@anievo-id/rbac-evolution-nuxt 0.0.0-stage → 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.
Files changed (41) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +85 -2
  3. package/dist/chunk-55P6WQGS.js +31 -0
  4. package/dist/chunk-55P6WQGS.js.map +1 -0
  5. package/dist/chunk-NRX4JOTB.js +29 -0
  6. package/dist/chunk-NRX4JOTB.js.map +1 -0
  7. package/dist/chunk-SWBMHFPA.js +6 -0
  8. package/dist/chunk-SWBMHFPA.js.map +1 -0
  9. package/dist/chunk-X5DITRQB.js +26 -0
  10. package/dist/chunk-X5DITRQB.js.map +1 -0
  11. package/dist/module.d.ts +38 -0
  12. package/dist/module.d.ts.map +1 -0
  13. package/dist/module.js +55 -0
  14. package/dist/module.js.map +1 -0
  15. package/dist/requirements.d.ts +20 -0
  16. package/dist/requirements.d.ts.map +1 -0
  17. package/dist/runtime/composables.d.ts +18 -0
  18. package/dist/runtime/composables.d.ts.map +1 -0
  19. package/dist/runtime/composables.js +3 -0
  20. package/dist/runtime/composables.js.map +1 -0
  21. package/dist/runtime/middleware.d.ts +8 -0
  22. package/dist/runtime/middleware.d.ts.map +1 -0
  23. package/dist/runtime/middleware.js +26 -0
  24. package/dist/runtime/middleware.js.map +1 -0
  25. package/dist/runtime/plugin.d.ts +13 -0
  26. package/dist/runtime/plugin.d.ts.map +1 -0
  27. package/dist/runtime/plugin.js +41 -0
  28. package/dist/runtime/plugin.js.map +1 -0
  29. package/dist/runtime/rule.d.ts +38 -0
  30. package/dist/runtime/rule.d.ts.map +1 -0
  31. package/dist/runtime/rule.js +4 -0
  32. package/dist/runtime/rule.js.map +1 -0
  33. package/dist/runtime/types.d.ts +22 -0
  34. package/dist/runtime/types.d.ts.map +1 -0
  35. package/dist/runtime/types.js +3 -0
  36. package/dist/runtime/types.js.map +1 -0
  37. package/dist/server.d.ts +104 -0
  38. package/dist/server.d.ts.map +1 -0
  39. package/dist/server.js +97 -0
  40. package/dist/server.js.map +1 -0
  41. package/package.json +76 -3
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AniEvo-ID
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,86 @@
1
- # Temporary Holding Version
1
+ # @anievo-id/rbac-evolution-nuxt
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Nuxt 3 / 4 module for [rbac-evolution](../core). It installs [`@anievo-id/rbac-evolution-vue`](../vue)
4
+ (`v-can`, `v-role`, `<Can>`, `<HasRole>`, `$can`), hydrates the user's snapshot from SSR, auto-imports
5
+ `useRbac()` / `useCan()` & co., adds a route middleware for `definePageMeta({ rbac })`, and ships Nitro helpers
6
+ for server-side enforcement.
7
+
8
+ ```bash
9
+ npm i @anievo-id/rbac-evolution @anievo-id/rbac-evolution-nuxt
10
+ ```
11
+
12
+ ## Setup
13
+
14
+ ```ts
15
+ // nuxt.config.ts
16
+ export default defineNuxtConfig({
17
+ modules: ['@anievo-id/rbac-evolution-nuxt'],
18
+ rbac: {
19
+ wildcard: true, // must mirror createRbac({ wildcard })
20
+ superAdminRoles: ['super-admin'],
21
+ unauthenticatedRedirect: '/login', // optional, otherwise a 401 error page
22
+ forbiddenRedirect: '/403', // optional, otherwise a 403 error page
23
+ },
24
+ })
25
+ ```
26
+
27
+ Resolve the subject on the server — the module's plugin reads `event.context.rbac` during SSR and sends the
28
+ snapshot to the client through `useState`:
29
+
30
+ ```ts
31
+ // server/utils/rbac.ts
32
+ import { createRbac } from '@anievo-id/rbac-evolution'
33
+ import { createRbacServer } from '@anievo-id/rbac-evolution-nuxt/server'
34
+
35
+ export const rbac = createRbac({ adapter: yourAdapter })
36
+
37
+ export const rbacServer = createRbacServer({
38
+ rbac,
39
+ getSubject: async (event) => {
40
+ const user = await getUserFromSession(event) // your auth
41
+ return user ? { type: 'user', id: user.id } : null
42
+ },
43
+ })
44
+
45
+ // server/middleware/rbac.ts
46
+ export default defineEventHandler((event) => rbacServer.resolve(event))
47
+ ```
48
+
49
+ ## Pages & components
50
+
51
+ ```vue
52
+ <script setup lang="ts">
53
+ definePageMeta({ rbac: { permission: 'articles.edit' } })
54
+
55
+ const canPublish = useCan('articles.publish')
56
+ const rbac = useRbac()
57
+ </script>
58
+
59
+ <template>
60
+ <button v-if="canPublish">Publish</button>
61
+ <button v-can="'articles.delete'">Delete</button>
62
+ <HasRole role="admin">Admin tools</HasRole>
63
+ <p v-if="rbac.isGuest()">Please log in</p>
64
+ </template>
65
+ ```
66
+
67
+ Route rules use the Express semantics: `permission` (all; `'a|b'` = any; `any: true`), `role` (any; `all: true`),
68
+ `roleOrPermission` (any), plus per-route `redirect` / `guestRedirect`.
69
+
70
+ After login or logout, update the client: `useRbac().setSnapshot(await $fetch('/api/me/permissions'))` or
71
+ `useRbac().setSnapshot(null)`.
72
+
73
+ ## Server-side enforcement
74
+
75
+ Client checks only decide what the UI shows. Enforce in API routes:
76
+
77
+ ```ts
78
+ // server/api/articles/[id].delete.ts
79
+ export default defineEventHandler(async (event) => {
80
+ const rbac = await rbacServer.requirePermission(event, 'articles.delete')
81
+ // ...
82
+ })
83
+ ```
84
+
85
+ `requirePermission`, `requireRole` and `requireRoleOrPermission` throw a 401 / 403 error whose `data` is the
86
+ Express body (`{ error, reason, message }`).
@@ -0,0 +1,31 @@
1
+ import { requirementGroups, MESSAGES } from './chunk-NRX4JOTB.js';
2
+
3
+ // src/runtime/rule.ts
4
+ var list = (names) => names === void 0 ? [] : [names];
5
+ function evaluateRouteRule(rbac, rule, isGuest) {
6
+ const checks = [];
7
+ if (rule.permission !== void 0) {
8
+ checks.push(["permission", requirementGroups("permission", list(rule.permission), { any: rule.any })]);
9
+ }
10
+ if (rule.role !== void 0) {
11
+ checks.push(["role", requirementGroups("role", list(rule.role), { all: rule.all })]);
12
+ }
13
+ if (rule.roleOrPermission !== void 0) {
14
+ checks.push(["role_or_permission", requirementGroups("role_or_permission", list(rule.roleOrPermission))]);
15
+ }
16
+ if (checks.length === 0) return { ok: true };
17
+ if (isGuest) return { ok: false, status: 401, error: "UNAUTHENTICATED" };
18
+ for (const [kind, groups] of checks) {
19
+ const pass = groups.length > 0 && groups.every((group) => {
20
+ if (kind === "permission") return rbac.canAny(group);
21
+ if (kind === "role") return rbac.hasAnyRole(group);
22
+ return rbac.hasAnyRole(group) || rbac.canAny(group);
23
+ });
24
+ if (!pass) return { ok: false, status: 403, error: "FORBIDDEN", reason: kind, message: MESSAGES[kind] };
25
+ }
26
+ return { ok: true };
27
+ }
28
+
29
+ export { evaluateRouteRule };
30
+ //# sourceMappingURL=chunk-55P6WQGS.js.map
31
+ //# sourceMappingURL=chunk-55P6WQGS.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/runtime/rule.ts"],"names":[],"mappings":";;;AA0BA,IAAM,IAAA,GAAO,CAAC,KAAA,KACZ,KAAA,KAAU,SAAY,EAAC,GAAI,CAAC,KAAK,CAAA;AAM5B,SAAS,iBAAA,CAAkB,IAAA,EAAe,IAAA,EAAqB,OAAA,EAAmC;AACvG,EAAA,MAAM,SAA0C,EAAC;AACjD,EAAA,IAAI,IAAA,CAAK,eAAe,MAAA,EAAW;AACjC,IAAA,MAAA,CAAO,IAAA,CAAK,CAAC,YAAA,EAAc,iBAAA,CAAkB,cAAc,IAAA,CAAK,IAAA,CAAK,UAAU,CAAA,EAAG,EAAE,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,CAAC,CAAC,CAAA;AAAA,EACvG;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAW;AAC3B,IAAA,MAAA,CAAO,IAAA,CAAK,CAAC,MAAA,EAAQ,iBAAA,CAAkB,QAAQ,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,EAAG,EAAE,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,CAAC,CAAC,CAAA;AAAA,EACrF;AACA,EAAA,IAAI,IAAA,CAAK,qBAAqB,MAAA,EAAW;AACvC,IAAA,MAAA,CAAO,IAAA,CAAK,CAAC,oBAAA,EAAsB,iBAAA,CAAkB,oBAAA,EAAsB,KAAK,IAAA,CAAK,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAAA,EAC1G;AACA,EAAA,IAAI,OAAO,MAAA,KAAW,CAAA,EAAG,OAAO,EAAE,IAAI,IAAA,EAAK;AAC3C,EAAA,IAAI,OAAA,SAAgB,EAAE,EAAA,EAAI,OAAO,MAAA,EAAQ,GAAA,EAAK,OAAO,iBAAA,EAAkB;AAEvE,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,MAAM,CAAA,IAAK,MAAA,EAAQ;AACnC,IAAA,MAAM,OACJ,MAAA,CAAO,MAAA,GAAS,KAChB,MAAA,CAAO,KAAA,CAAM,CAAC,KAAA,KAAU;AACtB,MAAA,IAAI,IAAA,KAAS,YAAA,EAAc,OAAO,IAAA,CAAK,OAAO,KAAK,CAAA;AACnD,MAAA,IAAI,IAAA,KAAS,MAAA,EAAQ,OAAO,IAAA,CAAK,WAAW,KAAK,CAAA;AACjD,MAAA,OAAO,KAAK,UAAA,CAAW,KAAK,CAAA,IAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,IACpD,CAAC,CAAA;AACH,IAAA,IAAI,CAAC,IAAA,EAAM,OAAO,EAAE,IAAI,KAAA,EAAO,MAAA,EAAQ,GAAA,EAAK,KAAA,EAAO,aAAa,MAAA,EAAQ,IAAA,EAAM,OAAA,EAAS,QAAA,CAAS,IAAI,CAAA,EAAE;AAAA,EACxG;AACA,EAAA,OAAO,EAAE,IAAI,IAAA,EAAK;AACpB","file":"chunk-55P6WQGS.js","sourcesContent":["import type { VueRbac } from '@anievo-id/rbac-evolution-vue'\nimport { MESSAGES, requirementGroups, type RequirementKind, type RequirementNames } from '../requirements'\n\n/** `definePageMeta({ rbac: { ... } })` — same semantics as the Express / Nest guards. */\nexport interface RbacRouteRule {\n /** Every name is required; `'a|b'` = any of them. With `any: true`, any of all the names. */\n permission?: RequirementNames\n /** Any of the roles; with `all: true`, all of them. `'a|b'` is supported. */\n role?: RequirementNames\n /** Any of the names, as a role OR as a permission. */\n roleOrPermission?: RequirementNames\n /** Permissions: pass with ANY of them instead of all. */\n any?: boolean\n /** Roles: require ALL of them instead of any. */\n all?: boolean\n /** Where to send a user who lacks access. Default: the module's `forbiddenRedirect`, else a 403 error page. */\n redirect?: string\n /** Where to send a guest. Default: the module's `unauthenticatedRedirect`, else a 401 error page. */\n guestRedirect?: string\n}\n\nexport type RouteRuleResult =\n | { ok: true }\n | { ok: false; status: 401; error: 'UNAUTHENTICATED' }\n | { ok: false; status: 403; error: 'FORBIDDEN'; reason: RequirementKind; message: string }\n\nconst list = (names: RequirementNames | undefined): RequirementNames[] =>\n names === undefined ? [] : [names]\n\n/**\n * Evaluates a route rule against the client-side snapshot. Pure and synchronous —\n * used by the `rbac` route middleware, exported for custom middleware.\n */\nexport function evaluateRouteRule(rbac: VueRbac, rule: RbacRouteRule, isGuest: boolean): RouteRuleResult {\n const checks: [RequirementKind, string[][]][] = []\n if (rule.permission !== undefined) {\n checks.push(['permission', requirementGroups('permission', list(rule.permission), { any: rule.any })])\n }\n if (rule.role !== undefined) {\n checks.push(['role', requirementGroups('role', list(rule.role), { all: rule.all })])\n }\n if (rule.roleOrPermission !== undefined) {\n checks.push(['role_or_permission', requirementGroups('role_or_permission', list(rule.roleOrPermission))])\n }\n if (checks.length === 0) return { ok: true }\n if (isGuest) return { ok: false, status: 401, error: 'UNAUTHENTICATED' }\n\n for (const [kind, groups] of checks) {\n const pass =\n groups.length > 0 &&\n groups.every((group) => {\n if (kind === 'permission') return rbac.canAny(group)\n if (kind === 'role') return rbac.hasAnyRole(group)\n return rbac.hasAnyRole(group) || rbac.canAny(group)\n })\n if (!pass) return { ok: false, status: 403, error: 'FORBIDDEN', reason: kind, message: MESSAGES[kind] }\n }\n return { ok: true }\n}\n"]}
@@ -0,0 +1,29 @@
1
+ // src/requirements.ts
2
+ var MESSAGES = {
3
+ permission: "User does not have the right permissions.",
4
+ role: "User does not have the right roles.",
5
+ role_or_permission: "User does not have any of the necessary access rights."
6
+ };
7
+ var UNAUTHENTICATED_MESSAGE = "User is not logged in.";
8
+ var split = (name) => name.split("|").map((n) => n.trim()).filter((n) => n !== "");
9
+ function toGroups(names) {
10
+ const groups = [];
11
+ for (const name of names) {
12
+ for (const item of typeof name === "string" ? [name] : name) {
13
+ const group = split(item);
14
+ if (group.length > 0) groups.push(group);
15
+ }
16
+ }
17
+ return groups;
18
+ }
19
+ function requirementGroups(kind, names, flags = {}) {
20
+ const groups = toGroups(names);
21
+ if (kind === "permission") return flags.any ? [groups.flat()] : groups;
22
+ const all = groups.flat();
23
+ if (kind === "role" && flags.all) return all.map((r) => [r]);
24
+ return all.length > 0 ? [all] : [];
25
+ }
26
+
27
+ export { MESSAGES, UNAUTHENTICATED_MESSAGE, requirementGroups };
28
+ //# sourceMappingURL=chunk-NRX4JOTB.js.map
29
+ //# sourceMappingURL=chunk-NRX4JOTB.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/requirements.ts"],"names":[],"mappings":";AAMO,IAAM,QAAA,GAA4C;AAAA,EACvD,UAAA,EAAY,2CAAA;AAAA,EACZ,IAAA,EAAM,qCAAA;AAAA,EACN,kBAAA,EAAoB;AACtB;AAEO,IAAM,uBAAA,GAA0B;AAEvC,IAAM,QAAQ,CAAC,IAAA,KACb,KACG,KAAA,CAAM,GAAG,EACT,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAA,CACnB,OAAO,CAAC,CAAA,KAAM,MAAM,EAAE,CAAA;AAGpB,SAAS,SAAS,KAAA,EAAgD;AACvE,EAAA,MAAM,SAAqB,EAAC;AAC5B,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,KAAA,MAAW,QAAQ,OAAO,IAAA,KAAS,WAAW,CAAC,IAAI,IAAI,IAAA,EAAM;AAC3D,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAI,CAAA;AACxB,MAAA,IAAI,KAAA,CAAM,MAAA,GAAS,CAAA,EAAG,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACzC;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AASO,SAAS,iBAAA,CACd,IAAA,EACA,KAAA,EACA,KAAA,GAAkE,EAAC,EACvD;AACZ,EAAA,MAAM,MAAA,GAAS,SAAS,KAAK,CAAA;AAC7B,EAAA,IAAI,IAAA,KAAS,cAAc,OAAO,KAAA,CAAM,MAAM,CAAC,MAAA,CAAO,IAAA,EAAM,CAAA,GAAI,MAAA;AAChE,EAAA,MAAM,GAAA,GAAM,OAAO,IAAA,EAAK;AACxB,EAAA,IAAI,IAAA,KAAS,MAAA,IAAU,KAAA,CAAM,GAAA,EAAK,OAAO,GAAA,CAAI,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,CAAC,CAAC,CAAA;AAC3D,EAAA,OAAO,IAAI,MAAA,GAAS,CAAA,GAAI,CAAC,GAAG,IAAI,EAAC;AACnC","file":"chunk-NRX4JOTB.js","sourcesContent":["/** Which kind of requirement failed — same values as the Express package. */\nexport type RequirementKind = 'permission' | 'role' | 'role_or_permission'\n\n/** A name, a pipe-separated list (`'edit|delete'` = any of), or an array of names. */\nexport type RequirementNames = string | readonly string[]\n\nexport const MESSAGES: Record<RequirementKind, string> = {\n permission: 'User does not have the right permissions.',\n role: 'User does not have the right roles.',\n role_or_permission: 'User does not have any of the necessary access rights.',\n}\n\nexport const UNAUTHENTICATED_MESSAGE = 'User is not logged in.'\n\nconst split = (name: string): string[] =>\n name\n .split('|')\n .map((n) => n.trim())\n .filter((n) => n !== '')\n\n/** Each argument is a group (pipes = any within the group); arrays contribute one group per item. */\nexport function toGroups(names: readonly RequirementNames[]): string[][] {\n const groups: string[][] = []\n for (const name of names) {\n for (const item of typeof name === 'string' ? [name] : name) {\n const group = split(item)\n if (group.length > 0) groups.push(group)\n }\n }\n return groups\n}\n\n/**\n * Normalizes a requirement into groups: every group must pass, a group passes when ANY of its names matches.\n *\n * - permissions: every argument is required, pipes mean any, `any` = any of everything\n * - roles: any of them, `all` = all of them\n * - role or permission: any of them\n */\nexport function requirementGroups(\n kind: RequirementKind,\n names: readonly RequirementNames[],\n flags: { any?: boolean | undefined; all?: boolean | undefined } = {},\n): string[][] {\n const groups = toGroups(names)\n if (kind === 'permission') return flags.any ? [groups.flat()] : groups\n const all = groups.flat()\n if (kind === 'role' && flags.all) return all.map((r) => [r])\n return all.length > 0 ? [all] : []\n}\n"]}
@@ -0,0 +1,6 @@
1
+ // src/runtime/types.ts
2
+ var STATE_KEY = "rbac-evolution:snapshot";
3
+
4
+ export { STATE_KEY };
5
+ //# sourceMappingURL=chunk-SWBMHFPA.js.map
6
+ //# sourceMappingURL=chunk-SWBMHFPA.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/runtime/types.ts"],"names":[],"mappings":";AAuBO,IAAM,SAAA,GAAY","file":"chunk-SWBMHFPA.js","sourcesContent":["import type { RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport type { VueRbac } from '@anievo-id/rbac-evolution-vue'\n\n/** Module options as exposed in `runtimeConfig.public.rbac`. */\nexport interface RbacPublicConfig {\n wildcard: boolean\n superAdminRoles: string[]\n directives: boolean\n components: boolean\n globalProperties: boolean\n unauthenticatedRedirect: string\n forbiddenRedirect: string\n}\n\n/** The RBAC instance provided as `$rbac` / returned by `useRbac()`. */\nexport interface NuxtRbac extends VueRbac {\n /** Replaces the snapshot (and the SSR state), e.g. after login (`snapshot`) or logout (`null`). */\n setSnapshot(snapshot: RbacSnapshot | null): void\n /** `true` when there is no subject (the server resolved a guest, or `setSnapshot(null)`). */\n isGuest(): boolean\n}\n\n/** `useState` key holding the snapshot serialized from SSR. */\nexport const STATE_KEY = 'rbac-evolution:snapshot'\n"]}
@@ -0,0 +1,26 @@
1
+ import { computed, toValue } from 'vue';
2
+ import { useNuxtApp } from '#app';
3
+
4
+ // src/runtime/composables.ts
5
+ function useRbac() {
6
+ const rbac = useNuxtApp().$rbac;
7
+ if (!rbac) {
8
+ throw new Error("[rbac-evolution] `$rbac` is missing. Is `@anievo-id/rbac-evolution-nuxt` in `modules`?");
9
+ }
10
+ return rbac;
11
+ }
12
+ var check = (pick) => (names) => {
13
+ const fn = pick(useRbac());
14
+ return computed(() => fn(toValue(names)));
15
+ };
16
+ var useCan = check((rbac) => rbac.can);
17
+ var useCannot = check((rbac) => rbac.cannot);
18
+ var useCanAny = check((rbac) => rbac.canAny);
19
+ var useCanAll = check((rbac) => rbac.canAll);
20
+ var useHasRole = check((rbac) => rbac.hasRole);
21
+ var useHasAnyRole = check((rbac) => rbac.hasAnyRole);
22
+ var useHasAllRoles = check((rbac) => rbac.hasAllRoles);
23
+
24
+ export { useCan, useCanAll, useCanAny, useCannot, useHasAllRoles, useHasAnyRole, useHasRole, useRbac };
25
+ //# sourceMappingURL=chunk-X5DITRQB.js.map
26
+ //# sourceMappingURL=chunk-X5DITRQB.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/runtime/composables.ts"],"names":[],"mappings":";;;;AASO,SAAS,OAAA,GAAoB;AAClC,EAAA,MAAM,IAAA,GAAQ,YAAW,CAAsC,KAAA;AAC/D,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAM,IAAI,MAAM,wFAAwF,CAAA;AAAA,EAC1G;AACA,EAAA,OAAO,IAAA;AACT;AAEA,IAAM,KAAA,GACJ,CAAC,IAAA,KACD,CAAC,KAAA,KAA4D;AAC3D,EAAA,MAAM,EAAA,GAAK,IAAA,CAAK,OAAA,EAAS,CAAA;AACzB,EAAA,OAAO,SAAS,MAAM,EAAA,CAAG,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAA;AAC1C,CAAA;AAGK,IAAM,MAAA,GAAS,KAAA,CAAM,CAAC,IAAA,KAAS,KAAK,GAAG;AACvC,IAAM,SAAA,GAAY,KAAA,CAAM,CAAC,IAAA,KAAS,KAAK,MAAM;AAC7C,IAAM,SAAA,GAAY,KAAA,CAAM,CAAC,IAAA,KAAS,KAAK,MAAM;AAC7C,IAAM,SAAA,GAAY,KAAA,CAAM,CAAC,IAAA,KAAS,KAAK,MAAM;AAE7C,IAAM,UAAA,GAAa,KAAA,CAAM,CAAC,IAAA,KAAS,KAAK,OAAO;AAC/C,IAAM,aAAA,GAAgB,KAAA,CAAM,CAAC,IAAA,KAAS,KAAK,UAAU;AACrD,IAAM,cAAA,GAAiB,KAAA,CAAM,CAAC,IAAA,KAAS,KAAK,WAAW","file":"chunk-X5DITRQB.js","sourcesContent":["import type { NameList } from '@anievo-id/rbac-evolution-vue'\nimport { type ComputedRef, computed, type MaybeRefOrGetter, toValue } from 'vue'\nimport { useNuxtApp } from '#app'\nimport type { NuxtRbac } from './types'\n\n/**\n * Returns the RBAC instance (`$rbac`). Works in components, plugins and route middleware.\n * Client-side checks only decide what the UI shows — enforce on the server too.\n */\nexport function useRbac(): NuxtRbac {\n const rbac = (useNuxtApp() as unknown as { $rbac?: NuxtRbac }).$rbac\n if (!rbac) {\n throw new Error('[rbac-evolution] `$rbac` is missing. Is `@anievo-id/rbac-evolution-nuxt` in `modules`?')\n }\n return rbac\n}\n\nconst check =\n (pick: (rbac: NuxtRbac) => (names: NameList) => boolean) =>\n (names: MaybeRefOrGetter<NameList>): ComputedRef<boolean> => {\n const fn = pick(useRbac())\n return computed(() => fn(toValue(names)))\n }\n\n/** Reactive permission check. A list means ALL of them. Accepts a ref or getter. */\nexport const useCan = check((rbac) => rbac.can)\nexport const useCannot = check((rbac) => rbac.cannot)\nexport const useCanAny = check((rbac) => rbac.canAny)\nexport const useCanAll = check((rbac) => rbac.canAll)\n/** Reactive role check. A list or `'a|b'` means ANY of them. */\nexport const useHasRole = check((rbac) => rbac.hasRole)\nexport const useHasAnyRole = check((rbac) => rbac.hasAnyRole)\nexport const useHasAllRoles = check((rbac) => rbac.hasAllRoles)\n"]}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * @anievo-id/rbac-evolution-nuxt
3
+ *
4
+ * Nuxt 3/4 module: installs `@anievo-id/rbac-evolution-vue`, hydrates the snapshot from SSR,
5
+ * auto-imports `useRbac()` / `useCan()` & co. and registers the `rbac` route middleware.
6
+ */
7
+ import type { RbacRouteRule } from './runtime/rule';
8
+ export type { RbacRouteRule, RouteRuleResult } from './runtime/rule';
9
+ export type { NuxtRbac, RbacPublicConfig } from './runtime/types';
10
+ export interface ModuleOptions {
11
+ /** Match permissions with wildcard semantics — must mirror `createRbac({ wildcard })`. Default: `false`. */
12
+ wildcard?: boolean;
13
+ /** Roles that pass every permission check on the client. Default: `[]`. */
14
+ superAdminRoles?: string[];
15
+ /** Register `v-can` / `v-role`. Default: `true`. */
16
+ directives?: boolean;
17
+ /** Register `<Can>` / `<HasRole>`. Default: `true`. */
18
+ components?: boolean;
19
+ /** Add `$can`, `$hasRole`, … to templates. Default: `true`. */
20
+ globalProperties?: boolean;
21
+ /** Register the global `rbac` route middleware for `definePageMeta({ rbac })`. Default: `true`. */
22
+ middleware?: boolean;
23
+ /** Where the middleware sends guests. Default: `''` (show a 401 error). */
24
+ unauthenticatedRedirect?: string;
25
+ /** Where the middleware sends users without access. Default: `''` (show a 403 error). */
26
+ forbiddenRedirect?: string;
27
+ }
28
+ /** Auto-imported composables. */
29
+ export declare const COMPOSABLES: readonly ["useRbac", "useCan", "useCannot", "useCanAny", "useCanAll", "useHasRole", "useHasAnyRole", "useHasAllRoles"];
30
+ declare const _default: import("nuxt/schema").NuxtModule<ModuleOptions, ModuleOptions, false>;
31
+ export default _default;
32
+ declare module '#app' {
33
+ interface PageMeta {
34
+ /** Access rule enforced by the `rbac` route middleware of `@anievo-id/rbac-evolution-nuxt`. */
35
+ rbac?: RbacRouteRule;
36
+ }
37
+ }
38
+ //# sourceMappingURL=module.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGnD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACpE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEjE,MAAM,WAAW,aAAa;IAC5B,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,mGAAmG;IACnG,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2EAA2E;IAC3E,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,iCAAiC;AACjC,eAAO,MAAM,WAAW,wHASd,CAAA;;AAEV,wBAyCE;AAEF,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,QAAQ;QAChB,+FAA+F;QAC/F,IAAI,CAAC,EAAE,aAAa,CAAA;KACrB;CACF"}
package/dist/module.js ADDED
@@ -0,0 +1,55 @@
1
+ import { defineNuxtModule, createResolver, addPlugin, addImports, addRouteMiddleware } from '@nuxt/kit';
2
+
3
+ // src/module.ts
4
+ var COMPOSABLES = [
5
+ "useRbac",
6
+ "useCan",
7
+ "useCannot",
8
+ "useCanAny",
9
+ "useCanAll",
10
+ "useHasRole",
11
+ "useHasAnyRole",
12
+ "useHasAllRoles"
13
+ ];
14
+ var module_default = defineNuxtModule({
15
+ meta: {
16
+ name: "@anievo-id/rbac-evolution-nuxt",
17
+ configKey: "rbac",
18
+ compatibility: { nuxt: ">=3.0.0" }
19
+ },
20
+ defaults: {
21
+ wildcard: false,
22
+ superAdminRoles: [],
23
+ directives: true,
24
+ components: true,
25
+ globalProperties: true,
26
+ middleware: true,
27
+ unauthenticatedRedirect: "",
28
+ forbiddenRedirect: ""
29
+ },
30
+ setup(options, nuxt) {
31
+ const resolver = createResolver(import.meta.url);
32
+ const config = {
33
+ wildcard: options.wildcard ?? false,
34
+ superAdminRoles: [...options.superAdminRoles ?? []],
35
+ directives: options.directives ?? true,
36
+ components: options.components ?? true,
37
+ globalProperties: options.globalProperties ?? true,
38
+ unauthenticatedRedirect: options.unauthenticatedRedirect ?? "",
39
+ forbiddenRedirect: options.forbiddenRedirect ?? ""
40
+ };
41
+ const publicConfig = nuxt.options.runtimeConfig.public;
42
+ publicConfig["rbac"] = { ...config, ...publicConfig["rbac"] };
43
+ const runtimeDir = resolver.resolve("./runtime");
44
+ nuxt.options.build.transpile.push(runtimeDir);
45
+ addPlugin(resolver.resolve("./runtime/plugin"));
46
+ addImports(COMPOSABLES.map((name) => ({ name, from: resolver.resolve("./runtime/composables") })));
47
+ if (options.middleware ?? true) {
48
+ addRouteMiddleware({ name: "rbac", path: resolver.resolve("./runtime/middleware"), global: true });
49
+ }
50
+ }
51
+ });
52
+
53
+ export { COMPOSABLES, module_default as default };
54
+ //# sourceMappingURL=module.js.map
55
+ //# sourceMappingURL=module.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/module.ts"],"names":[],"mappings":";;;AAkCO,IAAM,WAAA,GAAc;AAAA,EACzB,SAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF;AAEA,IAAO,iBAAQ,gBAAA,CAAgC;AAAA,EAC7C,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,gCAAA;AAAA,IACN,SAAA,EAAW,MAAA;AAAA,IACX,aAAA,EAAe,EAAE,IAAA,EAAM,SAAA;AAAU,GACnC;AAAA,EACA,QAAA,EAAU;AAAA,IACR,QAAA,EAAU,KAAA;AAAA,IACV,iBAAiB,EAAC;AAAA,IAClB,UAAA,EAAY,IAAA;AAAA,IACZ,UAAA,EAAY,IAAA;AAAA,IACZ,gBAAA,EAAkB,IAAA;AAAA,IAClB,UAAA,EAAY,IAAA;AAAA,IACZ,uBAAA,EAAyB,EAAA;AAAA,IACzB,iBAAA,EAAmB;AAAA,GACrB;AAAA,EACA,KAAA,CAAM,SAAS,IAAA,EAAM;AACnB,IAAA,MAAM,QAAA,GAAW,cAAA,CAAe,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AAE/C,IAAA,MAAM,MAAA,GAA2B;AAAA,MAC/B,QAAA,EAAU,QAAQ,QAAA,IAAY,KAAA;AAAA,MAC9B,iBAAiB,CAAC,GAAI,OAAA,CAAQ,eAAA,IAAmB,EAAG,CAAA;AAAA,MACpD,UAAA,EAAY,QAAQ,UAAA,IAAc,IAAA;AAAA,MAClC,UAAA,EAAY,QAAQ,UAAA,IAAc,IAAA;AAAA,MAClC,gBAAA,EAAkB,QAAQ,gBAAA,IAAoB,IAAA;AAAA,MAC9C,uBAAA,EAAyB,QAAQ,uBAAA,IAA2B,EAAA;AAAA,MAC5D,iBAAA,EAAmB,QAAQ,iBAAA,IAAqB;AAAA,KAClD;AACA,IAAA,MAAM,YAAA,GAAe,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,MAAA;AAChD,IAAA,YAAA,CAAa,MAAM,IAAI,EAAE,GAAG,QAAQ,GAAI,YAAA,CAAa,MAAM,CAAA,EAA4C;AAEvG,IAAA,MAAM,UAAA,GAAa,QAAA,CAAS,OAAA,CAAQ,WAAW,CAAA;AAC/C,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,SAAA,CAAU,IAAA,CAAK,UAAU,CAAA;AAE5C,IAAA,SAAA,CAAU,QAAA,CAAS,OAAA,CAAQ,kBAAkB,CAAC,CAAA;AAC9C,IAAA,UAAA,CAAW,WAAA,CAAY,GAAA,CAAI,CAAC,IAAA,MAAU,EAAE,IAAA,EAAM,IAAA,EAAM,QAAA,CAAS,OAAA,CAAQ,uBAAuB,CAAA,EAAE,CAAE,CAAC,CAAA;AAEjG,IAAA,IAAI,OAAA,CAAQ,cAAc,IAAA,EAAM;AAC9B,MAAA,kBAAA,CAAmB,EAAE,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,QAAA,CAAS,QAAQ,sBAAsB,CAAA,EAAG,MAAA,EAAQ,IAAA,EAAM,CAAA;AAAA,IACnG;AAAA,EACF;AACF,CAAC","file":"module.js","sourcesContent":["/**\n * @anievo-id/rbac-evolution-nuxt\n *\n * Nuxt 3/4 module: installs `@anievo-id/rbac-evolution-vue`, hydrates the snapshot from SSR,\n * auto-imports `useRbac()` / `useCan()` & co. and registers the `rbac` route middleware.\n */\n\nimport { addImports, addPlugin, addRouteMiddleware, createResolver, defineNuxtModule } from '@nuxt/kit'\nimport type { RbacRouteRule } from './runtime/rule'\nimport type { RbacPublicConfig } from './runtime/types'\n\nexport type { RbacRouteRule, RouteRuleResult } from './runtime/rule'\nexport type { NuxtRbac, RbacPublicConfig } from './runtime/types'\n\nexport interface ModuleOptions {\n /** Match permissions with wildcard semantics — must mirror `createRbac({ wildcard })`. Default: `false`. */\n wildcard?: boolean\n /** Roles that pass every permission check on the client. Default: `[]`. */\n superAdminRoles?: string[]\n /** Register `v-can` / `v-role`. Default: `true`. */\n directives?: boolean\n /** Register `<Can>` / `<HasRole>`. Default: `true`. */\n components?: boolean\n /** Add `$can`, `$hasRole`, … to templates. Default: `true`. */\n globalProperties?: boolean\n /** Register the global `rbac` route middleware for `definePageMeta({ rbac })`. Default: `true`. */\n middleware?: boolean\n /** Where the middleware sends guests. Default: `''` (show a 401 error). */\n unauthenticatedRedirect?: string\n /** Where the middleware sends users without access. Default: `''` (show a 403 error). */\n forbiddenRedirect?: string\n}\n\n/** Auto-imported composables. */\nexport const COMPOSABLES = [\n 'useRbac',\n 'useCan',\n 'useCannot',\n 'useCanAny',\n 'useCanAll',\n 'useHasRole',\n 'useHasAnyRole',\n 'useHasAllRoles',\n] as const\n\nexport default defineNuxtModule<ModuleOptions>({\n meta: {\n name: '@anievo-id/rbac-evolution-nuxt',\n configKey: 'rbac',\n compatibility: { nuxt: '>=3.0.0' },\n },\n defaults: {\n wildcard: false,\n superAdminRoles: [],\n directives: true,\n components: true,\n globalProperties: true,\n middleware: true,\n unauthenticatedRedirect: '',\n forbiddenRedirect: '',\n },\n setup(options, nuxt) {\n const resolver = createResolver(import.meta.url)\n\n const config: RbacPublicConfig = {\n wildcard: options.wildcard ?? false,\n superAdminRoles: [...(options.superAdminRoles ?? [])],\n directives: options.directives ?? true,\n components: options.components ?? true,\n globalProperties: options.globalProperties ?? true,\n unauthenticatedRedirect: options.unauthenticatedRedirect ?? '',\n forbiddenRedirect: options.forbiddenRedirect ?? '',\n }\n const publicConfig = nuxt.options.runtimeConfig.public as Record<string, unknown>\n publicConfig['rbac'] = { ...config, ...(publicConfig['rbac'] as Partial<RbacPublicConfig> | undefined) }\n\n const runtimeDir = resolver.resolve('./runtime')\n nuxt.options.build.transpile.push(runtimeDir)\n\n addPlugin(resolver.resolve('./runtime/plugin'))\n addImports(COMPOSABLES.map((name) => ({ name, from: resolver.resolve('./runtime/composables') })))\n\n if (options.middleware ?? true) {\n addRouteMiddleware({ name: 'rbac', path: resolver.resolve('./runtime/middleware'), global: true })\n }\n },\n})\n\ndeclare module '#app' {\n interface PageMeta {\n /** Access rule enforced by the `rbac` route middleware of `@anievo-id/rbac-evolution-nuxt`. */\n rbac?: RbacRouteRule\n }\n}\n"]}
@@ -0,0 +1,20 @@
1
+ /** Which kind of requirement failed — same values as the Express package. */
2
+ export type RequirementKind = 'permission' | 'role' | 'role_or_permission';
3
+ /** A name, a pipe-separated list (`'edit|delete'` = any of), or an array of names. */
4
+ export type RequirementNames = string | readonly string[];
5
+ export declare const MESSAGES: Record<RequirementKind, string>;
6
+ export declare const UNAUTHENTICATED_MESSAGE = "User is not logged in.";
7
+ /** Each argument is a group (pipes = any within the group); arrays contribute one group per item. */
8
+ export declare function toGroups(names: readonly RequirementNames[]): string[][];
9
+ /**
10
+ * Normalizes a requirement into groups: every group must pass, a group passes when ANY of its names matches.
11
+ *
12
+ * - permissions: every argument is required, pipes mean any, `any` = any of everything
13
+ * - roles: any of them, `all` = all of them
14
+ * - role or permission: any of them
15
+ */
16
+ export declare function requirementGroups(kind: RequirementKind, names: readonly RequirementNames[], flags?: {
17
+ any?: boolean | undefined;
18
+ all?: boolean | undefined;
19
+ }): string[][];
20
+ //# sourceMappingURL=requirements.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../src/requirements.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,MAAM,GAAG,oBAAoB,CAAA;AAE1E,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;AAEzD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAIpD,CAAA;AAED,eAAO,MAAM,uBAAuB,2BAA2B,CAAA;AAQ/D,qGAAqG;AACrG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,EAAE,EAAE,CASvE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,KAAK,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GACnE,MAAM,EAAE,EAAE,CAMZ"}
@@ -0,0 +1,18 @@
1
+ import type { NameList } from '@anievo-id/rbac-evolution-vue';
2
+ import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
3
+ import type { NuxtRbac } from './types';
4
+ /**
5
+ * Returns the RBAC instance (`$rbac`). Works in components, plugins and route middleware.
6
+ * Client-side checks only decide what the UI shows — enforce on the server too.
7
+ */
8
+ export declare function useRbac(): NuxtRbac;
9
+ /** Reactive permission check. A list means ALL of them. Accepts a ref or getter. */
10
+ export declare const useCan: (names: MaybeRefOrGetter<NameList>) => ComputedRef<boolean>;
11
+ export declare const useCannot: (names: MaybeRefOrGetter<NameList>) => ComputedRef<boolean>;
12
+ export declare const useCanAny: (names: MaybeRefOrGetter<NameList>) => ComputedRef<boolean>;
13
+ export declare const useCanAll: (names: MaybeRefOrGetter<NameList>) => ComputedRef<boolean>;
14
+ /** Reactive role check. A list or `'a|b'` means ANY of them. */
15
+ export declare const useHasRole: (names: MaybeRefOrGetter<NameList>) => ComputedRef<boolean>;
16
+ export declare const useHasAnyRole: (names: MaybeRefOrGetter<NameList>) => ComputedRef<boolean>;
17
+ export declare const useHasAllRoles: (names: MaybeRefOrGetter<NameList>) => ComputedRef<boolean>;
18
+ //# sourceMappingURL=composables.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"composables.d.ts","sourceRoot":"","sources":["../../src/runtime/composables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAY,KAAK,gBAAgB,EAAW,MAAM,KAAK,CAAA;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC;;;GAGG;AACH,wBAAgB,OAAO,IAAI,QAAQ,CAMlC;AASD,oFAAoF;AACpF,eAAO,MAAM,MAAM,UANT,gBAAgB,CAAC,QAAQ,CAAC,KAAG,WAAW,CAAC,OAAO,CAMX,CAAA;AAC/C,eAAO,MAAM,SAAS,UAPZ,gBAAgB,CAAC,QAAQ,CAAC,KAAG,WAAW,CAAC,OAAO,CAOL,CAAA;AACrD,eAAO,MAAM,SAAS,UARZ,gBAAgB,CAAC,QAAQ,CAAC,KAAG,WAAW,CAAC,OAAO,CAQL,CAAA;AACrD,eAAO,MAAM,SAAS,UATZ,gBAAgB,CAAC,QAAQ,CAAC,KAAG,WAAW,CAAC,OAAO,CASL,CAAA;AACrD,gEAAgE;AAChE,eAAO,MAAM,UAAU,UAXb,gBAAgB,CAAC,QAAQ,CAAC,KAAG,WAAW,CAAC,OAAO,CAWH,CAAA;AACvD,eAAO,MAAM,aAAa,UAZhB,gBAAgB,CAAC,QAAQ,CAAC,KAAG,WAAW,CAAC,OAAO,CAYG,CAAA;AAC7D,eAAO,MAAM,cAAc,UAbjB,gBAAgB,CAAC,QAAQ,CAAC,KAAG,WAAW,CAAC,OAAO,CAaK,CAAA"}
@@ -0,0 +1,3 @@
1
+ export { useCan, useCanAll, useCanAny, useCannot, useHasAllRoles, useHasAnyRole, useHasRole, useRbac } from '../chunk-X5DITRQB.js';
2
+ //# sourceMappingURL=composables.js.map
3
+ //# sourceMappingURL=composables.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"composables.js"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Global route middleware: enforces `definePageMeta({ rbac: { ... } })` against the snapshot.
3
+ * Guests go to `guestRedirect` / `unauthenticatedRedirect` (else a 401 error), users without
4
+ * access to `redirect` / `forbiddenRedirect` (else a 403 error).
5
+ */
6
+ declare const _default: import("#app").RouteMiddleware;
7
+ export default _default;
8
+ //# sourceMappingURL=middleware.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/runtime/middleware.ts"],"names":[],"mappings":"AAKA;;;;GAIG;;AACH,wBAyBE"}
@@ -0,0 +1,26 @@
1
+ import { useRbac } from '../chunk-X5DITRQB.js';
2
+ import { evaluateRouteRule } from '../chunk-55P6WQGS.js';
3
+ import '../chunk-NRX4JOTB.js';
4
+ import { defineNuxtRouteMiddleware, useRuntimeConfig, navigateTo, abortNavigation, createError } from '#app';
5
+
6
+ var middleware_default = defineNuxtRouteMiddleware((to) => {
7
+ const rule = to.meta["rbac"];
8
+ if (!rule) return;
9
+ const rbac = useRbac();
10
+ const result = evaluateRouteRule(rbac, rule, rbac.isGuest());
11
+ if (result.ok) return;
12
+ const config = useRuntimeConfig().public["rbac"] ?? {};
13
+ const redirect = result.status === 401 ? rule.guestRedirect ?? config.unauthenticatedRedirect : rule.redirect ?? config.forbiddenRedirect;
14
+ if (redirect && redirect !== to.path) return navigateTo(redirect);
15
+ return abortNavigation(
16
+ createError({
17
+ statusCode: result.status,
18
+ statusMessage: result.status === 401 ? "Unauthorized" : "Forbidden",
19
+ data: result.status === 401 ? { error: result.error, message: "User is not logged in." } : { error: result.error, reason: result.reason, message: result.message }
20
+ })
21
+ );
22
+ });
23
+
24
+ export { middleware_default as default };
25
+ //# sourceMappingURL=middleware.js.map
26
+ //# sourceMappingURL=middleware.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/runtime/middleware.ts"],"names":[],"mappings":";;;;;AAUA,IAAO,kBAAA,GAAQ,yBAAA,CAA0B,CAAC,EAAA,KAAO;AAC/C,EAAA,MAAM,IAAA,GAAO,EAAA,CAAG,IAAA,CAAK,MAAM,CAAA;AAC3B,EAAA,IAAI,CAAC,IAAA,EAAM;AAEX,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,MAAM,SAAS,iBAAA,CAAkB,IAAA,EAAM,IAAA,EAAM,IAAA,CAAK,SAAS,CAAA;AAC3D,EAAA,IAAI,OAAO,EAAA,EAAI;AAEf,EAAA,MAAM,SAAU,gBAAA,EAAiB,CAAE,MAAA,CAAO,MAAM,KAAK,EAAC;AACtD,EAAA,MAAM,QAAA,GACJ,MAAA,CAAO,MAAA,KAAW,GAAA,GACb,IAAA,CAAK,iBAAiB,MAAA,CAAO,uBAAA,GAC7B,IAAA,CAAK,QAAA,IAAY,MAAA,CAAO,iBAAA;AAC/B,EAAA,IAAI,YAAY,QAAA,KAAa,EAAA,CAAG,IAAA,EAAM,OAAO,WAAW,QAAQ,CAAA;AAEhE,EAAA,OAAO,eAAA;AAAA,IACL,WAAA,CAAY;AAAA,MACV,YAAY,MAAA,CAAO,MAAA;AAAA,MACnB,aAAA,EAAe,MAAA,CAAO,MAAA,KAAW,GAAA,GAAM,cAAA,GAAiB,WAAA;AAAA,MACxD,IAAA,EACE,OAAO,MAAA,KAAW,GAAA,GACd,EAAE,KAAA,EAAO,MAAA,CAAO,OAAO,OAAA,EAAS,wBAAA,KAChC,EAAE,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA,EAAQ,OAAA,EAAS,OAAO,OAAA;AAAQ,KAC7E;AAAA,GACH;AACF,CAAC","file":"middleware.js","sourcesContent":["import { abortNavigation, createError, defineNuxtRouteMiddleware, navigateTo, useRuntimeConfig } from '#app'\nimport { useRbac } from './composables'\nimport { evaluateRouteRule, type RbacRouteRule } from './rule'\nimport type { RbacPublicConfig } from './types'\n\n/**\n * Global route middleware: enforces `definePageMeta({ rbac: { ... } })` against the snapshot.\n * Guests go to `guestRedirect` / `unauthenticatedRedirect` (else a 401 error), users without\n * access to `redirect` / `forbiddenRedirect` (else a 403 error).\n */\nexport default defineNuxtRouteMiddleware((to) => {\n const rule = to.meta['rbac'] as RbacRouteRule | undefined\n if (!rule) return\n\n const rbac = useRbac()\n const result = evaluateRouteRule(rbac, rule, rbac.isGuest())\n if (result.ok) return\n\n const config = (useRuntimeConfig().public['rbac'] ?? {}) as Partial<RbacPublicConfig>\n const redirect =\n result.status === 401\n ? (rule.guestRedirect ?? config.unauthenticatedRedirect)\n : (rule.redirect ?? config.forbiddenRedirect)\n if (redirect && redirect !== to.path) return navigateTo(redirect)\n\n return abortNavigation(\n createError({\n statusCode: result.status,\n statusMessage: result.status === 401 ? 'Unauthorized' : 'Forbidden',\n data:\n result.status === 401\n ? { error: result.error, message: 'User is not logged in.' }\n : { error: result.error, reason: result.reason, message: result.message },\n }),\n )\n})\n"]}
@@ -0,0 +1,13 @@
1
+ import { type NuxtRbac } from './types';
2
+ /**
3
+ * Installs the Vue integration and hydrates the snapshot:
4
+ * on the server from `event.context.rbac` (set by `createRbacServer().resolve(event)`),
5
+ * on the client from the `useState` payload.
6
+ */
7
+ declare const _default: import("#app").Plugin<{
8
+ rbac: NuxtRbac;
9
+ }> & import("#app").ObjectPlugin<{
10
+ rbac: NuxtRbac;
11
+ }>;
12
+ export default _default;
13
+ //# sourceMappingURL=plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/runtime/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAoC,MAAM,SAAS,CAAA;AASzE;;;;GAIG;;;;;;AACH,wBAmCE"}
@@ -0,0 +1,41 @@
1
+ import { STATE_KEY } from '../chunk-SWBMHFPA.js';
2
+ import { createRbacPlugin } from '@anievo-id/rbac-evolution-vue';
3
+ import { defineNuxtPlugin, useRuntimeConfig, useState } from '#app';
4
+
5
+ var isSnapshotSource = (value) => typeof value === "object" && value !== null && typeof value.snapshot === "function";
6
+ var plugin_default = defineNuxtPlugin({
7
+ name: "rbac-evolution",
8
+ async setup(nuxtApp) {
9
+ const config = useRuntimeConfig().public["rbac"] ?? {};
10
+ const state = useState(STATE_KEY, () => null);
11
+ const event = nuxtApp.ssrContext?.event;
12
+ if (event?.context) {
13
+ const source = event.context["rbac"];
14
+ state.value = isSnapshotSource(source) ? await source.snapshot() : null;
15
+ }
16
+ const options = {
17
+ snapshot: state.value,
18
+ wildcard: config.wildcard ?? false,
19
+ superAdminRoles: config.superAdminRoles ?? [],
20
+ directives: config.directives ?? true,
21
+ components: config.components ?? true,
22
+ globalProperties: config.globalProperties ?? true
23
+ };
24
+ const plugin = createRbacPlugin(options);
25
+ nuxtApp.vueApp.use(plugin);
26
+ const { install: _install, ...vueRbac } = plugin;
27
+ const rbac = {
28
+ ...vueRbac,
29
+ setSnapshot(snapshot) {
30
+ state.value = snapshot;
31
+ plugin.setSnapshot(snapshot);
32
+ },
33
+ isGuest: () => state.value === null
34
+ };
35
+ return { provide: { rbac } };
36
+ }
37
+ });
38
+
39
+ export { plugin_default as default };
40
+ //# sourceMappingURL=plugin.js.map
41
+ //# sourceMappingURL=plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/runtime/plugin.ts"],"names":[],"mappings":";;;;AASA,IAAM,gBAAA,GAAmB,CAAC,KAAA,KACxB,OAAO,KAAA,KAAU,YAAY,KAAA,KAAU,IAAA,IAAQ,OAAQ,KAAA,CAAkC,QAAA,KAAa,UAAA;AAOxG,IAAO,iBAAQ,gBAAA,CAAiB;AAAA,EAC9B,IAAA,EAAM,gBAAA;AAAA,EACN,MAAM,MAAM,OAAA,EAAS;AACnB,IAAA,MAAM,SAAU,gBAAA,EAAiB,CAAE,MAAA,CAAO,MAAM,KAAK,EAAC;AACtD,IAAA,MAAM,KAAA,GAAQ,QAAA,CAA8B,SAAA,EAAW,MAAM,IAAI,CAAA;AAEjE,IAAA,MAAM,KAAA,GAAQ,QAAQ,UAAA,EAAY,KAAA;AAClC,IAAA,IAAI,OAAO,OAAA,EAAS;AAClB,MAAA,MAAM,MAAA,GAAS,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA;AACnC,MAAA,KAAA,CAAM,QAAQ,gBAAA,CAAiB,MAAM,IAAI,MAAM,MAAA,CAAO,UAAS,GAAI,IAAA;AAAA,IACrE;AAEA,IAAA,MAAM,OAAA,GAA6B;AAAA,MACjC,UAAU,KAAA,CAAM,KAAA;AAAA,MAChB,QAAA,EAAU,OAAO,QAAA,IAAY,KAAA;AAAA,MAC7B,eAAA,EAAiB,MAAA,CAAO,eAAA,IAAmB,EAAC;AAAA,MAC5C,UAAA,EAAY,OAAO,UAAA,IAAc,IAAA;AAAA,MACjC,UAAA,EAAY,OAAO,UAAA,IAAc,IAAA;AAAA,MACjC,gBAAA,EAAkB,OAAO,gBAAA,IAAoB;AAAA,KAC/C;AACA,IAAA,MAAM,MAAA,GAAS,iBAAiB,OAAO,CAAA;AACvC,IAAA,OAAA,CAAQ,MAAA,CAAO,IAAI,MAAM,CAAA;AAEzB,IAAA,MAAM,EAAE,OAAA,EAAS,QAAA,EAAU,GAAG,SAAQ,GAAI,MAAA;AAC1C,IAAA,MAAM,IAAA,GAAiB;AAAA,MACrB,GAAG,OAAA;AAAA,MACH,YAAY,QAAA,EAAU;AACpB,QAAA,KAAA,CAAM,KAAA,GAAQ,QAAA;AACd,QAAA,MAAA,CAAO,YAAY,QAAQ,CAAA;AAAA,MAC7B,CAAA;AAAA,MACA,OAAA,EAAS,MAAM,KAAA,CAAM,KAAA,KAAU;AAAA,KACjC;AAEA,IAAA,OAAO,EAAE,OAAA,EAAS,EAAE,IAAA,EAAK,EAAE;AAAA,EAC7B;AACF,CAAC","file":"plugin.js","sourcesContent":["import type { RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport { createRbacPlugin, type RbacPluginOptions } from '@anievo-id/rbac-evolution-vue'\nimport { defineNuxtPlugin, useRuntimeConfig, useState } from '#app'\nimport { type NuxtRbac, type RbacPublicConfig, STATE_KEY } from './types'\n\ninterface SnapshotSource {\n snapshot(): Promise<RbacSnapshot>\n}\n\nconst isSnapshotSource = (value: unknown): value is SnapshotSource =>\n typeof value === 'object' && value !== null && typeof (value as Partial<SnapshotSource>).snapshot === 'function'\n\n/**\n * Installs the Vue integration and hydrates the snapshot:\n * on the server from `event.context.rbac` (set by `createRbacServer().resolve(event)`),\n * on the client from the `useState` payload.\n */\nexport default defineNuxtPlugin({\n name: 'rbac-evolution',\n async setup(nuxtApp) {\n const config = (useRuntimeConfig().public['rbac'] ?? {}) as Partial<RbacPublicConfig>\n const state = useState<RbacSnapshot | null>(STATE_KEY, () => null)\n\n const event = nuxtApp.ssrContext?.event as { context?: Record<string, unknown> } | undefined\n if (event?.context) {\n const source = event.context['rbac']\n state.value = isSnapshotSource(source) ? await source.snapshot() : null\n }\n\n const options: RbacPluginOptions = {\n snapshot: state.value,\n wildcard: config.wildcard ?? false,\n superAdminRoles: config.superAdminRoles ?? [],\n directives: config.directives ?? true,\n components: config.components ?? true,\n globalProperties: config.globalProperties ?? true,\n }\n const plugin = createRbacPlugin(options)\n nuxtApp.vueApp.use(plugin)\n\n const { install: _install, ...vueRbac } = plugin\n const rbac: NuxtRbac = {\n ...vueRbac,\n setSnapshot(snapshot) {\n state.value = snapshot\n plugin.setSnapshot(snapshot)\n },\n isGuest: () => state.value === null,\n }\n\n return { provide: { rbac } }\n },\n})\n"]}
@@ -0,0 +1,38 @@
1
+ import type { VueRbac } from '@anievo-id/rbac-evolution-vue';
2
+ import { type RequirementKind, type RequirementNames } from '../requirements';
3
+ /** `definePageMeta({ rbac: { ... } })` — same semantics as the Express / Nest guards. */
4
+ export interface RbacRouteRule {
5
+ /** Every name is required; `'a|b'` = any of them. With `any: true`, any of all the names. */
6
+ permission?: RequirementNames;
7
+ /** Any of the roles; with `all: true`, all of them. `'a|b'` is supported. */
8
+ role?: RequirementNames;
9
+ /** Any of the names, as a role OR as a permission. */
10
+ roleOrPermission?: RequirementNames;
11
+ /** Permissions: pass with ANY of them instead of all. */
12
+ any?: boolean;
13
+ /** Roles: require ALL of them instead of any. */
14
+ all?: boolean;
15
+ /** Where to send a user who lacks access. Default: the module's `forbiddenRedirect`, else a 403 error page. */
16
+ redirect?: string;
17
+ /** Where to send a guest. Default: the module's `unauthenticatedRedirect`, else a 401 error page. */
18
+ guestRedirect?: string;
19
+ }
20
+ export type RouteRuleResult = {
21
+ ok: true;
22
+ } | {
23
+ ok: false;
24
+ status: 401;
25
+ error: 'UNAUTHENTICATED';
26
+ } | {
27
+ ok: false;
28
+ status: 403;
29
+ error: 'FORBIDDEN';
30
+ reason: RequirementKind;
31
+ message: string;
32
+ };
33
+ /**
34
+ * Evaluates a route rule against the client-side snapshot. Pure and synchronous —
35
+ * used by the `rbac` route middleware, exported for custom middleware.
36
+ */
37
+ export declare function evaluateRouteRule(rbac: VueRbac, rule: RbacRouteRule, isGuest: boolean): RouteRuleResult;
38
+ //# sourceMappingURL=rule.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/runtime/rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAA+B,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAE1G,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,6FAA6F;IAC7F,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,yDAAyD;IACzD,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,iDAAiD;IACjD,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAK5F;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAyBvG"}
@@ -0,0 +1,4 @@
1
+ export { evaluateRouteRule } from '../chunk-55P6WQGS.js';
2
+ import '../chunk-NRX4JOTB.js';
3
+ //# sourceMappingURL=rule.js.map
4
+ //# sourceMappingURL=rule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"rule.js"}
@@ -0,0 +1,22 @@
1
+ import type { RbacSnapshot } from '@anievo-id/rbac-evolution';
2
+ import type { VueRbac } from '@anievo-id/rbac-evolution-vue';
3
+ /** Module options as exposed in `runtimeConfig.public.rbac`. */
4
+ export interface RbacPublicConfig {
5
+ wildcard: boolean;
6
+ superAdminRoles: string[];
7
+ directives: boolean;
8
+ components: boolean;
9
+ globalProperties: boolean;
10
+ unauthenticatedRedirect: string;
11
+ forbiddenRedirect: string;
12
+ }
13
+ /** The RBAC instance provided as `$rbac` / returned by `useRbac()`. */
14
+ export interface NuxtRbac extends VueRbac {
15
+ /** Replaces the snapshot (and the SSR state), e.g. after login (`snapshot`) or logout (`null`). */
16
+ setSnapshot(snapshot: RbacSnapshot | null): void;
17
+ /** `true` when there is no subject (the server resolved a guest, or `setSnapshot(null)`). */
18
+ isGuest(): boolean;
19
+ }
20
+ /** `useState` key holding the snapshot serialized from SSR. */
21
+ export declare const STATE_KEY = "rbac-evolution:snapshot";
22
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAE5D,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;IACzB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,uEAAuE;AACvE,MAAM,WAAW,QAAS,SAAQ,OAAO;IACvC,mGAAmG;IACnG,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAAA;IAChD,6FAA6F;IAC7F,OAAO,IAAI,OAAO,CAAA;CACnB;AAED,+DAA+D;AAC/D,eAAO,MAAM,SAAS,4BAA4B,CAAA"}
@@ -0,0 +1,3 @@
1
+ export { STATE_KEY } from '../chunk-SWBMHFPA.js';
2
+ //# sourceMappingURL=types.js.map
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * @anievo-id/rbac-evolution-nuxt/server
3
+ *
4
+ * Server-side enforcement for Nitro / h3 event handlers. Runs on the server only.
5
+ */
6
+ import type { Rbac, RbacSnapshot, Subject, SubjectRbac, TeamId } from '@anievo-id/rbac-evolution';
7
+ import { type RequirementKind, type RequirementNames } from './requirements';
8
+ export type { RequirementKind, RequirementNames } from './requirements';
9
+ type MaybePromise<T> = T | Promise<T>;
10
+ /** The part of an h3 `H3Event` this helper uses. */
11
+ export interface RbacEvent {
12
+ context: object;
13
+ }
14
+ export interface RbacServerOptions<E extends RbacEvent = RbacEvent> {
15
+ /** The RBAC engine created with `createRbac(...)`. */
16
+ rbac: Rbac;
17
+ /** Resolves the authenticated subject for this request (e.g. from a session). `null` / `undefined` for guests. */
18
+ getSubject: (event: E) => MaybePromise<Subject | null | undefined>;
19
+ /** Guard name (e.g. `web` or `api`). Defaults to the engine's `defaultGuard`. */
20
+ guard?: string;
21
+ /** Resolves the current team (only when the engine was created with `teams: true`). */
22
+ team?: (event: E) => MaybePromise<TeamId | undefined>;
23
+ /** Include the required roles/permissions in the 403 body (`required`). Default: `false`. */
24
+ exposeRequirements?: boolean;
25
+ }
26
+ export interface PermissionRequirementOptions {
27
+ /** Pass when the subject has ANY of the permissions (instead of all). Default: `false`. */
28
+ any?: boolean;
29
+ }
30
+ export interface RoleRequirementOptions {
31
+ /** Require ALL of the roles (instead of any). Default: `false`. */
32
+ all?: boolean;
33
+ }
34
+ /** The JSON body of a failed check — identical to `@anievo-id/rbac-evolution-express`. */
35
+ export type RbacErrorBody = {
36
+ error: 'UNAUTHENTICATED';
37
+ message: string;
38
+ } | {
39
+ error: 'FORBIDDEN';
40
+ reason: RequirementKind;
41
+ message: string;
42
+ required?: string[][];
43
+ };
44
+ /**
45
+ * Thrown by the `require*` helpers. h3 turns it into an error response with this `statusCode`
46
+ * and the Express-style body under `data`.
47
+ *
48
+ * It is shaped like h3's `H3Error` (including the `__h3_error__` marker h3 checks), so h3 / Nitro
49
+ * treat it as an expected HTTP error instead of logging it as an unhandled exception —
50
+ * without this package depending on h3.
51
+ */
52
+ export declare class RbacHttpError extends Error {
53
+ static readonly __h3_error__ = true;
54
+ readonly statusCode: 401 | 403;
55
+ readonly statusMessage: string;
56
+ readonly data: RbacErrorBody;
57
+ readonly fatal = false;
58
+ readonly unhandled = false;
59
+ constructor(data: RbacErrorBody);
60
+ /** Alias of `statusCode`. */
61
+ get status(): 401 | 403;
62
+ toJSON(): {
63
+ message: string;
64
+ statusCode: 401 | 403;
65
+ statusMessage: string;
66
+ data: RbacErrorBody;
67
+ };
68
+ }
69
+ export interface RbacServer<E extends RbacEvent = RbacEvent> {
70
+ /**
71
+ * Resolves the subject once per request and stores it on `event.context.rbac`
72
+ * (a `SubjectRbac`, or `null` for guests). The Nuxt plugin reads it to hydrate the client.
73
+ */
74
+ resolve(event: E): Promise<SubjectRbac | null>;
75
+ /** The current subject's `{ roles, permissions }`, or `null` for guests. */
76
+ snapshot(event: E): Promise<RbacSnapshot | null>;
77
+ /** Like Express `requirePermission`: arguments are all required, pipes mean any, `{ any: true }`. */
78
+ requirePermission(event: E, ...args: (RequirementNames | PermissionRequirementOptions)[]): Promise<SubjectRbac>;
79
+ /** Like Express `requireRole`: any of the roles, `{ all: true }` for all. */
80
+ requireRole(event: E, ...args: (RequirementNames | RoleRequirementOptions)[]): Promise<SubjectRbac>;
81
+ /** Like Express `requireRoleOrPermission`: any of the names as a role OR a permission. */
82
+ requireRoleOrPermission(event: E, ...names: RequirementNames[]): Promise<SubjectRbac>;
83
+ }
84
+ /**
85
+ * Creates request helpers for Nitro event handlers.
86
+ *
87
+ * ```ts
88
+ * // server/utils/rbac.ts
89
+ * export const rbacServer = createRbacServer({
90
+ * rbac,
91
+ * getSubject: async (event) => {
92
+ * const user = await getUserFromSession(event)
93
+ * return user ? { type: 'user', id: user.id } : null
94
+ * },
95
+ * })
96
+ *
97
+ * // server/api/articles.post.ts
98
+ * export default defineEventHandler(async (event) => {
99
+ * await rbacServer.requirePermission(event, 'articles.create')
100
+ * })
101
+ * ```
102
+ */
103
+ export declare function createRbacServer<E extends RbacEvent = RbacEvent>(options: RbacServerOptions<E>): RbacServer<E>;
104
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AACjG,OAAO,EAA+B,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAA2B,MAAM,gBAAgB,CAAA;AAElI,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEvE,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAErC,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAChE,sDAAsD;IACtD,IAAI,EAAE,IAAI,CAAA;IACV,kHAAkH;IAClH,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IAClE,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uFAAuF;IACvF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACrD,6FAA6F;IAC7F,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,2FAA2F;IAC3F,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GACrB;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAAA;AAE3F;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,MAAM,CAAC,QAAQ,CAAC,YAAY,QAAO;IACnC,QAAQ,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,KAAK,SAAQ;IACtB,QAAQ,CAAC,SAAS,SAAQ;gBAEd,IAAI,EAAE,aAAa;IAQ/B,6BAA6B;IAC7B,IAAI,MAAM,IAAI,GAAG,GAAG,GAAG,CAEtB;IAED,MAAM;;;;;;CAGP;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IACzD;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAChD,qGAAqG;IACrG,iBAAiB,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,gBAAgB,GAAG,4BAA4B,CAAC,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC/G,6EAA6E;IAC7E,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IACnG,0FAA0F;IAC1F,uBAAuB,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CACtF;AAkBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CA0D9G"}
package/dist/server.js ADDED
@@ -0,0 +1,97 @@
1
+ import { requirementGroups, UNAUTHENTICATED_MESSAGE, MESSAGES } from './chunk-NRX4JOTB.js';
2
+
3
+ // src/server.ts
4
+ var RbacHttpError = class extends Error {
5
+ static __h3_error__ = true;
6
+ statusCode;
7
+ statusMessage;
8
+ data;
9
+ fatal = false;
10
+ unhandled = false;
11
+ constructor(data) {
12
+ super(data.message);
13
+ this.name = "RbacHttpError";
14
+ this.statusCode = data.error === "UNAUTHENTICATED" ? 401 : 403;
15
+ this.statusMessage = data.error === "UNAUTHENTICATED" ? "Unauthorized" : "Forbidden";
16
+ this.data = data;
17
+ }
18
+ /** Alias of `statusCode`. */
19
+ get status() {
20
+ return this.statusCode;
21
+ }
22
+ toJSON() {
23
+ return { message: this.message, statusCode: this.statusCode, statusMessage: this.statusMessage, data: this.data };
24
+ }
25
+ };
26
+ var CONTEXT_KEY = "rbac";
27
+ function parseArgs(args) {
28
+ const last = args[args.length - 1];
29
+ if (last !== void 0 && typeof last === "object" && !Array.isArray(last)) {
30
+ return { names: args.slice(0, -1), options: last };
31
+ }
32
+ return { names: args, options: void 0 };
33
+ }
34
+ async function passes(rbac, kind, group) {
35
+ if (kind === "permission") return rbac.canAny(group);
36
+ if (kind === "role") return rbac.hasAnyRole(group);
37
+ return await rbac.hasAnyRole(group) || rbac.canAny(group);
38
+ }
39
+ function createRbacServer(options) {
40
+ const { rbac, getSubject, guard, team, exposeRequirements = false } = options;
41
+ async function resolve(event) {
42
+ const context = event.context;
43
+ const cached = context[CONTEXT_KEY];
44
+ if (cached !== void 0) return cached;
45
+ const subject = await getSubject(event);
46
+ let result = null;
47
+ if (subject) {
48
+ const teamId = team ? await team(event) : void 0;
49
+ result = rbac.for(subject, {
50
+ ...guard !== void 0 && { guard },
51
+ ...teamId !== void 0 && { team: teamId }
52
+ });
53
+ }
54
+ context[CONTEXT_KEY] = result;
55
+ return result;
56
+ }
57
+ async function enforce(event, kind, requirements) {
58
+ if (requirements.length === 0) {
59
+ throw new TypeError(`[rbac-evolution] A ${kind} requirement needs at least one name.`);
60
+ }
61
+ const subject = await resolve(event);
62
+ if (subject === null) throw new RbacHttpError({ error: "UNAUTHENTICATED", message: UNAUTHENTICATED_MESSAGE });
63
+ for (const group of requirements) {
64
+ if (!await passes(subject, kind, group)) {
65
+ throw new RbacHttpError({
66
+ error: "FORBIDDEN",
67
+ reason: kind,
68
+ message: MESSAGES[kind],
69
+ ...exposeRequirements && { required: requirements }
70
+ });
71
+ }
72
+ }
73
+ return subject;
74
+ }
75
+ return {
76
+ resolve,
77
+ async snapshot(event) {
78
+ const subject = await resolve(event);
79
+ return subject ? subject.snapshot() : null;
80
+ },
81
+ requirePermission(event, ...args) {
82
+ const { names, options: opts } = parseArgs(args);
83
+ return enforce(event, "permission", requirementGroups("permission", names, { any: opts?.any }));
84
+ },
85
+ requireRole(event, ...args) {
86
+ const { names, options: opts } = parseArgs(args);
87
+ return enforce(event, "role", requirementGroups("role", names, { all: opts?.all }));
88
+ },
89
+ requireRoleOrPermission(event, ...names) {
90
+ return enforce(event, "role_or_permission", requirementGroups("role_or_permission", names));
91
+ }
92
+ };
93
+ }
94
+
95
+ export { RbacHttpError, createRbacServer };
96
+ //# sourceMappingURL=server.js.map
97
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/server.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["/**\n * @anievo-id/rbac-evolution-nuxt/server\n *\n * Server-side enforcement for Nitro / h3 event handlers. Runs on the server only.\n */\n\nimport type { Rbac, RbacSnapshot, Subject, SubjectRbac, TeamId } from '@anievo-id/rbac-evolution'\nimport { MESSAGES, requirementGroups, type RequirementKind, type RequirementNames, UNAUTHENTICATED_MESSAGE } from './requirements'\n\nexport type { RequirementKind, RequirementNames } from './requirements'\n\ntype MaybePromise<T> = T | Promise<T>\n\n/** The part of an h3 `H3Event` this helper uses. */\nexport interface RbacEvent {\n context: object\n}\n\nexport interface RbacServerOptions<E extends RbacEvent = RbacEvent> {\n /** The RBAC engine created with `createRbac(...)`. */\n rbac: Rbac\n /** Resolves the authenticated subject for this request (e.g. from a session). `null` / `undefined` for guests. */\n getSubject: (event: E) => MaybePromise<Subject | null | undefined>\n /** Guard name (e.g. `web` or `api`). Defaults to the engine's `defaultGuard`. */\n guard?: string\n /** Resolves the current team (only when the engine was created with `teams: true`). */\n team?: (event: E) => MaybePromise<TeamId | undefined>\n /** Include the required roles/permissions in the 403 body (`required`). Default: `false`. */\n exposeRequirements?: boolean\n}\n\nexport interface PermissionRequirementOptions {\n /** Pass when the subject has ANY of the permissions (instead of all). Default: `false`. */\n any?: boolean\n}\n\nexport interface RoleRequirementOptions {\n /** Require ALL of the roles (instead of any). Default: `false`. */\n all?: boolean\n}\n\n/** The JSON body of a failed check — identical to `@anievo-id/rbac-evolution-express`. */\nexport type RbacErrorBody =\n | { error: 'UNAUTHENTICATED'; message: string }\n | { error: 'FORBIDDEN'; reason: RequirementKind; message: string; required?: string[][] }\n\n/**\n * Thrown by the `require*` helpers. h3 turns it into an error response with this `statusCode`\n * and the Express-style body under `data`.\n *\n * It is shaped like h3's `H3Error` (including the `__h3_error__` marker h3 checks), so h3 / Nitro\n * treat it as an expected HTTP error instead of logging it as an unhandled exception —\n * without this package depending on h3.\n */\nexport class RbacHttpError extends Error {\n static readonly __h3_error__ = true\n readonly statusCode: 401 | 403\n readonly statusMessage: string\n readonly data: RbacErrorBody\n readonly fatal = false\n readonly unhandled = false\n\n constructor(data: RbacErrorBody) {\n super(data.message)\n this.name = 'RbacHttpError'\n this.statusCode = data.error === 'UNAUTHENTICATED' ? 401 : 403\n this.statusMessage = data.error === 'UNAUTHENTICATED' ? 'Unauthorized' : 'Forbidden'\n this.data = data\n }\n\n /** Alias of `statusCode`. */\n get status(): 401 | 403 {\n return this.statusCode\n }\n\n toJSON() {\n return { message: this.message, statusCode: this.statusCode, statusMessage: this.statusMessage, data: this.data }\n }\n}\n\nexport interface RbacServer<E extends RbacEvent = RbacEvent> {\n /**\n * Resolves the subject once per request and stores it on `event.context.rbac`\n * (a `SubjectRbac`, or `null` for guests). The Nuxt plugin reads it to hydrate the client.\n */\n resolve(event: E): Promise<SubjectRbac | null>\n /** The current subject's `{ roles, permissions }`, or `null` for guests. */\n snapshot(event: E): Promise<RbacSnapshot | null>\n /** Like Express `requirePermission`: arguments are all required, pipes mean any, `{ any: true }`. */\n requirePermission(event: E, ...args: (RequirementNames | PermissionRequirementOptions)[]): Promise<SubjectRbac>\n /** Like Express `requireRole`: any of the roles, `{ all: true }` for all. */\n requireRole(event: E, ...args: (RequirementNames | RoleRequirementOptions)[]): Promise<SubjectRbac>\n /** Like Express `requireRoleOrPermission`: any of the names as a role OR a permission. */\n requireRoleOrPermission(event: E, ...names: RequirementNames[]): Promise<SubjectRbac>\n}\n\nconst CONTEXT_KEY = 'rbac'\n\nfunction parseArgs<O extends object>(args: readonly (RequirementNames | O)[]): { names: RequirementNames[]; options: O | undefined } {\n const last = args[args.length - 1]\n if (last !== undefined && typeof last === 'object' && !Array.isArray(last)) {\n return { names: args.slice(0, -1) as RequirementNames[], options: last as O }\n }\n return { names: args as RequirementNames[], options: undefined }\n}\n\nasync function passes(rbac: SubjectRbac, kind: RequirementKind, group: string[]): Promise<boolean> {\n if (kind === 'permission') return rbac.canAny(group)\n if (kind === 'role') return rbac.hasAnyRole(group)\n return (await rbac.hasAnyRole(group)) || rbac.canAny(group)\n}\n\n/**\n * Creates request helpers for Nitro event handlers.\n *\n * ```ts\n * // server/utils/rbac.ts\n * export const rbacServer = createRbacServer({\n * rbac,\n * getSubject: async (event) => {\n * const user = await getUserFromSession(event)\n * return user ? { type: 'user', id: user.id } : null\n * },\n * })\n *\n * // server/api/articles.post.ts\n * export default defineEventHandler(async (event) => {\n * await rbacServer.requirePermission(event, 'articles.create')\n * })\n * ```\n */\nexport function createRbacServer<E extends RbacEvent = RbacEvent>(options: RbacServerOptions<E>): RbacServer<E> {\n const { rbac, getSubject, guard, team, exposeRequirements = false } = options\n\n async function resolve(event: E): Promise<SubjectRbac | null> {\n const context = event.context as Record<string, unknown>\n const cached = context[CONTEXT_KEY]\n if (cached !== undefined) return cached as SubjectRbac | null\n\n const subject = await getSubject(event)\n let result: SubjectRbac | null = null\n if (subject) {\n const teamId = team ? await team(event) : undefined\n result = rbac.for(subject, {\n ...(guard !== undefined && { guard }),\n ...(teamId !== undefined && { team: teamId }),\n })\n }\n context[CONTEXT_KEY] = result\n return result\n }\n\n async function enforce(event: E, kind: RequirementKind, requirements: string[][]): Promise<SubjectRbac> {\n if (requirements.length === 0) {\n throw new TypeError(`[rbac-evolution] A ${kind} requirement needs at least one name.`)\n }\n const subject = await resolve(event)\n if (subject === null) throw new RbacHttpError({ error: 'UNAUTHENTICATED', message: UNAUTHENTICATED_MESSAGE })\n for (const group of requirements) {\n if (!(await passes(subject, kind, group))) {\n throw new RbacHttpError({\n error: 'FORBIDDEN',\n reason: kind,\n message: MESSAGES[kind],\n ...(exposeRequirements && { required: requirements }),\n })\n }\n }\n return subject\n }\n\n return {\n resolve,\n async snapshot(event) {\n const subject = await resolve(event)\n return subject ? subject.snapshot() : null\n },\n requirePermission(event, ...args) {\n const { names, options: opts } = parseArgs<PermissionRequirementOptions>(args)\n return enforce(event, 'permission', requirementGroups('permission', names, { any: opts?.any }))\n },\n requireRole(event, ...args) {\n const { names, options: opts } = parseArgs<RoleRequirementOptions>(args)\n return enforce(event, 'role', requirementGroups('role', names, { all: opts?.all }))\n },\n requireRoleOrPermission(event, ...names) {\n return enforce(event, 'role_or_permission', requirementGroups('role_or_permission', names))\n },\n }\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,79 @@
1
1
  {
2
2
  "name": "@anievo-id/rbac-evolution-nuxt",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.2.1",
4
+ "description": "Nuxt 3/4 module for rbac-evolution: SSR-hydrated permissions, auto-imported composables, route middleware & Nitro helpers.",
5
+ "license": "MIT",
6
+ "author": "AniEvo-ID (https://github.com/AniEvo-ID)",
7
+ "homepage": "https://github.com/AniEvo-ID/rbac-evolution/tree/main/packages/nuxt#readme",
8
+ "bugs": {
9
+ "url": "https://github.com/AniEvo-ID/rbac-evolution/issues"
10
+ },
11
+ "type": "module",
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "git+https://github.com/AniEvo-ID/rbac-evolution.git",
15
+ "directory": "packages/nuxt"
16
+ },
17
+ "keywords": [
18
+ "rbac",
19
+ "permissions",
20
+ "roles",
21
+ "authorization",
22
+ "nuxt",
23
+ "nuxt-module",
24
+ "nitro",
25
+ "vue"
26
+ ],
27
+ "sideEffects": false,
28
+ "module": "./dist/module.js",
29
+ "types": "./dist/module.d.ts",
30
+ "exports": {
31
+ ".": {
32
+ "types": "./dist/module.d.ts",
33
+ "default": "./dist/module.js"
34
+ },
35
+ "./server": {
36
+ "types": "./dist/server.d.ts",
37
+ "default": "./dist/server.js"
38
+ },
39
+ "./rule": {
40
+ "types": "./dist/runtime/rule.d.ts",
41
+ "default": "./dist/runtime/rule.js"
42
+ },
43
+ "./package.json": "./package.json"
44
+ },
45
+ "files": [
46
+ "dist"
47
+ ],
48
+ "publishConfig": {
49
+ "access": "public"
50
+ },
51
+ "dependencies": {
52
+ "@nuxt/kit": "^3.13.0 || ^4.0.0",
53
+ "@anievo-id/rbac-evolution-vue": "^0.2.1",
54
+ "@anievo-id/rbac-evolution": "^0.2.1"
55
+ },
56
+ "peerDependencies": {
57
+ "nuxt": "^3.0.0 || ^4.0.0",
58
+ "vue": ">=3.3"
59
+ },
60
+ "devDependencies": {
61
+ "@nuxt/schema": "^4.6.4",
62
+ "h3": "^1.15.11",
63
+ "nuxt": "^4.6.4",
64
+ "tsup": "^8.3.0",
65
+ "typescript": "^5.7.0",
66
+ "vitest": "^2.1.0",
67
+ "vue": "^3.5.45"
68
+ },
69
+ "engines": {
70
+ "node": ">=20"
71
+ },
72
+ "scripts": {
73
+ "build": "tsup && tsc -p tsconfig.build.json",
74
+ "dev": "tsup --watch",
75
+ "typecheck": "tsc --noEmit",
76
+ "test": "vitest run --passWithNoTests",
77
+ "clean": "rm -rf dist .turbo"
78
+ }
6
79
  }