@broberg/tenant 0.0.0-stage → 0.1.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.
package/README.md CHANGED
@@ -1,3 +1,124 @@
1
- # Temporary Holding Version
1
+ # @broberg/tenant
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Organisations, memberships, invitations and role checks, the same way in every app.
4
+
5
+ **The storage is yours.** You implement `TenantStore` against your own database, in whatever shape it is: one shared DB with a `tenant_id`, a DB per organisation, or units below the organisation. The package never opens a tenant database, and it never decides how tenant data is isolated. Organisations never live in Broberg ID: BID says who the user is, and your app says which organisations she belongs to (D-5345a2).
6
+
7
+ Why it exists: six apps in the fleet each built their own (survey F029.7), and four of them choose the active organisation by silently falling back to «the first membership». This package refuses to.
8
+
9
+ ## Choosing the active tenant
10
+
11
+ ```ts
12
+ import { resolveActiveTenant } from "@broberg/tenant";
13
+
14
+ const active = await resolveActiveTenant({
15
+ store, userId,
16
+ requested: c.req.param("tenant"), // explicit, for THIS request → strict
17
+ preferred: cookie("active-tenant"), // a standing preference → may fall back
18
+ pickDefault: (usable) => mostRecentlyUsed(usable), // your rule when nothing says which
19
+ });
20
+ // → { tenant, membership, fellBack, reason? }
21
+ if (active.fellBack) clearCookie("active-tenant"); // the preference was stale
22
+ ```
23
+
24
+ | input | when it cannot be used |
25
+ |---|---|
26
+ | `requested` (path, header) | **throws**: `TenantNotFound`, `TenantNotMember` or `TenantSuspended`. A bad request is never quietly answered for another tenant. |
27
+ | `preferred` (cookie, stored choice) | **falls back** to one of the user's OWN memberships, with `fellBack: true` and `reason`. A stale cookie must not lock a user out of her own system (trail's pattern). |
28
+ | neither, several memberships | `pickDefault` decides. Without it the call throws `TenantChoiceRequired`; it never picks «the first row». |
29
+
30
+ In every mode, the result is one of the user's own memberships. A suspended tenant is never returned.
31
+
32
+ ## Invitations
33
+
34
+ ```ts
35
+ import { createInvite, acceptInvite } from "@broberg/tenant";
36
+
37
+ const { token } = await createInvite({ store, tenantId, email, role: "member", invitableRoles: ["member", "admin"], invitedBy });
38
+ // mail `${origin}/invite/${token}` with @broberg/mail. The token is returned ONCE.
39
+
40
+ const membership = await acceptInvite({ store, token, user: { id, email }, invitableRoles: ["member", "admin"] });
41
+ ```
42
+
43
+ - **Only the token's SHA-256 is stored**, so a leaked database does not leak working invitations.
44
+ - **Single use.** Of two accepts racing on one token, exactly one wins. Your store's `markInviteUsed` must be atomic, for example `UPDATE … SET used_at = ? WHERE id = ? AND used_at IS NULL` and then check the rowcount.
45
+ - **The signed-in email must match** the invitation (case-insensitive).
46
+ - **Expires** after 7 days by default (`ttlMs`).
47
+ - **Cannot escalate.** A role outside `invitableRoles` is refused when the invitation is created and again when it is accepted.
48
+ - Accepting again as the same user is safe and returns the same membership, so a half-finished earlier accept is repaired.
49
+
50
+ Refusals are `InviteRefused` with `reason`: `not_found`, `expired`, `revoked`, `used`, `email_mismatch` or `role_not_invitable`.
51
+
52
+ ## Role checks (RBAC)
53
+
54
+ ```ts
55
+ import { createPolicy } from "@broberg/tenant";
56
+
57
+ const policy = createPolicy({
58
+ roles: { owner: ["*"], admin: ["team:manage", "project:create"], member: ["project:read"] },
59
+ onDenied: ({ role, action, context }) => audit("permission_denied", { role, action, context }),
60
+ });
61
+ policy.can(membership.role, "team:manage"); // boolean
62
+ await policy.assert(membership, "team:manage", ctx); // throws TenantForbidden after onDenied
63
+ ```
64
+
65
+ Deny by default: a role or action that is not listed is refused. The roles are your own vocabulary.
66
+
67
+ ## TenantStore
68
+
69
+ ```ts
70
+ interface TenantStore {
71
+ tenantById(id): Promise<Tenant | null>;
72
+ tenantBySlug(slug): Promise<Tenant | null>;
73
+ membershipsOf(userId): Promise<Membership[]>; // across tenants; derive it if members belong to units
74
+ addMembership(m): Promise<void>; // idempotent
75
+ saveInvite(invite): Promise<void>; // insert or replace by id
76
+ inviteByTokenHash(hash): Promise<StoredInvite | null>;
77
+ markInviteUsed(id, at, userId): Promise<boolean>; // ATOMIC: true only for the call that claimed it
78
+ }
79
+ ```
80
+
81
+ `memoryTenantStore()` is the reference implementation, for tests and one dev process. The test suite runs the same checks against three stores: a shared DB with `tenant_id`, a DB per tenant, and units with a derived organisation membership.
82
+
83
+ ## Not in this package
84
+
85
+ - **How tenant data is isolated**: that is your app's decision.
86
+ - **Plans, limits, billing**: these are specific to each product.
87
+ - **Levels below the organisation** (site, project, unit): yours. Your store derives the organisation-level membership from them.
88
+
89
+ ## Hono (`@broberg/tenant/hono`)
90
+
91
+ Every refusal is JSON with a status, never a redirect, because a fetch cannot follow a redirect to a login page.
92
+
93
+ ```ts
94
+ import { tenantMiddleware, requireCapability, tenantRoutes, getTenant } from "@broberg/tenant/hono";
95
+ import { getSession } from "@broberg/sso/hono";
96
+
97
+ const user = (c) => { const s = getSession(c); return s ? { id: s.sub, email: s.email ?? "" } : null; };
98
+
99
+ app.use("/api/t/:tenant/*", sso.attach, tenantMiddleware({
100
+ store, user,
101
+ requested: (c) => c.req.param("tenant"), // strict
102
+ preferred: (c) => getCookie(c, "active-tenant"), // may fall back
103
+ onFellBack: (c) => deleteCookie(c, "active-tenant"),
104
+ }));
105
+ app.get("/api/t/:tenant/team", requireCapability(policy, "team:manage"), handler);
106
+ app.route("/api/t/:tenant", tenantRoutes({
107
+ store, user, invitableRoles: ["member", "admin"],
108
+ invite: { policy, action: "team:manage", deliverInvite: ({ to, token, tenant }) => mail.send(/* link with token */) },
109
+ }));
110
+ app.route("/api/me", tenantRoutes({ store, user, invitableRoles: ["member", "admin"] })); // GET /memberships, POST /invites/accept
111
+ ```
112
+
113
+ | situation | answer |
114
+ |---|---|
115
+ | no signed-in user | `401 {"error":"unauthenticated"}` |
116
+ | a tenant that is not hers, **whether or not it exists** | `404 {"error":"tenant_not_found"}`. It is the same answer either way, so slugs cannot be enumerated. |
117
+ | her tenant, suspended | `403 {"error":"tenant_suspended"}` (only ever said to a member) |
118
+ | several memberships, nothing says which | `409 {"error":"tenant_choice_required","count":n}` |
119
+ | role may not | `403 {"error":"forbidden","action":"…"}`, after your `onDenied` |
120
+ | `requireCapability` without `tenantMiddleware` in front | `500 {"error":"no_tenant_context"}`: closed, never open |
121
+ | invitation refusals | `invite_not_found` 404 · `invite_expired`/`invite_revoked` 410 · `invite_used` 409 · `invite_email_mismatch`/`invite_role_not_invitable` 403 |
122
+ | a write from another site, sibling subdomains included (`Sec-Fetch-Site`) | `403 {"error":"cross_site"}` |
123
+
124
+ `POST /invites` exists only when you pass `invite.deliverInvite`. The token goes straight to your mail function and never back to the inviter's browser; the response is `{ inviteId }`. `revokeInvite({ store, invite })` in the core revokes an invitation that has not been used.
package/dist/hono.cjs ADDED
@@ -0,0 +1,300 @@
1
+ 'use strict';
2
+
3
+ var hono = require('hono');
4
+
5
+ // src/hono.ts
6
+
7
+ // src/index.ts
8
+ var TenantError = class extends Error {
9
+ constructor(message) {
10
+ super(message);
11
+ this.name = "TenantError";
12
+ }
13
+ };
14
+ var TenantNotFound = class extends TenantError {
15
+ constructor(slug) {
16
+ super(`No tenant "${slug}".`);
17
+ this.slug = slug;
18
+ this.name = "TenantNotFound";
19
+ }
20
+ slug;
21
+ };
22
+ var TenantNotMember = class extends TenantError {
23
+ constructor(slug) {
24
+ super(`The user is not a member of "${slug}".`);
25
+ this.slug = slug;
26
+ this.name = "TenantNotMember";
27
+ }
28
+ slug;
29
+ };
30
+ var TenantSuspended = class extends TenantError {
31
+ constructor(slug) {
32
+ super(`Tenant "${slug}" is suspended.`);
33
+ this.slug = slug;
34
+ this.name = "TenantSuspended";
35
+ }
36
+ slug;
37
+ };
38
+ var TenantNoMembership = class extends TenantError {
39
+ constructor() {
40
+ super("The user has no active membership of any tenant.");
41
+ this.name = "TenantNoMembership";
42
+ }
43
+ };
44
+ var TenantChoiceRequired = class extends TenantError {
45
+ constructor(count) {
46
+ super(`The user is a member of ${count} tenants and nothing says which one \u2014 pass pickDefault.`);
47
+ this.count = count;
48
+ this.name = "TenantChoiceRequired";
49
+ }
50
+ count;
51
+ };
52
+ var InviteRefused = class extends TenantError {
53
+ constructor(reason) {
54
+ super(`Invitation refused: ${reason}.`);
55
+ this.reason = reason;
56
+ this.name = "InviteRefused";
57
+ }
58
+ reason;
59
+ };
60
+ async function memberships(store, userId) {
61
+ const all = await store.membershipsOf(userId);
62
+ const usable = [];
63
+ for (const m of all) {
64
+ const tenant = await store.tenantById(m.tenantId);
65
+ if (tenant && tenant.status !== "suspended") usable.push({ tenant, membership: m });
66
+ }
67
+ return { all, usable };
68
+ }
69
+ async function check(store, slug, m) {
70
+ const tenant = await store.tenantBySlug(slug);
71
+ if (!tenant) return { why: "not_found" };
72
+ const isMember = m.all.some((x) => x.tenantId === tenant.id);
73
+ if (!isMember) return { why: "not_member" };
74
+ if (tenant.status === "suspended") return { why: "suspended" };
75
+ const hit = m.usable.find((u) => u.tenant.id === tenant.id);
76
+ return hit ? { ok: hit } : { why: "not_member" };
77
+ }
78
+ async function resolveActiveTenant(input) {
79
+ const { store, userId } = input;
80
+ const ms = await memberships(store, userId);
81
+ const usable = ms.usable;
82
+ if (input.requested) {
83
+ const r = await check(store, input.requested, ms);
84
+ if ("ok" in r) return { ...r.ok, fellBack: false };
85
+ if (r.why === "not_found") throw new TenantNotFound(input.requested);
86
+ if (r.why === "suspended") throw new TenantSuspended(input.requested);
87
+ throw new TenantNotMember(input.requested);
88
+ }
89
+ let reason;
90
+ if (input.preferred) {
91
+ const r = await check(store, input.preferred, ms);
92
+ if ("ok" in r) return { ...r.ok, fellBack: false };
93
+ reason = r.why;
94
+ }
95
+ if (usable.length === 0) throw new TenantNoMembership();
96
+ const chosen = input.pickDefault ? input.pickDefault(usable) : usable.length === 1 ? usable[0] : void 0;
97
+ if (!chosen || !usable.some((u) => u.tenant.id === chosen.tenant.id && u.membership.userId === userId)) {
98
+ throw new TenantChoiceRequired(usable.length);
99
+ }
100
+ return { tenant: chosen.tenant, membership: chosen.membership, fellBack: reason !== void 0, ...reason ? { reason } : {} };
101
+ }
102
+ var DAY = 24 * 60 * 60 * 1e3;
103
+ var DEFAULT_INVITE_TTL_MS = 7 * DAY;
104
+ var normEmail = (e) => e.trim().toLowerCase();
105
+ function b64url(bytes) {
106
+ let s = "";
107
+ for (const b of bytes) s += String.fromCharCode(b);
108
+ return btoa(s).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
109
+ }
110
+ async function hashInviteToken(token) {
111
+ const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(token));
112
+ return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
113
+ }
114
+ async function createInvite(input) {
115
+ if (!input.invitableRoles.includes(input.role)) throw new InviteRefused("role_not_invitable");
116
+ const tenant = await input.store.tenantById(input.tenantId);
117
+ if (!tenant) throw new TenantNotFound(input.tenantId);
118
+ if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
119
+ const token = b64url(crypto.getRandomValues(new Uint8Array(32)));
120
+ const now = input.now ?? Date.now();
121
+ const invite = {
122
+ id: b64url(crypto.getRandomValues(new Uint8Array(12))),
123
+ tenantId: tenant.id,
124
+ email: normEmail(input.email),
125
+ role: input.role,
126
+ tokenHash: await hashInviteToken(token),
127
+ ...input.invitedBy ? { invitedBy: input.invitedBy } : {},
128
+ createdAt: now,
129
+ expiresAt: now + (input.ttlMs ?? DEFAULT_INVITE_TTL_MS)
130
+ };
131
+ await input.store.saveInvite(invite);
132
+ return { invite, token };
133
+ }
134
+ async function acceptInvite(input) {
135
+ const { store, user } = input;
136
+ const now = input.now ?? Date.now();
137
+ const invite = await store.inviteByTokenHash(await hashInviteToken(input.token));
138
+ if (!invite) throw new InviteRefused("not_found");
139
+ if (invite.revokedAt !== void 0) throw new InviteRefused("revoked");
140
+ if (normEmail(user.email) !== invite.email) throw new InviteRefused("email_mismatch");
141
+ if (!input.invitableRoles.includes(invite.role)) throw new InviteRefused("role_not_invitable");
142
+ const membership = { userId: user.id, tenantId: invite.tenantId, role: invite.role };
143
+ if (invite.usedAt !== void 0) {
144
+ if (invite.usedBy !== user.id) throw new InviteRefused("used");
145
+ await store.addMembership(membership);
146
+ return membership;
147
+ }
148
+ if (now >= invite.expiresAt) throw new InviteRefused("expired");
149
+ const tenant = await store.tenantById(invite.tenantId);
150
+ if (!tenant) throw new TenantNotFound(invite.tenantId);
151
+ if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
152
+ if (!await store.markInviteUsed(invite.id, now, user.id)) {
153
+ const again = await store.inviteByTokenHash(invite.tokenHash);
154
+ if (again?.usedBy !== user.id) throw new InviteRefused("used");
155
+ }
156
+ await store.addMembership(membership);
157
+ return membership;
158
+ }
159
+
160
+ // src/hono.ts
161
+ var TENANT_KEY = "broberg.tenant";
162
+ function getTenant(c) {
163
+ return c.get(TENANT_KEY) ?? null;
164
+ }
165
+ function nameOf(e) {
166
+ return e instanceof Error ? e.name : void 0;
167
+ }
168
+ function tenantErrorResponse(c, e) {
169
+ const err = e;
170
+ switch (nameOf(e)) {
171
+ case "TenantNotFound":
172
+ case "TenantNotMember":
173
+ return c.json({ error: "tenant_not_found" }, 404);
174
+ case "TenantSuspended":
175
+ return c.json({ error: "tenant_suspended" }, 403);
176
+ case "TenantNoMembership":
177
+ return c.json({ error: "no_tenant" }, 403);
178
+ case "TenantChoiceRequired":
179
+ return c.json({ error: "tenant_choice_required", count: err.count }, 409);
180
+ case "TenantForbidden":
181
+ return c.json({ error: "forbidden", action: err.action }, 403);
182
+ case "InviteRefused": {
183
+ const status = { not_found: 404, expired: 410, revoked: 410, used: 409, email_mismatch: 403, role_not_invitable: 403 }[err.reason];
184
+ return c.json({ error: `invite_${err.reason}` }, status ?? 400);
185
+ }
186
+ default:
187
+ return null;
188
+ }
189
+ }
190
+ function tenantMiddleware(o) {
191
+ return async (c, next) => {
192
+ const user = await o.user(c);
193
+ if (!user) return c.json({ error: "unauthenticated" }, 401);
194
+ let active;
195
+ try {
196
+ active = await resolveActiveTenant({
197
+ store: o.store,
198
+ userId: user.id,
199
+ requested: o.requested?.(c) ?? null,
200
+ preferred: o.preferred?.(c) ?? null,
201
+ ...o.pickDefault ? { pickDefault: o.pickDefault } : {}
202
+ });
203
+ } catch (e) {
204
+ const res = tenantErrorResponse(c, e);
205
+ if (res) return res;
206
+ throw e;
207
+ }
208
+ if (active.fellBack) await o.onFellBack?.(c, active);
209
+ c.set(TENANT_KEY, active);
210
+ await next();
211
+ };
212
+ }
213
+ function requireCapability(policy, action) {
214
+ return async (c, next) => {
215
+ const active = getTenant(c);
216
+ if (!active) return c.json({ error: "no_tenant_context" }, 500);
217
+ try {
218
+ await policy.assert(active.membership, action, { tenantId: active.tenant.id, userId: active.membership.userId });
219
+ } catch (e) {
220
+ const res = tenantErrorResponse(c, e);
221
+ if (res) return res;
222
+ throw e;
223
+ }
224
+ await next();
225
+ };
226
+ }
227
+ function tenantRoutes(o) {
228
+ const app = new hono.Hono();
229
+ app.use("*", async (c, next) => {
230
+ c.header("Cache-Control", "no-store");
231
+ await next();
232
+ });
233
+ app.use("*", async (c, next) => {
234
+ const site = c.req.header("sec-fetch-site");
235
+ if (c.req.method !== "GET" && site !== void 0 && site !== "same-origin" && site !== "none") {
236
+ return c.json({ error: "cross_site" }, 403);
237
+ }
238
+ await next();
239
+ });
240
+ app.get("/memberships", async (c) => {
241
+ const user = await o.user(c);
242
+ if (!user) return c.json({ error: "unauthenticated" }, 401);
243
+ const out = [];
244
+ for (const m of await o.store.membershipsOf(user.id)) {
245
+ const t = await o.store.tenantById(m.tenantId);
246
+ if (t) out.push({ tenant: { id: t.id, slug: t.slug, name: t.name, ...t.status ? { status: t.status } : {} }, role: m.role });
247
+ }
248
+ return c.json(out);
249
+ });
250
+ app.post("/invites/accept", async (c) => {
251
+ const user = await o.user(c);
252
+ if (!user) return c.json({ error: "unauthenticated" }, 401);
253
+ const body = await c.req.json().catch(() => null);
254
+ if (typeof body?.token !== "string" || body.token === "") return c.json({ error: "invalid_request" }, 400);
255
+ try {
256
+ const m = await acceptInvite({ store: o.store, token: body.token, user, invitableRoles: o.invitableRoles });
257
+ const t = await o.store.tenantById(m.tenantId);
258
+ return c.json({ tenant: t ? { id: t.id, slug: t.slug, name: t.name } : { id: m.tenantId }, role: m.role });
259
+ } catch (e) {
260
+ const res = tenantErrorResponse(c, e);
261
+ if (res) return res;
262
+ throw e;
263
+ }
264
+ });
265
+ if (o.invite) {
266
+ const inv = o.invite;
267
+ app.post("/invites", requireCapability(inv.policy, inv.action), async (c) => {
268
+ const active = getTenant(c);
269
+ const body = await c.req.json().catch(() => null);
270
+ if (typeof body?.email !== "string" || !body.email.includes("@") || typeof body.role !== "string") {
271
+ return c.json({ error: "invalid_request" }, 400);
272
+ }
273
+ try {
274
+ const { invite, token } = await createInvite({
275
+ store: o.store,
276
+ tenantId: active.tenant.id,
277
+ email: body.email,
278
+ role: body.role,
279
+ invitableRoles: o.invitableRoles,
280
+ invitedBy: active.membership.userId
281
+ });
282
+ await inv.deliverInvite({ to: invite.email, token, tenant: active.tenant, role: invite.role, invitedBy: active.membership.userId });
283
+ return c.json({ inviteId: invite.id }, 201);
284
+ } catch (e) {
285
+ const res = tenantErrorResponse(c, e);
286
+ if (res) return res;
287
+ throw e;
288
+ }
289
+ });
290
+ }
291
+ return app;
292
+ }
293
+
294
+ exports.getTenant = getTenant;
295
+ exports.requireCapability = requireCapability;
296
+ exports.tenantErrorResponse = tenantErrorResponse;
297
+ exports.tenantMiddleware = tenantMiddleware;
298
+ exports.tenantRoutes = tenantRoutes;
299
+ //# sourceMappingURL=hono.cjs.map
300
+ //# sourceMappingURL=hono.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts","../src/hono.ts"],"names":["Hono"],"mappings":";;;;;;;AA+EO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA,EACrC,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF,CAAA;AAEO,IAAM,cAAA,GAAN,cAA6B,WAAA,CAAY;AAAA,EAC9C,YAAqB,IAAA,EAAc;AACjC,IAAA,KAAA,CAAM,CAAA,WAAA,EAAc,IAAI,CAAA,EAAA,CAAI,CAAA;AADT,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAEnB,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AAAA,EACd;AAAA,EAHqB,IAAA;AAIvB,CAAA;AAEO,IAAM,eAAA,GAAN,cAA8B,WAAA,CAAY;AAAA,EAC/C,YAAqB,IAAA,EAAc;AACjC,IAAA,KAAA,CAAM,CAAA,6BAAA,EAAgC,IAAI,CAAA,EAAA,CAAI,CAAA;AAD3B,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAEnB,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AAAA,EAHqB,IAAA;AAIvB,CAAA;AAEO,IAAM,eAAA,GAAN,cAA8B,WAAA,CAAY;AAAA,EAC/C,YAAqB,IAAA,EAAc;AACjC,IAAA,KAAA,CAAM,CAAA,QAAA,EAAW,IAAI,CAAA,eAAA,CAAiB,CAAA;AADnB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAEnB,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AAAA,EAHqB,IAAA;AAIvB,CAAA;AAGO,IAAM,kBAAA,GAAN,cAAiC,WAAA,CAAY;AAAA,EAClD,WAAA,GAAc;AACZ,IAAA,KAAA,CAAM,kDAAkD,CAAA;AACxD,IAAA,IAAA,CAAK,IAAA,GAAO,oBAAA;AAAA,EACd;AACF,CAAA;AAOO,IAAM,oBAAA,GAAN,cAAmC,WAAA,CAAY;AAAA,EACpD,YAAqB,KAAA,EAAe;AAClC,IAAA,KAAA,CAAM,CAAA,wBAAA,EAA2B,KAAK,CAAA,4DAAA,CAAyD,CAAA;AAD5E,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAEnB,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,EACd;AAAA,EAHqB,KAAA;AAIvB,CAAA;AAIO,IAAM,aAAA,GAAN,cAA4B,WAAA,CAAY;AAAA,EAC7C,YAAqB,MAAA,EAAuB;AAC1C,IAAA,KAAA,CAAM,CAAA,oBAAA,EAAuB,MAAM,CAAA,CAAA,CAAG,CAAA;AADnB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAEnB,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AAAA,EACd;AAAA,EAHqB,MAAA;AAIvB,CAAA;AAuDA,eAAe,WAAA,CAAY,OAAoB,MAAA,EAAkE;AAC/G,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,aAAA,CAAc,MAAM,CAAA;AAC5C,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,KAAA,MAAW,KAAK,GAAA,EAAK;AACnB,IAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,UAAA,CAAW,EAAE,QAAQ,CAAA;AAChD,IAAA,IAAI,MAAA,IAAU,MAAA,CAAO,MAAA,KAAW,WAAA,EAAa,MAAA,CAAO,KAAK,EAAE,MAAA,EAAQ,UAAA,EAAY,CAAA,EAAG,CAAA;AAAA,EACpF;AACA,EAAA,OAAO,EAAE,KAAK,MAAA,EAAO;AACvB;AAOA,eAAe,KAAA,CAAM,KAAA,EAAoB,IAAA,EAAc,CAAA,EAA+F;AACpJ,EAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,YAAA,CAAa,IAAI,CAAA;AAC5C,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,EAAE,KAAK,WAAA,EAAY;AACvC,EAAA,MAAM,QAAA,GAAW,EAAE,GAAA,CAAI,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,QAAA,KAAa,MAAA,CAAO,EAAE,CAAA;AAC3D,EAAA,IAAI,CAAC,QAAA,EAAU,OAAO,EAAE,KAAK,YAAA,EAAa;AAC1C,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,EAAE,KAAK,WAAA,EAAY;AAC7D,EAAA,MAAM,GAAA,GAAM,CAAA,CAAE,MAAA,CAAO,IAAA,CAAK,CAAC,MAAM,CAAA,CAAE,MAAA,CAAO,EAAA,KAAO,MAAA,CAAO,EAAE,CAAA;AAC1D,EAAA,OAAO,MAAM,EAAE,EAAA,EAAI,KAAI,GAAI,EAAE,KAAK,YAAA,EAAa;AACjD;AAMA,eAAsB,oBAAoB,KAAA,EAA4C;AACpF,EAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAO,GAAI,KAAA;AAC1B,EAAA,MAAM,EAAA,GAAK,MAAM,WAAA,CAAY,KAAA,EAAO,MAAM,CAAA;AAC1C,EAAA,MAAM,SAAS,EAAA,CAAG,MAAA;AAElB,EAAA,IAAI,MAAM,SAAA,EAAW;AACnB,IAAA,MAAM,IAAI,MAAM,KAAA,CAAM,KAAA,EAAO,KAAA,CAAM,WAAW,EAAE,CAAA;AAChD,IAAA,IAAI,IAAA,IAAQ,GAAG,OAAO,EAAE,GAAG,CAAA,CAAE,EAAA,EAAI,UAAU,KAAA,EAAM;AACjD,IAAA,IAAI,EAAE,GAAA,KAAQ,WAAA,QAAmB,IAAI,cAAA,CAAe,MAAM,SAAS,CAAA;AACnE,IAAA,IAAI,EAAE,GAAA,KAAQ,WAAA,QAAmB,IAAI,eAAA,CAAgB,MAAM,SAAS,CAAA;AACpE,IAAA,MAAM,IAAI,eAAA,CAAgB,KAAA,CAAM,SAAS,CAAA;AAAA,EAC3C;AAEA,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI,MAAM,SAAA,EAAW;AACnB,IAAA,MAAM,IAAI,MAAM,KAAA,CAAM,KAAA,EAAO,KAAA,CAAM,WAAW,EAAE,CAAA;AAChD,IAAA,IAAI,IAAA,IAAQ,GAAG,OAAO,EAAE,GAAG,CAAA,CAAE,EAAA,EAAI,UAAU,KAAA,EAAM;AACjD,IAAA,MAAA,GAAS,CAAA,CAAE,GAAA;AAAA,EACb;AAEA,EAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,kBAAA,EAAmB;AACtD,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,WAAA,GAAc,KAAA,CAAM,WAAA,CAAY,MAAM,CAAA,GAAI,MAAA,CAAO,MAAA,KAAW,CAAA,GAAI,MAAA,CAAO,CAAC,CAAA,GAAI,MAAA;AAEjG,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,MAAA,CAAO,EAAA,KAAO,OAAO,MAAA,CAAO,EAAA,IAAM,EAAE,UAAA,CAAW,MAAA,KAAW,MAAM,CAAA,EAAG;AACtG,IAAA,MAAM,IAAI,oBAAA,CAAqB,MAAA,CAAO,MAAM,CAAA;AAAA,EAC9C;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAQ,UAAA,EAAY,OAAO,UAAA,EAAY,QAAA,EAAU,MAAA,KAAW,MAAA,EAAW,GAAI,MAAA,GAAS,EAAE,MAAA,EAAO,GAAI,EAAC,EAAG;AAC/H;AAIA,IAAM,GAAA,GAAM,EAAA,GAAK,EAAA,GAAK,EAAA,GAAK,GAAA;AACpB,IAAM,wBAAwB,CAAA,GAAI,GAAA;AAEzC,IAAM,YAAY,CAAC,CAAA,KAAc,CAAA,CAAE,IAAA,GAAO,WAAA,EAAY;AAEtD,SAAS,OAAO,KAAA,EAA2B;AACzC,EAAA,IAAI,CAAA,GAAI,EAAA;AACR,EAAA,KAAA,MAAW,CAAA,IAAK,KAAA,EAAO,CAAA,IAAK,MAAA,CAAO,aAAa,CAAC,CAAA;AACjD,EAAA,OAAO,IAAA,CAAK,CAAC,CAAA,CAAE,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA,CAAE,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA,CAAE,OAAA,CAAQ,OAAO,EAAE,CAAA;AAC1E;AAGA,eAAsB,gBAAgB,KAAA,EAAgC;AACpE,EAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,KAAK,CAAC,CAAA;AACpF,EAAA,OAAO,CAAC,GAAG,IAAI,UAAA,CAAW,MAAM,CAAC,CAAA,CAAE,IAAI,CAAC,CAAA,KAAM,EAAE,QAAA,CAAS,EAAE,EAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAE,KAAK,EAAE,CAAA;AACxF;AAsBA,eAAsB,aAAa,KAAA,EAA4E;AAC7G,EAAA,IAAI,CAAC,KAAA,CAAM,cAAA,CAAe,QAAA,CAAS,KAAA,CAAM,IAAI,CAAA,EAAG,MAAM,IAAI,aAAA,CAAc,oBAAoB,CAAA;AAC5F,EAAA,MAAM,SAAS,MAAM,KAAA,CAAM,KAAA,CAAM,UAAA,CAAW,MAAM,QAAQ,CAAA;AAC1D,EAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,cAAA,CAAe,MAAM,QAAQ,CAAA;AACpD,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,QAAmB,IAAI,eAAA,CAAgB,OAAO,IAAI,CAAA;AACxE,EAAA,MAAM,KAAA,GAAQ,OAAO,MAAA,CAAO,eAAA,CAAgB,IAAI,UAAA,CAAW,EAAE,CAAC,CAAC,CAAA;AAC/D,EAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,IAAO,IAAA,CAAK,GAAA,EAAI;AAClC,EAAA,MAAM,MAAA,GAAuB;AAAA,IAC3B,EAAA,EAAI,OAAO,MAAA,CAAO,eAAA,CAAgB,IAAI,UAAA,CAAW,EAAE,CAAC,CAAC,CAAA;AAAA,IACrD,UAAU,MAAA,CAAO,EAAA;AAAA,IACjB,KAAA,EAAO,SAAA,CAAU,KAAA,CAAM,KAAK,CAAA;AAAA,IAC5B,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,SAAA,EAAW,MAAM,eAAA,CAAgB,KAAK,CAAA;AAAA,IACtC,GAAI,MAAM,SAAA,GAAY,EAAE,WAAW,KAAA,CAAM,SAAA,KAAc,EAAC;AAAA,IACxD,SAAA,EAAW,GAAA;AAAA,IACX,SAAA,EAAW,GAAA,IAAO,KAAA,CAAM,KAAA,IAAS,qBAAA;AAAA,GACnC;AACA,EAAA,MAAM,KAAA,CAAM,KAAA,CAAM,UAAA,CAAW,MAAM,CAAA;AACnC,EAAA,OAAO,EAAE,QAAQ,KAAA,EAAM;AACzB;AAiBA,eAAsB,aAAa,KAAA,EAA+C;AAChF,EAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,KAAA;AACxB,EAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,IAAO,IAAA,CAAK,GAAA,EAAI;AAClC,EAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,iBAAA,CAAkB,MAAM,eAAA,CAAgB,KAAA,CAAM,KAAK,CAAC,CAAA;AAC/E,EAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,cAAc,WAAW,CAAA;AAChD,EAAA,IAAI,OAAO,SAAA,KAAc,MAAA,EAAW,MAAM,IAAI,cAAc,SAAS,CAAA;AACrE,EAAA,IAAI,SAAA,CAAU,KAAK,KAAK,CAAA,KAAM,OAAO,KAAA,EAAO,MAAM,IAAI,aAAA,CAAc,gBAAgB,CAAA;AACpF,EAAA,IAAI,CAAC,KAAA,CAAM,cAAA,CAAe,QAAA,CAAS,MAAA,CAAO,IAAI,CAAA,EAAG,MAAM,IAAI,aAAA,CAAc,oBAAoB,CAAA;AAC7F,EAAA,MAAM,UAAA,GAAyB,EAAE,MAAA,EAAQ,IAAA,CAAK,EAAA,EAAI,UAAU,MAAA,CAAO,QAAA,EAAU,IAAA,EAAM,MAAA,CAAO,IAAA,EAAK;AAE/F,EAAA,IAAI,MAAA,CAAO,WAAW,MAAA,EAAW;AAC/B,IAAA,IAAI,OAAO,MAAA,KAAW,IAAA,CAAK,IAAI,MAAM,IAAI,cAAc,MAAM,CAAA;AAC7D,IAAA,MAAM,KAAA,CAAM,cAAc,UAAU,CAAA;AACpC,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAO,MAAA,CAAO,SAAA,EAAW,MAAM,IAAI,cAAc,SAAS,CAAA;AAC9D,EAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,UAAA,CAAW,OAAO,QAAQ,CAAA;AACrD,EAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,cAAA,CAAe,OAAO,QAAQ,CAAA;AACrD,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,QAAmB,IAAI,eAAA,CAAgB,OAAO,IAAI,CAAA;AAGxE,EAAA,IAAI,CAAE,MAAM,KAAA,CAAM,cAAA,CAAe,OAAO,EAAA,EAAI,GAAA,EAAK,IAAA,CAAK,EAAE,CAAA,EAAI;AAC1D,IAAA,MAAM,KAAA,GAAQ,MAAM,KAAA,CAAM,iBAAA,CAAkB,OAAO,SAAS,CAAA;AAC5D,IAAA,IAAI,OAAO,MAAA,KAAW,IAAA,CAAK,IAAI,MAAM,IAAI,cAAc,MAAM,CAAA;AAAA,EAC/D;AACA,EAAA,MAAM,KAAA,CAAM,cAAc,UAAU,CAAA;AACpC,EAAA,OAAO,UAAA;AACT;;;ACnUA,IAAM,UAAA,GAAa,gBAAA;AAGZ,SAAS,UAAU,CAAA,EAAiC;AACzD,EAAA,OAAQ,CAAA,CAAE,GAAA,CAAI,UAAmB,CAAA,IAAkC,IAAA;AACrE;AAOA,SAAS,OAAO,CAAA,EAAgC;AAC9C,EAAA,OAAO,CAAA,YAAa,KAAA,GAAQ,CAAA,CAAE,IAAA,GAAO,MAAA;AACvC;AAQO,SAAS,mBAAA,CAAoB,GAAY,CAAA,EAA6B;AAC3E,EAAA,MAAM,GAAA,GAAM,CAAA;AACZ,EAAA,QAAQ,MAAA,CAAO,CAAC,CAAA;AAAG,IACjB,KAAK,gBAAA;AAAA,IACL,KAAK,iBAAA;AACH,MAAA,OAAO,EAAE,IAAA,CAAK,EAAE,KAAA,EAAO,kBAAA,IAAsB,GAAG,CAAA;AAAA,IAClD,KAAK,iBAAA;AACH,MAAA,OAAO,EAAE,IAAA,CAAK,EAAE,KAAA,EAAO,kBAAA,IAAsB,GAAG,CAAA;AAAA,IAClD,KAAK,oBAAA;AACH,MAAA,OAAO,EAAE,IAAA,CAAK,EAAE,KAAA,EAAO,WAAA,IAAe,GAAG,CAAA;AAAA,IAC3C,KAAK,sBAAA;AACH,MAAA,OAAO,CAAA,CAAE,KAAK,EAAE,KAAA,EAAO,0BAA0B,KAAA,EAAO,GAAA,CAAI,KAAA,EAAM,EAAG,GAAG,CAAA;AAAA,IAC1E,KAAK,iBAAA;AACH,MAAA,OAAO,CAAA,CAAE,KAAK,EAAE,KAAA,EAAO,aAAa,MAAA,EAAQ,GAAA,CAAI,MAAA,EAAO,EAAG,GAAG,CAAA;AAAA,IAC/D,KAAK,eAAA,EAAiB;AACpB,MAAA,MAAM,SAAU,EAAE,SAAA,EAAW,GAAA,EAAK,OAAA,EAAS,KAAK,OAAA,EAAS,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,gBAAgB,GAAA,EAAK,kBAAA,EAAoB,GAAA,EAAI,CACpH,IAAI,MACN,CAAA;AACA,MAAA,OAAO,CAAA,CAAE,IAAA,CAAK,EAAE,KAAA,EAAO,CAAA,OAAA,EAAU,IAAI,MAAM,CAAA,CAAA,EAAG,EAAG,MAAA,IAAU,GAAG,CAAA;AAAA,IAChE;AAAA,IACA;AACE,MAAA,OAAO,IAAA;AAAA;AAEb;AAmBO,SAAS,iBAAiB,CAAA,EAA+C;AAC9E,EAAA,OAAO,OAAO,GAAG,IAAA,KAAS;AACxB,IAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA;AAC3B,IAAA,IAAI,CAAC,MAAM,OAAO,CAAA,CAAE,KAAK,EAAE,KAAA,EAAO,iBAAA,EAAkB,EAAG,GAAG,CAAA;AAC1D,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAA,GAAS,MAAM,mBAAA,CAAoB;AAAA,QACjC,OAAO,CAAA,CAAE,KAAA;AAAA,QACT,QAAQ,IAAA,CAAK,EAAA;AAAA,QACb,SAAA,EAAW,CAAA,CAAE,SAAA,GAAY,CAAC,CAAA,IAAK,IAAA;AAAA,QAC/B,SAAA,EAAW,CAAA,CAAE,SAAA,GAAY,CAAC,CAAA,IAAK,IAAA;AAAA,QAC/B,GAAI,EAAE,WAAA,GAAc,EAAE,aAAa,CAAA,CAAE,WAAA,KAAgB;AAAC,OACvD,CAAA;AAAA,IACH,SAAS,CAAA,EAAG;AACV,MAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,CAAA,EAAG,CAAC,CAAA;AACpC,MAAA,IAAI,KAAK,OAAO,GAAA;AAChB,MAAA,MAAM,CAAA;AAAA,IACR;AACA,IAAA,IAAI,OAAO,QAAA,EAAU,MAAM,CAAA,CAAE,UAAA,GAAa,GAAG,MAAM,CAAA;AACnD,IAAA,CAAA,CAAE,GAAA,CAAI,YAAqB,MAAe,CAAA;AAC1C,IAAA,MAAM,IAAA,EAAK;AAAA,EACb,CAAA;AACF;AAQO,SAAS,iBAAA,CAAyC,QAAwB,MAAA,EAAmC;AAClH,EAAA,OAAO,OAAO,GAAG,IAAA,KAAS;AACxB,IAAA,MAAM,MAAA,GAAS,UAAU,CAAC,CAAA;AAC1B,IAAA,IAAI,CAAC,QAAQ,OAAO,CAAA,CAAE,KAAK,EAAE,KAAA,EAAO,mBAAA,EAAoB,EAAG,GAAG,CAAA;AAC9D,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,QAAQ,EAAE,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,EAAA,EAAI,MAAA,EAAQ,MAAA,CAAO,UAAA,CAAW,QAAQ,CAAA;AAAA,IACjH,SAAS,CAAA,EAAG;AACV,MAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,CAAA,EAAG,CAAC,CAAA;AACpC,MAAA,IAAI,KAAK,OAAO,GAAA;AAChB,MAAA,MAAM,CAAA;AAAA,IACR;AACA,IAAA,MAAM,IAAA,EAAK;AAAA,EACb,CAAA;AACF;AA0BO,SAAS,aAAoC,CAAA,EAAgC;AAClF,EAAA,MAAM,GAAA,GAAM,IAAIA,SAAA,EAAK;AACrB,EAAA,GAAA,CAAI,GAAA,CAAI,GAAA,EAAK,OAAO,CAAA,EAAG,IAAA,KAAS;AAC9B,IAAA,CAAA,CAAE,MAAA,CAAO,iBAAiB,UAAU,CAAA;AACpC,IAAA,MAAM,IAAA,EAAK;AAAA,EACb,CAAC,CAAA;AAKD,EAAA,GAAA,CAAI,GAAA,CAAI,GAAA,EAAK,OAAO,CAAA,EAAG,IAAA,KAAS;AAC9B,IAAA,MAAM,IAAA,GAAO,CAAA,CAAE,GAAA,CAAI,MAAA,CAAO,gBAAgB,CAAA;AAC1C,IAAA,IAAI,CAAA,CAAE,IAAI,MAAA,KAAW,KAAA,IAAS,SAAS,MAAA,IAAa,IAAA,KAAS,aAAA,IAAiB,IAAA,KAAS,MAAA,EAAQ;AAC7F,MAAA,OAAO,EAAE,IAAA,CAAK,EAAE,KAAA,EAAO,YAAA,IAAgB,GAAG,CAAA;AAAA,IAC5C;AACA,IAAA,MAAM,IAAA,EAAK;AAAA,EACb,CAAC,CAAA;AAED,EAAA,GAAA,CAAI,GAAA,CAAI,cAAA,EAAgB,OAAO,CAAA,KAAM;AACnC,IAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA;AAC3B,IAAA,IAAI,CAAC,MAAM,OAAO,CAAA,CAAE,KAAK,EAAE,KAAA,EAAO,iBAAA,EAAkB,EAAG,GAAG,CAAA;AAC1D,IAAA,MAAM,MAAmF,EAAC;AAC1F,IAAA,KAAA,MAAW,KAAK,MAAM,CAAA,CAAE,MAAM,aAAA,CAAc,IAAA,CAAK,EAAE,CAAA,EAAG;AACpD,MAAA,MAAM,IAAI,MAAM,CAAA,CAAE,KAAA,CAAM,UAAA,CAAW,EAAE,QAAQ,CAAA;AAC7C,MAAA,IAAI,CAAA,EAAG,GAAA,CAAI,IAAA,CAAK,EAAE,MAAA,EAAQ,EAAE,EAAA,EAAI,CAAA,CAAE,EAAA,EAAI,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,GAAI,CAAA,CAAE,MAAA,GAAS,EAAE,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,GAAI,EAAC,EAAG,EAAG,IAAA,EAAM,CAAA,CAAE,MAAM,CAAA;AAAA,IAC/H;AACA,IAAA,OAAO,CAAA,CAAE,KAAK,GAAG,CAAA;AAAA,EACnB,CAAC,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK,iBAAA,EAAmB,OAAO,CAAA,KAAM;AACvC,IAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA;AAC3B,IAAA,IAAI,CAAC,MAAM,OAAO,CAAA,CAAE,KAAK,EAAE,KAAA,EAAO,iBAAA,EAAkB,EAAG,GAAG,CAAA;AAC1D,IAAA,MAAM,IAAA,GAAQ,MAAM,CAAA,CAAE,GAAA,CAAI,MAAK,CAAE,KAAA,CAAM,MAAM,IAAI,CAAA;AACjD,IAAA,IAAI,OAAO,IAAA,EAAM,KAAA,KAAU,QAAA,IAAY,KAAK,KAAA,KAAU,EAAA,EAAI,OAAO,CAAA,CAAE,IAAA,CAAK,EAAE,KAAA,EAAO,iBAAA,IAAqB,GAAG,CAAA;AACzG,IAAA,IAAI;AACF,MAAA,MAAM,CAAA,GAAgB,MAAM,YAAA,CAAa,EAAE,OAAO,CAAA,CAAE,KAAA,EAAO,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,IAAA,EAAM,cAAA,EAAgB,CAAA,CAAE,gBAAgB,CAAA;AACtH,MAAA,MAAM,IAAI,MAAM,CAAA,CAAE,KAAA,CAAM,UAAA,CAAW,EAAE,QAAQ,CAAA;AAC7C,MAAA,OAAO,CAAA,CAAE,IAAA,CAAK,EAAE,MAAA,EAAQ,CAAA,GAAI,EAAE,EAAA,EAAI,CAAA,CAAE,EAAA,EAAI,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,MAAM,CAAA,CAAE,IAAA,EAAK,GAAI,EAAE,EAAA,EAAI,CAAA,CAAE,UAAS,EAAG,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,CAAA;AAAA,IAC3G,SAAS,CAAA,EAAG;AACV,MAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,CAAA,EAAG,CAAC,CAAA;AACpC,MAAA,IAAI,KAAK,OAAO,GAAA;AAChB,MAAA,MAAM,CAAA;AAAA,IACR;AAAA,EACF,CAAC,CAAA;AAED,EAAA,IAAI,EAAE,MAAA,EAAQ;AACZ,IAAA,MAAM,MAAM,CAAA,CAAE,MAAA;AACd,IAAA,GAAA,CAAI,IAAA,CAAK,YAAY,iBAAA,CAAkB,GAAA,CAAI,QAAQ,GAAA,CAAI,MAAM,CAAA,EAAG,OAAO,CAAA,KAAM;AAC3E,MAAA,MAAM,MAAA,GAAS,UAAU,CAAC,CAAA;AAC1B,MAAA,MAAM,IAAA,GAAQ,MAAM,CAAA,CAAE,GAAA,CAAI,MAAK,CAAE,KAAA,CAAM,MAAM,IAAI,CAAA;AACjD,MAAA,IAAI,OAAO,IAAA,EAAM,KAAA,KAAU,QAAA,IAAY,CAAC,IAAA,CAAK,KAAA,CAAM,QAAA,CAAS,GAAG,CAAA,IAAK,OAAO,IAAA,CAAK,SAAS,QAAA,EAAU;AACjG,QAAA,OAAO,EAAE,IAAA,CAAK,EAAE,KAAA,EAAO,iBAAA,IAAqB,GAAG,CAAA;AAAA,MACjD;AACA,MAAA,IAAI;AACF,QAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAM,GAAI,MAAM,YAAA,CAAa;AAAA,UAC3C,OAAO,CAAA,CAAE,KAAA;AAAA,UACT,QAAA,EAAU,OAAO,MAAA,CAAO,EAAA;AAAA,UACxB,OAAO,IAAA,CAAK,KAAA;AAAA,UACZ,MAAM,IAAA,CAAK,IAAA;AAAA,UACX,gBAAgB,CAAA,CAAE,cAAA;AAAA,UAClB,SAAA,EAAW,OAAO,UAAA,CAAW;AAAA,SAC9B,CAAA;AACD,QAAA,MAAM,IAAI,aAAA,CAAc,EAAE,EAAA,EAAI,MAAA,CAAO,OAAO,KAAA,EAAO,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAQ,MAAM,MAAA,CAAO,IAAA,EAAM,WAAW,MAAA,CAAO,UAAA,CAAW,QAAQ,CAAA;AAClI,QAAA,OAAO,EAAE,IAAA,CAAK,EAAE,UAAU,MAAA,CAAO,EAAA,IAAM,GAAG,CAAA;AAAA,MAC5C,SAAS,CAAA,EAAG;AACV,QAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,CAAA,EAAG,CAAC,CAAA;AACpC,QAAA,IAAI,KAAK,OAAO,GAAA;AAChB,QAAA,MAAM,CAAA;AAAA,MACR;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,GAAA;AACT","file":"hono.cjs","sourcesContent":["// @broberg/tenant — organisations, memberships, invitations and role checks,\n// the same way in every app (F029).\n//\n// THE SURVEY THAT SHAPED THIS (F029.7, six apps read at named commits): the\n// tenant / membership / invitation shape repeats in five or six of them, and\n// choosing the active organisation is where the bugs are — four of six fall\n// back to «the first membership» or «the first site» without saying so. What\n// does NOT repeat is how tenant data is isolated (a shared DB with tenant_id,\n// a DB per organisation, a directory per site). So this package owns the rules\n// and never the storage: the app implements `TenantStore` against its own\n// database, whatever shape that is.\n//\n// Organisations and memberships never live in Broberg ID (D-5345a2): BID says\n// who the user is, the app says which organisations she belongs to.\n\n// ── Types ──────────────────────────────────────────────────────────────────\n\nexport interface Tenant {\n id: string;\n /** Unique and immutable — the thing a URL or header names. */\n slug: string;\n name: string;\n /** Absent means active. A suspended tenant is refused everywhere. */\n status?: \"active\" | \"suspended\";\n}\n\n/**\n * A user's membership of ONE tenant. `role` is the app's own vocabulary\n * (owner/admin/member, owner/operator/viewer …) — the package never defines it.\n * An app whose members belong to sub-units (Scout's units, cms' sites) derives\n * this organisation-level membership in its store.\n */\nexport interface Membership {\n userId: string;\n tenantId: string;\n role: string;\n}\n\n/** An invitation as stored. The token itself is NEVER stored — only its hash. */\nexport interface StoredInvite {\n id: string;\n tenantId: string;\n /** Lower-cased and trimmed. */\n email: string;\n role: string;\n tokenHash: string;\n invitedBy?: string;\n createdAt: number;\n expiresAt: number;\n usedAt?: number;\n usedBy?: string;\n revokedAt?: number;\n}\n\n/**\n * Where tenant data lives — implemented by the app against its own database.\n * The package calls only these; it never opens a tenant database itself.\n */\nexport interface TenantStore {\n tenantById(id: string): Promise<Tenant | null>;\n tenantBySlug(slug: string): Promise<Tenant | null>;\n /** Every membership the user has, across tenants. */\n membershipsOf(userId: string): Promise<Membership[]>;\n /** Idempotent: adding an existing (userId, tenantId) must not duplicate it. */\n addMembership(m: Membership): Promise<void>;\n /** Insert, or replace the invite with the same id. */\n saveInvite(invite: StoredInvite): Promise<void>;\n inviteByTokenHash(tokenHash: string): Promise<StoredInvite | null>;\n /**\n * Mark the invite used — ATOMICALLY: return true only for the call that\n * changed it from unused, false when it was already used. This is what makes\n * an invitation single-use when two requests race.\n */\n markInviteUsed(id: string, at: number, userId: string): Promise<boolean>;\n}\n\n// ── Errors ─────────────────────────────────────────────────────────────────\n\n/** Base class. Every refusal in this package is one of these, never a null. */\nexport class TenantError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"TenantError\";\n }\n}\n\nexport class TenantNotFound extends TenantError {\n constructor(readonly slug: string) {\n super(`No tenant \"${slug}\".`);\n this.name = \"TenantNotFound\";\n }\n}\n\nexport class TenantNotMember extends TenantError {\n constructor(readonly slug: string) {\n super(`The user is not a member of \"${slug}\".`);\n this.name = \"TenantNotMember\";\n }\n}\n\nexport class TenantSuspended extends TenantError {\n constructor(readonly slug: string) {\n super(`Tenant \"${slug}\" is suspended.`);\n this.name = \"TenantSuspended\";\n }\n}\n\n/** The user has no usable membership at all. */\nexport class TenantNoMembership extends TenantError {\n constructor() {\n super(\"The user has no active membership of any tenant.\");\n this.name = \"TenantNoMembership\";\n }\n}\n\n/**\n * Several memberships, no request, no usable preference, and no rule from the\n * app for choosing. Refused rather than picking «the first row» — the bug the\n * survey found in four apps. The app supplies `pickDefault` to decide.\n */\nexport class TenantChoiceRequired extends TenantError {\n constructor(readonly count: number) {\n super(`The user is a member of ${count} tenants and nothing says which one — pass pickDefault.`);\n this.name = \"TenantChoiceRequired\";\n }\n}\n\nexport type InviteRefusal = \"not_found\" | \"expired\" | \"revoked\" | \"used\" | \"email_mismatch\" | \"role_not_invitable\";\n\nexport class InviteRefused extends TenantError {\n constructor(readonly reason: InviteRefusal) {\n super(`Invitation refused: ${reason}.`);\n this.name = \"InviteRefused\";\n }\n}\n\nexport class TenantForbidden extends TenantError {\n constructor(\n readonly role: string,\n readonly action: string,\n ) {\n super(`Role \"${role}\" may not \"${action}\".`);\n this.name = \"TenantForbidden\";\n }\n}\n\n// ── Choosing the active tenant ─────────────────────────────────────────────\n\nexport type FallbackReason = \"not_found\" | \"not_member\" | \"suspended\";\n\nexport interface ActiveTenant {\n tenant: Tenant;\n membership: Membership;\n /**\n * True when a STORED preference could not be used and another of the user's\n * own memberships was chosen. The app should clear the stale preference, and\n * the UI should say which tenant is active.\n */\n fellBack: boolean;\n reason?: FallbackReason;\n}\n\nexport interface ResolveInput {\n store: TenantStore;\n userId: string;\n /**\n * An explicit choice for THIS request (path slug, header). STRICT: if the\n * user cannot use it, the call throws — otherwise an answer would be shown\n * under the wrong tenant's name.\n */\n requested?: string | null;\n /**\n * A standing preference (cookie, a stored «active tenant»). It goes stale\n * for innocent reasons — a revoked membership, a deleted tenant — and a hard\n * refusal there would lock the user out of her own system. So it falls back,\n * but only to one of the user's OWN memberships, and says so (trail's\n * pattern, F029 #1976).\n */\n preferred?: string | null;\n /**\n * The app's rule for choosing among several usable memberships when there is\n * no request and no usable preference (e.g. the most recently used). Without\n * it, one membership is chosen and several are refused (TenantChoiceRequired).\n */\n pickDefault?: (usable: { tenant: Tenant; membership: Membership }[]) => { tenant: Tenant; membership: Membership } | undefined;\n}\n\ntype Usable = { tenant: Tenant; membership: Membership };\n\nasync function memberships(store: TenantStore, userId: string): Promise<{ all: Membership[]; usable: Usable[] }> {\n const all = await store.membershipsOf(userId);\n const usable: Usable[] = [];\n for (const m of all) {\n const tenant = await store.tenantById(m.tenantId);\n if (tenant && tenant.status !== \"suspended\") usable.push({ tenant, membership: m });\n }\n return { all, usable };\n}\n\n/**\n * Why `slug` cannot be used by this user. «Suspended» is only said to a\n * MEMBER of that tenant — to anyone else a suspended tenant is simply one they\n * are not a member of, so its existence is not revealed.\n */\nasync function check(store: TenantStore, slug: string, m: { all: Membership[]; usable: Usable[] }): Promise<{ ok: Usable } | { why: FallbackReason }> {\n const tenant = await store.tenantBySlug(slug);\n if (!tenant) return { why: \"not_found\" };\n const isMember = m.all.some((x) => x.tenantId === tenant.id);\n if (!isMember) return { why: \"not_member\" };\n if (tenant.status === \"suspended\") return { why: \"suspended\" };\n const hit = m.usable.find((u) => u.tenant.id === tenant.id);\n return hit ? { ok: hit } : { why: \"not_member\" };\n}\n\n/**\n * The tenant this request acts in. Never returns a tenant outside the user's\n * own memberships, in any mode.\n */\nexport async function resolveActiveTenant(input: ResolveInput): Promise<ActiveTenant> {\n const { store, userId } = input;\n const ms = await memberships(store, userId);\n const usable = ms.usable;\n\n if (input.requested) {\n const r = await check(store, input.requested, ms);\n if (\"ok\" in r) return { ...r.ok, fellBack: false };\n if (r.why === \"not_found\") throw new TenantNotFound(input.requested);\n if (r.why === \"suspended\") throw new TenantSuspended(input.requested);\n throw new TenantNotMember(input.requested);\n }\n\n let reason: FallbackReason | undefined;\n if (input.preferred) {\n const r = await check(store, input.preferred, ms);\n if (\"ok\" in r) return { ...r.ok, fellBack: false };\n reason = r.why;\n }\n\n if (usable.length === 0) throw new TenantNoMembership();\n const chosen = input.pickDefault ? input.pickDefault(usable) : usable.length === 1 ? usable[0] : undefined;\n // The app's rule may only choose among the user's own memberships.\n if (!chosen || !usable.some((u) => u.tenant.id === chosen.tenant.id && u.membership.userId === userId)) {\n throw new TenantChoiceRequired(usable.length);\n }\n return { tenant: chosen.tenant, membership: chosen.membership, fellBack: reason !== undefined, ...(reason ? { reason } : {}) };\n}\n\n// ── Invitations ────────────────────────────────────────────────────────────\n\nconst DAY = 24 * 60 * 60 * 1000;\nexport const DEFAULT_INVITE_TTL_MS = 7 * DAY;\n\nconst normEmail = (e: string) => e.trim().toLowerCase();\n\nfunction b64url(bytes: Uint8Array): string {\n let s = \"\";\n for (const b of bytes) s += String.fromCharCode(b);\n return btoa(s).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n}\n\n/** SHA-256 of the token, hex. The only form a token is ever stored in. */\nexport async function hashInviteToken(token: string): Promise<string> {\n const digest = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(token));\n return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nexport interface CreateInviteInput {\n store: TenantStore;\n tenantId: string;\n email: string;\n role: string;\n /**\n * The roles an invitation may grant. A role outside it is refused — an\n * invitation can never be the way to become owner or platform admin unless\n * the app says so (helpdesk's rule).\n */\n invitableRoles: readonly string[];\n invitedBy?: string;\n ttlMs?: number;\n now?: number;\n}\n\n/**\n * Create an invitation. Returns the token ONCE — put it in the link you mail\n * (via @broberg/mail in the app). Only its hash is stored.\n */\nexport async function createInvite(input: CreateInviteInput): Promise<{ invite: StoredInvite; token: string }> {\n if (!input.invitableRoles.includes(input.role)) throw new InviteRefused(\"role_not_invitable\");\n const tenant = await input.store.tenantById(input.tenantId);\n if (!tenant) throw new TenantNotFound(input.tenantId);\n if (tenant.status === \"suspended\") throw new TenantSuspended(tenant.slug);\n const token = b64url(crypto.getRandomValues(new Uint8Array(32)));\n const now = input.now ?? Date.now();\n const invite: StoredInvite = {\n id: b64url(crypto.getRandomValues(new Uint8Array(12))),\n tenantId: tenant.id,\n email: normEmail(input.email),\n role: input.role,\n tokenHash: await hashInviteToken(token),\n ...(input.invitedBy ? { invitedBy: input.invitedBy } : {}),\n createdAt: now,\n expiresAt: now + (input.ttlMs ?? DEFAULT_INVITE_TTL_MS),\n };\n await input.store.saveInvite(invite);\n return { invite, token };\n}\n\nexport interface AcceptInviteInput {\n store: TenantStore;\n token: string;\n /** The SIGNED-IN user. Her email must match the invitation. */\n user: { id: string; email: string };\n /** Checked again on accept, so a tampered stored role cannot slip through. */\n invitableRoles: readonly string[];\n now?: number;\n}\n\n/**\n * Accept an invitation: one use, before it expires, by the user it was sent\n * to. Repeating the accept as the SAME user is safe and returns the same\n * membership; anyone else gets `used`.\n */\nexport async function acceptInvite(input: AcceptInviteInput): Promise<Membership> {\n const { store, user } = input;\n const now = input.now ?? Date.now();\n const invite = await store.inviteByTokenHash(await hashInviteToken(input.token));\n if (!invite) throw new InviteRefused(\"not_found\");\n if (invite.revokedAt !== undefined) throw new InviteRefused(\"revoked\");\n if (normEmail(user.email) !== invite.email) throw new InviteRefused(\"email_mismatch\");\n if (!input.invitableRoles.includes(invite.role)) throw new InviteRefused(\"role_not_invitable\");\n const membership: Membership = { userId: user.id, tenantId: invite.tenantId, role: invite.role };\n\n if (invite.usedAt !== undefined) {\n if (invite.usedBy !== user.id) throw new InviteRefused(\"used\");\n await store.addMembership(membership); // heals a half-finished earlier accept\n return membership;\n }\n if (now >= invite.expiresAt) throw new InviteRefused(\"expired\");\n const tenant = await store.tenantById(invite.tenantId);\n if (!tenant) throw new TenantNotFound(invite.tenantId);\n if (tenant.status === \"suspended\") throw new TenantSuspended(tenant.slug);\n\n // Claim it first, atomically: of two racing accepts exactly one gets true.\n if (!(await store.markInviteUsed(invite.id, now, user.id))) {\n const again = await store.inviteByTokenHash(invite.tokenHash);\n if (again?.usedBy !== user.id) throw new InviteRefused(\"used\");\n }\n await store.addMembership(membership);\n return membership;\n}\n\n/**\n * Revoke an invitation that has not been used yet. Pass the stored invite (the\n * app lists its own invites); an accept after this is refused with `revoked`.\n */\nexport async function revokeInvite(input: { store: TenantStore; invite: StoredInvite; now?: number }): Promise<StoredInvite> {\n const revoked = { ...input.invite, revokedAt: input.now ?? Date.now() };\n await input.store.saveInvite(revoked);\n return revoked;\n}\n\n// ── Role checks (RBAC) ─────────────────────────────────────────────────────\n\nexport interface PolicyConfig<Action extends string> {\n /** role → the actions it may do. `\"*\"` grants every action. Unknown roles may do nothing. */\n roles: Record<string, readonly (Action | \"*\")[]>;\n /** Called on every refusal from `assert` — the place for an audit row. */\n onDenied?: (denial: { role: string; action: Action; context?: unknown }) => void | Promise<void>;\n}\n\nexport interface Policy<Action extends string> {\n can(role: string, action: Action): boolean;\n /** Throws TenantForbidden (after onDenied) when the membership's role may not. */\n assert(membership: Pick<Membership, \"role\">, action: Action, context?: unknown): Promise<void>;\n}\n\n/**\n * The app's role matrix as a checker. Deny by default: a role or an action\n * that is not listed is refused.\n */\nexport function createPolicy<Action extends string>(config: PolicyConfig<Action>): Policy<Action> {\n const can = (role: string, action: Action): boolean => {\n const allowed = Object.prototype.hasOwnProperty.call(config.roles, role) ? config.roles[role] : undefined;\n return !!allowed && (allowed.includes(\"*\") || allowed.includes(action));\n };\n return {\n can,\n async assert(membership, action, context) {\n if (can(membership.role, action)) return;\n await config.onDenied?.({ role: membership.role, action, ...(context !== undefined ? { context } : {}) });\n throw new TenantForbidden(membership.role, action);\n },\n };\n}\n\n// ── In-memory store (tests, one dev process) ───────────────────────────────\n\n/**\n * A TenantStore in this process's memory. For tests and a single dev process\n * only — it forgets everything on restart. Doubles as the reference for what\n * an app's own store must do (note markInviteUsed's atomicity).\n */\nexport function memoryTenantStore(seed: { tenants?: Tenant[]; memberships?: Membership[] } = {}): TenantStore & {\n readonly invites: ReadonlyMap<string, StoredInvite>;\n} {\n const tenants = new Map((seed.tenants ?? []).map((t) => [t.id, { ...t }]));\n const memberships: Membership[] = (seed.memberships ?? []).map((m) => ({ ...m }));\n const invites = new Map<string, StoredInvite>();\n return {\n invites,\n async tenantById(id) {\n return tenants.get(id) ?? null;\n },\n async tenantBySlug(slug) {\n for (const t of tenants.values()) if (t.slug === slug) return t;\n return null;\n },\n async membershipsOf(userId) {\n return memberships.filter((m) => m.userId === userId).map((m) => ({ ...m }));\n },\n async addMembership(m) {\n if (!memberships.some((x) => x.userId === m.userId && x.tenantId === m.tenantId)) memberships.push({ ...m });\n },\n async saveInvite(invite) {\n invites.set(invite.id, { ...invite });\n },\n async inviteByTokenHash(hash) {\n for (const i of invites.values()) if (i.tokenHash === hash) return { ...i };\n return null;\n },\n async markInviteUsed(id, at, userId) {\n const i = invites.get(id);\n if (!i || i.usedAt !== undefined) return false;\n invites.set(id, { ...i, usedAt: at, usedBy: userId });\n return true;\n },\n };\n}\n","// @broberg/tenant/hono — the tenant rules as Hono middleware and routes (F029.9).\n//\n// Every refusal is JSON with a status, never a redirect: these sit in front of\n// APIs, and a fetch cannot follow a redirect to a login page (the reason\n// sso.require is wrong in front of an API, F097).\nimport { Hono, type Context, type MiddlewareHandler } from \"hono\";\nimport {\n acceptInvite,\n createInvite,\n resolveActiveTenant,\n type ActiveTenant,\n type Membership,\n type Policy,\n type ResolveInput,\n type Tenant,\n type TenantStore,\n} from \"./index.js\";\n\n/** The signed-in user, as the app knows her — from @broberg/sso's session, or anything else. */\nexport interface TenantUser {\n id: string;\n email: string;\n}\n\ntype UserFn = (c: Context) => TenantUser | null | Promise<TenantUser | null>;\n\nconst TENANT_KEY = \"broberg.tenant\";\n\n/** The active tenant set by tenantMiddleware, or null outside it. */\nexport function getTenant(c: Context): ActiveTenant | null {\n return (c.get(TENANT_KEY as never) as ActiveTenant | undefined) ?? null;\n}\n\n/**\n * Errors are matched by NAME, not instanceof: an app may build its store or\n * policy from the main entry, which is a separate bundle with its own copies\n * of the classes (the lesson from @broberg/sso's accountRoutes).\n */\nfunction nameOf(e: unknown): string | undefined {\n return e instanceof Error ? e.name : undefined;\n}\n\n/**\n * JSON for every refusal this package makes. TenantNotFound and TenantNotMember\n * are the SAME 404 on purpose: a non-member must not be able to learn which\n * tenant slugs exist. TenantSuspended is only ever thrown to a member (the core\n * decides that), so its 403 reveals nothing new.\n */\nexport function tenantErrorResponse(c: Context, e: unknown): Response | null {\n const err = e as { reason?: string; count?: number; action?: string };\n switch (nameOf(e)) {\n case \"TenantNotFound\":\n case \"TenantNotMember\":\n return c.json({ error: \"tenant_not_found\" }, 404);\n case \"TenantSuspended\":\n return c.json({ error: \"tenant_suspended\" }, 403);\n case \"TenantNoMembership\":\n return c.json({ error: \"no_tenant\" }, 403);\n case \"TenantChoiceRequired\":\n return c.json({ error: \"tenant_choice_required\", count: err.count }, 409);\n case \"TenantForbidden\":\n return c.json({ error: \"forbidden\", action: err.action }, 403);\n case \"InviteRefused\": {\n const status = ({ not_found: 404, expired: 410, revoked: 410, used: 409, email_mismatch: 403, role_not_invitable: 403 } as const)[\n err.reason as \"not_found\"\n ];\n return c.json({ error: `invite_${err.reason}` }, status ?? 400);\n }\n default:\n return null;\n }\n}\n\nexport interface TenantMiddlewareOptions extends Pick<ResolveInput, \"pickDefault\"> {\n store: TenantStore;\n user: UserFn;\n /** The explicit tenant for THIS request (strict) — e.g. `(c) => c.req.param(\"tenant\")`. */\n requested?: (c: Context) => string | null | undefined;\n /** The standing preference (may fall back) — e.g. a cookie. */\n preferred?: (c: Context) => string | null | undefined;\n /** Called when the preference was stale and another of the user's memberships was used — clear it here. */\n onFellBack?: (c: Context, active: ActiveTenant) => void | Promise<void>;\n}\n\n/**\n * Resolve the tenant for this request and put it on the context (`getTenant(c)`).\n * 401 without a user, 404 for a tenant that is not hers (whether or not it\n * exists), 403 suspended / no tenant, 409 when several memberships and nothing\n * says which.\n */\nexport function tenantMiddleware(o: TenantMiddlewareOptions): MiddlewareHandler {\n return async (c, next) => {\n const user = await o.user(c);\n if (!user) return c.json({ error: \"unauthenticated\" }, 401);\n let active: ActiveTenant;\n try {\n active = await resolveActiveTenant({\n store: o.store,\n userId: user.id,\n requested: o.requested?.(c) ?? null,\n preferred: o.preferred?.(c) ?? null,\n ...(o.pickDefault ? { pickDefault: o.pickDefault } : {}),\n });\n } catch (e) {\n const res = tenantErrorResponse(c, e);\n if (res) return res;\n throw e;\n }\n if (active.fellBack) await o.onFellBack?.(c, active);\n c.set(TENANT_KEY as never, active as never);\n await next();\n };\n}\n\n/**\n * RBAC for one route: the active membership's role must be allowed `action`\n * by the app's policy. 403 JSON after the policy's onDenied (the audit hook).\n * Must run after tenantMiddleware — without it the route is refused, never\n * opened (fail closed).\n */\nexport function requireCapability<Action extends string>(policy: Policy<Action>, action: Action): MiddlewareHandler {\n return async (c, next) => {\n const active = getTenant(c);\n if (!active) return c.json({ error: \"no_tenant_context\" }, 500);\n try {\n await policy.assert(active.membership, action, { tenantId: active.tenant.id, userId: active.membership.userId });\n } catch (e) {\n const res = tenantErrorResponse(c, e);\n if (res) return res;\n throw e;\n }\n await next();\n };\n}\n\nexport interface TenantRoutesOptions<Action extends string> {\n store: TenantStore;\n user: UserFn;\n /** The roles an invitation may grant (never owner or platform unless you list it). */\n invitableRoles: readonly string[];\n /**\n * Inviting needs the active tenant (put tenantMiddleware before this app's\n * /invites route), this action in the policy, AND a way to deliver the link.\n * Without `deliverInvite` the route is not mounted: the token never travels\n * back to the inviter's browser.\n */\n invite?: {\n policy: Policy<Action>;\n action: Action;\n deliverInvite: (msg: { to: string; token: string; tenant: Tenant; role: string; invitedBy: string }) => Promise<void>;\n };\n}\n\n/**\n * JSON routes for the membership surface:\n * GET /memberships → [{ tenant: {id, slug, name, status}, role }] for the signed-in user\n * POST /invites/accept {token} → { tenant, role }\n * POST /invites {email, role} → { inviteId } (only with `invite`, needs tenantMiddleware)\n */\nexport function tenantRoutes<Action extends string>(o: TenantRoutesOptions<Action>) {\n const app = new Hono();\n app.use(\"*\", async (c, next) => {\n c.header(\"Cache-Control\", \"no-store\");\n await next();\n });\n // A write from ANOTHER site is refused. SameSite=Lax stops a foreign domain\n // but not a sibling subdomain (same site). Browsers send Sec-Fetch-Site on\n // every request; a non-browser caller sends none and is let through. Same\n // guard as @broberg/sso's accountRoutes.\n app.use(\"*\", async (c, next) => {\n const site = c.req.header(\"sec-fetch-site\");\n if (c.req.method !== \"GET\" && site !== undefined && site !== \"same-origin\" && site !== \"none\") {\n return c.json({ error: \"cross_site\" }, 403);\n }\n await next();\n });\n\n app.get(\"/memberships\", async (c) => {\n const user = await o.user(c);\n if (!user) return c.json({ error: \"unauthenticated\" }, 401);\n const out: { tenant: Pick<Tenant, \"id\" | \"slug\" | \"name\" | \"status\">; role: string }[] = [];\n for (const m of await o.store.membershipsOf(user.id)) {\n const t = await o.store.tenantById(m.tenantId);\n if (t) out.push({ tenant: { id: t.id, slug: t.slug, name: t.name, ...(t.status ? { status: t.status } : {}) }, role: m.role });\n }\n return c.json(out);\n });\n\n app.post(\"/invites/accept\", async (c) => {\n const user = await o.user(c);\n if (!user) return c.json({ error: \"unauthenticated\" }, 401);\n const body = (await c.req.json().catch(() => null)) as { token?: unknown } | null;\n if (typeof body?.token !== \"string\" || body.token === \"\") return c.json({ error: \"invalid_request\" }, 400);\n try {\n const m: Membership = await acceptInvite({ store: o.store, token: body.token, user, invitableRoles: o.invitableRoles });\n const t = await o.store.tenantById(m.tenantId);\n return c.json({ tenant: t ? { id: t.id, slug: t.slug, name: t.name } : { id: m.tenantId }, role: m.role });\n } catch (e) {\n const res = tenantErrorResponse(c, e);\n if (res) return res;\n throw e;\n }\n });\n\n if (o.invite) {\n const inv = o.invite;\n app.post(\"/invites\", requireCapability(inv.policy, inv.action), async (c) => {\n const active = getTenant(c)!;\n const body = (await c.req.json().catch(() => null)) as { email?: unknown; role?: unknown } | null;\n if (typeof body?.email !== \"string\" || !body.email.includes(\"@\") || typeof body.role !== \"string\") {\n return c.json({ error: \"invalid_request\" }, 400);\n }\n try {\n const { invite, token } = await createInvite({\n store: o.store,\n tenantId: active.tenant.id,\n email: body.email,\n role: body.role,\n invitableRoles: o.invitableRoles,\n invitedBy: active.membership.userId,\n });\n await inv.deliverInvite({ to: invite.email, token, tenant: active.tenant, role: invite.role, invitedBy: active.membership.userId });\n return c.json({ inviteId: invite.id }, 201);\n } catch (e) {\n const res = tenantErrorResponse(c, e);\n if (res) return res;\n throw e;\n }\n });\n }\n\n return app;\n}\n"]}