@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,228 +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
- }
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
+ }