@blokjs/runner 0.2.1 → 0.4.0

package/dist/scheduling/DebounceCoordinator.js

@@ -0,0 +1,141 @@
+export class DebounceCoordinator {
+    static instance = null;
+    states = new Map();
+    static getInstance() {
+        if (!DebounceCoordinator.instance) {
+            DebounceCoordinator.instance = new DebounceCoordinator();
+        }
+        return DebounceCoordinator.instance;
+    }
+    /** Test-only — reset the singleton + clear all state. */
+    static resetInstance() {
+        DebounceCoordinator.instance?.clear();
+        DebounceCoordinator.instance = null;
+    }
+    bucket(workflowName, debounceKey) {
+        return `${workflowName}\x1f${debounceKey}`;
+    }
+    register(opts) {
+        const now = opts.__now ?? Date.now();
+        const bucketKey = this.bucket(opts.workflowName, opts.debounceKey);
+        const existing = this.states.get(bucketKey);
+        // === Leading mode ===
+        if (opts.mode === "leading") {
+            if (existing) {
+                // Window active — coalesce this ping (drop the run).
+                existing.pingCount += 1;
+                existing.lastPingAt = now;
+                return {
+                    outcome: "coalesce",
+                    activeRunId: existing.activeRunId,
+                    pingCount: existing.pingCount,
+                };
+            }
+            // Open a new window. Caller fires synchronously; coordinator just
+            // tracks state to suppress follow-ups for `delayMs`.
+            const state = {
+                bucketKey,
+                mode: "leading",
+                delayMs: opts.delayMs,
+                maxDelayMs: opts.maxDelayMs,
+                firstPingAt: now,
+                lastPingAt: now,
+                pingCount: 1,
+                activeRunId: opts.runId,
+            };
+            // Auto-close the window after delayMs of silence — clear state so
+            // subsequent pings start fresh.
+            state.timer = setTimeout(() => {
+                const cur = this.states.get(bucketKey);
+                if (cur && cur.lastPingAt + opts.delayMs <= Date.now()) {
+                    this.states.delete(bucketKey);
+                }
+            }, opts.delayMs);
+            this.states.set(bucketKey, state);
+            return { outcome: "fire-immediate", activeRunId: opts.runId, pingCount: 1 };
+        }
+        // === Trailing mode ===
+        if (existing) {
+            // Extend the window: cancel the old timer, set a new one. Latest
+            // payload wins via the captured `onFire`.
+            if (existing.timer)
+                clearTimeout(existing.timer);
+            existing.pingCount += 1;
+            existing.lastPingAt = now;
+            existing.onFire = opts.onFire;
+            const naiveDeadline = now + opts.delayMs;
+            const dispatchAt = existing.maxDelayDeadline !== undefined ? Math.min(naiveDeadline, existing.maxDelayDeadline) : naiveDeadline;
+            const wait = Math.max(0, dispatchAt - now);
+            existing.timer = setTimeout(() => this.fireTrailing(bucketKey), wait);
+            return {
+                outcome: "coalesce",
+                activeRunId: existing.activeRunId,
+                scheduledAt: dispatchAt,
+                pingCount: existing.pingCount,
+            };
+        }
+        // New trailing window.
+        const state = {
+            bucketKey,
+            mode: "trailing",
+            delayMs: opts.delayMs,
+            maxDelayMs: opts.maxDelayMs,
+            firstPingAt: now,
+            lastPingAt: now,
+            pingCount: 1,
+            activeRunId: opts.runId,
+            maxDelayDeadline: opts.maxDelayMs !== undefined ? now + opts.maxDelayMs : undefined,
+            onFire: opts.onFire,
+        };
+        const naiveDeadline = now + opts.delayMs;
+        const dispatchAt = state.maxDelayDeadline !== undefined ? Math.min(naiveDeadline, state.maxDelayDeadline) : naiveDeadline;
+        const wait = Math.max(0, dispatchAt - now);
+        state.timer = setTimeout(() => this.fireTrailing(bucketKey), wait);
+        this.states.set(bucketKey, state);
+        return {
+            outcome: "schedule-trailing",
+            activeRunId: opts.runId,
+            scheduledAt: dispatchAt,
+            pingCount: 1,
+        };
+    }
+    fireTrailing(bucketKey) {
+        const state = this.states.get(bucketKey);
+        if (!state)
+            return;
+        this.states.delete(bucketKey);
+        if (state.onFire) {
+            void state.onFire().catch((err) => {
+                console.error(`[blok][scheduling] DebounceCoordinator trailing-fire failed for key ${bucketKey}:`, err instanceof Error ? err.stack || err.message : err);
+            });
+        }
+    }
+    /** Cancel an active window without firing. Returns true if cancelled. */
+    cancel(workflowName, debounceKey) {
+        const bucketKey = this.bucket(workflowName, debounceKey);
+        const state = this.states.get(bucketKey);
+        if (!state)
+            return false;
+        if (state.timer)
+            clearTimeout(state.timer);
+        this.states.delete(bucketKey);
+        return true;
+    }
+    /** Number of active debounce windows. Tests + observability. */
+    size() {
+        return this.states.size;
+    }
+    /** True if a window is open for `(workflow, key)`. */
+    has(workflowName, debounceKey) {
+        return this.states.has(this.bucket(workflowName, debounceKey));
+    }
+    /** Cancel everything without firing. */
+    clear() {
+        for (const state of this.states.values()) {
+            if (state.timer)
+                clearTimeout(state.timer);
+        }
+        this.states.clear();
+    }
+}
+//# sourceMappingURL=DebounceCoordinator.js.map

package/dist/scheduling/DebounceCoordinator.js.map

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

package/dist/scheduling/DeferredDispatchSignal.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Tier 2 #5 + #7 — thrown by `TriggerBase.run()` when a workflow's
+ * scheduling gates (debounce / delay) defer the run to a future
+ * dispatch. Tier 2 #6 follow-up extends this to cover `onLimit:"queue"`
+ * (concurrency-gate-deferred runs); same transport translation.
+ *
+ * NOT a true error — a control-flow exception. Trigger transports
+ * catch it and translate it into the appropriate transport-level
+ * response:
+ *
+ * - HTTP trigger → `202 Accepted` with `Location: /__blok/runs/:id`
+ *   header and structured JSON body.
+ * - Worker trigger → ACK without retry (the deferred coordinator owns
+ *   the eventual dispatch).
+ *
+ * Carries the run-detail summary the transport needs to populate the
+ * response.
+ */
+export interface DeferredDispatchInfo {
+    /** Run id allocated by the tracer when the run was created. */
+    runId: string;
+    /** Workflow name. */
+    workflowName: string;
+    /**
+     * Resolved status the run was placed in:
+     * - `"delayed"` — Tier 2 #5 (`trigger.delay`).
+     * - `"debounced"` — Tier 2 #7 (`trigger.debounce`).
+     * - `"queued"` — Tier 2 #6 follow-up (`trigger.onLimit:"queue"`).
+     */
+    status: "delayed" | "debounced" | "queued";
+    /** ms since epoch when the run is scheduled to dispatch. */
+    scheduledAt: number;
+    /** ms since epoch when the run will expire if not dispatched. Undefined when no TTL. */
+    expiresAt?: number;
+    /** True when the run was placed in `"debounced"` status (Tier 2 #7). */
+    debounced: boolean;
+    /** Pings absorbed by the run so far (always 1+). */
+    pingCount: number;
+    /**
+     * For leading-mode debounce, the runId of the sibling that fired
+     * immediately. Lets transports return `Location: /__blok/runs/<sibling>`
+     * so the caller can poll the actually-running run.
+     */
+    intoRunId?: string;
+}
+export declare class DeferredDispatchSignal extends Error {
+    readonly info: DeferredDispatchInfo;
+    constructor(info: DeferredDispatchInfo);
+}
+export declare function isDeferredDispatchSignal(err: unknown): err is DeferredDispatchSignal;

package/dist/scheduling/DeferredDispatchSignal.js

@@ -0,0 +1,14 @@
+export class DeferredDispatchSignal extends Error {
+    info;
+    constructor(info) {
+        super(`Run ${info.runId} for workflow '${info.workflowName}' was deferred ` +
+            `(${info.status}; scheduledAt=${info.scheduledAt}; pingCount=${info.pingCount}).`);
+        this.name = "DeferredDispatchSignal";
+        this.info = info;
+        Object.setPrototypeOf(this, DeferredDispatchSignal.prototype);
+    }
+}
+export function isDeferredDispatchSignal(err) {
+    return err instanceof DeferredDispatchSignal;
+}
+//# sourceMappingURL=DeferredDispatchSignal.js.map

package/dist/scheduling/DeferredDispatchSignal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeferredDispatchSignal.js","sourceRoot":"","sources":["../../src/scheduling/DeferredDispatchSignal.ts"],"names":[],"mappings":"AA8CA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAE3C,YAAY,IAA0B;QACrC,KAAK,CACJ,OAAO,IAAI,CAAC,KAAK,kBAAkB,IAAI,CAAC,YAAY,iBAAiB;YACpE,IAAI,IAAI,CAAC,MAAM,iBAAiB,IAAI,CAAC,WAAW,eAAe,IAAI,CAAC,SAAS,IAAI,CAClF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACD;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACpD,OAAO,GAAG,YAAY,sBAAsB,CAAC;AAC9C,CAAC"}

package/dist/scheduling/DeferredRunScheduler.d.ts

@@ -0,0 +1,68 @@
+import type { ScheduledDispatchRow } from "../tracing/types";
+export type DeferredDispatchFn = () => Promise<void>;
+/**
+ * Optional persistence payload — when supplied to `schedule()`, the
+ * scheduler writes a `scheduled_dispatches` row before registering the
+ * timer, and deletes it on cancel or fire. Trigger boot recovery
+ * (e.g. `HttpTrigger.recoverDispatches`) reads these rows to re-register
+ * timers across process restarts.
+ */
+export interface DeferredScheduleOptions {
+    workflowName: string;
+    /** Trigger type — `"http"` for v1; future triggers can opt in. */
+    triggerType: string;
+    /** TTL deadline (ms since epoch). When set, expired rows get marked `expired` on boot recovery. */
+    expiresAt?: number;
+    /** Mirrors the run record's status. */
+    dispatchStatus: ScheduledDispatchRow["dispatchStatus"];
+    /**
+     * JSON-serializable trigger-defined payload sufficient to reconstruct
+     * dispatch on boot. Trigger packages choose what to put here.
+     */
+    payload: unknown;
+}
+export declare class DeferredRunScheduler {
+    private static instance;
+    private entries;
+    static getInstance(): DeferredRunScheduler;
+    /** Test-only — reset the singleton. Cancels all pending timers. */
+    static resetInstance(): void;
+    /**
+     * Register a deferred dispatch. The timer fires at `dispatchAt`
+     * (clamped to ≥ now); when it fires, the entry is removed from the
+     * map and `dispatchFn` is invoked. Errors thrown by `dispatchFn` are
+     * swallowed and logged — the scheduler is fire-and-forget by design.
+     *
+     * Re-scheduling the same `runId` cancels the previous timer and
+     * replaces it (used by the debounce coordinator's "reset on ping").
+     *
+     * When `persist` is provided, the scheduler also writes a
+     * `scheduled_dispatches` row before registering the timer (so a
+     * crash leaves the dispatch recoverable), and deletes the row on
+     * cancel or fire.
+     */
+    schedule(runId: string, dispatchAt: number, dispatchFn: DeferredDispatchFn, persist?: DeferredScheduleOptions): void;
+    /**
+     * Cancel a pending dispatch. Returns true if the entry existed and
+     * was cancelled; false otherwise. Idempotent. When the entry was
+     * persisted, also deletes the `scheduled_dispatches` row.
+     *
+     * `cancelPersistedOnly` (default false) lets callers force the
+     * persistence-row delete even when the in-memory timer is gone (e.g.
+     * recovery cleanup that knows about a row but never had a timer).
+     */
+    cancel(runId: string, cancelPersistedOnly?: boolean): boolean;
+    private deletePersistedRow;
+    /** True if `runId` has a pending timer. */
+    has(runId: string): boolean;
+    /** Number of pending timers. Useful for tests + observability. */
+    size(): number;
+    /**
+     * Fire ALL pending dispatches immediately and clear the queue.
+     * Awaits each `dispatchFn` so the caller knows when the queue is
+     * drained. Useful for graceful shutdown.
+     */
+    drainAll(): Promise<void>;
+    /** Cancel everything without dispatching. */
+    clear(): void;
+}

package/dist/scheduling/DeferredRunScheduler.js

@@ -0,0 +1,154 @@
+/**
+ * Tier 2 #5 — in-memory scheduler for deferred workflow runs. Tier 2
+ * #5+#7 follow-up adds optional sqlite-backed durability via the
+ * {@link DeferredScheduleOptions.persist} parameter.
+ *
+ * Process-wide singleton; obtained via {@link DeferredRunScheduler.getInstance}.
+ * Reset between tests via {@link DeferredRunScheduler.resetInstance}.
+ */
+import { RunTracker } from "../tracing/RunTracker";
+export class DeferredRunScheduler {
+    static instance = null;
+    entries = new Map();
+    static getInstance() {
+        if (!DeferredRunScheduler.instance) {
+            DeferredRunScheduler.instance = new DeferredRunScheduler();
+        }
+        return DeferredRunScheduler.instance;
+    }
+    /** Test-only — reset the singleton. Cancels all pending timers. */
+    static resetInstance() {
+        DeferredRunScheduler.instance?.clear();
+        DeferredRunScheduler.instance = null;
+    }
+    /**
+     * Register a deferred dispatch. The timer fires at `dispatchAt`
+     * (clamped to ≥ now); when it fires, the entry is removed from the
+     * map and `dispatchFn` is invoked. Errors thrown by `dispatchFn` are
+     * swallowed and logged — the scheduler is fire-and-forget by design.
+     *
+     * Re-scheduling the same `runId` cancels the previous timer and
+     * replaces it (used by the debounce coordinator's "reset on ping").
+     *
+     * When `persist` is provided, the scheduler also writes a
+     * `scheduled_dispatches` row before registering the timer (so a
+     * crash leaves the dispatch recoverable), and deletes the row on
+     * cancel or fire.
+     */
+    schedule(runId, dispatchAt, dispatchFn, persist) {
+        // Persist BEFORE the timer so a crash between persist + setTimeout
+        // still leaves the row recoverable.
+        const persisted = persist !== undefined;
+        if (persisted) {
+            const tracker = RunTracker.getInstance();
+            if (tracker.active) {
+                try {
+                    tracker.getStore().upsertScheduledDispatch({
+                        runId,
+                        workflowName: persist.workflowName,
+                        triggerType: persist.triggerType,
+                        scheduledAt: dispatchAt,
+                        expiresAt: persist.expiresAt,
+                        dispatchStatus: persist.dispatchStatus,
+                        payload: persist.payload,
+                        createdAt: Date.now(),
+                    });
+                }
+                catch (err) {
+                    // Don't block the dispatch on persistence failure — log and continue.
+                    console.error(`[blok][scheduling] persist failed for run ${runId}; continuing in-memory only:`, err instanceof Error ? err.stack || err.message : err);
+                }
+            }
+        }
+        // Replace any existing entry for this runId.
+        const existing = this.entries.get(runId);
+        if (existing)
+            clearTimeout(existing.timer);
+        const delay = Math.max(0, dispatchAt - Date.now());
+        const timer = setTimeout(() => {
+            this.entries.delete(runId);
+            // Best-effort delete the persisted row before invoking dispatchFn —
+            // dispatch will write the run's terminal status separately.
+            if (persisted)
+                this.deletePersistedRow(runId);
+            void dispatchFn().catch((err) => {
+                console.error(`[blok][scheduling] DeferredRunScheduler dispatch failed for run ${runId}:`, err instanceof Error ? err.stack || err.message : err);
+            });
+        }, delay);
+        // `Node` will keep the event loop alive for pending timers — that's
+        // the desired behavior for delayed runs in long-running services.
+        // `unref()` would be wrong here.
+        this.entries.set(runId, { runId, dispatchAt, timer, dispatchFn, persisted });
+    }
+    /**
+     * Cancel a pending dispatch. Returns true if the entry existed and
+     * was cancelled; false otherwise. Idempotent. When the entry was
+     * persisted, also deletes the `scheduled_dispatches` row.
+     *
+     * `cancelPersistedOnly` (default false) lets callers force the
+     * persistence-row delete even when the in-memory timer is gone (e.g.
+     * recovery cleanup that knows about a row but never had a timer).
+     */
+    cancel(runId, cancelPersistedOnly = false) {
+        const entry = this.entries.get(runId);
+        if (!entry) {
+            if (cancelPersistedOnly) {
+                return this.deletePersistedRow(runId);
+            }
+            return false;
+        }
+        clearTimeout(entry.timer);
+        this.entries.delete(runId);
+        if (entry.persisted)
+            this.deletePersistedRow(runId);
+        return true;
+    }
+    deletePersistedRow(runId) {
+        const tracker = RunTracker.getInstance();
+        if (!tracker.active)
+            return false;
+        try {
+            return tracker.getStore().deleteScheduledDispatch(runId);
+        }
+        catch (err) {
+            console.error(`[blok][scheduling] persist-cleanup failed for run ${runId}:`, err instanceof Error ? err.stack || err.message : err);
+            return false;
+        }
+    }
+    /** True if `runId` has a pending timer. */
+    has(runId) {
+        return this.entries.has(runId);
+    }
+    /** Number of pending timers. Useful for tests + observability. */
+    size() {
+        return this.entries.size;
+    }
+    /**
+     * Fire ALL pending dispatches immediately and clear the queue.
+     * Awaits each `dispatchFn` so the caller knows when the queue is
+     * drained. Useful for graceful shutdown.
+     */
+    async drainAll() {
+        const toFire = Array.from(this.entries.values());
+        // Cancel all timers first so we don't double-dispatch.
+        for (const entry of toFire)
+            clearTimeout(entry.timer);
+        this.entries.clear();
+        // Sequential dispatch — preserves intended order if it matters.
+        for (const entry of toFire) {
+            try {
+                await entry.dispatchFn();
+            }
+            catch (err) {
+                console.error(`[blok][scheduling] drainAll dispatch failed for run ${entry.runId}:`, err instanceof Error ? err.stack || err.message : err);
+            }
+        }
+    }
+    /** Cancel everything without dispatching. */
+    clear() {
+        for (const entry of this.entries.values())
+            clearTimeout(entry.timer);
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=DeferredRunScheduler.js.map

package/dist/scheduling/DeferredRunScheduler.js.map

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

package/dist/scheduling/readSchedulingConfig.d.ts

@@ -0,0 +1,24 @@
+/** Parsed, normalized debounce config ready for the coordinator. */
+export interface NormalizedDebounceConfig {
+    keyExpression: string;
+    mode: "leading" | "trailing";
+    delayMs: number;
+    maxDelayMs?: number;
+}
+/** Parsed, normalized scheduling config ready for the gates. */
+export interface NormalizedSchedulingConfig {
+    /** Delay in ms; undefined when no delay configured. */
+    delayMs?: number;
+    /** TTL in ms; undefined when no TTL configured. */
+    ttlMs?: number;
+    /** Debounce config; undefined when no debounce configured. */
+    debounce?: NormalizedDebounceConfig;
+}
+/**
+ * Read a workflow's trigger config and return the normalized scheduling
+ * config, or null when the workflow has no scheduling gates.
+ */
+export declare function readSchedulingConfig(trigger: Record<string, unknown> | undefined | null): NormalizedSchedulingConfig | null;
+export declare const SCHEDULING_DEFAULTS: {
+    readonly debounceMode: "trailing";
+};

package/dist/scheduling/readSchedulingConfig.js

@@ -0,0 +1,52 @@
+/**
+ * Tier 2 #5 + #7 — extract scheduling config from a workflow's trigger
+ * block, regardless of which trigger type owns it (HTTP, Worker, …).
+ *
+ * Returns `null` when the trigger has NO scheduling fields set. The
+ * caller (`TriggerBase.run()`) treats null as "skip the gates, run the
+ * workflow synchronously" — zero-overhead default.
+ *
+ * Upfront duration parsing converts `"1h"` → `3600000` so downstream
+ * code only deals in milliseconds. Invalid duration values are dropped
+ * (treated as if the field were unset) — this is fail-open by design,
+ * matching `idempotencyKey` semantics. Use `BLOK_MAPPER_MODE=strict`
+ * for fail-fast behavior in production (handled at the trigger config
+ * validation layer, not here).
+ */
+import { tryParseDuration } from "@blokjs/helper";
+const SCHEDULING_TRIGGER_KEYS = ["http", "worker"];
+/**
+ * Read a workflow's trigger config and return the normalized scheduling
+ * config, or null when the workflow has no scheduling gates.
+ */
+export function readSchedulingConfig(trigger) {
+    if (!trigger)
+        return null;
+    for (const triggerKey of SCHEDULING_TRIGGER_KEYS) {
+        const cfg = trigger[triggerKey];
+        if (!cfg)
+            continue;
+        const delayMs = cfg.delay !== undefined ? (tryParseDuration(cfg.delay) ?? undefined) : undefined;
+        const ttlMs = cfg.ttl !== undefined ? (tryParseDuration(cfg.ttl) ?? undefined) : undefined;
+        let debounce;
+        if (cfg.debounce && typeof cfg.debounce === "object") {
+            const d = cfg.debounce;
+            const keyExpression = typeof d.key === "string" ? d.key.trim() : "";
+            const dDelayMs = d.delay !== undefined ? (tryParseDuration(d.delay) ?? undefined) : undefined;
+            if (keyExpression && dDelayMs !== undefined && dDelayMs >= 0) {
+                const mode = d.mode === "leading" ? "leading" : "trailing";
+                const maxDelayMs = d.maxDelay !== undefined ? (tryParseDuration(d.maxDelay) ?? undefined) : undefined;
+                debounce = { keyExpression, mode, delayMs: dDelayMs, maxDelayMs };
+            }
+        }
+        const hasAny = delayMs !== undefined || ttlMs !== undefined || debounce !== undefined;
+        if (hasAny) {
+            return { delayMs, ttlMs, debounce };
+        }
+    }
+    return null;
+}
+export const SCHEDULING_DEFAULTS = {
+    debounceMode: "trailing",
+};
+//# sourceMappingURL=readSchedulingConfig.js.map

package/dist/scheduling/readSchedulingConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSchedulingConfig.js","sourceRoot":"","sources":["../../src/scheduling/readSchedulingConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;AAiC5D;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAAmD;IAEnD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,KAAK,MAAM,UAAU,IAAI,uBAAuB,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAA8B,CAAC;QAC7D,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjG,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3F,IAAI,QAA8C,CAAC;QACnD,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;YACvB,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9F,IAAI,aAAa,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,GAA2B,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;gBACnF,MAAM,UAAU,GAAG,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACtG,QAAQ,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;YACnE,CAAC;QACF,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,CAAC;QACtF,IAAI,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACrC,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,YAAY,EAAE,UAAmB;CACxB,CAAC"}

package/dist/testing/WorkflowTestRunner.js

@@ -4,13 +4,17 @@ import { TestLogger } from "./TestLogger";
 /**
  * A mock node implementation wrapping a user-provided handler function.
  */
+// biome-ignore lint/suspicious/noExplicitAny: mock node needs generic any for test flexibility
 class MockNode extends BlokService {
+    // biome-ignore lint/suspicious/noExplicitAny: mock handler accepts arbitrary inputs/outputs
     handler;
+    // biome-ignore lint/suspicious/noExplicitAny: mock handler accepts arbitrary inputs/outputs
     constructor(name, handler) {
         super();
         this.name = name;
         this.handler = handler;
     }
+    // biome-ignore lint/suspicious/noExplicitAny: matches BlokService.handle signature
     async handle(ctx, inputs) {
         const response = new BlokResponse();
         try {
@@ -73,9 +77,11 @@ class AutoMockNode extends MockNode {
  */
 export class WorkflowTestRunner {
     config;
+    // biome-ignore lint/suspicious/noExplicitAny: node registry holds heterogeneous node types
     nodes;
     workflow;
     trace;
+    // biome-ignore lint/suspicious/noExplicitAny: test results hold arbitrary data
     nodeResults;
     constructor(config) {
         this.config = {
@@ -94,8 +100,10 @@ export class WorkflowTestRunner {
      * @param name - The node name as referenced in the workflow steps
      * @param node - A BlokService instance or a FunctionNode from defineNode()
      */
+    // biome-ignore lint/suspicious/noExplicitAny: accepts heterogeneous node types for test flexibility
     registerNode(name, node) {
         node.name = name;
+        // biome-ignore lint/suspicious/noExplicitAny: cast required for heterogeneous node storage
         this.nodes.set(name, node);
         if (this.config.verbose) {
             console.log(`[WorkflowTestRunner] Registered node: ${name}`);
@@ -110,6 +118,7 @@ export class WorkflowTestRunner {
      * @param name - The node name as referenced in the workflow steps
      * @param handler - Async function that receives (input, ctx) and returns output
      */
+    // biome-ignore lint/suspicious/noExplicitAny: mock handler accepts arbitrary inputs/outputs
     mockNode(name, handler) {
         const mockNodeInstance = new MockNode(name, handler);
         this.nodes.set(name, mockNodeInstance);
@@ -154,6 +163,7 @@ export class WorkflowTestRunner {
      * @returns WorkflowTestResult with output, trace, and per-node results
      * @throws Error if no workflow is loaded or if a required node is not registered
      */
+    // biome-ignore lint/suspicious/noExplicitAny: test utility accepts arbitrary input data
     async execute(input, options) {
         if (!this.workflow) {
             throw new Error("No workflow loaded. Call loadWorkflow() first.");
@@ -189,6 +199,7 @@ export class WorkflowTestRunner {
             _PRIVATE_: {},
         };
         let workflowSuccess = true;
+        // biome-ignore lint/suspicious/noExplicitAny: error can be any type
         let workflowError = null;
         // Create a timeout promise
         const timeoutPromise = new Promise((_, reject) => {
@@ -312,6 +323,7 @@ export class WorkflowTestRunner {
             if (step.set_var) {
                 if (!ctx.vars)
                     ctx.vars = {};
+                // biome-ignore lint/suspicious/noExplicitAny: vars hold arbitrary workflow data
                 ctx.vars[step.name] = response.data;
             }
             traceEntry.success = true;

package/dist/testing/WorkflowTestRunner.js.map

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