@broberg/tenant 0.1.0 → 0.2.1
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 +18 -3
- package/dist/hono.cjs +27 -4
- package/dist/hono.cjs.map +1 -1
- package/dist/hono.d.cts +31 -3
- package/dist/hono.d.ts +31 -3
- package/dist/hono.js +27 -4
- package/dist/hono.js.map +1 -1
- package/dist/index.cjs +15 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +34 -5
- package/dist/index.d.ts +34 -5
- package/dist/index.js +15 -2
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Organisations, memberships, invitations and role checks, the same way in every app.
|
|
4
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
|
|
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 BrobergID: BID says who the user is, and your app says which organisations she belongs to (D-5345a2).
|
|
6
6
|
|
|
7
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
8
|
|
|
@@ -49,6 +49,19 @@ const membership = await acceptInvite({ store, token, user: { id, email }, invit
|
|
|
49
49
|
|
|
50
50
|
Refusals are `InviteRefused` with `reason`: `not_found`, `expired`, `revoked`, `used`, `email_mismatch` or `role_not_invitable`.
|
|
51
51
|
|
|
52
|
+
### Inviting to a unit below the organisation: `scope` (0.2.0)
|
|
53
|
+
|
|
54
|
+
```ts
|
|
55
|
+
await createInvite({ store, tenantId, email, role: "unit_lead", scope: unitId, invitableRoles });
|
|
56
|
+
const grant = await acceptInvite({ store, token, user, invitableRoles }); // { userId, tenantId, role, scope }
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
- `scope` is **opaque**: a unit, a site, whatever your app has below the organisation. The package stores it and never interprets it.
|
|
60
|
+
- On accept it goes **into `store.addMembership`** (a `MembershipGrant`), not only into the return value. That way, a crash between the two writes is repaired by the same-user re-accept, unit included.
|
|
61
|
+
- **Whether the inviter may grant that scope is your check.** Only your app knows its unit tree. Do it before `createInvite`; the Hono route asks `authorizeScope` (below).
|
|
62
|
+
- **Write side only.** `membershipsOf` still returns ONE organisation-level row per tenant, with no scope. A user in two units of one organisation is one tenant choice, not a `tenant_choice_required`.
|
|
63
|
+
- With scopes, make `addMembership` idempotent on `(userId, tenantId, scope)`, and let a scoped grant also make the user a member of the organisation.
|
|
64
|
+
|
|
52
65
|
## Role checks (RBAC)
|
|
53
66
|
|
|
54
67
|
```ts
|
|
@@ -71,7 +84,7 @@ interface TenantStore {
|
|
|
71
84
|
tenantById(id): Promise<Tenant | null>;
|
|
72
85
|
tenantBySlug(slug): Promise<Tenant | null>;
|
|
73
86
|
membershipsOf(userId): Promise<Membership[]>; // across tenants; derive it if members belong to units
|
|
74
|
-
addMembership(m): Promise<void>;
|
|
87
|
+
addMembership(m: MembershipGrant): Promise<void>; // idempotent; on (userId, tenantId, scope) when scoped
|
|
75
88
|
saveInvite(invite): Promise<void>; // insert or replace by id
|
|
76
89
|
inviteByTokenHash(hash): Promise<StoredInvite | null>;
|
|
77
90
|
markInviteUsed(id, at, userId): Promise<boolean>; // ATOMIC: true only for the call that claimed it
|
|
@@ -118,7 +131,9 @@ app.route("/api/me", tenantRoutes({ store, user, invitableRoles: ["member", "adm
|
|
|
118
131
|
| several memberships, nothing says which | `409 {"error":"tenant_choice_required","count":n}` |
|
|
119
132
|
| role may not | `403 {"error":"forbidden","action":"…"}`, after your `onDenied` |
|
|
120
133
|
| `requireCapability` without `tenantMiddleware` in front | `500 {"error":"no_tenant_context"}`: closed, never open |
|
|
134
|
+
| `POST /invites` with `scope`, no `authorizeScope` given | `400 {"error":"invalid_request"}`: never silently dropped |
|
|
135
|
+
| `authorizeScope` answers false | `403 {"error":"scope_not_allowed"}` |
|
|
121
136
|
| invitation refusals | `invite_not_found` 404 · `invite_expired`/`invite_revoked` 410 · `invite_used` 409 · `invite_email_mismatch`/`invite_role_not_invitable` 403 |
|
|
122
137
|
| a write from another site, sibling subdomains included (`Sec-Fetch-Site`) | `403 {"error":"cross_site"}` |
|
|
123
138
|
|
|
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.
|
|
139
|
+
`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 }`. A body with `scope` needs `invite.authorizeScope(inviter, scope, role)`, and `deliverInvite` then receives `scope` too. `revokeInvite({ store, invite })` in the core revokes an invitation that has not been used.
|
package/dist/hono.cjs
CHANGED
|
@@ -123,6 +123,7 @@ async function createInvite(input) {
|
|
|
123
123
|
tenantId: tenant.id,
|
|
124
124
|
email: normEmail(input.email),
|
|
125
125
|
role: input.role,
|
|
126
|
+
...input.scope !== void 0 ? { scope: input.scope } : {},
|
|
126
127
|
tokenHash: await hashInviteToken(token),
|
|
127
128
|
...input.invitedBy ? { invitedBy: input.invitedBy } : {},
|
|
128
129
|
createdAt: now,
|
|
@@ -139,7 +140,12 @@ async function acceptInvite(input) {
|
|
|
139
140
|
if (invite.revokedAt !== void 0) throw new InviteRefused("revoked");
|
|
140
141
|
if (normEmail(user.email) !== invite.email) throw new InviteRefused("email_mismatch");
|
|
141
142
|
if (!input.invitableRoles.includes(invite.role)) throw new InviteRefused("role_not_invitable");
|
|
142
|
-
const membership = {
|
|
143
|
+
const membership = {
|
|
144
|
+
userId: user.id,
|
|
145
|
+
tenantId: invite.tenantId,
|
|
146
|
+
role: invite.role,
|
|
147
|
+
...invite.scope !== void 0 ? { scope: invite.scope } : {}
|
|
148
|
+
};
|
|
143
149
|
if (invite.usedAt !== void 0) {
|
|
144
150
|
if (invite.usedBy !== user.id) throw new InviteRefused("used");
|
|
145
151
|
await store.addMembership(membership);
|
|
@@ -255,7 +261,11 @@ function tenantRoutes(o) {
|
|
|
255
261
|
try {
|
|
256
262
|
const m = await acceptInvite({ store: o.store, token: body.token, user, invitableRoles: o.invitableRoles });
|
|
257
263
|
const t = await o.store.tenantById(m.tenantId);
|
|
258
|
-
return c.json({
|
|
264
|
+
return c.json({
|
|
265
|
+
tenant: t ? { id: t.id, slug: t.slug, name: t.name } : { id: m.tenantId },
|
|
266
|
+
role: m.role,
|
|
267
|
+
...m.scope !== void 0 ? { scope: m.scope } : {}
|
|
268
|
+
});
|
|
259
269
|
} catch (e) {
|
|
260
270
|
const res = tenantErrorResponse(c, e);
|
|
261
271
|
if (res) return res;
|
|
@@ -270,6 +280,11 @@ function tenantRoutes(o) {
|
|
|
270
280
|
if (typeof body?.email !== "string" || !body.email.includes("@") || typeof body.role !== "string") {
|
|
271
281
|
return c.json({ error: "invalid_request" }, 400);
|
|
272
282
|
}
|
|
283
|
+
const scope = body.scope;
|
|
284
|
+
if (scope !== void 0) {
|
|
285
|
+
if (typeof scope !== "string" || scope === "" || !inv.authorizeScope) return c.json({ error: "invalid_request" }, 400);
|
|
286
|
+
if (!await inv.authorizeScope(active.membership, scope, body.role)) return c.json({ error: "scope_not_allowed" }, 403);
|
|
287
|
+
}
|
|
273
288
|
try {
|
|
274
289
|
const { invite, token } = await createInvite({
|
|
275
290
|
store: o.store,
|
|
@@ -277,9 +292,17 @@ function tenantRoutes(o) {
|
|
|
277
292
|
email: body.email,
|
|
278
293
|
role: body.role,
|
|
279
294
|
invitableRoles: o.invitableRoles,
|
|
280
|
-
invitedBy: active.membership.userId
|
|
295
|
+
invitedBy: active.membership.userId,
|
|
296
|
+
...scope !== void 0 ? { scope } : {}
|
|
297
|
+
});
|
|
298
|
+
await inv.deliverInvite({
|
|
299
|
+
to: invite.email,
|
|
300
|
+
token,
|
|
301
|
+
tenant: active.tenant,
|
|
302
|
+
role: invite.role,
|
|
303
|
+
invitedBy: active.membership.userId,
|
|
304
|
+
...invite.scope !== void 0 ? { scope: invite.scope } : {}
|
|
281
305
|
});
|
|
282
|
-
await inv.deliverInvite({ to: invite.email, token, tenant: active.tenant, role: invite.role, invitedBy: active.membership.userId });
|
|
283
306
|
return c.json({ inviteId: invite.id }, 201);
|
|
284
307
|
} catch (e) {
|
|
285
308
|
const res = tenantErrorResponse(c, e);
|
package/dist/hono.cjs.map
CHANGED
|
@@ -1 +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"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/hono.ts"],"names":["Hono"],"mappings":"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","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 BrobergID (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/**\n * What accepting an invitation WRITES: a Membership plus the invitation's\n * `scope`, when it had one. `scope` is opaque to the package — Scout puts a\n * unit id there. It exists only on the write side: `membershipsOf` keeps\n * returning ONE organisation-level Membership per tenant, so a user in two\n * units of one org is still one tenant choice with one role.\n */\nexport interface MembershipGrant extends Membership {\n scope?: 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 /** Opaque to the package; carried into addMembership on accept. */\n scope?: 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 /**\n * Every membership the user has, across tenants — ONE organisation-level row\n * per tenant, never one per scope (derive it, as Scout does from units).\n */\n membershipsOf(userId: string): Promise<Membership[]>;\n /**\n * Idempotent: adding an existing (userId, tenantId) must not duplicate it —\n * keyed (userId, tenantId, scope) when the grant carries a scope. A grant\n * with a scope must also leave the user a member of the tenant as a whole.\n */\n addMembership(m: MembershipGrant): 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 * Opaque — a unit, a site, whatever level below the organisation the app\n * has. The package stores it and hands it to addMembership on accept; it\n * never checks it. Whether the INVITER may grant this scope is the app's\n * check, made before calling createInvite (the /hono route asks\n * `authorizeScope`).\n */\n scope?: 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 ...(input.scope !== undefined ? { scope: input.scope } : {}),\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<MembershipGrant> {\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: MembershipGrant = {\n userId: user.id,\n tenantId: invite.tenantId,\n role: invite.role,\n ...(invite.scope !== undefined ? { scope: invite.scope } : {}),\n };\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 /** Every scoped grant written by addMembership, in order. */\n readonly grants: readonly MembershipGrant[];\n} {\n const tenants = new Map((seed.tenants ?? []).map((t) => [t.id, { ...t }]));\n const memberships: Membership[] = (seed.memberships ?? []).map((m) => ({ ...m }));\n const grants: MembershipGrant[] = [];\n const invites = new Map<string, StoredInvite>();\n return {\n invites,\n grants,\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 // A scoped grant is kept apart; the org-level row (first role wins) is\n // what membershipsOf answers — a real store derives that role its own way.\n if (m.scope !== undefined && !grants.some((x) => x.userId === m.userId && x.tenantId === m.tenantId && x.scope === m.scope)) {\n grants.push({ ...m });\n }\n if (!memberships.some((x) => x.userId === m.userId && x.tenantId === m.tenantId)) {\n memberships.push({ userId: m.userId, tenantId: m.tenantId, role: m.role });\n }\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 MembershipGrant,\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; scope?: string }) => Promise<void>;\n /**\n * Required for an invitation with a `scope` (a unit below the organisation).\n * Only the app knows its unit tree, so only the app can say whether THIS\n * inviter may grant this role there. Without it a body carrying `scope` is\n * refused 400; a false answer is refused 403 `scope_not_allowed`. A scope is\n * never silently dropped.\n */\n authorizeScope?: (inviter: Membership, scope: string, role: string) => boolean | Promise<boolean>;\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: MembershipGrant = 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({\n tenant: t ? { id: t.id, slug: t.slug, name: t.name } : { id: m.tenantId },\n role: m.role,\n ...(m.scope !== undefined ? { scope: m.scope } : {}),\n });\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; scope?: 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 const scope = body.scope;\n if (scope !== undefined) {\n if (typeof scope !== \"string\" || scope === \"\" || !inv.authorizeScope) return c.json({ error: \"invalid_request\" }, 400);\n if (!(await inv.authorizeScope(active.membership, scope, body.role))) return c.json({ error: \"scope_not_allowed\" }, 403);\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 ...(scope !== undefined ? { scope } : {}),\n });\n await inv.deliverInvite({\n to: invite.email,\n token,\n tenant: active.tenant,\n role: invite.role,\n invitedBy: active.membership.userId,\n ...(invite.scope !== undefined ? { scope: invite.scope } : {}),\n });\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"]}
|
package/dist/hono.d.cts
CHANGED
|
@@ -20,6 +20,16 @@ interface Membership {
|
|
|
20
20
|
tenantId: string;
|
|
21
21
|
role: string;
|
|
22
22
|
}
|
|
23
|
+
/**
|
|
24
|
+
* What accepting an invitation WRITES: a Membership plus the invitation's
|
|
25
|
+
* `scope`, when it had one. `scope` is opaque to the package — Scout puts a
|
|
26
|
+
* unit id there. It exists only on the write side: `membershipsOf` keeps
|
|
27
|
+
* returning ONE organisation-level Membership per tenant, so a user in two
|
|
28
|
+
* units of one org is still one tenant choice with one role.
|
|
29
|
+
*/
|
|
30
|
+
interface MembershipGrant extends Membership {
|
|
31
|
+
scope?: string;
|
|
32
|
+
}
|
|
23
33
|
/** An invitation as stored. The token itself is NEVER stored — only its hash. */
|
|
24
34
|
interface StoredInvite {
|
|
25
35
|
id: string;
|
|
@@ -27,6 +37,8 @@ interface StoredInvite {
|
|
|
27
37
|
/** Lower-cased and trimmed. */
|
|
28
38
|
email: string;
|
|
29
39
|
role: string;
|
|
40
|
+
/** Opaque to the package; carried into addMembership on accept. */
|
|
41
|
+
scope?: string;
|
|
30
42
|
tokenHash: string;
|
|
31
43
|
invitedBy?: string;
|
|
32
44
|
createdAt: number;
|
|
@@ -42,10 +54,17 @@ interface StoredInvite {
|
|
|
42
54
|
interface TenantStore {
|
|
43
55
|
tenantById(id: string): Promise<Tenant | null>;
|
|
44
56
|
tenantBySlug(slug: string): Promise<Tenant | null>;
|
|
45
|
-
/**
|
|
57
|
+
/**
|
|
58
|
+
* Every membership the user has, across tenants — ONE organisation-level row
|
|
59
|
+
* per tenant, never one per scope (derive it, as Scout does from units).
|
|
60
|
+
*/
|
|
46
61
|
membershipsOf(userId: string): Promise<Membership[]>;
|
|
47
|
-
/**
|
|
48
|
-
|
|
62
|
+
/**
|
|
63
|
+
* Idempotent: adding an existing (userId, tenantId) must not duplicate it —
|
|
64
|
+
* keyed (userId, tenantId, scope) when the grant carries a scope. A grant
|
|
65
|
+
* with a scope must also leave the user a member of the tenant as a whole.
|
|
66
|
+
*/
|
|
67
|
+
addMembership(m: MembershipGrant): Promise<void>;
|
|
49
68
|
/** Insert, or replace the invite with the same id. */
|
|
50
69
|
saveInvite(invite: StoredInvite): Promise<void>;
|
|
51
70
|
inviteByTokenHash(tokenHash: string): Promise<StoredInvite | null>;
|
|
@@ -163,7 +182,16 @@ interface TenantRoutesOptions<Action extends string> {
|
|
|
163
182
|
tenant: Tenant;
|
|
164
183
|
role: string;
|
|
165
184
|
invitedBy: string;
|
|
185
|
+
scope?: string;
|
|
166
186
|
}) => Promise<void>;
|
|
187
|
+
/**
|
|
188
|
+
* Required for an invitation with a `scope` (a unit below the organisation).
|
|
189
|
+
* Only the app knows its unit tree, so only the app can say whether THIS
|
|
190
|
+
* inviter may grant this role there. Without it a body carrying `scope` is
|
|
191
|
+
* refused 400; a false answer is refused 403 `scope_not_allowed`. A scope is
|
|
192
|
+
* never silently dropped.
|
|
193
|
+
*/
|
|
194
|
+
authorizeScope?: (inviter: Membership, scope: string, role: string) => boolean | Promise<boolean>;
|
|
167
195
|
};
|
|
168
196
|
}
|
|
169
197
|
/**
|
package/dist/hono.d.ts
CHANGED
|
@@ -20,6 +20,16 @@ interface Membership {
|
|
|
20
20
|
tenantId: string;
|
|
21
21
|
role: string;
|
|
22
22
|
}
|
|
23
|
+
/**
|
|
24
|
+
* What accepting an invitation WRITES: a Membership plus the invitation's
|
|
25
|
+
* `scope`, when it had one. `scope` is opaque to the package — Scout puts a
|
|
26
|
+
* unit id there. It exists only on the write side: `membershipsOf` keeps
|
|
27
|
+
* returning ONE organisation-level Membership per tenant, so a user in two
|
|
28
|
+
* units of one org is still one tenant choice with one role.
|
|
29
|
+
*/
|
|
30
|
+
interface MembershipGrant extends Membership {
|
|
31
|
+
scope?: string;
|
|
32
|
+
}
|
|
23
33
|
/** An invitation as stored. The token itself is NEVER stored — only its hash. */
|
|
24
34
|
interface StoredInvite {
|
|
25
35
|
id: string;
|
|
@@ -27,6 +37,8 @@ interface StoredInvite {
|
|
|
27
37
|
/** Lower-cased and trimmed. */
|
|
28
38
|
email: string;
|
|
29
39
|
role: string;
|
|
40
|
+
/** Opaque to the package; carried into addMembership on accept. */
|
|
41
|
+
scope?: string;
|
|
30
42
|
tokenHash: string;
|
|
31
43
|
invitedBy?: string;
|
|
32
44
|
createdAt: number;
|
|
@@ -42,10 +54,17 @@ interface StoredInvite {
|
|
|
42
54
|
interface TenantStore {
|
|
43
55
|
tenantById(id: string): Promise<Tenant | null>;
|
|
44
56
|
tenantBySlug(slug: string): Promise<Tenant | null>;
|
|
45
|
-
/**
|
|
57
|
+
/**
|
|
58
|
+
* Every membership the user has, across tenants — ONE organisation-level row
|
|
59
|
+
* per tenant, never one per scope (derive it, as Scout does from units).
|
|
60
|
+
*/
|
|
46
61
|
membershipsOf(userId: string): Promise<Membership[]>;
|
|
47
|
-
/**
|
|
48
|
-
|
|
62
|
+
/**
|
|
63
|
+
* Idempotent: adding an existing (userId, tenantId) must not duplicate it —
|
|
64
|
+
* keyed (userId, tenantId, scope) when the grant carries a scope. A grant
|
|
65
|
+
* with a scope must also leave the user a member of the tenant as a whole.
|
|
66
|
+
*/
|
|
67
|
+
addMembership(m: MembershipGrant): Promise<void>;
|
|
49
68
|
/** Insert, or replace the invite with the same id. */
|
|
50
69
|
saveInvite(invite: StoredInvite): Promise<void>;
|
|
51
70
|
inviteByTokenHash(tokenHash: string): Promise<StoredInvite | null>;
|
|
@@ -163,7 +182,16 @@ interface TenantRoutesOptions<Action extends string> {
|
|
|
163
182
|
tenant: Tenant;
|
|
164
183
|
role: string;
|
|
165
184
|
invitedBy: string;
|
|
185
|
+
scope?: string;
|
|
166
186
|
}) => Promise<void>;
|
|
187
|
+
/**
|
|
188
|
+
* Required for an invitation with a `scope` (a unit below the organisation).
|
|
189
|
+
* Only the app knows its unit tree, so only the app can say whether THIS
|
|
190
|
+
* inviter may grant this role there. Without it a body carrying `scope` is
|
|
191
|
+
* refused 400; a false answer is refused 403 `scope_not_allowed`. A scope is
|
|
192
|
+
* never silently dropped.
|
|
193
|
+
*/
|
|
194
|
+
authorizeScope?: (inviter: Membership, scope: string, role: string) => boolean | Promise<boolean>;
|
|
167
195
|
};
|
|
168
196
|
}
|
|
169
197
|
/**
|
package/dist/hono.js
CHANGED
|
@@ -121,6 +121,7 @@ async function createInvite(input) {
|
|
|
121
121
|
tenantId: tenant.id,
|
|
122
122
|
email: normEmail(input.email),
|
|
123
123
|
role: input.role,
|
|
124
|
+
...input.scope !== void 0 ? { scope: input.scope } : {},
|
|
124
125
|
tokenHash: await hashInviteToken(token),
|
|
125
126
|
...input.invitedBy ? { invitedBy: input.invitedBy } : {},
|
|
126
127
|
createdAt: now,
|
|
@@ -137,7 +138,12 @@ async function acceptInvite(input) {
|
|
|
137
138
|
if (invite.revokedAt !== void 0) throw new InviteRefused("revoked");
|
|
138
139
|
if (normEmail(user.email) !== invite.email) throw new InviteRefused("email_mismatch");
|
|
139
140
|
if (!input.invitableRoles.includes(invite.role)) throw new InviteRefused("role_not_invitable");
|
|
140
|
-
const membership = {
|
|
141
|
+
const membership = {
|
|
142
|
+
userId: user.id,
|
|
143
|
+
tenantId: invite.tenantId,
|
|
144
|
+
role: invite.role,
|
|
145
|
+
...invite.scope !== void 0 ? { scope: invite.scope } : {}
|
|
146
|
+
};
|
|
141
147
|
if (invite.usedAt !== void 0) {
|
|
142
148
|
if (invite.usedBy !== user.id) throw new InviteRefused("used");
|
|
143
149
|
await store.addMembership(membership);
|
|
@@ -253,7 +259,11 @@ function tenantRoutes(o) {
|
|
|
253
259
|
try {
|
|
254
260
|
const m = await acceptInvite({ store: o.store, token: body.token, user, invitableRoles: o.invitableRoles });
|
|
255
261
|
const t = await o.store.tenantById(m.tenantId);
|
|
256
|
-
return c.json({
|
|
262
|
+
return c.json({
|
|
263
|
+
tenant: t ? { id: t.id, slug: t.slug, name: t.name } : { id: m.tenantId },
|
|
264
|
+
role: m.role,
|
|
265
|
+
...m.scope !== void 0 ? { scope: m.scope } : {}
|
|
266
|
+
});
|
|
257
267
|
} catch (e) {
|
|
258
268
|
const res = tenantErrorResponse(c, e);
|
|
259
269
|
if (res) return res;
|
|
@@ -268,6 +278,11 @@ function tenantRoutes(o) {
|
|
|
268
278
|
if (typeof body?.email !== "string" || !body.email.includes("@") || typeof body.role !== "string") {
|
|
269
279
|
return c.json({ error: "invalid_request" }, 400);
|
|
270
280
|
}
|
|
281
|
+
const scope = body.scope;
|
|
282
|
+
if (scope !== void 0) {
|
|
283
|
+
if (typeof scope !== "string" || scope === "" || !inv.authorizeScope) return c.json({ error: "invalid_request" }, 400);
|
|
284
|
+
if (!await inv.authorizeScope(active.membership, scope, body.role)) return c.json({ error: "scope_not_allowed" }, 403);
|
|
285
|
+
}
|
|
271
286
|
try {
|
|
272
287
|
const { invite, token } = await createInvite({
|
|
273
288
|
store: o.store,
|
|
@@ -275,9 +290,17 @@ function tenantRoutes(o) {
|
|
|
275
290
|
email: body.email,
|
|
276
291
|
role: body.role,
|
|
277
292
|
invitableRoles: o.invitableRoles,
|
|
278
|
-
invitedBy: active.membership.userId
|
|
293
|
+
invitedBy: active.membership.userId,
|
|
294
|
+
...scope !== void 0 ? { scope } : {}
|
|
295
|
+
});
|
|
296
|
+
await inv.deliverInvite({
|
|
297
|
+
to: invite.email,
|
|
298
|
+
token,
|
|
299
|
+
tenant: active.tenant,
|
|
300
|
+
role: invite.role,
|
|
301
|
+
invitedBy: active.membership.userId,
|
|
302
|
+
...invite.scope !== void 0 ? { scope: invite.scope } : {}
|
|
279
303
|
});
|
|
280
|
-
await inv.deliverInvite({ to: invite.email, token, tenant: active.tenant, role: invite.role, invitedBy: active.membership.userId });
|
|
281
304
|
return c.json({ inviteId: invite.id }, 201);
|
|
282
305
|
} catch (e) {
|
|
283
306
|
const res = tenantErrorResponse(c, e);
|