@noy-db/in-svelte 0.1.0-pre.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vLannaAi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @noy-db/in-svelte
+
+[![npm](https://img.shields.io/npm/v/%40noy-db/in-svelte.svg)](https://www.npmjs.com/package/@noy-db/in-svelte)
+
+> Svelte stores for noy-db
+
+Part of [**`@noy-db/hub`**](https://www.npmjs.com/package/@noy-db/hub) — the zero-knowledge, offline-first, encrypted document store.
+
+## Install
+
+```bash
+pnpm add @noy-db/hub @noy-db/in-svelte
+```
+
+## What it is
+
+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).
+
+## Status
+
+**Pre-release** (`0.1.0-pre.1`). API may change before `1.0`.
+
+## Documentation
+
+See the [main repository](https://github.com/vLannaAi/noy-db#readme) for setup, examples, and the full subsystem catalog.
+
+- 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)
+
+## License
+
+[MIT](./LICENSE) © vLannaAi

package/dist/index.cjs

@@ -0,0 +1,104 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,94 @@
+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 };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+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 };

package/dist/index.js

@@ -0,0 +1,77 @@
+// src/index.ts
+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)
+  };
+}
+export {
+  collectionStore,
+  queryStore,
+  syncStore
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"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":";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/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@noy-db/in-svelte",
+  "version": "0.1.0-pre.3",
+  "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>",
+  "homepage": "https://github.com/vLannaAi/noy-db/tree/main/packages/in-svelte#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vLannaAi/noy-db.git",
+    "directory": "packages/in-svelte"
+  },
+  "bugs": {
+    "url": "https://github.com/vLannaAi/noy-db/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@noy-db/hub": "0.1.0-pre.3"
+  },
+  "devDependencies": {
+    "@noy-db/hub": "0.1.0-pre.3"
+  },
+  "keywords": [
+    "noy-db",
+    "in-svelte",
+    "svelte",
+    "stores",
+    "sveltekit"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  }
+}