@inixiative/transitions 0.0.2 → 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 +18 -14
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +10 -4
- package/dist/index.d.ts +10 -4
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -17,11 +17,14 @@ 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.
|
|
@@ -37,7 +40,7 @@ concrete record, so there is no record-free action-level permission.
|
|
|
37
40
|
import { checkTransition } from '@inixiative/transitions';
|
|
38
41
|
|
|
39
42
|
const rules = {
|
|
40
|
-
|
|
43
|
+
'db:Inquiry': {
|
|
41
44
|
approve: {
|
|
42
45
|
paths: [
|
|
43
46
|
{
|
|
@@ -49,14 +52,14 @@ const rules = {
|
|
|
49
52
|
},
|
|
50
53
|
};
|
|
51
54
|
|
|
52
|
-
checkTransition(rules, '
|
|
55
|
+
checkTransition(rules, 'db:Inquiry', 'approve', { status: 'pending' }, { status: 'approved' });
|
|
53
56
|
// → true
|
|
54
57
|
|
|
55
|
-
checkTransition(rules, '
|
|
58
|
+
checkTransition(rules, 'db:Inquiry', 'approve', { status: 'approved' }, { status: 'approved' });
|
|
56
59
|
// → { paths: [{ from: { predicate: 'status must equal "pending"' } }] }
|
|
57
60
|
```
|
|
58
61
|
|
|
59
|
-
`checkTransition(rules,
|
|
62
|
+
`checkTransition(rules, resource, action, record, changes, { actor, authorize })` returns **`true`** when
|
|
60
63
|
allowed, else a structured **`Reason`** — never a bare bool:
|
|
61
64
|
|
|
62
65
|
```ts
|
|
@@ -83,8 +86,8 @@ The kernel never imports an authorization library. Per-side `permission` is a se
|
|
|
83
86
|
```ts
|
|
84
87
|
import { checkTransition, createRebac } from '@inixiative/transitions';
|
|
85
88
|
|
|
86
|
-
const authorize = createRebac({ schema: rebacSchema })('
|
|
87
|
-
checkTransition(rules, '
|
|
89
|
+
const authorize = createRebac({ schema: rebacSchema })('db:Inquiry');
|
|
90
|
+
checkTransition(rules, 'db:Inquiry', 'approve', record, changes, { actor, authorize });
|
|
88
91
|
```
|
|
89
92
|
|
|
90
93
|
Effective authz ANDs the two side rules, each against the record it reads:
|
|
@@ -100,19 +103,20 @@ Absent = open; `null` = terminal deny. Omit `authorize` to check legality only.
|
|
|
100
103
|
|
|
101
104
|
This package ships a **reference** rebac evaluator (`string` delegation, relation walk with cycle
|
|
102
105
|
detection, `{ self }`, json-rules `{ rule }`, `any`/`all`, per-row `permissionRules` override). It's
|
|
103
|
-
one implementation of the `Authorize` seam, kept deliberately swappable.
|
|
104
|
-
|
|
105
|
-
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.
|
|
106
110
|
|
|
107
111
|
## Affordance + set query
|
|
108
112
|
|
|
109
113
|
```ts
|
|
110
114
|
import { available, eligible } from '@inixiative/transitions';
|
|
111
115
|
|
|
112
|
-
available(rules, '
|
|
116
|
+
available(rules, 'db:Inquiry', record, { actor, authorize });
|
|
113
117
|
// → ['approve', 'reject', 'cancel'] (from-side only — `to` needs proposed changes, so it defers to checkTransition)
|
|
114
118
|
|
|
115
|
-
eligible(rules, '
|
|
119
|
+
eligible(rules, 'db:Inquiry', 'approve');
|
|
116
120
|
// → { OR: [{ status: { equals: 'pending' } }] } (Prisma where for "every record eligible for approve")
|
|
117
121
|
```
|
|
118
122
|
|
package/dist/index.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
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
|
|
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","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","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, model: string, action: string): Action => {\n const found = rules[model]?.[action];\n if (!found) throw new Error(`transition: no action \"${action}\" registered on model \"${model}\"`);\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 */\nexport const checkTransition = (\n rules: TransitionMap,\n model: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: AuthorizeOptions = {},\n): CheckResult => {\n const found = getAction(rules, model, 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 model: string,\n record: Row,\n options: AuthorizeOptions = {},\n): string[] => {\n const actions = rules[model];\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, model: string, action: string): Row => {\n const found = getAction(rules, model, 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"]}
|
|
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
|
@@ -66,7 +66,9 @@ type Action<R extends Row = Row> = {
|
|
|
66
66
|
paths: Transition<R>[];
|
|
67
67
|
label?: string;
|
|
68
68
|
};
|
|
69
|
-
/** `
|
|
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. */
|
|
70
72
|
type TransitionMap = Record<string, Record<string, Action>>;
|
|
71
73
|
/** Why one side failed. Both keys are independent; either, both, or neither may be set. */
|
|
72
74
|
type SideReason = {
|
|
@@ -148,19 +150,23 @@ declare const createRebac: (options: RebacOptions) => (model: string) => Authori
|
|
|
148
150
|
* Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches
|
|
149
151
|
* the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a
|
|
150
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.
|
|
151
157
|
*/
|
|
152
|
-
declare const checkTransition: (rules: TransitionMap,
|
|
158
|
+
declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: AuthorizeOptions) => CheckResult;
|
|
153
159
|
/**
|
|
154
160
|
* Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`
|
|
155
161
|
* side (predicate + `from` permission against the current record) — `to` needs the merged record,
|
|
156
162
|
* which doesn't exist without proposed changes, so it defers to {@link checkTransition}.
|
|
157
163
|
*/
|
|
158
|
-
declare const available: (rules: TransitionMap,
|
|
164
|
+
declare const available: (rules: TransitionMap, resource: string, record: Row, options?: AuthorizeOptions) => string[];
|
|
159
165
|
/**
|
|
160
166
|
* Set query: one OR'd Prisma `where` matching every record currently eligible for `action`
|
|
161
167
|
* (the union of all its paths' `from` predicates). Empty action → match-nothing.
|
|
162
168
|
*/
|
|
163
|
-
declare const eligible: (rules: TransitionMap,
|
|
169
|
+
declare const eligible: (rules: TransitionMap, resource: string, action: string) => Row;
|
|
164
170
|
|
|
165
171
|
/**
|
|
166
172
|
* Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?
|
package/dist/index.d.ts
CHANGED
|
@@ -66,7 +66,9 @@ type Action<R extends Row = Row> = {
|
|
|
66
66
|
paths: Transition<R>[];
|
|
67
67
|
label?: string;
|
|
68
68
|
};
|
|
69
|
-
/** `
|
|
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. */
|
|
70
72
|
type TransitionMap = Record<string, Record<string, Action>>;
|
|
71
73
|
/** Why one side failed. Both keys are independent; either, both, or neither may be set. */
|
|
72
74
|
type SideReason = {
|
|
@@ -148,19 +150,23 @@ declare const createRebac: (options: RebacOptions) => (model: string) => Authori
|
|
|
148
150
|
* Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches
|
|
149
151
|
* the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a
|
|
150
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.
|
|
151
157
|
*/
|
|
152
|
-
declare const checkTransition: (rules: TransitionMap,
|
|
158
|
+
declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: AuthorizeOptions) => CheckResult;
|
|
153
159
|
/**
|
|
154
160
|
* Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`
|
|
155
161
|
* side (predicate + `from` permission against the current record) — `to` needs the merged record,
|
|
156
162
|
* which doesn't exist without proposed changes, so it defers to {@link checkTransition}.
|
|
157
163
|
*/
|
|
158
|
-
declare const available: (rules: TransitionMap,
|
|
164
|
+
declare const available: (rules: TransitionMap, resource: string, record: Row, options?: AuthorizeOptions) => string[];
|
|
159
165
|
/**
|
|
160
166
|
* Set query: one OR'd Prisma `where` matching every record currently eligible for `action`
|
|
161
167
|
* (the union of all its paths' `from` predicates). Empty action → match-nothing.
|
|
162
168
|
*/
|
|
163
|
-
declare const eligible: (rules: TransitionMap,
|
|
169
|
+
declare const eligible: (rules: TransitionMap, resource: string, action: string) => Row;
|
|
164
170
|
|
|
165
171
|
/**
|
|
166
172
|
* Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?
|
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 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
|
|
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","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","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, model: string, action: string): Action => {\n const found = rules[model]?.[action];\n if (!found) throw new Error(`transition: no action \"${action}\" registered on model \"${model}\"`);\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 */\nexport const checkTransition = (\n rules: TransitionMap,\n model: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: AuthorizeOptions = {},\n): CheckResult => {\n const found = getAction(rules, model, 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 model: string,\n record: Row,\n options: AuthorizeOptions = {},\n): string[] => {\n const actions = rules[model];\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, model: string, action: string): Row => {\n const found = getAction(rules, model, 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"]}
|
|
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": {
|