@simplelayer/graniteer-core 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/index.js +2 -2
  2. package/package.json +1 -1
  3. package/src/agreementCheckout.ts +250 -250
  4. package/src/agreementPortalEmail.ts +128 -128
  5. package/src/billingPortalLinkEmail.ts +117 -117
  6. package/src/bookingAgreementEmail.ts +149 -149
  7. package/src/bookingEffects.ts +388 -388
  8. package/src/busClient.ts +268 -268
  9. package/src/busSignature.ts +71 -71
  10. package/src/checkoutCoupon.test.ts +675 -675
  11. package/src/checkoutCoupon.ts +455 -455
  12. package/src/commonsDeposit.ts +298 -298
  13. package/src/commonsDepositWebhook.ts +237 -237
  14. package/src/dayPassConfirmation.ts +230 -230
  15. package/src/dunningEmails.test.ts +263 -263
  16. package/src/dunningEmails.ts +203 -203
  17. package/src/email-templates/brand.ts +93 -93
  18. package/src/email-templates/magic-link.tsx +59 -59
  19. package/src/email-templates/recovery.tsx +59 -59
  20. package/src/email-templates/signup.tsx +67 -67
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -312
  23. package/src/functions/admin-charge-guest-print.ts +229 -229
  24. package/src/functions/admin-correct-booking.ts +333 -333
  25. package/src/functions/admin-create-booking.ts +460 -460
  26. package/src/functions/admin-create-commons-event.ts +244 -244
  27. package/src/functions/admin-debug-boldsign-doc.ts +93 -93
  28. package/src/functions/admin-door-write.ts +272 -272
  29. package/src/functions/admin-issue-day-pass.ts +231 -231
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -168
  32. package/src/functions/admin-mint-portal-link.ts +62 -62
  33. package/src/functions/admin-photo-upload.ts +128 -128
  34. package/src/functions/admin-remove-team-member.ts +150 -150
  35. package/src/functions/admin-request-trial.ts +366 -366
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -323
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.ts +333 -333
  39. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  40. package/src/functions/admin-revoke-agreement.ts +467 -467
  41. package/src/functions/admin-send-commons-agreement.ts +214 -214
  42. package/src/functions/admin-set-credit-amount.ts +123 -123
  43. package/src/functions/admin-skip-commons-contract.ts +165 -165
  44. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  45. package/src/functions/admin-wall-photo-write.ts +141 -141
  46. package/src/functions/auth-email-hook.ts +259 -259
  47. package/src/functions/boldsign-sender-identity.ts +114 -114
  48. package/src/functions/booking-availability.ts +419 -419
  49. package/src/functions/booking-member-preview.ts +136 -136
  50. package/src/functions/booking-status.ts +149 -149
  51. package/src/functions/create-booking.ts +648 -648
  52. package/src/functions/create-day-pass-checkout.ts +218 -218
  53. package/src/functions/create-portal-session.ts +142 -142
  54. package/src/functions/create-subscription-checkout.test.ts +222 -222
  55. package/src/functions/create-subscription-checkout.ts +440 -440
  56. package/src/functions/day-pass-status.ts +89 -89
  57. package/src/functions/diag-webpush-test.ts +45 -45
  58. package/src/functions/event-access-admin.ts +277 -277
  59. package/src/functions/event-access-store.ts +334 -334
  60. package/src/functions/ezeep-print-webhook.ts +213 -213
  61. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  62. package/src/functions/fetch-avatar-original.ts +457 -457
  63. package/src/functions/get-provider-sign-link.ts +155 -155
  64. package/src/functions/get-signing-link.ts +211 -211
  65. package/src/functions/guest-print-setup-confirm.ts +128 -128
  66. package/src/functions/guest-print-submit.ts +149 -149
  67. package/src/functions/luma-webhook.ts +165 -165
  68. package/src/functions/mcp.ts +67 -67
  69. package/src/functions/member-door-action.test.ts +1248 -1248
  70. package/src/functions/member-door-action.ts +863 -863
  71. package/src/functions/member-unifi-mapping.test.ts +516 -516
  72. package/src/functions/member-unifi-mapping.ts +206 -206
  73. package/src/functions/membership-door-sync.ts +956 -956
  74. package/src/functions/migration-collision-alert.copy.ts +232 -232
  75. package/src/functions/migration-collision-alert.test.ts +349 -349
  76. package/src/functions/migration-collision-alert.ts +232 -232
  77. package/src/functions/office-assignment-end.ts +146 -146
  78. package/src/functions/portal-booking-access.ts +217 -217
  79. package/src/functions/portal-list-invoices.ts +99 -99
  80. package/src/functions/portal-request-login.ts +219 -192
  81. package/src/functions/portal-resend-invite.ts +248 -248
  82. package/src/functions/portal-submit-event.ts +168 -168
  83. package/src/functions/print-billing-recover.ts +97 -97
  84. package/src/functions/print-billing-run.ts +183 -183
  85. package/src/functions/public-facts.ts +168 -168
  86. package/src/functions/push-send.ts +348 -348
  87. package/src/functions/push-test.ts +234 -234
  88. package/src/functions/request-portal-link.ts +211 -211
  89. package/src/functions/review-ratings.ts +113 -113
  90. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  91. package/src/functions/space-availability-range.ts +142 -142
  92. package/src/functions/stripe-db-reconcile.ts +319 -319
  93. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -78
  94. package/src/functions/stripe-webhook.ts +2595 -2595
  95. package/src/functions/sync-gcal-blackouts.ts +298 -298
  96. package/src/functions/timetable-event-register.ts +162 -162
  97. package/src/functions/timetable-event-status.ts +90 -90
  98. package/src/functions/timetable-spaces.ts +219 -219
  99. package/src/functions/touch-pass-reconciler.ts +689 -689
  100. package/src/functions/touch-pass-signup.ts +478 -478
  101. package/src/functions/upload-booking-display-image.ts +179 -179
  102. package/src/functions/virtual-onboarding-purge.ts +134 -134
  103. package/src/functions/virtual-onboarding-submit.ts +315 -315
  104. package/src/functions/voice-booking.ts +453 -453
  105. package/src/functions/voice-day-pass.ts +346 -346
  106. package/src/functions/voice-inquiry.test.ts +301 -301
  107. package/src/functions/voice-inquiry.ts +198 -198
  108. package/src/functions/voice-membership-signup.ts +355 -355
  109. package/src/functions/voice-tour-availability.ts +204 -204
  110. package/src/functions/voice-tour-booking.ts +429 -429
  111. package/src/ghlEventInquiry.ts +143 -143
  112. package/src/mailArrivalEmail.ts +121 -121
  113. package/src/manageToken.ts +363 -363
  114. package/src/membershipBusClient.ts +537 -537
  115. package/src/membershipWelcome.ts +683 -683
  116. package/src/migrationCheckout.ts +366 -366
  117. package/src/paymentLinkEmail.ts +123 -123
  118. package/src/signedUnpaidReminderEmail.test.ts +246 -246
  119. package/src/signedUnpaidReminderEmail.ts +132 -132
  120. package/src/stripeCoworkingPortal.ts +91 -91
  121. package/src/supabaseTestFakes.ts +131 -131
  122. package/src/supportTicketEmail.ts +119 -119
  123. package/src/unifiAccessPolicies.ts +228 -228
  124. package/src/unifiGroups.ts +129 -129
@@ -1,232 +1,232 @@
1
- // supabase/functions/migration-collision-alert/index.ts
2
- //
3
- // TEMPORARY, SECRET-GATED poller that Slack-alerts on
4
- // `membership_email_collision_flagged` ops_events for emails on the 61-person
5
- // legacy-migration roster, for the duration of the migration window only.
6
- //
7
- // WHY THIS EXISTS (plan v13 §4): stripe-webhook's existing, unmodified
8
- // adopt/insert logic (§9.4) emits that event at severity 'warning' when
9
- // `allSameCustomer` is true — two independently-completed Checkout Sessions
10
- // for one email produce two membership rows, one warning-severity collision
11
- // event, and two live subscriptions. That behavior is out of scope to change
12
- // ("zero webhook changes"), and it is the CORRECT behavior to leave alone.
13
- // What was missing is that nobody finds out: _shared/ops.ts only fans an event
14
- // out to Slack at severity 'error', so a 'warning' collision lands in
15
- // ops_events and stops there. This function closes the notification gap
16
- // WITHOUT touching the emitter.
17
- //
18
- // WHY A POLLER RATHER THAN A CALL-SITE ALERT: the natural place for this is
19
- // one `sendSlackAlert(...)` next to the `logOps(... 'membership_email_
20
- // collision_flagged' ...)` call in stripe-webhook. That file is explicitly
21
- // off-limits — the plan's own §4 commitment is zero webhook changes — so the
22
- // alert is attached from the outside, by reading the event stream the webhook
23
- // already writes.
24
- //
25
- // PATTERNS FOLLOWED (nothing new invented):
26
- // - auth: x-reconcile-secret + constant-time compare against a secret read
27
- // via an RPC, copied from dunning-email-check/index.ts (which copied it
28
- // from ezeep-usage-reconcile/index.ts).
29
- // - alerting: sendSlackAlert(OPS_ALERTS_CHANNEL_ID, ...) from
30
- // _shared/slackAlert.ts, as retell-call-webhook/index.ts uses it.
31
- // - once-only delivery: an ops_events dedupe_key marker row, read before
32
- // alerting, exactly as retell-call-webhook checks
33
- // `voice_inquiry_captured:<id>` before doing its backfill.
34
- //
35
- // SCOPE, both halves enforced in code below:
36
- // - people: only emails present in `migration_checkout_state`. That table IS
37
- // the 61-person roster, so the scoping needs no second hardcoded list and
38
- // cannot drift from it.
39
- // - window: only events newer than LOOKBACK_HOURS. When the migration is
40
- // done, unschedule the cron — see the migration that creates it.
41
- //
42
- // This function reads ops_events and migration_checkout_state and writes only
43
- // its own marker rows. It never reads or writes `memberships`, never touches
44
- // Stripe, and cannot alter what stripe-webhook did.
45
-
46
- import { createClient } from 'npm:@supabase/supabase-js@2';
47
- import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
48
- import { sendSlackAlert, OPS_ALERTS_CHANNEL_ID } from 'npm:@simplelayer/graniteer-core/slackAlert';
49
-
50
- const COLLISION_KIND = 'membership_email_collision_flagged';
51
- const ALERTED_KIND = 'migration_collision_alerted';
52
-
53
- /**
54
- * Generous relative to the 5-minute cron: an alert that fires twice is
55
- * prevented by the dedupe marker, but an alert that never fires because the
56
- * window was too tight is unrecoverable. Overlap is the safe direction.
57
- */
58
- const LOOKBACK_HOURS = 48;
59
-
60
- function safeEqual(a: string, b: string): boolean {
61
- const enc = new TextEncoder();
62
- const ab = enc.encode(a), bb = enc.encode(b);
63
- if (ab.length !== bb.length) return false;
64
- let diff = 0;
65
- for (let i = 0; i < ab.length; i++) diff |= ab[i] ^ bb[i];
66
- return diff === 0;
67
- }
68
-
69
- /** Same normalization §1's reconciliation query established: lower(trim(...)). */
70
- function normalizeEmail(v: unknown): string | null {
71
- if (typeof v !== 'string') return null;
72
- const n = v.trim().toLowerCase();
73
- return n.length > 0 ? n : null;
74
- }
75
-
76
- interface CollisionEventRow {
77
- id: string;
78
- created_at: string;
79
- severity: string | null;
80
- detail: Record<string, unknown> | null;
81
- }
82
-
83
- export interface CollisionAlertDeps {
84
- supabase: ReturnType<typeof createClient>;
85
- alert: (channelId: string, text: string) => Promise<void>;
86
- now: () => Date;
87
- }
88
-
89
- export async function handleMigrationCollisionAlert(
90
- req: Request,
91
- injected?: CollisionAlertDeps,
92
- ): Promise<Response> {
93
- if (req.method !== 'POST' && req.method !== 'GET') {
94
- return new Response('Method not allowed', { status: 405 });
95
- }
96
-
97
- const deps: CollisionAlertDeps = injected ?? {
98
- supabase: createClient(
99
- Deno.env.get('SUPABASE_URL')!,
100
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
101
- ),
102
- alert: sendSlackAlert,
103
- now: () => new Date(),
104
- };
105
- const supabase = deps.supabase;
106
-
107
- // Auth is skipped ONLY when dependencies are injected, i.e. under test.
108
- // In production `injected` is always undefined, so the gate always runs.
109
- if (!injected) {
110
- const provided = req.headers.get('x-reconcile-secret');
111
- if (!provided) return new Response('Unauthorized', { status: 401 });
112
-
113
- const { data: gate, error: gateErr } = await supabase.rpc('get_migration_collision_alert_secret');
114
- const expected = typeof gate === 'string' ? gate : null;
115
- if (gateErr || !expected || !safeEqual(provided, expected)) {
116
- return new Response('Unauthorized', { status: 401 });
117
- }
118
- }
119
-
120
- try {
121
- const sinceIso = new Date(deps.now().getTime() - LOOKBACK_HOURS * 3600_000).toISOString();
122
-
123
- // 1. The roster. This table is the 61-person migration list; an empty
124
- // roster means the migration is over (or not seeded yet) and there is
125
- // by definition nothing in scope to alert on.
126
- const { data: rosterRows, error: rosterErr } = await supabase
127
- .from('migration_checkout_state')
128
- .select('email');
129
- if (rosterErr) throw new Error('migration_checkout_state read failed: ' + rosterErr.message);
130
- const roster = new Set<string>();
131
- for (const r of (rosterRows ?? []) as Array<{ email: string }>) {
132
- const n = normalizeEmail(r.email);
133
- if (n) roster.add(n);
134
- }
135
- if (roster.size === 0) {
136
- return json({ ok: true, roster_size: 0, in_scope: 0, alerted: 0, skipped: 0 });
137
- }
138
-
139
- // 2. Collision events in the window. Deliberately NOT filtered by
140
- // severity: 'warning' is the same-customer case §4 describes and
141
- // 'error' is the cross-customer case, and a migrant hitting the second
142
- // one needs an alert at least as urgently as the first.
143
- const { data: events, error: evErr } = await supabase
144
- .from('ops_events')
145
- .select('id,created_at,severity,detail')
146
- .eq('kind', COLLISION_KIND)
147
- .gte('created_at', sinceIso)
148
- .order('created_at', { ascending: true });
149
- if (evErr) throw new Error('ops_events read failed: ' + evErr.message);
150
-
151
- let inScope = 0, alerted = 0, skipped = 0;
152
-
153
- for (const ev of (events ?? []) as CollisionEventRow[]) {
154
- const detail = ev.detail ?? {};
155
- const email = normalizeEmail(detail.attempted_email);
156
- if (!email || !roster.has(email)) { skipped++; continue; }
157
- inScope++;
158
-
159
- const subscriptionId = typeof detail.subscription_id === 'string' ? detail.subscription_id : null;
160
- // Keyed on the event row id, which is unique per emission, so one alert
161
- // per collision event rather than per (email, subscription) guess.
162
- const dedupeKey = `${ALERTED_KIND}:${ev.id}`;
163
-
164
- const { data: already, error: alreadyErr } = await supabase
165
- .from('ops_events')
166
- .select('id')
167
- .eq('dedupe_key', dedupeKey)
168
- .maybeSingle();
169
- // A failed dedupe read must not cause a duplicate alert storm on every
170
- // 5-minute tick — treat "can't tell" as "already alerted" and let the
171
- // next run retry once the read works.
172
- if (alreadyErr) { skipped++; continue; }
173
- if (already) { skipped++; continue; }
174
-
175
- const collidingIds = Array.isArray(detail.colliding_ids) ? detail.colliding_ids : [];
176
- const membershipId = typeof detail.membership_id === 'string' ? detail.membership_id : null;
177
-
178
- await deps.alert(
179
- OPS_ALERTS_CHANNEL_ID,
180
- `:rotating_light: MIGRATION email collision — *${email}* is on the legacy-migration roster ` +
181
- `and just tripped stripe-webhook's duplicate-membership guard.\n` +
182
- `• severity: ${ev.severity ?? 'unknown'} • at: ${ev.created_at}\n` +
183
- `• new subscription: ${subscriptionId ?? 'unknown'} • new membership: ${membershipId ?? 'none'}\n` +
184
- `• colliding membership rows: ${collidingIds.length > 0 ? collidingIds.join(', ') : 'none reported'}\n` +
185
- `Expected shape: TWO membership rows and TWO live subscriptions. Cancel the duplicate ` +
186
- `subscription in Stripe and reconcile the rows by hand — nothing does this automatically.`,
187
- );
188
-
189
- // Marker row. logOps returns ok:true on a dedupe_key collision (that is
190
- // the success case for a once-ever emission), so this is idempotent
191
- // under a concurrent second tick.
192
- const res = await logOps(supabase, ALERTED_KIND, {
193
- collision_event_id: ev.id,
194
- email,
195
- subscription_id: subscriptionId,
196
- severity: ev.severity,
197
- }, { severity: 'info', dedupeKey });
198
- if (!res.ok) {
199
- // Unchecked emission is indistinguishable from "no problem found"
200
- // (_shared/ops.ts's hard contract), and here it specifically means the
201
- // next tick will alert again. Say so loudly rather than silently.
202
- console.error('[migration-collision-alert] marker write failed', {
203
- collision_event_id: ev.id, error: res.error,
204
- });
205
- }
206
- alerted++;
207
- }
208
-
209
- return json({ ok: true, roster_size: roster.size, in_scope: inScope, alerted, skipped });
210
- } catch (e) {
211
- try {
212
- // Cast: the generated Database types are not wired into edge functions,
213
- // so the insert payload widens to `never` without it (same as ops.ts).
214
- await supabase.from('ops_events').insert({
215
- kind: 'migration_collision_alert_error',
216
- severity: 'error',
217
- detail: { error: String(e) },
218
- } as never);
219
- } catch { /* ignore */ }
220
- return json({ ok: false, error: String(e) }, 500);
221
- }
222
- }
223
-
224
- function json(body: unknown, status = 200): Response {
225
- return new Response(JSON.stringify(body), {
226
- headers: { 'Content-Type': 'application/json' }, status,
227
- });
228
- }
229
-
230
- // Arrow wrapper: the handler's optional second parameter (injected deps) makes
231
- // Deno.serve resolve to its options overload otherwise.
232
- if (import.meta.main) Deno.serve((req) => handleMigrationCollisionAlert(req));
1
+ // supabase/functions/migration-collision-alert/index.ts
2
+ //
3
+ // TEMPORARY, SECRET-GATED poller that Slack-alerts on
4
+ // `membership_email_collision_flagged` ops_events for emails on the 61-person
5
+ // legacy-migration roster, for the duration of the migration window only.
6
+ //
7
+ // WHY THIS EXISTS (plan v13 §4): stripe-webhook's existing, unmodified
8
+ // adopt/insert logic (§9.4) emits that event at severity 'warning' when
9
+ // `allSameCustomer` is true — two independently-completed Checkout Sessions
10
+ // for one email produce two membership rows, one warning-severity collision
11
+ // event, and two live subscriptions. That behavior is out of scope to change
12
+ // ("zero webhook changes"), and it is the CORRECT behavior to leave alone.
13
+ // What was missing is that nobody finds out: _shared/ops.ts only fans an event
14
+ // out to Slack at severity 'error', so a 'warning' collision lands in
15
+ // ops_events and stops there. This function closes the notification gap
16
+ // WITHOUT touching the emitter.
17
+ //
18
+ // WHY A POLLER RATHER THAN A CALL-SITE ALERT: the natural place for this is
19
+ // one `sendSlackAlert(...)` next to the `logOps(... 'membership_email_
20
+ // collision_flagged' ...)` call in stripe-webhook. That file is explicitly
21
+ // off-limits — the plan's own §4 commitment is zero webhook changes — so the
22
+ // alert is attached from the outside, by reading the event stream the webhook
23
+ // already writes.
24
+ //
25
+ // PATTERNS FOLLOWED (nothing new invented):
26
+ // - auth: x-reconcile-secret + constant-time compare against a secret read
27
+ // via an RPC, copied from dunning-email-check/index.ts (which copied it
28
+ // from ezeep-usage-reconcile/index.ts).
29
+ // - alerting: sendSlackAlert(OPS_ALERTS_CHANNEL_ID, ...) from
30
+ // _shared/slackAlert.ts, as retell-call-webhook/index.ts uses it.
31
+ // - once-only delivery: an ops_events dedupe_key marker row, read before
32
+ // alerting, exactly as retell-call-webhook checks
33
+ // `voice_inquiry_captured:<id>` before doing its backfill.
34
+ //
35
+ // SCOPE, both halves enforced in code below:
36
+ // - people: only emails present in `migration_checkout_state`. That table IS
37
+ // the 61-person roster, so the scoping needs no second hardcoded list and
38
+ // cannot drift from it.
39
+ // - window: only events newer than LOOKBACK_HOURS. When the migration is
40
+ // done, unschedule the cron — see the migration that creates it.
41
+ //
42
+ // This function reads ops_events and migration_checkout_state and writes only
43
+ // its own marker rows. It never reads or writes `memberships`, never touches
44
+ // Stripe, and cannot alter what stripe-webhook did.
45
+
46
+ import { createClient } from 'npm:@supabase/supabase-js@2';
47
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
48
+ import { sendSlackAlert, OPS_ALERTS_CHANNEL_ID } from 'npm:@simplelayer/graniteer-core/slackAlert';
49
+
50
+ const COLLISION_KIND = 'membership_email_collision_flagged';
51
+ const ALERTED_KIND = 'migration_collision_alerted';
52
+
53
+ /**
54
+ * Generous relative to the 5-minute cron: an alert that fires twice is
55
+ * prevented by the dedupe marker, but an alert that never fires because the
56
+ * window was too tight is unrecoverable. Overlap is the safe direction.
57
+ */
58
+ const LOOKBACK_HOURS = 48;
59
+
60
+ function safeEqual(a: string, b: string): boolean {
61
+ const enc = new TextEncoder();
62
+ const ab = enc.encode(a), bb = enc.encode(b);
63
+ if (ab.length !== bb.length) return false;
64
+ let diff = 0;
65
+ for (let i = 0; i < ab.length; i++) diff |= ab[i] ^ bb[i];
66
+ return diff === 0;
67
+ }
68
+
69
+ /** Same normalization §1's reconciliation query established: lower(trim(...)). */
70
+ function normalizeEmail(v: unknown): string | null {
71
+ if (typeof v !== 'string') return null;
72
+ const n = v.trim().toLowerCase();
73
+ return n.length > 0 ? n : null;
74
+ }
75
+
76
+ interface CollisionEventRow {
77
+ id: string;
78
+ created_at: string;
79
+ severity: string | null;
80
+ detail: Record<string, unknown> | null;
81
+ }
82
+
83
+ export interface CollisionAlertDeps {
84
+ supabase: ReturnType<typeof createClient>;
85
+ alert: (channelId: string, text: string) => Promise<void>;
86
+ now: () => Date;
87
+ }
88
+
89
+ export async function handleMigrationCollisionAlert(
90
+ req: Request,
91
+ injected?: CollisionAlertDeps,
92
+ ): Promise<Response> {
93
+ if (req.method !== 'POST' && req.method !== 'GET') {
94
+ return new Response('Method not allowed', { status: 405 });
95
+ }
96
+
97
+ const deps: CollisionAlertDeps = injected ?? {
98
+ supabase: createClient(
99
+ Deno.env.get('SUPABASE_URL')!,
100
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
101
+ ),
102
+ alert: sendSlackAlert,
103
+ now: () => new Date(),
104
+ };
105
+ const supabase = deps.supabase;
106
+
107
+ // Auth is skipped ONLY when dependencies are injected, i.e. under test.
108
+ // In production `injected` is always undefined, so the gate always runs.
109
+ if (!injected) {
110
+ const provided = req.headers.get('x-reconcile-secret');
111
+ if (!provided) return new Response('Unauthorized', { status: 401 });
112
+
113
+ const { data: gate, error: gateErr } = await supabase.rpc('get_migration_collision_alert_secret');
114
+ const expected = typeof gate === 'string' ? gate : null;
115
+ if (gateErr || !expected || !safeEqual(provided, expected)) {
116
+ return new Response('Unauthorized', { status: 401 });
117
+ }
118
+ }
119
+
120
+ try {
121
+ const sinceIso = new Date(deps.now().getTime() - LOOKBACK_HOURS * 3600_000).toISOString();
122
+
123
+ // 1. The roster. This table is the 61-person migration list; an empty
124
+ // roster means the migration is over (or not seeded yet) and there is
125
+ // by definition nothing in scope to alert on.
126
+ const { data: rosterRows, error: rosterErr } = await supabase
127
+ .from('migration_checkout_state')
128
+ .select('email');
129
+ if (rosterErr) throw new Error('migration_checkout_state read failed: ' + rosterErr.message);
130
+ const roster = new Set<string>();
131
+ for (const r of (rosterRows ?? []) as Array<{ email: string }>) {
132
+ const n = normalizeEmail(r.email);
133
+ if (n) roster.add(n);
134
+ }
135
+ if (roster.size === 0) {
136
+ return json({ ok: true, roster_size: 0, in_scope: 0, alerted: 0, skipped: 0 });
137
+ }
138
+
139
+ // 2. Collision events in the window. Deliberately NOT filtered by
140
+ // severity: 'warning' is the same-customer case §4 describes and
141
+ // 'error' is the cross-customer case, and a migrant hitting the second
142
+ // one needs an alert at least as urgently as the first.
143
+ const { data: events, error: evErr } = await supabase
144
+ .from('ops_events')
145
+ .select('id,created_at,severity,detail')
146
+ .eq('kind', COLLISION_KIND)
147
+ .gte('created_at', sinceIso)
148
+ .order('created_at', { ascending: true });
149
+ if (evErr) throw new Error('ops_events read failed: ' + evErr.message);
150
+
151
+ let inScope = 0, alerted = 0, skipped = 0;
152
+
153
+ for (const ev of (events ?? []) as CollisionEventRow[]) {
154
+ const detail = ev.detail ?? {};
155
+ const email = normalizeEmail(detail.attempted_email);
156
+ if (!email || !roster.has(email)) { skipped++; continue; }
157
+ inScope++;
158
+
159
+ const subscriptionId = typeof detail.subscription_id === 'string' ? detail.subscription_id : null;
160
+ // Keyed on the event row id, which is unique per emission, so one alert
161
+ // per collision event rather than per (email, subscription) guess.
162
+ const dedupeKey = `${ALERTED_KIND}:${ev.id}`;
163
+
164
+ const { data: already, error: alreadyErr } = await supabase
165
+ .from('ops_events')
166
+ .select('id')
167
+ .eq('dedupe_key', dedupeKey)
168
+ .maybeSingle();
169
+ // A failed dedupe read must not cause a duplicate alert storm on every
170
+ // 5-minute tick — treat "can't tell" as "already alerted" and let the
171
+ // next run retry once the read works.
172
+ if (alreadyErr) { skipped++; continue; }
173
+ if (already) { skipped++; continue; }
174
+
175
+ const collidingIds = Array.isArray(detail.colliding_ids) ? detail.colliding_ids : [];
176
+ const membershipId = typeof detail.membership_id === 'string' ? detail.membership_id : null;
177
+
178
+ await deps.alert(
179
+ OPS_ALERTS_CHANNEL_ID,
180
+ `:rotating_light: MIGRATION email collision — *${email}* is on the legacy-migration roster ` +
181
+ `and just tripped stripe-webhook's duplicate-membership guard.\n` +
182
+ `• severity: ${ev.severity ?? 'unknown'} • at: ${ev.created_at}\n` +
183
+ `• new subscription: ${subscriptionId ?? 'unknown'} • new membership: ${membershipId ?? 'none'}\n` +
184
+ `• colliding membership rows: ${collidingIds.length > 0 ? collidingIds.join(', ') : 'none reported'}\n` +
185
+ `Expected shape: TWO membership rows and TWO live subscriptions. Cancel the duplicate ` +
186
+ `subscription in Stripe and reconcile the rows by hand — nothing does this automatically.`,
187
+ );
188
+
189
+ // Marker row. logOps returns ok:true on a dedupe_key collision (that is
190
+ // the success case for a once-ever emission), so this is idempotent
191
+ // under a concurrent second tick.
192
+ const res = await logOps(supabase, ALERTED_KIND, {
193
+ collision_event_id: ev.id,
194
+ email,
195
+ subscription_id: subscriptionId,
196
+ severity: ev.severity,
197
+ }, { severity: 'info', dedupeKey });
198
+ if (!res.ok) {
199
+ // Unchecked emission is indistinguishable from "no problem found"
200
+ // (_shared/ops.ts's hard contract), and here it specifically means the
201
+ // next tick will alert again. Say so loudly rather than silently.
202
+ console.error('[migration-collision-alert] marker write failed', {
203
+ collision_event_id: ev.id, error: res.error,
204
+ });
205
+ }
206
+ alerted++;
207
+ }
208
+
209
+ return json({ ok: true, roster_size: roster.size, in_scope: inScope, alerted, skipped });
210
+ } catch (e) {
211
+ try {
212
+ // Cast: the generated Database types are not wired into edge functions,
213
+ // so the insert payload widens to `never` without it (same as ops.ts).
214
+ await supabase.from('ops_events').insert({
215
+ kind: 'migration_collision_alert_error',
216
+ severity: 'error',
217
+ detail: { error: String(e) },
218
+ } as never);
219
+ } catch { /* ignore */ }
220
+ return json({ ok: false, error: String(e) }, 500);
221
+ }
222
+ }
223
+
224
+ function json(body: unknown, status = 200): Response {
225
+ return new Response(JSON.stringify(body), {
226
+ headers: { 'Content-Type': 'application/json' }, status,
227
+ });
228
+ }
229
+
230
+ // Arrow wrapper: the handler's optional second parameter (injected deps) makes
231
+ // Deno.serve resolve to its options overload otherwise.
232
+ if (import.meta.main) Deno.serve((req) => handleMigrationCollisionAlert(req));