@shet-anirudh/crdt-sync-transport-ws 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 crdt-sync contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/serialization.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serialization.test.d.ts.map

package/dist/__tests__/serialization.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/serialization.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/serialization.test.js

@@ -0,0 +1,39 @@
+import { describe, it, expect } from 'vitest';
+import { createRecord, applyLocalChange, deleteField } from '@shet-anirudh/crdt-sync-core';
+import { serializeRecord, deserializeRecord } from '../serialization.js';
+describe('MessagePack serialization', () => {
+    it('serializes and deserializes an empty record', () => {
+        const record = createRecord();
+        const bytes = serializeRecord(record);
+        const restored = deserializeRecord(bytes);
+        // Deep equal check
+        expect(restored).toEqual(record);
+        // Verify it uses a null prototype like the original
+        expect(Object.getPrototypeOf(restored)).toBeNull();
+    });
+    it('serializes and deserializes a record with various field types', () => {
+        let record = createRecord();
+        const now = 1000;
+        record = applyLocalChange(record, 'stringField', 'hello', 'dev-a', now);
+        record = applyLocalChange(record, 'numberField', 42, 'dev-a', now);
+        record = applyLocalChange(record, 'booleanField', true, 'dev-a', now);
+        const bytes = serializeRecord(record);
+        const restored = deserializeRecord(bytes);
+        expect(restored).toEqual(record);
+        expect(restored['stringField']?.value).toBe('hello');
+        expect(restored['stringField']?.origin).toBe('dev-a');
+        expect(restored['numberField']?.value).toBe(42);
+        expect(restored['booleanField']?.value).toBe(true);
+    });
+    it('serializes and deserializes tombstones (deleted fields)', () => {
+        let record = createRecord();
+        record = applyLocalChange(record, 'temp', 'value', 'dev', 1000);
+        record = deleteField(record, 'temp', 'dev', 2000);
+        const bytes = serializeRecord(record);
+        const restored = deserializeRecord(bytes);
+        expect(restored).toEqual(record);
+        expect(restored['temp']?.deleted).toBe(true);
+        expect(restored['temp']?.value).toBeNull();
+    });
+});
+//# sourceMappingURL=serialization.test.js.map

package/dist/__tests__/serialization.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.test.js","sourceRoot":"","sources":["../../src/__tests__/serialization.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE1C,mBAAmB;QACnB,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEjC,oDAAoD;QACpD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,IAAI,MAAM,GAAG,YAAY,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC;QAEjB,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACxE,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACnE,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAEtE,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEjC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,IAAI,MAAM,GAAG,YAAY,EAAE,CAAC;QAC5B,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAChE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAElD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.test.d.ts.map

package/dist/__tests__/transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/transport.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/transport.test.js

@@ -0,0 +1,90 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { createRecord, applyLocalChange, mergeRecords } from '@shet-anirudh/crdt-sync-core';
+import { startRelayServer } from '../relay-server.js';
+import { WebSocketTransport } from '../ws-transport.js';
+import { serializeRecord, deserializeRecord } from '../serialization.js';
+describe('WebSocket Transport Integration', () => {
+    let server;
+    let serverUrl;
+    beforeAll(async () => {
+        // Start on random available port
+        server = await startRelayServer({ port: 0 });
+        serverUrl = `ws://localhost:${server.port}`;
+    });
+    afterAll(async () => {
+        if (server) {
+            await server.close();
+        }
+    });
+    it('connects two peers and exchanges messages', async () => {
+        const transportA = new WebSocketTransport({ serverUrl, initialReconnectDelayMs: 100 });
+        const transportB = new WebSocketTransport({ serverUrl, initialReconnectDelayMs: 100 });
+        const messagesReceivedByA = [];
+        const messagesReceivedByB = [];
+        transportA.onReceive((from, payload) => {
+            expect(from).toBe('peer-b');
+            messagesReceivedByA.push(payload);
+        });
+        transportB.onReceive((from, payload) => {
+            expect(from).toBe('peer-a');
+            messagesReceivedByB.push(payload);
+        });
+        // 1. Connect
+        await Promise.all([
+            transportA.connect('peer-a'),
+            transportB.connect('peer-b'),
+        ]);
+        expect(transportA.isConnected).toBe(true);
+        expect(transportB.isConnected).toBe(true);
+        // 2. Exchange CRDT records
+        let recordA = createRecord();
+        recordA = applyLocalChange(recordA, 'title', 'Hello from A', 'peer-a', Date.now());
+        let recordB = createRecord();
+        recordB = applyLocalChange(recordB, 'status', 'Active', 'peer-b', Date.now());
+        // A sends to B
+        await transportA.send('peer-b', serializeRecord(recordA));
+        // B sends to A
+        await transportB.send('peer-a', serializeRecord(recordB));
+        // Wait a moment for delivery
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        expect(messagesReceivedByA.length).toBe(1);
+        expect(messagesReceivedByB.length).toBe(1);
+        // 3. Deserialize and Merge
+        const receivedRecordA = deserializeRecord(messagesReceivedByB[0]); // B received A's record
+        const receivedRecordB = deserializeRecord(messagesReceivedByA[0]); // A received B's record
+        const mergedAtA = mergeRecords(recordA, receivedRecordB);
+        const mergedAtB = mergeRecords(recordB, receivedRecordA);
+        // Both should now have exactly the same data
+        expect(mergedAtA['title']?.value).toBe('Hello from A');
+        expect(mergedAtA['status']?.value).toBe('Active');
+        expect(mergedAtA).toEqual(mergedAtB);
+        // 4. Disconnect
+        await Promise.all([
+            transportA.disconnect(),
+            transportB.disconnect(),
+        ]);
+        expect(transportA.isConnected).toBe(false);
+        expect(transportB.isConnected).toBe(false);
+    });
+    it('buffers messages sent while offline and flushes on reconnect', async () => {
+        const transportA = new WebSocketTransport({ serverUrl, initialReconnectDelayMs: 100 });
+        const transportB = new WebSocketTransport({ serverUrl, initialReconnectDelayMs: 100 });
+        const receivedByB = [];
+        transportB.onReceive((_from, payload) => {
+            receivedByB.push(payload);
+        });
+        await transportB.connect('peer-b');
+        // A sends a message BEFORE connecting
+        const payload = new Uint8Array([1, 2, 3]);
+        await transportA.send('peer-b', payload);
+        expect(receivedByB.length).toBe(0);
+        // Connect A — it should flush the queue
+        await transportA.connect('peer-a');
+        // Wait for delivery
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        expect(receivedByB.length).toBe(1);
+        expect(receivedByB[0]).toEqual(payload);
+        await Promise.all([transportA.disconnect(), transportB.disconnect()]);
+    });
+});
+//# sourceMappingURL=transport.test.js.map

package/dist/__tests__/transport.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @shet-anirudh/crdt-sync-transport-ws — Public API
+ *
+ * Provides a WebSocket-based transport adapter and relay server for the
+ * CRDT sync engine.
+ */
+export type { PeerId, SyncTransport, WireMessage } from './types.js';
+export { serializeRecord, deserializeRecord, serializeMessage, deserializeMessage, } from './serialization.js';
+export { WebSocketTransport, type WebSocketTransportOptions, } from './ws-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @shet-anirudh/crdt-sync-transport-ws — Public API
+ *
+ * Provides a WebSocket-based transport adapter and relay server for the
+ * CRDT sync engine.
+ */
+export { serializeRecord, deserializeRecord, serializeMessage, deserializeMessage, } from './serialization.js';
+export { WebSocketTransport, } from './ws-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC"}

package/dist/relay-server.d.ts

@@ -0,0 +1,36 @@
+/**
+ * WebSocket Relay Server
+ *
+ * A minimal relay server that connects two (or more) peers by name.
+ * Peers register with their DeviceId, then send messages addressed to
+ * another DeviceId. The server forwards the raw bytes — it is CRDT-unaware.
+ *
+ * Architecture:
+ *   [Device A] ──ws──▶ [Relay Server] ──ws──▶ [Device B]
+ *
+ * Why relay mode instead of direct P2P?
+ *   Direct P2P needs NAT traversal (ICE/STUN/TURN). A relay is simpler
+ *   to demo reliably and is the standard starting point before adding
+ *   WebRTC or Nearby Connections.
+ *
+ * Wire protocol (all messages are MessagePack-encoded):
+ *   Client → Server: { type: 'register', peerId: string }
+ *                    { type: 'send', to: string, payload: Uint8Array }
+ *   Server → Client: { type: 'message', from: string, payload: Uint8Array }
+ *                    { type: 'peer_joined', peerId: string }
+ *                    { type: 'peer_left', peerId: string }
+ *                    { type: 'error', message: string }
+ */
+export interface RelayServerOptions {
+    port?: number;
+    host?: string;
+}
+/**
+ * Start the relay server.
+ * @returns A promise resolving to an object with the bound port and a close() method.
+ */
+export declare function startRelayServer(options?: RelayServerOptions): Promise<{
+    close: () => Promise<void>;
+    port: number;
+}>;
+//# sourceMappingURL=relay-server.d.ts.map

package/dist/relay-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-server.d.ts","sourceRoot":"","sources":["../src/relay-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC;IAC1E,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAsJD"}

package/dist/relay-server.js

@@ -0,0 +1,195 @@
+/**
+ * WebSocket Relay Server
+ *
+ * A minimal relay server that connects two (or more) peers by name.
+ * Peers register with their DeviceId, then send messages addressed to
+ * another DeviceId. The server forwards the raw bytes — it is CRDT-unaware.
+ *
+ * Architecture:
+ *   [Device A] ──ws──▶ [Relay Server] ──ws──▶ [Device B]
+ *
+ * Why relay mode instead of direct P2P?
+ *   Direct P2P needs NAT traversal (ICE/STUN/TURN). A relay is simpler
+ *   to demo reliably and is the standard starting point before adding
+ *   WebRTC or Nearby Connections.
+ *
+ * Wire protocol (all messages are MessagePack-encoded):
+ *   Client → Server: { type: 'register', peerId: string }
+ *                    { type: 'send', to: string, payload: Uint8Array }
+ *   Server → Client: { type: 'message', from: string, payload: Uint8Array }
+ *                    { type: 'peer_joined', peerId: string }
+ *                    { type: 'peer_left', peerId: string }
+ *                    { type: 'error', message: string }
+ */
+import { createServer } from 'http';
+import { decode, encode } from '@msgpack/msgpack';
+import { WebSocket, WebSocketServer } from 'ws';
+/**
+ * Start the relay server.
+ * @returns A promise resolving to an object with the bound port and a close() method.
+ */
+export function startRelayServer(options = {}) {
+    return new Promise((resolveStart) => {
+        const port = options.port ?? 8787;
+        const host = options.host ?? '0.0.0.0';
+        const httpServer = createServer();
+        const wss = new WebSocketServer({ server: httpServer });
+        // PeerId → ConnectedPeer
+        const peers = new Map();
+        wss.on('connection', (socket) => {
+            let registeredPeerId = null;
+            socket.on('message', (raw) => {
+                let msg;
+                try {
+                    const decoded = decode(raw);
+                    if (typeof decoded !== 'object' || decoded === null) {
+                        sendError(socket, 'Message must be an object');
+                        return;
+                    }
+                    msg = decoded;
+                }
+                catch {
+                    sendError(socket, 'Failed to decode MessagePack message');
+                    return;
+                }
+                const type = msg['type'];
+                // ── Register ──────────────────────────────────────────────────────────
+                if (type === 'register') {
+                    const peerId = msg['peerId'];
+                    if (typeof peerId !== 'string' || peerId.length === 0) {
+                        sendError(socket, 'register.peerId must be a non-empty string');
+                        return;
+                    }
+                    // If the peer is already registered (e.g. React StrictMode remount or
+                    // reconnect), close the stale connection and accept the new one.
+                    if (peers.has(peerId)) {
+                        const stale = peers.get(peerId);
+                        if (stale.socket !== socket) {
+                            stale.socket.close();
+                        }
+                        peers.delete(peerId);
+                    }
+                    registeredPeerId = peerId;
+                    peers.set(peerId, { peerId, socket });
+                    console.log(`[relay] peer registered: ${peerId} (${peers.size} total)`);
+                    // Reply to sender to confirm registration (ws-transport awaits this)
+                    socket.send(encode({ type: 'registered' }));
+                    // Notify all other peers that someone joined
+                    broadcast(peerId, encode({ type: 'peer_joined', peerId }), peers);
+                    return;
+                }
+                // ── Send ──────────────────────────────────────────────────────────────
+                if (type === 'send') {
+                    if (registeredPeerId === null) {
+                        sendError(socket, 'Must register before sending');
+                        return;
+                    }
+                    const to = msg['to'];
+                    const payload = msg['payload'];
+                    if (typeof to !== 'string') {
+                        sendError(socket, 'send.to must be a string');
+                        return;
+                    }
+                    if (!(payload instanceof Uint8Array) && !Buffer.isBuffer(payload)) {
+                        sendError(socket, 'send.payload must be a Uint8Array');
+                        return;
+                    }
+                    const recipient = peers.get(to);
+                    if (recipient === undefined) {
+                        sendError(socket, `Peer "${to}" is not connected`);
+                        return;
+                    }
+                    // Forward the payload to the recipient, tagging it with the sender
+                    const envelope = encode({
+                        type: 'message',
+                        from: registeredPeerId,
+                        payload: payload instanceof Buffer ? new Uint8Array(payload) : payload,
+                    });
+                    recipient.socket.send(envelope);
+                    return;
+                }
+                // ── Broadcast ─────────────────────────────────────────────────────────
+                if (type === 'broadcast') {
+                    if (registeredPeerId === null) {
+                        sendError(socket, 'Must register before broadcasting');
+                        return;
+                    }
+                    const payload = msg['payload'];
+                    if (!(payload instanceof Uint8Array) && !Buffer.isBuffer(payload)) {
+                        sendError(socket, 'broadcast.payload must be a Uint8Array');
+                        return;
+                    }
+                    const bytes = payload instanceof Buffer ? new Uint8Array(payload) : payload;
+                    const envelope = encode({ type: 'message', from: registeredPeerId, payload: bytes });
+                    broadcast(registeredPeerId, envelope, peers);
+                    return;
+                }
+                sendError(socket, `Unknown message type: ${String(type)}`);
+            });
+            socket.on('close', () => {
+                if (registeredPeerId !== null) {
+                    peers.delete(registeredPeerId);
+                    console.log(`[relay] peer left: ${registeredPeerId} (${peers.size} remaining)`);
+                    broadcast(registeredPeerId, encode({ type: 'peer_left', peerId: registeredPeerId }), peers);
+                }
+            });
+            socket.on('error', (err) => {
+                console.error(`[relay] socket error for ${registeredPeerId ?? 'unregistered'}:`, err.message);
+            });
+        });
+        httpServer.listen(port, host, () => {
+            const address = httpServer.address();
+            const boundPort = address && typeof address === 'object' ? address.port : port;
+            console.log(`[relay] server listening on ws://${host}:${boundPort}`);
+            resolveStart({
+                port: boundPort,
+                close: () => new Promise((resolve, reject) => {
+                    wss.close((err) => {
+                        if (err) {
+                            reject(err);
+                            return;
+                        }
+                        httpServer.close((err2) => {
+                            if (err2)
+                                reject(err2);
+                            else
+                                resolve();
+                        });
+                    });
+                }),
+            });
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sendError(socket, message) {
+    if (socket.readyState === WebSocket.OPEN) {
+        socket.send(encode({ type: 'error', message }));
+    }
+}
+/** Send encoded bytes to all peers except the sender. */
+function broadcast(excludePeerId, encoded, peers) {
+    for (const [id, peer] of peers) {
+        if (id !== excludePeerId && peer.socket.readyState === WebSocket.OPEN) {
+            peer.socket.send(encoded);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// CLI entrypoint — auto-start when run directly: node dist/relay-server.js
+// ---------------------------------------------------------------------------
+const isMain = typeof process !== 'undefined' &&
+    process.argv[1] !== undefined &&
+    (process.argv[1].endsWith('relay-server.js') || process.argv[1].endsWith('relay-server.ts'));
+if (isMain) {
+    const port = process.env['PORT'] ? Number(process.env['PORT']) : 8787;
+    startRelayServer({ port }).then(({ port: bound }) => {
+        console.log(`[relay] ready — ws://localhost:${bound}`);
+    }).catch((err) => {
+        console.error('[relay] failed to start:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=relay-server.js.map

package/dist/relay-server.js.map

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

package/dist/serialization.d.ts

@@ -0,0 +1,36 @@
+/**
+ * MessagePack serialization for CRDT records.
+ *
+ * Why MessagePack over JSON?
+ *   - Binary format: no string escaping, smaller payloads (~30% on average)
+ *   - Preserves numeric types (no JSON number precision loss)
+ *   - Fast encode/decode
+ *   - Well-supported in Node.js and browsers
+ *
+ * The wire format wraps the CRDTRecord in an envelope:
+ * { type, from, to?, record }
+ */
+import type { CRDTRecord } from '@shet-anirudh/crdt-sync-core';
+import type { WireMessage } from './types.js';
+/**
+ * Serialize a CRDTRecord into a compact binary Uint8Array using MessagePack.
+ *
+ * The record is first converted to a plain JSON-compatible object (no
+ * null-prototype, HLC expanded to { wallTime, logical }) before encoding.
+ */
+export declare function serializeRecord(record: CRDTRecord): Uint8Array;
+/**
+ * Deserialize a Uint8Array (MessagePack) back into a CRDTRecord.
+ * @throws If the bytes are malformed or missing required fields.
+ */
+export declare function deserializeRecord(bytes: Uint8Array): CRDTRecord;
+/**
+ * Serialize a full WireMessage (including CRDTRecord payload) to bytes.
+ */
+export declare function serializeMessage(msg: WireMessage): Uint8Array;
+/**
+ * Deserialize a WireMessage from bytes.
+ * @throws If the bytes are malformed.
+ */
+export declare function deserializeMessage(bytes: Uint8Array): WireMessage;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,8BAA8B,CAAC;AAGhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAG9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAG/D;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CAW7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAuBjE"}

package/dist/serialization.js

@@ -0,0 +1,137 @@
+/**
+ * MessagePack serialization for CRDT records.
+ *
+ * Why MessagePack over JSON?
+ *   - Binary format: no string escaping, smaller payloads (~30% on average)
+ *   - Preserves numeric types (no JSON number precision loss)
+ *   - Fast encode/decode
+ *   - Well-supported in Node.js and browsers
+ *
+ * The wire format wraps the CRDTRecord in an envelope:
+ * { type, from, to?, record }
+ */
+import { decode, encode } from '@msgpack/msgpack';
+import { hlcFromJSON, hlcToJSON } from '@shet-anirudh/crdt-sync-core';
+// ---------------------------------------------------------------------------
+// CRDTRecord serialization
+// ---------------------------------------------------------------------------
+/**
+ * Serialize a CRDTRecord into a compact binary Uint8Array using MessagePack.
+ *
+ * The record is first converted to a plain JSON-compatible object (no
+ * null-prototype, HLC expanded to { wallTime, logical }) before encoding.
+ */
+export function serializeRecord(record) {
+    const plain = recordToPlain(record);
+    return encode(plain);
+}
+/**
+ * Deserialize a Uint8Array (MessagePack) back into a CRDTRecord.
+ * @throws If the bytes are malformed or missing required fields.
+ */
+export function deserializeRecord(bytes) {
+    const plain = decode(bytes);
+    return plainToRecord(plain);
+}
+// ---------------------------------------------------------------------------
+// WireMessage serialization (used by relay server + client)
+// ---------------------------------------------------------------------------
+/**
+ * Serialize a full WireMessage (including CRDTRecord payload) to bytes.
+ */
+export function serializeMessage(msg) {
+    const plain = {
+        type: msg.type,
+        from: msg.from,
+    };
+    if (msg.to !== undefined)
+        plain['to'] = msg.to;
+    if (msg.payload !== undefined) {
+        // payload is already a CRDTRecord; convert to plain before outer encode
+        plain['payload'] = recordToPlain(msg.payload);
+    }
+    return encode(plain);
+}
+/**
+ * Deserialize a WireMessage from bytes.
+ * @throws If the bytes are malformed.
+ */
+export function deserializeMessage(bytes) {
+    const raw = decode(bytes);
+    assertObject(raw, 'WireMessage');
+    const obj = raw;
+    const type = obj['type'];
+    const from = obj['from'];
+    if (type !== 'sync' && type !== 'ping' && type !== 'pong') {
+        throw new Error(`Invalid WireMessage type: ${String(type)}`);
+    }
+    if (typeof from !== 'string') {
+        throw new Error(`WireMessage.from must be a string`);
+    }
+    const msg = { type, from };
+    if (typeof obj['to'] === 'string')
+        msg.to = obj['to'];
+    if (obj['payload'] !== undefined) {
+        msg.payload = plainToRecord(obj['payload']);
+    }
+    return msg;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Convert a CRDTRecord (null-prototype) to a plain JSON-safe object. */
+function recordToPlain(record) {
+    const out = {};
+    for (const [key, entry] of Object.entries(record)) {
+        out[key] = fieldEntryToPlain(entry);
+    }
+    return out;
+}
+function fieldEntryToPlain(entry) {
+    const out = {
+        value: entry.value,
+        hlc: hlcToJSON(entry.hlc),
+        origin: entry.origin,
+    };
+    if (entry.deleted === true)
+        out['deleted'] = true;
+    return out;
+}
+/** Reconstruct a CRDTRecord from a plain decoded object. */
+function plainToRecord(raw) {
+    assertObject(raw, 'CRDTRecord');
+    const obj = raw;
+    // Use null-prototype object to match core's convention
+    const record = Object.create(null);
+    for (const [key, rawEntry] of Object.entries(obj)) {
+        record[key] = plainToFieldEntry(rawEntry, key);
+    }
+    return record;
+}
+function plainToFieldEntry(raw, key) {
+    assertObject(raw, `FieldEntry[${key}]`);
+    const obj = raw;
+    const value = obj['value'] ?? null;
+    if (value !== null &&
+        typeof value !== 'string' &&
+        typeof value !== 'number' &&
+        typeof value !== 'boolean') {
+        throw new Error(`FieldEntry[${key}].value has invalid type: ${typeof value}`);
+    }
+    const hlc = hlcFromJSON(obj['hlc']);
+    const origin = obj['origin'];
+    if (typeof origin !== 'string') {
+        throw new Error(`FieldEntry[${key}].origin must be a string`);
+    }
+    const entry = { value, hlc, origin };
+    if (obj['deleted'] === true) {
+        return { ...entry, deleted: true };
+    }
+    return entry;
+}
+function assertObject(val, label) {
+    if (typeof val !== 'object' || val === null || Array.isArray(val)) {
+        throw new Error(`Expected object for ${label}, got: ${JSON.stringify(val)}`);
+    }
+}
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Transport abstraction for the CRDT sync engine.
+ *
+ * The SyncTransport interface is the *only* contract the core engine needs.
+ * Any transport implementation (WebSocket, WebRTC, Bluetooth, SMS) plugs in
+ * by implementing this interface — core never changes.
+ */
+/** Unique identifier for a peer/device on the network. */
+export type PeerId = string;
+/**
+ * The pluggable transport interface.
+ *
+ * Payloads are raw bytes (Uint8Array) — the transport is intentionally
+ * unaware of the CRDT serialization format. Serialization lives in
+ * serialization.ts, transport just moves bytes.
+ */
+export interface SyncTransport {
+    /**
+     * Connect to the relay server (or directly to a peer).
+     * @param peerId - This device's own identifier on the network.
+     */
+    connect(peerId: PeerId): Promise<void>;
+    /**
+     * Send a binary payload to a specific peer.
+     * If the transport is disconnected, implementations should queue the
+     * message and deliver it on reconnect.
+     */
+    send(toPeerId: PeerId, payload: Uint8Array): Promise<void>;
+    /**
+     * Register a callback invoked whenever a message arrives from any peer.
+     */
+    onReceive(callback: (fromPeerId: PeerId, payload: Uint8Array) => void): void;
+    /**
+     * Gracefully disconnect from the network.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Returns true if the transport is currently connected.
+     */
+    readonly isConnected: boolean;
+}
+/**
+ * Wire message format exchanged between peers via the relay server.
+ * Serialized with MessagePack before going onto the wire.
+ */
+export interface WireMessage {
+    /** Message type discriminant. */
+    type: 'sync' | 'ping' | 'pong';
+    /** Sender's device/peer ID. */
+    from: PeerId;
+    /** Recipient's device/peer ID (undefined = broadcast). */
+    to?: PeerId;
+    /** CRDT record payload (only present on 'sync' messages). */
+    payload?: unknown;
+}
+/**
+ * Relay server → client envelope.
+ * The relay server wraps incoming peer messages with the sender's ID.
+ */
+export interface RelayEnvelope {
+    from: PeerId;
+    payload: Uint8Array;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAE7E;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Transport abstraction for the CRDT sync engine.
+ *
+ * The SyncTransport interface is the *only* contract the core engine needs.
+ * Any transport implementation (WebSocket, WebRTC, Bluetooth, SMS) plugs in
+ * by implementing this interface — core never changes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/ws-transport.d.ts

@@ -0,0 +1,49 @@
+/**
+ * WebSocket client transport — implements SyncTransport.
+ *
+ * Connects to the relay server, registers with a peerId, and
+ * handles message routing to/from other peers.
+ *
+ * Works in both browser (native WebSocket via globalThis.WebSocket) and
+ * Node.js (globalThis.WebSocket is available from Node 22+, or via the `ws`
+ * polyfill injected at startup).
+ *
+ * Resilience features:
+ *   - Exponential backoff reconnection (1s → 2s → 4s → ... → 30s max)
+ *   - Outbound message queue: messages sent while offline are buffered
+ *     and flushed on reconnect — this is what makes the transport
+ *     offline-first rather than just a thin WebSocket wrapper.
+ */
+import type { PeerId, SyncTransport } from './types.js';
+export interface WebSocketTransportOptions {
+    /** WebSocket relay server URL, e.g. "ws://localhost:8787" */
+    serverUrl: string;
+    /** Initial reconnect delay in ms. Doubles each attempt up to maxReconnectDelayMs. */
+    initialReconnectDelayMs?: number;
+    /** Maximum reconnect delay (default 30 000 ms). */
+    maxReconnectDelayMs?: number;
+}
+export declare class WebSocketTransport implements SyncTransport {
+    private readonly serverUrl;
+    private readonly initialDelay;
+    private readonly maxDelay;
+    private ws;
+    private peerId;
+    private _isConnected;
+    private destroyed;
+    private receiveCallback;
+    private outboundQueue;
+    private reconnectDelay;
+    private reconnectTimer;
+    constructor(options: WebSocketTransportOptions);
+    get isConnected(): boolean;
+    connect(peerId: PeerId): Promise<void>;
+    send(toPeerId: PeerId, payload: Uint8Array): Promise<void>;
+    onReceive(callback: (fromPeerId: PeerId, payload: Uint8Array) => void): void;
+    disconnect(): Promise<void>;
+    private openSocket;
+    private scheduleReconnect;
+    private sendRaw;
+    private flushQueue;
+}
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../src/ws-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAOD,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,CAAC,EAAE,CAAqC;IAC/C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,eAAe,CAAoE;IAC3F,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAA8C;gBAExD,OAAO,EAAE,yBAAyB;IAO9C,IAAI,WAAW,IAAI,OAAO,CAEzB;IAIK,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAShE,SAAS,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAItE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC,OAAO,CAAC,UAAU;IAoGlB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;CASnB"}

package/dist/ws-transport.js

@@ -0,0 +1,188 @@
+/**
+ * WebSocket client transport — implements SyncTransport.
+ *
+ * Connects to the relay server, registers with a peerId, and
+ * handles message routing to/from other peers.
+ *
+ * Works in both browser (native WebSocket via globalThis.WebSocket) and
+ * Node.js (globalThis.WebSocket is available from Node 22+, or via the `ws`
+ * polyfill injected at startup).
+ *
+ * Resilience features:
+ *   - Exponential backoff reconnection (1s → 2s → 4s → ... → 30s max)
+ *   - Outbound message queue: messages sent while offline are buffered
+ *     and flushed on reconnect — this is what makes the transport
+ *     offline-first rather than just a thin WebSocket wrapper.
+ */
+import { decode, encode } from '@msgpack/msgpack';
+export class WebSocketTransport {
+    serverUrl;
+    initialDelay;
+    maxDelay;
+    ws = null;
+    peerId = null;
+    _isConnected = false;
+    destroyed = false;
+    receiveCallback = null;
+    outboundQueue = [];
+    reconnectDelay;
+    reconnectTimer = null;
+    constructor(options) {
+        this.serverUrl = options.serverUrl;
+        this.initialDelay = options.initialReconnectDelayMs ?? 1_000;
+        this.maxDelay = options.maxReconnectDelayMs ?? 30_000;
+        this.reconnectDelay = this.initialDelay;
+    }
+    get isConnected() {
+        return this._isConnected;
+    }
+    // ── SyncTransport API ────────────────────────────────────────────────────
+    async connect(peerId) {
+        if (this._isConnected)
+            return;
+        this.peerId = peerId;
+        this.destroyed = false;
+        await this.openSocket();
+    }
+    async send(toPeerId, payload) {
+        if (!this._isConnected || this.ws === null) {
+            // Buffer for delivery on reconnect
+            this.outboundQueue.push({ to: toPeerId, payload });
+            return;
+        }
+        this.sendRaw(toPeerId, payload);
+    }
+    onReceive(callback) {
+        this.receiveCallback = callback;
+    }
+    async disconnect() {
+        this.destroyed = true;
+        if (this.reconnectTimer !== null) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws !== null) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this._isConnected = false;
+    }
+    // ── Internal ─────────────────────────────────────────────────────────────
+    openSocket() {
+        return new Promise((resolve, reject) => {
+            // Use the native browser WebSocket (globalThis.WebSocket).
+            // This works in Vite/React without any Node.js polyfill.
+            // In Node.js 22+ WebSocket is also available on globalThis.
+            const socket = new globalThis.WebSocket(this.serverUrl);
+            socket.binaryType = 'arraybuffer';
+            this.ws = socket;
+            socket.addEventListener('open', () => {
+                // Register with the relay server
+                socket.send(encode({ type: 'register', peerId: this.peerId }));
+            });
+            socket.addEventListener('message', (event) => {
+                let raw;
+                if (event.data instanceof ArrayBuffer) {
+                    raw = new Uint8Array(event.data);
+                }
+                else if (event.data instanceof Uint8Array) {
+                    raw = event.data;
+                }
+                else {
+                    console.warn('[ws-transport] unexpected message data type:', typeof event.data);
+                    return;
+                }
+                let msg;
+                try {
+                    const decoded = decode(raw);
+                    if (typeof decoded !== 'object' || decoded === null)
+                        return;
+                    msg = decoded;
+                }
+                catch {
+                    console.warn('[ws-transport] failed to decode message');
+                    return;
+                }
+                const type = msg['type'];
+                if (type === 'registered') {
+                    // Server confirmed registration
+                    this._isConnected = true;
+                    this.reconnectDelay = this.initialDelay; // reset backoff on success
+                    this.flushQueue();
+                    resolve();
+                    return;
+                }
+                if (type === 'message') {
+                    const from = msg['from'];
+                    const payload = msg['payload'];
+                    if (typeof from === 'string' &&
+                        (payload instanceof Uint8Array || payload instanceof ArrayBuffer) &&
+                        this.receiveCallback !== null) {
+                        const bytes = payload instanceof ArrayBuffer ? new Uint8Array(payload) : payload;
+                        this.receiveCallback(from, bytes);
+                    }
+                    return;
+                }
+                if (type === 'peer_joined') {
+                    console.log(`[ws-transport] peer joined: ${String(msg['peerId'])}`);
+                    return;
+                }
+                if (type === 'peer_left') {
+                    console.log(`[ws-transport] peer left: ${String(msg['peerId'])}`);
+                    return;
+                }
+                if (type === 'error') {
+                    console.error(`[ws-transport] server error: ${String(msg['message'])}`);
+                    // If we weren't registered yet, reject the connect() promise
+                    if (!this._isConnected) {
+                        reject(new Error(String(msg['message'])));
+                    }
+                    return;
+                }
+            });
+            socket.addEventListener('close', () => {
+                this._isConnected = false;
+                this.ws = null;
+                if (!this.destroyed) {
+                    console.log(`[ws-transport] disconnected. Reconnecting in ${this.reconnectDelay}ms...`);
+                    this.scheduleReconnect();
+                }
+            });
+            socket.addEventListener('error', () => {
+                console.error('[ws-transport] WebSocket error');
+                if (!this._isConnected) {
+                    reject(new Error('WebSocket connection failed'));
+                }
+            });
+        });
+    }
+    scheduleReconnect() {
+        if (this.destroyed || this.peerId === null)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            // Exponential backoff with jitter (±10%)
+            const jitter = this.reconnectDelay * 0.1 * (Math.random() * 2 - 1);
+            this.reconnectDelay = Math.min(this.reconnectDelay * 2 + jitter, this.maxDelay);
+            console.log(`[ws-transport] attempting reconnect as "${this.peerId}"...`);
+            this.openSocket().catch((err) => {
+                console.error('[ws-transport] reconnect failed:', err);
+            });
+        }, this.reconnectDelay);
+    }
+    sendRaw(toPeerId, payload) {
+        if (this.ws === null || this.ws.readyState !== globalThis.WebSocket.OPEN)
+            return;
+        this.ws.send(encode({ type: 'send', to: toPeerId, payload }));
+    }
+    flushQueue() {
+        const queued = this.outboundQueue.splice(0);
+        for (const { to, payload } of queued) {
+            this.sendRaw(to, payload);
+        }
+        if (queued.length > 0) {
+            console.log(`[ws-transport] flushed ${queued.length} queued message(s)`);
+        }
+    }
+}
+//# sourceMappingURL=ws-transport.js.map

package/dist/ws-transport.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@shet-anirudh/crdt-sync-transport-ws",
+  "version": "0.1.0",
+  "description": "WebSocket transport adapter and relay server for @shet-anirudh/crdt-sync-core.",
+  "keywords": [
+    "crdt",
+    "websocket",
+    "transport",
+    "sync",
+    "offline-first"
+  ],
+  "license": "MIT",
+  "author": "Anirudh Shet",
+  "homepage": "https://github.com/shet-anirudh/crdt-sync-engine#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shet-anirudh/crdt-sync-engine.git",
+    "directory": "packages/transport-ws"
+  },
+  "bugs": {
+    "url": "https://github.com/shet-anirudh/crdt-sync-engine/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/relay-server.js",
+      "types": "./dist/relay-server.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@msgpack/msgpack": "^3.0.0",
+    "ws": "^8.18.0",
+    "@shet-anirudh/crdt-sync-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.12",
+    "rimraf": "^6.0.1",
+    "vitest": "^2.0.5"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "build:watch": "tsc --project tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "clean": "rimraf dist",
+    "start:relay": "node dist/relay-server.js"
+  }
+}