@noy-db/in-svelte 0.2.0-pre.8 → 0.3.0-pre.1

package/README.md

@@ -26,7 +26,7 @@ See the [main repository](https://github.com/vLannaAi/noy-db#readme) for setup,
 
 - Source — [`packages/in-svelte`](https://github.com/vLannaAi/noy-db/tree/main/packages/in-svelte)
 - 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-svelte",
-  "version": "0.2.0-pre.8",
+  "version": "0.3.0-pre.1",
   "description": "Svelte stores for noy-db — collectionStore / queryStore / syncStore backed by noy-db change events. Works with Svelte 4 store contract and Svelte 5 runes (via $store subscription interop).",
   "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,13 +29,13 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "peerDependencies": {
-    "@noy-db/hub": "0.2.0-pre.8"
+    "@noy-db/hub": "0.3.0-pre.1"
   },
   "devDependencies": {
-    "@noy-db/hub": "0.2.0-pre.8"
+    "@noy-db/hub": "0.3.0-pre.1"
   },
   "keywords": [
     "noy-db",

package/dist/index.cjs

@@ -1,104 +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, {
-  collectionStore: () => collectionStore,
-  queryStore: () => queryStore,
-  syncStore: () => syncStore
-});
-module.exports = __toCommonJS(index_exports);
-function writable(initial) {
-  let value = initial;
-  const subscribers = /* @__PURE__ */ new Set();
-  return {
-    set(next) {
-      value = next;
-      for (const s of subscribers) s(next);
-    },
-    subscribe(run) {
-      subscribers.add(run);
-      run(value);
-      return () => {
-        subscribers.delete(run);
-      };
-    }
-  };
-}
-function collectionStore(vault, collectionName) {
-  const inner = writable({ records: [], loading: true, error: null });
-  const coll = vault.collection(collectionName);
-  async function refresh() {
-    try {
-      const records = await coll.list();
-      inner.set({ records, loading: false, error: null });
-    } catch (err) {
-      inner.set({ records: [], loading: false, error: err });
-    }
-  }
-  void refresh();
-  const unsubscribe = coll.subscribe(() => {
-    void refresh();
-  });
-  return {
-    subscribe: (run) => inner.subscribe(run),
-    refresh,
-    stop: unsubscribe
-  };
-}
-function queryStore(vault, collectionName, builder) {
-  const inner = writable({ data: null, loading: true, error: null });
-  const coll = vault.collection(collectionName);
-  async function refresh() {
-    try {
-      const result = await Promise.resolve(builder(coll.query()));
-      inner.set({ data: result, loading: false, error: null });
-    } catch (err) {
-      inner.set({ data: null, loading: false, error: err });
-    }
-  }
-  void refresh();
-  const unsubscribe = coll.subscribe(() => {
-    void refresh();
-  });
-  return {
-    subscribe: (run) => inner.subscribe(run),
-    refresh,
-    stop: unsubscribe
-  };
-}
-function syncStore(db) {
-  const inner = writable({ lastEvent: null, error: null });
-  const handler = (event) => {
-    inner.set({ lastEvent: event, error: null });
-  };
-  db.on("change", handler);
-  return {
-    subscribe: (run) => inner.subscribe(run),
-    stop: () => db.off("change", handler)
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  collectionStore,
-  queryStore,
-  syncStore
-});
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/in-svelte** — Svelte stores for noy-db.\n *\n * Three store factories that conform to Svelte's standard store\n * contract (`subscribe(fn) → unsubscribe`). Works with:\n *\n *   - Svelte 4 components via the `$store` auto-subscription syntax\n *   - Svelte 5 runes via `$state(await fromStore(s).current)` or a\n *     small `fromStore()` shim\n *   - Any framework that consumes the Svelte store contract\n *     (e.g. `@gradio/client`, non-Svelte integrations)\n *\n * ## Factories\n *\n *   - {@link collectionStore} — reactive list of records.\n *   - {@link queryStore}      — reactive result of a query builder.\n *   - {@link syncStore}       — reactive Noydb-level change feed.\n *\n * ## Zero dependencies\n *\n * Svelte's store contract is ~10 lines of TypeScript. We re-implement\n * it inline rather than take a `svelte` peer-dep — the contract is\n * stable across Svelte 4/5 and the extra dependency is unnecessary\n * for store-only consumers (e.g. SvelteKit load functions).\n *\n * @packageDocumentation\n */\n\nimport type { Noydb, Vault, ChangeEvent, Query } from '@noy-db/hub'\n\n// ─── Svelte store contract (re-implemented, no svelte peer dep) ─────────\n\ntype Subscriber<T> = (value: T) => void\ntype Unsubscriber = () => void\n\nexport interface Readable<T> {\n  subscribe(run: Subscriber<T>): Unsubscriber\n}\n\nfunction writable<T>(initial: T): {\n  set(value: T): void\n  subscribe(run: Subscriber<T>): Unsubscriber\n} {\n  let value = initial\n  const subscribers = new Set<Subscriber<T>>()\n  return {\n    set(next) {\n      value = next\n      for (const s of subscribers) s(next)\n    },\n    subscribe(run) {\n      subscribers.add(run)\n      run(value)\n      return () => { subscribers.delete(run) }\n    },\n  }\n}\n\n// ─── collectionStore ───────────────────────────────────────────────────\n\nexport interface CollectionStoreState<T> {\n  readonly records: readonly T[]\n  readonly loading: boolean\n  readonly error: Error | null\n}\n\n/**\n * Reactive collection records. Re-emits on every change event from\n * the collection (put / delete / sync).\n *\n * ```svelte\n * <script>\n *   import { collectionStore } from '@noy-db/in-svelte'\n *   const invoices = collectionStore(vault, 'invoices')\n * </script>\n *\n * {#each $invoices.records as invoice}\n *   {invoice.id}\n * {/each}\n * ```\n */\nexport function collectionStore<T>(\n  vault: Vault,\n  collectionName: string,\n): Readable<CollectionStoreState<T>> & { refresh(): Promise<void>; stop(): void } {\n  const inner = writable<CollectionStoreState<T>>({ records: [], loading: true, error: null })\n  const coll = vault.collection<T>(collectionName)\n\n  async function refresh(): Promise<void> {\n    try {\n      const records = await coll.list()\n      inner.set({ records, loading: false, error: null })\n    } catch (err) {\n      inner.set({ records: [], loading: false, error: err as Error })\n    }\n  }\n\n  void refresh()\n  const unsubscribe = coll.subscribe(() => { void refresh() })\n\n  return {\n    subscribe: (run) => inner.subscribe(run),\n    refresh,\n    stop: unsubscribe,\n  }\n}\n\n// ─── queryStore ────────────────────────────────────────────────────────\n\nexport interface QueryStoreState<R> {\n  readonly data: R | null\n  readonly loading: boolean\n  readonly error: Error | null\n}\n\n/**\n * Reactive result of a query builder. The builder is re-run on every\n * change event — useful for aggregates, joins, and filtered lists.\n *\n * ```svelte\n * <script>\n *   import { queryStore } from '@noy-db/in-svelte'\n *   const paid = queryStore(vault, 'invoices', q => q.where('status', '==', 'paid').toArray())\n * </script>\n *\n * {#if $paid.loading} Loading… {:else} {$paid.data?.length} paid {/if}\n * ```\n */\nexport function queryStore<T, R>(\n  vault: Vault,\n  collectionName: string,\n  builder: (q: Query<T>) => Promise<R> | R,\n): Readable<QueryStoreState<R>> & { refresh(): Promise<void>; stop(): void } {\n  const inner = writable<QueryStoreState<R>>({ data: null, loading: true, error: null })\n  const coll = vault.collection<T>(collectionName)\n\n  async function refresh(): Promise<void> {\n    try {\n      const result = await Promise.resolve(builder(coll.query() as unknown as Query<T>))\n      inner.set({ data: result, loading: false, error: null })\n    } catch (err) {\n      inner.set({ data: null, loading: false, error: err as Error })\n    }\n  }\n\n  void refresh()\n  const unsubscribe = coll.subscribe(() => { void refresh() })\n\n  return {\n    subscribe: (run) => inner.subscribe(run),\n    refresh,\n    stop: unsubscribe,\n  }\n}\n\n// ─── syncStore ─────────────────────────────────────────────────────────\n\nexport interface SyncStoreState {\n  readonly lastEvent: ChangeEvent | null\n  readonly error: Error | null\n}\n\n/**\n * Reactive Noydb-level change feed. Useful for top-level status\n * indicators (last-update-time, \"unsynced changes\", offline banners).\n */\nexport function syncStore(db: Noydb): Readable<SyncStoreState> & { stop(): void } {\n  const inner = writable<SyncStoreState>({ lastEvent: null, error: null })\n\n  const handler = (event: ChangeEvent): void => {\n    inner.set({ lastEvent: event, error: null })\n  }\n  db.on('change', handler)\n\n  return {\n    subscribe: (run) => inner.subscribe(run),\n    stop: () => db.off('change', handler),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuCA,SAAS,SAAY,SAGnB;AACA,MAAI,QAAQ;AACZ,QAAM,cAAc,oBAAI,IAAmB;AAC3C,SAAO;AAAA,IACL,IAAI,MAAM;AACR,cAAQ;AACR,iBAAW,KAAK,YAAa,GAAE,IAAI;AAAA,IACrC;AAAA,IACA,UAAU,KAAK;AACb,kBAAY,IAAI,GAAG;AACnB,UAAI,KAAK;AACT,aAAO,MAAM;AAAE,oBAAY,OAAO,GAAG;AAAA,MAAE;AAAA,IACzC;AAAA,EACF;AACF;AAyBO,SAAS,gBACd,OACA,gBACgF;AAChF,QAAM,QAAQ,SAAkC,EAAE,SAAS,CAAC,GAAG,SAAS,MAAM,OAAO,KAAK,CAAC;AAC3F,QAAM,OAAO,MAAM,WAAc,cAAc;AAE/C,iBAAe,UAAyB;AACtC,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,KAAK;AAChC,YAAM,IAAI,EAAE,SAAS,SAAS,OAAO,OAAO,KAAK,CAAC;AAAA,IACpD,SAAS,KAAK;AACZ,YAAM,IAAI,EAAE,SAAS,CAAC,GAAG,SAAS,OAAO,OAAO,IAAa,CAAC;AAAA,IAChE;AAAA,EACF;AAEA,OAAK,QAAQ;AACb,QAAM,cAAc,KAAK,UAAU,MAAM;AAAE,SAAK,QAAQ;AAAA,EAAE,CAAC;AAE3D,SAAO;AAAA,IACL,WAAW,CAAC,QAAQ,MAAM,UAAU,GAAG;AAAA,IACvC;AAAA,IACA,MAAM;AAAA,EACR;AACF;AAuBO,SAAS,WACd,OACA,gBACA,SAC2E;AAC3E,QAAM,QAAQ,SAA6B,EAAE,MAAM,MAAM,SAAS,MAAM,OAAO,KAAK,CAAC;AACrF,QAAM,OAAO,MAAM,WAAc,cAAc;AAE/C,iBAAe,UAAyB;AACtC,QAAI;AACF,YAAM,SAAS,MAAM,QAAQ,QAAQ,QAAQ,KAAK,MAAM,CAAwB,CAAC;AACjF,YAAM,IAAI,EAAE,MAAM,QAAQ,SAAS,OAAO,OAAO,KAAK,CAAC;AAAA,IACzD,SAAS,KAAK;AACZ,YAAM,IAAI,EAAE,MAAM,MAAM,SAAS,OAAO,OAAO,IAAa,CAAC;AAAA,IAC/D;AAAA,EACF;AAEA,OAAK,QAAQ;AACb,QAAM,cAAc,KAAK,UAAU,MAAM;AAAE,SAAK,QAAQ;AAAA,EAAE,CAAC;AAE3D,SAAO;AAAA,IACL,WAAW,CAAC,QAAQ,MAAM,UAAU,GAAG;AAAA,IACvC;AAAA,IACA,MAAM;AAAA,EACR;AACF;AAaO,SAAS,UAAU,IAAwD;AAChF,QAAM,QAAQ,SAAyB,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAEvE,QAAM,UAAU,CAAC,UAA6B;AAC5C,UAAM,IAAI,EAAE,WAAW,OAAO,OAAO,KAAK,CAAC;AAAA,EAC7C;AACA,KAAG,GAAG,UAAU,OAAO;AAEvB,SAAO;AAAA,IACL,WAAW,CAAC,QAAQ,MAAM,UAAU,GAAG;AAAA,IACvC,MAAM,MAAM,GAAG,IAAI,UAAU,OAAO;AAAA,EACtC;AACF;","names":[]}

package/dist/index.d.cts

@@ -1,94 +0,0 @@
-import { ChangeEvent, Vault, Query, Noydb } from '@noy-db/hub';
-
-/**
- * **@noy-db/in-svelte** — Svelte stores for noy-db.
- *
- * Three store factories that conform to Svelte's standard store
- * contract (`subscribe(fn) → unsubscribe`). Works with:
- *
- *   - Svelte 4 components via the `$store` auto-subscription syntax
- *   - Svelte 5 runes via `$state(await fromStore(s).current)` or a
- *     small `fromStore()` shim
- *   - Any framework that consumes the Svelte store contract
- *     (e.g. `@gradio/client`, non-Svelte integrations)
- *
- * ## Factories
- *
- *   - {@link collectionStore} — reactive list of records.
- *   - {@link queryStore}      — reactive result of a query builder.
- *   - {@link syncStore}       — reactive Noydb-level change feed.
- *
- * ## Zero dependencies
- *
- * Svelte's store contract is ~10 lines of TypeScript. We re-implement
- * it inline rather than take a `svelte` peer-dep — the contract is
- * stable across Svelte 4/5 and the extra dependency is unnecessary
- * for store-only consumers (e.g. SvelteKit load functions).
- *
- * @packageDocumentation
- */
-
-type Subscriber<T> = (value: T) => void;
-type Unsubscriber = () => void;
-interface Readable<T> {
-    subscribe(run: Subscriber<T>): Unsubscriber;
-}
-interface CollectionStoreState<T> {
-    readonly records: readonly T[];
-    readonly loading: boolean;
-    readonly error: Error | null;
-}
-/**
- * Reactive collection records. Re-emits on every change event from
- * the collection (put / delete / sync).
- *
- * ```svelte
- * <script>
- *   import { collectionStore } from '@noy-db/in-svelte'
- *   const invoices = collectionStore(vault, 'invoices')
- * </script>
- *
- * {#each $invoices.records as invoice}
- *   {invoice.id}
- * {/each}
- * ```
- */
-declare function collectionStore<T>(vault: Vault, collectionName: string): Readable<CollectionStoreState<T>> & {
-    refresh(): Promise<void>;
-    stop(): void;
-};
-interface QueryStoreState<R> {
-    readonly data: R | null;
-    readonly loading: boolean;
-    readonly error: Error | null;
-}
-/**
- * Reactive result of a query builder. The builder is re-run on every
- * change event — useful for aggregates, joins, and filtered lists.
- *
- * ```svelte
- * <script>
- *   import { queryStore } from '@noy-db/in-svelte'
- *   const paid = queryStore(vault, 'invoices', q => q.where('status', '==', 'paid').toArray())
- * </script>
- *
- * {#if $paid.loading} Loading… {:else} {$paid.data?.length} paid {/if}
- * ```
- */
-declare function queryStore<T, R>(vault: Vault, collectionName: string, builder: (q: Query<T>) => Promise<R> | R): Readable<QueryStoreState<R>> & {
-    refresh(): Promise<void>;
-    stop(): void;
-};
-interface SyncStoreState {
-    readonly lastEvent: ChangeEvent | null;
-    readonly error: Error | null;
-}
-/**
- * Reactive Noydb-level change feed. Useful for top-level status
- * indicators (last-update-time, "unsynced changes", offline banners).
- */
-declare function syncStore(db: Noydb): Readable<SyncStoreState> & {
-    stop(): void;
-};
-
-export { type CollectionStoreState, type QueryStoreState, type Readable, type SyncStoreState, collectionStore, queryStore, syncStore };