@sqlrooms/crdt 0.27.0-rc.0

package/dist/storages/localStorageStorage.js

@@ -0,0 +1,44 @@
+function toBase64(bytes) {
+    let binary = '';
+    bytes.forEach((b) => {
+        binary += String.fromCharCode(b);
+    });
+    return btoa(binary);
+}
+function fromBase64(encoded) {
+    const binary = atob(encoded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+export function createLocalStorageDocStorage({ key, }) {
+    return {
+        async load() {
+            if (typeof window === 'undefined')
+                return undefined;
+            const raw = window.localStorage.getItem(key);
+            if (!raw)
+                return undefined;
+            try {
+                return fromBase64(raw);
+            }
+            catch (error) {
+                console.warn('Failed to decode CRDT snapshot', error);
+                return undefined;
+            }
+        },
+        async save(data) {
+            if (typeof window === 'undefined')
+                return;
+            try {
+                window.localStorage.setItem(key, toBase64(data));
+            }
+            catch (error) {
+                console.warn('Failed to persist CRDT snapshot', error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=localStorageStorage.js.map

package/dist/storages/localStorageStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorageStorage.js","sourceRoot":"","sources":["../../src/storages/localStorageStorage.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,KAAiB;IACjC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QAClB,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAMD,MAAM,UAAU,4BAA4B,CAAC,EAC3C,GAAG,GAC2B;IAC9B,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,OAAO,MAAM,KAAK,WAAW;gBAAE,OAAO,SAAS,CAAC;YACpD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,CAAC,GAAG;gBAAE,OAAO,SAAS,CAAC;YAC3B,IAAI,CAAC;gBACH,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;gBACtD,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAgB;YACzB,IAAI,OAAO,MAAM,KAAK,WAAW;gBAAE,OAAO;YAC1C,IAAI,CAAC;gBACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import {CrdtDocStorage} from '../createCrdtSlice';\n\nfunction toBase64(bytes: Uint8Array): string {\n  let binary = '';\n  bytes.forEach((b) => {\n    binary += String.fromCharCode(b);\n  });\n  return btoa(binary);\n}\n\nfunction fromBase64(encoded: string): Uint8Array {\n  const binary = atob(encoded);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i += 1) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n}\n\ntype LocalStorageDocStorageOptions = {\n  key: string;\n};\n\nexport function createLocalStorageDocStorage({\n  key,\n}: LocalStorageDocStorageOptions): CrdtDocStorage {\n  return {\n    async load() {\n      if (typeof window === 'undefined') return undefined;\n      const raw = window.localStorage.getItem(key);\n      if (!raw) return undefined;\n      try {\n        return fromBase64(raw);\n      } catch (error) {\n        console.warn('Failed to decode CRDT snapshot', error);\n        return undefined;\n      }\n    },\n    async save(data: Uint8Array) {\n      if (typeof window === 'undefined') return;\n      try {\n        window.localStorage.setItem(key, toBase64(data));\n      } catch (error) {\n        console.warn('Failed to persist CRDT snapshot', error);\n      }\n    },\n  };\n}\n"]}

package/dist/sync/webSocketSyncConnector.d.ts

@@ -0,0 +1,38 @@
+import { CrdtConnectionStatus, CrdtSyncConnector } from '../createCrdtSlice';
+type WebSocketLike = {
+    readyState: number;
+    send: (data: string | ArrayBufferLike | Blob | ArrayBufferView) => void;
+    close: () => void;
+    addEventListener: (type: string, listener: (...args: any[]) => void) => void;
+    removeEventListener: (type: string, listener: (...args: any[]) => void) => void;
+};
+export type WebSocketSyncOptions = {
+    url: string;
+    roomId: string;
+    token?: string;
+    params?: Record<string, string>;
+    protocols?: string | string[];
+    onStatus?: (status: Exclude<CrdtConnectionStatus, 'idle'>) => void;
+    createSocket?: (url: string, protocols?: string | string[]) => WebSocketLike;
+    sendSnapshotOnConnect?: boolean;
+    /**
+     * Optional per-tab client identifier. If omitted, the connector generates one via
+     * `crypto.randomUUID()` and persists it in `sessionStorage` (per-tab) by default.
+     */
+    clientId?: string;
+    /**
+     * Storage key used for persisting the generated clientId in `sessionStorage`.
+     *
+     * @defaultValue `"sqlrooms-crdt-clientId"`
+     */
+    clientIdStorageKey?: string;
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+};
+/**
+ * Creates a CRDT sync connector that exchanges Loro updates over WebSocket.
+ */
+export declare function createWebSocketSyncConnector(options: WebSocketSyncOptions): CrdtSyncConnector;
+export {};
+//# sourceMappingURL=webSocketSyncConnector.d.ts.map

package/dist/sync/webSocketSyncConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketSyncConnector.d.ts","sourceRoot":"","sources":["../../src/sync/webSocketSyncConnector.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,oBAAoB,EAAE,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AAE3E,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,GAAG,eAAe,KAAK,IAAI,CAAC;IACxE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IAC7E,mBAAmB,EAAE,CACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAC/B,IAAI,CAAC;CACX,CAAC;AAsDF,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACnE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,aAAa,CAAC;IAC7E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,iBAAiB,CAqdnB"}

package/dist/sync/webSocketSyncConnector.js

@@ -0,0 +1,500 @@
+import { LoroDoc } from 'loro-crdt';
+const WS_OPEN = 1;
+const WS_CONNECTING = 0;
+const getOrCreateClientId = (storageKey) => {
+    try {
+        const ss = globalThis.sessionStorage;
+        if (ss) {
+            const existing = ss.getItem(storageKey);
+            if (existing)
+                return existing;
+            const created = globalThis.crypto?.randomUUID?.();
+            const id = created ?? `client-${Math.random().toString(16).slice(2)}`;
+            ss.setItem(storageKey, id);
+            return id;
+        }
+    }
+    catch {
+        // ignore
+    }
+    const created = globalThis.crypto?.randomUUID?.();
+    return created ?? `client-${Math.random().toString(16).slice(2)}`;
+};
+const toBase64 = (bytes) => {
+    const buf = globalThis.Buffer;
+    if (buf) {
+        return buf.from(bytes).toString('base64');
+    }
+    let binary = '';
+    bytes.forEach((b) => {
+        binary += String.fromCharCode(b);
+    });
+    return btoa(binary);
+};
+const fromBase64 = (value) => {
+    const buf = globalThis.Buffer;
+    if (buf) {
+        return Uint8Array.from(buf.from(value, 'base64'));
+    }
+    const binary = atob(value);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1)
+        out[i] = binary.charCodeAt(i);
+    return out;
+};
+/**
+ * Creates a CRDT sync connector that exchanges Loro updates over WebSocket.
+ */
+export function createWebSocketSyncConnector(options) {
+    const sendSnapshotOnConnect = options.sendSnapshotOnConnect ?? true;
+    const clientId = options.clientId ??
+        getOrCreateClientId(options.clientIdStorageKey ?? `sqlrooms-crdt-clientId:${options.roomId}`);
+    let socket;
+    let unsubscribeLocal;
+    let subscribedDoc;
+    let attempt = 0;
+    let stopped = false;
+    let reconnectTimer;
+    let joined = false;
+    let snapshotApplied = false;
+    let snapshotWaitTimer;
+    let seededAfterEmptyServerSnapshot = false;
+    let connecting = false;
+    const pending = [];
+    let localSubscribed = false;
+    let listeningSocket;
+    let detachSocketListeners;
+    let statusListener;
+    const maxRetries = options.maxRetries ?? Infinity;
+    const initialDelay = options.initialDelayMs ?? 500;
+    const maxDelay = options.maxDelayMs ?? 5000;
+    const maybeSendUpdate = (update) => {
+        if (!socket || socket.readyState !== WS_OPEN) {
+            pending.push(update);
+            return;
+        }
+        if (!joined) {
+            pending.push(update);
+            return;
+        }
+        // IMPORTANT: don't send local updates until we've applied the server snapshot.
+        // Otherwise, a refreshing client that starts with empty local state can emit delete ops
+        // that wipe the room before the snapshot arrives.
+        if (!snapshotApplied) {
+            pending.push(update);
+            return;
+        }
+        socket.send(update);
+    };
+    const attachLocalSubscription = (doc) => {
+        try {
+            const unsub = doc.subscribeLocalUpdates((update) => {
+                // Pass through to shared handler so we keep centralized buffering/sending logic.
+                maybeSendUpdate(update);
+            });
+            unsubscribeLocal = () => {
+                try {
+                    unsub();
+                }
+                catch (error) {
+                    console.warn('[crdt] failed to unsubscribe local updates', error);
+                }
+            };
+            localSubscribed = true;
+        }
+        catch (error) {
+            console.warn('[crdt] failed to attach local subscription', error);
+            localSubscribed = false;
+            unsubscribeLocal = undefined;
+        }
+    };
+    /**
+     * Ensures we are subscribed to local updates on the *current* doc.
+     *
+     * This matters because this connector can be reused across reconnects and
+     * `connect(doc)` calls; we must not keep a stale subscription to a prior doc.
+     */
+    const ensureLocalSubscription = (doc) => {
+        if (subscribedDoc && subscribedDoc !== doc) {
+            unsubscribeLocal?.();
+            unsubscribeLocal = undefined;
+            localSubscribed = false;
+            subscribedDoc = undefined;
+        }
+        if (!localSubscribed || !unsubscribeLocal || subscribedDoc !== doc) {
+            attachLocalSubscription(doc);
+            subscribedDoc = doc;
+        }
+    };
+    const buildUrl = () => {
+        const url = new URL(options.url);
+        url.searchParams.set('roomId', options.roomId);
+        if (options.token)
+            url.searchParams.set('token', options.token);
+        if (options.params) {
+            Object.entries(options.params).forEach(([k, v]) => url.searchParams.set(k, v));
+        }
+        return url.toString();
+    };
+    const sendStatus = (status) => {
+        options.onStatus?.(status);
+        statusListener?.(status);
+    };
+    const sendJoin = () => {
+        if (!socket || socket.readyState !== WS_OPEN)
+            return;
+        const payload = JSON.stringify({
+            type: 'crdt-join',
+            roomId: options.roomId,
+            clientId,
+        });
+        socket.send(payload);
+    };
+    const sendSnapshot = (doc) => {
+        if (!socket || socket.readyState !== WS_OPEN)
+            return;
+        try {
+            const snapshot = doc.export({ mode: 'snapshot' });
+            const payload = JSON.stringify({
+                type: 'crdt-snapshot',
+                roomId: options.roomId,
+                data: toBase64(snapshot),
+            });
+            socket.send(payload);
+        }
+        catch (error) {
+            console.warn('Failed to send CRDT snapshot', error);
+        }
+    };
+    const scheduleReconnect = (doc) => {
+        if (stopped)
+            return;
+        if (reconnectTimer)
+            return;
+        if (connecting)
+            return;
+        if (attempt >= maxRetries) {
+            sendStatus('closed');
+            return;
+        }
+        const delay = Math.min(maxDelay, initialDelay * 2 ** attempt);
+        attempt += 1;
+        reconnectTimer = setTimeout(() => {
+            reconnectTimer = undefined;
+            void connect(doc);
+        }, delay);
+        // Avoid keeping the Node.js event loop alive in tests/SSR environments.
+        // No-op in browsers.
+        reconnectTimer?.unref?.();
+    };
+    const getEmptySnapshotLen = () => {
+        try {
+            return new LoroDoc().export({ mode: 'snapshot' }).byteLength;
+        }
+        catch {
+            return 0;
+        }
+    };
+    const connect = async (doc) => {
+        if (stopped)
+            return;
+        if (connecting)
+            return;
+        // Always ensure we are subscribed to the *current* doc.
+        ensureLocalSubscription(doc);
+        const attachSocketListenersFor = (ws) => {
+            // Ensure browser websockets deliver binary frames as ArrayBuffer (not Blob)
+            if ('binaryType' in ws) {
+                try {
+                    ws.binaryType = 'arraybuffer';
+                }
+                catch (error) {
+                    console.warn('Failed to set binaryType on CRDT websocket', error);
+                }
+            }
+            const handleMessage = (event) => {
+                // Use the currently connected doc reference (not the doc that created the socket),
+                // so a later connect(doc) call can rebind without needing a new WebSocket.
+                const activeDoc = subscribedDoc ?? doc;
+                if (!activeDoc)
+                    return;
+                // Binary updates flow directly
+                if (event.data instanceof ArrayBuffer ||
+                    ArrayBuffer.isView(event.data)) {
+                    const bytes = event.data instanceof ArrayBuffer
+                        ? new Uint8Array(event.data)
+                        : new Uint8Array(event.data.buffer, event.data.byteOffset, event.data.byteLength);
+                    activeDoc.import(bytes);
+                    return;
+                }
+                if (typeof Blob !== 'undefined' && event.data instanceof Blob) {
+                    void event.data
+                        .arrayBuffer()
+                        .then((buf) => {
+                        const bytes = new Uint8Array(buf);
+                        activeDoc.import(bytes);
+                    })
+                        .catch((error) => console.warn('Failed to decode CRDT binary message', error));
+                    return;
+                }
+                if (typeof event.data === 'string') {
+                    try {
+                        const parsed = JSON.parse(event.data);
+                        if (parsed?.type === 'crdt-joined') {
+                            joined = true;
+                            snapshotApplied = false;
+                            // IMPORTANT: do not flush buffered local updates yet.
+                            // The server sends `crdt-joined` before `crdt-snapshot`; flushing here can
+                            // broadcast "empty state" ops from a refreshing client and wipe the room.
+                            if (snapshotWaitTimer)
+                                clearTimeout(snapshotWaitTimer);
+                            snapshotWaitTimer = setTimeout(() => {
+                                snapshotWaitTimer = undefined;
+                                if (!ws || ws.readyState !== WS_OPEN)
+                                    return;
+                                // Fallback: if we never get a snapshot, avoid buffering forever.
+                                snapshotApplied = true;
+                                while (pending.length) {
+                                    const update = pending.shift();
+                                    if (update)
+                                        ws.send(update);
+                                }
+                            }, 2000);
+                            snapshotWaitTimer?.unref?.();
+                            return;
+                        }
+                        if (parsed?.type === 'crdt-snapshot' && parsed.data) {
+                            const bytes = fromBase64(parsed.data);
+                            // If the server snapshot is empty, but we already have non-empty local state,
+                            // don't import the empty snapshot (it would wipe local state). Instead, seed
+                            // the server once with our snapshot.
+                            try {
+                                const emptyLen = getEmptySnapshotLen();
+                                const serverLooksEmpty = bytes.byteLength <= emptyLen + 32;
+                                const localSnapshotLen = activeDoc.export({
+                                    mode: 'snapshot',
+                                }).byteLength;
+                                const localNonEmpty = localSnapshotLen > emptyLen + 32;
+                                if (serverLooksEmpty &&
+                                    localNonEmpty &&
+                                    !seededAfterEmptyServerSnapshot &&
+                                    ws &&
+                                    ws.readyState === WS_OPEN) {
+                                    seededAfterEmptyServerSnapshot = true;
+                                    // Seed the server; server will accept snapshot only if the room is empty.
+                                    sendSnapshot(activeDoc);
+                                    snapshotApplied = true;
+                                    if (snapshotWaitTimer) {
+                                        clearTimeout(snapshotWaitTimer);
+                                        snapshotWaitTimer = undefined;
+                                    }
+                                    return;
+                                }
+                            }
+                            catch {
+                                // ignore
+                            }
+                            activeDoc.import(bytes);
+                            snapshotApplied = true;
+                            if (snapshotWaitTimer) {
+                                clearTimeout(snapshotWaitTimer);
+                                snapshotWaitTimer = undefined;
+                            }
+                            // Now that we have base state, flush any local updates buffered during join.
+                            while (pending.length) {
+                                const update = pending.shift();
+                                if (update && ws && ws.readyState === WS_OPEN) {
+                                    ws.send(update);
+                                }
+                            }
+                        }
+                        // Ignore other messages (errors, acks) for now
+                    }
+                    catch (error) {
+                        console.warn('Failed to parse CRDT message', error);
+                    }
+                }
+            };
+            const handleOpen = () => {
+                attempt = 0;
+                joined = false;
+                snapshotApplied = false;
+                seededAfterEmptyServerSnapshot = false;
+                if (snapshotWaitTimer) {
+                    clearTimeout(snapshotWaitTimer);
+                    snapshotWaitTimer = undefined;
+                }
+                connecting = false;
+                sendStatus('open');
+                sendJoin();
+                if (sendSnapshotOnConnect) {
+                    sendSnapshot(doc);
+                }
+                ensureLocalSubscription(doc);
+            };
+            const handleClose = (event) => {
+                console.warn('CRDT WS closed', {
+                    code: event.code,
+                    reason: event.reason,
+                    pending: pending.length,
+                    joined,
+                });
+                connecting = false;
+                sendStatus('closed');
+                if (snapshotWaitTimer) {
+                    clearTimeout(snapshotWaitTimer);
+                    snapshotWaitTimer = undefined;
+                }
+                unsubscribeLocal?.();
+                unsubscribeLocal = undefined;
+                localSubscribed = false;
+                subscribedDoc = undefined;
+                joined = false;
+                pending.length = 0;
+                detachSocketListeners?.();
+                detachSocketListeners = undefined;
+                listeningSocket = undefined;
+                scheduleReconnect(doc);
+            };
+            const handleError = (event) => {
+                console.warn('CRDT WS error', event);
+                connecting = false;
+                sendStatus('error');
+                if (snapshotWaitTimer) {
+                    clearTimeout(snapshotWaitTimer);
+                    snapshotWaitTimer = undefined;
+                }
+                joined = false;
+                unsubscribeLocal?.();
+                unsubscribeLocal = undefined;
+                localSubscribed = false;
+                subscribedDoc = undefined;
+                detachSocketListeners?.();
+                detachSocketListeners = undefined;
+                listeningSocket = undefined;
+                scheduleReconnect(doc);
+            };
+            // Some WebSocket implementations expose either addEventListener or on*
+            // handlers. Use one style only to avoid duplicate events.
+            if (typeof ws.addEventListener === 'function') {
+                ws.addEventListener('message', handleMessage);
+                ws.addEventListener('open', handleOpen);
+                ws.addEventListener('close', handleClose);
+                ws.addEventListener('error', handleError);
+                detachSocketListeners = () => {
+                    try {
+                        ws.removeEventListener('message', handleMessage);
+                        ws.removeEventListener('open', handleOpen);
+                        ws.removeEventListener('close', handleClose);
+                        ws.removeEventListener('error', handleError);
+                    }
+                    catch (error) {
+                        console.warn('[crdt] failed to detach socket listeners', error);
+                    }
+                };
+            }
+            else {
+                ws.onmessage = handleMessage;
+                ws.onopen = handleOpen;
+                ws.onclose = handleClose;
+                ws.onerror = handleError;
+                detachSocketListeners = () => {
+                    try {
+                        ws.onmessage = null;
+                        ws.onopen = null;
+                        ws.onclose = null;
+                        ws.onerror = null;
+                    }
+                    catch (error) {
+                        console.warn('[crdt] failed to clear socket handlers', error);
+                    }
+                };
+            }
+            listeningSocket = ws;
+            // If we stay in CONNECTING too long, force a reconnect to avoid being stuck.
+            const connectingTimeout = setTimeout(() => {
+                if (ws && ws.readyState === WS_CONNECTING && !joined) {
+                    console.warn('[crdt] ws still connecting after timeout; retrying');
+                    try {
+                        ws.close();
+                    }
+                    catch (error) {
+                        console.warn('[crdt] error closing stuck socket', error);
+                    }
+                }
+            }, 3000);
+            // Avoid keeping the Node.js event loop alive in tests/SSR environments.
+            // No-op in browsers.
+            connectingTimeout?.unref?.();
+        };
+        if (socket &&
+            (socket.readyState === WS_OPEN || socket.readyState === WS_CONNECTING)) {
+            if (listeningSocket !== socket) {
+                console.warn('[crdt] existing socket had no listeners; attaching now');
+                attachSocketListenersFor(socket);
+                // If the socket is already open, we won't get an 'open' event, so act as if
+                // we just opened: (re)join and optionally send snapshot.
+                if (socket.readyState === WS_OPEN) {
+                    attempt = 0;
+                    joined = false;
+                    sendStatus('open');
+                    sendJoin();
+                    if (sendSnapshotOnConnect)
+                        sendSnapshot(doc);
+                }
+            }
+            return;
+        }
+        if (reconnectTimer) {
+            clearTimeout(reconnectTimer);
+            reconnectTimer = undefined;
+        }
+        connecting = true;
+        sendStatus('connecting');
+        const wsCreator = options.createSocket ??
+            ((url, protocols) => new WebSocket(url, protocols));
+        const url = buildUrl();
+        try {
+            socket = wsCreator(url, options.protocols);
+        }
+        catch (error) {
+            connecting = false;
+            sendStatus('error');
+            scheduleReconnect(doc);
+            return;
+        }
+        attachSocketListenersFor(socket);
+    };
+    const disconnect = async () => {
+        stopped = true;
+        if (reconnectTimer) {
+            clearTimeout(reconnectTimer);
+            reconnectTimer = undefined;
+        }
+        unsubscribeLocal?.();
+        unsubscribeLocal = undefined;
+        localSubscribed = false;
+        subscribedDoc = undefined;
+        detachSocketListeners?.();
+        detachSocketListeners = undefined;
+        listeningSocket = undefined;
+        if (socket) {
+            try {
+                socket.close();
+            }
+            catch (error) {
+                console.warn('Error closing CRDT websocket', error);
+            }
+        }
+        socket = undefined;
+        sendStatus('closed');
+    };
+    return {
+        connect,
+        disconnect,
+        setStatusListener: (listener) => {
+            statusListener = listener;
+        },
+    };
+}
+//# sourceMappingURL=webSocketSyncConnector.js.map

package/dist/sync/webSocketSyncConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketSyncConnector.js","sourceRoot":"","sources":["../../src/sync/webSocketSyncConnector.ts"],"names":[],"mappings":"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","sourcesContent":["import {LoroDoc} from 'loro-crdt';\nimport {CrdtConnectionStatus, CrdtSyncConnector} from '../createCrdtSlice';\n\ntype WebSocketLike = {\n  readyState: number;\n  send: (data: string | ArrayBufferLike | Blob | ArrayBufferView) => void;\n  close: () => void;\n  addEventListener: (type: string, listener: (...args: any[]) => void) => void;\n  removeEventListener: (\n    type: string,\n    listener: (...args: any[]) => void,\n  ) => void;\n};\n\nconst WS_OPEN = 1;\nconst WS_CONNECTING = 0;\n\nconst getOrCreateClientId = (storageKey: string) => {\n  try {\n    const ss = (globalThis as any).sessionStorage as Storage | undefined;\n    if (ss) {\n      const existing = ss.getItem(storageKey);\n      if (existing) return existing;\n      const created = (globalThis as any).crypto?.randomUUID?.() as\n        | string\n        | undefined;\n      const id = created ?? `client-${Math.random().toString(16).slice(2)}`;\n      ss.setItem(storageKey, id);\n      return id;\n    }\n  } catch {\n    // ignore\n  }\n  const created = (globalThis as any).crypto?.randomUUID?.() as\n    | string\n    | undefined;\n  return created ?? `client-${Math.random().toString(16).slice(2)}`;\n};\n\nconst toBase64 = (bytes: Uint8Array) => {\n  const buf = (globalThis as any).Buffer as\n    | {from: (input: Uint8Array) => {toString: (enc: string) => string}}\n    | undefined;\n  if (buf) {\n    return buf.from(bytes).toString('base64');\n  }\n  let binary = '';\n  bytes.forEach((b) => {\n    binary += String.fromCharCode(b);\n  });\n  return btoa(binary);\n};\n\nconst fromBase64 = (value: string) => {\n  const buf = (globalThis as any).Buffer as\n    | {from: (input: string, encoding: string) => Uint8Array}\n    | undefined;\n  if (buf) {\n    return Uint8Array.from(buf.from(value, 'base64'));\n  }\n  const binary = atob(value);\n  const out = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i += 1) out[i] = binary.charCodeAt(i);\n  return out;\n};\n\nexport type WebSocketSyncOptions = {\n  url: string;\n  roomId: string;\n  token?: string;\n  params?: Record<string, string>;\n  protocols?: string | string[];\n  onStatus?: (status: Exclude<CrdtConnectionStatus, 'idle'>) => void;\n  createSocket?: (url: string, protocols?: string | string[]) => WebSocketLike;\n  sendSnapshotOnConnect?: boolean;\n  /**\n   * Optional per-tab client identifier. If omitted, the connector generates one via\n   * `crypto.randomUUID()` and persists it in `sessionStorage` (per-tab) by default.\n   */\n  clientId?: string;\n  /**\n   * Storage key used for persisting the generated clientId in `sessionStorage`.\n   *\n   * @defaultValue `\"sqlrooms-crdt-clientId\"`\n   */\n  clientIdStorageKey?: string;\n  maxRetries?: number;\n  initialDelayMs?: number;\n  maxDelayMs?: number;\n};\n\n/**\n * Creates a CRDT sync connector that exchanges Loro updates over WebSocket.\n */\nexport function createWebSocketSyncConnector(\n  options: WebSocketSyncOptions,\n): CrdtSyncConnector {\n  const sendSnapshotOnConnect = options.sendSnapshotOnConnect ?? true;\n  const clientId =\n    options.clientId ??\n    getOrCreateClientId(\n      options.clientIdStorageKey ?? `sqlrooms-crdt-clientId:${options.roomId}`,\n    );\n  let socket: WebSocketLike | undefined;\n  let unsubscribeLocal: (() => void) | undefined;\n  let subscribedDoc: LoroDoc | undefined;\n  let attempt = 0;\n  let stopped = false;\n  let reconnectTimer: ReturnType<typeof setTimeout> | undefined;\n  let joined = false;\n  let snapshotApplied = false;\n  let snapshotWaitTimer: ReturnType<typeof setTimeout> | undefined;\n  let seededAfterEmptyServerSnapshot = false;\n  let connecting = false;\n  const pending: Uint8Array[] = [];\n  let localSubscribed = false;\n  let listeningSocket: WebSocketLike | undefined;\n  let detachSocketListeners: (() => void) | undefined;\n  let statusListener:\n    | ((status: Exclude<CrdtConnectionStatus, 'idle'>) => void)\n    | undefined;\n\n  const maxRetries = options.maxRetries ?? Infinity;\n  const initialDelay = options.initialDelayMs ?? 500;\n  const maxDelay = options.maxDelayMs ?? 5000;\n\n  const maybeSendUpdate = (update: Uint8Array) => {\n    if (!socket || socket.readyState !== WS_OPEN) {\n      pending.push(update);\n      return;\n    }\n    if (!joined) {\n      pending.push(update);\n      return;\n    }\n    // IMPORTANT: don't send local updates until we've applied the server snapshot.\n    // Otherwise, a refreshing client that starts with empty local state can emit delete ops\n    // that wipe the room before the snapshot arrives.\n    if (!snapshotApplied) {\n      pending.push(update);\n      return;\n    }\n    socket.send(update);\n  };\n\n  const attachLocalSubscription = (doc: LoroDoc) => {\n    try {\n      const unsub = doc.subscribeLocalUpdates((update: Uint8Array) => {\n        // Pass through to shared handler so we keep centralized buffering/sending logic.\n        maybeSendUpdate(update);\n      });\n      unsubscribeLocal = () => {\n        try {\n          unsub();\n        } catch (error) {\n          console.warn('[crdt] failed to unsubscribe local updates', error);\n        }\n      };\n      localSubscribed = true;\n    } catch (error) {\n      console.warn('[crdt] failed to attach local subscription', error);\n      localSubscribed = false;\n      unsubscribeLocal = undefined;\n    }\n  };\n\n  /**\n   * Ensures we are subscribed to local updates on the *current* doc.\n   *\n   * This matters because this connector can be reused across reconnects and\n   * `connect(doc)` calls; we must not keep a stale subscription to a prior doc.\n   */\n  const ensureLocalSubscription = (doc: LoroDoc) => {\n    if (subscribedDoc && subscribedDoc !== doc) {\n      unsubscribeLocal?.();\n      unsubscribeLocal = undefined;\n      localSubscribed = false;\n      subscribedDoc = undefined;\n    }\n    if (!localSubscribed || !unsubscribeLocal || subscribedDoc !== doc) {\n      attachLocalSubscription(doc);\n      subscribedDoc = doc;\n    }\n  };\n\n  const buildUrl = () => {\n    const url = new URL(options.url);\n    url.searchParams.set('roomId', options.roomId);\n    if (options.token) url.searchParams.set('token', options.token);\n    if (options.params) {\n      Object.entries(options.params).forEach(([k, v]) =>\n        url.searchParams.set(k, v),\n      );\n    }\n    return url.toString();\n  };\n\n  const sendStatus = (status: Exclude<CrdtConnectionStatus, 'idle'>) => {\n    options.onStatus?.(status);\n    statusListener?.(status);\n  };\n\n  const sendJoin = () => {\n    if (!socket || socket.readyState !== WS_OPEN) return;\n    const payload = JSON.stringify({\n      type: 'crdt-join',\n      roomId: options.roomId,\n      clientId,\n    });\n    socket.send(payload);\n  };\n\n  const sendSnapshot = (doc: LoroDoc) => {\n    if (!socket || socket.readyState !== WS_OPEN) return;\n    try {\n      const snapshot = doc.export({mode: 'snapshot'});\n      const payload = JSON.stringify({\n        type: 'crdt-snapshot',\n        roomId: options.roomId,\n        data: toBase64(snapshot),\n      });\n      socket.send(payload);\n    } catch (error) {\n      console.warn('Failed to send CRDT snapshot', error);\n    }\n  };\n\n  const scheduleReconnect = (doc: LoroDoc) => {\n    if (stopped) return;\n    if (reconnectTimer) return;\n    if (connecting) return;\n    if (attempt >= maxRetries) {\n      sendStatus('closed');\n      return;\n    }\n    const delay = Math.min(maxDelay, initialDelay * 2 ** attempt);\n    attempt += 1;\n    reconnectTimer = setTimeout(() => {\n      reconnectTimer = undefined;\n      void connect(doc);\n    }, delay);\n    // Avoid keeping the Node.js event loop alive in tests/SSR environments.\n    // No-op in browsers.\n    (reconnectTimer as any)?.unref?.();\n  };\n\n  const getEmptySnapshotLen = () => {\n    try {\n      return new LoroDoc().export({mode: 'snapshot'}).byteLength;\n    } catch {\n      return 0;\n    }\n  };\n\n  const connect = async (doc: LoroDoc) => {\n    if (stopped) return;\n    if (connecting) return;\n    // Always ensure we are subscribed to the *current* doc.\n    ensureLocalSubscription(doc);\n\n    const attachSocketListenersFor = (ws: WebSocketLike) => {\n      // Ensure browser websockets deliver binary frames as ArrayBuffer (not Blob)\n      if ('binaryType' in ws) {\n        try {\n          (ws as any).binaryType = 'arraybuffer';\n        } catch (error) {\n          console.warn('Failed to set binaryType on CRDT websocket', error);\n        }\n      }\n\n      const handleMessage = (event: any) => {\n        // Use the currently connected doc reference (not the doc that created the socket),\n        // so a later connect(doc) call can rebind without needing a new WebSocket.\n        const activeDoc = subscribedDoc ?? doc;\n        if (!activeDoc) return;\n        // Binary updates flow directly\n        if (\n          event.data instanceof ArrayBuffer ||\n          ArrayBuffer.isView(event.data)\n        ) {\n          const bytes =\n            event.data instanceof ArrayBuffer\n              ? new Uint8Array(event.data)\n              : new Uint8Array(\n                  event.data.buffer,\n                  event.data.byteOffset,\n                  event.data.byteLength,\n                );\n          activeDoc.import(bytes);\n          return;\n        }\n        if (typeof Blob !== 'undefined' && event.data instanceof Blob) {\n          void event.data\n            .arrayBuffer()\n            .then((buf: ArrayBuffer) => {\n              const bytes = new Uint8Array(buf);\n              activeDoc.import(bytes);\n            })\n            .catch((error: unknown) =>\n              console.warn('Failed to decode CRDT binary message', error),\n            );\n          return;\n        }\n\n        if (typeof event.data === 'string') {\n          try {\n            const parsed = JSON.parse(event.data);\n            if (parsed?.type === 'crdt-joined') {\n              joined = true;\n              snapshotApplied = false;\n              // IMPORTANT: do not flush buffered local updates yet.\n              // The server sends `crdt-joined` before `crdt-snapshot`; flushing here can\n              // broadcast \"empty state\" ops from a refreshing client and wipe the room.\n              if (snapshotWaitTimer) clearTimeout(snapshotWaitTimer);\n              snapshotWaitTimer = setTimeout(() => {\n                snapshotWaitTimer = undefined;\n                if (!ws || ws.readyState !== WS_OPEN) return;\n                // Fallback: if we never get a snapshot, avoid buffering forever.\n                snapshotApplied = true;\n                while (pending.length) {\n                  const update = pending.shift();\n                  if (update) ws.send(update);\n                }\n              }, 2000);\n              (snapshotWaitTimer as any)?.unref?.();\n              return;\n            }\n            if (parsed?.type === 'crdt-snapshot' && parsed.data) {\n              const bytes = fromBase64(parsed.data);\n              // If the server snapshot is empty, but we already have non-empty local state,\n              // don't import the empty snapshot (it would wipe local state). Instead, seed\n              // the server once with our snapshot.\n              try {\n                const emptyLen = getEmptySnapshotLen();\n                const serverLooksEmpty = bytes.byteLength <= emptyLen + 32;\n                const localSnapshotLen = activeDoc.export({\n                  mode: 'snapshot',\n                }).byteLength;\n                const localNonEmpty = localSnapshotLen > emptyLen + 32;\n                if (\n                  serverLooksEmpty &&\n                  localNonEmpty &&\n                  !seededAfterEmptyServerSnapshot &&\n                  ws &&\n                  ws.readyState === WS_OPEN\n                ) {\n                  seededAfterEmptyServerSnapshot = true;\n                  // Seed the server; server will accept snapshot only if the room is empty.\n                  sendSnapshot(activeDoc);\n                  snapshotApplied = true;\n                  if (snapshotWaitTimer) {\n                    clearTimeout(snapshotWaitTimer);\n                    snapshotWaitTimer = undefined;\n                  }\n                  return;\n                }\n              } catch {\n                // ignore\n              }\n\n              activeDoc.import(bytes);\n              snapshotApplied = true;\n              if (snapshotWaitTimer) {\n                clearTimeout(snapshotWaitTimer);\n                snapshotWaitTimer = undefined;\n              }\n              // Now that we have base state, flush any local updates buffered during join.\n              while (pending.length) {\n                const update = pending.shift();\n                if (update && ws && ws.readyState === WS_OPEN) {\n                  ws.send(update);\n                }\n              }\n            }\n            // Ignore other messages (errors, acks) for now\n          } catch (error) {\n            console.warn('Failed to parse CRDT message', error);\n          }\n        }\n      };\n\n      const handleOpen = () => {\n        attempt = 0;\n        joined = false;\n        snapshotApplied = false;\n        seededAfterEmptyServerSnapshot = false;\n        if (snapshotWaitTimer) {\n          clearTimeout(snapshotWaitTimer);\n          snapshotWaitTimer = undefined;\n        }\n        connecting = false;\n        sendStatus('open');\n        sendJoin();\n        if (sendSnapshotOnConnect) {\n          sendSnapshot(doc);\n        }\n        ensureLocalSubscription(doc);\n      };\n\n      const handleClose = (event: CloseEvent) => {\n        console.warn('CRDT WS closed', {\n          code: event.code,\n          reason: event.reason,\n          pending: pending.length,\n          joined,\n        });\n        connecting = false;\n        sendStatus('closed');\n        if (snapshotWaitTimer) {\n          clearTimeout(snapshotWaitTimer);\n          snapshotWaitTimer = undefined;\n        }\n        unsubscribeLocal?.();\n        unsubscribeLocal = undefined;\n        localSubscribed = false;\n        subscribedDoc = undefined;\n        joined = false;\n        pending.length = 0;\n        detachSocketListeners?.();\n        detachSocketListeners = undefined;\n        listeningSocket = undefined;\n        scheduleReconnect(doc);\n      };\n\n      const handleError = (event: Event) => {\n        console.warn('CRDT WS error', event);\n        connecting = false;\n        sendStatus('error');\n        if (snapshotWaitTimer) {\n          clearTimeout(snapshotWaitTimer);\n          snapshotWaitTimer = undefined;\n        }\n        joined = false;\n        unsubscribeLocal?.();\n        unsubscribeLocal = undefined;\n        localSubscribed = false;\n        subscribedDoc = undefined;\n        detachSocketListeners?.();\n        detachSocketListeners = undefined;\n        listeningSocket = undefined;\n        scheduleReconnect(doc);\n      };\n\n      // Some WebSocket implementations expose either addEventListener or on*\n      // handlers. Use one style only to avoid duplicate events.\n      if (typeof ws.addEventListener === 'function') {\n        ws.addEventListener('message', handleMessage);\n        ws.addEventListener('open', handleOpen);\n        ws.addEventListener('close', handleClose);\n        ws.addEventListener('error', handleError);\n        detachSocketListeners = () => {\n          try {\n            ws.removeEventListener('message', handleMessage);\n            ws.removeEventListener('open', handleOpen);\n            ws.removeEventListener('close', handleClose);\n            ws.removeEventListener('error', handleError);\n          } catch (error) {\n            console.warn('[crdt] failed to detach socket listeners', error);\n          }\n        };\n      } else {\n        (ws as any).onmessage = handleMessage;\n        (ws as any).onopen = handleOpen;\n        (ws as any).onclose = handleClose;\n        (ws as any).onerror = handleError;\n        detachSocketListeners = () => {\n          try {\n            (ws as any).onmessage = null;\n            (ws as any).onopen = null;\n            (ws as any).onclose = null;\n            (ws as any).onerror = null;\n          } catch (error) {\n            console.warn('[crdt] failed to clear socket handlers', error);\n          }\n        };\n      }\n      listeningSocket = ws;\n\n      // If we stay in CONNECTING too long, force a reconnect to avoid being stuck.\n      const connectingTimeout = setTimeout(() => {\n        if (ws && ws.readyState === WS_CONNECTING && !joined) {\n          console.warn('[crdt] ws still connecting after timeout; retrying');\n          try {\n            ws.close();\n          } catch (error) {\n            console.warn('[crdt] error closing stuck socket', error);\n          }\n        }\n      }, 3000);\n      // Avoid keeping the Node.js event loop alive in tests/SSR environments.\n      // No-op in browsers.\n      (connectingTimeout as any)?.unref?.();\n    };\n\n    if (\n      socket &&\n      (socket.readyState === WS_OPEN || socket.readyState === WS_CONNECTING)\n    ) {\n      if (listeningSocket !== socket) {\n        console.warn('[crdt] existing socket had no listeners; attaching now');\n        attachSocketListenersFor(socket);\n        // If the socket is already open, we won't get an 'open' event, so act as if\n        // we just opened: (re)join and optionally send snapshot.\n        if (socket.readyState === WS_OPEN) {\n          attempt = 0;\n          joined = false;\n          sendStatus('open');\n          sendJoin();\n          if (sendSnapshotOnConnect) sendSnapshot(doc);\n        }\n      }\n      return;\n    }\n    if (reconnectTimer) {\n      clearTimeout(reconnectTimer);\n      reconnectTimer = undefined;\n    }\n    connecting = true;\n    sendStatus('connecting');\n    const wsCreator =\n      options.createSocket ??\n      ((url, protocols) => new WebSocket(url, protocols));\n    const url = buildUrl();\n    try {\n      socket = wsCreator(url, options.protocols);\n    } catch (error) {\n      connecting = false;\n      sendStatus('error');\n      scheduleReconnect(doc);\n      return;\n    }\n    attachSocketListenersFor(socket);\n  };\n\n  const disconnect = async () => {\n    stopped = true;\n    if (reconnectTimer) {\n      clearTimeout(reconnectTimer);\n      reconnectTimer = undefined;\n    }\n    unsubscribeLocal?.();\n    unsubscribeLocal = undefined;\n    localSubscribed = false;\n    subscribedDoc = undefined;\n    detachSocketListeners?.();\n    detachSocketListeners = undefined;\n    listeningSocket = undefined;\n    if (socket) {\n      try {\n        socket.close();\n      } catch (error) {\n        console.warn('Error closing CRDT websocket', error);\n      }\n    }\n    socket = undefined;\n    sendStatus('closed');\n  };\n\n  return {\n    connect,\n    disconnect,\n    setStatusListener: (listener) => {\n      statusListener = listener as any;\n    },\n  };\n}\n"]}