@inixiative/transitions 0.1.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -136,9 +136,34 @@ available(rules, 'db:Inquiry', record, { actor, authorize });
136
136
  // → ['approve', 'reject', 'cancel'] (from-side only — `to` needs proposed changes, so it defers to checkTransition)
137
137
 
138
138
  eligible(rules, 'db:Inquiry', 'approve');
139
- // → { OR: [{ status: { equals: 'pending' } }] } (Prisma where for "every record eligible for approve")
139
+ // → { status: { equals: 'pending' } } (Prisma where for "every record eligible for approve")
140
140
  ```
141
141
 
142
+ A predicate evaluates with the same options json-rules' `check()` takes — `now`, `timeZone`,
143
+ `weekStart`, `bindings`, `context` — passed beside `actor` / `authorize`. `checkTransition`,
144
+ `checkPath` and `available` give them to both sides; `eligible` resolves the bindings into the
145
+ predicate and compiles with `now` / `context`, so the set query selects exactly the records the
146
+ single check accepts:
147
+
148
+ ```ts
149
+ const quietFor = { field: 'lastBreachedAt', dateOperator: 'before', bind: 'quietWindow' };
150
+ const options = { now, bindings: { quietWindow: { ago: { seconds: 1800 } } } };
151
+
152
+ checkTransition(rules, 'incident', 'autoResolve', incident, { status: 'resolved' }, options);
153
+ eligible(rules, 'incident', 'autoResolve', options);
154
+ // → { AND: [{ status: … }, { lastBreachedAt: { lt: <now - window> } }] }
155
+ ```
156
+
157
+ A guard can read its window off the record instead — self-contained, nothing to bind:
158
+
159
+ ```ts
160
+ { field: 'lastBreachedAt', dateOperator: 'before',
161
+ value: { ago: { seconds: { path: '$.platformAlertRule.autoResolveAfterSeconds' } } } }
162
+ ```
163
+
164
+ `check()` evaluates it per record; `eligible` throws on it, since a Prisma `where` can't do
165
+ arithmetic on a column — it never returns the wrong set.
166
+
142
167
  ## Merge strategies
143
168
 
144
169
  `to.merge` produces the resulting record. Keyword strategies are serializable; a callback is full-power
@@ -152,10 +177,12 @@ but not (`isSerializable(transition)` tells you which).
152
177
  ## Authoring validation
153
178
 
154
179
  `validateTransition(t, { lens?, requireSerializable? })` validates predicates (via json-rules
155
- `validateRule`, plus `checkRuleAgainstLens` when a `lens` scopes referenceable fields), merge
180
+ `validateRule`, plus `validateRuleInLens` when a `lens` scopes referenceable fields), merge
156
181
  strategy, and permission shape (via `@inixiative/permissions`' zod `actionRuleSchema`) — run it on
157
- save before persisting a tenant config. It returns structured `{ ok, errors }` (never throws), even on
158
- malformed input.
182
+ save before persisting a tenant config. It returns json-rules' `ValidationResult` —
183
+ `{ ok, errors: { path, message, code }[] }` — and never throws, even on malformed input. json-rules'
184
+ issues keep their codes; transitions adds `missing_side`, `missing_predicate`, `invalid_permission`,
185
+ `invalid_requires`, `invalid_merge` and `unserializable_merge`.
159
186
 
160
187
  ## Not built yet (designed — see the plan)
161
188
 
package/dist/index.cjs CHANGED
@@ -1,2 +1,2 @@
1
- 'use strict';var permissions=require('@inixiative/permissions'),jsonRules=require('@inixiative/json-rules'),lodashEs=require('lodash-es'),actionRuleSchema=require('@inixiative/permissions/actionRuleSchema');var z=/Cycle detected/,P=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getUserId:()=>e?.id??null}),W=e=>{let t=e.resolveRelation??((i,n)=>n),o=permissions.createRebacCheck(t);return i=>(n,r,a)=>{let p=P(a,e.isSuperadmin),c={resource:i,record:r,data:e.data?.(r,a)};try{return o(p,e.schema,c,n)}catch(s){if(s instanceof Error&&z.test(s.message))return false;throw s}}};var R=e=>Array.isArray(e)?e:e===void 0?[]:[e],q=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,o={})=>{if(typeof e=="function")return e(t,o);let i=e??"spread";if(i==="spread")return {...t,...o};if(i==="deepMerge")return lodashEs.mergeWith(lodashEs.cloneDeep(t),lodashEs.cloneDeep(o),q);let{kind:n,path:r}=i,a=lodashEs.cloneDeep({...t,...o}),p=[...R(lodashEs.get(t,r)),...R(lodashEs.get(o,r))];return lodashEs.set(a,r,n==="appendUnique"?lodashEs.uniqWith(p,lodashEs.isEqual):p),a};var y=e=>typeof e=="string"?e:"predicate not satisfied",A=(e,t,o,i)=>!e||t===void 0?false:!e(t,o,i),w=(e,t,o={},i={})=>{let{actor:n,authorize:r}=i,a=h(e.to.merge,t,o),p={},c=jsonRules.check(e.from.predicate,t);c!==true&&(p.predicate=y(c)),A(r,e.from.permission,t,n)&&(p.permission="not authorized");let s={},m=jsonRules.check(e.to.predicate,a);m!==true&&(s.predicate=y(m)),A(r,e.to.permission,a,n)&&(s.permission="not authorized");let u={};return (p.predicate||p.permission)&&(u.from=p),(s.predicate||s.permission)&&(u.to=s),u.from||u.to?u:true};var b=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"},J=e=>e.paths.length===0?"no transition path available":e.paths.length===1?b(e.paths[0]):e.paths.map((t,o)=>`path ${o}: ${b(t)}`).join(" | ");var k=(e,t,o)=>{let i=e[t]?.[o];if(!i)throw new Error(`transition: no action "${o}" registered on resource "${t}"`);return i},ee=(e,t,o,i,n={},r={})=>{let a=k(e,t,o),p=[];for(let c of a.paths){let s=w(c,i,n,r);if(s===true)return true;p.push(s);}return {paths:p}},te=(e,t,o,i={})=>{let n=e[t];if(!n)return [];let{actor:r,authorize:a}=i,p=(c,s)=>!a||c===void 0||a(c,s,r);return Object.entries(n).filter(([,c])=>c.paths.some(s=>jsonRules.check(s.from.predicate,o)===true&&p(s.from.permission,o))).map(([c])=>c)},oe=(e,t,o)=>{let i=k(e,t,o),{steps:n}=jsonRules.toPrisma({any:i.paths.map(r=>r.from.predicate)});return n[n.length-1].where};var re=e=>f(e.to.merge);var I=new Set(["spread","deepMerge"]),E=new Set(["append","appendUnique"]),N=(e,t,o,i)=>{if(e===void 0){t.push({path:o,message:"predicate is required"});return}let n=jsonRules.validateRule(e);for(let r of n.errors)t.push({path:`${o}.${r.path}`,message:r.message});if(i){let r=jsonRules.checkRuleAgainstLens(e,i);for(let a of r.violations)t.push({path:`${o}.${a.path}`,message:a.reason});}},_=(e,t,o)=>{if(e===void 0)return;let i=actionRuleSchema.actionRuleSchema.safeParse(e);if(!i.success)for(let n of i.error.issues)n.path.length===0?t.push({path:o,message:"unrecognized ActionRule shape"}):t.push({path:`${o}.${n.path.join(".")}`,message:n.message});},D=(e,t,o)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){I.has(e)||t.push({path:o,message:`unknown merge strategy "${e}"`});return}E.has(e.kind)?e.path||t.push({path:o,message:`merge "${e.kind}" requires a \`path\``}):t.push({path:o,message:`unknown merge kind "${e.kind}"`});}},x=(e,t,o,i)=>{if(e===null||typeof e!="object"){t.push({path:o,message:`\`${o}\` side is required`});return}N(e.predicate,t,`${o}.predicate`,i.lens),_(e.permission,t,`${o}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${o}.requires`,message:"`requires` must be a Prisma-include-shaped object"}),"merge"in e&&D(e.merge,t,`${o}.merge`);},ue=(e,t={})=>{let o=[];return x(e?.from,o,"from",t),x(e?.to,o,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&o.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy"}),{ok:o.length===0,errors:o}};exports.applyMerge=h;exports.available=te;exports.checkPath=w;exports.checkTransition=ee;exports.createAuthorize=W;exports.describe=J;exports.eligible=oe;exports.isSerializable=re;exports.isSerializableMerge=f;exports.validateTransition=ue;//# sourceMappingURL=index.cjs.map
1
+ 'use strict';var permissions=require('@inixiative/permissions'),jsonRules=require('@inixiative/json-rules'),lodashEs=require('lodash-es'),actionRuleSchema=require('@inixiative/permissions/actionRuleSchema');var v=/Cycle detected/,M=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getUserId:()=>e?.id??null}),K=e=>{let t=e.resolveRelation??((o,n)=>n),i=permissions.createRebacCheck(t);return o=>(n,r,a)=>{let p=M(a,e.isSuperadmin),c={resource:o,record:r,data:e.data?.(r,a)};try{return i(p,e.schema,c,n)}catch(s){if(s instanceof Error&&v.test(s.message))return false;throw s}}};var g=e=>Array.isArray(e)?e:e===void 0?[]:[e],O=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,i={})=>{if(typeof e=="function")return e(t,i);let o=e??"spread";if(o==="spread")return {...t,...i};if(o==="deepMerge")return lodashEs.mergeWith(lodashEs.cloneDeep(t),lodashEs.cloneDeep(i),O);let{kind:n,path:r}=o,a=lodashEs.cloneDeep({...t,...i}),p=[...g(lodashEs.get(t,r)),...g(lodashEs.get(i,r))];return lodashEs.set(a,r,n==="appendUnique"?lodashEs.uniqWith(p,lodashEs.isEqual):p),a};var w=e=>typeof e=="string"?e:"predicate not satisfied",b=(e,t,i,o)=>!e||t===void 0?false:!e(t,i,o),A=(e,t,i={},o={})=>{let{actor:n,authorize:r,...a}=o,p=h(e.to.merge,t,i),c={},s=jsonRules.check(e.from.predicate,t,a);s!==true&&(c.predicate=w(s)),b(r,e.from.permission,t,n)&&(c.permission="not authorized");let u={},m=jsonRules.check(e.to.predicate,p,a);m!==true&&(u.predicate=w(m)),b(r,e.to.permission,p,n)&&(u.permission="not authorized");let d={};return (c.predicate||c.permission)&&(d.from=c),(u.predicate||u.permission)&&(d.to=u),d.from||d.to?d:true};var k=e=>{let t=[];return e.from?.predicate&&t.push(`from: ${e.from.predicate}`),e.from?.permission&&t.push(`from: ${e.from.permission}`),e.to?.predicate&&t.push(`to: ${e.to.predicate}`),e.to?.permission&&t.push(`to: ${e.to.permission}`),t.join("; ")||"unknown"},X=e=>e.paths.length===0?"no transition path available":e.paths.length===1?k(e.paths[0]):e.paths.map((t,i)=>`path ${i}: ${k(t)}`).join(" | ");var x=(e,t,i)=>{let o=e[t]?.[i];if(!o)throw new Error(`transition: no action "${i}" registered on resource "${t}"`);return o},ie=(e,t,i,o,n={},r={})=>{let a=x(e,t,i),p=[];for(let c of a.paths){let s=A(c,o,n,r);if(s===true)return true;p.push(s);}return {paths:p}},oe=(e,t,i,o={})=>{let n=e[t];if(!n)return [];let{actor:r,authorize:a,...p}=o,c=(s,u)=>!a||s===void 0||a(s,u,r);return Object.entries(n).filter(([,s])=>s.paths.some(u=>jsonRules.check(u.from.predicate,i,p)===true&&c(u.from.permission,i))).map(([s])=>s)},ne=(e,t,i,o={})=>{let n=x(e,t,i),{bindings:r={},...a}=o,p=jsonRules.bindRule({any:n.paths.map(s=>s.from.predicate)},r),{steps:c}=jsonRules.toPrisma(p,a);return c[c.length-1].where};var ae=e=>f(e.to.merge);var E=new Set(["spread","deepMerge"]),N=new Set(["append","appendUnique"]),D=(e,t,i,o)=>{if(e===void 0){t.push({path:i,message:"predicate is required",code:"missing_predicate"});return}let n=[...jsonRules.validateRule(e).errors,...o?jsonRules.validateRuleInLens(e,o).errors:[]];for(let r of n)t.push({...r,path:`${i}.${r.path}`});},U=(e,t,i)=>{if(e===void 0)return;let o=actionRuleSchema.actionRuleSchema.safeParse(e);if(!o.success)for(let n of o.error.issues)n.path.length===0?t.push({path:i,message:"unrecognized ActionRule shape",code:"invalid_permission"}):t.push({path:`${i}.${n.path.join(".")}`,message:n.message,code:"invalid_permission"});},W=(e,t,i)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){E.has(e)||t.push({path:i,message:`unknown merge strategy "${e}"`,code:"invalid_merge"});return}N.has(e.kind)?e.path||t.push({path:i,message:`merge "${e.kind}" requires a \`path\``,code:"invalid_merge"}):t.push({path:i,message:`unknown merge kind "${e.kind}"`,code:"invalid_merge"});}},S=(e,t,i,o)=>{if(e===null||typeof e!="object"){t.push({path:i,message:`\`${i}\` side is required`,code:"missing_side"});return}D(e.predicate,t,`${i}.predicate`,o.lens),U(e.permission,t,`${i}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${i}.requires`,message:"`requires` must be a Prisma-include-shaped object",code:"invalid_requires"}),"merge"in e&&W(e.merge,t,`${i}.merge`);},fe=(e,t={})=>{let i=[];return S(e?.from,i,"from",t),S(e?.to,i,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&i.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy",code:"unserializable_merge"}),{ok:i.length===0,errors:i}};exports.applyMerge=h;exports.available=oe;exports.checkPath=A;exports.checkTransition=ie;exports.createAuthorize=K;exports.describe=X;exports.eligible=ne;exports.isSerializable=ae;exports.isSerializableMerge=f;exports.validateTransition=fe;//# sourceMappingURL=index.cjs.map
2
2
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","resolveRelation","_resource","segment","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","i","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","eligible","steps","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","predicate","errors","lens","validateRule","issue","lensCheck","checkRuleAgainstLens","violation","validatePermission","parsed","actionRuleSchema","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type ResolveRelation,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\n// permissions surfaces a cyclic permission graph by throwing; the transitions guard denies (fail\n// closed) so a misconfigured schema terminates cleanly instead of propagating out of the kernel.\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /**\n * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).\n * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved\n * by the engine from `schema.bridges`, not here.\n */\n resolveRelation?: ResolveRelation<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\n// The transitions seam carries no pre-granted (role-derived) permix state, so a direct permix grant\n// always misses and authorization is decided entirely by the schema. The actor supplies only its id\n// (for `{ self }`) and an optional superadmin bypass.\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getUserId: () => actor?.id ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,\n * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const resolveRelation: ResolveRelation<R> =\n options.resolveRelation ?? ((_resource, segment) => segment as R);\n const check = createRebacCheck<R>(resolveRelation);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n 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, 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 // toPrisma always terminates a plan in a WhereStep (and throws on count-based ops,\n // which would need a multi-step plan, since we pass no map/model). Trust that contract.\n const { steps } = toPrisma({ any: found.paths.map((path) => path.from.predicate) });\n return (steps[steps.length - 1] as { where: Row }).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 { actionRuleSchema } from '@inixiative/permissions/actionRuleSchema';\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 | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required' });\n return;\n }\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\n// Validate the whole ActionRule against `@inixiative/permissions`' zod schema — the single source of\n// truth for the algebra (boolean terminals, string delegation, `{ rel, action }`, `{ self }`, abac\n// `{ rule }`, `any`/`all`, `null`). A malformed rule yields a structured issue rather than throwing.\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return; // absent = open\n const parsed = actionRuleSchema.safeParse(rule);\n if (parsed.success) return;\n for (const issue of parsed.error.issues) {\n // A root union failure (zod reports an empty relative path) means none of the ActionRule shapes\n // matched; nested issues keep their zod path + message.\n if (issue.path.length === 0) {\n errors.push({ path, message: 'unrecognized ActionRule shape' });\n } else {\n errors.push({ path: `${path}.${issue.path.join('.')}`, message: issue.message });\n }\n }\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"` });\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 | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required` });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `checkRuleAgainstLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
1
+ {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","resolveRelation","_resource","segment","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","evaluation","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","eligible","bindings","compile","predicate","bindRule","steps","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","errors","lens","issues","validateRule","validateRuleInLens","issue","validatePermission","parsed","actionRuleSchema","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type ResolveRelation,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\n// permissions surfaces a cyclic permission graph by throwing; the transitions guard denies (fail\n// closed) so a misconfigured schema terminates cleanly instead of propagating out of the kernel.\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /**\n * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).\n * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved\n * by the engine from `schema.bridges`, not here.\n */\n resolveRelation?: ResolveRelation<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\n// The transitions seam carries no pre-granted (role-derived) permix state, so a direct permix grant\n// always misses and authorization is decided entirely by the schema. The actor supplies only its id\n// (for `{ self }`) and an optional superadmin bypass.\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getUserId: () => actor?.id ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,\n * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const resolveRelation: ResolveRelation<R> =\n options.resolveRelation ?? ((_resource, segment) => segment as R);\n const check = createRebacCheck<R>(resolveRelation);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n PathReason,\n Row,\n SideReason,\n Transition,\n TransitionOptions,\n} from './types';\n\nconst predicateReason = (result: boolean | string): string =>\n typeof result === 'string' ? result : 'predicate not satisfied';\n\n/**\n * Does this permission DENY?\n * - no authorizer injected → can't deny (legality-only mode)\n * - `undefined` rule → permission absent → open → can't deny\n * - any other rule (incl. `null` = terminal deny) → delegate to the authorizer\n */\nconst denies = (\n authorize: Authorize | undefined,\n rule: ActionRule | undefined,\n record: Row,\n actor: Actor,\n): boolean => {\n if (!authorize || rule === undefined) return false;\n return !authorize(rule, record, actor);\n};\n\n/**\n * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —\n * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole\n * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns\n * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;\n * json-rules' `check()` options (`now`, `bindings`, `context`, …) reach both predicates.\n */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: TransitionOptions = {},\n): true | PathReason => {\n const { actor, authorize, ...evaluation } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const from: SideReason = {};\n const fromPredicate = checkRule(transition.from.predicate, record as Row, evaluation);\n if (fromPredicate !== true) from.predicate = predicateReason(fromPredicate);\n if (denies(authorize, transition.from.permission, record as Row, actor))\n from.permission = 'not authorized';\n\n const to: SideReason = {};\n const toPredicate = checkRule(transition.to.predicate, next as Row, evaluation);\n if (toPredicate !== true) to.predicate = predicateReason(toPredicate);\n if (denies(authorize, transition.to.permission, next as Row, actor))\n to.permission = 'not authorized';\n\n const reason: PathReason = {};\n if (from.predicate || from.permission) reason.from = from;\n if (to.predicate || to.permission) reason.to = to;\n return reason.from || reason.to ? reason : true;\n};\n","import type { PathReason, Reason } from './types';\n\nconst describePath = (path: PathReason): string => {\n const segs: string[] = [];\n if (path.from?.predicate) segs.push(`from: ${path.from.predicate}`);\n if (path.from?.permission) segs.push(`from: ${path.from.permission}`);\n if (path.to?.predicate) segs.push(`to: ${path.to.predicate}`);\n if (path.to?.permission) segs.push(`to: ${path.to.permission}`);\n return segs.join('; ') || 'unknown';\n};\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n if (reason.paths.length === 0) return 'no transition path available';\n if (reason.paths.length === 1) return describePath(reason.paths[0]);\n return reason.paths.map((path, i) => `path ${i}: ${describePath(path)}`).join(' | ');\n};\n","import { bindRule, check as checkRule, toPrisma } from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n CheckResult,\n PathReason,\n PredicateOptions,\n Row,\n TransitionMap,\n TransitionOptions,\n} from './types';\n\nconst getAction = (rules: TransitionMap, resource: string, action: string): Action => {\n const found = rules[resource]?.[action];\n if (!found)\n throw new Error(`transition: no action \"${action}\" registered on resource \"${resource}\"`);\n return found;\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches\n * the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a\n * {@link Reason} with one {@link PathReason} per candidate path tried.\n *\n * `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`\n * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound\n * to this resource); a `predicate` that reads a bridged relation expects a stitched record.\n */\nexport const checkTransition = (\n rules: TransitionMap,\n resource: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: TransitionOptions = {},\n): CheckResult => {\n const found = getAction(rules, resource, action);\n const paths: PathReason[] = [];\n for (const path of found.paths) {\n const result = checkPath(path, record, changes, options);\n if (result === true) return true;\n paths.push(result);\n }\n return { paths };\n};\n\n/**\n * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`\n * side (predicate + `from` permission against the current record) — `to` needs the merged record,\n * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.\n */\nexport const available = (\n rules: TransitionMap,\n resource: string,\n record: Row,\n options: TransitionOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize, ...evaluation } = options;\n\n const allows = (rule: ActionRule | undefined, rec: Row): boolean =>\n !authorize || rule === undefined || authorize(rule, rec, actor);\n\n return Object.entries(actions)\n .filter(([, action]) =>\n action.paths.some(\n (path) =>\n checkRule(path.from.predicate, record, evaluation) === true &&\n allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n/**\n * Set query: one Prisma `where` matching every record currently eligible for `action` (the\n * union of all its paths' `from` predicates; a single path compiles to its predicate alone).\n * Empty action → match-nothing. Takes the same\n * json-rules `check()` options: `bindings` are resolved into the predicate before compiling, and\n * `now` / `context` reach `toPrisma`, so the set query selects the rows the single check accepts.\n * A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude) throws.\n */\nexport const eligible = (\n rules: TransitionMap,\n resource: string,\n action: string,\n options: PredicateOptions = {},\n): Row => {\n const found = getAction(rules, resource, action);\n const { bindings = {}, ...compile } = options;\n const predicate = bindRule({ any: found.paths.map((path) => path.from.predicate) }, bindings);\n // toPrisma always terminates a plan in a WhereStep (and throws on count-based ops,\n // which would need a multi-step plan, since we pass no map/model). Trust that contract.\n const { steps } = toPrisma(predicate, compile);\n return (steps[steps.length - 1] as { where: Row }).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 type Lens,\n type LensNarrowing,\n type ValidationIssue,\n type ValidationResult,\n validateRule,\n validateRuleInLens,\n} from '@inixiative/json-rules';\nimport { actionRuleSchema } from '@inixiative/permissions/actionRuleSchema';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type { ValidationIssue, ValidationResult };\n\nexport type ValidateOptions = {\n /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */\n lens?: Lens | LensNarrowing;\n /** Reject callback merges (use when the transition must be persistable / tenant-configured). */\n requireSerializable?: boolean;\n};\n\nconst MERGE_KEYWORDS = new Set(['spread', 'deepMerge']);\nconst ARRAY_KINDS = new Set(['append', 'appendUnique']);\n\nconst validatePredicate = (\n predicate: Condition | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required', code: 'missing_predicate' });\n return;\n }\n const issues = [\n ...validateRule(predicate).errors,\n ...(lens ? validateRuleInLens(predicate, lens).errors : []),\n ];\n for (const issue of issues) errors.push({ ...issue, path: `${path}.${issue.path}` });\n};\n\n// Validate the whole ActionRule against `@inixiative/permissions`' zod schema — the single source of\n// truth for the algebra (boolean terminals, string delegation, `{ rel, action }`, `{ self }`, abac\n// `{ rule }`, `any`/`all`, `null`). A malformed rule yields a structured issue rather than throwing.\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return; // absent = open\n const parsed = actionRuleSchema.safeParse(rule);\n if (parsed.success) return;\n for (const issue of parsed.error.issues) {\n // A root union failure (zod reports an empty relative path) means none of the ActionRule shapes\n // matched; nested issues keep their zod path + message.\n if (issue.path.length === 0) {\n errors.push({ path, message: 'unrecognized ActionRule shape', code: 'invalid_permission' });\n } else {\n errors.push({\n path: `${path}.${issue.path.join('.')}`,\n message: issue.message,\n code: 'invalid_permission',\n });\n }\n }\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"`, code: 'invalid_merge' });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"`, code: 'invalid_merge' });\n else if (!merge.path)\n errors.push({\n path,\n message: `merge \"${merge.kind}\" requires a \\`path\\``,\n code: 'invalid_merge',\n });\n};\n\nconst validateSide = (\n side: Side | ToSide | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required`, code: 'missing_side' });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n code: 'invalid_requires',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n code: 'unserializable_merge',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
package/dist/index.d.cts CHANGED
@@ -1,8 +1,7 @@
1
1
  import { ActionRule, RebacSchema, ResolveRelation, Subject } from '@inixiative/permissions';
2
2
  export { ActionRule } from '@inixiative/permissions';
3
- import { Condition, Lens, LensNarrowing } from '@inixiative/json-rules';
4
-
5
- type Row = Record<string, unknown>;
3
+ import { Row, Condition, CheckOptions, CompileOptions, Lens, LensNarrowing, ValidationResult } from '@inixiative/json-rules';
4
+ export { Row, ValidationIssue, ValidationResult } from '@inixiative/json-rules';
6
5
 
7
6
  type Actor = ({
8
7
  id?: string | null;
@@ -77,6 +76,14 @@ type AuthorizeOptions = {
77
76
  actor?: Actor;
78
77
  authorize?: Authorize;
79
78
  };
79
+ /**
80
+ * json-rules' own `check()` options — `now` / `timeZone` / `weekStart` for relative dates,
81
+ * `bindings` for `{ bind }` tokens — with `context` the compilers' (a {@link Row}), so the same
82
+ * options serve `check()` and {@link eligible}'s `toPrisma`.
83
+ */
84
+ type PredicateOptions = Omit<CheckOptions, 'context'> & Pick<CompileOptions, 'context'>;
85
+ /** A transition check: who acts, and what its predicates evaluate with. */
86
+ type TransitionOptions = AuthorizeOptions & PredicateOptions;
80
87
 
81
88
  type PermissionsAuthorizeOptions<R extends string = string> = {
82
89
  /** The permissions rebac schema: `{ bridges?, permissions }`. */
@@ -110,9 +117,10 @@ declare const createAuthorize: <R extends string = string>(options: PermissionsA
110
117
  * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —
111
118
  * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole
112
119
  * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns
113
- * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only.
120
+ * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;
121
+ * json-rules' `check()` options (`now`, `bindings`, `context`, …) reach both predicates.
114
122
  */
115
- declare const checkPath: <R extends Row>(transition: Transition<R>, record: R, changes?: Partial<R>, options?: AuthorizeOptions) => true | PathReason;
123
+ declare const checkPath: <R extends Row>(transition: Transition<R>, record: R, changes?: Partial<R>, options?: TransitionOptions) => true | PathReason;
116
124
 
117
125
  /** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */
118
126
  declare const describe: (reason: Reason) => string;
@@ -139,18 +147,22 @@ declare const applyMerge: <R extends Row>(merge: Merge<R> | undefined, record: R
139
147
  * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound
140
148
  * to this resource); a `predicate` that reads a bridged relation expects a stitched record.
141
149
  */
142
- declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: AuthorizeOptions) => CheckResult;
150
+ declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: TransitionOptions) => CheckResult;
143
151
  /**
144
152
  * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`
145
153
  * side (predicate + `from` permission against the current record) — `to` needs the merged record,
146
154
  * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.
147
155
  */
148
- declare const available: (rules: TransitionMap, resource: string, record: Row, options?: AuthorizeOptions) => string[];
156
+ declare const available: (rules: TransitionMap, resource: string, record: Row, options?: TransitionOptions) => string[];
149
157
  /**
150
- * Set query: one OR'd Prisma `where` matching every record currently eligible for `action`
151
- * (the union of all its paths' `from` predicates). Empty action → match-nothing.
158
+ * Set query: one Prisma `where` matching every record currently eligible for `action` (the
159
+ * union of all its paths' `from` predicates; a single path compiles to its predicate alone).
160
+ * Empty action → match-nothing. Takes the same
161
+ * json-rules `check()` options: `bindings` are resolved into the predicate before compiling, and
162
+ * `now` / `context` reach `toPrisma`, so the set query selects the rows the single check accepts.
163
+ * A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude) throws.
152
164
  */
153
- declare const eligible: (rules: TransitionMap, resource: string, action: string) => Row;
165
+ declare const eligible: (rules: TransitionMap, resource: string, action: string, options?: PredicateOptions) => Row;
154
166
 
155
167
  /**
156
168
  * Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?
@@ -160,14 +172,6 @@ declare const eligible: (rules: TransitionMap, resource: string, action: string)
160
172
  */
161
173
  declare const isSerializable: (transition: Transition) => boolean;
162
174
 
163
- type ValidationIssue = {
164
- path: string;
165
- message: string;
166
- };
167
- type ValidationResult = {
168
- ok: boolean;
169
- errors: ValidationIssue[];
170
- };
171
175
  type ValidateOptions = {
172
176
  /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */
173
177
  lens?: Lens | LensNarrowing;
@@ -177,10 +181,10 @@ type ValidateOptions = {
177
181
  /**
178
182
  * Authoring validation for a single transition — run on save before persisting a tenant config.
179
183
  * Returns structured issues (never throws) on malformed input: predicate validity delegates to
180
- * json-rules (`validateRule`, plus `checkRuleAgainstLens` when a `lens` is supplied for
184
+ * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for
181
185
  * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;
182
186
  * merge strategy is checked here.
183
187
  */
184
188
  declare const validateTransition: (transition: Transition, options?: ValidateOptions) => ValidationResult;
185
189
 
186
- export { type Action, type Actor, type Authorize, type AuthorizeOptions, type CheckResult, type Include, type Merge, type MergeStrategy, type PathReason, type PermissionsAuthorizeOptions, type Reason, type Row, type Side, type SideReason, type ToSide, type Transition, type TransitionMap, type ValidateOptions, type ValidationIssue, type ValidationResult, applyMerge, available, checkPath, checkTransition, createAuthorize, describe, eligible, isSerializable, isSerializableMerge, validateTransition };
190
+ export { type Action, type Actor, type Authorize, type AuthorizeOptions, type CheckResult, type Include, type Merge, type MergeStrategy, type PathReason, type PermissionsAuthorizeOptions, type PredicateOptions, type Reason, type Side, type SideReason, type ToSide, type Transition, type TransitionMap, type TransitionOptions, type ValidateOptions, applyMerge, available, checkPath, checkTransition, createAuthorize, describe, eligible, isSerializable, isSerializableMerge, validateTransition };
package/dist/index.d.ts CHANGED
@@ -1,8 +1,7 @@
1
1
  import { ActionRule, RebacSchema, ResolveRelation, Subject } from '@inixiative/permissions';
2
2
  export { ActionRule } from '@inixiative/permissions';
3
- import { Condition, Lens, LensNarrowing } from '@inixiative/json-rules';
4
-
5
- type Row = Record<string, unknown>;
3
+ import { Row, Condition, CheckOptions, CompileOptions, Lens, LensNarrowing, ValidationResult } from '@inixiative/json-rules';
4
+ export { Row, ValidationIssue, ValidationResult } from '@inixiative/json-rules';
6
5
 
7
6
  type Actor = ({
8
7
  id?: string | null;
@@ -77,6 +76,14 @@ type AuthorizeOptions = {
77
76
  actor?: Actor;
78
77
  authorize?: Authorize;
79
78
  };
79
+ /**
80
+ * json-rules' own `check()` options — `now` / `timeZone` / `weekStart` for relative dates,
81
+ * `bindings` for `{ bind }` tokens — with `context` the compilers' (a {@link Row}), so the same
82
+ * options serve `check()` and {@link eligible}'s `toPrisma`.
83
+ */
84
+ type PredicateOptions = Omit<CheckOptions, 'context'> & Pick<CompileOptions, 'context'>;
85
+ /** A transition check: who acts, and what its predicates evaluate with. */
86
+ type TransitionOptions = AuthorizeOptions & PredicateOptions;
80
87
 
81
88
  type PermissionsAuthorizeOptions<R extends string = string> = {
82
89
  /** The permissions rebac schema: `{ bridges?, permissions }`. */
@@ -110,9 +117,10 @@ declare const createAuthorize: <R extends string = string>(options: PermissionsA
110
117
  * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —
111
118
  * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole
112
119
  * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns
113
- * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only.
120
+ * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;
121
+ * json-rules' `check()` options (`now`, `bindings`, `context`, …) reach both predicates.
114
122
  */
115
- declare const checkPath: <R extends Row>(transition: Transition<R>, record: R, changes?: Partial<R>, options?: AuthorizeOptions) => true | PathReason;
123
+ declare const checkPath: <R extends Row>(transition: Transition<R>, record: R, changes?: Partial<R>, options?: TransitionOptions) => true | PathReason;
116
124
 
117
125
  /** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */
118
126
  declare const describe: (reason: Reason) => string;
@@ -139,18 +147,22 @@ declare const applyMerge: <R extends Row>(merge: Merge<R> | undefined, record: R
139
147
  * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound
140
148
  * to this resource); a `predicate` that reads a bridged relation expects a stitched record.
141
149
  */
142
- declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: AuthorizeOptions) => CheckResult;
150
+ declare const checkTransition: (rules: TransitionMap, resource: string, action: string, record: Row, changes?: Row, options?: TransitionOptions) => CheckResult;
143
151
  /**
144
152
  * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`
145
153
  * side (predicate + `from` permission against the current record) — `to` needs the merged record,
146
154
  * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.
147
155
  */
148
- declare const available: (rules: TransitionMap, resource: string, record: Row, options?: AuthorizeOptions) => string[];
156
+ declare const available: (rules: TransitionMap, resource: string, record: Row, options?: TransitionOptions) => string[];
149
157
  /**
150
- * Set query: one OR'd Prisma `where` matching every record currently eligible for `action`
151
- * (the union of all its paths' `from` predicates). Empty action → match-nothing.
158
+ * Set query: one Prisma `where` matching every record currently eligible for `action` (the
159
+ * union of all its paths' `from` predicates; a single path compiles to its predicate alone).
160
+ * Empty action → match-nothing. Takes the same
161
+ * json-rules `check()` options: `bindings` are resolved into the predicate before compiling, and
162
+ * `now` / `context` reach `toPrisma`, so the set query selects the rows the single check accepts.
163
+ * A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude) throws.
152
164
  */
153
- declare const eligible: (rules: TransitionMap, resource: string, action: string) => Row;
165
+ declare const eligible: (rules: TransitionMap, resource: string, action: string, options?: PredicateOptions) => Row;
154
166
 
155
167
  /**
156
168
  * Can this transition be persisted (stored in the DB, edited in a UI, sent over the wire)?
@@ -160,14 +172,6 @@ declare const eligible: (rules: TransitionMap, resource: string, action: string)
160
172
  */
161
173
  declare const isSerializable: (transition: Transition) => boolean;
162
174
 
163
- type ValidationIssue = {
164
- path: string;
165
- message: string;
166
- };
167
- type ValidationResult = {
168
- ok: boolean;
169
- errors: ValidationIssue[];
170
- };
171
175
  type ValidateOptions = {
172
176
  /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */
173
177
  lens?: Lens | LensNarrowing;
@@ -177,10 +181,10 @@ type ValidateOptions = {
177
181
  /**
178
182
  * Authoring validation for a single transition — run on save before persisting a tenant config.
179
183
  * Returns structured issues (never throws) on malformed input: predicate validity delegates to
180
- * json-rules (`validateRule`, plus `checkRuleAgainstLens` when a `lens` is supplied for
184
+ * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for
181
185
  * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;
182
186
  * merge strategy is checked here.
183
187
  */
184
188
  declare const validateTransition: (transition: Transition, options?: ValidateOptions) => ValidationResult;
185
189
 
186
- export { type Action, type Actor, type Authorize, type AuthorizeOptions, type CheckResult, type Include, type Merge, type MergeStrategy, type PathReason, type PermissionsAuthorizeOptions, type Reason, type Row, type Side, type SideReason, type ToSide, type Transition, type TransitionMap, type ValidateOptions, type ValidationIssue, type ValidationResult, applyMerge, available, checkPath, checkTransition, createAuthorize, describe, eligible, isSerializable, isSerializableMerge, validateTransition };
190
+ export { type Action, type Actor, type Authorize, type AuthorizeOptions, type CheckResult, type Include, type Merge, type MergeStrategy, type PathReason, type PermissionsAuthorizeOptions, type PredicateOptions, type Reason, type Side, type SideReason, type ToSide, type Transition, type TransitionMap, type TransitionOptions, type ValidateOptions, applyMerge, available, checkPath, checkTransition, createAuthorize, describe, eligible, isSerializable, isSerializableMerge, validateTransition };
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- import {createRebacCheck}from'@inixiative/permissions';import {check,toPrisma,validateRule,checkRuleAgainstLens}from'@inixiative/json-rules';import {mergeWith,cloneDeep,get,set,uniqWith,isEqual}from'lodash-es';import {actionRuleSchema}from'@inixiative/permissions/actionRuleSchema';var z=/Cycle detected/,P=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getUserId:()=>e?.id??null}),W=e=>{let t=e.resolveRelation??((i,n)=>n),o=createRebacCheck(t);return i=>(n,r,a)=>{let p=P(a,e.isSuperadmin),c={resource:i,record:r,data:e.data?.(r,a)};try{return o(p,e.schema,c,n)}catch(s){if(s instanceof Error&&z.test(s.message))return false;throw s}}};var R=e=>Array.isArray(e)?e:e===void 0?[]:[e],q=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,o={})=>{if(typeof e=="function")return e(t,o);let i=e??"spread";if(i==="spread")return {...t,...o};if(i==="deepMerge")return mergeWith(cloneDeep(t),cloneDeep(o),q);let{kind:n,path:r}=i,a=cloneDeep({...t,...o}),p=[...R(get(t,r)),...R(get(o,r))];return set(a,r,n==="appendUnique"?uniqWith(p,isEqual):p),a};var y=e=>typeof e=="string"?e:"predicate not satisfied",A=(e,t,o,i)=>!e||t===void 0?false:!e(t,o,i),w=(e,t,o={},i={})=>{let{actor:n,authorize:r}=i,a=h(e.to.merge,t,o),p={},c=check(e.from.predicate,t);c!==true&&(p.predicate=y(c)),A(r,e.from.permission,t,n)&&(p.permission="not authorized");let s={},m=check(e.to.predicate,a);m!==true&&(s.predicate=y(m)),A(r,e.to.permission,a,n)&&(s.permission="not authorized");let u={};return (p.predicate||p.permission)&&(u.from=p),(s.predicate||s.permission)&&(u.to=s),u.from||u.to?u:true};var b=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"},J=e=>e.paths.length===0?"no transition path available":e.paths.length===1?b(e.paths[0]):e.paths.map((t,o)=>`path ${o}: ${b(t)}`).join(" | ");var k=(e,t,o)=>{let i=e[t]?.[o];if(!i)throw new Error(`transition: no action "${o}" registered on resource "${t}"`);return i},ee=(e,t,o,i,n={},r={})=>{let a=k(e,t,o),p=[];for(let c of a.paths){let s=w(c,i,n,r);if(s===true)return true;p.push(s);}return {paths:p}},te=(e,t,o,i={})=>{let n=e[t];if(!n)return [];let{actor:r,authorize:a}=i,p=(c,s)=>!a||c===void 0||a(c,s,r);return Object.entries(n).filter(([,c])=>c.paths.some(s=>check(s.from.predicate,o)===true&&p(s.from.permission,o))).map(([c])=>c)},oe=(e,t,o)=>{let i=k(e,t,o),{steps:n}=toPrisma({any:i.paths.map(r=>r.from.predicate)});return n[n.length-1].where};var re=e=>f(e.to.merge);var I=new Set(["spread","deepMerge"]),E=new Set(["append","appendUnique"]),N=(e,t,o,i)=>{if(e===void 0){t.push({path:o,message:"predicate is required"});return}let n=validateRule(e);for(let r of n.errors)t.push({path:`${o}.${r.path}`,message:r.message});if(i){let r=checkRuleAgainstLens(e,i);for(let a of r.violations)t.push({path:`${o}.${a.path}`,message:a.reason});}},_=(e,t,o)=>{if(e===void 0)return;let i=actionRuleSchema.safeParse(e);if(!i.success)for(let n of i.error.issues)n.path.length===0?t.push({path:o,message:"unrecognized ActionRule shape"}):t.push({path:`${o}.${n.path.join(".")}`,message:n.message});},D=(e,t,o)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){I.has(e)||t.push({path:o,message:`unknown merge strategy "${e}"`});return}E.has(e.kind)?e.path||t.push({path:o,message:`merge "${e.kind}" requires a \`path\``}):t.push({path:o,message:`unknown merge kind "${e.kind}"`});}},x=(e,t,o,i)=>{if(e===null||typeof e!="object"){t.push({path:o,message:`\`${o}\` side is required`});return}N(e.predicate,t,`${o}.predicate`,i.lens),_(e.permission,t,`${o}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${o}.requires`,message:"`requires` must be a Prisma-include-shaped object"}),"merge"in e&&D(e.merge,t,`${o}.merge`);},ue=(e,t={})=>{let o=[];return x(e?.from,o,"from",t),x(e?.to,o,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&o.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy"}),{ok:o.length===0,errors:o}};export{h as applyMerge,te as available,w as checkPath,ee as checkTransition,W as createAuthorize,J as describe,oe as eligible,re as isSerializable,f as isSerializableMerge,ue as validateTransition};//# sourceMappingURL=index.js.map
1
+ import {createRebacCheck}from'@inixiative/permissions';import {check,bindRule,toPrisma,validateRule,validateRuleInLens}from'@inixiative/json-rules';import {mergeWith,cloneDeep,get,set,uniqWith,isEqual}from'lodash-es';import {actionRuleSchema}from'@inixiative/permissions/actionRuleSchema';var v=/Cycle detected/,M=(e,t)=>({check:()=>false,isSuperadmin:()=>t?.(e)??false,getUserId:()=>e?.id??null}),K=e=>{let t=e.resolveRelation??((o,n)=>n),i=createRebacCheck(t);return o=>(n,r,a)=>{let p=M(a,e.isSuperadmin),c={resource:o,record:r,data:e.data?.(r,a)};try{return i(p,e.schema,c,n)}catch(s){if(s instanceof Error&&v.test(s.message))return false;throw s}}};var g=e=>Array.isArray(e)?e:e===void 0?[]:[e],O=(e,t)=>Array.isArray(t)?t:void 0,f=e=>typeof e!="function",h=(e,t,i={})=>{if(typeof e=="function")return e(t,i);let o=e??"spread";if(o==="spread")return {...t,...i};if(o==="deepMerge")return mergeWith(cloneDeep(t),cloneDeep(i),O);let{kind:n,path:r}=o,a=cloneDeep({...t,...i}),p=[...g(get(t,r)),...g(get(i,r))];return set(a,r,n==="appendUnique"?uniqWith(p,isEqual):p),a};var w=e=>typeof e=="string"?e:"predicate not satisfied",b=(e,t,i,o)=>!e||t===void 0?false:!e(t,i,o),A=(e,t,i={},o={})=>{let{actor:n,authorize:r,...a}=o,p=h(e.to.merge,t,i),c={},s=check(e.from.predicate,t,a);s!==true&&(c.predicate=w(s)),b(r,e.from.permission,t,n)&&(c.permission="not authorized");let u={},m=check(e.to.predicate,p,a);m!==true&&(u.predicate=w(m)),b(r,e.to.permission,p,n)&&(u.permission="not authorized");let d={};return (c.predicate||c.permission)&&(d.from=c),(u.predicate||u.permission)&&(d.to=u),d.from||d.to?d:true};var k=e=>{let t=[];return e.from?.predicate&&t.push(`from: ${e.from.predicate}`),e.from?.permission&&t.push(`from: ${e.from.permission}`),e.to?.predicate&&t.push(`to: ${e.to.predicate}`),e.to?.permission&&t.push(`to: ${e.to.permission}`),t.join("; ")||"unknown"},X=e=>e.paths.length===0?"no transition path available":e.paths.length===1?k(e.paths[0]):e.paths.map((t,i)=>`path ${i}: ${k(t)}`).join(" | ");var x=(e,t,i)=>{let o=e[t]?.[i];if(!o)throw new Error(`transition: no action "${i}" registered on resource "${t}"`);return o},ie=(e,t,i,o,n={},r={})=>{let a=x(e,t,i),p=[];for(let c of a.paths){let s=A(c,o,n,r);if(s===true)return true;p.push(s);}return {paths:p}},oe=(e,t,i,o={})=>{let n=e[t];if(!n)return [];let{actor:r,authorize:a,...p}=o,c=(s,u)=>!a||s===void 0||a(s,u,r);return Object.entries(n).filter(([,s])=>s.paths.some(u=>check(u.from.predicate,i,p)===true&&c(u.from.permission,i))).map(([s])=>s)},ne=(e,t,i,o={})=>{let n=x(e,t,i),{bindings:r={},...a}=o,p=bindRule({any:n.paths.map(s=>s.from.predicate)},r),{steps:c}=toPrisma(p,a);return c[c.length-1].where};var ae=e=>f(e.to.merge);var E=new Set(["spread","deepMerge"]),N=new Set(["append","appendUnique"]),D=(e,t,i,o)=>{if(e===void 0){t.push({path:i,message:"predicate is required",code:"missing_predicate"});return}let n=[...validateRule(e).errors,...o?validateRuleInLens(e,o).errors:[]];for(let r of n)t.push({...r,path:`${i}.${r.path}`});},U=(e,t,i)=>{if(e===void 0)return;let o=actionRuleSchema.safeParse(e);if(!o.success)for(let n of o.error.issues)n.path.length===0?t.push({path:i,message:"unrecognized ActionRule shape",code:"invalid_permission"}):t.push({path:`${i}.${n.path.join(".")}`,message:n.message,code:"invalid_permission"});},W=(e,t,i)=>{if(!(e===void 0||typeof e=="function")){if(typeof e=="string"){E.has(e)||t.push({path:i,message:`unknown merge strategy "${e}"`,code:"invalid_merge"});return}N.has(e.kind)?e.path||t.push({path:i,message:`merge "${e.kind}" requires a \`path\``,code:"invalid_merge"}):t.push({path:i,message:`unknown merge kind "${e.kind}"`,code:"invalid_merge"});}},S=(e,t,i,o)=>{if(e===null||typeof e!="object"){t.push({path:i,message:`\`${i}\` side is required`,code:"missing_side"});return}D(e.predicate,t,`${i}.predicate`,o.lens),U(e.permission,t,`${i}.permission`),e.requires!==void 0&&(typeof e.requires!="object"||e.requires===null)&&t.push({path:`${i}.requires`,message:"`requires` must be a Prisma-include-shaped object",code:"invalid_requires"}),"merge"in e&&W(e.merge,t,`${i}.merge`);},fe=(e,t={})=>{let i=[];return S(e?.from,i,"from",t),S(e?.to,i,"to",t),t.requireSerializable&&!f(e?.to?.merge)&&i.push({path:"to.merge",message:"callback merge is not serializable; use a keyword strategy",code:"unserializable_merge"}),{ok:i.length===0,errors:i}};export{h as applyMerge,oe as available,A as checkPath,ie as checkTransition,K as createAuthorize,X as describe,ne as eligible,ae as isSerializable,f as isSerializableMerge,fe as validateTransition};//# sourceMappingURL=index.js.map
2
2
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","resolveRelation","_resource","segment","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","i","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","eligible","steps","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","predicate","errors","lens","validateRule","issue","lensCheck","checkRuleAgainstLens","violation","validatePermission","parsed","actionRuleSchema","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.js","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type ResolveRelation,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\n// permissions surfaces a cyclic permission graph by throwing; the transitions guard denies (fail\n// closed) so a misconfigured schema terminates cleanly instead of propagating out of the kernel.\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /**\n * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).\n * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved\n * by the engine from `schema.bridges`, not here.\n */\n resolveRelation?: ResolveRelation<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\n// The transitions seam carries no pre-granted (role-derived) permix state, so a direct permix grant\n// always misses and authorization is decided entirely by the schema. The actor supplies only its id\n// (for `{ self }`) and an optional superadmin bypass.\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getUserId: () => actor?.id ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,\n * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const resolveRelation: ResolveRelation<R> =\n options.resolveRelation ?? ((_resource, segment) => segment as R);\n const check = createRebacCheck<R>(resolveRelation);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n 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, 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 // toPrisma always terminates a plan in a WhereStep (and throws on count-based ops,\n // which would need a multi-step plan, since we pass no map/model). Trust that contract.\n const { steps } = toPrisma({ any: found.paths.map((path) => path.from.predicate) });\n return (steps[steps.length - 1] as { where: Row }).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 { actionRuleSchema } from '@inixiative/permissions/actionRuleSchema';\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 | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required' });\n return;\n }\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\n// Validate the whole ActionRule against `@inixiative/permissions`' zod schema — the single source of\n// truth for the algebra (boolean terminals, string delegation, `{ rel, action }`, `{ self }`, abac\n// `{ rule }`, `any`/`all`, `null`). A malformed rule yields a structured issue rather than throwing.\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return; // absent = open\n const parsed = actionRuleSchema.safeParse(rule);\n if (parsed.success) return;\n for (const issue of parsed.error.issues) {\n // A root union failure (zod reports an empty relative path) means none of the ActionRule shapes\n // matched; nested issues keep their zod path + message.\n if (issue.path.length === 0) {\n errors.push({ path, message: 'unrecognized ActionRule shape' });\n } else {\n errors.push({ path: `${path}.${issue.path.join('.')}`, message: issue.message });\n }\n }\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"` });\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 | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required` });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `checkRuleAgainstLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
1
+ {"version":3,"sources":["../src/authorize.ts","../src/merge.ts","../src/check.ts","../src/describe.ts","../src/registry.ts","../src/serializable.ts","../src/validate.ts"],"names":["CYCLE","actorPermix","actor","isSuperadmin","createAuthorize","options","resolveRelation","_resource","segment","check","createRebacCheck","resource","rule","record","permix","subject","error","toArray","value","replaceArrays","_target","source","isSerializableMerge","merge","applyMerge","changes","strategy","mergeWith","cloneDeep","kind","path","base","merged","get","set","uniqWith","isEqual","predicateReason","result","denies","authorize","checkPath","transition","evaluation","next","from","fromPredicate","checkRule","to","toPredicate","reason","describePath","segs","describe","getAction","rules","action","found","checkTransition","paths","available","actions","allows","rec","eligible","bindings","compile","predicate","bindRule","steps","toPrisma","isSerializable","MERGE_KEYWORDS","ARRAY_KINDS","validatePredicate","errors","lens","issues","validateRule","validateRuleInLens","issue","validatePermission","parsed","actionRuleSchema","validateMerge","validateSide","side","validateTransition"],"mappings":"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","file":"index.js","sourcesContent":["import {\n type ActionRule,\n createRebacCheck,\n type PermixLike,\n type RebacSchema,\n type ResolveRelation,\n type Subject,\n} from '@inixiative/permissions';\nimport type { Actor, Authorize, Row } from './types';\n\n// permissions surfaces a cyclic permission graph by throwing; the transitions guard denies (fail\n// closed) so a misconfigured schema terminates cleanly instead of propagating out of the kernel.\nconst CYCLE = /Cycle detected/;\n\nexport type PermissionsAuthorizeOptions<R extends string = string> = {\n /** The permissions rebac schema: `{ bridges?, permissions }`. */\n schema: RebacSchema<R>;\n /**\n * Resolve a hydrated relation field to the resource it points at (the ORM-specific seam).\n * Default: the relation segment name doubles as the resource key. Cross-map bridges are resolved\n * by the engine from `schema.bridges`, not here.\n */\n resolveRelation?: ResolveRelation<R>;\n /** Superadmin bypass, derived from the actor; checked before any rule. */\n isSuperadmin?: (actor: Actor) => boolean;\n /**\n * Supplemental hydrated rows (`map:model → rows`) for bridge (cross-map) `rel` walks, derived from\n * the record + actor — the same shape `Subject.data` takes. Only consulted when a walk crosses a\n * bridge and a downstream action reads the far record's fields.\n */\n data?: (record: Row, actor: Actor) => Subject<R>['data'];\n};\n\n// The transitions seam carries no pre-granted (role-derived) permix state, so a direct permix grant\n// always misses and authorization is decided entirely by the schema. The actor supplies only its id\n// (for `{ self }`) and an optional superadmin bypass.\nconst actorPermix = (actor: Actor, isSuperadmin?: (actor: Actor) => boolean): PermixLike => ({\n check: () => false,\n isSuperadmin: () => isSuperadmin?.(actor) ?? false,\n getUserId: () => actor?.id ?? null,\n});\n\n/**\n * Bridge `@inixiative/permissions`' rebac `check` onto transitions' {@link Authorize} seam — the\n * production evaluator, injected, not reimplemented. `createAuthorize(options)(resource)` returns an\n * `Authorize` bound to a (map-qualified) `resource`; each call evaluates a per-side `permission`\n * rule against a concrete record + actor. permissions owns the evaluation (string delegation with\n * cycle detection, intra-map `rel` walks via `resolveRelation`, cross-map bridge walks, `{ self }`,\n * abac `{ rule }`, boolean terminals, `any`/`all`, per-row `permissionRules` overrides).\n */\nexport const createAuthorize = <R extends string = string>(\n options: PermissionsAuthorizeOptions<R>,\n): ((resource: R) => Authorize) => {\n const resolveRelation: ResolveRelation<R> =\n options.resolveRelation ?? ((_resource, segment) => segment as R);\n const check = createRebacCheck<R>(resolveRelation);\n\n return (resource: R): Authorize =>\n (rule, record, actor) => {\n const permix = actorPermix(actor, options.isSuperadmin);\n const subject: Subject<R> = { resource, record, data: options.data?.(record, actor) };\n try {\n return check(permix, options.schema, subject, rule as ActionRule);\n } catch (error) {\n if (error instanceof Error && CYCLE.test(error.message)) return false;\n throw error;\n }\n };\n};\n","import { cloneDeep, get, isEqual, mergeWith, set, uniqWith } from 'lodash-es';\nimport type { Merge, MergeStrategy, Row } from './types';\n\nconst toArray = (value: unknown): unknown[] =>\n Array.isArray(value) ? value : value === undefined ? [] : [value];\n\n// deepMerge replaces arrays wholesale rather than index-merging them (the intuitive default).\nconst replaceArrays = (_target: unknown, source: unknown): unknown[] | undefined =>\n Array.isArray(source) ? source : undefined;\n\n/** A transition is persistable iff its merge is absent or a keyword strategy (callbacks are not). */\nexport const isSerializableMerge = (merge?: Merge): boolean => typeof merge !== 'function';\n\n/**\n * Produce the resulting record from a current record + proposed changes.\n *\n * - `spread` (default) — shallow overwrite (`{ ...record, ...changes }`)\n * - `deepMerge` — recursive object merge, arrays replaced\n * - `{ kind: 'append', path }` — concat `changes[path]` onto `record[path]`\n * - `{ kind: 'appendUnique', path }` — append + dedupe (deep equality)\n * - a callback — full power, not serializable\n */\nexport const applyMerge = <R extends Row>(\n merge: Merge<R> | undefined,\n record: R,\n changes: Partial<R> = {},\n): R => {\n if (typeof merge === 'function') return merge(record, changes);\n\n const strategy: MergeStrategy = merge ?? 'spread';\n\n if (strategy === 'spread') return { ...record, ...changes };\n // clone BOTH inputs: mergeWith assigns nested objects/arrays from `changes` by reference, which\n // would alias the caller's `changes` into the returned record (a mutation footgun for a pure guard).\n if (strategy === 'deepMerge')\n return mergeWith(cloneDeep(record), cloneDeep(changes), replaceArrays);\n\n // field-scoped array strategies: spread the rest of `changes`, then concat at `path`.\n const { kind, path } = strategy;\n const base = cloneDeep({ ...record, ...changes }) as R;\n const merged = [...toArray(get(record, path)), ...toArray(get(changes, path))];\n set(base as Row, path, kind === 'appendUnique' ? uniqWith(merged, isEqual) : merged);\n return base;\n};\n","import { check as checkRule } from '@inixiative/json-rules';\nimport { applyMerge } from './merge';\nimport type {\n ActionRule,\n Actor,\n Authorize,\n PathReason,\n Row,\n SideReason,\n Transition,\n TransitionOptions,\n} from './types';\n\nconst predicateReason = (result: boolean | string): string =>\n typeof result === 'string' ? result : 'predicate not satisfied';\n\n/**\n * Does this permission DENY?\n * - no authorizer injected → can't deny (legality-only mode)\n * - `undefined` rule → permission absent → open → can't deny\n * - any other rule (incl. `null` = terminal deny) → delegate to the authorizer\n */\nconst denies = (\n authorize: Authorize | undefined,\n rule: ActionRule | undefined,\n record: Row,\n actor: Actor,\n): boolean => {\n if (!authorize || rule === undefined) return false;\n return !authorize(rule, record, actor);\n};\n\n/**\n * The kernel: evaluate one atomic edge. Reports every failure rather than short-circuiting —\n * `from`/`to` and predicate/permission are independent slots — so a caller sees the whole\n * picture. `from.*` reads the current `record`, `to.*` reads the merged `next` record. Returns\n * `true` when the edge is allowed, else the {@link PathReason}. Omit `authorize` for legality only;\n * json-rules' `check()` options (`now`, `bindings`, `context`, …) reach both predicates.\n */\nexport const checkPath = <R extends Row>(\n transition: Transition<R>,\n record: R,\n changes: Partial<R> = {},\n options: TransitionOptions = {},\n): true | PathReason => {\n const { actor, authorize, ...evaluation } = options;\n const next = applyMerge(transition.to.merge, record, changes);\n\n const from: SideReason = {};\n const fromPredicate = checkRule(transition.from.predicate, record as Row, evaluation);\n if (fromPredicate !== true) from.predicate = predicateReason(fromPredicate);\n if (denies(authorize, transition.from.permission, record as Row, actor))\n from.permission = 'not authorized';\n\n const to: SideReason = {};\n const toPredicate = checkRule(transition.to.predicate, next as Row, evaluation);\n if (toPredicate !== true) to.predicate = predicateReason(toPredicate);\n if (denies(authorize, transition.to.permission, next as Row, actor))\n to.permission = 'not authorized';\n\n const reason: PathReason = {};\n if (from.predicate || from.permission) reason.from = from;\n if (to.predicate || to.permission) reason.to = to;\n return reason.from || reason.to ? reason : true;\n};\n","import type { PathReason, Reason } from './types';\n\nconst describePath = (path: PathReason): string => {\n const segs: string[] = [];\n if (path.from?.predicate) segs.push(`from: ${path.from.predicate}`);\n if (path.from?.permission) segs.push(`from: ${path.from.permission}`);\n if (path.to?.predicate) segs.push(`to: ${path.to.predicate}`);\n if (path.to?.permission) segs.push(`to: ${path.to.permission}`);\n return segs.join('; ') || 'unknown';\n};\n\n/** Build a human-readable message from a structured {@link Reason} (logs / UI / error bodies). */\nexport const describe = (reason: Reason): string => {\n if (reason.paths.length === 0) return 'no transition path available';\n if (reason.paths.length === 1) return describePath(reason.paths[0]);\n return reason.paths.map((path, i) => `path ${i}: ${describePath(path)}`).join(' | ');\n};\n","import { bindRule, check as checkRule, toPrisma } from '@inixiative/json-rules';\nimport { checkPath } from './check';\nimport type {\n Action,\n ActionRule,\n CheckResult,\n PathReason,\n PredicateOptions,\n Row,\n TransitionMap,\n TransitionOptions,\n} from './types';\n\nconst getAction = (rules: TransitionMap, resource: string, action: string): Action => {\n const found = rules[resource]?.[action];\n if (!found)\n throw new Error(`transition: no action \"${action}\" registered on resource \"${resource}\"`);\n return found;\n};\n\n/**\n * Authoritative check: the FIRST path whose `from` matches the current record, whose `to` matches\n * the merged record, and whose permissions all pass, wins → `true`. If none pass, returns a\n * {@link Reason} with one {@link PathReason} per candidate path tried.\n *\n * `resource` is the (map-qualified) key into the map — e.g. `db:Inquiry`. Cross-source `permission`\n * checks are handled by the injected {@link Authorize} (wire it to a bridge-aware rebac check, bound\n * to this resource); a `predicate` that reads a bridged relation expects a stitched record.\n */\nexport const checkTransition = (\n rules: TransitionMap,\n resource: string,\n action: string,\n record: Row,\n changes: Row = {},\n options: TransitionOptions = {},\n): CheckResult => {\n const found = getAction(rules, resource, action);\n const paths: PathReason[] = [];\n for (const path of found.paths) {\n const result = checkPath(path, record, changes, options);\n if (result === true) return true;\n paths.push(result);\n }\n return { paths };\n};\n\n/**\n * Affordance hint: which actions are offerable from `record` right now. Evaluates ONLY the `from`\n * side (predicate + `from` permission against the current record) — `to` needs the merged record,\n * which doesn't exist without proposed changes, so it defers to {@link checkTransition}.\n */\nexport const available = (\n rules: TransitionMap,\n resource: string,\n record: Row,\n options: TransitionOptions = {},\n): string[] => {\n const actions = rules[resource];\n if (!actions) return [];\n const { actor, authorize, ...evaluation } = options;\n\n const allows = (rule: ActionRule | undefined, rec: Row): boolean =>\n !authorize || rule === undefined || authorize(rule, rec, actor);\n\n return Object.entries(actions)\n .filter(([, action]) =>\n action.paths.some(\n (path) =>\n checkRule(path.from.predicate, record, evaluation) === true &&\n allows(path.from.permission, record),\n ),\n )\n .map(([action]) => action);\n};\n\n/**\n * Set query: one Prisma `where` matching every record currently eligible for `action` (the\n * union of all its paths' `from` predicates; a single path compiles to its predicate alone).\n * Empty action → match-nothing. Takes the same\n * json-rules `check()` options: `bindings` are resolved into the predicate before compiling, and\n * `now` / `context` reach `toPrisma`, so the set query selects the rows the single check accepts.\n * A guard toPrisma cannot express (a `$.` row ref in an offset or magnitude) throws.\n */\nexport const eligible = (\n rules: TransitionMap,\n resource: string,\n action: string,\n options: PredicateOptions = {},\n): Row => {\n const found = getAction(rules, resource, action);\n const { bindings = {}, ...compile } = options;\n const predicate = bindRule({ any: found.paths.map((path) => path.from.predicate) }, bindings);\n // toPrisma always terminates a plan in a WhereStep (and throws on count-based ops,\n // which would need a multi-step plan, since we pass no map/model). Trust that contract.\n const { steps } = toPrisma(predicate, compile);\n return (steps[steps.length - 1] as { where: Row }).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 type Lens,\n type LensNarrowing,\n type ValidationIssue,\n type ValidationResult,\n validateRule,\n validateRuleInLens,\n} from '@inixiative/json-rules';\nimport { actionRuleSchema } from '@inixiative/permissions/actionRuleSchema';\nimport { isSerializableMerge } from './merge';\nimport type { ActionRule, Merge, Side, ToSide, Transition } from './types';\n\nexport type { ValidationIssue, ValidationResult };\n\nexport type ValidateOptions = {\n /** Optional field/relation allowlist; passed through to json-rules lens validation per predicate. */\n lens?: Lens | LensNarrowing;\n /** Reject callback merges (use when the transition must be persistable / tenant-configured). */\n requireSerializable?: boolean;\n};\n\nconst MERGE_KEYWORDS = new Set(['spread', 'deepMerge']);\nconst ARRAY_KINDS = new Set(['append', 'appendUnique']);\n\nconst validatePredicate = (\n predicate: Condition | undefined,\n errors: ValidationIssue[],\n path: string,\n lens?: Lens | LensNarrowing,\n): void => {\n if (predicate === undefined) {\n errors.push({ path, message: 'predicate is required', code: 'missing_predicate' });\n return;\n }\n const issues = [\n ...validateRule(predicate).errors,\n ...(lens ? validateRuleInLens(predicate, lens).errors : []),\n ];\n for (const issue of issues) errors.push({ ...issue, path: `${path}.${issue.path}` });\n};\n\n// Validate the whole ActionRule against `@inixiative/permissions`' zod schema — the single source of\n// truth for the algebra (boolean terminals, string delegation, `{ rel, action }`, `{ self }`, abac\n// `{ rule }`, `any`/`all`, `null`). A malformed rule yields a structured issue rather than throwing.\nconst validatePermission = (\n rule: ActionRule | undefined,\n errors: ValidationIssue[],\n path: string,\n): void => {\n if (rule === undefined) return; // absent = open\n const parsed = actionRuleSchema.safeParse(rule);\n if (parsed.success) return;\n for (const issue of parsed.error.issues) {\n // A root union failure (zod reports an empty relative path) means none of the ActionRule shapes\n // matched; nested issues keep their zod path + message.\n if (issue.path.length === 0) {\n errors.push({ path, message: 'unrecognized ActionRule shape', code: 'invalid_permission' });\n } else {\n errors.push({\n path: `${path}.${issue.path.join('.')}`,\n message: issue.message,\n code: 'invalid_permission',\n });\n }\n }\n};\n\nconst validateMerge = (merge: Merge | undefined, errors: ValidationIssue[], path: string): void => {\n if (merge === undefined || typeof merge === 'function') return;\n if (typeof merge === 'string') {\n if (!MERGE_KEYWORDS.has(merge))\n errors.push({ path, message: `unknown merge strategy \"${merge}\"`, code: 'invalid_merge' });\n return;\n }\n if (!ARRAY_KINDS.has(merge.kind))\n errors.push({ path, message: `unknown merge kind \"${merge.kind}\"`, code: 'invalid_merge' });\n else if (!merge.path)\n errors.push({\n path,\n message: `merge \"${merge.kind}\" requires a \\`path\\``,\n code: 'invalid_merge',\n });\n};\n\nconst validateSide = (\n side: Side | ToSide | undefined,\n errors: ValidationIssue[],\n path: string,\n options: ValidateOptions,\n): void => {\n if (side === null || typeof side !== 'object') {\n errors.push({ path, message: `\\`${path}\\` side is required`, code: 'missing_side' });\n return;\n }\n validatePredicate(side.predicate, errors, `${path}.predicate`, options.lens);\n validatePermission(side.permission, errors, `${path}.permission`);\n if (side.requires !== undefined && (typeof side.requires !== 'object' || side.requires === null))\n errors.push({\n path: `${path}.requires`,\n message: '`requires` must be a Prisma-include-shaped object',\n code: 'invalid_requires',\n });\n if ('merge' in side) validateMerge(side.merge, errors, `${path}.merge`);\n};\n\n/**\n * Authoring validation for a single transition — run on save before persisting a tenant config.\n * Returns structured issues (never throws) on malformed input: predicate validity delegates to\n * json-rules (`validateRule`, plus `validateRuleInLens` when a `lens` is supplied for\n * field/relation scoping); permission shape delegates to `@inixiative/permissions`' `actionRuleSchema`;\n * merge strategy is checked here.\n */\nexport const validateTransition = (\n transition: Transition,\n options: ValidateOptions = {},\n): ValidationResult => {\n const errors: ValidationIssue[] = [];\n validateSide(transition?.from, errors, 'from', options);\n validateSide(transition?.to, errors, 'to', options);\n if (options.requireSerializable && !isSerializableMerge(transition?.to?.merge))\n errors.push({\n path: 'to.merge',\n message: 'callback merge is not serializable; use a keyword strategy',\n code: 'unserializable_merge',\n });\n return { ok: errors.length === 0, errors };\n};\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inixiative/transitions",
3
- "version": "0.1.1",
3
+ "version": "0.3.0",
4
4
  "description": "Declarative, serializable transition guard + affordance layer on top of @inixiative/json-rules",
5
5
  "main": "./dist/index.cjs",
6
6
  "module": "./dist/index.js",
@@ -18,7 +18,7 @@
18
18
  "lint": "biome check .",
19
19
  "format": "biome format --write .",
20
20
  "check": "bun run typecheck && bun run lint && bun run test",
21
- "prepare": "lefthook install",
21
+ "prepare": "if git rev-parse --git-dir >/dev/null 2>&1; then lefthook install; fi",
22
22
  "prepublishOnly": "bun run check && bun run build"
23
23
  },
24
24
  "keywords": [
@@ -41,7 +41,7 @@
41
41
  },
42
42
  "devDependencies": {
43
43
  "@biomejs/biome": "2.5.2",
44
- "@inixiative/config": "^0.5.46",
44
+ "@inixiative/config": "^0.5.51",
45
45
  "@types/bun": "1.4.2",
46
46
  "@types/lodash-es": "^4.17.12",
47
47
  "lefthook": "2.1.9",
@@ -57,8 +57,8 @@
57
57
  }
58
58
  },
59
59
  "dependencies": {
60
- "@inixiative/json-rules": "^2.26.0",
61
- "@inixiative/permissions": "^0.3.4",
60
+ "@inixiative/json-rules": "^3.0.0",
61
+ "@inixiative/permissions": "^0.4.0",
62
62
  "lodash-es": "^4.18.1",
63
63
  "zod": "^4.4.3"
64
64
  },