@simplelayer/graniteer-core 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/index.js +2 -2
  2. package/package.json +1 -1
  3. package/src/agreementCheckout.ts +250 -250
  4. package/src/agreementPortalEmail.ts +128 -128
  5. package/src/billingPortalLinkEmail.ts +117 -117
  6. package/src/bookingAgreementEmail.ts +149 -149
  7. package/src/bookingEffects.ts +388 -388
  8. package/src/busClient.ts +268 -268
  9. package/src/busSignature.ts +71 -71
  10. package/src/checkoutCoupon.test.ts +675 -675
  11. package/src/checkoutCoupon.ts +455 -455
  12. package/src/commonsDeposit.ts +298 -298
  13. package/src/commonsDepositWebhook.ts +237 -237
  14. package/src/dayPassConfirmation.ts +230 -230
  15. package/src/dunningEmails.test.ts +263 -263
  16. package/src/dunningEmails.ts +203 -203
  17. package/src/email-templates/brand.ts +93 -93
  18. package/src/email-templates/magic-link.tsx +59 -59
  19. package/src/email-templates/recovery.tsx +59 -59
  20. package/src/email-templates/signup.tsx +67 -67
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -312
  23. package/src/functions/admin-charge-guest-print.ts +229 -229
  24. package/src/functions/admin-correct-booking.ts +333 -333
  25. package/src/functions/admin-create-booking.ts +460 -460
  26. package/src/functions/admin-create-commons-event.ts +244 -244
  27. package/src/functions/admin-debug-boldsign-doc.ts +93 -93
  28. package/src/functions/admin-door-write.ts +272 -272
  29. package/src/functions/admin-issue-day-pass.ts +231 -231
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -168
  32. package/src/functions/admin-mint-portal-link.ts +62 -62
  33. package/src/functions/admin-photo-upload.ts +128 -128
  34. package/src/functions/admin-remove-team-member.ts +150 -150
  35. package/src/functions/admin-request-trial.ts +366 -366
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -323
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.ts +333 -333
  39. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  40. package/src/functions/admin-revoke-agreement.ts +467 -467
  41. package/src/functions/admin-send-commons-agreement.ts +214 -214
  42. package/src/functions/admin-set-credit-amount.ts +123 -123
  43. package/src/functions/admin-skip-commons-contract.ts +165 -165
  44. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  45. package/src/functions/admin-wall-photo-write.ts +141 -141
  46. package/src/functions/auth-email-hook.ts +259 -259
  47. package/src/functions/boldsign-sender-identity.ts +114 -114
  48. package/src/functions/booking-availability.ts +419 -419
  49. package/src/functions/booking-member-preview.ts +136 -136
  50. package/src/functions/booking-status.ts +149 -149
  51. package/src/functions/create-booking.ts +648 -648
  52. package/src/functions/create-day-pass-checkout.ts +218 -218
  53. package/src/functions/create-portal-session.ts +142 -142
  54. package/src/functions/create-subscription-checkout.test.ts +222 -222
  55. package/src/functions/create-subscription-checkout.ts +440 -440
  56. package/src/functions/day-pass-status.ts +89 -89
  57. package/src/functions/diag-webpush-test.ts +45 -45
  58. package/src/functions/event-access-admin.ts +277 -277
  59. package/src/functions/event-access-store.ts +334 -309
  60. package/src/functions/ezeep-print-webhook.ts +213 -213
  61. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  62. package/src/functions/fetch-avatar-original.ts +457 -457
  63. package/src/functions/get-provider-sign-link.ts +155 -155
  64. package/src/functions/get-signing-link.ts +211 -211
  65. package/src/functions/guest-print-setup-confirm.ts +128 -128
  66. package/src/functions/guest-print-submit.ts +149 -149
  67. package/src/functions/luma-webhook.ts +165 -165
  68. package/src/functions/mcp.ts +67 -67
  69. package/src/functions/member-door-action.test.ts +1248 -1248
  70. package/src/functions/member-door-action.ts +863 -863
  71. package/src/functions/member-unifi-mapping.test.ts +516 -516
  72. package/src/functions/member-unifi-mapping.ts +206 -206
  73. package/src/functions/membership-door-sync.ts +956 -956
  74. package/src/functions/migration-collision-alert.copy.ts +232 -232
  75. package/src/functions/migration-collision-alert.test.ts +349 -349
  76. package/src/functions/migration-collision-alert.ts +232 -232
  77. package/src/functions/office-assignment-end.ts +146 -146
  78. package/src/functions/portal-booking-access.ts +217 -95
  79. package/src/functions/portal-list-invoices.ts +99 -99
  80. package/src/functions/portal-request-login.ts +219 -192
  81. package/src/functions/portal-resend-invite.ts +248 -248
  82. package/src/functions/portal-submit-event.ts +168 -168
  83. package/src/functions/print-billing-recover.ts +97 -97
  84. package/src/functions/print-billing-run.ts +183 -183
  85. package/src/functions/public-facts.ts +168 -168
  86. package/src/functions/push-send.ts +348 -348
  87. package/src/functions/push-test.ts +234 -234
  88. package/src/functions/request-portal-link.ts +211 -211
  89. package/src/functions/review-ratings.ts +113 -113
  90. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  91. package/src/functions/space-availability-range.ts +142 -142
  92. package/src/functions/stripe-db-reconcile.ts +319 -319
  93. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -78
  94. package/src/functions/stripe-webhook.ts +2595 -2595
  95. package/src/functions/sync-gcal-blackouts.ts +298 -298
  96. package/src/functions/timetable-event-register.ts +162 -162
  97. package/src/functions/timetable-event-status.ts +90 -90
  98. package/src/functions/timetable-spaces.ts +219 -219
  99. package/src/functions/touch-pass-reconciler.ts +689 -689
  100. package/src/functions/touch-pass-signup.ts +478 -478
  101. package/src/functions/upload-booking-display-image.ts +179 -179
  102. package/src/functions/virtual-onboarding-purge.ts +134 -134
  103. package/src/functions/virtual-onboarding-submit.ts +315 -315
  104. package/src/functions/voice-booking.ts +453 -453
  105. package/src/functions/voice-day-pass.ts +346 -346
  106. package/src/functions/voice-inquiry.test.ts +301 -301
  107. package/src/functions/voice-inquiry.ts +198 -198
  108. package/src/functions/voice-membership-signup.ts +355 -355
  109. package/src/functions/voice-tour-availability.ts +204 -204
  110. package/src/functions/voice-tour-booking.ts +429 -429
  111. package/src/ghlEventInquiry.ts +143 -143
  112. package/src/mailArrivalEmail.ts +121 -121
  113. package/src/manageToken.ts +363 -363
  114. package/src/membershipBusClient.ts +537 -537
  115. package/src/membershipWelcome.ts +683 -683
  116. package/src/migrationCheckout.ts +366 -366
  117. package/src/paymentLinkEmail.ts +123 -123
  118. package/src/signedUnpaidReminderEmail.test.ts +246 -246
  119. package/src/signedUnpaidReminderEmail.ts +132 -132
  120. package/src/stripeCoworkingPortal.ts +91 -91
  121. package/src/supabaseTestFakes.ts +131 -131
  122. package/src/supportTicketEmail.ts +119 -119
  123. package/src/unifiAccessPolicies.ts +228 -228
  124. package/src/unifiGroups.ts +129 -129
@@ -1,429 +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
- }
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
+ }