@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,128 +1,128 @@
1
- // Initial "sign and pay" portal email for a unified private-office agreement.
2
- //
3
- // Sent by create-agreement immediately after BoldSign accepts the send. This is
4
- // the FIRST outreach -- BoldSign delivers its own signing email separately.
5
- //
6
- // Mirrors the GHL request shape, headers, timeouts, escaping and error
7
- // classification of sendPaymentLinkEmail in ./paymentLinkEmail.ts.
8
-
9
- import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
10
- import { logOps } from './ops.ts';
11
-
12
- type SupabaseLike = SupabaseClient<any, 'public', any>;
13
-
14
- export type AgreementPortalEmailResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
15
-
16
- /** Escape untrusted values interpolated into outbound HTML. */
17
- function esc(v: unknown): string {
18
- return String(v ?? '')
19
- .replace(/&/g, '&amp;')
20
- .replace(/</g, '&lt;')
21
- .replace(/>/g, '&gt;')
22
- .replace(/"/g, '&quot;')
23
- .replace(/'/g, '&#39;');
24
- }
25
-
26
- /** Classify a caught error as transient (worth another event) or hopeless. */
27
- function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
28
- const name = e instanceof Error ? e.name : '';
29
- if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
30
- const msg = e instanceof Error ? e.message : String(e);
31
- const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
32
- if (m) {
33
- const code = Number(m[1]);
34
- if (code === 429 || code >= 500) return 'failed_retryable';
35
- }
36
- return 'failed_permanent';
37
- }
38
-
39
- export async function sendAgreementPortalEmail(
40
- supabase: SupabaseLike,
41
- { email, name, portalUrl, officeNumber }: {
42
- email: string;
43
- name?: string | null;
44
- portalUrl: string;
45
- officeNumber?: string | null;
46
- },
47
- operator: { name: string; shortName: string; domain: string; supportEmail: string },
48
- ): Promise<AgreementPortalEmailResult> {
49
- try {
50
- const apiKey = Deno.env.get('GHL_API_KEY');
51
- const locationId = Deno.env.get('GHL_LOCATION_ID');
52
- if (!apiKey || !locationId) {
53
- await logOps(supabase, 'agreement_portal_email_skipped',
54
- { email, reason: 'ghl_not_configured' }, { severity: 'warning' }).catch(() => {});
55
- return 'skipped';
56
- }
57
- const GHL_BASE = 'https://services.leadconnectorhq.com';
58
- const headers = {
59
- Authorization: `Bearer ${apiKey}`,
60
- Version: '2021-07-28',
61
- 'Content-Type': 'application/json',
62
- Accept: 'application/json',
63
- };
64
-
65
- const trimmed = (name || '').trim();
66
- const parts = trimmed.split(/\s+/).filter(Boolean);
67
- // Greeting is display-only. The CRM name is OMITTED when we have no name —
68
- // never defaulted, or we would overwrite a real contact with "there".
69
- const greetingName = parts[0] || 'there';
70
- const crmName: { firstName?: string; lastName?: string } = {};
71
- if (parts[0]) crmName.firstName = parts[0];
72
- if (parts.length > 1) crmName.lastName = parts.slice(1).join(' ');
73
-
74
- const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
75
- method: 'POST', headers,
76
- signal: AbortSignal.timeout(8000),
77
- body: JSON.stringify({
78
- locationId, ...crmName, email,
79
- source: `${operator.shortName} Website — Office Agreement`,
80
- tags: ['Office Agreement', 'Unified Portal', operator.domain],
81
- }),
82
- });
83
- if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
84
- const upJson = await upRes.json();
85
- const contactId = upJson.contact?.id || upJson.id || null;
86
- if (!contactId) throw new Error('ghl_upsert_no_contact_id');
87
-
88
- const p = (t: string) =>
89
- `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
90
-
91
- const office = (officeNumber || '').trim();
92
- const officeClause = office ? ` for office ${esc(office)}` : '';
93
- const subject = `Your ${operator.shortName} private office agreement is ready — review and pay your retainer`;
94
-
95
- 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">
96
- <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">Your ${operator.shortName} private office agreement is ready</h2>
97
- ${p(`Hi ${esc(greetingName)},`)}
98
- ${p(`Your ${operator.name} private office agreement${officeClause} is ready to review. There are two quick steps to get you moved in.`)}
99
- ${p('<strong>1. Review your terms and pay your service retainer.</strong> Open your secure agreement portal:')}
100
- ${p(`<a href="${esc(portalUrl)}" style="color:#C98A5E">Review and pay your retainer →</a>`)}
101
- ${p('<strong>2. Sign your agreement.</strong> BoldSign is sending you a separate email with the signing link — watch for it in your inbox (check spam if you don\'t see it shortly).')}
102
- ${p('Your monthly billing starts only after both steps are complete. This portal link is unique to your agreement, so please don\'t forward it.')}
103
- ${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>.`)}
104
- ${p(`Welcome aboard,<br />The ${operator.name} team`)}
105
- </td></tr></table></td></tr></table></div>`;
106
-
107
- const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
108
- method: 'POST', headers,
109
- signal: AbortSignal.timeout(8000),
110
- body: JSON.stringify({
111
- type: 'Email',
112
- contactId,
113
- subject,
114
- html,
115
- }),
116
- });
117
- if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
118
-
119
- await logOps(supabase, 'agreement_portal_email_sent', { email }, { severity: 'info' }).catch(() => {});
120
- return 'sent';
121
- } catch (e) {
122
- const classification = classifyError(e);
123
- await logOps(supabase, 'agreement_portal_email_failed',
124
- { email, message: e instanceof Error ? e.message : String(e) },
125
- { severity: classification === 'failed_permanent' ? 'error' : 'warning' }).catch(() => {});
126
- return classification;
127
- }
128
- }
1
+ // Initial "sign and pay" portal email for a unified private-office agreement.
2
+ //
3
+ // Sent by create-agreement immediately after BoldSign accepts the send. This is
4
+ // the FIRST outreach -- BoldSign delivers its own signing email separately.
5
+ //
6
+ // Mirrors the GHL request shape, headers, timeouts, escaping and error
7
+ // classification of sendPaymentLinkEmail in ./paymentLinkEmail.ts.
8
+
9
+ import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
10
+ import { logOps } from './ops.ts';
11
+
12
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
13
+
14
+ export type AgreementPortalEmailResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
15
+
16
+ /** Escape untrusted values interpolated into outbound HTML. */
17
+ function esc(v: unknown): string {
18
+ return String(v ?? '')
19
+ .replace(/&/g, '&amp;')
20
+ .replace(/</g, '&lt;')
21
+ .replace(/>/g, '&gt;')
22
+ .replace(/"/g, '&quot;')
23
+ .replace(/'/g, '&#39;');
24
+ }
25
+
26
+ /** Classify a caught error as transient (worth another event) or hopeless. */
27
+ function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
28
+ const name = e instanceof Error ? e.name : '';
29
+ if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
30
+ const msg = e instanceof Error ? e.message : String(e);
31
+ const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
32
+ if (m) {
33
+ const code = Number(m[1]);
34
+ if (code === 429 || code >= 500) return 'failed_retryable';
35
+ }
36
+ return 'failed_permanent';
37
+ }
38
+
39
+ export async function sendAgreementPortalEmail(
40
+ supabase: SupabaseLike,
41
+ { email, name, portalUrl, officeNumber }: {
42
+ email: string;
43
+ name?: string | null;
44
+ portalUrl: string;
45
+ officeNumber?: string | null;
46
+ },
47
+ operator: { name: string; shortName: string; domain: string; supportEmail: string },
48
+ ): Promise<AgreementPortalEmailResult> {
49
+ try {
50
+ const apiKey = Deno.env.get('GHL_API_KEY');
51
+ const locationId = Deno.env.get('GHL_LOCATION_ID');
52
+ if (!apiKey || !locationId) {
53
+ await logOps(supabase, 'agreement_portal_email_skipped',
54
+ { email, reason: 'ghl_not_configured' }, { severity: 'warning' }).catch(() => {});
55
+ return 'skipped';
56
+ }
57
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
58
+ const headers = {
59
+ Authorization: `Bearer ${apiKey}`,
60
+ Version: '2021-07-28',
61
+ 'Content-Type': 'application/json',
62
+ Accept: 'application/json',
63
+ };
64
+
65
+ const trimmed = (name || '').trim();
66
+ const parts = trimmed.split(/\s+/).filter(Boolean);
67
+ // Greeting is display-only. The CRM name is OMITTED when we have no name —
68
+ // never defaulted, or we would overwrite a real contact with "there".
69
+ const greetingName = parts[0] || 'there';
70
+ const crmName: { firstName?: string; lastName?: string } = {};
71
+ if (parts[0]) crmName.firstName = parts[0];
72
+ if (parts.length > 1) crmName.lastName = parts.slice(1).join(' ');
73
+
74
+ const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
75
+ method: 'POST', headers,
76
+ signal: AbortSignal.timeout(8000),
77
+ body: JSON.stringify({
78
+ locationId, ...crmName, email,
79
+ source: `${operator.shortName} Website — Office Agreement`,
80
+ tags: ['Office Agreement', 'Unified Portal', operator.domain],
81
+ }),
82
+ });
83
+ if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
84
+ const upJson = await upRes.json();
85
+ const contactId = upJson.contact?.id || upJson.id || null;
86
+ if (!contactId) throw new Error('ghl_upsert_no_contact_id');
87
+
88
+ const p = (t: string) =>
89
+ `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
90
+
91
+ const office = (officeNumber || '').trim();
92
+ const officeClause = office ? ` for office ${esc(office)}` : '';
93
+ const subject = `Your ${operator.shortName} private office agreement is ready — review and pay your retainer`;
94
+
95
+ 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">
96
+ <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">Your ${operator.shortName} private office agreement is ready</h2>
97
+ ${p(`Hi ${esc(greetingName)},`)}
98
+ ${p(`Your ${operator.name} private office agreement${officeClause} is ready to review. There are two quick steps to get you moved in.`)}
99
+ ${p('<strong>1. Review your terms and pay your service retainer.</strong> Open your secure agreement portal:')}
100
+ ${p(`<a href="${esc(portalUrl)}" style="color:#C98A5E">Review and pay your retainer →</a>`)}
101
+ ${p('<strong>2. Sign your agreement.</strong> BoldSign is sending you a separate email with the signing link — watch for it in your inbox (check spam if you don\'t see it shortly).')}
102
+ ${p('Your monthly billing starts only after both steps are complete. This portal link is unique to your agreement, so please don\'t forward it.')}
103
+ ${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>.`)}
104
+ ${p(`Welcome aboard,<br />The ${operator.name} team`)}
105
+ </td></tr></table></td></tr></table></div>`;
106
+
107
+ const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
108
+ method: 'POST', headers,
109
+ signal: AbortSignal.timeout(8000),
110
+ body: JSON.stringify({
111
+ type: 'Email',
112
+ contactId,
113
+ subject,
114
+ html,
115
+ }),
116
+ });
117
+ if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
118
+
119
+ await logOps(supabase, 'agreement_portal_email_sent', { email }, { severity: 'info' }).catch(() => {});
120
+ return 'sent';
121
+ } catch (e) {
122
+ const classification = classifyError(e);
123
+ await logOps(supabase, 'agreement_portal_email_failed',
124
+ { email, message: e instanceof Error ? e.message : String(e) },
125
+ { severity: classification === 'failed_permanent' ? 'error' : 'warning' }).catch(() => {});
126
+ return classification;
127
+ }
128
+ }
@@ -1,117 +1,117 @@
1
- // Staff-triggered "update your billing" email, sent when an admin mints a
2
- // Stripe billing-portal link for a member from the admin console.
3
- //
4
- // Mirrors the GHL request shape, headers, escaping and error classification
5
- // of sendPaymentLinkEmail in ./paymentLinkEmail.ts -- same transport, same
6
- // safety properties, different copy (this is for an EXISTING member updating
7
- // a card on file, not a new signup completing checkout).
8
-
9
- import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
10
- import { logOps } from './ops.ts';
11
-
12
- type SupabaseLike = SupabaseClient<any, 'public', any>;
13
-
14
- export type BillingPortalLinkEmailResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
15
-
16
- function esc(v: unknown): string {
17
- return String(v ?? '')
18
- .replace(/&/g, '&amp;')
19
- .replace(/</g, '&lt;')
20
- .replace(/>/g, '&gt;')
21
- .replace(/"/g, '&quot;')
22
- .replace(/'/g, '&#39;');
23
- }
24
-
25
- function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
26
- const name = e instanceof Error ? e.name : '';
27
- if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
28
- const msg = e instanceof Error ? e.message : String(e);
29
- const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
30
- if (m) {
31
- const code = Number(m[1]);
32
- if (code === 429 || code >= 500) return 'failed_retryable';
33
- }
34
- return 'failed_permanent';
35
- }
36
-
37
- export async function sendBillingPortalLinkEmail(
38
- supabase: SupabaseLike,
39
- { email, name, portalUrl }: {
40
- email: string;
41
- name?: string | null;
42
- portalUrl: string;
43
- },
44
- operator: { name: string; shortName: string; domain: string; supportEmail: string },
45
- ): Promise<BillingPortalLinkEmailResult> {
46
- try {
47
- const apiKey = Deno.env.get('GHL_API_KEY');
48
- const locationId = Deno.env.get('GHL_LOCATION_ID');
49
- if (!apiKey || !locationId) {
50
- await logOps(supabase, 'billing_portal_link_email_skipped',
51
- { email, reason: 'ghl_not_configured' }, { severity: 'warning' }).catch(() => {});
52
- return 'skipped';
53
- }
54
- const GHL_BASE = 'https://services.leadconnectorhq.com';
55
- const headers = {
56
- Authorization: `Bearer ${apiKey}`,
57
- Version: '2021-07-28',
58
- 'Content-Type': 'application/json',
59
- Accept: 'application/json',
60
- };
61
-
62
- const trimmed = (name || '').trim();
63
- const parts = trimmed.split(/\s+/).filter(Boolean);
64
- const greetingName = parts[0] || 'there';
65
- const crmName: { firstName?: string; lastName?: string } = {};
66
- if (parts[0]) crmName.firstName = parts[0];
67
- if (parts.length > 1) crmName.lastName = parts.slice(1).join(' ');
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, ...crmName, email,
74
- source: `${operator.shortName} Admin — Billing Update`,
75
- tags: ['Billing Update', operator.domain],
76
- }),
77
- });
78
- if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
79
- const upJson = await upRes.json();
80
- const contactId = upJson.contact?.id || upJson.id || null;
81
- if (!contactId) throw new Error('ghl_upsert_no_contact_id');
82
-
83
- const p = (t: string) =>
84
- `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
85
-
86
- 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">
87
- <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">Update your ${operator.shortName} billing details</h2>
88
- ${p(`Hi ${esc(greetingName)},`)}
89
- ${p(`Our team wanted to make it easy for you to update the payment method on your ${operator.name} membership. Use the secure link below:`)}
90
- ${p(`<a href="${esc(portalUrl)}" style="color:#C98A5E">Update payment method →</a>`)}
91
- ${p("This link is unique to your account and takes you straight to our payment processor, Stripe, where you can update your card, view invoices, and manage your subscription. Please don't forward it.")}
92
- ${p(`Questions? Just reply to this email or reach us at <a href="mailto:${operator.supportEmail}" style="color:#C98A5E">${operator.supportEmail}</a>.`)}
93
- ${p(`Thanks,<br />The ${operator.name} team`)}
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: `Update your ${operator.shortName} billing details`,
103
- html,
104
- }),
105
- });
106
- if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
107
-
108
- await logOps(supabase, 'billing_portal_link_email_sent', { email }, { severity: 'info' }).catch(() => {});
109
- return 'sent';
110
- } catch (e) {
111
- const classification = classifyError(e);
112
- await logOps(supabase, 'billing_portal_link_email_failed',
113
- { email, message: e instanceof Error ? e.message : String(e) },
114
- { severity: classification === 'failed_permanent' ? 'error' : 'warning' }).catch(() => {});
115
- return classification;
116
- }
117
- }
1
+ // Staff-triggered "update your billing" email, sent when an admin mints a
2
+ // Stripe billing-portal link for a member from the admin console.
3
+ //
4
+ // Mirrors the GHL request shape, headers, escaping and error classification
5
+ // of sendPaymentLinkEmail in ./paymentLinkEmail.ts -- same transport, same
6
+ // safety properties, different copy (this is for an EXISTING member updating
7
+ // a card on file, not a new signup completing checkout).
8
+
9
+ import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
10
+ import { logOps } from './ops.ts';
11
+
12
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
13
+
14
+ export type BillingPortalLinkEmailResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
15
+
16
+ function esc(v: unknown): string {
17
+ return String(v ?? '')
18
+ .replace(/&/g, '&amp;')
19
+ .replace(/</g, '&lt;')
20
+ .replace(/>/g, '&gt;')
21
+ .replace(/"/g, '&quot;')
22
+ .replace(/'/g, '&#39;');
23
+ }
24
+
25
+ function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
26
+ const name = e instanceof Error ? e.name : '';
27
+ if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
28
+ const msg = e instanceof Error ? e.message : String(e);
29
+ const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
30
+ if (m) {
31
+ const code = Number(m[1]);
32
+ if (code === 429 || code >= 500) return 'failed_retryable';
33
+ }
34
+ return 'failed_permanent';
35
+ }
36
+
37
+ export async function sendBillingPortalLinkEmail(
38
+ supabase: SupabaseLike,
39
+ { email, name, portalUrl }: {
40
+ email: string;
41
+ name?: string | null;
42
+ portalUrl: string;
43
+ },
44
+ operator: { name: string; shortName: string; domain: string; supportEmail: string },
45
+ ): Promise<BillingPortalLinkEmailResult> {
46
+ try {
47
+ const apiKey = Deno.env.get('GHL_API_KEY');
48
+ const locationId = Deno.env.get('GHL_LOCATION_ID');
49
+ if (!apiKey || !locationId) {
50
+ await logOps(supabase, 'billing_portal_link_email_skipped',
51
+ { email, reason: 'ghl_not_configured' }, { severity: 'warning' }).catch(() => {});
52
+ return 'skipped';
53
+ }
54
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
55
+ const headers = {
56
+ Authorization: `Bearer ${apiKey}`,
57
+ Version: '2021-07-28',
58
+ 'Content-Type': 'application/json',
59
+ Accept: 'application/json',
60
+ };
61
+
62
+ const trimmed = (name || '').trim();
63
+ const parts = trimmed.split(/\s+/).filter(Boolean);
64
+ const greetingName = parts[0] || 'there';
65
+ const crmName: { firstName?: string; lastName?: string } = {};
66
+ if (parts[0]) crmName.firstName = parts[0];
67
+ if (parts.length > 1) crmName.lastName = parts.slice(1).join(' ');
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, ...crmName, email,
74
+ source: `${operator.shortName} Admin — Billing Update`,
75
+ tags: ['Billing Update', operator.domain],
76
+ }),
77
+ });
78
+ if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
79
+ const upJson = await upRes.json();
80
+ const contactId = upJson.contact?.id || upJson.id || null;
81
+ if (!contactId) throw new Error('ghl_upsert_no_contact_id');
82
+
83
+ const p = (t: string) =>
84
+ `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
85
+
86
+ 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">
87
+ <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">Update your ${operator.shortName} billing details</h2>
88
+ ${p(`Hi ${esc(greetingName)},`)}
89
+ ${p(`Our team wanted to make it easy for you to update the payment method on your ${operator.name} membership. Use the secure link below:`)}
90
+ ${p(`<a href="${esc(portalUrl)}" style="color:#C98A5E">Update payment method →</a>`)}
91
+ ${p("This link is unique to your account and takes you straight to our payment processor, Stripe, where you can update your card, view invoices, and manage your subscription. Please don't forward it.")}
92
+ ${p(`Questions? Just reply to this email or reach us at <a href="mailto:${operator.supportEmail}" style="color:#C98A5E">${operator.supportEmail}</a>.`)}
93
+ ${p(`Thanks,<br />The ${operator.name} team`)}
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: `Update your ${operator.shortName} billing details`,
103
+ html,
104
+ }),
105
+ });
106
+ if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
107
+
108
+ await logOps(supabase, 'billing_portal_link_email_sent', { email }, { severity: 'info' }).catch(() => {});
109
+ return 'sent';
110
+ } catch (e) {
111
+ const classification = classifyError(e);
112
+ await logOps(supabase, 'billing_portal_link_email_failed',
113
+ { email, message: e instanceof Error ? e.message : String(e) },
114
+ { severity: classification === 'failed_permanent' ? 'error' : 'warning' }).catch(() => {});
115
+ return classification;
116
+ }
117
+ }