@d34dman/flowdrop 0.0.15 → 0.0.16

package/dist/components/App.svelte

@@ -17,24 +17,44 @@
 	import { sampleNodes } from '../data/samples.js';
 	import { createEndpointConfig } from '../config/endpoints.js';
 	import type { EndpointConfig } from '../config/endpoints.js';
-	import { workflowStore, workflowActions, workflowName } from '../stores/workflowStore.js';
+	import type { AuthProvider } from '../types/auth.js';
+	import type { FlowDropEventHandlers, FlowDropFeatures } from '../types/events.js';
+	import { mergeFeatures } from '../types/events.js';
+	import {
+		workflowStore,
+		workflowActions,
+		workflowName,
+		markAsSaved
+	} from '../stores/workflowStore.js';
 	import { apiToasts, dismissToast } from '../services/toastService.js';
 
-	// Configuration props for runtime customization
+	/**
+	 * Configuration props for runtime customization
+	 */
 	interface Props {
+		/** Initial workflow to load */
 		workflow?: Workflow;
+		/** Pre-loaded node types (if provided, skips API fetch) */
+		nodes?: NodeMetadata[];
+		/** Editor height */
 		height?: string | number;
+		/** Editor width */
 		width?: string | number;
+		/** Show the navbar */
 		showNavbar?: boolean;
-		// New configuration options for pipeline status mode
+		/** Disable the node sidebar */
 		disableSidebar?: boolean;
+		/** Lock the workflow (prevent changes) */
 		lockWorkflow?: boolean;
+		/** Read-only mode */
 		readOnly?: boolean;
+		/** Node execution statuses */
 		nodeStatuses?: Record<string, 'pending' | 'running' | 'completed' | 'error'>;
-		// Pipeline ID for fetching node execution info from jobs
+		/** Pipeline ID for fetching node execution info */
 		pipelineId?: string;
-		// Navbar customization
+		/** Custom navbar title */
 		navbarTitle?: string;
+		/** Custom navbar actions */
 		navbarActions?: Array<{
 			label: string;
 			href: string;
@@ -42,13 +62,21 @@
 			variant?: 'primary' | 'secondary' | 'outline';
 			onclick?: (event: Event) => void;
 		}>;
-		// API configuration - optional, defaults to '/api/flowdrop'
+		/** API base URL */
 		apiBaseUrl?: string;
+		/** Endpoint configuration */
 		endpointConfig?: EndpointConfig;
+		/** Authentication provider */
+		authProvider?: AuthProvider;
+		/** Event handlers */
+		eventHandlers?: FlowDropEventHandlers;
+		/** Feature configuration */
+		features?: FlowDropFeatures;
 	}
 
 	let {
 		workflow: initialWorkflow,
+		nodes: propNodes,
 		height = '100vh',
 		width = '100%',
 		showNavbar = false,
@@ -60,9 +88,15 @@
 		navbarTitle,
 		navbarActions = [],
 		apiBaseUrl,
-		endpointConfig: propEndpointConfig
+		endpointConfig: propEndpointConfig,
+		authProvider,
+		eventHandlers,
+		features: propFeatures
 	}: Props = $props();
 
+	// Merge features with defaults
+	const features = mergeFeatures(propFeatures);
+
 	// Create breadcrumb-style title - at top level to avoid store subscription issues
 	let breadcrumbTitle = $derived(() => {
 		// Use custom navbar title if provided
@@ -129,10 +163,19 @@
 
 	/**
 	 * Fetch node types from the server
+	 *
+	 * If propNodes is provided, uses those instead of fetching from API.
+	 * This fixes the bug where propNodes was ignored.
 	 */
 	async function fetchNodeTypes(): Promise<void> {
-		// Show loading toast
-		const loadingToast = apiToasts.loading('Loading node types');
+		// If nodes were provided as props, use them directly (skip API fetch)
+		if (propNodes && propNodes.length > 0) {
+			nodes = propNodes;
+			return;
+		}
+
+		// Show loading toast (if toasts are enabled)
+		const loadingToast = features.showToasts ? apiToasts.loading('Loading node types') : null;
 		try {
 			error = null;
 
@@ -142,13 +185,35 @@
 			error = null;
 
 			// Dismiss loading toast
-			dismissToast(loadingToast);
+			if (loadingToast) {
+				dismissToast(loadingToast);
+			}
 		} catch (err) {
 			// Dismiss loading toast and show error toast
-			dismissToast(loadingToast);
+			if (loadingToast) {
+				dismissToast(loadingToast);
+			}
+
+			const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+
+			// Notify parent via event handler
+			if (eventHandlers?.onApiError) {
+				const suppressToast = eventHandlers.onApiError(
+					err instanceof Error ? err : new Error(errorMessage),
+					'fetchNodes'
+				);
+				if (suppressToast) {
+					// Parent handled the error, don't show default toast
+					nodes = sampleNodes;
+					return;
+				}
+			}
+
 			// Show error but don't block the UI
-			error = `API Error: ${err instanceof Error ? err.message : 'Unknown error'}. Using sample data.`;
-			apiToasts.error('Load node types', err instanceof Error ? err.message : 'Unknown error');
+			error = `API Error: ${errorMessage}. Using sample data.`;
+			if (features.showToasts) {
+				apiToasts.error('Load node types', errorMessage);
+			}
 
 			// Fallback to sample data
 			nodes = sampleNodes;
@@ -283,27 +348,37 @@
 
 	/**
 	 * Save workflow - exposed API function
+	 *
+	 * Integrates with event handlers for enterprise customization.
 	 */
 	async function saveWorkflow(): Promise<void> {
 		// Wait for any pending DOM updates before saving
 		await tick();
 
-		// Show loading toast
-		const loadingToast = apiToasts.loading('Saving workflow');
+		// Use current workflow from global store
+		const workflowToSave = $workflowStore;
+
+		if (!workflowToSave) {
+			return;
+		}
+
+		// Call onBeforeSave if provided - allows cancellation
+		if (eventHandlers?.onBeforeSave) {
+			const shouldContinue = await eventHandlers.onBeforeSave(workflowToSave);
+			if (shouldContinue === false) {
+				// Save cancelled by event handler
+				return;
+			}
+		}
+
+		// Show loading toast (if enabled)
+		const loadingToast = features.showToasts ? apiToasts.loading('Saving workflow') : null;
 
 		try {
 			// Import necessary modules
 			const { workflowApi } = await import('../services/api.js');
 			const { v4: uuidv4 } = await import('uuid');
 
-			// Use current workflow from global store
-			const workflowToSave = $workflowStore;
-
-			if (!workflowToSave) {
-				dismissToast(loadingToast);
-				return;
-			}
-
 			// Determine the workflow ID
 			let workflowId: string;
 			if (workflowToSave.id) {
@@ -313,7 +388,7 @@
 			}
 
 			// Create workflow object for saving
-			const finalWorkflow = {
+			const finalWorkflow: Workflow = {
 				id: workflowId,
 				name: workflowToSave.name || 'Untitled Workflow',
 				description: workflowToSave.description || '',
@@ -342,14 +417,45 @@
 				});
 			}
 
+			// Mark as saved (clears dirty state)
+			markAsSaved();
+
 			// Dismiss loading toast and show success
-			dismissToast(loadingToast);
-			apiToasts.success('Save workflow', 'Workflow saved successfully');
+			if (loadingToast) {
+				dismissToast(loadingToast);
+			}
+			if (features.showToasts) {
+				apiToasts.success('Save workflow', 'Workflow saved successfully');
+			}
+
+			// Call onAfterSave if provided
+			if (eventHandlers?.onAfterSave) {
+				await eventHandlers.onAfterSave(savedWorkflow);
+			}
 		} catch (error) {
-			// Dismiss loading toast and show error
-			dismissToast(loadingToast);
-			const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-			apiToasts.error('Save workflow', errorMessage);
+			// Dismiss loading toast
+			if (loadingToast) {
+				dismissToast(loadingToast);
+			}
+
+			const errorObj = error instanceof Error ? error : new Error('Unknown error occurred');
+
+			// Call onSaveError if provided
+			if (eventHandlers?.onSaveError && workflowToSave) {
+				await eventHandlers.onSaveError(errorObj, workflowToSave);
+			}
+
+			// Check if parent wants to handle API errors
+			let suppressToast = false;
+			if (eventHandlers?.onApiError) {
+				suppressToast = eventHandlers.onApiError(errorObj, 'save') === true;
+			}
+
+			// Show error toast if not suppressed
+			if (features.showToasts && !suppressToast) {
+				apiToasts.error('Save workflow', errorObj.message);
+			}
+
 			throw error; // Re-throw to allow calling code to handle if needed
 		}
 	}
@@ -398,9 +504,7 @@
 
 	// Expose save and export functions globally for external access
 	if (typeof window !== 'undefined') {
-		// @ts-expect-error - Adding to window for external access
 		window.flowdropSave = saveWorkflow;
-		// @ts-expect-error - Adding to window for external access
 		window.flowdropExport = exportWorkflow;
 	}
 
@@ -425,6 +529,11 @@
 			// Initialize the workflow store if we have an initial workflow
 			if (initialWorkflow) {
 				workflowActions.initialize(initialWorkflow);
+
+				// Emit onWorkflowLoad event
+				if (eventHandlers?.onWorkflowLoad) {
+					eventHandlers.onWorkflowLoad(initialWorkflow);
+				}
 			}
 		})();
 
@@ -635,7 +744,10 @@
 									<div class="flowdrop-config-sidebar__detail">
 										<span class="flowdrop-config-sidebar__detail-label">Node ID:</span>
 										<div class="flowdrop-config-sidebar__detail-value-with-copy">
-											<span class="flowdrop-config-sidebar__detail-value" style="font-family: monospace;">
+											<span
+												class="flowdrop-config-sidebar__detail-value"
+												style="font-family: monospace;"
+											>
 												{selectedNodeForConfig().id}
 											</span>
 											<button

package/dist/components/App.svelte.d.ts

@@ -1,16 +1,34 @@
-import type { Workflow } from '../types/index.js';
+import type { NodeMetadata, Workflow } from '../types/index.js';
 import type { EndpointConfig } from '../config/endpoints.js';
+import type { AuthProvider } from '../types/auth.js';
+import type { FlowDropEventHandlers, FlowDropFeatures } from '../types/events.js';
+/**
+ * Configuration props for runtime customization
+ */
 interface Props {
+    /** Initial workflow to load */
     workflow?: Workflow;
+    /** Pre-loaded node types (if provided, skips API fetch) */
+    nodes?: NodeMetadata[];
+    /** Editor height */
     height?: string | number;
+    /** Editor width */
     width?: string | number;
+    /** Show the navbar */
     showNavbar?: boolean;
+    /** Disable the node sidebar */
     disableSidebar?: boolean;
+    /** Lock the workflow (prevent changes) */
     lockWorkflow?: boolean;
+    /** Read-only mode */
     readOnly?: boolean;
+    /** Node execution statuses */
     nodeStatuses?: Record<string, 'pending' | 'running' | 'completed' | 'error'>;
+    /** Pipeline ID for fetching node execution info */
     pipelineId?: string;
+    /** Custom navbar title */
     navbarTitle?: string;
+    /** Custom navbar actions */
     navbarActions?: Array<{
         label: string;
         href: string;
@@ -18,8 +36,16 @@ interface Props {
         variant?: 'primary' | 'secondary' | 'outline';
         onclick?: (event: Event) => void;
     }>;
+    /** API base URL */
     apiBaseUrl?: string;
+    /** Endpoint configuration */
     endpointConfig?: EndpointConfig;
+    /** Authentication provider */
+    authProvider?: AuthProvider;
+    /** Event handlers */
+    eventHandlers?: FlowDropEventHandlers;
+    /** Feature configuration */
+    features?: FlowDropFeatures;
 }
 declare const App: import("svelte").Component<Props, {}, "">;
 type App = ReturnType<typeof App>;

package/dist/data/samples.js

@@ -444,8 +444,8 @@ export const sampleNodes = [
                     type: 'string',
                     title: 'Model',
                     description: 'OpenAI model to use',
-                    default: 'gpt-3.5-turbo',
-                    enum: ['gpt-3.5-turbo', 'gpt-4', 'gpt-4-turbo']
+                    default: 'gpt-4o-mini',
+                    enum: ['gpt-4o-mini', 'gpt-5-chat-latest', 'gpt-4.1']
                 },
                 temperature: {
                     type: 'number',
@@ -2107,8 +2107,8 @@ export const sampleNodes = [
                     type: 'string',
                     title: 'Model',
                     description: 'Chat model to use',
-                    default: 'gpt-3.5-turbo',
-                    enum: ['gpt-3.5-turbo', 'gpt-4', 'claude-3-sonnet']
+                    default: 'gpt-4o-mini',
+                    enum: ['gpt-4o-mini', 'gpt-5-chat-latest', 'claude-3-sonnet']
                 },
                 temperature: {
                     type: 'number',
@@ -2601,8 +2601,8 @@ export const sampleNodes = [
                     type: 'string',
                     title: 'AI Model',
                     description: 'AI model to use for content analysis',
-                    default: 'gpt-4',
-                    enum: ['gpt-3.5-turbo', 'gpt-4', 'claude-3-sonnet', 'claude-3-haiku']
+                    default: 'gpt-5-chat-latest',
+                    enum: ['gpt-4o-mini', 'gpt-5-chat-latest', 'claude-3-sonnet', 'claude-3-haiku']
                 },
                 analysisType: {
                     type: 'string',
@@ -2725,8 +2725,8 @@ export const sampleNodes = [
                     type: 'string',
                     title: 'AI Model',
                     description: 'AI model to use for content editing',
-                    default: 'gpt-4',
-                    enum: ['gpt-3.5-turbo', 'gpt-4', 'claude-3-sonnet', 'claude-3-haiku']
+                    default: 'gpt-5-chat-latest',
+                    enum: ['gpt-4o-mini', 'gpt-5-chat-latest', 'claude-3-sonnet', 'claude-3-haiku']
                 },
                 editingStyle: {
                     type: 'string',
@@ -3184,7 +3184,7 @@ export const sampleWorkflow = {
             data: {
                 label: 'OpenAI',
                 config: {
-                    model: 'gpt-3.5-turbo',
+                    model: 'gpt-4o-mini',
                     temperature: 0.7,
                     maxTokens: 1000
                 },

package/dist/examples/adapter-usage.js

@@ -14,7 +14,7 @@ function createSimpleWorkflow() {
         placeholder: 'Enter your message'
     });
     const modelNode = adapter.addNode(workflow, 'openai', { x: 300, y: 100 }, {
-        model: 'gpt-4',
+        model: 'gpt-4o-mini',
         temperature: 0.7
     });
     const outputNode = adapter.addNode(workflow, 'text-output', { x: 500, y: 100 });

package/dist/index.d.ts

@@ -2,9 +2,13 @@
  * FlowDrop - Visual Workflow Editor Library
  * A Svelte 5 component library built on @xyflow/svelte for creating node-based workflow editors
  */
-import './styles/base.css';
-export type { NodeCategory, NodeDataType, NodePort, NodeMetadata, NodeConfig, WorkflowNode, WorkflowEdge, Workflow, ApiResponse, NodesResponse, WorkflowResponse, WorkflowsResponse, ExecutionStatus, ExecutionResult, FlowDropConfig, WorkflowEvents } from './types/index.js';
-export type { WorkflowEditorConfig, EditorFeatures, UIConfig, APIConfig, ExecutionConfig, StorageConfig, NodeType, WorkflowData, ExecutionResult as EditorExecutionResult, EditorState } from './types/config.js';
+import "./styles/base.css";
+export type { NodeCategory, NodeDataType, NodePort, NodeMetadata, NodeConfig, WorkflowNode, WorkflowEdge, Workflow, ApiResponse, NodesResponse, WorkflowResponse, WorkflowsResponse, ExecutionStatus, ExecutionResult, FlowDropConfig, WorkflowEvents } from "./types/index.js";
+export type { WorkflowEditorConfig, EditorFeatures, UIConfig, APIConfig, ExecutionConfig, StorageConfig, NodeType, WorkflowData, ExecutionResult as EditorExecutionResult, EditorState } from "./types/config.js";
+export type { AuthProvider, StaticAuthConfig, CallbackAuthConfig } from "./types/auth.js";
+export { StaticAuthProvider, CallbackAuthProvider, NoAuthProvider, createAuthProviderFromLegacyConfig } from "./types/auth.js";
+export type { WorkflowChangeType, FlowDropEventHandlers, FlowDropFeatures } from "./types/events.js";
+export { DEFAULT_FEATURES, mergeFeatures } from "./types/events.js";
 export { FlowDropApiClient } from './api/client.js';
 export { EnhancedFlowDropApiClient } from './api/enhanced-client.js';
 export { default as WorkflowEditor } from './components/WorkflowEditor.svelte';
@@ -45,9 +49,10 @@ export type { ToastType, ToastOptions } from './services/toastService.js';
 export { NodeExecutionService, nodeExecutionService } from './services/nodeExecutionService.js';
 export { saveWorkflow, updateWorkflow, getWorkflow, getWorkflows, deleteWorkflow, getWorkflowCount, initializeSampleWorkflows } from './services/workflowStorage.js';
 export { globalSaveWorkflow, globalExportWorkflow, initializeGlobalSave } from './services/globalSave.js';
-export { fetchPortConfig, validatePortConfig } from './services/portConfigApi.js';
+export { fetchPortConfig, validatePortConfig } from "./services/portConfigApi.js";
+export { getDraftStorageKey, saveDraft, loadDraft, deleteDraft, hasDraft, getDraftMetadata, DraftAutoSaveManager } from "./services/draftStorage.js";
 export { EdgeStylingHelper, NodeOperationsHelper, WorkflowOperationsHelper, ConfigurationHelper } from './helpers/workflowEditorHelper.js';
-export { workflowStore, workflowActions, workflowId, workflowName, workflowNodes, workflowEdges, workflowMetadata, workflowChanged, workflowValidation, workflowMetadataChanged } from './stores/workflowStore.js';
+export { workflowStore, workflowActions, workflowId, workflowName, workflowNodes, workflowEdges, workflowMetadata, workflowChanged, workflowValidation, workflowMetadataChanged, isDirtyStore, isDirty, markAsSaved, getWorkflow as getWorkflowFromStore, setOnDirtyStateChange, setOnWorkflowChange } from "./stores/workflowStore.js";
 export * from './config/endpoints.js';
 export { defaultApiConfig, getEndpointUrl } from './config/apiConfig.js';
 export type { ApiConfig } from './config/apiConfig.js';
@@ -55,4 +60,6 @@ export { DEFAULT_PORT_CONFIG } from './config/defaultPortConfig.js';
 export * from './config/runtimeConfig.js';
 export * from './adapters/WorkflowAdapter.js';
 export * from './clients/ApiClient.js';
-export { mountWorkflowEditor, unmountWorkflowEditor, mountFlowDropApp, unmountFlowDropApp } from './svelte-app.js';
+export { mountWorkflowEditor, unmountWorkflowEditor, mountFlowDropApp, unmountFlowDropApp } from "./svelte-app.js";
+export type { FlowDropMountOptions, MountedFlowDropApp, NavbarAction } from "./svelte-app.js";
+export { ApiError } from "./api/enhanced-client.js";

package/dist/index.js

@@ -3,7 +3,9 @@
  * A Svelte 5 component library built on @xyflow/svelte for creating node-based workflow editors
  */
 // Import CSS to ensure styles are included in the library build
-import './styles/base.css';
+import "./styles/base.css";
+export { StaticAuthProvider, CallbackAuthProvider, NoAuthProvider, createAuthProviderFromLegacyConfig } from "./types/auth.js";
+export { DEFAULT_FEATURES, mergeFeatures } from "./types/events.js";
 // Export API clients
 export { FlowDropApiClient } from './api/client.js';
 export { EnhancedFlowDropApiClient } from './api/enhanced-client.js';
@@ -47,11 +49,15 @@ export { showSuccess, showError, showWarning, showInfo, showLoading, dismissToas
 export { NodeExecutionService, nodeExecutionService } from './services/nodeExecutionService.js';
 export { saveWorkflow, updateWorkflow, getWorkflow, getWorkflows, deleteWorkflow, getWorkflowCount, initializeSampleWorkflows } from './services/workflowStorage.js';
 export { globalSaveWorkflow, globalExportWorkflow, initializeGlobalSave } from './services/globalSave.js';
-export { fetchPortConfig, validatePortConfig } from './services/portConfigApi.js';
+export { fetchPortConfig, validatePortConfig } from "./services/portConfigApi.js";
+// Export draft storage service
+export { getDraftStorageKey, saveDraft, loadDraft, deleteDraft, hasDraft, getDraftMetadata, DraftAutoSaveManager } from "./services/draftStorage.js";
 // Export helpers
 export { EdgeStylingHelper, NodeOperationsHelper, WorkflowOperationsHelper, ConfigurationHelper } from './helpers/workflowEditorHelper.js';
 // Export stores
-export { workflowStore, workflowActions, workflowId, workflowName, workflowNodes, workflowEdges, workflowMetadata, workflowChanged, workflowValidation, workflowMetadataChanged } from './stores/workflowStore.js';
+export { workflowStore, workflowActions, workflowId, workflowName, workflowNodes, workflowEdges, workflowMetadata, workflowChanged, workflowValidation, workflowMetadataChanged, 
+// Dirty state tracking
+isDirtyStore, isDirty, markAsSaved, getWorkflow as getWorkflowFromStore, setOnDirtyStateChange, setOnWorkflowChange } from "./stores/workflowStore.js";
 // Export endpoint configuration
 export * from './config/endpoints.js';
 export { defaultApiConfig, getEndpointUrl } from './config/apiConfig.js';
@@ -62,4 +68,6 @@ export * from './adapters/WorkflowAdapter.js';
 // Export API client
 export * from './clients/ApiClient.js';
 // Export Svelte app wrapper for framework integration
-export { mountWorkflowEditor, unmountWorkflowEditor, mountFlowDropApp, unmountFlowDropApp } from './svelte-app.js';
+export { mountWorkflowEditor, unmountWorkflowEditor, mountFlowDropApp, unmountFlowDropApp } from "./svelte-app.js";
+// Export API error class
+export { ApiError } from "./api/enhanced-client.js";

package/dist/services/draftStorage.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Draft Storage Service for FlowDrop
+ *
+ * Handles saving and loading workflow drafts to/from localStorage.
+ * Provides interval-based auto-save functionality.
+ *
+ * @module services/draftStorage
+ */
+import type { Workflow } from "../types/index.js";
+/**
+ * Draft metadata stored alongside the workflow
+ */
+interface DraftMetadata {
+    /** Timestamp when the draft was saved */
+    savedAt: string;
+    /** Workflow ID (if available) */
+    workflowId?: string;
+    /** Workflow name */
+    workflowName?: string;
+}
+/**
+ * Complete draft data stored in localStorage
+ */
+interface StoredDraft {
+    /** The workflow data */
+    workflow: Workflow;
+    /** Draft metadata */
+    metadata: DraftMetadata;
+}
+/**
+ * Generate a storage key for a workflow
+ *
+ * If a custom key is provided, use it directly.
+ * Otherwise, generate based on workflow ID or use "new" for unsaved workflows.
+ *
+ * @param workflowId - The workflow ID (optional)
+ * @param customKey - Custom storage key provided by enterprise (optional)
+ * @returns The storage key to use
+ */
+export declare function getDraftStorageKey(workflowId?: string, customKey?: string): string;
+/**
+ * Save a workflow draft to localStorage
+ *
+ * @param workflow - The workflow to save
+ * @param storageKey - The storage key to use
+ * @returns true if saved successfully, false otherwise
+ */
+export declare function saveDraft(workflow: Workflow, storageKey: string): boolean;
+/**
+ * Load a workflow draft from localStorage
+ *
+ * @param storageKey - The storage key to load from
+ * @returns The stored draft, or null if not found
+ */
+export declare function loadDraft(storageKey: string): StoredDraft | null;
+/**
+ * Delete a workflow draft from localStorage
+ *
+ * @param storageKey - The storage key to delete
+ */
+export declare function deleteDraft(storageKey: string): void;
+/**
+ * Check if a draft exists for a given storage key
+ *
+ * @param storageKey - The storage key to check
+ * @returns true if a draft exists
+ */
+export declare function hasDraft(storageKey: string): boolean;
+/**
+ * Get draft metadata without loading the full workflow
+ *
+ * Useful for displaying draft information without parsing the entire workflow.
+ *
+ * @param storageKey - The storage key to check
+ * @returns Draft metadata, or null if not found
+ */
+export declare function getDraftMetadata(storageKey: string): DraftMetadata | null;
+/**
+ * Draft auto-save manager
+ *
+ * Handles interval-based auto-saving of workflow drafts.
+ * Should be instantiated per FlowDrop instance.
+ */
+export declare class DraftAutoSaveManager {
+    /** Interval timer ID */
+    private intervalId;
+    /** Storage key for drafts */
+    private storageKey;
+    /** Auto-save interval in milliseconds */
+    private interval;
+    /** Whether auto-save is enabled */
+    private enabled;
+    /** Function to get current workflow */
+    private getWorkflow;
+    /** Function to check if workflow is dirty */
+    private isDirty;
+    /** Last saved workflow hash (for change detection) */
+    private lastSavedHash;
+    /**
+     * Create a new DraftAutoSaveManager
+     *
+     * @param options - Configuration options
+     */
+    constructor(options: {
+        storageKey: string;
+        interval: number;
+        enabled: boolean;
+        getWorkflow: () => Workflow | null;
+        isDirty: () => boolean;
+    });
+    /**
+     * Start auto-save interval
+     *
+     * Will save drafts at the configured interval if there are unsaved changes.
+     */
+    start(): void;
+    /**
+     * Stop auto-save interval
+     */
+    stop(): void;
+    /**
+     * Save draft if there are unsaved changes
+     *
+     * @returns true if a draft was saved
+     */
+    saveIfDirty(): boolean;
+    /**
+     * Force save the current workflow as a draft
+     *
+     * Saves regardless of dirty state.
+     *
+     * @returns true if saved successfully
+     */
+    forceSave(): boolean;
+    /**
+     * Clear the draft from storage
+     */
+    clearDraft(): void;
+    /**
+     * Mark the current state as saved
+     *
+     * Updates the hash so the next saveIfDirty won't save unless there are new changes.
+     */
+    markAsSaved(): void;
+    /**
+     * Update the storage key
+     *
+     * Useful when the workflow ID changes (e.g., after first save).
+     *
+     * @param newKey - The new storage key
+     */
+    updateStorageKey(newKey: string): void;
+    /**
+     * Simple hash function for change detection
+     *
+     * Not cryptographically secure, just for detecting changes.
+     *
+     * @param workflow - The workflow to hash
+     * @returns A simple hash string
+     */
+    private hashWorkflow;
+    /**
+     * Check if auto-save is currently running
+     */
+    isRunning(): boolean;
+    /**
+     * Get the current storage key
+     */
+    getStorageKey(): string;
+}
+export {};