@siglo/core 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jerico de guzman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,101 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="../../docs/assets/siglo-logo.png" alt="Siglo Logo" width="220" style="border-radius: 16px;" />
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Siglo Core
+> Zero-daemon, in-process workflow orchestration with durable checkpoints, Sagas, and live visual DevTools.
+
+[![NPM Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://www.npmjs.com/package/siglo)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node Version](https://img.shields.io/badge/node-%5E22.13.0%20%7C%7C%20%3E%3D24.0.0-brightgreen.svg)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)]()
+
+**Siglo** is a lightweight, zero-daemon workflow runtime for TypeScript. It orchestrates complex business logic into composable, resilient steps—featuring end-to-end type inference, automatic Sagas, durable checkpoints, and live DevTools without external infrastructure.
+
+---
+
+## Positioning: In-Process Orchestration vs Distributed Engines
+
+| Dimension | `Siglo` | Distributed Engines (Temporal, Inngest) |
+|---|---|---|
+| **Architecture** | Lightweight, zero-infrastructure in-process library | Heavy multi-cluster / external orchestrator daemon |
+| **Latency** | Microsecond direct async function invocation | Millisecond-to-second RPC / polling overhead |
+| **Footprint** | Zero external dependencies, pure TypeScript | Requires persistent workers, queue servers, and databases |
+| **Primary Focus** | Modular workflows, parallel fan-out/fan-in, bounded worker mapping, request-scoped sagas, idempotency, durable event waits, retry backoff with jitter, OCC checkpointing | Months-long durable human-in-the-loop workflows |
+
+---
+
+## Documentation & Topic Guides
+
+Explore the 11 comprehensive guides covering architecture, design patterns, testing, and production operations:
+
+1. 🚀 [01. Getting Started](../../docs/01-getting-started.md) &mdash; Installation, quickstart walkthrough, minimal examples, and CLI scaffolding.
+2. 💡 [02. Core Concepts](../../docs/02-core-concepts.md) &mdash; Executable ASTs, accumulated context immutability, 5-phase step lifecycle, and reserved keys.
+3. ⛓️ [03. Sequential Workflows](../../docs/03-sequential-workflows.md) &mdash; Linear pipelines, clean POJO parameters, lifecycle hooks (`onBefore`, `onSkip`, `onAfter`), and caching.
+4. 🔀 [04. Branching and Parallelism](../../docs/04-branching-and-parallelism.md) &mdash; Concurrent fan-outs (`parallel`, `all`, `allSettled`, `race`), dynamic routing (`when`, `branch`), and bounded mapping (`map`).
+5. 🛡️ [05. Retries, Timeouts, and Cancellation](../../docs/05-retries-timeouts-and-cancellation.md) &mdash; Two-tier timeouts, exponential backoff with jitter, cooperative `AbortSignal` cancellation, and saga rollbacks.
+6. ⏳ [06. Durable Workflows](../../docs/06-durable-workflows.md) &mdash; Long-running human-in-the-loop waits (`waitForEvent`, `wait`), checkpoint resumption, and state migrations.
+7. 💾 [07. Storage and Adapters](../../docs/07-storage-and-adapters.md) &mdash; Distributed persistence contracts, PostgreSQL & Redis adapters, and multi-tenant namespaces.
+8. 🔭 [08. Observability](../../docs/08-observability.md) &mdash; Graph exports (Mermaid, DOT, JSON), OpenTelemetry distributed tracing, and W3C trace propagation.
+9. 🧪 [09. Testing and Replay](../../docs/09-testing-and-replay.md) &mdash; Deterministic workflow harnesses (`@siglo/testing`), fake clocks, step spies, mocks, and failure replay.
+10. 🏷️ [10. TypeScript Reference](../../docs/10-typescript-reference.md) &mdash; End-to-end accumulated context inference, typed step history (`$steps`), and Standard Schema integration.
+11. 🏭 [11. Production Operations](../../docs/11-production-operations.md) &mdash; Production deployment checklist, zero-daemon operational topologies, connection pooling, and retention cleanup.
+
+---
+
+## Quickstart: Type-Safe Composable Flows
+
+```typescript
+import { Step, flow } from '@siglo/core';
+
+// 1. Define modular steps with input/output contracts
+const fetchUser = Step.create('fetchUser', async (param: { userId: string }) => {
+    return { name: 'Alice', tier: 'PRO' };
+});
+
+const calculateDiscount = Step.create('calculateDiscount', async (param: { tier: string }) => {
+    const discount = param.tier === 'PRO' ? 0.20 : 0.05;
+    return { discountPercentage: discount };
+});
+
+// 2. Compose into an executable flow
+export const orderWorkflow = flow(fetchUser, calculateDiscount);
+
+// 3. Run the flow with full type safety
+async function main() {
+    const result = await orderWorkflow.run({ userId: 'u_123' }, { pojo: true });
+    console.log(result.name);               // 'Alice'
+    console.log(result.discountPercentage); // 0.20
+    console.log(result.$steps.fetchUser);   // { name: 'Alice', tier: 'PRO' }
+}
+
+main();
+```
+
+---
+
+## Key Features
+
+- ⚡ **Composable Flows (`flow`)** &mdash; Compose steps directly into workflows without global registries; steps are pure execution units.
+- 🧠 **Accumulated Context Inference** &mdash; TypeScript automatically computes the accumulated output type across composed sequential steps at compile time.
+- 📜 **Typed Step History (`$steps`)** &mdash; Statically typed access to any step's output using string literal names (`context.$steps.loadUser.user`).
+- 🗺️ **Workflow Graph Visualization** &mdash; Export workflow graphs directly to Mermaid diagrams (`flow.toMermaid()`), Graphviz DOT (`flow.toDot()`), and JSON AST (`flow.toJSON()`) with policy badges.
+- 💉 **Runtime Dependency Injection** &mdash; Inject services and repositories explicitly via `options.services` or step-level `step.withDependencies()`.
+- 🔀 **Parallel Execution Combinators** &mdash; Run branches concurrently with `parallel`, `all`, `allSettled`, and `race`, equipped with branch context isolation and configurable merge strategies.
+- 🌿 **Conditional Branching & Routing** &mdash; Dynamic decision routing via `when(predicate, thenStep).otherwise(elseStep)` and multi-branch selectors via `branch({...})`.
+- 🔄 **Dynamic Mapping & Bounded Concurrency** &mdash; Process arrays with `map(items, step, { concurrency })`, order preservation, and error aggregation.
+- 🔑 **Scoped Idempotency & Deduplication** &mdash; Protect workflows and individual steps (`step.idempotent()`) with deterministic hash keys and TTL stores.
+- ⏪ **Sagas & LIFO Compensations** &mdash; Attach rollback handlers (`step.compensate(handler)`) that run automatically in reverse execution order upon failure.
+- ⏳ **Durable Waits & Event Resumption** &mdash; Pause execution with `waitForEvent(eventName)` or `wait('30m')`, persist suspended checkpoints, and safely resume workflows.
+- 🏷️ **Workflow Versioning & State Migrations** &mdash; Declare workflow versions (`flow.version('v2')`), detect version mismatches upon resumption, and run registered state transformation functions.
+- ⏱️ **Resilient Deadlines & Two-Tier Timeouts** &mdash; Enforce per-step SLA (`step.timeout(ms)`) and workflow-level deadlines (`flow.timeout(ms)`).\
+- 🔁 **Structured Retry Strategies** &mdash; Automatic retries with exponential, linear, or fixed backoff, jitter, and `onRetry` hooks right in `onFail`.\
+- 📦 **Standard Schema Integration (`spec` / `schema`)** &mdash; Native Standard Schema, Zod, Valibot, and ArkType contract enforcement.\
+- 🛑 **Graceful Cancellation & AbortSignals** &mdash; Cancel flows, in-flight async steps, and retry timers seamlessly using standard `AbortSignal`.
+
+---
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](../../LICENSE) file for details.

package/dist/features/cache/index.d.ts

@@ -0,0 +1,9 @@
+export interface CacheOptions {
+    ttl?: number;
+    staleWhileRevalidate?: number;
+    swr?: boolean | number;
+    keySerializer?: (stepId: string, param: any, namespace?: string) => string;
+    stampedeProtection?: boolean;
+}
+export declare function cache(stackId: string, stepId: string, param: any, cachedLast: number, action: (param: any) => any, namespace?: string, options?: CacheOptions): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/features/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/cache/index.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAID,wBAAgB,KAAK,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,EACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EAC3B,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACvB,GAAG,CAgML"}

package/dist/features/cache/index.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cache = cache;
+const shared_1 = require("../../shared");
+const storage_1 = require("../storage");
+const context_1 = require("../context");
+const inFlightPromises = new Map();
+function cache(stackId, stepId, param, cachedLast, action, namespace, options) {
+    const adapter = storage_1.defaultStorageManager.getStorageAdapter();
+    const cleanParam = (0, context_1.toPOJO)(param);
+    const paramToHash = Object.assign({}, cleanParam);
+    const internalKeys = [
+        shared_1.STEP_ID,
+        shared_1.STACK_ID,
+        shared_1.VALIDATORS,
+        shared_1.STEPS,
+        shared_1.HISTORY,
+        shared_1.SIGNAL,
+        shared_1.SIGNAL_KEY,
+        'props',
+        'raw',
+        shared_1.ATTEMPT,
+        shared_1.RETRY_DELAY,
+        shared_1.WORKFLOW_ID
+    ];
+    for (const ik of internalKeys) {
+        delete paramToHash[ik];
+    }
+    delete paramToHash[shared_1.NAMESPACE];
+    delete paramToHash[shared_1.NAMESPACE_KEY];
+    delete paramToHash[shared_1.STACK_ID_KEY];
+    const customSerializer = options?.keySerializer || (storage_1.defaultStorageManager.getState().config?.cacheKeySerializer);
+    const paramKey = customSerializer
+        ? customSerializer(stepId, paramToHash, namespace)
+        : JSON.stringify(paramToHash);
+    const effectiveCacheKey = namespace
+        ? `${namespace}:${stepId}:${paramKey}`
+        : `${stepId}:${paramKey}`;
+    const swrWindow = typeof options?.swr === 'number'
+        ? options.swr
+        : (options?.staleWhileRevalidate || (options?.swr ? cachedLast : 0));
+    // 1. In-Memory Cache Lookup
+    if ((0, storage_1.hasCached)(stackId, effectiveCacheKey, paramKey)) {
+        const cachedAction = (0, storage_1.getCachedChainAction)(stackId, effectiveCacheKey, paramKey);
+        const currentTime = Date.now();
+        const expirationTime = cachedAction.timestamp + cachedLast;
+        if (currentTime <= expirationTime) {
+            storage_1.defaultStorageManager.emitCacheEvent({
+                type: 'hit',
+                key: effectiveCacheKey,
+                stepId,
+                stackId,
+                namespace,
+                timestamp: currentTime
+            });
+            return cachedAction.result;
+        }
+        else if (swrWindow > 0 && currentTime <= expirationTime + swrWindow) {
+            storage_1.defaultStorageManager.emitCacheEvent({
+                type: 'hit',
+                key: effectiveCacheKey,
+                stepId,
+                stackId,
+                namespace,
+                timestamp: currentTime
+            });
+            // Background revalidation
+            Promise.resolve().then(async () => {
+                try {
+                    const fresh = await action(param);
+                    (0, storage_1.cacheChainAction)(stackId, effectiveCacheKey, paramKey, fresh);
+                    if (adapter?.setCachedStep) {
+                        try {
+                            await adapter.setCachedStep(effectiveCacheKey, fresh, cachedLast);
+                        }
+                        catch (err) {
+                            storage_1.defaultStorageManager.handleAdapterError('setCachedStep', err);
+                        }
+                    }
+                }
+                catch {
+                    // Suppress background revalidation error
+                }
+            });
+            return cachedAction.result;
+        }
+        else {
+            (0, storage_1.clearCache)(stackId, effectiveCacheKey);
+        }
+    }
+    // 2. Cache Stampede Protection (In-flight Promise deduplication)
+    const useStampedeProtection = options?.stampedeProtection !== false;
+    if (useStampedeProtection && inFlightPromises.has(effectiveCacheKey)) {
+        return inFlightPromises.get(effectiveCacheKey);
+    }
+    // 3. Adapter Distributed Cache Lookup
+    if (adapter?.getCachedStep) {
+        const executionPromise = (async () => {
+            try {
+                const adapterCached = await adapter.getCachedStep(effectiveCacheKey);
+                if (adapterCached !== undefined) {
+                    storage_1.defaultStorageManager.emitCacheEvent({
+                        type: 'hit',
+                        key: effectiveCacheKey,
+                        stepId,
+                        stackId,
+                        namespace,
+                        timestamp: Date.now()
+                    });
+                    (0, storage_1.cacheChainAction)(stackId, effectiveCacheKey, paramKey, adapterCached);
+                    return adapterCached;
+                }
+            }
+            catch (err) {
+                storage_1.defaultStorageManager.handleAdapterError('getCachedStep', err);
+            }
+            storage_1.defaultStorageManager.emitCacheEvent({
+                type: 'miss',
+                key: effectiveCacheKey,
+                stepId,
+                stackId,
+                namespace,
+                timestamp: Date.now()
+            });
+            const actionResult = await action(param);
+            (0, storage_1.cacheChainAction)(stackId, effectiveCacheKey, paramKey, actionResult);
+            if (adapter?.setCachedStep) {
+                try {
+                    await adapter.setCachedStep(effectiveCacheKey, actionResult, cachedLast);
+                }
+                catch (err) {
+                    storage_1.defaultStorageManager.handleAdapterError('setCachedStep', err);
+                }
+            }
+            return actionResult;
+        })();
+        if (useStampedeProtection) {
+            inFlightPromises.set(effectiveCacheKey, executionPromise);
+            const clean = () => { inFlightPromises.delete(effectiveCacheKey); };
+            executionPromise.then(clean, clean);
+        }
+        return executionPromise;
+    }
+    storage_1.defaultStorageManager.emitCacheEvent({
+        type: 'miss',
+        key: effectiveCacheKey,
+        stepId,
+        stackId,
+        namespace,
+        timestamp: Date.now()
+    });
+    // 4. Local Execution
+    const rawResult = action(param);
+    if (rawResult instanceof Promise) {
+        const executionPromise = rawResult.then(async (val) => {
+            (0, storage_1.cacheChainAction)(stackId, effectiveCacheKey, paramKey, val);
+            if (adapter?.setCachedStep) {
+                try {
+                    await adapter.setCachedStep(effectiveCacheKey, val, cachedLast);
+                }
+                catch (err) {
+                    storage_1.defaultStorageManager.handleAdapterError('setCachedStep', err);
+                }
+            }
+            return val;
+        });
+        if (useStampedeProtection) {
+            inFlightPromises.set(effectiveCacheKey, executionPromise);
+            const clean = () => { inFlightPromises.delete(effectiveCacheKey); };
+            executionPromise.then(clean, clean);
+        }
+        return executionPromise;
+    }
+    // Synchronous execution result
+    (0, storage_1.cacheChainAction)(stackId, effectiveCacheKey, paramKey, rawResult);
+    if (adapter?.setCachedStep) {
+        try {
+            const setRes = adapter.setCachedStep(effectiveCacheKey, rawResult, cachedLast);
+            if (setRes && typeof setRes.catch === 'function') {
+                setRes.catch((err) => {
+                    try {
+                        storage_1.defaultStorageManager.handleAdapterError('setCachedStep', err);
+                    }
+                    catch {
+                        // Suppress unhandled rejection in background fire-and-forget sync write
+                    }
+                });
+            }
+        }
+        catch (err) {
+            storage_1.defaultStorageManager.handleAdapterError('setCachedStep', err);
+        }
+    }
+    return rawResult;
+}
+//# sourceMappingURL=index.js.map

package/dist/features/cache/index.js.map

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

package/dist/features/combinators/branch.d.ts

@@ -0,0 +1,12 @@
+import { Step } from '../step';
+export type BranchPredicate = (ctx: any, meta?: any) => boolean | Promise<boolean>;
+export type BranchSelector = (ctx: any, meta?: any) => string | Promise<string>;
+export declare const BranchRoute: {
+    readonly THEN: "then";
+    readonly ELSE: "else";
+    readonly DEFAULT: "default";
+};
+export type BranchRoute = (typeof BranchRoute)[keyof typeof BranchRoute];
+export declare function when(predicate: BranchPredicate, thenStep: any, elseStep?: any): Step<any, any>;
+export declare function branch(selectorOrBranches: BranchSelector | Record<string, any>, branchesMap?: Record<string, any>, defaultBranch?: any): Step<any, any>;
+//# sourceMappingURL=branch.d.ts.map

package/dist/features/combinators/branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../../src/features/combinators/branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAO,MAAM,SAAS,CAAC;AAKnC,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhF,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAwCzE,wBAAgB,IAAI,CAChB,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,GAAG,EACb,QAAQ,CAAC,EAAE,GAAG,GACf,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAqDhB;AAED,wBAAgB,MAAM,CAClB,kBAAkB,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,aAAa,CAAC,EAAE,GAAG,GACpB,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CA+DhB"}

package/dist/features/combinators/branch.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BranchRoute = void 0;
+exports.when = when;
+exports.branch = branch;
+const step_1 = require("../step");
+const context_1 = require("../context");
+const shared_1 = require("../../shared");
+const graph_1 = require("../graph");
+exports.BranchRoute = {
+    THEN: 'then',
+    ELSE: 'else',
+    DEFAULT: 'default'
+};
+function cleanBranchOutput(output) {
+    if (!(0, shared_1.isObject)(output)) {
+        return output;
+    }
+    const clean = {};
+    for (const key of Object.keys(output)) {
+        if ((0, shared_1.isReservedKey)(key) ||
+            (0, shared_1.isFunction)(output[key])) {
+            continue;
+        }
+        clean[key] = output[key];
+    }
+    return clean;
+}
+function executeBranchTarget(target, input, signal) {
+    const isolatedInput = (0, shared_1.safeClone)((0, context_1.toPOJO)(input));
+    const parentStackId = (0, shared_1.isFunction)(input?.$stackId) ? input.$stackId() : (input?.$stackId || input?.stackId);
+    const namespace = (0, shared_1.isFunction)(input?.$namespace) ? input.$namespace() : (input?.$namespace || input?.namespace);
+    const branchOptions = { signal, pojo: true, stackId: parentStackId, namespace };
+    if ((0, shared_1.isFunction)(target)) {
+        return Promise.resolve(target(isolatedInput, branchOptions));
+    }
+    if (target && (0, shared_1.isFunction)(target.execute)) {
+        return target.execute(isolatedInput, branchOptions);
+    }
+    if (target && (0, shared_1.isFunction)(target.run)) {
+        return target.run(isolatedInput, branchOptions);
+    }
+    if (target && (0, shared_1.isFunction)(target.start)) {
+        return target.start(isolatedInput, branchOptions);
+    }
+    return (0, step_1.flow)(target).execute(isolatedInput, branchOptions);
+}
+function when(predicate, thenStep, elseStep) {
+    const thenNode = (0, graph_1.toGraph)(thenStep);
+    const elseNode = elseStep ? (0, graph_1.toGraph)(elseStep) : undefined;
+    const branchNode = {
+        id: (0, shared_1.generateUUID)(),
+        name: 'when',
+        type: shared_1.WorkflowNodeType.BRANCH,
+        branches: {
+            then: thenNode,
+            ...(elseNode ? { else: elseNode } : {})
+        },
+        selector: predicate
+    };
+    const step = step_1.Step.create('when', async (param) => {
+        const rawSig = param?.$signal || param?.signal;
+        const signal = (0, shared_1.isFunction)(rawSig) ? (rawSig.val || rawSig()) : rawSig;
+        const meta = {
+            attempt: (0, shared_1.isFunction)(param?.$attempt) ? param.$attempt() : param?.$attempt,
+            stackId: (0, shared_1.isFunction)(param?.$stackId) ? param.$stackId() : param?.$stackId,
+            namespace: (0, shared_1.isFunction)(param?.$namespace) ? param.$namespace() : param?.namespace
+        };
+        const isTrue = await predicate((0, context_1.toPOJO)(param), meta);
+        if (isTrue) {
+            const result = await executeBranchTarget(thenStep, param, signal);
+            const cleaned = cleanBranchOutput(result);
+            return {
+                ...((0, shared_1.isObject)(cleaned) ? cleaned : { value: cleaned }),
+                $branchSelected: exports.BranchRoute.THEN,
+                $skippedBranches: elseStep ? [exports.BranchRoute.ELSE] : []
+            };
+        }
+        else if (elseStep) {
+            const result = await executeBranchTarget(elseStep, param, signal);
+            const cleaned = cleanBranchOutput(result);
+            return {
+                ...((0, shared_1.isObject)(cleaned) ? cleaned : { value: cleaned }),
+                $branchSelected: exports.BranchRoute.ELSE,
+                $skippedBranches: [exports.BranchRoute.THEN]
+            };
+        }
+        else {
+            return {
+                $branchSelected: undefined,
+                $skippedBranches: [exports.BranchRoute.THEN],
+                $skipped: true
+            };
+        }
+    });
+    step.workflowNode = branchNode;
+    return step;
+}
+function branch(selectorOrBranches, branchesMap, defaultBranch) {
+    let selector;
+    let branches;
+    let fallback;
+    if ((0, shared_1.isFunction)(selectorOrBranches)) {
+        selector = selectorOrBranches;
+        branches = branchesMap || {};
+        fallback = defaultBranch;
+    }
+    else {
+        branches = selectorOrBranches;
+        fallback = branchesMap;
+        selector = (ctx) => ctx.branch || ctx.status || ctx.choice || exports.BranchRoute.DEFAULT;
+    }
+    const branchNodes = {};
+    for (const key of Object.keys(branches)) {
+        branchNodes[key] = (0, graph_1.toGraph)(branches[key]);
+    }
+    const defaultNode = fallback ? (0, graph_1.toGraph)(fallback) : undefined;
+    const branchNode = {
+        id: (0, shared_1.generateUUID)(),
+        name: 'branch',
+        type: shared_1.WorkflowNodeType.BRANCH,
+        branches: branchNodes,
+        selector,
+        defaultBranch: defaultNode
+    };
+    const step = step_1.Step.create('branch', async (param) => {
+        const rawSig = param?.$signal || param?.signal;
+        const signal = (0, shared_1.isFunction)(rawSig) ? (rawSig.val || rawSig()) : rawSig;
+        const meta = {
+            attempt: (0, shared_1.isFunction)(param?.$attempt) ? param.$attempt() : param?.$attempt,
+            stackId: (0, shared_1.isFunction)(param?.$stackId) ? param.$stackId() : param?.$stackId,
+            namespace: (0, shared_1.isFunction)(param?.$namespace) ? param.$namespace() : param?.namespace
+        };
+        const chosenKey = await selector((0, context_1.toPOJO)(param), meta);
+        const target = branches[chosenKey] || fallback;
+        const allKeys = Object.keys(branches);
+        const skippedBranches = allKeys.filter(k => k !== chosenKey);
+        if (!target) {
+            return {
+                $branchSelected: undefined,
+                $skippedBranches: allKeys,
+                $skipped: true
+            };
+        }
+        const result = await executeBranchTarget(target, param, signal);
+        const cleaned = cleanBranchOutput(result);
+        return {
+            ...((0, shared_1.isObject)(cleaned) ? cleaned : { value: cleaned }),
+            $branchSelected: chosenKey,
+            $skippedBranches: skippedBranches
+        };
+    });
+    step.workflowNode = branchNode;
+    return step;
+}
+//# sourceMappingURL=branch.js.map

package/dist/features/combinators/branch.js.map

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

package/dist/features/combinators/index.d.ts

@@ -0,0 +1,4 @@
+export * from './parallel';
+export * from './branch';
+export * from './map';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/combinators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/combinators/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC"}

package/dist/features/combinators/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./parallel"), exports);
+__exportStar(require("./branch"), exports);
+__exportStar(require("./map"), exports);
+//# sourceMappingURL=index.js.map

package/dist/features/combinators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/combinators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,2CAAyB;AACzB,wCAAsB"}

package/dist/features/combinators/map.d.ts

@@ -0,0 +1,10 @@
+import { Step } from '../step';
+export interface MapOptions {
+    name?: string;
+    concurrency?: number;
+    stopOnError?: boolean;
+    preserveOrder?: boolean;
+}
+export type MapItemAccessor = any[] | AsyncIterable<any> | Iterable<any> | ((ctx: any) => any[] | AsyncIterable<any> | Iterable<any> | Promise<any[] | AsyncIterable<any> | Iterable<any>>);
+export declare function map(itemsOrAccessor: MapItemAccessor, processItem: any, options?: MapOptions): Step<any, any>;
+//# sourceMappingURL=map.d.ts.map

package/dist/features/combinators/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/features/combinators/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAO,MAAM,SAAS,CAAC;AAMnC,MAAM,WAAW,UAAU;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GACvB,GAAG,EAAE,GACH,aAAa,CAAC,GAAG,CAAC,GAClB,QAAQ,CAAC,GAAG,CAAC,GACb,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAmDvH,wBAAgB,GAAG,CACf,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,GAAG,EAChB,OAAO,CAAC,EAAE,UAAU,GACrB,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAoIhB"}