attlaz-client 1.64.0 → 1.66.0

package/dist/Model/Command/CommandExecutionFilter.d.ts

@@ -1,6 +1,6 @@
 import { CommandExecutionStatus } from './CommandExecutionStatus.js';
 export interface CommandExecutionFilter {
-    status?: CommandExecutionStatus;
-    type?: string;
+    status?: CommandExecutionStatus[];
+    type?: string[];
     requestedBy?: string;
 }

package/dist/Model/Event/EventType.d.ts

@@ -1,17 +1,17 @@
 export declare enum EventType {
     /** @deprecated * */
-    TaskExecutionRequested,
+    TaskExecutionRequested = "TaskExecutionRequested",
     /** @deprecated * */
-    TaskExecutionStarted,
+    TaskExecutionStarted = "TaskExecutionStarted",
     /** @deprecated * */
-    TaskExecutionFailed,
+    TaskExecutionFailed = "TaskExecutionFailed",
     /** @deprecated * */
-    TaskExecutionComplete,
+    TaskExecutionComplete = "TaskExecutionComplete",
     /** @deprecated * */
-    TaskExecutionRetry,
-    FlowRunRequested,
-    FlowRunStarted,
-    FlowRunFailed,
-    FlowRunComplete,
-    FlowRunRetry
+    TaskExecutionRetry = "TaskExecutionRetry",
+    FlowRunRequested = "FlowRunRequested",
+    FlowRunStarted = "FlowRunStarted",
+    FlowRunFailed = "FlowRunFailed",
+    FlowRunComplete = "FlowRunComplete",
+    FlowRunRetry = "FlowRunRetry"
 }

package/dist/Model/Event/EventType.js

@@ -1,18 +1,18 @@
 export var EventType;
 (function (EventType) {
     /** @deprecated * */
-    EventType[EventType["TaskExecutionRequested"] = 'TaskExecutionRequested'] = "TaskExecutionRequested";
+    EventType["TaskExecutionRequested"] = "TaskExecutionRequested";
     /** @deprecated * */
-    EventType[EventType["TaskExecutionStarted"] = 'TaskExecutionStarted'] = "TaskExecutionStarted";
+    EventType["TaskExecutionStarted"] = "TaskExecutionStarted";
     /** @deprecated * */
-    EventType[EventType["TaskExecutionFailed"] = 'TaskExecutionFailed'] = "TaskExecutionFailed";
+    EventType["TaskExecutionFailed"] = "TaskExecutionFailed";
     /** @deprecated * */
-    EventType[EventType["TaskExecutionComplete"] = 'TaskExecutionComplete'] = "TaskExecutionComplete";
+    EventType["TaskExecutionComplete"] = "TaskExecutionComplete";
     /** @deprecated * */
-    EventType[EventType["TaskExecutionRetry"] = 'TaskExecutionRetry'] = "TaskExecutionRetry";
-    EventType[EventType["FlowRunRequested"] = 'FlowRunRequested'] = "FlowRunRequested";
-    EventType[EventType["FlowRunStarted"] = 'FlowRunStarted'] = "FlowRunStarted";
-    EventType[EventType["FlowRunFailed"] = 'FlowRunFailed'] = "FlowRunFailed";
-    EventType[EventType["FlowRunComplete"] = 'FlowRunComplete'] = "FlowRunComplete";
-    EventType[EventType["FlowRunRetry"] = 'FlowRunRetry'] = "FlowRunRetry";
+    EventType["TaskExecutionRetry"] = "TaskExecutionRetry";
+    EventType["FlowRunRequested"] = "FlowRunRequested";
+    EventType["FlowRunStarted"] = "FlowRunStarted";
+    EventType["FlowRunFailed"] = "FlowRunFailed";
+    EventType["FlowRunComplete"] = "FlowRunComplete";
+    EventType["FlowRunRetry"] = "FlowRunRetry";
 })(EventType || (EventType = {}));

package/dist/Model/Flow/FlowRunHistory.d.ts

@@ -1,7 +1,8 @@
-import { FlowRunStatus } from './FlowRunStatus.js';
+import { ApiRecord } from '../ApiRecord.js';
+import { FlowRunHistoryStatus } from './FlowRunHistoryStatus.js';
 export declare class FlowRunHistory {
     id: string;
     time: Date;
-    status: FlowRunStatus;
-    static parse(rawFlowRunHistory: any): FlowRunHistory;
+    status: FlowRunHistoryStatus;
+    static parse(rawFlowRunHistory: ApiRecord): FlowRunHistory;
 }

package/dist/Model/Flow/FlowRunHistory.js

@@ -1,5 +1,5 @@
 import { Utils } from '../../Utils.js';
-import { FlowRunStatus } from './FlowRunStatus.js';
+import { FlowRunHistoryStatus } from './FlowRunHistoryStatus.js';
 export class FlowRunHistory {
     id;
     time;
@@ -8,7 +8,7 @@ export class FlowRunHistory {
         const flowRunHistory = new FlowRunHistory();
         flowRunHistory.id = rawFlowRunHistory.id;
         flowRunHistory.time = Utils.parseRawDate(rawFlowRunHistory.time);
-        flowRunHistory.status = FlowRunStatus.fromString(rawFlowRunHistory.status);
+        flowRunHistory.status = FlowRunHistoryStatus.fromString(rawFlowRunHistory.status);
         return flowRunHistory;
     }
 }

package/dist/Model/Flow/FlowRunHistoryStatus.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Status values as stored in flow_run_history (distinct from FlowRunStatus, the derived run state).
+ * Notably `started`/`success` here vs `running`/`complete` on FlowRunStatus — reusing FlowRunStatus
+ * to parse history rows would throw on those two values and silently drop them.
+ */
+export declare enum FlowRunHistoryStatus {
+    Pending = "pending",
+    Started = "started",
+    Success = "success",
+    Failed = "failed",
+    Stopped = "stopped",
+    Canceled = "canceled"
+}
+export declare namespace FlowRunHistoryStatus {
+    const fromString: (input: string) => FlowRunHistoryStatus;
+}

package/dist/Model/Flow/FlowRunHistoryStatus.js

@@ -0,0 +1,24 @@
+import { Utils } from '../../Utils.js';
+/**
+ * Status values as stored in flow_run_history (distinct from FlowRunStatus, the derived run state).
+ * Notably `started`/`success` here vs `running`/`complete` on FlowRunStatus — reusing FlowRunStatus
+ * to parse history rows would throw on those two values and silently drop them.
+ */
+export var FlowRunHistoryStatus;
+(function (FlowRunHistoryStatus) {
+    FlowRunHistoryStatus["Pending"] = "pending";
+    FlowRunHistoryStatus["Started"] = "started";
+    FlowRunHistoryStatus["Success"] = "success";
+    FlowRunHistoryStatus["Failed"] = "failed";
+    FlowRunHistoryStatus["Stopped"] = "stopped";
+    FlowRunHistoryStatus["Canceled"] = "canceled";
+})(FlowRunHistoryStatus || (FlowRunHistoryStatus = {}));
+(function (FlowRunHistoryStatus) {
+    FlowRunHistoryStatus.fromString = (input) => {
+        const result = Utils.parseEnum(input, FlowRunHistoryStatus);
+        if (result === null) {
+            throw new Error('Unable to parse FlowRunHistoryStatus from string: Unknown FlowRunHistoryStatus "' + input + '"');
+        }
+        return result;
+    };
+})(FlowRunHistoryStatus || (FlowRunHistoryStatus = {}));

package/dist/Model/Flow/FlowRunLifecycle.d.ts

@@ -0,0 +1,16 @@
+import { ApiRecord } from '../ApiRecord.js';
+import { FlowRunStatus } from './FlowRunStatus.js';
+/**
+ * The authoritative lifecycle of a flow run, as derived server-side from its event history
+ * (first-terminal-wins). Unlike FlowRunSummary, which reflects the (eventually-consistent) index
+ * projection, this is computed directly from the history and is safe for control-flow decisions
+ * such as the worker's "is this run already terminal?" tombstone check.
+ */
+export declare class FlowRunLifecycle {
+    id: string;
+    status: FlowRunStatus;
+    requested: Date | null;
+    started: Date | null;
+    ended: Date | null;
+    static parse(rawFlowRunLifecycle: ApiRecord): FlowRunLifecycle;
+}

package/dist/Model/Flow/FlowRunLifecycle.js

@@ -0,0 +1,24 @@
+import { Utils } from '../../Utils.js';
+import { FlowRunStatus } from './FlowRunStatus.js';
+/**
+ * The authoritative lifecycle of a flow run, as derived server-side from its event history
+ * (first-terminal-wins). Unlike FlowRunSummary, which reflects the (eventually-consistent) index
+ * projection, this is computed directly from the history and is safe for control-flow decisions
+ * such as the worker's "is this run already terminal?" tombstone check.
+ */
+export class FlowRunLifecycle {
+    id;
+    status;
+    requested;
+    started;
+    ended;
+    static parse(rawFlowRunLifecycle) {
+        const lifecycle = new FlowRunLifecycle();
+        lifecycle.id = rawFlowRunLifecycle.id;
+        lifecycle.status = FlowRunStatus.fromString(rawFlowRunLifecycle.status);
+        lifecycle.requested = rawFlowRunLifecycle.requested === null || rawFlowRunLifecycle.requested === undefined ? null : Utils.parseRawDate(rawFlowRunLifecycle.requested);
+        lifecycle.started = rawFlowRunLifecycle.started === null || rawFlowRunLifecycle.started === undefined ? null : Utils.parseRawDate(rawFlowRunLifecycle.started);
+        lifecycle.ended = rawFlowRunLifecycle.ended === null || rawFlowRunLifecycle.ended === undefined ? null : Utils.parseRawDate(rawFlowRunLifecycle.ended);
+        return lifecycle;
+    }
+}

package/dist/Model/Flow/FlowRunStatus.d.ts

@@ -1,11 +1,11 @@
 export declare enum FlowRunStatus {
-    Unknown,
-    Pending,
-    Canceled,
-    Running,
-    Failed,
-    Stopped,
-    Complete
+    Unknown = "unknown",
+    Pending = "pending",
+    Canceled = "canceled",
+    Running = "running",
+    Failed = "failed",
+    Stopped = "stopped",
+    Complete = "complete"
 }
 export declare namespace FlowRunStatus {
     const fromString: (input: string) => FlowRunStatus;

package/dist/Model/Flow/FlowRunStatus.js

@@ -1,13 +1,13 @@
 import { Utils } from '../../Utils.js';
 export var FlowRunStatus;
 (function (FlowRunStatus) {
-    FlowRunStatus[FlowRunStatus["Unknown"] = 'unknown'] = "Unknown";
-    FlowRunStatus[FlowRunStatus["Pending"] = 'pending'] = "Pending";
-    FlowRunStatus[FlowRunStatus["Canceled"] = 'canceled'] = "Canceled";
-    FlowRunStatus[FlowRunStatus["Running"] = 'running'] = "Running";
-    FlowRunStatus[FlowRunStatus["Failed"] = 'failed'] = "Failed";
-    FlowRunStatus[FlowRunStatus["Stopped"] = 'stopped'] = "Stopped";
-    FlowRunStatus[FlowRunStatus["Complete"] = 'complete'] = "Complete";
+    FlowRunStatus["Unknown"] = "unknown";
+    FlowRunStatus["Pending"] = "pending";
+    FlowRunStatus["Canceled"] = "canceled";
+    FlowRunStatus["Running"] = "running";
+    FlowRunStatus["Failed"] = "failed";
+    FlowRunStatus["Stopped"] = "stopped";
+    FlowRunStatus["Complete"] = "complete";
 })(FlowRunStatus || (FlowRunStatus = {}));
 (function (FlowRunStatus) {
     FlowRunStatus.fromString = (input) => {

package/dist/Service/CommandExecutionEndpoint.js

@@ -9,10 +9,10 @@ export class CommandExecutionEndpoint extends Endpoint {
         const queryString = new QueryString('/system/command-executions');
         queryString.addPagination(pagination);
         if (filter !== null) {
-            if (filter.status !== undefined) {
+            if (filter.status !== undefined && filter.status.length > 0) {
                 queryString.set('status', filter.status);
             }
-            if (filter.type !== undefined) {
+            if (filter.type !== undefined && filter.type.length > 0) {
                 queryString.set('type', filter.type);
             }
             if (filter.requestedBy !== undefined) {

package/dist/Service/FlowRunEndpoint.d.ts

@@ -2,6 +2,7 @@ import { FlowRun } from '../Model/Flow/FlowRun.js';
 import { FlowRunStatus } from '../Model/Flow/FlowRunStatus.js';
 import { FlowRunSummary } from '../Model/Flow/FlowRunSummary.js';
 import { FlowRunHistory } from '../Model/Flow/FlowRunHistory.js';
+import { FlowRunLifecycle } from '../Model/Flow/FlowRunLifecycle.js';
 import { CollectionResult } from '../Model/Result/CollectionResult.js';
 import { CursorPagination } from '../Model/Pagination/CursorPagination.js';
 import { Endpoint } from './Endpoint.js';
@@ -10,5 +11,11 @@ export declare class FlowRunEndpoint extends Endpoint {
     getFlowRunSummaries(flowId: string, flowRunStatuses?: FlowRunStatus[] | null, pagination?: CursorPagination | null, projectEnvironmentId?: string | null): Promise<CollectionResult<FlowRunSummary>>;
     getFlowRunSummary(flowRunId: string): Promise<FlowRunSummary | null>;
     getFlowRunHistory(flowRunId: string): Promise<CollectionResult<FlowRunHistory>>;
+    /**
+     * Authoritative lifecycle (status derived from history, first-terminal-wins). Prefer this over
+     * getFlowRunSummary for control-flow decisions (e.g. the worker tombstone), since the summary
+     * reflects the eventually-consistent index projection which can lag the history.
+     */
+    getFlowRunLifecycle(flowRunId: string): Promise<FlowRunLifecycle | null>;
     updateFlowRun(flowRunId: string, status: FlowRunStatus, time?: Date | null): Promise<FlowRun>;
 }

package/dist/Service/FlowRunEndpoint.js

@@ -1,6 +1,7 @@
 import { FlowRun } from '../Model/Flow/FlowRun.js';
 import { FlowRunSummary } from '../Model/Flow/FlowRunSummary.js';
 import { FlowRunHistory } from '../Model/Flow/FlowRunHistory.js';
+import { FlowRunLifecycle } from '../Model/Flow/FlowRunLifecycle.js';
 import { QueryString } from '../Http/Data/QueryString.js';
 import { Endpoint } from './Endpoint.js';
 export class FlowRunEndpoint extends Endpoint {
@@ -62,6 +63,15 @@ export class FlowRunEndpoint extends Endpoint {
         const result = await this.requestCollection('/flowruns/' + flowRunId + '/history', FlowRunHistory.parse);
         return result;
     }
+    /**
+     * Authoritative lifecycle (status derived from history, first-terminal-wins). Prefer this over
+     * getFlowRunSummary for control-flow decisions (e.g. the worker tombstone), since the summary
+     * reflects the eventually-consistent index projection which can lag the history.
+     */
+    async getFlowRunLifecycle(flowRunId) {
+        const result = await this.requestObject('/flowruns/' + flowRunId + '/lifecycle', null, FlowRunLifecycle.parse);
+        return result.getData();
+    }
     async updateFlowRun(flowRunId, status, time = null) {
         if (flowRunId.length === 0) {
             throw new Error('Flow run id cannot be empty');

package/dist/index.d.ts

@@ -118,6 +118,8 @@ export { StateAware } from './Model/StateAware.js';
 export { Flow } from './Model/Flow/Flow.js';
 export { FlowRun } from './Model/Flow/FlowRun.js';
 export { FlowRunHistory } from './Model/Flow/FlowRunHistory.js';
+export { FlowRunHistoryStatus } from './Model/Flow/FlowRunHistoryStatus.js';
+export { FlowRunLifecycle } from './Model/Flow/FlowRunLifecycle.js';
 export { FlowRunResponse } from './Model/Flow/FlowRunResponse.js';
 export { FlowRunStatus } from './Model/Flow/FlowRunStatus.js';
 export { FlowRunSummary } from './Model/Flow/FlowRunSummary.js';

package/dist/index.js

@@ -106,6 +106,8 @@ export { State } from './Model/State.js';
 export { Flow } from './Model/Flow/Flow.js';
 export { FlowRun } from './Model/Flow/FlowRun.js';
 export { FlowRunHistory } from './Model/Flow/FlowRunHistory.js';
+export { FlowRunHistoryStatus } from './Model/Flow/FlowRunHistoryStatus.js';
+export { FlowRunLifecycle } from './Model/Flow/FlowRunLifecycle.js';
 export { FlowRunResponse } from './Model/Flow/FlowRunResponse.js';
 export { FlowRunStatus } from './Model/Flow/FlowRunStatus.js';
 export { FlowRunSummary } from './Model/Flow/FlowRunSummary.js';

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.64.0";
+export declare const VERSION = "1.66.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.64.0";
+export const VERSION = "1.66.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attlaz-client",
-  "version": "1.64.0",
+  "version": "1.66.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -50,12 +50,12 @@
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.9.1",
+    "@types/node": "^25.9.2",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
     "eslint": "^9.39.4",
     "eslint-config-attlaz-base": "^1.8.0",
-    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsdoc": "^62.9.0",
     "eslint-plugin-prefer-arrow": "^1.2.3",