@owlmeans/server-planning 0.1.18-rc.21 → 0.1.18-rc.23

package/build/executor/changes.js

@@ -1,55 +1,46 @@
-import { CommitState, computeChanges, isEmptyChange, TransitionAction } from '@owlmeans/planning';
+import { changesHelper, CommitState, TransitionAction } from '@owlmeans/planning';
 const clean = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
-/**
- * Step 9: the recorded `changes`/`unset`, and whether an update wrote nothing.
- *
- * @throws {IllegalTransition | PlanningError}
- */
-export const changeSetOf = (exec, resolved, schemas, at) => {
-    const set = computeChanges(resolved.card, exec, resolved.type, schemas, at, { slot: resolved.slot });
-    const empty = exec.action === TransitionAction.Update && isEmptyChange(set);
-    return { set, empty };
-};
-/**
- * Who wrote it — the SCOPE's identity, never the execution's.
- *
- * `profileId`, `userId`, `service` and `channel` come only from the scope (the server builds it
- * from the authenticated request); the descriptive `agent`/`runId` an in-process caller passes on
- * the execution are kept unless the scope's own actor names them.
- */
-export const actorOf = (scope, exec) => clean({
-    agent: exec.actor?.agent,
-    runId: exec.actor?.runId,
-    ...clean({ profileId: scope.profileId, userId: scope.userId, service: scope.service }),
-    ...clean(scope.actor ?? {}),
-    channel: scope.channel ?? scope.actor?.channel,
-});
-const withFrom = (link, card) => ({ ...link, from: link.from ?? card });
-/** Step 11's record: the event as it is appended, `pending`. */
-export const transitionOf = (params) => {
-    const { exec, resolved, scope, set, cardId, seq, project, at } = params;
-    const kind = resolved.create ? exec.card.kind : resolved.card.kind;
-    return clean({
-        entityId: scope.entityId,
-        card: cardId,
-        kind,
-        type: resolved.type.type,
-        project,
-        seq,
-        action: exec.action,
-        flow: set.flow,
-        transition: exec.action === TransitionAction.Transit ? exec.transition : undefined,
-        from: set.from,
-        to: set.to,
-        changes: set.changes,
-        unset: set.unset.length > 0 ? set.unset : undefined,
-        link: exec.link != null && exec.action !== TransitionAction.Create ? withFrom(exec.link, cardId) : undefined,
-        links: resolved.create && (exec.links?.length ?? 0) > 0 ? exec.links.map(link => withFrom(link, cardId)) : undefined,
-        actor: actorOf(scope, exec),
-        cause: exec.cause,
-        key: exec.key,
-        at,
-        commit: { state: CommitState.Pending },
+export const createChangesUtils = () => {
+    const changeSetOf = (exec, resolved, schemas, at) => {
+        const set = changesHelper.computeChanges(resolved.card, exec, resolved.type, schemas, at, { slot: resolved.slot });
+        const empty = exec.action === TransitionAction.Update && changesHelper.isEmptyChange(set);
+        return { set, empty };
+    };
+    const actorOf = (scope, exec) => clean({
+        agent: exec.actor?.agent,
+        runId: exec.actor?.runId,
+        ...clean({ profileId: scope.profileId, userId: scope.userId, service: scope.service }),
+        ...clean(scope.actor ?? {}),
+        channel: scope.channel ?? scope.actor?.channel,
     });
+    const withFrom = (link, card) => ({ ...link, from: link.from ?? card });
+    const transitionOf = (params) => {
+        const { exec, resolved, scope, set, cardId, seq, project, at } = params;
+        const kind = resolved.create ? exec.card.kind : resolved.card.kind;
+        return clean({
+            entityId: scope.entityId,
+            card: cardId,
+            kind,
+            type: resolved.type.type,
+            project,
+            seq,
+            action: exec.action,
+            flow: set.flow,
+            transition: exec.action === TransitionAction.Transit ? exec.transition : undefined,
+            from: set.from,
+            to: set.to,
+            changes: set.changes,
+            unset: set.unset.length > 0 ? set.unset : undefined,
+            link: exec.link != null && exec.action !== TransitionAction.Create ? withFrom(exec.link, cardId) : undefined,
+            links: resolved.create && (exec.links?.length ?? 0) > 0 ? exec.links.map(link => withFrom(link, cardId)) : undefined,
+            actor: actorOf(scope, exec),
+            cause: exec.cause,
+            key: exec.key,
+            at,
+            commit: { state: CommitState.Pending },
+        });
+    };
+    return { changeSetOf, actorOf, transitionOf };
 };
+export const changesUtils = createChangesUtils();
 //# sourceMappingURL=changes.js.map

package/build/executor/changes.js.map

@@ -1 +1 @@
-{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../src/executor/changes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../src/executor/changes.ts"],"names":[],"mappings":"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"}

package/build/executor/code/types.d.ts

@@ -0,0 +1,17 @@
+import type { PlanningExecContext, PlanningPlugin, PlanningScope, TransitionExecution } from '@owlmeans/planning';
+import type { PluginRegistry } from '../../types.js';
+import type { Resolved } from '../types.js';
+/** Step 8 of the write path: the code a card gets, unique within its policy's scope. */
+export interface CodeUtils {
+    /**
+     * Step 8: the code a new card gets, or the check a changed code passes.
+     *
+     * A caller-supplied code is checked for uniqueness; otherwise the plugins' `mintCode` chain answers
+     * (first answer wins, and is checked too); otherwise the type's policy mints one — a slug policy
+     * derives it from the title. A type with no policy and no supplied code gets none.
+     *
+     * @throws {CodeTaken}
+     */
+    assignCode: (exec: TransitionExecution, resolved: Resolved, scope: PlanningScope, registry: PluginRegistry, contextOf: (plugin: PlanningPlugin) => PlanningExecContext) => Promise<TransitionExecution>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/executor/code/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/executor/code/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACjH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,wFAAwF;AACxF,MAAM,WAAW,SAAS;IACxB;;;;;;;;OAQG;IACH,UAAU,EAAE,CACV,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,mBAAmB,KACvD,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAClC"}

package/build/executor/code/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/executor/code/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/executor/code/types.ts"],"names":[],"mappings":""}

package/build/executor/code.d.ts

@@ -1,15 +1,4 @@
-import { type PlanningExecContext, type PlanningPlugin, type PlanningScope, type TransitionExecution } from '@owlmeans/planning';
-import type { PluginRegistry } from '../types.js';
-import type { Resolved } from './types.js';
-export declare const takenProbe: (resolved: Resolved, scope: PlanningScope, parent: string | undefined) => (code: string) => Promise<boolean>;
-/**
- * Step 8: the code a new card gets, or the check a changed code passes.
- *
- * A caller-supplied code is checked for uniqueness; otherwise the plugins' `mintCode` chain answers
- * (first answer wins, and is checked too); otherwise the type's policy mints one — a slug policy
- * derives it from the title. A type with no policy and no supplied code gets none.
- *
- * @throws {CodeTaken}
- */
-export declare const assignCode: (exec: TransitionExecution, resolved: Resolved, scope: PlanningScope, registry: PluginRegistry, contextOf: (plugin: PlanningPlugin) => PlanningExecContext) => Promise<TransitionExecution>;
+import type { CodeUtils } from './code/types.js';
+export declare const createCodeUtils: () => CodeUtils;
+export declare const codeUtils: CodeUtils;
 //# sourceMappingURL=code.d.ts.map

package/build/executor/code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/executor/code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoG,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAqC,MAAM,oBAAoB,CAAA;AAErQ,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAW1C,eAAO,MAAM,UAAU,aAAc,QAAQ,SAAS,aAAa,UAAU,MAAM,GAAG,SAAS,YAGzE,MAAM,KAAG,OAAO,CAAC,OAAO,CAE7C,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,SACf,mBAAmB,YACf,QAAQ,SACX,aAAa,YACV,cAAc,aACb,CAAC,MAAM,EAAE,cAAc,KAAK,mBAAmB,KACzD,OAAO,CAAC,mBAAmB,CAwC7B,CAAA"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/executor/code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,eAAO,MAAM,eAAe,QAAO,SAmElC,CAAA;AAED,eAAO,MAAM,SAAS,WAAoB,CAAA"}

package/build/executor/code.js

@@ -1,59 +1,55 @@
-import { CODE_MINT_ATTEMPTS, CodeScope, CodeStyle, CodeTaken, mintCode, TransitionAction } from '@owlmeans/planning';
-/** The criteria a code must be unique within — the policy's scope, `parent` when there is none. */
-const scopeCriteria = (scope, type, parent, policy) => ({
-    entityId: scope.entityId,
-    type,
-    ...((policy?.uniqueWithin ?? CodeScope.Parent) === CodeScope.Parent ? { parent: parent ?? null } : {}),
-});
-export const takenProbe = (resolved, scope, parent) => {
-    const base = scopeCriteria(scope, resolved.type.type, parent, resolved.type.code);
-    return async (code) => await resolved.store.cards.count({ ...base, code }) > 0;
-};
-/**
- * Step 8: the code a new card gets, or the check a changed code passes.
- *
- * A caller-supplied code is checked for uniqueness; otherwise the plugins' `mintCode` chain answers
- * (first answer wins, and is checked too); otherwise the type's policy mints one — a slug policy
- * derives it from the title. A type with no policy and no supplied code gets none.
- *
- * @throws {CodeTaken}
- */
-export const assignCode = async (exec, resolved, scope, registry, contextOf) => {
-    const policy = resolved.type.code;
-    if (exec.action !== TransitionAction.Create) {
-        const code = exec.changes?.code;
-        if (code != null && code !== resolved.card?.code
-            && await takenProbe(resolved, scope, exec.changes?.parent ?? resolved.card?.parent)(code)) {
-            throw new CodeTaken(code);
+import { CODE_MINT_ATTEMPTS, codeHelper, CodeScope, CodeStyle, CodeTaken, TransitionAction } from '@owlmeans/planning';
+export const createCodeUtils = () => {
+    /** The criteria a code must be unique within — the policy's scope, `parent` when there is none. */
+    const scopeCriteria = (scope, type, parent, policy) => ({
+        entityId: scope.entityId,
+        type,
+        ...((policy?.uniqueWithin ?? CodeScope.Parent) === CodeScope.Parent ? { parent: parent ?? null } : {}),
+    });
+    /** Is a code taken within the scope the type's policy names (its parent when it names none)? */
+    const takenProbe = (resolved, scope, parent) => {
+        const base = scopeCriteria(scope, resolved.type.type, parent, resolved.type.code);
+        return async (code) => await resolved.store.cards.count({ ...base, code }) > 0;
+    };
+    const assignCode = async (exec, resolved, scope, registry, contextOf) => {
+        const policy = resolved.type.code;
+        if (exec.action !== TransitionAction.Create) {
+            const code = exec.changes?.code;
+            if (code != null && code !== resolved.card?.code
+                && await takenProbe(resolved, scope, exec.changes?.parent ?? resolved.card?.parent)(code)) {
+                throw new CodeTaken(code);
+            }
+            return exec;
+        }
+        const draft = exec.card;
+        const taken = takenProbe(resolved, scope, draft.parent);
+        if (draft.code != null && draft.code !== '') {
+            if (await taken(draft.code)) {
+                throw new CodeTaken(draft.code);
+            }
+            return exec;
+        }
+        if (policy == null) {
+            return exec;
         }
-        return exec;
-    }
-    const draft = exec.card;
-    const taken = takenProbe(resolved, scope, draft.parent);
-    if (draft.code != null && draft.code !== '') {
-        if (await taken(draft.code)) {
-            throw new CodeTaken(draft.code);
+        let code = await registry.mintCode(draft, taken, contextOf);
+        if (code != null) {
+            if (await taken(code)) {
+                throw new CodeTaken(code);
+            }
         }
-        return exec;
-    }
-    if (policy == null) {
-        return exec;
-    }
-    let code = await registry.mintCode(draft, taken, contextOf);
-    if (code != null) {
-        if (await taken(code)) {
-            throw new CodeTaken(code);
+        else {
+            const count = policy.style === CodeStyle.Sequential
+                ? await resolved.store.cards.count(scopeCriteria(scope, draft.type, draft.parent, policy))
+                : undefined;
+            code = await codeHelper.mintCode(policy, taken, CODE_MINT_ATTEMPTS, {
+                ...(policy.style === CodeStyle.Slug ? { seed: draft.title } : {}),
+                ...(count != null ? { count } : {}),
+            });
         }
-    }
-    else {
-        const count = policy.style === CodeStyle.Sequential
-            ? await resolved.store.cards.count(scopeCriteria(scope, draft.type, draft.parent, policy))
-            : undefined;
-        code = await mintCode(policy, taken, CODE_MINT_ATTEMPTS, {
-            ...(policy.style === CodeStyle.Slug ? { seed: draft.title } : {}),
-            ...(count != null ? { count } : {}),
-        });
-    }
-    return { ...exec, card: { ...draft, code } };
+        return { ...exec, card: { ...draft, code } };
+    };
+    return { assignCode };
 };
+export const codeUtils = createCodeUtils();
 //# sourceMappingURL=code.js.map

package/build/executor/code.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/executor/code.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/executor/code.ts"],"names":[],"mappings":"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"}

package/build/executor/creator/types.d.ts

@@ -0,0 +1,33 @@
+import type { PlanningScope, TransitionExecution } from '@owlmeans/planning';
+/** Who owns a card: `createdBy`, stamped from the scope on a create and fixed after it. */
+export interface CreatorHelper {
+    /**
+     * The subject a create made under `scope` is stamped with as its `createdBy`: the scope's
+     * `profileId`, else its `userId`, else the same two of its `actor` — the authenticated subject an
+     * HTTP scope carries, in the same format. `undefined` for a scope that names nobody (a service or a
+     * system scope).
+     */
+    creatorOf: (scope: PlanningScope) => string | undefined;
+    /**
+     * A create's draft with `createdBy` defaulted to {@link CreatorHelper.creatorOf} the scope. A
+     * `createdBy` the caller supplied wins; a scope that names nobody leaves the draft as it is;
+     * anything but a create is returned untouched. Never mutates `exec`.
+     *
+     * The executor applies it to every execution, so an in-process facade create and a wire create
+     * stamp the same value.
+     */
+    withCreator: (exec: TransitionExecution, scope: PlanningScope) => TransitionExecution;
+    /**
+     * Refuse an execution that names `createdBy` in `changes` or `unset`, whatever the action — a
+     * create included, whose owner is its draft's. After the create it never moves, so an ownership
+     * check (`card.createdBy === profileId`) cannot be bypassed by anyone allowed to update the card.
+     *
+     * The executor runs it with the immutables of step 6, after the `before` chain, so a wire body, an
+     * in-process caller and a plugin are refused alike. It is the executor's own check, whatever
+     * `@owlmeans/planning` build `changesHelper.assertMutable` comes from.
+     *
+     * @throws {PlanningError} `planning:immutable:createdBy`
+     */
+    assertCreatorFixed: (exec: TransitionExecution) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/executor/creator/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/executor/creator/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE5E,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAA;IACvD;;;;;;;OAOG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,aAAa,KAAK,mBAAmB,CAAA;IACrF;;;;;;;;;;OAUG;IACH,kBAAkB,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACxD"}

package/build/executor/creator/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/executor/creator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/executor/creator/types.ts"],"names":[],"mappings":""}

package/build/executor/creator.d.ts

@@ -1,30 +1,11 @@
 import { type PlanningScope, type TransitionExecution } from '@owlmeans/planning';
-/**
- * The subject a create made under `scope` is stamped with as its `createdBy`: the scope's
- * `profileId`, else its `userId`, else the same two of its `actor` — the authenticated subject an
- * HTTP scope carries, in the same format. `undefined` for a scope that names nobody (a service or a
- * system scope).
- */
+import type { CreatorHelper } from './creator/types.js';
+export declare const createCreatorHelper: () => CreatorHelper;
+export declare const creatorHelper: CreatorHelper;
+/** @deprecated compat:factory-refactor — use `creatorHelper.creatorOf(…)` */
 export declare const creatorOf: (scope: PlanningScope) => string | undefined;
-/**
- * A create's draft with `createdBy` defaulted to {@link creatorOf} the scope. A `createdBy` the
- * caller supplied wins; a scope that names nobody leaves the draft as it is; anything but a create
- * is returned untouched. Never mutates `exec`.
- *
- * The executor applies it to every execution, so an in-process facade create and a wire create
- * stamp the same value.
- */
+/** @deprecated compat:factory-refactor — use `creatorHelper.withCreator(…)` */
 export declare const withCreator: (exec: TransitionExecution, scope: PlanningScope) => TransitionExecution;
-/**
- * Refuse an execution that names `createdBy` in `changes` or `unset`, whatever the action — a
- * create included, whose owner is its draft's. After the create it never moves, so an ownership
- * check (`card.createdBy === profileId`) cannot be bypassed by anyone allowed to update the card.
- *
- * The executor runs it with the immutables of step 6, after the `before` chain, so a wire body, an
- * in-process caller and a plugin are refused alike. It is the executor's own check, whatever
- * `@owlmeans/planning` build `assertMutable` comes from.
- *
- * @throws {PlanningError} `planning:immutable:createdBy`
- */
+/** @deprecated compat:factory-refactor — use `creatorHelper.assertCreatorFixed(…)` */
 export declare const assertCreatorFixed: (exec: TransitionExecution) => void;
 //# sourceMappingURL=creator.d.ts.map

package/build/executor/creator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"creator.d.ts","sourceRoot":"","sources":["../../src/executor/creator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAKlH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,UAAW,aAAa,KAAG,MAAM,GAAG,SACgC,CAAA;AAE1F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,SAAU,mBAAmB,SAAS,aAAa,KAAG,mBAU7E,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,SAAU,mBAAmB,KAAG,IAK9D,CAAA"}
+{"version":3,"file":"creator.d.ts","sourceRoot":"","sources":["../../src/executor/creator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAElH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD,eAAO,MAAM,mBAAmB,QAAO,aAwBtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA;AAElD,6EAA6E;AAC7E,eAAO,MAAM,SAAS,UAAW,aAAa,KAAG,MAAM,GAAG,SAA2C,CAAA;AAErG,+EAA+E;AAC/E,eAAO,MAAM,WAAW,SAAU,mBAAmB,SAAS,aAAa,KAAG,mBACtC,CAAA;AAExC,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,SAAU,mBAAmB,KAAG,IAA8C,CAAA"}

package/build/executor/creator.js

@@ -1,46 +1,31 @@
 import { PlanningError, TransitionAction } from '@owlmeans/planning';
 import { CREATOR } from './consts.local.js';
 const named = (value) => value != null && value !== '';
-/**
- * The subject a create made under `scope` is stamped with as its `createdBy`: the scope's
- * `profileId`, else its `userId`, else the same two of its `actor` — the authenticated subject an
- * HTTP scope carries, in the same format. `undefined` for a scope that names nobody (a service or a
- * system scope).
- */
-export const creatorOf = (scope) => [scope.profileId, scope.userId, scope.actor?.profileId, scope.actor?.userId].find(named);
-/**
- * A create's draft with `createdBy` defaulted to {@link creatorOf} the scope. A `createdBy` the
- * caller supplied wins; a scope that names nobody leaves the draft as it is; anything but a create
- * is returned untouched. Never mutates `exec`.
- *
- * The executor applies it to every execution, so an in-process facade create and a wire create
- * stamp the same value.
- */
-export const withCreator = (exec, scope) => {
-    if (exec.action !== TransitionAction.Create || exec.card == null || typeof exec.card !== 'object') {
-        return exec;
-    }
-    if (named(exec.card.createdBy)) {
-        return exec;
-    }
-    const creator = creatorOf(scope);
-    return creator == null ? exec : { ...exec, card: { ...exec.card, createdBy: creator } };
-};
-/**
- * Refuse an execution that names `createdBy` in `changes` or `unset`, whatever the action — a
- * create included, whose owner is its draft's. After the create it never moves, so an ownership
- * check (`card.createdBy === profileId`) cannot be bypassed by anyone allowed to update the card.
- *
- * The executor runs it with the immutables of step 6, after the `before` chain, so a wire body, an
- * in-process caller and a plugin are refused alike. It is the executor's own check, whatever
- * `@owlmeans/planning` build `assertMutable` comes from.
- *
- * @throws {PlanningError} `planning:immutable:createdBy`
- */
-export const assertCreatorFixed = (exec) => {
-    if (exec.changes?.[CREATOR] !== undefined
-        || (exec.unset ?? []).some(path => path.split('.')[0] === CREATOR)) {
-        throw new PlanningError(`immutable:${CREATOR}`);
-    }
+export const createCreatorHelper = () => {
+    const creatorOf = (scope) => [scope.profileId, scope.userId, scope.actor?.profileId, scope.actor?.userId].find(named);
+    const withCreator = (exec, scope) => {
+        if (exec.action !== TransitionAction.Create || exec.card == null || typeof exec.card !== 'object') {
+            return exec;
+        }
+        if (named(exec.card.createdBy)) {
+            return exec;
+        }
+        const creator = creatorOf(scope);
+        return creator == null ? exec : { ...exec, card: { ...exec.card, createdBy: creator } };
+    };
+    const assertCreatorFixed = (exec) => {
+        if (exec.changes?.[CREATOR] !== undefined
+            || (exec.unset ?? []).some(path => path.split('.')[0] === CREATOR)) {
+            throw new PlanningError(`immutable:${CREATOR}`);
+        }
+    };
+    return { creatorOf, withCreator, assertCreatorFixed };
 };
+export const creatorHelper = createCreatorHelper();
+/** @deprecated compat:factory-refactor — use `creatorHelper.creatorOf(…)` */
+export const creatorOf = (scope) => creatorHelper.creatorOf(scope);
+/** @deprecated compat:factory-refactor — use `creatorHelper.withCreator(…)` */
+export const withCreator = (exec, scope) => creatorHelper.withCreator(exec, scope);
+/** @deprecated compat:factory-refactor — use `creatorHelper.assertCreatorFixed(…)` */
+export const assertCreatorFixed = (exec) => creatorHelper.assertCreatorFixed(exec);
 //# sourceMappingURL=creator.js.map

package/build/executor/creator.js.map

@@ -1 +1 @@
-{"version":3,"file":"creator.js","sourceRoot":"","sources":["../../src/executor/creator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAgD,MAAM,oBAAoB,CAAA;AAClH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE3C,MAAM,KAAK,GAAG,CAAC,KAAqB,EAAmB,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAA;AAEvF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAsB,EAAE,CACpE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAE1F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAyB,EAAE,KAAoB,EAAuB,EAAE;IAClG,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClG,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAEhC,OAAO,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAA;AACzF,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAyB,EAAQ,EAAE;IACpE,IAAK,IAAI,CAAC,OAA+C,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS;WAC7E,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,aAAa,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;IACjD,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"creator.js","sourceRoot":"","sources":["../../src/executor/creator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAgD,MAAM,oBAAoB,CAAA;AAClH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,MAAM,KAAK,GAAG,CAAC,KAAqB,EAAmB,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAA;AAEvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAkB,EAAE;IACrD,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAsB,EAAE,CAC7D,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAE1F,MAAM,WAAW,GAAG,CAAC,IAAyB,EAAE,KAAoB,EAAuB,EAAE;QAC3F,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClG,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAEhC,OAAO,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAA;IACzF,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,CAAC,IAAyB,EAAQ,EAAE;QAC7D,IAAK,IAAI,CAAC,OAA+C,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS;eAC7E,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,aAAa,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;QACjD,CAAC;IACH,CAAC,CAAA;IAED,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAA;AACvD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAA;AAElD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAsB,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AAErG,+EAA+E;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAyB,EAAE,KAAoB,EAAuB,EAAE,CAClG,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AAExC,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAyB,EAAQ,EAAE,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA"}

package/build/executor/resolve/types.d.ts

@@ -0,0 +1,30 @@
+import type { PlanningFacade, PlanningSchemaRegistry, TransitionExecution, Workcard, WorkcardKind } from '@owlmeans/planning';
+import type { Resolved } from '../types.js';
+/** Steps 1 and 4 of the write path, over one service runtime. */
+export interface ResolveUtils {
+    /**
+     * Step 1: a deep copy with trimmed text, `parents ∋ parent` on a draft, and no duplicate `unset`
+     * paths. The caller's object is never touched.
+     */
+    normalizeExecution: (input: TransitionExecution) => TransitionExecution;
+    /**
+     * The parent type's rule for a child of `kind`/`type`: a project lists the `cardTypes` (and
+     * `projectTypes`) it admits, and one declaring `scopedCardTypes` also admits a card type its layer
+     * (`view`, the parent project's resolved schemas) defines as data. Project types are code's alone.
+     *
+     * @throws {CardTypeNotAllowed}
+     */
+    assertChildAllowed: (parent: Workcard, kind: WorkcardKind, type: string, view?: PlanningSchemaRegistry) => void;
+    /** The layer a parent project admits data-defined children through — `undefined` without a schema port. */
+    childViewOf: (entityId: string, parent: Workcard) => Promise<PlanningSchemaRegistry | undefined>;
+    /**
+     * Step 4: the card, its type and flow, its parent and — for a specification — its slot.
+     *
+     * @throws {WorkcardNotFound | PlanningScopeMismatch | UnknownWorkcardType | UnknownStatusFlow}
+     * @throws {ParentNotFound | CardTypeNotAllowed | PlanningError}
+     */
+    resolveExecution: (facade: PlanningFacade, exec: TransitionExecution) => Promise<Resolved>;
+    /** The project a transition is filed under: a project's own id, else its parent's project. */
+    projectFor: (resolved: Resolved, exec: TransitionExecution, cardId: string) => string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/executor/resolve/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/executor/resolve/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC7H,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,kBAAkB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,mBAAmB,CAAA;IACvE;;;;;;OAMG;IACH,kBAAkB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAA;IAC/G,2GAA2G;IAC3G,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,KAAK,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAA;IAChG;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1F,8FAA8F;IAC9F,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CAClG"}

package/build/executor/resolve/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/executor/resolve/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/executor/resolve/types.ts"],"names":[],"mappings":""}

package/build/executor/resolve.d.ts

@@ -1,43 +1,6 @@
-import { WorkcardKind, type PlanningFacade, type PlanningSchemaRegistry, type TransitionExecution, type Workcard } from '@owlmeans/planning';
 import type { PlanningRuntime } from '../types.js';
-import type { Resolved } from './types.js';
-/**
- * Step 1: a deep copy with trimmed text, `parents ∋ parent` on a draft, and no duplicate `unset`
- * paths. The caller's object is never touched.
- */
-declare const normalizeExecution: (input: TransitionExecution) => TransitionExecution;
-/**
- * The parent type's rule for a child of `kind`/`type`: a project lists the `cardTypes` (and
- * `projectTypes`) it admits, and one declaring `scopedCardTypes` also admits a card type its layer
- * (`view`, the parent project's resolved schemas) defines as data. Project types are code's alone.
- *
- * @throws {CardTypeNotAllowed}
- */
-declare const assertChildAllowed: (runtime: PlanningRuntime, parent: Workcard, kind: WorkcardKind, type: string, view?: PlanningSchemaRegistry) => void;
-/** The layer a parent project admits data-defined children through — `undefined` without a schema port. */
-declare const childViewOf: (runtime: PlanningRuntime, entityId: string, parent: Workcard) => Promise<PlanningSchemaRegistry | undefined>;
-/**
- * Step 4: the card, its type and flow, its parent and — for a specification — its slot.
- *
- * @throws {WorkcardNotFound | PlanningScopeMismatch | UnknownWorkcardType | UnknownStatusFlow}
- * @throws {ParentNotFound | CardTypeNotAllowed | PlanningError}
- */
-declare const resolveExecution: (runtime: PlanningRuntime, facade: PlanningFacade, exec: TransitionExecution) => Promise<Resolved>;
-/** The project a transition is filed under: a project's own id, else its parent's project. */
-declare const projectFor: (resolved: Resolved, exec: TransitionExecution, cardId: string) => string | undefined;
-export declare const createResolveHelper: () => {
-    normalizeExecution: typeof normalizeExecution;
-    assertChildAllowed: typeof assertChildAllowed;
-    childViewOf: typeof childViewOf;
-    resolveExecution: typeof resolveExecution;
-    projectFor: typeof projectFor;
-};
-export declare const resolveHelper: {
-    normalizeExecution: typeof normalizeExecution;
-    assertChildAllowed: typeof assertChildAllowed;
-    childViewOf: typeof childViewOf;
-    resolveExecution: typeof resolveExecution;
-    projectFor: typeof projectFor;
-};
-export {};
+import type { ResolveUtils } from './resolve/types.js';
+export declare const makeResolveUtils: (runtime: PlanningRuntime) => ResolveUtils;
+/** The resolution steps of one service runtime — one per runtime. */
+export declare const resolveUtilsOf: (target: PlanningRuntime) => ResolveUtils;
 //# sourceMappingURL=resolve.d.ts.map

package/build/executor/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/executor/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuO,YAAY,EAAwC,KAAK,cAAc,EAAE,KAAK,sBAAsB,EAAyE,KAAK,mBAAmB,EAAE,KAAK,QAAQ,EAAsB,MAAM,oBAAoB,CAAA;AAClf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AA6B1C;;;GAGG;AACH,QAAA,MAAM,kBAAkB,UAAW,mBAAmB,KAAG,mBAcxD,CAAA;AAED;;;;;;GAMG;AACH,QAAA,MAAM,kBAAkB,YACb,eAAe,UAAU,QAAQ,QAAQ,YAAY,QAAQ,MAAM,SAAS,sBAAsB,KAC1G,IAgBF,CAAA;AAED,2GAA2G;AAC3G,QAAA,MAAM,WAAW,YACN,eAAe,YAAY,MAAM,UAAU,QAAQ,KAC3D,OAAO,CAAC,sBAAsB,GAAG,SAAS,CACoE,CAAA;AAEjH;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,YACX,eAAe,UAAU,cAAc,QAAQ,mBAAmB,KAC1E,OAAO,CAAC,QAAQ,CA4GlB,CAAA;AAED,8FAA8F;AAC9F,QAAA,MAAM,UAAU,aAAc,QAAQ,QAAQ,mBAAmB,UAAU,MAAM,KAAG,MAAM,GAAG,SAS5F,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;CAAgG,CAAA;AAEhI,eAAO,MAAM,aAAa;;;;;;CAAwB,CAAA"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/executor/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AA6BtD,eAAO,MAAM,gBAAgB,YAAa,eAAe,KAAG,YAsK3D,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,cAAc,2CAAuC,CAAA"}