@framers/sql-storage-adapter 0.4.2 → 0.5.1

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

@@ -0,0 +1,9 @@
+/**
+ * Migration Module for Electron SQL Storage Adapter.
+ *
+ * Provides automatic database migration management for Electron applications.
+ *
+ * @packageDocumentation
+ */
+export { AutoMigrator, createAutoMigrator, type AutoMigratorConfig, type MigrationFile, type AppliedMigration, type MigrationResult, } from './autoMigrator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/electron/migration/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Migration Module for Electron SQL Storage Adapter.
+ *
+ * Provides automatic database migration management for Electron applications.
+ *
+ * @packageDocumentation
+ */
+export { AutoMigrator, createAutoMigrator, } from './autoMigrator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/electron/migration/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,GAKnB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,126 @@
+/**
+ * Preload Script for Electron SQL Storage Adapter.
+ *
+ * Exposes a secure API to renderer processes via contextBridge.
+ * This script runs in an isolated context with access to Node.js APIs
+ * and Electron's IPC modules.
+ *
+ * ## Security
+ * - Only exposes necessary functions via contextBridge
+ * - All IPC calls are wrapped with proper error handling
+ * - No direct access to Node.js modules from renderer
+ *
+ * ## Usage in main.js
+ * ```javascript
+ * new BrowserWindow({
+ *   webPreferences: {
+ *     preload: path.join(__dirname, 'preload.js'),
+ *     contextIsolation: true,
+ *     nodeIntegration: false,
+ *   }
+ * });
+ * ```
+ */
+import type { TransactionContext, SyncStatus, DbChangeEvent } from './ipc/types';
+import type { StorageRunResult, StorageOpenOptions, StorageParameters, BatchOperation, BatchResult, StorageCapability } from '../../core/contracts';
+/**
+ * SQL Storage API exposed to renderer processes.
+ */
+declare const sqlStorageApi: {
+    /**
+     * Open the database connection.
+     */
+    open(options?: StorageOpenOptions): Promise<void>;
+    /**
+     * Close the database connection.
+     */
+    close(): Promise<void>;
+    /**
+     * Check if the database is open.
+     */
+    isOpen(): Promise<boolean>;
+    /**
+     * Get adapter capabilities.
+     */
+    getCapabilities(): Promise<StorageCapability[]>;
+    /**
+     * Execute a mutation statement (INSERT, UPDATE, DELETE).
+     */
+    run(statement: string, parameters?: StorageParameters): Promise<StorageRunResult>;
+    /**
+     * Get a single row.
+     */
+    get<T = unknown>(statement: string, parameters?: StorageParameters): Promise<T | null>;
+    /**
+     * Get all matching rows.
+     */
+    all<T = unknown>(statement: string, parameters?: StorageParameters): Promise<T[]>;
+    /**
+     * Execute a SQL script.
+     */
+    exec(script: string): Promise<void>;
+    /**
+     * Execute batch operations.
+     */
+    batch(operations: BatchOperation[]): Promise<BatchResult>;
+    /**
+     * Begin a transaction.
+     */
+    beginTransaction(): Promise<TransactionContext>;
+    /**
+     * Commit a transaction.
+     */
+    commitTransaction(transactionId: string): Promise<void>;
+    /**
+     * Rollback a transaction.
+     */
+    rollbackTransaction(transactionId: string): Promise<void>;
+    /**
+     * Execute an operation within a transaction.
+     */
+    executeInTransaction(transactionId: string, statement: string, parameters?: StorageParameters): Promise<StorageRunResult | unknown[]>;
+    /**
+     * Execute a callback within a transaction (convenience method).
+     * Automatically handles begin/commit/rollback.
+     */
+    transaction<T>(fn: (trx: {
+        run: (statement: string, parameters?: StorageParameters) => Promise<StorageRunResult>;
+        get: <R = unknown>(statement: string, parameters?: StorageParameters) => Promise<R | null>;
+        all: <R = unknown>(statement: string, parameters?: StorageParameters) => Promise<R[]>;
+    }) => Promise<T>): Promise<T>;
+    /**
+     * Get sync status.
+     */
+    getSyncStatus(): Promise<SyncStatus>;
+    /**
+     * Trigger manual sync.
+     */
+    triggerSync(): Promise<void>;
+    /**
+     * Subscribe to database change events.
+     */
+    onDatabaseChange(callback: (event: DbChangeEvent) => void): () => void;
+    /**
+     * Subscribe to sync progress events.
+     */
+    onSyncProgress(callback: (progress: number) => void): () => void;
+    /**
+     * Subscribe to sync complete events.
+     */
+    onSyncComplete(callback: () => void): () => void;
+    /**
+     * Subscribe to sync error events.
+     */
+    onSyncError(callback: (error: Error) => void): () => void;
+};
+/**
+ * Type declaration for window.sqlStorage.
+ */
+export type SqlStorageApi = typeof sqlStorageApi;
+export { sqlStorageApi };
+declare global {
+    interface Window {
+        sqlStorage: SqlStorageApi;
+    }
+}
+//# sourceMappingURL=preload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../../../src/adapters/electron/preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAOV,kBAAkB,EAElB,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AA4C9B;;GAEG;AACH,QAAA,MAAM,aAAa;IAKjB;;OAEG;mBACkB,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;OAEG;aACY,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;cACa,OAAO,CAAC,OAAO,CAAC;IAIhC;;OAEG;uBACsB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrD;;OAEG;mBACkB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKvF;;OAEG;QACO,CAAC,uBAAuB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5F;;OAEG;QACO,CAAC,uBAAuB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKvF;;OAEG;iBACgB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC;;OAEG;sBACqB,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAS/D;;OAEG;wBACuB,OAAO,CAAC,kBAAkB,CAAC;IAIrD;;OAEG;qCACoC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;uCACsC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;OAEG;wCAEc,MAAM,aACV,MAAM,eACJ,iBAAiB,GAC7B,OAAO,CAAC,gBAAgB,GAAG,OAAO,EAAE,CAAC;IAQxC;;;OAGG;gBACe,CAAC,MACb,CAAC,GAAG,EAAE;QACR,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtF,GAAG,EAAE,CAAC,CAAW,GAAP,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3F,GAAG,EAAE,CAAC,CAAW,GAAP,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;KACvF,KAAK,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,CAAC;IAkCb;;OAEG;qBACoB,OAAO,CAAC,UAAU,CAAC;IAI1C;;OAEG;mBACkB,OAAO,CAAC,IAAI,CAAC;IAQlC;;OAEG;+BACwB,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAQtE;;OAEG;6BACsB,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAQhE;;OAEG;6BACsB,MAAM,IAAI,GAAG,MAAM,IAAI;IAMhD;;OAEG;0BACmB,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;CAO1D,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAQjD,OAAO,EAAE,aAAa,EAAE,CAAC;AAMzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,aAAa,CAAC;KAC3B;CACF"}

package/dist/adapters/electron/preload.js

@@ -0,0 +1,254 @@
+/**
+ * Preload Script for Electron SQL Storage Adapter.
+ *
+ * Exposes a secure API to renderer processes via contextBridge.
+ * This script runs in an isolated context with access to Node.js APIs
+ * and Electron's IPC modules.
+ *
+ * ## Security
+ * - Only exposes necessary functions via contextBridge
+ * - All IPC calls are wrapped with proper error handling
+ * - No direct access to Node.js modules from renderer
+ *
+ * ## Usage in main.js
+ * ```javascript
+ * new BrowserWindow({
+ *   webPreferences: {
+ *     preload: path.join(__dirname, 'preload.js'),
+ *     contextIsolation: true,
+ *     nodeIntegration: false,
+ *   }
+ * });
+ * ```
+ */
+import { contextBridge, ipcRenderer } from 'electron';
+import { DB_CHANNELS, TRANSACTION_CHANNELS, SYNC_CHANNELS, BROADCAST_CHANNELS } from './ipc/channels.js';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Generate a unique message ID for request correlation.
+ */
+function generateMessageId() {
+    return `msg_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Create a typed IPC request.
+ */
+function createRequest(payload) {
+    return {
+        messageId: generateMessageId(),
+        payload,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Invoke IPC and handle response.
+ */
+async function invokeIpc(channel, payload) {
+    const request = createRequest(payload);
+    const response = await ipcRenderer.invoke(channel, request);
+    if (!response.success) {
+        const error = new Error(response.error?.message ?? 'Unknown IPC error');
+        error.name = response.error?.code ?? 'IpcError';
+        throw error;
+    }
+    return response.data;
+}
+// ============================================================================
+// SQL Storage API
+// ============================================================================
+/**
+ * SQL Storage API exposed to renderer processes.
+ */
+const sqlStorageApi = {
+    // ============================================================================
+    // Database Operations
+    // ============================================================================
+    /**
+     * Open the database connection.
+     */
+    async open(options) {
+        const payload = { options };
+        await invokeIpc(DB_CHANNELS.OPEN, payload);
+    },
+    /**
+     * Close the database connection.
+     */
+    async close() {
+        await invokeIpc(DB_CHANNELS.CLOSE, undefined);
+    },
+    /**
+     * Check if the database is open.
+     */
+    async isOpen() {
+        return invokeIpc(DB_CHANNELS.IS_OPEN, undefined);
+    },
+    /**
+     * Get adapter capabilities.
+     */
+    async getCapabilities() {
+        return invokeIpc(DB_CHANNELS.CAPABILITIES, undefined);
+    },
+    /**
+     * Execute a mutation statement (INSERT, UPDATE, DELETE).
+     */
+    async run(statement, parameters) {
+        const payload = { statement, parameters };
+        return invokeIpc(DB_CHANNELS.RUN, payload);
+    },
+    /**
+     * Get a single row.
+     */
+    async get(statement, parameters) {
+        const payload = { statement, parameters };
+        return invokeIpc(DB_CHANNELS.GET, payload);
+    },
+    /**
+     * Get all matching rows.
+     */
+    async all(statement, parameters) {
+        const payload = { statement, parameters };
+        return invokeIpc(DB_CHANNELS.ALL, payload);
+    },
+    /**
+     * Execute a SQL script.
+     */
+    async exec(script) {
+        const payload = { script };
+        await invokeIpc(DB_CHANNELS.EXEC, payload);
+    },
+    /**
+     * Execute batch operations.
+     */
+    async batch(operations) {
+        const payload = { operations };
+        return invokeIpc(DB_CHANNELS.BATCH, payload);
+    },
+    // ============================================================================
+    // Transaction Operations
+    // ============================================================================
+    /**
+     * Begin a transaction.
+     */
+    async beginTransaction() {
+        return invokeIpc(TRANSACTION_CHANNELS.BEGIN, undefined);
+    },
+    /**
+     * Commit a transaction.
+     */
+    async commitTransaction(transactionId) {
+        await invokeIpc(TRANSACTION_CHANNELS.COMMIT, { transactionId });
+    },
+    /**
+     * Rollback a transaction.
+     */
+    async rollbackTransaction(transactionId) {
+        await invokeIpc(TRANSACTION_CHANNELS.ROLLBACK, { transactionId });
+    },
+    /**
+     * Execute an operation within a transaction.
+     */
+    async executeInTransaction(transactionId, statement, parameters) {
+        const payload = {
+            transactionId,
+            operation: { statement, parameters },
+        };
+        return invokeIpc(TRANSACTION_CHANNELS.EXECUTE, payload);
+    },
+    /**
+     * Execute a callback within a transaction (convenience method).
+     * Automatically handles begin/commit/rollback.
+     */
+    async transaction(fn) {
+        const ctx = await this.beginTransaction();
+        const trx = {
+            run: async (statement, parameters) => {
+                const result = await this.executeInTransaction(ctx.transactionId, statement, parameters);
+                return result;
+            },
+            get: async (statement, parameters) => {
+                const result = await this.executeInTransaction(ctx.transactionId, statement, parameters);
+                return (Array.isArray(result) ? result[0] ?? null : null);
+            },
+            all: async (statement, parameters) => {
+                const result = await this.executeInTransaction(ctx.transactionId, statement, parameters);
+                return (Array.isArray(result) ? result : []);
+            },
+        };
+        try {
+            const result = await fn(trx);
+            await this.commitTransaction(ctx.transactionId);
+            return result;
+        }
+        catch (error) {
+            await this.rollbackTransaction(ctx.transactionId).catch(() => {
+                // Ignore rollback errors
+            });
+            throw error;
+        }
+    },
+    // ============================================================================
+    // Sync Operations
+    // ============================================================================
+    /**
+     * Get sync status.
+     */
+    async getSyncStatus() {
+        return invokeIpc(SYNC_CHANNELS.STATUS, undefined);
+    },
+    /**
+     * Trigger manual sync.
+     */
+    async triggerSync() {
+        await invokeIpc(SYNC_CHANNELS.TRIGGER, undefined);
+    },
+    // ============================================================================
+    // Event Subscriptions
+    // ============================================================================
+    /**
+     * Subscribe to database change events.
+     */
+    onDatabaseChange(callback) {
+        const handler = (_, event) => {
+            callback(event);
+        };
+        ipcRenderer.on(BROADCAST_CHANNELS.DB_CHANGE, handler);
+        return () => ipcRenderer.removeListener(BROADCAST_CHANNELS.DB_CHANGE, handler);
+    },
+    /**
+     * Subscribe to sync progress events.
+     */
+    onSyncProgress(callback) {
+        const handler = (_, progress) => {
+            callback(progress);
+        };
+        ipcRenderer.on(SYNC_CHANNELS.PROGRESS, handler);
+        return () => ipcRenderer.removeListener(SYNC_CHANNELS.PROGRESS, handler);
+    },
+    /**
+     * Subscribe to sync complete events.
+     */
+    onSyncComplete(callback) {
+        const handler = () => callback();
+        ipcRenderer.on(SYNC_CHANNELS.COMPLETE, handler);
+        return () => ipcRenderer.removeListener(SYNC_CHANNELS.COMPLETE, handler);
+    },
+    /**
+     * Subscribe to sync error events.
+     */
+    onSyncError(callback) {
+        const handler = (_, error) => {
+            callback(new Error(error.message));
+        };
+        ipcRenderer.on(SYNC_CHANNELS.ERROR, handler);
+        return () => ipcRenderer.removeListener(SYNC_CHANNELS.ERROR, handler);
+    },
+};
+// Only expose if contextBridge is available (running in Electron)
+if (contextBridge) {
+    contextBridge.exposeInMainWorld('sqlStorage', sqlStorageApi);
+}
+// Export for testing and direct use
+export { sqlStorageApi };
+//# sourceMappingURL=preload.js.map

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

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

package/dist/adapters/electron/recovery/corruptionDetector.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Database Corruption Detection and Auto-Repair.
+ *
+ * Provides integrity checking and automatic repair capabilities
+ * for SQLite databases. Detects corruption early and attempts
+ * recovery before data loss occurs.
+ *
+ * ## Detection Methods
+ * - SQLite integrity_check PRAGMA
+ * - Quick check (faster, less thorough)
+ * - Foreign key constraint validation
+ * - Index integrity verification
+ *
+ * ## Repair Strategies
+ * - VACUUM: Rebuilds entire database
+ * - REINDEX: Rebuilds all indexes
+ * - Export/Import: Last resort recovery
+ *
+ * @example
+ * ```typescript
+ * const detector = new CorruptionDetector(adapter, {
+ *   checkOnOpen: true,
+ *   autoRepair: true,
+ *   backupBeforeRepair: true,
+ * });
+ *
+ * const result = await detector.runFullCheck();
+ * if (!result.isHealthy) {
+ *   await detector.attemptRepair();
+ * }
+ * ```
+ */
+import type { StorageAdapter } from '../../../core/contracts';
+/**
+ * Integrity check level.
+ */
+export type IntegrityCheckLevel = 'quick' | 'full' | 'thorough';
+/**
+ * Corruption detection configuration.
+ */
+export interface CorruptionDetectorConfig {
+    /** Run check when database is opened (default: true) */
+    checkOnOpen?: boolean;
+    /** Attempt automatic repair on corruption (default: true) */
+    autoRepair?: boolean;
+    /** Create backup before repair (default: true) */
+    backupBeforeRepair?: boolean;
+    /** Maximum time for integrity check in ms (default: 60000) */
+    checkTimeout?: number;
+    /** Check level (default: 'quick') */
+    defaultCheckLevel?: IntegrityCheckLevel;
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+}
+/**
+ * Single corruption issue.
+ */
+export interface CorruptionIssue {
+    /** Issue type */
+    type: 'data' | 'index' | 'foreign_key' | 'structure' | 'unknown';
+    /** Affected table (if identifiable) */
+    table?: string;
+    /** Detailed message */
+    message: string;
+    /** Severity level */
+    severity: 'warning' | 'error' | 'critical';
+    /** Whether this issue is repairable */
+    repairable: boolean;
+}
+/**
+ * Result of an integrity check.
+ */
+export interface IntegrityCheckResult {
+    /** Whether the database is healthy */
+    isHealthy: boolean;
+    /** Check level performed */
+    level: IntegrityCheckLevel;
+    /** List of issues found */
+    issues: CorruptionIssue[];
+    /** Time taken in milliseconds */
+    durationMs: number;
+    /** Timestamp of check */
+    timestamp: number;
+    /** Pages checked (full check only) */
+    pagesChecked?: number;
+    /** Total database size in bytes */
+    databaseSize?: number;
+}
+/**
+ * Repair strategy.
+ */
+export type RepairStrategy = 'vacuum' | 'reindex' | 'export_import';
+/**
+ * Result of a repair attempt.
+ */
+export interface RepairResult {
+    /** Whether repair was successful */
+    success: boolean;
+    /** Strategy used */
+    strategy: RepairStrategy;
+    /** Issues fixed */
+    issuesFixed: number;
+    /** Issues remaining */
+    issuesRemaining: number;
+    /** Time taken in milliseconds */
+    durationMs: number;
+    /** Backup path (if created) */
+    backupPath?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Database Corruption Detector.
+ *
+ * Detects and repairs SQLite database corruption.
+ */
+export declare class CorruptionDetector {
+    private readonly adapter;
+    private readonly config;
+    private lastCheck;
+    private repairHistory;
+    constructor(adapter: StorageAdapter, config?: CorruptionDetectorConfig);
+    /**
+     * Run a quick integrity check.
+     * Faster but less thorough than full check.
+     */
+    runQuickCheck(): Promise<IntegrityCheckResult>;
+    /**
+     * Run a full integrity check.
+     * Checks all pages and structures.
+     */
+    runFullCheck(): Promise<IntegrityCheckResult>;
+    /**
+     * Run a thorough integrity check.
+     * Includes foreign key and index validation.
+     */
+    runThoroughCheck(): Promise<IntegrityCheckResult>;
+    /**
+     * Run an integrity check at the specified level.
+     */
+    private runCheck;
+    /**
+     * Parse integrity check results into structured issues.
+     */
+    private parseIntegrityResults;
+    /**
+     * Check foreign key constraints.
+     */
+    private checkForeignKeys;
+    /**
+     * Check index integrity.
+     */
+    private checkIndexes;
+    /**
+     * Attempt to repair the database.
+     */
+    attemptRepair(strategy?: RepairStrategy): Promise<RepairResult>;
+    /**
+     * Select the best repair strategy based on issues found.
+     */
+    private selectRepairStrategy;
+    /**
+     * Repair using VACUUM.
+     */
+    private repairWithVacuum;
+    /**
+     * Repair using REINDEX.
+     */
+    private repairWithReindex;
+    /**
+     * Repair using export/import.
+     * This is a last resort that exports all data and recreates the database.
+     */
+    private repairWithExportImport;
+    /**
+     * Create a backup of the database.
+     */
+    private createBackup;
+    /**
+     * Get the last integrity check result.
+     */
+    getLastCheck(): IntegrityCheckResult | null;
+    /**
+     * Get repair history.
+     */
+    getRepairHistory(): RepairResult[];
+    /**
+     * Check if the database appears healthy.
+     */
+    isHealthy(): boolean;
+    /**
+     * Get summary of database health.
+     */
+    getHealthSummary(): {
+        isHealthy: boolean;
+        lastCheckAt: number | null;
+        issueCount: number;
+        repairAttempts: number;
+        successfulRepairs: number;
+    };
+    /**
+     * Log a message if verbose mode is enabled.
+     */
+    private log;
+}
+/**
+ * Create a Corruption Detector.
+ *
+ * @param adapter - Storage adapter to monitor
+ * @param config - Detector configuration
+ * @returns CorruptionDetector instance
+ */
+export declare function createCorruptionDetector(adapter: StorageAdapter, config?: CorruptionDetectorConfig): CorruptionDetector;
+//# sourceMappingURL=corruptionDetector.d.ts.map

package/dist/adapters/electron/recovery/corruptionDetector.d.ts.map

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