@d34dman/flowdrop 0.0.43 → 0.0.44

package/dist/services/settingsService.js

@@ -0,0 +1,202 @@
+/**
+ * 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 "@d34dman/flowdrop";
+ * import { setSettingsService } from "@d34dman/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

@@ -3,6 +3,15 @@
  * 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 '@d34dman/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
  */

package/dist/services/toastService.js

@@ -3,7 +3,36 @@
  * 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 } from "svelte-5-french-toast";
+/**
+ * Default toast options themed with FlowDrop design tokens.
+ * Use with <Toaster toastOptions={flowdropToastOptions} containerClassName="flowdrop-toaster" />
+ * and import '@d34dman/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
  */

package/dist/stores/settingsStore.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Settings Store for FlowDrop
+ *
+ * Provides unified state management for all user-configurable settings with:
+ * - Hybrid persistence (localStorage primary, optional API sync)
+ * - Category-specific derived stores for performance
+ * - Deep merge support for partial updates
+ * - Theme system compatibility (backward compatible with themeStore)
+ *
+ * @module stores/settingsStore
+ */
+import type { FlowDropSettings, ThemeSettings, EditorSettings, UISettings, BehaviorSettings, ApiSettings, PartialSettings, SyncStatus, ResolvedTheme, ThemePreference, SettingsChangeCallback, SettingsCategory } from "../types/settings.js";
+/**
+ * Main settings store (read-only access to current settings)
+ */
+export declare const settingsStore: import("svelte/store").Readable<FlowDropSettings>;
+/**
+ * Sync status store for UI indicators
+ */
+export declare const syncStatusStore: import("svelte/store").Readable<{
+    status: SyncStatus;
+    lastSyncedAt: number;
+    error: string;
+}>;
+/**
+ * Theme settings store
+ */
+export declare const themeSettings: import("svelte/store").Readable<ThemeSettings>;
+/**
+ * Editor settings store
+ */
+export declare const editorSettings: import("svelte/store").Readable<EditorSettings>;
+/**
+ * UI settings store
+ */
+export declare const uiSettings: import("svelte/store").Readable<UISettings>;
+/**
+ * Behavior settings store
+ */
+export declare const behaviorSettings: import("svelte/store").Readable<BehaviorSettings>;
+/**
+ * API settings store
+ */
+export declare const apiSettings: import("svelte/store").Readable<ApiSettings>;
+/**
+ * Theme preference store (backward compatible with themeStore)
+ */
+export declare const theme: import("svelte/store").Readable<ThemePreference>;
+/**
+ * Resolved theme store
+ * Always returns the actual theme being applied ('light' or 'dark')
+ */
+export declare const resolvedTheme: import("svelte/store").Readable<ResolvedTheme>;
+/**
+ * Update settings with partial values
+ *
+ * @param partial - Partial settings to merge
+ */
+export declare function updateSettings(partial: PartialSettings): void;
+/**
+ * Reset settings to defaults
+ *
+ * @param categories - Optional categories to reset (all if not specified)
+ */
+export declare function resetSettings(categories?: SettingsCategory[]): void;
+/**
+ * Get current settings synchronously
+ */
+export declare function getSettings(): FlowDropSettings;
+/**
+ * Set the theme preference
+ *
+ * @param newTheme - The new theme preference ('light', 'dark', or 'auto')
+ */
+export declare function setTheme(newTheme: ThemePreference): void;
+/**
+ * Toggle between light and dark themes
+ * If currently 'auto', switches to the opposite of system preference
+ */
+export declare function toggleTheme(): void;
+/**
+ * Cycle through theme options: light -> dark -> auto -> light
+ */
+export declare function cycleTheme(): void;
+/**
+ * Initialize the theme system
+ * Should be called once on app startup
+ */
+export declare function initializeTheme(): void;
+/**
+ * Set the settings service for API operations
+ *
+ * @param service - Settings service instance
+ */
+export declare function setSettingsService(service: {
+    savePreferences: (settings: FlowDropSettings) => Promise<void>;
+    getPreferences: () => Promise<FlowDropSettings>;
+} | null): void;
+/**
+ * Sync current settings to the backend API
+ *
+ * @returns Promise that resolves when sync is complete
+ */
+export declare function syncSettingsToApi(): Promise<void>;
+/**
+ * Load settings from the backend API
+ *
+ * @returns Promise that resolves when load is complete
+ */
+export declare function loadSettingsFromApi(): Promise<void>;
+/**
+ * Subscribe to settings changes
+ *
+ * @param callback - Function to call when settings change
+ * @returns Unsubscribe function
+ */
+export declare function onSettingsChange(callback: SettingsChangeCallback): () => void;
+/**
+ * Initialize the settings system
+ *
+ * @param options - Initialization options
+ */
+export declare function initializeSettings(options?: {
+    /** Custom default settings to merge */
+    defaults?: PartialSettings;
+    /** Enable API sync on initialization */
+    apiSync?: boolean;
+}): Promise<void>;