@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,440 +1,440 @@
1
- import { corsHeaders } from 'npm:@supabase/supabase-js@2/cors';
2
- import { createClient } from 'npm:@supabase/supabase-js@2';
3
- import Stripe from 'npm:stripe@17.5.0';
4
- import { z } from 'npm:zod@3.23.8';
5
- import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
6
- import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
7
- import {
8
- applyCheckoutCoupon,
9
- couponFailureBody,
10
- reverseCheckoutCoupon,
11
- COUPON_START_DATE_CONFLICT_MESSAGE,
12
- } from 'npm:@simplelayer/graniteer-core/checkoutCoupon';
13
- import { buildSubscriptionSessionParams } from 'npm:@simplelayer/graniteer-core/checkoutSessionParams';
14
- // Extracted verbatim (bodies and comments) to _shared/pacificDate.ts so the
15
- // migration-checkout functions can reuse the exact same clamp/validation
16
- // arithmetic instead of duplicating it. Pure refactor: no behavior change.
17
- import { MAX_START_DATE_DAYS, pacificDateStr, addDaysStr } from 'npm:@simplelayer/graniteer-core/pacificDate';
18
-
19
- const Body = z.object({
20
- plan_slug: z.string().min(1).max(80).regex(/^[a-z0-9-]+$/),
21
- email: z.string().email().max(255),
22
- name: z.string().trim().min(1).max(200),
23
- start_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
24
- // Referral program Phase 1. Case-sensitive exact match against
25
- // memberships.referral_code, resolved just below. An unresolvable code is
26
- // silently ignored -- it must never block or error checkout.
27
- referral_code: z.string().trim().min(1).max(32).optional(),
28
- // Internal `coupons` code. Unlike referral_code, an unusable code here is a
29
- // hard 400 -- the member typed it expecting a discount, so charging them
30
- // full price silently is the wrong failure mode.
31
- coupon_code: z.string().trim().min(1).max(40).regex(/^[A-Za-z0-9_-]+$/).optional(),
32
- });
33
-
34
- // MAX_START_DATE_DAYS, pacificDateStr and addDaysStr now live in
35
- // _shared/pacificDate.ts (imported above) — moved there verbatim, comments
36
- // included, so migration-checkout-redirect's dynamic start-date clamp and this
37
- // function's start-date validation cannot drift apart.
38
-
39
- // pacificMidnightUtc/laOffsetMinutes inlined verbatim from gc-connect's
40
- // _shared/agreementActivation.ts (that file stays in gc-connect, out of scope
41
- // this phase -- it also owns BoldSign-specific activation logic this function
42
- // has nothing to do with). Single source of truth for the start instant
43
- // (Pacific midnight -> UTC), reused wherever a plan/agreement needs the same
44
- // clamp/validation arithmetic.
45
- const LA_TZ = 'America/Los_Angeles';
46
-
47
- /**
48
- * Resolve the UTC instant of midnight (00:00) on a Pacific calendar date,
49
- * handling PST/PDT correctly. Returns null for a missing/invalid date string.
50
- */
51
- function pacificMidnightUtc(dateStr: string | null | undefined): Date | null {
52
- if (!dateStr) return null;
53
- const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(String(dateStr));
54
- if (!m) return null;
55
- const [, y, mo, d] = m;
56
- // Start from the UTC-midnight guess, then correct by the zone offset that
57
- // actually applies at that instant (two passes settles DST boundaries).
58
- let ts = Date.UTC(Number(y), Number(mo) - 1, Number(d), 0, 0, 0);
59
- for (let i = 0; i < 2; i++) {
60
- const offsetMinutes = laOffsetMinutes(new Date(ts));
61
- ts = Date.UTC(Number(y), Number(mo) - 1, Number(d), 0, 0, 0) - offsetMinutes * 60_000;
62
- }
63
- return new Date(ts);
64
- }
65
-
66
- /** Offset of America/Los_Angeles from UTC, in minutes, at the given instant. */
67
- function laOffsetMinutes(at: Date): number {
68
- const fmt = new Intl.DateTimeFormat('en-US', {
69
- timeZone: LA_TZ,
70
- hour12: false,
71
- year: 'numeric',
72
- month: '2-digit',
73
- day: '2-digit',
74
- hour: '2-digit',
75
- minute: '2-digit',
76
- second: '2-digit',
77
- });
78
- const parts = Object.fromEntries(
79
- fmt.formatToParts(at).filter((p) => p.type !== 'literal').map((p) => [p.type, p.value]),
80
- ) as Record<string, string>;
81
- const asUtc = Date.UTC(
82
- Number(parts.year),
83
- Number(parts.month) - 1,
84
- Number(parts.day),
85
- Number(parts.hour) % 24,
86
- Number(parts.minute),
87
- Number(parts.second),
88
- );
89
- return (asUtc - at.getTime()) / 60_000;
90
- }
91
-
92
- export async function handle(req: Request, operator: { domain: string; actorEmail: string }): Promise<Response> {
93
- if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
94
-
95
- // Set once a coupon reservation exists. Held at handler scope so the outer
96
- // catch can release it if anything after the reservation throws -- otherwise
97
- // a single-use code stays consumed by a checkout that never started.
98
- let couponRedemptionId: string | null = null;
99
-
100
- try {
101
- const raw = await req.json().catch(() => ({}));
102
- const parsed = Body.safeParse(raw);
103
- if (!parsed.success) {
104
- return new Response(JSON.stringify({ error: parsed.error.flatten() }), {
105
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
106
- });
107
- }
108
- const { plan_slug, email, name, start_date, referral_code, coupon_code } = parsed.data;
109
- const emailKey = email.toLowerCase();
110
-
111
- if (start_date) {
112
- // Round-trip check: rejects a calendar-invalid date (e.g. 2026-02-31) that
113
- // the regex accepts, rather than letting pacificMidnightUtc silently roll
114
- // it over to a different date than the one requested.
115
- if (addDaysStr(start_date, 0) !== start_date) {
116
- return new Response(JSON.stringify({ error: 'start_date_invalid' }), {
117
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
118
- });
119
- }
120
- const today = pacificDateStr(new Date());
121
- if (start_date < today) {
122
- return new Response(JSON.stringify({ error: 'start_date_in_past' }), {
123
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
124
- });
125
- }
126
- if (start_date > addDaysStr(today, MAX_START_DATE_DAYS)) {
127
- return new Response(JSON.stringify({ error: 'start_date_too_far_out' }), {
128
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
129
- });
130
- }
131
- }
132
-
133
- // Single source of truth for the start instant (Pacific midnight -> UTC),
134
- // shared with the private-office path and with stripe-webhook's door gate.
135
- const startInstant = pacificMidnightUtc(start_date ?? null);
136
- // null unless the date is strictly in the future -- a today date keeps
137
- // the original behavior (bill immediately, no anchor, no proration change).
138
- const futureStartUnix = startInstant && startInstant.getTime() > Date.now()
139
- ? Math.floor(startInstant.getTime() / 1000)
140
- : null;
141
-
142
- // An internal coupon plus a FUTURE billing_cycle_anchor is an unverified
143
- // combination on a live-only Stripe account: nobody has confirmed which
144
- // invoice Stripe attaches the `discounts` coupon to, so a duration:'once'
145
- // coupon could be consumed by a $0/placeholder invoice at session creation
146
- // and leave the real first charge at the anchor date at full price -- with
147
- // the internal redemption already flipped to 'applied'. Refuse the pair
148
- // until a real Stripe test settles it. Earliest possible placement: no
149
- // Stripe call, no coupon RPC, not even a Supabase client yet.
150
- // A today-or-past start_date leaves futureStartUnix null (bill immediately,
151
- // no anchor), which is the ordinary path and stays allowed with a coupon.
152
- if (coupon_code && futureStartUnix !== null) {
153
- return new Response(JSON.stringify(couponFailureBody({ message: COUPON_START_DATE_CONFLICT_MESSAGE })), {
154
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
155
- });
156
- }
157
-
158
- const supabase = createClient(
159
- Deno.env.get('SUPABASE_URL')!,
160
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
161
- );
162
-
163
- // Fail-open rate limiting (mirror create-booking).
164
- const ip = clientIp(req);
165
- const [ipOk, emailOk] = await Promise.all([
166
- checkRateLimit(supabase, 'create-subscription', ip, 10, 600),
167
- checkRateLimit(supabase, 'create-subscription-email', emailKey, 5, 600),
168
- ]);
169
- if (!ipOk || !emailOk) {
170
- return new Response(
171
- JSON.stringify({ error: 'Too many checkout attempts — please wait a few minutes and try again.' }),
172
- { status: 429, headers: { ...corsHeaders, 'Content-Type': 'application/json' } },
173
- );
174
- }
175
-
176
- const { data: plan, error: pErr } = await supabase
177
- .from('membership_plans')
178
- .select('id,slug,name,category,active,billable,billing_interval,stripe_price_id,stripe_product_id,price_cents')
179
- .eq('slug', plan_slug)
180
- .maybeSingle();
181
- if (pErr) throw pErr;
182
-
183
- // Self-serve subscription checkout is ALLOWLISTED to these categories.
184
- // `office` is deliberately excluded: private offices are sign-before-pay — a signed
185
- // BoldSign agreement precedes any charge, and boldsign-webhook creates that
186
- // subscription itself. An office plan must never be billable from this public
187
- // endpoint regardless of its flags or whether it has a stripe_price_id.
188
- // Allowlist, not denylist: an unknown or NULL category fails closed.
189
- const SELF_SERVE_CATEGORIES = ['coworking', 'dedicated'];
190
-
191
- // Two supported pricing mechanisms, both still valid for allowlisted categories:
192
- // 1. Stored Stripe Price ID — what all live self-serve plans use today.
193
- // 2. Ad-hoc inline price_data from `price_cents`, so a price change is a DB edit
194
- // with no Stripe Price object churn. This is DELIBERATE — do not "fix" it by
195
- // requiring a stored price ID.
196
- const usesAdHocPrice =
197
- !plan?.stripe_price_id &&
198
- !!plan?.billing_interval &&
199
- typeof plan?.price_cents === 'number' &&
200
- plan.price_cents > 0;
201
-
202
- const eligible =
203
- !!plan &&
204
- plan.active === true &&
205
- plan.billable === true &&
206
- SELF_SERVE_CATEGORIES.includes(plan.category as string) &&
207
- plan.billing_interval === 'month' &&
208
- (!!plan.stripe_price_id || usesAdHocPrice);
209
-
210
- if (!eligible) {
211
- // Best-effort structured deny log. Never blocks or 500s the request.
212
- try {
213
- await logOps(
214
- supabase,
215
- 'subscription_checkout_denied',
216
- {
217
- plan_slug,
218
- ...(plan
219
- ? {
220
- category: plan.category,
221
- active: plan.active,
222
- billable: plan.billable,
223
- billing_interval: plan.billing_interval,
224
- has_price_id: !!plan.stripe_price_id,
225
- }
226
- : {}),
227
- },
228
- // _shared/ops.ts Severity is 'info' | 'warning' | 'error' — 'warn' is not a
229
- // valid value, so the warn-level severity here is 'warning'.
230
- { severity: 'warning' },
231
- );
232
- } catch { /* ignore */ }
233
- return new Response(JSON.stringify({ error: 'That plan is not available for online checkout.' }), {
234
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
235
- });
236
- }
237
-
238
- // Referral program Phase 1: best-effort lookup only. A miss (typo, stale
239
- // code, malicious input) is NOT an error -- it just means no referral
240
- // metadata gets attached, same as if the field had been omitted.
241
- let referralCode: string | undefined;
242
- if (referral_code) {
243
- try {
244
- const { data: referrer, error: refErr } = await supabase
245
- .from('memberships')
246
- .select('id')
247
- .eq('referral_code', referral_code)
248
- .maybeSingle();
249
- if (!refErr && referrer) referralCode = referral_code;
250
- } catch (e) {
251
- console.warn('[create-subscription-checkout] referral_code lookup failed (ignored)', e);
252
- }
253
- }
254
-
255
- const stripeKey = Deno.env.get('STRIPE_SECRET_KEY');
256
- if (!stripeKey) {
257
- return new Response(JSON.stringify({ error: 'Payments not configured (missing STRIPE_SECRET_KEY).' }), {
258
- status: 500, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
259
- });
260
- }
261
- const stripe = new Stripe(stripeKey, { apiVersion: '2024-11-20.acacia' as Stripe.LatestApiVersion });
262
-
263
- // === Optional internal coupon ===
264
- // Runs BEFORE any Stripe Customer or Session is created: a bad code should
265
- // cost one read-only RPC, not a customer record and an abandoned session.
266
- let stripeCouponId: string | null = null;
267
- let couponId: string | null = null;
268
- let couponAttemptId: string | null = null;
269
- if (coupon_code) {
270
- // The discount has to be computed against the SAME amount Stripe is
271
- // about to charge. For the stored-price branch that means asking Stripe
272
- // what the Price is actually worth -- price_cents may be stale or unset
273
- // for those plans.
274
- let baseAmountCents: number | null = null;
275
- if (plan.stripe_price_id) {
276
- try {
277
- const price = await stripe.prices.retrieve(plan.stripe_price_id);
278
- baseAmountCents = price.unit_amount ?? null;
279
- } catch (e) {
280
- console.error('[create-subscription-checkout] prices.retrieve failed', String(e));
281
- }
282
- } else {
283
- baseAmountCents = plan.price_cents as number;
284
- }
285
- if (baseAmountCents === null) {
286
- // Tiered/metered price, or Stripe unreachable -- we cannot size the
287
- // discount, so refuse rather than guess.
288
- return new Response(JSON.stringify(couponFailureBody({ message: "That code isn't valid." })), {
289
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
290
- });
291
- }
292
-
293
- const outcome = await applyCheckoutCoupon(supabase, stripe, {
294
- code: coupon_code,
295
- fnName: 'create-subscription-checkout',
296
- planId: plan.id,
297
- planSlug: plan.slug,
298
- planName: plan.name,
299
- emailKey,
300
- baseAmountCents,
301
- appliedToType: 'membership',
302
- oneTime: false,
303
- actorEmail: operator.actorEmail,
304
- });
305
- if (!outcome.ok) {
306
- return new Response(JSON.stringify(couponFailureBody(outcome)), {
307
- status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
308
- });
309
- }
310
- stripeCouponId = outcome.stripeCouponId;
311
- couponId = outcome.couponId;
312
- couponAttemptId = outcome.attemptId;
313
- couponRedemptionId = outcome.redemptionId;
314
- }
315
-
316
- // Reuse-or-create a Stripe Customer by email. Prefer search; fall back to list.
317
- let customerId: string | null = null;
318
- let matchCount = 0;
319
- try {
320
- const found = await stripe.customers.search({
321
- query: `email:'${emailKey.replace(/'/g, "\\'")}'`,
322
- limit: 2,
323
- });
324
- matchCount = found.data.length;
325
- if (found.data.length > 0) customerId = found.data[0].id;
326
- } catch (e) {
327
- console.warn('[create-subscription-checkout] customers.search failed', e);
328
- }
329
- // Search is eventually consistent (~1 min). Always fall back to list for freshly-created customers.
330
- if (!customerId) {
331
- try {
332
- const listed = await stripe.customers.list({ email: emailKey, limit: 2 });
333
- matchCount = listed.data.length;
334
- if (listed.data.length > 0) customerId = listed.data[0].id;
335
- } catch (e2) {
336
- console.warn('[create-subscription-checkout] customers.list failed', e2);
337
- }
338
- }
339
- // Stripe does NOT enforce Customer email uniqueness. With >1 Customer per
340
- // email the reused id is arbitrary, which makes any stripe_customer_id
341
- // predicate downstream nondeterministic. Assert exactly one; flag otherwise.
342
- // This is the second, INDEPENDENT copy of reuse-or-create-by-email; the
343
- // other lives in _shared/agreementCheckout.ts. They are not byte-identical
344
- // (this one also updates the reused customer's name), so both are fixed.
345
- if (matchCount > 1) {
346
- console.error('[create-subscription-checkout] multiple Stripe Customers for one email',
347
- { email: emailKey, match_count: matchCount, chosen: customerId });
348
- }
349
- if (customerId) {
350
- // Best-effort: keep the reused customer's name current. Never block checkout.
351
- try {
352
- await stripe.customers.update(customerId, { name });
353
- } catch (e3) {
354
- console.warn('[create-subscription-checkout] customers.update name failed', e3);
355
- }
356
- } else {
357
- const created = await stripe.customers.create({ email: emailKey, name });
358
- customerId = created.id;
359
- }
360
-
361
- const origin = req.headers.get('origin');
362
- const base = origin && /^https?:\/\//.test(origin) ? origin : `https://${operator.domain}`;
363
-
364
- const metadata: Record<string, string> = {
365
- checkout_type: 'membership',
366
- plan_slug: plan.slug,
367
- plan_id: plan.id,
368
- ...(start_date ? { start_date } : {}),
369
- ...(referralCode ? { referral_code: referralCode } : {}),
370
- // stripe-webhook reads these back to flip the reservation to 'applied'
371
- // once payment lands, or reverse it if the session expires.
372
- ...(couponRedemptionId ? { coupon_redemption_id: couponRedemptionId } : {}),
373
- ...(couponId ? { coupon_id: couponId } : {}),
374
- // Opaque per-attempt uuid; it is the redemption row's applied_to_id, so
375
- // this is what correlates that row back to this checkout attempt.
376
- ...(couponAttemptId ? { coupon_attempt_id: couponAttemptId } : {}),
377
- };
378
-
379
- const lineItem: Stripe.Checkout.SessionCreateParams.LineItem = plan.stripe_price_id
380
- ? { price: plan.stripe_price_id, quantity: 1 }
381
- : {
382
- price_data: {
383
- currency: 'usd',
384
- product_data: { name: plan.name },
385
- unit_amount: plan.price_cents as number,
386
- recurring: {
387
- interval: plan.billing_interval as Stripe.Checkout.SessionCreateParams.LineItem.PriceData.Recurring.Interval,
388
- },
389
- },
390
- quantity: 1,
391
- };
392
-
393
- // Future start date: anchor the first billing cycle to Pacific midnight on
394
- // that date with proration_behavior 'none', so the member isn't charged
395
- // until then (mirrors maybeActivateAgreement's office-subscription path).
396
- const subscriptionData: Stripe.Checkout.SessionCreateParams.SubscriptionData =
397
- futureStartUnix !== null
398
- ? { metadata, billing_cycle_anchor: futureStartUnix, proration_behavior: 'none' }
399
- : { metadata };
400
-
401
- const session = await stripe.checkout.sessions.create(buildSubscriptionSessionParams({
402
- customerId,
403
- lineItem,
404
- metadata,
405
- subscriptionData,
406
- // start_date is only appended when it's a validated YYYY-MM-DD in the future
407
- // (futureStartUnix is non-null iff start_date was parsed and is strictly
408
- // ahead of now), so start_date is guaranteed defined here.
409
- successUrl: futureStartUnix !== null
410
- ? `${base}/membership/success?session_id={CHECKOUT_SESSION_ID}&start_date=${start_date!}`
411
- : `${base}/membership/success?session_id={CHECKOUT_SESSION_ID}`,
412
- cancelUrl: `${base}/pricing`,
413
- stripeCouponId,
414
- }));
415
-
416
- return new Response(JSON.stringify({ url: session.url }), {
417
- headers: { ...corsHeaders, 'Content-Type': 'application/json' },
418
- });
419
- } catch (e) {
420
- console.error('create-subscription-checkout error', e);
421
- try {
422
- const opsClient = createClient(
423
- Deno.env.get('SUPABASE_URL') ?? '',
424
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY') ?? '',
425
- );
426
- // Checkout died after the coupon was reserved -- hand the redemption
427
- // back. Runs BEFORE logOps so a failing ops write can't skip it.
428
- if (couponRedemptionId) {
429
- await reverseCheckoutCoupon(opsClient, couponRedemptionId,
430
- 'subscription_checkout_error', 'create-subscription-checkout', operator.actorEmail);
431
- }
432
- await logOps(opsClient, 'subscription_checkout_error',
433
- { message: e instanceof Error ? e.message : String(e) },
434
- { severity: 'error' });
435
- } catch { /* ignore */ }
436
- return new Response(JSON.stringify({ error: 'Something went wrong starting your checkout. Please try again.' }), {
437
- status: 500, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
438
- });
439
- }
440
- }
1
+ import { corsHeaders } from 'npm:@supabase/supabase-js@2/cors';
2
+ import { createClient } from 'npm:@supabase/supabase-js@2';
3
+ import Stripe from 'npm:stripe@17.5.0';
4
+ import { z } from 'npm:zod@3.23.8';
5
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
6
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
7
+ import {
8
+ applyCheckoutCoupon,
9
+ couponFailureBody,
10
+ reverseCheckoutCoupon,
11
+ COUPON_START_DATE_CONFLICT_MESSAGE,
12
+ } from 'npm:@simplelayer/graniteer-core/checkoutCoupon';
13
+ import { buildSubscriptionSessionParams } from 'npm:@simplelayer/graniteer-core/checkoutSessionParams';
14
+ // Extracted verbatim (bodies and comments) to _shared/pacificDate.ts so the
15
+ // migration-checkout functions can reuse the exact same clamp/validation
16
+ // arithmetic instead of duplicating it. Pure refactor: no behavior change.
17
+ import { MAX_START_DATE_DAYS, pacificDateStr, addDaysStr } from 'npm:@simplelayer/graniteer-core/pacificDate';
18
+
19
+ const Body = z.object({
20
+ plan_slug: z.string().min(1).max(80).regex(/^[a-z0-9-]+$/),
21
+ email: z.string().email().max(255),
22
+ name: z.string().trim().min(1).max(200),
23
+ start_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
24
+ // Referral program Phase 1. Case-sensitive exact match against
25
+ // memberships.referral_code, resolved just below. An unresolvable code is
26
+ // silently ignored -- it must never block or error checkout.
27
+ referral_code: z.string().trim().min(1).max(32).optional(),
28
+ // Internal `coupons` code. Unlike referral_code, an unusable code here is a
29
+ // hard 400 -- the member typed it expecting a discount, so charging them
30
+ // full price silently is the wrong failure mode.
31
+ coupon_code: z.string().trim().min(1).max(40).regex(/^[A-Za-z0-9_-]+$/).optional(),
32
+ });
33
+
34
+ // MAX_START_DATE_DAYS, pacificDateStr and addDaysStr now live in
35
+ // _shared/pacificDate.ts (imported above) — moved there verbatim, comments
36
+ // included, so migration-checkout-redirect's dynamic start-date clamp and this
37
+ // function's start-date validation cannot drift apart.
38
+
39
+ // pacificMidnightUtc/laOffsetMinutes inlined verbatim from gc-connect's
40
+ // _shared/agreementActivation.ts (that file stays in gc-connect, out of scope
41
+ // this phase -- it also owns BoldSign-specific activation logic this function
42
+ // has nothing to do with). Single source of truth for the start instant
43
+ // (Pacific midnight -> UTC), reused wherever a plan/agreement needs the same
44
+ // clamp/validation arithmetic.
45
+ const LA_TZ = 'America/Los_Angeles';
46
+
47
+ /**
48
+ * Resolve the UTC instant of midnight (00:00) on a Pacific calendar date,
49
+ * handling PST/PDT correctly. Returns null for a missing/invalid date string.
50
+ */
51
+ function pacificMidnightUtc(dateStr: string | null | undefined): Date | null {
52
+ if (!dateStr) return null;
53
+ const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(String(dateStr));
54
+ if (!m) return null;
55
+ const [, y, mo, d] = m;
56
+ // Start from the UTC-midnight guess, then correct by the zone offset that
57
+ // actually applies at that instant (two passes settles DST boundaries).
58
+ let ts = Date.UTC(Number(y), Number(mo) - 1, Number(d), 0, 0, 0);
59
+ for (let i = 0; i < 2; i++) {
60
+ const offsetMinutes = laOffsetMinutes(new Date(ts));
61
+ ts = Date.UTC(Number(y), Number(mo) - 1, Number(d), 0, 0, 0) - offsetMinutes * 60_000;
62
+ }
63
+ return new Date(ts);
64
+ }
65
+
66
+ /** Offset of America/Los_Angeles from UTC, in minutes, at the given instant. */
67
+ function laOffsetMinutes(at: Date): number {
68
+ const fmt = new Intl.DateTimeFormat('en-US', {
69
+ timeZone: LA_TZ,
70
+ hour12: false,
71
+ year: 'numeric',
72
+ month: '2-digit',
73
+ day: '2-digit',
74
+ hour: '2-digit',
75
+ minute: '2-digit',
76
+ second: '2-digit',
77
+ });
78
+ const parts = Object.fromEntries(
79
+ fmt.formatToParts(at).filter((p) => p.type !== 'literal').map((p) => [p.type, p.value]),
80
+ ) as Record<string, string>;
81
+ const asUtc = Date.UTC(
82
+ Number(parts.year),
83
+ Number(parts.month) - 1,
84
+ Number(parts.day),
85
+ Number(parts.hour) % 24,
86
+ Number(parts.minute),
87
+ Number(parts.second),
88
+ );
89
+ return (asUtc - at.getTime()) / 60_000;
90
+ }
91
+
92
+ export async function handle(req: Request, operator: { domain: string; actorEmail: string }): Promise<Response> {
93
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
94
+
95
+ // Set once a coupon reservation exists. Held at handler scope so the outer
96
+ // catch can release it if anything after the reservation throws -- otherwise
97
+ // a single-use code stays consumed by a checkout that never started.
98
+ let couponRedemptionId: string | null = null;
99
+
100
+ try {
101
+ const raw = await req.json().catch(() => ({}));
102
+ const parsed = Body.safeParse(raw);
103
+ if (!parsed.success) {
104
+ return new Response(JSON.stringify({ error: parsed.error.flatten() }), {
105
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
106
+ });
107
+ }
108
+ const { plan_slug, email, name, start_date, referral_code, coupon_code } = parsed.data;
109
+ const emailKey = email.toLowerCase();
110
+
111
+ if (start_date) {
112
+ // Round-trip check: rejects a calendar-invalid date (e.g. 2026-02-31) that
113
+ // the regex accepts, rather than letting pacificMidnightUtc silently roll
114
+ // it over to a different date than the one requested.
115
+ if (addDaysStr(start_date, 0) !== start_date) {
116
+ return new Response(JSON.stringify({ error: 'start_date_invalid' }), {
117
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
118
+ });
119
+ }
120
+ const today = pacificDateStr(new Date());
121
+ if (start_date < today) {
122
+ return new Response(JSON.stringify({ error: 'start_date_in_past' }), {
123
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
124
+ });
125
+ }
126
+ if (start_date > addDaysStr(today, MAX_START_DATE_DAYS)) {
127
+ return new Response(JSON.stringify({ error: 'start_date_too_far_out' }), {
128
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
129
+ });
130
+ }
131
+ }
132
+
133
+ // Single source of truth for the start instant (Pacific midnight -> UTC),
134
+ // shared with the private-office path and with stripe-webhook's door gate.
135
+ const startInstant = pacificMidnightUtc(start_date ?? null);
136
+ // null unless the date is strictly in the future -- a today date keeps
137
+ // the original behavior (bill immediately, no anchor, no proration change).
138
+ const futureStartUnix = startInstant && startInstant.getTime() > Date.now()
139
+ ? Math.floor(startInstant.getTime() / 1000)
140
+ : null;
141
+
142
+ // An internal coupon plus a FUTURE billing_cycle_anchor is an unverified
143
+ // combination on a live-only Stripe account: nobody has confirmed which
144
+ // invoice Stripe attaches the `discounts` coupon to, so a duration:'once'
145
+ // coupon could be consumed by a $0/placeholder invoice at session creation
146
+ // and leave the real first charge at the anchor date at full price -- with
147
+ // the internal redemption already flipped to 'applied'. Refuse the pair
148
+ // until a real Stripe test settles it. Earliest possible placement: no
149
+ // Stripe call, no coupon RPC, not even a Supabase client yet.
150
+ // A today-or-past start_date leaves futureStartUnix null (bill immediately,
151
+ // no anchor), which is the ordinary path and stays allowed with a coupon.
152
+ if (coupon_code && futureStartUnix !== null) {
153
+ return new Response(JSON.stringify(couponFailureBody({ message: COUPON_START_DATE_CONFLICT_MESSAGE })), {
154
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
155
+ });
156
+ }
157
+
158
+ const supabase = createClient(
159
+ Deno.env.get('SUPABASE_URL')!,
160
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
161
+ );
162
+
163
+ // Fail-open rate limiting (mirror create-booking).
164
+ const ip = clientIp(req);
165
+ const [ipOk, emailOk] = await Promise.all([
166
+ checkRateLimit(supabase, 'create-subscription', ip, 10, 600),
167
+ checkRateLimit(supabase, 'create-subscription-email', emailKey, 5, 600),
168
+ ]);
169
+ if (!ipOk || !emailOk) {
170
+ return new Response(
171
+ JSON.stringify({ error: 'Too many checkout attempts — please wait a few minutes and try again.' }),
172
+ { status: 429, headers: { ...corsHeaders, 'Content-Type': 'application/json' } },
173
+ );
174
+ }
175
+
176
+ const { data: plan, error: pErr } = await supabase
177
+ .from('membership_plans')
178
+ .select('id,slug,name,category,active,billable,billing_interval,stripe_price_id,stripe_product_id,price_cents')
179
+ .eq('slug', plan_slug)
180
+ .maybeSingle();
181
+ if (pErr) throw pErr;
182
+
183
+ // Self-serve subscription checkout is ALLOWLISTED to these categories.
184
+ // `office` is deliberately excluded: private offices are sign-before-pay — a signed
185
+ // BoldSign agreement precedes any charge, and boldsign-webhook creates that
186
+ // subscription itself. An office plan must never be billable from this public
187
+ // endpoint regardless of its flags or whether it has a stripe_price_id.
188
+ // Allowlist, not denylist: an unknown or NULL category fails closed.
189
+ const SELF_SERVE_CATEGORIES = ['coworking', 'dedicated'];
190
+
191
+ // Two supported pricing mechanisms, both still valid for allowlisted categories:
192
+ // 1. Stored Stripe Price ID — what all live self-serve plans use today.
193
+ // 2. Ad-hoc inline price_data from `price_cents`, so a price change is a DB edit
194
+ // with no Stripe Price object churn. This is DELIBERATE — do not "fix" it by
195
+ // requiring a stored price ID.
196
+ const usesAdHocPrice =
197
+ !plan?.stripe_price_id &&
198
+ !!plan?.billing_interval &&
199
+ typeof plan?.price_cents === 'number' &&
200
+ plan.price_cents > 0;
201
+
202
+ const eligible =
203
+ !!plan &&
204
+ plan.active === true &&
205
+ plan.billable === true &&
206
+ SELF_SERVE_CATEGORIES.includes(plan.category as string) &&
207
+ plan.billing_interval === 'month' &&
208
+ (!!plan.stripe_price_id || usesAdHocPrice);
209
+
210
+ if (!eligible) {
211
+ // Best-effort structured deny log. Never blocks or 500s the request.
212
+ try {
213
+ await logOps(
214
+ supabase,
215
+ 'subscription_checkout_denied',
216
+ {
217
+ plan_slug,
218
+ ...(plan
219
+ ? {
220
+ category: plan.category,
221
+ active: plan.active,
222
+ billable: plan.billable,
223
+ billing_interval: plan.billing_interval,
224
+ has_price_id: !!plan.stripe_price_id,
225
+ }
226
+ : {}),
227
+ },
228
+ // _shared/ops.ts Severity is 'info' | 'warning' | 'error' — 'warn' is not a
229
+ // valid value, so the warn-level severity here is 'warning'.
230
+ { severity: 'warning' },
231
+ );
232
+ } catch { /* ignore */ }
233
+ return new Response(JSON.stringify({ error: 'That plan is not available for online checkout.' }), {
234
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
235
+ });
236
+ }
237
+
238
+ // Referral program Phase 1: best-effort lookup only. A miss (typo, stale
239
+ // code, malicious input) is NOT an error -- it just means no referral
240
+ // metadata gets attached, same as if the field had been omitted.
241
+ let referralCode: string | undefined;
242
+ if (referral_code) {
243
+ try {
244
+ const { data: referrer, error: refErr } = await supabase
245
+ .from('memberships')
246
+ .select('id')
247
+ .eq('referral_code', referral_code)
248
+ .maybeSingle();
249
+ if (!refErr && referrer) referralCode = referral_code;
250
+ } catch (e) {
251
+ console.warn('[create-subscription-checkout] referral_code lookup failed (ignored)', e);
252
+ }
253
+ }
254
+
255
+ const stripeKey = Deno.env.get('STRIPE_SECRET_KEY');
256
+ if (!stripeKey) {
257
+ return new Response(JSON.stringify({ error: 'Payments not configured (missing STRIPE_SECRET_KEY).' }), {
258
+ status: 500, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
259
+ });
260
+ }
261
+ const stripe = new Stripe(stripeKey, { apiVersion: '2024-11-20.acacia' as Stripe.LatestApiVersion });
262
+
263
+ // === Optional internal coupon ===
264
+ // Runs BEFORE any Stripe Customer or Session is created: a bad code should
265
+ // cost one read-only RPC, not a customer record and an abandoned session.
266
+ let stripeCouponId: string | null = null;
267
+ let couponId: string | null = null;
268
+ let couponAttemptId: string | null = null;
269
+ if (coupon_code) {
270
+ // The discount has to be computed against the SAME amount Stripe is
271
+ // about to charge. For the stored-price branch that means asking Stripe
272
+ // what the Price is actually worth -- price_cents may be stale or unset
273
+ // for those plans.
274
+ let baseAmountCents: number | null = null;
275
+ if (plan.stripe_price_id) {
276
+ try {
277
+ const price = await stripe.prices.retrieve(plan.stripe_price_id);
278
+ baseAmountCents = price.unit_amount ?? null;
279
+ } catch (e) {
280
+ console.error('[create-subscription-checkout] prices.retrieve failed', String(e));
281
+ }
282
+ } else {
283
+ baseAmountCents = plan.price_cents as number;
284
+ }
285
+ if (baseAmountCents === null) {
286
+ // Tiered/metered price, or Stripe unreachable -- we cannot size the
287
+ // discount, so refuse rather than guess.
288
+ return new Response(JSON.stringify(couponFailureBody({ message: "That code isn't valid." })), {
289
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
290
+ });
291
+ }
292
+
293
+ const outcome = await applyCheckoutCoupon(supabase, stripe, {
294
+ code: coupon_code,
295
+ fnName: 'create-subscription-checkout',
296
+ planId: plan.id,
297
+ planSlug: plan.slug,
298
+ planName: plan.name,
299
+ emailKey,
300
+ baseAmountCents,
301
+ appliedToType: 'membership',
302
+ oneTime: false,
303
+ actorEmail: operator.actorEmail,
304
+ });
305
+ if (!outcome.ok) {
306
+ return new Response(JSON.stringify(couponFailureBody(outcome)), {
307
+ status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
308
+ });
309
+ }
310
+ stripeCouponId = outcome.stripeCouponId;
311
+ couponId = outcome.couponId;
312
+ couponAttemptId = outcome.attemptId;
313
+ couponRedemptionId = outcome.redemptionId;
314
+ }
315
+
316
+ // Reuse-or-create a Stripe Customer by email. Prefer search; fall back to list.
317
+ let customerId: string | null = null;
318
+ let matchCount = 0;
319
+ try {
320
+ const found = await stripe.customers.search({
321
+ query: `email:'${emailKey.replace(/'/g, "\\'")}'`,
322
+ limit: 2,
323
+ });
324
+ matchCount = found.data.length;
325
+ if (found.data.length > 0) customerId = found.data[0].id;
326
+ } catch (e) {
327
+ console.warn('[create-subscription-checkout] customers.search failed', e);
328
+ }
329
+ // Search is eventually consistent (~1 min). Always fall back to list for freshly-created customers.
330
+ if (!customerId) {
331
+ try {
332
+ const listed = await stripe.customers.list({ email: emailKey, limit: 2 });
333
+ matchCount = listed.data.length;
334
+ if (listed.data.length > 0) customerId = listed.data[0].id;
335
+ } catch (e2) {
336
+ console.warn('[create-subscription-checkout] customers.list failed', e2);
337
+ }
338
+ }
339
+ // Stripe does NOT enforce Customer email uniqueness. With >1 Customer per
340
+ // email the reused id is arbitrary, which makes any stripe_customer_id
341
+ // predicate downstream nondeterministic. Assert exactly one; flag otherwise.
342
+ // This is the second, INDEPENDENT copy of reuse-or-create-by-email; the
343
+ // other lives in _shared/agreementCheckout.ts. They are not byte-identical
344
+ // (this one also updates the reused customer's name), so both are fixed.
345
+ if (matchCount > 1) {
346
+ console.error('[create-subscription-checkout] multiple Stripe Customers for one email',
347
+ { email: emailKey, match_count: matchCount, chosen: customerId });
348
+ }
349
+ if (customerId) {
350
+ // Best-effort: keep the reused customer's name current. Never block checkout.
351
+ try {
352
+ await stripe.customers.update(customerId, { name });
353
+ } catch (e3) {
354
+ console.warn('[create-subscription-checkout] customers.update name failed', e3);
355
+ }
356
+ } else {
357
+ const created = await stripe.customers.create({ email: emailKey, name });
358
+ customerId = created.id;
359
+ }
360
+
361
+ const origin = req.headers.get('origin');
362
+ const base = origin && /^https?:\/\//.test(origin) ? origin : `https://${operator.domain}`;
363
+
364
+ const metadata: Record<string, string> = {
365
+ checkout_type: 'membership',
366
+ plan_slug: plan.slug,
367
+ plan_id: plan.id,
368
+ ...(start_date ? { start_date } : {}),
369
+ ...(referralCode ? { referral_code: referralCode } : {}),
370
+ // stripe-webhook reads these back to flip the reservation to 'applied'
371
+ // once payment lands, or reverse it if the session expires.
372
+ ...(couponRedemptionId ? { coupon_redemption_id: couponRedemptionId } : {}),
373
+ ...(couponId ? { coupon_id: couponId } : {}),
374
+ // Opaque per-attempt uuid; it is the redemption row's applied_to_id, so
375
+ // this is what correlates that row back to this checkout attempt.
376
+ ...(couponAttemptId ? { coupon_attempt_id: couponAttemptId } : {}),
377
+ };
378
+
379
+ const lineItem: Stripe.Checkout.SessionCreateParams.LineItem = plan.stripe_price_id
380
+ ? { price: plan.stripe_price_id, quantity: 1 }
381
+ : {
382
+ price_data: {
383
+ currency: 'usd',
384
+ product_data: { name: plan.name },
385
+ unit_amount: plan.price_cents as number,
386
+ recurring: {
387
+ interval: plan.billing_interval as Stripe.Checkout.SessionCreateParams.LineItem.PriceData.Recurring.Interval,
388
+ },
389
+ },
390
+ quantity: 1,
391
+ };
392
+
393
+ // Future start date: anchor the first billing cycle to Pacific midnight on
394
+ // that date with proration_behavior 'none', so the member isn't charged
395
+ // until then (mirrors maybeActivateAgreement's office-subscription path).
396
+ const subscriptionData: Stripe.Checkout.SessionCreateParams.SubscriptionData =
397
+ futureStartUnix !== null
398
+ ? { metadata, billing_cycle_anchor: futureStartUnix, proration_behavior: 'none' }
399
+ : { metadata };
400
+
401
+ const session = await stripe.checkout.sessions.create(buildSubscriptionSessionParams({
402
+ customerId,
403
+ lineItem,
404
+ metadata,
405
+ subscriptionData,
406
+ // start_date is only appended when it's a validated YYYY-MM-DD in the future
407
+ // (futureStartUnix is non-null iff start_date was parsed and is strictly
408
+ // ahead of now), so start_date is guaranteed defined here.
409
+ successUrl: futureStartUnix !== null
410
+ ? `${base}/membership/success?session_id={CHECKOUT_SESSION_ID}&start_date=${start_date!}`
411
+ : `${base}/membership/success?session_id={CHECKOUT_SESSION_ID}`,
412
+ cancelUrl: `${base}/pricing`,
413
+ stripeCouponId,
414
+ }));
415
+
416
+ return new Response(JSON.stringify({ url: session.url }), {
417
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
418
+ });
419
+ } catch (e) {
420
+ console.error('create-subscription-checkout error', e);
421
+ try {
422
+ const opsClient = createClient(
423
+ Deno.env.get('SUPABASE_URL') ?? '',
424
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY') ?? '',
425
+ );
426
+ // Checkout died after the coupon was reserved -- hand the redemption
427
+ // back. Runs BEFORE logOps so a failing ops write can't skip it.
428
+ if (couponRedemptionId) {
429
+ await reverseCheckoutCoupon(opsClient, couponRedemptionId,
430
+ 'subscription_checkout_error', 'create-subscription-checkout', operator.actorEmail);
431
+ }
432
+ await logOps(opsClient, 'subscription_checkout_error',
433
+ { message: e instanceof Error ? e.message : String(e) },
434
+ { severity: 'error' });
435
+ } catch { /* ignore */ }
436
+ return new Response(JSON.stringify({ error: 'Something went wrong starting your checkout. Please try again.' }), {
437
+ status: 500, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
438
+ });
439
+ }
440
+ }