@simplelayer/graniteer-core 0.1.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 (130) hide show
  1. package/index.js +2 -2
  2. package/package.json +73 -2
  3. package/src/agreementCheckout.ts +250 -0
  4. package/src/agreementPortalEmail.ts +128 -0
  5. package/src/billingPortalLinkEmail.ts +117 -0
  6. package/src/bookingAgreementEmail.ts +149 -0
  7. package/src/bookingEffects.ts +388 -0
  8. package/src/busClient.ts +268 -0
  9. package/src/busSignature.ts +71 -0
  10. package/src/checkoutCoupon.test.ts +675 -0
  11. package/src/checkoutCoupon.ts +455 -0
  12. package/src/commonsDeposit.ts +298 -0
  13. package/src/commonsDepositWebhook.ts +237 -0
  14. package/src/dayPassConfirmation.ts +230 -0
  15. package/src/dunningEmails.test.ts +263 -0
  16. package/src/dunningEmails.ts +203 -0
  17. package/src/email-templates/brand.ts +93 -0
  18. package/src/email-templates/magic-link.tsx +59 -0
  19. package/src/email-templates/recovery.tsx +59 -0
  20. package/src/email-templates/signup.tsx +67 -0
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -308
  23. package/src/functions/admin-charge-guest-print.ts +229 -229
  24. package/src/functions/admin-correct-booking.ts +333 -333
  25. package/src/functions/admin-create-booking.ts +460 -0
  26. package/src/functions/admin-create-commons-event.ts +244 -244
  27. package/src/functions/admin-debug-boldsign-doc.ts +93 -93
  28. package/src/functions/admin-door-write.ts +272 -272
  29. package/src/functions/admin-issue-day-pass.ts +231 -0
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -0
  32. package/src/functions/admin-mint-portal-link.ts +62 -0
  33. package/src/functions/admin-photo-upload.ts +128 -128
  34. package/src/functions/admin-remove-team-member.ts +150 -150
  35. package/src/functions/admin-request-trial.ts +366 -0
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -0
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.test.ts +567 -0
  39. package/src/functions/admin-retry-invoice-payment.ts +333 -0
  40. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  41. package/src/functions/admin-revoke-agreement.ts +467 -0
  42. package/src/functions/admin-send-commons-agreement.ts +214 -214
  43. package/src/functions/admin-set-credit-amount.ts +123 -123
  44. package/src/functions/admin-skip-commons-contract.ts +165 -165
  45. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  46. package/src/functions/admin-wall-photo-write.ts +141 -141
  47. package/src/functions/auth-email-hook.ts +259 -0
  48. package/src/functions/boldsign-sender-identity.ts +114 -114
  49. package/src/functions/booking-availability.ts +419 -419
  50. package/src/functions/booking-member-preview.ts +136 -136
  51. package/src/functions/booking-status.ts +149 -0
  52. package/src/functions/conductor.ts +505 -0
  53. package/src/functions/create-agreement.ts +537 -0
  54. package/src/functions/create-booking.ts +648 -0
  55. package/src/functions/create-day-pass-checkout.ts +218 -0
  56. package/src/functions/create-portal-session.ts +142 -0
  57. package/src/functions/create-subscription-checkout.test.ts +222 -0
  58. package/src/functions/create-subscription-checkout.ts +440 -0
  59. package/src/functions/day-pass-status.ts +89 -89
  60. package/src/functions/diag-webpush-test.ts +45 -45
  61. package/src/functions/event-access-admin.ts +277 -0
  62. package/src/functions/event-access-store.ts +309 -309
  63. package/src/functions/ezeep-print-webhook.ts +213 -213
  64. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  65. package/src/functions/fetch-avatar-original.ts +457 -0
  66. package/src/functions/get-provider-sign-link.ts +155 -0
  67. package/src/functions/get-signing-link.ts +211 -211
  68. package/src/functions/guest-print-setup-confirm.ts +128 -128
  69. package/src/functions/guest-print-submit.ts +149 -149
  70. package/src/functions/luma-webhook.ts +165 -165
  71. package/src/functions/manage-booking.ts +472 -0
  72. package/src/functions/mcp.ts +67 -0
  73. package/src/functions/member-door-action.test.ts +1248 -0
  74. package/src/functions/member-door-action.ts +863 -0
  75. package/src/functions/member-unifi-mapping.test.ts +516 -0
  76. package/src/functions/member-unifi-mapping.ts +206 -0
  77. package/src/functions/membership-door-sync.ts +956 -0
  78. package/src/functions/migration-collision-alert.copy.ts +232 -232
  79. package/src/functions/migration-collision-alert.test.ts +349 -349
  80. package/src/functions/migration-collision-alert.ts +232 -232
  81. package/src/functions/office-assignment-end.ts +146 -146
  82. package/src/functions/portal-booking-access.ts +95 -95
  83. package/src/functions/portal-list-invoices.ts +99 -99
  84. package/src/functions/portal-request-login.ts +192 -0
  85. package/src/functions/portal-resend-invite.ts +248 -0
  86. package/src/functions/portal-submit-event.ts +168 -0
  87. package/src/functions/print-billing-recover.ts +97 -97
  88. package/src/functions/print-billing-run.ts +183 -183
  89. package/src/functions/public-facts.ts +168 -168
  90. package/src/functions/push-send.ts +348 -0
  91. package/src/functions/push-test.ts +234 -0
  92. package/src/functions/request-portal-link.ts +211 -0
  93. package/src/functions/reschedule-booking.ts +649 -0
  94. package/src/functions/review-ratings.ts +113 -0
  95. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  96. package/src/functions/space-availability-range.ts +142 -142
  97. package/src/functions/stripe-db-reconcile.ts +319 -0
  98. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  99. package/src/functions/stripe-webhook.ts +2595 -0
  100. package/src/functions/sync-gcal-blackouts.ts +298 -298
  101. package/src/functions/timetable-event-register.ts +162 -162
  102. package/src/functions/timetable-event-status.ts +90 -90
  103. package/src/functions/timetable-spaces.ts +219 -219
  104. package/src/functions/touch-pass-reconciler.ts +689 -689
  105. package/src/functions/touch-pass-signup.ts +478 -0
  106. package/src/functions/upload-booking-display-image.ts +179 -0
  107. package/src/functions/virtual-onboarding-purge.ts +134 -134
  108. package/src/functions/virtual-onboarding-submit.ts +315 -315
  109. package/src/functions/voice-booking.ts +453 -0
  110. package/src/functions/voice-day-pass.ts +346 -0
  111. package/src/functions/voice-inquiry.test.ts +301 -301
  112. package/src/functions/voice-inquiry.ts +198 -198
  113. package/src/functions/voice-membership-signup.ts +355 -0
  114. package/src/functions/voice-tour-availability.ts +204 -204
  115. package/src/functions/voice-tour-booking.ts +429 -0
  116. package/src/ghlEventInquiry.ts +143 -0
  117. package/src/mailArrivalEmail.ts +121 -0
  118. package/src/manageToken.ts +363 -0
  119. package/src/membershipBusClient.ts +537 -0
  120. package/src/membershipWelcome.ts +683 -0
  121. package/src/migrationCheckout.ts +366 -0
  122. package/src/pacificDate.ts +54 -0
  123. package/src/paymentLinkEmail.ts +123 -0
  124. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  125. package/src/signedUnpaidReminderEmail.ts +132 -0
  126. package/src/stripeCoworkingPortal.ts +91 -0
  127. package/src/supabaseTestFakes.ts +131 -131
  128. package/src/supportTicketEmail.ts +119 -0
  129. package/src/unifiAccessPolicies.ts +228 -0
  130. package/src/unifiGroups.ts +129 -0
@@ -0,0 +1,230 @@
1
+ // v1a day-pass confirmation email. Sends a branded GHL email confirming a
2
+ // day pass -- visit date, arrival time, amount, front-desk/WiFi instructions.
3
+ // Deliberately NO Supabase auth account, NO magic link, NO portal CTA --
4
+ // that's a later phase, gated on real door/WiFi provisioning existing.
5
+ // Modeled on bookingEffects.ts's notifyGhl confirmation-email step:
6
+ // best-effort, never throws into the caller.
7
+
8
+ import type { createClient, SupabaseClient } from 'npm:@supabase/supabase-js@2';
9
+ import { logOps } from './ops.ts';
10
+
11
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
12
+
13
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
14
+
15
+ export interface DayPassPurchase {
16
+ email: string;
17
+ customerName: string | null;
18
+ visitDate: string | null;
19
+ arrivalTime: string | null;
20
+ amountCents: number | null;
21
+ // Set only once ftw-middleware has actually minted a WiFi code for this
22
+ // booking (provisionDayPass() in the stripe-webhook handler). null/absent
23
+ // covers every other case -- feature not yet turned on, provisioning
24
+ // disabled/failed, or WiFi specifically not enabled even though door
25
+ // provisioning is -- and falls back to the generic front-desk copy below,
26
+ // so this email is safe to send unchanged before Kyle flips any flag on.
27
+ wifiCode?: string | null;
28
+ }
29
+
30
+ function esc(v: unknown): string {
31
+ return String(v ?? '')
32
+ .replace(/&/g, '&amp;')
33
+ .replace(/</g, '&lt;')
34
+ .replace(/>/g, '&gt;')
35
+ .replace(/"/g, '&quot;')
36
+ .replace(/'/g, '&#39;');
37
+ }
38
+
39
+ function fmtDollars(cents: number | null | undefined): string {
40
+ const c = cents ?? 0;
41
+ return `$${(c / 100).toFixed(c % 100 === 0 ? 0 : 2)}`;
42
+ }
43
+
44
+ function fmtVisitDate(visitDate: string | null): string {
45
+ if (!visitDate) return 'your visit';
46
+ const [y, m, d] = visitDate.split('-').map(Number);
47
+ if (!y || !m || !d) return visitDate;
48
+ const dt = new Date(Date.UTC(y, m - 1, d));
49
+ return new Intl.DateTimeFormat('en-US', {
50
+ timeZone: 'UTC', weekday: 'long', month: 'long', day: 'numeric',
51
+ }).format(dt);
52
+ }
53
+
54
+ function fmtArrival(arrivalTime: string | null): string | null {
55
+ const m = arrivalTime?.match(/^(\d{2}):(\d{2})/);
56
+ if (!m) return null;
57
+ const h = Number(m[1]);
58
+ const mer = h >= 12 ? 'pm' : 'am';
59
+ const h12 = h % 12 === 0 ? 12 : h % 12;
60
+ return `${h12}:${m[2]}${mer}`;
61
+ }
62
+
63
+ const WEEKDAY_LONG = [
64
+ 'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday',
65
+ ];
66
+
67
+ /** Host hours, read from app_settings -- the STAFFED-hours source
68
+ * (host_hours_open/close/days), deliberately NOT the booking-window
69
+ * `business_hours` table, which is a different concept. Falls back to
70
+ * generic wording if app_settings rows are missing. */
71
+ async function hostHoursLine(supabase: SupabaseLike): Promise<string> {
72
+ try {
73
+ const { data: rows } = await supabase
74
+ .from('app_settings')
75
+ .select('key,value')
76
+ .in('key', ['host_hours_open', 'host_hours_close', 'host_hours_days']);
77
+ const map = new Map<string, string>();
78
+ for (const r of (rows ?? []) as Record<string, unknown>[]) {
79
+ if (typeof r.key === 'string' && typeof r.value === 'string') map.set(r.key, r.value);
80
+ }
81
+ const fmt = (t: string | undefined) => {
82
+ const mm = t?.match(/^(\d{2}):(\d{2})/);
83
+ if (!mm) return null;
84
+ const h = Number(mm[1]);
85
+ const mer = h >= 12 ? 'pm' : 'am';
86
+ const h12 = h % 12 === 0 ? 12 : h % 12;
87
+ const mins = mm[2] === '00' ? '' : `:${mm[2]}`;
88
+ return `${h12}${mins}${mer}`;
89
+ };
90
+ const open = fmt(map.get('host_hours_open'));
91
+ const close = fmt(map.get('host_hours_close'));
92
+ if (open && close) {
93
+ const daysRaw = (map.get('host_hours_days') ?? '').trim();
94
+ const dm = daysRaw.match(/^(\d)\s*-\s*(\d)$/) ?? daysRaw.match(/^(\d)$/);
95
+ if (dm) {
96
+ const start = Number(dm[1]);
97
+ const end = dm[2] === undefined ? start : Number(dm[2]);
98
+ const valid = Number.isFinite(start) && Number.isFinite(end) &&
99
+ start >= 0 && start <= 6 && end >= 0 && end <= 6 && end >= start;
100
+ if (valid) {
101
+ const range = start === end
102
+ ? WEEKDAY_LONG[start]
103
+ : `${WEEKDAY_LONG[start]}–${WEEKDAY_LONG[end]}`;
104
+ return `${range}, ${open}–${close}`;
105
+ }
106
+ }
107
+ return `${open}–${close}`;
108
+ }
109
+ } catch { /* fall through */ }
110
+ return 'during posted host hours';
111
+ }
112
+
113
+ export async function sendDayPassConfirmation(
114
+ supabase: SupabaseLike,
115
+ purchase: DayPassPurchase,
116
+ operator: { name: string; shortName: string; domain: string; supportEmail: string },
117
+ ): Promise<'sent' | 'skipped' | 'failed'> {
118
+ try {
119
+ const apiKey = Deno.env.get('GHL_API_KEY');
120
+ const locationId = Deno.env.get('GHL_LOCATION_ID');
121
+ if (!apiKey || !locationId) {
122
+ console.log('[dayPassConfirmation] GHL not configured; skip');
123
+ await logOps(supabase, 'day_pass_confirmation_skipped',
124
+ { customer_email: purchase.email }, { severity: 'warning' }).catch(() => {});
125
+ return 'skipped';
126
+ }
127
+ const headers = {
128
+ Authorization: `Bearer ${apiKey}`,
129
+ Version: '2021-07-28',
130
+ 'Content-Type': 'application/json',
131
+ Accept: 'application/json',
132
+ };
133
+
134
+ const name = (purchase.customerName || '').trim();
135
+ const parts = name.split(/\s+/).filter(Boolean);
136
+ const greetingName = parts[0] || 'there';
137
+ const crmName: { firstName?: string; lastName?: string } = {};
138
+ if (parts[0]) crmName.firstName = parts[0];
139
+ if (parts.length > 1) crmName.lastName = parts.slice(1).join(' ');
140
+
141
+ const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
142
+ method: 'POST', headers,
143
+ signal: AbortSignal.timeout(8000),
144
+ body: JSON.stringify({
145
+ locationId, ...crmName, email: purchase.email,
146
+ source: `${operator.shortName} Website — Day Pass`,
147
+ tags: ['Guest', 'day-pass', operator.domain],
148
+ }),
149
+ });
150
+ if (!upRes.ok) {
151
+ const bodyText = await upRes.text();
152
+ console.warn('[dayPassConfirmation] GHL upsert failed', upRes.status, bodyText);
153
+ await logOps(supabase, 'day_pass_confirmation_failed',
154
+ { customer_email: purchase.email, visit_date: purchase.visitDate, stage: 'ghl_upsert', status: upRes.status },
155
+ { severity: 'error' }).catch(() => {});
156
+ return 'failed';
157
+ }
158
+ const upJson = await upRes.json();
159
+ const contactId = upJson.contact?.id || upJson.id || null;
160
+ if (!contactId) {
161
+ console.warn('[dayPassConfirmation] no contact id from upsert');
162
+ await logOps(supabase, 'day_pass_confirmation_failed',
163
+ { customer_email: purchase.email, visit_date: purchase.visitDate, stage: 'no_contact_id' },
164
+ { severity: 'error' }).catch(() => {});
165
+ return 'failed';
166
+ }
167
+
168
+ const visitLine = fmtVisitDate(purchase.visitDate);
169
+ const arrival = fmtArrival(purchase.arrivalTime);
170
+ const amount = fmtDollars(purchase.amountCents);
171
+ const hostHours = await hostHoursLine(supabase);
172
+
173
+ const card = (title: string, inner: string) =>
174
+ `<tr><td style="padding:0 0 16px 0"><table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;border:1px solid #E5E1D8;border-radius:8px"><tr><td style="padding:16px"><h3 style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:16px">${title}</h3>${inner}</td></tr></table></td></tr>`;
175
+ const p = (t: string) =>
176
+ `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
177
+
178
+ const detailsCard = card('Your visit', [
179
+ p(`<strong>Date:</strong> ${esc(visitLine)}`),
180
+ arrival ? p(`<strong>Arriving around:</strong> ${esc(arrival)}`) : '',
181
+ p(`<strong>Paid:</strong> ${esc(amount)}`),
182
+ ].join(''));
183
+
184
+ const wifiLine = purchase.wifiCode
185
+ ? `<strong>Your WiFi code:</strong> ${esc(purchase.wifiCode)}`
186
+ : `Ask any team member for the guest WiFi details.`;
187
+
188
+ const checkinCard = card('When you arrive', [
189
+ p(`Check in at the front desk and let a team member know you have a day pass.`),
190
+ p(wifiLine),
191
+ p(`Hosts are on site ${esc(hostHours)} Pacific — outside those hours, check in whenever the front desk is staffed.`),
192
+ ].join(''));
193
+
194
+ 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">
195
+ <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">Your day pass is confirmed</h2>
196
+ ${p(`Hi ${esc(greetingName)},`)}
197
+ ${p(`Thanks for booking a day pass at ${esc(operator.name)}.`)}
198
+ <table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;margin-top:12px">${detailsCard}${checkinCard}</table>
199
+ ${p(`Questions before you come in? Reply to this email or write to <a href="mailto:${operator.supportEmail}" style="color:#C98A5E">${operator.supportEmail}</a>.`)}
200
+ <p style="margin:24px 0 0 0;color:#748272;font-family:Inter,Arial,sans-serif;font-size:13px;line-height:20px">${operator.name}</p>
201
+ </td></tr></table></td></tr></table></div>`;
202
+
203
+ const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
204
+ method: 'POST', headers,
205
+ signal: AbortSignal.timeout(8000),
206
+ body: JSON.stringify({
207
+ type: 'Email',
208
+ contactId,
209
+ subject: `Your day pass is confirmed — ${visitLine}`,
210
+ html,
211
+ }),
212
+ });
213
+ if (!emailRes.ok) {
214
+ const bodyText = await emailRes.text();
215
+ console.warn('[dayPassConfirmation] send failed', emailRes.status, bodyText);
216
+ await logOps(supabase, 'day_pass_confirmation_failed',
217
+ { customer_email: purchase.email, visit_date: purchase.visitDate, stage: 'ghl_send', status: emailRes.status },
218
+ { severity: 'error' }).catch(() => {});
219
+ return 'failed';
220
+ }
221
+ await logOps(supabase, 'day_pass_confirmation_sent',
222
+ { customer_email: purchase.email, visit_date: purchase.visitDate }, { severity: 'info' }).catch(() => {});
223
+ return 'sent';
224
+ } catch (e) {
225
+ await logOps(supabase, 'day_pass_confirmation_failed',
226
+ { customer_email: purchase.email, message: e instanceof Error ? e.message : String(e) },
227
+ { severity: 'error' }).catch(() => {});
228
+ return 'failed';
229
+ }
230
+ }
@@ -0,0 +1,263 @@
1
+ // Unit tests for dunningEmails.ts: stageForGraceWindow's day-band boundaries,
2
+ // shouldSendDunningStage's skip-if-already-sent logic, and sendDunningEmail's
3
+ // GHL upsert+send outcomes.
4
+ //
5
+ // Run with:
6
+ // deno test --node-modules-dir=auto --allow-env --allow-net --allow-read \
7
+ // src/dunningEmails.test.ts
8
+ //
9
+ // NO REAL NETWORK, NO REAL DB: fetch is a global stub (same style as
10
+ // trialConversion.test.ts / voice-inquiry/index.test.ts) and the Supabase
11
+ // client is a minimal in-memory stub that only supports what sendDunningEmail
12
+ // actually calls (ops_events inserts via logOps).
13
+ import { assert, assertEquals } from 'https://deno.land/std@0.224.0/assert/mod.ts';
14
+ import {
15
+ sendDunningEmail,
16
+ stageForGraceWindow,
17
+ shouldSendDunningStage,
18
+ } from './dunningEmails.ts';
19
+
20
+ const ONE_DAY_MS = 24 * 60 * 60 * 1000;
21
+ const MEMBERSHIP_ID = '33333333-3333-3333-3333-333333333333';
22
+ const EMAIL = 'member@example.com';
23
+ const OPERATOR = { name: 'Granite City Workspaces', shortName: 'Granite City', domain: 'granitecity.io', supportEmail: 'info@granitecity.io' };
24
+
25
+ function withEnv(overrides: Record<string, string | undefined>, fn: () => Promise<void>): Promise<void> {
26
+ const prior: Record<string, string | undefined> = {};
27
+ for (const k of Object.keys(overrides)) prior[k] = Deno.env.get(k);
28
+ for (const [k, v] of Object.entries(overrides)) {
29
+ if (v === undefined) Deno.env.delete(k); else Deno.env.set(k, v);
30
+ }
31
+ return fn().finally(() => {
32
+ for (const [k, v] of Object.entries(prior)) {
33
+ if (v === undefined) Deno.env.delete(k); else Deno.env.set(k, v);
34
+ }
35
+ });
36
+ }
37
+
38
+ // deno-lint-ignore no-explicit-any
39
+ function stubClient(): { client: any; opsEvents: Array<Record<string, unknown>> } {
40
+ const opsEvents: Array<Record<string, unknown>> = [];
41
+ const builder = (table: string) => ({
42
+ insert: (p: Record<string, unknown>) => {
43
+ if (table === 'ops_events') opsEvents.push(p);
44
+ return Promise.resolve({ data: null, error: null });
45
+ },
46
+ });
47
+ return { client: { from: (table: string) => builder(table) }, opsEvents };
48
+ }
49
+
50
+ // ---------------------------------------------------------------------------
51
+ // stageForGraceWindow: day-band boundaries.
52
+ // ---------------------------------------------------------------------------
53
+
54
+ Deno.test('stageForGraceWindow: exactly 1 day remaining -> final_notice (inclusive boundary)', () => {
55
+ const now = new Date('2026-09-08T00:00:00.000Z');
56
+ const graceEndsAt = new Date(now.getTime() + ONE_DAY_MS).toISOString();
57
+ assertEquals(stageForGraceWindow(graceEndsAt, now), 'final_notice');
58
+ });
59
+
60
+ Deno.test('stageForGraceWindow: 1 day remaining minus 1ms -> final_notice', () => {
61
+ const now = new Date('2026-09-08T00:00:00.000Z');
62
+ const graceEndsAt = new Date(now.getTime() + ONE_DAY_MS - 1).toISOString();
63
+ assertEquals(stageForGraceWindow(graceEndsAt, now), 'final_notice');
64
+ });
65
+
66
+ Deno.test('stageForGraceWindow: 1 day remaining plus 1ms -> day_3', () => {
67
+ const now = new Date('2026-09-08T00:00:00.000Z');
68
+ const graceEndsAt = new Date(now.getTime() + ONE_DAY_MS + 1).toISOString();
69
+ assertEquals(stageForGraceWindow(graceEndsAt, now), 'day_3');
70
+ });
71
+
72
+ Deno.test('stageForGraceWindow: exactly 2 days remaining -> day_3 (inclusive boundary)', () => {
73
+ const now = new Date('2026-09-08T00:00:00.000Z');
74
+ const graceEndsAt = new Date(now.getTime() + 2 * ONE_DAY_MS).toISOString();
75
+ assertEquals(stageForGraceWindow(graceEndsAt, now), 'day_3');
76
+ });
77
+
78
+ Deno.test('stageForGraceWindow: 2 days remaining plus 1ms -> null (too early)', () => {
79
+ const now = new Date('2026-09-08T00:00:00.000Z');
80
+ const graceEndsAt = new Date(now.getTime() + 2 * ONE_DAY_MS + 1).toISOString();
81
+ assertEquals(stageForGraceWindow(graceEndsAt, now), null);
82
+ });
83
+
84
+ Deno.test('stageForGraceWindow: 5 days remaining (fresh grace_start) -> null', () => {
85
+ const now = new Date('2026-09-08T00:00:00.000Z');
86
+ const graceEndsAt = new Date(now.getTime() + 5 * ONE_DAY_MS).toISOString();
87
+ assertEquals(stageForGraceWindow(graceEndsAt, now), null);
88
+ });
89
+
90
+ Deno.test('stageForGraceWindow: already expired (negative remaining) -> final_notice, fails safe', () => {
91
+ const now = new Date('2026-09-08T00:00:00.000Z');
92
+ const graceEndsAt = new Date(now.getTime() - ONE_DAY_MS).toISOString();
93
+ assertEquals(stageForGraceWindow(graceEndsAt, now), 'final_notice');
94
+ });
95
+
96
+ Deno.test('stageForGraceWindow: unparsable ISO string -> null, fails closed', () => {
97
+ assertEquals(stageForGraceWindow('not-a-date'), null);
98
+ });
99
+
100
+ // ---------------------------------------------------------------------------
101
+ // shouldSendDunningStage: skip-if-already-sent logic.
102
+ // ---------------------------------------------------------------------------
103
+
104
+ Deno.test('shouldSendDunningStage: stage null (too early) -> never send', () => {
105
+ assertEquals(shouldSendDunningStage(null, null), false);
106
+ assertEquals(shouldSendDunningStage(null, { day_3: true }), false);
107
+ });
108
+
109
+ Deno.test('shouldSendDunningStage: dunning_emails_sent null/undefined -> send', () => {
110
+ assertEquals(shouldSendDunningStage('day_3', null), true);
111
+ assertEquals(shouldSendDunningStage('final_notice', undefined), true);
112
+ });
113
+
114
+ Deno.test('shouldSendDunningStage: dunning_emails_sent {} (fresh row default) -> send', () => {
115
+ assertEquals(shouldSendDunningStage('day_3', {}), true);
116
+ });
117
+
118
+ Deno.test('shouldSendDunningStage: this exact stage already true -> skip', () => {
119
+ assertEquals(shouldSendDunningStage('day_3', { day_3: true }), false);
120
+ assertEquals(shouldSendDunningStage('final_notice', { final_notice: true }), false);
121
+ });
122
+
123
+ Deno.test('shouldSendDunningStage: a DIFFERENT stage already true -> still send this one', () => {
124
+ assertEquals(shouldSendDunningStage('final_notice', { day_3: true }), true);
125
+ assertEquals(shouldSendDunningStage('day_3', { grace_start: true }), true);
126
+ });
127
+
128
+ Deno.test('shouldSendDunningStage: stage explicitly false -> send (only true ever blocks)', () => {
129
+ assertEquals(shouldSendDunningStage('day_3', { day_3: false }), true);
130
+ });
131
+
132
+ // ---------------------------------------------------------------------------
133
+ // sendDunningEmail: GHL upsert+send outcomes (fetch fully mocked).
134
+ // ---------------------------------------------------------------------------
135
+
136
+ Deno.test('sendDunningEmail: GHL not configured -> skipped, no network call', async () => {
137
+ await withEnv({ GHL_API_KEY: undefined, GHL_LOCATION_ID: undefined }, async () => {
138
+ const stub = stubClient();
139
+ let fetchCalled = false;
140
+ const original = globalThis.fetch;
141
+ // deno-lint-ignore no-explicit-any
142
+ (globalThis as any).fetch = async () => { fetchCalled = true; return new Response('{}', { status: 200 }); };
143
+ let result: string;
144
+ try {
145
+ result = await sendDunningEmail(stub.client, EMAIL, MEMBERSHIP_ID, 'day_3', new Date().toISOString(), OPERATOR);
146
+ } finally {
147
+ globalThis.fetch = original;
148
+ }
149
+ assertEquals(result, 'skipped');
150
+ assert(!fetchCalled, 'must not call GHL when unconfigured');
151
+ assertEquals(stub.opsEvents.length, 1);
152
+ assertEquals(stub.opsEvents[0].kind, 'dunning_email_skipped');
153
+ });
154
+ });
155
+
156
+ Deno.test('sendDunningEmail: happy path -> sent, correct tags and contactId flow through', async () => {
157
+ await withEnv({ GHL_API_KEY: 'key123', GHL_LOCATION_ID: 'loc123' }, async () => {
158
+ const stub = stubClient();
159
+ const calls: Array<{ url: string; body: Record<string, unknown> }> = [];
160
+ const original = globalThis.fetch;
161
+ // deno-lint-ignore no-explicit-any
162
+ (globalThis as any).fetch = async (input: string | URL | Request, init?: RequestInit) => {
163
+ const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
164
+ const body = init?.body ? JSON.parse(init.body as string) : {};
165
+ calls.push({ url, body });
166
+ if (url.endsWith('/contacts/upsert')) {
167
+ return new Response(JSON.stringify({ contact: { id: 'contact-1' } }), { status: 200 });
168
+ }
169
+ return new Response(JSON.stringify({ ok: true }), { status: 200 });
170
+ };
171
+ let result: string;
172
+ try {
173
+ result = await sendDunningEmail(stub.client, EMAIL, MEMBERSHIP_ID, 'final_notice', '2026-09-10T00:00:00.000Z', OPERATOR);
174
+ } finally {
175
+ globalThis.fetch = original;
176
+ }
177
+ assertEquals(result, 'sent');
178
+ assertEquals(calls.length, 2);
179
+ assertEquals(calls[0].url, 'https://services.leadconnectorhq.com/contacts/upsert');
180
+ assert((calls[0].body.tags as string[]).includes('dunning:final_notice'));
181
+ assertEquals(calls[1].url, 'https://services.leadconnectorhq.com/conversations/messages');
182
+ assertEquals(calls[1].body.contactId, 'contact-1');
183
+ assert((calls[1].body.subject as string).toLowerCase().includes('final notice'));
184
+ assertEquals(stub.opsEvents.length, 1);
185
+ assertEquals(stub.opsEvents[0].kind, 'dunning_email_sent');
186
+ });
187
+ });
188
+
189
+ Deno.test('sendDunningEmail: GHL upsert 500 -> failed_retryable', async () => {
190
+ await withEnv({ GHL_API_KEY: 'key123', GHL_LOCATION_ID: 'loc123' }, async () => {
191
+ const stub = stubClient();
192
+ const original = globalThis.fetch;
193
+ // deno-lint-ignore no-explicit-any
194
+ (globalThis as any).fetch = async () => new Response('server error', { status: 500 });
195
+ let result: string;
196
+ try {
197
+ result = await sendDunningEmail(stub.client, EMAIL, MEMBERSHIP_ID, 'day_3', new Date().toISOString(), OPERATOR);
198
+ } finally {
199
+ globalThis.fetch = original;
200
+ }
201
+ assertEquals(result, 'failed_retryable');
202
+ assertEquals(stub.opsEvents[0].kind, 'dunning_email_failed');
203
+ assertEquals(stub.opsEvents[0].severity, 'warning');
204
+ });
205
+ });
206
+
207
+ Deno.test('sendDunningEmail: GHL upsert 400 -> failed_permanent', async () => {
208
+ await withEnv({ GHL_API_KEY: 'key123', GHL_LOCATION_ID: 'loc123' }, async () => {
209
+ const stub = stubClient();
210
+ const original = globalThis.fetch;
211
+ // deno-lint-ignore no-explicit-any
212
+ (globalThis as any).fetch = async () => new Response('bad request', { status: 400 });
213
+ let result: string;
214
+ try {
215
+ result = await sendDunningEmail(stub.client, EMAIL, MEMBERSHIP_ID, 'day_3', new Date().toISOString(), OPERATOR);
216
+ } finally {
217
+ globalThis.fetch = original;
218
+ }
219
+ assertEquals(result, 'failed_permanent');
220
+ assertEquals(stub.opsEvents[0].kind, 'dunning_email_failed');
221
+ assertEquals(stub.opsEvents[0].severity, 'error');
222
+ });
223
+ });
224
+
225
+ Deno.test('sendDunningEmail: upsert ok but conversations/messages send 429 -> failed_retryable', async () => {
226
+ await withEnv({ GHL_API_KEY: 'key123', GHL_LOCATION_ID: 'loc123' }, async () => {
227
+ const stub = stubClient();
228
+ const original = globalThis.fetch;
229
+ // deno-lint-ignore no-explicit-any
230
+ (globalThis as any).fetch = async (input: string | URL | Request) => {
231
+ const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
232
+ if (url.endsWith('/contacts/upsert')) {
233
+ return new Response(JSON.stringify({ contact: { id: 'contact-1' } }), { status: 200 });
234
+ }
235
+ return new Response('rate limited', { status: 429 });
236
+ };
237
+ let result: string;
238
+ try {
239
+ result = await sendDunningEmail(stub.client, EMAIL, MEMBERSHIP_ID, 'grace_start', new Date().toISOString(), OPERATOR);
240
+ } finally {
241
+ globalThis.fetch = original;
242
+ }
243
+ assertEquals(result, 'failed_retryable');
244
+ });
245
+ });
246
+
247
+ Deno.test('sendDunningEmail: empty email -> skipped, no network call', async () => {
248
+ await withEnv({ GHL_API_KEY: 'key123', GHL_LOCATION_ID: 'loc123' }, async () => {
249
+ const stub = stubClient();
250
+ let fetchCalled = false;
251
+ const original = globalThis.fetch;
252
+ // deno-lint-ignore no-explicit-any
253
+ (globalThis as any).fetch = async () => { fetchCalled = true; return new Response('{}', { status: 200 }); };
254
+ let result: string;
255
+ try {
256
+ result = await sendDunningEmail(stub.client, '', MEMBERSHIP_ID, 'day_3', new Date().toISOString(), OPERATOR);
257
+ } finally {
258
+ globalThis.fetch = original;
259
+ }
260
+ assertEquals(result, 'skipped');
261
+ assert(!fetchCalled);
262
+ });
263
+ });