@inixiative/transitions 0.0.1 → 0.0.3
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 +56 -35
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +48 -64
- package/dist/index.d.ts +48 -64
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
A small, **stateless** primitive on top of [`@inixiative/json-rules`](https://github.com/inixiative/json-rules)
|
|
4
4
|
that answers two questions about an entity's lifecycle, declaratively:
|
|
5
5
|
|
|
6
|
-
- **"Can this change happen?"** — guard a proposed update (`
|
|
7
|
-
- **"What changes can happen?"** — list available
|
|
8
|
-
`toPrisma`, every record currently eligible for
|
|
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`).
|
|
9
9
|
|
|
10
10
|
It is **not** a state machine (no statecharts/actors/hierarchy), does **not** own state, and does
|
|
11
11
|
**not** execute the change or run side effects. It is a guard + affordance layer. A transition is
|
|
@@ -17,45 +17,65 @@ no deploy to change a lifecycle).
|
|
|
17
17
|
## Model
|
|
18
18
|
|
|
19
19
|
```
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
20
|
+
resource → action → Action { paths: Transition[], label? }
|
|
21
|
+
Transition { from: Side, to: Side & { merge? } }
|
|
22
|
+
Side { predicate, permission?, requires? }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
+
A `resource` key is map-qualified (`map:Model`, e.g. `db:Inquiry`) — the same convention
|
|
26
|
+
`@inixiative/permissions` uses, so a transition's `permission` can delegate into the rebac schema.
|
|
27
|
+
|
|
25
28
|
A `Transition` is one atomic `from → to` edge. An **Action** (a named verb) is the OR of its edges —
|
|
26
29
|
disjunction lives at the action level, never inside a `Transition`, so the kernel stays atomic and
|
|
27
30
|
serializable.
|
|
28
31
|
|
|
29
32
|
The `from`/`to` asymmetry is load-bearing and applies to **both** `predicate` (legality) and
|
|
30
33
|
`permission` (authz): `from.*` is evaluated against the **current** record, `to.*` against the
|
|
31
|
-
**resulting (merged)** record.
|
|
34
|
+
**resulting (merged)** record. Permission only ever lives on a side — every authz check reads a
|
|
35
|
+
concrete record, so there is no record-free action-level permission.
|
|
32
36
|
|
|
33
|
-
##
|
|
37
|
+
## Check
|
|
34
38
|
|
|
35
39
|
```ts
|
|
36
40
|
import { checkTransition } from '@inixiative/transitions';
|
|
37
41
|
|
|
38
|
-
const
|
|
39
|
-
|
|
40
|
-
|
|
42
|
+
const rules = {
|
|
43
|
+
'db:Inquiry': {
|
|
44
|
+
approve: {
|
|
45
|
+
paths: [
|
|
46
|
+
{
|
|
47
|
+
from: { predicate: { field: 'status', operator: 'equals', value: 'pending' } },
|
|
48
|
+
to: { predicate: { field: 'status', operator: 'equals', value: 'approved' } },
|
|
49
|
+
},
|
|
50
|
+
],
|
|
51
|
+
},
|
|
52
|
+
},
|
|
41
53
|
};
|
|
42
54
|
|
|
43
|
-
checkTransition(approve, { status: 'pending' }, { status: 'approved' });
|
|
44
|
-
// →
|
|
55
|
+
checkTransition(rules, 'db:Inquiry', 'approve', { status: 'pending' }, { status: 'approved' });
|
|
56
|
+
// → true
|
|
45
57
|
|
|
46
|
-
checkTransition(approve, { status: 'approved' }, { status: 'approved' });
|
|
47
|
-
// → {
|
|
58
|
+
checkTransition(rules, 'db:Inquiry', 'approve', { status: 'approved' }, { status: 'approved' });
|
|
59
|
+
// → { paths: [{ from: { predicate: 'status must equal "pending"' } }] }
|
|
48
60
|
```
|
|
49
61
|
|
|
50
|
-
`
|
|
62
|
+
`checkTransition(rules, resource, action, record, changes, { actor, authorize })` returns **`true`** when
|
|
63
|
+
allowed, else a structured **`Reason`** — never a bare bool:
|
|
64
|
+
|
|
65
|
+
```ts
|
|
66
|
+
type SideReason = { predicate?: string; permission?: string }; // why one side failed
|
|
67
|
+
type PathReason = { from?: SideReason; to?: SideReason }; // why one candidate path failed
|
|
68
|
+
type Reason = { paths: PathReason[] }; // one entry per path tried
|
|
69
|
+
```
|
|
51
70
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
| `unauthorized` | a legal edge exists but a permission denied | 403 |
|
|
71
|
+
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
|
|
73
|
+
map to HTTP: a path that fails purely on `permission` is a 403; any `predicate` failure is a 409.
|
|
74
|
+
`describe(reason)` builds a human-readable message.
|
|
57
75
|
|
|
58
|
-
`
|
|
76
|
+
`checkPath(transition, record, changes, options)` is the single-edge kernel underneath, returning
|
|
77
|
+
`true | PathReason`; `checkTransition` walks an action's paths with it and returns the first `true`,
|
|
78
|
+
else every path's `PathReason`.
|
|
59
79
|
|
|
60
80
|
## Permissions are injected (the seam)
|
|
61
81
|
|
|
@@ -64,38 +84,39 @@ The kernel never imports an authorization library. Per-side `permission` is a se
|
|
|
64
84
|
`authorize` callback to evaluate it:
|
|
65
85
|
|
|
66
86
|
```ts
|
|
67
|
-
import {
|
|
87
|
+
import { checkTransition, createRebac } from '@inixiative/transitions';
|
|
68
88
|
|
|
69
|
-
const authorize = createRebac({ schema: rebacSchema })('
|
|
70
|
-
|
|
89
|
+
const authorize = createRebac({ schema: rebacSchema })('db:Inquiry');
|
|
90
|
+
checkTransition(rules, 'db:Inquiry', 'approve', record, changes, { actor, authorize });
|
|
71
91
|
```
|
|
72
92
|
|
|
73
|
-
Effective authz ANDs
|
|
93
|
+
Effective authz ANDs the two side rules, each against the record it reads:
|
|
74
94
|
|
|
75
95
|
```
|
|
76
|
-
|
|
77
|
-
(
|
|
96
|
+
from.permission AND to.permission
|
|
97
|
+
(current record) (merged record)
|
|
78
98
|
```
|
|
79
99
|
|
|
80
|
-
Absent = open; `null` = terminal deny.
|
|
100
|
+
Absent = open; `null` = terminal deny. Omit `authorize` to check legality only.
|
|
81
101
|
|
|
82
102
|
### `createRebac` / `makeRebacAuthorize` — reference implementation
|
|
83
103
|
|
|
84
104
|
This package ships a **reference** rebac evaluator (`string` delegation, relation walk with cycle
|
|
85
105
|
detection, `{ self }`, json-rules `{ rule }`, `any`/`all`, per-row `permissionRules` override). It's
|
|
86
|
-
one implementation of the `Authorize` seam, kept deliberately swappable.
|
|
87
|
-
|
|
88
|
-
the
|
|
106
|
+
one implementation of the `Authorize` seam, kept deliberately swappable. The standalone
|
|
107
|
+
[`@inixiative/permissions`](https://github.com/inixiative/permissions) package is the production
|
|
108
|
+
evaluator — inject its `check` as the `authorize` seam (it speaks the same map-qualified
|
|
109
|
+
`resource` keys); nothing in the transition core changes.
|
|
89
110
|
|
|
90
111
|
## Affordance + set query
|
|
91
112
|
|
|
92
113
|
```ts
|
|
93
114
|
import { available, eligible } from '@inixiative/transitions';
|
|
94
115
|
|
|
95
|
-
available(
|
|
96
|
-
// → ['approve', 'reject', 'cancel'] (from-side only — `to` needs proposed changes, so it defers to
|
|
116
|
+
available(rules, 'db:Inquiry', record, { actor, authorize });
|
|
117
|
+
// → ['approve', 'reject', 'cancel'] (from-side only — `to` needs proposed changes, so it defers to checkTransition)
|
|
97
118
|
|
|
98
|
-
eligible(
|
|
119
|
+
eligible(rules, 'db:Inquiry', 'approve');
|
|
99
120
|
// → { OR: [{ status: { equals: 'pending' } }] } (Prisma where for "every record eligible for approve")
|
|
100
121
|
```
|
|
101
122
|
|
package/dist/index.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
'use strict';var jsonRules=require('@inixiative/json-rules'),lodashEs=require('lodash-es');var
|
|
1
|
+
'use strict';var jsonRules=require('@inixiative/json-rules'),lodashEs=require('lodash-es');var h=e=>Array.isArray(e)?e:e===void 0?[]:[e],O=(e,t)=>Array.isArray(t)?t:void 0,m=e=>typeof e!="function",y=(e,t,n={})=>{if(typeof e=="function")return e(t,n);let i=e??"spread";if(i==="spread")return {...t,...n};if(i==="deepMerge")return lodashEs.mergeWith(lodashEs.cloneDeep(t),lodashEs.cloneDeep(n),O);let{kind:o,path:r}=i,s=lodashEs.cloneDeep({...t,...n}),a=[...h(lodashEs.get(t,r)),...h(lodashEs.get(n,r))];return lodashEs.set(s,r,o==="appendUnique"?lodashEs.uniqWith(a,lodashEs.isEqual):a),s};var A=e=>typeof e=="string"?e:"predicate not satisfied",b=(e,t,n,i)=>!e||t===void 0?false:!e(t,n,i),k=(e,t,n={},i={})=>{let{actor:o,authorize:r}=i,s=y(e.to.merge,t,n),a={},p=jsonRules.check(e.from.predicate,t);p!==true&&(a.predicate=A(p)),b(r,e.from.permission,t,o)&&(a.permission="not authorized");let f={},c=jsonRules.check(e.to.predicate,s);c!==true&&(f.predicate=A(c)),b(r,e.to.permission,s,o)&&(f.permission="not authorized");let u={};return (a.predicate||a.permission)&&(u.from=a),(f.predicate||f.permission)&&(u.to=f),u.from||u.to?u:true};var S=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"},G=e=>e.paths.length===0?"no transition path available":e.paths.length===1?S(e.paths[0]):e.paths.map((t,n)=>`path ${n}: ${S(t)}`).join(" | ");var l=(e,t,n,i,o,r)=>{if(e.isSuperadmin?.(i))return true;if(o===null)return false;if(typeof o=="string"){let s=e.schema[t]?.actions[o]??null,p=n.permissionRules?.[o];return l(e,t,n,i,p!==void 0?{any:[s,p]}:s,r)}if("rel"in o&&"action"in o){let s=o.rel.split("."),a=n,p=t;for(let c of s){let u=a[c];if(!u)return false;p=e.resolveModel?e.resolveModel(p,c):c,a=u;}let f=`${p}:${String(a.id)}:${o.action}`;if(r.has(f))throw new Error(`Cycle detected in permission graph: ${f}`);return r.add(f),l(e,p,a,i,o.action,r)}if("self"in o){let s=i?.id??null;return s!==null&&n[o.self]===s}return "rule"in o?jsonRules.check(o.rule,n)===true:"any"in o?o.any.some(s=>l(e,t,n,i,s,new Set(r))):"all"in o?o.all.every(s=>l(e,t,n,i,s,new Set(r))):false},v=e=>{let{model:t,...n}=e;return (i,o,r)=>l(n,t,o,r,i,new Set)},H=e=>t=>v({...e,model:t});var $=(e,t,n)=>{let i=e[t]?.[n];if(!i)throw new Error(`transition: no action "${n}" registered on resource "${t}"`);return i},te=(e,t,n,i,o={},r={})=>{let s=$(e,t,n),a=[];for(let p of s.paths){let f=k(p,i,o,r);if(f===true)return true;a.push(f);}return {paths:a}},ne=(e,t,n,i={})=>{let o=e[t];if(!o)return [];let{actor:r,authorize:s}=i,a=(p,f)=>!s||p===void 0||s(p,f,r);return Object.entries(o).filter(([,p])=>p.paths.some(f=>jsonRules.check(f.from.predicate,n)===true&&a(f.from.permission,n))).map(([p])=>p)},oe=(e,t,n)=>{let i=$(e,t,n),{steps:o}=jsonRules.toPrisma({any:i.paths.map(s=>s.from.predicate)}),r=o[o.length-1];if(r?.operation!=="where"||r.where===void 0)throw new Error("transition: expected a terminal WhereStep from toPrisma; got none");return r.where};var se=e=>m(e.to.merge);var L=new Set(["spread","deepMerge"]),j=new Set(["append","appendUnique"]),N=(e,t,n,i)=>{let o=jsonRules.validateRule(e);for(let r of o.errors)t.push({path:`${n}.${r.path}`,message:r.message});if(i){let r=jsonRules.checkRuleAgainstLens(e,i);for(let s of r.violations)t.push({path:`${n}.${s.path}`,message:s.reason});}},g=(e,t,n)=>{if(!(e==null||typeof e=="string")){if("rule"in e){let i=jsonRules.validateRule(e.rule);for(let o of i.errors)t.push({path:`${n}.rule.${o.path}`,message:o.message});return}if("rel"in e){(!e.rel||!e.action)&&t.push({path:n,message:"rel-rule requires non-empty `rel` and `action`"});return}if("self"in e){e.self||t.push({path:n,message:"self-rule requires a non-empty field name"});return}if("any"in e){e.any.forEach((i,o)=>{g(i,t,`${n}.any[${o}]`);});return}if("all"in e){e.all.forEach((i,o)=>{g(i,t,`${n}.all[${o}]`);});return}t.push({path:n,message:"unrecognized ActionRule shape"});}},W=(e,t,n)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){L.has(e)||t.push({path:n,message:`unknown merge strategy "${e}"`});return}j.has(e.kind)?e.path||t.push({path:n,message:`merge "${e.kind}" requires a \`path\``}):t.push({path:n,message:`unknown merge kind "${e.kind}"`});}},M=(e,t,n,i)=>{N(e.predicate,t,`${n}.predicate`,i.lens),g(e.permission,t,`${n}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${n}.requires`,message:"`requires` must be a Prisma-include-shaped object"}),"merge"in e&&W(e.merge,t,`${n}.merge`);},ue=(e,t={})=>{let n=[];return M(e.from,n,"from",t),M(e.to,n,"to",t),t.requireSerializable&&!m(e.to.merge)&&n.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy"}),{ok:n.length===0,errors:n}};exports.applyMerge=y;exports.available=ne;exports.checkPath=k;exports.checkTransition=te;exports.createRebac=H;exports.describe=G;exports.eligible=oe;exports.isSerializable=se;exports.isSerializableMerge=m;exports.makeRebacAuthorize=v;exports.validateTransition=ue;//# sourceMappingURL=index.cjs.map
|
|
2
2
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/merge.ts","../src/check.ts","../src/describe.ts","../src/rebac/authorize.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","record","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","reasonString","result","denies","authorize","rule","actor","checkTransition","transition","options","basePermission","next","fromResult","checkRule","toResult","describe","reason","evaluate","ctx","model","visited","schemaRule","rowRule","segments","current","currentModel","segment","related","key","actorId","sub","makeRebacAuthorize","rest","createRebac","getAction","map","verb","action","aggregate","failures","paths","_kind","_paths","pick","failure","chosen","_omit","representative","check","opts","available","actions","allows","rec","eligible","steps","toPrisma","last","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","predicate","errors","lens","validateRule","issue","lensCheck","checkRuleAgainstLens","violation","validatePermission","i","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.cjs","sourcesContent":["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 CheckOptions,\n CheckResult,\n Row,\n Transition,\n} from './types';\n\nconst reasonString = (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 transition.\n *\n * Legality (json-rules) AND authz (injected, per side), with the load-bearing asymmetry —\n * `from.*` reads the current `record`, `to.*` reads the merged `next` record. Authz order is\n * action baseline → from → to, all ANDed. Returns a structured {@link CheckResult} whose\n * `reason.kind` lets a caller map illegal → 409 vs unauthorized → 403.\n *\n * Omit `options.authorize` to check legality only.\n */\nexport const checkTransition = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: CheckOptions = {},\n): CheckResult<R> => {\n const { actor, authorize, basePermission } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const fromResult = checkRule(transition.from.predicate, record as Row);\n if (fromResult !== true)\n return { ok: false, reason: { kind: 'no-from', from: reasonString(fromResult) } };\n\n const toResult = checkRule(transition.to.predicate, next as Row);\n if (toResult !== true)\n return { ok: false, reason: { kind: 'no-to', to: reasonString(toResult) } };\n\n if (denies(authorize, basePermission, record as Row, actor))\n return { ok: false, reason: { kind: 'unauthorized', authz: 'action' } };\n if (denies(authorize, transition.from.permission, record as Row, actor))\n return { ok: false, reason: { kind: 'unauthorized', authz: 'from' } };\n if (denies(authorize, transition.to.permission, next as Row, actor))\n return { ok: false, reason: { kind: 'unauthorized', authz: 'to' } };\n\n return { ok: true, path: transition };\n};\n","import type { Reason } from './types';\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n switch (reason.kind) {\n case 'no-from':\n return reason.from ?? 'transition is not available from the current state';\n case 'no-to':\n return reason.to ?? 'the resulting state is not a valid target';\n case 'unauthorized':\n return reason.authz\n ? `not authorized (${reason.authz}-level permission denied)`\n : 'not authorized';\n default: {\n // exhaustiveness guard: a new FailureKind must be handled here, not silently return undefined\n const _exhaustive: never = reason.kind;\n return _exhaustive;\n }\n }\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport type { ActionRule, Actor, Authorize, Row } from '../types';\nimport type { RebacOptions, RebacSchema } from './types';\n\ntype Context = {\n schema: RebacSchema;\n resolveModel?: (model: string, relationSegment: string) => string;\n isSuperadmin?: (actor: Actor) => boolean;\n};\n\nconst evaluate = (\n ctx: Context,\n model: string,\n record: Row,\n actor: Actor,\n rule: ActionRule,\n visited: Set<string>,\n): boolean => {\n if (ctx.isSuperadmin?.(actor)) return true;\n if (rule === null) return false;\n\n // string → delegate to the named action on this model, additively merged with any per-row override.\n if (typeof rule === 'string') {\n const schemaRule = ctx.schema[model]?.actions[rule] ?? null;\n const rowRules = record.permissionRules as Record<string, ActionRule> | null | undefined;\n const rowRule = rowRules?.[rule];\n const merged: ActionRule = rowRule !== undefined ? { any: [schemaRule, rowRule] } : schemaRule;\n return evaluate(ctx, model, record, actor, merged, visited);\n }\n\n // { rel, action } → walk the relation (dot-paths supported), then check `action` on the target.\n if ('rel' in rule && 'action' in rule) {\n const segments = rule.rel.split('.');\n let current: Row = record;\n let currentModel = model;\n for (const segment of segments) {\n const related = current[segment] as Row | null | undefined;\n if (!related) return false;\n currentModel = ctx.resolveModel ? ctx.resolveModel(currentModel, segment) : segment;\n current = related;\n }\n const key = `${currentModel}:${String(current.id)}:${rule.action}`;\n if (visited.has(key)) throw new Error(`Cycle detected in permission graph: ${key}`);\n visited.add(key);\n return evaluate(ctx, currentModel, current, actor, rule.action, visited);\n }\n\n // { self } → record[field] matches the current actor.\n if ('self' in rule) {\n const actorId = actor?.id ?? null;\n return actorId !== null && record[rule.self] === actorId;\n }\n\n // { rule } → ABAC predicate (json-rules) over the record.\n if ('rule' in rule) return checkRule(rule.rule, record) === true;\n\n // Fork `visited` per branch — parallel paths through any/all aren't cycles.\n if ('any' in rule)\n return rule.any.some((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n if ('all' in rule)\n return rule.all.every((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n\n return false;\n};\n\n/**\n * A reference rebac evaluator — one implementation of the injected {@link Authorize} seam,\n * bound to a single `model`. Faithful to `@template/permissions`' `rebac/check` (string-delegate,\n * relation walk with cycle detection, self, json-rules `{ rule }`, any/all, per-row\n * `permissionRules` override) but standalone. Swap it for a richer authorizer in production;\n * this is slated to graduate into `@inixiative/permissions`.\n */\nexport const makeRebacAuthorize = (options: RebacOptions & { model: string }): Authorize => {\n const { model, ...rest } = options;\n return (rule, record, actor) => evaluate(rest, model, record, actor, rule, new Set());\n};\n\n/** Curried form: `createRebac({ schema })(model)` → an {@link Authorize} for that model. */\nexport const createRebac =\n (options: RebacOptions) =>\n (model: string): Authorize =>\n makeRebacAuthorize({ ...options, model });\n","import { check as checkRule, toPrisma } from '@inixiative/json-rules';\nimport { checkTransition } from './check';\nimport type {\n Action,\n AuthorizeOptions,\n CheckOptions,\n CheckResult,\n PathFailure,\n Reason,\n Row,\n TransitionMap,\n} from './types';\n\nconst getAction = (map: TransitionMap, model: string, verb: string): Action => {\n const action = map[model]?.[verb];\n if (!action) throw new Error(`transition: no action \"${verb}\" registered on model \"${model}\"`);\n return action;\n};\n\n// Pick the most-progressed failure across an action's paths:\n// unauthorized (a legal edge existed but authz denied) → 403\n// no-to (from matched, target invalid) → 409\n// no-from (no edge even starts here) → 409\nconst aggregate = (failures: Reason[]): Reason => {\n const paths: PathFailure[] = failures.map(({ kind: _kind, paths: _paths, ...rest }) => rest);\n const pick = (kind: Reason['kind']) => failures.find((failure) => failure.kind === kind);\n const chosen = pick('unauthorized') ?? pick('no-to') ?? pick('no-from');\n if (!chosen) return { kind: 'no-from', paths };\n const { paths: _omit, ...representative } = chosen;\n return { ...representative, paths };\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to`\n * matches the merged record, and whose permissions all pass, wins. If none pass, returns the\n * aggregated structured failure (see {@link aggregate}).\n */\nexport const check = (\n map: TransitionMap,\n model: string,\n verb: string,\n record: Row,\n changes: Row = {},\n options: AuthorizeOptions = {},\n): CheckResult => {\n const action = getAction(map, model, verb);\n const opts: CheckOptions = { ...options, basePermission: action.permission };\n\n const failures: Reason[] = [];\n for (const path of action.paths) {\n const result = checkTransition(path, record, changes, opts);\n if (result.ok) return result;\n failures.push(result.reason);\n }\n return { ok: false, reason: aggregate(failures) };\n};\n\n/**\n * Affordance hint: which verbs are offerable from `record` right now. Evaluates ONLY the\n * `from` side (predicate + `action`/`from` permission against the current record) — `to` needs\n * the merged record, which doesn't exist without proposed changes, so it defers to {@link check}.\n */\nexport const available = (\n map: TransitionMap,\n model: string,\n record: Row,\n options: AuthorizeOptions = {},\n): string[] => {\n const actions = map[model];\n if (!actions) return [];\n const { actor, authorize } = options;\n\n const allows = (rule: Action['permission'], 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) === true &&\n allows(action.permission, record) &&\n allows(path.from.permission, record),\n ),\n )\n .map(([verb]) => verb);\n};\n\n/**\n * Set query: one OR'd Prisma `where` matching every record currently eligible for `verb`\n * (the union of all its paths' `from` predicates). Empty action → match-nothing.\n */\nexport const eligible = (map: TransitionMap, model: string, verb: string): Row => {\n const action = getAction(map, model, verb);\n const { steps } = toPrisma({ any: action.paths.map((path) => path.from.predicate) });\n // json-rules guarantees the last step is the WhereStep. Assert it loudly rather than cast-and-swallow:\n // a silent `{}` fallback would mean match-EVERYTHING — the dangerous inverse of the intended\n // match-nothing — if a future json-rules emits a trailing non-where step or multi-step relation refs.\n const last = steps[steps.length - 1] as { operation?: string; where?: Row } | undefined;\n if (last?.operation !== 'where' || last.where === undefined)\n throw new Error('transition: expected a terminal WhereStep from toPrisma; got none');\n return last.where;\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 checkRuleAgainstLens,\n type Lens,\n type LensNarrowing,\n validateRule,\n} from '@inixiative/json-rules';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type ValidationIssue = { path: string; message: string };\nexport type ValidationResult = { ok: boolean; errors: ValidationIssue[] };\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,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n const result = validateRule(predicate);\n for (const issue of result.errors)\n errors.push({ path: `${path}.${issue.path}`, message: issue.message });\n if (lens) {\n const lensCheck = checkRuleAgainstLens(predicate, lens);\n for (const violation of lensCheck.violations)\n errors.push({ path: `${path}.${violation.path}`, message: violation.reason });\n }\n};\n\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined || rule === null || typeof rule === 'string') return;\n if ('rule' in rule) {\n const result = validateRule(rule.rule);\n for (const issue of result.errors)\n errors.push({ path: `${path}.rule.${issue.path}`, message: issue.message });\n return;\n }\n if ('rel' in rule) {\n if (!rule.rel || !rule.action)\n errors.push({ path, message: 'rel-rule requires non-empty `rel` and `action`' });\n return;\n }\n if ('self' in rule) {\n if (!rule.self) errors.push({ path, message: 'self-rule requires a non-empty field name' });\n return;\n }\n if ('any' in rule) {\n rule.any.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.any[${i}]`);\n });\n return;\n }\n if ('all' in rule) {\n rule.all.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.all[${i}]`);\n });\n return;\n }\n errors.push({ path, message: 'unrecognized ActionRule shape' });\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}\"` });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"` });\n else if (!merge.path) errors.push({ path, message: `merge \"${merge.kind}\" requires a \\`path\\`` });\n};\n\nconst validateSide = (\n side: Side | ToSide,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\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 });\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 * Predicate validity delegates to json-rules (`validateRule`, plus `checkRuleAgainstLens` when a\n * `lens` is supplied for field/relation scoping); merge strategy and permission shape are 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 });\n return { ok: errors.length === 0, errors };\n};\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/merge.ts","../src/check.ts","../src/describe.ts","../src/rebac/authorize.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","record","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","rule","actor","checkPath","transition","options","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","i","evaluate","ctx","model","visited","schemaRule","rowRule","segments","current","currentModel","segment","related","key","actorId","sub","makeRebacAuthorize","rest","createRebac","getAction","rules","resource","action","found","checkTransition","paths","available","actions","allows","rec","eligible","steps","toPrisma","last","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","predicate","errors","lens","validateRule","issue","lensCheck","checkRuleAgainstLens","violation","validatePermission","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.cjs","sourcesContent":["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 AuthorizeOptions,\n PathReason,\n Row,\n SideReason,\n Transition,\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 */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: AuthorizeOptions = {},\n): true | PathReason => {\n const { actor, authorize } = 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);\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);\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 { check as checkRule } from '@inixiative/json-rules';\nimport type { ActionRule, Actor, Authorize, Row } from '../types';\nimport type { RebacOptions, RebacSchema } from './types';\n\ntype Context = {\n schema: RebacSchema;\n resolveModel?: (model: string, relationSegment: string) => string;\n isSuperadmin?: (actor: Actor) => boolean;\n};\n\nconst evaluate = (\n ctx: Context,\n model: string,\n record: Row,\n actor: Actor,\n rule: ActionRule,\n visited: Set<string>,\n): boolean => {\n if (ctx.isSuperadmin?.(actor)) return true;\n if (rule === null) return false;\n\n // string → delegate to the named action on this model, additively merged with any per-row override.\n if (typeof rule === 'string') {\n const schemaRule = ctx.schema[model]?.actions[rule] ?? null;\n const rowRules = record.permissionRules as Record<string, ActionRule> | null | undefined;\n const rowRule = rowRules?.[rule];\n const merged: ActionRule = rowRule !== undefined ? { any: [schemaRule, rowRule] } : schemaRule;\n return evaluate(ctx, model, record, actor, merged, visited);\n }\n\n // { rel, action } → walk the relation (dot-paths supported), then check `action` on the target.\n if ('rel' in rule && 'action' in rule) {\n const segments = rule.rel.split('.');\n let current: Row = record;\n let currentModel = model;\n for (const segment of segments) {\n const related = current[segment] as Row | null | undefined;\n if (!related) return false;\n currentModel = ctx.resolveModel ? ctx.resolveModel(currentModel, segment) : segment;\n current = related;\n }\n const key = `${currentModel}:${String(current.id)}:${rule.action}`;\n if (visited.has(key)) throw new Error(`Cycle detected in permission graph: ${key}`);\n visited.add(key);\n return evaluate(ctx, currentModel, current, actor, rule.action, visited);\n }\n\n // { self } → record[field] matches the current actor.\n if ('self' in rule) {\n const actorId = actor?.id ?? null;\n return actorId !== null && record[rule.self] === actorId;\n }\n\n // { rule } → ABAC predicate (json-rules) over the record.\n if ('rule' in rule) return checkRule(rule.rule, record) === true;\n\n // Fork `visited` per branch — parallel paths through any/all aren't cycles.\n if ('any' in rule)\n return rule.any.some((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n if ('all' in rule)\n return rule.all.every((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n\n return false;\n};\n\n/**\n * A reference rebac evaluator — one implementation of the injected {@link Authorize} seam,\n * bound to a single `model`. Faithful to `@template/permissions`' `rebac/check` (string-delegate,\n * relation walk with cycle detection, self, json-rules `{ rule }`, any/all, per-row\n * `permissionRules` override) but standalone. Swap it for a richer authorizer in production;\n * this is slated to graduate into `@inixiative/permissions`.\n */\nexport const makeRebacAuthorize = (options: RebacOptions & { model: string }): Authorize => {\n const { model, ...rest } = options;\n return (rule, record, actor) => evaluate(rest, model, record, actor, rule, new Set());\n};\n\n/** Curried form: `createRebac({ schema })(model)` → an {@link Authorize} for that model. */\nexport const createRebac =\n (options: RebacOptions) =>\n (model: string): Authorize =>\n makeRebacAuthorize({ ...options, model });\n","import { check as checkRule, toPrisma } from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n AuthorizeOptions,\n CheckResult,\n PathReason,\n Row,\n TransitionMap,\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: AuthorizeOptions = {},\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: AuthorizeOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize } = 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) === true && allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n/**\n * Set query: one OR'd Prisma `where` matching every record currently eligible for `action`\n * (the union of all its paths' `from` predicates). Empty action → match-nothing.\n */\nexport const eligible = (rules: TransitionMap, resource: string, action: string): Row => {\n const found = getAction(rules, resource, action);\n const { steps } = toPrisma({ any: found.paths.map((path) => path.from.predicate) });\n // json-rules guarantees the last step is the WhereStep. Assert it loudly rather than cast-and-swallow:\n // a silent `{}` fallback would mean match-EVERYTHING — the dangerous inverse of match-nothing.\n const last = steps[steps.length - 1] as { operation?: string; where?: Row } | undefined;\n if (last?.operation !== 'where' || last.where === undefined)\n throw new Error('transition: expected a terminal WhereStep from toPrisma; got none');\n return last.where;\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 checkRuleAgainstLens,\n type Lens,\n type LensNarrowing,\n validateRule,\n} from '@inixiative/json-rules';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type ValidationIssue = { path: string; message: string };\nexport type ValidationResult = { ok: boolean; errors: ValidationIssue[] };\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,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n const result = validateRule(predicate);\n for (const issue of result.errors)\n errors.push({ path: `${path}.${issue.path}`, message: issue.message });\n if (lens) {\n const lensCheck = checkRuleAgainstLens(predicate, lens);\n for (const violation of lensCheck.violations)\n errors.push({ path: `${path}.${violation.path}`, message: violation.reason });\n }\n};\n\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined || rule === null || typeof rule === 'string') return;\n if ('rule' in rule) {\n const result = validateRule(rule.rule);\n for (const issue of result.errors)\n errors.push({ path: `${path}.rule.${issue.path}`, message: issue.message });\n return;\n }\n if ('rel' in rule) {\n if (!rule.rel || !rule.action)\n errors.push({ path, message: 'rel-rule requires non-empty `rel` and `action`' });\n return;\n }\n if ('self' in rule) {\n if (!rule.self) errors.push({ path, message: 'self-rule requires a non-empty field name' });\n return;\n }\n if ('any' in rule) {\n rule.any.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.any[${i}]`);\n });\n return;\n }\n if ('all' in rule) {\n rule.all.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.all[${i}]`);\n });\n return;\n }\n errors.push({ path, message: 'unrecognized ActionRule shape' });\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}\"` });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"` });\n else if (!merge.path) errors.push({ path, message: `merge \"${merge.kind}\" requires a \\`path\\`` });\n};\n\nconst validateSide = (\n side: Side | ToSide,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\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 });\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 * Predicate validity delegates to json-rules (`validateRule`, plus `checkRuleAgainstLens` when a\n * `lens` is supplied for field/relation scoping); merge strategy and permission shape are 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 });\n return { ok: errors.length === 0, errors };\n};\n"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -2,16 +2,10 @@ import { Condition, Lens, LensNarrowing } from '@inixiative/json-rules';
|
|
|
2
2
|
|
|
3
3
|
type Row = Record<string, unknown>;
|
|
4
4
|
/**
|
|
5
|
-
* The serializable permission algebra.
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
* identical to the rebac `ActionRule` used by `@template/permissions`, so a permission
|
|
10
|
-
* rule authored over there deserializes into a transition's `permission` field unchanged.
|
|
11
|
-
*
|
|
12
|
-
* The kernel never *interprets* an ActionRule; it hands the rule to an injected
|
|
13
|
-
* {@link Authorize} callback. Resolving `string` (delegate) and `{ rel, action }`
|
|
14
|
-
* (relation walk) requires a model + schema, which lives in the authorizer, not here.
|
|
5
|
+
* The serializable permission algebra. Re-declared here (not imported from any app's
|
|
6
|
+
* permissions package) so this stays a zero-app-dependency primitive; structurally identical
|
|
7
|
+
* to `@template/permissions`' rebac `ActionRule`. The kernel never interprets it — it hands the
|
|
8
|
+
* rule to an injected {@link Authorize} callback.
|
|
15
9
|
*/
|
|
16
10
|
type ActionRule = string | {
|
|
17
11
|
rel: string;
|
|
@@ -29,10 +23,8 @@ type Actor = ({
|
|
|
29
23
|
id?: string | null;
|
|
30
24
|
} & Row) | null | undefined;
|
|
31
25
|
/**
|
|
32
|
-
* Injected permission evaluator. Model-free
|
|
33
|
-
*
|
|
34
|
-
* {@link makeRebacAuthorize} for the reference implementation). Returns a bare boolean —
|
|
35
|
-
* authz is yes/no; the structured-reason machinery lives in the kernel.
|
|
26
|
+
* Injected permission evaluator. Model-free: the kernel knows nothing about models or schemas,
|
|
27
|
+
* so the consumer closes over whatever its rebac needs (see {@link makeRebacAuthorize}).
|
|
36
28
|
*/
|
|
37
29
|
type Authorize = (rule: ActionRule, record: Row, actor: Actor) => boolean;
|
|
38
30
|
/** Serializable merge keywords (Mongo-flavored). Array strategies are field-scoped. */
|
|
@@ -48,9 +40,9 @@ type Merge<R extends Row = Row> = ((record: R, changes: Partial<R>) => R) | Merg
|
|
|
48
40
|
/** Prisma-include-shaped metadata: the relations a side's predicate reads. Kernel ignores it. */
|
|
49
41
|
type Include = Record<string, unknown>;
|
|
50
42
|
/**
|
|
51
|
-
* One half of a transition. `predicate` (legality) and `permission` (authz) are evaluated
|
|
52
|
-
* against the SAME record —
|
|
53
|
-
*
|
|
43
|
+
* One half of a transition. `predicate` (legality) and `permission` (authz) are both evaluated
|
|
44
|
+
* against the SAME record — the load-bearing asymmetry is WHICH record: `from.*` reads the
|
|
45
|
+
* CURRENT record, `to.*` reads the RESULTING (merged) record.
|
|
54
46
|
*/
|
|
55
47
|
type Side = {
|
|
56
48
|
predicate: Condition;
|
|
@@ -66,59 +58,47 @@ type Transition<R extends Row = Row> = {
|
|
|
66
58
|
to: ToSide<R>;
|
|
67
59
|
};
|
|
68
60
|
/**
|
|
69
|
-
* A named verb: the OR of its edges. An object (not a bare `Transition[]`)
|
|
70
|
-
*
|
|
71
|
-
*
|
|
61
|
+
* A named verb: the OR of its edges. An object (not a bare `Transition[]`) so the action can
|
|
62
|
+
* carry affordance metadata (`label`). Authorization lives on the per-side `permission`s, which
|
|
63
|
+
* always read a concrete record — there is no record-free action-level permission.
|
|
72
64
|
*/
|
|
73
65
|
type Action<R extends Row = Row> = {
|
|
74
66
|
paths: Transition<R>[];
|
|
75
|
-
permission?: ActionRule;
|
|
76
67
|
label?: string;
|
|
77
68
|
};
|
|
78
|
-
/** `
|
|
69
|
+
/** `resource → action → Action`, where `resource` is the (map-qualified) key — e.g. `db:Inquiry`,
|
|
70
|
+
* matching `@inixiative/permissions`' rebac schema keys so a transition's `permission` resolves
|
|
71
|
+
* against the same resource identity. */
|
|
79
72
|
type TransitionMap = Record<string, Record<string, Action>>;
|
|
80
|
-
|
|
81
|
-
type
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
to?: string;
|
|
85
|
-
authz?: AuthzLevel;
|
|
73
|
+
/** Why one side failed. Both keys are independent; either, both, or neither may be set. */
|
|
74
|
+
type SideReason = {
|
|
75
|
+
predicate?: string;
|
|
76
|
+
permission?: string;
|
|
86
77
|
};
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
78
|
+
/** Why one candidate path failed — `from` and `to` reported separately. */
|
|
79
|
+
type PathReason = {
|
|
80
|
+
from?: SideReason;
|
|
81
|
+
to?: SideReason;
|
|
90
82
|
};
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
} | {
|
|
95
|
-
ok: false;
|
|
96
|
-
reason: Reason;
|
|
83
|
+
/** Why an action failed: one {@link PathReason} per candidate path that was tried. */
|
|
84
|
+
type Reason = {
|
|
85
|
+
paths: PathReason[];
|
|
97
86
|
};
|
|
87
|
+
/** `true` when the transition is allowed, else a structured {@link Reason}. */
|
|
88
|
+
type CheckResult = true | Reason;
|
|
98
89
|
/** Options threaded into a check. Omit `authorize` to evaluate legality only. */
|
|
99
|
-
type CheckOptions = {
|
|
100
|
-
actor?: Actor;
|
|
101
|
-
authorize?: Authorize;
|
|
102
|
-
/** Action-level baseline permission, ANDed against the current record (supplied by the registry). */
|
|
103
|
-
basePermission?: ActionRule;
|
|
104
|
-
};
|
|
105
|
-
/** Options for affordance/check at the registry level. */
|
|
106
90
|
type AuthorizeOptions = {
|
|
107
91
|
actor?: Actor;
|
|
108
92
|
authorize?: Authorize;
|
|
109
93
|
};
|
|
110
94
|
|
|
111
95
|
/**
|
|
112
|
-
* The kernel: evaluate one atomic
|
|
113
|
-
*
|
|
114
|
-
*
|
|
115
|
-
* `
|
|
116
|
-
* action baseline → from → to, all ANDed. Returns a structured {@link CheckResult} whose
|
|
117
|
-
* `reason.kind` lets a caller map illegal → 409 vs unauthorized → 403.
|
|
118
|
-
*
|
|
119
|
-
* Omit `options.authorize` to check legality only.
|
|
96
|
+
* The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —
|
|
97
|
+
* `from`/`to` and predicate/permission are independent slots — so a caller sees the whole
|
|
98
|
+
* picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns
|
|
99
|
+
* `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only.
|
|
120
100
|
*/
|
|
121
|
-
declare const
|
|
101
|
+
declare const checkPath: <R extends Row>(transition: Transition<R>, record: R, changes?: Partial<R>, options?: AuthorizeOptions) => true | PathReason;
|
|
122
102
|
|
|
123
103
|
/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */
|
|
124
104
|
declare const describe: (reason: Reason) => string;
|
|
@@ -167,22 +147,26 @@ declare const makeRebacAuthorize: (options: RebacOptions & {
|
|
|
167
147
|
declare const createRebac: (options: RebacOptions) => (model: string) => Authorize;
|
|
168
148
|
|
|
169
149
|
/**
|
|
170
|
-
* Authoritative check: the FIRST path whose `from` matches the current record, whose `to`
|
|
171
|
-
*
|
|
172
|
-
*
|
|
150
|
+
* Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches
|
|
151
|
+
* the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a
|
|
152
|
+
* {@link Reason} with one {@link PathReason} per candidate path tried.
|
|
153
|
+
*
|
|
154
|
+
* `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`
|
|
155
|
+
* checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound
|
|
156
|
+
* to this resource); a `predicate` that reads a bridged relation expects a stitched record.
|
|
173
157
|
*/
|
|
174
|
-
declare const
|
|
158
|
+
declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: AuthorizeOptions) => CheckResult;
|
|
175
159
|
/**
|
|
176
|
-
* Affordance hint: which
|
|
177
|
-
*
|
|
178
|
-
*
|
|
160
|
+
* Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`
|
|
161
|
+
* side (predicate + `from` permission against the current record) — `to` needs the merged record,
|
|
162
|
+
* which doesn't exist without proposed changes, so it defers to {@link checkTransition}.
|
|
179
163
|
*/
|
|
180
|
-
declare const available: (
|
|
164
|
+
declare const available: (rules: TransitionMap, resource: string, record: Row, options?: AuthorizeOptions) => string[];
|
|
181
165
|
/**
|
|
182
|
-
* Set query: one OR'd Prisma `where` matching every record currently eligible for `
|
|
166
|
+
* Set query: one OR'd Prisma `where` matching every record currently eligible for `action`
|
|
183
167
|
* (the union of all its paths' `from` predicates). Empty action → match-nothing.
|
|
184
168
|
*/
|
|
185
|
-
declare const eligible: (
|
|
169
|
+
declare const eligible: (rules: TransitionMap, resource: string, action: string) => Row;
|
|
186
170
|
|
|
187
171
|
/**
|
|
188
172
|
* Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?
|
|
@@ -213,4 +197,4 @@ type ValidateOptions = {
|
|
|
213
197
|
*/
|
|
214
198
|
declare const validateTransition: (transition: Transition, options?: ValidateOptions) => ValidationResult;
|
|
215
199
|
|
|
216
|
-
export { type Action, type ActionRule, type Actor, type Authorize, type AuthorizeOptions, type
|
|
200
|
+
export { type Action, type ActionRule, type Actor, type Authorize, type AuthorizeOptions, type CheckResult, type Include, type Merge, type MergeStrategy, type ModelPermission, type PathReason, type Reason, type RebacOptions, type RebacSchema, type Row, type Side, type SideReason, type ToSide, type Transition, type TransitionMap, type ValidateOptions, type ValidationIssue, type ValidationResult, applyMerge, available, checkPath, checkTransition, createRebac, describe, eligible, isSerializable, isSerializableMerge, makeRebacAuthorize, validateTransition };
|
package/dist/index.d.ts
CHANGED
|
@@ -2,16 +2,10 @@ import { Condition, Lens, LensNarrowing } from '@inixiative/json-rules';
|
|
|
2
2
|
|
|
3
3
|
type Row = Record<string, unknown>;
|
|
4
4
|
/**
|
|
5
|
-
* The serializable permission algebra.
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
* identical to the rebac `ActionRule` used by `@template/permissions`, so a permission
|
|
10
|
-
* rule authored over there deserializes into a transition's `permission` field unchanged.
|
|
11
|
-
*
|
|
12
|
-
* The kernel never *interprets* an ActionRule; it hands the rule to an injected
|
|
13
|
-
* {@link Authorize} callback. Resolving `string` (delegate) and `{ rel, action }`
|
|
14
|
-
* (relation walk) requires a model + schema, which lives in the authorizer, not here.
|
|
5
|
+
* The serializable permission algebra. Re-declared here (not imported from any app's
|
|
6
|
+
* permissions package) so this stays a zero-app-dependency primitive; structurally identical
|
|
7
|
+
* to `@template/permissions`' rebac `ActionRule`. The kernel never interprets it — it hands the
|
|
8
|
+
* rule to an injected {@link Authorize} callback.
|
|
15
9
|
*/
|
|
16
10
|
type ActionRule = string | {
|
|
17
11
|
rel: string;
|
|
@@ -29,10 +23,8 @@ type Actor = ({
|
|
|
29
23
|
id?: string | null;
|
|
30
24
|
} & Row) | null | undefined;
|
|
31
25
|
/**
|
|
32
|
-
* Injected permission evaluator. Model-free
|
|
33
|
-
*
|
|
34
|
-
* {@link makeRebacAuthorize} for the reference implementation). Returns a bare boolean —
|
|
35
|
-
* authz is yes/no; the structured-reason machinery lives in the kernel.
|
|
26
|
+
* Injected permission evaluator. Model-free: the kernel knows nothing about models or schemas,
|
|
27
|
+
* so the consumer closes over whatever its rebac needs (see {@link makeRebacAuthorize}).
|
|
36
28
|
*/
|
|
37
29
|
type Authorize = (rule: ActionRule, record: Row, actor: Actor) => boolean;
|
|
38
30
|
/** Serializable merge keywords (Mongo-flavored). Array strategies are field-scoped. */
|
|
@@ -48,9 +40,9 @@ type Merge<R extends Row = Row> = ((record: R, changes: Partial<R>) => R) | Merg
|
|
|
48
40
|
/** Prisma-include-shaped metadata: the relations a side's predicate reads. Kernel ignores it. */
|
|
49
41
|
type Include = Record<string, unknown>;
|
|
50
42
|
/**
|
|
51
|
-
* One half of a transition. `predicate` (legality) and `permission` (authz) are evaluated
|
|
52
|
-
* against the SAME record —
|
|
53
|
-
*
|
|
43
|
+
* One half of a transition. `predicate` (legality) and `permission` (authz) are both evaluated
|
|
44
|
+
* against the SAME record — the load-bearing asymmetry is WHICH record: `from.*` reads the
|
|
45
|
+
* CURRENT record, `to.*` reads the RESULTING (merged) record.
|
|
54
46
|
*/
|
|
55
47
|
type Side = {
|
|
56
48
|
predicate: Condition;
|
|
@@ -66,59 +58,47 @@ type Transition<R extends Row = Row> = {
|
|
|
66
58
|
to: ToSide<R>;
|
|
67
59
|
};
|
|
68
60
|
/**
|
|
69
|
-
* A named verb: the OR of its edges. An object (not a bare `Transition[]`)
|
|
70
|
-
*
|
|
71
|
-
*
|
|
61
|
+
* A named verb: the OR of its edges. An object (not a bare `Transition[]`) so the action can
|
|
62
|
+
* carry affordance metadata (`label`). Authorization lives on the per-side `permission`s, which
|
|
63
|
+
* always read a concrete record — there is no record-free action-level permission.
|
|
72
64
|
*/
|
|
73
65
|
type Action<R extends Row = Row> = {
|
|
74
66
|
paths: Transition<R>[];
|
|
75
|
-
permission?: ActionRule;
|
|
76
67
|
label?: string;
|
|
77
68
|
};
|
|
78
|
-
/** `
|
|
69
|
+
/** `resource → action → Action`, where `resource` is the (map-qualified) key — e.g. `db:Inquiry`,
|
|
70
|
+
* matching `@inixiative/permissions`' rebac schema keys so a transition's `permission` resolves
|
|
71
|
+
* against the same resource identity. */
|
|
79
72
|
type TransitionMap = Record<string, Record<string, Action>>;
|
|
80
|
-
|
|
81
|
-
type
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
to?: string;
|
|
85
|
-
authz?: AuthzLevel;
|
|
73
|
+
/** Why one side failed. Both keys are independent; either, both, or neither may be set. */
|
|
74
|
+
type SideReason = {
|
|
75
|
+
predicate?: string;
|
|
76
|
+
permission?: string;
|
|
86
77
|
};
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
78
|
+
/** Why one candidate path failed — `from` and `to` reported separately. */
|
|
79
|
+
type PathReason = {
|
|
80
|
+
from?: SideReason;
|
|
81
|
+
to?: SideReason;
|
|
90
82
|
};
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
} | {
|
|
95
|
-
ok: false;
|
|
96
|
-
reason: Reason;
|
|
83
|
+
/** Why an action failed: one {@link PathReason} per candidate path that was tried. */
|
|
84
|
+
type Reason = {
|
|
85
|
+
paths: PathReason[];
|
|
97
86
|
};
|
|
87
|
+
/** `true` when the transition is allowed, else a structured {@link Reason}. */
|
|
88
|
+
type CheckResult = true | Reason;
|
|
98
89
|
/** Options threaded into a check. Omit `authorize` to evaluate legality only. */
|
|
99
|
-
type CheckOptions = {
|
|
100
|
-
actor?: Actor;
|
|
101
|
-
authorize?: Authorize;
|
|
102
|
-
/** Action-level baseline permission, ANDed against the current record (supplied by the registry). */
|
|
103
|
-
basePermission?: ActionRule;
|
|
104
|
-
};
|
|
105
|
-
/** Options for affordance/check at the registry level. */
|
|
106
90
|
type AuthorizeOptions = {
|
|
107
91
|
actor?: Actor;
|
|
108
92
|
authorize?: Authorize;
|
|
109
93
|
};
|
|
110
94
|
|
|
111
95
|
/**
|
|
112
|
-
* The kernel: evaluate one atomic
|
|
113
|
-
*
|
|
114
|
-
*
|
|
115
|
-
* `
|
|
116
|
-
* action baseline → from → to, all ANDed. Returns a structured {@link CheckResult} whose
|
|
117
|
-
* `reason.kind` lets a caller map illegal → 409 vs unauthorized → 403.
|
|
118
|
-
*
|
|
119
|
-
* Omit `options.authorize` to check legality only.
|
|
96
|
+
* The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —
|
|
97
|
+
* `from`/`to` and predicate/permission are independent slots — so a caller sees the whole
|
|
98
|
+
* picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns
|
|
99
|
+
* `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only.
|
|
120
100
|
*/
|
|
121
|
-
declare const
|
|
101
|
+
declare const checkPath: <R extends Row>(transition: Transition<R>, record: R, changes?: Partial<R>, options?: AuthorizeOptions) => true | PathReason;
|
|
122
102
|
|
|
123
103
|
/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */
|
|
124
104
|
declare const describe: (reason: Reason) => string;
|
|
@@ -167,22 +147,26 @@ declare const makeRebacAuthorize: (options: RebacOptions & {
|
|
|
167
147
|
declare const createRebac: (options: RebacOptions) => (model: string) => Authorize;
|
|
168
148
|
|
|
169
149
|
/**
|
|
170
|
-
* Authoritative check: the FIRST path whose `from` matches the current record, whose `to`
|
|
171
|
-
*
|
|
172
|
-
*
|
|
150
|
+
* Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches
|
|
151
|
+
* the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a
|
|
152
|
+
* {@link Reason} with one {@link PathReason} per candidate path tried.
|
|
153
|
+
*
|
|
154
|
+
* `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`
|
|
155
|
+
* checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound
|
|
156
|
+
* to this resource); a `predicate` that reads a bridged relation expects a stitched record.
|
|
173
157
|
*/
|
|
174
|
-
declare const
|
|
158
|
+
declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: AuthorizeOptions) => CheckResult;
|
|
175
159
|
/**
|
|
176
|
-
* Affordance hint: which
|
|
177
|
-
*
|
|
178
|
-
*
|
|
160
|
+
* Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`
|
|
161
|
+
* side (predicate + `from` permission against the current record) — `to` needs the merged record,
|
|
162
|
+
* which doesn't exist without proposed changes, so it defers to {@link checkTransition}.
|
|
179
163
|
*/
|
|
180
|
-
declare const available: (
|
|
164
|
+
declare const available: (rules: TransitionMap, resource: string, record: Row, options?: AuthorizeOptions) => string[];
|
|
181
165
|
/**
|
|
182
|
-
* Set query: one OR'd Prisma `where` matching every record currently eligible for `
|
|
166
|
+
* Set query: one OR'd Prisma `where` matching every record currently eligible for `action`
|
|
183
167
|
* (the union of all its paths' `from` predicates). Empty action → match-nothing.
|
|
184
168
|
*/
|
|
185
|
-
declare const eligible: (
|
|
169
|
+
declare const eligible: (rules: TransitionMap, resource: string, action: string) => Row;
|
|
186
170
|
|
|
187
171
|
/**
|
|
188
172
|
* Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?
|
|
@@ -213,4 +197,4 @@ type ValidateOptions = {
|
|
|
213
197
|
*/
|
|
214
198
|
declare const validateTransition: (transition: Transition, options?: ValidateOptions) => ValidationResult;
|
|
215
199
|
|
|
216
|
-
export { type Action, type ActionRule, type Actor, type Authorize, type AuthorizeOptions, type
|
|
200
|
+
export { type Action, type ActionRule, type Actor, type Authorize, type AuthorizeOptions, type CheckResult, type Include, type Merge, type MergeStrategy, type ModelPermission, type PathReason, type Reason, type RebacOptions, type RebacSchema, type Row, type Side, type SideReason, type ToSide, type Transition, type TransitionMap, type ValidateOptions, type ValidationIssue, type ValidationResult, applyMerge, available, checkPath, checkTransition, createRebac, describe, eligible, isSerializable, isSerializableMerge, makeRebacAuthorize, validateTransition };
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import {check,toPrisma,validateRule,checkRuleAgainstLens}from'@inixiative/json-rules';import {mergeWith,cloneDeep,get,set,uniqWith,isEqual}from'lodash-es';var
|
|
1
|
+
import {check,toPrisma,validateRule,checkRuleAgainstLens}from'@inixiative/json-rules';import {mergeWith,cloneDeep,get,set,uniqWith,isEqual}from'lodash-es';var h=e=>Array.isArray(e)?e:e===void 0?[]:[e],O=(e,t)=>Array.isArray(t)?t:void 0,m=e=>typeof e!="function",y=(e,t,n={})=>{if(typeof e=="function")return e(t,n);let i=e??"spread";if(i==="spread")return {...t,...n};if(i==="deepMerge")return mergeWith(cloneDeep(t),cloneDeep(n),O);let{kind:o,path:r}=i,s=cloneDeep({...t,...n}),a=[...h(get(t,r)),...h(get(n,r))];return set(s,r,o==="appendUnique"?uniqWith(a,isEqual):a),s};var A=e=>typeof e=="string"?e:"predicate not satisfied",b=(e,t,n,i)=>!e||t===void 0?false:!e(t,n,i),k=(e,t,n={},i={})=>{let{actor:o,authorize:r}=i,s=y(e.to.merge,t,n),a={},p=check(e.from.predicate,t);p!==true&&(a.predicate=A(p)),b(r,e.from.permission,t,o)&&(a.permission="not authorized");let f={},c=check(e.to.predicate,s);c!==true&&(f.predicate=A(c)),b(r,e.to.permission,s,o)&&(f.permission="not authorized");let u={};return (a.predicate||a.permission)&&(u.from=a),(f.predicate||f.permission)&&(u.to=f),u.from||u.to?u:true};var S=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"},G=e=>e.paths.length===0?"no transition path available":e.paths.length===1?S(e.paths[0]):e.paths.map((t,n)=>`path ${n}: ${S(t)}`).join(" | ");var l=(e,t,n,i,o,r)=>{if(e.isSuperadmin?.(i))return true;if(o===null)return false;if(typeof o=="string"){let s=e.schema[t]?.actions[o]??null,p=n.permissionRules?.[o];return l(e,t,n,i,p!==void 0?{any:[s,p]}:s,r)}if("rel"in o&&"action"in o){let s=o.rel.split("."),a=n,p=t;for(let c of s){let u=a[c];if(!u)return false;p=e.resolveModel?e.resolveModel(p,c):c,a=u;}let f=`${p}:${String(a.id)}:${o.action}`;if(r.has(f))throw new Error(`Cycle detected in permission graph: ${f}`);return r.add(f),l(e,p,a,i,o.action,r)}if("self"in o){let s=i?.id??null;return s!==null&&n[o.self]===s}return "rule"in o?check(o.rule,n)===true:"any"in o?o.any.some(s=>l(e,t,n,i,s,new Set(r))):"all"in o?o.all.every(s=>l(e,t,n,i,s,new Set(r))):false},v=e=>{let{model:t,...n}=e;return (i,o,r)=>l(n,t,o,r,i,new Set)},H=e=>t=>v({...e,model:t});var $=(e,t,n)=>{let i=e[t]?.[n];if(!i)throw new Error(`transition: no action "${n}" registered on resource "${t}"`);return i},te=(e,t,n,i,o={},r={})=>{let s=$(e,t,n),a=[];for(let p of s.paths){let f=k(p,i,o,r);if(f===true)return true;a.push(f);}return {paths:a}},ne=(e,t,n,i={})=>{let o=e[t];if(!o)return [];let{actor:r,authorize:s}=i,a=(p,f)=>!s||p===void 0||s(p,f,r);return Object.entries(o).filter(([,p])=>p.paths.some(f=>check(f.from.predicate,n)===true&&a(f.from.permission,n))).map(([p])=>p)},oe=(e,t,n)=>{let i=$(e,t,n),{steps:o}=toPrisma({any:i.paths.map(s=>s.from.predicate)}),r=o[o.length-1];if(r?.operation!=="where"||r.where===void 0)throw new Error("transition: expected a terminal WhereStep from toPrisma; got none");return r.where};var se=e=>m(e.to.merge);var L=new Set(["spread","deepMerge"]),j=new Set(["append","appendUnique"]),N=(e,t,n,i)=>{let o=validateRule(e);for(let r of o.errors)t.push({path:`${n}.${r.path}`,message:r.message});if(i){let r=checkRuleAgainstLens(e,i);for(let s of r.violations)t.push({path:`${n}.${s.path}`,message:s.reason});}},g=(e,t,n)=>{if(!(e==null||typeof e=="string")){if("rule"in e){let i=validateRule(e.rule);for(let o of i.errors)t.push({path:`${n}.rule.${o.path}`,message:o.message});return}if("rel"in e){(!e.rel||!e.action)&&t.push({path:n,message:"rel-rule requires non-empty `rel` and `action`"});return}if("self"in e){e.self||t.push({path:n,message:"self-rule requires a non-empty field name"});return}if("any"in e){e.any.forEach((i,o)=>{g(i,t,`${n}.any[${o}]`);});return}if("all"in e){e.all.forEach((i,o)=>{g(i,t,`${n}.all[${o}]`);});return}t.push({path:n,message:"unrecognized ActionRule shape"});}},W=(e,t,n)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){L.has(e)||t.push({path:n,message:`unknown merge strategy "${e}"`});return}j.has(e.kind)?e.path||t.push({path:n,message:`merge "${e.kind}" requires a \`path\``}):t.push({path:n,message:`unknown merge kind "${e.kind}"`});}},M=(e,t,n,i)=>{N(e.predicate,t,`${n}.predicate`,i.lens),g(e.permission,t,`${n}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${n}.requires`,message:"`requires` must be a Prisma-include-shaped object"}),"merge"in e&&W(e.merge,t,`${n}.merge`);},ue=(e,t={})=>{let n=[];return M(e.from,n,"from",t),M(e.to,n,"to",t),t.requireSerializable&&!m(e.to.merge)&&n.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy"}),{ok:n.length===0,errors:n}};export{y as applyMerge,ne as available,k as checkPath,te as checkTransition,H as createRebac,G as describe,oe as eligible,se as isSerializable,m as isSerializableMerge,v as makeRebacAuthorize,ue 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/merge.ts","../src/check.ts","../src/describe.ts","../src/rebac/authorize.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","record","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","reasonString","result","denies","authorize","rule","actor","checkTransition","transition","options","basePermission","next","fromResult","checkRule","toResult","describe","reason","evaluate","ctx","model","visited","schemaRule","rowRule","segments","current","currentModel","segment","related","key","actorId","sub","makeRebacAuthorize","rest","createRebac","getAction","map","verb","action","aggregate","failures","paths","_kind","_paths","pick","failure","chosen","_omit","representative","check","opts","available","actions","allows","rec","eligible","steps","toPrisma","last","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","predicate","errors","lens","validateRule","issue","lensCheck","checkRuleAgainstLens","violation","validatePermission","i","validateMerge","validateSide","side","validateTransition"],"mappings":"2JAGA,IAAMA,CAAAA,CAAWC,CAAAA,EACf,MAAM,OAAA,CAAQA,CAAK,CAAA,CAAIA,CAAAA,CAAQA,IAAU,MAAA,CAAY,EAAC,CAAI,CAACA,CAAK,CAAA,CAG5DC,CAAAA,CAAgB,CAACC,CAAAA,CAAkBC,IACvC,KAAA,CAAM,OAAA,CAAQA,CAAM,CAAA,CAAIA,EAAS,MAAA,CAGtBC,CAAAA,CAAuBC,CAAAA,EAA2B,OAAOA,GAAU,UAAA,CAWnEC,CAAAA,CAAa,CACxBD,CAAAA,CACAE,EACAC,CAAAA,CAAsB,EAAC,GACjB,CACN,GAAI,OAAOH,CAAAA,EAAU,UAAA,CAAY,OAAOA,EAAME,CAAAA,CAAQC,CAAO,CAAA,CAE7D,IAAMC,EAA0BJ,CAAAA,EAAS,QAAA,CAEzC,GAAII,CAAAA,GAAa,SAAU,OAAO,CAAE,GAAGF,CAAAA,CAAQ,GAAGC,CAAQ,CAAA,CAG1D,GAAIC,CAAAA,GAAa,WAAA,CACf,OAAOC,SAAAA,CAAUC,SAAAA,CAAUJ,CAAM,CAAA,CAAGI,UAAUH,CAAO,CAAA,CAAGP,CAAa,CAAA,CAGvE,GAAM,CAAE,IAAA,CAAAW,CAAAA,CAAM,IAAA,CAAAC,CAAK,CAAA,CAAIJ,CAAAA,CACjBK,CAAAA,CAAOH,SAAAA,CAAU,CAAE,GAAGJ,CAAAA,CAAQ,GAAGC,CAAQ,CAAC,CAAA,CAC1CO,CAAAA,CAAS,CAAC,GAAGhB,EAAQiB,GAAAA,CAAIT,CAAAA,CAAQM,CAAI,CAAC,EAAG,GAAGd,CAAAA,CAAQiB,GAAAA,CAAIR,CAAAA,CAASK,CAAI,CAAC,CAAC,CAAA,CAC7E,OAAAI,IAAIH,CAAAA,CAAaD,CAAAA,CAAMD,CAAAA,GAAS,cAAA,CAAiBM,SAASH,CAAAA,CAAQI,OAAO,CAAA,CAAIJ,CAAM,EAC5ED,CACT,EC/BA,IAAMM,CAAAA,CAAgBC,GACpB,OAAOA,CAAAA,EAAW,QAAA,CAAWA,CAAAA,CAAS,0BAQlCC,CAAAA,CAAS,CACbC,CAAAA,CACAC,CAAAA,CACAjB,EACAkB,CAAAA,GAEI,CAACF,GAAaC,CAAAA,GAAS,MAAA,CAAkB,MACtC,CAACD,CAAAA,CAAUC,CAAAA,CAAMjB,CAAAA,CAAQkB,CAAK,CAAA,CAa1BC,CAAAA,CAAkB,CAC7BC,CAAAA,CACApB,EACAC,CAAAA,CAAsB,EAAC,CACvBoB,CAAAA,CAAwB,EAAC,GACN,CACnB,GAAM,CAAE,MAAAH,CAAAA,CAAO,SAAA,CAAAF,CAAAA,CAAW,cAAA,CAAAM,CAAe,CAAA,CAAID,CAAAA,CACvCE,CAAAA,CAAOxB,CAAAA,CAAWqB,EAAW,EAAA,CAAG,KAAA,CAAOpB,CAAAA,CAAQC,CAAO,EAEtDuB,CAAAA,CAAaC,KAAAA,CAAUL,CAAAA,CAAW,IAAA,CAAK,UAAWpB,CAAa,CAAA,CACrE,GAAIwB,CAAAA,GAAe,KACjB,OAAO,CAAE,EAAA,CAAI,KAAA,CAAO,OAAQ,CAAE,IAAA,CAAM,SAAA,CAAW,IAAA,CAAMX,EAAaW,CAAU,CAAE,CAAE,CAAA,CAElF,IAAME,CAAAA,CAAWD,KAAAA,CAAUL,CAAAA,CAAW,EAAA,CAAG,UAAWG,CAAW,CAAA,CAC/D,OAAIG,CAAAA,GAAa,KACR,CAAE,EAAA,CAAI,KAAA,CAAO,MAAA,CAAQ,CAAE,IAAA,CAAM,OAAA,CAAS,GAAIb,CAAAA,CAAaa,CAAQ,CAAE,CAAE,CAAA,CAExEX,CAAAA,CAAOC,CAAAA,CAAWM,EAAgBtB,CAAAA,CAAekB,CAAK,CAAA,CACjD,CAAE,GAAI,KAAA,CAAO,MAAA,CAAQ,CAAE,IAAA,CAAM,eAAgB,KAAA,CAAO,QAAS,CAAE,CAAA,CACpEH,EAAOC,CAAAA,CAAWI,CAAAA,CAAW,IAAA,CAAK,UAAA,CAAYpB,EAAekB,CAAK,CAAA,CAC7D,CAAE,EAAA,CAAI,MAAO,MAAA,CAAQ,CAAE,IAAA,CAAM,cAAA,CAAgB,MAAO,MAAO,CAAE,CAAA,CAClEH,CAAAA,CAAOC,EAAWI,CAAAA,CAAW,EAAA,CAAG,UAAA,CAAYG,CAAAA,CAAaL,CAAK,CAAA,CACzD,CAAE,EAAA,CAAI,KAAA,CAAO,OAAQ,CAAE,IAAA,CAAM,cAAA,CAAgB,KAAA,CAAO,IAAK,CAAE,CAAA,CAE7D,CAAE,EAAA,CAAI,KAAM,IAAA,CAAME,CAAW,CACtC,MC/DaO,CAAAA,CAAYC,CAAAA,EAA2B,CAClD,OAAQA,EAAO,IAAA,EACb,KAAK,SAAA,CACH,OAAOA,CAAAA,CAAO,IAAA,EAAQ,qDACxB,KAAK,OAAA,CACH,OAAOA,CAAAA,CAAO,EAAA,EAAM,2CAAA,CACtB,KAAK,eACH,OAAOA,CAAAA,CAAO,KAAA,CACV,CAAA,gBAAA,EAAmBA,EAAO,KAAK,CAAA,yBAAA,CAAA,CAC/B,gBAAA,CACN,QAGE,OAD2BA,CAAAA,CAAO,IAGtC,CACF,ECTA,IAAMC,EAAW,CACfC,CAAAA,CACAC,CAAAA,CACA/B,CAAAA,CACAkB,EACAD,CAAAA,CACAe,CAAAA,GACY,CACZ,GAAIF,EAAI,YAAA,GAAeZ,CAAK,CAAA,CAAG,OAAO,MACtC,GAAID,CAAAA,GAAS,IAAA,CAAM,OAAO,OAG1B,GAAI,OAAOA,CAAAA,EAAS,QAAA,CAAU,CAC5B,IAAMgB,CAAAA,CAAaH,CAAAA,CAAI,MAAA,CAAOC,CAAK,CAAA,EAAG,OAAA,CAAQd,CAAI,CAAA,EAAK,KAEjDiB,CAAAA,CADWlC,CAAAA,CAAO,eAAA,GACGiB,CAAI,EAE/B,OAAOY,CAAAA,CAASC,CAAAA,CAAKC,CAAAA,CAAO/B,EAAQkB,CAAAA,CADTgB,CAAAA,GAAY,MAAA,CAAY,CAAE,IAAK,CAACD,CAAAA,CAAYC,CAAO,CAAE,CAAA,CAAID,EACjCD,CAAO,CAC5D,CAGA,GAAI,QAASf,CAAAA,EAAQ,QAAA,GAAYA,CAAAA,CAAM,CACrC,IAAMkB,CAAAA,CAAWlB,CAAAA,CAAK,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAC/BmB,CAAAA,CAAepC,CAAAA,CACfqC,CAAAA,CAAeN,EACnB,IAAA,IAAWO,CAAAA,IAAWH,CAAAA,CAAU,CAC9B,IAAMI,CAAAA,CAAUH,CAAAA,CAAQE,CAAO,CAAA,CAC/B,GAAI,CAACC,CAAAA,CAAS,OAAO,MAAA,CACrBF,EAAeP,CAAAA,CAAI,YAAA,CAAeA,CAAAA,CAAI,YAAA,CAAaO,EAAcC,CAAO,CAAA,CAAIA,CAAAA,CAC5EF,CAAAA,CAAUG,EACZ,CACA,IAAMC,CAAAA,CAAM,CAAA,EAAGH,CAAY,CAAA,CAAA,EAAI,MAAA,CAAOD,CAAAA,CAAQ,EAAE,CAAC,CAAA,CAAA,EAAInB,CAAAA,CAAK,MAAM,CAAA,CAAA,CAChE,GAAIe,CAAAA,CAAQ,GAAA,CAAIQ,CAAG,CAAA,CAAG,MAAM,IAAI,KAAA,CAAM,CAAA,oCAAA,EAAuCA,CAAG,EAAE,CAAA,CAClF,OAAAR,CAAAA,CAAQ,GAAA,CAAIQ,CAAG,CAAA,CACRX,CAAAA,CAASC,EAAKO,CAAAA,CAAcD,CAAAA,CAASlB,EAAOD,CAAAA,CAAK,MAAA,CAAQe,CAAO,CACzE,CAGA,GAAI,MAAA,GAAUf,CAAAA,CAAM,CAClB,IAAMwB,CAAAA,CAAUvB,CAAAA,EAAO,EAAA,EAAM,IAAA,CAC7B,OAAOuB,CAAAA,GAAY,IAAA,EAAQzC,CAAAA,CAAOiB,CAAAA,CAAK,IAAI,CAAA,GAAMwB,CACnD,CAGA,OAAI,SAAUxB,CAAAA,CAAaQ,KAAAA,CAAUR,CAAAA,CAAK,IAAA,CAAMjB,CAAM,CAAA,GAAM,IAAA,CAGxD,KAAA,GAASiB,CAAAA,CACJA,EAAK,GAAA,CAAI,IAAA,CAAMyB,CAAAA,EAAQb,CAAAA,CAASC,EAAKC,CAAAA,CAAO/B,CAAAA,CAAQkB,CAAAA,CAAOwB,CAAAA,CAAK,IAAI,GAAA,CAAIV,CAAO,CAAC,CAAC,EACtF,KAAA,GAASf,CAAAA,CACJA,CAAAA,CAAK,GAAA,CAAI,MAAOyB,CAAAA,EAAQb,CAAAA,CAASC,CAAAA,CAAKC,CAAAA,CAAO/B,EAAQkB,CAAAA,CAAOwB,CAAAA,CAAK,IAAI,GAAA,CAAIV,CAAO,CAAC,CAAC,CAAA,CAEpF,KACT,EASaW,CAAAA,CAAsBtB,CAAAA,EAAyD,CAC1F,GAAM,CAAE,KAAA,CAAAU,CAAAA,CAAO,GAAGa,CAAK,CAAA,CAAIvB,EAC3B,OAAO,CAACJ,CAAAA,CAAMjB,CAAAA,CAAQkB,IAAUW,CAAAA,CAASe,CAAAA,CAAMb,CAAAA,CAAO/B,CAAAA,CAAQkB,EAAOD,CAAAA,CAAM,IAAI,GAAK,CACtF,EAGa4B,CAAAA,CACVxB,CAAAA,EACAU,CAAAA,EACCY,CAAAA,CAAmB,CAAE,GAAGtB,CAAAA,CAAS,KAAA,CAAAU,CAAM,CAAC,ECpE5C,IAAMe,CAAAA,CAAY,CAACC,CAAAA,CAAoBhB,CAAAA,CAAeiB,IAAyB,CAC7E,IAAMC,EAASF,CAAAA,CAAIhB,CAAK,CAAA,GAAIiB,CAAI,EAChC,GAAI,CAACC,CAAAA,CAAQ,MAAM,IAAI,KAAA,CAAM,CAAA,uBAAA,EAA0BD,CAAI,CAAA,uBAAA,EAA0BjB,CAAK,CAAA,CAAA,CAAG,CAAA,CAC7F,OAAOkB,CACT,EAMMC,CAAAA,CAAaC,CAAAA,EAA+B,CAChD,IAAMC,EAAuBD,CAAAA,CAAS,GAAA,CAAI,CAAC,CAAE,KAAME,CAAAA,CAAO,KAAA,CAAOC,CAAAA,CAAQ,GAAGV,CAAK,CAAA,GAAMA,CAAI,EACrFW,CAAAA,CAAQlD,CAAAA,EAAyB8C,EAAS,IAAA,CAAMK,CAAAA,EAAYA,CAAAA,CAAQ,IAAA,GAASnD,CAAI,CAAA,CACjFoD,CAAAA,CAASF,CAAAA,CAAK,cAAc,GAAKA,CAAAA,CAAK,OAAO,CAAA,EAAKA,CAAAA,CAAK,SAAS,CAAA,CACtE,GAAI,CAACE,CAAAA,CAAQ,OAAO,CAAE,IAAA,CAAM,SAAA,CAAW,KAAA,CAAAL,CAAM,CAAA,CAC7C,GAAM,CAAE,KAAA,CAAOM,EAAO,GAAGC,CAAe,CAAA,CAAIF,CAAAA,CAC5C,OAAO,CAAE,GAAGE,CAAAA,CAAgB,KAAA,CAAAP,CAAM,CACpC,CAAA,CAOaQ,EAAAA,CAAQ,CACnBb,EACAhB,CAAAA,CACAiB,CAAAA,CACAhD,CAAAA,CACAC,CAAAA,CAAe,EAAC,CAChBoB,CAAAA,CAA4B,EAAC,GACb,CAChB,IAAM4B,CAAAA,CAASH,CAAAA,CAAUC,CAAAA,CAAKhB,EAAOiB,CAAI,CAAA,CACnCa,CAAAA,CAAqB,CAAE,GAAGxC,CAAAA,CAAS,cAAA,CAAgB4B,CAAAA,CAAO,UAAW,EAErEE,CAAAA,CAAqB,EAAC,CAC5B,IAAA,IAAW7C,KAAQ2C,CAAAA,CAAO,KAAA,CAAO,CAC/B,IAAMnC,CAAAA,CAASK,EAAgBb,CAAAA,CAAMN,CAAAA,CAAQC,CAAAA,CAAS4D,CAAI,EAC1D,GAAI/C,CAAAA,CAAO,EAAA,CAAI,OAAOA,EACtBqC,CAAAA,CAAS,IAAA,CAAKrC,CAAAA,CAAO,MAAM,EAC7B,CACA,OAAO,CAAE,EAAA,CAAI,MAAO,MAAA,CAAQoC,CAAAA,CAAUC,CAAQ,CAAE,CAClD,CAAA,CAOaW,EAAAA,CAAY,CACvBf,CAAAA,CACAhB,EACA/B,CAAAA,CACAqB,CAAAA,CAA4B,EAAC,GAChB,CACb,IAAM0C,CAAAA,CAAUhB,CAAAA,CAAIhB,CAAK,EACzB,GAAI,CAACgC,CAAAA,CAAS,OAAO,EAAC,CACtB,GAAM,CAAE,KAAA,CAAA7C,EAAO,SAAA,CAAAF,CAAU,CAAA,CAAIK,CAAAA,CAEvB2C,EAAS,CAAC/C,CAAAA,CAA4BgD,CAAAA,GAC1C,CAACjD,GAAaC,CAAAA,GAAS,MAAA,EAAaD,CAAAA,CAAUC,CAAAA,CAAMgD,EAAK/C,CAAK,CAAA,CAEhE,OAAO,MAAA,CAAO,QAAQ6C,CAAO,CAAA,CAC1B,MAAA,CAAO,CAAC,EAAGd,CAAM,IAChBA,CAAAA,CAAO,KAAA,CAAM,KACV3C,CAAAA,EACCmB,KAAAA,CAAUnB,CAAAA,CAAK,IAAA,CAAK,UAAWN,CAAM,CAAA,GAAM,IAAA,EAC3CgE,CAAAA,CAAOf,EAAO,UAAA,CAAYjD,CAAM,CAAA,EAChCgE,CAAAA,CAAO1D,EAAK,IAAA,CAAK,UAAA,CAAYN,CAAM,CACvC,CACF,CAAA,CACC,GAAA,CAAI,CAAC,CAACgD,CAAI,CAAA,GAAMA,CAAI,CACzB,CAAA,CAMakB,GAAW,CAACnB,CAAAA,CAAoBhB,CAAAA,CAAeiB,CAAAA,GAAsB,CAChF,IAAMC,CAAAA,CAASH,CAAAA,CAAUC,CAAAA,CAAKhB,EAAOiB,CAAI,CAAA,CACnC,CAAE,KAAA,CAAAmB,CAAM,CAAA,CAAIC,QAAAA,CAAS,CAAE,GAAA,CAAKnB,EAAO,KAAA,CAAM,GAAA,CAAK3C,CAAAA,EAASA,CAAAA,CAAK,KAAK,SAAS,CAAE,CAAC,CAAA,CAI7E+D,EAAOF,CAAAA,CAAMA,CAAAA,CAAM,MAAA,CAAS,CAAC,EACnC,GAAIE,CAAAA,EAAM,SAAA,GAAc,OAAA,EAAWA,EAAK,KAAA,GAAU,MAAA,CAChD,MAAM,IAAI,MAAM,mEAAmE,CAAA,CACrF,OAAOA,CAAAA,CAAK,KACd,EC5FO,IAAMC,EAAAA,CAAkBlD,CAAAA,EAC7BvB,CAAAA,CAAoBuB,EAAW,EAAA,CAAG,KAAK,MCUnCmD,CAAAA,CAAiB,IAAI,GAAA,CAAI,CAAC,SAAU,WAAW,CAAC,CAAA,CAChDC,CAAAA,CAAc,IAAI,GAAA,CAAI,CAAC,QAAA,CAAU,cAAc,CAAC,CAAA,CAEhDC,CAAAA,CAAoB,CACxBC,CAAAA,CACAC,EACArE,CAAAA,CACAsE,CAAAA,GACS,CACT,IAAM9D,EAAS+D,YAAAA,CAAaH,CAAS,CAAA,CACrC,IAAA,IAAWI,KAAShE,CAAAA,CAAO,MAAA,CACzB6D,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAM,CAAA,EAAGrE,CAAI,CAAA,CAAA,EAAIwE,EAAM,IAAI,CAAA,CAAA,CAAI,OAAA,CAASA,CAAAA,CAAM,OAAQ,CAAC,CAAA,CACvE,GAAIF,CAAAA,CAAM,CACR,IAAMG,CAAAA,CAAYC,oBAAAA,CAAqBN,CAAAA,CAAWE,CAAI,CAAA,CACtD,IAAA,IAAWK,CAAAA,IAAaF,CAAAA,CAAU,WAChCJ,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAM,CAAA,EAAGrE,CAAI,CAAA,CAAA,EAAI2E,CAAAA,CAAU,IAAI,CAAA,CAAA,CAAI,QAASA,CAAAA,CAAU,MAAO,CAAC,EAChF,CACF,CAAA,CAEMC,CAAAA,CAAqB,CACzBjE,CAAAA,CACA0D,EACArE,CAAAA,GACS,CACT,GAAI,EAAsBW,GAAS,IAAA,EAAQ,OAAOA,CAAAA,EAAS,QAAA,CAAA,CAC3D,IAAI,MAAA,GAAUA,CAAAA,CAAM,CAClB,IAAMH,EAAS+D,YAAAA,CAAa5D,CAAAA,CAAK,IAAI,CAAA,CACrC,QAAW6D,CAAAA,IAAShE,CAAAA,CAAO,MAAA,CACzB6D,CAAAA,CAAO,KAAK,CAAE,IAAA,CAAM,CAAA,EAAGrE,CAAI,SAASwE,CAAAA,CAAM,IAAI,CAAA,CAAA,CAAI,OAAA,CAASA,EAAM,OAAQ,CAAC,CAAA,CAC5E,MACF,CACA,GAAI,KAAA,GAAS7D,CAAAA,CAAM,CAAA,CACb,CAACA,CAAAA,CAAK,GAAA,EAAO,CAACA,CAAAA,CAAK,SACrB0D,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAArE,EAAM,OAAA,CAAS,gDAAiD,CAAC,CAAA,CACjF,MACF,CACA,GAAI,SAAUW,CAAAA,CAAM,CACbA,EAAK,IAAA,EAAM0D,CAAAA,CAAO,IAAA,CAAK,CAAE,KAAArE,CAAAA,CAAM,OAAA,CAAS,2CAA4C,CAAC,EAC1F,MACF,CACA,GAAI,KAAA,GAASW,EAAM,CACjBA,CAAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,CAACyB,CAAAA,CAAKyC,CAAAA,GAAM,CAC3BD,CAAAA,CAAmBxC,EAAKiC,CAAAA,CAAQ,CAAA,EAAGrE,CAAI,CAAA,KAAA,EAAQ6E,CAAC,CAAA,CAAA,CAAG,EACrD,CAAC,CAAA,CACD,MACF,CACA,GAAI,KAAA,GAASlE,CAAAA,CAAM,CACjBA,CAAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,CAACyB,EAAKyC,CAAAA,GAAM,CAC3BD,CAAAA,CAAmBxC,CAAAA,CAAKiC,EAAQ,CAAA,EAAGrE,CAAI,CAAA,KAAA,EAAQ6E,CAAC,GAAG,EACrD,CAAC,CAAA,CACD,MACF,CACAR,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAArE,EAAM,OAAA,CAAS,+BAAgC,CAAC,EAAA,CAChE,EAEM8E,CAAAA,CAAgB,CAACtF,CAAAA,CAA0B6E,CAAAA,CAA2BrE,IAAuB,CACjG,GAAI,EAAAR,CAAAA,GAAU,MAAA,EAAa,OAAOA,CAAAA,EAAU,UAAA,CAAA,CAC5C,CAAA,GAAI,OAAOA,GAAU,QAAA,CAAU,CACxByE,CAAAA,CAAe,GAAA,CAAIzE,CAAK,CAAA,EAC3B6E,CAAAA,CAAO,IAAA,CAAK,CAAE,KAAArE,CAAAA,CAAM,OAAA,CAAS,CAAA,wBAAA,EAA2BR,CAAK,GAAI,CAAC,CAAA,CACpE,MACF,CACK0E,EAAY,GAAA,CAAI1E,CAAAA,CAAM,IAAI,CAAA,CAErBA,EAAM,IAAA,EAAM6E,CAAAA,CAAO,IAAA,CAAK,CAAE,KAAArE,CAAAA,CAAM,OAAA,CAAS,CAAA,OAAA,EAAUR,CAAAA,CAAM,IAAI,CAAA,qBAAA,CAAwB,CAAC,CAAA,CAD9F6E,CAAAA,CAAO,KAAK,CAAE,IAAA,CAAArE,CAAAA,CAAM,OAAA,CAAS,uBAAuBR,CAAAA,CAAM,IAAI,CAAA,CAAA,CAAI,CAAC,GAEvE,CAAA,CAEMuF,CAAAA,CAAe,CACnBC,CAAAA,CACAX,EACArE,CAAAA,CACAe,CAAAA,GACS,CACToD,CAAAA,CAAkBa,EAAK,SAAA,CAAWX,CAAAA,CAAQ,CAAA,EAAGrE,CAAI,aAAce,CAAAA,CAAQ,IAAI,CAAA,CAC3E6D,CAAAA,CAAmBI,EAAK,UAAA,CAAYX,CAAAA,CAAQ,GAAGrE,CAAI,CAAA,WAAA,CAAa,EAC5DgF,CAAAA,CAAK,QAAA,GAAa,MAAA,GAAc,OAAOA,EAAK,QAAA,EAAa,QAAA,EAAYA,CAAAA,CAAK,QAAA,GAAa,OACzFX,CAAAA,CAAO,IAAA,CAAK,CACV,IAAA,CAAM,GAAGrE,CAAI,CAAA,SAAA,CAAA,CACb,OAAA,CAAS,mDACX,CAAC,CAAA,CACC,OAAA,GAAWgF,CAAAA,EAAMF,CAAAA,CAAcE,EAAK,KAAA,CAAOX,CAAAA,CAAQ,CAAA,EAAGrE,CAAI,QAAQ,EACxE,CAAA,CAOaiF,EAAAA,CAAqB,CAChCnE,EACAC,CAAAA,CAA2B,KACN,CACrB,IAAMsD,EAA4B,EAAC,CACnC,OAAAU,CAAAA,CAAajE,EAAW,IAAA,CAAMuD,CAAAA,CAAQ,MAAA,CAAQtD,CAAO,EACrDgE,CAAAA,CAAajE,CAAAA,CAAW,EAAA,CAAIuD,CAAAA,CAAQ,KAAMtD,CAAO,CAAA,CAC7CA,CAAAA,CAAQ,mBAAA,EAAuB,CAACxB,CAAAA,CAAoBuB,CAAAA,CAAW,EAAA,CAAG,KAAK,GACzEuD,CAAAA,CAAO,IAAA,CAAK,CACV,IAAA,CAAM,WACN,OAAA,CAAS,4DACX,CAAC,CAAA,CACI,CAAE,EAAA,CAAIA,CAAAA,CAAO,SAAW,CAAA,CAAG,MAAA,CAAAA,CAAO,CAC3C","file":"index.js","sourcesContent":["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 CheckOptions,\n CheckResult,\n Row,\n Transition,\n} from './types';\n\nconst reasonString = (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 transition.\n *\n * Legality (json-rules) AND authz (injected, per side), with the load-bearing asymmetry —\n * `from.*` reads the current `record`, `to.*` reads the merged `next` record. Authz order is\n * action baseline → from → to, all ANDed. Returns a structured {@link CheckResult} whose\n * `reason.kind` lets a caller map illegal → 409 vs unauthorized → 403.\n *\n * Omit `options.authorize` to check legality only.\n */\nexport const checkTransition = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: CheckOptions = {},\n): CheckResult<R> => {\n const { actor, authorize, basePermission } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const fromResult = checkRule(transition.from.predicate, record as Row);\n if (fromResult !== true)\n return { ok: false, reason: { kind: 'no-from', from: reasonString(fromResult) } };\n\n const toResult = checkRule(transition.to.predicate, next as Row);\n if (toResult !== true)\n return { ok: false, reason: { kind: 'no-to', to: reasonString(toResult) } };\n\n if (denies(authorize, basePermission, record as Row, actor))\n return { ok: false, reason: { kind: 'unauthorized', authz: 'action' } };\n if (denies(authorize, transition.from.permission, record as Row, actor))\n return { ok: false, reason: { kind: 'unauthorized', authz: 'from' } };\n if (denies(authorize, transition.to.permission, next as Row, actor))\n return { ok: false, reason: { kind: 'unauthorized', authz: 'to' } };\n\n return { ok: true, path: transition };\n};\n","import type { Reason } from './types';\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n switch (reason.kind) {\n case 'no-from':\n return reason.from ?? 'transition is not available from the current state';\n case 'no-to':\n return reason.to ?? 'the resulting state is not a valid target';\n case 'unauthorized':\n return reason.authz\n ? `not authorized (${reason.authz}-level permission denied)`\n : 'not authorized';\n default: {\n // exhaustiveness guard: a new FailureKind must be handled here, not silently return undefined\n const _exhaustive: never = reason.kind;\n return _exhaustive;\n }\n }\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport type { ActionRule, Actor, Authorize, Row } from '../types';\nimport type { RebacOptions, RebacSchema } from './types';\n\ntype Context = {\n schema: RebacSchema;\n resolveModel?: (model: string, relationSegment: string) => string;\n isSuperadmin?: (actor: Actor) => boolean;\n};\n\nconst evaluate = (\n ctx: Context,\n model: string,\n record: Row,\n actor: Actor,\n rule: ActionRule,\n visited: Set<string>,\n): boolean => {\n if (ctx.isSuperadmin?.(actor)) return true;\n if (rule === null) return false;\n\n // string → delegate to the named action on this model, additively merged with any per-row override.\n if (typeof rule === 'string') {\n const schemaRule = ctx.schema[model]?.actions[rule] ?? null;\n const rowRules = record.permissionRules as Record<string, ActionRule> | null | undefined;\n const rowRule = rowRules?.[rule];\n const merged: ActionRule = rowRule !== undefined ? { any: [schemaRule, rowRule] } : schemaRule;\n return evaluate(ctx, model, record, actor, merged, visited);\n }\n\n // { rel, action } → walk the relation (dot-paths supported), then check `action` on the target.\n if ('rel' in rule && 'action' in rule) {\n const segments = rule.rel.split('.');\n let current: Row = record;\n let currentModel = model;\n for (const segment of segments) {\n const related = current[segment] as Row | null | undefined;\n if (!related) return false;\n currentModel = ctx.resolveModel ? ctx.resolveModel(currentModel, segment) : segment;\n current = related;\n }\n const key = `${currentModel}:${String(current.id)}:${rule.action}`;\n if (visited.has(key)) throw new Error(`Cycle detected in permission graph: ${key}`);\n visited.add(key);\n return evaluate(ctx, currentModel, current, actor, rule.action, visited);\n }\n\n // { self } → record[field] matches the current actor.\n if ('self' in rule) {\n const actorId = actor?.id ?? null;\n return actorId !== null && record[rule.self] === actorId;\n }\n\n // { rule } → ABAC predicate (json-rules) over the record.\n if ('rule' in rule) return checkRule(rule.rule, record) === true;\n\n // Fork `visited` per branch — parallel paths through any/all aren't cycles.\n if ('any' in rule)\n return rule.any.some((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n if ('all' in rule)\n return rule.all.every((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n\n return false;\n};\n\n/**\n * A reference rebac evaluator — one implementation of the injected {@link Authorize} seam,\n * bound to a single `model`. Faithful to `@template/permissions`' `rebac/check` (string-delegate,\n * relation walk with cycle detection, self, json-rules `{ rule }`, any/all, per-row\n * `permissionRules` override) but standalone. Swap it for a richer authorizer in production;\n * this is slated to graduate into `@inixiative/permissions`.\n */\nexport const makeRebacAuthorize = (options: RebacOptions & { model: string }): Authorize => {\n const { model, ...rest } = options;\n return (rule, record, actor) => evaluate(rest, model, record, actor, rule, new Set());\n};\n\n/** Curried form: `createRebac({ schema })(model)` → an {@link Authorize} for that model. */\nexport const createRebac =\n (options: RebacOptions) =>\n (model: string): Authorize =>\n makeRebacAuthorize({ ...options, model });\n","import { check as checkRule, toPrisma } from '@inixiative/json-rules';\nimport { checkTransition } from './check';\nimport type {\n Action,\n AuthorizeOptions,\n CheckOptions,\n CheckResult,\n PathFailure,\n Reason,\n Row,\n TransitionMap,\n} from './types';\n\nconst getAction = (map: TransitionMap, model: string, verb: string): Action => {\n const action = map[model]?.[verb];\n if (!action) throw new Error(`transition: no action \"${verb}\" registered on model \"${model}\"`);\n return action;\n};\n\n// Pick the most-progressed failure across an action's paths:\n// unauthorized (a legal edge existed but authz denied) → 403\n// no-to (from matched, target invalid) → 409\n// no-from (no edge even starts here) → 409\nconst aggregate = (failures: Reason[]): Reason => {\n const paths: PathFailure[] = failures.map(({ kind: _kind, paths: _paths, ...rest }) => rest);\n const pick = (kind: Reason['kind']) => failures.find((failure) => failure.kind === kind);\n const chosen = pick('unauthorized') ?? pick('no-to') ?? pick('no-from');\n if (!chosen) return { kind: 'no-from', paths };\n const { paths: _omit, ...representative } = chosen;\n return { ...representative, paths };\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to`\n * matches the merged record, and whose permissions all pass, wins. If none pass, returns the\n * aggregated structured failure (see {@link aggregate}).\n */\nexport const check = (\n map: TransitionMap,\n model: string,\n verb: string,\n record: Row,\n changes: Row = {},\n options: AuthorizeOptions = {},\n): CheckResult => {\n const action = getAction(map, model, verb);\n const opts: CheckOptions = { ...options, basePermission: action.permission };\n\n const failures: Reason[] = [];\n for (const path of action.paths) {\n const result = checkTransition(path, record, changes, opts);\n if (result.ok) return result;\n failures.push(result.reason);\n }\n return { ok: false, reason: aggregate(failures) };\n};\n\n/**\n * Affordance hint: which verbs are offerable from `record` right now. Evaluates ONLY the\n * `from` side (predicate + `action`/`from` permission against the current record) — `to` needs\n * the merged record, which doesn't exist without proposed changes, so it defers to {@link check}.\n */\nexport const available = (\n map: TransitionMap,\n model: string,\n record: Row,\n options: AuthorizeOptions = {},\n): string[] => {\n const actions = map[model];\n if (!actions) return [];\n const { actor, authorize } = options;\n\n const allows = (rule: Action['permission'], 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) === true &&\n allows(action.permission, record) &&\n allows(path.from.permission, record),\n ),\n )\n .map(([verb]) => verb);\n};\n\n/**\n * Set query: one OR'd Prisma `where` matching every record currently eligible for `verb`\n * (the union of all its paths' `from` predicates). Empty action → match-nothing.\n */\nexport const eligible = (map: TransitionMap, model: string, verb: string): Row => {\n const action = getAction(map, model, verb);\n const { steps } = toPrisma({ any: action.paths.map((path) => path.from.predicate) });\n // json-rules guarantees the last step is the WhereStep. Assert it loudly rather than cast-and-swallow:\n // a silent `{}` fallback would mean match-EVERYTHING — the dangerous inverse of the intended\n // match-nothing — if a future json-rules emits a trailing non-where step or multi-step relation refs.\n const last = steps[steps.length - 1] as { operation?: string; where?: Row } | undefined;\n if (last?.operation !== 'where' || last.where === undefined)\n throw new Error('transition: expected a terminal WhereStep from toPrisma; got none');\n return last.where;\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 checkRuleAgainstLens,\n type Lens,\n type LensNarrowing,\n validateRule,\n} from '@inixiative/json-rules';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type ValidationIssue = { path: string; message: string };\nexport type ValidationResult = { ok: boolean; errors: ValidationIssue[] };\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,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n const result = validateRule(predicate);\n for (const issue of result.errors)\n errors.push({ path: `${path}.${issue.path}`, message: issue.message });\n if (lens) {\n const lensCheck = checkRuleAgainstLens(predicate, lens);\n for (const violation of lensCheck.violations)\n errors.push({ path: `${path}.${violation.path}`, message: violation.reason });\n }\n};\n\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined || rule === null || typeof rule === 'string') return;\n if ('rule' in rule) {\n const result = validateRule(rule.rule);\n for (const issue of result.errors)\n errors.push({ path: `${path}.rule.${issue.path}`, message: issue.message });\n return;\n }\n if ('rel' in rule) {\n if (!rule.rel || !rule.action)\n errors.push({ path, message: 'rel-rule requires non-empty `rel` and `action`' });\n return;\n }\n if ('self' in rule) {\n if (!rule.self) errors.push({ path, message: 'self-rule requires a non-empty field name' });\n return;\n }\n if ('any' in rule) {\n rule.any.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.any[${i}]`);\n });\n return;\n }\n if ('all' in rule) {\n rule.all.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.all[${i}]`);\n });\n return;\n }\n errors.push({ path, message: 'unrecognized ActionRule shape' });\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}\"` });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"` });\n else if (!merge.path) errors.push({ path, message: `merge \"${merge.kind}\" requires a \\`path\\`` });\n};\n\nconst validateSide = (\n side: Side | ToSide,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\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 });\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 * Predicate validity delegates to json-rules (`validateRule`, plus `checkRuleAgainstLens` when a\n * `lens` is supplied for field/relation scoping); merge strategy and permission shape are 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 });\n return { ok: errors.length === 0, errors };\n};\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/merge.ts","../src/check.ts","../src/describe.ts","../src/rebac/authorize.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","record","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","rule","actor","checkPath","transition","options","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","i","evaluate","ctx","model","visited","schemaRule","rowRule","segments","current","currentModel","segment","related","key","actorId","sub","makeRebacAuthorize","rest","createRebac","getAction","rules","resource","action","found","checkTransition","paths","available","actions","allows","rec","eligible","steps","toPrisma","last","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","predicate","errors","lens","validateRule","issue","lensCheck","checkRuleAgainstLens","violation","validatePermission","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.js","sourcesContent":["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 AuthorizeOptions,\n PathReason,\n Row,\n SideReason,\n Transition,\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 */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: AuthorizeOptions = {},\n): true | PathReason => {\n const { actor, authorize } = 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);\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);\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 { check as checkRule } from '@inixiative/json-rules';\nimport type { ActionRule, Actor, Authorize, Row } from '../types';\nimport type { RebacOptions, RebacSchema } from './types';\n\ntype Context = {\n schema: RebacSchema;\n resolveModel?: (model: string, relationSegment: string) => string;\n isSuperadmin?: (actor: Actor) => boolean;\n};\n\nconst evaluate = (\n ctx: Context,\n model: string,\n record: Row,\n actor: Actor,\n rule: ActionRule,\n visited: Set<string>,\n): boolean => {\n if (ctx.isSuperadmin?.(actor)) return true;\n if (rule === null) return false;\n\n // string → delegate to the named action on this model, additively merged with any per-row override.\n if (typeof rule === 'string') {\n const schemaRule = ctx.schema[model]?.actions[rule] ?? null;\n const rowRules = record.permissionRules as Record<string, ActionRule> | null | undefined;\n const rowRule = rowRules?.[rule];\n const merged: ActionRule = rowRule !== undefined ? { any: [schemaRule, rowRule] } : schemaRule;\n return evaluate(ctx, model, record, actor, merged, visited);\n }\n\n // { rel, action } → walk the relation (dot-paths supported), then check `action` on the target.\n if ('rel' in rule && 'action' in rule) {\n const segments = rule.rel.split('.');\n let current: Row = record;\n let currentModel = model;\n for (const segment of segments) {\n const related = current[segment] as Row | null | undefined;\n if (!related) return false;\n currentModel = ctx.resolveModel ? ctx.resolveModel(currentModel, segment) : segment;\n current = related;\n }\n const key = `${currentModel}:${String(current.id)}:${rule.action}`;\n if (visited.has(key)) throw new Error(`Cycle detected in permission graph: ${key}`);\n visited.add(key);\n return evaluate(ctx, currentModel, current, actor, rule.action, visited);\n }\n\n // { self } → record[field] matches the current actor.\n if ('self' in rule) {\n const actorId = actor?.id ?? null;\n return actorId !== null && record[rule.self] === actorId;\n }\n\n // { rule } → ABAC predicate (json-rules) over the record.\n if ('rule' in rule) return checkRule(rule.rule, record) === true;\n\n // Fork `visited` per branch — parallel paths through any/all aren't cycles.\n if ('any' in rule)\n return rule.any.some((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n if ('all' in rule)\n return rule.all.every((sub) => evaluate(ctx, model, record, actor, sub, new Set(visited)));\n\n return false;\n};\n\n/**\n * A reference rebac evaluator — one implementation of the injected {@link Authorize} seam,\n * bound to a single `model`. Faithful to `@template/permissions`' `rebac/check` (string-delegate,\n * relation walk with cycle detection, self, json-rules `{ rule }`, any/all, per-row\n * `permissionRules` override) but standalone. Swap it for a richer authorizer in production;\n * this is slated to graduate into `@inixiative/permissions`.\n */\nexport const makeRebacAuthorize = (options: RebacOptions & { model: string }): Authorize => {\n const { model, ...rest } = options;\n return (rule, record, actor) => evaluate(rest, model, record, actor, rule, new Set());\n};\n\n/** Curried form: `createRebac({ schema })(model)` → an {@link Authorize} for that model. */\nexport const createRebac =\n (options: RebacOptions) =>\n (model: string): Authorize =>\n makeRebacAuthorize({ ...options, model });\n","import { check as checkRule, toPrisma } from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n AuthorizeOptions,\n CheckResult,\n PathReason,\n Row,\n TransitionMap,\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: AuthorizeOptions = {},\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: AuthorizeOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize } = 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) === true && allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n/**\n * Set query: one OR'd Prisma `where` matching every record currently eligible for `action`\n * (the union of all its paths' `from` predicates). Empty action → match-nothing.\n */\nexport const eligible = (rules: TransitionMap, resource: string, action: string): Row => {\n const found = getAction(rules, resource, action);\n const { steps } = toPrisma({ any: found.paths.map((path) => path.from.predicate) });\n // json-rules guarantees the last step is the WhereStep. Assert it loudly rather than cast-and-swallow:\n // a silent `{}` fallback would mean match-EVERYTHING — the dangerous inverse of match-nothing.\n const last = steps[steps.length - 1] as { operation?: string; where?: Row } | undefined;\n if (last?.operation !== 'where' || last.where === undefined)\n throw new Error('transition: expected a terminal WhereStep from toPrisma; got none');\n return last.where;\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 checkRuleAgainstLens,\n type Lens,\n type LensNarrowing,\n validateRule,\n} from '@inixiative/json-rules';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type ValidationIssue = { path: string; message: string };\nexport type ValidationResult = { ok: boolean; errors: ValidationIssue[] };\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,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n const result = validateRule(predicate);\n for (const issue of result.errors)\n errors.push({ path: `${path}.${issue.path}`, message: issue.message });\n if (lens) {\n const lensCheck = checkRuleAgainstLens(predicate, lens);\n for (const violation of lensCheck.violations)\n errors.push({ path: `${path}.${violation.path}`, message: violation.reason });\n }\n};\n\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined || rule === null || typeof rule === 'string') return;\n if ('rule' in rule) {\n const result = validateRule(rule.rule);\n for (const issue of result.errors)\n errors.push({ path: `${path}.rule.${issue.path}`, message: issue.message });\n return;\n }\n if ('rel' in rule) {\n if (!rule.rel || !rule.action)\n errors.push({ path, message: 'rel-rule requires non-empty `rel` and `action`' });\n return;\n }\n if ('self' in rule) {\n if (!rule.self) errors.push({ path, message: 'self-rule requires a non-empty field name' });\n return;\n }\n if ('any' in rule) {\n rule.any.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.any[${i}]`);\n });\n return;\n }\n if ('all' in rule) {\n rule.all.forEach((sub, i) => {\n validatePermission(sub, errors, `${path}.all[${i}]`);\n });\n return;\n }\n errors.push({ path, message: 'unrecognized ActionRule shape' });\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}\"` });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"` });\n else if (!merge.path) errors.push({ path, message: `merge \"${merge.kind}\" requires a \\`path\\`` });\n};\n\nconst validateSide = (\n side: Side | ToSide,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\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 });\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 * Predicate validity delegates to json-rules (`validateRule`, plus `checkRuleAgainstLens` when a\n * `lens` is supplied for field/relation scoping); merge strategy and permission shape are 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 });\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.0.
|
|
3
|
+
"version": "0.0.3",
|
|
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",
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
}
|
|
57
57
|
},
|
|
58
58
|
"dependencies": {
|
|
59
|
-
"@inixiative/json-rules": "^2.
|
|
59
|
+
"@inixiative/json-rules": "^2.10.0",
|
|
60
60
|
"lodash-es": "^4.17.21"
|
|
61
61
|
},
|
|
62
62
|
"exports": {
|