@simplelayer/graniteer-core 0.2.0 → 0.2.2

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