@blokjs/runner 0.4.0 → 0.6.0

package/dist/SubworkflowNode.js

@@ -19,6 +19,25 @@ function getMaxDepth() {
     }
     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;
@@ -51,6 +70,51 @@ const SUBWORKFLOW_DEPTH_KEY = "_subworkflowDepth";
  * 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
@@ -64,13 +128,42 @@ export class SubworkflowNode extends RunnerNode {
         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. Look up the child workflow ===
+        // === 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(this.subworkflow);
+        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 "${this.subworkflow}" 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: "${this.subworkflow}"\`.`);
+            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
@@ -174,6 +267,171 @@ export class SubworkflowNode extends RunnerNode {
      * 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();

package/dist/SubworkflowNode.js.map

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

package/dist/SwitchNode.js

@@ -0,0 +1,153 @@
+/**
+ * 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 RunnerNode from "./RunnerNode";
+import { consumeRehydratedCursor, popPrimitiveFrame, pushPrimitiveFrame, readRehydratedCursor, } from "./runtime/PrimitiveStack";
+import { applyStepOutput } from "./workflow/PersistenceHelper";
+/** Sentinel `caseIndex` value meaning "the `default` arm matched". */
+const DEFAULT_ARM = -1;
+function caseMatches(when, on) {
+    if (Array.isArray(when)) {
+        return when.some((w) => w === on);
+    }
+    return when === on;
+}
+export class SwitchNode extends RunnerNode {
+    async run(ctx) {
+        this.contentType = "application/json";
+        const response = { success: true, data: null, error: null };
+        const opts = (ctx.config?.[this.name] ?? {});
+        const on = opts.on;
+        const cases = Array.isArray(opts.cases) ? opts.cases : [];
+        const defaultSteps = Array.isArray(opts.default) ? opts.default : undefined;
+        // v0.6 Phase 4 — resume cursor lookup. On re-entry from a wait
+        // fired inside a switch case, the persisted NodeRun's
+        // iteration_context carries the matched arm + inner step index.
+        const ctxAny = ctx;
+        const myNodeRunId = ctxAny._traceNodeId;
+        // Phase 4 — lookup by step NAME (stable across re-entries).
+        const resumeRaw = readRehydratedCursor(ctx, this.name);
+        const resume = resumeRaw && resumeRaw.mode === "switch" ? resumeRaw : undefined;
+        if (resume) {
+            consumeRehydratedCursor(ctx, this.name);
+        }
+        // Case selection. On resume, skip re-evaluating the `when`
+        // expressions — we've already committed to a specific arm and
+        // `on` could have changed mid-flight (different ctx state after
+        // pre-wait mutations). Walk straight back into the cached arm.
+        let selected;
+        let selectedCaseIndex = DEFAULT_ARM;
+        if (resume !== undefined) {
+            if (resume.caseIndex === DEFAULT_ARM) {
+                selected = defaultSteps;
+            }
+            else if (resume.caseIndex >= 0 && resume.caseIndex < cases.length) {
+                selected = cases[resume.caseIndex].steps;
+                selectedCaseIndex = resume.caseIndex;
+            }
+            // Cursor pointed at an arm that no longer exists (case removed
+            // between deploys, etc.). Fall through to fresh first-match
+            // behaviour — better than crashing the resume.
+        }
+        if (selected === undefined && resume === undefined) {
+            for (let idx = 0; idx < cases.length; idx++) {
+                if (caseMatches(cases[idx].when, on)) {
+                    selected = cases[idx].steps;
+                    selectedCaseIndex = idx;
+                    break;
+                }
+            }
+            if (selected === undefined) {
+                selected = defaultSteps;
+                if (selected !== undefined)
+                    selectedCaseIndex = DEFAULT_ARM;
+            }
+        }
+        if (selected === undefined || selected.length === 0) {
+            // No matching case + no default → no-op success. State
+            // entry is `null` so downstream `$.state[<id>]` reads return
+            // null (not undefined) — keeps the persistence model uniform.
+            applyStepOutput(ctx, this, { data: null });
+            // Preserve the previous step's ctx.response so the NEXT
+            // top-level step doesn't dereference null when RunnerSteps
+            // assigns `ctx.response.contentType`.
+            response.data = ctx.response;
+            return response;
+        }
+        // v0.6 Phase 4 — push a primitive frame so a nested wait fired
+        // inside this case's sub-pipeline persists the cursor on
+        // THIS switch's NodeRun. `innerStepIndex` is updated at each
+        // step boundary inside the case body by RunnerSteps; we just
+        // keep `caseIndex` pinned for the duration of this run.
+        const initialCursor = {
+            mode: "switch",
+            caseIndex: selectedCaseIndex,
+            innerStepIndex: resume?.innerStepIndex ?? 0,
+            completedResults: [],
+        };
+        const frame = myNodeRunId
+            ? { nodeRunId: myNodeRunId, cursor: initialCursor }
+            : undefined;
+        if (frame)
+            pushPrimitiveFrame(ctx, frame);
+        try {
+            // Lazy import — same circular-dep guard ForEach/Loop use.
+            const { default: Runner } = await import("./Runner");
+            const runner = new Runner(selected);
+            // On resume, pass the inner-step resume index — INCLUDING
+            // the index-0 case where the wait is the very first step
+            // of the matched arm. The deep runSteps' wait re-entry
+            // detection uses `innerResumeIndex !== undefined` as the
+            // "this primitive resumed here" signal (Phase 4 fix).
+            if (resume) {
+                ctxAny._blokInnerResumeIndex = resume.innerStepIndex;
+            }
+            // `deep: true` so the inner runSteps doesn't inherit the
+            // outer run's `lastCompletedStepIndex` cursor (PR 4 wait/
+            // resume logic).
+            await runner.run(ctx, { deep: true, stepName: this.name });
+            // Switch is a passthrough — the matched case ran on the
+            // parent ctx, so state mutations are already visible to
+            // downstream steps. The switch step's own data is the last
+            // inner step's response.
+            const data = ctx.response;
+            response.data = data;
+            applyStepOutput(ctx, this, { data });
+            return response;
+        }
+        finally {
+            if (frame)
+                popPrimitiveFrame(ctx);
+        }
+    }
+}
+//# sourceMappingURL=SwitchNode.js.map

package/dist/SwitchNode.js.map

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

package/dist/TriggerBase.d.ts

@@ -11,6 +11,7 @@ import { PrometheusMetricsBridge } from "./monitoring/PrometheusMetricsBridge";
 import { RateLimiter } from "./monitoring/RateLimiter";
 import type { RateLimitConfig, RateLimitResult } from "./monitoring/RateLimiter";
 import { TriggerMetricsCollector } from "./monitoring/TriggerMetricsCollector";
+import type GlobalOptions from "./types/GlobalOptions";
 import type TriggerResponse from "./types/TriggerResponse";
 /**
  * Tier 2 quick-wins follow-up · structural logger interface used by
@@ -71,6 +72,55 @@ export default abstract class TriggerBase extends Trigger {
      * the class name doesn't naturally produce the right tag.
      */
     protected getTriggerType(): string;
+    /**
+     * v0.6 — apply the merged middleware chain (process-global → workflow-level
+     * → trigger-level) to `ctx` before the main workflow body runs.
+     *
+     * Trigger-level names are read from
+     * `this.configuration.trigger[<this.getTriggerType()>].middleware`, so
+     * HttpTrigger reads `trigger.http.middleware`, WorkerTrigger reads
+     * `trigger.worker.middleware`, CronTrigger reads `trigger.cron.middleware`.
+     *
+     * Pre-v0.6 the merge code lived inline in `HttpTrigger.run` and worker
+     * + cron triggers silently skipped middleware. Centralising it on
+     * TriggerBase gives all three trigger families uniform semantics.
+     *
+     * Resolution order outer→inner:
+     *   process-global → workflow-level → trigger-level → main workflow body.
+     *
+     * State mutations from earlier middleware (e.g. `ctx.state.identity`
+     * from auth-check) carry forward to later middleware and the main
+     * workflow because they share the same ctx. Middleware authors
+     * short-circuit via `@blokjs/throw` — the throw propagates to the
+     * caller's outer catch, and the main workflow does NOT run.
+     */
+    protected applyMiddlewareChain(ctx: Context, nodeMap: GlobalOptions): Promise<void>;
+    /**
+     * v0.6 — dispatch a chain of middleware workflows on the same parent
+     * ctx. Each entry in `names` is the `name:` of a workflow registered
+     * with `middleware: true`. For each:
+     *
+     * - Materialise a fresh `Configuration` for the middleware (resolves
+     *   its inner steps + nodes against `nodeMap` so `@blokjs/throw`
+     *   etc. resolve from `@blokjs/helpers`).
+     * - Save the parent ctx.config; swap in the middleware's resolved
+     *   `mwConfig.nodes` so the blueprint mapper finds the middleware's
+     *   step inputs.
+     * - Run via `new Runner(...).run(ctx, { deep: true })` — `deep: true`
+     *   prevents the inner runSteps from inheriting the outer run's
+     *   `lastCompletedStepIndex` cursor (PR 4 wait/resume hazard).
+     * - Restore parent ctx.config in `finally`.
+     *
+     * Missing middleware (name not registered) is a configuration error
+     * — throws a clear message naming the unknown middleware. Authors
+     * typically use `@blokjs/throw` inside middleware with a `code:` to
+     * produce structured HTTP responses (e.g. 401) — those throws
+     * propagate to the outer catch in the calling trigger.
+     *
+     * Pre-v0.6 this lived as a private method on `HttpTrigger`. Lifted
+     * here so worker + cron triggers can reuse it without duplication.
+     */
+    protected runMiddlewareChain(ctx: Context, names: readonly string[], nodeMap: GlobalOptions): Promise<void>;
     /** Flag — set true after `installCrashHandlers` has run once in this process. */
     private static crashHandlersInstalled;
     /**