@simplelayer/graniteer-core 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/index.js +2 -2
  2. package/package.json +1 -1
  3. package/src/agreementCheckout.ts +250 -250
  4. package/src/agreementPortalEmail.ts +128 -128
  5. package/src/billingPortalLinkEmail.ts +117 -117
  6. package/src/bookingAgreementEmail.ts +149 -149
  7. package/src/bookingEffects.ts +388 -388
  8. package/src/busClient.ts +268 -268
  9. package/src/busSignature.ts +71 -71
  10. package/src/checkoutCoupon.test.ts +675 -675
  11. package/src/checkoutCoupon.ts +455 -455
  12. package/src/commonsDeposit.ts +298 -298
  13. package/src/commonsDepositWebhook.ts +237 -237
  14. package/src/dayPassConfirmation.ts +230 -230
  15. package/src/dunningEmails.test.ts +263 -263
  16. package/src/dunningEmails.ts +203 -203
  17. package/src/email-templates/brand.ts +93 -93
  18. package/src/email-templates/magic-link.tsx +59 -59
  19. package/src/email-templates/recovery.tsx +59 -59
  20. package/src/email-templates/signup.tsx +67 -67
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -312
  23. package/src/functions/admin-charge-guest-print.ts +229 -229
  24. package/src/functions/admin-correct-booking.ts +333 -333
  25. package/src/functions/admin-create-booking.ts +460 -460
  26. package/src/functions/admin-create-commons-event.ts +244 -244
  27. package/src/functions/admin-debug-boldsign-doc.ts +93 -93
  28. package/src/functions/admin-door-write.ts +272 -272
  29. package/src/functions/admin-issue-day-pass.ts +231 -231
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -168
  32. package/src/functions/admin-mint-portal-link.ts +62 -62
  33. package/src/functions/admin-photo-upload.ts +128 -128
  34. package/src/functions/admin-remove-team-member.ts +150 -150
  35. package/src/functions/admin-request-trial.ts +366 -366
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -323
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.ts +333 -333
  39. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  40. package/src/functions/admin-revoke-agreement.ts +467 -467
  41. package/src/functions/admin-send-commons-agreement.ts +214 -214
  42. package/src/functions/admin-set-credit-amount.ts +123 -123
  43. package/src/functions/admin-skip-commons-contract.ts +165 -165
  44. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  45. package/src/functions/admin-wall-photo-write.ts +141 -141
  46. package/src/functions/auth-email-hook.ts +259 -259
  47. package/src/functions/boldsign-sender-identity.ts +114 -114
  48. package/src/functions/booking-availability.ts +419 -419
  49. package/src/functions/booking-member-preview.ts +136 -136
  50. package/src/functions/booking-status.ts +149 -149
  51. package/src/functions/create-booking.ts +648 -648
  52. package/src/functions/create-day-pass-checkout.ts +218 -218
  53. package/src/functions/create-portal-session.ts +142 -142
  54. package/src/functions/create-subscription-checkout.test.ts +222 -222
  55. package/src/functions/create-subscription-checkout.ts +440 -440
  56. package/src/functions/day-pass-status.ts +89 -89
  57. package/src/functions/diag-webpush-test.ts +45 -45
  58. package/src/functions/event-access-admin.ts +277 -277
  59. package/src/functions/event-access-store.ts +334 -334
  60. package/src/functions/ezeep-print-webhook.ts +213 -213
  61. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  62. package/src/functions/fetch-avatar-original.ts +457 -457
  63. package/src/functions/get-provider-sign-link.ts +155 -155
  64. package/src/functions/get-signing-link.ts +211 -211
  65. package/src/functions/guest-print-setup-confirm.ts +128 -128
  66. package/src/functions/guest-print-submit.ts +149 -149
  67. package/src/functions/luma-webhook.ts +165 -165
  68. package/src/functions/mcp.ts +67 -67
  69. package/src/functions/member-door-action.test.ts +1248 -1248
  70. package/src/functions/member-door-action.ts +863 -863
  71. package/src/functions/member-unifi-mapping.test.ts +516 -516
  72. package/src/functions/member-unifi-mapping.ts +206 -206
  73. package/src/functions/membership-door-sync.ts +956 -956
  74. package/src/functions/migration-collision-alert.copy.ts +232 -232
  75. package/src/functions/migration-collision-alert.test.ts +349 -349
  76. package/src/functions/migration-collision-alert.ts +232 -232
  77. package/src/functions/office-assignment-end.ts +146 -146
  78. package/src/functions/portal-booking-access.ts +217 -217
  79. package/src/functions/portal-list-invoices.ts +99 -99
  80. package/src/functions/portal-request-login.ts +219 -192
  81. package/src/functions/portal-resend-invite.ts +248 -248
  82. package/src/functions/portal-submit-event.ts +168 -168
  83. package/src/functions/print-billing-recover.ts +97 -97
  84. package/src/functions/print-billing-run.ts +183 -183
  85. package/src/functions/public-facts.ts +168 -168
  86. package/src/functions/push-send.ts +348 -348
  87. package/src/functions/push-test.ts +234 -234
  88. package/src/functions/request-portal-link.ts +211 -211
  89. package/src/functions/review-ratings.ts +113 -113
  90. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  91. package/src/functions/space-availability-range.ts +142 -142
  92. package/src/functions/stripe-db-reconcile.ts +319 -319
  93. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -78
  94. package/src/functions/stripe-webhook.ts +2595 -2595
  95. package/src/functions/sync-gcal-blackouts.ts +298 -298
  96. package/src/functions/timetable-event-register.ts +162 -162
  97. package/src/functions/timetable-event-status.ts +90 -90
  98. package/src/functions/timetable-spaces.ts +219 -219
  99. package/src/functions/touch-pass-reconciler.ts +689 -689
  100. package/src/functions/touch-pass-signup.ts +478 -478
  101. package/src/functions/upload-booking-display-image.ts +179 -179
  102. package/src/functions/virtual-onboarding-purge.ts +134 -134
  103. package/src/functions/virtual-onboarding-submit.ts +315 -315
  104. package/src/functions/voice-booking.ts +453 -453
  105. package/src/functions/voice-day-pass.ts +346 -346
  106. package/src/functions/voice-inquiry.test.ts +301 -301
  107. package/src/functions/voice-inquiry.ts +198 -198
  108. package/src/functions/voice-membership-signup.ts +355 -355
  109. package/src/functions/voice-tour-availability.ts +204 -204
  110. package/src/functions/voice-tour-booking.ts +429 -429
  111. package/src/ghlEventInquiry.ts +143 -143
  112. package/src/mailArrivalEmail.ts +121 -121
  113. package/src/manageToken.ts +363 -363
  114. package/src/membershipBusClient.ts +537 -537
  115. package/src/membershipWelcome.ts +683 -683
  116. package/src/migrationCheckout.ts +366 -366
  117. package/src/paymentLinkEmail.ts +123 -123
  118. package/src/signedUnpaidReminderEmail.test.ts +246 -246
  119. package/src/signedUnpaidReminderEmail.ts +132 -132
  120. package/src/stripeCoworkingPortal.ts +91 -91
  121. package/src/supabaseTestFakes.ts +131 -131
  122. package/src/supportTicketEmail.ts +119 -119
  123. package/src/unifiAccessPolicies.ts +228 -228
  124. package/src/unifiGroups.ts +129 -129
@@ -1,165 +1,165 @@
1
- import { createClient } from 'npm:@supabase/supabase-js@2';
2
- import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
3
- import { syncLumaGuestToGhl } from 'npm:@simplelayer/graniteer-core/lumaGhl';
4
-
5
- /**
6
- * Inbound Lu.ma webhook receiver.
7
- *
8
- * Receive → verify → log. No downstream dispatch yet: rows land in
9
- * `luma_webhook_events` with `processed = false` for a follow-up task to read.
10
- *
11
- * Signature scheme (https://help.luma.com/p/webhooks):
12
- * Webhook-Signature: t=<unix_ts>,v1=<hex_hmac_sha256>
13
- * HMAC-SHA256 over `${t}.${rawBody}` keyed with LUMA_WEBHOOK_SECRET.
14
- * Verified with Web Crypto (Deno has no Node `crypto` module).
15
- */
16
-
17
- const MAX_SKEW_SECONDS = 5 * 60;
18
-
19
- function json(status: number, body: unknown) {
20
- return new Response(JSON.stringify(body), {
21
- status,
22
- headers: { 'Content-Type': 'application/json' },
23
- });
24
- }
25
-
26
- function toHex(buf: ArrayBuffer): string {
27
- return Array.from(new Uint8Array(buf))
28
- .map((b) => b.toString(16).padStart(2, '0'))
29
- .join('');
30
- }
31
-
32
- /** Constant-time string compare (Web Crypto exposes no timingSafeEqual). */
33
- function timingSafeEqualHex(a: string, b: string): boolean {
34
- if (a.length !== b.length) return false;
35
- let acc = 0;
36
- for (let i = 0; i < a.length; i++) acc |= a.charCodeAt(i) ^ b.charCodeAt(i);
37
- return acc === 0;
38
- }
39
-
40
- // No CORS — this is called by Lu.ma, not the browser.
41
- export async function handle(req: Request): Promise<Response> {
42
- if (req.method !== 'POST') {
43
- return new Response('Method not allowed', { status: 405 });
44
- }
45
-
46
- // Raw text first: signature verification needs the exact bytes Lu.ma signed.
47
- const rawBody = await req.text();
48
-
49
- // Cast: the supabase-js generic defaults differ from logOps' inferred
50
- // client type; the same shim other functions use.
51
- const supabase = createClient(
52
- Deno.env.get('SUPABASE_URL')!,
53
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
54
- { auth: { persistSession: false, autoRefreshToken: false } },
55
- ) as unknown as Parameters<typeof logOps>[0];
56
-
57
- const webhookId = req.headers.get('Webhook-Id');
58
- const signatureHeader = req.headers.get('Webhook-Signature');
59
- const timestampHeader = req.headers.get('Webhook-Timestamp');
60
-
61
- const secret = Deno.env.get('LUMA_WEBHOOK_SECRET');
62
- if (!secret) {
63
- // Fail closed — never process an unverifiable request.
64
- await logOps(supabase, 'luma_webhook_not_configured', {}, { severity: 'error' });
65
- return json(500, { error: 'not_configured' });
66
- }
67
-
68
- const rejectSignature = async (reason: string) => {
69
- // Never log the secret or the computed/expected signature values.
70
- await logOps(
71
- supabase,
72
- 'luma_webhook_signature_invalid',
73
- { webhook_id: webhookId, reason },
74
- { severity: 'warning' },
75
- );
76
- return json(401, { error: 'invalid_signature' });
77
- };
78
-
79
- if (!signatureHeader || !webhookId) return await rejectSignature('missing_header');
80
-
81
- let t: string | null = null;
82
- let v1: string | null = null;
83
- for (const part of signatureHeader.split(',')) {
84
- const idx = part.indexOf('=');
85
- if (idx === -1) continue;
86
- const key = part.slice(0, idx).trim();
87
- const value = part.slice(idx + 1).trim();
88
- if (key === 't') t = value;
89
- else if (key === 'v1') v1 = value;
90
- }
91
- if (!t || !v1) return await rejectSignature('malformed_header');
92
-
93
- // Replay protection: reject stale or far-future timestamps.
94
- const tsRaw = timestampHeader ?? t;
95
- const ts = Number(tsRaw);
96
- if (!Number.isFinite(ts)) return await rejectSignature('bad_timestamp');
97
- const skew = Math.abs(Math.floor(Date.now() / 1000) - ts);
98
- if (skew > MAX_SKEW_SECONDS) return await rejectSignature('timestamp_out_of_window');
99
-
100
- const key = await crypto.subtle.importKey(
101
- 'raw',
102
- new TextEncoder().encode(secret),
103
- { name: 'HMAC', hash: 'SHA-256' },
104
- false,
105
- ['sign'],
106
- );
107
- const macBuf = await crypto.subtle.sign(
108
- 'HMAC',
109
- key,
110
- new TextEncoder().encode(`${t}.${rawBody}`),
111
- );
112
- const expected = toHex(macBuf);
113
-
114
- if (!timingSafeEqualHex(expected, v1.toLowerCase())) {
115
- return await rejectSignature('signature_mismatch');
116
- }
117
-
118
- // ---- Verified past this point ----
119
-
120
- let body: Record<string, unknown>;
121
- try {
122
- body = JSON.parse(rawBody) as Record<string, unknown>;
123
- } catch (e) {
124
- await logOps(
125
- supabase,
126
- 'luma_webhook_malformed_payload',
127
- { webhook_id: webhookId, message: (e instanceof Error ? e.message : String(e)).slice(0, 500) },
128
- { severity: 'error' },
129
- );
130
- return json(400, { error: 'malformed_payload' });
131
- }
132
-
133
- const eventType = typeof body.type === 'string' && body.type.length > 0 ? body.type : 'unknown';
134
-
135
- // Idempotency ledger — dedupe Lu.ma redeliveries (mirrors stripe_events).
136
- const { error: insertErr } = await supabase
137
- .from('luma_webhook_events')
138
- .insert({ webhook_id: webhookId, event_type: eventType, payload: body } as never);
139
-
140
- const code = (insertErr as { code?: string } | null)?.code;
141
- if (code === '23505') {
142
- return json(200, { received: true, duplicate: true });
143
- }
144
- if (insertErr) {
145
- await logOps(
146
- supabase,
147
- 'luma_webhook_insert_failed',
148
- { webhook_id: webhookId, event_type: eventType, message: insertErr.message },
149
- { severity: 'error' },
150
- );
151
- return json(500, { error: 'insert_failed' });
152
- }
153
-
154
- // Data-sync only: create/tag the CRM contact. Never sends a message; GHL
155
- // workflows fire off these tags. Only guest records reach GHL. Runs after
156
- // the idempotency insert so redeliveries (23505 above) never re-sync.
157
- if (eventType === 'guest.registered' || eventType === 'guest.updated') {
158
- await syncLumaGuestToGhl(body.data, eventType, supabase);
159
- }
160
-
161
- return new Response(JSON.stringify({ received: true }), {
162
- status: 200,
163
- headers: { 'Content-Type': 'application/json' },
164
- });
165
- }
1
+ import { createClient } from 'npm:@supabase/supabase-js@2';
2
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
3
+ import { syncLumaGuestToGhl } from 'npm:@simplelayer/graniteer-core/lumaGhl';
4
+
5
+ /**
6
+ * Inbound Lu.ma webhook receiver.
7
+ *
8
+ * Receive → verify → log. No downstream dispatch yet: rows land in
9
+ * `luma_webhook_events` with `processed = false` for a follow-up task to read.
10
+ *
11
+ * Signature scheme (https://help.luma.com/p/webhooks):
12
+ * Webhook-Signature: t=<unix_ts>,v1=<hex_hmac_sha256>
13
+ * HMAC-SHA256 over `${t}.${rawBody}` keyed with LUMA_WEBHOOK_SECRET.
14
+ * Verified with Web Crypto (Deno has no Node `crypto` module).
15
+ */
16
+
17
+ const MAX_SKEW_SECONDS = 5 * 60;
18
+
19
+ function json(status: number, body: unknown) {
20
+ return new Response(JSON.stringify(body), {
21
+ status,
22
+ headers: { 'Content-Type': 'application/json' },
23
+ });
24
+ }
25
+
26
+ function toHex(buf: ArrayBuffer): string {
27
+ return Array.from(new Uint8Array(buf))
28
+ .map((b) => b.toString(16).padStart(2, '0'))
29
+ .join('');
30
+ }
31
+
32
+ /** Constant-time string compare (Web Crypto exposes no timingSafeEqual). */
33
+ function timingSafeEqualHex(a: string, b: string): boolean {
34
+ if (a.length !== b.length) return false;
35
+ let acc = 0;
36
+ for (let i = 0; i < a.length; i++) acc |= a.charCodeAt(i) ^ b.charCodeAt(i);
37
+ return acc === 0;
38
+ }
39
+
40
+ // No CORS — this is called by Lu.ma, not the browser.
41
+ export async function handle(req: Request): Promise<Response> {
42
+ if (req.method !== 'POST') {
43
+ return new Response('Method not allowed', { status: 405 });
44
+ }
45
+
46
+ // Raw text first: signature verification needs the exact bytes Lu.ma signed.
47
+ const rawBody = await req.text();
48
+
49
+ // Cast: the supabase-js generic defaults differ from logOps' inferred
50
+ // client type; the same shim other functions use.
51
+ const supabase = createClient(
52
+ Deno.env.get('SUPABASE_URL')!,
53
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
54
+ { auth: { persistSession: false, autoRefreshToken: false } },
55
+ ) as unknown as Parameters<typeof logOps>[0];
56
+
57
+ const webhookId = req.headers.get('Webhook-Id');
58
+ const signatureHeader = req.headers.get('Webhook-Signature');
59
+ const timestampHeader = req.headers.get('Webhook-Timestamp');
60
+
61
+ const secret = Deno.env.get('LUMA_WEBHOOK_SECRET');
62
+ if (!secret) {
63
+ // Fail closed — never process an unverifiable request.
64
+ await logOps(supabase, 'luma_webhook_not_configured', {}, { severity: 'error' });
65
+ return json(500, { error: 'not_configured' });
66
+ }
67
+
68
+ const rejectSignature = async (reason: string) => {
69
+ // Never log the secret or the computed/expected signature values.
70
+ await logOps(
71
+ supabase,
72
+ 'luma_webhook_signature_invalid',
73
+ { webhook_id: webhookId, reason },
74
+ { severity: 'warning' },
75
+ );
76
+ return json(401, { error: 'invalid_signature' });
77
+ };
78
+
79
+ if (!signatureHeader || !webhookId) return await rejectSignature('missing_header');
80
+
81
+ let t: string | null = null;
82
+ let v1: string | null = null;
83
+ for (const part of signatureHeader.split(',')) {
84
+ const idx = part.indexOf('=');
85
+ if (idx === -1) continue;
86
+ const key = part.slice(0, idx).trim();
87
+ const value = part.slice(idx + 1).trim();
88
+ if (key === 't') t = value;
89
+ else if (key === 'v1') v1 = value;
90
+ }
91
+ if (!t || !v1) return await rejectSignature('malformed_header');
92
+
93
+ // Replay protection: reject stale or far-future timestamps.
94
+ const tsRaw = timestampHeader ?? t;
95
+ const ts = Number(tsRaw);
96
+ if (!Number.isFinite(ts)) return await rejectSignature('bad_timestamp');
97
+ const skew = Math.abs(Math.floor(Date.now() / 1000) - ts);
98
+ if (skew > MAX_SKEW_SECONDS) return await rejectSignature('timestamp_out_of_window');
99
+
100
+ const key = await crypto.subtle.importKey(
101
+ 'raw',
102
+ new TextEncoder().encode(secret),
103
+ { name: 'HMAC', hash: 'SHA-256' },
104
+ false,
105
+ ['sign'],
106
+ );
107
+ const macBuf = await crypto.subtle.sign(
108
+ 'HMAC',
109
+ key,
110
+ new TextEncoder().encode(`${t}.${rawBody}`),
111
+ );
112
+ const expected = toHex(macBuf);
113
+
114
+ if (!timingSafeEqualHex(expected, v1.toLowerCase())) {
115
+ return await rejectSignature('signature_mismatch');
116
+ }
117
+
118
+ // ---- Verified past this point ----
119
+
120
+ let body: Record<string, unknown>;
121
+ try {
122
+ body = JSON.parse(rawBody) as Record<string, unknown>;
123
+ } catch (e) {
124
+ await logOps(
125
+ supabase,
126
+ 'luma_webhook_malformed_payload',
127
+ { webhook_id: webhookId, message: (e instanceof Error ? e.message : String(e)).slice(0, 500) },
128
+ { severity: 'error' },
129
+ );
130
+ return json(400, { error: 'malformed_payload' });
131
+ }
132
+
133
+ const eventType = typeof body.type === 'string' && body.type.length > 0 ? body.type : 'unknown';
134
+
135
+ // Idempotency ledger — dedupe Lu.ma redeliveries (mirrors stripe_events).
136
+ const { error: insertErr } = await supabase
137
+ .from('luma_webhook_events')
138
+ .insert({ webhook_id: webhookId, event_type: eventType, payload: body } as never);
139
+
140
+ const code = (insertErr as { code?: string } | null)?.code;
141
+ if (code === '23505') {
142
+ return json(200, { received: true, duplicate: true });
143
+ }
144
+ if (insertErr) {
145
+ await logOps(
146
+ supabase,
147
+ 'luma_webhook_insert_failed',
148
+ { webhook_id: webhookId, event_type: eventType, message: insertErr.message },
149
+ { severity: 'error' },
150
+ );
151
+ return json(500, { error: 'insert_failed' });
152
+ }
153
+
154
+ // Data-sync only: create/tag the CRM contact. Never sends a message; GHL
155
+ // workflows fire off these tags. Only guest records reach GHL. Runs after
156
+ // the idempotency insert so redeliveries (23505 above) never re-sync.
157
+ if (eventType === 'guest.registered' || eventType === 'guest.updated') {
158
+ await syncLumaGuestToGhl(body.data, eventType, supabase);
159
+ }
160
+
161
+ return new Response(JSON.stringify({ received: true }), {
162
+ status: 200,
163
+ headers: { 'Content-Type': 'application/json' },
164
+ });
165
+ }
@@ -1,67 +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
- }
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
+ }