@anievo-id/rbac-evolution-next 0.7.1 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,239 +1,45 @@
1
1
  # @anievo-id/rbac-evolution-next
2
2
 
3
- 📖 **[Documentation](https://creation.anievo.id/rbac-evolution/frameworks/nextjs)**
3
+ Next.js App Router helpers for [RBAC Evolution](https://github.com/AniEvo-ID/rbac-evolution): guards for server
4
+ components, server actions and route handlers, plus route rules for `middleware.ts`.
4
5
 
5
- Next.js (App Router) helpers for [rbac-evolution](https://github.com/AniEvo-ID/rbac-evolution): guards for server components, server actions and route
6
- handlers, plus route protection in `middleware.ts` — the Next.js counterpart of spatie/laravel-permission's
7
- `permission`, `role` and `role_or_permission` middleware.
6
+ ## Install
8
7
 
9
8
  ```bash
10
- npm i @anievo-id/rbac-evolution @anievo-id/rbac-evolution-next
11
- # for client-side <Can> / useCan():
12
- npm i @anievo-id/rbac-evolution-react
9
+ npm i @anievo-id/rbac-evolution @anievo-id/rbac-evolution-next next react
10
+ npm i @anievo-id/rbac-evolution-react # optional, for <Can> / useCan() in client components
13
11
  ```
14
12
 
15
- `next` (14+) and `react` are peer dependencies. This package is server-only; it does not re-export the React bindings.
16
-
17
- ## Setup
18
-
19
- You resolve the session yourself (Auth.js, Clerk, Lucia, iron-session, ...) and tell rbac-evolution who the
20
- current subject is:
13
+ ## Usage
21
14
 
22
15
  ```ts
23
16
  // lib/rbac.ts
24
17
  import { createRbac } from '@anievo-id/rbac-evolution'
25
18
  import { createNextRbac } from '@anievo-id/rbac-evolution-next'
26
- import { PrismaAdapter } from '@anievo-id/rbac-evolution-prisma'
27
- import { auth } from '@/auth'
28
- import { prisma } from '@/lib/prisma'
19
+ import { auth } from '@/auth' // your session library (Auth.js, Clerk, Lucia, ...)
29
20
 
30
- export const rbac = createRbac({ adapter: new PrismaAdapter(prisma), wildcard: true })
21
+ export const rbac = createRbac({ adapter })
31
22
 
32
- export const {
33
- getSnapshot,
34
- can,
35
- hasRole,
36
- requirePermission,
37
- requireRole,
38
- withPermission,
39
- withRbac,
40
- } = createNextRbac({
23
+ export const { getSnapshot, requirePermission, withPermission, withRbac } = createNextRbac({
41
24
  rbac,
42
25
  getSubject: async () => {
43
26
  const session = await auth()
44
27
  return session?.user?.id ? { type: 'user', id: session.user.id } : null
45
28
  },
46
- loginUrl: '/login', // optional: where require*() sends guests
47
- // guard: 'web', // optional default guard
48
- // team: async () => (await cookies()).get('team')?.value, // optional default team
49
- })
50
- ```
51
-
52
- ## Server components → `RbacProvider` → `<Can>`
53
-
54
- ```tsx
55
- // app/layout.tsx (server component)
56
- import { RbacProvider } from '@anievo-id/rbac-evolution-react'
57
- import { getSnapshot, rbac } from '@/lib/rbac'
58
-
59
- export default async function RootLayout({ children }: { children: React.ReactNode }) {
60
- return (
61
- <html lang="en">
62
- <body>
63
- {/* guests get { roles: [], permissions: [] } */}
64
- <RbacProvider snapshot={await getSnapshot()} wildcard={rbac.wildcard}>
65
- {children}
66
- </RbacProvider>
67
- </body>
68
- </html>
69
- )
70
- }
71
- ```
72
-
73
- ```tsx
74
- // app/articles/[id]/toolbar.tsx (client component)
75
- 'use client'
76
-
77
- import { Can } from '@anievo-id/rbac-evolution-react'
78
-
79
- export function Toolbar() {
80
- return (
81
- <Can permission="articles.edit" fallback={<span>Read only</span>}>
82
- <button>Edit</button>
83
- </Can>
84
- )
85
- }
86
- ```
87
-
88
- `<Can>` only hides UI. The page, actions and APIs below must still be protected on the server:
89
-
90
- ## Protecting pages
91
-
92
- ```tsx
93
- // app/admin/page.tsx
94
- import { requireRole } from '@/lib/rbac'
95
-
96
- export default async function AdminPage() {
97
- const user = await requireRole('admin') // returns the subject when allowed
98
- return <h1>Admin</h1>
99
- }
100
- ```
101
-
102
- `requirePermission(permission | permissions[], opts?)`, `requireRole(role | roles[], opts?)` and
103
- `requireRoleOrPermission(items, opts?)` — arrays and `'a|b'` strings mean "any of" (like spatie's
104
- `permission:a|b` and `canAny()`). Pass `{ all: true }` to `requirePermission` / `requireRole` (or `all: true` in a
105
- `withRbac` option or middleware rule) to require every entry, like spatie v8.5's `canAll()`.
106
-
107
- On failure (both configurable per factory or per call):
108
-
109
- | Case | Default | Option |
110
- | ------------------------------ | ----------------------------------------------------------- | ------------------- |
111
- | Guest (`getSubject()` → null) | `redirect(loginUrl)` if `loginUrl` is set, else `notFound()` | `onUnauthenticated` |
112
- | Missing role/permission | `notFound()` (does not reveal the page exists) | `onUnauthorized` |
113
-
114
- ```ts
115
- import { redirect } from 'next/navigation'
116
-
117
- await requirePermission('billing.view', {
118
- onUnauthorized: () => redirect('/403'),
119
- // or, with `experimental.authInterrupts` (Next 15.1+): onUnauthorized: () => forbidden(),
120
29
  })
121
30
  ```
122
31
 
123
- Use `can()`, `canAny()`, `canAll()`, `hasRole()`, `hasAllRoles()` for plain boolean checks, and
124
- `authorize(requirement)` for a non-throwing `{ ok, reason, subject }` result.
125
-
126
- ## Server actions
127
-
128
- ```ts
129
- // app/articles/actions.ts
130
- 'use server'
131
-
132
- import { withPermission } from '@/lib/rbac'
133
-
134
- export const deleteArticle = withPermission('articles.delete', async (id: string) => {
135
- await db.article.delete({ where: { id } })
136
- })
137
- ```
138
-
139
- When access is denied the wrapped action throws `RbacUnauthorizedError` (`reason: 'unauthenticated' | 'unauthorized'`,
140
- `status: 401 | 403`) before running. `withRole(role, action)` works the same. Note that Next.js hides error details
141
- from the client in production; if the UI needs to react, catch it in the action and return a value instead.
142
-
143
- ## Route handlers
144
-
145
- ```ts
146
- // app/api/articles/[id]/route.ts
147
- import { withRbac } from '@/lib/rbac'
148
-
149
- export const DELETE = withRbac(
150
- async (req: Request, { params }: { params: Promise<{ id: string }> }) => {
151
- const { id } = await params
152
- // ...
153
- return Response.json({ deleted: id })
154
- },
155
- { permission: 'articles.delete' }, // or { role: 'admin' } or { roleOrPermission: ['admin', 'articles.delete'] }
156
- )
157
- ```
158
-
159
- Guests get `401 { "error": "UNAUTHENTICATED", "message": … }`, users without access get
160
- `403 { "error": "FORBIDDEN", "reason": "permission" | "role" | "role_or_permission", "message": … }` — the same
161
- bodies as `@anievo-id/rbac-evolution-express`.
162
- `withRbac` also accepts `guard` and `team`.
163
-
164
- ## Guards & teams
165
-
166
- Every helper accepts `{ guard, team }` (passed to `rbac.for(subject, { guard, team })`). Defaults come from the
167
- `guard` / `team` options of `createNextRbac`; `team` may be a function so it can read the current tenant per request.
168
-
169
- ```ts
170
- await can('invoices.view', { team: params.teamId })
171
- ```
172
-
173
- ## Middleware
174
-
175
- ```ts
176
- // middleware.ts
177
- import type { NextRequest } from 'next/server'
178
- import { createRbacMiddleware } from '@anievo-id/rbac-evolution-next/middleware'
179
-
180
- export default createRbacMiddleware<NextRequest>({
181
- rules: [
182
- { matcher: '/admin/:path*', role: 'admin' },
183
- { matcher: '/articles/:id/edit', permission: 'articles.edit' },
184
- { matcher: '/reports/:path*', roleOrPermission: ['manager', 'reports.view'] },
185
- { matcher: '/dashboard/:path*' }, // logged in only
186
- ],
187
- // Snapshot stored in the session/JWT (see below) — works in the Edge runtime:
188
- getSnapshot: async (req) => readSessionSnapshot(req), // RbacSnapshot | null
189
- wildcard: true,
190
- loginUrl: (req) => `/login?callbackUrl=${encodeURIComponent(req.nextUrl.pathname)}`,
191
- })
192
-
193
- export const config = { matcher: ['/admin/:path*', '/articles/:path*', '/reports/:path*', '/dashboard/:path*'] }
194
- ```
195
-
196
- - Matchers support `/exact`, `:param` (one segment), `:path*` (zero or more), `:path+` (one or more), `:param?`,
197
- a `RegExp`, or an array of these. Trailing slashes are ignored.
198
- - Every matching rule must pass; a rule may combine `permission`, `role` and `roleOrPermission` (all must hold).
199
- - Requests matching no rule pass through (the middleware returns `undefined`), so you can compose it:
200
- `const res = await rbacMiddleware(req); if (res) return res`.
201
- - Defaults: guests → redirect to `loginUrl`, or `401` JSON without it; missing access → `403` JSON.
202
- Override with `onUnauthenticated(req, rule)` / `onUnauthorized(req, rule)` returning a `Response`
203
- (e.g. `NextResponse.rewrite(new URL('/403', req.url))`).
204
- - Import from `@anievo-id/rbac-evolution-next/middleware`: this entry does not import `next/navigation`.
205
-
206
- ### Where the roles come from in middleware
207
-
208
- Middleware runs on every matched request, so database lookups there are costly — and **database adapters (Prisma,
209
- Drizzle, ...) do not work in the Edge runtime**, which was the only middleware runtime before Next.js 15.5. Two options:
210
-
211
- 1. **Snapshot in the session/JWT (recommended).** Store `await rbac.for(user).snapshot()` in the token when the
212
- user signs in (e.g. Auth.js `jwt` callback) and return it from `getSnapshot(req)`. Remember to refresh the token
213
- when roles change; the server-side guards above still read live data.
214
- 2. **Use the `rbac` instance with the Node.js middleware runtime** (Next.js 15.5+):
215
-
216
- ```ts
217
- import type { NextRequest } from 'next/server'
218
- import { createRbacMiddleware } from '@anievo-id/rbac-evolution-next/middleware'
219
- import { rbac } from '@/lib/rbac'
220
- import { auth } from '@/auth'
32
+ Then `await requirePermission('articles.edit')` in a page, `withPermission('articles.delete', action)` around a
33
+ server action, and `withRbac(handler, { permission: 'articles.delete' })` around a route handler.
221
34
 
222
- export default createRbacMiddleware<NextRequest>({
223
- rbac,
224
- getSubject: async () => {
225
- const session = await auth()
226
- return session?.user?.id ? { type: 'user', id: session.user.id } : null
227
- },
228
- rules: [{ matcher: '/admin/:path*', role: 'admin' }],
229
- // guard: 'web', team: (req) => req.cookies.get('team')?.value,
230
- })
35
+ - Pages answer `notFound()` by default, so a page the user can't open looks like one that doesn't exist.
36
+ - `createRbacMiddleware` (from `@anievo-id/rbac-evolution-next/middleware`) is a first filter for page navigation.
37
+ Keep the guards in pages, actions and route handlers: they are what protect your data.
38
+ - With a typed engine (`createRbac<AppRbac>()`), every helper type-checks the names.
231
39
 
232
- export const config = { runtime: 'nodejs', matcher: ['/admin/:path*'] }
233
- ```
40
+ ## Documentation
234
41
 
235
- Middleware is a first line of defence for page navigation. Keep the server component / action / route handler
236
- guards — they are what actually protects your data.
42
+ https://creation.anievo.id/rbac-evolution/frameworks/nextjs
237
43
 
238
44
  ## License
239
45
 
package/dist/index.cjs CHANGED
@@ -75,6 +75,10 @@ async function checkRequirement(requirement, can, hasRole) {
75
75
  // src/server.ts
76
76
  var EMPTY_SNAPSHOT = { roles: [], permissions: [] };
77
77
  function createNextRbac(options) {
78
+ const helpers = buildNextRbac(options);
79
+ return helpers;
80
+ }
81
+ function buildNextRbac(options) {
78
82
  const { rbac } = options;
79
83
  async function getSubject() {
80
84
  return await options.getSubject() ?? null;
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/responses.ts","../src/types.ts","../src/server.ts","../src/matcher.ts","../src/snapshot.ts","../src/middleware.ts"],"names":["group","redirect","notFound","options","wildcardImplies"],"mappings":";;;;;;;;AAGO,IAAM,qBAAA,GAAN,cAAoC,KAAA,CAAM;AAAA;AAAA,EAEtC,MAAA;AAAA;AAAA,EAEA,MAAA;AAAA,EAET,WAAA,CAAY,QAAuB,OAAA,EAAkB;AACnD,IAAA,KAAA,CAAM,OAAA,KAAY,MAAA,KAAW,iBAAA,GAAoB,kBAAA,GAAqB,8BAAA,CAA+B,CAAA;AACrG,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AACZ,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA,KAAW,iBAAA,GAAoB,GAAA,GAAM,GAAA;AAAA,EACrD;AACF;;;ACVO,SAAS,gBAAgB,WAAA,EAA2C;AACzE,EAAA,IAAI,WAAA,CAAY,UAAA,KAAe,MAAA,EAAW,OAAO,YAAA;AACjD,EAAA,IAAI,WAAA,CAAY,IAAA,KAAS,MAAA,EAAW,OAAO,MAAA;AAC3C,EAAA,OAAO,oBAAA;AACT;AAGO,SAAS,iBAAiB,WAAA,EAAkC;AACjE,EAAA,QAAQ,eAAA,CAAgB,WAAW,CAAA;AAAG,IACpC,KAAK,YAAA;AACH,MAAA,OAAO,2CAAA;AAAA,IACT,KAAK,MAAA;AACH,MAAA,OAAO,qCAAA;AAAA,IACT;AACE,MAAA,OAAO,wDAAA;AAAA;AAEb;AAGO,SAAS,uBAAA,GAAoC;AAClD,EAAA,OAAO,QAAA,CAAS,IAAA,CAAK,EAAE,KAAA,EAAO,iBAAA,EAAmB,OAAA,EAAS,wBAAA,EAAyB,EAAG,EAAE,MAAA,EAAQ,GAAA,EAAK,CAAA;AACvG;AAGO,SAAS,kBAAkB,WAAA,EAAoC;AACpE,EAAA,OAAO,QAAA,CAAS,IAAA;AAAA,IACd,EAAE,KAAA,EAAO,WAAA,EAAa,MAAA,EAAQ,eAAA,CAAgB,WAAW,CAAA,EAAG,OAAA,EAAS,gBAAA,CAAiB,WAAW,CAAA,EAAE;AAAA,IACnG,EAAE,QAAQ,GAAA;AAAI,GAChB;AACF;;;AClBO,SAAS,iBAAA,CAAkB,OAAqB,GAAA,EAAsC;AAC3F,EAAA,MAAM,OAAA,GAAA,CAAW,OAAO,KAAA,KAAU,QAAA,GAAW,CAAC,KAAK,CAAA,GAAI,CAAC,GAAG,KAAK,CAAA,EAAG,GAAA;AAAA,IAAI,CAAC,KAAA,KACtE,KAAA,CACG,KAAA,CAAM,GAAG,EACT,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAA,CACnB,OAAO,CAAC,CAAA,KAAM,MAAM,EAAE;AAAA,GAC3B;AAEA,EAAA,OAAO,GAAA,GAAM,OAAA,GAAU,CAAC,OAAA,CAAQ,MAAM,CAAA;AACxC;AAGA,eAAsB,gBAAA,CACpB,WAAA,EACA,GAAA,EACA,OAAA,EACkB;AAClB,EAAA,MAAM,IAAA,GAAO,OAAOA,MAAAA,EAAiB,EAAA,KAAkD;AACrF,IAAA,KAAA,MAAW,KAAKA,MAAAA,EAAO,IAAI,MAAM,EAAA,CAAG,CAAC,GAAG,OAAO,IAAA;AAC/C,IAAA,OAAO,KAAA;AAAA,EACT,CAAA;AACA,EAAA,MAAM,KAAA,GAAQ,OAAO,MAAA,EAAoB,EAAA,KAA8C;AACrF,IAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,KAAA;AAChC,IAAA,KAAA,MAAW,CAAA,IAAK,QAAQ,IAAI,CAAE,MAAM,EAAA,CAAG,CAAC,GAAI,OAAO,KAAA;AACnD,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AACA,EAAA,IAAI,WAAA,CAAY,eAAe,MAAA,EAAW;AACxC,IAAA,OAAO,KAAA,CAAM,iBAAA,CAAkB,WAAA,CAAY,UAAA,EAAY,WAAA,CAAY,GAAG,CAAA,EAAG,CAAC,CAAA,KAAM,IAAA,CAAK,CAAA,EAAG,GAAG,CAAC,CAAA;AAAA,EAC9F;AACA,EAAA,IAAI,WAAA,CAAY,SAAS,MAAA,EAAW;AAClC,IAAA,OAAO,KAAA,CAAM,iBAAA,CAAkB,WAAA,CAAY,IAAA,EAAM,WAAA,CAAY,GAAG,CAAA,EAAG,CAAC,CAAA,KAAM,IAAA,CAAK,CAAA,EAAG,OAAO,CAAC,CAAA;AAAA,EAC5F;AACA,EAAA,MAAM,CAAC,QAAQ,EAAE,IAAI,iBAAA,CAAkB,WAAA,CAAY,kBAAkB,KAAK,CAAA;AAC1E,EAAA,OAAQ,MAAM,KAAK,KAAA,EAAO,OAAO,KAAO,MAAM,IAAA,CAAK,OAAO,GAAG,CAAA;AAC/D;;;ACTA,IAAM,iBAA+B,EAAE,KAAA,EAAO,EAAC,EAAG,WAAA,EAAa,EAAC,EAAE;AAkB3D,SAAS,eAAe,OAAA,EAA0B;AACvD,EAAA,MAAM,EAAE,MAAK,GAAI,OAAA;AAEjB,EAAA,eAAe,UAAA,GAAsC;AACnD,IAAA,OAAQ,MAAM,OAAA,CAAQ,UAAA,EAAW,IAAM,IAAA;AAAA,EACzC;AAEA,EAAA,eAAe,YAAA,CAAa,KAAA,GAAsB,EAAC,EAA0B;AAC3E,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,IAAS,OAAA,CAAQ,KAAA;AACrC,IAAA,IAAI,OAA2B,KAAA,CAAM,IAAA;AACrC,IAAA,IAAI,SAAS,MAAA,EAAW;AACtB,MAAA,IAAA,GAAO,OAAO,QAAQ,IAAA,KAAS,UAAA,GAAa,MAAM,OAAA,CAAQ,IAAA,KAAS,OAAA,CAAQ,IAAA;AAAA,IAC7E;AACA,IAAA,MAAM,MAAoB,EAAC;AAC3B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,GAAA,CAAI,KAAA,GAAQ,KAAA;AACrC,IAAA,IAAI,IAAA,KAAS,MAAA,IAAa,IAAA,KAAS,IAAA,MAAU,IAAA,GAAO,IAAA;AACpD,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,eAAe,UAAA,CAAW,SAAkB,KAAA,EAAsB;AAChE,IAAA,OAAO,KAAK,GAAA,CAAI,OAAA,EAAS,MAAM,YAAA,CAAa,KAAK,CAAC,CAAA;AAAA,EACpD;AAEA,EAAA,eAAe,SAAA,CAAU,OAAA,EAAkB,WAAA,EAA0B,KAAA,EAAwC;AAC3G,IAAA,MAAM,CAAA,GAAI,MAAM,UAAA,CAAW,OAAA,EAAS,KAAK,CAAA;AACzC,IAAA,OAAO,gBAAA,CAAiB,WAAA,EAAa,CAAC,CAAA,KAAM,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,CAAA;AAAA,EAC3E;AAGA,EAAA,eAAe,SAAA,CAAU,aAA0B,KAAA,EAAgD;AACjG,IAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,IAAA,IAAI,CAAC,SAAS,OAAO,EAAE,IAAI,KAAA,EAAO,MAAA,EAAQ,iBAAA,EAAmB,OAAA,EAAS,IAAA,EAAK;AAC3E,IAAA,IAAI,CAAE,MAAM,SAAA,CAAU,OAAA,EAAS,WAAA,EAAa,KAAK,CAAA,EAAI,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,gBAAgB,OAAA,EAAQ;AACzG,IAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,OAAA,EAAQ;AAAA,EAC7B;AAEA,EAAA,SAAS,IAAA,CAAK,QAAuB,IAAA,EAA6B;AAChE,IAAA,IAAI,WAAW,iBAAA,EAAmB;AAChC,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,iBAAA,IAAqB,OAAA,CAAQ,iBAAA;AAClD,MAAA,IAAI,SAAS,OAAA,EAAQ;AAAA,WAChB;AACH,QAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAY,OAAA,CAAQ,QAAA;AAC1C,QAAA,IAAI,QAAA,KAAa,MAAA,EAAWC,mBAAA,CAAS,QAAQ,CAAA;AAC7C,QAAAC,mBAAA,EAAS;AAAA,MACX;AAAA,IACF,CAAA,MAAO;AACL,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,cAAA,IAAkB,OAAA,CAAQ,cAAA;AAC/C,MAAA,IAAI,SAAS,OAAA,EAAQ;AAAA,WAChBA,mBAAA,EAAS;AAAA,IAChB;AAEA,IAAA,MAAM,IAAI,sBAAsB,MAAM,CAAA;AAAA,EACxC;AAEA,EAAA,eAAe,OAAA,CAAQ,WAAA,EAA0B,IAAA,GAAuB,EAAC,EAAqB;AAC5F,IAAA,MAAM,MAAA,GAAS,MAAM,SAAA,CAAU,WAAA,EAAa,IAAI,CAAA;AAChD,IAAA,IAAI,CAAC,MAAA,CAAO,EAAA,EAAI,IAAA,CAAK,MAAA,CAAO,QAAQ,IAAI,CAAA;AACxC,IAAA,OAAO,MAAA,CAAO,OAAA;AAAA,EAChB;AAEA,EAAA,SAAS,WAAA,CACP,WAAA,EACA,MAAA,EACA,KAAA,EAC+B;AAC/B,IAAA,OAAO,UAAU,IAAA,KAA2B;AAC1C,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,CAAU,WAAA,EAAa,KAAK,CAAA;AACjD,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,QAAU,IAAI,qBAAA,CAAsB,OAAO,MAAM,CAAA;AAC7D,MAAA,OAAO,MAAA,CAAO,GAAG,IAAI,CAAA;AAAA,IACvB,CAAA;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,UAAA;AAAA,IACA,SAAA;AAAA;AAAA,IAGA,MAAM,YAAY,KAAA,EAA6C;AAC7D,MAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,MAAA,IAAI,CAAC,OAAA,EAAS,OAAO,EAAE,OAAO,CAAC,GAAG,cAAA,CAAe,KAAK,GAAG,WAAA,EAAa,CAAC,GAAG,cAAA,CAAe,WAAW,CAAA,EAAE;AACtG,MAAA,OAAA,CAAQ,MAAM,UAAA,CAAW,OAAA,EAAS,KAAK,GAAG,QAAA,EAAS;AAAA,IACrD,CAAA;AAAA,IAEA,MAAM,GAAA,CAAI,UAAA,EAAoB,KAAA,EAAwC;AACpE,MAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,MAAA,OAAO,OAAA,GAAA,CAAW,MAAM,UAAA,CAAW,OAAA,EAAS,KAAK,CAAA,EAAG,GAAA,CAAI,UAAU,CAAA,GAAI,KAAA;AAAA,IACxE,CAAA;AAAA,IAEA,MAAM,MAAA,CAAO,WAAA,EAA2B,KAAA,EAAwC;AAC9E,MAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,MAAA,OAAO,OAAA,GAAA,CAAW,MAAM,UAAA,CAAW,OAAA,EAAS,KAAK,CAAA,EAAG,MAAA,CAAO,WAAW,CAAA,GAAI,KAAA;AAAA,IAC5E,CAAA;AAAA,IAEA,MAAM,MAAA,CAAO,WAAA,EAA2B,KAAA,EAAwC;AAC9E,MAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,MAAA,OAAO,OAAA,GAAA,CAAW,MAAM,UAAA,CAAW,OAAA,EAAS,KAAK,CAAA,EAAG,MAAA,CAAO,WAAW,CAAA,GAAI,KAAA;AAAA,IAC5E,CAAA;AAAA;AAAA,IAGA,MAAM,OAAA,CAAQ,IAAA,EAAoB,KAAA,EAAwC;AACxE,MAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,MAAA,OAAO,OAAA,GAAA,CAAW,MAAM,UAAA,CAAW,OAAA,EAAS,KAAK,CAAA,EAAG,UAAA,CAAW,IAAI,CAAA,GAAI,KAAA;AAAA,IACzE,CAAA;AAAA,IAEA,MAAM,WAAA,CAAY,KAAA,EAAqB,KAAA,EAAwC;AAC7E,MAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,MAAA,OAAO,OAAA,GAAA,CAAW,MAAM,UAAA,CAAW,OAAA,EAAS,KAAK,CAAA,EAAG,WAAA,CAAY,KAAK,CAAA,GAAI,KAAA;AAAA,IAC3E,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,iBAAA,CAAkB,YAA0B,IAAA,EAAyC;AACnF,MAAA,OAAO,OAAA,CAAQ,EAAE,UAAA,EAAY,GAAI,IAAA,EAAM,GAAA,IAAO,EAAE,GAAA,EAAK,IAAA,EAAK,EAAG,EAAG,IAAI,CAAA;AAAA,IACtE,CAAA;AAAA;AAAA,IAGA,WAAA,CAAY,MAAoB,IAAA,EAAyC;AACvE,MAAA,OAAO,OAAA,CAAQ,EAAE,IAAA,EAAM,GAAI,IAAA,EAAM,GAAA,IAAO,EAAE,GAAA,EAAK,IAAA,EAAK,EAAG,EAAG,IAAI,CAAA;AAAA,IAChE,CAAA;AAAA;AAAA,IAGA,uBAAA,CAAwB,OAAqB,IAAA,EAAyC;AACpF,MAAA,OAAO,OAAA,CAAQ,EAAE,gBAAA,EAAkB,KAAA,IAAS,IAAI,CAAA;AAAA,IAClD,CAAA;AAAA;AAAA,IAGA,cAAA,CACE,UAAA,EACA,MAAA,EACA,KAAA,EAC+B;AAC/B,MAAA,OAAO,WAAA,CAAY,EAAE,UAAA,EAAW,EAAG,QAAQ,KAAK,CAAA;AAAA,IAClD,CAAA;AAAA;AAAA,IAGA,QAAA,CACE,IAAA,EACA,MAAA,EACA,KAAA,EAC+B;AAC/B,MAAA,OAAO,WAAA,CAAY,EAAE,IAAA,EAAK,EAAG,QAAQ,KAAK,CAAA;AAAA,IAC5C,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,QAAA,CACE,SACAC,QAAAA,EACsC;AACtC,MAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAM,GAAG,aAAY,GAAIA,QAAAA;AACxC,MAAA,MAAM,QAAsB,EAAC;AAC7B,MAAA,IAAI,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,KAAA,GAAQ,KAAA;AACvC,MAAA,IAAI,IAAA,KAAS,MAAA,EAAW,KAAA,CAAM,IAAA,GAAO,IAAA;AACrC,MAAA,OAAO,UAAU,IAAA,KAAkC;AACjD,QAAA,MAAM,MAAA,GAAS,MAAM,SAAA,CAAU,WAAA,EAA4B,KAAK,CAAA;AAChE,QAAA,IAAI,MAAA,CAAO,EAAA,EAAI,OAAO,OAAA,CAAQ,GAAG,IAAI,CAAA;AACrC,QAAA,OAAO,OAAO,MAAA,KAAW,iBAAA,GACrB,uBAAA,EAAwB,GACxB,kBAAkB,WAA0B,CAAA;AAAA,MAClD,CAAA;AAAA,IACF;AAAA,GACF;AACF;;;AClOA,IAAM,KAAA,uBAAY,GAAA,EAAoB;AAEtC,IAAM,SAAS,CAAC,CAAA,KAAsB,CAAA,CAAE,OAAA,CAAQ,uBAAuB,MAAM,CAAA;AAWtE,SAAS,mBAAmB,OAAA,EAAyB;AAC1D,EAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AAC7B,EAAA,IAAI,KAAK,OAAO,GAAA;AAEhB,EAAA,IAAI,MAAA,GAAS,EAAA;AACb,EAAA,KAAA,MAAW,OAAA,IAAW,OAAA,CAAQ,KAAA,CAAM,GAAG,CAAA,EAAG;AACxC,IAAA,IAAI,YAAY,EAAA,EAAI;AACpB,IAAA,MAAM,KAAA,GAAQ,mCAAA,CAAoC,IAAA,CAAK,OAAO,CAAA;AAC9D,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,MAAA,IAAU,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,CAAC,CAAA,CAAA;AAC7B,MAAA;AAAA,IACF;AACA,IAAA,QAAQ,KAAA,CAAM,CAAC,CAAA;AAAG,MAChB,KAAK,GAAA;AACH,QAAA,MAAA,IAAU,aAAA;AACV,QAAA;AAAA,MACF,KAAK,GAAA;AACH,QAAA,MAAA,IAAU,aAAA;AACV,QAAA;AAAA,MACF,KAAK,GAAA;AACH,QAAA,MAAA,IAAU,aAAA;AACV,QAAA;AAAA,MACF;AACE,QAAA,MAAA,IAAU,QAAA;AAAA;AACd,EACF;AACA,EAAA,MAAM,KAAA,GAAQ,IAAI,MAAA,CAAO,CAAA,CAAA,EAAI,MAAM,CAAA,GAAA,CAAK,CAAA;AACxC,EAAA,KAAA,CAAM,GAAA,CAAI,SAAS,KAAK,CAAA;AACxB,EAAA,OAAO,KAAA;AACT;AAIA,SAAS,OAAA,CAAQ,SAA0B,QAAA,EAA2B;AACpE,EAAA,IAAI,OAAO,YAAY,QAAA,EAAU,OAAO,mBAAmB,OAAO,CAAA,CAAE,IAAA,CAAK,QAAA,IAAY,GAAG,CAAA;AACxF,EAAA,OAAA,CAAQ,SAAA,GAAY,CAAA;AACpB,EAAA,OAAO,OAAA,CAAQ,KAAK,QAAQ,CAAA;AAC9B;AAEA,IAAM,MAAA,GAAS,CAAC,QAAA,KAA6B;AAC3C,EAAA,IAAI;AACF,IAAA,OAAO,UAAU,QAAQ,CAAA;AAAA,EAC3B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,QAAA;AAAA,EACT;AACF,CAAA;AAMO,SAAS,SAAA,CAAU,SAAsB,QAAA,EAA2B;AACzE,EAAA,MAAM,UAAA,GAAa,CAAC,QAAA,EAAU,MAAA,CAAO,QAAQ,CAAC,CAAA;AAC9C,EAAA,MAAM,IAAA,GAAO,OAAO,OAAA,KAAY,QAAA,IAAY,mBAAmB,MAAA,GAAS,CAAC,OAAO,CAAA,GAAI,OAAA;AACpF,EAAA,OAAO,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,KAAM,UAAA,CAAW,IAAA,CAAK,CAAC,CAAA,KAAM,OAAA,CAAQ,CAAA,EAAG,CAAC,CAAC,CAAC,CAAA;AAC/D;ACxDA,SAAS,WAAA,CAAY,SAAiB,QAAA,EAA2B;AAC/D,EAAA,IAAI;AACF,IAAA,OAAOC,6BAAA,CAAgB,SAAS,QAAQ,CAAA;AAAA,EAC1C,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAGO,SAAS,iBAAA,CACd,QAAA,EACA,WAAA,EACA,OAAA,GAAgC,EAAC,EACxB;AACT,EAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,QAAA,CAAS,KAAK,CAAA;AACpC,EAAA,MAAM,YAAA,GAAA,CAAgB,OAAA,CAAQ,eAAA,IAAmB,EAAC,EAAG,IAAA,CAAK,CAAC,CAAA,KAAM,KAAA,CAAM,GAAA,CAAI,CAAC,CAAC,CAAA;AAC7E,EAAA,MAAM,UAAU,CAAC,IAAA,KAA0B,MAAM,GAAA,CAAI,IAAA,CAAK,MAAM,CAAA;AAChE,EAAA,MAAM,GAAA,GAAM,CAAC,UAAA,KAAgC;AAC3C,IAAA,IAAI,cAAc,OAAO,IAAA;AACzB,IAAA,MAAM,IAAA,GAAO,WAAW,IAAA,EAAK;AAC7B,IAAA,IAAI,IAAA,KAAS,IAAI,OAAO,KAAA;AACxB,IAAA,IAAI,QAAA,CAAS,WAAA,CAAY,QAAA,CAAS,IAAI,GAAG,OAAO,IAAA;AAChD,IAAA,OAAA,CAAQ,OAAA,CAAQ,QAAA,IAAY,KAAA,KAAU,QAAA,CAAS,WAAA,CAAY,IAAA,CAAK,CAAC,CAAA,KAAM,WAAA,CAAY,CAAA,EAAG,IAAI,CAAC,CAAA;AAAA,EAC7F,CAAA;AAEA,EAAA,MAAM,GAAA,GAAM,CAAC,MAAA,EAAoB,EAAA,KAC/B,OAAO,MAAA,GAAS,CAAA,IAAK,MAAA,CAAO,KAAA,CAAM,CAAC,KAAA,KAAU,KAAA,CAAM,IAAA,CAAK,EAAE,CAAC,CAAA;AAC7D,EAAA,IAAI,WAAA,CAAY,UAAA,KAAe,MAAA,EAAW,OAAO,GAAA,CAAI,iBAAA,CAAkB,WAAA,CAAY,UAAA,EAAY,WAAA,CAAY,GAAG,CAAA,EAAG,GAAG,CAAA;AACpH,EAAA,IAAI,WAAA,CAAY,IAAA,KAAS,MAAA,EAAW,OAAO,GAAA,CAAI,iBAAA,CAAkB,WAAA,CAAY,IAAA,EAAM,WAAA,CAAY,GAAG,CAAA,EAAG,OAAO,CAAA;AAC5G,EAAA,MAAM,CAAC,QAAQ,EAAE,IAAI,iBAAA,CAAkB,WAAA,CAAY,kBAAkB,KAAK,CAAA;AAC1E,EAAA,OAAO,MAAM,IAAA,CAAK,OAAO,CAAA,IAAK,KAAA,CAAM,KAAK,GAAG,CAAA;AAC9C;;;ACiBA,SAAS,iBAAiB,IAAA,EAAyC;AACjE,EAAA,MAAM,MAAqB,EAAC;AAC5B,EAAA,IAAI,KAAK,UAAA,KAAe,MAAA,EAAW,GAAA,CAAI,IAAA,CAAK,EAAE,UAAA,EAAY,IAAA,CAAK,UAAA,EAAY,GAAI,KAAK,GAAA,IAAO,EAAE,GAAA,EAAK,IAAA,IAAS,CAAA;AAC3G,EAAA,IAAI,KAAK,IAAA,KAAS,MAAA,EAAW,GAAA,CAAI,IAAA,CAAK,EAAE,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,GAAI,KAAK,GAAA,IAAO,EAAE,GAAA,EAAK,IAAA,IAAS,CAAA;AACzF,EAAA,IAAI,IAAA,CAAK,qBAAqB,MAAA,EAAW,GAAA,CAAI,KAAK,EAAE,gBAAA,EAAkB,IAAA,CAAK,gBAAA,EAAkB,CAAA;AAC7F,EAAA,OAAO,GAAA;AACT;AAaO,SAAS,qBACd,OAAA,EAC6C;AAQ7C,EAAA,eAAe,YAAY,GAAA,EAAmC;AAC5D,IAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,MAAA,MAAM,QAAA,GAAY,MAAM,OAAA,CAAQ,WAAA,CAAY,GAAG,CAAA,IAAM,IAAA;AACrD,MAAA,IAAI,CAAC,UAAU,OAAO,IAAA;AACtB,MAAA,MAAM,YAAA,GAAqC,EAAE,QAAA,EAAU,OAAA,CAAQ,YAAY,KAAA,EAAM;AACjF,MAAA,IAAI,OAAA,CAAQ,eAAA,EAAiB,YAAA,CAAa,eAAA,GAAkB,OAAA,CAAQ,eAAA;AACpE,MAAA,OAAO,OAAO,WAAA,KAAgB,iBAAA,CAAkB,QAAA,EAAU,aAAa,YAAY,CAAA;AAAA,IACrF;AACA,IAAA,MAAM,OAAA,GAAW,MAAM,OAAA,CAAQ,UAAA,CAAW,GAAG,CAAA,IAAM,IAAA;AACnD,IAAA,IAAI,CAAC,SAAS,OAAO,IAAA;AACrB,IAAA,MAAM,QAAsB,EAAC;AAC7B,IAAA,IAAI,OAAA,CAAQ,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,QAAQ,OAAA,CAAQ,KAAA;AACvD,IAAA,MAAM,IAAA,GAAO,OAAO,OAAA,CAAQ,IAAA,KAAS,UAAA,GAAa,MAAM,OAAA,CAAQ,IAAA,CAAK,GAAG,CAAA,GAAI,OAAA,CAAQ,IAAA;AACpF,IAAA,IAAI,IAAA,KAAS,MAAA,IAAa,IAAA,KAAS,IAAA,QAAY,IAAA,GAAO,IAAA;AACtD,IAAA,MAAM,CAAA,GAAI,OAAA,CAAQ,IAAA,CAAK,GAAA,CAAI,SAAS,KAAK,CAAA;AACzC,IAAA,OAAO,CAAC,WAAA,KAAgB,gBAAA,CAAiB,WAAA,EAAa,CAAC,CAAA,KAAM,CAAA,CAAE,GAAA,CAAI,CAAC,GAAG,CAAC,CAAA,KAAM,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,CAAA;AAAA,EAC5F;AAEA,EAAA,OAAO,OAAO,GAAA,KAA4C;AACxD,IAAA,MAAM,QAAA,GAAW,IAAI,OAAA,EAAS,QAAA,IAAY,IAAI,GAAA,CAAI,GAAA,CAAI,GAAG,CAAA,CAAE,QAAA;AAC3D,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,KAAA,CAAM,MAAA,CAAO,CAAC,SAAS,SAAA,CAAU,IAAA,CAAK,OAAA,EAAS,QAAQ,CAAC,CAAA;AACjF,IAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,OAAO,MAAA;AAElC,IAAA,MAAM,KAAA,GAAQ,MAAM,WAAA,CAAY,GAAG,CAAA;AACnC,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,MAAM,IAAA,GAAO,SAAS,CAAC,CAAA;AACvB,MAAA,IAAI,QAAQ,iBAAA,EAAmB,OAAO,OAAA,CAAQ,iBAAA,CAAkB,KAAK,IAAI,CAAA;AACzE,MAAA,IAAI,OAAA,CAAQ,aAAa,MAAA,EAAW;AAClC,QAAA,MAAM,MAAA,GAAS,OAAO,OAAA,CAAQ,QAAA,KAAa,aAAa,OAAA,CAAQ,QAAA,CAAS,GAAG,CAAA,GAAI,OAAA,CAAQ,QAAA;AACxF,QAAA,OAAO,QAAA,CAAS,SAAS,IAAI,GAAA,CAAI,QAAQ,GAAA,CAAI,GAAG,GAAG,GAAG,CAAA;AAAA,MACxD;AACA,MAAA,OAAO,uBAAA,EAAwB;AAAA,IACjC;AAEA,IAAA,KAAA,MAAW,QAAQ,QAAA,EAAU;AAC3B,MAAA,IAAI,MAAA;AACJ,MAAA,KAAA,MAAW,WAAA,IAAe,gBAAA,CAAiB,IAAI,CAAA,EAAG;AAChD,QAAA,IAAI,CAAE,MAAM,KAAA,CAAM,WAAW,CAAA,EAAI;AAC/B,UAAA,MAAA,GAAS,WAAA;AACT,UAAA;AAAA,QACF;AAAA,MACF;AACA,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,IAAI,QAAQ,cAAA,EAAgB,OAAO,OAAA,CAAQ,cAAA,CAAe,KAAK,IAAI,CAAA;AACnE,QAAA,OAAO,kBAAkB,MAAM,CAAA;AAAA,MACjC;AAAA,IACF;AACA,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF","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 type { Many } from '@anievo-id/rbac-evolution'\n\nexport type MaybePromise<T> = T | Promise<T>\n\n/**\n * What a guard requires — mirrors spatie's `permission`, `role` and `role_or_permission` middleware.\n * Arrays and `'a|b'` strings mean \"any of\" (like `permission:a|b` / spatie's `canAny()`).\n * With `all: true`, every listed permission or role is required (spatie v8.5 `canAll()`); a `'a|b'`\n * entry still means \"a or b\" within that entry.\n */\nexport type Requirement =\n | { permission: Many<string>; role?: never; roleOrPermission?: never; all?: boolean }\n | { permission?: never; role: Many<string>; roleOrPermission?: never; all?: boolean }\n | { permission?: never; role?: never; roleOrPermission: Many<string>; all?: never }\n\n/** One requirement as groups: every group must pass, any name inside a group passes it. */\nexport function requirementGroups(names: Many<string>, all: boolean | undefined): string[][] {\n const entries = (typeof names === 'string' ? [names] : [...names]).map((entry) =>\n entry\n .split('|')\n .map((n) => n.trim())\n .filter((n) => n !== ''),\n )\n // shortcut: an entry that is only pipes/spaces yields an empty group, which nobody satisfies.\n return all ? entries : [entries.flat()]\n}\n\n/** Evaluates a requirement with any/all checkers for single names. Empty requirements deny. */\nexport async function checkRequirement(\n requirement: Requirement,\n can: (name: string) => boolean | Promise<boolean>,\n hasRole: (name: string) => boolean | Promise<boolean>,\n): Promise<boolean> {\n const some = async (group: string[], fn: (n: string) => boolean | Promise<boolean>) => {\n for (const n of group) if (await fn(n)) return true\n return false\n }\n const every = async (groups: string[][], fn: (group: string[]) => Promise<boolean>) => {\n if (groups.length === 0) return false\n for (const g of groups) if (!(await fn(g))) return false\n return true\n }\n if (requirement.permission !== undefined) {\n return every(requirementGroups(requirement.permission, requirement.all), (g) => some(g, can))\n }\n if (requirement.role !== undefined) {\n return every(requirementGroups(requirement.role, requirement.all), (g) => some(g, hasRole))\n }\n const [group = []] = requirementGroups(requirement.roleOrPermission, false)\n return (await some(group, hasRole)) || (await some(group, can))\n}\n\nexport type FailureReason = 'unauthenticated' | 'unauthorized'\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 { checkRequirement, type FailureReason, type MaybePromise, type 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 | undefined\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 | undefined\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: (() => never) | undefined\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: (() => never) | undefined\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n /** `requirePermission` / `requireRole`: require EVERY listed name instead of any (spatie v8.5 `canAll()`). */\n all?: boolean | undefined\n loginUrl?: string | undefined\n onUnauthenticated?: (() => never) | undefined\n onUnauthorized?: (() => never) | undefined\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 return checkRequirement(requirement, (n) => s.can(n), (n) => s.hasRole(n))\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 | undefined,\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?.all && { all: true }) }, 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?.all && { all: true }) }, 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 | undefined,\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 | undefined,\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\nfunction testOne(matcher: string | RegExp, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n matcher.lastIndex = 0 // a /g or /y RegExp keeps state between test() calls\n return matcher.test(pathname)\n}\n\nconst decode = (pathname: string): string => {\n try {\n return decodeURI(pathname)\n } catch {\n return pathname\n }\n}\n\n/**\n * `true` if the pathname matches the pattern (or any of the patterns). Both the raw and the\n * percent-decoded pathname are tried, so `/%61dmin` is protected by a rule for `/admin`.\n */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n const candidates = [pathname, decode(pathname)]\n const list = typeof matcher === 'string' || matcher instanceof RegExp ? [matcher] : matcher\n return list.some((m) => candidates.some((p) => testOne(m, p)))\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport { type Requirement, requirementGroups } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean | undefined\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[] | undefined\n}\n\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 const all = (groups: string[][], fn: (n: string) => boolean) =>\n groups.length > 0 && groups.every((group) => group.some(fn))\n if (requirement.permission !== undefined) return all(requirementGroups(requirement.permission, requirement.all), can)\n if (requirement.role !== undefined) return all(requirementGroups(requirement.role, requirement.all), hasRole)\n const [items = []] = requirementGroups(requirement.roleOrPermission, false)\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 { checkRequirement, type MaybePromise, type 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> | undefined\n /** Requires the role (or ANY of them). */\n role?: Many<string> | undefined\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string> | undefined\n /** Require EVERY listed permission / role instead of any (spatie v8.5 `canAll()`). */\n all?: boolean | undefined\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) | undefined\n /** Custom response for guests. */\n onUnauthenticated?: ((req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>) | undefined\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: ((req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>) | undefined\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 | undefined\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 | undefined\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[] | undefined\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, ...(rule.all && { all: true }) })\n if (rule.role !== undefined) out.push({ role: rule.role, ...(rule.all && { all: true }) })\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 (requirement) => checkRequirement(requirement, (n) => s.can(n), (n) => s.hasRole(n))\n }\n\n return async (req: Req): Promise<Response | undefined> => {\n const pathname = req.nextUrl?.pathname ?? new URL(req.url).pathname\n const matching = options.rules.filter((rule) => matchPath(rule.matcher, pathname))\n if (matching.length === 0) return undefined\n\n const check = await loadChecker(req)\n if (!check) {\n const rule = matching[0]!\n if (options.onUnauthenticated) return options.onUnauthenticated(req, rule)\n if (options.loginUrl !== undefined) {\n const target = typeof options.loginUrl === 'function' ? options.loginUrl(req) : options.loginUrl\n return Response.redirect(new URL(target, req.url), 307)\n }\n return unauthenticatedResponse()\n }\n\n for (const rule of matching) {\n let failed: Requirement | undefined\n for (const requirement of ruleRequirements(rule)) {\n if (!(await check(requirement))) {\n failed = requirement\n break\n }\n }\n if (failed) {\n if (options.onUnauthorized) return options.onUnauthorized(req, rule)\n return forbiddenResponse(failed)\n }\n }\n return undefined\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/responses.ts","../src/types.ts","../src/server.ts","../src/matcher.ts","../src/snapshot.ts","../src/middleware.ts"],"names":["group","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 type { Many } from '@anievo-id/rbac-evolution'\n\nexport type MaybePromise<T> = T | Promise<T>\n\n/**\n * What a guard requires — mirrors spatie's `permission`, `role` and `role_or_permission` middleware.\n * Arrays and `'a|b'` strings mean \"any of\" (like `permission:a|b` / spatie's `canAny()`).\n * With `all: true`, every listed permission or role is required (spatie v8.5 `canAll()`); a `'a|b'`\n * entry still means \"a or b\" within that entry.\n */\nexport type Requirement =\n | { permission: Many<string>; role?: never; roleOrPermission?: never; all?: boolean }\n | { permission?: never; role: Many<string>; roleOrPermission?: never; all?: boolean }\n | { permission?: never; role?: never; roleOrPermission: Many<string>; all?: never }\n\n/** One requirement as groups: every group must pass, any name inside a group passes it. */\nexport function requirementGroups(names: Many<string>, all: boolean | undefined): string[][] {\n const entries = (typeof names === 'string' ? [names] : [...names]).map((entry) =>\n entry\n .split('|')\n .map((n) => n.trim())\n .filter((n) => n !== ''),\n )\n // shortcut: an entry that is only pipes/spaces yields an empty group, which nobody satisfies.\n return all ? entries : [entries.flat()]\n}\n\n/** Evaluates a requirement with any/all checkers for single names. Empty requirements deny. */\nexport async function checkRequirement(\n requirement: Requirement,\n can: (name: string) => boolean | Promise<boolean>,\n hasRole: (name: string) => boolean | Promise<boolean>,\n): Promise<boolean> {\n const some = async (group: string[], fn: (n: string) => boolean | Promise<boolean>) => {\n for (const n of group) if (await fn(n)) return true\n return false\n }\n const every = async (groups: string[][], fn: (group: string[]) => Promise<boolean>) => {\n if (groups.length === 0) return false\n for (const g of groups) if (!(await fn(g))) return false\n return true\n }\n if (requirement.permission !== undefined) {\n return every(requirementGroups(requirement.permission, requirement.all), (g) => some(g, can))\n }\n if (requirement.role !== undefined) {\n return every(requirementGroups(requirement.role, requirement.all), (g) => some(g, hasRole))\n }\n const [group = []] = requirementGroups(requirement.roleOrPermission, false)\n return (await some(group, hasRole)) || (await some(group, can))\n}\n\nexport type FailureReason = 'unauthenticated' | 'unauthorized'\n","import { notFound, redirect } from 'next/navigation'\nimport type {\n CheckRequirementName,\n DefaultRbacTypes,\n Many,\n PermissionName,\n Rbac,\n RbacSnapshot,\n RbacTypeConfig,\n RoleName,\n ScopeOptions,\n Subject,\n TeamId,\n} from '@anievo-id/rbac-evolution'\nimport { RbacUnauthorizedError } from './errors'\nimport { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport { checkRequirement, type FailureReason, type MaybePromise, type Requirement } from './types'\n\nexport interface NextRbacOptions<T extends RbacTypeConfig = DefaultRbacTypes> {\n /** Your `createRbac(...)` instance. Its typed names (`createRbac<{ permissions: ...; roles: ... }>`) flow into every helper. */\n rbac: Rbac<T>\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 | undefined\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 | undefined\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: (() => never) | undefined\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: (() => never) | undefined\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n /** `requirePermission` / `requireRole`: require EVERY listed name instead of any (spatie v8.5 `canAll()`). */\n all?: boolean | undefined\n loginUrl?: string | undefined\n onUnauthenticated?: (() => never) | undefined\n onUnauthorized?: (() => never) | undefined\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/**\n * Checks a name, a `'a|b'` pipe list or an array of them against the names `N`.\n * Any name passes when `N` is `string` (an untyped engine).\n */\nexport type CheckNames<S, N extends string> = S extends string\n ? CheckRequirementName<S, N>\n : S extends readonly string[]\n ? { [K in keyof S]: S[K] extends string ? CheckRequirementName<S[K], N> : S[K] }\n : S\n\n/** Checks the `permission` / `role` / `roleOrPermission` names of a requirement object `Q` against the names of `T`. */\nexport type CheckRequirement<Q, T extends RbacTypeConfig> = {\n [K in keyof Q]: K extends 'permission'\n ? CheckNames<Q[K], PermissionName<T>>\n : K extends 'role'\n ? CheckNames<Q[K], RoleName<T>>\n : K extends 'roleOrPermission'\n ? CheckNames<Q[K], PermissionName<T> | RoleName<T>>\n : Q[K]\n}\n\n/**\n * The helpers returned by `createNextRbac()`. `T` comes from the `rbac` instance: with typed names,\n * every name (including each part of a `'a|b'` list) must be one of them; untyped, any string is accepted.\n */\nexport interface NextRbac<T extends RbacTypeConfig = DefaultRbacTypes> {\n rbac: Rbac<T>\n getSubject(): Promise<Subject | null>\n /** Non-throwing check: who is the user and do they meet the requirement? */\n authorize<const Q extends Requirement>(\n requirement: Q & CheckRequirement<Q, T>,\n scope?: ScopeOptions,\n ): Promise<AuthorizeResult>\n /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */\n getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot>\n can(permission: PermissionName<T>, scope?: ScopeOptions): Promise<boolean>\n canAny(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>\n canAll(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>\n /** `true` if the user has the role — or ANY of the roles when given an array. */\n hasRole(role: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>\n hasAllRoles(roles: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>\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<const S extends Many<string>>(\n permission: S & CheckNames<S, PermissionName<T>>,\n opts?: RequireOptions,\n ): Promise<Subject>\n /** Ensures the user has the role (or ANY of the roles). Returns the subject. */\n requireRole<const S extends Many<string>>(role: S & CheckNames<S, RoleName<T>>, opts?: RequireOptions): Promise<Subject>\n /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */\n requireRoleOrPermission<const S extends Many<string>>(\n items: S & CheckNames<S, PermissionName<T> | RoleName<T>>,\n opts?: RequireOptions,\n ): Promise<Subject>\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */\n withPermission<const S extends Many<string>, Args extends unknown[], R>(\n permission: S & CheckNames<S, PermissionName<T>>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions | undefined,\n ): (...args: Args) => Promise<R>\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */\n withRole<const S extends Many<string>, Args extends unknown[], R>(\n role: S & CheckNames<S, RoleName<T>>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions | undefined,\n ): (...args: Args) => Promise<R>\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[], const O extends WithRbacOptions>(\n handler: (...args: Args) => MaybePromise<Response>,\n options: O & CheckRequirement<O, T>,\n ): (...args: Args) => Promise<Response>\n}\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 *\n * With a typed engine (`createRbac<AppTypes>(...)`), names are checked: `requirePermission('typo')` is a type error.\n */\nexport function createNextRbac<T extends RbacTypeConfig = DefaultRbacTypes>(options: NextRbacOptions<T>): NextRbac<T> {\n // The implementation is untyped (plain `string` names); `NextRbac<T>` adds the typed signatures.\n const helpers = buildNextRbac(options as unknown as NextRbacOptions) satisfies Record<keyof NextRbac, unknown>\n return helpers as unknown as NextRbac<T>\n}\n\nfunction buildNextRbac(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 return checkRequirement(requirement, (n) => s.can(n), (n) => s.hasRole(n))\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 | undefined,\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?.all && { all: true }) }, 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?.all && { all: true }) }, 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 | undefined,\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 | undefined,\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","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\nfunction testOne(matcher: string | RegExp, pathname: string): boolean {\n if (typeof matcher === 'string') return compilePathPattern(matcher).test(pathname || '/')\n matcher.lastIndex = 0 // a /g or /y RegExp keeps state between test() calls\n return matcher.test(pathname)\n}\n\nconst decode = (pathname: string): string => {\n try {\n return decodeURI(pathname)\n } catch {\n return pathname\n }\n}\n\n/**\n * `true` if the pathname matches the pattern (or any of the patterns). Both the raw and the\n * percent-decoded pathname are tried, so `/%61dmin` is protected by a rule for `/admin`.\n */\nexport function matchPath(matcher: PathMatcher, pathname: string): boolean {\n const candidates = [pathname, decode(pathname)]\n const list = typeof matcher === 'string' || matcher instanceof RegExp ? [matcher] : matcher\n return list.some((m) => candidates.some((p) => testOne(m, p)))\n}\n","import { wildcardImplies } from '@anievo-id/rbac-evolution'\nimport type { Many, RbacSnapshot } from '@anievo-id/rbac-evolution'\nimport { type Requirement, requirementGroups } from './types'\n\nexport interface SnapshotCheckOptions {\n /** Treat granted permissions as wildcard patterns. */\n wildcard?: boolean | undefined\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[] | undefined\n}\n\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 const all = (groups: string[][], fn: (n: string) => boolean) =>\n groups.length > 0 && groups.every((group) => group.some(fn))\n if (requirement.permission !== undefined) return all(requirementGroups(requirement.permission, requirement.all), can)\n if (requirement.role !== undefined) return all(requirementGroups(requirement.role, requirement.all), hasRole)\n const [items = []] = requirementGroups(requirement.roleOrPermission, false)\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 { checkRequirement, type MaybePromise, type 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> | undefined\n /** Requires the role (or ANY of them). */\n role?: Many<string> | undefined\n /** Requires ANY of the given roles or permissions. */\n roleOrPermission?: Many<string> | undefined\n /** Require EVERY listed permission / role instead of any (spatie v8.5 `canAll()`). */\n all?: boolean | undefined\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) | undefined\n /** Custom response for guests. */\n onUnauthenticated?: ((req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>) | undefined\n /** Custom response for users missing a role/permission. Default: `403` JSON response. */\n onUnauthorized?: ((req: Req, rule: RbacMiddlewareRule) => MaybePromise<Response>) | undefined\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 | undefined\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 | undefined\n /** Roles that pass every permission check. */\n superAdminRoles?: readonly string[] | undefined\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, ...(rule.all && { all: true }) })\n if (rule.role !== undefined) out.push({ role: rule.role, ...(rule.all && { all: true }) })\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 (requirement) => checkRequirement(requirement, (n) => s.can(n), (n) => s.hasRole(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,5 +1,4 @@
1
- import * as _anievo_id_rbac_evolution from '@anievo-id/rbac-evolution';
2
- import { Subject, Rbac, TeamId, ScopeOptions, RbacSnapshot, Many } from '@anievo-id/rbac-evolution';
1
+ import { Subject, RbacTypeConfig, DefaultRbacTypes, Rbac, CheckRequirementName, PermissionName, RoleName, ScopeOptions, RbacSnapshot, Many, TeamId } from '@anievo-id/rbac-evolution';
3
2
  import { R as Requirement, M as MaybePromise, F as FailureReason } from './middleware-entry-BYLAhtrk.cjs';
4
3
  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-BYLAhtrk.cjs';
5
4
 
@@ -8,9 +7,9 @@ type ForbiddenReason = 'permission' | 'role' | 'role_or_permission';
8
7
  /** Like spatie, the message names the kind of requirement but not the role/permission names. */
9
8
  declare function forbiddenMessage(requirement: Requirement): string;
10
9
 
11
- interface NextRbacOptions {
12
- /** Your `createRbac(...)` instance. */
13
- rbac: Rbac;
10
+ interface NextRbacOptions<T extends RbacTypeConfig = DefaultRbacTypes> {
11
+ /** Your `createRbac(...)` instance. Its typed names (`createRbac<{ permissions: ...; roles: ... }>`) flow into every helper. */
12
+ rbac: Rbac<T>;
14
13
  /** Resolves the current user (e.g. from Auth.js `auth()`). Return `null` for guests. */
15
14
  getSubject: () => MaybePromise<Subject | null | undefined>;
16
15
  /** Default guard for every check. Default: the rbac instance's `defaultGuard`. */
@@ -45,53 +44,71 @@ type AuthorizeResult = {
45
44
  subject: Subject;
46
45
  };
47
46
  type WithRbacOptions = Requirement & ScopeOptions;
48
-
49
47
  /**
50
- * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).
51
- *
52
- * ```ts
53
- * // lib/rbac.ts
54
- * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({
55
- * rbac,
56
- * getSubject: async () => {
57
- * const session = await auth()
58
- * return session?.user ? { type: 'user', id: session.user.id } : null
59
- * },
60
- * })
61
- * ```
48
+ * Checks a name, a `'a|b'` pipe list or an array of them against the names `N`.
49
+ * Any name passes when `N` is `string` (an untyped engine).
62
50
  */
63
- declare function createNextRbac(options: NextRbacOptions): {
64
- rbac: Rbac<_anievo_id_rbac_evolution.DefaultRbacTypes>;
65
- getSubject: () => Promise<Subject | null>;
66
- authorize: (requirement: Requirement, scope?: ScopeOptions) => Promise<AuthorizeResult>;
51
+ type CheckNames<S, N extends string> = S extends string ? CheckRequirementName<S, N> : S extends readonly string[] ? {
52
+ [K in keyof S]: S[K] extends string ? CheckRequirementName<S[K], N> : S[K];
53
+ } : S;
54
+ /** Checks the `permission` / `role` / `roleOrPermission` names of a requirement object `Q` against the names of `T`. */
55
+ type CheckRequirement<Q, T extends RbacTypeConfig> = {
56
+ [K in keyof Q]: K extends 'permission' ? CheckNames<Q[K], PermissionName<T>> : K extends 'role' ? CheckNames<Q[K], RoleName<T>> : K extends 'roleOrPermission' ? CheckNames<Q[K], PermissionName<T> | RoleName<T>> : Q[K];
57
+ };
58
+ /**
59
+ * The helpers returned by `createNextRbac()`. `T` comes from the `rbac` instance: with typed names,
60
+ * every name (including each part of a `'a|b'` list) must be one of them; untyped, any string is accepted.
61
+ */
62
+ interface NextRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
63
+ rbac: Rbac<T>;
64
+ getSubject(): Promise<Subject | null>;
65
+ /** Non-throwing check: who is the user and do they meet the requirement? */
66
+ authorize<const Q extends Requirement>(requirement: Q & CheckRequirement<Q, T>, scope?: ScopeOptions): Promise<AuthorizeResult>;
67
67
  /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */
68
68
  getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot>;
69
- can(permission: string, scope?: ScopeOptions): Promise<boolean>;
70
- canAny(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean>;
71
- canAll(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean>;
69
+ can(permission: PermissionName<T>, scope?: ScopeOptions): Promise<boolean>;
70
+ canAny(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>;
71
+ canAll(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>;
72
72
  /** `true` if the user has the role — or ANY of the roles when given an array. */
73
- hasRole(role: Many<string>, scope?: ScopeOptions): Promise<boolean>;
74
- hasAllRoles(roles: Many<string>, scope?: ScopeOptions): Promise<boolean>;
73
+ hasRole(role: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>;
74
+ hasAllRoles(roles: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>;
75
75
  /**
76
76
  * Ensures the user has the permission (or ANY of the permissions). Returns the subject.
77
77
  * Guests: `redirect(loginUrl)` or `notFound()`. Missing permission: `notFound()`. Both configurable.
78
78
  */
79
- requirePermission(permission: Many<string>, opts?: RequireOptions): Promise<Subject>;
79
+ requirePermission<const S extends Many<string>>(permission: S & CheckNames<S, PermissionName<T>>, opts?: RequireOptions): Promise<Subject>;
80
80
  /** Ensures the user has the role (or ANY of the roles). Returns the subject. */
81
- requireRole(role: Many<string>, opts?: RequireOptions): Promise<Subject>;
81
+ requireRole<const S extends Many<string>>(role: S & CheckNames<S, RoleName<T>>, opts?: RequireOptions): Promise<Subject>;
82
82
  /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */
83
- requireRoleOrPermission(items: Many<string>, opts?: RequireOptions): Promise<Subject>;
83
+ requireRoleOrPermission<const S extends Many<string>>(items: S & CheckNames<S, PermissionName<T> | RoleName<T>>, opts?: RequireOptions): Promise<Subject>;
84
84
  /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */
85
- withPermission<Args extends unknown[], R>(permission: Many<string>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
85
+ withPermission<const S extends Many<string>, Args extends unknown[], R>(permission: S & CheckNames<S, PermissionName<T>>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
86
86
  /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */
87
- withRole<Args extends unknown[], R>(role: Many<string>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
87
+ withRole<const S extends Many<string>, Args extends unknown[], R>(role: S & CheckNames<S, RoleName<T>>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
88
88
  /**
89
89
  * Wraps a route handler. Responds `401` (guest) or `403` (missing role/permission) with a JSON body.
90
90
  * Mirrors spatie's `permission`, `role` and `role_or_permission` middleware.
91
91
  */
92
- withRbac<Args extends unknown[]>(handler: (...args: Args) => MaybePromise<Response>, options: WithRbacOptions): (...args: Args) => Promise<Response>;
93
- };
94
- type NextRbac = ReturnType<typeof createNextRbac>;
92
+ withRbac<Args extends unknown[], const O extends WithRbacOptions>(handler: (...args: Args) => MaybePromise<Response>, options: O & CheckRequirement<O, T>): (...args: Args) => Promise<Response>;
93
+ }
94
+
95
+ /**
96
+ * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).
97
+ *
98
+ * ```ts
99
+ * // lib/rbac.ts
100
+ * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({
101
+ * rbac,
102
+ * getSubject: async () => {
103
+ * const session = await auth()
104
+ * return session?.user ? { type: 'user', id: session.user.id } : null
105
+ * },
106
+ * })
107
+ * ```
108
+ *
109
+ * With a typed engine (`createRbac<AppTypes>(...)`), names are checked: `requirePermission('typo')` is a type error.
110
+ */
111
+ declare function createNextRbac<T extends RbacTypeConfig = DefaultRbacTypes>(options: NextRbacOptions<T>): NextRbac<T>;
95
112
 
96
113
  /** Thrown by `withPermission()` / `withRole()` wrapped server actions when access is denied. */
97
114
  declare class RbacUnauthorizedError extends Error {
package/dist/index.d.ts CHANGED
@@ -1,5 +1,4 @@
1
- import * as _anievo_id_rbac_evolution from '@anievo-id/rbac-evolution';
2
- import { Subject, Rbac, TeamId, ScopeOptions, RbacSnapshot, Many } from '@anievo-id/rbac-evolution';
1
+ import { Subject, RbacTypeConfig, DefaultRbacTypes, Rbac, CheckRequirementName, PermissionName, RoleName, ScopeOptions, RbacSnapshot, Many, TeamId } from '@anievo-id/rbac-evolution';
3
2
  import { R as Requirement, M as MaybePromise, F as FailureReason } from './middleware-entry-BYLAhtrk.js';
4
3
  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-BYLAhtrk.js';
5
4
 
@@ -8,9 +7,9 @@ type ForbiddenReason = 'permission' | 'role' | 'role_or_permission';
8
7
  /** Like spatie, the message names the kind of requirement but not the role/permission names. */
9
8
  declare function forbiddenMessage(requirement: Requirement): string;
10
9
 
11
- interface NextRbacOptions {
12
- /** Your `createRbac(...)` instance. */
13
- rbac: Rbac;
10
+ interface NextRbacOptions<T extends RbacTypeConfig = DefaultRbacTypes> {
11
+ /** Your `createRbac(...)` instance. Its typed names (`createRbac<{ permissions: ...; roles: ... }>`) flow into every helper. */
12
+ rbac: Rbac<T>;
14
13
  /** Resolves the current user (e.g. from Auth.js `auth()`). Return `null` for guests. */
15
14
  getSubject: () => MaybePromise<Subject | null | undefined>;
16
15
  /** Default guard for every check. Default: the rbac instance's `defaultGuard`. */
@@ -45,53 +44,71 @@ type AuthorizeResult = {
45
44
  subject: Subject;
46
45
  };
47
46
  type WithRbacOptions = Requirement & ScopeOptions;
48
-
49
47
  /**
50
- * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).
51
- *
52
- * ```ts
53
- * // lib/rbac.ts
54
- * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({
55
- * rbac,
56
- * getSubject: async () => {
57
- * const session = await auth()
58
- * return session?.user ? { type: 'user', id: session.user.id } : null
59
- * },
60
- * })
61
- * ```
48
+ * Checks a name, a `'a|b'` pipe list or an array of them against the names `N`.
49
+ * Any name passes when `N` is `string` (an untyped engine).
62
50
  */
63
- declare function createNextRbac(options: NextRbacOptions): {
64
- rbac: Rbac<_anievo_id_rbac_evolution.DefaultRbacTypes>;
65
- getSubject: () => Promise<Subject | null>;
66
- authorize: (requirement: Requirement, scope?: ScopeOptions) => Promise<AuthorizeResult>;
51
+ type CheckNames<S, N extends string> = S extends string ? CheckRequirementName<S, N> : S extends readonly string[] ? {
52
+ [K in keyof S]: S[K] extends string ? CheckRequirementName<S[K], N> : S[K];
53
+ } : S;
54
+ /** Checks the `permission` / `role` / `roleOrPermission` names of a requirement object `Q` against the names of `T`. */
55
+ type CheckRequirement<Q, T extends RbacTypeConfig> = {
56
+ [K in keyof Q]: K extends 'permission' ? CheckNames<Q[K], PermissionName<T>> : K extends 'role' ? CheckNames<Q[K], RoleName<T>> : K extends 'roleOrPermission' ? CheckNames<Q[K], PermissionName<T> | RoleName<T>> : Q[K];
57
+ };
58
+ /**
59
+ * The helpers returned by `createNextRbac()`. `T` comes from the `rbac` instance: with typed names,
60
+ * every name (including each part of a `'a|b'` list) must be one of them; untyped, any string is accepted.
61
+ */
62
+ interface NextRbac<T extends RbacTypeConfig = DefaultRbacTypes> {
63
+ rbac: Rbac<T>;
64
+ getSubject(): Promise<Subject | null>;
65
+ /** Non-throwing check: who is the user and do they meet the requirement? */
66
+ authorize<const Q extends Requirement>(requirement: Q & CheckRequirement<Q, T>, scope?: ScopeOptions): Promise<AuthorizeResult>;
67
67
  /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */
68
68
  getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot>;
69
- can(permission: string, scope?: ScopeOptions): Promise<boolean>;
70
- canAny(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean>;
71
- canAll(permissions: Many<string>, scope?: ScopeOptions): Promise<boolean>;
69
+ can(permission: PermissionName<T>, scope?: ScopeOptions): Promise<boolean>;
70
+ canAny(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>;
71
+ canAll(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>;
72
72
  /** `true` if the user has the role — or ANY of the roles when given an array. */
73
- hasRole(role: Many<string>, scope?: ScopeOptions): Promise<boolean>;
74
- hasAllRoles(roles: Many<string>, scope?: ScopeOptions): Promise<boolean>;
73
+ hasRole(role: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>;
74
+ hasAllRoles(roles: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>;
75
75
  /**
76
76
  * Ensures the user has the permission (or ANY of the permissions). Returns the subject.
77
77
  * Guests: `redirect(loginUrl)` or `notFound()`. Missing permission: `notFound()`. Both configurable.
78
78
  */
79
- requirePermission(permission: Many<string>, opts?: RequireOptions): Promise<Subject>;
79
+ requirePermission<const S extends Many<string>>(permission: S & CheckNames<S, PermissionName<T>>, opts?: RequireOptions): Promise<Subject>;
80
80
  /** Ensures the user has the role (or ANY of the roles). Returns the subject. */
81
- requireRole(role: Many<string>, opts?: RequireOptions): Promise<Subject>;
81
+ requireRole<const S extends Many<string>>(role: S & CheckNames<S, RoleName<T>>, opts?: RequireOptions): Promise<Subject>;
82
82
  /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */
83
- requireRoleOrPermission(items: Many<string>, opts?: RequireOptions): Promise<Subject>;
83
+ requireRoleOrPermission<const S extends Many<string>>(items: S & CheckNames<S, PermissionName<T> | RoleName<T>>, opts?: RequireOptions): Promise<Subject>;
84
84
  /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */
85
- withPermission<Args extends unknown[], R>(permission: Many<string>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
85
+ withPermission<const S extends Many<string>, Args extends unknown[], R>(permission: S & CheckNames<S, PermissionName<T>>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
86
86
  /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */
87
- withRole<Args extends unknown[], R>(role: Many<string>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
87
+ withRole<const S extends Many<string>, Args extends unknown[], R>(role: S & CheckNames<S, RoleName<T>>, action: (...args: Args) => MaybePromise<R>, scope?: ScopeOptions | undefined): (...args: Args) => Promise<R>;
88
88
  /**
89
89
  * Wraps a route handler. Responds `401` (guest) or `403` (missing role/permission) with a JSON body.
90
90
  * Mirrors spatie's `permission`, `role` and `role_or_permission` middleware.
91
91
  */
92
- withRbac<Args extends unknown[]>(handler: (...args: Args) => MaybePromise<Response>, options: WithRbacOptions): (...args: Args) => Promise<Response>;
93
- };
94
- type NextRbac = ReturnType<typeof createNextRbac>;
92
+ withRbac<Args extends unknown[], const O extends WithRbacOptions>(handler: (...args: Args) => MaybePromise<Response>, options: O & CheckRequirement<O, T>): (...args: Args) => Promise<Response>;
93
+ }
94
+
95
+ /**
96
+ * Server-side helpers for the Next.js App Router (server components, server actions, route handlers).
97
+ *
98
+ * ```ts
99
+ * // lib/rbac.ts
100
+ * export const { getSnapshot, can, requirePermission, withPermission, withRbac } = createNextRbac({
101
+ * rbac,
102
+ * getSubject: async () => {
103
+ * const session = await auth()
104
+ * return session?.user ? { type: 'user', id: session.user.id } : null
105
+ * },
106
+ * })
107
+ * ```
108
+ *
109
+ * With a typed engine (`createRbac<AppTypes>(...)`), names are checked: `requirePermission('typo')` is a type error.
110
+ */
111
+ declare function createNextRbac<T extends RbacTypeConfig = DefaultRbacTypes>(options: NextRbacOptions<T>): NextRbac<T>;
95
112
 
96
113
  /** Thrown by `withPermission()` / `withRole()` wrapped server actions when access is denied. */
97
114
  declare class RbacUnauthorizedError extends Error {
package/dist/index.js CHANGED
@@ -19,6 +19,10 @@ var RbacUnauthorizedError = class extends Error {
19
19
  // src/server.ts
20
20
  var EMPTY_SNAPSHOT = { roles: [], permissions: [] };
21
21
  function createNextRbac(options) {
22
+ const helpers = buildNextRbac(options);
23
+ return helpers;
24
+ }
25
+ function buildNextRbac(options) {
22
26
  const { rbac } = options;
23
27
  async function getSubject() {
24
28
  return await options.getSubject() ?? null;
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 { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport { checkRequirement, type FailureReason, type MaybePromise, type 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 | undefined\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 | undefined\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: (() => never) | undefined\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: (() => never) | undefined\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n /** `requirePermission` / `requireRole`: require EVERY listed name instead of any (spatie v8.5 `canAll()`). */\n all?: boolean | undefined\n loginUrl?: string | undefined\n onUnauthenticated?: (() => never) | undefined\n onUnauthorized?: (() => never) | undefined\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 return checkRequirement(requirement, (n) => s.can(n), (n) => s.hasRole(n))\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 | undefined,\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?.all && { all: true }) }, 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?.all && { all: true }) }, 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 | undefined,\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 | undefined,\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"]}
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 {\n CheckRequirementName,\n DefaultRbacTypes,\n Many,\n PermissionName,\n Rbac,\n RbacSnapshot,\n RbacTypeConfig,\n RoleName,\n ScopeOptions,\n Subject,\n TeamId,\n} from '@anievo-id/rbac-evolution'\nimport { RbacUnauthorizedError } from './errors'\nimport { forbiddenResponse, unauthenticatedResponse } from './responses'\nimport { checkRequirement, type FailureReason, type MaybePromise, type Requirement } from './types'\n\nexport interface NextRbacOptions<T extends RbacTypeConfig = DefaultRbacTypes> {\n /** Your `createRbac(...)` instance. Its typed names (`createRbac<{ permissions: ...; roles: ... }>`) flow into every helper. */\n rbac: Rbac<T>\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 | undefined\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 | undefined\n /** Replaces the default guest handling of `require*()` (must throw, e.g. `() => redirect('/login')`). */\n onUnauthenticated?: (() => never) | undefined\n /** Replaces the default `notFound()` of `require*()` (must throw, e.g. `() => forbidden()`). */\n onUnauthorized?: (() => never) | undefined\n}\n\n/** Per-call options for `require*()`. */\nexport interface RequireOptions extends ScopeOptions {\n /** `requirePermission` / `requireRole`: require EVERY listed name instead of any (spatie v8.5 `canAll()`). */\n all?: boolean | undefined\n loginUrl?: string | undefined\n onUnauthenticated?: (() => never) | undefined\n onUnauthorized?: (() => never) | undefined\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/**\n * Checks a name, a `'a|b'` pipe list or an array of them against the names `N`.\n * Any name passes when `N` is `string` (an untyped engine).\n */\nexport type CheckNames<S, N extends string> = S extends string\n ? CheckRequirementName<S, N>\n : S extends readonly string[]\n ? { [K in keyof S]: S[K] extends string ? CheckRequirementName<S[K], N> : S[K] }\n : S\n\n/** Checks the `permission` / `role` / `roleOrPermission` names of a requirement object `Q` against the names of `T`. */\nexport type CheckRequirement<Q, T extends RbacTypeConfig> = {\n [K in keyof Q]: K extends 'permission'\n ? CheckNames<Q[K], PermissionName<T>>\n : K extends 'role'\n ? CheckNames<Q[K], RoleName<T>>\n : K extends 'roleOrPermission'\n ? CheckNames<Q[K], PermissionName<T> | RoleName<T>>\n : Q[K]\n}\n\n/**\n * The helpers returned by `createNextRbac()`. `T` comes from the `rbac` instance: with typed names,\n * every name (including each part of a `'a|b'` list) must be one of them; untyped, any string is accepted.\n */\nexport interface NextRbac<T extends RbacTypeConfig = DefaultRbacTypes> {\n rbac: Rbac<T>\n getSubject(): Promise<Subject | null>\n /** Non-throwing check: who is the user and do they meet the requirement? */\n authorize<const Q extends Requirement>(\n requirement: Q & CheckRequirement<Q, T>,\n scope?: ScopeOptions,\n ): Promise<AuthorizeResult>\n /** Roles & permissions of the current user — pass to `<RbacProvider snapshot={...}>`. Guests get an empty snapshot. */\n getSnapshot(scope?: ScopeOptions): Promise<RbacSnapshot>\n can(permission: PermissionName<T>, scope?: ScopeOptions): Promise<boolean>\n canAny(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>\n canAll(permissions: Many<PermissionName<T>>, scope?: ScopeOptions): Promise<boolean>\n /** `true` if the user has the role — or ANY of the roles when given an array. */\n hasRole(role: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>\n hasAllRoles(roles: Many<RoleName<T>>, scope?: ScopeOptions): Promise<boolean>\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<const S extends Many<string>>(\n permission: S & CheckNames<S, PermissionName<T>>,\n opts?: RequireOptions,\n ): Promise<Subject>\n /** Ensures the user has the role (or ANY of the roles). Returns the subject. */\n requireRole<const S extends Many<string>>(role: S & CheckNames<S, RoleName<T>>, opts?: RequireOptions): Promise<Subject>\n /** Ensures the user has ANY of the given roles or permissions. Returns the subject. */\n requireRoleOrPermission<const S extends Many<string>>(\n items: S & CheckNames<S, PermissionName<T> | RoleName<T>>,\n opts?: RequireOptions,\n ): Promise<Subject>\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the permission (or ANY of them). */\n withPermission<const S extends Many<string>, Args extends unknown[], R>(\n permission: S & CheckNames<S, PermissionName<T>>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions | undefined,\n ): (...args: Args) => Promise<R>\n /** Wraps a server action; throws `RbacUnauthorizedError` unless the user has the role (or ANY of them). */\n withRole<const S extends Many<string>, Args extends unknown[], R>(\n role: S & CheckNames<S, RoleName<T>>,\n action: (...args: Args) => MaybePromise<R>,\n scope?: ScopeOptions | undefined,\n ): (...args: Args) => Promise<R>\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[], const O extends WithRbacOptions>(\n handler: (...args: Args) => MaybePromise<Response>,\n options: O & CheckRequirement<O, T>,\n ): (...args: Args) => Promise<Response>\n}\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 *\n * With a typed engine (`createRbac<AppTypes>(...)`), names are checked: `requirePermission('typo')` is a type error.\n */\nexport function createNextRbac<T extends RbacTypeConfig = DefaultRbacTypes>(options: NextRbacOptions<T>): NextRbac<T> {\n // The implementation is untyped (plain `string` names); `NextRbac<T>` adds the typed signatures.\n const helpers = buildNextRbac(options as unknown as NextRbacOptions) satisfies Record<keyof NextRbac, unknown>\n return helpers as unknown as NextRbac<T>\n}\n\nfunction buildNextRbac(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 return checkRequirement(requirement, (n) => s.can(n), (n) => s.hasRole(n))\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 | undefined,\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?.all && { all: true }) }, 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?.all && { all: true }) }, 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 | undefined,\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 | undefined,\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"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anievo-id/rbac-evolution-next",
3
- "version": "0.7.1",
3
+ "version": "0.9.0",
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.7.1"
60
+ "@anievo-id/rbac-evolution": "^0.9.0"
61
61
  },
62
62
  "peerDependencies": {
63
63
  "next": ">=14",