@blokjs/helper 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -5,10 +5,14 @@ import Step from "./components/StepNode";
 import Trigger from "./components/Trigger";
 import Workflow from "./components/Workflow";
 import { type BranchOpts, branch } from "./components/branch";
+import { type ForEachOpts, forEach } from "./components/forEach";
+import { type LoopOpts, loop } from "./components/loop";
+import { type SwitchCase, type SwitchOpts, switchOn } from "./components/switchOn";
+import { type TryCatchOpts, tryCatch } from "./components/tryCatch";
 import { type WorkflowV2Builder, type WorkflowOpts as WorkflowV2Opts, workflow } from "./components/workflowV2";
 import { $, type DollarProxy, type ExprPath, JS_EXPR_TAG, unwrapProxies } from "./proxy/$";
-import { NodeType, NodeTypeSchema, RetryConfig, RetryConfigSchema, RuntimeKind, RuntimeKindSchema, StepInputs, StepOpts, V2BranchStep, V2BranchStepSchema, V2RegularStep, V2RegularStepSchema, V2Step, V2StepSchema, V2SubworkflowStep, V2SubworkflowStepSchema, V2WaitStep, V2WaitStepSchema, isBranchStep, isSubworkflowStep, isWaitStep } from "./types/StepOpts";
-import { AnyTriggerOpts, ConcurrencyOpts, ConcurrencyOptsFields, ConcurrencyOptsSchema, CronTriggerOpts, CronTriggerOptsSchema, DebounceOpts, DebounceOptsSchema, HTTP_METHODS, HttpMethod, HttpMethodSchema, HttpTriggerOpts, HttpTriggerOptsSchema, PubSubProvider, PubSubProviderSchema, PubSubTriggerOpts, PubSubTriggerOptsSchema, QueueProvider, QueueProviderSchema, QueueTriggerOpts, QueueTriggerOptsSchema, SSETriggerOpts, SSETriggerOptsSchema, SchedulingOpts, SchedulingOptsFields, SchedulingOptsSchema, TRIGGER_SCHEMAS, TriggerConfigMap, TriggerOpts, TriggerOptsSchema, TriggersEnum, TriggersSchema, WebSocketTriggerOpts, WebSocketTriggerOptsSchema, WebhookTriggerOpts, WebhookTriggerOptsSchema, WorkerTriggerOpts, WorkerTriggerOptsSchema, concurrencyRefinement, makeSchedulingRefinement, validateTriggerConfig } from "./types/TriggerOpts";
+import { NodeType, NodeTypeSchema, RetryConfig, RetryConfigSchema, RuntimeKind, RuntimeKindSchema, StepInputs, StepOpts, V2BranchStep, V2BranchStepSchema, V2ForEachStep, V2ForEachStepSchema, V2LoopStep, V2LoopStepSchema, V2RegularStep, V2RegularStepSchema, V2Step, V2StepSchema, V2SubworkflowStep, V2SubworkflowStepSchema, V2SwitchStep, V2SwitchStepSchema, V2TryCatchStep, V2TryCatchStepSchema, V2WaitStep, V2WaitStepSchema, isBranchStep, isForEachStep, isLoopStep, isSubworkflowStep, isSwitchStep, isTryCatchStep, isWaitStep } from "./types/StepOpts";
+import { AnyTriggerOpts, ConcurrencyOpts, ConcurrencyOptsFields, ConcurrencyOptsSchema, CronTriggerOpts, CronTriggerOptsSchema, DebounceOpts, DebounceOptsSchema, HTTP_METHODS, HttpMethod, HttpMethodSchema, HttpTriggerOpts, HttpTriggerOptsSchema, PubSubProvider, PubSubProviderSchema, PubSubTriggerOpts, PubSubTriggerOptsSchema, QueueProvider, QueueProviderSchema, QueueTriggerOpts, QueueTriggerOptsSchema, SSETriggerOpts, SSETriggerOptsSchema, SchedulingOpts, SchedulingOptsFields, SchedulingOptsSchema, TRIGGER_SCHEMAS, TriggerConfigMap, TriggerOpts, TriggerOptsSchema, TriggersEnum, TriggersSchema, WebSocketTriggerOpts, WebSocketTriggerOptsSchema, WebhookTriggerOpts, WebhookTriggerOptsSchema, WorkerProvider, WorkerProviderSchema, WorkerTriggerOpts, WorkerTriggerOptsSchema, concurrencyRefinement, makeSchedulingRefinement, validateTriggerConfig } from "./types/TriggerOpts";
 import { WorkflowV2, WorkflowV2Schema } from "./types/WorkflowOpts";
 import { parseDuration, tryParseDuration } from "./utils/parseDuration";
-export { AddElse, AddIf, ConditionOpts, HelperResponse, NodeType, NodeTypeSchema, RuntimeKind, RuntimeKindSchema, Step, StepInputs, StepOpts, Trigger, Workflow, workflow, branch, $, unwrapProxies, type BranchOpts, type WorkflowV2Opts, type WorkflowV2Builder, type DollarProxy, type ExprPath, JS_EXPR_TAG, V2Step, V2StepSchema, V2RegularStep, V2RegularStepSchema, V2BranchStep, V2BranchStepSchema, isBranchStep, V2SubworkflowStep, V2SubworkflowStepSchema, isSubworkflowStep, V2WaitStep, V2WaitStepSchema, isWaitStep, RetryConfig, RetryConfigSchema, WorkflowV2, WorkflowV2Schema, HTTP_METHODS, HttpMethod, HttpMethodSchema, ConcurrencyOpts, ConcurrencyOptsFields, ConcurrencyOptsSchema, concurrencyRefinement, DebounceOpts, DebounceOptsSchema, makeSchedulingRefinement, SchedulingOpts, SchedulingOptsFields, SchedulingOptsSchema, HttpTriggerOpts, HttpTriggerOptsSchema, TriggerOpts, TriggerOptsSchema, QueueProvider, QueueProviderSchema, QueueTriggerOpts, QueueTriggerOptsSchema, PubSubProvider, PubSubProviderSchema, PubSubTriggerOpts, PubSubTriggerOptsSchema, WorkerTriggerOpts, WorkerTriggerOptsSchema, CronTriggerOpts, CronTriggerOptsSchema, WebhookTriggerOpts, WebhookTriggerOptsSchema, WebSocketTriggerOpts, WebSocketTriggerOptsSchema, SSETriggerOpts, SSETriggerOptsSchema, TriggersSchema, TriggersEnum, TriggerConfigMap, TRIGGER_SCHEMAS, AnyTriggerOpts, validateTriggerConfig, parseDuration, tryParseDuration, };
+export { AddElse, AddIf, ConditionOpts, HelperResponse, NodeType, NodeTypeSchema, RuntimeKind, RuntimeKindSchema, Step, StepInputs, StepOpts, Trigger, Workflow, workflow, branch, forEach, loop, switchOn, tryCatch, $, unwrapProxies, type BranchOpts, type ForEachOpts, type LoopOpts, type SwitchOpts, type SwitchCase, type TryCatchOpts, type WorkflowV2Opts, type WorkflowV2Builder, type DollarProxy, type ExprPath, JS_EXPR_TAG, V2Step, V2StepSchema, V2RegularStep, V2RegularStepSchema, V2BranchStep, V2BranchStepSchema, isBranchStep, V2SubworkflowStep, V2SubworkflowStepSchema, isSubworkflowStep, V2WaitStep, V2WaitStepSchema, isWaitStep, V2ForEachStep, V2ForEachStepSchema, isForEachStep, V2LoopStep, V2LoopStepSchema, isLoopStep, V2SwitchStep, V2SwitchStepSchema, isSwitchStep, V2TryCatchStep, V2TryCatchStepSchema, isTryCatchStep, RetryConfig, RetryConfigSchema, WorkflowV2, WorkflowV2Schema, HTTP_METHODS, HttpMethod, HttpMethodSchema, ConcurrencyOpts, ConcurrencyOptsFields, ConcurrencyOptsSchema, concurrencyRefinement, DebounceOpts, DebounceOptsSchema, makeSchedulingRefinement, SchedulingOpts, SchedulingOptsFields, SchedulingOptsSchema, HttpTriggerOpts, HttpTriggerOptsSchema, TriggerOpts, TriggerOptsSchema, QueueProvider, QueueProviderSchema, QueueTriggerOpts, QueueTriggerOptsSchema, PubSubProvider, PubSubProviderSchema, PubSubTriggerOpts, PubSubTriggerOptsSchema, WorkerProvider, WorkerProviderSchema, WorkerTriggerOpts, WorkerTriggerOptsSchema, CronTriggerOpts, CronTriggerOptsSchema, WebhookTriggerOpts, WebhookTriggerOptsSchema, WebSocketTriggerOpts, WebSocketTriggerOptsSchema, SSETriggerOpts, SSETriggerOptsSchema, TriggersSchema, TriggersEnum, TriggerConfigMap, TRIGGER_SCHEMAS, AnyTriggerOpts, validateTriggerConfig, parseDuration, tryParseDuration, };

package/dist/index.js

@@ -5,23 +5,29 @@ import Step from "./components/StepNode";
 import Trigger from "./components/Trigger";
 import Workflow from "./components/Workflow";
 import { branch } from "./components/branch";
+import { forEach } from "./components/forEach";
+import { loop } from "./components/loop";
+import { switchOn } from "./components/switchOn";
+import { tryCatch } from "./components/tryCatch";
 import { workflow } from "./components/workflowV2";
 import { $, JS_EXPR_TAG, unwrapProxies } from "./proxy/$";
-import { NodeTypeSchema, RetryConfigSchema, RuntimeKindSchema, V2BranchStepSchema, V2RegularStepSchema, V2StepSchema, V2SubworkflowStepSchema, V2WaitStepSchema, isBranchStep, isSubworkflowStep, isWaitStep, } from "./types/StepOpts";
+import { NodeTypeSchema, RetryConfigSchema, RuntimeKindSchema, V2BranchStepSchema, V2ForEachStepSchema, V2LoopStepSchema, V2RegularStepSchema, V2StepSchema, V2SubworkflowStepSchema, V2SwitchStepSchema, V2TryCatchStepSchema, V2WaitStepSchema, isBranchStep, isForEachStep, isLoopStep, isSubworkflowStep, isSwitchStep, isTryCatchStep, isWaitStep, } from "./types/StepOpts";
 import { ConcurrencyOptsFields, ConcurrencyOptsSchema, CronTriggerOptsSchema, DebounceOptsSchema, 
 // HTTP method enum (canonical names + legacy * preprocess)
 HTTP_METHODS, HttpMethodSchema, HttpTriggerOptsSchema, PubSubProviderSchema, PubSubTriggerOptsSchema, QueueProviderSchema, QueueTriggerOptsSchema, SSETriggerOptsSchema, SchedulingOptsFields, SchedulingOptsSchema, 
 // Trigger registry
 TRIGGER_SCHEMAS, TriggerOptsSchema, 
 // Triggers enum
-TriggersSchema, WebSocketTriggerOptsSchema, WebhookTriggerOptsSchema, WorkerTriggerOptsSchema, concurrencyRefinement, makeSchedulingRefinement, validateTriggerConfig, } from "./types/TriggerOpts";
+TriggersSchema, WebSocketTriggerOptsSchema, WebhookTriggerOptsSchema, WorkerProviderSchema, WorkerTriggerOptsSchema, concurrencyRefinement, makeSchedulingRefinement, validateTriggerConfig, } from "./types/TriggerOpts";
 import { WorkflowV2Schema } from "./types/WorkflowOpts";
 import { parseDuration, tryParseDuration } from "./utils/parseDuration";
 export { AddElse, AddIf, HelperResponse, NodeTypeSchema, RuntimeKindSchema, Step, Trigger, Workflow, 
 // v2 DSL primitives — the canonical authoring surface
-workflow, branch, $, unwrapProxies, JS_EXPR_TAG, V2StepSchema, V2RegularStepSchema, V2BranchStepSchema, isBranchStep, V2SubworkflowStepSchema, isSubworkflowStep, V2WaitStepSchema, isWaitStep, RetryConfigSchema, WorkflowV2Schema, 
+workflow, branch, 
+// v0.5 control-flow primitives
+forEach, loop, switchOn, tryCatch, $, unwrapProxies, JS_EXPR_TAG, V2StepSchema, V2RegularStepSchema, V2BranchStepSchema, isBranchStep, V2SubworkflowStepSchema, isSubworkflowStep, V2WaitStepSchema, isWaitStep, V2ForEachStepSchema, isForEachStep, V2LoopStepSchema, isLoopStep, V2SwitchStepSchema, isSwitchStep, V2TryCatchStepSchema, isTryCatchStep, RetryConfigSchema, WorkflowV2Schema, 
 // HTTP method enum
-HTTP_METHODS, HttpMethodSchema, ConcurrencyOptsFields, ConcurrencyOptsSchema, concurrencyRefinement, DebounceOptsSchema, makeSchedulingRefinement, SchedulingOptsFields, SchedulingOptsSchema, HttpTriggerOptsSchema, TriggerOptsSchema, QueueProviderSchema, QueueTriggerOptsSchema, PubSubProviderSchema, PubSubTriggerOptsSchema, WorkerTriggerOptsSchema, CronTriggerOptsSchema, WebhookTriggerOptsSchema, WebSocketTriggerOptsSchema, SSETriggerOptsSchema, TriggersSchema, TRIGGER_SCHEMAS, validateTriggerConfig, 
+HTTP_METHODS, HttpMethodSchema, ConcurrencyOptsFields, ConcurrencyOptsSchema, concurrencyRefinement, DebounceOptsSchema, makeSchedulingRefinement, SchedulingOptsFields, SchedulingOptsSchema, HttpTriggerOptsSchema, TriggerOptsSchema, QueueProviderSchema, QueueTriggerOptsSchema, PubSubProviderSchema, PubSubTriggerOptsSchema, WorkerProviderSchema, WorkerTriggerOptsSchema, CronTriggerOptsSchema, WebhookTriggerOptsSchema, WebSocketTriggerOptsSchema, SSETriggerOptsSchema, TriggersSchema, TRIGGER_SCHEMAS, validateTriggerConfig, 
 // Duration parser (Tier 2 #5 + #7)
 parseDuration, tryParseDuration, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,sBAAsB,CAAC;AAC3C,OAAO,KAAwB,MAAM,oBAAoB,CAAC;AAC1D,OAAO,cAAc,MAAM,6BAA6B,CAAC;AACzD,OAAO,IAAI,MAAM,uBAAuB,CAAC;AACzC,OAAO,OAAO,MAAM,sBAAsB,CAAC;AAC3C,OAAO,QAAQ,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAmB,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAA+D,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAChH,OAAO,EAAE,CAAC,EAAmC,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAEN,cAAc,EAEd,iBAAiB,EAEjB,iBAAiB,EAIjB,kBAAkB,EAElB,mBAAmB,EAEnB,YAAY,EAEZ,uBAAuB,EAEvB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,UAAU,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIN,qBAAqB,EACrB,qBAAqB,EAGrB,qBAAqB,EAGrB,kBAAkB;AAClB,2DAA2D;AAC3D,YAAY,EAGZ,gBAAgB,EAEhB,qBAAqB,EAGrB,oBAAoB,EAEpB,uBAAuB,EAGvB,mBAAmB,EAEnB,sBAAsB,EAGtB,oBAAoB,EAEpB,oBAAoB,EACpB,oBAAoB;AACpB,mBAAmB;AACnB,eAAe,EAIf,iBAAiB;AAEjB,gBAAgB;AAChB,cAAc,EAGd,0BAA0B,EAG1B,wBAAwB,EAGxB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAc,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EACN,OAAO,EACP,KAAK,EAEL,cAAc,EAEd,cAAc,EAEd,iBAAiB,EACjB,IAAI,EAGJ,OAAO,EACP,QAAQ;AACR,sDAAsD;AACtD,QAAQ,EACR,MAAM,EACN,CAAC,EACD,aAAa,EAOb,WAAW,EAGX,YAAY,EAEZ,mBAAmB,EAEnB,kBAAkB,EAClB,YAAY,EAGZ,uBAAuB,EACvB,iBAAiB,EAGjB,gBAAgB,EAChB,UAAU,EAGV,iBAAiB,EAGjB,gBAAgB;AAChB,mBAAmB;AACnB,YAAY,EAEZ,gBAAgB,EAGhB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EAGrB,kBAAkB,EAClB,wBAAwB,EAExB,oBAAoB,EACpB,oBAAoB,EAGpB,qBAAqB,EAGrB,iBAAiB,EAEjB,mBAAmB,EAEnB,sBAAsB,EAEtB,oBAAoB,EAEpB,uBAAuB,EAEvB,uBAAuB,EAEvB,qBAAqB,EAErB,wBAAwB,EAExB,0BAA0B,EAE1B,oBAAoB,EACpB,cAAc,EAId,eAAe,EAEf,qBAAqB;AACrB,mCAAmC;AACnC,aAAa,EACb,gBAAgB,GAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/proxy/$.d.ts

@@ -63,6 +63,13 @@ export interface DollarProxy {
     readonly env: ExprPath;
     readonly step: ExprPath;
     readonly workflow: ExprPath;
+    /**
+     * The captured error inside a `tryCatch.catch` block (v0.5).
+     * Resolves to `ctx.error`; undefined inside `try`, `finally`, and
+     * any step outside a tryCatch. Use `$.error.message`, `$.error.name`,
+     * `$.error.stack`.
+     */
+    readonly error: ExprPath;
     /** Escape hatch — any property; returns a sub-path. */
     readonly [key: string]: ExprPath;
 }

package/dist/proxy/$.js.map

@@ -1 +1 @@
-{"version":3,"file":"$.js","sourceRoot":"","sources":["../../src/proxy/$.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAEjD,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAC9C,MAAM,UAAU,GAAG,OAAO,CAAC;AAyC3B,SAAS,SAAS,CAAC,MAAc;IAChC,wEAAwE;IACxE,sEAAsE;IACtE,6CAA6C;IAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAA+B,CAAC;IAC5D,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC;IAE7B,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACxB,GAAG,CAAC,OAAO,EAAE,GAAG;YACf,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC;YACvC,IAAI,GAAG,KAAK,MAAM,CAAC,WAAW;gBAAE,OAAO,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,MAAM,EAAE,CAAC;YACzE,IAAI,GAAG,KAAK,UAAU;gBAAE,OAAO,GAAG,EAAE,CAAC,MAAM,MAAM,EAAE,CAAC;YACpD,IAAI,GAAG,KAAK,QAAQ;gBAAE,OAAO,GAAG,EAAE,CAAC,MAAM,MAAM,EAAE,CAAC;YAClD,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,GAAG,EAAE,CAAC,MAAM,MAAM,EAAE,CAAC;YACnD,qEAAqE;YACrE,IAAI,GAAG,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAC;YACrC,oDAAoD;YACpD,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAE9C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,IAAY,CAAC;YACjB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;YAC1B,CAAC;iBAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACP,IAAI,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1C,CAAC;YACD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,CAAC,GAAgB,SAAS,CAAC,KAAK,CAAgB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAAI,KAAQ;IACxC,OAAO,MAAM,CAAC,KAAK,CAAM,CAAC;AAC3B,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAExD,mCAAmC;IACnC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,GAAG,GAAI,KAAoC,CAAC,WAAW,CAAC,CAAC;QAC/D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,MAAM,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,iCAAiC;QACjC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,8DAA8D;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YAClD,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAE,KAAiC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,GAAG,CAAC;QACZ,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../src/proxy/$.ts"],"names":[],"mappings":"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"}

package/dist/types/StepOpts.d.ts

@@ -28,12 +28,6 @@ export declare const StepOptsSchema: z.ZodObject<{
     type: z.ZodEnum<["local", "module", "runtime.python3", "runtime.nodejs", "runtime.bun", "runtime.go", "runtime.java", "runtime.rust", "runtime.php", "runtime.csharp", "runtime.ruby", "runtime.docker", "runtime.wasm"]>;
     inputs: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
     runtime: z.ZodOptional<z.ZodEnum<["nodejs", "bun", "python3", "go", "java", "rust", "php", "csharp", "ruby", "docker", "wasm"]>>;
-    /**
-     * @deprecated v2 default-stores every step's output. Set `ephemeral: true`
-     * to opt out. `set_var: true` is now a no-op (default behaviour);
-     * `set_var: false` is normalized to `ephemeral: true` at load time.
-     */
-    set_var: z.ZodOptional<z.ZodBoolean>;
     active: z.ZodOptional<z.ZodBoolean>;
     stop: z.ZodOptional<z.ZodBoolean>;
     stream_logs: z.ZodOptional<z.ZodBoolean>;
@@ -43,7 +37,6 @@ export declare const StepOptsSchema: z.ZodObject<{
     type: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm";
     inputs?: {} | undefined;
     runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-    set_var?: boolean | undefined;
     active?: boolean | undefined;
     stop?: boolean | undefined;
     stream_logs?: boolean | undefined;
@@ -53,7 +46,6 @@ export declare const StepOptsSchema: z.ZodObject<{
     type: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm";
     inputs?: {} | undefined;
     runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-    set_var?: boolean | undefined;
     active?: boolean | undefined;
     stop?: boolean | undefined;
     stream_logs?: boolean | undefined;
@@ -68,12 +60,6 @@ export declare const StepConditionSchema: z.ZodObject<{
         type: z.ZodEnum<["local", "module", "runtime.python3", "runtime.nodejs", "runtime.bun", "runtime.go", "runtime.java", "runtime.rust", "runtime.php", "runtime.csharp", "runtime.ruby", "runtime.docker", "runtime.wasm"]>;
         inputs: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
         runtime: z.ZodOptional<z.ZodEnum<["nodejs", "bun", "python3", "go", "java", "rust", "php", "csharp", "ruby", "docker", "wasm"]>>;
-        /**
-         * @deprecated v2 default-stores every step's output. Set `ephemeral: true`
-         * to opt out. `set_var: true` is now a no-op (default behaviour);
-         * `set_var: false` is normalized to `ephemeral: true` at load time.
-         */
-        set_var: z.ZodOptional<z.ZodBoolean>;
         active: z.ZodOptional<z.ZodBoolean>;
         stop: z.ZodOptional<z.ZodBoolean>;
         stream_logs: z.ZodOptional<z.ZodBoolean>;
@@ -83,7 +69,6 @@ export declare const StepConditionSchema: z.ZodObject<{
         type: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm";
         inputs?: {} | undefined;
         runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-        set_var?: boolean | undefined;
         active?: boolean | undefined;
         stop?: boolean | undefined;
         stream_logs?: boolean | undefined;
@@ -93,7 +78,6 @@ export declare const StepConditionSchema: z.ZodObject<{
         type: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm";
         inputs?: {} | undefined;
         runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-        set_var?: boolean | undefined;
         active?: boolean | undefined;
         stop?: boolean | undefined;
         stream_logs?: boolean | undefined;
@@ -106,7 +90,6 @@ export declare const StepConditionSchema: z.ZodObject<{
         type: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm";
         inputs?: {} | undefined;
         runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-        set_var?: boolean | undefined;
         active?: boolean | undefined;
         stop?: boolean | undefined;
         stream_logs?: boolean | undefined;
@@ -119,7 +102,6 @@ export declare const StepConditionSchema: z.ZodObject<{
         type: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm";
         inputs?: {} | undefined;
         runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-        set_var?: boolean | undefined;
         active?: boolean | undefined;
         stop?: boolean | undefined;
         stream_logs?: boolean | undefined;
@@ -242,21 +224,19 @@ export declare const V2RegularStepSchema: z.ZodEffects<z.ZodObject<{
         maxTimeoutInMs?: number | undefined;
     }>>;
     maxDuration: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
-    set_var: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     use: string;
     type?: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm" | undefined;
     inputs?: Record<string, unknown> | undefined;
     runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-    set_var?: boolean | undefined;
     active?: boolean | undefined;
     stop?: boolean | undefined;
     stream_logs?: boolean | undefined;
+    idempotencyKey?: string | undefined;
     as?: string | undefined;
     spread?: boolean | undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: string | undefined;
     idempotencyKeyTTL?: number | undefined;
     retry?: {
         maxAttempts: number;
@@ -271,14 +251,13 @@ export declare const V2RegularStepSchema: z.ZodEffects<z.ZodObject<{
     type?: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm" | undefined;
     inputs?: Record<string, unknown> | undefined;
     runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-    set_var?: boolean | undefined;
     active?: boolean | undefined;
     stop?: boolean | undefined;
     stream_logs?: boolean | undefined;
+    idempotencyKey?: string | undefined;
     as?: string | undefined;
     spread?: boolean | undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: string | undefined;
     idempotencyKeyTTL?: number | undefined;
     retry?: {
         maxAttempts: number;
@@ -293,14 +272,13 @@ export declare const V2RegularStepSchema: z.ZodEffects<z.ZodObject<{
     type?: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm" | undefined;
     inputs?: Record<string, unknown> | undefined;
     runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-    set_var?: boolean | undefined;
     active?: boolean | undefined;
     stop?: boolean | undefined;
     stream_logs?: boolean | undefined;
+    idempotencyKey?: string | undefined;
     as?: string | undefined;
     spread?: boolean | undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: string | undefined;
     idempotencyKeyTTL?: number | undefined;
     retry?: {
         maxAttempts: number;
@@ -315,14 +293,13 @@ export declare const V2RegularStepSchema: z.ZodEffects<z.ZodObject<{
     type?: "local" | "module" | "runtime.python3" | "runtime.nodejs" | "runtime.bun" | "runtime.go" | "runtime.java" | "runtime.rust" | "runtime.php" | "runtime.csharp" | "runtime.ruby" | "runtime.docker" | "runtime.wasm" | undefined;
     inputs?: Record<string, unknown> | undefined;
     runtime?: "nodejs" | "bun" | "python3" | "go" | "java" | "rust" | "php" | "csharp" | "ruby" | "docker" | "wasm" | undefined;
-    set_var?: boolean | undefined;
     active?: boolean | undefined;
     stop?: boolean | undefined;
     stream_logs?: boolean | undefined;
+    idempotencyKey?: string | undefined;
     as?: string | undefined;
     spread?: boolean | undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: string | undefined;
     idempotencyKeyTTL?: number | undefined;
     retry?: {
         maxAttempts: number;
@@ -404,6 +381,15 @@ export declare const V2SubworkflowStepSchema: z.ZodType<{
     idempotencyKey?: string;
     idempotencyKeyTTL?: number;
     retry?: RetryConfig;
+    allowList?: readonly string[];
+    /**
+     * G2 (v0.6) — dispatch strategy. `in-process` (default) runs the
+     * child workflow in the same Node process; `http-self` makes an
+     * HTTP self-call to the deployment so multi-process deployments
+     * can isolate child execution. Requires the child to have an HTTP
+     * trigger (`trigger.http.path` set).
+     */
+    dispatch?: "in-process" | "http-self";
 }>;
 export type V2SubworkflowStep = z.infer<typeof V2SubworkflowStepSchema>;
 /**
@@ -455,10 +441,10 @@ export declare const V2WaitStepSchema: z.ZodEffects<z.ZodObject<{
     active?: boolean | undefined;
     stop?: boolean | undefined;
     concurrencyKey?: undefined;
+    idempotencyKey?: undefined;
     as?: string | undefined;
     spread?: undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: undefined;
     retry?: undefined;
     maxDuration?: undefined;
 }, {
@@ -470,10 +456,10 @@ export declare const V2WaitStepSchema: z.ZodEffects<z.ZodObject<{
     active?: boolean | undefined;
     stop?: boolean | undefined;
     concurrencyKey?: undefined;
+    idempotencyKey?: undefined;
     as?: string | undefined;
     spread?: undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: undefined;
     retry?: undefined;
     maxDuration?: undefined;
 }>, {
@@ -485,10 +471,10 @@ export declare const V2WaitStepSchema: z.ZodEffects<z.ZodObject<{
     active?: boolean | undefined;
     stop?: boolean | undefined;
     concurrencyKey?: undefined;
+    idempotencyKey?: undefined;
     as?: string | undefined;
     spread?: undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: undefined;
     retry?: undefined;
     maxDuration?: undefined;
 }, {
@@ -500,25 +486,290 @@ export declare const V2WaitStepSchema: z.ZodEffects<z.ZodObject<{
     active?: boolean | undefined;
     stop?: boolean | undefined;
     concurrencyKey?: undefined;
+    idempotencyKey?: undefined;
     as?: string | undefined;
     spread?: undefined;
     ephemeral?: boolean | undefined;
-    idempotencyKey?: undefined;
     retry?: undefined;
     maxDuration?: undefined;
 }>;
 export type V2WaitStep = z.infer<typeof V2WaitStepSchema>;
 /**
- * Discriminated v2 step — regular, branch, sub-workflow, or wait.
+ * V2 forEach step — iterate over a collection running a sub-pipeline
+ * per item. Sequential (default) or parallel with bounded concurrency.
+ *
+ * @example
+ *   forEach({
+ *     id: "process-orders",
+ *     in: $.state.orders,
+ *     as: "order",
+ *     mode: "parallel",
+ *     concurrency: 5,
+ *     do: [
+ *       { id: "charge", use: "stripe-charge", inputs: { amount: $.state.order.total } },
+ *     ],
+ *   })
+ */
+export declare const V2ForEachStepSchema: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    forEach: z.ZodObject<{
+        in: z.ZodUnknown;
+        as: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<["sequential", "parallel"]>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
+        do: z.ZodArray<z.ZodUnknown, "many">;
+    }, "strip", z.ZodTypeAny, {
+        as: string;
+        do: unknown[];
+        mode?: "sequential" | "parallel" | undefined;
+        concurrency?: number | undefined;
+        in?: unknown;
+    }, {
+        as: string;
+        do: unknown[];
+        mode?: "sequential" | "parallel" | undefined;
+        concurrency?: number | undefined;
+        in?: unknown;
+    }>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    stop: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    forEach: {
+        as: string;
+        do: unknown[];
+        mode?: "sequential" | "parallel" | undefined;
+        concurrency?: number | undefined;
+        in?: unknown;
+    };
+    id: string;
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}, {
+    forEach: {
+        as: string;
+        do: unknown[];
+        mode?: "sequential" | "parallel" | undefined;
+        concurrency?: number | undefined;
+        in?: unknown;
+    };
+    id: string;
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}>>;
+export type V2ForEachStep = z.infer<typeof V2ForEachStepSchema>;
+/**
+ * V2 loop step — while-loop with hard maxIterations safety cap.
+ *
+ * @example
+ *   loop({
+ *     id: "poll",
+ *     while: '$.state["check-status"].status !== "done"',
+ *     maxIterations: 60,
+ *     do: [
+ *       { id: "wait-tick", wait: { for: "2s" } },
+ *       { id: "check-status", use: "@blokjs/api-call", inputs: { url: $.state.url } },
+ *     ],
+ *   })
+ */
+export declare const V2LoopStepSchema: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    loop: z.ZodObject<{
+        while: z.ZodString;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        do: z.ZodArray<z.ZodUnknown, "many">;
+    }, "strip", z.ZodTypeAny, {
+        do: unknown[];
+        while: string;
+        maxIterations?: number | undefined;
+    }, {
+        do: unknown[];
+        while: string;
+        maxIterations?: number | undefined;
+    }>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    stop: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    loop: {
+        do: unknown[];
+        while: string;
+        maxIterations?: number | undefined;
+    };
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}, {
+    id: string;
+    loop: {
+        do: unknown[];
+        while: string;
+        maxIterations?: number | undefined;
+    };
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}>>;
+export type V2LoopStep = z.infer<typeof V2LoopStepSchema>;
+/**
+ * V2 switch step — N-way branch keyed on a value. First matching case wins.
+ *
+ * `on` resolves to a value at run time (literal, `$` proxy expression, or
+ * `js/...` string). Each case carries a `when` and a `do` sub-pipeline:
+ * - `when` is a literal → match if `on === when`.
+ * - `when` is an array  → match if `array.includes(on)` (group related cases).
+ * - `default` runs when no case matches. Optional.
+ *
+ * @example
+ *   switchOn({
+ *     id: "route-by-tenant",
+ *     on: $.req.headers["x-tenant-id"],
+ *     cases: [
+ *       { when: "acme",   do: [{ id: "x", subworkflow: "acme-process" }] },
+ *       { when: ["a","b"], do: [{ id: "y", subworkflow: "shared" }] },
+ *     ],
+ *     default: [{ id: "respond-403", use: "@blokjs/respond", stop: true,
+ *                 inputs: { status: 403, body: { error: "Unknown tenant" } } }],
+ *   })
+ */
+export declare const V2SwitchStepSchema: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    switch: z.ZodObject<{
+        on: z.ZodUnknown;
+        cases: z.ZodArray<z.ZodObject<{
+            when: z.ZodUnknown;
+            do: z.ZodArray<z.ZodUnknown, "many">;
+        }, "strip", z.ZodTypeAny, {
+            do: unknown[];
+            when?: unknown;
+        }, {
+            do: unknown[];
+            when?: unknown;
+        }>, "many">;
+        default: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        cases: {
+            do: unknown[];
+            when?: unknown;
+        }[];
+        on?: unknown;
+        default?: unknown[] | undefined;
+    }, {
+        cases: {
+            do: unknown[];
+            when?: unknown;
+        }[];
+        on?: unknown;
+        default?: unknown[] | undefined;
+    }>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    stop: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    switch: {
+        cases: {
+            do: unknown[];
+            when?: unknown;
+        }[];
+        on?: unknown;
+        default?: unknown[] | undefined;
+    };
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}, {
+    id: string;
+    switch: {
+        cases: {
+            do: unknown[];
+            when?: unknown;
+        }[];
+        on?: unknown;
+        default?: unknown[] | undefined;
+    };
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}>>;
+export type V2SwitchStep = z.infer<typeof V2SwitchStepSchema>;
+/**
+ * V2 tryCatch step — JS-like exception handling for sub-pipelines.
+ *
+ * - `try` block runs first.
+ * - On error, the `catch` block runs with `ctx.error` populated
+ *   (`$.error.message`, `$.error.name`, `$.error.stack`). Errors thrown
+ *   inside `catch` propagate to the next outer handler — they DO NOT
+ *   re-trigger `catch`.
+ * - `finally` (if provided) runs unconditionally after try/catch — on
+ *   normal completion, after a caught error, AND after an uncaught
+ *   error from inside `catch`. Errors from `finally` propagate.
+ *
+ * State mutations from any block are visible to subsequent top-level
+ * steps (passthrough flow, like switch).
+ *
+ * @example
+ *   tryCatch({
+ *     id: "saga",
+ *     try: [
+ *       { id: "create", use: "user-create", inputs: { email: $.req.body.email } },
+ *       { id: "notify", use: "email-send", inputs: { to: $.state.create.email } },
+ *     ],
+ *     catch: [
+ *       { id: "rollback", use: "user-delete",
+ *         inputs: { userId: $.state.create.id, reason: $.error.message } },
+ *     ],
+ *     finally: [
+ *       { id: "metric", use: "@blokjs/metrics-emit", inputs: { event: "saga-attempt" } },
+ *     ],
+ *   })
+ */
+export declare const V2TryCatchStepSchema: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    tryCatch: z.ZodObject<{
+        try: z.ZodArray<z.ZodUnknown, "many">;
+        catch: z.ZodArray<z.ZodUnknown, "many">;
+        finally: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        try: unknown[];
+        catch: unknown[];
+        finally?: unknown[] | undefined;
+    }, {
+        try: unknown[];
+        catch: unknown[];
+        finally?: unknown[] | undefined;
+    }>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    stop: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    tryCatch: {
+        try: unknown[];
+        catch: unknown[];
+        finally?: unknown[] | undefined;
+    };
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}, {
+    id: string;
+    tryCatch: {
+        try: unknown[];
+        catch: unknown[];
+        finally?: unknown[] | undefined;
+    };
+    active?: boolean | undefined;
+    stop?: boolean | undefined;
+}>>;
+export type V2TryCatchStep = z.infer<typeof V2TryCatchStepSchema>;
+/**
+ * Discriminated v2 step — regular, branch, sub-workflow, wait, forEach, loop, switch, or tryCatch.
  *
  * Discriminators (no `kind` field needed):
  * - presence of `branch` → branch step
  * - presence of `subworkflow` → sub-workflow step
  * - presence of `wait` (object) → wait step
+ * - presence of `forEach` → forEach step (v0.5)
+ * - presence of `loop` → loop step (v0.5)
+ * - presence of `switch` → switch step (v0.5)
+ * - presence of `tryCatch` → tryCatch step (v0.5)
  * - otherwise → regular step
  */
-export declare const V2StepSchema: z.ZodType<V2RegularStep | V2BranchStep | V2SubworkflowStep | V2WaitStep>;
-export type V2Step = V2RegularStep | V2BranchStep | V2SubworkflowStep | V2WaitStep;
+export declare const V2StepSchema: z.ZodType<V2RegularStep | V2BranchStep | V2SubworkflowStep | V2WaitStep | V2ForEachStep | V2LoopStep | V2SwitchStep | V2TryCatchStep>;
+export type V2Step = V2RegularStep | V2BranchStep | V2SubworkflowStep | V2WaitStep | V2ForEachStep | V2LoopStep | V2SwitchStep | V2TryCatchStep;
 /**
  * Type guard — true when the step is a branch.
  */
@@ -531,3 +782,19 @@ export declare function isWaitStep(step: V2Step): step is V2WaitStep;
  * Type guard — true when the step is a sub-workflow invocation.
  */
 export declare function isSubworkflowStep(step: V2Step): step is V2SubworkflowStep;
+/**
+ * Type guard — true when the step is a forEach iteration (v0.5).
+ */
+export declare function isForEachStep(step: V2Step): step is V2ForEachStep;
+/**
+ * Type guard — true when the step is a while-loop (v0.5).
+ */
+export declare function isLoopStep(step: V2Step): step is V2LoopStep;
+/**
+ * Type guard — true when the step is an N-way switch (v0.5).
+ */
+export declare function isSwitchStep(step: V2Step): step is V2SwitchStep;
+/**
+ * Type guard — true when the step is a tryCatch (v0.5).
+ */
+export declare function isTryCatchStep(step: V2Step): step is V2TryCatchStep;