ooxml-core 1.19.2 → 1.21.0

package/dist/collab/index.cjs

@@ -653,107 +653,6 @@ var Emitter = class {
   }
 };
 
-// collab/external-provider.ts
-function adaptYjsProvider(provider) {
-  const events = new Emitter();
-  let destroyed = false;
-  let status = provider.wsconnected || provider.connected ? "connected" : provider.wsconnecting ? "connecting" : "disconnected";
-  let synced = Boolean(provider.synced);
-  const subscriptions = [];
-  const listen = (name, handler) => {
-    const wrapped = handler;
-    provider.on(name, wrapped);
-    subscriptions.push([name, wrapped]);
-  };
-  const setStatus = (next) => {
-    if (destroyed || next === status) return;
-    status = next;
-    events.emit("status", next);
-  };
-  const setSynced = (next) => {
-    if (destroyed || next === synced) return;
-    synced = next;
-    events.emit("synced", next);
-  };
-  listen("status", (payload) => {
-    if (typeof payload.connected === "boolean") {
-      if (!payload.connected) setSynced(false);
-      return setStatus(payload.connected ? "connected" : "disconnected");
-    }
-    if (payload.status === "connected" || payload.status === "connecting")
-      setStatus(payload.status);
-    else if (payload.status === "disconnected") {
-      setSynced(false);
-      setStatus("disconnected");
-    }
-  });
-  const onSync = (value) => setSynced(typeof value === "boolean" ? value : value.synced === true);
-  listen("sync", onSync);
-  listen("synced", onSync);
-  listen("connection-error", (cause) => {
-    if (destroyed) return;
-    setStatus("error");
-    events.emit("error", cause instanceof Error ? cause : new Error("Provider connection error"));
-  });
-  return {
-    get status() {
-      return status;
-    },
-    get synced() {
-      return synced;
-    },
-    connect: () => {
-      if (destroyed || status === "connected" || status === "connecting") return;
-      setStatus("connecting");
-      provider.connect?.();
-    },
-    disconnect: () => {
-      if (destroyed) return;
-      provider.disconnect?.();
-      setSynced(false);
-      setStatus("disconnected");
-    },
-    destroy: () => {
-      if (destroyed) return;
-      setSynced(false);
-      setStatus("disconnected");
-      destroyed = true;
-      for (const [name, handler] of subscriptions) provider.off?.(name, handler);
-      subscriptions.length = 0;
-      events.clear();
-      provider.destroy?.();
-    },
-    on: (event, listener) => events.on(event, listener)
-  };
-}
-function observeExternalSession(session, onSnapshot) {
-  let active = true;
-  let subscribing = true;
-  let previous;
-  let unsubscribe;
-  const notify = () => {
-    if (!active || subscribing) return;
-    const snapshot = session.getSnapshot();
-    if (previous?.status === snapshot.status && previous.synced === snapshot.synced) return;
-    previous = { status: snapshot.status, synced: snapshot.synced };
-    onSnapshot(previous);
-  };
-  const dispose = () => {
-    if (!active) return;
-    active = false;
-    unsubscribe?.();
-  };
-  try {
-    unsubscribe = session.subscribe(notify);
-    subscribing = false;
-    notify();
-  } catch (error) {
-    dispose();
-    throw error;
-  }
-  return dispose;
-}
-
 // collab/lifecycle.ts
 var COLLAB_LEAVE_MESSAGE = "ooxml-core:collab-leave";
 var DEPARTURE_CHANNEL = "ooxml-core:collab-departures";
@@ -836,250 +735,77 @@ function createDepartureChannel(roomId, awareness, factory, channelName = DEPART
   };
 }
 
-// collab/memory-transport.ts
-function createMemoryHub(options = {}) {
-  const rooms = /* @__PURE__ */ new Map();
-  let nextId = 0;
-  const deliver = (task) => {
-    if (options.async) queueMicrotask(task);
-    else task();
+// collab/provider.ts
+var CONNECTION_TIMEOUT_MS = 3e4;
+
+// collab/session.ts
+function createCollabSession(options) {
+  const roomId = validateRoomId(options.roomId);
+  const ownsDoc = !options.doc;
+  const doc = options.doc ?? new Y__namespace.Doc();
+  const awareness = new awarenessProtocol.Awareness(doc);
+  const events = new Emitter();
+  const role = options.user.role;
+  const identity = {
+    userName: sanitizeUserName(options.user.name),
+    userColor: sanitizeColor(options.user.color, assignUserColor(doc.clientID)),
+    userAvatar: options.user.avatar,
+    role
   };
-  return {
-    size: (roomId) => rooms.get(roomId)?.size ?? 0,
-    createTransport(roomId) {
-      const id = nextId++;
-      let endpoint = null;
-      const peers = () => {
-        let room = rooms.get(roomId);
-        if (!room) rooms.set(roomId, room = /* @__PURE__ */ new Set());
-        return room;
-      };
-      return {
-        get connected() {
-          return endpoint !== null;
-        },
-        connect(handlers) {
-          if (endpoint) peers().delete(endpoint);
-          const self = { id, handlers };
-          const others = [...peers()];
-          peers().add(self);
-          endpoint = self;
-          deliver(() => {
-            if (endpoint !== self) return;
-            handlers.open();
-            for (const other of others) other.handlers.peer?.();
-          });
-        },
-        send(data) {
-          const self = endpoint;
-          if (!self || options.filter && !options.filter(data, id)) return;
-          for (const other of [...peers()])
-            if (other !== self) deliver(() => other.handlers.message(data.slice()));
-        },
-        disconnect() {
-          const self = endpoint;
-          if (!self) return;
-          endpoint = null;
-          peers().delete(self);
-          self.handlers.close("disconnected");
-        }
-      };
-    }
+  const sanitizePayload = options.sanitizePayload ?? (() => ({}));
+  const publisher = createPresencePublisher(
+    awareness,
+    identity,
+    options.initialPresence ?? {}
+  );
+  let destroyed = false;
+  let timeout = null;
+  const gate = createSyncGate(() => {
+    if (destroyed) return;
+    options.onReady?.({ synced: provider.synced });
+    events.emit("ready", void 0);
+  }, options.syncGraceMs ?? INITIAL_SYNC_GRACE_MS);
+  const peers = () => derivePresence(awareness.getStates(), doc.clientID, sanitizePayload);
+  const emitPeers = () => events.emit("peers", peers());
+  awareness.on("change", emitPeers);
+  const provider = options.provider({ doc, awareness, roomId });
+  const clearTimeoutTimer = () => {
+    if (timeout !== null) clearTimeout(timeout);
+    timeout = null;
   };
-}
-
-// collab/package-adapter.ts
-var DEFAULT_MAX_PACKAGE_BYTES = 32 * 1024 * 1024;
-function packageAdapter(options = {}) {
-  const name = options.name ?? "package";
-  const maxBytes = options.maxBytes ?? DEFAULT_MAX_PACKAGE_BYTES;
-  const map = (doc) => doc.getMap(name);
-  const check = (bytes) => {
-    if (!(bytes instanceof Uint8Array)) throw new Error("The shared package is not binary data.");
-    if (bytes.byteLength > maxBytes)
-      throw new Error(`The shared package exceeds ${Math.round(maxBytes / 1024 / 1024)} MiB.`);
-    return bytes;
+  provider.on("status", (status) => {
+    clearTimeoutTimer();
+    events.emit("status", status);
+    if (status === "connecting")
+      timeout = setTimeout(() => {
+        events.emit("error", new Error("Collaboration connection timed out"));
+        events.emit("status", "error");
+      }, options.connectionTimeoutMs ?? CONNECTION_TIMEOUT_MS);
+    if (status === "connected") gate.arm();
+  });
+  provider.on("synced", (synced) => {
+    events.emit("synced", synced);
+    if (synced) gate.open();
+  });
+  provider.on("error", (error) => events.emit("error", error));
+  const heartbeatMs = options.heartbeatMs ?? PRESENCE_HEARTBEAT_MS;
+  const heartbeat = heartbeatMs > 0 ? setInterval(() => {
+    publisher.flush();
+    emitPeers();
+  }, heartbeatMs) : null;
+  heartbeat?.unref?.();
+  const departure = createDepartureChannel(roomId, awareness);
+  const leave = () => {
+    departure.announce();
+    publisher.dispose();
+    awareness.setLocalState(null);
+    provider.disconnect();
   };
-  return {
-    isEmpty: (doc) => !(map(doc).get("bytes") instanceof Uint8Array),
-    read: (doc) => {
-      const shared = map(doc);
-      const revision = shared.get("revision");
-      return {
-        bytes: check(shared.get("bytes")).slice(),
-        revision: typeof revision === "number" && Number.isSafeInteger(revision) ? revision : 0
-      };
-    },
-    write: (doc, model, origin) => {
-      const bytes = check(model.bytes);
-      doc.transact(() => {
-        const shared = map(doc);
-        const current = shared.get("revision");
-        const revision = Math.max(model.revision, typeof current === "number" ? current : 0) + 1;
-        shared.set("bytes", bytes.slice());
-        shared.set("revision", revision);
-      }, origin);
-    },
-    observe: (doc, onChange) => {
-      const shared = map(doc);
-      const handler = (event) => {
-        if (event.keysChanged.has("bytes")) onChange(event.transaction.origin);
-      };
-      shared.observe(handler);
-      return () => shared.unobserve(handler);
-    }
-  };
-}
-
-// collab/ordering.ts
-function classifyVersion(messageVersion, currentVersion) {
-  if (!isNonNegativeSafeInteger(messageVersion) || !isNonNegativeSafeInteger(currentVersion))
-    return "invalid";
-  if (messageVersion < currentVersion) return "stale";
-  return messageVersion > currentVersion ? "out-of-order" : "apply";
-}
-var BoundedMap = class {
-  constructor(limit) {
-    this.limit = limit;
-    if (!Number.isSafeInteger(limit) || limit < 1) throw new Error("limit must be positive");
-  }
-  limit;
-  entries = /* @__PURE__ */ new Map();
-  get size() {
-    return this.entries.size;
-  }
-  get(key) {
-    return this.entries.get(key);
-  }
-  has(key) {
-    return this.entries.has(key);
-  }
-  set(key, value) {
-    this.entries.delete(key);
-    this.entries.set(key, value);
-    if (this.entries.size > this.limit) {
-      const oldest = this.entries.keys().next();
-      if (!oldest.done) this.entries.delete(oldest.value);
-    }
-  }
-  delete(key) {
-    return this.entries.delete(key);
-  }
-  clear() {
-    this.entries.clear();
-  }
-};
-var IdempotencyCache = class {
-  seen;
-  constructor(limit = 5e3) {
-    this.seen = new BoundedMap(limit);
-  }
-  check(clientId, messageId, fingerprint) {
-    const prior = this.seen.get(`${clientId}\0${messageId}`);
-    if (!prior) return { status: "fresh" };
-    return prior.fingerprint === fingerprint ? { status: "duplicate", value: prior.value } : { status: "reused" };
-  }
-  remember(clientId, messageId, fingerprint, value) {
-    this.seen.set(`${clientId}\0${messageId}`, { fingerprint, value });
-  }
-};
-var SequenceTracker = class {
-  last;
-  constructor(limit = 200) {
-    this.last = new BoundedMap(limit);
-  }
-  /** Classify without recording; call {@link commit} once the message was actually applied. */
-  classify(peerId, sequence, fingerprint) {
-    if (!isNonNegativeSafeInteger(sequence) || sequence < 1) return "invalid";
-    const previous = this.last.get(peerId);
-    if (!previous || sequence > previous.sequence) return "apply";
-    if (sequence < previous.sequence) return "stale";
-    return previous.fingerprint === fingerprint ? "duplicate" : "invalid";
-  }
-  commit(peerId, sequence, fingerprint) {
-    this.last.set(peerId, { sequence, fingerprint });
-  }
-  forget(peerId) {
-    this.last.delete(peerId);
-  }
-};
-function freezeDeep(value) {
-  if (value && typeof value === "object" && !Object.isFrozen(value)) {
-    for (const child of Object.values(value)) freezeDeep(child);
-    Object.freeze(value);
-  }
-  return value;
-}
-
-// collab/provider.ts
-var CONNECTION_TIMEOUT_MS = 3e4;
-function createCollabSession(options) {
-  const roomId = validateRoomId(options.roomId);
-  const ownsDoc = !options.doc;
-  const doc = options.doc ?? new Y__namespace.Doc();
-  const awareness = new awarenessProtocol.Awareness(doc);
-  const events = new Emitter();
-  const role = options.user.role;
-  const identity = {
-    userName: sanitizeUserName(options.user.name),
-    userColor: sanitizeColor(options.user.color, assignUserColor(doc.clientID)),
-    userAvatar: options.user.avatar,
-    role
-  };
-  const sanitizePayload = options.sanitizePayload ?? (() => ({}));
-  const publisher = createPresencePublisher(
-    awareness,
-    identity,
-    options.initialPresence ?? {}
-  );
-  let destroyed = false;
-  let timeout = null;
-  const gate = createSyncGate(() => {
-    if (destroyed) return;
-    options.onReady?.({ synced: provider.synced });
-    events.emit("ready", void 0);
-  }, options.syncGraceMs ?? INITIAL_SYNC_GRACE_MS);
-  const peers = () => derivePresence(awareness.getStates(), doc.clientID, sanitizePayload);
-  const emitPeers = () => events.emit("peers", peers());
-  awareness.on("change", emitPeers);
-  const provider = options.provider({ doc, awareness, roomId });
-  const clearTimeoutTimer = () => {
-    if (timeout !== null) clearTimeout(timeout);
-    timeout = null;
-  };
-  provider.on("status", (status) => {
-    clearTimeoutTimer();
-    events.emit("status", status);
-    if (status === "connecting")
-      timeout = setTimeout(() => {
-        events.emit("error", new Error("Collaboration connection timed out"));
-        events.emit("status", "error");
-      }, options.connectionTimeoutMs ?? CONNECTION_TIMEOUT_MS);
-    if (status === "connected") gate.arm();
-  });
-  provider.on("synced", (synced) => {
-    events.emit("synced", synced);
-    if (synced) gate.open();
-  });
-  provider.on("error", (error) => events.emit("error", error));
-  const heartbeatMs = options.heartbeatMs ?? PRESENCE_HEARTBEAT_MS;
-  const heartbeat = heartbeatMs > 0 ? setInterval(() => {
-    publisher.flush();
-    emitPeers();
-  }, heartbeatMs) : null;
-  heartbeat?.unref?.();
-  const departure = createDepartureChannel(roomId, awareness);
-  const leave = () => {
-    departure.announce();
-    publisher.dispose();
-    awareness.setLocalState(null);
-    provider.disconnect();
-  };
-  const unregisterTeardown = options.teardown ? registerTeardown({
-    leave,
-    rejoin: () => {
-      publisher.flush();
-      provider.connect();
+  const unregisterTeardown = options.teardown ? registerTeardown({
+    leave,
+    rejoin: () => {
+      publisher.flush();
+      provider.connect();
     },
     ...typeof options.teardown === "object" ? options.teardown : {}
   }) : () => {
@@ -1402,8 +1128,384 @@ function trimTrailingSlashes(value) {
   return value.slice(0, end);
 }
 
+// collab/embedding.ts
+var COLLABORATION_CHANGE_EVENT = "collaboration-change";
+var COLLABORATION_OFF_STATE = Object.freeze({
+  active: false,
+  roomId: void 0,
+  status: "off",
+  synced: false,
+  people: []
+});
+var INVALID_ROOM_MESSAGE = "Use 1 to 128 letters, digits, hyphens or underscores for the room name.";
+var NO_BROADCAST_MESSAGE = "This browser cannot share between windows; pass a server URL.";
+function openCollaborationSession(options, defaults) {
+  if (options.session) return { session: options.session, owned: false };
+  const roomId = options.roomId ?? "";
+  if (!isValidRoomId(roomId)) throw new Error(INVALID_ROOM_MESSAGE);
+  let provider = options.provider;
+  if (!provider && options.serverUrl)
+    provider = transportProvider({
+      transport: createWebSocketTransport({ url: roomUrl(options.serverUrl, roomId) })
+    });
+  if (!provider) {
+    if (!canBroadcast()) throw new Error(NO_BROADCAST_MESSAGE);
+    provider = transportProvider({
+      transport: createBroadcastTransport({ roomId, prefix: defaults.broadcastPrefix })
+    });
+  }
+  const user = options.user ?? {};
+  const session = createCollabSession({
+    roomId,
+    provider,
+    user: {
+      name: user.name || defaults.defaultName,
+      ...user.color ? { color: user.color } : {},
+      ...user.avatar ? { avatar: user.avatar } : {},
+      ...user.role ? { role: user.role } : {}
+    },
+    ...defaults.initialPresence ? { initialPresence: defaults.initialPresence } : {},
+    ...defaults.sanitizePayload ? { sanitizePayload: defaults.sanitizePayload } : {},
+    teardown: true
+  });
+  return { session, owned: true };
+}
+function collaborationStateOf(session) {
+  return {
+    active: true,
+    roomId: session.roomId,
+    status: session.status,
+    synced: session.synced,
+    people: [
+      {
+        clientId: session.clientId,
+        name: session.identity.userName,
+        color: session.identity.userColor,
+        self: true
+      },
+      ...session.peers().map((peer) => ({
+        clientId: peer.clientId,
+        name: peer.userName,
+        color: peer.userColor,
+        self: false
+      }))
+    ]
+  };
+}
+function onCollaborationStateChange(session, listener) {
+  const stops = [
+    session.on("status", listener),
+    session.on("synced", listener),
+    session.on("peers", listener)
+  ];
+  return () => {
+    for (const stop of stops) stop();
+  };
+}
+function toExternalSession(session) {
+  let snapshot = { status: session.status, synced: false };
+  return {
+    doc: session.doc,
+    awareness: session.awareness,
+    getSnapshot: () => {
+      const status = session.status;
+      const synced = session.synced || session.gate.isOpen();
+      if (snapshot.status !== status || snapshot.synced !== synced) snapshot = { status, synced };
+      return snapshot;
+    },
+    subscribe: (listener) => {
+      const stops = [
+        session.on("status", listener),
+        session.on("synced", listener),
+        session.on("ready", listener)
+      ];
+      return () => {
+        for (const stop of stops) stop();
+      };
+    }
+  };
+}
+
+// collab/external-provider.ts
+function adaptYjsProvider(provider) {
+  const events = new Emitter();
+  let destroyed = false;
+  let status = provider.wsconnected || provider.connected ? "connected" : provider.wsconnecting ? "connecting" : "disconnected";
+  let synced = Boolean(provider.synced);
+  const subscriptions = [];
+  const listen = (name, handler) => {
+    const wrapped = handler;
+    provider.on(name, wrapped);
+    subscriptions.push([name, wrapped]);
+  };
+  const setStatus = (next) => {
+    if (destroyed || next === status) return;
+    status = next;
+    events.emit("status", next);
+  };
+  const setSynced = (next) => {
+    if (destroyed || next === synced) return;
+    synced = next;
+    events.emit("synced", next);
+  };
+  listen("status", (payload) => {
+    if (typeof payload.connected === "boolean") {
+      if (!payload.connected) setSynced(false);
+      return setStatus(payload.connected ? "connected" : "disconnected");
+    }
+    if (payload.status === "connected" || payload.status === "connecting")
+      setStatus(payload.status);
+    else if (payload.status === "disconnected") {
+      setSynced(false);
+      setStatus("disconnected");
+    }
+  });
+  const onSync = (value) => setSynced(typeof value === "boolean" ? value : value.synced === true);
+  listen("sync", onSync);
+  listen("synced", onSync);
+  listen("connection-error", (cause) => {
+    if (destroyed) return;
+    setStatus("error");
+    events.emit("error", cause instanceof Error ? cause : new Error("Provider connection error"));
+  });
+  return {
+    get status() {
+      return status;
+    },
+    get synced() {
+      return synced;
+    },
+    connect: () => {
+      if (destroyed || status === "connected" || status === "connecting") return;
+      setStatus("connecting");
+      provider.connect?.();
+    },
+    disconnect: () => {
+      if (destroyed) return;
+      provider.disconnect?.();
+      setSynced(false);
+      setStatus("disconnected");
+    },
+    destroy: () => {
+      if (destroyed) return;
+      setSynced(false);
+      setStatus("disconnected");
+      destroyed = true;
+      for (const [name, handler] of subscriptions) provider.off?.(name, handler);
+      subscriptions.length = 0;
+      events.clear();
+      provider.destroy?.();
+    },
+    on: (event, listener) => events.on(event, listener)
+  };
+}
+function observeExternalSession(session, onSnapshot) {
+  let active = true;
+  let subscribing = true;
+  let previous;
+  let unsubscribe;
+  const notify = () => {
+    if (!active || subscribing) return;
+    const snapshot = session.getSnapshot();
+    if (previous?.status === snapshot.status && previous.synced === snapshot.synced) return;
+    previous = { status: snapshot.status, synced: snapshot.synced };
+    onSnapshot(previous);
+  };
+  const dispose = () => {
+    if (!active) return;
+    active = false;
+    unsubscribe?.();
+  };
+  try {
+    unsubscribe = session.subscribe(notify);
+    subscribing = false;
+    notify();
+  } catch (error) {
+    dispose();
+    throw error;
+  }
+  return dispose;
+}
+
+// collab/memory-transport.ts
+function createMemoryHub(options = {}) {
+  const rooms = /* @__PURE__ */ new Map();
+  let nextId = 0;
+  const deliver = (task) => {
+    if (options.async) queueMicrotask(task);
+    else task();
+  };
+  return {
+    size: (roomId) => rooms.get(roomId)?.size ?? 0,
+    createTransport(roomId) {
+      const id = nextId++;
+      let endpoint = null;
+      const peers = () => {
+        let room = rooms.get(roomId);
+        if (!room) rooms.set(roomId, room = /* @__PURE__ */ new Set());
+        return room;
+      };
+      return {
+        get connected() {
+          return endpoint !== null;
+        },
+        connect(handlers) {
+          if (endpoint) peers().delete(endpoint);
+          const self = { id, handlers };
+          const others = [...peers()];
+          peers().add(self);
+          endpoint = self;
+          deliver(() => {
+            if (endpoint !== self) return;
+            handlers.open();
+            for (const other of others) other.handlers.peer?.();
+          });
+        },
+        send(data) {
+          const self = endpoint;
+          if (!self || options.filter && !options.filter(data, id)) return;
+          for (const other of [...peers()])
+            if (other !== self) deliver(() => other.handlers.message(data.slice()));
+        },
+        disconnect() {
+          const self = endpoint;
+          if (!self) return;
+          endpoint = null;
+          peers().delete(self);
+          self.handlers.close("disconnected");
+        }
+      };
+    }
+  };
+}
+
+// collab/package-adapter.ts
+var DEFAULT_MAX_PACKAGE_BYTES = 32 * 1024 * 1024;
+function packageAdapter(options = {}) {
+  const name = options.name ?? "package";
+  const maxBytes = options.maxBytes ?? DEFAULT_MAX_PACKAGE_BYTES;
+  const map = (doc) => doc.getMap(name);
+  const check = (bytes) => {
+    if (!(bytes instanceof Uint8Array)) throw new Error("The shared package is not binary data.");
+    if (bytes.byteLength > maxBytes)
+      throw new Error(`The shared package exceeds ${Math.round(maxBytes / 1024 / 1024)} MiB.`);
+    return bytes;
+  };
+  return {
+    isEmpty: (doc) => !(map(doc).get("bytes") instanceof Uint8Array),
+    read: (doc) => {
+      const shared = map(doc);
+      const revision = shared.get("revision");
+      return {
+        bytes: check(shared.get("bytes")).slice(),
+        revision: typeof revision === "number" && Number.isSafeInteger(revision) ? revision : 0
+      };
+    },
+    write: (doc, model, origin) => {
+      const bytes = check(model.bytes);
+      doc.transact(() => {
+        const shared = map(doc);
+        const current = shared.get("revision");
+        const revision = Math.max(model.revision, typeof current === "number" ? current : 0) + 1;
+        shared.set("bytes", bytes.slice());
+        shared.set("revision", revision);
+      }, origin);
+    },
+    observe: (doc, onChange) => {
+      const shared = map(doc);
+      const handler = (event) => {
+        if (event.keysChanged.has("bytes")) onChange(event.transaction.origin);
+      };
+      shared.observe(handler);
+      return () => shared.unobserve(handler);
+    }
+  };
+}
+
+// collab/ordering.ts
+function classifyVersion(messageVersion, currentVersion) {
+  if (!isNonNegativeSafeInteger(messageVersion) || !isNonNegativeSafeInteger(currentVersion))
+    return "invalid";
+  if (messageVersion < currentVersion) return "stale";
+  return messageVersion > currentVersion ? "out-of-order" : "apply";
+}
+var BoundedMap = class {
+  constructor(limit) {
+    this.limit = limit;
+    if (!Number.isSafeInteger(limit) || limit < 1) throw new Error("limit must be positive");
+  }
+  limit;
+  entries = /* @__PURE__ */ new Map();
+  get size() {
+    return this.entries.size;
+  }
+  get(key) {
+    return this.entries.get(key);
+  }
+  has(key) {
+    return this.entries.has(key);
+  }
+  set(key, value) {
+    this.entries.delete(key);
+    this.entries.set(key, value);
+    if (this.entries.size > this.limit) {
+      const oldest = this.entries.keys().next();
+      if (!oldest.done) this.entries.delete(oldest.value);
+    }
+  }
+  delete(key) {
+    return this.entries.delete(key);
+  }
+  clear() {
+    this.entries.clear();
+  }
+};
+var IdempotencyCache = class {
+  seen;
+  constructor(limit = 5e3) {
+    this.seen = new BoundedMap(limit);
+  }
+  check(clientId, messageId, fingerprint) {
+    const prior = this.seen.get(`${clientId}\0${messageId}`);
+    if (!prior) return { status: "fresh" };
+    return prior.fingerprint === fingerprint ? { status: "duplicate", value: prior.value } : { status: "reused" };
+  }
+  remember(clientId, messageId, fingerprint, value) {
+    this.seen.set(`${clientId}\0${messageId}`, { fingerprint, value });
+  }
+};
+var SequenceTracker = class {
+  last;
+  constructor(limit = 200) {
+    this.last = new BoundedMap(limit);
+  }
+  /** Classify without recording; call {@link commit} once the message was actually applied. */
+  classify(peerId, sequence, fingerprint) {
+    if (!isNonNegativeSafeInteger(sequence) || sequence < 1) return "invalid";
+    const previous = this.last.get(peerId);
+    if (!previous || sequence > previous.sequence) return "apply";
+    if (sequence < previous.sequence) return "stale";
+    return previous.fingerprint === fingerprint ? "duplicate" : "invalid";
+  }
+  commit(peerId, sequence, fingerprint) {
+    this.last.set(peerId, { sequence, fingerprint });
+  }
+  forget(peerId) {
+    this.last.delete(peerId);
+  }
+};
+function freezeDeep(value) {
+  if (value && typeof value === "object" && !Object.isFrozen(value)) {
+    for (const child of Object.values(value)) freezeDeep(child);
+    Object.freeze(value);
+  }
+  return value;
+}
+
 exports.BROADCAST_THROTTLE_MS = BROADCAST_THROTTLE_MS;
 exports.BoundedMap = BoundedMap;
+exports.COLLABORATION_CHANGE_EVENT = COLLABORATION_CHANGE_EVENT;
+exports.COLLABORATION_OFF_STATE = COLLABORATION_OFF_STATE;
 exports.COLLABORATION_ROLES = COLLABORATION_ROLES;
 exports.COLLAB_LEAVE_MESSAGE = COLLAB_LEAVE_MESSAGE;
 exports.CONNECTION_TIMEOUT_MS = CONNECTION_TIMEOUT_MS;
@@ -1413,6 +1515,7 @@ exports.DEFAULT_MAX_PACKAGE_BYTES = DEFAULT_MAX_PACKAGE_BYTES;
 exports.DEPARTURE_CHANNEL = DEPARTURE_CHANNEL;
 exports.Emitter = Emitter;
 exports.INITIAL_SYNC_GRACE_MS = INITIAL_SYNC_GRACE_MS;
+exports.INVALID_ROOM_MESSAGE = INVALID_ROOM_MESSAGE;
 exports.IdempotencyCache = IdempotencyCache;
 exports.LEGACY_PPTX_DEPARTURE_CHANNEL = LEGACY_PPTX_DEPARTURE_CHANNEL;
 exports.LEGACY_PPTX_LEAVE_MESSAGE = LEGACY_PPTX_LEAVE_MESSAGE;
@@ -1422,6 +1525,7 @@ exports.MAX_UPDATE_BYTES = MAX_UPDATE_BYTES;
 exports.MESSAGE_AWARENESS = MESSAGE_AWARENESS;
 exports.MESSAGE_QUERY_AWARENESS = MESSAGE_QUERY_AWARENESS;
 exports.MESSAGE_SYNC = MESSAGE_SYNC;
+exports.NO_BROADCAST_MESSAGE = NO_BROADCAST_MESSAGE;
 exports.PRESENCE_FIELD = PRESENCE_FIELD;
 exports.PRESENCE_HEARTBEAT_MS = PRESENCE_HEARTBEAT_MS;
 exports.STALE_PRESENCE_MS = STALE_PRESENCE_MS;
@@ -1438,6 +1542,7 @@ exports.canWrite = canWrite;
 exports.clampCoordinate = clampCoordinate;
 exports.classifyVersion = classifyVersion;
 exports.clearLocalAwareness = clearLocalAwareness;
+exports.collaborationStateOf = collaborationStateOf;
 exports.createAssetSync = createAssetSync;
 exports.createBroadcastTransport = createBroadcastTransport;
 exports.createClientId = createClientId;
@@ -1465,6 +1570,8 @@ exports.isValidId = isValidId;
 exports.isValidRoomId = isValidRoomId;
 exports.mergeUpdates = mergeUpdates2;
 exports.observeExternalSession = observeExternalSession;
+exports.onCollaborationStateChange = onCollaborationStateChange;
+exports.openCollaborationSession = openCollaborationSession;
 exports.packageAdapter = packageAdapter;
 exports.presenceToCursors = presenceToCursors;
 exports.randomToken = randomToken;
@@ -1483,6 +1590,7 @@ exports.shouldAutoFollowBroadcaster = shouldAutoFollowBroadcaster;
 exports.shouldRoomReplaceLoad = shouldRoomReplaceLoad;
 exports.stripHtmlTags = stripHtmlTags;
 exports.toBase64 = toBase64;
+exports.toExternalSession = toExternalSession;
 exports.transportProvider = transportProvider;
 exports.validateDisplayName = validateDisplayName;
 exports.validateRoomId = validateRoomId;