@vielzeug/sourcerer 1.0.6 → 2.0.0

package/dist/fetchManager.d.ts

@@ -1,27 +0,0 @@
-/**
- * Internal fetch deduplication and in-flight request manager.
- *
- * - Deduplicates identical concurrent queries: joiners await the existing in-flight promise.
- * - Aborts superseded in-flight requests when a new query key arrives.
- * - Tracks pending count so callers can reflect loading state.
- *
- * Not exported from the public API — consumed via `asyncSource.ts` by remoteSource,
- * cursorSource, and infiniteSource.
- */
-export type FetchManager<TQuery> = {
-    /** Abort all in-flight requests and clear the registry. */
-    dispose(): void;
-    /** Number of currently in-flight requests (including joiners). */
-    readonly pendingCount: number;
-    /**
-     * Run a fetch for query `q`.
-     *
-     * - If an identical key is already in-flight, joins as a waiter.
-     * - If a different key is in-flight, aborts it and starts a new request.
-     * - Calls `onPendingChange()` whenever `pendingCount` changes.
-     * - Passes an `isLatest()` predicate to `execute` so it can skip stale responses.
-     */
-    run(q: TQuery, execute: (q: TQuery, signal: AbortSignal, isLatest: () => boolean) => Promise<void>, onPendingChange: () => void): Promise<void>;
-};
-export declare function createFetchManager<TQuery>(keyOf: (q: TQuery) => string): FetchManager<TQuery>;
-//# sourceMappingURL=fetchManager.d.ts.map

package/dist/fetchManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetchManager.d.ts","sourceRoot":"","sources":["../src/fetchManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,YAAY,CAAC,MAAM,IAAI;IACjC,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,GAAG,CACD,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,EACnF,eAAe,EAAE,MAAM,IAAI,GAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAiE7F"}

package/dist/fetchManager.js

@@ -1,41 +0,0 @@
-//#region src/fetchManager.ts
-function e(e) {
-	let t = /* @__PURE__ */ new Map(), n = "", r = 0;
-	return {
-		dispose() {
-			for (let e of t.values()) e.controller.abort();
-			t.clear(), r = 0;
-		},
-		get pendingCount() {
-			return r;
-		},
-		async run(i, a, o) {
-			let s = e(i);
-			n = s;
-			for (let [e, n] of t) e !== s && (n.controller.abort(), t.delete(e));
-			let c = t.get(s);
-			if (c) {
-				r++, o();
-				try {
-					await c.promise;
-				} finally {
-					r--, o();
-				}
-				return;
-			}
-			let l = new AbortController();
-			r++, o();
-			let u = a(i, l.signal, () => s === n).finally(() => {
-				t.delete(s), r--, o();
-			});
-			t.set(s, {
-				controller: l,
-				promise: u
-			}), await u;
-		}
-	};
-}
-//#endregion
-export { e as createFetchManager };
-
-//# sourceMappingURL=fetchManager.js.map

package/dist/fetchManager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetchManager.js","names":[],"sources":["../src/fetchManager.ts"],"sourcesContent":["/**\n * Internal fetch deduplication and in-flight request manager.\n *\n * - Deduplicates identical concurrent queries: joiners await the existing in-flight promise.\n * - Aborts superseded in-flight requests when a new query key arrives.\n * - Tracks pending count so callers can reflect loading state.\n *\n * Not exported from the public API — consumed via `asyncSource.ts` by remoteSource,\n * cursorSource, and infiniteSource.\n */\n\ntype InFlightEntry = { controller: AbortController; promise: Promise<void> };\n\nexport type FetchManager<TQuery> = {\n  /** Abort all in-flight requests and clear the registry. */\n  dispose(): void;\n  /** Number of currently in-flight requests (including joiners). */\n  readonly pendingCount: number;\n  /**\n   * Run a fetch for query `q`.\n   *\n   * - If an identical key is already in-flight, joins as a waiter.\n   * - If a different key is in-flight, aborts it and starts a new request.\n   * - Calls `onPendingChange()` whenever `pendingCount` changes.\n   * - Passes an `isLatest()` predicate to `execute` so it can skip stale responses.\n   */\n  run(\n    q: TQuery,\n    execute: (q: TQuery, signal: AbortSignal, isLatest: () => boolean) => Promise<void>,\n    onPendingChange: () => void,\n  ): Promise<void>;\n};\n\nexport function createFetchManager<TQuery>(keyOf: (q: TQuery) => string): FetchManager<TQuery> {\n  const inflight = new Map<string, InFlightEntry>();\n  let latestKey = '';\n  let _pendingCount = 0;\n\n  return {\n    dispose() {\n      for (const entry of inflight.values()) {\n        entry.controller.abort();\n      }\n\n      inflight.clear();\n      _pendingCount = 0;\n    },\n\n    get pendingCount() {\n      return _pendingCount;\n    },\n\n    async run(q, execute, onPendingChange) {\n      const key = keyOf(q);\n\n      latestKey = key;\n\n      // Abort and remove all superseded in-flight requests.\n      for (const [k, entry] of inflight) {\n        if (k !== key) {\n          entry.controller.abort();\n          inflight.delete(k);\n        }\n      }\n\n      // Join an identical in-flight request rather than issuing a duplicate.\n      const existing = inflight.get(key);\n\n      if (existing) {\n        _pendingCount++;\n        onPendingChange();\n\n        try {\n          await existing.promise;\n        } finally {\n          _pendingCount--;\n          onPendingChange();\n        }\n\n        return;\n      }\n\n      // New request.\n      const controller = new AbortController();\n\n      _pendingCount++;\n      onPendingChange();\n\n      const promise = execute(q, controller.signal, () => key === latestKey).finally(() => {\n        inflight.delete(key);\n        _pendingCount--;\n        onPendingChange();\n      });\n\n      inflight.set(key, { controller, promise });\n      await promise;\n    },\n  };\n}\n"],"mappings":";AAiCA,SAAgB,EAA2B,GAAoD;CAC7F,IAAM,oBAAW,IAAI,IAA2B,GAC5C,IAAY,IACZ,IAAgB;CAEpB,OAAO;EACL,UAAU;GACR,KAAK,IAAM,KAAS,EAAS,OAAO,GAClC,EAAM,WAAW,MAAM;GAIzB,AADA,EAAS,MAAM,GACf,IAAgB;EAClB;EAEA,IAAI,eAAe;GACjB,OAAO;EACT;EAEA,MAAM,IAAI,GAAG,GAAS,GAAiB;GACrC,IAAM,IAAM,EAAM,CAAC;GAEnB,IAAY;GAGZ,KAAK,IAAM,CAAC,GAAG,MAAU,GACvB,AAAI,MAAM,MACR,EAAM,WAAW,MAAM,GACvB,EAAS,OAAO,CAAC;GAKrB,IAAM,IAAW,EAAS,IAAI,CAAG;GAEjC,IAAI,GAAU;IAEZ,AADA,KACA,EAAgB;IAEhB,IAAI;KACF,MAAM,EAAS;IACjB,UAAU;KAER,AADA,KACA,EAAgB;IAClB;IAEA;GACF;GAGA,IAAM,IAAa,IAAI,gBAAgB;GAGvC,AADA,KACA,EAAgB;GAEhB,IAAM,IAAU,EAAQ,GAAG,EAAW,cAAc,MAAQ,CAAS,CAAC,CAAC,cAAc;IAGnF,AAFA,EAAS,OAAO,CAAG,GACnB,KACA,EAAgB;GAClB,CAAC;GAGD,AADA,EAAS,IAAI,GAAK;IAAE;IAAY;GAAQ,CAAC,GACzC,MAAM;EACR;CACF;AACF"}

package/dist/merge.cjs

@@ -1,2 +0,0 @@
-const e=require("./core.cjs");function t(t,n){let r=e.createSourceCore(),i=n(t.map(e=>e.current)),a=t.map(e=>e.subscribe(()=>{i=n(t.map(e=>e.current)),r.notify()})),o={get current(){return i},get disposalSignal(){return r.disposalSignal},dispose(){if(!r.isDisposed){for(let e of a)e();r.dispose()}},get disposed(){return r.isDisposed},subscribe(e){return r.subscribe(e)},[Symbol.dispose](){o.dispose()}};return o}exports.mergeSource=t;
-//# sourceMappingURL=merge.cjs.map

package/dist/merge.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge.cjs","names":[],"sources":["../src/merge.ts"],"sourcesContent":["import type { MergedSource } from './types';\n\nimport { createSourceCore } from './core';\n\n/**\n * Combines multiple reactive sources into a single read-only view by applying\n * a user-supplied `combine` function over all sources' `current` arrays.\n *\n * The merged source recalculates whenever any parent source changes. Useful for\n * offline/online hybrid UIs (local + remote merged), multi-dataset views, or\n * pagination across multiple backends.\n *\n * Call `dispose()` to unsubscribe from all parent sources.\n *\n * @example\n * ```ts\n * const local = createLocalSource(localCache, { limit: 50 });\n * const remote = createRemoteSource({ fetch: fetchUsers, limit: 50 });\n *\n * // Show local cache items first, then remote items (deduped by id).\n * const merged = mergeSource([local, remote], (all) => {\n *   const seen = new Set<number>();\n *   return all.flat().filter((u) => !seen.has(u.id) && seen.add(u.id));\n * });\n *\n * merged.subscribe(() => console.log(merged.current));\n * ```\n */\nexport function mergeSource<T>(\n  sources: ReadonlyArray<{\n    readonly current: readonly T[];\n    subscribe(listener: () => void): () => void;\n  }>,\n  combine: (allItems: ReadonlyArray<readonly T[]>) => readonly T[],\n): MergedSource<T> {\n  const core = createSourceCore();\n  let cachedCurrent: readonly T[] = combine(sources.map((s) => s.current));\n\n  const unsubscribeFns = sources.map((source) =>\n    source.subscribe(() => {\n      cachedCurrent = combine(sources.map((s) => s.current));\n      core.notify();\n    }),\n  );\n\n  const source: MergedSource<T> = {\n    get current() {\n      return cachedCurrent;\n    },\n\n    get disposalSignal() {\n      return core.disposalSignal;\n    },\n\n    dispose() {\n      if (core.isDisposed) return;\n\n      for (const unsub of unsubscribeFns) {\n        unsub();\n      }\n\n      core.dispose();\n    },\n\n    get disposed() {\n      return core.isDisposed;\n    },\n\n    subscribe(listener) {\n      return core.subscribe(listener);\n    },\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":"8BA4BA,SAAgB,EACd,EAIA,EACiB,CACjB,IAAM,EAAO,EAAA,iBAAiB,EAC1B,EAA8B,EAAQ,EAAQ,IAAK,GAAM,EAAE,OAAO,CAAC,EAEjE,EAAiB,EAAQ,IAAK,GAClC,EAAO,cAAgB,CACrB,EAAgB,EAAQ,EAAQ,IAAK,GAAM,EAAE,OAAO,CAAC,EACrD,EAAK,OAAO,CACd,CAAC,CACH,EAEM,EAA0B,CAC9B,IAAI,SAAU,CACZ,OAAO,CACT,EAEA,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EAEA,SAAU,CACJ,MAAK,WAET,KAAK,IAAM,KAAS,EAClB,EAAM,EAGR,EAAK,QAAQ,CAHL,CAIV,EAEA,IAAI,UAAW,CACb,OAAO,EAAK,UACd,EAEA,UAAU,EAAU,CAClB,OAAO,EAAK,UAAU,CAAQ,CAChC,EAEA,CAAC,OAAO,UAAW,CACjB,EAAO,QAAQ,CACjB,CACF,EAEA,OAAO,CACT"}

package/dist/merge.d.ts

@@ -1,30 +0,0 @@
-import type { MergedSource } from './types';
-/**
- * Combines multiple reactive sources into a single read-only view by applying
- * a user-supplied `combine` function over all sources' `current` arrays.
- *
- * The merged source recalculates whenever any parent source changes. Useful for
- * offline/online hybrid UIs (local + remote merged), multi-dataset views, or
- * pagination across multiple backends.
- *
- * Call `dispose()` to unsubscribe from all parent sources.
- *
- * @example
- * ```ts
- * const local = createLocalSource(localCache, { limit: 50 });
- * const remote = createRemoteSource({ fetch: fetchUsers, limit: 50 });
- *
- * // Show local cache items first, then remote items (deduped by id).
- * const merged = mergeSource([local, remote], (all) => {
- *   const seen = new Set<number>();
- *   return all.flat().filter((u) => !seen.has(u.id) && seen.add(u.id));
- * });
- *
- * merged.subscribe(() => console.log(merged.current));
- * ```
- */
-export declare function mergeSource<T>(sources: ReadonlyArray<{
-    readonly current: readonly T[];
-    subscribe(listener: () => void): () => void;
-}>, combine: (allItems: ReadonlyArray<readonly T[]>) => readonly T[]): MergedSource<T>;
-//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC/B,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C,CAAC,EACF,OAAO,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,GAC/D,YAAY,CAAC,CAAC,CAAC,CA4CjB"}

package/dist/merge.js

@@ -1,34 +0,0 @@
-import { createSourceCore as e } from "./core.js";
-//#region src/merge.ts
-function t(t, n) {
-	let r = e(), i = n(t.map((e) => e.current)), a = t.map((e) => e.subscribe(() => {
-		i = n(t.map((e) => e.current)), r.notify();
-	})), o = {
-		get current() {
-			return i;
-		},
-		get disposalSignal() {
-			return r.disposalSignal;
-		},
-		dispose() {
-			if (!r.isDisposed) {
-				for (let e of a) e();
-				r.dispose();
-			}
-		},
-		get disposed() {
-			return r.isDisposed;
-		},
-		subscribe(e) {
-			return r.subscribe(e);
-		},
-		[Symbol.dispose]() {
-			o.dispose();
-		}
-	};
-	return o;
-}
-//#endregion
-export { t as mergeSource };
-
-//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge.js","names":[],"sources":["../src/merge.ts"],"sourcesContent":["import type { MergedSource } from './types';\n\nimport { createSourceCore } from './core';\n\n/**\n * Combines multiple reactive sources into a single read-only view by applying\n * a user-supplied `combine` function over all sources' `current` arrays.\n *\n * The merged source recalculates whenever any parent source changes. Useful for\n * offline/online hybrid UIs (local + remote merged), multi-dataset views, or\n * pagination across multiple backends.\n *\n * Call `dispose()` to unsubscribe from all parent sources.\n *\n * @example\n * ```ts\n * const local = createLocalSource(localCache, { limit: 50 });\n * const remote = createRemoteSource({ fetch: fetchUsers, limit: 50 });\n *\n * // Show local cache items first, then remote items (deduped by id).\n * const merged = mergeSource([local, remote], (all) => {\n *   const seen = new Set<number>();\n *   return all.flat().filter((u) => !seen.has(u.id) && seen.add(u.id));\n * });\n *\n * merged.subscribe(() => console.log(merged.current));\n * ```\n */\nexport function mergeSource<T>(\n  sources: ReadonlyArray<{\n    readonly current: readonly T[];\n    subscribe(listener: () => void): () => void;\n  }>,\n  combine: (allItems: ReadonlyArray<readonly T[]>) => readonly T[],\n): MergedSource<T> {\n  const core = createSourceCore();\n  let cachedCurrent: readonly T[] = combine(sources.map((s) => s.current));\n\n  const unsubscribeFns = sources.map((source) =>\n    source.subscribe(() => {\n      cachedCurrent = combine(sources.map((s) => s.current));\n      core.notify();\n    }),\n  );\n\n  const source: MergedSource<T> = {\n    get current() {\n      return cachedCurrent;\n    },\n\n    get disposalSignal() {\n      return core.disposalSignal;\n    },\n\n    dispose() {\n      if (core.isDisposed) return;\n\n      for (const unsub of unsubscribeFns) {\n        unsub();\n      }\n\n      core.dispose();\n    },\n\n    get disposed() {\n      return core.isDisposed;\n    },\n\n    subscribe(listener) {\n      return core.subscribe(listener);\n    },\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":";;AA4BA,SAAgB,EACd,GAIA,GACiB;CACjB,IAAM,IAAO,EAAiB,GAC1B,IAA8B,EAAQ,EAAQ,KAAK,MAAM,EAAE,OAAO,CAAC,GAEjE,IAAiB,EAAQ,KAAK,MAClC,EAAO,gBAAgB;EAErB,AADA,IAAgB,EAAQ,EAAQ,KAAK,MAAM,EAAE,OAAO,CAAC,GACrD,EAAK,OAAO;CACd,CAAC,CACH,GAEM,IAA0B;EAC9B,IAAI,UAAU;GACZ,OAAO;EACT;EAEA,IAAI,iBAAiB;GACnB,OAAO,EAAK;EACd;EAEA,UAAU;GACJ,OAAK,YAET;SAAK,IAAM,KAAS,GAClB,EAAM;IAGR,EAAK,QAAQ;GAHL;EAIV;EAEA,IAAI,WAAW;GACb,OAAO,EAAK;EACd;EAEA,UAAU,GAAU;GAClB,OAAO,EAAK,UAAU,CAAQ;EAChC;EAEA,CAAC,OAAO,WAAW;GACjB,EAAO,QAAQ;EACjB;CACF;CAEA,OAAO;AACT"}

package/dist/prefetch.cjs

@@ -1,2 +0,0 @@
-const e=require("./remoteSource.cjs");var t=e=>{let t=e.query;return{items:e.current,...t.search&&{search:t.search},page:e.meta.pageNumber,total:e.meta.totalItems}};async function n(n){let r=e.createRemoteSource({...n,autoFetch:!1});try{if(await r.refresh(),r.meta.error)throw r.meta.error;return t(r)}finally{r.dispose()}}async function r(n){let r=e.createRemoteSource({...n,autoFetch:!1});if(await r.refresh(),r.meta.error)throw r.dispose(),r.meta.error;return{snapshot:t(r),source:r}}exports.prefetchSource=n,exports.prefetchSourceAndKeep=r;
-//# sourceMappingURL=prefetch.cjs.map

package/dist/prefetch.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"prefetch.cjs","names":[],"sources":["../src/prefetch.ts"],"sourcesContent":["import type { RemoteConfig, RemoteSource, SourceSnapshot } from './types';\n\nimport { createRemoteSource } from './remoteSource';\n\ntype PrefetchConfig<T, TFilter, TSort> = Omit<RemoteConfig<T, TFilter, TSort>, 'autoFetch' | 'refreshInterval'>;\n\nconst buildSnapshot = <T, TFilter, TSort>(source: RemoteSource<T, TFilter, TSort>): SourceSnapshot<T> => {\n  const q = source.query;\n\n  return {\n    items: source.current,\n    ...(q.search && { search: q.search }),\n    page: source.meta.pageNumber,\n    total: source.meta.totalItems,\n  };\n};\n\n/**\n * Fetches a single page of data and returns a serialisable `SourceSnapshot`.\n * The underlying source is created, fetched, then immediately disposed.\n * Use for SSR / static-generation where you only need the data, not a live source.\n *\n * @example\n * ```ts\n * const snapshot = await prefetchSource({ fetch: fetchUsers, limit: 20 });\n * ```\n */\nexport async function prefetchSource<T, TFilter = unknown, TSort = unknown>(\n  cfg: PrefetchConfig<T, TFilter, TSort>,\n): Promise<SourceSnapshot<T>> {\n  const source = createRemoteSource<T, TFilter, TSort>({ ...cfg, autoFetch: false });\n\n  try {\n    await source.refresh();\n\n    if (source.meta.error) throw source.meta.error;\n\n    return buildSnapshot(source);\n  } finally {\n    source.dispose();\n  }\n}\n\n/**\n * Fetches a single page of data and returns both a serialisable `SourceSnapshot` and the\n * still-live `RemoteSource`. Useful when you need the snapshot for SSR serialisation\n * **and** the live source for subsequent client-side updates without a double-fetch.\n *\n * **The caller is responsible for disposing the returned source.**\n *\n * @example\n * ```ts\n * const { snapshot, source } = await prefetchSourceAndKeep({ fetch: fetchUsers, limit: 20 });\n * // hydrate HTML with snapshot, pass source to client\n * ```\n */\nexport async function prefetchSourceAndKeep<T, TFilter = unknown, TSort = unknown>(\n  cfg: PrefetchConfig<T, TFilter, TSort>,\n): Promise<{ snapshot: SourceSnapshot<T>; source: RemoteSource<T, TFilter, TSort> }> {\n  const source = createRemoteSource<T, TFilter, TSort>({ ...cfg, autoFetch: false });\n\n  await source.refresh();\n\n  if (source.meta.error) {\n    source.dispose();\n    throw source.meta.error;\n  }\n\n  return { snapshot: buildSnapshot(source), source };\n}\n"],"mappings":"sCAMA,IAAM,EAAoC,GAA+D,CACvG,IAAM,EAAI,EAAO,MAEjB,MAAO,CACL,MAAO,EAAO,QACd,GAAI,EAAE,QAAU,CAAE,OAAQ,EAAE,MAAO,EACnC,KAAM,EAAO,KAAK,WAClB,MAAO,EAAO,KAAK,UACrB,CACF,EAYA,eAAsB,EACpB,EAC4B,CAC5B,IAAM,EAAS,EAAA,mBAAsC,CAAE,GAAG,EAAK,UAAW,EAAM,CAAC,EAEjF,GAAI,CAGF,GAFA,MAAM,EAAO,QAAQ,EAEjB,EAAO,KAAK,MAAO,MAAM,EAAO,KAAK,MAEzC,OAAO,EAAc,CAAM,CAC7B,QAAU,CACR,EAAO,QAAQ,CACjB,CACF,CAeA,eAAsB,EACpB,EACmF,CACnF,IAAM,EAAS,EAAA,mBAAsC,CAAE,GAAG,EAAK,UAAW,EAAM,CAAC,EAIjF,GAFA,MAAM,EAAO,QAAQ,EAEjB,EAAO,KAAK,MAEd,MADA,EAAO,QAAQ,EACT,EAAO,KAAK,MAGpB,MAAO,CAAE,SAAU,EAAc,CAAM,EAAG,QAAO,CACnD"}

package/dist/prefetch.d.ts

@@ -1,32 +0,0 @@
-import type { RemoteConfig, RemoteSource, SourceSnapshot } from './types';
-type PrefetchConfig<T, TFilter, TSort> = Omit<RemoteConfig<T, TFilter, TSort>, 'autoFetch' | 'refreshInterval'>;
-/**
- * Fetches a single page of data and returns a serialisable `SourceSnapshot`.
- * The underlying source is created, fetched, then immediately disposed.
- * Use for SSR / static-generation where you only need the data, not a live source.
- *
- * @example
- * ```ts
- * const snapshot = await prefetchSource({ fetch: fetchUsers, limit: 20 });
- * ```
- */
-export declare function prefetchSource<T, TFilter = unknown, TSort = unknown>(cfg: PrefetchConfig<T, TFilter, TSort>): Promise<SourceSnapshot<T>>;
-/**
- * Fetches a single page of data and returns both a serialisable `SourceSnapshot` and the
- * still-live `RemoteSource`. Useful when you need the snapshot for SSR serialisation
- * **and** the live source for subsequent client-side updates without a double-fetch.
- *
- * **The caller is responsible for disposing the returned source.**
- *
- * @example
- * ```ts
- * const { snapshot, source } = await prefetchSourceAndKeep({ fetch: fetchUsers, limit: 20 });
- * // hydrate HTML with snapshot, pass source to client
- * ```
- */
-export declare function prefetchSourceAndKeep<T, TFilter = unknown, TSort = unknown>(cfg: PrefetchConfig<T, TFilter, TSort>): Promise<{
-    snapshot: SourceSnapshot<T>;
-    source: RemoteSource<T, TFilter, TSort>;
-}>;
-export {};
-//# sourceMappingURL=prefetch.d.ts.map

package/dist/prefetch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prefetch.d.ts","sourceRoot":"","sources":["../src/prefetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI1E,KAAK,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAAC,CAAC;AAahH;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACxE,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GACrC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAY5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAC/E,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GACrC,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;CAAE,CAAC,CAWnF"}

package/dist/prefetch.js

@@ -1,38 +0,0 @@
-import { createRemoteSource as e } from "./remoteSource.js";
-//#region src/prefetch.ts
-var t = (e) => {
-	let t = e.query;
-	return {
-		items: e.current,
-		...t.search && { search: t.search },
-		page: e.meta.pageNumber,
-		total: e.meta.totalItems
-	};
-};
-async function n(n) {
-	let r = e({
-		...n,
-		autoFetch: !1
-	});
-	try {
-		if (await r.refresh(), r.meta.error) throw r.meta.error;
-		return t(r);
-	} finally {
-		r.dispose();
-	}
-}
-async function r(n) {
-	let r = e({
-		...n,
-		autoFetch: !1
-	});
-	if (await r.refresh(), r.meta.error) throw r.dispose(), r.meta.error;
-	return {
-		snapshot: t(r),
-		source: r
-	};
-}
-//#endregion
-export { n as prefetchSource, r as prefetchSourceAndKeep };
-
-//# sourceMappingURL=prefetch.js.map

package/dist/prefetch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prefetch.js","names":[],"sources":["../src/prefetch.ts"],"sourcesContent":["import type { RemoteConfig, RemoteSource, SourceSnapshot } from './types';\n\nimport { createRemoteSource } from './remoteSource';\n\ntype PrefetchConfig<T, TFilter, TSort> = Omit<RemoteConfig<T, TFilter, TSort>, 'autoFetch' | 'refreshInterval'>;\n\nconst buildSnapshot = <T, TFilter, TSort>(source: RemoteSource<T, TFilter, TSort>): SourceSnapshot<T> => {\n  const q = source.query;\n\n  return {\n    items: source.current,\n    ...(q.search && { search: q.search }),\n    page: source.meta.pageNumber,\n    total: source.meta.totalItems,\n  };\n};\n\n/**\n * Fetches a single page of data and returns a serialisable `SourceSnapshot`.\n * The underlying source is created, fetched, then immediately disposed.\n * Use for SSR / static-generation where you only need the data, not a live source.\n *\n * @example\n * ```ts\n * const snapshot = await prefetchSource({ fetch: fetchUsers, limit: 20 });\n * ```\n */\nexport async function prefetchSource<T, TFilter = unknown, TSort = unknown>(\n  cfg: PrefetchConfig<T, TFilter, TSort>,\n): Promise<SourceSnapshot<T>> {\n  const source = createRemoteSource<T, TFilter, TSort>({ ...cfg, autoFetch: false });\n\n  try {\n    await source.refresh();\n\n    if (source.meta.error) throw source.meta.error;\n\n    return buildSnapshot(source);\n  } finally {\n    source.dispose();\n  }\n}\n\n/**\n * Fetches a single page of data and returns both a serialisable `SourceSnapshot` and the\n * still-live `RemoteSource`. Useful when you need the snapshot for SSR serialisation\n * **and** the live source for subsequent client-side updates without a double-fetch.\n *\n * **The caller is responsible for disposing the returned source.**\n *\n * @example\n * ```ts\n * const { snapshot, source } = await prefetchSourceAndKeep({ fetch: fetchUsers, limit: 20 });\n * // hydrate HTML with snapshot, pass source to client\n * ```\n */\nexport async function prefetchSourceAndKeep<T, TFilter = unknown, TSort = unknown>(\n  cfg: PrefetchConfig<T, TFilter, TSort>,\n): Promise<{ snapshot: SourceSnapshot<T>; source: RemoteSource<T, TFilter, TSort> }> {\n  const source = createRemoteSource<T, TFilter, TSort>({ ...cfg, autoFetch: false });\n\n  await source.refresh();\n\n  if (source.meta.error) {\n    source.dispose();\n    throw source.meta.error;\n  }\n\n  return { snapshot: buildSnapshot(source), source };\n}\n"],"mappings":";;AAMA,IAAM,KAAoC,MAA+D;CACvG,IAAM,IAAI,EAAO;CAEjB,OAAO;EACL,OAAO,EAAO;EACd,GAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO;EACnC,MAAM,EAAO,KAAK;EAClB,OAAO,EAAO,KAAK;CACrB;AACF;AAYA,eAAsB,EACpB,GAC4B;CAC5B,IAAM,IAAS,EAAsC;EAAE,GAAG;EAAK,WAAW;CAAM,CAAC;CAEjF,IAAI;EAGF,IAFA,MAAM,EAAO,QAAQ,GAEjB,EAAO,KAAK,OAAO,MAAM,EAAO,KAAK;EAEzC,OAAO,EAAc,CAAM;CAC7B,UAAU;EACR,EAAO,QAAQ;CACjB;AACF;AAeA,eAAsB,EACpB,GACmF;CACnF,IAAM,IAAS,EAAsC;EAAE,GAAG;EAAK,WAAW;CAAM,CAAC;CAIjF,IAFA,MAAM,EAAO,QAAQ,GAEjB,EAAO,KAAK,OAEd,MADA,EAAO,QAAQ,GACT,EAAO,KAAK;CAGpB,OAAO;EAAE,UAAU,EAAc,CAAM;EAAG;CAAO;AACnD"}

package/dist/presets.cjs

@@ -1,2 +0,0 @@
-var e=e=>{if(e==null)return``;if(typeof e==`bigint`||typeof e==`boolean`||typeof e==`number`||typeof e==`string`)return String(e);if(e instanceof Date)return e.toISOString();try{return JSON.stringify(e)??``}catch{return String(e)}},t=(e,t,n=!1)=>{let r=n?t:t.toLowerCase();return t=>{let i=e(t)??``;return(n?i:i.toLowerCase()).includes(r)}},n=(e,t)=>n=>Object.is(e(n),t),r=(e,t)=>{let n=e=>e instanceof Date?e.getTime():e,r=t.min===void 0?void 0:n(t.min),i=t.max===void 0?void 0:n(t.max);return t=>{let a=n(e(t));return!(r!==void 0&&a<r||i!==void 0&&a>i)}},i=(e,t=`asc`)=>{let n=t===`asc`?1:-1;return(t,r)=>{let i=e(t),a=e(r);return i instanceof Date&&a instanceof Date?(i.getTime()-a.getTime())*n:i<a?-1*n:i>a?1*n:0}},a=(t,n={})=>{let r=Array.isArray(t)?t:[t],i=n.caseSensitive===!0;return(t,n)=>{if(n.length===0)return t;let a=i?n:n.toLowerCase();return t.filter(t=>r.some(n=>{let r=e(n(t));return(i?r:r.toLowerCase()).includes(a)}))}};exports.filterContains=t,exports.filterEquals=n,exports.filterRange=r,exports.searchBy=a,exports.sortBy=i;
-//# sourceMappingURL=presets.cjs.map

package/dist/presets.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"presets.cjs","names":[],"sources":["../src/presets.ts"],"sourcesContent":["import type { Predicate, Sorter } from './types';\n\ntype Direction = 'asc' | 'desc';\n\ntype PrimitiveComparable = number | string | Date;\ntype SearchByGetter<T> = (item: T) => unknown;\ntype SearchByOptions = Readonly<{ caseSensitive?: boolean }>;\n\nconst toSearchableString = (value: unknown): string => {\n  if (value === null || value === undefined) return '';\n\n  if (\n    typeof value === 'bigint' ||\n    typeof value === 'boolean' ||\n    typeof value === 'number' ||\n    typeof value === 'string'\n  ) {\n    return String(value);\n  }\n\n  if (value instanceof Date) return value.toISOString();\n\n  try {\n    return JSON.stringify(value) ?? '';\n  } catch {\n    return String(value);\n  }\n};\n\nexport const filterContains = <T>(\n  getValue: (item: T) => string | null | undefined,\n  query: string,\n  caseSensitive = false,\n): Predicate<T> => {\n  const needle = caseSensitive ? query : query.toLowerCase();\n\n  return (item) => {\n    const value = getValue(item) ?? '';\n    const haystack = caseSensitive ? value : value.toLowerCase();\n\n    return haystack.includes(needle);\n  };\n};\n\nexport const filterEquals = <T, V>(getValue: (item: T) => V, expected: V): Predicate<T> => {\n  return (item) => Object.is(getValue(item), expected);\n};\n\nexport const filterRange = <T>(\n  getValue: (item: T) => Date | number,\n  bounds: Readonly<{ max?: Date | number; min?: Date | number }>,\n): Predicate<T> => {\n  const toNum = (v: Date | number): number => (v instanceof Date ? v.getTime() : v);\n\n  const min = bounds.min !== undefined ? toNum(bounds.min) : undefined;\n  const max = bounds.max !== undefined ? toNum(bounds.max) : undefined;\n\n  return (item) => {\n    const value = toNum(getValue(item));\n\n    if (min !== undefined && value < min) return false;\n\n    if (max !== undefined && value > max) return false;\n\n    return true;\n  };\n};\n\nexport const sortBy = <T, V extends PrimitiveComparable>(\n  getValue: (item: T) => V,\n  direction: Direction = 'asc',\n): Sorter<T> => {\n  const sign = direction === 'asc' ? 1 : -1;\n\n  return (a, b) => {\n    const left = getValue(a);\n    const right = getValue(b);\n\n    if (left instanceof Date && right instanceof Date) {\n      return (left.getTime() - right.getTime()) * sign;\n    }\n\n    if (left < right) return -1 * sign;\n\n    if (left > right) return 1 * sign;\n\n    return 0;\n  };\n};\n\nexport const searchBy = <T>(\n  getValue: SearchByGetter<T> | readonly SearchByGetter<T>[],\n  opts: SearchByOptions = {},\n): ((items: readonly T[], query: string) => readonly T[]) => {\n  const getters = Array.isArray(getValue) ? getValue : [getValue];\n  const caseSensitive = opts.caseSensitive === true;\n\n  return (items, query) => {\n    if (query.length === 0) return items;\n\n    const needle = caseSensitive ? query : query.toLowerCase();\n\n    return items.filter((item) => {\n      return getters.some((getter) => {\n        const raw = toSearchableString(getter(item));\n        const haystack = caseSensitive ? raw : raw.toLowerCase();\n\n        return haystack.includes(needle);\n      });\n    });\n  };\n};\n"],"mappings":"AAQA,IAAM,EAAsB,GAA2B,CACrD,GAAI,GAAU,KAA6B,MAAO,GAElD,GACE,OAAO,GAAU,UACjB,OAAO,GAAU,WACjB,OAAO,GAAU,UACjB,OAAO,GAAU,SAEjB,OAAO,OAAO,CAAK,EAGrB,GAAI,aAAiB,KAAM,OAAO,EAAM,YAAY,EAEpD,GAAI,CACF,OAAO,KAAK,UAAU,CAAK,GAAK,EAClC,MAAQ,CACN,OAAO,OAAO,CAAK,CACrB,CACF,EAEa,GACX,EACA,EACA,EAAgB,KACC,CACjB,IAAM,EAAS,EAAgB,EAAQ,EAAM,YAAY,EAEzD,MAAQ,IAAS,CACf,IAAM,EAAQ,EAAS,CAAI,GAAK,GAGhC,OAFiB,EAAgB,EAAQ,EAAM,YAAY,EAAA,CAE3C,SAAS,CAAM,CACjC,CACF,EAEa,GAAsB,EAA0B,IACnD,GAAS,OAAO,GAAG,EAAS,CAAI,EAAG,CAAQ,EAGxC,GACX,EACA,IACiB,CACjB,IAAM,EAAS,GAA8B,aAAa,KAAO,EAAE,QAAQ,EAAI,EAEzE,EAAM,EAAO,MAAQ,IAAA,GAAgC,IAAA,GAApB,EAAM,EAAO,GAAG,EACjD,EAAM,EAAO,MAAQ,IAAA,GAAgC,IAAA,GAApB,EAAM,EAAO,GAAG,EAEvD,MAAQ,IAAS,CACf,IAAM,EAAQ,EAAM,EAAS,CAAI,CAAC,EAMlC,MAFA,EAFI,IAAQ,IAAA,IAAa,EAAQ,GAE7B,IAAQ,IAAA,IAAa,EAAQ,EAGnC,CACF,EAEa,GACX,EACA,EAAuB,QACT,CACd,IAAM,EAAO,IAAc,MAAQ,EAAI,GAEvC,OAAQ,EAAG,IAAM,CACf,IAAM,EAAO,EAAS,CAAC,EACjB,EAAQ,EAAS,CAAC,EAUxB,OARI,aAAgB,MAAQ,aAAiB,MACnC,EAAK,QAAQ,EAAI,EAAM,QAAQ,GAAK,EAG1C,EAAO,EAAc,GAAK,EAE1B,EAAO,EAAc,EAAI,EAEtB,CACT,CACF,EAEa,GACX,EACA,EAAwB,CAAC,IACkC,CAC3D,IAAM,EAAU,MAAM,QAAQ,CAAQ,EAAI,EAAW,CAAC,CAAQ,EACxD,EAAgB,EAAK,gBAAkB,GAE7C,OAAQ,EAAO,IAAU,CACvB,GAAI,EAAM,SAAW,EAAG,OAAO,EAE/B,IAAM,EAAS,EAAgB,EAAQ,EAAM,YAAY,EAEzD,OAAO,EAAM,OAAQ,GACZ,EAAQ,KAAM,GAAW,CAC9B,IAAM,EAAM,EAAmB,EAAO,CAAI,CAAC,EAG3C,OAFiB,EAAgB,EAAM,EAAI,YAAY,EAAA,CAEvC,SAAS,CAAM,CACjC,CAAC,CACF,CACH,CACF"}

package/dist/presets.d.ts

@@ -1,17 +0,0 @@
-import type { Predicate, Sorter } from './types';
-type Direction = 'asc' | 'desc';
-type PrimitiveComparable = number | string | Date;
-type SearchByGetter<T> = (item: T) => unknown;
-type SearchByOptions = Readonly<{
-    caseSensitive?: boolean;
-}>;
-export declare const filterContains: <T>(getValue: (item: T) => string | null | undefined, query: string, caseSensitive?: boolean) => Predicate<T>;
-export declare const filterEquals: <T, V>(getValue: (item: T) => V, expected: V) => Predicate<T>;
-export declare const filterRange: <T>(getValue: (item: T) => Date | number, bounds: Readonly<{
-    max?: Date | number;
-    min?: Date | number;
-}>) => Predicate<T>;
-export declare const sortBy: <T, V extends PrimitiveComparable>(getValue: (item: T) => V, direction?: Direction) => Sorter<T>;
-export declare const searchBy: <T>(getValue: SearchByGetter<T> | readonly SearchByGetter<T>[], opts?: SearchByOptions) => ((items: readonly T[], query: string) => readonly T[]);
-export {};
-//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjD,KAAK,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhC,KAAK,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAClD,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;AAC9C,KAAK,eAAe,GAAG,QAAQ,CAAC;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAuB7D,eAAO,MAAM,cAAc,GAAI,CAAC,EAC9B,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EAChD,OAAO,MAAM,EACb,uBAAqB,KACpB,SAAS,CAAC,CAAC,CASb,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAG,SAAS,CAAC,CAAC,CAErF,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,EACpC,QAAQ,QAAQ,CAAC;IAAE,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC,KAC7D,SAAS,CAAC,CAAC,CAeb,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,SAAS,mBAAmB,EACrD,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EACxB,YAAW,SAAiB,KAC3B,MAAM,CAAC,CAAC,CAiBV,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,UAAU,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,EAC1D,OAAM,eAAoB,KACzB,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,EAAE,CAkBvD,CAAC"}

package/dist/presets.js

@@ -1,43 +0,0 @@
-//#region src/presets.ts
-var e = (e) => {
-	if (e == null) return "";
-	if (typeof e == "bigint" || typeof e == "boolean" || typeof e == "number" || typeof e == "string") return String(e);
-	if (e instanceof Date) return e.toISOString();
-	try {
-		return JSON.stringify(e) ?? "";
-	} catch {
-		return String(e);
-	}
-}, t = (e, t, n = !1) => {
-	let r = n ? t : t.toLowerCase();
-	return (t) => {
-		let i = e(t) ?? "";
-		return (n ? i : i.toLowerCase()).includes(r);
-	};
-}, n = (e, t) => (n) => Object.is(e(n), t), r = (e, t) => {
-	let n = (e) => e instanceof Date ? e.getTime() : e, r = t.min === void 0 ? void 0 : n(t.min), i = t.max === void 0 ? void 0 : n(t.max);
-	return (t) => {
-		let a = n(e(t));
-		return !(r !== void 0 && a < r || i !== void 0 && a > i);
-	};
-}, i = (e, t = "asc") => {
-	let n = t === "asc" ? 1 : -1;
-	return (t, r) => {
-		let i = e(t), a = e(r);
-		return i instanceof Date && a instanceof Date ? (i.getTime() - a.getTime()) * n : i < a ? -1 * n : i > a ? 1 * n : 0;
-	};
-}, a = (t, n = {}) => {
-	let r = Array.isArray(t) ? t : [t], i = n.caseSensitive === !0;
-	return (t, n) => {
-		if (n.length === 0) return t;
-		let a = i ? n : n.toLowerCase();
-		return t.filter((t) => r.some((n) => {
-			let r = e(n(t));
-			return (i ? r : r.toLowerCase()).includes(a);
-		}));
-	};
-};
-//#endregion
-export { t as filterContains, n as filterEquals, r as filterRange, a as searchBy, i as sortBy };
-
-//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"presets.js","names":[],"sources":["../src/presets.ts"],"sourcesContent":["import type { Predicate, Sorter } from './types';\n\ntype Direction = 'asc' | 'desc';\n\ntype PrimitiveComparable = number | string | Date;\ntype SearchByGetter<T> = (item: T) => unknown;\ntype SearchByOptions = Readonly<{ caseSensitive?: boolean }>;\n\nconst toSearchableString = (value: unknown): string => {\n  if (value === null || value === undefined) return '';\n\n  if (\n    typeof value === 'bigint' ||\n    typeof value === 'boolean' ||\n    typeof value === 'number' ||\n    typeof value === 'string'\n  ) {\n    return String(value);\n  }\n\n  if (value instanceof Date) return value.toISOString();\n\n  try {\n    return JSON.stringify(value) ?? '';\n  } catch {\n    return String(value);\n  }\n};\n\nexport const filterContains = <T>(\n  getValue: (item: T) => string | null | undefined,\n  query: string,\n  caseSensitive = false,\n): Predicate<T> => {\n  const needle = caseSensitive ? query : query.toLowerCase();\n\n  return (item) => {\n    const value = getValue(item) ?? '';\n    const haystack = caseSensitive ? value : value.toLowerCase();\n\n    return haystack.includes(needle);\n  };\n};\n\nexport const filterEquals = <T, V>(getValue: (item: T) => V, expected: V): Predicate<T> => {\n  return (item) => Object.is(getValue(item), expected);\n};\n\nexport const filterRange = <T>(\n  getValue: (item: T) => Date | number,\n  bounds: Readonly<{ max?: Date | number; min?: Date | number }>,\n): Predicate<T> => {\n  const toNum = (v: Date | number): number => (v instanceof Date ? v.getTime() : v);\n\n  const min = bounds.min !== undefined ? toNum(bounds.min) : undefined;\n  const max = bounds.max !== undefined ? toNum(bounds.max) : undefined;\n\n  return (item) => {\n    const value = toNum(getValue(item));\n\n    if (min !== undefined && value < min) return false;\n\n    if (max !== undefined && value > max) return false;\n\n    return true;\n  };\n};\n\nexport const sortBy = <T, V extends PrimitiveComparable>(\n  getValue: (item: T) => V,\n  direction: Direction = 'asc',\n): Sorter<T> => {\n  const sign = direction === 'asc' ? 1 : -1;\n\n  return (a, b) => {\n    const left = getValue(a);\n    const right = getValue(b);\n\n    if (left instanceof Date && right instanceof Date) {\n      return (left.getTime() - right.getTime()) * sign;\n    }\n\n    if (left < right) return -1 * sign;\n\n    if (left > right) return 1 * sign;\n\n    return 0;\n  };\n};\n\nexport const searchBy = <T>(\n  getValue: SearchByGetter<T> | readonly SearchByGetter<T>[],\n  opts: SearchByOptions = {},\n): ((items: readonly T[], query: string) => readonly T[]) => {\n  const getters = Array.isArray(getValue) ? getValue : [getValue];\n  const caseSensitive = opts.caseSensitive === true;\n\n  return (items, query) => {\n    if (query.length === 0) return items;\n\n    const needle = caseSensitive ? query : query.toLowerCase();\n\n    return items.filter((item) => {\n      return getters.some((getter) => {\n        const raw = toSearchableString(getter(item));\n        const haystack = caseSensitive ? raw : raw.toLowerCase();\n\n        return haystack.includes(needle);\n      });\n    });\n  };\n};\n"],"mappings":";AAQA,IAAM,KAAsB,MAA2B;CACrD,IAAI,KAAU,MAA6B,OAAO;CAElD,IACE,OAAO,KAAU,YACjB,OAAO,KAAU,aACjB,OAAO,KAAU,YACjB,OAAO,KAAU,UAEjB,OAAO,OAAO,CAAK;CAGrB,IAAI,aAAiB,MAAM,OAAO,EAAM,YAAY;CAEpD,IAAI;EACF,OAAO,KAAK,UAAU,CAAK,KAAK;CAClC,QAAQ;EACN,OAAO,OAAO,CAAK;CACrB;AACF,GAEa,KACX,GACA,GACA,IAAgB,OACC;CACjB,IAAM,IAAS,IAAgB,IAAQ,EAAM,YAAY;CAEzD,QAAQ,MAAS;EACf,IAAM,IAAQ,EAAS,CAAI,KAAK;EAGhC,QAFiB,IAAgB,IAAQ,EAAM,YAAY,EAAA,CAE3C,SAAS,CAAM;CACjC;AACF,GAEa,KAAsB,GAA0B,OACnD,MAAS,OAAO,GAAG,EAAS,CAAI,GAAG,CAAQ,GAGxC,KACX,GACA,MACiB;CACjB,IAAM,KAAS,MAA8B,aAAa,OAAO,EAAE,QAAQ,IAAI,GAEzE,IAAM,EAAO,QAAQ,KAAA,IAAgC,KAAA,IAApB,EAAM,EAAO,GAAG,GACjD,IAAM,EAAO,QAAQ,KAAA,IAAgC,KAAA,IAApB,EAAM,EAAO,GAAG;CAEvD,QAAQ,MAAS;EACf,IAAM,IAAQ,EAAM,EAAS,CAAI,CAAC;EAMlC,OAFA,EAFI,MAAQ,KAAA,KAAa,IAAQ,KAE7B,MAAQ,KAAA,KAAa,IAAQ;CAGnC;AACF,GAEa,KACX,GACA,IAAuB,UACT;CACd,IAAM,IAAO,MAAc,QAAQ,IAAI;CAEvC,QAAQ,GAAG,MAAM;EACf,IAAM,IAAO,EAAS,CAAC,GACjB,IAAQ,EAAS,CAAC;EAUxB,OARI,aAAgB,QAAQ,aAAiB,QACnC,EAAK,QAAQ,IAAI,EAAM,QAAQ,KAAK,IAG1C,IAAO,IAAc,KAAK,IAE1B,IAAO,IAAc,IAAI,IAEtB;CACT;AACF,GAEa,KACX,GACA,IAAwB,CAAC,MACkC;CAC3D,IAAM,IAAU,MAAM,QAAQ,CAAQ,IAAI,IAAW,CAAC,CAAQ,GACxD,IAAgB,EAAK,kBAAkB;CAE7C,QAAQ,GAAO,MAAU;EACvB,IAAI,EAAM,WAAW,GAAG,OAAO;EAE/B,IAAM,IAAS,IAAgB,IAAQ,EAAM,YAAY;EAEzD,OAAO,EAAM,QAAQ,MACZ,EAAQ,MAAM,MAAW;GAC9B,IAAM,IAAM,EAAmB,EAAO,CAAI,CAAC;GAG3C,QAFiB,IAAgB,IAAM,EAAI,YAAY,EAAA,CAEvC,SAAS,CAAM;EACjC,CAAC,CACF;CACH;AACF"}

package/dist/remoteSource.cjs

@@ -1,2 +0,0 @@
-const e=require("./errors.cjs"),t=require("./_utils.cjs"),n=require("./asyncSearch.cjs"),r=require("./asyncSource.cjs"),i=require("./pagination.cjs");let a=require("@vielzeug/arsenal");function o(o){let s=o.queryKey??t.defaultKeyOf,c=o.staleTime??0,l=Math.max(1,Math.trunc(o.limit??20)),u=1,d=``,f=o.filter,p=o.sort,m=[],h=0,g=null,_=0,v=``,y=null;o.snapshot&&(m=o.snapshot.items,h=o.snapshot.total,o.snapshot.page!==void 0&&(u=o.snapshot.page),o.snapshot.search&&(d=o.snapshot.search),_=Date.now());let b=[],x=i.createMeta({error:null,isLoading:!1,isSearchPending:!1,pageNumber:1,pageSize:l,totalItems:0}),S=()=>{let e=i.pageCount(h,l),t=i.clampPage(u,e);b=m,x=i.createMeta({error:g,isLoading:C.pendingCount()>0,isSearchPending:C.core.isScheduled,pageNumber:t,pageSize:l,totalItems:h})},C=r.createAsyncSource(o,s,S),{autoFetch:w,debounceMs:T,retryAttempts:E,retryDelay:D}=C;S();let O=()=>{C.disposed||C.core.notify()},k=n.createAsyncSearchCoordinator(C.core,O),A=e=>{y?.active&&(y.active=!1,y=null),m=e.items,h=e.total,u=i.clampPage(u,i.pageCount(h,l))},j=()=>({...f!==void 0&&{filter:f},...p!==void 0&&{sort:p},...d&&{search:d},limit:l,page:u}),M=n=>{let r=s(n);return c>0&&r===v&&h>0&&Date.now()-_<c&&!y?.active?Promise.resolve():(g=null,C.fetch(n,async(n,i,s)=>{let c=Date.now();try{let e=await(0,a.retry)(e=>o.fetch(n,e),{delay:D,signal:i,times:E+1});s()&&(A(e),g=null,v=r,_=Date.now(),o.onFetch?.({durationMs:Date.now()-c,query:n,status:`success`}))}catch(r){if(i.aborted)return;s()&&(y?.active?(y.active=!1,m=y.prevItems,h=y.prevTotal,y=null):(m=[],h=0),g=new e.SourcererError(t.extractError(r),{cause:r,context:{kind:`remote`,limit:n.limit,page:n.page,...n.search&&{search:n.search}}}),o.onFetch?.({durationMs:Date.now()-c,error:g,query:n,status:`error`}))}},()=>{O(),k.settleIfIdle(C.pendingCount())}))},N=()=>M(j());return w&&N(),C.startRefreshInterval(()=>void N()),{get current(){return b},get disposalSignal(){return C.disposalSignal},dispose:()=>{k.cancel(),k.dispose(),C.dispose()},get disposed(){return C.disposed},goTo(e){let t=h>0?i.clampPage(e,i.pageCount(h,l)):Math.max(1,Math.trunc(e));return t===u?Promise.resolve():(u=t,N())},goToLast(){let e=i.pageCount(h,l);return u===e?Promise.resolve():(u=e,N())},get meta(){return x},next(){let e=i.pageCount(h,l);return u>=e?Promise.resolve():(u++,N())},optimisticUpdate(t,n){if(y?.active)throw new e.SourcererError(`An optimistic update is already active. Rollback the previous update before starting another.`);let r=m,i=h;y={active:!0,prevItems:r,prevTotal:i};try{m=t(m)}catch(e){throw y=null,e}return h=n?.total??h,O(),()=>{y?.active&&(y.active=!1,m=r,h=i,y=null,O())}},patch(e){let t=!1;if(e.limit!==void 0){let n=Math.max(1,Math.trunc(e.limit));n!==l&&(l=n,t=!0)}if(`filter`in e&&(f=e.filter,t=!0),`sort`in e&&(p=e.sort,t=!0),`search`in e&&(e.search!==d||C.core.isScheduled)&&(d=e.search??``,t=!0),e.page!==void 0){let n=h>0?i.clampPage(e.page,i.pageCount(h,l)):Math.max(1,Math.trunc(e.page));n!==u&&(u=n,t=!0)}return t?(k.cancel(),(e.limit!==void 0||`filter`in e||`sort`in e||`search`in e)&&e.page===void 0&&(u=1),N()):Promise.resolve()},prev(){return u<=1?Promise.resolve():(u--,N())},get query(){return{...f!==void 0&&{filter:f},...p!==void 0&&{sort:p},...d&&{search:d},limit:l,page:u}},ready(e){return C.ready(e)},refresh(){return N()},reset(){return k.cancel(),d=``,u=1,f=o.filter,p=o.sort,N()},search(e,t){return t?.immediate?e===d&&!C.core.isScheduled?Promise.resolve():(k.cancel(),d=e,u=1,N()):e===d?Promise.resolve():(d=e,u=1,k.schedule(()=>void N(),T))},subscribe:e=>C.core.subscribe(e),[Symbol.dispose]:()=>{k.cancel(),k.dispose(),C.dispose()}}}exports.createRemoteSource=o;
-//# sourceMappingURL=remoteSource.cjs.map

package/dist/remoteSource.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"remoteSource.cjs","names":[],"sources":["../src/remoteSource.ts"],"sourcesContent":["import type { RemoteConfig, RemoteSource, RemoteSourceQuery, SearchOptions } from './types';\n\nimport { defaultKeyOf, extractError, retry } from './_utils';\nimport { createAsyncSearchCoordinator } from './asyncSearch';\nimport { createAsyncSource } from './asyncSource';\nimport { SourcererError } from './errors';\nimport { clampPage, createMeta, pageCount } from './pagination';\n\n/** Creates a remote page-based source that fetches data from a network endpoint. */\nexport function createRemoteSource<T, TFilter = unknown, TSort = unknown>(\n  cfg: RemoteConfig<T, TFilter, TSort>,\n): RemoteSource<T, TFilter, TSort> {\n  const keyOf = cfg.queryKey ?? defaultKeyOf;\n\n  // ── Config defaults ─────────────────────────────────────────────────────────\n  const staleTimeMs = cfg.staleTime ?? 0;\n\n  // ── Mutable state ───────────────────────────────────────────────────────────\n  let limit = Math.max(1, Math.trunc(cfg.limit ?? 20));\n  let page = 1;\n  let search = '';\n  let filter: TFilter | undefined = cfg.filter;\n  let sort: TSort | undefined = cfg.sort;\n  let items: readonly T[] = [];\n  let total = 0;\n  let error: SourcererError | null = null;\n  let lastFetchTime = 0;\n  let lastFetchKey = '';\n\n  // Optimistic update state.\n  let optimistic: { active: boolean; prevItems: readonly T[]; prevTotal: number } | null = null;\n\n  // ── Snapshot pre-population ─────────────────────────────────────────────────\n  if (cfg.snapshot) {\n    items = cfg.snapshot.items;\n    total = cfg.snapshot.total;\n\n    if (cfg.snapshot.page !== undefined) page = cfg.snapshot.page;\n\n    if (cfg.snapshot.search) search = cfg.snapshot.search;\n\n    lastFetchTime = Date.now();\n  }\n\n  // ── Cached accessors ────────────────────────────────────────────────────────\n  let cachedCurrent: readonly T[] = [];\n  let cachedMeta = createMeta({\n    error: null,\n    isLoading: false,\n    isSearchPending: false,\n    pageNumber: 1,\n    pageSize: limit,\n    totalItems: 0,\n  });\n\n  const refreshMeta = () => {\n    const pages = pageCount(total, limit);\n    const safePage = clampPage(page, pages);\n\n    // items is already the current page from the server — no local slicing needed.\n    cachedCurrent = items;\n    cachedMeta = createMeta({\n      error,\n      isLoading: base.pendingCount() > 0,\n      isSearchPending: base.core.isScheduled,\n      pageNumber: safePage,\n      pageSize: limit,\n      totalItems: total,\n    });\n  };\n\n  // onBeforeNotify ensures refreshMeta() runs before any subscriber observes the new state,\n  // eliminating the need for a parallel listeners Set.\n  const base = createAsyncSource<RemoteSourceQuery<TFilter, TSort>>(cfg, keyOf, refreshMeta);\n  const { autoFetch, debounceMs, retryAttempts, retryDelay } = base;\n\n  // Initialise cache before first fetch.\n  refreshMeta();\n\n  const notifyListeners = () => {\n    if (base.disposed) return;\n\n    base.core.notify();\n  };\n  const searchCoordinator = createAsyncSearchCoordinator(base.core, notifyListeners);\n\n  // ── Assign result ───────────────────────────────────────────────────────────\n  const assign = (result: Readonly<{ items: readonly T[]; total: number }>) => {\n    if (optimistic?.active) {\n      optimistic.active = false;\n      optimistic = null;\n    }\n\n    items = result.items;\n    total = result.total;\n    page = clampPage(page, pageCount(total, limit));\n  };\n\n  // ── Core fetch ──────────────────────────────────────────────────────────────\n  const toRemoteQuery = (): RemoteSourceQuery<TFilter, TSort> => ({\n    ...(filter !== undefined && { filter }),\n    ...(sort !== undefined && { sort }),\n    ...(search && { search }),\n    limit,\n    page,\n  });\n\n  const fetchQuery = (q: RemoteSourceQuery<TFilter, TSort>): Promise<void> => {\n    const key = keyOf(q);\n\n    if (\n      staleTimeMs > 0 &&\n      key === lastFetchKey &&\n      total > 0 &&\n      Date.now() - lastFetchTime < staleTimeMs &&\n      !optimistic?.active\n    ) {\n      return Promise.resolve();\n    }\n\n    error = null;\n\n    return base.fetch(\n      q,\n      async (q: RemoteSourceQuery<TFilter, TSort>, signal, isLatest) => {\n        const startTime = Date.now();\n\n        try {\n          const result = await retry((sig) => cfg.fetch(q, sig!), {\n            delay: retryDelay,\n            signal,\n            times: retryAttempts + 1,\n          });\n\n          if (isLatest()) {\n            assign(result);\n            error = null;\n            lastFetchKey = key;\n            lastFetchTime = Date.now();\n            cfg.onFetch?.({ durationMs: Date.now() - startTime, query: q, status: 'success' });\n          }\n        } catch (reason: unknown) {\n          if (signal.aborted) return;\n\n          if (isLatest()) {\n            if (optimistic?.active) {\n              optimistic.active = false;\n              items = optimistic.prevItems;\n              total = optimistic.prevTotal;\n              optimistic = null;\n            } else {\n              items = [];\n              total = 0;\n            }\n\n            error = new SourcererError(extractError(reason), {\n              cause: reason,\n              context: { kind: 'remote', limit: q.limit, page: q.page, ...(q.search && { search: q.search }) },\n            });\n            cfg.onFetch?.({ durationMs: Date.now() - startTime, error, query: q, status: 'error' });\n          }\n        }\n      },\n      () => {\n        notifyListeners();\n\n        searchCoordinator.settleIfIdle(base.pendingCount());\n      },\n    );\n  };\n\n  const doUpdate = () => fetchQuery(toRemoteQuery());\n\n  // ── Auto-fetch + refresh interval ───────────────────────────────────────────\n  if (autoFetch) void doUpdate();\n\n  base.startRefreshInterval(() => void doUpdate());\n\n  // ── Public API ──────────────────────────────────────────────────────────────\n  return {\n    get current() {\n      return cachedCurrent;\n    },\n\n    get disposalSignal() {\n      return base.disposalSignal;\n    },\n\n    dispose: () => {\n      searchCoordinator.cancel();\n      searchCoordinator.dispose();\n      base.dispose();\n    },\n\n    get disposed() {\n      return base.disposed;\n    },\n\n    goTo(target) {\n      const clamped = total > 0 ? clampPage(target, pageCount(total, limit)) : Math.max(1, Math.trunc(target));\n\n      if (clamped === page) return Promise.resolve();\n\n      page = clamped;\n\n      return doUpdate();\n    },\n\n    goToLast() {\n      const last = pageCount(total, limit);\n\n      if (page === last) return Promise.resolve();\n\n      page = last;\n\n      return doUpdate();\n    },\n\n    get meta() {\n      return cachedMeta;\n    },\n\n    next() {\n      const pages = pageCount(total, limit);\n\n      if (page >= pages) return Promise.resolve();\n\n      page++;\n\n      return doUpdate();\n    },\n\n    optimisticUpdate(mutator, options) {\n      if (optimistic?.active) {\n        throw new SourcererError(\n          'An optimistic update is already active. Rollback the previous update before starting another.',\n        );\n      }\n\n      const prevItems = items;\n      const prevTotal = total;\n\n      optimistic = { active: true, prevItems, prevTotal };\n\n      try {\n        items = mutator(items);\n      } catch (e: unknown) {\n        optimistic = null;\n        throw e;\n      }\n\n      total = options?.total ?? total;\n      notifyListeners();\n\n      return () => {\n        if (optimistic?.active) {\n          optimistic.active = false;\n          items = prevItems;\n          total = prevTotal;\n          optimistic = null;\n          notifyListeners();\n        }\n      };\n    },\n\n    patch(changes) {\n      let changed = false;\n\n      if (changes.limit !== undefined) {\n        const next = Math.max(1, Math.trunc(changes.limit));\n\n        if (next !== limit) {\n          limit = next;\n          changed = true;\n        }\n      }\n\n      if ('filter' in changes) {\n        filter = changes.filter;\n        changed = true;\n      }\n\n      if ('sort' in changes) {\n        sort = changes.sort;\n        changed = true;\n      }\n\n      // `|| base.core.isScheduled` also catches patching in the same search text as an already-pending\n      // debounced search() call — that still needs flushing, not silently dropping as a no-op.\n      if ('search' in changes && (changes.search !== search || base.core.isScheduled)) {\n        search = changes.search ?? '';\n        changed = true;\n      }\n\n      if (changes.page !== undefined) {\n        const next =\n          total > 0 ? clampPage(changes.page, pageCount(total, limit)) : Math.max(1, Math.trunc(changes.page));\n\n        if (next !== page) {\n          page = next;\n          changed = true;\n        }\n      }\n\n      if (!changed) return Promise.resolve();\n\n      // patch() is documented as a single atomic fetch — cancel any debounced search()\n      // still pending so it doesn't fire a second, redundant fetch afterwards.\n      searchCoordinator.cancel();\n\n      // Reset to page 1 when non-page query fields changed without explicit page\n      if (\n        (changes.limit !== undefined || 'filter' in changes || 'sort' in changes || 'search' in changes) &&\n        changes.page === undefined\n      ) {\n        page = 1;\n      }\n\n      return doUpdate();\n    },\n\n    prev() {\n      if (page <= 1) return Promise.resolve();\n\n      page--;\n\n      return doUpdate();\n    },\n\n    get query() {\n      return {\n        ...(filter !== undefined && { filter }),\n        ...(sort !== undefined && { sort }),\n        ...(search && { search }),\n        limit,\n        page,\n      };\n    },\n\n    ready(timeout) {\n      return base.ready(timeout);\n    },\n\n    refresh() {\n      return doUpdate();\n    },\n\n    reset() {\n      searchCoordinator.cancel();\n      search = '';\n      page = 1;\n      filter = cfg.filter;\n      sort = cfg.sort;\n\n      return doUpdate();\n    },\n\n    search(q, opts?: SearchOptions): Promise<void> {\n      if (opts?.immediate) {\n        // A pending debounced search for this same text still needs flushing —\n        // `q === search` alone doesn't mean the fetch already happened.\n        if (q === search && !base.core.isScheduled) return Promise.resolve();\n\n        searchCoordinator.cancel();\n        search = q;\n        page = 1;\n\n        return doUpdate();\n      }\n\n      if (q === search) return Promise.resolve();\n\n      search = q;\n      page = 1;\n\n      return searchCoordinator.schedule(() => void doUpdate(), debounceMs);\n    },\n\n    subscribe: (listener) => base.core.subscribe(listener),\n\n    [Symbol.dispose]: () => {\n      searchCoordinator.cancel();\n      searchCoordinator.dispose();\n      base.dispose();\n    },\n  };\n}\n"],"mappings":"yLASA,SAAgB,EACd,EACiC,CACjC,IAAM,EAAQ,EAAI,UAAY,EAAA,aAGxB,EAAc,EAAI,WAAa,EAGjC,EAAQ,KAAK,IAAI,EAAG,KAAK,MAAM,EAAI,OAAS,EAAE,CAAC,EAC/C,EAAO,EACP,EAAS,GACT,EAA8B,EAAI,OAClC,EAA0B,EAAI,KAC9B,EAAsB,CAAC,EACvB,EAAQ,EACR,EAA+B,KAC/B,EAAgB,EAChB,EAAe,GAGf,EAAqF,KAGrF,EAAI,WACN,EAAQ,EAAI,SAAS,MACrB,EAAQ,EAAI,SAAS,MAEjB,EAAI,SAAS,OAAS,IAAA,KAAW,EAAO,EAAI,SAAS,MAErD,EAAI,SAAS,SAAQ,EAAS,EAAI,SAAS,QAE/C,EAAgB,KAAK,IAAI,GAI3B,IAAI,EAA8B,CAAC,EAC/B,EAAa,EAAA,WAAW,CAC1B,MAAO,KACP,UAAW,GACX,gBAAiB,GACjB,WAAY,EACZ,SAAU,EACV,WAAY,CACd,CAAC,EAEK,MAAoB,CACxB,IAAM,EAAQ,EAAA,UAAU,EAAO,CAAK,EAC9B,EAAW,EAAA,UAAU,EAAM,CAAK,EAGtC,EAAgB,EAChB,EAAa,EAAA,WAAW,CACtB,QACA,UAAW,EAAK,aAAa,EAAI,EACjC,gBAAiB,EAAK,KAAK,YAC3B,WAAY,EACZ,SAAU,EACV,WAAY,CACd,CAAC,CACH,EAIM,EAAO,EAAA,kBAAqD,EAAK,EAAO,CAAW,EACnF,CAAE,YAAW,aAAY,gBAAe,cAAe,EAG7D,EAAY,EAEZ,IAAM,MAAwB,CACxB,EAAK,UAET,EAAK,KAAK,OAAO,CACnB,EACM,EAAoB,EAAA,6BAA6B,EAAK,KAAM,CAAe,EAG3E,EAAU,GAA6D,CACvE,GAAY,SACd,EAAW,OAAS,GACpB,EAAa,MAGf,EAAQ,EAAO,MACf,EAAQ,EAAO,MACf,EAAO,EAAA,UAAU,EAAM,EAAA,UAAU,EAAO,CAAK,CAAC,CAChD,EAGM,OAA0D,CAC9D,GAAI,IAAW,IAAA,IAAa,CAAE,QAAO,EACrC,GAAI,IAAS,IAAA,IAAa,CAAE,MAAK,EACjC,GAAI,GAAU,CAAE,QAAO,EACvB,QACA,MACF,GAEM,EAAc,GAAwD,CAC1E,IAAM,EAAM,EAAM,CAAC,EAcnB,OAXE,EAAc,GACd,IAAQ,GACR,EAAQ,GACR,KAAK,IAAI,EAAI,EAAgB,GAC7B,CAAC,GAAY,OAEN,QAAQ,QAAQ,GAGzB,EAAQ,KAED,EAAK,MACV,EACA,MAAO,EAAsC,EAAQ,IAAa,CAChE,IAAM,EAAY,KAAK,IAAI,EAE3B,GAAI,CACF,IAAM,EAAS,MAAA,EAAA,EAAA,MAAA,CAAa,GAAQ,EAAI,MAAM,EAAG,CAAI,EAAG,CACtD,MAAO,EACP,SACA,MAAO,EAAgB,CACzB,CAAC,EAEG,EAAS,IACX,EAAO,CAAM,EACb,EAAQ,KACR,EAAe,EACf,EAAgB,KAAK,IAAI,EACzB,EAAI,UAAU,CAAE,WAAY,KAAK,IAAI,EAAI,EAAW,MAAO,EAAG,OAAQ,SAAU,CAAC,EAErF,OAAS,EAAiB,CACxB,GAAI,EAAO,QAAS,OAEhB,EAAS,IACP,GAAY,QACd,EAAW,OAAS,GACpB,EAAQ,EAAW,UACnB,EAAQ,EAAW,UACnB,EAAa,OAEb,EAAQ,CAAC,EACT,EAAQ,GAGV,EAAQ,IAAI,EAAA,eAAe,EAAA,aAAa,CAAM,EAAG,CAC/C,MAAO,EACP,QAAS,CAAE,KAAM,SAAU,MAAO,EAAE,MAAO,KAAM,EAAE,KAAM,GAAI,EAAE,QAAU,CAAE,OAAQ,EAAE,MAAO,CAAG,CACjG,CAAC,EACD,EAAI,UAAU,CAAE,WAAY,KAAK,IAAI,EAAI,EAAW,QAAO,MAAO,EAAG,OAAQ,OAAQ,CAAC,EAE1F,CACF,MACM,CACJ,EAAgB,EAEhB,EAAkB,aAAa,EAAK,aAAa,CAAC,CACpD,CACF,EACF,EAEM,MAAiB,EAAW,EAAc,CAAC,EAQjD,OALI,GAAW,EAAc,EAE7B,EAAK,yBAA2B,KAAK,EAAS,CAAC,EAGxC,CACL,IAAI,SAAU,CACZ,OAAO,CACT,EAEA,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EAEA,YAAe,CACb,EAAkB,OAAO,EACzB,EAAkB,QAAQ,EAC1B,EAAK,QAAQ,CACf,EAEA,IAAI,UAAW,CACb,OAAO,EAAK,QACd,EAEA,KAAK,EAAQ,CACX,IAAM,EAAU,EAAQ,EAAI,EAAA,UAAU,EAAQ,EAAA,UAAU,EAAO,CAAK,CAAC,EAAI,KAAK,IAAI,EAAG,KAAK,MAAM,CAAM,CAAC,EAMvG,OAJI,IAAY,EAAa,QAAQ,QAAQ,GAE7C,EAAO,EAEA,EAAS,EAClB,EAEA,UAAW,CACT,IAAM,EAAO,EAAA,UAAU,EAAO,CAAK,EAMnC,OAJI,IAAS,EAAa,QAAQ,QAAQ,GAE1C,EAAO,EAEA,EAAS,EAClB,EAEA,IAAI,MAAO,CACT,OAAO,CACT,EAEA,MAAO,CACL,IAAM,EAAQ,EAAA,UAAU,EAAO,CAAK,EAMpC,OAJI,GAAQ,EAAc,QAAQ,QAAQ,GAE1C,IAEO,EAAS,EAClB,EAEA,iBAAiB,EAAS,EAAS,CACjC,GAAI,GAAY,OACd,MAAM,IAAI,EAAA,eACR,+FACF,EAGF,IAAM,EAAY,EACZ,EAAY,EAElB,EAAa,CAAE,OAAQ,GAAM,YAAW,WAAU,EAElD,GAAI,CACF,EAAQ,EAAQ,CAAK,CACvB,OAAS,EAAY,CAEnB,KADA,GAAa,KACP,CACR,CAKA,MAHA,GAAQ,GAAS,OAAS,EAC1B,EAAgB,MAEH,CACP,GAAY,SACd,EAAW,OAAS,GACpB,EAAQ,EACR,EAAQ,EACR,EAAa,KACb,EAAgB,EAEpB,CACF,EAEA,MAAM,EAAS,CACb,IAAI,EAAU,GAEd,GAAI,EAAQ,QAAU,IAAA,GAAW,CAC/B,IAAM,EAAO,KAAK,IAAI,EAAG,KAAK,MAAM,EAAQ,KAAK,CAAC,EAE9C,IAAS,IACX,EAAQ,EACR,EAAU,GAEd,CAmBA,GAjBI,WAAY,IACd,EAAS,EAAQ,OACjB,EAAU,IAGR,SAAU,IACZ,EAAO,EAAQ,KACf,EAAU,IAKR,WAAY,IAAY,EAAQ,SAAW,GAAU,EAAK,KAAK,eACjE,EAAS,EAAQ,QAAU,GAC3B,EAAU,IAGR,EAAQ,OAAS,IAAA,GAAW,CAC9B,IAAM,EACJ,EAAQ,EAAI,EAAA,UAAU,EAAQ,KAAM,EAAA,UAAU,EAAO,CAAK,CAAC,EAAI,KAAK,IAAI,EAAG,KAAK,MAAM,EAAQ,IAAI,CAAC,EAEjG,IAAS,IACX,EAAO,EACP,EAAU,GAEd,CAgBA,OAdK,GAIL,EAAkB,OAAO,GAItB,EAAQ,QAAU,IAAA,IAAa,WAAY,GAAW,SAAU,GAAW,WAAY,IACxF,EAAQ,OAAS,IAAA,KAEjB,EAAO,GAGF,EAAS,GAdK,QAAQ,QAAQ,CAevC,EAEA,MAAO,CAKL,OAJI,GAAQ,EAAU,QAAQ,QAAQ,GAEtC,IAEO,EAAS,EAClB,EAEA,IAAI,OAAQ,CACV,MAAO,CACL,GAAI,IAAW,IAAA,IAAa,CAAE,QAAO,EACrC,GAAI,IAAS,IAAA,IAAa,CAAE,MAAK,EACjC,GAAI,GAAU,CAAE,QAAO,EACvB,QACA,MACF,CACF,EAEA,MAAM,EAAS,CACb,OAAO,EAAK,MAAM,CAAO,CAC3B,EAEA,SAAU,CACR,OAAO,EAAS,CAClB,EAEA,OAAQ,CAON,OANA,EAAkB,OAAO,EACzB,EAAS,GACT,EAAO,EACP,EAAS,EAAI,OACb,EAAO,EAAI,KAEJ,EAAS,CAClB,EAEA,OAAO,EAAG,EAAqC,CAkB7C,OAjBI,GAAM,UAGJ,IAAM,GAAU,CAAC,EAAK,KAAK,YAAoB,QAAQ,QAAQ,GAEnE,EAAkB,OAAO,EACzB,EAAS,EACT,EAAO,EAEA,EAAS,GAGd,IAAM,EAAe,QAAQ,QAAQ,GAEzC,EAAS,EACT,EAAO,EAEA,EAAkB,aAAe,KAAK,EAAS,EAAG,CAAU,EACrE,EAEA,UAAY,GAAa,EAAK,KAAK,UAAU,CAAQ,GAEpD,OAAO,aAAgB,CACtB,EAAkB,OAAO,EACzB,EAAkB,QAAQ,EAC1B,EAAK,QAAQ,CACf,CACF,CACF"}

package/dist/remoteSource.d.ts

@@ -1,4 +0,0 @@
-import type { RemoteConfig, RemoteSource } from './types';
-/** Creates a remote page-based source that fetches data from a network endpoint. */
-export declare function createRemoteSource<T, TFilter = unknown, TSort = unknown>(cfg: RemoteConfig<T, TFilter, TSort>): RemoteSource<T, TFilter, TSort>;
-//# sourceMappingURL=remoteSource.d.ts.map

package/dist/remoteSource.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"remoteSource.d.ts","sourceRoot":"","sources":["../src/remoteSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAoC,MAAM,SAAS,CAAC;AAQ5F,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACtE,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GACnC,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAuXjC"}

package/dist/remoteSource.js

@@ -1,165 +0,0 @@
-import { SourcererError as e } from "./errors.js";
-import { defaultKeyOf as t, extractError as n, retry as r } from "./_utils.js";
-import { createAsyncSearchCoordinator as i } from "./asyncSearch.js";
-import { createAsyncSource as a } from "./asyncSource.js";
-import { clampPage as o, createMeta as s, pageCount as c } from "./pagination.js";
-//#region src/remoteSource.ts
-function l(l) {
-	let u = l.queryKey ?? t, d = l.staleTime ?? 0, f = Math.max(1, Math.trunc(l.limit ?? 20)), p = 1, m = "", h = l.filter, g = l.sort, _ = [], v = 0, y = null, b = 0, x = "", S = null;
-	l.snapshot && (_ = l.snapshot.items, v = l.snapshot.total, l.snapshot.page !== void 0 && (p = l.snapshot.page), l.snapshot.search && (m = l.snapshot.search), b = Date.now());
-	let C = [], w = s({
-		error: null,
-		isLoading: !1,
-		isSearchPending: !1,
-		pageNumber: 1,
-		pageSize: f,
-		totalItems: 0
-	}), T = () => {
-		let e = c(v, f), t = o(p, e);
-		C = _, w = s({
-			error: y,
-			isLoading: E.pendingCount() > 0,
-			isSearchPending: E.core.isScheduled,
-			pageNumber: t,
-			pageSize: f,
-			totalItems: v
-		});
-	}, E = a(l, u, T), { autoFetch: D, debounceMs: O, retryAttempts: k, retryDelay: A } = E;
-	T();
-	let j = () => {
-		E.disposed || E.core.notify();
-	}, M = i(E.core, j), N = (e) => {
-		S?.active && (S.active = !1, S = null), _ = e.items, v = e.total, p = o(p, c(v, f));
-	}, P = () => ({
-		...h !== void 0 && { filter: h },
-		...g !== void 0 && { sort: g },
-		...m && { search: m },
-		limit: f,
-		page: p
-	}), F = (t) => {
-		let i = u(t);
-		return d > 0 && i === x && v > 0 && Date.now() - b < d && !S?.active ? Promise.resolve() : (y = null, E.fetch(t, async (t, a, o) => {
-			let s = Date.now();
-			try {
-				let e = await r((e) => l.fetch(t, e), {
-					delay: A,
-					signal: a,
-					times: k + 1
-				});
-				o() && (N(e), y = null, x = i, b = Date.now(), l.onFetch?.({
-					durationMs: Date.now() - s,
-					query: t,
-					status: "success"
-				}));
-			} catch (r) {
-				if (a.aborted) return;
-				o() && (S?.active ? (S.active = !1, _ = S.prevItems, v = S.prevTotal, S = null) : (_ = [], v = 0), y = new e(n(r), {
-					cause: r,
-					context: {
-						kind: "remote",
-						limit: t.limit,
-						page: t.page,
-						...t.search && { search: t.search }
-					}
-				}), l.onFetch?.({
-					durationMs: Date.now() - s,
-					error: y,
-					query: t,
-					status: "error"
-				}));
-			}
-		}, () => {
-			j(), M.settleIfIdle(E.pendingCount());
-		}));
-	}, I = () => F(P());
-	return D && I(), E.startRefreshInterval(() => void I()), {
-		get current() {
-			return C;
-		},
-		get disposalSignal() {
-			return E.disposalSignal;
-		},
-		dispose: () => {
-			M.cancel(), M.dispose(), E.dispose();
-		},
-		get disposed() {
-			return E.disposed;
-		},
-		goTo(e) {
-			let t = v > 0 ? o(e, c(v, f)) : Math.max(1, Math.trunc(e));
-			return t === p ? Promise.resolve() : (p = t, I());
-		},
-		goToLast() {
-			let e = c(v, f);
-			return p === e ? Promise.resolve() : (p = e, I());
-		},
-		get meta() {
-			return w;
-		},
-		next() {
-			let e = c(v, f);
-			return p >= e ? Promise.resolve() : (p++, I());
-		},
-		optimisticUpdate(t, n) {
-			if (S?.active) throw new e("An optimistic update is already active. Rollback the previous update before starting another.");
-			let r = _, i = v;
-			S = {
-				active: !0,
-				prevItems: r,
-				prevTotal: i
-			};
-			try {
-				_ = t(_);
-			} catch (e) {
-				throw S = null, e;
-			}
-			return v = n?.total ?? v, j(), () => {
-				S?.active && (S.active = !1, _ = r, v = i, S = null, j());
-			};
-		},
-		patch(e) {
-			let t = !1;
-			if (e.limit !== void 0) {
-				let n = Math.max(1, Math.trunc(e.limit));
-				n !== f && (f = n, t = !0);
-			}
-			if ("filter" in e && (h = e.filter, t = !0), "sort" in e && (g = e.sort, t = !0), "search" in e && (e.search !== m || E.core.isScheduled) && (m = e.search ?? "", t = !0), e.page !== void 0) {
-				let n = v > 0 ? o(e.page, c(v, f)) : Math.max(1, Math.trunc(e.page));
-				n !== p && (p = n, t = !0);
-			}
-			return t ? (M.cancel(), (e.limit !== void 0 || "filter" in e || "sort" in e || "search" in e) && e.page === void 0 && (p = 1), I()) : Promise.resolve();
-		},
-		prev() {
-			return p <= 1 ? Promise.resolve() : (p--, I());
-		},
-		get query() {
-			return {
-				...h !== void 0 && { filter: h },
-				...g !== void 0 && { sort: g },
-				...m && { search: m },
-				limit: f,
-				page: p
-			};
-		},
-		ready(e) {
-			return E.ready(e);
-		},
-		refresh() {
-			return I();
-		},
-		reset() {
-			return M.cancel(), m = "", p = 1, h = l.filter, g = l.sort, I();
-		},
-		search(e, t) {
-			return t?.immediate ? e === m && !E.core.isScheduled ? Promise.resolve() : (M.cancel(), m = e, p = 1, I()) : e === m ? Promise.resolve() : (m = e, p = 1, M.schedule(() => void I(), O));
-		},
-		subscribe: (e) => E.core.subscribe(e),
-		[Symbol.dispose]: () => {
-			M.cancel(), M.dispose(), E.dispose();
-		}
-	};
-}
-//#endregion
-export { l as createRemoteSource };
-
-//# sourceMappingURL=remoteSource.js.map