@athenaintel/react 0.57.2 → 0.60.0

package/dist/keryx-http/src/initial-sync.d.ts

@@ -20,6 +20,20 @@ export declare const INITIAL_SYNC_PARAM = "initialSync";
 export declare const INITIAL_SYNC_DIFF = "diff";
 /** The `GET /ydoc` response header with which a Keryx says it answers `?initialSync=diff`. */
 export declare const INITIAL_SYNC_CAPABILITY_HEADER = "x-keryx-initial-sync";
+/**
+ * Which sockets of a room that opens HTTP-first ask for a diffed initial sync, while Keryx is known
+ * to answer it and the room holds no write Keryx has not echoed.
+ *
+ * - `every-socket` (Word documents): the socket after the room's read, every reconnect, and the
+ *   first socket of a room opened from its local copy.
+ * - `after-read` (decks): only the socket that follows the room's own read. A room opened from its
+ *   local copy, and every reconnect, get Keryx's whole document, as a room that does not open
+ *   HTTP-first does. Keryx diffs a room that is not one compacted row against its whole merged
+ *   document on every socket that asks (the `@y/hub` patch's `diffForClient`). On a fast link that
+ *   costs a deck reopened from its copy more than the whole document does (the Midas smoke's
+ *   160-slide deck synced in 3.3 s, where the whole document took about 0.6 s).
+ */
+export type DiffedInitialSync = 'every-socket' | 'after-read';
 /**
  * The `GET /ydoc` URL of the room a socket URL names: `wss://host/ws/<org>/<docId>` (or the
  * `/api/ws/v1/` spelling) becomes `https://host/api/ydoc/v1/<org>/<docId>?yauth=…&branch=…`. `null`
@@ -39,14 +53,30 @@ export interface RoomReadOverHttp {
     /** The decoded body's size. */
     bytes: number;
 }
+/**
+ * How long a room's HTTP-first read may receive nothing (no answer yet, or no byte of its body)
+ * before the room gives it up and syncs over its socket instead: the minute every read was allowed
+ * in all before, so no read is given up sooner than it was.
+ */
+export declare const HTTP_FIRST_READ_IDLE_TIMEOUT_MS = 60000;
+/**
+ * How long a room's HTTP-first read may take in all, however steadily its bytes come. A read still
+ * downloading is otherwise never thrown away: the socket's whole-document sync it would fall back to
+ * carries the same bytes, restarted from the first one on every reconnect (a large deck on a slow
+ * link took 39 s to 550 s that way, `@athenaintel/decks`' `deck-open-watchdog`).
+ */
+export declare const HTTP_FIRST_READ_TIMEOUT_MS: number;
 /**
  * Read a room over `GET /ydoc` (`url` from {@link keryxRoomReadUrl}). The runtime's `fetch` names
  * and decodes the content codings. Throws on a non-2xx answer or a body that is not a lib0 `{ doc }`.
+ * With `idleTimeoutMs`, a read that receives nothing for that long (no answer, or no byte of its
+ * body) is given up with a `TimeoutError`; one whose bytes keep coming runs as long as they do.
  */
-export declare function readRoomOverHttp({ url, signal, fetchImpl, }: {
+export declare function readRoomOverHttp({ url, signal, fetchImpl, idleTimeoutMs, }: {
     url: string;
     signal?: AbortSignal;
     fetchImpl?: typeof fetch;
+    idleTimeoutMs?: number;
 }): Promise<RoomReadOverHttp>;
 /** Where {@link rememberInitialSyncSupport} keeps what it learned: `localStorage`'s surface. */
 export interface InitialSyncSupportStorage {

package/dist/keryx-http/src/initial-sync.js

@@ -23,28 +23,74 @@ function keryxRoomReadUrl({
   read.searchParams.set("branch", branch);
   return read.toString();
 }
+const HTTP_FIRST_READ_IDLE_TIMEOUT_MS = 6e4;
+const HTTP_FIRST_READ_TIMEOUT_MS = 10 * 6e4;
+async function readBody({ response, onChunk }) {
+  const stream = response.body;
+  if (stream === null) return new Uint8Array(await response.arrayBuffer());
+  const reader = stream.getReader();
+  const chunks = [];
+  let length = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    chunks.push(value);
+    length += value.byteLength;
+    onChunk();
+  }
+  const body = new Uint8Array(length);
+  let offset = 0;
+  for (const chunk of chunks) {
+    body.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return body;
+}
 async function readRoomOverHttp({
   url,
   signal,
-  fetchImpl = fetch
+  fetchImpl = fetch,
+  idleTimeoutMs
 }) {
   var _a;
-  const response = await fetchImpl(url, { headers: { Accept: "application/octet-stream" }, signal });
-  if (!response.ok) {
-    await ((_a = response.body) == null ? void 0 : _a.cancel().catch(() => void 0));
-    throw new Error(`GET /ydoc answered ${response.status}`);
-  }
-  const body = new Uint8Array(await response.arrayBuffer());
-  const decoded = decoding.readAny(decoding.createDecoder(body));
-  if (decoded === null || typeof decoded !== "object" || !(decoded.doc instanceof Uint8Array)) {
-    throw new Error("GET /ydoc answered a body without a document");
-  }
-  return {
-    // a copy: lib0 hands out a view into the body
-    update: new Uint8Array(decoded.doc),
-    answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,
-    bytes: body.byteLength
+  const reading = new AbortController();
+  const stop = () => reading.abort(signal == null ? void 0 : signal.reason);
+  if (signal == null ? void 0 : signal.aborted) stop();
+  else signal == null ? void 0 : signal.addEventListener("abort", stop, { once: true });
+  let idle = null;
+  const stillReceiving = () => {
+    if (idle !== null) clearTimeout(idle);
+    idle = setTimeout(
+      () => reading.abort(new DOMException(`GET /ydoc received nothing for ${idleTimeoutMs} ms`, "TimeoutError")),
+      idleTimeoutMs
+    );
   };
+  stillReceiving();
+  try {
+    const response = await fetchImpl(url, { headers: { Accept: "application/octet-stream" }, signal: reading.signal });
+    if (!response.ok) {
+      await ((_a = response.body) == null ? void 0 : _a.cancel().catch(() => void 0));
+      throw new Error(`GET /ydoc answered ${response.status}`);
+    }
+    stillReceiving();
+    const body = await readBody({ response, onChunk: stillReceiving });
+    const decoded = decoding.readAny(decoding.createDecoder(body));
+    if (decoded === null || typeof decoded !== "object" || !(decoded.doc instanceof Uint8Array)) {
+      throw new Error("GET /ydoc answered a body without a document");
+    }
+    return {
+      // a copy: lib0 hands out a view into the body
+      update: new Uint8Array(decoded.doc),
+      answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,
+      bytes: body.byteLength
+    };
+  } catch (error) {
+    if (reading.signal.aborted && !(signal == null ? void 0 : signal.aborted)) throw reading.signal.reason;
+    throw error;
+  } finally {
+    if (idle !== null) clearTimeout(idle);
+    signal == null ? void 0 : signal.removeEventListener("abort", stop);
+  }
 }
 const MEMO_PREFIX = "keryx-initial-sync:";
 const INITIAL_SYNC_UNSUPPORTED_TTL_MS = 60 * 60 * 1e3;
@@ -90,6 +136,8 @@ function knownInitialSyncSupport({
   }
 }
 export {
+  HTTP_FIRST_READ_IDLE_TIMEOUT_MS,
+  HTTP_FIRST_READ_TIMEOUT_MS,
   INITIAL_SYNC_CAPABILITY_HEADER,
   INITIAL_SYNC_DIFF,
   INITIAL_SYNC_PARAM,

package/dist/keryx-http/src/initial-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"initial-sync.js","sources":["../../../../keryx-http/src/initial-sync.ts"],"sourcesContent":["/**\n * Opening a big room HTTP-first (Word at scale, 2026-11-02).\n *\n * A Keryx socket's initial sync step 2 is the whole document, sent as one frame that uWS deflates on\n * Keryx's event loop: 1.4-1.8 s for a 132 MiB Word room, during which no other room on that server\n * is served, then 17 MiB on the wire. A Keryx that carries the `@y/hub` patch's diffed initial sync\n * answers a socket that connects with `?initialSync=diff` with only what the client lacks past its\n * own sync step 1, and serves `GET /ydoc` compressed (zstd, brotli or gzip, as the browser names\n * them) from a kept copy. So a client opening a big room reads it over HTTP first - decoded by the\n * browser as it downloads - applies it as the server's state, and opens its socket asking for the\n * rest: usually just the delete set.\n *\n * A Keryx says it answers that way in its `GET /ydoc` answer to a browser\n * (`X-Keryx-Initial-Sync: diff`, exposed to cross-origin readers). A Keryx without the patch says\n * nothing: its document is then not used, the socket opens as before, and the origin is remembered\n * as one that does not answer, so the next open skips the read.\n */\n\nimport * as decoding from 'lib0/decoding';\n\n/** The socket query parameter, and its one value, that ask for a diffed initial sync. */\nexport const INITIAL_SYNC_PARAM = 'initialSync';\nexport const INITIAL_SYNC_DIFF = 'diff';\n\n/** The `GET /ydoc` response header with which a Keryx says it answers `?initialSync=diff`. */\nexport const INITIAL_SYNC_CAPABILITY_HEADER = 'x-keryx-initial-sync';\n\n/**\n * The `GET /ydoc` URL of the room a socket URL names: `wss://host/ws/<org>/<docId>` (or the\n * `/api/ws/v1/` spelling) becomes `https://host/api/ydoc/v1/<org>/<docId>?yauth=…&branch=…`. `null`\n * for a URL of any other shape.\n */\nexport function keryxRoomReadUrl({\n  wsUrl,\n  token,\n  branch,\n}: {\n  wsUrl: string;\n  token: string;\n  branch: string;\n}): string | null {\n  let parsed: URL;\n  try {\n    parsed = new URL(wsUrl);\n  } catch {\n    return null;\n  }\n  const scheme = parsed.protocol === 'wss:' ? 'https:' : parsed.protocol === 'ws:' ? 'http:' : null;\n  if (scheme === null) return null;\n  const match = /^(.*?)\\/(?:api\\/ws\\/v1|ws)\\/([^/]+)\\/([^/]+)\\/?$/.exec(parsed.pathname);\n  if (match === null) return null;\n  const [, prefix = '', org = '', docId = ''] = match;\n  const read = new URL(`${scheme}//${parsed.host}${prefix}/api/ydoc/v1/${org}/${docId}`);\n  read.searchParams.set('yauth', token);\n  read.searchParams.set('branch', branch);\n  return read.toString();\n}\n\n/** A room read over HTTP. */\nexport interface RoomReadOverHttp {\n  /** The room's state as one update (empty for a room never written). */\n  update: Uint8Array;\n  /** Keryx said it answers a socket's sync step 1 (`INITIAL_SYNC_CAPABILITY_HEADER`). */\n  answersSyncStep1: boolean;\n  /** The decoded body's size. */\n  bytes: number;\n}\n\n/**\n * Read a room over `GET /ydoc` (`url` from {@link keryxRoomReadUrl}). The runtime's `fetch` names\n * and decodes the content codings. Throws on a non-2xx answer or a body that is not a lib0 `{ doc }`.\n */\nexport async function readRoomOverHttp({\n  url,\n  signal,\n  fetchImpl = fetch,\n}: {\n  url: string;\n  signal?: AbortSignal;\n  fetchImpl?: typeof fetch;\n}): Promise<RoomReadOverHttp> {\n  const response = await fetchImpl(url, { headers: { Accept: 'application/octet-stream' }, signal });\n  if (!response.ok) {\n    await response.body?.cancel().catch(() => undefined);\n    throw new Error(`GET /ydoc answered ${response.status}`);\n  }\n  const body = new Uint8Array(await response.arrayBuffer());\n  const decoded = decoding.readAny(decoding.createDecoder(body)) as { doc?: unknown } | null;\n  if (decoded === null || typeof decoded !== 'object' || !(decoded.doc instanceof Uint8Array)) {\n    throw new Error('GET /ydoc answered a body without a document');\n  }\n  return {\n    // a copy: lib0 hands out a view into the body\n    update: new Uint8Array(decoded.doc),\n    answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,\n    bytes: body.byteLength,\n  };\n}\n\n/** Where {@link rememberInitialSyncSupport} keeps what it learned: `localStorage`'s surface. */\nexport interface InitialSyncSupportStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nconst MEMO_PREFIX = 'keryx-initial-sync:';\n/** A Keryx that answered without the header is asked again an hour later: it may have been upgraded. */\nexport const INITIAL_SYNC_UNSUPPORTED_TTL_MS = 60 * 60 * 1000;\n/** A Keryx that answers is believed for a week; one rolled back meanwhile just sends whole documents. */\nexport const INITIAL_SYNC_SUPPORTED_TTL_MS = 7 * 24 * 60 * 60 * 1000;\n\n/** The origin a socket URL connects to, as the memo keys it (`wss://host`). */\nexport function keryxOriginOf(wsUrl: string): string | null {\n  try {\n    const parsed = new URL(wsUrl);\n    return `${parsed.protocol}//${parsed.host}`;\n  } catch {\n    return null;\n  }\n}\n\n/** Remember whether the Keryx at `origin` answered with the capability header. */\nexport function rememberInitialSyncSupport({\n  storage,\n  origin,\n  supported,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  supported: boolean;\n  now?: number;\n}): void {\n  try {\n    storage?.setItem(`${MEMO_PREFIX}${origin}`, JSON.stringify({ supported, at: now }));\n  } catch {\n    // a full or refused storage only costs the next open a read\n  }\n}\n\n/**\n * What is known of the Keryx at `origin`: `true` (it answers a socket's sync step 1), `false` (it\n * did not, within the last hour) or `null` (not known: read it and see).\n */\nexport function knownInitialSyncSupport({\n  storage,\n  origin,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  now?: number;\n}): boolean | null {\n  let raw: string | null = null;\n  try {\n    raw = storage?.getItem(`${MEMO_PREFIX}${origin}`) ?? null;\n  } catch {\n    return null;\n  }\n  if (raw === null) return null;\n  try {\n    const memo = JSON.parse(raw) as { supported?: unknown; at?: unknown };\n    if (typeof memo.supported !== 'boolean' || typeof memo.at !== 'number') return null;\n    const ttl = memo.supported ? INITIAL_SYNC_SUPPORTED_TTL_MS : INITIAL_SYNC_UNSUPPORTED_TTL_MS;\n    return now - memo.at <= ttl ? memo.supported : null;\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":";AAqBO,MAAM,qBAAqB;AAC3B,MAAM,oBAAoB;AAG1B,MAAM,iCAAiC;AAOvC,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AACF,GAIkB;AAChB,MAAI;AACJ,MAAI;AACF,aAAS,IAAI,IAAI,KAAK;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,SAAS,OAAO,aAAa,SAAS,WAAW,OAAO,aAAa,QAAQ,UAAU;AAC7F,MAAI,WAAW,KAAM,QAAO;AAC5B,QAAM,QAAQ,mDAAmD,KAAK,OAAO,QAAQ;AACrF,MAAI,UAAU,KAAM,QAAO;AAC3B,QAAM,CAAA,EAAG,SAAS,IAAI,MAAM,IAAI,QAAQ,EAAE,IAAI;AAC9C,QAAM,OAAO,IAAI,IAAI,GAAG,MAAM,KAAK,OAAO,IAAI,GAAG,MAAM,gBAAgB,GAAG,IAAI,KAAK,EAAE;AACrF,OAAK,aAAa,IAAI,SAAS,KAAK;AACpC,OAAK,aAAa,IAAI,UAAU,MAAM;AACtC,SAAO,KAAK,SAAA;AACd;AAgBA,eAAsB,iBAAiB;AAAA,EACrC;AAAA,EACA;AAAA,EACA,YAAY;AACd,GAI8B;;AAC5B,QAAM,WAAW,MAAM,UAAU,KAAK,EAAE,SAAS,EAAE,QAAQ,8BAA8B,QAAQ;AACjG,MAAI,CAAC,SAAS,IAAI;AAChB,YAAM,cAAS,SAAT,mBAAe,SAAS,MAAM,MAAM;AAC1C,UAAM,IAAI,MAAM,sBAAsB,SAAS,MAAM,EAAE;AAAA,EACzD;AACA,QAAM,OAAO,IAAI,WAAW,MAAM,SAAS,aAAa;AACxD,QAAM,UAAU,SAAS,QAAQ,SAAS,cAAc,IAAI,CAAC;AAC7D,MAAI,YAAY,QAAQ,OAAO,YAAY,YAAY,EAAE,QAAQ,eAAe,aAAa;AAC3F,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,SAAO;AAAA;AAAA,IAEL,QAAQ,IAAI,WAAW,QAAQ,GAAG;AAAA,IAClC,kBAAkB,SAAS,QAAQ,IAAI,8BAA8B,MAAM;AAAA,IAC3E,OAAO,KAAK;AAAA,EAAA;AAEhB;AAQA,MAAM,cAAc;AAEb,MAAM,kCAAkC,KAAK,KAAK;AAElD,MAAM,gCAAgC,IAAI,KAAK,KAAK,KAAK;AAGzD,SAAS,cAAc,OAA8B;AAC1D,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,KAAK;AAC5B,WAAO,GAAG,OAAO,QAAQ,KAAK,OAAO,IAAI;AAAA,EAC3C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA,MAAM,KAAK,IAAA;AACb,GAKS;AACP,MAAI;AACF,uCAAS,QAAQ,GAAG,WAAW,GAAG,MAAM,IAAI,KAAK,UAAU,EAAE,WAAW,IAAI,IAAA,CAAK;AAAA,EACnF,QAAQ;AAAA,EAER;AACF;AAMO,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AAAA,EACA,MAAM,KAAK,IAAA;AACb,GAImB;AACjB,MAAI,MAAqB;AACzB,MAAI;AACF,WAAM,mCAAS,QAAQ,GAAG,WAAW,GAAG,MAAM,QAAO;AAAA,EACvD,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,KAAM,QAAO;AACzB,MAAI;AACF,UAAM,OAAO,KAAK,MAAM,GAAG;AAC3B,QAAI,OAAO,KAAK,cAAc,aAAa,OAAO,KAAK,OAAO,SAAU,QAAO;AAC/E,UAAM,MAAM,KAAK,YAAY,gCAAgC;AAC7D,WAAO,MAAM,KAAK,MAAM,MAAM,KAAK,YAAY;AAAA,EACjD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"initial-sync.js","sources":["../../../../keryx-http/src/initial-sync.ts"],"sourcesContent":["/**\n * Opening a big room HTTP-first (Word at scale, 2026-11-02).\n *\n * A Keryx socket's initial sync step 2 is the whole document, sent as one frame that uWS deflates on\n * Keryx's event loop: 1.4-1.8 s for a 132 MiB Word room, during which no other room on that server\n * is served, then 17 MiB on the wire. A Keryx that carries the `@y/hub` patch's diffed initial sync\n * answers a socket that connects with `?initialSync=diff` with only what the client lacks past its\n * own sync step 1, and serves `GET /ydoc` compressed (zstd, brotli or gzip, as the browser names\n * them) from a kept copy. So a client opening a big room reads it over HTTP first - decoded by the\n * browser as it downloads - applies it as the server's state, and opens its socket asking for the\n * rest: usually just the delete set.\n *\n * A Keryx says it answers that way in its `GET /ydoc` answer to a browser\n * (`X-Keryx-Initial-Sync: diff`, exposed to cross-origin readers). A Keryx without the patch says\n * nothing: its document is then not used, the socket opens as before, and the origin is remembered\n * as one that does not answer, so the next open skips the read.\n */\n\nimport * as decoding from 'lib0/decoding';\n\n/** The socket query parameter, and its one value, that ask for a diffed initial sync. */\nexport const INITIAL_SYNC_PARAM = 'initialSync';\nexport const INITIAL_SYNC_DIFF = 'diff';\n\n/** The `GET /ydoc` response header with which a Keryx says it answers `?initialSync=diff`. */\nexport const INITIAL_SYNC_CAPABILITY_HEADER = 'x-keryx-initial-sync';\n\n/**\n * Which sockets of a room that opens HTTP-first ask for a diffed initial sync, while Keryx is known\n * to answer it and the room holds no write Keryx has not echoed.\n *\n * - `every-socket` (Word documents): the socket after the room's read, every reconnect, and the\n *   first socket of a room opened from its local copy.\n * - `after-read` (decks): only the socket that follows the room's own read. A room opened from its\n *   local copy, and every reconnect, get Keryx's whole document, as a room that does not open\n *   HTTP-first does. Keryx diffs a room that is not one compacted row against its whole merged\n *   document on every socket that asks (the `@y/hub` patch's `diffForClient`). On a fast link that\n *   costs a deck reopened from its copy more than the whole document does (the Midas smoke's\n *   160-slide deck synced in 3.3 s, where the whole document took about 0.6 s).\n */\nexport type DiffedInitialSync = 'every-socket' | 'after-read';\n\n/**\n * The `GET /ydoc` URL of the room a socket URL names: `wss://host/ws/<org>/<docId>` (or the\n * `/api/ws/v1/` spelling) becomes `https://host/api/ydoc/v1/<org>/<docId>?yauth=…&branch=…`. `null`\n * for a URL of any other shape.\n */\nexport function keryxRoomReadUrl({\n  wsUrl,\n  token,\n  branch,\n}: {\n  wsUrl: string;\n  token: string;\n  branch: string;\n}): string | null {\n  let parsed: URL;\n  try {\n    parsed = new URL(wsUrl);\n  } catch {\n    return null;\n  }\n  const scheme = parsed.protocol === 'wss:' ? 'https:' : parsed.protocol === 'ws:' ? 'http:' : null;\n  if (scheme === null) return null;\n  const match = /^(.*?)\\/(?:api\\/ws\\/v1|ws)\\/([^/]+)\\/([^/]+)\\/?$/.exec(parsed.pathname);\n  if (match === null) return null;\n  const [, prefix = '', org = '', docId = ''] = match;\n  const read = new URL(`${scheme}//${parsed.host}${prefix}/api/ydoc/v1/${org}/${docId}`);\n  read.searchParams.set('yauth', token);\n  read.searchParams.set('branch', branch);\n  return read.toString();\n}\n\n/** A room read over HTTP. */\nexport interface RoomReadOverHttp {\n  /** The room's state as one update (empty for a room never written). */\n  update: Uint8Array;\n  /** Keryx said it answers a socket's sync step 1 (`INITIAL_SYNC_CAPABILITY_HEADER`). */\n  answersSyncStep1: boolean;\n  /** The decoded body's size. */\n  bytes: number;\n}\n\n/**\n * How long a room's HTTP-first read may receive nothing (no answer yet, or no byte of its body)\n * before the room gives it up and syncs over its socket instead: the minute every read was allowed\n * in all before, so no read is given up sooner than it was.\n */\nexport const HTTP_FIRST_READ_IDLE_TIMEOUT_MS = 60_000;\n\n/**\n * How long a room's HTTP-first read may take in all, however steadily its bytes come. A read still\n * downloading is otherwise never thrown away: the socket's whole-document sync it would fall back to\n * carries the same bytes, restarted from the first one on every reconnect (a large deck on a slow\n * link took 39 s to 550 s that way, `@athenaintel/decks`' `deck-open-watchdog`).\n */\nexport const HTTP_FIRST_READ_TIMEOUT_MS = 10 * 60_000;\n\n/** The body, read as it arrives: `onChunk` hears each piece. */\nasync function readBody({ response, onChunk }: { response: Response; onChunk: () => void }): Promise<Uint8Array> {\n  const stream = response.body;\n  if (stream === null) return new Uint8Array(await response.arrayBuffer());\n  const reader = stream.getReader();\n  const chunks: Uint8Array[] = [];\n  let length = 0;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n    length += value.byteLength;\n    onChunk();\n  }\n  const body = new Uint8Array(length);\n  let offset = 0;\n  for (const chunk of chunks) {\n    body.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return body;\n}\n\n/**\n * Read a room over `GET /ydoc` (`url` from {@link keryxRoomReadUrl}). The runtime's `fetch` names\n * and decodes the content codings. Throws on a non-2xx answer or a body that is not a lib0 `{ doc }`.\n * With `idleTimeoutMs`, a read that receives nothing for that long (no answer, or no byte of its\n * body) is given up with a `TimeoutError`; one whose bytes keep coming runs as long as they do.\n */\nexport async function readRoomOverHttp({\n  url,\n  signal,\n  fetchImpl = fetch,\n  idleTimeoutMs,\n}: {\n  url: string;\n  signal?: AbortSignal;\n  fetchImpl?: typeof fetch;\n  idleTimeoutMs?: number;\n}): Promise<RoomReadOverHttp> {\n  const reading = new AbortController();\n  const stop = () => reading.abort(signal?.reason);\n  if (signal?.aborted) stop();\n  else signal?.addEventListener('abort', stop, { once: true });\n  let idle: ReturnType<typeof setTimeout> | null = null;\n  const stillReceiving = () => {\n    if (idleTimeoutMs === undefined) return;\n    if (idle !== null) clearTimeout(idle);\n    idle = setTimeout(\n      () => reading.abort(new DOMException(`GET /ydoc received nothing for ${idleTimeoutMs} ms`, 'TimeoutError')),\n      idleTimeoutMs\n    );\n  };\n  stillReceiving();\n  try {\n    const response = await fetchImpl(url, { headers: { Accept: 'application/octet-stream' }, signal: reading.signal });\n    if (!response.ok) {\n      await response.body?.cancel().catch(() => undefined);\n      throw new Error(`GET /ydoc answered ${response.status}`);\n    }\n    stillReceiving();\n    const body = await readBody({ response, onChunk: stillReceiving });\n    const decoded = decoding.readAny(decoding.createDecoder(body)) as { doc?: unknown } | null;\n    if (decoded === null || typeof decoded !== 'object' || !(decoded.doc instanceof Uint8Array)) {\n      throw new Error('GET /ydoc answered a body without a document');\n    }\n    return {\n      // a copy: lib0 hands out a view into the body\n      update: new Uint8Array(decoded.doc),\n      answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,\n      bytes: body.byteLength,\n    };\n  } catch (error) {\n    // The idle timeout's own reason, whatever the runtime's fetch rejected the stopped read with\n    if (reading.signal.aborted && !signal?.aborted) throw reading.signal.reason;\n    throw error;\n  } finally {\n    if (idle !== null) clearTimeout(idle);\n    signal?.removeEventListener('abort', stop);\n  }\n}\n\n/** Where {@link rememberInitialSyncSupport} keeps what it learned: `localStorage`'s surface. */\nexport interface InitialSyncSupportStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nconst MEMO_PREFIX = 'keryx-initial-sync:';\n/** A Keryx that answered without the header is asked again an hour later: it may have been upgraded. */\nexport const INITIAL_SYNC_UNSUPPORTED_TTL_MS = 60 * 60 * 1000;\n/** A Keryx that answers is believed for a week; one rolled back meanwhile just sends whole documents. */\nexport const INITIAL_SYNC_SUPPORTED_TTL_MS = 7 * 24 * 60 * 60 * 1000;\n\n/** The origin a socket URL connects to, as the memo keys it (`wss://host`). */\nexport function keryxOriginOf(wsUrl: string): string | null {\n  try {\n    const parsed = new URL(wsUrl);\n    return `${parsed.protocol}//${parsed.host}`;\n  } catch {\n    return null;\n  }\n}\n\n/** Remember whether the Keryx at `origin` answered with the capability header. */\nexport function rememberInitialSyncSupport({\n  storage,\n  origin,\n  supported,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  supported: boolean;\n  now?: number;\n}): void {\n  try {\n    storage?.setItem(`${MEMO_PREFIX}${origin}`, JSON.stringify({ supported, at: now }));\n  } catch {\n    // a full or refused storage only costs the next open a read\n  }\n}\n\n/**\n * What is known of the Keryx at `origin`: `true` (it answers a socket's sync step 1), `false` (it\n * did not, within the last hour) or `null` (not known: read it and see).\n */\nexport function knownInitialSyncSupport({\n  storage,\n  origin,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  now?: number;\n}): boolean | null {\n  let raw: string | null = null;\n  try {\n    raw = storage?.getItem(`${MEMO_PREFIX}${origin}`) ?? null;\n  } catch {\n    return null;\n  }\n  if (raw === null) return null;\n  try {\n    const memo = JSON.parse(raw) as { supported?: unknown; at?: unknown };\n    if (typeof memo.supported !== 'boolean' || typeof memo.at !== 'number') return null;\n    const ttl = memo.supported ? INITIAL_SYNC_SUPPORTED_TTL_MS : INITIAL_SYNC_UNSUPPORTED_TTL_MS;\n    return now - memo.at <= ttl ? memo.supported : null;\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/keryx-http/src/own-awareness.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function publishOwnAwarenessOnly({
+  transport
+}) {
+  const send = transport._awarenessUpdateHandler;
+  if (typeof send !== "function") return;
+  const { awareness } = transport;
+  const ownOnly = (clientIds) => clientIds.filter((clientId) => clientId === awareness.clientID);
+  const sendOwn = ({ added, updated, removed }, origin) => {
+    const own = { added: ownOnly(added), updated: ownOnly(updated), removed: ownOnly(removed) };
+    if (own.added.length + own.updated.length + own.removed.length === 0) return;
+    send(own, origin);
+  };
+  awareness.off("update", send);
+  awareness.on("update", sendOwn);
+  transport._awarenessUpdateHandler = sendOwn;
+}
+exports.publishOwnAwarenessOnly = publishOwnAwarenessOnly;
+//# sourceMappingURL=own-awareness.cjs.map

package/dist/keryx-http/src/own-awareness.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-awareness.cjs","sources":["../../../../keryx-http/src/own-awareness.ts"],"sourcesContent":["/**\n * The awareness a Keryx room's socket sends: this client's own entry, never another client's.\n * Olympus's rooms (`KeryxYjsProviderV14`, and the workspace-awareness and user-notify rooms' bare\n * transport), `@athenaintel/react/collab`'s `connectGenericDoc` and the Office add-in's rooms put it\n * on every `@y/websocket` transport they open.\n *\n * `@y/websocket` sends, for every awareness `update` event, the state of every client the event\n * names (`_awarenessUpdateHandler`), whatever caused it. Most events name other clients: each peer\n * state the transport applies from Keryx (a peer's 15 s renewal, and the whole roster Keryx sends a\n * socket as it opens) and each peer the awareness drops on its own 30 s timer (a `null` entry). So\n * every client sent every peer's entry straight back to Keryx, which already holds and relays it:\n *   - a workspace-awareness socket's token attests the one client id it may publish, and Keryx drops\n *     every other entry it sends (`foreign_client_id`, `keryx/src/presence-ingress.ts`): in a room\n *     where n tabs read the roster that is n × (n − 1) entries every 15 seconds, and every tab's whole\n *     roster again each time the sockets reconnect, a Keryx roll included;\n *   - a document room drops a re-sent agent slot (`agent_from_browser_token`) and a re-sent departure\n *     (`foreign_departure`), and stores and relays every other re-sent entry a second time.\n *\n * What still goes out is everything about this client: its state when it changes, its 15 s renewal,\n * its departure (a `setLocalState(null)`; `disconnect()` sends its own), and its answer to a peer that\n * marked it gone (the awareness raises its own clock and the event names it). A peer's departure is\n * this client's business alone: each client drops a silent peer on its own timer, and Keryx\n * announces the departure of every client a closed socket published. Keryx never asks a socket for\n * its awareness (`messageQueryAwareness`), whose answer `@y/websocket` would build from every state\n * it holds.\n */\nimport type { Awareness } from '@y/protocols/awareness';\n\n/** The clients an awareness `update` event names. */\nexport interface AwarenessChanges {\n  added: number[];\n  updated: number[];\n  removed: number[];\n}\n\n/** The part of `@y/websocket`'s `WebsocketProvider` that sends awareness. */\nexport interface AwarenessSendingTransport {\n  readonly awareness: Awareness;\n  /**\n   * Sends the clients an awareness `update` event names; the transport listens with it from its\n   * constructor and stops in `destroy()`.\n   */\n  _awarenessUpdateHandler: (changes: AwarenessChanges, origin: unknown) => void;\n}\n\n/**\n * Has `transport` send only its own client's awareness entry: every `update` event reaches the\n * transport's sender narrowed to this client, and none that names only other clients does. Call it\n * as the transport is made, before its socket opens.\n */\nexport function publishOwnAwarenessOnly({\n  transport,\n}: {\n  transport: AwarenessSendingTransport;\n}): void {\n  const send = transport._awarenessUpdateHandler;\n  // No sender (a test's stand-in for `@y/websocket`): nothing leaves to narrow. Each transport's\n  // suite runs the real one, so a release that renamed the sender fails there.\n  if (typeof send !== 'function') return;\n  const { awareness } = transport;\n  const ownOnly = (clientIds: number[]): number[] =>\n    clientIds.filter((clientId) => clientId === awareness.clientID);\n  const sendOwn = ({ added, updated, removed }: AwarenessChanges, origin: unknown): void => {\n    const own = { added: ownOnly(added), updated: ownOnly(updated), removed: ownOnly(removed) };\n    if (own.added.length + own.updated.length + own.removed.length === 0) return;\n    send(own, origin);\n  };\n  awareness.off('update', send);\n  awareness.on('update', sendOwn);\n  // `destroy()` stops the listener this field holds.\n  transport._awarenessUpdateHandler = sendOwn;\n}\n"],"names":[],"mappings":";;AAkDO,SAAS,wBAAwB;AAAA,EACtC;AACF,GAES;AACP,QAAM,OAAO,UAAU;AAGvB,MAAI,OAAO,SAAS,WAAY;AAChC,QAAM,EAAE,cAAc;AACtB,QAAM,UAAU,CAAC,cACf,UAAU,OAAO,CAAC,aAAa,aAAa,UAAU,QAAQ;AAChE,QAAM,UAAU,CAAC,EAAE,OAAO,SAAS,QAAA,GAA6B,WAA0B;AACxF,UAAM,MAAM,EAAE,OAAO,QAAQ,KAAK,GAAG,SAAS,QAAQ,OAAO,GAAG,SAAS,QAAQ,OAAO,EAAA;AACxF,QAAI,IAAI,MAAM,SAAS,IAAI,QAAQ,SAAS,IAAI,QAAQ,WAAW,EAAG;AACtE,SAAK,KAAK,MAAM;AAAA,EAClB;AACA,YAAU,IAAI,UAAU,IAAI;AAC5B,YAAU,GAAG,UAAU,OAAO;AAE9B,YAAU,0BAA0B;AACtC;;"}

package/dist/keryx-http/src/own-awareness.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The awareness a Keryx room's socket sends: this client's own entry, never another client's.
+ * Olympus's rooms (`KeryxYjsProviderV14`, and the workspace-awareness and user-notify rooms' bare
+ * transport), `@athenaintel/react/collab`'s `connectGenericDoc` and the Office add-in's rooms put it
+ * on every `@y/websocket` transport they open.
+ *
+ * `@y/websocket` sends, for every awareness `update` event, the state of every client the event
+ * names (`_awarenessUpdateHandler`), whatever caused it. Most events name other clients: each peer
+ * state the transport applies from Keryx (a peer's 15 s renewal, and the whole roster Keryx sends a
+ * socket as it opens) and each peer the awareness drops on its own 30 s timer (a `null` entry). So
+ * every client sent every peer's entry straight back to Keryx, which already holds and relays it:
+ *   - a workspace-awareness socket's token attests the one client id it may publish, and Keryx drops
+ *     every other entry it sends (`foreign_client_id`, `keryx/src/presence-ingress.ts`): in a room
+ *     where n tabs read the roster that is n × (n − 1) entries every 15 seconds, and every tab's whole
+ *     roster again each time the sockets reconnect, a Keryx roll included;
+ *   - a document room drops a re-sent agent slot (`agent_from_browser_token`) and a re-sent departure
+ *     (`foreign_departure`), and stores and relays every other re-sent entry a second time.
+ *
+ * What still goes out is everything about this client: its state when it changes, its 15 s renewal,
+ * its departure (a `setLocalState(null)`; `disconnect()` sends its own), and its answer to a peer that
+ * marked it gone (the awareness raises its own clock and the event names it). A peer's departure is
+ * this client's business alone: each client drops a silent peer on its own timer, and Keryx
+ * announces the departure of every client a closed socket published. Keryx never asks a socket for
+ * its awareness (`messageQueryAwareness`), whose answer `@y/websocket` would build from every state
+ * it holds.
+ */
+import type { Awareness } from '@y/protocols/awareness';
+/** The clients an awareness `update` event names. */
+export interface AwarenessChanges {
+    added: number[];
+    updated: number[];
+    removed: number[];
+}
+/** The part of `@y/websocket`'s `WebsocketProvider` that sends awareness. */
+export interface AwarenessSendingTransport {
+    readonly awareness: Awareness;
+    /**
+     * Sends the clients an awareness `update` event names; the transport listens with it from its
+     * constructor and stops in `destroy()`.
+     */
+    _awarenessUpdateHandler: (changes: AwarenessChanges, origin: unknown) => void;
+}
+/**
+ * Has `transport` send only its own client's awareness entry: every `update` event reaches the
+ * transport's sender narrowed to this client, and none that names only other clients does. Call it
+ * as the transport is made, before its socket opens.
+ */
+export declare function publishOwnAwarenessOnly({ transport, }: {
+    transport: AwarenessSendingTransport;
+}): void;

package/dist/keryx-http/src/own-awareness.js

@@ -0,0 +1,20 @@
+function publishOwnAwarenessOnly({
+  transport
+}) {
+  const send = transport._awarenessUpdateHandler;
+  if (typeof send !== "function") return;
+  const { awareness } = transport;
+  const ownOnly = (clientIds) => clientIds.filter((clientId) => clientId === awareness.clientID);
+  const sendOwn = ({ added, updated, removed }, origin) => {
+    const own = { added: ownOnly(added), updated: ownOnly(updated), removed: ownOnly(removed) };
+    if (own.added.length + own.updated.length + own.removed.length === 0) return;
+    send(own, origin);
+  };
+  awareness.off("update", send);
+  awareness.on("update", sendOwn);
+  transport._awarenessUpdateHandler = sendOwn;
+}
+export {
+  publishOwnAwarenessOnly
+};
+//# sourceMappingURL=own-awareness.js.map

package/dist/keryx-http/src/own-awareness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-awareness.js","sources":["../../../../keryx-http/src/own-awareness.ts"],"sourcesContent":["/**\n * The awareness a Keryx room's socket sends: this client's own entry, never another client's.\n * Olympus's rooms (`KeryxYjsProviderV14`, and the workspace-awareness and user-notify rooms' bare\n * transport), `@athenaintel/react/collab`'s `connectGenericDoc` and the Office add-in's rooms put it\n * on every `@y/websocket` transport they open.\n *\n * `@y/websocket` sends, for every awareness `update` event, the state of every client the event\n * names (`_awarenessUpdateHandler`), whatever caused it. Most events name other clients: each peer\n * state the transport applies from Keryx (a peer's 15 s renewal, and the whole roster Keryx sends a\n * socket as it opens) and each peer the awareness drops on its own 30 s timer (a `null` entry). So\n * every client sent every peer's entry straight back to Keryx, which already holds and relays it:\n *   - a workspace-awareness socket's token attests the one client id it may publish, and Keryx drops\n *     every other entry it sends (`foreign_client_id`, `keryx/src/presence-ingress.ts`): in a room\n *     where n tabs read the roster that is n × (n − 1) entries every 15 seconds, and every tab's whole\n *     roster again each time the sockets reconnect, a Keryx roll included;\n *   - a document room drops a re-sent agent slot (`agent_from_browser_token`) and a re-sent departure\n *     (`foreign_departure`), and stores and relays every other re-sent entry a second time.\n *\n * What still goes out is everything about this client: its state when it changes, its 15 s renewal,\n * its departure (a `setLocalState(null)`; `disconnect()` sends its own), and its answer to a peer that\n * marked it gone (the awareness raises its own clock and the event names it). A peer's departure is\n * this client's business alone: each client drops a silent peer on its own timer, and Keryx\n * announces the departure of every client a closed socket published. Keryx never asks a socket for\n * its awareness (`messageQueryAwareness`), whose answer `@y/websocket` would build from every state\n * it holds.\n */\nimport type { Awareness } from '@y/protocols/awareness';\n\n/** The clients an awareness `update` event names. */\nexport interface AwarenessChanges {\n  added: number[];\n  updated: number[];\n  removed: number[];\n}\n\n/** The part of `@y/websocket`'s `WebsocketProvider` that sends awareness. */\nexport interface AwarenessSendingTransport {\n  readonly awareness: Awareness;\n  /**\n   * Sends the clients an awareness `update` event names; the transport listens with it from its\n   * constructor and stops in `destroy()`.\n   */\n  _awarenessUpdateHandler: (changes: AwarenessChanges, origin: unknown) => void;\n}\n\n/**\n * Has `transport` send only its own client's awareness entry: every `update` event reaches the\n * transport's sender narrowed to this client, and none that names only other clients does. Call it\n * as the transport is made, before its socket opens.\n */\nexport function publishOwnAwarenessOnly({\n  transport,\n}: {\n  transport: AwarenessSendingTransport;\n}): void {\n  const send = transport._awarenessUpdateHandler;\n  // No sender (a test's stand-in for `@y/websocket`): nothing leaves to narrow. Each transport's\n  // suite runs the real one, so a release that renamed the sender fails there.\n  if (typeof send !== 'function') return;\n  const { awareness } = transport;\n  const ownOnly = (clientIds: number[]): number[] =>\n    clientIds.filter((clientId) => clientId === awareness.clientID);\n  const sendOwn = ({ added, updated, removed }: AwarenessChanges, origin: unknown): void => {\n    const own = { added: ownOnly(added), updated: ownOnly(updated), removed: ownOnly(removed) };\n    if (own.added.length + own.updated.length + own.removed.length === 0) return;\n    send(own, origin);\n  };\n  awareness.off('update', send);\n  awareness.on('update', sendOwn);\n  // `destroy()` stops the listener this field holds.\n  transport._awarenessUpdateHandler = sendOwn;\n}\n"],"names":[],"mappings":"AAkDO,SAAS,wBAAwB;AAAA,EACtC;AACF,GAES;AACP,QAAM,OAAO,UAAU;AAGvB,MAAI,OAAO,SAAS,WAAY;AAChC,QAAM,EAAE,cAAc;AACtB,QAAM,UAAU,CAAC,cACf,UAAU,OAAO,CAAC,aAAa,aAAa,UAAU,QAAQ;AAChE,QAAM,UAAU,CAAC,EAAE,OAAO,SAAS,QAAA,GAA6B,WAA0B;AACxF,UAAM,MAAM,EAAE,OAAO,QAAQ,KAAK,GAAG,SAAS,QAAQ,OAAO,GAAG,SAAS,QAAQ,OAAO,EAAA;AACxF,QAAI,IAAI,MAAM,SAAS,IAAI,QAAQ,SAAS,IAAI,QAAQ,WAAW,EAAG;AACtE,SAAK,KAAK,MAAM;AAAA,EAClB;AACA,YAAU,IAAI,UAAU,IAAI;AAC5B,YAAU,GAAG,UAAU,OAAO;AAE9B,YAAU,0BAA0B;AACtC;"}

package/dist/keryx-http/src/update-attributions.cjs

@@ -11,6 +11,27 @@ function docScopes() {
   const host = globalThis;
   return host[DOC_SCOPES] ?? (host[DOC_SCOPES] = /* @__PURE__ */ new WeakMap());
 }
+const TRANSACTION_MARKS = Symbol.for("@athenaintel/keryx-http/update-attribution-transactions");
+function transactionMarks() {
+  const host = globalThis;
+  return host[TRANSACTION_MARKS] ?? (host[TRANSACTION_MARKS] = { marked: /* @__PURE__ */ new WeakMap(), emitting: /* @__PURE__ */ new WeakMap(), followed: /* @__PURE__ */ new WeakSet() });
+}
+function hasTransactionEvents(doc) {
+  const events = doc;
+  return typeof events.on === "function" && typeof events.off === "function";
+}
+function markTransactionsBegun(doc, attributions) {
+  if (!hasTransactionEvents(doc)) return null;
+  const marks = transactionMarks();
+  if (!marks.followed.has(doc)) {
+    marks.followed.add(doc);
+    doc.on("afterTransactionCleanup", (transaction) => marks.emitting.set(doc, transaction));
+    doc.on("afterAllTransactions", () => marks.emitting.delete(doc));
+  }
+  const mark = (transaction) => marks.marked.set(transaction, attributions);
+  doc.on("beforeTransaction", mark);
+  return () => doc.off("beforeTransaction", mark);
+}
 function runWithDocUpdateAttributions({
   doc,
   attributions,
@@ -19,15 +40,19 @@ function runWithDocUpdateAttributions({
   const scopes = docScopes();
   const outer = scopes.get(doc);
   scopes.set(doc, attributions);
+  const stopMarking = markTransactionsBegun(doc, attributions);
   try {
     return run();
   } finally {
+    stopMarking == null ? void 0 : stopMarking();
     if (outer === void 0) scopes.delete(doc);
     else scopes.set(doc, outer);
   }
 }
 function docUpdateAttributions(doc) {
-  return docScopes().get(doc);
+  const marks = transactionMarks();
+  const emitting = marks.emitting.get(doc);
+  return (emitting === void 0 ? void 0 : marks.marked.get(emitting)) ?? docScopes().get(doc);
 }
 function readVarUint({
   bytes,

package/dist/keryx-http/src/update-attributions.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"update-attributions.cjs","sources":["../../../../keryx-http/src/update-attributions.ts"],"sourcesContent":["/**\n * Attributions one Keryx socket update carries of its own.\n *\n * A Keryx connection's attributions are fixed when its socket opens, so every update a client\n * sends is attributed to the person whose client it is. A write the client makes on its own (the\n * sheet leader re-issuing `=AOP` formulas or re-pushing `=IMPORTRANGE` values, a restored result,\n * an editor binding re-keying what an older binding stored) read as that person's edit and woke\n * \"people only\" subscriptions. Keryx reads a trailer after the update in a sync update message\n * (`readUpdateAttributions` in `patches/@y%2Fhub@0.10.1.patch`): `varUint(1)`, `varUint(n)`, then\n * `n` pairs of `varString` key and value. It accepts only `origin: background`, which it counts as\n * system work (`actorOf` in `keryx/src/compaction-activity.ts`), and the pairs that name a Quick\n * Edit step (`@athenaintel/keryx-http/quick-edit`: `session_id`/`run_kind` on the apply,\n * `quick_edit_undo`/`quick_edit_redo` with `quick_edit_op` on an undo or redo), each value in\n * exactly its shape. A Keryx without that hunk reads the update and ignores the bytes after it, so\n * a trailer never costs an update; a pair it does not allow is dropped and the rest kept.\n *\n * A writer marks its writes by making them inside {@link runWithDocUpdateAttributions} for the\n * doc; the transport's socket ({@link attributingWebSocket}) appends the trailer to each sync\n * update it sends while that scope is open. Both Keryx transports wrap their sockets with it:\n * Olympus's rooms (`KeryxYjsProviderV14`) and `@athenaintel/react/collab`'s `connectGenericDoc`\n * (Midas, the phone's editor page). y-websocket sends a local update from inside the doc's\n * `update` event, which fires inside the write itself, so the trailer always rides on the update\n * the scope wrote. A write made while the socket is closed is not sent then: it reaches Keryx in\n * the reconnect's sync step 2, which can carry no trailer. A transport that hands its socket the\n * room's {@link UnconfirmedAttributedWrites} (`@athenaintel/keryx-http/unconfirmed-update-attributions`)\n * sends each such write ahead of that sync step 2 as its own marked update; without one it stays\n * the person's.\n */\n\n/** One custom attribution, as Keryx stores it on the items an update wrote. */\nexport interface UpdateAttribution {\n  k: string;\n  v: string;\n}\n\n/** The pair a housekeeping write carries; Agora and Keryx spell it the same way. */\nexport const BACKGROUND_UPDATE_ATTRIBUTIONS: readonly UpdateAttribution[] = [\n  { k: 'origin', v: 'background' },\n];\n\n/** The trailer format Keryx reads (`updateAttributionsTrailerV1`). */\nexport const UPDATE_ATTRIBUTIONS_TRAILER_V1 = 1;\n\n/** y-protocols: a sync message, and its update sub-type. */\nconst MESSAGE_SYNC = 0;\nconst MESSAGE_SYNC_UPDATE = 2;\n\n/**\n * The open scopes live on `globalThis`, not in module scope, because two copies of this module can\n * run in one page: `@athenaintel/react` bundles it into its dist (this package is private, so the\n * published SDK must inline it) while a host may import it from this package. A scope a writer\n * opens through one copy must be the one the transport's socket reads through the other.\n */\nconst DOC_SCOPES = Symbol.for('@athenaintel/keryx-http/update-attribution-scopes');\n\ntype DocScopesHost = typeof globalThis & {\n  [DOC_SCOPES]?: WeakMap<object, readonly UpdateAttribution[]>;\n};\n\n// process-local: browser-only scopes, each keyed by the doc it guards and cleared in the same synchronous call that set it\nfunction docScopes(): WeakMap<object, readonly UpdateAttribution[]> {\n  const host = globalThis as DocScopesHost;\n  return (host[DOC_SCOPES] ??= new WeakMap());\n}\n\n/**\n * Run `run` with every update it writes into `doc` marked with `attributions`. Synchronous only:\n * the scope ends when `run` returns. Nested scopes restore the outer one.\n */\nexport function runWithDocUpdateAttributions<T>({\n  doc,\n  attributions,\n  run,\n}: {\n  doc: object;\n  attributions: readonly UpdateAttribution[];\n  run: () => T;\n}): T {\n  const scopes = docScopes();\n  const outer = scopes.get(doc);\n  scopes.set(doc, attributions);\n  try {\n    return run();\n  } finally {\n    if (outer === undefined) scopes.delete(doc);\n    else scopes.set(doc, outer);\n  }\n}\n\n/** The attributions the update being written into `doc` right now carries, if any. */\nexport function docUpdateAttributions(doc: object): readonly UpdateAttribution[] | undefined {\n  return docScopes().get(doc);\n}\n\n/** The lib0 varUint at `start` in `bytes` and where the next field begins; `null` past the end. */\nexport function readVarUint({\n  bytes,\n  start,\n}: {\n  bytes: Uint8Array;\n  start: number;\n}): { value: number; next: number } | null {\n  let value = 0;\n  let multiplier = 1;\n  for (let pos = start; pos < bytes.length; pos += 1) {\n    const byte = bytes[pos];\n    if (byte === undefined) return null;\n    value += (byte & 0x7f) * multiplier;\n    if (byte < 0x80) return { value, next: pos + 1 };\n    multiplier *= 0x80;\n    if (multiplier > Number.MAX_SAFE_INTEGER) return null;\n  }\n  return null;\n}\n\n/** Append `value` to `out` as a lib0 varUint. */\nexport function writeVarUint({ out, value }: { out: number[]; value: number }): void {\n  let rest = value;\n  while (rest > 0x7f) {\n    out.push(0x80 | (rest % 0x80));\n    rest = Math.floor(rest / 0x80);\n  }\n  out.push(rest);\n}\n\n/** Exactly one sync update message, with nothing after the update. */\nfunction isBareSyncUpdate(message: Uint8Array): boolean {\n  const type = readVarUint({ bytes: message, start: 0 });\n  if (type?.value !== MESSAGE_SYNC) return false;\n  const syncType = readVarUint({ bytes: message, start: type.next });\n  if (syncType?.value !== MESSAGE_SYNC_UPDATE) return false;\n  const length = readVarUint({ bytes: message, start: syncType.next });\n  return length !== null && length.next + length.value === message.length;\n}\n\n/**\n * `message` with the trailer for `attributions` appended, when it is a bare sync update message;\n * any other message (sync step 1 or 2, awareness, one that already ends in a trailer) is returned\n * as it is.\n */\nexport function withUpdateAttributionsTrailer({\n  message,\n  attributions,\n}: {\n  message: Uint8Array;\n  attributions: readonly UpdateAttribution[];\n}): Uint8Array {\n  if (attributions.length === 0 || !isBareSyncUpdate(message)) return message;\n  const trailer: number[] = [];\n  writeVarUint({ out: trailer, value: UPDATE_ATTRIBUTIONS_TRAILER_V1 });\n  writeVarUint({ out: trailer, value: attributions.length });\n  const utf8 = new TextEncoder();\n  for (const { k, v } of attributions) {\n    for (const text of [k, v]) {\n      const bytes = utf8.encode(text);\n      writeVarUint({ out: trailer, value: bytes.length });\n      for (const byte of bytes) trailer.push(byte);\n    }\n  }\n  const out = new Uint8Array(message.length + trailer.length);\n  out.set(message, 0);\n  out.set(trailer, message.length);\n  return out;\n}\n\n/** What {@link attributingWebSocket} needs of a socket: the `send` y-websocket writes frames with. */\nexport interface SendingSocket {\n  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;\n}\n\n/** One socket of a room, as the room's attributed writes Keryx has not acknowledged see it. */\nexport interface AttributedWritesSocket {\n  /** Keryx sent `frame` on the socket: what it carries, Keryx holds. */\n  received(frame: Uint8Array): void;\n  /** The socket sends `frame` (now, or once Keryx has sent what it holds; see the implementation). */\n  send(frame: Uint8Array): void;\n}\n\n/**\n * The room's attributed writes Keryx has not acknowledged yet, as its sockets see them\n * (`UnconfirmedUpdateAttributions` in `@athenaintel/keryx-http/unconfirmed-update-attributions`).\n */\nexport interface UnconfirmedAttributedWrites {\n  /**\n   * A socket opened, sending through `send`. `hears`: the socket hands it every frame Keryx sends\n   * (`received`), ahead of the transport.\n   */\n  connect(params: { send: (frame: Uint8Array) => void; hears: boolean }): AttributedWritesSocket;\n}\n\n/** The bytes of a binary frame a socket received, or `null` for one that is not (a string, a `Blob`). */\nfunction receivedBytes(data: unknown): Uint8Array | null {\n  if (data instanceof ArrayBuffer) return new Uint8Array(data);\n  if (ArrayBuffer.isView(data))\n    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n  return null;\n}\n\n/**\n * Hands `onFrame` every binary frame `socket` receives; whether it can. A listener added before\n * y-websocket sets `onmessage` runs ahead of it. A socket without `addEventListener` hands nothing.\n */\nfunction listenToFrames({\n  socket,\n  onFrame,\n}: {\n  socket: SendingSocket;\n  onFrame: (frame: Uint8Array) => void;\n}): boolean {\n  if (!('addEventListener' in socket) || typeof socket.addEventListener !== 'function') {\n    return false;\n  }\n  socket.addEventListener('message', (event: { data?: unknown }) => {\n    const frame = receivedBytes(event.data);\n    if (frame) onFrame(frame);\n  });\n  return true;\n}\n\n/**\n * `Base` with `send` appending the trailer of `attributionsFor()` to each sync update it sends.\n * With the room's `unconfirmed` attributed writes, each socket also tells them every frame Keryx\n * sends and sends its frames through them, so a sync step 2 goes out behind the kept writes it\n * carries. A `Proxy` keeps the constructor's statics and type, so it drops in as y-websocket's\n * `WebSocketPolyfill`.\n */\nexport function attributingWebSocket<TBase extends new (...args: never[]) => SendingSocket>({\n  Base,\n  attributionsFor,\n  unconfirmed,\n}: {\n  Base: TBase;\n  attributionsFor: () => readonly UpdateAttribution[] | undefined;\n  unconfirmed?: UnconfirmedAttributedWrites;\n}): TBase {\n  // No WebSocket where the provider is built (server render, a test without one): nothing to wrap,\n  // and the transport fails at connect as it always did.\n  if (typeof Base !== 'function') return Base;\n  return new Proxy(Base, {\n    construct(target, args) {\n      const socket: SendingSocket = Reflect.construct(target, args);\n      const send = socket.send.bind(socket);\n      let connection: AttributedWritesSocket | null = null;\n      if (unconfirmed) {\n        const hears = listenToFrames({ socket, onFrame: (frame) => connection?.received(frame) });\n        connection = unconfirmed.connect({ send, hears });\n      }\n      socket.send = (data) => {\n        if (!(data instanceof Uint8Array)) {\n          send(data);\n          return;\n        }\n        const attributions = attributionsFor();\n        const message = attributions\n          ? withUpdateAttributionsTrailer({ message: data, attributions })\n          : data;\n        if (connection) connection.send(message);\n        else send(message);\n      };\n      return socket;\n    },\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-attributions.cjs","sources":["../../../../keryx-http/src/update-attributions.ts"],"sourcesContent":["/**\n * Attributions one Keryx socket update carries of its own.\n *\n * A Keryx connection's attributions are fixed when its socket opens, so every update a client\n * sends is attributed to the person whose client it is. A write the client makes on its own (the\n * sheet leader re-issuing `=AOP` formulas or re-pushing `=IMPORTRANGE` values, a restored result,\n * an editor binding re-keying what an older binding stored) read as that person's edit and woke\n * \"people only\" subscriptions. Keryx reads a trailer after the update in a sync update message\n * (`readUpdateAttributions` in `patches/@y%2Fhub@0.10.1.patch`): `varUint(1)`, `varUint(n)`, then\n * `n` pairs of `varString` key and value. It accepts only `origin: background`, which it counts as\n * system work (`actorOf` in `keryx/src/compaction-activity.ts`), and the pairs that name a Quick\n * Edit step (`@athenaintel/keryx-http/quick-edit`: `session_id`/`run_kind` on the apply,\n * `quick_edit_undo`/`quick_edit_redo` with `quick_edit_op` on an undo or redo), each value in\n * exactly its shape. A Keryx without that hunk reads the update and ignores the bytes after it, so\n * a trailer never costs an update; a pair it does not allow is dropped and the rest kept.\n *\n * A writer marks its writes by making them inside {@link runWithDocUpdateAttributions} for the\n * doc; the transport's socket ({@link attributingWebSocket}) appends the trailer to each sync\n * update it sends while that scope is open. Both Keryx transports wrap their sockets with it:\n * Olympus's rooms (`KeryxYjsProviderV14`) and `@athenaintel/react/collab`'s `connectGenericDoc`\n * (Midas, the phone's editor page). y-websocket sends a local update from inside the doc's\n * `update` event, which fires inside the write itself, so the trailer always rides on the update\n * the scope wrote. A write made while the socket is closed is not sent then: it reaches Keryx in\n * the reconnect's sync step 2, which can carry no trailer. A transport that hands its socket the\n * room's {@link UnconfirmedAttributedWrites} (`@athenaintel/keryx-http/unconfirmed-update-attributions`)\n * sends each such write ahead of that sync step 2 as its own marked update; without one it stays\n * the person's.\n */\n\n/** One custom attribution, as Keryx stores it on the items an update wrote. */\nexport interface UpdateAttribution {\n  k: string;\n  v: string;\n}\n\n/** The pair a housekeeping write carries; Agora and Keryx spell it the same way. */\nexport const BACKGROUND_UPDATE_ATTRIBUTIONS: readonly UpdateAttribution[] = [\n  { k: 'origin', v: 'background' },\n];\n\n/** The trailer format Keryx reads (`updateAttributionsTrailerV1`). */\nexport const UPDATE_ATTRIBUTIONS_TRAILER_V1 = 1;\n\n/** y-protocols: a sync message, and its update sub-type. */\nconst MESSAGE_SYNC = 0;\nconst MESSAGE_SYNC_UPDATE = 2;\n\n/**\n * The open scopes live on `globalThis`, not in module scope, because two copies of this module can\n * run in one page: `@athenaintel/react` bundles it into its dist (this package is private, so the\n * published SDK must inline it) while a host may import it from this package. A scope a writer\n * opens through one copy must be the one the transport's socket reads through the other.\n */\nconst DOC_SCOPES = Symbol.for('@athenaintel/keryx-http/update-attribution-scopes');\n\ntype DocScopesHost = typeof globalThis & {\n  [DOC_SCOPES]?: WeakMap<object, readonly UpdateAttribution[]>;\n};\n\n// process-local: browser-only scopes, each keyed by the doc it guards and cleared in the same synchronous call that set it\nfunction docScopes(): WeakMap<object, readonly UpdateAttribution[]> {\n  const host = globalThis as DocScopesHost;\n  return (host[DOC_SCOPES] ??= new WeakMap());\n}\n\n/**\n * The transactions a scope began, by the attributions their update carries, and the transaction\n * whose update each doc is emitting now: on `globalThis` for the same reason as {@link DOC_SCOPES}.\n */\nconst TRANSACTION_MARKS = Symbol.for('@athenaintel/keryx-http/update-attribution-transactions');\n\ninterface TransactionMarks {\n  /** A transaction a scope began, by the attributions its update carries. */\n  readonly marked: WeakMap<object, readonly UpdateAttribution[]>;\n  /** The transaction whose update each doc emits now (from its cleanup to the end of the drain). */\n  readonly emitting: WeakMap<object, object>;\n  /** The docs whose emitting transaction is followed. */\n  readonly followed: WeakSet<object>;\n}\n\ntype TransactionMarksHost = typeof globalThis & { [TRANSACTION_MARKS]?: TransactionMarks };\n\n// process-local: browser-only, keyed weakly by the doc and its transactions, which drop them with them\nfunction transactionMarks(): TransactionMarks {\n  const host = globalThis as TransactionMarksHost;\n  return (host[TRANSACTION_MARKS] ??= { marked: new WeakMap(), emitting: new WeakMap(), followed: new WeakSet() });\n}\n\n/** What a scope listens to on a doc: Yjs 13's and `@y/y`'s `on`/`off` alike. */\ninterface TransactionEvents {\n  on(name: string, listener: (transaction: object) => void): void;\n  off(name: string, listener: (transaction: object) => void): void;\n}\n\nfunction hasTransactionEvents(doc: object): doc is TransactionEvents {\n  const events = doc as Partial<TransactionEvents>;\n  return typeof events.on === 'function' && typeof events.off === 'function';\n}\n\n/**\n * Mark every transaction of `doc` that begins until the returned function is called with\n * `attributions`, and follow which transaction's update `doc` emits. Yjs emits a transaction's\n * update right after its `afterTransactionCleanup`, and sends none outside a drain.\n */\nfunction markTransactionsBegun(doc: object, attributions: readonly UpdateAttribution[]): (() => void) | null {\n  if (!hasTransactionEvents(doc)) return null;\n  const marks = transactionMarks();\n  if (!marks.followed.has(doc)) {\n    marks.followed.add(doc);\n    doc.on('afterTransactionCleanup', (transaction) => marks.emitting.set(doc, transaction));\n    doc.on('afterAllTransactions', () => marks.emitting.delete(doc));\n  }\n  const mark = (transaction: object) => marks.marked.set(transaction, attributions);\n  doc.on('beforeTransaction', mark);\n  return () => doc.off('beforeTransaction', mark);\n}\n\n/**\n * Run `run` with every update it writes into `doc` marked with `attributions`. Synchronous only:\n * the scope ends when `run` returns. Nested scopes restore the outer one.\n *\n * A transaction `run` begins while another transaction's events are delivered (an editor binding\n * writing the fix a remote change needs, from inside that change's observers) is queued by Yjs, and\n * its update is emitted, and sent, after `run` returns. Such a transaction is marked as it begins,\n * so its update carries `attributions` too: a housekeeping write never goes out as the person's.\n */\nexport function runWithDocUpdateAttributions<T>({\n  doc,\n  attributions,\n  run,\n}: {\n  doc: object;\n  attributions: readonly UpdateAttribution[];\n  run: () => T;\n}): T {\n  const scopes = docScopes();\n  const outer = scopes.get(doc);\n  scopes.set(doc, attributions);\n  const stopMarking = markTransactionsBegun(doc, attributions);\n  try {\n    return run();\n  } finally {\n    stopMarking?.();\n    if (outer === undefined) scopes.delete(doc);\n    else scopes.set(doc, outer);\n  }\n}\n\n/**\n * The attributions the update being written into `doc` right now carries, if any: those of the\n * scope that began the transaction whose update `doc` is emitting, else those of the scope open\n * now.\n */\nexport function docUpdateAttributions(doc: object): readonly UpdateAttribution[] | undefined {\n  const marks = transactionMarks();\n  const emitting = marks.emitting.get(doc);\n  return (emitting === undefined ? undefined : marks.marked.get(emitting)) ?? docScopes().get(doc);\n}\n\n/** The lib0 varUint at `start` in `bytes` and where the next field begins; `null` past the end. */\nexport function readVarUint({\n  bytes,\n  start,\n}: {\n  bytes: Uint8Array;\n  start: number;\n}): { value: number; next: number } | null {\n  let value = 0;\n  let multiplier = 1;\n  for (let pos = start; pos < bytes.length; pos += 1) {\n    const byte = bytes[pos];\n    if (byte === undefined) return null;\n    value += (byte & 0x7f) * multiplier;\n    if (byte < 0x80) return { value, next: pos + 1 };\n    multiplier *= 0x80;\n    if (multiplier > Number.MAX_SAFE_INTEGER) return null;\n  }\n  return null;\n}\n\n/** Append `value` to `out` as a lib0 varUint. */\nexport function writeVarUint({ out, value }: { out: number[]; value: number }): void {\n  let rest = value;\n  while (rest > 0x7f) {\n    out.push(0x80 | (rest % 0x80));\n    rest = Math.floor(rest / 0x80);\n  }\n  out.push(rest);\n}\n\n/** Exactly one sync update message, with nothing after the update. */\nfunction isBareSyncUpdate(message: Uint8Array): boolean {\n  const type = readVarUint({ bytes: message, start: 0 });\n  if (type?.value !== MESSAGE_SYNC) return false;\n  const syncType = readVarUint({ bytes: message, start: type.next });\n  if (syncType?.value !== MESSAGE_SYNC_UPDATE) return false;\n  const length = readVarUint({ bytes: message, start: syncType.next });\n  return length !== null && length.next + length.value === message.length;\n}\n\n/**\n * `message` with the trailer for `attributions` appended, when it is a bare sync update message;\n * any other message (sync step 1 or 2, awareness, one that already ends in a trailer) is returned\n * as it is.\n */\nexport function withUpdateAttributionsTrailer({\n  message,\n  attributions,\n}: {\n  message: Uint8Array;\n  attributions: readonly UpdateAttribution[];\n}): Uint8Array {\n  if (attributions.length === 0 || !isBareSyncUpdate(message)) return message;\n  const trailer: number[] = [];\n  writeVarUint({ out: trailer, value: UPDATE_ATTRIBUTIONS_TRAILER_V1 });\n  writeVarUint({ out: trailer, value: attributions.length });\n  const utf8 = new TextEncoder();\n  for (const { k, v } of attributions) {\n    for (const text of [k, v]) {\n      const bytes = utf8.encode(text);\n      writeVarUint({ out: trailer, value: bytes.length });\n      for (const byte of bytes) trailer.push(byte);\n    }\n  }\n  const out = new Uint8Array(message.length + trailer.length);\n  out.set(message, 0);\n  out.set(trailer, message.length);\n  return out;\n}\n\n/** What {@link attributingWebSocket} needs of a socket: the `send` y-websocket writes frames with. */\nexport interface SendingSocket {\n  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;\n}\n\n/** One socket of a room, as the room's attributed writes Keryx has not acknowledged see it. */\nexport interface AttributedWritesSocket {\n  /** Keryx sent `frame` on the socket: what it carries, Keryx holds. */\n  received(frame: Uint8Array): void;\n  /** The socket sends `frame` (now, or once Keryx has sent what it holds; see the implementation). */\n  send(frame: Uint8Array): void;\n}\n\n/**\n * The room's attributed writes Keryx has not acknowledged yet, as its sockets see them\n * (`UnconfirmedUpdateAttributions` in `@athenaintel/keryx-http/unconfirmed-update-attributions`).\n */\nexport interface UnconfirmedAttributedWrites {\n  /**\n   * A socket opened, sending through `send`. `hears`: the socket hands it every frame Keryx sends\n   * (`received`), ahead of the transport.\n   */\n  connect(params: { send: (frame: Uint8Array) => void; hears: boolean }): AttributedWritesSocket;\n}\n\n/** The bytes of a binary frame a socket received, or `null` for one that is not (a string, a `Blob`). */\nfunction receivedBytes(data: unknown): Uint8Array | null {\n  if (data instanceof ArrayBuffer) return new Uint8Array(data);\n  if (ArrayBuffer.isView(data))\n    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n  return null;\n}\n\n/**\n * Hands `onFrame` every binary frame `socket` receives; whether it can. A listener added before\n * y-websocket sets `onmessage` runs ahead of it. A socket without `addEventListener` hands nothing.\n */\nfunction listenToFrames({\n  socket,\n  onFrame,\n}: {\n  socket: SendingSocket;\n  onFrame: (frame: Uint8Array) => void;\n}): boolean {\n  if (!('addEventListener' in socket) || typeof socket.addEventListener !== 'function') {\n    return false;\n  }\n  socket.addEventListener('message', (event: { data?: unknown }) => {\n    const frame = receivedBytes(event.data);\n    if (frame) onFrame(frame);\n  });\n  return true;\n}\n\n/**\n * `Base` with `send` appending the trailer of `attributionsFor()` to each sync update it sends.\n * With the room's `unconfirmed` attributed writes, each socket also tells them every frame Keryx\n * sends and sends its frames through them, so a sync step 2 goes out behind the kept writes it\n * carries. A `Proxy` keeps the constructor's statics and type, so it drops in as y-websocket's\n * `WebSocketPolyfill`.\n */\nexport function attributingWebSocket<TBase extends new (...args: never[]) => SendingSocket>({\n  Base,\n  attributionsFor,\n  unconfirmed,\n}: {\n  Base: TBase;\n  attributionsFor: () => readonly UpdateAttribution[] | undefined;\n  unconfirmed?: UnconfirmedAttributedWrites;\n}): TBase {\n  // No WebSocket where the provider is built (server render, a test without one): nothing to wrap,\n  // and the transport fails at connect as it always did.\n  if (typeof Base !== 'function') return Base;\n  return new Proxy(Base, {\n    construct(target, args) {\n      const socket: SendingSocket = Reflect.construct(target, args);\n      const send = socket.send.bind(socket);\n      let connection: AttributedWritesSocket | null = null;\n      if (unconfirmed) {\n        const hears = listenToFrames({ socket, onFrame: (frame) => connection?.received(frame) });\n        connection = unconfirmed.connect({ send, hears });\n      }\n      socket.send = (data) => {\n        if (!(data instanceof Uint8Array)) {\n          send(data);\n          return;\n        }\n        const attributions = attributionsFor();\n        const message = attributions\n          ? withUpdateAttributionsTrailer({ message: data, attributions })\n          : data;\n        if (connection) connection.send(message);\n        else send(message);\n      };\n      return socket;\n    },\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/keryx-http/src/update-attributions.d.ts

@@ -38,13 +38,22 @@ export declare const UPDATE_ATTRIBUTIONS_TRAILER_V1 = 1;
 /**
  * Run `run` with every update it writes into `doc` marked with `attributions`. Synchronous only:
  * the scope ends when `run` returns. Nested scopes restore the outer one.
+ *
+ * A transaction `run` begins while another transaction's events are delivered (an editor binding
+ * writing the fix a remote change needs, from inside that change's observers) is queued by Yjs, and
+ * its update is emitted, and sent, after `run` returns. Such a transaction is marked as it begins,
+ * so its update carries `attributions` too: a housekeeping write never goes out as the person's.
  */
 export declare function runWithDocUpdateAttributions<T>({ doc, attributions, run, }: {
     doc: object;
     attributions: readonly UpdateAttribution[];
     run: () => T;
 }): T;
-/** The attributions the update being written into `doc` right now carries, if any. */
+/**
+ * The attributions the update being written into `doc` right now carries, if any: those of the
+ * scope that began the transaction whose update `doc` is emitting, else those of the scope open
+ * now.
+ */
 export declare function docUpdateAttributions(doc: object): readonly UpdateAttribution[] | undefined;
 /** The lib0 varUint at `start` in `bytes` and where the next field begins; `null` past the end. */
 export declare function readVarUint({ bytes, start, }: {

package/dist/keryx-http/src/update-attributions.js

@@ -9,6 +9,27 @@ function docScopes() {
   const host = globalThis;
   return host[DOC_SCOPES] ?? (host[DOC_SCOPES] = /* @__PURE__ */ new WeakMap());
 }
+const TRANSACTION_MARKS = Symbol.for("@athenaintel/keryx-http/update-attribution-transactions");
+function transactionMarks() {
+  const host = globalThis;
+  return host[TRANSACTION_MARKS] ?? (host[TRANSACTION_MARKS] = { marked: /* @__PURE__ */ new WeakMap(), emitting: /* @__PURE__ */ new WeakMap(), followed: /* @__PURE__ */ new WeakSet() });
+}
+function hasTransactionEvents(doc) {
+  const events = doc;
+  return typeof events.on === "function" && typeof events.off === "function";
+}
+function markTransactionsBegun(doc, attributions) {
+  if (!hasTransactionEvents(doc)) return null;
+  const marks = transactionMarks();
+  if (!marks.followed.has(doc)) {
+    marks.followed.add(doc);
+    doc.on("afterTransactionCleanup", (transaction) => marks.emitting.set(doc, transaction));
+    doc.on("afterAllTransactions", () => marks.emitting.delete(doc));
+  }
+  const mark = (transaction) => marks.marked.set(transaction, attributions);
+  doc.on("beforeTransaction", mark);
+  return () => doc.off("beforeTransaction", mark);
+}
 function runWithDocUpdateAttributions({
   doc,
   attributions,
@@ -17,15 +38,19 @@ function runWithDocUpdateAttributions({
   const scopes = docScopes();
   const outer = scopes.get(doc);
   scopes.set(doc, attributions);
+  const stopMarking = markTransactionsBegun(doc, attributions);
   try {
     return run();
   } finally {
+    stopMarking == null ? void 0 : stopMarking();
     if (outer === void 0) scopes.delete(doc);
     else scopes.set(doc, outer);
   }
 }
 function docUpdateAttributions(doc) {
-  return docScopes().get(doc);
+  const marks = transactionMarks();
+  const emitting = marks.emitting.get(doc);
+  return (emitting === void 0 ? void 0 : marks.marked.get(emitting)) ?? docScopes().get(doc);
 }
 function readVarUint({
   bytes,

package/dist/keryx-http/src/update-attributions.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-attributions.js","sources":["../../../../keryx-http/src/update-attributions.ts"],"sourcesContent":["/**\n * Attributions one Keryx socket update carries of its own.\n *\n * A Keryx connection's attributions are fixed when its socket opens, so every update a client\n * sends is attributed to the person whose client it is. A write the client makes on its own (the\n * sheet leader re-issuing `=AOP` formulas or re-pushing `=IMPORTRANGE` values, a restored result,\n * an editor binding re-keying what an older binding stored) read as that person's edit and woke\n * \"people only\" subscriptions. Keryx reads a trailer after the update in a sync update message\n * (`readUpdateAttributions` in `patches/@y%2Fhub@0.10.1.patch`): `varUint(1)`, `varUint(n)`, then\n * `n` pairs of `varString` key and value. It accepts only `origin: background`, which it counts as\n * system work (`actorOf` in `keryx/src/compaction-activity.ts`), and the pairs that name a Quick\n * Edit step (`@athenaintel/keryx-http/quick-edit`: `session_id`/`run_kind` on the apply,\n * `quick_edit_undo`/`quick_edit_redo` with `quick_edit_op` on an undo or redo), each value in\n * exactly its shape. A Keryx without that hunk reads the update and ignores the bytes after it, so\n * a trailer never costs an update; a pair it does not allow is dropped and the rest kept.\n *\n * A writer marks its writes by making them inside {@link runWithDocUpdateAttributions} for the\n * doc; the transport's socket ({@link attributingWebSocket}) appends the trailer to each sync\n * update it sends while that scope is open. Both Keryx transports wrap their sockets with it:\n * Olympus's rooms (`KeryxYjsProviderV14`) and `@athenaintel/react/collab`'s `connectGenericDoc`\n * (Midas, the phone's editor page). y-websocket sends a local update from inside the doc's\n * `update` event, which fires inside the write itself, so the trailer always rides on the update\n * the scope wrote. A write made while the socket is closed is not sent then: it reaches Keryx in\n * the reconnect's sync step 2, which can carry no trailer. A transport that hands its socket the\n * room's {@link UnconfirmedAttributedWrites} (`@athenaintel/keryx-http/unconfirmed-update-attributions`)\n * sends each such write ahead of that sync step 2 as its own marked update; without one it stays\n * the person's.\n */\n\n/** One custom attribution, as Keryx stores it on the items an update wrote. */\nexport interface UpdateAttribution {\n  k: string;\n  v: string;\n}\n\n/** The pair a housekeeping write carries; Agora and Keryx spell it the same way. */\nexport const BACKGROUND_UPDATE_ATTRIBUTIONS: readonly UpdateAttribution[] = [\n  { k: 'origin', v: 'background' },\n];\n\n/** The trailer format Keryx reads (`updateAttributionsTrailerV1`). */\nexport const UPDATE_ATTRIBUTIONS_TRAILER_V1 = 1;\n\n/** y-protocols: a sync message, and its update sub-type. */\nconst MESSAGE_SYNC = 0;\nconst MESSAGE_SYNC_UPDATE = 2;\n\n/**\n * The open scopes live on `globalThis`, not in module scope, because two copies of this module can\n * run in one page: `@athenaintel/react` bundles it into its dist (this package is private, so the\n * published SDK must inline it) while a host may import it from this package. A scope a writer\n * opens through one copy must be the one the transport's socket reads through the other.\n */\nconst DOC_SCOPES = Symbol.for('@athenaintel/keryx-http/update-attribution-scopes');\n\ntype DocScopesHost = typeof globalThis & {\n  [DOC_SCOPES]?: WeakMap<object, readonly UpdateAttribution[]>;\n};\n\n// process-local: browser-only scopes, each keyed by the doc it guards and cleared in the same synchronous call that set it\nfunction docScopes(): WeakMap<object, readonly UpdateAttribution[]> {\n  const host = globalThis as DocScopesHost;\n  return (host[DOC_SCOPES] ??= new WeakMap());\n}\n\n/**\n * Run `run` with every update it writes into `doc` marked with `attributions`. Synchronous only:\n * the scope ends when `run` returns. Nested scopes restore the outer one.\n */\nexport function runWithDocUpdateAttributions<T>({\n  doc,\n  attributions,\n  run,\n}: {\n  doc: object;\n  attributions: readonly UpdateAttribution[];\n  run: () => T;\n}): T {\n  const scopes = docScopes();\n  const outer = scopes.get(doc);\n  scopes.set(doc, attributions);\n  try {\n    return run();\n  } finally {\n    if (outer === undefined) scopes.delete(doc);\n    else scopes.set(doc, outer);\n  }\n}\n\n/** The attributions the update being written into `doc` right now carries, if any. */\nexport function docUpdateAttributions(doc: object): readonly UpdateAttribution[] | undefined {\n  return docScopes().get(doc);\n}\n\n/** The lib0 varUint at `start` in `bytes` and where the next field begins; `null` past the end. */\nexport function readVarUint({\n  bytes,\n  start,\n}: {\n  bytes: Uint8Array;\n  start: number;\n}): { value: number; next: number } | null {\n  let value = 0;\n  let multiplier = 1;\n  for (let pos = start; pos < bytes.length; pos += 1) {\n    const byte = bytes[pos];\n    if (byte === undefined) return null;\n    value += (byte & 0x7f) * multiplier;\n    if (byte < 0x80) return { value, next: pos + 1 };\n    multiplier *= 0x80;\n    if (multiplier > Number.MAX_SAFE_INTEGER) return null;\n  }\n  return null;\n}\n\n/** Append `value` to `out` as a lib0 varUint. */\nexport function writeVarUint({ out, value }: { out: number[]; value: number }): void {\n  let rest = value;\n  while (rest > 0x7f) {\n    out.push(0x80 | (rest % 0x80));\n    rest = Math.floor(rest / 0x80);\n  }\n  out.push(rest);\n}\n\n/** Exactly one sync update message, with nothing after the update. */\nfunction isBareSyncUpdate(message: Uint8Array): boolean {\n  const type = readVarUint({ bytes: message, start: 0 });\n  if (type?.value !== MESSAGE_SYNC) return false;\n  const syncType = readVarUint({ bytes: message, start: type.next });\n  if (syncType?.value !== MESSAGE_SYNC_UPDATE) return false;\n  const length = readVarUint({ bytes: message, start: syncType.next });\n  return length !== null && length.next + length.value === message.length;\n}\n\n/**\n * `message` with the trailer for `attributions` appended, when it is a bare sync update message;\n * any other message (sync step 1 or 2, awareness, one that already ends in a trailer) is returned\n * as it is.\n */\nexport function withUpdateAttributionsTrailer({\n  message,\n  attributions,\n}: {\n  message: Uint8Array;\n  attributions: readonly UpdateAttribution[];\n}): Uint8Array {\n  if (attributions.length === 0 || !isBareSyncUpdate(message)) return message;\n  const trailer: number[] = [];\n  writeVarUint({ out: trailer, value: UPDATE_ATTRIBUTIONS_TRAILER_V1 });\n  writeVarUint({ out: trailer, value: attributions.length });\n  const utf8 = new TextEncoder();\n  for (const { k, v } of attributions) {\n    for (const text of [k, v]) {\n      const bytes = utf8.encode(text);\n      writeVarUint({ out: trailer, value: bytes.length });\n      for (const byte of bytes) trailer.push(byte);\n    }\n  }\n  const out = new Uint8Array(message.length + trailer.length);\n  out.set(message, 0);\n  out.set(trailer, message.length);\n  return out;\n}\n\n/** What {@link attributingWebSocket} needs of a socket: the `send` y-websocket writes frames with. */\nexport interface SendingSocket {\n  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;\n}\n\n/** One socket of a room, as the room's attributed writes Keryx has not acknowledged see it. */\nexport interface AttributedWritesSocket {\n  /** Keryx sent `frame` on the socket: what it carries, Keryx holds. */\n  received(frame: Uint8Array): void;\n  /** The socket sends `frame` (now, or once Keryx has sent what it holds; see the implementation). */\n  send(frame: Uint8Array): void;\n}\n\n/**\n * The room's attributed writes Keryx has not acknowledged yet, as its sockets see them\n * (`UnconfirmedUpdateAttributions` in `@athenaintel/keryx-http/unconfirmed-update-attributions`).\n */\nexport interface UnconfirmedAttributedWrites {\n  /**\n   * A socket opened, sending through `send`. `hears`: the socket hands it every frame Keryx sends\n   * (`received`), ahead of the transport.\n   */\n  connect(params: { send: (frame: Uint8Array) => void; hears: boolean }): AttributedWritesSocket;\n}\n\n/** The bytes of a binary frame a socket received, or `null` for one that is not (a string, a `Blob`). */\nfunction receivedBytes(data: unknown): Uint8Array | null {\n  if (data instanceof ArrayBuffer) return new Uint8Array(data);\n  if (ArrayBuffer.isView(data))\n    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n  return null;\n}\n\n/**\n * Hands `onFrame` every binary frame `socket` receives; whether it can. A listener added before\n * y-websocket sets `onmessage` runs ahead of it. A socket without `addEventListener` hands nothing.\n */\nfunction listenToFrames({\n  socket,\n  onFrame,\n}: {\n  socket: SendingSocket;\n  onFrame: (frame: Uint8Array) => void;\n}): boolean {\n  if (!('addEventListener' in socket) || typeof socket.addEventListener !== 'function') {\n    return false;\n  }\n  socket.addEventListener('message', (event: { data?: unknown }) => {\n    const frame = receivedBytes(event.data);\n    if (frame) onFrame(frame);\n  });\n  return true;\n}\n\n/**\n * `Base` with `send` appending the trailer of `attributionsFor()` to each sync update it sends.\n * With the room's `unconfirmed` attributed writes, each socket also tells them every frame Keryx\n * sends and sends its frames through them, so a sync step 2 goes out behind the kept writes it\n * carries. A `Proxy` keeps the constructor's statics and type, so it drops in as y-websocket's\n * `WebSocketPolyfill`.\n */\nexport function attributingWebSocket<TBase extends new (...args: never[]) => SendingSocket>({\n  Base,\n  attributionsFor,\n  unconfirmed,\n}: {\n  Base: TBase;\n  attributionsFor: () => readonly UpdateAttribution[] | undefined;\n  unconfirmed?: UnconfirmedAttributedWrites;\n}): TBase {\n  // No WebSocket where the provider is built (server render, a test without one): nothing to wrap,\n  // and the transport fails at connect as it always did.\n  if (typeof Base !== 'function') return Base;\n  return new Proxy(Base, {\n    construct(target, args) {\n      const socket: SendingSocket = Reflect.construct(target, args);\n      const send = socket.send.bind(socket);\n      let connection: AttributedWritesSocket | null = null;\n      if (unconfirmed) {\n        const hears = listenToFrames({ socket, onFrame: (frame) => connection?.received(frame) });\n        connection = unconfirmed.connect({ send, hears });\n      }\n      socket.send = (data) => {\n        if (!(data instanceof Uint8Array)) {\n          send(data);\n          return;\n        }\n        const attributions = attributionsFor();\n        const message = attributions\n          ? withUpdateAttributionsTrailer({ message: data, attributions })\n          : data;\n        if (connection) connection.send(message);\n        else send(message);\n      };\n      return socket;\n    },\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-attributions.js","sources":["../../../../keryx-http/src/update-attributions.ts"],"sourcesContent":["/**\n * Attributions one Keryx socket update carries of its own.\n *\n * A Keryx connection's attributions are fixed when its socket opens, so every update a client\n * sends is attributed to the person whose client it is. A write the client makes on its own (the\n * sheet leader re-issuing `=AOP` formulas or re-pushing `=IMPORTRANGE` values, a restored result,\n * an editor binding re-keying what an older binding stored) read as that person's edit and woke\n * \"people only\" subscriptions. Keryx reads a trailer after the update in a sync update message\n * (`readUpdateAttributions` in `patches/@y%2Fhub@0.10.1.patch`): `varUint(1)`, `varUint(n)`, then\n * `n` pairs of `varString` key and value. It accepts only `origin: background`, which it counts as\n * system work (`actorOf` in `keryx/src/compaction-activity.ts`), and the pairs that name a Quick\n * Edit step (`@athenaintel/keryx-http/quick-edit`: `session_id`/`run_kind` on the apply,\n * `quick_edit_undo`/`quick_edit_redo` with `quick_edit_op` on an undo or redo), each value in\n * exactly its shape. A Keryx without that hunk reads the update and ignores the bytes after it, so\n * a trailer never costs an update; a pair it does not allow is dropped and the rest kept.\n *\n * A writer marks its writes by making them inside {@link runWithDocUpdateAttributions} for the\n * doc; the transport's socket ({@link attributingWebSocket}) appends the trailer to each sync\n * update it sends while that scope is open. Both Keryx transports wrap their sockets with it:\n * Olympus's rooms (`KeryxYjsProviderV14`) and `@athenaintel/react/collab`'s `connectGenericDoc`\n * (Midas, the phone's editor page). y-websocket sends a local update from inside the doc's\n * `update` event, which fires inside the write itself, so the trailer always rides on the update\n * the scope wrote. A write made while the socket is closed is not sent then: it reaches Keryx in\n * the reconnect's sync step 2, which can carry no trailer. A transport that hands its socket the\n * room's {@link UnconfirmedAttributedWrites} (`@athenaintel/keryx-http/unconfirmed-update-attributions`)\n * sends each such write ahead of that sync step 2 as its own marked update; without one it stays\n * the person's.\n */\n\n/** One custom attribution, as Keryx stores it on the items an update wrote. */\nexport interface UpdateAttribution {\n  k: string;\n  v: string;\n}\n\n/** The pair a housekeeping write carries; Agora and Keryx spell it the same way. */\nexport const BACKGROUND_UPDATE_ATTRIBUTIONS: readonly UpdateAttribution[] = [\n  { k: 'origin', v: 'background' },\n];\n\n/** The trailer format Keryx reads (`updateAttributionsTrailerV1`). */\nexport const UPDATE_ATTRIBUTIONS_TRAILER_V1 = 1;\n\n/** y-protocols: a sync message, and its update sub-type. */\nconst MESSAGE_SYNC = 0;\nconst MESSAGE_SYNC_UPDATE = 2;\n\n/**\n * The open scopes live on `globalThis`, not in module scope, because two copies of this module can\n * run in one page: `@athenaintel/react` bundles it into its dist (this package is private, so the\n * published SDK must inline it) while a host may import it from this package. A scope a writer\n * opens through one copy must be the one the transport's socket reads through the other.\n */\nconst DOC_SCOPES = Symbol.for('@athenaintel/keryx-http/update-attribution-scopes');\n\ntype DocScopesHost = typeof globalThis & {\n  [DOC_SCOPES]?: WeakMap<object, readonly UpdateAttribution[]>;\n};\n\n// process-local: browser-only scopes, each keyed by the doc it guards and cleared in the same synchronous call that set it\nfunction docScopes(): WeakMap<object, readonly UpdateAttribution[]> {\n  const host = globalThis as DocScopesHost;\n  return (host[DOC_SCOPES] ??= new WeakMap());\n}\n\n/**\n * The transactions a scope began, by the attributions their update carries, and the transaction\n * whose update each doc is emitting now: on `globalThis` for the same reason as {@link DOC_SCOPES}.\n */\nconst TRANSACTION_MARKS = Symbol.for('@athenaintel/keryx-http/update-attribution-transactions');\n\ninterface TransactionMarks {\n  /** A transaction a scope began, by the attributions its update carries. */\n  readonly marked: WeakMap<object, readonly UpdateAttribution[]>;\n  /** The transaction whose update each doc emits now (from its cleanup to the end of the drain). */\n  readonly emitting: WeakMap<object, object>;\n  /** The docs whose emitting transaction is followed. */\n  readonly followed: WeakSet<object>;\n}\n\ntype TransactionMarksHost = typeof globalThis & { [TRANSACTION_MARKS]?: TransactionMarks };\n\n// process-local: browser-only, keyed weakly by the doc and its transactions, which drop them with them\nfunction transactionMarks(): TransactionMarks {\n  const host = globalThis as TransactionMarksHost;\n  return (host[TRANSACTION_MARKS] ??= { marked: new WeakMap(), emitting: new WeakMap(), followed: new WeakSet() });\n}\n\n/** What a scope listens to on a doc: Yjs 13's and `@y/y`'s `on`/`off` alike. */\ninterface TransactionEvents {\n  on(name: string, listener: (transaction: object) => void): void;\n  off(name: string, listener: (transaction: object) => void): void;\n}\n\nfunction hasTransactionEvents(doc: object): doc is TransactionEvents {\n  const events = doc as Partial<TransactionEvents>;\n  return typeof events.on === 'function' && typeof events.off === 'function';\n}\n\n/**\n * Mark every transaction of `doc` that begins until the returned function is called with\n * `attributions`, and follow which transaction's update `doc` emits. Yjs emits a transaction's\n * update right after its `afterTransactionCleanup`, and sends none outside a drain.\n */\nfunction markTransactionsBegun(doc: object, attributions: readonly UpdateAttribution[]): (() => void) | null {\n  if (!hasTransactionEvents(doc)) return null;\n  const marks = transactionMarks();\n  if (!marks.followed.has(doc)) {\n    marks.followed.add(doc);\n    doc.on('afterTransactionCleanup', (transaction) => marks.emitting.set(doc, transaction));\n    doc.on('afterAllTransactions', () => marks.emitting.delete(doc));\n  }\n  const mark = (transaction: object) => marks.marked.set(transaction, attributions);\n  doc.on('beforeTransaction', mark);\n  return () => doc.off('beforeTransaction', mark);\n}\n\n/**\n * Run `run` with every update it writes into `doc` marked with `attributions`. Synchronous only:\n * the scope ends when `run` returns. Nested scopes restore the outer one.\n *\n * A transaction `run` begins while another transaction's events are delivered (an editor binding\n * writing the fix a remote change needs, from inside that change's observers) is queued by Yjs, and\n * its update is emitted, and sent, after `run` returns. Such a transaction is marked as it begins,\n * so its update carries `attributions` too: a housekeeping write never goes out as the person's.\n */\nexport function runWithDocUpdateAttributions<T>({\n  doc,\n  attributions,\n  run,\n}: {\n  doc: object;\n  attributions: readonly UpdateAttribution[];\n  run: () => T;\n}): T {\n  const scopes = docScopes();\n  const outer = scopes.get(doc);\n  scopes.set(doc, attributions);\n  const stopMarking = markTransactionsBegun(doc, attributions);\n  try {\n    return run();\n  } finally {\n    stopMarking?.();\n    if (outer === undefined) scopes.delete(doc);\n    else scopes.set(doc, outer);\n  }\n}\n\n/**\n * The attributions the update being written into `doc` right now carries, if any: those of the\n * scope that began the transaction whose update `doc` is emitting, else those of the scope open\n * now.\n */\nexport function docUpdateAttributions(doc: object): readonly UpdateAttribution[] | undefined {\n  const marks = transactionMarks();\n  const emitting = marks.emitting.get(doc);\n  return (emitting === undefined ? undefined : marks.marked.get(emitting)) ?? docScopes().get(doc);\n}\n\n/** The lib0 varUint at `start` in `bytes` and where the next field begins; `null` past the end. */\nexport function readVarUint({\n  bytes,\n  start,\n}: {\n  bytes: Uint8Array;\n  start: number;\n}): { value: number; next: number } | null {\n  let value = 0;\n  let multiplier = 1;\n  for (let pos = start; pos < bytes.length; pos += 1) {\n    const byte = bytes[pos];\n    if (byte === undefined) return null;\n    value += (byte & 0x7f) * multiplier;\n    if (byte < 0x80) return { value, next: pos + 1 };\n    multiplier *= 0x80;\n    if (multiplier > Number.MAX_SAFE_INTEGER) return null;\n  }\n  return null;\n}\n\n/** Append `value` to `out` as a lib0 varUint. */\nexport function writeVarUint({ out, value }: { out: number[]; value: number }): void {\n  let rest = value;\n  while (rest > 0x7f) {\n    out.push(0x80 | (rest % 0x80));\n    rest = Math.floor(rest / 0x80);\n  }\n  out.push(rest);\n}\n\n/** Exactly one sync update message, with nothing after the update. */\nfunction isBareSyncUpdate(message: Uint8Array): boolean {\n  const type = readVarUint({ bytes: message, start: 0 });\n  if (type?.value !== MESSAGE_SYNC) return false;\n  const syncType = readVarUint({ bytes: message, start: type.next });\n  if (syncType?.value !== MESSAGE_SYNC_UPDATE) return false;\n  const length = readVarUint({ bytes: message, start: syncType.next });\n  return length !== null && length.next + length.value === message.length;\n}\n\n/**\n * `message` with the trailer for `attributions` appended, when it is a bare sync update message;\n * any other message (sync step 1 or 2, awareness, one that already ends in a trailer) is returned\n * as it is.\n */\nexport function withUpdateAttributionsTrailer({\n  message,\n  attributions,\n}: {\n  message: Uint8Array;\n  attributions: readonly UpdateAttribution[];\n}): Uint8Array {\n  if (attributions.length === 0 || !isBareSyncUpdate(message)) return message;\n  const trailer: number[] = [];\n  writeVarUint({ out: trailer, value: UPDATE_ATTRIBUTIONS_TRAILER_V1 });\n  writeVarUint({ out: trailer, value: attributions.length });\n  const utf8 = new TextEncoder();\n  for (const { k, v } of attributions) {\n    for (const text of [k, v]) {\n      const bytes = utf8.encode(text);\n      writeVarUint({ out: trailer, value: bytes.length });\n      for (const byte of bytes) trailer.push(byte);\n    }\n  }\n  const out = new Uint8Array(message.length + trailer.length);\n  out.set(message, 0);\n  out.set(trailer, message.length);\n  return out;\n}\n\n/** What {@link attributingWebSocket} needs of a socket: the `send` y-websocket writes frames with. */\nexport interface SendingSocket {\n  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;\n}\n\n/** One socket of a room, as the room's attributed writes Keryx has not acknowledged see it. */\nexport interface AttributedWritesSocket {\n  /** Keryx sent `frame` on the socket: what it carries, Keryx holds. */\n  received(frame: Uint8Array): void;\n  /** The socket sends `frame` (now, or once Keryx has sent what it holds; see the implementation). */\n  send(frame: Uint8Array): void;\n}\n\n/**\n * The room's attributed writes Keryx has not acknowledged yet, as its sockets see them\n * (`UnconfirmedUpdateAttributions` in `@athenaintel/keryx-http/unconfirmed-update-attributions`).\n */\nexport interface UnconfirmedAttributedWrites {\n  /**\n   * A socket opened, sending through `send`. `hears`: the socket hands it every frame Keryx sends\n   * (`received`), ahead of the transport.\n   */\n  connect(params: { send: (frame: Uint8Array) => void; hears: boolean }): AttributedWritesSocket;\n}\n\n/** The bytes of a binary frame a socket received, or `null` for one that is not (a string, a `Blob`). */\nfunction receivedBytes(data: unknown): Uint8Array | null {\n  if (data instanceof ArrayBuffer) return new Uint8Array(data);\n  if (ArrayBuffer.isView(data))\n    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n  return null;\n}\n\n/**\n * Hands `onFrame` every binary frame `socket` receives; whether it can. A listener added before\n * y-websocket sets `onmessage` runs ahead of it. A socket without `addEventListener` hands nothing.\n */\nfunction listenToFrames({\n  socket,\n  onFrame,\n}: {\n  socket: SendingSocket;\n  onFrame: (frame: Uint8Array) => void;\n}): boolean {\n  if (!('addEventListener' in socket) || typeof socket.addEventListener !== 'function') {\n    return false;\n  }\n  socket.addEventListener('message', (event: { data?: unknown }) => {\n    const frame = receivedBytes(event.data);\n    if (frame) onFrame(frame);\n  });\n  return true;\n}\n\n/**\n * `Base` with `send` appending the trailer of `attributionsFor()` to each sync update it sends.\n * With the room's `unconfirmed` attributed writes, each socket also tells them every frame Keryx\n * sends and sends its frames through them, so a sync step 2 goes out behind the kept writes it\n * carries. A `Proxy` keeps the constructor's statics and type, so it drops in as y-websocket's\n * `WebSocketPolyfill`.\n */\nexport function attributingWebSocket<TBase extends new (...args: never[]) => SendingSocket>({\n  Base,\n  attributionsFor,\n  unconfirmed,\n}: {\n  Base: TBase;\n  attributionsFor: () => readonly UpdateAttribution[] | undefined;\n  unconfirmed?: UnconfirmedAttributedWrites;\n}): TBase {\n  // No WebSocket where the provider is built (server render, a test without one): nothing to wrap,\n  // and the transport fails at connect as it always did.\n  if (typeof Base !== 'function') return Base;\n  return new Proxy(Base, {\n    construct(target, args) {\n      const socket: SendingSocket = Reflect.construct(target, args);\n      const send = socket.send.bind(socket);\n      let connection: AttributedWritesSocket | null = null;\n      if (unconfirmed) {\n        const hears = listenToFrames({ socket, onFrame: (frame) => connection?.received(frame) });\n        connection = unconfirmed.connect({ send, hears });\n      }\n      socket.send = (data) => {\n        if (!(data instanceof Uint8Array)) {\n          send(data);\n          return;\n        }\n        const attributions = attributionsFor();\n        const message = attributions\n          ? withUpdateAttributionsTrailer({ message: data, attributions })\n          : data;\n        if (connection) connection.send(message);\n        else send(message);\n      };\n      return socket;\n    },\n  });\n}\n"],"names":[],"mappings":"AAoCO,MAAM,iCAA+D;AAAA,EAC1E,EAAE,GAAG,UAAU,GAAG,aAAA;AACpB;AAGO,MAAM,iCAAiC;AAG9C,MAAM,eAAe;AACrB,MAAM,sBAAsB;AAQ5B,MAAM,aAAa,OAAO,IAAI,mDAAmD;AAOjF,SAAS,YAA2D;AAClE,QAAM,OAAO;AACb,SAAQ,wCAAqB,oBAAI,QAAA;AACnC;AAMA,MAAM,oBAAoB,OAAO,IAAI,yDAAyD;AAc9F,SAAS,mBAAqC;AAC5C,QAAM,OAAO;AACb,SAAQ,sDAA4B,EAAE,QAAQ,oBAAI,QAAA,GAAW,8BAAc,QAAA,GAAW,UAAU,oBAAI,UAAQ;AAC9G;AAQA,SAAS,qBAAqB,KAAuC;AACnE,QAAM,SAAS;AACf,SAAO,OAAO,OAAO,OAAO,cAAc,OAAO,OAAO,QAAQ;AAClE;AAOA,SAAS,sBAAsB,KAAa,cAAiE;AAC3G,MAAI,CAAC,qBAAqB,GAAG,EAAG,QAAO;AACvC,QAAM,QAAQ,iBAAA;AACd,MAAI,CAAC,MAAM,SAAS,IAAI,GAAG,GAAG;AAC5B,UAAM,SAAS,IAAI,GAAG;AACtB,QAAI,GAAG,2BAA2B,CAAC,gBAAgB,MAAM,SAAS,IAAI,KAAK,WAAW,CAAC;AACvF,QAAI,GAAG,wBAAwB,MAAM,MAAM,SAAS,OAAO,GAAG,CAAC;AAAA,EACjE;AACA,QAAM,OAAO,CAAC,gBAAwB,MAAM,OAAO,IAAI,aAAa,YAAY;AAChF,MAAI,GAAG,qBAAqB,IAAI;AAChC,SAAO,MAAM,IAAI,IAAI,qBAAqB,IAAI;AAChD;AAWO,SAAS,6BAAgC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AACF,GAIM;AACJ,QAAM,SAAS,UAAA;AACf,QAAM,QAAQ,OAAO,IAAI,GAAG;AAC5B,SAAO,IAAI,KAAK,YAAY;AAC5B,QAAM,cAAc,sBAAsB,KAAK,YAAY;AAC3D,MAAI;AACF,WAAO,IAAA;AAAA,EACT,UAAA;AACE;AACA,QAAI,UAAU,OAAW,QAAO,OAAO,GAAG;AAAA,QACrC,QAAO,IAAI,KAAK,KAAK;AAAA,EAC5B;AACF;AAOO,SAAS,sBAAsB,KAAuD;AAC3F,QAAM,QAAQ,iBAAA;AACd,QAAM,WAAW,MAAM,SAAS,IAAI,GAAG;AACvC,UAAQ,aAAa,SAAY,SAAY,MAAM,OAAO,IAAI,QAAQ,MAAM,YAAY,IAAI,GAAG;AACjG;AAGO,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AACF,GAG2C;AACzC,MAAI,QAAQ;AACZ,MAAI,aAAa;AACjB,WAAS,MAAM,OAAO,MAAM,MAAM,QAAQ,OAAO,GAAG;AAClD,UAAM,OAAO,MAAM,GAAG;AACtB,QAAI,SAAS,OAAW,QAAO;AAC/B,cAAU,OAAO,OAAQ;AACzB,QAAI,OAAO,IAAM,QAAO,EAAE,OAAO,MAAM,MAAM,EAAA;AAC7C,kBAAc;AACd,QAAI,aAAa,OAAO,iBAAkB,QAAO;AAAA,EACnD;AACA,SAAO;AACT;AAGO,SAAS,aAAa,EAAE,KAAK,SAAiD;AACnF,MAAI,OAAO;AACX,SAAO,OAAO,KAAM;AAClB,QAAI,KAAK,MAAQ,OAAO,GAAK;AAC7B,WAAO,KAAK,MAAM,OAAO,GAAI;AAAA,EAC/B;AACA,MAAI,KAAK,IAAI;AACf;AAGA,SAAS,iBAAiB,SAA8B;AACtD,QAAM,OAAO,YAAY,EAAE,OAAO,SAAS,OAAO,GAAG;AACrD,OAAI,6BAAM,WAAU,aAAc,QAAO;AACzC,QAAM,WAAW,YAAY,EAAE,OAAO,SAAS,OAAO,KAAK,MAAM;AACjE,OAAI,qCAAU,WAAU,oBAAqB,QAAO;AACpD,QAAM,SAAS,YAAY,EAAE,OAAO,SAAS,OAAO,SAAS,MAAM;AACnE,SAAO,WAAW,QAAQ,OAAO,OAAO,OAAO,UAAU,QAAQ;AACnE;AAOO,SAAS,8BAA8B;AAAA,EAC5C;AAAA,EACA;AACF,GAGe;AACb,MAAI,aAAa,WAAW,KAAK,CAAC,iBAAiB,OAAO,EAAG,QAAO;AACpE,QAAM,UAAoB,CAAA;AAC1B,eAAa,EAAE,KAAK,SAAS,OAAO,gCAAgC;AACpE,eAAa,EAAE,KAAK,SAAS,OAAO,aAAa,QAAQ;AACzD,QAAM,OAAO,IAAI,YAAA;AACjB,aAAW,EAAE,GAAG,EAAA,KAAO,cAAc;AACnC,eAAW,QAAQ,CAAC,GAAG,CAAC,GAAG;AACzB,YAAM,QAAQ,KAAK,OAAO,IAAI;AAC9B,mBAAa,EAAE,KAAK,SAAS,OAAO,MAAM,QAAQ;AAClD,iBAAW,QAAQ,MAAO,SAAQ,KAAK,IAAI;AAAA,IAC7C;AAAA,EACF;AACA,QAAM,MAAM,IAAI,WAAW,QAAQ,SAAS,QAAQ,MAAM;AAC1D,MAAI,IAAI,SAAS,CAAC;AAClB,MAAI,IAAI,SAAS,QAAQ,MAAM;AAC/B,SAAO;AACT;AA4BA,SAAS,cAAc,MAAkC;AACvD,MAAI,gBAAgB,YAAa,QAAO,IAAI,WAAW,IAAI;AAC3D,MAAI,YAAY,OAAO,IAAI;AACzB,WAAO,IAAI,WAAW,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU;AACrE,SAAO;AACT;AAMA,SAAS,eAAe;AAAA,EACtB;AAAA,EACA;AACF,GAGY;AACV,MAAI,EAAE,sBAAsB,WAAW,OAAO,OAAO,qBAAqB,YAAY;AACpF,WAAO;AAAA,EACT;AACA,SAAO,iBAAiB,WAAW,CAAC,UAA8B;AAChE,UAAM,QAAQ,cAAc,MAAM,IAAI;AACtC,QAAI,eAAe,KAAK;AAAA,EAC1B,CAAC;AACD,SAAO;AACT;AASO,SAAS,qBAA4E;AAAA,EAC1F;AAAA,EACA;AAAA,EACA;AACF,GAIU;AAGR,MAAI,OAAO,SAAS,WAAY,QAAO;AACvC,SAAO,IAAI,MAAM,MAAM;AAAA,IACrB,UAAU,QAAQ,MAAM;AACtB,YAAM,SAAwB,QAAQ,UAAU,QAAQ,IAAI;AAC5D,YAAM,OAAO,OAAO,KAAK,KAAK,MAAM;AACpC,UAAI,aAA4C;AAChD,UAAI,aAAa;AACf,cAAM,QAAQ,eAAe,EAAE,QAAQ,SAAS,CAAC,UAAU,yCAAY,SAAS,QAAQ;AACxF,qBAAa,YAAY,QAAQ,EAAE,MAAM,OAAO;AAAA,MAClD;AACA,aAAO,OAAO,CAAC,SAAS;AACtB,YAAI,EAAE,gBAAgB,aAAa;AACjC,eAAK,IAAI;AACT;AAAA,QACF;AACA,cAAM,eAAe,gBAAA;AACrB,cAAM,UAAU,eACZ,8BAA8B,EAAE,SAAS,MAAM,aAAA,CAAc,IAC7D;AACJ,YAAI,WAAY,YAAW,KAAK,OAAO;AAAA,kBAC7B,OAAO;AAAA,MACnB;AACA,aAAO;AAAA,IACT;AAAA,EAAA,CACD;AACH;"}