@happyvertical/smrt-svelte 0.30.0

package/dist/state/app-state.d.ts

@@ -0,0 +1,308 @@
+/**
+ * App state types and initial state
+ *
+ * Framework-agnostic state shape - Svelte bindings are in app-state.svelte.ts
+ */
+import type { User } from '@happyvertical/smrt-types';
+import type { BrowserAICapabilities, DownloadProgressInfo, InitState, LLMAdapter, STTAdapter, TTSAdapter } from '../browser-ai/index.js';
+export type { User } from '@happyvertical/smrt-types';
+/**
+ * App mode determines which features are enabled
+ * - 'default': Standard components, no AI features
+ * - 'smrt': AI-enhanced features enabled
+ */
+export type AppMode = 'default' | 'smrt';
+/**
+ * How the current mode was determined
+ */
+export type ModeSource = 'explicit' | 'auto' | 'toggled';
+/**
+ * User preferences for AI features
+ */
+export interface UserPreferences {
+    /** Preferred STT backend */
+    preferredSTT?: 'browser-speech' | 'whisper-cpp' | 'whisper-wasm';
+    /** Preferred LLM backend */
+    preferredLLM?: 'webllm' | 'transformers-llm';
+    /** Default LLM model */
+    defaultLLMModel?: string;
+    /** Auto-enable smrt mode when available */
+    autoEnableSmrt?: boolean;
+}
+/**
+ * When to preload AI models
+ *
+ * - 'none': Don't preload, initialize on first use
+ * - 'eager': Preload immediately when SmrtProvider mounts
+ * - 'idle': Preload during browser idle time (requestIdleCallback)
+ * - 'on-visible': Preload when a SMRT component becomes visible
+ */
+export type AIPreloadStrategy = 'none' | 'eager' | 'idle' | 'on-visible';
+/**
+ * STT adapter configuration
+ */
+export interface STTConfig {
+    /** Which STT backend to use */
+    type: 'browser-speech' | 'whisper-cpp' | 'whisper-wasm';
+    /** Whisper model to use (for whisper-cpp/whisper-wasm) */
+    model?: string;
+    /** Whether to enable this adapter */
+    enabled?: boolean;
+    /**
+     * Allow loading models from local /models/ path.
+     * When false (default), models load from HuggingFace Hub CDN.
+     */
+    allowLocalModels?: boolean;
+}
+/**
+ * TTS adapter configuration
+ */
+export interface TTSConfig {
+    /** Which TTS backend to use */
+    type: 'browser-synthesis';
+    /** Preferred voice name */
+    voice?: string;
+    /** Whether to enable this adapter */
+    enabled?: boolean;
+}
+/**
+ * LLM adapter configuration
+ */
+export interface LLMConfig {
+    /** Which LLM backend to use */
+    type: 'webllm' | 'transformers-llm';
+    /** Model to load */
+    model?: string;
+    /** Whether to enable this adapter */
+    enabled?: boolean;
+}
+/**
+ * Complete AI configuration for SmrtProvider.
+ *
+ * Configures preloading strategy and which AI adapters to initialize.
+ * Uses a warm client cache to persist adapters across navigation.
+ *
+ * @example
+ * ```svelte
+ * <SmrtProvider
+ *   ai={{
+ *     preload: 'idle',
+ *     stt: { type: 'whisper-cpp', model: 'tiny.en' },
+ *     tts: { type: 'browser-synthesis' },
+ *     llm: { type: 'webllm', model: 'Llama-3.1-8B-Instruct' },
+ *     showLoadingOverlay: true,
+ *     loadingMessage: 'Preparing AI...'
+ *   }}
+ * >
+ * ```
+ */
+export interface AIConfig {
+    /**
+     * When to preload models.
+     * - 'none': Don't preload, initialize on first use
+     * - 'eager': Preload immediately when SmrtProvider mounts
+     * - 'idle': Preload during browser idle time (recommended)
+     * - 'on-visible': Preload when a SMRT AI component becomes visible
+     * @default 'idle'
+     */
+    preload?: AIPreloadStrategy;
+    /** STT (Speech-to-Text) configuration */
+    stt?: STTConfig;
+    /** TTS (Text-to-Speech) configuration */
+    tts?: TTSConfig;
+    /** LLM (Large Language Model) configuration */
+    llm?: LLMConfig;
+    /**
+     * Show a loading overlay while models download.
+     * The overlay shows progress and can be dismissed.
+     * @default true
+     */
+    showLoadingOverlay?: boolean;
+    /** Custom message to show in the loading overlay */
+    loadingMessage?: string;
+}
+/**
+ * Overall AI loading state for the loading overlay
+ */
+export type AILoadingPhase = 'idle' | 'checking' | 'downloading' | 'initializing' | 'ready' | 'error';
+/**
+ * AI loading state details
+ */
+export interface AILoadingState {
+    /** Current loading phase */
+    phase: AILoadingPhase;
+    /** What's currently loading (e.g., 'whisper-cpp', 'webllm') */
+    currentAdapter: string | null;
+    /** Overall progress percentage (0-100) */
+    overallProgress: number;
+    /** Human-readable status message */
+    message: string;
+    /** Adapters that have been loaded */
+    loaded: string[];
+    /** Adapters that failed to load */
+    failed: string[];
+    /** Error if phase is 'error' */
+    error: Error | null;
+}
+/**
+ * User session information
+ */
+export interface UserSession {
+    /** The smrt-users User object (null if not authenticated) */
+    user: User | null;
+    /** Whether user is authenticated (derived from user !== null) */
+    isAuthenticated: boolean;
+    /** Resolved permissions (from PermissionResolver) */
+    permissions: string[];
+    /** User preferences for AI features */
+    preferences: UserPreferences;
+}
+/**
+ * STT adapter state
+ */
+export interface STTState {
+    /** The adapter instance */
+    adapter: STTAdapter | null;
+    /** Initialization state */
+    initState: InitState;
+    /** Download progress if initializing */
+    downloadProgress: DownloadProgressInfo | null;
+    /** Whether currently listening */
+    isListening: boolean;
+    /** Last final transcribed text */
+    lastResult: string;
+    /** Current interim result (updates during speech) */
+    interimResult: string;
+    /** Last error */
+    error: Error | null;
+}
+/**
+ * TTS adapter state
+ */
+export interface TTSState {
+    /** The adapter instance */
+    adapter: TTSAdapter | null;
+    /** Initialization state */
+    initState: InitState;
+    /** Download progress if initializing */
+    downloadProgress: DownloadProgressInfo | null;
+    /** Whether currently speaking */
+    isSpeaking: boolean;
+    /** Whether paused */
+    isPaused: boolean;
+    /** Last error */
+    error: Error | null;
+}
+/**
+ * LLM adapter state
+ */
+export interface LLMState {
+    /** The adapter instance */
+    adapter: LLMAdapter | null;
+    /** Initialization state */
+    initState: InitState;
+    /** Download progress if initializing */
+    downloadProgress: DownloadProgressInfo | null;
+    /** Currently loaded model */
+    currentModel: string | null;
+    /** Whether currently generating */
+    isGenerating: boolean;
+    /** Last error */
+    error: Error | null;
+}
+/**
+ * All AI adapter states
+ */
+export interface AIState {
+    stt: STTState;
+    tts: TTSState;
+    llm: LLMState;
+}
+/**
+ * WebSocket connection status
+ */
+export type SocketStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/**
+ * WebSocket reconnection settings
+ */
+export interface SocketReconnectConfig {
+    /** Whether to automatically reconnect on disconnect (default: true) */
+    enabled?: boolean;
+    /** Maximum number of reconnection attempts (default: 5) */
+    maxAttempts?: number;
+    /** Base delay in ms for exponential backoff (default: 1000) */
+    baseDelay?: number;
+}
+/**
+ * WebSocket configuration
+ */
+export interface SocketConfig {
+    /** WebSocket URL (wss:// or ws://) */
+    url: string;
+    /** Reconnection settings */
+    reconnect?: SocketReconnectConfig;
+    /** Called when connection opens */
+    onOpen?: () => void;
+    /** Called when a message is received */
+    onMessage?: (data: unknown) => void;
+    /** Called when connection closes */
+    onClose?: (event: CloseEvent) => void;
+    /** Called on connection error */
+    onError?: (event: Event) => void;
+}
+/**
+ * WebSocket connection state
+ */
+export interface SocketState {
+    /** Current connection status */
+    status: SocketStatus;
+    /** Number of reconnection attempts made */
+    reconnectAttempts: number;
+    /** Last connection error */
+    lastError: Event | null;
+}
+/**
+ * Complete app state shape
+ */
+export interface SmrtAppState {
+    /** Current app mode */
+    mode: AppMode;
+    /** How mode was determined */
+    modeSource: ModeSource;
+    /** User session */
+    session: UserSession;
+    /** Detected browser capabilities */
+    capabilities: BrowserAICapabilities | null;
+    /** AI adapter states */
+    ai: AIState;
+    /** AI loading state (for preload/overlay) */
+    aiLoading: AILoadingState;
+    /** WebSocket connection state */
+    socket: SocketState;
+    /** Global error */
+    error: Error | null;
+    /** Whether state has been initialized */
+    initialized: boolean;
+}
+/**
+ * Create initial app state
+ */
+export declare function createInitialState(): SmrtAppState;
+/**
+ * Options for creating app state
+ */
+export interface CreateAppStateOptions {
+    /** Initial mode (overrides auto-detection) */
+    initialMode?: AppMode;
+    /** Initial session data */
+    session?: Partial<UserSession>;
+    /** AI preloading and warm client configuration */
+    ai?: AIConfig;
+    /** Callback when capabilities are detected */
+    onCapabilitiesDetected?: (caps: BrowserAICapabilities) => void;
+    /** Callback when mode changes */
+    onModeChange?: (mode: AppMode, source: ModeSource) => void;
+    /** Callback when AI loading state changes */
+    onAILoadingChange?: (state: AILoadingState) => void;
+}
+//# sourceMappingURL=app-state.d.ts.map

package/dist/state/app-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.d.ts","sourceRoot":"","sources":["../../src/state/app-state.ts"],"names":[],"mappings":"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"}

package/dist/state/app-state.js

@@ -0,0 +1,64 @@
+/**
+ * App state types and initial state
+ *
+ * Framework-agnostic state shape - Svelte bindings are in app-state.svelte.ts
+ */
+/**
+ * Create initial app state
+ */
+export function createInitialState() {
+    return {
+        mode: 'default',
+        modeSource: 'auto',
+        session: {
+            user: null,
+            isAuthenticated: false,
+            permissions: [],
+            preferences: {},
+        },
+        capabilities: null,
+        ai: {
+            stt: {
+                adapter: null,
+                initState: 'uninitialized',
+                downloadProgress: null,
+                isListening: false,
+                lastResult: '',
+                interimResult: '',
+                error: null,
+            },
+            tts: {
+                adapter: null,
+                initState: 'uninitialized',
+                downloadProgress: null,
+                isSpeaking: false,
+                isPaused: false,
+                error: null,
+            },
+            llm: {
+                adapter: null,
+                initState: 'uninitialized',
+                downloadProgress: null,
+                currentModel: null,
+                isGenerating: false,
+                error: null,
+            },
+        },
+        aiLoading: {
+            phase: 'idle',
+            currentAdapter: null,
+            overallProgress: 0,
+            message: '',
+            loaded: [],
+            failed: [],
+            error: null,
+        },
+        socket: {
+            status: 'disconnected',
+            reconnectAttempts: 0,
+            lastError: null,
+        },
+        error: null,
+        initialized: false,
+    };
+}

package/dist/state/app-state.svelte.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Svelte 5 reactive app state
+ *
+ * Uses runes ($state, $derived) for reactivity.
+ * This is the Svelte-specific binding layer on top of app-state.ts
+ */
+import { type GetLLMOptions, type GetSTTOptions, type GetTTSOptions, type LLMAdapter, type STTAdapter, type TTSAdapter, type TTSOptions } from '../browser-ai/index.js';
+import { type AIConfig, type AILoadingState, type AppMode, type CreateAppStateOptions, type ModeSource, type SmrtAppState, type SocketConfig, type User, type UserSession } from './app-state.js';
+/**
+ * Reactive app state manager for Svelte 5
+ */
+export declare class SmrtAppStateManager {
+    private _state;
+    private options;
+    private _aiConfig;
+    private _preloadScheduled;
+    private _idleCallbackId;
+    private _socket;
+    private _socketConfig;
+    private _reconnectTimeout;
+    private _subscribedSTTAdapters;
+    private _subscribedTTSAdapters;
+    constructor(options?: CreateAppStateOptions);
+    /**
+     * Get the current socket configuration (for reconnection)
+     */
+    get socketConfig(): SocketConfig | null;
+    /**
+     * Get the current state (readonly)
+     */
+    get state(): Readonly<SmrtAppState>;
+    /**
+     * Get the current AI configuration
+     */
+    get aiConfig(): AIConfig | null;
+    /**
+     * Get the current AI loading state
+     */
+    get aiLoading(): Readonly<AILoadingState>;
+    /**
+     * Initialize the app state
+     * Detects capabilities and sets initial mode
+     * Note: This is a no-op during SSR as browser-ai requires browser environment
+     */
+    initialize(): Promise<void>;
+    /**
+     * Set or update AI configuration
+     */
+    setAIConfig(config: AIConfig): void;
+    /**
+     * Schedule preloading based on the configured strategy
+     */
+    private schedulePreload;
+    /**
+     * Trigger preloading (called by components for 'on-visible' strategy)
+     */
+    triggerPreload(): void;
+    /**
+     * Execute the preloading of configured adapters
+     */
+    private executePreload;
+    /**
+     * Update the AI loading state
+     */
+    private updateLoadingState;
+    /**
+     * Set the app mode
+     */
+    setMode(mode: AppMode, source?: ModeSource): void;
+    /**
+     * Toggle between default and smrt modes
+     */
+    toggleMode(): void;
+    /**
+     * Update user session
+     */
+    updateSession(session: Partial<UserSession>): void;
+    /**
+     * Set user permissions
+     */
+    setPermissions(permissions: string[]): void;
+    /**
+     * Check if user has a permission
+     */
+    hasPermission(permission: string): boolean;
+    /**
+     * Check if user has all permissions
+     */
+    hasAllPermissions(permissions: string[]): boolean;
+    /**
+     * Check if user has any of the permissions
+     */
+    hasAnyPermission(permissions: string[]): boolean;
+    /**
+     * Set the current user and permissions
+     * Called by SmrtProvider when user prop changes
+     */
+    setUser(user: User | null, permissions?: string[]): void;
+    /**
+     * Connect to a WebSocket server
+     */
+    connectSocket(config: SocketConfig): void;
+    /**
+     * Disconnect from the WebSocket server
+     */
+    disconnectSocket(): void;
+    /**
+     * Send a message through the WebSocket
+     */
+    sendMessage(data: unknown): void;
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     */
+    private scheduleReconnect;
+    /**
+     * Initialize STT adapter
+     * Uses warm client cache to avoid re-downloading models
+     */
+    initializeSTT(options?: GetSTTOptions): Promise<STTAdapter>;
+    /**
+     * Subscribe to STT adapter events
+     * Only subscribes once per adapter instance to prevent duplicate listeners
+     */
+    private subscribeToSTTEvents;
+    /**
+     * Start STT listening
+     */
+    startListening(options?: Parameters<STTAdapter['start']>[0]): Promise<void>;
+    /**
+     * Stop STT listening
+     */
+    stopListening(): Promise<void>;
+    /**
+     * Initialize TTS adapter
+     * Uses warm client cache to avoid re-initialization
+     */
+    initializeTTS(options?: GetTTSOptions): Promise<TTSAdapter>;
+    /**
+     * Subscribe to TTS adapter events
+     * Only subscribes once per adapter instance to prevent duplicate listeners
+     */
+    private subscribeToTTSEvents;
+    /**
+     * Speak text using TTS
+     */
+    speak(text: string, options?: TTSOptions): Promise<void>;
+    /**
+     * Stop TTS speech
+     */
+    stopSpeaking(): void;
+    /**
+     * Pause TTS speech
+     */
+    pauseSpeaking(): void;
+    /**
+     * Resume TTS speech
+     */
+    resumeSpeaking(): void;
+    /**
+     * Get available TTS voices
+     */
+    getTTSVoices(): import("../browser-ai/index.js").TTSVoice[];
+    /**
+     * Initialize LLM adapter
+     * Uses warm client cache to avoid re-downloading models
+     */
+    initializeLLM(modelId?: string, options?: GetLLMOptions): Promise<LLMAdapter>;
+    /**
+     * Send a message to the LLM
+     */
+    chat(text: string, options?: {
+        systemPrompt?: string;
+        onToken?: (token: string) => void;
+    }): Promise<string>;
+    /**
+     * Unload LLM model to free memory
+     */
+    unloadLLM(): Promise<void>;
+    /**
+     * Dispose of all resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Check if AI is ready to use (all configured adapters loaded)
+     */
+    get isAIReady(): boolean;
+    /**
+     * Check if AI is currently loading
+     */
+    get isAILoading(): boolean;
+}
+/**
+ * Create a new reactive app state manager
+ */
+export declare function createAppState(options?: CreateAppStateOptions): SmrtAppStateManager;
+//# sourceMappingURL=app-state.svelte.d.ts.map

package/dist/state/app-state.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.svelte.d.ts","sourceRoot":"","sources":["../../src/state/app-state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAIlB,KAAK,UAAU,EAEf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAE1B,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,IAAI,EACT,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAiBxB;;GAEG;AACH,qBAAa,mBAAmB;IAE9B,OAAO,CAAC,MAAM,CAA8C;IAG5D,OAAO,CAAC,OAAO,CAAwB;IAGvC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAuB;IAG9C,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,iBAAiB,CAA8C;IAGvE,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,sBAAsB,CAA6B;gBAE/C,OAAO,GAAE,qBAA0B;IAK/C;;OAEG;IACH,IAAI,YAAY,IAAI,YAAY,GAAG,IAAI,CAEtC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC,CAElC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAE9B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,cAAc,CAAC,CAExC;IAED;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CjC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAiBnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,cAAc,IAAI,IAAI;IAQtB;;OAEG;YACW,cAAc;IAsG5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,UAAsB,GAAG,IAAI;IAmB5D;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAOlD;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IAI3C;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO;IAMjD;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO;IAMhD;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,IAAI;IAQ5D;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IA+CzC;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAexB;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAQhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;;OAGG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAoEjE;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAoC5B;;OAEG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;;OAGG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAuDjE;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,aAAa,IAAI,IAAI;IAOrB;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;OAEG;IACH,YAAY;IAMZ;;;OAGG;IACG,aAAa,CACjB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,UAAU,CAAC;IAoEtB;;OAEG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACrE,OAAO,CAAC,MAAM,CAAC;IAgBlB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAKvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAMzB;CACF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,mBAAmB,CAErB"}