@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,214 +1,214 @@
1
- // supabase/functions/admin-send-commons-agreement/index.ts
2
- //
3
- // The missing piece of the Commons (Tier 3) contract flow: admin-create-commons-event
4
- // creates the pending booking but deliberately never sends a contract. send-booking-agreement
5
- // fully supports tier-3 rendering but is internal-only (service-role auth, "never called by a
6
- // browser"). This function is the staff-facing bridge: verify the caller is an authenticated
7
- // admin, validate the booking is a sendable tier-3 pending hold, then call send-booking-agreement
8
- // server-to-server with the service-role key.
9
- //
10
- // Auth scaffold is the same shape as admin-create-commons-event: JWKS-verified caller JWT,
11
- // aal2 required, admin_users allowlist re-checked server-side, rate limited on distinct buckets.
12
- import { createClient } from 'npm:@supabase/supabase-js@2';
13
- import { z } from 'npm:zod@3.23.8';
14
- import { jwtVerify, createRemoteJWKSet } from 'npm:jose@5.9.6';
15
- import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
16
- import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
17
-
18
- const corsHeaders = {
19
- 'Access-Control-Allow-Origin': '*',
20
- 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
21
- 'Access-Control-Allow-Methods': 'POST, OPTIONS',
22
- };
23
-
24
- interface CallerClaims { sub: string; email?: string; aal?: string }
25
-
26
- const JWKS_URL_SUFFIX = '/auth/v1/.well-known/jwks.json';
27
- let jwksCache: ReturnType<typeof createRemoteJWKSet> | null = null;
28
- function getJwks(supabaseUrl: string) {
29
- if (!jwksCache) jwksCache = createRemoteJWKSet(new URL(`${supabaseUrl}${JWKS_URL_SUFFIX}`));
30
- return jwksCache;
31
- }
32
- async function verifyCaller(authHeader: string | null, supabaseUrl: string): Promise<CallerClaims | null> {
33
- if (!authHeader?.toLowerCase().startsWith('bearer ')) return null;
34
- const token = authHeader.slice(7).trim();
35
- try {
36
- const { payload } = await jwtVerify(token, getJwks(supabaseUrl));
37
- const claims = payload as unknown as CallerClaims;
38
- if (!claims.sub) return null;
39
- return claims;
40
- } catch { return null; }
41
- }
42
-
43
- function json(status: number, body: unknown) {
44
- return new Response(JSON.stringify(body), {
45
- status, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
46
- });
47
- }
48
- function fail(status: number, code: string, error: string, extra?: Record<string, unknown>) {
49
- return json(status, { ok: false, status, code, error, ...(extra ?? {}) });
50
- }
51
-
52
- const Body = z.object({
53
- booking_id: z.string().uuid(),
54
- client_legal_name: z.string().trim().min(1).max(300),
55
- security_deposit_cents: z.number().int().min(0),
56
- });
57
-
58
- export async function handle(req: Request): Promise<Response> {
59
- if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
60
- if (req.method !== 'POST') return fail(405, 'method_not_allowed', 'Method not allowed.');
61
-
62
- const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
63
- const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
64
-
65
- // === Admin auth: same shape as admin-create-commons-event ===
66
- const authHeader = req.headers.get('Authorization') || req.headers.get('authorization');
67
- const caller = await verifyCaller(authHeader, SUPABASE_URL);
68
- if (!caller) return fail(401, 'unauthenticated', 'Not signed in.');
69
- if (caller.aal !== 'aal2') return fail(403, 'mfa_required', 'Two-factor authentication is required.');
70
- const callerEmail = (caller.email ?? '').toLowerCase();
71
- if (!callerEmail) return fail(403, 'no_email', 'Caller has no email claim.');
72
-
73
- const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
74
- auth: { persistSession: false, autoRefreshToken: false },
75
- });
76
-
77
- const [ipOk, emailOk] = await Promise.all([
78
- checkRateLimit(admin, 'admin-send-commons-agreement-ip', clientIp(req), 20, 300),
79
- checkRateLimit(admin, 'admin-send-commons-agreement-email', callerEmail, 20, 300),
80
- ]);
81
- if (!ipOk || !emailOk) return fail(429, 'rate_limited', 'Too many attempts — try again shortly.');
82
-
83
- const { data: allow, error: allowErr } = await admin
84
- .from('admin_users').select('email').eq('email', callerEmail).maybeSingle();
85
- if (allowErr) return fail(500, 'allowlist_lookup_failed', allowErr.message);
86
- if (!allow) return fail(403, 'not_authorized', 'Not authorized.');
87
-
88
- // === Body ===
89
- let raw: unknown;
90
- try { raw = await req.json(); } catch { return fail(400, 'invalid_json', 'Body was not valid JSON.'); }
91
- const parsed = Body.safeParse(raw);
92
- if (!parsed.success) {
93
- return fail(400, 'invalid_body', JSON.stringify(parsed.error.flatten().fieldErrors));
94
- }
95
- const { booking_id, client_legal_name, security_deposit_cents } = parsed.data;
96
-
97
- // === Booking + tier ===
98
- const { data: booking, error: bErr } = await admin
99
- .from('bookings')
100
- .select('id,room_id,status,hold_expires_at,list_amount_cents,deposit_amount_cents,contact_name,contact_email,contract_skipped_at')
101
- .eq('id', booking_id)
102
- .maybeSingle();
103
- if (bErr) return fail(500, 'booking_lookup_failed', bErr.message);
104
- if (!booking) return fail(404, 'booking_not_found', 'Booking not found.');
105
-
106
- const depositAmountCents = Number(booking.deposit_amount_cents);
107
- if (!Number.isInteger(depositAmountCents) || depositAmountCents <= 0) {
108
- return fail(409, 'invalid_deposit_amount', 'This booking has no valid deposit amount set; fix the booking before sending a contract.');
109
- }
110
-
111
- const { data: tier, error: tErr } = await admin
112
- .rpc('resolve_room_contract_tier', { p_room_id: booking.room_id });
113
- if (tErr) return fail(500, 'tier_lookup_failed', tErr.message);
114
- if (Number(tier) !== 3) {
115
- return fail(409, 'not_tier3', 'This booking is not a tier-3 (contract + deposit) room.');
116
- }
117
-
118
- if (booking.status !== 'pending') {
119
- return fail(409, 'booking_not_pending', `Booking status is "${booking.status}"; only a pending hold can be sent a contract.`);
120
- }
121
-
122
- if (booking.contract_skipped_at) {
123
- return fail(409, 'contract_skipped', 'This booking\'s contract was deliberately skipped by staff; sending one now would contradict that decision. Clear contract_skipped_at first if this was a mistake.');
124
- }
125
-
126
- const holdExpiresMs = booking.hold_expires_at ? Date.parse(String(booking.hold_expires_at)) : NaN;
127
- if (!Number.isFinite(holdExpiresMs) || holdExpiresMs <= Date.now()) {
128
- return fail(409, 'hold_expired', 'This booking\'s hold has already expired.');
129
- }
130
-
131
- // NOTE: no ceiling here tied to list_amount_cents. A refundable, uncharged
132
- // security deposit has no arithmetic relationship to the event's rental
133
- // fee (a $500 deposit on a $300 event is completely normal venue practice)
134
- // -- send-booking-agreement's own 0..10_000_000 sanity bound (an absolute
135
- // cap, not a ratio) is the only ceiling that belongs here.
136
-
137
- // === Already sent? Avoid a wasted render+BoldSign attempt that would only
138
- // be rejected downstream anyway (send-booking-agreement's own claim
139
- // guard only accepts 'draft'/'failed'). ===
140
- const { data: existingAgreement, error: eaErr } = await admin
141
- .from('booking_agreements')
142
- .select('id,status,created_at')
143
- .eq('booking_id', booking_id)
144
- .maybeSingle();
145
- if (eaErr) return fail(500, 'agreement_lookup_failed', eaErr.message);
146
-
147
- // Recovery path: a crashed/interrupted send can leave a row stuck at
148
- // 'sending' forever, which would otherwise block every future attempt with
149
- // no way out. If it's been stuck more than 10 minutes, recover it to
150
- // 'failed' so the normal retry path below can claim it.
151
- const STUCK_SENDING_MS = 10 * 60 * 1000;
152
- if (existingAgreement && existingAgreement.status === 'sending') {
153
- const ageMs = Date.now() - Date.parse(String(existingAgreement.created_at));
154
- if (Number.isFinite(ageMs) && ageMs > STUCK_SENDING_MS) {
155
- await admin.from('booking_agreements').update({
156
- status: 'failed',
157
- last_error: 'recovered_from_stuck_sending',
158
- }).eq('id', existingAgreement.id).eq('status', 'sending');
159
- await logOps(admin, 'commons_agreement_stuck_sending_recovered', {
160
- agreement_id: existingAgreement.id, booking_id, age_ms: ageMs,
161
- }, { severity: 'warning', bookingId: booking_id }).catch(() => {});
162
- existingAgreement.status = 'failed';
163
- }
164
- }
165
-
166
- if (existingAgreement && existingAgreement.status !== 'failed') {
167
- return fail(409, 'already_sent', `An agreement already exists with status "${existingAgreement.status}".`, {
168
- agreement_id: existingAgreement.id,
169
- agreement_status: existingAgreement.status,
170
- });
171
- }
172
-
173
- // === Call send-booking-agreement server-to-server. It requires the literal
174
- // service-role key as its bearer token, not the caller's JWT. ===
175
- let sendRes: Response;
176
- try {
177
- sendRes = await fetch(`${SUPABASE_URL}/functions/v1/send-booking-agreement`, {
178
- method: 'POST',
179
- headers: {
180
- Authorization: `Bearer ${SERVICE_ROLE_KEY}`,
181
- 'Content-Type': 'application/json',
182
- },
183
- body: JSON.stringify({
184
- booking_id,
185
- client_legal_name,
186
- security_deposit_cents,
187
- sent_by_email: callerEmail,
188
- sent_by_user_id: caller.sub,
189
- }),
190
- });
191
- } catch (e) {
192
- return fail(502, 'send_booking_agreement_unreachable', e instanceof Error ? e.message : String(e));
193
- }
194
-
195
- let sendBody: Record<string, unknown>;
196
- try {
197
- sendBody = await sendRes.json();
198
- } catch {
199
- return fail(502, 'send_booking_agreement_bad_response', 'send-booking-agreement did not return valid JSON.');
200
- }
201
-
202
- if (sendBody && (sendBody as { ok?: boolean }).ok === true) {
203
- logOps(admin, 'commons_agreement_send_requested', {
204
- booking_id,
205
- actor: callerEmail,
206
- client_legal_name,
207
- security_deposit_cents,
208
- agreement_id: (sendBody as { agreement_id?: string }).agreement_id ?? null,
209
- }, { severity: 'info', bookingId: booking_id }).catch(() => {});
210
- }
211
-
212
- // Relay send-booking-agreement's response (and status code) as-is.
213
- return json(sendRes.status, sendBody);
214
- }
1
+ // supabase/functions/admin-send-commons-agreement/index.ts
2
+ //
3
+ // The missing piece of the Commons (Tier 3) contract flow: admin-create-commons-event
4
+ // creates the pending booking but deliberately never sends a contract. send-booking-agreement
5
+ // fully supports tier-3 rendering but is internal-only (service-role auth, "never called by a
6
+ // browser"). This function is the staff-facing bridge: verify the caller is an authenticated
7
+ // admin, validate the booking is a sendable tier-3 pending hold, then call send-booking-agreement
8
+ // server-to-server with the service-role key.
9
+ //
10
+ // Auth scaffold is the same shape as admin-create-commons-event: JWKS-verified caller JWT,
11
+ // aal2 required, admin_users allowlist re-checked server-side, rate limited on distinct buckets.
12
+ import { createClient } from 'npm:@supabase/supabase-js@2';
13
+ import { z } from 'npm:zod@3.23.8';
14
+ import { jwtVerify, createRemoteJWKSet } from 'npm:jose@5.9.6';
15
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
16
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
17
+
18
+ const corsHeaders = {
19
+ 'Access-Control-Allow-Origin': '*',
20
+ 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
21
+ 'Access-Control-Allow-Methods': 'POST, OPTIONS',
22
+ };
23
+
24
+ interface CallerClaims { sub: string; email?: string; aal?: string }
25
+
26
+ const JWKS_URL_SUFFIX = '/auth/v1/.well-known/jwks.json';
27
+ let jwksCache: ReturnType<typeof createRemoteJWKSet> | null = null;
28
+ function getJwks(supabaseUrl: string) {
29
+ if (!jwksCache) jwksCache = createRemoteJWKSet(new URL(`${supabaseUrl}${JWKS_URL_SUFFIX}`));
30
+ return jwksCache;
31
+ }
32
+ async function verifyCaller(authHeader: string | null, supabaseUrl: string): Promise<CallerClaims | null> {
33
+ if (!authHeader?.toLowerCase().startsWith('bearer ')) return null;
34
+ const token = authHeader.slice(7).trim();
35
+ try {
36
+ const { payload } = await jwtVerify(token, getJwks(supabaseUrl));
37
+ const claims = payload as unknown as CallerClaims;
38
+ if (!claims.sub) return null;
39
+ return claims;
40
+ } catch { return null; }
41
+ }
42
+
43
+ function json(status: number, body: unknown) {
44
+ return new Response(JSON.stringify(body), {
45
+ status, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
46
+ });
47
+ }
48
+ function fail(status: number, code: string, error: string, extra?: Record<string, unknown>) {
49
+ return json(status, { ok: false, status, code, error, ...(extra ?? {}) });
50
+ }
51
+
52
+ const Body = z.object({
53
+ booking_id: z.string().uuid(),
54
+ client_legal_name: z.string().trim().min(1).max(300),
55
+ security_deposit_cents: z.number().int().min(0),
56
+ });
57
+
58
+ export async function handle(req: Request): Promise<Response> {
59
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
60
+ if (req.method !== 'POST') return fail(405, 'method_not_allowed', 'Method not allowed.');
61
+
62
+ const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
63
+ const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
64
+
65
+ // === Admin auth: same shape as admin-create-commons-event ===
66
+ const authHeader = req.headers.get('Authorization') || req.headers.get('authorization');
67
+ const caller = await verifyCaller(authHeader, SUPABASE_URL);
68
+ if (!caller) return fail(401, 'unauthenticated', 'Not signed in.');
69
+ if (caller.aal !== 'aal2') return fail(403, 'mfa_required', 'Two-factor authentication is required.');
70
+ const callerEmail = (caller.email ?? '').toLowerCase();
71
+ if (!callerEmail) return fail(403, 'no_email', 'Caller has no email claim.');
72
+
73
+ const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
74
+ auth: { persistSession: false, autoRefreshToken: false },
75
+ });
76
+
77
+ const [ipOk, emailOk] = await Promise.all([
78
+ checkRateLimit(admin, 'admin-send-commons-agreement-ip', clientIp(req), 20, 300),
79
+ checkRateLimit(admin, 'admin-send-commons-agreement-email', callerEmail, 20, 300),
80
+ ]);
81
+ if (!ipOk || !emailOk) return fail(429, 'rate_limited', 'Too many attempts — try again shortly.');
82
+
83
+ const { data: allow, error: allowErr } = await admin
84
+ .from('admin_users').select('email').eq('email', callerEmail).maybeSingle();
85
+ if (allowErr) return fail(500, 'allowlist_lookup_failed', allowErr.message);
86
+ if (!allow) return fail(403, 'not_authorized', 'Not authorized.');
87
+
88
+ // === Body ===
89
+ let raw: unknown;
90
+ try { raw = await req.json(); } catch { return fail(400, 'invalid_json', 'Body was not valid JSON.'); }
91
+ const parsed = Body.safeParse(raw);
92
+ if (!parsed.success) {
93
+ return fail(400, 'invalid_body', JSON.stringify(parsed.error.flatten().fieldErrors));
94
+ }
95
+ const { booking_id, client_legal_name, security_deposit_cents } = parsed.data;
96
+
97
+ // === Booking + tier ===
98
+ const { data: booking, error: bErr } = await admin
99
+ .from('bookings')
100
+ .select('id,room_id,status,hold_expires_at,list_amount_cents,deposit_amount_cents,contact_name,contact_email,contract_skipped_at')
101
+ .eq('id', booking_id)
102
+ .maybeSingle();
103
+ if (bErr) return fail(500, 'booking_lookup_failed', bErr.message);
104
+ if (!booking) return fail(404, 'booking_not_found', 'Booking not found.');
105
+
106
+ const depositAmountCents = Number(booking.deposit_amount_cents);
107
+ if (!Number.isInteger(depositAmountCents) || depositAmountCents <= 0) {
108
+ return fail(409, 'invalid_deposit_amount', 'This booking has no valid deposit amount set; fix the booking before sending a contract.');
109
+ }
110
+
111
+ const { data: tier, error: tErr } = await admin
112
+ .rpc('resolve_room_contract_tier', { p_room_id: booking.room_id });
113
+ if (tErr) return fail(500, 'tier_lookup_failed', tErr.message);
114
+ if (Number(tier) !== 3) {
115
+ return fail(409, 'not_tier3', 'This booking is not a tier-3 (contract + deposit) room.');
116
+ }
117
+
118
+ if (booking.status !== 'pending') {
119
+ return fail(409, 'booking_not_pending', `Booking status is "${booking.status}"; only a pending hold can be sent a contract.`);
120
+ }
121
+
122
+ if (booking.contract_skipped_at) {
123
+ return fail(409, 'contract_skipped', 'This booking\'s contract was deliberately skipped by staff; sending one now would contradict that decision. Clear contract_skipped_at first if this was a mistake.');
124
+ }
125
+
126
+ const holdExpiresMs = booking.hold_expires_at ? Date.parse(String(booking.hold_expires_at)) : NaN;
127
+ if (!Number.isFinite(holdExpiresMs) || holdExpiresMs <= Date.now()) {
128
+ return fail(409, 'hold_expired', 'This booking\'s hold has already expired.');
129
+ }
130
+
131
+ // NOTE: no ceiling here tied to list_amount_cents. A refundable, uncharged
132
+ // security deposit has no arithmetic relationship to the event's rental
133
+ // fee (a $500 deposit on a $300 event is completely normal venue practice)
134
+ // -- send-booking-agreement's own 0..10_000_000 sanity bound (an absolute
135
+ // cap, not a ratio) is the only ceiling that belongs here.
136
+
137
+ // === Already sent? Avoid a wasted render+BoldSign attempt that would only
138
+ // be rejected downstream anyway (send-booking-agreement's own claim
139
+ // guard only accepts 'draft'/'failed'). ===
140
+ const { data: existingAgreement, error: eaErr } = await admin
141
+ .from('booking_agreements')
142
+ .select('id,status,created_at')
143
+ .eq('booking_id', booking_id)
144
+ .maybeSingle();
145
+ if (eaErr) return fail(500, 'agreement_lookup_failed', eaErr.message);
146
+
147
+ // Recovery path: a crashed/interrupted send can leave a row stuck at
148
+ // 'sending' forever, which would otherwise block every future attempt with
149
+ // no way out. If it's been stuck more than 10 minutes, recover it to
150
+ // 'failed' so the normal retry path below can claim it.
151
+ const STUCK_SENDING_MS = 10 * 60 * 1000;
152
+ if (existingAgreement && existingAgreement.status === 'sending') {
153
+ const ageMs = Date.now() - Date.parse(String(existingAgreement.created_at));
154
+ if (Number.isFinite(ageMs) && ageMs > STUCK_SENDING_MS) {
155
+ await admin.from('booking_agreements').update({
156
+ status: 'failed',
157
+ last_error: 'recovered_from_stuck_sending',
158
+ }).eq('id', existingAgreement.id).eq('status', 'sending');
159
+ await logOps(admin, 'commons_agreement_stuck_sending_recovered', {
160
+ agreement_id: existingAgreement.id, booking_id, age_ms: ageMs,
161
+ }, { severity: 'warning', bookingId: booking_id }).catch(() => {});
162
+ existingAgreement.status = 'failed';
163
+ }
164
+ }
165
+
166
+ if (existingAgreement && existingAgreement.status !== 'failed') {
167
+ return fail(409, 'already_sent', `An agreement already exists with status "${existingAgreement.status}".`, {
168
+ agreement_id: existingAgreement.id,
169
+ agreement_status: existingAgreement.status,
170
+ });
171
+ }
172
+
173
+ // === Call send-booking-agreement server-to-server. It requires the literal
174
+ // service-role key as its bearer token, not the caller's JWT. ===
175
+ let sendRes: Response;
176
+ try {
177
+ sendRes = await fetch(`${SUPABASE_URL}/functions/v1/send-booking-agreement`, {
178
+ method: 'POST',
179
+ headers: {
180
+ Authorization: `Bearer ${SERVICE_ROLE_KEY}`,
181
+ 'Content-Type': 'application/json',
182
+ },
183
+ body: JSON.stringify({
184
+ booking_id,
185
+ client_legal_name,
186
+ security_deposit_cents,
187
+ sent_by_email: callerEmail,
188
+ sent_by_user_id: caller.sub,
189
+ }),
190
+ });
191
+ } catch (e) {
192
+ return fail(502, 'send_booking_agreement_unreachable', e instanceof Error ? e.message : String(e));
193
+ }
194
+
195
+ let sendBody: Record<string, unknown>;
196
+ try {
197
+ sendBody = await sendRes.json();
198
+ } catch {
199
+ return fail(502, 'send_booking_agreement_bad_response', 'send-booking-agreement did not return valid JSON.');
200
+ }
201
+
202
+ if (sendBody && (sendBody as { ok?: boolean }).ok === true) {
203
+ logOps(admin, 'commons_agreement_send_requested', {
204
+ booking_id,
205
+ actor: callerEmail,
206
+ client_legal_name,
207
+ security_deposit_cents,
208
+ agreement_id: (sendBody as { agreement_id?: string }).agreement_id ?? null,
209
+ }, { severity: 'info', bookingId: booking_id }).catch(() => {});
210
+ }
211
+
212
+ // Relay send-booking-agreement's response (and status code) as-is.
213
+ return json(sendRes.status, sendBody);
214
+ }