flowcraft 1.0.0 → 2.0.0

package/dist/builder/graph/internal-nodes.d.ts

@@ -1,59 +0,0 @@
-import { Context } from '../../context.js';
-import { N as Node, b as NodeArgs, A as AbstractNode } from '../../types-U76Ukj96.js';
-import { ParallelFlow } from '../patterns.js';
-import '../../logger.js';
-import '../../functions.js';
-
-/**
- * An internal node used by the GraphBuilder to handle the `inputs` mapping
- * of an inlined sub-workflow. It copies data from the parent context scope
- * to the sub-workflow's context scope.
- * @internal
- */
-declare class InputMappingNode<TContext extends Context = Context> extends Node<void, void, any, any, TContext> {
-    private mappings;
-    constructor(options: {
-        data: Record<string, string>;
-    });
-    prep({ ctx, logger }: NodeArgs<void, void, any, TContext>): Promise<void>;
-}
-/**
- * An internal node used by the GraphBuilder to handle the `outputs` mapping
- * of an inlined sub-workflow. It copies data from the sub-workflow's
- * context scope back to the parent's context scope.
- * @internal
- */
-declare class OutputMappingNode<TContext extends Context = Context> extends Node<void, void, any, any, TContext> {
-    private mappings;
-    constructor(options: {
-        data: Record<string, string>;
-    });
-    prep({ ctx, logger }: NodeArgs<void, void, any, TContext>): Promise<void>;
-}
-/**
- * A private class used by the builder to represent the sub-workflow container itself.
- * It's a structural node that preserves the original node ID in the flattened graph.
- * @internal
- */
-declare class SubWorkflowContainerNode<TContext extends Context = Context> extends Node<void, void, any, any, TContext> {
-    constructor();
-    exec(): Promise<void>;
-}
-/** A private class used by the builder to represent parallel execution blocks. */
-declare class ParallelBranchContainer<TContext extends Context = Context> extends ParallelFlow<TContext> {
-    /** A tag to reliably identify this node type in the visualizer. */
-    readonly isParallelContainer = true;
-    nodesToRun: AbstractNode[];
-    constructor();
-}
-/**
- * A private class used by the builder to unify conditional branches
- * before they connect to a common successor. This ensures the successor
- * only has one predecessor, preventing false fan-in detection.
- * @internal
- */
-declare class ConditionalJoinNode<TContext extends Context = Context> extends Node<void, void, any, any, TContext> {
-    constructor();
-}
-
-export { ConditionalJoinNode, InputMappingNode, OutputMappingNode, ParallelBranchContainer, SubWorkflowContainerNode };

package/dist/builder/graph/internal-nodes.js

@@ -1,20 +0,0 @@
-export { ConditionalJoinNode, InputMappingNode, OutputMappingNode, ParallelBranchContainer, SubWorkflowContainerNode } from '../../chunk-WGVHM7DU.js';
-import '../../chunk-L5PK5VL2.js';
-import '../../chunk-F6C6J7HK.js';
-import '../../chunk-UY4PNPBX.js';
-import '../../chunk-ELEHMJPM.js';
-import '../../chunk-HEO3XL4Z.js';
-import '../../chunk-7XUN3OQT.js';
-import '../../chunk-WR5PDOPP.js';
-import '../../chunk-VMH2LRM6.js';
-import '../../chunk-YR433ZDA.js';
-import '../../chunk-6QCXIRLA.js';
-import '../../chunk-BRFMFLR6.js';
-import '../../chunk-PNWOW52F.js';
-import '../../chunk-VZDHIOCH.js';
-import '../../chunk-S4WFNGQG.js';
-import '../../chunk-64DNBF5W.js';
-import '../../chunk-IIKTTIW5.js';
-import '../../chunk-AOHBHYF6.js';
-//# sourceMappingURL=internal-nodes.js.map
-//# sourceMappingURL=internal-nodes.js.map

package/dist/builder/graph/internal-nodes.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"internal-nodes.js"}

package/dist/builder/graph/runner.d.ts

@@ -1,51 +0,0 @@
-import { Context } from '../../context.js';
-import { I as IExecutor, F as Flow, A as AbstractNode, W as WorkflowBlueprint, n as NodeRegistry, i as TypedNodeRegistry, R as RunOptions } from '../../types-U76Ukj96.js';
-import '../../logger.js';
-
-/**
- * An execution engine that hydrates a runnable `Flow` from a serializable
- * `WorkflowBlueprint` and runs it. This is the recommended executor for
- *  distributed systems where the workflow is built once and executed many times by workers.
- */
-declare class BlueprintExecutor implements IExecutor {
-    private blueprint;
-    private nodeOptionsContext;
-    readonly flow: Flow;
-    readonly nodeMap: Map<string, AbstractNode>;
-    private readonly registry;
-    constructor(blueprint: WorkflowBlueprint, registry: NodeRegistry | TypedNodeRegistry<any, any>, nodeOptionsContext?: Record<string, any>);
-    private _populateContainers;
-    /**
-     * Retrieves a hydrated node instance from the blueprint by its ID.
-     * This is useful for workers that need to execute a specific node from the graph.
-     * @param nodeId The ID of the node to retrieve.
-     * @returns The `AbstractNode` instance if found, otherwise `undefined`.
-     */
-    getNode(nodeId: string): AbstractNode | undefined;
-    /**
-     * Instantiates all node objects from the blueprint's definition.
-     * @private
-     */
-    private _createNodeMap;
-    /**
-     * Wires the hydrated node instances together based on the blueprint's edges.
-     * @private
-     */
-    private _wireGraph;
-    /**
-     * Executes the flow defined by the blueprint.
-     * @param flow The flow to execute.
-     * @param context The shared context for the workflow.
-     * @param options Runtime options, including a logger, abort controller, or initial params.
-     * @returns A promise that resolves with the final action of the workflow.
-     */
-    run<T>(flow: Flow<any, T>, context: Context, options?: RunOptions): Promise<T>;
-    /**
-     * Determines the next node to execute based on the action returned by the current node.
-     * For distributed systems, this logic would live on the orchestrator.
-     * @internal
-     */
-    getNextNode(curr: AbstractNode, action: any): AbstractNode | undefined;
-}
-
-export { BlueprintExecutor };

package/dist/builder/graph/runner.js

@@ -1,21 +0,0 @@
-export { BlueprintExecutor } from '../../chunk-3YMBNZ77.js';
-import '../../chunk-WGVHM7DU.js';
-import '../../chunk-L5PK5VL2.js';
-import '../../chunk-F6C6J7HK.js';
-import '../../chunk-UY4PNPBX.js';
-import '../../chunk-ELEHMJPM.js';
-import '../../chunk-HEO3XL4Z.js';
-import '../../chunk-7XUN3OQT.js';
-import '../../chunk-WR5PDOPP.js';
-import '../../chunk-VMH2LRM6.js';
-import '../../chunk-YR433ZDA.js';
-import '../../chunk-6QCXIRLA.js';
-import '../../chunk-BRFMFLR6.js';
-import '../../chunk-PNWOW52F.js';
-import '../../chunk-VZDHIOCH.js';
-import '../../chunk-S4WFNGQG.js';
-import '../../chunk-64DNBF5W.js';
-import '../../chunk-IIKTTIW5.js';
-import '../../chunk-AOHBHYF6.js';
-//# sourceMappingURL=runner.js.map
-//# sourceMappingURL=runner.js.map

package/dist/builder/graph/runner.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"runner.js"}

package/dist/builder/graph/types.d.ts

@@ -1,3 +0,0 @@
-export { B as BlueprintBuildResult, k as BuildResult, o as GraphBuilderOptions, G as GraphEdge, l as GraphNode, g as NodeConstructorOptions, n as NodeRegistry, f as NodeTypeMap, O as OriginalPredecessorIdMap, j as PredecessorIdMap, S as SubWorkflowResolver, T as TypedGraphNode, i as TypedNodeRegistry, h as TypedWorkflowGraph, W as WorkflowBlueprint, m as WorkflowGraph } from '../../types-U76Ukj96.js';
-import '../../context.js';
-import '../../logger.js';

package/dist/builder/graph/types.js

@@ -1,3 +0,0 @@
-import '../../chunk-KOBEU2EM.js';
-//# sourceMappingURL=types.js.map
-//# sourceMappingURL=types.js.map

package/dist/builder/index.d.ts

@@ -1,8 +0,0 @@
-export { GraphBuilder, createNodeRegistry } from './graph/graph.js';
-export { ConditionalJoinNode, InputMappingNode, OutputMappingNode, ParallelBranchContainer, SubWorkflowContainerNode } from './graph/internal-nodes.js';
-export { BlueprintExecutor } from './graph/runner.js';
-export { B as BlueprintBuildResult, k as BuildResult, o as GraphBuilderOptions, G as GraphEdge, l as GraphNode, g as NodeConstructorOptions, n as NodeRegistry, f as NodeTypeMap, O as OriginalPredecessorIdMap, j as PredecessorIdMap, S as SubWorkflowResolver, T as TypedGraphNode, i as TypedNodeRegistry, h as TypedWorkflowGraph, W as WorkflowBlueprint, m as WorkflowGraph } from '../types-U76Ukj96.js';
-export { BatchFlow, ParallelBatchFlow, ParallelFlow, SequenceFlow, filterCollection, mapCollection, reduceCollection } from './patterns.js';
-import '../logger.js';
-import '../context.js';
-import '../functions.js';

package/dist/builder/index.js

@@ -1,24 +0,0 @@
-import '../chunk-F2RSES6P.js';
-import '../chunk-GMKJ34T2.js';
-import '../chunk-KOBEU2EM.js';
-export { BlueprintExecutor, GraphBuilder, createNodeRegistry } from '../chunk-3YMBNZ77.js';
-export { ConditionalJoinNode, InputMappingNode, OutputMappingNode, ParallelBranchContainer, SubWorkflowContainerNode } from '../chunk-WGVHM7DU.js';
-export { BatchFlow, ParallelBatchFlow, ParallelFlow, SequenceFlow, filterCollection, mapCollection, reduceCollection } from '../chunk-L5PK5VL2.js';
-import '../chunk-F6C6J7HK.js';
-import '../chunk-UY4PNPBX.js';
-import '../chunk-ELEHMJPM.js';
-import '../chunk-HEO3XL4Z.js';
-import '../chunk-7XUN3OQT.js';
-import '../chunk-WR5PDOPP.js';
-import '../chunk-VMH2LRM6.js';
-import '../chunk-YR433ZDA.js';
-import '../chunk-6QCXIRLA.js';
-import '../chunk-BRFMFLR6.js';
-import '../chunk-PNWOW52F.js';
-import '../chunk-VZDHIOCH.js';
-import '../chunk-S4WFNGQG.js';
-import '../chunk-64DNBF5W.js';
-import '../chunk-IIKTTIW5.js';
-import '../chunk-AOHBHYF6.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/builder/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/builder/patterns.d.ts

@@ -1,136 +0,0 @@
-import { Context } from '../context.js';
-import { NodeFunction } from '../functions.js';
-import { F as Flow, P as Params, A as AbstractNode, b as NodeArgs } from '../types-U76Ukj96.js';
-import '../logger.js';
-
-/**
- * A `Flow` that creates a linear workflow from a sequence of nodes,
- * automatically chaining them in order.
- */
-declare class SequenceFlow<PrepRes = any, ExecRes = any, TParams extends Params = Params, TContext extends Context = Context> extends Flow<PrepRes, ExecRes, TParams, TContext> {
-    /**
-     * @param nodes A sequence of `Node` or `Flow` instances to be executed in order.
-     */
-    constructor(...nodes: AbstractNode<any, any, TContext>[]);
-}
-/**
- * A `Flow` that executes a collection of different nodes concurrently.
- * This is the core of the "fan-out, fan-in" pattern for structural parallelism.
- * After all parallel branches complete, the flow can proceed to a single successor.
- */
-declare class ParallelFlow<TContext extends Context = Context> extends Flow<void, void, Params, TContext> {
-    protected nodesToRun: AbstractNode<any, any, TContext>[];
-    /** A tag to reliably identify this node type in the visualizer. */
-    readonly isParallelContainer = true;
-    /**
-     * @param nodesToRun The array of nodes to execute concurrently.
-     */
-    constructor(nodesToRun?: AbstractNode<any, any, TContext>[]);
-    /**
-     * Orchestrates the parallel execution of all nodes.
-     * @internal
-     */
-    exec({ ctx, params, signal, logger, executor, visitedInParallel }: NodeArgs<void, void, Params, TContext>): Promise<void>;
-}
-/**
- * An abstract `Flow` that processes a collection of items sequentially, one by one.
- * Subclasses must implement the `prep` method to provide the items and the
- * `nodeToRun` property to define the processing logic for each item.
- */
-declare abstract class BatchFlow<T = any, TContext extends Context = Context> extends Flow<Iterable<T>, null, Params, TContext> {
-    /**
-     * The `Node` instance that will be executed for each item in the batch.
-     * This must be implemented by any subclass.
-     */
-    protected abstract nodeToRun: AbstractNode<any, any, TContext>;
-    constructor();
-    /**
-     * (Abstract) Prepares the list of items to be processed.
-     * This method is called once before the batch processing begins.
-     * @param _args The arguments for the node, including `ctx` and `params`.
-     * @returns An array or iterable of parameter objects, one for each item.
-     * The `nodeToRun` will be executed once for each of these objects.
-     */
-    prep(_args: NodeArgs<void, void, Params, TContext>): Promise<Iterable<any>>;
-    /**
-     * Orchestrates the sequential execution of `nodeToRun` for each item.
-     * @internal
-     */
-    exec(args: NodeArgs<void, void, Params, TContext>): Promise<null>;
-}
-/**
- * An abstract `Flow` that processes a collection of items concurrently.
- * Subclasses must implement the `prep` method to provide the items and the
- * `nodeToRun` property to define the processing logic for each item.
- * This provides a significant performance boost for I/O-bound tasks.
- */
-declare abstract class ParallelBatchFlow<T = any, TContext extends Context = Context> extends Flow<Iterable<T>, PromiseSettledResult<any>[], Params, TContext> {
-    /**
-     * The `Node` instance that will be executed concurrently for each item in the batch.
-     * This must be implemented by any subclass.
-     */
-    protected abstract nodeToRun: AbstractNode<any, any, TContext>;
-    constructor();
-    /**
-     * (Abstract) Prepares the list of items to be processed.
-     * This method is called once before the batch processing begins.
-     * @param _args The arguments for the node, including `ctx` and `params`.
-     * @returns An array or iterable of parameter objects, one for each item.
-     * The `nodeToRun` will be executed concurrently for each of these objects.
-     */
-    prep(_args: NodeArgs<void, void, Params, TContext>): Promise<Iterable<any>>;
-    /**
-     * Orchestrates the parallel execution of `nodeToRun` for each item.
-     * @internal
-     */
-    exec(args: NodeArgs<any, void, Params, TContext>): Promise<PromiseSettledResult<any>[]>;
-}
-/**
- * Creates a flow that applies a mapping function to each item in a collection in parallel
- * and returns a new array containing the results.
- *
- * @example
- * const numbers = [1, 2, 3];
- * const double = (n: number) => n * 2;
- * const processingFlow = mapCollection(numbers, double);
- * // When run, processingFlow's result will be [2, 4, 6]
- *
- * @param items The initial array of items of type `T`.
- * @param fn An async or sync function that transforms an item from type `T` to type `U`.
- * @returns A `Flow` instance that, when run, will output an array of type `U[]`.
- */
-declare function mapCollection<T, U, TContext extends Context = Context>(items: T[], fn: NodeFunction<T, U>): Flow<void, U[], Params, TContext>;
-/**
- * Creates a flow that filters a collection based on a predicate function,
- * returning a new array containing only the items that pass the predicate.
- * The predicate is applied to all items concurrently.
- *
- * @example
- * const users = [{ id: 1, admin: true }, { id: 2, admin: false }];
- * const isAdmin = async (user: { admin: boolean }) => user.admin;
- * const adminFilterFlow = filterCollection(users, isAdmin);
- * // When run, the result will be [{ id: 1, admin: true }]
- *
- * @param items The initial array of items of type `T`.
- * @param predicate An async or sync function that returns `true` or `false` for an item.
- * @returns A `Flow` instance that, when run, will output a filtered array of type `T[]`.
- */
-declare function filterCollection<T, TContext extends Context = Context>(items: T[], predicate: (item: T) => boolean | Promise<boolean>): Flow<void, T[], Params, TContext>;
-/**
- * Creates a flow that reduces a collection to a single value by executing a
- * reducer function sequentially for each item, similar to `Array.prototype.reduce()`.
- *
- * @example
- * const numbers = [1, 2, 3, 4];
- * const sumReducer = (acc: number, val: number) => acc + val;
- * const sumFlow = reduceCollection(numbers, sumReducer, 0);
- * // When run, the result will be 10.
- *
- * @param items The array of items to be reduced.
- * @param reducer An async or sync function that processes the accumulator and the current item.
- * @param initialValue The initial value for the accumulator.
- * @returns A `Flow` instance that, when run, will output the final accumulated value of type `U`.
- */
-declare function reduceCollection<T, U, TContext extends Context = Context>(items: T[], reducer: (accumulator: U, item: T) => U | Promise<U>, initialValue: U): Flow<void, U, Params, TContext>;
-
-export { BatchFlow, ParallelBatchFlow, ParallelFlow, SequenceFlow, filterCollection, mapCollection, reduceCollection };

package/dist/builder/patterns.js

@@ -1,19 +0,0 @@
-export { BatchFlow, ParallelBatchFlow, ParallelFlow, SequenceFlow, filterCollection, mapCollection, reduceCollection } from '../chunk-L5PK5VL2.js';
-import '../chunk-F6C6J7HK.js';
-import '../chunk-UY4PNPBX.js';
-import '../chunk-ELEHMJPM.js';
-import '../chunk-HEO3XL4Z.js';
-import '../chunk-7XUN3OQT.js';
-import '../chunk-WR5PDOPP.js';
-import '../chunk-VMH2LRM6.js';
-import '../chunk-YR433ZDA.js';
-import '../chunk-6QCXIRLA.js';
-import '../chunk-BRFMFLR6.js';
-import '../chunk-PNWOW52F.js';
-import '../chunk-VZDHIOCH.js';
-import '../chunk-S4WFNGQG.js';
-import '../chunk-64DNBF5W.js';
-import '../chunk-IIKTTIW5.js';
-import '../chunk-AOHBHYF6.js';
-//# sourceMappingURL=patterns.js.map
-//# sourceMappingURL=patterns.js.map

package/dist/builder/patterns.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"patterns.js"}