bunqueue 2.6.116 → 2.7.1

package/dist/client/workflow/workflow.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Workflow - DSL builder for defining workflow step graphs
+ * Pure data structure, no side effects.
+ */
+import type { WorkflowNode, StepHandler, StepOptions, StepContext, BranchCondition } from './types';
+export declare class Workflow<TInput = unknown> {
+    readonly name: string;
+    readonly nodes: WorkflowNode[];
+    constructor(name: string);
+    /** Add a step to the workflow */
+    step(name: string, handler: StepHandler<TInput>, options?: StepOptions<TInput>): this;
+    /** Add a branch point — call .path() after this to define paths */
+    branch(condition: BranchCondition): this;
+    /** Define a branch path (must follow a .branch() call) */
+    path(name: string, builder: (w: Workflow<TInput>) => Workflow<TInput>): this;
+    /** Run multiple steps in parallel */
+    parallel(builder: (w: Workflow<TInput>) => Workflow<TInput>): this;
+    /** Call another registered workflow as a step */
+    subWorkflow(name: string, inputMapper: (ctx: StepContext<TInput>) => unknown): this;
+    /** Wait for an external signal before continuing */
+    waitFor(event: string, options?: {
+        timeout?: number;
+    }): this;
+    /** Get flat list of step names for validation */
+    getStepNames(): string[];
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/client/workflow/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/client/workflow/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAEX,WAAW,EAEX,WAAW,EACX,eAAe,EAEhB,MAAM,SAAS,CAAC;AAEjB,qBAAa,QAAQ,CAAC,MAAM,GAAG,OAAO;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAM;gBAExB,IAAI,EAAE,MAAM;IAIxB,iCAAiC;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAcrF,mEAAmE;IACnE,MAAM,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAQxC,0DAA0D;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAc5E,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAalE,iDAAiD;IACjD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,OAAO,GAAG,IAAI;IASnF,oDAAoD;IACpD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAS5D,iDAAiD;IACjD,YAAY,IAAI,MAAM,EAAE;CAiBzB"}

package/dist/client/workflow/workflow.js

@@ -0,0 +1,102 @@
+/**
+ * Workflow - DSL builder for defining workflow step graphs
+ * Pure data structure, no side effects.
+ */
+export class Workflow {
+    name;
+    nodes = [];
+    constructor(name) {
+        this.name = name;
+    }
+    /** Add a step to the workflow */
+    step(name, handler, options) {
+        this.nodes.push({
+            type: 'step',
+            def: {
+                name,
+                handler: handler,
+                compensate: options?.compensate,
+                retry: options?.retry ?? 3,
+                timeout: options?.timeout ?? 30_000,
+            },
+        });
+        return this;
+    }
+    /** Add a branch point — call .path() after this to define paths */
+    branch(condition) {
+        this.nodes.push({
+            type: 'branch',
+            def: { condition, paths: new Map() },
+        });
+        return this;
+    }
+    /** Define a branch path (must follow a .branch() call) */
+    path(name, builder) {
+        const lastNode = this.nodes[this.nodes.length - 1];
+        if (lastNode?.type !== 'branch') {
+            throw new Error('path() must follow a branch() call');
+        }
+        const sub = new Workflow(`${this.name}:${name}`);
+        builder(sub);
+        const steps = sub.nodes
+            .filter((n) => n.type === 'step')
+            .map((n) => n.def);
+        lastNode.def.paths.set(name, steps);
+        return this;
+    }
+    /** Run multiple steps in parallel */
+    parallel(builder) {
+        const sub = new Workflow(`${this.name}:parallel`);
+        builder(sub);
+        const steps = sub.nodes
+            .filter((n) => n.type === 'step')
+            .map((n) => n.def);
+        if (steps.length === 0) {
+            throw new Error('parallel() requires at least one step');
+        }
+        this.nodes.push({ type: 'parallel', def: { steps } });
+        return this;
+    }
+    /** Call another registered workflow as a step */
+    subWorkflow(name, inputMapper) {
+        this.nodes.push({
+            type: 'subWorkflow',
+            name,
+            inputMapper: inputMapper,
+        });
+        return this;
+    }
+    /** Wait for an external signal before continuing */
+    waitFor(event, options) {
+        this.nodes.push({
+            type: 'waitFor',
+            event,
+            timeout: options?.timeout,
+        });
+        return this;
+    }
+    /** Get flat list of step names for validation */
+    getStepNames() {
+        const names = [];
+        for (const node of this.nodes) {
+            if (node.type === 'step') {
+                names.push(node.def.name);
+            }
+            else if (node.type === 'branch') {
+                for (const steps of node.def.paths.values()) {
+                    for (const s of steps)
+                        names.push(s.name);
+                }
+            }
+            else if (node.type === 'parallel') {
+                for (const s of node.def.steps)
+                    names.push(s.name);
+            }
+            else if (node.type === 'subWorkflow') {
+                names.push(`sub:${node.name}`);
+            }
+        }
+        return names;
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/client/workflow/workflow.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunqueue",
-  "version": "2.6.116",
+  "version": "2.7.1",
   "description": "High-performance job queue for Bun & AI agents. SQLite persistence, cron scheduling, priorities, retries, DLQ, webhooks, native MCP server. Zero external dependencies.",
   "type": "module",
   "main": "dist/main.js",
@@ -25,6 +25,10 @@
     "./mcp": {
       "types": "./dist/mcp/index.d.ts",
       "import": "./dist/mcp/index.js"
+    },
+    "./workflow": {
+      "types": "./dist/client/workflow/index.d.ts",
+      "import": "./dist/client/workflow/index.js"
     }
   },
   "files": [
@@ -105,7 +109,18 @@
     "mcp",
     "model-context-protocol",
     "agentic",
-    "automation"
+    "automation",
+    "workflow",
+    "workflow-engine",
+    "orchestration",
+    "saga",
+    "saga-pattern",
+    "temporal-alternative",
+    "inngest-alternative",
+    "step-functions",
+    "multi-step",
+    "compensation",
+    "human-in-the-loop"
   ],
   "author": "egeominotti",
   "license": "MIT",