@jam-nodes/core 0.1.0

package/dist/execution/context.d.ts

@@ -0,0 +1,116 @@
+import type { NodeExecutionContext } from '../types/index.js';
+/**
+ * Manages workflow variables and provides utilities for:
+ * - Storing node outputs as variables
+ * - Retrieving variable values
+ * - Interpolating variables into strings
+ * - JSONPath evaluation for nested data access
+ */
+export declare class ExecutionContext {
+    private variables;
+    constructor(initialVariables?: Record<string, unknown>);
+    /**
+     * Set a variable value
+     */
+    setVariable(name: string, value: unknown): void;
+    /**
+     * Get a variable value
+     */
+    getVariable(name: string): unknown;
+    /**
+     * Get all variables as a plain object
+     */
+    getAllVariables(): Record<string, unknown>;
+    /**
+     * Check if a variable exists
+     */
+    hasVariable(name: string): boolean;
+    /**
+     * Delete a variable
+     */
+    deleteVariable(name: string): void;
+    /**
+     * Clear all variables
+     */
+    clearAll(): void;
+    /**
+     * Merge multiple variables at once
+     */
+    mergeVariables(vars: Record<string, unknown>): void;
+    /**
+     * Evaluate a JSONPath expression against workflow variables
+     *
+     * @example
+     * // Get first contact's email
+     * ctx.evaluateJsonPath('$.contacts[0].email')
+     *
+     * @example
+     * // Get all email subjects
+     * ctx.evaluateJsonPath('$.emailDrafts[*].subject')
+     */
+    evaluateJsonPath(path: string): unknown;
+    /**
+     * Interpolate variables into a string template
+     *
+     * Supports:
+     * - Simple variables: "Hello {{name}}"
+     * - Nested access: "Email: {{contact.email}}"
+     * - JSONPath: "First email: {{$.contacts[0].email}}"
+     * - Direct value replacement: "{{contacts}}" returns the actual array
+     *
+     * @returns The interpolated value. If the entire string is a single variable
+     * reference, returns the actual value. Otherwise returns an interpolated string.
+     */
+    interpolate(template: string): unknown;
+    /**
+     * Interpolate variables in an object recursively
+     *
+     * Processes all string values in the object and interpolates variables.
+     * Useful for interpolating variables in node settings.
+     */
+    interpolateObject<T>(obj: T): T;
+    /**
+     * Resolve nested path like "contact.email" or "data[0].name"
+     */
+    resolveNestedPath(path: string): unknown;
+    /**
+     * Format a value for string interpolation
+     */
+    private formatValue;
+    /**
+     * Store a node's output as variables
+     *
+     * The output is stored under the node's ID and also merged into root variables
+     * if it's a plain object.
+     *
+     * @example
+     * // Node "search_contacts" returns { contacts: [...] }
+     * // Variables become: { search_contacts: { contacts: [...] }, contacts: [...] }
+     */
+    storeNodeOutput(nodeId: string, output: unknown): void;
+    /**
+     * Get a node's output by node ID
+     */
+    getNodeOutput<T = unknown>(nodeId: string): T | undefined;
+    /**
+     * Create a NodeExecutionContext for use with executors
+     */
+    toNodeContext(userId: string, workflowExecutionId: string, campaignId?: string): NodeExecutionContext;
+    /**
+     * Export variables as JSON
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create ExecutionContext from JSON
+     */
+    static fromJSON(json: Record<string, unknown>): ExecutionContext;
+}
+/**
+ * Create execution context from workflow input
+ */
+export declare function createExecutionContext(input?: Record<string, unknown>): ExecutionContext;
+/**
+ * Prepare node input by interpolating variables from execution context
+ */
+export declare function prepareNodeInput<T extends Record<string, unknown>>(nodeSettings: T, context: ExecutionContext): T;
+//# sourceMappingURL=context.d.ts.map

package/dist/execution/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/execution/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0B;gBAE/B,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAI1D;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1C;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAOnD;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAevC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAoCtC;;;;;OAKG;IACH,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAuB/B;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IA2BxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;;;;;;;;OASG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAYtD;;OAEG;IACH,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIzD;;OAEG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,MAAM,EAC3B,UAAU,CAAC,EAAE,MAAM,GAClB,oBAAoB;IAUvB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;CAGjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,gBAAgB,GACxB,CAAC,CAEH"}

package/dist/execution/context.js

@@ -0,0 +1,259 @@
+import { JSONPath } from 'jsonpath-plus';
+/**
+ * Manages workflow variables and provides utilities for:
+ * - Storing node outputs as variables
+ * - Retrieving variable values
+ * - Interpolating variables into strings
+ * - JSONPath evaluation for nested data access
+ */
+export class ExecutionContext {
+    variables;
+    constructor(initialVariables = {}) {
+        this.variables = { ...initialVariables };
+    }
+    /**
+     * Set a variable value
+     */
+    setVariable(name, value) {
+        this.variables[name] = value;
+    }
+    /**
+     * Get a variable value
+     */
+    getVariable(name) {
+        return this.variables[name];
+    }
+    /**
+     * Get all variables as a plain object
+     */
+    getAllVariables() {
+        return { ...this.variables };
+    }
+    /**
+     * Check if a variable exists
+     */
+    hasVariable(name) {
+        return name in this.variables;
+    }
+    /**
+     * Delete a variable
+     */
+    deleteVariable(name) {
+        delete this.variables[name];
+    }
+    /**
+     * Clear all variables
+     */
+    clearAll() {
+        this.variables = {};
+    }
+    /**
+     * Merge multiple variables at once
+     */
+    mergeVariables(vars) {
+        this.variables = {
+            ...this.variables,
+            ...vars,
+        };
+    }
+    /**
+     * Evaluate a JSONPath expression against workflow variables
+     *
+     * @example
+     * // Get first contact's email
+     * ctx.evaluateJsonPath('$.contacts[0].email')
+     *
+     * @example
+     * // Get all email subjects
+     * ctx.evaluateJsonPath('$.emailDrafts[*].subject')
+     */
+    evaluateJsonPath(path) {
+        try {
+            const result = JSONPath({ path, json: this.variables });
+            // If path returns single value, unwrap array
+            if (Array.isArray(result) && result.length === 1) {
+                return result[0];
+            }
+            return result;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Interpolate variables into a string template
+     *
+     * Supports:
+     * - Simple variables: "Hello {{name}}"
+     * - Nested access: "Email: {{contact.email}}"
+     * - JSONPath: "First email: {{$.contacts[0].email}}"
+     * - Direct value replacement: "{{contacts}}" returns the actual array
+     *
+     * @returns The interpolated value. If the entire string is a single variable
+     * reference, returns the actual value. Otherwise returns an interpolated string.
+     */
+    interpolate(template) {
+        if (typeof template !== 'string') {
+            return template;
+        }
+        // Check if the entire string is just a single variable reference
+        const singleVarMatch = template.match(/^\{\{([^}]+)\}\}$/);
+        if (singleVarMatch) {
+            const expression = singleVarMatch[1].trim();
+            // Return the actual value for single variable references
+            if (expression.startsWith('$')) {
+                return this.evaluateJsonPath(expression);
+            }
+            return this.resolveNestedPath(expression);
+        }
+        // Match {{variable}} or {{$.jsonpath.expression}}
+        const regex = /\{\{([^}]+)\}\}/g;
+        return template.replace(regex, (match, expression) => {
+            const trimmed = expression.trim();
+            // Check if it's a JSONPath expression
+            if (trimmed.startsWith('$')) {
+                const result = this.evaluateJsonPath(trimmed);
+                return this.formatValue(result);
+            }
+            // Handle dot notation (e.g., contact.email)
+            const value = this.resolveNestedPath(trimmed);
+            return this.formatValue(value);
+        });
+    }
+    /**
+     * Interpolate variables in an object recursively
+     *
+     * Processes all string values in the object and interpolates variables.
+     * Useful for interpolating variables in node settings.
+     */
+    interpolateObject(obj) {
+        // Check for string FIRST
+        if (typeof obj === 'string') {
+            return this.interpolate(obj);
+        }
+        // Then check for non-objects
+        if (typeof obj !== 'object' || obj === null) {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.interpolateObject(item));
+        }
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = this.interpolateObject(value);
+        }
+        return result;
+    }
+    /**
+     * Resolve nested path like "contact.email" or "data[0].name"
+     */
+    resolveNestedPath(path) {
+        const parts = path.split('.');
+        let current = this.variables;
+        for (const part of parts) {
+            if (current === null || current === undefined) {
+                return undefined;
+            }
+            // Handle array access like "contacts[0]"
+            const arrayMatch = part.match(/^(\w+)\[(\d+)\]$/);
+            if (arrayMatch) {
+                const [, key, index] = arrayMatch;
+                current = current[key];
+                if (Array.isArray(current)) {
+                    current = current[parseInt(index, 10)];
+                }
+                else {
+                    return undefined;
+                }
+            }
+            else {
+                current = current[part];
+            }
+        }
+        return current;
+    }
+    /**
+     * Format a value for string interpolation
+     */
+    formatValue(value) {
+        if (value === null || value === undefined) {
+            return '';
+        }
+        if (typeof value === 'string') {
+            return value;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            return String(value);
+        }
+        if (Array.isArray(value)) {
+            return value.map((v) => this.formatValue(v)).join(', ');
+        }
+        if (typeof value === 'object') {
+            return JSON.stringify(value);
+        }
+        return String(value);
+    }
+    /**
+     * Store a node's output as variables
+     *
+     * The output is stored under the node's ID and also merged into root variables
+     * if it's a plain object.
+     *
+     * @example
+     * // Node "search_contacts" returns { contacts: [...] }
+     * // Variables become: { search_contacts: { contacts: [...] }, contacts: [...] }
+     */
+    storeNodeOutput(nodeId, output) {
+        // Store under node ID
+        this.setVariable(nodeId, output);
+        // If output is a plain object, merge keys into root
+        if (output && typeof output === 'object' && !Array.isArray(output)) {
+            for (const [key, value] of Object.entries(output)) {
+                this.setVariable(key, value);
+            }
+        }
+    }
+    /**
+     * Get a node's output by node ID
+     */
+    getNodeOutput(nodeId) {
+        return this.getVariable(nodeId);
+    }
+    /**
+     * Create a NodeExecutionContext for use with executors
+     */
+    toNodeContext(userId, workflowExecutionId, campaignId) {
+        return {
+            userId,
+            workflowExecutionId,
+            campaignId,
+            variables: this.getAllVariables(),
+            resolveNestedPath: this.resolveNestedPath.bind(this),
+        };
+    }
+    /**
+     * Export variables as JSON
+     */
+    toJSON() {
+        return this.getAllVariables();
+    }
+    /**
+     * Create ExecutionContext from JSON
+     */
+    static fromJSON(json) {
+        return new ExecutionContext(json);
+    }
+}
+/**
+ * Create execution context from workflow input
+ */
+export function createExecutionContext(input) {
+    return new ExecutionContext(input || {});
+}
+/**
+ * Prepare node input by interpolating variables from execution context
+ */
+export function prepareNodeInput(nodeSettings, context) {
+    return context.interpolateObject(nodeSettings);
+}
+//# sourceMappingURL=context.js.map

package/dist/execution/context.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,2 @@
+export { ExecutionContext, createExecutionContext, prepareNodeInput, } from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,2 @@
+export { ExecutionContext, createExecutionContext, prepareNodeInput, } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { NodeExecutionContext, NodeExecutionResult, NodeExecutor, NodeApprovalRequest, NodeCapabilities, NodeCategory, NodeMetadata, NodeDefinition, NodeApprovalConfig, NodeNotificationConfig, BaseNodeConfig, } from './types/index.js';
+export { ExecutionContext, createExecutionContext, prepareNodeInput, } from './execution/index.js';
+export { NodeRegistry, createRegistry } from './registry/index.js';
+export { defineNode } from './utils/index.js';
+export type { DefineNodeConfig } from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Execution context
+export { ExecutionContext, createExecutionContext, prepareNodeInput, } from './execution/index.js';
+// Registry
+export { NodeRegistry, createRegistry } from './registry/index.js';
+// Utilities
+export { defineNode } from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEnE,YAAY;AACZ,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,2 @@
+export { NodeRegistry, createRegistry } from './node-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,2 @@
+export { NodeRegistry, createRegistry } from './node-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/node-registry.d.ts

@@ -0,0 +1,93 @@
+import type { NodeDefinition, NodeMetadata, NodeExecutor, NodeCategory } from '../types/index.js';
+/**
+ * Registry for workflow nodes.
+ * Manages node definitions and provides lookup utilities.
+ *
+ * @template TNodeType - String union of valid node types
+ *
+ * @example
+ * ```typescript
+ * const registry = new NodeRegistry<'conditional' | 'end' | 'custom'>();
+ *
+ * registry.register(conditionalNode);
+ * registry.register(endNode);
+ *
+ * const executor = registry.getExecutor('conditional');
+ * ```
+ */
+export declare class NodeRegistry<TNodeType extends string = string> {
+    private definitions;
+    private metadata;
+    /**
+     * Register a node definition
+     * @throws Error if node type is already registered
+     */
+    register<TInput, TOutput>(definition: NodeDefinition<TInput, TOutput>): this;
+    /**
+     * Register multiple node definitions at once
+     */
+    registerAll(definitions: NodeDefinition[]): this;
+    /**
+     * Unregister a node type
+     */
+    unregister(type: TNodeType): boolean;
+    /**
+     * Check if a node type is registered
+     */
+    has(type: TNodeType): boolean;
+    /**
+     * Get node definition (includes executor)
+     */
+    getDefinition(type: TNodeType): NodeDefinition | undefined;
+    /**
+     * Get node metadata (client-safe, no executor)
+     */
+    getMetadata(type: TNodeType): NodeMetadata | undefined;
+    /**
+     * Get node executor
+     */
+    getExecutor(type: TNodeType): NodeExecutor | undefined;
+    /**
+     * Get all registered node types
+     */
+    getNodeTypes(): TNodeType[];
+    /**
+     * Get all node definitions
+     */
+    getAllDefinitions(): NodeDefinition[];
+    /**
+     * Get all metadata (for client-side rendering)
+     */
+    getAllMetadata(): NodeMetadata[];
+    /**
+     * Get definitions by category
+     */
+    getByCategory(category: NodeCategory): NodeDefinition[];
+    /**
+     * Get metadata by category
+     */
+    getMetadataByCategory(category: NodeCategory): NodeMetadata[];
+    /**
+     * Validate input against node's input schema
+     * @throws ZodError if validation fails
+     */
+    validateInput<TInput>(type: TNodeType, input: unknown): TInput;
+    /**
+     * Validate output against node's output schema
+     * @throws ZodError if validation fails
+     */
+    validateOutput<TOutput>(type: TNodeType, output: unknown): TOutput;
+    /**
+     * Get count of registered nodes
+     */
+    get size(): number;
+    /**
+     * Extract client-safe metadata from definition
+     */
+    private extractMetadata;
+}
+/**
+ * Create a new node registry
+ */
+export declare function createRegistry<TNodeType extends string = string>(): NodeRegistry<TNodeType>;
+//# sourceMappingURL=node-registry.d.ts.map

package/dist/registry/node-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-registry.d.ts","sourceRoot":"","sources":["../../src/registry/node-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IACzD,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,QAAQ,CAAsC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,EACtB,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,IAAI;IAcP;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,IAAI;IAOhD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAMpC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAI7B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,SAAS;IAI1D;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS;IAItD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS;IAItD;;OAEG;IACH,YAAY,IAAI,SAAS,EAAE;IAI3B;;OAEG;IACH,iBAAiB,IAAI,cAAc,EAAE;IAIrC;;OAEG;IACH,cAAc,IAAI,YAAY,EAAE;IAIhC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,EAAE;IAIvD;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE;IAI7D;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;IAQ9D;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAQlE;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;CAUxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,SAAS,MAAM,GAAG,MAAM,KAC9B,YAAY,CAAC,SAAS,CAAC,CAE3B"}

package/dist/registry/node-registry.js

@@ -0,0 +1,153 @@
+/**
+ * Registry for workflow nodes.
+ * Manages node definitions and provides lookup utilities.
+ *
+ * @template TNodeType - String union of valid node types
+ *
+ * @example
+ * ```typescript
+ * const registry = new NodeRegistry<'conditional' | 'end' | 'custom'>();
+ *
+ * registry.register(conditionalNode);
+ * registry.register(endNode);
+ *
+ * const executor = registry.getExecutor('conditional');
+ * ```
+ */
+export class NodeRegistry {
+    definitions = new Map();
+    metadata = new Map();
+    /**
+     * Register a node definition
+     * @throws Error if node type is already registered
+     */
+    register(definition) {
+        const type = definition.type;
+        if (this.definitions.has(type)) {
+            throw new Error(`Node type "${type}" is already registered`);
+        }
+        // Cast to unknown first to satisfy TypeScript's strict variance checks
+        this.definitions.set(type, definition);
+        this.metadata.set(type, this.extractMetadata(definition));
+        return this;
+    }
+    /**
+     * Register multiple node definitions at once
+     */
+    registerAll(definitions) {
+        for (const definition of definitions) {
+            this.register(definition);
+        }
+        return this;
+    }
+    /**
+     * Unregister a node type
+     */
+    unregister(type) {
+        const hadDefinition = this.definitions.delete(type);
+        this.metadata.delete(type);
+        return hadDefinition;
+    }
+    /**
+     * Check if a node type is registered
+     */
+    has(type) {
+        return this.definitions.has(type);
+    }
+    /**
+     * Get node definition (includes executor)
+     */
+    getDefinition(type) {
+        return this.definitions.get(type);
+    }
+    /**
+     * Get node metadata (client-safe, no executor)
+     */
+    getMetadata(type) {
+        return this.metadata.get(type);
+    }
+    /**
+     * Get node executor
+     */
+    getExecutor(type) {
+        return this.definitions.get(type)?.executor;
+    }
+    /**
+     * Get all registered node types
+     */
+    getNodeTypes() {
+        return Array.from(this.definitions.keys());
+    }
+    /**
+     * Get all node definitions
+     */
+    getAllDefinitions() {
+        return Array.from(this.definitions.values());
+    }
+    /**
+     * Get all metadata (for client-side rendering)
+     */
+    getAllMetadata() {
+        return Array.from(this.metadata.values());
+    }
+    /**
+     * Get definitions by category
+     */
+    getByCategory(category) {
+        return this.getAllDefinitions().filter((def) => def.category === category);
+    }
+    /**
+     * Get metadata by category
+     */
+    getMetadataByCategory(category) {
+        return this.getAllMetadata().filter((meta) => meta.category === category);
+    }
+    /**
+     * Validate input against node's input schema
+     * @throws ZodError if validation fails
+     */
+    validateInput(type, input) {
+        const definition = this.definitions.get(type);
+        if (!definition) {
+            throw new Error(`Unknown node type: ${type}`);
+        }
+        return definition.inputSchema.parse(input);
+    }
+    /**
+     * Validate output against node's output schema
+     * @throws ZodError if validation fails
+     */
+    validateOutput(type, output) {
+        const definition = this.definitions.get(type);
+        if (!definition) {
+            throw new Error(`Unknown node type: ${type}`);
+        }
+        return definition.outputSchema.parse(output);
+    }
+    /**
+     * Get count of registered nodes
+     */
+    get size() {
+        return this.definitions.size;
+    }
+    /**
+     * Extract client-safe metadata from definition
+     */
+    extractMetadata(definition) {
+        return {
+            type: definition.type,
+            name: definition.name,
+            description: definition.description,
+            category: definition.category,
+            estimatedDuration: definition.estimatedDuration,
+            capabilities: definition.capabilities,
+        };
+    }
+}
+/**
+ * Create a new node registry
+ */
+export function createRegistry() {
+    return new NodeRegistry();
+}
+//# sourceMappingURL=node-registry.js.map

package/dist/registry/node-registry.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Approval configuration for nodes.
+ * Any node can optionally require approval before/after execution.
+ */
+export interface NodeApprovalConfig {
+    /** Whether approval is required for this node */
+    required: boolean;
+    /** Whether to pause workflow execution until approved (default: true) */
+    pauseWorkflow?: boolean;
+    /** Timeout in minutes before auto-rejection (default: 1440 = 24h) */
+    timeoutMinutes?: number;
+    /** Type of approval for UI display */
+    approvalType?: string;
+    /** Optional message to display to approver */
+    message?: string;
+}
+/**
+ * Notification configuration for nodes.
+ * Any node can optionally send notifications on completion/error.
+ */
+export interface NodeNotificationConfig {
+    /** Enable notifications for this node */
+    enabled: boolean;
+    /** Channels to send notifications to */
+    channels?: Array<'chat' | 'email' | 'slack' | 'webhook'>;
+    /** Notification message template */
+    message?: string;
+    /** Priority level */
+    priority?: 'low' | 'medium' | 'high';
+    /** Notify on successful completion */
+    notifyOnComplete?: boolean;
+    /** Notify on error */
+    notifyOnError?: boolean;
+}
+/**
+ * Base config that all nodes can optionally include.
+ * Provides approval and notification capabilities to any node type.
+ */
+export interface BaseNodeConfig {
+    /** Approval configuration */
+    approval?: NodeApprovalConfig;
+    /** Notification configuration */
+    notification?: NodeNotificationConfig;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IACzD,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,iCAAiC;IACjC,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { NodeExecutionContext, NodeExecutionResult, NodeExecutor, NodeApprovalRequest, NodeCapabilities, NodeCategory, NodeMetadata, NodeDefinition, } from './node.js';
+export type { NodeApprovalConfig, NodeNotificationConfig, BaseNodeConfig, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/types/node.d.ts

@@ -0,0 +1,109 @@
+import type { z } from 'zod';
+/**
+ * Base execution context passed to all node executors.
+ * Provides access to workflow state and utilities.
+ */
+export interface NodeExecutionContext {
+    /** User ID executing the workflow */
+    userId: string;
+    /** Optional campaign/project context */
+    campaignId?: string;
+    /** Unique identifier for this workflow execution */
+    workflowExecutionId: string;
+    /** Variables from previous node outputs */
+    variables: Record<string, unknown>;
+    /** Resolve nested path like "contact.email" or "data[0].name" */
+    resolveNestedPath: (path: string) => unknown;
+}
+/**
+ * Approval request metadata returned by nodes that need user approval.
+ */
+export interface NodeApprovalRequest {
+    /** IDs of resources needing approval */
+    resourceIds: string[];
+    /** Type of resource for UI display */
+    resourceType: string;
+    /** Optional message to display to approver */
+    message?: string;
+    /** Component to use for displaying approval details */
+    detailComponent?: string;
+}
+/**
+ * Result returned by node executors.
+ * @template TOutput - Type of the output data
+ */
+export interface NodeExecutionResult<TOutput = unknown> {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Output data on success */
+    output?: TOutput;
+    /** Error message on failure */
+    error?: string;
+    /** Next node ID for conditional branching */
+    nextNodeId?: string;
+    /** Approval request if node needs user approval */
+    needsApproval?: NodeApprovalRequest;
+    /** Notification to send to user */
+    notification?: {
+        title: string;
+        message: string;
+        data?: Record<string, unknown>;
+    };
+}
+/**
+ * Node executor function type.
+ * Async function that takes input and context, returns result.
+ * @template TInput - Input type (validated by inputSchema)
+ * @template TOutput - Output type (validated by outputSchema)
+ */
+export type NodeExecutor<TInput = unknown, TOutput = unknown> = (input: TInput, context: NodeExecutionContext) => Promise<NodeExecutionResult<TOutput>>;
+/**
+ * Node capabilities for UI and runtime behavior.
+ */
+export interface NodeCapabilities {
+    /** Node supports data enrichment */
+    supportsEnrichment?: boolean;
+    /** Node supports bulk actions */
+    supportsBulkActions?: boolean;
+    /** Node supports approval workflow */
+    supportsApproval?: boolean;
+    /** Node can be re-run after completion */
+    supportsRerun?: boolean;
+    /** Node supports cancellation */
+    supportsCancel?: boolean;
+}
+/**
+ * Node category for organization.
+ */
+export type NodeCategory = 'action' | 'logic' | 'integration' | 'transform';
+/**
+ * Metadata about a node (safe for client-side use).
+ */
+export interface NodeMetadata {
+    /** Unique node type identifier */
+    type: string;
+    /** Display name */
+    name: string;
+    /** Description of what the node does */
+    description: string;
+    /** Category for grouping */
+    category: NodeCategory;
+    /** Estimated duration in seconds */
+    estimatedDuration?: number;
+    /** Node capabilities */
+    capabilities?: NodeCapabilities;
+}
+/**
+ * Complete node definition including executor.
+ * @template TInput - Input type
+ * @template TOutput - Output type
+ */
+export interface NodeDefinition<TInput = unknown, TOutput = unknown> extends NodeMetadata {
+    /** Zod schema for validating input */
+    inputSchema: z.ZodSchema<TInput>;
+    /** Zod schema for validating output */
+    outputSchema: z.ZodSchema<TOutput>;
+    /** Executor function */
+    executor: NodeExecutor<TInput, TOutput>;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/types/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/types/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iEAAiE;IACjE,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO;IACpD,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,mCAAmC;IACnC,YAAY,CAAC,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC9D,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iCAAiC;IACjC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,CACjE,SAAQ,YAAY;IACpB,sCAAsC;IACtC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,uCAAuC;IACvC,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,wBAAwB;IACxB,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC"}

package/dist/types/node.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node.js.map

package/dist/types/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/types/node.ts"],"names":[],"mappings":""}

package/dist/utils/define-node.d.ts

@@ -0,0 +1,55 @@
+import type { z } from 'zod';
+import type { NodeDefinition, NodeExecutor, NodeCapabilities, NodeCategory } from '../types/index.js';
+/**
+ * Configuration for defining a node
+ */
+export interface DefineNodeConfig<TInput, TOutput> {
+    /** Unique node type identifier */
+    type: string;
+    /** Display name */
+    name: string;
+    /** Description of what the node does */
+    description: string;
+    /** Category for grouping */
+    category: NodeCategory;
+    /** Zod schema for validating input */
+    inputSchema: z.ZodSchema<TInput>;
+    /** Zod schema for validating output */
+    outputSchema: z.ZodSchema<TOutput>;
+    /** Executor function */
+    executor: NodeExecutor<TInput, TOutput>;
+    /** Estimated duration in seconds */
+    estimatedDuration?: number;
+    /** Node capabilities */
+    capabilities?: NodeCapabilities;
+}
+/**
+ * Type-safe helper for defining nodes.
+ *
+ * @example
+ * ```typescript
+ * import { defineNode } from '@jam-nodes/core';
+ * import { z } from 'zod';
+ *
+ * export const myNode = defineNode({
+ *   type: 'my_node',
+ *   name: 'My Node',
+ *   description: 'Does something useful',
+ *   category: 'action',
+ *   inputSchema: z.object({
+ *     message: z.string(),
+ *   }),
+ *   outputSchema: z.object({
+ *     result: z.string(),
+ *   }),
+ *   executor: async (input, context) => {
+ *     return {
+ *       success: true,
+ *       output: { result: `Processed: ${input.message}` },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export declare function defineNode<TInput, TOutput>(config: DefineNodeConfig<TInput, TOutput>): NodeDefinition<TInput, TOutput>;
+//# sourceMappingURL=define-node.d.ts.map

package/dist/utils/define-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-node.d.ts","sourceRoot":"","sources":["../../src/utils/define-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,EAAE,OAAO;IAC/C,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,uCAAuC;IACvC,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,wBAAwB;IACxB,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAYjC"}

package/dist/utils/define-node.js

@@ -0,0 +1,42 @@
+/**
+ * Type-safe helper for defining nodes.
+ *
+ * @example
+ * ```typescript
+ * import { defineNode } from '@jam-nodes/core';
+ * import { z } from 'zod';
+ *
+ * export const myNode = defineNode({
+ *   type: 'my_node',
+ *   name: 'My Node',
+ *   description: 'Does something useful',
+ *   category: 'action',
+ *   inputSchema: z.object({
+ *     message: z.string(),
+ *   }),
+ *   outputSchema: z.object({
+ *     result: z.string(),
+ *   }),
+ *   executor: async (input, context) => {
+ *     return {
+ *       success: true,
+ *       output: { result: `Processed: ${input.message}` },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export function defineNode(config) {
+    return {
+        type: config.type,
+        name: config.name,
+        description: config.description,
+        category: config.category,
+        inputSchema: config.inputSchema,
+        outputSchema: config.outputSchema,
+        executor: config.executor,
+        estimatedDuration: config.estimatedDuration,
+        capabilities: config.capabilities,
+    };
+}
+//# sourceMappingURL=define-node.js.map

package/dist/utils/define-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-node.js","sourceRoot":"","sources":["../../src/utils/define-node.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,UAAU,CACxB,MAAyC;IAEzC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { defineNode } from './define-node.js';
+export type { DefineNodeConfig } from './define-node.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export { defineNode } from './define-node.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@jam-nodes/core",
+  "version": "0.1.0",
+  "description": "Core framework for building workflow nodes with type-safe executors and Zod validation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "zod": "^3.0.0"
+  },
+  "dependencies": {
+    "jsonpath-plus": "^10.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "zod": "^3.24.0"
+  },
+  "keywords": [
+    "workflow",
+    "nodes",
+    "executor",
+    "zod",
+    "typescript"
+  ],
+  "author": "Jam",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wespreadjam/jam-nodes.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/wespreadjam/jam-nodes/issues"
+  },
+  "homepage": "https://github.com/wespreadjam/jam-nodes/tree/main/packages/core#readme"
+}