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

package/dist/types.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Views of the workflow domain. Keys appear in the documented order, absent values are left out,
+ * empty lists are kept. Types only.
+ */
+import type { Rec } from "./records.js";
+export type InstanceState = "ACTIVE" | "SUSPENDED" | "COMPLETED" | "EXTERNALLY_TERMINATED" | "INTERNALLY_TERMINATED";
+export interface DefinitionView {
+    readonly key: string;
+    readonly version?: number;
+    readonly name?: string;
+    readonly id: string;
+}
+interface WaitBase {
+    /** Only when the wait is in a called instance. */
+    readonly processInstanceId?: string;
+    readonly activityId: string;
+    readonly activityName?: string;
+    readonly activityType?: string;
+    /** The activity a boundary event is attached to. */
+    readonly attachedTo?: string;
+    readonly since?: string;
+    readonly incidentId?: string;
+}
+export type WaitKind = "userTask" | "externalTask" | "timer" | "asyncContinuation" | "message" | "signal" | "conditional" | "other";
+export type WaitState = WaitBase & ({
+    readonly kind: "userTask";
+    readonly taskId: string;
+    readonly name?: string;
+    readonly assignee?: string;
+    readonly due?: string;
+} | {
+    readonly kind: "externalTask";
+    readonly externalTaskId: string;
+    readonly topic: string;
+    readonly workerId?: string;
+    readonly lockExpirationTime?: string;
+    readonly retries?: number;
+    readonly errorMessage?: string;
+} | {
+    readonly kind: "timer";
+    readonly jobId: string;
+    readonly dueDate: string;
+    readonly retries: number;
+    /** The job (or its job definition) is suspended: the job executor does not run it. */
+    readonly suspended?: true;
+} | {
+    readonly kind: "asyncContinuation";
+    readonly jobId: string;
+    readonly retries: number;
+    readonly dueDate?: string;
+    /** Left out when the wait state has an incident (the incident carries the message). */
+    readonly exceptionMessage?: string;
+    readonly suspended?: true;
+} | {
+    readonly kind: "message" | "signal" | "conditional";
+    readonly eventSubscriptionId: string;
+    readonly eventName?: string;
+    readonly executionId: string;
+} | {
+    readonly kind: "other";
+    readonly executionId: string;
+});
+export interface IncidentView {
+    readonly id: string;
+    readonly type: string;
+    readonly activityId: string;
+    readonly processInstanceId?: string;
+    readonly message?: string;
+    readonly rootCause?: string;
+    readonly jobId?: string;
+    readonly externalTaskId?: string;
+    readonly since: string;
+    readonly annotation?: string;
+    readonly stacktrace?: readonly string[];
+}
+export interface ChildView {
+    readonly id: string;
+    readonly parentId: string;
+    readonly key: string;
+    readonly version?: number;
+    readonly businessKey?: string;
+    readonly state: "ACTIVE" | "SUSPENDED";
+}
+export interface TimelineIncident {
+    readonly type: string;
+    readonly message?: string;
+    readonly state: "open" | "resolved" | "deleted";
+}
+export interface TimelineEntry {
+    readonly activityId: string;
+    readonly activityName?: string;
+    readonly activityType: string;
+    readonly startTime: string;
+    readonly endTime?: string;
+    readonly durationMs?: number;
+    readonly canceled?: true;
+    readonly assignee?: string;
+    readonly calledProcessInstanceId?: string;
+    readonly incidents?: readonly TimelineIncident[];
+}
+/** How a wait ended successfully: the condition that held. */
+export interface Waited {
+    readonly until: string;
+    readonly elapsedMs: number;
+    readonly polls: number;
+}
+/** `N`: what a next step is, structured data (`NextStep`) or the text a caller renders from it. */
+export interface InstanceView<N = NextStep> {
+    readonly id: string;
+    readonly businessKey?: string;
+    readonly definition: DefinitionView;
+    readonly state: InstanceState;
+    readonly startTime?: string;
+    readonly endTime?: string;
+    readonly durationMs?: number;
+    readonly deleteReason?: string;
+    readonly parentId?: string;
+    /** Only when it differs from `id`. */
+    readonly rootId?: string;
+    readonly waitingAt: readonly WaitState[];
+    readonly incidents: readonly IncidentView[];
+    readonly propagatedIncidents?: number;
+    readonly children: readonly ChildView[];
+    readonly variables?: Readonly<Record<string, unknown>>;
+    readonly timeline?: readonly TimelineEntry[];
+    readonly truncated?: true;
+    readonly next: readonly N[];
+    readonly waited?: Waited;
+}
+/** An instance that ended without a history record (history level none). */
+export interface EndedInstance {
+    readonly id: string;
+    readonly state: "ENDED";
+    readonly waited?: Waited;
+}
+/** A process instance of the active tree. */
+export interface TreeNode {
+    readonly id: string;
+    readonly parentId?: string;
+    readonly definitionId: string;
+    readonly definitionKey?: string;
+    readonly businessKey?: string;
+    readonly suspended: boolean;
+    /** 0 for the selected instance. */
+    readonly depth: number;
+}
+/** The root cause of an incident, loaded for at most 10 incidents per run. */
+export interface IncidentCause {
+    readonly rootCause?: string;
+    readonly stacktrace?: readonly string[];
+}
+/** Everything `inspect` loaded for one instance; `instanceView` turns it into the view. */
+export interface InstanceData {
+    readonly id: string;
+    /** The ProcessInstanceDto; absent when the instance ended. */
+    readonly runtime?: Rec;
+    /** The HistoricProcessInstanceDto; absent with history level none. */
+    readonly history?: Rec;
+    /** The parent instance, when there is no history record. */
+    readonly parentId?: string;
+    readonly tree: readonly TreeNode[];
+    readonly truncated: boolean;
+    /** The activity instance tree of every instance of the tree. */
+    readonly activityTrees: readonly Rec[];
+    readonly incidents: readonly Rec[];
+    readonly subscriptions: readonly Rec[];
+    readonly tasks: readonly Rec[];
+    readonly externalTasks: readonly Rec[];
+    readonly jobs: readonly Rec[];
+    readonly timerJobIds: ReadonlySet<string>;
+    readonly definitions: readonly Rec[];
+    readonly jobDefinitions: readonly Rec[];
+    /** The variable map of the process scope; absent unless variables were asked for. */
+    readonly variables?: Rec;
+    /** Historic activity instances in BPMN order; only when the history was asked for. */
+    readonly timeline?: readonly Rec[];
+    readonly historicIncidents?: readonly Rec[];
+    /** Root causes by incident id. */
+    readonly causes: ReadonlyMap<string, IncidentCause>;
+    /** True when the history was asked for (the next steps then suggest no history). */
+    readonly historyRequested: boolean;
+}
+/**
+ * A wait state one request moves with its ids alone: no external task (it needs a lock first), no
+ * conditional event (it reacts to variables).
+ */
+export type ItemWait = Extract<WaitState, {
+    readonly kind: "userTask" | "timer" | "asyncContinuation" | "other";
+}> | (Extract<WaitState, {
+    readonly kind: "message" | "signal" | "conditional";
+}> & {
+    readonly kind: "message" | "signal";
+});
+/**
+ * A ready follow-up of an instance view, always by id (never by business key): retry its failed
+ * jobs and external tasks, activate a suspended instance, advance it (at one activity), move one
+ * item of a multi-instance activity, or inspect an ended instance with its history.
+ */
+export type NextStep = {
+    readonly action: "retry";
+    readonly processInstanceId: string;
+} | {
+    readonly action: "activate";
+    readonly processInstanceId: string;
+} | {
+    readonly action: "advance";
+    readonly processInstanceId: string;
+    readonly activityId?: string;
+} | ItemStep | {
+    readonly action: "inspectHistory";
+    readonly processInstanceId: string;
+};
+/** Moves one wait state with the request its ids are enough for. */
+export interface ItemStep {
+    readonly action: "move";
+    readonly wait: ItemWait;
+}
+/** How a process instance is selected: by id, or by business key and/or definition key. */
+export interface Selection {
+    readonly id?: string;
+    readonly businessKey?: string;
+    readonly processDefinitionKey?: string;
+    /** The most recently started instance that matches the filters. */
+    readonly latest: boolean;
+}
+/** A process instance that matches a selection. */
+export interface Candidate {
+    readonly id: string;
+    readonly key?: string;
+    readonly version?: number;
+    readonly businessKey?: string;
+    readonly state: string;
+    readonly startTime?: string;
+}
+/** A typed variable value as the engine takes it. */
+export interface TypedValue {
+    readonly value: unknown;
+    readonly type: string;
+}
+/** What moving a wait state carries; every option applies to some wait kinds only. */
+export interface AdvanceInput {
+    readonly activityId?: string;
+    readonly variables?: Readonly<Record<string, TypedValue>>;
+    readonly localVariables?: Readonly<Record<string, TypedValue>>;
+    readonly bpmnError?: string;
+    readonly errorMessage?: string;
+    readonly fail?: string;
+    readonly retries?: number;
+    readonly workerId?: string;
+}
+/** An option of `AdvanceInput` other than the activity. */
+export type AdvanceOption = Exclude<keyof AdvanceInput, "activityId">;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Views of the workflow domain. Keys appear in the documented order, absent values are left out,
+ * empty lists are kept. Types only.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/util.d.ts

@@ -0,0 +1,26 @@
+/** Small helpers of the workflow domain. Pure. */
+type Defined<T> = {
+    [K in keyof T]: Exclude<T[K], undefined>;
+};
+/**
+ * Drops properties whose value is undefined. Needed with exactOptionalPropertyTypes, where an
+ * optional property must be absent rather than undefined.
+ */
+export declare function compact<T extends object>(value: T): Partial<Defined<T>>;
+/** `Omit` for each member of a union, as a rest pattern types it. */
+type Without<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+/**
+ * A copy of `value` without its property `key`; every other own property stays, an undefined value
+ * included. The rest pattern `{ [key]: _, ...rest }` without a binding that is never read.
+ */
+export declare function omit<T extends object, K extends keyof T & string>(value: T, key: K): Without<T, K>;
+/** True for plain JSON-like objects (not null, not arrays). */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Maps every item with `fn`, at most `limit` calls at a time, and resolves to the results in the
+ * order of the items (requests of one round of a workflow run like this). Rejects with the first
+ * failure; no item starts after it (calls already running finish on their own).
+ */
+export declare function mapLimit<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+export {};
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,KAAK,OAAO,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAAE,CAAA;AAE9D;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAIvE;AAED,qEAAqE;AACrE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAA;AAE/E;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAC/D,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,CAAC,GACL,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAEf;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EACjC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAiBd"}

package/dist/util.js

@@ -0,0 +1,44 @@
+/** Small helpers of the workflow domain. Pure. */
+/**
+ * Drops properties whose value is undefined. Needed with exactOptionalPropertyTypes, where an
+ * optional property must be absent rather than undefined.
+ */
+export function compact(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+/**
+ * A copy of `value` without its property `key`; every other own property stays, an undefined value
+ * included. The rest pattern `{ [key]: _, ...rest }` without a binding that is never read.
+ */
+export function omit(value, key) {
+    return Object.fromEntries(Object.entries(value).filter(([name]) => name !== key));
+}
+/** True for plain JSON-like objects (not null, not arrays). */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Maps every item with `fn`, at most `limit` calls at a time, and resolves to the results in the
+ * order of the items (requests of one round of a workflow run like this). Rejects with the first
+ * failure; no item starts after it (calls already running finish on their own).
+ */
+export async function mapLimit(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    let failed = false;
+    const worker = async () => {
+        while (!failed && next < items.length) {
+            const index = next++;
+            try {
+                results[index] = await fn(items[index], index);
+            }
+            catch (error) {
+                failed = true;
+                throw error;
+            }
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+    return results;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAIlD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAmB,KAAQ;IAChD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAC1C,CAAA;AAC1B,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,IAAI,CAClB,KAAQ,EACR,GAAM;IAEN,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAkB,CAAA;AACpG,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAmB,EACnB,KAAa,EACb,EAA0C;IAE1C,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1C,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,CAAC,MAAM,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;YACpB,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAM,EAAE,KAAK,CAAC,CAAA;YACrD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,IAAI,CAAA;gBACb,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IAChF,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/variable-writes.d.ts

@@ -0,0 +1,32 @@
+import type { TypedValue } from "./types.js";
+/**
+ * A variable in the engine's wire shape, the REST API's `VariableValueDto` (this package has no
+ * dependency, so it states the shape; the SDK's type accepts it as is).
+ */
+export interface EngineVariable {
+    value?: unknown;
+    type?: string | undefined;
+    valueInfo?: Record<string, unknown>;
+}
+/** A variable as a tool receives it (value, optional type + valueInfo). */
+export interface EngineVariableInput {
+    value?: unknown;
+    type?: string | undefined;
+    valueInfo?: Record<string, unknown> | undefined;
+}
+/** The serialization format an Object variable gets when none is given. */
+export declare const DEFAULT_OBJECT_FORMAT = "application/json";
+/**
+ * One variable in the engine's wire shape (`EngineVariable`, the SDK's `VariableValueDto`). Throws a
+ * `RangeError` naming the variable for a value the engine would refuse.
+ */
+export declare function toEngineVariable(name: string, input: EngineVariableInput): EngineVariable;
+/** {@link toEngineVariable} over a variables map; `undefined` stays `undefined`. */
+export declare function toEngineVariables(variables: Record<string, EngineVariableInput> | undefined): Record<string, EngineVariable> | undefined;
+/**
+ * A variable value given as text, typed by its form: `true`/`false` → Boolean, `null` → Null,
+ * integers → Integer (int32) or Long (int64, a BigInt beyond 2^53), plain decimals → Double,
+ * everything else (also an integer beyond int64, `01234`, `1e3`) → String.
+ */
+export declare function autoTypedValue(raw: string): TypedValue;
+//# sourceMappingURL=variable-writes.d.ts.map

package/dist/variable-writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-writes.d.ts","sourceRoot":"","sources":["../src/variable-writes.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAChD;AAED,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,qBAAqB,CAAA;AA8CvD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAQzF;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,SAAS,GACzD,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,SAAS,CAK5C;AAgBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAOtD"}

package/dist/variable-writes.js

@@ -0,0 +1,113 @@
+/**
+ * Variable writes. The engine REST layer types a variable value by its
+ * `type` and is strict about the wire shape:
+ *
+ * - `Json`, `Xml` (Spin) and `Object` are SERIALIZABLE types: the value must
+ *   be the serialized STRING (or null); a JSON object/array is a 400 "Must
+ *   provide 'null' or String value for value of SerializableValue type".
+ * - `Object` additionally needs `valueInfo.objectTypeName` (+ the
+ *   `serializationDataFormat`), or the engine finds no serializer.
+ * - `Date` parses only `yyyy-MM-dd'T'HH:mm:ss.SSS±HHMM` (see `dates.ts`).
+ *
+ * Every variable a tool writes goes through {@link toEngineVariable}, so a
+ * model (or a widget) may send a parsed JSON object, an ISO date or an Object
+ * without a format and still produce the one shape the engine accepts.
+ */
+import { toEngineDate } from "./dates.js";
+/** The serialization format an Object variable gets when none is given. */
+export const DEFAULT_OBJECT_FORMAT = "application/json";
+/**
+ * The engine resolves a type name with its FIRST letter lowercased
+ * (`Json` = `json`), so the rules below compare that form.
+ */
+function typeKey(type) {
+    return type ? type.charAt(0).toLowerCase() + type.slice(1) : "";
+}
+function invalid(name, message) {
+    throw new RangeError(`Variable "${name}": ${message}`);
+}
+function serialized(name, input) {
+    const { value } = input;
+    if (value === null || value === undefined || typeof value === "string")
+        return value;
+    if (typeKey(input.type) === "xml")
+        invalid(name, "an Xml value must be the XML document as a string");
+    return JSON.stringify(value);
+}
+function objectValueInfo(name, input) {
+    const info = input.valueInfo ?? {};
+    if (input.value !== null && input.value !== undefined) {
+        const typeName = info.objectTypeName;
+        if (typeof typeName !== "string" || typeName.length === 0) {
+            invalid(name, 'an Object value needs valueInfo.objectTypeName (the Java type, e.g. "java.util.HashMap")');
+        }
+    }
+    return { serializationDataFormat: DEFAULT_OBJECT_FORMAT, ...info };
+}
+function dateValue(name, value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value !== "string")
+        invalid(name, "a Date value must be an ISO 8601 string");
+    try {
+        return toEngineDate(value);
+    }
+    catch (error) {
+        return invalid(name, error.message);
+    }
+}
+/**
+ * One variable in the engine's wire shape (`EngineVariable`, the SDK's `VariableValueDto`). Throws a
+ * `RangeError` naming the variable for a value the engine would refuse.
+ */
+export function toEngineVariable(name, input) {
+    const key = typeKey(input.type);
+    const out = { value: input.value, type: input.type };
+    if (key === "json" || key === "xml" || key === "object")
+        out.value = serialized(name, input);
+    if (key === "date")
+        out.value = dateValue(name, input.value);
+    if (key === "object")
+        out.valueInfo = objectValueInfo(name, input);
+    else if (input.valueInfo)
+        out.valueInfo = input.valueInfo;
+    return out;
+}
+/** {@link toEngineVariable} over a variables map; `undefined` stays `undefined`. */
+export function toEngineVariables(variables) {
+    if (!variables)
+        return undefined;
+    return Object.fromEntries(Object.entries(variables).map(([name, input]) => [name, toEngineVariable(name, input)]));
+}
+const INT32 = { min: -(2 ** 31), max: 2 ** 31 - 1 };
+const INT64 = { min: -(2n ** 63n), max: 2n ** 63n - 1n };
+const INTEGER = /^-?(0|[1-9]\d*)$/;
+const DECIMAL = /^-?(0|[1-9]\d*)\.\d+$/;
+/** Integers: Integer (int32), else Long (exact, BigInt beyond 2^53), else beyond int64 a String. */
+function autoInteger(raw) {
+    const value = BigInt(raw);
+    if (value >= INT32.min && value <= INT32.max)
+        return { value: Number(value), type: "Integer" };
+    if (value < INT64.min || value > INT64.max)
+        return undefined;
+    const exact = value >= Number.MIN_SAFE_INTEGER && value <= Number.MAX_SAFE_INTEGER;
+    return { value: exact ? Number(value) : value, type: "Long" };
+}
+/**
+ * A variable value given as text, typed by its form: `true`/`false` → Boolean, `null` → Null,
+ * integers → Integer (int32) or Long (int64, a BigInt beyond 2^53), plain decimals → Double,
+ * everything else (also an integer beyond int64, `01234`, `1e3`) → String.
+ */
+export function autoTypedValue(raw) {
+    if (raw === "true" || raw === "false")
+        return { value: raw === "true", type: "Boolean" };
+    if (raw === "null")
+        return { value: null, type: "Null" };
+    const integer = INTEGER.test(raw) ? autoInteger(raw) : undefined;
+    if (integer !== undefined)
+        return integer;
+    if (DECIMAL.test(raw))
+        return { value: Number(raw), type: "Double" };
+    return { value: raw, type: "String" };
+}
+//# sourceMappingURL=variable-writes.js.map

package/dist/variable-writes.js.map

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

package/dist/variables.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Variables of the instance view: values fetched with `deserializeValues=false`;
+ * scalar types become their plain value, every other type keeps what writing it back needs. Pure.
+ */
+import { type Rec } from "./records.js";
+/**
+ * The query every variable read sends, runtime AND historic (`/history/variable-instance` takes
+ * the same flag). The engine's default `deserializeValues=true` deserializes every Object
+ * variable eagerly (one class missing on its classpath fails the WHOLE read with a 500) and
+ * renders Json variables as Jackson's view of the Spin node instead of their JSON. With `false`,
+ * Object/Json/Xml values come back as their serialized string + `valueInfo`, exactly the shape a
+ * variable write takes back.
+ */
+export declare const RAW_VARIABLES: {
+    readonly deserializeValues: false;
+};
+/**
+ * A variable map (`{name: {type, value, valueInfo}}`) with String, Boolean, Integer, Short, Long,
+ * Double and Null values flattened (Long stays exact), others as `{type, value, valueInfo?}`;
+ * sorted by name.
+ */
+export declare function plainVariables(map: unknown): Record<string, unknown>;
+/**
+ * The process scope rows of historic variable instances (`activityInstanceId` equal to the
+ * instance id) as a variable map.
+ */
+export declare function historicVariableMap(rows: readonly Rec[], instanceId: string): Rec;
+//# sourceMappingURL=variables.d.ts.map

package/dist/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../src/variables.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,GAAG,EAAgB,MAAM,cAAc,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;CAAwC,CAAA;AA6BlE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAUjF"}

package/dist/variables.js

@@ -0,0 +1,64 @@
+/**
+ * Variables of the instance view: values fetched with `deserializeValues=false`;
+ * scalar types become their plain value, every other type keeps what writing it back needs. Pure.
+ */
+import { isRecord } from "./util.js";
+import { records, str } from "./records.js";
+/**
+ * The query every variable read sends, runtime AND historic (`/history/variable-instance` takes
+ * the same flag). The engine's default `deserializeValues=true` deserializes every Object
+ * variable eagerly (one class missing on its classpath fails the WHOLE read with a 500) and
+ * renders Json variables as Jackson's view of the Spin node instead of their JSON. With `false`,
+ * Object/Json/Xml values come back as their serialized string + `valueInfo`, exactly the shape a
+ * variable write takes back.
+ */
+export const RAW_VARIABLES = { deserializeValues: false };
+const PLAIN_TYPES = new Set([
+    "string",
+    "boolean",
+    "integer",
+    "short",
+    "long",
+    "double",
+    "null",
+]);
+function isEmpty(value) {
+    return (value === undefined || value === null || (isRecord(value) && Object.keys(value).length === 0));
+}
+function plainValue(typed) {
+    if (!isRecord(typed))
+        return typed;
+    const type = typeof typed.type === "string" ? typed.type : "";
+    if (PLAIN_TYPES.has(type.toLowerCase()))
+        return typed.value ?? null;
+    return {
+        type,
+        value: typed.value ?? null,
+        ...(isEmpty(typed.valueInfo) ? {} : { valueInfo: typed.valueInfo }),
+    };
+}
+/**
+ * A variable map (`{name: {type, value, valueInfo}}`) with String, Boolean, Integer, Short, Long,
+ * Double and Null values flattened (Long stays exact), others as `{type, value, valueInfo?}`;
+ * sorted by name.
+ */
+export function plainVariables(map) {
+    if (!isRecord(map))
+        return {};
+    const names = Object.keys(map).sort((left, right) => (left < right ? -1 : 1));
+    return Object.fromEntries(names.map((name) => [name, plainValue(map[name])]));
+}
+/**
+ * The process scope rows of historic variable instances (`activityInstanceId` equal to the
+ * instance id) as a variable map.
+ */
+export function historicVariableMap(rows, instanceId) {
+    const scope = records(rows).filter((row) => str(row, "activityInstanceId") === instanceId);
+    return Object.fromEntries(scope.flatMap((row) => {
+        const name = str(row, "name");
+        return name === undefined
+            ? []
+            : [[name, { type: row.type, value: row.value, valueInfo: row.valueInfo }]];
+    }));
+}
+//# sourceMappingURL=variables.js.map

package/dist/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../src/variables.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAY,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAW,CAAA;AAElE,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IAC/C,QAAQ;IACR,SAAS;IACT,SAAS;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,MAAM;CACP,CAAC,CAAA;AAEF,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,CACL,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAC9F,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAClC,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7D,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,IAAI,IAAI,CAAA;IACnE,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;KACpE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7E,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoB,EAAE,UAAkB;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,KAAK,UAAU,CAAC,CAAA;IAC1F,OAAO,MAAM,CAAC,WAAW,CACvB,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC7B,OAAO,IAAI,KAAK,SAAS;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC9E,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/waits.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Where an instance tree waits: one wait state per user task, external task, job
+ * and message, signal or conditional event subscription, plus the leaf activity instances that
+ * wait for something else. Pure and independent of the order of the engine's lists.
+ */
+import type { InstanceData, WaitState } from "./types.js";
+/** The id of the wait state's resource: task, external task, job, subscription or execution. */
+export declare function waitId(wait: WaitState): string;
+/** Every wait state of the instance tree, sorted. */
+export declare function waitStates(data: InstanceData): WaitState[];
+//# sourceMappingURL=waits.d.ts.map

package/dist/waits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waits.d.ts","sourceRoot":"","sources":["../src/waits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAY,SAAS,EAAE,MAAM,YAAY,CAAA;AAmBnE,gGAAgG;AAChG,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAgB9C;AA2OD,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,EAAE,CAS1D"}