@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,132 @@
1
+ // D20: follow-up "you signed but haven't paid" email for a unified
2
+ // private-office agreement. Sent EXACTLY ONCE by agreement-reconcile, when a
3
+ // tenant has completed their BoldSign signature but the retainer checkout on
4
+ // the agreement portal was never completed (see signed_unpaid_reminder_sent_at
5
+ // on signature_documents for the write-once guard).
6
+ //
7
+ // Deliberately a separate function from sendAgreementPortalEmail (the initial
8
+ // "sign and pay" email sent by create-agreement at Send time) -- this is a
9
+ // DIFFERENT email, sent at a DIFFERENT time, for a DIFFERENT reason, and must
10
+ // never be merged into or fired from that path. Mirrors its GHL request
11
+ // shape, headers, timeouts, escaping and error classification, and those of
12
+ // sendPaymentLinkEmail in ./paymentLinkEmail.ts, for consistency.
13
+
14
+ import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
15
+ import { logOps } from './ops.ts';
16
+
17
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
18
+
19
+ export type SignedUnpaidReminderEmailResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
20
+
21
+ /** Escape untrusted values interpolated into outbound HTML. */
22
+ function esc(v: unknown): string {
23
+ return String(v ?? '')
24
+ .replace(/&/g, '&amp;')
25
+ .replace(/</g, '&lt;')
26
+ .replace(/>/g, '&gt;')
27
+ .replace(/"/g, '&quot;')
28
+ .replace(/'/g, '&#39;');
29
+ }
30
+
31
+ /** Classify a caught error as transient (worth another event) or hopeless. */
32
+ function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
33
+ const name = e instanceof Error ? e.name : '';
34
+ if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
35
+ const msg = e instanceof Error ? e.message : String(e);
36
+ const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
37
+ if (m) {
38
+ const code = Number(m[1]);
39
+ if (code === 429 || code >= 500) return 'failed_retryable';
40
+ }
41
+ return 'failed_permanent';
42
+ }
43
+
44
+ export async function sendSignedUnpaidReminderEmail(
45
+ supabase: SupabaseLike,
46
+ { email, name, portalUrl, officeNumber }: {
47
+ email: string;
48
+ name?: string | null;
49
+ portalUrl: string;
50
+ officeNumber?: string | null;
51
+ },
52
+ operator: { name: string; shortName: string; domain: string; supportEmail: string },
53
+ ): Promise<SignedUnpaidReminderEmailResult> {
54
+ try {
55
+ const apiKey = Deno.env.get('GHL_API_KEY');
56
+ const locationId = Deno.env.get('GHL_LOCATION_ID');
57
+ if (!apiKey || !locationId) {
58
+ await logOps(supabase, 'agreement_signed_unpaid_reminder_skipped',
59
+ { email, reason: 'ghl_not_configured' }, { severity: 'warning' }).catch(() => {});
60
+ return 'skipped';
61
+ }
62
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
63
+ const headers = {
64
+ Authorization: `Bearer ${apiKey}`,
65
+ Version: '2021-07-28',
66
+ 'Content-Type': 'application/json',
67
+ Accept: 'application/json',
68
+ };
69
+
70
+ const trimmed = (name || '').trim();
71
+ const parts = trimmed.split(/\s+/).filter(Boolean);
72
+ // Greeting is display-only. The CRM name is OMITTED when we have no name --
73
+ // never defaulted, or we would overwrite a real contact with "there".
74
+ const greetingName = parts[0] || 'there';
75
+ const crmName: { firstName?: string; lastName?: string } = {};
76
+ if (parts[0]) crmName.firstName = parts[0];
77
+ if (parts.length > 1) crmName.lastName = parts.slice(1).join(' ');
78
+
79
+ const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
80
+ method: 'POST', headers,
81
+ signal: AbortSignal.timeout(8000),
82
+ body: JSON.stringify({
83
+ locationId, ...crmName, email,
84
+ source: `${operator.shortName} Website — Office Agreement`,
85
+ tags: ['Office Agreement', 'Unified Portal', 'Signed Unpaid Reminder', operator.domain],
86
+ }),
87
+ });
88
+ if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
89
+ const upJson = await upRes.json();
90
+ const contactId = upJson.contact?.id || upJson.id || null;
91
+ if (!contactId) throw new Error('ghl_upsert_no_contact_id');
92
+
93
+ const p = (t: string) =>
94
+ `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
95
+
96
+ const office = (officeNumber || '').trim();
97
+ const officeClause = office ? ` for office ${esc(office)}` : '';
98
+ const subject = `Almost there — your ${operator.shortName} agreement is signed, just the retainer left`;
99
+
100
+ const html = `<div style="background:#F6F6F6;padding:24px 0;margin:0"><table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;background:#F6F6F6"><tr><td align="center" style="padding:0 12px"><table role="presentation" width="560" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;max-width:560px;width:100%;background:#FFFFFF;border-radius:10px"><tr><td style="padding:24px">
101
+ <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">Your signature is in — one step left</h2>
102
+ ${p(`Hi ${esc(greetingName)},`)}
103
+ ${p(`Thanks for signing your ${operator.name} private office agreement${officeClause}. We just need your service retainer to finish setting things up.`)}
104
+ ${p('<strong>Review your terms and pay your retainer</strong> in your secure agreement portal:')}
105
+ ${p(`<a href="${esc(portalUrl)}" style="color:#C98A5E">Review and pay your retainer →</a>`)}
106
+ ${p('Your monthly billing starts only after the retainer is paid, so nothing happens until you complete this step. This portal link is unique to your agreement, so please don\'t forward it.')}
107
+ ${p(`Questions in the meantime? Just reply to this email or reach us at <a href="mailto:${operator.supportEmail}" style="color:#C98A5E">${operator.supportEmail}</a>.`)}
108
+ ${p(`Thanks,<br />The ${operator.name} team`)}
109
+ </td></tr></table></td></tr></table></div>`;
110
+
111
+ const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
112
+ method: 'POST', headers,
113
+ signal: AbortSignal.timeout(8000),
114
+ body: JSON.stringify({
115
+ type: 'Email',
116
+ contactId,
117
+ subject,
118
+ html,
119
+ }),
120
+ });
121
+ if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
122
+
123
+ await logOps(supabase, 'agreement_signed_unpaid_reminder_sent', { email }, { severity: 'info' }).catch(() => {});
124
+ return 'sent';
125
+ } catch (e) {
126
+ const classification = classifyError(e);
127
+ await logOps(supabase, 'agreement_signed_unpaid_reminder_failed',
128
+ { email, message: e instanceof Error ? e.message : String(e) },
129
+ { severity: classification === 'failed_permanent' ? 'error' : 'warning' }).catch(() => {});
130
+ return classification;
131
+ }
132
+ }
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Small reusable Slack alert helper. Posts via chat.postMessage using the
3
+ * SLACK_BOT_TOKEN secret. Never throws and never blocks its caller on a
4
+ * Slack outage — a missed alert must never turn into a 500 for whatever
5
+ * triggered it.
6
+ *
7
+ * Distinct from `_shared/ops.ts`'s own built-in Slack fallback (which reads
8
+ * OPS_ALERT_SLACK_CHANNEL_ID and only fires for severity:'error' rows): this
9
+ * helper always posts to an explicit channel id, for call sites that need a
10
+ * guaranteed destination regardless of whether that env var is configured.
11
+ */
12
+
13
+ // #ops-alerts
14
+ export const OPS_ALERTS_CHANNEL_ID = 'C0BQDT4L197';
15
+
16
+ export async function sendSlackAlert(channelId: string, text: string): Promise<void> {
17
+ const token = Deno.env.get('SLACK_BOT_TOKEN');
18
+ if (!token) {
19
+ console.warn('[slackAlert] SLACK_BOT_TOKEN not set — skipping alert:', text);
20
+ return;
21
+ }
22
+ try {
23
+ const res = await fetch('https://slack.com/api/chat.postMessage', {
24
+ method: 'POST',
25
+ headers: {
26
+ 'Content-Type': 'application/json; charset=utf-8',
27
+ Authorization: `Bearer ${token}`,
28
+ },
29
+ body: JSON.stringify({ channel: channelId, text }),
30
+ });
31
+ const body = await res.json().catch(() => null) as { ok?: boolean; error?: string } | null;
32
+ if (!body?.ok) {
33
+ console.warn('[slackAlert] chat.postMessage failed:', body?.error ?? `http_${res.status}`);
34
+ }
35
+ } catch (e) {
36
+ console.warn('[slackAlert] chat.postMessage error:', e);
37
+ }
38
+ }
@@ -0,0 +1,91 @@
1
+ import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
2
+ import type Stripe from 'npm:stripe@17.5.0';
3
+
4
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
5
+
6
+ /**
7
+ * Return the Stripe billingPortal configuration id used for coworking
8
+ * memberships. This is a DEDICATED configuration, distinct from the account
9
+ * default (which belongs to a different product line -- do not touch it).
10
+ *
11
+ * The id is cached in public.app_settings (key='coworking_portal_config_id').
12
+ * If missing we create the configuration on first use, then race-safely store
13
+ * the id and re-read the winning value so concurrent calls converge.
14
+ *
15
+ * Extracted from create-portal-session/index.ts so admin-mint-billing-portal-link
16
+ * (and any future caller) reuses the exact same configuration instead of each
17
+ * function racing to create its own.
18
+ */
19
+ export async function getOrCreateCoworkingPortalConfig(
20
+ stripe: Stripe,
21
+ admin: SupabaseLike,
22
+ opts: { headline: string; defaultReturnUrl: string },
23
+ ): Promise<string> {
24
+ const { data: existing } = await admin
25
+ .from('app_settings')
26
+ .select('value')
27
+ .eq('key', 'coworking_portal_config_id')
28
+ .maybeSingle();
29
+ if (existing?.value) return existing.value as string;
30
+
31
+ const { data: plans, error: plansErr } = await admin
32
+ .from('membership_plans')
33
+ .select('stripe_product_id,stripe_price_id')
34
+ .eq('billable', true)
35
+ .eq('billing_interval', 'month')
36
+ .not('stripe_product_id', 'is', null)
37
+ .not('stripe_price_id', 'is', null);
38
+ if (plansErr) throw plansErr;
39
+
40
+ const products = (plans ?? [])
41
+ .filter((p) => p.stripe_product_id && p.stripe_price_id)
42
+ .map((p) => ({
43
+ product: p.stripe_product_id as string,
44
+ prices: [p.stripe_price_id as string],
45
+ }));
46
+ if (products.length === 0) {
47
+ throw new Error('no_billable_membership_plans');
48
+ }
49
+
50
+ const cfg = await stripe.billingPortal.configurations.create({
51
+ business_profile: {
52
+ headline: opts.headline,
53
+ },
54
+ default_return_url: opts.defaultReturnUrl,
55
+ login_page: { enabled: false },
56
+ features: {
57
+ customer_update: {
58
+ enabled: true,
59
+ allowed_updates: ['address', 'phone', 'name'],
60
+ },
61
+ invoice_history: { enabled: true },
62
+ payment_method_update: { enabled: true },
63
+ subscription_cancel: { enabled: false },
64
+ subscription_update: {
65
+ enabled: true,
66
+ default_allowed_updates: ['price'],
67
+ proration_behavior: 'always_invoice',
68
+ products,
69
+ schedule_at_period_end: {
70
+ conditions: [{ type: 'decreasing_item_amount' }],
71
+ },
72
+ },
73
+ },
74
+ metadata: { purpose: 'coworking_memberships' },
75
+ // `name` is a supported API field; cast to bypass SDK typing gap.
76
+ name: 'Coworking Memberships',
77
+ } as unknown as Stripe.BillingPortal.ConfigurationCreateParams);
78
+
79
+ await admin
80
+ .from('app_settings')
81
+ .insert({ key: 'coworking_portal_config_id', value: cfg.id })
82
+ .select()
83
+ .maybeSingle();
84
+ // Ignore conflict; re-read whichever value won.
85
+ const { data: winner } = await admin
86
+ .from('app_settings')
87
+ .select('value')
88
+ .eq('key', 'coworking_portal_config_id')
89
+ .maybeSingle();
90
+ return (winner?.value as string) || cfg.id;
91
+ }
@@ -0,0 +1,131 @@
1
+ // TEST-ONLY recording fake for a Supabase/PostgREST client.
2
+ //
3
+ // Generic — no tenant or feature-specific knowledge. Implements no transport
4
+ // of any kind: no fetch, no sockets. Extracted 2026-09-15 from what was
5
+ // migrationCheckoutFakes.ts, which bundled this generic Supabase double with
6
+ // migration-checkout-specific Stripe fakes; the Stripe half (and the whole
7
+ // migration-checkout feature) was dropped from this package per a Kyle
8
+ // decision (migrationCheckout* stays GC-only, not ported to core) — this
9
+ // file is the reusable part that survived the split.
10
+
11
+ export interface RecordedDbCall {
12
+ table: string;
13
+ op: 'select' | 'insert' | 'update' | 'delete' | 'none';
14
+ columns?: string;
15
+ payload?: unknown;
16
+ filters: Array<{ kind: string; args: unknown[] }>;
17
+ terminal: string;
18
+ }
19
+
20
+ export interface RecordedRpcCall {
21
+ fn: string;
22
+ args: unknown;
23
+ }
24
+
25
+ export interface DbResult {
26
+ data: unknown;
27
+ error: { message: string; code?: string } | null;
28
+ }
29
+
30
+ export type DbResponder = (call: RecordedDbCall) => DbResult;
31
+ export type RpcResponder = (call: RecordedRpcCall) => DbResult;
32
+
33
+ const OK: DbResult = { data: null, error: null };
34
+
35
+ class FakeQuery implements PromiseLike<DbResult> {
36
+ private settled: Promise<DbResult> | null = null;
37
+
38
+ constructor(
39
+ private rec: RecordedDbCall,
40
+ private responder: DbResponder,
41
+ private log: RecordedDbCall[],
42
+ ) {}
43
+
44
+ select(columns?: string): this { this.rec.op = 'select'; this.rec.columns = columns; return this; }
45
+ insert(payload: unknown): this { this.rec.op = 'insert'; this.rec.payload = payload; return this; }
46
+ update(payload: unknown): this { this.rec.op = 'update'; this.rec.payload = payload; return this; }
47
+ delete(): this { this.rec.op = 'delete'; return this; }
48
+
49
+ eq(...args: unknown[]): this { this.rec.filters.push({ kind: 'eq', args }); return this; }
50
+ neq(...args: unknown[]): this { this.rec.filters.push({ kind: 'neq', args }); return this; }
51
+ not(...args: unknown[]): this { this.rec.filters.push({ kind: 'not', args }); return this; }
52
+ in(...args: unknown[]): this { this.rec.filters.push({ kind: 'in', args }); return this; }
53
+ gt(...args: unknown[]): this { this.rec.filters.push({ kind: 'gt', args }); return this; }
54
+ gte(...args: unknown[]): this { this.rec.filters.push({ kind: 'gte', args }); return this; }
55
+ lt(...args: unknown[]): this { this.rec.filters.push({ kind: 'lt', args }); return this; }
56
+ order(...args: unknown[]): this { this.rec.filters.push({ kind: 'order', args }); return this; }
57
+ limit(...args: unknown[]): this { this.rec.filters.push({ kind: 'limit', args }); return this; }
58
+
59
+ maybeSingle(): Promise<DbResult> { this.rec.terminal = 'maybeSingle'; return this.resolve(); }
60
+ single(): Promise<DbResult> { this.rec.terminal = 'single'; return this.resolve(); }
61
+
62
+ then<R1 = DbResult, R2 = never>(
63
+ onOk?: ((v: DbResult) => R1 | PromiseLike<R1>) | null,
64
+ onErr?: ((e: unknown) => R2 | PromiseLike<R2>) | null,
65
+ ): PromiseLike<R1 | R2> {
66
+ return this.resolve().then(onOk, onErr);
67
+ }
68
+
69
+ private resolve(): Promise<DbResult> {
70
+ if (!this.settled) {
71
+ this.log.push(this.rec);
72
+ let out: DbResult;
73
+ try {
74
+ out = this.responder(this.rec) ?? OK;
75
+ } catch (e) {
76
+ return Promise.reject(e);
77
+ }
78
+ this.settled = Promise.resolve(out);
79
+ }
80
+ return this.settled;
81
+ }
82
+ }
83
+
84
+ export interface FakeSupabase {
85
+ from(table: string): FakeQuery;
86
+ rpc(fn: string, args?: unknown): Promise<DbResult>;
87
+ /** Every PostgREST call made, in order. */
88
+ readonly dbCalls: RecordedDbCall[];
89
+ /** Every .rpc() call made, in order. */
90
+ readonly rpcCalls: RecordedRpcCall[];
91
+ /** Convenience: db calls against one table. */
92
+ callsTo(table: string): RecordedDbCall[];
93
+ /** Convenience: writes (insert/update/delete) against one table. */
94
+ writesTo(table: string): RecordedDbCall[];
95
+ }
96
+
97
+ export function makeFakeSupabase(opts: {
98
+ db?: DbResponder;
99
+ rpc?: RpcResponder;
100
+ } = {}): FakeSupabase {
101
+ const dbCalls: RecordedDbCall[] = [];
102
+ const rpcCalls: RecordedRpcCall[] = [];
103
+ const db = opts.db ?? (() => OK);
104
+ const rpc = opts.rpc ?? (() => OK);
105
+
106
+ return {
107
+ dbCalls,
108
+ rpcCalls,
109
+ from(table: string) {
110
+ return new FakeQuery(
111
+ { table, op: 'none', filters: [], terminal: 'await' },
112
+ db,
113
+ dbCalls,
114
+ );
115
+ },
116
+ rpc(fn: string, args?: unknown) {
117
+ const call: RecordedRpcCall = { fn, args };
118
+ rpcCalls.push(call);
119
+ return Promise.resolve(rpc(call) ?? OK);
120
+ },
121
+ callsTo(table: string) { return dbCalls.filter((c) => c.table === table); },
122
+ writesTo(table: string) {
123
+ return dbCalls.filter((c) => c.table === table && c.op !== 'select' && c.op !== 'none');
124
+ },
125
+ };
126
+ }
127
+
128
+ /** Reads the value an `update` payload set for one column, or `undefined`. */
129
+ export function updatedValue(call: RecordedDbCall, column: string): unknown {
130
+ return (call.payload as Record<string, unknown> | undefined)?.[column];
131
+ }
@@ -0,0 +1,119 @@
1
+ // Best-effort email to the platform operator (Kyle) when an admin/owner/
2
+ // door-ops staff member files a support ticket via support-ticket-submit.
3
+ //
4
+ // Mirrors the transport, escaping, error classification and never-throws
5
+ // contract of sendBillingPortalLinkEmail in ./billingPortalLinkEmail.ts --
6
+ // same GHL upsert-then-send shape, different recipient (the platform
7
+ // operator's own inbox, operator.platformSupportEmail) and copy.
8
+ //
9
+ // NOTE: the platform support inbox may not have a mailbox provisioned yet,
10
+ // so this send is expected to bounce/fail for some tenants. That must never
11
+ // block or fail ticket creation -- see the ok:true/ok:false result shape
12
+ // below and its only caller, support-ticket-submit/index.ts.
13
+
14
+ import type { SupabaseClient } from 'npm:@supabase/supabase-js@2';
15
+ import { logOps } from './ops.ts';
16
+
17
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
18
+
19
+ export type SupportTicketEmailResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
20
+
21
+ function esc(v: unknown): string {
22
+ return String(v ?? '')
23
+ .replace(/&/g, '&amp;')
24
+ .replace(/</g, '&lt;')
25
+ .replace(/>/g, '&gt;')
26
+ .replace(/"/g, '&quot;')
27
+ .replace(/'/g, '&#39;');
28
+ }
29
+
30
+ function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
31
+ const name = e instanceof Error ? e.name : '';
32
+ if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
33
+ const msg = e instanceof Error ? e.message : String(e);
34
+ const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
35
+ if (m) {
36
+ const code = Number(m[1]);
37
+ if (code === 429 || code >= 500) return 'failed_retryable';
38
+ }
39
+ return 'failed_permanent';
40
+ }
41
+
42
+ export async function sendSupportTicketEmail(
43
+ supabase: SupabaseLike,
44
+ { ticketId, submitterName, submitterEmail, subject, message }: {
45
+ ticketId: string;
46
+ submitterName: string;
47
+ submitterEmail: string;
48
+ subject: string;
49
+ message: string;
50
+ },
51
+ operator: { name: string; shortName: string; domain: string; platformSupportEmail: string },
52
+ ): Promise<SupportTicketEmailResult> {
53
+ try {
54
+ const apiKey = Deno.env.get('GHL_API_KEY');
55
+ const locationId = Deno.env.get('GHL_LOCATION_ID');
56
+ if (!apiKey || !locationId) {
57
+ await logOps(supabase, 'support_ticket_email_skipped',
58
+ { ticket_id: ticketId, reason: 'ghl_not_configured' }, { severity: 'warning' }).catch(() => {});
59
+ return 'skipped';
60
+ }
61
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
62
+ const headers = {
63
+ Authorization: `Bearer ${apiKey}`,
64
+ Version: '2021-07-28',
65
+ 'Content-Type': 'application/json',
66
+ Accept: 'application/json',
67
+ };
68
+
69
+ const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
70
+ method: 'POST', headers,
71
+ signal: AbortSignal.timeout(8000),
72
+ body: JSON.stringify({
73
+ locationId,
74
+ email: operator.platformSupportEmail,
75
+ source: `${operator.shortName} Admin — Support Ticket`,
76
+ tags: ['Support Ticket', operator.domain],
77
+ }),
78
+ });
79
+ if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
80
+ const upJson = await upRes.json();
81
+ const contactId = upJson.contact?.id || upJson.id || null;
82
+ if (!contactId) throw new Error('ghl_upsert_no_contact_id');
83
+
84
+ const p = (t: string) =>
85
+ `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
86
+
87
+ const html = `<div style="background:#F6F6F6;padding:24px 0;margin:0"><table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;background:#F6F6F6"><tr><td align="center" style="padding:0 12px"><table role="presentation" width="560" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;max-width:560px;width:100%;background:#FFFFFF;border-radius:10px"><tr><td style="padding:24px">
88
+ <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">New support ticket — ${esc(operator.name)}</h2>
89
+ ${p(`<strong>From:</strong> ${esc(submitterName)} &lt;${esc(submitterEmail)}&gt;`)}
90
+ ${p(`<strong>Subject:</strong> ${esc(subject)}`)}
91
+ ${p(`<strong>Ticket:</strong> ${esc(ticketId)}`)}
92
+ <div style="margin:12px 0;padding:12px;background:#F6F6F6;border-radius:6px;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px;white-space:pre-wrap">${esc(message)}</div>
93
+ ${p(`Manage this ticket at <a href="https://${esc(operator.domain)}/admin/support-tickets/" style="color:#C98A5E">/admin/support-tickets/</a>.`)}
94
+ </td></tr></table></td></tr></table></div>`;
95
+
96
+ const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
97
+ method: 'POST', headers,
98
+ signal: AbortSignal.timeout(8000),
99
+ body: JSON.stringify({
100
+ type: 'Email',
101
+ contactId,
102
+ subject: `[Support Ticket] ${subject}`,
103
+ html,
104
+ }),
105
+ });
106
+ if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
107
+
108
+ await logOps(supabase, 'support_ticket_email_sent', { ticket_id: ticketId }, { severity: 'info' }).catch(() => {});
109
+ return 'sent';
110
+ } catch (e) {
111
+ const classification = classifyError(e);
112
+ await logOps(supabase, 'support_ticket_email_failed',
113
+ { ticket_id: ticketId, message: e instanceof Error ? e.message : String(e) },
114
+ // Expected to fail until the platform support inbox has a mailbox --
115
+ // warning, not error, so this doesn't page anyone for a known, accepted gap.
116
+ { severity: 'warning' }).catch(() => {});
117
+ return classification;
118
+ }
119
+ }
@@ -0,0 +1,125 @@
1
+ import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
2
+
3
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
4
+
5
+ export const TERMS_BUCKET = 'contract-templates';
6
+ export const TIER1_TERMS_DIR = 'booking-terms/tier1';
7
+
8
+ /**
9
+ * Authoritative contract tier for a room, resolved in the DATABASE via
10
+ * public.resolve_room_contract_tier() -> private.room_contract_tier().
11
+ * Never derive tier from client input or from rooms.booking_mode.
12
+ * Returns null when the room is not contract-mapped.
13
+ */
14
+ export async function resolveContractTier(
15
+ supabase: SupabaseLike,
16
+ roomId: string,
17
+ ): Promise<number | null> {
18
+ const { data, error } = await supabase.rpc('resolve_room_contract_tier', { p_room_id: roomId });
19
+ if (error) throw error;
20
+ return data === null || data === undefined ? null : Number(data);
21
+ }
22
+
23
+ async function sha256Hex(bytes: Uint8Array): Promise<string> {
24
+ const digest = await crypto.subtle.digest('SHA-256', bytes as unknown as BufferSource);
25
+ return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, '0')).join('');
26
+ }
27
+
28
+ export interface Tier1Terms {
29
+ version: string;
30
+ path: string;
31
+ content_sha256: string;
32
+ }
33
+
34
+ /**
35
+ * Loads the current Tier 1 terms artifact and hashes the EXACT bytes we served.
36
+ * The hash is always computed here — a client-supplied hash is never accepted.
37
+ * `declaredVersion` (what the browser rendered) must equal the manifest's
38
+ * current_version, otherwise the caller must reject with `terms_version_stale`.
39
+ */
40
+ export async function loadTier1Terms(
41
+ supabase: SupabaseLike,
42
+ declaredVersion: string | null,
43
+ ): Promise<
44
+ | { ok: true; terms: Tier1Terms }
45
+ | { ok: false; error: 'terms_unavailable' | 'terms_version_stale'; current_version?: string }
46
+ > {
47
+ const manifestRes = await supabase.storage.from(TERMS_BUCKET).download(`${TIER1_TERMS_DIR}/manifest.json`);
48
+ if (manifestRes.error || !manifestRes.data) return { ok: false, error: 'terms_unavailable' };
49
+ let current: string;
50
+ try {
51
+ const parsed = JSON.parse(await manifestRes.data.text()) as { current_version?: string };
52
+ if (!parsed.current_version) return { ok: false, error: 'terms_unavailable' };
53
+ current = parsed.current_version;
54
+ } catch {
55
+ return { ok: false, error: 'terms_unavailable' };
56
+ }
57
+
58
+ if (declaredVersion !== null && declaredVersion !== current) {
59
+ return { ok: false, error: 'terms_version_stale', current_version: current };
60
+ }
61
+
62
+ const path = `${TIER1_TERMS_DIR}/${current}.md`;
63
+ const docRes = await supabase.storage.from(TERMS_BUCKET).download(path);
64
+ if (docRes.error || !docRes.data) return { ok: false, error: 'terms_unavailable' };
65
+ const bytes = new Uint8Array(await docRes.data.arrayBuffer());
66
+
67
+ return { ok: true, terms: { version: current, path, content_sha256: await sha256Hex(bytes) } };
68
+ }
69
+
70
+ export interface Tier1AgreementInput {
71
+ bookingId: string;
72
+ roomSlug: string | null;
73
+ terms: Tier1Terms;
74
+ // How the acceptance was captured. Omitted (every existing web-checkout
75
+ // caller) defaults to 'click_through' — that default must never change
76
+ // for a caller that doesn't pass this.
77
+ method?: 'click_through' | 'phone_verbal';
78
+ signerName: string | null;
79
+ signerEmail: string | null;
80
+ signerIp: string | null;
81
+ signerUserAgent: string | null;
82
+ }
83
+
84
+ /**
85
+ * Records the Tier 1 acceptance. `booking_agreements.booking_id` is
86
+ * UNIQUE, so a duplicate insert (retry / reschedule re-entry) is a no-op.
87
+ */
88
+ export async function insertTier1Agreement(
89
+ supabase: SupabaseLike,
90
+ input: Tier1AgreementInput,
91
+ ): Promise<{ error: string | null }> {
92
+ const nowIso = new Date().toISOString();
93
+ const { error } = await supabase.from('booking_agreements').insert({
94
+ booking_id: input.bookingId,
95
+ tier: 1,
96
+ tier_source: 'mapped',
97
+ room_slug_at_capture: input.roomSlug,
98
+ capture_method: input.method ?? 'click_through',
99
+ status: 'completed',
100
+ completed_at: nowIso,
101
+ document_version: input.terms.version,
102
+ content_sha256: input.terms.content_sha256,
103
+ content_url: `${TERMS_BUCKET}/${input.terms.path}`,
104
+ signer_name: input.signerName,
105
+ signer_email: input.signerEmail,
106
+ signer_ip: input.signerIp,
107
+ signer_user_agent: input.signerUserAgent,
108
+ } as never);
109
+ // 23505 = booking already has an agreement row; treat as success.
110
+ const code = (error as { code?: string } | null)?.code;
111
+ if (error && code !== '23505') return { error: error.message };
112
+ return { error: null };
113
+ }
114
+
115
+ /** First hop of x-forwarded-for, matching _shared/rateLimit.ts's clientIp(). */
116
+ export function signerIpFrom(req: Request): string | null {
117
+ const xff = req.headers.get('x-forwarded-for');
118
+ const first = xff?.split(',')[0]?.trim();
119
+ return first && first.length > 0 ? first : null;
120
+ }
121
+
122
+ export function signerUserAgentFrom(req: Request): string | null {
123
+ const ua = req.headers.get('user-agent');
124
+ return ua ? ua.slice(0, 500) : null;
125
+ }