@simplelayer/graniteer-core 0.2.0 → 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 -309
  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 -95
  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,277 +1,277 @@
1
- // D27 stage 1 — browser-facing command surface for staff-granted Commons door access.
2
- //
3
- // Auth mirrors admin-door-write exactly: JWKS jwtVerify -> aal2 -> authorization, except
4
- // authorization here accepts door_ops_staff OR admin (ratified decision).
5
- //
6
- // This function performs NO UniFi/RADIUS work itself and never writes WiFi state. It signs
7
- // and forwards to the tenant middleware's /admin/event-access/* endpoints. The middleware is
8
- // the only thing that talks to UniFi Access; it writes grants back via event-access-store.
9
-
10
- import { createClient } from 'npm:@supabase/supabase-js@2';
11
- import { jwtVerify, createRemoteJWKSet } from 'npm:jose@5.9.6';
12
- import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
13
- import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
14
- import { sha256Hex, signBusMessage } from 'npm:@simplelayer/graniteer-core/busSignature';
15
-
16
- const corsHeaders = {
17
- 'Access-Control-Allow-Origin': '*',
18
- 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
19
- 'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
20
- };
21
-
22
- const TIMEOUT_MS = 20_000;
23
- const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
24
-
25
- export interface EventAccessAdminConfig {
26
- /** Origin of the tenant's ftw-middleware-equivalent service, e.g.
27
- * https://bus.example.com. No trailing slash. */
28
- busBase: string;
29
- /** Deploy-verification marker (lovable-ops §2c, 2026-09-04) returned by the
30
- * unauthenticated GET branch: edge functions can silently keep serving
31
- * pre-deploy bytecode even after a commit lands on main, `read_file` shows
32
- * correct source, and a frontend `deploy_project` succeeds. Bump this string
33
- * by hand whenever this tenant's wrapper changes OR its pinned
34
- * graniteer-core version changes, and after asking Lovable to redeploy this
35
- * function, GET this endpoint and confirm the returned build string matches
36
- * what you just wrote — that's a live, cheap way to confirm the *deployed*
37
- * bytecode (wrapper plus the core version it pulled in) is current, without
38
- * needing a real door/grant to test against. */
39
- buildMarker: string;
40
- }
41
-
42
- const JWKS_URL_SUFFIX = '/auth/v1/.well-known/jwks.json';
43
- let jwksCache: ReturnType<typeof createRemoteJWKSet> | null = null;
44
- function getJwks(url: string) {
45
- if (!jwksCache) jwksCache = createRemoteJWKSet(new URL(`${url}${JWKS_URL_SUFFIX}`));
46
- return jwksCache;
47
- }
48
-
49
- function json(status: number, body: unknown) {
50
- return new Response(JSON.stringify(body), {
51
- status, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
52
- });
53
- }
54
-
55
- // PINNED CROSS-REPO CONTRACT: ftw-middleware verifies these bytes independently.
56
- // signBusMessage is byte-identical to the hand-rolled HMAC this file used to
57
- // carry — same raw-key import, same HMAC-SHA256, same accumulate-loop
58
- // base64url-no-pad encoding (busB64UrlNoPad) — so the signature for a given
59
- // (secret, verb, ts, bodyHashHex) tuple is unchanged by the dedup.
60
- async function signE1(secret: string, verb: string, ts: string, bodyHashHex: string): Promise<string> {
61
- const msg = ['e1', verb, ts, bodyHashHex].join('\n');
62
- return signBusMessage(msg, secret);
63
- }
64
-
65
- function str(v: unknown): string | null {
66
- if (typeof v !== 'string') return null;
67
- const t = v.trim();
68
- return t === '' ? null : t;
69
- }
70
-
71
- export function createEventAccessAdminHandler(
72
- config: EventAccessAdminConfig,
73
- ): (req: Request) => Promise<Response> {
74
- const BUS_BASE = config.busBase;
75
- const BUILD_MARKER = config.buildMarker;
76
-
77
- return async (req) => {
78
- if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
79
- // Deploy-verification GET, unauthenticated on purpose: returns only a hand-maintained
80
- // build marker, no secrets, no DB access. Not rate-limited or logged — cheap enough to
81
- // hit freely while confirming a deploy actually landed.
82
- if (req.method === 'GET') {
83
- return json(200, { ok: true, function: 'event-access-admin', build: BUILD_MARKER });
84
- }
85
- if (req.method !== 'POST') return json(405, { ok: false, error: 'method_not_allowed' });
86
-
87
- const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
88
- const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
89
-
90
- const authHeader = req.headers.get('Authorization') ?? req.headers.get('authorization');
91
- if (!authHeader?.toLowerCase().startsWith('bearer ')) return json(401, { ok: false, error: 'unauthenticated' });
92
-
93
- let actorEmail = '';
94
- let actorUid = '';
95
- const token = authHeader.slice(7).trim();
96
- try {
97
- const { payload } = await jwtVerify(token, getJwks(SUPABASE_URL));
98
- const claims = payload as unknown as { sub?: string; email?: string; aal?: string };
99
- if (!claims.sub) return json(401, { ok: false, error: 'unauthenticated' });
100
- if (claims.aal !== 'aal2') return json(403, { ok: false, error: 'mfa_required' });
101
- actorUid = claims.sub;
102
- actorEmail = (claims.email ?? '').toLowerCase();
103
- } catch {
104
- return json(401, { ok: false, error: 'unauthenticated' });
105
- }
106
- if (!actorEmail) return json(403, { ok: false, error: 'no_email' });
107
-
108
- const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
109
- auth: { persistSession: false, autoRefreshToken: false },
110
- });
111
-
112
- const [ipOk, emailOk] = await Promise.all([
113
- checkRateLimit(admin, 'event-access-admin-ip', clientIp(req), 120, 300),
114
- checkRateLimit(admin, 'event-access-admin-email', actorEmail, 80, 300),
115
- ]);
116
- if (!ipOk || !emailOk) return json(429, { ok: false, error: 'rate_limited' });
117
-
118
- // door_ops_staff OR admin. Both re-checked server-side against the tables, never
119
- // trusting anything the browser sent.
120
- const [allowRes, doorOpsRes] = await Promise.all([
121
- admin.from('admin_users').select('email').eq('email', actorEmail).maybeSingle(),
122
- admin.from('door_ops_staff').select('email').eq('email', actorEmail).maybeSingle(),
123
- ]);
124
- if (allowRes.error || doorOpsRes.error) return json(500, { ok: false, error: 'authz_lookup_failed' });
125
- if (!allowRes.data && !doorOpsRes.data) return json(403, { ok: false, error: 'not_authorized' });
126
-
127
- let body: Record<string, unknown>;
128
- try { body = await req.json(); } catch { return json(400, { ok: false, error: 'invalid_json' }); }
129
-
130
- const action = String(body.action ?? '');
131
- if (!['grant', 'door', 'revoke'].includes(action)) return json(400, { ok: false, error: 'unknown_action' });
132
- const payload = (body.payload ?? {}) as Record<string, unknown>;
133
-
134
- // doors.id -> UniFi door id translation. The middleware calls
135
- // PUT /doors/{id}/lock_rule on the UniFi controller directly, so the outbound door_id
136
- // MUST be doors.unifi_door_id, never our internal doors.id.
137
- const resolveUnifiDoorId = async (gcDoorId: string) => {
138
- const { data, error } = await admin
139
- .from('doors').select('id,unifi_door_id,status,lockdown_verified').eq('id', gcDoorId).maybeSingle();
140
- if (error) return { error: 'door_lookup_failed' as const };
141
- if (!data) return { error: 'door_not_found' as const };
142
- const row = data as { unifi_door_id: string | null; lockdown_verified: boolean | null };
143
- const unifi = row.unifi_door_id;
144
- if (!unifi || unifi === 'PENDING') return { error: 'door_not_provisioned' as const };
145
- return { unifi, lockdownVerified: row.lockdown_verified === true };
146
- };
147
-
148
- let outbound: Record<string, unknown>;
149
-
150
- if (action === 'grant') {
151
- const gcDoorId = str(payload.door_id);
152
- const start = str(payload.start);
153
- const end = str(payload.end);
154
- if (!gcDoorId || !UUID.test(gcDoorId) || !start || !end) return json(400, { ok: false, error: 'invalid_payload' });
155
- if (!Number.isFinite(Date.parse(start)) || !Number.isFinite(Date.parse(end))) {
156
- return json(400, { ok: false, error: 'invalid_payload' });
157
- }
158
- const resolved = await resolveUnifiDoorId(gcDoorId);
159
- if ('error' in resolved) return json(400, { ok: false, error: resolved.error });
160
- const person = (payload.person ?? {}) as Record<string, unknown>;
161
- const room = (payload.room ?? {}) as Record<string, unknown>;
162
- outbound = {
163
- acting_user_id: actorEmail,
164
- person: {
165
- name: str(person.name),
166
- email: str(person.email),
167
- phone: str(person.phone),
168
- },
169
- room: { booking_id: str(room.booking_id) },
170
- door_id: resolved.unifi,
171
- start,
172
- end,
173
- idempotency_key: str(payload.idempotency_key),
174
- };
175
- } else if (action === 'door') {
176
- const gcDoorId = str(payload.door_id);
177
- const doorAction = str(payload.action);
178
- if (!gcDoorId || !UUID.test(gcDoorId) || !doorAction || !['unlock', 'relock', 'lockdown'].includes(doorAction)) {
179
- return json(400, { ok: false, error: 'invalid_payload' });
180
- }
181
- const resolved = await resolveUnifiDoorId(gcDoorId);
182
- if ('error' in resolved) return json(400, { ok: false, error: resolved.error });
183
- // A16 / D27 generalization: the panel's own render-time gate and its
184
- // client-side re-check (both in EventAccessPanel.tsx) are the same
185
- // browser session and enforce nothing on their own -- this is the one
186
- // server-side check standing between "Lockdown" and a door whose
187
- // physical lockdown/relock behavior was never actually verified.
188
- if (doorAction === 'lockdown' && !resolved.lockdownVerified) {
189
- return json(400, { ok: false, error: 'lockdown_not_verified' });
190
- }
191
- outbound = { acting_user_id: actorEmail, door_id: resolved.unifi, action: doorAction };
192
- // 2026-09-04 Relock/End-event self-contention fix: grant_id is opaque
193
- // (our booking_access_grants.id UUID, same as the revoke branch below —
194
- // never translated, unlike door_id). Optional and door-action-agnostic
195
- // here (the caller decides when it's meaningful): the middleware's
196
- // set_door() only reads it for a 'relock' action, to exclude this grant
197
- // from its own contention check so a booking's relock/end-event is never
198
- // blocked by its own still-active grant. Omitted (undefined) rather than
199
- // an empty string when the caller sends nothing, so a naive `!x` check
200
- // on the middleware side can't be fooled by "".
201
- const grantId = str(payload.grant_id);
202
- // 2026-09-04 fix (round 2, adversarial review): validate the shape
203
- // before forwarding, mirroring the door_id check above. An unvalidated
204
- // grant_id previously reached the middleware, then booking_access_events'
205
- // FK, and only failed there as a generic 502 door_action_failed — a
206
- // device-layer code that invites a pointless retry for what is actually
207
- // a caller-fixable bad payload.
208
- if (grantId) {
209
- if (!UUID.test(grantId)) return json(400, { ok: false, error: 'invalid_payload' });
210
- outbound.grant_id = grantId;
211
- }
212
- } else {
213
- // revoke — grant_id is opaque (our booking_access_grants.id UUID).
214
- const grantId = str(payload.grant_id);
215
- if (!grantId) return json(400, { ok: false, error: 'invalid_payload' });
216
- outbound = { acting_user_id: actorEmail, grant_id: grantId };
217
- }
218
-
219
- const { data: secretRaw, error: secretErr } = await admin.rpc('get_event_access_hmac_secret');
220
- const secret = typeof secretRaw === 'string' ? secretRaw : null;
221
- if (secretErr || !secret) {
222
- await logOps(admin, 'event_access_admin_secret_missing', { action }, { severity: 'error' });
223
- return json(500, { ok: false, error: 'signing_unavailable' });
224
- }
225
-
226
- // Exact bytes posted are the exact bytes digested.
227
- const rawBody = JSON.stringify(outbound);
228
- const bodyHash = await sha256Hex(rawBody);
229
- // The "door" verb has a 45s replay window on the middleware — stamp ts last.
230
- const ts = String(Math.floor(Date.now() / 1000));
231
- const signature = await signE1(secret, action, ts, bodyHash);
232
-
233
- let res: Response;
234
- try {
235
- res = await fetch(`${BUS_BASE}/admin/event-access/${action}`, {
236
- method: 'POST',
237
- headers: {
238
- 'Content-Type': 'application/json',
239
- 'X-Event-Access-Signature': signature,
240
- 'X-Event-Access-Timestamp': ts,
241
- },
242
- body: rawBody,
243
- signal: AbortSignal.timeout(TIMEOUT_MS),
244
- });
245
- } catch (e) {
246
- await logOps(admin, 'event_access_admin_call_error',
247
- { action, actor_email: actorEmail, message: String(e) }, { severity: 'error' });
248
- return json(502, { ok: false, error: 'middleware_unreachable' });
249
- }
250
-
251
- const text = await res.text();
252
- let parsed: unknown = null;
253
- try { parsed = text ? JSON.parse(text) : null; } catch { parsed = null; }
254
-
255
- if (!res.ok) {
256
- await logOps(admin, 'event_access_admin_call_failed',
257
- { action, actor_email: actorEmail, status: res.status, response: text.slice(0, 1000) },
258
- { severity: 'error' });
259
- return json(502, { ok: false, error: res.status === 401 || res.status === 403 ? 'middleware_rejected' : 'middleware_error' });
260
- }
261
-
262
- await admin.from('ops_events').insert({
263
- kind: 'event_access_admin_write',
264
- severity: 'info',
265
- booking_id: null,
266
- detail: {
267
- action,
268
- actor_email: actorEmail,
269
- actor_uid: actorUid,
270
- outbound: { ...outbound, acting_user_id: actorEmail },
271
- middleware_status: res.status,
272
- },
273
- });
274
-
275
- return json(200, { ok: true, result: parsed });
276
- };
277
- }
1
+ // D27 stage 1 — browser-facing command surface for staff-granted Commons door access.
2
+ //
3
+ // Auth mirrors admin-door-write exactly: JWKS jwtVerify -> aal2 -> authorization, except
4
+ // authorization here accepts door_ops_staff OR admin (ratified decision).
5
+ //
6
+ // This function performs NO UniFi/RADIUS work itself and never writes WiFi state. It signs
7
+ // and forwards to the tenant middleware's /admin/event-access/* endpoints. The middleware is
8
+ // the only thing that talks to UniFi Access; it writes grants back via event-access-store.
9
+
10
+ import { createClient } from 'npm:@supabase/supabase-js@2';
11
+ import { jwtVerify, createRemoteJWKSet } from 'npm:jose@5.9.6';
12
+ import { clientIp, checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
13
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
14
+ import { sha256Hex, signBusMessage } from 'npm:@simplelayer/graniteer-core/busSignature';
15
+
16
+ const corsHeaders = {
17
+ 'Access-Control-Allow-Origin': '*',
18
+ 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
19
+ 'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
20
+ };
21
+
22
+ const TIMEOUT_MS = 20_000;
23
+ const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
24
+
25
+ export interface EventAccessAdminConfig {
26
+ /** Origin of the tenant's ftw-middleware-equivalent service, e.g.
27
+ * https://bus.example.com. No trailing slash. */
28
+ busBase: string;
29
+ /** Deploy-verification marker (lovable-ops §2c, 2026-09-04) returned by the
30
+ * unauthenticated GET branch: edge functions can silently keep serving
31
+ * pre-deploy bytecode even after a commit lands on main, `read_file` shows
32
+ * correct source, and a frontend `deploy_project` succeeds. Bump this string
33
+ * by hand whenever this tenant's wrapper changes OR its pinned
34
+ * graniteer-core version changes, and after asking Lovable to redeploy this
35
+ * function, GET this endpoint and confirm the returned build string matches
36
+ * what you just wrote — that's a live, cheap way to confirm the *deployed*
37
+ * bytecode (wrapper plus the core version it pulled in) is current, without
38
+ * needing a real door/grant to test against. */
39
+ buildMarker: string;
40
+ }
41
+
42
+ const JWKS_URL_SUFFIX = '/auth/v1/.well-known/jwks.json';
43
+ let jwksCache: ReturnType<typeof createRemoteJWKSet> | null = null;
44
+ function getJwks(url: string) {
45
+ if (!jwksCache) jwksCache = createRemoteJWKSet(new URL(`${url}${JWKS_URL_SUFFIX}`));
46
+ return jwksCache;
47
+ }
48
+
49
+ function json(status: number, body: unknown) {
50
+ return new Response(JSON.stringify(body), {
51
+ status, headers: { ...corsHeaders, 'Content-Type': 'application/json' },
52
+ });
53
+ }
54
+
55
+ // PINNED CROSS-REPO CONTRACT: ftw-middleware verifies these bytes independently.
56
+ // signBusMessage is byte-identical to the hand-rolled HMAC this file used to
57
+ // carry — same raw-key import, same HMAC-SHA256, same accumulate-loop
58
+ // base64url-no-pad encoding (busB64UrlNoPad) — so the signature for a given
59
+ // (secret, verb, ts, bodyHashHex) tuple is unchanged by the dedup.
60
+ async function signE1(secret: string, verb: string, ts: string, bodyHashHex: string): Promise<string> {
61
+ const msg = ['e1', verb, ts, bodyHashHex].join('\n');
62
+ return signBusMessage(msg, secret);
63
+ }
64
+
65
+ function str(v: unknown): string | null {
66
+ if (typeof v !== 'string') return null;
67
+ const t = v.trim();
68
+ return t === '' ? null : t;
69
+ }
70
+
71
+ export function createEventAccessAdminHandler(
72
+ config: EventAccessAdminConfig,
73
+ ): (req: Request) => Promise<Response> {
74
+ const BUS_BASE = config.busBase;
75
+ const BUILD_MARKER = config.buildMarker;
76
+
77
+ return async (req) => {
78
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
79
+ // Deploy-verification GET, unauthenticated on purpose: returns only a hand-maintained
80
+ // build marker, no secrets, no DB access. Not rate-limited or logged — cheap enough to
81
+ // hit freely while confirming a deploy actually landed.
82
+ if (req.method === 'GET') {
83
+ return json(200, { ok: true, function: 'event-access-admin', build: BUILD_MARKER });
84
+ }
85
+ if (req.method !== 'POST') return json(405, { ok: false, error: 'method_not_allowed' });
86
+
87
+ const SUPABASE_URL = Deno.env.get('SUPABASE_URL')!;
88
+ const SERVICE_ROLE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!;
89
+
90
+ const authHeader = req.headers.get('Authorization') ?? req.headers.get('authorization');
91
+ if (!authHeader?.toLowerCase().startsWith('bearer ')) return json(401, { ok: false, error: 'unauthenticated' });
92
+
93
+ let actorEmail = '';
94
+ let actorUid = '';
95
+ const token = authHeader.slice(7).trim();
96
+ try {
97
+ const { payload } = await jwtVerify(token, getJwks(SUPABASE_URL));
98
+ const claims = payload as unknown as { sub?: string; email?: string; aal?: string };
99
+ if (!claims.sub) return json(401, { ok: false, error: 'unauthenticated' });
100
+ if (claims.aal !== 'aal2') return json(403, { ok: false, error: 'mfa_required' });
101
+ actorUid = claims.sub;
102
+ actorEmail = (claims.email ?? '').toLowerCase();
103
+ } catch {
104
+ return json(401, { ok: false, error: 'unauthenticated' });
105
+ }
106
+ if (!actorEmail) return json(403, { ok: false, error: 'no_email' });
107
+
108
+ const admin = createClient(SUPABASE_URL, SERVICE_ROLE_KEY, {
109
+ auth: { persistSession: false, autoRefreshToken: false },
110
+ });
111
+
112
+ const [ipOk, emailOk] = await Promise.all([
113
+ checkRateLimit(admin, 'event-access-admin-ip', clientIp(req), 120, 300),
114
+ checkRateLimit(admin, 'event-access-admin-email', actorEmail, 80, 300),
115
+ ]);
116
+ if (!ipOk || !emailOk) return json(429, { ok: false, error: 'rate_limited' });
117
+
118
+ // door_ops_staff OR admin. Both re-checked server-side against the tables, never
119
+ // trusting anything the browser sent.
120
+ const [allowRes, doorOpsRes] = await Promise.all([
121
+ admin.from('admin_users').select('email').eq('email', actorEmail).maybeSingle(),
122
+ admin.from('door_ops_staff').select('email').eq('email', actorEmail).maybeSingle(),
123
+ ]);
124
+ if (allowRes.error || doorOpsRes.error) return json(500, { ok: false, error: 'authz_lookup_failed' });
125
+ if (!allowRes.data && !doorOpsRes.data) return json(403, { ok: false, error: 'not_authorized' });
126
+
127
+ let body: Record<string, unknown>;
128
+ try { body = await req.json(); } catch { return json(400, { ok: false, error: 'invalid_json' }); }
129
+
130
+ const action = String(body.action ?? '');
131
+ if (!['grant', 'door', 'revoke'].includes(action)) return json(400, { ok: false, error: 'unknown_action' });
132
+ const payload = (body.payload ?? {}) as Record<string, unknown>;
133
+
134
+ // doors.id -> UniFi door id translation. The middleware calls
135
+ // PUT /doors/{id}/lock_rule on the UniFi controller directly, so the outbound door_id
136
+ // MUST be doors.unifi_door_id, never our internal doors.id.
137
+ const resolveUnifiDoorId = async (gcDoorId: string) => {
138
+ const { data, error } = await admin
139
+ .from('doors').select('id,unifi_door_id,status,lockdown_verified').eq('id', gcDoorId).maybeSingle();
140
+ if (error) return { error: 'door_lookup_failed' as const };
141
+ if (!data) return { error: 'door_not_found' as const };
142
+ const row = data as { unifi_door_id: string | null; lockdown_verified: boolean | null };
143
+ const unifi = row.unifi_door_id;
144
+ if (!unifi || unifi === 'PENDING') return { error: 'door_not_provisioned' as const };
145
+ return { unifi, lockdownVerified: row.lockdown_verified === true };
146
+ };
147
+
148
+ let outbound: Record<string, unknown>;
149
+
150
+ if (action === 'grant') {
151
+ const gcDoorId = str(payload.door_id);
152
+ const start = str(payload.start);
153
+ const end = str(payload.end);
154
+ if (!gcDoorId || !UUID.test(gcDoorId) || !start || !end) return json(400, { ok: false, error: 'invalid_payload' });
155
+ if (!Number.isFinite(Date.parse(start)) || !Number.isFinite(Date.parse(end))) {
156
+ return json(400, { ok: false, error: 'invalid_payload' });
157
+ }
158
+ const resolved = await resolveUnifiDoorId(gcDoorId);
159
+ if ('error' in resolved) return json(400, { ok: false, error: resolved.error });
160
+ const person = (payload.person ?? {}) as Record<string, unknown>;
161
+ const room = (payload.room ?? {}) as Record<string, unknown>;
162
+ outbound = {
163
+ acting_user_id: actorEmail,
164
+ person: {
165
+ name: str(person.name),
166
+ email: str(person.email),
167
+ phone: str(person.phone),
168
+ },
169
+ room: { booking_id: str(room.booking_id) },
170
+ door_id: resolved.unifi,
171
+ start,
172
+ end,
173
+ idempotency_key: str(payload.idempotency_key),
174
+ };
175
+ } else if (action === 'door') {
176
+ const gcDoorId = str(payload.door_id);
177
+ const doorAction = str(payload.action);
178
+ if (!gcDoorId || !UUID.test(gcDoorId) || !doorAction || !['unlock', 'relock', 'lockdown'].includes(doorAction)) {
179
+ return json(400, { ok: false, error: 'invalid_payload' });
180
+ }
181
+ const resolved = await resolveUnifiDoorId(gcDoorId);
182
+ if ('error' in resolved) return json(400, { ok: false, error: resolved.error });
183
+ // A16 / D27 generalization: the panel's own render-time gate and its
184
+ // client-side re-check (both in EventAccessPanel.tsx) are the same
185
+ // browser session and enforce nothing on their own -- this is the one
186
+ // server-side check standing between "Lockdown" and a door whose
187
+ // physical lockdown/relock behavior was never actually verified.
188
+ if (doorAction === 'lockdown' && !resolved.lockdownVerified) {
189
+ return json(400, { ok: false, error: 'lockdown_not_verified' });
190
+ }
191
+ outbound = { acting_user_id: actorEmail, door_id: resolved.unifi, action: doorAction };
192
+ // 2026-09-04 Relock/End-event self-contention fix: grant_id is opaque
193
+ // (our booking_access_grants.id UUID, same as the revoke branch below —
194
+ // never translated, unlike door_id). Optional and door-action-agnostic
195
+ // here (the caller decides when it's meaningful): the middleware's
196
+ // set_door() only reads it for a 'relock' action, to exclude this grant
197
+ // from its own contention check so a booking's relock/end-event is never
198
+ // blocked by its own still-active grant. Omitted (undefined) rather than
199
+ // an empty string when the caller sends nothing, so a naive `!x` check
200
+ // on the middleware side can't be fooled by "".
201
+ const grantId = str(payload.grant_id);
202
+ // 2026-09-04 fix (round 2, adversarial review): validate the shape
203
+ // before forwarding, mirroring the door_id check above. An unvalidated
204
+ // grant_id previously reached the middleware, then booking_access_events'
205
+ // FK, and only failed there as a generic 502 door_action_failed — a
206
+ // device-layer code that invites a pointless retry for what is actually
207
+ // a caller-fixable bad payload.
208
+ if (grantId) {
209
+ if (!UUID.test(grantId)) return json(400, { ok: false, error: 'invalid_payload' });
210
+ outbound.grant_id = grantId;
211
+ }
212
+ } else {
213
+ // revoke — grant_id is opaque (our booking_access_grants.id UUID).
214
+ const grantId = str(payload.grant_id);
215
+ if (!grantId) return json(400, { ok: false, error: 'invalid_payload' });
216
+ outbound = { acting_user_id: actorEmail, grant_id: grantId };
217
+ }
218
+
219
+ const { data: secretRaw, error: secretErr } = await admin.rpc('get_event_access_hmac_secret');
220
+ const secret = typeof secretRaw === 'string' ? secretRaw : null;
221
+ if (secretErr || !secret) {
222
+ await logOps(admin, 'event_access_admin_secret_missing', { action }, { severity: 'error' });
223
+ return json(500, { ok: false, error: 'signing_unavailable' });
224
+ }
225
+
226
+ // Exact bytes posted are the exact bytes digested.
227
+ const rawBody = JSON.stringify(outbound);
228
+ const bodyHash = await sha256Hex(rawBody);
229
+ // The "door" verb has a 45s replay window on the middleware — stamp ts last.
230
+ const ts = String(Math.floor(Date.now() / 1000));
231
+ const signature = await signE1(secret, action, ts, bodyHash);
232
+
233
+ let res: Response;
234
+ try {
235
+ res = await fetch(`${BUS_BASE}/admin/event-access/${action}`, {
236
+ method: 'POST',
237
+ headers: {
238
+ 'Content-Type': 'application/json',
239
+ 'X-Event-Access-Signature': signature,
240
+ 'X-Event-Access-Timestamp': ts,
241
+ },
242
+ body: rawBody,
243
+ signal: AbortSignal.timeout(TIMEOUT_MS),
244
+ });
245
+ } catch (e) {
246
+ await logOps(admin, 'event_access_admin_call_error',
247
+ { action, actor_email: actorEmail, message: String(e) }, { severity: 'error' });
248
+ return json(502, { ok: false, error: 'middleware_unreachable' });
249
+ }
250
+
251
+ const text = await res.text();
252
+ let parsed: unknown = null;
253
+ try { parsed = text ? JSON.parse(text) : null; } catch { parsed = null; }
254
+
255
+ if (!res.ok) {
256
+ await logOps(admin, 'event_access_admin_call_failed',
257
+ { action, actor_email: actorEmail, status: res.status, response: text.slice(0, 1000) },
258
+ { severity: 'error' });
259
+ return json(502, { ok: false, error: res.status === 401 || res.status === 403 ? 'middleware_rejected' : 'middleware_error' });
260
+ }
261
+
262
+ await admin.from('ops_events').insert({
263
+ kind: 'event_access_admin_write',
264
+ severity: 'info',
265
+ booking_id: null,
266
+ detail: {
267
+ action,
268
+ actor_email: actorEmail,
269
+ actor_uid: actorUid,
270
+ outbound: { ...outbound, acting_user_id: actorEmail },
271
+ middleware_status: res.status,
272
+ },
273
+ });
274
+
275
+ return json(200, { ok: true, result: parsed });
276
+ };
277
+ }