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

package/dist/filters.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Query filters. Two engine behaviours turn a plausible filter into a silent
+ * no-op, so the tools never forward a filter value as given:
+ *
+ * - Boolean filters are TRUE-ONLY: `true` narrows the result, `false` is
+ *   IGNORED (HTTP 200, no filter): neither a negation nor a 400. A forwarded
+ *   `suspended=false` would return the suspended instances to a caller who
+ *   asked for the opposite. Flags go out only when `true`; where the engine
+ *   has the complementary flag (active/suspended, finished/unfinished, …), a
+ *   `false` is sent as `true` on the other side instead.
+ * - `…Like` filters are SQL LIKE patterns: without a `%` they match the whole
+ *   value exactly, so "substring" search silently became an exact match.
+ */
+/** A true-only engine flag: `true` stays, `false`/absent is not sent at all. */
+export declare function trueOnly(flag: boolean | undefined): true | undefined;
+/**
+ * Two complementary true-only flags, e.g. `active`/`suspended`: each is sent
+ * when it is `true` OR its complement is `false`.
+ *
+ * A pair that asks for both states or neither (`true`/`true`,
+ * `false`/`false`) throws a RangeError (a tool error). The engine has no
+ * honest answer to it: active/suspended (process instances, jobs) and
+ * withRetriesLeft/noRetriesLeft (external tasks) set ONE query field, so the
+ * engine keeps the flag it applies last and returns one state as if it were
+ * the filtered result; the separate-field pairs return nothing.
+ */
+export declare function complementaryFlags<A extends string, B extends string>(flags: Partial<Record<A | B, boolean>>, first: A, second: B): Partial<Record<A | B, true>>;
+/**
+ * A `…Like` filter value: wrapped in `%` (a substring match) unless the
+ * caller already placed a wildcard; empty/absent sends nothing.
+ */
+export declare function engineLike(value: string | undefined): string | undefined;
+/**
+ * A comma-list `…In` filter from single and list inputs (`processDefinitionKey`
+ * + `processDefinitionKeyIn`), de-duplicated; nothing sent when both are empty.
+ */
+export declare function engineKeyList(...parts: (string | readonly string[] | undefined)[]): string | undefined;
+/**
+ * A search box over process instances, matching what a list names an instance
+ * by: its business key as a substring OR its whole id. The engine has no LIKE
+ * on ids (`processInstanceIds` matches whole ids only), so a pasted id is
+ * found and a fragment of one is not. Sent as ONE nested OR query of the POST
+ * `/process-instance` (and `/count`) body, which the engine ANDs with the
+ * other filters; a blank term sends nothing. The term is trimmed: a pasted
+ * id with a trailing space would match nothing.
+ */
+export declare function engineInstanceSearch(term: string | undefined): {
+    orQueries?: {
+        businessKeyLike: string;
+        processInstanceIds: string[];
+    }[];
+};
+//# sourceMappingURL=filters.d.ts.map

package/dist/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACnE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,EACtC,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAU9B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,sBAGjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG;IAC9D,SAAS,CAAC,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;CACxE,CAMA"}

package/dist/filters.js

@@ -0,0 +1,74 @@
+/**
+ * Query filters. Two engine behaviours turn a plausible filter into a silent
+ * no-op, so the tools never forward a filter value as given:
+ *
+ * - Boolean filters are TRUE-ONLY: `true` narrows the result, `false` is
+ *   IGNORED (HTTP 200, no filter): neither a negation nor a 400. A forwarded
+ *   `suspended=false` would return the suspended instances to a caller who
+ *   asked for the opposite. Flags go out only when `true`; where the engine
+ *   has the complementary flag (active/suspended, finished/unfinished, …), a
+ *   `false` is sent as `true` on the other side instead.
+ * - `…Like` filters are SQL LIKE patterns: without a `%` they match the whole
+ *   value exactly, so "substring" search silently became an exact match.
+ */
+/** A true-only engine flag: `true` stays, `false`/absent is not sent at all. */
+export function trueOnly(flag) {
+    return flag === true ? true : undefined;
+}
+/**
+ * Two complementary true-only flags, e.g. `active`/`suspended`: each is sent
+ * when it is `true` OR its complement is `false`.
+ *
+ * A pair that asks for both states or neither (`true`/`true`,
+ * `false`/`false`) throws a RangeError (a tool error). The engine has no
+ * honest answer to it: active/suspended (process instances, jobs) and
+ * withRetriesLeft/noRetriesLeft (external tasks) set ONE query field, so the
+ * engine keeps the flag it applies last and returns one state as if it were
+ * the filtered result; the separate-field pairs return nothing.
+ */
+export function complementaryFlags(flags, first, second) {
+    const wanted = {};
+    if (flags[first] === true || flags[second] === false)
+        wanted[first] = true;
+    if (flags[second] === true || flags[first] === false)
+        wanted[second] = true;
+    if (wanted[first] && wanted[second]) {
+        throw new RangeError(`${first}: ${flags[first]} and ${second}: ${flags[second]} contradict each other — pass one of them (false selects the other state), or neither for both states.`);
+    }
+    return wanted;
+}
+/**
+ * A `…Like` filter value: wrapped in `%` (a substring match) unless the
+ * caller already placed a wildcard; empty/absent sends nothing.
+ */
+export function engineLike(value) {
+    if (!value)
+        return undefined;
+    return value.includes("%") ? value : `%${value}%`;
+}
+/**
+ * A comma-list `…In` filter from single and list inputs (`processDefinitionKey`
+ * + `processDefinitionKeyIn`), de-duplicated; nothing sent when both are empty.
+ */
+export function engineKeyList(...parts) {
+    const values = [...new Set(parts.flat().filter((value) => !!value))];
+    return values.length > 0 ? values.join(",") : undefined;
+}
+/**
+ * A search box over process instances, matching what a list names an instance
+ * by: its business key as a substring OR its whole id. The engine has no LIKE
+ * on ids (`processInstanceIds` matches whole ids only), so a pasted id is
+ * found and a fragment of one is not. Sent as ONE nested OR query of the POST
+ * `/process-instance` (and `/count`) body, which the engine ANDs with the
+ * other filters; a blank term sends nothing. The term is trimmed: a pasted
+ * id with a trailing space would match nothing.
+ */
+export function engineInstanceSearch(term) {
+    const value = term?.trim();
+    if (!value)
+        return {};
+    return {
+        orQueries: [{ businessKeyLike: engineLike(value) ?? value, processInstanceIds: [value] }],
+    };
+}
+//# sourceMappingURL=filters.js.map

package/dist/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,IAAyB;IAChD,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAsC,EACtC,KAAQ,EACR,MAAS;IAET,MAAM,MAAM,GAAiC,EAAE,CAAA;IAC/C,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK;QAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAC1E,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC3E,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAClB,GAAG,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,QAAQ,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,wGAAwG,CAClK,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAA;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAG,KAAiD;IAChF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACrF,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACzD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAG3D,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,CAAA;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,OAAO;QACL,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,EAAE,kBAAkB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;KAC1F,CAAA;AACH,CAAC"}

package/dist/findings.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The findings of the status triage: pure rules over the aggregated status, each naming its next
+ * step, and the overall status (the highest severity, else `ok`).
+ */
+import { type Rec } from "./records.js";
+import type { GroupStep, IncidentGroup, JobStatus, TopicStatus } from "./status.js";
+export type Severity = "warning" | "critical";
+export type EngineStatus = "ok" | Severity;
+/**
+ * What to look at for a finding: the step of its incident group, the overdue jobs, the unlocked
+ * tasks or the expired locks of a topic, the deployed definitions.
+ */
+export type FindingStep = GroupStep | {
+    readonly action: "listOverdueJobs";
+} | {
+    readonly action: "listUnlockedTasks";
+    readonly topic: string;
+} | {
+    readonly action: "listExpiredLocks";
+    readonly topic: string;
+} | {
+    readonly action: "listDefinitions";
+};
+/** `N`: the next step, structured (`FindingStep`) or the text a caller renders from it. */
+export interface Finding<N = FindingStep> {
+    readonly severity: Severity;
+    readonly code: string;
+    readonly message: string;
+    readonly next: N;
+}
+export interface FindingInput {
+    readonly jobs: JobStatus;
+    /** The incident groups shown; their findings carry the group's next step on. */
+    readonly incidents: readonly IncidentGroup[];
+    readonly externalTasks: readonly TopicStatus[];
+    readonly batches: readonly Rec[];
+    /** Named process definition keys without a deployed definition. */
+    readonly unknownKeys?: readonly string[];
+    readonly staleAfterMs: number;
+    readonly now: number;
+}
+/** Every finding, critical first, then by code and message; incident findings carry their group's step. */
+export declare function findings(input: FindingInput): Finding[];
+/** The highest severity of the findings, else `ok`. */
+export declare function engineStatus(list: readonly Pick<Finding<unknown>, "severity">[]): EngineStatus;
+//# sourceMappingURL=findings.d.ts.map

package/dist/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAA8B,KAAK,GAAG,EAAO,MAAM,cAAc,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGnF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;AAC7C,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,QAAQ,CAAA;AAE1C;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT;IAAE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GACtC;IAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAE1C,2FAA2F;AAC3F,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,WAAW;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAA;IAC5C,QAAQ,CAAC,aAAa,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,CAAA;IAChC,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAwFD,2GAA2G;AAC3G,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,EAAE,CAavD;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,YAAY,CAE9F"}

package/dist/findings.js

@@ -0,0 +1,105 @@
+/**
+ * The findings of the status triage: pure rules over the aggregated status, each naming its next
+ * step, and the overall status (the highest severity, else `ok`).
+ */
+import { formatDuration } from "./durations.js";
+import { engineTime } from "./dates.js";
+import { amount, compareText, field, str } from "./records.js";
+import { compact } from "./util.js";
+function plural(count, word) {
+    return `${count} ${word}${count === 1 ? "" : "s"}`;
+}
+function overdueJobs(input) {
+    const { overdue, oldestReadySince } = input.jobs;
+    if (overdue === 0)
+        return [];
+    const since = oldestReadySince === undefined ? "" : ` (oldest since ${oldestReadySince})`;
+    return [
+        {
+            severity: "critical",
+            code: "JOBS_OVERDUE",
+            message: `${plural(overdue, "executable job")} ${overdue === 1 ? "has" : "have"} waited longer than ${formatDuration(input.staleAfterMs)}${since}: is the job executor running?`,
+            next: { action: "listOverdueJobs" },
+        },
+    ];
+}
+function where(group) {
+    return group.processDefinitionKey === ""
+        ? `job definition ${group.jobDefinitionId ?? "(unknown)"}`
+        : `${group.processDefinitionKey}/${group.activityId}`;
+}
+function incidentFindings(input) {
+    return input.incidents.map((group) => ({
+        severity: "warning",
+        code: "INCIDENTS",
+        message: `${plural(group.count, `${group.type} incident`)} at ${where(group)}: ${group.rootCause ?? group.message}`,
+        next: group.next,
+    }));
+}
+function workerFindings(input) {
+    const threshold = input.now - input.staleAfterMs;
+    return input.externalTasks.flatMap((topic) => {
+        const findings = [];
+        const oldest = engineTime(topic.oldestWaitingSince);
+        if (topic.waiting > 0 && topic.locked === 0 && oldest !== undefined && oldest < threshold) {
+            findings.push({
+                severity: "warning",
+                code: "NO_WORKER",
+                message: `topic ${topic.topic}: ${plural(topic.waiting, "task")} wait since ${topic.oldestWaitingSince ?? ""}, none is locked: is a worker subscribed?`,
+                next: { action: "listUnlockedTasks", topic: topic.topic },
+            });
+        }
+        const expired = engineTime(topic.oldestLockExpiredAt);
+        if (topic.lockExpired > 0 && expired !== undefined && expired < threshold) {
+            findings.push({
+                severity: "warning",
+                code: "LOCK_EXPIRED",
+                message: `topic ${topic.topic}: ${plural(topic.lockExpired, "task")} with an expired lock (the oldest since ${topic.oldestLockExpiredAt ?? ""}): a worker crashed or exceeded its lock`,
+                next: { action: "listExpiredLocks", topic: topic.topic },
+            });
+        }
+        return findings;
+    });
+}
+function batchFindings(input) {
+    return input.batches.flatMap((batch) => {
+        const failed = amount(batch, "failedJobs");
+        if (failed === 0)
+            return [];
+        const jobDefinitionId = str(batch, "batchJobDefinitionId");
+        return [
+            {
+                severity: "warning",
+                code: "BATCH_FAILURES",
+                message: `batch ${field(batch, "id")} (${field(batch, "type")}): ${plural(failed, "failed job")}`,
+                next: { action: "listFailedJobs", ...compact({ jobDefinitionId }) },
+            },
+        ];
+    });
+}
+function keyFindings(input) {
+    return (input.unknownKeys ?? []).map((key) => ({
+        severity: "warning",
+        code: "UNKNOWN_KEY",
+        message: `process definition key ${key} is not deployed`,
+        next: { action: "listDefinitions" },
+    }));
+}
+const SEVERITY_ORDER = ["critical", "warning"];
+/** Every finding, critical first, then by code and message; incident findings carry their group's step. */
+export function findings(input) {
+    return [
+        ...overdueJobs(input),
+        ...incidentFindings(input),
+        ...workerFindings(input),
+        ...batchFindings(input),
+        ...keyFindings(input),
+    ].toSorted((left, right) => SEVERITY_ORDER.indexOf(left.severity) - SEVERITY_ORDER.indexOf(right.severity) ||
+        compareText(left.code, right.code) ||
+        compareText(left.message, right.message));
+}
+/** The highest severity of the findings, else `ok`. */
+export function engineStatus(list) {
+    return list[0]?.severity ?? "ok";
+}
+//# sourceMappingURL=findings.js.map

package/dist/findings.js.map

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

package/dist/incident-recovery.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Incident recovery. `DELETE /incident/{id}` (resolve) refuses the two
+ * BUILT-IN incident types with a 400 "Cannot resolve an incident of type …",
+ * in CIB seven, Camunda 7 and Operaton alike. Those incidents go away when
+ * their cause is retried: a `failedJob` through the job's retries, a
+ * `failedExternalTask` through the external task's retries. The incident's
+ * `configuration` names that job / external task. Only custom incident types
+ * (raised via the API) are resolved.
+ */
+/** The incident types the engine raises itself: never resolvable, only retried. */
+export declare const BUILT_IN_INCIDENT_TYPES: readonly ["failedJob", "failedExternalTask"];
+/**
+ * What clears an incident:
+ * - `resolve` (a custom incident): resolve it (`DELETE /incident/{id}`);
+ * - `retry-job`: set the retries of the job `jobId`;
+ * - `retry-external-task`: set the retries of the external task `externalTaskId`;
+ * - `none` (a built-in incident without a `configuration`): one propagated
+ *   from a called instance, cleared by retrying its ROOT-CAUSE incident.
+ */
+export type IncidentRecovery = {
+    action: "resolve";
+} | {
+    action: "retry-job";
+    jobId: string;
+} | {
+    action: "retry-external-task";
+    externalTaskId: string;
+} | {
+    action: "none";
+};
+export declare function incidentRecovery(incident: {
+    incidentType?: string | null | undefined;
+    configuration?: string | null | undefined;
+}): IncidentRecovery;
+//# sourceMappingURL=incident-recovery.d.ts.map

package/dist/incident-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-recovery.d.ts","sourceRoot":"","sources":["../src/incident-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,8CAA+C,CAAA;AAEnF;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtB,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE;IACzC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACxC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAC1C,GAAG,gBAAgB,CAWnB"}

package/dist/incident-recovery.js

@@ -0,0 +1,24 @@
+/**
+ * Incident recovery. `DELETE /incident/{id}` (resolve) refuses the two
+ * BUILT-IN incident types with a 400 "Cannot resolve an incident of type …",
+ * in CIB seven, Camunda 7 and Operaton alike. Those incidents go away when
+ * their cause is retried: a `failedJob` through the job's retries, a
+ * `failedExternalTask` through the external task's retries. The incident's
+ * `configuration` names that job / external task. Only custom incident types
+ * (raised via the API) are resolved.
+ */
+/** The incident types the engine raises itself: never resolvable, only retried. */
+export const BUILT_IN_INCIDENT_TYPES = ["failedJob", "failedExternalTask"];
+export function incidentRecovery(incident) {
+    // An empty configuration names nothing, like an absent one.
+    const target = incident.configuration === "" ? null : (incident.configuration ?? null);
+    switch (incident.incidentType) {
+        case "failedJob":
+            return target ? { action: "retry-job", jobId: target } : { action: "none" };
+        case "failedExternalTask":
+            return target ? { action: "retry-external-task", externalTaskId: target } : { action: "none" };
+        default:
+            return { action: "resolve" };
+    }
+}
+//# sourceMappingURL=incident-recovery.js.map

package/dist/incident-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-recovery.js","sourceRoot":"","sources":["../src/incident-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,WAAW,EAAE,oBAAoB,CAAU,CAAA;AAgBnF,MAAM,UAAU,gBAAgB,CAAC,QAGhC;IACC,4DAA4D;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC,CAAA;IACtF,QAAQ,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC9B,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAC7E,KAAK,oBAAoB;YACvB,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAChG;YACE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IAChC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @miragon/pulse-engine-core: the workflow domain of the Camunda 7 REST API family (Operaton,
+ * CIB seven, Camunda 7), and the one home of its pure engine REST rules (dates, filters,
+ * sorting, variable writes and typing, incident recovery, root causes, raw variable reads, the
+ * missing resource). Runs on a caller's `EnginePort`; returns data and throws
+ * `WorkflowError` reasons, and names no command, flag or tool: next steps and error reasons are
+ * structured, the caller words them. The pure rules behind these functions that only tests reach
+ * are exported from `@miragon/pulse-engine-core/testing`.
+ */
+export { type EngineFailure, type EnginePort, type EngineTransport, type ListResult, type OperationInput, type PlannedRequest, type PlannedWrite, type Query, createEnginePort, PARALLEL, Slots, } from "./port.js";
+export { type IdRequest, listByIds, queryInput } from "./requests.js";
+export { isWorkflowError, WorkflowError, type WorkflowErrorReason } from "./errors.js";
+export { amount, compareText, compareTime, definitionKeyOf, field, num, type Rec, records, str, } from "./records.js";
+export { type DateInputReading, earliestEngineDate, ENGINE_DATE_INPUT_FORMS, engineDateInput, engineDateMillis, engineTime, isEngineDateInput, latestEngineDate, OFFSET_REQUIRED, toEngineDate, toOptionalEngineDate, UTC_WITHOUT_OFFSET, } from "./dates.js";
+export { engineSorting } from "./sorting.js";
+export { complementaryFlags, engineInstanceSearch, engineKeyList, engineLike, trueOnly, } from "./filters.js";
+export { autoTypedValue, type EngineVariableInput, toEngineVariable, toEngineVariables, } from "./variable-writes.js";
+export { RAW_VARIABLES } from "./variables.js";
+export { incidentRecovery, type IncidentRecovery } from "./incident-recovery.js";
+export { mapLimit } from "./util.js";
+export { formatDuration } from "./durations.js";
+export { rootCause, rootCauseLine } from "./root-cause.js";
+export type { AdvanceInput, AdvanceOption, Candidate, ChildView, DefinitionView, EndedInstance, IncidentCause, IncidentView, InstanceData, InstanceState, InstanceView, ItemStep, ItemWait, NextStep, Selection, TimelineEntry, TimelineIncident, TreeNode, TypedValue, WaitKind, Waited, WaitState, } from "./types.js";
+export { checkSelection, selectInstance, selectionRequests } from "./select.js";
+export { type InspectOptions, inspectInstance, instanceRequests, loadInstance, loadView, MAX_STACKTRACE_LINES, } from "./inspect.js";
+export { activeTree, type InstanceTree } from "./tree.js";
+export { waitId } from "./waits.js";
+export { byActivity, isAdvanceable, isSuspendedJob, itemStep } from "./next.js";
+export type { DefinitionStatus, GroupStep, IncidentGroup, JobStatus, TopicStatus, } from "./status.js";
+export type { EngineStatus, Finding, FindingStep, Severity } from "./findings.js";
+export { readStatus, type StatusData, type StatusDeps, type StatusOptions, statusRequests, } from "./engine-status.js";
+export { type Condition, conditionLabel, decide, EXECUTABLE, type Measurement, measure, parseCondition, type Probe, type Verdict, } from "./conditions.js";
+export { poll, type PollResult, type PollTiming } from "./poll.js";
+export { checkRetryCount, executeWrite, missingRoots, type PlanEntry, planRetry, retriesWrite, type RetryFilter, retryEffect, type RetryMode, retryMode, retryPlanView, type SkipStep, } from "./retry-plan.js";
+export { advanceSteps, checkAdvanceInput, checkLock, checkOptions, checkSuspended, chooseWait, } from "./advance-plan.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * @miragon/pulse-engine-core: the workflow domain of the Camunda 7 REST API family (Operaton,
+ * CIB seven, Camunda 7), and the one home of its pure engine REST rules (dates, filters,
+ * sorting, variable writes and typing, incident recovery, root causes, raw variable reads, the
+ * missing resource). Runs on a caller's `EnginePort`; returns data and throws
+ * `WorkflowError` reasons, and names no command, flag or tool: next steps and error reasons are
+ * structured, the caller words them. The pure rules behind these functions that only tests reach
+ * are exported from `@miragon/pulse-engine-core/testing`.
+ */
+export { createEnginePort, PARALLEL, Slots, } from "./port.js";
+export { listByIds, queryInput } from "./requests.js";
+export { isWorkflowError, WorkflowError } from "./errors.js";
+export { amount, compareText, compareTime, definitionKeyOf, field, num, records, str, } from "./records.js";
+export { earliestEngineDate, ENGINE_DATE_INPUT_FORMS, engineDateInput, engineDateMillis, engineTime, isEngineDateInput, latestEngineDate, OFFSET_REQUIRED, toEngineDate, toOptionalEngineDate, UTC_WITHOUT_OFFSET, } from "./dates.js";
+export { engineSorting } from "./sorting.js";
+export { complementaryFlags, engineInstanceSearch, engineKeyList, engineLike, trueOnly, } from "./filters.js";
+export { autoTypedValue, toEngineVariable, toEngineVariables, } from "./variable-writes.js";
+export { RAW_VARIABLES } from "./variables.js";
+export { incidentRecovery } from "./incident-recovery.js";
+export { mapLimit } from "./util.js";
+export { formatDuration } from "./durations.js";
+export { rootCause, rootCauseLine } from "./root-cause.js";
+export { checkSelection, selectInstance, selectionRequests } from "./select.js";
+export { inspectInstance, instanceRequests, loadInstance, loadView, MAX_STACKTRACE_LINES, } from "./inspect.js";
+export { activeTree } from "./tree.js";
+export { waitId } from "./waits.js";
+export { byActivity, isAdvanceable, isSuspendedJob, itemStep } from "./next.js";
+export { readStatus, statusRequests, } from "./engine-status.js";
+export { conditionLabel, decide, EXECUTABLE, measure, parseCondition, } from "./conditions.js";
+export { poll } from "./poll.js";
+export { checkRetryCount, executeWrite, missingRoots, planRetry, retriesWrite, retryEffect, retryMode, retryPlanView, } from "./retry-plan.js";
+export { advanceSteps, checkAdvanceInput, checkLock, checkOptions, checkSuspended, chooseWait, } from "./advance-plan.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EASL,gBAAgB,EAChB,QAAQ,EACR,KAAK,GACN,MAAM,WAAW,CAAA;AAClB,OAAO,EAAkB,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,aAAa,EAA4B,MAAM,aAAa,CAAA;AACtF,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,eAAe,EACf,KAAK,EACL,GAAG,EAEH,OAAO,EACP,GAAG,GACJ,MAAM,cAAc,CAAA;AACrB,OAAO,EAEL,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,EAEd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAA;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAyB1D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,oBAAoB,GACrB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,UAAU,EAAqB,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAS/E,OAAO,EACL,UAAU,EAIV,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAEL,cAAc,EACd,MAAM,EACN,UAAU,EAEV,OAAO,EACP,cAAc,GAGf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,IAAI,EAAoC,MAAM,WAAW,CAAA;AAClE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EAEZ,SAAS,EACT,YAAY,EAEZ,WAAW,EAEX,SAAS,EACT,aAAa,GAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,mBAAmB,CAAA"}

package/dist/inspect.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 { type EnginePort, type PlannedRequest } from "./port.js";
+import { type Rec } from "./records.js";
+import type { EndedInstance, IncidentCause, InstanceView, Selection } from "./types.js";
+export interface InspectOptions {
+    readonly variables: boolean;
+    readonly history: boolean;
+    readonly stacktrace: boolean;
+}
+/** A stack trace an instance view carries is cut after this many lines. */
+export declare const MAX_STACKTRACE_LINES = 200;
+/** The first round for an id: runtime and history record. */
+export declare function instanceRequests(id: string): PlannedRequest[];
+/**
+ * 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 declare function incidentCause(port: EnginePort, incident: Rec, stacktrace: boolean): Promise<IncidentCause>;
+/**
+ * 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 declare function loadInstance(port: EnginePort, id: string, options: InspectOptions, attempts?: number): Promise<InstanceView>;
+/**
+ * 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 declare function loadView(port: EnginePort, id: string, options: InspectOptions): Promise<InstanceView | EndedInstance>;
+/** Inspect: the selected instance's view (selection rules and errors as `selectInstance`'s). */
+export declare function inspectInstance(port: EnginePort, selection: Selection, options: InspectOptions): Promise<InstanceView>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,UAAU,EAAuB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AACrF,OAAO,EAAS,KAAK,GAAG,EAAgB,MAAM,cAAc,CAAA;AAM5D,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,YAAY,EACZ,SAAS,EACV,MAAM,YAAY,CAAA;AAInB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAID,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAavC,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,EAAE,CAK7D;AAoKD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,aAAa,CAAC,CAaxB;AAWD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,cAAc,EACvB,QAAQ,SAAI,GACX,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,GAAG,aAAa,CAAC,CASvC;AAED,gGAAgG;AAChG,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CAGvB"}