@framers/sql-storage-adapter 0.4.2 → 0.5.1

package/dist/adapters/electron/electronRendererAdapter.js

@@ -0,0 +1,339 @@
+/**
+ * Electron Renderer Process Storage Adapter.
+ *
+ * Provides the same StorageAdapter interface to renderer processes
+ * by proxying all operations to the main process via IPC.
+ *
+ * ## Architecture
+ * This adapter runs in renderer processes and communicates with
+ * ElectronMainAdapter in the main process via the preload script API.
+ *
+ * ## Requirements
+ * - Preload script must be loaded and expose `window.sqlStorage`
+ * - Main process must have ElectronMainAdapter initialized
+ *
+ * ## Usage
+ * ```typescript
+ * import { createElectronRendererAdapter } from '@framers/sql-storage-adapter/electron';
+ *
+ * const db = createElectronRendererAdapter({
+ *   onDatabaseChange: (change) => {
+ *     console.log('Database changed:', change);
+ *     // React to changes from other windows
+ *   },
+ * });
+ *
+ * await db.open();
+ * const users = await db.all('SELECT * FROM users');
+ * ```
+ */
+// ============================================================================
+// Electron Renderer Adapter
+// ============================================================================
+/**
+ * Storage adapter for Electron renderer processes.
+ *
+ * Proxies all database operations to the main process via IPC.
+ * Implements the same StorageAdapter interface as other adapters.
+ */
+export class ElectronRendererAdapter {
+    constructor(options = {}) {
+        this.kind = 'electron-renderer';
+        this.eventUnsubscribers = [];
+        this.isInitialized = false;
+        this.cachedCapabilities = [];
+        this.options = options;
+        // Default capabilities - will be updated after connecting to main process
+        this.capabilities = new Set([
+            'transactions',
+            'persistence',
+            'batch',
+        ]);
+    }
+    // ============================================================================
+    // Private Helpers
+    // ============================================================================
+    /**
+     * Get the preload API, throwing if not available.
+     */
+    getApi() {
+        if (typeof window === 'undefined' || !window.sqlStorage) {
+            throw new Error('[ElectronRendererAdapter] window.sqlStorage not available. ' +
+                'Ensure the preload script is loaded and contextBridge is properly configured.');
+        }
+        return window.sqlStorage;
+    }
+    /**
+     * Log a message if verbose mode is enabled.
+     */
+    log(message) {
+        if (this.options.verbose) {
+            console.log(`[ElectronRendererAdapter] ${message}`);
+        }
+    }
+    // ============================================================================
+    // Lifecycle Methods
+    // ============================================================================
+    /**
+     * Open connection to the database via main process.
+     */
+    async open(options) {
+        if (this.isInitialized) {
+            this.log('Already initialized, skipping open()');
+            return;
+        }
+        const api = this.getApi();
+        // Open connection
+        await api.open(options);
+        // Fetch actual capabilities from main process
+        this.cachedCapabilities = await api.getCapabilities();
+        this.capabilities = new Set(this.cachedCapabilities);
+        // Subscribe to events
+        this.subscribeToEvents();
+        this.isInitialized = true;
+        this.log('Connected to main process');
+    }
+    /**
+     * Close connection.
+     */
+    async close() {
+        if (!this.isInitialized) {
+            return;
+        }
+        // Unsubscribe from events
+        for (const unsubscribe of this.eventUnsubscribers) {
+            unsubscribe();
+        }
+        this.eventUnsubscribers = [];
+        // Note: We don't actually close the database here since that would
+        // affect all other renderer processes. The main process owns the connection.
+        this.isInitialized = false;
+        this.log('Disconnected from main process');
+    }
+    /**
+     * Subscribe to database events from main process.
+     */
+    subscribeToEvents() {
+        const api = this.getApi();
+        // Database change events
+        if (this.options.onDatabaseChange) {
+            const unsubscribe = api.onDatabaseChange(this.options.onDatabaseChange);
+            this.eventUnsubscribers.push(unsubscribe);
+        }
+        // Sync events
+        if (this.options.onSyncProgress) {
+            const unsubscribe = api.onSyncProgress(this.options.onSyncProgress);
+            this.eventUnsubscribers.push(unsubscribe);
+        }
+        if (this.options.onSyncComplete) {
+            const unsubscribe = api.onSyncComplete(this.options.onSyncComplete);
+            this.eventUnsubscribers.push(unsubscribe);
+        }
+        if (this.options.onSyncError) {
+            const unsubscribe = api.onSyncError(this.options.onSyncError);
+            this.eventUnsubscribers.push(unsubscribe);
+        }
+    }
+    // ============================================================================
+    // Storage Adapter Interface
+    // ============================================================================
+    /**
+     * Execute a mutation statement (INSERT, UPDATE, DELETE).
+     */
+    async run(statement, parameters) {
+        this.assertOpen();
+        return this.getApi().run(statement, parameters);
+    }
+    /**
+     * Get a single row.
+     */
+    async get(statement, parameters) {
+        this.assertOpen();
+        return this.getApi().get(statement, parameters);
+    }
+    /**
+     * Get all matching rows.
+     */
+    async all(statement, parameters) {
+        this.assertOpen();
+        return this.getApi().all(statement, parameters);
+    }
+    /**
+     * Execute a SQL script.
+     */
+    async exec(script) {
+        this.assertOpen();
+        return this.getApi().exec(script);
+    }
+    /**
+     * Execute operations within a transaction.
+     */
+    async transaction(fn) {
+        this.assertOpen();
+        // Create a transaction proxy adapter
+        const trxAdapter = new TransactionProxyAdapter(this.getApi());
+        return this.getApi().transaction(async (trx) => {
+            // The trx object from preload provides run/get/all
+            // We need to wrap it to match StorageAdapter interface
+            const wrappedTrx = {
+                kind: 'electron-renderer-transaction',
+                capabilities: this.capabilities,
+                open: async () => { },
+                close: async () => { },
+                run: trx.run,
+                get: trx.get,
+                all: trx.all,
+                exec: async () => { throw new Error('exec not supported in transaction'); },
+                transaction: async () => { throw new Error('Nested transactions not supported'); },
+            };
+            return fn(wrappedTrx);
+        });
+    }
+    /**
+     * Execute batch operations.
+     */
+    async batch(operations) {
+        this.assertOpen();
+        return this.getApi().batch(operations);
+    }
+    /**
+     * Prepared statements are not directly supported in renderer.
+     * Use the main process adapter for prepared statements.
+     */
+    prepare(_statement) {
+        throw new Error('Prepared statements not supported in renderer process. Use transactions instead.');
+    }
+    // ============================================================================
+    // Sync Operations
+    // ============================================================================
+    /**
+     * Get current sync status.
+     */
+    async getSyncStatus() {
+        this.assertOpen();
+        return this.getApi().getSyncStatus();
+    }
+    /**
+     * Trigger a manual sync.
+     */
+    async triggerSync() {
+        this.assertOpen();
+        return this.getApi().triggerSync();
+    }
+    // ============================================================================
+    // Utility Methods
+    // ============================================================================
+    /**
+     * Assert that the adapter is open.
+     */
+    assertOpen() {
+        if (!this.isInitialized) {
+            throw new Error('[ElectronRendererAdapter] Adapter not open. Call open() first.');
+        }
+    }
+    /**
+     * Check if the adapter is open.
+     */
+    isOpen() {
+        return this.isInitialized;
+    }
+    /**
+     * Check if the main process database is open.
+     */
+    async isMainProcessOpen() {
+        try {
+            return await this.getApi().isOpen();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Add an event listener for database changes.
+     */
+    onDatabaseChange(callback) {
+        const unsubscribe = this.getApi().onDatabaseChange(callback);
+        this.eventUnsubscribers.push(unsubscribe);
+        return unsubscribe;
+    }
+}
+// ============================================================================
+// Transaction Proxy Adapter
+// ============================================================================
+/**
+ * Internal adapter used during transactions.
+ */
+class TransactionProxyAdapter {
+    constructor(api) {
+        this.api = api;
+        this.kind = 'electron-renderer-transaction';
+        this.capabilities = new Set();
+    }
+    async open() {
+        // No-op: Transaction doesn't need to be opened
+    }
+    async close() {
+        // No-op: Transaction is closed by commit/rollback
+    }
+    async run(statement, parameters) {
+        return this.api.run(statement, parameters);
+    }
+    async get(statement, parameters) {
+        return this.api.get(statement, parameters);
+    }
+    async all(statement, parameters) {
+        return this.api.all(statement, parameters);
+    }
+    async exec(_script) {
+        throw new Error('exec not supported within transactions from renderer');
+    }
+    async transaction(_fn) {
+        throw new Error('Nested transactions not supported');
+    }
+    async batch(_operations) {
+        throw new Error('Batch operations not supported within transactions from renderer');
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create an Electron Renderer Process Storage Adapter.
+ *
+ * This adapter proxies all database operations to the main process
+ * via IPC. Use it in renderer processes to access the shared database.
+ *
+ * @param options - Adapter configuration
+ * @returns ElectronRendererAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const db = createElectronRendererAdapter({
+ *   onDatabaseChange: (change) => {
+ *     console.log('Database changed:', change);
+ *     // Refresh data or invalidate caches
+ *   },
+ * });
+ *
+ * await db.open();
+ * const users = await db.all('SELECT * FROM users');
+ * ```
+ */
+export function createElectronRendererAdapter(options = {}) {
+    return new ElectronRendererAdapter(options);
+}
+/**
+ * Helper to detect if running in Electron renderer.
+ */
+export function isElectronRenderer() {
+    return typeof window !== 'undefined' &&
+        typeof window.process === 'object' &&
+        window.process?.type === 'renderer';
+}
+/**
+ * Helper to check if preload API is available.
+ */
+export function isPreloadApiAvailable() {
+    return typeof window !== 'undefined' && !!window.sqlStorage;
+}
+//# sourceMappingURL=electronRendererAdapter.js.map

package/dist/adapters/electron/electronRendererAdapter.js.map

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

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

@@ -0,0 +1,74 @@
+/**
+ * Electron Storage Adapter Module.
+ *
+ * Provides database access for Electron applications with:
+ * - Main process adapter (owns the database connection)
+ * - Renderer process adapter (IPC proxy to main)
+ * - Preload script for secure IPC bridge
+ * - WAL management and crash recovery
+ * - Multi-window change broadcasting
+ *
+ * ## Quick Start
+ *
+ * ### Main Process (main.ts)
+ * ```typescript
+ * import { createElectronMainAdapter } from '@framers/sql-storage-adapter/electron';
+ * import { app } from 'electron';
+ * import path from 'path';
+ *
+ * const db = createElectronMainAdapter({
+ *   filePath: path.join(app.getPath('userData'), 'app.db'),
+ *   wal: { enabled: true },
+ *   recovery: { checkOnOpen: true },
+ * });
+ *
+ * app.whenReady().then(async () => {
+ *   await db.open();
+ *   // Database ready for use
+ * });
+ * ```
+ *
+ * ### BrowserWindow Configuration
+ * ```typescript
+ * new BrowserWindow({
+ *   webPreferences: {
+ *     preload: path.join(__dirname, 'preload.js'),
+ *     contextIsolation: true,
+ *     nodeIntegration: false,
+ *   }
+ * });
+ * ```
+ *
+ * ### Preload Script (preload.ts)
+ * ```typescript
+ * // Just import the preload module - it auto-registers
+ * import '@framers/sql-storage-adapter/electron/preload';
+ * ```
+ *
+ * ### Renderer Process
+ * ```typescript
+ * import { createElectronRendererAdapter } from '@framers/sql-storage-adapter/electron';
+ *
+ * const db = createElectronRendererAdapter({
+ *   onDatabaseChange: (change) => {
+ *     console.log('Database changed:', change);
+ *   },
+ * });
+ *
+ * await db.open();
+ * const users = await db.all('SELECT * FROM users');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ElectronMainAdapter, createElectronMainAdapter, type ElectronMainAdapterOptions, type WalConfig, type RecoveryConfig, type MigrationConfig, type BackupConfig, type CloudBackupProvider, type MultiWindowConfig, } from './electronMainAdapter';
+export { ElectronRendererAdapter, createElectronRendererAdapter, isElectronRenderer, isPreloadApiAvailable, type ElectronRendererAdapterOptions, } from './electronRendererAdapter';
+export { sqlStorageApi, type SqlStorageApi, } from './preload';
+export { IPC_CHANNELS, DB_CHANNELS, TRANSACTION_CHANNELS, SYNC_CHANNELS, BACKUP_CHANNELS, RECOVERY_CHANNELS, MIGRATION_CHANNELS, BROADCAST_CHANNELS, type IpcChannel, } from './ipc/channels';
+export type { IpcRequest, IpcResponse, IpcError, SqlOperationPayload, ExecPayload, BatchPayload, OpenPayload, TransactionContext, TransactionOperationPayload, SyncStatus, BackupInfo, DbChangeEvent, ConnectionStateEvent, IntegrityCheckResult, WalCheckpointResult, MigrationStatus, } from './ipc/types';
+export { IpcProtocolManager, protocolManager, initializeIpcProtocol, disposeIpcProtocol, } from './ipc/protocol';
+export { WalCheckpointManager, createWalCheckpointManager, type WalCheckpointConfig, type CheckpointStrategy, type CheckpointResult, type WalStatus, CorruptionDetector, createCorruptionDetector, type CorruptionDetectorConfig, type IntegrityCheckLevel, type IntegrityCheckResult as RecoveryIntegrityCheckResult, type CorruptionIssue, type RepairStrategy, type RepairResult, } from './recovery';
+export { AutoMigrator, createAutoMigrator, type AutoMigratorConfig, type MigrationFile, type AppliedMigration, type MigrationResult, } from './migration';
+export { WindowManager, createWindowManager, type WindowManagerConfig, type WindowManagerCallbacks, type RegisteredWindow, } from './window';
+export type { StorageAdapter, StorageCapability, StorageOpenOptions, StorageParameters, StorageRunResult, BatchOperation, BatchResult, } from '../../core/contracts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/electron/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAMH,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,8BAA8B,GACpC,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EACL,aAAa,EACb,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AAMnB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,2BAA2B,EAC3B,UAAU,EACV,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,IAAI,4BAA4B,EACzD,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAMlB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC"}

package/dist/adapters/electron/index.js

@@ -0,0 +1,96 @@
+/**
+ * Electron Storage Adapter Module.
+ *
+ * Provides database access for Electron applications with:
+ * - Main process adapter (owns the database connection)
+ * - Renderer process adapter (IPC proxy to main)
+ * - Preload script for secure IPC bridge
+ * - WAL management and crash recovery
+ * - Multi-window change broadcasting
+ *
+ * ## Quick Start
+ *
+ * ### Main Process (main.ts)
+ * ```typescript
+ * import { createElectronMainAdapter } from '@framers/sql-storage-adapter/electron';
+ * import { app } from 'electron';
+ * import path from 'path';
+ *
+ * const db = createElectronMainAdapter({
+ *   filePath: path.join(app.getPath('userData'), 'app.db'),
+ *   wal: { enabled: true },
+ *   recovery: { checkOnOpen: true },
+ * });
+ *
+ * app.whenReady().then(async () => {
+ *   await db.open();
+ *   // Database ready for use
+ * });
+ * ```
+ *
+ * ### BrowserWindow Configuration
+ * ```typescript
+ * new BrowserWindow({
+ *   webPreferences: {
+ *     preload: path.join(__dirname, 'preload.js'),
+ *     contextIsolation: true,
+ *     nodeIntegration: false,
+ *   }
+ * });
+ * ```
+ *
+ * ### Preload Script (preload.ts)
+ * ```typescript
+ * // Just import the preload module - it auto-registers
+ * import '@framers/sql-storage-adapter/electron/preload';
+ * ```
+ *
+ * ### Renderer Process
+ * ```typescript
+ * import { createElectronRendererAdapter } from '@framers/sql-storage-adapter/electron';
+ *
+ * const db = createElectronRendererAdapter({
+ *   onDatabaseChange: (change) => {
+ *     console.log('Database changed:', change);
+ *   },
+ * });
+ *
+ * await db.open();
+ * const users = await db.all('SELECT * FROM users');
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Main Process Exports
+// ============================================================================
+export { ElectronMainAdapter, createElectronMainAdapter, } from './electronMainAdapter.js';
+// ============================================================================
+// Renderer Process Exports
+// ============================================================================
+export { ElectronRendererAdapter, createElectronRendererAdapter, isElectronRenderer, isPreloadApiAvailable, } from './electronRendererAdapter.js';
+// ============================================================================
+// Preload Script Exports
+// ============================================================================
+export { sqlStorageApi, } from './preload.js';
+// ============================================================================
+// IPC Types & Channels
+// ============================================================================
+export { IPC_CHANNELS, DB_CHANNELS, TRANSACTION_CHANNELS, SYNC_CHANNELS, BACKUP_CHANNELS, RECOVERY_CHANNELS, MIGRATION_CHANNELS, BROADCAST_CHANNELS, } from './ipc/channels.js';
+// ============================================================================
+// Protocol (Main Process Only)
+// ============================================================================
+export { IpcProtocolManager, protocolManager, initializeIpcProtocol, disposeIpcProtocol, } from './ipc/protocol.js';
+// ============================================================================
+// Recovery Module
+// ============================================================================
+export { WalCheckpointManager, createWalCheckpointManager, CorruptionDetector, createCorruptionDetector, } from './recovery/index.js';
+// ============================================================================
+// Migration Module
+// ============================================================================
+export { AutoMigrator, createAutoMigrator, } from './migration/index.js';
+// ============================================================================
+// Window Management Module
+// ============================================================================
+export { WindowManager, createWindowManager, } from './window/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/electron/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAQ1B,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,2BAA2B,CAAC;AAEnC,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,OAAO,EACL,aAAa,GAEd,MAAM,WAAW,CAAC;AAEnB,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO,EACL,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAqBxB,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAK1B,kBAAkB,EAClB,wBAAwB,GAOzB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,OAAO,EACL,YAAY,EACZ,kBAAkB,GAKnB,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,OAAO,EACL,aAAa,EACb,mBAAmB,GAIpB,MAAM,UAAU,CAAC"}