@vielzeug/sourcerer 1.0.6 → 2.0.0

package/dist/remoteSource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"remoteSource.js","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":"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"}

package/dist/state.cjs

@@ -1,2 +0,0 @@
-function e(e){return e.meta.isLoading||e.meta.isSearchPending?{status:`loading`}:e.meta.error?{error:e.meta.error,status:`error`}:{items:e.current,status:`success`}}exports.sourceState=e;
-//# sourceMappingURL=state.cjs.map

package/dist/state.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.cjs","names":[],"sources":["../src/state.ts"],"sourcesContent":["import type { SourcererError, SourceState } from './types';\n\n/**\n * Derives a `SourceState<T>` discriminated union from a reactive source.\n * Works with any object that exposes `current`, `meta.isLoading`, `meta.error`, and optionally `meta.isSearchPending`.\n * Returns `'loading'` when `isLoading` or `isSearchPending` is true, so callers see a spinner during debounce windows.\n *\n * @example\n * ```ts\n * const state = sourceState(source);\n * if (state.status === 'loading') return <Spinner />;\n * if (state.status === 'error') return <p>{state.error.message}</p>;\n * return <List items={state.items} />;\n * ```\n */\nexport function sourceState<T>(source: {\n  readonly current: readonly T[];\n  readonly meta: {\n    readonly error: SourcererError | null;\n    readonly isLoading: boolean;\n    readonly isSearchPending?: boolean;\n  };\n}): SourceState<T> {\n  if (source.meta.isLoading || source.meta.isSearchPending) return { status: 'loading' };\n\n  if (source.meta.error) return { error: source.meta.error, status: 'error' };\n\n  return { items: source.current, status: 'success' };\n}\n"],"mappings":"AAeA,SAAgB,EAAe,EAOZ,CAKjB,OAJI,EAAO,KAAK,WAAa,EAAO,KAAK,gBAAwB,CAAE,OAAQ,SAAU,EAEjF,EAAO,KAAK,MAAc,CAAE,MAAO,EAAO,KAAK,MAAO,OAAQ,OAAQ,EAEnE,CAAE,MAAO,EAAO,QAAS,OAAQ,SAAU,CACpD"}

package/dist/state.d.ts

@@ -1,23 +0,0 @@
-import type { SourcererError, SourceState } from './types';
-/**
- * Derives a `SourceState<T>` discriminated union from a reactive source.
- * Works with any object that exposes `current`, `meta.isLoading`, `meta.error`, and optionally `meta.isSearchPending`.
- * Returns `'loading'` when `isLoading` or `isSearchPending` is true, so callers see a spinner during debounce windows.
- *
- * @example
- * ```ts
- * const state = sourceState(source);
- * if (state.status === 'loading') return <Spinner />;
- * if (state.status === 'error') return <p>{state.error.message}</p>;
- * return <List items={state.items} />;
- * ```
- */
-export declare function sourceState<T>(source: {
-    readonly current: readonly T[];
-    readonly meta: {
-        readonly error: SourcererError | null;
-        readonly isLoading: boolean;
-        readonly isSearchPending?: boolean;
-    };
-}): SourceState<T>;
-//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;QACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;KACpC,CAAC;CACH,GAAG,WAAW,CAAC,CAAC,CAAC,CAMjB"}

package/dist/state.js

@@ -1,14 +0,0 @@
-//#region src/state.ts
-function e(e) {
-	return e.meta.isLoading || e.meta.isSearchPending ? { status: "loading" } : e.meta.error ? {
-		error: e.meta.error,
-		status: "error"
-	} : {
-		items: e.current,
-		status: "success"
-	};
-}
-//#endregion
-export { e as sourceState };
-
-//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.js","names":[],"sources":["../src/state.ts"],"sourcesContent":["import type { SourcererError, SourceState } from './types';\n\n/**\n * Derives a `SourceState<T>` discriminated union from a reactive source.\n * Works with any object that exposes `current`, `meta.isLoading`, `meta.error`, and optionally `meta.isSearchPending`.\n * Returns `'loading'` when `isLoading` or `isSearchPending` is true, so callers see a spinner during debounce windows.\n *\n * @example\n * ```ts\n * const state = sourceState(source);\n * if (state.status === 'loading') return <Spinner />;\n * if (state.status === 'error') return <p>{state.error.message}</p>;\n * return <List items={state.items} />;\n * ```\n */\nexport function sourceState<T>(source: {\n  readonly current: readonly T[];\n  readonly meta: {\n    readonly error: SourcererError | null;\n    readonly isLoading: boolean;\n    readonly isSearchPending?: boolean;\n  };\n}): SourceState<T> {\n  if (source.meta.isLoading || source.meta.isSearchPending) return { status: 'loading' };\n\n  if (source.meta.error) return { error: source.meta.error, status: 'error' };\n\n  return { items: source.current, status: 'success' };\n}\n"],"mappings":";AAeA,SAAgB,EAAe,GAOZ;CAKjB,OAJI,EAAO,KAAK,aAAa,EAAO,KAAK,kBAAwB,EAAE,QAAQ,UAAU,IAEjF,EAAO,KAAK,QAAc;EAAE,OAAO,EAAO,KAAK;EAAO,QAAQ;CAAQ,IAEnE;EAAE,OAAO,EAAO;EAAS,QAAQ;CAAU;AACpD"}