@blokjs/runner 0.2.2 → 0.6.0

package/dist/SubworkflowNode.js

@@ -0,0 +1,479 @@
+import Configuration from "./Configuration";
+import RunnerNode from "./RunnerNode";
+import { RunTracker } from "./tracing/RunTracker";
+import { createChildContext } from "./utils/createChildContext";
+import { applyStepOutput } from "./workflow/PersistenceHelper";
+import { WorkflowRegistry } from "./workflow/WorkflowRegistry";
+/**
+ * Hard cap on `parent → child → grandchild → …` recursion. Bounds the
+ * blast radius of an accidental cycle (workflow A calls B calls A) or
+ * a legitimate-but-pathological deep nesting. Tunable via
+ * `BLOK_MAX_SUBWORKFLOW_DEPTH` env var; falls back to 10.
+ */
+function getMaxDepth() {
+    const raw = process.env.BLOK_MAX_SUBWORKFLOW_DEPTH;
+    if (typeof raw === "string" && raw.length > 0) {
+        const parsed = Number.parseInt(raw, 10);
+        if (Number.isInteger(parsed) && parsed > 0)
+            return parsed;
+    }
+    return 10;
+}
+/**
+ * G2 — resolve the deployment's self base URL for HTTP self-call
+ * dispatch. Reads `BLOK_SELF_BASE_URL` when set (recommended in
+ * containerized deployments where `localhost` is just the pod);
+ * otherwise defaults to `http://localhost:${PORT || 4000}` which
+ * works out-of-box for the dev orchestrator. Always trims a trailing
+ * slash so callers can `${base}${path}` without doubling.
+ *
+ * Exported for tests; production callers go through
+ * `SubworkflowNode.dispatchHttpSelf`.
+ */
+export function getSelfBaseUrl() {
+    const fromEnv = process.env.BLOK_SELF_BASE_URL;
+    if (typeof fromEnv === "string" && fromEnv.length > 0) {
+        return fromEnv.endsWith("/") ? fromEnv.slice(0, -1) : fromEnv;
+    }
+    const port = process.env.PORT && process.env.PORT.length > 0 ? process.env.PORT : "4000";
+    return `http://localhost:${port}`;
+}
+/**
+ * Internal ctx field that carries the current sub-workflow depth.
+ * Incremented by `SubworkflowNode.run` before invoking the child;
+ * read on entry to enforce the cap.
+ */
+const SUBWORKFLOW_DEPTH_KEY = "_subworkflowDepth";
+/**
+ * `SubworkflowNode` — the runner-side dispatch primitive that powers
+ * the v2 `subworkflow:` step shape. Looks up the named child workflow
+ * in the `WorkflowRegistry`, materializes a child `Configuration` +
+ * `Runner`, runs the child to completion in its own isolated `Context`,
+ * and returns the child's `ctx.response` as this step's `model.data`.
+ *
+ * **Composition with Tier 1**:
+ * - Parent step's `idempotencyKey` is consulted by `RunnerSteps` BEFORE
+ *   `SubworkflowNode.run` is even called — cache hit short-circuits the
+ *   entire sub-workflow (no child invocation, no side effects fire).
+ *   This is the headline pattern AND the documented footgun.
+ * - Parent step's `retry` retries the whole sub-workflow on failure;
+ *   each retry creates a fresh child run record under the same parent.
+ * - Replay re-creates fresh sub-run lineage automatically — the new
+ *   parent run invokes the sub-workflow fresh.
+ *
+ * **Lineage**: child's `WorkflowRun.parentRunId` and
+ * `WorkflowRun.parentNodeRunId` carry the parent run + step that
+ * invoked it. Studio renders a "called from #..." breadcrumb on the
+ * child and a "Sub-runs" list on the parent.
+ *
+ * **Recursion guard**: `BLOK_MAX_SUBWORKFLOW_DEPTH` (default 10) bounds
+ * cycle / deep-nesting blast radius. Throws a clear error past the cap.
+ */
+export class SubworkflowNode extends RunnerNode {
+    /**
+     * v0.7 — optional namespace prefix prepended to the resolved
+     * polymorphic name. Used by the Webhook trigger:
+     * `namespace: "stripe"` + `subworkflow: "js/ctx.req.body.type"`
+     * resolving to `"invoice.paid"` looks up `"stripe.invoice.paid"`.
+     * Static names are unaffected.
+     */
+    namespace;
+    /**
+     * G3 (v0.5) — exact-match allow-list for the workflow name dispatched
+     * by this step. When set, the **final** resolved name (after any
+     * polymorphic `js/...` evaluation AND the `namespace` prefix) must be
+     * in this array; otherwise the dispatch is rejected at run time with
+     * a structured error. Strongly recommended when `subworkflow` is an
+     * expression so a malicious or buggy ctx value can't escalate the
+     * workflow surface accessible to a request.
+     *
+     * `undefined` preserves pre-G3 behaviour (no constraint). Authors
+     * with literal `subworkflow:` strings have no reason to set this —
+     * the registry lookup already gates dispatch on the literal name.
+     */
+    allowList;
+    /**
+     * G2 (v0.6) — dispatch strategy.
+     *
+     * - `"in-process"` (default): the child workflow runs in the SAME
+     *   Node process — synchronous when `wait: true`, `setImmediate`-
+     *   based when `wait: false`. Cheapest, no extra hops; the historic
+     *   behaviour.
+     * - `"http-self"`: the child is dispatched as a fresh HTTP request
+     *   to the deployment's own base URL (resolved from
+     *   `BLOK_SELF_BASE_URL`, defaulting to `http://localhost:${PORT}`).
+     *   Use when each child run should land on a different process in
+     *   a horizontally-scaled deployment, or to fully isolate child
+     *   execution from the parent's call stack. The child MUST have an
+     *   HTTP trigger — a runtime error is thrown otherwise. Lineage
+     *   (parentRunId / parentNodeRunId / depth) is preserved across the
+     *   HTTP hop via `X-Blok-Parent-Run-Id` / `X-Blok-Parent-Node-Run-Id`
+     *   / `X-Blok-Subworkflow-Depth` headers that the receiving
+     *   HttpTrigger reads + threads into `tracker.startRun(...)`.
+     *
+     * Both modes integrate with `wait` and `idempotencyKey` identically
+     * (the cache lookup happens BEFORE `SubworkflowNode.run`).
+     */
+    dispatch;
+    /**
+     * Runner-wide options (carries the `nodes` registry that the child
+     * Configuration needs for `module` step resolution). Set by
+     * `Configuration.subworkflowResolver` before this node runs.
+     */
+    globalOptions;
+    async run(ctx) {
+        // === 1. Recursion guard ===
+        const depth = (ctx[SUBWORKFLOW_DEPTH_KEY] ?? 0) + 1;
+        const maxDepth = getMaxDepth();
+        if (depth > maxDepth) {
+            throw new Error(`[blok] Sub-workflow recursion limit exceeded (depth ${depth} > ${maxDepth}). Likely a cycle: workflow "${ctx.workflow_name}" called sub-workflow "${this.subworkflow}" too deep. Bump via BLOK_MAX_SUBWORKFLOW_DEPTH if intentional.`);
+        }
+        // === 2. Resolve the child workflow name (polymorphic v0.7) ===
+        // Static names ("send-receipt-email") are looked up directly.
+        // Mapper-expression names ("js/ctx.req.body.type", "$.req.body.type")
+        // are evaluated against the live ctx — the cleanest way to dispatch
+        // many handlers from one webhook / event router workflow without a
+        // big switch statement. Resolved names go through the same registry
+        // lookup as static names.
+        const resolvedName = await this.resolveSubworkflowName(ctx);
+        const registry = WorkflowRegistry.getInstance();
+        const entry = registry.get(resolvedName);
+        if (!entry) {
+            const known = registry.list().map((w) => w.name);
+            const knownStr = known.length > 0 ? known.join(", ") : "(none registered yet)";
+            throw new Error(`[blok] Sub-workflow "${resolvedName}" not found in WorkflowRegistry. Available: ${knownStr}. Workflows are registered automatically by the HTTP trigger at boot — make sure the child workflow file is in the scanned directory and has \`name: "${resolvedName}"\`.`);
+        }
+        // === 2.5. Registry-level authorization ===
+        // Default-allow when no hook is installed (preserves pre-v0.4.1
+        // behavior). Operators install a hook via
+        // WorkflowRegistry.getInstance().setAuthorizeFn(...) for
+        // multi-tenant access control. Throws on denial; the parent
+        // step's retry loop (if any) will retry — author should pin
+        // `retry: undefined` on sub-workflow steps where denial is
+        // permanent.
+        const allowed = await registry.authorize(ctx.workflow_name ?? "<unknown>", resolvedName, ctx);
+        if (!allowed) {
+            throw new Error(`[blok] Sub-workflow access denied: workflow "${ctx.workflow_name}" is not authorized to invoke "${resolvedName}". This denial came from the registry-level authorize hook (WorkflowRegistry.setAuthorizeFn). Adjust the hook to allow this composition, or remove the gate.`);
+        }
+        // === 2.6. G2 — HTTP self-call dispatch ===
+        // When `dispatch: "http-self"`, skip the in-process Configuration
+        // + Runner materialization entirely. The child workflow runs on
+        // the OTHER side of an HTTP request that goes through the
+        // deployment's own base URL, hitting whichever process picks it
+        // up. The receiving HttpTrigger registers the child run record;
+        // this side just makes the HTTP call.
+        if (this.dispatch === "http-self") {
+            return this.dispatchHttpSelf(ctx, entry, resolvedName, depth);
+        }
+        // === 3. Materialize child Configuration + Runner ===
+        // `preloaded` = entry.workflow skips the disk re-read; the
+        // normalizer still runs so v1→v2 conversion happens for legacy
+        // child workflows.
+        const childConfig = new Configuration();
+        await childConfig.init(entry.name, this.globalOptions, entry.workflow);
+        // Lazy import of Runner to avoid a circular dep
+        // (Configuration → RunnerNode → ... — Runner has its own chain).
+        const { default: Runner } = await import("./Runner");
+        const childRunner = new Runner(childConfig.steps);
+        // === 4. Build the child Context ===
+        // Parent step's resolved inputs (from blueprint mapper) live on
+        // `ctx.config[this.name].inputs` — the blueprint mapper has
+        // mutated the wrapper in place, so `js/...` and `$.<path>`
+        // expressions are now concrete values. These become the child's
+        // `request.body` so the child reads them via `$.req.body.<key>`
+        // exactly as if HTTP-triggered (function-call semantics).
+        const parentNodeConfig = ctx.config?.[this.name];
+        const parentInputs = parentNodeConfig?.inputs ?? {};
+        const childCtx = createChildContext(ctx, {
+            workflowName: entry.name,
+            workflowPath: entry.source,
+            body: parentInputs,
+            config: childConfig.nodes,
+        });
+        // Carry the depth counter forward so nested sub-workflows hit the cap.
+        childCtx[SUBWORKFLOW_DEPTH_KEY] = depth;
+        // === 5. Tracing — child gets its own run record + lineage ===
+        const tracker = RunTracker.getInstance();
+        const parentRunId = ctx._traceRunId;
+        const parentNodeRunId = ctx._traceNodeId;
+        const childTriggerSummary = `${ctx.workflow_name ?? "?"} → ${entry.name}`;
+        let childRunId;
+        if (tracker.active) {
+            const childRun = tracker.startRun({
+                workflowName: entry.name,
+                workflowPath: entry.source,
+                triggerType: "subworkflow",
+                triggerSummary: childTriggerSummary,
+                nodeCount: childConfig.steps.length,
+                parentRunId,
+                parentNodeRunId,
+            });
+            childRunId = childRun.id;
+            childCtx._traceRunId = childRun.id;
+        }
+        // === 6. Dispatch — sync or fire-and-forget based on `this.wait` ===
+        if (this.wait === false) {
+            return this.dispatchAsync(ctx, childRunner, childCtx, childRunId, entry.name);
+        }
+        // === 6a. Synchronous dispatch (wait: true / default) ===
+        try {
+            await childRunner.run(childCtx);
+            if (childRunId)
+                tracker.completeRun(childRunId, childCtx.response);
+        }
+        catch (err) {
+            if (childRunId)
+                tracker.failRun(childRunId, err);
+            throw err;
+        }
+        finally {
+            // PR 1 follow-up · A3 fix. Abort the listener-cleanup signal so
+            // the parent.signal listener (registered in createChildContext)
+            // auto-removes. Without this, listeners accumulate on long-lived
+            // parents that fire many sub-workflows.
+            const childPrivate = childCtx._PRIVATE_;
+            if (childPrivate?.listenerCleanup && !childPrivate.listenerCleanup.signal.aborted) {
+                childPrivate.listenerCleanup.abort();
+            }
+        }
+        // === 7. Apply parent persistence + return child's response ===
+        // Mirrors HTTP function-call semantics: parent reads child output
+        // at `$.state[<this.name>]`. Child author controls the shape via
+        // `@blokjs/respond` (or the last step's natural output).
+        //
+        // Persistence-helper call mirrors the RuntimeAdapterNode pattern
+        // (RuntimeAdapterNode.ts:100). The parent step's `as` / `spread`
+        // / `ephemeral` knobs apply identically here — sub-workflow
+        // output is just data, persistence rules are uniform.
+        const result = { success: !childCtx.response?.error, data: childCtx.response };
+        applyStepOutput(ctx, this, result);
+        return {
+            success: result.success,
+            data: childCtx.response,
+            error: childCtx.response?.error ?? null,
+        };
+    }
+    /**
+     * Fire-and-forget dispatch (Tier 2 #4 follow-up — `wait: false`).
+     *
+     * Schedules the child runner via `setImmediate` so the parent step
+     * can return immediately. Child errors are caught and routed to
+     * `tracker.failRun(childRunId, err)` — visible in Studio, NOT
+     * propagated to the parent step (which has already returned). Also
+     * logged via `console.error` for ops visibility.
+     *
+     * Parent step's output is the dispatch metadata `{runId,
+     * workflowName, scheduledAt}` — NOT the child's response (which
+     * doesn't exist yet). Caller polls `GET /__blok/runs/<runId>` for
+     * the actual outcome.
+     */
+    /**
+     * v0.7 PR 4 — resolve a (possibly polymorphic) sub-workflow name to
+     * the actual workflow name in the registry.
+     *
+     *   - Static names ("send-receipt-email") pass through unchanged.
+     *   - `js/...` expressions are evaluated against the live ctx —
+     *     `subworkflow: "js/ctx.req.body.type"` becomes `"invoice.paid"`
+     *     on a request with that body.
+     *   - `$.<path>` / `${...}` strings go through the same Mapper code
+     *     path as step inputs (the TS DSL compiles `$` to `"js/ctx..."`
+     *     by the time the workflow hits Configuration; this branch
+     *     handles authors who hand-wrote `$` in JSON).
+     *   - When `this.namespace` is set (from the parent workflow's
+     *     `trigger.webhook.namespace`), the resolved name is prefixed
+     *     as `"<namespace>.<resolvedName>"` — only when polymorphic
+     *     resolution fired AND the resolved name isn't already prefixed.
+     *
+     * Throws if the expression evaluates to anything other than a
+     * non-empty string — operators should see a clear "polymorphic
+     * subworkflow name resolved to <T>" error rather than a confusing
+     * "workflow not found" downstream.
+     */
+    async resolveSubworkflowName(ctx) {
+        const raw = this.subworkflow;
+        const isExpression = typeof raw === "string" && (raw.startsWith("js/") || raw.startsWith("$.") || raw.startsWith("${"));
+        let resolvedName;
+        if (!isExpression) {
+            resolvedName = raw;
+        }
+        else {
+            // Lazy import keeps the static dep graph between runner and
+            // shared minimal — most steps don't dispatch sub-workflows.
+            const { mapper } = await import("@blokjs/shared");
+            // Normalise `$.<path>` → `js/ctx.<path>` so Mapper.replaceString
+            // evaluates it. Authors who wrote `js/...` go straight through.
+            let expr = raw;
+            if (expr.startsWith("$.")) {
+                expr = `js/ctx.${expr.slice(2)}`;
+            }
+            else if (expr.startsWith("$")) {
+                expr = `js/${expr.slice(1)}`;
+            }
+            const resolved = mapper.replaceString(expr, ctx, {});
+            if (typeof resolved !== "string" || resolved.length === 0) {
+                throw new Error(`[blok] Polymorphic sub-workflow name "${raw}" resolved to ${JSON.stringify(resolved)} (expected a non-empty string). Check the expression and the runtime value of ctx.`);
+            }
+            resolvedName = resolved;
+        }
+        // Namespace prefix — applies to polymorphic resolutions when set on
+        // the parent workflow's trigger (today: webhook namespace). Static
+        // names skip prefixing so they stay routable by their literal name.
+        if (isExpression && this.namespace && this.namespace.length > 0 && !resolvedName.startsWith(`${this.namespace}.`)) {
+            resolvedName = `${this.namespace}.${resolvedName}`;
+        }
+        // G3 allow-list enforcement. Checked after namespace prefixing so
+        // the value an author writes in the list matches the registry name
+        // they intend to permit. Polymorphic dispatch without an allow-list
+        // is still allowed (matches pre-G3 behaviour); the schema's
+        // describe() recommends pairing them in production.
+        if (this.allowList && this.allowList.length > 0 && !this.allowList.includes(resolvedName)) {
+            throw new Error(`[blok] Sub-workflow dispatch blocked: resolved name "${resolvedName}" is not in the step's \`allowList\` [${this.allowList.map((n) => `"${n}"`).join(", ")}]. Add it to the list if the dispatch is intended, or audit the workflow whose ctx produced this name.`);
+        }
+        return resolvedName;
+    }
+    /**
+     * G2 (v0.6) — HTTP self-call dispatch.
+     *
+     * Replaces the in-process child Configuration / Runner / Context
+     * with an HTTP request to the deployment's own base URL. The
+     * receiving HttpTrigger materializes the child as if it were a
+     * fresh request — registers its own run record, runs the workflow,
+     * returns the response.
+     *
+     * - `wait: true` (default) — `fetch` is awaited. The HTTP response
+     *   body becomes this step's `model.data`. A non-2xx response is
+     *   treated as failure (mirrors the in-process error propagation).
+     * - `wait: false` — `fetch` is fired-and-forgotten. The promise's
+     *   rejection is caught + logged. Parent step's output is
+     *   `{runId: null, workflowName, scheduledAt}` — the child's runId
+     *   isn't known on this side until the receiver actually creates
+     *   the run record. Studio's Sub-runs strip surfaces the child
+     *   once it lands.
+     *
+     * Lineage (parentRunId / parentNodeRunId / depth) crosses the HTTP
+     * boundary via headers that the receiving HttpTrigger reads + threads
+     * into `tracker.startRun(...)`. Same end-result as the in-process
+     * path: child's `WorkflowRun` carries the parent ids so Studio renders
+     * the breadcrumbs.
+     */
+    async dispatchHttpSelf(parentCtx, entry, resolvedName, depth) {
+        // === 1. Validate the child has an HTTP trigger ===
+        const childWorkflow = entry.workflow;
+        const httpTrigger = childWorkflow?.trigger?.http;
+        if (!httpTrigger || typeof httpTrigger.path !== "string" || httpTrigger.path.length === 0) {
+            throw new Error(`[blok] Sub-workflow dispatch failed: \`dispatch: "http-self"\` requires the child workflow "${resolvedName}" to have an HTTP trigger with an explicit \`trigger.http.path\`. Switch the step to \`dispatch: "in-process"\` (or omit the field) for non-HTTP children, or add an HTTP trigger to the child.`);
+        }
+        const method = (httpTrigger.method ?? "POST").toUpperCase();
+        const path = httpTrigger.path.startsWith("/") ? httpTrigger.path : `/${httpTrigger.path}`;
+        // === 2. Resolve the deployment's self base URL ===
+        const baseUrl = getSelfBaseUrl();
+        const url = `${baseUrl}${path}`;
+        // === 3. Build lineage headers ===
+        const parentRunId = parentCtx._traceRunId;
+        const parentNodeRunId = parentCtx._traceNodeId;
+        const headers = {
+            "content-type": "application/json",
+            // Receiving HttpTrigger reads these in `runWorkflowExecution`
+            // and threads them into `tracker.startRun({parentRunId, ...})`.
+            // Same shape as the existing `X-Blok-Replay-Of` plumbing.
+            "X-Blok-Subworkflow-Depth": String(depth),
+        };
+        if (parentRunId)
+            headers["X-Blok-Parent-Run-Id"] = parentRunId;
+        if (parentNodeRunId)
+            headers["X-Blok-Parent-Node-Run-Id"] = parentNodeRunId;
+        // === 4. Parent step's resolved inputs become the request body ===
+        const parentNodeConfig = parentCtx.config?.[this.name];
+        const parentInputs = parentNodeConfig?.inputs ?? {};
+        const body = JSON.stringify(parentInputs);
+        // === 5. Fire-and-forget (wait: false) ===
+        if (this.wait === false) {
+            const scheduledAt = Date.now();
+            fetch(url, { method, headers, body }).catch((err) => {
+                console.error(`[blok][subworkflow] http-self dispatch to ${url} failed (wait:false):`, err instanceof Error ? err.stack || err.message : err);
+            });
+            const dispatchData = {
+                runId: null, // unknown on this side — receiving trigger creates the record
+                workflowName: entry.name,
+                scheduledAt,
+                dispatch: "http-self",
+                url,
+            };
+            const result = { success: true, data: dispatchData };
+            applyStepOutput(parentCtx, this, result);
+            return {
+                success: true,
+                data: dispatchData,
+                error: null,
+            };
+        }
+        // === 6. Synchronous (wait: true) ===
+        let response;
+        try {
+            response = await fetch(url, { method, headers, body });
+        }
+        catch (err) {
+            // Network-level failure: connection refused, DNS, etc.
+            throw new Error(`[blok] Sub-workflow http-self dispatch to ${url} failed: ${err instanceof Error ? err.message : String(err)}. The deployment's self base URL is "${baseUrl}" (set via BLOK_SELF_BASE_URL or defaulted from PORT). Make sure the trigger is listening + the URL is reachable from THIS process.`);
+        }
+        const responseText = await response.text();
+        let responseBody;
+        try {
+            responseBody = responseText.length > 0 ? JSON.parse(responseText) : undefined;
+        }
+        catch {
+            responseBody = responseText;
+        }
+        if (!response.ok) {
+            throw new Error(`[blok] Sub-workflow http-self dispatch returned ${response.status} ${response.statusText} from ${url}. Body: ${typeof responseBody === "string" ? responseBody.slice(0, 500) : JSON.stringify(responseBody).slice(0, 500)}`);
+        }
+        const resp = { success: true, data: responseBody, error: null };
+        const result = { success: true, data: responseBody };
+        applyStepOutput(parentCtx, this, result);
+        return resp;
+    }
+    dispatchAsync(parentCtx, childRunner, childCtx, childRunId, childWorkflowName) {
+        const scheduledAt = Date.now();
+        const tracker = RunTracker.getInstance();
+        setImmediate(() => {
+            void (async () => {
+                try {
+                    await childRunner.run(childCtx);
+                    if (childRunId)
+                        tracker.completeRun(childRunId, childCtx.response);
+                }
+                catch (err) {
+                    if (childRunId) {
+                        tracker.failRun(childRunId, err instanceof Error ? err : new Error(String(err)));
+                    }
+                    console.error(`[blok][subworkflow] async child '${childWorkflowName}' (run ${childRunId ?? "?"}) failed:`, err instanceof Error ? err.stack || err.message : err);
+                }
+                finally {
+                    // PR 1 follow-up · A3 fix. Same listener-cleanup hook as the
+                    // sync path so async sub-workflows also auto-remove the
+                    // parent.signal listener on completion.
+                    const childPrivate = childCtx._PRIVATE_;
+                    if (childPrivate?.listenerCleanup && !childPrivate.listenerCleanup.signal.aborted) {
+                        childPrivate.listenerCleanup.abort();
+                    }
+                }
+            })();
+        });
+        // Parent step's output: dispatch metadata (the runId is the
+        // canonical handle for at-most-once dispatch deduplication when
+        // combined with `idempotencyKey`).
+        const dispatchData = {
+            runId: childRunId ?? null,
+            workflowName: childWorkflowName,
+            scheduledAt,
+        };
+        const result = { success: true, data: dispatchData };
+        applyStepOutput(parentCtx, this, result);
+        return {
+            success: true,
+            data: dispatchData,
+            error: null,
+        };
+    }
+}
+//# sourceMappingURL=SubworkflowNode.js.map

package/dist/SubworkflowNode.js.map

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

package/dist/SwitchNode.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SwitchNode — v0.5 primitive. N-way branch keyed on a value. First
+ * matching case wins; an optional `default` block runs when no case
+ * matches.
+ *
+ * The runtime config is read from `ctx.config[this.name]`:
+ *   {
+ *     on: unknown,                                      // resolved by mapper
+ *     cases: [{ when, steps: NodeBase[] }],             // pre-resolved by Configuration
+ *     default?: NodeBase[],                             // pre-resolved
+ *   }
+ *
+ * Match semantics:
+ * - `when` is a literal scalar (string/number/boolean) → match if `on === when`.
+ * - `when` is an array → match if `array.includes(on)` (group related cases).
+ *
+ * Mutations to state inside the matched case's sub-pipeline DO carry
+ * forward to subsequent top-level steps — switch is a passthrough flow,
+ * NOT an isolation boundary like forEach. The matched case's last step
+ * output becomes the switch step's `response.data`.
+ *
+ * If no case matches and there's no default, the step is a no-op
+ * (success, data: null).
+ *
+ * v0.6 Phase 4 — switch + wait support. The cursor schema
+ * (`SwitchIterationContext`) records `caseIndex` (or -1 for `default`)
+ * plus `innerStepIndex` within that arm. On re-entry after a wait,
+ * SwitchNode reads its cursor from the rehydrated map (keyed by its
+ * own NodeRun id), walks back into the matched arm at the right step,
+ * and ignores the `on` value entirely — we already committed to a
+ * specific arm in the first pass.
+ */
+import type { Context, ResponseContext } from "@blokjs/shared";
+import RunnerNode from "./RunnerNode";
+export declare class SwitchNode extends RunnerNode {
+    run(ctx: Context): Promise<ResponseContext>;
+}