@framers/sql-storage-adapter 0.4.2 → 0.5.1

package/dist/features/sync/transport/websocketTransport.js

@@ -0,0 +1,374 @@
+/**
+ * WebSocket Transport Implementation.
+ *
+ * Real-time bidirectional sync transport using WebSockets.
+ * Supports automatic reconnection, heartbeats, and message compression.
+ *
+ * @packageDocumentation
+ */
+import { BaseTransport, TransportError, TransportErrorCodes, } from './transport.js';
+import { isSyncMessage, createHeartbeatMessage, createAckMessage } from '../protocol/messages.js';
+/**
+ * WebSocket transport for real-time sync.
+ *
+ * Provides low-latency bidirectional communication with:
+ * - Automatic reconnection with exponential backoff
+ * - Request/response correlation
+ * - Heartbeat keep-alive
+ * - Message compression (gzip)
+ *
+ * @example
+ * ```typescript
+ * const transport = new WebSocketTransport({
+ *   endpoint: 'wss://sync.example.com/v1/sync',
+ *   authToken: 'bearer-token',
+ *   autoReconnect: true,
+ *   heartbeatInterval: 30000,
+ * });
+ *
+ * transport.on('message', ({ message }) => {
+ *   handleSyncMessage(message);
+ * });
+ *
+ * await transport.connect();
+ * ```
+ */
+export class WebSocketTransport extends BaseTransport {
+    constructor(options) {
+        super(options);
+        this.type = 'websocket';
+        this._ws = null;
+        this._heartbeatTimer = null;
+        this._reconnectTimer = null;
+        this._pendingRequests = new Map();
+        this._lastPongAt = 0;
+        this._shouldReconnect = false;
+        this._wsOptions = {
+            ...this._options,
+            protocols: options.protocols ?? ['sync-v1'],
+            binaryType: options.binaryType ?? 'arraybuffer',
+            pingPong: options.pingPong ?? true,
+        };
+    }
+    /**
+     * Connect to the WebSocket server.
+     */
+    async connect() {
+        this.checkDisposed();
+        if (this._state === 'connected' || this._state === 'connecting') {
+            return;
+        }
+        this.setState('connecting');
+        this._shouldReconnect = this._options.autoReconnect;
+        try {
+            await this._createConnection();
+        }
+        catch (error) {
+            this.setState('error');
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from the WebSocket server.
+     */
+    async disconnect(reason = 'client disconnect') {
+        this._shouldReconnect = false;
+        this._clearTimers();
+        this._rejectAllPending(new TransportError('Disconnected', TransportErrorCodes.DISPOSED, { recoverable: false }));
+        if (this._ws) {
+            try {
+                this._ws.close(1000, reason);
+            }
+            catch {
+                // Ignore close errors
+            }
+            this._ws = null;
+        }
+        this.setState('disconnected');
+        this.emit('disconnected', { reason, wasClean: true });
+    }
+    /**
+     * Send a sync message.
+     */
+    async send(message) {
+        this.checkDisposed();
+        if (!this._ws || this._state !== 'connected') {
+            throw new TransportError('Not connected', TransportErrorCodes.SEND_FAILED, { recoverable: true });
+        }
+        const data = this._serialize(message);
+        try {
+            this._ws.send(data);
+            this._stats.messagesSent++;
+            this._stats.bytesSent += data.length;
+        }
+        catch (error) {
+            throw new TransportError('Failed to send message', TransportErrorCodes.SEND_FAILED, { recoverable: true, cause: error });
+        }
+    }
+    /**
+     * Send a message and wait for a response.
+     */
+    async request(message, timeout) {
+        this.checkDisposed();
+        const requestId = message.messageId;
+        const timeoutMs = timeout ?? this._options.requestTimeout;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pendingRequests.delete(requestId);
+                reject(new TransportError('Request timed out', TransportErrorCodes.REQUEST_TIMEOUT, { recoverable: true }));
+            }, timeoutMs);
+            this._pendingRequests.set(requestId, { resolve, reject, timer });
+            this.send(message).catch((error) => {
+                clearTimeout(timer);
+                this._pendingRequests.delete(requestId);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Create WebSocket connection.
+     */
+    _createConnection() {
+        return new Promise((resolve, reject) => {
+            const url = this._buildUrl();
+            const timeout = setTimeout(() => {
+                reject(new TransportError('Connection timed out', TransportErrorCodes.CONNECTION_TIMEOUT, { recoverable: true }));
+            }, this._options.connectionTimeout);
+            try {
+                this._ws = new WebSocket(url, this._wsOptions.protocols);
+                this._ws.binaryType = this._wsOptions.binaryType;
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                reject(new TransportError('Failed to create WebSocket', TransportErrorCodes.CONNECTION_FAILED, { recoverable: true, cause: error }));
+                return;
+            }
+            this._ws.onopen = () => {
+                clearTimeout(timeout);
+                this.setState('connected');
+                this._stats.connectedAt = Date.now();
+                this._stats.reconnectAttempts = 0;
+                this._startHeartbeat();
+                this.emit('connected', { timestamp: Date.now() });
+                resolve();
+            };
+            this._ws.onclose = (event) => {
+                clearTimeout(timeout);
+                this._handleClose(event);
+                if (this._state === 'connecting') {
+                    reject(new TransportError(`Connection closed: ${event.reason || 'unknown'}`, TransportErrorCodes.CONNECTION_FAILED, { recoverable: true }));
+                }
+            };
+            this._ws.onerror = (event) => {
+                const error = new TransportError('WebSocket error', TransportErrorCodes.NETWORK_ERROR, { recoverable: true });
+                this.emit('error', { error, recoverable: true });
+                // Note: onclose will be called after onerror
+                console.error('[WebSocketTransport] Connection error:', event);
+            };
+            this._ws.onmessage = (event) => {
+                this._handleMessage(event);
+            };
+        });
+    }
+    /**
+     * Build WebSocket URL with auth token.
+     */
+    _buildUrl() {
+        const url = new URL(this._options.endpoint);
+        // Add auth token as query parameter if provided
+        if (this._options.authToken) {
+            url.searchParams.set('token', this._options.authToken);
+        }
+        return url.toString();
+    }
+    /**
+     * Handle incoming WebSocket message.
+     */
+    _handleMessage(event) {
+        try {
+            const message = this._deserialize(event.data);
+            if (!isSyncMessage(message)) {
+                console.warn('[WebSocketTransport] Received invalid message:', message);
+                return;
+            }
+            this._stats.messagesReceived++;
+            this._stats.bytesReceived += typeof event.data === 'string'
+                ? event.data.length
+                : event.data.byteLength;
+            // Handle heartbeat responses
+            if (message.type === 'heartbeat') {
+                this._lastPongAt = Date.now();
+                // Send ack for heartbeat
+                this.send(createAckMessage(message.messageId, this._options.authToken || 'device'))
+                    .catch(() => { });
+                return;
+            }
+            // Handle ack messages - resolve pending requests
+            if (message.type === 'ack') {
+                const pending = this._pendingRequests.get(message.ackMessageId);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    this._pendingRequests.delete(message.ackMessageId);
+                    pending.resolve(message);
+                }
+                return;
+            }
+            // Check if this is a response to a pending request
+            if ('inResponseTo' in message && message.inResponseTo) {
+                const pending = this._pendingRequests.get(message.inResponseTo);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    this._pendingRequests.delete(message.inResponseTo);
+                    pending.resolve(message);
+                    return;
+                }
+            }
+            // Emit message for general handling
+            this.emit('message', { message, receivedAt: Date.now() });
+        }
+        catch (error) {
+            console.error('[WebSocketTransport] Failed to process message:', error);
+            this.emit('error', {
+                error: new TransportError('Failed to process message', TransportErrorCodes.PROTOCOL_ERROR, { recoverable: true, cause: error }),
+                recoverable: true,
+            });
+        }
+    }
+    /**
+     * Handle WebSocket close event.
+     */
+    _handleClose(event) {
+        this._stopHeartbeat();
+        const wasConnected = this._state === 'connected';
+        const wasClean = event.wasClean;
+        const reason = event.reason || `Code: ${event.code}`;
+        this.emit('disconnected', { reason, wasClean });
+        // Reject all pending requests
+        this._rejectAllPending(new TransportError('Connection closed', TransportErrorCodes.NETWORK_ERROR, { recoverable: this._shouldReconnect }));
+        // Attempt reconnection if enabled
+        if (this._shouldReconnect && wasConnected) {
+            this._scheduleReconnect();
+        }
+        else {
+            this.setState('disconnected');
+        }
+    }
+    /**
+     * Schedule reconnection attempt.
+     */
+    _scheduleReconnect() {
+        if (!this._shouldReconnect || this._disposed)
+            return;
+        const maxAttempts = this._options.maxReconnectAttempts;
+        if (maxAttempts > 0 && this._stats.reconnectAttempts >= maxAttempts) {
+            console.warn('[WebSocketTransport] Max reconnection attempts reached');
+            this.setState('error');
+            return;
+        }
+        this._stats.reconnectAttempts++;
+        const delay = this.calculateReconnectDelay(this._stats.reconnectAttempts);
+        this.setState('reconnecting');
+        this.emit('reconnecting', {
+            attempt: this._stats.reconnectAttempts,
+            delay,
+        });
+        this._reconnectTimer = setTimeout(async () => {
+            if (!this._shouldReconnect || this._disposed)
+                return;
+            try {
+                await this._createConnection();
+            }
+            catch (error) {
+                console.warn('[WebSocketTransport] Reconnection failed:', error);
+                this._scheduleReconnect();
+            }
+        }, delay);
+    }
+    /**
+     * Start heartbeat timer.
+     */
+    _startHeartbeat() {
+        if (!this._wsOptions.pingPong || this._options.heartbeatInterval <= 0) {
+            return;
+        }
+        this._lastPongAt = Date.now();
+        this._heartbeatTimer = setInterval(() => {
+            if (!this._ws || this._state !== 'connected')
+                return;
+            // Check if we missed too many heartbeats
+            const missedTime = Date.now() - this._lastPongAt;
+            if (missedTime > this._options.heartbeatInterval * 3) {
+                console.warn('[WebSocketTransport] Heartbeat timeout, reconnecting...');
+                this._ws.close(4000, 'Heartbeat timeout');
+                return;
+            }
+            // Send heartbeat
+            const heartbeat = createHeartbeatMessage(this._options.authToken || 'device');
+            this.send(heartbeat).catch((error) => {
+                console.warn('[WebSocketTransport] Failed to send heartbeat:', error);
+            });
+        }, this._options.heartbeatInterval);
+    }
+    /**
+     * Stop heartbeat timer.
+     */
+    _stopHeartbeat() {
+        if (this._heartbeatTimer) {
+            clearInterval(this._heartbeatTimer);
+            this._heartbeatTimer = null;
+        }
+    }
+    /**
+     * Clear all timers.
+     */
+    _clearTimers() {
+        this._stopHeartbeat();
+        if (this._reconnectTimer) {
+            clearTimeout(this._reconnectTimer);
+            this._reconnectTimer = null;
+        }
+    }
+    /**
+     * Reject all pending requests.
+     */
+    _rejectAllPending(error) {
+        for (const [id, pending] of this._pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this._pendingRequests.clear();
+    }
+    /**
+     * Serialize message for transmission.
+     */
+    _serialize(message) {
+        // For now, use JSON. Could add compression/binary later.
+        return JSON.stringify(message);
+    }
+    /**
+     * Deserialize received message.
+     */
+    _deserialize(data) {
+        if (typeof data === 'string') {
+            return JSON.parse(data);
+        }
+        // Handle binary (ArrayBuffer)
+        const decoder = new TextDecoder();
+        const text = decoder.decode(data);
+        return JSON.parse(text);
+    }
+    /**
+     * Dispose of the transport.
+     */
+    async dispose() {
+        this._shouldReconnect = false;
+        await super.dispose();
+    }
+}
+/**
+ * Create a WebSocket transport instance.
+ */
+export const createWebSocketTransport = (options) => {
+    return new WebSocketTransport(options);
+};
+//# sourceMappingURL=websocketTransport.js.map

package/dist/features/sync/transport/websocketTransport.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAG9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAG5C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAQ9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAM5C,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -11,12 +11,18 @@ export * from './adapters/capacitorSqliteAdapter.js';
 export * from './adapters/postgresAdapter.js';
 export * from './adapters/supabase.js';
 export * from './adapters/baseStorageAdapter.js';
+// Note: Electron adapter is available via separate entry point to avoid
+// bundling Electron dependencies in non-Electron builds.
+// Usage: import { createElectronMainAdapter, createElectronRendererAdapter } from '@framers/sql-storage-adapter/electron';
+// Preload: import '@framers/sql-storage-adapter/electron/preload';
 // Feature modules ------------------------------------------------------------
 export * from './features/backup/cloudBackup.js';
 export * from './features/migrations/dataExport.js';
 export * from './features/migrations/dataImport.js';
 export * from './features/migrations/migration.js';
 export * from './features/sync/syncManager.js';
+// Note: Cross-platform sync is available via separate entry point for cleaner imports.
+// Usage: import { createCrossPlatformSync } from '@framers/sql-storage-adapter/sync';
 // Shared utilities -----------------------------------------------------------
 export * from './shared/parameterUtils.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc,SAAS,CAAC;AAExB,8EAA8E;AAC9E,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,+EAA+E;AAC/E,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,+EAA+E;AAC/E,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAE5C,+EAA+E;AAC/E,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc,SAAS,CAAC;AAExB,8EAA8E;AAC9E,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,+EAA+E;AAC/E,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,wEAAwE;AACxE,yDAAyD;AACzD,2HAA2H;AAC3H,mEAAmE;AAEnE,+EAA+E;AAC/E,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAE5C,uFAAuF;AACvF,sFAAsF;AAEtF,+EAA+E;AAC/E,cAAc,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/sql-storage-adapter",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "Robust cross-platform SQL storage abstraction with automatic fallbacks and runtime detection",
   "type": "module",
   "main": "dist/index.js",
@@ -17,6 +17,21 @@
       "import": "./dist/types/index.js",
       "default": "./dist/types/index.js"
     },
+    "./electron": {
+      "types": "./dist/adapters/electron/index.d.ts",
+      "import": "./dist/adapters/electron/index.js",
+      "default": "./dist/adapters/electron/index.js"
+    },
+    "./electron/preload": {
+      "types": "./dist/adapters/electron/preload.d.ts",
+      "import": "./dist/adapters/electron/preload.js",
+      "default": "./dist/adapters/electron/preload.js"
+    },
+    "./sync": {
+      "types": "./dist/features/sync/index.d.ts",
+      "import": "./dist/features/sync/index.js",
+      "default": "./dist/features/sync/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -74,6 +89,7 @@
   "sideEffects": false,
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.709.0",
+    "electron": "^33.0.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.0",
     "@semantic-release/git": "^10.0.1",
@@ -106,6 +122,7 @@
     "@aws-sdk/client-s3": "^3.0.0",
     "@capacitor-community/sqlite": "^6.0.0",
     "better-sqlite3": "^12.0.0",
+    "electron": ">=20.0.0",
     "pg": "^8.13.1"
   },
   "peerDependenciesMeta": {
@@ -118,6 +135,9 @@
     "better-sqlite3": {
       "optional": true
     },
+    "electron": {
+      "optional": true
+    },
     "pg": {
       "optional": true
     }