@simplelayer/graniteer-core 0.1.2 → 0.2.1

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 (130) hide show
  1. package/index.js +2 -2
  2. package/package.json +73 -2
  3. package/src/agreementCheckout.ts +250 -0
  4. package/src/agreementPortalEmail.ts +128 -0
  5. package/src/billingPortalLinkEmail.ts +117 -0
  6. package/src/bookingAgreementEmail.ts +149 -0
  7. package/src/bookingEffects.ts +388 -0
  8. package/src/busClient.ts +268 -0
  9. package/src/busSignature.ts +71 -0
  10. package/src/checkoutCoupon.test.ts +675 -0
  11. package/src/checkoutCoupon.ts +455 -0
  12. package/src/commonsDeposit.ts +298 -0
  13. package/src/commonsDepositWebhook.ts +237 -0
  14. package/src/dayPassConfirmation.ts +230 -0
  15. package/src/dunningEmails.test.ts +263 -0
  16. package/src/dunningEmails.ts +203 -0
  17. package/src/email-templates/brand.ts +93 -0
  18. package/src/email-templates/magic-link.tsx +59 -0
  19. package/src/email-templates/recovery.tsx +59 -0
  20. package/src/email-templates/signup.tsx +67 -0
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -308
  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 -0
  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 -0
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -0
  32. package/src/functions/admin-mint-portal-link.ts +62 -0
  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 -0
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -0
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.test.ts +567 -0
  39. package/src/functions/admin-retry-invoice-payment.ts +333 -0
  40. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  41. package/src/functions/admin-revoke-agreement.ts +467 -0
  42. package/src/functions/admin-send-commons-agreement.ts +214 -214
  43. package/src/functions/admin-set-credit-amount.ts +123 -123
  44. package/src/functions/admin-skip-commons-contract.ts +165 -165
  45. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  46. package/src/functions/admin-wall-photo-write.ts +141 -141
  47. package/src/functions/auth-email-hook.ts +259 -0
  48. package/src/functions/boldsign-sender-identity.ts +114 -114
  49. package/src/functions/booking-availability.ts +419 -419
  50. package/src/functions/booking-member-preview.ts +136 -136
  51. package/src/functions/booking-status.ts +149 -0
  52. package/src/functions/conductor.ts +505 -0
  53. package/src/functions/create-agreement.ts +537 -0
  54. package/src/functions/create-booking.ts +648 -0
  55. package/src/functions/create-day-pass-checkout.ts +218 -0
  56. package/src/functions/create-portal-session.ts +142 -0
  57. package/src/functions/create-subscription-checkout.test.ts +222 -0
  58. package/src/functions/create-subscription-checkout.ts +440 -0
  59. package/src/functions/day-pass-status.ts +89 -89
  60. package/src/functions/diag-webpush-test.ts +45 -45
  61. package/src/functions/event-access-admin.ts +277 -0
  62. package/src/functions/event-access-store.ts +334 -309
  63. package/src/functions/ezeep-print-webhook.ts +213 -213
  64. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  65. package/src/functions/fetch-avatar-original.ts +457 -0
  66. package/src/functions/get-provider-sign-link.ts +155 -0
  67. package/src/functions/get-signing-link.ts +211 -211
  68. package/src/functions/guest-print-setup-confirm.ts +128 -128
  69. package/src/functions/guest-print-submit.ts +149 -149
  70. package/src/functions/luma-webhook.ts +165 -165
  71. package/src/functions/manage-booking.ts +472 -0
  72. package/src/functions/mcp.ts +67 -0
  73. package/src/functions/member-door-action.test.ts +1248 -0
  74. package/src/functions/member-door-action.ts +863 -0
  75. package/src/functions/member-unifi-mapping.test.ts +516 -0
  76. package/src/functions/member-unifi-mapping.ts +206 -0
  77. package/src/functions/membership-door-sync.ts +956 -0
  78. package/src/functions/migration-collision-alert.copy.ts +232 -232
  79. package/src/functions/migration-collision-alert.test.ts +349 -349
  80. package/src/functions/migration-collision-alert.ts +232 -232
  81. package/src/functions/office-assignment-end.ts +146 -146
  82. package/src/functions/portal-booking-access.ts +217 -95
  83. package/src/functions/portal-list-invoices.ts +99 -99
  84. package/src/functions/portal-request-login.ts +192 -0
  85. package/src/functions/portal-resend-invite.ts +248 -0
  86. package/src/functions/portal-submit-event.ts +168 -0
  87. package/src/functions/print-billing-recover.ts +97 -97
  88. package/src/functions/print-billing-run.ts +183 -183
  89. package/src/functions/public-facts.ts +168 -168
  90. package/src/functions/push-send.ts +348 -0
  91. package/src/functions/push-test.ts +234 -0
  92. package/src/functions/request-portal-link.ts +211 -0
  93. package/src/functions/reschedule-booking.ts +649 -0
  94. package/src/functions/review-ratings.ts +113 -0
  95. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  96. package/src/functions/space-availability-range.ts +142 -142
  97. package/src/functions/stripe-db-reconcile.ts +319 -0
  98. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  99. package/src/functions/stripe-webhook.ts +2595 -0
  100. package/src/functions/sync-gcal-blackouts.ts +298 -298
  101. package/src/functions/timetable-event-register.ts +162 -162
  102. package/src/functions/timetable-event-status.ts +90 -90
  103. package/src/functions/timetable-spaces.ts +219 -219
  104. package/src/functions/touch-pass-reconciler.ts +689 -689
  105. package/src/functions/touch-pass-signup.ts +478 -0
  106. package/src/functions/upload-booking-display-image.ts +179 -0
  107. package/src/functions/virtual-onboarding-purge.ts +134 -134
  108. package/src/functions/virtual-onboarding-submit.ts +315 -315
  109. package/src/functions/voice-booking.ts +453 -0
  110. package/src/functions/voice-day-pass.ts +346 -0
  111. package/src/functions/voice-inquiry.test.ts +301 -301
  112. package/src/functions/voice-inquiry.ts +198 -198
  113. package/src/functions/voice-membership-signup.ts +355 -0
  114. package/src/functions/voice-tour-availability.ts +204 -204
  115. package/src/functions/voice-tour-booking.ts +429 -0
  116. package/src/ghlEventInquiry.ts +143 -0
  117. package/src/mailArrivalEmail.ts +121 -0
  118. package/src/manageToken.ts +363 -0
  119. package/src/membershipBusClient.ts +537 -0
  120. package/src/membershipWelcome.ts +683 -0
  121. package/src/migrationCheckout.ts +366 -0
  122. package/src/pacificDate.ts +54 -0
  123. package/src/paymentLinkEmail.ts +123 -0
  124. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  125. package/src/signedUnpaidReminderEmail.ts +132 -0
  126. package/src/stripeCoworkingPortal.ts +91 -0
  127. package/src/supabaseTestFakes.ts +131 -131
  128. package/src/supportTicketEmail.ts +119 -0
  129. package/src/unifiAccessPolicies.ts +228 -0
  130. package/src/unifiGroups.ts +129 -0
@@ -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));