@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,429 @@
1
+ // Flat-body function for the external voice-AI system to book a real tour
2
+ // appointment on one of the operator's configured GHL calendars.
3
+ //
4
+ // Unlike `voice-booking` (which forwards into `create-booking` for internal
5
+ // room bookings), this function owns the GHL integration directly: it checks
6
+ // the requested slot is actually free via GHL's free-slots endpoint, then
7
+ // upserts the contact, tags it, creates the appointment, and texts a
8
+ // confirmation. There is no separate availability-check tool for tours (the
9
+ // way `check_room_availability` exists for rooms), so the free-slots check
10
+ // lives inline here instead.
11
+ import { corsHeaders } from 'npm:@supabase/supabase-js@2/cors';
12
+ import { createClient } from 'npm:@supabase/supabase-js@2';
13
+ import { z } from 'npm:zod@3.23.8';
14
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
15
+ import { laWallToUtc } from 'npm:@simplelayer/graniteer-core/availability';
16
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
17
+ import { verifyRetellSignature } from 'npm:@simplelayer/graniteer-core/retellSignature';
18
+
19
+ const Body = z.object({
20
+ // Not a zod enum: the set of valid tour types is operator-configured (see
21
+ // VoiceTourBookingConfig.calendars below), so membership is checked at
22
+ // runtime against the caller's config instead of being baked into the
23
+ // schema.
24
+ tour_type: z.string().min(1).max(80),
25
+ date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
26
+ start_time: z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/),
27
+ contact_name: z.string().min(1).max(200),
28
+ contact_email: z.string().email(),
29
+ contact_phone: z.string().max(40).optional(),
30
+ // Optional replay guard for the voice agent: a dropped call can make it
31
+ // resend the same request. Omitting it behaves exactly as before.
32
+ idempotency_key: z.string().min(1).max(200).optional(),
33
+ });
34
+
35
+ // How long a stored response is replayed. Older rows are treated as a miss
36
+ // and simply overwritten by the next write (most recent write wins, no GC
37
+ // job). Mirrors voice-booking's own idempotency design.
38
+ const IDEMPOTENCY_TTL_MS = 10 * 60 * 1000;
39
+
40
+ const json = (status: number, body: unknown) =>
41
+ new Response(JSON.stringify(body), {
42
+ status,
43
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
44
+ });
45
+
46
+ // Business-logic failures always return HTTP 200 so the caller reliably gets
47
+ // JSON back; only a malformed request body is a non-200.
48
+ const GENERIC_ERROR = "Sorry — I wasn't able to book that tour just now.";
49
+
50
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
51
+ const GHL_VERSION = '2021-07-28';
52
+ const GHL_LOCATION_ID = 'BDI8NHA4nkHnQGJ8g3hV';
53
+ // Cloudflare in front of the LeadConnector host blocks default fetch UAs.
54
+ const BROWSER_UA =
55
+ 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/124.0 Safari/537.36';
56
+
57
+ /** One operator-configured tour calendar. `key` matches the caller's `tour_type`. */
58
+ export type TourCalendarConfig = {
59
+ key: string;
60
+ calendarId: string;
61
+ /** Spoken/logged label, e.g. "Workspace Tour w/Megan". */
62
+ label: string;
63
+ };
64
+
65
+ /** Tenant-owned inputs to this function. */
66
+ export type VoiceTourBookingConfig = {
67
+ /**
68
+ * The operator's bookable tour calendars. Deliberately a list, not a fixed
69
+ * pair — an operator with one calendar, or five, needs no code change here,
70
+ * only a longer/shorter config array.
71
+ */
72
+ calendars: readonly TourCalendarConfig[];
73
+ /** Spoken/texted business name, e.g. "Granite City Workspaces". */
74
+ businessName: string;
75
+ /** Spoken/texted support phone number, e.g. "(916) 836-0808". */
76
+ supportPhoneDisplay: string;
77
+ };
78
+
79
+ function findCalendar(config: VoiceTourBookingConfig, tourType: string): TourCalendarConfig | undefined {
80
+ return config.calendars.find((c) => c.key === tourType);
81
+ }
82
+
83
+ function ghlHeaders(apiKey: string): HeadersInit {
84
+ return {
85
+ Authorization: `Bearer ${apiKey}`,
86
+ Version: GHL_VERSION,
87
+ 'Content-Type': 'application/json',
88
+ Accept: 'application/json',
89
+ 'User-Agent': BROWSER_UA,
90
+ };
91
+ }
92
+
93
+ // Calendar-day arithmetic only (never a fixed +24h — that breaks across a DST
94
+ // transition); the LA-timezone instant itself is resolved via laWallToUtc.
95
+ function nextDateStr(dateStr: string): string {
96
+ const [y, mo, d] = dateStr.split('-').map(Number);
97
+ return new Date(Date.UTC(y, mo - 1, d + 1)).toISOString().slice(0, 10);
98
+ }
99
+
100
+ /**
101
+ * Whether GHL's free-slots endpoint reports `target` as bookable on
102
+ * `calendarId`. Response shape assumed here — a date-keyed object of
103
+ * `{ slots: string[] }` (plus a `traceId` key) — is GHL's documented v2
104
+ * shape; it could NOT be verified against the live API from this repo (no
105
+ * local GHL credentials — they only exist as Supabase edge function
106
+ * secrets), see the discrepancy note in the PR report. Any unexpected shape
107
+ * is treated as "not free" rather than thrown, so a parsing surprise fails
108
+ * toward the safer "please pick another time" outcome.
109
+ */
110
+ async function isSlotFree(
111
+ apiKey: string,
112
+ calendarId: string,
113
+ date: string,
114
+ target: Date,
115
+ ): Promise<boolean> {
116
+ const startMs = laWallToUtc(date, 0, 0).getTime();
117
+ const endMs = laWallToUtc(nextDateStr(date), 0, 0).getTime();
118
+ const url =
119
+ `${GHL_BASE}/calendars/${calendarId}/free-slots?startDate=${startMs}&endDate=${endMs}&timezone=America%2FLos_Angeles`;
120
+ const res = await fetch(url, { headers: ghlHeaders(apiKey) });
121
+ if (!res.ok) {
122
+ throw new Error(`free-slots ${res.status}: ${await res.text().catch(() => '')}`);
123
+ }
124
+ const data = (await res.json().catch(() => null)) as Record<string, unknown> | null;
125
+ if (!data || typeof data !== 'object') return false;
126
+
127
+ const targetMs = target.getTime();
128
+ for (const [key, value] of Object.entries(data)) {
129
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(key)) continue; // skips traceId etc.
130
+ const slots = (value as { slots?: unknown } | null)?.slots;
131
+ if (!Array.isArray(slots)) continue;
132
+ for (const slot of slots) {
133
+ if (typeof slot === 'string' && new Date(slot).getTime() === targetMs) return true;
134
+ }
135
+ }
136
+ return false;
137
+ }
138
+
139
+ /**
140
+ * Booking-confirmation SMS via GHL. Never throws, never rejects: a messaging
141
+ * hiccup must never turn a successful booking into a reported failure.
142
+ * Awaited (not fire-and-forget) because the edge isolate can be torn down
143
+ * right after the response, dropping in-flight fetches.
144
+ */
145
+ async function sendTourConfirmationSms(args: {
146
+ apiKey: string;
147
+ contactId: string;
148
+ phone?: string;
149
+ tourLabel: string;
150
+ start: Date;
151
+ config: VoiceTourBookingConfig;
152
+ }): Promise<void> {
153
+ try {
154
+ const phone = (args.phone ?? '').trim();
155
+ if (!phone) return; // nothing to text
156
+
157
+ const when = new Intl.DateTimeFormat('en-US', {
158
+ timeZone: 'America/Los_Angeles',
159
+ weekday: 'long',
160
+ month: 'long',
161
+ day: 'numeric',
162
+ hour: 'numeric',
163
+ minute: '2-digit',
164
+ }).format(args.start);
165
+
166
+ const message =
167
+ `You're all set — your ${args.tourLabel} on ${when} at ${args.config.businessName} is confirmed. ` +
168
+ `Questions? Call us at ${args.config.supportPhoneDisplay}.`;
169
+
170
+ const smsRes = await fetch(`${GHL_BASE}/conversations/messages`, {
171
+ method: 'POST',
172
+ headers: ghlHeaders(args.apiKey),
173
+ body: JSON.stringify({ contactId: args.contactId, type: 'SMS', message }),
174
+ });
175
+ if (!smsRes.ok) {
176
+ console.error(
177
+ '[voice-tour-booking] GHL SMS failed',
178
+ smsRes.status,
179
+ await smsRes.text().catch(() => ''),
180
+ );
181
+ }
182
+ } catch (e) {
183
+ console.error('[voice-tour-booking] GHL SMS error', e);
184
+ }
185
+ }
186
+
187
+ export async function handle(req: Request, config: VoiceTourBookingConfig): Promise<Response> {
188
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
189
+
190
+ // Raw text first: the signature is over the exact bytes sent, so the body
191
+ // can only be JSON.parse-d after verification.
192
+ const rawBody = await req.text().catch(() => '');
193
+ if (!(await verifyRetellSignature(req, rawBody, 'voice-tour-booking'))) {
194
+ return json(401, { ok: false, error: 'unauthorized' });
195
+ }
196
+
197
+ let raw: unknown = {};
198
+ try {
199
+ raw = rawBody ? JSON.parse(rawBody) : {};
200
+ } catch {
201
+ raw = {};
202
+ }
203
+
204
+ const parsed = Body.safeParse(raw);
205
+ if (!parsed.success) return json(400, { ok: false, error: 'invalid_request' });
206
+
207
+ const {
208
+ tour_type, date, start_time,
209
+ contact_name, contact_email, contact_phone, idempotency_key,
210
+ } = parsed.data;
211
+
212
+ const calendar = findCalendar(config, tour_type);
213
+ if (!calendar) return json(400, { ok: false, error: 'invalid_request' });
214
+
215
+ const supabaseUrl = Deno.env.get('SUPABASE_URL')!;
216
+ const serviceKey = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
217
+ const supabase = createClient(supabaseUrl, serviceKey);
218
+
219
+ // Every cached call site returns HTTP 200, so only the JSON body is stored
220
+ // and a replay is always a 200.
221
+ const finish = async (body: unknown): Promise<Response> => {
222
+ if (idempotency_key) {
223
+ const { error } = await supabase
224
+ .from('voice_tour_booking_idempotency')
225
+ .upsert(
226
+ { key: idempotency_key, response: body, created_at: new Date().toISOString() },
227
+ { onConflict: 'key' },
228
+ );
229
+ if (error) console.error('[voice-tour-booking] idempotency write failed', error);
230
+ }
231
+ return json(200, body);
232
+ };
233
+
234
+ // Replay a recent identical request before doing ANY work: no rate-limit
235
+ // consumption, no GHL calls.
236
+ if (idempotency_key) {
237
+ const { data: cached, error: cacheErr } = await supabase
238
+ .from('voice_tour_booking_idempotency')
239
+ .select('response,created_at')
240
+ .eq('key', idempotency_key)
241
+ .maybeSingle();
242
+ // A cache read must never be able to fail a booking — log and fall through.
243
+ if (cacheErr) console.error('[voice-tour-booking] idempotency read failed', cacheErr);
244
+ else if (cached) {
245
+ const age = Date.now() - Date.parse(cached.created_at as string);
246
+ if (Number.isFinite(age) && age >= 0 && age < IDEMPOTENCY_TTL_MS) {
247
+ return json(200, cached.response);
248
+ }
249
+ }
250
+ }
251
+
252
+ try {
253
+ const ip = clientIp(req);
254
+ const ipOk = await checkRateLimit(supabase, 'voice-tour-booking-ip', ip, 10, 600);
255
+ if (!ipOk) {
256
+ // Not cached: rate limiting is transient and must stay retryable.
257
+ return json(200, {
258
+ ok: false,
259
+ error: 'Too many booking attempts — please try again in a few minutes.',
260
+ });
261
+ }
262
+
263
+ const apiKey = Deno.env.get('GC_VOICE_GHL_API_KEY');
264
+ if (!apiKey) {
265
+ await logOps(
266
+ supabase,
267
+ 'voice_tour_booking_failed',
268
+ { tour_type, date, start_time, reason: 'GC_VOICE_GHL_API_KEY not set' },
269
+ { severity: 'warning' },
270
+ );
271
+ return await finish({ ok: false, error: GENERIC_ERROR });
272
+ }
273
+
274
+ // DST-safe: resolve the LA wall-clock start to a UTC instant.
275
+ const [hh, mm] = start_time.split(':').map(Number);
276
+ const start = laWallToUtc(date, hh, mm);
277
+
278
+ let free: boolean;
279
+ try {
280
+ free = await isSlotFree(apiKey, calendar.calendarId, date, start);
281
+ } catch (e) {
282
+ console.error('[voice-tour-booking] free-slots check failed', e);
283
+ await logOps(
284
+ supabase,
285
+ 'voice_tour_booking_failed',
286
+ { tour_type, date, start_time, reason: 'free_slots_check_failed' },
287
+ { severity: 'warning' },
288
+ );
289
+ return await finish({ ok: false, error: GENERIC_ERROR });
290
+ }
291
+
292
+ if (!free) {
293
+ return await finish({
294
+ ok: false,
295
+ error:
296
+ `That time isn't available for the ${calendar.label} — would you like to try a different time or day?`,
297
+ });
298
+ }
299
+
300
+ // 1) Upsert the contact. No `tags` field — upsert REPLACES tags and we
301
+ // must never clobber an existing contact's tags from here.
302
+ const upsertRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
303
+ method: 'POST',
304
+ headers: ghlHeaders(apiKey),
305
+ body: JSON.stringify({
306
+ locationId: GHL_LOCATION_ID,
307
+ name: contact_name,
308
+ email: contact_email,
309
+ ...(contact_phone ? { phone: contact_phone } : {}),
310
+ }),
311
+ });
312
+ if (!upsertRes.ok) {
313
+ console.error(
314
+ '[voice-tour-booking] GHL upsert failed',
315
+ upsertRes.status,
316
+ await upsertRes.text().catch(() => ''),
317
+ );
318
+ await logOps(
319
+ supabase,
320
+ 'voice_tour_booking_failed',
321
+ { tour_type, date, start_time, reason: 'ghl_upsert_failed', status: upsertRes.status },
322
+ { severity: 'warning' },
323
+ );
324
+ return await finish({ ok: false, error: GENERIC_ERROR });
325
+ }
326
+ const upsertJson = (await upsertRes.json().catch(() => null)) as
327
+ | { contact?: { id?: string }; id?: string }
328
+ | null;
329
+ const contactId = upsertJson?.contact?.id ?? upsertJson?.id;
330
+ if (!contactId) {
331
+ console.error('[voice-tour-booking] GHL upsert returned no contact id');
332
+ await logOps(
333
+ supabase,
334
+ 'voice_tour_booking_failed',
335
+ { tour_type, date, start_time, reason: 'ghl_upsert_no_contact_id' },
336
+ { severity: 'warning' },
337
+ );
338
+ return await finish({ ok: false, error: GENERIC_ERROR });
339
+ }
340
+
341
+ // 2) Tag the contact — dedicated endpoint, never via upsert's own `tags`
342
+ // field (see above). Non-fatal: a missing tag must never block the
343
+ // actual booking.
344
+ const tagRes = await fetch(`${GHL_BASE}/contacts/${contactId}/tags`, {
345
+ method: 'POST',
346
+ headers: ghlHeaders(apiKey),
347
+ body: JSON.stringify({ tags: ['voice-tour-inquiry'] }),
348
+ });
349
+ if (!tagRes.ok) {
350
+ console.error(
351
+ '[voice-tour-booking] GHL tag failed',
352
+ tagRes.status,
353
+ await tagRes.text().catch(() => ''),
354
+ );
355
+ }
356
+
357
+ // 3) Create the appointment. `endTime` is deliberately left out so GHL
358
+ // applies the calendar's own configured duration, and
359
+ // `ignoreFreeSlotValidation` is deliberately omitted so GHL still
360
+ // enforces the slot is free server-side too.
361
+ const apptRes = await fetch(`${GHL_BASE}/calendars/events/appointments`, {
362
+ method: 'POST',
363
+ headers: ghlHeaders(apiKey),
364
+ body: JSON.stringify({
365
+ locationId: GHL_LOCATION_ID,
366
+ calendarId: calendar.calendarId,
367
+ contactId,
368
+ startTime: start.toISOString(),
369
+ title: calendar.label,
370
+ appointmentStatus: 'confirmed',
371
+ }),
372
+ });
373
+ const apptJson = (await apptRes.json().catch(() => null)) as
374
+ | { id?: string; appointment?: { id?: string } }
375
+ | null;
376
+ const appointmentId = apptJson?.id ?? apptJson?.appointment?.id;
377
+
378
+ if (!apptRes.ok || !appointmentId) {
379
+ console.error(
380
+ '[voice-tour-booking] GHL create-appointment failed',
381
+ apptRes.status,
382
+ JSON.stringify(apptJson),
383
+ );
384
+ await logOps(
385
+ supabase,
386
+ 'voice_tour_booking_failed',
387
+ {
388
+ tour_type,
389
+ date,
390
+ start_time,
391
+ reason: 'ghl_create_appointment_failed',
392
+ status: apptRes.status,
393
+ body: JSON.stringify(apptJson).slice(0, 500),
394
+ },
395
+ { severity: 'warning' },
396
+ );
397
+ return await finish({ ok: false, error: GENERIC_ERROR });
398
+ }
399
+
400
+ await logOps(
401
+ supabase,
402
+ 'voice_tour_booking_completed',
403
+ { tour_type, date, start_time, appointment_id: appointmentId },
404
+ { severity: 'info' },
405
+ );
406
+
407
+ // 4) Confirmation SMS — best-effort, skipped gracefully when no phone was
408
+ // given.
409
+ await sendTourConfirmationSms({
410
+ apiKey,
411
+ contactId,
412
+ phone: contact_phone,
413
+ tourLabel: calendar.label,
414
+ start,
415
+ config,
416
+ });
417
+
418
+ return await finish({ ok: true, appointment_id: appointmentId });
419
+ } catch (e) {
420
+ console.error('[voice-tour-booking] error', e);
421
+ await logOps(
422
+ supabase,
423
+ 'voice_tour_booking_failed',
424
+ { tour_type, date, start_time, reason: 'unhandled_error' },
425
+ { severity: 'warning' },
426
+ );
427
+ return json(200, { ok: false, error: GENERIC_ERROR });
428
+ }
429
+ }
@@ -0,0 +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
+ }
@@ -0,0 +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
+ }