@anievo-id/rbac-evolution-next 0.2.0 → 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 +3 -1
- package/dist/{chunk-QGRA2JHH.js → chunk-L3PCX3HA.js} +53 -14
- package/dist/chunk-L3PCX3HA.js.map +1 -0
- package/dist/index.cjs +50 -16
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +8 -4
- package/dist/index.d.ts +8 -4
- package/dist/index.js +4 -8
- package/dist/index.js.map +1 -1
- package/dist/middleware.cjs +50 -11
- package/dist/middleware.cjs.map +1 -1
- package/dist/middleware.js +1 -1
- package/package.json +2 -2
- package/dist/chunk-QGRA2JHH.js.map +0 -1
package/README.md
CHANGED
|
@@ -152,7 +152,9 @@ export const DELETE = withRbac(
|
|
|
152
152
|
)
|
|
153
153
|
```
|
|
154
154
|
|
|
155
|
-
Guests get `401 { "error": "
|
|
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
|
|
100
|
+
async function loadChecker(req) {
|
|
76
101
|
if (options.rbac === void 0) {
|
|
77
102
|
const snapshot = await options.getSnapshot(req) ?? null;
|
|
78
|
-
|
|
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
|
-
|
|
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
|
|
93
|
-
if (!
|
|
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
|
|
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
|
-
|
|
105
|
-
|
|
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
|
|
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-
|
|
116
|
-
//# sourceMappingURL=chunk-
|
|
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/
|
|
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
|
-
|
|
25
|
-
|
|
26
|
-
|
|
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" ?
|
|
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
|
|
253
|
+
async function loadChecker(req) {
|
|
234
254
|
if (options.rbac === void 0) {
|
|
235
255
|
const snapshot = await options.getSnapshot(req) ?? null;
|
|
236
|
-
|
|
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
|
-
|
|
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
|
|
251
|
-
if (!
|
|
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
|
|
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
|
-
|
|
263
|
-
|
|
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
|
|
299
|
+
return forbiddenResponse(failed);
|
|
266
300
|
}
|
|
267
301
|
}
|
|
268
302
|
return void 0;
|
package/dist/index.cjs.map
CHANGED
|
@@ -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 {
|
|
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
|
-
|
|
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 {
|
|
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
|
-
|
|
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
|
-
|
|
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" ?
|
|
147
|
+
return result.reason === "unauthenticated" ? unauthenticatedResponse() : forbiddenResponse(requirement);
|
|
152
148
|
};
|
|
153
149
|
}
|
|
154
150
|
};
|
|
155
151
|
}
|
|
156
152
|
|
|
157
|
-
export { RbacUnauthorizedError, createNextRbac
|
|
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"]}
|
package/dist/middleware.cjs
CHANGED
|
@@ -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
|
|
102
|
+
async function loadChecker(req) {
|
|
78
103
|
if (options.rbac === void 0) {
|
|
79
104
|
const snapshot = await options.getSnapshot(req) ?? null;
|
|
80
|
-
|
|
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
|
-
|
|
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
|
|
95
|
-
if (!
|
|
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
|
|
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
|
-
|
|
107
|
-
|
|
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
|
|
148
|
+
return forbiddenResponse(failed);
|
|
110
149
|
}
|
|
111
150
|
}
|
|
112
151
|
return void 0;
|
package/dist/middleware.cjs.map
CHANGED
|
@@ -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"]}
|
package/dist/middleware.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
export { compilePathPattern, createRbacMiddleware, matchPath, snapshotSatisfies } from './chunk-
|
|
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.2.
|
|
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.2.
|
|
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"]}
|