flowcraft 1.0.0 → 2.0.0

package/dist/utils/analysis.js

@@ -1,3 +0,0 @@
-export { analyzeGraph, checkForCycles, createNodeRule, isNodeType } from '../chunk-WR5PDOPP.js';
-//# sourceMappingURL=analysis.js.map
-//# sourceMappingURL=analysis.js.map

package/dist/utils/index.d.ts

@@ -1,8 +0,0 @@
-export { GraphAnalysis, ValidationError, Validator, analyzeGraph, checkForCycles, createNodeRule, isNodeType } from './analysis.js';
-export { generateMermaidFromBlueprint, generateMermaidGraph } from './mermaid.js';
-export { applyMiddleware } from './middleware.js';
-export { sanitizeGraph } from './sanitize.js';
-export { sleep } from './sleep.js';
-import '../types-U76Ukj96.js';
-import '../context.js';
-import '../logger.js';

package/dist/utils/index.js

@@ -1,10 +0,0 @@
-import '../chunk-7XUN3OQT.js';
-export { analyzeGraph, checkForCycles, createNodeRule, isNodeType } from '../chunk-WR5PDOPP.js';
-export { generateMermaidFromBlueprint, generateMermaidGraph } from '../chunk-VMH2LRM6.js';
-export { sanitizeGraph } from '../chunk-YR433ZDA.js';
-export { sleep } from '../chunk-6QCXIRLA.js';
-export { applyMiddleware } from '../chunk-PNWOW52F.js';
-import '../chunk-64DNBF5W.js';
-import '../chunk-AOHBHYF6.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/mermaid.d.ts

@@ -1,46 +0,0 @@
-import { F as Flow, W as WorkflowBlueprint } from '../types-U76Ukj96.js';
-import '../context.js';
-import '../logger.js';
-
-/**
- * Generates a Mermaid graph definition from a `Flow` instance.
- *
- * This utility traverses the workflow's node structure and outputs a string
- * that can be rendered by Mermaid.js to visualize the flow's logic,
- * including branching and cycles.
- *
- * @param flow The `Flow` instance to visualize.
- * @returns A string containing the Mermaid `graph TD` definition.
- *
- * @example
- * const startNode = new Node('start')
- * const processNode = new Node('process')
- * const endNode = new Node('end')
- *
- * startNode.next(processNode)
- * processNode.next(endNode)
- *
- * const myFlow = new Flow(startNode)
- * const mermaidSyntax = generateMermaidGraph(myFlow)
- * console.log(mermaidSyntax)
- * // Outputs:
- * // graph TD
- * //   Node_0[Node]
- * //   Node_1[Node]
- * //   Node_2[Node]
- * //   Node_0 --> Node_1
- * //   Node_1 --> Node_2
- */
-declare function generateMermaidGraph(flow: Flow): string;
-/**
- * Generates a Mermaid graph definition from a static `WorkflowBlueprint`.
- *
- * This utility iterates over the blueprint's nodes and edges to output a string
- * that can be rendered by Mermaid.js to visualize the entire workflow structure.
- *
- * @param blueprint The `WorkflowBlueprint` instance to visualize.
- * @returns A string containing the Mermaid `graph TD` definition.
- */
-declare function generateMermaidFromBlueprint(blueprint: WorkflowBlueprint): string;
-
-export { generateMermaidFromBlueprint, generateMermaidGraph };

package/dist/utils/mermaid.js

@@ -1,4 +0,0 @@
-export { generateMermaidFromBlueprint, generateMermaidGraph } from '../chunk-VMH2LRM6.js';
-import '../chunk-AOHBHYF6.js';
-//# sourceMappingURL=mermaid.js.map
-//# sourceMappingURL=mermaid.js.map

package/dist/utils/mermaid.js.map

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

package/dist/utils/middleware.d.ts

@@ -1,11 +0,0 @@
-import { e as Middleware, A as AbstractNode, M as MiddlewareNext } from '../types-U76Ukj96.js';
-import '../context.js';
-import '../logger.js';
-
-/**
- * Composes a chain of middleware functions around a node's execution.
- * @internal
- */
-declare function applyMiddleware<T = any>(middleware: Middleware<T>[], nodeToRun: AbstractNode): MiddlewareNext<T>;
-
-export { applyMiddleware };

package/dist/utils/middleware.js

@@ -1,3 +0,0 @@
-export { applyMiddleware } from '../chunk-PNWOW52F.js';
-//# sourceMappingURL=middleware.js.map
-//# sourceMappingURL=middleware.js.map

package/dist/utils/middleware.js.map

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

package/dist/utils/sanitize.d.ts

@@ -1,19 +0,0 @@
-import { m as WorkflowGraph } from '../types-U76Ukj96.js';
-import '../context.js';
-import '../logger.js';
-
-/**
- * Sanitizes a raw workflow graph object by removing properties that are not
- * relevant to the execution engine, such as UI-specific data.
- *
- * @param rawGraph - The raw graph object, potentially containing extraneous properties.
- * @param rawGraph.nodes - An array of node objects.
- * @param rawGraph.edges - An array of edge objects.
- * @returns A clean, execution-focused `WorkflowGraph` object.
- */
-declare function sanitizeGraph(rawGraph: {
-    nodes: any[];
-    edges: any[];
-}): WorkflowGraph;
-
-export { sanitizeGraph };

package/dist/utils/sanitize.js

@@ -1,3 +0,0 @@
-export { sanitizeGraph } from '../chunk-YR433ZDA.js';
-//# sourceMappingURL=sanitize.js.map
-//# sourceMappingURL=sanitize.js.map

package/dist/utils/sleep.d.ts

@@ -1,9 +0,0 @@
-/**
- * An abortable `sleep` utility that pauses execution for a specified duration.
- * It will reject with an `AbortError` if the provided `AbortSignal` is triggered.
- * @param ms The number of milliseconds to sleep.
- * @param signal An optional `AbortSignal` to listen for cancellation.
- */
-declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
-
-export { sleep };

package/dist/utils/sleep.js

@@ -1,4 +0,0 @@
-export { sleep } from '../chunk-6QCXIRLA.js';
-import '../chunk-64DNBF5W.js';
-//# sourceMappingURL=sleep.js.map
-//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

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

package/dist/workflow/AbstractNode.d.ts

@@ -1,3 +0,0 @@
-export { A as AbstractNode } from '../types-U76Ukj96.js';
-import '../context.js';
-import '../logger.js';

package/dist/workflow/AbstractNode.js

@@ -1,4 +0,0 @@
-export { AbstractNode } from '../chunk-VZDHIOCH.js';
-import '../chunk-AOHBHYF6.js';
-//# sourceMappingURL=AbstractNode.js.map
-//# sourceMappingURL=AbstractNode.js.map

package/dist/workflow/AbstractNode.js.map

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

package/dist/workflow/Flow.d.ts

@@ -1,3 +0,0 @@
-import '../context.js';
-export { F as Flow } from '../types-U76Ukj96.js';
-import '../logger.js';

package/dist/workflow/Flow.js

@@ -1,16 +0,0 @@
-export { Flow } from '../chunk-UY4PNPBX.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=Flow.js.map
-//# sourceMappingURL=Flow.js.map

package/dist/workflow/Flow.js.map

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

package/dist/workflow/Node.d.ts

@@ -1,3 +0,0 @@
-import '../context.js';
-export { N as Node } from '../types-U76Ukj96.js';
-import '../logger.js';

package/dist/workflow/Node.js

@@ -1,15 +0,0 @@
-export { Node } from '../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=Node.js.map
-//# sourceMappingURL=Node.js.map

package/dist/workflow/Node.js.map

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

package/dist/workflow/index.d.ts

@@ -1,4 +0,0 @@
-export { A as AbstractNode, F as Flow, N as Node } from '../types-U76Ukj96.js';
-export { ExecNode, PostNode, PreNode } from './node-patterns.js';
-import '../context.js';
-import '../logger.js';

package/dist/workflow/index.js

@@ -1,18 +0,0 @@
-import '../chunk-F6C6J7HK.js';
-export { Flow } from '../chunk-UY4PNPBX.js';
-export { ExecNode, PostNode, PreNode } from '../chunk-ELEHMJPM.js';
-export { Node } from '../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';
-export { AbstractNode } from '../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/workflow/index.js.map

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

package/dist/workflow/node-patterns.d.ts

@@ -1,55 +0,0 @@
-import { P as Params, N as Node, b as NodeArgs } from '../types-U76Ukj96.js';
-import { Context } from '../context.js';
-import '../logger.js';
-
-/**
- * A simplified base class for nodes that only need to perform a core action.
- * This pattern is ideal for nodes that receive their inputs via `params` and
- * produce an output, without needing `prep` or complex `post` branching logic.
- *
- * @template ExecRes The type of data returned by the `exec` phase.
- * @template TParams The type for the node's static parameters.
- */
-declare abstract class ExecNode<ExecRes = any, TParams extends Params = Params, TContext extends Context = Context> extends Node<void, ExecRes, any, TParams, TContext> {
-    /**
-     * (Lifecycle) Performs the core, isolated logic of the node.
-     * This is the only phase that is retried on failure. It should not access the `Context` directly.
-     * @param args The arguments for the node, including `prepRes`.
-     * @returns The result of the execution.
-     */
-    abstract exec(args: NodeArgs<void, void, TParams, TContext>): Promise<ExecRes>;
-}
-/**
- * A simplified base class for nodes that only perform a side effect, such as
- * modifying the `Context` or logging. These nodes do not produce an `exec` result.
- * Their logic is typically placed in the `prep` phase.
- *
- * @template TParams The type for the node's static parameters.
- */
-declare abstract class PreNode<TParams extends Params = Params, TContext extends Context = Context> extends Node<void, void, any, TParams, TContext> {
-    /**
-     * (Lifecycle) Prepares data or performs a side effect. Runs once before `exec`.
-     * This is the ideal place to read from or write to the `Context`.
-     * @param args The arguments for the node, including `ctx` and `params`.
-     */
-    abstract prep(args: NodeArgs<void, void, TParams, TContext>): Promise<void>;
-}
-/**
- * A simplified base class for nodes that make a branching decision.
- * This pattern is ideal for routing the workflow based on data in the `Context`.
- * The branching logic is placed in the `post` phase, which returns a custom action string.
- *
- * @template PostRes The type of the "action" string returned by the `post` phase.
- * @template TParams The type for the node's static parameters.
- */
-declare abstract class PostNode<PostRes = any, TParams extends Params = Params, TContext extends Context = Context> extends Node<void, void, PostRes, TParams, TContext> {
-    /**
-     * (Lifecycle) Processes results and determines the next step. Runs once after `exec`.
-     * This is the ideal place to write data to the `Context` and return an action.
-     * @param args The arguments for the node, including `execRes`.
-     * @returns An "action" string to determine which successor to execute next.
-     */
-    abstract post(args: NodeArgs<void, void, TParams, TContext>): Promise<PostRes>;
-}
-
-export { ExecNode, PostNode, PreNode };

package/dist/workflow/node-patterns.js

@@ -1,16 +0,0 @@
-export { ExecNode, PostNode, PreNode } from '../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=node-patterns.js.map
-//# sourceMappingURL=node-patterns.js.map

package/dist/workflow/node-patterns.js.map

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

package/dist/workflow/registry.d.ts

@@ -1,17 +0,0 @@
-import { A as AbstractNode, F as Flow } from '../types-U76Ukj96.js';
-import '../context.js';
-import '../logger.js';
-
-type FlowConstructor = new (start?: AbstractNode) => Flow;
-/**
- * For internal use by the Flow class to register itself, breaking the circular dependency.
- * @internal
- */
-declare function registerFlow(constructor: FlowConstructor): void;
-/**
- * For internal use by the Node class to get the Flow constructor without a direct import.
- * @internal
- */
-declare function getFlowConstructor(): FlowConstructor;
-
-export { getFlowConstructor, registerFlow };

package/dist/workflow/registry.js

@@ -1,3 +0,0 @@
-export { getFlowConstructor, registerFlow } from '../chunk-S4WFNGQG.js';
-//# sourceMappingURL=registry.js.map
-//# sourceMappingURL=registry.js.map

package/dist/workflow/registry.js.map

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