@mdfn/collab 0.1.0

package/README.md

@@ -0,0 +1,18 @@
+# `@mdfn/collab`
+
+Yjs-backed collaboration for canonical Markdown, validated editorial/asset
+sidecar data, awareness, offline update queues, reconnect flushing, compaction,
+and contract negotiation. Transport remains host-controlled: exchange
+`encodeUpdate()` bytes over an authorized provider and call `applyUpdate()` for
+remote data.
+
+Each remote update is size checked and authorized, then applied to an isolated
+candidate document. The candidate must retain the expected document ID, schema
+hash, profile, protocol version, extension set, Markdown, and sidecar validity
+before the live document is changed. Rejections and queue lifecycle events are
+available through the audit callback.
+
+Queue compaction merges only unsent dependency-complete updates. It never
+re-encodes the full long-lived `Y.Doc`, whose retained CRDT history can exceed
+the transport limit. If a merged row would exceed `maxUpdateBytes`, the session
+keeps the original incremental rows and flushes them independently.

package/dist/index.cjs

@@ -0,0 +1,322 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Awareness: () => import_awareness.Awareness,
+  MDFN_COLLAB_VERSION: () => MDFN_COLLAB_VERSION,
+  Y: () => Y,
+  createCollaborationSession: () => createCollaborationSession
+});
+module.exports = __toCommonJS(index_exports);
+var Y = __toESM(require("yjs"), 1);
+var import_awareness = require("y-protocols/awareness");
+var import_core = require("@mdfn/core");
+function parseSidecar(value, markdownLength) {
+  if (value === void 0) return void 0;
+  try {
+    return (0, import_core.validateMdfnSidecar)(JSON.parse(value), { markdownLength });
+  } catch (error) {
+    throw new Error(`MDFN_COLLAB_SIDECAR_INVALID:${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+function changedRange(previous, current) {
+  let from = 0;
+  while (from < previous.length && from < current.length && previous[from] === current[from]) from += 1;
+  let oldEnd = previous.length;
+  let newEnd = current.length;
+  while (oldEnd > from && newEnd > from && previous[oldEnd - 1] === current[newEnd - 1]) {
+    oldEnd -= 1;
+    newEnd -= 1;
+  }
+  return { from, to: oldEnd, inserted: current.slice(from, newEnd) };
+}
+function createCollaborationSession(options) {
+  const doc = options.doc ?? new Y.Doc({ guid: options.documentId });
+  const ownsAwareness = !options.awareness;
+  const awareness = options.awareness ?? new import_awareness.Awareness(doc);
+  const source = doc.getText("markdown");
+  const sidecar = doc.getMap("sidecar");
+  const metadata = doc.getMap("metadata");
+  const sharedDocumentInitialized = options.doc !== void 0 && (source.length > 0 || sidecar.size > 0 || metadata.size > 0);
+  const localOrigin = Object.freeze({ session: options.user.id });
+  let applyingRemote = false;
+  let destroyed = false;
+  let online = options.online ?? true;
+  let nextPendingId = 0;
+  let pendingUpdates = [];
+  let inFlight = null;
+  let flushing = null;
+  let remoteApplication = Promise.resolve();
+  let documentGeneration = 0;
+  const maxDocumentBytes = options.maxDocumentBytes ?? 2 * 1024 * 1024;
+  const maxUpdateBytes = options.maxUpdateBytes ?? maxDocumentBytes + Math.max(64 * 1024, Math.ceil(maxDocumentBytes / 16));
+  const emitAudit = (event) => {
+    options.onAudit?.({ ...event, documentId: options.documentId, userId: options.user.id });
+  };
+  const expectedSchema = options.controller.getState().schemaHash;
+  const expectedDocumentId = options.documentId;
+  const expectedProfile = options.profileId ?? "default";
+  const expectedProtocol = String(options.protocolVersion ?? 1);
+  const expectedExtensions = JSON.stringify(options.controller.extensions.extensions.map((extension) => ({ name: extension.name, version: extension.version })));
+  const bindMetadata = (key, expected, code) => {
+    const current = metadata.get(key);
+    if (current !== void 0 && current !== expected) throw new Error(`${code}:${current}:${expected}`);
+    if (current === void 0) metadata.set(key, expected);
+  };
+  bindMetadata("schemaHash", expectedSchema, "MDFN_COLLAB_SCHEMA_MISMATCH");
+  bindMetadata("documentId", expectedDocumentId, "MDFN_COLLAB_DOCUMENT_MISMATCH");
+  bindMetadata("profileId", expectedProfile, "MDFN_COLLAB_PROFILE_MISMATCH");
+  bindMetadata("protocolVersion", expectedProtocol, "MDFN_COLLAB_PROTOCOL_MISMATCH");
+  bindMetadata("extensions", expectedExtensions, "MDFN_COLLAB_EXTENSIONS_MISMATCH");
+  const assertContract = (candidate) => {
+    const candidateMetadata = candidate.getMap("metadata");
+    const schema = candidateMetadata.get("schemaHash");
+    if (schema !== expectedSchema) throw new Error(`MDFN_COLLAB_SCHEMA_MISMATCH:${schema ?? "missing"}:${expectedSchema}`);
+    if (candidateMetadata.get("documentId") !== expectedDocumentId) throw new Error("MDFN_COLLAB_DOCUMENT_MISMATCH");
+    if (candidateMetadata.get("profileId") !== expectedProfile) throw new Error("MDFN_COLLAB_PROFILE_MISMATCH");
+    if (candidateMetadata.get("protocolVersion") !== expectedProtocol) throw new Error("MDFN_COLLAB_PROTOCOL_MISMATCH");
+    if (candidateMetadata.get("extensions") !== expectedExtensions) throw new Error("MDFN_COLLAB_EXTENSIONS_MISMATCH");
+    const markdown = candidate.getText("markdown").toString();
+    try {
+      options.controller.validateMarkdown(markdown);
+    } catch (error) {
+      throw new Error(`MDFN_COLLAB_MARKDOWN_INVALID:${error instanceof Error ? error.message : String(error)}`);
+    }
+    parseSidecar(candidate.getMap("sidecar").get("value"), markdown.length);
+  };
+  const canonicalJson = (value) => {
+    if (Array.isArray(value)) return value.map(canonicalJson);
+    if (value === null || typeof value !== "object") return value;
+    return Object.fromEntries(
+      Object.entries(value).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, entry]) => [key, canonicalJson(entry)])
+    );
+  };
+  const protectedSidecar = (value) => JSON.stringify(canonicalJson({
+    comments: value?.comments ?? [],
+    suggestions: value?.suggestions ?? [],
+    reviewState: value?.reviewState ?? "draft",
+    audit: value?.audit ?? []
+  }));
+  const validateUpdate = async (update, origin) => {
+    const baseline = documentGeneration;
+    const candidate = new Y.Doc({ guid: expectedDocumentId });
+    try {
+      Y.applyUpdate(candidate, Y.encodeStateAsUpdate(doc), "validation:baseline");
+      Y.applyUpdate(candidate, update, "validation:candidate");
+      assertContract(candidate);
+      const previousSidecar = parseSidecar(sidecar.get("value"), source.length);
+      const candidateSidecar = parseSidecar(candidate.getMap("sidecar").get("value"), candidate.getText("markdown").length);
+      if (protectedSidecar(previousSidecar) !== protectedSidecar(candidateSidecar)) {
+        if (!options.authorizeSidecarUpdate || !await options.authorizeSidecarUpdate(previousSidecar, candidateSidecar, origin)) {
+          throw new Error("MDFN_COLLAB_EDITORIAL_UPDATE_FORBIDDEN");
+        }
+      }
+      return baseline;
+    } finally {
+      candidate.destroy();
+    }
+  };
+  if (!sharedDocumentInitialized) {
+    if (source.length === 0) source.insert(0, options.controller.getState().markdown);
+    if (!sidecar.has("value") && options.controller.getState().sidecar) sidecar.set("value", JSON.stringify(options.controller.getState().sidecar));
+  } else {
+    assertContract(doc);
+    const state = options.controller.getState();
+    const sharedMarkdown = source.toString();
+    const sharedSidecar = parseSidecar(sidecar.get("value"), sharedMarkdown.length);
+    let initial = new import_core.Transaction().withSource("collab:initial").withMetadata({ addToHistory: false });
+    if (sharedMarkdown !== state.markdown) initial = initial.replaceSource(0, state.markdown.length, sharedMarkdown);
+    if (JSON.stringify(sharedSidecar) !== JSON.stringify(state.sidecar)) initial = initial.setSidecar(sharedSidecar);
+    if (initial.operations.length > 0) options.controller.dispatch(initial);
+  }
+  awareness.setLocalState({ user: options.user, documentId: options.documentId });
+  const trackDocumentGeneration = () => {
+    documentGeneration += 1;
+  };
+  doc.on("afterTransaction", trackDocumentGeneration);
+  const unsubscribe = options.controller.subscribe((change) => {
+    if (applyingRemote || destroyed) return;
+    doc.transact(() => {
+      if (change.documentChanged) {
+        const current = source.toString();
+        const range = changedRange(current, change.current.markdown);
+        if (range.to > range.from) source.delete(range.from, range.to - range.from);
+        if (range.inserted) source.insert(range.from, range.inserted);
+      }
+      if (change.sidecarChanged) {
+        if (change.current.sidecar) sidecar.set("value", JSON.stringify(change.current.sidecar));
+        else sidecar.delete("value");
+      }
+    }, localOrigin);
+  });
+  const applySharedState = (transaction) => {
+    if (destroyed || transaction.origin === localOrigin) return;
+    applyingRemote = true;
+    try {
+      const state = options.controller.getState();
+      const nextSource = source.toString();
+      let edit = new import_core.Transaction().withSource("collab:remote").withMetadata({ addToHistory: false });
+      if (nextSource !== state.markdown) edit = edit.replaceSource(0, state.markdown.length, nextSource);
+      assertContract(doc);
+      const nextSidecar = parseSidecar(sidecar.get("value"), nextSource.length);
+      if (JSON.stringify(nextSidecar) !== JSON.stringify(state.sidecar)) edit = edit.setSidecar(nextSidecar);
+      if (edit.operations.length > 0) options.controller.dispatch(edit);
+    } finally {
+      applyingRemote = false;
+    }
+  };
+  doc.on("afterTransaction", applySharedState);
+  const compactPending = () => {
+    const compactable = pendingUpdates.filter((entry) => entry !== inFlight);
+    const update = Y.mergeUpdates(compactable.map((entry) => entry.update));
+    if (update.byteLength > maxUpdateBytes) {
+      throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);
+    }
+    if (compactable.length === 0) return update;
+    const replacement = { id: ++nextPendingId, update };
+    pendingUpdates = inFlight ? [inFlight, replacement] : [replacement];
+    emitAudit({ type: "compact", byteLength: update.byteLength, pending: pendingUpdates.length });
+    return update;
+  };
+  const flush = async () => {
+    if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+    if (!online || !options.sendUpdate || pendingUpdates.length === 0) return;
+    if (flushing) return flushing;
+    flushing = (async () => {
+      while (online && pendingUpdates.length > 0) {
+        const entry = pendingUpdates[0];
+        inFlight = entry;
+        try {
+          await options.sendUpdate(entry.update);
+          pendingUpdates = pendingUpdates.filter((candidate) => candidate !== entry);
+          emitAudit({ type: "flush", byteLength: entry.update.byteLength, pending: pendingUpdates.length });
+        } finally {
+          if (inFlight === entry) inFlight = null;
+        }
+      }
+    })().finally(() => {
+      flushing = null;
+    });
+    return flushing;
+  };
+  const queueLocalUpdate = (update, origin) => {
+    if (destroyed || origin !== localOrigin) return;
+    pendingUpdates.push({ id: ++nextPendingId, update: update.slice() });
+    emitAudit({ type: "local-update", byteLength: update.byteLength, pending: pendingUpdates.length });
+    const threshold = options.compactionThresholdBytes ?? 2 * 1024 * 1024;
+    if (pendingUpdates.reduce((total, entry) => total + entry.update.byteLength, 0) > threshold) {
+      try {
+        compactPending();
+      } catch (error) {
+        if (!(error instanceof RangeError) || !error.message.startsWith("MDFN_COLLAB_UPDATE_TOO_LARGE:")) throw error;
+      }
+    }
+    if (online) void flush().catch((error) => {
+      online = false;
+      emitAudit({ type: "offline", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });
+    });
+  };
+  doc.on("update", queueLocalUpdate);
+  if (options.sendUpdate) {
+    const initial = Y.encodeStateAsUpdate(doc);
+    pendingUpdates.push({ id: ++nextPendingId, update: initial });
+    emitAudit({ type: "local-update", byteLength: initial.byteLength, pending: pendingUpdates.length });
+    if (online) void flush().catch((error) => {
+      online = false;
+      emitAudit({ type: "offline", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });
+    });
+  }
+  return {
+    doc,
+    awareness,
+    encodeUpdate: (stateVector) => stateVector ? Y.encodeStateAsUpdate(doc, stateVector) : Y.encodeStateAsUpdate(doc),
+    encodeStateVector: () => Y.encodeStateVector(doc),
+    async applyUpdate(update, origin = "transport") {
+      if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+      const apply = async () => {
+        try {
+          if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+          if (update.byteLength > maxUpdateBytes) throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);
+          if (options.authorizeUpdate && !await options.authorizeUpdate(update, origin)) throw new Error("MDFN_COLLAB_UPDATE_FORBIDDEN");
+          for (; ; ) {
+            const baseline = await validateUpdate(update, origin);
+            if (baseline !== documentGeneration) continue;
+            if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+            Y.applyUpdate(doc, update, origin);
+            emitAudit({ type: "remote-update", byteLength: update.byteLength });
+            return;
+          }
+        } catch (error) {
+          emitAudit({ type: "remote-rejected", byteLength: update.byteLength, error: error instanceof Error ? error.message : String(error) });
+          throw error;
+        }
+      };
+      const queued = remoteApplication.then(apply, apply);
+      remoteApplication = queued.catch(() => void 0);
+      return queued;
+    },
+    setPresence(value) {
+      if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+      awareness.setLocalStateField("presence", value);
+    },
+    getPresence: () => awareness.getStates(),
+    isOnline: () => online,
+    pendingUpdateCount: () => pendingUpdates.length,
+    async setOnline(value) {
+      if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+      online = value;
+      emitAudit({ type: value ? "online" : "offline", pending: pendingUpdates.length });
+      if (value) await flush();
+    },
+    flush,
+    compact: compactPending,
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      unsubscribe();
+      doc.off("afterTransaction", applySharedState);
+      doc.off("afterTransaction", trackDocumentGeneration);
+      doc.off("update", queueLocalUpdate);
+      pendingUpdates = [];
+      awareness.setLocalState(null);
+      if (ownsAwareness) awareness.destroy();
+    }
+  };
+}
+var MDFN_COLLAB_VERSION = "0.1.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Awareness,
+  MDFN_COLLAB_VERSION,
+  Y,
+  createCollaborationSession
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import * as Y from \"yjs\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport { Transaction, validateMdfnSidecar, type EditorController, type MdfnJsonValue, type MdfnSidecar } from \"@mdfn/core\";\n\nexport interface CollaborationUser {\n  readonly id: string;\n  readonly name?: string;\n  readonly color?: string;\n  readonly metadata?: Readonly<Record<string, MdfnJsonValue>>;\n}\n\nexport interface CollaborationSessionOptions {\n  readonly controller: EditorController;\n  readonly documentId: string;\n  readonly user: CollaborationUser;\n  readonly doc?: Y.Doc;\n  readonly awareness?: Awareness;\n  readonly authorizeUpdate?: (update: Uint8Array, origin: unknown) => boolean | Promise<boolean>;\n  /** Protected editorial sidecar changes require an authoritative host decision. */\n  readonly authorizeSidecarUpdate?: (previous: MdfnSidecar | undefined, next: MdfnSidecar | undefined, origin: unknown) => boolean | Promise<boolean>;\n  readonly profileId?: string;\n  readonly protocolVersion?: number;\n  /** Maximum valid UTF-8 Markdown size; used to derive safe Yjs update limits. */\n  readonly maxDocumentBytes?: number;\n  readonly maxUpdateBytes?: number;\n  readonly online?: boolean;\n  readonly sendUpdate?: (update: Uint8Array) => void | Promise<void>;\n  readonly compactionThresholdBytes?: number;\n  readonly onAudit?: (event: CollaborationAuditEvent) => void;\n}\n\nexport interface CollaborationAuditEvent {\n  readonly type: \"local-update\" | \"remote-update\" | \"remote-rejected\" | \"offline\" | \"online\" | \"flush\" | \"compact\";\n  readonly documentId: string;\n  readonly userId: string;\n  readonly byteLength?: number;\n  readonly pending?: number;\n  readonly error?: string;\n}\n\nfunction parseSidecar(value: string | undefined, markdownLength?: number): MdfnSidecar | undefined {\n  if (value === undefined) return undefined;\n  try {\n    return validateMdfnSidecar(JSON.parse(value), { markdownLength });\n  } catch (error) {\n    throw new Error(`MDFN_COLLAB_SIDECAR_INVALID:${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\nexport interface CollaborationSession {\n  readonly doc: Y.Doc;\n  readonly awareness: Awareness;\n  encodeUpdate(stateVector?: Uint8Array): Uint8Array;\n  encodeStateVector(): Uint8Array;\n  applyUpdate(update: Uint8Array, origin?: unknown): Promise<void>;\n  setPresence(value: Readonly<Record<string, MdfnJsonValue>>): void;\n  getPresence(): ReadonlyMap<number, unknown>;\n  isOnline(): boolean;\n  pendingUpdateCount(): number;\n  setOnline(online: boolean): Promise<void>;\n  flush(): Promise<void>;\n  compact(): Uint8Array;\n  destroy(): void;\n}\n\nfunction changedRange(previous: string, current: string): { from: number; to: number; inserted: string } {\n  let from = 0;\n  while (from < previous.length && from < current.length && previous[from] === current[from]) from += 1;\n  let oldEnd = previous.length;\n  let newEnd = current.length;\n  while (oldEnd > from && newEnd > from && previous[oldEnd - 1] === current[newEnd - 1]) { oldEnd -= 1; newEnd -= 1; }\n  return { from, to: oldEnd, inserted: current.slice(from, newEnd) };\n}\n\nexport function createCollaborationSession(options: CollaborationSessionOptions): CollaborationSession {\n  const doc = options.doc ?? new Y.Doc({ guid: options.documentId });\n  const ownsAwareness = !options.awareness;\n  const awareness = options.awareness ?? new Awareness(doc);\n  const source = doc.getText(\"markdown\");\n  const sidecar = doc.getMap<string>(\"sidecar\");\n  const metadata = doc.getMap<string>(\"metadata\");\n  const sharedDocumentInitialized = options.doc !== undefined && (source.length > 0 || sidecar.size > 0 || metadata.size > 0);\n  const localOrigin = Object.freeze({ session: options.user.id });\n  let applyingRemote = false;\n  let destroyed = false;\n  let online = options.online ?? true;\n  interface PendingUpdate { readonly id: number; readonly update: Uint8Array; }\n  let nextPendingId = 0;\n  let pendingUpdates: PendingUpdate[] = [];\n  let inFlight: PendingUpdate | null = null;\n  let flushing: Promise<void> | null = null;\n  let remoteApplication: Promise<void> = Promise.resolve();\n  let documentGeneration = 0;\n  const maxDocumentBytes = options.maxDocumentBytes ?? 2 * 1024 * 1024;\n  const maxUpdateBytes = options.maxUpdateBytes ?? maxDocumentBytes + Math.max(64 * 1024, Math.ceil(maxDocumentBytes / 16));\n\n  const emitAudit = (event: Omit<CollaborationAuditEvent, \"documentId\" | \"userId\">): void => {\n    options.onAudit?.({ ...event, documentId: options.documentId, userId: options.user.id });\n  };\n\n  const expectedSchema = options.controller.getState().schemaHash;\n  const expectedDocumentId = options.documentId;\n  const expectedProfile = options.profileId ?? \"default\";\n  const expectedProtocol = String(options.protocolVersion ?? 1);\n  const expectedExtensions = JSON.stringify(options.controller.extensions.extensions.map((extension) => ({ name: extension.name, version: extension.version })));\n  const bindMetadata = (key: string, expected: string, code: string): void => {\n    const current = metadata.get(key);\n    if (current !== undefined && current !== expected) throw new Error(`${code}:${current}:${expected}`);\n    if (current === undefined) metadata.set(key, expected);\n  };\n  bindMetadata(\"schemaHash\", expectedSchema, \"MDFN_COLLAB_SCHEMA_MISMATCH\");\n  bindMetadata(\"documentId\", expectedDocumentId, \"MDFN_COLLAB_DOCUMENT_MISMATCH\");\n  bindMetadata(\"profileId\", expectedProfile, \"MDFN_COLLAB_PROFILE_MISMATCH\");\n  bindMetadata(\"protocolVersion\", expectedProtocol, \"MDFN_COLLAB_PROTOCOL_MISMATCH\");\n  bindMetadata(\"extensions\", expectedExtensions, \"MDFN_COLLAB_EXTENSIONS_MISMATCH\");\n\n  const assertContract = (candidate: Y.Doc): void => {\n    const candidateMetadata = candidate.getMap<string>(\"metadata\");\n    const schema = candidateMetadata.get(\"schemaHash\");\n    if (schema !== expectedSchema) throw new Error(`MDFN_COLLAB_SCHEMA_MISMATCH:${schema ?? \"missing\"}:${expectedSchema}`);\n    if (candidateMetadata.get(\"documentId\") !== expectedDocumentId) throw new Error(\"MDFN_COLLAB_DOCUMENT_MISMATCH\");\n    if (candidateMetadata.get(\"profileId\") !== expectedProfile) throw new Error(\"MDFN_COLLAB_PROFILE_MISMATCH\");\n    if (candidateMetadata.get(\"protocolVersion\") !== expectedProtocol) throw new Error(\"MDFN_COLLAB_PROTOCOL_MISMATCH\");\n    if (candidateMetadata.get(\"extensions\") !== expectedExtensions) throw new Error(\"MDFN_COLLAB_EXTENSIONS_MISMATCH\");\n    const markdown = candidate.getText(\"markdown\").toString();\n    try {\n      options.controller.validateMarkdown(markdown);\n    } catch (error) {\n      throw new Error(`MDFN_COLLAB_MARKDOWN_INVALID:${error instanceof Error ? error.message : String(error)}`);\n    }\n    parseSidecar(candidate.getMap<string>(\"sidecar\").get(\"value\"), markdown.length);\n  };\n\n  const canonicalJson = (value: unknown): unknown => {\n    if (Array.isArray(value)) return value.map(canonicalJson);\n    if (value === null || typeof value !== \"object\") return value;\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)\n        .map(([key, entry]) => [key, canonicalJson(entry)]),\n    );\n  };\n  const protectedSidecar = (value: MdfnSidecar | undefined): string => JSON.stringify(canonicalJson({\n    comments: value?.comments ?? [],\n    suggestions: value?.suggestions ?? [],\n    reviewState: value?.reviewState ?? \"draft\",\n    audit: value?.audit ?? [],\n  }));\n\n  const validateUpdate = async (update: Uint8Array, origin: unknown): Promise<number> => {\n    const baseline = documentGeneration;\n    const candidate = new Y.Doc({ guid: expectedDocumentId });\n    try {\n      Y.applyUpdate(candidate, Y.encodeStateAsUpdate(doc), \"validation:baseline\");\n      Y.applyUpdate(candidate, update, \"validation:candidate\");\n      assertContract(candidate);\n      const previousSidecar = parseSidecar(sidecar.get(\"value\"), source.length);\n      const candidateSidecar = parseSidecar(candidate.getMap<string>(\"sidecar\").get(\"value\"), candidate.getText(\"markdown\").length);\n      if (protectedSidecar(previousSidecar) !== protectedSidecar(candidateSidecar)) {\n        if (!options.authorizeSidecarUpdate || !(await options.authorizeSidecarUpdate(previousSidecar, candidateSidecar, origin))) {\n          throw new Error(\"MDFN_COLLAB_EDITORIAL_UPDATE_FORBIDDEN\");\n        }\n      }\n      return baseline;\n    } finally {\n      candidate.destroy();\n    }\n  };\n\n  if (!sharedDocumentInitialized) {\n    if (source.length === 0) source.insert(0, options.controller.getState().markdown);\n    if (!sidecar.has(\"value\") && options.controller.getState().sidecar) sidecar.set(\"value\", JSON.stringify(options.controller.getState().sidecar));\n  } else {\n    assertContract(doc);\n    const state = options.controller.getState();\n    const sharedMarkdown = source.toString();\n    const sharedSidecar = parseSidecar(sidecar.get(\"value\"), sharedMarkdown.length);\n    let initial = new Transaction().withSource(\"collab:initial\").withMetadata({ addToHistory: false });\n    if (sharedMarkdown !== state.markdown) initial = initial.replaceSource(0, state.markdown.length, sharedMarkdown);\n    if (JSON.stringify(sharedSidecar) !== JSON.stringify(state.sidecar)) initial = initial.setSidecar(sharedSidecar);\n    if (initial.operations.length > 0) options.controller.dispatch(initial);\n  }\n\n  awareness.setLocalState({ user: options.user, documentId: options.documentId });\n\n  const trackDocumentGeneration = (): void => { documentGeneration += 1; };\n  doc.on(\"afterTransaction\", trackDocumentGeneration);\n\n  const unsubscribe = options.controller.subscribe((change) => {\n    if (applyingRemote || destroyed) return;\n    doc.transact(() => {\n      if (change.documentChanged) {\n        const current = source.toString();\n        const range = changedRange(current, change.current.markdown);\n        if (range.to > range.from) source.delete(range.from, range.to - range.from);\n        if (range.inserted) source.insert(range.from, range.inserted);\n      }\n      if (change.sidecarChanged) {\n        if (change.current.sidecar) sidecar.set(\"value\", JSON.stringify(change.current.sidecar));\n        else sidecar.delete(\"value\");\n      }\n    }, localOrigin);\n  });\n\n  const applySharedState = (transaction: Y.Transaction): void => {\n    if (destroyed || transaction.origin === localOrigin) return;\n    applyingRemote = true;\n    try {\n      const state = options.controller.getState();\n      const nextSource = source.toString();\n      let edit = new Transaction().withSource(\"collab:remote\").withMetadata({ addToHistory: false });\n      if (nextSource !== state.markdown) edit = edit.replaceSource(0, state.markdown.length, nextSource);\n      assertContract(doc);\n      const nextSidecar = parseSidecar(sidecar.get(\"value\"), nextSource.length);\n      if (JSON.stringify(nextSidecar) !== JSON.stringify(state.sidecar)) edit = edit.setSidecar(nextSidecar);\n      if (edit.operations.length > 0) options.controller.dispatch(edit);\n    } finally { applyingRemote = false; }\n  };\n  doc.on(\"afterTransaction\", applySharedState);\n\n  const compactPending = (): Uint8Array => {\n    const compactable = pendingUpdates.filter((entry) => entry !== inFlight);\n    const update = Y.mergeUpdates(compactable.map((entry) => entry.update));\n    if (update.byteLength > maxUpdateBytes) {\n      throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);\n    }\n    if (compactable.length === 0) return update;\n    const replacement = { id: ++nextPendingId, update };\n    pendingUpdates = inFlight ? [inFlight, replacement] : [replacement];\n    emitAudit({ type: \"compact\", byteLength: update.byteLength, pending: pendingUpdates.length });\n    return update;\n  };\n\n  const flush = async (): Promise<void> => {\n    if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n    if (!online || !options.sendUpdate || pendingUpdates.length === 0) return;\n    if (flushing) return flushing;\n    flushing = (async () => {\n      while (online && pendingUpdates.length > 0) {\n        const entry = pendingUpdates[0];\n        inFlight = entry;\n        try {\n          await options.sendUpdate!(entry.update);\n          pendingUpdates = pendingUpdates.filter((candidate) => candidate !== entry);\n          emitAudit({ type: \"flush\", byteLength: entry.update.byteLength, pending: pendingUpdates.length });\n        } finally {\n          if (inFlight === entry) inFlight = null;\n        }\n      }\n    })().finally(() => { flushing = null; });\n    return flushing;\n  };\n\n  const queueLocalUpdate = (update: Uint8Array, origin: unknown): void => {\n    if (destroyed || origin !== localOrigin) return;\n    pendingUpdates.push({ id: ++nextPendingId, update: update.slice() });\n    emitAudit({ type: \"local-update\", byteLength: update.byteLength, pending: pendingUpdates.length });\n    const threshold = options.compactionThresholdBytes ?? 2 * 1024 * 1024;\n    if (pendingUpdates.reduce((total, entry) => total + entry.update.byteLength, 0) > threshold) {\n      try {\n        compactPending();\n      } catch (error) {\n        if (!(error instanceof RangeError) || !error.message.startsWith(\"MDFN_COLLAB_UPDATE_TOO_LARGE:\")) throw error;\n      }\n    }\n    if (online) void flush().catch((error: unknown) => {\n      online = false;\n      emitAudit({ type: \"offline\", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });\n    });\n  };\n  doc.on(\"update\", queueLocalUpdate);\n  if (options.sendUpdate) {\n    const initial = Y.encodeStateAsUpdate(doc);\n    pendingUpdates.push({ id: ++nextPendingId, update: initial });\n    emitAudit({ type: \"local-update\", byteLength: initial.byteLength, pending: pendingUpdates.length });\n    if (online) void flush().catch((error: unknown) => {\n      online = false;\n      emitAudit({ type: \"offline\", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });\n    });\n  }\n\n  return {\n    doc,\n    awareness,\n    encodeUpdate: (stateVector) => stateVector ? Y.encodeStateAsUpdate(doc, stateVector) : Y.encodeStateAsUpdate(doc),\n    encodeStateVector: () => Y.encodeStateVector(doc),\n    async applyUpdate(update, origin = \"transport\") {\n      if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n      const apply = async (): Promise<void> => {\n        try {\n          if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n          if (update.byteLength > maxUpdateBytes) throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);\n          if (options.authorizeUpdate && !(await options.authorizeUpdate(update, origin))) throw new Error(\"MDFN_COLLAB_UPDATE_FORBIDDEN\");\n          for (;;) {\n            const baseline = await validateUpdate(update, origin);\n            if (baseline !== documentGeneration) continue;\n            if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n            Y.applyUpdate(doc, update, origin);\n            emitAudit({ type: \"remote-update\", byteLength: update.byteLength });\n            return;\n          }\n        } catch (error) {\n          emitAudit({ type: \"remote-rejected\", byteLength: update.byteLength, error: error instanceof Error ? error.message : String(error) });\n          throw error;\n        }\n      };\n      const queued = remoteApplication.then(apply, apply);\n      remoteApplication = queued.catch(() => undefined);\n      return queued;\n    },\n    setPresence(value) { if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\"); awareness.setLocalStateField(\"presence\", value); },\n    getPresence: () => awareness.getStates(),\n    isOnline: () => online,\n    pendingUpdateCount: () => pendingUpdates.length,\n    async setOnline(value) {\n      if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n      online = value;\n      emitAudit({ type: value ? \"online\" : \"offline\", pending: pendingUpdates.length });\n      if (value) await flush();\n    },\n    flush,\n    compact: compactPending,\n    destroy() {\n      if (destroyed) return;\n      destroyed = true;\n      unsubscribe();\n      doc.off(\"afterTransaction\", applySharedState);\n      doc.off(\"afterTransaction\", trackDocumentGeneration);\n      doc.off(\"update\", queueLocalUpdate);\n      pendingUpdates = [];\n      awareness.setLocalState(null);\n      if (ownsAwareness) awareness.destroy();\n    },\n  };\n}\n\nexport { Awareness, Y };\nexport const MDFN_COLLAB_VERSION = \"0.1.0\" as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAAmB;AACnB,uBAA0B;AAC1B,kBAA8G;AAsC9G,SAAS,aAAa,OAA2B,gBAAkD;AACjG,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI;AACF,eAAO,iCAAoB,KAAK,MAAM,KAAK,GAAG,EAAE,eAAe,CAAC;AAAA,EAClE,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,+BAA+B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,EACzG;AACF;AAkBA,SAAS,aAAa,UAAkB,SAAiE;AACvG,MAAI,OAAO;AACX,SAAO,OAAO,SAAS,UAAU,OAAO,QAAQ,UAAU,SAAS,IAAI,MAAM,QAAQ,IAAI,EAAG,SAAQ;AACpG,MAAI,SAAS,SAAS;AACtB,MAAI,SAAS,QAAQ;AACrB,SAAO,SAAS,QAAQ,SAAS,QAAQ,SAAS,SAAS,CAAC,MAAM,QAAQ,SAAS,CAAC,GAAG;AAAE,cAAU;AAAG,cAAU;AAAA,EAAG;AACnH,SAAO,EAAE,MAAM,IAAI,QAAQ,UAAU,QAAQ,MAAM,MAAM,MAAM,EAAE;AACnE;AAEO,SAAS,2BAA2B,SAA4D;AACrG,QAAM,MAAM,QAAQ,OAAO,IAAM,MAAI,EAAE,MAAM,QAAQ,WAAW,CAAC;AACjE,QAAM,gBAAgB,CAAC,QAAQ;AAC/B,QAAM,YAAY,QAAQ,aAAa,IAAI,2BAAU,GAAG;AACxD,QAAM,SAAS,IAAI,QAAQ,UAAU;AACrC,QAAM,UAAU,IAAI,OAAe,SAAS;AAC5C,QAAM,WAAW,IAAI,OAAe,UAAU;AAC9C,QAAM,4BAA4B,QAAQ,QAAQ,WAAc,OAAO,SAAS,KAAK,QAAQ,OAAO,KAAK,SAAS,OAAO;AACzH,QAAM,cAAc,OAAO,OAAO,EAAE,SAAS,QAAQ,KAAK,GAAG,CAAC;AAC9D,MAAI,iBAAiB;AACrB,MAAI,YAAY;AAChB,MAAI,SAAS,QAAQ,UAAU;AAE/B,MAAI,gBAAgB;AACpB,MAAI,iBAAkC,CAAC;AACvC,MAAI,WAAiC;AACrC,MAAI,WAAiC;AACrC,MAAI,oBAAmC,QAAQ,QAAQ;AACvD,MAAI,qBAAqB;AACzB,QAAM,mBAAmB,QAAQ,oBAAoB,IAAI,OAAO;AAChE,QAAM,iBAAiB,QAAQ,kBAAkB,mBAAmB,KAAK,IAAI,KAAK,MAAM,KAAK,KAAK,mBAAmB,EAAE,CAAC;AAExH,QAAM,YAAY,CAAC,UAAwE;AACzF,YAAQ,UAAU,EAAE,GAAG,OAAO,YAAY,QAAQ,YAAY,QAAQ,QAAQ,KAAK,GAAG,CAAC;AAAA,EACzF;AAEA,QAAM,iBAAiB,QAAQ,WAAW,SAAS,EAAE;AACrD,QAAM,qBAAqB,QAAQ;AACnC,QAAM,kBAAkB,QAAQ,aAAa;AAC7C,QAAM,mBAAmB,OAAO,QAAQ,mBAAmB,CAAC;AAC5D,QAAM,qBAAqB,KAAK,UAAU,QAAQ,WAAW,WAAW,WAAW,IAAI,CAAC,eAAe,EAAE,MAAM,UAAU,MAAM,SAAS,UAAU,QAAQ,EAAE,CAAC;AAC7J,QAAM,eAAe,CAAC,KAAa,UAAkB,SAAuB;AAC1E,UAAM,UAAU,SAAS,IAAI,GAAG;AAChC,QAAI,YAAY,UAAa,YAAY,SAAU,OAAM,IAAI,MAAM,GAAG,IAAI,IAAI,OAAO,IAAI,QAAQ,EAAE;AACnG,QAAI,YAAY,OAAW,UAAS,IAAI,KAAK,QAAQ;AAAA,EACvD;AACA,eAAa,cAAc,gBAAgB,6BAA6B;AACxE,eAAa,cAAc,oBAAoB,+BAA+B;AAC9E,eAAa,aAAa,iBAAiB,8BAA8B;AACzE,eAAa,mBAAmB,kBAAkB,+BAA+B;AACjF,eAAa,cAAc,oBAAoB,iCAAiC;AAEhF,QAAM,iBAAiB,CAAC,cAA2B;AACjD,UAAM,oBAAoB,UAAU,OAAe,UAAU;AAC7D,UAAM,SAAS,kBAAkB,IAAI,YAAY;AACjD,QAAI,WAAW,eAAgB,OAAM,IAAI,MAAM,+BAA+B,UAAU,SAAS,IAAI,cAAc,EAAE;AACrH,QAAI,kBAAkB,IAAI,YAAY,MAAM,mBAAoB,OAAM,IAAI,MAAM,+BAA+B;AAC/G,QAAI,kBAAkB,IAAI,WAAW,MAAM,gBAAiB,OAAM,IAAI,MAAM,8BAA8B;AAC1G,QAAI,kBAAkB,IAAI,iBAAiB,MAAM,iBAAkB,OAAM,IAAI,MAAM,+BAA+B;AAClH,QAAI,kBAAkB,IAAI,YAAY,MAAM,mBAAoB,OAAM,IAAI,MAAM,iCAAiC;AACjH,UAAM,WAAW,UAAU,QAAQ,UAAU,EAAE,SAAS;AACxD,QAAI;AACF,cAAQ,WAAW,iBAAiB,QAAQ;AAAA,IAC9C,SAAS,OAAO;AACd,YAAM,IAAI,MAAM,gCAAgC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,IAC1G;AACA,iBAAa,UAAU,OAAe,SAAS,EAAE,IAAI,OAAO,GAAG,SAAS,MAAM;AAAA,EAChF;AAEA,QAAM,gBAAgB,CAAC,UAA4B;AACjD,QAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,aAAa;AACxD,QAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAgC,EAC5C,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MAAM,OAAO,QAAQ,KAAK,OAAO,QAAQ,IAAI,CAAC,EAClE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,cAAc,KAAK,CAAC,CAAC;AAAA,IACtD;AAAA,EACF;AACA,QAAM,mBAAmB,CAAC,UAA2C,KAAK,UAAU,cAAc;AAAA,IAChG,UAAU,OAAO,YAAY,CAAC;AAAA,IAC9B,aAAa,OAAO,eAAe,CAAC;AAAA,IACpC,aAAa,OAAO,eAAe;AAAA,IACnC,OAAO,OAAO,SAAS,CAAC;AAAA,EAC1B,CAAC,CAAC;AAEF,QAAM,iBAAiB,OAAO,QAAoB,WAAqC;AACrF,UAAM,WAAW;AACjB,UAAM,YAAY,IAAM,MAAI,EAAE,MAAM,mBAAmB,CAAC;AACxD,QAAI;AACF,MAAE,cAAY,WAAa,sBAAoB,GAAG,GAAG,qBAAqB;AAC1E,MAAE,cAAY,WAAW,QAAQ,sBAAsB;AACvD,qBAAe,SAAS;AACxB,YAAM,kBAAkB,aAAa,QAAQ,IAAI,OAAO,GAAG,OAAO,MAAM;AACxE,YAAM,mBAAmB,aAAa,UAAU,OAAe,SAAS,EAAE,IAAI,OAAO,GAAG,UAAU,QAAQ,UAAU,EAAE,MAAM;AAC5H,UAAI,iBAAiB,eAAe,MAAM,iBAAiB,gBAAgB,GAAG;AAC5E,YAAI,CAAC,QAAQ,0BAA0B,CAAE,MAAM,QAAQ,uBAAuB,iBAAiB,kBAAkB,MAAM,GAAI;AACzH,gBAAM,IAAI,MAAM,wCAAwC;AAAA,QAC1D;AAAA,MACF;AACA,aAAO;AAAA,IACT,UAAE;AACA,gBAAU,QAAQ;AAAA,IACpB;AAAA,EACF;AAEA,MAAI,CAAC,2BAA2B;AAC9B,QAAI,OAAO,WAAW,EAAG,QAAO,OAAO,GAAG,QAAQ,WAAW,SAAS,EAAE,QAAQ;AAChF,QAAI,CAAC,QAAQ,IAAI,OAAO,KAAK,QAAQ,WAAW,SAAS,EAAE,QAAS,SAAQ,IAAI,SAAS,KAAK,UAAU,QAAQ,WAAW,SAAS,EAAE,OAAO,CAAC;AAAA,EAChJ,OAAO;AACL,mBAAe,GAAG;AAClB,UAAM,QAAQ,QAAQ,WAAW,SAAS;AAC1C,UAAM,iBAAiB,OAAO,SAAS;AACvC,UAAM,gBAAgB,aAAa,QAAQ,IAAI,OAAO,GAAG,eAAe,MAAM;AAC9E,QAAI,UAAU,IAAI,wBAAY,EAAE,WAAW,gBAAgB,EAAE,aAAa,EAAE,cAAc,MAAM,CAAC;AACjG,QAAI,mBAAmB,MAAM,SAAU,WAAU,QAAQ,cAAc,GAAG,MAAM,SAAS,QAAQ,cAAc;AAC/G,QAAI,KAAK,UAAU,aAAa,MAAM,KAAK,UAAU,MAAM,OAAO,EAAG,WAAU,QAAQ,WAAW,aAAa;AAC/G,QAAI,QAAQ,WAAW,SAAS,EAAG,SAAQ,WAAW,SAAS,OAAO;AAAA,EACxE;AAEA,YAAU,cAAc,EAAE,MAAM,QAAQ,MAAM,YAAY,QAAQ,WAAW,CAAC;AAE9E,QAAM,0BAA0B,MAAY;AAAE,0BAAsB;AAAA,EAAG;AACvE,MAAI,GAAG,oBAAoB,uBAAuB;AAElD,QAAM,cAAc,QAAQ,WAAW,UAAU,CAAC,WAAW;AAC3D,QAAI,kBAAkB,UAAW;AACjC,QAAI,SAAS,MAAM;AACjB,UAAI,OAAO,iBAAiB;AAC1B,cAAM,UAAU,OAAO,SAAS;AAChC,cAAM,QAAQ,aAAa,SAAS,OAAO,QAAQ,QAAQ;AAC3D,YAAI,MAAM,KAAK,MAAM,KAAM,QAAO,OAAO,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI;AAC1E,YAAI,MAAM,SAAU,QAAO,OAAO,MAAM,MAAM,MAAM,QAAQ;AAAA,MAC9D;AACA,UAAI,OAAO,gBAAgB;AACzB,YAAI,OAAO,QAAQ,QAAS,SAAQ,IAAI,SAAS,KAAK,UAAU,OAAO,QAAQ,OAAO,CAAC;AAAA,YAClF,SAAQ,OAAO,OAAO;AAAA,MAC7B;AAAA,IACF,GAAG,WAAW;AAAA,EAChB,CAAC;AAED,QAAM,mBAAmB,CAAC,gBAAqC;AAC7D,QAAI,aAAa,YAAY,WAAW,YAAa;AACrD,qBAAiB;AACjB,QAAI;AACF,YAAM,QAAQ,QAAQ,WAAW,SAAS;AAC1C,YAAM,aAAa,OAAO,SAAS;AACnC,UAAI,OAAO,IAAI,wBAAY,EAAE,WAAW,eAAe,EAAE,aAAa,EAAE,cAAc,MAAM,CAAC;AAC7F,UAAI,eAAe,MAAM,SAAU,QAAO,KAAK,cAAc,GAAG,MAAM,SAAS,QAAQ,UAAU;AACjG,qBAAe,GAAG;AAClB,YAAM,cAAc,aAAa,QAAQ,IAAI,OAAO,GAAG,WAAW,MAAM;AACxE,UAAI,KAAK,UAAU,WAAW,MAAM,KAAK,UAAU,MAAM,OAAO,EAAG,QAAO,KAAK,WAAW,WAAW;AACrG,UAAI,KAAK,WAAW,SAAS,EAAG,SAAQ,WAAW,SAAS,IAAI;AAAA,IAClE,UAAE;AAAU,uBAAiB;AAAA,IAAO;AAAA,EACtC;AACA,MAAI,GAAG,oBAAoB,gBAAgB;AAE3C,QAAM,iBAAiB,MAAkB;AACvC,UAAM,cAAc,eAAe,OAAO,CAAC,UAAU,UAAU,QAAQ;AACvE,UAAM,SAAW,eAAa,YAAY,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC;AACtE,QAAI,OAAO,aAAa,gBAAgB;AACtC,YAAM,IAAI,WAAW,gCAAgC,cAAc,EAAE;AAAA,IACvE;AACA,QAAI,YAAY,WAAW,EAAG,QAAO;AACrC,UAAM,cAAc,EAAE,IAAI,EAAE,eAAe,OAAO;AAClD,qBAAiB,WAAW,CAAC,UAAU,WAAW,IAAI,CAAC,WAAW;AAClE,cAAU,EAAE,MAAM,WAAW,YAAY,OAAO,YAAY,SAAS,eAAe,OAAO,CAAC;AAC5F,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,YAA2B;AACvC,QAAI,UAAW,OAAM,IAAI,MAAM,uBAAuB;AACtD,QAAI,CAAC,UAAU,CAAC,QAAQ,cAAc,eAAe,WAAW,EAAG;AACnE,QAAI,SAAU,QAAO;AACrB,gBAAY,YAAY;AACtB,aAAO,UAAU,eAAe,SAAS,GAAG;AAC1C,cAAM,QAAQ,eAAe,CAAC;AAC9B,mBAAW;AACX,YAAI;AACF,gBAAM,QAAQ,WAAY,MAAM,MAAM;AACtC,2BAAiB,eAAe,OAAO,CAAC,cAAc,cAAc,KAAK;AACzE,oBAAU,EAAE,MAAM,SAAS,YAAY,MAAM,OAAO,YAAY,SAAS,eAAe,OAAO,CAAC;AAAA,QAClG,UAAE;AACA,cAAI,aAAa,MAAO,YAAW;AAAA,QACrC;AAAA,MACF;AAAA,IACF,GAAG,EAAE,QAAQ,MAAM;AAAE,iBAAW;AAAA,IAAM,CAAC;AACvC,WAAO;AAAA,EACT;AAEA,QAAM,mBAAmB,CAAC,QAAoB,WAA0B;AACtE,QAAI,aAAa,WAAW,YAAa;AACzC,mBAAe,KAAK,EAAE,IAAI,EAAE,eAAe,QAAQ,OAAO,MAAM,EAAE,CAAC;AACnE,cAAU,EAAE,MAAM,gBAAgB,YAAY,OAAO,YAAY,SAAS,eAAe,OAAO,CAAC;AACjG,UAAM,YAAY,QAAQ,4BAA4B,IAAI,OAAO;AACjE,QAAI,eAAe,OAAO,CAAC,OAAO,UAAU,QAAQ,MAAM,OAAO,YAAY,CAAC,IAAI,WAAW;AAC3F,UAAI;AACF,uBAAe;AAAA,MACjB,SAAS,OAAO;AACd,YAAI,EAAE,iBAAiB,eAAe,CAAC,MAAM,QAAQ,WAAW,+BAA+B,EAAG,OAAM;AAAA,MAC1G;AAAA,IACF;AACA,QAAI,OAAQ,MAAK,MAAM,EAAE,MAAM,CAAC,UAAmB;AACjD,eAAS;AACT,gBAAU,EAAE,MAAM,WAAW,SAAS,eAAe,QAAQ,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE,CAAC;AAAA,IAC9H,CAAC;AAAA,EACH;AACA,MAAI,GAAG,UAAU,gBAAgB;AACjC,MAAI,QAAQ,YAAY;AACtB,UAAM,UAAY,sBAAoB,GAAG;AACzC,mBAAe,KAAK,EAAE,IAAI,EAAE,eAAe,QAAQ,QAAQ,CAAC;AAC5D,cAAU,EAAE,MAAM,gBAAgB,YAAY,QAAQ,YAAY,SAAS,eAAe,OAAO,CAAC;AAClG,QAAI,OAAQ,MAAK,MAAM,EAAE,MAAM,CAAC,UAAmB;AACjD,eAAS;AACT,gBAAU,EAAE,MAAM,WAAW,SAAS,eAAe,QAAQ,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE,CAAC;AAAA,IAC9H,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,cAAc,CAAC,gBAAgB,cAAgB,sBAAoB,KAAK,WAAW,IAAM,sBAAoB,GAAG;AAAA,IAChH,mBAAmB,MAAQ,oBAAkB,GAAG;AAAA,IAChD,MAAM,YAAY,QAAQ,SAAS,aAAa;AAC9C,UAAI,UAAW,OAAM,IAAI,MAAM,uBAAuB;AACtD,YAAM,QAAQ,YAA2B;AACvC,YAAI;AACF,cAAI,UAAW,OAAM,IAAI,MAAM,uBAAuB;AACtD,cAAI,OAAO,aAAa,eAAgB,OAAM,IAAI,WAAW,gCAAgC,cAAc,EAAE;AAC7G,cAAI,QAAQ,mBAAmB,CAAE,MAAM,QAAQ,gBAAgB,QAAQ,MAAM,EAAI,OAAM,IAAI,MAAM,8BAA8B;AAC/H,qBAAS;AACP,kBAAM,WAAW,MAAM,eAAe,QAAQ,MAAM;AACpD,gBAAI,aAAa,mBAAoB;AACrC,gBAAI,UAAW,OAAM,IAAI,MAAM,uBAAuB;AACtD,YAAE,cAAY,KAAK,QAAQ,MAAM;AACjC,sBAAU,EAAE,MAAM,iBAAiB,YAAY,OAAO,WAAW,CAAC;AAClE;AAAA,UACF;AAAA,QACF,SAAS,OAAO;AACd,oBAAU,EAAE,MAAM,mBAAmB,YAAY,OAAO,YAAY,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE,CAAC;AACnI,gBAAM;AAAA,QACR;AAAA,MACF;AACA,YAAM,SAAS,kBAAkB,KAAK,OAAO,KAAK;AAClD,0BAAoB,OAAO,MAAM,MAAM,MAAS;AAChD,aAAO;AAAA,IACT;AAAA,IACA,YAAY,OAAO;AAAE,UAAI,UAAW,OAAM,IAAI,MAAM,uBAAuB;AAAG,gBAAU,mBAAmB,YAAY,KAAK;AAAA,IAAG;AAAA,IAC/H,aAAa,MAAM,UAAU,UAAU;AAAA,IACvC,UAAU,MAAM;AAAA,IAChB,oBAAoB,MAAM,eAAe;AAAA,IACzC,MAAM,UAAU,OAAO;AACrB,UAAI,UAAW,OAAM,IAAI,MAAM,uBAAuB;AACtD,eAAS;AACT,gBAAU,EAAE,MAAM,QAAQ,WAAW,WAAW,SAAS,eAAe,OAAO,CAAC;AAChF,UAAI,MAAO,OAAM,MAAM;AAAA,IACzB;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,UAAU;AACR,UAAI,UAAW;AACf,kBAAY;AACZ,kBAAY;AACZ,UAAI,IAAI,oBAAoB,gBAAgB;AAC5C,UAAI,IAAI,oBAAoB,uBAAuB;AACnD,UAAI,IAAI,UAAU,gBAAgB;AAClC,uBAAiB,CAAC;AAClB,gBAAU,cAAc,IAAI;AAC5B,UAAI,cAAe,WAAU,QAAQ;AAAA,IACvC;AAAA,EACF;AACF;AAGO,IAAM,sBAAsB;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+import * as Y from 'yjs';
+export { Y };
+import { Awareness } from 'y-protocols/awareness';
+export { Awareness } from 'y-protocols/awareness';
+import { MdfnJsonValue, EditorController, MdfnSidecar } from '@mdfn/core';
+
+interface CollaborationUser {
+    readonly id: string;
+    readonly name?: string;
+    readonly color?: string;
+    readonly metadata?: Readonly<Record<string, MdfnJsonValue>>;
+}
+interface CollaborationSessionOptions {
+    readonly controller: EditorController;
+    readonly documentId: string;
+    readonly user: CollaborationUser;
+    readonly doc?: Y.Doc;
+    readonly awareness?: Awareness;
+    readonly authorizeUpdate?: (update: Uint8Array, origin: unknown) => boolean | Promise<boolean>;
+    /** Protected editorial sidecar changes require an authoritative host decision. */
+    readonly authorizeSidecarUpdate?: (previous: MdfnSidecar | undefined, next: MdfnSidecar | undefined, origin: unknown) => boolean | Promise<boolean>;
+    readonly profileId?: string;
+    readonly protocolVersion?: number;
+    /** Maximum valid UTF-8 Markdown size; used to derive safe Yjs update limits. */
+    readonly maxDocumentBytes?: number;
+    readonly maxUpdateBytes?: number;
+    readonly online?: boolean;
+    readonly sendUpdate?: (update: Uint8Array) => void | Promise<void>;
+    readonly compactionThresholdBytes?: number;
+    readonly onAudit?: (event: CollaborationAuditEvent) => void;
+}
+interface CollaborationAuditEvent {
+    readonly type: "local-update" | "remote-update" | "remote-rejected" | "offline" | "online" | "flush" | "compact";
+    readonly documentId: string;
+    readonly userId: string;
+    readonly byteLength?: number;
+    readonly pending?: number;
+    readonly error?: string;
+}
+interface CollaborationSession {
+    readonly doc: Y.Doc;
+    readonly awareness: Awareness;
+    encodeUpdate(stateVector?: Uint8Array): Uint8Array;
+    encodeStateVector(): Uint8Array;
+    applyUpdate(update: Uint8Array, origin?: unknown): Promise<void>;
+    setPresence(value: Readonly<Record<string, MdfnJsonValue>>): void;
+    getPresence(): ReadonlyMap<number, unknown>;
+    isOnline(): boolean;
+    pendingUpdateCount(): number;
+    setOnline(online: boolean): Promise<void>;
+    flush(): Promise<void>;
+    compact(): Uint8Array;
+    destroy(): void;
+}
+declare function createCollaborationSession(options: CollaborationSessionOptions): CollaborationSession;
+
+declare const MDFN_COLLAB_VERSION: "0.1.0";
+
+export { type CollaborationAuditEvent, type CollaborationSession, type CollaborationSessionOptions, type CollaborationUser, MDFN_COLLAB_VERSION, createCollaborationSession };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import * as Y from 'yjs';
+export { Y };
+import { Awareness } from 'y-protocols/awareness';
+export { Awareness } from 'y-protocols/awareness';
+import { MdfnJsonValue, EditorController, MdfnSidecar } from '@mdfn/core';
+
+interface CollaborationUser {
+    readonly id: string;
+    readonly name?: string;
+    readonly color?: string;
+    readonly metadata?: Readonly<Record<string, MdfnJsonValue>>;
+}
+interface CollaborationSessionOptions {
+    readonly controller: EditorController;
+    readonly documentId: string;
+    readonly user: CollaborationUser;
+    readonly doc?: Y.Doc;
+    readonly awareness?: Awareness;
+    readonly authorizeUpdate?: (update: Uint8Array, origin: unknown) => boolean | Promise<boolean>;
+    /** Protected editorial sidecar changes require an authoritative host decision. */
+    readonly authorizeSidecarUpdate?: (previous: MdfnSidecar | undefined, next: MdfnSidecar | undefined, origin: unknown) => boolean | Promise<boolean>;
+    readonly profileId?: string;
+    readonly protocolVersion?: number;
+    /** Maximum valid UTF-8 Markdown size; used to derive safe Yjs update limits. */
+    readonly maxDocumentBytes?: number;
+    readonly maxUpdateBytes?: number;
+    readonly online?: boolean;
+    readonly sendUpdate?: (update: Uint8Array) => void | Promise<void>;
+    readonly compactionThresholdBytes?: number;
+    readonly onAudit?: (event: CollaborationAuditEvent) => void;
+}
+interface CollaborationAuditEvent {
+    readonly type: "local-update" | "remote-update" | "remote-rejected" | "offline" | "online" | "flush" | "compact";
+    readonly documentId: string;
+    readonly userId: string;
+    readonly byteLength?: number;
+    readonly pending?: number;
+    readonly error?: string;
+}
+interface CollaborationSession {
+    readonly doc: Y.Doc;
+    readonly awareness: Awareness;
+    encodeUpdate(stateVector?: Uint8Array): Uint8Array;
+    encodeStateVector(): Uint8Array;
+    applyUpdate(update: Uint8Array, origin?: unknown): Promise<void>;
+    setPresence(value: Readonly<Record<string, MdfnJsonValue>>): void;
+    getPresence(): ReadonlyMap<number, unknown>;
+    isOnline(): boolean;
+    pendingUpdateCount(): number;
+    setOnline(online: boolean): Promise<void>;
+    flush(): Promise<void>;
+    compact(): Uint8Array;
+    destroy(): void;
+}
+declare function createCollaborationSession(options: CollaborationSessionOptions): CollaborationSession;
+
+declare const MDFN_COLLAB_VERSION: "0.1.0";
+
+export { type CollaborationAuditEvent, type CollaborationSession, type CollaborationSessionOptions, type CollaborationUser, MDFN_COLLAB_VERSION, createCollaborationSession };

package/dist/index.js

@@ -0,0 +1,284 @@
+// src/index.ts
+import * as Y from "yjs";
+import { Awareness } from "y-protocols/awareness";
+import { Transaction, validateMdfnSidecar } from "@mdfn/core";
+function parseSidecar(value, markdownLength) {
+  if (value === void 0) return void 0;
+  try {
+    return validateMdfnSidecar(JSON.parse(value), { markdownLength });
+  } catch (error) {
+    throw new Error(`MDFN_COLLAB_SIDECAR_INVALID:${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+function changedRange(previous, current) {
+  let from = 0;
+  while (from < previous.length && from < current.length && previous[from] === current[from]) from += 1;
+  let oldEnd = previous.length;
+  let newEnd = current.length;
+  while (oldEnd > from && newEnd > from && previous[oldEnd - 1] === current[newEnd - 1]) {
+    oldEnd -= 1;
+    newEnd -= 1;
+  }
+  return { from, to: oldEnd, inserted: current.slice(from, newEnd) };
+}
+function createCollaborationSession(options) {
+  const doc = options.doc ?? new Y.Doc({ guid: options.documentId });
+  const ownsAwareness = !options.awareness;
+  const awareness = options.awareness ?? new Awareness(doc);
+  const source = doc.getText("markdown");
+  const sidecar = doc.getMap("sidecar");
+  const metadata = doc.getMap("metadata");
+  const sharedDocumentInitialized = options.doc !== void 0 && (source.length > 0 || sidecar.size > 0 || metadata.size > 0);
+  const localOrigin = Object.freeze({ session: options.user.id });
+  let applyingRemote = false;
+  let destroyed = false;
+  let online = options.online ?? true;
+  let nextPendingId = 0;
+  let pendingUpdates = [];
+  let inFlight = null;
+  let flushing = null;
+  let remoteApplication = Promise.resolve();
+  let documentGeneration = 0;
+  const maxDocumentBytes = options.maxDocumentBytes ?? 2 * 1024 * 1024;
+  const maxUpdateBytes = options.maxUpdateBytes ?? maxDocumentBytes + Math.max(64 * 1024, Math.ceil(maxDocumentBytes / 16));
+  const emitAudit = (event) => {
+    options.onAudit?.({ ...event, documentId: options.documentId, userId: options.user.id });
+  };
+  const expectedSchema = options.controller.getState().schemaHash;
+  const expectedDocumentId = options.documentId;
+  const expectedProfile = options.profileId ?? "default";
+  const expectedProtocol = String(options.protocolVersion ?? 1);
+  const expectedExtensions = JSON.stringify(options.controller.extensions.extensions.map((extension) => ({ name: extension.name, version: extension.version })));
+  const bindMetadata = (key, expected, code) => {
+    const current = metadata.get(key);
+    if (current !== void 0 && current !== expected) throw new Error(`${code}:${current}:${expected}`);
+    if (current === void 0) metadata.set(key, expected);
+  };
+  bindMetadata("schemaHash", expectedSchema, "MDFN_COLLAB_SCHEMA_MISMATCH");
+  bindMetadata("documentId", expectedDocumentId, "MDFN_COLLAB_DOCUMENT_MISMATCH");
+  bindMetadata("profileId", expectedProfile, "MDFN_COLLAB_PROFILE_MISMATCH");
+  bindMetadata("protocolVersion", expectedProtocol, "MDFN_COLLAB_PROTOCOL_MISMATCH");
+  bindMetadata("extensions", expectedExtensions, "MDFN_COLLAB_EXTENSIONS_MISMATCH");
+  const assertContract = (candidate) => {
+    const candidateMetadata = candidate.getMap("metadata");
+    const schema = candidateMetadata.get("schemaHash");
+    if (schema !== expectedSchema) throw new Error(`MDFN_COLLAB_SCHEMA_MISMATCH:${schema ?? "missing"}:${expectedSchema}`);
+    if (candidateMetadata.get("documentId") !== expectedDocumentId) throw new Error("MDFN_COLLAB_DOCUMENT_MISMATCH");
+    if (candidateMetadata.get("profileId") !== expectedProfile) throw new Error("MDFN_COLLAB_PROFILE_MISMATCH");
+    if (candidateMetadata.get("protocolVersion") !== expectedProtocol) throw new Error("MDFN_COLLAB_PROTOCOL_MISMATCH");
+    if (candidateMetadata.get("extensions") !== expectedExtensions) throw new Error("MDFN_COLLAB_EXTENSIONS_MISMATCH");
+    const markdown = candidate.getText("markdown").toString();
+    try {
+      options.controller.validateMarkdown(markdown);
+    } catch (error) {
+      throw new Error(`MDFN_COLLAB_MARKDOWN_INVALID:${error instanceof Error ? error.message : String(error)}`);
+    }
+    parseSidecar(candidate.getMap("sidecar").get("value"), markdown.length);
+  };
+  const canonicalJson = (value) => {
+    if (Array.isArray(value)) return value.map(canonicalJson);
+    if (value === null || typeof value !== "object") return value;
+    return Object.fromEntries(
+      Object.entries(value).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, entry]) => [key, canonicalJson(entry)])
+    );
+  };
+  const protectedSidecar = (value) => JSON.stringify(canonicalJson({
+    comments: value?.comments ?? [],
+    suggestions: value?.suggestions ?? [],
+    reviewState: value?.reviewState ?? "draft",
+    audit: value?.audit ?? []
+  }));
+  const validateUpdate = async (update, origin) => {
+    const baseline = documentGeneration;
+    const candidate = new Y.Doc({ guid: expectedDocumentId });
+    try {
+      Y.applyUpdate(candidate, Y.encodeStateAsUpdate(doc), "validation:baseline");
+      Y.applyUpdate(candidate, update, "validation:candidate");
+      assertContract(candidate);
+      const previousSidecar = parseSidecar(sidecar.get("value"), source.length);
+      const candidateSidecar = parseSidecar(candidate.getMap("sidecar").get("value"), candidate.getText("markdown").length);
+      if (protectedSidecar(previousSidecar) !== protectedSidecar(candidateSidecar)) {
+        if (!options.authorizeSidecarUpdate || !await options.authorizeSidecarUpdate(previousSidecar, candidateSidecar, origin)) {
+          throw new Error("MDFN_COLLAB_EDITORIAL_UPDATE_FORBIDDEN");
+        }
+      }
+      return baseline;
+    } finally {
+      candidate.destroy();
+    }
+  };
+  if (!sharedDocumentInitialized) {
+    if (source.length === 0) source.insert(0, options.controller.getState().markdown);
+    if (!sidecar.has("value") && options.controller.getState().sidecar) sidecar.set("value", JSON.stringify(options.controller.getState().sidecar));
+  } else {
+    assertContract(doc);
+    const state = options.controller.getState();
+    const sharedMarkdown = source.toString();
+    const sharedSidecar = parseSidecar(sidecar.get("value"), sharedMarkdown.length);
+    let initial = new Transaction().withSource("collab:initial").withMetadata({ addToHistory: false });
+    if (sharedMarkdown !== state.markdown) initial = initial.replaceSource(0, state.markdown.length, sharedMarkdown);
+    if (JSON.stringify(sharedSidecar) !== JSON.stringify(state.sidecar)) initial = initial.setSidecar(sharedSidecar);
+    if (initial.operations.length > 0) options.controller.dispatch(initial);
+  }
+  awareness.setLocalState({ user: options.user, documentId: options.documentId });
+  const trackDocumentGeneration = () => {
+    documentGeneration += 1;
+  };
+  doc.on("afterTransaction", trackDocumentGeneration);
+  const unsubscribe = options.controller.subscribe((change) => {
+    if (applyingRemote || destroyed) return;
+    doc.transact(() => {
+      if (change.documentChanged) {
+        const current = source.toString();
+        const range = changedRange(current, change.current.markdown);
+        if (range.to > range.from) source.delete(range.from, range.to - range.from);
+        if (range.inserted) source.insert(range.from, range.inserted);
+      }
+      if (change.sidecarChanged) {
+        if (change.current.sidecar) sidecar.set("value", JSON.stringify(change.current.sidecar));
+        else sidecar.delete("value");
+      }
+    }, localOrigin);
+  });
+  const applySharedState = (transaction) => {
+    if (destroyed || transaction.origin === localOrigin) return;
+    applyingRemote = true;
+    try {
+      const state = options.controller.getState();
+      const nextSource = source.toString();
+      let edit = new Transaction().withSource("collab:remote").withMetadata({ addToHistory: false });
+      if (nextSource !== state.markdown) edit = edit.replaceSource(0, state.markdown.length, nextSource);
+      assertContract(doc);
+      const nextSidecar = parseSidecar(sidecar.get("value"), nextSource.length);
+      if (JSON.stringify(nextSidecar) !== JSON.stringify(state.sidecar)) edit = edit.setSidecar(nextSidecar);
+      if (edit.operations.length > 0) options.controller.dispatch(edit);
+    } finally {
+      applyingRemote = false;
+    }
+  };
+  doc.on("afterTransaction", applySharedState);
+  const compactPending = () => {
+    const compactable = pendingUpdates.filter((entry) => entry !== inFlight);
+    const update = Y.mergeUpdates(compactable.map((entry) => entry.update));
+    if (update.byteLength > maxUpdateBytes) {
+      throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);
+    }
+    if (compactable.length === 0) return update;
+    const replacement = { id: ++nextPendingId, update };
+    pendingUpdates = inFlight ? [inFlight, replacement] : [replacement];
+    emitAudit({ type: "compact", byteLength: update.byteLength, pending: pendingUpdates.length });
+    return update;
+  };
+  const flush = async () => {
+    if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+    if (!online || !options.sendUpdate || pendingUpdates.length === 0) return;
+    if (flushing) return flushing;
+    flushing = (async () => {
+      while (online && pendingUpdates.length > 0) {
+        const entry = pendingUpdates[0];
+        inFlight = entry;
+        try {
+          await options.sendUpdate(entry.update);
+          pendingUpdates = pendingUpdates.filter((candidate) => candidate !== entry);
+          emitAudit({ type: "flush", byteLength: entry.update.byteLength, pending: pendingUpdates.length });
+        } finally {
+          if (inFlight === entry) inFlight = null;
+        }
+      }
+    })().finally(() => {
+      flushing = null;
+    });
+    return flushing;
+  };
+  const queueLocalUpdate = (update, origin) => {
+    if (destroyed || origin !== localOrigin) return;
+    pendingUpdates.push({ id: ++nextPendingId, update: update.slice() });
+    emitAudit({ type: "local-update", byteLength: update.byteLength, pending: pendingUpdates.length });
+    const threshold = options.compactionThresholdBytes ?? 2 * 1024 * 1024;
+    if (pendingUpdates.reduce((total, entry) => total + entry.update.byteLength, 0) > threshold) {
+      try {
+        compactPending();
+      } catch (error) {
+        if (!(error instanceof RangeError) || !error.message.startsWith("MDFN_COLLAB_UPDATE_TOO_LARGE:")) throw error;
+      }
+    }
+    if (online) void flush().catch((error) => {
+      online = false;
+      emitAudit({ type: "offline", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });
+    });
+  };
+  doc.on("update", queueLocalUpdate);
+  if (options.sendUpdate) {
+    const initial = Y.encodeStateAsUpdate(doc);
+    pendingUpdates.push({ id: ++nextPendingId, update: initial });
+    emitAudit({ type: "local-update", byteLength: initial.byteLength, pending: pendingUpdates.length });
+    if (online) void flush().catch((error) => {
+      online = false;
+      emitAudit({ type: "offline", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });
+    });
+  }
+  return {
+    doc,
+    awareness,
+    encodeUpdate: (stateVector) => stateVector ? Y.encodeStateAsUpdate(doc, stateVector) : Y.encodeStateAsUpdate(doc),
+    encodeStateVector: () => Y.encodeStateVector(doc),
+    async applyUpdate(update, origin = "transport") {
+      if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+      const apply = async () => {
+        try {
+          if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+          if (update.byteLength > maxUpdateBytes) throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);
+          if (options.authorizeUpdate && !await options.authorizeUpdate(update, origin)) throw new Error("MDFN_COLLAB_UPDATE_FORBIDDEN");
+          for (; ; ) {
+            const baseline = await validateUpdate(update, origin);
+            if (baseline !== documentGeneration) continue;
+            if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+            Y.applyUpdate(doc, update, origin);
+            emitAudit({ type: "remote-update", byteLength: update.byteLength });
+            return;
+          }
+        } catch (error) {
+          emitAudit({ type: "remote-rejected", byteLength: update.byteLength, error: error instanceof Error ? error.message : String(error) });
+          throw error;
+        }
+      };
+      const queued = remoteApplication.then(apply, apply);
+      remoteApplication = queued.catch(() => void 0);
+      return queued;
+    },
+    setPresence(value) {
+      if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+      awareness.setLocalStateField("presence", value);
+    },
+    getPresence: () => awareness.getStates(),
+    isOnline: () => online,
+    pendingUpdateCount: () => pendingUpdates.length,
+    async setOnline(value) {
+      if (destroyed) throw new Error("MDFN_COLLAB_DESTROYED");
+      online = value;
+      emitAudit({ type: value ? "online" : "offline", pending: pendingUpdates.length });
+      if (value) await flush();
+    },
+    flush,
+    compact: compactPending,
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      unsubscribe();
+      doc.off("afterTransaction", applySharedState);
+      doc.off("afterTransaction", trackDocumentGeneration);
+      doc.off("update", queueLocalUpdate);
+      pendingUpdates = [];
+      awareness.setLocalState(null);
+      if (ownsAwareness) awareness.destroy();
+    }
+  };
+}
+var MDFN_COLLAB_VERSION = "0.1.0";
+export {
+  Awareness,
+  MDFN_COLLAB_VERSION,
+  Y,
+  createCollaborationSession
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import * as Y from \"yjs\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport { Transaction, validateMdfnSidecar, type EditorController, type MdfnJsonValue, type MdfnSidecar } from \"@mdfn/core\";\n\nexport interface CollaborationUser {\n  readonly id: string;\n  readonly name?: string;\n  readonly color?: string;\n  readonly metadata?: Readonly<Record<string, MdfnJsonValue>>;\n}\n\nexport interface CollaborationSessionOptions {\n  readonly controller: EditorController;\n  readonly documentId: string;\n  readonly user: CollaborationUser;\n  readonly doc?: Y.Doc;\n  readonly awareness?: Awareness;\n  readonly authorizeUpdate?: (update: Uint8Array, origin: unknown) => boolean | Promise<boolean>;\n  /** Protected editorial sidecar changes require an authoritative host decision. */\n  readonly authorizeSidecarUpdate?: (previous: MdfnSidecar | undefined, next: MdfnSidecar | undefined, origin: unknown) => boolean | Promise<boolean>;\n  readonly profileId?: string;\n  readonly protocolVersion?: number;\n  /** Maximum valid UTF-8 Markdown size; used to derive safe Yjs update limits. */\n  readonly maxDocumentBytes?: number;\n  readonly maxUpdateBytes?: number;\n  readonly online?: boolean;\n  readonly sendUpdate?: (update: Uint8Array) => void | Promise<void>;\n  readonly compactionThresholdBytes?: number;\n  readonly onAudit?: (event: CollaborationAuditEvent) => void;\n}\n\nexport interface CollaborationAuditEvent {\n  readonly type: \"local-update\" | \"remote-update\" | \"remote-rejected\" | \"offline\" | \"online\" | \"flush\" | \"compact\";\n  readonly documentId: string;\n  readonly userId: string;\n  readonly byteLength?: number;\n  readonly pending?: number;\n  readonly error?: string;\n}\n\nfunction parseSidecar(value: string | undefined, markdownLength?: number): MdfnSidecar | undefined {\n  if (value === undefined) return undefined;\n  try {\n    return validateMdfnSidecar(JSON.parse(value), { markdownLength });\n  } catch (error) {\n    throw new Error(`MDFN_COLLAB_SIDECAR_INVALID:${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\nexport interface CollaborationSession {\n  readonly doc: Y.Doc;\n  readonly awareness: Awareness;\n  encodeUpdate(stateVector?: Uint8Array): Uint8Array;\n  encodeStateVector(): Uint8Array;\n  applyUpdate(update: Uint8Array, origin?: unknown): Promise<void>;\n  setPresence(value: Readonly<Record<string, MdfnJsonValue>>): void;\n  getPresence(): ReadonlyMap<number, unknown>;\n  isOnline(): boolean;\n  pendingUpdateCount(): number;\n  setOnline(online: boolean): Promise<void>;\n  flush(): Promise<void>;\n  compact(): Uint8Array;\n  destroy(): void;\n}\n\nfunction changedRange(previous: string, current: string): { from: number; to: number; inserted: string } {\n  let from = 0;\n  while (from < previous.length && from < current.length && previous[from] === current[from]) from += 1;\n  let oldEnd = previous.length;\n  let newEnd = current.length;\n  while (oldEnd > from && newEnd > from && previous[oldEnd - 1] === current[newEnd - 1]) { oldEnd -= 1; newEnd -= 1; }\n  return { from, to: oldEnd, inserted: current.slice(from, newEnd) };\n}\n\nexport function createCollaborationSession(options: CollaborationSessionOptions): CollaborationSession {\n  const doc = options.doc ?? new Y.Doc({ guid: options.documentId });\n  const ownsAwareness = !options.awareness;\n  const awareness = options.awareness ?? new Awareness(doc);\n  const source = doc.getText(\"markdown\");\n  const sidecar = doc.getMap<string>(\"sidecar\");\n  const metadata = doc.getMap<string>(\"metadata\");\n  const sharedDocumentInitialized = options.doc !== undefined && (source.length > 0 || sidecar.size > 0 || metadata.size > 0);\n  const localOrigin = Object.freeze({ session: options.user.id });\n  let applyingRemote = false;\n  let destroyed = false;\n  let online = options.online ?? true;\n  interface PendingUpdate { readonly id: number; readonly update: Uint8Array; }\n  let nextPendingId = 0;\n  let pendingUpdates: PendingUpdate[] = [];\n  let inFlight: PendingUpdate | null = null;\n  let flushing: Promise<void> | null = null;\n  let remoteApplication: Promise<void> = Promise.resolve();\n  let documentGeneration = 0;\n  const maxDocumentBytes = options.maxDocumentBytes ?? 2 * 1024 * 1024;\n  const maxUpdateBytes = options.maxUpdateBytes ?? maxDocumentBytes + Math.max(64 * 1024, Math.ceil(maxDocumentBytes / 16));\n\n  const emitAudit = (event: Omit<CollaborationAuditEvent, \"documentId\" | \"userId\">): void => {\n    options.onAudit?.({ ...event, documentId: options.documentId, userId: options.user.id });\n  };\n\n  const expectedSchema = options.controller.getState().schemaHash;\n  const expectedDocumentId = options.documentId;\n  const expectedProfile = options.profileId ?? \"default\";\n  const expectedProtocol = String(options.protocolVersion ?? 1);\n  const expectedExtensions = JSON.stringify(options.controller.extensions.extensions.map((extension) => ({ name: extension.name, version: extension.version })));\n  const bindMetadata = (key: string, expected: string, code: string): void => {\n    const current = metadata.get(key);\n    if (current !== undefined && current !== expected) throw new Error(`${code}:${current}:${expected}`);\n    if (current === undefined) metadata.set(key, expected);\n  };\n  bindMetadata(\"schemaHash\", expectedSchema, \"MDFN_COLLAB_SCHEMA_MISMATCH\");\n  bindMetadata(\"documentId\", expectedDocumentId, \"MDFN_COLLAB_DOCUMENT_MISMATCH\");\n  bindMetadata(\"profileId\", expectedProfile, \"MDFN_COLLAB_PROFILE_MISMATCH\");\n  bindMetadata(\"protocolVersion\", expectedProtocol, \"MDFN_COLLAB_PROTOCOL_MISMATCH\");\n  bindMetadata(\"extensions\", expectedExtensions, \"MDFN_COLLAB_EXTENSIONS_MISMATCH\");\n\n  const assertContract = (candidate: Y.Doc): void => {\n    const candidateMetadata = candidate.getMap<string>(\"metadata\");\n    const schema = candidateMetadata.get(\"schemaHash\");\n    if (schema !== expectedSchema) throw new Error(`MDFN_COLLAB_SCHEMA_MISMATCH:${schema ?? \"missing\"}:${expectedSchema}`);\n    if (candidateMetadata.get(\"documentId\") !== expectedDocumentId) throw new Error(\"MDFN_COLLAB_DOCUMENT_MISMATCH\");\n    if (candidateMetadata.get(\"profileId\") !== expectedProfile) throw new Error(\"MDFN_COLLAB_PROFILE_MISMATCH\");\n    if (candidateMetadata.get(\"protocolVersion\") !== expectedProtocol) throw new Error(\"MDFN_COLLAB_PROTOCOL_MISMATCH\");\n    if (candidateMetadata.get(\"extensions\") !== expectedExtensions) throw new Error(\"MDFN_COLLAB_EXTENSIONS_MISMATCH\");\n    const markdown = candidate.getText(\"markdown\").toString();\n    try {\n      options.controller.validateMarkdown(markdown);\n    } catch (error) {\n      throw new Error(`MDFN_COLLAB_MARKDOWN_INVALID:${error instanceof Error ? error.message : String(error)}`);\n    }\n    parseSidecar(candidate.getMap<string>(\"sidecar\").get(\"value\"), markdown.length);\n  };\n\n  const canonicalJson = (value: unknown): unknown => {\n    if (Array.isArray(value)) return value.map(canonicalJson);\n    if (value === null || typeof value !== \"object\") return value;\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)\n        .map(([key, entry]) => [key, canonicalJson(entry)]),\n    );\n  };\n  const protectedSidecar = (value: MdfnSidecar | undefined): string => JSON.stringify(canonicalJson({\n    comments: value?.comments ?? [],\n    suggestions: value?.suggestions ?? [],\n    reviewState: value?.reviewState ?? \"draft\",\n    audit: value?.audit ?? [],\n  }));\n\n  const validateUpdate = async (update: Uint8Array, origin: unknown): Promise<number> => {\n    const baseline = documentGeneration;\n    const candidate = new Y.Doc({ guid: expectedDocumentId });\n    try {\n      Y.applyUpdate(candidate, Y.encodeStateAsUpdate(doc), \"validation:baseline\");\n      Y.applyUpdate(candidate, update, \"validation:candidate\");\n      assertContract(candidate);\n      const previousSidecar = parseSidecar(sidecar.get(\"value\"), source.length);\n      const candidateSidecar = parseSidecar(candidate.getMap<string>(\"sidecar\").get(\"value\"), candidate.getText(\"markdown\").length);\n      if (protectedSidecar(previousSidecar) !== protectedSidecar(candidateSidecar)) {\n        if (!options.authorizeSidecarUpdate || !(await options.authorizeSidecarUpdate(previousSidecar, candidateSidecar, origin))) {\n          throw new Error(\"MDFN_COLLAB_EDITORIAL_UPDATE_FORBIDDEN\");\n        }\n      }\n      return baseline;\n    } finally {\n      candidate.destroy();\n    }\n  };\n\n  if (!sharedDocumentInitialized) {\n    if (source.length === 0) source.insert(0, options.controller.getState().markdown);\n    if (!sidecar.has(\"value\") && options.controller.getState().sidecar) sidecar.set(\"value\", JSON.stringify(options.controller.getState().sidecar));\n  } else {\n    assertContract(doc);\n    const state = options.controller.getState();\n    const sharedMarkdown = source.toString();\n    const sharedSidecar = parseSidecar(sidecar.get(\"value\"), sharedMarkdown.length);\n    let initial = new Transaction().withSource(\"collab:initial\").withMetadata({ addToHistory: false });\n    if (sharedMarkdown !== state.markdown) initial = initial.replaceSource(0, state.markdown.length, sharedMarkdown);\n    if (JSON.stringify(sharedSidecar) !== JSON.stringify(state.sidecar)) initial = initial.setSidecar(sharedSidecar);\n    if (initial.operations.length > 0) options.controller.dispatch(initial);\n  }\n\n  awareness.setLocalState({ user: options.user, documentId: options.documentId });\n\n  const trackDocumentGeneration = (): void => { documentGeneration += 1; };\n  doc.on(\"afterTransaction\", trackDocumentGeneration);\n\n  const unsubscribe = options.controller.subscribe((change) => {\n    if (applyingRemote || destroyed) return;\n    doc.transact(() => {\n      if (change.documentChanged) {\n        const current = source.toString();\n        const range = changedRange(current, change.current.markdown);\n        if (range.to > range.from) source.delete(range.from, range.to - range.from);\n        if (range.inserted) source.insert(range.from, range.inserted);\n      }\n      if (change.sidecarChanged) {\n        if (change.current.sidecar) sidecar.set(\"value\", JSON.stringify(change.current.sidecar));\n        else sidecar.delete(\"value\");\n      }\n    }, localOrigin);\n  });\n\n  const applySharedState = (transaction: Y.Transaction): void => {\n    if (destroyed || transaction.origin === localOrigin) return;\n    applyingRemote = true;\n    try {\n      const state = options.controller.getState();\n      const nextSource = source.toString();\n      let edit = new Transaction().withSource(\"collab:remote\").withMetadata({ addToHistory: false });\n      if (nextSource !== state.markdown) edit = edit.replaceSource(0, state.markdown.length, nextSource);\n      assertContract(doc);\n      const nextSidecar = parseSidecar(sidecar.get(\"value\"), nextSource.length);\n      if (JSON.stringify(nextSidecar) !== JSON.stringify(state.sidecar)) edit = edit.setSidecar(nextSidecar);\n      if (edit.operations.length > 0) options.controller.dispatch(edit);\n    } finally { applyingRemote = false; }\n  };\n  doc.on(\"afterTransaction\", applySharedState);\n\n  const compactPending = (): Uint8Array => {\n    const compactable = pendingUpdates.filter((entry) => entry !== inFlight);\n    const update = Y.mergeUpdates(compactable.map((entry) => entry.update));\n    if (update.byteLength > maxUpdateBytes) {\n      throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);\n    }\n    if (compactable.length === 0) return update;\n    const replacement = { id: ++nextPendingId, update };\n    pendingUpdates = inFlight ? [inFlight, replacement] : [replacement];\n    emitAudit({ type: \"compact\", byteLength: update.byteLength, pending: pendingUpdates.length });\n    return update;\n  };\n\n  const flush = async (): Promise<void> => {\n    if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n    if (!online || !options.sendUpdate || pendingUpdates.length === 0) return;\n    if (flushing) return flushing;\n    flushing = (async () => {\n      while (online && pendingUpdates.length > 0) {\n        const entry = pendingUpdates[0];\n        inFlight = entry;\n        try {\n          await options.sendUpdate!(entry.update);\n          pendingUpdates = pendingUpdates.filter((candidate) => candidate !== entry);\n          emitAudit({ type: \"flush\", byteLength: entry.update.byteLength, pending: pendingUpdates.length });\n        } finally {\n          if (inFlight === entry) inFlight = null;\n        }\n      }\n    })().finally(() => { flushing = null; });\n    return flushing;\n  };\n\n  const queueLocalUpdate = (update: Uint8Array, origin: unknown): void => {\n    if (destroyed || origin !== localOrigin) return;\n    pendingUpdates.push({ id: ++nextPendingId, update: update.slice() });\n    emitAudit({ type: \"local-update\", byteLength: update.byteLength, pending: pendingUpdates.length });\n    const threshold = options.compactionThresholdBytes ?? 2 * 1024 * 1024;\n    if (pendingUpdates.reduce((total, entry) => total + entry.update.byteLength, 0) > threshold) {\n      try {\n        compactPending();\n      } catch (error) {\n        if (!(error instanceof RangeError) || !error.message.startsWith(\"MDFN_COLLAB_UPDATE_TOO_LARGE:\")) throw error;\n      }\n    }\n    if (online) void flush().catch((error: unknown) => {\n      online = false;\n      emitAudit({ type: \"offline\", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });\n    });\n  };\n  doc.on(\"update\", queueLocalUpdate);\n  if (options.sendUpdate) {\n    const initial = Y.encodeStateAsUpdate(doc);\n    pendingUpdates.push({ id: ++nextPendingId, update: initial });\n    emitAudit({ type: \"local-update\", byteLength: initial.byteLength, pending: pendingUpdates.length });\n    if (online) void flush().catch((error: unknown) => {\n      online = false;\n      emitAudit({ type: \"offline\", pending: pendingUpdates.length, error: error instanceof Error ? error.message : String(error) });\n    });\n  }\n\n  return {\n    doc,\n    awareness,\n    encodeUpdate: (stateVector) => stateVector ? Y.encodeStateAsUpdate(doc, stateVector) : Y.encodeStateAsUpdate(doc),\n    encodeStateVector: () => Y.encodeStateVector(doc),\n    async applyUpdate(update, origin = \"transport\") {\n      if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n      const apply = async (): Promise<void> => {\n        try {\n          if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n          if (update.byteLength > maxUpdateBytes) throw new RangeError(`MDFN_COLLAB_UPDATE_TOO_LARGE:${maxUpdateBytes}`);\n          if (options.authorizeUpdate && !(await options.authorizeUpdate(update, origin))) throw new Error(\"MDFN_COLLAB_UPDATE_FORBIDDEN\");\n          for (;;) {\n            const baseline = await validateUpdate(update, origin);\n            if (baseline !== documentGeneration) continue;\n            if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n            Y.applyUpdate(doc, update, origin);\n            emitAudit({ type: \"remote-update\", byteLength: update.byteLength });\n            return;\n          }\n        } catch (error) {\n          emitAudit({ type: \"remote-rejected\", byteLength: update.byteLength, error: error instanceof Error ? error.message : String(error) });\n          throw error;\n        }\n      };\n      const queued = remoteApplication.then(apply, apply);\n      remoteApplication = queued.catch(() => undefined);\n      return queued;\n    },\n    setPresence(value) { if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\"); awareness.setLocalStateField(\"presence\", value); },\n    getPresence: () => awareness.getStates(),\n    isOnline: () => online,\n    pendingUpdateCount: () => pendingUpdates.length,\n    async setOnline(value) {\n      if (destroyed) throw new Error(\"MDFN_COLLAB_DESTROYED\");\n      online = value;\n      emitAudit({ type: value ? \"online\" : \"offline\", pending: pendingUpdates.length });\n      if (value) await flush();\n    },\n    flush,\n    compact: compactPending,\n    destroy() {\n      if (destroyed) return;\n      destroyed = true;\n      unsubscribe();\n      doc.off(\"afterTransaction\", applySharedState);\n      doc.off(\"afterTransaction\", trackDocumentGeneration);\n      doc.off(\"update\", queueLocalUpdate);\n      pendingUpdates = [];\n      awareness.setLocalState(null);\n      if (ownsAwareness) awareness.destroy();\n    },\n  };\n}\n\nexport { Awareness, Y };\nexport const MDFN_COLLAB_VERSION = \"0.1.0\" as const;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@mdfn/collab", "version": "0.1.0", "description": "Yjs collaboration binding for mdfn source, presence, and sidecar state", "type": "module",
+  "main": "dist/index.cjs", "module": "dist/index.js", "types": "dist/index.d.ts", "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js", "require": "./dist/index.cjs" } },
+  "scripts": { "build": "tsup src/index.ts --format esm,cjs --dts --sourcemap --clean", "test": "vitest run", "typecheck": "tsc --noEmit -p tsconfig.json", "lint": "tsc --noEmit -p tsconfig.json", "prepack": "npm run build" },
+  "dependencies": { "@mdfn/core": "0.1.0", "y-protocols": "^1.0.6", "yjs": "^13.6.32" },
+  "devDependencies": { "@mdfn/markdown": "0.1.0", "tsup": "^8.0.0", "typescript": "^5.3.0", "vitest": "3.2.4" },
+  "files": ["dist", "README.md"], "sideEffects": false, "license": "MIT", "engines": { "node": ">=20 <25" }, "repository": { "type": "git", "url": "git+https://github.com/21nCo/super-functions.git", "directory": "mdfn/collab" }, "publishConfig": { "access": "public" },
+  "mdfn": { "status": "optional", "layer": "platform", "schemaVersion": 1 }
+}