@d34dman/flowdrop 0.0.61 → 0.0.62

package/README.md

@@ -75,6 +75,12 @@ You get a production-ready workflow UI. You keep full control of everything else
 | 🎭 **Framework Flexible**    | Use as Svelte component or mount into React, Vue, Angular, or vanilla JS  |
 | 🐳 **Deploy Anywhere**       | Runtime config means build once, deploy everywhere                        |
 
+## Architecture Notes
+
+- **Single instance per page.** FlowDrop uses module-level singleton stores for state management. Only one FlowDrop editor instance can exist on a page at a time.
+- **Svelte 5 required.** FlowDrop uses Svelte 5 runes (`$state`, `$derived`, `$effect`) throughout. Svelte 4 is not supported.
+- **Modern browsers only.** The library targets ES2020+ and does not include polyfills for older browsers.
+
 ## Node Types
 
 FlowDrop ships with 7 beautifully designed node types:

package/dist/adapters/WorkflowAdapter.d.ts

@@ -158,7 +158,7 @@ export declare class WorkflowAdapter {
         nodeTypeCounts: {
             [k: string]: number;
         };
-        lastModified: string;
+        lastModified: string | undefined;
     };
     /**
      * Clone a workflow

package/dist/adapters/agentspec/AgentSpecAdapter.js

@@ -12,6 +12,7 @@
 import { getComponentTypeDefaults, extractComponentType, AGENTSPEC_NAMESPACE } from './componentTypeDefaults.js';
 import { computeAutoLayout } from './autoLayout.js';
 import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../../utils/logger.js';
 // ============================================================================
 // Handle ID Helpers
 // ============================================================================
@@ -351,8 +352,9 @@ export class AgentSpecAdapter {
                                 ? JSON.parse(config.headers)
                                 : config.headers;
                     }
-                    catch {
+                    catch (error) {
                         // Ignore parse errors
+                        logger.warn('Failed to parse header JSON', error);
                     }
                 }
                 return apiNode;

package/dist/api/client.d.ts

@@ -4,6 +4,10 @@
 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;

package/dist/api/client.js

@@ -1,8 +1,13 @@
 /**
  * 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;
@@ -34,7 +39,7 @@ export class FlowDropApiClient {
             return data;
         }
         catch (error) {
-            console.error('API request failed:', error);
+            logger.error('API request failed:', error);
             throw new Error(`API request failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     }

package/dist/api/enhanced-client.js

@@ -7,8 +7,9 @@
  */
 import { buildEndpointUrl, getEndpointMethod, getEndpointHeaders } from '../config/endpoints.js';
 import { NoAuthProvider } from '../types/auth.js';
-import { get } from 'svelte/store';
-import { apiSettings } from '../stores/settingsStore.js';
+import { getApiSettings } from '../stores/settingsStore.svelte.js';
+import { logger } from '../utils/logger.js';
+import { DEFAULT_API_TIMEOUT_MS } from '../config/constants.js';
 /**
  * API error with additional context
  */
@@ -71,7 +72,7 @@ export class EnhancedFlowDropApiClient {
         const method = options.method ?? getEndpointMethod(this.config, endpointKey);
         const configHeaders = getEndpointHeaders(this.config, endpointKey);
         // Get user settings for timeout and retry
-        const userApiSettings = get(apiSettings);
+        const userApiSettings = getApiSettings();
         // Get auth headers from provider
         const authHeaders = await this.authProvider.getAuthHeaders();
         // Merge headers: config headers < auth headers < request-specific headers
@@ -82,7 +83,7 @@ export class EnhancedFlowDropApiClient {
         };
         // Create AbortController for timeout
         const controller = new AbortController();
-        const timeoutMs = userApiSettings.timeout ?? this.config.timeout ?? 30000;
+        const timeoutMs = userApiSettings.timeout ?? this.config.timeout ?? DEFAULT_API_TIMEOUT_MS;
         const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
         const fetchConfig = {
             method,
@@ -142,7 +143,7 @@ export class EnhancedFlowDropApiClient {
                         timeout: true
                     });
                     // Don't retry on timeout - it's a client-side timeout
-                    console.error(`API request timed out after ${timeoutMs}ms:`, lastError);
+                    logger.error(`API request timed out after ${timeoutMs}ms:`, lastError);
                     throw lastError;
                 }
                 // If it's already an ApiError, preserve it
@@ -156,7 +157,7 @@ export class EnhancedFlowDropApiClient {
                 if ((lastError instanceof ApiError &&
                     (lastError.status === 401 || lastError.status === 403)) ||
                     attempt === maxAttempts) {
-                    console.error(`API request failed after ${attempt} attempts:`, lastError);
+                    logger.error(`API request failed after ${attempt} attempts:`, lastError);
                     throw lastError;
                 }
                 // Wait before retry with exponential backoff