attlaz-client 1.64.0 → 1.65.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/Flow/FlowRunLifecycle.d.ts

@@ -0,0 +1,15 @@
+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: any): 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/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,7 @@ 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 { 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,7 @@ 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 { 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.65.0";

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attlaz-client",
-  "version": "1.64.0",
+  "version": "1.65.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -55,7 +55,7 @@
     "@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",