@simplelayer/graniteer-core 0.1.2 → 0.2.0

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