@quereus/sync-client 0.1.1

package/dist/src/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @quereus/sync-client - WebSocket sync client for Quereus
+ *
+ * This package provides a WebSocket-based sync client that connects to a
+ * sync server and handles bidirectional synchronization of changes.
+ *
+ * Features:
+ * - Automatic reconnection with exponential backoff
+ * - Local change batching with debouncing
+ * - Delta sync tracking (only send/receive changes since last sync)
+ * - Event callbacks for status changes, remote changes, and errors
+ *
+ * @example
+ * ```typescript
+ * import { SyncClient } from '@quereus/sync-client';
+ *
+ * const client = new SyncClient({
+ *   syncManager,
+ *   onStatusChange: (status) => console.log('Status:', status),
+ *   onRemoteChanges: (result) => console.log('Applied:', result.applied),
+ * });
+ *
+ * await client.connect('ws://localhost:8080/sync');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { SyncClient } from './sync-client.js';
+export { serializeChangeSet, deserializeChangeSet, serializeHLCForTransport, deserializeHLCFromTransport, } from './serialization.js';
+export type { SyncStatus, SyncEvent, SyncEventType, SyncClientOptions, SerializedChangeSet, SerializedChange, SerializedSchemaMigration, ClientMessage, ServerMessage, HandshakeMessage, HandshakeAckMessage, GetChangesMessage, ChangesMessage, PushChangesMessage, ApplyChangesMessage, ApplyResultMessage, GetSnapshotMessage, PingMessage, PongMessage, ErrorMessage, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EAEzB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,30 @@
+/**
+ * @quereus/sync-client - WebSocket sync client for Quereus
+ *
+ * This package provides a WebSocket-based sync client that connects to a
+ * sync server and handles bidirectional synchronization of changes.
+ *
+ * Features:
+ * - Automatic reconnection with exponential backoff
+ * - Local change batching with debouncing
+ * - Delta sync tracking (only send/receive changes since last sync)
+ * - Event callbacks for status changes, remote changes, and errors
+ *
+ * @example
+ * ```typescript
+ * import { SyncClient } from '@quereus/sync-client';
+ *
+ * const client = new SyncClient({
+ *   syncManager,
+ *   onStatusChange: (status) => console.log('Status:', status),
+ *   onRemoteChanges: (result) => console.log('Applied:', result.applied),
+ * });
+ *
+ * await client.connect('ws://localhost:8080/sync');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { SyncClient } from './sync-client.js';
+export { serializeChangeSet, deserializeChangeSet, serializeHLCForTransport, deserializeHLCFromTransport, } from './serialization.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC"}

package/dist/src/serialization.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Serialization helpers for ChangeSet transport over JSON.
+ *
+ * - SiteIds use base64url encoding (via siteIdToBase64/siteIdFromBase64)
+ * - HLCs use standard base64 encoding (via btoa/atob in browser, Buffer in Node)
+ */
+import { type ChangeSet, type HLC } from '@quereus/plugin-sync';
+import type { SerializedChangeSet } from './types.js';
+/**
+ * Serialize a ChangeSet for JSON transport.
+ *
+ * @param cs - The ChangeSet to serialize
+ * @returns A JSON-serializable object
+ */
+export declare function serializeChangeSet(cs: ChangeSet): SerializedChangeSet;
+/**
+ * Deserialize a ChangeSet from JSON transport format.
+ *
+ * @param obj - The serialized ChangeSet object
+ * @returns The deserialized ChangeSet
+ */
+export declare function deserializeChangeSet(obj: SerializedChangeSet): ChangeSet;
+/**
+ * Serialize an HLC for transport (base64 encoding).
+ *
+ * @param hlc - The HLC to serialize
+ * @returns Base64-encoded string
+ */
+export declare function serializeHLCForTransport(hlc: HLC): string;
+/**
+ * Deserialize an HLC from transport format.
+ *
+ * @param str - Base64-encoded HLC string
+ * @returns The deserialized HLC
+ */
+export declare function deserializeHLCFromTransport(str: string): HLC;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/src/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/serialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAKL,KAAK,SAAS,EAGd,KAAK,GAAG,EACT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAkCtD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,SAAS,GAAG,mBAAmB,CAcrE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB,GAAG,SAAS,CAcxE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAE5D"}

package/dist/src/serialization.js

@@ -0,0 +1,96 @@
+/**
+ * Serialization helpers for ChangeSet transport over JSON.
+ *
+ * - SiteIds use base64url encoding (via siteIdToBase64/siteIdFromBase64)
+ * - HLCs use standard base64 encoding (via btoa/atob in browser, Buffer in Node)
+ */
+import { serializeHLC, deserializeHLC, siteIdToBase64, siteIdFromBase64, } from '@quereus/plugin-sync';
+// ============================================================================
+// Base64 helpers (work in both browser and Node.js)
+// ============================================================================
+/**
+ * Encode bytes to base64 string.
+ */
+function bytesToBase64(bytes) {
+    // Browser: use btoa
+    if (typeof btoa === 'function') {
+        return btoa(String.fromCharCode(...bytes));
+    }
+    // Node.js: use Buffer
+    return Buffer.from(bytes).toString('base64');
+}
+/**
+ * Decode base64 string to bytes.
+ */
+function base64ToBytes(str) {
+    // Browser: use atob
+    if (typeof atob === 'function') {
+        return Uint8Array.from(atob(str), c => c.charCodeAt(0));
+    }
+    // Node.js: use Buffer
+    return new Uint8Array(Buffer.from(str, 'base64'));
+}
+// ============================================================================
+// ChangeSet Serialization
+// ============================================================================
+/**
+ * Serialize a ChangeSet for JSON transport.
+ *
+ * @param cs - The ChangeSet to serialize
+ * @returns A JSON-serializable object
+ */
+export function serializeChangeSet(cs) {
+    return {
+        siteId: siteIdToBase64(cs.siteId),
+        transactionId: cs.transactionId,
+        hlc: bytesToBase64(serializeHLC(cs.hlc)),
+        changes: cs.changes.map(c => ({
+            ...c,
+            hlc: bytesToBase64(serializeHLC(c.hlc)),
+        })),
+        schemaMigrations: cs.schemaMigrations.map(m => ({
+            ...m,
+            hlc: bytesToBase64(serializeHLC(m.hlc)),
+        })),
+    };
+}
+/**
+ * Deserialize a ChangeSet from JSON transport format.
+ *
+ * @param obj - The serialized ChangeSet object
+ * @returns The deserialized ChangeSet
+ */
+export function deserializeChangeSet(obj) {
+    return {
+        siteId: siteIdFromBase64(obj.siteId),
+        transactionId: obj.transactionId,
+        hlc: deserializeHLC(base64ToBytes(obj.hlc)),
+        changes: obj.changes.map(c => ({
+            ...c,
+            hlc: deserializeHLC(base64ToBytes(c.hlc)),
+        })),
+        schemaMigrations: obj.schemaMigrations.map(m => ({
+            ...m,
+            hlc: deserializeHLC(base64ToBytes(m.hlc)),
+        })),
+    };
+}
+/**
+ * Serialize an HLC for transport (base64 encoding).
+ *
+ * @param hlc - The HLC to serialize
+ * @returns Base64-encoded string
+ */
+export function serializeHLCForTransport(hlc) {
+    return bytesToBase64(serializeHLC(hlc));
+}
+/**
+ * Deserialize an HLC from transport format.
+ *
+ * @param str - Base64-encoded HLC string
+ * @returns The deserialized HLC
+ */
+export function deserializeHLCFromTransport(str) {
+    return deserializeHLC(base64ToBytes(str));
+}
+//# sourceMappingURL=serialization.js.map

package/dist/src/serialization.js.map

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

package/dist/src/sync-client.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SyncClient - WebSocket-based sync client for Quereus.
+ *
+ * Handles:
+ * - WebSocket connection and handshake
+ * - Message dispatch (changes, push_changes, apply_result, error, pong)
+ * - Reconnection with exponential backoff
+ * - Local change debouncing
+ * - Delta sync tracking (lastSentHLC, pendingSentHLC)
+ */
+import type { SyncClientOptions, SyncStatus } from './types.js';
+/**
+ * WebSocket sync client for Quereus.
+ *
+ * Connects to a sync server and handles bidirectional synchronization
+ * of changes with automatic reconnection and local change batching.
+ */
+export declare class SyncClient {
+    private readonly syncManager;
+    private readonly syncEvents;
+    private readonly options;
+    private ws;
+    private serverSiteId;
+    private _status;
+    private connectionUrl;
+    private connectionToken;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private intentionalDisconnect;
+    private lastSentHLC;
+    private pendingSentHLC;
+    private debounceTimer;
+    private pendingLocalChangeCount;
+    private localChangeUnsubscribe;
+    constructor(options: SyncClientOptions);
+    /** Current connection status */
+    get status(): SyncStatus;
+    /** Whether the client is connected and synced */
+    get isConnected(): boolean;
+    /** Whether the client is fully synced */
+    get isSynced(): boolean;
+    /**
+     * Connect to a sync server.
+     *
+     * @param url - WebSocket URL of the sync server
+     * @param token - Optional authentication token
+     * @returns Promise that resolves when connected (not yet synced)
+     */
+    connect(url: string, token?: string): Promise<void>;
+    /**
+     * Disconnect from the sync server.
+     * Stops reconnection attempts.
+     */
+    disconnect(): Promise<void>;
+    private handleMessage;
+    private handleHandshakeAck;
+    private handleChanges;
+    private handleApplyResult;
+    private sendHandshake;
+    private requestChangesFromServer;
+    private send;
+    private subscribeToLocalChanges;
+    private debouncePushLocalChanges;
+    private pushLocalChanges;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private clearDebounceTimer;
+    private setStatus;
+    private emitSyncEvent;
+}
+//# sourceMappingURL=sync-client.d.ts.map

package/dist/src/sync-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-client.d.ts","sourceRoot":"","sources":["../../src/sync-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EAGX,MAAM,YAAY,CAAC;AAapB;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAED;IAGvB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,YAAY,CAAuB;IAG3C,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,eAAe,CAAiC;IAGxD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,qBAAqB,CAAS;IAGtC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,cAAc,CAAoB;IAG1C,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,uBAAuB,CAAK;IAGpC,OAAO,CAAC,sBAAsB,CAA6B;gBAE/C,OAAO,EAAE,iBAAiB;IAYtC,gCAAgC;IAChC,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,iDAAiD;IACjD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,yCAAyC;IACzC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;OAMG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4DzD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YA8BnB,aAAa;YA+Bb,kBAAkB;YAiBlB,aAAa;IAgC3B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,aAAa;YASP,wBAAwB;IAatC,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,wBAAwB;YASlB,gBAAgB;IAuC9B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,aAAa;CAatB"}

package/dist/src/sync-client.js

@@ -0,0 +1,342 @@
+/**
+ * SyncClient - WebSocket-based sync client for Quereus.
+ *
+ * Handles:
+ * - WebSocket connection and handshake
+ * - Message dispatch (changes, push_changes, apply_result, error, pong)
+ * - Reconnection with exponential backoff
+ * - Local change debouncing
+ * - Delta sync tracking (lastSentHLC, pendingSentHLC)
+ */
+import { siteIdToBase64, siteIdFromBase64, compareHLC, } from '@quereus/plugin-sync';
+import { serializeChangeSet, deserializeChangeSet, serializeHLCForTransport, } from './serialization.js';
+// Default configuration values
+const DEFAULT_RECONNECT_DELAY_MS = 1000;
+const DEFAULT_MAX_RECONNECT_DELAY_MS = 60_000;
+const DEFAULT_LOCAL_CHANGE_DEBOUNCE_MS = 50;
+/**
+ * WebSocket sync client for Quereus.
+ *
+ * Connects to a sync server and handles bidirectional synchronization
+ * of changes with automatic reconnection and local change batching.
+ */
+export class SyncClient {
+    syncManager;
+    syncEvents;
+    options;
+    // WebSocket state
+    ws = null;
+    serverSiteId = null;
+    // Connection state
+    _status = { status: 'disconnected' };
+    connectionUrl = null;
+    connectionToken = undefined;
+    // Reconnection state
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    intentionalDisconnect = false;
+    // Delta sync tracking
+    lastSentHLC = null;
+    pendingSentHLC = null;
+    // Local change debouncing
+    debounceTimer = null;
+    pendingLocalChangeCount = 0;
+    // Local change listener cleanup
+    localChangeUnsubscribe = null;
+    constructor(options) {
+        this.syncManager = options.syncManager;
+        this.syncEvents = options.syncEvents;
+        this.options = {
+            ...options,
+            autoReconnect: options.autoReconnect ?? true,
+            reconnectDelayMs: options.reconnectDelayMs ?? DEFAULT_RECONNECT_DELAY_MS,
+            maxReconnectDelayMs: options.maxReconnectDelayMs ?? DEFAULT_MAX_RECONNECT_DELAY_MS,
+            localChangeDebounceMs: options.localChangeDebounceMs ?? DEFAULT_LOCAL_CHANGE_DEBOUNCE_MS,
+        };
+    }
+    /** Current connection status */
+    get status() {
+        return this._status;
+    }
+    /** Whether the client is connected and synced */
+    get isConnected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    /** Whether the client is fully synced */
+    get isSynced() {
+        return this._status.status === 'synced';
+    }
+    /**
+     * Connect to a sync server.
+     *
+     * @param url - WebSocket URL of the sync server
+     * @param token - Optional authentication token
+     * @returns Promise that resolves when connected (not yet synced)
+     */
+    async connect(url, token) {
+        // Store connection params for reconnection
+        this.connectionUrl = url;
+        this.connectionToken = token;
+        this.intentionalDisconnect = false;
+        // Clear any pending reconnect timer
+        this.clearReconnectTimer();
+        // Close existing connection
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.setStatus({ status: 'connecting' });
+        return new Promise((resolve, reject) => {
+            try {
+                const wsUrl = token ? `${url}?token=${encodeURIComponent(token)}` : url;
+                this.ws = new WebSocket(wsUrl);
+                this.ws.onopen = () => {
+                    this.reconnectAttempts = 0;
+                    this.sendHandshake(token);
+                    this.setStatus({ status: 'syncing', progress: 0 });
+                    this.emitSyncEvent('state-change', 'Connected to sync server, handshake sent');
+                    resolve();
+                };
+                this.ws.onclose = () => {
+                    this.setStatus({ status: 'disconnected' });
+                    this.emitSyncEvent('state-change', 'Disconnected from sync server');
+                    this.scheduleReconnect();
+                };
+                this.ws.onerror = () => {
+                    const error = new Error('WebSocket connection failed');
+                    this.setStatus({ status: 'error', message: error.message });
+                    this.emitSyncEvent('error', error.message);
+                    // Only reject on first attempt
+                    if (this.reconnectAttempts === 0) {
+                        reject(error);
+                    }
+                };
+                this.ws.onmessage = (event) => {
+                    this.handleMessage(event.data).catch(err => {
+                        console.error('Error handling sync message:', err);
+                        this.emitSyncEvent('error', `Sync error: ${err instanceof Error ? err.message : 'Unknown'}`);
+                    });
+                };
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : 'Connection failed';
+                this.setStatus({ status: 'error', message: msg });
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Disconnect from the sync server.
+     * Stops reconnection attempts.
+     */
+    async disconnect() {
+        this.intentionalDisconnect = true;
+        // Clear timers
+        this.clearReconnectTimer();
+        this.clearDebounceTimer();
+        // Remove local change listener
+        if (this.localChangeUnsubscribe) {
+            this.localChangeUnsubscribe();
+            this.localChangeUnsubscribe = null;
+        }
+        // Close WebSocket
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.serverSiteId = null;
+        this.lastSentHLC = null;
+        this.pendingSentHLC = null;
+        this.setStatus({ status: 'disconnected' });
+        this.emitSyncEvent('state-change', 'Disconnected from sync server (manual)');
+    }
+    // ==========================================================================
+    // Private: Message Handlers
+    // ==========================================================================
+    async handleMessage(data) {
+        const message = JSON.parse(data);
+        switch (message.type) {
+            case 'handshake_ack':
+                await this.handleHandshakeAck(message);
+                break;
+            case 'changes':
+            case 'push_changes':
+                await this.handleChanges(message.changeSets || []);
+                break;
+            case 'apply_result':
+                this.handleApplyResult(message);
+                break;
+            case 'error':
+                this.emitSyncEvent('error', `Server error: ${message.message} (${message.code})`);
+                this.options.onError?.(new Error(message.message));
+                break;
+            case 'pong':
+                // Heartbeat response - no action needed
+                break;
+            default:
+                console.warn('Unknown sync message type:', message.type);
+        }
+    }
+    async handleHandshakeAck(message) {
+        if (message.serverSiteId) {
+            this.serverSiteId = siteIdFromBase64(message.serverSiteId);
+        }
+        this.emitSyncEvent('state-change', `Authenticated with server (connection: ${message.connectionId?.slice(0, 8) ?? 'unknown'})`);
+        // Request changes from server since our last sync with this peer
+        await this.requestChangesFromServer();
+        // Subscribe to local changes for pushing to server
+        this.subscribeToLocalChanges();
+    }
+    async handleChanges(serializedChangeSets) {
+        const changeSets = serializedChangeSets.map(cs => deserializeChangeSet(cs));
+        const result = await this.syncManager.applyChanges(changeSets);
+        // Update peer sync state with the max HLC from received changes
+        if (changeSets.length > 0 && this.serverSiteId) {
+            let maxHLC;
+            for (const cs of changeSets) {
+                if (!maxHLC || compareHLC(cs.hlc, maxHLC) > 0) {
+                    maxHLC = cs.hlc;
+                }
+            }
+            if (maxHLC) {
+                await this.syncManager.updatePeerSyncState(this.serverSiteId, maxHLC);
+            }
+        }
+        // Emit events
+        if (result.applied > 0 || result.conflicts > 0 || result.skipped > 0) {
+            const conflictText = result.conflicts > 0 ? ` (${result.conflicts} conflicts resolved)` : '';
+            const skippedText = result.skipped > 0 ? `, ${result.skipped} skipped` : '';
+            this.emitSyncEvent('remote-change', `Applied ${result.applied} column changes${conflictText}${skippedText}`, { changeCount: result.applied, conflicts: result.conflicts, skipped: result.skipped });
+        }
+        this.options.onRemoteChanges?.(result, changeSets);
+        this.setStatus({ status: 'synced', lastSyncTime: Date.now() });
+    }
+    handleApplyResult(message) {
+        // Update lastSentHLC to enable delta sync on next send
+        if (this.pendingSentHLC) {
+            this.lastSentHLC = this.pendingSentHLC;
+            this.pendingSentHLC = null;
+        }
+        this.emitSyncEvent('info', `Server applied ${message.applied ?? 0} change(s)`);
+    }
+    // ==========================================================================
+    // Private: Message Sending
+    // ==========================================================================
+    sendHandshake(token) {
+        const siteId = this.syncManager.getSiteId();
+        this.send({
+            type: 'handshake',
+            siteId: siteIdToBase64(siteId),
+            token,
+        });
+    }
+    async requestChangesFromServer() {
+        if (!this.serverSiteId)
+            return;
+        const lastSyncHLC = await this.syncManager.getPeerSyncState(this.serverSiteId);
+        const msg = { type: 'get_changes' };
+        if (lastSyncHLC) {
+            msg.sinceHLC = serializeHLCForTransport(lastSyncHLC);
+        }
+        this.send(msg);
+    }
+    send(message) {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    // ==========================================================================
+    // Private: Local Change Handling
+    // ==========================================================================
+    subscribeToLocalChanges() {
+        // Unsubscribe from previous if any
+        if (this.localChangeUnsubscribe) {
+            this.localChangeUnsubscribe();
+        }
+        // Subscribe to local changes via SyncEventEmitter
+        this.localChangeUnsubscribe = this.syncEvents.onLocalChange(() => {
+            this.pendingLocalChangeCount++;
+            this.debouncePushLocalChanges();
+        });
+    }
+    debouncePushLocalChanges() {
+        this.clearDebounceTimer();
+        this.debounceTimer = setTimeout(async () => {
+            this.debounceTimer = null;
+            await this.pushLocalChanges();
+        }, this.options.localChangeDebounceMs);
+    }
+    async pushLocalChanges() {
+        if (!this.isConnected)
+            return;
+        // Get changes since lastSentHLC (delta sync)
+        const changes = await this.syncManager.getChangesSince(this.syncManager.getSiteId(), this.lastSentHLC ?? undefined);
+        if (changes.length === 0)
+            return;
+        // Track the max HLC we're sending for delta sync
+        let maxHLC;
+        for (const cs of changes) {
+            if (!maxHLC || compareHLC(cs.hlc, maxHLC) > 0) {
+                maxHLC = cs.hlc;
+            }
+        }
+        this.pendingSentHLC = maxHLC ?? null;
+        // Serialize and send
+        const serialized = changes.map(cs => serializeChangeSet(cs));
+        this.emitSyncEvent('local-change', `Sending ${changes.length} change set(s) to server`, {
+            changeCount: changes.length,
+        });
+        this.send({
+            type: 'apply_changes',
+            changes: serialized,
+        });
+        this.pendingLocalChangeCount = 0;
+    }
+    // ==========================================================================
+    // Private: Reconnection
+    // ==========================================================================
+    scheduleReconnect() {
+        if (this.intentionalDisconnect || !this.connectionUrl || !this.options.autoReconnect) {
+            return;
+        }
+        // Exponential backoff: 1s, 2s, 4s, 8s, ... up to max
+        const delay = Math.min(this.options.reconnectDelayMs * Math.pow(2, this.reconnectAttempts), this.options.maxReconnectDelayMs);
+        this.reconnectAttempts++;
+        this.emitSyncEvent('state-change', `Reconnecting in ${Math.round(delay / 1000)}s (attempt ${this.reconnectAttempts})`);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect(this.connectionUrl, this.connectionToken).catch(() => {
+                // Error already handled in connect, reconnect will be scheduled by onclose
+            });
+        }, delay);
+    }
+    clearReconnectTimer() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    clearDebounceTimer() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+    }
+    // ==========================================================================
+    // Private: Status & Events
+    // ==========================================================================
+    setStatus(status) {
+        this._status = status;
+        this.options.onStatusChange?.(status);
+    }
+    emitSyncEvent(type, message, details) {
+        const event = {
+            type,
+            timestamp: Date.now(),
+            message,
+            details,
+        };
+        this.options.onSyncEvent?.(event);
+    }
+}
+//# sourceMappingURL=sync-client.js.map

package/dist/src/sync-client.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Types for the WebSocket sync client.
+ */
+import type { ApplyResult, ChangeSet, SyncManager, SyncEventEmitter } from '@quereus/plugin-sync';
+/**
+ * Sync connection status.
+ */
+export type SyncStatus = {
+    status: 'disconnected';
+} | {
+    status: 'connecting';
+} | {
+    status: 'syncing';
+    progress: number;
+} | {
+    status: 'synced';
+    lastSyncTime: number;
+} | {
+    status: 'error';
+    message: string;
+};
+/**
+ * Sync event types for logging/UI notifications.
+ */
+export type SyncEventType = 'remote-change' | 'local-change' | 'conflict' | 'state-change' | 'error' | 'info';
+/**
+ * Sync event for logging/UI display.
+ */
+export interface SyncEvent {
+    type: SyncEventType;
+    timestamp: number;
+    message: string;
+    details?: {
+        table?: string;
+        changeCount?: number;
+        conflicts?: number;
+        skipped?: number;
+    };
+}
+/**
+ * Options for configuring the SyncClient.
+ */
+export interface SyncClientOptions {
+    /**
+     * The SyncManager instance to use for sync operations.
+     */
+    syncManager: SyncManager;
+    /**
+     * The SyncEventEmitter to subscribe to local change events.
+     * Required for automatic pushing of local changes to the server.
+     */
+    syncEvents: SyncEventEmitter;
+    /**
+     * Callback when connection status changes.
+     */
+    onStatusChange?: (status: SyncStatus) => void;
+    /**
+     * Callback when remote changes are applied.
+     */
+    onRemoteChanges?: (result: ApplyResult, changeSets: ChangeSet[]) => void;
+    /**
+     * Callback when a sync event occurs (for logging/UI).
+     */
+    onSyncEvent?: (event: SyncEvent) => void;
+    /**
+     * Callback when an error occurs.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Whether to automatically reconnect on disconnect.
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Initial delay for reconnection (milliseconds).
+     * @default 1000
+     */
+    reconnectDelayMs?: number;
+    /**
+     * Maximum delay for reconnection (milliseconds).
+     * @default 60000
+     */
+    maxReconnectDelayMs?: number;
+    /**
+     * Debounce delay for batching local changes (milliseconds).
+     * @default 50
+     */
+    localChangeDebounceMs?: number;
+}
+/** Client → Server: Handshake */
+export interface HandshakeMessage {
+    type: 'handshake';
+    siteId: string;
+    token?: string;
+}
+/** Client → Server: Request changes */
+export interface GetChangesMessage {
+    type: 'get_changes';
+    sinceHLC?: string;
+}
+/** Client → Server: Apply local changes */
+export interface ApplyChangesMessage {
+    type: 'apply_changes';
+    changes: SerializedChangeSet[];
+}
+/** Client → Server: Request snapshot */
+export interface GetSnapshotMessage {
+    type: 'get_snapshot';
+}
+/** Client → Server: Heartbeat */
+export interface PingMessage {
+    type: 'ping';
+}
+export type ClientMessage = HandshakeMessage | GetChangesMessage | ApplyChangesMessage | GetSnapshotMessage | PingMessage;
+/** Server → Client: Handshake acknowledgment */
+export interface HandshakeAckMessage {
+    type: 'handshake_ack';
+    serverSiteId: string;
+    connectionId?: string;
+}
+/** Server → Client: Changes response */
+export interface ChangesMessage {
+    type: 'changes';
+    changeSets: SerializedChangeSet[];
+}
+/** Server → Client: Pushed changes from another peer */
+export interface PushChangesMessage {
+    type: 'push_changes';
+    changeSets: SerializedChangeSet[];
+}
+/** Server → Client: Apply result */
+export interface ApplyResultMessage {
+    type: 'apply_result';
+    applied: number;
+    skipped: number;
+    conflicts: number;
+    transactions: number;
+}
+/** Server → Client: Error */
+export interface ErrorMessage {
+    type: 'error';
+    code: string;
+    message: string;
+}
+/** Server → Client: Heartbeat response */
+export interface PongMessage {
+    type: 'pong';
+}
+export type ServerMessage = HandshakeAckMessage | ChangesMessage | PushChangesMessage | ApplyResultMessage | ErrorMessage | PongMessage;
+/**
+ * A ChangeSet serialized for JSON transport.
+ * SiteIds are base64url-encoded, HLCs are base64-encoded.
+ */
+export interface SerializedChangeSet {
+    siteId: string;
+    transactionId: string;
+    hlc: string;
+    changes: SerializedChange[];
+    schemaMigrations: SerializedSchemaMigration[];
+}
+export interface SerializedChange {
+    type: 'column' | 'delete';
+    schema: string;
+    table: string;
+    pk: unknown[];
+    column?: string;
+    value?: unknown;
+    hlc: string;
+}
+export interface SerializedSchemaMigration {
+    type: string;
+    schema: string;
+    table: string;
+    ddl: string;
+    hlc: string;
+    schemaVersion: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the WebSocket sync client.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@quereus/sync-client",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "WebSocket sync client for Quereus - handles connection, reconnection, and change synchronization",
+  "keywords": [
+    "quereus",
+    "sync",
+    "websocket",
+    "crdt",
+    "replication",
+    "offline-first",
+    "client"
+  ],
+  "publisher": "Got Choices Foundation",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gotchoices/quereus.git",
+    "directory": "packages/quereus-sync-client"
+  },
+  "license": "MIT",
+  "main": "dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "cd ../.. && node --import ./packages/quereus-sync-client/register.mjs node_modules/mocha/bin/mocha.js \"packages/quereus-sync-client/test/**/*.spec.ts\" --colors",
+    "test:single": "cd ../.. && node --import ./packages/quereus-sync-client/register.mjs node_modules/mocha/bin/mocha.js --bail"
+  },
+  "peerDependencies": {
+    "@quereus/plugin-sync": "*"
+  },
+  "devDependencies": {
+    "@quereus/plugin-sync": "*",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.15.29",
+    "chai": "^5.2.0",
+    "mocha": "^11.5.0",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  },
+  "quereus": {
+    "provides": {
+      "sync-client": true
+    }
+  }
+}