@anievo-id/rbac-evolution 0.8.0 → 1.0.0-rc.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
@@ -259,6 +259,8 @@ declare class Rbac<T extends RbacTypeConfig = DefaultRbacTypes> {
259
259
  createPermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
260
260
  findPermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission | null>;
261
261
  findPermissionOrFail(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
262
+ /** Finds a permission by id in the guard (spatie: `Permission::findById($id, $guard)`), or `null`. */
263
+ findPermissionById(id: Id, options?: GuardOptions): Promise<Permission | null>;
262
264
  findOrCreatePermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
263
265
  getPermissions(options?: GuardOptions): Promise<Permission[]>;
264
266
  deletePermission(permission: PermissionInput<PermissionName<T>>, options?: GuardOptions): Promise<void>;
@@ -266,6 +268,13 @@ declare class Rbac<T extends RbacTypeConfig = DefaultRbacTypes> {
266
268
  /** Finds a role. With a team, a team-specific role wins over a global role of the same name. */
267
269
  findRole(name: RoleName<T>, options?: ScopeOptions): Promise<Role | null>;
268
270
  findRoleOrFail(name: RoleName<T>, options?: ScopeOptions): Promise<Role>;
271
+ /** Finds a role by id in the guard (spatie: `Role::findById($id, $guard)`), or `null`. */
272
+ findRoleById(id: Id, options?: GuardOptions): Promise<Role | null>;
273
+ /**
274
+ * Roles in the given scope that grant the permission directly (spatie: `$permission->roles`).
275
+ * Throws `PermissionDoesNotExist` for an unknown permission. Wildcard grants are not expanded.
276
+ */
277
+ rolesWithPermission(permission: PermissionInput<PermissionName<T>>, options?: ScopeOptions): Promise<Role[]>;
269
278
  findOrCreateRole(name: RoleName<T>, options?: ScopeOptions): Promise<Role>;
270
279
  /** Lists roles visible in the given scope (global roles + roles of the given team). */
271
280
  getRoles(options?: ScopeOptions): Promise<Role[]>;
@@ -339,6 +348,15 @@ declare class SubjectRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
339
348
  readonly guardName: string;
340
349
  readonly teamId: TeamId;
341
350
  constructor(rbac: Rbac<T>, subject: Subject, guardName: string, teamId: TeamId);
351
+ /**
352
+ * The same subject in another guard and/or team; options left out keep the current ones (spatie passes the
353
+ * guard to each check: `$user->hasRole('admin', 'api')`).
354
+ *
355
+ * ```ts
356
+ * await rbac.for(user).withScope({ guard: 'api' }).hasRole('admin')
357
+ * ```
358
+ */
359
+ withScope(options: ScopeOptions): SubjectRbac<T>;
342
360
  assignRole(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<this>;
343
361
  removeRole(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<this>;
344
362
  /** Replaces all roles (in the current guard & team) with the given ones. */
@@ -368,6 +386,15 @@ declare class SubjectRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
368
386
  hasPermissionTo(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
369
387
  /** Checks a direct permission only (ignores roles). */
370
388
  hasDirectPermission(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
389
+ /** `true` if the subject has ANY of the permissions directly (ignores roles). Never throws. */
390
+ hasAnyDirectPermission(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
391
+ /** `true` if the subject has ALL the permissions directly (ignores roles). Never throws. */
392
+ hasAllDirectPermissions(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
393
+ /**
394
+ * {@link hasPermissionTo} that returns `false` instead of throwing for an unknown permission or another guard
395
+ * (spatie: `checkPermissionTo`). Pure data check: no `before` hook or super-admin.
396
+ */
397
+ checkPermissionTo(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
371
398
  /**
372
399
  * Authorization check: runs the `before` hook and `superAdminRoles` first, then falls back
373
400
  * to {@link hasPermissionTo}, returning `false` instead of throwing.
@@ -384,6 +411,8 @@ declare class SubjectRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
384
411
  snapshot(): Promise<RbacSnapshot>;
385
412
  /** {@link hasPermissionTo} that returns `false` instead of throwing. */
386
413
  private check;
414
+ /** {@link hasDirectPermission} that returns `false` instead of throwing. */
415
+ private checkDirect;
387
416
  private requirePermissionName;
388
417
  private state;
389
418
  private emitRoles;
package/dist/index.d.ts CHANGED
@@ -259,6 +259,8 @@ declare class Rbac<T extends RbacTypeConfig = DefaultRbacTypes> {
259
259
  createPermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
260
260
  findPermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission | null>;
261
261
  findPermissionOrFail(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
262
+ /** Finds a permission by id in the guard (spatie: `Permission::findById($id, $guard)`), or `null`. */
263
+ findPermissionById(id: Id, options?: GuardOptions): Promise<Permission | null>;
262
264
  findOrCreatePermission(name: PermissionName<T>, options?: GuardOptions): Promise<Permission>;
263
265
  getPermissions(options?: GuardOptions): Promise<Permission[]>;
264
266
  deletePermission(permission: PermissionInput<PermissionName<T>>, options?: GuardOptions): Promise<void>;
@@ -266,6 +268,13 @@ declare class Rbac<T extends RbacTypeConfig = DefaultRbacTypes> {
266
268
  /** Finds a role. With a team, a team-specific role wins over a global role of the same name. */
267
269
  findRole(name: RoleName<T>, options?: ScopeOptions): Promise<Role | null>;
268
270
  findRoleOrFail(name: RoleName<T>, options?: ScopeOptions): Promise<Role>;
271
+ /** Finds a role by id in the guard (spatie: `Role::findById($id, $guard)`), or `null`. */
272
+ findRoleById(id: Id, options?: GuardOptions): Promise<Role | null>;
273
+ /**
274
+ * Roles in the given scope that grant the permission directly (spatie: `$permission->roles`).
275
+ * Throws `PermissionDoesNotExist` for an unknown permission. Wildcard grants are not expanded.
276
+ */
277
+ rolesWithPermission(permission: PermissionInput<PermissionName<T>>, options?: ScopeOptions): Promise<Role[]>;
269
278
  findOrCreateRole(name: RoleName<T>, options?: ScopeOptions): Promise<Role>;
270
279
  /** Lists roles visible in the given scope (global roles + roles of the given team). */
271
280
  getRoles(options?: ScopeOptions): Promise<Role[]>;
@@ -339,6 +348,15 @@ declare class SubjectRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
339
348
  readonly guardName: string;
340
349
  readonly teamId: TeamId;
341
350
  constructor(rbac: Rbac<T>, subject: Subject, guardName: string, teamId: TeamId);
351
+ /**
352
+ * The same subject in another guard and/or team; options left out keep the current ones (spatie passes the
353
+ * guard to each check: `$user->hasRole('admin', 'api')`).
354
+ *
355
+ * ```ts
356
+ * await rbac.for(user).withScope({ guard: 'api' }).hasRole('admin')
357
+ * ```
358
+ */
359
+ withScope(options: ScopeOptions): SubjectRbac<T>;
342
360
  assignRole(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<this>;
343
361
  removeRole(...roles: Many<RoleInput<RoleName<T>>>[]): Promise<this>;
344
362
  /** Replaces all roles (in the current guard & team) with the given ones. */
@@ -368,6 +386,15 @@ declare class SubjectRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
368
386
  hasPermissionTo(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
369
387
  /** Checks a direct permission only (ignores roles). */
370
388
  hasDirectPermission(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
389
+ /** `true` if the subject has ANY of the permissions directly (ignores roles). Never throws. */
390
+ hasAnyDirectPermission(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
391
+ /** `true` if the subject has ALL the permissions directly (ignores roles). Never throws. */
392
+ hasAllDirectPermissions(...permissions: Many<PermissionInput<PermissionName<T>>>[]): Promise<boolean>;
393
+ /**
394
+ * {@link hasPermissionTo} that returns `false` instead of throwing for an unknown permission or another guard
395
+ * (spatie: `checkPermissionTo`). Pure data check: no `before` hook or super-admin.
396
+ */
397
+ checkPermissionTo(permission: PermissionInput<PermissionName<T>>): Promise<boolean>;
371
398
  /**
372
399
  * Authorization check: runs the `before` hook and `superAdminRoles` first, then falls back
373
400
  * to {@link hasPermissionTo}, returning `false` instead of throwing.
@@ -384,6 +411,8 @@ declare class SubjectRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
384
411
  snapshot(): Promise<RbacSnapshot>;
385
412
  /** {@link hasPermissionTo} that returns `false` instead of throwing. */
386
413
  private check;
414
+ /** {@link hasDirectPermission} that returns `false` instead of throwing. */
415
+ private checkDirect;
387
416
  private requirePermissionName;
388
417
  private state;
389
418
  private emitRoles;
package/dist/index.js CHANGED
@@ -1,7 +1,7 @@
1
- export { GuardDoesNotMatch, InvalidWildcardPermission, MemoryCache, PermissionAlreadyExists, PermissionDoesNotExist, Rbac, RbacError, RoleAlreadyExists, RoleDoesNotExist, RoleRbac, SubjectRbac, createRbac, parseWildcardPermission, wildcardImplies } from './chunk-4IVKUA7F.js';
1
+ export { GuardDoesNotMatch, InvalidWildcardPermission, MemoryCache, PermissionAlreadyExists, PermissionDoesNotExist, Rbac, RbacError, RoleAlreadyExists, RoleDoesNotExist, RoleRbac, SubjectRbac, createRbac, parseWildcardPermission, wildcardImplies } from './chunk-TYHFU62A.js';
2
2
 
3
3
  // package.json
4
- var version = "0.8.0";
4
+ var version = "1.0.0-rc.0";
5
5
 
6
6
  // src/adapters/memory.ts
7
7
  var key = (id) => id === null ? "\0null" : String(id);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
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.8.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://creation.anievo.id/rbac-evolution/guide/introduction\",\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 \"fast-check\": \"^4.10.2\",\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// ---------------------------------------------------------------------------- typed guard arguments\n//\n// Types for integrations whose guards take `(...names, options?)`, like `requirePermission('a|b', 'c', { any: true })`.\n// With typed names (see `RbacTypeConfig`), every name, including each part of a pipe list, must be one of `N`.\n// Without them (`N` is `string`), any name is accepted. In both cases a call with no names, or with options\n// before the last argument, is a type error, because it would throw (or ignore the options) at runtime.\n\ntype TrimSpaces<S extends string> = S extends ` ${infer R}` ? TrimSpaces<R> : S extends `${infer L} ` ? TrimSpaces<L> : S\n\n/** The first `|`-separated part of `S` that is not in `N`, or `never` when every part is. */\ntype UnknownPart<S extends string, N extends string> = S extends `${infer A}|${infer B}`\n ? TrimSpaces<A> extends N\n ? UnknownPart<B, N>\n : TrimSpaces<A>\n : TrimSpaces<S> extends N\n ? never\n : TrimSpaces<S>\n\n/** Shown in the type error when a name is not one of the typed names. */\nexport interface UnknownRequirementName<S extends string> {\n 'rbac-evolution: unknown name': S\n}\n\n/** Shown in the type error when an options object is not the last argument. */\nexport interface OptionsMustBeLast {\n 'rbac-evolution: options must be the last argument': true\n}\n\n/** Shown in the type error when a guard gets no names. */\nexport interface NamesRequired {\n 'rbac-evolution: at least one name is required': true\n}\n\n/** `S` when every part of the pipe list `S` is in `N` (always, for plain `string` names), else an error type. */\nexport type CheckRequirementName<S extends string, N extends string> = string extends N\n ? S\n : string extends S\n ? S\n : [UnknownPart<S, N>] extends [never]\n ? S\n : S & UnknownRequirementName<UnknownPart<S, N>>\n\ntype CheckNames<X, N extends string> = X extends string\n ? CheckRequirementName<X, N>\n : X extends readonly string[]\n ? { [K in keyof X]: X[K] extends string ? CheckRequirementName<X[K], N> : X[K] }\n : OptionsMustBeLast\n\n/**\n * Validates a guard's `(...names, options?)` arguments `A` against the names `N` and the options type `O`.\n * Use it as `fn<const A extends readonly (RequirementNames | O)[]>(...args: A & RequirementArgs<A, N, O>)`.\n * Arguments that are not a fixed tuple (a spread `string[]`) are not checked.\n */\nexport type RequirementArgs<A extends readonly unknown[], N extends string, O> = number extends A['length']\n ? A\n : A extends readonly []\n ? [names: NamesRequired]\n : A extends readonly [...infer Init, infer Last]\n ? Last extends RequirementNames\n ? { [K in keyof A]: CheckNames<A[K], N> }\n : Init extends readonly []\n ? [names: NamesRequired, options: O]\n : [...{ [K in keyof Init]: CheckNames<Init[K], N> }, O]\n : A\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 CheckRequirementName,\n NamesRequired,\n OptionsMustBeLast,\n PermissionRequirementOptions,\n RbacRequirement,\n RequirementArgs,\n RequirementKind,\n RequirementNames,\n RoleRequirementOptions,\n UnknownRequirementName,\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"]}
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\": \"1.0.0-rc.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://creation.anievo.id/rbac-evolution/guide/introduction\",\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 \"fast-check\": \"^4.10.2\",\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// ---------------------------------------------------------------------------- typed guard arguments\n//\n// Types for integrations whose guards take `(...names, options?)`, like `requirePermission('a|b', 'c', { any: true })`.\n// With typed names (see `RbacTypeConfig`), every name, including each part of a pipe list, must be one of `N`.\n// Without them (`N` is `string`), any name is accepted. In both cases a call with no names, or with options\n// before the last argument, is a type error, because it would throw (or ignore the options) at runtime.\n\ntype TrimSpaces<S extends string> = S extends ` ${infer R}` ? TrimSpaces<R> : S extends `${infer L} ` ? TrimSpaces<L> : S\n\n/** The first `|`-separated part of `S` that is not in `N`, or `never` when every part is. */\ntype UnknownPart<S extends string, N extends string> = S extends `${infer A}|${infer B}`\n ? TrimSpaces<A> extends N\n ? UnknownPart<B, N>\n : TrimSpaces<A>\n : TrimSpaces<S> extends N\n ? never\n : TrimSpaces<S>\n\n/** Shown in the type error when a name is not one of the typed names. */\nexport interface UnknownRequirementName<S extends string> {\n 'rbac-evolution: unknown name': S\n}\n\n/** Shown in the type error when an options object is not the last argument. */\nexport interface OptionsMustBeLast {\n 'rbac-evolution: options must be the last argument': true\n}\n\n/** Shown in the type error when a guard gets no names. */\nexport interface NamesRequired {\n 'rbac-evolution: at least one name is required': true\n}\n\n/** `S` when every part of the pipe list `S` is in `N` (always, for plain `string` names), else an error type. */\nexport type CheckRequirementName<S extends string, N extends string> = string extends N\n ? S\n : string extends S\n ? S\n : [UnknownPart<S, N>] extends [never]\n ? S\n : S & UnknownRequirementName<UnknownPart<S, N>>\n\ntype CheckNames<X, N extends string> = X extends string\n ? CheckRequirementName<X, N>\n : X extends readonly string[]\n ? { [K in keyof X]: X[K] extends string ? CheckRequirementName<X[K], N> : X[K] }\n : OptionsMustBeLast\n\n/**\n * Validates a guard's `(...names, options?)` arguments `A` against the names `N` and the options type `O`.\n * Use it as `fn<const A extends readonly (RequirementNames | O)[]>(...args: A & RequirementArgs<A, N, O>)`.\n * Arguments that are not a fixed tuple (a spread `string[]`) are not checked.\n */\nexport type RequirementArgs<A extends readonly unknown[], N extends string, O> = number extends A['length']\n ? A\n : A extends readonly []\n ? [names: NamesRequired]\n : A extends readonly [...infer Init, infer Last]\n ? Last extends RequirementNames\n ? { [K in keyof A]: CheckNames<A[K], N> }\n : Init extends readonly []\n ? [names: NamesRequired, options: O]\n : [...{ [K in keyof Init]: CheckNames<Init[K], N> }, O]\n : A\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 CheckRequirementName,\n NamesRequired,\n OptionsMustBeLast,\n PermissionRequirementOptions,\n RbacRequirement,\n RequirementArgs,\n RequirementKind,\n RequirementNames,\n RoleRequirementOptions,\n UnknownRequirementName,\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
@@ -413,6 +413,11 @@ var Rbac = class _Rbac {
413
413
  if (!permission) throw new PermissionDoesNotExist(normalizeName(name), this.#resolveGuard(options.guard));
414
414
  return permission;
415
415
  }
416
+ /** Finds a permission by id in the guard (spatie: `Permission::findById($id, $guard)`), or `null`. */
417
+ async findPermissionById(id, options = {}) {
418
+ const [permission] = await this.adapter.findPermissions({ ids: [id], guardName: this.#resolveGuard(options.guard) });
419
+ return permission ?? null;
420
+ }
416
421
  async findOrCreatePermission(name, options = {}) {
417
422
  return await this.findPermission(name, options) ?? this.createPermission(name, options);
418
423
  }
@@ -451,6 +456,25 @@ var Rbac = class _Rbac {
451
456
  if (!role) throw new RoleDoesNotExist(normalizeName(name), this.#resolveGuard(options.guard));
452
457
  return role;
453
458
  }
459
+ /** Finds a role by id in the guard (spatie: `Role::findById($id, $guard)`), or `null`. */
460
+ async findRoleById(id, options = {}) {
461
+ const [role] = await this.adapter.findRoles({ ids: [id], guardName: this.#resolveGuard(options.guard) });
462
+ return role ?? null;
463
+ }
464
+ /**
465
+ * Roles in the given scope that grant the permission directly (spatie: `$permission->roles`).
466
+ * Throws `PermissionDoesNotExist` for an unknown permission. Wildcard grants are not expanded.
467
+ */
468
+ async rolesWithPermission(permission, options = {}) {
469
+ const guardName = this.#resolveGuard(options.guard);
470
+ const teamId = this.#resolveTeam(options.team);
471
+ const [resolved] = await this.#resolvePermissions([permission], guardName);
472
+ const roles = await this.adapter.findRoles({ guardName, teamIds: this.#visibleTeams(teamId) });
473
+ if (roles.length === 0) return [];
474
+ const links = await this.adapter.getRolePermissionLinks(roles.map((r) => r.id));
475
+ const holders = new Set(links.filter((l) => idKey2(l.permissionId) === idKey2(resolved.id)).map((l) => idKey2(l.roleId)));
476
+ return roles.filter((r) => holders.has(idKey2(r.id)));
477
+ }
454
478
  async findOrCreateRole(name, options = {}) {
455
479
  return await this.findRole(name, options) ?? this.createRole(name, options);
456
480
  }
@@ -750,6 +774,20 @@ var SubjectRbac = class _SubjectRbac {
750
774
  guardName;
751
775
  teamId;
752
776
  #core;
777
+ /**
778
+ * The same subject in another guard and/or team; options left out keep the current ones (spatie passes the
779
+ * guard to each check: `$user->hasRole('admin', 'api')`).
780
+ *
781
+ * ```ts
782
+ * await rbac.for(user).withScope({ guard: 'api' }).hasRole('admin')
783
+ * ```
784
+ */
785
+ withScope(options) {
786
+ return this.rbac.for(this.subject, {
787
+ guard: options.guard ?? this.guardName,
788
+ team: options.team === void 0 ? this.teamId : options.team
789
+ });
790
+ }
753
791
  // ------------------------------------------------------------------------ roles
754
792
  async assignRole(...roles) {
755
793
  const { adapter } = this.rbac;
@@ -883,6 +921,27 @@ var SubjectRbac = class _SubjectRbac {
883
921
  const direct = (await this.state()).direct.map((p) => p.name);
884
922
  return this.#core.permissionMatches(direct, name);
885
923
  }
924
+ /** `true` if the subject has ANY of the permissions directly (ignores roles). Never throws. */
925
+ async hasAnyDirectPermission(...permissions) {
926
+ for (const permission of flatten(permissions)) {
927
+ if (await this.checkDirect(permission)) return true;
928
+ }
929
+ return false;
930
+ }
931
+ /** `true` if the subject has ALL the permissions directly (ignores roles). Never throws. */
932
+ async hasAllDirectPermissions(...permissions) {
933
+ for (const permission of flatten(permissions)) {
934
+ if (!await this.checkDirect(permission)) return false;
935
+ }
936
+ return true;
937
+ }
938
+ /**
939
+ * {@link hasPermissionTo} that returns `false` instead of throwing for an unknown permission or another guard
940
+ * (spatie: `checkPermissionTo`). Pure data check: no `before` hook or super-admin.
941
+ */
942
+ async checkPermissionTo(permission) {
943
+ return this.check(permission);
944
+ }
886
945
  /**
887
946
  * Authorization check: runs the `before` hook and `superAdminRoles` first, then falls back
888
947
  * to {@link hasPermissionTo}, returning `false` instead of throwing.
@@ -936,6 +995,15 @@ var SubjectRbac = class _SubjectRbac {
936
995
  throw error;
937
996
  }
938
997
  }
998
+ /** {@link hasDirectPermission} that returns `false` instead of throwing. */
999
+ async checkDirect(permission) {
1000
+ try {
1001
+ return await this.hasDirectPermission(permission);
1002
+ } catch (error) {
1003
+ if (error instanceof RbacError) return false;
1004
+ throw error;
1005
+ }
1006
+ }
939
1007
  async requirePermissionName(permission) {
940
1008
  if (typeof permission !== "string") {
941
1009
  if (permission.guardName !== this.guardName) throw new GuardDoesNotMatch(permission.guardName, this.guardName);