@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
@@ -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
+ }