@framers/sql-storage-adapter 0.4.2 → 0.5.1

package/dist/features/sync/transport/transport.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Transport Layer Interface.
+ *
+ * Defines the contract for sync transports (WebSocket, HTTP polling, etc.).
+ * Transports handle the low-level communication between sync nodes.
+ *
+ * @packageDocumentation
+ */
+import type { SyncMessage } from '../protocol/messages';
+/**
+ * Transport connection state.
+ */
+export type TransportState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+/**
+ * Transport configuration options.
+ */
+export interface TransportOptions {
+    /** Server endpoint URL */
+    endpoint: string;
+    /** Authentication token or API key */
+    authToken?: string;
+    /** Custom headers for HTTP requests */
+    headers?: Record<string, string>;
+    /** Connection timeout in milliseconds */
+    connectionTimeout?: number;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+    /** Enable automatic reconnection */
+    autoReconnect?: boolean;
+    /** Initial reconnection delay in milliseconds */
+    reconnectDelay?: number;
+    /** Maximum reconnection delay in milliseconds */
+    maxReconnectDelay?: number;
+    /** Maximum reconnection attempts (0 = unlimited) */
+    maxReconnectAttempts?: number;
+    /** Heartbeat interval in milliseconds (0 = disabled) */
+    heartbeatInterval?: number;
+    /** Enable message compression */
+    compression?: boolean;
+}
+/**
+ * Transport event types.
+ */
+export type TransportEventType = 'connected' | 'disconnected' | 'message' | 'error' | 'reconnecting' | 'stateChange';
+/**
+ * Transport event payloads.
+ */
+export interface TransportEvents {
+    connected: {
+        timestamp: number;
+    };
+    disconnected: {
+        reason: string;
+        wasClean: boolean;
+    };
+    message: {
+        message: SyncMessage;
+        receivedAt: number;
+    };
+    error: {
+        error: Error;
+        recoverable: boolean;
+    };
+    reconnecting: {
+        attempt: number;
+        delay: number;
+    };
+    stateChange: {
+        previousState: TransportState;
+        currentState: TransportState;
+    };
+}
+/**
+ * Transport event listener.
+ */
+export type TransportEventListener<T extends TransportEventType> = (event: TransportEvents[T]) => void;
+/**
+ * Transport statistics.
+ */
+export interface TransportStats {
+    /** Current connection state */
+    state: TransportState;
+    /** Time when connection was established (epoch ms) */
+    connectedAt?: number;
+    /** Total messages sent */
+    messagesSent: number;
+    /** Total messages received */
+    messagesReceived: number;
+    /** Total bytes sent */
+    bytesSent: number;
+    /** Total bytes received */
+    bytesReceived: number;
+    /** Number of reconnection attempts */
+    reconnectAttempts: number;
+    /** Average round-trip latency in milliseconds */
+    averageLatency?: number;
+    /** Last error encountered */
+    lastError?: Error;
+}
+/**
+ * Transport interface for sync communication.
+ *
+ * Implementations handle the actual network communication,
+ * allowing the sync engine to be transport-agnostic.
+ *
+ * @example
+ * ```typescript
+ * const transport = new WebSocketTransport({
+ *   endpoint: 'wss://sync.example.com',
+ *   authToken: 'bearer-token',
+ *   autoReconnect: true,
+ * });
+ *
+ * transport.on('message', ({ message }) => {
+ *   console.log('Received:', message);
+ * });
+ *
+ * await transport.connect();
+ * await transport.send(handshakeMessage);
+ * ```
+ */
+export interface SyncTransport {
+    /** Transport type identifier */
+    readonly type: 'websocket' | 'http' | 'custom';
+    /** Current connection state */
+    readonly state: TransportState;
+    /** Whether the transport is currently connected */
+    readonly isConnected: boolean;
+    /**
+     * Connect to the sync server.
+     *
+     * @throws {TransportError} If connection fails
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the sync server.
+     *
+     * @param reason - Optional disconnect reason
+     */
+    disconnect(reason?: string): Promise<void>;
+    /**
+     * Send a message to the sync server.
+     *
+     * @param message - The sync message to send
+     * @returns Promise that resolves when message is sent
+     * @throws {TransportError} If send fails
+     */
+    send(message: SyncMessage): Promise<void>;
+    /**
+     * Send a message and wait for a response.
+     *
+     * @param message - The sync message to send
+     * @param timeout - Optional response timeout in milliseconds
+     * @returns Promise that resolves with the response message
+     * @throws {TransportError} If send fails or times out
+     */
+    request(message: SyncMessage, timeout?: number): Promise<SyncMessage>;
+    /**
+     * Register an event listener.
+     *
+     * @param event - Event type to listen for
+     * @param listener - Callback function
+     * @returns Unsubscribe function
+     */
+    on<T extends TransportEventType>(event: T, listener: TransportEventListener<T>): () => void;
+    /**
+     * Register a one-time event listener.
+     *
+     * @param event - Event type to listen for
+     * @param listener - Callback function
+     * @returns Unsubscribe function
+     */
+    once<T extends TransportEventType>(event: T, listener: TransportEventListener<T>): () => void;
+    /**
+     * Get transport statistics.
+     */
+    getStats(): TransportStats;
+    /**
+     * Dispose of the transport and release resources.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Transport error with additional context.
+ */
+export declare class TransportError extends Error {
+    /** Error code for categorization */
+    readonly code: string;
+    /** Whether the error is recoverable */
+    readonly recoverable: boolean;
+    /** Original error if wrapping another error */
+    readonly cause?: Error;
+    constructor(message: string, code: string, options?: {
+        recoverable?: boolean;
+        cause?: Error;
+    });
+}
+/**
+ * Common transport error codes.
+ */
+export declare const TransportErrorCodes: {
+    /** Connection failed */
+    readonly CONNECTION_FAILED: "CONNECTION_FAILED";
+    /** Connection timeout */
+    readonly CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT";
+    /** Authentication failed */
+    readonly AUTH_FAILED: "AUTH_FAILED";
+    /** Request timeout */
+    readonly REQUEST_TIMEOUT: "REQUEST_TIMEOUT";
+    /** Send failed */
+    readonly SEND_FAILED: "SEND_FAILED";
+    /** Server error */
+    readonly SERVER_ERROR: "SERVER_ERROR";
+    /** Network error */
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    /** Protocol error */
+    readonly PROTOCOL_ERROR: "PROTOCOL_ERROR";
+    /** Transport disposed */
+    readonly DISPOSED: "DISPOSED";
+};
+/**
+ * Base transport implementation with common functionality.
+ */
+export declare abstract class BaseTransport implements SyncTransport {
+    abstract readonly type: 'websocket' | 'http' | 'custom';
+    protected _state: TransportState;
+    protected _stats: TransportStats;
+    protected _options: Required<TransportOptions>;
+    protected _disposed: boolean;
+    private _listeners;
+    constructor(options: TransportOptions);
+    get state(): TransportState;
+    get isConnected(): boolean;
+    abstract connect(): Promise<void>;
+    abstract disconnect(reason?: string): Promise<void>;
+    abstract send(message: SyncMessage): Promise<void>;
+    abstract request(message: SyncMessage, timeout?: number): Promise<SyncMessage>;
+    on<T extends TransportEventType>(event: T, listener: TransportEventListener<T>): () => void;
+    once<T extends TransportEventType>(event: T, listener: TransportEventListener<T>): () => void;
+    getStats(): TransportStats;
+    dispose(): Promise<void>;
+    /**
+     * Emit an event to all registered listeners.
+     */
+    protected emit<T extends TransportEventType>(event: T, data: TransportEvents[T]): void;
+    /**
+     * Update transport state and emit event.
+     */
+    protected setState(newState: TransportState): void;
+    /**
+     * Check if transport is disposed and throw if so.
+     */
+    protected checkDisposed(): void;
+    /**
+     * Calculate next reconnection delay with exponential backoff.
+     */
+    protected calculateReconnectDelay(attempt: number): number;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/features/sync/transport/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/features/sync/transport/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,cAAc,GACd,SAAS,GACT,OAAO,GACP,cAAc,GACd,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACpD,OAAO,EAAE;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,WAAW,EAAE;QAAE,aAAa,EAAE,cAAc,CAAC;QAAC,YAAY,EAAE,cAAc,CAAA;KAAE,CAAC;CAC9E;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,kBAAkB,IAAI,CACjE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KACtB,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,KAAK,EAAE,cAAc,CAAC;IAEtB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IAEtB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;IAE/C,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;OAIG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEtE;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAC7B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,MAAM,IAAI,CAAC;IAEd;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,SAAS,kBAAkB,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,MAAM,IAAI,CAAC;IAEd;;OAEG;IACH,QAAQ,IAAI,cAAc,CAAC;IAE3B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAQrD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,wBAAwB;;IAGxB,yBAAyB;;IAGzB,4BAA4B;;IAG5B,sBAAsB;;IAGtB,kBAAkB;;IAGlB,mBAAmB;;IAGnB,oBAAoB;;IAGpB,qBAAqB;;IAGrB,yBAAyB;;CAEjB,CAAC;AAEX;;GAEG;AACH,8BAAsB,aAAc,YAAW,aAAa;IAC1D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;IAExD,SAAS,CAAC,MAAM,EAAE,cAAc,CAAkB;IAClD,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;IACjC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC/C,SAAS,CAAC,SAAS,UAAS;IAE5B,OAAO,CAAC,UAAU,CAAuF;gBAE7F,OAAO,EAAE,gBAAgB;IAyBrC,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAE9E,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAC7B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,MAAM,IAAI;IAab,IAAI,CAAC,CAAC,SAAS,kBAAkB,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,MAAM,IAAI;IAUb,QAAQ,IAAI,cAAc;IAIpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,kBAAkB,EACzC,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,IAAI;IAaP;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAUlD;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,IAAI;IAU/B;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAU3D"}

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

@@ -0,0 +1,153 @@
+/**
+ * Transport Layer Interface.
+ *
+ * Defines the contract for sync transports (WebSocket, HTTP polling, etc.).
+ * Transports handle the low-level communication between sync nodes.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Transport error with additional context.
+ */
+export class TransportError extends Error {
+    constructor(message, code, options) {
+        super(message);
+        this.name = 'TransportError';
+        this.code = code;
+        this.recoverable = options?.recoverable ?? false;
+        this.cause = options?.cause;
+    }
+}
+/**
+ * Common transport error codes.
+ */
+export const TransportErrorCodes = {
+    /** Connection failed */
+    CONNECTION_FAILED: 'CONNECTION_FAILED',
+    /** Connection timeout */
+    CONNECTION_TIMEOUT: 'CONNECTION_TIMEOUT',
+    /** Authentication failed */
+    AUTH_FAILED: 'AUTH_FAILED',
+    /** Request timeout */
+    REQUEST_TIMEOUT: 'REQUEST_TIMEOUT',
+    /** Send failed */
+    SEND_FAILED: 'SEND_FAILED',
+    /** Server error */
+    SERVER_ERROR: 'SERVER_ERROR',
+    /** Network error */
+    NETWORK_ERROR: 'NETWORK_ERROR',
+    /** Protocol error */
+    PROTOCOL_ERROR: 'PROTOCOL_ERROR',
+    /** Transport disposed */
+    DISPOSED: 'DISPOSED',
+};
+/**
+ * Base transport implementation with common functionality.
+ */
+export class BaseTransport {
+    constructor(options) {
+        this._state = 'disconnected';
+        this._disposed = false;
+        this._listeners = new Map();
+        this._options = {
+            endpoint: options.endpoint,
+            authToken: options.authToken ?? '',
+            headers: options.headers ?? {},
+            connectionTimeout: options.connectionTimeout ?? 10000,
+            requestTimeout: options.requestTimeout ?? 30000,
+            autoReconnect: options.autoReconnect ?? true,
+            reconnectDelay: options.reconnectDelay ?? 1000,
+            maxReconnectDelay: options.maxReconnectDelay ?? 30000,
+            maxReconnectAttempts: options.maxReconnectAttempts ?? 0,
+            heartbeatInterval: options.heartbeatInterval ?? 30000,
+            compression: options.compression ?? true,
+        };
+        this._stats = {
+            state: 'disconnected',
+            messagesSent: 0,
+            messagesReceived: 0,
+            bytesSent: 0,
+            bytesReceived: 0,
+            reconnectAttempts: 0,
+        };
+    }
+    get state() {
+        return this._state;
+    }
+    get isConnected() {
+        return this._state === 'connected';
+    }
+    on(event, listener) {
+        if (!this._listeners.has(event)) {
+            this._listeners.set(event, new Set());
+        }
+        const listeners = this._listeners.get(event);
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    once(event, listener) {
+        const wrapper = (eventData) => {
+            unsubscribe();
+            listener(eventData);
+        };
+        const unsubscribe = this.on(event, wrapper);
+        return unsubscribe;
+    }
+    getStats() {
+        return { ...this._stats, state: this._state };
+    }
+    async dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        await this.disconnect('disposed');
+        this._listeners.clear();
+    }
+    /**
+     * Emit an event to all registered listeners.
+     */
+    emit(event, data) {
+        const listeners = this._listeners.get(event);
+        if (!listeners)
+            return;
+        for (const listener of listeners) {
+            try {
+                listener(data);
+            }
+            catch (error) {
+                console.error(`[Transport] Error in ${event} listener:`, error);
+            }
+        }
+    }
+    /**
+     * Update transport state and emit event.
+     */
+    setState(newState) {
+        if (this._state === newState)
+            return;
+        const previousState = this._state;
+        this._state = newState;
+        this._stats.state = newState;
+        this.emit('stateChange', { previousState, currentState: newState });
+    }
+    /**
+     * Check if transport is disposed and throw if so.
+     */
+    checkDisposed() {
+        if (this._disposed) {
+            throw new TransportError('Transport has been disposed', TransportErrorCodes.DISPOSED, { recoverable: false });
+        }
+    }
+    /**
+     * Calculate next reconnection delay with exponential backoff.
+     */
+    calculateReconnectDelay(attempt) {
+        const delay = Math.min(this._options.reconnectDelay * Math.pow(2, attempt - 1), this._options.maxReconnectDelay);
+        // Add jitter (±20%)
+        const jitter = delay * 0.2 * (Math.random() * 2 - 1);
+        return Math.floor(delay + jitter);
+    }
+}
+//# sourceMappingURL=transport.js.map

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

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

package/dist/features/sync/transport/websocketTransport.d.ts

@@ -0,0 +1,126 @@
+/**
+ * WebSocket Transport Implementation.
+ *
+ * Real-time bidirectional sync transport using WebSockets.
+ * Supports automatic reconnection, heartbeats, and message compression.
+ *
+ * @packageDocumentation
+ */
+import { BaseTransport, type TransportOptions } from './transport';
+import type { SyncMessage } from '../protocol/messages';
+/**
+ * WebSocket-specific transport options.
+ */
+export interface WebSocketTransportOptions extends TransportOptions {
+    /** WebSocket protocols to use */
+    protocols?: string[];
+    /** Binary message format */
+    binaryType?: 'arraybuffer' | 'blob';
+    /** Enable ping/pong heartbeats */
+    pingPong?: boolean;
+}
+/**
+ * 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 declare class WebSocketTransport extends BaseTransport {
+    readonly type: "websocket";
+    private _ws;
+    private _heartbeatTimer;
+    private _reconnectTimer;
+    private _pendingRequests;
+    private _wsOptions;
+    private _lastPongAt;
+    private _shouldReconnect;
+    constructor(options: WebSocketTransportOptions);
+    /**
+     * Connect to the WebSocket server.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the WebSocket server.
+     */
+    disconnect(reason?: string): Promise<void>;
+    /**
+     * Send a sync message.
+     */
+    send(message: SyncMessage): Promise<void>;
+    /**
+     * Send a message and wait for a response.
+     */
+    request(message: SyncMessage, timeout?: number): Promise<SyncMessage>;
+    /**
+     * Create WebSocket connection.
+     */
+    private _createConnection;
+    /**
+     * Build WebSocket URL with auth token.
+     */
+    private _buildUrl;
+    /**
+     * Handle incoming WebSocket message.
+     */
+    private _handleMessage;
+    /**
+     * Handle WebSocket close event.
+     */
+    private _handleClose;
+    /**
+     * Schedule reconnection attempt.
+     */
+    private _scheduleReconnect;
+    /**
+     * Start heartbeat timer.
+     */
+    private _startHeartbeat;
+    /**
+     * Stop heartbeat timer.
+     */
+    private _stopHeartbeat;
+    /**
+     * Clear all timers.
+     */
+    private _clearTimers;
+    /**
+     * Reject all pending requests.
+     */
+    private _rejectAllPending;
+    /**
+     * Serialize message for transmission.
+     */
+    private _serialize;
+    /**
+     * Deserialize received message.
+     */
+    private _deserialize;
+    /**
+     * Dispose of the transport.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Create a WebSocket transport instance.
+ */
+export declare const createWebSocketTransport: (options: WebSocketTransportOptions) => WebSocketTransport;
+//# sourceMappingURL=websocketTransport.d.ts.map

package/dist/features/sync/transport/websocketTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocketTransport.d.ts","sourceRoot":"","sources":["../../../../src/features/sync/transport/websocketTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,aAAa,EAGb,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAEpC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,QAAQ,CAAC,IAAI,cAAwB;IAErC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,EAAE,yBAAyB;IAW9C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;IACG,UAAU,CAAC,MAAM,SAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7D;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/C;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0B3E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkEzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6DtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,YAC1B,yBAAyB,KACjC,kBAEF,CAAC"}