statewire 0.21.0 → 0.22.0

package/dist/wire/documents.js

@@ -1,7 +1,7 @@
-import { reviveDocumentValue } from "../document.js";
 import { protocolToken } from "./protocol.js";
+import { reviveDocumentValue } from "../document.js";
 import { applyOps } from "./ops.js";
-//#region src/wire/documents.ts
+// src/wire/documents.ts
 const invalid = (message) => {
 	throw new Error(`statewire: protocol error: ${message}`);
 };
@@ -88,7 +88,6 @@ const findDocument = (state, protocol, key, prefix) => {
 	const resolved = resolveDocumentKey(key, prefix);
 	return [...state.documents.values()].find((document) => document.protocol === protocol && document.key !== null && (JSON.stringify(document.key) === JSON.stringify(key) || resolved !== void 0 && JSON.stringify(resolveDocumentKey(document.key, prefix)) === JSON.stringify(resolved)));
 };
-//#endregion
 export { applyDocumentOps, findDocument, mainDocument, resolveDocumentKey };
 
 //# sourceMappingURL=documents.js.map

package/dist/wire/documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"documents.js","names":["applyOps","reviveValue","protocolToken","StatewirePath","StatewireDocuments","CacheEntry","version","value","Storage","namespace","load","identity","save","entry","subscribe","listener","Source","get","protocol","key","prefix","list","ReadonlyMap","Document","main","State","mode","documents","invalid","message","Error","applyDocumentOps","previous","ops","protocols","name","strict","undefined","length","Map","changedPaths","raw","Array","isArray","op","Record","doc","Number","isSafeInteger","includes","_doc","unknown","path","set","has","every","test","some","p","values","d","JSON","stringify","meta","rejectUnknown","push","document","delete","part","mutation","applied","state","mainDocument","find","resolveDocumentKey","slice","findDocument","resolved"],"sources":["../../src/wire/documents.ts"],"sourcesContent":["import { applyOps } from \"./ops\";\nimport { reviveValue } from \"./meta\";\nimport { protocolToken } from \"./protocol\";\nimport type { StatewirePath } from \"./ops\";\n\nexport namespace StatewireDocuments {\n  export type CacheEntry = { version: string; value: unknown };\n  export type Storage = {\n    namespace?: string;\n    load: (identity: readonly string[]) => CacheEntry | undefined;\n    save: (identity: readonly string[], entry: CacheEntry) => void;\n    subscribe?: (listener: () => void) => () => void;\n  };\n  export type Source = {\n    get: (\n      protocol: string,\n      key?: readonly string[],\n      prefix?: readonly string[],\n    ) => unknown;\n    list: () => ReadonlyMap<number, Document>;\n    subscribe: (listener: () => void) => () => void;\n  };\n  export type Document = {\n    key: readonly string[] | null;\n    protocol?: string;\n    main?: boolean;\n    value: unknown;\n  };\n  export type State = {\n    mode: \"mounted\" | \"keyless\" | null;\n    documents: ReadonlyMap<number, Document>;\n  };\n}\n\nconst invalid: (message: string) => never = (message) => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nexport const applyDocumentOps = (\n  previous: StatewireDocuments.State,\n  ops: readonly unknown[],\n  protocols?: readonly { name: string; version: string }[],\n  strict = false,\n) => {\n  let mode =\n    previous.mode ??\n    (protocols !== undefined && ops.length === 0 ? \"mounted\" : null);\n  const documents = new Map(previous.documents);\n  const changedPaths: StatewirePath[] = [];\n  for (const raw of ops) {\n    if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n      invalid(\"operation must be an object\");\n    }\n    const op = raw as Record<string, unknown>;\n    const doc = op.doc === undefined ? 0 : op.doc;\n    if (typeof doc !== \"number\" || !Number.isSafeInteger(doc) || doc < 0) {\n      invalid(\"doc must be a nonnegative safe integer\");\n    }\n    if (\n      ![\"mount\", \"unmount\", \"add\", \"replace\", \"remove\"].includes(\n        op.op as string,\n      )\n    ) {\n      if (strict) invalid(\"unknown context operation\");\n      const { doc: _doc, ...unknown } = op;\n      applyOps(undefined, [unknown]);\n      continue;\n    }\n    if (protocols !== undefined && mode === null && op.op !== \"mount\")\n      invalid(\"negotiated state must start with mounts\");\n    if (mode === null) {\n      if (op.op === \"mount\") mode = \"mounted\";\n      else if (\n        op.op === \"replace\" &&\n        doc === 0 &&\n        Array.isArray(op.path) &&\n        op.path.length === 0 &&\n        \"value\" in op\n      ) {\n        mode = \"keyless\";\n        documents.set(0, { key: null, value: undefined });\n      } else\n        invalid(\n          \"first operation must mount a document or replace document 0 at the root\",\n        );\n    }\n    if (\n      mode === \"keyless\" &&\n      (doc !== 0 || op.op === \"mount\" || op.op === \"unmount\")\n    ) {\n      invalid(\"keyless mode only supports mutations of document 0\");\n    }\n    if (op.op === \"mount\") {\n      if (documents.has(doc)) invalid(\"document is already mounted\");\n      if (\n        (op.key !== undefined &&\n          (!Array.isArray(op.key) ||\n            !op.key.every((key) => typeof key === \"string\"))) ||\n        !(\"value\" in op)\n      ) {\n        invalid(\"mount requires value and an optional key array\");\n      }\n      if (\n        op.protocol !== undefined &&\n        (typeof op.protocol !== \"string\" ||\n          !protocolToken.test(op.protocol) ||\n          op.protocol === \"*\")\n      )\n        invalid(\"invalid mount protocol\");\n      if (\n        protocols !== undefined &&\n        !protocols.some((p) => p.name === op.protocol)\n      )\n        invalid(\"mount protocol was not negotiated\");\n      if (op.main !== undefined && typeof op.main !== \"boolean\")\n        invalid(\"main must be boolean\");\n      if (\n        op.main === true &&\n        [...documents.values()].some(\n          (d) => d.protocol === op.protocol && d.main,\n        )\n      )\n        invalid(\"protocol already has a main document\");\n      if (\n        op.key !== undefined &&\n        [...documents.values()].some(\n          (d) =>\n            d.protocol === op.protocol &&\n            JSON.stringify(d.key) === JSON.stringify(op.key),\n        )\n      )\n        invalid(\"protocol document key is already mounted\");\n      documents.set(doc, {\n        key: op.key === undefined ? null : (op.key as string[]),\n        ...(op.protocol === undefined\n          ? {}\n          : { protocol: op.protocol as string }),\n        ...(op.main === undefined ? {} : { main: op.main as boolean }),\n        value:\n          op.meta === undefined\n            ? op.value\n            : reviveValue(op.value, op.meta, { rejectUnknown: strict }),\n      });\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"unmount\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!documents.delete(doc)) invalid(\"document is not mounted\");\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"add\" || op.op === \"replace\" || op.op === \"remove\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!document) invalid(\"document is not mounted\");\n      if (\n        !Array.isArray(op.path) ||\n        !op.path.every(\n          (part) =>\n            typeof part === \"string\" ||\n            (typeof part === \"number\" &&\n              Number.isSafeInteger(part) &&\n              part >= 0),\n        )\n      ) {\n        invalid(\"operation requires a valid path\");\n      }\n      if (op.op !== \"remove\" && !(\"value\" in op))\n        invalid(\"operation requires a value\");\n      const { doc: _doc, meta, ...mutation } = op;\n      if (meta !== undefined)\n        mutation.value = reviveValue(mutation.value, meta, {\n          rejectUnknown: strict,\n        });\n      const applied = applyOps(document.value, [mutation]);\n      documents.set(doc, { ...document, value: applied.state });\n      if (doc === 0) changedPaths.push(...applied.changedPaths);\n    }\n  }\n  if (mode === null) invalid(\"hello missing snapshot\");\n  return { mode, documents, changedPaths };\n};\n\nexport const mainDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n) =>\n  [...state.documents.values()].find(\n    (document) => document.protocol === protocol && document.main,\n  );\n\nexport const resolveDocumentKey = (\n  key: readonly string[],\n  prefix?: readonly string[],\n) =>\n  key[0] === \".\"\n    ? prefix === undefined\n      ? undefined\n      : [...prefix, ...key.slice(1)]\n    : key;\n\nexport const findDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n  key?: readonly string[],\n  prefix?: readonly string[],\n) => {\n  if (key === undefined) return mainDocument(state, protocol);\n  const resolved = resolveDocumentKey(key, prefix);\n  return [...state.documents.values()].find(\n    (document) =>\n      document.protocol === protocol &&\n      document.key !== null &&\n      (JSON.stringify(document.key) === JSON.stringify(key) ||\n        (resolved !== undefined &&\n          JSON.stringify(resolveDocumentKey(document.key, prefix)) ===\n            JSON.stringify(resolved))),\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"documents.js","names":["applyOps","reviveValue","protocolToken","StatewirePath","StatewireDocuments","CacheEntry","version","value","Storage","namespace","load","identity","save","entry","subscribe","listener","Source","get","protocol","key","prefix","list","ReadonlyMap","Document","main","State","mode","documents","invalid","message","Error","applyDocumentOps","previous","ops","protocols","name","strict","undefined","length","Map","changedPaths","raw","Array","isArray","op","Record","doc","Number","isSafeInteger","includes","_doc","unknown","path","set","has","every","test","some","p","values","d","JSON","stringify","meta","rejectUnknown","push","document","delete","part","mutation","applied","state","mainDocument","find","resolveDocumentKey","slice","findDocument","resolved","reviveValue"],"sources":["../../src/wire/documents.ts"],"sourcesContent":["import { applyOps } from \"./ops\";\nimport { reviveValue } from \"./meta\";\nimport { protocolToken } from \"./protocol\";\nimport type { StatewirePath } from \"./ops\";\n\nexport namespace StatewireDocuments {\n  export type CacheEntry = { version: string; value: unknown };\n  export type Storage = {\n    namespace?: string;\n    load: (identity: readonly string[]) => CacheEntry | undefined;\n    save: (identity: readonly string[], entry: CacheEntry) => void;\n    subscribe?: (listener: () => void) => () => void;\n  };\n  export type Source = {\n    get: (\n      protocol: string,\n      key?: readonly string[],\n      prefix?: readonly string[],\n    ) => unknown;\n    list: () => ReadonlyMap<number, Document>;\n    subscribe: (listener: () => void) => () => void;\n  };\n  export type Document = {\n    key: readonly string[] | null;\n    protocol?: string;\n    main?: boolean;\n    value: unknown;\n  };\n  export type State = {\n    mode: \"mounted\" | \"keyless\" | null;\n    documents: ReadonlyMap<number, Document>;\n  };\n}\n\nconst invalid: (message: string) => never = (message) => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nexport const applyDocumentOps = (\n  previous: StatewireDocuments.State,\n  ops: readonly unknown[],\n  protocols?: readonly { name: string; version: string }[],\n  strict = false,\n) => {\n  let mode =\n    previous.mode ??\n    (protocols !== undefined && ops.length === 0 ? \"mounted\" : null);\n  const documents = new Map(previous.documents);\n  const changedPaths: StatewirePath[] = [];\n  for (const raw of ops) {\n    if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n      invalid(\"operation must be an object\");\n    }\n    const op = raw as Record<string, unknown>;\n    const doc = op.doc === undefined ? 0 : op.doc;\n    if (typeof doc !== \"number\" || !Number.isSafeInteger(doc) || doc < 0) {\n      invalid(\"doc must be a nonnegative safe integer\");\n    }\n    if (\n      ![\"mount\", \"unmount\", \"add\", \"replace\", \"remove\"].includes(\n        op.op as string,\n      )\n    ) {\n      if (strict) invalid(\"unknown context operation\");\n      const { doc: _doc, ...unknown } = op;\n      applyOps(undefined, [unknown]);\n      continue;\n    }\n    if (protocols !== undefined && mode === null && op.op !== \"mount\")\n      invalid(\"negotiated state must start with mounts\");\n    if (mode === null) {\n      if (op.op === \"mount\") mode = \"mounted\";\n      else if (\n        op.op === \"replace\" &&\n        doc === 0 &&\n        Array.isArray(op.path) &&\n        op.path.length === 0 &&\n        \"value\" in op\n      ) {\n        mode = \"keyless\";\n        documents.set(0, { key: null, value: undefined });\n      } else\n        invalid(\n          \"first operation must mount a document or replace document 0 at the root\",\n        );\n    }\n    if (\n      mode === \"keyless\" &&\n      (doc !== 0 || op.op === \"mount\" || op.op === \"unmount\")\n    ) {\n      invalid(\"keyless mode only supports mutations of document 0\");\n    }\n    if (op.op === \"mount\") {\n      if (documents.has(doc)) invalid(\"document is already mounted\");\n      if (\n        (op.key !== undefined &&\n          (!Array.isArray(op.key) ||\n            !op.key.every((key) => typeof key === \"string\"))) ||\n        !(\"value\" in op)\n      ) {\n        invalid(\"mount requires value and an optional key array\");\n      }\n      if (\n        op.protocol !== undefined &&\n        (typeof op.protocol !== \"string\" ||\n          !protocolToken.test(op.protocol) ||\n          op.protocol === \"*\")\n      )\n        invalid(\"invalid mount protocol\");\n      if (\n        protocols !== undefined &&\n        !protocols.some((p) => p.name === op.protocol)\n      )\n        invalid(\"mount protocol was not negotiated\");\n      if (op.main !== undefined && typeof op.main !== \"boolean\")\n        invalid(\"main must be boolean\");\n      if (\n        op.main === true &&\n        [...documents.values()].some(\n          (d) => d.protocol === op.protocol && d.main,\n        )\n      )\n        invalid(\"protocol already has a main document\");\n      if (\n        op.key !== undefined &&\n        [...documents.values()].some(\n          (d) =>\n            d.protocol === op.protocol &&\n            JSON.stringify(d.key) === JSON.stringify(op.key),\n        )\n      )\n        invalid(\"protocol document key is already mounted\");\n      documents.set(doc, {\n        key: op.key === undefined ? null : (op.key as string[]),\n        ...(op.protocol === undefined\n          ? {}\n          : { protocol: op.protocol as string }),\n        ...(op.main === undefined ? {} : { main: op.main as boolean }),\n        value:\n          op.meta === undefined\n            ? op.value\n            : reviveValue(op.value, op.meta, { rejectUnknown: strict }),\n      });\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"unmount\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!documents.delete(doc)) invalid(\"document is not mounted\");\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"add\" || op.op === \"replace\" || op.op === \"remove\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!document) invalid(\"document is not mounted\");\n      if (\n        !Array.isArray(op.path) ||\n        !op.path.every(\n          (part) =>\n            typeof part === \"string\" ||\n            (typeof part === \"number\" &&\n              Number.isSafeInteger(part) &&\n              part >= 0),\n        )\n      ) {\n        invalid(\"operation requires a valid path\");\n      }\n      if (op.op !== \"remove\" && !(\"value\" in op))\n        invalid(\"operation requires a value\");\n      const { doc: _doc, meta, ...mutation } = op;\n      if (meta !== undefined)\n        mutation.value = reviveValue(mutation.value, meta, {\n          rejectUnknown: strict,\n        });\n      const applied = applyOps(document.value, [mutation]);\n      documents.set(doc, { ...document, value: applied.state });\n      if (doc === 0) changedPaths.push(...applied.changedPaths);\n    }\n  }\n  if (mode === null) invalid(\"hello missing snapshot\");\n  return { mode, documents, changedPaths };\n};\n\nexport const mainDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n) =>\n  [...state.documents.values()].find(\n    (document) => document.protocol === protocol && document.main,\n  );\n\nexport const resolveDocumentKey = (\n  key: readonly string[],\n  prefix?: readonly string[],\n) =>\n  key[0] === \".\"\n    ? prefix === undefined\n      ? undefined\n      : [...prefix, ...key.slice(1)]\n    : key;\n\nexport const findDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n  key?: readonly string[],\n  prefix?: readonly string[],\n) => {\n  if (key === undefined) return mainDocument(state, protocol);\n  const resolved = resolveDocumentKey(key, prefix);\n  return [...state.documents.values()].find(\n    (document) =>\n      document.protocol === protocol &&\n      document.key !== null &&\n      (JSON.stringify(document.key) === JSON.stringify(key) ||\n        (resolved !== undefined &&\n          JSON.stringify(resolveDocumentKey(document.key, prefix)) ===\n            JSON.stringify(resolved))),\n  );\n};\n"],"mappings":"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"}

package/dist/wire/limits.d.ts

@@ -1,11 +1,8 @@
-//#region src/wire/limits.d.ts
-declare const MAX_COMMANDS_PER_FRAME = 256;
-declare const MAX_INFLIGHT_COMMANDS_PER_CLIENT = 256;
-declare const MAX_FRAME_BODY_BYTES: number;
-declare const MAX_EPHEMERAL_DOCUMENT_BYTES: number;
-declare const MAX_INFLIGHT_COMMANDS_PER_HOST = 1024;
-declare const COMMAND_CAPACITY_RETRY_MS = 1000;
-declare const MAX_CONTEXT_BYTES: number;
-//#endregion
-export { COMMAND_CAPACITY_RETRY_MS, MAX_COMMANDS_PER_FRAME, MAX_CONTEXT_BYTES, MAX_EPHEMERAL_DOCUMENT_BYTES, MAX_FRAME_BODY_BYTES, MAX_INFLIGHT_COMMANDS_PER_CLIENT, MAX_INFLIGHT_COMMANDS_PER_HOST };
+export declare const MAX_COMMANDS_PER_FRAME = 256;
+export declare const MAX_INFLIGHT_COMMANDS_PER_CLIENT = 256;
+export declare const MAX_FRAME_BODY_BYTES: number;
+export declare const MAX_EPHEMERAL_DOCUMENT_BYTES: number;
+export declare const MAX_INFLIGHT_COMMANDS_PER_HOST = 1024;
+export declare const COMMAND_CAPACITY_RETRY_MS = 1000;
+export declare const MAX_CONTEXT_BYTES: number;
 //# sourceMappingURL=limits.d.ts.map

package/dist/wire/limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"limits.d.ts","names":[],"sources":["../../src/wire/limits.ts"],"mappings":";cAAa;cACA;cACA;cACA;cACA;cACA;cAEA"}
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/wire/limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,oBAAoB,QAAkB,CAAC;AACpD,eAAO,MAAM,4BAA4B,QAAY,CAAC;AACtD,eAAO,MAAM,8BAA8B,OAAO,CAAC;AACnD,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,eAAO,MAAM,iBAAiB,QAAY,CAAC"}

package/dist/wire/limits.js

@@ -1,4 +1,4 @@
-//#region src/wire/limits.ts
+// src/wire/limits.ts
 const MAX_COMMANDS_PER_FRAME = 256;
 const MAX_INFLIGHT_COMMANDS_PER_CLIENT = 256;
 const MAX_FRAME_BODY_BYTES = 8388608;
@@ -6,7 +6,6 @@ const MAX_EPHEMERAL_DOCUMENT_BYTES = 65536;
 const MAX_INFLIGHT_COMMANDS_PER_HOST = 1024;
 const COMMAND_CAPACITY_RETRY_MS = 1e3;
 const MAX_CONTEXT_BYTES = 65536;
-//#endregion
 export { COMMAND_CAPACITY_RETRY_MS, MAX_COMMANDS_PER_FRAME, MAX_CONTEXT_BYTES, MAX_EPHEMERAL_DOCUMENT_BYTES, MAX_FRAME_BODY_BYTES, MAX_INFLIGHT_COMMANDS_PER_CLIENT, MAX_INFLIGHT_COMMANDS_PER_HOST };
 
 //# sourceMappingURL=limits.js.map

package/dist/wire/meta.d.ts

@@ -1,14 +1,12 @@
-import { StatewireDocument, reviveDocumentValue } from "../document.js";
-//#region src/wire/meta.d.ts
-declare const reviveOps: (ops: unknown[]) => unknown[];
-declare const reviveResponse: <T extends {
-  payload?: unknown;
-  meta?: unknown;
+import type { StatewireDocument } from "../document.js";
+export { reviveDocumentValue as reviveValue } from "../document.js";
+export declare const reviveOps: (ops: unknown[]) => unknown[];
+export declare const reviveResponse: <T extends {
+    payload?: unknown;
+    meta?: unknown;
 }>(response: T) => T;
-declare const encodeParams: (params: readonly unknown[]) => {
-  params: unknown[];
-  meta?: StatewireDocument.MetaEntry[];
+export declare const encodeParams: (params: readonly unknown[]) => {
+    params: unknown[];
+    meta?: StatewireDocument.MetaEntry[];
 };
-//#endregion
-export { encodeParams, reviveOps, reviveResponse, reviveDocumentValue as reviveValue };
 //# sourceMappingURL=meta.d.ts.map

package/dist/wire/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","names":[],"sources":["../../src/wire/meta.ts"],"mappings":";;cAQa,YAAa;cAOb,iBAAkB;EAAY;EAAmB;GAC5D,UAAU,MACT;cAMU,eACX;EACG;EAAmB,OAAO,kBAAkB"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/wire/meta.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAoB;AAErD,OAAO,EAAE,mBAAmB,IAAI,WAAW,EAAE,uBAAoB;AAEjE,eAAO,MAAM,SAAS,GAAI,KAAK,OAAO,EAAE,KAAG,OAAO,EAK9C,CAAC;AAEL,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAC5E,UAAU,CAAC,KACV,CAIF,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,QAAQ,SAAS,OAAO,EAAE,KACzB;IAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,SAAS,EAAE,CAAA;CAK3D,CAAC"}

package/dist/wire/meta.js

@@ -1,5 +1,5 @@
 import { encodeDocument, reviveDocumentValue } from "../document.js";
-//#region src/wire/meta.ts
+// src/wire/meta.ts
 const reviveOps = (ops) => ops.map((op) => {
 	if (typeof op !== "object" || op === null || !("meta" in op)) return op;
 	const { meta, ...rest } = op;
@@ -23,7 +23,6 @@ const encodeParams = (params) => {
 		meta
 	} : { params: value };
 };
-//#endregion
 export { encodeParams, reviveOps, reviveResponse, reviveDocumentValue as reviveValue };
 
 //# sourceMappingURL=meta.js.map

package/dist/wire/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","names":["encodeDocument","reviveDocumentValue","reviveValue","StatewireDocument","reviveOps","ops","map","op","meta","rest","value","reviveResponse","payload","response","T","undefined","encodeParams","params","MetaEntry"],"sources":["../../src/wire/meta.ts"],"sourcesContent":["import {\n  encodeDocument,\n  reviveDocumentValue as reviveValue,\n} from \"../document\";\nimport type { StatewireDocument } from \"../document\";\n\nexport { reviveDocumentValue as reviveValue } from \"../document\";\n\nexport const reviveOps = (ops: unknown[]): unknown[] =>\n  ops.map((op) => {\n    if (typeof op !== \"object\" || op === null || !(\"meta\" in op)) return op;\n    const { meta, ...rest } = op as { meta: unknown; value?: unknown };\n    return { ...rest, value: reviveValue(rest.value, meta) };\n  });\n\nexport const reviveResponse = <T extends { payload?: unknown; meta?: unknown }>(\n  response: T,\n): T => {\n  if (response.meta === undefined) return response;\n  const { meta, ...rest } = response;\n  return { ...rest, payload: reviveValue(rest.payload, meta) } as T;\n};\n\nexport const encodeParams = (\n  params: readonly unknown[],\n): { params: unknown[]; meta?: StatewireDocument.MetaEntry[] } => {\n  const { value, meta } = encodeDocument(params);\n  return meta\n    ? { params: value as unknown[], meta }\n    : { params: value as unknown[] };\n};\n"],"mappings":";;AAQA,MAAaI,aAAaC,QACxBA,IAAIC,KAAKC,OAAO;CACd,IAAI,OAAOA,OAAO,YAAYA,OAAO,QAAQ,EAAE,UAAUA,KAAK,OAAOA;CACrE,MAAM,EAAEC,MAAM,GAAGC,SAASF;CAC1B,OAAO;EAAE,GAAGE;EAAMC,OAAOR,oBAAYO,KAAKC,OAAOF,IAAI;CAAE;AACzD,CAAC;AAEH,MAAaG,kBACXE,aACM;CACN,IAAIA,SAASL,SAASO,KAAAA,GAAW,OAAOF;CACxC,MAAM,EAAEL,MAAM,GAAGC,SAASI;CAC1B,OAAO;EAAE,GAAGJ;EAAMG,SAASV,oBAAYO,KAAKG,SAASJ,IAAI;CAAE;AAC7D;AAEA,MAAaQ,gBACXC,WACgE;CAChE,MAAM,EAAEP,OAAOF,SAASR,eAAeiB,MAAM;CAC7C,OAAOT,OACH;EAAES,QAAQP;EAAoBF;CAAK,IACnC,EAAES,QAAQP,MAAmB;AACnC"}
+{"version":3,"file":"meta.js","names":["encodeDocument","reviveDocumentValue","reviveValue","StatewireDocument","reviveOps","ops","map","op","meta","rest","value","reviveResponse","payload","response","T","undefined","encodeParams","params","MetaEntry","reviveValue"],"sources":["../../src/wire/meta.ts"],"sourcesContent":["import {\n  encodeDocument,\n  reviveDocumentValue as reviveValue,\n} from \"../document\";\nimport type { StatewireDocument } from \"../document\";\n\nexport { reviveDocumentValue as reviveValue } from \"../document\";\n\nexport const reviveOps = (ops: unknown[]): unknown[] =>\n  ops.map((op) => {\n    if (typeof op !== \"object\" || op === null || !(\"meta\" in op)) return op;\n    const { meta, ...rest } = op as { meta: unknown; value?: unknown };\n    return { ...rest, value: reviveValue(rest.value, meta) };\n  });\n\nexport const reviveResponse = <T extends { payload?: unknown; meta?: unknown }>(\n  response: T,\n): T => {\n  if (response.meta === undefined) return response;\n  const { meta, ...rest } = response;\n  return { ...rest, payload: reviveValue(rest.payload, meta) } as T;\n};\n\nexport const encodeParams = (\n  params: readonly unknown[],\n): { params: unknown[]; meta?: StatewireDocument.MetaEntry[] } => {\n  const { value, meta } = encodeDocument(params);\n  return meta\n    ? { params: value as unknown[], meta }\n    : { params: value as unknown[] };\n};\n"],"mappings":";;AAQA,MAAaI,aAAaC,QACxBA,IAAIC,KAAKC,OAAO;CACd,IAAI,OAAOA,OAAO,YAAYA,OAAO,QAAQ,EAAE,UAAUA,KAAK,OAAOA;CACrE,MAAM,EAAEC,MAAM,GAAGC,SAASF;CAC1B,OAAO;EAAE,GAAGE;EAAMC,OAAOR,oBAAYO,KAAKC,OAAOF,IAAI;CAAE;AACzD,CAAC;AAEH,MAAaG,kBACXE,aACM;CACN,IAAIA,SAASL,SAASO,KAAAA,GAAW,OAAOF;CACxC,MAAM,EAAEL,MAAM,GAAGC,SAASI;CAC1B,OAAO;EAAE,GAAGJ;EAAMG,SAASV,oBAAYO,KAAKG,SAASJ,IAAI;CAAE;AAC7D;AAEA,MAAaQ,gBACXC,WACgE;CAChE,MAAM,EAAEP,OAAOF,SAASR,eAAeiB,MAAM;CAC7C,OAAOT,OACH;EAAES,QAAQP;EAAoBF;CAAK,IACnC,EAAES,QAAQP,MAAmB;AACnC"}

package/dist/wire/ops.d.ts

@@ -1,15 +1,12 @@
-import { Statewire } from "../types.js";
-//#region src/wire/ops.d.ts
-type StatewirePath = readonly (string | number)[];
-declare const sanitizeValue: (value: unknown, parent?: string) => unknown;
-declare const applyOp: (root: unknown, op: Statewire.Op) => {
-  state: unknown;
-  changedPaths: StatewirePath[];
+import type { Statewire } from "../types.js";
+export type StatewirePath = readonly (string | number)[];
+export declare const sanitizeValue: (value: unknown, parent?: string) => unknown;
+export declare const applyOp: (root: unknown, op: Statewire.Op) => {
+    state: unknown;
+    changedPaths: StatewirePath[];
 };
-declare const applyOps: (state: unknown, ops: readonly unknown[]) => {
-  state: unknown;
-  changedPaths: StatewirePath[];
+export declare const applyOps: (state: unknown, ops: readonly unknown[]) => {
+    state: unknown;
+    changedPaths: StatewirePath[];
 };
-//#endregion
-export { StatewirePath, applyOp, applyOps, sanitizeValue };
 //# sourceMappingURL=ops.d.ts.map

package/dist/wire/ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ops.d.ts","names":[],"sources":["../../src/wire/ops.ts"],"mappings":";;KAIY;cAwDC,gBAAiB,gBAAgB;cAgIjC,UACX,eACA,IAAI,UAAU;EACX;EAAgB,cAAc;;cAUtB,WACX,gBACA;EAEA;EACA,cAAc"}
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../src/wire/ops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAiB;AAE1C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AAwDzD,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,SAAS,MAAM,KAAG,OACC,CAAC;AA+HlE,eAAO,MAAM,OAAO,GAClB,MAAM,OAAO,EACb,IAAI,SAAS,CAAC,EAAE,KACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,aAAa,EAAE,CAAA;CAQjD,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,OAAO,OAAO,EACd,KAAK,SAAS,OAAO,EAAE,KACtB;IACD,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,aAAa,EAAE,CAAC;CAkB/B,CAAC"}

package/dist/wire/ops.js

@@ -1,6 +1,6 @@
 import { isUnsafeKey, walkStatePath } from "../util/statePath.js";
 import { recordMutations } from "../util/recordMutations.js";
-//#region src/wire/ops.ts
+// src/wire/ops.ts
 const warnStripped = (key, parent) => {
 	if (typeof process === "undefined" || process.env["NODE_ENV"] !== "production") console.warn(`statewire: stripped unsafe key "${key}"` + (parent === void 0 ? "" : ` under "${parent}"`));
 };
@@ -130,7 +130,6 @@ const applyOps = (state, ops) => {
 		changedPaths: unboxPaths(recorded.changedPaths)
 	};
 };
-//#endregion
 export { applyOp, applyOps, sanitizeValue };
 
 //# sourceMappingURL=ops.js.map

package/dist/wire/protocol.d.ts

@@ -1,60 +1,57 @@
-//#region src/wire/protocol.d.ts
-declare namespace StatewireProtocol {
-  type Range = {
-    version: string;
-    minVersion?: string;
-  };
-  type Offer = Range & {
-    name: string;
-    optional?: boolean;
-  };
-  type Selection = {
-    version: string;
-    protocols: {
-      name: string;
-      version: string;
-      record?: "ephemeral";
-    }[];
-  };
-  type Options = {
-    wireVersion?: Range;
-    applicationProtocols?: readonly Offer[] | "*";
-    protocol?: string;
-    keyPrefixes?: Readonly<Record<string, readonly string[]>>;
-  };
-  type Definition = Range & {
-    name: string;
-    requires?: Readonly<Record<string, Range>>;
-    subprotocols?: readonly {
-      name: string;
-      record?: "ephemeral";
-    }[];
-  };
+export declare namespace StatewireProtocol {
+    type Range = {
+        version: string;
+        minVersion?: string;
+    };
+    type Offer = Range & {
+        name: string;
+        optional?: boolean;
+    };
+    type Selection = {
+        version: string;
+        protocols: {
+            name: string;
+            version: string;
+            record?: "ephemeral";
+        }[];
+    };
+    type Options = {
+        wireVersion?: Range;
+        applicationProtocols?: readonly Offer[] | "*";
+        protocol?: string;
+        keyPrefixes?: Readonly<Record<string, readonly string[]>>;
+    };
+    type Definition = Range & {
+        name: string;
+        requires?: Readonly<Record<string, Range>>;
+        subprotocols?: readonly {
+            name: string;
+            record?: "ephemeral";
+        }[];
+    };
 }
-declare const WIRE_VERSION = "2026-09-30";
-declare const DEFAULT_PROTOCOL = "default";
-declare const PROTOCOL_HEADER = "Statewire-Protocol";
-declare const VERSION_HEADER = "Statewire-Version";
-declare const protocolToken: RegExp;
-declare const validateVersion: (value: unknown) => string;
-declare const validateRange: (range: StatewireProtocol.Range) => {
-  version: string;
-  minVersion: string;
+export declare const WIRE_VERSION = "2026-09-30";
+export declare const DEFAULT_PROTOCOL = "default";
+export declare const PROTOCOL_HEADER = "Statewire-Protocol";
+export declare const VERSION_HEADER = "Statewire-Version";
+export declare const protocolToken: RegExp;
+export declare const validateVersion: (value: unknown) => string;
+export declare const validateRange: (range: StatewireProtocol.Range) => {
+    version: string;
+    minVersion: string;
 };
-declare const inRange: (value: string, range: StatewireProtocol.Range) => boolean;
-declare const protocolOffers: (options: StatewireProtocol.Options) => readonly StatewireProtocol.Offer[] | "*";
-declare const negotiationHeaders: (options: StatewireProtocol.Options) => Record<string, string>;
-declare const parseNegotiation: (headers: Headers) => Required<Pick<StatewireProtocol.Options, "wireVersion" | "applicationProtocols">>;
-declare const validateSelection: (value: unknown, options: StatewireProtocol.Options) => StatewireProtocol.Selection;
-declare const negotiateProtocols: (headers: Headers, wire: StatewireProtocol.Range, definitions: readonly StatewireProtocol.Definition[]) => StatewireProtocol.Selection | {
-  fin: {
-    reason: "protocol-error";
-    code: string;
-    status: number;
-    message: string;
-    payload?: unknown;
-  };
+export declare const inRange: (value: string, range: StatewireProtocol.Range) => boolean;
+export declare const protocolOffers: (options: StatewireProtocol.Options) => readonly StatewireProtocol.Offer[] | "*";
+export declare const negotiationHeaders: (options: StatewireProtocol.Options) => Record<string, string>;
+export declare const parseNegotiation: (headers: Headers) => Required<Pick<StatewireProtocol.Options, "wireVersion" | "applicationProtocols">>;
+export declare const validateSelection: (value: unknown, options: StatewireProtocol.Options) => StatewireProtocol.Selection;
+export declare const negotiateProtocols: (headers: Headers, wire: StatewireProtocol.Range, definitions: readonly StatewireProtocol.Definition[]) => StatewireProtocol.Selection | {
+    fin: {
+        reason: "protocol-error";
+        code: string;
+        status: number;
+        message: string;
+        payload?: unknown;
+    };
 };
-//#endregion
-export { DEFAULT_PROTOCOL, PROTOCOL_HEADER, StatewireProtocol, VERSION_HEADER, WIRE_VERSION, inRange, negotiateProtocols, negotiationHeaders, parseNegotiation, protocolOffers, protocolToken, validateRange, validateSelection, validateVersion };
 //# sourceMappingURL=protocol.d.ts.map

package/dist/wire/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","names":[],"sources":["../../src/wire/protocol.ts"],"mappings":";kBAAiB;OACH;IAAU;IAAiB;;OAC3B,QAAQ;IAAU;IAAc;;OAChC;IACV;IACA;MAAa;MAAc;MAAiB;;;OAElC;IACV,cAAc;IACd,gCAAgC;IAChC;IACA,cAAc,SAAS;;OAEb,aAAa;IACvB;IACA,WAAW,SAAS,eAAe;IACnC;MAA0B;MAAc;;;;cAI/B;cACA;cACA;cACA;cACA,eAAa;cAMb,kBAAmB;cAanB,gBAAiB,OAAO,kBAAkB;;;;cAU1C,UAAW,eAAe,OAAO,kBAAkB;cAKnD,iBAAkB,SAAS,kBAAkB,qBAAO,kBAAA;cAKpD,qBACX,SAAS,kBAAkB,YAC1B;cA6DU,mBACX,SAAS,YACR,SACD,KAAK,kBAAkB;cA0DZ,oBACX,gBACA,SAAS,kBAAkB,YAC1B,kBAAkB;cA6CR,qBACX,SAAS,SACT,MAAM,kBAAkB,OACxB,sBAAsB,kBAAkB,iBAEtC,kBAAkB;EAEhB;IACE;IACA;IACA;IACA;IACA"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/wire/protocol.ts"],"names":[],"mappings":"AAAA,yBAAiB,iBAAiB,CAAC;IACjC,KAAY,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,KAAY,KAAK,GAAG,KAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjE,KAAY,SAAS,GAAG;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,EAAE,CAAC;KACtE,CAAC;IACF,KAAY,OAAO,GAAG;QACpB,WAAW,CAAC,EAAE,KAAK,CAAC;QACpB,oBAAoB,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,GAAG,CAAC;QAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;KAC3D,CAAC;IACF,KAAY,UAAU,GAAG,KAAK,GAAG;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3C,YAAY,CAAC,EAAE,SAAS;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,EAAE,CAAC;KAClE,CAAC;CACH;AAED,eAAO,MAAM,YAAY,eAAe,CAAC;AACzC,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,eAAe,uBAAuB,CAAC;AACpD,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,eAAO,MAAM,aAAa,QAA6C,CAAC;AAMxE,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAWhD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,iBAAiB,CAAC,KAAK;;;CAQ3D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,EAAE,OAAO,iBAAiB,CAAC,KAAK,YAGpE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,iBAAiB,CAAC,OAAO,6CAG9D,CAAC;AAEJ,eAAO,MAAM,kBAAkB,GAC7B,SAAS,iBAAiB,CAAC,OAAO,KACjC,MAAM,CAAC,MAAM,EAAE,MAAM,CAgCvB,CAAC;AA6BF,eAAO,MAAM,gBAAgB,GAC3B,SAAS,OAAO,KACf,QAAQ,CACT,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,sBAAsB,CAAC,CAwDxE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,SAAS,iBAAiB,CAAC,OAAO,KACjC,iBAAiB,CAAC,SA2CpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,EAChB,MAAM,iBAAiB,CAAC,KAAK,EAC7B,aAAa,SAAS,iBAAiB,CAAC,UAAU,EAAE,KAElD,iBAAiB,CAAC,SAAS,GAC3B;IACE,GAAG,EAAE;QACH,MAAM,EAAE,gBAAgB,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CA2GP,CAAC"}

package/dist/wire/protocol.js

@@ -1,4 +1,4 @@
-//#region src/wire/protocol.ts
+// src/wire/protocol.ts
 const WIRE_VERSION = "2026-09-30";
 const DEFAULT_PROTOCOL = "default";
 const PROTOCOL_HEADER = "Statewire-Protocol";
@@ -236,7 +236,6 @@ const negotiateProtocols = (headers, wire, definitions) => {
 		})
 	};
 };
-//#endregion
 export { DEFAULT_PROTOCOL, PROTOCOL_HEADER, VERSION_HEADER, WIRE_VERSION, inRange, negotiateProtocols, negotiationHeaders, parseNegotiation, protocolOffers, protocolToken, validateRange, validateSelection, validateVersion };
 
 //# sourceMappingURL=protocol.js.map

package/dist/wire/version.d.ts

@@ -1,5 +1,2 @@
-//#region src/wire/version.d.ts
-declare const WS_SUBPROTOCOL = "statewire.v1";
-//#endregion
-export { WS_SUBPROTOCOL };
+export declare const WS_SUBPROTOCOL = "statewire.v1";
 //# sourceMappingURL=version.d.ts.map

package/dist/wire/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","names":[],"sources":["../../src/wire/version.ts"],"mappings":";cAAa"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/wire/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,iBAAiB,CAAC"}

package/dist/wire/version.js

@@ -1,6 +1,5 @@
-//#region src/wire/version.ts
+// src/wire/version.ts
 const WS_SUBPROTOCOL = "statewire.v1";
-//#endregion
 export { WS_SUBPROTOCOL };
 
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statewire",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "State over the wire: snapshot-first delta streaming and command submission for any state and any command",
   "license": "MIT",
   "repository": {
@@ -47,16 +47,16 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@assistant-ui/tap": "^0.9.6"
+    "@assistant-ui/tap": "^0.9.24"
   },
   "peerDependencies": {
     "react": "^18 || ^19"
   },
   "devDependencies": {
-    "@assistant-ui/x-buildutils": "^0.0.20",
-    "@types/react": "^19.2.17",
+    "@assistant-ui/x-buildutils": "^0.0.31",
+    "@types/react": "^19.3.0",
     "babel-plugin-react-compiler": "^1.0.0",
-    "react": "^19.2.8",
-    "vitest": "^4.1.10"
+    "react": "^19.3.1",
+    "vitest": "^5.0.5"
   }
 }

package/src/client/connection.ts

@@ -718,21 +718,19 @@ export const useLink = (
     };
     return conn;
   });
-  const [link] = useState(
-    (): RemoteLink => ({
-      get connection() {
-        return c.connection;
-      },
-      get parked() {
-        return c.parked;
-      },
-      send: (frame) => latest.current.send(c, frame),
-      storageFailed: (error) =>
-        stopForError({ connection: c, error, reason: "storage-error" }),
-      protocolFailed: (error) =>
-        stopForError({ connection: c, error, reason: "protocol-error" }),
-    }),
-  );
+  const [link] = useState((): RemoteLink => ({
+    get connection() {
+      return c.connection;
+    },
+    get parked() {
+      return c.parked;
+    },
+    send: (frame) => latest.current.send(c, frame),
+    storageFailed: (error) =>
+      stopForError({ connection: c, error, reason: "storage-error" }),
+    protocolFailed: (error) =>
+      stopForError({ connection: c, error, reason: "protocol-error" }),
+  }));
 
   const negotiation = JSON.stringify([
     props.protocol,

package/src/host/socket.ts

@@ -134,6 +134,9 @@ export type Conn = {
   contexts: Map<string, Statewire.Context>;
   documents: Map<string, StatewireHost.Document>;
   included: Set<string>;
+  onIncludedChange:
+    | ((included: readonly StatewireHostInternal.IncludedDocument[]) => void)
+    | undefined;
   view: Map<string, { doc: number; value: unknown }>;
   nextDoc: number;
   pendingApplied: Cmd[];
@@ -641,6 +644,33 @@ const diffView = (h: SocketHostState, conn: Conn): WireOp[] => {
   return ops;
 };
 
+const notifyIncluded = (conn: Conn) =>
+  conn.onIncludedChange?.(
+    [...conn.included].map(
+      (id) => JSON.parse(id) as StatewireHostInternal.IncludedDocument,
+    ),
+  );
+
+const restoredIncluded = (
+  included: readonly StatewireHostInternal.IncludedDocument[],
+): Set<string> =>
+  new Set(
+    included.map((entry) => {
+      if (
+        !Array.isArray(entry) ||
+        entry.length !== 2 ||
+        typeof entry[0] !== "string" ||
+        !(
+          entry[1] === null ||
+          (Array.isArray(entry[1]) &&
+            entry[1].every((part) => typeof part === "string"))
+        )
+      )
+        throw new TypeError("statewire: invalid restored include");
+      return documentIdentity(entry[0], entry[1] ?? undefined);
+    }),
+  );
+
 const attachOf = (h: SocketHostState, conn: Conn): StatewireHost.Attach => {
   const requireSelected = (protocol: string) => {
     const entry = conn.selection.protocols.find((p) => p.name === protocol);
@@ -700,11 +730,15 @@ const attachOf = (h: SocketHostState, conn: Conn): StatewireHost.Attach => {
     include: (protocol, key) => {
       if (requireSelected(protocol).record !== undefined)
         throw new Error(`statewire: protocol ${protocol} is not durable`);
-      conn.included.add(documentIdentity(protocol, key));
+      const id = documentIdentity(protocol, key);
+      if (conn.included.has(id)) return;
+      conn.included.add(id);
+      notifyIncluded(conn);
       markViews(h);
     },
     exclude: (protocol, key) => {
-      conn.included.delete(documentIdentity(protocol, key));
+      if (!conn.included.delete(documentIdentity(protocol, key))) return;
+      notifyIncluded(conn);
       markViews(h);
     },
   };
@@ -1343,6 +1377,7 @@ const connectAuthorized = (
       options.selection,
       undefined,
       options.authorizedAt,
+      options,
     );
     return registration?.connection ?? null;
   }
@@ -1496,6 +1531,9 @@ const connectAuthorized = (
               selection,
               frame,
               authorizedAt,
+              options.onIncludedChange === undefined
+                ? {}
+                : { onIncludedChange: options.onIncludedChange },
             );
           } catch (error) {
             if (violationReason(error) === null) throw error;
@@ -1559,7 +1597,12 @@ export const register = (
   },
   frame: ParsedFrame = { cmd: [] },
   authorizedAt?: number,
+  included: Pick<
+    StatewireHostInternal.SocketConnectOptions,
+    "included" | "onIncludedChange"
+  > = {},
 ): Registration | null => {
+  const restored = restoredIncluded(included.included ?? []);
   const refuse = (code: number, reason: string) => {
     try {
       socket.close(code, reason);
@@ -1636,7 +1679,8 @@ export const register = (
     lanes: new Map(),
     contexts: new Map(),
     documents: new Map(),
-    included: new Set(),
+    included: restored,
+    onIncludedChange: included.onIncludedChange,
     view: new Map(),
     nextDoc: 1,
     pendingApplied: [],

package/src/host-internal.ts

@@ -31,8 +31,18 @@ export namespace StatewireHostInternal {
       selection: StatewireProtocol.Selection,
       authorizedAt: number,
     ) => void;
+    /** Documents the attach had included before the adapter retained its socket; they ride the hello. */
+    included?: readonly IncludedDocument[];
+    /** Called with the attach's whole include set each time `include` or `exclude` changes it. */
+    onIncludedChange?: (included: readonly IncludedDocument[]) => void;
   };
 
+  /** A durable document an attach included: `[protocol, key]`. */
+  export type IncludedDocument = readonly [
+    protocol: string,
+    key: readonly string[] | null,
+  ];
+
   export type SocketHost = {
     /** Null means refused: the socket was told (fin and/or close) and is dead. */
     connect: (