@simplelayer/graniteer-core 0.0.1 → 0.1.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 (100) hide show
  1. package/index.js +2 -2
  2. package/package.json +98 -15
  3. package/src/adminBookingCredit.test.ts +451 -0
  4. package/src/adminBookingCredit.ts +239 -0
  5. package/src/availability.test.ts +25 -0
  6. package/src/availability.ts +201 -0
  7. package/src/bookingHoldReclaim.ts +94 -0
  8. package/src/checkoutSessionParams.ts +56 -0
  9. package/src/commonsContract.ts +175 -0
  10. package/src/conductorAdmin.ts +141 -0
  11. package/src/email-templates/email-change.tsx +92 -0
  12. package/src/email-templates/invite.tsx +79 -0
  13. package/src/email-templates/reauthentication.tsx +60 -0
  14. package/src/functions/admin-cancel-membership.ts +311 -0
  15. package/src/functions/admin-change-membership-plan.ts +308 -0
  16. package/src/functions/admin-charge-guest-print.ts +229 -0
  17. package/src/functions/admin-correct-booking.ts +333 -0
  18. package/src/functions/admin-create-commons-event.ts +244 -0
  19. package/src/functions/admin-debug-boldsign-doc.ts +93 -0
  20. package/src/functions/admin-door-write.ts +272 -0
  21. package/src/functions/admin-mark-booking-paid.ts +203 -0
  22. package/src/functions/admin-photo-upload.ts +128 -0
  23. package/src/functions/admin-remove-team-member.ts +150 -0
  24. package/src/functions/admin-reset-mfa.ts +138 -0
  25. package/src/functions/admin-reverse-coupon-redemption.ts +98 -0
  26. package/src/functions/admin-send-commons-agreement.ts +214 -0
  27. package/src/functions/admin-set-credit-amount.ts +123 -0
  28. package/src/functions/admin-skip-commons-contract.ts +165 -0
  29. package/src/functions/admin-undo-membership-cancel.ts +144 -0
  30. package/src/functions/admin-wall-photo-write.ts +141 -0
  31. package/src/functions/boldsign-sender-identity.ts +114 -0
  32. package/src/functions/booking-availability.ts +419 -0
  33. package/src/functions/booking-member-preview.ts +136 -0
  34. package/src/functions/day-pass-status.ts +89 -0
  35. package/src/functions/dayStatus.ts +71 -0
  36. package/src/functions/diag-webpush-test.ts +45 -0
  37. package/src/functions/event-access-store.ts +309 -0
  38. package/src/functions/ezeep-print-webhook.ts +213 -0
  39. package/src/functions/ezeep-usage-reconcile.ts +299 -0
  40. package/src/functions/get-signing-link.ts +211 -0
  41. package/src/functions/guest-print-setup-confirm.ts +128 -0
  42. package/src/functions/guest-print-submit.ts +149 -0
  43. package/src/functions/luma-webhook.ts +165 -0
  44. package/src/functions/migration-collision-alert.copy.ts +232 -0
  45. package/src/functions/migration-collision-alert.test.ts +349 -0
  46. package/src/functions/migration-collision-alert.ts +232 -0
  47. package/src/functions/office-assignment-end.ts +146 -0
  48. package/src/functions/portal-booking-access.ts +95 -0
  49. package/src/functions/portal-list-invoices.ts +99 -0
  50. package/src/functions/print-billing-recover.ts +97 -0
  51. package/src/functions/print-billing-run.ts +183 -0
  52. package/src/functions/public-facts.ts +168 -0
  53. package/src/functions/space-availability-range.acceptance.test.ts +161 -0
  54. package/src/functions/space-availability-range.ts +142 -0
  55. package/src/functions/sync-gcal-blackouts.ts +298 -0
  56. package/src/functions/timetable-event-register.ts +162 -0
  57. package/src/functions/timetable-event-status.ts +90 -0
  58. package/src/functions/timetable-spaces.ts +219 -0
  59. package/src/functions/touch-pass-reconciler.ts +689 -0
  60. package/src/functions/virtual-onboarding-purge.ts +134 -0
  61. package/src/functions/virtual-onboarding-submit.ts +315 -0
  62. package/src/functions/voice-inquiry.test.ts +301 -0
  63. package/src/functions/voice-inquiry.ts +198 -0
  64. package/src/functions/voice-tour-availability.ts +204 -0
  65. package/src/gcalSync.ts +142 -0
  66. package/src/ghlNote.ts +34 -0
  67. package/src/ghlTask.ts +48 -0
  68. package/src/ghlVoiceInquiry.ts +90 -0
  69. package/src/guestPrintCapture.test.ts +722 -0
  70. package/src/guestPrintCapture.ts +538 -0
  71. package/src/lumaGhl.ts +195 -0
  72. package/src/membership.ts +109 -0
  73. package/src/money.ts +36 -0
  74. package/src/ops.ts +97 -0
  75. package/src/pacificDate.ts +34 -0
  76. package/src/policyAcknowledgment.test.ts +50 -0
  77. package/src/policyAcknowledgment.ts +96 -0
  78. package/src/portalSession.ts +46 -0
  79. package/src/pricing.test.ts +660 -0
  80. package/src/pricing.ts +1025 -0
  81. package/src/printBilling.test.ts +750 -0
  82. package/src/printBilling.ts +891 -0
  83. package/src/printBillingAdapters.ts +169 -0
  84. package/src/printCorrections.test.ts +348 -0
  85. package/src/printCorrections.ts +496 -0
  86. package/src/rateLimit.ts +82 -0
  87. package/src/referralCredits.test.ts +31 -0
  88. package/src/referralCredits.ts +34 -0
  89. package/src/referralGrant.ts +321 -0
  90. package/src/rescheduleCredit.test.ts +521 -0
  91. package/src/rescheduleCredit.ts +337 -0
  92. package/src/reservationWifiCode.test.ts +69 -0
  93. package/src/reservationWifiCode.ts +81 -0
  94. package/src/retellCallAnalyzed.test.ts +167 -0
  95. package/src/retellCallAnalyzed.ts +113 -0
  96. package/src/retellSignature.test.ts +137 -0
  97. package/src/retellSignature.ts +82 -0
  98. package/src/slackAlert.ts +38 -0
  99. package/src/supabaseTestFakes.ts +131 -0
  100. package/src/tier1Agreement.ts +125 -0
@@ -0,0 +1,204 @@
1
+ // Read-only tour-availability lookup for the Retell voice agent.
2
+ //
3
+ // `voice-tour-booking` owns the actual booking write and does its own
4
+ // single-slot free/busy check inline (see the comment at the top of that
5
+ // file — there was deliberately no separate availability-check tool for
6
+ // tours, unlike `check_room_availability` for rooms). That gap forced the
7
+ // voice agent to guess exact times one at a time against `book_tour` and
8
+ // read the rejection as its only signal, producing a slow, frustrating
9
+ // trial-and-error loop for callers (confirmed live on a 2026-08-21 test
10
+ // call: three consecutive book_tour misses before the agent gave up and
11
+ // promised a callback, while GHL's calendar actually had three real
12
+ // afternoon openings that day).
13
+ //
14
+ // This function closes that gap: given an anchor date, it walks forward
15
+ // (default 7 days) through GHL's free-slots endpoint for the requested tour
16
+ // calendar and returns a flat, ready-to-read list of open slots — enough for
17
+ // the agent to proactively offer several real options on the first attempt
18
+ // instead of iterating blind guesses through `book_tour`.
19
+ import { corsHeaders } from 'npm:@supabase/supabase-js@2/cors';
20
+ import { createClient } from 'npm:@supabase/supabase-js@2';
21
+ import { z } from 'npm:zod@3.23.8';
22
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
23
+ import { laWallToUtc } from 'npm:@simplelayer/graniteer-core/availability';
24
+ import { verifyRetellSignature } from 'npm:@simplelayer/graniteer-core/retellSignature';
25
+
26
+ const Body = z.object({
27
+ tour_type: z.enum(['workspace', 'event-space']),
28
+ // Anchor date to start searching from — usually "today" or whatever day
29
+ // the caller first asked about. YYYY-MM-DD in America/Los_Angeles time.
30
+ date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
31
+ // How many calendar days forward to search, inclusive of the anchor date.
32
+ // Optional — defaults to 7. Capped at 14 to keep the GHL call and the
33
+ // response both small.
34
+ days_ahead: z.number().int().min(1).max(14).optional(),
35
+ });
36
+
37
+ const json = (status: number, body: unknown) =>
38
+ new Response(JSON.stringify(body), {
39
+ status,
40
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
41
+ });
42
+
43
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
44
+ const GHL_VERSION = '2021-07-28';
45
+ // Cloudflare in front of the LeadConnector host blocks default fetch UAs.
46
+ const BROWSER_UA =
47
+ 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/124.0 Safari/537.36';
48
+
49
+ // Same two calendars as voice-tour-booking — kept in sync deliberately;
50
+ // if one changes, change both.
51
+ const TOUR_CALENDARS: Record<'workspace' | 'event-space', { calendarId: string; label: string }> = {
52
+ workspace: { calendarId: 'SVTXVh2uhJjMBKIY6Sd4', label: 'Workspace Tour w/Megan' },
53
+ 'event-space': { calendarId: 'ZpDp17KNsiranwTIrTFw', label: 'Event Space Tour w/Megan' },
54
+ };
55
+
56
+ // Cap on how many individual slots come back — enough for the agent to offer
57
+ // a genuinely useful spread (today's remaining openings plus a couple of
58
+ // next-available days) without dumping dozens of half-hour slots on the
59
+ // caller.
60
+ const MAX_SLOTS = 8;
61
+
62
+ function nextDateStr(dateStr: string): string {
63
+ const [y, mo, d] = dateStr.split('-').map(Number);
64
+ return new Date(Date.UTC(y, mo - 1, d + 1)).toISOString().slice(0, 10);
65
+ }
66
+
67
+ function addDays(dateStr: string, n: number): string {
68
+ const [y, mo, d] = dateStr.split('-').map(Number);
69
+ return new Date(Date.UTC(y, mo - 1, d + n)).toISOString().slice(0, 10);
70
+ }
71
+
72
+ const WEEKDAY_LABELS = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
73
+
74
+ function friendlyLabel(dateStr: string, hh: number, mm: number, todayStr: string): string {
75
+ const [y, mo, d] = dateStr.split('-').map(Number);
76
+ const weekday = WEEKDAY_LABELS[new Date(Date.UTC(y, mo - 1, d)).getUTCDay()];
77
+ const dayPart = dateStr === todayStr ? 'Today' : dateStr === nextDateStr(todayStr) ? 'Tomorrow' : weekday;
78
+ const hour12 = hh % 12 === 0 ? 12 : hh % 12;
79
+ const ampm = hh < 12 ? 'AM' : 'PM';
80
+ const minutePart = mm === 0 ? '' : `:${String(mm).padStart(2, '0')}`;
81
+ return `${dayPart} at ${hour12}${minutePart} ${ampm}`;
82
+ }
83
+
84
+ export async function handle(req: Request): Promise<Response> {
85
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
86
+
87
+ const rawBody = await req.text().catch(() => '');
88
+ if (!(await verifyRetellSignature(req, rawBody, 'voice-tour-availability'))) {
89
+ return json(401, { ok: false, error: 'unauthorized' });
90
+ }
91
+
92
+ let raw: unknown = {};
93
+ try {
94
+ raw = rawBody ? JSON.parse(rawBody) : {};
95
+ } catch {
96
+ raw = {};
97
+ }
98
+
99
+ const parsed = Body.safeParse(raw);
100
+ if (!parsed.success) return json(400, { ok: false, error: 'invalid_request' });
101
+
102
+ const { tour_type, date, days_ahead } = parsed.data;
103
+ const windowDays = days_ahead ?? 7;
104
+
105
+ const supabaseUrl = Deno.env.get('SUPABASE_URL')!;
106
+ const serviceKey = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
107
+ const supabase = createClient(supabaseUrl, serviceKey);
108
+
109
+ const GENERIC_ERROR =
110
+ "Sorry — I couldn't pull up tour availability right now. I'll have a team member follow up to get you scheduled.";
111
+
112
+ try {
113
+ const ip = clientIp(req);
114
+ // Read-only, but still rate-limited: this is a live call to GHL on every
115
+ // invocation, same as voice-tour-booking's own inline check.
116
+ const ipOk = await checkRateLimit(supabase, 'voice-tour-availability-ip', ip, 20, 600);
117
+ if (!ipOk) {
118
+ return json(200, { ok: false, error: 'Too many availability checks — please try again in a few minutes.' });
119
+ }
120
+
121
+ const apiKey = Deno.env.get('GC_VOICE_GHL_API_KEY');
122
+ if (!apiKey) {
123
+ console.error('[voice-tour-availability] GC_VOICE_GHL_API_KEY not set');
124
+ return json(200, { ok: false, error: GENERIC_ERROR });
125
+ }
126
+
127
+ const calendar = TOUR_CALENDARS[tour_type];
128
+ const endDateExclusive = addDays(date, windowDays);
129
+
130
+ const startMs = laWallToUtc(date, 0, 0).getTime();
131
+ const endMs = laWallToUtc(endDateExclusive, 0, 0).getTime();
132
+
133
+ const url =
134
+ `${GHL_BASE}/calendars/${calendar.calendarId}/free-slots?startDate=${startMs}&endDate=${endMs}` +
135
+ `&timezone=America%2FLos_Angeles`;
136
+ const res = await fetch(url, {
137
+ headers: {
138
+ Authorization: `Bearer ${apiKey}`,
139
+ Version: GHL_VERSION,
140
+ Accept: 'application/json',
141
+ 'User-Agent': BROWSER_UA,
142
+ },
143
+ });
144
+ if (!res.ok) {
145
+ console.error('[voice-tour-availability] free-slots failed', res.status, await res.text().catch(() => ''));
146
+ return json(200, { ok: false, error: GENERIC_ERROR });
147
+ }
148
+
149
+ const data = (await res.json().catch(() => null)) as Record<string, unknown> | null;
150
+ if (!data || typeof data !== 'object') return json(200, { ok: false, error: GENERIC_ERROR });
151
+
152
+ // GHL keys the response by date (plus a `traceId` key to skip). Flatten
153
+ // every slot across every date, sort chronologically, then cap.
154
+ type Slot = { date: string; start_time: string; label: string };
155
+ const out: Slot[] = [];
156
+ const dateKeys = Object.keys(data).filter((k) => /^\d{4}-\d{2}-\d{2}$/.test(k)).sort();
157
+ for (const dKey of dateKeys) {
158
+ const slots = (data[dKey] as { slots?: unknown } | null)?.slots;
159
+ if (!Array.isArray(slots)) continue;
160
+ for (const slot of slots) {
161
+ if (typeof slot !== 'string') continue;
162
+ const dt = new Date(slot);
163
+ if (Number.isNaN(dt.getTime())) continue;
164
+ // Slot ISO strings come back with the LA offset already applied
165
+ // (e.g. "2026-08-24T09:00:00-07:00"), so reading the local wall time
166
+ // straight off the string (not via UTC conversion) gives the right
167
+ // HH:MM without re-deriving DST.
168
+ const m = /T(\d{2}):(\d{2}):/.exec(slot);
169
+ if (!m) continue;
170
+ const hh = Number(m[1]);
171
+ const mm = Number(m[2]);
172
+ out.push({
173
+ date: dKey,
174
+ start_time: `${String(hh).padStart(2, '0')}:${String(mm).padStart(2, '0')}`,
175
+ label: friendlyLabel(dKey, hh, mm, date),
176
+ });
177
+ }
178
+ }
179
+
180
+ out.sort((a, b) => (a.date === b.date ? a.start_time.localeCompare(b.start_time) : a.date.localeCompare(b.date)));
181
+ const capped = out.slice(0, MAX_SLOTS);
182
+
183
+ if (capped.length === 0) {
184
+ return json(200, {
185
+ ok: false,
186
+ error:
187
+ `No openings for the ${calendar.label} in the next ${windowDays} days — ` +
188
+ `I'll have a team member follow up to get you scheduled.`,
189
+ });
190
+ }
191
+
192
+ return json(200, {
193
+ ok: true,
194
+ tour_type,
195
+ calendar_label: calendar.label,
196
+ searched_from: date,
197
+ searched_through: addDays(endDateExclusive, -1),
198
+ slots: capped,
199
+ });
200
+ } catch (e) {
201
+ console.error('[voice-tour-availability] error', e);
202
+ return json(200, { ok: false, error: GENERIC_ERROR });
203
+ }
204
+ }
@@ -0,0 +1,142 @@
1
+ // Pure helpers for the Google Calendar → blackouts sync.
2
+ // No Deno-only or npm: imports so unit tests can mirror this logic in vitest.
3
+
4
+ // LA offset in hours (integer: -7 DST, -8 STD) for a given UTC instant.
5
+ // Uses Intl.DateTimeFormat longOffset — DST-correct across boundaries.
6
+ export function laOffsetHours(atUtc: Date): number {
7
+ const parts = new Intl.DateTimeFormat('en-US', {
8
+ timeZone: 'America/Los_Angeles',
9
+ timeZoneName: 'longOffset',
10
+ }).formatToParts(atUtc);
11
+ const tz = parts.find((p) => p.type === 'timeZoneName')?.value ?? 'GMT-08:00';
12
+ const m = tz.match(/GMT([+-])(\d{1,2}):?(\d{2})?/);
13
+ if (!m) return -8;
14
+ const sign = m[1] === '+' ? 1 : -1;
15
+ return sign * (parseInt(m[2], 10) + parseInt(m[3] || '0', 10) / 60);
16
+ }
17
+
18
+ // Convert an LA wall-clock (YYYY-MM-DD + HH:MM) to a real UTC Date.
19
+ // Picks the offset from noon UTC of that day to avoid DST-edge ambiguity.
20
+ export function laWallToUtc(dateStr: string, hh: number, mm: number): Date {
21
+ const [y, mo, d] = dateStr.split('-').map(Number);
22
+ const guess = new Date(Date.UTC(y, mo - 1, d, 12));
23
+ const off = laOffsetHours(guess);
24
+ return new Date(Date.UTC(y, mo - 1, d, hh - Math.trunc(off), mm));
25
+ }
26
+
27
+ // Convert a Google all-day event's YYYY-MM-DD start/end (end exclusive) to
28
+ // UTC ISO strings representing LA-midnight of start through LA-midnight of end.
29
+ export function allDayToUtcRange(
30
+ startDate: string,
31
+ endDate: string,
32
+ ): { startIso: string; endIso: string } {
33
+ const s = laMidnightUtc(startDate);
34
+ const e = laMidnightUtc(endDate);
35
+ return { startIso: s.toISOString(), endIso: e.toISOString() };
36
+ }
37
+
38
+ // LA midnight of the given calendar date, DST-correct on both spring-forward
39
+ // and fall-back days. The noon-guess trick in `laWallToUtc` fails at midnight
40
+ // on fall-back (Nov 1) because noon UTC on that date is already in PST,
41
+ // producing an 08:00Z answer when 07:00Z is correct.
42
+ //
43
+ // We try both offsets and pick the one whose LA rendering matches the
44
+ // requested wall-date at hour 00.
45
+ export function laMidnightUtc(dateStr: string): Date {
46
+ const [y, mo, d] = dateStr.split('-').map(Number);
47
+ const fmt = new Intl.DateTimeFormat('en-US', {
48
+ timeZone: 'America/Los_Angeles',
49
+ year: 'numeric',
50
+ month: '2-digit',
51
+ day: '2-digit',
52
+ hour: '2-digit',
53
+ hour12: false,
54
+ });
55
+ for (const off of [-7, -8]) {
56
+ const utc = new Date(Date.UTC(y, mo - 1, d, -off, 0));
57
+ const parts = fmt.formatToParts(utc);
58
+ const gy = parts.find((p) => p.type === 'year')?.value;
59
+ const gmo = parts.find((p) => p.type === 'month')?.value;
60
+ const gd = parts.find((p) => p.type === 'day')?.value;
61
+ const gh = parts.find((p) => p.type === 'hour')?.value;
62
+ const iso = `${gy}-${gmo}-${gd}`;
63
+ // Intl may render midnight as '00' or '24' depending on runtime.
64
+ const hourOk = gh === '00' || gh === '24';
65
+ if (iso === dateStr && hourOk) return utc;
66
+ }
67
+ // Fallback (should not happen for real LA dates).
68
+ return new Date(Date.UTC(y, mo - 1, d, 8, 0));
69
+ }
70
+
71
+ export interface GcalEventStartEnd {
72
+ dateTime?: string;
73
+ date?: string;
74
+ }
75
+
76
+ export interface GcalEvent {
77
+ id: string;
78
+ status?: string;
79
+ summary?: string;
80
+ transparency?: string;
81
+ start?: GcalEventStartEnd;
82
+ end?: GcalEventStartEnd;
83
+ extendedProperties?: {
84
+ private?: Record<string, string>;
85
+ shared?: Record<string, string>;
86
+ };
87
+ }
88
+
89
+ // True when this event was created by our own booking system and must NOT be
90
+ // re-imported as a blackout (belt & braces: gc_source marker OR known booking
91
+ // google_event_id). Also drops cancelled and transparent (free) events.
92
+ export function shouldSkipEvent(ev: GcalEvent, selfIds: Set<string>): boolean {
93
+ if (!ev || !ev.id) return true;
94
+ if (ev.status === 'cancelled') return true;
95
+ if (ev.transparency === 'transparent') return true;
96
+ const source = ev.extendedProperties?.private?.gc_source;
97
+ if (source === 'gc-connect') return true;
98
+ if (selfIds.has(ev.id)) return true;
99
+ return false;
100
+ }
101
+
102
+ // Extract a UTC [startIso, endIso) range from a Google event.
103
+ // - Timed events: pass through start.dateTime / end.dateTime (already offset-aware ISO)
104
+ // - All-day events: LA-midnight to LA-midnight (end is exclusive per GCal)
105
+ // Returns null if the shape is unrecognized.
106
+ export function eventToRange(
107
+ ev: GcalEvent,
108
+ ): { startIso: string; endIso: string } | null {
109
+ const s = ev.start ?? {};
110
+ const e = ev.end ?? {};
111
+ if (s.dateTime && e.dateTime) {
112
+ const sd = new Date(s.dateTime);
113
+ const ed = new Date(e.dateTime);
114
+ if (Number.isNaN(sd.getTime()) || Number.isNaN(ed.getTime())) return null;
115
+ return { startIso: sd.toISOString(), endIso: ed.toISOString() };
116
+ }
117
+ if (s.date && e.date) {
118
+ return allDayToUtcRange(s.date, e.date);
119
+ }
120
+ return null;
121
+ }
122
+
123
+ // Given the ids we fetched per room this run and the set of rooms whose fetch
124
+ // failed, return the per-room set of ids that survive (retain). Rooms whose
125
+ // fetch failed produce `null` — callers must skip deletes for those rooms.
126
+ export function computeRetainSets(
127
+ fetchedByRoom: Record<string, string[]>,
128
+ failedRooms: Set<string>,
129
+ ): Record<string, Set<string> | null> {
130
+ const out: Record<string, Set<string> | null> = {};
131
+ for (const [room, ids] of Object.entries(fetchedByRoom)) {
132
+ if (failedRooms.has(room)) {
133
+ out[room] = null;
134
+ } else {
135
+ out[room] = new Set(ids);
136
+ }
137
+ }
138
+ for (const room of failedRooms) {
139
+ if (!(room in out)) out[room] = null;
140
+ }
141
+ return out;
142
+ }
package/src/ghlNote.ts ADDED
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Post a note onto a GHL/LeadConnector contact.
3
+ * Never throws — returns false on any failure.
4
+ */
5
+ export async function postContactNote(
6
+ apiKey: string,
7
+ contactId: string,
8
+ body: string,
9
+ ): Promise<boolean> {
10
+ if (!apiKey || !contactId || !body) return false;
11
+ try {
12
+ const resp = await fetch(
13
+ `https://services.leadconnectorhq.com/contacts/${contactId}/notes`,
14
+ {
15
+ method: "POST",
16
+ headers: {
17
+ Authorization: `Bearer ${apiKey}`,
18
+ Version: "2021-07-28",
19
+ "Content-Type": "application/json",
20
+ },
21
+ body: JSON.stringify({ body: body.slice(0, 5000) }),
22
+ },
23
+ );
24
+ if (!resp.ok) {
25
+ console.error("[ghlNote] note failed", resp.status, await resp.text().catch(() => ""));
26
+ return false;
27
+ }
28
+ console.log("[ghlNote] note created for contact", contactId, "status:", resp.status);
29
+ return true;
30
+ } catch (err) {
31
+ console.error("[ghlNote] note error", err);
32
+ return false;
33
+ }
34
+ }
package/src/ghlTask.ts ADDED
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Create a GHL task on a contact so a staff member is actually notified of an
3
+ * inbound website lead. Mirrors ghlNote.ts: never throws, returns false on failure.
4
+ */
5
+
6
+ // GHL user ids for location BDI8NHA4nkHnQGJ8g3hV (verified live 2026-07-31)
7
+ export const GHL_USER_MEGAN = "IK5HeWGcvch99L0p428S";
8
+ export const GHL_USER_KYLE = "Fzy7Dt9Z08Xeg4vxM7KU";
9
+
10
+ export async function createLeadTask(
11
+ apiKey: string,
12
+ contactId: string,
13
+ title: string,
14
+ body: string,
15
+ assignedTo: string = GHL_USER_MEGAN,
16
+ ): Promise<boolean> {
17
+ if (!apiKey || !contactId || !title) return false;
18
+ try {
19
+ const dueDate = new Date(Date.now() + 60 * 60 * 1000).toISOString();
20
+ const resp = await fetch(
21
+ `https://services.leadconnectorhq.com/contacts/${contactId}/tasks`,
22
+ {
23
+ method: "POST",
24
+ headers: {
25
+ Authorization: `Bearer ${apiKey}`,
26
+ Version: "2021-07-28",
27
+ "Content-Type": "application/json",
28
+ },
29
+ body: JSON.stringify({
30
+ title: title.slice(0, 200),
31
+ body: body.slice(0, 5000),
32
+ dueDate,
33
+ completed: false,
34
+ assignedTo,
35
+ }),
36
+ },
37
+ );
38
+ if (!resp.ok) {
39
+ console.error("[ghlTask] task failed", resp.status, await resp.text().catch(() => ""));
40
+ return false;
41
+ }
42
+ console.log("[ghlTask] task created for contact", contactId);
43
+ return true;
44
+ } catch (err) {
45
+ console.error("[ghlTask] task error", err);
46
+ return false;
47
+ }
48
+ }
@@ -0,0 +1,90 @@
1
+ import { postContactNote } from './ghlNote.ts';
2
+
3
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
4
+
5
+ /**
6
+ * Sync a voice-call inquiry as a GHL lead: upsert the contact for the given
7
+ * location, tag it via the dedicated tags endpoint (upsert's own `tags`
8
+ * field REPLACES existing tags, so a tag add always goes through the
9
+ * dedicated endpoint instead — same convention as request-portal-link.ts),
10
+ * and leave a note. Shared by `retell-call-webhook` (caller-ID-backfill
11
+ * fallback) and `voice-inquiry` (live tool-call capture) — the two call
12
+ * sites differ only in tags/note wording, which they build themselves.
13
+ *
14
+ * Never throws — a CRM hiccup must never turn into a non-200 for Retell.
15
+ * `ok` in the return value reflects only "the contact now exists in GHL";
16
+ * tag/note failures are logged but do not flip it to false, since callers
17
+ * use `ok` to decide whether to write a dedupe marker for the capture
18
+ * itself, not for every downstream step.
19
+ */
20
+ export async function syncVoiceInquiryToGhl(args: {
21
+ apiKey: string;
22
+ locationId: string;
23
+ callbackNumber: string;
24
+ callerName?: string | null;
25
+ tags: string[];
26
+ noteBody: string;
27
+ }): Promise<{ ok: boolean; contactId?: string }> {
28
+ try {
29
+ // GHL rejects an upsert with neither a usable number nor an email
30
+ // ("Pass at least one of number, email query parameter"). A phone that
31
+ // normalizes down to "" or "+" (no digits, or far too few) is exactly
32
+ // that case — bail before the request so the failure is attributable.
33
+ const digitCount = (args.callbackNumber.match(/\d/g) ?? []).length;
34
+ if (digitCount < 7) {
35
+ console.error(
36
+ '[ghlVoiceInquiry] refusing GHL upsert — callback number has too few digits',
37
+ JSON.stringify({ digit_count: digitCount }),
38
+ );
39
+ return { ok: false };
40
+ }
41
+
42
+ const headers = {
43
+ Authorization: `Bearer ${args.apiKey}`,
44
+ Version: '2021-07-28',
45
+ 'Content-Type': 'application/json',
46
+ };
47
+
48
+ const upsertRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
49
+ method: 'POST',
50
+ headers,
51
+ body: JSON.stringify({
52
+ locationId: args.locationId,
53
+ phone: args.callbackNumber,
54
+ ...(args.callerName ? { name: args.callerName } : {}),
55
+ source: 'Retell Voice Receptionist',
56
+ }),
57
+ });
58
+ if (!upsertRes.ok) {
59
+ console.error(
60
+ '[ghlVoiceInquiry] GHL upsert failed',
61
+ upsertRes.status,
62
+ await upsertRes.text().catch(() => ''),
63
+ );
64
+ return { ok: false };
65
+ }
66
+ const upsertJson = (await upsertRes.json().catch(() => null)) as
67
+ | { contact?: { id?: string }; id?: string }
68
+ | null;
69
+ const contactId = upsertJson?.contact?.id ?? upsertJson?.id;
70
+ if (!contactId) {
71
+ console.error('[ghlVoiceInquiry] GHL upsert returned no contact id');
72
+ return { ok: false };
73
+ }
74
+
75
+ if (args.tags.length > 0) {
76
+ await fetch(`${GHL_BASE}/contacts/${contactId}/tags`, {
77
+ method: 'POST',
78
+ headers,
79
+ body: JSON.stringify({ tags: args.tags }),
80
+ }).catch((e) => console.warn('[ghlVoiceInquiry] tag add error', e));
81
+ }
82
+
83
+ await postContactNote(args.apiKey, contactId, args.noteBody);
84
+
85
+ return { ok: true, contactId };
86
+ } catch (e) {
87
+ console.error('[ghlVoiceInquiry] GHL sync error', e);
88
+ return { ok: false };
89
+ }
90
+ }