@lotiai/composer 0.2.0 → 0.2.1

package/dist/internal/context-provider.d.ts

@@ -0,0 +1,316 @@
+/**
+ * Context Provider Types for Composer
+ *
+ * This module defines the generic context provider pattern that allows
+ * steps to receive context (e.g., database connections) via lifecycle hooks.
+ *
+ * The context provider is configured once via createComposer() and used
+ * for both sync and async workflow execution.
+ */
+import type { ScheduleDefinition } from "./async/schedule/define-schedule";
+import type { SyncSchedulesResult } from "./async/schedule/sync-schedules";
+import type { ExtractWorkflowBag, ExtractWorkflowCheckpointNames, ExtractWorkflowConfig, ExtractWorkflowRequiredInitial, ExtractWorkflowSteps, InferWorkflowResult, SafeConfiguredKeys, Workflow, WorkflowResult } from "./dag-sync-workflow";
+import type { ComposerLogger } from "./types";
+/**
+ * Step Context Provider - manages context lifecycle for steps.
+ *
+ * Implement this interface to provide context (e.g., database connections,
+ * loggers) to steps. The beforeStep/afterStep hooks ensure proper lifecycle
+ * management (creation and cleanup).
+ *
+ * @typeParam TContext - The context type that steps will receive
+ *
+ * @example
+ * ```typescript
+ * const contextProvider: StepContextProvider<{ em: SqlEntityManager }> = {
+ *   beforeStep: async (stepName) => ({
+ *     em: await IxDbConnection.getInstance().getForkedEntityManager(),
+ *   }),
+ *   afterStep: async (ctx, error) => {
+ *     if (!error) await ctx.em.flush();
+ *     ctx.em.clear();
+ *   },
+ * };
+ * ```
+ */
+export interface StepContextProvider<TContext> {
+    /**
+     * Called before each step executes.
+     * Returns the context that will be passed to the step's run function.
+     *
+     * @param stepName - The name of the step about to execute
+     * @returns The context for this step execution
+     */
+    beforeStep: (stepName: string) => Promise<TContext>;
+    /**
+     * Called after each step completes (success or failure).
+     * Use this to clean up resources (e.g., clear entity manager).
+     *
+     * @param ctx - The context that was passed to the step
+     * @param error - The error if the step failed, undefined if successful
+     */
+    afterStep: (ctx: TContext, error?: Error) => Promise<void>;
+}
+/**
+ * Configuration for creating a Composer instance.
+ *
+ * @typeParam TContext - The context type that steps will receive
+ *
+ * @example
+ * ```typescript
+ * const composer = createComposer({
+ *   contextProvider: myContextProvider,
+ *   logger: myPinoLogger,     // optional, defaults to console
+ *   deepFreeze: true,         // optional, defaults to false
+ * });
+ * ```
+ */
+export interface ComposerConfig<TContext> {
+    /**
+     * The context provider that manages step context lifecycle.
+     */
+    contextProvider: StepContextProvider<TContext>;
+    /**
+     * Custom logger for framework diagnostics.
+     *
+     * If not provided, defaults to a console-based logger.
+     * The logger is used for internal framework messages (step cleanup failures,
+     * error handler issues, workflow success/failure summaries).
+     *
+     * Any object with `info`, `warn`, `error`, and `debug` methods works.
+     * Compatible with console, pino, winston, and most logging libraries.
+     */
+    logger?: ComposerLogger;
+    /**
+     * Enable deep-freezing of step outputs for immutability protection.
+     *
+     * When enabled, all step outputs are deeply frozen before being merged into
+     * the shared bag. This prevents mutation bugs (parallel batch mutations,
+     * downstream mutations, post-return mutations) at the cost of a small
+     * performance overhead (~0.5-10ms per output depending on object size).
+     *
+     * Recommended for development and testing. In production, enable unless
+     * profiling shows it's a bottleneck.
+     *
+     * @default false
+     */
+    deepFreeze?: boolean;
+    /**
+     * Temporal server configuration for async workflow execution.
+     *
+     * When provided, `createComposer` returns a full `Composer` with async methods.
+     * When omitted, it returns a `SyncComposer` with only `runSyncWorkflow`.
+     */
+    temporal?: TemporalConfig;
+}
+/**
+ * Temporal server connection configuration.
+ */
+export interface TemporalConfig {
+    /** Temporal server address (e.g. "localhost:7233") */
+    serverAddress: string;
+    /** Temporal namespace (e.g. "default") */
+    namespace: string;
+    /**
+     * Service name used as the base for Worker Versioning deployment series
+     * (e.g., "orders-service"). Activity and workflow workers derive their
+     * series names as "{serviceName}-activities" and "{serviceName}-workflows".
+     */
+    serviceName: string;
+    /**
+     * Build identifier for Worker Versioning (typically git commit SHA).
+     * When set, enables versioning for both worker registration and workflow starts.
+     * When unset (e.g., local dev), Worker Versioning is disabled.
+     */
+    buildId?: string;
+}
+/**
+ * Options for async workflow execution.
+ *
+ * @typeParam CheckpointNames - Union of valid checkpoint names for the workflow (defaults to `never`)
+ */
+export interface AsyncWorkflowOptions<CheckpointNames extends string = never> {
+    /**
+     * Optional caller-supplied workflow ID.
+     *
+     * If omitted, Composer generates a UUIDv7 automatically.
+     */
+    workflowId?: string;
+    /**
+     * Checkpoint name to await for early return.
+     *
+     * If specified, returns partial bag state when the checkpoint is reached
+     * instead of waiting for full workflow completion. The workflow continues
+     * executing in the background after the checkpoint.
+     *
+     * Useful for fast HTTP responses while long-running work continues.
+     *
+     * @example
+     * ```typescript
+     * // Workflow with checkpoints
+     * const wf = createWorkflow<Bag>("my-workflow")
+     *   .build([step1, step2, step3])
+     *   .checkpoint("earlyReturn", { afterStep: step1 });
+     *
+     * // Get partial result after step1 completes
+     * const result = await composer.runAsyncWorkflow(wf, data, {
+     *   awaitCheckpoint: "earlyReturn",
+     * });
+     * ```
+     */
+    awaitCheckpoint?: [CheckpointNames] extends [never] ? "ERROR: Cannot use awaitCheckpoint - this workflow has no checkpoints defined" : NoInfer<CheckpointNames>;
+    /**
+     * Start the Temporal workflow and return immediately after Temporal accepts it.
+     *
+     * This is intended for long-running fire-and-forget workflows where the caller
+     * only needs to confirm handoff to Temporal, not wait for business completion.
+     */
+    startOnly?: boolean;
+}
+/**
+ * Sync-only Composer instance.
+ *
+ * Returned by `createComposer()` when no `temporal` config is provided.
+ * Supports only synchronous (in-process) workflow execution.
+ *
+ * Workflows never throw - errors are returned in `result.error`.
+ * Check `result.error` to handle failures, use `result.bag` for success data.
+ *
+ * @typeParam TContext - The context type that steps will receive
+ */
+export interface SyncComposer<TContext> {
+    /**
+     * Run a workflow synchronously (in-process).
+     *
+     * Best for: tests, local development, simple use cases.
+     *
+     * @param workflow - The workflow to execute
+     * @param initialData - Initial data for the workflow bag
+     * @returns WorkflowResult with bag and optional error
+     *
+     * @example
+     * ```typescript
+     * const result = await composer.runSyncWorkflow(myWorkflow, data);
+     * if (result.error) {
+     *   // Handle error
+     * }
+     * // Use result.bag
+     * ```
+     */
+    runSyncWorkflow<W extends Workflow<any, never, any, any, any>>(workflow: W, initialData?: Partial<ExtractWorkflowBag<W>>): Promise<WorkflowResult<InferWorkflowResult<ExtractWorkflowBag<W>, ExtractWorkflowSteps<W>, never, SafeConfiguredKeys<ExtractWorkflowConfig<W>, ExtractWorkflowBag<W>>> & Partial<ExtractWorkflowBag<W>>>>;
+    runSyncWorkflow<W extends Workflow<any, any, any, any, any>>(workflow: W, initialData: Partial<ExtractWorkflowBag<W>> & Pick<ExtractWorkflowBag<W>, ExtractWorkflowRequiredInitial<W>>): Promise<WorkflowResult<InferWorkflowResult<ExtractWorkflowBag<W>, ExtractWorkflowSteps<W>, ExtractWorkflowRequiredInitial<W>, SafeConfiguredKeys<ExtractWorkflowConfig<W>, ExtractWorkflowBag<W>>>>>;
+    /**
+     * Access the underlying context provider.
+     * Useful for advanced use cases or when you need to share the provider.
+     */
+    contextProvider: StepContextProvider<TContext>;
+    /**
+     * The logger used for framework diagnostics.
+     * This is the resolved logger (either the one passed to createComposer or the default).
+     */
+    readonly logger: ComposerLogger;
+}
+/**
+ * Full Composer instance with sync and async workflow support.
+ *
+ * Returned by `createComposer()` when `temporal` config is provided.
+ * Supports both synchronous and Temporal-based async workflow execution.
+ *
+ * @typeParam TContext - The context type that steps will receive
+ */
+export interface Composer<TContext> extends SyncComposer<TContext> {
+    /**
+     * Run a workflow asynchronously via Temporal.
+     *
+     * Best for: production, long-running workflows, reliability.
+     *
+     * @param workflow - The workflow to execute
+     * @param initialData - Initial data for the workflow bag
+     * @param options - Optional execution options (e.g., awaitCheckpoint for early return)
+     * @returns WorkflowResult with bag and optional error
+     *
+     * @example
+     * ```typescript
+     * // Full workflow completion
+     * const result = await composer.runAsyncWorkflow(myWorkflow, data);
+     *
+     * // Early return at checkpoint (workflow continues in background)
+     * const partialResult = await composer.runAsyncWorkflow(myWorkflow, data, {
+     *   awaitCheckpoint: "created",
+     * });
+     * ```
+     */
+    runAsyncWorkflow<W extends Workflow<any, never, any, any, any>>(workflow: W, initialData?: Partial<ExtractWorkflowBag<W>>, options?: AsyncWorkflowOptions<ExtractWorkflowCheckpointNames<W>>): Promise<WorkflowResult<InferWorkflowResult<ExtractWorkflowBag<W>, ExtractWorkflowSteps<W>, never, SafeConfiguredKeys<ExtractWorkflowConfig<W>, ExtractWorkflowBag<W>>> & Partial<ExtractWorkflowBag<W>>>>;
+    runAsyncWorkflow<W extends Workflow<any, any, any, any, any>>(workflow: W, initialData: Partial<ExtractWorkflowBag<W>> & Pick<ExtractWorkflowBag<W>, ExtractWorkflowRequiredInitial<W>>, options?: AsyncWorkflowOptions<ExtractWorkflowCheckpointNames<W>>): Promise<WorkflowResult<InferWorkflowResult<ExtractWorkflowBag<W>, ExtractWorkflowSteps<W>, ExtractWorkflowRequiredInitial<W>, SafeConfiguredKeys<ExtractWorkflowConfig<W>, ExtractWorkflowBag<W>>>>>;
+    /**
+     * Start an async workflow without waiting for completion (fire-and-forget).
+     *
+     * Returns only the workflowId. The workflow executes in the background
+     * on Temporal workers. Use this for 202 Accepted HTTP responses.
+     *
+     * @example
+     * ```typescript
+     * const { workflowId } = await composer.startAsyncWorkflow(myWorkflow, data);
+     * reply.code(202).send({ workflowId });
+     * ```
+     */
+    startAsyncWorkflow<W extends Workflow<any, never, any, any, any>>(workflow: W, initialData?: Partial<ExtractWorkflowBag<W>>): Promise<{
+        workflowId: string;
+    }>;
+    startAsyncWorkflow<W extends Workflow<any, any, any, any, any>>(workflow: W, initialData: Partial<ExtractWorkflowBag<W>> & Pick<ExtractWorkflowBag<W>, ExtractWorkflowRequiredInitial<W>>): Promise<{
+        workflowId: string;
+    }>;
+    /**
+     * The Temporal connection configuration.
+     * Available on full Composer instances (created with temporal config).
+     */
+    readonly temporal: TemporalConfig;
+    /**
+     * Start activity workers for Temporal execution.
+     *
+     * This starts long-running worker processes that execute step business logic.
+     * The Temporal server address, namespace, context provider, and logger are
+     * automatically injected from the Composer's configuration.
+     *
+     * Call this in your worker startup scripts.
+     *
+     * @param config - Activity worker configuration (queues, concurrency)
+     */
+    runActivityWorkers: (config: {
+        taskQueues: string[];
+        maxConcurrentActivityTaskExecutions: number;
+        workflows: Workflow<any, any, any>[];
+    }) => Promise<void>;
+    /**
+     * Start workflow workers for Temporal execution.
+     *
+     * This starts long-running worker processes that generate workflow plans and
+     * execute workflow orchestration logic (batch sequencing, parallel execution).
+     * The Temporal server address, namespace, and logger are automatically injected
+     * from the Composer's configuration.
+     *
+     * Call this in your worker startup scripts.
+     *
+     * @param config - Workflow worker configuration (queues, concurrency, workflows)
+     */
+    runWorkflowWorkers: (config: {
+        taskQueues: string[];
+        maxConcurrentWorkflowTaskExecutions: number;
+        workflows: Workflow<any, any, any>[];
+    }) => Promise<void>;
+    /**
+     * Declaratively sync schedule definitions to the Temporal server.
+     *
+     * Creates new schedules, updates existing ones, and deletes composer-managed
+     * schedules that are no longer in the definitions. Non-composer schedules
+     * (without the `managedBy: "composer"` memo) are never touched.
+     *
+     * @param schedules - Schedule definitions (source of truth)
+     * @param options - Optional sync options
+     * @returns Summary of what was created, updated, and deleted
+     */
+    syncSchedules: (schedules: ScheduleDefinition[], options?: {
+        dryRun?: boolean;
+    }) => Promise<SyncSchedulesResult>;
+}
+//# sourceMappingURL=context-provider.d.ts.map

package/dist/internal/context-provider.d.ts.map

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

package/dist/internal/context-provider.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Context Provider Types for Composer
+ *
+ * This module defines the generic context provider pattern that allows
+ * steps to receive context (e.g., database connections) via lifecycle hooks.
+ *
+ * The context provider is configured once via createComposer() and used
+ * for both sync and async workflow execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context-provider.js.map

package/dist/internal/context-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-provider.js","sourceRoot":"","sources":["../../src/internal/context-provider.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/internal/create-composer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Composer Factory
+ *
+ * Creates a configured Composer instance with methods for running workflows
+ * synchronously or asynchronously, and for starting activity workers.
+ *
+ * The composer provides a unified interface that uses the same context provider
+ * for all execution modes, ensuring consistent context management.
+ */
+import type { Composer, ComposerConfig, SyncComposer, TemporalConfig } from "./context-provider";
+/**
+ * Creates a Composer instance with the given configuration.
+ *
+ * The composer provides methods for:
+ * - `runSyncWorkflow`: Execute workflows synchronously (in-process)
+ * - `runAsyncWorkflow`: Execute workflows via Temporal
+ * - `runActivityWorkers`: Start Temporal activity workers
+ *
+ * All methods use the same context provider, ensuring consistent context management.
+ *
+ * @param config - Configuration including the context provider
+ * @returns A configured Composer instance
+ *
+ * @example
+ * ```typescript
+ * const composer = createComposer({
+ *   contextProvider: {
+ *     beforeStep: async () => ({
+ *       em: await IxDbConnection.getInstance().getForkedEntityManager(),
+ *     }),
+ *     afterStep: async (ctx, error) => {
+ *       if (!error) await ctx.em.flush();
+ *       ctx.em.clear();
+ *     },
+ *   },
+ * });
+ *
+ * // Run sync workflow
+ * const result = await composer.runSyncWorkflow(myWorkflow, initialData);
+ *
+ * // Run async workflow
+ * const result = await composer.runAsyncWorkflow(myWorkflow, initialData);
+ *
+ * // Start activity workers (in worker script)
+ * await composer.runActivityWorkers({
+ *   serverAddress: "localhost:7233",
+ *   namespace: "default",
+ *   taskQueues: ["standard-tasks"],
+ *   maxConcurrentActivityTaskExecutions: 10,
+ * });
+ * ```
+ */
+export declare function createComposer<TContext>(config: ComposerConfig<TContext> & {
+    temporal: TemporalConfig;
+}): Composer<TContext>;
+export declare function createComposer<TContext>(config: ComposerConfig<TContext>): SyncComposer<TContext>;
+//# sourceMappingURL=create-composer.d.ts.map

package/dist/internal/create-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-composer.d.ts","sourceRoot":"","sources":["../../src/internal/create-composer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAEV,QAAQ,EACR,cAAc,EAEd,YAAY,EACZ,cAAc,EACf,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,wBAAgB,cAAc,CAAC,QAAQ,EACrC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAAE,GAC9D,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAGtB,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC"}

package/dist/internal/create-composer.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Composer Factory
+ *
+ * Creates a configured Composer instance with methods for running workflows
+ * synchronously or asynchronously, and for starting activity workers.
+ *
+ * The composer provides a unified interface that uses the same context provider
+ * for all execution modes, ensuring consistent context management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createComposer = createComposer;
+const uuid_1 = require("uuid");
+const temporal_naming_1 = require("../temporal-naming");
+const workflow_execution_1 = require("./async/execute/workflow-execution");
+const activity_worker_1 = require("./async/register/activity-worker");
+const workflow_worker_1 = require("./async/register/workflow-worker");
+const sync_schedules_1 = require("./async/schedule/sync-schedules");
+const dag_sync_workflow_1 = require("./dag-sync-workflow");
+const defaults_1 = require("./defaults");
+// Implementation
+function createComposer(config) {
+    const { contextProvider, deepFreeze, temporal } = config;
+    // Resolve effective logger (use provided or default) before defining closures
+    // so all closures capture the resolved logger consistently.
+    const resolvedLogger = config.logger ?? defaults_1.defaultLogger;
+    // Create a type-erased version for internal use
+    const internalContextProvider = {
+        beforeStep: contextProvider.beforeStep,
+        afterStep: contextProvider.afterStep,
+    };
+    // Implementation
+    function runSyncWorkflowImpl(workflow, initialData) {
+        return (0, dag_sync_workflow_1.runSyncWorkflow)(workflow, initialData, internalContextProvider, resolvedLogger, deepFreeze);
+    }
+    // Base result (sync-only)
+    const syncComposer = {
+        contextProvider,
+        logger: resolvedLogger,
+        runSyncWorkflow: runSyncWorkflowImpl,
+    };
+    // If no temporal config, return sync-only composer
+    if (!temporal) {
+        return syncComposer;
+    }
+    // Capture after guard so TypeScript narrows the type for closures
+    const temporalConfig = temporal;
+    // Construct versioningOverride for workflow starts when buildId is set.
+    // This pins new workflows to the same deployment version as the workers,
+    // eliminating the TOCTOU gap that would require a separate setCurrentDeployment call.
+    const seriesNames = (0, temporal_naming_1.getDeploymentSeriesNames)(temporalConfig.serviceName);
+    const workflowVersioningOverride = temporalConfig.buildId
+        ? {
+            pinnedTo: {
+                buildId: temporalConfig.buildId,
+                deploymentName: seriesNames.workflows,
+            },
+        }
+        : undefined;
+    // Implementation
+    function runAsyncWorkflowImpl(workflow, initialData, options) {
+        const workflowId = options?.workflowId ? options.workflowId : (0, uuid_1.v7)();
+        return (0, workflow_execution_1.executeWorkflowTemporal)(workflow, initialData, {
+            workflowId,
+            clientConfig: {
+                address: temporalConfig.serverAddress,
+                namespace: temporalConfig.namespace,
+            },
+            versioningOverride: workflowVersioningOverride,
+            awaitCheckpoint: options?.awaitCheckpoint,
+            startOnly: options?.startOnly,
+        });
+    }
+    // Implementation
+    function startAsyncWorkflowImpl(workflow, initialData) {
+        const workflowId = (0, uuid_1.v7)();
+        return (0, workflow_execution_1.startWorkflowTemporal)(workflow, initialData, {
+            workflowId,
+            clientConfig: {
+                address: temporalConfig.serverAddress,
+                namespace: temporalConfig.namespace,
+            },
+            versioningOverride: workflowVersioningOverride,
+        });
+    }
+    return {
+        ...syncComposer,
+        temporal: temporalConfig,
+        runAsyncWorkflow: runAsyncWorkflowImpl,
+        startAsyncWorkflow: startAsyncWorkflowImpl,
+        async runActivityWorkers(config) {
+            return (0, activity_worker_1.runActivityWorkers)({
+                serverAddress: temporalConfig.serverAddress,
+                namespace: temporalConfig.namespace,
+                deploymentSeriesName: seriesNames.activities,
+                buildId: temporalConfig.buildId,
+                ...config,
+                contextProvider: internalContextProvider,
+                logger: resolvedLogger,
+            });
+        },
+        async runWorkflowWorkers(config) {
+            return (0, workflow_worker_1.runWorkflowWorkers)({
+                serverAddress: temporalConfig.serverAddress,
+                namespace: temporalConfig.namespace,
+                deploymentSeriesName: seriesNames.workflows,
+                buildId: temporalConfig.buildId,
+                ...config,
+                logger: resolvedLogger,
+            });
+        },
+        async syncSchedules(schedules, options) {
+            return (0, sync_schedules_1.syncSchedules)({
+                temporalConfig: {
+                    address: temporalConfig.serverAddress,
+                    namespace: temporalConfig.namespace,
+                },
+                schedules,
+                dryRun: options?.dryRun,
+                logger: resolvedLogger,
+            });
+        },
+    };
+}
+//# sourceMappingURL=create-composer.js.map

package/dist/internal/create-composer.js.map

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

package/dist/internal/dag-sync-fanout.d.ts

@@ -0,0 +1,79 @@
+import type { AssertSerializable, Step, StrictStepReturn } from "./dag-sync-step";
+import type { ExtractWorkflowBag, ExtractWorkflowRequiredInitial, InferWorkflowResult, SafeConfiguredKeys, Workflow } from "./dag-sync-workflow";
+/**
+ * Computes the precise result type of a workflow from its type parameter.
+ *
+ * Given a Workflow<Bag, RequiredInitial, Config, Steps, CheckpointNames>, produces
+ * Pick<Bag, (all step provides) | RequiredInitial | ConfiguredKeys> -- the exact
+ * set of fields available after the workflow completes.
+ */
+export type InferWorkflowResultFromWorkflow<W> = W extends Workflow<infer B, infer R, infer C, infer S, infer _CN> ? InferWorkflowResult<B, S, R, SafeConfiguredKeys<C, B>> : never;
+/**
+ * Runtime metadata for a FanOut node. Carries the child workflow reference,
+ * data transformation functions, and concurrency configuration.
+ *
+ * Types are erased at the metadata level (Record<string, unknown>) because
+ * the runtimes call these functions with dynamically-typed data. Full type
+ * safety is enforced at the factory level during construction.
+ */
+export interface FanOutMetadata {
+    childWorkflow: Workflow<any, any, any, any, any>;
+    mapInput: (bag: Record<string, unknown>) => Record<string, unknown>[];
+    aggregateResults: (results: Record<string, unknown>[]) => Record<string, unknown>;
+    concurrency: number;
+}
+/**
+ * A FanOut is a Step with additional __fanOut metadata.
+ *
+ * It participates in the DAG like a regular step (has name, needs, provides)
+ * but the runtimes detect __fanOut and execute it specially: calling mapInput
+ * to produce child workflow inputs, running child workflows with concurrency
+ * control (lane-based), then calling aggregateResults to merge the child
+ * results back into the parent bag.
+ *
+ * The `run` function on a FanOut always throws -- it exists only to satisfy
+ * the Step interface for the DAG planner. Actual execution is handled by the
+ * sync and async runtimes.
+ */
+export type FanOut<Bag extends Record<string, any>, Needs extends readonly (keyof Bag)[], Provides extends readonly (keyof Bag)[], Name extends string = string> = Step<Bag, Needs, Provides, unknown, Name> & {
+    __fanOut: FanOutMetadata;
+};
+/**
+ * Runtime type guard for detecting FanOut nodes within a step array.
+ */
+export declare function isFanOutStep(value: Step<any, any, any, any, any>): value is FanOut<any, any, any, any>;
+/**
+ * Factory function for creating type-safe FanOut nodes.
+ *
+ * Usage:
+ *   const fo = fanOut<ParentBag>()({
+ *     name: "startTldIngestions",
+ *     needs: ["tlds"] as const,
+ *     childWorkflow: ingestCzdsTld,
+ *     mapInput: (bag) => bag.tlds.map(tld => ({ tld })),
+ *     provides: ["tldResults"] as const,
+ *     aggregateResults: (results) => ({ tldResults: results }),
+ *     concurrency: 5,
+ *   });
+ *
+ * The double-call pattern (fanOut<ParentBag>()({...})) matches the step()
+ * factory -- ParentBag is explicit, all other generics are inferred from
+ * the definition object.
+ *
+ * Generic parameters:
+ * - ParentBag (explicit): The parent workflow's bag type
+ * - Name (inferred): Literal string name of this fanOut node
+ * - Needs (inferred): Bag keys this fanOut requires as input
+ * - Provides (inferred): Bag keys this fanOut produces as output
+ * - W (inferred): The child workflow type (carries Bag, RequiredInitial, etc.)
+ */
+export declare function fanOut<ParentBag extends Record<string, any>>(): <const Name extends string, const Needs extends readonly (keyof ParentBag)[], const Provides extends readonly (keyof ParentBag)[], W extends Workflow<any, any, any, any, any>>(definition: {
+    name: Name;
+    needs: Needs;
+    childWorkflow: W;
+    mapInput: (bag: Pick<ParentBag, Needs[number]>) => Pick<ExtractWorkflowBag<W>, ExtractWorkflowRequiredInitial<W>>[];
+    provides: Provides;
+    aggregateResults: (results: InferWorkflowResultFromWorkflow<W>[]) => AssertSerializable<StrictStepReturn<ParentBag, Provides[number]>>;
+    concurrency?: number;
+}) => FanOut<ParentBag, Needs, Provides, Name>;
+//# sourceMappingURL=dag-sync-fanout.d.ts.map

package/dist/internal/dag-sync-fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-sync-fanout.d.ts","sourceRoot":"","sources":["../../src/internal/dag-sync-fanout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,MAAM,+BAA+B,CAAC,CAAC,IAC3C,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,GAC7D,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACtD,KAAK,CAAC;AAEZ;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACjD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtE,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,MAAM,CAChB,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,KAAK,SAAS,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,EACpC,QAAQ,SAAS,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,EACvC,IAAI,SAAS,MAAM,GAAG,MAAM,IAC1B,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG;IAC9C,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GACnC,KAAK,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAErC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,MAAM,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAExD,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,KAAK,SAAS,SAAS,CAAC,MAAM,SAAS,CAAC,EAAE,EAChD,KAAK,CAAC,QAAQ,SAAS,SAAS,CAAC,MAAM,SAAS,CAAC,EAAE,EACnD,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC3C,YAAY;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,CACR,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,KAChC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,8BAA8B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,EAAE,CAChB,OAAO,EAAE,+BAA+B,CAAC,CAAC,CAAC,EAAE,KAC1C,kBAAkB,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAG,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CA6B7C"}