@noy-db/in-zustand 0.2.0-pre.9 → 0.3.0-pre.2

package/README.md

@@ -26,7 +26,7 @@ See the [main repository](https://github.com/vLannaAi/noy-db#readme) for setup,
 
 - Source — [`packages/in-zustand`](https://github.com/vLannaAi/noy-db/tree/main/packages/in-zustand)
 - Issues — [github.com/vLannaAi/noy-db/issues](https://github.com/vLannaAi/noy-db/issues)
-- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db/blob/main/SPEC.md)
+- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db-docs/blob/main/SPEC.md)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noy-db/in-zustand",
-  "version": "0.2.0-pre.9",
+  "version": "0.3.0-pre.2",
   "description": "Zustand adapter for noy-db — factory that mirrors defineNoydbStore for Zustand users, auto-syncs state from noy-db change events, and supports optimistic mutations.",
   "license": "MIT",
   "author": "vLannaAi <vicio@lanna.ai>",
@@ -17,17 +17,10 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -36,15 +29,15 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "peerDependencies": {
     "zustand": "^4.0.0 || ^5.0.0",
-    "@noy-db/hub": "0.2.0-pre.9"
+    "@noy-db/hub": "0.3.0-pre.2"
   },
   "devDependencies": {
     "zustand": "^5.0.0",
-    "@noy-db/hub": "0.2.0-pre.9"
+    "@noy-db/hub": "0.3.0-pre.2"
   },
   "keywords": [
     "noy-db",

package/dist/index.cjs

@@ -1,95 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  createNoydbStore: () => createNoydbStore
-});
-module.exports = __toCommonJS(index_exports);
-function createNoydbStore(getCollection) {
-  return (set, get) => {
-    let subscribed = false;
-    let unsubscribe = null;
-    async function ensureSubscribed(coll) {
-      if (subscribed) return;
-      subscribed = true;
-      unsubscribe = coll.subscribe(() => {
-        void get().refresh();
-      });
-    }
-    async function load() {
-      try {
-        const coll = await Promise.resolve(getCollection());
-        await ensureSubscribed(coll);
-        const list = await coll.list();
-        const ids = await coll.list().then((rows) => rows.map((_r, i) => String(i)));
-        const records = {};
-        list.forEach((rec, idx) => {
-          const maybeId = rec.id;
-          records[maybeId ?? ids[idx]] = rec;
-        });
-        set({ records, loading: false, error: null });
-      } catch (err) {
-        set({ records: {}, loading: false, error: err });
-      }
-    }
-    void load();
-    return {
-      records: {},
-      loading: true,
-      error: null,
-      async put(id, value) {
-        try {
-          const coll = await Promise.resolve(getCollection());
-          await coll.put(id, value);
-        } catch (err) {
-          set({ error: err });
-          throw err;
-        }
-      },
-      async remove(id) {
-        try {
-          const coll = await Promise.resolve(getCollection());
-          await coll.delete(id);
-        } catch (err) {
-          set({ error: err });
-          throw err;
-        }
-      },
-      async refresh() {
-        await load();
-      },
-      // Internal cleanup helper — Zustand stores don't have a native
-      // unmount hook, so framework bindings can call this when
-      // tearing down.
-      ...{
-        _unsubscribe() {
-          unsubscribe?.();
-          subscribed = false;
-        }
-      }
-    };
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createNoydbStore
-});
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/in-zustand** — Zustand adapter for noy-db.\n *\n * Factory that creates a Zustand store backed by a noy-db\n * `Collection<T>`. Reads hydrate from the collection on first access\n * and auto-refresh on every change event; writes go through the\n * collection (and are therefore encrypted + replicated by the sync\n * engine).\n *\n * ```ts\n * import { create } from 'zustand'\n * import { createNoydbStore } from '@noy-db/in-zustand'\n *\n * const useInvoices = create(createNoydbStore(() => db.vault('acme').collection<Invoice>('invoices')))\n * ```\n *\n * The returned state slice shape:\n *\n * ```ts\n * {\n *   records: Record<string, T>\n *   loading: boolean\n *   error: Error | null\n *   put: (id, value) => Promise<void>\n *   remove: (id) => Promise<void>\n *   refresh: () => Promise<void>\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { StateCreator } from 'zustand'\nimport type { Collection } from '@noy-db/hub'\n\nexport interface NoydbZustandSlice<T> {\n  /** Current records keyed by id. */\n  records: Record<string, T>\n  /** True during the initial hydration. */\n  loading: boolean\n  /** Error from hydration or a mutation. */\n  error: Error | null\n  /** Put a record — encrypts + writes + fires the auto-refresh. */\n  put(id: string, value: T): Promise<void>\n  /** Delete a record. */\n  remove(id: string): Promise<void>\n  /** Re-hydrate from the underlying collection. */\n  refresh(): Promise<void>\n}\n\n/**\n * Produce a Zustand `StateCreator` backed by a noy-db collection.\n *\n * The `getCollection` factory is called lazily on first access so\n * consumers can wire the store while the `Noydb` instance is still\n * being opened asynchronously — the first `refresh()` waits for the\n * factory to succeed before hydrating.\n */\nexport function createNoydbStore<T>(\n  getCollection: () => Collection<T> | Promise<Collection<T>>,\n): StateCreator<NoydbZustandSlice<T>> {\n  return (set, get) => {\n    let subscribed = false\n    let unsubscribe: (() => void) | null = null\n\n    async function ensureSubscribed(coll: Collection<T>): Promise<void> {\n      if (subscribed) return\n      subscribed = true\n      unsubscribe = coll.subscribe(() => {\n        void get().refresh()\n      })\n    }\n\n    async function load(): Promise<void> {\n      try {\n        const coll = await Promise.resolve(getCollection())\n        await ensureSubscribed(coll)\n        const list = await coll.list()\n        const ids = await coll.list().then(rows => rows.map((_r, i) => String(i)))\n        // Derive an id map. list() returns records; get the id via the envelope round-trip.\n        // Fallback: use each record's own `id` field when present; else use string index.\n        const records: Record<string, T> = {}\n        list.forEach((rec, idx) => {\n          const maybeId = (rec as unknown as { id?: string }).id\n          records[maybeId ?? ids[idx]!] = rec\n        })\n        set({ records, loading: false, error: null })\n      } catch (err) {\n        set({ records: {}, loading: false, error: err as Error })\n      }\n    }\n\n    // Trigger initial load on first read.\n    void load()\n\n    return {\n      records: {},\n      loading: true,\n      error: null,\n\n      async put(id, value) {\n        try {\n          const coll = await Promise.resolve(getCollection())\n          await coll.put(id, value)\n          // `subscribe()` will trigger refresh; no manual state update needed here.\n        } catch (err) {\n          set({ error: err as Error })\n          throw err\n        }\n      },\n\n      async remove(id) {\n        try {\n          const coll = await Promise.resolve(getCollection())\n          await coll.delete(id)\n        } catch (err) {\n          set({ error: err as Error })\n          throw err\n        }\n      },\n\n      async refresh() {\n        await load()\n      },\n\n      // Internal cleanup helper — Zustand stores don't have a native\n      // unmount hook, so framework bindings can call this when\n      // tearing down.\n      ...({\n        _unsubscribe(): void {\n          unsubscribe?.()\n          subscribed = false\n        },\n      } as Record<string, () => void>),\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0DO,SAAS,iBACd,eACoC;AACpC,SAAO,CAAC,KAAK,QAAQ;AACnB,QAAI,aAAa;AACjB,QAAI,cAAmC;AAEvC,mBAAe,iBAAiB,MAAoC;AAClE,UAAI,WAAY;AAChB,mBAAa;AACb,oBAAc,KAAK,UAAU,MAAM;AACjC,aAAK,IAAI,EAAE,QAAQ;AAAA,MACrB,CAAC;AAAA,IACH;AAEA,mBAAe,OAAsB;AACnC,UAAI;AACF,cAAM,OAAO,MAAM,QAAQ,QAAQ,cAAc,CAAC;AAClD,cAAM,iBAAiB,IAAI;AAC3B,cAAM,OAAO,MAAM,KAAK,KAAK;AAC7B,cAAM,MAAM,MAAM,KAAK,KAAK,EAAE,KAAK,UAAQ,KAAK,IAAI,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC;AAGzE,cAAM,UAA6B,CAAC;AACpC,aAAK,QAAQ,CAAC,KAAK,QAAQ;AACzB,gBAAM,UAAW,IAAmC;AACpD,kBAAQ,WAAW,IAAI,GAAG,CAAE,IAAI;AAAA,QAClC,CAAC;AACD,YAAI,EAAE,SAAS,SAAS,OAAO,OAAO,KAAK,CAAC;AAAA,MAC9C,SAAS,KAAK;AACZ,YAAI,EAAE,SAAS,CAAC,GAAG,SAAS,OAAO,OAAO,IAAa,CAAC;AAAA,MAC1D;AAAA,IACF;AAGA,SAAK,KAAK;AAEV,WAAO;AAAA,MACL,SAAS,CAAC;AAAA,MACV,SAAS;AAAA,MACT,OAAO;AAAA,MAEP,MAAM,IAAI,IAAI,OAAO;AACnB,YAAI;AACF,gBAAM,OAAO,MAAM,QAAQ,QAAQ,cAAc,CAAC;AAClD,gBAAM,KAAK,IAAI,IAAI,KAAK;AAAA,QAE1B,SAAS,KAAK;AACZ,cAAI,EAAE,OAAO,IAAa,CAAC;AAC3B,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,MAEA,MAAM,OAAO,IAAI;AACf,YAAI;AACF,gBAAM,OAAO,MAAM,QAAQ,QAAQ,cAAc,CAAC;AAClD,gBAAM,KAAK,OAAO,EAAE;AAAA,QACtB,SAAS,KAAK;AACZ,cAAI,EAAE,OAAO,IAAa,CAAC;AAC3B,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,MAEA,MAAM,UAAU;AACd,cAAM,KAAK;AAAA,MACb;AAAA;AAAA;AAAA;AAAA,MAKA,GAAI;AAAA,QACF,eAAqB;AACnB,wBAAc;AACd,uBAAa;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.cts

@@ -1,60 +0,0 @@
-import { StateCreator } from 'zustand';
-import { Collection } from '@noy-db/hub';
-
-/**
- * **@noy-db/in-zustand** — Zustand adapter for noy-db.
- *
- * Factory that creates a Zustand store backed by a noy-db
- * `Collection<T>`. Reads hydrate from the collection on first access
- * and auto-refresh on every change event; writes go through the
- * collection (and are therefore encrypted + replicated by the sync
- * engine).
- *
- * ```ts
- * import { create } from 'zustand'
- * import { createNoydbStore } from '@noy-db/in-zustand'
- *
- * const useInvoices = create(createNoydbStore(() => db.vault('acme').collection<Invoice>('invoices')))
- * ```
- *
- * The returned state slice shape:
- *
- * ```ts
- * {
- *   records: Record<string, T>
- *   loading: boolean
- *   error: Error | null
- *   put: (id, value) => Promise<void>
- *   remove: (id) => Promise<void>
- *   refresh: () => Promise<void>
- * }
- * ```
- *
- * @packageDocumentation
- */
-
-interface NoydbZustandSlice<T> {
-    /** Current records keyed by id. */
-    records: Record<string, T>;
-    /** True during the initial hydration. */
-    loading: boolean;
-    /** Error from hydration or a mutation. */
-    error: Error | null;
-    /** Put a record — encrypts + writes + fires the auto-refresh. */
-    put(id: string, value: T): Promise<void>;
-    /** Delete a record. */
-    remove(id: string): Promise<void>;
-    /** Re-hydrate from the underlying collection. */
-    refresh(): Promise<void>;
-}
-/**
- * Produce a Zustand `StateCreator` backed by a noy-db collection.
- *
- * The `getCollection` factory is called lazily on first access so
- * consumers can wire the store while the `Noydb` instance is still
- * being opened asynchronously — the first `refresh()` waits for the
- * factory to succeed before hydrating.
- */
-declare function createNoydbStore<T>(getCollection: () => Collection<T> | Promise<Collection<T>>): StateCreator<NoydbZustandSlice<T>>;
-
-export { type NoydbZustandSlice, createNoydbStore };