@d34dman/flowdrop 0.0.63 → 0.0.65

package/dist/utils/errors.js

@@ -0,0 +1,44 @@
+/**
+ * Error Handling Utilities
+ *
+ * @module utils/errors
+ */
+/**
+ * Normalize an unknown caught value into an Error instance.
+ *
+ * Use in catch blocks where the error type is `unknown`:
+ * ```typescript
+ * try { ... } catch (error) {
+ *   const err = normalizeError(error);
+ *   logger.error(err.message);
+ * }
+ * ```
+ *
+ * @param error - The caught value (may be Error, string, or anything)
+ * @returns An Error instance with a meaningful message
+ */
+export function normalizeError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    if (typeof error === 'string') {
+        return new Error(error);
+    }
+    return new Error(String(error));
+}
+/**
+ * Extract a human-readable message from an unknown error.
+ *
+ * @param error - The caught value
+ * @param fallback - Fallback message if error has no useful info
+ * @returns A string message
+ */
+export function getErrorMessage(error, fallback = 'Unknown error') {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return fallback;
+}

package/dist/utils/handleIds.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Handle ID utilities for FlowDrop
+ *
+ * Handle IDs encode node + direction + port in the format:
+ * `${nodeId}-${direction}-${portId}` (e.g., "node1-output-trigger")
+ *
+ * @module utils/handleIds
+ */
+/**
+ * Build a handle ID from its parts.
+ *
+ * @param nodeId - The node identifier
+ * @param direction - 'input' or 'output'
+ * @param portId - The port identifier
+ * @returns A composite handle ID string
+ */
+export declare function buildHandleId(nodeId: string, direction: 'input' | 'output', portId: string): string;
+/**
+ * Extract the port ID from a composite handle ID.
+ *
+ * Supports two formats:
+ * 1. Standard: `${nodeId}-output-${portId}` or `${nodeId}-input-${portId}`
+ * 2. Short: just the portId itself (returned as-is)
+ *
+ * @param handleId - The handle ID string
+ * @returns The port ID, or null if handleId is empty/undefined
+ */
+export declare function extractPortId(handleId: string | undefined): string | null;
+/**
+ * Extract the direction from a composite handle ID.
+ *
+ * @param handleId - The handle ID string
+ * @returns 'input', 'output', or null if not found
+ */
+export declare function extractDirection(handleId: string | undefined): 'input' | 'output' | null;

package/dist/utils/handleIds.js

@@ -0,0 +1,58 @@
+/**
+ * Handle ID utilities for FlowDrop
+ *
+ * Handle IDs encode node + direction + port in the format:
+ * `${nodeId}-${direction}-${portId}` (e.g., "node1-output-trigger")
+ *
+ * @module utils/handleIds
+ */
+/**
+ * Build a handle ID from its parts.
+ *
+ * @param nodeId - The node identifier
+ * @param direction - 'input' or 'output'
+ * @param portId - The port identifier
+ * @returns A composite handle ID string
+ */
+export function buildHandleId(nodeId, direction, portId) {
+    return `${nodeId}-${direction}-${portId}`;
+}
+/**
+ * Extract the port ID from a composite handle ID.
+ *
+ * Supports two formats:
+ * 1. Standard: `${nodeId}-output-${portId}` or `${nodeId}-input-${portId}`
+ * 2. Short: just the portId itself (returned as-is)
+ *
+ * @param handleId - The handle ID string
+ * @returns The port ID, or null if handleId is empty/undefined
+ */
+export function extractPortId(handleId) {
+    if (!handleId)
+        return null;
+    const outputMatch = handleId.lastIndexOf('-output-');
+    if (outputMatch !== -1) {
+        return handleId.substring(outputMatch + '-output-'.length);
+    }
+    const inputMatch = handleId.lastIndexOf('-input-');
+    if (inputMatch !== -1) {
+        return handleId.substring(inputMatch + '-input-'.length);
+    }
+    // Short format: the handleId IS the port ID
+    return handleId;
+}
+/**
+ * Extract the direction from a composite handle ID.
+ *
+ * @param handleId - The handle ID string
+ * @returns 'input', 'output', or null if not found
+ */
+export function extractDirection(handleId) {
+    if (!handleId)
+        return null;
+    if (handleId.includes('-output-'))
+        return 'output';
+    if (handleId.includes('-input-'))
+        return 'input';
+    return null;
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@d34dman/flowdrop",
   "license": "MIT",
   "private": false,
-  "version": "0.0.63",
+  "version": "0.0.65",
   "watch": {
     "build": {
       "ignore": "build",
@@ -112,12 +112,53 @@
     }
   },
   "peerDependencies": {
+    "@codemirror/autocomplete": "^6.20.0",
+    "@codemirror/commands": "^6.10.2",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/language": "^6.12.1",
+    "@codemirror/lint": "^6.9.2",
+    "@codemirror/state": "^6.5.4",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.39.14",
     "@iconify/svelte": "^5.0.0",
+    "@xyflow/svelte": "^1.2",
+    "codemirror": "^6.0.2",
     "svelte": "^5.0.0"
   },
   "peerDependenciesMeta": {
+    "@codemirror/autocomplete": {
+      "optional": true
+    },
+    "@codemirror/commands": {
+      "optional": true
+    },
+    "@codemirror/lang-json": {
+      "optional": true
+    },
+    "@codemirror/lang-markdown": {
+      "optional": true
+    },
+    "@codemirror/language": {
+      "optional": true
+    },
+    "@codemirror/lint": {
+      "optional": true
+    },
+    "@codemirror/state": {
+      "optional": true
+    },
+    "@codemirror/theme-one-dark": {
+      "optional": true
+    },
+    "@codemirror/view": {
+      "optional": true
+    },
     "@iconify/svelte": {
       "optional": true
+    },
+    "codemirror": {
+      "optional": true
     }
   },
   "repository": {
@@ -126,6 +167,17 @@
   },
   "devDependencies": {
     "@chromatic-com/storybook": "^5.0.1",
+    "@xyflow/svelte": "^1.2",
+    "@codemirror/autocomplete": "^6.20.0",
+    "@codemirror/commands": "^6.10.2",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/language": "^6.12.1",
+    "@codemirror/lint": "^6.9.2",
+    "@codemirror/state": "^6.5.4",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.39.14",
+    "codemirror": "^6.0.2",
     "@eslint/compat": "^1.2.5",
     "@eslint/js": "^9.18.0",
     "@iconify/svelte": "^5.0.0",
@@ -191,17 +243,6 @@
     "dag"
   ],
   "dependencies": {
-    "@codemirror/autocomplete": "^6.20.0",
-    "@codemirror/commands": "^6.10.2",
-    "@codemirror/lang-json": "^6.0.2",
-    "@codemirror/lang-markdown": "^6.5.0",
-    "@codemirror/language": "^6.12.1",
-    "@codemirror/lint": "^6.9.2",
-    "@codemirror/state": "^6.5.4",
-    "@codemirror/theme-one-dark": "^6.1.3",
-    "@codemirror/view": "^6.39.14",
-    "@xyflow/svelte": "^1.2",
-    "codemirror": "^6.0.2",
     "diff": "^8.0.3",
     "dompurify": "^3.3.1",
     "marked": "^16.1.1",

package/dist/api/client.d.ts

@@ -1,110 +0,0 @@
-/**
- * API Client for FlowDrop Workflow Library
- */
-import type { NodeMetadata, Workflow, ExecutionResult, PortConfig, CategoryDefinition } from '../types/index.js';
-/**
- * HTTP API client for FlowDrop
- *
- * @deprecated Use {@link EnhancedFlowDropApiClient} instead, which supports
- * configurable endpoints, authentication providers, retry logic, and timeouts.
- * This class will be removed in a future major version.
- */
-export declare class FlowDropApiClient {
-    private baseUrl;
-    private headers;
-    constructor(baseUrl: string, apiKey?: string);
-    /**
-     * Make HTTP request with error handling
-     */
-    private request;
-    /**
-     * Fetch available node types and their metadata
-     */
-    getAvailableNodes(): Promise<NodeMetadata[]>;
-    /**
-     * Fetch nodes by category
-     */
-    getNodesByCategory(category: string): Promise<NodeMetadata[]>;
-    /**
-     * Fetch a specific node's metadata
-     */
-    getNodeMetadata(nodeId: string): Promise<NodeMetadata>;
-    /**
-     * Save a workflow
-     */
-    saveWorkflow(workflow: Workflow): Promise<Workflow>;
-    /**
-     * Update an existing workflow
-     */
-    updateWorkflow(workflowId: string, workflow: Partial<Workflow>): Promise<Workflow>;
-    /**
-     * Load a workflow by ID
-     */
-    loadWorkflow(workflowId: string): Promise<Workflow>;
-    /**
-     * List all workflows
-     */
-    listWorkflows(): Promise<Workflow[]>;
-    /**
-     * Delete a workflow
-     */
-    deleteWorkflow(workflowId: string): Promise<void>;
-    /**
-     * Execute a workflow
-     */
-    executeWorkflow(workflowId: string, inputs?: Record<string, unknown>): Promise<ExecutionResult>;
-    /**
-     * Get execution status
-     */
-    getExecutionStatus(executionId: string): Promise<ExecutionResult>;
-    /**
-     * Cancel workflow execution
-     */
-    cancelExecution(executionId: string): Promise<void>;
-    /**
-     * Get execution logs
-     */
-    getExecutionLogs(executionId: string): Promise<string[]>;
-    /**
-     * Validate workflow configuration
-     */
-    validateWorkflow(workflow: Workflow): Promise<{
-        valid: boolean;
-        errors: string[];
-    }>;
-    /**
-     * Export workflow as JSON
-     */
-    exportWorkflow(workflowId: string): Promise<string>;
-    /**
-     * Import workflow from JSON
-     */
-    importWorkflow(workflowJson: string): Promise<Workflow>;
-    /**
-     * Fetch port configuration
-     */
-    getPortConfig(): Promise<PortConfig>;
-    /**
-     * Fetch category definitions
-     */
-    getCategories(): Promise<CategoryDefinition[]>;
-    /**
-     * Fetch pipeline data including job information and status
-     */
-    getPipelineData(pipelineId: string): Promise<{
-        status: string;
-        jobs: Array<Record<string, unknown>>;
-        node_statuses: Record<string, {
-            status: string;
-            [key: string]: unknown;
-        }>;
-        job_status_summary: {
-            total: number;
-            pending: number;
-            running: number;
-            completed: number;
-            failed: number;
-            cancelled: number;
-        };
-    }>;
-}

package/dist/api/client.js

@@ -1,240 +0,0 @@
-/**
- * API Client for FlowDrop Workflow Library
- */
-import { logger } from '../utils/logger.js';
-/**
- * HTTP API client for FlowDrop
- *
- * @deprecated Use {@link EnhancedFlowDropApiClient} instead, which supports
- * configurable endpoints, authentication providers, retry logic, and timeouts.
- * This class will be removed in a future major version.
- */
-export class FlowDropApiClient {
-    baseUrl;
-    headers;
-    constructor(baseUrl, apiKey) {
-        this.baseUrl = baseUrl.replace(/\/$/, '');
-        this.headers = {
-            'Content-Type': 'application/json'
-        };
-        if (apiKey) {
-            this.headers['Authorization'] = `Bearer ${apiKey}`;
-        }
-    }
-    /**
-     * Make HTTP request with error handling
-     */
-    async request(endpoint, options = {}) {
-        const url = `${this.baseUrl}${endpoint}`;
-        const config = {
-            headers: this.headers,
-            ...options
-        };
-        try {
-            const response = await fetch(url, config);
-            if (!response.ok) {
-                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-            }
-            const data = await response.json();
-            return data;
-        }
-        catch (error) {
-            logger.error('API request failed:', error);
-            throw new Error(`API request failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    /**
-     * Fetch available node types and their metadata
-     */
-    async getAvailableNodes() {
-        const response = await this.request('/nodes');
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to fetch available nodes');
-        }
-        return response.data;
-    }
-    /**
-     * Fetch nodes by category
-     */
-    async getNodesByCategory(category) {
-        const response = await this.request(`/nodes?category=${encodeURIComponent(category)}`);
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to fetch nodes by category');
-        }
-        return response.data;
-    }
-    /**
-     * Fetch a specific node's metadata
-     */
-    async getNodeMetadata(nodeId) {
-        const response = await this.request(`/nodes/${encodeURIComponent(nodeId)}`);
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to fetch node metadata');
-        }
-        return response.data;
-    }
-    /**
-     * Save a workflow
-     */
-    async saveWorkflow(workflow) {
-        const response = await this.request('/workflows', {
-            method: 'POST',
-            body: JSON.stringify(workflow)
-        });
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to save workflow');
-        }
-        return response.data;
-    }
-    /**
-     * Update an existing workflow
-     */
-    async updateWorkflow(workflowId, workflow) {
-        const response = await this.request(`/workflows/${encodeURIComponent(workflowId)}`, {
-            method: 'PUT',
-            body: JSON.stringify(workflow)
-        });
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to update workflow');
-        }
-        return response.data;
-    }
-    /**
-     * Load a workflow by ID
-     */
-    async loadWorkflow(workflowId) {
-        const response = await this.request(`/workflows/${encodeURIComponent(workflowId)}`);
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to load workflow');
-        }
-        return response.data;
-    }
-    /**
-     * List all workflows
-     */
-    async listWorkflows() {
-        const response = await this.request('/workflows');
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to list workflows');
-        }
-        return response.data;
-    }
-    /**
-     * Delete a workflow
-     */
-    async deleteWorkflow(workflowId) {
-        const response = await this.request(`/workflows/${encodeURIComponent(workflowId)}`, {
-            method: 'DELETE'
-        });
-        if (!response.success) {
-            throw new Error(response.error || 'Failed to delete workflow');
-        }
-    }
-    /**
-     * Execute a workflow
-     */
-    async executeWorkflow(workflowId, inputs) {
-        const response = await this.request(`/workflows/${encodeURIComponent(workflowId)}/execute`, {
-            method: 'POST',
-            body: JSON.stringify({ inputs })
-        });
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to execute workflow');
-        }
-        return response.data;
-    }
-    /**
-     * Get execution status
-     */
-    async getExecutionStatus(executionId) {
-        const response = await this.request(`/executions/${encodeURIComponent(executionId)}`);
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to get execution status');
-        }
-        return response.data;
-    }
-    /**
-     * Cancel workflow execution
-     */
-    async cancelExecution(executionId) {
-        const response = await this.request(`/executions/${encodeURIComponent(executionId)}/cancel`, {
-            method: 'POST'
-        });
-        if (!response.success) {
-            throw new Error(response.error || 'Failed to cancel execution');
-        }
-    }
-    /**
-     * Get execution logs
-     */
-    async getExecutionLogs(executionId) {
-        const response = await this.request(`/executions/${encodeURIComponent(executionId)}/logs`);
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to get execution logs');
-        }
-        return response.data;
-    }
-    /**
-     * Validate workflow configuration
-     */
-    async validateWorkflow(workflow) {
-        const response = await this.request('/workflows/validate', {
-            method: 'POST',
-            body: JSON.stringify(workflow)
-        });
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to validate workflow');
-        }
-        return response.data;
-    }
-    /**
-     * Export workflow as JSON
-     */
-    async exportWorkflow(workflowId) {
-        const response = await this.request(`/workflows/${encodeURIComponent(workflowId)}/export`);
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to export workflow');
-        }
-        return response.data;
-    }
-    /**
-     * Import workflow from JSON
-     */
-    async importWorkflow(workflowJson) {
-        const response = await this.request('/workflows/import', {
-            method: 'POST',
-            body: JSON.stringify({ workflow: workflowJson })
-        });
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to import workflow');
-        }
-        return response.data;
-    }
-    /**
-     * Fetch port configuration
-     */
-    async getPortConfig() {
-        const response = await this.request('/port-config');
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to fetch port configuration');
-        }
-        return response.data;
-    }
-    /**
-     * Fetch category definitions
-     */
-    async getCategories() {
-        const response = await this.request('/categories');
-        if (!response.success || !response.data) {
-            throw new Error(response.error || 'Failed to fetch categories');
-        }
-        return response.data;
-    }
-    /**
-     * Fetch pipeline data including job information and status
-     */
-    async getPipelineData(pipelineId) {
-        const response = await this.request(`/pipeline/${encodeURIComponent(pipelineId)}`);
-        return response;
-    }
-}