[stewartjarod]

Summary

A manual suppression only reached the SES list. Broadcasts read contact.email_status, so the Oct 30 broadcast still sent to 5 suppressed addresses. SES refused them as Permanent / OnAccountSuppressionList, and the webhook counted each one as a hard bounce (bounced=6, suppressed=0; really 1 and 5).

 suppressOne (dashboard Suppress / Add address)
   putSuppressedAddress            # SES list
+  suppressContactByEmail          # contact → suppressed (only if active / soft_bounced / NULL)
   audit

 removeSuppression
   deleteSuppressedAddress
+  unsuppressContactByEmail        # suppressed → active
   audit

 processBounce / sdkDiagnosticFor / applyLifecycleToContact
-  if subType in (Suppressed, EmailValidationSuppressed)
+  if isSuppressionBounceSubType(subType)   # @wraps/core: + OnAccountSuppressionList, OnTenantSuppressionList
     → suppression, not bounce

The bounce-reason metrics in packages/db exclude the same subtypes. That package can't import core, so it keeps a copy of the list, with a comment saying to change both together. The event-processor Lambda already treated OnAccountSuppressionList as a suppression.

Evidence

• Before: the new tests fail with the fix reverted. Webhook: 10 failed (an OnAccountSuppressionList bounce → status: "bounced", batch.bounced + 1, contact bounced). Suppression actions: 10 failed (the contact stays active after Suppress).
  After: all green: API 2360, web 3812, db 342, core 240. Typecheck is clean.
• Production: broadcast e158d3d0 was corrected by hand to bounced=1, suppressed=5, with the 5 contacts set to suppressed.

Merge Danger

Door: two-way

Code only, no migration. Reverting restores the old labelling.

Blast Radius: small

• Contact status now follows manual suppress and unsuppress, scoped to the org. Unsuppress also re-activates a contact suppressed by an SES global-list event; SES still blocks that send.
• An SDK send whose first event is one of these bounces still gets message_send.status = 'bounced' (unchanged). Only its contact and diagnostics change.
• Existing mislabelled transactional rows in other orgs are not backfilled.

🤖 Generated with Claude Code

https://claude.ai/code/session_01GxJAQPQtEUd9AV6C37CnJM

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
wraps-web	Ready	Preview	Oct 31, 2026 3:51pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
wraps-website	Skipped		Oct 31, 2026 3:51pm UTC