@simplelayer/graniteer-core 0.2.1 → 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 -334
  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 -217
  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,143 +1,143 @@
1
- /**
2
- * Shared GHL "event inquiry" lead-creation logic. Extracted verbatim from
3
- * ghl-event-inquiry/index.ts so other callers (e.g. create-booking's Commons
4
- * A/V request checkbox) can create the same contact + note + task +
5
- * Events-pipeline opportunity without duplicating the GHL mechanics.
6
- *
7
- * Same endpoints, same payload shapes, same error handling as the original:
8
- * never throws — logs and resolves `{ ok: false }` on any upstream failure.
9
- */
10
- import { postContactNote } from "./ghlNote.ts";
11
- import { createLeadTask } from "./ghlTask.ts";
12
-
13
- const EVENTS_PIPELINE_ID = "H5lJnhYh5lnUFVwSERZz"; // Events pipeline (stages: New Inquiry → Tour/Consult → Proposal Sent → Tentative Hold → Confirmed → Event Delivered → Closed Lost)
14
-
15
- async function resolveStageId(apiKey: string, locationId: string, pipelineId: string, stageName: string): Promise<string | null> {
16
- try {
17
- const r = await fetch(`https://services.leadconnectorhq.com/opportunities/pipelines?locationId=${locationId}`, {
18
- headers: { Authorization: `Bearer ${apiKey}`, Version: "2021-07-28" },
19
- });
20
- if (!r.ok) return null;
21
- const d = await r.json();
22
- const pipe = (d.pipelines || []).find((p: { id: string }) => p.id === pipelineId);
23
- if (!pipe || !Array.isArray(pipe.stages) || pipe.stages.length === 0) return null;
24
- const target = pipe.stages.find((s: { name?: string }) => (s.name || "").toLowerCase() === stageName.toLowerCase());
25
- if (!target) {
26
- console.error(
27
- `[ghlEventInquiry] resolveStageId fallback: requested "${stageName}" not found in pipeline ${pipelineId}. Available stages:`,
28
- pipe.stages.map((s: { name?: string }) => s.name),
29
- );
30
- }
31
- return (target || pipe.stages[0]).id;
32
- } catch { return null; }
33
- }
34
-
35
- export interface EventInquiryInput {
36
- name: string;
37
- email: string;
38
- phone?: string;
39
- eventType?: string;
40
- guestCount?: string;
41
- preferredDate?: string;
42
- message?: string;
43
- source: string;
44
- tags?: string[];
45
- }
46
-
47
- export async function createEventInquiryLead(
48
- apiKey: string,
49
- locationId: string,
50
- input: EventInquiryInput,
51
- domain: string,
52
- ): Promise<{ ok: boolean; contactId?: string; opportunityId?: string }> {
53
- const { name, email, phone, eventType, guestCount, preferredDate, message, source, tags } = input;
54
- const guests = guestCount || "";
55
- const when = preferredDate || "";
56
- const parts = name.trim().split(/\s+/);
57
- const firstName = parts[0];
58
- const lastName = parts.slice(1).join(" ");
59
-
60
- try {
61
- const customFields = [
62
- { id: "Dbj2YTe589jqRFMGTICE", value: "Events" },
63
- { id: "ucdEmnp7udomDgDKXmmV", value: "Inbound / Website" },
64
- ...(message ? [{ id: "o3s2JwsXWUpp3AJmurUC", value: message }] : []),
65
- ...(eventType ? [{ id: "wXU3ZYMRXc1bl2y7mjnp", value: eventType }] : []),
66
- ...(guests ? [{ id: "q4iTC07kYQ7HSdQONizS", value: guests }] : []),
67
- ...(when ? [{ id: "QyJtCvyJakeEceTYIpXN", value: when }] : []),
68
- ];
69
- const resp = await fetch("https://services.leadconnectorhq.com/contacts/", {
70
- method: "POST",
71
- headers: { Authorization: `Bearer ${apiKey}`, Version: "2021-07-28", "Content-Type": "application/json" },
72
- body: JSON.stringify({
73
- locationId,
74
- firstName,
75
- lastName,
76
- email,
77
- phone: phone || "",
78
- tags: tags ?? ["Event Inquiry", domain],
79
- source,
80
- customFields,
81
- }),
82
- });
83
- if (!resp.ok) {
84
- console.error("[ghlEventInquiry] contact create failed", resp.status, await resp.text().catch(() => ""));
85
- return { ok: false };
86
- }
87
- const data = await resp.json();
88
- const contactId = data.contact?.id;
89
- console.log("[ghlEventInquiry] Contact:", contactId, eventType, guests, when);
90
-
91
- if (contactId) {
92
- await postContactNote(
93
- apiKey,
94
- contactId,
95
- `Event inquiry (${domain})\n\nName: ${name}\nEmail: ${email}\nPhone: ${phone || "—"}\nEvent type: ${eventType || "—"}\nGuest count: ${guests || "—"}\nPreferred date: ${when || "—"}\n\nDetails:\n${message || "(none provided)"}`,
96
- );
97
- await createLeadTask(
98
- apiKey,
99
- contactId,
100
- `New event inquiry – ${name}`,
101
- `Name: ${name}\nEmail: ${email}\nPhone: ${phone || "—"}\nEvent type: ${eventType || "—"}\nGuest count: ${guests || "—"}\nPreferred date: ${when || "—"}\nMessage: ${message || "—"}\n\nFull submission is in the contact notes.`,
102
- );
103
- }
104
-
105
- let opportunityId: string | undefined;
106
- if (EVENTS_PIPELINE_ID) {
107
- try {
108
- const stageId = await resolveStageId(apiKey, locationId, EVENTS_PIPELINE_ID, "New Inquiry");
109
- if (contactId && stageId) {
110
- const oppResp = await fetch("https://services.leadconnectorhq.com/opportunities/", {
111
- method: "POST",
112
- headers: { Authorization: `Bearer ${apiKey}`, Version: "2021-07-28", "Content-Type": "application/json" },
113
- body: JSON.stringify({
114
- pipelineId: EVENTS_PIPELINE_ID,
115
- locationId,
116
- name: `Event Inquiry – ${name}`,
117
- pipelineStageId: stageId,
118
- status: "open",
119
- contactId,
120
- source,
121
- }),
122
- });
123
- if (oppResp.ok) {
124
- const o = await oppResp.json();
125
- opportunityId = o.opportunity?.id;
126
- console.log("[ghlEventInquiry] Opp:", opportunityId);
127
- } else {
128
- console.error("[ghlEventInquiry] Opp create failed", oppResp.status, await oppResp.text());
129
- }
130
- } else {
131
- console.error("[ghlEventInquiry] Missing contactId or stageId; skipping opp");
132
- }
133
- } catch (oppErr) {
134
- console.error("[ghlEventInquiry] Opp step error", oppErr);
135
- }
136
- }
137
-
138
- return { ok: true, contactId, opportunityId };
139
- } catch (err) {
140
- console.error("[ghlEventInquiry] error", err);
141
- return { ok: false };
142
- }
143
- }
1
+ /**
2
+ * Shared GHL "event inquiry" lead-creation logic. Extracted verbatim from
3
+ * ghl-event-inquiry/index.ts so other callers (e.g. create-booking's Commons
4
+ * A/V request checkbox) can create the same contact + note + task +
5
+ * Events-pipeline opportunity without duplicating the GHL mechanics.
6
+ *
7
+ * Same endpoints, same payload shapes, same error handling as the original:
8
+ * never throws — logs and resolves `{ ok: false }` on any upstream failure.
9
+ */
10
+ import { postContactNote } from "./ghlNote.ts";
11
+ import { createLeadTask } from "./ghlTask.ts";
12
+
13
+ const EVENTS_PIPELINE_ID = "H5lJnhYh5lnUFVwSERZz"; // Events pipeline (stages: New Inquiry → Tour/Consult → Proposal Sent → Tentative Hold → Confirmed → Event Delivered → Closed Lost)
14
+
15
+ async function resolveStageId(apiKey: string, locationId: string, pipelineId: string, stageName: string): Promise<string | null> {
16
+ try {
17
+ const r = await fetch(`https://services.leadconnectorhq.com/opportunities/pipelines?locationId=${locationId}`, {
18
+ headers: { Authorization: `Bearer ${apiKey}`, Version: "2021-07-28" },
19
+ });
20
+ if (!r.ok) return null;
21
+ const d = await r.json();
22
+ const pipe = (d.pipelines || []).find((p: { id: string }) => p.id === pipelineId);
23
+ if (!pipe || !Array.isArray(pipe.stages) || pipe.stages.length === 0) return null;
24
+ const target = pipe.stages.find((s: { name?: string }) => (s.name || "").toLowerCase() === stageName.toLowerCase());
25
+ if (!target) {
26
+ console.error(
27
+ `[ghlEventInquiry] resolveStageId fallback: requested "${stageName}" not found in pipeline ${pipelineId}. Available stages:`,
28
+ pipe.stages.map((s: { name?: string }) => s.name),
29
+ );
30
+ }
31
+ return (target || pipe.stages[0]).id;
32
+ } catch { return null; }
33
+ }
34
+
35
+ export interface EventInquiryInput {
36
+ name: string;
37
+ email: string;
38
+ phone?: string;
39
+ eventType?: string;
40
+ guestCount?: string;
41
+ preferredDate?: string;
42
+ message?: string;
43
+ source: string;
44
+ tags?: string[];
45
+ }
46
+
47
+ export async function createEventInquiryLead(
48
+ apiKey: string,
49
+ locationId: string,
50
+ input: EventInquiryInput,
51
+ domain: string,
52
+ ): Promise<{ ok: boolean; contactId?: string; opportunityId?: string }> {
53
+ const { name, email, phone, eventType, guestCount, preferredDate, message, source, tags } = input;
54
+ const guests = guestCount || "";
55
+ const when = preferredDate || "";
56
+ const parts = name.trim().split(/\s+/);
57
+ const firstName = parts[0];
58
+ const lastName = parts.slice(1).join(" ");
59
+
60
+ try {
61
+ const customFields = [
62
+ { id: "Dbj2YTe589jqRFMGTICE", value: "Events" },
63
+ { id: "ucdEmnp7udomDgDKXmmV", value: "Inbound / Website" },
64
+ ...(message ? [{ id: "o3s2JwsXWUpp3AJmurUC", value: message }] : []),
65
+ ...(eventType ? [{ id: "wXU3ZYMRXc1bl2y7mjnp", value: eventType }] : []),
66
+ ...(guests ? [{ id: "q4iTC07kYQ7HSdQONizS", value: guests }] : []),
67
+ ...(when ? [{ id: "QyJtCvyJakeEceTYIpXN", value: when }] : []),
68
+ ];
69
+ const resp = await fetch("https://services.leadconnectorhq.com/contacts/", {
70
+ method: "POST",
71
+ headers: { Authorization: `Bearer ${apiKey}`, Version: "2021-07-28", "Content-Type": "application/json" },
72
+ body: JSON.stringify({
73
+ locationId,
74
+ firstName,
75
+ lastName,
76
+ email,
77
+ phone: phone || "",
78
+ tags: tags ?? ["Event Inquiry", domain],
79
+ source,
80
+ customFields,
81
+ }),
82
+ });
83
+ if (!resp.ok) {
84
+ console.error("[ghlEventInquiry] contact create failed", resp.status, await resp.text().catch(() => ""));
85
+ return { ok: false };
86
+ }
87
+ const data = await resp.json();
88
+ const contactId = data.contact?.id;
89
+ console.log("[ghlEventInquiry] Contact:", contactId, eventType, guests, when);
90
+
91
+ if (contactId) {
92
+ await postContactNote(
93
+ apiKey,
94
+ contactId,
95
+ `Event inquiry (${domain})\n\nName: ${name}\nEmail: ${email}\nPhone: ${phone || "—"}\nEvent type: ${eventType || "—"}\nGuest count: ${guests || "—"}\nPreferred date: ${when || "—"}\n\nDetails:\n${message || "(none provided)"}`,
96
+ );
97
+ await createLeadTask(
98
+ apiKey,
99
+ contactId,
100
+ `New event inquiry – ${name}`,
101
+ `Name: ${name}\nEmail: ${email}\nPhone: ${phone || "—"}\nEvent type: ${eventType || "—"}\nGuest count: ${guests || "—"}\nPreferred date: ${when || "—"}\nMessage: ${message || "—"}\n\nFull submission is in the contact notes.`,
102
+ );
103
+ }
104
+
105
+ let opportunityId: string | undefined;
106
+ if (EVENTS_PIPELINE_ID) {
107
+ try {
108
+ const stageId = await resolveStageId(apiKey, locationId, EVENTS_PIPELINE_ID, "New Inquiry");
109
+ if (contactId && stageId) {
110
+ const oppResp = await fetch("https://services.leadconnectorhq.com/opportunities/", {
111
+ method: "POST",
112
+ headers: { Authorization: `Bearer ${apiKey}`, Version: "2021-07-28", "Content-Type": "application/json" },
113
+ body: JSON.stringify({
114
+ pipelineId: EVENTS_PIPELINE_ID,
115
+ locationId,
116
+ name: `Event Inquiry – ${name}`,
117
+ pipelineStageId: stageId,
118
+ status: "open",
119
+ contactId,
120
+ source,
121
+ }),
122
+ });
123
+ if (oppResp.ok) {
124
+ const o = await oppResp.json();
125
+ opportunityId = o.opportunity?.id;
126
+ console.log("[ghlEventInquiry] Opp:", opportunityId);
127
+ } else {
128
+ console.error("[ghlEventInquiry] Opp create failed", oppResp.status, await oppResp.text());
129
+ }
130
+ } else {
131
+ console.error("[ghlEventInquiry] Missing contactId or stageId; skipping opp");
132
+ }
133
+ } catch (oppErr) {
134
+ console.error("[ghlEventInquiry] Opp step error", oppErr);
135
+ }
136
+ }
137
+
138
+ return { ok: true, contactId, opportunityId };
139
+ } catch (err) {
140
+ console.error("[ghlEventInquiry] error", err);
141
+ return { ok: false };
142
+ }
143
+ }
@@ -1,121 +1,121 @@
1
- // Mail-arrival notification for the virtual mailbox (hold-for-pickup).
2
- //
3
- // Follows dunningEmails.ts's exact GHL upsert+send pattern; esc() and
4
- // classifyError() are reused verbatim (byte-identical) from that file.
5
- //
6
- // SCOPE GUARDRAIL: this email is a plain "you have mail waiting" notice. It
7
- // never contains, describes, scans, photographs or attaches mail contents.
8
- // The only item detail that may ever appear is the short free-text
9
- // description a staff member optionally typed when logging the item.
10
-
11
- import type { SupabaseClient } from 'npm:@supabase/supabase-js@2';
12
- import { logOps } from './ops.ts';
13
-
14
- type SupabaseLike = SupabaseClient<any, 'public', any>;
15
-
16
- export type MailArrivalResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
17
-
18
- /** Escape untrusted values interpolated into outbound HTML. Identical to dunningEmails.ts's esc(). */
19
- function esc(v: unknown): string {
20
- return String(v ?? '')
21
- .replace(/&/g, '&amp;')
22
- .replace(/</g, '&lt;')
23
- .replace(/>/g, '&gt;')
24
- .replace(/"/g, '&quot;')
25
- .replace(/'/g, '&#39;');
26
- }
27
-
28
- /** Classify a caught error as transient or hopeless. Identical to dunningEmails.ts's classifyError(). */
29
- function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
30
- const name = e instanceof Error ? e.name : '';
31
- if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
32
- const msg = e instanceof Error ? e.message : String(e);
33
- const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
34
- if (m) {
35
- const code = Number(m[1]);
36
- if (code === 429 || code >= 500) return 'failed_retryable';
37
- }
38
- return 'failed_permanent';
39
- }
40
-
41
- /**
42
- * Notify one member that an item is waiting at the front desk. Never throws:
43
- * every failure is caught, logged via logOps and classified, so a mail item
44
- * is still recorded even when the notification can't go out.
45
- */
46
- export async function sendMailArrivalEmail(
47
- supabase: SupabaseLike,
48
- email: string,
49
- mailItemId: string,
50
- description: string | null,
51
- operator: { name: string; shortName: string; domain: string; supportEmail: string },
52
- ): Promise<MailArrivalResult> {
53
- try {
54
- if (!email) return 'skipped';
55
-
56
- const apiKey = Deno.env.get('GHL_API_KEY');
57
- const locationId = Deno.env.get('GHL_LOCATION_ID');
58
- if (!apiKey || !locationId) {
59
- await logOps(supabase, 'mail_arrival_email_skipped',
60
- { email, mail_item_id: mailItemId, reason: 'ghl_not_configured' },
61
- { severity: 'warning' }).catch(() => {});
62
- return 'skipped';
63
- }
64
-
65
- const GHL_BASE = 'https://services.leadconnectorhq.com';
66
- const headers = {
67
- Authorization: `Bearer ${apiKey}`,
68
- Version: '2021-07-28',
69
- 'Content-Type': 'application/json',
70
- Accept: 'application/json',
71
- };
72
-
73
- const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
74
- method: 'POST', headers,
75
- signal: AbortSignal.timeout(8000),
76
- body: JSON.stringify({
77
- locationId, email,
78
- source: `${operator.shortName} Website — Mailroom`,
79
- tags: ['Mailroom', 'mail:arrived', operator.domain],
80
- }),
81
- });
82
- if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
83
- const upJson = await upRes.json();
84
- const contactId = upJson.contact?.id || upJson.id || null;
85
- if (!contactId) throw new Error('ghl_upsert_no_contact_id');
86
-
87
- const p = (t: string) =>
88
- `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
89
-
90
- const subject = `You have mail waiting for pickup at ${operator.name}`;
91
- const trimmed = (description ?? '').trim();
92
- const detailLine = trimmed
93
- ? p(`Staff noted: <strong>${esc(trimmed)}</strong>`)
94
- : '';
95
-
96
- 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">
97
- <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">${esc(subject)}</h2>
98
- ${p(`An item arrived for you and is being held at the front desk. Stop by during staffed hours to pick it up.`)}
99
- ${detailLine}
100
- ${p(`Questions? Just reply to this email — it reaches a real person here. You can also write to <a href="mailto:${operator.supportEmail}" style="color:#C98A5E">${operator.supportEmail}</a>.`)}
101
- <p style="margin:24px 0 0 0;color:#748272;font-family:Inter,Arial,sans-serif;font-size:13px;line-height:20px">${operator.name}</p>
102
- </td></tr></table></td></tr></table></div>`;
103
-
104
- const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
105
- method: 'POST', headers,
106
- signal: AbortSignal.timeout(8000),
107
- body: JSON.stringify({ type: 'Email', contactId, subject, html }),
108
- });
109
- if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
110
-
111
- await logOps(supabase, 'mail_arrival_email_sent',
112
- { email, mail_item_id: mailItemId }, { severity: 'info' }).catch(() => {});
113
- return 'sent';
114
- } catch (e) {
115
- const classification = classifyError(e);
116
- await logOps(supabase, 'mail_arrival_email_failed',
117
- { email, mail_item_id: mailItemId, message: e instanceof Error ? e.message : String(e) },
118
- { severity: classification === 'failed_permanent' ? 'error' : 'warning' }).catch(() => {});
119
- return classification;
120
- }
121
- }
1
+ // Mail-arrival notification for the virtual mailbox (hold-for-pickup).
2
+ //
3
+ // Follows dunningEmails.ts's exact GHL upsert+send pattern; esc() and
4
+ // classifyError() are reused verbatim (byte-identical) from that file.
5
+ //
6
+ // SCOPE GUARDRAIL: this email is a plain "you have mail waiting" notice. It
7
+ // never contains, describes, scans, photographs or attaches mail contents.
8
+ // The only item detail that may ever appear is the short free-text
9
+ // description a staff member optionally typed when logging the item.
10
+
11
+ import type { SupabaseClient } from 'npm:@supabase/supabase-js@2';
12
+ import { logOps } from './ops.ts';
13
+
14
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
15
+
16
+ export type MailArrivalResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
17
+
18
+ /** Escape untrusted values interpolated into outbound HTML. Identical to dunningEmails.ts's esc(). */
19
+ function esc(v: unknown): string {
20
+ return String(v ?? '')
21
+ .replace(/&/g, '&amp;')
22
+ .replace(/</g, '&lt;')
23
+ .replace(/>/g, '&gt;')
24
+ .replace(/"/g, '&quot;')
25
+ .replace(/'/g, '&#39;');
26
+ }
27
+
28
+ /** Classify a caught error as transient or hopeless. Identical to dunningEmails.ts's classifyError(). */
29
+ function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
30
+ const name = e instanceof Error ? e.name : '';
31
+ if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
32
+ const msg = e instanceof Error ? e.message : String(e);
33
+ const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
34
+ if (m) {
35
+ const code = Number(m[1]);
36
+ if (code === 429 || code >= 500) return 'failed_retryable';
37
+ }
38
+ return 'failed_permanent';
39
+ }
40
+
41
+ /**
42
+ * Notify one member that an item is waiting at the front desk. Never throws:
43
+ * every failure is caught, logged via logOps and classified, so a mail item
44
+ * is still recorded even when the notification can't go out.
45
+ */
46
+ export async function sendMailArrivalEmail(
47
+ supabase: SupabaseLike,
48
+ email: string,
49
+ mailItemId: string,
50
+ description: string | null,
51
+ operator: { name: string; shortName: string; domain: string; supportEmail: string },
52
+ ): Promise<MailArrivalResult> {
53
+ try {
54
+ if (!email) return 'skipped';
55
+
56
+ const apiKey = Deno.env.get('GHL_API_KEY');
57
+ const locationId = Deno.env.get('GHL_LOCATION_ID');
58
+ if (!apiKey || !locationId) {
59
+ await logOps(supabase, 'mail_arrival_email_skipped',
60
+ { email, mail_item_id: mailItemId, reason: 'ghl_not_configured' },
61
+ { severity: 'warning' }).catch(() => {});
62
+ return 'skipped';
63
+ }
64
+
65
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
66
+ const headers = {
67
+ Authorization: `Bearer ${apiKey}`,
68
+ Version: '2021-07-28',
69
+ 'Content-Type': 'application/json',
70
+ Accept: 'application/json',
71
+ };
72
+
73
+ const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
74
+ method: 'POST', headers,
75
+ signal: AbortSignal.timeout(8000),
76
+ body: JSON.stringify({
77
+ locationId, email,
78
+ source: `${operator.shortName} Website — Mailroom`,
79
+ tags: ['Mailroom', 'mail:arrived', operator.domain],
80
+ }),
81
+ });
82
+ if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
83
+ const upJson = await upRes.json();
84
+ const contactId = upJson.contact?.id || upJson.id || null;
85
+ if (!contactId) throw new Error('ghl_upsert_no_contact_id');
86
+
87
+ const p = (t: string) =>
88
+ `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
89
+
90
+ const subject = `You have mail waiting for pickup at ${operator.name}`;
91
+ const trimmed = (description ?? '').trim();
92
+ const detailLine = trimmed
93
+ ? p(`Staff noted: <strong>${esc(trimmed)}</strong>`)
94
+ : '';
95
+
96
+ 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">
97
+ <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">${esc(subject)}</h2>
98
+ ${p(`An item arrived for you and is being held at the front desk. Stop by during staffed hours to pick it up.`)}
99
+ ${detailLine}
100
+ ${p(`Questions? Just reply to this email — it reaches a real person here. You can also write to <a href="mailto:${operator.supportEmail}" style="color:#C98A5E">${operator.supportEmail}</a>.`)}
101
+ <p style="margin:24px 0 0 0;color:#748272;font-family:Inter,Arial,sans-serif;font-size:13px;line-height:20px">${operator.name}</p>
102
+ </td></tr></table></td></tr></table></div>`;
103
+
104
+ const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
105
+ method: 'POST', headers,
106
+ signal: AbortSignal.timeout(8000),
107
+ body: JSON.stringify({ type: 'Email', contactId, subject, html }),
108
+ });
109
+ if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
110
+
111
+ await logOps(supabase, 'mail_arrival_email_sent',
112
+ { email, mail_item_id: mailItemId }, { severity: 'info' }).catch(() => {});
113
+ return 'sent';
114
+ } catch (e) {
115
+ const classification = classifyError(e);
116
+ await logOps(supabase, 'mail_arrival_email_failed',
117
+ { email, mail_item_id: mailItemId, message: e instanceof Error ? e.message : String(e) },
118
+ { severity: classification === 'failed_permanent' ? 'error' : 'warning' }).catch(() => {});
119
+ return classification;
120
+ }
121
+ }