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

package/dist/port.js

@@ -0,0 +1,113 @@
+/**
+ * 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 { records } from "./records.js";
+/** Most parallel requests of one round. */
+export const PARALLEL = 8;
+const PAGE_SIZE = 500;
+/**
+ * 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 function isMissing(failure) {
+    const type = failure?.engineType;
+    return (failure?.status === 404 &&
+        type !== undefined &&
+        type !== "NotFoundException" &&
+        type !== "QueryParamException");
+}
+/** The query of a page of `list`. */
+export function pageQuery(query, first, size) {
+    return { ...query, firstResult: String(first), maxResults: String(size) };
+}
+/** Page size of the next page: one item more than `cap` in total tells whether more exist. */
+function pageSize(loaded, cap) {
+    return Math.min(PAGE_SIZE, cap + 1 - loaded);
+}
+/**
+ * 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 function createEnginePort(transport) {
+    const missing = (error) => isMissing(transport.failure(error));
+    return {
+        async json(operationId, input) {
+            return transport.json(await transport.send(operationId, input));
+        },
+        failure: (error) => transport.failure(error),
+        async find(operationId, input) {
+            try {
+                return transport.json(await transport.send(operationId, input));
+            }
+            catch (error) {
+                if (missing(error))
+                    return undefined;
+                throw error;
+            }
+        },
+        async list(operationId, query, cap = Number.POSITIVE_INFINITY) {
+            const items = [];
+            for (let size = pageSize(0, cap);; size = pageSize(items.length, cap)) {
+                const input = { pathArgs: [], query: pageQuery(query, items.length, size) };
+                const page = records(transport.json(await transport.send(operationId, input)));
+                for (const item of page)
+                    items.push(item);
+                // a page of a different size is the last one (shorter, or the engine ignored the paging)
+                if (page.length !== size || items.length > cap)
+                    break;
+            }
+            return { items: items.slice(0, cap), truncated: items.length > cap };
+        },
+        async text(operationId, pathArgs) {
+            try {
+                const text = transport.text(await transport.send(operationId, { pathArgs, query: {} }));
+                return text !== undefined && text.trim() !== "" ? text : undefined;
+            }
+            catch (error) {
+                if (missing(error))
+                    return undefined;
+                throw error;
+            }
+        },
+    };
+}
+/**
+ * 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 class Slots {
+    limit;
+    active = 0;
+    waiting = [];
+    constructor(limit = PARALLEL) {
+        this.limit = limit;
+    }
+    async acquire() {
+        if (this.active < this.limit) {
+            this.active += 1;
+            return;
+        }
+        await new Promise((resolve) => this.waiting.push(resolve));
+    }
+    release() {
+        const next = this.waiting.shift();
+        if (next === undefined)
+            this.active -= 1;
+        else
+            next();
+    }
+    /** Runs `fn` in a slot: waits for one, frees it when `fn` settles. */
+    async run(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+}
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

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

package/dist/records.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Typed reads of engine response objects (DTOs) and their order (timestamps read in dates.ts). The workflow commands
+ * never trust the shape of a response: a missing or mistyped property reads as undefined. Pure.
+ */
+/** An engine DTO. */
+export type Rec = Readonly<Record<string, unknown>>;
+/** The objects of a JSON array (anything else gives an empty list). */
+export declare function records(value: unknown): Rec[];
+/** A non-empty string property. */
+export declare function str(record: Rec | undefined, key: string): string | undefined;
+/** A string property, or an empty string when it is missing (identifiers the engine always sends). */
+export declare function field(record: Rec | undefined, key: string): string;
+/** A number property (also a BigInt of `parseJson`, as a number). */
+export declare function num(record: Rec | undefined, key: string): number | undefined;
+/** A number property, or 0 when it is missing (counts). */
+export declare function amount(record: Rec | undefined, key: string): number;
+/** True only for a boolean `true`. */
+export declare function yes(record: Rec | undefined, key: string): boolean;
+/** `count` of a `CountResultDto`, 0 when absent. */
+export declare function countOf(value: unknown): number;
+/** The key part of a process definition id (`order:3:1f2...` → `order`). */
+export declare function definitionKeyOf(definitionId: string | undefined): string | undefined;
+/** Ordinal string order, independent of the locale. */
+export declare function compareText(left: string, right: string): number;
+/** Order of optional timestamps: earlier first, missing ones last. */
+export declare function compareTime(left: string | undefined, right: string | undefined): number;
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAqB;AACrB,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEnD,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,EAAE,CAE7C;AAED,mCAAmC;AACnC,wBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED,sGAAsG;AACtG,wBAAgB,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,qEAAqE;AACrE,wBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI5E;AAED,2DAA2D;AAC3D,wBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,sCAAsC;AACtC,wBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE9C;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGpF;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKvF"}

package/dist/records.js

@@ -0,0 +1,58 @@
+/**
+ * Typed reads of engine response objects (DTOs) and their order (timestamps read in dates.ts). The workflow commands
+ * never trust the shape of a response: a missing or mistyped property reads as undefined. Pure.
+ */
+import { engineTime } from "./dates.js";
+import { isRecord } from "./util.js";
+/** The objects of a JSON array (anything else gives an empty list). */
+export function records(value) {
+    return Array.isArray(value) ? value.filter(isRecord) : [];
+}
+/** A non-empty string property. */
+export function str(record, key) {
+    const value = record?.[key];
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+/** A string property, or an empty string when it is missing (identifiers the engine always sends). */
+export function field(record, key) {
+    return str(record, key) ?? "";
+}
+/** A number property (also a BigInt of `parseJson`, as a number). */
+export function num(record, key) {
+    const value = record?.[key];
+    if (typeof value === "bigint")
+        return Number(value);
+    return typeof value === "number" ? value : undefined;
+}
+/** A number property, or 0 when it is missing (counts). */
+export function amount(record, key) {
+    return num(record, key) ?? 0;
+}
+/** True only for a boolean `true`. */
+export function yes(record, key) {
+    return record?.[key] === true;
+}
+/** `count` of a `CountResultDto`, 0 when absent. */
+export function countOf(value) {
+    return isRecord(value) ? amount(value, "count") : 0;
+}
+/** The key part of a process definition id (`order:3:1f2...` → `order`). */
+export function definitionKeyOf(definitionId) {
+    const key = definitionId?.split(":")[0] ?? "";
+    return key === "" ? undefined : key;
+}
+/** Ordinal string order, independent of the locale. */
+export function compareText(left, right) {
+    if (left < right)
+        return -1;
+    return left > right ? 1 : 0;
+}
+/** Order of optional timestamps: earlier first, missing ones last. */
+export function compareTime(left, right) {
+    const a = engineTime(left) ?? Number.POSITIVE_INFINITY;
+    const b = engineTime(right) ?? Number.POSITIVE_INFINITY;
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=records.js.map

package/dist/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAKpC,uEAAuE;AACvE,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC1E,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,GAAG,CAAC,MAAuB,EAAE,GAAW;IACtD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;IAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACtE,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,KAAK,CAAC,MAAuB,EAAE,GAAW;IACxD,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAA;AAC/B,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,GAAG,CAAC,MAAuB,EAAE,GAAW;IACtD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACtD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,MAAM,CAAC,MAAuB,EAAE,GAAW;IACzD,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,GAAG,CAAC,MAAuB,EAAE,GAAW;IACtD,OAAO,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;AAC/B,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,YAAgC;IAC9D,MAAM,GAAG,GAAG,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7C,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA;AACrC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAa;IACrD,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC,CAAA;IAC3B,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,IAAwB,EAAE,KAAyB;IAC7E,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAA;IACtD,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAA;IACvD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACrB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACvB,CAAC"}

package/dist/requests.d.ts

@@ -0,0 +1,24 @@
+/** Requests over id lists: chunks of 50 ids, at most `PARALLEL` at a time. */
+import { type EnginePort, type OperationInput, type Query } from "./port.js";
+import { type Rec } from "./records.js";
+/** Ids per request of a query parameter that takes a comma separated list (URL length). */
+export declare const ID_CHUNK = 50;
+/** A request without path arguments. */
+export declare function queryInput(query: Query): OperationInput;
+/** A list or count request over an id list (`processInstanceIds`, ...): `key` takes the ids. */
+export interface IdRequest {
+    readonly operationId: string;
+    readonly key: string;
+    readonly ids: readonly string[];
+    readonly query?: Query;
+    /** Items per chunk at most (lists only). */
+    readonly cap?: number;
+}
+/**
+ * The summed `count` of a count operation over an id list, sent in chunks of 50 ids; no ids give
+ * 0 without a request.
+ */
+export declare function countByIds(port: EnginePort, request: IdRequest): Promise<number>;
+/** The items of a list operation over an id list, chunked like `countByIds` and concatenated. */
+export declare function listByIds(port: EnginePort, request: IdRequest): Promise<Rec[]>;
+//# sourceMappingURL=requests.d.ts.map

package/dist/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../src/requests.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAY,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AACtF,OAAO,EAAW,KAAK,GAAG,EAAE,MAAM,cAAc,CAAA;AAGhD,2FAA2F;AAC3F,eAAO,MAAM,QAAQ,KAAK,CAAA;AAE1B,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,CAEvD;AAWD,gGAAgG;AAChG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAMtF;AAED,iGAAiG;AACjG,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAKpF"}

package/dist/requests.js

@@ -0,0 +1,35 @@
+/** Requests over id lists: chunks of 50 ids, at most `PARALLEL` at a time. */
+import { PARALLEL } from "./port.js";
+import { countOf } from "./records.js";
+import { mapLimit } from "./util.js";
+/** Ids per request of a query parameter that takes a comma separated list (URL length). */
+export const ID_CHUNK = 50;
+/** A request without path arguments. */
+export function queryInput(query) {
+    return { pathArgs: [], query };
+}
+/** `ids` in chunks of `ID_CHUNK`, each joined with commas. */
+function idChunks(ids) {
+    const chunks = [];
+    for (let start = 0; start < ids.length; start += ID_CHUNK) {
+        chunks.push(ids.slice(start, start + ID_CHUNK).join(","));
+    }
+    return chunks;
+}
+/**
+ * The summed `count` of a count operation over an id list, sent in chunks of 50 ids; no ids give
+ * 0 without a request.
+ */
+export async function countByIds(port, request) {
+    const counts = await mapLimit(idChunks(request.ids), PARALLEL, async (chunk) => {
+        const query = { ...request.query, [request.key]: chunk };
+        return countOf(await port.json(request.operationId, queryInput(query)));
+    });
+    return counts.reduce((sum, count) => sum + count, 0);
+}
+/** The items of a list operation over an id list, chunked like `countByIds` and concatenated. */
+export async function listByIds(port, request) {
+    const pages = await mapLimit(idChunks(request.ids), PARALLEL, async (chunk) => port.list(request.operationId, { ...request.query, [request.key]: chunk }, request.cap));
+    return pages.flatMap((page) => page.items);
+}
+//# sourceMappingURL=requests.js.map

package/dist/requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../src/requests.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAwC,QAAQ,EAAc,MAAM,WAAW,CAAA;AACtF,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAA;AAE1B,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;AAChC,CAAC;AAED,8DAA8D;AAC9D,SAAS,QAAQ,CAAC,GAAsB;IACtC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAYD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB,EAAE,OAAkB;IACnE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7E,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAA;QACxD,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAgB,EAAE,OAAkB;IAClE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC5E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,CACxF,CAAA;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC5C,CAAC"}

package/dist/retry-plan.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Planning of retry: the selection mode, the root cause incidents to retry and the requests per
+ * incident type. Pure.
+ */
+import type { PlannedWrite } from "./port.js";
+import { type Rec } from "./records.js";
+import type { Selection } from "./types.js";
+export type RetryMode = "instance" | "incidents" | "definition";
+/** The selection mode: exactly one of instance, incidents and definition. */
+export declare function retryMode(selection: Selection, incidentIds: readonly string[]): RetryMode;
+/** Retrying every incident of a definition is a bulk operation. */
+export declare function retryEffect(mode: RetryMode): "write" | "bulk";
+/** A root cause incident and what retry does about it. */
+export interface PlanEntry {
+    readonly incidentId: string;
+    readonly type: string;
+    readonly activityId: string;
+    readonly processInstanceId: string;
+    readonly message?: string;
+    readonly jobId?: string;
+    readonly externalTaskId?: string;
+    /** `job`, `externalTask`, or `skip` for incident types retry cannot fix. */
+    readonly action: "job" | "externalTask" | "skip";
+}
+/** Root cause ids of propagated incidents that were not loaded. */
+export declare function missingRoots(incidents: readonly Rec[]): string[];
+export interface RetryFilter {
+    readonly activityId?: string;
+    readonly incidentType?: string;
+}
+/**
+ * The root causes of the incidents (propagated ones replaced by their loaded root cause,
+ * deduplicated), filtered by activity and type, by time and id.
+ */
+export declare function planRetry(incidents: readonly Rec[], filter: RetryFilter): PlanEntry[];
+/** Too many incidents to retry one by one: refused before any write. */
+export declare function checkRetryCount(entries: readonly PlanEntry[], truncated: boolean, key: string | undefined): void;
+/** The retries request of an entry; undefined for skipped ones. */
+export declare function retriesWrite(entry: PlanEntry, retries: number): PlannedWrite | undefined;
+/** The execute request of a job entry (retry now). */
+export declare function executeWrite(entry: PlanEntry): PlannedWrite | undefined;
+/** What to do about an incident retry cannot fix: resolve it. */
+export interface SkipStep {
+    readonly action: "resolveIncident";
+    readonly incidentId: string;
+}
+/** The plan a preview shows: counts per kind and the skipped incidents. */
+export declare function retryPlanView(mode: RetryMode, entries: readonly PlanEntry[]): {
+    mode: RetryMode;
+    incidents: number;
+    jobs: number;
+    externalTasks: number;
+    skipped: {
+        incidentId: string;
+        type: string;
+        next: {
+            action: "resolveIncident";
+            incidentId: string;
+        };
+    }[];
+};
+//# sourceMappingURL=retry-plan.d.ts.map

package/dist/retry-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-plan.d.ts","sourceRoot":"","sources":["../src/retry-plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAmC,KAAK,GAAG,EAAO,MAAM,cAAc,CAAA;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAG3C,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAA;AAK/D,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAYzF;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAE7D;AAED,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,cAAc,GAAG,MAAM,CAAA;CACjD;AAMD,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,CAMhE;AAgCD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,CAsBrF;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,SAAS,EAAE,OAAO,EAClB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,IAAI,CAQN;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAexF;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAOvE;AAED,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,SAAS,EAAE;;;;;;;;;;;;;EAa3E"}

package/dist/retry-plan.js

@@ -0,0 +1,140 @@
+/**
+ * Planning of retry: the selection mode, the root cause incidents to retry and the requests per
+ * incident type. Pure.
+ */
+import { WorkflowError } from "./errors.js";
+import { incidentRecovery } from "./incident-recovery.js";
+import { compareText, compareTime, field, str } from "./records.js";
+import { compact } from "./util.js";
+/** More retryable incidents than this are pointed to the asynchronous bulk operations. */
+const MAX_RETRIES = 1000;
+/** The selection mode: exactly one of instance, incidents and definition. */
+export function retryMode(selection, incidentIds) {
+    const instance = selection.id !== undefined || selection.businessKey !== undefined || selection.latest;
+    if (incidentIds.length > 0) {
+        if (instance || selection.processDefinitionKey !== undefined) {
+            throw new WorkflowError({ kind: "retry-selection-conflict" });
+        }
+        return "incidents";
+    }
+    if (instance)
+        return "instance";
+    if (selection.processDefinitionKey !== undefined)
+        return "definition";
+    throw new WorkflowError({ kind: "retry-selection-missing" });
+}
+/** Retrying every incident of a definition is a bulk operation. */
+export function retryEffect(mode) {
+    return mode === "definition" ? "bulk" : "write";
+}
+function isRoot(incident) {
+    return str(incident, "id") === str(incident, "rootCauseIncidentId");
+}
+/** Root cause ids of propagated incidents that were not loaded. */
+export function missingRoots(incidents) {
+    const loaded = new Set(incidents.map((incident) => str(incident, "id")));
+    const roots = incidents.flatMap((incident) => isRoot(incident) ? [] : (str(incident, "rootCauseIncidentId") ?? []));
+    return [...new Set(roots)].filter((id) => !loaded.has(id)).sort(compareText);
+}
+/** The plan's action per recovery: retry fixes only what a retry clears. */
+const ACTIONS = {
+    "retry-job": "job",
+    "retry-external-task": "externalTask",
+    resolve: "skip",
+    none: "skip",
+};
+function actionOf(type, configuration) {
+    return ACTIONS[incidentRecovery({ incidentType: type, configuration }).action];
+}
+function entryOf(incident) {
+    const type = field(incident, "incidentType");
+    const configuration = str(incident, "configuration");
+    const action = actionOf(type, configuration);
+    return {
+        incidentId: field(incident, "id"),
+        type,
+        activityId: field(incident, "activityId"),
+        processInstanceId: field(incident, "processInstanceId"),
+        ...compact({
+            message: str(incident, "incidentMessage"),
+            jobId: action === "job" ? configuration : undefined,
+            externalTaskId: action === "externalTask" ? configuration : undefined,
+        }),
+        action,
+    };
+}
+/**
+ * The root causes of the incidents (propagated ones replaced by their loaded root cause,
+ * deduplicated), filtered by activity and type, by time and id.
+ */
+export function planRetry(incidents, filter) {
+    const byId = new Map(incidents.map((incident) => [str(incident, "id"), incident]));
+    const roots = new Map();
+    for (const incident of incidents) {
+        const root = isRoot(incident) ? incident : byId.get(str(incident, "rootCauseIncidentId"));
+        const id = str(root, "id");
+        if (root !== undefined && id !== undefined && isRoot(root))
+            roots.set(id, root);
+    }
+    return [...roots.values()]
+        .filter((root) => filter.activityId === undefined || str(root, "activityId") === filter.activityId)
+        .filter((root) => filter.incidentType === undefined || str(root, "incidentType") === filter.incidentType)
+        .toSorted((left, right) => compareTime(str(left, "incidentTimestamp"), str(right, "incidentTimestamp")) ||
+        compareText(field(left, "id"), field(right, "id")))
+        .map(entryOf);
+}
+/** Too many incidents to retry one by one: refused before any write. */
+export function checkRetryCount(entries, truncated, key) {
+    const retryable = entries.filter((entry) => entry.action !== "skip").length;
+    if (!truncated && retryable <= MAX_RETRIES)
+        return;
+    throw new WorkflowError({
+        kind: "retry-too-many",
+        max: MAX_RETRIES,
+        ...compact({ processDefinitionKey: key }),
+    });
+}
+/** The retries request of an entry; undefined for skipped ones. */
+export function retriesWrite(entry, retries) {
+    const body = { retries };
+    if (entry.jobId !== undefined) {
+        return {
+            label: `set the retries of job ${entry.jobId} to ${retries}`,
+            operationId: "setJobRetries",
+            input: { pathArgs: [entry.jobId], query: {}, body },
+        };
+    }
+    if (entry.externalTaskId === undefined)
+        return undefined;
+    return {
+        label: `set the retries of external task ${entry.externalTaskId} to ${retries}`,
+        operationId: "setExternalTaskResourceRetries",
+        input: { pathArgs: [entry.externalTaskId], query: {}, body },
+    };
+}
+/** The execute request of a job entry (retry now). */
+export function executeWrite(entry) {
+    if (entry.jobId === undefined)
+        return undefined;
+    return {
+        label: `execute job ${entry.jobId}`,
+        operationId: "executeJob",
+        input: { pathArgs: [entry.jobId], query: {} },
+    };
+}
+/** The plan a preview shows: counts per kind and the skipped incidents. */
+export function retryPlanView(mode, entries) {
+    const skipped = entries.filter((entry) => entry.action === "skip");
+    return {
+        mode,
+        incidents: entries.length,
+        jobs: entries.filter((entry) => entry.action === "job").length,
+        externalTasks: entries.filter((entry) => entry.action === "externalTask").length,
+        skipped: skipped.map((entry) => ({
+            incidentId: entry.incidentId,
+            type: entry.type,
+            next: { action: "resolveIncident", incidentId: entry.incidentId },
+        })),
+    };
+}
+//# sourceMappingURL=retry-plan.js.map

package/dist/retry-plan.js.map

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

package/dist/root-cause.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The root cause of a failure: one line out of a Java stacktrace or an external
+ * task's error details. Pure.
+ */
+/**
+ * The last `Caused by: ` line (prefix removed), else the first non-blank line; a leading
+ * qualified class name shortened to its simple name; whitespace collapsed; at most 300
+ * characters. Undefined for a blank text.
+ */
+export declare function rootCause(text: string): string | undefined;
+/**
+ * The index of the last `Caused by: ` line (the line {@link rootCause} takes its cause from), in
+ * the lines of `text` split at CRLF, LF and CR; undefined without one. A viewer opens the text
+ * there.
+ */
+export declare function rootCauseLine(text: string): number | undefined;
+//# sourceMappingURL=root-cause.d.ts.map

package/dist/root-cause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-cause.d.ts","sourceRoot":"","sources":["../src/root-cause.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D"}

package/dist/root-cause.js

@@ -0,0 +1,35 @@
+/**
+ * The root cause of a failure: one line out of a Java stacktrace or an external
+ * task's error details. Pure.
+ */
+const CAUSED_BY = "Caused by: ";
+const MAX_LENGTH = 300;
+/** A leading qualified Java class name: `org.camunda.bpm.engine.ProcessEngineException`. */
+const QUALIFIED_CLASS = /^(?:[a-z_$][\w$]*\.)+([A-Z][\w$]*)(?=:|\s|$)/;
+/**
+ * The last `Caused by: ` line (prefix removed), else the first non-blank line; a leading
+ * qualified class name shortened to its simple name; whitespace collapsed; at most 300
+ * characters. Undefined for a blank text.
+ */
+export function rootCause(text) {
+    const lines = linesOf(text);
+    const caused = lines.filter((line) => line.startsWith(CAUSED_BY)).at(-1);
+    const line = caused?.slice(CAUSED_BY.length) ?? lines.find((candidate) => candidate !== "");
+    if (line === undefined)
+        return undefined;
+    const simple = line.replace(QUALIFIED_CLASS, "$1").replace(/\s+/g, " ").trim();
+    return simple.length > MAX_LENGTH ? `${simple.slice(0, MAX_LENGTH - 1)}…` : simple;
+}
+/**
+ * The index of the last `Caused by: ` line (the line {@link rootCause} takes its cause from), in
+ * the lines of `text` split at CRLF, LF and CR; undefined without one. A viewer opens the text
+ * there.
+ */
+export function rootCauseLine(text) {
+    const index = linesOf(text).findLastIndex((line) => line.startsWith(CAUSED_BY));
+    return index === -1 ? undefined : index;
+}
+function linesOf(text) {
+    return text.split(/\r\n|[\n\r]/).map((line) => line.trim());
+}
+//# sourceMappingURL=root-cause.js.map

package/dist/root-cause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-cause.js","sourceRoot":"","sources":["../src/root-cause.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,SAAS,GAAG,aAAa,CAAA;AAC/B,MAAM,UAAU,GAAG,GAAG,CAAA;AAEtB,4FAA4F;AAC5F,MAAM,eAAe,GAAG,8CAA8C,CAAA;AAEtE;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACxE,MAAM,IAAI,GAAG,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,CAAA;IAC3F,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9E,OAAO,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;IAC/E,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;AACzC,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;AAC7D,CAAC"}

package/dist/select.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Instance selection: a process instance id, or a business key and/or a process definition key
+ * (with `latest`) resolved against history and runtime.
+ */
+import type { EnginePort, PlannedRequest } from "./port.js";
+import { type Rec } from "./records.js";
+import type { Candidate, Selection } from "./types.js";
+/** The rules of a selection; nothing is sent before this passed. */
+export declare function checkSelection(selection: Selection): void;
+/** The requests that resolve the filters (history, runtime); none for an id. */
+export declare function selectionRequests(selection: Selection): PlannedRequest[];
+/** Merged by id (history first), active before ended, then the most recently started first. */
+export declare function mergeCandidates(history: readonly Rec[], runtime: readonly Rec[]): Candidate[];
+/** The id of the selected instance; filters are resolved in parallel against history and runtime. */
+export declare function selectInstance(port: EnginePort, selection: Selection): Promise<string>;
+//# sourceMappingURL=select.d.ts.map

package/dist/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAAqC,KAAK,GAAG,EAAqB,MAAM,cAAc,CAAA;AAG7F,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAStD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CASzD;AA0BD,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,EAAE,CAExE;AAqCD,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,GAAG,EAAE,GAAG,SAAS,EAAE,CAW7F;AAYD,qGAAqG;AACrG,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5F"}