@anievo-id/rbac-evolution 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,402 @@
1
+ import { S as Subject, R as Role, T as TeamId, P as Permission, a as RbacTypeConfig, D as DefaultRbacTypes, b as RbacAdapter, c as RoleName, d as RoleInput, M as Many, e as PermissionInput, f as PermissionName, I as Id, g as RbacSnapshot, F as FindPermissionsQuery, h as FindRolesQuery, i as RolePermissionLink } from './adapter-BBs9C5pT.js';
2
+
3
+ /**
4
+ * Cache used to store each subject's resolved roles & permissions.
5
+ * Can be sync (in-memory) or async (Redis, KV, ...).
6
+ *
7
+ * `clear()` is called whenever roles or permissions change, so the store
8
+ * should be dedicated to rbac-evolution (or namespaced by your implementation).
9
+ */
10
+ interface CacheStore {
11
+ get(key: string): unknown | Promise<unknown>;
12
+ set(key: string, value: unknown, ttlMs: number): void | Promise<void>;
13
+ clear(): void | Promise<void>;
14
+ }
15
+ /** Default in-process cache with TTL support. */
16
+ declare class MemoryCache implements CacheStore {
17
+ private readonly store;
18
+ get(key: string): unknown;
19
+ set(key: string, value: unknown, ttlMs: number): void;
20
+ clear(): void;
21
+ }
22
+
23
+ /** Roles were attached to a subject (`assignRole`, `syncRoles`). Only newly attached roles are listed. */
24
+ interface RoleAttachedEvent {
25
+ event: 'role.attached';
26
+ subject: Subject;
27
+ roles: Role[];
28
+ guardName: string;
29
+ teamId: TeamId;
30
+ }
31
+ /** Roles were detached from a subject (`removeRole`, `syncRoles`). Only actually removed roles are listed. */
32
+ interface RoleDetachedEvent {
33
+ event: 'role.detached';
34
+ subject: Subject;
35
+ roles: Role[];
36
+ guardName: string;
37
+ teamId: TeamId;
38
+ }
39
+ /** Who received / lost the permissions: a subject (direct permissions) or a role. */
40
+ type PermissionTarget = {
41
+ target: 'subject';
42
+ subject: Subject;
43
+ } | {
44
+ target: 'role';
45
+ role: Role;
46
+ };
47
+ /** Permissions were attached to a subject or a role. Only newly attached permissions are listed. */
48
+ type PermissionAttachedEvent = {
49
+ event: 'permission.attached';
50
+ permissions: Permission[];
51
+ guardName: string;
52
+ /** The subject's team scope, or the role's `teamId`. */
53
+ teamId: TeamId;
54
+ } & PermissionTarget;
55
+ /** Permissions were detached from a subject or a role. Only actually removed permissions are listed. */
56
+ type PermissionDetachedEvent = {
57
+ event: 'permission.detached';
58
+ permissions: Permission[];
59
+ guardName: string;
60
+ /** The subject's team scope, or the role's `teamId`. */
61
+ teamId: TeamId;
62
+ } & PermissionTarget;
63
+ interface RoleCreatedEvent {
64
+ event: 'role.created';
65
+ role: Role;
66
+ teamId: TeamId;
67
+ }
68
+ interface RoleDeletedEvent {
69
+ event: 'role.deleted';
70
+ role: Role;
71
+ teamId: TeamId;
72
+ }
73
+ interface PermissionCreatedEvent {
74
+ event: 'permission.created';
75
+ permission: Permission;
76
+ }
77
+ interface PermissionDeletedEvent {
78
+ event: 'permission.deleted';
79
+ permission: Permission;
80
+ }
81
+ /** Every event emitted by `Rbac`, keyed by name. */
82
+ interface RbacEventMap {
83
+ 'role.attached': RoleAttachedEvent;
84
+ 'role.detached': RoleDetachedEvent;
85
+ 'permission.attached': PermissionAttachedEvent;
86
+ 'permission.detached': PermissionDetachedEvent;
87
+ 'role.created': RoleCreatedEvent;
88
+ 'role.deleted': RoleDeletedEvent;
89
+ 'permission.created': PermissionCreatedEvent;
90
+ 'permission.deleted': PermissionDeletedEvent;
91
+ }
92
+ type RbacEventName = keyof RbacEventMap;
93
+ /** Union of every event payload, discriminated by `event`. */
94
+ type RbacEvent = RbacEventMap[RbacEventName];
95
+ type RbacEventListener<K extends RbacEventName = RbacEventName> = (payload: RbacEventMap[K]) => void | Promise<void>;
96
+ /** @internal Minimal ordered async event emitter. */
97
+ declare class RbacEmitter {
98
+ #private;
99
+ on<K extends RbacEventName>(event: K, listener: RbacEventListener<K>): () => void;
100
+ off<K extends RbacEventName>(event: K, listener: RbacEventListener<K>): void;
101
+ has(event: RbacEventName): boolean;
102
+ /** Calls the listeners one by one, in registration order, awaiting each. */
103
+ emit<K extends RbacEventName>(payload: RbacEventMap[K] & {
104
+ event: K;
105
+ }): Promise<void>;
106
+ }
107
+
108
+ interface GuardOptions {
109
+ /** Guard name, e.g. `web` or `api`. Defaults to `defaultGuard`. */
110
+ guard?: string;
111
+ }
112
+ interface ScopeOptions extends GuardOptions {
113
+ /** Team id. Only allowed when `teams` is enabled. */
114
+ team?: TeamId;
115
+ }
116
+ /** Context passed to the {@link RbacOptions.before} hook. */
117
+ interface BeforeContext<T extends RbacTypeConfig = DefaultRbacTypes> {
118
+ /** The subject being checked (already scoped to its guard & team). */
119
+ subject: SubjectRbac<T>;
120
+ /** The permission name being checked. */
121
+ permission: string;
122
+ }
123
+ /** Return `true` to allow, `false` to deny, `undefined` to continue with the normal check. */
124
+ type BeforeHook<T extends RbacTypeConfig = DefaultRbacTypes> = (ctx: BeforeContext<T>) => boolean | undefined | Promise<boolean | undefined>;
125
+ interface RbacOptions<T extends RbacTypeConfig = DefaultRbacTypes> {
126
+ /** Storage adapter (e.g. `new MemoryAdapter()`, Prisma, Drizzle, ...). */
127
+ adapter: RbacAdapter;
128
+ /** Guard used when none is given. Default: `web`. */
129
+ defaultGuard?: string;
130
+ /** Enable wildcard permissions like `articles.*`. Default: `false`. */
131
+ wildcard?: boolean;
132
+ /** Enable team-scoped roles & permissions (multi-tenancy). Default: `false`. */
133
+ teams?: boolean;
134
+ /** Cache store, or `false` to disable caching. Default: in-memory cache. */
135
+ cache?: CacheStore | false;
136
+ /** Cache TTL in milliseconds. Default: 24 hours. */
137
+ cacheTtl?: number;
138
+ /**
139
+ * Runs before every `can()` / `cannot()` / `canAny()` / `canAll()` check (spatie's `Gate::before`).
140
+ * Return `true` to allow, `false` to deny, `undefined` to fall through to the normal check.
141
+ * Not applied to `hasPermissionTo()` & co., which stay pure data checks.
142
+ */
143
+ before?: BeforeHook<T>;
144
+ /**
145
+ * Subjects having ANY of these roles pass every `can()` check (super-admin).
146
+ * Evaluated after `before` (if `before` returned `undefined`).
147
+ */
148
+ superAdminRoles?: readonly RoleName<T>[];
149
+ }
150
+ /**
151
+ * The RBAC engine. Create one per app with {@link createRbac}.
152
+ *
153
+ * ```ts
154
+ * const rbac = createRbac({ adapter: new MemoryAdapter() })
155
+ * await rbac.createPermission('edit articles')
156
+ * await rbac.createRole('writer')
157
+ * await rbac.role('writer').givePermissionTo('edit articles')
158
+ * await rbac.for({ type: 'user', id: 1 }).assignRole('writer')
159
+ * await rbac.for({ type: 'user', id: 1 }).can('edit articles') // true
160
+ * ```
161
+ *
162
+ * `T` optionally narrows the accepted permission / role names, see {@link RbacTypeConfig}.
163
+ */
164
+ declare class Rbac<T extends RbacTypeConfig = DefaultRbacTypes> {
165
+ #private;
166
+ readonly adapter: RbacAdapter;
167
+ readonly defaultGuard: string;
168
+ readonly wildcard: boolean;
169
+ readonly teams: boolean;
170
+ constructor(options: RbacOptions<T>);
171
+ /** Work with the roles & permissions of a subject (usually a user). */
172
+ for(subject: Subject, options?: ScopeOptions): SubjectRbac<T>;
173
+ /** Work with the permissions of a role. */
174
+ role(role: RoleInput<RoleName<T>>, options?: ScopeOptions): RoleRbac<T>;
175
+ /**
176
+ * Listens to an event. Listeners run in registration order and are awaited one by one,
177
+ * after the change has been written by the adapter. Returns an unsubscribe function.
178
+ */
179
+ on<K extends RbacEventName>(event: K, listener: RbacEventListener<K>): () => void;
180
+ /** Removes a listener added with {@link on}. */
181
+ off<K extends RbacEventName>(event: K, listener: RbacEventListener<K>): void;
182
+ /** @internal */
183
+ get events(): RbacEmitter;
184
+ createPermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
185
+ findPermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission | null>;
186
+ findPermissionOrFail(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
187
+ findOrCreatePermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
188
+ getPermissions(options?: GuardOptions): Promise<Permission[]>;
189
+ deletePermission(permission: PermissionInput<PermissionName<T>>, options?: GuardOptions): Promise<void>;
190
+ createRole(name: RoleName<T>, options?: ScopeOptions): Promise<Role>;
191
+ /** Finds a role. With a team, a team-specific role wins over a global role of the same name. */
192
+ findRole(name: RoleName<T>, options?: ScopeOptions): Promise<Role | null>;
193
+ findRoleOrFail(name: RoleName<T>, options?: ScopeOptions): Promise<Role>;
194
+ findOrCreateRole(name: RoleName<T>, options?: ScopeOptions): Promise<Role>;
195
+ /** Lists roles visible in the given scope (global roles + roles of the given team). */
196
+ getRoles(options?: ScopeOptions): Promise<Role[]>;
197
+ deleteRole(role: RoleInput<RoleName<T>>, options?: ScopeOptions): Promise<void>;
198
+ /**
199
+ * Ids of subjects of `subjectType` that have ANY of the given roles in the given scope
200
+ * (spatie: `User::role('writer')->get()`). Throws `RoleDoesNotExist` for unknown roles.
201
+ */
202
+ subjectsWithRole(subjectType: string, roles: Many<RoleInput<RoleName<T>>>, options?: ScopeOptions): Promise<Id[]>;
203
+ /**
204
+ * Ids of subjects of `subjectType` that have ANY of the given permissions in the given scope —
205
+ * directly or via one of their roles (spatie: `User::permission('edit')->get()`).
206
+ * Throws `PermissionDoesNotExist` for unknown permissions. Wildcards are not expanded.
207
+ */
208
+ subjectsWithPermission(subjectType: string, permissions: Many<PermissionInput<PermissionName<T>>>, options?: ScopeOptions): Promise<Id[]>;
209
+ /** Clears every cached role/permission lookup. Called automatically after each change. */
210
+ forgetCachedPermissions(): Promise<void>;
211
+ /** @internal */
212
+ remember<V>(key: string, compute: () => Promise<V>): Promise<V>;
213
+ /** @internal Runs the `before` hook and the super-admin check. `undefined` = no decision. */
214
+ gate(subject: SubjectRbac<T>, permission: string): Promise<boolean | undefined>;
215
+ /** @internal */
216
+ resolveGuard(guard: string | undefined): string;
217
+ /** @internal */
218
+ resolveTeam(team: TeamId | undefined): TeamId;
219
+ /** @internal */
220
+ visibleTeams(teamId: TeamId): TeamId[];
221
+ /** @internal Resolves names/objects to permissions, validating existence and guard. */
222
+ resolvePermissions(inputs: readonly PermissionInput[], guardName: string): Promise<Permission[]>;
223
+ /** @internal Resolves names/objects to roles, validating existence, guard and team. */
224
+ resolveRoles(inputs: readonly RoleInput[], guardName: string, teamId: TeamId): Promise<Role[]>;
225
+ /** @internal */
226
+ permissionMatches(granted: readonly string[], required: string): boolean;
227
+ private static pickRole;
228
+ }
229
+ /** Permissions of a single role. Obtain with `rbac.role('writer')`. */
230
+ declare class RoleRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
231
+ private readonly rbac;
232
+ private readonly input;
233
+ readonly guardName: string;
234
+ readonly teamId: TeamId;
235
+ constructor(rbac: Rbac<T>, input: RoleInput, guardName: string, teamId: TeamId);
236
+ /** Returns the role, throwing `RoleDoesNotExist` if it can't be found. */
237
+ get(): Promise<Role>;
238
+ givePermissionTo(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<this>;
239
+ revokePermissionTo(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<this>;
240
+ /** Replaces all permissions of the role with the given ones. */
241
+ syncPermissions(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<this>;
242
+ getPermissions(): Promise<Permission[]>;
243
+ getPermissionNames(): Promise<string[]>;
244
+ hasPermissionTo(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
245
+ private currentPermissionIds;
246
+ private emit;
247
+ }
248
+ /** Roles & permissions of a single subject. Obtain with `rbac.for(user)`. */
249
+ declare class SubjectRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
250
+ private readonly rbac;
251
+ readonly subject: Subject;
252
+ readonly guardName: string;
253
+ readonly teamId: TeamId;
254
+ constructor(rbac: Rbac<T>, subject: Subject, guardName: string, teamId: TeamId);
255
+ assignRole(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<this>;
256
+ removeRole(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<this>;
257
+ /** Replaces all roles (in the current guard & team) with the given ones. */
258
+ syncRoles(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<this>;
259
+ getRoles(): Promise<Role[]>;
260
+ getRoleNames(): Promise<string[]>;
261
+ /** `true` if the subject has the role — or ANY of the roles when given an array. */
262
+ hasRole(roles: Many<RoleInput<RoleName<T>>>): Promise<boolean>;
263
+ hasAnyRole(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<boolean>;
264
+ hasAllRoles(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<boolean>;
265
+ /** `true` if the subject has ALL the given roles and no other role (in the current guard & team). */
266
+ hasExactRoles(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<boolean>;
267
+ givePermissionTo(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<this>;
268
+ revokePermissionTo(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<this>;
269
+ /** Replaces all direct permissions (in the current guard & team) with the given ones. */
270
+ syncPermissions(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<this>;
271
+ getDirectPermissions(): Promise<Permission[]>;
272
+ getPermissionsViaRoles(): Promise<Permission[]>;
273
+ getAllPermissions(): Promise<Permission[]>;
274
+ getPermissionNames(): Promise<string[]>;
275
+ /**
276
+ * Checks a permission (direct or via roles). Pure data check: the `before` hook and
277
+ * `superAdminRoles` are NOT applied (like spatie, where only `can()` goes through the Gate).
278
+ * Throws `PermissionDoesNotExist` if the permission is unknown (when wildcard is off).
279
+ * Use {@link can} for a check that never throws.
280
+ */
281
+ hasPermissionTo(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
282
+ /** Checks a direct permission only (ignores roles). */
283
+ hasDirectPermission(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
284
+ /**
285
+ * Authorization check: runs the `before` hook and `superAdminRoles` first, then falls back
286
+ * to {@link hasPermissionTo}, returning `false` instead of throwing.
287
+ */
288
+ can(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
289
+ cannot(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
290
+ canAny(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
291
+ canAll(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
292
+ /** `true` if the subject has ANY of the permissions. Pure data check (no `before` / super-admin), never throws. */
293
+ hasAnyPermission(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
294
+ /** `true` if the subject has ALL the permissions. Pure data check (no `before` / super-admin), never throws. */
295
+ hasAllPermissions(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
296
+ /** Serializable `{ roles, permissions }` — e.g. to hydrate a React/Vue client. */
297
+ snapshot(): Promise<RbacSnapshot>;
298
+ /** {@link hasPermissionTo} that returns `false` instead of throwing. */
299
+ private check;
300
+ private requirePermissionName;
301
+ private state;
302
+ private emitRoles;
303
+ private emitPermissions;
304
+ private static roleMatches;
305
+ }
306
+ /**
307
+ * Creates the RBAC engine. Pass a type argument to restrict permission / role names:
308
+ * `createRbac<{ permissions: 'edit' | 'delete'; roles: 'writer' }>({ adapter })`.
309
+ */
310
+ declare function createRbac<T extends RbacTypeConfig = DefaultRbacTypes>(options: RbacOptions<T>): Rbac<T>;
311
+
312
+ /**
313
+ * In-memory adapter. Great for tests, prototypes, or apps whose roles are defined in code.
314
+ * Data is lost when the process exits.
315
+ */
316
+ declare class MemoryAdapter implements RbacAdapter {
317
+ private nextId;
318
+ private permissions;
319
+ private roles;
320
+ private rolePermissions;
321
+ private subjectRoles;
322
+ private subjectPermissions;
323
+ createPermission(data: {
324
+ name: string;
325
+ guardName: string;
326
+ }): Promise<Permission>;
327
+ findPermissions(query?: FindPermissionsQuery): Promise<Permission[]>;
328
+ deletePermission(id: Id): Promise<void>;
329
+ createRole(data: {
330
+ name: string;
331
+ guardName: string;
332
+ teamId: TeamId;
333
+ }): Promise<Role>;
334
+ findRoles(query?: FindRolesQuery): Promise<Role[]>;
335
+ deleteRole(id: Id): Promise<void>;
336
+ getRolePermissionLinks(roleIds: readonly Id[]): Promise<RolePermissionLink[]>;
337
+ attachRolePermissions(roleId: Id, permissionIds: readonly Id[]): Promise<void>;
338
+ detachRolePermissions(roleId: Id, permissionIds?: readonly Id[]): Promise<void>;
339
+ getSubjectRoleIds(subject: Subject, teamId: TeamId): Promise<Id[]>;
340
+ attachSubjectRoles(subject: Subject, roleIds: readonly Id[], teamId: TeamId): Promise<void>;
341
+ detachSubjectRoles(subject: Subject, roleIds: readonly Id[] | undefined, teamId: TeamId): Promise<void>;
342
+ getSubjectPermissionIds(subject: Subject, teamId: TeamId): Promise<Id[]>;
343
+ attachSubjectPermissions(subject: Subject, permissionIds: readonly Id[], teamId: TeamId): Promise<void>;
344
+ detachSubjectPermissions(subject: Subject, permissionIds: readonly Id[] | undefined, teamId: TeamId): Promise<void>;
345
+ getSubjectIdsWithRoles(subjectType: string, roleIds: readonly Id[], teamId: TeamId): Promise<Id[]>;
346
+ getSubjectIdsWithPermissions(subjectType: string, permissionIds: readonly Id[], teamId: TeamId): Promise<Id[]>;
347
+ private static getLinks;
348
+ private static attach;
349
+ private static detach;
350
+ private static reverse;
351
+ }
352
+
353
+ type RbacErrorCode = 'PERMISSION_DOES_NOT_EXIST' | 'PERMISSION_ALREADY_EXISTS' | 'ROLE_DOES_NOT_EXIST' | 'ROLE_ALREADY_EXISTS' | 'GUARD_DOES_NOT_MATCH' | 'TEAM_DOES_NOT_MATCH' | 'TEAMS_NOT_ENABLED' | 'INVALID_NAME' | 'INVALID_WILDCARD_PERMISSION';
354
+ declare class RbacError extends Error {
355
+ readonly code: RbacErrorCode;
356
+ constructor(code: RbacErrorCode, message: string);
357
+ }
358
+ declare class PermissionDoesNotExist extends RbacError {
359
+ constructor(name: string, guardName: string);
360
+ }
361
+ declare class PermissionAlreadyExists extends RbacError {
362
+ constructor(name: string, guardName: string);
363
+ }
364
+ declare class RoleDoesNotExist extends RbacError {
365
+ constructor(name: string, guardName: string);
366
+ }
367
+ declare class RoleAlreadyExists extends RbacError {
368
+ constructor(name: string, guardName: string);
369
+ }
370
+ declare class GuardDoesNotMatch extends RbacError {
371
+ constructor(given: string, expected: string);
372
+ }
373
+ declare class InvalidWildcardPermission extends RbacError {
374
+ constructor(permission: string);
375
+ }
376
+
377
+ /**
378
+ * Splits a permission into parts and subparts.
379
+ *
380
+ * `articles.edit,delete.own` → `[['articles'], ['edit', 'delete'], ['own']]`
381
+ */
382
+ declare function parseWildcardPermission(permission: string): string[][];
383
+ /**
384
+ * Returns `true` when the `granted` permission covers the `required` one.
385
+ *
386
+ * - `*` covers everything.
387
+ * - `articles.*` covers `articles.edit`, `articles.edit.own`, ...
388
+ * - `articles` covers `articles.edit` (a shorter permission implies everything below it).
389
+ * - `articles.edit,delete` covers `articles.edit` and `articles.delete`, not `articles.create`.
390
+ * - `articles.edit` does NOT cover `articles.*` or `articles`.
391
+ */
392
+ declare function wildcardImplies(granted: string, required: string): boolean;
393
+
394
+ /**
395
+ * @anievo-id/rbac-evolution
396
+ *
397
+ * Framework-agnostic RBAC engine — roles, permissions, guards, wildcards and teams.
398
+ */
399
+
400
+ declare const VERSION = "0.1.0";
401
+
402
+ export { type BeforeContext, type BeforeHook, type CacheStore, DefaultRbacTypes, FindPermissionsQuery, FindRolesQuery, GuardDoesNotMatch, type GuardOptions, Id, InvalidWildcardPermission, Many, MemoryAdapter, MemoryCache, Permission, PermissionAlreadyExists, type PermissionAttachedEvent, type PermissionCreatedEvent, type PermissionDeletedEvent, type PermissionDetachedEvent, PermissionDoesNotExist, PermissionInput, PermissionName, type PermissionTarget, Rbac, RbacAdapter, RbacError, type RbacErrorCode, type RbacEvent, type RbacEventListener, type RbacEventMap, type RbacEventName, type RbacOptions, RbacSnapshot, RbacTypeConfig, Role, RoleAlreadyExists, type RoleAttachedEvent, type RoleCreatedEvent, type RoleDeletedEvent, type RoleDetachedEvent, RoleDoesNotExist, RoleInput, RoleName, RolePermissionLink, RoleRbac, type ScopeOptions, Subject, SubjectRbac, TeamId, VERSION, createRbac, parseWildcardPermission, wildcardImplies };
package/dist/index.js ADDED
@@ -0,0 +1,121 @@
1
+ export { GuardDoesNotMatch, InvalidWildcardPermission, MemoryCache, PermissionAlreadyExists, PermissionDoesNotExist, Rbac, RbacError, RoleAlreadyExists, RoleDoesNotExist, RoleRbac, SubjectRbac, createRbac, parseWildcardPermission, wildcardImplies } from './chunk-JQ53Q7UP.js';
2
+
3
+ // src/adapters/memory.ts
4
+ var key = (id) => id === null ? "\0null" : String(id);
5
+ var same = (a, b) => key(a) === key(b);
6
+ var inIds = (ids, id) => ids.some((x) => same(x, id));
7
+ var isSubject = (l, s) => l.subjectType === s.type && same(l.subjectId, s.id);
8
+ var MemoryAdapter = class _MemoryAdapter {
9
+ nextId = 1;
10
+ permissions = [];
11
+ roles = [];
12
+ rolePermissions = [];
13
+ subjectRoles = [];
14
+ subjectPermissions = [];
15
+ // ---------------------------------------------------------------- permissions
16
+ async createPermission(data) {
17
+ const permission = { id: this.nextId++, name: data.name, guardName: data.guardName };
18
+ this.permissions.push(permission);
19
+ return { ...permission };
20
+ }
21
+ async findPermissions(query = {}) {
22
+ return this.permissions.filter(
23
+ (p) => (query.ids === void 0 || inIds(query.ids, p.id)) && (query.names === void 0 || query.names.includes(p.name)) && (query.guardName === void 0 || p.guardName === query.guardName)
24
+ ).map((p) => ({ ...p }));
25
+ }
26
+ async deletePermission(id) {
27
+ this.permissions = this.permissions.filter((p) => !same(p.id, id));
28
+ this.rolePermissions = this.rolePermissions.filter((l) => !same(l.permissionId, id));
29
+ this.subjectPermissions = this.subjectPermissions.filter((l) => !same(l.targetId, id));
30
+ }
31
+ // ---------------------------------------------------------------------- roles
32
+ async createRole(data) {
33
+ const role = { id: this.nextId++, name: data.name, guardName: data.guardName, teamId: data.teamId };
34
+ this.roles.push(role);
35
+ return { ...role };
36
+ }
37
+ async findRoles(query = {}) {
38
+ return this.roles.filter(
39
+ (r) => (query.ids === void 0 || inIds(query.ids, r.id)) && (query.names === void 0 || query.names.includes(r.name)) && (query.guardName === void 0 || r.guardName === query.guardName) && (query.teamIds === void 0 || inIds(query.teamIds, r.teamId))
40
+ ).map((r) => ({ ...r }));
41
+ }
42
+ async deleteRole(id) {
43
+ this.roles = this.roles.filter((r) => !same(r.id, id));
44
+ this.rolePermissions = this.rolePermissions.filter((l) => !same(l.roleId, id));
45
+ this.subjectRoles = this.subjectRoles.filter((l) => !same(l.targetId, id));
46
+ }
47
+ // ---------------------------------------------------------- role ↔ permission
48
+ async getRolePermissionLinks(roleIds) {
49
+ return this.rolePermissions.filter((l) => inIds(roleIds, l.roleId)).map((l) => ({ ...l }));
50
+ }
51
+ async attachRolePermissions(roleId, permissionIds) {
52
+ for (const permissionId of permissionIds) {
53
+ const exists = this.rolePermissions.some((l) => same(l.roleId, roleId) && same(l.permissionId, permissionId));
54
+ if (!exists) this.rolePermissions.push({ roleId, permissionId });
55
+ }
56
+ }
57
+ async detachRolePermissions(roleId, permissionIds) {
58
+ this.rolePermissions = this.rolePermissions.filter(
59
+ (l) => !(same(l.roleId, roleId) && (permissionIds === void 0 || inIds(permissionIds, l.permissionId)))
60
+ );
61
+ }
62
+ // ------------------------------------------------------------- subject links
63
+ async getSubjectRoleIds(subject, teamId) {
64
+ return _MemoryAdapter.getLinks(this.subjectRoles, subject, teamId);
65
+ }
66
+ async attachSubjectRoles(subject, roleIds, teamId) {
67
+ _MemoryAdapter.attach(this.subjectRoles, subject, roleIds, teamId);
68
+ }
69
+ async detachSubjectRoles(subject, roleIds, teamId) {
70
+ this.subjectRoles = _MemoryAdapter.detach(this.subjectRoles, subject, roleIds, teamId);
71
+ }
72
+ async getSubjectPermissionIds(subject, teamId) {
73
+ return _MemoryAdapter.getLinks(this.subjectPermissions, subject, teamId);
74
+ }
75
+ async attachSubjectPermissions(subject, permissionIds, teamId) {
76
+ _MemoryAdapter.attach(this.subjectPermissions, subject, permissionIds, teamId);
77
+ }
78
+ async detachSubjectPermissions(subject, permissionIds, teamId) {
79
+ this.subjectPermissions = _MemoryAdapter.detach(this.subjectPermissions, subject, permissionIds, teamId);
80
+ }
81
+ async getSubjectIdsWithRoles(subjectType, roleIds, teamId) {
82
+ return _MemoryAdapter.reverse(this.subjectRoles, subjectType, roleIds, teamId);
83
+ }
84
+ async getSubjectIdsWithPermissions(subjectType, permissionIds, teamId) {
85
+ return _MemoryAdapter.reverse(this.subjectPermissions, subjectType, permissionIds, teamId);
86
+ }
87
+ // -------------------------------------------------------------------- helpers
88
+ static getLinks(links, subject, teamId) {
89
+ return links.filter((l) => isSubject(l, subject) && same(l.teamId, teamId)).map((l) => l.targetId);
90
+ }
91
+ static attach(links, subject, ids, teamId) {
92
+ for (const targetId of ids) {
93
+ const exists = links.some((l) => isSubject(l, subject) && same(l.targetId, targetId) && same(l.teamId, teamId));
94
+ if (!exists) links.push({ subjectType: subject.type, subjectId: subject.id, targetId, teamId });
95
+ }
96
+ }
97
+ static detach(links, subject, ids, teamId) {
98
+ return links.filter(
99
+ (l) => !(isSubject(l, subject) && same(l.teamId, teamId) && (ids === void 0 || inIds(ids, l.targetId)))
100
+ );
101
+ }
102
+ static reverse(links, subjectType, ids, teamId) {
103
+ const seen = /* @__PURE__ */ new Set();
104
+ const out = [];
105
+ for (const l of links) {
106
+ if (l.subjectType !== subjectType || !same(l.teamId, teamId) || !inIds(ids, l.targetId)) continue;
107
+ const k = key(l.subjectId);
108
+ if (seen.has(k)) continue;
109
+ seen.add(k);
110
+ out.push(l.subjectId);
111
+ }
112
+ return out;
113
+ }
114
+ };
115
+
116
+ // src/index.ts
117
+ var VERSION = "0.1.0";
118
+
119
+ export { MemoryAdapter, VERSION };
120
+ //# sourceMappingURL=index.js.map
121
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/adapters/memory.ts","../src/index.ts"],"names":[],"mappings":";;;AAUA,IAAM,MAAM,CAAC,EAAA,KAA2B,OAAO,IAAA,GAAO,QAAA,GAAe,OAAO,EAAE,CAAA;AAC9E,IAAM,IAAA,GAAO,CAAC,CAAA,EAAc,CAAA,KAA0B,IAAI,CAAC,CAAA,KAAM,IAAI,CAAC,CAAA;AACtE,IAAM,KAAA,GAAQ,CAAC,GAAA,EAA6B,EAAA,KAA2B,GAAA,CAAI,IAAA,CAAK,CAAC,CAAA,KAAM,IAAA,CAAK,CAAA,EAAG,EAAE,CAAC,CAAA;AAClG,IAAM,SAAA,GAAY,CAAC,CAAA,EAAgB,CAAA,KAAwB,CAAA,CAAE,WAAA,KAAgB,CAAA,CAAE,IAAA,IAAQ,IAAA,CAAK,CAAA,CAAE,SAAA,EAAW,CAAA,CAAE,EAAE,CAAA;AAMtG,IAAM,aAAA,GAAN,MAAM,cAAA,CAAqC;AAAA,EACxC,MAAA,GAAS,CAAA;AAAA,EACT,cAA4B,EAAC;AAAA,EAC7B,QAAgB,EAAC;AAAA,EACjB,kBAAwC,EAAC;AAAA,EACzC,eAA8B,EAAC;AAAA,EAC/B,qBAAoC,EAAC;AAAA;AAAA,EAI7C,MAAM,iBAAiB,IAAA,EAAgE;AACrF,IAAA,MAAM,UAAA,GAAyB,EAAE,EAAA,EAAI,IAAA,CAAK,MAAA,EAAA,EAAU,MAAM,IAAA,CAAK,IAAA,EAAM,SAAA,EAAW,IAAA,CAAK,SAAA,EAAU;AAC/F,IAAA,IAAA,CAAK,WAAA,CAAY,KAAK,UAAU,CAAA;AAChC,IAAA,OAAO,EAAE,GAAG,UAAA,EAAW;AAAA,EACzB;AAAA,EAEA,MAAM,eAAA,CAAgB,KAAA,GAA8B,EAAC,EAA0B;AAC7E,IAAA,OAAO,KAAK,WAAA,CACT,MAAA;AAAA,MACC,CAAC,CAAA,KAAA,CACE,KAAA,CAAM,GAAA,KAAQ,MAAA,IAAa,MAAM,KAAA,CAAM,GAAA,EAAK,CAAA,CAAE,EAAE,CAAA,MAChD,KAAA,CAAM,UAAU,MAAA,IAAa,KAAA,CAAM,KAAA,CAAM,QAAA,CAAS,CAAA,CAAE,IAAI,CAAA,CAAA,KACxD,KAAA,CAAM,SAAA,KAAc,MAAA,IAAa,CAAA,CAAE,SAAA,KAAc,KAAA,CAAM,SAAA;AAAA,MAE3D,GAAA,CAAI,CAAC,OAAO,EAAE,GAAG,GAAE,CAAE,CAAA;AAAA,EAC1B;AAAA,EAEA,MAAM,iBAAiB,EAAA,EAAuB;AAC5C,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,WAAA,CAAY,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,IAAA,CAAK,CAAA,CAAE,EAAA,EAAI,EAAE,CAAC,CAAA;AACjE,IAAA,IAAA,CAAK,eAAA,GAAkB,IAAA,CAAK,eAAA,CAAgB,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,IAAA,CAAK,CAAA,CAAE,YAAA,EAAc,EAAE,CAAC,CAAA;AACnF,IAAA,IAAA,CAAK,kBAAA,GAAqB,IAAA,CAAK,kBAAA,CAAmB,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,IAAA,CAAK,CAAA,CAAE,QAAA,EAAU,EAAE,CAAC,CAAA;AAAA,EACvF;AAAA;AAAA,EAIA,MAAM,WAAW,IAAA,EAA0E;AACzF,IAAA,MAAM,IAAA,GAAa,EAAE,EAAA,EAAI,IAAA,CAAK,MAAA,EAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,SAAA,EAAW,IAAA,CAAK,SAAA,EAAW,MAAA,EAAQ,KAAK,MAAA,EAAO;AACxG,IAAA,IAAA,CAAK,KAAA,CAAM,KAAK,IAAI,CAAA;AACpB,IAAA,OAAO,EAAE,GAAG,IAAA,EAAK;AAAA,EACnB;AAAA,EAEA,MAAM,SAAA,CAAU,KAAA,GAAwB,EAAC,EAAoB;AAC3D,IAAA,OAAO,KAAK,KAAA,CACT,MAAA;AAAA,MACC,CAAC,CAAA,KAAA,CACE,KAAA,CAAM,GAAA,KAAQ,UAAa,KAAA,CAAM,KAAA,CAAM,GAAA,EAAK,CAAA,CAAE,EAAE,CAAA,MAChD,KAAA,CAAM,KAAA,KAAU,MAAA,IAAa,MAAM,KAAA,CAAM,QAAA,CAAS,CAAA,CAAE,IAAI,CAAA,CAAA,KACxD,KAAA,CAAM,SAAA,KAAc,MAAA,IAAa,EAAE,SAAA,KAAc,KAAA,CAAM,SAAA,CAAA,KACvD,KAAA,CAAM,YAAY,MAAA,IAAa,KAAA,CAAM,KAAA,CAAM,OAAA,EAAS,EAAE,MAAM,CAAA;AAAA,MAEhE,GAAA,CAAI,CAAC,OAAO,EAAE,GAAG,GAAE,CAAE,CAAA;AAAA,EAC1B;AAAA,EAEA,MAAM,WAAW,EAAA,EAAuB;AACtC,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,IAAA,CAAK,CAAA,CAAE,EAAA,EAAI,EAAE,CAAC,CAAA;AACrD,IAAA,IAAA,CAAK,eAAA,GAAkB,IAAA,CAAK,eAAA,CAAgB,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,IAAA,CAAK,CAAA,CAAE,MAAA,EAAQ,EAAE,CAAC,CAAA;AAC7E,IAAA,IAAA,CAAK,YAAA,GAAe,IAAA,CAAK,YAAA,CAAa,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,IAAA,CAAK,CAAA,CAAE,QAAA,EAAU,EAAE,CAAC,CAAA;AAAA,EAC3E;AAAA;AAAA,EAIA,MAAM,uBAAuB,OAAA,EAAuD;AAClF,IAAA,OAAO,KAAK,eAAA,CAAgB,MAAA,CAAO,CAAC,CAAA,KAAM,MAAM,OAAA,EAAS,CAAA,CAAE,MAAM,CAAC,EAAE,GAAA,CAAI,CAAC,OAAO,EAAE,GAAG,GAAE,CAAE,CAAA;AAAA,EAC3F;AAAA,EAEA,MAAM,qBAAA,CAAsB,MAAA,EAAY,aAAA,EAA6C;AACnF,IAAA,KAAA,MAAW,gBAAgB,aAAA,EAAe;AACxC,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,CAAC,CAAA,KAAM,IAAA,CAAK,CAAA,CAAE,MAAA,EAAQ,MAAM,CAAA,IAAK,IAAA,CAAK,CAAA,CAAE,YAAA,EAAc,YAAY,CAAC,CAAA;AAC5G,MAAA,IAAI,CAAC,QAAQ,IAAA,CAAK,eAAA,CAAgB,KAAK,EAAE,MAAA,EAAQ,cAAc,CAAA;AAAA,IACjE;AAAA,EACF;AAAA,EAEA,MAAM,qBAAA,CAAsB,MAAA,EAAY,aAAA,EAA8C;AACpF,IAAA,IAAA,CAAK,eAAA,GAAkB,KAAK,eAAA,CAAgB,MAAA;AAAA,MAC1C,CAAC,CAAA,KAAM,EAAE,IAAA,CAAK,CAAA,CAAE,MAAA,EAAQ,MAAM,CAAA,KAAM,aAAA,KAAkB,MAAA,IAAa,KAAA,CAAM,aAAA,EAAe,EAAE,YAAY,CAAA,CAAA;AAAA,KACxG;AAAA,EACF;AAAA;AAAA,EAIA,MAAM,iBAAA,CAAkB,OAAA,EAAkB,MAAA,EAA+B;AACvE,IAAA,OAAO,cAAA,CAAc,QAAA,CAAS,IAAA,CAAK,YAAA,EAAc,SAAS,MAAM,CAAA;AAAA,EAClE;AAAA,EAEA,MAAM,kBAAA,CAAmB,OAAA,EAAkB,OAAA,EAAwB,MAAA,EAA+B;AAChG,IAAA,cAAA,CAAc,MAAA,CAAO,IAAA,CAAK,YAAA,EAAc,OAAA,EAAS,SAAS,MAAM,CAAA;AAAA,EAClE;AAAA,EAEA,MAAM,kBAAA,CAAmB,OAAA,EAAkB,OAAA,EAAoC,MAAA,EAA+B;AAC5G,IAAA,IAAA,CAAK,eAAe,cAAA,CAAc,MAAA,CAAO,KAAK,YAAA,EAAc,OAAA,EAAS,SAAS,MAAM,CAAA;AAAA,EACtF;AAAA,EAEA,MAAM,uBAAA,CAAwB,OAAA,EAAkB,MAAA,EAA+B;AAC7E,IAAA,OAAO,cAAA,CAAc,QAAA,CAAS,IAAA,CAAK,kBAAA,EAAoB,SAAS,MAAM,CAAA;AAAA,EACxE;AAAA,EAEA,MAAM,wBAAA,CAAyB,OAAA,EAAkB,aAAA,EAA8B,MAAA,EAA+B;AAC5G,IAAA,cAAA,CAAc,MAAA,CAAO,IAAA,CAAK,kBAAA,EAAoB,OAAA,EAAS,eAAe,MAAM,CAAA;AAAA,EAC9E;AAAA,EAEA,MAAM,wBAAA,CACJ,OAAA,EACA,aAAA,EACA,MAAA,EACe;AACf,IAAA,IAAA,CAAK,qBAAqB,cAAA,CAAc,MAAA,CAAO,KAAK,kBAAA,EAAoB,OAAA,EAAS,eAAe,MAAM,CAAA;AAAA,EACxG;AAAA,EAEA,MAAM,sBAAA,CAAuB,WAAA,EAAqB,OAAA,EAAwB,MAAA,EAA+B;AACvG,IAAA,OAAO,eAAc,OAAA,CAAQ,IAAA,CAAK,YAAA,EAAc,WAAA,EAAa,SAAS,MAAM,CAAA;AAAA,EAC9E;AAAA,EAEA,MAAM,4BAAA,CAA6B,WAAA,EAAqB,aAAA,EAA8B,MAAA,EAA+B;AACnH,IAAA,OAAO,eAAc,OAAA,CAAQ,IAAA,CAAK,kBAAA,EAAoB,WAAA,EAAa,eAAe,MAAM,CAAA;AAAA,EAC1F;AAAA;AAAA,EAIA,OAAe,QAAA,CAAS,KAAA,EAAsB,OAAA,EAAkB,MAAA,EAAsB;AACpF,IAAA,OAAO,MAAM,MAAA,CAAO,CAAC,MAAM,SAAA,CAAU,CAAA,EAAG,OAAO,CAAA,IAAK,IAAA,CAAK,CAAA,CAAE,MAAA,EAAQ,MAAM,CAAC,CAAA,CAAE,IAAI,CAAC,CAAA,KAAM,EAAE,QAAQ,CAAA;AAAA,EACnG;AAAA,EAEA,OAAe,MAAA,CAAO,KAAA,EAAsB,OAAA,EAAkB,KAAoB,MAAA,EAAsB;AACtG,IAAA,KAAA,MAAW,YAAY,GAAA,EAAK;AAC1B,MAAA,MAAM,SAAS,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA,KAAM,SAAA,CAAU,GAAG,OAAO,CAAA,IAAK,IAAA,CAAK,CAAA,CAAE,UAAU,QAAQ,CAAA,IAAK,KAAK,CAAA,CAAE,MAAA,EAAQ,MAAM,CAAC,CAAA;AAC9G,MAAA,IAAI,CAAC,MAAA,EAAQ,KAAA,CAAM,IAAA,CAAK,EAAE,WAAA,EAAa,OAAA,CAAQ,IAAA,EAAM,SAAA,EAAW,OAAA,CAAQ,EAAA,EAAI,QAAA,EAAU,QAAQ,CAAA;AAAA,IAChG;AAAA,EACF;AAAA,EAEA,OAAe,MAAA,CACb,KAAA,EACA,OAAA,EACA,KACA,MAAA,EACe;AACf,IAAA,OAAO,KAAA,CAAM,MAAA;AAAA,MACX,CAAC,CAAA,KAAM,EAAE,SAAA,CAAU,CAAA,EAAG,OAAO,CAAA,IAAK,IAAA,CAAK,CAAA,CAAE,MAAA,EAAQ,MAAM,CAAA,KAAM,GAAA,KAAQ,UAAa,KAAA,CAAM,GAAA,EAAK,EAAE,QAAQ,CAAA,CAAA;AAAA,KACzG;AAAA,EACF;AAAA,EAEA,OAAe,OAAA,CAAQ,KAAA,EAAsB,WAAA,EAAqB,KAAoB,MAAA,EAAsB;AAC1G,IAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,IAAA,MAAM,MAAY,EAAC;AACnB,IAAA,KAAA,MAAW,KAAK,KAAA,EAAO;AACrB,MAAA,IAAI,CAAA,CAAE,WAAA,KAAgB,WAAA,IAAe,CAAC,KAAK,CAAA,CAAE,MAAA,EAAQ,MAAM,CAAA,IAAK,CAAC,KAAA,CAAM,GAAA,EAAK,CAAA,CAAE,QAAQ,CAAA,EAAG;AACzF,MAAA,MAAM,CAAA,GAAI,GAAA,CAAI,CAAA,CAAE,SAAS,CAAA;AACzB,MAAA,IAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAA,EAAG;AACjB,MAAA,IAAA,CAAK,IAAI,CAAC,CAAA;AACV,MAAA,GAAA,CAAI,IAAA,CAAK,EAAE,SAAS,CAAA;AAAA,IACtB;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AACF;;;AC1GO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["import type { FindPermissionsQuery, FindRolesQuery, RbacAdapter, RolePermissionLink } from '../adapter'\nimport type { Id, Permission, Role, Subject, TeamId } from '../types'\n\ninterface SubjectLink {\n subjectType: string\n subjectId: Id\n targetId: Id\n teamId: TeamId\n}\n\nconst key = (id: Id | null): string => (id === null ? '\\u0000null' : String(id))\nconst same = (a: Id | null, b: Id | null): boolean => key(a) === key(b)\nconst inIds = (ids: readonly (Id | null)[], id: Id | null): boolean => ids.some((x) => same(x, id))\nconst isSubject = (l: SubjectLink, s: Subject): boolean => l.subjectType === s.type && same(l.subjectId, s.id)\n\n/**\n * In-memory adapter. Great for tests, prototypes, or apps whose roles are defined in code.\n * Data is lost when the process exits.\n */\nexport class MemoryAdapter implements RbacAdapter {\n private nextId = 1\n private permissions: Permission[] = []\n private roles: Role[] = []\n private rolePermissions: RolePermissionLink[] = []\n private subjectRoles: SubjectLink[] = []\n private subjectPermissions: SubjectLink[] = []\n\n // ---------------------------------------------------------------- permissions\n\n async createPermission(data: { name: string; guardName: string }): Promise<Permission> {\n const permission: Permission = { id: this.nextId++, name: data.name, guardName: data.guardName }\n this.permissions.push(permission)\n return { ...permission }\n }\n\n async findPermissions(query: FindPermissionsQuery = {}): Promise<Permission[]> {\n return this.permissions\n .filter(\n (p) =>\n (query.ids === undefined || inIds(query.ids, p.id)) &&\n (query.names === undefined || query.names.includes(p.name)) &&\n (query.guardName === undefined || p.guardName === query.guardName),\n )\n .map((p) => ({ ...p }))\n }\n\n async deletePermission(id: Id): Promise<void> {\n this.permissions = this.permissions.filter((p) => !same(p.id, id))\n this.rolePermissions = this.rolePermissions.filter((l) => !same(l.permissionId, id))\n this.subjectPermissions = this.subjectPermissions.filter((l) => !same(l.targetId, id))\n }\n\n // ---------------------------------------------------------------------- roles\n\n async createRole(data: { name: string; guardName: string; teamId: TeamId }): Promise<Role> {\n const role: Role = { id: this.nextId++, name: data.name, guardName: data.guardName, teamId: data.teamId }\n this.roles.push(role)\n return { ...role }\n }\n\n async findRoles(query: FindRolesQuery = {}): Promise<Role[]> {\n return this.roles\n .filter(\n (r) =>\n (query.ids === undefined || inIds(query.ids, r.id)) &&\n (query.names === undefined || query.names.includes(r.name)) &&\n (query.guardName === undefined || r.guardName === query.guardName) &&\n (query.teamIds === undefined || inIds(query.teamIds, r.teamId)),\n )\n .map((r) => ({ ...r }))\n }\n\n async deleteRole(id: Id): Promise<void> {\n this.roles = this.roles.filter((r) => !same(r.id, id))\n this.rolePermissions = this.rolePermissions.filter((l) => !same(l.roleId, id))\n this.subjectRoles = this.subjectRoles.filter((l) => !same(l.targetId, id))\n }\n\n // ---------------------------------------------------------- role ↔ permission\n\n async getRolePermissionLinks(roleIds: readonly Id[]): Promise<RolePermissionLink[]> {\n return this.rolePermissions.filter((l) => inIds(roleIds, l.roleId)).map((l) => ({ ...l }))\n }\n\n async attachRolePermissions(roleId: Id, permissionIds: readonly Id[]): Promise<void> {\n for (const permissionId of permissionIds) {\n const exists = this.rolePermissions.some((l) => same(l.roleId, roleId) && same(l.permissionId, permissionId))\n if (!exists) this.rolePermissions.push({ roleId, permissionId })\n }\n }\n\n async detachRolePermissions(roleId: Id, permissionIds?: readonly Id[]): Promise<void> {\n this.rolePermissions = this.rolePermissions.filter(\n (l) => !(same(l.roleId, roleId) && (permissionIds === undefined || inIds(permissionIds, l.permissionId))),\n )\n }\n\n // ------------------------------------------------------------- subject links\n\n async getSubjectRoleIds(subject: Subject, teamId: TeamId): Promise<Id[]> {\n return MemoryAdapter.getLinks(this.subjectRoles, subject, teamId)\n }\n\n async attachSubjectRoles(subject: Subject, roleIds: readonly Id[], teamId: TeamId): Promise<void> {\n MemoryAdapter.attach(this.subjectRoles, subject, roleIds, teamId)\n }\n\n async detachSubjectRoles(subject: Subject, roleIds: readonly Id[] | undefined, teamId: TeamId): Promise<void> {\n this.subjectRoles = MemoryAdapter.detach(this.subjectRoles, subject, roleIds, teamId)\n }\n\n async getSubjectPermissionIds(subject: Subject, teamId: TeamId): Promise<Id[]> {\n return MemoryAdapter.getLinks(this.subjectPermissions, subject, teamId)\n }\n\n async attachSubjectPermissions(subject: Subject, permissionIds: readonly Id[], teamId: TeamId): Promise<void> {\n MemoryAdapter.attach(this.subjectPermissions, subject, permissionIds, teamId)\n }\n\n async detachSubjectPermissions(\n subject: Subject,\n permissionIds: readonly Id[] | undefined,\n teamId: TeamId,\n ): Promise<void> {\n this.subjectPermissions = MemoryAdapter.detach(this.subjectPermissions, subject, permissionIds, teamId)\n }\n\n async getSubjectIdsWithRoles(subjectType: string, roleIds: readonly Id[], teamId: TeamId): Promise<Id[]> {\n return MemoryAdapter.reverse(this.subjectRoles, subjectType, roleIds, teamId)\n }\n\n async getSubjectIdsWithPermissions(subjectType: string, permissionIds: readonly Id[], teamId: TeamId): Promise<Id[]> {\n return MemoryAdapter.reverse(this.subjectPermissions, subjectType, permissionIds, teamId)\n }\n\n // -------------------------------------------------------------------- helpers\n\n private static getLinks(links: SubjectLink[], subject: Subject, teamId: TeamId): Id[] {\n return links.filter((l) => isSubject(l, subject) && same(l.teamId, teamId)).map((l) => l.targetId)\n }\n\n private static attach(links: SubjectLink[], subject: Subject, ids: readonly Id[], teamId: TeamId): void {\n for (const targetId of ids) {\n const exists = links.some((l) => isSubject(l, subject) && same(l.targetId, targetId) && same(l.teamId, teamId))\n if (!exists) links.push({ subjectType: subject.type, subjectId: subject.id, targetId, teamId })\n }\n }\n\n private static detach(\n links: SubjectLink[],\n subject: Subject,\n ids: readonly Id[] | undefined,\n teamId: TeamId,\n ): SubjectLink[] {\n return links.filter(\n (l) => !(isSubject(l, subject) && same(l.teamId, teamId) && (ids === undefined || inIds(ids, l.targetId))),\n )\n }\n\n private static reverse(links: SubjectLink[], subjectType: string, ids: readonly Id[], teamId: TeamId): Id[] {\n const seen = new Set<string>()\n const out: Id[] = []\n for (const l of links) {\n if (l.subjectType !== subjectType || !same(l.teamId, teamId) || !inIds(ids, l.targetId)) continue\n const k = key(l.subjectId)\n if (seen.has(k)) continue\n seen.add(k)\n out.push(l.subjectId)\n }\n return out\n }\n}\n","/**\n * @anievo-id/rbac-evolution\n *\n * Framework-agnostic RBAC engine — roles, permissions, guards, wildcards and teams.\n */\n\nexport { createRbac, Rbac, RoleRbac, SubjectRbac } from './rbac'\nexport type { BeforeContext, BeforeHook, GuardOptions, RbacOptions, ScopeOptions } from './rbac'\n\nexport type {\n PermissionAttachedEvent,\n PermissionCreatedEvent,\n PermissionDeletedEvent,\n PermissionDetachedEvent,\n PermissionTarget,\n RbacEvent,\n RbacEventListener,\n RbacEventMap,\n RbacEventName,\n RoleAttachedEvent,\n RoleCreatedEvent,\n RoleDeletedEvent,\n RoleDetachedEvent,\n} from './events'\n\nexport type {\n FindPermissionsQuery,\n FindRolesQuery,\n RbacAdapter,\n RolePermissionLink,\n} from './adapter'\nexport { MemoryAdapter } from './adapters/memory'\n\nexport { MemoryCache } from './cache'\nexport type { CacheStore } from './cache'\n\nexport {\n GuardDoesNotMatch,\n InvalidWildcardPermission,\n PermissionAlreadyExists,\n PermissionDoesNotExist,\n RbacError,\n RoleAlreadyExists,\n RoleDoesNotExist,\n} from './errors'\nexport type { RbacErrorCode } from './errors'\n\nexport { parseWildcardPermission, wildcardImplies } from './wildcard'\n\nexport type {\n DefaultRbacTypes,\n Id,\n Many,\n Permission,\n PermissionInput,\n PermissionName,\n RbacSnapshot,\n RbacTypeConfig,\n Role,\n RoleInput,\n RoleName,\n Subject,\n TeamId,\n} from './types'\n\nexport const VERSION = '0.1.0'\n"]}