@flowdrop/flowdrop 1.0.0

package/dist/services/settingsService.js

@@ -0,0 +1,196 @@
+/**
+ * Settings Service for FlowDrop
+ *
+ * Provides API operations for user preferences/settings using the
+ * configurable endpoint system. Integrates with settingsStore for
+ * hybrid localStorage + API persistence.
+ *
+ * @module services/settingsService
+ */
+import { buildEndpointUrl, getEndpointHeaders } from '../config/endpoints.js';
+// =========================================================================
+// Configuration
+// =========================================================================
+/**
+ * Endpoint configuration reference
+ */
+let endpointConfig = null;
+/**
+ * Set the endpoint configuration for settings API calls
+ *
+ * @param config - Endpoint configuration
+ */
+export function setSettingsEndpointConfig(config) {
+    endpointConfig = config;
+}
+/**
+ * Get the current endpoint configuration
+ *
+ * @returns Current endpoint configuration or null
+ */
+export function getSettingsEndpointConfig() {
+    return endpointConfig;
+}
+// =========================================================================
+// API Request Helper
+// =========================================================================
+/**
+ * Make an API request for settings operations
+ *
+ * @param endpointKey - Key for headers lookup
+ * @param endpointPath - Path to the endpoint
+ * @param options - Additional fetch options
+ * @returns Parsed response data
+ */
+async function settingsRequest(endpointKey, endpointPath, options = {}) {
+    if (!endpointConfig) {
+        throw new Error('Endpoint configuration not set. Call setSettingsEndpointConfig() first.');
+    }
+    const url = buildEndpointUrl(endpointConfig, endpointPath);
+    const headers = getEndpointHeaders(endpointConfig, endpointKey);
+    const response = await fetch(url, {
+        headers,
+        ...options
+    });
+    // Check if response is JSON
+    const contentType = response.headers.get('content-type');
+    const isJson = contentType?.includes('application/json');
+    if (!response.ok) {
+        let errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+        if (isJson) {
+            try {
+                const data = (await response.json());
+                errorMessage = data.error ?? data.message ?? errorMessage;
+            }
+            catch {
+                // Failed to parse JSON, use default error message
+            }
+        }
+        throw new Error(errorMessage);
+    }
+    // Parse successful response
+    const data = (await response.json());
+    return data;
+}
+// =========================================================================
+// Settings API Methods
+// =========================================================================
+/**
+ * Settings API namespace
+ */
+export const settingsApi = {
+    /**
+     * Get user preferences from the backend
+     *
+     * @returns User's saved preferences
+     */
+    async getPreferences() {
+        if (!endpointConfig) {
+            throw new Error('Endpoint configuration not set');
+        }
+        const response = await settingsRequest('users.preferences', endpointConfig.endpoints.users.preferences, { method: 'GET' });
+        if (!response.success || !response.data) {
+            throw new Error(typeof response.error === 'string' ? response.error : 'Failed to fetch user preferences');
+        }
+        return response.data;
+    },
+    /**
+     * Save user preferences to the backend
+     *
+     * @param settings - Complete settings to save
+     */
+    async savePreferences(settings) {
+        if (!endpointConfig) {
+            throw new Error('Endpoint configuration not set');
+        }
+        const response = await settingsRequest('users.preferences', endpointConfig.endpoints.users.preferences, {
+            method: 'PUT',
+            body: JSON.stringify(settings)
+        });
+        if (!response.success) {
+            throw new Error(typeof response.error === 'string' ? response.error : 'Failed to save user preferences');
+        }
+    },
+    /**
+     * Partially update user preferences
+     *
+     * @param partial - Partial settings to merge
+     */
+    async patchPreferences(partial) {
+        if (!endpointConfig) {
+            throw new Error('Endpoint configuration not set');
+        }
+        const response = await settingsRequest('users.preferences', endpointConfig.endpoints.users.preferences, {
+            method: 'PATCH',
+            body: JSON.stringify(partial)
+        });
+        if (!response.success || !response.data) {
+            throw new Error(typeof response.error === 'string' ? response.error : 'Failed to update user preferences');
+        }
+        return response.data;
+    }
+};
+// =========================================================================
+// Settings Service Class (for settingsStore integration)
+// =========================================================================
+/**
+ * Settings service class for integration with settingsStore
+ *
+ * @example
+ * ```typescript
+ * import { SettingsService } from "@flowdrop/flowdrop";
+ * import { setSettingsService } from "@flowdrop/flowdrop";
+ *
+ * const service = new SettingsService(endpointConfig);
+ * setSettingsService(service);
+ * ```
+ */
+export class SettingsService {
+    config;
+    /**
+     * Create a new settings service instance
+     *
+     * @param config - Endpoint configuration
+     */
+    constructor(config) {
+        this.config = config;
+        // Also set the module-level config
+        setSettingsEndpointConfig(config);
+    }
+    /**
+     * Get user preferences from the backend
+     *
+     * @returns User's saved preferences
+     */
+    async getPreferences() {
+        return settingsApi.getPreferences();
+    }
+    /**
+     * Save user preferences to the backend
+     *
+     * @param settings - Complete settings to save
+     */
+    async savePreferences(settings) {
+        return settingsApi.savePreferences(settings);
+    }
+    /**
+     * Partially update user preferences
+     *
+     * @param partial - Partial settings to merge
+     */
+    async patchPreferences(partial) {
+        return settingsApi.patchPreferences(partial);
+    }
+}
+// =========================================================================
+// Factory Function
+// =========================================================================
+/**
+ * Create a settings service instance
+ *
+ * @param config - Endpoint configuration
+ * @returns SettingsService instance
+ */
+export function createSettingsService(config) {
+    return new SettingsService(config);
+}

package/dist/services/toastService.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Toast Service
+ * Centralized toast notification service using svelte-french-toast
+ * Provides consistent toast notifications across the FlowDrop application
+ */
+import { type DefaultToastOptions } from 'svelte-5-french-toast';
+/**
+ * Default toast options themed with FlowDrop design tokens.
+ * Use with <Toaster toastOptions={flowdropToastOptions} containerClassName="flowdrop-toaster" />
+ * and import '@flowdrop/flowdrop/styles/toast.css' (or app toast.css) so toast bar styles apply.
+ */
+export declare const flowdropToastOptions: DefaultToastOptions;
+/** Container class for FlowDrop-themed Toaster (used with toast.css). */
+export declare const FLOWDROP_TOASTER_CLASS = "flowdrop-toaster";
+/**
+ * Toast notification types
+ */
+export type ToastType = 'success' | 'error' | 'warning' | 'info' | 'loading';
+/**
+ * Toast configuration options
+ */
+export interface ToastOptions {
+    duration?: number;
+    position?: 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+}
+/**
+ * Show a success toast notification
+ */
+export declare function showSuccess(message: string, options?: ToastOptions): string;
+/**
+ * Show an error toast notification
+ */
+export declare function showError(message: string, options?: ToastOptions): string;
+/**
+ * Show a warning toast notification
+ */
+export declare function showWarning(message: string, options?: ToastOptions): string;
+/**
+ * Show an info toast notification
+ */
+export declare function showInfo(message: string, options?: ToastOptions): string;
+/**
+ * Show a loading toast notification
+ */
+export declare function showLoading(message: string, options?: ToastOptions): string;
+/**
+ * Dismiss a specific toast by ID
+ */
+export declare function dismissToast(toastId: string): void;
+/**
+ * Dismiss all toasts
+ */
+export declare function dismissAllToasts(): void;
+/**
+ * Show a promise-based toast (loading -> success/error)
+ */
+export declare function showPromise<T>(promise: Promise<T>, { loading, success, error, options }: {
+    loading: string;
+    success: string | ((data: T) => string);
+    error: string | ((error: unknown) => string);
+    options?: ToastOptions;
+}): Promise<T>;
+/**
+ * Show a confirmation toast (simplified version without action buttons)
+ */
+export declare function showConfirmation(message: string, options?: ToastOptions): string;
+/**
+ * API-specific toast helpers
+ */
+export declare const apiToasts: {
+    /**
+     * Show API success message
+     */
+    success: (operation: string, details?: string) => string;
+    /**
+     * Show API error message
+     */
+    error: (operation: string, error: string | Error) => string;
+    /**
+     * Show API loading message
+     */
+    loading: (operation: string) => string;
+    /**
+     * Show API promise with automatic success/error handling
+     */
+    promise: <T>(promise: Promise<T>, operation: string, options?: {
+        successMessage?: string;
+        errorMessage?: string;
+    }) => Promise<T>;
+};
+/**
+ * Workflow-specific toast helpers
+ */
+export declare const workflowToasts: {
+    /**
+     * Show workflow save success
+     */
+    saved: (workflowName?: string) => string;
+    /**
+     * Show workflow save error
+     */
+    saveError: (error: string | Error) => string;
+    /**
+     * Show workflow delete success
+     */
+    deleted: (workflowName?: string) => string;
+    /**
+     * Show workflow delete error
+     */
+    deleteError: (error: string | Error) => string;
+    /**
+     * Show workflow execution started
+     */
+    executionStarted: (workflowName?: string) => string;
+    /**
+     * Show workflow execution completed
+     */
+    executionCompleted: (workflowName?: string) => string;
+    /**
+     * Show workflow export success
+     */
+    exported: (workflowName?: string) => string;
+    /**
+     * Show workflow execution error
+     */
+    executionError: (error: string | Error) => string;
+};
+/**
+ * Pipeline-specific toast helpers
+ */
+export declare const pipelineToasts: {
+    /**
+     * Show pipeline creation success
+     */
+    created: (pipelineName?: string) => string;
+    /**
+     * Show pipeline creation error
+     */
+    creationError: (error: string | Error) => string;
+    /**
+     * Show pipeline execution started
+     */
+    executionStarted: (pipelineId: string) => string;
+    /**
+     * Show pipeline execution completed
+     */
+    executionCompleted: (pipelineId: string) => string;
+    /**
+     * Show pipeline execution error
+     */
+    executionError: (pipelineId: string, error: string | Error) => string;
+    /**
+     * Show pipeline status update
+     */
+    statusUpdate: (pipelineId: string, status: string) => string;
+};

package/dist/services/toastService.js

@@ -0,0 +1,265 @@
+/**
+ * Toast Service
+ * Centralized toast notification service using svelte-french-toast
+ * Provides consistent toast notifications across the FlowDrop application
+ */
+import { toast } from 'svelte-5-french-toast';
+import { TOAST_DURATION } from '../config/constants.js';
+/**
+ * Default toast options themed with FlowDrop design tokens.
+ * Use with <Toaster toastOptions={flowdropToastOptions} containerClassName="flowdrop-toaster" />
+ * and import '@flowdrop/flowdrop/styles/toast.css' (or app toast.css) so toast bar styles apply.
+ */
+export const flowdropToastOptions = {
+    className: 'flowdrop-toast-bar',
+    style: '',
+    success: {
+        iconTheme: {
+            primary: 'var(--fd-success)',
+            secondary: 'var(--fd-success-foreground)'
+        }
+    },
+    error: {
+        iconTheme: {
+            primary: 'var(--fd-error)',
+            secondary: 'var(--fd-error-foreground)'
+        }
+    },
+    loading: {
+        iconTheme: {
+            primary: 'var(--fd-primary)',
+            secondary: 'var(--fd-primary-muted)'
+        }
+    }
+};
+/** Container class for FlowDrop-themed Toaster (used with toast.css). */
+export const FLOWDROP_TOASTER_CLASS = 'flowdrop-toaster';
+/**
+ * Show a success toast notification
+ */
+export function showSuccess(message, options) {
+    return toast.success(message, {
+        duration: options?.duration || TOAST_DURATION.SUCCESS,
+        position: options?.position || 'bottom-center'
+    });
+}
+/**
+ * Show an error toast notification
+ */
+export function showError(message, options) {
+    return toast.error(message, {
+        duration: options?.duration || TOAST_DURATION.ERROR,
+        position: options?.position || 'bottom-center'
+    });
+}
+/**
+ * Show a warning toast notification
+ */
+export function showWarning(message, options) {
+    return toast.error(message, {
+        duration: options?.duration || TOAST_DURATION.WARNING,
+        position: options?.position || 'bottom-center'
+    });
+}
+/**
+ * Show an info toast notification
+ */
+export function showInfo(message, options) {
+    return toast.success(message, {
+        duration: options?.duration || TOAST_DURATION.INFO,
+        position: options?.position || 'bottom-center'
+    });
+}
+/**
+ * Show a loading toast notification
+ */
+export function showLoading(message, options) {
+    return toast.loading(message, {
+        duration: options?.duration || Infinity,
+        position: options?.position || 'bottom-center'
+    });
+}
+/**
+ * Dismiss a specific toast by ID
+ */
+export function dismissToast(toastId) {
+    toast.dismiss(toastId);
+}
+/**
+ * Dismiss all toasts
+ */
+export function dismissAllToasts() {
+    toast.dismiss();
+}
+/**
+ * Show a promise-based toast (loading -> success/error)
+ */
+export function showPromise(promise, { loading, success, error, options }) {
+    return toast.promise(promise, {
+        loading,
+        success,
+        error,
+        ...options
+    });
+}
+/**
+ * Show a confirmation toast (simplified version without action buttons)
+ */
+export function showConfirmation(message, options) {
+    return toast(message, {
+        duration: options?.duration || TOAST_DURATION.CONFIRMATION,
+        position: options?.position || 'bottom-center'
+    });
+}
+/**
+ * API-specific toast helpers
+ */
+export const apiToasts = {
+    /**
+     * Show API success message
+     */
+    success: (operation, details) => {
+        const message = details ? `${operation}: ${details}` : operation;
+        return showSuccess(message);
+    },
+    /**
+     * Show API error message
+     */
+    error: (operation, error) => {
+        const errorMessage = error instanceof Error ? error.message : error;
+        return showError(`${operation} failed: ${errorMessage}`);
+    },
+    /**
+     * Show API loading message
+     */
+    loading: (operation) => {
+        return showLoading(`${operation}...`);
+    },
+    /**
+     * Show API promise with automatic success/error handling
+     */
+    promise: (promise, operation, options) => {
+        return showPromise(promise, {
+            loading: `${operation}...`,
+            success: options?.successMessage || `${operation} completed successfully`,
+            error: options?.errorMessage || `${operation} failed`
+        });
+    }
+};
+/**
+ * Workflow-specific toast helpers
+ */
+export const workflowToasts = {
+    /**
+     * Show workflow save success
+     */
+    saved: (workflowName) => {
+        const message = workflowName
+            ? `Workflow "${workflowName}" saved successfully`
+            : 'Workflow saved successfully';
+        return showSuccess(message);
+    },
+    /**
+     * Show workflow save error
+     */
+    saveError: (error) => {
+        const errorMessage = error instanceof Error ? error.message : error;
+        return showError(`Failed to save workflow: ${errorMessage}`);
+    },
+    /**
+     * Show workflow delete success
+     */
+    deleted: (workflowName) => {
+        const message = workflowName
+            ? `Workflow "${workflowName}" deleted successfully`
+            : 'Workflow deleted successfully';
+        return showSuccess(message);
+    },
+    /**
+     * Show workflow delete error
+     */
+    deleteError: (error) => {
+        const errorMessage = error instanceof Error ? error.message : error;
+        return showError(`Failed to delete workflow: ${errorMessage}`);
+    },
+    /**
+     * Show workflow execution started
+     */
+    executionStarted: (workflowName) => {
+        const message = workflowName
+            ? `Workflow "${workflowName}" execution started`
+            : 'Workflow execution started';
+        return showInfo(message);
+    },
+    /**
+     * Show workflow execution completed
+     */
+    executionCompleted: (workflowName) => {
+        const message = workflowName
+            ? `Workflow "${workflowName}" execution completed`
+            : 'Workflow execution completed';
+        return showSuccess(message);
+    },
+    /**
+     * Show workflow export success
+     */
+    exported: (workflowName) => {
+        const message = workflowName
+            ? `Workflow "${workflowName}" exported successfully`
+            : 'Workflow exported successfully';
+        return showSuccess(message);
+    },
+    /**
+     * Show workflow execution error
+     */
+    executionError: (error) => {
+        const errorMessage = error instanceof Error ? error.message : error;
+        return showError(`Workflow execution failed: ${errorMessage}`);
+    }
+};
+/**
+ * Pipeline-specific toast helpers
+ */
+export const pipelineToasts = {
+    /**
+     * Show pipeline creation success
+     */
+    created: (pipelineName) => {
+        const message = pipelineName
+            ? `Pipeline "${pipelineName}" created successfully`
+            : 'Pipeline created successfully';
+        return showSuccess(message);
+    },
+    /**
+     * Show pipeline creation error
+     */
+    creationError: (error) => {
+        const errorMessage = error instanceof Error ? error.message : error;
+        return showError(`Failed to create pipeline: ${errorMessage}`);
+    },
+    /**
+     * Show pipeline execution started
+     */
+    executionStarted: (pipelineId) => {
+        return showInfo(`Pipeline ${pipelineId} execution started`);
+    },
+    /**
+     * Show pipeline execution completed
+     */
+    executionCompleted: (pipelineId) => {
+        return showSuccess(`Pipeline ${pipelineId} execution completed`);
+    },
+    /**
+     * Show pipeline execution error
+     */
+    executionError: (pipelineId, error) => {
+        const errorMessage = error instanceof Error ? error.message : error;
+        return showError(`Pipeline ${pipelineId} execution failed: ${errorMessage}`);
+    },
+    /**
+     * Show pipeline status update
+     */
+    statusUpdate: (pipelineId, status) => {
+        return showInfo(`Pipeline ${pipelineId} status: ${status}`);
+    }
+};