@owlmeans/server-planning 0.1.18-rc.0

package/build/actions/schemas.js

@@ -0,0 +1,9 @@
+import { handlers } from '@owlmeans/server-api';
+import { planningServiceOf, scopeOf } from '../utils/index.js';
+/** The schema bundle the service holds — what a client loads to answer `can()` with no round trip. */
+export const listSchemas = (protocol, opts) => handlers().request(protocol, async (req, ctx) => {
+    // Scoped like every other leaf: no organization, no bundle.
+    scopeOf(req);
+    return planningServiceOf(ctx, opts).schemas.bundle();
+});
+//# sourceMappingURL=schemas.js.map

package/build/actions/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/actions/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAG/C,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE9D,sGAAsG;AACtG,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAA6C,EAAE,IAA6B,EACf,EAAE,CAC/D,QAAQ,EAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACvD,4DAA4D;IAC5D,OAAO,CAAC,GAAG,CAAC,CAAA;IAEZ,OAAO,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;AACtD,CAAC,CAAC,CAAA"}

package/build/actions/specs.d.ts

@@ -0,0 +1,10 @@
+import { handlers } from '@owlmeans/server-api';
+import type { PlanningProtocols } from '@owlmeans/planning';
+import type { Context, PlanningHandlerOptions } from '../types.js';
+type RequestHandler = ReturnType<ReturnType<typeof handlers<Context>>['request']>;
+/** @throws {WorkcardNotFound} */
+export declare const getSpecification: (protocol: PlanningProtocols['spec']['get'], opts?: PlanningHandlerOptions) => RequestHandler;
+/** A document's history, newest first, replayed from its log. */
+export declare const listSpecificationRevisions: (protocol: PlanningProtocols['spec']['revisions'], opts?: PlanningHandlerOptions) => RequestHandler;
+export {};
+//# sourceMappingURL=specs.d.ts.map

package/build/actions/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/actions/specs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAGlE,KAAK,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;AAEjF,iCAAiC;AACjC,eAAO,MAAM,gBAAgB,aAAc,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,SAAS,sBAAsB,KAAG,cAKxG,CAAA;AAEL,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,aAAc,iBAAiB,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,SAAS,sBAAsB,KAAG,cAMxH,CAAA"}

package/build/actions/specs.js

@@ -0,0 +1,14 @@
+import { handlers } from '@owlmeans/server-api';
+import { concealed, handlerFacade } from '../utils/index.js';
+/** @throws {WorkcardNotFound} */
+export const getSpecification = (protocol, opts) => handlers().request(protocol, async (req, ctx) => concealed(async () => {
+    const facade = await handlerFacade(ctx, req, opts);
+    return await facade.specifications.get(`${req.params.id}`);
+}));
+/** A document's history, newest first, replayed from its log. */
+export const listSpecificationRevisions = (protocol, opts) => handlers().request(protocol, async (req, ctx) => concealed(async () => {
+    const facade = await handlerFacade(ctx, req, opts);
+    const limit = req.query?.limit == null ? undefined : Number(req.query.limit);
+    return { items: await facade.specifications.revisions(`${req.params.id}`, Number.isFinite(limit) ? limit : undefined) };
+}));
+//# sourceMappingURL=specs.js.map

package/build/actions/specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.js","sourceRoot":"","sources":["../../src/actions/specs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAG/C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAI5D,iCAAiC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAA0C,EAAE,IAA6B,EAAkB,EAAE,CAC5H,QAAQ,EAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;IAC7E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAElD,OAAO,MAAM,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAC,CAAA;AAEL,iEAAiE;AACjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,QAAgD,EAAE,IAA6B,EAAkB,EAAE,CAC5I,QAAQ,EAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;IAC7E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAE5E,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAA;AACzH,CAAC,CAAC,CAAC,CAAA"}

package/build/actions/transitions.d.ts

@@ -0,0 +1,6 @@
+import { handlers } from '@owlmeans/server-api';
+import type { PlanningProtocols } from '@owlmeans/planning';
+import type { Context, PlanningHandlerOptions } from '../types.js';
+/** @throws {WorkcardNotFound} for an absent transition and for another entity's alike */
+export declare const getTransition: (protocol: PlanningProtocols['transition']['get'], opts?: PlanningHandlerOptions) => ReturnType<ReturnType<typeof handlers<Context>>['request']>;
+//# sourceMappingURL=transitions.d.ts.map

package/build/actions/transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/actions/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAGlE,yFAAyF;AACzF,eAAO,MAAM,aAAa,aACd,iBAAiB,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,SAAS,sBAAsB,KAC9E,UAAU,CAAC,UAAU,CAAC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAKxD,CAAA"}

package/build/actions/transitions.js

@@ -0,0 +1,8 @@
+import { handlers } from '@owlmeans/server-api';
+import { concealed, handlerFacade } from '../utils/index.js';
+/** @throws {WorkcardNotFound} for an absent transition and for another entity's alike */
+export const getTransition = (protocol, opts) => handlers().request(protocol, async (req, ctx) => concealed(async () => {
+    const facade = await handlerFacade(ctx, req, opts);
+    return await facade.transitions.get(`${req.params.transition}`);
+}));
+//# sourceMappingURL=transitions.js.map

package/build/actions/transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/actions/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAG/C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE5D,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,QAAgD,EAAE,IAA6B,EAClB,EAAE,CAC/D,QAAQ,EAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;IAC7E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAElD,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;AACjE,CAAC,CAAC,CAAC,CAAA"}

package/build/actions/watch.d.ts

@@ -0,0 +1,12 @@
+import type { PlanningProtocols } from '@owlmeans/planning';
+import { connection } from '@owlmeans/server-socket';
+import type { PlanningHandlerOptions } from '../types.js';
+/**
+ * The notify tool: push the caller's entity's commits down a socket as `planning-commit` frames.
+ *
+ * The subscription is filtered by the authenticated entity (never a query value) and optionally by
+ * `project`/`card`. A frame without `record` — what a cross-process bus delivers — gets the card as
+ * it reads now (`null` once deleted), so a subscriber never re-reads per frame.
+ */
+export declare const watchCommits: (protocol: PlanningProtocols['commit']['events'], opts?: PlanningHandlerOptions) => ReturnType<typeof connection>;
+//# sourceMappingURL=watch.d.ts.map

package/build/actions/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/actions/watch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgC,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGpD,OAAO,KAAK,EAAW,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAMlE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,aACb,iBAAiB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,sBAAsB,KAC7E,UAAU,CAAC,OAAO,UAAU,CA+B7B,CAAA"}

package/build/actions/watch.js

@@ -0,0 +1,45 @@
+import { PLANNING_COMMIT_EVENT } from '@owlmeans/planning';
+import { connection } from '@owlmeans/server-socket';
+import { MessageType } from '@owlmeans/socket';
+import { handlerFacade } from '../utils/index.js';
+const text = (value) => value == null || value === '' ? undefined : `${value}`;
+/**
+ * The notify tool: push the caller's entity's commits down a socket as `planning-commit` frames.
+ *
+ * The subscription is filtered by the authenticated entity (never a query value) and optionally by
+ * `project`/`card`. A frame without `record` — what a cross-process bus delivers — gets the card as
+ * it reads now (`null` once deleted), so a subscriber never re-reads per frame.
+ */
+export const watchCommits = (protocol, opts) => connection(protocol, async (conn, ctx, req) => {
+    const facade = await handlerFacade(ctx, req, opts);
+    const query = (req.query ?? {});
+    const frame = opts?.event ?? PLANNING_COMMIT_EVENT;
+    const filter = {
+        ...(text(query.project) != null ? { project: text(query.project) } : {}),
+        ...(text(query.card) != null ? { card: text(query.card) } : {}),
+    };
+    const unsubscribe = await facade.commits.subscribe(async (event) => {
+        try {
+            const enriched = event.record !== undefined ? event : { ...event, record: await facade.cards.load(event.card) };
+            await conn.notify(frame, enriched);
+        }
+        catch (e) {
+            console.error('Planning commit notify error:', e);
+        }
+    }, filter);
+    conn.listen(async (message) => {
+        if (typeof message !== 'object') {
+            return;
+        }
+        const msg = message;
+        if (msg.type === MessageType.System && msg.event === 'close') {
+            try {
+                unsubscribe();
+            }
+            catch (e) {
+                console.error('Planning commit unsubscribe error:', e);
+            }
+        }
+    });
+});
+//# sourceMappingURL=watch.js.map

package/build/actions/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/actions/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,IAAI,GAAG,CAAC,KAAc,EAAsB,EAAE,CAClD,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,QAA+C,EAAE,IAA6B,EAC/C,EAAE,CAAC,UAAU,CAA2B,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC1G,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAoB,CAAA;IAClD,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,qBAAqB,CAAA;IAClD,MAAM,MAAM,GAAG;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAA;IAED,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,KAAkB,EAAE,EAAE;QAC9E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;YAC/G,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAA;QACnD,CAAC;IACH,CAAC,EAAE,MAAM,CAAC,CAAA;IAEV,IAAI,CAAC,MAAM,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;QAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAM;QACR,CAAC;QACD,MAAM,GAAG,GAAG,OAA6B,CAAA;QACzC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC7D,IAAI,CAAC;gBACH,WAAW,EAAE,CAAA;YACf,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAA;YACxD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/consts.d.ts

@@ -0,0 +1,18 @@
+/** The alias `appendPlanningService` registers the host under — the same one a client uses. */
+export declare const DEFAULT_ALIAS = "planning";
+/** The alias a memory store answers `PlanningStore.alias` with. */
+export declare const MEMORY_STORE_ALIAS = "planning-memory";
+/**
+ * How many settled commits a hub remembers after their transition row may be gone.
+ *
+ * A project `delete` purges the project's own log, so without this a waiter that polls a moment
+ * after the fold would be told the transition never existed.
+ */
+export declare const DEFAULT_COMMIT_MEMORY = 1000;
+/**
+ * The poll ladder `wait` climbs after its first immediate poll, in milliseconds. The last step
+ * repeats. The subscription answers first whenever the fold publishes where the hub hears it; the
+ * ladder is what answers when it folded somewhere the hub does not.
+ */
+export declare const COMMIT_POLL_LADDER: readonly number[];
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,eAAO,MAAM,aAAa,aAAmB,CAAA;AAE7C,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,oBAAoB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAA;AAEzC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAqC,CAAA"}

package/build/consts.js

@@ -0,0 +1,19 @@
+import { PLANNING_SERVICE } from '@owlmeans/planning';
+/** The alias `appendPlanningService` registers the host under — the same one a client uses. */
+export const DEFAULT_ALIAS = PLANNING_SERVICE;
+/** The alias a memory store answers `PlanningStore.alias` with. */
+export const MEMORY_STORE_ALIAS = 'planning-memory';
+/**
+ * How many settled commits a hub remembers after their transition row may be gone.
+ *
+ * A project `delete` purges the project's own log, so without this a waiter that polls a moment
+ * after the fold would be told the transition never existed.
+ */
+export const DEFAULT_COMMIT_MEMORY = 1000;
+/**
+ * The poll ladder `wait` climbs after its first immediate poll, in milliseconds. The last step
+ * repeats. The subscription answers first whenever the fold publishes where the hub hears it; the
+ * ladder is what answers when it folded somewhere the hub does not.
+ */
+export const COMMIT_POLL_LADDER = Object.freeze([250, 1000, 2000]);
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAA;AAE7C,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAA;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA"}

package/build/executor/changes.d.ts

@@ -0,0 +1,31 @@
+import type { ChangeSet, PlanningSchemaRegistry, PlanningScope, Transition, TransitionActor, TransitionExecution } from '@owlmeans/planning';
+import type { Resolved } from './resolve.js';
+/**
+ * Step 9: the recorded `changes`/`unset`, and whether an update wrote nothing.
+ *
+ * @throws {IllegalTransition | PlanningError}
+ */
+export declare const changeSetOf: (exec: TransitionExecution, resolved: Resolved, schemas: PlanningSchemaRegistry, at: string) => {
+    set: ChangeSet;
+    empty: boolean;
+};
+/**
+ * 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 declare const actorOf: (scope: PlanningScope, exec: TransitionExecution) => TransitionActor;
+/** Step 11's record: the event as it is appended, `pending`. */
+export declare const transitionOf: (params: {
+    exec: TransitionExecution;
+    resolved: Resolved;
+    scope: PlanningScope;
+    set: ChangeSet;
+    cardId: string;
+    seq: number;
+    project?: string;
+    at: string;
+}) => Transition;
+//# sourceMappingURL=changes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/executor/changes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EAAE,sBAAsB,EAAE,aAAa,EAAqB,UAAU,EAAE,eAAe,EAChG,mBAAmB,EACpB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAK5C;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAChB,mBAAmB,YAAY,QAAQ,WAAW,sBAAsB,MAAM,MAAM,KACzF;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAKlC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,UAAW,aAAa,QAAQ,mBAAmB,KAAG,eAMxE,CAAA;AAIF,gEAAgE;AAChE,eAAO,MAAM,YAAY,WAAY;IACnC,IAAI,EAAE,mBAAmB,CAAA;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,aAAa,CAAA;IACpB,GAAG,EAAE,SAAS,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;CACX,KAAG,UA0BH,CAAA"}

package/build/executor/changes.js

@@ -0,0 +1,55 @@
+import { CommitState, computeChanges, isEmptyChange, 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 },
+    });
+};
+//# sourceMappingURL=changes.js.map

package/build/executor/changes.js.map

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

package/build/executor/code.d.ts

@@ -0,0 +1,15 @@
+import type { PlanningExecContext, PlanningPlugin, PlanningScope, TransitionExecution } from '@owlmeans/planning';
+import type { PluginRegistry } from '../registry.js';
+import type { Resolved } from './resolve.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>;
+//# sourceMappingURL=code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/executor/code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EACpF,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAW5C,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"}

package/build/executor/code.js

@@ -0,0 +1,59 @@
+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);
+        }
+        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;
+    }
+    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 mintCode(policy, taken, CODE_MINT_ATTEMPTS, {
+            ...(policy.style === CodeStyle.Slug ? { seed: draft.title } : {}),
+            ...(count != null ? { count } : {}),
+        });
+    }
+    return { ...exec, card: { ...draft, code } };
+};
+//# sourceMappingURL=code.js.map

package/build/executor/code.js.map

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

package/build/executor/receipt.d.ts

@@ -0,0 +1,12 @@
+import type { ExecuteOptions, PlanningStore, Transition, TransitionReceipt } from '@owlmeans/planning';
+/**
+ * A receipt for an appended (or idempotently found) transition.
+ *
+ * `committed()` waits on the store's commit source; a store without one (a foreign provider that
+ * applies writes itself) answers the card as it reads now. With `wait: true` the receipt is
+ * returned only once the commit landed — `CommitFailed` / `CommitTimeout` otherwise.
+ *
+ * @throws {CommitFailed | CommitTimeout} in wait mode
+ */
+export declare const makeReceipt: (store: PlanningStore, transition: Transition, opts?: ExecuteOptions) => Promise<TransitionReceipt>;
+//# sourceMappingURL=receipt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/executor/receipt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACI,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAC3E,MAAM,oBAAoB,CAAA;AAmC3B;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,UACf,aAAa,cAAc,UAAU,SAAS,cAAc,KAClE,OAAO,CAAC,iBAAiB,CAgB3B,CAAA"}

package/build/executor/receipt.js

@@ -0,0 +1,56 @@
+import { CommitState, DEFAULT_COMMIT_TIMEOUT, TransitionAction } from '@owlmeans/planning';
+const clean = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+const statusOf = async (store, transition) => {
+    if (store.commits == null || transition.id == null) {
+        return null;
+    }
+    try {
+        return await store.commits.status(transition.id);
+    }
+    catch {
+        return null;
+    }
+};
+/** The transition as its latest commit status reports it, and the card when that commit landed. */
+const viewOf = async (store, transition) => {
+    const status = await statusOf(store, transition);
+    if (status == null) {
+        return { transition };
+    }
+    const view = {
+        transition: { ...transition, commit: clean({ state: status.state, at: status.at, error: status.error }) },
+    };
+    if (status.state === CommitState.Committed) {
+        view.card = status.card !== undefined
+            ? status.card
+            : transition.action === TransitionAction.Delete
+                ? null
+                : await store.cards.get(transition.card, transition.entityId);
+    }
+    return view;
+};
+/**
+ * A receipt for an appended (or idempotently found) transition.
+ *
+ * `committed()` waits on the store's commit source; a store without one (a foreign provider that
+ * applies writes itself) answers the card as it reads now. With `wait: true` the receipt is
+ * returned only once the commit landed — `CommitFailed` / `CommitTimeout` otherwise.
+ *
+ * @throws {CommitFailed | CommitTimeout} in wait mode
+ */
+export const makeReceipt = async (store, transition, opts) => {
+    const committed = async (waitOpts) => {
+        if (store.commits == null || transition.id == null) {
+            return await store.cards.get(transition.card, transition.entityId);
+        }
+        return await store.commits.wait(transition.id, { timeout: waitOpts?.timeout ?? DEFAULT_COMMIT_TIMEOUT });
+    };
+    let view = await viewOf(store, transition);
+    if (opts?.wait === true && view.transition.commit.state !== CommitState.Committed) {
+        const card = await committed({ timeout: opts.timeout });
+        view = await viewOf(store, transition);
+        view.card = card;
+    }
+    return { ...view, committed };
+};
+//# sourceMappingURL=receipt.js.map

package/build/executor/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../../src/executor/receipt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAK1F,MAAM,KAAK,GAAG,CAAmB,MAAS,EAAK,EAAE,CAC/C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAM,CAAA;AAE5F,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAoB,EAAE,UAAsB,EAAgC,EAAE;IACpG,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,UAAU,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACnD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED,mGAAmG;AACnG,MAAM,MAAM,GAAG,KAAK,EAAE,KAAoB,EAAE,UAAsB,EAAkC,EAAE;IACpG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAChD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,UAAU,EAAE,CAAA;IACvB,CAAC;IACD,MAAM,IAAI,GAA0B;QAClC,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE;KAC1G,CAAA;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC,SAAS,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS;YACnC,CAAC,CAAC,MAAM,CAAC,IAAI;YACb,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,gBAAgB,CAAC,MAAM;gBAC7C,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,KAAoB,EAAE,UAAsB,EAAE,IAAqB,EACvC,EAAE;IAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,QAA+B,EAA4B,EAAE;QACpF,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,UAAU,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YACnD,OAAO,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;QACpE,CAAC;QACD,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,sBAAsB,EAAE,CAAC,CAAA;IAC1G,CAAC,CAAA;IAED,IAAI,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAC1C,IAAI,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC,SAAS,EAAE,CAAC;QAClF,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QACvD,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAA;AAC/B,CAAC,CAAA"}

package/build/executor/resolve.d.ts

@@ -0,0 +1,35 @@
+import { WorkcardKind } from '@owlmeans/planning';
+import type { AnyTypeSchema, PlanningFacade, PlanningStore, SpecificationSlot, StatusFlowSchema, TransitionExecution, Workcard } from '@owlmeans/planning';
+import type { PlanningRuntime } from '../service.js';
+/** Everything the steps after resolution read about an execution. */
+export interface Resolved {
+    create: boolean;
+    /** The existing card (not a create). */
+    card?: Workcard;
+    type: AnyTypeSchema;
+    flowId: string;
+    flow: StatusFlowSchema;
+    /** The primary parent, when it resolves. */
+    parent?: Workcard;
+    /** The slot a specification belongs to. */
+    slot?: SpecificationSlot;
+    /** The store the type is written to. */
+    store: PlanningStore;
+}
+/**
+ * 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.
+ */
+export declare const normalizeExecution: (input: TransitionExecution) => TransitionExecution;
+/** The parent type's rule for a child of `kind`/`type`. @throws {CardTypeNotAllowed} */
+export declare const assertChildAllowed: (runtime: PlanningRuntime, parent: Workcard, kind: WorkcardKind, type: string) => void;
+/**
+ * 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}
+ */
+export 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. */
+export declare const projectFor: (resolved: Resolved, exec: TransitionExecution, cardId: string) => string | undefined;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/executor/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAEkE,YAAY,EACpF,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACV,aAAa,EAAE,cAAc,EAAE,aAAa,EAAoC,iBAAiB,EACjG,gBAAgB,EAAE,mBAAmB,EAAE,QAAQ,EAChD,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,OAAO,CAAA;IACf,wCAAwC;IACxC,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,gBAAgB,CAAA;IACtB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB,wCAAwC;IACxC,KAAK,EAAE,aAAa,CAAA;CACrB;AAmBD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,UAAW,mBAAmB,KAAG,mBAc/D,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,YACpB,eAAe,UAAU,QAAQ,QAAQ,YAAY,QAAQ,MAAM,KAC3E,IAYF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAClB,eAAe,UAAU,cAAc,QAAQ,mBAAmB,KAC1E,OAAO,CAAC,QAAQ,CAyElB,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,UAAU,aAAc,QAAQ,QAAQ,mBAAmB,UAAU,MAAM,KAAG,MAAM,GAAG,SASnG,CAAA"}