@anievo-id/rbac-evolution 0.4.1 → 0.6.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/dist/index.d.cts CHANGED
@@ -511,6 +511,45 @@ declare function parseWildcardPermission(permission: string): string[][];
511
511
  */
512
512
  declare function wildcardImplies(granted: string, required: string): boolean;
513
513
 
514
+ /**
515
+ * Shared requirement logic for the framework integrations (spatie's `permission:`, `role:` and
516
+ * `role_or_permission:` middleware), so every package parses names and checks them the same way.
517
+ */
518
+ /** Which kind of requirement a guard checks. */
519
+ type RequirementKind = 'permission' | 'role' | 'role_or_permission';
520
+ /** A name, a pipe-separated list (`'edit|delete'` = any of), or an array of names. */
521
+ type RequirementNames = string | readonly string[];
522
+ /** A normalized requirement. Every group must pass; a group passes when ANY of its names matches. */
523
+ interface RbacRequirement {
524
+ kind: RequirementKind;
525
+ requirements: string[][];
526
+ }
527
+ interface PermissionRequirementOptions {
528
+ /** Pass when the subject has ANY of the permissions (instead of all). Default: `false`. */
529
+ any?: boolean | undefined;
530
+ }
531
+ interface RoleRequirementOptions {
532
+ /** Require ALL of the roles (instead of any). Default: `false`. */
533
+ all?: boolean | undefined;
534
+ }
535
+ /** Default 403 messages, per kind (same wording as spatie). */
536
+ declare const REQUIREMENT_MESSAGES: Readonly<Record<RequirementKind, string>>;
537
+ /** Default 401 message. */
538
+ declare const UNAUTHENTICATED_MESSAGE = "User is not logged in.";
539
+ /** Splits `(...names, options?)` guard arguments: a trailing plain object is the options. */
540
+ declare function splitRequirementArgs<O extends object>(args: readonly (RequirementNames | O)[]): {
541
+ names: RequirementNames[];
542
+ options: O | undefined;
543
+ };
544
+ /** `'a', 'b'` = all; `'a|b'` = any; `{ any: true }` = any of everything. Throws `TypeError` without names. */
545
+ declare function permissionRequirement(names: readonly RequirementNames[], options?: PermissionRequirementOptions): RbacRequirement;
546
+ /** Any of the roles by default; `{ all: true }` = all of them. Throws `TypeError` without names. */
547
+ declare function roleRequirement(names: readonly RequirementNames[], options?: RoleRequirementOptions): RbacRequirement;
548
+ /** Any of the names, as a role OR as a permission. Throws `TypeError` without names. */
549
+ declare function roleOrPermissionRequirement(names: readonly RequirementNames[]): RbacRequirement;
550
+ /** `true` when every group of the requirement passes for the subject. */
551
+ declare function satisfiesRequirement(rbac: SubjectRbac, requirement: RbacRequirement): Promise<boolean>;
552
+
514
553
  /**
515
554
  * @anievo-id/rbac-evolution
516
555
  *
@@ -520,4 +559,4 @@ declare function wildcardImplies(granted: string, required: string): boolean;
520
559
  /** Version of this package (read from package.json at build time). */
521
560
  declare const VERSION: string;
522
561
 
523
- export { type BeforeContext, type BeforeHook, type CacheStore, DefaultRbacTypes, FindPermissionsQuery, FindRolesQuery, GuardDoesNotMatch, type GuardOptions, Id, InvalidWildcardPermission, Many, MemoryAdapter, MemoryCache, type MemoryCacheOptions, 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, type SyncDefinition, type SyncOptions, type SyncPermissionChange, type SyncResult, type SyncRoleChange, type SyncRolePermissions, type SyncRoleUpdate, TeamId, VERSION, createRbac, parseWildcardPermission, wildcardImplies };
562
+ export { type BeforeContext, type BeforeHook, type CacheStore, DefaultRbacTypes, FindPermissionsQuery, FindRolesQuery, GuardDoesNotMatch, type GuardOptions, Id, InvalidWildcardPermission, Many, MemoryAdapter, MemoryCache, type MemoryCacheOptions, Permission, PermissionAlreadyExists, type PermissionAttachedEvent, type PermissionCreatedEvent, type PermissionDeletedEvent, type PermissionDetachedEvent, PermissionDoesNotExist, PermissionInput, PermissionName, type PermissionRequirementOptions, type PermissionTarget, REQUIREMENT_MESSAGES, Rbac, RbacAdapter, RbacError, type RbacErrorCode, type RbacEvent, type RbacEventListener, type RbacEventMap, type RbacEventName, type RbacOptions, type RbacRequirement, RbacSnapshot, RbacTypeConfig, type RequirementKind, type RequirementNames, Role, RoleAlreadyExists, type RoleAttachedEvent, type RoleCreatedEvent, type RoleDeletedEvent, type RoleDetachedEvent, RoleDoesNotExist, RoleInput, RoleName, RolePermissionLink, RoleRbac, type RoleRequirementOptions, type ScopeOptions, Subject, SubjectRbac, type SyncDefinition, type SyncOptions, type SyncPermissionChange, type SyncResult, type SyncRoleChange, type SyncRolePermissions, type SyncRoleUpdate, TeamId, UNAUTHENTICATED_MESSAGE, VERSION, createRbac, parseWildcardPermission, permissionRequirement, roleOrPermissionRequirement, roleRequirement, satisfiesRequirement, splitRequirementArgs, wildcardImplies };
package/dist/index.d.ts CHANGED
@@ -511,6 +511,45 @@ declare function parseWildcardPermission(permission: string): string[][];
511
511
  */
512
512
  declare function wildcardImplies(granted: string, required: string): boolean;
513
513
 
514
+ /**
515
+ * Shared requirement logic for the framework integrations (spatie's `permission:`, `role:` and
516
+ * `role_or_permission:` middleware), so every package parses names and checks them the same way.
517
+ */
518
+ /** Which kind of requirement a guard checks. */
519
+ type RequirementKind = 'permission' | 'role' | 'role_or_permission';
520
+ /** A name, a pipe-separated list (`'edit|delete'` = any of), or an array of names. */
521
+ type RequirementNames = string | readonly string[];
522
+ /** A normalized requirement. Every group must pass; a group passes when ANY of its names matches. */
523
+ interface RbacRequirement {
524
+ kind: RequirementKind;
525
+ requirements: string[][];
526
+ }
527
+ interface PermissionRequirementOptions {
528
+ /** Pass when the subject has ANY of the permissions (instead of all). Default: `false`. */
529
+ any?: boolean | undefined;
530
+ }
531
+ interface RoleRequirementOptions {
532
+ /** Require ALL of the roles (instead of any). Default: `false`. */
533
+ all?: boolean | undefined;
534
+ }
535
+ /** Default 403 messages, per kind (same wording as spatie). */
536
+ declare const REQUIREMENT_MESSAGES: Readonly<Record<RequirementKind, string>>;
537
+ /** Default 401 message. */
538
+ declare const UNAUTHENTICATED_MESSAGE = "User is not logged in.";
539
+ /** Splits `(...names, options?)` guard arguments: a trailing plain object is the options. */
540
+ declare function splitRequirementArgs<O extends object>(args: readonly (RequirementNames | O)[]): {
541
+ names: RequirementNames[];
542
+ options: O | undefined;
543
+ };
544
+ /** `'a', 'b'` = all; `'a|b'` = any; `{ any: true }` = any of everything. Throws `TypeError` without names. */
545
+ declare function permissionRequirement(names: readonly RequirementNames[], options?: PermissionRequirementOptions): RbacRequirement;
546
+ /** Any of the roles by default; `{ all: true }` = all of them. Throws `TypeError` without names. */
547
+ declare function roleRequirement(names: readonly RequirementNames[], options?: RoleRequirementOptions): RbacRequirement;
548
+ /** Any of the names, as a role OR as a permission. Throws `TypeError` without names. */
549
+ declare function roleOrPermissionRequirement(names: readonly RequirementNames[]): RbacRequirement;
550
+ /** `true` when every group of the requirement passes for the subject. */
551
+ declare function satisfiesRequirement(rbac: SubjectRbac, requirement: RbacRequirement): Promise<boolean>;
552
+
514
553
  /**
515
554
  * @anievo-id/rbac-evolution
516
555
  *
@@ -520,4 +559,4 @@ declare function wildcardImplies(granted: string, required: string): boolean;
520
559
  /** Version of this package (read from package.json at build time). */
521
560
  declare const VERSION: string;
522
561
 
523
- export { type BeforeContext, type BeforeHook, type CacheStore, DefaultRbacTypes, FindPermissionsQuery, FindRolesQuery, GuardDoesNotMatch, type GuardOptions, Id, InvalidWildcardPermission, Many, MemoryAdapter, MemoryCache, type MemoryCacheOptions, 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, type SyncDefinition, type SyncOptions, type SyncPermissionChange, type SyncResult, type SyncRoleChange, type SyncRolePermissions, type SyncRoleUpdate, TeamId, VERSION, createRbac, parseWildcardPermission, wildcardImplies };
562
+ export { type BeforeContext, type BeforeHook, type CacheStore, DefaultRbacTypes, FindPermissionsQuery, FindRolesQuery, GuardDoesNotMatch, type GuardOptions, Id, InvalidWildcardPermission, Many, MemoryAdapter, MemoryCache, type MemoryCacheOptions, Permission, PermissionAlreadyExists, type PermissionAttachedEvent, type PermissionCreatedEvent, type PermissionDeletedEvent, type PermissionDetachedEvent, PermissionDoesNotExist, PermissionInput, PermissionName, type PermissionRequirementOptions, type PermissionTarget, REQUIREMENT_MESSAGES, Rbac, RbacAdapter, RbacError, type RbacErrorCode, type RbacEvent, type RbacEventListener, type RbacEventMap, type RbacEventName, type RbacOptions, type RbacRequirement, RbacSnapshot, RbacTypeConfig, type RequirementKind, type RequirementNames, Role, RoleAlreadyExists, type RoleAttachedEvent, type RoleCreatedEvent, type RoleDeletedEvent, type RoleDetachedEvent, RoleDoesNotExist, RoleInput, RoleName, RolePermissionLink, RoleRbac, type RoleRequirementOptions, type ScopeOptions, Subject, SubjectRbac, type SyncDefinition, type SyncOptions, type SyncPermissionChange, type SyncResult, type SyncRoleChange, type SyncRolePermissions, type SyncRoleUpdate, TeamId, UNAUTHENTICATED_MESSAGE, VERSION, createRbac, parseWildcardPermission, permissionRequirement, roleOrPermissionRequirement, roleRequirement, satisfiesRequirement, splitRequirementArgs, wildcardImplies };
package/dist/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  export { GuardDoesNotMatch, InvalidWildcardPermission, MemoryCache, PermissionAlreadyExists, PermissionDoesNotExist, Rbac, RbacError, RoleAlreadyExists, RoleDoesNotExist, RoleRbac, SubjectRbac, createRbac, parseWildcardPermission, wildcardImplies } from './chunk-7KKIVES7.js';
2
2
 
3
3
  // package.json
4
- var version = "0.4.1";
4
+ var version = "0.6.0";
5
5
 
6
6
  // src/adapters/memory.ts
7
7
  var key = (id) => id === null ? "\0null" : String(id);
@@ -116,9 +116,70 @@ var MemoryAdapter = class _MemoryAdapter {
116
116
  }
117
117
  };
118
118
 
119
+ // src/requirements.ts
120
+ var REQUIREMENT_MESSAGES = {
121
+ permission: "User does not have the right permissions.",
122
+ role: "User does not have the right roles.",
123
+ role_or_permission: "User does not have any of the necessary access rights."
124
+ };
125
+ var UNAUTHENTICATED_MESSAGE = "User is not logged in.";
126
+ var split = (name) => name.split("|").map((n) => n.trim()).filter((n) => n !== "");
127
+ function toGroups(names) {
128
+ const groups = [];
129
+ for (const name of names) {
130
+ for (const item of typeof name === "string" ? [name] : name) {
131
+ const group = split(item);
132
+ if (group.length > 0) groups.push(group);
133
+ }
134
+ }
135
+ return groups;
136
+ }
137
+ function ensure(requirement) {
138
+ const { requirements } = requirement;
139
+ if (requirements.length === 0 || requirements.some((group) => group.length === 0)) {
140
+ throw new TypeError(`[rbac-evolution] A ${requirement.kind} requirement needs at least one name.`);
141
+ }
142
+ return requirement;
143
+ }
144
+ function splitRequirementArgs(args) {
145
+ const last = args[args.length - 1];
146
+ if (last !== void 0 && typeof last === "object" && !Array.isArray(last)) {
147
+ return { names: args.slice(0, -1), options: last };
148
+ }
149
+ return { names: args, options: void 0 };
150
+ }
151
+ function permissionRequirement(names, options = {}) {
152
+ const groups = toGroups(names);
153
+ return ensure({ kind: "permission", requirements: options.any ? [groups.flat()] : groups });
154
+ }
155
+ function roleRequirement(names, options = {}) {
156
+ const all = toGroups(names).flat();
157
+ return ensure({ kind: "role", requirements: options.all ? all.map((r) => [r]) : [all] });
158
+ }
159
+ function roleOrPermissionRequirement(names) {
160
+ return ensure({ kind: "role_or_permission", requirements: [toGroups(names).flat()] });
161
+ }
162
+ async function satisfiesRequirement(rbac, requirement) {
163
+ for (const group of requirement.requirements) {
164
+ let pass;
165
+ switch (requirement.kind) {
166
+ case "permission":
167
+ pass = await rbac.canAny(group);
168
+ break;
169
+ case "role":
170
+ pass = await rbac.hasAnyRole(group);
171
+ break;
172
+ default:
173
+ pass = await rbac.hasAnyRole(group) || await rbac.canAny(group);
174
+ }
175
+ if (!pass) return false;
176
+ }
177
+ return true;
178
+ }
179
+
119
180
  // src/index.ts
120
181
  var VERSION = version;
121
182
 
122
- export { MemoryAdapter, VERSION };
183
+ export { MemoryAdapter, REQUIREMENT_MESSAGES, UNAUTHENTICATED_MESSAGE, VERSION, permissionRequirement, roleOrPermissionRequirement, roleRequirement, satisfiesRequirement, splitRequirementArgs };
123
184
  //# sourceMappingURL=index.js.map
124
185
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../package.json","../src/adapters/memory.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["{\n \"name\": \"@anievo-id/rbac-evolution\",\n \"version\": \"0.4.1\",\n \"description\": \"Framework-agnostic RBAC engine for rbac-evolution — roles, permissions, guards.\",\n \"license\": \"MIT\",\n \"author\": \"AniEvo-ID (https://github.com/AniEvo-ID)\",\n \"homepage\": \"https://github.com/AniEvo-ID/rbac-evolution/tree/main/packages/core#readme\",\n \"bugs\": {\n \"url\": \"https://github.com/AniEvo-ID/rbac-evolution/issues\"\n },\n \"type\": \"module\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/AniEvo-ID/rbac-evolution.git\",\n \"directory\": \"packages/core\"\n },\n \"keywords\": [\n \"rbac\",\n \"permissions\",\n \"roles\",\n \"authorization\",\n \"acl\",\n \"typescript\"\n ],\n \"sideEffects\": false,\n \"main\": \"./dist/index.cjs\",\n \"module\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": {\n \"types\": \"./dist/index.d.ts\",\n \"default\": \"./dist/index.js\"\n },\n \"require\": {\n \"types\": \"./dist/index.d.cts\",\n \"default\": \"./dist/index.cjs\"\n }\n },\n \"./testing\": {\n \"import\": {\n \"types\": \"./dist/testing.d.ts\",\n \"default\": \"./dist/testing.js\"\n },\n \"require\": {\n \"types\": \"./dist/testing.d.cts\",\n \"default\": \"./dist/testing.cjs\"\n }\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\n \"dist\"\n ],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"scripts\": {\n \"build\": \"tsup\",\n \"dev\": \"tsup --watch\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run --passWithNoTests\",\n \"clean\": \"rm -rf dist .turbo\"\n },\n \"devDependencies\": {\n \"tsup\": \"^8.3.0\",\n \"typescript\": \"^5.7.0\",\n \"vitest\": \"^2.1.0\"\n },\n \"peerDependencies\": {\n \"vitest\": \">=2\"\n },\n \"peerDependenciesMeta\": {\n \"vitest\": {\n \"optional\": true\n }\n },\n \"engines\": {\n \"node\": \">=20\"\n }\n}\n","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\nimport { version } from '../package.json'\n\nexport { createRbac, Rbac, RoleRbac, SubjectRbac } from './rbac'\nexport type { BeforeContext, BeforeHook, GuardOptions, RbacOptions, ScopeOptions } from './rbac'\nexport type {\n SyncDefinition,\n SyncOptions,\n SyncPermissionChange,\n SyncResult,\n SyncRoleChange,\n SyncRolePermissions,\n SyncRoleUpdate,\n} from './sync'\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, type MemoryCacheOptions } 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\n/** Version of this package (read from package.json at build time). */\nexport const VERSION: string = version\n"]}
1
+ {"version":3,"sources":["../package.json","../src/adapters/memory.ts","../src/requirements.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["{\n \"name\": \"@anievo-id/rbac-evolution\",\n \"version\": \"0.6.0\",\n \"description\": \"Framework-agnostic RBAC engine for rbac-evolution — roles, permissions, guards.\",\n \"license\": \"MIT\",\n \"author\": \"AniEvo-ID (https://github.com/AniEvo-ID)\",\n \"homepage\": \"https://github.com/AniEvo-ID/rbac-evolution/tree/main/packages/core#readme\",\n \"bugs\": {\n \"url\": \"https://github.com/AniEvo-ID/rbac-evolution/issues\"\n },\n \"type\": \"module\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/AniEvo-ID/rbac-evolution.git\",\n \"directory\": \"packages/core\"\n },\n \"keywords\": [\n \"rbac\",\n \"permissions\",\n \"roles\",\n \"authorization\",\n \"acl\",\n \"typescript\"\n ],\n \"sideEffects\": false,\n \"main\": \"./dist/index.cjs\",\n \"module\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": {\n \"types\": \"./dist/index.d.ts\",\n \"default\": \"./dist/index.js\"\n },\n \"require\": {\n \"types\": \"./dist/index.d.cts\",\n \"default\": \"./dist/index.cjs\"\n }\n },\n \"./testing\": {\n \"import\": {\n \"types\": \"./dist/testing.d.ts\",\n \"default\": \"./dist/testing.js\"\n },\n \"require\": {\n \"types\": \"./dist/testing.d.cts\",\n \"default\": \"./dist/testing.cjs\"\n }\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\n \"dist\"\n ],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"scripts\": {\n \"build\": \"tsup\",\n \"dev\": \"tsup --watch\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run --passWithNoTests\",\n \"clean\": \"rm -rf dist .turbo\"\n },\n \"devDependencies\": {\n \"tsup\": \"^8.3.0\",\n \"typescript\": \"^5.7.0\",\n \"vitest\": \"^2.1.0\"\n },\n \"peerDependencies\": {\n \"vitest\": \">=2\"\n },\n \"peerDependenciesMeta\": {\n \"vitest\": {\n \"optional\": true\n }\n },\n \"engines\": {\n \"node\": \">=20\"\n }\n}\n","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","import type { SubjectRbac } from './rbac'\n\n/**\n * Shared requirement logic for the framework integrations (spatie's `permission:`, `role:` and\n * `role_or_permission:` middleware), so every package parses names and checks them the same way.\n */\n\n/** Which kind of requirement a guard checks. */\nexport type RequirementKind = 'permission' | 'role' | 'role_or_permission'\n\n/** A name, a pipe-separated list (`'edit|delete'` = any of), or an array of names. */\nexport type RequirementNames = string | readonly string[]\n\n/** A normalized requirement. Every group must pass; a group passes when ANY of its names matches. */\nexport interface RbacRequirement {\n kind: RequirementKind\n requirements: string[][]\n}\n\nexport interface PermissionRequirementOptions {\n /** Pass when the subject has ANY of the permissions (instead of all). Default: `false`. */\n any?: boolean | undefined\n}\n\nexport interface RoleRequirementOptions {\n /** Require ALL of the roles (instead of any). Default: `false`. */\n all?: boolean | undefined\n}\n\n/** Default 403 messages, per kind (same wording as spatie). */\nexport const REQUIREMENT_MESSAGES: Readonly<Record<RequirementKind, string>> = {\n permission: 'User does not have the right permissions.',\n role: 'User does not have the right roles.',\n role_or_permission: 'User does not have any of the necessary access rights.',\n}\n\n/** Default 401 message. */\nexport const UNAUTHENTICATED_MESSAGE = 'User is not logged in.'\n\nconst split = (name: string): string[] =>\n name\n .split('|')\n .map((n) => n.trim())\n .filter((n) => n !== '')\n\n/** Each argument is a group (pipes = any within the group); arrays contribute one group per item. */\nfunction toGroups(names: readonly RequirementNames[]): string[][] {\n const groups: string[][] = []\n for (const name of names) {\n for (const item of typeof name === 'string' ? [name] : name) {\n const group = split(item)\n if (group.length > 0) groups.push(group)\n }\n }\n return groups\n}\n\nfunction ensure(requirement: RbacRequirement): RbacRequirement {\n const { requirements } = requirement\n if (requirements.length === 0 || requirements.some((group) => group.length === 0)) {\n throw new TypeError(`[rbac-evolution] A ${requirement.kind} requirement needs at least one name.`)\n }\n return requirement\n}\n\n/** Splits `(...names, options?)` guard arguments: a trailing plain object is the options. */\nexport function splitRequirementArgs<O extends object>(\n args: readonly (RequirementNames | O)[],\n): { names: RequirementNames[]; options: O | undefined } {\n const last = args[args.length - 1]\n if (last !== undefined && typeof last === 'object' && !Array.isArray(last)) {\n return { names: args.slice(0, -1) as RequirementNames[], options: last as O }\n }\n return { names: args as RequirementNames[], options: undefined }\n}\n\n/** `'a', 'b'` = all; `'a|b'` = any; `{ any: true }` = any of everything. Throws `TypeError` without names. */\nexport function permissionRequirement(\n names: readonly RequirementNames[],\n options: PermissionRequirementOptions = {},\n): RbacRequirement {\n const groups = toGroups(names)\n return ensure({ kind: 'permission', requirements: options.any ? [groups.flat()] : groups })\n}\n\n/** Any of the roles by default; `{ all: true }` = all of them. Throws `TypeError` without names. */\nexport function roleRequirement(names: readonly RequirementNames[], options: RoleRequirementOptions = {}): RbacRequirement {\n const all = toGroups(names).flat()\n return ensure({ kind: 'role', requirements: options.all ? all.map((r) => [r]) : [all] })\n}\n\n/** Any of the names, as a role OR as a permission. Throws `TypeError` without names. */\nexport function roleOrPermissionRequirement(names: readonly RequirementNames[]): RbacRequirement {\n return ensure({ kind: 'role_or_permission', requirements: [toGroups(names).flat()] })\n}\n\n/** `true` when every group of the requirement passes for the subject. */\nexport async function satisfiesRequirement(rbac: SubjectRbac, requirement: RbacRequirement): Promise<boolean> {\n for (const group of requirement.requirements) {\n let pass: boolean\n switch (requirement.kind) {\n case 'permission':\n pass = await rbac.canAny(group)\n break\n case 'role':\n pass = await rbac.hasAnyRole(group)\n break\n default:\n pass = (await rbac.hasAnyRole(group)) || (await rbac.canAny(group))\n }\n if (!pass) return false\n }\n return true\n}\n","/**\n * @anievo-id/rbac-evolution\n *\n * Framework-agnostic RBAC engine — roles, permissions, guards, wildcards and teams.\n */\n\nimport { version } from '../package.json'\n\nexport { createRbac, Rbac, RoleRbac, SubjectRbac } from './rbac'\nexport type { BeforeContext, BeforeHook, GuardOptions, RbacOptions, ScopeOptions } from './rbac'\nexport type {\n SyncDefinition,\n SyncOptions,\n SyncPermissionChange,\n SyncResult,\n SyncRoleChange,\n SyncRolePermissions,\n SyncRoleUpdate,\n} from './sync'\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, type MemoryCacheOptions } 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 {\n permissionRequirement,\n REQUIREMENT_MESSAGES,\n roleOrPermissionRequirement,\n roleRequirement,\n satisfiesRequirement,\n splitRequirementArgs,\n UNAUTHENTICATED_MESSAGE,\n} from './requirements'\nexport type {\n PermissionRequirementOptions,\n RbacRequirement,\n RequirementKind,\n RequirementNames,\n RoleRequirementOptions,\n} from './requirements'\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\n/** Version of this package (read from package.json at build time). */\nexport const VERSION: string = version\n"]}
package/dist/testing.cjs CHANGED
@@ -980,6 +980,7 @@ function runAdapterTests(name, factory, options = {}) {
980
980
  let adapter;
981
981
  const alice = { type: "user", id: 1 };
982
982
  const bob = { type: "user", id: 2 };
983
+ const carol = { type: "user", id: 3 };
983
984
  const robot = { type: "client", id: 1 };
984
985
  vitest.beforeEach(async () => {
985
986
  adapter = await factory();
@@ -1134,6 +1135,23 @@ function runAdapterTests(name, factory, options = {}) {
1134
1135
  vitest.expect(await adapter.getSubjectIdsWithRoles("user", [], null)).toHaveLength(0);
1135
1136
  vitest.expect(s(await adapter.getSubjectIdsWithPermissions("user", [p.id], null))).toEqual(["2"]);
1136
1137
  });
1138
+ if (teams) {
1139
+ vitest.it("only finds subjects linked in the given team", async () => {
1140
+ const r = await adapter.createRole({ name: "r", guardName: "web", teamId: null });
1141
+ const p = await adapter.createPermission({ name: "p", guardName: "web" });
1142
+ await adapter.attachSubjectRoles(alice, [r.id], 1);
1143
+ await adapter.attachSubjectRoles(bob, [r.id], 2);
1144
+ await adapter.attachSubjectRoles(carol, [r.id], null);
1145
+ await adapter.attachSubjectPermissions(alice, [p.id], 1);
1146
+ await adapter.attachSubjectPermissions(bob, [p.id], null);
1147
+ vitest.expect(s(await adapter.getSubjectIdsWithRoles("user", [r.id], 1))).toEqual(["1"]);
1148
+ vitest.expect(s(await adapter.getSubjectIdsWithRoles("user", [r.id], 2))).toEqual(["2"]);
1149
+ vitest.expect(s(await adapter.getSubjectIdsWithRoles("user", [r.id], null))).toEqual(["3"]);
1150
+ vitest.expect(s(await adapter.getSubjectIdsWithPermissions("user", [p.id], 1))).toEqual(["1"]);
1151
+ vitest.expect(s(await adapter.getSubjectIdsWithPermissions("user", [p.id], null))).toEqual(["2"]);
1152
+ vitest.expect(await adapter.getSubjectIdsWithPermissions("user", [p.id], 3)).toHaveLength(0);
1153
+ });
1154
+ }
1137
1155
  });
1138
1156
  vitest.describe("engine integration", () => {
1139
1157
  vitest.it("runs a full flow through createRbac", async () => {