statewire 0.16.0 → 0.17.1

package/dist/types.d.ts

@@ -1,3 +1,5 @@
+import { StatewireDocuments } from "./wire/documents.js";
+import { StatewireProtocol } from "./wire/protocol.js";
 import { StatewireClient } from "./statewire.js";
 import { StatewirePath } from "./wire/ops.js";
 //#region src/types.d.ts
@@ -9,6 +11,7 @@ declare namespace Statewire {
   }; }[keyof TCommands];
   type CommandsProxy<TCommands extends Commands> = { [K in keyof TCommands]: (...args: Parameters<TCommands[K]>) => Promise<Awaited<ReturnType<TCommands[K]>>>; };
   type CommandUpdate<TCommands extends Commands = Commands> = { [K in keyof TCommands]: {
+    readonly protocol?: string;
     method: K;
     params: Parameters<TCommands[K]>;
     seq: number;
@@ -43,6 +46,10 @@ declare namespace Statewire {
 }
 interface Statewire<TState = any, TCommands extends Statewire.Commands = Statewire.Commands> {
   state: TState;
+  documents?: StatewireDocuments.Source;
+  selection?: StatewireProtocol.Selection | undefined;
+  invoke?: (protocol: string, method: string, params: readonly unknown[]) => Promise<unknown>;
+  updateContext?: (ops: readonly unknown[]) => void;
   commands: Statewire.CommandsProxy<TCommands>;
   connection?: StatewireClient.Connection;
   source?: Statewire.StateSource;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;kBAGiB;OACH,WAAW,mBAAmB;OAE9B,QAAQ,kBAAkB,WAAW,eAC9C,WAAW;IAAc,QAAQ;IAAG,QAAQ,WAAW,UAAU;aAC5D;OAEI,cAAc,kBAAkB,eACzC,WAAW,gBACP,MAAM,WAAW,UAAU,QAC3B,QAAQ,QAAQ,WAAW,UAAU;OAGhC,cAAc,kBAAkB,WAAW,eACpD,WAAW;IACV,QAAQ;IACR,QAAQ,WAAW,UAAU;IAC7B;IACA;IACA;IACA,UAAU,gBAAgB;aAEtB;;OAGI;IACV;;IAEA,mBAAmB;;IAEnB,cAAc;;OAGJ;IACN;IAAe,MAAM;IAAe;;IACpC;IAAW,MAAM;IAAe;;IAChC;IAAc,MAAM;;OAEd;IACV,YAAY;IACZ,eAAe;;;UAIF,UACf,cACA,kBAAkB,UAAU,WAAW,UAAU;EAEjD,OAAO;EACP,UAAU,UAAU,cAAc;EAClC,aAAa,gBAAgB;EAC7B,SAAS,UAAU;;EAEnB;;EAEA;EACA;aAAkB;;;EAElB,cAAc,OAAO;;EAErB;IACE,qBAAqB,gBAAgB;IACrC,QAAQ,OAAO,gBAAgB,kBAAkB;IACjD,UAAU,OAAO,gBAAgB;;;cAuBxB,2BAA2B;WAC7B,SAAS,gBAAgB;EAEtB,YAAA,SAAS,gBAAgB"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;kBAKiB;OACH,WAAW,mBAAmB;OAE9B,QAAQ,kBAAkB,WAAW,eAC9C,WAAW;IAAc,QAAQ;IAAG,QAAQ,WAAW,UAAU;aAC5D;OAEI,cAAc,kBAAkB,eACzC,WAAW,gBACP,MAAM,WAAW,UAAU,QAC3B,QAAQ,QAAQ,WAAW,UAAU;OAGhC,cAAc,kBAAkB,WAAW,eACpD,WAAW;aACD;IACT,QAAQ;IACR,QAAQ,WAAW,UAAU;IAC7B;IACA;IACA;IACA,UAAU,gBAAgB;aAEtB;;OAGI;IACV;;IAEA,mBAAmB;;IAEnB,cAAc;;OAGJ;IACN;IAAe,MAAM;IAAe;;IACpC;IAAW,MAAM;IAAe;;IAChC;IAAc,MAAM;;OAEd;IACV,YAAY;IACZ,eAAe;;;UAIF,UACf,cACA,kBAAkB,UAAU,WAAW,UAAU;EAEjD,OAAO;EACP,YAAY,mBAAmB;EAC/B,YAAY,kBAAkB;EAC9B,UACE,kBACA,gBACA,+BACG;EACL,iBAAiB;EACjB,UAAU,UAAU,cAAc;EAClC,aAAa,gBAAgB;EAC7B,SAAS,UAAU;;EAEnB;;EAEA;EACA;aAAkB;;;EAElB,cAAc,OAAO;;EAErB;IACE,qBAAqB,gBAAgB;IACrC,QAAQ,OAAO,gBAAgB,kBAAkB;IACjD,UAAU,OAAO,gBAAgB;;;cAuBxB,2BAA2B;WAC7B,SAAS,gBAAgB;EAEtB,YAAA,SAAS,gBAAgB"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":["StatewireClient","StatewirePath","Statewire","Commands","Record","args","Command","TCommands","method","K","params","Parameters","CommandsProxy","Promise","Awaited","ReturnType","CommandUpdate","seq","status","result","failure","SendFailure","StateSource","snapshot","takeChanged","setOnChange","listener","Op","op","path","value","Changes","isChangedAt","getChangedKeys","state","TState","commands","connection","Connection","source","durableSeq","isBusy","work","isIdle","setContext","failures","list","FailedCommand","retry","entry","discard","describe","fate","code","message","cause","StatewireSendError","Error","constructor","name"],"sources":["../src/types.ts"],"sourcesContent":["import type { StatewireClient } from \"./statewire\";\nimport type { StatewirePath } from \"./wire/ops\";\n\nexport namespace Statewire {\n  export type Commands = Record<string, (...args: never[]) => unknown>;\n\n  export type Command<TCommands extends Commands = Commands> = {\n    [K in keyof TCommands]: { method: K; params: Parameters<TCommands[K]> };\n  }[keyof TCommands];\n\n  export type CommandsProxy<TCommands extends Commands> = {\n    [K in keyof TCommands]: (\n      ...args: Parameters<TCommands[K]>\n    ) => Promise<Awaited<ReturnType<TCommands[K]>>>;\n  };\n\n  export type CommandUpdate<TCommands extends Commands = Commands> = {\n    [K in keyof TCommands]: {\n      method: K;\n      params: Parameters<TCommands[K]>;\n      seq: number;\n      status: \"queued\" | \"posted\" | \"applied\" | \"settled\";\n      result?: unknown;\n      failure?: StatewireClient.SendFailure;\n    };\n  }[keyof TCommands];\n\n  /** Push-based canonical state feed a statewire hands to the client core. */\n  export type StateSource = {\n    snapshot: () => unknown;\n    /** Drain the paths changed since the last take (`[]` entry = whole state). */\n    takeChanged: () => StatewirePath[];\n    /** Synchronous, per change; the consumer owns coalescing. */\n    setOnChange: (listener: (() => void) | null) => void;\n  };\n\n  export type Op =\n    | { op: \"replace\"; path: StatewirePath; value: unknown }\n    | { op: \"add\"; path: StatewirePath; value: unknown }\n    | { op: \"remove\"; path: StatewirePath };\n\n  export type Changes = {\n    isChangedAt(path: readonly (string | number)[]): boolean;\n    getChangedKeys(path: readonly (string | number)[]): string[];\n  };\n}\n\nexport interface Statewire<\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n> {\n  state: TState;\n  commands: Statewire.CommandsProxy<TCommands>;\n  connection?: StatewireClient.Connection;\n  source?: Statewire.StateSource;\n  /** Highest command seq the server's dur flag states durably admitted — never lost, never run again — and released from the resend queue. */\n  durableSeq?: number;\n  /** Negation of the server's broadcast idle level; absent means always busy. */\n  isBusy?: boolean;\n  work?: { readonly isIdle: boolean };\n  /** Replace this client's ambient context on the server; it rides the ctx lane (no verdict). */\n  setContext?: (value: Record<string, unknown>) => void;\n  /** The retained failed-send lane; present on transports with a durable session. */\n  failures?: {\n    list: () => readonly StatewireClient.FailedCommand[];\n    retry: (entry: StatewireClient.FailedCommand) => Promise<unknown>;\n    discard: (entry: StatewireClient.FailedCommand) => void;\n  };\n}\n\nconst describe = (failure: StatewireClient.SendFailure): string => {\n  switch (failure.fate) {\n    case \"rejected\":\n      return `statewire: command rejected${failure.code ? ` (${failure.code})` : \"\"}${failure.message ? `: ${failure.message}` : \"\"}`;\n    case \"aborted\":\n      return `statewire: command aborted (${failure.cause})`;\n    case \"lost\":\n      return `statewire: command lost (${failure.cause})`;\n    case \"failed\":\n      return failure.message\n        ? `statewire: command failed: ${failure.message}`\n        : \"statewire: command failed\";\n    case \"crashed\":\n      return \"statewire: command crashed\";\n    case \"expired\":\n      return `statewire: command result expired (${failure.cause})`;\n  }\n};\n\nexport class StatewireSendError extends Error {\n  readonly failure: StatewireClient.SendFailure;\n\n  constructor(failure: StatewireClient.SendFailure) {\n    super(describe(failure));\n    this.name = \"StatewireSendError\";\n    this.failure = failure;\n  }\n}\n"],"mappings":";AAsEA,MAAMmD,YAAY/B,YAAiD;CACjE,QAAQA,QAAQgC,MAAhB;EACE,KAAK,YACH,OAAO,8BAA8BhC,QAAQiC,OAAO,KAAKjC,QAAQiC,KAAI,KAAM,KAAKjC,QAAQkC,UAAU,KAAKlC,QAAQkC,YAAY;EAC7H,KAAK,WACH,OAAO,+BAA+BlC,QAAQmC,MAAK;EACrD,KAAK,QACH,OAAO,4BAA4BnC,QAAQmC,MAAK;EAClD,KAAK,UACH,OAAOnC,QAAQkC,UACX,8BAA8BlC,QAAQkC,YACtC;EACN,KAAK,WACH,OAAO;EACT,KAAK,WACH,OAAO,sCAAsClC,QAAQmC,MAAK;CAC9D;AACF;AAEA,IAAaC,qBAAb,cAAwCC,MAAM;CAC5C;CAEAC,YAAYtC,SAAsC;EAChD,MAAM+B,SAAS/B,OAAO,CAAC;EACvB,KAAKuC,OAAO;EACZ,KAAKvC,UAAUA;CACjB;AACF"}
+{"version":3,"file":"types.js","names":["StatewireDocuments","StatewireProtocol","StatewireClient","StatewirePath","Statewire","Commands","Record","args","Command","TCommands","method","K","params","Parameters","CommandsProxy","Promise","Awaited","ReturnType","CommandUpdate","protocol","seq","status","result","failure","SendFailure","StateSource","snapshot","takeChanged","setOnChange","listener","Op","op","path","value","Changes","isChangedAt","getChangedKeys","state","TState","documents","Source","selection","Selection","invoke","updateContext","ops","commands","connection","Connection","source","durableSeq","isBusy","work","isIdle","setContext","failures","list","FailedCommand","retry","entry","discard","describe","fate","code","message","cause","StatewireSendError","Error","constructor","name"],"sources":["../src/types.ts"],"sourcesContent":["import type { StatewireDocuments } from \"./wire/documents\";\nimport type { StatewireProtocol } from \"./wire/protocol\";\nimport type { StatewireClient } from \"./statewire\";\nimport type { StatewirePath } from \"./wire/ops\";\n\nexport namespace Statewire {\n  export type Commands = Record<string, (...args: never[]) => unknown>;\n\n  export type Command<TCommands extends Commands = Commands> = {\n    [K in keyof TCommands]: { method: K; params: Parameters<TCommands[K]> };\n  }[keyof TCommands];\n\n  export type CommandsProxy<TCommands extends Commands> = {\n    [K in keyof TCommands]: (\n      ...args: Parameters<TCommands[K]>\n    ) => Promise<Awaited<ReturnType<TCommands[K]>>>;\n  };\n\n  export type CommandUpdate<TCommands extends Commands = Commands> = {\n    [K in keyof TCommands]: {\n      readonly protocol?: string;\n      method: K;\n      params: Parameters<TCommands[K]>;\n      seq: number;\n      status: \"queued\" | \"posted\" | \"applied\" | \"settled\";\n      result?: unknown;\n      failure?: StatewireClient.SendFailure;\n    };\n  }[keyof TCommands];\n\n  /** Push-based canonical state feed a statewire hands to the client core. */\n  export type StateSource = {\n    snapshot: () => unknown;\n    /** Drain the paths changed since the last take (`[]` entry = whole state). */\n    takeChanged: () => StatewirePath[];\n    /** Synchronous, per change; the consumer owns coalescing. */\n    setOnChange: (listener: (() => void) | null) => void;\n  };\n\n  export type Op =\n    | { op: \"replace\"; path: StatewirePath; value: unknown }\n    | { op: \"add\"; path: StatewirePath; value: unknown }\n    | { op: \"remove\"; path: StatewirePath };\n\n  export type Changes = {\n    isChangedAt(path: readonly (string | number)[]): boolean;\n    getChangedKeys(path: readonly (string | number)[]): string[];\n  };\n}\n\nexport interface Statewire<\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n> {\n  state: TState;\n  documents?: StatewireDocuments.Source;\n  selection?: StatewireProtocol.Selection | undefined;\n  invoke?: (\n    protocol: string,\n    method: string,\n    params: readonly unknown[],\n  ) => Promise<unknown>;\n  updateContext?: (ops: readonly unknown[]) => void;\n  commands: Statewire.CommandsProxy<TCommands>;\n  connection?: StatewireClient.Connection;\n  source?: Statewire.StateSource;\n  /** Highest command seq the server's dur flag states durably admitted — never lost, never run again — and released from the resend queue. */\n  durableSeq?: number;\n  /** Negation of the server's broadcast idle level; absent means always busy. */\n  isBusy?: boolean;\n  work?: { readonly isIdle: boolean };\n  /** Replace this client's ambient context on the server; it rides the ctx lane (no verdict). */\n  setContext?: (value: Record<string, unknown>) => void;\n  /** The retained failed-send lane; present on transports with a durable session. */\n  failures?: {\n    list: () => readonly StatewireClient.FailedCommand[];\n    retry: (entry: StatewireClient.FailedCommand) => Promise<unknown>;\n    discard: (entry: StatewireClient.FailedCommand) => void;\n  };\n}\n\nconst describe = (failure: StatewireClient.SendFailure): string => {\n  switch (failure.fate) {\n    case \"rejected\":\n      return `statewire: command rejected${failure.code ? ` (${failure.code})` : \"\"}${failure.message ? `: ${failure.message}` : \"\"}`;\n    case \"aborted\":\n      return `statewire: command aborted (${failure.cause})`;\n    case \"lost\":\n      return `statewire: command lost (${failure.cause})`;\n    case \"failed\":\n      return failure.message\n        ? `statewire: command failed: ${failure.message}`\n        : \"statewire: command failed\";\n    case \"crashed\":\n      return \"statewire: command crashed\";\n    case \"expired\":\n      return `statewire: command result expired (${failure.cause})`;\n  }\n};\n\nexport class StatewireSendError extends Error {\n  readonly failure: StatewireClient.SendFailure;\n\n  constructor(failure: StatewireClient.SendFailure) {\n    super(describe(failure));\n    this.name = \"StatewireSendError\";\n    this.failure = failure;\n  }\n}\n"],"mappings":";AAiFA,MAAM6D,YAAYtC,YAAiD;CACjE,QAAQA,QAAQuC,MAAhB;EACE,KAAK,YACH,OAAO,8BAA8BvC,QAAQwC,OAAO,KAAKxC,QAAQwC,KAAI,KAAM,KAAKxC,QAAQyC,UAAU,KAAKzC,QAAQyC,YAAY;EAC7H,KAAK,WACH,OAAO,+BAA+BzC,QAAQ0C,MAAK;EACrD,KAAK,QACH,OAAO,4BAA4B1C,QAAQ0C,MAAK;EAClD,KAAK,UACH,OAAO1C,QAAQyC,UACX,8BAA8BzC,QAAQyC,YACtC;EACN,KAAK,WACH,OAAO;EACT,KAAK,WACH,OAAO,sCAAsCzC,QAAQ0C,MAAK;CAC9D;AACF;AAEA,IAAaC,qBAAb,cAAwCC,MAAM;CAC5C;CAEAC,YAAY7C,SAAsC;EAChD,MAAMsC,SAAStC,OAAO,CAAC;EACvB,KAAK8C,OAAO;EACZ,KAAK9C,UAAUA;CACjB;AACF"}

package/dist/wire/documents.d.ts

@@ -1,8 +1,25 @@
 import { StatewirePath } from "./ops.js";
 //#region src/wire/documents.d.ts
 declare namespace StatewireDocuments {
+  type CacheEntry = {
+    version: string;
+    value: unknown;
+  };
+  type Storage = {
+    namespace?: string;
+    load: (identity: readonly string[]) => CacheEntry | undefined;
+    save: (identity: readonly string[], entry: CacheEntry) => void;
+    subscribe?: (listener: () => void) => () => void;
+  };
+  type Source = {
+    get: (protocol: string, key?: readonly string[], prefix?: readonly string[]) => unknown;
+    list: () => ReadonlyMap<number, Document>;
+    subscribe: (listener: () => void) => () => void;
+  };
   type Document = {
     key: readonly string[] | null;
+    protocol?: string;
+    main?: boolean;
     value: unknown;
   };
   type State = {
@@ -10,11 +27,17 @@ declare namespace StatewireDocuments {
     documents: ReadonlyMap<number, Document>;
   };
 }
-declare const applyDocumentOps: (previous: StatewireDocuments.State, ops: readonly unknown[]) => {
+declare const applyDocumentOps: (previous: StatewireDocuments.State, ops: readonly unknown[], protocols?: readonly {
+  name: string;
+  version: string;
+}[], strict?: boolean) => {
   mode: "mounted" | "keyless";
   documents: Map<number, StatewireDocuments.Document>;
   changedPaths: StatewirePath[];
 };
+declare const mainDocument: (state: StatewireDocuments.State, protocol: string) => StatewireDocuments.Document | undefined;
+declare const resolveDocumentKey: (key: readonly string[], prefix?: readonly string[]) => readonly string[] | undefined;
+declare const findDocument: (state: StatewireDocuments.State, protocol: string, key?: readonly string[], prefix?: readonly string[]) => StatewireDocuments.Document | undefined;
 //#endregion
-export { StatewireDocuments, applyDocumentOps };
+export { StatewireDocuments, applyDocumentOps, findDocument, mainDocument, resolveDocumentKey };
 //# sourceMappingURL=documents.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","names":[],"sources":["../../src/wire/documents.ts"],"mappings":";;kBAIiB;OACH;IAAa;IAA+B;;OAC5C;IACV;IACA,WAAW,oBAAoB;;;cAQtB,mBACX,UAAU,mBAAmB,OAC7B"}
+{"version":3,"file":"documents.d.ts","names":[],"sources":["../../src/wire/documents.ts"],"mappings":";;kBAKiB;OACH;IAAe;IAAiB;;OAChC;IACV;IACA,OAAO,gCAAgC;IACvC,OAAO,6BAA6B,OAAO;IAC3C,aAAa;;OAEH;IACV,MACE,kBACA,yBACA;IAEF,YAAY,oBAAoB;IAChC,YAAY;;OAEF;IACV;IACA;IACA;IACA;;OAEU;IACV;IACA,WAAW,oBAAoB;;;cAQtB,mBACX,UAAU,mBAAmB,OAC7B,yBACA;EAAuB;EAAc;KACrC;;;;;cAqJW,eACX,OAAO,mBAAmB,OAC1B,qBAAgB,mBAAA;cAML,qBACX,wBACA;cAQW,eACX,OAAO,mBAAmB,OAC1B,kBACA,yBACA,+BAA0B,mBAAA"}

package/dist/wire/documents.js

@@ -1,11 +1,12 @@
+import { reviveDocumentValue } from "../document.js";
+import { protocolToken } from "./protocol.js";
 import { applyOps } from "./ops.js";
-import { reviveValue } from "./meta.js";
 //#region src/wire/documents.ts
 const invalid = (message) => {
 	throw new Error(`statewire: protocol error: ${message}`);
 };
-const applyDocumentOps = (previous, ops) => {
-	let mode = previous.mode;
+const applyDocumentOps = (previous, ops, protocols, strict = false) => {
+	let mode = previous.mode ?? (protocols !== void 0 && ops.length === 0 ? "mounted" : null);
 	const documents = new Map(previous.documents);
 	const changedPaths = [];
 	for (const raw of ops) {
@@ -20,10 +21,12 @@ const applyDocumentOps = (previous, ops) => {
 			"replace",
 			"remove"
 		].includes(op.op)) {
+			if (strict) invalid("unknown context operation");
 			const { doc: _doc, ...unknown } = op;
 			applyOps(void 0, [unknown]);
 			continue;
 		}
+		if (protocols !== void 0 && mode === null && op.op !== "mount") invalid("negotiated state must start with mounts");
 		if (mode === null) {
 			if (op.op === "mount") mode = "mounted";
 			else if (op.op === "replace" && doc === 0 && Array.isArray(op.path) && op.path.length === 0 && "value" in op) {
@@ -37,22 +40,32 @@ const applyDocumentOps = (previous, ops) => {
 		if (mode === "keyless" && (doc !== 0 || op.op === "mount" || op.op === "unmount")) invalid("keyless mode only supports mutations of document 0");
 		if (op.op === "mount") {
 			if (documents.has(doc)) invalid("document is already mounted");
-			if (!Array.isArray(op.key) || !op.key.every((key) => typeof key === "string") || !("value" in op)) invalid("mount requires a key array and value");
+			if (op.key !== void 0 && (!Array.isArray(op.key) || !op.key.every((key) => typeof key === "string")) || !("value" in op)) invalid("mount requires value and an optional key array");
+			if (op.protocol !== void 0 && (typeof op.protocol !== "string" || !protocolToken.test(op.protocol) || op.protocol === "*")) invalid("invalid mount protocol");
+			if (protocols !== void 0 && !protocols.some((p) => p.name === op.protocol)) invalid("mount protocol was not negotiated");
+			if (op.main !== void 0 && typeof op.main !== "boolean") invalid("main must be boolean");
+			if (op.main === true && [...documents.values()].some((d) => d.protocol === op.protocol && d.main)) invalid("protocol already has a main document");
+			if (op.key !== void 0 && [...documents.values()].some((d) => d.protocol === op.protocol && JSON.stringify(d.key) === JSON.stringify(op.key))) invalid("protocol document key is already mounted");
 			documents.set(doc, {
-				key: op.key,
-				value: op.meta === void 0 ? op.value : reviveValue(op.value, op.meta)
+				key: op.key === void 0 ? null : op.key,
+				...op.protocol === void 0 ? {} : { protocol: op.protocol },
+				...op.main === void 0 ? {} : { main: op.main },
+				value: op.meta === void 0 ? op.value : reviveDocumentValue(op.value, op.meta, { rejectUnknown: strict })
 			});
 			if (doc === 0) changedPaths.push([]);
 		} else if (op.op === "unmount") {
+			const document = documents.get(doc);
+			if (protocols !== void 0 && document !== void 0 && !protocols.some((p) => p.name === document.protocol)) invalid("document protocol was not negotiated");
 			if (!documents.delete(doc)) invalid("document is not mounted");
 			if (doc === 0) changedPaths.push([]);
 		} else if (op.op === "add" || op.op === "replace" || op.op === "remove") {
 			const document = documents.get(doc);
+			if (protocols !== void 0 && document !== void 0 && !protocols.some((p) => p.name === document.protocol)) invalid("document protocol was not negotiated");
 			if (!document) invalid("document is not mounted");
 			if (!Array.isArray(op.path) || !op.path.every((part) => typeof part === "string" || typeof part === "number" && Number.isSafeInteger(part) && part >= 0)) invalid("operation requires a valid path");
 			if (op.op !== "remove" && !("value" in op)) invalid("operation requires a value");
 			const { doc: _doc, meta, ...mutation } = op;
-			if (meta !== void 0) mutation.value = reviveValue(mutation.value, meta);
+			if (meta !== void 0) mutation.value = reviveDocumentValue(mutation.value, meta, { rejectUnknown: strict });
 			const applied = applyOps(document.value, [mutation]);
 			documents.set(doc, {
 				...document,
@@ -68,7 +81,14 @@ const applyDocumentOps = (previous, ops) => {
 		changedPaths
 	};
 };
+const mainDocument = (state, protocol) => [...state.documents.values()].find((document) => document.protocol === protocol && document.main);
+const resolveDocumentKey = (key, prefix) => key[0] === "." ? prefix === void 0 ? void 0 : [...prefix, ...key.slice(1)] : key;
+const findDocument = (state, protocol, key, prefix) => {
+	if (key === void 0) return mainDocument(state, protocol);
+	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 };
+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","StatewirePath","StatewireDocuments","Document","key","value","State","mode","documents","ReadonlyMap","invalid","message","Error","applyDocumentOps","previous","ops","Map","changedPaths","raw","Array","isArray","op","Record","doc","undefined","Number","isSafeInteger","includes","_doc","unknown","path","length","set","has","every","meta","push","delete","document","get","part","mutation","applied","state"],"sources":["../../src/wire/documents.ts"],"sourcesContent":["import { applyOps } from \"./ops\";\nimport { reviveValue } from \"./meta\";\nimport type { StatewirePath } from \"./ops\";\n\nexport namespace StatewireDocuments {\n  export type Document = { key: readonly string[] | null; value: unknown };\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) => {\n  let mode = previous.mode;\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      const { doc: _doc, ...unknown } = op;\n      applyOps(undefined, [unknown]);\n      continue;\n    }\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        !Array.isArray(op.key) ||\n        !op.key.every((key) => typeof key === \"string\") ||\n        !(\"value\" in op)\n      ) {\n        invalid(\"mount requires a key array and value\");\n      }\n      documents.set(doc, {\n        key: op.key,\n        value:\n          op.meta === undefined ? op.value : reviveValue(op.value, op.meta),\n      });\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"unmount\") {\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 (!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      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"],"mappings":";;;AAYA,MAAMW,WAAuCC,YAAY;CACvD,MAAM,IAAIC,MAAM,8BAA8BD,SAAS;AACzD;AAEA,MAAaE,oBACXC,UACAC,QACG;CACH,IAAIR,OAAOO,SAASP;CACpB,MAAMC,YAAY,IAAIQ,IAAIF,SAASN,SAAS;CAC5C,MAAMS,eAAgC,CAAA;CACtC,KAAK,MAAMC,OAAOH,KAAK;EACrB,IAAI,OAAOG,QAAQ,YAAYA,QAAQ,QAAQC,MAAMC,QAAQF,GAAG,GAC9DR,QAAQ,6BAA6B;EAEvC,MAAMW,KAAKH;EACX,MAAMK,MAAMF,GAAGE,QAAQC,KAAAA,IAAY,IAAIH,GAAGE;EAC1C,IAAI,OAAOA,QAAQ,YAAY,CAACE,OAAOC,cAAcH,GAAG,KAAKA,MAAM,GACjEb,QAAQ,wCAAwC;EAElD,IACE,CAAC;GAAC;GAAS;GAAW;GAAO;GAAW;EAAQ,CAAC,CAACiB,SAChDN,GAAGA,EACL,GACA;GACA,MAAM,EAAEE,KAAKK,MAAM,GAAGC,YAAYR;GAClCtB,SAASyB,KAAAA,GAAW,CAACK,OAAO,CAAC;GAC7B;EACF;EACA,IAAItB,SAAS,MAAM;GACjB,IAAIc,GAAGA,OAAO,SAASd,OAAO;QACzB,IACHc,GAAGA,OAAO,aACVE,QAAQ,KACRJ,MAAMC,QAAQC,GAAGS,IAAI,KACrBT,GAAGS,KAAKC,WAAW,KACnB,WAAWV,IACX;IACAd,OAAO;IACPC,UAAUwB,IAAI,GAAG;KAAE5B,KAAK;KAAMC,OAAOmB,KAAAA;IAAU,CAAC;GAClD,OACEd,QACE,yEACF;EACJ;EACA,IACEH,SAAS,cACRgB,QAAQ,KAAKF,GAAGA,OAAO,WAAWA,GAAGA,OAAO,YAE7CX,QAAQ,oDAAoD;EAE9D,IAAIW,GAAGA,OAAO,SAAS;GACrB,IAAIb,UAAUyB,IAAIV,GAAG,GAAGb,QAAQ,6BAA6B;GAC7D,IACE,CAACS,MAAMC,QAAQC,GAAGjB,GAAG,KACrB,CAACiB,GAAGjB,IAAI8B,OAAO9B,QAAQ,OAAOA,QAAQ,QAAQ,KAC9C,EAAE,WAAWiB,KAEbX,QAAQ,sCAAsC;GAEhDF,UAAUwB,IAAIT,KAAK;IACjBnB,KAAKiB,GAAGjB;IACRC,OACEgB,GAAGc,SAASX,KAAAA,IAAYH,GAAGhB,QAAQL,YAAYqB,GAAGhB,OAAOgB,GAAGc,IAAI;GACpE,CAAC;GACD,IAAIZ,QAAQ,GAAGN,aAAamB,KAAK,CAAA,CAAE;EACrC,OAAO,IAAIf,GAAGA,OAAO,WAAW;GAC9B,IAAI,CAACb,UAAU6B,OAAOd,GAAG,GAAGb,QAAQ,yBAAyB;GAC7D,IAAIa,QAAQ,GAAGN,aAAamB,KAAK,CAAA,CAAE;EACrC,OAAO,IAAIf,GAAGA,OAAO,SAASA,GAAGA,OAAO,aAAaA,GAAGA,OAAO,UAAU;GACvE,MAAMiB,WAAW9B,UAAU+B,IAAIhB,GAAG;GAClC,IAAI,CAACe,UAAU5B,QAAQ,yBAAyB;GAChD,IACE,CAACS,MAAMC,QAAQC,GAAGS,IAAI,KACtB,CAACT,GAAGS,KAAKI,OACNM,SACC,OAAOA,SAAS,YACf,OAAOA,SAAS,YACff,OAAOC,cAAcc,IAAI,KACzBA,QAAQ,CACd,GAEA9B,QAAQ,iCAAiC;GAE3C,IAAIW,GAAGA,OAAO,YAAY,EAAE,WAAWA,KACrCX,QAAQ,4BAA4B;GACtC,MAAM,EAAEa,KAAKK,MAAMO,MAAM,GAAGM,aAAapB;GACzC,IAAIc,SAASX,KAAAA,GACXiB,SAASpC,QAAQL,YAAYyC,SAASpC,OAAO8B,IAAI;GACnD,MAAMO,UAAU3C,SAASuC,SAASjC,OAAO,CAACoC,QAAQ,CAAC;GACnDjC,UAAUwB,IAAIT,KAAK;IAAE,GAAGe;IAAUjC,OAAOqC,QAAQC;GAAM,CAAC;GACxD,IAAIpB,QAAQ,GAAGN,aAAamB,KAAK,GAAGM,QAAQzB,YAAY;EAC1D;CACF;CACA,IAAIV,SAAS,MAAMG,QAAQ,wBAAwB;CACnD,OAAO;EAAEH;EAAMC;EAAWS;CAAa;AACzC"}
+{"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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"}

package/dist/wire/meta.d.ts

@@ -1,29 +1,14 @@
+import { StatewireDocument, reviveDocumentValue } from "../document.js";
 //#region src/wire/meta.d.ts
-type StatewireMetaEntry = {
-  path: (string | number)[];
-  type: string;
-};
-/** Revive meta-typed locations inside a wire value (in place). Clients skip
- * unknown types; hosts pass `rejectUnknown` to fault on them instead. */
-declare const reviveValue: (value: unknown, meta: unknown, { rejectUnknown }?: {
-  rejectUnknown?: boolean | undefined;
-}) => unknown;
 declare const reviveOps: (ops: unknown[]) => unknown[];
 declare const reviveResponse: <T extends {
   payload?: unknown;
   meta?: unknown;
 }>(response: T) => T;
-/** Encode Date instances inside command params as canonical ISO strings,
- * recording their paths (starting at the param index) in meta. */
 declare const encodeParams: (params: readonly unknown[]) => {
   params: unknown[];
-  meta?: StatewireMetaEntry[];
-};
-/** Encode Date instances inside a wire value, recording their paths in meta. */
-declare const encodeValue: (value: unknown) => {
-  value: unknown;
-  meta?: StatewireMetaEntry[];
+  meta?: StatewireDocument.MetaEntry[];
 };
 //#endregion
-export { StatewireMetaEntry, encodeParams, encodeValue, reviveOps, reviveResponse, reviveValue };
+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":";KAEY;EACV;EACA;;;;cAiBW,cACX,gBACA,iBACA;;;cAkCW,YAAa;cAOb,iBAAkB;EAAY;EAAmB;GAC5D,UAAU,MACT;;;cA+BU,eACX;EACG;EAAmB,OAAO;;;cAOlB,cACX;EACG;EAAgB,OAAO"}
+{"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"}

package/dist/wire/meta.js

@@ -1,36 +1,11 @@
-import { walkStatePath } from "../util/statePath.js";
+import { encodeDocument, reviveDocumentValue } from "../document.js";
 //#region src/wire/meta.ts
-const fault = (message) => {
-	throw new Error(`statewire: protocol error: ${message}`);
-};
-const isPath = (path) => Array.isArray(path) && path.every((seg) => typeof seg === "string" || typeof seg === "number" && Number.isInteger(seg));
-/** Revive meta-typed locations inside a wire value (in place). Clients skip
-* unknown types; hosts pass `rejectUnknown` to fault on them instead. */
-const reviveValue = (value, meta, { rejectUnknown = false } = {}) => {
-	if (!Array.isArray(meta)) return fault("meta must be an array");
-	for (const entry of meta) {
-		const path = typeof entry === "object" && entry !== null ? entry.path : null;
-		if (!isPath(path)) return fault("meta entry must carry a path array");
-		if (entry.type !== "date") {
-			if (rejectUnknown) return fault(`unknown meta type: ${String(entry.type)}`);
-			continue;
-		}
-		const walked = walkStatePath(value, path, "resolve");
-		if (walked === void 0) return fault(`meta path ${path.join(".")} does not resolve`);
-		if (typeof walked.leaf !== "string") return fault(`meta path ${path.join(".")} must name a string`);
-		const date = new Date(walked.leaf);
-		if (!/(?:T| )\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})$/i.test(walked.leaf) || Number.isNaN(date.getTime())) return fault(`invalid date at meta path ${path.join(".")}`);
-		if (walked.parent === void 0) return date;
-		walked.parent[walked.key] = date;
-	}
-	return value;
-};
 const reviveOps = (ops) => ops.map((op) => {
 	if (typeof op !== "object" || op === null || !("meta" in op)) return op;
 	const { meta, ...rest } = op;
 	return {
 		...rest,
-		value: reviveValue(rest.value, meta)
+		value: reviveDocumentValue(rest.value, meta)
 	};
 });
 const reviveResponse = (response) => {
@@ -38,41 +13,17 @@ const reviveResponse = (response) => {
 	const { meta, ...rest } = response;
 	return {
 		...rest,
-		payload: reviveValue(rest.payload, meta)
+		payload: reviveDocumentValue(rest.payload, meta)
 	};
 };
-const walkDates = (node, path, meta) => {
-	if (node instanceof Date) {
-		meta.push({
-			path,
-			type: "date"
-		});
-		return node.toISOString();
-	}
-	if (Array.isArray(node)) return node.map((item, i) => walkDates(item, [...path, i], meta));
-	if (typeof node === "object" && node !== null) return Object.fromEntries(Object.keys(node).map((key) => [key, walkDates(node[key], [...path, key], meta)]));
-	return node;
-};
-/** Encode Date instances inside command params as canonical ISO strings,
-* recording their paths (starting at the param index) in meta. */
 const encodeParams = (params) => {
-	const meta = [];
-	const encoded = params.map((param, i) => walkDates(param, [i], meta));
-	return meta.length > 0 ? {
-		params: encoded,
-		meta
-	} : { params: encoded };
-};
-/** Encode Date instances inside a wire value, recording their paths in meta. */
-const encodeValue = (value) => {
-	const meta = [];
-	const encoded = walkDates(value, [], meta);
-	return meta.length > 0 ? {
-		value: encoded,
+	const { value, meta } = encodeDocument(params);
+	return meta ? {
+		params: value,
 		meta
-	} : { value: encoded };
+	} : { params: value };
 };
 //#endregion
-export { encodeParams, encodeValue, reviveOps, reviveResponse, reviveValue };
+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":["walkStatePath","StatewireMetaEntry","path","type","fault","message","Error","isPath","Array","isArray","every","seg","Number","isInteger","reviveValue","value","meta","rejectUnknown","entry","String","walked","undefined","join","leaf","date","Date","test","isNaN","getTime","parent","Record","key","reviveOps","ops","map","op","rest","reviveResponse","payload","response","T","walkDates","node","push","toISOString","item","i","Object","fromEntries","keys","encodeParams","params","encoded","param","length","encodeValue"],"sources":["../../src/wire/meta.ts"],"sourcesContent":["import { walkStatePath } from \"../util/statePath\";\n\nexport type StatewireMetaEntry = {\n  path: (string | number)[];\n  type: string;\n};\n\nconst fault = (message: string): never => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nconst isPath = (path: unknown): path is (string | number)[] =>\n  Array.isArray(path) &&\n  path.every(\n    (seg) =>\n      typeof seg === \"string\" ||\n      (typeof seg === \"number\" && Number.isInteger(seg)),\n  );\n\n/** Revive meta-typed locations inside a wire value (in place). Clients skip\n * unknown types; hosts pass `rejectUnknown` to fault on them instead. */\nexport const reviveValue = (\n  value: unknown,\n  meta: unknown,\n  { rejectUnknown = false } = {},\n): unknown => {\n  if (!Array.isArray(meta)) return fault(\"meta must be an array\");\n  for (const entry of meta as { path?: unknown; type?: unknown }[]) {\n    const path =\n      typeof entry === \"object\" && entry !== null ? entry.path : null;\n    if (!isPath(path)) return fault(\"meta entry must carry a path array\");\n    if (entry.type !== \"date\") {\n      if (rejectUnknown)\n        return fault(`unknown meta type: ${String(entry.type)}`);\n      continue;\n    }\n    const walked = walkStatePath(value, path, \"resolve\");\n    if (walked === undefined) {\n      return fault(`meta path ${path.join(\".\")} does not resolve`);\n    }\n    if (typeof walked.leaf !== \"string\") {\n      return fault(`meta path ${path.join(\".\")} must name a string`);\n    }\n    const date = new Date(walked.leaf);\n    if (\n      !/(?:T| )\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})$/i.test(\n        walked.leaf,\n      ) ||\n      Number.isNaN(date.getTime())\n    ) {\n      return fault(`invalid date at meta path ${path.join(\".\")}`);\n    }\n    if (walked.parent === undefined) return date;\n    (walked.parent as Record<string | number, unknown>)[walked.key] = date;\n  }\n  return value;\n};\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\nconst walkDates = (\n  node: unknown,\n  path: (string | number)[],\n  meta: StatewireMetaEntry[],\n): unknown => {\n  if (node instanceof Date) {\n    meta.push({ path, type: \"date\" });\n    return node.toISOString();\n  }\n  if (Array.isArray(node)) {\n    return node.map((item, i) => walkDates(item, [...path, i], meta));\n  }\n  if (typeof node === \"object\" && node !== null) {\n    return Object.fromEntries(\n      Object.keys(node).map((key) => [\n        key,\n        walkDates((node as Record<string, unknown>)[key], [...path, key], meta),\n      ]),\n    );\n  }\n  return node;\n};\n\n/** Encode Date instances inside command params as canonical ISO strings,\n * recording their paths (starting at the param index) in meta. */\nexport const encodeParams = (\n  params: readonly unknown[],\n): { params: unknown[]; meta?: StatewireMetaEntry[] } => {\n  const meta: StatewireMetaEntry[] = [];\n  const encoded = params.map((param, i) => walkDates(param, [i], meta));\n  return meta.length > 0 ? { params: encoded, meta } : { params: encoded };\n};\n\n/** Encode Date instances inside a wire value, recording their paths in meta. */\nexport const encodeValue = (\n  value: unknown,\n): { value: unknown; meta?: StatewireMetaEntry[] } => {\n  const meta: StatewireMetaEntry[] = [];\n  const encoded = walkDates(value, [], meta);\n  return meta.length > 0 ? { value: encoded, meta } : { value: encoded };\n};\n"],"mappings":"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"}
+{"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"}

package/dist/wire/ops.js

@@ -1,5 +1,5 @@
-import { recordMutations } from "../util/recordMutations.js";
 import { isUnsafeKey, walkStatePath } from "../util/statePath.js";
+import { recordMutations } from "../util/recordMutations.js";
 //#region 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}"`));

package/dist/wire/protocol.d.ts

@@ -0,0 +1,55 @@
+//#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;
+    }[];
+  };
+  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>>;
+  };
+}
+declare const WIRE_VERSION = "2026-09-07";
+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;
+};
+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;
+  };
+};
+//#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

@@ -0,0 +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;;;OAEjB;IACV,cAAc;IACd,gCAAgC;IAChC;IACA,cAAc,SAAS;;OAEb,aAAa;IACvB;IACA,WAAW,SAAS,eAAe;;;cAI1B;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;cAqCR,qBACX,SAAS,SACT,MAAM,kBAAkB,OACxB,sBAAsB,kBAAkB,iBAEtC,kBAAkB;EAEhB;IACE;IACA;IACA;IACA;IACA"}