@simplelayer/graniteer-core 0.0.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/package.json +169 -15
  2. package/src/adminBookingCredit.test.ts +451 -0
  3. package/src/adminBookingCredit.ts +239 -0
  4. package/src/agreementCheckout.ts +250 -0
  5. package/src/agreementPortalEmail.ts +128 -0
  6. package/src/availability.test.ts +25 -0
  7. package/src/availability.ts +201 -0
  8. package/src/billingPortalLinkEmail.ts +117 -0
  9. package/src/bookingAgreementEmail.ts +149 -0
  10. package/src/bookingEffects.ts +388 -0
  11. package/src/bookingHoldReclaim.ts +94 -0
  12. package/src/busClient.ts +268 -0
  13. package/src/busSignature.ts +71 -0
  14. package/src/checkoutCoupon.test.ts +675 -0
  15. package/src/checkoutCoupon.ts +455 -0
  16. package/src/checkoutSessionParams.ts +56 -0
  17. package/src/commonsContract.ts +175 -0
  18. package/src/commonsDeposit.ts +298 -0
  19. package/src/commonsDepositWebhook.ts +237 -0
  20. package/src/conductorAdmin.ts +141 -0
  21. package/src/dayPassConfirmation.ts +230 -0
  22. package/src/dunningEmails.test.ts +263 -0
  23. package/src/dunningEmails.ts +203 -0
  24. package/src/email-templates/brand.ts +93 -0
  25. package/src/email-templates/email-change.tsx +92 -0
  26. package/src/email-templates/invite.tsx +79 -0
  27. package/src/email-templates/magic-link.tsx +59 -0
  28. package/src/email-templates/reauthentication.tsx +60 -0
  29. package/src/email-templates/recovery.tsx +59 -0
  30. package/src/email-templates/signup.tsx +67 -0
  31. package/src/functions/admin-cancel-membership.ts +311 -0
  32. package/src/functions/admin-change-membership-plan.ts +312 -0
  33. package/src/functions/admin-charge-guest-print.ts +229 -0
  34. package/src/functions/admin-correct-booking.ts +333 -0
  35. package/src/functions/admin-create-booking.ts +460 -0
  36. package/src/functions/admin-create-commons-event.ts +244 -0
  37. package/src/functions/admin-debug-boldsign-doc.ts +93 -0
  38. package/src/functions/admin-door-write.ts +272 -0
  39. package/src/functions/admin-issue-day-pass.ts +231 -0
  40. package/src/functions/admin-mark-booking-paid.ts +203 -0
  41. package/src/functions/admin-mint-billing-portal-link.ts +168 -0
  42. package/src/functions/admin-mint-portal-link.ts +62 -0
  43. package/src/functions/admin-photo-upload.ts +128 -0
  44. package/src/functions/admin-remove-team-member.ts +150 -0
  45. package/src/functions/admin-request-trial.ts +366 -0
  46. package/src/functions/admin-resend-commons-deposit-link.ts +323 -0
  47. package/src/functions/admin-reset-mfa.ts +138 -0
  48. package/src/functions/admin-retry-invoice-payment.test.ts +567 -0
  49. package/src/functions/admin-retry-invoice-payment.ts +333 -0
  50. package/src/functions/admin-reverse-coupon-redemption.ts +98 -0
  51. package/src/functions/admin-revoke-agreement.ts +467 -0
  52. package/src/functions/admin-send-commons-agreement.ts +214 -0
  53. package/src/functions/admin-set-credit-amount.ts +123 -0
  54. package/src/functions/admin-skip-commons-contract.ts +165 -0
  55. package/src/functions/admin-undo-membership-cancel.ts +144 -0
  56. package/src/functions/admin-wall-photo-write.ts +141 -0
  57. package/src/functions/auth-email-hook.ts +259 -0
  58. package/src/functions/boldsign-sender-identity.ts +114 -0
  59. package/src/functions/booking-availability.ts +419 -0
  60. package/src/functions/booking-member-preview.ts +136 -0
  61. package/src/functions/booking-status.ts +149 -0
  62. package/src/functions/conductor.ts +505 -0
  63. package/src/functions/create-agreement.ts +537 -0
  64. package/src/functions/create-booking.ts +648 -0
  65. package/src/functions/create-day-pass-checkout.ts +218 -0
  66. package/src/functions/create-portal-session.ts +142 -0
  67. package/src/functions/create-subscription-checkout.test.ts +222 -0
  68. package/src/functions/create-subscription-checkout.ts +440 -0
  69. package/src/functions/day-pass-status.ts +89 -0
  70. package/src/functions/dayStatus.ts +71 -0
  71. package/src/functions/diag-webpush-test.ts +45 -0
  72. package/src/functions/event-access-admin.ts +277 -0
  73. package/src/functions/event-access-store.ts +309 -0
  74. package/src/functions/ezeep-print-webhook.ts +213 -0
  75. package/src/functions/ezeep-usage-reconcile.ts +299 -0
  76. package/src/functions/fetch-avatar-original.ts +457 -0
  77. package/src/functions/get-provider-sign-link.ts +155 -0
  78. package/src/functions/get-signing-link.ts +211 -0
  79. package/src/functions/guest-print-setup-confirm.ts +128 -0
  80. package/src/functions/guest-print-submit.ts +149 -0
  81. package/src/functions/luma-webhook.ts +165 -0
  82. package/src/functions/manage-booking.ts +472 -0
  83. package/src/functions/mcp.ts +67 -0
  84. package/src/functions/member-door-action.test.ts +1248 -0
  85. package/src/functions/member-door-action.ts +863 -0
  86. package/src/functions/member-unifi-mapping.test.ts +516 -0
  87. package/src/functions/member-unifi-mapping.ts +206 -0
  88. package/src/functions/membership-door-sync.ts +956 -0
  89. package/src/functions/migration-collision-alert.copy.ts +232 -0
  90. package/src/functions/migration-collision-alert.test.ts +349 -0
  91. package/src/functions/migration-collision-alert.ts +232 -0
  92. package/src/functions/office-assignment-end.ts +146 -0
  93. package/src/functions/portal-booking-access.ts +95 -0
  94. package/src/functions/portal-list-invoices.ts +99 -0
  95. package/src/functions/portal-request-login.ts +192 -0
  96. package/src/functions/portal-resend-invite.ts +248 -0
  97. package/src/functions/portal-submit-event.ts +168 -0
  98. package/src/functions/print-billing-recover.ts +97 -0
  99. package/src/functions/print-billing-run.ts +183 -0
  100. package/src/functions/public-facts.ts +168 -0
  101. package/src/functions/push-send.ts +348 -0
  102. package/src/functions/push-test.ts +234 -0
  103. package/src/functions/request-portal-link.ts +211 -0
  104. package/src/functions/reschedule-booking.ts +649 -0
  105. package/src/functions/review-ratings.ts +113 -0
  106. package/src/functions/space-availability-range.acceptance.test.ts +161 -0
  107. package/src/functions/space-availability-range.ts +142 -0
  108. package/src/functions/stripe-db-reconcile.ts +319 -0
  109. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  110. package/src/functions/stripe-webhook.ts +2595 -0
  111. package/src/functions/sync-gcal-blackouts.ts +298 -0
  112. package/src/functions/timetable-event-register.ts +162 -0
  113. package/src/functions/timetable-event-status.ts +90 -0
  114. package/src/functions/timetable-spaces.ts +219 -0
  115. package/src/functions/touch-pass-reconciler.ts +689 -0
  116. package/src/functions/touch-pass-signup.ts +478 -0
  117. package/src/functions/upload-booking-display-image.ts +179 -0
  118. package/src/functions/virtual-onboarding-purge.ts +134 -0
  119. package/src/functions/virtual-onboarding-submit.ts +315 -0
  120. package/src/functions/voice-booking.ts +453 -0
  121. package/src/functions/voice-day-pass.ts +346 -0
  122. package/src/functions/voice-inquiry.test.ts +301 -0
  123. package/src/functions/voice-inquiry.ts +198 -0
  124. package/src/functions/voice-membership-signup.ts +355 -0
  125. package/src/functions/voice-tour-availability.ts +204 -0
  126. package/src/functions/voice-tour-booking.ts +429 -0
  127. package/src/gcalSync.ts +142 -0
  128. package/src/ghlEventInquiry.ts +143 -0
  129. package/src/ghlNote.ts +34 -0
  130. package/src/ghlTask.ts +48 -0
  131. package/src/ghlVoiceInquiry.ts +90 -0
  132. package/src/guestPrintCapture.test.ts +722 -0
  133. package/src/guestPrintCapture.ts +538 -0
  134. package/src/lumaGhl.ts +195 -0
  135. package/src/mailArrivalEmail.ts +121 -0
  136. package/src/manageToken.ts +363 -0
  137. package/src/membership.ts +109 -0
  138. package/src/membershipBusClient.ts +537 -0
  139. package/src/membershipWelcome.ts +683 -0
  140. package/src/migrationCheckout.ts +366 -0
  141. package/src/money.ts +36 -0
  142. package/src/ops.ts +97 -0
  143. package/src/pacificDate.ts +88 -0
  144. package/src/paymentLinkEmail.ts +123 -0
  145. package/src/policyAcknowledgment.test.ts +50 -0
  146. package/src/policyAcknowledgment.ts +96 -0
  147. package/src/portalSession.ts +46 -0
  148. package/src/pricing.test.ts +660 -0
  149. package/src/pricing.ts +1025 -0
  150. package/src/printBilling.test.ts +750 -0
  151. package/src/printBilling.ts +891 -0
  152. package/src/printBillingAdapters.ts +169 -0
  153. package/src/printCorrections.test.ts +348 -0
  154. package/src/printCorrections.ts +496 -0
  155. package/src/rateLimit.ts +82 -0
  156. package/src/referralCredits.test.ts +31 -0
  157. package/src/referralCredits.ts +34 -0
  158. package/src/referralGrant.ts +321 -0
  159. package/src/rescheduleCredit.test.ts +521 -0
  160. package/src/rescheduleCredit.ts +337 -0
  161. package/src/reservationWifiCode.test.ts +69 -0
  162. package/src/reservationWifiCode.ts +81 -0
  163. package/src/retellCallAnalyzed.test.ts +167 -0
  164. package/src/retellCallAnalyzed.ts +113 -0
  165. package/src/retellSignature.test.ts +137 -0
  166. package/src/retellSignature.ts +82 -0
  167. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  168. package/src/signedUnpaidReminderEmail.ts +132 -0
  169. package/src/slackAlert.ts +38 -0
  170. package/src/stripeCoworkingPortal.ts +91 -0
  171. package/src/supabaseTestFakes.ts +131 -0
  172. package/src/supportTicketEmail.ts +119 -0
  173. package/src/tier1Agreement.ts +125 -0
  174. package/src/unifiAccessPolicies.ts +228 -0
  175. package/src/unifiGroups.ts +129 -0
@@ -0,0 +1,134 @@
1
+ // Virtual Office onboarding retention purge (cron-triggered).
2
+ //
3
+ // Called only by pg_cron via private.trigger_virtual_onboarding_purge(),
4
+ // authenticated with SYNC_JOB_SECRET (x-sync-secret) — the same pattern as
5
+ // sync-gcal-blackouts / ls-parity-check.
6
+ //
7
+ // Why an edge function instead of plpgsql: deleting a row from
8
+ // storage.objects only removes the catalog entry and can orphan the
9
+ // underlying blob. The Storage API delete below removes the real file.
10
+ import { createClient } from 'npm:@supabase/supabase-js@2';
11
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
12
+
13
+ const BUCKET = 'virtual-office-ids';
14
+ const RETENTION = "2 years";
15
+
16
+ function timingSafeEq(a: string, b: string): boolean {
17
+ if (a.length !== b.length) return false;
18
+ let diff = 0;
19
+ for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
20
+ return diff === 0;
21
+ }
22
+
23
+ function json(status: number, body: unknown) {
24
+ return new Response(JSON.stringify(body), {
25
+ status,
26
+ headers: { 'Content-Type': 'application/json' },
27
+ });
28
+ }
29
+
30
+ export async function handle(req: Request): Promise<Response> {
31
+ if (req.method !== 'POST') return json(405, { error: 'method_not_allowed' });
32
+
33
+ const expected = Deno.env.get('SYNC_JOB_SECRET');
34
+ const provided = req.headers.get('x-sync-secret') ?? '';
35
+ if (!expected || !timingSafeEq(expected, provided)) {
36
+ return json(401, { error: 'unauthorized' });
37
+ }
38
+
39
+ const admin = createClient(
40
+ Deno.env.get('SUPABASE_URL')!,
41
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
42
+ { auth: { persistSession: false, autoRefreshToken: false } },
43
+ );
44
+
45
+ try {
46
+ const cutoff = new Date(Date.now() - 2 * 365 * 24 * 60 * 60 * 1000).toISOString();
47
+
48
+ // Doomed = onboarding rows whose membership ended more than the retention
49
+ // window ago and that still hold un-anonymized PII.
50
+ const { data: rows, error: readErr } = await admin
51
+ .from('virtual_membership_onboarding')
52
+ .select('id,photo_id_path,email,memberships!inner(membership_ended_at)')
53
+ .not('memberships.membership_ended_at', 'is', null)
54
+ .lt('memberships.membership_ended_at', cutoff);
55
+ if (readErr) throw new Error(`read_failed: ${readErr.message}`);
56
+
57
+ const doomed = (rows ?? []).filter(
58
+ (r) => !/^anon-[0-9a-f]{12}@anonymized\.invalid$/.test(String(r.email ?? '')),
59
+ );
60
+
61
+ // 1) Real Storage API delete (removes the object, not just its row).
62
+ const paths = doomed
63
+ .map((r) => r.photo_id_path as string | null)
64
+ .filter((p): p is string => !!p);
65
+ let filesRemoved = 0;
66
+ if (paths.length > 0) {
67
+ const { data: removed, error: rmErr } = await admin.storage.from(BUCKET).remove(paths);
68
+ if (rmErr) {
69
+ await logOps(admin, 'virtual_onboarding_purge_file_failed', {
70
+ count: paths.length,
71
+ message: rmErr.message,
72
+ }, { severity: 'error' });
73
+ } else {
74
+ filesRemoved = removed?.length ?? 0;
75
+ }
76
+ }
77
+
78
+ // 2) Anonymize in place (never hard-delete the row).
79
+ let rowsAnonymized = 0;
80
+ for (const r of doomed) {
81
+ const anonEmail = `anon-${crypto.randomUUID().replace(/-/g, '').slice(0, 12)}@anonymized.invalid`;
82
+ const { error: upErr } = await admin
83
+ .from('virtual_membership_onboarding')
84
+ .update({
85
+ legal_first_name: '[anonymized]',
86
+ legal_middle_initial: null,
87
+ legal_last_name: '[anonymized]',
88
+ home_phone: null,
89
+ email: anonEmail,
90
+ home_address_line1: null,
91
+ home_address_line2: null,
92
+ home_city: null,
93
+ home_state: null,
94
+ home_zip: null,
95
+ photo_id_path: null,
96
+ // A sole proprietor's business address is often their home address,
97
+ // so it gets the same treatment. business_name /
98
+ // business_description are retained (not personal data).
99
+ business_address_line1: null,
100
+ business_address_line2: null,
101
+ business_city: null,
102
+ business_state: null,
103
+ business_zip: null,
104
+ business_phone: null,
105
+ officers: null,
106
+ })
107
+ .eq('id', r.id);
108
+ if (upErr) {
109
+ await logOps(admin, 'virtual_onboarding_purge_row_failed', {
110
+ id: r.id,
111
+ message: upErr.message,
112
+ }, { severity: 'error' });
113
+ } else {
114
+ rowsAnonymized++;
115
+ }
116
+ }
117
+
118
+ await logOps(admin, 'virtual_onboarding_purge', {
119
+ retention: RETENTION,
120
+ candidates: doomed.length,
121
+ files_removed: filesRemoved,
122
+ rows_anonymized: rowsAnonymized,
123
+ }, { severity: 'info' });
124
+
125
+ return json(200, { ok: true, files_removed: filesRemoved, rows_anonymized: rowsAnonymized });
126
+ } catch (e) {
127
+ try {
128
+ await logOps(admin, 'virtual_onboarding_purge_error', {
129
+ message: e instanceof Error ? e.message : String(e),
130
+ }, { severity: 'error' });
131
+ } catch { /* ignore */ }
132
+ return json(500, { error: 'server_error' });
133
+ }
134
+ }
@@ -0,0 +1,315 @@
1
+ // Virtual Office onboarding intake.
2
+ //
3
+ // This is the ONLY write path for `virtual_membership_onboarding` and for the
4
+ // private `virtual-office-ids` bucket. There is deliberately no INSERT/UPDATE
5
+ // RLS policy for the `authenticated` role on either: the portal JWT cannot
6
+ // satisfy `private.is_admin()` (aal2), so a member-scoped write policy would
7
+ // have meant widening the admin gate. Instead the member's identity is
8
+ // resolved server-side from their portal session and every write happens with
9
+ // the service-role client below.
10
+ //
11
+ // Nothing here touches GHL. Virtual Office onboarding data is PII (photo ID,
12
+ // home address) and stays inside Supabase by design.
13
+ import { createClient } from 'npm:@supabase/supabase-js@2';
14
+ import { z } from 'https://esm.sh/zod@3.23.8';
15
+ import { checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
16
+ import { resolvePortalSession } from 'npm:@simplelayer/graniteer-core/portalSession';
17
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
18
+
19
+ const corsHeaders = {
20
+ 'Access-Control-Allow-Origin': '*',
21
+ 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
22
+ 'Access-Control-Allow-Methods': 'POST, OPTIONS',
23
+ };
24
+
25
+ const VIRTUAL_OFFICE_SLUG = 'virtual-office';
26
+ const BUCKET = 'virtual-office-ids';
27
+ const MAX_ID_BYTES = 8 * 1024 * 1024;
28
+ const ALLOWED_MIME: Record<string, string> = {
29
+ 'image/jpeg': 'jpg',
30
+ 'image/png': 'png',
31
+ 'image/heic': 'heic',
32
+ 'image/webp': 'webp',
33
+ 'application/pdf': 'pdf',
34
+ };
35
+
36
+ function json(status: number, body: unknown) {
37
+ return new Response(JSON.stringify(body), {
38
+ status,
39
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
40
+ });
41
+ }
42
+
43
+ const s = (max: number) => z.string().trim().max(max).optional().or(z.literal(''));
44
+
45
+ const Officer = z.object({
46
+ name: z.string().trim().min(1).max(160),
47
+ title: z.string().trim().max(120).optional().or(z.literal('')),
48
+ phone: z.string().trim().max(40).optional().or(z.literal('')),
49
+ address: z.string().trim().max(300).optional().or(z.literal('')),
50
+ });
51
+
52
+ const Schema = z.object({
53
+ legal_first_name: z.string().trim().min(1).max(120),
54
+ legal_middle_initial: z.string().trim().max(4).optional().or(z.literal('')),
55
+ legal_last_name: z.string().trim().min(1).max(120),
56
+ home_phone: z.string().trim().min(1).max(40),
57
+ home_address_line1: z.string().trim().min(1).max(200),
58
+ home_address_line2: s(200),
59
+ home_city: z.string().trim().min(1).max(120),
60
+ home_state: z.string().trim().min(1).max(60),
61
+ home_zip: z.string().trim().min(1).max(20),
62
+ po_box_flag: z.boolean().optional(),
63
+ is_business: z.boolean().optional(),
64
+ business_name: s(200),
65
+ business_address_line1: s(200),
66
+ business_address_line2: s(200),
67
+ business_city: s(120),
68
+ business_state: s(60),
69
+ business_zip: s(20),
70
+ business_phone: s(40),
71
+ business_description: s(2000),
72
+ officers: z.array(Officer).max(10).optional(),
73
+ // Photo ID: base64 (no data: prefix) + declared mime. Required on first
74
+ // submit; optional on a re-submit that keeps the already-stored file.
75
+ photo_id_base64: z.string().max(12_000_000).optional(),
76
+ photo_id_mime: z.string().max(100).optional(),
77
+ });
78
+
79
+ function decodeBase64(b64: string): Uint8Array {
80
+ const clean = b64.includes(',') ? b64.slice(b64.indexOf(',') + 1) : b64;
81
+ const bin = atob(clean);
82
+ const out = new Uint8Array(bin.length);
83
+ for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
84
+ return out;
85
+ }
86
+
87
+ // Slack DM to the staff reviewer. Throws on any failure; the single call site
88
+ // catches and logs so submission success is never coupled to Slack.
89
+ const SLACK_REVIEWER_USER_ID = 'U02GL7X8MR8'; // Megan Kenney
90
+
91
+ async function slackApi(method: string, body: unknown, token: string) {
92
+ const res = await fetch(`https://slack.com/api/${method}`, {
93
+ method: 'POST',
94
+ headers: {
95
+ Authorization: `Bearer ${token}`,
96
+ 'Content-Type': 'application/json; charset=utf-8',
97
+ },
98
+ body: JSON.stringify(body),
99
+ signal: AbortSignal.timeout(10_000),
100
+ });
101
+ const text = await res.text();
102
+ if (!res.ok) throw new Error(`${method} HTTP ${res.status}: ${text.slice(0, 300)}`);
103
+ let data: { ok?: boolean; error?: string; channel?: { id?: string } };
104
+ try {
105
+ data = JSON.parse(text);
106
+ } catch {
107
+ throw new Error(`${method} non-JSON response: ${text.slice(0, 200)}`);
108
+ }
109
+ // Slack reports failures inside a 200 body.
110
+ if (!data.ok) throw new Error(`${method} failed: ${data.error ?? 'unknown_error'}`);
111
+ return data;
112
+ }
113
+
114
+ async function notifySlack(info: {
115
+ name: string;
116
+ email: string;
117
+ isBusiness: boolean;
118
+ businessName: string | null;
119
+ }): Promise<void> {
120
+ const token = Deno.env.get('SLACK_BOT_TOKEN');
121
+ if (!token) throw new Error('SLACK_BOT_TOKEN not configured');
122
+
123
+ const opened = await slackApi('conversations.open', { users: SLACK_REVIEWER_USER_ID }, token);
124
+ const channelId = opened.channel?.id;
125
+ if (!channelId) throw new Error('conversations.open returned no channel id');
126
+
127
+ const lines = [
128
+ '*New Virtual Office onboarding submission*',
129
+ `• Name: ${info.name}`,
130
+ `• Email: ${info.email}`,
131
+ `• Business submission: ${info.isBusiness ? 'Yes' : 'No'}`,
132
+ ];
133
+ if (info.isBusiness && info.businessName) lines.push(`• Business name: ${info.businessName}`);
134
+ lines.push('• Photo ID uploaded to the private `virtual-office-ids` bucket — needs review in the admin panel.');
135
+
136
+ await slackApi('chat.postMessage', { channel: channelId, text: lines.join('\n') }, token);
137
+ }
138
+
139
+ export async function handle(req: Request): Promise<Response> {
140
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
141
+ if (req.method !== 'POST') return json(405, { error: 'method_not_allowed' });
142
+
143
+ const admin = createClient(
144
+ Deno.env.get('SUPABASE_URL')!,
145
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
146
+ { auth: { persistSession: false, autoRefreshToken: false } },
147
+ );
148
+
149
+ try {
150
+ const session = await resolvePortalSession(req, admin);
151
+ if (!session) return json(401, { error: 'unauthorized' });
152
+ const email = session.email.toLowerCase();
153
+
154
+ const ok = await checkRateLimit(admin, 'virtual-onboarding-submit', email, 10, 3600);
155
+ if (!ok) return json(429, { error: 'rate_limited' });
156
+
157
+ let raw: unknown;
158
+ try {
159
+ raw = await req.json();
160
+ } catch {
161
+ return json(400, { error: 'invalid_json' });
162
+ }
163
+ const parsed = Schema.safeParse(raw);
164
+ if (!parsed.success) {
165
+ return json(400, { error: 'invalid_input', fields: parsed.error.flatten().fieldErrors });
166
+ }
167
+ const d = parsed.data;
168
+
169
+ // The virtual-office plan id is resolved from the DB, never from the client.
170
+ const { data: plan } = await admin
171
+ .from('membership_plans')
172
+ .select('id')
173
+ .eq('slug', VIRTUAL_OFFICE_SLUG)
174
+ .maybeSingle();
175
+ if (!plan?.id) return json(503, { error: 'plan_not_configured' });
176
+
177
+ // Membership is resolved from the verified session: linked auth user id
178
+ // first, then (transition) the email match on still-unlinked rows.
179
+ // PLURALITY: never .maybeSingle() here -- supabase-js returns data:null when
180
+ // >1 row matches, which would lock a member with two Virtual Office
181
+ // memberships out of onboarding entirely. Oldest-first + limit(1), matching
182
+ // _shared/membership.ts's "THE OLDEST ENTITLED MEMBERSHIP PAYS" intent.
183
+ const { data: byIdRows, error: byIdErr } = await admin
184
+ .from('memberships')
185
+ .select('id,plan_id,email')
186
+ .eq('auth_user_id', session.id)
187
+ .eq('plan_id', plan.id)
188
+ .order('created_at', { ascending: true })
189
+ .limit(1);
190
+ if (byIdErr) return json(500, { error: 'lookup_failed' });
191
+ let membership = (byIdRows ?? [])[0];
192
+ if (!membership) {
193
+ const { data: byEmailRows, error: byEmailErr } = await admin
194
+ .from('memberships')
195
+ .select('id,plan_id,email')
196
+ .eq('email', email)
197
+ .eq('plan_id', plan.id)
198
+ .is('auth_user_id', null)
199
+ .order('created_at', { ascending: true })
200
+ .limit(1);
201
+ if (byEmailErr) return json(500, { error: 'lookup_failed' });
202
+ membership = (byEmailRows ?? [])[0];
203
+ }
204
+ if (!membership?.id) return json(403, { error: 'not_a_virtual_office_member' });
205
+
206
+ const { data: existing } = await admin
207
+ .from('virtual_membership_onboarding')
208
+ .select('id,photo_id_path')
209
+ .eq('membership_id', membership.id)
210
+ .maybeSingle();
211
+
212
+ // --- photo ID ---
213
+ let photoPath: string | null = (existing?.photo_id_path as string | null) ?? null;
214
+ if (d.photo_id_base64) {
215
+ const mime = (d.photo_id_mime ?? '').toLowerCase();
216
+ const ext = ALLOWED_MIME[mime];
217
+ if (!ext) return json(400, { error: 'unsupported_file_type' });
218
+ let bytes: Uint8Array;
219
+ try {
220
+ bytes = decodeBase64(d.photo_id_base64);
221
+ } catch {
222
+ return json(400, { error: 'invalid_file_encoding' });
223
+ }
224
+ if (bytes.byteLength === 0) return json(400, { error: 'empty_file' });
225
+ if (bytes.byteLength > MAX_ID_BYTES) return json(400, { error: 'file_too_large' });
226
+
227
+ const path = `${membership.id}/id-${Date.now()}.${ext}`;
228
+ const { error: upErr } = await admin.storage
229
+ .from(BUCKET)
230
+ .upload(path, bytes, { contentType: mime, upsert: false });
231
+ if (upErr) {
232
+ await logOps(admin, 'virtual_onboarding_upload_failed', {
233
+ membership_id: membership.id,
234
+ message: upErr.message,
235
+ }, { severity: 'error' });
236
+ return json(502, { error: 'upload_failed' });
237
+ }
238
+ // Replace: remove the superseded file so we never accumulate stale IDs
239
+ // outside the retention job's reach.
240
+ if (photoPath && photoPath !== path) {
241
+ await admin.storage.from(BUCKET).remove([photoPath]).catch(() => undefined);
242
+ }
243
+ photoPath = path;
244
+ }
245
+ if (!photoPath) return json(400, { error: 'photo_id_required' });
246
+
247
+ const isBusiness = d.is_business === true;
248
+ const row = {
249
+ membership_id: membership.id,
250
+ status: 'submitted',
251
+ legal_first_name: d.legal_first_name,
252
+ legal_middle_initial: d.legal_middle_initial || null,
253
+ legal_last_name: d.legal_last_name,
254
+ home_phone: d.home_phone,
255
+ email,
256
+ home_address_line1: d.home_address_line1,
257
+ home_address_line2: d.home_address_line2 || null,
258
+ home_city: d.home_city,
259
+ home_state: d.home_state,
260
+ home_zip: d.home_zip,
261
+ po_box_flag: d.po_box_flag === true,
262
+ photo_id_path: photoPath,
263
+ is_business: isBusiness,
264
+ business_name: isBusiness ? d.business_name || null : null,
265
+ business_address_line1: isBusiness ? d.business_address_line1 || null : null,
266
+ business_address_line2: isBusiness ? d.business_address_line2 || null : null,
267
+ business_city: isBusiness ? d.business_city || null : null,
268
+ business_state: isBusiness ? d.business_state || null : null,
269
+ business_zip: isBusiness ? d.business_zip || null : null,
270
+ business_phone: isBusiness ? d.business_phone || null : null,
271
+ business_description: isBusiness ? d.business_description || null : null,
272
+ officers: isBusiness && d.officers?.length ? d.officers : null,
273
+ submitted_at: new Date().toISOString(),
274
+ };
275
+
276
+ const { error: wErr } = await admin
277
+ .from('virtual_membership_onboarding')
278
+ .upsert(row, { onConflict: 'membership_id' });
279
+ if (wErr) {
280
+ await logOps(admin, 'virtual_onboarding_write_failed', {
281
+ membership_id: membership.id,
282
+ message: wErr.message,
283
+ }, { severity: 'error' });
284
+ return json(500, { error: 'write_failed' });
285
+ }
286
+
287
+ // Staff notification. Best-effort only: a Slack outage must never fail the
288
+ // member's submission or undo the row above. No PII beyond the name, and
289
+ // deliberately no photo-ID path/link — the file stays in the private
290
+ // bucket and is reviewed from the admin side.
291
+ try {
292
+ await notifySlack({
293
+ name: [d.legal_first_name, d.legal_middle_initial, d.legal_last_name]
294
+ .filter(Boolean).join(' '),
295
+ email,
296
+ isBusiness,
297
+ businessName: isBusiness ? (d.business_name || null) : null,
298
+ });
299
+ } catch (e) {
300
+ await logOps(admin, 'virtual_onboarding_slack_failed', {
301
+ membership_id: membership.id,
302
+ message: e instanceof Error ? e.message : String(e),
303
+ }, { severity: 'warning' });
304
+ }
305
+
306
+ return json(200, { ok: true, status: 'submitted' });
307
+ } catch (e) {
308
+ try {
309
+ await logOps(admin, 'virtual_onboarding_error', {
310
+ message: e instanceof Error ? e.message : String(e),
311
+ }, { severity: 'error' });
312
+ } catch { /* ignore */ }
313
+ return json(500, { error: 'server_error' });
314
+ }
315
+ }