@simplelayer/graniteer-core 0.2.0 → 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 -309
  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 -95
  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,183 +1,183 @@
1
- // supabase/functions/print-billing-run/index.ts
2
- //
3
- // print-usage-bill P2 — the monthly billing run. Design: PRINT-USAGE-BILL-DESIGN.md
4
- // v19 section 4.2. Runs on the 5th of each month; the 5th is a STAFF BUFFER giving four
5
- // days to catch a reconciliation mismatch before money moves (section 2.1).
6
- //
7
- // All of the decision logic lives in _shared/printBilling.ts, which imports
8
- // nothing and is fully exercised against a mocked Stripe client in
9
- // _shared/printBilling.test.ts. This file is the adapter: it builds a real Stripe
10
- // client and a real Supabase client, enumerates eligible memberships, applies
11
- // section 4.2's anomaly/cap gate, and hands each membership to the core.
12
- //
13
- // C-01: ONE standalone invoice per membership per month, customer-scoped, with no
14
- // subscription attached and nothing on it but print charges.
15
- //
16
- // SECRET-GATED, like the other scheduled functions in this project. It is invoked
17
- // by pg_cron via net.http_post and by nothing else.
18
-
19
- import Stripe from 'npm:stripe@17.5.0';
20
- import { createClient } from 'npm:@supabase/supabase-js@2';
21
- import {
22
- evaluateGate,
23
- executeBillingRun,
24
- resolveDefaultPaymentMethod,
25
- type RunInput,
26
- } from 'npm:@simplelayer/graniteer-core/printBilling';
27
- import { makeDb, makeStripe } from 'npm:@simplelayer/graniteer-core/printBillingAdapters';
28
-
29
- function safeEqual(a: string, b: string): boolean {
30
- const enc = new TextEncoder();
31
- const ab = enc.encode(a), bb = enc.encode(b);
32
- if (ab.length !== bb.length) return false;
33
- let diff = 0;
34
- for (let i = 0; i < ab.length; i++) diff |= ab[i] ^ bb[i];
35
- return diff === 0;
36
- }
37
-
38
- interface EligibleRow {
39
- membership_id: string;
40
- period_ids: string[];
41
- period_months: string[];
42
- amount_cents: number;
43
- }
44
-
45
- export async function handle(req: Request): Promise<Response> {
46
- const supabase = createClient(
47
- Deno.env.get('SUPABASE_URL')!,
48
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
49
- );
50
-
51
- // ---- gate ---------------------------------------------------------------
52
- const { data: secret } = await supabase.rpc('get_print_billing_run_secret');
53
- const provided = req.headers.get('x-gc-print-billing-secret') ?? '';
54
- if (!secret || !safeEqual(String(secret), provided)) {
55
- return new Response(JSON.stringify({ ok: false, error: 'forbidden' }), {
56
- status: 403, headers: { 'Content-Type': 'application/json' },
57
- });
58
- }
59
-
60
- const stripeKey = Deno.env.get('STRIPE_SECRET_KEY');
61
- const expectedAccountId = Deno.env.get('STRIPE_ACCOUNT_ID');
62
- if (!stripeKey || !expectedAccountId) {
63
- // STEP 0.2 cannot be satisfied without both. Refuse rather than guess: it is
64
- // the account assertion that makes a later 404 interpretable at all (R8 F3).
65
- return new Response(JSON.stringify({ ok: false, error: 'stripe_config_missing' }), {
66
- status: 500, headers: { 'Content-Type': 'application/json' },
67
- });
68
- }
69
-
70
- const rawStripe = new Stripe(stripeKey, {
71
- apiVersion: '2024-11-20.acacia' as Stripe.LatestApiVersion,
72
- });
73
- const stripe = makeStripe(rawStripe);
74
- const db = makeDb(supabase as never);
75
- const expectedLivemode = (Deno.env.get('ENVIRONMENT') ?? '') === 'production';
76
-
77
- // ---- section 4.2 eligibility -------------------------------------------------
78
- // Wrapped server-side for the same reason section 5.2's selection is (v18/B12-2):
79
- // the aggregate + HAVING + NOT EXISTS shape is not expressible through PostgREST.
80
- const { data: eligible, error: eligErr } =
81
- await supabase.rpc('print_billing_eligible_memberships');
82
- if (eligErr) {
83
- return new Response(JSON.stringify({ ok: false, error: eligErr.message }), {
84
- status: 500, headers: { 'Content-Type': 'application/json' },
85
- });
86
- }
87
-
88
- const rows = (eligible ?? []) as EligibleRow[];
89
- const results: Record<string, unknown>[] = [];
90
-
91
- for (const row of rows) {
92
- // ---- section 4.2's anomaly / cap gate. Runs entirely on DB reads, BEFORE the
93
- // claim, and it decides whether money moves at all.
94
- const baseline = await db.baseline(row.membership_id);
95
- const gate = evaluateGate({
96
- amountCents: row.amount_cents,
97
- baselineCents: baseline.baseline_cents,
98
- qualifyingPeriods: baseline.qualifying_periods,
99
- });
100
-
101
- if (gate.blocked) {
102
- // Both gates are evaluated and BOTH rows are written when both fire — staff
103
- // need to know which rule caught it, because the two mean different things.
104
- // The periods stay pending_bill and unclaimed; this needs staff approval.
105
- if (gate.overCap) {
106
- await db.opsEvent('print_billing_over_cap', 'error', {
107
- membership_id: row.membership_id,
108
- amount_cents: row.amount_cents,
109
- cap_cents: 7500,
110
- period_ids: row.period_ids,
111
- }, `print_billing_over_cap:${row.membership_id}:${row.period_months[0]}`);
112
- }
113
- if (gate.anomaly) {
114
- await db.opsEvent('print_billing_anomaly', 'error', {
115
- membership_id: row.membership_id,
116
- amount_cents: row.amount_cents,
117
- baseline_cents: baseline.baseline_cents,
118
- qualifying_periods: baseline.qualifying_periods,
119
- period_ids: row.period_ids,
120
- }, `print_billing_anomaly:${row.membership_id}:${row.period_months[0]}`);
121
- }
122
- results.push({ membership_id: row.membership_id, status: 'gated', ...gate });
123
- continue;
124
- }
125
-
126
- // ---- STEP 0.3 / 0.4 ---------------------------------------------------
127
- // C-12: a CANCELED member is billed here like anyone else, using their
128
- // existing Stripe customer id, with no subscription required.
129
- // C-13: standalone customer-scoped invoices do NOT inherit
130
- // subscription.default_payment_method, so it is resolved and set explicitly.
131
- // print_billing_resolve_customer (the DB function) returns identifiers ONLY
132
- // -- stripe_customer_id and stripe_subscription_id. It cannot itself call
133
- // Stripe (C-03: no synchronous HTTP extension in this Postgres), so it does
134
- // NOT resolve a payment method; resolveDefaultPaymentMethod() below does
135
- // that, against a live Stripe client, in the (a) -> (b) -> (c) preference
136
- // order the design requires.
137
- const { data: resolved, error: resolveErr } =
138
- await supabase.rpc('print_billing_resolve_customer',
139
- { p_membership_id: row.membership_id });
140
- if (resolveErr || !resolved?.stripe_customer_id) {
141
- results.push({ membership_id: row.membership_id, status: 'no_customer' });
142
- continue;
143
- }
144
-
145
- // Preference order (C-13): (a) the subscription's own default_payment_method
146
- // (if the member has a live sub), then (b) the customer's own
147
- // invoice_settings default, then (c) none -- the invoice still finalizes and
148
- // duns. 3 of 20 live subscriptions have a different card at (a) than at (b),
149
- // which is why (a) wins and is set explicitly on the invoice.
150
- const pm = await resolveDefaultPaymentMethod(stripe, {
151
- stripeCustomerId: resolved.stripe_customer_id,
152
- stripeSubscriptionId: resolved.stripe_subscription_id ?? null,
153
- });
154
-
155
- const input: RunInput = {
156
- runId: crypto.randomUUID(), // minted BEFORE T1, stable across retries
157
- membershipId: row.membership_id,
158
- customerId: resolved.stripe_customer_id,
159
- periodIds: row.period_ids,
160
- periodMonths: row.period_months,
161
- amountCents: row.amount_cents,
162
- defaultPaymentMethod: pm,
163
- expectedAccountId,
164
- expectedLivemode,
165
- };
166
-
167
- try {
168
- const outcome = await executeBillingRun(stripe, db, input);
169
- results.push({ membership_id: row.membership_id, run_id: input.runId, ...outcome });
170
- } catch (e) {
171
- results.push({
172
- membership_id: row.membership_id,
173
- run_id: input.runId,
174
- status: 'error',
175
- detail: String((e as Error)?.message ?? e),
176
- });
177
- }
178
- }
179
-
180
- return new Response(JSON.stringify({ ok: true, considered: rows.length, results }), {
181
- headers: { 'Content-Type': 'application/json' },
182
- });
183
- }
1
+ // supabase/functions/print-billing-run/index.ts
2
+ //
3
+ // print-usage-bill P2 — the monthly billing run. Design: PRINT-USAGE-BILL-DESIGN.md
4
+ // v19 section 4.2. Runs on the 5th of each month; the 5th is a STAFF BUFFER giving four
5
+ // days to catch a reconciliation mismatch before money moves (section 2.1).
6
+ //
7
+ // All of the decision logic lives in _shared/printBilling.ts, which imports
8
+ // nothing and is fully exercised against a mocked Stripe client in
9
+ // _shared/printBilling.test.ts. This file is the adapter: it builds a real Stripe
10
+ // client and a real Supabase client, enumerates eligible memberships, applies
11
+ // section 4.2's anomaly/cap gate, and hands each membership to the core.
12
+ //
13
+ // C-01: ONE standalone invoice per membership per month, customer-scoped, with no
14
+ // subscription attached and nothing on it but print charges.
15
+ //
16
+ // SECRET-GATED, like the other scheduled functions in this project. It is invoked
17
+ // by pg_cron via net.http_post and by nothing else.
18
+
19
+ import Stripe from 'npm:stripe@17.5.0';
20
+ import { createClient } from 'npm:@supabase/supabase-js@2';
21
+ import {
22
+ evaluateGate,
23
+ executeBillingRun,
24
+ resolveDefaultPaymentMethod,
25
+ type RunInput,
26
+ } from 'npm:@simplelayer/graniteer-core/printBilling';
27
+ import { makeDb, makeStripe } from 'npm:@simplelayer/graniteer-core/printBillingAdapters';
28
+
29
+ function safeEqual(a: string, b: string): boolean {
30
+ const enc = new TextEncoder();
31
+ const ab = enc.encode(a), bb = enc.encode(b);
32
+ if (ab.length !== bb.length) return false;
33
+ let diff = 0;
34
+ for (let i = 0; i < ab.length; i++) diff |= ab[i] ^ bb[i];
35
+ return diff === 0;
36
+ }
37
+
38
+ interface EligibleRow {
39
+ membership_id: string;
40
+ period_ids: string[];
41
+ period_months: string[];
42
+ amount_cents: number;
43
+ }
44
+
45
+ export async function handle(req: Request): Promise<Response> {
46
+ const supabase = createClient(
47
+ Deno.env.get('SUPABASE_URL')!,
48
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
49
+ );
50
+
51
+ // ---- gate ---------------------------------------------------------------
52
+ const { data: secret } = await supabase.rpc('get_print_billing_run_secret');
53
+ const provided = req.headers.get('x-gc-print-billing-secret') ?? '';
54
+ if (!secret || !safeEqual(String(secret), provided)) {
55
+ return new Response(JSON.stringify({ ok: false, error: 'forbidden' }), {
56
+ status: 403, headers: { 'Content-Type': 'application/json' },
57
+ });
58
+ }
59
+
60
+ const stripeKey = Deno.env.get('STRIPE_SECRET_KEY');
61
+ const expectedAccountId = Deno.env.get('STRIPE_ACCOUNT_ID');
62
+ if (!stripeKey || !expectedAccountId) {
63
+ // STEP 0.2 cannot be satisfied without both. Refuse rather than guess: it is
64
+ // the account assertion that makes a later 404 interpretable at all (R8 F3).
65
+ return new Response(JSON.stringify({ ok: false, error: 'stripe_config_missing' }), {
66
+ status: 500, headers: { 'Content-Type': 'application/json' },
67
+ });
68
+ }
69
+
70
+ const rawStripe = new Stripe(stripeKey, {
71
+ apiVersion: '2024-11-20.acacia' as Stripe.LatestApiVersion,
72
+ });
73
+ const stripe = makeStripe(rawStripe);
74
+ const db = makeDb(supabase as never);
75
+ const expectedLivemode = (Deno.env.get('ENVIRONMENT') ?? '') === 'production';
76
+
77
+ // ---- section 4.2 eligibility -------------------------------------------------
78
+ // Wrapped server-side for the same reason section 5.2's selection is (v18/B12-2):
79
+ // the aggregate + HAVING + NOT EXISTS shape is not expressible through PostgREST.
80
+ const { data: eligible, error: eligErr } =
81
+ await supabase.rpc('print_billing_eligible_memberships');
82
+ if (eligErr) {
83
+ return new Response(JSON.stringify({ ok: false, error: eligErr.message }), {
84
+ status: 500, headers: { 'Content-Type': 'application/json' },
85
+ });
86
+ }
87
+
88
+ const rows = (eligible ?? []) as EligibleRow[];
89
+ const results: Record<string, unknown>[] = [];
90
+
91
+ for (const row of rows) {
92
+ // ---- section 4.2's anomaly / cap gate. Runs entirely on DB reads, BEFORE the
93
+ // claim, and it decides whether money moves at all.
94
+ const baseline = await db.baseline(row.membership_id);
95
+ const gate = evaluateGate({
96
+ amountCents: row.amount_cents,
97
+ baselineCents: baseline.baseline_cents,
98
+ qualifyingPeriods: baseline.qualifying_periods,
99
+ });
100
+
101
+ if (gate.blocked) {
102
+ // Both gates are evaluated and BOTH rows are written when both fire — staff
103
+ // need to know which rule caught it, because the two mean different things.
104
+ // The periods stay pending_bill and unclaimed; this needs staff approval.
105
+ if (gate.overCap) {
106
+ await db.opsEvent('print_billing_over_cap', 'error', {
107
+ membership_id: row.membership_id,
108
+ amount_cents: row.amount_cents,
109
+ cap_cents: 7500,
110
+ period_ids: row.period_ids,
111
+ }, `print_billing_over_cap:${row.membership_id}:${row.period_months[0]}`);
112
+ }
113
+ if (gate.anomaly) {
114
+ await db.opsEvent('print_billing_anomaly', 'error', {
115
+ membership_id: row.membership_id,
116
+ amount_cents: row.amount_cents,
117
+ baseline_cents: baseline.baseline_cents,
118
+ qualifying_periods: baseline.qualifying_periods,
119
+ period_ids: row.period_ids,
120
+ }, `print_billing_anomaly:${row.membership_id}:${row.period_months[0]}`);
121
+ }
122
+ results.push({ membership_id: row.membership_id, status: 'gated', ...gate });
123
+ continue;
124
+ }
125
+
126
+ // ---- STEP 0.3 / 0.4 ---------------------------------------------------
127
+ // C-12: a CANCELED member is billed here like anyone else, using their
128
+ // existing Stripe customer id, with no subscription required.
129
+ // C-13: standalone customer-scoped invoices do NOT inherit
130
+ // subscription.default_payment_method, so it is resolved and set explicitly.
131
+ // print_billing_resolve_customer (the DB function) returns identifiers ONLY
132
+ // -- stripe_customer_id and stripe_subscription_id. It cannot itself call
133
+ // Stripe (C-03: no synchronous HTTP extension in this Postgres), so it does
134
+ // NOT resolve a payment method; resolveDefaultPaymentMethod() below does
135
+ // that, against a live Stripe client, in the (a) -> (b) -> (c) preference
136
+ // order the design requires.
137
+ const { data: resolved, error: resolveErr } =
138
+ await supabase.rpc('print_billing_resolve_customer',
139
+ { p_membership_id: row.membership_id });
140
+ if (resolveErr || !resolved?.stripe_customer_id) {
141
+ results.push({ membership_id: row.membership_id, status: 'no_customer' });
142
+ continue;
143
+ }
144
+
145
+ // Preference order (C-13): (a) the subscription's own default_payment_method
146
+ // (if the member has a live sub), then (b) the customer's own
147
+ // invoice_settings default, then (c) none -- the invoice still finalizes and
148
+ // duns. 3 of 20 live subscriptions have a different card at (a) than at (b),
149
+ // which is why (a) wins and is set explicitly on the invoice.
150
+ const pm = await resolveDefaultPaymentMethod(stripe, {
151
+ stripeCustomerId: resolved.stripe_customer_id,
152
+ stripeSubscriptionId: resolved.stripe_subscription_id ?? null,
153
+ });
154
+
155
+ const input: RunInput = {
156
+ runId: crypto.randomUUID(), // minted BEFORE T1, stable across retries
157
+ membershipId: row.membership_id,
158
+ customerId: resolved.stripe_customer_id,
159
+ periodIds: row.period_ids,
160
+ periodMonths: row.period_months,
161
+ amountCents: row.amount_cents,
162
+ defaultPaymentMethod: pm,
163
+ expectedAccountId,
164
+ expectedLivemode,
165
+ };
166
+
167
+ try {
168
+ const outcome = await executeBillingRun(stripe, db, input);
169
+ results.push({ membership_id: row.membership_id, run_id: input.runId, ...outcome });
170
+ } catch (e) {
171
+ results.push({
172
+ membership_id: row.membership_id,
173
+ run_id: input.runId,
174
+ status: 'error',
175
+ detail: String((e as Error)?.message ?? e),
176
+ });
177
+ }
178
+ }
179
+
180
+ return new Response(JSON.stringify({ ok: true, considered: rows.length, results }), {
181
+ headers: { 'Content-Type': 'application/json' },
182
+ });
183
+ }