@inixiative/transitions 0.5.0 → 0.7.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,16 +1,20 @@
1
1
  # @inixiative/transitions
2
2
 
3
+ > One of the [inixiative](https://www.inixiative.com) building blocks. Stop rediscovering what you need to build. See [all the projects](https://github.com/inixiative).
4
+
3
5
  A small, **stateless** primitive on top of [`@inixiative/json-rules`](https://github.com/inixiative/json-rules)
4
6
  that answers two questions about an entity's lifecycle, declaratively:
5
7
 
6
- - **"Can this change happen?"** — guard a proposed update (`checkTransition`).
7
- - **"What changes can happen?"** — list available actions for a record (`available`), and via
8
- `toPrisma`, every record currently eligible for an action (`eligible`).
8
+ - **"Can this change happen?"** `checkTransition` guards a proposed update.
9
+ - **"What changes can happen?"** `available` lists the actions open to one record, and `eligible`
10
+ compiles the same rules through `toPrisma` into a query for every record an action is open to.
9
11
 
10
12
  It is **not** a state machine (no statecharts/actors/hierarchy), does **not** own state, and does
11
13
  **not** execute the change or run side effects. It is a guard + affordance layer. A transition is
12
- **pure data** → serializable → tenant-configurable at runtime (stored in the DB, edited in a UI,
13
- no deploy to change a lifecycle).
14
+ **pure data**, so a tenant's lifecycle can be stored in the database and edited in a UI at runtime,
15
+ with no deploy to change it. Because one rule set answers both the single-record check and the
16
+ set query, the set query never returns a record the check would refuse; where a rule can't compile
17
+ to Prisma, `eligible` throws.
14
18
 
15
19
  > Full design: [`docs/FEAT-018-transitions.md`](./docs/FEAT-018-transitions.md).
16
20
 
@@ -22,16 +26,16 @@ resource → action → Action { paths: Transition[], label? }
22
26
  Side { predicate, permission?, requires? }
23
27
  ```
24
28
 
25
- A `resource` key is map-qualified (`map:Model`, e.g. `db:Inquiry`) — the same convention
29
+ A `resource` key is map-qualified (`map:Model`, e.g. `db:Inquiry`), the same convention
26
30
  `@inixiative/permissions` uses, so a transition's `permission` can delegate into the rebac schema.
27
31
 
28
- A `Transition` is one atomic `from → to` edge. An **Action** (a named verb) is the OR of its edges —
32
+ A `Transition` is one atomic `from → to` edge. An **Action** (a named verb) is the OR of its edges:
29
33
  disjunction lives at the action level, never inside a `Transition`, so the kernel stays atomic and
30
34
  serializable.
31
35
 
32
- The `from`/`to` asymmetry is load-bearing and applies to **both** `predicate` (legality) and
36
+ The `from`/`to` asymmetry matters and applies to **both** `predicate` (legality) and
33
37
  `permission` (authz): `from.*` is evaluated against the **current** record, `to.*` against the
34
- **resulting (merged)** record. Permission only ever lives on a side — every authz check reads a
38
+ **resulting (merged)** record. Permission only ever lives on a side: every authz check reads a
35
39
  concrete record, so there is no record-free action-level permission.
36
40
 
37
41
  ## Check
@@ -60,7 +64,7 @@ checkTransition(rules, 'db:Inquiry', 'approve', { status: 'approved' }, { status
60
64
  ```
61
65
 
62
66
  `checkTransition(rules, resource, action, record, changes, { actor, authorize })` returns **`true`** when
63
- allowed, else a structured **`Reason`** — never a bare bool:
67
+ allowed, else a structured **`Reason`**, never a bare bool:
64
68
 
65
69
  ```ts
66
70
  type SideReason = { predicate?: string; permission?: string }; // why one side failed
@@ -69,7 +73,7 @@ type Reason = { paths: PathReason[] }; // one entry per
69
73
  ```
70
74
 
71
75
  Each side reports its `predicate` (legality) and `permission` (authz) failures independently, and
72
- `from`/`to` are kept separate — so the caller sees the whole picture, not just the first failure. To
76
+ `from`/`to` are kept separate, so the caller sees every failure, not only the first. To
73
77
  map to HTTP: a path that fails purely on `permission` is a 403; any `predicate` failure is a 409.
74
78
  `describe(reason)` builds a human-readable message.
75
79
 
@@ -81,13 +85,13 @@ else every path's `PathReason`.
81
85
 
82
86
  The kernel never imports an authorization library. Per-side `permission` is a serializable
83
87
  `ActionRule` re-exported straight from [`@inixiative/permissions`](https://github.com/inixiative/permissions)
84
- (`string` delegation, `{ rel, action }`, `{ self }`, abac `{ rule }`, `any`/`all`, boolean terminals
88
+ (`string` delegation, `{ rel, action }`, abac `{ rule }` (the actor reads as `__actor`), `any`/`all`, boolean terminals
85
89
  `true`/`false`, `null`), and you inject an `authorize` callback to evaluate it:
86
90
 
87
91
  ```ts
88
92
  import { checkTransition, createAuthorize } from '@inixiative/transitions';
89
93
 
90
- const authorize = createAuthorize({ schema: rebacSchema })('db:Inquiry');
94
+ const authorize = createAuthorize({ schema: rebacSchema, map: schemaMap })('db:Inquiry');
91
95
  checkTransition(rules, 'db:Inquiry', 'approve', record, changes, { actor, authorize });
92
96
  ```
93
97
 
@@ -100,31 +104,38 @@ from.permission AND to.permission
100
104
 
101
105
  Absent = open; `null` (or `false`) = terminal deny. Omit `authorize` to check legality only.
102
106
 
103
- ### `createAuthorize` — the `@inixiative/permissions` adapter
107
+ ### `createAuthorize`: the `@inixiative/permissions` adapter
104
108
 
105
109
  Authorization is **not** reimplemented here. `createAuthorize` is a thin adapter that bridges
106
110
  `@inixiative/permissions`' production rebac `check` onto the `Authorize` seam:
107
111
  `createAuthorize(options)(resource)` returns an `Authorize` bound to a (map-qualified) `resource`.
108
- permissions owns the whole evaluation — `string` delegation with **cycle detection**, intra-map `rel`
109
- walks (via an injected `resolveRelation`), cross-map bridge walks, `{ self }`, abac `{ rule }`, boolean
110
- terminals, `any`/`all`, and per-row `permissionRules` overrides. It speaks the same map-qualified
112
+ permissions owns the whole evaluation: `string` delegation with **cycle detection**, `rel` walks
113
+ through the schema map, cross-map bridge walks, abac `{ rule }` reading the actor as `__actor`,
114
+ boolean terminals, `any`/`all`, and per-row `permissionRules` overrides. Acting as yourself is a
115
+ walk to your own entry (`{ rel: 'user', action }` on a row hydrated with its `user`); a row without
116
+ the relation loaded is denied. It speaks the same map-qualified
111
117
  `resource` keys as this package.
112
118
 
113
119
  ```ts
114
- import type { RebacSchema } from '@inixiative/permissions';
120
+ import type { RebacSchema, SchemaMap } from '@inixiative/permissions';
115
121
  import { createAuthorize } from '@inixiative/transitions';
116
122
 
117
123
  const schema: RebacSchema = { permissions: { 'db:Inquiry': { actions: { /* … */ } } } };
118
124
  const authorize = createAuthorize({
119
125
  schema,
120
- resolveRelation, // optional; default: the relation segment name is the resource key
121
- isSuperadmin, // optional; derived from the actor
126
+ map, // permissions' SchemaMap: { resources, fieldMap, polymorphism? }
127
+ isSuperadmin, // optional; derived from the actor
122
128
  })('db:Inquiry');
129
+ checkTransition(rules, 'db:Inquiry', 'cancel', record, changes, {
130
+ actor: { model: 'User', record: user },
131
+ authorize,
132
+ });
123
133
  ```
124
134
 
125
- `options`: `schema` (permissions' `{ bridges?, permissions }`), optional `resolveRelation`,
126
- `isSuperadmin`, and `data` (supplemental hydrated rows for bridge walks). A cyclic permission graph —
127
- which permissions surfaces by throwing — is caught and denied (fail closed), so the guard terminates
135
+ `options`: `schema` (permissions' `{ bridges?, permissions }`), `map` (permissions' `SchemaMap`: which
136
+ model each resource is, its relations and foreign keys), optional `isSuperadmin`, and `data`
137
+ (supplemental hydrated rows for bridge walks). The actor is permissions' `{ model, record }`. A cyclic permission graph
138
+ (permissions throws on one) is caught and denied (fail closed), so the guard terminates
128
139
  cleanly.
129
140
 
130
141
  ## Affordance + set query
@@ -146,8 +157,8 @@ const where = await executePrismaPlan(plan, prisma);
146
157
  `executePrismaPlan(plan, prisma)`, which resolves the plan's field and step references, and use
147
158
  the `where` it returns.
148
159
 
149
- A predicate evaluates with the same options json-rules' `check()` takes — `now`, `timeZone`,
150
- `weekStart`, `bindings` — passed beside `actor` / `authorize`. `checkTransition`,
160
+ A predicate evaluates with the same options json-rules' `check()` takes (`now`, `timeZone`,
161
+ `weekStart`, `bindings`), passed beside `actor` / `authorize`. `checkTransition`,
151
162
  `checkPath` and `available` give them to both sides; `eligible` resolves the bindings into the
152
163
  predicate (and into a `{ bind }` `timeZone`) and compiles with `now`, so the set query selects
153
164
  exactly the records the single check accepts:
@@ -161,7 +172,7 @@ eligible(rules, 'incident', 'autoResolve', options);
161
172
  // → plan whose where is { AND: [{ status: … }, { lastBreachedAt: { lt: <now - window> } }] }
162
173
  ```
163
174
 
164
- A guard can read its window off the record instead — self-contained, nothing to bind:
175
+ A guard can read its window off the record instead, with nothing to bind:
165
176
 
166
177
  ```ts
167
178
  { field: 'lastBreachedAt', dateOperator: 'before',
@@ -169,7 +180,7 @@ A guard can read its window off the record instead — self-contained, nothing t
169
180
  ```
170
181
 
171
182
  `check()` evaluates it per record; `eligible` throws on it, since a Prisma `where` can't do
172
- arithmetic on a column — it never returns the wrong set.
183
+ arithmetic on a column. It never returns the wrong set.
173
184
 
174
185
  A guard that compares a column with a column (`{ field: 'approvals', operator: 'lessThan', path:
175
186
  'required' }`) or counts a relation needs the schema to compile: pass toPrisma's `map` /
@@ -189,24 +200,24 @@ Without the schema, a column comparison throws.
189
200
  `to.merge` produces the resulting record. Keyword strategies are serializable; a callback is full-power
190
201
  but not (`isSerializable(transition)` tells you which).
191
202
 
192
- - `spread` (default) — shallow overwrite
193
- - `deepMerge` — recursive, arrays replaced
194
- - `{ kind: 'append', path }` — concat at a field path
195
- - `{ kind: 'appendUnique', path }` — concat + dedupe
203
+ - `spread` (default): shallow overwrite
204
+ - `deepMerge`: recursive, arrays replaced
205
+ - `{ kind: 'append', path }`: concat at a field path
206
+ - `{ kind: 'appendUnique', path }`: concat + dedupe
196
207
 
197
208
  ## Authoring validation
198
209
 
199
210
  `validateTransition(t, { lens?, requireSerializable? })` validates predicates (via json-rules
200
211
  `validateRule`, plus `validateRuleInLens` when a `lens` scopes referenceable fields), merge
201
- strategy, and permission shape (via `@inixiative/permissions`' zod `actionRuleSchema`) — run it on
202
- save before persisting a tenant config. It returns json-rules' `ValidationResult` —
203
- `{ ok, errors: { path, message, code }[] }` — and never throws, even on malformed input. json-rules'
212
+ strategy, and permission shape (via `@inixiative/permissions`' `validateActionRule`: every `{ rule }` positive). Run it on
213
+ save before persisting a tenant config. It returns json-rules' `ValidationResult`,
214
+ `{ ok, errors: { path, message, code }[] }`, and never throws, even on malformed input. json-rules'
204
215
  issues keep their codes; transitions adds `missing_side`, `missing_predicate`, `invalid_permission`,
205
216
  `invalid_requires`, `invalid_merge` and `unserializable_merge`.
206
217
 
207
- ## Not built yet (designed — see the plan)
218
+ ## Not built yet (designed in the plan)
208
219
 
209
- - **`requires` relation loader** — derive a Prisma `include` from a side's `requires`, auto-load, fail
220
+ - **`requires` relation loader:** derive a Prisma `include` from a side's `requires`, auto-load, fail
210
221
  loud on unloaded reads, respect tenancy. The kernel ignores `requires` (it's metadata).
211
222
  - **Permission-filtered `available()`** beyond the from-side static check.
212
223
  - **Lens-aware structural composition** check (does A's `to` lens line up with B's `from`).
package/dist/index.cjs CHANGED
@@ -1,2 +1,2 @@
1
- 'use strict';var permissions=require('@inixiative/permissions'),jsonRules=require('@inixiative/json-rules'),lodashEs=require('lodash-es'),actionRuleSchema=require('@inixiative/permissions/actionRuleSchema');var v=/Cycle detected/,M=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getUserId:()=>e?.id??null}),G=e=>{let t=e.resolveRelation??((o,n)=>n),i=permissions.createRebacCheck(t);return o=>(n,r,a)=>{let p=M(a,e.isSuperadmin),c={resource:o,record:r,data:e.data?.(r,a)};try{return i(p,e.schema,c,n)}catch(s){if(s instanceof Error&&v.test(s.message))return false;throw s}}};var g=e=>Array.isArray(e)?e:e===void 0?[]:[e],V=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,i={})=>{if(typeof e=="function")return e(t,i);let o=e??"spread";if(o==="spread")return {...t,...i};if(o==="deepMerge")return lodashEs.mergeWith(lodashEs.cloneDeep(t),lodashEs.cloneDeep(i),V);let{kind:n,path:r}=o,a=lodashEs.cloneDeep({...t,...i}),p=[...g(lodashEs.get(t,r)),...g(lodashEs.get(i,r))];return lodashEs.set(a,r,n==="appendUnique"?lodashEs.uniqWith(p,lodashEs.isEqual):p),a};var b=e=>typeof e=="string"?e:"predicate not satisfied",w=(e,t,i,o)=>!e||t===void 0?false:!e(t,i,o),A=(e,t,i={},o={})=>{let{actor:n,authorize:r,...a}=o,p=h(e.to.merge,t,i),c={},s=jsonRules.check(e.from.predicate,t,a);s!==true&&(c.predicate=b(s)),w(r,e.from.permission,t,n)&&(c.permission="not authorized");let u={},m=jsonRules.check(e.to.predicate,p,a);m!==true&&(u.predicate=b(m)),w(r,e.to.permission,p,n)&&(u.permission="not authorized");let d={};return (c.predicate||c.permission)&&(d.from=c),(u.predicate||u.permission)&&(d.to=u),d.from||d.to?d:true};var k=e=>{let t=[];return e.from?.predicate&&t.push(`from: ${e.from.predicate}`),e.from?.permission&&t.push(`from: ${e.from.permission}`),e.to?.predicate&&t.push(`to: ${e.to.predicate}`),e.to?.permission&&t.push(`to: ${e.to.permission}`),t.join("; ")||"unknown"},ee=e=>e.paths.length===0?"no transition path available":e.paths.length===1?k(e.paths[0]):e.paths.map((t,i)=>`path ${i}: ${k(t)}`).join(" | ");var S=(e,t,i)=>{let o=e[t]?.[i];if(!o)throw new Error(`transition: no action "${i}" registered on resource "${t}"`);return o},ne=(e,t,i,o,n={},r={})=>{let a=S(e,t,i),p=[];for(let c of a.paths){let s=A(c,o,n,r);if(s===true)return true;p.push(s);}return {paths:p}},re=(e,t,i,o={})=>{let n=e[t];if(!n)return [];let{actor:r,authorize:a,...p}=o,c=(s,u)=>!a||s===void 0||a(s,u,r);return Object.entries(n).filter(([,s])=>s.paths.some(u=>jsonRules.check(u.from.predicate,i,p)===true&&c(u.from.permission,i))).map(([s])=>s)},I=(e,t)=>{if(e===void 0||typeof e=="string")return e;let i={field:"timeZone",operator:jsonRules.Operator.equals,...e},{field:o,operator:n,...r}=jsonRules.bindRule(i,t);return r},se=(e,t,i,o={})=>{let n=S(e,t,i),{bindings:r={},timeZone:a,...p}=o,c=jsonRules.bindRule({any:n.paths.map(s=>s.from.predicate)},r);return jsonRules.toPrisma(c,{...p,timeZone:I(a,r)})};var ce=e=>f(e.to.merge);var N=new Set(["spread","deepMerge"]),D=new Set(["append","appendUnique"]),U=(e,t,i,o)=>{if(e===void 0){t.push({path:i,message:"predicate is required",code:"missing_predicate"});return}let n=[...jsonRules.validateRule(e).errors,...o?jsonRules.validateRuleInLens(e,o).errors:[]];for(let r of n)t.push({...r,path:`${i}.${r.path}`});},W=(e,t,i)=>{if(e===void 0)return;let o=actionRuleSchema.actionRuleSchema.safeParse(e);if(!o.success)for(let n of o.error.issues)n.path.length===0?t.push({path:i,message:"unrecognized ActionRule shape",code:"invalid_permission"}):t.push({path:`${i}.${n.path.join(".")}`,message:n.message,code:"invalid_permission"});},Y=(e,t,i)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){N.has(e)||t.push({path:i,message:`unknown merge strategy "${e}"`,code:"invalid_merge"});return}D.has(e.kind)?e.path||t.push({path:i,message:`merge "${e.kind}" requires a \`path\``,code:"invalid_merge"}):t.push({path:i,message:`unknown merge kind "${e.kind}"`,code:"invalid_merge"});}},T=(e,t,i,o)=>{if(e===null||typeof e!="object"){t.push({path:i,message:`\`${i}\` side is required`,code:"missing_side"});return}U(e.predicate,t,`${i}.predicate`,o.lens),W(e.permission,t,`${i}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${i}.requires`,message:"`requires` must be a Prisma-include-shaped object",code:"invalid_requires"}),"merge"in e&&Y(e.merge,t,`${i}.merge`);},me=(e,t={})=>{let i=[];return T(e?.from,i,"from",t),T(e?.to,i,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&i.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy",code:"unserializable_merge"}),{ok:i.length===0,errors:i}};exports.applyMerge=h;exports.available=re;exports.checkPath=A;exports.checkTransition=ne;exports.createAuthorize=G;exports.describe=ee;exports.eligible=se;exports.isSerializable=ce;exports.isSerializableMerge=f;exports.validateTransition=me;//# sourceMappingURL=index.cjs.map
1
+ 'use strict';var permissions=require('@inixiative/permissions'),jsonRules=require('@inixiative/json-rules'),lodashEs=require('lodash-es');var M=/Cycle detected/,$=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getActor:()=>e??null}),B=e=>{let t=permissions.createRebacCheck(e.map);return i=>(o,r,n)=>{let a=$(n,e.isSuperadmin),p={resource:i,record:r,data:e.data?.(r,n)};try{return t(a,e.schema,p,o)}catch(s){if(s instanceof Error&&M.test(s.message))return false;throw s}}};var g=e=>Array.isArray(e)?e:e===void 0?[]:[e],V=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,i={})=>{if(typeof e=="function")return e(t,i);let o=e??"spread";if(o==="spread")return {...t,...i};if(o==="deepMerge")return lodashEs.mergeWith(lodashEs.cloneDeep(t),lodashEs.cloneDeep(i),V);let{kind:r,path:n}=o,a=lodashEs.cloneDeep({...t,...i}),p=[...g(lodashEs.get(t,n)),...g(lodashEs.get(i,n))];return lodashEs.set(a,n,r==="appendUnique"?lodashEs.uniqWith(p,lodashEs.isEqual):p),a};var b=e=>typeof e=="string"?e:"predicate not satisfied",w=(e,t,i,o)=>!e||t===void 0?false:!e(t,i,o),A=(e,t,i={},o={})=>{let{actor:r,authorize:n,...a}=o,p=h(e.to.merge,t,i),s={},c=jsonRules.check(e.from.predicate,t,a);c!==true&&(s.predicate=b(c)),w(n,e.from.permission,t,r)&&(s.permission="not authorized");let u={},l=jsonRules.check(e.to.predicate,p,a);l!==true&&(u.predicate=b(l)),w(n,e.to.permission,p,r)&&(u.permission="not authorized");let d={};return (s.predicate||s.permission)&&(d.from=s),(u.predicate||u.permission)&&(d.to=u),d.from||d.to?d:true};var k=e=>{let t=[];return e.from?.predicate&&t.push(`from: ${e.from.predicate}`),e.from?.permission&&t.push(`from: ${e.from.permission}`),e.to?.predicate&&t.push(`to: ${e.to.predicate}`),e.to?.permission&&t.push(`to: ${e.to.permission}`),t.join("; ")||"unknown"},te=e=>e.paths.length===0?"no transition path available":e.paths.length===1?k(e.paths[0]):e.paths.map((t,i)=>`path ${i}: ${k(t)}`).join(" | ");jsonRules.registerEngineGlobals("transitions",{});var S=(e,t,i)=>{let o=e[t]?.[i];if(!o)throw new Error(`transition: no action "${i}" registered on resource "${t}"`);return o},se=(e,t,i,o,r={},n={})=>{let a=S(e,t,i),p=[];for(let s of a.paths){let c=A(s,o,r,n);if(c===true)return true;p.push(c);}return {paths:p}},ae=(e,t,i,o={})=>{let r=e[t];if(!r)return [];let{actor:n,authorize:a,...p}=o,s=(c,u)=>!a||c===void 0||a(c,u,n);return Object.entries(r).filter(([,c])=>c.paths.some(u=>jsonRules.check(u.from.predicate,i,p)===true&&s(u.from.permission,i))).map(([c])=>c)},L=(e,t)=>{if(e===void 0||typeof e=="string")return e;let i={field:"timeZone",operator:jsonRules.Operator.equals,...e},{field:o,operator:r,...n}=jsonRules.bindRule(i,t);return n},pe=(e,t,i,o={})=>{let r=S(e,t,i),{bindings:n={},timeZone:a,...p}=o,s=jsonRules.bindRule({any:r.paths.map(c=>c.from.predicate)},n);return jsonRules.toPrisma(s,{...p,timeZone:L(a,n)})};var de=e=>f(e.to.merge);var D=new Set(["spread","deepMerge"]),W=new Set(["append","appendUnique"]),Y=(e,t,i,o)=>{if(e===void 0){t.push({path:i,message:"predicate is required",code:"missing_predicate"});return}let r=[...jsonRules.validateRule(e).errors,...o?jsonRules.validateRuleInLens(e,o).errors:[]];for(let n of r)t.push({...n,path:`${i}.${n.path}`});},G=(e,t,i)=>{if(e!==void 0)for(let o of permissions.validateActionRule(e).errors)t.push({...o,path:`${i}${o.path.slice(1)}`,code:"invalid_permission"});},K=(e,t,i)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){D.has(e)||t.push({path:i,message:`unknown merge strategy "${e}"`,code:"invalid_merge"});return}W.has(e.kind)?e.path||t.push({path:i,message:`merge "${e.kind}" requires a \`path\``,code:"invalid_merge"}):t.push({path:i,message:`unknown merge kind "${e.kind}"`,code:"invalid_merge"});}},T=(e,t,i,o)=>{if(e===null||typeof e!="object"){t.push({path:i,message:`\`${i}\` side is required`,code:"missing_side"});return}Y(e.predicate,t,`${i}.predicate`,o.lens),G(e.permission,t,`${i}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${i}.requires`,message:"`requires` must be a Prisma-include-shaped object",code:"invalid_requires"}),"merge"in e&&K(e.merge,t,`${i}.merge`);},ge=(e,t={})=>{let i=[];return T(e?.from,i,"from",t),T(e?.to,i,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&i.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy",code:"unserializable_merge"}),{ok:i.length===0,errors:i}};exports.applyMerge=h;exports.available=ae;exports.checkPath=A;exports.checkTransition=se;exports.createAuthorize=B;exports.describe=te;exports.eligible=pe;exports.isSerializable=de;exports.isSerializableMerge=f;exports.validateTransition=ge;//# sourceMappingURL=index.cjs.map
2
2
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","resolveRelation","_resource","segment","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","evaluation","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","bindTimeZone","timeZone","bindings","carrier","Operator","_field","_operator","bindRule","eligible","compile","predicate","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","errors","lens","issues","validateRule","validateRuleInLens","issue","validatePermission","parsed","actionRuleSchema","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type ResolveRelation,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\n// permissions surfaces a cyclic permission graph by throwing; the transitions guard denies (fail\n// closed) so a misconfigured schema terminates cleanly instead of propagating out of the kernel.\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /**\n * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).\n * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved\n * by the engine from `schema.bridges`, not here.\n */\n resolveRelation?: ResolveRelation<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\n// The transitions seam carries no pre-granted (role-derived) permix state, so a direct permix grant\n// always misses and authorization is decided entirely by the schema. The actor supplies only its id\n// (for `{ self }`) and an optional superadmin bypass.\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getUserId: () => actor?.id ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,\n * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const resolveRelation: ResolveRelation<R> =\n options.resolveRelation ?? ((_resource, segment) => segment as R);\n const check = createRebacCheck<R>(resolveRelation);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n PathReason,\n Row,\n SideReason,\n Transition,\n TransitionOptions,\n} from './types';\n\nconst predicateReason = (result: boolean | string): string =>\n typeof result === 'string' ? result : 'predicate not satisfied';\n\n/**\n * Does this permission DENY?\n * - no authorizer injected → can't deny (legality-only mode)\n * - `undefined` rule → permission absent → open → can't deny\n * - any other rule (incl. `null` = terminal deny) → delegate to the authorizer\n */\nconst denies = (\n authorize: Authorize | undefined,\n rule: ActionRule | undefined,\n record: Row,\n actor: Actor,\n): boolean => {\n if (!authorize || rule === undefined) return false;\n return !authorize(rule, record, actor);\n};\n\n/**\n * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —\n * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole\n * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns\n * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;\n * json-rules' `check()` options (`now`, `bindings`, …) reach both predicates.\n */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: TransitionOptions = {},\n): true | PathReason => {\n const { actor, authorize, ...evaluation } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const from: SideReason = {};\n const fromPredicate = checkRule(transition.from.predicate, record as Row, evaluation);\n if (fromPredicate !== true) from.predicate = predicateReason(fromPredicate);\n if (denies(authorize, transition.from.permission, record as Row, actor))\n from.permission = 'not authorized';\n\n const to: SideReason = {};\n const toPredicate = checkRule(transition.to.predicate, next as Row, evaluation);\n if (toPredicate !== true) to.predicate = predicateReason(toPredicate);\n if (denies(authorize, transition.to.permission, next as Row, actor))\n to.permission = 'not authorized';\n\n const reason: PathReason = {};\n if (from.predicate || from.permission) reason.from = from;\n if (to.predicate || to.permission) reason.to = to;\n return reason.from || reason.to ? reason : true;\n};\n","import type { PathReason, Reason } from './types';\n\nconst describePath = (path: PathReason): string => {\n const segs: string[] = [];\n if (path.from?.predicate) segs.push(`from: ${path.from.predicate}`);\n if (path.from?.permission) segs.push(`from: ${path.from.permission}`);\n if (path.to?.predicate) segs.push(`to: ${path.to.predicate}`);\n if (path.to?.permission) segs.push(`to: ${path.to.permission}`);\n return segs.join('; ') || 'unknown';\n};\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n if (reason.paths.length === 0) return 'no transition path available';\n if (reason.paths.length === 1) return describePath(reason.paths[0]);\n return reason.paths.map((path, i) => `path ${i}: ${describePath(path)}`).join(' | ');\n};\n","import {\n bindRule,\n type Condition,\n check as checkRule,\n Operator,\n type RuleValue,\n type TimeZoneConfig,\n type ToPrismaResult,\n toPrisma,\n} from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n CheckResult,\n EligibleOptions,\n PathReason,\n Row,\n TransitionMap,\n TransitionOptions,\n} from './types';\n\nconst getAction = (rules: TransitionMap, resource: string, action: string): Action => {\n const found = rules[resource]?.[action];\n if (!found)\n throw new Error(`transition: no action \"${action}\" registered on resource \"${resource}\"`);\n return found;\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches\n * the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a\n * {@link Reason} with one {@link PathReason} per candidate path tried.\n *\n * `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`\n * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound\n * to this resource); a `predicate` that reads a bridged relation expects a stitched record.\n */\nexport const checkTransition = (\n rules: TransitionMap,\n resource: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: TransitionOptions = {},\n): CheckResult => {\n const found = getAction(rules, resource, action);\n const paths: PathReason[] = [];\n for (const path of found.paths) {\n const result = checkPath(path, record, changes, options);\n if (result === true) return true;\n paths.push(result);\n }\n return { paths };\n};\n\n/**\n * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`\n * side (predicate + `from` permission against the current record) — `to` needs the merged record,\n * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.\n */\nexport const available = (\n rules: TransitionMap,\n resource: string,\n record: Row,\n options: TransitionOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize, ...evaluation } = options;\n\n const allows = (rule: ActionRule | undefined, rec: Row): boolean =>\n !authorize || rule === undefined || authorize(rule, rec, actor);\n\n return Object.entries(actions)\n .filter(([, action]) =>\n action.paths.some(\n (path) =>\n checkRule(path.from.predicate, record, evaluation) === true &&\n allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n// A `{ bind }` zone, resolved the way the rule's own tokens are: json-rules' bindRule over a\n// carrier leaf. An uncovered token stays a token, and toPrisma reports it unresolved.\nconst bindTimeZone = (\n timeZone: TimeZoneConfig | undefined,\n bindings: Record<string, RuleValue>,\n): TimeZoneConfig | undefined => {\n if (timeZone === undefined || typeof timeZone === 'string') return timeZone;\n const carrier = { field: 'timeZone', operator: Operator.equals, ...timeZone } as Condition;\n const { field: _field, operator: _operator, ...source } = bindRule(carrier, bindings) as Row;\n return source as TimeZoneConfig;\n};\n\n/**\n * Set query as a json-rules Prisma plan: every record currently eligible for `action` (the union\n * of all its paths' `from` predicates; a single path compiles to its predicate alone; an empty\n * action matches nothing). Takes the json-rules `check()` options plus toPrisma's schema:\n * `bindings` are resolved into the predicate and a `{ bind }` timeZone before compiling, `now`\n * reaches `toPrisma`, and `map` / `mapName` / `model` (or `lens`) let it compile a column\n * compared with a column or a count. Run it with json-rules' `executePrismaPlan(plan, prisma)`,\n * which resolves the plan's references, and the `where` selects the rows the single check\n * accepts. A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude, a column\n * ref without the schema) throws.\n */\nexport const eligible = (\n rules: TransitionMap,\n resource: string,\n action: string,\n options: EligibleOptions = {},\n): ToPrismaResult => {\n const found = getAction(rules, resource, action);\n const { bindings = {}, timeZone, ...compile } = options;\n const predicate = bindRule({ any: found.paths.map((path) => path.from.predicate) }, bindings);\n return toPrisma(predicate, { ...compile, timeZone: bindTimeZone(timeZone, bindings) });\n};\n","import { isSerializableMerge } from './merge';\nimport type { Transition } from './types';\n\n/**\n * Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?\n *\n * Predicates (json-rules) and permissions (ActionRule) are always plain JSON; the only\n * non-data escape hatch is a `to.merge` callback. So serializability reduces to the merge.\n */\nexport const isSerializable = (transition: Transition): boolean =>\n isSerializableMerge(transition.to.merge);\n","import {\n type Condition,\n type Lens,\n type LensNarrowing,\n type ValidationIssue,\n type ValidationResult,\n validateRule,\n validateRuleInLens,\n} from '@inixiative/json-rules';\nimport { actionRuleSchema } from '@inixiative/permissions/actionRuleSchema';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type { ValidationIssue, ValidationResult };\n\nexport type ValidateOptions = {\n /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */\n lens?: Lens | LensNarrowing;\n /** Reject callback merges (use when the transition must be persistable / tenant-configured). */\n requireSerializable?: boolean;\n};\n\nconst MERGE_KEYWORDS = new Set(['spread', 'deepMerge']);\nconst ARRAY_KINDS = new Set(['append', 'appendUnique']);\n\nconst validatePredicate = (\n predicate: Condition | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required', code: 'missing_predicate' });\n return;\n }\n const issues = [\n ...validateRule(predicate).errors,\n ...(lens ? validateRuleInLens(predicate, lens).errors : []),\n ];\n for (const issue of issues) errors.push({ ...issue, path: `${path}.${issue.path}` });\n};\n\n// Validate the whole ActionRule against `@inixiative/permissions`' zod schema — the single source of\n// truth for the algebra (boolean terminals, string delegation, `{ rel, action }`, `{ self }`, abac\n// `{ rule }`, `any`/`all`, `null`). A malformed rule yields a structured issue rather than throwing.\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return; // absent = open\n const parsed = actionRuleSchema.safeParse(rule);\n if (parsed.success) return;\n for (const issue of parsed.error.issues) {\n // A root union failure (zod reports an empty relative path) means none of the ActionRule shapes\n // matched; nested issues keep their zod path + message.\n if (issue.path.length === 0) {\n errors.push({ path, message: 'unrecognized ActionRule shape', code: 'invalid_permission' });\n } else {\n errors.push({\n path: `${path}.${issue.path.join('.')}`,\n message: issue.message,\n code: 'invalid_permission',\n });\n }\n }\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"`, code: 'invalid_merge' });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"`, code: 'invalid_merge' });\n else if (!merge.path)\n errors.push({\n path,\n message: `merge \"${merge.kind}\" requires a \\`path\\``,\n code: 'invalid_merge',\n });\n};\n\nconst validateSide = (\n side: Side | ToSide | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required`, code: 'missing_side' });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n code: 'invalid_requires',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n code: 'unserializable_merge',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
1
+ {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/engineGlobals.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","evaluation","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","registerEngineGlobals","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","bindTimeZone","timeZone","bindings","carrier","Operator","_field","_operator","bindRule","eligible","compile","predicate","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","errors","lens","issues","validateRule","validateRuleInLens","issue","validatePermission","validateActionRule","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type SchemaMap,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /** Which model each resource is, and its relations: where a `{ rel }` walk leads. */\n map: SchemaMap<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getActor: () => actor ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, `rel` walks through the schema map, cross-map bridge walks, abac `{ rule }`\n * reading the actor as `__actor`, boolean terminals, `any`/`all`, per-row `permissionRules`\n * overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const check = createRebacCheck<R>(options.map);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n PathReason,\n Row,\n SideReason,\n Transition,\n TransitionOptions,\n} from './types';\n\nconst predicateReason = (result: boolean | string): string =>\n typeof result === 'string' ? result : 'predicate not satisfied';\n\n/**\n * Does this permission DENY?\n * - no authorizer injected → can't deny (legality-only mode)\n * - `undefined` rule → permission absent → open → can't deny\n * - any other rule (incl. `null` = terminal deny) → delegate to the authorizer\n */\nconst denies = (\n authorize: Authorize | undefined,\n rule: ActionRule | undefined,\n record: Row,\n actor: Actor,\n): boolean => {\n if (!authorize || rule === undefined) return false;\n return !authorize(rule, record, actor);\n};\n\n/**\n * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —\n * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole\n * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns\n * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;\n * json-rules' `check()` options (`now`, `bindings`, …) reach both predicates.\n */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: TransitionOptions = {},\n): true | PathReason => {\n const { actor, authorize, ...evaluation } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const from: SideReason = {};\n const fromPredicate = checkRule(transition.from.predicate, record as Row, evaluation);\n if (fromPredicate !== true) from.predicate = predicateReason(fromPredicate);\n if (denies(authorize, transition.from.permission, record as Row, actor))\n from.permission = 'not authorized';\n\n const to: SideReason = {};\n const toPredicate = checkRule(transition.to.predicate, next as Row, evaluation);\n if (toPredicate !== true) to.predicate = predicateReason(toPredicate);\n if (denies(authorize, transition.to.permission, next as Row, actor))\n to.permission = 'not authorized';\n\n const reason: PathReason = {};\n if (from.predicate || from.permission) reason.from = from;\n if (to.predicate || to.permission) reason.to = to;\n return reason.from || reason.to ? reason : true;\n};\n","import type { PathReason, Reason } from './types';\n\nconst describePath = (path: PathReason): string => {\n const segs: string[] = [];\n if (path.from?.predicate) segs.push(`from: ${path.from.predicate}`);\n if (path.from?.permission) segs.push(`from: ${path.from.permission}`);\n if (path.to?.predicate) segs.push(`to: ${path.to.predicate}`);\n if (path.to?.permission) segs.push(`to: ${path.to.permission}`);\n return segs.join('; ') || 'unknown';\n};\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n if (reason.paths.length === 0) return 'no transition path available';\n if (reason.paths.length === 1) return describePath(reason.paths[0]);\n return reason.paths.map((path, i) => `path ${i}: ${describePath(path)}`).join(' | ');\n};\n","import { registerEngineGlobals } from '@inixiative/json-rules';\n\n// transitions' namespace in the one engine interaction point (json-rules' `engineGlobals`). Every\n// option transitions takes is per call today, so it holds no path yet.\nregisterEngineGlobals('transitions', {});\n","import {\n bindRule,\n type Condition,\n check as checkRule,\n Operator,\n type RuleValue,\n type TimeZoneConfig,\n type ToPrismaResult,\n toPrisma,\n} from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n CheckResult,\n EligibleOptions,\n PathReason,\n Row,\n TransitionMap,\n TransitionOptions,\n} from './types';\n\nconst getAction = (rules: TransitionMap, resource: string, action: string): Action => {\n const found = rules[resource]?.[action];\n if (!found)\n throw new Error(`transition: no action \"${action}\" registered on resource \"${resource}\"`);\n return found;\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches\n * the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a\n * {@link Reason} with one {@link PathReason} per candidate path tried.\n *\n * `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`\n * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound\n * to this resource); a `predicate` that reads a bridged relation expects a stitched record.\n */\nexport const checkTransition = (\n rules: TransitionMap,\n resource: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: TransitionOptions = {},\n): CheckResult => {\n const found = getAction(rules, resource, action);\n const paths: PathReason[] = [];\n for (const path of found.paths) {\n const result = checkPath(path, record, changes, options);\n if (result === true) return true;\n paths.push(result);\n }\n return { paths };\n};\n\n/**\n * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`\n * side (predicate + `from` permission against the current record) — `to` needs the merged record,\n * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.\n */\nexport const available = (\n rules: TransitionMap,\n resource: string,\n record: Row,\n options: TransitionOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize, ...evaluation } = options;\n\n const allows = (rule: ActionRule | undefined, rec: Row): boolean =>\n !authorize || rule === undefined || authorize(rule, rec, actor);\n\n return Object.entries(actions)\n .filter(([, action]) =>\n action.paths.some(\n (path) =>\n checkRule(path.from.predicate, record, evaluation) === true &&\n allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n// A `{ bind }` zone, resolved the way the rule's own tokens are: json-rules' bindRule over a\n// carrier leaf. An uncovered token stays a token, and toPrisma reports it unresolved.\nconst bindTimeZone = (\n timeZone: TimeZoneConfig | undefined,\n bindings: Record<string, RuleValue>,\n): TimeZoneConfig | undefined => {\n if (timeZone === undefined || typeof timeZone === 'string') return timeZone;\n const carrier = { field: 'timeZone', operator: Operator.equals, ...timeZone } as Condition;\n const { field: _field, operator: _operator, ...source } = bindRule(carrier, bindings) as Row;\n return source as TimeZoneConfig;\n};\n\n/**\n * Set query as a json-rules Prisma plan: every record currently eligible for `action` (the union\n * of all its paths' `from` predicates; a single path compiles to its predicate alone; an empty\n * action matches nothing). Takes the json-rules `check()` options plus toPrisma's schema:\n * `bindings` are resolved into the predicate and a `{ bind }` timeZone before compiling, `now`\n * reaches `toPrisma`, and `map` / `mapName` / `model` (or `lens`) let it compile a column\n * compared with a column or a count. Run it with json-rules' `executePrismaPlan(plan, prisma)`,\n * which resolves the plan's references, and the `where` selects the rows the single check\n * accepts. A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude, a column\n * ref without the schema) throws.\n */\nexport const eligible = (\n rules: TransitionMap,\n resource: string,\n action: string,\n options: EligibleOptions = {},\n): ToPrismaResult => {\n const found = getAction(rules, resource, action);\n const { bindings = {}, timeZone, ...compile } = options;\n const predicate = bindRule({ any: found.paths.map((path) => path.from.predicate) }, bindings);\n return toPrisma(predicate, { ...compile, timeZone: bindTimeZone(timeZone, bindings) });\n};\n","import { isSerializableMerge } from './merge';\nimport type { Transition } from './types';\n\n/**\n * Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?\n *\n * Predicates (json-rules) and permissions (ActionRule) are always plain JSON; the only\n * non-data escape hatch is a `to.merge` callback. So serializability reduces to the merge.\n */\nexport const isSerializable = (transition: Transition): boolean =>\n isSerializableMerge(transition.to.merge);\n","import {\n type Condition,\n type Lens,\n type LensNarrowing,\n type ValidationIssue,\n type ValidationResult,\n validateRule,\n validateRuleInLens,\n} from '@inixiative/json-rules';\nimport { validateActionRule } from '@inixiative/permissions';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type { ValidationIssue, ValidationResult };\n\nexport type ValidateOptions = {\n /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */\n lens?: Lens | LensNarrowing;\n /** Reject callback merges (use when the transition must be persistable / tenant-configured). */\n requireSerializable?: boolean;\n};\n\nconst MERGE_KEYWORDS = new Set(['spread', 'deepMerge']);\nconst ARRAY_KINDS = new Set(['append', 'appendUnique']);\n\nconst validatePredicate = (\n predicate: Condition | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required', code: 'missing_predicate' });\n return;\n }\n const issues = [\n ...validateRule(predicate).errors,\n ...(lens ? validateRuleInLens(predicate, lens).errors : []),\n ];\n for (const issue of issues) errors.push({ ...issue, path: `${path}.${issue.path}` });\n};\n\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return;\n for (const issue of validateActionRule(rule).errors)\n errors.push({ ...issue, path: `${path}${issue.path.slice(1)}`, code: 'invalid_permission' });\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"`, code: 'invalid_merge' });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"`, code: 'invalid_merge' });\n else if (!merge.path)\n errors.push({\n path,\n message: `merge \"${merge.kind}\" requires a \\`path\\``,\n code: 'invalid_merge',\n });\n};\n\nconst validateSide = (\n side: Side | ToSide | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required`, code: 'missing_side' });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n code: 'invalid_requires',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `validateActionRule`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n code: 'unserializable_merge',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
package/dist/index.d.cts CHANGED
@@ -1,11 +1,9 @@
1
- import { ActionRule, RebacSchema, ResolveRelation, Subject } from '@inixiative/permissions';
1
+ import { ActionRule, Actor as Actor$1, RebacSchema, SchemaMap, Subject } from '@inixiative/permissions';
2
2
  export { ActionRule } from '@inixiative/permissions';
3
3
  import { Row, Condition, CheckOptions, ToPrismaOptions, ToPrismaResult, Lens, LensNarrowing, ValidationResult } from '@inixiative/json-rules';
4
4
  export { Row, ValidationIssue, ValidationResult } from '@inixiative/json-rules';
5
5
 
6
- type Actor = ({
7
- id?: string | null;
8
- } & Row) | null | undefined;
6
+ type Actor = Actor$1 | null | undefined;
9
7
  /**
10
8
  * Injected permission evaluator. Resource-free: the kernel knows nothing about resources or schemas,
11
9
  * so the consumer closes over whatever its rebac needs (see {@link createAuthorize}, the adapter
@@ -93,12 +91,8 @@ type EligibleOptions = PredicateOptions & ToPrismaOptions;
93
91
  type PermissionsAuthorizeOptions<R extends string = string> = {
94
92
  /** The permissions rebac schema: `{ bridges?, permissions }`. */
95
93
  schema: RebacSchema<R>;
96
- /**
97
- * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).
98
- * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved
99
- * by the engine from `schema.bridges`, not here.
100
- */
101
- resolveRelation?: ResolveRelation<R>;
94
+ /** Which model each resource is, and its relations: where a `{ rel }` walk leads. */
95
+ map: SchemaMap<R>;
102
96
  /** Superadmin bypass, derived from the actor; checked before any rule. */
103
97
  isSuperadmin?: (actor: Actor) => boolean;
104
98
  /**
@@ -113,8 +107,9 @@ type PermissionsAuthorizeOptions<R extends string = string> = {
113
107
  * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an
114
108
  * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`
115
109
  * rule against a concrete record + actor. permissions owns the evaluation (string delegation with
116
- * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,
117
- * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).
110
+ * cycle detection, `rel` walks through the schema map, cross-map bridge walks, abac `{ rule }`
111
+ * reading the actor as `__actor`, boolean terminals, `any`/`all`, per-row `permissionRules`
112
+ * overrides).
118
113
  */
119
114
  declare const createAuthorize: <R extends string = string>(options: PermissionsAuthorizeOptions<R>) => ((resource: R) => Authorize);
120
115
 
@@ -190,7 +185,7 @@ type ValidateOptions = {
190
185
  * Authoring validation for a single transition — run on save before persisting a tenant config.
191
186
  * Returns structured issues (never throws) on malformed input: predicate validity delegates to
192
187
  * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for
193
- * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;
188
+ * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `validateActionRule`;
194
189
  * merge strategy is checked here.
195
190
  */
196
191
  declare const validateTransition: (transition: Transition, options?: ValidateOptions) => ValidationResult;
package/dist/index.d.ts CHANGED
@@ -1,11 +1,9 @@
1
- import { ActionRule, RebacSchema, ResolveRelation, Subject } from '@inixiative/permissions';
1
+ import { ActionRule, Actor as Actor$1, RebacSchema, SchemaMap, Subject } from '@inixiative/permissions';
2
2
  export { ActionRule } from '@inixiative/permissions';
3
3
  import { Row, Condition, CheckOptions, ToPrismaOptions, ToPrismaResult, Lens, LensNarrowing, ValidationResult } from '@inixiative/json-rules';
4
4
  export { Row, ValidationIssue, ValidationResult } from '@inixiative/json-rules';
5
5
 
6
- type Actor = ({
7
- id?: string | null;
8
- } & Row) | null | undefined;
6
+ type Actor = Actor$1 | null | undefined;
9
7
  /**
10
8
  * Injected permission evaluator. Resource-free: the kernel knows nothing about resources or schemas,
11
9
  * so the consumer closes over whatever its rebac needs (see {@link createAuthorize}, the adapter
@@ -93,12 +91,8 @@ type EligibleOptions = PredicateOptions & ToPrismaOptions;
93
91
  type PermissionsAuthorizeOptions<R extends string = string> = {
94
92
  /** The permissions rebac schema: `{ bridges?, permissions }`. */
95
93
  schema: RebacSchema<R>;
96
- /**
97
- * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).
98
- * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved
99
- * by the engine from `schema.bridges`, not here.
100
- */
101
- resolveRelation?: ResolveRelation<R>;
94
+ /** Which model each resource is, and its relations: where a `{ rel }` walk leads. */
95
+ map: SchemaMap<R>;
102
96
  /** Superadmin bypass, derived from the actor; checked before any rule. */
103
97
  isSuperadmin?: (actor: Actor) => boolean;
104
98
  /**
@@ -113,8 +107,9 @@ type PermissionsAuthorizeOptions<R extends string = string> = {
113
107
  * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an
114
108
  * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`
115
109
  * rule against a concrete record + actor. permissions owns the evaluation (string delegation with
116
- * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,
117
- * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).
110
+ * cycle detection, `rel` walks through the schema map, cross-map bridge walks, abac `{ rule }`
111
+ * reading the actor as `__actor`, boolean terminals, `any`/`all`, per-row `permissionRules`
112
+ * overrides).
118
113
  */
119
114
  declare const createAuthorize: <R extends string = string>(options: PermissionsAuthorizeOptions<R>) => ((resource: R) => Authorize);
120
115
 
@@ -190,7 +185,7 @@ type ValidateOptions = {
190
185
  * Authoring validation for a single transition — run on save before persisting a tenant config.
191
186
  * Returns structured issues (never throws) on malformed input: predicate validity delegates to
192
187
  * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for
193
- * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;
188
+ * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `validateActionRule`;
194
189
  * merge strategy is checked here.
195
190
  */
196
191
  declare const validateTransition: (transition: Transition, options?: ValidateOptions) => ValidationResult;
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- import {createRebacCheck}from'@inixiative/permissions';import {check,bindRule,toPrisma,Operator,validateRule,validateRuleInLens}from'@inixiative/json-rules';import {mergeWith,cloneDeep,get,set,uniqWith,isEqual}from'lodash-es';import {actionRuleSchema}from'@inixiative/permissions/actionRuleSchema';var v=/Cycle detected/,M=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getUserId:()=>e?.id??null}),G=e=>{let t=e.resolveRelation??((o,n)=>n),i=createRebacCheck(t);return o=>(n,r,a)=>{let p=M(a,e.isSuperadmin),c={resource:o,record:r,data:e.data?.(r,a)};try{return i(p,e.schema,c,n)}catch(s){if(s instanceof Error&&v.test(s.message))return false;throw s}}};var g=e=>Array.isArray(e)?e:e===void 0?[]:[e],V=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,i={})=>{if(typeof e=="function")return e(t,i);let o=e??"spread";if(o==="spread")return {...t,...i};if(o==="deepMerge")return mergeWith(cloneDeep(t),cloneDeep(i),V);let{kind:n,path:r}=o,a=cloneDeep({...t,...i}),p=[...g(get(t,r)),...g(get(i,r))];return set(a,r,n==="appendUnique"?uniqWith(p,isEqual):p),a};var b=e=>typeof e=="string"?e:"predicate not satisfied",w=(e,t,i,o)=>!e||t===void 0?false:!e(t,i,o),A=(e,t,i={},o={})=>{let{actor:n,authorize:r,...a}=o,p=h(e.to.merge,t,i),c={},s=check(e.from.predicate,t,a);s!==true&&(c.predicate=b(s)),w(r,e.from.permission,t,n)&&(c.permission="not authorized");let u={},m=check(e.to.predicate,p,a);m!==true&&(u.predicate=b(m)),w(r,e.to.permission,p,n)&&(u.permission="not authorized");let d={};return (c.predicate||c.permission)&&(d.from=c),(u.predicate||u.permission)&&(d.to=u),d.from||d.to?d:true};var k=e=>{let t=[];return e.from?.predicate&&t.push(`from: ${e.from.predicate}`),e.from?.permission&&t.push(`from: ${e.from.permission}`),e.to?.predicate&&t.push(`to: ${e.to.predicate}`),e.to?.permission&&t.push(`to: ${e.to.permission}`),t.join("; ")||"unknown"},ee=e=>e.paths.length===0?"no transition path available":e.paths.length===1?k(e.paths[0]):e.paths.map((t,i)=>`path ${i}: ${k(t)}`).join(" | ");var S=(e,t,i)=>{let o=e[t]?.[i];if(!o)throw new Error(`transition: no action "${i}" registered on resource "${t}"`);return o},ne=(e,t,i,o,n={},r={})=>{let a=S(e,t,i),p=[];for(let c of a.paths){let s=A(c,o,n,r);if(s===true)return true;p.push(s);}return {paths:p}},re=(e,t,i,o={})=>{let n=e[t];if(!n)return [];let{actor:r,authorize:a,...p}=o,c=(s,u)=>!a||s===void 0||a(s,u,r);return Object.entries(n).filter(([,s])=>s.paths.some(u=>check(u.from.predicate,i,p)===true&&c(u.from.permission,i))).map(([s])=>s)},I=(e,t)=>{if(e===void 0||typeof e=="string")return e;let i={field:"timeZone",operator:Operator.equals,...e},{field:o,operator:n,...r}=bindRule(i,t);return r},se=(e,t,i,o={})=>{let n=S(e,t,i),{bindings:r={},timeZone:a,...p}=o,c=bindRule({any:n.paths.map(s=>s.from.predicate)},r);return toPrisma(c,{...p,timeZone:I(a,r)})};var ce=e=>f(e.to.merge);var N=new Set(["spread","deepMerge"]),D=new Set(["append","appendUnique"]),U=(e,t,i,o)=>{if(e===void 0){t.push({path:i,message:"predicate is required",code:"missing_predicate"});return}let n=[...validateRule(e).errors,...o?validateRuleInLens(e,o).errors:[]];for(let r of n)t.push({...r,path:`${i}.${r.path}`});},W=(e,t,i)=>{if(e===void 0)return;let o=actionRuleSchema.safeParse(e);if(!o.success)for(let n of o.error.issues)n.path.length===0?t.push({path:i,message:"unrecognized ActionRule shape",code:"invalid_permission"}):t.push({path:`${i}.${n.path.join(".")}`,message:n.message,code:"invalid_permission"});},Y=(e,t,i)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){N.has(e)||t.push({path:i,message:`unknown merge strategy "${e}"`,code:"invalid_merge"});return}D.has(e.kind)?e.path||t.push({path:i,message:`merge "${e.kind}" requires a \`path\``,code:"invalid_merge"}):t.push({path:i,message:`unknown merge kind "${e.kind}"`,code:"invalid_merge"});}},T=(e,t,i,o)=>{if(e===null||typeof e!="object"){t.push({path:i,message:`\`${i}\` side is required`,code:"missing_side"});return}U(e.predicate,t,`${i}.predicate`,o.lens),W(e.permission,t,`${i}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${i}.requires`,message:"`requires` must be a Prisma-include-shaped object",code:"invalid_requires"}),"merge"in e&&Y(e.merge,t,`${i}.merge`);},me=(e,t={})=>{let i=[];return T(e?.from,i,"from",t),T(e?.to,i,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&i.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy",code:"unserializable_merge"}),{ok:i.length===0,errors:i}};export{h as applyMerge,re as available,A as checkPath,ne as checkTransition,G as createAuthorize,ee as describe,se as eligible,ce as isSerializable,f as isSerializableMerge,me as validateTransition};//# sourceMappingURL=index.js.map
1
+ import {createRebacCheck,validateActionRule}from'@inixiative/permissions';import {registerEngineGlobals,check,bindRule,toPrisma,Operator,validateRule,validateRuleInLens}from'@inixiative/json-rules';import {mergeWith,cloneDeep,get,set,uniqWith,isEqual}from'lodash-es';var M=/Cycle detected/,$=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getActor:()=>e??null}),B=e=>{let t=createRebacCheck(e.map);return i=>(o,r,n)=>{let a=$(n,e.isSuperadmin),p={resource:i,record:r,data:e.data?.(r,n)};try{return t(a,e.schema,p,o)}catch(s){if(s instanceof Error&&M.test(s.message))return false;throw s}}};var g=e=>Array.isArray(e)?e:e===void 0?[]:[e],V=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,i={})=>{if(typeof e=="function")return e(t,i);let o=e??"spread";if(o==="spread")return {...t,...i};if(o==="deepMerge")return mergeWith(cloneDeep(t),cloneDeep(i),V);let{kind:r,path:n}=o,a=cloneDeep({...t,...i}),p=[...g(get(t,n)),...g(get(i,n))];return set(a,n,r==="appendUnique"?uniqWith(p,isEqual):p),a};var b=e=>typeof e=="string"?e:"predicate not satisfied",w=(e,t,i,o)=>!e||t===void 0?false:!e(t,i,o),A=(e,t,i={},o={})=>{let{actor:r,authorize:n,...a}=o,p=h(e.to.merge,t,i),s={},c=check(e.from.predicate,t,a);c!==true&&(s.predicate=b(c)),w(n,e.from.permission,t,r)&&(s.permission="not authorized");let u={},l=check(e.to.predicate,p,a);l!==true&&(u.predicate=b(l)),w(n,e.to.permission,p,r)&&(u.permission="not authorized");let d={};return (s.predicate||s.permission)&&(d.from=s),(u.predicate||u.permission)&&(d.to=u),d.from||d.to?d:true};var k=e=>{let t=[];return e.from?.predicate&&t.push(`from: ${e.from.predicate}`),e.from?.permission&&t.push(`from: ${e.from.permission}`),e.to?.predicate&&t.push(`to: ${e.to.predicate}`),e.to?.permission&&t.push(`to: ${e.to.permission}`),t.join("; ")||"unknown"},te=e=>e.paths.length===0?"no transition path available":e.paths.length===1?k(e.paths[0]):e.paths.map((t,i)=>`path ${i}: ${k(t)}`).join(" | ");registerEngineGlobals("transitions",{});var S=(e,t,i)=>{let o=e[t]?.[i];if(!o)throw new Error(`transition: no action "${i}" registered on resource "${t}"`);return o},se=(e,t,i,o,r={},n={})=>{let a=S(e,t,i),p=[];for(let s of a.paths){let c=A(s,o,r,n);if(c===true)return true;p.push(c);}return {paths:p}},ae=(e,t,i,o={})=>{let r=e[t];if(!r)return [];let{actor:n,authorize:a,...p}=o,s=(c,u)=>!a||c===void 0||a(c,u,n);return Object.entries(r).filter(([,c])=>c.paths.some(u=>check(u.from.predicate,i,p)===true&&s(u.from.permission,i))).map(([c])=>c)},L=(e,t)=>{if(e===void 0||typeof e=="string")return e;let i={field:"timeZone",operator:Operator.equals,...e},{field:o,operator:r,...n}=bindRule(i,t);return n},pe=(e,t,i,o={})=>{let r=S(e,t,i),{bindings:n={},timeZone:a,...p}=o,s=bindRule({any:r.paths.map(c=>c.from.predicate)},n);return toPrisma(s,{...p,timeZone:L(a,n)})};var de=e=>f(e.to.merge);var D=new Set(["spread","deepMerge"]),W=new Set(["append","appendUnique"]),Y=(e,t,i,o)=>{if(e===void 0){t.push({path:i,message:"predicate is required",code:"missing_predicate"});return}let r=[...validateRule(e).errors,...o?validateRuleInLens(e,o).errors:[]];for(let n of r)t.push({...n,path:`${i}.${n.path}`});},G=(e,t,i)=>{if(e!==void 0)for(let o of validateActionRule(e).errors)t.push({...o,path:`${i}${o.path.slice(1)}`,code:"invalid_permission"});},K=(e,t,i)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){D.has(e)||t.push({path:i,message:`unknown merge strategy "${e}"`,code:"invalid_merge"});return}W.has(e.kind)?e.path||t.push({path:i,message:`merge "${e.kind}" requires a \`path\``,code:"invalid_merge"}):t.push({path:i,message:`unknown merge kind "${e.kind}"`,code:"invalid_merge"});}},T=(e,t,i,o)=>{if(e===null||typeof e!="object"){t.push({path:i,message:`\`${i}\` side is required`,code:"missing_side"});return}Y(e.predicate,t,`${i}.predicate`,o.lens),G(e.permission,t,`${i}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${i}.requires`,message:"`requires` must be a Prisma-include-shaped object",code:"invalid_requires"}),"merge"in e&&K(e.merge,t,`${i}.merge`);},ge=(e,t={})=>{let i=[];return T(e?.from,i,"from",t),T(e?.to,i,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&i.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy",code:"unserializable_merge"}),{ok:i.length===0,errors:i}};export{h as applyMerge,ae as available,A as checkPath,se as checkTransition,B as createAuthorize,te as describe,pe as eligible,de as isSerializable,f as isSerializableMerge,ge as validateTransition};//# sourceMappingURL=index.js.map
2
2
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","resolveRelation","_resource","segment","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","evaluation","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","bindTimeZone","timeZone","bindings","carrier","Operator","_field","_operator","bindRule","eligible","compile","predicate","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","errors","lens","issues","validateRule","validateRuleInLens","issue","validatePermission","parsed","actionRuleSchema","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.js","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type ResolveRelation,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\n// permissions surfaces a cyclic permission graph by throwing; the transitions guard denies (fail\n// closed) so a misconfigured schema terminates cleanly instead of propagating out of the kernel.\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /**\n * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).\n * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved\n * by the engine from `schema.bridges`, not here.\n */\n resolveRelation?: ResolveRelation<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\n// The transitions seam carries no pre-granted (role-derived) permix state, so a direct permix grant\n// always misses and authorization is decided entirely by the schema. The actor supplies only its id\n// (for `{ self }`) and an optional superadmin bypass.\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getUserId: () => actor?.id ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,\n * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const resolveRelation: ResolveRelation<R> =\n options.resolveRelation ?? ((_resource, segment) => segment as R);\n const check = createRebacCheck<R>(resolveRelation);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n PathReason,\n Row,\n SideReason,\n Transition,\n TransitionOptions,\n} from './types';\n\nconst predicateReason = (result: boolean | string): string =>\n typeof result === 'string' ? result : 'predicate not satisfied';\n\n/**\n * Does this permission DENY?\n * - no authorizer injected → can't deny (legality-only mode)\n * - `undefined` rule → permission absent → open → can't deny\n * - any other rule (incl. `null` = terminal deny) → delegate to the authorizer\n */\nconst denies = (\n authorize: Authorize | undefined,\n rule: ActionRule | undefined,\n record: Row,\n actor: Actor,\n): boolean => {\n if (!authorize || rule === undefined) return false;\n return !authorize(rule, record, actor);\n};\n\n/**\n * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —\n * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole\n * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns\n * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;\n * json-rules' `check()` options (`now`, `bindings`, …) reach both predicates.\n */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: TransitionOptions = {},\n): true | PathReason => {\n const { actor, authorize, ...evaluation } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const from: SideReason = {};\n const fromPredicate = checkRule(transition.from.predicate, record as Row, evaluation);\n if (fromPredicate !== true) from.predicate = predicateReason(fromPredicate);\n if (denies(authorize, transition.from.permission, record as Row, actor))\n from.permission = 'not authorized';\n\n const to: SideReason = {};\n const toPredicate = checkRule(transition.to.predicate, next as Row, evaluation);\n if (toPredicate !== true) to.predicate = predicateReason(toPredicate);\n if (denies(authorize, transition.to.permission, next as Row, actor))\n to.permission = 'not authorized';\n\n const reason: PathReason = {};\n if (from.predicate || from.permission) reason.from = from;\n if (to.predicate || to.permission) reason.to = to;\n return reason.from || reason.to ? reason : true;\n};\n","import type { PathReason, Reason } from './types';\n\nconst describePath = (path: PathReason): string => {\n const segs: string[] = [];\n if (path.from?.predicate) segs.push(`from: ${path.from.predicate}`);\n if (path.from?.permission) segs.push(`from: ${path.from.permission}`);\n if (path.to?.predicate) segs.push(`to: ${path.to.predicate}`);\n if (path.to?.permission) segs.push(`to: ${path.to.permission}`);\n return segs.join('; ') || 'unknown';\n};\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n if (reason.paths.length === 0) return 'no transition path available';\n if (reason.paths.length === 1) return describePath(reason.paths[0]);\n return reason.paths.map((path, i) => `path ${i}: ${describePath(path)}`).join(' | ');\n};\n","import {\n bindRule,\n type Condition,\n check as checkRule,\n Operator,\n type RuleValue,\n type TimeZoneConfig,\n type ToPrismaResult,\n toPrisma,\n} from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n CheckResult,\n EligibleOptions,\n PathReason,\n Row,\n TransitionMap,\n TransitionOptions,\n} from './types';\n\nconst getAction = (rules: TransitionMap, resource: string, action: string): Action => {\n const found = rules[resource]?.[action];\n if (!found)\n throw new Error(`transition: no action \"${action}\" registered on resource \"${resource}\"`);\n return found;\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches\n * the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a\n * {@link Reason} with one {@link PathReason} per candidate path tried.\n *\n * `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`\n * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound\n * to this resource); a `predicate` that reads a bridged relation expects a stitched record.\n */\nexport const checkTransition = (\n rules: TransitionMap,\n resource: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: TransitionOptions = {},\n): CheckResult => {\n const found = getAction(rules, resource, action);\n const paths: PathReason[] = [];\n for (const path of found.paths) {\n const result = checkPath(path, record, changes, options);\n if (result === true) return true;\n paths.push(result);\n }\n return { paths };\n};\n\n/**\n * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`\n * side (predicate + `from` permission against the current record) — `to` needs the merged record,\n * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.\n */\nexport const available = (\n rules: TransitionMap,\n resource: string,\n record: Row,\n options: TransitionOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize, ...evaluation } = options;\n\n const allows = (rule: ActionRule | undefined, rec: Row): boolean =>\n !authorize || rule === undefined || authorize(rule, rec, actor);\n\n return Object.entries(actions)\n .filter(([, action]) =>\n action.paths.some(\n (path) =>\n checkRule(path.from.predicate, record, evaluation) === true &&\n allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n// A `{ bind }` zone, resolved the way the rule's own tokens are: json-rules' bindRule over a\n// carrier leaf. An uncovered token stays a token, and toPrisma reports it unresolved.\nconst bindTimeZone = (\n timeZone: TimeZoneConfig | undefined,\n bindings: Record<string, RuleValue>,\n): TimeZoneConfig | undefined => {\n if (timeZone === undefined || typeof timeZone === 'string') return timeZone;\n const carrier = { field: 'timeZone', operator: Operator.equals, ...timeZone } as Condition;\n const { field: _field, operator: _operator, ...source } = bindRule(carrier, bindings) as Row;\n return source as TimeZoneConfig;\n};\n\n/**\n * Set query as a json-rules Prisma plan: every record currently eligible for `action` (the union\n * of all its paths' `from` predicates; a single path compiles to its predicate alone; an empty\n * action matches nothing). Takes the json-rules `check()` options plus toPrisma's schema:\n * `bindings` are resolved into the predicate and a `{ bind }` timeZone before compiling, `now`\n * reaches `toPrisma`, and `map` / `mapName` / `model` (or `lens`) let it compile a column\n * compared with a column or a count. Run it with json-rules' `executePrismaPlan(plan, prisma)`,\n * which resolves the plan's references, and the `where` selects the rows the single check\n * accepts. A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude, a column\n * ref without the schema) throws.\n */\nexport const eligible = (\n rules: TransitionMap,\n resource: string,\n action: string,\n options: EligibleOptions = {},\n): ToPrismaResult => {\n const found = getAction(rules, resource, action);\n const { bindings = {}, timeZone, ...compile } = options;\n const predicate = bindRule({ any: found.paths.map((path) => path.from.predicate) }, bindings);\n return toPrisma(predicate, { ...compile, timeZone: bindTimeZone(timeZone, bindings) });\n};\n","import { isSerializableMerge } from './merge';\nimport type { Transition } from './types';\n\n/**\n * Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?\n *\n * Predicates (json-rules) and permissions (ActionRule) are always plain JSON; the only\n * non-data escape hatch is a `to.merge` callback. So serializability reduces to the merge.\n */\nexport const isSerializable = (transition: Transition): boolean =>\n isSerializableMerge(transition.to.merge);\n","import {\n type Condition,\n type Lens,\n type LensNarrowing,\n type ValidationIssue,\n type ValidationResult,\n validateRule,\n validateRuleInLens,\n} from '@inixiative/json-rules';\nimport { actionRuleSchema } from '@inixiative/permissions/actionRuleSchema';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type { ValidationIssue, ValidationResult };\n\nexport type ValidateOptions = {\n /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */\n lens?: Lens | LensNarrowing;\n /** Reject callback merges (use when the transition must be persistable / tenant-configured). */\n requireSerializable?: boolean;\n};\n\nconst MERGE_KEYWORDS = new Set(['spread', 'deepMerge']);\nconst ARRAY_KINDS = new Set(['append', 'appendUnique']);\n\nconst validatePredicate = (\n predicate: Condition | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required', code: 'missing_predicate' });\n return;\n }\n const issues = [\n ...validateRule(predicate).errors,\n ...(lens ? validateRuleInLens(predicate, lens).errors : []),\n ];\n for (const issue of issues) errors.push({ ...issue, path: `${path}.${issue.path}` });\n};\n\n// Validate the whole ActionRule against `@inixiative/permissions`' zod schema — the single source of\n// truth for the algebra (boolean terminals, string delegation, `{ rel, action }`, `{ self }`, abac\n// `{ rule }`, `any`/`all`, `null`). A malformed rule yields a structured issue rather than throwing.\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return; // absent = open\n const parsed = actionRuleSchema.safeParse(rule);\n if (parsed.success) return;\n for (const issue of parsed.error.issues) {\n // A root union failure (zod reports an empty relative path) means none of the ActionRule shapes\n // matched; nested issues keep their zod path + message.\n if (issue.path.length === 0) {\n errors.push({ path, message: 'unrecognized ActionRule shape', code: 'invalid_permission' });\n } else {\n errors.push({\n path: `${path}.${issue.path.join('.')}`,\n message: issue.message,\n code: 'invalid_permission',\n });\n }\n }\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"`, code: 'invalid_merge' });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"`, code: 'invalid_merge' });\n else if (!merge.path)\n errors.push({\n path,\n message: `merge \"${merge.kind}\" requires a \\`path\\``,\n code: 'invalid_merge',\n });\n};\n\nconst validateSide = (\n side: Side | ToSide | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required`, code: 'missing_side' });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n code: 'invalid_requires',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n code: 'unserializable_merge',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
1
+ {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/engineGlobals.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","evaluation","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","registerEngineGlobals","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","bindTimeZone","timeZone","bindings","carrier","Operator","_field","_operator","bindRule","eligible","compile","predicate","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","errors","lens","issues","validateRule","validateRuleInLens","issue","validatePermission","validateActionRule","validateMerge","validateSide","side","validateTransition"],"mappings":"2QAUA,IAAMA,CAAAA,CAAQ,gBAAA,CAiBRC,CAAAA,CAAc,CAACC,CAAAA,CAAcC,CAAAA,IAA0D,CAC3F,KAAA,CAAO,IAAM,KAAA,CACb,YAAA,CAAc,IAAMA,CAAAA,GAAeD,CAAK,CAAA,EAAK,KAAA,CAC7C,QAAA,CAAU,IAAMA,CAAAA,EAAS,IAC3B,CAAA,CAAA,CAWaE,CAAAA,CACXC,CAAAA,EACiC,CACjC,IAAMC,CAAAA,CAAQC,gBAAAA,CAAoBF,CAAAA,CAAQ,GAAG,CAAA,CAE7C,OAAQG,CAAAA,EACN,CAACC,CAAAA,CAAMC,CAAAA,CAAQR,CAAAA,GAAU,CACvB,IAAMS,CAAAA,CAASV,CAAAA,CAAYC,CAAAA,CAAOG,EAAQ,YAAY,CAAA,CAChDO,CAAAA,CAAsB,CAAE,QAAA,CAAAJ,CAAAA,CAAU,MAAA,CAAAE,CAAAA,CAAQ,IAAA,CAAML,CAAAA,CAAQ,IAAA,GAAOK,CAAAA,CAAQR,CAAK,CAAE,CAAA,CACpF,GAAI,CACF,OAAOI,CAAAA,CAAMK,CAAAA,CAAQN,CAAAA,CAAQ,MAAA,CAAQO,CAAAA,CAASH,CAAkB,CAClE,CAAA,MAASI,CAAAA,CAAO,CACd,GAAIA,CAAAA,YAAiB,KAAA,EAASb,CAAAA,CAAM,IAAA,CAAKa,CAAAA,CAAM,OAAO,CAAA,CAAG,OAAO,MAAA,CAChE,MAAMA,CACR,CACF,CACJ,ECvDA,IAAMC,CAAAA,CAAWC,CAAAA,EACf,KAAA,CAAM,OAAA,CAAQA,CAAK,CAAA,CAAIA,CAAAA,CAAQA,CAAAA,GAAU,MAAA,CAAY,EAAC,CAAI,CAACA,CAAK,CAAA,CAG5DC,CAAAA,CAAgB,CAACC,CAAAA,CAAkBC,CAAAA,GACvC,KAAA,CAAM,OAAA,CAAQA,CAAM,EAAIA,CAAAA,CAAS,MAAA,CAGtBC,CAAAA,CAAuBC,CAAAA,EAA2B,OAAOA,CAAAA,EAAU,UAAA,CAWnEC,CAAAA,CAAa,CACxBD,CAAAA,CACAV,CAAAA,CACAY,CAAAA,CAAsB,EAAC,GACjB,CACN,GAAI,OAAOF,CAAAA,EAAU,UAAA,CAAY,OAAOA,CAAAA,CAAMV,CAAAA,CAAQY,CAAO,CAAA,CAE7D,IAAMC,CAAAA,CAA0BH,CAAAA,EAAS,QAAA,CAEzC,GAAIG,CAAAA,GAAa,QAAA,CAAU,OAAO,CAAE,GAAGb,CAAAA,CAAQ,GAAGY,CAAQ,CAAA,CAG1D,GAAIC,CAAAA,GAAa,WAAA,CACf,OAAOC,SAAAA,CAAUC,SAAAA,CAAUf,CAAM,CAAA,CAAGe,SAAAA,CAAUH,CAAO,CAAA,CAAGN,CAAa,CAAA,CAGvE,GAAM,CAAE,IAAA,CAAAU,CAAAA,CAAM,IAAA,CAAAC,CAAK,CAAA,CAAIJ,CAAAA,CACjBK,CAAAA,CAAOH,SAAAA,CAAU,CAAE,GAAGf,CAAAA,CAAQ,GAAGY,CAAQ,CAAC,CAAA,CAC1CO,CAAAA,CAAS,CAAC,GAAGf,CAAAA,CAAQgB,GAAAA,CAAIpB,CAAAA,CAAQiB,CAAI,CAAC,CAAA,CAAG,GAAGb,CAAAA,CAAQgB,GAAAA,CAAIR,CAAAA,CAASK,CAAI,CAAC,CAAC,CAAA,CAC7E,OAAAI,GAAAA,CAAIH,CAAAA,CAAaD,CAAAA,CAAMD,CAAAA,GAAS,cAAA,CAAiBM,QAAAA,CAASH,CAAAA,CAAQI,OAAO,CAAA,CAAIJ,CAAM,CAAA,CAC5ED,CACT,EC9BA,IAAMM,EAAmBC,CAAAA,EACvB,OAAOA,CAAAA,EAAW,QAAA,CAAWA,CAAAA,CAAS,yBAAA,CAQlCC,CAAAA,CAAS,CACbC,CAAAA,CACA5B,CAAAA,CACAC,CAAAA,CACAR,CAAAA,GAEI,CAACmC,CAAAA,EAAa5B,CAAAA,GAAS,MAAA,CAAkB,MACtC,CAAC4B,CAAAA,CAAU5B,CAAAA,CAAMC,CAAAA,CAAQR,CAAK,CAAA,CAU1BoC,CAAAA,CAAY,CACvBC,CAAAA,CACA7B,CAAAA,CACAY,CAAAA,CAAsB,EAAC,CACvBjB,CAAAA,CAA6B,EAAC,GACR,CACtB,GAAM,CAAE,KAAA,CAAAH,CAAAA,CAAO,SAAA,CAAAmC,CAAAA,CAAW,GAAGG,CAAW,CAAA,CAAInC,CAAAA,CACtCoC,CAAAA,CAAOpB,CAAAA,CAAWkB,CAAAA,CAAW,EAAA,CAAG,KAAA,CAAO7B,CAAAA,CAAQY,CAAO,CAAA,CAEtDoB,CAAAA,CAAmB,EAAC,CACpBC,CAAAA,CAAgBC,KAAAA,CAAUL,CAAAA,CAAW,IAAA,CAAK,SAAA,CAAW7B,CAAAA,CAAe8B,CAAU,CAAA,CAChFG,CAAAA,GAAkB,IAAA,GAAMD,CAAAA,CAAK,UAAYR,CAAAA,CAAgBS,CAAa,CAAA,CAAA,CACtEP,CAAAA,CAAOC,CAAAA,CAAWE,CAAAA,CAAW,IAAA,CAAK,UAAA,CAAY7B,CAAAA,CAAeR,CAAK,CAAA,GACpEwC,CAAAA,CAAK,UAAA,CAAa,gBAAA,CAAA,CAEpB,IAAMG,CAAAA,CAAiB,EAAC,CAClBC,CAAAA,CAAcF,KAAAA,CAAUL,CAAAA,CAAW,EAAA,CAAG,SAAA,CAAWE,CAAAA,CAAaD,CAAU,CAAA,CAC1EM,CAAAA,GAAgB,IAAA,GAAMD,CAAAA,CAAG,SAAA,CAAYX,CAAAA,CAAgBY,CAAW,CAAA,CAAA,CAChEV,EAAOC,CAAAA,CAAWE,CAAAA,CAAW,EAAA,CAAG,UAAA,CAAYE,CAAAA,CAAavC,CAAK,CAAA,GAChE2C,CAAAA,CAAG,UAAA,CAAa,gBAAA,CAAA,CAElB,IAAME,CAAAA,CAAqB,EAAC,CAC5B,OAAA,CAAIL,CAAAA,CAAK,WAAaA,CAAAA,CAAK,UAAA,IAAYK,CAAAA,CAAO,IAAA,CAAOL,CAAAA,CAAAA,CAAAA,CACjDG,CAAAA,CAAG,SAAA,EAAaA,CAAAA,CAAG,UAAA,IAAYE,CAAAA,CAAO,EAAA,CAAKF,CAAAA,CAAAA,CACxCE,CAAAA,CAAO,IAAA,EAAQA,CAAAA,CAAO,EAAA,CAAKA,EAAS,IAC7C,EC9DA,IAAMC,CAAAA,CAAgBrB,CAAAA,EAA6B,CACjD,IAAMsB,CAAAA,CAAiB,EAAC,CACxB,OAAItB,CAAAA,CAAK,IAAA,EAAM,SAAA,EAAWsB,CAAAA,CAAK,IAAA,CAAK,SAAStB,CAAAA,CAAK,IAAA,CAAK,SAAS,CAAA,CAAE,CAAA,CAC9DA,CAAAA,CAAK,IAAA,EAAM,UAAA,EAAYsB,CAAAA,CAAK,IAAA,CAAK,CAAA,MAAA,EAAStB,CAAAA,CAAK,IAAA,CAAK,UAAU,CAAA,CAAE,CAAA,CAChEA,EAAK,EAAA,EAAI,SAAA,EAAWsB,CAAAA,CAAK,IAAA,CAAK,CAAA,IAAA,EAAOtB,CAAAA,CAAK,EAAA,CAAG,SAAS,CAAA,CAAE,CAAA,CACxDA,CAAAA,CAAK,EAAA,EAAI,UAAA,EAAYsB,CAAAA,CAAK,IAAA,CAAK,CAAA,IAAA,EAAOtB,CAAAA,CAAK,EAAA,CAAG,UAAU,CAAA,CAAE,CAAA,CACvDsB,CAAAA,CAAK,IAAA,CAAK,IAAI,CAAA,EAAK,SAC5B,CAAA,CAGaC,EAAAA,CAAYH,CAAAA,EACnBA,CAAAA,CAAO,KAAA,CAAM,MAAA,GAAW,EAAU,8BAAA,CAClCA,CAAAA,CAAO,KAAA,CAAM,MAAA,GAAW,CAAA,CAAUC,CAAAA,CAAaD,CAAAA,CAAO,KAAA,CAAM,CAAC,CAAC,CAAA,CAC3DA,CAAAA,CAAO,KAAA,CAAM,GAAA,CAAI,CAACpB,CAAAA,CAAM,IAAM,CAAA,KAAA,EAAQ,CAAC,CAAA,EAAA,EAAKqB,CAAAA,CAAarB,CAAI,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,KAAK,ECXrFwB,qBAAAA,CAAsB,cAAe,EAAE,CAAA,CCkBvC,IAAMC,CAAAA,CAAY,CAACC,EAAsB7C,CAAAA,CAAkB8C,CAAAA,GAA2B,CACpF,IAAMC,CAAAA,CAAQF,CAAAA,CAAM7C,CAAQ,CAAA,GAAI8C,CAAM,CAAA,CACtC,GAAI,CAACC,CAAAA,CACH,MAAM,IAAI,KAAA,CAAM,0BAA0BD,CAAM,CAAA,0BAAA,EAA6B9C,CAAQ,CAAA,CAAA,CAAG,CAAA,CAC1F,OAAO+C,CACT,CAAA,CAWaC,EAAAA,CAAkB,CAC7BH,CAAAA,CACA7C,CAAAA,CACA8C,CAAAA,CACA5C,CAAAA,CACAY,CAAAA,CAAe,GACfjB,CAAAA,CAA6B,EAAC,GACd,CAChB,IAAMkD,CAAAA,CAAQH,CAAAA,CAAUC,CAAAA,CAAO7C,CAAAA,CAAU8C,CAAM,CAAA,CACzCG,CAAAA,CAAsB,EAAC,CAC7B,IAAA,IAAW9B,CAAAA,IAAQ4B,EAAM,KAAA,CAAO,CAC9B,IAAMpB,CAAAA,CAASG,CAAAA,CAAUX,CAAAA,CAAMjB,CAAAA,CAAQY,CAAAA,CAASjB,CAAO,CAAA,CACvD,GAAI8B,CAAAA,GAAW,IAAA,CAAM,OAAO,KAAA,CAC5BsB,CAAAA,CAAM,IAAA,CAAKtB,CAAM,EACnB,CACA,OAAO,CAAE,KAAA,CAAAsB,CAAM,CACjB,CAAA,CAOaC,EAAAA,CAAY,CACvBL,CAAAA,CACA7C,CAAAA,CACAE,CAAAA,CACAL,CAAAA,CAA6B,EAAC,GACjB,CACb,IAAMsD,CAAAA,CAAUN,CAAAA,CAAM7C,CAAQ,CAAA,CAC9B,GAAI,CAACmD,CAAAA,CAAS,OAAO,EAAC,CACtB,GAAM,CAAE,KAAA,CAAAzD,EAAO,SAAA,CAAAmC,CAAAA,CAAW,GAAGG,CAAW,CAAA,CAAInC,CAAAA,CAEtCuD,CAAAA,CAAS,CAACnD,CAAAA,CAA8BoD,CAAAA,GAC5C,CAACxB,CAAAA,EAAa5B,CAAAA,GAAS,MAAA,EAAa4B,CAAAA,CAAU5B,CAAAA,CAAMoD,EAAK3D,CAAK,CAAA,CAEhE,OAAO,MAAA,CAAO,OAAA,CAAQyD,CAAO,CAAA,CAC1B,MAAA,CAAO,CAAC,EAAGL,CAAM,CAAA,GAChBA,CAAAA,CAAO,KAAA,CAAM,IAAA,CACV3B,CAAAA,EACCiB,KAAAA,CAAUjB,CAAAA,CAAK,IAAA,CAAK,SAAA,CAAWjB,CAAAA,CAAQ8B,CAAU,CAAA,GAAM,IAAA,EACvDoB,CAAAA,CAAOjC,CAAAA,CAAK,IAAA,CAAK,UAAA,CAAYjB,CAAM,CACvC,CACF,EACC,GAAA,CAAI,CAAC,CAAC4C,CAAM,CAAA,GAAMA,CAAM,CAC7B,CAAA,CAIMQ,CAAAA,CAAe,CACnBC,CAAAA,CACAC,CAAAA,GAC+B,CAC/B,GAAID,CAAAA,GAAa,MAAA,EAAa,OAAOA,CAAAA,EAAa,QAAA,CAAU,OAAOA,CAAAA,CACnE,IAAME,CAAAA,CAAU,CAAE,KAAA,CAAO,UAAA,CAAY,QAAA,CAAUC,QAAAA,CAAS,MAAA,CAAQ,GAAGH,CAAS,CAAA,CACtE,CAAE,MAAOI,CAAAA,CAAQ,QAAA,CAAUC,CAAAA,CAAW,GAAGlD,CAAO,CAAA,CAAImD,QAAAA,CAASJ,CAAAA,CAASD,CAAQ,CAAA,CACpF,OAAO9C,CACT,CAAA,CAaaoD,EAAAA,CAAW,CACtBjB,CAAAA,CACA7C,CAAAA,CACA8C,CAAAA,CACAjD,CAAAA,CAA2B,EAAC,GACT,CACnB,IAAMkD,CAAAA,CAAQH,CAAAA,CAAUC,CAAAA,CAAO7C,CAAAA,CAAU8C,CAAM,CAAA,CACzC,CAAE,QAAA,CAAAU,CAAAA,CAAW,EAAC,CAAG,QAAA,CAAAD,CAAAA,CAAU,GAAGQ,CAAQ,CAAA,CAAIlE,CAAAA,CAC1CmE,CAAAA,CAAYH,QAAAA,CAAS,CAAE,GAAA,CAAKd,CAAAA,CAAM,KAAA,CAAM,GAAA,CAAK5B,CAAAA,EAASA,CAAAA,CAAK,KAAK,SAAS,CAAE,CAAA,CAAGqC,CAAQ,CAAA,CAC5F,OAAOS,QAAAA,CAASD,CAAAA,CAAW,CAAE,GAAGD,CAAAA,CAAS,QAAA,CAAUT,CAAAA,CAAaC,CAAAA,CAAUC,CAAQ,CAAE,CAAC,CACvF,EC7GO,IAAMU,EAAAA,CAAkBnC,CAAAA,EAC7BpB,CAAAA,CAAoBoB,CAAAA,CAAW,EAAA,CAAG,KAAK,ECYzC,IAAMoC,CAAAA,CAAiB,IAAI,GAAA,CAAI,CAAC,QAAA,CAAU,WAAW,CAAC,CAAA,CAChDC,CAAAA,CAAc,IAAI,GAAA,CAAI,CAAC,SAAU,cAAc,CAAC,CAAA,CAEhDC,CAAAA,CAAoB,CACxBL,CAAAA,CACAM,CAAAA,CACAnD,CAAAA,CACAoD,CAAAA,GACS,CACT,GAAIP,CAAAA,GAAc,MAAA,CAAW,CAC3BM,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAAnD,CAAAA,CAAM,OAAA,CAAS,uBAAA,CAAyB,IAAA,CAAM,mBAAoB,CAAC,CAAA,CACjF,MACF,CACA,IAAMqD,CAAAA,CAAS,CACb,GAAGC,YAAAA,CAAaT,CAAS,EAAE,MAAA,CAC3B,GAAIO,CAAAA,CAAOG,kBAAAA,CAAmBV,CAAAA,CAAWO,CAAI,CAAA,CAAE,MAAA,CAAS,EAC1D,CAAA,CACA,IAAA,IAAWI,CAAAA,IAASH,CAAAA,CAAQF,CAAAA,CAAO,IAAA,CAAK,CAAE,GAAGK,CAAAA,CAAO,IAAA,CAAM,CAAA,EAAGxD,CAAI,CAAA,CAAA,EAAIwD,CAAAA,CAAM,IAAI,CAAA,CAAG,CAAC,EACrF,CAAA,CAEMC,CAAAA,CAAqB,CACzB3E,CAAAA,CACAqE,EACAnD,CAAAA,GACS,CACT,GAAIlB,CAAAA,GAAS,MAAA,CACb,IAAA,IAAW0E,CAAAA,IAASE,kBAAAA,CAAmB5E,CAAI,CAAA,CAAE,MAAA,CAC3CqE,CAAAA,CAAO,IAAA,CAAK,CAAE,GAAGK,CAAAA,CAAO,KAAM,CAAA,EAAGxD,CAAI,CAAA,EAAGwD,CAAAA,CAAM,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA,CAAI,IAAA,CAAM,oBAAqB,CAAC,EAC/F,CAAA,CAEMG,CAAAA,CAAgB,CAAClE,EAA0B0D,CAAAA,CAA2BnD,CAAAA,GAAuB,CACjG,GAAI,EAAAP,CAAAA,GAAU,MAAA,EAAa,OAAOA,CAAAA,EAAU,UAAA,CAAA,CAC5C,CAAA,GAAI,OAAOA,CAAAA,EAAU,QAAA,CAAU,CACxBuD,CAAAA,CAAe,IAAIvD,CAAK,CAAA,EAC3B0D,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAAnD,CAAAA,CAAM,OAAA,CAAS,CAAA,wBAAA,EAA2BP,CAAK,CAAA,CAAA,CAAA,CAAK,IAAA,CAAM,eAAgB,CAAC,CAAA,CAC3F,MACF,CACKwD,CAAAA,CAAY,GAAA,CAAIxD,CAAAA,CAAM,IAAI,CAAA,CAErBA,CAAAA,CAAM,IAAA,EACd0D,CAAAA,CAAO,IAAA,CAAK,CACV,IAAA,CAAAnD,CAAAA,CACA,OAAA,CAAS,CAAA,OAAA,EAAUP,CAAAA,CAAM,IAAI,wBAC7B,IAAA,CAAM,eACR,CAAC,CAAA,CAND0D,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAAnD,CAAAA,CAAM,OAAA,CAAS,CAAA,oBAAA,EAAuBP,CAAAA,CAAM,IAAI,CAAA,CAAA,CAAA,CAAK,IAAA,CAAM,eAAgB,CAAC,EAAA,CAO9F,CAAA,CAEMmE,CAAAA,CAAe,CACnBC,CAAAA,CACAV,CAAAA,CACAnD,CAAAA,CACAtB,CAAAA,GACS,CACT,GAAImF,CAAAA,GAAS,IAAA,EAAQ,OAAOA,CAAAA,EAAS,QAAA,CAAU,CAC7CV,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAAnD,CAAAA,CAAM,OAAA,CAAS,CAAA,EAAA,EAAKA,CAAI,CAAA,mBAAA,CAAA,CAAuB,IAAA,CAAM,cAAe,CAAC,CAAA,CACnF,MACF,CACAkD,CAAAA,CAAkBW,EAAK,SAAA,CAAWV,CAAAA,CAAQ,CAAA,EAAGnD,CAAI,CAAA,UAAA,CAAA,CAActB,CAAAA,CAAQ,IAAI,CAAA,CAC3E+E,CAAAA,CAAmBI,CAAAA,CAAK,UAAA,CAAYV,CAAAA,CAAQ,CAAA,EAAGnD,CAAI,CAAA,WAAA,CAAa,CAAA,CAC5D6D,EAAK,QAAA,GAAa,MAAA,GAAc,OAAOA,CAAAA,CAAK,QAAA,EAAa,QAAA,EAAYA,CAAAA,CAAK,QAAA,GAAa,IAAA,CAAA,EACzFV,CAAAA,CAAO,IAAA,CAAK,CACV,IAAA,CAAM,CAAA,EAAGnD,CAAI,CAAA,SAAA,CAAA,CACb,QAAS,mDAAA,CACT,IAAA,CAAM,kBACR,CAAC,CAAA,CACC,OAAA,GAAW6D,CAAAA,EAAMF,CAAAA,CAAcE,CAAAA,CAAK,KAAA,CAAOV,CAAAA,CAAQ,CAAA,EAAGnD,CAAI,CAAA,MAAA,CAAQ,EACxE,CAAA,CASa8D,GAAqB,CAChClD,CAAAA,CACAlC,CAAAA,CAA2B,EAAC,GACP,CACrB,IAAMyE,CAAAA,CAA4B,EAAC,CACnC,OAAAS,CAAAA,CAAahD,CAAAA,EAAY,IAAA,CAAMuC,CAAAA,CAAQ,MAAA,CAAQzE,CAAO,CAAA,CACtDkF,CAAAA,CAAahD,CAAAA,EAAY,EAAA,CAAIuC,CAAAA,CAAQ,IAAA,CAAMzE,CAAO,CAAA,CAC9CA,CAAAA,CAAQ,mBAAA,EAAuB,CAACc,CAAAA,CAAoBoB,CAAAA,EAAY,EAAA,EAAI,KAAK,CAAA,EAC3EuC,EAAO,IAAA,CAAK,CACV,IAAA,CAAM,UAAA,CACN,OAAA,CAAS,4DAAA,CACT,IAAA,CAAM,sBACR,CAAC,CAAA,CACI,CAAE,EAAA,CAAIA,CAAAA,CAAO,MAAA,GAAW,CAAA,CAAG,MAAA,CAAAA,CAAO,CAC3C","file":"index.js","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type SchemaMap,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /** Which model each resource is, and its relations: where a `{ rel }` walk leads. */\n map: SchemaMap<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getActor: () => actor ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, `rel` walks through the schema map, cross-map bridge walks, abac `{ rule }`\n * reading the actor as `__actor`, boolean terminals, `any`/`all`, per-row `permissionRules`\n * overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const check = createRebacCheck<R>(options.map);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n PathReason,\n Row,\n SideReason,\n Transition,\n TransitionOptions,\n} from './types';\n\nconst predicateReason = (result: boolean | string): string =>\n typeof result === 'string' ? result : 'predicate not satisfied';\n\n/**\n * Does this permission DENY?\n * - no authorizer injected → can't deny (legality-only mode)\n * - `undefined` rule → permission absent → open → can't deny\n * - any other rule (incl. `null` = terminal deny) → delegate to the authorizer\n */\nconst denies = (\n authorize: Authorize | undefined,\n rule: ActionRule | undefined,\n record: Row,\n actor: Actor,\n): boolean => {\n if (!authorize || rule === undefined) return false;\n return !authorize(rule, record, actor);\n};\n\n/**\n * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —\n * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole\n * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns\n * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;\n * json-rules' `check()` options (`now`, `bindings`, …) reach both predicates.\n */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: TransitionOptions = {},\n): true | PathReason => {\n const { actor, authorize, ...evaluation } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const from: SideReason = {};\n const fromPredicate = checkRule(transition.from.predicate, record as Row, evaluation);\n if (fromPredicate !== true) from.predicate = predicateReason(fromPredicate);\n if (denies(authorize, transition.from.permission, record as Row, actor))\n from.permission = 'not authorized';\n\n const to: SideReason = {};\n const toPredicate = checkRule(transition.to.predicate, next as Row, evaluation);\n if (toPredicate !== true) to.predicate = predicateReason(toPredicate);\n if (denies(authorize, transition.to.permission, next as Row, actor))\n to.permission = 'not authorized';\n\n const reason: PathReason = {};\n if (from.predicate || from.permission) reason.from = from;\n if (to.predicate || to.permission) reason.to = to;\n return reason.from || reason.to ? reason : true;\n};\n","import type { PathReason, Reason } from './types';\n\nconst describePath = (path: PathReason): string => {\n const segs: string[] = [];\n if (path.from?.predicate) segs.push(`from: ${path.from.predicate}`);\n if (path.from?.permission) segs.push(`from: ${path.from.permission}`);\n if (path.to?.predicate) segs.push(`to: ${path.to.predicate}`);\n if (path.to?.permission) segs.push(`to: ${path.to.permission}`);\n return segs.join('; ') || 'unknown';\n};\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n if (reason.paths.length === 0) return 'no transition path available';\n if (reason.paths.length === 1) return describePath(reason.paths[0]);\n return reason.paths.map((path, i) => `path ${i}: ${describePath(path)}`).join(' | ');\n};\n","import { registerEngineGlobals } from '@inixiative/json-rules';\n\n// transitions' namespace in the one engine interaction point (json-rules' `engineGlobals`). Every\n// option transitions takes is per call today, so it holds no path yet.\nregisterEngineGlobals('transitions', {});\n","import {\n bindRule,\n type Condition,\n check as checkRule,\n Operator,\n type RuleValue,\n type TimeZoneConfig,\n type ToPrismaResult,\n toPrisma,\n} from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n CheckResult,\n EligibleOptions,\n PathReason,\n Row,\n TransitionMap,\n TransitionOptions,\n} from './types';\n\nconst getAction = (rules: TransitionMap, resource: string, action: string): Action => {\n const found = rules[resource]?.[action];\n if (!found)\n throw new Error(`transition: no action \"${action}\" registered on resource \"${resource}\"`);\n return found;\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches\n * the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a\n * {@link Reason} with one {@link PathReason} per candidate path tried.\n *\n * `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`\n * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound\n * to this resource); a `predicate` that reads a bridged relation expects a stitched record.\n */\nexport const checkTransition = (\n rules: TransitionMap,\n resource: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: TransitionOptions = {},\n): CheckResult => {\n const found = getAction(rules, resource, action);\n const paths: PathReason[] = [];\n for (const path of found.paths) {\n const result = checkPath(path, record, changes, options);\n if (result === true) return true;\n paths.push(result);\n }\n return { paths };\n};\n\n/**\n * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`\n * side (predicate + `from` permission against the current record) — `to` needs the merged record,\n * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.\n */\nexport const available = (\n rules: TransitionMap,\n resource: string,\n record: Row,\n options: TransitionOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize, ...evaluation } = options;\n\n const allows = (rule: ActionRule | undefined, rec: Row): boolean =>\n !authorize || rule === undefined || authorize(rule, rec, actor);\n\n return Object.entries(actions)\n .filter(([, action]) =>\n action.paths.some(\n (path) =>\n checkRule(path.from.predicate, record, evaluation) === true &&\n allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n// A `{ bind }` zone, resolved the way the rule's own tokens are: json-rules' bindRule over a\n// carrier leaf. An uncovered token stays a token, and toPrisma reports it unresolved.\nconst bindTimeZone = (\n timeZone: TimeZoneConfig | undefined,\n bindings: Record<string, RuleValue>,\n): TimeZoneConfig | undefined => {\n if (timeZone === undefined || typeof timeZone === 'string') return timeZone;\n const carrier = { field: 'timeZone', operator: Operator.equals, ...timeZone } as Condition;\n const { field: _field, operator: _operator, ...source } = bindRule(carrier, bindings) as Row;\n return source as TimeZoneConfig;\n};\n\n/**\n * Set query as a json-rules Prisma plan: every record currently eligible for `action` (the union\n * of all its paths' `from` predicates; a single path compiles to its predicate alone; an empty\n * action matches nothing). Takes the json-rules `check()` options plus toPrisma's schema:\n * `bindings` are resolved into the predicate and a `{ bind }` timeZone before compiling, `now`\n * reaches `toPrisma`, and `map` / `mapName` / `model` (or `lens`) let it compile a column\n * compared with a column or a count. Run it with json-rules' `executePrismaPlan(plan, prisma)`,\n * which resolves the plan's references, and the `where` selects the rows the single check\n * accepts. A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude, a column\n * ref without the schema) throws.\n */\nexport const eligible = (\n rules: TransitionMap,\n resource: string,\n action: string,\n options: EligibleOptions = {},\n): ToPrismaResult => {\n const found = getAction(rules, resource, action);\n const { bindings = {}, timeZone, ...compile } = options;\n const predicate = bindRule({ any: found.paths.map((path) => path.from.predicate) }, bindings);\n return toPrisma(predicate, { ...compile, timeZone: bindTimeZone(timeZone, bindings) });\n};\n","import { isSerializableMerge } from './merge';\nimport type { Transition } from './types';\n\n/**\n * Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?\n *\n * Predicates (json-rules) and permissions (ActionRule) are always plain JSON; the only\n * non-data escape hatch is a `to.merge` callback. So serializability reduces to the merge.\n */\nexport const isSerializable = (transition: Transition): boolean =>\n isSerializableMerge(transition.to.merge);\n","import {\n type Condition,\n type Lens,\n type LensNarrowing,\n type ValidationIssue,\n type ValidationResult,\n validateRule,\n validateRuleInLens,\n} from '@inixiative/json-rules';\nimport { validateActionRule } from '@inixiative/permissions';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type { ValidationIssue, ValidationResult };\n\nexport type ValidateOptions = {\n /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */\n lens?: Lens | LensNarrowing;\n /** Reject callback merges (use when the transition must be persistable / tenant-configured). */\n requireSerializable?: boolean;\n};\n\nconst MERGE_KEYWORDS = new Set(['spread', 'deepMerge']);\nconst ARRAY_KINDS = new Set(['append', 'appendUnique']);\n\nconst validatePredicate = (\n predicate: Condition | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required', code: 'missing_predicate' });\n return;\n }\n const issues = [\n ...validateRule(predicate).errors,\n ...(lens ? validateRuleInLens(predicate, lens).errors : []),\n ];\n for (const issue of issues) errors.push({ ...issue, path: `${path}.${issue.path}` });\n};\n\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return;\n for (const issue of validateActionRule(rule).errors)\n errors.push({ ...issue, path: `${path}${issue.path.slice(1)}`, code: 'invalid_permission' });\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"`, code: 'invalid_merge' });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"`, code: 'invalid_merge' });\n else if (!merge.path)\n errors.push({\n path,\n message: `merge \"${merge.kind}\" requires a \\`path\\``,\n code: 'invalid_merge',\n });\n};\n\nconst validateSide = (\n side: Side | ToSide | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required`, code: 'missing_side' });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n code: 'invalid_requires',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `validateActionRule`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n code: 'unserializable_merge',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inixiative/transitions",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "Declarative, serializable transition guard + affordance layer on top of @inixiative/json-rules",
5
5
  "main": "./dist/index.cjs",
6
6
  "module": "./dist/index.js",
@@ -41,8 +41,8 @@
41
41
  },
42
42
  "devDependencies": {
43
43
  "@biomejs/biome": "2.5.2",
44
- "@inixiative/config": "^0.5.64",
45
- "@types/bun": "1.4.2",
44
+ "@inixiative/config": "^0.5.191",
45
+ "@types/bun": "1.4.4",
46
46
  "@types/lodash-es": "^4.17.12",
47
47
  "lefthook": "2.1.9",
48
48
  "tsup": "8.5.1",
@@ -57,8 +57,8 @@
57
57
  }
58
58
  },
59
59
  "dependencies": {
60
- "@inixiative/json-rules": "^3.5.1",
61
- "@inixiative/permissions": "^0.4.0",
60
+ "@inixiative/json-rules": "^3.17.0",
61
+ "@inixiative/permissions": "^0.19.0",
62
62
  "lodash-es": "^4.18.1",
63
63
  "zod": "^4.4.3"
64
64
  },
@@ -69,5 +69,5 @@
69
69
  "require": "./dist/index.cjs"
70
70
  }
71
71
  },
72
- "packageManager": "bun@1.4.2"
72
+ "packageManager": "bun@1.4.4"
73
73
  }