@docukit/docsync 0.0.1-alpha.1 → 0.2.0-alpha.1

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

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

package/dist/src/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/client/types.js.map

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

package/dist/src/client/utils/BCHelper.d.ts

@@ -0,0 +1,21 @@
+import type { DocSyncClient } from "../index.js";
+type BroadcastMessage<O> = {
+    type: "OPERATIONS";
+    operations: O;
+    docId: string;
+    presence?: Record<string, unknown>;
+} | {
+    type: "PRESENCE";
+    docId: string;
+    presence: Record<string, unknown>;
+};
+export declare class BCHelper<D extends {}, S extends {}, O extends {} = {}> {
+    private _channel;
+    constructor(client: DocSyncClient<D, S, O>, userId: string);
+    private _applyOperations;
+    broadcast(message: BroadcastMessage<O>): void;
+    /** Close the underlying channel (e.g. for test cleanup). */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=BCHelper.d.ts.map

package/dist/src/client/utils/BCHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BCHelper.d.ts","sourceRoot":"","sources":["../../../../src/client/utils/BCHelper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,KAAK,gBAAgB,CAAC,CAAC,IACnB;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,CAAC,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE3E,qBAAa,QAAQ,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACjE,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM;YA4B5C,gBAAgB;IAmB9B,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAI7C,4DAA4D;IAC5D,KAAK,IAAI,IAAI;CAGd"}

package/dist/src/client/utils/BCHelper.js

@@ -0,0 +1,57 @@
+/* eslint-disable @typescript-eslint/no-empty-object-type */
+import { applyPresencePatch } from "./applyPresencePatch.js";
+export class BCHelper {
+    _channel;
+    constructor(client, userId) {
+        const channelName = `docsync:${userId}`;
+        this._channel = new BroadcastChannel(channelName);
+        this._channel.onmessage = (ev) => {
+            const msg = ev.data;
+            if (msg.type === "OPERATIONS") {
+                const { docId, operations, presence } = msg;
+                const currentStatus = client["_pushStatusByDocId"].get(docId) ?? "idle";
+                if (currentStatus === "pushing") {
+                    client["_pushStatusByDocId"].set(docId, "pushing-with-pending");
+                }
+                void this._applyOperations(client, operations, docId);
+                if (presence) {
+                    const cacheEntry = client["_docsCache"].get(docId);
+                    if (cacheEntry)
+                        applyPresencePatch(client["_clientId"], cacheEntry, presence);
+                }
+                return;
+            }
+            if (msg.type === "PRESENCE") {
+                const { docId, presence } = msg;
+                const cacheEntry = client["_docsCache"].get(docId);
+                if (!cacheEntry)
+                    return;
+                applyPresencePatch(client["_clientId"], cacheEntry, presence);
+            }
+        };
+    }
+    async _applyOperations(client, operations, docId) {
+        const cacheEntry = client["_docsCache"].get(docId);
+        if (!cacheEntry)
+            return;
+        const doc = await cacheEntry.promisedDoc;
+        if (!doc)
+            return;
+        client["_shouldBroadcast"] = false;
+        client["_docBinding"].applyOperations(doc, operations);
+        client["_shouldBroadcast"] = true;
+        client["_events"].emit("change", {
+            docId,
+            origin: "broadcast",
+            operations: [operations],
+        });
+    }
+    broadcast(message) {
+        this._channel.postMessage(message);
+    }
+    /** Close the underlying channel (e.g. for test cleanup). */
+    close() {
+        this._channel.close();
+    }
+}
+//# sourceMappingURL=BCHelper.js.map

package/dist/src/client/utils/BCHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BCHelper.js","sourceRoot":"","sources":["../../../../src/client/utils/BCHelper.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAG5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAW7D,MAAM,OAAO,QAAQ;IACX,QAAQ,CAAmB;IAEnC,YAAY,MAA8B,EAAE,MAAc;QACxD,MAAM,WAAW,GAAG,WAAW,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAqC,EAAE,EAAE;YAClE,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;YACpB,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC9B,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;gBAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;gBACxE,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;oBAChC,MAAM,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;gBAClE,CAAC;gBACD,KAAK,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBACtD,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACnD,IAAI,UAAU;wBACZ,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAClE,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC5B,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;gBAChC,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnD,IAAI,CAAC,UAAU;oBAAE,OAAO;gBACxB,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAChE,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,MAA8B,EAC9B,UAAa,EACb,KAAa;QAEb,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU;YAAE,OAAO;QACxB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC;QACnC,MAAM,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC/B,KAAK;YACL,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,CAAC,UAAU,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAA4B;QACpC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,4DAA4D;IAC5D,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/src/client/utils/applyPresencePatch.d.ts

@@ -0,0 +1,11 @@
+import type { Presence } from "../../shared/types.js";
+/**
+ * Applies a presence patch to a cache entry: merges patch into presence,
+ * skips own clientId, notifies presence listeners.
+ * Used by server-initiated presence, setPresence, and BCHelper.
+ */
+export declare function applyPresencePatch(clientId: string, cacheEntry: {
+    presence: Presence;
+    presenceListeners: Set<(presence: Presence) => void>;
+}, patch: Record<string, unknown>): void;
+//# sourceMappingURL=applyPresencePatch.d.ts.map

package/dist/src/client/utils/applyPresencePatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPresencePatch.d.ts","sourceRoot":"","sources":["../../../../src/client/utils/applyPresencePatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE;IACV,QAAQ,EAAE,QAAQ,CAAC;IACnB,iBAAiB,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC;CACtD,EACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAcN"}

package/dist/src/client/utils/applyPresencePatch.js

@@ -0,0 +1,21 @@
+/**
+ * Applies a presence patch to a cache entry: merges patch into presence,
+ * skips own clientId, notifies presence listeners.
+ * Used by server-initiated presence, setPresence, and BCHelper.
+ */
+export function applyPresencePatch(clientId, cacheEntry, patch) {
+    const newPresence = { ...cacheEntry.presence };
+    for (const [key, value] of Object.entries(patch)) {
+        if (key === clientId)
+            continue; // never store own presence in cache
+        if (value === undefined || value === null) {
+            delete newPresence[key];
+        }
+        else {
+            newPresence[key] = value;
+        }
+    }
+    cacheEntry.presence = newPresence;
+    cacheEntry.presenceListeners.forEach((listener) => listener(cacheEntry.presence));
+}
+//# sourceMappingURL=applyPresencePatch.js.map

package/dist/src/client/utils/applyPresencePatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPresencePatch.js","sourceRoot":"","sources":["../../../../src/client/utils/applyPresencePatch.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,UAGC,EACD,KAA8B;IAE9B,MAAM,WAAW,GAAG,EAAE,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,QAAQ;YAAE,SAAS,CAAC,oCAAoC;QACpE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,UAAU,CAAC,QAAQ,GAAG,WAAW,CAAC;IAClC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAChD,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC9B,CAAC;AACJ,CAAC"}

package/dist/src/client/utils/createSocket.d.ts

@@ -0,0 +1,4 @@
+import type { DocSyncClient } from "../index.js";
+import type { ClientConfig, ClientSocket } from "../types.js";
+export declare function createSocket<D extends {}, S extends {}, O extends {}>(client: DocSyncClient<D, S, O>, config: ClientConfig<D, S, O>): ClientSocket<S, O>;
+//# sourceMappingURL=createSocket.d.ts.map

package/dist/src/client/utils/createSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSocket.d.ts","sourceRoot":"","sources":["../../../../src/client/utils/createSocket.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D,wBAAgB,YAAY,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,EACnE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC5B,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAcpB"}

package/dist/src/client/utils/createSocket.js

@@ -0,0 +1,29 @@
+import { io } from "socket.io-client";
+export function createSocket(client, config) {
+    // deviceId needs to be captured at construction, not in the auth callback,
+    // to avoid race conditions.
+    const deviceId = getDeviceId();
+    return io(config.server.url, {
+        auth: (cb) => {
+            void config.server.auth.getToken().then((token) => {
+                cb({ token, deviceId, clientId: client["_clientId"] });
+            });
+        },
+        transports: ["websocket"], // Skip polling, go straight to WebSocket for performance
+        ackTimeout: 5000,
+    });
+}
+/**
+ * Get or create a unique device ID stored in localStorage.
+ * This ID is shared across all tabs/windows on the same device.
+ */
+function getDeviceId() {
+    const key = "docsync:deviceId";
+    let deviceId = localStorage.getItem(key);
+    if (!deviceId) {
+        deviceId = crypto.randomUUID();
+        localStorage.setItem(key, deviceId);
+    }
+    return deviceId;
+}
+//# sourceMappingURL=createSocket.js.map

package/dist/src/client/utils/createSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSocket.js","sourceRoot":"","sources":["../../../../src/client/utils/createSocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAItC,MAAM,UAAU,YAAY,CAC1B,MAA8B,EAC9B,MAA6B;IAE7B,2EAA2E;IAC3E,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QAC3B,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;YACX,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBAChD,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,yDAAyD;QACpF,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,kBAAkB,CAAC;IAC/B,IAAI,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/B,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/client/utils/events.d.ts

@@ -0,0 +1,46 @@
+import type { SyncRequest, SyncResponse } from "../../shared/types.js";
+export type DisconnectEvent = {
+    reason: string;
+};
+export type ChangeEvent<O = unknown> = {
+    docId: string;
+    origin: "local" | "broadcast" | "remote";
+    operations: O[];
+};
+/** Emitted once after sync completes (success or error). */
+export type SyncEvent<O = unknown, S = unknown> = {
+    req: SyncRequest<O>;
+} & (SyncResponse<S, O> | {
+    error: {
+        type: "NetworkError";
+        message: string;
+    };
+    data?: never;
+});
+export type DocLoadEvent = {
+    docId: string;
+    source: "cache" | "local" | "created";
+    refCount: number;
+};
+export type DocUnloadEvent = {
+    docId: string;
+    refCount: number;
+};
+export type ClientEventMap<O = unknown, S = unknown> = {
+    connect: undefined;
+    disconnect: DisconnectEvent;
+    change: ChangeEvent<O>;
+    sync: SyncEvent<O, S>;
+    docLoad: DocLoadEvent;
+    docUnload: DocUnloadEvent;
+};
+export type ClientEventName = keyof ClientEventMap;
+export type ClientEventEmitter<O = unknown, S = unknown> = {
+    listeners: {
+        [K in ClientEventName]: Set<(payload: ClientEventMap<O, S>[K]) => void>;
+    };
+    on<K extends ClientEventName>(event: K, cb: (payload: ClientEventMap<O, S>[K]) => void): () => void;
+    emit<K extends ClientEventName>(event: K, payload?: ClientEventMap<O, S>[K]): void;
+};
+export declare function createClientEventEmitter<O = unknown, S = unknown>(): ClientEventEmitter<O, S>;
+//# sourceMappingURL=events.d.ts.map

package/dist/src/client/utils/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/client/utils/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAMvE,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzC,UAAU,EAAE,CAAC,EAAE,CAAC;CACjB,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,CACxE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,CACrE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAMjE,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACrD,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACzD,SAAS,EAAE;SACR,CAAC,IAAI,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;KACxE,CAAC;IACF,EAAE,CAAC,CAAC,SAAS,eAAe,EAC1B,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAC7C,MAAM,IAAI,CAAC;IACd,IAAI,CAAC,CAAC,SAAS,eAAe,EAC5B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAChC,IAAI,CAAC;CACT,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,CAAC,GAAG,OAAO,EACX,CAAC,GAAG,OAAO,KACR,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAkC5B"}

package/dist/src/client/utils/events.js

@@ -0,0 +1,25 @@
+export function createClientEventEmitter() {
+    const listeners = {
+        connect: new Set(),
+        disconnect: new Set(),
+        change: new Set(),
+        sync: new Set(),
+        docLoad: new Set(),
+        docUnload: new Set(),
+    };
+    function on(event, cb) {
+        const set = listeners[event];
+        set.add(cb);
+        return () => {
+            set.delete(cb);
+        };
+    }
+    function emit(event, payload) {
+        const set = listeners[event];
+        for (const fn of set) {
+            fn(payload);
+        }
+    }
+    return { listeners, on, emit };
+}
+//# sourceMappingURL=events.js.map

package/dist/src/client/utils/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/client/utils/events.ts"],"names":[],"mappings":"AAyDA,MAAM,UAAU,wBAAwB;IAItC,MAAM,SAAS,GAEX;QACF,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,SAAS,EAAE,IAAI,GAAG,EAAE;KACrB,CAAC;IAEF,SAAS,EAAE,CACT,KAAQ,EACR,EAA8C;QAE9C,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,GAAG,CAAC,GAAG,CAAC,EAAwD,CAAC,CAAC;QAClE,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,MAAM,CAAC,EAAwD,CAAC,CAAC;QACvE,CAAC,CAAC;IACJ,CAAC;IAED,SAAS,IAAI,CACX,KAAQ,EACR,OAAiC;QAEjC,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACpB,EAAuD,CAAC,OAAO,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/src/client/utils/getDeviceId.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Get or create a unique device ID stored in localStorage.
+ * This ID is shared across all tabs/windows on the same device.
+ */
+export declare function getDeviceId(): string;
+//# sourceMappingURL=getDeviceId.d.ts.map

package/dist/src/client/utils/getDeviceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeviceId.d.ts","sourceRoot":"","sources":["../../../../src/client/utils/getDeviceId.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAQpC"}

package/dist/src/client/utils/getDeviceId.js

@@ -0,0 +1,14 @@
+/**
+ * Get or create a unique device ID stored in localStorage.
+ * This ID is shared across all tabs/windows on the same device.
+ */
+export function getDeviceId() {
+    const key = "docsync:deviceId";
+    let deviceId = localStorage.getItem(key);
+    if (!deviceId) {
+        deviceId = crypto.randomUUID();
+        localStorage.setItem(key, deviceId);
+    }
+    return deviceId;
+}
+//# sourceMappingURL=getDeviceId.js.map

package/dist/src/client/utils/getDeviceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeviceId.js","sourceRoot":"","sources":["../../../../src/client/utils/getDeviceId.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,kBAAkB,CAAC;IAC/B,IAAI,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/B,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/client/utils/getOwnPresencePatch.d.ts

@@ -0,0 +1,3 @@
+import type { DocSyncClient } from "../index.js";
+export declare function getOwnPresencePatch(client: DocSyncClient, docId: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=getOwnPresencePatch.d.ts.map

package/dist/src/client/utils/getOwnPresencePatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnPresencePatch.d.ts","sourceRoot":"","sources":["../../../../src/client/utils/getOwnPresencePatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOrC"}

package/dist/src/client/utils/getOwnPresencePatch.js

@@ -0,0 +1,10 @@
+export function getOwnPresencePatch(client, docId) {
+    const debounced = client["_presenceDebounceState"].get(docId);
+    if (debounced)
+        return { [client["_clientId"]]: debounced.data };
+    const cacheEntry = client["_docsCache"].get(docId);
+    if (cacheEntry?.presence[client["_clientId"]] !== undefined)
+        return { [client["_clientId"]]: cacheEntry.presence[client["_clientId"]] };
+    return undefined;
+}
+//# sourceMappingURL=getOwnPresencePatch.js.map

package/dist/src/client/utils/getOwnPresencePatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnPresencePatch.js","sourceRoot":"","sources":["../../../../src/client/utils/getOwnPresencePatch.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,KAAa;IAEb,MAAM,SAAS,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,SAAS;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,SAAS;QACzD,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;IAC7E,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/client/utils/request.d.ts

@@ -0,0 +1,10 @@
+import type { ClientToServerEvents } from "../../shared/types.js";
+import type { ClientSocket } from "../types.js";
+type ResponseOf<S, O, E extends keyof ClientToServerEvents<S, O>> = Parameters<Parameters<ClientToServerEvents<S, O>[E]>[1]>[0];
+/**
+ * Send a request to the server for a DocSync event and return the response.
+ * Applies a timeout to avoid hanging if the socket disconnects during the request.
+ */
+export declare function request<S, O, E extends keyof ClientToServerEvents<S, O>>(socket: ClientSocket<S, O>, event: E, payload: Parameters<ClientToServerEvents<S, O>[E]>[0], timeoutMs?: number): Promise<ResponseOf<S, O, E>>;
+export {};
+//# sourceMappingURL=request.d.ts.map

package/dist/src/client/utils/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../../src/client/utils/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,UAAU,CAC5E,UAAU,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC7C,CAAC,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,EACtE,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACrD,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAe9B"}

package/dist/src/client/utils/request.js

@@ -0,0 +1,15 @@
+const DEFAULT_REQUEST_TIMEOUT_MS = 5000;
+/**
+ * Send a request to the server for a DocSync event and return the response.
+ * Applies a timeout to avoid hanging if the socket disconnects during the request.
+ */
+export function request(socket, event, payload, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error(`Request timeout: ${String(event)}`)), timeoutMs);
+        socket.emit(event, payload, (response) => {
+            clearTimeout(timeout);
+            resolve(response);
+        });
+    });
+}
+//# sourceMappingURL=request.js.map

package/dist/src/client/utils/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../src/client/utils/request.ts"],"names":[],"mappings":"AAGA,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAMxC;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,MAA0B,EAC1B,KAAQ,EACR,OAAqD,EACrD,YAAoB,0BAA0B;IAE9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAC5D,SAAS,CACV,CAAC;QACD,MAAM,CAAC,IAAgE,CACtE,KAAK,EACL,OAAO,EACP,CAAC,QAAQ,EAAE,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,QAA+B,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/exports/client.d.ts

@@ -1,4 +1,7 @@
+export { createDocBinding } from "../bindings/index.js";
 export { DocSyncClient } from "../client/index.js";
 export { IndexedDBProvider } from "../client/providers/indexeddb.js";
-export type { ClientConfig, GetDocArgs, DocData, Identity, QueryResult, Presence, } from "../shared/types.js";
+export type { DocBinding, Presence } from "../shared/types.js";
+export type { ChangeEvent, ClientEventMap, ClientEventName, DisconnectEvent, DocLoadEvent, DocUnloadEvent, SyncEvent, } from "../client/utils/events.js";
+export type { ClientConfig, ClientProvider, GetDocArgs, DocData, Identity, QueryResult, } from "../client/types.js";
 //# sourceMappingURL=client.d.ts.map

package/dist/src/exports/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EACV,YAAY,EACZ,UAAU,EACV,OAAO,EACP,QAAQ,EACR,WAAW,EACX,QAAQ,GACT,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,OAAO,EACP,QAAQ,EACR,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/src/exports/client.js

@@ -1,3 +1,4 @@
+export { createDocBinding } from "../bindings/index.js";
 export { DocSyncClient } from "../client/index.js";
 export { IndexedDBProvider } from "../client/providers/indexeddb.js";
 //# sourceMappingURL=client.js.map

package/dist/src/exports/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/src/exports/docnode.d.ts

@@ -1,2 +1,2 @@
-export { DocNodeBinding } from "../shared/docBinding.js";
+export { DocNodeBinding } from "../bindings/docnode.js";
 //# sourceMappingURL=docnode.d.ts.map

package/dist/src/exports/docnode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docnode.d.ts","sourceRoot":"","sources":["../../../src/exports/docnode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"docnode.d.ts","sourceRoot":"","sources":["../../../src/exports/docnode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/exports/docnode.js

@@ -1,2 +1,2 @@
-export { DocNodeBinding } from "../shared/docBinding.js";
+export { DocNodeBinding } from "../bindings/docnode.js";
 //# sourceMappingURL=docnode.js.map

package/dist/src/exports/docnode.js.map

@@ -1 +1 @@
-{"version":3,"file":"docnode.js","sourceRoot":"","sources":["../../../src/exports/docnode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"docnode.js","sourceRoot":"","sources":["../../../src/exports/docnode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/exports/server.d.ts

@@ -1,5 +1,5 @@
 export { DocSyncServer } from "../server/index.js";
-export type { ServerConfig } from "../shared/types.js";
+export type { ServerConfig, ServerProvider, ClientConnectEvent, ClientDisconnectEvent, SyncRequestEvent, } from "../server/types.js";
 export { PostgresProvider } from "../server/providers/postgres/index.js";
 export { InMemoryServerProvider } from "../server/providers/memory.js";
 //# sourceMappingURL=server.d.ts.map

package/dist/src/exports/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/exports/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/exports/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/exports/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/exports/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/exports/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/exports/shared.d.ts

@@ -0,0 +1,2 @@
+export * from "../shared/types.js";
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/exports/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/exports/shared.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/src/exports/shared.js

@@ -0,0 +1,2 @@
+export * from "../shared/types.js";
+//# sourceMappingURL=shared.js.map

package/dist/src/exports/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/exports/shared.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/src/server/cli.js

@@ -5,6 +5,6 @@ new DocSyncServer({
     docBinding: DocNodeBinding([]),
     port: 8081,
     provider: PostgresProvider,
-    authenticate: async () => ({ userId: "John" }),
+    authenticate: () => ({ userId: "John" }),
 });
 //# sourceMappingURL=cli.js.map

package/dist/src/server/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/server/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,IAAI,aAAa,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC;IAC9B,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,gBAAgB;IAC1B,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;CAC/C,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/server/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,IAAI,aAAa,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC;IAC9B,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,gBAAgB;IAC1B,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;CACzC,CAAC,CAAC"}

package/dist/src/server/handlers/connection/authenticationAndConnection.d.ts

@@ -0,0 +1,7 @@
+import type { DocSyncServer } from "../../index.js";
+import type { ServerConfig } from "../../types.js";
+/**
+ * Sets up auth middleware, connection_error handling, and connect event emission.
+ */
+export declare function handleAuthenticationAndConnection<TContext = {}, D extends {} = {}, S extends {} = {}, O extends {} = {}>(server: DocSyncServer<TContext, D, S, O>, authenticate: ServerConfig<TContext, D, S, O>["authenticate"]): void;
+//# sourceMappingURL=authenticationAndConnection.d.ts.map

package/dist/src/server/handlers/connection/authenticationAndConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticationAndConnection.d.ts","sourceRoot":"","sources":["../../../../../src/server/handlers/connection/authenticationAndConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,GAAG,EAAE,EACb,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EAEjB,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACxC,YAAY,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,GAC5D,IAAI,CAgEN"}

package/dist/src/server/handlers/connection/authenticationAndConnection.js

@@ -0,0 +1,57 @@
+/**
+ * Sets up auth middleware, connection_error handling, and connect event emission.
+ */
+export function handleAuthenticationAndConnection(server, authenticate) {
+    const io = server["_io"];
+    io.use((socket, next) => {
+        const { token, deviceId, clientId } = socket.handshake.auth;
+        if (!token || typeof token !== "string") {
+            next(new Error("Authentication required: no token provided"));
+            return;
+        }
+        if (!deviceId || typeof deviceId !== "string") {
+            next(new Error("Device ID required"));
+            return;
+        }
+        if (!clientId || typeof clientId !== "string" || clientId.length === 0) {
+            next(new Error("Client ID required"));
+            return;
+        }
+        authenticate({ token })
+            .then((authResult) => {
+            if (!authResult) {
+                next(new Error("Authentication failed: invalid token"));
+                return;
+            }
+            socket.data = {
+                userId: authResult.userId,
+                deviceId,
+                clientId,
+                context: authResult.context ?? {},
+            };
+            next();
+        })
+            .catch((err) => {
+            next(new Error(`Authentication error: ${String(err)}`));
+        });
+    });
+    io.engine.on("connection_error", (err) => {
+        const deviceId = err.req._query?.deviceId ?? "unknown";
+        server["_events"].emit("clientDisconnect", {
+            userId: "unknown",
+            deviceId,
+            socketId: "unknown",
+            reason: `Authentication failed: ${err.message}`,
+        });
+    });
+    io.on("connection", (socket) => {
+        const { userId, deviceId, context } = socket.data;
+        server["_events"].emit("clientConnect", {
+            userId,
+            deviceId,
+            socketId: socket.id,
+            context,
+        });
+    });
+}
+//# sourceMappingURL=authenticationAndConnection.js.map

package/dist/src/server/handlers/connection/authenticationAndConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticationAndConnection.js","sourceRoot":"","sources":["../../../../../src/server/handlers/connection/authenticationAndConnection.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAM/C,MAAwC,EACxC,YAA6D;IAE7D,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzB,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QAC5D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvE,IAAI,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;aACpB,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;YACnB,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,IAAI,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;gBACxD,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,GAAG;gBACZ,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,QAAQ;gBACR,QAAQ;gBACR,OAAO,EAAE,UAAU,CAAC,OAAO,IAAK,EAAe;aACP,CAAC;YAE3C,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,IAAI,CAAC,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,MAAM,CAAC,EAAE,CACV,kBAAkB,EAClB,CAAC,GAAiE,EAAE,EAAE;QACpE,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS,CAAC;QACvD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE;YACzC,MAAM,EAAE,SAAS;YACjB,QAAQ;YACR,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,0BAA0B,GAAG,CAAC,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QAElD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE;YACtC,MAAM;YACN,QAAQ;YACR,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/server/handlers/connection/disconnect.d.ts

@@ -0,0 +1,5 @@
+import type { DocSyncServer } from "../../index.js";
+export declare function handleDisconnect<TContext = {}, D extends {} = {}, S extends {} = {}, O extends {} = {}>({ server }: {
+    server: DocSyncServer<TContext, D, S, O>;
+}): void;
+//# sourceMappingURL=disconnect.d.ts.map

package/dist/src/server/handlers/connection/disconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.d.ts","sourceRoot":"","sources":["../../../../../src/server/handlers/connection/disconnect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,wBAAgB,gBAAgB,CAC9B,QAAQ,GAAG,EAAE,EACb,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAAE,GAAG,IAAI,CAyBhE"}

package/dist/src/server/handlers/connection/disconnect.js

@@ -0,0 +1,25 @@
+import { applyPresenceUpdate } from "../../utils/applyPresenceUpdate.js";
+export function handleDisconnect({ server }) {
+    const io = server["_io"];
+    io.on("connection", (socket) => {
+        socket.on("disconnect", (reason) => {
+            const { userId, deviceId } = socket.data;
+            const socketToDocsMap = server["_socketToDocsMap"];
+            const presenceByDoc = server["_presenceByDoc"];
+            const subscribedDocs = socketToDocsMap.get(socket.id);
+            if (subscribedDocs) {
+                for (const docId of subscribedDocs) {
+                    applyPresenceUpdate(presenceByDoc, socket, { docId, presence: null });
+                }
+                socketToDocsMap.delete(socket.id);
+            }
+            server["_events"].emit("clientDisconnect", {
+                userId,
+                deviceId,
+                socketId: socket.id,
+                reason,
+            });
+        });
+    });
+}
+//# sourceMappingURL=disconnect.js.map

package/dist/src/server/handlers/connection/disconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.js","sourceRoot":"","sources":["../../../../../src/server/handlers/connection/disconnect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,UAAU,gBAAgB,CAK9B,EAAE,MAAM,EAAgD;IACxD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACjC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;YACzC,MAAM,eAAe,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACnD,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC/C,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEtD,IAAI,cAAc,EAAE,CAAC;gBACnB,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;oBACnC,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxE,CAAC;gBAED,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE;gBACzC,MAAM;gBACN,QAAQ;gBACR,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,MAAM;aACP,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/server/handlers/deleteDoc.d.ts

@@ -0,0 +1,11 @@
+import type { DeleteDocRequest, DeleteDocResponse } from "../../shared/types.js";
+import type { ServerConnectionSocket } from "../types.js";
+import type { DocSyncServer } from "../index.js";
+export type DeleteDocHandler = (payload: DeleteDocRequest, cb: (res: DeleteDocResponse) => void) => void | Promise<void>;
+export declare const handleDeleteDoc: <TContext = {}>({ server, socket, userId, context, }: {
+    server: DocSyncServer<TContext>;
+    socket: ServerConnectionSocket<{}, {}>;
+    userId: string;
+    context: TContext;
+}) => void;
+//# sourceMappingURL=deleteDoc.d.ts.map

package/dist/src/server/handlers/deleteDoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteDoc.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/deleteDoc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,gBAAgB,EACzB,EAAE,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,KACjC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,eAAO,MAAM,eAAe,GAAI,QAAQ,GAAG,EAAE,EAAE,sCAK5C;IACD,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,EAAE,sBAAsB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;CACnB,KAAG,IAWH,CAAC"}