@broberg/tenant 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -45,7 +45,7 @@ const membership = await acceptInvite({ store, token, user: { id, email }, invit
45
45
  - **The signed-in email must match** the invitation (case-insensitive).
46
46
  - **Expires** after 7 days by default (`ttlMs`).
47
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.
48
+ - **A removed member stays removed (0.2.2).** Accepting again as the same user is safe while they are still a member (nothing is written). A used invitation never re-creates a membership an admin has removed: a retry inside `HEAL_WINDOW_MS` (5 minutes after the invitation was claimed) still repairs a half-finished accept — a crash between `markInviteUsed` and `addMembership` — and after that window the retry is refused with `used`. Expiry is checked first, so an expired link is dead for everyone. If your app removes members, the removal needs no extra step; if you need a stricter rule, revoke the member's used invitations on removal as well.
49
49
 
50
50
  Refusals are `InviteRefused` with `reason`: `not_found`, `expired`, `revoked`, `used`, `email_mismatch` or `role_not_invitable`.
51
51
 
package/dist/hono.cjs CHANGED
@@ -132,6 +132,7 @@ async function createInvite(input) {
132
132
  await input.store.saveInvite(invite);
133
133
  return { invite, token };
134
134
  }
135
+ var HEAL_WINDOW_MS = 5 * 60 * 1e3;
135
136
  async function acceptInvite(input) {
136
137
  const { store, user } = input;
137
138
  const now = input.now ?? Date.now();
@@ -146,12 +147,17 @@ async function acceptInvite(input) {
146
147
  role: invite.role,
147
148
  ...invite.scope !== void 0 ? { scope: invite.scope } : {}
148
149
  };
150
+ if (now >= invite.expiresAt) throw new InviteRefused("expired");
149
151
  if (invite.usedAt !== void 0) {
150
152
  if (invite.usedBy !== user.id) throw new InviteRefused("used");
151
- await store.addMembership(membership);
152
- return membership;
153
+ if (now - invite.usedAt < HEAL_WINDOW_MS) {
154
+ await store.addMembership(membership);
155
+ return membership;
156
+ }
157
+ const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);
158
+ if (current) return { ...membership, role: current.role };
159
+ throw new InviteRefused("used");
153
160
  }
154
- if (now >= invite.expiresAt) throw new InviteRefused("expired");
155
161
  const tenant = await store.tenantById(invite.tenantId);
156
162
  if (!tenant) throw new TenantNotFound(invite.tenantId);
157
163
  if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
package/dist/hono.cjs.map CHANGED
@@ -1 +1 @@
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"]}
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 * How long after an invitation was claimed a retry by the same user may still WRITE the membership — the window in which\n * \"claimed but never added\" (a crash between the two store calls) is healed. After it, a used invitation can only be\n * replayed read-only while the membership exists; a removed member stays removed (F029.15).\n */\nexport const HEAL_WINDOW_MS = 5 * 60 * 1000;\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 while they are still a\n * member (nothing is written); it never re-creates a removed membership, apart\n * from healing a half-finished accept inside HEAL_WINDOW_MS. 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 (now >= invite.expiresAt) throw new InviteRefused(\"expired\"); // before the reuse branch: an old link is dead for everyone\n if (invite.usedAt !== undefined) {\n if (invite.usedBy !== user.id) throw new InviteRefused(\"used\");\n // F029.15 — reusing a used invitation must NEVER re-create a membership an admin has since removed.\n // 1) Inside a short window a crash between \"claimed\" and \"added\" is healed (addMembership is idempotent).\n if (now - invite.usedAt < HEAL_WINDOW_MS) {\n await store.addMembership(membership);\n return membership;\n }\n // 2) Later: idempotent only while the user is still a member — read-only, nothing is written.\n const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);\n if (current) return { ...membership, role: current.role };\n throw new InviteRefused(\"used\");\n }\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 /** What an app's \"remove member\" does: drop the user's rows in that tenant. (Not part of TenantStore — the app owns removal.) */\n removeMembership(userId: string, tenantId: string): void;\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 removeMembership(userId, tenantId) {\n for (let i = memberships.length - 1; i >= 0; i--) if (memberships[i]!.userId === userId && memberships[i]!.tenantId === tenantId) memberships.splice(i, 1);\n for (let i = grants.length - 1; i >= 0; i--) if (grants[i]!.userId === userId && grants[i]!.tenantId === tenantId) grants.splice(i, 1);\n },\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.js CHANGED
@@ -130,6 +130,7 @@ async function createInvite(input) {
130
130
  await input.store.saveInvite(invite);
131
131
  return { invite, token };
132
132
  }
133
+ var HEAL_WINDOW_MS = 5 * 60 * 1e3;
133
134
  async function acceptInvite(input) {
134
135
  const { store, user } = input;
135
136
  const now = input.now ?? Date.now();
@@ -144,12 +145,17 @@ async function acceptInvite(input) {
144
145
  role: invite.role,
145
146
  ...invite.scope !== void 0 ? { scope: invite.scope } : {}
146
147
  };
148
+ if (now >= invite.expiresAt) throw new InviteRefused("expired");
147
149
  if (invite.usedAt !== void 0) {
148
150
  if (invite.usedBy !== user.id) throw new InviteRefused("used");
149
- await store.addMembership(membership);
150
- return membership;
151
+ if (now - invite.usedAt < HEAL_WINDOW_MS) {
152
+ await store.addMembership(membership);
153
+ return membership;
154
+ }
155
+ const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);
156
+ if (current) return { ...membership, role: current.role };
157
+ throw new InviteRefused("used");
151
158
  }
152
- if (now >= invite.expiresAt) throw new InviteRefused("expired");
153
159
  const tenant = await store.tenantById(invite.tenantId);
154
160
  if (!tenant) throw new TenantNotFound(invite.tenantId);
155
161
  if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
package/dist/hono.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/hono.ts"],"names":[],"mappings":"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","file":"hono.js","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"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/hono.ts"],"names":[],"mappings":"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","file":"hono.js","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 * How long after an invitation was claimed a retry by the same user may still WRITE the membership — the window in which\n * \"claimed but never added\" (a crash between the two store calls) is healed. After it, a used invitation can only be\n * replayed read-only while the membership exists; a removed member stays removed (F029.15).\n */\nexport const HEAL_WINDOW_MS = 5 * 60 * 1000;\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 while they are still a\n * member (nothing is written); it never re-creates a removed membership, apart\n * from healing a half-finished accept inside HEAL_WINDOW_MS. 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 (now >= invite.expiresAt) throw new InviteRefused(\"expired\"); // before the reuse branch: an old link is dead for everyone\n if (invite.usedAt !== undefined) {\n if (invite.usedBy !== user.id) throw new InviteRefused(\"used\");\n // F029.15 — reusing a used invitation must NEVER re-create a membership an admin has since removed.\n // 1) Inside a short window a crash between \"claimed\" and \"added\" is healed (addMembership is idempotent).\n if (now - invite.usedAt < HEAL_WINDOW_MS) {\n await store.addMembership(membership);\n return membership;\n }\n // 2) Later: idempotent only while the user is still a member — read-only, nothing is written.\n const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);\n if (current) return { ...membership, role: current.role };\n throw new InviteRefused(\"used\");\n }\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 /** What an app's \"remove member\" does: drop the user's rows in that tenant. (Not part of TenantStore — the app owns removal.) */\n removeMembership(userId: string, tenantId: string): void;\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 removeMembership(userId, tenantId) {\n for (let i = memberships.length - 1; i >= 0; i--) if (memberships[i]!.userId === userId && memberships[i]!.tenantId === tenantId) memberships.splice(i, 1);\n for (let i = grants.length - 1; i >= 0; i--) if (grants[i]!.userId === userId && grants[i]!.tenantId === tenantId) grants.splice(i, 1);\n },\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/index.cjs CHANGED
@@ -138,6 +138,7 @@ async function createInvite(input) {
138
138
  await input.store.saveInvite(invite);
139
139
  return { invite, token };
140
140
  }
141
+ var HEAL_WINDOW_MS = 5 * 60 * 1e3;
141
142
  async function acceptInvite(input) {
142
143
  const { store, user } = input;
143
144
  const now = input.now ?? Date.now();
@@ -152,12 +153,17 @@ async function acceptInvite(input) {
152
153
  role: invite.role,
153
154
  ...invite.scope !== void 0 ? { scope: invite.scope } : {}
154
155
  };
156
+ if (now >= invite.expiresAt) throw new InviteRefused("expired");
155
157
  if (invite.usedAt !== void 0) {
156
158
  if (invite.usedBy !== user.id) throw new InviteRefused("used");
157
- await store.addMembership(membership);
158
- return membership;
159
+ if (now - invite.usedAt < HEAL_WINDOW_MS) {
160
+ await store.addMembership(membership);
161
+ return membership;
162
+ }
163
+ const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);
164
+ if (current) return { ...membership, role: current.role };
165
+ throw new InviteRefused("used");
159
166
  }
160
- if (now >= invite.expiresAt) throw new InviteRefused("expired");
161
167
  const tenant = await store.tenantById(invite.tenantId);
162
168
  if (!tenant) throw new TenantNotFound(invite.tenantId);
163
169
  if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
@@ -195,6 +201,10 @@ function memoryTenantStore(seed = {}) {
195
201
  return {
196
202
  invites,
197
203
  grants,
204
+ removeMembership(userId, tenantId) {
205
+ for (let i = memberships2.length - 1; i >= 0; i--) if (memberships2[i].userId === userId && memberships2[i].tenantId === tenantId) memberships2.splice(i, 1);
206
+ for (let i = grants.length - 1; i >= 0; i--) if (grants[i].userId === userId && grants[i].tenantId === tenantId) grants.splice(i, 1);
207
+ },
198
208
  async tenantById(id) {
199
209
  return tenants.get(id) ?? null;
200
210
  },
@@ -230,6 +240,7 @@ function memoryTenantStore(seed = {}) {
230
240
  }
231
241
 
232
242
  exports.DEFAULT_INVITE_TTL_MS = DEFAULT_INVITE_TTL_MS;
243
+ exports.HEAL_WINDOW_MS = HEAL_WINDOW_MS;
233
244
  exports.InviteRefused = InviteRefused;
234
245
  exports.TenantChoiceRequired = TenantChoiceRequired;
235
246
  exports.TenantError = TenantError;
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"names":["memberships"],"mappings":"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","file":"index.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"]}
1
+ {"version":3,"sources":["../src/index.ts"],"names":["memberships"],"mappings":"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","file":"index.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 * How long after an invitation was claimed a retry by the same user may still WRITE the membership — the window in which\n * \"claimed but never added\" (a crash between the two store calls) is healed. After it, a used invitation can only be\n * replayed read-only while the membership exists; a removed member stays removed (F029.15).\n */\nexport const HEAL_WINDOW_MS = 5 * 60 * 1000;\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 while they are still a\n * member (nothing is written); it never re-creates a removed membership, apart\n * from healing a half-finished accept inside HEAL_WINDOW_MS. 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 (now >= invite.expiresAt) throw new InviteRefused(\"expired\"); // before the reuse branch: an old link is dead for everyone\n if (invite.usedAt !== undefined) {\n if (invite.usedBy !== user.id) throw new InviteRefused(\"used\");\n // F029.15 — reusing a used invitation must NEVER re-create a membership an admin has since removed.\n // 1) Inside a short window a crash between \"claimed\" and \"added\" is healed (addMembership is idempotent).\n if (now - invite.usedAt < HEAL_WINDOW_MS) {\n await store.addMembership(membership);\n return membership;\n }\n // 2) Later: idempotent only while the user is still a member — read-only, nothing is written.\n const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);\n if (current) return { ...membership, role: current.role };\n throw new InviteRefused(\"used\");\n }\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 /** What an app's \"remove member\" does: drop the user's rows in that tenant. (Not part of TenantStore — the app owns removal.) */\n removeMembership(userId: string, tenantId: string): void;\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 removeMembership(userId, tenantId) {\n for (let i = memberships.length - 1; i >= 0; i--) if (memberships[i]!.userId === userId && memberships[i]!.tenantId === tenantId) memberships.splice(i, 1);\n for (let i = grants.length - 1; i >= 0; i--) if (grants[i]!.userId === userId && grants[i]!.tenantId === tenantId) grants.splice(i, 1);\n },\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"]}
package/dist/index.d.cts CHANGED
@@ -204,10 +204,17 @@ interface AcceptInviteInput {
204
204
  invitableRoles: readonly string[];
205
205
  now?: number;
206
206
  }
207
+ /**
208
+ * How long after an invitation was claimed a retry by the same user may still WRITE the membership — the window in which
209
+ * "claimed but never added" (a crash between the two store calls) is healed. After it, a used invitation can only be
210
+ * replayed read-only while the membership exists; a removed member stays removed (F029.15).
211
+ */
212
+ declare const HEAL_WINDOW_MS: number;
207
213
  /**
208
214
  * Accept an invitation: one use, before it expires, by the user it was sent
209
- * to. Repeating the accept as the SAME user is safe and returns the same
210
- * membership; anyone else gets `used`.
215
+ * to. Repeating the accept as the SAME user is safe while they are still a
216
+ * member (nothing is written); it never re-creates a removed membership, apart
217
+ * from healing a half-finished accept inside HEAL_WINDOW_MS. Anyone else gets `used`.
211
218
  */
212
219
  declare function acceptInvite(input: AcceptInviteInput): Promise<MembershipGrant>;
213
220
  /**
@@ -251,6 +258,8 @@ declare function memoryTenantStore(seed?: {
251
258
  readonly invites: ReadonlyMap<string, StoredInvite>;
252
259
  /** Every scoped grant written by addMembership, in order. */
253
260
  readonly grants: readonly MembershipGrant[];
261
+ /** What an app's "remove member" does: drop the user's rows in that tenant. (Not part of TenantStore — the app owns removal.) */
262
+ removeMembership(userId: string, tenantId: string): void;
254
263
  };
255
264
 
256
- export { type AcceptInviteInput, type ActiveTenant, type CreateInviteInput, DEFAULT_INVITE_TTL_MS, type FallbackReason, type InviteRefusal, InviteRefused, type Membership, type MembershipGrant, type Policy, type PolicyConfig, type ResolveInput, type StoredInvite, type Tenant, TenantChoiceRequired, TenantError, TenantForbidden, TenantNoMembership, TenantNotFound, TenantNotMember, type TenantStore, TenantSuspended, acceptInvite, createInvite, createPolicy, hashInviteToken, memoryTenantStore, resolveActiveTenant, revokeInvite };
265
+ export { type AcceptInviteInput, type ActiveTenant, type CreateInviteInput, DEFAULT_INVITE_TTL_MS, type FallbackReason, HEAL_WINDOW_MS, type InviteRefusal, InviteRefused, type Membership, type MembershipGrant, type Policy, type PolicyConfig, type ResolveInput, type StoredInvite, type Tenant, TenantChoiceRequired, TenantError, TenantForbidden, TenantNoMembership, TenantNotFound, TenantNotMember, type TenantStore, TenantSuspended, acceptInvite, createInvite, createPolicy, hashInviteToken, memoryTenantStore, resolveActiveTenant, revokeInvite };
package/dist/index.d.ts CHANGED
@@ -204,10 +204,17 @@ interface AcceptInviteInput {
204
204
  invitableRoles: readonly string[];
205
205
  now?: number;
206
206
  }
207
+ /**
208
+ * How long after an invitation was claimed a retry by the same user may still WRITE the membership — the window in which
209
+ * "claimed but never added" (a crash between the two store calls) is healed. After it, a used invitation can only be
210
+ * replayed read-only while the membership exists; a removed member stays removed (F029.15).
211
+ */
212
+ declare const HEAL_WINDOW_MS: number;
207
213
  /**
208
214
  * Accept an invitation: one use, before it expires, by the user it was sent
209
- * to. Repeating the accept as the SAME user is safe and returns the same
210
- * membership; anyone else gets `used`.
215
+ * to. Repeating the accept as the SAME user is safe while they are still a
216
+ * member (nothing is written); it never re-creates a removed membership, apart
217
+ * from healing a half-finished accept inside HEAL_WINDOW_MS. Anyone else gets `used`.
211
218
  */
212
219
  declare function acceptInvite(input: AcceptInviteInput): Promise<MembershipGrant>;
213
220
  /**
@@ -251,6 +258,8 @@ declare function memoryTenantStore(seed?: {
251
258
  readonly invites: ReadonlyMap<string, StoredInvite>;
252
259
  /** Every scoped grant written by addMembership, in order. */
253
260
  readonly grants: readonly MembershipGrant[];
261
+ /** What an app's "remove member" does: drop the user's rows in that tenant. (Not part of TenantStore — the app owns removal.) */
262
+ removeMembership(userId: string, tenantId: string): void;
254
263
  };
255
264
 
256
- export { type AcceptInviteInput, type ActiveTenant, type CreateInviteInput, DEFAULT_INVITE_TTL_MS, type FallbackReason, type InviteRefusal, InviteRefused, type Membership, type MembershipGrant, type Policy, type PolicyConfig, type ResolveInput, type StoredInvite, type Tenant, TenantChoiceRequired, TenantError, TenantForbidden, TenantNoMembership, TenantNotFound, TenantNotMember, type TenantStore, TenantSuspended, acceptInvite, createInvite, createPolicy, hashInviteToken, memoryTenantStore, resolveActiveTenant, revokeInvite };
265
+ export { type AcceptInviteInput, type ActiveTenant, type CreateInviteInput, DEFAULT_INVITE_TTL_MS, type FallbackReason, HEAL_WINDOW_MS, type InviteRefusal, InviteRefused, type Membership, type MembershipGrant, type Policy, type PolicyConfig, type ResolveInput, type StoredInvite, type Tenant, TenantChoiceRequired, TenantError, TenantForbidden, TenantNoMembership, TenantNotFound, TenantNotMember, type TenantStore, TenantSuspended, acceptInvite, createInvite, createPolicy, hashInviteToken, memoryTenantStore, resolveActiveTenant, revokeInvite };
package/dist/index.js CHANGED
@@ -136,6 +136,7 @@ async function createInvite(input) {
136
136
  await input.store.saveInvite(invite);
137
137
  return { invite, token };
138
138
  }
139
+ var HEAL_WINDOW_MS = 5 * 60 * 1e3;
139
140
  async function acceptInvite(input) {
140
141
  const { store, user } = input;
141
142
  const now = input.now ?? Date.now();
@@ -150,12 +151,17 @@ async function acceptInvite(input) {
150
151
  role: invite.role,
151
152
  ...invite.scope !== void 0 ? { scope: invite.scope } : {}
152
153
  };
154
+ if (now >= invite.expiresAt) throw new InviteRefused("expired");
153
155
  if (invite.usedAt !== void 0) {
154
156
  if (invite.usedBy !== user.id) throw new InviteRefused("used");
155
- await store.addMembership(membership);
156
- return membership;
157
+ if (now - invite.usedAt < HEAL_WINDOW_MS) {
158
+ await store.addMembership(membership);
159
+ return membership;
160
+ }
161
+ const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);
162
+ if (current) return { ...membership, role: current.role };
163
+ throw new InviteRefused("used");
157
164
  }
158
- if (now >= invite.expiresAt) throw new InviteRefused("expired");
159
165
  const tenant = await store.tenantById(invite.tenantId);
160
166
  if (!tenant) throw new TenantNotFound(invite.tenantId);
161
167
  if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
@@ -193,6 +199,10 @@ function memoryTenantStore(seed = {}) {
193
199
  return {
194
200
  invites,
195
201
  grants,
202
+ removeMembership(userId, tenantId) {
203
+ for (let i = memberships2.length - 1; i >= 0; i--) if (memberships2[i].userId === userId && memberships2[i].tenantId === tenantId) memberships2.splice(i, 1);
204
+ for (let i = grants.length - 1; i >= 0; i--) if (grants[i].userId === userId && grants[i].tenantId === tenantId) grants.splice(i, 1);
205
+ },
196
206
  async tenantById(id) {
197
207
  return tenants.get(id) ?? null;
198
208
  },
@@ -227,6 +237,6 @@ function memoryTenantStore(seed = {}) {
227
237
  };
228
238
  }
229
239
 
230
- export { DEFAULT_INVITE_TTL_MS, InviteRefused, TenantChoiceRequired, TenantError, TenantForbidden, TenantNoMembership, TenantNotFound, TenantNotMember, TenantSuspended, acceptInvite, createInvite, createPolicy, hashInviteToken, memoryTenantStore, resolveActiveTenant, revokeInvite };
240
+ export { DEFAULT_INVITE_TTL_MS, HEAL_WINDOW_MS, InviteRefused, TenantChoiceRequired, TenantError, TenantForbidden, TenantNoMembership, TenantNotFound, TenantNotMember, TenantSuspended, acceptInvite, createInvite, createPolicy, hashInviteToken, memoryTenantStore, resolveActiveTenant, revokeInvite };
231
241
  //# sourceMappingURL=index.js.map
232
242
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"names":["memberships"],"mappings":";AAmGO,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;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;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;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;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;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;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;AAEO,IAAM,eAAA,GAAN,cAA8B,WAAA,CAAY;AAAA,EAC/C,WAAA,CACW,MACA,MAAA,EACT;AACA,IAAA,KAAA,CAAM,CAAA,MAAA,EAAS,IAAI,CAAA,WAAA,EAAc,MAAM,CAAA,EAAA,CAAI,CAAA;AAHlC,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAGT,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AAAA,EALW,IAAA;AAAA,EACA,MAAA;AAKb;AA6CA,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;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;AA8BA,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,GAAI,MAAM,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,KAAA,CAAM,KAAA,EAAM,GAAI,EAAC;AAAA,IAC1D,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,EAAoD;AACrF,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,GAA8B;AAAA,IAClC,QAAQ,IAAA,CAAK,EAAA;AAAA,IACb,UAAU,MAAA,CAAO,QAAA;AAAA,IACjB,MAAM,MAAA,CAAO,IAAA;AAAA,IACb,GAAI,OAAO,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,MAAA,CAAO,KAAA,EAAM,GAAI;AAAC,GAC9D;AAEA,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;AAMA,eAAsB,aAAa,KAAA,EAA0F;AAC3H,EAAA,MAAM,OAAA,GAAU,EAAE,GAAG,KAAA,CAAM,MAAA,EAAQ,WAAW,KAAA,CAAM,GAAA,IAAO,IAAA,CAAK,GAAA,EAAI,EAAE;AACtE,EAAA,MAAM,KAAA,CAAM,KAAA,CAAM,UAAA,CAAW,OAAO,CAAA;AACpC,EAAA,OAAO,OAAA;AACT;AAqBO,SAAS,aAAoC,MAAA,EAA8C;AAChG,EAAA,MAAM,GAAA,GAAM,CAAC,IAAA,EAAc,MAAA,KAA4B;AACrD,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,SAAA,CAAU,cAAA,CAAe,IAAA,CAAK,MAAA,CAAO,KAAA,EAAO,IAAI,CAAA,GAAI,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA,GAAI,MAAA;AAChG,IAAA,OAAO,CAAC,CAAC,OAAA,KAAY,OAAA,CAAQ,SAAS,GAAG,CAAA,IAAK,OAAA,CAAQ,QAAA,CAAS,MAAM,CAAA,CAAA;AAAA,EACvE,CAAA;AACA,EAAA,OAAO;AAAA,IACL,GAAA;AAAA,IACA,MAAM,MAAA,CAAO,UAAA,EAAY,MAAA,EAAQ,OAAA,EAAS;AACxC,MAAA,IAAI,GAAA,CAAI,UAAA,CAAW,IAAA,EAAM,MAAM,CAAA,EAAG;AAClC,MAAA,MAAM,MAAA,CAAO,QAAA,GAAW,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,MAAA,EAAQ,GAAI,OAAA,KAAY,SAAY,EAAE,OAAA,EAAQ,GAAI,IAAK,CAAA;AACxG,MAAA,MAAM,IAAI,eAAA,CAAgB,UAAA,CAAW,IAAA,EAAM,MAAM,CAAA;AAAA,IACnD;AAAA,GACF;AACF;AASO,SAAS,iBAAA,CAAkB,IAAA,GAA2D,EAAC,EAI5F;AACA,EAAA,MAAM,UAAU,IAAI,GAAA,CAAA,CAAK,KAAK,OAAA,IAAW,IAAI,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,EAAE,EAAA,EAAI,EAAE,GAAG,CAAA,EAAG,CAAC,CAAC,CAAA;AACzE,EAAA,MAAMA,YAAAA,GAAAA,CAA6B,IAAA,CAAK,WAAA,IAAe,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,MAAO,EAAE,GAAG,CAAA,EAAE,CAAE,CAAA;AAChF,EAAA,MAAM,SAA4B,EAAC;AACnC,EAAA,MAAM,OAAA,uBAAc,GAAA,EAA0B;AAC9C,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAM,WAAW,EAAA,EAAI;AACnB,MAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA,IAAK,IAAA;AAAA,IAC5B,CAAA;AAAA,IACA,MAAM,aAAa,IAAA,EAAM;AACvB,MAAA,KAAA,MAAW,CAAA,IAAK,QAAQ,MAAA,EAAO,MAAO,CAAA,CAAE,IAAA,KAAS,MAAM,OAAO,CAAA;AAC9D,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,cAAc,MAAA,EAAQ;AAC1B,MAAA,OAAOA,YAAAA,CAAY,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,MAAA,KAAW,MAAM,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,MAAO,EAAE,GAAG,GAAE,CAAE,CAAA;AAAA,IAC7E,CAAA;AAAA,IACA,MAAM,cAAc,CAAA,EAAG;AAGrB,MAAA,IAAI,CAAA,CAAE,UAAU,MAAA,IAAa,CAAC,OAAO,IAAA,CAAK,CAAC,MAAM,CAAA,CAAE,MAAA,KAAW,EAAE,MAAA,IAAU,CAAA,CAAE,aAAa,CAAA,CAAE,QAAA,IAAY,EAAE,KAAA,KAAU,CAAA,CAAE,KAAK,CAAA,EAAG;AAC3H,QAAA,MAAA,CAAO,IAAA,CAAK,EAAE,GAAG,CAAA,EAAG,CAAA;AAAA,MACtB;AACA,MAAA,IAAI,CAACA,YAAAA,CAAY,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,QAAA,KAAa,CAAA,CAAE,QAAQ,CAAA,EAAG;AAChF,QAAAA,YAAAA,CAAY,IAAA,CAAK,EAAE,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAQ,QAAA,EAAU,CAAA,CAAE,QAAA,EAAU,IAAA,EAAM,CAAA,CAAE,IAAA,EAAM,CAAA;AAAA,MAC3E;AAAA,IACF,CAAA;AAAA,IACA,MAAM,WAAW,MAAA,EAAQ;AACvB,MAAA,OAAA,CAAQ,IAAI,MAAA,CAAO,EAAA,EAAI,EAAE,GAAG,QAAQ,CAAA;AAAA,IACtC,CAAA;AAAA,IACA,MAAM,kBAAkB,IAAA,EAAM;AAC5B,MAAA,KAAA,MAAW,CAAA,IAAK,OAAA,CAAQ,MAAA,EAAO,EAAG,IAAI,CAAA,CAAE,SAAA,KAAc,IAAA,EAAM,OAAO,EAAE,GAAG,CAAA,EAAE;AAC1E,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,cAAA,CAAe,EAAA,EAAI,EAAA,EAAI,MAAA,EAAQ;AACnC,MAAA,MAAM,CAAA,GAAI,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA;AACxB,MAAA,IAAI,CAAC,CAAA,IAAK,CAAA,CAAE,MAAA,KAAW,QAAW,OAAO,KAAA;AACzC,MAAA,OAAA,CAAQ,GAAA,CAAI,IAAI,EAAE,GAAG,GAAG,MAAA,EAAQ,EAAA,EAAI,MAAA,EAAQ,MAAA,EAAQ,CAAA;AACpD,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,GACF;AACF","file":"index.js","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"]}
1
+ {"version":3,"sources":["../src/index.ts"],"names":["memberships"],"mappings":"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","file":"index.js","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 * How long after an invitation was claimed a retry by the same user may still WRITE the membership — the window in which\n * \"claimed but never added\" (a crash between the two store calls) is healed. After it, a used invitation can only be\n * replayed read-only while the membership exists; a removed member stays removed (F029.15).\n */\nexport const HEAL_WINDOW_MS = 5 * 60 * 1000;\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 while they are still a\n * member (nothing is written); it never re-creates a removed membership, apart\n * from healing a half-finished accept inside HEAL_WINDOW_MS. 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 (now >= invite.expiresAt) throw new InviteRefused(\"expired\"); // before the reuse branch: an old link is dead for everyone\n if (invite.usedAt !== undefined) {\n if (invite.usedBy !== user.id) throw new InviteRefused(\"used\");\n // F029.15 — reusing a used invitation must NEVER re-create a membership an admin has since removed.\n // 1) Inside a short window a crash between \"claimed\" and \"added\" is healed (addMembership is idempotent).\n if (now - invite.usedAt < HEAL_WINDOW_MS) {\n await store.addMembership(membership);\n return membership;\n }\n // 2) Later: idempotent only while the user is still a member — read-only, nothing is written.\n const current = (await store.membershipsOf(user.id)).find((m) => m.tenantId === invite.tenantId);\n if (current) return { ...membership, role: current.role };\n throw new InviteRefused(\"used\");\n }\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 /** What an app's \"remove member\" does: drop the user's rows in that tenant. (Not part of TenantStore — the app owns removal.) */\n removeMembership(userId: string, tenantId: string): void;\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 removeMembership(userId, tenantId) {\n for (let i = memberships.length - 1; i >= 0; i--) if (memberships[i]!.userId === userId && memberships[i]!.tenantId === tenantId) memberships.splice(i, 1);\n for (let i = grants.length - 1; i >= 0; i--) if (grants[i]!.userId === userId && grants[i]!.tenantId === tenantId) grants.splice(i, 1);\n },\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"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@broberg/tenant",
3
- "version": "0.2.1",
3
+ "version": "0.2.2",
4
4
  "description": "Organisations, memberships, invitations and role checks, the same way in every app. Storage is the app's own (a TenantStore adapter); the package never chooses how tenant data is isolated, and organisations never live in BrobergID.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -27,7 +27,7 @@
27
27
  },
28
28
  "scripts": {
29
29
  "build": "rm -rf dist && tsup && node verify-exports.mjs",
30
- "test": "vitest run --reporter=default --reporter=json --outputFile.json=.vitest-report/results.json",
30
+ "test": "vitest run --reporter=default --reporter=json --outputFile.json=.vitest-report/results.json && node ../../scripts/mutations-if-changed.mjs test/mutations.mjs",
31
31
  "typecheck": "tsc --noEmit"
32
32
  },
33
33
  "devDependencies": {