@simplelayer/graniteer-core 0.1.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. package/index.js +2 -2
  2. package/package.json +73 -2
  3. package/src/agreementCheckout.ts +250 -0
  4. package/src/agreementPortalEmail.ts +128 -0
  5. package/src/billingPortalLinkEmail.ts +117 -0
  6. package/src/bookingAgreementEmail.ts +149 -0
  7. package/src/bookingEffects.ts +388 -0
  8. package/src/busClient.ts +268 -0
  9. package/src/busSignature.ts +71 -0
  10. package/src/checkoutCoupon.test.ts +675 -0
  11. package/src/checkoutCoupon.ts +455 -0
  12. package/src/commonsDeposit.ts +298 -0
  13. package/src/commonsDepositWebhook.ts +237 -0
  14. package/src/dayPassConfirmation.ts +230 -0
  15. package/src/dunningEmails.test.ts +263 -0
  16. package/src/dunningEmails.ts +203 -0
  17. package/src/email-templates/brand.ts +93 -0
  18. package/src/email-templates/magic-link.tsx +59 -0
  19. package/src/email-templates/recovery.tsx +59 -0
  20. package/src/email-templates/signup.tsx +67 -0
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -308
  23. package/src/functions/admin-charge-guest-print.ts +229 -229
  24. package/src/functions/admin-correct-booking.ts +333 -333
  25. package/src/functions/admin-create-booking.ts +460 -0
  26. package/src/functions/admin-create-commons-event.ts +244 -244
  27. package/src/functions/admin-debug-boldsign-doc.ts +93 -93
  28. package/src/functions/admin-door-write.ts +272 -272
  29. package/src/functions/admin-issue-day-pass.ts +231 -0
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -0
  32. package/src/functions/admin-mint-portal-link.ts +62 -0
  33. package/src/functions/admin-photo-upload.ts +128 -128
  34. package/src/functions/admin-remove-team-member.ts +150 -150
  35. package/src/functions/admin-request-trial.ts +366 -0
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -0
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.test.ts +567 -0
  39. package/src/functions/admin-retry-invoice-payment.ts +333 -0
  40. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  41. package/src/functions/admin-revoke-agreement.ts +467 -0
  42. package/src/functions/admin-send-commons-agreement.ts +214 -214
  43. package/src/functions/admin-set-credit-amount.ts +123 -123
  44. package/src/functions/admin-skip-commons-contract.ts +165 -165
  45. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  46. package/src/functions/admin-wall-photo-write.ts +141 -141
  47. package/src/functions/auth-email-hook.ts +259 -0
  48. package/src/functions/boldsign-sender-identity.ts +114 -114
  49. package/src/functions/booking-availability.ts +419 -419
  50. package/src/functions/booking-member-preview.ts +136 -136
  51. package/src/functions/booking-status.ts +149 -0
  52. package/src/functions/conductor.ts +505 -0
  53. package/src/functions/create-agreement.ts +537 -0
  54. package/src/functions/create-booking.ts +648 -0
  55. package/src/functions/create-day-pass-checkout.ts +218 -0
  56. package/src/functions/create-portal-session.ts +142 -0
  57. package/src/functions/create-subscription-checkout.test.ts +222 -0
  58. package/src/functions/create-subscription-checkout.ts +440 -0
  59. package/src/functions/day-pass-status.ts +89 -89
  60. package/src/functions/diag-webpush-test.ts +45 -45
  61. package/src/functions/event-access-admin.ts +277 -0
  62. package/src/functions/event-access-store.ts +309 -309
  63. package/src/functions/ezeep-print-webhook.ts +213 -213
  64. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  65. package/src/functions/fetch-avatar-original.ts +457 -0
  66. package/src/functions/get-provider-sign-link.ts +155 -0
  67. package/src/functions/get-signing-link.ts +211 -211
  68. package/src/functions/guest-print-setup-confirm.ts +128 -128
  69. package/src/functions/guest-print-submit.ts +149 -149
  70. package/src/functions/luma-webhook.ts +165 -165
  71. package/src/functions/manage-booking.ts +472 -0
  72. package/src/functions/mcp.ts +67 -0
  73. package/src/functions/member-door-action.test.ts +1248 -0
  74. package/src/functions/member-door-action.ts +863 -0
  75. package/src/functions/member-unifi-mapping.test.ts +516 -0
  76. package/src/functions/member-unifi-mapping.ts +206 -0
  77. package/src/functions/membership-door-sync.ts +956 -0
  78. package/src/functions/migration-collision-alert.copy.ts +232 -232
  79. package/src/functions/migration-collision-alert.test.ts +349 -349
  80. package/src/functions/migration-collision-alert.ts +232 -232
  81. package/src/functions/office-assignment-end.ts +146 -146
  82. package/src/functions/portal-booking-access.ts +95 -95
  83. package/src/functions/portal-list-invoices.ts +99 -99
  84. package/src/functions/portal-request-login.ts +192 -0
  85. package/src/functions/portal-resend-invite.ts +248 -0
  86. package/src/functions/portal-submit-event.ts +168 -0
  87. package/src/functions/print-billing-recover.ts +97 -97
  88. package/src/functions/print-billing-run.ts +183 -183
  89. package/src/functions/public-facts.ts +168 -168
  90. package/src/functions/push-send.ts +348 -0
  91. package/src/functions/push-test.ts +234 -0
  92. package/src/functions/request-portal-link.ts +211 -0
  93. package/src/functions/reschedule-booking.ts +649 -0
  94. package/src/functions/review-ratings.ts +113 -0
  95. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  96. package/src/functions/space-availability-range.ts +142 -142
  97. package/src/functions/stripe-db-reconcile.ts +319 -0
  98. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  99. package/src/functions/stripe-webhook.ts +2595 -0
  100. package/src/functions/sync-gcal-blackouts.ts +298 -298
  101. package/src/functions/timetable-event-register.ts +162 -162
  102. package/src/functions/timetable-event-status.ts +90 -90
  103. package/src/functions/timetable-spaces.ts +219 -219
  104. package/src/functions/touch-pass-reconciler.ts +689 -689
  105. package/src/functions/touch-pass-signup.ts +478 -0
  106. package/src/functions/upload-booking-display-image.ts +179 -0
  107. package/src/functions/virtual-onboarding-purge.ts +134 -134
  108. package/src/functions/virtual-onboarding-submit.ts +315 -315
  109. package/src/functions/voice-booking.ts +453 -0
  110. package/src/functions/voice-day-pass.ts +346 -0
  111. package/src/functions/voice-inquiry.test.ts +301 -301
  112. package/src/functions/voice-inquiry.ts +198 -198
  113. package/src/functions/voice-membership-signup.ts +355 -0
  114. package/src/functions/voice-tour-availability.ts +204 -204
  115. package/src/functions/voice-tour-booking.ts +429 -0
  116. package/src/ghlEventInquiry.ts +143 -0
  117. package/src/mailArrivalEmail.ts +121 -0
  118. package/src/manageToken.ts +363 -0
  119. package/src/membershipBusClient.ts +537 -0
  120. package/src/membershipWelcome.ts +683 -0
  121. package/src/migrationCheckout.ts +366 -0
  122. package/src/pacificDate.ts +54 -0
  123. package/src/paymentLinkEmail.ts +123 -0
  124. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  125. package/src/signedUnpaidReminderEmail.ts +132 -0
  126. package/src/stripeCoworkingPortal.ts +91 -0
  127. package/src/supabaseTestFakes.ts +131 -131
  128. package/src/supportTicketEmail.ts +119 -0
  129. package/src/unifiAccessPolicies.ts +228 -0
  130. package/src/unifiGroups.ts +129 -0
@@ -1,131 +1,131 @@
1
- // TEST-ONLY recording fake for a Supabase/PostgREST client.
2
- //
3
- // Generic — no tenant or feature-specific knowledge. Implements no transport
4
- // of any kind: no fetch, no sockets. Extracted 2026-09-15 from what was
5
- // migrationCheckoutFakes.ts, which bundled this generic Supabase double with
6
- // migration-checkout-specific Stripe fakes; the Stripe half (and the whole
7
- // migration-checkout feature) was dropped from this package per a Kyle
8
- // decision (migrationCheckout* stays GC-only, not ported to core) — this
9
- // file is the reusable part that survived the split.
10
-
11
- export interface RecordedDbCall {
12
- table: string;
13
- op: 'select' | 'insert' | 'update' | 'delete' | 'none';
14
- columns?: string;
15
- payload?: unknown;
16
- filters: Array<{ kind: string; args: unknown[] }>;
17
- terminal: string;
18
- }
19
-
20
- export interface RecordedRpcCall {
21
- fn: string;
22
- args: unknown;
23
- }
24
-
25
- export interface DbResult {
26
- data: unknown;
27
- error: { message: string; code?: string } | null;
28
- }
29
-
30
- export type DbResponder = (call: RecordedDbCall) => DbResult;
31
- export type RpcResponder = (call: RecordedRpcCall) => DbResult;
32
-
33
- const OK: DbResult = { data: null, error: null };
34
-
35
- class FakeQuery implements PromiseLike<DbResult> {
36
- private settled: Promise<DbResult> | null = null;
37
-
38
- constructor(
39
- private rec: RecordedDbCall,
40
- private responder: DbResponder,
41
- private log: RecordedDbCall[],
42
- ) {}
43
-
44
- select(columns?: string): this { this.rec.op = 'select'; this.rec.columns = columns; return this; }
45
- insert(payload: unknown): this { this.rec.op = 'insert'; this.rec.payload = payload; return this; }
46
- update(payload: unknown): this { this.rec.op = 'update'; this.rec.payload = payload; return this; }
47
- delete(): this { this.rec.op = 'delete'; return this; }
48
-
49
- eq(...args: unknown[]): this { this.rec.filters.push({ kind: 'eq', args }); return this; }
50
- neq(...args: unknown[]): this { this.rec.filters.push({ kind: 'neq', args }); return this; }
51
- not(...args: unknown[]): this { this.rec.filters.push({ kind: 'not', args }); return this; }
52
- in(...args: unknown[]): this { this.rec.filters.push({ kind: 'in', args }); return this; }
53
- gt(...args: unknown[]): this { this.rec.filters.push({ kind: 'gt', args }); return this; }
54
- gte(...args: unknown[]): this { this.rec.filters.push({ kind: 'gte', args }); return this; }
55
- lt(...args: unknown[]): this { this.rec.filters.push({ kind: 'lt', args }); return this; }
56
- order(...args: unknown[]): this { this.rec.filters.push({ kind: 'order', args }); return this; }
57
- limit(...args: unknown[]): this { this.rec.filters.push({ kind: 'limit', args }); return this; }
58
-
59
- maybeSingle(): Promise<DbResult> { this.rec.terminal = 'maybeSingle'; return this.resolve(); }
60
- single(): Promise<DbResult> { this.rec.terminal = 'single'; return this.resolve(); }
61
-
62
- then<R1 = DbResult, R2 = never>(
63
- onOk?: ((v: DbResult) => R1 | PromiseLike<R1>) | null,
64
- onErr?: ((e: unknown) => R2 | PromiseLike<R2>) | null,
65
- ): PromiseLike<R1 | R2> {
66
- return this.resolve().then(onOk, onErr);
67
- }
68
-
69
- private resolve(): Promise<DbResult> {
70
- if (!this.settled) {
71
- this.log.push(this.rec);
72
- let out: DbResult;
73
- try {
74
- out = this.responder(this.rec) ?? OK;
75
- } catch (e) {
76
- return Promise.reject(e);
77
- }
78
- this.settled = Promise.resolve(out);
79
- }
80
- return this.settled;
81
- }
82
- }
83
-
84
- export interface FakeSupabase {
85
- from(table: string): FakeQuery;
86
- rpc(fn: string, args?: unknown): Promise<DbResult>;
87
- /** Every PostgREST call made, in order. */
88
- readonly dbCalls: RecordedDbCall[];
89
- /** Every .rpc() call made, in order. */
90
- readonly rpcCalls: RecordedRpcCall[];
91
- /** Convenience: db calls against one table. */
92
- callsTo(table: string): RecordedDbCall[];
93
- /** Convenience: writes (insert/update/delete) against one table. */
94
- writesTo(table: string): RecordedDbCall[];
95
- }
96
-
97
- export function makeFakeSupabase(opts: {
98
- db?: DbResponder;
99
- rpc?: RpcResponder;
100
- } = {}): FakeSupabase {
101
- const dbCalls: RecordedDbCall[] = [];
102
- const rpcCalls: RecordedRpcCall[] = [];
103
- const db = opts.db ?? (() => OK);
104
- const rpc = opts.rpc ?? (() => OK);
105
-
106
- return {
107
- dbCalls,
108
- rpcCalls,
109
- from(table: string) {
110
- return new FakeQuery(
111
- { table, op: 'none', filters: [], terminal: 'await' },
112
- db,
113
- dbCalls,
114
- );
115
- },
116
- rpc(fn: string, args?: unknown) {
117
- const call: RecordedRpcCall = { fn, args };
118
- rpcCalls.push(call);
119
- return Promise.resolve(rpc(call) ?? OK);
120
- },
121
- callsTo(table: string) { return dbCalls.filter((c) => c.table === table); },
122
- writesTo(table: string) {
123
- return dbCalls.filter((c) => c.table === table && c.op !== 'select' && c.op !== 'none');
124
- },
125
- };
126
- }
127
-
128
- /** Reads the value an `update` payload set for one column, or `undefined`. */
129
- export function updatedValue(call: RecordedDbCall, column: string): unknown {
130
- return (call.payload as Record<string, unknown> | undefined)?.[column];
131
- }
1
+ // TEST-ONLY recording fake for a Supabase/PostgREST client.
2
+ //
3
+ // Generic — no tenant or feature-specific knowledge. Implements no transport
4
+ // of any kind: no fetch, no sockets. Extracted 2026-09-15 from what was
5
+ // migrationCheckoutFakes.ts, which bundled this generic Supabase double with
6
+ // migration-checkout-specific Stripe fakes; the Stripe half (and the whole
7
+ // migration-checkout feature) was dropped from this package per a Kyle
8
+ // decision (migrationCheckout* stays GC-only, not ported to core) — this
9
+ // file is the reusable part that survived the split.
10
+
11
+ export interface RecordedDbCall {
12
+ table: string;
13
+ op: 'select' | 'insert' | 'update' | 'delete' | 'none';
14
+ columns?: string;
15
+ payload?: unknown;
16
+ filters: Array<{ kind: string; args: unknown[] }>;
17
+ terminal: string;
18
+ }
19
+
20
+ export interface RecordedRpcCall {
21
+ fn: string;
22
+ args: unknown;
23
+ }
24
+
25
+ export interface DbResult {
26
+ data: unknown;
27
+ error: { message: string; code?: string } | null;
28
+ }
29
+
30
+ export type DbResponder = (call: RecordedDbCall) => DbResult;
31
+ export type RpcResponder = (call: RecordedRpcCall) => DbResult;
32
+
33
+ const OK: DbResult = { data: null, error: null };
34
+
35
+ class FakeQuery implements PromiseLike<DbResult> {
36
+ private settled: Promise<DbResult> | null = null;
37
+
38
+ constructor(
39
+ private rec: RecordedDbCall,
40
+ private responder: DbResponder,
41
+ private log: RecordedDbCall[],
42
+ ) {}
43
+
44
+ select(columns?: string): this { this.rec.op = 'select'; this.rec.columns = columns; return this; }
45
+ insert(payload: unknown): this { this.rec.op = 'insert'; this.rec.payload = payload; return this; }
46
+ update(payload: unknown): this { this.rec.op = 'update'; this.rec.payload = payload; return this; }
47
+ delete(): this { this.rec.op = 'delete'; return this; }
48
+
49
+ eq(...args: unknown[]): this { this.rec.filters.push({ kind: 'eq', args }); return this; }
50
+ neq(...args: unknown[]): this { this.rec.filters.push({ kind: 'neq', args }); return this; }
51
+ not(...args: unknown[]): this { this.rec.filters.push({ kind: 'not', args }); return this; }
52
+ in(...args: unknown[]): this { this.rec.filters.push({ kind: 'in', args }); return this; }
53
+ gt(...args: unknown[]): this { this.rec.filters.push({ kind: 'gt', args }); return this; }
54
+ gte(...args: unknown[]): this { this.rec.filters.push({ kind: 'gte', args }); return this; }
55
+ lt(...args: unknown[]): this { this.rec.filters.push({ kind: 'lt', args }); return this; }
56
+ order(...args: unknown[]): this { this.rec.filters.push({ kind: 'order', args }); return this; }
57
+ limit(...args: unknown[]): this { this.rec.filters.push({ kind: 'limit', args }); return this; }
58
+
59
+ maybeSingle(): Promise<DbResult> { this.rec.terminal = 'maybeSingle'; return this.resolve(); }
60
+ single(): Promise<DbResult> { this.rec.terminal = 'single'; return this.resolve(); }
61
+
62
+ then<R1 = DbResult, R2 = never>(
63
+ onOk?: ((v: DbResult) => R1 | PromiseLike<R1>) | null,
64
+ onErr?: ((e: unknown) => R2 | PromiseLike<R2>) | null,
65
+ ): PromiseLike<R1 | R2> {
66
+ return this.resolve().then(onOk, onErr);
67
+ }
68
+
69
+ private resolve(): Promise<DbResult> {
70
+ if (!this.settled) {
71
+ this.log.push(this.rec);
72
+ let out: DbResult;
73
+ try {
74
+ out = this.responder(this.rec) ?? OK;
75
+ } catch (e) {
76
+ return Promise.reject(e);
77
+ }
78
+ this.settled = Promise.resolve(out);
79
+ }
80
+ return this.settled;
81
+ }
82
+ }
83
+
84
+ export interface FakeSupabase {
85
+ from(table: string): FakeQuery;
86
+ rpc(fn: string, args?: unknown): Promise<DbResult>;
87
+ /** Every PostgREST call made, in order. */
88
+ readonly dbCalls: RecordedDbCall[];
89
+ /** Every .rpc() call made, in order. */
90
+ readonly rpcCalls: RecordedRpcCall[];
91
+ /** Convenience: db calls against one table. */
92
+ callsTo(table: string): RecordedDbCall[];
93
+ /** Convenience: writes (insert/update/delete) against one table. */
94
+ writesTo(table: string): RecordedDbCall[];
95
+ }
96
+
97
+ export function makeFakeSupabase(opts: {
98
+ db?: DbResponder;
99
+ rpc?: RpcResponder;
100
+ } = {}): FakeSupabase {
101
+ const dbCalls: RecordedDbCall[] = [];
102
+ const rpcCalls: RecordedRpcCall[] = [];
103
+ const db = opts.db ?? (() => OK);
104
+ const rpc = opts.rpc ?? (() => OK);
105
+
106
+ return {
107
+ dbCalls,
108
+ rpcCalls,
109
+ from(table: string) {
110
+ return new FakeQuery(
111
+ { table, op: 'none', filters: [], terminal: 'await' },
112
+ db,
113
+ dbCalls,
114
+ );
115
+ },
116
+ rpc(fn: string, args?: unknown) {
117
+ const call: RecordedRpcCall = { fn, args };
118
+ rpcCalls.push(call);
119
+ return Promise.resolve(rpc(call) ?? OK);
120
+ },
121
+ callsTo(table: string) { return dbCalls.filter((c) => c.table === table); },
122
+ writesTo(table: string) {
123
+ return dbCalls.filter((c) => c.table === table && c.op !== 'select' && c.op !== 'none');
124
+ },
125
+ };
126
+ }
127
+
128
+ /** Reads the value an `update` payload set for one column, or `undefined`. */
129
+ export function updatedValue(call: RecordedDbCall, column: string): unknown {
130
+ return (call.payload as Record<string, unknown> | undefined)?.[column];
131
+ }
@@ -0,0 +1,119 @@
1
+ // Best-effort email to the platform operator (Kyle) when an admin/owner/
2
+ // door-ops staff member files a support ticket via support-ticket-submit.
3
+ //
4
+ // Mirrors the transport, escaping, error classification and never-throws
5
+ // contract of sendBillingPortalLinkEmail in ./billingPortalLinkEmail.ts --
6
+ // same GHL upsert-then-send shape, different recipient (the platform
7
+ // operator's own inbox, operator.platformSupportEmail) and copy.
8
+ //
9
+ // NOTE: the platform support inbox may not have a mailbox provisioned yet,
10
+ // so this send is expected to bounce/fail for some tenants. That must never
11
+ // block or fail ticket creation -- see the ok:true/ok:false result shape
12
+ // below and its only caller, support-ticket-submit/index.ts.
13
+
14
+ import type { SupabaseClient } from 'npm:@supabase/supabase-js@2';
15
+ import { logOps } from './ops.ts';
16
+
17
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
18
+
19
+ export type SupportTicketEmailResult = 'sent' | 'skipped' | 'failed_retryable' | 'failed_permanent';
20
+
21
+ function esc(v: unknown): string {
22
+ return String(v ?? '')
23
+ .replace(/&/g, '&amp;')
24
+ .replace(/</g, '&lt;')
25
+ .replace(/>/g, '&gt;')
26
+ .replace(/"/g, '&quot;')
27
+ .replace(/'/g, '&#39;');
28
+ }
29
+
30
+ function classifyError(e: unknown): 'failed_retryable' | 'failed_permanent' {
31
+ const name = e instanceof Error ? e.name : '';
32
+ if (name === 'AbortError' || name === 'TimeoutError') return 'failed_retryable';
33
+ const msg = e instanceof Error ? e.message : String(e);
34
+ const m = msg.match(/^ghl_(?:upsert|email)_(\d{3})/);
35
+ if (m) {
36
+ const code = Number(m[1]);
37
+ if (code === 429 || code >= 500) return 'failed_retryable';
38
+ }
39
+ return 'failed_permanent';
40
+ }
41
+
42
+ export async function sendSupportTicketEmail(
43
+ supabase: SupabaseLike,
44
+ { ticketId, submitterName, submitterEmail, subject, message }: {
45
+ ticketId: string;
46
+ submitterName: string;
47
+ submitterEmail: string;
48
+ subject: string;
49
+ message: string;
50
+ },
51
+ operator: { name: string; shortName: string; domain: string; platformSupportEmail: string },
52
+ ): Promise<SupportTicketEmailResult> {
53
+ try {
54
+ const apiKey = Deno.env.get('GHL_API_KEY');
55
+ const locationId = Deno.env.get('GHL_LOCATION_ID');
56
+ if (!apiKey || !locationId) {
57
+ await logOps(supabase, 'support_ticket_email_skipped',
58
+ { ticket_id: ticketId, reason: 'ghl_not_configured' }, { severity: 'warning' }).catch(() => {});
59
+ return 'skipped';
60
+ }
61
+ const GHL_BASE = 'https://services.leadconnectorhq.com';
62
+ const headers = {
63
+ Authorization: `Bearer ${apiKey}`,
64
+ Version: '2021-07-28',
65
+ 'Content-Type': 'application/json',
66
+ Accept: 'application/json',
67
+ };
68
+
69
+ const upRes = await fetch(`${GHL_BASE}/contacts/upsert`, {
70
+ method: 'POST', headers,
71
+ signal: AbortSignal.timeout(8000),
72
+ body: JSON.stringify({
73
+ locationId,
74
+ email: operator.platformSupportEmail,
75
+ source: `${operator.shortName} Admin — Support Ticket`,
76
+ tags: ['Support Ticket', operator.domain],
77
+ }),
78
+ });
79
+ if (!upRes.ok) throw new Error(`ghl_upsert_${upRes.status}: ${await upRes.text()}`);
80
+ const upJson = await upRes.json();
81
+ const contactId = upJson.contact?.id || upJson.id || null;
82
+ if (!contactId) throw new Error('ghl_upsert_no_contact_id');
83
+
84
+ const p = (t: string) =>
85
+ `<p style="margin:0 0 8px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px">${t}</p>`;
86
+
87
+ const html = `<div style="background:#F6F6F6;padding:24px 0;margin:0"><table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;background:#F6F6F6"><tr><td align="center" style="padding:0 12px"><table role="presentation" width="560" cellpadding="0" cellspacing="0" border="0" style="border-collapse:collapse;max-width:560px;width:100%;background:#FFFFFF;border-radius:10px"><tr><td style="padding:24px">
88
+ <h2 style="margin:0 0 12px 0;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:22px">New support ticket — ${esc(operator.name)}</h2>
89
+ ${p(`<strong>From:</strong> ${esc(submitterName)} &lt;${esc(submitterEmail)}&gt;`)}
90
+ ${p(`<strong>Subject:</strong> ${esc(subject)}`)}
91
+ ${p(`<strong>Ticket:</strong> ${esc(ticketId)}`)}
92
+ <div style="margin:12px 0;padding:12px;background:#F6F6F6;border-radius:6px;color:#22263B;font-family:Inter,Arial,sans-serif;font-size:14px;line-height:22px;white-space:pre-wrap">${esc(message)}</div>
93
+ ${p(`Manage this ticket at <a href="https://${esc(operator.domain)}/admin/support-tickets/" style="color:#C98A5E">/admin/support-tickets/</a>.`)}
94
+ </td></tr></table></td></tr></table></div>`;
95
+
96
+ const emailRes = await fetch(`${GHL_BASE}/conversations/messages`, {
97
+ method: 'POST', headers,
98
+ signal: AbortSignal.timeout(8000),
99
+ body: JSON.stringify({
100
+ type: 'Email',
101
+ contactId,
102
+ subject: `[Support Ticket] ${subject}`,
103
+ html,
104
+ }),
105
+ });
106
+ if (!emailRes.ok) throw new Error(`ghl_email_${emailRes.status}: ${await emailRes.text()}`);
107
+
108
+ await logOps(supabase, 'support_ticket_email_sent', { ticket_id: ticketId }, { severity: 'info' }).catch(() => {});
109
+ return 'sent';
110
+ } catch (e) {
111
+ const classification = classifyError(e);
112
+ await logOps(supabase, 'support_ticket_email_failed',
113
+ { ticket_id: ticketId, message: e instanceof Error ? e.message : String(e) },
114
+ // Expected to fail until the platform support inbox has a mailbox --
115
+ // warning, not error, so this doesn't page anyone for a known, accepted gap.
116
+ { severity: 'warning' }).catch(() => {});
117
+ return classification;
118
+ }
119
+ }
@@ -0,0 +1,228 @@
1
+ // READ-ONLY UniFi Access-Policy mirror.
2
+ //
3
+ // D33 Phase 0.5 / Phase 10 batch 1: the generic half of gc-connect's
4
+ // _shared/unifiAccessPolicies.ts. The tenant layer keeps only its transport
5
+ // identity (bus origin, `source`) and the names of its own env gates, passed in
6
+ // as the `config` parameter. The signed message, header names, redirect policy,
7
+ // group-id validation, timeout, every `note` string and the B1 all-entries-
8
+ // unparseable rule are unchanged from the pre-split file.
9
+ //
10
+ // Companion to unifiGroups.ts. Same non-negotiable rule: the tenant's edge
11
+ // functions never talk to UniFi Access directly. This module asks the middleware
12
+ // for the Access Policies bound to a UniFi group and nothing else. It performs
13
+ // ZERO writes to UniFi, the middleware, or any business table -- no UniFi write
14
+ // endpoint, ever, and it does not even know how to construct a write request.
15
+ // A future change that made this module call a UniFi Access endpoint itself
16
+ // would be an architecture violation, not a refactor: the indirection through
17
+ // `config.busBase` IS the design.
18
+ //
19
+ // (Note carried over from the pre-split file: this module writes nothing to the
20
+ // database either, but a caller's own rate-limit check -- checkRateLimit in
21
+ // rateLimit.ts, run before this function is invoked -- can write an `ops_events`
22
+ // row via logOps() if the check_rate_limit RPC errors or throws, in addition to
23
+ // the rate-limit counter's own RPC increment. Both remain benign internal
24
+ // bookkeeping, unrelated to groups/policies/doors, and neither is an exception
25
+ // to the "no writes to UniFi, the middleware, or any business table" rule.)
26
+ //
27
+ // Gated by its OWN feature flag (config.env.mirrorEnabledFlag) -- deliberately
28
+ // NOT the shared bus flag that unifiGroups.ts's live path and
29
+ // membershipBusClient.ts's write-capable sync/enforce/revoke calls also key off.
30
+ // Reusing that flag would mean enabling this read-only mirror could also
31
+ // silently arm the live group-list path and the sync/enforce/revoke bus client
32
+ // -- exactly the "one flag secretly arms two things" mistake
33
+ // membershipBusClient.ts itself warns against for its own separate
34
+ // enforce/revoke flags.
35
+ //
36
+ // Contract (mirrors unifiGroups.ts's /membership/groups contract exactly,
37
+ // same header-borne-signature reasoning, a DISTINCT secret per that file's own
38
+ // "two unrelated authorities never share one key" rule):
39
+ // GET {config.busBase}/membership/groups/{group_id}/access_policies
40
+ // headers: x-gc-source, x-gc-generated-at, x-gc-signature
41
+ // message signed = "ap1\n{source}\n{group_id}\n{generated_at}" under
42
+ // config.env.secret
43
+ //
44
+ // KNOWN GAP AS OF THIS WRITING (2026-09-09, carried over from the pre-split
45
+ // file): this middleware endpoint does NOT exist yet in ftw-middleware -- there
46
+ // is no "/membership/groups" GET route of any kind, meaning unifiGroups.ts's own
47
+ // fromMiddleware() path is ALSO unreachable in production today. This is a
48
+ // pre-existing gap, not something the split introduces. Until the middleware
49
+ // implements both endpoints, a screen built on this will always show
50
+ // source:'unavailable' against real UniFi data -- that is the HONEST behavior
51
+ // (never fabricate policy data), not a bug in this file. The middleware side is
52
+ // a SEPARATE codebase/deploy pipeline (a droplet service tied to physical door
53
+ // hardware) and is deliberately NOT touched by this change.
54
+ //
55
+ // The real UniFi Access API call the middleware would make on the other end
56
+ // of this contract is `GET /user_groups/{id}/access_policies` -- the only
57
+ // correct way to read a group's policy bindings, confirmed working read-only,
58
+ // and UNRELATED to and safe alongside the destructive
59
+ // `PUT /user_groups/{id}/access_policies` (full-replace) write path that the
60
+ // admin door-write function uses. Nothing in this file, or anything it calls,
61
+ // ever issues that PUT.
62
+
63
+ import { signBusMessage } from './busSignature.ts';
64
+
65
+ const TIMEOUT_MS = 15_000;
66
+
67
+ /** The tenant's transport identity and env gates for the policy-list read. */
68
+ export interface UnifiAccessPoliciesConfig {
69
+ /** Origin of the tenant's middleware, e.g. https://bus.example.com. No trailing slash. */
70
+ busBase: string;
71
+ /** Transport identity signed into the "ap1" message and sent as x-gc-source. */
72
+ source: string;
73
+ env: {
74
+ /**
75
+ * Env var gating this read-only mirror. MUST be its own variable, never the
76
+ * shared bus flag -- see the module note above.
77
+ */
78
+ mirrorEnabledFlag: string;
79
+ /** Env var holding this endpoint's OWN HMAC secret (never the sync secret). */
80
+ secret: string;
81
+ };
82
+ }
83
+
84
+ export interface AccessPolicy {
85
+ id: string;
86
+ name: string;
87
+ schedule_id?: string;
88
+ schedule_name?: string;
89
+ }
90
+
91
+ export interface GroupAccessPolicies {
92
+ group_id: string;
93
+ source: 'unifi_live' | 'unavailable';
94
+ policies: AccessPolicy[];
95
+ note?: string;
96
+ }
97
+
98
+ // A UniFi group id must be a plain opaque token -- reject anything else
99
+ // before it ever reaches the signed message below. Without this, a caller
100
+ // could embed '\n' in a group id and desynchronize the signed canonical
101
+ // message ("ap1\n{source}\n{group_id}\n{generated_at}") from the actual URL
102
+ // path (which IS percent-encoded), even though nothing exploitable follows
103
+ // from that today given the aal2+allowlist gate callers put in front of this.
104
+ const GROUP_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
105
+
106
+ async function fetchOneGroup(
107
+ groupId: string,
108
+ config: UnifiAccessPoliciesConfig,
109
+ ): Promise<GroupAccessPolicies> {
110
+ if (!GROUP_ID_PATTERN.test(groupId)) {
111
+ return {
112
+ group_id: groupId,
113
+ source: 'unavailable',
114
+ policies: [],
115
+ note: 'Invalid group id format — refusing to query the middleware.',
116
+ };
117
+ }
118
+ if (Deno.env.get(config.env.mirrorEnabledFlag) !== 'true') {
119
+ return {
120
+ group_id: groupId,
121
+ source: 'unavailable',
122
+ policies: [],
123
+ note: 'Access-Policy mirror disabled — live UniFi Access-Policy data unavailable.',
124
+ };
125
+ }
126
+ const secret = Deno.env.get(config.env.secret);
127
+ if (!secret) {
128
+ return {
129
+ group_id: groupId,
130
+ source: 'unavailable',
131
+ policies: [],
132
+ note: `${config.env.secret} not configured — live UniFi Access-Policy data unavailable.`,
133
+ };
134
+ }
135
+ try {
136
+ const generatedAt = new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
137
+ const hmac = await signBusMessage(['ap1', config.source, groupId, generatedAt].join('\n'), secret);
138
+ const res = await fetch(
139
+ `${config.busBase}/membership/groups/${encodeURIComponent(groupId)}/access_policies`,
140
+ {
141
+ method: 'GET',
142
+ headers: {
143
+ 'x-gc-source': config.source,
144
+ 'x-gc-generated-at': generatedAt,
145
+ 'x-gc-signature': hmac,
146
+ },
147
+ // S5 (adversarial review, round 1): a cross-origin redirect does NOT
148
+ // carry the Authorization header forward, but it DOES carry an
149
+ // ordinary custom header like x-gc-signature -- so an unexpected
150
+ // redirect here would leak this request's HMAC to whatever origin
151
+ // issued it. 'error' refuses to follow any redirect at all.
152
+ redirect: 'error',
153
+ signal: AbortSignal.timeout(TIMEOUT_MS),
154
+ },
155
+ );
156
+ if (!res.ok) {
157
+ return {
158
+ group_id: groupId,
159
+ source: 'unavailable',
160
+ policies: [],
161
+ note: `Middleware returned ${res.status} for this group — live UniFi Access-Policy data unavailable.`,
162
+ };
163
+ }
164
+ const body = await res.json().catch(() => null) as { policies?: unknown } | null;
165
+ const raw = Array.isArray(body?.policies) ? body!.policies as unknown[] : null;
166
+ if (!raw) {
167
+ return {
168
+ group_id: groupId,
169
+ source: 'unavailable',
170
+ policies: [],
171
+ note: 'Middleware response was not in the expected shape — live UniFi Access-Policy data unavailable.',
172
+ };
173
+ }
174
+ const policies: AccessPolicy[] = [];
175
+ for (const p of raw) {
176
+ const o = p as Record<string, unknown>;
177
+ const id = typeof o.id === 'string' ? o.id : null;
178
+ if (!id) continue;
179
+ policies.push({
180
+ id,
181
+ name: typeof o.name === 'string' ? o.name : id,
182
+ schedule_id: typeof o.schedule_id === 'string' ? o.schedule_id : undefined,
183
+ schedule_name: typeof o.schedule_name === 'string' ? o.schedule_name : undefined,
184
+ });
185
+ }
186
+ // B1 (adversarial review, round 1): the middleware returned a non-empty
187
+ // `raw` array but EVERY entry failed to parse (no usable top-level string
188
+ // `id` -- e.g. `policy_id` instead, a numeric id, or a nested shape). That
189
+ // is a malformed/unrecognized response, not evidence the group has zero
190
+ // policies. Reporting `unifi_live` with an empty array here would be a
191
+ // confident false negative on a physical-door-access screen ("No Access
192
+ // Policies are bound to this group") when the true answer is "we don't
193
+ // know." Only collapse to `unavailable` when NOTHING parsed -- a partial
194
+ // parse (some entries good, some bad) is real, if incomplete, live data
195
+ // and must still be reported as `unifi_live`.
196
+ if (raw.length > 0 && policies.length === 0) {
197
+ return {
198
+ group_id: groupId,
199
+ source: 'unavailable',
200
+ policies: [],
201
+ note: 'Middleware returned policy entries in an unrecognized shape — live UniFi Access-Policy data unavailable.',
202
+ };
203
+ }
204
+ return { group_id: groupId, source: 'unifi_live', policies };
205
+ } catch {
206
+ return {
207
+ group_id: groupId,
208
+ source: 'unavailable',
209
+ policies: [],
210
+ note: 'Request to the middleware failed or timed out — live UniFi Access-Policy data unavailable.',
211
+ };
212
+ }
213
+ }
214
+
215
+ /** Fetches policies for each group id, independently — one group's failure
216
+ * never blocks another's result. Never throws. Never issues a write to
217
+ * UniFi or the middleware. It also never writes to the database itself --
218
+ * though the caller's own rate-limit check (checkRateLimit in rateLimit.ts,
219
+ * run before this function is invoked) can write an `ops_events` row via
220
+ * logOps() if the check_rate_limit RPC errors or throws. That write is not
221
+ * part of this function's own call graph, but is part of this feature's. */
222
+ export async function listGroupAccessPolicies(
223
+ groupIds: string[],
224
+ config: UnifiAccessPoliciesConfig,
225
+ ): Promise<GroupAccessPolicies[]> {
226
+ const unique = Array.from(new Set(groupIds.map((g) => (g ?? '').trim()).filter(Boolean)));
227
+ return await Promise.all(unique.map((g) => fetchOneGroup(g, config)));
228
+ }