statewire 0.0.1 → 0.0.3

package/dist/host/draft.js

@@ -1,124 +1,211 @@
+import { sharedDraftTraps } from "../util/draftTraps.js";
+import { isUnsafeKey } from "../util/statePath.js";
+import { sanitizeValue } from "../wire/ops.js";
 //#region src/host/draft.ts
-const frozen = (value) => {
-	if (value instanceof Date) return new Date(value.getTime());
-	if (Array.isArray(value)) return value.map((item) => frozen(item) ?? null);
-	if (typeof value === "object" && value !== null) {
-		const out = {};
-		for (const key of Object.keys(value)) {
-			const item = frozen(value[key]);
-			if (item !== void 0) out[key] = item;
-		}
-		return out;
-	}
-	return typeof value === "function" ? void 0 : value;
-};
-const lookup = (root, path) => {
-	let node = root;
-	for (const key of path) node = node[key];
-	return node;
-};
+const NODE = Symbol("statewire.draftNode");
 const isIndex = (key) => /^(0|[1-9]\d*)$/.test(key);
 const invalid = (path, message) => /* @__PURE__ */ new Error(`statewire: ${message} at path: ${path.join(".")}`);
-const createStateDraft = (host, path = []) => {
-	const node = () => lookup(host.root(), path);
-	const assign = (container, key, value) => {
-		const old = Object.hasOwn(container, key) ? container[key] : void 0;
-		if (old === value) return;
-		if (typeof old === "string" && typeof value === "string" && value.startsWith(old)) {
-			host.record({
-				op: "append",
-				path: [...path, key],
-				value: value.slice(old.length)
-			});
-			return;
+const createStateDraft = (host) => {
+	let gen = 0;
+	const dirty = [];
+	const latest = (node) => node.copy ?? node.base;
+	const resolve = (node) => {
+		if (node.gen === gen) return node;
+		node.gen = gen;
+		if (node.parent === null) {
+			if (node.copy === null) node.base = host.snapshot();
+			return node;
 		}
+		const value = latest(resolve(node.parent))[node.key];
+		if (value !== latest(node)) {
+			node.base = value;
+			node.copy = null;
+		}
+		return node;
+	};
+	const prepareForWrite = (node) => {
+		resolve(node);
+		if (node.copy !== null) return node.copy;
+		const base = node.base;
+		node.copy = Array.isArray(base) ? base.slice() : { ...base };
+		dirty.push(node);
+		if (node.parent !== null) prepareForWrite(node.parent)[node.key] = node.copy;
+		return node.copy;
+	};
+	const changedPathFor = (node, key) => Array.isArray(latest(node)) ? node.path : [...node.path, key];
+	const applyAppend = (node, rawKey, suffix) => {
+		const container = latest(resolve(node));
+		const key = Array.isArray(container) && typeof rawKey === "string" && isIndex(rawKey) ? Number(rawKey) : rawKey;
+		const existing = Object.hasOwn(container, key) ? container[key] : void 0;
+		if (typeof existing !== "string") throw invalid([...node.path, key], "cannot append to a non-string");
+		if (suffix === "") return;
+		prepareForWrite(node)[key] = existing + suffix;
 		host.record({
-			op: "replace",
-			path: [...path, key],
-			value
-		});
+			op: "add",
+			path: [
+				...node.path,
+				key,
+				existing.length
+			],
+			value: suffix
+		}, changedPathFor(node, key));
 	};
-	return new Proxy(node(), {
-		get: (_target, prop) => {
-			const current = node();
-			if (typeof prop === "symbol") return current[prop];
-			const key = Array.isArray(current) && isIndex(prop) ? Number(prop) : prop;
-			const value = current[key];
-			if (typeof value === "object" && value !== null) return createStateDraft(host, [...path, key]);
-			return value;
-		},
-		set: (_target, prop, rawValue) => {
-			if (typeof prop === "symbol") return false;
-			const current = node();
-			const value = frozen(rawValue);
-			if (Array.isArray(current)) {
-				if (prop === "length") {
-					const next = Number(value);
-					if (!Number.isInteger(next) || next < 0 || next > current.length) throw invalid(path, `cannot set list length to ${String(value)}`);
-					for (let i = current.length - 1; i >= next; i--) host.record({
-						op: "remove",
-						path: [...path, i]
-					});
+	const createNode = (parent, key) => {
+		const seed = parent === null ? host.snapshot() : latest(parent)[key];
+		const node = {
+			parent,
+			key,
+			path: parent === null ? [] : [...parent.path, key],
+			gen,
+			base: seed,
+			copy: null,
+			children: /* @__PURE__ */ new Map(),
+			isArray: Array.isArray(seed),
+			proxy: null,
+			handle: null
+		};
+		node.handle = { append: (childKey, suffix) => applyAppend(node, childKey, suffix) };
+		const current = () => latest(resolve(node));
+		const childProxy = (prop, childKey, value) => {
+			let child = node.children.get(prop);
+			if (child === void 0 || child.isArray !== Array.isArray(value)) {
+				child = createNode(node, childKey);
+				node.children.set(prop, child);
+			}
+			return child.proxy;
+		};
+		const assign = (container, key, value) => {
+			const old = Object.hasOwn(container, key) ? container[key] : void 0;
+			if (old === value) return;
+			const isObjectContainer = !Array.isArray(container);
+			if (isObjectContainer && isUnsafeKey(key, node.path[node.path.length - 1])) throw invalid([...node.path, key], `cannot set unsafe key "${key}"`);
+			if (value === void 0) {
+				if (!isObjectContainer) throw invalid([...node.path, key], "cannot serialize undefined");
+				delete prepareForWrite(node)[key];
+				host.record({
+					op: "remove",
+					path: [...node.path, key]
+				}, [...node.path, key]);
+				gen++;
+				return;
+			}
+			prepareForWrite(node)[key] = isObjectContainer ? sanitizeValue(value, key) : sanitizeValue(value);
+			host.record({
+				op: "replace",
+				path: [...node.path, key],
+				value
+			}, changedPathFor(node, key));
+			if (typeof old === "object" && old !== null || typeof value === "object" && value !== null) gen++;
+		};
+		node.proxy = new Proxy(seed, {
+			get: (_target, prop) => {
+				if (prop === NODE) return node.handle;
+				const container = current();
+				if (typeof prop === "symbol") return container[prop];
+				const c = container;
+				const key = Array.isArray(c) && isIndex(prop) ? Number(prop) : prop;
+				const value = c[key];
+				if (typeof value === "object" && value !== null) return childProxy(prop, key, value);
+				return value;
+			},
+			set: (_target, prop, value) => {
+				if (typeof prop === "symbol") return false;
+				const container = current();
+				if (Array.isArray(container)) {
+					if (prop === "length") {
+						const next = Number(value);
+						if (!Number.isInteger(next) || next < 0 || next > container.length) throw invalid(node.path, `cannot set list length to ${String(value)}`);
+						if (next === container.length) return true;
+						const copy = prepareForWrite(node);
+						for (let i = container.length - 1; i >= next; i--) {
+							copy.splice(i, 1);
+							host.record({
+								op: "remove",
+								path: [...node.path, i]
+							}, node.path);
+						}
+						gen++;
+						return true;
+					}
+					if (!isIndex(prop)) throw invalid(node.path, `cannot set key "${prop}" on a list`);
+					const index = Number(prop);
+					if (index > container.length) throw invalid(node.path, `list index ${index} out of range`);
+					if (index === container.length) {
+						if (value === void 0) throw invalid([...node.path, index], "cannot serialize undefined");
+						prepareForWrite(node)[index] = sanitizeValue(value);
+						host.record({
+							op: "add",
+							path: [...node.path, index],
+							value
+						}, node.path);
+						gen++;
+						return true;
+					}
+					assign(container, index, value);
 					return true;
 				}
-				if (!isIndex(prop)) throw invalid(path, `cannot set key "${prop}" on a list`);
-				const index = Number(prop);
-				if (index > current.length) throw invalid(path, `list index ${index} out of range`);
-				if (index === current.length) {
+				assign(container, prop, value);
+				return true;
+			},
+			deleteProperty: (_target, prop) => {
+				if (typeof prop === "symbol") return false;
+				const container = current();
+				if (Array.isArray(container)) {
+					if (!isIndex(prop) || Number(prop) >= container.length) return true;
+					const index = Number(prop);
+					prepareForWrite(node).splice(index, 1);
 					host.record({
-						op: "add",
-						path: [...path, index],
-						value
-					});
+						op: "remove",
+						path: [...node.path, index]
+					}, node.path);
+					gen++;
 					return true;
 				}
-				assign(current, index, value);
-				return true;
-			}
-			assign(current, prop, value);
-			return true;
-		},
-		deleteProperty: (_target, prop) => {
-			if (typeof prop === "symbol") return false;
-			const current = node();
-			if (Array.isArray(current)) {
-				if (!isIndex(prop) || Number(prop) >= current.length) return true;
+				if (!Object.hasOwn(container, prop)) return true;
+				if (isUnsafeKey(prop, node.path[node.path.length - 1])) throw invalid([...node.path, prop], `cannot remove unsafe key "${prop}"`);
+				delete prepareForWrite(node)[prop];
 				host.record({
 					op: "remove",
-					path: [...path, Number(prop)]
-				});
+					path: [...node.path, prop]
+				}, [...node.path, prop]);
+				gen++;
 				return true;
+			},
+			has: (_target, prop) => Reflect.has(current(), prop),
+			...sharedDraftTraps(() => current(), "on a state draft")
+		});
+		return node;
+	};
+	const root = createNode(null, "");
+	return {
+		proxy: root.proxy,
+		flush: () => {
+			if (dirty.length === 0) return host.snapshot();
+			for (const node of dirty) if (node.copy !== null) {
+				node.base = node.copy;
+				node.copy = null;
 			}
-			if (!Object.hasOwn(current, prop)) return true;
-			host.record({
-				op: "remove",
-				path: [...path, prop]
-			});
-			return true;
-		},
-		defineProperty: () => {
-			throw new Error("statewire: defineProperty is not supported on a state draft");
-		},
-		setPrototypeOf: () => {
-			throw new Error("statewire: setPrototypeOf is not supported on a state draft");
+			dirty.length = 0;
+			return root.base;
 		},
-		preventExtensions: () => {
-			throw new Error("statewire: preventExtensions is not supported on a state draft");
-		},
-		has: (_target, prop) => Reflect.has(node(), prop),
-		ownKeys: () => Reflect.ownKeys(node()),
-		getOwnPropertyDescriptor: (_target, prop) => {
-			const current = node();
-			const desc = Reflect.getOwnPropertyDescriptor(current, prop);
-			if (!desc) return void 0;
-			return {
-				...desc,
-				configurable: !Array.isArray(current) || prop !== "length"
-			};
+		invalidate: () => {
+			gen++;
 		}
-	});
+	};
+};
+/**
+* Append `suffix` to the string at `parent[key]` on a statewire state draft,
+* recording a single end-offset text-insert `add` op instead of a full
+* `replace` — use it on token-streaming hot paths. Throws when the current
+* value is not a string.
+*/
+const append = (parent, key, suffix) => {
+	const handle = parent[NODE];
+	if (handle === void 0) throw new Error("statewire: append expects a state draft object");
+	if (typeof suffix !== "string") throw new Error("statewire: append suffix must be a string");
+	handle.append(key, suffix);
 };
 //#endregion
-export { createStateDraft, frozen };
+export { append, createStateDraft };
 
 //# sourceMappingURL=draft.js.map

package/dist/host/draft.js.map

@@ -1 +1 @@
-{"version":3,"file":"draft.js","names":["StatewireOp","StatewirePath","ServerOp","Exclude","op","DraftHost","root","record","frozen","value","Date","getTime","Array","isArray","map","item","out","Record","key","Object","keys","undefined","lookup","path","node","isIndex","test","invalid","message","Error","join","createStateDraft","host","T","assign","container","old","hasOwn","startsWith","slice","length","Proxy","get","_target","prop","current","Number","set","rawValue","next","isInteger","String","i","index","deleteProperty","defineProperty","setPrototypeOf","preventExtensions","has","Reflect","ownKeys","getOwnPropertyDescriptor","desc","configurable"],"sources":["../../src/host/draft.ts"],"sourcesContent":["import type { StatewireOp, StatewirePath } from \"../wire/ops\";\n\nexport type ServerOp = Exclude<StatewireOp, { op: \"event\" }>;\n\nexport type DraftHost = {\n  root: () => unknown;\n  record: (op: ServerOp) => void;\n};\n\nexport const frozen = (value: unknown): unknown => {\n  if (value instanceof Date) return new Date(value.getTime());\n  if (Array.isArray(value)) {\n    return value.map((item) => frozen(item) ?? null);\n  }\n  if (typeof value === \"object\" && value !== null) {\n    const out: Record<string, unknown> = {};\n    for (const key of Object.keys(value)) {\n      const item = frozen((value as Record<string, unknown>)[key]);\n      if (item !== undefined) out[key] = item;\n    }\n    return out;\n  }\n  return typeof value === \"function\" ? undefined : value;\n};\n\nconst lookup = (root: unknown, path: StatewirePath): unknown => {\n  let node = root;\n  for (const key of path) {\n    node = (node as Record<string | number, unknown>)[key];\n  }\n  return node;\n};\n\nconst isIndex = (key: string) => /^(0|[1-9]\\d*)$/.test(key);\n\nconst invalid = (path: StatewirePath, message: string) =>\n  new Error(`statewire: ${message} at path: ${path.join(\".\")}`);\n\nexport const createStateDraft = <T>(\n  host: DraftHost,\n  path: StatewirePath = [],\n): T => {\n  const node = () => lookup(host.root(), path);\n\n  const assign = (\n    container: Record<string | number, unknown>,\n    key: string | number,\n    value: unknown,\n  ) => {\n    const old = Object.hasOwn(container, key) ? container[key] : undefined;\n    if (old === value) return;\n    if (\n      typeof old === \"string\" &&\n      typeof value === \"string\" &&\n      value.startsWith(old)\n    ) {\n      host.record({\n        op: \"append\",\n        path: [...path, key],\n        value: value.slice(old.length),\n      });\n      return;\n    }\n    host.record({ op: \"replace\", path: [...path, key], value });\n  };\n\n  return new Proxy(node() as object, {\n    get: (_target, prop) => {\n      const current = node() as Record<string | number, unknown>;\n      if (typeof prop === \"symbol\") {\n        return (current as unknown as Record<symbol, unknown>)[prop];\n      }\n      const key = Array.isArray(current) && isIndex(prop) ? Number(prop) : prop;\n      const value = current[key];\n      if (typeof value === \"object\" && value !== null) {\n        return createStateDraft(host, [...path, key]);\n      }\n      return value;\n    },\n    set: (_target, prop, rawValue) => {\n      if (typeof prop === \"symbol\") return false;\n      const current = node();\n      const value = frozen(rawValue);\n      if (Array.isArray(current)) {\n        if (prop === \"length\") {\n          const next = Number(value);\n          if (!Number.isInteger(next) || next < 0 || next > current.length) {\n            throw invalid(path, `cannot set list length to ${String(value)}`);\n          }\n          for (let i = current.length - 1; i >= next; i--) {\n            host.record({ op: \"remove\", path: [...path, i] });\n          }\n          return true;\n        }\n        if (!isIndex(prop)) {\n          throw invalid(path, `cannot set key \"${prop}\" on a list`);\n        }\n        const index = Number(prop);\n        if (index > current.length) {\n          throw invalid(path, `list index ${index} out of range`);\n        }\n        if (index === current.length) {\n          host.record({ op: \"add\", path: [...path, index], value });\n          return true;\n        }\n        assign(\n          current as unknown as Record<string | number, unknown>,\n          index,\n          value,\n        );\n        return true;\n      }\n      assign(current as Record<string, unknown>, prop, value);\n      return true;\n    },\n    deleteProperty: (_target, prop) => {\n      if (typeof prop === \"symbol\") return false;\n      const current = node();\n      if (Array.isArray(current)) {\n        if (!isIndex(prop) || Number(prop) >= current.length) return true;\n        host.record({ op: \"remove\", path: [...path, Number(prop)] });\n        return true;\n      }\n      if (!Object.hasOwn(current as object, prop)) return true;\n      host.record({ op: \"remove\", path: [...path, prop] });\n      return true;\n    },\n    defineProperty: () => {\n      throw new Error(\n        \"statewire: defineProperty is not supported on a state draft\",\n      );\n    },\n    setPrototypeOf: () => {\n      throw new Error(\n        \"statewire: setPrototypeOf is not supported on a state draft\",\n      );\n    },\n    preventExtensions: () => {\n      throw new Error(\n        \"statewire: preventExtensions is not supported on a state draft\",\n      );\n    },\n    has: (_target, prop) => Reflect.has(node() as object, prop),\n    ownKeys: () => Reflect.ownKeys(node() as object),\n    getOwnPropertyDescriptor: (_target, prop) => {\n      const current = node() as object;\n      const desc = Reflect.getOwnPropertyDescriptor(current, prop);\n      if (!desc) return undefined;\n      return {\n        ...desc,\n        configurable: !Array.isArray(current) || prop !== \"length\",\n      };\n    },\n  }) as T;\n};\n"],"mappings":"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"}
+{"version":3,"file":"draft.js","names":["Statewire","StatewirePath","sanitizeValue","isUnsafeKey","sharedDraftTraps","ServerOp","Exclude","Op","op","DraftHost","snapshot","record","changedPath","StateDraft","proxy","T","flush","invalidate","NODE","Symbol","NodeHandle","append","key","suffix","isIndex","test","invalid","path","message","Error","join","Container","Record","Node","parent","gen","base","copy","children","Map","isArray","handle","createStateDraft","host","dirty","latest","node","resolve","value","prepareForWrite","Array","slice","push","changedPathFor","applyAppend","rawKey","container","Number","existing","Object","hasOwn","undefined","length","createNode","seed","childKey","current","childProxy","prop","child","get","set","assign","old","isObjectContainer","Proxy","_target","c","next","isInteger","String","i","splice","index","deleteProperty","has","Reflect","root","TKey"],"sources":["../../src/host/draft.ts"],"sourcesContent":["import type { Statewire } from \"../types\";\nimport type { StatewirePath } from \"../wire/ops\";\nimport { sanitizeValue } from \"../wire/ops\";\nimport { isUnsafeKey } from \"../util/statePath\";\nimport { sharedDraftTraps } from \"../util/draftTraps\";\n\nexport type ServerOp = Exclude<Statewire.Op, { op: \"event\" }>;\n\nexport type DraftHost = {\n  snapshot: () => unknown;\n  record: (op: ServerOp, changedPath: StatewirePath) => void;\n};\n\nexport type StateDraft<T> = {\n  proxy: T;\n  /** Seal pending writes and return the committed state. */\n  flush: () => unknown;\n  /** Committed state was replaced externally; cached nodes re-resolve. */\n  invalidate: () => void;\n};\n\nconst NODE = Symbol(\"statewire.draftNode\");\n\ntype NodeHandle = {\n  append: (key: string | number, suffix: string) => void;\n};\n\nconst isIndex = (key: string) => /^(0|[1-9]\\d*)$/.test(key);\n\nconst invalid = (path: StatewirePath, message: string) =>\n  new Error(`statewire: ${message} at path: ${path.join(\".\")}`);\n\ntype Container = Record<string | number, unknown>;\n\ntype Node = {\n  parent: Node | null;\n  key: string | number;\n  path: StatewirePath;\n  gen: number;\n  base: unknown;\n  copy: Container | null;\n  children: Map<string, Node>;\n  isArray: boolean;\n  proxy: object;\n  handle: NodeHandle;\n};\n\nexport const createStateDraft = <T>(host: DraftHost): StateDraft<T> => {\n  let gen = 0;\n  const dirty: Node[] = [];\n\n  const latest = (node: Node): unknown => node.copy ?? node.base;\n\n  const resolve = (node: Node): Node => {\n    if (node.gen === gen) return node;\n    node.gen = gen;\n    if (node.parent === null) {\n      if (node.copy === null) node.base = host.snapshot();\n      return node;\n    }\n    const value = (latest(resolve(node.parent)) as Container)[node.key];\n    if (value !== latest(node)) {\n      node.base = value;\n      node.copy = null;\n    }\n    return node;\n  };\n\n  const prepareForWrite = (node: Node): Container => {\n    resolve(node);\n    if (node.copy !== null) return node.copy;\n    const base = node.base;\n    node.copy = Array.isArray(base)\n      ? (base.slice() as unknown as Container)\n      : { ...(base as Container) };\n    dirty.push(node);\n    if (node.parent !== null) {\n      prepareForWrite(node.parent)[node.key] = node.copy;\n    }\n    return node.copy;\n  };\n\n  const changedPathFor = (node: Node, key: string | number): StatewirePath =>\n    Array.isArray(latest(node)) ? node.path : [...node.path, key];\n\n  const applyAppend = (node: Node, rawKey: string | number, suffix: string) => {\n    const container = latest(resolve(node)) as Container;\n    const key =\n      Array.isArray(container) && typeof rawKey === \"string\" && isIndex(rawKey)\n        ? Number(rawKey)\n        : rawKey;\n    const existing = Object.hasOwn(container as object, key)\n      ? container[key]\n      : undefined;\n    if (typeof existing !== \"string\") {\n      throw invalid([...node.path, key], \"cannot append to a non-string\");\n    }\n    if (suffix === \"\") return;\n    prepareForWrite(node)[key] = existing + suffix;\n    host.record(\n      { op: \"add\", path: [...node.path, key, existing.length], value: suffix },\n      changedPathFor(node, key),\n    );\n  };\n\n  const createNode = (parent: Node | null, key: string | number): Node => {\n    const seed =\n      parent === null ? host.snapshot() : (latest(parent) as Container)[key];\n    const node: Node = {\n      parent,\n      key,\n      path: parent === null ? [] : [...parent.path, key],\n      gen,\n      base: seed,\n      copy: null,\n      children: new Map(),\n      isArray: Array.isArray(seed),\n      proxy: null!,\n      handle: null!,\n    };\n    node.handle = {\n      append: (childKey, suffix) => applyAppend(node, childKey, suffix),\n    };\n\n    const current = () => latest(resolve(node));\n\n    const childProxy = (\n      prop: string,\n      childKey: string | number,\n      value: object,\n    ) => {\n      let child = node.children.get(prop);\n      if (child === undefined || child.isArray !== Array.isArray(value)) {\n        child = createNode(node, childKey);\n        node.children.set(prop, child);\n      }\n      return child.proxy;\n    };\n\n    const assign = (\n      container: Container,\n      key: string | number,\n      value: unknown,\n    ) => {\n      const old = Object.hasOwn(container as object, key)\n        ? container[key]\n        : undefined;\n      if (old === value) return;\n      const isObjectContainer = !Array.isArray(container);\n      if (\n        isObjectContainer &&\n        isUnsafeKey(key, node.path[node.path.length - 1])\n      ) {\n        throw invalid([...node.path, key], `cannot set unsafe key \"${key}\"`);\n      }\n      if (value === undefined) {\n        if (!isObjectContainer) {\n          throw invalid([...node.path, key], \"cannot serialize undefined\");\n        }\n        delete prepareForWrite(node)[key];\n        host.record({ op: \"remove\", path: [...node.path, key] }, [\n          ...node.path,\n          key,\n        ]);\n        gen++;\n        return;\n      }\n      prepareForWrite(node)[key] = isObjectContainer\n        ? sanitizeValue(value, key as string)\n        : sanitizeValue(value);\n      host.record(\n        { op: \"replace\", path: [...node.path, key], value },\n        changedPathFor(node, key),\n      );\n      if (\n        (typeof old === \"object\" && old !== null) ||\n        (typeof value === \"object\" && value !== null)\n      ) {\n        gen++;\n      }\n    };\n\n    node.proxy = new Proxy(seed as object, {\n      get: (_target, prop) => {\n        if (prop === NODE) return node.handle;\n        const container = current();\n        if (typeof prop === \"symbol\") {\n          return (container as Record<symbol, unknown>)[prop];\n        }\n        const c = container as Container;\n        const key = Array.isArray(c) && isIndex(prop) ? Number(prop) : prop;\n        const value = c[key];\n        if (typeof value === \"object\" && value !== null) {\n          return childProxy(prop, key, value);\n        }\n        return value;\n      },\n      set: (_target, prop, value) => {\n        if (typeof prop === \"symbol\") return false;\n        const container = current();\n        if (Array.isArray(container)) {\n          if (prop === \"length\") {\n            const next = Number(value);\n            if (\n              !Number.isInteger(next) ||\n              next < 0 ||\n              next > container.length\n            ) {\n              throw invalid(\n                node.path,\n                `cannot set list length to ${String(value)}`,\n              );\n            }\n            if (next === container.length) return true;\n            const copy = prepareForWrite(node) as unknown as unknown[];\n            for (let i = container.length - 1; i >= next; i--) {\n              copy.splice(i, 1);\n              host.record({ op: \"remove\", path: [...node.path, i] }, node.path);\n            }\n            gen++;\n            return true;\n          }\n          if (!isIndex(prop)) {\n            throw invalid(node.path, `cannot set key \"${prop}\" on a list`);\n          }\n          const index = Number(prop);\n          if (index > container.length) {\n            throw invalid(node.path, `list index ${index} out of range`);\n          }\n          if (index === container.length) {\n            if (value === undefined) {\n              throw invalid(\n                [...node.path, index],\n                \"cannot serialize undefined\",\n              );\n            }\n            prepareForWrite(node)[index] = sanitizeValue(value);\n            host.record(\n              { op: \"add\", path: [...node.path, index], value },\n              node.path,\n            );\n            gen++;\n            return true;\n          }\n          assign(container as unknown as Container, index, value);\n          return true;\n        }\n        assign(container as Container, prop, value);\n        return true;\n      },\n      deleteProperty: (_target, prop) => {\n        if (typeof prop === \"symbol\") return false;\n        const container = current();\n        if (Array.isArray(container)) {\n          if (!isIndex(prop) || Number(prop) >= container.length) return true;\n          const index = Number(prop);\n          (prepareForWrite(node) as unknown as unknown[]).splice(index, 1);\n          host.record({ op: \"remove\", path: [...node.path, index] }, node.path);\n          gen++;\n          return true;\n        }\n        if (!Object.hasOwn(container as object, prop)) return true;\n        if (isUnsafeKey(prop, node.path[node.path.length - 1])) {\n          throw invalid(\n            [...node.path, prop],\n            `cannot remove unsafe key \"${prop}\"`,\n          );\n        }\n        delete prepareForWrite(node)[prop];\n        host.record({ op: \"remove\", path: [...node.path, prop] }, [\n          ...node.path,\n          prop,\n        ]);\n        gen++;\n        return true;\n      },\n      has: (_target, prop) => Reflect.has(current() as object, prop),\n      ...sharedDraftTraps(() => current() as object, \"on a state draft\"),\n    });\n    return node;\n  };\n\n  const root = createNode(null, \"\");\n\n  return {\n    proxy: root.proxy as T,\n    flush: () => {\n      if (dirty.length === 0) return host.snapshot();\n      for (const node of dirty) {\n        if (node.copy !== null) {\n          node.base = node.copy;\n          node.copy = null;\n        }\n      }\n      dirty.length = 0;\n      return root.base;\n    },\n    invalidate: () => {\n      gen++;\n    },\n  };\n};\n\n/**\n * Append `suffix` to the string at `parent[key]` on a statewire state draft,\n * recording a single end-offset text-insert `add` op instead of a full\n * `replace` — use it on token-streaming hot paths. Throws when the current\n * value is not a string.\n */\nexport const append = <TKey extends string | number>(\n  parent: { readonly [P in TKey]: string },\n  key: TKey,\n  suffix: string,\n): void => {\n  const handle = (parent as { [NODE]?: NodeHandle })[NODE];\n  if (handle === undefined) {\n    throw new Error(\"statewire: append expects a state draft object\");\n  }\n  if (typeof suffix !== \"string\") {\n    throw new Error(\"statewire: append suffix must be a string\");\n  }\n  handle.append(key, suffix);\n};\n"],"mappings":"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"}

package/dist/host/host.d.ts

@@ -1,32 +1,9 @@
-import { StatewireOp } from "../wire/ops.js";
-import { StatewireCommands, StatewireCommandsProxy, StatewireStateSource } from "../types.js";
-import { ServerOp } from "./draft.js";
+import { StatewireHost } from "../host.js";
+import { Statewire } from "../types.js";
 //#region src/host/host.d.ts
-type StatewireStateCtl = {
-  /** Apply server-vocabulary ops (root replace = whole-state swap). */
-  apply: (ops: readonly StatewireOp[]) => void;
-};
-type StateHost = StatewireStateSource & {
-  /** Synchronous, per locally-recorded op; the host owns batching. */
-  setOnOp: (listener: ((op: ServerOp) => void) | null) => void;
-};
-declare const getStateHost: (state: object) => StateHost | undefined;
-declare const useStatewireState: <TState>(init: () => TState) => readonly [TState, StatewireStateCtl];
-declare const executionResult: unique symbol;
-/**
- * Handle a command handler returns to keep the command open past its own
- * return: `ack()` releases the client's optimistic overlay / ack watermark,
- * `resolve`/`reject` settle the command (and imply ack). `ack` is idempotent
- * and a no-op after settle.
- */
-type CommandExecution<T = void> = {
-  readonly [executionResult]: (value: T) => void;
-};
-type CommandExecutionResolvers<T = void> = {
-  ack: () => void;
-  resolve: (value: T) => void;
-  reject: (error: unknown) => void;
-};
+/** Host-side accessor for a `useStatewireState` state object's source (`snapshot()` reads the committed state). */
+declare const getStateHost: (state: object) => StatewireHost.StateHost | undefined;
+declare const useStatewireState: <TState>(init: () => TState) => readonly [TState, StatewireHost.StateCtl<TState>];
 /**
  * `CommandExecution(executor)` runs the (possibly async) `executor({ ack })`
  * immediately: its return value resolves the execution, a throw/rejection
@@ -36,8 +13,8 @@ type CommandExecutionResolvers<T = void> = {
  */
 declare const CommandExecution: (<T = void>(executor: (resolvers: {
   ack: () => void;
-}) => T | void | PromiseLike<T | void>) => CommandExecution<T>) & {
-  withResolvers: <T = void>() => [CommandExecution<T>, CommandExecutionResolvers<T>];
+}) => T | void | PromiseLike<T | void>) => StatewireHost.Execution<T>) & {
+  withResolvers: <T = void>() => [StatewireHost.Execution<T>, StatewireHost.ExecutionResolvers<T>];
 };
 type CommandsInvocation = {
   readonly method: string;
@@ -61,19 +38,26 @@ type CommandsListener = {
   onCovered?: (inv: CommandsInvocation) => void;
   onSettle: (inv: CommandsInvocation, outcome: CommandsOutcome) => void;
 };
+type CommandsSubmission = {
+  method: string;
+  params: readonly unknown[];
+  clientId?: string;
+  caller?: StatewireHost.Caller;
+  onAck?: () => void;
+  onSettle?: (outcome: CommandsOutcome) => void;
+};
 type CommandsHost = {
   setListener: (listener: CommandsListener | null) => void;
+  submit?: (call: CommandsSubmission) => Promise<unknown>;
 };
 declare const getCommandsHost: (commands: object) => CommandsHost | undefined;
 declare const bindCommandsHost: (commands: object, host: CommandsHost) => void;
-type UnwrapExecution<V> = V extends CommandExecution<infer T> ? T : V;
-type StatewireHandledCommands<THandlers extends StatewireCommands> = { [K in keyof THandlers]: (...args: Parameters<THandlers[K]>) => UnwrapExecution<Awaited<ReturnType<THandlers[K]>>>; };
-declare const useStatewireCommands: <THandlers extends StatewireCommands>(commands: THandlers | undefined | null | false) => StatewireCommandsProxy<StatewireHandledCommands<THandlers>>;
+declare const useStatewireCommands: <THandlers extends Statewire.Commands>(commands: (THandlers & ThisType<StatewireHost.Caller>) | undefined | null | false) => Statewire.CommandsProxy<StatewireHost.HandledCommands<THandlers>>;
 type EmitHost = {
   setSink: (sink: ((event: unknown) => void) | null) => void;
 };
-declare const getEmitHost: (emit: object) => EmitHost | undefined;
+declare const getEmitHost: (emit: object | undefined) => EmitHost | undefined;
 declare const useStatewireEmit: <TEvent>() => ((event: TEvent) => void);
 //#endregion
-export { CommandExecution, CommandExecutionResolvers, CommandsHost, CommandsInvocation, CommandsListener, CommandsOutcome, EmitHost, StateHost, StatewireHandledCommands, StatewireStateCtl, bindCommandsHost, getCommandsHost, getEmitHost, getStateHost, useStatewireCommands, useStatewireEmit, useStatewireState };
+export { CommandExecution, CommandsHost, CommandsInvocation, CommandsListener, CommandsOutcome, CommandsSubmission, EmitHost, bindCommandsHost, getCommandsHost, getEmitHost, getStateHost, useStatewireCommands, useStatewireEmit, useStatewireState };
 //# sourceMappingURL=host.d.ts.map

package/dist/host/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","names":[],"sources":["../../src/host/host.ts"],"mappings":";;;;KAkBY;;EAEV,QAAQ,cAAc;;KAGZ,YAAY;;EAEtB,UAAU,YAAY,IAAI;;cAKf,eAAgB,kBAAgB;cAchC,oBAAqB,QAChC,YAAY,qBACD,QAAQ;cAgFP;;;;;;;KAQF,iBAAiB;YACjB,mBAAmB,OAAO;;KAG1B,0BAA0B;EACpC;EACA,UAAU,OAAO;EACjB,SAAS;;;;;;;;;cAUE,oBACV,UAAC,WACW;EACT;MACI,WAAW,YAAY,cAC5B,iBAAiB;EAyBF,gBAAA,gBACd,iBAAiB,IACjB,0BAA0B;;KAkBpB;WACD;WACA;WACA;WACA;WACA;;KAGC;EACN;EAAkB;;EAClB;EAAkB;;KAEZ;EACV,UAAU,KAAK;EACf,YAAY,KAAK;EACjB,QAAQ,KAAK;;EAEb,aAAa,KAAK;EAClB,WAAW,KAAK,oBAAoB,SAAS;;KAGnC;EACV,cAAc,UAAU;;cAKb,kBAAmB,qBAAmB;cAGtC,mBAAoB,kBAAkB,MAAM;KAsIpD,gBAAgB,KAAK,UAAU,uBAAuB,KAAK,IAAI;KAExD,yBAAyB,kBAAkB,wBACpD,WAAW,gBACP,MAAM,WAAW,UAAU,QAC3B,gBAAgB,QAAQ,WAAW,UAAU;cAGvC,uBAAwB,kBAAkB,mBACrD,UAAU,yCACT,uBAAuB,yBAAyB;KA+EvC;EACV,UAAU,QAAQ;;cAKP,cAAe,iBAAe;cAG9B,mBAAoB,eAAa,OAAO"}
+{"version":3,"file":"host.d.ts","names":[],"sources":["../../src/host/host.ts"],"mappings":";;;;cAmBa,eACX,kBACC,cAAc;cAaJ,oBAAqB,QAChC,YAAY,qBACD,QAAQ,cAAc,SAAS;;;;;;;;cA4F/B,oBACV,UAAC,WACW;EACT;MACI,WAAW,YAAY,cAC5B,cAAc,UAAU;EA2BT,gBAAA,gBACd,cAAc,UAAU,IACxB,cAAc,mBAAmB;;KAkB3B;WACD;WACA;WACA;WACA;WACA;;KAGC;EACN;EAAkB;;EAClB;EAAkB;;KAEZ;EACV,UAAU,KAAK;EACf,YAAY,KAAK;EACjB,QAAQ,KAAK;;EAEb,aAAa,KAAK;EAClB,WAAW,KAAK,oBAAoB,SAAS;;KAGnC;EACV;EACA;EACA;EACA,SAAS,cAAc;EACvB;EACA,YAAY,SAAS;;KAGX;EACV,cAAc,UAAU;EACxB,UAAU,MAAM,uBAAuB;;cAK5B,kBAAmB,qBAAmB;cAGtC,mBAAoB,kBAAkB,MAAM;cA2J5C,uBAAwB,kBAAkB,UAAU,UAC/D,WACK,YAAY,SAAS,cAAc,wCAIvC,UAAU,cAAc,cAAc,gBAAgB;KAqF7C;EACV,UAAU,QAAQ;;cAKP,cAAe,6BAA2B;cAG1C,mBAAoB,eAAa,OAAO"}