@broberg/tenant 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +138 -2
- package/dist/hono.cjs +323 -0
- package/dist/hono.cjs.map +1 -0
- package/dist/hono.d.cts +205 -0
- package/dist/hono.d.ts +205 -0
- package/dist/hono.js +317 -0
- package/dist/hono.js.map +1 -0
- package/dist/index.cjs +249 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +256 -0
- package/dist/index.d.ts +256 -0
- package/dist/index.js +232 -0
- package/dist/index.js.map +1 -0
- package/package.json +54 -4
package/dist/index.js
ADDED
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
// src/index.ts
|
|
2
|
+
var TenantError = class extends Error {
|
|
3
|
+
constructor(message) {
|
|
4
|
+
super(message);
|
|
5
|
+
this.name = "TenantError";
|
|
6
|
+
}
|
|
7
|
+
};
|
|
8
|
+
var TenantNotFound = class extends TenantError {
|
|
9
|
+
constructor(slug) {
|
|
10
|
+
super(`No tenant "${slug}".`);
|
|
11
|
+
this.slug = slug;
|
|
12
|
+
this.name = "TenantNotFound";
|
|
13
|
+
}
|
|
14
|
+
slug;
|
|
15
|
+
};
|
|
16
|
+
var TenantNotMember = class extends TenantError {
|
|
17
|
+
constructor(slug) {
|
|
18
|
+
super(`The user is not a member of "${slug}".`);
|
|
19
|
+
this.slug = slug;
|
|
20
|
+
this.name = "TenantNotMember";
|
|
21
|
+
}
|
|
22
|
+
slug;
|
|
23
|
+
};
|
|
24
|
+
var TenantSuspended = class extends TenantError {
|
|
25
|
+
constructor(slug) {
|
|
26
|
+
super(`Tenant "${slug}" is suspended.`);
|
|
27
|
+
this.slug = slug;
|
|
28
|
+
this.name = "TenantSuspended";
|
|
29
|
+
}
|
|
30
|
+
slug;
|
|
31
|
+
};
|
|
32
|
+
var TenantNoMembership = class extends TenantError {
|
|
33
|
+
constructor() {
|
|
34
|
+
super("The user has no active membership of any tenant.");
|
|
35
|
+
this.name = "TenantNoMembership";
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
var TenantChoiceRequired = class extends TenantError {
|
|
39
|
+
constructor(count) {
|
|
40
|
+
super(`The user is a member of ${count} tenants and nothing says which one \u2014 pass pickDefault.`);
|
|
41
|
+
this.count = count;
|
|
42
|
+
this.name = "TenantChoiceRequired";
|
|
43
|
+
}
|
|
44
|
+
count;
|
|
45
|
+
};
|
|
46
|
+
var InviteRefused = class extends TenantError {
|
|
47
|
+
constructor(reason) {
|
|
48
|
+
super(`Invitation refused: ${reason}.`);
|
|
49
|
+
this.reason = reason;
|
|
50
|
+
this.name = "InviteRefused";
|
|
51
|
+
}
|
|
52
|
+
reason;
|
|
53
|
+
};
|
|
54
|
+
var TenantForbidden = class extends TenantError {
|
|
55
|
+
constructor(role, action) {
|
|
56
|
+
super(`Role "${role}" may not "${action}".`);
|
|
57
|
+
this.role = role;
|
|
58
|
+
this.action = action;
|
|
59
|
+
this.name = "TenantForbidden";
|
|
60
|
+
}
|
|
61
|
+
role;
|
|
62
|
+
action;
|
|
63
|
+
};
|
|
64
|
+
async function memberships(store, userId) {
|
|
65
|
+
const all = await store.membershipsOf(userId);
|
|
66
|
+
const usable = [];
|
|
67
|
+
for (const m of all) {
|
|
68
|
+
const tenant = await store.tenantById(m.tenantId);
|
|
69
|
+
if (tenant && tenant.status !== "suspended") usable.push({ tenant, membership: m });
|
|
70
|
+
}
|
|
71
|
+
return { all, usable };
|
|
72
|
+
}
|
|
73
|
+
async function check(store, slug, m) {
|
|
74
|
+
const tenant = await store.tenantBySlug(slug);
|
|
75
|
+
if (!tenant) return { why: "not_found" };
|
|
76
|
+
const isMember = m.all.some((x) => x.tenantId === tenant.id);
|
|
77
|
+
if (!isMember) return { why: "not_member" };
|
|
78
|
+
if (tenant.status === "suspended") return { why: "suspended" };
|
|
79
|
+
const hit = m.usable.find((u) => u.tenant.id === tenant.id);
|
|
80
|
+
return hit ? { ok: hit } : { why: "not_member" };
|
|
81
|
+
}
|
|
82
|
+
async function resolveActiveTenant(input) {
|
|
83
|
+
const { store, userId } = input;
|
|
84
|
+
const ms = await memberships(store, userId);
|
|
85
|
+
const usable = ms.usable;
|
|
86
|
+
if (input.requested) {
|
|
87
|
+
const r = await check(store, input.requested, ms);
|
|
88
|
+
if ("ok" in r) return { ...r.ok, fellBack: false };
|
|
89
|
+
if (r.why === "not_found") throw new TenantNotFound(input.requested);
|
|
90
|
+
if (r.why === "suspended") throw new TenantSuspended(input.requested);
|
|
91
|
+
throw new TenantNotMember(input.requested);
|
|
92
|
+
}
|
|
93
|
+
let reason;
|
|
94
|
+
if (input.preferred) {
|
|
95
|
+
const r = await check(store, input.preferred, ms);
|
|
96
|
+
if ("ok" in r) return { ...r.ok, fellBack: false };
|
|
97
|
+
reason = r.why;
|
|
98
|
+
}
|
|
99
|
+
if (usable.length === 0) throw new TenantNoMembership();
|
|
100
|
+
const chosen = input.pickDefault ? input.pickDefault(usable) : usable.length === 1 ? usable[0] : void 0;
|
|
101
|
+
if (!chosen || !usable.some((u) => u.tenant.id === chosen.tenant.id && u.membership.userId === userId)) {
|
|
102
|
+
throw new TenantChoiceRequired(usable.length);
|
|
103
|
+
}
|
|
104
|
+
return { tenant: chosen.tenant, membership: chosen.membership, fellBack: reason !== void 0, ...reason ? { reason } : {} };
|
|
105
|
+
}
|
|
106
|
+
var DAY = 24 * 60 * 60 * 1e3;
|
|
107
|
+
var DEFAULT_INVITE_TTL_MS = 7 * DAY;
|
|
108
|
+
var normEmail = (e) => e.trim().toLowerCase();
|
|
109
|
+
function b64url(bytes) {
|
|
110
|
+
let s = "";
|
|
111
|
+
for (const b of bytes) s += String.fromCharCode(b);
|
|
112
|
+
return btoa(s).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
|
|
113
|
+
}
|
|
114
|
+
async function hashInviteToken(token) {
|
|
115
|
+
const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(token));
|
|
116
|
+
return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
|
|
117
|
+
}
|
|
118
|
+
async function createInvite(input) {
|
|
119
|
+
if (!input.invitableRoles.includes(input.role)) throw new InviteRefused("role_not_invitable");
|
|
120
|
+
const tenant = await input.store.tenantById(input.tenantId);
|
|
121
|
+
if (!tenant) throw new TenantNotFound(input.tenantId);
|
|
122
|
+
if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
|
|
123
|
+
const token = b64url(crypto.getRandomValues(new Uint8Array(32)));
|
|
124
|
+
const now = input.now ?? Date.now();
|
|
125
|
+
const invite = {
|
|
126
|
+
id: b64url(crypto.getRandomValues(new Uint8Array(12))),
|
|
127
|
+
tenantId: tenant.id,
|
|
128
|
+
email: normEmail(input.email),
|
|
129
|
+
role: input.role,
|
|
130
|
+
...input.scope !== void 0 ? { scope: input.scope } : {},
|
|
131
|
+
tokenHash: await hashInviteToken(token),
|
|
132
|
+
...input.invitedBy ? { invitedBy: input.invitedBy } : {},
|
|
133
|
+
createdAt: now,
|
|
134
|
+
expiresAt: now + (input.ttlMs ?? DEFAULT_INVITE_TTL_MS)
|
|
135
|
+
};
|
|
136
|
+
await input.store.saveInvite(invite);
|
|
137
|
+
return { invite, token };
|
|
138
|
+
}
|
|
139
|
+
async function acceptInvite(input) {
|
|
140
|
+
const { store, user } = input;
|
|
141
|
+
const now = input.now ?? Date.now();
|
|
142
|
+
const invite = await store.inviteByTokenHash(await hashInviteToken(input.token));
|
|
143
|
+
if (!invite) throw new InviteRefused("not_found");
|
|
144
|
+
if (invite.revokedAt !== void 0) throw new InviteRefused("revoked");
|
|
145
|
+
if (normEmail(user.email) !== invite.email) throw new InviteRefused("email_mismatch");
|
|
146
|
+
if (!input.invitableRoles.includes(invite.role)) throw new InviteRefused("role_not_invitable");
|
|
147
|
+
const membership = {
|
|
148
|
+
userId: user.id,
|
|
149
|
+
tenantId: invite.tenantId,
|
|
150
|
+
role: invite.role,
|
|
151
|
+
...invite.scope !== void 0 ? { scope: invite.scope } : {}
|
|
152
|
+
};
|
|
153
|
+
if (invite.usedAt !== void 0) {
|
|
154
|
+
if (invite.usedBy !== user.id) throw new InviteRefused("used");
|
|
155
|
+
await store.addMembership(membership);
|
|
156
|
+
return membership;
|
|
157
|
+
}
|
|
158
|
+
if (now >= invite.expiresAt) throw new InviteRefused("expired");
|
|
159
|
+
const tenant = await store.tenantById(invite.tenantId);
|
|
160
|
+
if (!tenant) throw new TenantNotFound(invite.tenantId);
|
|
161
|
+
if (tenant.status === "suspended") throw new TenantSuspended(tenant.slug);
|
|
162
|
+
if (!await store.markInviteUsed(invite.id, now, user.id)) {
|
|
163
|
+
const again = await store.inviteByTokenHash(invite.tokenHash);
|
|
164
|
+
if (again?.usedBy !== user.id) throw new InviteRefused("used");
|
|
165
|
+
}
|
|
166
|
+
await store.addMembership(membership);
|
|
167
|
+
return membership;
|
|
168
|
+
}
|
|
169
|
+
async function revokeInvite(input) {
|
|
170
|
+
const revoked = { ...input.invite, revokedAt: input.now ?? Date.now() };
|
|
171
|
+
await input.store.saveInvite(revoked);
|
|
172
|
+
return revoked;
|
|
173
|
+
}
|
|
174
|
+
function createPolicy(config) {
|
|
175
|
+
const can = (role, action) => {
|
|
176
|
+
const allowed = Object.prototype.hasOwnProperty.call(config.roles, role) ? config.roles[role] : void 0;
|
|
177
|
+
return !!allowed && (allowed.includes("*") || allowed.includes(action));
|
|
178
|
+
};
|
|
179
|
+
return {
|
|
180
|
+
can,
|
|
181
|
+
async assert(membership, action, context) {
|
|
182
|
+
if (can(membership.role, action)) return;
|
|
183
|
+
await config.onDenied?.({ role: membership.role, action, ...context !== void 0 ? { context } : {} });
|
|
184
|
+
throw new TenantForbidden(membership.role, action);
|
|
185
|
+
}
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
function memoryTenantStore(seed = {}) {
|
|
189
|
+
const tenants = new Map((seed.tenants ?? []).map((t) => [t.id, { ...t }]));
|
|
190
|
+
const memberships2 = (seed.memberships ?? []).map((m) => ({ ...m }));
|
|
191
|
+
const grants = [];
|
|
192
|
+
const invites = /* @__PURE__ */ new Map();
|
|
193
|
+
return {
|
|
194
|
+
invites,
|
|
195
|
+
grants,
|
|
196
|
+
async tenantById(id) {
|
|
197
|
+
return tenants.get(id) ?? null;
|
|
198
|
+
},
|
|
199
|
+
async tenantBySlug(slug) {
|
|
200
|
+
for (const t of tenants.values()) if (t.slug === slug) return t;
|
|
201
|
+
return null;
|
|
202
|
+
},
|
|
203
|
+
async membershipsOf(userId) {
|
|
204
|
+
return memberships2.filter((m) => m.userId === userId).map((m) => ({ ...m }));
|
|
205
|
+
},
|
|
206
|
+
async addMembership(m) {
|
|
207
|
+
if (m.scope !== void 0 && !grants.some((x) => x.userId === m.userId && x.tenantId === m.tenantId && x.scope === m.scope)) {
|
|
208
|
+
grants.push({ ...m });
|
|
209
|
+
}
|
|
210
|
+
if (!memberships2.some((x) => x.userId === m.userId && x.tenantId === m.tenantId)) {
|
|
211
|
+
memberships2.push({ userId: m.userId, tenantId: m.tenantId, role: m.role });
|
|
212
|
+
}
|
|
213
|
+
},
|
|
214
|
+
async saveInvite(invite) {
|
|
215
|
+
invites.set(invite.id, { ...invite });
|
|
216
|
+
},
|
|
217
|
+
async inviteByTokenHash(hash) {
|
|
218
|
+
for (const i of invites.values()) if (i.tokenHash === hash) return { ...i };
|
|
219
|
+
return null;
|
|
220
|
+
},
|
|
221
|
+
async markInviteUsed(id, at, userId) {
|
|
222
|
+
const i = invites.get(id);
|
|
223
|
+
if (!i || i.usedAt !== void 0) return false;
|
|
224
|
+
invites.set(id, { ...i, usedAt: at, usedBy: userId });
|
|
225
|
+
return true;
|
|
226
|
+
}
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
export { DEFAULT_INVITE_TTL_MS, InviteRefused, TenantChoiceRequired, TenantError, TenantForbidden, TenantNoMembership, TenantNotFound, TenantNotMember, TenantSuspended, acceptInvite, createInvite, createPolicy, hashInviteToken, memoryTenantStore, resolveActiveTenant, revokeInvite };
|
|
231
|
+
//# sourceMappingURL=index.js.map
|
|
232
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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 Broberg ID (D-5345a2): BID says\n// who the user is, the app says which organisations she belongs to.\n\n// ── Types ──────────────────────────────────────────────────────────────────\n\nexport interface Tenant {\n id: string;\n /** Unique and immutable — the thing a URL or header names. */\n slug: string;\n name: string;\n /** Absent means active. A suspended tenant is refused everywhere. */\n status?: \"active\" | \"suspended\";\n}\n\n/**\n * A user's membership of ONE tenant. `role` is the app's own vocabulary\n * (owner/admin/member, owner/operator/viewer …) — the package never defines it.\n * An app whose members belong to sub-units (Scout's units, cms' sites) derives\n * this organisation-level membership in its store.\n */\nexport interface Membership {\n userId: string;\n tenantId: string;\n role: string;\n}\n\n/**\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"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,56 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@broberg/tenant",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.2.0",
|
|
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 Broberg ID.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"sideEffects": false,
|
|
8
|
+
"files": [
|
|
9
|
+
"dist",
|
|
10
|
+
"README.md"
|
|
11
|
+
],
|
|
12
|
+
"main": "./dist/index.cjs",
|
|
13
|
+
"module": "./dist/index.js",
|
|
14
|
+
"types": "./dist/index.d.ts",
|
|
15
|
+
"exports": {
|
|
16
|
+
".": {
|
|
17
|
+
"types": "./dist/index.d.ts",
|
|
18
|
+
"import": "./dist/index.js",
|
|
19
|
+
"require": "./dist/index.cjs"
|
|
20
|
+
},
|
|
21
|
+
"./hono": {
|
|
22
|
+
"types": "./dist/hono.d.ts",
|
|
23
|
+
"import": "./dist/hono.js",
|
|
24
|
+
"require": "./dist/hono.cjs"
|
|
25
|
+
},
|
|
26
|
+
"./package.json": "./package.json"
|
|
27
|
+
},
|
|
28
|
+
"scripts": {
|
|
29
|
+
"build": "rm -rf dist && tsup && node verify-exports.mjs",
|
|
30
|
+
"test": "vitest run --reporter=default --reporter=json --outputFile.json=.vitest-report/results.json",
|
|
31
|
+
"typecheck": "tsc --noEmit"
|
|
32
|
+
},
|
|
33
|
+
"devDependencies": {
|
|
34
|
+
"@types/node": "^22.20.3",
|
|
35
|
+
"hono": "^4",
|
|
36
|
+
"tsup": "^8",
|
|
37
|
+
"typescript": "^5",
|
|
38
|
+
"vitest": "^3"
|
|
39
|
+
},
|
|
40
|
+
"publishConfig": {
|
|
41
|
+
"access": "public"
|
|
42
|
+
},
|
|
43
|
+
"repository": {
|
|
44
|
+
"type": "git",
|
|
45
|
+
"url": "git+https://github.com/broberg-ai/components.git",
|
|
46
|
+
"directory": "packages/tenant"
|
|
47
|
+
},
|
|
48
|
+
"peerDependencies": {
|
|
49
|
+
"hono": "^4"
|
|
50
|
+
},
|
|
51
|
+
"peerDependenciesMeta": {
|
|
52
|
+
"hono": {
|
|
53
|
+
"optional": true
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|