statewire 0.0.1 → 0.0.2

package/dist/wire/meta.js

@@ -1,3 +1,4 @@
+import { walkStatePath } from "../util/statePath.js";
 //#region src/wire/meta.ts
 const fault = (message) => {
 	throw new Error(`statewire: protocol error: ${message}`);
@@ -11,21 +12,13 @@ const reviveValue = (value, 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") continue;
-		let parent = null;
-		let key = "";
-		let node = value;
-		for (const seg of path) {
-			parent = node;
-			key = seg;
-			if (typeof seg === "string" && typeof node === "object" && node !== null && !Array.isArray(node) && Object.hasOwn(node, seg)) node = node[seg];
-			else if (typeof seg === "number" && Array.isArray(node) && seg >= 0 && seg < node.length) node = node[seg];
-			else return fault(`meta path ${path.join(".")} does not resolve`);
-		}
-		if (typeof node !== "string") return fault(`meta path ${path.join(".")} must name a string`);
-		const date = new Date(node);
+		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 (Number.isNaN(date.getTime())) return fault(`invalid date at meta path ${path.join(".")}`);
-		if (parent === null) return date;
-		parent[key] = date;
+		if (walked.parent === void 0) return date;
+		walked.parent[walked.key] = date;
 	}
 	return value;
 };
@@ -45,29 +38,38 @@ const reviveResponse = (response) => {
 		payload: reviveValue(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 walk = (node, path) => {
-		if (node instanceof Date) {
-			meta.push({
-				path,
-				type: "date"
-			});
-			return node.toISOString();
-		}
-		if (Array.isArray(node)) return node.map((item, i) => walk(item, [...path, i]));
-		if (typeof node === "object" && node !== null) return Object.fromEntries(Object.keys(node).map((key) => [key, walk(node[key], [...path, key])]));
-		return node;
-	};
-	const encoded = params.map((param, i) => walk(param, [i]));
+	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,
+		meta
+	} : { value: encoded };
+};
 //#endregion
-export { encodeParams, reviveOps, reviveResponse, reviveValue };
+export { encodeParams, encodeValue, reviveOps, reviveResponse, reviveValue };
 
 //# sourceMappingURL=meta.js.map

package/dist/wire/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","names":["StatewireMetaEntry","path","type","fault","message","Error","isPath","Array","isArray","every","seg","Number","isInteger","reviveValue","value","meta","entry","parent","key","node","Object","hasOwn","Record","length","join","date","Date","isNaN","getTime","reviveOps","ops","map","op","rest","reviveResponse","payload","response","T","undefined","encodeParams","params","walk","push","toISOString","item","i","fromEntries","keys","encoded","param"],"sources":["../../src/wire/meta.ts"],"sourcesContent":["export 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). Unknown types\n * are skipped; a path that does not resolve to a valid target faults. */\nexport const reviveValue = (value: unknown, meta: unknown): 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\") continue;\n    let parent: unknown = null;\n    let key: string | number = \"\";\n    let node = value;\n    for (const seg of path) {\n      parent = node;\n      key = seg;\n      if (\n        typeof seg === \"string\" &&\n        typeof node === \"object\" &&\n        node !== null &&\n        !Array.isArray(node) &&\n        Object.hasOwn(node, seg)\n      ) {\n        node = (node as Record<string, unknown>)[seg];\n      } else if (\n        typeof seg === \"number\" &&\n        Array.isArray(node) &&\n        seg >= 0 &&\n        seg < node.length\n      ) {\n        node = node[seg];\n      } else {\n        return fault(`meta path ${path.join(\".\")} does not resolve`);\n      }\n    }\n    if (typeof node !== \"string\") {\n      return fault(`meta path ${path.join(\".\")} must name a string`);\n    }\n    const date = new Date(node);\n    if (Number.isNaN(date.getTime())) {\n      return fault(`invalid date at meta path ${path.join(\".\")}`);\n    }\n    if (parent === null) return date;\n    (parent as Record<string | number, unknown>)[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\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 walk = (node: unknown, path: (string | number)[]): 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) => walk(item, [...path, i]));\n    }\n    if (typeof node === \"object\" && node !== null) {\n      return Object.fromEntries(\n        Object.keys(node).map((key) => [\n          key,\n          walk((node as Record<string, unknown>)[key], [...path, key]),\n        ]),\n      );\n    }\n    return node;\n  };\n  const encoded = params.map((param, i) => walk(param, [i]));\n  return meta.length > 0 ? { params: encoded, meta } : { params: encoded };\n};\n"],"mappings":"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"}
+{"version":3,"file":"meta.js","names":["walkStatePath","StatewireMetaEntry","path","type","fault","message","Error","isPath","Array","isArray","every","seg","Number","isInteger","reviveValue","value","meta","entry","walked","undefined","join","leaf","date","Date","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). Unknown types\n * are skipped; a path that does not resolve to a valid target faults. */\nexport const reviveValue = (value: unknown, meta: unknown): 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\") continue;\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 (Number.isNaN(date.getTime())) {\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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"}

package/dist/wire/ops.d.ts

@@ -1,27 +1,9 @@
+import { Statewire } from "../types.js";
 //#region src/wire/ops.d.ts
 type StatewirePath = readonly (string | number)[];
-type StatewireOp = {
-  op: "replace";
-  path: StatewirePath;
-  value: unknown;
-} | {
-  op: "add";
-  path: StatewirePath;
-  value: unknown;
-} | {
-  op: "append";
-  path: StatewirePath;
-  value: unknown;
-} | {
-  op: "remove";
-  path: StatewirePath;
-} | {
-  op: "event";
-  value: object;
-};
 declare const sanitizeValue: (value: unknown, parent?: string) => unknown;
-type MutableOp = Extract<StatewireOp, {
-  op: "replace" | "add" | "append" | "remove";
+type MutableOp = Extract<Statewire.Op, {
+  op: "replace" | "add" | "remove";
 }>;
 declare const applyOp: (root: unknown, op: MutableOp) => {
   state: unknown;
@@ -29,12 +11,9 @@ declare const applyOp: (root: unknown, op: MutableOp) => {
 };
 declare const applyOps: (state: unknown, ops: readonly unknown[]) => {
   state: unknown;
-  events: {
-    event: unknown;
-    state: unknown;
-  }[];
+  events: unknown[];
   changedPaths: StatewirePath[];
 };
 //#endregion
-export { StatewireOp, StatewirePath, applyOp, applyOps, sanitizeValue };
+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":";KAEY;KAEA;EACN;EAAe,MAAM;EAAe;;EACpC;EAAW,MAAM;EAAe;;EAChC;EAAc,MAAM;EAAe;;EACnC;EAAc,MAAM;;EACpB;EAAa;;cAiBN,gBAAiB,gBAAgB;KAYzC,YAAY,QACf;EACE;;cA6GS,UACX,eACA,IAAI;EACD;EAAgB,cAAc;;cAUtB,WACX,gBACA;EAEA;EACA;IAAU;IAAgB;;EAC1B,cAAc"}
+{"version":3,"file":"ops.d.ts","names":[],"sources":["../../src/wire/ops.ts"],"mappings":";;KAIY;cAwDC,gBAAiB,gBAAgB;KAGzC,YAAY,QAAQ,UAAU;EAAM;;cAkG5B,UACX,eACA,IAAI;EACD;EAAgB,cAAc;;cAUtB,WACX,gBACA;EAEA;EACA;EACA,cAAc"}

package/dist/wire/ops.js

@@ -1,80 +1,81 @@
-import { recordMutations } from "../client/optimistic.js";
+import { recordMutations } from "../util/recordMutations.js";
+import { isUnsafeKey, walkStatePath } from "../util/statePath.js";
 //#region src/wire/ops.ts
-const isUnsafe = (key, parent) => key === "__proto__" || key === "prototype" && parent === "constructor";
 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}"`));
 };
-const sanitizeValue = (value, parent) => {
-	if (typeof value !== "object" || value === null) return value;
+const unserializable = (kind, path) => {
+	throw new Error(`statewire: cannot serialize ${kind}` + (path.length === 0 ? "" : ` at ${path.join(".")}`));
+};
+const sanitizeAt = (value, parent, path) => {
 	if (value instanceof Date) return new Date(value.getTime());
-	if (Array.isArray(value)) return value.map((item) => sanitizeValue(item));
-	const out = {};
-	for (const key of Object.keys(value)) if (isUnsafe(key, parent)) warnStripped(key, parent);
-	else out[key] = sanitizeValue(value[key], key);
-	return out;
+	if (Array.isArray(value)) return value.map((item, index) => {
+		if (item === void 0) unserializable("undefined", [...path, index]);
+		return sanitizeAt(item, void 0, [...path, index]);
+	});
+	if (typeof value === "object" && value !== null) {
+		const out = {};
+		for (const key of Object.keys(value)) {
+			if (isUnsafeKey(key, parent)) {
+				warnStripped(key, parent);
+				continue;
+			}
+			const item = value[key];
+			if (item === void 0) continue;
+			out[key] = sanitizeAt(item, key, [...path, key]);
+		}
+		return out;
+	}
+	if (typeof value === "function") unserializable("function", path);
+	return value;
 };
+const sanitizeValue = (value, parent) => sanitizeAt(value, parent, parent === void 0 ? [] : [parent]);
 const invalid = (op) => /* @__PURE__ */ new Error(`Statewire cannot apply ${op.op} at path: ${op.path.join(".")}`);
-const appended = (current, op) => {
-	if (typeof current !== "string" || typeof op.value !== "string") throw invalid(op);
-	return current + op.value;
+const insertedText = (current, op, offset) => {
+	if (typeof op.value !== "string" || offset > current.length) throw invalid(op);
+	return current.slice(0, offset) + op.value + current.slice(offset);
 };
-const applyAtRoot = (box, op) => {
-	if (op.op === "replace") box.state = sanitizeValue(op.value);
-	else if (op.op === "append") box.state = appended(box.state, op);
-	else throw invalid(op);
+const applyAdd = (box, op) => {
+	const offset = op.path[op.path.length - 1];
+	const walked = walkStatePath(box.state, op.path.slice(0, -1), "resolve");
+	if (walked === void 0 || typeof offset !== "number" || !Number.isInteger(offset) || offset < 0) throw invalid(op);
+	const target = walked.leaf;
+	if (Array.isArray(target)) {
+		if (offset > target.length) throw invalid(op);
+		target.splice(offset, 0, sanitizeValue(op.value));
+	} else if (typeof target === "string") {
+		const next = insertedText(target, op, offset);
+		if (op.path.length === 1) box.state = next;
+		else walked.parent[walked.key] = next;
+	} else throw invalid(op);
 };
 const applyInList = (list, index, op) => {
-	if (op.op === "replace") {
-		if (index >= list.length) throw invalid(op);
-		list[index] = sanitizeValue(op.value);
-	} else if (op.op === "add") {
-		if (index > list.length) throw invalid(op);
-		list.splice(index, 0, sanitizeValue(op.value));
-	} else if (op.op === "append") {
-		if (index >= list.length) throw invalid(op);
-		list[index] = appended(list[index], op);
-	} else {
-		if (index >= list.length) throw invalid(op);
-		list.splice(index, 1);
-	}
+	if (index >= list.length) throw invalid(op);
+	if (op.op === "replace") list[index] = sanitizeValue(op.value);
+	else list.splice(index, 1);
 };
 const applyInObject = (obj, key, op) => {
-	const exists = Object.hasOwn(obj, key);
 	if (op.op === "replace") obj[key] = sanitizeValue(op.value, key);
-	else if (op.op === "append") obj[key] = appended(exists ? obj[key] : void 0, op);
-	else if (op.op === "remove") {
-		if (!exists) throw invalid(op);
+	else {
+		if (!Object.hasOwn(obj, key)) throw invalid(op);
 		delete obj[key];
-	} else throw invalid(op);
+	}
 };
 const applyOpToDraft = (box, op) => {
-	if (op.path.length === 0) {
-		applyAtRoot(box, op);
+	if (op.op === "add") {
+		if (op.path.length === 0) throw invalid(op);
+		applyAdd(box, op);
 		return;
 	}
-	let node = box.state;
-	for (let depth = 0; depth < op.path.length; depth++) {
-		const key = op.path[depth];
-		const last = depth === op.path.length - 1;
-		if (typeof key === "number") {
-			if (!Array.isArray(node) || !Number.isInteger(key) || key < 0) throw invalid(op);
-			if (last) {
-				applyInList(node, key, op);
-				return;
-			}
-			if (key >= node.length) throw invalid(op);
-			node = node[key];
-		} else {
-			if (isUnsafe(key, op.path[depth - 1]) || typeof node !== "object" || node === null || Array.isArray(node)) throw invalid(op);
-			const obj = node;
-			if (last) {
-				applyInObject(obj, key, op);
-				return;
-			}
-			if (!Object.hasOwn(obj, key)) throw invalid(op);
-			node = obj[key];
-		}
+	if (op.path.length === 0) {
+		if (op.op !== "replace") throw invalid(op);
+		box.state = sanitizeValue(op.value);
+		return;
 	}
+	const walked = walkStatePath(box.state, op.path, "parent");
+	if (walked === void 0) throw invalid(op);
+	if (typeof walked.key === "number") applyInList(walked.parent, walked.key, op);
+	else applyInObject(walked.parent, walked.key, op);
 };
 const warnedOps = /* @__PURE__ */ new Set();
 const warnUnknownOp = (type) => {
@@ -92,31 +93,17 @@ const applyOp = (root, op) => {
 };
 const applyOps = (state, ops) => {
 	const events = [];
-	const changedPaths = [];
-	let segment = [];
-	const flush = () => {
-		if (segment.length === 0) return;
-		const ops = segment;
-		segment = [];
-		const recorded = recordMutations({ state }, (draft) => {
-			for (const op of ops) applyOpToDraft(draft, op);
-		});
-		state = recorded.state.state;
-		changedPaths.push(...unboxPaths(recorded.changedPaths));
-	};
-	for (const op of ops) if (op.op === "event") {
-		flush();
-		events.push({
-			event: sanitizeValue(op.value),
-			state
-		});
-	} else if (op.op === "replace" || op.op === "add" || op.op === "append" || op.op === "remove") segment.push(op);
+	const mutable = [];
+	for (const op of ops) if (op.op === "event") events.push(sanitizeValue(op.value));
+	else if (op.op === "replace" || op.op === "add" || op.op === "remove") mutable.push(op);
 	else warnUnknownOp(op.op);
-	flush();
+	const recorded = recordMutations({ state }, (draft) => {
+		for (const op of mutable) applyOpToDraft(draft, op);
+	});
 	return {
-		state,
+		state: recorded.state.state,
 		events,
-		changedPaths
+		changedPaths: unboxPaths(recorded.changedPaths)
 	};
 };
 //#endregion

package/dist/wire/ops.js.map

@@ -1 +1 @@
-{"version":3,"file":"ops.js","names":["recordMutations","StatewirePath","StatewireOp","op","path","value","isUnsafe","key","parent","warnStripped","process","env","console","warn","undefined","sanitizeValue","Date","getTime","Array","isArray","map","item","out","Record","Object","keys","MutableOp","Extract","invalid","Error","join","appended","current","applyAtRoot","box","state","applyInList","list","index","length","splice","applyInObject","obj","exists","hasOwn","applyOpToDraft","node","depth","last","Number","isInteger","warnedOps","Set","warnUnknownOp","type","has","add","JSON","stringify","unboxPaths","paths","slice","applyOp","root","changedPaths","recorded","draft","applyOps","ops","events","event","segment","flush","push"],"sources":["../../src/wire/ops.ts"],"sourcesContent":["import { recordMutations } from \"../client/optimistic\";\n\nexport type StatewirePath = readonly (string | number)[];\n\nexport type StatewireOp =\n  | { op: \"replace\"; path: StatewirePath; value: unknown }\n  | { op: \"add\"; path: StatewirePath; value: unknown }\n  | { op: \"append\"; path: StatewirePath; value: unknown }\n  | { op: \"remove\"; path: StatewirePath }\n  | { op: \"event\"; value: object };\n\nconst isUnsafe = (key: string, parent: string | number | undefined) =>\n  key === \"__proto__\" || (key === \"prototype\" && parent === \"constructor\");\n\nconst warnStripped = (key: string, parent: string | undefined) => {\n  if (\n    typeof process === \"undefined\" ||\n    process.env[\"NODE_ENV\"] !== \"production\"\n  ) {\n    console.warn(\n      `statewire: stripped unsafe key \"${key}\"` +\n        (parent === undefined ? \"\" : ` under \"${parent}\"`),\n    );\n  }\n};\n\nexport const sanitizeValue = (value: unknown, parent?: string): unknown => {\n  if (typeof value !== \"object\" || value === null) return value;\n  if (value instanceof Date) return new Date(value.getTime());\n  if (Array.isArray(value)) return value.map((item) => sanitizeValue(item));\n  const out: Record<string, unknown> = {};\n  for (const key of Object.keys(value)) {\n    if (isUnsafe(key, parent)) warnStripped(key, parent);\n    else out[key] = sanitizeValue((value as Record<string, unknown>)[key], key);\n  }\n  return out;\n};\n\ntype MutableOp = Extract<\n  StatewireOp,\n  { op: \"replace\" | \"add\" | \"append\" | \"remove\" }\n>;\n\nconst invalid = (op: MutableOp) =>\n  new Error(`Statewire cannot apply ${op.op} at path: ${op.path.join(\".\")}`);\n\nconst appended = (\n  current: unknown,\n  op: Extract<MutableOp, { op: \"append\" }>,\n): string => {\n  if (typeof current !== \"string\" || typeof op.value !== \"string\") {\n    throw invalid(op);\n  }\n  return current + op.value;\n};\n\nconst applyAtRoot = (box: { state: unknown }, op: MutableOp) => {\n  if (op.op === \"replace\") {\n    box.state = sanitizeValue(op.value);\n  } else if (op.op === \"append\") {\n    box.state = appended(box.state, op);\n  } else {\n    throw invalid(op);\n  }\n};\n\nconst applyInList = (list: unknown[], index: number, op: MutableOp) => {\n  if (op.op === \"replace\") {\n    if (index >= list.length) throw invalid(op);\n    list[index] = sanitizeValue(op.value);\n  } else if (op.op === \"add\") {\n    if (index > list.length) throw invalid(op);\n    list.splice(index, 0, sanitizeValue(op.value));\n  } else if (op.op === \"append\") {\n    if (index >= list.length) throw invalid(op);\n    list[index] = appended(list[index], op);\n  } else {\n    if (index >= list.length) throw invalid(op);\n    list.splice(index, 1);\n  }\n};\n\nconst applyInObject = (\n  obj: Record<string, unknown>,\n  key: string,\n  op: MutableOp,\n) => {\n  const exists = Object.hasOwn(obj, key);\n  if (op.op === \"replace\") {\n    obj[key] = sanitizeValue(op.value, key);\n  } else if (op.op === \"append\") {\n    obj[key] = appended(exists ? obj[key] : undefined, op);\n  } else if (op.op === \"remove\") {\n    if (!exists) throw invalid(op);\n    delete obj[key];\n  } else {\n    throw invalid(op);\n  }\n};\n\nconst applyOpToDraft = (box: { state: unknown }, op: MutableOp): void => {\n  if (op.path.length === 0) {\n    applyAtRoot(box, op);\n    return;\n  }\n  let node: unknown = box.state;\n  for (let depth = 0; depth < op.path.length; depth++) {\n    const key = op.path[depth]!;\n    const last = depth === op.path.length - 1;\n    if (typeof key === \"number\") {\n      if (!Array.isArray(node) || !Number.isInteger(key) || key < 0) {\n        throw invalid(op);\n      }\n      if (last) {\n        applyInList(node, key, op);\n        return;\n      }\n      if (key >= node.length) throw invalid(op);\n      node = node[key];\n    } else {\n      if (\n        isUnsafe(key, op.path[depth - 1]) ||\n        typeof node !== \"object\" ||\n        node === null ||\n        Array.isArray(node)\n      ) {\n        throw invalid(op);\n      }\n      const obj = node as Record<string, unknown>;\n      if (last) {\n        applyInObject(obj, key, op);\n        return;\n      }\n      if (!Object.hasOwn(obj, key)) throw invalid(op);\n      node = obj[key];\n    }\n  }\n};\n\nconst warnedOps = new Set<unknown>();\nconst warnUnknownOp = (type: unknown) => {\n  if (warnedOps.has(type)) return;\n  warnedOps.add(type);\n  console.warn(`statewire: ignoring unknown op type ${JSON.stringify(type)}`);\n};\n\nconst unboxPaths = (paths: readonly StatewirePath[]): StatewirePath[] =>\n  paths.map((path) => path.slice(1));\n\nexport const applyOp = (\n  root: unknown,\n  op: MutableOp,\n): { state: unknown; changedPaths: StatewirePath[] } => {\n  const recorded = recordMutations({ state: root }, (draft) =>\n    applyOpToDraft(draft, op),\n  );\n  return {\n    state: recorded.state.state,\n    changedPaths: unboxPaths(recorded.changedPaths),\n  };\n};\n\nexport const applyOps = (\n  state: unknown,\n  ops: readonly unknown[],\n): {\n  state: unknown;\n  events: { event: unknown; state: unknown }[];\n  changedPaths: StatewirePath[];\n} => {\n  const events: { event: unknown; state: unknown }[] = [];\n  const changedPaths: StatewirePath[] = [];\n  let segment: MutableOp[] = [];\n  const flush = () => {\n    if (segment.length === 0) return;\n    const ops = segment;\n    segment = [];\n    const recorded = recordMutations({ state }, (draft) => {\n      for (const op of ops) applyOpToDraft(draft, op);\n    });\n    state = recorded.state.state;\n    changedPaths.push(...unboxPaths(recorded.changedPaths));\n  };\n  for (const op of ops as StatewireOp[]) {\n    if (op.op === \"event\") {\n      flush();\n      events.push({ event: sanitizeValue(op.value), state });\n    } else if (\n      op.op === \"replace\" ||\n      op.op === \"add\" ||\n      op.op === \"append\" ||\n      op.op === \"remove\"\n    ) {\n      segment.push(op);\n    } else {\n      warnUnknownOp((op as { op: unknown }).op);\n    }\n  }\n  flush();\n  return { state, events, changedPaths };\n};\n"],"mappings":"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"}
+{"version":3,"file":"ops.js","names":["recordMutations","isUnsafeKey","walkStatePath","Statewire","StatewirePath","warnStripped","key","parent","process","env","console","warn","undefined","unserializable","kind","path","Error","length","join","sanitizeAt","value","Date","getTime","Array","isArray","map","item","index","out","Record","Object","keys","sanitizeValue","MutableOp","Extract","Op","op","invalid","insertedText","current","offset","slice","applyAdd","box","state","walked","Number","isInteger","target","leaf","splice","next","applyInList","list","applyInObject","obj","hasOwn","applyOpToDraft","warnedOps","Set","warnUnknownOp","type","has","add","JSON","stringify","unboxPaths","paths","applyOp","root","changedPaths","recorded","draft","applyOps","ops","events","mutable","push"],"sources":["../../src/wire/ops.ts"],"sourcesContent":["import { recordMutations } from \"../util/recordMutations\";\nimport { isUnsafeKey, walkStatePath } from \"../util/statePath\";\nimport type { Statewire } from \"../types\";\n\nexport type StatewirePath = readonly (string | number)[];\n\nconst warnStripped = (key: string, parent: string | undefined) => {\n  if (\n    typeof process === \"undefined\" ||\n    process.env[\"NODE_ENV\"] !== \"production\"\n  ) {\n    console.warn(\n      `statewire: stripped unsafe key \"${key}\"` +\n        (parent === undefined ? \"\" : ` under \"${parent}\"`),\n    );\n  }\n};\n\nconst unserializable = (\n  kind: \"function\" | \"undefined\",\n  path: readonly (string | number)[],\n): never => {\n  throw new Error(\n    `statewire: cannot serialize ${kind}` +\n      (path.length === 0 ? \"\" : ` at ${path.join(\".\")}`),\n  );\n};\n\nconst sanitizeAt = (\n  value: unknown,\n  parent: string | undefined,\n  path: readonly (string | number)[],\n): unknown => {\n  if (value instanceof Date) return new Date(value.getTime());\n  if (Array.isArray(value)) {\n    return value.map((item, index) => {\n      if (item === undefined) unserializable(\"undefined\", [...path, index]);\n      return sanitizeAt(item, undefined, [...path, index]);\n    });\n  }\n  if (typeof value === \"object\" && value !== null) {\n    const out: Record<string, unknown> = {};\n    for (const key of Object.keys(value)) {\n      if (isUnsafeKey(key, parent)) {\n        warnStripped(key, parent);\n        continue;\n      }\n      const item = (value as Record<string, unknown>)[key];\n      if (item === undefined) continue;\n      out[key] = sanitizeAt(item, key, [...path, key]);\n    }\n    return out;\n  }\n  if (typeof value === \"function\") unserializable(\"function\", path);\n  return value;\n};\n\n// One clone pass: strips unsafe keys (with a warning); explicit-undefined\n// object entries are omitted (delete semantics), functions and undefined\n// list items throw.\nexport const sanitizeValue = (value: unknown, parent?: string): unknown =>\n  sanitizeAt(value, parent, parent === undefined ? [] : [parent]);\n\ntype MutableOp = Extract<Statewire.Op, { op: \"replace\" | \"add\" | \"remove\" }>;\n\nconst invalid = (op: MutableOp) =>\n  new Error(`Statewire cannot apply ${op.op} at path: ${op.path.join(\".\")}`);\n\nconst insertedText = (\n  current: string,\n  op: Extract<MutableOp, { op: \"add\" }>,\n  offset: number,\n): string => {\n  if (typeof op.value !== \"string\" || offset > current.length) {\n    throw invalid(op);\n  }\n  return current.slice(0, offset) + op.value + current.slice(offset);\n};\n\nconst applyAdd = (\n  box: { state: unknown },\n  op: Extract<MutableOp, { op: \"add\" }>,\n) => {\n  const offset = op.path[op.path.length - 1];\n  const walked = walkStatePath(box.state, op.path.slice(0, -1), \"resolve\");\n  if (\n    walked === undefined ||\n    typeof offset !== \"number\" ||\n    !Number.isInteger(offset) ||\n    offset < 0\n  ) {\n    throw invalid(op);\n  }\n  const target = walked.leaf;\n  if (Array.isArray(target)) {\n    if (offset > target.length) throw invalid(op);\n    target.splice(offset, 0, sanitizeValue(op.value));\n  } else if (typeof target === \"string\") {\n    const next = insertedText(target, op, offset);\n    if (op.path.length === 1) {\n      box.state = next;\n    } else {\n      (walked.parent as Record<string | number, unknown>)[walked.key] = next;\n    }\n  } else {\n    throw invalid(op);\n  }\n};\n\nconst applyInList = (list: unknown[], index: number, op: MutableOp) => {\n  if (index >= list.length) throw invalid(op);\n  if (op.op === \"replace\") {\n    list[index] = sanitizeValue(op.value);\n  } else {\n    list.splice(index, 1);\n  }\n};\n\nconst applyInObject = (\n  obj: Record<string, unknown>,\n  key: string,\n  op: MutableOp,\n) => {\n  if (op.op === \"replace\") {\n    obj[key] = sanitizeValue(op.value, key);\n  } else {\n    if (!Object.hasOwn(obj, key)) throw invalid(op);\n    delete obj[key];\n  }\n};\n\nconst applyOpToDraft = (box: { state: unknown }, op: MutableOp): void => {\n  if (op.op === \"add\") {\n    if (op.path.length === 0) throw invalid(op);\n    applyAdd(box, op);\n    return;\n  }\n  if (op.path.length === 0) {\n    if (op.op !== \"replace\") throw invalid(op);\n    box.state = sanitizeValue(op.value);\n    return;\n  }\n  const walked = walkStatePath(box.state, op.path, \"parent\");\n  if (walked === undefined) throw invalid(op);\n  if (typeof walked.key === \"number\") {\n    applyInList(walked.parent as unknown[], walked.key, op);\n  } else {\n    applyInObject(walked.parent as Record<string, unknown>, walked.key, op);\n  }\n};\n\nconst warnedOps = new Set<unknown>();\nconst warnUnknownOp = (type: unknown) => {\n  if (warnedOps.has(type)) return;\n  warnedOps.add(type);\n  console.warn(`statewire: ignoring unknown op type ${JSON.stringify(type)}`);\n};\n\nconst unboxPaths = (paths: readonly StatewirePath[]): StatewirePath[] =>\n  paths.map((path) => path.slice(1));\n\nexport const applyOp = (\n  root: unknown,\n  op: MutableOp,\n): { state: unknown; changedPaths: StatewirePath[] } => {\n  const recorded = recordMutations({ state: root }, (draft) =>\n    applyOpToDraft(draft, op),\n  );\n  return {\n    state: recorded.state.state,\n    changedPaths: unboxPaths(recorded.changedPaths),\n  };\n};\n\nexport const applyOps = (\n  state: unknown,\n  ops: readonly unknown[],\n): {\n  state: unknown;\n  events: unknown[];\n  changedPaths: StatewirePath[];\n} => {\n  const events: unknown[] = [];\n  const mutable: MutableOp[] = [];\n  for (const op of ops as Statewire.Op[]) {\n    if (op.op === \"event\") {\n      events.push(sanitizeValue(op.value));\n    } else if (op.op === \"replace\" || op.op === \"add\" || op.op === \"remove\") {\n      mutable.push(op);\n    } else {\n      warnUnknownOp((op as { op: unknown }).op);\n    }\n  }\n  const recorded = recordMutations({ state }, (draft) => {\n    for (const op of mutable) applyOpToDraft(draft, op);\n  });\n  return {\n    state: recorded.state.state,\n    events,\n    changedPaths: unboxPaths(recorded.changedPaths),\n  };\n};\n"],"mappings":"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"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "statewire",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "State over the wire: snapshot-first delta streaming and command submission for any state and any command",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/assistant-ui/harness-sdk.git",
-    "directory": "packages/statewire"
+    "directory": "packages/statewire/core"
   },
   "publishConfig": {
     "access": "public"
@@ -17,9 +17,13 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./server": {
-      "types": "./dist/server.d.ts",
-      "default": "./dist/server.js"
+    "./host": {
+      "types": "./dist/host.d.ts",
+      "default": "./dist/host.js"
+    },
+    "./host-internal": {
+      "types": "./dist/host-internal.d.ts",
+      "default": "./dist/host-internal.js"
     },
     "./testing": {
       "types": "./dist/transports/testing.d.ts",
@@ -33,6 +37,11 @@
     "src",
     "README.md"
   ],
+  "scripts": {
+    "build": "aui-build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
   "dependencies": {
     "@assistant-ui/tap": "^0.9.6"
   },
@@ -45,10 +54,5 @@
     "babel-plugin-react-compiler": "^1.0.0",
     "react": "^19.2.8",
     "vitest": "^4.1.10"
-  },
-  "scripts": {
-    "build": "aui-build",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run"
   }
-}
+}

package/src/client/changes.ts

@@ -1,16 +1,6 @@
 import type { StatewirePath } from "../wire/ops";
-import type { StatewireChanges } from "../types";
-
-const lookupValue = (state: unknown, path: StatewirePath): unknown => {
-  let node = state;
-  for (const key of path) {
-    if (typeof node !== "object" || node === null) return undefined;
-    node = Object.hasOwn(node, key)
-      ? (node as Record<string, unknown>)[key]
-      : undefined;
-  }
-  return node;
-};
+import type { Statewire } from "../types";
+import { readAtPath } from "../util/statePath";
 
 const keysAt = (node: unknown): string[] =>
   typeof node === "object" && node !== null ? Object.keys(node) : [];
@@ -23,7 +13,7 @@ export const createChanges = (
   prev: unknown,
   next: unknown,
   changedPaths: readonly StatewirePath[],
-): StatewireChanges => ({
+): Statewire.Changes => ({
   isChangedAt: (path) =>
     changedPaths.some((p) => isPrefix(p, path) || isPrefix(path, p)),
   getChangedKeys: (path) => {
@@ -31,8 +21,8 @@ export const createChanges = (
       (p) => p.length <= path.length && isPrefix(p, path),
     );
     if (wiped) {
-      const keys = keysAt(lookupValue(next, path));
-      for (const key of keysAt(lookupValue(prev, path))) {
+      const keys = keysAt(readAtPath(next, path));
+      for (const key of keysAt(readAtPath(prev, path))) {
         if (!keys.includes(key)) keys.push(key);
       }
       return keys;