@simplelayer/graniteer-core 0.1.2 → 0.2.1

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 +334 -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 +217 -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,472 @@
1
+ import { createClient } from 'npm:@supabase/supabase-js@2';
2
+ import { JWT } from 'npm:google-auth-library@9';
3
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
4
+ import { verifyManageToken } from 'npm:@simplelayer/graniteer-core/manageToken';
5
+ import { resolvePortalSessionEmail } from 'npm:@simplelayer/graniteer-core/portalSession';
6
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
7
+ import { deriveReservationWifiCode, isReservationWifiRoom } from 'npm:@simplelayer/graniteer-core/reservationWifiCode';
8
+ import { buildCancellationCreditGrants } from 'npm:@simplelayer/graniteer-core/rescheduleCredit';
9
+
10
+ const corsHeaders = {
11
+ 'Access-Control-Allow-Origin': '*',
12
+ 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
13
+ 'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
14
+ };
15
+
16
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
17
+ const LA_TZ = 'America/Los_Angeles';
18
+
19
+ function json(status: number, body: unknown) {
20
+ return new Response(JSON.stringify(body), {
21
+ status,
22
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
23
+ });
24
+ }
25
+
26
+ interface BookingRow {
27
+ id: string;
28
+ status: string;
29
+ contact_email: string;
30
+ contact_name: string | null;
31
+ contact_phone: string | null;
32
+ ghl_contact_id: string | null;
33
+ during: string;
34
+ charged_amount_cents: number | null;
35
+ list_amount_cents: number | null;
36
+ dynamic_discount_cents: number | null;
37
+ credit_applied_cents: number | null;
38
+ google_event_id: string | null;
39
+ rooms: {
40
+ id: string;
41
+ name: string;
42
+ address: string | null;
43
+ google_calendar_id: string | null;
44
+ slug: string | null;
45
+ booking_mode: string;
46
+ hourly_cents: number;
47
+ day_cents: number | null;
48
+ half_day_cents: number | null;
49
+ min_booking_minutes: number;
50
+ } | null;
51
+ }
52
+
53
+ // The gc-connect wrapper imports these from its own local _shared/busClient.ts
54
+ // (FTW-middleware-specific integration, out of scope for this phase) and
55
+ // passes them through unchanged.
56
+ export interface ManageBookingDeps {
57
+ busCancel: (
58
+ input: { bookingId: string; roomKey: string; startUtc: string; endUtc: string },
59
+ admin: unknown,
60
+ ) => Promise<unknown>;
61
+ signBus: (
62
+ verb: string, bookingId: string, roomKey: string, startUtc: string, endUtc: string,
63
+ secret: string, ts: number,
64
+ ) => Promise<string>;
65
+ toBusUtc: (iso: string) => string;
66
+ }
67
+
68
+ function parseTstzRange(range: string): { startISO: string; endISO: string } | null {
69
+ const m = range.match(/[[(]"?([^",)]+)"?,"?([^",)]+)"?[\])]/);
70
+ if (!m) return null;
71
+ const normalize = (raw: string) => {
72
+ let v = raw.trim().replace(/ /g, 'T');
73
+ v = v.replace(/([+-]\d{2})$/, '$1:00');
74
+ return v;
75
+ };
76
+ const s = new Date(normalize(m[1]));
77
+ const e = new Date(normalize(m[2]));
78
+ if (isNaN(s.getTime()) || isNaN(e.getTime())) return null;
79
+ return { startISO: s.toISOString(), endISO: e.toISOString() };
80
+ }
81
+
82
+ function googleCalendarUrl(startISO: string, endISO: string, title: string, details: string, location: string): string {
83
+ const compact = (iso: string) => new Date(iso).toISOString().replace(/[-:]/g, '').replace(/\.\d{3}/, '');
84
+ const dates = `${compact(startISO)}/${compact(endISO)}`;
85
+ const params = `action=TEMPLATE&text=${encodeURIComponent(title)}&dates=${dates}&details=${encodeURIComponent(details)}&location=${encodeURIComponent(location)}`;
86
+ return `https://calendar.google.com/calendar/render?${params}`;
87
+ }
88
+
89
+ async function deleteCalendarEvent(booking: BookingRow): Promise<{ ok: boolean; detail?: string }> {
90
+ const clientEmail = Deno.env.get('GOOGLE_SA_CLIENT_EMAIL');
91
+ const rawKey = Deno.env.get('GOOGLE_SA_PRIVATE_KEY');
92
+ if (!clientEmail || !rawKey) return { ok: false, detail: 'not_configured' };
93
+ if (!booking.google_event_id || !booking.rooms?.google_calendar_id) return { ok: false, detail: 'no_event_or_calendar' };
94
+ const privateKey = rawKey.replace(/\\n/g, '\n');
95
+ try {
96
+ const jwt = new JWT({ email: clientEmail, key: privateKey, scopes: ['https://www.googleapis.com/auth/calendar.events'] });
97
+ const tok = await jwt.getAccessToken();
98
+ if (!tok?.token) return { ok: false, detail: 'no_access_token' };
99
+ const url = `https://www.googleapis.com/calendar/v3/calendars/${encodeURIComponent(booking.rooms.google_calendar_id)}/events/${encodeURIComponent(booking.google_event_id)}`;
100
+ const res = await fetch(url, { method: 'DELETE', headers: { Authorization: `Bearer ${tok.token}` } });
101
+ if (!res.ok && res.status !== 404 && res.status !== 410) {
102
+ const text = await res.text();
103
+ return { ok: false, detail: `status_${res.status}: ${text.slice(0, 200)}` };
104
+ }
105
+ return { ok: true };
106
+ } catch (e) {
107
+ return { ok: false, detail: String(e).slice(0, 200) };
108
+ }
109
+ }
110
+
111
+ async function addGhlNote(ghlContactId: string | null, message: string): Promise<void> {
112
+ const apiKey = Deno.env.get('GHL_API_KEY');
113
+ if (!apiKey || !ghlContactId) return;
114
+ try {
115
+ await fetch(`${GHL_BASE}/contacts/${ghlContactId}/notes`, {
116
+ method: 'POST',
117
+ headers: {
118
+ Authorization: `Bearer ${apiKey}`,
119
+ Version: '2021-07-28',
120
+ 'Content-Type': 'application/json',
121
+ Accept: 'application/json',
122
+ },
123
+ body: JSON.stringify({ body: message }),
124
+ });
125
+ } catch { /* ignore */ }
126
+ }
127
+
128
+ async function bookingViewForCustomer(b: BookingRow, operator: { operatorName: string }) {
129
+ const range = parseTstzRange(b.during);
130
+ const startISO = range?.startISO ?? null;
131
+ const endISO = range?.endISO ?? null;
132
+ const now = Date.now();
133
+ const startMs = startISO ? new Date(startISO).getTime() : null;
134
+ const isPaid = b.status === 'paid';
135
+ const within48h = startMs != null && (startMs - now) < 48 * 60 * 60 * 1000;
136
+ const cancellable = isPaid && startMs != null && startMs > now;
137
+ const reschedulable = isPaid && startMs != null && startMs > now && !within48h;
138
+ const gcalUrl = startISO && endISO && b.rooms
139
+ ? googleCalendarUrl(
140
+ startISO,
141
+ endISO,
142
+ `${b.rooms.name} — ${operator.operatorName}`,
143
+ `Your booking at ${operator.operatorName}.\nRoom: ${b.rooms.name}\nBooking ID: ${b.id}`,
144
+ b.rooms.address || operator.operatorName,
145
+ )
146
+ : null;
147
+
148
+ // Guest WiFi code — derived fresh (never stored), gated to the 4 hourly
149
+ // meeting rooms and only shown while the booking is currently paid/
150
+ // confirmed. A cancelled booking needs no extra handling: ftw-middleware
151
+ // only ever validates against currently live/paid bookings.
152
+ let reservationWifiCode: string | null = null;
153
+ const wifiSecret = Deno.env.get('RESERVATION_WIFI_CODE_SECRET');
154
+ if (isPaid && wifiSecret && isReservationWifiRoom(b.rooms?.slug)) {
155
+ reservationWifiCode = await deriveReservationWifiCode(wifiSecret, b.id);
156
+ }
157
+
158
+ return {
159
+ booking_id: b.id,
160
+ room_id: b.rooms?.id ?? null,
161
+ room_name: b.rooms?.name ?? null,
162
+ room_address: b.rooms?.address ?? null,
163
+ booking_mode: b.rooms?.booking_mode ?? null,
164
+ hourly_cents: b.rooms?.hourly_cents ?? null,
165
+ day_cents: b.rooms?.day_cents ?? null,
166
+ half_day_cents: b.rooms?.half_day_cents ?? null,
167
+ min_booking_minutes: b.rooms?.min_booking_minutes ?? null,
168
+ contact_name: b.contact_name,
169
+ start: startISO,
170
+ end: endISO,
171
+ status: b.status,
172
+ list_amount_cents: b.list_amount_cents,
173
+ dynamic_discount_cents: b.dynamic_discount_cents,
174
+ charged_amount_cents: b.charged_amount_cents,
175
+ cancellable,
176
+ reschedulable,
177
+ within48h,
178
+ google_calendar_url: gcalUrl,
179
+ reservation_wifi_code: reservationWifiCode,
180
+ };
181
+ }
182
+
183
+ export async function handle(req: Request, operator: { operatorName: string }, deps: ManageBookingDeps): Promise<Response> {
184
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
185
+
186
+ const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
187
+ const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
188
+ const secret = Deno.env.get('MANAGE_TOKEN_SECRET');
189
+ if (!secret) return json(500, { error: 'not_configured' });
190
+
191
+ const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
192
+ auth: { persistSession: false, autoRefreshToken: false },
193
+ });
194
+
195
+ // Rate-limit BEFORE any DB work.
196
+ const ip = clientIp(req);
197
+ const [ipOk] = await Promise.all([
198
+ checkRateLimit(admin, 'manage-booking-ip', ip, 30, 300),
199
+ ]);
200
+ if (!ipOk) return json(429, { error: 'rate_limited' });
201
+
202
+ // Extract token + action.
203
+ let token = '';
204
+ let action: string | null = null;
205
+ let bodyBookingId = '';
206
+ if (req.method === 'GET') {
207
+ const url = new URL(req.url);
208
+ token = url.searchParams.get('token') ?? '';
209
+ bodyBookingId = url.searchParams.get('booking_id') ?? '';
210
+ } else if (req.method === 'POST') {
211
+ try {
212
+ const body = await req.json();
213
+ token = typeof body?.token === 'string' ? body.token : '';
214
+ action = typeof body?.action === 'string' ? body.action : null;
215
+ bodyBookingId = typeof body?.booking_id === 'string' ? body.booking_id : '';
216
+ } catch {
217
+ return json(400, { error: 'invalid_json' });
218
+ }
219
+ } else {
220
+ return json(405, { error: 'method_not_allowed' });
221
+ }
222
+
223
+ // Two accepted auth modes, resolving to the same (bookingId, authedEmail):
224
+ // 1. HMAC manage token (emailed link) — unchanged, still the default.
225
+ // 2. Member-portal session: Authorization: Bearer <jwt> + booking_id.
226
+ let bookingId = '';
227
+ let authedEmail = '';
228
+ if (token) {
229
+ const payload = await verifyManageToken(token, secret);
230
+ if (!payload) return json(401, { error: 'invalid_or_expired_token' });
231
+ bookingId = payload.bid;
232
+ authedEmail = payload.eml;
233
+ } else {
234
+ const sessionEmail = await resolvePortalSessionEmail(req, admin);
235
+ if (!sessionEmail || !bodyBookingId) return json(400, { error: 'missing_token' });
236
+ bookingId = bodyBookingId;
237
+ authedEmail = sessionEmail;
238
+ }
239
+
240
+ // Rate-limit per booking id to cap abuse of a single link/session.
241
+ const bidOk = await checkRateLimit(admin, 'manage-booking-bid', bookingId, 30, 300);
242
+ if (!bidOk) return json(429, { error: 'rate_limited' });
243
+
244
+ const { data: booking, error: bErr } = await admin
245
+ .from('bookings')
246
+ .select('id,status,contact_email,contact_name,contact_phone,ghl_contact_id,during,charged_amount_cents,list_amount_cents,dynamic_discount_cents,credit_applied_cents,google_event_id,rooms(id,name,address,google_calendar_id,slug,booking_mode,hourly_cents,day_cents,half_day_cents,min_booking_minutes)')
247
+ .eq('id', bookingId)
248
+ .maybeSingle();
249
+ if (bErr) return json(500, { error: 'lookup_failed' });
250
+ if (!booking) return json(404, { error: 'not_found' });
251
+ const b = booking as unknown as BookingRow;
252
+
253
+ // Credential (token or session) binds to the email the booking was made under.
254
+ if ((b.contact_email ?? '').toLowerCase() !== authedEmail.toLowerCase()) {
255
+ return json(401, { error: 'invalid_or_expired_token' });
256
+ }
257
+
258
+ if (req.method === 'GET') {
259
+ return json(200, await bookingViewForCustomer(b, operator));
260
+ }
261
+
262
+ // POST — 'cancel' or 'credential'.
263
+ if (action === 'credential') {
264
+ const parsedRange = parseTstzRange(b.during);
265
+ const endMs = parsedRange ? new Date(parsedRange.endISO).getTime() : 0;
266
+ if (b.status !== 'paid' || endMs <= Date.now()) {
267
+ return json(404, { error: 'no_credential' });
268
+ }
269
+ const busSecret = Deno.env.get('BUS_HMAC_SECRET');
270
+ const slug = b.rooms?.slug ?? null;
271
+ if (!busSecret || !slug || !parsedRange) {
272
+ return json(404, { error: 'no_credential' });
273
+ }
274
+ try {
275
+ const startUtc = deps.toBusUtc(parsedRange.startISO);
276
+ const endUtc = deps.toBusUtc(parsedRange.endISO);
277
+ const ts = Math.floor(Date.now() / 1000);
278
+ const sig = await deps.signBus('credential', b.id, slug, startUtc, endUtc, busSecret, ts);
279
+ const qs = new URLSearchParams({ source: 'gc-connect', booking_id: b.id });
280
+ // FTW membership-bus base URL: same GC-hardcoded infra as
281
+ // _shared/busClient.ts's own BUS_BASE, tracked for the later "make the
282
+ // bus pluggable" phase of this project, not this identity-parameterization
283
+ // phase.
284
+ const res = await fetch(`https://ftw.granitecity.io/bookings/credential?${qs.toString()}`, {
285
+ method: 'GET',
286
+ headers: { 'X-GC-Signature': sig, 'X-GC-Timestamp': String(ts) },
287
+ signal: AbortSignal.timeout(10000),
288
+ });
289
+ if (res.status === 404) return json(404, { error: 'no_credential' });
290
+ if (res.status === 401) {
291
+ await logOps(admin, 'manage_credential_unauthorized', {},
292
+ { severity: 'warning', bookingId: b.id });
293
+ return json(404, { error: 'no_credential' });
294
+ }
295
+ if (!res.ok) return json(404, { error: 'no_credential' });
296
+ const j = await res.json().catch(() => null) as
297
+ | { cancelled?: boolean; credential?: { pin?: unknown; status?: unknown; valid_from_utc?: unknown; valid_to_utc?: unknown } }
298
+ | null;
299
+ const cred = j?.credential;
300
+ if (j?.cancelled || !cred || typeof cred.pin !== 'string' || cred.pin.length === 0) {
301
+ return json(404, { error: 'no_credential' });
302
+ }
303
+ return json(200, {
304
+ pin: cred.pin,
305
+ status: typeof cred.status === 'string' ? cred.status : null,
306
+ valid_from_utc: typeof cred.valid_from_utc === 'string' ? cred.valid_from_utc : null,
307
+ valid_to_utc: typeof cred.valid_to_utc === 'string' ? cred.valid_to_utc : null,
308
+ });
309
+ } catch {
310
+ return json(404, { error: 'no_credential' });
311
+ }
312
+ }
313
+ if (action !== 'cancel') return json(400, { error: 'invalid_action' });
314
+
315
+ // Idempotent: if already cancelled, just return the current view.
316
+ if (b.status !== 'paid') {
317
+ return json(200, {
318
+ ...await bookingViewForCustomer(b, operator),
319
+ cancelled: b.status.startsWith('cancelled_'),
320
+ outcome: b.status,
321
+ });
322
+ }
323
+
324
+ const parsed = parseTstzRange(b.during);
325
+ if (!parsed) return json(500, { error: 'bad_time_range' });
326
+ const startMs = new Date(parsed.startISO).getTime();
327
+ const within48h = (startMs - Date.now()) < 48 * 60 * 60 * 1000;
328
+
329
+ const charged = b.charged_amount_cents ?? 0;
330
+ const appliedCredit = b.credit_applied_cents ?? 0;
331
+ const newStatus: 'cancelled_credited' | 'cancelled_forfeited' =
332
+ within48h ? 'cancelled_forfeited' : 'cancelled_credited';
333
+ const creditAmount = within48h ? 0 : charged + appliedCredit;
334
+
335
+ // Optimistic status flip.
336
+ const { data: updated, error: updErr } = await admin
337
+ .from('bookings')
338
+ .update({ status: newStatus })
339
+ .eq('id', b.id)
340
+ .eq('status', 'paid')
341
+ .select('id');
342
+ if (updErr) return json(500, { error: 'update_failed' });
343
+ if (!updated || updated.length === 0) {
344
+ // Someone else flipped it in-between — return current view.
345
+ const { data: fresh } = await admin
346
+ .from('bookings')
347
+ .select('id,status,contact_email,contact_name,contact_phone,ghl_contact_id,during,charged_amount_cents,list_amount_cents,dynamic_discount_cents,credit_applied_cents,google_event_id,rooms(id,name,address,google_calendar_id,slug,booking_mode,hourly_cents,day_cents,half_day_cents,min_booking_minutes)')
348
+ .eq('id', b.id)
349
+ .maybeSingle();
350
+ if (fresh) {
351
+ return json(200, {
352
+ ...await bookingViewForCustomer(fresh as unknown as BookingRow, operator),
353
+ cancelled: (fresh.status as string).startsWith('cancelled_'),
354
+ outcome: fresh.status,
355
+ });
356
+ }
357
+ }
358
+
359
+ // Credit ledger row(s): split cash-funded (1yr) vs credit-funded (capped at
360
+ // the ORIGINAL credit's own expiry) so a cancellation can never launder a
361
+ // short-lived credit into a longer-lived one. See E10/GATE-0188.
362
+ if (newStatus === 'cancelled_credited' && creditAmount > 0) {
363
+ const defaultExp = new Date();
364
+ defaultExp.setUTCFullYear(defaultExp.getUTCFullYear() + 1);
365
+ const built = await buildCancellationCreditGrants(admin, {
366
+ bookingId: b.id,
367
+ contactEmail: b.contact_email ?? '',
368
+ ghlContactId: b.ghl_contact_id,
369
+ cashPortionCents: charged,
370
+ creditPortionCents: appliedCredit,
371
+ defaultExp,
372
+ actor: 'customer',
373
+ });
374
+ if (built.expiryLookupErrored) {
375
+ await logOps(admin, 'manage_booking_credit_expiry_lookup_failed',
376
+ { detail: built.expiryLookupDetail, credit_applied_cents: appliedCredit },
377
+ { severity: 'error', bookingId: b.id });
378
+ }
379
+ if (built.grants.length > 0) {
380
+ const { error: cErr } = await admin.from('credits').insert(built.grants);
381
+ if (cErr) {
382
+ // Roll back status if we can't record the credit — customer must be made whole.
383
+ await admin.from('bookings').update({ status: 'paid' }).eq('id', b.id);
384
+ await logOps(admin, 'manage_booking_credit_failed',
385
+ { message: cErr.message },
386
+ { severity: 'error', bookingId: b.id });
387
+ return json(500, { error: 'credit_insert_failed' });
388
+ }
389
+ }
390
+ }
391
+
392
+ // Best-effort: reverse an applied coupon on this booking. Never rolls back
393
+ // the cancellation.
394
+ try {
395
+ const { data: redRow } = await admin
396
+ .from('coupon_redemptions')
397
+ .select('id,status')
398
+ .eq('applied_to_type', 'booking')
399
+ .eq('applied_to_id', b.id)
400
+ .maybeSingle();
401
+ if (redRow && redRow.status === 'applied') {
402
+ const { error: cvErr } = await admin.rpc('coupon_reverse', {
403
+ p_redemption_id: redRow.id,
404
+ p_reason: 'booking_cancelled',
405
+ p_actor_email: (b.contact_email ?? '').toLowerCase(),
406
+ });
407
+ if (cvErr) throw cvErr;
408
+ }
409
+ } catch (e) {
410
+ await logOps(admin, 'coupon_reverse_on_cancel_failed',
411
+ { message: String(e) }, { severity: 'error', bookingId: b.id });
412
+ }
413
+
414
+ // Best-effort: delete Google Calendar event.
415
+ try {
416
+ const cal = await deleteCalendarEvent(b);
417
+ if (cal.ok) {
418
+ await admin.from('bookings').update({ google_event_id: null }).eq('id', b.id);
419
+ }
420
+ } catch (e) {
421
+ await logOps(admin, 'manage_booking_calendar_delete_failed',
422
+ { message: String(e) },
423
+ { severity: 'warning', bookingId: b.id });
424
+ }
425
+
426
+ // Best-effort: GHL note so staff see it in the timeline.
427
+ const outcomeLine = within48h
428
+ ? 'Outcome: Forfeited (within 48 hours) — no refund/credit'
429
+ : `Outcome: Credit of $${(creditAmount / 100).toFixed(2)} issued (valid 1 year)`;
430
+ await addGhlNote(
431
+ b.ghl_contact_id,
432
+ [
433
+ 'Booking cancelled by customer (self-serve manage link)',
434
+ `Room: ${b.rooms?.name ?? '—'}`,
435
+ `Booking ID: ${b.id}`,
436
+ outcomeLine,
437
+ ].join('\n'),
438
+ );
439
+
440
+ // Best-effort: notify FTW bus that this booking is cancelled (inert until secret is set).
441
+ try {
442
+ if (b.rooms?.slug) {
443
+ await deps.busCancel({
444
+ bookingId: b.id,
445
+ roomKey: b.rooms.slug,
446
+ startUtc: parsed.startISO,
447
+ endUtc: parsed.endISO,
448
+ }, admin);
449
+ } else {
450
+ console.log('[manage-booking] busCancel skipped: missing room slug');
451
+ }
452
+ } catch { /* never break the response */ }
453
+
454
+ const { data: fresh } = await admin
455
+ .from('bookings')
456
+ .select('id,status,contact_email,contact_name,contact_phone,ghl_contact_id,during,charged_amount_cents,list_amount_cents,dynamic_discount_cents,credit_applied_cents,google_event_id,rooms(id,name,address,google_calendar_id,booking_mode,hourly_cents,day_cents,half_day_cents,min_booking_minutes)')
457
+ .eq('id', b.id)
458
+ .maybeSingle();
459
+ const view = fresh ? await bookingViewForCustomer(fresh as unknown as BookingRow, operator) : await bookingViewForCustomer(b, operator);
460
+ return json(200, {
461
+ ...view,
462
+ cancelled: true,
463
+ outcome: newStatus,
464
+ within48h,
465
+ credit_amount_cents: creditAmount,
466
+ });
467
+ }
468
+
469
+ // Unused in default runtime; exported for tests.
470
+ export const _test = { bookingViewForCustomer, googleCalendarUrl, parseTstzRange };
471
+ // LA_TZ retained for future use in humanized strings on the server (currently client-side).
472
+ void LA_TZ;
@@ -0,0 +1,67 @@
1
+ // Tenant branding for the gc-connect MCP server (supabase/functions/mcp).
2
+ //
3
+ // The MCP tool definitions themselves (schema, handlers, Supabase queries)
4
+ // stay in the tenant repo -- this module only supplies the generic
5
+ // text-construction logic behind the brand name / site URL literals that
6
+ // appear in tool descriptions and generated links, so those strings are
7
+ // parameterized instead of hardcoding "Granite City Workspaces" /
8
+ // "granitecity.io" in nine separate places.
9
+
10
+ export interface McpBrandConfig {
11
+ /** Public-facing operator name, e.g. "Granite City Workspaces". */
12
+ brandName: string;
13
+ /** Site origin, no trailing slash, e.g. "https://granitecity.io". */
14
+ siteBase: string;
15
+ }
16
+
17
+ function bareDomain(siteBase: string): string {
18
+ return siteBase.replace(/^https?:\/\//, '');
19
+ }
20
+
21
+ export function meetingRoomUrl(config: McpBrandConfig, slug: string): string {
22
+ return `${config.siteBase}/meeting-rooms/${slug}/`;
23
+ }
24
+
25
+ export function mcpToolDescriptions(config: McpBrandConfig) {
26
+ const domain = bareDomain(config.siteBase);
27
+ return {
28
+ listMeetingRooms:
29
+ `List ${config.brandName}' bookable meeting rooms with seats, hourly/day rates and booking mode.`,
30
+ listMembershipPlans:
31
+ `List active ${config.brandName} membership and private office plans with published pricing.`,
32
+ listOfficeAvailability:
33
+ `List ${config.brandName}' private offices and dedicated desks with building, office number, tier ` +
34
+ `and whether the space is currently vacant. Occupant details are never returned.`,
35
+ getBookingLink:
36
+ `Check whether a meeting room is open at a requested time and return a link to book it on ${domain}. ` +
37
+ `This tool never charges a card or creates the booking itself — the member (or their assistant) ` +
38
+ `completes the booking on the website, where payment and cancellation terms are shown. Use ` +
39
+ `check_room_availability first if you need the full list of open slots for a date.`,
40
+ };
41
+ }
42
+
43
+ /** The two "requested slot is open" branches of get_booking_link's note text. */
44
+ export function bookingLinkOpenNote(config: McpBrandConfig, date: string, startTime?: string): string {
45
+ const domain = bareDomain(config.siteBase);
46
+ if (startTime) {
47
+ return `${date} at ${startTime} is open. ${domain} does not currently pre-fill date/time from a link — ` +
48
+ `tell the member to open this page and pick ${date} at ${startTime} manually. Booking and payment ` +
49
+ `happen on the site; this tool never charges a card.`;
50
+ }
51
+ return `${domain} does not currently pre-fill date/time from a link — tell the member to open this page ` +
52
+ `and pick ${date} manually. Booking and payment happen on the site; this tool never charges a card.`;
53
+ }
54
+
55
+ export function mcpInstructions(config: McpBrandConfig): string {
56
+ const domain = bareDomain(config.siteBase);
57
+ return `Tools for ${config.brandName} (${domain}). Use \`list_meeting_rooms\` and \`list_membership_plans\` ` +
58
+ `for public pricing and space details, \`check_room_availability\` for open slots on a date, and ` +
59
+ `\`my_bookings\` / \`my_membership\` for the signed-in member's own bookings, membership status and ` +
60
+ `credit balance. Use \`list_office_availability\` to see which private offices and dedicated desks are ` +
61
+ `vacant, and \`verify_todays_booking\` to confirm that a caller with a given name has a booking in a ` +
62
+ `room on a date. Use \`get_booking_link\` to check whether a specific date/time is open for a room and ` +
63
+ `get a link for the member to complete the booking on ${domain} — it never charges a card or books on ` +
64
+ `its own. Use \`cancel_booking\` to cancel the signed-in member's own booking: for a booking 48+ hours ` +
65
+ `out it cancels immediately and issues a credit; for a booking within 48 hours it first previews the ` +
66
+ `forfeiture and requires a second call with confirm: true to actually cancel.`;
67
+ }