@simplelayer/graniteer-core 0.1.2 → 0.2.1

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 +334 -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 +217 -95
  83. package/src/functions/portal-list-invoices.ts +99 -99
  84. package/src/functions/portal-request-login.ts +192 -0
  85. package/src/functions/portal-resend-invite.ts +248 -0
  86. package/src/functions/portal-submit-event.ts +168 -0
  87. package/src/functions/print-billing-recover.ts +97 -97
  88. package/src/functions/print-billing-run.ts +183 -183
  89. package/src/functions/public-facts.ts +168 -168
  90. package/src/functions/push-send.ts +348 -0
  91. package/src/functions/push-test.ts +234 -0
  92. package/src/functions/request-portal-link.ts +211 -0
  93. package/src/functions/reschedule-booking.ts +649 -0
  94. package/src/functions/review-ratings.ts +113 -0
  95. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  96. package/src/functions/space-availability-range.ts +142 -142
  97. package/src/functions/stripe-db-reconcile.ts +319 -0
  98. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  99. package/src/functions/stripe-webhook.ts +2595 -0
  100. package/src/functions/sync-gcal-blackouts.ts +298 -298
  101. package/src/functions/timetable-event-register.ts +162 -162
  102. package/src/functions/timetable-event-status.ts +90 -90
  103. package/src/functions/timetable-spaces.ts +219 -219
  104. package/src/functions/touch-pass-reconciler.ts +689 -689
  105. package/src/functions/touch-pass-signup.ts +478 -0
  106. package/src/functions/upload-booking-display-image.ts +179 -0
  107. package/src/functions/virtual-onboarding-purge.ts +134 -134
  108. package/src/functions/virtual-onboarding-submit.ts +315 -315
  109. package/src/functions/voice-booking.ts +453 -0
  110. package/src/functions/voice-day-pass.ts +346 -0
  111. package/src/functions/voice-inquiry.test.ts +301 -301
  112. package/src/functions/voice-inquiry.ts +198 -198
  113. package/src/functions/voice-membership-signup.ts +355 -0
  114. package/src/functions/voice-tour-availability.ts +204 -204
  115. package/src/functions/voice-tour-booking.ts +429 -0
  116. package/src/ghlEventInquiry.ts +143 -0
  117. package/src/mailArrivalEmail.ts +121 -0
  118. package/src/manageToken.ts +363 -0
  119. package/src/membershipBusClient.ts +537 -0
  120. package/src/membershipWelcome.ts +683 -0
  121. package/src/migrationCheckout.ts +366 -0
  122. package/src/pacificDate.ts +54 -0
  123. package/src/paymentLinkEmail.ts +123 -0
  124. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  125. package/src/signedUnpaidReminderEmail.ts +132 -0
  126. package/src/stripeCoworkingPortal.ts +91 -0
  127. package/src/supabaseTestFakes.ts +131 -131
  128. package/src/supportTicketEmail.ts +119 -0
  129. package/src/unifiAccessPolicies.ts +228 -0
  130. package/src/unifiGroups.ts +129 -0
@@ -1,211 +1,211 @@
1
- // Staff-only tool: fetch a fresh BoldSign embedded signing link for whichever
2
- // recipient on a private-office-agreement document hasn't signed yet, so it
3
- // can be copied and sent by hand (e.g. over the phone). Never triggers any
4
- // BoldSign or app email -- this only reads BoldSign state and mints a link.
5
- import { createClient } from 'npm:@supabase/supabase-js@2';
6
- import { jwtVerify, createRemoteJWKSet } from 'npm:jose@5.9.6';
7
- import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
8
-
9
- const corsHeaders = {
10
- 'Access-Control-Allow-Origin': '*',
11
- 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
12
- 'Access-Control-Allow-Methods': 'POST, OPTIONS',
13
- };
14
-
15
- interface CallerClaims {
16
- sub: string;
17
- email?: string;
18
- aal?: string;
19
- }
20
-
21
- const JWKS_URL_SUFFIX = '/auth/v1/.well-known/jwks.json';
22
- let jwksCache: ReturnType<typeof createRemoteJWKSet> | null = null;
23
- function getJwks(supabaseUrl: string) {
24
- if (!jwksCache) jwksCache = createRemoteJWKSet(new URL(`${supabaseUrl}${JWKS_URL_SUFFIX}`));
25
- return jwksCache;
26
- }
27
-
28
- async function verifyCaller(authHeader: string | null, supabaseUrl: string): Promise<CallerClaims | null> {
29
- if (!authHeader?.toLowerCase().startsWith('bearer ')) return null;
30
- const token = authHeader.slice(7).trim();
31
- try {
32
- const { payload } = await jwtVerify(token, getJwks(supabaseUrl));
33
- const claims = payload as unknown as CallerClaims;
34
- if (!claims.sub) return null;
35
- return claims;
36
- } catch {
37
- return null;
38
- }
39
- }
40
-
41
- function json(status: number, body: unknown) {
42
- return new Response(JSON.stringify(body), {
43
- status,
44
- headers: { ...corsHeaders, 'Content-Type': 'application/json' },
45
- });
46
- }
47
-
48
- interface Recipient {
49
- name: string;
50
- email: string;
51
- status: string;
52
- }
53
-
54
- // BoldSign has shipped several field spellings across API versions for the
55
- // same concept -- accept any of them rather than depending on one. Mirrors
56
- // the same tolerant parsing used in _shared/agreementActivation.ts.
57
- function emailOf(s: Record<string, unknown>): string {
58
- return String(s.signerEmail ?? s.emailAddress ?? s.email ?? '').trim();
59
- }
60
- function nameOf(s: Record<string, unknown>): string {
61
- return String(s.signerName ?? s.name ?? '').trim();
62
- }
63
- function statusOf(s: Record<string, unknown>): string {
64
- return String(s.status ?? '').trim();
65
- }
66
-
67
- const COMPLETED_STATUSES = new Set(['completed', 'signed']);
68
-
69
- export async function handle(req: Request): Promise<Response> {
70
- if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
71
- if (req.method !== 'POST') return json(405, { ok: false, error: 'method_not_allowed' });
72
-
73
- const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
74
- const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
75
-
76
- const authHeader = req.headers.get('Authorization') || req.headers.get('authorization');
77
- const caller = await verifyCaller(authHeader, SUPABASE_URL);
78
- if (!caller) return json(401, { ok: false, error: 'unauthenticated' });
79
- if (caller.aal !== 'aal2') return json(403, { ok: false, error: 'mfa_required' });
80
- const callerEmail = (caller.email ?? '').toLowerCase();
81
- if (!callerEmail) return json(403, { ok: false, error: 'no_email' });
82
-
83
- const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
84
- auth: { persistSession: false, autoRefreshToken: false },
85
- });
86
-
87
- const [ipOk, emailOk] = await Promise.all([
88
- checkRateLimit(admin, 'get-signing-link-ip', clientIp(req), 30, 300),
89
- checkRateLimit(admin, 'get-signing-link-email', callerEmail, 20, 300),
90
- ]);
91
- if (!ipOk || !emailOk) return json(429, { ok: false, error: 'rate_limited' });
92
-
93
- const { data: allow, error: allowErr } = await admin
94
- .from('admin_users').select('email').eq('email', callerEmail).maybeSingle();
95
- if (allowErr) return json(500, { ok: false, error: 'allowlist_lookup_failed' });
96
- if (!allow) return json(403, { ok: false, error: 'not_authorized' });
97
-
98
- let body: { signature_document_id?: string; signer_email?: string };
99
- try {
100
- body = await req.json();
101
- } catch {
102
- return json(400, { ok: false, error: 'invalid_json' });
103
- }
104
- const docId = (body.signature_document_id ?? '').trim();
105
- if (!/^[0-9a-f-]{36}$/i.test(docId)) {
106
- return json(400, { ok: false, error: 'invalid_signature_document_id' });
107
- }
108
- const requestedSignerEmail = (body.signer_email ?? '').trim();
109
-
110
- try {
111
- const { data: row, error: rowErr } = await admin
112
- .from('signature_documents')
113
- .select('id,boldsign_document_id,signer_name,signer_email')
114
- .eq('id', docId)
115
- .maybeSingle();
116
- if (rowErr) return json(500, { ok: false, error: 'row_lookup_failed', detail: rowErr.message });
117
- if (!row) return json(404, { ok: false, error: 'not_found' });
118
- if (!row.boldsign_document_id) {
119
- return json(400, {
120
- ok: false,
121
- error: 'not_sent',
122
- detail: 'This agreement has not been sent to BoldSign yet, so there is nothing to sign.',
123
- });
124
- }
125
-
126
- const apiKey = Deno.env.get('BOLDSIGN_API_KEY');
127
- if (!apiKey) return json(500, { ok: false, error: 'boldsign_not_configured' });
128
-
129
- const propsRes = await fetch(
130
- `https://api.boldsign.com/v1/document/properties?documentId=${encodeURIComponent(row.boldsign_document_id)}`,
131
- { headers: { 'X-API-KEY': apiKey, accept: 'application/json' } },
132
- );
133
- const propsText = await propsRes.text();
134
- if (!propsRes.ok) {
135
- return json(500, {
136
- ok: false,
137
- error: 'boldsign_failed',
138
- detail: `BoldSign ${propsRes.status}: ${propsText}`.slice(0, 500),
139
- });
140
- }
141
-
142
- let props: unknown;
143
- try {
144
- props = JSON.parse(propsText);
145
- } catch {
146
- return json(500, { ok: false, error: 'boldsign_properties_bad_json' });
147
- }
148
-
149
- const signerDetails: Record<string, unknown>[] = Array.isArray((props as { signerDetails?: unknown })?.signerDetails)
150
- ? ((props as { signerDetails: unknown[] }).signerDetails as Record<string, unknown>[])
151
- : [];
152
- const recipients: Recipient[] = signerDetails.map((s) => ({
153
- name: nameOf(s),
154
- email: emailOf(s),
155
- status: statusOf(s),
156
- }));
157
-
158
- let targetEmail: string;
159
- if (requestedSignerEmail) {
160
- const match = recipients.find((r) => r.email.toLowerCase() === requestedSignerEmail.toLowerCase());
161
- if (!match) return json(400, { ok: false, error: 'unknown_signer', recipients });
162
- targetEmail = match.email;
163
- } else {
164
- const pending = recipients.find((r) => !COMPLETED_STATUSES.has(r.status.toLowerCase()));
165
- if (!pending) {
166
- return json(409, { ok: false, error: 'already_completed', recipients });
167
- }
168
- targetEmail = pending.email;
169
- }
170
-
171
- const linkRes = await fetch(
172
- 'https://api.boldsign.com/v1/document/getEmbeddedSignLink' +
173
- `?documentId=${encodeURIComponent(row.boldsign_document_id)}` +
174
- `&signerEmail=${encodeURIComponent(targetEmail)}`,
175
- { headers: { 'X-API-KEY': apiKey, accept: 'application/json' } },
176
- );
177
- const linkText = await linkRes.text();
178
- if (!linkRes.ok) {
179
- return json(500, {
180
- ok: false,
181
- error: 'boldsign_failed',
182
- detail: `BoldSign ${linkRes.status}: ${linkText}`.slice(0, 500),
183
- });
184
- }
185
-
186
- let signLink: string | null = null;
187
- try {
188
- signLink = (JSON.parse(linkText) as { signLink?: string }).signLink ?? null;
189
- } catch {
190
- signLink = null;
191
- }
192
- if (!signLink) {
193
- return json(500, {
194
- ok: false,
195
- error: 'no_sign_link',
196
- detail: `BoldSign returned no signLink: ${linkText}`.slice(0, 500),
197
- });
198
- }
199
-
200
- const matchedRecipient = recipients.find((r) => r.email.toLowerCase() === targetEmail.toLowerCase());
201
- return json(200, {
202
- ok: true,
203
- signerEmail: targetEmail,
204
- signerName: matchedRecipient?.name || row.signer_name || '',
205
- signLink,
206
- recipients,
207
- });
208
- } catch (e) {
209
- return json(500, { ok: false, error: 'unhandled', detail: String(e).slice(0, 500) });
210
- }
211
- }
1
+ // Staff-only tool: fetch a fresh BoldSign embedded signing link for whichever
2
+ // recipient on a private-office-agreement document hasn't signed yet, so it
3
+ // can be copied and sent by hand (e.g. over the phone). Never triggers any
4
+ // BoldSign or app email -- this only reads BoldSign state and mints a link.
5
+ import { createClient } from 'npm:@supabase/supabase-js@2';
6
+ import { jwtVerify, createRemoteJWKSet } from 'npm:jose@5.9.6';
7
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
8
+
9
+ const corsHeaders = {
10
+ 'Access-Control-Allow-Origin': '*',
11
+ 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
12
+ 'Access-Control-Allow-Methods': 'POST, OPTIONS',
13
+ };
14
+
15
+ interface CallerClaims {
16
+ sub: string;
17
+ email?: string;
18
+ aal?: string;
19
+ }
20
+
21
+ const JWKS_URL_SUFFIX = '/auth/v1/.well-known/jwks.json';
22
+ let jwksCache: ReturnType<typeof createRemoteJWKSet> | null = null;
23
+ function getJwks(supabaseUrl: string) {
24
+ if (!jwksCache) jwksCache = createRemoteJWKSet(new URL(`${supabaseUrl}${JWKS_URL_SUFFIX}`));
25
+ return jwksCache;
26
+ }
27
+
28
+ async function verifyCaller(authHeader: string | null, supabaseUrl: string): Promise<CallerClaims | null> {
29
+ if (!authHeader?.toLowerCase().startsWith('bearer ')) return null;
30
+ const token = authHeader.slice(7).trim();
31
+ try {
32
+ const { payload } = await jwtVerify(token, getJwks(supabaseUrl));
33
+ const claims = payload as unknown as CallerClaims;
34
+ if (!claims.sub) return null;
35
+ return claims;
36
+ } catch {
37
+ return null;
38
+ }
39
+ }
40
+
41
+ function json(status: number, body: unknown) {
42
+ return new Response(JSON.stringify(body), {
43
+ status,
44
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
45
+ });
46
+ }
47
+
48
+ interface Recipient {
49
+ name: string;
50
+ email: string;
51
+ status: string;
52
+ }
53
+
54
+ // BoldSign has shipped several field spellings across API versions for the
55
+ // same concept -- accept any of them rather than depending on one. Mirrors
56
+ // the same tolerant parsing used in _shared/agreementActivation.ts.
57
+ function emailOf(s: Record<string, unknown>): string {
58
+ return String(s.signerEmail ?? s.emailAddress ?? s.email ?? '').trim();
59
+ }
60
+ function nameOf(s: Record<string, unknown>): string {
61
+ return String(s.signerName ?? s.name ?? '').trim();
62
+ }
63
+ function statusOf(s: Record<string, unknown>): string {
64
+ return String(s.status ?? '').trim();
65
+ }
66
+
67
+ const COMPLETED_STATUSES = new Set(['completed', 'signed']);
68
+
69
+ export async function handle(req: Request): Promise<Response> {
70
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
71
+ if (req.method !== 'POST') return json(405, { ok: false, error: 'method_not_allowed' });
72
+
73
+ const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
74
+ const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
75
+
76
+ const authHeader = req.headers.get('Authorization') || req.headers.get('authorization');
77
+ const caller = await verifyCaller(authHeader, SUPABASE_URL);
78
+ if (!caller) return json(401, { ok: false, error: 'unauthenticated' });
79
+ if (caller.aal !== 'aal2') return json(403, { ok: false, error: 'mfa_required' });
80
+ const callerEmail = (caller.email ?? '').toLowerCase();
81
+ if (!callerEmail) return json(403, { ok: false, error: 'no_email' });
82
+
83
+ const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
84
+ auth: { persistSession: false, autoRefreshToken: false },
85
+ });
86
+
87
+ const [ipOk, emailOk] = await Promise.all([
88
+ checkRateLimit(admin, 'get-signing-link-ip', clientIp(req), 30, 300),
89
+ checkRateLimit(admin, 'get-signing-link-email', callerEmail, 20, 300),
90
+ ]);
91
+ if (!ipOk || !emailOk) return json(429, { ok: false, error: 'rate_limited' });
92
+
93
+ const { data: allow, error: allowErr } = await admin
94
+ .from('admin_users').select('email').eq('email', callerEmail).maybeSingle();
95
+ if (allowErr) return json(500, { ok: false, error: 'allowlist_lookup_failed' });
96
+ if (!allow) return json(403, { ok: false, error: 'not_authorized' });
97
+
98
+ let body: { signature_document_id?: string; signer_email?: string };
99
+ try {
100
+ body = await req.json();
101
+ } catch {
102
+ return json(400, { ok: false, error: 'invalid_json' });
103
+ }
104
+ const docId = (body.signature_document_id ?? '').trim();
105
+ if (!/^[0-9a-f-]{36}$/i.test(docId)) {
106
+ return json(400, { ok: false, error: 'invalid_signature_document_id' });
107
+ }
108
+ const requestedSignerEmail = (body.signer_email ?? '').trim();
109
+
110
+ try {
111
+ const { data: row, error: rowErr } = await admin
112
+ .from('signature_documents')
113
+ .select('id,boldsign_document_id,signer_name,signer_email')
114
+ .eq('id', docId)
115
+ .maybeSingle();
116
+ if (rowErr) return json(500, { ok: false, error: 'row_lookup_failed', detail: rowErr.message });
117
+ if (!row) return json(404, { ok: false, error: 'not_found' });
118
+ if (!row.boldsign_document_id) {
119
+ return json(400, {
120
+ ok: false,
121
+ error: 'not_sent',
122
+ detail: 'This agreement has not been sent to BoldSign yet, so there is nothing to sign.',
123
+ });
124
+ }
125
+
126
+ const apiKey = Deno.env.get('BOLDSIGN_API_KEY');
127
+ if (!apiKey) return json(500, { ok: false, error: 'boldsign_not_configured' });
128
+
129
+ const propsRes = await fetch(
130
+ `https://api.boldsign.com/v1/document/properties?documentId=${encodeURIComponent(row.boldsign_document_id)}`,
131
+ { headers: { 'X-API-KEY': apiKey, accept: 'application/json' } },
132
+ );
133
+ const propsText = await propsRes.text();
134
+ if (!propsRes.ok) {
135
+ return json(500, {
136
+ ok: false,
137
+ error: 'boldsign_failed',
138
+ detail: `BoldSign ${propsRes.status}: ${propsText}`.slice(0, 500),
139
+ });
140
+ }
141
+
142
+ let props: unknown;
143
+ try {
144
+ props = JSON.parse(propsText);
145
+ } catch {
146
+ return json(500, { ok: false, error: 'boldsign_properties_bad_json' });
147
+ }
148
+
149
+ const signerDetails: Record<string, unknown>[] = Array.isArray((props as { signerDetails?: unknown })?.signerDetails)
150
+ ? ((props as { signerDetails: unknown[] }).signerDetails as Record<string, unknown>[])
151
+ : [];
152
+ const recipients: Recipient[] = signerDetails.map((s) => ({
153
+ name: nameOf(s),
154
+ email: emailOf(s),
155
+ status: statusOf(s),
156
+ }));
157
+
158
+ let targetEmail: string;
159
+ if (requestedSignerEmail) {
160
+ const match = recipients.find((r) => r.email.toLowerCase() === requestedSignerEmail.toLowerCase());
161
+ if (!match) return json(400, { ok: false, error: 'unknown_signer', recipients });
162
+ targetEmail = match.email;
163
+ } else {
164
+ const pending = recipients.find((r) => !COMPLETED_STATUSES.has(r.status.toLowerCase()));
165
+ if (!pending) {
166
+ return json(409, { ok: false, error: 'already_completed', recipients });
167
+ }
168
+ targetEmail = pending.email;
169
+ }
170
+
171
+ const linkRes = await fetch(
172
+ 'https://api.boldsign.com/v1/document/getEmbeddedSignLink' +
173
+ `?documentId=${encodeURIComponent(row.boldsign_document_id)}` +
174
+ `&signerEmail=${encodeURIComponent(targetEmail)}`,
175
+ { headers: { 'X-API-KEY': apiKey, accept: 'application/json' } },
176
+ );
177
+ const linkText = await linkRes.text();
178
+ if (!linkRes.ok) {
179
+ return json(500, {
180
+ ok: false,
181
+ error: 'boldsign_failed',
182
+ detail: `BoldSign ${linkRes.status}: ${linkText}`.slice(0, 500),
183
+ });
184
+ }
185
+
186
+ let signLink: string | null = null;
187
+ try {
188
+ signLink = (JSON.parse(linkText) as { signLink?: string }).signLink ?? null;
189
+ } catch {
190
+ signLink = null;
191
+ }
192
+ if (!signLink) {
193
+ return json(500, {
194
+ ok: false,
195
+ error: 'no_sign_link',
196
+ detail: `BoldSign returned no signLink: ${linkText}`.slice(0, 500),
197
+ });
198
+ }
199
+
200
+ const matchedRecipient = recipients.find((r) => r.email.toLowerCase() === targetEmail.toLowerCase());
201
+ return json(200, {
202
+ ok: true,
203
+ signerEmail: targetEmail,
204
+ signerName: matchedRecipient?.name || row.signer_name || '',
205
+ signLink,
206
+ recipients,
207
+ });
208
+ } catch (e) {
209
+ return json(500, { ok: false, error: 'unhandled', detail: String(e).slice(0, 500) });
210
+ }
211
+ }