@flowdrop/flowdrop 1.0.0

package/dist/config/constants.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Library-wide Constants
+ *
+ * Centralizes magic numbers and default configuration values
+ * used across FlowDrop services.
+ *
+ * @module config/constants
+ */
+/** Default API request timeout in milliseconds */
+export declare const DEFAULT_API_TIMEOUT_MS = 30000;
+/** Cache timeout for node execution data in milliseconds */
+export declare const NODE_EXECUTION_CACHE_TIMEOUT_MS = 30000;
+/** Duration to mark pipeline API as unavailable after 404 (milliseconds) */
+export declare const PIPELINE_API_UNAVAILABLE_DURATION_MS: number;
+/** Default cache TTL for schema and variable data in milliseconds (5 minutes) */
+export declare const DEFAULT_CACHE_TTL_MS: number;
+/** Edge marker arrow sizes by category */
+export declare const EDGE_MARKER_SIZES: {
+    readonly loopback: {
+        readonly width: 14;
+        readonly height: 14;
+    };
+    readonly trigger: {
+        readonly width: 16;
+        readonly height: 16;
+    };
+    readonly tool: {
+        readonly width: 16;
+        readonly height: 16;
+    };
+    readonly data: {
+        readonly width: 16;
+        readonly height: 16;
+    };
+};
+/** Toast notification durations in milliseconds */
+export declare const TOAST_DURATION: {
+    readonly SUCCESS: 4000;
+    readonly ERROR: 6000;
+    readonly WARNING: 5000;
+    readonly INFO: 4000;
+    readonly CONFIRMATION: 5000;
+};

package/dist/config/constants.js

@@ -0,0 +1,31 @@
+/**
+ * Library-wide Constants
+ *
+ * Centralizes magic numbers and default configuration values
+ * used across FlowDrop services.
+ *
+ * @module config/constants
+ */
+/** Default API request timeout in milliseconds */
+export const DEFAULT_API_TIMEOUT_MS = 30_000;
+/** Cache timeout for node execution data in milliseconds */
+export const NODE_EXECUTION_CACHE_TIMEOUT_MS = 30_000;
+/** Duration to mark pipeline API as unavailable after 404 (milliseconds) */
+export const PIPELINE_API_UNAVAILABLE_DURATION_MS = 5 * 60 * 1000;
+/** Default cache TTL for schema and variable data in milliseconds (5 minutes) */
+export const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1000;
+/** Edge marker arrow sizes by category */
+export const EDGE_MARKER_SIZES = {
+    loopback: { width: 14, height: 14 },
+    trigger: { width: 16, height: 16 },
+    tool: { width: 16, height: 16 },
+    data: { width: 16, height: 16 }
+};
+/** Toast notification durations in milliseconds */
+export const TOAST_DURATION = {
+    SUCCESS: 4_000,
+    ERROR: 6_000,
+    WARNING: 5_000,
+    INFO: 4_000,
+    CONFIRMATION: 5_000
+};

package/dist/config/defaultCategories.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Default category definitions for FlowDrop
+ * Provides built-in categories with icons, colors, and display labels.
+ * These serve as fallbacks when the /categories API endpoint is unavailable.
+ */
+import type { CategoryDefinition } from '../types/index.js';
+export declare const DEFAULT_CATEGORIES: CategoryDefinition[];

package/dist/config/defaultCategories.js

@@ -0,0 +1,126 @@
+/**
+ * Default category definitions for FlowDrop
+ * Provides built-in categories with icons, colors, and display labels.
+ * These serve as fallbacks when the /categories API endpoint is unavailable.
+ */
+export const DEFAULT_CATEGORIES = [
+    {
+        name: 'triggers',
+        label: 'Triggers',
+        icon: 'mdi:lightning-bolt',
+        color: 'var(--fd-node-cyan)',
+        weight: 0
+    },
+    {
+        name: 'inputs',
+        label: 'Inputs',
+        icon: 'mdi:arrow-down-circle',
+        color: 'var(--fd-node-emerald)',
+        weight: 1
+    },
+    {
+        name: 'outputs',
+        label: 'Outputs',
+        icon: 'mdi:arrow-up-circle',
+        color: 'var(--fd-node-blue)',
+        weight: 2
+    },
+    {
+        name: 'prompts',
+        label: 'Prompts',
+        icon: 'mdi:message-text',
+        color: 'var(--fd-node-amber)',
+        weight: 3
+    },
+    {
+        name: 'models',
+        label: 'Models',
+        icon: 'mdi:robot',
+        color: 'var(--fd-node-indigo)',
+        weight: 4
+    },
+    {
+        name: 'processing',
+        label: 'Processing',
+        icon: 'mdi:cog',
+        color: 'var(--fd-node-teal)',
+        weight: 5
+    },
+    {
+        name: 'logic',
+        label: 'Logic',
+        icon: 'mdi:source-branch',
+        color: 'var(--fd-node-purple)',
+        weight: 6
+    },
+    {
+        name: 'data',
+        label: 'Data',
+        icon: 'mdi:database',
+        color: 'var(--fd-node-orange)',
+        weight: 7
+    },
+    {
+        name: 'tools',
+        label: 'Tools',
+        icon: 'mdi:wrench',
+        color: 'var(--fd-node-amber)',
+        weight: 8
+    },
+    {
+        name: 'helpers',
+        label: 'Helpers',
+        icon: 'mdi:help-circle',
+        color: 'var(--fd-node-slate)',
+        weight: 9
+    },
+    {
+        name: 'vector stores',
+        label: 'Vector Stores',
+        icon: 'mdi:vector-square',
+        color: 'var(--fd-node-emerald)',
+        weight: 10
+    },
+    {
+        name: 'embeddings',
+        label: 'Embeddings',
+        icon: 'mdi:vector-polygon',
+        color: 'var(--fd-node-indigo)',
+        weight: 11
+    },
+    {
+        name: 'memories',
+        label: 'Memories',
+        icon: 'mdi:brain',
+        color: 'var(--fd-node-blue)',
+        weight: 12
+    },
+    {
+        name: 'agents',
+        label: 'Agents',
+        icon: 'mdi:account-cog',
+        color: 'var(--fd-node-teal)',
+        weight: 13
+    },
+    {
+        name: 'ai',
+        label: 'AI',
+        icon: 'mdi:shimmer',
+        color: 'var(--fd-node-purple)',
+        weight: 14
+    },
+    {
+        name: 'interrupts',
+        label: 'Interrupts',
+        icon: 'mdi:hand-back-left',
+        color: 'var(--fd-node-red)',
+        weight: 15
+    },
+    {
+        name: 'bundles',
+        label: 'Bundles',
+        icon: 'mdi:package-variant',
+        color: 'var(--fd-node-slate)',
+        weight: 16
+    }
+];

package/dist/config/defaultPortConfig.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Default port configuration for FlowDrop
+ * Provides backward compatibility and serves as an example configuration
+ */
+import type { PortConfig } from '../types/index.js';
+export declare const DEFAULT_PORT_CONFIG: PortConfig;

package/dist/config/defaultPortConfig.js

@@ -0,0 +1,201 @@
+/**
+ * Default port configuration for FlowDrop
+ * Provides backward compatibility and serves as an example configuration
+ */
+export const DEFAULT_PORT_CONFIG = {
+    version: '1.0.0',
+    defaultDataType: 'string',
+    dataTypes: [
+        // Control flow types
+        {
+            id: 'trigger',
+            name: 'Trigger',
+            description: 'Control flow of the workflow',
+            color: 'var(--fd-node-purple)',
+            category: 'basic',
+            enabled: true
+        },
+        // Text and basic types
+        {
+            id: 'string',
+            name: 'String',
+            description: 'Text data',
+            color: 'var(--fd-node-emerald)',
+            category: 'basic',
+            enabled: true
+        },
+        // Numeric types
+        {
+            id: 'number',
+            name: 'Number',
+            description: 'Numeric data',
+            color: 'var(--fd-node-blue)',
+            category: 'numeric',
+            enabled: true
+        },
+        // Boolean types
+        {
+            id: 'boolean',
+            name: 'Boolean',
+            description: 'True/false values',
+            color: 'var(--fd-node-purple)',
+            category: 'logical',
+            enabled: true
+        },
+        // Collection types
+        {
+            id: 'array',
+            name: 'Array',
+            description: 'Ordered list of items',
+            color: 'var(--fd-node-amber)',
+            category: 'collection',
+            enabled: true
+        },
+        // Typed arrays
+        {
+            id: 'string[]',
+            name: 'String Array',
+            description: 'Array of strings',
+            color: 'var(--fd-node-emerald)',
+            category: 'collection',
+            enabled: true
+        },
+        {
+            id: 'number[]',
+            name: 'Number Array',
+            description: 'Array of numbers',
+            color: 'var(--fd-node-blue)',
+            category: 'collection',
+            enabled: true
+        },
+        {
+            id: 'boolean[]',
+            name: 'Boolean Array',
+            description: 'Array of true/false values',
+            color: 'var(--fd-node-purple)',
+            category: 'collection',
+            enabled: true
+        },
+        {
+            id: 'json[]',
+            name: 'JSON Array',
+            description: 'Array of JSON objects',
+            color: 'var(--fd-node-orange)',
+            category: 'collection',
+            enabled: true
+        },
+        {
+            id: 'file[]',
+            name: 'File Array',
+            description: 'Array of files',
+            color: 'var(--fd-node-red)',
+            category: 'collection',
+            enabled: true
+        },
+        {
+            id: 'image[]',
+            name: 'Image Array',
+            description: 'Array of images',
+            color: 'var(--fd-node-pink)',
+            category: 'collection',
+            enabled: true
+        },
+        // Complex types
+        {
+            id: 'json',
+            name: 'JSON',
+            description: 'JSON structured data',
+            color: 'var(--fd-node-orange)',
+            category: 'complex',
+            enabled: true
+        },
+        // File types
+        {
+            id: 'file',
+            name: 'File',
+            description: 'File data',
+            color: 'var(--fd-node-red)',
+            category: 'file',
+            enabled: true
+        },
+        // Media types
+        {
+            id: 'image',
+            name: 'Image',
+            description: 'Image data',
+            color: 'var(--fd-node-pink)',
+            category: 'media',
+            enabled: true
+        },
+        {
+            id: 'audio',
+            name: 'Audio',
+            description: 'Audio data',
+            color: 'var(--fd-node-indigo)',
+            category: 'media',
+            enabled: true
+        },
+        {
+            id: 'video',
+            name: 'Video',
+            description: 'Video data',
+            color: 'var(--fd-node-teal)',
+            category: 'media',
+            enabled: true
+        },
+        // Tool type
+        {
+            id: 'tool',
+            name: 'Tool',
+            description: 'Tool interface for agent connections',
+            color: 'var(--fd-node-amber)',
+            category: 'special',
+            enabled: true
+        },
+        // Special types
+        {
+            id: 'url',
+            name: 'URL',
+            description: 'Web address',
+            color: 'var(--fd-node-cyan)',
+            category: 'special',
+            enabled: true
+        },
+        {
+            id: 'email',
+            name: 'Email',
+            description: 'Email address',
+            color: 'var(--fd-node-cyan)',
+            category: 'special',
+            enabled: true
+        },
+        {
+            id: 'date',
+            name: 'Date',
+            description: 'Date value',
+            color: 'var(--fd-node-lime)',
+            category: 'temporal',
+            enabled: true
+        },
+        {
+            id: 'datetime',
+            name: 'DateTime',
+            description: 'Date and time value',
+            color: 'var(--fd-node-lime)',
+            category: 'temporal',
+            enabled: true
+        },
+        {
+            id: 'time',
+            name: 'Time',
+            description: 'Time value',
+            color: 'var(--fd-node-lime)',
+            category: 'temporal',
+            enabled: true
+        }
+    ],
+    compatibilityRules: [
+    // Pure same-type compatibility: string connects to string, number to number, etc.
+    // No additional rules needed - the system handles same-type connections automatically
+    ]
+};

package/dist/config/endpoints.d.ts

@@ -0,0 +1,160 @@
+/**
+ * FlowDrop Endpoint Configuration
+ * Provides configurable endpoints for all API actions
+ */
+import type { AgentSpecEndpointConfig } from './agentSpecEndpoints.js';
+export interface EndpointConfig {
+    /** Base URL for all endpoints */
+    baseUrl: string;
+    /** Individual endpoint paths */
+    endpoints: {
+        nodes: {
+            list: string;
+            get: string;
+            byCategory: string;
+            metadata: string;
+        };
+        portConfig: string;
+        categories: string;
+        workflows: {
+            list: string;
+            get: string;
+            create: string;
+            update: string;
+            delete: string;
+            validate: string;
+            export: string;
+            import: string;
+        };
+        executions: {
+            execute: string;
+            status: string;
+            cancel: string;
+            logs: string;
+            history: string;
+        };
+        pipelines: {
+            list: string;
+            get: string;
+            create: string;
+            update: string;
+            delete: string;
+            status: string;
+            logs: string;
+            execute: string;
+            stop: string;
+        };
+        playground: {
+            /** List sessions for a workflow */
+            listSessions: string;
+            /** Create a new session */
+            createSession: string;
+            /** Get session details */
+            getSession: string;
+            /** Delete a session */
+            deleteSession: string;
+            /** Get messages from a session */
+            getMessages: string;
+            /** Send a message to a session */
+            sendMessage: string;
+            /** Stop execution in a session */
+            stopExecution: string;
+        };
+        interrupts: {
+            /** Get interrupt details by ID */
+            get: string;
+            /** Resolve an interrupt with user response */
+            resolve: string;
+            /** Cancel a pending interrupt */
+            cancel: string;
+            /** List interrupts for a playground session */
+            listBySession: string;
+            /** List interrupts for a pipeline */
+            listByPipeline: string;
+        };
+        templates: {
+            list: string;
+            get: string;
+            create: string;
+            update: string;
+            delete: string;
+        };
+        users: {
+            profile: string;
+            preferences: string;
+        };
+        system: {
+            health: string;
+            config: string;
+            version: string;
+        };
+    };
+    /**
+     * Optional Agent Spec runtime configuration.
+     * When provided, enables Agent Spec execution features.
+     */
+    agentSpec?: AgentSpecEndpointConfig;
+    /** HTTP method overrides for specific endpoints */
+    methods?: {
+        [key: string]: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    };
+    /** Custom headers for specific endpoints */
+    headers?: {
+        [key: string]: Record<string, string>;
+    };
+    /** Authentication configuration */
+    auth?: {
+        type: 'none' | 'bearer' | 'api_key' | 'custom';
+        token?: string;
+        apiKey?: string;
+        headers?: Record<string, string>;
+    };
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Retry configuration */
+    retry?: {
+        enabled: boolean;
+        maxAttempts: number;
+        delay: number;
+        backoff?: 'linear' | 'exponential';
+    };
+    /**
+     * Optional transform applied to workflow objects before they are sent to the backend
+     * (i.e., in create and update requests).
+     *
+     * Use this to adapt the generic FlowDrop `Workflow` shape to whatever your backend
+     * expects. The function receives the workflow data and must return the body that will
+     * be JSON-serialised and posted.
+     *
+     * Default: identity — the workflow is sent as-is.
+     *
+     * @example Drupal integration — Drupal expects `label` in addition to `name`:
+     * ```ts
+     * transformWorkflowPayload: (workflow) => ({
+     *   ...workflow,
+     *   label: workflow.name,
+     * })
+     * ```
+     */
+    transformWorkflowPayload?: (workflow: Record<string, unknown>) => Record<string, unknown>;
+}
+/**
+ * Default endpoint configuration
+ */
+export declare const defaultEndpointConfig: EndpointConfig;
+/**
+ * Create endpoint configuration with custom base URL
+ */
+export declare function createEndpointConfig(baseUrl: string, overrides?: Partial<EndpointConfig>): EndpointConfig;
+/**
+ * Build full URL for an endpoint
+ */
+export declare function buildEndpointUrl(config: EndpointConfig, endpointPath: string, params?: Record<string, string>): string;
+/**
+ * Get HTTP method for an endpoint
+ */
+export declare function getEndpointMethod(config: EndpointConfig, endpointKey: string): string;
+/**
+ * Get custom headers for an endpoint
+ */
+export declare function getEndpointHeaders(config: EndpointConfig, endpointKey: string): Record<string, string>;