@simplelayer/graniteer-core 0.0.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 (175) hide show
  1. package/package.json +169 -15
  2. package/src/adminBookingCredit.test.ts +451 -0
  3. package/src/adminBookingCredit.ts +239 -0
  4. package/src/agreementCheckout.ts +250 -0
  5. package/src/agreementPortalEmail.ts +128 -0
  6. package/src/availability.test.ts +25 -0
  7. package/src/availability.ts +201 -0
  8. package/src/billingPortalLinkEmail.ts +117 -0
  9. package/src/bookingAgreementEmail.ts +149 -0
  10. package/src/bookingEffects.ts +388 -0
  11. package/src/bookingHoldReclaim.ts +94 -0
  12. package/src/busClient.ts +268 -0
  13. package/src/busSignature.ts +71 -0
  14. package/src/checkoutCoupon.test.ts +675 -0
  15. package/src/checkoutCoupon.ts +455 -0
  16. package/src/checkoutSessionParams.ts +56 -0
  17. package/src/commonsContract.ts +175 -0
  18. package/src/commonsDeposit.ts +298 -0
  19. package/src/commonsDepositWebhook.ts +237 -0
  20. package/src/conductorAdmin.ts +141 -0
  21. package/src/dayPassConfirmation.ts +230 -0
  22. package/src/dunningEmails.test.ts +263 -0
  23. package/src/dunningEmails.ts +203 -0
  24. package/src/email-templates/brand.ts +93 -0
  25. package/src/email-templates/email-change.tsx +92 -0
  26. package/src/email-templates/invite.tsx +79 -0
  27. package/src/email-templates/magic-link.tsx +59 -0
  28. package/src/email-templates/reauthentication.tsx +60 -0
  29. package/src/email-templates/recovery.tsx +59 -0
  30. package/src/email-templates/signup.tsx +67 -0
  31. package/src/functions/admin-cancel-membership.ts +311 -0
  32. package/src/functions/admin-change-membership-plan.ts +312 -0
  33. package/src/functions/admin-charge-guest-print.ts +229 -0
  34. package/src/functions/admin-correct-booking.ts +333 -0
  35. package/src/functions/admin-create-booking.ts +460 -0
  36. package/src/functions/admin-create-commons-event.ts +244 -0
  37. package/src/functions/admin-debug-boldsign-doc.ts +93 -0
  38. package/src/functions/admin-door-write.ts +272 -0
  39. package/src/functions/admin-issue-day-pass.ts +231 -0
  40. package/src/functions/admin-mark-booking-paid.ts +203 -0
  41. package/src/functions/admin-mint-billing-portal-link.ts +168 -0
  42. package/src/functions/admin-mint-portal-link.ts +62 -0
  43. package/src/functions/admin-photo-upload.ts +128 -0
  44. package/src/functions/admin-remove-team-member.ts +150 -0
  45. package/src/functions/admin-request-trial.ts +366 -0
  46. package/src/functions/admin-resend-commons-deposit-link.ts +323 -0
  47. package/src/functions/admin-reset-mfa.ts +138 -0
  48. package/src/functions/admin-retry-invoice-payment.test.ts +567 -0
  49. package/src/functions/admin-retry-invoice-payment.ts +333 -0
  50. package/src/functions/admin-reverse-coupon-redemption.ts +98 -0
  51. package/src/functions/admin-revoke-agreement.ts +467 -0
  52. package/src/functions/admin-send-commons-agreement.ts +214 -0
  53. package/src/functions/admin-set-credit-amount.ts +123 -0
  54. package/src/functions/admin-skip-commons-contract.ts +165 -0
  55. package/src/functions/admin-undo-membership-cancel.ts +144 -0
  56. package/src/functions/admin-wall-photo-write.ts +141 -0
  57. package/src/functions/auth-email-hook.ts +259 -0
  58. package/src/functions/boldsign-sender-identity.ts +114 -0
  59. package/src/functions/booking-availability.ts +419 -0
  60. package/src/functions/booking-member-preview.ts +136 -0
  61. package/src/functions/booking-status.ts +149 -0
  62. package/src/functions/conductor.ts +505 -0
  63. package/src/functions/create-agreement.ts +537 -0
  64. package/src/functions/create-booking.ts +648 -0
  65. package/src/functions/create-day-pass-checkout.ts +218 -0
  66. package/src/functions/create-portal-session.ts +142 -0
  67. package/src/functions/create-subscription-checkout.test.ts +222 -0
  68. package/src/functions/create-subscription-checkout.ts +440 -0
  69. package/src/functions/day-pass-status.ts +89 -0
  70. package/src/functions/dayStatus.ts +71 -0
  71. package/src/functions/diag-webpush-test.ts +45 -0
  72. package/src/functions/event-access-admin.ts +277 -0
  73. package/src/functions/event-access-store.ts +309 -0
  74. package/src/functions/ezeep-print-webhook.ts +213 -0
  75. package/src/functions/ezeep-usage-reconcile.ts +299 -0
  76. package/src/functions/fetch-avatar-original.ts +457 -0
  77. package/src/functions/get-provider-sign-link.ts +155 -0
  78. package/src/functions/get-signing-link.ts +211 -0
  79. package/src/functions/guest-print-setup-confirm.ts +128 -0
  80. package/src/functions/guest-print-submit.ts +149 -0
  81. package/src/functions/luma-webhook.ts +165 -0
  82. package/src/functions/manage-booking.ts +472 -0
  83. package/src/functions/mcp.ts +67 -0
  84. package/src/functions/member-door-action.test.ts +1248 -0
  85. package/src/functions/member-door-action.ts +863 -0
  86. package/src/functions/member-unifi-mapping.test.ts +516 -0
  87. package/src/functions/member-unifi-mapping.ts +206 -0
  88. package/src/functions/membership-door-sync.ts +956 -0
  89. package/src/functions/migration-collision-alert.copy.ts +232 -0
  90. package/src/functions/migration-collision-alert.test.ts +349 -0
  91. package/src/functions/migration-collision-alert.ts +232 -0
  92. package/src/functions/office-assignment-end.ts +146 -0
  93. package/src/functions/portal-booking-access.ts +95 -0
  94. package/src/functions/portal-list-invoices.ts +99 -0
  95. package/src/functions/portal-request-login.ts +192 -0
  96. package/src/functions/portal-resend-invite.ts +248 -0
  97. package/src/functions/portal-submit-event.ts +168 -0
  98. package/src/functions/print-billing-recover.ts +97 -0
  99. package/src/functions/print-billing-run.ts +183 -0
  100. package/src/functions/public-facts.ts +168 -0
  101. package/src/functions/push-send.ts +348 -0
  102. package/src/functions/push-test.ts +234 -0
  103. package/src/functions/request-portal-link.ts +211 -0
  104. package/src/functions/reschedule-booking.ts +649 -0
  105. package/src/functions/review-ratings.ts +113 -0
  106. package/src/functions/space-availability-range.acceptance.test.ts +161 -0
  107. package/src/functions/space-availability-range.ts +142 -0
  108. package/src/functions/stripe-db-reconcile.ts +319 -0
  109. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  110. package/src/functions/stripe-webhook.ts +2595 -0
  111. package/src/functions/sync-gcal-blackouts.ts +298 -0
  112. package/src/functions/timetable-event-register.ts +162 -0
  113. package/src/functions/timetable-event-status.ts +90 -0
  114. package/src/functions/timetable-spaces.ts +219 -0
  115. package/src/functions/touch-pass-reconciler.ts +689 -0
  116. package/src/functions/touch-pass-signup.ts +478 -0
  117. package/src/functions/upload-booking-display-image.ts +179 -0
  118. package/src/functions/virtual-onboarding-purge.ts +134 -0
  119. package/src/functions/virtual-onboarding-submit.ts +315 -0
  120. package/src/functions/voice-booking.ts +453 -0
  121. package/src/functions/voice-day-pass.ts +346 -0
  122. package/src/functions/voice-inquiry.test.ts +301 -0
  123. package/src/functions/voice-inquiry.ts +198 -0
  124. package/src/functions/voice-membership-signup.ts +355 -0
  125. package/src/functions/voice-tour-availability.ts +204 -0
  126. package/src/functions/voice-tour-booking.ts +429 -0
  127. package/src/gcalSync.ts +142 -0
  128. package/src/ghlEventInquiry.ts +143 -0
  129. package/src/ghlNote.ts +34 -0
  130. package/src/ghlTask.ts +48 -0
  131. package/src/ghlVoiceInquiry.ts +90 -0
  132. package/src/guestPrintCapture.test.ts +722 -0
  133. package/src/guestPrintCapture.ts +538 -0
  134. package/src/lumaGhl.ts +195 -0
  135. package/src/mailArrivalEmail.ts +121 -0
  136. package/src/manageToken.ts +363 -0
  137. package/src/membership.ts +109 -0
  138. package/src/membershipBusClient.ts +537 -0
  139. package/src/membershipWelcome.ts +683 -0
  140. package/src/migrationCheckout.ts +366 -0
  141. package/src/money.ts +36 -0
  142. package/src/ops.ts +97 -0
  143. package/src/pacificDate.ts +88 -0
  144. package/src/paymentLinkEmail.ts +123 -0
  145. package/src/policyAcknowledgment.test.ts +50 -0
  146. package/src/policyAcknowledgment.ts +96 -0
  147. package/src/portalSession.ts +46 -0
  148. package/src/pricing.test.ts +660 -0
  149. package/src/pricing.ts +1025 -0
  150. package/src/printBilling.test.ts +750 -0
  151. package/src/printBilling.ts +891 -0
  152. package/src/printBillingAdapters.ts +169 -0
  153. package/src/printCorrections.test.ts +348 -0
  154. package/src/printCorrections.ts +496 -0
  155. package/src/rateLimit.ts +82 -0
  156. package/src/referralCredits.test.ts +31 -0
  157. package/src/referralCredits.ts +34 -0
  158. package/src/referralGrant.ts +321 -0
  159. package/src/rescheduleCredit.test.ts +521 -0
  160. package/src/rescheduleCredit.ts +337 -0
  161. package/src/reservationWifiCode.test.ts +69 -0
  162. package/src/reservationWifiCode.ts +81 -0
  163. package/src/retellCallAnalyzed.test.ts +167 -0
  164. package/src/retellCallAnalyzed.ts +113 -0
  165. package/src/retellSignature.test.ts +137 -0
  166. package/src/retellSignature.ts +82 -0
  167. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  168. package/src/signedUnpaidReminderEmail.ts +132 -0
  169. package/src/slackAlert.ts +38 -0
  170. package/src/stripeCoworkingPortal.ts +91 -0
  171. package/src/supabaseTestFakes.ts +131 -0
  172. package/src/supportTicketEmail.ts +119 -0
  173. package/src/tier1Agreement.ts +125 -0
  174. package/src/unifiAccessPolicies.ts +228 -0
  175. package/src/unifiGroups.ts +129 -0
@@ -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
+ }
@@ -0,0 +1,129 @@
1
+ // SMALLEST POSSIBLE READ-ONLY UniFi group-list wrapper.
2
+ //
3
+ // D33 Phase 0.5 / Phase 10 batch 1: the generic half of gc-connect's
4
+ // _shared/unifiGroups.ts. The tenant layer keeps only its transport identity
5
+ // (bus origin, `source`) and the names of its own env gates, passed in as the
6
+ // `config` parameter. Behaviour, the signed message, the header names, the
7
+ // redirect policy, the timeout and the fallback copy are unchanged from the
8
+ // pre-split file.
9
+ //
10
+ // This is NOT a UniFi client, and this module must never become one. The
11
+ // tenant's edge functions never talk to UniFi Access directly -- the middleware
12
+ // deployment owns that credential and every UniFi call. This module asks the
13
+ // middleware for its group catalogue and nothing else. No writes, ever. A
14
+ // future change that made this module call a UniFi Access endpoint itself would
15
+ // be an architecture violation, not a refactor: the indirection through
16
+ // `config.busBase` IS the design.
17
+ //
18
+ // Contract, deliberately minimal:
19
+ // GET {config.busBase}/membership/groups
20
+ // headers: x-gc-source: <source>, x-gc-generated-at: <iso>, x-gc-signature: <sig>
21
+ // message signed = "g1\n{source}\n{generated_at}" under config.env.secret
22
+ //
23
+ // The signature travels in a REQUEST HEADER, never in the URL: a URL-borne signature is
24
+ // written verbatim into every intermediate access log. It is also signed with its own
25
+ // secret rather than the membership-sync secret — two unrelated authorities never share
26
+ // one key, even for a read-only call.
27
+ //
28
+ // If the middleware does not implement this endpoint yet (404/any non-2xx), or the bus is
29
+ // disabled, we DO NOT fail the screen: we fall back to the distinct group ids already
30
+ // present in membership_plans.unifi_group_ids and report source='fallback_db' so the UI can
31
+ // say so out loud. Never throws.
32
+
33
+ import type { SupabaseClient } from 'npm:@supabase/supabase-js@2';
34
+ import { signBusMessage } from './busSignature.ts';
35
+
36
+ // deno-lint-ignore no-explicit-any
37
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
38
+
39
+ const TIMEOUT_MS = 15_000;
40
+
41
+ /** The tenant's transport identity and env gates for the group-list read. */
42
+ export interface UnifiGroupsConfig {
43
+ /** Origin of the tenant's middleware, e.g. https://bus.example.com. No trailing slash. */
44
+ busBase: string;
45
+ /** Transport identity signed into the "g1" message and sent as x-gc-source. */
46
+ source: string;
47
+ env: {
48
+ /** Env var gating the live middleware read. Falls back to the DB when off. */
49
+ busEnabledFlag: string;
50
+ /** Env var holding this endpoint's OWN HMAC secret (never the sync secret). */
51
+ secret: string;
52
+ };
53
+ }
54
+
55
+ export interface UnifiGroup { id: string; name: string }
56
+ export interface UnifiGroupList {
57
+ source: 'unifi_live' | 'fallback_db';
58
+ groups: UnifiGroup[];
59
+ note?: string;
60
+ }
61
+
62
+ async function fromMiddleware(config: UnifiGroupsConfig): Promise<UnifiGroup[] | null> {
63
+ if (Deno.env.get(config.env.busEnabledFlag) !== 'true') return null;
64
+ const secret = Deno.env.get(config.env.secret);
65
+ if (!secret) return null;
66
+ try {
67
+ const generatedAt = new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
68
+ const hmac = await signBusMessage(['g1', config.source, generatedAt].join('\n'), secret);
69
+ const res = await fetch(`${config.busBase}/membership/groups`, {
70
+ method: 'GET',
71
+ headers: {
72
+ 'x-gc-source': config.source,
73
+ 'x-gc-generated-at': generatedAt,
74
+ 'x-gc-signature': hmac,
75
+ },
76
+ // S5 (adversarial review, round 1, on the companion unifiAccessPolicies.ts
77
+ // module): a cross-origin redirect does NOT carry the Authorization
78
+ // header forward, but it DOES carry an ordinary custom header like
79
+ // x-gc-signature -- so an unexpected redirect here would leak this
80
+ // request's HMAC to whatever origin issued it. 'error' refuses to
81
+ // follow any redirect at all.
82
+ redirect: 'error',
83
+ signal: AbortSignal.timeout(TIMEOUT_MS),
84
+ });
85
+ if (!res.ok) return null;
86
+ const json = await res.json().catch(() => null) as { groups?: unknown } | null;
87
+ const raw = Array.isArray(json?.groups) ? json!.groups as unknown[] : null;
88
+ if (!raw) return null;
89
+ const out: UnifiGroup[] = [];
90
+ for (const g of raw) {
91
+ if (typeof g === 'string') { out.push({ id: g, name: g }); continue; }
92
+ const o = g as Record<string, unknown>;
93
+ const id = typeof o.id === 'string' ? o.id : typeof o.group_id === 'string' ? o.group_id : null;
94
+ if (!id) continue;
95
+ out.push({ id, name: typeof o.name === 'string' ? o.name : id });
96
+ }
97
+ return out.length ? out : null;
98
+ } catch {
99
+ return null;
100
+ }
101
+ }
102
+
103
+ async function fromDb(supabase: SupabaseLike): Promise<UnifiGroup[]> {
104
+ const { data } = await supabase.from('membership_plans').select('unifi_group_ids');
105
+ const set = new Set<string>();
106
+ for (const row of (data ?? []) as { unifi_group_ids: string[] | null }[]) {
107
+ for (const g of row.unifi_group_ids ?? []) {
108
+ const v = (g ?? '').trim();
109
+ if (v) set.add(v);
110
+ }
111
+ }
112
+ return Array.from(set).sort().map((id) => ({ id, name: id }));
113
+ }
114
+
115
+ export async function listUnifiGroups(
116
+ supabase: SupabaseLike,
117
+ config: UnifiGroupsConfig,
118
+ ): Promise<UnifiGroupList> {
119
+ const live = await fromMiddleware(config);
120
+ if (live) return { source: 'unifi_live', groups: live.sort((a, b) => a.name.localeCompare(b.name)) };
121
+ return {
122
+ source: 'fallback_db',
123
+ groups: await fromDb(supabase),
124
+ note:
125
+ 'Live UniFi group list unavailable — the catalogue below is derived from group IDs already assigned to plans. ' +
126
+ 'Group list is incomplete in this mode — a group not already used by some plan cannot be added here. ' +
127
+ 'IDs are shown raw because group names are only available from UniFi.',
128
+ };
129
+ }