@miragon/pulse-engine-core 0.0.0-bootstrap.0 → 0.25.0

package/dist/inspect.js

@@ -0,0 +1,247 @@
+/**
+ * Inspect: where a process instance waits and why. Loads the rounds of requests (instance, tree,
+ * wait states, root causes) and assembles the instance view.
+ */
+import { isWorkflowError, WorkflowError } from "./errors.js";
+import { isMissing, PARALLEL } from "./port.js";
+import { field, records, str } from "./records.js";
+import { listByIds } from "./requests.js";
+import { rootCause } from "./root-cause.js";
+import { selectInstance } from "./select.js";
+import { instanceView, rootIncidents } from "./snapshot.js";
+import { activeTree } from "./tree.js";
+import { compact, isRecord, mapLimit } from "./util.js";
+import { historicVariableMap, RAW_VARIABLES } from "./variables.js";
+/** Root causes are loaded for at most this many incidents per command run. */
+const MAX_CAUSES = 10;
+/** A stack trace an instance view carries is cut after this many lines. */
+export const MAX_STACKTRACE_LINES = 200;
+const NO_VALUES = { deserializeValues: String(RAW_VARIABLES.deserializeValues) };
+const JOBS = { operationId: "getJobs", key: "processInstanceIds" };
+/** The request that holds the root cause of an incident type. */
+const CAUSE_OPERATIONS = new Map([
+    ["failedJob", "getStacktrace"],
+    ["failedExternalTask", "getExternalTaskErrorDetails"],
+]);
+function idInput(id) {
+    return { pathArgs: [id], query: {} };
+}
+/** The first round for an id: runtime and history record. */
+export function instanceRequests(id) {
+    return [
+        { operationId: "getProcessInstance", input: idInput(id) },
+        { operationId: "getHistoricProcessInstance", input: idInput(id) },
+    ];
+}
+/** An id that neither the runtime nor the history knows. */
+function instanceMissing(id) {
+    return new WorkflowError({ kind: "instance-missing", id });
+}
+async function timeline(port, id) {
+    const [activities, incidents] = await Promise.all([
+        port.list("getHistoricActivityInstances", {
+            processInstanceId: id,
+            sortBy: "occurrence",
+            sortOrder: "asc",
+        }),
+        port.list("getHistoricIncidents", { processInstanceId: id }),
+    ]);
+    return { timeline: activities.items, historicIncidents: incidents.items };
+}
+function emptyData(id, options) {
+    return {
+        id,
+        tree: [],
+        truncated: false,
+        activityTrees: [],
+        incidents: [],
+        subscriptions: [],
+        tasks: [],
+        externalTasks: [],
+        jobs: [],
+        timerJobIds: new Set(),
+        definitions: [],
+        jobDefinitions: [],
+        causes: new Map(),
+        historyRequested: options.history,
+    };
+}
+async function endedData(port, id, history, options) {
+    const [variables, past] = await Promise.all([
+        options.variables
+            ? port.list("getHistoricVariableInstances", { processInstanceId: id, ...NO_VALUES })
+            : undefined,
+        options.history ? timeline(port, id) : undefined,
+    ]);
+    return {
+        ...emptyData(id, options),
+        history,
+        ...compact({ variables: variables && historicVariableMap(variables.items, id) }),
+        ...past,
+    };
+}
+/**
+ * The instance ended between two rounds (a job executor finished it): its activity instances
+ * answer 404, its variables 500 NullValueException (verified on all three engines).
+ */
+function endedMeanwhile(port, error) {
+    const failure = port.failure(error);
+    if (isMissing(failure))
+        return true;
+    return failure?.status === 500 && failure.engineType === "NullValueException";
+}
+/**
+ * Per instance of the tree: activity instance tree, incidents and event subscriptions. Instances
+ * that ended since the tree was read are `gone` and left out.
+ */
+async function perInstance(port, ids) {
+    const rows = await mapLimit(ids, PARALLEL, async (pid) => {
+        const [activities, incidents, subscriptions] = await Promise.all([
+            port.find("getActivityInstanceTree", idInput(pid)),
+            port.list("getIncidents", { processInstanceId: pid }),
+            port.list("getEventSubscriptions", { processInstanceId: pid }),
+        ]);
+        return { pid, activities, incidents: incidents.items, subscriptions: subscriptions.items };
+    });
+    const present = rows.filter((row) => row.activities !== undefined);
+    return {
+        gone: new Set(rows.filter((row) => row.activities === undefined).map((row) => row.pid)),
+        activityTrees: records(present.map((row) => row.activities)),
+        incidents: present.flatMap((row) => row.incidents),
+        subscriptions: present.flatMap((row) => row.subscriptions),
+    };
+}
+/** The variables of the process scope; `gone` when the instance ended meanwhile. */
+async function scopeVariables(port, id) {
+    try {
+        const value = await port.json("getProcessInstanceVariables", {
+            pathArgs: [id],
+            query: NO_VALUES,
+        });
+        return isRecord(value) ? value : {};
+    }
+    catch (error) {
+        if (endedMeanwhile(port, error))
+            return "gone";
+        throw error;
+    }
+}
+/** Once for the whole tree: tasks, external tasks, jobs, timers, definitions, job definitions. */
+async function perTree(port, ids, definitionIds) {
+    const [tasks, externalTasks, jobs, timers, definitions, jobDefinitions] = await Promise.all([
+        listByIds(port, { operationId: "getTasks", key: "processInstanceIdIn", ids }),
+        listByIds(port, { operationId: "getExternalTasks", key: "processInstanceIdIn", ids }),
+        listByIds(port, { operationId: "getJobs", key: "processInstanceIds", ids }),
+        listByIds(port, { ...JOBS, ids, query: { timers: "true" } }),
+        listByIds(port, {
+            operationId: "getProcessDefinitions",
+            key: "processDefinitionIdIn",
+            ids: definitionIds,
+        }),
+        mapLimit(definitionIds, PARALLEL, (definitionId) => port.list("getJobDefinitions", { processDefinitionId: definitionId })),
+    ]);
+    const timerJobIds = new Set(timers.flatMap((timer) => str(timer, "id") ?? []));
+    return {
+        tasks,
+        externalTasks,
+        jobs,
+        timerJobIds,
+        definitions,
+        jobDefinitions: jobDefinitions.flatMap((page) => page.items),
+    };
+}
+async function parentOf(port, id) {
+    const parents = await port.list("getProcessInstances", { subProcessInstance: id }, 1);
+    return str(parents.items[0], "id");
+}
+/** The data of a running instance; undefined when it ended while the rounds ran. */
+async function activeData(port, ids, options) {
+    const { id, runtime, history } = ids;
+    const [tree, parentId] = await Promise.all([
+        activeTree(port, runtime),
+        history === undefined ? parentOf(port, id) : undefined,
+    ]);
+    const pids = tree.nodes.map((node) => node.id);
+    const definitionIds = [...new Set(tree.nodes.map((node) => node.definitionId))];
+    const [{ gone, ...instances }, items, variables, past] = await Promise.all([
+        perInstance(port, pids),
+        perTree(port, pids, definitionIds),
+        options.variables ? scopeVariables(port, id) : undefined,
+        options.history ? timeline(port, id) : undefined,
+    ]);
+    if (gone.has(id) || variables === "gone")
+        return undefined;
+    return {
+        ...emptyData(id, options),
+        runtime,
+        ...compact({ history, parentId, variables }),
+        // called instances that ended since the tree was read are left out
+        tree: tree.nodes.filter((node) => !gone.has(node.id)),
+        truncated: tree.truncated,
+        ...instances,
+        ...items,
+        ...past,
+    };
+}
+/**
+ * The root cause of an incident: from the stacktrace of a failed job or the error details of a
+ * failed external task, else the incident message; with `stacktrace` also the (first 200) lines.
+ */
+export async function incidentCause(port, incident, stacktrace) {
+    const operation = CAUSE_OPERATIONS.get(field(incident, "incidentType"));
+    const configuration = str(incident, "configuration");
+    const text = operation === undefined || configuration === undefined
+        ? undefined
+        : await port.text(operation, [configuration]);
+    const message = str(incident, "incidentMessage");
+    const lines = text?.trimEnd().split(/\r?\n/).slice(0, MAX_STACKTRACE_LINES);
+    return compact({
+        rootCause: (text === undefined ? undefined : rootCause(text)) ?? message,
+        stacktrace: stacktrace ? lines : undefined,
+    });
+}
+/** Root causes of the first (at most 10) open root incidents. */
+async function causes(port, incidents, options) {
+    const first = rootIncidents(incidents).slice(0, MAX_CAUSES);
+    const loaded = await mapLimit(first, PARALLEL, (incident) => incidentCause(port, incident, options.stacktrace));
+    return new Map(first.map((incident, index) => [field(incident, "id"), loaded[index] ?? {}]));
+}
+/**
+ * The instance view of `id`; `instance-missing` when neither runtime nor history know it. An instance that
+ * ends while the rounds run (a job executor finished it) is loaded once more, then as ended.
+ */
+export async function loadInstance(port, id, options, attempts = 2) {
+    const [runtime, history] = await Promise.all(instanceRequests(id).map(async (request) => records([await port.find(request.operationId, request.input)])[0]));
+    if (runtime === undefined && history === undefined)
+        throw instanceMissing(id);
+    if (runtime === undefined)
+        return instanceView(await endedData(port, id, history ?? {}, options));
+    const data = await activeData(port, { id, runtime, ...compact({ history }) }, options);
+    if (data === undefined) {
+        if (attempts > 1)
+            return loadInstance(port, id, options, attempts - 1);
+        throw instanceMissing(id);
+    }
+    return instanceView({ ...data, causes: await causes(port, data.incidents, options) });
+}
+/**
+ * The view after a write: an instance that ended without a history record (history level none)
+ * is `{id, state: "ENDED"}` instead of `instance-missing`.
+ */
+export async function loadView(port, id, options) {
+    try {
+        return await loadInstance(port, id, options);
+    }
+    catch (error) {
+        if (isWorkflowError(error) && error.reason.kind === "instance-missing") {
+            return { id, state: "ENDED" };
+        }
+        throw error;
+    }
+}
+/** Inspect: the selected instance's view (selection rules and errors as `selectInstance`'s). */
+export async function inspectInstance(port, selection, options) {
+    const id = await selectInstance(port, selection);
+    return loadInstance(port, id, options);
+}
+//# sourceMappingURL=inspect.js.map

package/dist/inspect.js.map

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

package/dist/next.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Ready follow-ups of the instance view: at most three steps, always by id (never by business
+ * key), so they are reproducible. A caller renders each step in its own words. Pure.
+ */
+import type { InstanceView, ItemStep, NextStep, WaitState } from "./types.js";
+/** Wait states advance can move: also receive tasks without a message. */
+export declare function isAdvanceable(wait: WaitState): boolean;
+/** True for incident types whose retries retry sets. */
+export declare function isRetryable(type: string): boolean;
+type NextInput = Pick<InstanceView<unknown>, "id" | "state" | "waitingAt" | "incidents">;
+/** A suspended job: advance refuses to execute it. */
+export declare function isSuspendedJob(wait: WaitState): boolean;
+/**
+ * The step that moves one wait state (an item of a multi-instance activity) when its ids are all
+ * it needs; undefined for external tasks (they need a lock first) and conditions.
+ */
+export declare function itemStep(wait: WaitState): ItemStep | undefined;
+/** The wait states per activity, in the order of the view. */
+export declare function byActivity(waits: readonly WaitState[]): Map<string, WaitState[]>;
+/**
+ * Retry for a failed job or external task, the advance steps above, the history of an ended
+ * instance shown without it.
+ */
+export declare function nextSteps(view: NextInput, historyShown: boolean): NextStep[];
+export {};
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAY,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAevF,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAItD;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC,CAAA;AAExF,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAE9D;AAMD,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAMhF;AAqBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,GAAG,QAAQ,EAAE,CAU5E"}

package/dist/next.js

@@ -0,0 +1,83 @@
+/**
+ * Ready follow-ups of the instance view: at most three steps, always by id (never by business
+ * key), so they are reproducible. A caller renders each step in its own words. Pure.
+ */
+import { BUILT_IN_INCIDENT_TYPES } from "./incident-recovery.js";
+const MAX_NEXT = 3;
+const MAX_ACTIVITIES = 2;
+const RETRYABLE = new Set(BUILT_IN_INCIDENT_TYPES);
+const ADVANCEABLE = new Set([
+    "userTask",
+    "externalTask",
+    "timer",
+    "asyncContinuation",
+    "message",
+    "signal",
+]);
+const RUNNING = new Set(["ACTIVE", "SUSPENDED"]);
+/** Wait states advance can move: also receive tasks without a message. */
+export function isAdvanceable(wait) {
+    return (ADVANCEABLE.has(wait.kind) || (wait.kind === "other" && wait.activityType === "receiveTask"));
+}
+/** True for incident types whose retries retry sets. */
+export function isRetryable(type) {
+    return RETRYABLE.has(type);
+}
+/** A suspended job: advance refuses to execute it. */
+export function isSuspendedJob(wait) {
+    return (wait.kind === "timer" || wait.kind === "asyncContinuation") && wait.suspended === true;
+}
+/**
+ * The step that moves one wait state (an item of a multi-instance activity) when its ids are all
+ * it needs; undefined for external tasks (they need a lock first) and conditions.
+ */
+export function itemStep(wait) {
+    return isItemWait(wait) ? { action: "move", wait } : undefined;
+}
+function isItemWait(wait) {
+    return wait.kind !== "externalTask" && wait.kind !== "conditional";
+}
+/** The wait states per activity, in the order of the view. */
+export function byActivity(waits) {
+    const groups = new Map();
+    for (const wait of waits) {
+        groups.set(wait.activityId, [...(groups.get(wait.activityId) ?? []), wait]);
+    }
+    return groups;
+}
+/**
+ * Advance the only wait state; with several, per activity (the first two) advance at that
+ * activity, or move the first item of a multi-instance activity (advance at an activity refuses
+ * to pick one). A suspended instance is activated first.
+ */
+function advanceSteps(view) {
+    const processInstanceId = view.id;
+    if (view.state === "SUSPENDED")
+        return [{ action: "activate", processInstanceId }];
+    const movable = view.waitingAt.filter((wait) => isAdvanceable(wait) && !isSuspendedJob(wait));
+    if (movable.length === 1)
+        return [{ action: "advance", processInstanceId }];
+    return [...byActivity(movable).entries()]
+        .filter(([activityId]) => activityId !== "")
+        .slice(0, MAX_ACTIVITIES)
+        .flatMap(([activityId, waits]) => {
+        if (waits.length === 1)
+            return [{ action: "advance", processInstanceId, activityId }];
+        return waits[0] === undefined ? [] : (itemStep(waits[0]) ?? []);
+    });
+}
+/**
+ * Retry for a failed job or external task, the advance steps above, the history of an ended
+ * instance shown without it.
+ */
+export function nextSteps(view, historyShown) {
+    const processInstanceId = view.id;
+    const retry = view.incidents.some((incident) => isRetryable(incident.type))
+        ? [{ action: "retry", processInstanceId }]
+        : [];
+    const history = !RUNNING.has(view.state) && !historyShown
+        ? [{ action: "inspectHistory", processInstanceId }]
+        : [];
+    return [...retry, ...advanceSteps(view), ...history].slice(0, MAX_NEXT);
+}
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

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

package/dist/operations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The operations each composite may send, by operation id: the contract with a port adapter that
+ * maps operations one by one (the engine connector holds its table equal to the union).
+ */
+/** `inspectInstance`: the selection reads, the rounds of the instance view and its root causes. */
+export declare const INSPECT_OPERATIONS: readonly ["getHistoricProcessInstances", "getProcessInstances", "getProcessInstance", "getHistoricProcessInstance", "getActivityInstanceTree", "getIncidents", "getEventSubscriptions", "getTasks", "getExternalTasks", "getJobs", "getProcessDefinitions", "getJobDefinitions", "getProcessInstanceVariables", "getHistoricVariableInstances", "getHistoricActivityInstances", "getHistoricIncidents", "getStacktrace", "getExternalTaskErrorDetails"];
+/** `readStatus`: round one and the root cause of each incident group shown. */
+export declare const STATUS_OPERATIONS: readonly ["getRestAPIVersion", "getProcessDefinitionStatistics", "getIncidents", "getIncidentsCount", "getExternalTasks", "getExternalTasksCount", "getJobsCount", "getJobs", "getTasksCount", "getBatchStatistics", "getStacktrace", "getExternalTaskErrorDetails"];
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,ybAmBrB,CAAA;AAEV,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,sQAapB,CAAA"}

package/dist/operations.js

@@ -0,0 +1,41 @@
+/**
+ * The operations each composite may send, by operation id: the contract with a port adapter that
+ * maps operations one by one (the engine connector holds its table equal to the union).
+ */
+/** `inspectInstance`: the selection reads, the rounds of the instance view and its root causes. */
+export const INSPECT_OPERATIONS = [
+    "getHistoricProcessInstances",
+    "getProcessInstances",
+    "getProcessInstance",
+    "getHistoricProcessInstance",
+    "getActivityInstanceTree",
+    "getIncidents",
+    "getEventSubscriptions",
+    "getTasks",
+    "getExternalTasks",
+    "getJobs",
+    "getProcessDefinitions",
+    "getJobDefinitions",
+    "getProcessInstanceVariables",
+    "getHistoricVariableInstances",
+    "getHistoricActivityInstances",
+    "getHistoricIncidents",
+    "getStacktrace",
+    "getExternalTaskErrorDetails",
+];
+/** `readStatus`: round one and the root cause of each incident group shown. */
+export const STATUS_OPERATIONS = [
+    "getRestAPIVersion",
+    "getProcessDefinitionStatistics",
+    "getIncidents",
+    "getIncidentsCount",
+    "getExternalTasks",
+    "getExternalTasksCount",
+    "getJobsCount",
+    "getJobs",
+    "getTasksCount",
+    "getBatchStatistics",
+    "getStacktrace",
+    "getExternalTaskErrorDetails",
+];
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mGAAmG;AACnG,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,6BAA6B;IAC7B,qBAAqB;IACrB,oBAAoB;IACpB,4BAA4B;IAC5B,yBAAyB;IACzB,cAAc;IACd,uBAAuB;IACvB,UAAU;IACV,kBAAkB;IAClB,SAAS;IACT,uBAAuB;IACvB,mBAAmB;IACnB,6BAA6B;IAC7B,8BAA8B;IAC9B,8BAA8B;IAC9B,sBAAsB;IACtB,eAAe;IACf,6BAA6B;CACrB,CAAA;AAEV,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mBAAmB;IACnB,gCAAgC;IAChC,cAAc;IACd,mBAAmB;IACnB,kBAAkB;IAClB,uBAAuB;IACvB,cAAc;IACd,SAAS;IACT,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,6BAA6B;CACrB,CAAA"}

package/dist/poll.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The polling loop of waiting for a condition: a check right away, then after
+ * sleeps of 250, 500, 1000, 2000, 2000, ... ms; the last sleep ends at the deadline, where a
+ * final check runs. Pure: the clock and the sleep are injected.
+ */
+export interface PollTiming {
+    readonly now: () => number;
+    readonly sleep: (ms: number) => Promise<void>;
+    readonly timeoutMs: number;
+    /** Called once, before the first sleep (the wait really waits). */
+    readonly waiting?: () => void;
+}
+export interface PollResult<T> {
+    /** The value of the check that ended the loop; undefined after the deadline. */
+    readonly value?: T;
+    readonly polls: number;
+    readonly elapsedMs: number;
+}
+/**
+ * Runs `check` until it returns a value or the deadline passed. `check` gets the number of the
+ * poll (1 for the first).
+ */
+export declare function poll<T>(check: (polls: number) => Promise<T | undefined>, timing: PollTiming): Promise<PollResult<T>>;
+//# sourceMappingURL=poll.d.ts.map

package/dist/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAKD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,EAChD,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAaxB"}

package/dist/poll.js

@@ -0,0 +1,29 @@
+/**
+ * The polling loop of waiting for a condition: a check right away, then after
+ * sleeps of 250, 500, 1000, 2000, 2000, ... ms; the last sleep ends at the deadline, where a
+ * final check runs. Pure: the clock and the sleep are injected.
+ */
+const FIRST_DELAY_MS = 250;
+const MAX_DELAY_MS = 2000;
+/**
+ * Runs `check` until it returns a value or the deadline passed. `check` gets the number of the
+ * poll (1 for the first).
+ */
+export async function poll(check, timing) {
+    const started = timing.now();
+    const deadline = started + timing.timeoutMs;
+    let delay = FIRST_DELAY_MS;
+    for (let polls = 1;; polls++) {
+        const value = await check(polls);
+        const now = timing.now();
+        if (value !== undefined)
+            return { value, polls, elapsedMs: now - started };
+        if (now >= deadline)
+            return { polls, elapsedMs: now - started };
+        if (polls === 1)
+            timing.waiting?.();
+        await timing.sleep(Math.min(delay, deadline - now));
+        delay = Math.min(delay * 2, MAX_DELAY_MS);
+    }
+}
+//# sourceMappingURL=poll.js.map

package/dist/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,MAAM,cAAc,GAAG,GAAG,CAAA;AAC1B,MAAM,YAAY,GAAG,IAAI,CAAA;AAEzB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,KAAgD,EAChD,MAAkB;IAElB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,CAAA;IAC5B,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC,SAAS,CAAA;IAC3C,IAAI,KAAK,GAAG,cAAc,CAAA;IAC1B,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAA;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,EAAE,CAAA;QAC1E,IAAI,GAAG,IAAI,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,EAAE,CAAA;QAC/D,IAAI,KAAK,KAAK,CAAC;YAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAA;QACnC,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAA;QACnD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,YAAY,CAAC,CAAA;IAC3C,CAAC;AACH,CAAC"}

package/dist/port.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The engine port of the Camunda 7 REST API family: the operations a workflow sends, by the
+ * operation ids of the REST API, and the read rules every caller shares (paging, missing
+ * resources, text answers). A caller supplies the transport; vendors are its runtime config.
+ */
+import { type Rec } from "./records.js";
+/** Query values by wire name, as text; undefined entries are not sent. */
+export type Query = Readonly<Record<string, string | undefined>>;
+/** Path values in path order, the query, an optional JSON body. */
+export interface OperationInput {
+    readonly pathArgs: readonly string[];
+    readonly query: Query;
+    readonly body?: unknown;
+}
+/** A request a workflow sends. */
+export interface PlannedRequest {
+    readonly operationId: string;
+    readonly input: OperationInput;
+}
+/**
+ * A write of a workflow; `label` says it in words (`execute job j1`), for a preview. Not named
+ * `summary`: scripts/hand-off-refs.test.mjs reads an object literal with a `summary` in a
+ * package's source as a hand-off to the model.
+ */
+export interface PlannedWrite extends PlannedRequest {
+    readonly label: string;
+}
+/** What an engine's error answer says. */
+export interface EngineFailure {
+    readonly status: number;
+    readonly engineType?: string;
+    readonly engineMessage?: string;
+}
+/**
+ * How a caller reaches one engine. `A` is the caller's answer of a request, which the port reads
+ * as JSON or as text right after awaiting it.
+ */
+export interface EngineTransport<A = unknown> {
+    /** Sends the operation and resolves to its answer; rejects on any failure. */
+    send(operationId: string, input: OperationInput): Promise<A>;
+    /** The JSON value of an answer; undefined when it carries none. */
+    json(answer: A): unknown;
+    /** The text of an answer (stacktrace, error details); undefined when it carries none. */
+    text(answer: A): string | undefined;
+    /** The engine answer an error of `send` carries; undefined for anything else. */
+    failure(error: unknown): EngineFailure | undefined;
+}
+export interface ListResult {
+    readonly items: readonly Rec[];
+    /** True when the engine has more than the `cap` items that were loaded. */
+    readonly truncated: boolean;
+}
+/** What the workflows run on. */
+export interface EnginePort {
+    /** The JSON value of the operation. */
+    json(operationId: string, input: OperationInput): Promise<unknown>;
+    /** As `json`; a missing resource (`isMissing`) gives undefined. */
+    find(operationId: string, input: OperationInput): Promise<unknown>;
+    /** All pages of 500, at most `cap` items (one more is asked for to tell truncation). */
+    list(operationId: string, query: Query, cap?: number): Promise<ListResult>;
+    /** A text answer; missing, 204, empty or blank give undefined. */
+    text(operationId: string, pathArgs: readonly string[]): Promise<string | undefined>;
+    /** The engine answer an error of the port carries (the transport's reading). */
+    failure(error: unknown): EngineFailure | undefined;
+}
+/** Most parallel requests of one round. */
+export declare const PARALLEL = 8;
+/**
+ * An engine 404 that names a missing resource: status 404 with an engine exception type other than
+ * NotFoundException (JAX-RS: no such endpoint, a wrong REST root) and QueryParamException (an
+ * unreadable query value).
+ */
+export declare function isMissing(failure: EngineFailure | undefined): boolean;
+/** The query of a page of `list`. */
+export declare function pageQuery(query: Query, first: number, size: number): Query;
+/**
+ * The port over `transport`: a plain object of closures, never a class instance, so a caller can
+ * spread it and add its own methods.
+ */
+export declare function createEnginePort<A>(transport: EngineTransport<A>): EnginePort;
+/**
+ * At most `limit` requests in flight: the rounds of a workflow may start more at once, the
+ * others wait for a free slot (a released slot passes straight to the next waiter).
+ */
+export declare class Slots {
+    private readonly limit;
+    private active;
+    private readonly waiting;
+    constructor(limit?: number);
+    acquire(): Promise<void>;
+    release(): void;
+    /** Runs `fn` in a slot: waits for one, frees it when `fn` settles. */
+    run<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=port.d.ts.map

package/dist/port.d.ts.map

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