@nativewindow/tsdb 1.0.1 → 1.0.3

package/dist/client.js

@@ -1,113 +1,173 @@
+//#region client.ts
+/** @internal Type guard for IPC envelope. */
 function isEnvelope(data) {
-  return typeof data === "object" && data !== null && "$ch" in data && typeof data.$ch === "string";
+	return typeof data === "object" && data !== null && "$ch" in data && typeof data.$ch === "string";
 }
+/**
+* Create TanStack DB collection options that sync data from a
+* native-window host process via IPC.
+*
+* The returned config is **read-only** — no `onInsert`/`onUpdate`/
+* `onDelete` handlers. Data flows host to webview only.
+*
+* The sync function prefers `window.__native_message_listeners__`
+* (the external listener registry exposed by `createChannelClient`)
+* when available. This avoids the frozen-property crash caused by
+* assigning to the read-only `window.__native_message__`. When the
+* IPC client is not present, it falls back to direct interposition
+* of `window.__native_message__` with a try/catch guard.
+*
+* @param config - Collection and channel configuration.
+* @returns An object compatible with `createCollection()` from `@tanstack/db`.
+*
+* @example
+* ```ts
+* import { createCollection } from "@tanstack/db";
+* import { useLiveQuery } from "@tanstack/react-db";
+* import { nativeWindowCollectionOptions } from "@nativewindow/tsdb/client";
+*
+* type Todo = { id: string; text: string; done: boolean };
+*
+* const todoCollection = createCollection(
+*   nativeWindowCollectionOptions<Todo, string>({
+*     id: "todos",
+*     channel: "tsdb:todos",
+*     getKey: (todo) => todo.id,
+*   }),
+* );
+*
+* function TodoList() {
+*   const { data: todos } = useLiveQuery((q) =>
+*     q.from({ todos: todoCollection }),
+*   );
+*   return (
+*     <ul>
+*       {todos.map((todo) => (
+*         <li key={todo.id}>{todo.text}</li>
+*       ))}
+*     </ul>
+*   );
+* }
+* ```
+*/
 function nativeWindowCollectionOptions(config) {
-  const { id, channel, getKey } = config;
-  return {
-    id,
-    getKey,
-    sync: {
-      sync: (params) => {
-        const { begin, write, commit, markReady } = params;
-        function processPayload(payload) {
-          switch (payload.t) {
-            case "i":
-              begin();
-              write({ type: "insert", value: payload.v });
-              commit();
-              break;
-            case "u":
-              begin();
-              write({ type: "update", value: payload.v });
-              commit();
-              break;
-            case "d":
-              begin();
-              write({ key: payload.k, type: "delete" });
-              commit();
-              break;
-            case "s":
-              begin();
-              for (const item of payload.items) {
-                write({ type: "insert", value: item.v });
-              }
-              commit();
-              markReady();
-              break;
-            case "b":
-              begin();
-              for (const op of payload.ops) {
-                switch (op.t) {
-                  case "i":
-                    write({ type: "insert", value: op.v });
-                    break;
-                  case "u":
-                    write({ type: "update", value: op.v });
-                    break;
-                  case "d":
-                    write({ key: op.k, type: "delete" });
-                    break;
-                }
-              }
-              commit();
-              break;
-          }
-        }
-        function handler(msg) {
-          let parsed;
-          try {
-            parsed = JSON.parse(msg);
-          } catch {
-            return;
-          }
-          if (!isEnvelope(parsed) || parsed.$ch !== channel) return;
-          const payload = parsed.p;
-          if (!payload || typeof payload.t !== "string") return;
-          processPayload(payload);
-        }
-        const registry = window.__native_message_listeners__;
-        if (registry && typeof registry.add === "function") {
-          registry.add(handler);
-          return () => {
-            registry.remove(handler);
-          };
-        }
-        const prev = window.__native_message__;
-        function fallbackHandler(msg) {
-          let parsed;
-          try {
-            parsed = JSON.parse(msg);
-          } catch {
-            prev?.(msg);
-            return;
-          }
-          if (!isEnvelope(parsed) || parsed.$ch !== channel) {
-            prev?.(msg);
-            return;
-          }
-          const payload = parsed.p;
-          if (!payload || typeof payload.t !== "string") {
-            prev?.(msg);
-            return;
-          }
-          processPayload(payload);
-        }
-        try {
-          window.__native_message__ = fallbackHandler;
-        } catch {
-        }
-        return () => {
-          try {
-            if (window.__native_message__ === fallbackHandler) {
-              window.__native_message__ = prev;
-            }
-          } catch {
-          }
-        };
-      }
-    }
-  };
+	const { id, channel, getKey } = config;
+	return {
+		id,
+		getKey,
+		sync: { sync: (params) => {
+			const { begin, write, commit, markReady } = params;
+			function processPayload(payload) {
+				switch (payload.t) {
+					case "i":
+						begin();
+						write({
+							type: "insert",
+							value: payload.v
+						});
+						commit();
+						break;
+					case "u":
+						begin();
+						write({
+							type: "update",
+							value: payload.v
+						});
+						commit();
+						break;
+					case "d":
+						begin();
+						write({
+							key: payload.k,
+							type: "delete"
+						});
+						commit();
+						break;
+					case "s":
+						begin();
+						for (const item of payload.items) write({
+							type: "insert",
+							value: item.v
+						});
+						commit();
+						markReady();
+						break;
+					case "b":
+						begin();
+						for (const op of payload.ops) switch (op.t) {
+							case "i":
+								write({
+									type: "insert",
+									value: op.v
+								});
+								break;
+							case "u":
+								write({
+									type: "update",
+									value: op.v
+								});
+								break;
+							case "d":
+								write({
+									key: op.k,
+									type: "delete"
+								});
+								break;
+						}
+						commit();
+						break;
+				}
+			}
+			/** Handler that filters for our channel and dispatches. */
+			function handler(msg) {
+				let parsed;
+				try {
+					parsed = JSON.parse(msg);
+				} catch {
+					return;
+				}
+				if (!isEnvelope(parsed) || parsed.$ch !== channel) return;
+				const payload = parsed.p;
+				if (!payload || typeof payload.t !== "string") return;
+				processPayload(payload);
+			}
+			const registry = window.__native_message_listeners__;
+			if (registry && typeof registry.add === "function") {
+				registry.add(handler);
+				return () => {
+					registry.remove(handler);
+				};
+			}
+			const prev = window.__native_message__;
+			function fallbackHandler(msg) {
+				let parsed;
+				try {
+					parsed = JSON.parse(msg);
+				} catch {
+					prev?.(msg);
+					return;
+				}
+				if (!isEnvelope(parsed) || parsed.$ch !== channel) {
+					prev?.(msg);
+					return;
+				}
+				const payload = parsed.p;
+				if (!payload || typeof payload.t !== "string") {
+					prev?.(msg);
+					return;
+				}
+				processPayload(payload);
+			}
+			try {
+				window.__native_message__ = fallbackHandler;
+			} catch {}
+			return () => {
+				try {
+					if (window.__native_message__ === fallbackHandler) window.__native_message__ = prev;
+				} catch {}
+			};
+		} }
+	};
 }
-export {
-  nativeWindowCollectionOptions
-};
+//#endregion
+export { nativeWindowCollectionOptions };

package/dist/index.js

@@ -1,59 +1,124 @@
+//#region index.ts
+/**
+* Create a host-side data source that pushes mutations to the
+* webview via native-window IPC.
+*
+* The data source maintains an internal `Map` of all items so it
+* can send full snapshots on demand (e.g. after a page reload).
+* Individual mutations (`insert`, `update`, `delete`) update the
+* map *and* send an incremental IPC message.
+*
+* @param sender - Any object with a `postMessage` method (e.g. a `NativeWindow`).
+* @param options - Data source configuration.
+* @returns A {@link DataSource} with imperative push methods.
+*
+* @example
+* ```ts
+* import { NativeWindow } from "@nativewindow/webview";
+* import { createDataSource } from "@nativewindow/tsdb";
+*
+* const win = new NativeWindow({ title: "My App" });
+* win.loadUrl("http://localhost:5173");
+*
+* const todos = createDataSource<Todo, string>(win, {
+*   channel: "tsdb:todos",
+*   getKey: (todo) => todo.id,
+* });
+*
+* todos.insert({ id: "1", text: "Hello", done: false });
+*
+* // Re-send full state after page load
+* win.onPageLoad((event) => {
+*   if (event === "finished") todos.sync();
+* });
+* ```
+*/
 function createDataSource(sender, options) {
-  const { channel, getKey } = options;
-  const items = /* @__PURE__ */ new Map();
-  function send(payload) {
-    sender.postMessage(JSON.stringify({ $ch: channel, p: payload }));
-  }
-  function sendSnapshot() {
-    const entries = [];
-    items.forEach((v, k) => entries.push({ k, v }));
-    send({ t: "s", items: entries });
-  }
-  return {
-    insert(item) {
-      const key = getKey(item);
-      items.set(key, item);
-      send({ t: "i", k: key, v: item });
-    },
-    update(key, item) {
-      items.set(key, item);
-      send({ t: "u", k: key, v: item });
-    },
-    delete(key) {
-      items.delete(key);
-      send({ t: "d", k: key });
-    },
-    batch(fn) {
-      const ops = [];
-      const builder = {
-        insert(item) {
-          const key = getKey(item);
-          items.set(key, item);
-          ops.push({ t: "i", k: key, v: item });
-        },
-        update(key, item) {
-          items.set(key, item);
-          ops.push({ t: "u", k: key, v: item });
-        },
-        delete(key) {
-          items.delete(key);
-          ops.push({ t: "d", k: key });
-        }
-      };
-      fn(builder);
-      if (ops.length > 0) send({ t: "b", ops });
-    },
-    sync(newItems) {
-      if (newItems !== void 0) {
-        items.clear();
-        for (const item of newItems) {
-          items.set(getKey(item), item);
-        }
-      }
-      sendSnapshot();
-    }
-  };
+	const { channel, getKey } = options;
+	const items = /* @__PURE__ */ new Map();
+	function send(payload) {
+		sender.postMessage(JSON.stringify({
+			$ch: channel,
+			p: payload
+		}));
+	}
+	function sendSnapshot() {
+		const entries = [];
+		items.forEach((v, k) => entries.push({
+			k,
+			v
+		}));
+		send({
+			t: "s",
+			items: entries
+		});
+	}
+	return {
+		insert(item) {
+			const key = getKey(item);
+			items.set(key, item);
+			send({
+				t: "i",
+				k: key,
+				v: item
+			});
+		},
+		update(key, item) {
+			items.set(key, item);
+			send({
+				t: "u",
+				k: key,
+				v: item
+			});
+		},
+		delete(key) {
+			items.delete(key);
+			send({
+				t: "d",
+				k: key
+			});
+		},
+		batch(fn) {
+			const ops = [];
+			fn({
+				insert(item) {
+					const key = getKey(item);
+					items.set(key, item);
+					ops.push({
+						t: "i",
+						k: key,
+						v: item
+					});
+				},
+				update(key, item) {
+					items.set(key, item);
+					ops.push({
+						t: "u",
+						k: key,
+						v: item
+					});
+				},
+				delete(key) {
+					items.delete(key);
+					ops.push({
+						t: "d",
+						k: key
+					});
+				}
+			});
+			if (ops.length > 0) send({
+				t: "b",
+				ops
+			});
+		},
+		sync(newItems) {
+			if (newItems !== void 0) {
+				items.clear();
+				for (const item of newItems) items.set(getKey(item), item);
+			}
+			sendSnapshot();
+		}
+	};
 }
-export {
-  createDataSource
-};
+//#endregion
+export { createDataSource };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nativewindow/tsdb",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "TanStack DB collection adapter for native-window IPC (beta)",
   "homepage": "https://nativewindow.fcannizzaro.com",
   "bugs": {
@@ -46,13 +46,13 @@
   },
   "devDependencies": {
     "@types/bun": "^1.3.9",
-    "vite": "^7.3.1",
+    "vite": "^8.0.3",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.0.18",
+    "vitest": "^4.1.2",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@nativewindow/webview": "workspace:*",
-    "typescript": "^5"
+    "@nativewindow/webview": "^1.0.0",
+    "typescript": "^6.0.2"
   }
 }