@simplelayer/graniteer-core 0.0.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 (175) hide show
  1. package/package.json +169 -15
  2. package/src/adminBookingCredit.test.ts +451 -0
  3. package/src/adminBookingCredit.ts +239 -0
  4. package/src/agreementCheckout.ts +250 -0
  5. package/src/agreementPortalEmail.ts +128 -0
  6. package/src/availability.test.ts +25 -0
  7. package/src/availability.ts +201 -0
  8. package/src/billingPortalLinkEmail.ts +117 -0
  9. package/src/bookingAgreementEmail.ts +149 -0
  10. package/src/bookingEffects.ts +388 -0
  11. package/src/bookingHoldReclaim.ts +94 -0
  12. package/src/busClient.ts +268 -0
  13. package/src/busSignature.ts +71 -0
  14. package/src/checkoutCoupon.test.ts +675 -0
  15. package/src/checkoutCoupon.ts +455 -0
  16. package/src/checkoutSessionParams.ts +56 -0
  17. package/src/commonsContract.ts +175 -0
  18. package/src/commonsDeposit.ts +298 -0
  19. package/src/commonsDepositWebhook.ts +237 -0
  20. package/src/conductorAdmin.ts +141 -0
  21. package/src/dayPassConfirmation.ts +230 -0
  22. package/src/dunningEmails.test.ts +263 -0
  23. package/src/dunningEmails.ts +203 -0
  24. package/src/email-templates/brand.ts +93 -0
  25. package/src/email-templates/email-change.tsx +92 -0
  26. package/src/email-templates/invite.tsx +79 -0
  27. package/src/email-templates/magic-link.tsx +59 -0
  28. package/src/email-templates/reauthentication.tsx +60 -0
  29. package/src/email-templates/recovery.tsx +59 -0
  30. package/src/email-templates/signup.tsx +67 -0
  31. package/src/functions/admin-cancel-membership.ts +311 -0
  32. package/src/functions/admin-change-membership-plan.ts +312 -0
  33. package/src/functions/admin-charge-guest-print.ts +229 -0
  34. package/src/functions/admin-correct-booking.ts +333 -0
  35. package/src/functions/admin-create-booking.ts +460 -0
  36. package/src/functions/admin-create-commons-event.ts +244 -0
  37. package/src/functions/admin-debug-boldsign-doc.ts +93 -0
  38. package/src/functions/admin-door-write.ts +272 -0
  39. package/src/functions/admin-issue-day-pass.ts +231 -0
  40. package/src/functions/admin-mark-booking-paid.ts +203 -0
  41. package/src/functions/admin-mint-billing-portal-link.ts +168 -0
  42. package/src/functions/admin-mint-portal-link.ts +62 -0
  43. package/src/functions/admin-photo-upload.ts +128 -0
  44. package/src/functions/admin-remove-team-member.ts +150 -0
  45. package/src/functions/admin-request-trial.ts +366 -0
  46. package/src/functions/admin-resend-commons-deposit-link.ts +323 -0
  47. package/src/functions/admin-reset-mfa.ts +138 -0
  48. package/src/functions/admin-retry-invoice-payment.test.ts +567 -0
  49. package/src/functions/admin-retry-invoice-payment.ts +333 -0
  50. package/src/functions/admin-reverse-coupon-redemption.ts +98 -0
  51. package/src/functions/admin-revoke-agreement.ts +467 -0
  52. package/src/functions/admin-send-commons-agreement.ts +214 -0
  53. package/src/functions/admin-set-credit-amount.ts +123 -0
  54. package/src/functions/admin-skip-commons-contract.ts +165 -0
  55. package/src/functions/admin-undo-membership-cancel.ts +144 -0
  56. package/src/functions/admin-wall-photo-write.ts +141 -0
  57. package/src/functions/auth-email-hook.ts +259 -0
  58. package/src/functions/boldsign-sender-identity.ts +114 -0
  59. package/src/functions/booking-availability.ts +419 -0
  60. package/src/functions/booking-member-preview.ts +136 -0
  61. package/src/functions/booking-status.ts +149 -0
  62. package/src/functions/conductor.ts +505 -0
  63. package/src/functions/create-agreement.ts +537 -0
  64. package/src/functions/create-booking.ts +648 -0
  65. package/src/functions/create-day-pass-checkout.ts +218 -0
  66. package/src/functions/create-portal-session.ts +142 -0
  67. package/src/functions/create-subscription-checkout.test.ts +222 -0
  68. package/src/functions/create-subscription-checkout.ts +440 -0
  69. package/src/functions/day-pass-status.ts +89 -0
  70. package/src/functions/dayStatus.ts +71 -0
  71. package/src/functions/diag-webpush-test.ts +45 -0
  72. package/src/functions/event-access-admin.ts +277 -0
  73. package/src/functions/event-access-store.ts +309 -0
  74. package/src/functions/ezeep-print-webhook.ts +213 -0
  75. package/src/functions/ezeep-usage-reconcile.ts +299 -0
  76. package/src/functions/fetch-avatar-original.ts +457 -0
  77. package/src/functions/get-provider-sign-link.ts +155 -0
  78. package/src/functions/get-signing-link.ts +211 -0
  79. package/src/functions/guest-print-setup-confirm.ts +128 -0
  80. package/src/functions/guest-print-submit.ts +149 -0
  81. package/src/functions/luma-webhook.ts +165 -0
  82. package/src/functions/manage-booking.ts +472 -0
  83. package/src/functions/mcp.ts +67 -0
  84. package/src/functions/member-door-action.test.ts +1248 -0
  85. package/src/functions/member-door-action.ts +863 -0
  86. package/src/functions/member-unifi-mapping.test.ts +516 -0
  87. package/src/functions/member-unifi-mapping.ts +206 -0
  88. package/src/functions/membership-door-sync.ts +956 -0
  89. package/src/functions/migration-collision-alert.copy.ts +232 -0
  90. package/src/functions/migration-collision-alert.test.ts +349 -0
  91. package/src/functions/migration-collision-alert.ts +232 -0
  92. package/src/functions/office-assignment-end.ts +146 -0
  93. package/src/functions/portal-booking-access.ts +95 -0
  94. package/src/functions/portal-list-invoices.ts +99 -0
  95. package/src/functions/portal-request-login.ts +192 -0
  96. package/src/functions/portal-resend-invite.ts +248 -0
  97. package/src/functions/portal-submit-event.ts +168 -0
  98. package/src/functions/print-billing-recover.ts +97 -0
  99. package/src/functions/print-billing-run.ts +183 -0
  100. package/src/functions/public-facts.ts +168 -0
  101. package/src/functions/push-send.ts +348 -0
  102. package/src/functions/push-test.ts +234 -0
  103. package/src/functions/request-portal-link.ts +211 -0
  104. package/src/functions/reschedule-booking.ts +649 -0
  105. package/src/functions/review-ratings.ts +113 -0
  106. package/src/functions/space-availability-range.acceptance.test.ts +161 -0
  107. package/src/functions/space-availability-range.ts +142 -0
  108. package/src/functions/stripe-db-reconcile.ts +319 -0
  109. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  110. package/src/functions/stripe-webhook.ts +2595 -0
  111. package/src/functions/sync-gcal-blackouts.ts +298 -0
  112. package/src/functions/timetable-event-register.ts +162 -0
  113. package/src/functions/timetable-event-status.ts +90 -0
  114. package/src/functions/timetable-spaces.ts +219 -0
  115. package/src/functions/touch-pass-reconciler.ts +689 -0
  116. package/src/functions/touch-pass-signup.ts +478 -0
  117. package/src/functions/upload-booking-display-image.ts +179 -0
  118. package/src/functions/virtual-onboarding-purge.ts +134 -0
  119. package/src/functions/virtual-onboarding-submit.ts +315 -0
  120. package/src/functions/voice-booking.ts +453 -0
  121. package/src/functions/voice-day-pass.ts +346 -0
  122. package/src/functions/voice-inquiry.test.ts +301 -0
  123. package/src/functions/voice-inquiry.ts +198 -0
  124. package/src/functions/voice-membership-signup.ts +355 -0
  125. package/src/functions/voice-tour-availability.ts +204 -0
  126. package/src/functions/voice-tour-booking.ts +429 -0
  127. package/src/gcalSync.ts +142 -0
  128. package/src/ghlEventInquiry.ts +143 -0
  129. package/src/ghlNote.ts +34 -0
  130. package/src/ghlTask.ts +48 -0
  131. package/src/ghlVoiceInquiry.ts +90 -0
  132. package/src/guestPrintCapture.test.ts +722 -0
  133. package/src/guestPrintCapture.ts +538 -0
  134. package/src/lumaGhl.ts +195 -0
  135. package/src/mailArrivalEmail.ts +121 -0
  136. package/src/manageToken.ts +363 -0
  137. package/src/membership.ts +109 -0
  138. package/src/membershipBusClient.ts +537 -0
  139. package/src/membershipWelcome.ts +683 -0
  140. package/src/migrationCheckout.ts +366 -0
  141. package/src/money.ts +36 -0
  142. package/src/ops.ts +97 -0
  143. package/src/pacificDate.ts +88 -0
  144. package/src/paymentLinkEmail.ts +123 -0
  145. package/src/policyAcknowledgment.test.ts +50 -0
  146. package/src/policyAcknowledgment.ts +96 -0
  147. package/src/portalSession.ts +46 -0
  148. package/src/pricing.test.ts +660 -0
  149. package/src/pricing.ts +1025 -0
  150. package/src/printBilling.test.ts +750 -0
  151. package/src/printBilling.ts +891 -0
  152. package/src/printBillingAdapters.ts +169 -0
  153. package/src/printCorrections.test.ts +348 -0
  154. package/src/printCorrections.ts +496 -0
  155. package/src/rateLimit.ts +82 -0
  156. package/src/referralCredits.test.ts +31 -0
  157. package/src/referralCredits.ts +34 -0
  158. package/src/referralGrant.ts +321 -0
  159. package/src/rescheduleCredit.test.ts +521 -0
  160. package/src/rescheduleCredit.ts +337 -0
  161. package/src/reservationWifiCode.test.ts +69 -0
  162. package/src/reservationWifiCode.ts +81 -0
  163. package/src/retellCallAnalyzed.test.ts +167 -0
  164. package/src/retellCallAnalyzed.ts +113 -0
  165. package/src/retellSignature.test.ts +137 -0
  166. package/src/retellSignature.ts +82 -0
  167. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  168. package/src/signedUnpaidReminderEmail.ts +132 -0
  169. package/src/slackAlert.ts +38 -0
  170. package/src/stripeCoworkingPortal.ts +91 -0
  171. package/src/supabaseTestFakes.ts +131 -0
  172. package/src/supportTicketEmail.ts +119 -0
  173. package/src/tier1Agreement.ts +125 -0
  174. package/src/unifiAccessPolicies.ts +228 -0
  175. package/src/unifiGroups.ts +129 -0
@@ -0,0 +1,467 @@
1
+ import { createClient, type SupabaseClient } from 'npm:@supabase/supabase-js@2';
2
+ import { jwtVerify, createRemoteJWKSet } from 'npm:jose@5.9.6';
3
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
4
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
5
+
6
+ const corsHeaders = {
7
+ 'Access-Control-Allow-Origin': '*',
8
+ 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
9
+ 'Access-Control-Allow-Methods': 'POST, OPTIONS',
10
+ };
11
+
12
+ interface CallerClaims {
13
+ sub: string;
14
+ email?: string;
15
+ aal?: string;
16
+ }
17
+
18
+ const JWKS_URL_SUFFIX = '/auth/v1/.well-known/jwks.json';
19
+ let jwksCache: ReturnType<typeof createRemoteJWKSet> | null = null;
20
+ function getJwks(supabaseUrl: string) {
21
+ if (!jwksCache) jwksCache = createRemoteJWKSet(new URL(`${supabaseUrl}${JWKS_URL_SUFFIX}`));
22
+ return jwksCache;
23
+ }
24
+
25
+ async function verifyCaller(authHeader: string | null, supabaseUrl: string): Promise<CallerClaims | null> {
26
+ if (!authHeader?.toLowerCase().startsWith('bearer ')) return null;
27
+ const token = authHeader.slice(7).trim();
28
+ try {
29
+ const { payload } = await jwtVerify(token, getJwks(supabaseUrl));
30
+ const claims = payload as unknown as CallerClaims;
31
+ if (!claims.sub) return null;
32
+ return claims;
33
+ } catch {
34
+ return null;
35
+ }
36
+ }
37
+
38
+ function json(status: number, body: unknown) {
39
+ return new Response(JSON.stringify(body), {
40
+ status,
41
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
42
+ });
43
+ }
44
+
45
+ /** Only pre-signature documents may be cancelled here. Signed/completed is out of scope. */
46
+ const CANCELLABLE_STATUSES = new Set(['sent', 'viewed']);
47
+
48
+ function isPlainObject(v: unknown): v is Record<string, unknown> {
49
+ return typeof v === 'object' && v !== null && !Array.isArray(v);
50
+ }
51
+
52
+ /**
53
+ * mode 'correct_completed' — fix a DATA ERROR on an already fully-signed
54
+ * document (misspelled signer, wrong office label) WITHOUT collecting a new
55
+ * signature.
56
+ *
57
+ * Deliberately never touches BoldSign: a completed envelope cannot be revoked
58
+ * upstream, and the signed PDF that BoldSign holds is the legal artefact — it
59
+ * stays exactly as signed. What this corrects is OUR record of it. The
60
+ * superseded row is marked 'revoked' and chained forward via
61
+ * replaced_by_document_id, so the wrong version is never silently erased; the
62
+ * replacement carries boldsign_document_id: null precisely because it has no
63
+ * envelope of its own.
64
+ *
65
+ * Anything that changes what was actually agreed (rate, term, room, plan) is
66
+ * out of scope here and needs a real new agreement — this only rewrites the
67
+ * record's descriptive fields.
68
+ */
69
+ async function correctCompleted(opts: {
70
+ admin: SupabaseClient<any, 'public', any>;
71
+ row: Record<string, unknown>;
72
+ status: string;
73
+ docId: string;
74
+ callerEmail: string;
75
+ callerSub: string;
76
+ corrections: { signer_name?: string; field_values?: Record<string, unknown> } | undefined;
77
+ }): Promise<Response> {
78
+ const { admin, row, status, docId, callerEmail, callerSub } = opts;
79
+
80
+ if (status !== 'completed') {
81
+ return json(400, {
82
+ ok: false,
83
+ error: 'not_correctable',
84
+ detail: `Document status is "${String(row.status)}"; only a fully-signed (completed) document can be corrected this way. Agreements still out for signature use "Edit & resend" instead.`,
85
+ });
86
+ }
87
+
88
+ const corrections = opts.corrections ?? {};
89
+ if (!isPlainObject(corrections)) return json(400, { ok: false, error: 'invalid_corrections' });
90
+ if (corrections.field_values !== undefined && !isPlainObject(corrections.field_values)) {
91
+ return json(400, { ok: false, error: 'invalid_corrections', detail: 'corrections.field_values must be an object.' });
92
+ }
93
+
94
+ let signerName = String(row.signer_name ?? '');
95
+ if (corrections.signer_name !== undefined) {
96
+ if (typeof corrections.signer_name !== 'string') {
97
+ return json(400, { ok: false, error: 'invalid_corrections', detail: 'corrections.signer_name must be a string.' });
98
+ }
99
+ signerName = corrections.signer_name.trim().slice(0, 200);
100
+ if (!signerName) {
101
+ return json(400, { ok: false, error: 'invalid_corrections', detail: 'signer_name cannot be blank.' });
102
+ }
103
+ }
104
+
105
+ const originalFieldValues = isPlainObject(row.field_values) ? row.field_values : {};
106
+ const nextFieldValues = { ...originalFieldValues, ...(corrections.field_values ?? {}) };
107
+
108
+ const now = new Date().toISOString();
109
+
110
+ const { data: replacement, error: insErr } = await admin
111
+ .from('signature_documents')
112
+ .insert({
113
+ document_type: row.document_type,
114
+ boldsign_template_id: row.boldsign_template_id,
115
+ status: 'completed',
116
+ completed_at: now,
117
+ boldsign_document_id: null,
118
+ signer_name: signerName,
119
+ signer_email: row.signer_email,
120
+ flow: row.flow,
121
+ start_date: row.start_date,
122
+ field_values: nextFieldValues,
123
+ created_by_email: callerEmail,
124
+ replaced_by_document_id: null,
125
+ revoked_at: null,
126
+ revoked_by_email: null,
127
+ stripe_checkout_url: row.stripe_checkout_url,
128
+ stripe_checkout_session_id: row.stripe_checkout_session_id,
129
+ stripe_customer_id: row.stripe_customer_id,
130
+ stripe_issued_at: row.stripe_issued_at,
131
+ stripe_subscription_id: row.stripe_subscription_id,
132
+ retainer_paid_at: row.retainer_paid_at,
133
+ retainer_payment_intent_id: row.retainer_payment_intent_id,
134
+ retainer_terms_accepted_at: row.retainer_terms_accepted_at,
135
+ retainer_setup_intent_id: row.retainer_setup_intent_id,
136
+ retainer_intent_kind: row.retainer_intent_kind,
137
+ retainer_attempt_count: row.retainer_attempt_count,
138
+ subscription_attempt_count: row.subscription_attempt_count,
139
+ subscription_error: row.subscription_error,
140
+ client_signed_at: row.client_signed_at,
141
+ payment_link_email_sent_at: row.payment_link_email_sent_at,
142
+ portal_issued_at: row.portal_issued_at,
143
+ portal_token_revoked_at: row.portal_token_revoked_at,
144
+ activation_started_at: row.activation_started_at,
145
+ } as never)
146
+ .select('id')
147
+ .single();
148
+ if (insErr) return json(500, { ok: false, error: 'correction_insert_failed', detail: insErr.message });
149
+ const newDocId = (replacement as { id: string }).id;
150
+
151
+ const rollback = async () => {
152
+ await admin
153
+ .from('signature_documents')
154
+ .update({ status: 'completed', revoked_at: null, revoked_by_email: null, replaced_by_document_id: null } as never)
155
+ .eq('id', docId)
156
+ .eq('replaced_by_document_id', newDocId);
157
+ await admin.from('signature_documents').delete().eq('id', newDocId);
158
+ };
159
+
160
+ // CAS on 'completed' so a concurrent status change can't be stomped.
161
+ const { data: superseded, error: updErr } = await admin
162
+ .from('signature_documents')
163
+ .update({
164
+ status: 'revoked',
165
+ revoked_at: now,
166
+ revoked_by_email: callerEmail,
167
+ replaced_by_document_id: newDocId,
168
+ } as never)
169
+ .eq('id', docId)
170
+ .eq('status', 'completed')
171
+ .select('id')
172
+ .maybeSingle();
173
+ if (updErr) {
174
+ await rollback();
175
+ return json(500, { ok: false, error: 'supersede_failed', detail: updErr.message });
176
+ }
177
+ if (!superseded) {
178
+ await rollback();
179
+ return json(409, {
180
+ ok: false,
181
+ error: 'status_changed',
182
+ detail: 'The document status changed while correcting it. Reload and try again.',
183
+ });
184
+ }
185
+
186
+ // Repoint any office assignment that referenced the superseded row, so the
187
+ // room's occupancy record follows the live document instead of a revoked one.
188
+ const { data: repointed, error: assignErr } = await admin
189
+ .from('office_assignments')
190
+ .update({ signature_document_id: newDocId } as never)
191
+ .eq('signature_document_id', docId)
192
+ .select('id');
193
+ if (assignErr) {
194
+ await rollback();
195
+ return json(500, { ok: false, error: 'assignment_repoint_failed', detail: assignErr.message });
196
+ }
197
+ const repointedIds = ((repointed ?? []) as Array<{ id: string }>).map((a) => a.id);
198
+
199
+ const changedFieldKeys = Object.keys(corrections.field_values ?? {}).filter(
200
+ (k) => JSON.stringify(originalFieldValues[k]) !== JSON.stringify(nextFieldValues[k]),
201
+ );
202
+
203
+ await logOps(admin, 'agreement_completed_corrected', {
204
+ signature_document_id: docId,
205
+ new_signature_document_id: newDocId,
206
+ actor: callerEmail,
207
+ actor_user_id: callerSub,
208
+ document_type: row.document_type,
209
+ prior_signer_name: row.signer_name ?? null,
210
+ new_signer_name: signerName,
211
+ changed_field_value_keys: changedFieldKeys,
212
+ repointed_office_assignment_ids: repointedIds,
213
+ }, { severity: 'warning' }).catch(() => {});
214
+
215
+ return json(200, { ok: true, mode: 'correct_completed', new_document_id: newDocId });
216
+ }
217
+
218
+ /**
219
+ * mode 'resend_completed' — the terms themselves (not just a descriptive
220
+ * label) are wrong on an already fully-signed document, and the customer
221
+ * needs to actually sign something new.
222
+ *
223
+ * Unlike 'correct_completed', this does NOT try to preserve the completed
224
+ * status: it clones the row into a fresh 'draft' (same shape as edit_resend's
225
+ * clone, for consistency with that existing flow) and hands back
226
+ * new_draft_id so the caller can route into the same "finish and send" editor
227
+ * edit_resend already uses. No BoldSign call happens here — a completed
228
+ * envelope isn't revocable via BoldSign's API, and none is needed: the old
229
+ * row is just marked revoked/superseded, exactly like edit_resend does for a
230
+ * pre-signature document, so "sending" only happens later, explicitly, from
231
+ * the editor.
232
+ */
233
+ async function resendCompleted(opts: {
234
+ admin: SupabaseClient<any, 'public', any>;
235
+ row: Record<string, unknown>;
236
+ status: string;
237
+ docId: string;
238
+ callerEmail: string;
239
+ callerSub: string;
240
+ }): Promise<Response> {
241
+ const { admin, row, status, docId, callerEmail, callerSub } = opts;
242
+
243
+ if (status !== 'completed') {
244
+ return json(400, {
245
+ ok: false,
246
+ error: 'not_resendable',
247
+ detail: `Document status is "${String(row.status)}"; only a fully-signed (completed) document can be superseded this way. Agreements still out for signature use "Edit & resend" instead.`,
248
+ });
249
+ }
250
+
251
+ const { data: clone, error: cloneErr } = await admin
252
+ .from('signature_documents')
253
+ .insert({
254
+ document_type: row.document_type,
255
+ status: 'draft',
256
+ signer_name: row.signer_name,
257
+ signer_email: row.signer_email,
258
+ start_date: row.start_date,
259
+ field_values: row.field_values ?? {},
260
+ created_by_email: callerEmail,
261
+ })
262
+ .select('id')
263
+ .single();
264
+ if (cloneErr) return json(500, { ok: false, error: 'clone_failed', detail: cloneErr.message });
265
+ const newDraftId = (clone as { id: string }).id;
266
+
267
+ // CAS on 'completed' so a concurrent change can't be stomped. Mirrors
268
+ // edit_resend's .in('status', ['sent','viewed']) guard, scoped to this mode.
269
+ const { data: superseded, error: updErr } = await admin
270
+ .from('signature_documents')
271
+ .update({
272
+ status: 'revoked',
273
+ revoked_at: new Date().toISOString(),
274
+ revoked_by_email: callerEmail,
275
+ replaced_by_document_id: newDraftId,
276
+ } as never)
277
+ .eq('id', docId)
278
+ .eq('status', 'completed')
279
+ .select('id')
280
+ .maybeSingle();
281
+ if (updErr) {
282
+ await admin.from('signature_documents').delete().eq('id', newDraftId);
283
+ return json(500, { ok: false, error: 'supersede_failed', detail: updErr.message });
284
+ }
285
+ if (!superseded) {
286
+ await admin.from('signature_documents').delete().eq('id', newDraftId);
287
+ return json(409, {
288
+ ok: false,
289
+ error: 'status_changed',
290
+ detail: 'The document status changed while superseding it. Reload and try again.',
291
+ });
292
+ }
293
+
294
+ await logOps(admin, 'agreement_completed_resend', {
295
+ signature_document_id: docId,
296
+ new_draft_id: newDraftId,
297
+ actor: callerEmail,
298
+ actor_user_id: callerSub,
299
+ document_type: row.document_type,
300
+ }, { severity: 'warning' }).catch(() => {});
301
+
302
+ return json(200, { ok: true, mode: 'resend_completed', new_draft_id: newDraftId });
303
+ }
304
+
305
+ export async function handle(
306
+ req: Request,
307
+ operator: { operatorShortName: string; supportEmail: string },
308
+ ): Promise<Response> {
309
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
310
+ if (req.method !== 'POST') return json(405, { ok: false, error: 'method_not_allowed' });
311
+
312
+ const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
313
+ const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
314
+
315
+ const authHeader = req.headers.get('Authorization') || req.headers.get('authorization');
316
+ const caller = await verifyCaller(authHeader, SUPABASE_URL);
317
+ if (!caller) return json(401, { ok: false, error: 'unauthenticated' });
318
+ if (caller.aal !== 'aal2') return json(403, { ok: false, error: 'mfa_required' });
319
+ const callerEmail = (caller.email ?? '').toLowerCase();
320
+ if (!callerEmail) return json(403, { ok: false, error: 'no_email' });
321
+
322
+ const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
323
+ auth: { persistSession: false, autoRefreshToken: false },
324
+ });
325
+
326
+ const [ipOk, emailOk] = await Promise.all([
327
+ checkRateLimit(admin, 'revoke-agreement-ip', clientIp(req), 20, 300),
328
+ checkRateLimit(admin, 'revoke-agreement-email', callerEmail, 15, 300),
329
+ ]);
330
+ if (!ipOk || !emailOk) return json(429, { ok: false, error: 'rate_limited' });
331
+
332
+ const { data: allow, error: allowErr } = await admin
333
+ .from('admin_users').select('email').eq('email', callerEmail).maybeSingle();
334
+ if (allowErr) return json(500, { ok: false, error: 'allowlist_lookup_failed' });
335
+ if (!allow) return json(403, { ok: false, error: 'not_authorized' });
336
+
337
+ let body: {
338
+ signature_document_id?: string;
339
+ mode?: string;
340
+ message?: string;
341
+ corrections?: { signer_name?: string; field_values?: Record<string, unknown> };
342
+ };
343
+ try {
344
+ body = await req.json();
345
+ } catch {
346
+ return json(400, { ok: false, error: 'invalid_json' });
347
+ }
348
+ const docId = (body.signature_document_id ?? '').trim();
349
+ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(docId)) {
350
+ return json(400, { ok: false, error: 'invalid_signature_document_id' });
351
+ }
352
+ const mode =
353
+ body.mode === 'edit_resend' || body.mode === 'correct_completed' || body.mode === 'resend_completed'
354
+ ? body.mode
355
+ : 'cancel';
356
+ const message = (body.message ?? '').trim().slice(0, 300) ||
357
+ (mode === 'edit_resend'
358
+ ? 'This agreement was withdrawn so the terms could be revised. A replacement will follow.'
359
+ : `This agreement was cancelled by ${operator.operatorShortName}.`);
360
+
361
+ try {
362
+ const { data: row, error: rowErr } = await admin
363
+ .from('signature_documents')
364
+ .select(
365
+ `id,status,boldsign_document_id,boldsign_template_id,document_type,signer_name,signer_email,field_values,flow,start_date,
366
+ stripe_checkout_url,stripe_checkout_session_id,stripe_customer_id,stripe_issued_at,stripe_subscription_id,
367
+ retainer_paid_at,retainer_payment_intent_id,retainer_terms_accepted_at,retainer_setup_intent_id,retainer_intent_kind,
368
+ retainer_attempt_count,subscription_attempt_count,subscription_error,client_signed_at,payment_link_email_sent_at,
369
+ portal_issued_at,portal_token_revoked_at,activation_started_at`,
370
+ )
371
+ .eq('id', docId)
372
+ .maybeSingle();
373
+ if (rowErr) return json(500, { ok: false, error: 'row_lookup_failed', detail: rowErr.message });
374
+ if (!row) return json(404, { ok: false, error: 'not_found' });
375
+
376
+ const status = String(row.status).toLowerCase();
377
+
378
+ if (mode === 'correct_completed') {
379
+ return await correctCompleted({ admin, row, status, docId, callerEmail, callerSub: caller.sub, corrections: body.corrections });
380
+ }
381
+
382
+ if (mode === 'resend_completed') {
383
+ return await resendCompleted({ admin, row, status, docId, callerEmail, callerSub: caller.sub });
384
+ }
385
+
386
+ if (!CANCELLABLE_STATUSES.has(status)) {
387
+ return json(409, {
388
+ ok: false,
389
+ error: 'not_cancellable',
390
+ detail: `Document status is "${row.status}"; only agreements that are out for signature (sent/viewed) can be cancelled here.`,
391
+ });
392
+ }
393
+ if (!row.boldsign_document_id) {
394
+ return json(409, { ok: false, error: 'not_sent', detail: 'No BoldSign document is attached to this agreement.' });
395
+ }
396
+
397
+ const apiKey = Deno.env.get('BOLDSIGN_API_KEY');
398
+ if (!apiKey) return json(500, { ok: false, error: 'boldsign_not_configured' });
399
+
400
+ // POST /v1/document/revoke?documentId=... with body { message } (BoldSign RevokeDocument schema).
401
+ const res = await fetch(
402
+ `https://api.boldsign.com/v1/document/revoke?documentId=${encodeURIComponent(row.boldsign_document_id)}`,
403
+ {
404
+ method: 'POST',
405
+ headers: { 'X-API-KEY': apiKey, 'Content-Type': 'application/json', accept: 'application/json' },
406
+ body: JSON.stringify({ message, onBehalfOf: operator.supportEmail }),
407
+ },
408
+ );
409
+ if (!res.ok) {
410
+ const text = await res.text();
411
+ // Already revoked upstream is not a failure — fall through and reconcile our row.
412
+ const alreadyGone = res.status === 400 && /revok|already/i.test(text);
413
+ if (!alreadyGone) {
414
+ return json(502, {
415
+ ok: false,
416
+ error: 'boldsign_failed',
417
+ detail: `BoldSign ${res.status}: ${text}`.slice(0, 500),
418
+ });
419
+ }
420
+ }
421
+
422
+ let newDraftId: string | null = null;
423
+ if (mode === 'edit_resend') {
424
+ const { data: clone, error: cloneErr } = await admin
425
+ .from('signature_documents')
426
+ .insert({
427
+ document_type: row.document_type,
428
+ status: 'draft',
429
+ signer_name: row.signer_name,
430
+ signer_email: row.signer_email,
431
+ start_date: row.start_date,
432
+ field_values: row.field_values ?? {},
433
+ created_by_email: callerEmail,
434
+ })
435
+ .select('id')
436
+ .single();
437
+ if (cloneErr) return json(500, { ok: false, error: 'clone_failed', detail: cloneErr.message });
438
+ newDraftId = clone.id as string;
439
+ }
440
+
441
+ // CAS on the pre-signature status so a concurrent webhook completion can't be stomped.
442
+ const { data: updated, error: updErr } = await admin
443
+ .from('signature_documents')
444
+ .update({
445
+ status: 'revoked',
446
+ revoked_at: new Date().toISOString(),
447
+ revoked_by_email: callerEmail,
448
+ replaced_by_document_id: newDraftId,
449
+ })
450
+ .eq('id', docId)
451
+ .in('status', ['sent', 'viewed'])
452
+ .select('id')
453
+ .maybeSingle();
454
+ if (updErr) return json(500, { ok: false, error: 'update_failed', detail: updErr.message });
455
+ if (!updated) {
456
+ return json(409, {
457
+ ok: false,
458
+ error: 'status_changed',
459
+ detail: 'The agreement status changed while cancelling. Reload and try again.',
460
+ });
461
+ }
462
+
463
+ return json(200, { ok: true, mode, new_draft_id: newDraftId });
464
+ } catch (e) {
465
+ return json(500, { ok: false, error: 'unhandled', detail: String(e).slice(0, 500) });
466
+ }
467
+ }
@@ -0,0 +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
+ }