@framers/sql-storage-adapter 0.4.2 → 0.5.1

package/dist/adapters/electron/recovery/walCheckpoint.js

@@ -0,0 +1,302 @@
+/**
+ * WAL (Write-Ahead Logging) Checkpoint Manager.
+ *
+ * Manages SQLite WAL checkpointing for optimal performance and
+ * data durability. Handles automatic and manual checkpointing
+ * with configurable strategies.
+ *
+ * ## WAL Mode Benefits
+ * - Better concurrency (readers don't block writers)
+ * - Faster write performance
+ * - Atomic commits
+ *
+ * ## Checkpoint Strategies
+ * - PASSIVE: Non-blocking, best for background checkpointing
+ * - FULL: Blocks until complete, ensures WAL is cleared
+ * - RESTART: Blocks and restarts WAL, minimizes WAL growth
+ * - TRUNCATE: Most aggressive, truncates WAL file
+ *
+ * @example
+ * ```typescript
+ * const manager = new WalCheckpointManager(adapter, {
+ *   checkpointInterval: 300000,
+ *   strategy: 'PASSIVE',
+ *   maxWalSize: 50 * 1024 * 1024, // 50MB
+ * });
+ *
+ * await manager.start();
+ * ```
+ */
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    checkpointInterval: 300000, // 5 minutes
+    strategy: 'PASSIVE',
+    maxWalSize: 50 * 1024 * 1024, // 50MB
+    pageSize: 4096,
+    autoCheckpointPages: 1000,
+    synchronous: 'NORMAL',
+    verbose: false,
+};
+// ============================================================================
+// WAL Checkpoint Manager
+// ============================================================================
+/**
+ * WAL Checkpoint Manager.
+ *
+ * Manages automatic and manual WAL checkpointing for SQLite databases.
+ * Ensures optimal performance and data durability.
+ */
+export class WalCheckpointManager {
+    constructor(adapter, config = {}) {
+        this.adapter = adapter;
+        this.checkpointTimer = null;
+        this.lastCheckpoint = null;
+        this.totalCheckpoints = 0;
+        this.isRunning = false;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // ============================================================================
+    // Lifecycle Methods
+    // ============================================================================
+    /**
+     * Start the checkpoint manager.
+     */
+    async start() {
+        if (this.isRunning) {
+            this.log('Already running');
+            return;
+        }
+        // Configure WAL mode
+        await this.configureWalMode();
+        // Start periodic checkpointing
+        this.startCheckpointTimer();
+        this.isRunning = true;
+        this.log('WAL Checkpoint Manager started');
+    }
+    /**
+     * Stop the checkpoint manager.
+     */
+    async stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        // Stop timer
+        this.stopCheckpointTimer();
+        // Final checkpoint before stopping
+        try {
+            await this.checkpoint('FULL');
+        }
+        catch (error) {
+            this.log(`Final checkpoint failed: ${error}`);
+        }
+        this.isRunning = false;
+        this.log('WAL Checkpoint Manager stopped');
+    }
+    // ============================================================================
+    // WAL Configuration
+    // ============================================================================
+    /**
+     * Configure WAL mode on the database.
+     */
+    async configureWalMode() {
+        const pragmas = [
+            'PRAGMA journal_mode = WAL',
+            `PRAGMA synchronous = ${this.config.synchronous}`,
+            `PRAGMA wal_autocheckpoint = ${this.config.autoCheckpointPages}`,
+            `PRAGMA page_size = ${this.config.pageSize}`,
+        ];
+        for (const pragma of pragmas) {
+            await this.adapter.exec(pragma);
+        }
+        this.log('WAL mode configured');
+    }
+    /**
+     * Disable WAL mode and switch back to DELETE journal mode.
+     */
+    async disableWalMode() {
+        // First, checkpoint everything
+        await this.checkpoint('TRUNCATE');
+        // Switch to DELETE mode
+        await this.adapter.exec('PRAGMA journal_mode = DELETE');
+        this.log('WAL mode disabled');
+    }
+    // ============================================================================
+    // Checkpoint Operations
+    // ============================================================================
+    /**
+     * Perform a WAL checkpoint.
+     *
+     * @param strategy - Checkpoint strategy (defaults to config strategy)
+     * @returns Checkpoint result
+     */
+    async checkpoint(strategy) {
+        const effectiveStrategy = strategy ?? this.config.strategy;
+        const startTime = Date.now();
+        try {
+            // Get WAL status before checkpoint
+            const walBefore = await this.getWalFrameCount();
+            // Execute checkpoint
+            const result = await this.adapter.get(`PRAGMA wal_checkpoint(${effectiveStrategy})`);
+            // Get WAL status after checkpoint
+            const walAfter = await this.getWalFrameCount();
+            const checkpointResult = {
+                success: true,
+                strategy: effectiveStrategy,
+                walFramesBefore: walBefore,
+                walFramesAfter: walAfter,
+                framesCheckpointed: result?.checkpointed ?? 0,
+                busyFrames: result?.busy ?? 0,
+                durationMs: Date.now() - startTime,
+                timestamp: Date.now(),
+            };
+            this.lastCheckpoint = Date.now();
+            this.totalCheckpoints++;
+            this.log(`Checkpoint completed: ${checkpointResult.framesCheckpointed} frames ` +
+                `(${effectiveStrategy}, ${checkpointResult.durationMs}ms)`);
+            return checkpointResult;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.log(`Checkpoint failed: ${errorMessage}`);
+            return {
+                success: false,
+                strategy: effectiveStrategy,
+                walFramesBefore: 0,
+                walFramesAfter: 0,
+                framesCheckpointed: 0,
+                busyFrames: 0,
+                durationMs: Date.now() - startTime,
+                timestamp: Date.now(),
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Force a full checkpoint that clears the WAL.
+     */
+    async forceFullCheckpoint() {
+        return this.checkpoint('TRUNCATE');
+    }
+    // ============================================================================
+    // Timer Management
+    // ============================================================================
+    /**
+     * Start the automatic checkpoint timer.
+     */
+    startCheckpointTimer() {
+        if (this.checkpointTimer) {
+            clearInterval(this.checkpointTimer);
+        }
+        this.checkpointTimer = setInterval(async () => {
+            try {
+                // Check if WAL has grown too large
+                const walSize = await this.getWalSize();
+                const strategy = walSize > this.config.maxWalSize ? 'FULL' : this.config.strategy;
+                await this.checkpoint(strategy);
+            }
+            catch (error) {
+                this.log(`Periodic checkpoint failed: ${error}`);
+            }
+        }, this.config.checkpointInterval);
+    }
+    /**
+     * Stop the automatic checkpoint timer.
+     */
+    stopCheckpointTimer() {
+        if (this.checkpointTimer) {
+            clearInterval(this.checkpointTimer);
+            this.checkpointTimer = null;
+        }
+    }
+    // ============================================================================
+    // Status & Monitoring
+    // ============================================================================
+    /**
+     * Get current WAL status.
+     */
+    async getStatus() {
+        const journalMode = await this.adapter.get('PRAGMA journal_mode');
+        const walFrames = await this.getWalFrameCount();
+        const autoCheckpoint = await this.adapter.get('PRAGMA wal_autocheckpoint');
+        return {
+            enabled: journalMode?.journal_mode?.toLowerCase() === 'wal',
+            walSize: walFrames * this.config.pageSize,
+            walPages: walFrames,
+            lastCheckpoint: this.lastCheckpoint,
+            totalCheckpoints: this.totalCheckpoints,
+            autoCheckpointThreshold: autoCheckpoint?.wal_autocheckpoint ?? this.config.autoCheckpointPages,
+        };
+    }
+    /**
+     * Get current WAL size in bytes.
+     */
+    async getWalSize() {
+        const frames = await this.getWalFrameCount();
+        return frames * this.config.pageSize;
+    }
+    /**
+     * Get current WAL frame count.
+     */
+    async getWalFrameCount() {
+        // PRAGMA wal_checkpoint returns (busy, log, checkpointed)
+        // log is the total number of frames in the WAL file
+        const result = await this.adapter.get('PRAGMA wal_checkpoint(PASSIVE)');
+        return result?.log ?? 0;
+    }
+    /**
+     * Check if WAL mode is currently enabled.
+     */
+    async isWalEnabled() {
+        const result = await this.adapter.get('PRAGMA journal_mode');
+        return result?.journal_mode?.toLowerCase() === 'wal';
+    }
+    // ============================================================================
+    // Utilities
+    // ============================================================================
+    /**
+     * Get checkpoint statistics.
+     */
+    getStats() {
+        return {
+            totalCheckpoints: this.totalCheckpoints,
+            lastCheckpoint: this.lastCheckpoint,
+            isRunning: this.isRunning,
+            checkpointInterval: this.config.checkpointInterval,
+            strategy: this.config.strategy,
+        };
+    }
+    /**
+     * Update checkpoint configuration at runtime.
+     */
+    updateConfig(newConfig) {
+        Object.assign(this.config, newConfig);
+        // Restart timer if interval changed and running
+        if (this.isRunning && newConfig.checkpointInterval !== undefined) {
+            this.startCheckpointTimer();
+        }
+    }
+    /**
+     * Log a message if verbose mode is enabled.
+     */
+    log(message) {
+        if (this.config.verbose) {
+            console.log(`[WalCheckpointManager] ${message}`);
+        }
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a WAL Checkpoint Manager.
+ *
+ * @param adapter - Storage adapter to manage
+ * @param config - Checkpoint configuration
+ * @returns WalCheckpointManager instance
+ */
+export function createWalCheckpointManager(adapter, config = {}) {
+    return new WalCheckpointManager(adapter, config);
+}
+//# sourceMappingURL=walCheckpoint.js.map

package/dist/adapters/electron/recovery/walCheckpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walCheckpoint.js","sourceRoot":"","sources":["../../../../src/adapters/electron/recovery/walCheckpoint.ts"],"names":[],"mappings":"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"}

package/dist/adapters/electron/window/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Window Management Module for Electron SQL Storage Adapter.
+ *
+ * Provides multi-window coordination and change broadcasting.
+ *
+ * @packageDocumentation
+ */
+export { WindowManager, createWindowManager, type WindowManagerConfig, type WindowManagerCallbacks, type RegisteredWindow, } from './windowManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/electron/window/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/electron/window/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/adapters/electron/window/index.js

@@ -0,0 +1,9 @@
+/**
+ * Window Management Module for Electron SQL Storage Adapter.
+ *
+ * Provides multi-window coordination and change broadcasting.
+ *
+ * @packageDocumentation
+ */
+export { WindowManager, createWindowManager, } from './windowManager.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/electron/window/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/electron/window/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,GAIpB,MAAM,iBAAiB,CAAC"}

package/dist/adapters/electron/window/windowManager.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Multi-Window Manager for Electron SQL Storage Adapter.
+ *
+ * Coordinates database access across multiple Electron windows.
+ * Broadcasts database changes to all windows and manages
+ * window-specific state.
+ *
+ * ## Features
+ * - Change broadcasting to all windows
+ * - Window registration and tracking
+ * - Focused window optimization
+ * - Connection state synchronization
+ *
+ * @example
+ * ```typescript
+ * const manager = new WindowManager({
+ *   broadcastChanges: true,
+ *   trackFocusedWindow: true,
+ * });
+ *
+ * manager.initialize();
+ *
+ * // Register a window
+ * manager.registerWindow(mainWindow);
+ *
+ * // Broadcast a change
+ * manager.broadcastChange({
+ *   type: 'insert',
+ *   tables: ['users'],
+ *   changes: 1,
+ * });
+ * ```
+ */
+import { BrowserWindow } from 'electron';
+import type { DbChangeEvent } from '../ipc/types';
+/**
+ * Window registration info.
+ */
+export interface RegisteredWindow {
+    /** Window ID */
+    id: number;
+    /** Window name/label */
+    name?: string;
+    /** Whether the window is currently focused */
+    isFocused: boolean;
+    /** When the window was registered */
+    registeredAt: number;
+    /** Last activity timestamp */
+    lastActivityAt: number;
+    /** Whether the window is subscribed to changes */
+    subscribedToChanges: boolean;
+}
+/**
+ * Window manager configuration.
+ */
+export interface WindowManagerConfig {
+    /** Broadcast changes to all windows (default: true) */
+    broadcastChanges?: boolean;
+    /** Track focused window for optimizations (default: true) */
+    trackFocusedWindow?: boolean;
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+    /** Exclude windows by name from broadcasts */
+    excludeWindows?: string[];
+}
+/**
+ * Window manager event callbacks.
+ */
+export interface WindowManagerCallbacks {
+    /** Called when a window is registered */
+    onWindowRegistered?: (window: RegisteredWindow) => void;
+    /** Called when a window is unregistered */
+    onWindowUnregistered?: (windowId: number) => void;
+    /** Called when focus changes */
+    onFocusChanged?: (windowId: number | null) => void;
+}
+/**
+ * Multi-Window Manager.
+ *
+ * Manages database access coordination across multiple Electron windows.
+ */
+export declare class WindowManager {
+    private readonly config;
+    private readonly callbacks;
+    private windows;
+    private focusedWindowId;
+    private isInitialized;
+    constructor(config?: WindowManagerConfig, callbacks?: WindowManagerCallbacks);
+    /**
+     * Initialize the window manager.
+     */
+    initialize(): void;
+    /**
+     * Dispose the window manager.
+     */
+    dispose(): void;
+    /**
+     * Set up focus tracking for all windows.
+     */
+    private setupFocusTracking;
+    /**
+     * Register a window for management.
+     */
+    registerWindow(window: BrowserWindow, name?: string): void;
+    /**
+     * Unregister a window.
+     */
+    unregisterWindow(windowId: number): void;
+    /**
+     * Handle window focus event.
+     */
+    private handleWindowFocus;
+    /**
+     * Handle window blur event.
+     */
+    private handleWindowBlur;
+    /**
+     * Broadcast a database change to all windows.
+     */
+    broadcastChange(change: Omit<DbChangeEvent, 'timestamp'>, excludeWindowId?: number): void;
+    /**
+     * Broadcast connection state change to all windows.
+     */
+    broadcastConnectionState(state: 'open' | 'closed' | 'error', error?: Error): void;
+    /**
+     * Send a message to a specific window.
+     */
+    sendToWindow(windowId: number, channel: string, data: unknown): boolean;
+    /**
+     * Send a message to the focused window.
+     */
+    sendToFocusedWindow(channel: string, data: unknown): boolean;
+    /**
+     * Subscribe a window to database changes.
+     */
+    subscribeWindow(windowId: number): void;
+    /**
+     * Unsubscribe a window from database changes.
+     */
+    unsubscribeWindow(windowId: number): void;
+    /**
+     * Get all registered windows.
+     */
+    getWindows(): RegisteredWindow[];
+    /**
+     * Get a specific window registration.
+     */
+    getWindow(windowId: number): RegisteredWindow | undefined;
+    /**
+     * Get the focused window ID.
+     */
+    getFocusedWindowId(): number | null;
+    /**
+     * Get the focused window registration.
+     */
+    getFocusedWindow(): RegisteredWindow | undefined;
+    /**
+     * Get window count.
+     */
+    getWindowCount(): number;
+    /**
+     * Check if a window is registered.
+     */
+    hasWindow(windowId: number): boolean;
+    /**
+     * Update window activity timestamp.
+     */
+    updateActivity(windowId: number): void;
+    /**
+     * Get statistics about windows.
+     */
+    getStats(): {
+        totalWindows: number;
+        subscribedWindows: number;
+        focusedWindowId: number | null;
+    };
+    /**
+     * Log a message if verbose mode is enabled.
+     */
+    private log;
+}
+/**
+ * Create a Window Manager.
+ *
+ * @param config - Manager configuration
+ * @param callbacks - Event callbacks
+ * @returns WindowManager instance
+ */
+export declare function createWindowManager(config?: WindowManagerConfig, callbacks?: WindowManagerCallbacks): WindowManager;
+//# sourceMappingURL=windowManager.d.ts.map

package/dist/adapters/electron/window/windowManager.d.ts.map

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