@d34dman/flowdrop 0.0.15 → 0.0.17

package/README.md

@@ -14,6 +14,14 @@ A visual workflow editor component library built with Svelte 5 and @xyflow/svelt
 - **TypeScript Support**: Full type definitions included
 - **Docker Ready**: Production-ready Dockerfile and Docker Compose configuration
 
+### Enterprise Features (v0.0.16+)
+
+- **Pluggable Authentication**: AuthProvider interface for OAuth, JWT, SSO integration
+- **Workflow Lifecycle Events**: Hooks for save, load, change, and unmount events
+- **Dirty State Tracking**: Monitor unsaved changes with reactive stores
+- **Draft Auto-Save**: Automatic localStorage drafts with configurable intervals
+- **Feature Flags**: Customize behavior for security and UX requirements
+
 ## 📦 Installation
 
 ```bash
@@ -117,6 +125,52 @@ const editor = mountWorkflowEditor(container, {
 editor.destroy();
 ```
 
+#### 3. Enterprise Integration (v0.0.16+)
+
+```javascript
+import { mountFlowDropApp, createEndpointConfig, CallbackAuthProvider } from '@d34dman/flowdrop';
+
+const app = await mountFlowDropApp(container, {
+	workflow: myWorkflow,
+	endpointConfig: createEndpointConfig('/api/flowdrop'),
+
+	// Dynamic authentication with token refresh
+	authProvider: new CallbackAuthProvider({
+		getToken: () => authService.getAccessToken(),
+		onUnauthorized: () => authService.refreshToken()
+	}),
+
+	// Workflow lifecycle hooks
+	eventHandlers: {
+		onDirtyStateChange: (isDirty) => updateSaveButton(isDirty),
+		onAfterSave: (workflow) => showSuccess('Saved!'),
+		onBeforeUnmount: (workflow, isDirty) => {
+			if (isDirty) saveDraft(workflow);
+		}
+	},
+
+	// Feature configuration
+	features: {
+		autoSaveDraft: true,
+		autoSaveDraftInterval: 30000,
+		showToasts: true
+	}
+});
+
+// Access instance methods
+if (app.isDirty()) {
+	await app.save();
+}
+
+// Get current workflow data
+const workflow = app.getWorkflow();
+
+// Cleanup
+app.destroy();
+```
+
+See the [Enterprise Integration Guide](./docs/enterprise-integration.md) for React, Vue, Angular, and Drupal examples.
+
 #### 3. Integration with Backend Frameworks
 
 ##### Drupal Example
@@ -313,6 +367,13 @@ npm run format
 - **CHANGELOG.md** - Version history
 - **Storybook** - Component documentation (run `npm run storybook`)
 
+### Enterprise Features (v0.0.16+)
+
+- **[Enterprise Integration Guide](./docs/enterprise-integration.md)** - Complete integration patterns for React, Vue, Angular, Drupal
+- **[Authentication Guide](./docs/authentication-guide.md)** - OAuth, JWT, SSO, and custom auth providers
+- **[Event Handlers](./docs/event-handlers.md)** - Workflow lifecycle events and hooks
+- **[Features Configuration](./docs/features-configuration.md)** - Feature flags, draft auto-save, and customization
+
 ## 🤝 Contributing
 
 Not accepting contributions until the library stabilizes. Stay tuned.
@@ -347,6 +408,7 @@ docker-compose up -d
 ### Environment Variables
 
 **Production (Runtime):**
+
 - `FLOWDROP_API_BASE_URL` - Backend API URL
 - `FLOWDROP_THEME` - UI theme (light/dark/auto)
 - `FLOWDROP_TIMEOUT` - Request timeout in milliseconds
@@ -354,6 +416,7 @@ docker-compose up -d
 - `FLOWDROP_AUTH_TOKEN` - Authentication token
 
 **Development (Build-time):**
+
 - `VITE_API_BASE_URL` - Dev API URL (used only during `npm run dev`)
 
 ### Build for Production
@@ -371,7 +434,7 @@ node build
 ```
 
 For detailed deployment instructions, see:
-- [DEPLOYMENT.md](./DEPLOYMENT.md) - Complete deployment guide
+
 - [DOCKER.md](./DOCKER.md) - Docker quick start
 
 ---

package/dist/api/enhanced-client.d.ts

@@ -1,44 +1,160 @@
 /**
  * Enhanced API Client for FlowDrop
- * Uses configurable endpoints for all API actions
+ *
+ * Uses configurable endpoints and supports pluggable authentication providers.
+ *
+ * @module api/enhanced-client
  */
 import type { NodeMetadata, Workflow, ExecutionResult } from '../types/index.js';
 import type { EndpointConfig } from '../config/endpoints.js';
+import type { AuthProvider } from '../types/auth.js';
+/**
+ * API error with additional context
+ */
+export declare class ApiError extends Error {
+    /** HTTP status code */
+    readonly status: number;
+    /** Original error data from API */
+    readonly errorData: Record<string, unknown>;
+    /** Operation that was being performed */
+    readonly operation: string;
+    constructor(message: string, status: number, operation: string, errorData?: Record<string, unknown>);
+}
 /**
  * Enhanced HTTP API client for FlowDrop with configurable endpoints
+ *
+ * Supports pluggable authentication via AuthProvider interface.
+ *
+ * @example
+ * ```typescript
+ * // With AuthProvider
+ * const client = new EnhancedFlowDropApiClient(config, authProvider);
+ *
+ * // Backward compatible (uses config.auth)
+ * const client = new EnhancedFlowDropApiClient(config);
+ * ```
  */
 export declare class EnhancedFlowDropApiClient {
     private config;
-    constructor(config: EndpointConfig);
+    private authProvider;
     /**
-     * Make HTTP request with error handling and retry logic
+     * Create a new EnhancedFlowDropApiClient
+     *
+     * @param config - Endpoint configuration
+     * @param authProvider - Optional authentication provider (if not provided, uses config.auth)
+     */
+    constructor(config: EndpointConfig, authProvider?: AuthProvider);
+    /**
+     * Make HTTP request with error handling, retry logic, and auth support
+     *
+     * @param endpointKey - Key identifying the endpoint (for method/header lookup)
+     * @param endpointPath - The endpoint path template
+     * @param params - URL parameters to substitute
+     * @param options - Additional fetch options
+     * @param operation - Description of the operation (for error messages)
      */
     private request;
+    /**
+     * Update the auth provider
+     *
+     * Useful for updating auth after token refresh in parent application.
+     * Note: Per specification, this should rarely be needed as auth is typically
+     * set at mount time and requires remount to change.
+     *
+     * @param authProvider - New authentication provider
+     */
+    setAuthProvider(authProvider: AuthProvider): void;
+    /**
+     * Get current auth provider
+     *
+     * @returns The current AuthProvider instance
+     */
+    getAuthProvider(): AuthProvider;
+    /**
+     * Fetch all available node types
+     */
     getAvailableNodes(): Promise<NodeMetadata[]>;
+    /**
+     * Fetch nodes filtered by category
+     */
     getNodesByCategory(category: string): Promise<NodeMetadata[]>;
+    /**
+     * Fetch metadata for a specific node type
+     */
     getNodeMetadata(nodeId: string): Promise<NodeMetadata>;
+    /**
+     * Save a new 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>;
+    /**
+     * Validate a workflow
+     */
     validateWorkflow(workflow: Workflow): Promise<{
         valid: boolean;
         errors: string[];
     }>;
+    /**
+     * Export a workflow as JSON string
+     */
     exportWorkflow(workflowId: string): Promise<string>;
+    /**
+     * Import a workflow from JSON
+     */
     importWorkflow(workflowJson: string): Promise<Workflow>;
+    /**
+     * Execute a workflow
+     */
     executeWorkflow(workflowId: string, inputs?: Record<string, unknown>): Promise<ExecutionResult>;
+    /**
+     * Get execution status
+     */
     getExecutionStatus(executionId: string): Promise<ExecutionResult>;
+    /**
+     * Cancel a running execution
+     */
     cancelExecution(executionId: string): Promise<void>;
+    /**
+     * Get execution logs
+     */
     getExecutionLogs(executionId: string): Promise<string[]>;
+    /**
+     * List available templates
+     */
     listTemplates(): Promise<Workflow[]>;
+    /**
+     * Get a template by ID
+     */
     getTemplate(templateId: string): Promise<Workflow>;
+    /**
+     * Get system health status
+     */
     getSystemHealth(): Promise<{
         status: string;
         timestamp: number;
     }>;
+    /**
+     * Get system configuration
+     */
     getSystemConfig(): Promise<Record<string, unknown>>;
+    /**
+     * Get system version information
+     */
     getSystemVersion(): Promise<{
         version: string;
         build: string;