@framers/sql-storage-adapter 0.4.2 → 0.5.1

package/dist/features/sync/tables/syncLogManager.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Sync Log Manager - Tracks database changes for delta synchronization.
+ *
+ * Maintains a change log with vector clocks for each modification,
+ * enabling efficient delta sync between devices.
+ *
+ * @example
+ * ```typescript
+ * const syncLog = new SyncLogManager(adapter, 'device-123');
+ * await syncLog.initialize();
+ *
+ * // Log a change
+ * await syncLog.logChange({
+ *   table: 'users',
+ *   recordId: 'user-1',
+ *   operation: 'UPDATE',
+ *   oldData: { name: 'Old' },
+ *   newData: { name: 'New' },
+ * });
+ *
+ * // Get changes since a clock
+ * const changes = await syncLog.getChangesSince(remoteVectorClock);
+ * ```
+ */
+import type { StorageAdapter } from '../../../core/contracts';
+import type { VectorClockData } from '../protocol/vectorClock';
+import { VectorClock } from '../protocol/vectorClock';
+import type { ChangeRecord, ChangeOperation, DeviceInfo, DeviceType } from '../protocol/messages';
+/**
+ * Change log entry as stored in database.
+ */
+export interface ChangeLogEntry {
+    logId: number;
+    changeId: string;
+    tableName: string;
+    recordId: string;
+    operation: ChangeOperation;
+    vectorClock: string;
+    deviceId: string;
+    oldData: string | null;
+    newData: string | null;
+    createdAt: number;
+    syncedAt: number | null;
+}
+/**
+ * Device registry entry.
+ */
+export interface DeviceEntry {
+    deviceId: string;
+    deviceType: DeviceType;
+    deviceName: string | null;
+    vectorClock: string;
+    lastSeenAt: number;
+    createdAt: number;
+}
+/**
+ * Conflict entry.
+ */
+export interface ConflictEntry {
+    conflictId: string;
+    tableName: string;
+    recordId: string;
+    localData: string;
+    remoteData: string;
+    localClock: string;
+    remoteClock: string;
+    status: 'pending' | 'resolved' | 'deferred';
+    resolution: string | null;
+    createdAt: number;
+    resolvedAt: number | null;
+}
+/**
+ * Sync log manager configuration.
+ */
+export interface SyncLogManagerConfig {
+    /** Maximum log entries to keep (auto-prune) */
+    maxLogEntries?: number;
+    /** Auto-prune synced entries after N days */
+    pruneSyncedAfterDays?: number;
+    /** Tables to track (undefined = all) */
+    includeTables?: string[];
+    /** Tables to exclude from tracking */
+    excludeTables?: string[];
+}
+/**
+ * Manages the sync change log and device registry.
+ */
+export declare class SyncLogManager {
+    private readonly adapter;
+    private readonly deviceId;
+    private readonly config;
+    private vectorClock;
+    private isInitialized;
+    constructor(adapter: StorageAdapter, deviceId?: string, config?: SyncLogManagerConfig);
+    /**
+     * Initialize sync tables.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create sync tracking tables.
+     */
+    private createSyncTables;
+    /**
+     * Load vector clock from database or create new one.
+     */
+    private loadVectorClock;
+    /**
+     * Log a database change.
+     */
+    logChange(change: {
+        table: string;
+        recordId: string;
+        operation: ChangeOperation;
+        oldData?: Record<string, unknown>;
+        newData?: Record<string, unknown>;
+    }): Promise<ChangeRecord>;
+    /**
+     * Get changes since a vector clock.
+     */
+    getChangesSince(sinceClock: VectorClockData, options?: {
+        tables?: string[];
+        limit?: number;
+    }): Promise<ChangeRecord[]>;
+    /**
+     * Mark changes as synced.
+     */
+    markSynced(changeIds: string[]): Promise<void>;
+    /**
+     * Get unsynced change count.
+     */
+    getUnsyncedCount(): Promise<number>;
+    /**
+     * Register a device.
+     */
+    registerDevice(device: DeviceInfo): Promise<void>;
+    /**
+     * Get all registered devices.
+     */
+    getDevices(): Promise<DeviceInfo[]>;
+    /**
+     * Update a device's vector clock.
+     */
+    updateDeviceClockFor(deviceId: string, clock: VectorClockData): Promise<void>;
+    /**
+     * Record a conflict.
+     */
+    recordConflict(conflict: {
+        table: string;
+        recordId: string;
+        localData: Record<string, unknown>;
+        remoteData: Record<string, unknown>;
+        localClock: VectorClockData;
+        remoteClock: VectorClockData;
+    }): Promise<string>;
+    /**
+     * Get pending conflicts.
+     */
+    getPendingConflicts(): Promise<ConflictEntry[]>;
+    /**
+     * Resolve a conflict.
+     */
+    resolveConflict(conflictId: string, resolution: string): Promise<void>;
+    /**
+     * Get current vector clock.
+     */
+    getVectorClock(): VectorClock;
+    /**
+     * Get vector clock data.
+     */
+    getVectorClockData(): VectorClockData;
+    /**
+     * Merge a remote clock into ours.
+     */
+    mergeVectorClock(remoteClock: VectorClockData): void;
+    /**
+     * Get device ID.
+     */
+    getDeviceId(): string;
+    /**
+     * Update this device's clock in database.
+     */
+    private updateDeviceClock;
+    /**
+     * Check if table should be tracked.
+     */
+    private shouldTrackTable;
+    /**
+     * Check if clock A is after clock B.
+     */
+    private isClockAfter;
+    /**
+     * Generate unique change ID.
+     */
+    private generateChangeId;
+    /**
+     * Generate unique conflict ID.
+     */
+    private generateConflictId;
+    /**
+     * Detect device type from environment.
+     */
+    private detectDeviceType;
+    /**
+     * Get device name.
+     */
+    private getDeviceName;
+    /**
+     * Prune old synced entries if over limit.
+     */
+    private pruneIfNeeded;
+}
+/**
+ * Create a sync log manager.
+ */
+export declare function createSyncLogManager(adapter: StorageAdapter, deviceId?: string, config?: SyncLogManagerConfig): SyncLogManager;
+//# sourceMappingURL=syncLogManager.d.ts.map

package/dist/features/sync/tables/syncLogManager.d.ts.map

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

package/dist/features/sync/tables/syncLogManager.js

@@ -0,0 +1,456 @@
+/**
+ * Sync Log Manager - Tracks database changes for delta synchronization.
+ *
+ * Maintains a change log with vector clocks for each modification,
+ * enabling efficient delta sync between devices.
+ *
+ * @example
+ * ```typescript
+ * const syncLog = new SyncLogManager(adapter, 'device-123');
+ * await syncLog.initialize();
+ *
+ * // Log a change
+ * await syncLog.logChange({
+ *   table: 'users',
+ *   recordId: 'user-1',
+ *   operation: 'UPDATE',
+ *   oldData: { name: 'Old' },
+ *   newData: { name: 'New' },
+ * });
+ *
+ * // Get changes since a clock
+ * const changes = await syncLog.getChangesSince(remoteVectorClock);
+ * ```
+ */
+import { VectorClock, generateDeviceId } from '../protocol/vectorClock.js';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxLogEntries: 10000,
+    pruneSyncedAfterDays: 30,
+    includeTables: [],
+    excludeTables: ['_sync_log', '_sync_devices', '_sync_conflicts'],
+};
+// ============================================================================
+// Sync Log Manager
+// ============================================================================
+/**
+ * Manages the sync change log and device registry.
+ */
+export class SyncLogManager {
+    constructor(adapter, deviceId = generateDeviceId(), config = {}) {
+        this.adapter = adapter;
+        this.deviceId = deviceId;
+        this.isInitialized = false;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.vectorClock = new VectorClock(deviceId);
+    }
+    // ============================================================================
+    // Initialization
+    // ============================================================================
+    /**
+     * Initialize sync tables.
+     */
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        await this.createSyncTables();
+        await this.loadVectorClock();
+        this.isInitialized = true;
+    }
+    /**
+     * Create sync tracking tables.
+     */
+    async createSyncTables() {
+        // Change log table
+        await this.adapter.exec(`
+      CREATE TABLE IF NOT EXISTS _sync_log (
+        log_id INTEGER PRIMARY KEY AUTOINCREMENT,
+        change_id TEXT NOT NULL UNIQUE,
+        table_name TEXT NOT NULL,
+        record_id TEXT NOT NULL,
+        operation TEXT NOT NULL CHECK (operation IN ('INSERT', 'UPDATE', 'DELETE')),
+        vector_clock TEXT NOT NULL,
+        device_id TEXT NOT NULL,
+        old_data TEXT,
+        new_data TEXT,
+        created_at INTEGER NOT NULL,
+        synced_at INTEGER
+      )
+    `);
+        // Indexes for efficient queries
+        await this.adapter.exec(`
+      CREATE INDEX IF NOT EXISTS idx_sync_log_table ON _sync_log(table_name)
+    `);
+        await this.adapter.exec(`
+      CREATE INDEX IF NOT EXISTS idx_sync_log_synced ON _sync_log(synced_at)
+    `);
+        await this.adapter.exec(`
+      CREATE INDEX IF NOT EXISTS idx_sync_log_device ON _sync_log(device_id)
+    `);
+        // Device registry table
+        await this.adapter.exec(`
+      CREATE TABLE IF NOT EXISTS _sync_devices (
+        device_id TEXT PRIMARY KEY,
+        device_type TEXT NOT NULL,
+        device_name TEXT,
+        vector_clock TEXT NOT NULL,
+        last_seen_at INTEGER NOT NULL,
+        created_at INTEGER NOT NULL
+      )
+    `);
+        // Conflicts table
+        await this.adapter.exec(`
+      CREATE TABLE IF NOT EXISTS _sync_conflicts (
+        conflict_id TEXT PRIMARY KEY,
+        table_name TEXT NOT NULL,
+        record_id TEXT NOT NULL,
+        local_data TEXT NOT NULL,
+        remote_data TEXT NOT NULL,
+        local_clock TEXT NOT NULL,
+        remote_clock TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'resolved', 'deferred')),
+        resolution TEXT,
+        created_at INTEGER NOT NULL,
+        resolved_at INTEGER
+      )
+    `);
+        await this.adapter.exec(`
+      CREATE INDEX IF NOT EXISTS idx_sync_conflicts_status ON _sync_conflicts(status)
+    `);
+    }
+    /**
+     * Load vector clock from database or create new one.
+     */
+    async loadVectorClock() {
+        const device = await this.adapter.get('SELECT * FROM _sync_devices WHERE device_id = ?', [this.deviceId]);
+        if (device) {
+            const clockData = JSON.parse(device.vectorClock);
+            this.vectorClock = new VectorClock(this.deviceId);
+            this.vectorClock.observe(clockData);
+        }
+        else {
+            // Register this device
+            await this.registerDevice({
+                deviceId: this.deviceId,
+                deviceType: this.detectDeviceType(),
+                deviceName: this.getDeviceName(),
+            });
+        }
+    }
+    // ============================================================================
+    // Change Logging
+    // ============================================================================
+    /**
+     * Log a database change.
+     */
+    async logChange(change) {
+        // Check if table should be tracked
+        if (!this.shouldTrackTable(change.table)) {
+            throw new Error(`Table ${change.table} is not tracked`);
+        }
+        // Increment vector clock
+        this.vectorClock.tick();
+        const changeId = this.generateChangeId();
+        const clockData = this.vectorClock.getValues();
+        const record = {
+            changeId,
+            table: change.table,
+            recordId: change.recordId,
+            operation: change.operation,
+            vectorClock: clockData,
+            deviceId: this.deviceId,
+            oldData: change.oldData,
+            newData: change.newData,
+            timestamp: Date.now(),
+        };
+        // Insert into log
+        await this.adapter.run(`INSERT INTO _sync_log
+       (change_id, table_name, record_id, operation, vector_clock, device_id, old_data, new_data, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            changeId,
+            change.table,
+            change.recordId,
+            change.operation,
+            JSON.stringify(clockData),
+            this.deviceId,
+            change.oldData ? JSON.stringify(change.oldData) : null,
+            change.newData ? JSON.stringify(change.newData) : null,
+            Date.now(),
+        ]);
+        // Update device's vector clock
+        await this.updateDeviceClock();
+        // Auto-prune if needed
+        await this.pruneIfNeeded();
+        return record;
+    }
+    /**
+     * Get changes since a vector clock.
+     */
+    async getChangesSince(sinceClock, options = {}) {
+        const { tables, limit = 1000 } = options;
+        let query = `
+      SELECT * FROM _sync_log
+      WHERE synced_at IS NULL
+    `;
+        const params = [];
+        if (tables && tables.length > 0) {
+            query += ` AND table_name IN (${tables.map(() => '?').join(', ')})`;
+            params.push(...tables);
+        }
+        query += ` ORDER BY log_id ASC LIMIT ?`;
+        params.push(limit);
+        const entries = await this.adapter.all(query, params);
+        // Filter by vector clock comparison
+        const changes = [];
+        for (const entry of entries) {
+            const entryClock = JSON.parse(entry.vectorClock);
+            // Include if entry's clock is after the since clock
+            if (this.isClockAfter(entryClock, sinceClock)) {
+                changes.push({
+                    changeId: entry.changeId,
+                    table: entry.tableName,
+                    recordId: entry.recordId,
+                    operation: entry.operation,
+                    vectorClock: entryClock,
+                    deviceId: entry.deviceId,
+                    oldData: entry.oldData ? JSON.parse(entry.oldData) : undefined,
+                    newData: entry.newData ? JSON.parse(entry.newData) : undefined,
+                    timestamp: entry.createdAt,
+                });
+            }
+        }
+        return changes;
+    }
+    /**
+     * Mark changes as synced.
+     */
+    async markSynced(changeIds) {
+        if (changeIds.length === 0)
+            return;
+        const placeholders = changeIds.map(() => '?').join(', ');
+        await this.adapter.run(`UPDATE _sync_log SET synced_at = ? WHERE change_id IN (${placeholders})`, [Date.now(), ...changeIds]);
+    }
+    /**
+     * Get unsynced change count.
+     */
+    async getUnsyncedCount() {
+        const result = await this.adapter.get('SELECT COUNT(*) as count FROM _sync_log WHERE synced_at IS NULL');
+        return result?.count ?? 0;
+    }
+    // ============================================================================
+    // Device Registry
+    // ============================================================================
+    /**
+     * Register a device.
+     */
+    async registerDevice(device) {
+        const existing = await this.adapter.get('SELECT * FROM _sync_devices WHERE device_id = ?', [device.deviceId]);
+        const clockData = this.vectorClock.getValues();
+        const now = Date.now();
+        if (existing) {
+            await this.adapter.run(`UPDATE _sync_devices
+         SET device_type = ?, device_name = ?, vector_clock = ?, last_seen_at = ?
+         WHERE device_id = ?`, [device.deviceType, device.deviceName ?? null, JSON.stringify(clockData), now, device.deviceId]);
+        }
+        else {
+            await this.adapter.run(`INSERT INTO _sync_devices (device_id, device_type, device_name, vector_clock, last_seen_at, created_at)
+         VALUES (?, ?, ?, ?, ?, ?)`, [device.deviceId, device.deviceType, device.deviceName ?? null, JSON.stringify(clockData), now, now]);
+        }
+    }
+    /**
+     * Get all registered devices.
+     */
+    async getDevices() {
+        const entries = await this.adapter.all('SELECT * FROM _sync_devices ORDER BY last_seen_at DESC');
+        return entries.map(entry => ({
+            deviceId: entry.deviceId,
+            deviceType: entry.deviceType,
+            deviceName: entry.deviceName ?? undefined,
+            lastSeen: entry.lastSeenAt,
+            firstSeen: entry.createdAt,
+        }));
+    }
+    /**
+     * Update a device's vector clock.
+     */
+    async updateDeviceClockFor(deviceId, clock) {
+        await this.adapter.run('UPDATE _sync_devices SET vector_clock = ?, last_seen_at = ? WHERE device_id = ?', [JSON.stringify(clock), Date.now(), deviceId]);
+        // Merge into our clock
+        this.vectorClock.observe(clock);
+    }
+    // ============================================================================
+    // Conflicts
+    // ============================================================================
+    /**
+     * Record a conflict.
+     */
+    async recordConflict(conflict) {
+        const conflictId = this.generateConflictId();
+        await this.adapter.run(`INSERT INTO _sync_conflicts
+       (conflict_id, table_name, record_id, local_data, remote_data, local_clock, remote_clock, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
+            conflictId,
+            conflict.table,
+            conflict.recordId,
+            JSON.stringify(conflict.localData),
+            JSON.stringify(conflict.remoteData),
+            JSON.stringify(conflict.localClock),
+            JSON.stringify(conflict.remoteClock),
+            Date.now(),
+        ]);
+        return conflictId;
+    }
+    /**
+     * Get pending conflicts.
+     */
+    async getPendingConflicts() {
+        return this.adapter.all("SELECT * FROM _sync_conflicts WHERE status = 'pending' ORDER BY created_at ASC");
+    }
+    /**
+     * Resolve a conflict.
+     */
+    async resolveConflict(conflictId, resolution) {
+        await this.adapter.run("UPDATE _sync_conflicts SET status = 'resolved', resolution = ?, resolved_at = ? WHERE conflict_id = ?", [resolution, Date.now(), conflictId]);
+    }
+    // ============================================================================
+    // Vector Clock
+    // ============================================================================
+    /**
+     * Get current vector clock.
+     */
+    getVectorClock() {
+        return this.vectorClock;
+    }
+    /**
+     * Get vector clock data.
+     */
+    getVectorClockData() {
+        return this.vectorClock.getValues();
+    }
+    /**
+     * Merge a remote clock into ours.
+     */
+    mergeVectorClock(remoteClock) {
+        this.vectorClock.merge(remoteClock);
+    }
+    // ============================================================================
+    // Utilities
+    // ============================================================================
+    /**
+     * Get device ID.
+     */
+    getDeviceId() {
+        return this.deviceId;
+    }
+    /**
+     * Update this device's clock in database.
+     */
+    async updateDeviceClock() {
+        await this.adapter.run('UPDATE _sync_devices SET vector_clock = ?, last_seen_at = ? WHERE device_id = ?', [JSON.stringify(this.vectorClock.getValues()), Date.now(), this.deviceId]);
+    }
+    /**
+     * Check if table should be tracked.
+     */
+    shouldTrackTable(table) {
+        // Exclude sync tables
+        if (this.config.excludeTables.includes(table)) {
+            return false;
+        }
+        // If include list is specified, only track those
+        if (this.config.includeTables.length > 0) {
+            return this.config.includeTables.includes(table);
+        }
+        return true;
+    }
+    /**
+     * Check if clock A is after clock B.
+     */
+    isClockAfter(a, b) {
+        let aGreater = false;
+        let bGreater = false;
+        const allDevices = new Set([...Object.keys(a), ...Object.keys(b)]);
+        for (const deviceId of allDevices) {
+            const aValue = a[deviceId] ?? 0;
+            const bValue = b[deviceId] ?? 0;
+            if (aValue > bValue)
+                aGreater = true;
+            if (bValue > aValue)
+                bGreater = true;
+        }
+        return aGreater && !bGreater;
+    }
+    /**
+     * Generate unique change ID.
+     */
+    generateChangeId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        return `chg_${timestamp}_${random}`;
+    }
+    /**
+     * Generate unique conflict ID.
+     */
+    generateConflictId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        return `cnf_${timestamp}_${random}`;
+    }
+    /**
+     * Detect device type from environment.
+     */
+    detectDeviceType() {
+        // Check for Electron
+        if (typeof process !== 'undefined' && process.versions?.electron) {
+            return 'electron';
+        }
+        // Check for Capacitor
+        if (typeof window !== 'undefined' && window.Capacitor) {
+            return 'capacitor';
+        }
+        // Check for browser
+        if (typeof window !== 'undefined') {
+            return 'browser';
+        }
+        return 'server';
+    }
+    /**
+     * Get device name.
+     */
+    getDeviceName() {
+        if (typeof navigator !== 'undefined') {
+            return navigator.userAgent.split('/')[0];
+        }
+        if (typeof process !== 'undefined') {
+            return process.platform;
+        }
+        return undefined;
+    }
+    /**
+     * Prune old synced entries if over limit.
+     */
+    async pruneIfNeeded() {
+        const count = await this.adapter.get('SELECT COUNT(*) as count FROM _sync_log');
+        if ((count?.count ?? 0) > this.config.maxLogEntries) {
+            // Delete oldest synced entries
+            const deleteCount = (count?.count ?? 0) - this.config.maxLogEntries + 100;
+            await this.adapter.run(`DELETE FROM _sync_log WHERE log_id IN (
+          SELECT log_id FROM _sync_log
+          WHERE synced_at IS NOT NULL
+          ORDER BY log_id ASC
+          LIMIT ?
+        )`, [deleteCount]);
+        }
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a sync log manager.
+ */
+export function createSyncLogManager(adapter, deviceId, config) {
+    return new SyncLogManager(adapter, deviceId, config);
+}
+//# sourceMappingURL=syncLogManager.js.map