@blokjs/helper 0.2.1 → 0.4.0

package/dist/components/AddElse.d.ts

@@ -13,18 +13,30 @@ declare const ConditionElseSchema: 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"]>>;
+        set_var: z.ZodOptional<z.ZodBoolean>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        stop: z.ZodOptional<z.ZodBoolean>;
+        stream_logs: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         node: 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";
         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;
     }, {
         name: string;
         node: 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";
         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;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "if" | "else";
@@ -34,6 +46,10 @@ declare const ConditionElseSchema: 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;
     }[] | undefined;
 }, {
     type: "if" | "else";
@@ -43,6 +59,10 @@ declare const ConditionElseSchema: 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;
     }[] | undefined;
 }>;
 export type ConditionElseOpts = z.infer<typeof ConditionElseSchema>;

package/dist/components/AddIf.d.ts

@@ -16,18 +16,30 @@ declare const ConditionSchema: 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"]>>;
+        set_var: z.ZodOptional<z.ZodBoolean>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        stop: z.ZodOptional<z.ZodBoolean>;
+        stream_logs: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         node: 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";
         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;
     }, {
         name: string;
         node: 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";
         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;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "if" | "else";
@@ -38,6 +50,10 @@ declare const ConditionSchema: 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;
     }[] | undefined;
 }, {
     type: "if" | "else";
@@ -48,6 +64,10 @@ declare const ConditionSchema: 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;
     }[] | undefined;
 }>;
 export type ConditionOpts = z.infer<typeof ConditionSchema>;

package/dist/components/StepNode.d.ts

@@ -1,5 +1,11 @@
 import { type StepConditionOpts, type StepOpts } from "../types/StepOpts";
 import HelperResponse from "./HelperResponse";
+/**
+ * Builder step that adds workflow steps and conditional branches.
+ *
+ * Each call returns a new {@link StepNode} carrying the accumulated config
+ * so workflow definitions remain immutable from the outside.
+ */
 export default class StepNode extends HelperResponse {
     addStep(config: StepOpts): StepNode;
     addCondition(conditions: StepConditionOpts): StepNode;

package/dist/components/StepNode.js

@@ -1,5 +1,11 @@
 import { StepConditionSchema, StepOptsSchema, } from "../types/StepOpts";
 import HelperResponse from "./HelperResponse";
+/**
+ * Builder step that adds workflow steps and conditional branches.
+ *
+ * Each call returns a new {@link StepNode} carrying the accumulated config
+ * so workflow definitions remain immutable from the outside.
+ */
 export default class StepNode extends HelperResponse {
     addStep(config) {
         StepOptsSchema.parse(config);
@@ -13,6 +19,9 @@ export default class StepNode extends HelperResponse {
             node: config.node,
             type: config.type,
             runtime: config.runtime,
+            set_var: config.set_var,
+            active: config.active,
+            stop: config.stop,
         });
         const helperResponse = new StepNode();
         helperResponse.setConfig(this._config);

package/dist/components/StepNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"StepNode.js","sourceRoot":"","sources":["../../src/components/StepNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,mBAAmB,EAEnB,cAAc,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,cAAc;IACnD,OAAO,CAAC,MAAgB;QACvB,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE7B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;YACxB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,IAAI,QAAQ,EAAE,CAAC;QACtC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,cAAc,CAAC;IACvB,CAAC;IAED,YAAY,CAAC,UAA6B;QACzC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,UAAoC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAA2C,CAAC;QAE5E,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAE9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAmB,CAAC;YAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEtB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;iBACnB,CAAC;gBAEF,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACzB,CAAC;QACF,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC1C,UAAU,EAAE,QAAQ;SACpB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,QAAQ,EAAE,CAAC;QACtC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,cAAc,CAAC;IACvB,CAAC;CACD"}
+{"version":3,"file":"StepNode.js","sourceRoot":"","sources":["../../src/components/StepNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,mBAAmB,EAEnB,cAAc,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,cAAc;IACnD,OAAO,CAAC,MAAgB;QACvB,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE7B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;YACxB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,IAAI,QAAQ,EAAE,CAAC;QACtC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,cAAc,CAAC;IACvB,CAAC;IAED,YAAY,CAAC,UAA6B;QACzC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,UAAoC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAA2C,CAAC;QAE5E,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAE9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAmB,CAAC;YAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEtB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;iBACnB,CAAC;gBAEF,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACzB,CAAC;QACF,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC1C,UAAU,EAAE,QAAQ;SACpB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,QAAQ,EAAE,CAAC;QACtC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,cAAc,CAAC;IACvB,CAAC;CACD"}

package/dist/components/Trigger.d.ts

@@ -1,8 +1,16 @@
-import { type CronTriggerOpts, type PubSubTriggerOpts, type QueueTriggerOpts, type SSETriggerOpts, type TriggerOpts, type WebSocketTriggerOpts, type WebhookTriggerOpts, type WorkerTriggerOpts } from "../types/TriggerOpts";
+import { type CronTriggerOpts, type HttpTriggerOpts, type PubSubTriggerOpts, type QueueTriggerOpts, type SSETriggerOpts, type WebSocketTriggerOpts, type WebhookTriggerOpts, type WorkerTriggerOpts } from "../types/TriggerOpts";
 import HelperResponse from "./HelperResponse";
 import StepNode from "./StepNode";
+/**
+ * Builder step that attaches a trigger to a workflow.
+ *
+ * Returned by {@link Workflow}; chains into {@link StepNode} via
+ * {@link Trigger.addTrigger}. Type-safe overloads constrain the `config`
+ * argument shape per trigger kind; {@link validateTriggerConfig} runs the
+ * matching Zod schema at call time.
+ */
 export default class Trigger extends HelperResponse {
-    addTrigger(name: "http", config: TriggerOpts): StepNode;
+    addTrigger(name: "http", config: HttpTriggerOpts): StepNode;
     addTrigger(name: "queue", config: QueueTriggerOpts): StepNode;
     addTrigger(name: "pubsub", config: PubSubTriggerOpts): StepNode;
     addTrigger(name: "cron", config: CronTriggerOpts): StepNode;

package/dist/components/Trigger.js

@@ -1,13 +1,24 @@
-import { TriggerOptsSchema, TriggersSchema, } from "../types/TriggerOpts";
+import { TriggersSchema, validateTriggerConfig, } from "../types/TriggerOpts";
 import HelperResponse from "./HelperResponse";
 import StepNode from "./StepNode";
+/**
+ * Builder step that attaches a trigger to a workflow.
+ *
+ * Returned by {@link Workflow}; chains into {@link StepNode} via
+ * {@link Trigger.addTrigger}. Type-safe overloads constrain the `config`
+ * argument shape per trigger kind; {@link validateTriggerConfig} runs the
+ * matching Zod schema at call time.
+ */
 export default class Trigger extends HelperResponse {
     addTrigger(name, config) {
+        // Validate the trigger NAME first so callers get a clear error for typos
+        // before we try to dispatch to a schema.
         TriggersSchema.parse(name);
-        if (name === "http" && config) {
-            TriggerOptsSchema.parse(config);
-        }
-        this._config.trigger = { [name]: config || {} };
+        // Dispatch to the per-kind schema. Returns the parsed config (with
+        // defaults applied) for typed triggers, or the input config for
+        // grpc/manual which have no schema.
+        const validated = validateTriggerConfig(name, config);
+        this._config.trigger = { [name]: validated };
         const helperResponse = new StepNode();
         helperResponse.setConfig(this._config);
         return helperResponse;

package/dist/components/Trigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"Trigger.js","sourceRoot":"","sources":["../../src/components/Trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAON,iBAAiB,EAEjB,cAAc,GAId,MAAM,sBAAsB,CAAC;AAC9B,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,cAAc;IAWlD,UAAU,CAAyB,IAAO,EAAE,MAA4B;QACvE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3B,IAAI,IAAI,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;YAC/B,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QAEhD,MAAM,cAAc,GAAG,IAAI,QAAQ,EAAE,CAAC;QACtC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,cAAc,CAAC;IACvB,CAAC;CACD"}
+{"version":3,"file":"Trigger.js","sourceRoot":"","sources":["../../src/components/Trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAQN,cAAc,EAId,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,cAAc;IAUlD,UAAU,CAAyB,IAAO,EAAE,MAA4B;QACvE,yEAAyE;QACzE,yCAAyC;QACzC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3B,mEAAmE;QACnE,gEAAgE;QAChE,oCAAoC;QACpC,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;QAE7C,MAAM,cAAc,GAAG,IAAI,QAAQ,EAAE,CAAC;QACtC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,cAAc,CAAC;IACvB,CAAC;CACD"}

package/dist/components/branch.d.ts

@@ -0,0 +1,44 @@
+import type { V2BranchStep, V2Step } from "../types/StepOpts";
+/**
+ * Author-facing options for {@link branch}.
+ *
+ * `when` accepts either a plain string (`"$.req.method === 'POST'"`) or
+ * a `$` proxy expression that will compile to a string at definition
+ * time (`$.req.method`). Note that JavaScript's `===` operator can't be
+ * intercepted, so equality comparisons must be expressed as strings.
+ */
+export interface BranchOpts {
+    /** Stable identifier — visible in traces, referenced as `$.state[id]`. */
+    id: string;
+    /** JS condition. Truthy → run `then`; falsy → run `else`. */
+    when: string | unknown;
+    then: V2Step[];
+    /** Optional. Steps to run when `when` is falsy. */
+    else?: V2Step[];
+    /** Skip this branch step at runtime. Default true (active). */
+    active?: boolean;
+    /** Halt the workflow after this branch step completes. */
+    stop?: boolean;
+}
+/**
+ * Create a branch step — a step that runs one of two sub-pipelines based
+ * on a JS condition.
+ *
+ * Compiles down to today's `@blokjs/if-else` flow node at workflow load
+ * time, so the runner core needs no change. Authors get a single primitive
+ * with the same shape as a regular step: `{ id, ... }`.
+ *
+ * @example
+ *   branch({
+ *     id: "route",
+ *     when: '$.req.method === "POST"',
+ *     then: [{ id: "create", use: "...", inputs: {...} }],
+ *     else: [{ id: "read",   use: "...", inputs: {...} }]
+ *   })
+ *
+ * @example
+ *   // `when` accepts a $ proxy expression — compiles to a string at
+ *   // definition time, so `js/ctx.req.query.kind` lands in the workflow.
+ *   branch({ id: "route-by-kind", when: $.req.query.kind, then: [...] })
+ */
+export declare function branch(opts: BranchOpts): V2BranchStep;

package/dist/components/branch.js

@@ -0,0 +1,57 @@
+import { unwrapProxies } from "../proxy/$";
+/**
+ * Create a branch step — a step that runs one of two sub-pipelines based
+ * on a JS condition.
+ *
+ * Compiles down to today's `@blokjs/if-else` flow node at workflow load
+ * time, so the runner core needs no change. Authors get a single primitive
+ * with the same shape as a regular step: `{ id, ... }`.
+ *
+ * @example
+ *   branch({
+ *     id: "route",
+ *     when: '$.req.method === "POST"',
+ *     then: [{ id: "create", use: "...", inputs: {...} }],
+ *     else: [{ id: "read",   use: "...", inputs: {...} }]
+ *   })
+ *
+ * @example
+ *   // `when` accepts a $ proxy expression — compiles to a string at
+ *   // definition time, so `js/ctx.req.query.kind` lands in the workflow.
+ *   branch({ id: "route-by-kind", when: $.req.query.kind, then: [...] })
+ */
+export function branch(opts) {
+    if (!opts || typeof opts !== "object") {
+        throw new Error("branch() requires an options object.");
+    }
+    if (!opts.id || typeof opts.id !== "string") {
+        throw new Error("branch() requires a non-empty `id` string.");
+    }
+    const when = unwrapProxies(opts.when);
+    if (typeof when !== "string" || when.length === 0) {
+        throw new Error(`branch("${opts.id}") requires a non-empty \`when\` string. Use a $ proxy path (e.g. $.req.query.kind) or a plain expression (e.g. '$.req.method === "POST"'). For equality comparisons, use a plain string — JavaScript's === operator can't be intercepted by the proxy.`);
+    }
+    if (!Array.isArray(opts.then)) {
+        throw new Error(`branch("${opts.id}") requires \`then\` to be an array of steps.`);
+    }
+    if (opts.else !== undefined && !Array.isArray(opts.else)) {
+        throw new Error(`branch("${opts.id}") \`else\` must be an array of steps when set.`);
+    }
+    // Walk the steps to convert any inline proxies in their inputs.
+    const thenSteps = unwrapProxies(opts.then);
+    const elseSteps = opts.else ? unwrapProxies(opts.else) : undefined;
+    const result = {
+        id: opts.id,
+        branch: {
+            when,
+            then: thenSteps,
+            ...(elseSteps ? { else: elseSteps } : {}),
+        },
+    };
+    if (opts.active === false)
+        result.active = false;
+    if (opts.stop === true)
+        result.stop = true;
+    return result;
+}
+//# sourceMappingURL=branch.js.map

package/dist/components/branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.js","sourceRoot":"","sources":["../../src/components/branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyB3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,MAAM,CAAC,IAAgB;IACtC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACd,WAAW,IAAI,CAAC,EAAE,yPAAyP,CAC3Q,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,+CAA+C,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,iDAAiD,CAAC,CAAC;IACtF,CAAC;IAED,gEAAgE;IAChE,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAa,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,MAAM,MAAM,GAAiB;QAC5B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,MAAM,EAAE;YACP,IAAI;YACJ,IAAI,EAAE,SAAS;YACf,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzC;KACD,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;QAAG,MAA6C,CAAC,MAAM,GAAG,KAAK,CAAC;IACzF,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAG,MAA2C,CAAC,IAAI,GAAG,IAAI,CAAC;IACjF,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/components/workflowV2.d.ts

@@ -0,0 +1,83 @@
+import { type V2Step } from "../types/StepOpts";
+import type { WorkflowV2 } from "../types/WorkflowOpts";
+/**
+ * V2 workflow author input — strict TypeScript shape with the user-facing
+ * fields the lowercase `workflow()` factory accepts.
+ */
+export interface WorkflowOpts {
+    /** Workflow display name. Min 3 characters. Shown in Studio. */
+    name: string;
+    /** Semantic version (x.x.x). Used for trace recording and audit. */
+    version: string;
+    /** What this workflow does. Optional but recommended. */
+    description?: string;
+    /**
+     * Trigger configuration. Most workflows use a single key:
+     *   `{ http: { method: "GET" } }`
+     *   `{ cron: { schedule: "0 * * * *" } }`
+     *   `{ queue: { provider: "kafka", topic: "..." } }`
+     *
+     * See `TRIGGER_SCHEMAS` for per-kind shapes. Validated per-kind at
+     * factory time.
+     */
+    trigger: Record<string, unknown>;
+    /** Pipeline of steps to execute in order. At least one required. */
+    steps: V2Step[];
+}
+/**
+ * The shape returned by `workflow()`. Tagged with `_blokV2: true` so the
+ * scanner / loader can detect a v2-shape default export and route it
+ * through the v1→v2 normalizer cleanly. The internal `_config` field
+ * mirrors the legacy v1 builder output for back-compat with code that
+ * already reads `step._config.trigger` etc.
+ */
+export interface WorkflowV2Builder {
+    readonly _blokV2: true;
+    readonly _config: WorkflowV2;
+    /**
+     * Serialize the wrapped workflow to a JSON string. Mirrors the
+     * `HelperResponse.toJson()` contract so v2 builders are
+     * structurally compatible with the v1 workflow registry
+     * (`Workflows` map → `LocalStorage.get` fallback).
+     */
+    toJson(): string;
+}
+/**
+ * Lowercase v2 workflow factory. Validates inputs against the v2 schema,
+ * compiles any `$` proxy expressions inside step `inputs` into
+ * `"js/ctx..."` strings at definition time, and returns a tagged object
+ * the runner's normalizer recognizes.
+ *
+ * Differences from the legacy `Workflow()` (capital W):
+ * - **No chaining.** The full workflow is a single object literal —
+ *   exactly what JSON workflows look like.
+ * - **No separate `nodes{}` map.** `inputs` lives on each step.
+ * - **No `set_var: true`** — every step's output auto-stores in `ctx.state`.
+ *   Opt out with `ephemeral: true`. Multi-output: `spread: true`. Rename:
+ *   `as: "<name>"`.
+ * - **`branch({when, then, else})`** replaces `addCondition + AddIf + AddElse`.
+ * - **`$` proxy** replaces hand-written `js/ctx....` strings with typed
+ *   property access.
+ *
+ * @example
+ *   import { workflow, branch, $ } from "@blokjs/helper";
+ *
+ *   export default workflow({
+ *     name: "World Countries",
+ *     version: "1.0.0",
+ *     trigger: { http: { method: "GET" } },
+ *     steps: [
+ *       { id: "fetch", use: "@blokjs/api-call",
+ *         inputs: { url: "https://countriesnow.space/api/v0.1/countries" } },
+ *       branch({
+ *         id: "route",
+ *         when: $.req.query.kind,
+ *         then: [{ id: "respond", use: "@blokjs/respond",
+ *                  inputs: { body: $.state.fetch } }],
+ *         else: [{ id: "fallback", use: "@blokjs/api-call",
+ *                  inputs: { url: "https://catfact.ninja/fact" } }]
+ *       })
+ *     ]
+ *   });
+ */
+export declare function workflow(opts: WorkflowOpts): WorkflowV2Builder;

package/dist/components/workflowV2.js

@@ -0,0 +1,84 @@
+import { unwrapProxies } from "../proxy/$";
+import { V2StepSchema } from "../types/StepOpts";
+import { TriggersSchema, validateTriggerConfig } from "../types/TriggerOpts";
+/**
+ * Lowercase v2 workflow factory. Validates inputs against the v2 schema,
+ * compiles any `$` proxy expressions inside step `inputs` into
+ * `"js/ctx..."` strings at definition time, and returns a tagged object
+ * the runner's normalizer recognizes.
+ *
+ * Differences from the legacy `Workflow()` (capital W):
+ * - **No chaining.** The full workflow is a single object literal —
+ *   exactly what JSON workflows look like.
+ * - **No separate `nodes{}` map.** `inputs` lives on each step.
+ * - **No `set_var: true`** — every step's output auto-stores in `ctx.state`.
+ *   Opt out with `ephemeral: true`. Multi-output: `spread: true`. Rename:
+ *   `as: "<name>"`.
+ * - **`branch({when, then, else})`** replaces `addCondition + AddIf + AddElse`.
+ * - **`$` proxy** replaces hand-written `js/ctx....` strings with typed
+ *   property access.
+ *
+ * @example
+ *   import { workflow, branch, $ } from "@blokjs/helper";
+ *
+ *   export default workflow({
+ *     name: "World Countries",
+ *     version: "1.0.0",
+ *     trigger: { http: { method: "GET" } },
+ *     steps: [
+ *       { id: "fetch", use: "@blokjs/api-call",
+ *         inputs: { url: "https://countriesnow.space/api/v0.1/countries" } },
+ *       branch({
+ *         id: "route",
+ *         when: $.req.query.kind,
+ *         then: [{ id: "respond", use: "@blokjs/respond",
+ *                  inputs: { body: $.state.fetch } }],
+ *         else: [{ id: "fallback", use: "@blokjs/api-call",
+ *                  inputs: { url: "https://catfact.ninja/fact" } }]
+ *       })
+ *     ]
+ *   });
+ */
+export function workflow(opts) {
+    if (!opts || typeof opts !== "object") {
+        throw new Error("workflow() requires an options object.");
+    }
+    // Compile $ proxy expressions into js/ strings BEFORE schema validation
+    // (the schema sees only strings; proxies would fail z.string().min(1)).
+    const compiledSteps = unwrapProxies(opts.steps);
+    // Per-step schema check — surface authoring errors loudly.
+    for (let i = 0; i < compiledSteps.length; i++) {
+        const parsed = V2StepSchema.safeParse(compiledSteps[i]);
+        if (!parsed.success) {
+            const id = compiledSteps[i]?.id ?? compiledSteps[i]?.name ?? `<step ${i}>`;
+            throw new Error(`workflow("${opts.name}") step "${id}" failed validation: ${parsed.error.message}`);
+        }
+    }
+    // Per-kind trigger validation. Mirrors what `Trigger.addTrigger` does
+    // in the v1 builder so v2 authors get the same error messages.
+    const triggerKeys = Object.keys(opts.trigger ?? {});
+    if (triggerKeys.length === 0) {
+        throw new Error(`workflow("${opts.name}") requires a trigger.`);
+    }
+    const validatedTrigger = {};
+    for (const kind of triggerKeys) {
+        const parsedKind = TriggersSchema.safeParse(kind);
+        if (!parsedKind.success) {
+            throw new Error(`workflow("${opts.name}") trigger kind "${kind}" is not recognized. Allowed: http, queue, pubsub, worker, cron, webhook, sse, websocket, grpc, manual.`);
+        }
+        validatedTrigger[kind] = validateTriggerConfig(parsedKind.data, opts.trigger[kind]);
+    }
+    const _config = {
+        name: opts.name,
+        version: opts.version,
+        description: opts.description,
+        trigger: validatedTrigger,
+        steps: compiledSteps,
+    };
+    return Object.freeze({
+        _blokV2: true,
+        _config,
+        toJson: () => JSON.stringify(_config),
+    });
+}
+//# sourceMappingURL=workflowV2.js.map

package/dist/components/workflowV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowV2.js","sourceRoot":"","sources":["../../src/components/workflowV2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAe,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA+C7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAkB;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC3D,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAa,CAAC;IAE5D,2DAA2D;IAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,EAAE,GACN,aAAa,CAAC,CAAC,CAAqB,EAAE,EAAE,IAAK,aAAa,CAAC,CAAC,CAAuB,EAAE,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC;YAC7G,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,IAAI,YAAY,EAAE,wBAAwB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;IACF,CAAC;IAED,sEAAsE;IACtE,+DAA+D;IAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,IAAI,wBAAwB,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,gBAAgB,GAA4B,EAAE,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACd,aAAa,IAAI,CAAC,IAAI,oBAAoB,IAAI,yGAAyG,CACvJ,CAAC;QACH,CAAC;QACD,gBAAgB,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,UAAU,CAAC,IAAI,EAAG,IAAI,CAAC,OAAmC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClH,CAAC;IAED,MAAM,OAAO,GAAe;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,gBAAgB;QACzB,KAAK,EAAE,aAAa;KACpB,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,IAAa;QACtB,OAAO;QACP,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KACrC,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -4,6 +4,11 @@ import HelperResponse from "./components/HelperResponse";
 import Step from "./components/StepNode";
 import Trigger from "./components/Trigger";
 import Workflow from "./components/Workflow";
-import { NodeType, NodeTypeSchema, RuntimeKind, RuntimeKindSchema, StepInputs, StepOpts } from "./types/StepOpts";
-import { CronTriggerOpts, CronTriggerOptsSchema, HttpTriggerOptsSchema, PubSubProvider, PubSubProviderSchema, PubSubTriggerOpts, PubSubTriggerOptsSchema, QueueProvider, QueueProviderSchema, QueueTriggerOpts, QueueTriggerOptsSchema, SSETriggerOpts, SSETriggerOptsSchema, TriggerOpts, TriggerOptsSchema, TriggersEnum, TriggersSchema, WebSocketTriggerOpts, WebSocketTriggerOptsSchema, WebhookTriggerOpts, WebhookTriggerOptsSchema, WorkerTriggerOpts, WorkerTriggerOptsSchema } from "./types/TriggerOpts";
-export { AddElse, AddIf, ConditionOpts, HelperResponse, NodeType, NodeTypeSchema, RuntimeKind, RuntimeKindSchema, Step, StepInputs, StepOpts, Trigger, Workflow, TriggerOpts, TriggerOptsSchema, HttpTriggerOptsSchema, QueueProvider, QueueProviderSchema, QueueTriggerOpts, QueueTriggerOptsSchema, PubSubProvider, PubSubProviderSchema, PubSubTriggerOpts, PubSubTriggerOptsSchema, WorkerTriggerOpts, WorkerTriggerOptsSchema, CronTriggerOpts, CronTriggerOptsSchema, WebhookTriggerOpts, WebhookTriggerOptsSchema, WebSocketTriggerOpts, WebSocketTriggerOptsSchema, SSETriggerOpts, SSETriggerOptsSchema, TriggersSchema, TriggersEnum, };
+import { type BranchOpts, branch } from "./components/branch";
+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 { 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, };

package/dist/index.js

@@ -4,9 +4,24 @@ import HelperResponse from "./components/HelperResponse";
 import Step from "./components/StepNode";
 import Trigger from "./components/Trigger";
 import Workflow from "./components/Workflow";
-import { NodeTypeSchema, RuntimeKindSchema } from "./types/StepOpts";
-import { CronTriggerOptsSchema, HttpTriggerOptsSchema, PubSubProviderSchema, PubSubTriggerOptsSchema, QueueProviderSchema, QueueTriggerOptsSchema, SSETriggerOptsSchema, TriggerOptsSchema, 
+import { branch } from "./components/branch";
+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 { 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, } from "./types/TriggerOpts";
-export { AddElse, AddIf, HelperResponse, NodeTypeSchema, RuntimeKindSchema, Step, Trigger, Workflow, TriggerOptsSchema, HttpTriggerOptsSchema, QueueProviderSchema, QueueTriggerOptsSchema, PubSubProviderSchema, PubSubTriggerOptsSchema, WorkerTriggerOptsSchema, CronTriggerOptsSchema, WebhookTriggerOptsSchema, WebSocketTriggerOptsSchema, SSETriggerOptsSchema, TriggersSchema, };
+TriggersSchema, WebSocketTriggerOptsSchema, WebhookTriggerOptsSchema, 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, 
+// 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, 
+// 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,EAAY,cAAc,EAAe,iBAAiB,EAAwB,MAAM,kBAAkB,CAAC;AAClH,OAAO,EAGN,qBAAqB,EACrB,qBAAqB,EAGrB,oBAAoB,EAEpB,uBAAuB,EAGvB,mBAAmB,EAEnB,sBAAsB,EAGtB,oBAAoB,EAGpB,iBAAiB;AAEjB,gBAAgB;AAChB,cAAc,EAGd,0BAA0B,EAG1B,wBAAwB,EAGxB,uBAAuB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,OAAO,EACP,KAAK,EAEL,cAAc,EAEd,cAAc,EAEd,iBAAiB,EACjB,IAAI,EAGJ,OAAO,EACP,QAAQ,EAGR,iBAAiB,EACjB,qBAAqB,EAErB,mBAAmB,EAEnB,sBAAsB,EAEtB,oBAAoB,EAEpB,uBAAuB,EAEvB,uBAAuB,EAEvB,qBAAqB,EAErB,wBAAwB,EAExB,0BAA0B,EAE1B,oBAAoB,EACpB,cAAc,GAEd,CAAC"}
+{"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"}