@teamkeel/testing-runtime 0.463.1 → 0.464.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teamkeel/testing-runtime",
-  "version": "0.463.1",
+  "version": "0.464.0",
   "description": "Internal package used by the generated @teamkeel/testing package",
   "exports": "./src/index.mjs",
   "typings": "src/index.d.ts",

package/src/FlowExecutor.mjs

@@ -1,6 +1,13 @@
 import jwt from "jsonwebtoken";
 import { parseInputs, parseOutputs, reviver } from "./parsing.mjs";
 
+// Interval (ms) between flow-run status polls in untilFinished/untilAwaitingInput.
+// A lower interval means less dead wait per flow assertion (at the cost of a few
+// more cheap status requests); overridable via env for tuning. In a test suite with
+// many flow assertions the previous 50ms floor added up to meaningful wall-clock.
+const FLOW_POLL_INTERVAL_MS =
+  Number(process.env.KEEL_FLOW_POLL_INTERVAL_MS) || 10;
+
 export class FlowExecutor {
   constructor(props) {
     this._flowUrl =
@@ -105,6 +112,28 @@ export class FlowExecutor {
     };
   }
 
+  async listSignedLinks(options = {}) {
+    let url = this._flowUrl + "/share";
+    if (options.status !== undefined && options.status !== null) {
+      const queryString = new URLSearchParams({
+        status: options.status,
+      }).toString();
+      url = `${url}?${queryString}`;
+    }
+
+    return fetch(url, {
+      method: "GET",
+      headers: this.headers(),
+    }).then(handleResponse);
+  }
+
+  async revokeSignedLink(linkId) {
+    return fetch(this._flowUrl + "/share/" + encodeURIComponent(linkId), {
+      method: "DELETE",
+      headers: this.headers(),
+    }).then(handleResponse);
+  }
+
   async cancel(id) {
     return fetch(this._flowUrl + "/" + encodeURIComponent(id) + "/cancel", {
       method: "POST",
@@ -172,7 +201,9 @@ export class FlowExecutor {
         return flow;
       }
 
-      await new Promise((resolve) => setTimeout(resolve, 50));
+      await new Promise((resolve) =>
+        setTimeout(resolve, FLOW_POLL_INTERVAL_MS)
+      );
     }
   }
 
@@ -204,7 +235,9 @@ export class FlowExecutor {
         );
       }
 
-      await new Promise((resolve) => setTimeout(resolve, 50));
+      await new Promise((resolve) =>
+        setTimeout(resolve, FLOW_POLL_INTERVAL_MS)
+      );
     }
   }
 }

package/src/index.d.ts

@@ -151,6 +151,10 @@ declare class FlowExecutor<Input = {}> {
     expiresAt: Date | null;
     flow: { name: string; runId: string | null };
   }>;
+  listSignedLinks(options?: {
+    status?: "active" | "revoked" | "expired";
+  }): Promise<{ signedLinks: SignedLinkRecord[] }>;
+  revokeSignedLink(linkId: string): Promise<SignedLinkRecord>;
   get(id: string): Promise<FlowRun<Input>>;
   cancel(id: string): Promise<FlowRun<Input>>;
   back(id: string): Promise<FlowRun<Input>>;
@@ -171,6 +175,36 @@ declare class FlowExecutor<Input = {}> {
   untilFinished(id: string, timeout?: number): Promise<FlowRun<Input>>;
 }
 
+// A persisted shareable signed link for a flow. The shareable url is exposed so the link can be
+// re-shared; the raw token/hash is never exposed. url is absent for links minted before the token
+// was persisted.
+export interface SignedLinkRecord {
+  id: string;
+  flowName: string;
+  inputs: Record<string, any> | null;
+  reusable: boolean;
+  createdBy: string | null;
+  expiresAt: Date | null;
+  usedCount: number;
+  revokedAt: Date | null;
+  createdAt: Date;
+  updatedAt: Date;
+  status: "active" | "revoked" | "expired";
+  url?: string;
+}
+
+// Live progress snapshot reported by a step while it runs
+export interface StepProgress {
+  message?: string;
+  current?: number;
+  total?: number;
+  unit?: string;
+  counter?: "count" | "percent" | "none";
+  logs?: string[];
+  data?: Record<string, unknown>;
+  updatedAt: string;
+}
+
 // Step Definition
 export interface FlowStep {
   id: string;
@@ -186,6 +220,7 @@ export interface FlowStep {
   createdAt: string;
   updatedAt: string;
   ui: UIConfig | null;
+  progress: StepProgress | null;
 }
 
 // Flow Run Definition