@vielzeug/sourcerer 1.1.0 → 2.0.1

package/dist/sourcerer.iife.js.map

@@ -1 +1 @@
-{"version":3,"file":"sourcerer.iife.js","names":["#opts"],"sources":["../src/_dev.ts","../src/_utils.ts","../src/errors.ts","../src/codecs.ts","../src/asyncSearch.ts","../src/core.ts","../src/fetchManager.ts","../src/asyncSource.ts","../src/cursorSource.ts","../src/derive.ts","../src/infiniteSource.ts","../src/pagination.ts","../src/localSource.ts","../src/merge.ts","../src/remoteSource.ts","../src/prefetch.ts","../src/presets.ts","../src/state.ts"],"sourcesContent":["const isDev = !(globalThis as { __SOURCERER_PROD__?: boolean }).__SOURCERER_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/sourcerer] ${msg}`);\n}\n\n/** @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() call. */\nexport function devOnly(fn: () => void): void {\n  if (isDev) fn();\n}\n","import { backoff, hash, retry } from '@vielzeug/arsenal';\n\nimport { devOnly, warn } from './_dev';\n\nexport { retry };\n\n// Internal stable-key helper — used by source factories, not exposed as public API.\nexport const defaultKeyOf = hash;\n\n/** Extracts a user-facing error message from a caught exception. */\nexport const extractError = (reason: unknown): string => {\n  if (reason instanceof Error) return reason.message;\n\n  if (typeof reason === 'string' && reason.length > 0) return reason;\n\n  return 'Request failed';\n};\n\n/** Default exponential backoff: 1 s, 2 s, 4 s, … capped at 30 s. Receives a 0-indexed failure count. */\nexport const defaultRetryDelay = (attempt: number): number => backoff(attempt);\n\n/**\n * Strips control characters (which could otherwise inject terminal escape sequences into\n * `console.warn`/`console.debug` output) and caps length before interpolating caller- or\n * user-controlled text into a dev warning. Same approach as `@vielzeug/forge`'s\n * `sanitizeForLog` — duplicated rather than shared, per this repo's zero-cross-package-utility\n * convention for internal-only helpers.\n */\nexport function sanitizeForLog(text: string, maxLength = 200): string {\n  return text.replace(/\\p{C}/gu, '?').slice(0, maxLength);\n}\n\nconst warnedClamps = new Set<string>();\n\n/**\n * Coerces a user-supplied `limit`/`page`/target value to a positive integer, warning once per\n * `(apiLabel, fieldName)` call site in dev when the raw input needed clamping (negative, zero,\n * or non-finite) — every source factory previously did `Math.max(1, Math.trunc(value))`\n * silently, so a typo'd or miscalculated config value (e.g. `limit: -1`) produced no signal at\n * all. The once-per-call-site de-dup matters here specifically because `limit`/`page` reach this\n * function via `patch()`, which realistically sits behind live UI (a numeric input, a stepper) —\n * without it, a single persistently-invalid bound value would re-warn on every keystroke.\n * Fractional inputs (e.g. `2.5`) are truncated without a warning — that's a harmless\n * normalization, not a likely mistake.\n */\nexport function clampPositiveInt(value: number, apiLabel: string, fieldName: string): number {\n  const clamped = Number.isFinite(value) ? Math.max(1, Math.trunc(value)) : 1;\n\n  if (!Number.isFinite(value) || value < 1) {\n    const key = `${apiLabel}:${fieldName}`;\n\n    if (!warnedClamps.has(key)) {\n      warnedClamps.add(key);\n      devOnly(() =>\n        warn(`${apiLabel}: ${fieldName} ${value} is invalid — clamped to ${clamped}. Must be a positive integer.`),\n      );\n    }\n  }\n\n  return clamped;\n}\n","/**\n * Structured context carried by `SourcererError`.\n * Discriminated on `kind` — narrow with `error.context?.kind` to access typed fields.\n *\n * @example\n * ```ts\n * if (source.meta.error?.context?.kind === 'remote') {\n *   console.log('Failed page', source.meta.error.context.page);\n * }\n * ```\n */\nexport type SourcererErrorContext =\n  | Readonly<{ kind: 'cursor'; limit: number; search?: string }>\n  | Readonly<{ kind: 'infinite'; limit: number; page: number; search?: string }>\n  | Readonly<{ kind: 'remote'; limit: number; page: number; search?: string }>;\n\n/**\n * Base class for all sourcerer errors. Catch with `instanceof SourcererError` to handle any\n * sourcerer-originated error regardless of specific subtype.\n *\n * Carries the original cause, structured context, and the attempt number.\n *\n * @example\n * ```ts\n * if (source.meta.error) {\n *   console.error(source.meta.error.message, source.meta.error.context);\n * }\n * ```\n */\nexport class SourcererError extends Error {\n  readonly #opts: {\n    readonly attempt?: number;\n    readonly cause?: unknown;\n    readonly context?: SourcererErrorContext;\n  };\n\n  constructor(\n    message: string,\n    opts: {\n      readonly attempt?: number;\n      readonly cause?: unknown;\n      readonly context?: SourcererErrorContext;\n    } = {},\n  ) {\n    super(message, opts.cause !== undefined ? { cause: opts.cause } : undefined);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n    this.#opts = opts;\n  }\n\n  get attempt(): number {\n    return this.#opts.attempt ?? 0;\n  }\n\n  /** Context bag for the error — safe to log. */\n  get context(): SourcererErrorContext | undefined {\n    return this.#opts.context;\n  }\n\n  static is(err: unknown): err is SourcererError {\n    return err instanceof SourcererError;\n  }\n}\n\n/** Thrown by `ready()` when the source timed out waiting for the first successful fetch. */\nexport class SourcererTimeoutError extends SourcererError {\n  /** The configured timeout in milliseconds. */\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number) {\n    super(`Source.ready() timed out after ${timeoutMs}ms`);\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/** Thrown by `ready()` when the source is disposed while waiting. */\nexport class SourcererDisposedError extends SourcererError {\n  constructor() {\n    super('Source disposed while waiting for ready()');\n  }\n}\n","import type { QueryParams, QueryParamsInput, RemoteSourceQuery, SourceQuery } from './types';\n\nimport { devOnly, warn } from './_dev';\nimport { sanitizeForLog } from './_utils';\nimport { SourcererError } from './errors';\n\n/**\n * Serialises a `SourceQuery` or `RemoteSourceQuery` into plain URL-safe string params.\n *\n * ⚠️ `filter` and `sort` are JSON-stringified without a try/catch. A circular object reference\n * throws a native `TypeError` (\"Converting circular structure to JSON\") straight out of this\n * function — ensure filter/sort values are plain serialisable objects, or wrap the call yourself.\n *\n * ⚠️ Round-trip fidelity: `page` and `limit` must be positive integers. `encodeQuery` will\n * serialise any number (including 0), but `decodeQuery` clamps non-positive values to 1/defaultLimit.\n *\n * `encodeQuery` + `decodeQuery` form a round-trip pair: filter/sort values are JSON-stringified\n * on encode and JSON-parsed on decode.\n */\nexport const encodeQuery = <TFilter = unknown, TSort = unknown>(\n  query: RemoteSourceQuery<TFilter, TSort> | SourceQuery,\n): QueryParams => {\n  const base: QueryParams = {\n    ...(query.search && { search: query.search }),\n    limit: String(query.limit),\n    page: String(query.page),\n  };\n\n  const rq = query as RemoteSourceQuery<TFilter, TSort>;\n\n  if (rq.filter !== undefined) {\n    base['filter'] = JSON.stringify(rq.filter);\n  }\n\n  if (rq.sort !== undefined) {\n    base['sort'] = JSON.stringify(rq.sort);\n  }\n\n  return base;\n};\n\nexport type DecodeQueryOptions = Readonly<{\n  defaultLimit?: number;\n  strict?: boolean;\n}>;\n\n/**\n * Parses URL query params into a `Partial<RemoteSourceQuery<unknown, unknown>>`.\n * Accepts either a plain `Record<string, string | string[] | undefined>` or a `URLSearchParams` instance.\n *\n * - `filter` and `sort` are JSON-parsed and typed as `unknown` — validate and narrow them\n *   with a runtime schema (e.g. Zod) before passing to `source.patch(...)`.\n * - `search` is omitted from the result when the param is absent (rather than defaulting to `''`).\n * - `limit` and `page` are parsed as positive integers; invalid values fall back to defaults.\n */\nexport const decodeQuery = (\n  params: QueryParamsInput | URLSearchParams,\n  options: DecodeQueryOptions = {},\n): Partial<RemoteSourceQuery<unknown, unknown>> => {\n  const raw: QueryParamsInput =\n    params instanceof URLSearchParams ? (Object.fromEntries(params.entries()) as QueryParamsInput) : params;\n\n  const { defaultLimit = 20, strict = false } = options;\n\n  // Deliberately not `_utils.ts::clampPositiveInt` here: that one truncates a fractional\n  // config value (2.5 -> 2) as a harmless normalization, and always floors invalid input to 1.\n  // A URL param is untrusted network input, not a caller's own config object — \"2.5\" or \"-5\"\n  // in a query string is more likely a corrupted/tampered link than a rounding artifact, so\n  // this stays strict (reject anything that isn't a clean positive integer) and falls back to\n  // the caller's own `defaultLimit`/`1`, not an unconditional floor of 1.\n  //\n  // @security `str` is the raw, attacker-controllable param value (this function's whole job\n  // is parsing untrusted `location.search`/route params) — sanitize before interpolating into\n  // the warning to prevent terminal-escape-sequence injection into a developer's console.\n  const parsePositiveInt = (fieldName: string, value: string | string[] | undefined, fallback: number): number => {\n    if (value === undefined) return fallback;\n\n    const str = Array.isArray(value) ? value[0] : value;\n    const n = Number(str);\n\n    if (Number.isInteger(n) && n > 0) return n;\n\n    devOnly(() =>\n      warn(`decodeQuery: ${fieldName} \"${sanitizeForLog(str, 80)}\" is not a positive integer — using ${fallback}.`),\n    );\n\n    return fallback;\n  };\n\n  // @security Same as `parsePositiveInt` above — `str` is untrusted and may end up in a\n  // terminal/log aggregator via this error's `.message`, not just a direct `console.warn`.\n  const parseJson = (key: string, value: string | string[] | undefined): unknown => {\n    if (value === undefined) return undefined;\n\n    const str = Array.isArray(value) ? value[0] : value;\n\n    try {\n      return JSON.parse(str) as unknown;\n    } catch {\n      if (strict) throw new SourcererError(`Invalid query param \"${key}\": ${sanitizeForLog(str, 80)}`);\n\n      return undefined;\n    }\n  };\n\n  const rawLimit = raw['limit'];\n  const rawPage = raw['page'];\n  const rawSearch = raw['search'];\n  const rawFilter = raw['filter'];\n  const rawSort = raw['sort'];\n\n  const filter = rawFilter !== undefined ? parseJson('filter', rawFilter) : undefined;\n  const sort = rawSort !== undefined ? parseJson('sort', rawSort) : undefined;\n\n  const result: Partial<RemoteSourceQuery<unknown, unknown>> = {\n    ...(filter !== undefined && { filter }),\n    ...(sort !== undefined && { sort }),\n    ...(rawSearch !== undefined && { search: Array.isArray(rawSearch) ? rawSearch[0] : rawSearch }),\n    limit: parsePositiveInt('limit', rawLimit, defaultLimit),\n    page: parsePositiveInt('page', rawPage, 1),\n  };\n\n  return result;\n};\n","import type { SourceCore } from './core';\n\nexport type AsyncSearchCoordinator = Readonly<{\n  cancel(): void;\n  dispose(): void;\n  schedule(run: () => void, delayMs: number): Promise<void>;\n  settleIfIdle(pendingCount: number): void;\n}>;\n\n/**\n * Shared debounced-search promise orchestration for async sources.\n * Keeps search() promise lifecycles consistent across remote/cursor/infinite sources.\n */\nexport function createAsyncSearchCoordinator(core: SourceCore, notify: () => void): AsyncSearchCoordinator {\n  let pendingResolve: (() => void) | null = null;\n\n  const resolvePending = () => {\n    if (pendingResolve) {\n      pendingResolve();\n      pendingResolve = null;\n    }\n  };\n\n  return {\n    cancel() {\n      core.cancelTimer();\n      resolvePending();\n    },\n\n    dispose() {\n      resolvePending();\n    },\n\n    schedule(run, delayMs) {\n      resolvePending();\n\n      const promise = new Promise<void>((resolve) => {\n        pendingResolve = resolve;\n      });\n\n      core.schedule(run, delayMs);\n      notify();\n\n      return promise;\n    },\n\n    settleIfIdle(pendingCount) {\n      if (pendingCount === 0) resolvePending();\n    },\n  };\n}\n","import { SourcererDisposedError, SourcererTimeoutError } from './errors';\n\n/**\n * Shared source infrastructure: change notification, debounce scheduling, and ready() polling.\n * All source factories compose this core rather than duplicating the same patterns.\n *\n * Change notification is a plain `Set<listener>` — deliberately NOT `@vielzeug/ripple`, despite\n * that being the repo-wide convention for \"reactive\" packages. Tried it; reverted. Two concrete\n * problems, not just aesthetics:\n *\n * 1. `prefetchSource()`/`prefetchSourceAndKeep()` are explicitly documented for SSR, and every\n *    source factory routes through this file's `signal`-backed notify. Ripple's own scheduler\n *    warns that its module-level flush queue is shared across concurrent requests in Node.js\n *    unless the caller opts into `@vielzeug/ripple/ssr`'s per-request isolation — a real,\n *    unaddressed risk in exactly the code path meant to run on a server handling concurrent\n *    requests.\n * 2. `subscribe()`'s public contract is \"fire on every notify()\", not per-field reactivity —\n *    ripple's dependency-tracking machinery (a real subscription object per `watch()` call)\n *    buys nothing over a bare `Set.add()` for that contract, since there's exactly one thing\n *    ever being watched (an internal version counter, not real data).\n *\n * `current`/`meta` themselves were never ripple signals either way — the public shape has\n * always been plain getters + `subscribe()`, framework-agnostic by design (see `types.ts`'s\n * `ReactiveSource` doc comment). Nothing about restoring a plain `Set` changes that contract.\n *\n * Debounce scheduling and `ready()`'s \"resolve when idle, with a timeout\" polling were never\n * ripple's job either way: ripple is a dependency-tracking signal system (\"notify when a value\n * changes\"), not an async-coordination library (\"wait for a condition, with a timeout, and\n * reject if disposed first\").\n */\nexport type SourceCore = {\n  /** Cancels any pending timer without invoking the callback. */\n  cancelTimer(): void;\n\n  /** `AbortSignal` that is aborted when `dispose()` is called. */\n  readonly disposalSignal: AbortSignal;\n\n  /**\n   * Clears all listeners, cancels any pending timer, and marks the core as disposed.\n   * Subsequent method calls on the core become no-ops.\n   */\n  dispose(): void;\n\n  /**\n   * If a timer is scheduled, cancels it and immediately invokes `fn`.\n   * Returns a resolved Promise when no timer is pending.\n   */\n  flush(fn: () => Promise<void>): Promise<void>;\n\n  /** Whether `dispose()` has been called. All methods become no-ops after disposal. */\n  readonly isDisposed: boolean;\n\n  /** Whether a debounce timer is currently scheduled (drives `meta.isSearchPending`). */\n  readonly isScheduled: boolean;\n\n  /**\n   * Fire all registered listeners and wake any `ready()` waiters.\n   * When provided, `onBefore` runs once before listeners are called — use it to\n   * refresh cached meta/current before subscribers observe the new state.\n   */\n  notify(onBefore?: () => void): void;\n\n  /**\n   * Returns a Promise that resolves when `isIdle()` returns true.\n   * Resolves synchronously if already idle.\n   * Rejects with a `TimeoutError` after `timeoutMs` ms if still not idle.\n   */\n  ready(isIdle: () => boolean, timeoutMs?: number): Promise<void>;\n\n  /**\n   * Schedules a debounced callback, replacing any pending timer.\n   * The callback is invoked after `delayMs` ms of inactivity.\n   */\n  schedule(fn: () => void, delayMs: number): void;\n\n  /** Subscribe to change notifications. Returns an unsubscribe function. */\n  subscribe(listener: () => void): () => void;\n};\n\nexport function createSourceCore(opts?: { onBeforeNotify?: () => void }): SourceCore {\n  const listeners = new Set<() => void>();\n  const readyWaiters = new Set<{\n    check: () => void;\n    reject: (err: unknown) => void;\n    timeoutId?: ReturnType<typeof setTimeout>;\n  }>();\n  const controller = new AbortController();\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let disposed = false;\n\n  return {\n    cancelTimer() {\n      if (timer) {\n        clearTimeout(timer);\n        timer = undefined;\n      }\n    },\n\n    get disposalSignal() {\n      return controller.signal;\n    },\n\n    dispose() {\n      if (timer) {\n        clearTimeout(timer);\n        timer = undefined;\n      }\n\n      for (const waiter of readyWaiters) {\n        if (waiter.timeoutId !== undefined) clearTimeout(waiter.timeoutId);\n\n        waiter.reject(new SourcererDisposedError());\n      }\n\n      readyWaiters.clear();\n      listeners.clear();\n      disposed = true;\n      controller.abort();\n    },\n\n    flush(fn) {\n      if (!timer) return Promise.resolve();\n\n      clearTimeout(timer);\n      timer = undefined;\n\n      return fn();\n    },\n\n    get isDisposed() {\n      return disposed;\n    },\n\n    get isScheduled() {\n      return timer !== undefined;\n    },\n\n    notify(onBefore?: () => void) {\n      if (disposed) return;\n\n      (onBefore ?? opts?.onBeforeNotify)?.();\n\n      for (const listener of listeners) {\n        listener();\n      }\n\n      for (const waiter of readyWaiters) {\n        waiter.check();\n      }\n    },\n\n    ready(isIdle, timeoutMs) {\n      if (disposed) return Promise.reject(new SourcererDisposedError());\n\n      if (isIdle()) return Promise.resolve();\n\n      return new Promise<void>((resolve, reject) => {\n        const waiter: { check: () => void; reject: (err: unknown) => void; timeoutId?: ReturnType<typeof setTimeout> } =\n          {\n            check: () => {\n              if (isIdle()) {\n                if (waiter.timeoutId !== undefined) clearTimeout(waiter.timeoutId);\n\n                readyWaiters.delete(waiter);\n                resolve();\n              }\n            },\n            reject,\n          };\n\n        if (timeoutMs !== undefined) {\n          waiter.timeoutId = setTimeout(() => {\n            readyWaiters.delete(waiter);\n            reject(new SourcererTimeoutError(timeoutMs));\n          }, timeoutMs);\n        }\n\n        readyWaiters.add(waiter);\n      });\n    },\n\n    schedule(fn, delayMs) {\n      if (disposed) return;\n\n      if (timer) clearTimeout(timer);\n\n      timer = setTimeout(() => {\n        timer = undefined;\n        fn();\n      }, delayMs);\n    },\n\n    subscribe(listener) {\n      if (disposed) return () => {};\n\n      listeners.add(listener);\n\n      return () => listeners.delete(listener);\n    },\n  };\n}\n","/**\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 * Deliberately not `@vielzeug/courier`'s query cache: retry itself already comes from the\n * one shared implementation both packages use (`retry` from `@vielzeug/arsenal` — see\n * `_utils.ts`), so there's no retry logic duplicated here to remove. What's left — \"only one\n * query is ever active per source instance; a new query always supersedes and aborts the\n * previous one, regardless of key\" — is a narrower, different contract than courier's, which\n * is a shared cross-consumer cache keyed by query (many independent entries, each with its own\n * staleness window, meant to be read by multiple observers). Forcing this single-active-query\n * source to route through a per-key shared cache would need as much glue code to reconcile the\n * two models as this file already is, for no behavioral win. See `docs/sourcerer/examples/\n * sourcerer-with-courier.md` for the actually-intended integration point: pass a courier-backed\n * client call as the `fetch` callback into `createRemoteSource()` — composition at the\n * transport layer, not inside this dedup manager.\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","import type { SourceCore } from './core';\n\nimport { defaultKeyOf, defaultRetryDelay } from './_utils';\nimport { createSourceCore } from './core';\nimport { createFetchManager } from './fetchManager';\n\n/**\n * Configuration subset common to all async source types.\n * Extracted to eliminate duplication across remote, cursor, and infinite sources.\n */\nexport type AsyncSourceConfig<TQuery> = Readonly<{\n  autoFetch?: boolean;\n  debounceMs?: number;\n  queryKey?: (q: TQuery) => string;\n  refreshInterval?: number;\n  retry?: { attempts?: number; delay?: (attempt: number) => number };\n}>;\n\nexport type FetchExecutor<TQuery> = (q: TQuery, signal: AbortSignal, isLatest: () => boolean) => Promise<void>;\n\nexport type AsyncSourceInfra<TQuery> = {\n  [Symbol.dispose](): void;\n  /** `true` when `autoFetch !== false`. */\n  readonly autoFetch: boolean;\n  /** The underlying SourceCore — use directly for subscribe, schedule, cancelTimer, flush, isScheduled. */\n  readonly core: SourceCore;\n  /** Debounce delay in ms. */\n  readonly debounceMs: number;\n  /** `AbortSignal` aborted when `dispose()` is called. */\n  readonly disposalSignal: AbortSignal;\n  /** Dispose lifecycle: cancel refresh interval, dispose FM, dispose core. Idempotent. */\n  dispose(): void;\n  /** `true` after `dispose()`. */\n  readonly disposed: boolean;\n  /**\n   * Run a deduplicated fetch for query `q`.\n   * Calls `onCommit()` whenever pending count changes (for subscriber notification).\n   */\n  fetch(q: TQuery, execute: FetchExecutor<TQuery>, onCommit: () => void): Promise<void>;\n  /** Number of currently in-flight requests. */\n  pendingCount(): number;\n  /** Resolves when idle (no in-flight requests, no pending debounce). */\n  ready(timeout?: number): Promise<void>;\n  /** Number of retry attempts after the first failure. */\n  readonly retryAttempts: number;\n  /** Returns the delay in ms before the nth retry. */\n  readonly retryDelay: (attempt: number) => number;\n  /**\n   * Wire the refresh interval. Must be called once after construction, passing\n   * the source-level `doUpdate` callback. Does nothing when `refreshInterval`\n   * is unset or ≤ 0.\n   */\n  startRefreshInterval(doUpdate: () => void): void;\n};\n\n/**\n * Creates the shared infrastructure used by `createRemoteSource`, `createCursorSource`,\n * and `createInfiniteSource`. Eliminates duplication of lifecycle, config-defaults,\n * fetch-manager setup, dispose, ready, flush, and refresh-interval logic.\n *\n * Each source factory composes this and adds its own query state, meta shape, and\n * source-specific methods. Pass `onBeforeNotify` to run `refreshMeta()` before\n * subscribers observe each notification — this eliminates the need for a parallel\n * listeners Set in each source factory.\n */\nexport function createAsyncSource<TQuery>(\n  cfg: AsyncSourceConfig<TQuery>,\n  keyOf: (q: TQuery) => string = defaultKeyOf as (q: TQuery) => string,\n  onBeforeNotify?: () => void,\n): AsyncSourceInfra<TQuery> {\n  const core = createSourceCore({ onBeforeNotify });\n  const fm = createFetchManager<TQuery>(keyOf);\n  const debounceMs = cfg.debounceMs ?? 300;\n  const retryAttempts = cfg.retry?.attempts ?? 0;\n  const retryDelay = cfg.retry?.delay ?? defaultRetryDelay;\n  const autoFetch = cfg.autoFetch !== false;\n\n  let refreshTimer: ReturnType<typeof setInterval> | undefined;\n\n  const dispose = (): void => {\n    if (core.isDisposed) return;\n\n    if (refreshTimer !== undefined) {\n      clearInterval(refreshTimer);\n      refreshTimer = undefined;\n    }\n\n    fm.dispose();\n    core.dispose();\n  };\n\n  return {\n    autoFetch,\n    core,\n    debounceMs,\n    get disposalSignal() {\n      return core.disposalSignal;\n    },\n\n    dispose,\n\n    get disposed() {\n      return core.isDisposed;\n    },\n\n    fetch(q, execute, onCommit) {\n      return fm.run(q, execute, onCommit);\n    },\n\n    pendingCount: () => fm.pendingCount,\n\n    ready(timeout) {\n      return core.ready(() => fm.pendingCount === 0 && !core.isScheduled, timeout);\n    },\n    retryAttempts,\n\n    retryDelay,\n\n    startRefreshInterval(doUpdate) {\n      if (cfg.refreshInterval !== undefined && cfg.refreshInterval > 0) {\n        refreshTimer = setInterval(() => {\n          if (!core.isDisposed) doUpdate();\n        }, cfg.refreshInterval);\n      }\n    },\n\n    [Symbol.dispose]: dispose,\n  };\n}\n","import type { CursorConfig, CursorMeta, CursorSource, CursorSourceQuery, SearchOptions } from './types';\n\nimport { clampPositiveInt, defaultKeyOf, extractError, retry } from './_utils';\nimport { createAsyncSearchCoordinator } from './asyncSearch';\nimport { createAsyncSource } from './asyncSource';\nimport { SourcererError } from './errors';\n\n/** Creates a cursor-based (keyset-pagination) source that fetches data from a network endpoint. */\nexport function createCursorSource<T, TCursor = string>(cfg: CursorConfig<T, TCursor>): CursorSource<T, TCursor> {\n  const keyOf = cfg.queryKey ?? defaultKeyOf;\n\n  // ── Mutable state ───────────────────────────────────────────────────────────\n  let limit = clampPositiveInt(cfg.limit ?? 20, 'createCursorSource', 'limit');\n  let search = '';\n  let afterCursor: TCursor | undefined;\n  let beforeCursor: TCursor | undefined;\n  let nextCursor: TCursor | undefined;\n  let prevCursor: TCursor | undefined;\n  let items: readonly T[] = [];\n  let total = 0;\n  let error: SourcererError | null = null;\n\n  // ── Cached accessors ────────────────────────────────────────────────────────\n  let cachedCurrent: readonly T[] = [];\n  let cachedMeta: CursorMeta = {\n    error: null,\n    hasNextPage: false,\n    hasPrevPage: false,\n    isLoading: false,\n    isSearchPending: false,\n    pageSize: limit,\n    totalItems: 0,\n  };\n\n  const refreshMeta = () => {\n    cachedCurrent = items;\n    cachedMeta = {\n      error,\n      hasNextPage: nextCursor !== undefined,\n      hasPrevPage: prevCursor !== undefined,\n      isLoading: base.pendingCount() > 0,\n      isSearchPending: base.core.isScheduled,\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<CursorSourceQuery<TCursor>>(cfg, keyOf, refreshMeta);\n  const { autoFetch, debounceMs, retryAttempts, retryDelay } = base;\n\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  // ── Core fetch ──────────────────────────────────────────────────────────────\n  const toRemoteQuery = (): CursorSourceQuery<TCursor> => ({\n    ...(afterCursor !== undefined && { after: afterCursor }),\n    ...(beforeCursor !== undefined && { before: beforeCursor }),\n    ...(search && { search }),\n    limit,\n  });\n\n  const fetchQuery = (q: CursorSourceQuery<TCursor>): Promise<void> => {\n    error = null;\n\n    return base.fetch(\n      q,\n      async (q, 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            items = result.items;\n            total = result.total ?? result.items.length;\n            nextCursor = result.nextCursor;\n            prevCursor = result.prevCursor;\n            error = null;\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            items = [];\n            total = 0;\n            nextCursor = undefined;\n            prevCursor = undefined;\n            error = new SourcererError(extractError(reason), {\n              cause: reason,\n              context: { kind: 'cursor', limit: q.limit, ...(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    get meta() {\n      return cachedMeta;\n    },\n\n    next() {\n      if (!nextCursor) return Promise.resolve();\n\n      afterCursor = nextCursor;\n      beforeCursor = undefined;\n\n      return doUpdate();\n    },\n\n    patch(changes) {\n      let changed = false;\n\n      if (changes.limit !== undefined) {\n        const next = clampPositiveInt(changes.limit, 'source.patch', 'limit');\n\n        if (next !== limit) {\n          limit = next;\n          afterCursor = undefined;\n          beforeCursor = undefined;\n          changed = true;\n        }\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        afterCursor = undefined;\n        beforeCursor = undefined;\n        changed = true;\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      return doUpdate();\n    },\n\n    prev() {\n      if (!prevCursor) return Promise.resolve();\n\n      beforeCursor = prevCursor;\n      afterCursor = undefined;\n\n      return doUpdate();\n    },\n\n    get query() {\n      return {\n        ...(afterCursor !== undefined && { after: afterCursor }),\n        ...(beforeCursor !== undefined && { before: beforeCursor }),\n        ...(search && { search }),\n        limit,\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      afterCursor = undefined;\n      beforeCursor = undefined;\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        afterCursor = undefined;\n        beforeCursor = undefined;\n\n        return doUpdate();\n      }\n\n      if (q === search) return Promise.resolve();\n\n      search = q;\n      afterCursor = undefined;\n      beforeCursor = undefined;\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","import type { DerivedSource } from './types';\n\nimport { createSourceCore } from './core';\n\n/**\n * Creates a reactive read-only projection derived from a parent source.\n *\n * The derived source mirrors the parent's `meta` and applies `transform` to `current`\n * whenever the parent changes. This is useful for client-side projections (e.g. additional\n * filtering, mapping, or sorting) over a remote source without re-fetching.\n *\n * Call `dispose()` to stop listening to the parent.\n *\n * @example\n * ```ts\n * const source = createRemoteSource<User>({ fetch: fetchUsers, limit: 20 });\n *\n * // Show only active users without re-fetching.\n * const activeUsers = deriveSource(source, (items) => items.filter((u) => u.active));\n *\n * activeUsers.subscribe(() => {\n *   console.log(activeUsers.current, activeUsers.meta.totalItems);\n * });\n * ```\n */\nexport function deriveSource<T, U, TMeta>(\n  parent: {\n    readonly current: readonly T[];\n    readonly disposalSignal?: AbortSignal;\n    readonly meta: TMeta;\n    subscribe(listener: () => void): () => void;\n  },\n  transform: (items: readonly T[]) => readonly U[],\n): DerivedSource<U, TMeta> {\n  const core = createSourceCore();\n  let cachedCurrent: readonly U[] = [];\n\n  const applyTransform = () => {\n    cachedCurrent = transform(parent.current);\n  };\n\n  applyTransform();\n\n  const unsubscribeParent = parent.subscribe(() => {\n    applyTransform();\n    core.notify();\n  });\n\n  const source: DerivedSource<U, TMeta> = {\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      unsubscribeParent();\n      core.dispose();\n    },\n\n    get disposed() {\n      return core.isDisposed;\n    },\n\n    get meta() {\n      return parent.meta;\n    },\n\n    subscribe(listener) {\n      return core.subscribe(listener);\n    },\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  // Only tracked when the parent actually exposes a disposalSignal — deriveSource() also\n  // accepts minimal duck-typed parents (per its parameter type) that may not have one.\n  // Routed through the same `dispose()` method above, not `core.dispose()` directly, so there's\n  // exactly one cleanup path regardless of what triggered it.\n  if (parent.disposalSignal instanceof AbortSignal) {\n    parent.disposalSignal.addEventListener('abort', () => source.dispose(), { once: true });\n  }\n\n  return source;\n}\n","import type { InfiniteConfig, InfiniteMeta, InfiniteSource, InfiniteSourceQuery, SearchOptions } from './types';\n\nimport { clampPositiveInt, defaultKeyOf, extractError, retry } from './_utils';\nimport { createAsyncSearchCoordinator } from './asyncSearch';\nimport { createAsyncSource } from './asyncSource';\nimport { SourcererError } from './errors';\n\n/** Creates an infinite-scroll source that appends pages on `loadMore()`. */\nexport function createInfiniteSource<T>(cfg: InfiniteConfig<T>): InfiniteSource<T> {\n  const keyOf = cfg.queryKey ?? defaultKeyOf;\n\n  // ── Mutable state ───────────────────────────────────────────────────────────\n  let limit = clampPositiveInt(cfg.limit ?? 20, 'createInfiniteSource', 'limit');\n  let search = '';\n  let currentPage = 1;\n  let loadedPages = 0;\n  let items: readonly T[] = [];\n  let total = 0;\n  let error: SourcererError | null = null;\n  let isLoadingMore = false;\n\n  // ── Cached accessors ─────────────────────────────────────────────────────────\n  let cachedCurrent: readonly T[] = [];\n  let cachedMeta: InfiniteMeta = {\n    error: null,\n    hasMore: false,\n    isLoading: false,\n    isLoadingMore: false,\n    isSearchPending: false,\n    loadedPages: 0,\n    pageSize: limit,\n    totalItems: 0,\n  };\n\n  const refreshMeta = () => {\n    cachedCurrent = items;\n    cachedMeta = {\n      error,\n      hasMore: items.length < total,\n      isLoading: base.pendingCount() > 0 && !isLoadingMore,\n      isLoadingMore,\n      isSearchPending: base.core.isScheduled,\n      loadedPages,\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<InfiniteSourceQuery>(cfg, keyOf, refreshMeta);\n  const { autoFetch, debounceMs, retryAttempts, retryDelay } = base;\n\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  // ── Core fetch ──────────────────────────────────────────────────────────────\n  const fetchPage = (targetPage: number, append: boolean): Promise<void> => {\n    const q: InfiniteSourceQuery = {\n      ...(search && { search }),\n      limit,\n      page: targetPage,\n    };\n\n    error = null;\n\n    return base.fetch(\n      q,\n      async (q, 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            if (append) {\n              items = [...items, ...result.items];\n            } else {\n              items = result.items;\n            }\n\n            total = result.total;\n            currentPage = targetPage;\n            loadedPages = append ? loadedPages + 1 : 1;\n            error = null;\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 (!append) items = [];\n\n            total = append ? total : 0;\n            error = new SourcererError(extractError(reason), {\n              cause: reason,\n              context: { kind: 'infinite', 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        } finally {\n          isLoadingMore = false;\n        }\n      },\n      () => {\n        notifyListeners();\n\n        searchCoordinator.settleIfIdle(base.pendingCount());\n      },\n    );\n  };\n\n  const doFetch = () => fetchPage(1, false);\n\n  // ── Auto-fetch + refresh interval ───────────────────────────────────────────\n  if (autoFetch) void doFetch();\n\n  base.startRefreshInterval(() => void doFetch());\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    loadMore() {\n      if (!cachedMeta.hasMore || base.pendingCount() > 0 || isLoadingMore) return Promise.resolve();\n\n      isLoadingMore = true;\n      refreshMeta();\n\n      return fetchPage(currentPage + 1, true);\n    },\n\n    get meta() {\n      return cachedMeta;\n    },\n\n    patch(changes) {\n      let changed = false;\n\n      if (changes.limit !== undefined) {\n        const next = clampPositiveInt(changes.limit, 'source.patch', 'limit');\n\n        if (next !== limit) {\n          limit = next;\n          changed = true;\n        }\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 (!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      items = [];\n      total = 0;\n      currentPage = 1;\n      loadedPages = 0;\n\n      return doFetch();\n    },\n\n    get query() {\n      return {\n        ...(search && { search }),\n        limit,\n        page: currentPage,\n      };\n    },\n\n    ready(timeout) {\n      return base.ready(timeout);\n    },\n\n    reset() {\n      searchCoordinator.cancel();\n      currentPage = 1;\n      loadedPages = 0;\n      items = [];\n      total = 0;\n      search = '';\n\n      return doFetch();\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        items = [];\n        total = 0;\n        loadedPages = 0;\n        currentPage = 1;\n\n        return doFetch();\n      }\n\n      if (q === search) return Promise.resolve();\n\n      search = q;\n      items = [];\n      total = 0;\n      loadedPages = 0;\n      currentPage = 1;\n\n      return searchCoordinator.schedule(() => void doFetch(), 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","import type { SourcererError, SourceMeta } from './types';\n\nconst clampInt = (value: number, minimum: number) => {\n  const parsed = Math.trunc(value);\n\n  if (!Number.isFinite(parsed)) {\n    return minimum;\n  }\n\n  return Math.max(minimum, parsed);\n};\n\nexport const pageCount = (total: number, limit: number) => {\n  const safeTotal = clampInt(total, 0);\n  const safeLimit = clampInt(limit, 1);\n\n  return Math.max(1, Math.ceil(safeTotal / safeLimit));\n};\n\nexport const clampPage = (page: number, pages: number) => {\n  return Math.max(1, Math.min(clampInt(page, 1), Math.max(1, pages)));\n};\n\nexport const createMeta = (state: {\n  error: SourcererError | null;\n  isLoading: boolean;\n  isSearchPending: boolean;\n  pageNumber: number;\n  pageSize: number;\n  totalItems: number;\n}): SourceMeta => {\n  const safeLimit = clampInt(state.pageSize, 1);\n  const safeTotal = clampInt(state.totalItems, 0);\n  const pages = pageCount(safeTotal, safeLimit);\n  const page = clampPage(state.pageNumber, pages);\n\n  return {\n    error: state.error,\n    isLoading: state.isLoading,\n    isSearchPending: state.isSearchPending,\n    pageCount: pages,\n    pageNumber: page,\n    pageSize: safeLimit,\n    totalItems: safeTotal,\n  };\n};\n\n/**\n * Computes the 1-based display range of items on the current page.\n * Returns `{ start: 0, end: 0 }` when there are no items.\n *\n * @example\n * ```ts\n * const { start, end } = itemRange(source.meta);\n * // \"Showing 11–20 of 50\"\n * console.log(`Showing ${start}–${end} of ${source.meta.totalItems}`);\n * ```\n */\nexport function itemRange(meta: Readonly<{ pageNumber: number; pageSize: number; totalItems: number }>): {\n  end: number;\n  start: number;\n} {\n  if (meta.totalItems === 0) return { end: 0, start: 0 };\n\n  const start = (meta.pageNumber - 1) * meta.pageSize + 1;\n\n  return {\n    end: Math.min(meta.pageNumber * meta.pageSize, meta.totalItems),\n    start,\n  };\n}\n","import type { LocalSource, LocalSourceConfig, LocalSourceQuery, SearchOptions, SourceQuery } from './types';\n\nimport { clampPositiveInt, extractError } from './_utils';\nimport { createAsyncSearchCoordinator } from './asyncSearch';\nimport { createSourceCore } from './core';\nimport { SourcererError } from './errors';\nimport { clampPage, createMeta, pageCount } from './pagination';\n\nconst DEFAULT_LIMIT = 20;\nconst DEFAULT_DEBOUNCE_MS = 300;\n\nfunction defaultSearch<T>(items: readonly T[], query: string): readonly T[] {\n  const q = query.toLowerCase();\n\n  return items.filter((item) => JSON.stringify(item).toLowerCase().includes(q));\n}\n\n/**\n * Creates an in-memory paginated source with optional async filter/sort pipelines.\n *\n * When neither `filterAsync` nor `sortAsync` are configured, all operations\n * complete synchronously — there is no loading state and `ready()` resolves immediately.\n * Provide async ops to offload heavy computation (e.g. to a Web Worker).\n *\n * @example\n * ```ts\n * // Synchronous (common case)\n * const source = createLocalSource([1, 2, 3, 4, 5], { limit: 2 });\n * await source.goTo(2);\n * console.log(source.current); // [3, 4]\n *\n * // Async pipeline (Web Worker offloading)\n * const source = createLocalSource(users, {\n *   filterAsync: (items, signal) => myWorker.filter(items, signal),\n *   sortAsync: (items, signal) => myWorker.sort(items, signal),\n * });\n * ```\n */\nexport function createLocalSource<T>(data: readonly T[], cfg: LocalSourceConfig<T> = {}): LocalSource<T> {\n  const core = createSourceCore();\n  const isAsync = cfg.filterAsync !== undefined || cfg.sortAsync !== undefined;\n  const debounceMs = cfg.debounceMs ?? DEFAULT_DEBOUNCE_MS;\n\n  let allData: readonly T[] = cfg.initialData ?? data;\n  let search = '';\n  let filter = cfg.filter;\n  let sort = cfg.sort;\n  let limit = clampPositiveInt(cfg.limit ?? DEFAULT_LIMIT, 'createLocalSource', 'limit');\n  let page = 1;\n  let processed: readonly T[] = [];\n  let isLoading = false;\n  let isSearchPending = false;\n  let error: SourcererError | null = null;\n  let asyncController: AbortController | null = null;\n\n  const commit = () => core.notify();\n  // Shared debounced-search promise coordinator — the same one remote/cursor/infinite use,\n  // instead of a fourth hand-rolled copy of \"pendingSearch/resolvePendingSearch\" bookkeeping.\n  const searchCoordinator = createAsyncSearchCoordinator(core, commit);\n\n  // ── Sync pipeline (used when no async ops) ──────────────────────────────────\n  const runSyncPipeline = (): readonly T[] => {\n    let result: readonly T[] = allData;\n\n    if (search) result = (cfg.searchFn ?? defaultSearch)(result, search);\n\n    if (filter) result = result.filter(filter);\n\n    if (sort) result = [...result].sort(sort);\n\n    return result;\n  };\n\n  const recompute = () => {\n    processed = runSyncPipeline();\n\n    const pages = pageCount(processed.length, limit);\n\n    page = clampPage(page, pages);\n  };\n\n  // ── Async pipeline ──────────────────────────────────────────────────────────\n  const runAsyncPipeline = async (): Promise<void> => {\n    asyncController?.abort();\n\n    const controller = new AbortController();\n\n    asyncController = controller;\n    isLoading = true;\n    error = null;\n    commit();\n\n    try {\n      let result: readonly T[] = allData;\n\n      if (search) result = (cfg.searchFn ?? defaultSearch)(result, search);\n\n      if (filter) result = result.filter(filter);\n\n      if (cfg.filterAsync && !controller.signal.aborted) {\n        result = await cfg.filterAsync(result, controller.signal);\n      }\n\n      if (sort) result = [...result].sort(sort);\n\n      if (cfg.sortAsync && !controller.signal.aborted) {\n        result = await cfg.sortAsync(result, controller.signal);\n      }\n\n      if (controller.signal.aborted) return;\n\n      processed = result;\n      isLoading = false;\n      isSearchPending = false;\n\n      const pages = pageCount(processed.length, limit);\n\n      page = clampPage(page, pages);\n    } catch (reason: unknown) {\n      if (!controller.signal.aborted) {\n        isLoading = false;\n        isSearchPending = false;\n        error = new SourcererError(extractError(reason), { cause: reason });\n      }\n    } finally {\n      if (asyncController === controller) asyncController = null;\n    }\n\n    commit();\n    // Local source never has more than one pipeline run in flight — settling always means idle.\n    searchCoordinator.settleIfIdle(0);\n  };\n\n  // Internal flush — not part of public API\n  const flushInternal = (): Promise<void> => {\n    if (isAsync) return runAsyncPipeline();\n\n    isSearchPending = false;\n    recompute();\n    commit();\n    searchCoordinator.settleIfIdle(0);\n\n    return Promise.resolve();\n  };\n\n  // ── Initial state ───────────────────────────────────────────────────────────\n  if (isAsync) {\n    // Async: seed with a sync pass so `current` isn't empty while the async pass runs.\n    processed = runSyncPipeline();\n    void runAsyncPipeline();\n  } else {\n    recompute();\n  }\n\n  const source: LocalSource<T> = {\n    get current() {\n      const start = (page - 1) * limit;\n\n      return processed.slice(start, start + limit);\n    },\n\n    get disposalSignal() {\n      return core.disposalSignal;\n    },\n\n    dispose() {\n      if (core.isDisposed) return;\n\n      asyncController?.abort();\n      asyncController = null;\n      searchCoordinator.cancel();\n      searchCoordinator.dispose();\n      core.dispose();\n    },\n\n    get disposed() {\n      return core.isDisposed;\n    },\n\n    goTo(n) {\n      const pages = pageCount(processed.length, limit);\n      const clamped = clampPage(n, pages);\n\n      if (clamped === page) return Promise.resolve();\n\n      page = clamped;\n      commit();\n\n      return Promise.resolve();\n    },\n\n    goToLast() {\n      return source.goTo(pageCount(processed.length, limit));\n    },\n\n    get meta() {\n      return createMeta({\n        error,\n        isLoading,\n        isSearchPending,\n        pageNumber: page,\n        pageSize: limit,\n        totalItems: processed.length,\n      });\n    },\n\n    next() {\n      return source.goTo(page + 1);\n    },\n\n    patch(changes: LocalSourceQuery<T>) {\n      let changed = false;\n\n      if (changes.limit !== undefined) {\n        const next = clampPositiveInt(changes.limit, 'source.patch', '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      // `|| 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 || core.isScheduled)) {\n        search = changes.search ?? '';\n        changed = true;\n      }\n\n      if (changes.page !== undefined) {\n        const next = clampPage(changes.page, pageCount(processed.length, limit));\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 recompute — cancel any debounced search()\n      // still pending so it doesn't fire a second, redundant recompute afterwards.\n      searchCoordinator.cancel();\n\n      // Reset page only when non-page query fields changed without an 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 flushInternal();\n    },\n\n    prev() {\n      return source.goTo(page - 1);\n    },\n\n    get query(): SourceQuery {\n      return {\n        limit,\n        page,\n        ...(search && { search }),\n      };\n    },\n\n    ready(timeout?: number) {\n      return core.ready(() => !isLoading && !core.isScheduled, timeout);\n    },\n\n    reset() {\n      searchCoordinator.cancel();\n      isSearchPending = false;\n      search = '';\n      filter = cfg.filter;\n      sort = cfg.sort;\n      page = 1;\n\n      return flushInternal();\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 recompute already happened.\n        if (q === search && !core.isScheduled) return Promise.resolve();\n\n        searchCoordinator.cancel();\n        isSearchPending = false;\n        search = q;\n        page = 1;\n\n        return flushInternal();\n      }\n\n      if (q === search) return Promise.resolve();\n\n      search = q;\n      page = 1;\n      isSearchPending = true;\n\n      return searchCoordinator.schedule(() => {\n        isSearchPending = false;\n        void flushInternal();\n      }, debounceMs);\n    },\n\n    setData(d) {\n      allData = d;\n      page = 1;\n\n      return flushInternal();\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","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. If every parent exposes a\n * `disposalSignal` (the standard `ReactiveSource` shape does), the merge auto-disposes once\n * every parent has disposed — mirroring `deriveSource()`'s single-parent auto-dispose, scaled\n * to N parents. If any parent lacks `disposalSignal` (a minimal duck-typed source), auto-dispose\n * doesn't activate — call `dispose()` yourself.\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    readonly disposalSignal?: AbortSignal;\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  // Mirrors deriveSource()'s parent-lifetime tracking, scaled to N parents: once every\n  // parent has disposed there's nothing left this merge could ever reflect, so it disposes\n  // itself too instead of staying alive holding now-permanently-stale combined state.\n  // Only tracked when every source actually exposes a disposalSignal — mergeSource() also\n  // accepts minimal duck-typed sources (per its parameter type) that may not have one.\n  // Routed through `source.dispose()` above, not `core.dispose()` directly, so there's exactly\n  // one cleanup path (including unsubscribing from parents) regardless of what triggered it.\n  const disposalSignals = sources\n    .map((s) => s.disposalSignal)\n    .filter((s): s is AbortSignal => s instanceof AbortSignal);\n\n  if (disposalSignals.length === sources.length && disposalSignals.length > 0) {\n    let pendingCount = disposalSignals.filter((s) => !s.aborted).length;\n\n    if (pendingCount === 0) {\n      // Every parent was already disposed before mergeSource() was even called.\n      source.dispose();\n    } else {\n      for (const signal of disposalSignals) {\n        if (signal.aborted) continue;\n\n        signal.addEventListener(\n          'abort',\n          () => {\n            pendingCount--;\n\n            if (pendingCount === 0) source.dispose();\n          },\n          { once: true },\n        );\n      }\n    }\n  }\n\n  return source;\n}\n","import type { RemoteConfig, RemoteSource, RemoteSourceQuery, SearchOptions } from './types';\n\nimport { clampPositiveInt, 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 = clampPositiveInt(cfg.limit ?? 20, 'createRemoteSource', 'limit');\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 =\n        total > 0 ? clampPage(target, pageCount(total, limit)) : clampPositiveInt(target, 'source.goTo', '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 = clampPositiveInt(changes.limit, 'source.patch', '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\n            ? clampPage(changes.page, pageCount(total, limit))\n            : clampPositiveInt(changes.page, 'source.patch', '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","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","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","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":"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"}
+{"version":3,"file":"sourcerer.iife.js","names":[],"sources":["../src/_dev.ts","../src/requestController.ts","../src/sourceStore.ts","../src/asyncSource.ts","../src/pagination.ts","../src/cursorSource.ts","../src/infiniteSource.ts","../src/localSource.ts","../src/pageSource.ts"],"sourcesContent":["const isDev = !(globalThis as { __SOURCERER_PROD__?: boolean }).__SOURCERER_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/sourcerer] ${msg}`);\n}\n\n/** @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() call. */\nexport function devOnly(fn: () => void): void {\n  if (isDev) fn();\n}\n","export type RequestHandle = Readonly<{\n  finish(): void;\n  isCurrent(): boolean;\n  signal: AbortSignal;\n}>;\n\nexport type RequestController = Readonly<{\n  begin(): RequestHandle;\n  dispose(): void;\n}>;\n\n/** A source owns one active request: newer query state always supersedes older work. */\nexport function createRequestController(): RequestController {\n  let active: AbortController | undefined;\n  let sequence = 0;\n\n  return {\n    begin() {\n      active?.abort();\n\n      const controller = new AbortController();\n      const requestSequence = ++sequence;\n\n      active = controller;\n\n      return {\n        finish() {\n          if (requestSequence === sequence) active = undefined;\n        },\n\n        isCurrent() {\n          return requestSequence === sequence;\n        },\n\n        signal: controller.signal,\n      };\n    },\n\n    dispose() {\n      active?.abort();\n      active = undefined;\n      sequence++;\n    },\n  };\n}\n\nexport function toError(reason: unknown): Error {\n  if (reason instanceof Error) return reason;\n\n  return new Error(typeof reason === 'string' && reason.length > 0 ? reason : 'Source request failed');\n}\n","import type { Disposable } from './types';\n\ntype SourceStore<T> = Disposable & {\n  set(value: T): void;\n  subscribe(listener: (value: T) => void): () => void;\n  readonly value: T;\n};\n\n/** Store commits source state before notifying; observer failures cannot rewrite committed state. */\nexport function createSourceStore<T>(initialValue: T): SourceStore<T> {\n  const controller = new AbortController();\n  const listeners = new Set<(value: T) => void>();\n  let disposed = false;\n  let value = initialValue;\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    listeners.clear();\n    controller.abort();\n  };\n\n  return {\n    get disposalSignal() {\n      return controller.signal;\n    },\n\n    dispose,\n\n    get disposed() {\n      return disposed;\n    },\n\n    set(nextValue) {\n      if (disposed) return;\n\n      value = nextValue;\n\n      for (const listener of listeners) {\n        try {\n          listener(value);\n        } catch (error) {\n          queueMicrotask(() => {\n            throw error;\n          });\n        }\n      }\n    },\n\n    subscribe(listener) {\n      if (disposed) return () => {};\n\n      listeners.add(listener);\n\n      return () => listeners.delete(listener);\n    },\n\n    [Symbol.dispose]: dispose,\n\n    get value() {\n      return value;\n    },\n  };\n}\n","import type { AnyPagination, SourceSnapshot } from './types';\n\nimport { createRequestController, toError } from './requestController';\nimport { createSourceStore } from './sourceStore';\n\ntype AsyncSource<T, TQuery, TPagination extends AnyPagination> = Readonly<{\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  fetch<TResult>(options: {\n    failure(previous: SourceSnapshot<T, TQuery, TPagination>, error: Error): SourceSnapshot<T, TQuery, TPagination>;\n    load(signal: AbortSignal): Promise<TResult>;\n    pending(previous: SourceSnapshot<T, TQuery, TPagination>): SourceSnapshot<T, TQuery, TPagination>;\n    success(result: TResult): SourceSnapshot<T, TQuery, TPagination>;\n  }): Promise<void>;\n  readonly snapshot: SourceSnapshot<T, TQuery, TPagination>;\n  subscribe(listener: (snapshot: SourceSnapshot<T, TQuery, TPagination>) => void): () => void;\n}>;\n\n/** Request failures and observer failures stay separate so observers cannot corrupt source state. */\nexport function createAsyncSource<T, TQuery, TPagination extends AnyPagination>(\n  initial: SourceSnapshot<T, TQuery, TPagination>,\n): AsyncSource<T, TQuery, TPagination> {\n  const store = createSourceStore(initial);\n  const requests = createRequestController();\n\n  return {\n    get disposalSignal() {\n      return store.disposalSignal;\n    },\n\n    dispose() {\n      requests.dispose();\n      store.dispose();\n    },\n\n    get disposed() {\n      return store.disposed;\n    },\n\n    async fetch(options) {\n      if (store.disposed) return;\n\n      const request = requests.begin();\n      const previous = store.value;\n\n      store.set(options.pending(previous));\n\n      let next: SourceSnapshot<T, TQuery, TPagination>;\n\n      try {\n        next = options.success(await options.load(request.signal));\n      } catch (reason: unknown) {\n        if (!request.isCurrent() || store.disposed) return;\n\n        const error = toError(reason);\n\n        store.set(options.failure(previous, error));\n        throw error;\n      } finally {\n        request.finish();\n      }\n\n      if (!request.isCurrent() || store.disposed) return;\n\n      store.set(next);\n    },\n\n    get snapshot() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n  };\n}\n","import type { PagePagination } from './types';\n\nexport function positiveInteger(value: number, name: string): number {\n  if (!Number.isInteger(value) || value < 1) throw new RangeError(`${name} must be a positive integer`);\n\n  return value;\n}\n\nexport function totalItems(value: number): number {\n  if (!Number.isInteger(value) || value < 0) throw new RangeError('Source loader total must be a non-negative integer');\n\n  return value;\n}\n\nexport function createPagePagination(index: number, size: number, total: number): PagePagination {\n  const count = Math.max(1, Math.ceil(total / size));\n  const safeIndex = Math.min(index, count);\n\n  return {\n    count,\n    hasNext: safeIndex < count,\n    hasPrevious: safeIndex > 1,\n    index: safeIndex,\n    kind: 'page',\n    size,\n    total,\n  };\n}\n\nexport function sameQuery<T extends Record<string, unknown>>(left: T, right: T): boolean {\n  const keys = new Set([...Object.keys(left), ...Object.keys(right)]);\n\n  return [...keys].every((key) => Object.is(left[key], right[key]));\n}\n","import type { CursorPagination, CursorQuery, CursorQueryPatch, CursorSource, CursorSourceConfig } from './types';\n\nimport { warn } from './_dev';\nimport { createAsyncSource } from './asyncSource';\nimport { positiveInteger, sameQuery, totalItems } from './pagination';\n\nconst createPagination = <TCursor>(result?: {\n  nextCursor?: TCursor;\n  previousCursor?: TCursor;\n  total?: number;\n}): CursorPagination<TCursor> => ({\n  hasNext: result?.nextCursor !== undefined,\n  hasPrevious: result?.previousCursor !== undefined,\n  kind: 'cursor',\n  ...(result?.nextCursor !== undefined && { nextCursor: result.nextCursor }),\n  ...(result?.previousCursor !== undefined && { previousCursor: result.previousCursor }),\n  ...(result?.total !== undefined && { total: totalItems(result.total) }),\n});\n\nconst normalizeQuery = <TCursor>(\n  current: CursorQuery<TCursor>,\n  patch: CursorQueryPatch<TCursor> = {},\n): CursorQuery<TCursor> => {\n  if (patch.after !== undefined && patch.before !== undefined) {\n    throw new RangeError('Cursor query cannot include both after and before');\n  }\n\n  const resetsCursor = patch.pageSize !== undefined || patch.search !== undefined;\n  const after = resetsCursor || 'before' in patch ? undefined : 'after' in patch ? patch.after : current.after;\n  const before = resetsCursor || 'after' in patch ? undefined : 'before' in patch ? patch.before : current.before;\n\n  return {\n    ...(after !== undefined && { after }),\n    ...(before !== undefined && { before }),\n    pageSize: positiveInteger(patch.pageSize ?? current.pageSize, 'pageSize'),\n    search: patch.search ?? current.search,\n  };\n};\n\n/** Cursor sources retain loaded cursors while pendingQuery records newer navigation. */\nexport function createCursorSource<T, TCursor = string>(\n  config: CursorSourceConfig<T, TCursor>,\n): CursorSource<T, TCursor> {\n  const initialQuery: CursorQuery<TCursor> = { pageSize: 20, search: '' };\n  let requestedQuery = normalizeQuery(initialQuery, config.initialQuery);\n  const asyncSource = createAsyncSource<T, CursorQuery<TCursor>, CursorPagination<TCursor>>({\n    data: [],\n    error: null,\n    isFetching: false,\n    pagination: createPagination(),\n    query: requestedQuery,\n  });\n\n  const fetch = (query: CursorQuery<TCursor>): Promise<void> =>\n    asyncSource.fetch({\n      failure: (previous, error) => ({ ...previous, error, isFetching: false, pendingQuery: undefined }),\n      load: (signal) => config.load({ query, signal }),\n      pending: (previous) => ({ ...previous, error: null, isFetching: true, pendingQuery: query }),\n      success: (result) => ({\n        data: result.data,\n        error: null,\n        isFetching: false,\n        pagination: createPagination(result),\n        query,\n      }),\n    });\n\n  const reload = (): Promise<void> => fetch(requestedQuery);\n\n  const setQuery = async (patch: CursorQueryPatch<TCursor>): Promise<void> => {\n    const current = asyncSource.snapshot.pendingQuery ?? asyncSource.snapshot.query;\n    const next = normalizeQuery(current, patch);\n\n    if (sameQuery(next, requestedQuery)) return;\n\n    requestedQuery = next;\n    await fetch(next);\n  };\n\n  const source: CursorSource<T, TCursor> = {\n    get disposalSignal() {\n      return asyncSource.disposalSignal;\n    },\n\n    dispose: asyncSource.dispose,\n\n    get disposed() {\n      return asyncSource.disposed;\n    },\n\n    page: {\n      next() {\n        const cursor = asyncSource.snapshot.pagination.nextCursor;\n\n        return asyncSource.snapshot.isFetching || cursor === undefined\n          ? Promise.resolve()\n          : setQuery({ after: cursor });\n      },\n\n      previous() {\n        const cursor = asyncSource.snapshot.pagination.previousCursor;\n\n        return asyncSource.snapshot.isFetching || cursor === undefined\n          ? Promise.resolve()\n          : setQuery({ before: cursor });\n      },\n    },\n\n    reload,\n    setQuery,\n\n    get snapshot() {\n      return asyncSource.snapshot;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  if (config.autoStart !== false)\n    void reload().catch(() => warn('Initial load failed. Inspect source.snapshot.error.'));\n\n  return source;\n}\n","import type {\n  InfinitePagination,\n  InfiniteQuery,\n  InfiniteQueryPatch,\n  InfiniteSource,\n  InfiniteSourceConfig,\n} from './types';\n\nimport { warn } from './_dev';\nimport { createAsyncSource } from './asyncSource';\nimport { positiveInteger, sameQuery, totalItems } from './pagination';\n\nconst createPagination = (loaded: number, total: number, isLoadingMore: boolean): InfinitePagination => ({\n  hasMore: loaded < total,\n  isLoadingMore,\n  kind: 'infinite',\n  loaded,\n  total,\n});\n\nconst normalizeQuery = (current: InfiniteQuery, patch: InfiniteQueryPatch = {}): InfiniteQuery => ({\n  pageSize: positiveInteger(patch.pageSize ?? current.pageSize, 'pageSize'),\n  search: patch.search ?? current.search,\n});\n\n/** Infinite sources preserve loaded collection state while a pending query replaces it. */\nexport function createInfiniteSource<T>(config: InfiniteSourceConfig<T>): InfiniteSource<T> {\n  const initialQuery: InfiniteQuery = { pageSize: 20, search: '' };\n  let requestedQuery = normalizeQuery(initialQuery, config.initialQuery);\n  let nextPage = 1;\n  const asyncSource = createAsyncSource<T, InfiniteQuery, InfinitePagination>({\n    data: [],\n    error: null,\n    isFetching: false,\n    pagination: createPagination(0, 0, false),\n    query: requestedQuery,\n  });\n\n  const fetch = (query: InfiniteQuery, page: number, append: boolean): Promise<void> => {\n    const loadedData = asyncSource.snapshot.data;\n\n    return asyncSource.fetch({\n      failure: (previous, error) => ({ ...previous, error, isFetching: false, pendingQuery: undefined }),\n      load: (signal) => config.load({ query: { ...query, page, pageSize: query.pageSize }, signal }),\n      pending: (previous) => ({\n        ...previous,\n        error: null,\n        isFetching: true,\n        pagination: createPagination(previous.data.length, previous.pagination.total, append),\n        pendingQuery: query,\n      }),\n      success: (result) => {\n        const total = totalItems(result.total);\n        const data = append ? [...loadedData, ...result.data] : result.data;\n\n        nextPage = page + 1;\n\n        return {\n          data,\n          error: null,\n          isFetching: false,\n          pagination: createPagination(data.length, total, false),\n          query,\n        };\n      },\n    });\n  };\n\n  const reload = (): Promise<void> => {\n    nextPage = 1;\n\n    return fetch(requestedQuery, 1, false);\n  };\n\n  const setQuery = async (patch: InfiniteQueryPatch): Promise<void> => {\n    const current = asyncSource.snapshot.pendingQuery ?? asyncSource.snapshot.query;\n    const next = normalizeQuery(current, patch);\n\n    if (sameQuery(next, requestedQuery)) return;\n\n    requestedQuery = next;\n    nextPage = 1;\n    await fetch(next, 1, false);\n  };\n\n  const source: InfiniteSource<T> = {\n    get disposalSignal() {\n      return asyncSource.disposalSignal;\n    },\n\n    dispose: asyncSource.dispose,\n\n    get disposed() {\n      return asyncSource.disposed;\n    },\n\n    loadMore() {\n      const { isFetching, pagination } = asyncSource.snapshot;\n\n      return isFetching || (asyncSource.snapshot.data.length > 0 && !pagination.hasMore)\n        ? Promise.resolve()\n        : fetch(requestedQuery, nextPage, true);\n    },\n\n    reload,\n    setQuery,\n\n    get snapshot() {\n      return asyncSource.snapshot;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  if (config.autoStart !== false)\n    void reload().catch(() => warn('Initial load failed. Inspect source.snapshot.error.'));\n\n  return source;\n}\n","import type {\n  LocalQuery,\n  LocalQueryPatch,\n  LocalSource,\n  LocalSourceConfig,\n  PagePagination,\n  SourceSnapshot,\n} from './types';\n\nimport { createPagePagination, positiveInteger, sameQuery, totalItems } from './pagination';\nimport { createSourceStore } from './sourceStore';\n\nconst normalizeQuery = (current: LocalQuery, patch: LocalQueryPatch = {}, maxPage?: number): LocalQuery => {\n  const page = patch.page ?? current.page;\n  const pageSize = patch.pageSize ?? current.pageSize;\n  const search = patch.search ?? current.search;\n  const resetsPage = patch.pageSize !== undefined || patch.search !== undefined;\n\n  const requestedPage = patch.page ?? (resetsPage ? 1 : page);\n\n  return {\n    page:\n      maxPage === undefined\n        ? positiveInteger(requestedPage, 'page')\n        : Math.min(positiveInteger(requestedPage, 'page'), maxPage),\n    pageSize: positiveInteger(pageSize, 'pageSize'),\n    search,\n  };\n};\n\n/** Local sources own only search and pagination; callers prepare filtering and ranking. */\nexport function createLocalSource<T>(data: readonly T[], config: LocalSourceConfig<T> = {}): LocalSource<T> {\n  let allData = data;\n  let query = normalizeQuery({ page: 1, pageSize: 20, search: '' }, config.initialQuery);\n\n  const buildSnapshot = (): SourceSnapshot<T, LocalQuery, PagePagination> => {\n    const matched =\n      query.search.length > 0 && config.match ? allData.filter((item) => config.match!(item, query.search)) : allData;\n    const total = totalItems(matched.length);\n    const pagination = createPagePagination(query.page, query.pageSize, total);\n    const start = (pagination.index - 1) * pagination.size;\n\n    query = { ...query, page: pagination.index };\n\n    return {\n      data: matched.slice(start, start + pagination.size),\n      error: null,\n      isFetching: false,\n      pagination,\n      query,\n    };\n  };\n\n  const store = createSourceStore(buildSnapshot());\n\n  const commit = (): boolean => {\n    const next = buildSnapshot();\n\n    if (\n      sameQuery(next.query, store.value.query) &&\n      next.data === store.value.data &&\n      next.pagination === store.value.pagination\n    ) {\n      return false;\n    }\n\n    store.set(next);\n\n    return true;\n  };\n\n  const setQuery = (patch: LocalQueryPatch): boolean => {\n    const next = normalizeQuery(query, patch, store.value.pagination.count);\n\n    if (sameQuery(next, query)) return false;\n\n    query = next;\n\n    return commit();\n  };\n\n  const source: LocalSource<T> = {\n    get disposalSignal() {\n      return store.disposalSignal;\n    },\n\n    dispose: store.dispose,\n\n    get disposed() {\n      return store.disposed;\n    },\n\n    page: {\n      go(index) {\n        return setQuery({ page: index });\n      },\n\n      last() {\n        return setQuery({ page: store.value.pagination.count });\n      },\n\n      next() {\n        return store.value.pagination.hasNext && setQuery({ page: store.value.pagination.index + 1 });\n      },\n\n      previous() {\n        return store.value.pagination.hasPrevious && setQuery({ page: store.value.pagination.index - 1 });\n      },\n    },\n\n    setData(nextData) {\n      if (nextData === allData) return false;\n\n      allData = nextData;\n\n      return commit();\n    },\n\n    setQuery,\n\n    get snapshot() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n","import type { PagePagination, PageQuery, PageQueryPatch, PageSource, PageSourceConfig } from './types';\n\nimport { warn } from './_dev';\nimport { createAsyncSource } from './asyncSource';\nimport { createPagePagination, positiveInteger, sameQuery, totalItems } from './pagination';\n\nconst normalizeQuery = <TFilter, TSort>(\n  current: PageQuery<TFilter, TSort>,\n  patch: PageQueryPatch<TFilter, TSort> = {},\n  maxPage?: number,\n): PageQuery<TFilter, TSort> => {\n  const page = patch.page ?? current.page;\n  const pageSize = patch.pageSize ?? current.pageSize;\n  const search = patch.search ?? current.search;\n  const resetsPage = 'filter' in patch || patch.pageSize !== undefined || patch.search !== undefined || 'sort' in patch;\n\n  const requestedPage = patch.page ?? (resetsPage ? 1 : page);\n\n  return {\n    ...('filter' in patch\n      ? patch.filter !== undefined && { filter: patch.filter }\n      : current.filter !== undefined && { filter: current.filter }),\n    ...('sort' in patch\n      ? patch.sort !== undefined && { sort: patch.sort }\n      : current.sort !== undefined && { sort: current.sort }),\n    page:\n      maxPage === undefined\n        ? positiveInteger(requestedPage, 'page')\n        : Math.min(positiveInteger(requestedPage, 'page'), maxPage),\n    pageSize: positiveInteger(pageSize, 'pageSize'),\n    search,\n  };\n};\n\n/** Page sources retain loaded state while pendingQuery records newer work. */\nexport function createPageSource<T, TFilter = unknown, TSort = unknown>(\n  config: PageSourceConfig<T, TFilter, TSort>,\n): PageSource<T, TFilter, TSort> {\n  const initialQuery: PageQuery<TFilter, TSort> = {\n    page: 1,\n    pageSize: 20,\n    search: '',\n  };\n  let requestedQuery = normalizeQuery(initialQuery, config.initialQuery);\n  const asyncSource = createAsyncSource<T, PageQuery<TFilter, TSort>, PagePagination>({\n    data: [],\n    error: null,\n    isFetching: false,\n    pagination: createPagePagination(requestedQuery.page, requestedQuery.pageSize, 0),\n    query: requestedQuery,\n  });\n\n  const fetch = (query: PageQuery<TFilter, TSort>): Promise<void> =>\n    asyncSource.fetch({\n      failure: (previous, error) => ({ ...previous, error, isFetching: false, pendingQuery: undefined }),\n      load: (signal) => config.load({ query, signal }),\n      pending: (previous) => ({ ...previous, error: null, isFetching: true, pendingQuery: query }),\n      success: (result) => {\n        const total = totalItems(result.total);\n        const pagination = createPagePagination(query.page, query.pageSize, total);\n        const loadedQuery = { ...query, page: pagination.index };\n\n        requestedQuery = loadedQuery;\n\n        return {\n          data: result.data,\n          error: null,\n          isFetching: false,\n          pagination,\n          query: loadedQuery,\n        };\n      },\n    });\n\n  const reload = (): Promise<void> => fetch(requestedQuery);\n\n  const setQuery = async (patch: PageQueryPatch<TFilter, TSort>): Promise<void> => {\n    const current = asyncSource.snapshot.pendingQuery ?? asyncSource.snapshot.query;\n    const next = normalizeQuery(\n      current,\n      patch,\n      asyncSource.snapshot.pagination.total > 0 ? asyncSource.snapshot.pagination.count : undefined,\n    );\n\n    if (sameQuery(next, requestedQuery)) return;\n\n    requestedQuery = next;\n    await fetch(next);\n  };\n\n  const source: PageSource<T, TFilter, TSort> = {\n    get disposalSignal() {\n      return asyncSource.disposalSignal;\n    },\n\n    dispose: asyncSource.dispose,\n\n    get disposed() {\n      return asyncSource.disposed;\n    },\n\n    page: {\n      go(index) {\n        return asyncSource.snapshot.isFetching ? Promise.resolve() : setQuery({ page: index });\n      },\n\n      last() {\n        return asyncSource.snapshot.isFetching\n          ? Promise.resolve()\n          : setQuery({ page: asyncSource.snapshot.pagination.count });\n      },\n\n      next() {\n        return asyncSource.snapshot.isFetching || !asyncSource.snapshot.pagination.hasNext\n          ? Promise.resolve()\n          : setQuery({ page: asyncSource.snapshot.pagination.index + 1 });\n      },\n\n      previous() {\n        return asyncSource.snapshot.isFetching || !asyncSource.snapshot.pagination.hasPrevious\n          ? Promise.resolve()\n          : setQuery({ page: asyncSource.snapshot.pagination.index - 1 });\n      },\n    },\n\n    reload,\n    setQuery,\n\n    get snapshot() {\n      return asyncSource.snapshot;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  if (config.autoStart !== false)\n    void reload().catch(() => warn('Initial load failed. Inspect source.snapshot.error.'));\n\n  return source;\n}\n"],"mappings":"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"}

package/dist/sourcerer.js

@@ -1,2 +1,2 @@
-import{backoff as e,hash as t,retry as n}from"@vielzeug/arsenal";var r=!globalThis.__SOURCERER_PROD__;function i(e){r&&console.warn(`[@vielzeug/sourcerer] ${e}`)}function a(e){r&&e()}var o=t,s=e=>e instanceof Error?e.message:typeof e==`string`&&e.length>0?e:`Request failed`,c=t=>e(t);function l(e,t=200){return e.replace(/\p{C}/gu,`?`).slice(0,t)}var u=new Set;function d(e,t,n){let r=Number.isFinite(e)?Math.max(1,Math.trunc(e)):1;if(!Number.isFinite(e)||e<1){let o=`${t}:${n}`;u.has(o)||(u.add(o),a(()=>i(`${t}: ${n} ${e} is invalid — clamped to ${r}. Must be a positive integer.`)))}return r}var f=class e extends Error{#e;constructor(e,t={}){super(e,t.cause===void 0?void 0:{cause:t.cause}),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype),this.#e=t}get attempt(){return this.#e.attempt??0}get context(){return this.#e.context}static is(t){return t instanceof e}},p=class extends f{timeoutMs;constructor(e){super(`Source.ready() timed out after ${e}ms`),this.timeoutMs=e}},m=class extends f{constructor(){super(`Source disposed while waiting for ready()`)}},h=e=>{let t={...e.search&&{search:e.search},limit:String(e.limit),page:String(e.page)},n=e;return n.filter!==void 0&&(t.filter=JSON.stringify(n.filter)),n.sort!==void 0&&(t.sort=JSON.stringify(n.sort)),t},g=(e,t={})=>{let n=e instanceof URLSearchParams?Object.fromEntries(e.entries()):e,{defaultLimit:r=20,strict:o=!1}=t,s=(e,t,n)=>{if(t===void 0)return n;let r=Array.isArray(t)?t[0]:t,o=Number(r);return Number.isInteger(o)&&o>0?o:(a(()=>i(`decodeQuery: ${e} "${l(r,80)}" is not a positive integer — using ${n}.`)),n)},c=(e,t)=>{if(t===void 0)return;let n=Array.isArray(t)?t[0]:t;try{return JSON.parse(n)}catch{if(o)throw new f(`Invalid query param "${e}": ${l(n,80)}`);return}},u=n.limit,d=n.page,p=n.search,m=n.filter,h=n.sort,g=m===void 0?void 0:c(`filter`,m),_=h===void 0?void 0:c(`sort`,h);return{...g!==void 0&&{filter:g},..._!==void 0&&{sort:_},...p!==void 0&&{search:Array.isArray(p)?p[0]:p},limit:s(`limit`,u,r),page:s(`page`,d,1)}};function _(e,t){let n=null,r=()=>{n&&=(n(),null)};return{cancel(){e.cancelTimer(),r()},dispose(){r()},schedule(i,a){r();let o=new Promise(e=>{n=e});return e.schedule(i,a),t(),o},settleIfIdle(e){e===0&&r()}}}function v(e){let t=new Set,n=new Set,r=new AbortController,i,a=!1;return{cancelTimer(){i&&=(clearTimeout(i),void 0)},get disposalSignal(){return r.signal},dispose(){i&&=(clearTimeout(i),void 0);for(let e of n)e.timeoutId!==void 0&&clearTimeout(e.timeoutId),e.reject(new m);n.clear(),t.clear(),a=!0,r.abort()},flush(e){return i?(clearTimeout(i),i=void 0,e()):Promise.resolve()},get isDisposed(){return a},get isScheduled(){return i!==void 0},notify(r){if(!a){(r??e?.onBeforeNotify)?.();for(let e of t)e();for(let e of n)e.check()}},ready(e,t){return a?Promise.reject(new m):e()?Promise.resolve():new Promise((r,i)=>{let a={check:()=>{e()&&(a.timeoutId!==void 0&&clearTimeout(a.timeoutId),n.delete(a),r())},reject:i};t!==void 0&&(a.timeoutId=setTimeout(()=>{n.delete(a),i(new p(t))},t)),n.add(a)})},schedule(e,t){a||(i&&clearTimeout(i),i=setTimeout(()=>{i=void 0,e()},t))},subscribe(e){return a?()=>{}:(t.add(e),()=>t.delete(e))}}}function y(e){let t=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}}}function b(e,t=o,n){let r=v({onBeforeNotify:n}),i=y(t),a=e.debounceMs??300,s=e.retry?.attempts??0,l=e.retry?.delay??c,u=e.autoFetch!==!1,d,f=()=>{r.isDisposed||(d!==void 0&&(clearInterval(d),d=void 0),i.dispose(),r.dispose())};return{autoFetch:u,core:r,debounceMs:a,get disposalSignal(){return r.disposalSignal},dispose:f,get disposed(){return r.isDisposed},fetch(e,t,n){return i.run(e,t,n)},pendingCount:()=>i.pendingCount,ready(e){return r.ready(()=>i.pendingCount===0&&!r.isScheduled,e)},retryAttempts:s,retryDelay:l,startRefreshInterval(t){e.refreshInterval!==void 0&&e.refreshInterval>0&&(d=setInterval(()=>{r.isDisposed||t()},e.refreshInterval))},[Symbol.dispose]:f}}function x(e){let t=e.queryKey??o,r=d(e.limit??20,`createCursorSource`,`limit`),i=``,a,c,l,u,p=[],m=0,h=null,g=[],v={error:null,hasNextPage:!1,hasPrevPage:!1,isLoading:!1,isSearchPending:!1,pageSize:r,totalItems:0},y=()=>{g=p,v={error:h,hasNextPage:l!==void 0,hasPrevPage:u!==void 0,isLoading:x.pendingCount()>0,isSearchPending:x.core.isScheduled,pageSize:r,totalItems:m}},x=b(e,t,y),{autoFetch:S,debounceMs:C,retryAttempts:w,retryDelay:T}=x;y();let E=()=>{x.disposed||x.core.notify()},D=_(x.core,E),O=()=>({...a!==void 0&&{after:a},...c!==void 0&&{before:c},...i&&{search:i},limit:r}),k=t=>(h=null,x.fetch(t,async(t,r,i)=>{let a=Date.now();try{let o=await n(n=>e.fetch(t,n),{delay:T,signal:r,times:w+1});i()&&(p=o.items,m=o.total??o.items.length,l=o.nextCursor,u=o.prevCursor,h=null,e.onFetch?.({durationMs:Date.now()-a,query:t,status:`success`}))}catch(n){if(r.aborted)return;i()&&(p=[],m=0,l=void 0,u=void 0,h=new f(s(n),{cause:n,context:{kind:`cursor`,limit:t.limit,...t.search&&{search:t.search}}}),e.onFetch?.({durationMs:Date.now()-a,error:h,query:t,status:`error`}))}},()=>{E(),D.settleIfIdle(x.pendingCount())})),A=()=>k(O());return S&&A(),x.startRefreshInterval(()=>void A()),{get current(){return g},get disposalSignal(){return x.disposalSignal},dispose:()=>{D.cancel(),D.dispose(),x.dispose()},get disposed(){return x.disposed},get meta(){return v},next(){return l?(a=l,c=void 0,A()):Promise.resolve()},patch(e){let t=!1;if(e.limit!==void 0){let n=d(e.limit,`source.patch`,`limit`);n!==r&&(r=n,a=void 0,c=void 0,t=!0)}return`search`in e&&(e.search!==i||x.core.isScheduled)&&(i=e.search??``,a=void 0,c=void 0,t=!0),t?(D.cancel(),A()):Promise.resolve()},prev(){return u?(c=u,a=void 0,A()):Promise.resolve()},get query(){return{...a!==void 0&&{after:a},...c!==void 0&&{before:c},...i&&{search:i},limit:r}},ready(e){return x.ready(e)},refresh(){return A()},reset(){return D.cancel(),i=``,a=void 0,c=void 0,A()},search(e,t){return t?.immediate?e===i&&!x.core.isScheduled?Promise.resolve():(D.cancel(),i=e,a=void 0,c=void 0,A()):e===i?Promise.resolve():(i=e,a=void 0,c=void 0,D.schedule(()=>void A(),C))},subscribe:e=>x.core.subscribe(e),[Symbol.dispose]:()=>{D.cancel(),D.dispose(),x.dispose()}}}function S(e,t){let n=v(),r=[],i=()=>{r=t(e.current)};i();let a=e.subscribe(()=>{i(),n.notify()}),o={get current(){return r},get disposalSignal(){return n.disposalSignal},dispose(){n.isDisposed||(a(),n.dispose())},get disposed(){return n.isDisposed},get meta(){return e.meta},subscribe(e){return n.subscribe(e)},[Symbol.dispose](){o.dispose()}};return e.disposalSignal instanceof AbortSignal&&e.disposalSignal.addEventListener(`abort`,()=>o.dispose(),{once:!0}),o}function C(e){let t=e.queryKey??o,r=d(e.limit??20,`createInfiniteSource`,`limit`),i=``,a=1,c=0,l=[],u=0,p=null,m=!1,h=[],g={error:null,hasMore:!1,isLoading:!1,isLoadingMore:!1,isSearchPending:!1,loadedPages:0,pageSize:r,totalItems:0},v=()=>{h=l,g={error:p,hasMore:l.length<u,isLoading:y.pendingCount()>0&&!m,isLoadingMore:m,isSearchPending:y.core.isScheduled,loadedPages:c,pageSize:r,totalItems:u}},y=b(e,t,v),{autoFetch:x,debounceMs:S,retryAttempts:C,retryDelay:w}=y;v();let T=()=>{y.disposed||y.core.notify()},E=_(y.core,T),D=(t,o)=>{let d={...i&&{search:i},limit:r,page:t};return p=null,y.fetch(d,async(r,i,d)=>{let h=Date.now();try{let s=await n(t=>e.fetch(r,t),{delay:w,signal:i,times:C+1});d()&&(l=o?[...l,...s.items]:s.items,u=s.total,a=t,c=o?c+1:1,p=null,e.onFetch?.({durationMs:Date.now()-h,query:r,status:`success`}))}catch(t){if(i.aborted)return;d()&&(o||(l=[]),u=o?u:0,p=new f(s(t),{cause:t,context:{kind:`infinite`,limit:r.limit,page:r.page,...r.search&&{search:r.search}}}),e.onFetch?.({durationMs:Date.now()-h,error:p,query:r,status:`error`}))}finally{m=!1}},()=>{T(),E.settleIfIdle(y.pendingCount())})},O=()=>D(1,!1);return x&&O(),y.startRefreshInterval(()=>void O()),{get current(){return h},get disposalSignal(){return y.disposalSignal},dispose:()=>{E.cancel(),E.dispose(),y.dispose()},get disposed(){return y.disposed},loadMore(){return!g.hasMore||y.pendingCount()>0||m?Promise.resolve():(m=!0,v(),D(a+1,!0))},get meta(){return g},patch(e){let t=!1;if(e.limit!==void 0){let n=d(e.limit,`source.patch`,`limit`);n!==r&&(r=n,t=!0)}return`search`in e&&(e.search!==i||y.core.isScheduled)&&(i=e.search??``,t=!0),t?(E.cancel(),l=[],u=0,a=1,c=0,O()):Promise.resolve()},get query(){return{...i&&{search:i},limit:r,page:a}},ready(e){return y.ready(e)},reset(){return E.cancel(),a=1,c=0,l=[],u=0,i=``,O()},search(e,t){return t?.immediate?e===i&&!y.core.isScheduled?Promise.resolve():(E.cancel(),i=e,l=[],u=0,c=0,a=1,O()):e===i?Promise.resolve():(i=e,l=[],u=0,c=0,a=1,E.schedule(()=>void O(),S))},subscribe:e=>y.core.subscribe(e),[Symbol.dispose]:()=>{E.cancel(),E.dispose(),y.dispose()}}}var w=(e,t)=>{let n=Math.trunc(e);return Number.isFinite(n)?Math.max(t,n):t},T=(e,t)=>{let n=w(e,0),r=w(t,1);return Math.max(1,Math.ceil(n/r))},E=(e,t)=>Math.max(1,Math.min(w(e,1),Math.max(1,t))),D=e=>{let t=w(e.pageSize,1),n=w(e.totalItems,0),r=T(n,t),i=E(e.pageNumber,r);return{error:e.error,isLoading:e.isLoading,isSearchPending:e.isSearchPending,pageCount:r,pageNumber:i,pageSize:t,totalItems:n}};function O(e){if(e.totalItems===0)return{end:0,start:0};let t=(e.pageNumber-1)*e.pageSize+1;return{end:Math.min(e.pageNumber*e.pageSize,e.totalItems),start:t}}var k=20,A=300;function j(e,t){let n=t.toLowerCase();return e.filter(e=>JSON.stringify(e).toLowerCase().includes(n))}function M(e,t={}){let n=v(),r=t.filterAsync!==void 0||t.sortAsync!==void 0,i=t.debounceMs??A,a=t.initialData??e,o=``,c=t.filter,l=t.sort,u=d(t.limit??k,`createLocalSource`,`limit`),p=1,m=[],h=!1,g=!1,y=null,b=null,x=()=>n.notify(),S=_(n,x),C=()=>{let e=a;return o&&(e=(t.searchFn??j)(e,o)),c&&(e=e.filter(c)),l&&(e=[...e].sort(l)),e},w=()=>{m=C();let e=T(m.length,u);p=E(p,e)},O=async()=>{b?.abort();let e=new AbortController;b=e,h=!0,y=null,x();try{let n=a;if(o&&(n=(t.searchFn??j)(n,o)),c&&(n=n.filter(c)),t.filterAsync&&!e.signal.aborted&&(n=await t.filterAsync(n,e.signal)),l&&(n=[...n].sort(l)),t.sortAsync&&!e.signal.aborted&&(n=await t.sortAsync(n,e.signal)),e.signal.aborted)return;m=n,h=!1,g=!1;let r=T(m.length,u);p=E(p,r)}catch(t){e.signal.aborted||(h=!1,g=!1,y=new f(s(t),{cause:t}))}finally{b===e&&(b=null)}x(),S.settleIfIdle(0)},M=()=>r?O():(g=!1,w(),x(),S.settleIfIdle(0),Promise.resolve());r?(m=C(),O()):w();let N={get current(){let e=(p-1)*u;return m.slice(e,e+u)},get disposalSignal(){return n.disposalSignal},dispose(){n.isDisposed||(b?.abort(),b=null,S.cancel(),S.dispose(),n.dispose())},get disposed(){return n.isDisposed},goTo(e){let t=E(e,T(m.length,u));return t===p?Promise.resolve():(p=t,x(),Promise.resolve())},goToLast(){return N.goTo(T(m.length,u))},get meta(){return D({error:y,isLoading:h,isSearchPending:g,pageNumber:p,pageSize:u,totalItems:m.length})},next(){return N.goTo(p+1)},patch(e){let t=!1;if(e.limit!==void 0){let n=d(e.limit,`source.patch`,`limit`);n!==u&&(u=n,t=!0)}if(`filter`in e&&(c=e.filter,t=!0),`sort`in e&&(l=e.sort,t=!0),`search`in e&&(e.search!==o||n.isScheduled)&&(o=e.search??``,t=!0),e.page!==void 0){let n=E(e.page,T(m.length,u));n!==p&&(p=n,t=!0)}return t?(S.cancel(),(e.limit!==void 0||`filter`in e||`sort`in e||`search`in e)&&e.page===void 0&&(p=1),M()):Promise.resolve()},prev(){return N.goTo(p-1)},get query(){return{limit:u,page:p,...o&&{search:o}}},ready(e){return n.ready(()=>!h&&!n.isScheduled,e)},reset(){return S.cancel(),g=!1,o=``,c=t.filter,l=t.sort,p=1,M()},search(e,t){return t?.immediate?e===o&&!n.isScheduled?Promise.resolve():(S.cancel(),g=!1,o=e,p=1,M()):e===o?Promise.resolve():(o=e,p=1,g=!0,S.schedule(()=>{g=!1,M()},i))},setData(e){return a=e,p=1,M()},subscribe(e){return n.subscribe(e)},[Symbol.dispose](){N.dispose()}};return N}function N(e,t){let n=v(),r=t(e.map(e=>e.current)),i=e.map(i=>i.subscribe(()=>{r=t(e.map(e=>e.current)),n.notify()})),a={get current(){return r},get disposalSignal(){return n.disposalSignal},dispose(){if(!n.isDisposed){for(let e of i)e();n.dispose()}},get disposed(){return n.isDisposed},subscribe(e){return n.subscribe(e)},[Symbol.dispose](){a.dispose()}},o=e.map(e=>e.disposalSignal).filter(e=>e instanceof AbortSignal);if(o.length===e.length&&o.length>0){let e=o.filter(e=>!e.aborted).length;if(e===0)a.dispose();else for(let t of o)t.aborted||t.addEventListener(`abort`,()=>{e--,e===0&&a.dispose()},{once:!0})}return a}function P(e){let t=e.queryKey??o,r=e.staleTime??0,i=d(e.limit??20,`createRemoteSource`,`limit`),a=1,c=``,l=e.filter,u=e.sort,p=[],m=0,h=null,g=0,v=``,y=null;e.snapshot&&(p=e.snapshot.items,m=e.snapshot.total,e.snapshot.page!==void 0&&(a=e.snapshot.page),e.snapshot.search&&(c=e.snapshot.search),g=Date.now());let x=[],S=D({error:null,isLoading:!1,isSearchPending:!1,pageNumber:1,pageSize:i,totalItems:0}),C=()=>{let e=T(m,i),t=E(a,e);x=p,S=D({error:h,isLoading:w.pendingCount()>0,isSearchPending:w.core.isScheduled,pageNumber:t,pageSize:i,totalItems:m})},w=b(e,t,C),{autoFetch:O,debounceMs:k,retryAttempts:A,retryDelay:j}=w;C();let M=()=>{w.disposed||w.core.notify()},N=_(w.core,M),P=e=>{y?.active&&(y.active=!1,y=null),p=e.items,m=e.total,a=E(a,T(m,i))},F=()=>({...l!==void 0&&{filter:l},...u!==void 0&&{sort:u},...c&&{search:c},limit:i,page:a}),I=i=>{let a=t(i);return r>0&&a===v&&m>0&&Date.now()-g<r&&!y?.active?Promise.resolve():(h=null,w.fetch(i,async(t,r,i)=>{let o=Date.now();try{let s=await n(n=>e.fetch(t,n),{delay:j,signal:r,times:A+1});i()&&(P(s),h=null,v=a,g=Date.now(),e.onFetch?.({durationMs:Date.now()-o,query:t,status:`success`}))}catch(n){if(r.aborted)return;i()&&(y?.active?(y.active=!1,p=y.prevItems,m=y.prevTotal,y=null):(p=[],m=0),h=new f(s(n),{cause:n,context:{kind:`remote`,limit:t.limit,page:t.page,...t.search&&{search:t.search}}}),e.onFetch?.({durationMs:Date.now()-o,error:h,query:t,status:`error`}))}},()=>{M(),N.settleIfIdle(w.pendingCount())}))},L=()=>I(F());return O&&L(),w.startRefreshInterval(()=>void L()),{get current(){return x},get disposalSignal(){return w.disposalSignal},dispose:()=>{N.cancel(),N.dispose(),w.dispose()},get disposed(){return w.disposed},goTo(e){let t=m>0?E(e,T(m,i)):d(e,`source.goTo`,`target`);return t===a?Promise.resolve():(a=t,L())},goToLast(){let e=T(m,i);return a===e?Promise.resolve():(a=e,L())},get meta(){return S},next(){let e=T(m,i);return a>=e?Promise.resolve():(a++,L())},optimisticUpdate(e,t){if(y?.active)throw new f(`An optimistic update is already active. Rollback the previous update before starting another.`);let n=p,r=m;y={active:!0,prevItems:n,prevTotal:r};try{p=e(p)}catch(e){throw y=null,e}return m=t?.total??m,M(),()=>{y?.active&&(y.active=!1,p=n,m=r,y=null,M())}},patch(e){let t=!1;if(e.limit!==void 0){let n=d(e.limit,`source.patch`,`limit`);n!==i&&(i=n,t=!0)}if(`filter`in e&&(l=e.filter,t=!0),`sort`in e&&(u=e.sort,t=!0),`search`in e&&(e.search!==c||w.core.isScheduled)&&(c=e.search??``,t=!0),e.page!==void 0){let n=m>0?E(e.page,T(m,i)):d(e.page,`source.patch`,`page`);n!==a&&(a=n,t=!0)}return t?(N.cancel(),(e.limit!==void 0||`filter`in e||`sort`in e||`search`in e)&&e.page===void 0&&(a=1),L()):Promise.resolve()},prev(){return a<=1?Promise.resolve():(a--,L())},get query(){return{...l!==void 0&&{filter:l},...u!==void 0&&{sort:u},...c&&{search:c},limit:i,page:a}},ready(e){return w.ready(e)},refresh(){return L()},reset(){return N.cancel(),c=``,a=1,l=e.filter,u=e.sort,L()},search(e,t){return t?.immediate?e===c&&!w.core.isScheduled?Promise.resolve():(N.cancel(),c=e,a=1,L()):e===c?Promise.resolve():(c=e,a=1,N.schedule(()=>void L(),k))},subscribe:e=>w.core.subscribe(e),[Symbol.dispose]:()=>{N.cancel(),N.dispose(),w.dispose()}}}var F=e=>{let t=e.query;return{items:e.current,...t.search&&{search:t.search},page:e.meta.pageNumber,total:e.meta.totalItems}};async function I(e){let t=P({...e,autoFetch:!1});try{if(await t.refresh(),t.meta.error)throw t.meta.error;return F(t)}finally{t.dispose()}}async function L(e){let t=P({...e,autoFetch:!1});if(await t.refresh(),t.meta.error)throw t.dispose(),t.meta.error;return{snapshot:F(t),source:t}}var R=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)}},z=(e,t,n=!1)=>{let r=n?t:t.toLowerCase();return t=>{let i=e(t)??``;return(n?i:i.toLowerCase()).includes(r)}},B=(e,t)=>n=>Object.is(e(n),t),V=(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)}},H=(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}},U=(e,t={})=>{let n=Array.isArray(e)?e:[e],r=t.caseSensitive===!0;return(e,t)=>{if(t.length===0)return e;let i=r?t:t.toLowerCase();return e.filter(e=>n.some(t=>{let n=R(t(e));return(r?n:n.toLowerCase()).includes(i)}))}};function W(e){return e.meta.isLoading||e.meta.isSearchPending?{status:`loading`}:e.meta.error?{error:e.meta.error,status:`error`}:{items:e.current,status:`success`}}export{m as SourcererDisposedError,f as SourcererError,p as SourcererTimeoutError,x as createCursorSource,C as createInfiniteSource,M as createLocalSource,P as createRemoteSource,g as decodeQuery,S as deriveSource,h as encodeQuery,z as filterContains,B as filterEquals,V as filterRange,O as itemRange,N as mergeSource,I as prefetchSource,L as prefetchSourceAndKeep,U as searchBy,H as sortBy,W as sourceState};
+function e(){let e,t=0;return{begin(){e?.abort();let n=new AbortController,r=++t;return e=n,{finish(){r===t&&(e=void 0)},isCurrent(){return r===t},signal:n.signal}},dispose(){e?.abort(),e=void 0,t++}}}function t(e){return e instanceof Error?e:Error(typeof e==`string`&&e.length>0?e:`Source request failed`)}function n(e){let t=new AbortController,n=new Set,r=!1,i=e,a=()=>{r||(r=!0,n.clear(),t.abort())};return{get disposalSignal(){return t.signal},dispose:a,get disposed(){return r},set(e){if(!r){i=e;for(let e of n)try{e(i)}catch(e){queueMicrotask(()=>{throw e})}}},subscribe(e){return r?()=>{}:(n.add(e),()=>n.delete(e))},[Symbol.dispose]:a,get value(){return i}}}function r(r){let i=n(r),a=e();return{get disposalSignal(){return i.disposalSignal},dispose(){a.dispose(),i.dispose()},get disposed(){return i.disposed},async fetch(e){if(i.disposed)return;let n=a.begin(),r=i.value;i.set(e.pending(r));let o;try{o=e.success(await e.load(n.signal))}catch(a){if(!n.isCurrent()||i.disposed)return;let o=t(a);throw i.set(e.failure(r,o)),o}finally{n.finish()}!n.isCurrent()||i.disposed||i.set(o)},get snapshot(){return i.value},subscribe:i.subscribe}}function i(e,t){if(!Number.isInteger(e)||e<1)throw RangeError(`${t} must be a positive integer`);return e}function a(e){if(!Number.isInteger(e)||e<0)throw RangeError(`Source loader total must be a non-negative integer`);return e}function o(e,t,n){let r=Math.max(1,Math.ceil(n/t)),i=Math.min(e,r);return{count:r,hasNext:i<r,hasPrevious:i>1,index:i,kind:`page`,size:t,total:n}}function s(e,t){return[...new Set([...Object.keys(e),...Object.keys(t)])].every(n=>Object.is(e[n],t[n]))}var c=e=>({hasNext:e?.nextCursor!==void 0,hasPrevious:e?.previousCursor!==void 0,kind:`cursor`,...e?.nextCursor!==void 0&&{nextCursor:e.nextCursor},...e?.previousCursor!==void 0&&{previousCursor:e.previousCursor},...e?.total!==void 0&&{total:a(e.total)}}),l=(e,t={})=>{if(t.after!==void 0&&t.before!==void 0)throw RangeError(`Cursor query cannot include both after and before`);let n=t.pageSize!==void 0||t.search!==void 0,r=n||`before`in t?void 0:`after`in t?t.after:e.after,a=n||`after`in t?void 0:`before`in t?t.before:e.before;return{...r!==void 0&&{after:r},...a!==void 0&&{before:a},pageSize:i(t.pageSize??e.pageSize,`pageSize`),search:t.search??e.search}};function u(e){let t=l({pageSize:20,search:``},e.initialQuery),n=r({data:[],error:null,isFetching:!1,pagination:c(),query:t}),i=t=>n.fetch({failure:(e,t)=>({...e,error:t,isFetching:!1,pendingQuery:void 0}),load:n=>e.load({query:t,signal:n}),pending:e=>({...e,error:null,isFetching:!0,pendingQuery:t}),success:e=>({data:e.data,error:null,isFetching:!1,pagination:c(e),query:t})}),a=()=>i(t),o=async e=>{let r=l(n.snapshot.pendingQuery??n.snapshot.query,e);s(r,t)||(t=r,await i(r))},u={get disposalSignal(){return n.disposalSignal},dispose:n.dispose,get disposed(){return n.disposed},page:{next(){let e=n.snapshot.pagination.nextCursor;return n.snapshot.isFetching||e===void 0?Promise.resolve():o({after:e})},previous(){let e=n.snapshot.pagination.previousCursor;return n.snapshot.isFetching||e===void 0?Promise.resolve():o({before:e})}},reload:a,setQuery:o,get snapshot(){return n.snapshot},subscribe:n.subscribe,[Symbol.dispose](){u.dispose()}};return e.autoStart!==!1&&a().catch(()=>void 0),u}var d=(e,t,n)=>({hasMore:e<t,isLoadingMore:n,kind:`infinite`,loaded:e,total:t}),f=(e,t={})=>({pageSize:i(t.pageSize??e.pageSize,`pageSize`),search:t.search??e.search});function p(e){let t=f({pageSize:20,search:``},e.initialQuery),n=1,i=r({data:[],error:null,isFetching:!1,pagination:d(0,0,!1),query:t}),o=(t,r,o)=>{let s=i.snapshot.data;return i.fetch({failure:(e,t)=>({...e,error:t,isFetching:!1,pendingQuery:void 0}),load:n=>e.load({query:{...t,page:r,pageSize:t.pageSize},signal:n}),pending:e=>({...e,error:null,isFetching:!0,pagination:d(e.data.length,e.pagination.total,o),pendingQuery:t}),success:e=>{let i=a(e.total),c=o?[...s,...e.data]:e.data;return n=r+1,{data:c,error:null,isFetching:!1,pagination:d(c.length,i,!1),query:t}}})},c=()=>(n=1,o(t,1,!1)),l={get disposalSignal(){return i.disposalSignal},dispose:i.dispose,get disposed(){return i.disposed},loadMore(){let{isFetching:e,pagination:r}=i.snapshot;return e||i.snapshot.data.length>0&&!r.hasMore?Promise.resolve():o(t,n,!0)},reload:c,setQuery:async e=>{let r=f(i.snapshot.pendingQuery??i.snapshot.query,e);s(r,t)||(t=r,n=1,await o(r,1,!1))},get snapshot(){return i.snapshot},subscribe:i.subscribe,[Symbol.dispose](){l.dispose()}};return e.autoStart!==!1&&c().catch(()=>void 0),l}var m=(e,t={},n)=>{let r=t.page??e.page,a=t.pageSize??e.pageSize,o=t.search??e.search,s=t.pageSize!==void 0||t.search!==void 0,c=t.page??(s?1:r);return{page:n===void 0?i(c,`page`):Math.min(i(c,`page`),n),pageSize:i(a,`pageSize`),search:o}};function h(e,t={}){let r=e,i=m({page:1,pageSize:20,search:``},t.initialQuery),c=()=>{let e=i.search.length>0&&t.match?r.filter(e=>t.match(e,i.search)):r,n=a(e.length),s=o(i.page,i.pageSize,n),c=(s.index-1)*s.size;return i={...i,page:s.index},{data:e.slice(c,c+s.size),error:null,isFetching:!1,pagination:s,query:i}},l=n(c()),u=()=>{let e=c();return s(e.query,l.value.query)&&e.data===l.value.data&&e.pagination===l.value.pagination?!1:(l.set(e),!0)},d=e=>{let t=m(i,e,l.value.pagination.count);return!s(t,i)&&(i=t,u())},f={get disposalSignal(){return l.disposalSignal},dispose:l.dispose,get disposed(){return l.disposed},page:{go(e){return d({page:e})},last(){return d({page:l.value.pagination.count})},next(){return l.value.pagination.hasNext&&d({page:l.value.pagination.index+1})},previous(){return l.value.pagination.hasPrevious&&d({page:l.value.pagination.index-1})}},setData(e){return e!==r&&(r=e,u())},setQuery:d,get snapshot(){return l.value},subscribe:l.subscribe,[Symbol.dispose](){f.dispose()}};return f}var g=(e,t={},n)=>{let r=t.page??e.page,a=t.pageSize??e.pageSize,o=t.search??e.search,s=`filter`in t||t.pageSize!==void 0||t.search!==void 0||`sort`in t,c=t.page??(s?1:r);return{...`filter`in t?t.filter!==void 0&&{filter:t.filter}:e.filter!==void 0&&{filter:e.filter},...`sort`in t?t.sort!==void 0&&{sort:t.sort}:e.sort!==void 0&&{sort:e.sort},page:n===void 0?i(c,`page`):Math.min(i(c,`page`),n),pageSize:i(a,`pageSize`),search:o}};function _(e){let t=g({page:1,pageSize:20,search:``},e.initialQuery),n=r({data:[],error:null,isFetching:!1,pagination:o(t.page,t.pageSize,0),query:t}),i=r=>n.fetch({failure:(e,t)=>({...e,error:t,isFetching:!1,pendingQuery:void 0}),load:t=>e.load({query:r,signal:t}),pending:e=>({...e,error:null,isFetching:!0,pendingQuery:r}),success:e=>{let n=a(e.total),i=o(r.page,r.pageSize,n),s={...r,page:i.index};return t=s,{data:e.data,error:null,isFetching:!1,pagination:i,query:s}}}),c=()=>i(t),l=async e=>{let r=g(n.snapshot.pendingQuery??n.snapshot.query,e,n.snapshot.pagination.total>0?n.snapshot.pagination.count:void 0);s(r,t)||(t=r,await i(r))},u={get disposalSignal(){return n.disposalSignal},dispose:n.dispose,get disposed(){return n.disposed},page:{go(e){return n.snapshot.isFetching?Promise.resolve():l({page:e})},last(){return n.snapshot.isFetching?Promise.resolve():l({page:n.snapshot.pagination.count})},next(){return n.snapshot.isFetching||!n.snapshot.pagination.hasNext?Promise.resolve():l({page:n.snapshot.pagination.index+1})},previous(){return n.snapshot.isFetching||!n.snapshot.pagination.hasPrevious?Promise.resolve():l({page:n.snapshot.pagination.index-1})}},reload:c,setQuery:l,get snapshot(){return n.snapshot},subscribe:n.subscribe,[Symbol.dispose](){u.dispose()}};return e.autoStart!==!1&&c().catch(()=>void 0),u}export{u as createCursorSource,p as createInfiniteSource,h as createLocalSource,_ as createPageSource};
 //# sourceMappingURL=sourcerer.js.map