@anievo-id/rbac-evolution-next 0.1.1 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -152,7 +152,9 @@ export const DELETE = withRbac(
152
152
  )
153
153
  ```
154
154
 
155
- Guests get `401 { "error": "Unauthenticated" }`, users without access get `403 { "error": "Forbidden" }`.
155
+ Guests get `401 { "error": "UNAUTHENTICATED", "message": … }`, users without access get
156
+ `403 { "error": "FORBIDDEN", "reason": "permission" | "role" | "role_or_permission", "message": … }` — the same
157
+ bodies as `@anievo-id/rbac-evolution-express`.
156
158
  `withRbac` also accepts `guard` and `team`.
157
159
 
158
160
  ## Guards & teams
@@ -37,6 +37,32 @@ function matchPath(matcher, pathname) {
37
37
  if (matcher instanceof RegExp) return matcher.test(pathname);
38
38
  return matcher.some((m) => matchPath(m, pathname));
39
39
  }
40
+
41
+ // src/responses.ts
42
+ function forbiddenReason(requirement) {
43
+ if (requirement.permission !== void 0) return "permission";
44
+ if (requirement.role !== void 0) return "role";
45
+ return "role_or_permission";
46
+ }
47
+ function forbiddenMessage(requirement) {
48
+ switch (forbiddenReason(requirement)) {
49
+ case "permission":
50
+ return "User does not have the right permissions.";
51
+ case "role":
52
+ return "User does not have the right roles.";
53
+ default:
54
+ return "User does not have any of the necessary access rights.";
55
+ }
56
+ }
57
+ function unauthenticatedResponse() {
58
+ return Response.json({ error: "UNAUTHENTICATED", message: "User is not logged in." }, { status: 401 });
59
+ }
60
+ function forbiddenResponse(requirement) {
61
+ return Response.json(
62
+ { error: "FORBIDDEN", reason: forbiddenReason(requirement), message: forbiddenMessage(requirement) },
63
+ { status: 403 }
64
+ );
65
+ }
40
66
  var toList = (value) => typeof value === "string" ? [value] : value;
41
67
  function safeImplies(granted, required) {
42
68
  try {
@@ -70,12 +96,14 @@ function ruleRequirements(rule) {
70
96
  if (rule.roleOrPermission !== void 0) out.push({ roleOrPermission: rule.roleOrPermission });
71
97
  return out;
72
98
  }
73
- var json = (status, error, message) => new Response(JSON.stringify({ error, message }), { status, headers: { "content-type": "application/json" } });
74
99
  function createRbacMiddleware(options) {
75
- async function loadSnapshot(req) {
100
+ async function loadChecker(req) {
76
101
  if (options.rbac === void 0) {
77
102
  const snapshot = await options.getSnapshot(req) ?? null;
78
- return snapshot && { snapshot, wildcard: options.wildcard ?? false };
103
+ if (!snapshot) return null;
104
+ const checkOptions = { wildcard: options.wildcard ?? false };
105
+ if (options.superAdminRoles) checkOptions.superAdminRoles = options.superAdminRoles;
106
+ return async (requirement) => snapshotSatisfies(snapshot, requirement, checkOptions);
79
107
  }
80
108
  const subject = await options.getSubject(req) ?? null;
81
109
  if (!subject) return null;
@@ -83,34 +111,45 @@ function createRbacMiddleware(options) {
83
111
  if (options.guard !== void 0) scope.guard = options.guard;
84
112
  const team = typeof options.team === "function" ? await options.team(req) : options.team;
85
113
  if (team !== void 0 && team !== null) scope.team = team;
86
- return { snapshot: await options.rbac.for(subject, scope).snapshot(), wildcard: options.rbac.wildcard };
114
+ const s = options.rbac.for(subject, scope);
115
+ return async (requirement) => {
116
+ if (requirement.permission !== void 0) return s.canAny(requirement.permission);
117
+ if (requirement.role !== void 0) return s.hasAnyRole(requirement.role);
118
+ const items = requirement.roleOrPermission;
119
+ return await s.hasAnyRole(items) || await s.canAny(items);
120
+ };
87
121
  }
88
122
  return async (req) => {
89
123
  const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname;
90
124
  const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname));
91
125
  if (matching.length === 0) return void 0;
92
- const loaded = await loadSnapshot(req);
93
- if (!loaded) {
126
+ const check = await loadChecker(req);
127
+ if (!check) {
94
128
  const rule = matching[0];
95
129
  if (options.onUnauthenticated) return options.onUnauthenticated(req, rule);
96
130
  if (options.loginUrl !== void 0) {
97
131
  const target = typeof options.loginUrl === "function" ? options.loginUrl(req) : options.loginUrl;
98
132
  return Response.redirect(new URL(target, req.url), 307);
99
133
  }
100
- return json(401, "Unauthenticated", "Unauthenticated.");
134
+ return unauthenticatedResponse();
101
135
  }
102
- const checkOptions = options.rbac === void 0 && options.superAdminRoles ? { wildcard: loaded.wildcard, superAdminRoles: options.superAdminRoles } : { wildcard: loaded.wildcard };
103
136
  for (const rule of matching) {
104
- const passes = ruleRequirements(rule).every((r) => snapshotSatisfies(loaded.snapshot, r, checkOptions));
105
- if (!passes) {
137
+ let failed;
138
+ for (const requirement of ruleRequirements(rule)) {
139
+ if (!await check(requirement)) {
140
+ failed = requirement;
141
+ break;
142
+ }
143
+ }
144
+ if (failed) {
106
145
  if (options.onUnauthorized) return options.onUnauthorized(req, rule);
107
- return json(403, "Forbidden", "User does not have the right roles or permissions.");
146
+ return forbiddenResponse(failed);
108
147
  }
109
148
  }
110
149
  return void 0;
111
150
  };
112
151
  }
113
152
 
114
- export { compilePathPattern, createRbacMiddleware, matchPath, snapshotSatisfies };
115
- //# sourceMappingURL=chunk-QGRA2JHH.js.map
116
- //# sourceMappingURL=chunk-QGRA2JHH.js.map
153
+ export { compilePathPattern, createRbacMiddleware, forbiddenMessage, forbiddenResponse, matchPath, snapshotSatisfies, unauthenticatedResponse };
154
+ //# sourceMappingURL=chunk-L3PCX3HA.js.map
155
+ //# sourceMappingURL=chunk-L3PCX3HA.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/matcher.ts","../src/responses.ts","../src/snapshot.ts","../src/middleware.ts"],"names":[],"mappings":"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","file":"chunk-L3PCX3HA.js","sourcesContent":["const cache = new Map<string, RegExp>()\n\nconst escape = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * Compiles a Next.js-style path pattern to a RegExp.\n *\n * - `/admin` matches `/admin` (and `/admin/`)\n * - `/users/:id` matches one segment\n * - `/admin/:path*` matches `/admin`, `/admin/a`, `/admin/a/b`\n * - `/admin/:path+` matches `/admin/a`, `/admin/a/b` (not `/admin`)\n * - `/blog/:slug?` matches `/blog` and `/blog/x`\n */\nexport function compilePathPattern(pattern: string): RegExp {\n const hit = cache.get(pattern)\n if (hit) return hit\n\n let source = ''\n for (const segment of pattern.split('/')) {\n if (segment === '') continue\n const param = /^:[A-Za-z_][A-Za-z0-9_]*([*+?])?$/.exec(segment)\n if (!param) {\n source += `/${escape(segment)}`\n continue\n }\n switch (param[1]) {\n case '*':\n source += '(?:/[^/]+)*'\n break\n case '+':\n source += '(?:/[^/]+)+'\n break\n case '?':\n source += '(?:/[^/]+)?'\n break\n default:\n source += '/[^/]+'\n }\n }\n const regex = new RegExp(`^${source}/?$`)\n cache.set(pattern, regex)\n return regex\n}\n\nexport type PathMatcher = string | RegExp | readonly (string | RegExp)[]\n\n/** `true` if the pathname matches the pattern (or any of the patterns). */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n if (matcher instanceof RegExp) return matcher.test(pathname)\n return matcher.some((m) => matchPath(m, pathname))\n}\n","import type { Requirement } from './types'\n\n/** Which kind of requirement failed — same values as the Express package. */\nexport type ForbiddenReason = 'permission' | 'role' | 'role_or_permission'\n\nexport function forbiddenReason(requirement: Requirement): ForbiddenReason {\n if (requirement.permission !== undefined) return 'permission'\n if (requirement.role !== undefined) return 'role'\n return 'role_or_permission'\n}\n\n/** Like spatie, the message names the kind of requirement but not the role/permission names. */\nexport function forbiddenMessage(requirement: Requirement): string {\n switch (forbiddenReason(requirement)) {\n case 'permission':\n return 'User does not have the right permissions.'\n case 'role':\n return 'User does not have the right roles.'\n default:\n return 'User does not have any of the necessary access rights.'\n }\n}\n\n/** `401 { error: 'UNAUTHENTICATED', message }` — same body as `@anievo-id/rbac-evolution-express`. */\nexport function unauthenticatedResponse(): Response {\n return Response.json({ error: 'UNAUTHENTICATED', message: 'User is not logged in.' }, { status: 401 })\n}\n\n/** `403 { error: 'FORBIDDEN', reason, message }` — same body as `@anievo-id/rbac-evolution-express`. */\nexport function forbiddenResponse(requirement: Requirement): Response {\n return Response.json(\n { error: 'FORBIDDEN', reason: forbiddenReason(requirement), message: forbiddenMessage(requirement) },\n { status: 403 },\n )\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport type { Requirement } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n}\n\nconst toList = (value: Many<string>): readonly string[] => (typeof value === 'string' ? [value] : value)\n\nfunction safeImplies(granted: string, required: string): boolean {\n try {\n return wildcardImplies(granted, required)\n } catch {\n return false\n }\n}\n\n/** Synchronously checks a requirement against a snapshot. Arrays mean \"any of\". */\nexport function snapshotSatisfies(\n snapshot: RbacSnapshot,\n requirement: Requirement,\n options: SnapshotCheckOptions = {},\n): boolean {\n const roles = new Set(snapshot.roles)\n const isSuperAdmin = (options.superAdminRoles ?? []).some((r) => roles.has(r))\n const hasRole = (role: string): boolean => roles.has(role.trim())\n const can = (permission: string): boolean => {\n if (isSuperAdmin) return true\n const name = permission.trim()\n if (name === '') return false\n if (snapshot.permissions.includes(name)) return true\n return (options.wildcard ?? false) && snapshot.permissions.some((g) => safeImplies(g, name))\n }\n\n if (requirement.permission !== undefined) return toList(requirement.permission).some(can)\n if (requirement.role !== undefined) return toList(requirement.role).some(hasRole)\n const items = toList(requirement.roleOrPermission)\n return items.some(hasRole) || items.some(can)\n}\n","import type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { matchPath } from './matcher'\nimport type { PathMatcher } from './matcher'\nimport { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport { snapshotSatisfies, type SnapshotCheckOptions } from './snapshot'\nimport type { MaybePromise, Requirement } from './types'\n\nexport interface RbacMiddlewareRule {\n /** Path pattern(s): `/admin`, `/users/:id`, `/admin/:path*`, or a RegExp. */\n matcher: PathMatcher\n /** Requires the permission (or ANY of them). */\n permission?: Many<string>\n /** Requires the role (or ANY of them). */\n role?: Many<string>\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string>\n // A rule with none of the above only requires an authenticated user.\n}\n\n/** The request as seen by middleware. `NextRequest` fits; `nextUrl.pathname` is preferred (it excludes `basePath`). */\nexport type MiddlewareRequest = Request & { nextUrl?: { pathname: string } }\n\ninterface BaseOptions<Req extends MiddlewareRequest> {\n /** Every matching rule must pass. Requests matching no rule pass through. */\n rules: readonly RbacMiddlewareRule[]\n /** Redirect guests here (relative to the request URL). Without it, guests get a `401` JSON response. */\n loginUrl?: string | ((req: Req) => string | URL)\n /** Custom response for guests. */\n onUnauthenticated?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n}\n\n/** Loads roles & permissions through an `Rbac` instance (DB adapters need the Node.js middleware runtime). */\nexport interface RbacMiddlewareWithRbac<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n rbac: Rbac\n getSubject: (req: Req) => MaybePromise<Subject | null | undefined>\n guard?: string\n team?: TeamId | ((req: Req) => MaybePromise<TeamId | undefined>)\n getSnapshot?: never\n}\n\n/** Reads roles & permissions from somewhere cheap, e.g. the session/JWT. Works in the Edge runtime. */\nexport interface RbacMiddlewareWithSnapshot<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n /** Return `null` for guests. */\n getSnapshot: (req: Req) => MaybePromise<RbacSnapshot | null | undefined>\n /** Must match the server's `wildcard` setting. Default: `false`. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n rbac?: never\n getSubject?: never\n}\n\nexport type RbacMiddlewareOptions<Req extends MiddlewareRequest = MiddlewareRequest> =\n | RbacMiddlewareWithRbac<Req>\n | RbacMiddlewareWithSnapshot<Req>\n\nfunction ruleRequirements(rule: RbacMiddlewareRule): Requirement[] {\n const out: Requirement[] = []\n if (rule.permission !== undefined) out.push({ permission: rule.permission })\n if (rule.role !== undefined) out.push({ role: rule.role })\n if (rule.roleOrPermission !== undefined) out.push({ roleOrPermission: rule.roleOrPermission })\n return out\n}\n\n/**\n * Route protection for `middleware.ts`, like spatie's route middleware.\n * Returns a `Response` when access is denied, or `undefined` to let the request through.\n *\n * ```ts\n * export default createRbacMiddleware({\n * rules: [{ matcher: '/admin/:path*', role: 'admin' }],\n * getSnapshot: async (req) => (await getToken({ req }))?.rbac ?? null,\n * })\n * ```\n */\nexport function createRbacMiddleware<Req extends MiddlewareRequest = MiddlewareRequest>(\n options: RbacMiddlewareOptions<Req>,\n): (req: Req) => Promise<Response | undefined> {\n type Checker = (requirement: Requirement) => Promise<boolean>\n\n /**\n * Resolves who is asking and returns a requirement checker, or `null` for guests.\n * In `rbac` mode the checks go through the engine (`canAny` / `hasAnyRole`), so\n * `superAdminRoles` and the `before` hook apply exactly like in the server helpers.\n */\n async function loadChecker(req: Req): Promise<Checker | null> {\n if (options.rbac === undefined) {\n const snapshot = (await options.getSnapshot(req)) ?? null\n if (!snapshot) return null\n const checkOptions: SnapshotCheckOptions = { wildcard: options.wildcard ?? false }\n if (options.superAdminRoles) checkOptions.superAdminRoles = options.superAdminRoles\n return async (requirement) => snapshotSatisfies(snapshot, requirement, checkOptions)\n }\n const subject = (await options.getSubject(req)) ?? null\n if (!subject) return null\n const scope: ScopeOptions = {}\n if (options.guard !== undefined) scope.guard = options.guard\n const team = typeof options.team === 'function' ? await options.team(req) : options.team\n if (team !== undefined && team !== null) scope.team = team\n const s = options.rbac.for(subject, scope)\n return async (requirement) => {\n if (requirement.permission !== undefined) return s.canAny(requirement.permission)\n if (requirement.role !== undefined) return s.hasAnyRole(requirement.role)\n const items = requirement.roleOrPermission\n return (await s.hasAnyRole(items)) || (await s.canAny(items))\n }\n }\n\n return async (req: Req): Promise<Response | undefined> => {\n const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname\n const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname))\n if (matching.length === 0) return undefined\n\n const check = await loadChecker(req)\n if (!check) {\n const rule = matching[0]!\n if (options.onUnauthenticated) return options.onUnauthenticated(req, rule)\n if (options.loginUrl !== undefined) {\n const target = typeof options.loginUrl === 'function' ? options.loginUrl(req) : options.loginUrl\n return Response.redirect(new URL(target, req.url), 307)\n }\n return unauthenticatedResponse()\n }\n\n for (const rule of matching) {\n let failed: Requirement | undefined\n for (const requirement of ruleRequirements(rule)) {\n if (!(await check(requirement))) {\n failed = requirement\n break\n }\n }\n if (failed) {\n if (options.onUnauthorized) return options.onUnauthorized(req, rule)\n return forbiddenResponse(failed)\n }\n }\n return undefined\n }\n}\n"]}
package/dist/index.cjs CHANGED
@@ -19,12 +19,33 @@ var RbacUnauthorizedError = class extends Error {
19
19
  }
20
20
  };
21
21
 
22
- // src/server.ts
22
+ // src/responses.ts
23
+ function forbiddenReason(requirement) {
24
+ if (requirement.permission !== void 0) return "permission";
25
+ if (requirement.role !== void 0) return "role";
26
+ return "role_or_permission";
27
+ }
23
28
  function forbiddenMessage(requirement) {
24
- if (requirement.permission !== void 0) return "User does not have the right permissions.";
25
- if (requirement.role !== void 0) return "User does not have the right roles.";
26
- return "User does not have any of the necessary access rights.";
29
+ switch (forbiddenReason(requirement)) {
30
+ case "permission":
31
+ return "User does not have the right permissions.";
32
+ case "role":
33
+ return "User does not have the right roles.";
34
+ default:
35
+ return "User does not have any of the necessary access rights.";
36
+ }
37
+ }
38
+ function unauthenticatedResponse() {
39
+ return Response.json({ error: "UNAUTHENTICATED", message: "User is not logged in." }, { status: 401 });
40
+ }
41
+ function forbiddenResponse(requirement) {
42
+ return Response.json(
43
+ { error: "FORBIDDEN", reason: forbiddenReason(requirement), message: forbiddenMessage(requirement) },
44
+ { status: 403 }
45
+ );
27
46
  }
47
+
48
+ // src/server.ts
28
49
  var EMPTY_SNAPSHOT = { roles: [], permissions: [] };
29
50
  function createNextRbac(options) {
30
51
  const { rbac } = options;
@@ -152,7 +173,7 @@ function createNextRbac(options) {
152
173
  return async (...args) => {
153
174
  const result = await authorize(requirement, scope);
154
175
  if (result.ok) return handler(...args);
155
- return result.reason === "unauthenticated" ? Response.json({ error: "Unauthenticated", message: "Unauthenticated." }, { status: 401 }) : Response.json({ error: "Forbidden", message: forbiddenMessage(requirement) }, { status: 403 });
176
+ return result.reason === "unauthenticated" ? unauthenticatedResponse() : forbiddenResponse(requirement);
156
177
  };
157
178
  }
158
179
  };
@@ -228,12 +249,14 @@ function ruleRequirements(rule) {
228
249
  if (rule.roleOrPermission !== void 0) out.push({ roleOrPermission: rule.roleOrPermission });
229
250
  return out;
230
251
  }
231
- var json = (status, error, message) => new Response(JSON.stringify({ error, message }), { status, headers: { "content-type": "application/json" } });
232
252
  function createRbacMiddleware(options) {
233
- async function loadSnapshot(req) {
253
+ async function loadChecker(req) {
234
254
  if (options.rbac === void 0) {
235
255
  const snapshot = await options.getSnapshot(req) ?? null;
236
- return snapshot && { snapshot, wildcard: options.wildcard ?? false };
256
+ if (!snapshot) return null;
257
+ const checkOptions = { wildcard: options.wildcard ?? false };
258
+ if (options.superAdminRoles) checkOptions.superAdminRoles = options.superAdminRoles;
259
+ return async (requirement) => snapshotSatisfies(snapshot, requirement, checkOptions);
237
260
  }
238
261
  const subject = await options.getSubject(req) ?? null;
239
262
  if (!subject) return null;
@@ -241,28 +264,39 @@ function createRbacMiddleware(options) {
241
264
  if (options.guard !== void 0) scope.guard = options.guard;
242
265
  const team = typeof options.team === "function" ? await options.team(req) : options.team;
243
266
  if (team !== void 0 && team !== null) scope.team = team;
244
- return { snapshot: await options.rbac.for(subject, scope).snapshot(), wildcard: options.rbac.wildcard };
267
+ const s = options.rbac.for(subject, scope);
268
+ return async (requirement) => {
269
+ if (requirement.permission !== void 0) return s.canAny(requirement.permission);
270
+ if (requirement.role !== void 0) return s.hasAnyRole(requirement.role);
271
+ const items = requirement.roleOrPermission;
272
+ return await s.hasAnyRole(items) || await s.canAny(items);
273
+ };
245
274
  }
246
275
  return async (req) => {
247
276
  const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname;
248
277
  const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname));
249
278
  if (matching.length === 0) return void 0;
250
- const loaded = await loadSnapshot(req);
251
- if (!loaded) {
279
+ const check = await loadChecker(req);
280
+ if (!check) {
252
281
  const rule = matching[0];
253
282
  if (options.onUnauthenticated) return options.onUnauthenticated(req, rule);
254
283
  if (options.loginUrl !== void 0) {
255
284
  const target = typeof options.loginUrl === "function" ? options.loginUrl(req) : options.loginUrl;
256
285
  return Response.redirect(new URL(target, req.url), 307);
257
286
  }
258
- return json(401, "Unauthenticated", "Unauthenticated.");
287
+ return unauthenticatedResponse();
259
288
  }
260
- const checkOptions = options.rbac === void 0 && options.superAdminRoles ? { wildcard: loaded.wildcard, superAdminRoles: options.superAdminRoles } : { wildcard: loaded.wildcard };
261
289
  for (const rule of matching) {
262
- const passes = ruleRequirements(rule).every((r) => snapshotSatisfies(loaded.snapshot, r, checkOptions));
263
- if (!passes) {
290
+ let failed;
291
+ for (const requirement of ruleRequirements(rule)) {
292
+ if (!await check(requirement)) {
293
+ failed = requirement;
294
+ break;
295
+ }
296
+ }
297
+ if (failed) {
264
298
  if (options.onUnauthorized) return options.onUnauthorized(req, rule);
265
- return json(403, "Forbidden", "User does not have the right roles or permissions.");
299
+ return forbiddenResponse(failed);
266
300
  }
267
301
  }
268
302
  return void 0;
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/server.ts","../src/matcher.ts","../src/snapshot.ts","../src/middleware.ts"],"names":["redirect","notFound","options","wildcardImplies"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { FailureReason } from './types'\n\n/** Thrown by `withPermission()` / `withRole()` wrapped server actions when access is denied. */\nexport class RbacUnauthorizedError extends Error {\n /** `unauthenticated` (no subject) or `unauthorized` (missing role/permission). */\n readonly reason: FailureReason\n /** HTTP-style status: `401` or `403`. */\n readonly status: 401 | 403\n\n constructor(reason: FailureReason, message?: string) {\n super(message ?? (reason === 'unauthenticated' ? 'Unauthenticated.' : 'This action is unauthorized.'))\n this.name = 'RbacUnauthorizedError'\n this.reason = reason\n this.status = reason === 'unauthenticated' ? 401 : 403\n }\n}\n","import { notFound, redirect } from 'next/navigation'\nimport type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { RbacUnauthorizedError } from './errors'\nimport type { FailureReason, MaybePromise, Requirement } from './types'\n\nexport interface NextRbacOptions {\n /** Your `createRbac(...)` instance. */\n rbac: Rbac\n /** Resolves the current user (e.g. from Auth.js `auth()`). Return `null` for guests. */\n getSubject: () => MaybePromise<Subject | null | undefined>\n /** Default guard for every check. Default: the rbac instance's `defaultGuard`. */\n guard?: string\n /** Default team for every check — a value, or a function (e.g. reading the current tenant). */\n team?: TeamId | (() => MaybePromise<TeamId | undefined>)\n /** Where `require*()` redirects guests. Without it, guests get `notFound()`. */\n loginUrl?: string\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: () => never\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: () => never\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n loginUrl?: string\n onUnauthenticated?: () => never\n onUnauthorized?: () => never\n}\n\nexport type AuthorizeResult =\n | { ok: true; subject: Subject }\n | { ok: false; reason: 'unauthenticated'; subject: null }\n | { ok: false; reason: 'unauthorized'; subject: Subject }\n\nexport type WithRbacOptions = Requirement & ScopeOptions\n\n/** Like spatie, the message names the kind of requirement but not the role/permission names. */\nexport function forbiddenMessage(requirement: Requirement): string {\n if (requirement.permission !== undefined) return 'User does not have the right permissions.'\n if (requirement.role !== undefined) return 'User does not have the right roles.'\n return 'User does not have any of the necessary access rights.'\n}\n\nconst EMPTY_SNAPSHOT: RbacSnapshot = { roles: [], permissions: [] }\n\n\n\n/**\n * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).\n *\n * ```ts\n * // lib/rbac.ts\n * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({\n * rbac,\n * getSubject: async () => {\n * const session = await auth()\n * return session?.user ? { type: 'user', id: session.user.id } : null\n * },\n * })\n * ```\n */\nexport function createNextRbac(options: NextRbacOptions) {\n const { rbac } = options\n\n async function getSubject(): Promise<Subject | null> {\n return (await options.getSubject()) ?? null\n }\n\n async function resolveScope(scope: ScopeOptions = {}): Promise<ScopeOptions> {\n const guard = scope.guard ?? options.guard\n let team: TeamId | undefined = scope.team\n if (team === undefined) {\n team = typeof options.team === 'function' ? await options.team() : options.team\n }\n const out: ScopeOptions = {}\n if (guard !== undefined) out.guard = guard\n if (team !== undefined && team !== null) out.team = team\n return out\n }\n\n async function forSubject(subject: Subject, scope?: ScopeOptions) {\n return rbac.for(subject, await resolveScope(scope))\n }\n\n async function satisfies(subject: Subject, requirement: Requirement, scope?: ScopeOptions): Promise<boolean> {\n const s = await forSubject(subject, scope)\n if (requirement.permission !== undefined) return s.canAny(requirement.permission)\n if (requirement.role !== undefined) return s.hasAnyRole(requirement.role)\n const items = requirement.roleOrPermission\n return (await s.hasAnyRole(items)) || (await s.canAny(items))\n }\n\n /** Non-throwing check: who is the user and do they meet the requirement? */\n async function authorize(requirement: Requirement, scope?: ScopeOptions): Promise<AuthorizeResult> {\n const subject = await getSubject()\n if (!subject) return { ok: false, reason: 'unauthenticated', subject: null }\n if (!(await satisfies(subject, requirement, scope))) return { ok: false, reason: 'unauthorized', subject }\n return { ok: true, subject }\n }\n\n function fail(reason: FailureReason, opts: RequireOptions): never {\n if (reason === 'unauthenticated') {\n const handler = opts.onUnauthenticated ?? options.onUnauthenticated\n if (handler) handler()\n else {\n const loginUrl = opts.loginUrl ?? options.loginUrl\n if (loginUrl !== undefined) redirect(loginUrl)\n notFound()\n }\n } else {\n const handler = opts.onUnauthorized ?? options.onUnauthorized\n if (handler) handler()\n else notFound()\n }\n // Safety net in case a custom handler returned instead of throwing.\n throw new RbacUnauthorizedError(reason)\n }\n\n async function enforce(requirement: Requirement, opts: RequireOptions = {}): Promise<Subject> {\n const result = await authorize(requirement, opts)\n if (!result.ok) fail(result.reason, opts)\n return result.subject\n }\n\n function guardAction<Args extends unknown[], R>(\n requirement: Requirement,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return async (...args: Args): Promise<R> => {\n const result = await authorize(requirement, scope)\n if (!result.ok) throw new RbacUnauthorizedError(result.reason)\n return action(...args)\n }\n }\n\n return {\n rbac,\n getSubject,\n authorize,\n\n /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */\n async getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot> {\n const subject = await getSubject()\n if (!subject) return { roles: [...EMPTY_SNAPSHOT.roles], permissions: [...EMPTY_SNAPSHOT.permissions] }\n return (await forSubject(subject, scope)).snapshot()\n },\n\n async can(permission: string, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).can(permission) : false\n },\n\n async canAny(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAny(permissions) : false\n },\n\n async canAll(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAll(permissions) : false\n },\n\n /** `true` if the user has the role — or ANY of the roles when given an array. */\n async hasRole(role: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAnyRole(role) : false\n },\n\n async hasAllRoles(roles: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAllRoles(roles) : false\n },\n\n /**\n * Ensures the user has the permission (or ANY of the permissions). Returns the subject.\n * Guests: `redirect(loginUrl)` or `notFound()`. Missing permission: `notFound()`. Both configurable.\n */\n requirePermission(permission: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ permission }, opts)\n },\n\n /** Ensures the user has the role (or ANY of the roles). Returns the subject. */\n requireRole(role: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ role }, opts)\n },\n\n /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */\n requireRoleOrPermission(items: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ roleOrPermission: items }, opts)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */\n withPermission<Args extends unknown[], R>(\n permission: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ permission }, action, scope)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */\n withRole<Args extends unknown[], R>(\n role: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ role }, action, scope)\n },\n\n /**\n * Wraps a route handler. Responds `401` (guest) or `403` (missing role/permission) with a JSON body.\n * Mirrors spatie's `permission`, `role` and `role_or_permission` middleware.\n */\n withRbac<Args extends unknown[]>(\n handler: (...args: Args) => MaybePromise<Response>,\n options: WithRbacOptions,\n ): (...args: Args) => Promise<Response> {\n const { guard, team, ...requirement } = options\n const scope: ScopeOptions = {}\n if (guard !== undefined) scope.guard = guard\n if (team !== undefined) scope.team = team\n return async (...args: Args): Promise<Response> => {\n const result = await authorize(requirement as Requirement, scope)\n if (result.ok) return handler(...args)\n return result.reason === 'unauthenticated'\n ? Response.json({ error: 'Unauthenticated', message: 'Unauthenticated.' }, { status: 401 })\n : Response.json({ error: 'Forbidden', message: forbiddenMessage(requirement as Requirement) }, { status: 403 })\n }\n },\n }\n}\n\nexport type NextRbac = ReturnType<typeof createNextRbac>\n","const cache = new Map<string, RegExp>()\n\nconst escape = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * Compiles a Next.js-style path pattern to a RegExp.\n *\n * - `/admin` matches `/admin` (and `/admin/`)\n * - `/users/:id` matches one segment\n * - `/admin/:path*` matches `/admin`, `/admin/a`, `/admin/a/b`\n * - `/admin/:path+` matches `/admin/a`, `/admin/a/b` (not `/admin`)\n * - `/blog/:slug?` matches `/blog` and `/blog/x`\n */\nexport function compilePathPattern(pattern: string): RegExp {\n const hit = cache.get(pattern)\n if (hit) return hit\n\n let source = ''\n for (const segment of pattern.split('/')) {\n if (segment === '') continue\n const param = /^:[A-Za-z_][A-Za-z0-9_]*([*+?])?$/.exec(segment)\n if (!param) {\n source += `/${escape(segment)}`\n continue\n }\n switch (param[1]) {\n case '*':\n source += '(?:/[^/]+)*'\n break\n case '+':\n source += '(?:/[^/]+)+'\n break\n case '?':\n source += '(?:/[^/]+)?'\n break\n default:\n source += '/[^/]+'\n }\n }\n const regex = new RegExp(`^${source}/?$`)\n cache.set(pattern, regex)\n return regex\n}\n\nexport type PathMatcher = string | RegExp | readonly (string | RegExp)[]\n\n/** `true` if the pathname matches the pattern (or any of the patterns). */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n if (matcher instanceof RegExp) return matcher.test(pathname)\n return matcher.some((m) => matchPath(m, pathname))\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport type { Requirement } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n}\n\nconst toList = (value: Many<string>): readonly string[] => (typeof value === 'string' ? [value] : value)\n\nfunction safeImplies(granted: string, required: string): boolean {\n try {\n return wildcardImplies(granted, required)\n } catch {\n return false\n }\n}\n\n/** Synchronously checks a requirement against a snapshot. Arrays mean \"any of\". */\nexport function snapshotSatisfies(\n snapshot: RbacSnapshot,\n requirement: Requirement,\n options: SnapshotCheckOptions = {},\n): boolean {\n const roles = new Set(snapshot.roles)\n const isSuperAdmin = (options.superAdminRoles ?? []).some((r) => roles.has(r))\n const hasRole = (role: string): boolean => roles.has(role.trim())\n const can = (permission: string): boolean => {\n if (isSuperAdmin) return true\n const name = permission.trim()\n if (name === '') return false\n if (snapshot.permissions.includes(name)) return true\n return (options.wildcard ?? false) && snapshot.permissions.some((g) => safeImplies(g, name))\n }\n\n if (requirement.permission !== undefined) return toList(requirement.permission).some(can)\n if (requirement.role !== undefined) return toList(requirement.role).some(hasRole)\n const items = toList(requirement.roleOrPermission)\n return items.some(hasRole) || items.some(can)\n}\n","import type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { matchPath } from './matcher'\nimport type { PathMatcher } from './matcher'\nimport { snapshotSatisfies } from './snapshot'\nimport type { MaybePromise, Requirement } from './types'\n\nexport interface RbacMiddlewareRule {\n /** Path pattern(s): `/admin`, `/users/:id`, `/admin/:path*`, or a RegExp. */\n matcher: PathMatcher\n /** Requires the permission (or ANY of them). */\n permission?: Many<string>\n /** Requires the role (or ANY of them). */\n role?: Many<string>\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string>\n // A rule with none of the above only requires an authenticated user.\n}\n\n/** The request as seen by middleware. `NextRequest` fits; `nextUrl.pathname` is preferred (it excludes `basePath`). */\nexport type MiddlewareRequest = Request & { nextUrl?: { pathname: string } }\n\ninterface BaseOptions<Req extends MiddlewareRequest> {\n /** Every matching rule must pass. Requests matching no rule pass through. */\n rules: readonly RbacMiddlewareRule[]\n /** Redirect guests here (relative to the request URL). Without it, guests get a `401` JSON response. */\n loginUrl?: string | ((req: Req) => string | URL)\n /** Custom response for guests. */\n onUnauthenticated?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n}\n\n/** Loads roles & permissions through an `Rbac` instance (DB adapters need the Node.js middleware runtime). */\nexport interface RbacMiddlewareWithRbac<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n rbac: Rbac\n getSubject: (req: Req) => MaybePromise<Subject | null | undefined>\n guard?: string\n team?: TeamId | ((req: Req) => MaybePromise<TeamId | undefined>)\n getSnapshot?: never\n}\n\n/** Reads roles & permissions from somewhere cheap, e.g. the session/JWT. Works in the Edge runtime. */\nexport interface RbacMiddlewareWithSnapshot<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n /** Return `null` for guests. */\n getSnapshot: (req: Req) => MaybePromise<RbacSnapshot | null | undefined>\n /** Must match the server's `wildcard` setting. Default: `false`. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n rbac?: never\n getSubject?: never\n}\n\nexport type RbacMiddlewareOptions<Req extends MiddlewareRequest = MiddlewareRequest> =\n | RbacMiddlewareWithRbac<Req>\n | RbacMiddlewareWithSnapshot<Req>\n\nfunction ruleRequirements(rule: RbacMiddlewareRule): Requirement[] {\n const out: Requirement[] = []\n if (rule.permission !== undefined) out.push({ permission: rule.permission })\n if (rule.role !== undefined) out.push({ role: rule.role })\n if (rule.roleOrPermission !== undefined) out.push({ roleOrPermission: rule.roleOrPermission })\n return out\n}\n\nconst json = (status: number, error: string, message: string): Response =>\n new Response(JSON.stringify({ error, message }), { status, headers: { 'content-type': 'application/json' } })\n\n/**\n * Route protection for `middleware.ts`, like spatie's route middleware.\n * Returns a `Response` when access is denied, or `undefined` to let the request through.\n *\n * ```ts\n * export default createRbacMiddleware({\n * rules: [{ matcher: '/admin/:path*', role: 'admin' }],\n * getSnapshot: async (req) => (await getToken({ req }))?.rbac ?? null,\n * })\n * ```\n */\nexport function createRbacMiddleware<Req extends MiddlewareRequest = MiddlewareRequest>(\n options: RbacMiddlewareOptions<Req>,\n): (req: Req) => Promise<Response | undefined> {\n async function loadSnapshot(req: Req): Promise<{ snapshot: RbacSnapshot; wildcard: boolean } | null> {\n if (options.rbac === undefined) {\n const snapshot = (await options.getSnapshot(req)) ?? null\n return snapshot && { snapshot, wildcard: options.wildcard ?? false }\n }\n const subject = (await options.getSubject(req)) ?? null\n if (!subject) return null\n const scope: ScopeOptions = {}\n if (options.guard !== undefined) scope.guard = options.guard\n const team = typeof options.team === 'function' ? await options.team(req) : options.team\n if (team !== undefined && team !== null) scope.team = team\n return { snapshot: await options.rbac.for(subject, scope).snapshot(), wildcard: options.rbac.wildcard }\n }\n\n return async (req: Req): Promise<Response | undefined> => {\n const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname\n const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname))\n if (matching.length === 0) return undefined\n\n const loaded = await loadSnapshot(req)\n if (!loaded) {\n const rule = matching[0]!\n if (options.onUnauthenticated) return options.onUnauthenticated(req, rule)\n if (options.loginUrl !== undefined) {\n const target = typeof options.loginUrl === 'function' ? options.loginUrl(req) : options.loginUrl\n return Response.redirect(new URL(target, req.url), 307)\n }\n return json(401, 'Unauthenticated', 'Unauthenticated.')\n }\n\n const checkOptions =\n options.rbac === undefined && options.superAdminRoles\n ? { wildcard: loaded.wildcard, superAdminRoles: options.superAdminRoles }\n : { wildcard: loaded.wildcard }\n\n for (const rule of matching) {\n const passes = ruleRequirements(rule).every((r) => snapshotSatisfies(loaded.snapshot, r, checkOptions))\n if (!passes) {\n if (options.onUnauthorized) return options.onUnauthorized(req, rule)\n return json(403, 'Forbidden', 'User does not have the right roles or permissions.')\n }\n }\n return undefined\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/responses.ts","../src/server.ts","../src/matcher.ts","../src/snapshot.ts","../src/middleware.ts"],"names":["redirect","notFound","options","wildcardImplies"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { FailureReason } from './types'\n\n/** Thrown by `withPermission()` / `withRole()` wrapped server actions when access is denied. */\nexport class RbacUnauthorizedError extends Error {\n /** `unauthenticated` (no subject) or `unauthorized` (missing role/permission). */\n readonly reason: FailureReason\n /** HTTP-style status: `401` or `403`. */\n readonly status: 401 | 403\n\n constructor(reason: FailureReason, message?: string) {\n super(message ?? (reason === 'unauthenticated' ? 'Unauthenticated.' : 'This action is unauthorized.'))\n this.name = 'RbacUnauthorizedError'\n this.reason = reason\n this.status = reason === 'unauthenticated' ? 401 : 403\n }\n}\n","import type { Requirement } from './types'\n\n/** Which kind of requirement failed — same values as the Express package. */\nexport type ForbiddenReason = 'permission' | 'role' | 'role_or_permission'\n\nexport function forbiddenReason(requirement: Requirement): ForbiddenReason {\n if (requirement.permission !== undefined) return 'permission'\n if (requirement.role !== undefined) return 'role'\n return 'role_or_permission'\n}\n\n/** Like spatie, the message names the kind of requirement but not the role/permission names. */\nexport function forbiddenMessage(requirement: Requirement): string {\n switch (forbiddenReason(requirement)) {\n case 'permission':\n return 'User does not have the right permissions.'\n case 'role':\n return 'User does not have the right roles.'\n default:\n return 'User does not have any of the necessary access rights.'\n }\n}\n\n/** `401 { error: 'UNAUTHENTICATED', message }` — same body as `@anievo-id/rbac-evolution-express`. */\nexport function unauthenticatedResponse(): Response {\n return Response.json({ error: 'UNAUTHENTICATED', message: 'User is not logged in.' }, { status: 401 })\n}\n\n/** `403 { error: 'FORBIDDEN', reason, message }` — same body as `@anievo-id/rbac-evolution-express`. */\nexport function forbiddenResponse(requirement: Requirement): Response {\n return Response.json(\n { error: 'FORBIDDEN', reason: forbiddenReason(requirement), message: forbiddenMessage(requirement) },\n { status: 403 },\n )\n}\n","import { notFound, redirect } from 'next/navigation'\nimport type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { RbacUnauthorizedError } from './errors'\nimport { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport type { FailureReason, MaybePromise, Requirement } from './types'\n\nexport interface NextRbacOptions {\n /** Your `createRbac(...)` instance. */\n rbac: Rbac\n /** Resolves the current user (e.g. from Auth.js `auth()`). Return `null` for guests. */\n getSubject: () => MaybePromise<Subject | null | undefined>\n /** Default guard for every check. Default: the rbac instance's `defaultGuard`. */\n guard?: string\n /** Default team for every check — a value, or a function (e.g. reading the current tenant). */\n team?: TeamId | (() => MaybePromise<TeamId | undefined>)\n /** Where `require*()` redirects guests. Without it, guests get `notFound()`. */\n loginUrl?: string\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: () => never\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: () => never\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n loginUrl?: string\n onUnauthenticated?: () => never\n onUnauthorized?: () => never\n}\n\nexport type AuthorizeResult =\n | { ok: true; subject: Subject }\n | { ok: false; reason: 'unauthenticated'; subject: null }\n | { ok: false; reason: 'unauthorized'; subject: Subject }\n\nexport type WithRbacOptions = Requirement & ScopeOptions\n\nexport { forbiddenMessage } from './responses'\n\nconst EMPTY_SNAPSHOT: RbacSnapshot = { roles: [], permissions: [] }\n\n\n\n/**\n * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).\n *\n * ```ts\n * // lib/rbac.ts\n * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({\n * rbac,\n * getSubject: async () => {\n * const session = await auth()\n * return session?.user ? { type: 'user', id: session.user.id } : null\n * },\n * })\n * ```\n */\nexport function createNextRbac(options: NextRbacOptions) {\n const { rbac } = options\n\n async function getSubject(): Promise<Subject | null> {\n return (await options.getSubject()) ?? null\n }\n\n async function resolveScope(scope: ScopeOptions = {}): Promise<ScopeOptions> {\n const guard = scope.guard ?? options.guard\n let team: TeamId | undefined = scope.team\n if (team === undefined) {\n team = typeof options.team === 'function' ? await options.team() : options.team\n }\n const out: ScopeOptions = {}\n if (guard !== undefined) out.guard = guard\n if (team !== undefined && team !== null) out.team = team\n return out\n }\n\n async function forSubject(subject: Subject, scope?: ScopeOptions) {\n return rbac.for(subject, await resolveScope(scope))\n }\n\n async function satisfies(subject: Subject, requirement: Requirement, scope?: ScopeOptions): Promise<boolean> {\n const s = await forSubject(subject, scope)\n if (requirement.permission !== undefined) return s.canAny(requirement.permission)\n if (requirement.role !== undefined) return s.hasAnyRole(requirement.role)\n const items = requirement.roleOrPermission\n return (await s.hasAnyRole(items)) || (await s.canAny(items))\n }\n\n /** Non-throwing check: who is the user and do they meet the requirement? */\n async function authorize(requirement: Requirement, scope?: ScopeOptions): Promise<AuthorizeResult> {\n const subject = await getSubject()\n if (!subject) return { ok: false, reason: 'unauthenticated', subject: null }\n if (!(await satisfies(subject, requirement, scope))) return { ok: false, reason: 'unauthorized', subject }\n return { ok: true, subject }\n }\n\n function fail(reason: FailureReason, opts: RequireOptions): never {\n if (reason === 'unauthenticated') {\n const handler = opts.onUnauthenticated ?? options.onUnauthenticated\n if (handler) handler()\n else {\n const loginUrl = opts.loginUrl ?? options.loginUrl\n if (loginUrl !== undefined) redirect(loginUrl)\n notFound()\n }\n } else {\n const handler = opts.onUnauthorized ?? options.onUnauthorized\n if (handler) handler()\n else notFound()\n }\n // Safety net in case a custom handler returned instead of throwing.\n throw new RbacUnauthorizedError(reason)\n }\n\n async function enforce(requirement: Requirement, opts: RequireOptions = {}): Promise<Subject> {\n const result = await authorize(requirement, opts)\n if (!result.ok) fail(result.reason, opts)\n return result.subject\n }\n\n function guardAction<Args extends unknown[], R>(\n requirement: Requirement,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return async (...args: Args): Promise<R> => {\n const result = await authorize(requirement, scope)\n if (!result.ok) throw new RbacUnauthorizedError(result.reason)\n return action(...args)\n }\n }\n\n return {\n rbac,\n getSubject,\n authorize,\n\n /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */\n async getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot> {\n const subject = await getSubject()\n if (!subject) return { roles: [...EMPTY_SNAPSHOT.roles], permissions: [...EMPTY_SNAPSHOT.permissions] }\n return (await forSubject(subject, scope)).snapshot()\n },\n\n async can(permission: string, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).can(permission) : false\n },\n\n async canAny(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAny(permissions) : false\n },\n\n async canAll(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAll(permissions) : false\n },\n\n /** `true` if the user has the role — or ANY of the roles when given an array. */\n async hasRole(role: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAnyRole(role) : false\n },\n\n async hasAllRoles(roles: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAllRoles(roles) : false\n },\n\n /**\n * Ensures the user has the permission (or ANY of the permissions). Returns the subject.\n * Guests: `redirect(loginUrl)` or `notFound()`. Missing permission: `notFound()`. Both configurable.\n */\n requirePermission(permission: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ permission }, opts)\n },\n\n /** Ensures the user has the role (or ANY of the roles). Returns the subject. */\n requireRole(role: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ role }, opts)\n },\n\n /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */\n requireRoleOrPermission(items: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ roleOrPermission: items }, opts)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */\n withPermission<Args extends unknown[], R>(\n permission: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ permission }, action, scope)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */\n withRole<Args extends unknown[], R>(\n role: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ role }, action, scope)\n },\n\n /**\n * Wraps a route handler. Responds `401` (guest) or `403` (missing role/permission) with a JSON body.\n * Mirrors spatie's `permission`, `role` and `role_or_permission` middleware.\n */\n withRbac<Args extends unknown[]>(\n handler: (...args: Args) => MaybePromise<Response>,\n options: WithRbacOptions,\n ): (...args: Args) => Promise<Response> {\n const { guard, team, ...requirement } = options\n const scope: ScopeOptions = {}\n if (guard !== undefined) scope.guard = guard\n if (team !== undefined) scope.team = team\n return async (...args: Args): Promise<Response> => {\n const result = await authorize(requirement as Requirement, scope)\n if (result.ok) return handler(...args)\n return result.reason === 'unauthenticated'\n ? unauthenticatedResponse()\n : forbiddenResponse(requirement as Requirement)\n }\n },\n }\n}\n\nexport type NextRbac = ReturnType<typeof createNextRbac>\n","const cache = new Map<string, RegExp>()\n\nconst escape = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * Compiles a Next.js-style path pattern to a RegExp.\n *\n * - `/admin` matches `/admin` (and `/admin/`)\n * - `/users/:id` matches one segment\n * - `/admin/:path*` matches `/admin`, `/admin/a`, `/admin/a/b`\n * - `/admin/:path+` matches `/admin/a`, `/admin/a/b` (not `/admin`)\n * - `/blog/:slug?` matches `/blog` and `/blog/x`\n */\nexport function compilePathPattern(pattern: string): RegExp {\n const hit = cache.get(pattern)\n if (hit) return hit\n\n let source = ''\n for (const segment of pattern.split('/')) {\n if (segment === '') continue\n const param = /^:[A-Za-z_][A-Za-z0-9_]*([*+?])?$/.exec(segment)\n if (!param) {\n source += `/${escape(segment)}`\n continue\n }\n switch (param[1]) {\n case '*':\n source += '(?:/[^/]+)*'\n break\n case '+':\n source += '(?:/[^/]+)+'\n break\n case '?':\n source += '(?:/[^/]+)?'\n break\n default:\n source += '/[^/]+'\n }\n }\n const regex = new RegExp(`^${source}/?$`)\n cache.set(pattern, regex)\n return regex\n}\n\nexport type PathMatcher = string | RegExp | readonly (string | RegExp)[]\n\n/** `true` if the pathname matches the pattern (or any of the patterns). */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n if (matcher instanceof RegExp) return matcher.test(pathname)\n return matcher.some((m) => matchPath(m, pathname))\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport type { Requirement } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n}\n\nconst toList = (value: Many<string>): readonly string[] => (typeof value === 'string' ? [value] : value)\n\nfunction safeImplies(granted: string, required: string): boolean {\n try {\n return wildcardImplies(granted, required)\n } catch {\n return false\n }\n}\n\n/** Synchronously checks a requirement against a snapshot. Arrays mean \"any of\". */\nexport function snapshotSatisfies(\n snapshot: RbacSnapshot,\n requirement: Requirement,\n options: SnapshotCheckOptions = {},\n): boolean {\n const roles = new Set(snapshot.roles)\n const isSuperAdmin = (options.superAdminRoles ?? []).some((r) => roles.has(r))\n const hasRole = (role: string): boolean => roles.has(role.trim())\n const can = (permission: string): boolean => {\n if (isSuperAdmin) return true\n const name = permission.trim()\n if (name === '') return false\n if (snapshot.permissions.includes(name)) return true\n return (options.wildcard ?? false) && snapshot.permissions.some((g) => safeImplies(g, name))\n }\n\n if (requirement.permission !== undefined) return toList(requirement.permission).some(can)\n if (requirement.role !== undefined) return toList(requirement.role).some(hasRole)\n const items = toList(requirement.roleOrPermission)\n return items.some(hasRole) || items.some(can)\n}\n","import type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { matchPath } from './matcher'\nimport type { PathMatcher } from './matcher'\nimport { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport { snapshotSatisfies, type SnapshotCheckOptions } from './snapshot'\nimport type { MaybePromise, Requirement } from './types'\n\nexport interface RbacMiddlewareRule {\n /** Path pattern(s): `/admin`, `/users/:id`, `/admin/:path*`, or a RegExp. */\n matcher: PathMatcher\n /** Requires the permission (or ANY of them). */\n permission?: Many<string>\n /** Requires the role (or ANY of them). */\n role?: Many<string>\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string>\n // A rule with none of the above only requires an authenticated user.\n}\n\n/** The request as seen by middleware. `NextRequest` fits; `nextUrl.pathname` is preferred (it excludes `basePath`). */\nexport type MiddlewareRequest = Request & { nextUrl?: { pathname: string } }\n\ninterface BaseOptions<Req extends MiddlewareRequest> {\n /** Every matching rule must pass. Requests matching no rule pass through. */\n rules: readonly RbacMiddlewareRule[]\n /** Redirect guests here (relative to the request URL). Without it, guests get a `401` JSON response. */\n loginUrl?: string | ((req: Req) => string | URL)\n /** Custom response for guests. */\n onUnauthenticated?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n}\n\n/** Loads roles & permissions through an `Rbac` instance (DB adapters need the Node.js middleware runtime). */\nexport interface RbacMiddlewareWithRbac<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n rbac: Rbac\n getSubject: (req: Req) => MaybePromise<Subject | null | undefined>\n guard?: string\n team?: TeamId | ((req: Req) => MaybePromise<TeamId | undefined>)\n getSnapshot?: never\n}\n\n/** Reads roles & permissions from somewhere cheap, e.g. the session/JWT. Works in the Edge runtime. */\nexport interface RbacMiddlewareWithSnapshot<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n /** Return `null` for guests. */\n getSnapshot: (req: Req) => MaybePromise<RbacSnapshot | null | undefined>\n /** Must match the server's `wildcard` setting. Default: `false`. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n rbac?: never\n getSubject?: never\n}\n\nexport type RbacMiddlewareOptions<Req extends MiddlewareRequest = MiddlewareRequest> =\n | RbacMiddlewareWithRbac<Req>\n | RbacMiddlewareWithSnapshot<Req>\n\nfunction ruleRequirements(rule: RbacMiddlewareRule): Requirement[] {\n const out: Requirement[] = []\n if (rule.permission !== undefined) out.push({ permission: rule.permission })\n if (rule.role !== undefined) out.push({ role: rule.role })\n if (rule.roleOrPermission !== undefined) out.push({ roleOrPermission: rule.roleOrPermission })\n return out\n}\n\n/**\n * Route protection for `middleware.ts`, like spatie's route middleware.\n * Returns a `Response` when access is denied, or `undefined` to let the request through.\n *\n * ```ts\n * export default createRbacMiddleware({\n * rules: [{ matcher: '/admin/:path*', role: 'admin' }],\n * getSnapshot: async (req) => (await getToken({ req }))?.rbac ?? null,\n * })\n * ```\n */\nexport function createRbacMiddleware<Req extends MiddlewareRequest = MiddlewareRequest>(\n options: RbacMiddlewareOptions<Req>,\n): (req: Req) => Promise<Response | undefined> {\n type Checker = (requirement: Requirement) => Promise<boolean>\n\n /**\n * Resolves who is asking and returns a requirement checker, or `null` for guests.\n * In `rbac` mode the checks go through the engine (`canAny` / `hasAnyRole`), so\n * `superAdminRoles` and the `before` hook apply exactly like in the server helpers.\n */\n async function loadChecker(req: Req): Promise<Checker | null> {\n if (options.rbac === undefined) {\n const snapshot = (await options.getSnapshot(req)) ?? null\n if (!snapshot) return null\n const checkOptions: SnapshotCheckOptions = { wildcard: options.wildcard ?? false }\n if (options.superAdminRoles) checkOptions.superAdminRoles = options.superAdminRoles\n return async (requirement) => snapshotSatisfies(snapshot, requirement, checkOptions)\n }\n const subject = (await options.getSubject(req)) ?? null\n if (!subject) return null\n const scope: ScopeOptions = {}\n if (options.guard !== undefined) scope.guard = options.guard\n const team = typeof options.team === 'function' ? await options.team(req) : options.team\n if (team !== undefined && team !== null) scope.team = team\n const s = options.rbac.for(subject, scope)\n return async (requirement) => {\n if (requirement.permission !== undefined) return s.canAny(requirement.permission)\n if (requirement.role !== undefined) return s.hasAnyRole(requirement.role)\n const items = requirement.roleOrPermission\n return (await s.hasAnyRole(items)) || (await s.canAny(items))\n }\n }\n\n return async (req: Req): Promise<Response | undefined> => {\n const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname\n const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname))\n if (matching.length === 0) return undefined\n\n const check = await loadChecker(req)\n if (!check) {\n const rule = matching[0]!\n if (options.onUnauthenticated) return options.onUnauthenticated(req, rule)\n if (options.loginUrl !== undefined) {\n const target = typeof options.loginUrl === 'function' ? options.loginUrl(req) : options.loginUrl\n return Response.redirect(new URL(target, req.url), 307)\n }\n return unauthenticatedResponse()\n }\n\n for (const rule of matching) {\n let failed: Requirement | undefined\n for (const requirement of ruleRequirements(rule)) {\n if (!(await check(requirement))) {\n failed = requirement\n break\n }\n }\n if (failed) {\n if (options.onUnauthorized) return options.onUnauthorized(req, rule)\n return forbiddenResponse(failed)\n }\n }\n return undefined\n }\n}\n"]}
package/dist/index.d.cts CHANGED
@@ -1,8 +1,13 @@
1
1
  import * as _anievo_id_rbac_evolution from '@anievo-id/rbac-evolution';
2
2
  import { Subject, Rbac, TeamId, ScopeOptions, RbacSnapshot, Many } from '@anievo-id/rbac-evolution';
3
- import { M as MaybePromise, R as Requirement, F as FailureReason } from './middleware-entry-Bh8jQj1L.cjs';
3
+ import { R as Requirement, M as MaybePromise, F as FailureReason } from './middleware-entry-Bh8jQj1L.cjs';
4
4
  export { a as MiddlewareRequest, P as PathMatcher, b as RbacMiddlewareOptions, c as RbacMiddlewareRule, d as RbacMiddlewareWithRbac, e as RbacMiddlewareWithSnapshot, S as SnapshotCheckOptions, f as compilePathPattern, g as createRbacMiddleware, m as matchPath, s as snapshotSatisfies } from './middleware-entry-Bh8jQj1L.cjs';
5
5
 
6
+ /** Which kind of requirement failed — same values as the Express package. */
7
+ type ForbiddenReason = 'permission' | 'role' | 'role_or_permission';
8
+ /** Like spatie, the message names the kind of requirement but not the role/permission names. */
9
+ declare function forbiddenMessage(requirement: Requirement): string;
10
+
6
11
  interface NextRbacOptions {
7
12
  /** Your `createRbac(...)` instance. */
8
13
  rbac: Rbac;
@@ -38,8 +43,7 @@ type AuthorizeResult = {
38
43
  subject: Subject;
39
44
  };
40
45
  type WithRbacOptions = Requirement & ScopeOptions;
41
- /** Like spatie, the message names the kind of requirement but not the role/permission names. */
42
- declare function forbiddenMessage(requirement: Requirement): string;
46
+
43
47
  /**
44
48
  * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).
45
49
  *
@@ -96,4 +100,4 @@ declare class RbacUnauthorizedError extends Error {
96
100
  constructor(reason: FailureReason, message?: string);
97
101
  }
98
102
 
99
- export { type AuthorizeResult, FailureReason, MaybePromise, type NextRbac, type NextRbacOptions, RbacUnauthorizedError, type RequireOptions, Requirement, type WithRbacOptions, createNextRbac, forbiddenMessage };
103
+ export { type AuthorizeResult, FailureReason, type ForbiddenReason, MaybePromise, type NextRbac, type NextRbacOptions, RbacUnauthorizedError, type RequireOptions, Requirement, type WithRbacOptions, createNextRbac, forbiddenMessage };
package/dist/index.d.ts CHANGED
@@ -1,8 +1,13 @@
1
1
  import * as _anievo_id_rbac_evolution from '@anievo-id/rbac-evolution';
2
2
  import { Subject, Rbac, TeamId, ScopeOptions, RbacSnapshot, Many } from '@anievo-id/rbac-evolution';
3
- import { M as MaybePromise, R as Requirement, F as FailureReason } from './middleware-entry-Bh8jQj1L.js';
3
+ import { R as Requirement, M as MaybePromise, F as FailureReason } from './middleware-entry-Bh8jQj1L.js';
4
4
  export { a as MiddlewareRequest, P as PathMatcher, b as RbacMiddlewareOptions, c as RbacMiddlewareRule, d as RbacMiddlewareWithRbac, e as RbacMiddlewareWithSnapshot, S as SnapshotCheckOptions, f as compilePathPattern, g as createRbacMiddleware, m as matchPath, s as snapshotSatisfies } from './middleware-entry-Bh8jQj1L.js';
5
5
 
6
+ /** Which kind of requirement failed — same values as the Express package. */
7
+ type ForbiddenReason = 'permission' | 'role' | 'role_or_permission';
8
+ /** Like spatie, the message names the kind of requirement but not the role/permission names. */
9
+ declare function forbiddenMessage(requirement: Requirement): string;
10
+
6
11
  interface NextRbacOptions {
7
12
  /** Your `createRbac(...)` instance. */
8
13
  rbac: Rbac;
@@ -38,8 +43,7 @@ type AuthorizeResult = {
38
43
  subject: Subject;
39
44
  };
40
45
  type WithRbacOptions = Requirement & ScopeOptions;
41
- /** Like spatie, the message names the kind of requirement but not the role/permission names. */
42
- declare function forbiddenMessage(requirement: Requirement): string;
46
+
43
47
  /**
44
48
  * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).
45
49
  *
@@ -96,4 +100,4 @@ declare class RbacUnauthorizedError extends Error {
96
100
  constructor(reason: FailureReason, message?: string);
97
101
  }
98
102
 
99
- export { type AuthorizeResult, FailureReason, MaybePromise, type NextRbac, type NextRbacOptions, RbacUnauthorizedError, type RequireOptions, Requirement, type WithRbacOptions, createNextRbac, forbiddenMessage };
103
+ export { type AuthorizeResult, FailureReason, type ForbiddenReason, MaybePromise, type NextRbac, type NextRbacOptions, RbacUnauthorizedError, type RequireOptions, Requirement, type WithRbacOptions, createNextRbac, forbiddenMessage };
package/dist/index.js CHANGED
@@ -1,4 +1,5 @@
1
- export { compilePathPattern, createRbacMiddleware, matchPath, snapshotSatisfies } from './chunk-QGRA2JHH.js';
1
+ import { unauthenticatedResponse, forbiddenResponse } from './chunk-L3PCX3HA.js';
2
+ export { compilePathPattern, createRbacMiddleware, forbiddenMessage, matchPath, snapshotSatisfies } from './chunk-L3PCX3HA.js';
2
3
  import { redirect, notFound } from 'next/navigation';
3
4
 
4
5
  // src/errors.ts
@@ -16,11 +17,6 @@ var RbacUnauthorizedError = class extends Error {
16
17
  };
17
18
 
18
19
  // src/server.ts
19
- function forbiddenMessage(requirement) {
20
- if (requirement.permission !== void 0) return "User does not have the right permissions.";
21
- if (requirement.role !== void 0) return "User does not have the right roles.";
22
- return "User does not have any of the necessary access rights.";
23
- }
24
20
  var EMPTY_SNAPSHOT = { roles: [], permissions: [] };
25
21
  function createNextRbac(options) {
26
22
  const { rbac } = options;
@@ -148,12 +144,12 @@ function createNextRbac(options) {
148
144
  return async (...args) => {
149
145
  const result = await authorize(requirement, scope);
150
146
  if (result.ok) return handler(...args);
151
- return result.reason === "unauthenticated" ? Response.json({ error: "Unauthenticated", message: "Unauthenticated." }, { status: 401 }) : Response.json({ error: "Forbidden", message: forbiddenMessage(requirement) }, { status: 403 });
147
+ return result.reason === "unauthenticated" ? unauthenticatedResponse() : forbiddenResponse(requirement);
152
148
  };
153
149
  }
154
150
  };
155
151
  }
156
152
 
157
- export { RbacUnauthorizedError, createNextRbac, forbiddenMessage };
153
+ export { RbacUnauthorizedError, createNextRbac };
158
154
  //# sourceMappingURL=index.js.map
159
155
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/server.ts"],"names":["options"],"mappings":"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","file":"index.js","sourcesContent":["import type { FailureReason } from './types'\n\n/** Thrown by `withPermission()` / `withRole()` wrapped server actions when access is denied. */\nexport class RbacUnauthorizedError extends Error {\n /** `unauthenticated` (no subject) or `unauthorized` (missing role/permission). */\n readonly reason: FailureReason\n /** HTTP-style status: `401` or `403`. */\n readonly status: 401 | 403\n\n constructor(reason: FailureReason, message?: string) {\n super(message ?? (reason === 'unauthenticated' ? 'Unauthenticated.' : 'This action is unauthorized.'))\n this.name = 'RbacUnauthorizedError'\n this.reason = reason\n this.status = reason === 'unauthenticated' ? 401 : 403\n }\n}\n","import { notFound, redirect } from 'next/navigation'\nimport type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { RbacUnauthorizedError } from './errors'\nimport type { FailureReason, MaybePromise, Requirement } from './types'\n\nexport interface NextRbacOptions {\n /** Your `createRbac(...)` instance. */\n rbac: Rbac\n /** Resolves the current user (e.g. from Auth.js `auth()`). Return `null` for guests. */\n getSubject: () => MaybePromise<Subject | null | undefined>\n /** Default guard for every check. Default: the rbac instance's `defaultGuard`. */\n guard?: string\n /** Default team for every check — a value, or a function (e.g. reading the current tenant). */\n team?: TeamId | (() => MaybePromise<TeamId | undefined>)\n /** Where `require*()` redirects guests. Without it, guests get `notFound()`. */\n loginUrl?: string\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: () => never\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: () => never\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n loginUrl?: string\n onUnauthenticated?: () => never\n onUnauthorized?: () => never\n}\n\nexport type AuthorizeResult =\n | { ok: true; subject: Subject }\n | { ok: false; reason: 'unauthenticated'; subject: null }\n | { ok: false; reason: 'unauthorized'; subject: Subject }\n\nexport type WithRbacOptions = Requirement & ScopeOptions\n\n/** Like spatie, the message names the kind of requirement but not the role/permission names. */\nexport function forbiddenMessage(requirement: Requirement): string {\n if (requirement.permission !== undefined) return 'User does not have the right permissions.'\n if (requirement.role !== undefined) return 'User does not have the right roles.'\n return 'User does not have any of the necessary access rights.'\n}\n\nconst EMPTY_SNAPSHOT: RbacSnapshot = { roles: [], permissions: [] }\n\n\n\n/**\n * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).\n *\n * ```ts\n * // lib/rbac.ts\n * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({\n * rbac,\n * getSubject: async () => {\n * const session = await auth()\n * return session?.user ? { type: 'user', id: session.user.id } : null\n * },\n * })\n * ```\n */\nexport function createNextRbac(options: NextRbacOptions) {\n const { rbac } = options\n\n async function getSubject(): Promise<Subject | null> {\n return (await options.getSubject()) ?? null\n }\n\n async function resolveScope(scope: ScopeOptions = {}): Promise<ScopeOptions> {\n const guard = scope.guard ?? options.guard\n let team: TeamId | undefined = scope.team\n if (team === undefined) {\n team = typeof options.team === 'function' ? await options.team() : options.team\n }\n const out: ScopeOptions = {}\n if (guard !== undefined) out.guard = guard\n if (team !== undefined && team !== null) out.team = team\n return out\n }\n\n async function forSubject(subject: Subject, scope?: ScopeOptions) {\n return rbac.for(subject, await resolveScope(scope))\n }\n\n async function satisfies(subject: Subject, requirement: Requirement, scope?: ScopeOptions): Promise<boolean> {\n const s = await forSubject(subject, scope)\n if (requirement.permission !== undefined) return s.canAny(requirement.permission)\n if (requirement.role !== undefined) return s.hasAnyRole(requirement.role)\n const items = requirement.roleOrPermission\n return (await s.hasAnyRole(items)) || (await s.canAny(items))\n }\n\n /** Non-throwing check: who is the user and do they meet the requirement? */\n async function authorize(requirement: Requirement, scope?: ScopeOptions): Promise<AuthorizeResult> {\n const subject = await getSubject()\n if (!subject) return { ok: false, reason: 'unauthenticated', subject: null }\n if (!(await satisfies(subject, requirement, scope))) return { ok: false, reason: 'unauthorized', subject }\n return { ok: true, subject }\n }\n\n function fail(reason: FailureReason, opts: RequireOptions): never {\n if (reason === 'unauthenticated') {\n const handler = opts.onUnauthenticated ?? options.onUnauthenticated\n if (handler) handler()\n else {\n const loginUrl = opts.loginUrl ?? options.loginUrl\n if (loginUrl !== undefined) redirect(loginUrl)\n notFound()\n }\n } else {\n const handler = opts.onUnauthorized ?? options.onUnauthorized\n if (handler) handler()\n else notFound()\n }\n // Safety net in case a custom handler returned instead of throwing.\n throw new RbacUnauthorizedError(reason)\n }\n\n async function enforce(requirement: Requirement, opts: RequireOptions = {}): Promise<Subject> {\n const result = await authorize(requirement, opts)\n if (!result.ok) fail(result.reason, opts)\n return result.subject\n }\n\n function guardAction<Args extends unknown[], R>(\n requirement: Requirement,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return async (...args: Args): Promise<R> => {\n const result = await authorize(requirement, scope)\n if (!result.ok) throw new RbacUnauthorizedError(result.reason)\n return action(...args)\n }\n }\n\n return {\n rbac,\n getSubject,\n authorize,\n\n /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */\n async getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot> {\n const subject = await getSubject()\n if (!subject) return { roles: [...EMPTY_SNAPSHOT.roles], permissions: [...EMPTY_SNAPSHOT.permissions] }\n return (await forSubject(subject, scope)).snapshot()\n },\n\n async can(permission: string, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).can(permission) : false\n },\n\n async canAny(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAny(permissions) : false\n },\n\n async canAll(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAll(permissions) : false\n },\n\n /** `true` if the user has the role — or ANY of the roles when given an array. */\n async hasRole(role: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAnyRole(role) : false\n },\n\n async hasAllRoles(roles: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAllRoles(roles) : false\n },\n\n /**\n * Ensures the user has the permission (or ANY of the permissions). Returns the subject.\n * Guests: `redirect(loginUrl)` or `notFound()`. Missing permission: `notFound()`. Both configurable.\n */\n requirePermission(permission: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ permission }, opts)\n },\n\n /** Ensures the user has the role (or ANY of the roles). Returns the subject. */\n requireRole(role: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ role }, opts)\n },\n\n /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */\n requireRoleOrPermission(items: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ roleOrPermission: items }, opts)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */\n withPermission<Args extends unknown[], R>(\n permission: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ permission }, action, scope)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */\n withRole<Args extends unknown[], R>(\n role: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ role }, action, scope)\n },\n\n /**\n * Wraps a route handler. Responds `401` (guest) or `403` (missing role/permission) with a JSON body.\n * Mirrors spatie's `permission`, `role` and `role_or_permission` middleware.\n */\n withRbac<Args extends unknown[]>(\n handler: (...args: Args) => MaybePromise<Response>,\n options: WithRbacOptions,\n ): (...args: Args) => Promise<Response> {\n const { guard, team, ...requirement } = options\n const scope: ScopeOptions = {}\n if (guard !== undefined) scope.guard = guard\n if (team !== undefined) scope.team = team\n return async (...args: Args): Promise<Response> => {\n const result = await authorize(requirement as Requirement, scope)\n if (result.ok) return handler(...args)\n return result.reason === 'unauthenticated'\n ? Response.json({ error: 'Unauthenticated', message: 'Unauthenticated.' }, { status: 401 })\n : Response.json({ error: 'Forbidden', message: forbiddenMessage(requirement as Requirement) }, { status: 403 })\n }\n },\n }\n}\n\nexport type NextRbac = ReturnType<typeof createNextRbac>\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/server.ts"],"names":["options"],"mappings":"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","file":"index.js","sourcesContent":["import type { FailureReason } from './types'\n\n/** Thrown by `withPermission()` / `withRole()` wrapped server actions when access is denied. */\nexport class RbacUnauthorizedError extends Error {\n /** `unauthenticated` (no subject) or `unauthorized` (missing role/permission). */\n readonly reason: FailureReason\n /** HTTP-style status: `401` or `403`. */\n readonly status: 401 | 403\n\n constructor(reason: FailureReason, message?: string) {\n super(message ?? (reason === 'unauthenticated' ? 'Unauthenticated.' : 'This action is unauthorized.'))\n this.name = 'RbacUnauthorizedError'\n this.reason = reason\n this.status = reason === 'unauthenticated' ? 401 : 403\n }\n}\n","import { notFound, redirect } from 'next/navigation'\nimport type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { RbacUnauthorizedError } from './errors'\nimport { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport type { FailureReason, MaybePromise, Requirement } from './types'\n\nexport interface NextRbacOptions {\n /** Your `createRbac(...)` instance. */\n rbac: Rbac\n /** Resolves the current user (e.g. from Auth.js `auth()`). Return `null` for guests. */\n getSubject: () => MaybePromise<Subject | null | undefined>\n /** Default guard for every check. Default: the rbac instance's `defaultGuard`. */\n guard?: string\n /** Default team for every check — a value, or a function (e.g. reading the current tenant). */\n team?: TeamId | (() => MaybePromise<TeamId | undefined>)\n /** Where `require*()` redirects guests. Without it, guests get `notFound()`. */\n loginUrl?: string\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: () => never\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: () => never\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n loginUrl?: string\n onUnauthenticated?: () => never\n onUnauthorized?: () => never\n}\n\nexport type AuthorizeResult =\n | { ok: true; subject: Subject }\n | { ok: false; reason: 'unauthenticated'; subject: null }\n | { ok: false; reason: 'unauthorized'; subject: Subject }\n\nexport type WithRbacOptions = Requirement & ScopeOptions\n\nexport { forbiddenMessage } from './responses'\n\nconst EMPTY_SNAPSHOT: RbacSnapshot = { roles: [], permissions: [] }\n\n\n\n/**\n * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).\n *\n * ```ts\n * // lib/rbac.ts\n * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({\n * rbac,\n * getSubject: async () => {\n * const session = await auth()\n * return session?.user ? { type: 'user', id: session.user.id } : null\n * },\n * })\n * ```\n */\nexport function createNextRbac(options: NextRbacOptions) {\n const { rbac } = options\n\n async function getSubject(): Promise<Subject | null> {\n return (await options.getSubject()) ?? null\n }\n\n async function resolveScope(scope: ScopeOptions = {}): Promise<ScopeOptions> {\n const guard = scope.guard ?? options.guard\n let team: TeamId | undefined = scope.team\n if (team === undefined) {\n team = typeof options.team === 'function' ? await options.team() : options.team\n }\n const out: ScopeOptions = {}\n if (guard !== undefined) out.guard = guard\n if (team !== undefined && team !== null) out.team = team\n return out\n }\n\n async function forSubject(subject: Subject, scope?: ScopeOptions) {\n return rbac.for(subject, await resolveScope(scope))\n }\n\n async function satisfies(subject: Subject, requirement: Requirement, scope?: ScopeOptions): Promise<boolean> {\n const s = await forSubject(subject, scope)\n if (requirement.permission !== undefined) return s.canAny(requirement.permission)\n if (requirement.role !== undefined) return s.hasAnyRole(requirement.role)\n const items = requirement.roleOrPermission\n return (await s.hasAnyRole(items)) || (await s.canAny(items))\n }\n\n /** Non-throwing check: who is the user and do they meet the requirement? */\n async function authorize(requirement: Requirement, scope?: ScopeOptions): Promise<AuthorizeResult> {\n const subject = await getSubject()\n if (!subject) return { ok: false, reason: 'unauthenticated', subject: null }\n if (!(await satisfies(subject, requirement, scope))) return { ok: false, reason: 'unauthorized', subject }\n return { ok: true, subject }\n }\n\n function fail(reason: FailureReason, opts: RequireOptions): never {\n if (reason === 'unauthenticated') {\n const handler = opts.onUnauthenticated ?? options.onUnauthenticated\n if (handler) handler()\n else {\n const loginUrl = opts.loginUrl ?? options.loginUrl\n if (loginUrl !== undefined) redirect(loginUrl)\n notFound()\n }\n } else {\n const handler = opts.onUnauthorized ?? options.onUnauthorized\n if (handler) handler()\n else notFound()\n }\n // Safety net in case a custom handler returned instead of throwing.\n throw new RbacUnauthorizedError(reason)\n }\n\n async function enforce(requirement: Requirement, opts: RequireOptions = {}): Promise<Subject> {\n const result = await authorize(requirement, opts)\n if (!result.ok) fail(result.reason, opts)\n return result.subject\n }\n\n function guardAction<Args extends unknown[], R>(\n requirement: Requirement,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return async (...args: Args): Promise<R> => {\n const result = await authorize(requirement, scope)\n if (!result.ok) throw new RbacUnauthorizedError(result.reason)\n return action(...args)\n }\n }\n\n return {\n rbac,\n getSubject,\n authorize,\n\n /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */\n async getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot> {\n const subject = await getSubject()\n if (!subject) return { roles: [...EMPTY_SNAPSHOT.roles], permissions: [...EMPTY_SNAPSHOT.permissions] }\n return (await forSubject(subject, scope)).snapshot()\n },\n\n async can(permission: string, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).can(permission) : false\n },\n\n async canAny(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAny(permissions) : false\n },\n\n async canAll(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).canAll(permissions) : false\n },\n\n /** `true` if the user has the role — or ANY of the roles when given an array. */\n async hasRole(role: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAnyRole(role) : false\n },\n\n async hasAllRoles(roles: Many<string>, scope?: ScopeOptions): Promise<boolean> {\n const subject = await getSubject()\n return subject ? (await forSubject(subject, scope)).hasAllRoles(roles) : false\n },\n\n /**\n * Ensures the user has the permission (or ANY of the permissions). Returns the subject.\n * Guests: `redirect(loginUrl)` or `notFound()`. Missing permission: `notFound()`. Both configurable.\n */\n requirePermission(permission: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ permission }, opts)\n },\n\n /** Ensures the user has the role (or ANY of the roles). Returns the subject. */\n requireRole(role: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ role }, opts)\n },\n\n /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */\n requireRoleOrPermission(items: Many<string>, opts?: RequireOptions): Promise<Subject> {\n return enforce({ roleOrPermission: items }, opts)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */\n withPermission<Args extends unknown[], R>(\n permission: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ permission }, action, scope)\n },\n\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */\n withRole<Args extends unknown[], R>(\n role: Many<string>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions,\n ): (...args: Args) => Promise<R> {\n return guardAction({ role }, action, scope)\n },\n\n /**\n * Wraps a route handler. Responds `401` (guest) or `403` (missing role/permission) with a JSON body.\n * Mirrors spatie's `permission`, `role` and `role_or_permission` middleware.\n */\n withRbac<Args extends unknown[]>(\n handler: (...args: Args) => MaybePromise<Response>,\n options: WithRbacOptions,\n ): (...args: Args) => Promise<Response> {\n const { guard, team, ...requirement } = options\n const scope: ScopeOptions = {}\n if (guard !== undefined) scope.guard = guard\n if (team !== undefined) scope.team = team\n return async (...args: Args): Promise<Response> => {\n const result = await authorize(requirement as Requirement, scope)\n if (result.ok) return handler(...args)\n return result.reason === 'unauthenticated'\n ? unauthenticatedResponse()\n : forbiddenResponse(requirement as Requirement)\n }\n },\n }\n}\n\nexport type NextRbac = ReturnType<typeof createNextRbac>\n"]}
@@ -39,6 +39,32 @@ function matchPath(matcher, pathname) {
39
39
  if (matcher instanceof RegExp) return matcher.test(pathname);
40
40
  return matcher.some((m) => matchPath(m, pathname));
41
41
  }
42
+
43
+ // src/responses.ts
44
+ function forbiddenReason(requirement) {
45
+ if (requirement.permission !== void 0) return "permission";
46
+ if (requirement.role !== void 0) return "role";
47
+ return "role_or_permission";
48
+ }
49
+ function forbiddenMessage(requirement) {
50
+ switch (forbiddenReason(requirement)) {
51
+ case "permission":
52
+ return "User does not have the right permissions.";
53
+ case "role":
54
+ return "User does not have the right roles.";
55
+ default:
56
+ return "User does not have any of the necessary access rights.";
57
+ }
58
+ }
59
+ function unauthenticatedResponse() {
60
+ return Response.json({ error: "UNAUTHENTICATED", message: "User is not logged in." }, { status: 401 });
61
+ }
62
+ function forbiddenResponse(requirement) {
63
+ return Response.json(
64
+ { error: "FORBIDDEN", reason: forbiddenReason(requirement), message: forbiddenMessage(requirement) },
65
+ { status: 403 }
66
+ );
67
+ }
42
68
  var toList = (value) => typeof value === "string" ? [value] : value;
43
69
  function safeImplies(granted, required) {
44
70
  try {
@@ -72,12 +98,14 @@ function ruleRequirements(rule) {
72
98
  if (rule.roleOrPermission !== void 0) out.push({ roleOrPermission: rule.roleOrPermission });
73
99
  return out;
74
100
  }
75
- var json = (status, error, message) => new Response(JSON.stringify({ error, message }), { status, headers: { "content-type": "application/json" } });
76
101
  function createRbacMiddleware(options) {
77
- async function loadSnapshot(req) {
102
+ async function loadChecker(req) {
78
103
  if (options.rbac === void 0) {
79
104
  const snapshot = await options.getSnapshot(req) ?? null;
80
- return snapshot && { snapshot, wildcard: options.wildcard ?? false };
105
+ if (!snapshot) return null;
106
+ const checkOptions = { wildcard: options.wildcard ?? false };
107
+ if (options.superAdminRoles) checkOptions.superAdminRoles = options.superAdminRoles;
108
+ return async (requirement) => snapshotSatisfies(snapshot, requirement, checkOptions);
81
109
  }
82
110
  const subject = await options.getSubject(req) ?? null;
83
111
  if (!subject) return null;
@@ -85,28 +113,39 @@ function createRbacMiddleware(options) {
85
113
  if (options.guard !== void 0) scope.guard = options.guard;
86
114
  const team = typeof options.team === "function" ? await options.team(req) : options.team;
87
115
  if (team !== void 0 && team !== null) scope.team = team;
88
- return { snapshot: await options.rbac.for(subject, scope).snapshot(), wildcard: options.rbac.wildcard };
116
+ const s = options.rbac.for(subject, scope);
117
+ return async (requirement) => {
118
+ if (requirement.permission !== void 0) return s.canAny(requirement.permission);
119
+ if (requirement.role !== void 0) return s.hasAnyRole(requirement.role);
120
+ const items = requirement.roleOrPermission;
121
+ return await s.hasAnyRole(items) || await s.canAny(items);
122
+ };
89
123
  }
90
124
  return async (req) => {
91
125
  const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname;
92
126
  const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname));
93
127
  if (matching.length === 0) return void 0;
94
- const loaded = await loadSnapshot(req);
95
- if (!loaded) {
128
+ const check = await loadChecker(req);
129
+ if (!check) {
96
130
  const rule = matching[0];
97
131
  if (options.onUnauthenticated) return options.onUnauthenticated(req, rule);
98
132
  if (options.loginUrl !== void 0) {
99
133
  const target = typeof options.loginUrl === "function" ? options.loginUrl(req) : options.loginUrl;
100
134
  return Response.redirect(new URL(target, req.url), 307);
101
135
  }
102
- return json(401, "Unauthenticated", "Unauthenticated.");
136
+ return unauthenticatedResponse();
103
137
  }
104
- const checkOptions = options.rbac === void 0 && options.superAdminRoles ? { wildcard: loaded.wildcard, superAdminRoles: options.superAdminRoles } : { wildcard: loaded.wildcard };
105
138
  for (const rule of matching) {
106
- const passes = ruleRequirements(rule).every((r) => snapshotSatisfies(loaded.snapshot, r, checkOptions));
107
- if (!passes) {
139
+ let failed;
140
+ for (const requirement of ruleRequirements(rule)) {
141
+ if (!await check(requirement)) {
142
+ failed = requirement;
143
+ break;
144
+ }
145
+ }
146
+ if (failed) {
108
147
  if (options.onUnauthorized) return options.onUnauthorized(req, rule);
109
- return json(403, "Forbidden", "User does not have the right roles or permissions.");
148
+ return forbiddenResponse(failed);
110
149
  }
111
150
  }
112
151
  return void 0;
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/matcher.ts","../src/snapshot.ts","../src/middleware.ts"],"names":["wildcardImplies"],"mappings":"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","file":"middleware.cjs","sourcesContent":["const cache = new Map<string, RegExp>()\n\nconst escape = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * Compiles a Next.js-style path pattern to a RegExp.\n *\n * - `/admin` matches `/admin` (and `/admin/`)\n * - `/users/:id` matches one segment\n * - `/admin/:path*` matches `/admin`, `/admin/a`, `/admin/a/b`\n * - `/admin/:path+` matches `/admin/a`, `/admin/a/b` (not `/admin`)\n * - `/blog/:slug?` matches `/blog` and `/blog/x`\n */\nexport function compilePathPattern(pattern: string): RegExp {\n const hit = cache.get(pattern)\n if (hit) return hit\n\n let source = ''\n for (const segment of pattern.split('/')) {\n if (segment === '') continue\n const param = /^:[A-Za-z_][A-Za-z0-9_]*([*+?])?$/.exec(segment)\n if (!param) {\n source += `/${escape(segment)}`\n continue\n }\n switch (param[1]) {\n case '*':\n source += '(?:/[^/]+)*'\n break\n case '+':\n source += '(?:/[^/]+)+'\n break\n case '?':\n source += '(?:/[^/]+)?'\n break\n default:\n source += '/[^/]+'\n }\n }\n const regex = new RegExp(`^${source}/?$`)\n cache.set(pattern, regex)\n return regex\n}\n\nexport type PathMatcher = string | RegExp | readonly (string | RegExp)[]\n\n/** `true` if the pathname matches the pattern (or any of the patterns). */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n if (matcher instanceof RegExp) return matcher.test(pathname)\n return matcher.some((m) => matchPath(m, pathname))\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport type { Requirement } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n}\n\nconst toList = (value: Many<string>): readonly string[] => (typeof value === 'string' ? [value] : value)\n\nfunction safeImplies(granted: string, required: string): boolean {\n try {\n return wildcardImplies(granted, required)\n } catch {\n return false\n }\n}\n\n/** Synchronously checks a requirement against a snapshot. Arrays mean \"any of\". */\nexport function snapshotSatisfies(\n snapshot: RbacSnapshot,\n requirement: Requirement,\n options: SnapshotCheckOptions = {},\n): boolean {\n const roles = new Set(snapshot.roles)\n const isSuperAdmin = (options.superAdminRoles ?? []).some((r) => roles.has(r))\n const hasRole = (role: string): boolean => roles.has(role.trim())\n const can = (permission: string): boolean => {\n if (isSuperAdmin) return true\n const name = permission.trim()\n if (name === '') return false\n if (snapshot.permissions.includes(name)) return true\n return (options.wildcard ?? false) && snapshot.permissions.some((g) => safeImplies(g, name))\n }\n\n if (requirement.permission !== undefined) return toList(requirement.permission).some(can)\n if (requirement.role !== undefined) return toList(requirement.role).some(hasRole)\n const items = toList(requirement.roleOrPermission)\n return items.some(hasRole) || items.some(can)\n}\n","import type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { matchPath } from './matcher'\nimport type { PathMatcher } from './matcher'\nimport { snapshotSatisfies } from './snapshot'\nimport type { MaybePromise, Requirement } from './types'\n\nexport interface RbacMiddlewareRule {\n /** Path pattern(s): `/admin`, `/users/:id`, `/admin/:path*`, or a RegExp. */\n matcher: PathMatcher\n /** Requires the permission (or ANY of them). */\n permission?: Many<string>\n /** Requires the role (or ANY of them). */\n role?: Many<string>\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string>\n // A rule with none of the above only requires an authenticated user.\n}\n\n/** The request as seen by middleware. `NextRequest` fits; `nextUrl.pathname` is preferred (it excludes `basePath`). */\nexport type MiddlewareRequest = Request & { nextUrl?: { pathname: string } }\n\ninterface BaseOptions<Req extends MiddlewareRequest> {\n /** Every matching rule must pass. Requests matching no rule pass through. */\n rules: readonly RbacMiddlewareRule[]\n /** Redirect guests here (relative to the request URL). Without it, guests get a `401` JSON response. */\n loginUrl?: string | ((req: Req) => string | URL)\n /** Custom response for guests. */\n onUnauthenticated?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n}\n\n/** Loads roles & permissions through an `Rbac` instance (DB adapters need the Node.js middleware runtime). */\nexport interface RbacMiddlewareWithRbac<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n rbac: Rbac\n getSubject: (req: Req) => MaybePromise<Subject | null | undefined>\n guard?: string\n team?: TeamId | ((req: Req) => MaybePromise<TeamId | undefined>)\n getSnapshot?: never\n}\n\n/** Reads roles & permissions from somewhere cheap, e.g. the session/JWT. Works in the Edge runtime. */\nexport interface RbacMiddlewareWithSnapshot<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n /** Return `null` for guests. */\n getSnapshot: (req: Req) => MaybePromise<RbacSnapshot | null | undefined>\n /** Must match the server's `wildcard` setting. Default: `false`. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n rbac?: never\n getSubject?: never\n}\n\nexport type RbacMiddlewareOptions<Req extends MiddlewareRequest = MiddlewareRequest> =\n | RbacMiddlewareWithRbac<Req>\n | RbacMiddlewareWithSnapshot<Req>\n\nfunction ruleRequirements(rule: RbacMiddlewareRule): Requirement[] {\n const out: Requirement[] = []\n if (rule.permission !== undefined) out.push({ permission: rule.permission })\n if (rule.role !== undefined) out.push({ role: rule.role })\n if (rule.roleOrPermission !== undefined) out.push({ roleOrPermission: rule.roleOrPermission })\n return out\n}\n\nconst json = (status: number, error: string, message: string): Response =>\n new Response(JSON.stringify({ error, message }), { status, headers: { 'content-type': 'application/json' } })\n\n/**\n * Route protection for `middleware.ts`, like spatie's route middleware.\n * Returns a `Response` when access is denied, or `undefined` to let the request through.\n *\n * ```ts\n * export default createRbacMiddleware({\n * rules: [{ matcher: '/admin/:path*', role: 'admin' }],\n * getSnapshot: async (req) => (await getToken({ req }))?.rbac ?? null,\n * })\n * ```\n */\nexport function createRbacMiddleware<Req extends MiddlewareRequest = MiddlewareRequest>(\n options: RbacMiddlewareOptions<Req>,\n): (req: Req) => Promise<Response | undefined> {\n async function loadSnapshot(req: Req): Promise<{ snapshot: RbacSnapshot; wildcard: boolean } | null> {\n if (options.rbac === undefined) {\n const snapshot = (await options.getSnapshot(req)) ?? null\n return snapshot && { snapshot, wildcard: options.wildcard ?? false }\n }\n const subject = (await options.getSubject(req)) ?? null\n if (!subject) return null\n const scope: ScopeOptions = {}\n if (options.guard !== undefined) scope.guard = options.guard\n const team = typeof options.team === 'function' ? await options.team(req) : options.team\n if (team !== undefined && team !== null) scope.team = team\n return { snapshot: await options.rbac.for(subject, scope).snapshot(), wildcard: options.rbac.wildcard }\n }\n\n return async (req: Req): Promise<Response | undefined> => {\n const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname\n const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname))\n if (matching.length === 0) return undefined\n\n const loaded = await loadSnapshot(req)\n if (!loaded) {\n const rule = matching[0]!\n if (options.onUnauthenticated) return options.onUnauthenticated(req, rule)\n if (options.loginUrl !== undefined) {\n const target = typeof options.loginUrl === 'function' ? options.loginUrl(req) : options.loginUrl\n return Response.redirect(new URL(target, req.url), 307)\n }\n return json(401, 'Unauthenticated', 'Unauthenticated.')\n }\n\n const checkOptions =\n options.rbac === undefined && options.superAdminRoles\n ? { wildcard: loaded.wildcard, superAdminRoles: options.superAdminRoles }\n : { wildcard: loaded.wildcard }\n\n for (const rule of matching) {\n const passes = ruleRequirements(rule).every((r) => snapshotSatisfies(loaded.snapshot, r, checkOptions))\n if (!passes) {\n if (options.onUnauthorized) return options.onUnauthorized(req, rule)\n return json(403, 'Forbidden', 'User does not have the right roles or permissions.')\n }\n }\n return undefined\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/matcher.ts","../src/responses.ts","../src/snapshot.ts","../src/middleware.ts"],"names":["wildcardImplies"],"mappings":"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","file":"middleware.cjs","sourcesContent":["const cache = new Map<string, RegExp>()\n\nconst escape = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * Compiles a Next.js-style path pattern to a RegExp.\n *\n * - `/admin` matches `/admin` (and `/admin/`)\n * - `/users/:id` matches one segment\n * - `/admin/:path*` matches `/admin`, `/admin/a`, `/admin/a/b`\n * - `/admin/:path+` matches `/admin/a`, `/admin/a/b` (not `/admin`)\n * - `/blog/:slug?` matches `/blog` and `/blog/x`\n */\nexport function compilePathPattern(pattern: string): RegExp {\n const hit = cache.get(pattern)\n if (hit) return hit\n\n let source = ''\n for (const segment of pattern.split('/')) {\n if (segment === '') continue\n const param = /^:[A-Za-z_][A-Za-z0-9_]*([*+?])?$/.exec(segment)\n if (!param) {\n source += `/${escape(segment)}`\n continue\n }\n switch (param[1]) {\n case '*':\n source += '(?:/[^/]+)*'\n break\n case '+':\n source += '(?:/[^/]+)+'\n break\n case '?':\n source += '(?:/[^/]+)?'\n break\n default:\n source += '/[^/]+'\n }\n }\n const regex = new RegExp(`^${source}/?$`)\n cache.set(pattern, regex)\n return regex\n}\n\nexport type PathMatcher = string | RegExp | readonly (string | RegExp)[]\n\n/** `true` if the pathname matches the pattern (or any of the patterns). */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n if (matcher instanceof RegExp) return matcher.test(pathname)\n return matcher.some((m) => matchPath(m, pathname))\n}\n","import type { Requirement } from './types'\n\n/** Which kind of requirement failed — same values as the Express package. */\nexport type ForbiddenReason = 'permission' | 'role' | 'role_or_permission'\n\nexport function forbiddenReason(requirement: Requirement): ForbiddenReason {\n if (requirement.permission !== undefined) return 'permission'\n if (requirement.role !== undefined) return 'role'\n return 'role_or_permission'\n}\n\n/** Like spatie, the message names the kind of requirement but not the role/permission names. */\nexport function forbiddenMessage(requirement: Requirement): string {\n switch (forbiddenReason(requirement)) {\n case 'permission':\n return 'User does not have the right permissions.'\n case 'role':\n return 'User does not have the right roles.'\n default:\n return 'User does not have any of the necessary access rights.'\n }\n}\n\n/** `401 { error: 'UNAUTHENTICATED', message }` — same body as `@anievo-id/rbac-evolution-express`. */\nexport function unauthenticatedResponse(): Response {\n return Response.json({ error: 'UNAUTHENTICATED', message: 'User is not logged in.' }, { status: 401 })\n}\n\n/** `403 { error: 'FORBIDDEN', reason, message }` — same body as `@anievo-id/rbac-evolution-express`. */\nexport function forbiddenResponse(requirement: Requirement): Response {\n return Response.json(\n { error: 'FORBIDDEN', reason: forbiddenReason(requirement), message: forbiddenMessage(requirement) },\n { status: 403 },\n )\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport type { Requirement } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n}\n\nconst toList = (value: Many<string>): readonly string[] => (typeof value === 'string' ? [value] : value)\n\nfunction safeImplies(granted: string, required: string): boolean {\n try {\n return wildcardImplies(granted, required)\n } catch {\n return false\n }\n}\n\n/** Synchronously checks a requirement against a snapshot. Arrays mean \"any of\". */\nexport function snapshotSatisfies(\n snapshot: RbacSnapshot,\n requirement: Requirement,\n options: SnapshotCheckOptions = {},\n): boolean {\n const roles = new Set(snapshot.roles)\n const isSuperAdmin = (options.superAdminRoles ?? []).some((r) => roles.has(r))\n const hasRole = (role: string): boolean => roles.has(role.trim())\n const can = (permission: string): boolean => {\n if (isSuperAdmin) return true\n const name = permission.trim()\n if (name === '') return false\n if (snapshot.permissions.includes(name)) return true\n return (options.wildcard ?? false) && snapshot.permissions.some((g) => safeImplies(g, name))\n }\n\n if (requirement.permission !== undefined) return toList(requirement.permission).some(can)\n if (requirement.role !== undefined) return toList(requirement.role).some(hasRole)\n const items = toList(requirement.roleOrPermission)\n return items.some(hasRole) || items.some(can)\n}\n","import type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { matchPath } from './matcher'\nimport type { PathMatcher } from './matcher'\nimport { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport { snapshotSatisfies, type SnapshotCheckOptions } from './snapshot'\nimport type { MaybePromise, Requirement } from './types'\n\nexport interface RbacMiddlewareRule {\n /** Path pattern(s): `/admin`, `/users/:id`, `/admin/:path*`, or a RegExp. */\n matcher: PathMatcher\n /** Requires the permission (or ANY of them). */\n permission?: Many<string>\n /** Requires the role (or ANY of them). */\n role?: Many<string>\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string>\n // A rule with none of the above only requires an authenticated user.\n}\n\n/** The request as seen by middleware. `NextRequest` fits; `nextUrl.pathname` is preferred (it excludes `basePath`). */\nexport type MiddlewareRequest = Request & { nextUrl?: { pathname: string } }\n\ninterface BaseOptions<Req extends MiddlewareRequest> {\n /** Every matching rule must pass. Requests matching no rule pass through. */\n rules: readonly RbacMiddlewareRule[]\n /** Redirect guests here (relative to the request URL). Without it, guests get a `401` JSON response. */\n loginUrl?: string | ((req: Req) => string | URL)\n /** Custom response for guests. */\n onUnauthenticated?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n}\n\n/** Loads roles & permissions through an `Rbac` instance (DB adapters need the Node.js middleware runtime). */\nexport interface RbacMiddlewareWithRbac<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n rbac: Rbac\n getSubject: (req: Req) => MaybePromise<Subject | null | undefined>\n guard?: string\n team?: TeamId | ((req: Req) => MaybePromise<TeamId | undefined>)\n getSnapshot?: never\n}\n\n/** Reads roles & permissions from somewhere cheap, e.g. the session/JWT. Works in the Edge runtime. */\nexport interface RbacMiddlewareWithSnapshot<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n /** Return `null` for guests. */\n getSnapshot: (req: Req) => MaybePromise<RbacSnapshot | null | undefined>\n /** Must match the server's `wildcard` setting. Default: `false`. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n rbac?: never\n getSubject?: never\n}\n\nexport type RbacMiddlewareOptions<Req extends MiddlewareRequest = MiddlewareRequest> =\n | RbacMiddlewareWithRbac<Req>\n | RbacMiddlewareWithSnapshot<Req>\n\nfunction ruleRequirements(rule: RbacMiddlewareRule): Requirement[] {\n const out: Requirement[] = []\n if (rule.permission !== undefined) out.push({ permission: rule.permission })\n if (rule.role !== undefined) out.push({ role: rule.role })\n if (rule.roleOrPermission !== undefined) out.push({ roleOrPermission: rule.roleOrPermission })\n return out\n}\n\n/**\n * Route protection for `middleware.ts`, like spatie's route middleware.\n * Returns a `Response` when access is denied, or `undefined` to let the request through.\n *\n * ```ts\n * export default createRbacMiddleware({\n * rules: [{ matcher: '/admin/:path*', role: 'admin' }],\n * getSnapshot: async (req) => (await getToken({ req }))?.rbac ?? null,\n * })\n * ```\n */\nexport function createRbacMiddleware<Req extends MiddlewareRequest = MiddlewareRequest>(\n options: RbacMiddlewareOptions<Req>,\n): (req: Req) => Promise<Response | undefined> {\n type Checker = (requirement: Requirement) => Promise<boolean>\n\n /**\n * Resolves who is asking and returns a requirement checker, or `null` for guests.\n * In `rbac` mode the checks go through the engine (`canAny` / `hasAnyRole`), so\n * `superAdminRoles` and the `before` hook apply exactly like in the server helpers.\n */\n async function loadChecker(req: Req): Promise<Checker | null> {\n if (options.rbac === undefined) {\n const snapshot = (await options.getSnapshot(req)) ?? null\n if (!snapshot) return null\n const checkOptions: SnapshotCheckOptions = { wildcard: options.wildcard ?? false }\n if (options.superAdminRoles) checkOptions.superAdminRoles = options.superAdminRoles\n return async (requirement) => snapshotSatisfies(snapshot, requirement, checkOptions)\n }\n const subject = (await options.getSubject(req)) ?? null\n if (!subject) return null\n const scope: ScopeOptions = {}\n if (options.guard !== undefined) scope.guard = options.guard\n const team = typeof options.team === 'function' ? await options.team(req) : options.team\n if (team !== undefined && team !== null) scope.team = team\n const s = options.rbac.for(subject, scope)\n return async (requirement) => {\n if (requirement.permission !== undefined) return s.canAny(requirement.permission)\n if (requirement.role !== undefined) return s.hasAnyRole(requirement.role)\n const items = requirement.roleOrPermission\n return (await s.hasAnyRole(items)) || (await s.canAny(items))\n }\n }\n\n return async (req: Req): Promise<Response | undefined> => {\n const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname\n const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname))\n if (matching.length === 0) return undefined\n\n const check = await loadChecker(req)\n if (!check) {\n const rule = matching[0]!\n if (options.onUnauthenticated) return options.onUnauthenticated(req, rule)\n if (options.loginUrl !== undefined) {\n const target = typeof options.loginUrl === 'function' ? options.loginUrl(req) : options.loginUrl\n return Response.redirect(new URL(target, req.url), 307)\n }\n return unauthenticatedResponse()\n }\n\n for (const rule of matching) {\n let failed: Requirement | undefined\n for (const requirement of ruleRequirements(rule)) {\n if (!(await check(requirement))) {\n failed = requirement\n break\n }\n }\n if (failed) {\n if (options.onUnauthorized) return options.onUnauthorized(req, rule)\n return forbiddenResponse(failed)\n }\n }\n return undefined\n }\n}\n"]}
@@ -1,3 +1,3 @@
1
- export { compilePathPattern, createRbacMiddleware, matchPath, snapshotSatisfies } from './chunk-QGRA2JHH.js';
1
+ export { compilePathPattern, createRbacMiddleware, matchPath, snapshotSatisfies } from './chunk-L3PCX3HA.js';
2
2
  //# sourceMappingURL=middleware.js.map
3
3
  //# sourceMappingURL=middleware.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anievo-id/rbac-evolution-next",
3
- "version": "0.1.1",
3
+ "version": "0.2.1",
4
4
  "description": "Next.js helpers for rbac-evolution: middleware, server components & server action guards.",
5
5
  "license": "MIT",
6
6
  "author": "AniEvo-ID (https://github.com/AniEvo-ID)",
@@ -57,7 +57,7 @@
57
57
  "access": "public"
58
58
  },
59
59
  "dependencies": {
60
- "@anievo-id/rbac-evolution": "^0.1.1"
60
+ "@anievo-id/rbac-evolution": "^0.2.1"
61
61
  },
62
62
  "peerDependencies": {
63
63
  "next": ">=14",
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/matcher.ts","../src/snapshot.ts","../src/middleware.ts"],"names":[],"mappings":"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","file":"chunk-QGRA2JHH.js","sourcesContent":["const cache = new Map<string, RegExp>()\n\nconst escape = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * Compiles a Next.js-style path pattern to a RegExp.\n *\n * - `/admin` matches `/admin` (and `/admin/`)\n * - `/users/:id` matches one segment\n * - `/admin/:path*` matches `/admin`, `/admin/a`, `/admin/a/b`\n * - `/admin/:path+` matches `/admin/a`, `/admin/a/b` (not `/admin`)\n * - `/blog/:slug?` matches `/blog` and `/blog/x`\n */\nexport function compilePathPattern(pattern: string): RegExp {\n const hit = cache.get(pattern)\n if (hit) return hit\n\n let source = ''\n for (const segment of pattern.split('/')) {\n if (segment === '') continue\n const param = /^:[A-Za-z_][A-Za-z0-9_]*([*+?])?$/.exec(segment)\n if (!param) {\n source += `/${escape(segment)}`\n continue\n }\n switch (param[1]) {\n case '*':\n source += '(?:/[^/]+)*'\n break\n case '+':\n source += '(?:/[^/]+)+'\n break\n case '?':\n source += '(?:/[^/]+)?'\n break\n default:\n source += '/[^/]+'\n }\n }\n const regex = new RegExp(`^${source}/?$`)\n cache.set(pattern, regex)\n return regex\n}\n\nexport type PathMatcher = string | RegExp | readonly (string | RegExp)[]\n\n/** `true` if the pathname matches the pattern (or any of the patterns). */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n if (matcher instanceof RegExp) return matcher.test(pathname)\n return matcher.some((m) => matchPath(m, pathname))\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport type { Requirement } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n}\n\nconst toList = (value: Many<string>): readonly string[] => (typeof value === 'string' ? [value] : value)\n\nfunction safeImplies(granted: string, required: string): boolean {\n try {\n return wildcardImplies(granted, required)\n } catch {\n return false\n }\n}\n\n/** Synchronously checks a requirement against a snapshot. Arrays mean \"any of\". */\nexport function snapshotSatisfies(\n snapshot: RbacSnapshot,\n requirement: Requirement,\n options: SnapshotCheckOptions = {},\n): boolean {\n const roles = new Set(snapshot.roles)\n const isSuperAdmin = (options.superAdminRoles ?? []).some((r) => roles.has(r))\n const hasRole = (role: string): boolean => roles.has(role.trim())\n const can = (permission: string): boolean => {\n if (isSuperAdmin) return true\n const name = permission.trim()\n if (name === '') return false\n if (snapshot.permissions.includes(name)) return true\n return (options.wildcard ?? false) && snapshot.permissions.some((g) => safeImplies(g, name))\n }\n\n if (requirement.permission !== undefined) return toList(requirement.permission).some(can)\n if (requirement.role !== undefined) return toList(requirement.role).some(hasRole)\n const items = toList(requirement.roleOrPermission)\n return items.some(hasRole) || items.some(can)\n}\n","import type { Many, Rbac, RbacSnapshot, ScopeOptions, Subject, TeamId } from '@anievo-id/rbac-evolution'\nimport { matchPath } from './matcher'\nimport type { PathMatcher } from './matcher'\nimport { snapshotSatisfies } from './snapshot'\nimport type { MaybePromise, Requirement } from './types'\n\nexport interface RbacMiddlewareRule {\n /** Path pattern(s): `/admin`, `/users/:id`, `/admin/:path*`, or a RegExp. */\n matcher: PathMatcher\n /** Requires the permission (or ANY of them). */\n permission?: Many<string>\n /** Requires the role (or ANY of them). */\n role?: Many<string>\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string>\n // A rule with none of the above only requires an authenticated user.\n}\n\n/** The request as seen by middleware. `NextRequest` fits; `nextUrl.pathname` is preferred (it excludes `basePath`). */\nexport type MiddlewareRequest = Request & { nextUrl?: { pathname: string } }\n\ninterface BaseOptions<Req extends MiddlewareRequest> {\n /** Every matching rule must pass. Requests matching no rule pass through. */\n rules: readonly RbacMiddlewareRule[]\n /** Redirect guests here (relative to the request URL). Without it, guests get a `401` JSON response. */\n loginUrl?: string | ((req: Req) => string | URL)\n /** Custom response for guests. */\n onUnauthenticated?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: (req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>\n}\n\n/** Loads roles & permissions through an `Rbac` instance (DB adapters need the Node.js middleware runtime). */\nexport interface RbacMiddlewareWithRbac<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n rbac: Rbac\n getSubject: (req: Req) => MaybePromise<Subject | null | undefined>\n guard?: string\n team?: TeamId | ((req: Req) => MaybePromise<TeamId | undefined>)\n getSnapshot?: never\n}\n\n/** Reads roles & permissions from somewhere cheap, e.g. the session/JWT. Works in the Edge runtime. */\nexport interface RbacMiddlewareWithSnapshot<Req extends MiddlewareRequest> extends BaseOptions<Req> {\n /** Return `null` for guests. */\n getSnapshot: (req: Req) => MaybePromise<RbacSnapshot | null | undefined>\n /** Must match the server's `wildcard` setting. Default: `false`. */\n wildcard?: boolean\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[]\n rbac?: never\n getSubject?: never\n}\n\nexport type RbacMiddlewareOptions<Req extends MiddlewareRequest = MiddlewareRequest> =\n | RbacMiddlewareWithRbac<Req>\n | RbacMiddlewareWithSnapshot<Req>\n\nfunction ruleRequirements(rule: RbacMiddlewareRule): Requirement[] {\n const out: Requirement[] = []\n if (rule.permission !== undefined) out.push({ permission: rule.permission })\n if (rule.role !== undefined) out.push({ role: rule.role })\n if (rule.roleOrPermission !== undefined) out.push({ roleOrPermission: rule.roleOrPermission })\n return out\n}\n\nconst json = (status: number, error: string, message: string): Response =>\n new Response(JSON.stringify({ error, message }), { status, headers: { 'content-type': 'application/json' } })\n\n/**\n * Route protection for `middleware.ts`, like spatie's route middleware.\n * Returns a `Response` when access is denied, or `undefined` to let the request through.\n *\n * ```ts\n * export default createRbacMiddleware({\n * rules: [{ matcher: '/admin/:path*', role: 'admin' }],\n * getSnapshot: async (req) => (await getToken({ req }))?.rbac ?? null,\n * })\n * ```\n */\nexport function createRbacMiddleware<Req extends MiddlewareRequest = MiddlewareRequest>(\n options: RbacMiddlewareOptions<Req>,\n): (req: Req) => Promise<Response | undefined> {\n async function loadSnapshot(req: Req): Promise<{ snapshot: RbacSnapshot; wildcard: boolean } | null> {\n if (options.rbac === undefined) {\n const snapshot = (await options.getSnapshot(req)) ?? null\n return snapshot && { snapshot, wildcard: options.wildcard ?? false }\n }\n const subject = (await options.getSubject(req)) ?? null\n if (!subject) return null\n const scope: ScopeOptions = {}\n if (options.guard !== undefined) scope.guard = options.guard\n const team = typeof options.team === 'function' ? await options.team(req) : options.team\n if (team !== undefined && team !== null) scope.team = team\n return { snapshot: await options.rbac.for(subject, scope).snapshot(), wildcard: options.rbac.wildcard }\n }\n\n return async (req: Req): Promise<Response | undefined> => {\n const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname\n const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname))\n if (matching.length === 0) return undefined\n\n const loaded = await loadSnapshot(req)\n if (!loaded) {\n const rule = matching[0]!\n if (options.onUnauthenticated) return options.onUnauthenticated(req, rule)\n if (options.loginUrl !== undefined) {\n const target = typeof options.loginUrl === 'function' ? options.loginUrl(req) : options.loginUrl\n return Response.redirect(new URL(target, req.url), 307)\n }\n return json(401, 'Unauthenticated', 'Unauthenticated.')\n }\n\n const checkOptions =\n options.rbac === undefined && options.superAdminRoles\n ? { wildcard: loaded.wildcard, superAdminRoles: options.superAdminRoles }\n : { wildcard: loaded.wildcard }\n\n for (const rule of matching) {\n const passes = ruleRequirements(rule).every((r) => snapshotSatisfies(loaded.snapshot, r, checkOptions))\n if (!passes) {\n if (options.onUnauthorized) return options.onUnauthorized(req, rule)\n return json(403, 'Forbidden', 'User does not have the right roles or permissions.')\n }\n }\n return undefined\n }\n}\n"]}