@graph-compose/client 1.0.0

package/dist/core/node-builder.d.ts

@@ -0,0 +1,180 @@
+import { ActivityConfig, AgentNode, ErrorBoundaryNode, HttpNode, JsonataParam, Node, NodeConditions } from "@graph-compose/core";
+import { z } from "zod";
+import { GraphCompose } from "./builder";
+/**
+ * Fluent API for configuring individual nodes within a GraphCompose workflow.
+ * Chain configuration methods (e.g., `.get()`, `.withHeaders()`, `.withDependencies()`).
+ * Call `.end()` to finalize the node definition and add it to the graph.
+ */
+export declare class NodeBuilder {
+    private readonly graph;
+    protected node: HttpNode | ErrorBoundaryNode | AgentNode;
+    private isHttpNode;
+    private isAgentNode;
+    private readonly id;
+    /**
+     * Creates an instance of NodeBuilder.
+     * @param graph The parent GraphCompose instance.
+     * @param id The unique identifier for the node.
+     * @param type The type of the node ('http', 'error_boundary', 'agent'). Defaults to 'http'.
+     * @param protectedNodes Optional array of node IDs to protect if type is 'error_boundary'.
+     */
+    constructor(graph: GraphCompose, id: string, type?: "http" | "error_boundary" | "agent", protectedNodes?: string[]);
+    /**
+     * Validates a JSONata expression within the context of the current node.
+     * @param expression The JSONata expression string to validate.
+     * @param context A descriptive string indicating where the expression is used (e.g., 'header 'X-Api-Key'').
+     * @throws {Error} If the expression is invalid.
+     */
+    private validateJsonataExpression;
+    /**
+     * Sets the HTTP method to GET and specifies the URL for the node.
+     * @param url The URL endpoint for the GET request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    get(url: string): NodeBuilder;
+    /**
+     * Sets the HTTP method to POST and specifies the URL for the node.
+     * @param url The URL endpoint for the POST request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    post(url: string): NodeBuilder;
+    /**
+     * Sets the HTTP method to PUT and specifies the URL for the node.
+     * @param url The URL endpoint for the PUT request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    put(url: string): NodeBuilder;
+    /**
+     * Sets the HTTP method to DELETE and specifies the URL for the node.
+     * @param url The URL endpoint for the DELETE request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    delete(url: string): NodeBuilder;
+    /**
+     * Sets the HTTP method to PATCH and specifies the URL for the node.
+     * @param url The URL endpoint for the PATCH request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    patch(url: string): NodeBuilder;
+    /**
+     * Configures conditional execution logic for the HTTP node.
+     * This includes termination, continuation, and polling conditions based on JSONata expressions.
+     * @param conditions An object defining the conditional logic (`terminateWhen`, `continueTo`, `pollUntil`).
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If called on a non-HTTP node.
+     * @throws {Error} If any JSONata expression within conditions is invalid.
+     */
+    withConditions(conditions: NodeConditions): NodeBuilder;
+    /**
+     * Sets the HTTP headers for the node's request.
+     * Values can be static strings or dynamic JSONata expressions.
+     * @param headers A record of header names to string values or JsonataParam objects.
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If any JSONata expression within headers is invalid.
+     */
+    withHeaders(headers: Record<string, string | JsonataParam>): NodeBuilder;
+    /**
+     * Sets the body for the HTTP request.
+     * Can be a JSON object or a string (potentially containing template expressions).
+     * Template expression validation occurs during final workflow validation.
+     * @param body The request body as an object or string.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withBody(body: Record<string, any> | string): NodeBuilder;
+    /**
+     * Configures the retry policy for the HTTP request.
+     * Merges provided partial configuration with any existing policy.
+     * @param config Partial configuration for the RetryPolicy.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withRetries(config: Partial<ActivityConfig["retryPolicy"]>): NodeBuilder;
+    /**
+     * Sets the start-to-close timeout for the activity's execution.
+     * Maximum time allowed for the activity to complete once it starts executing.
+     * @param duration The timeout duration (e.g., '30s', 5000).
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withStartToCloseTimeout(duration: string): NodeBuilder;
+    /**
+     * Sets the schedule-to-close timeout for the activity's execution.
+     * Maximum time from when the activity is scheduled until it completes (includes queue time + execution time).
+     * @param duration The timeout duration (e.g., '30s', 5000).
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withScheduleToCloseTimeout(duration: string): NodeBuilder;
+    /**
+     * Specifies the nodes that this node depends on.
+     * The node will only execute after all its dependencies have successfully completed.
+     * Applicable only to HTTP and agent nodes.
+     * @param nodeIds An array of node IDs that this node depends on.
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If called on a non-HTTP or non-agent node.
+     */
+    withDependencies(nodeIds: string[]): NodeBuilder;
+    /**
+     * Configures input and/or output validation schemas for the HTTP node using Zod schemas.
+     * The Zod schemas are converted to JSON Schema for runtime validation.
+     * @param config An object containing optional `input` and `output` Zod schemas.
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If called on a non-HTTP node.
+     */
+    withValidation(config: {
+        input?: z.ZodType<any>;
+        output?: z.ZodType<any>;
+    }): NodeBuilder;
+    /**
+     * Set the maximum number of iterations for an agent node.
+     * An agent runs until it returns a completion schema response.
+     * You are responsible for ensuring the agent returns a `complete` response before this limit.
+     * If the agent reaches the max iterations without completing, it will fail.
+     *
+     * @default 5
+     * @param maxIterations Must be greater than 0
+     * @throws {Error} If called on a non-agent node
+     * @throws {ValidationError} If maxIterations is less than 1
+     */
+    withMaxIterations(maxIterations: number): NodeBuilder;
+    /**
+     * Set the tools available to the agent.
+     * Tools must be defined in the global tools section of the workflow.
+     * Each tool name must be unique within the workflow and have no dashes or spaces.
+     *
+     * @param tools Array of tool names that the agent can use
+     * @throws {Error} If called on a non-agent node
+     * @throws {ValidationError} If any tool is not found in global tools
+     */
+    withTools(tools: string[]): NodeBuilder;
+    /**
+     * Add a single tool to the agent's available tools.
+     * The tool must be defined in the global tools section of the workflow.
+     * The tool name must be unique within the workflow and have no dashes or spaces.
+     *
+     * @param tool Name of the tool to add
+     * @throws {Error} If called on a non-agent node
+     * @throws {ValidationError} If the tool is not found in global tools
+     */
+    addTool(tool: string): NodeBuilder;
+    /**
+     * Finalizes the node configuration and adds it to the parent GraphCompose builder.
+     * This method MUST be called to complete the node definition.
+     *
+     * @returns The parent GraphCompose instance, allowing for further chaining on the main graph.
+     */
+    end(): GraphCompose;
+    /**
+     * @internal
+     * Retrieves the fully configured node object.
+     * This method is intended for internal use by the GraphCompose builder.
+     * @returns The configured Node object.
+     */
+    build(): Node;
+    /**
+     * @internal
+     * Retrieves the ID of the node being built.
+     * Used for generating informative error messages.
+     * @returns The ID of the node.
+     */
+    getId(): string;
+}
+//# sourceMappingURL=node-builder.d.ts.map

package/dist/core/node-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-builder.d.ts","sourceRoot":"","sources":["../../src/core/node-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,WAAW;IAgBpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAfxB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACzD,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,WAAW,CAAU;IAG7B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAE5B;;;;;;OAMG;gBAEgB,KAAK,EAAE,YAAY,EACpC,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAAM,GAAG,gBAAgB,GAAG,OAAgB,EAClD,cAAc,CAAC,EAAE,MAAM,EAAE;IA8C3B;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAajC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAM7B;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAM9B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAM7B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAMhC;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAO/B;;;;;;;OAOG;IACH,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,WAAW;IA4BvD;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,GAAG,WAAW;IAWxE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,WAAW;IAWzD;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,GAAG,WAAW;IAYxE;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAQtD;;;;;OAKG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAQzD;;;;;;;OAOG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW;IAWhD;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,GAAG,WAAW;IAuBxF;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW;IASrD;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW;IASvC;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAYlC;;;;;OAKG;IACH,GAAG,IAAI,YAAY;IAOnB;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IASb;;;;;OAKG;IACH,KAAK,IAAI,MAAM;CAGhB"}

package/dist/core/node-builder.js

@@ -0,0 +1,387 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeBuilder = void 0;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const validation_1 = require("../validation");
+/**
+ * Fluent API for configuring individual nodes within a GraphCompose workflow.
+ * Chain configuration methods (e.g., `.get()`, `.withHeaders()`, `.withDependencies()`).
+ * Call `.end()` to finalize the node definition and add it to the graph.
+ */
+class NodeBuilder {
+    /**
+     * Creates an instance of NodeBuilder.
+     * @param graph The parent GraphCompose instance.
+     * @param id The unique identifier for the node.
+     * @param type The type of the node ('http', 'error_boundary', 'agent'). Defaults to 'http'.
+     * @param protectedNodes Optional array of node IDs to protect if type is 'error_boundary'.
+     */
+    constructor(graph, id, type = "http", protectedNodes) {
+        this.graph = graph;
+        this.isHttpNode = type === "http";
+        this.isAgentNode = type === "agent";
+        this.id = id; // Store the ID
+        if (type === "error_boundary") {
+            this.node = {
+                id,
+                type: "error_boundary",
+                protectedNodes: protectedNodes || [],
+                activityConfig: {},
+                http: {
+                    method: "POST",
+                    url: "",
+                },
+            };
+        }
+        else if (type === "agent") {
+            this.node = {
+                id,
+                type: "agent",
+                dependencies: [],
+                tools: [],
+                activityConfig: {},
+                http: {
+                    method: "POST",
+                    url: "",
+                    config: {
+                        max_iterations: undefined,
+                    },
+                },
+            };
+        }
+        else {
+            this.node = {
+                id,
+                type: "http",
+                dependencies: [],
+                http: {
+                    method: "GET",
+                    url: "",
+                },
+                activityConfig: {},
+            };
+        }
+    }
+    /**
+     * Validates a JSONata expression within the context of the current node.
+     * @param expression The JSONata expression string to validate.
+     * @param context A descriptive string indicating where the expression is used (e.g., 'header 'X-Api-Key'').
+     * @throws {Error} If the expression is invalid.
+     */
+    validateJsonataExpression(expression, context) {
+        try {
+            const result = (0, validation_1.validateExpression)(expression, this.node.id);
+            if (!result.isValid) {
+                throw result.errors[0];
+            }
+        }
+        catch (e) {
+            console.error(`Error validating expression for node ${this.node.id}:`, e);
+            throw e;
+        }
+    }
+    // Update HTTP methods to validate URLs
+    /**
+     * Sets the HTTP method to GET and specifies the URL for the node.
+     * @param url The URL endpoint for the GET request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    get(url) {
+        this.node.http.method = "GET";
+        this.node.http.url = url;
+        return this;
+    }
+    /**
+     * Sets the HTTP method to POST and specifies the URL for the node.
+     * @param url The URL endpoint for the POST request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    post(url) {
+        this.node.http.method = "POST";
+        this.node.http.url = url;
+        return this;
+    }
+    /**
+     * Sets the HTTP method to PUT and specifies the URL for the node.
+     * @param url The URL endpoint for the PUT request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    put(url) {
+        this.node.http.method = "PUT";
+        this.node.http.url = url;
+        return this;
+    }
+    /**
+     * Sets the HTTP method to DELETE and specifies the URL for the node.
+     * @param url The URL endpoint for the DELETE request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    delete(url) {
+        this.node.http.method = "DELETE";
+        this.node.http.url = url;
+        return this;
+    }
+    /**
+     * Sets the HTTP method to PATCH and specifies the URL for the node.
+     * @param url The URL endpoint for the PATCH request.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    patch(url) {
+        this.node.http.method = "PATCH";
+        this.node.http.url = url;
+        return this;
+    }
+    // Conditional branching methods - only available for HTTP nodes
+    /**
+     * Configures conditional execution logic for the HTTP node.
+     * This includes termination, continuation, and polling conditions based on JSONata expressions.
+     * @param conditions An object defining the conditional logic (`terminateWhen`, `continueTo`, `pollUntil`).
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If called on a non-HTTP node.
+     * @throws {Error} If any JSONata expression within conditions is invalid.
+     */
+    withConditions(conditions) {
+        if (!this.isHttpNode) {
+            throw new Error("Conditional branching is only available for HTTP nodes");
+        }
+        // Validate JSONata expressions in conditions
+        if (conditions.terminateWhen) {
+            conditions.terminateWhen.forEach((expression) => {
+                this.validateJsonataExpression(expression, "terminateWhen condition");
+            });
+        }
+        if (conditions.continueTo) {
+            conditions.continueTo.forEach(({ when }) => {
+                this.validateJsonataExpression(when, "continueTo condition");
+            });
+        }
+        if (conditions.pollUntil) {
+            conditions.pollUntil.forEach((expression) => {
+                this.validateJsonataExpression(expression, "pollUntil condition");
+            });
+        }
+        const httpNode = this.node;
+        httpNode.conditions = conditions;
+        return this;
+    }
+    // Configuration methods
+    /**
+     * Sets the HTTP headers for the node's request.
+     * Values can be static strings or dynamic JSONata expressions.
+     * @param headers A record of header names to string values or JsonataParam objects.
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If any JSONata expression within headers is invalid.
+     */
+    withHeaders(headers) {
+        // Validate any JSONata expressions in headers
+        Object.entries(headers).forEach(([key, value]) => {
+            if (typeof value === "object" && "jsonataExpression" in value) {
+                this.validateJsonataExpression(value.jsonataExpression, `header '${key}'`);
+            }
+        });
+        this.node.http.headers = headers;
+        return this;
+    }
+    /**
+     * Sets the body for the HTTP request.
+     * Can be a JSON object or a string (potentially containing template expressions).
+     * Template expression validation occurs during final workflow validation.
+     * @param body The request body as an object or string.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withBody(body) {
+        // Note: Template expression validation happens during final workflow validation
+        // This allows us to collect all validation errors at once and maintain a single source of truth
+        if (typeof body === "string") {
+            this.node.http.body = body;
+        }
+        else {
+            this.node.http.body = body;
+        }
+        return this;
+    }
+    /**
+     * Configures the retry policy for the HTTP request.
+     * Merges provided partial configuration with any existing policy.
+     * @param config Partial configuration for the RetryPolicy.
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withRetries(config) {
+        // Ensure activityConfig exists
+        if (!this.node.activityConfig) {
+            this.node.activityConfig = {};
+        }
+        this.node.activityConfig.retryPolicy = {
+            ...this.node.activityConfig.retryPolicy,
+            ...config,
+        };
+        return this;
+    }
+    /**
+     * Sets the start-to-close timeout for the activity's execution.
+     * Maximum time allowed for the activity to complete once it starts executing.
+     * @param duration The timeout duration (e.g., '30s', 5000).
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withStartToCloseTimeout(duration) {
+        if (!this.node.activityConfig) {
+            this.node.activityConfig = {};
+        }
+        this.node.activityConfig.startToCloseTimeout = duration;
+        return this;
+    }
+    /**
+     * Sets the schedule-to-close timeout for the activity's execution.
+     * Maximum time from when the activity is scheduled until it completes (includes queue time + execution time).
+     * @param duration The timeout duration (e.g., '30s', 5000).
+     * @returns The NodeBuilder instance for chaining.
+     */
+    withScheduleToCloseTimeout(duration) {
+        if (!this.node.activityConfig) {
+            this.node.activityConfig = {};
+        }
+        this.node.activityConfig.scheduleToCloseTimeout = duration;
+        return this;
+    }
+    /**
+     * Specifies the nodes that this node depends on.
+     * The node will only execute after all its dependencies have successfully completed.
+     * Applicable only to HTTP and agent nodes.
+     * @param nodeIds An array of node IDs that this node depends on.
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If called on a non-HTTP or non-agent node.
+     */
+    withDependencies(nodeIds) {
+        if (this.isHttpNode) {
+            this.node.dependencies = nodeIds;
+        }
+        else if (this.isAgentNode) {
+            this.node.dependencies = nodeIds;
+        }
+        else {
+            throw new Error("Dependencies can only be set on HTTP or agent nodes");
+        }
+        return this;
+    }
+    /**
+     * Configures input and/or output validation schemas for the HTTP node using Zod schemas.
+     * The Zod schemas are converted to JSON Schema for runtime validation.
+     * @param config An object containing optional `input` and `output` Zod schemas.
+     * @returns The NodeBuilder instance for chaining.
+     * @throws {Error} If called on a non-HTTP node.
+     */
+    withValidation(config) {
+        if (!this.isHttpNode) {
+            throw new Error("Validation can only be set on HTTP nodes");
+        }
+        if (config.input || config.output) {
+            this.node.validation = {};
+            if (config.input) {
+                // Use 'as any' to prevent deep type instantiation errors
+                const inputSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(config.input);
+                this.node.validation.input =
+                    inputSchema.definitions?.[Object.keys(inputSchema.definitions || {})[0]] || inputSchema;
+            }
+            if (config.output) {
+                // Use 'as any' to prevent deep type instantiation errors
+                const outputSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(config.output);
+                this.node.validation.output =
+                    outputSchema.definitions?.[Object.keys(outputSchema.definitions || {})[0]] ||
+                        outputSchema;
+            }
+        }
+        return this;
+    }
+    /**
+     * Set the maximum number of iterations for an agent node.
+     * An agent runs until it returns a completion schema response.
+     * You are responsible for ensuring the agent returns a `complete` response before this limit.
+     * If the agent reaches the max iterations without completing, it will fail.
+     *
+     * @default 5
+     * @param maxIterations Must be greater than 0
+     * @throws {Error} If called on a non-agent node
+     * @throws {ValidationError} If maxIterations is less than 1
+     */
+    withMaxIterations(maxIterations) {
+        if (!this.isAgentNode) {
+            throw new Error("Max iterations can only be set for agent nodes");
+        }
+        const agentNode = this.node;
+        agentNode.http.config.max_iterations = maxIterations;
+        return this;
+    }
+    /**
+     * Set the tools available to the agent.
+     * Tools must be defined in the global tools section of the workflow.
+     * Each tool name must be unique within the workflow and have no dashes or spaces.
+     *
+     * @param tools Array of tool names that the agent can use
+     * @throws {Error} If called on a non-agent node
+     * @throws {ValidationError} If any tool is not found in global tools
+     */
+    withTools(tools) {
+        if (!this.isAgentNode) {
+            throw new Error("Tools can only be set for agent nodes");
+        }
+        const agentNode = this.node;
+        agentNode.tools = tools;
+        return this;
+    }
+    /**
+     * Add a single tool to the agent's available tools.
+     * The tool must be defined in the global tools section of the workflow.
+     * The tool name must be unique within the workflow and have no dashes or spaces.
+     *
+     * @param tool Name of the tool to add
+     * @throws {Error} If called on a non-agent node
+     * @throws {ValidationError} If the tool is not found in global tools
+     */
+    addTool(tool) {
+        if (!this.isAgentNode) {
+            throw new Error("Tools can only be added to agent nodes");
+        }
+        const agentNode = this.node;
+        if (!agentNode.tools.includes(tool)) {
+            agentNode.tools.push(tool);
+        }
+        return this;
+    }
+    // Terminal operation
+    /**
+     * Finalizes the node configuration and adds it to the parent GraphCompose builder.
+     * This method MUST be called to complete the node definition.
+     *
+     * @returns The parent GraphCompose instance, allowing for further chaining on the main graph.
+     */
+    end() {
+        // Call the internal add method on the parent graph
+        this.graph._addNodeDefinition(this.build());
+        return this.graph;
+    }
+    // Internal method to get the built node
+    /**
+     * @internal
+     * Retrieves the fully configured node object.
+     * This method is intended for internal use by the GraphCompose builder.
+     * @returns The configured Node object.
+     */
+    build() {
+        // Remove empty activityConfig if no activity settings were provided
+        if (this.node.activityConfig && Object.keys(this.node.activityConfig).length === 0) {
+            delete this.node.activityConfig;
+        }
+        return this.node;
+    }
+    /**
+     * @internal
+     * Retrieves the ID of the node being built.
+     * Used for generating informative error messages.
+     * @returns The ID of the node.
+     */
+    getId() {
+        return this.id;
+    }
+}
+exports.NodeBuilder = NodeBuilder;
+//# sourceMappingURL=node-builder.js.map

package/dist/core/node-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-builder.js","sourceRoot":"","sources":["../../src/core/node-builder.ts"],"names":[],"mappings":";;;AAUA,2DAAqD;AACrD,8CAAmD;AAGnD;;;;GAIG;AACH,MAAa,WAAW;IAQtB;;;;;;OAMG;IACH,YACmB,KAAmB,EACpC,EAAU,EACV,OAA4C,MAAM,EAClD,cAAyB;QAHR,UAAK,GAAL,KAAK,CAAc;QAKpC,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,MAAM,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,KAAK,OAAO,CAAC;QACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,eAAe;QAE7B,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,GAAG;gBACV,EAAE;gBACF,IAAI,EAAE,gBAAgB;gBACtB,cAAc,EAAE,cAAc,IAAI,EAAE;gBACpC,cAAc,EAAE,EAAE;gBAClB,IAAI,EAAE;oBACJ,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,EAAE;iBACR;aACF,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG;gBACV,EAAE;gBACF,IAAI,EAAE,OAAO;gBACb,YAAY,EAAE,EAAE;gBAChB,KAAK,EAAE,EAAE;gBACT,cAAc,EAAE,EAAE;gBAClB,IAAI,EAAE;oBACJ,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,EAAE;oBACP,MAAM,EAAE;wBACN,cAAc,EAAE,SAA8B;qBAC/C;iBACF;aACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG;gBACV,EAAE;gBACF,IAAI,EAAE,MAAM;gBACZ,YAAY,EAAE,EAAE;gBAChB,IAAI,EAAE;oBACJ,MAAM,EAAE,KAAK;oBACb,GAAG,EAAE,EAAE;iBACR;gBACD,cAAc,EAAE,EAAE;aACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,yBAAyB,CAAC,UAAkB,EAAE,OAAe;QACnE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,+BAAkB,EAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,wCAAwC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1E,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAW;QACf,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gEAAgE;IAChE;;;;;;;OAOG;IACH,cAAc,CAAC,UAA0B;QACvC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,6CAA6C;QAC7C,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;YAC7B,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC9C,IAAI,CAAC,yBAAyB,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;YACxE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1B,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;gBACzC,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACzB,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC1C,IAAI,CAAC,yBAAyB,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAgB,CAAC;QACvC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB;;;;;;OAMG;IACH,WAAW,CAAC,OAA8C;QACxD,8CAA8C;QAC9C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,mBAAmB,IAAI,KAAK,EAAE,CAAC;gBAC9D,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,iBAAiB,EAAE,WAAW,GAAG,GAAG,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,IAAkC;QACzC,gFAAgF;QAChF,gGAAgG;QAChG,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,MAA8C;QACxD,+BAA+B;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,GAAG;YACrC,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW;YACvC,GAAG,MAAM;SACV,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,uBAAuB,CAAC,QAAgB;QACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,mBAAmB,GAAG,QAAQ,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,0BAA0B,CAAC,QAAgB;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,sBAAsB,GAAG,QAAQ,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,OAAiB;QAChC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnB,IAAI,CAAC,IAAiB,CAAC,YAAY,GAAG,OAAO,CAAC;QACjD,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAkB,CAAC,YAAY,GAAG,OAAO,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,MAA2D;QACxE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,IAAiB,CAAC,UAAU,GAAG,EAAE,CAAC;YACxC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,yDAAyD;gBACzD,MAAM,WAAW,GAAG,IAAA,oCAAe,EAAC,MAAM,CAAC,KAAY,CAAC,CAAC;gBACxD,IAAI,CAAC,IAAiB,CAAC,UAAW,CAAC,KAAK;oBACvC,WAAW,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;YAC5F,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,yDAAyD;gBACzD,MAAM,YAAY,GAAG,IAAA,oCAAe,EAAC,MAAM,CAAC,MAAa,CAAC,CAAC;gBAC1D,IAAI,CAAC,IAAiB,CAAC,UAAW,CAAC,MAAM;oBACxC,YAAY,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC1E,YAAY,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,aAAqB;QACrC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAiB,CAAC;QACzC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,aAAa,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAe;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAiB,CAAC;QACzC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAiB,CAAC;QACzC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB;;;;;OAKG;IACH,GAAG;QACD,mDAAmD;QACnD,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,wCAAwC;IACxC;;;;;OAKG;IACH,KAAK;QACH,oEAAoE;QACpE,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnF,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;QAClC,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AAnZD,kCAmZC"}