@vielzeug/sourcerer 1.0.2

package/dist/types.d.ts

@@ -0,0 +1,374 @@
+import type { SourcererError } from './errors';
+export type Predicate<T> = (value: T, index: number, array: readonly T[]) => boolean;
+export type Sorter<T> = (a: T, b: T) => number;
+export type QueryParamsInput = Record<string, string | string[] | undefined>;
+export type QueryParams = Record<string, string>;
+/** Configures automatic retry on fetch failure. */
+export type RetryConfig = Readonly<{
+    /** Number of retry attempts after the first failure. Default: 0 (no retries). */
+    attempts?: number;
+    /** Returns the delay in ms before the nth retry (1-indexed). Default: exponential backoff. */
+    delay?: (attempt: number) => number;
+}>;
+export type SourceQuery = Readonly<{
+    limit: number;
+    page: number;
+    /**
+     * The active search string. Absent (or empty string) when no search is active.
+     * Both representations are equivalent — treat `''` and `undefined` identically.
+     * `encodeQuery` omits this field when falsy; `decodeQuery` returns it only when present in the URL.
+     */
+    search?: string;
+}>;
+export type RemoteSourceQuery<TFilter = unknown, TSort = unknown> = Readonly<{
+    filter?: TFilter;
+    limit: number;
+    page: number;
+    search?: string;
+    sort?: TSort;
+}>;
+export type CursorSourceQuery<TCursor = string> = Readonly<{
+    after?: TCursor;
+    before?: TCursor;
+    limit: number;
+    search?: string;
+}>;
+export type InfiniteSourceQuery = Readonly<{
+    limit: number;
+    page: number;
+    search?: string;
+}>;
+export { SourceDisposedError, SourcererError, SourceTimeoutError } from './errors';
+export type { SourcererErrorContext } from './errors';
+/**
+ * Event emitted by the `onFetch` callback after each fetch attempt settles.
+ * Carries the full `SourcererError` on failure for rich diagnostics.
+ */
+export type FetchEvent<TQuery = unknown> = Readonly<{
+    /** Total time in ms from issuing the request to receiving a response (includes retries). */
+    durationMs: number;
+    /** Structured error when `status` is `'error'`. */
+    error?: SourcererError;
+    /** The query object that was fetched. */
+    query: TQuery;
+    status: 'error' | 'success';
+}>;
+/**
+ * Metadata snapshot describing the current pagination and loading state of a source.
+ * Use `itemRange(meta)` to compute display-level start/end item numbers.
+ */
+export type SourceMeta = Readonly<{
+    /** Structured error from the most recent failed fetch. `null` when healthy. */
+    error: SourcererError | null;
+    isLoading: boolean;
+    isSearchPending: boolean;
+    pageCount: number;
+    pageNumber: number;
+    pageSize: number;
+    totalItems: number;
+}>;
+/**
+ * A serializable point-in-time snapshot of a remote source's loaded state.
+ * Safe to embed in HTML or pass over the network.
+ */
+export type SourceSnapshot<T> = Readonly<{
+    items: readonly T[];
+    page?: number;
+    search?: string;
+    total: number;
+}>;
+/**
+ * Discriminated union describing the current state of any reactive source.
+ * Use `sourceState(source)` to derive this without manual branching on meta fields.
+ *
+ * @example
+ * ```ts
+ * const state = sourceState(source);
+ * if (state.status === 'loading') return <Spinner />;
+ * if (state.status === 'error') return <Error message={state.error.message} />;
+ * return <List items={state.items} />;
+ * ```
+ */
+export type SourceState<T> = {
+    readonly error: SourcererError;
+    readonly status: 'error';
+} | {
+    readonly items: readonly T[];
+    readonly status: 'success';
+} | {
+    readonly status: 'loading';
+};
+/**
+ * Minimal observable interface shared by all source and derived source types.
+ * Framework adapters should target this interface for maximum portability.
+ */
+export type ReactiveSource<T, TMeta = SourceMeta> = {
+    [Symbol.dispose](): void;
+    readonly current: readonly T[];
+    readonly disposalSignal: AbortSignal;
+    dispose(): void;
+    readonly disposed: boolean;
+    readonly meta: TMeta;
+    subscribe(listener: () => void): () => void;
+};
+/**
+ * Read-only reactive projection derived from a parent source.
+ * Returned by `deriveSource()`.
+ */
+export type DerivedSource<T, TMeta = SourceMeta> = ReactiveSource<T, TMeta>;
+/**
+ * Read-only reactive view combining multiple sources.
+ * Returned by `mergeSource()` when sources have incompatible meta shapes.
+ */
+export type MergedSource<T> = {
+    [Symbol.dispose](): void;
+    readonly current: readonly T[];
+    readonly disposalSignal: AbortSignal;
+    dispose(): void;
+    readonly disposed: boolean;
+    subscribe(listener: () => void): () => void;
+};
+/** Options for the `search()` method on all source types. */
+export type SearchOptions = Readonly<{
+    /** When `true`, cancels any pending debounce and fetches immediately. Default: `false`. */
+    immediate?: boolean;
+}>;
+/** Shared navigation interface for all page-based source types (local and remote). */
+export type PageNavigator<T> = ReactiveSource<T, SourceMeta> & {
+    goTo(page: number): Promise<void>;
+    goToLast(): Promise<void>;
+    next(): Promise<void>;
+    /**
+     * Applies one or more query changes atomically — a single fetch for any combination
+     * of limit, page, and search updates.
+     *
+     * @example
+     * ```ts
+     * // Change limit and search in one fetch
+     * await source.patch({ limit: 20, search: 'hello' });
+     * ```
+     */
+    patch(changes: Partial<SourceQuery>): Promise<void>;
+    prev(): Promise<void>;
+    /**
+     * The current query state — limit, page, and optional search string.
+     * Use `encodeQuery(source.query)` to serialize to URL params.
+     */
+    readonly query: SourceQuery;
+    /**
+     * Resolves when the source is idle (no pending async computation).
+     * Rejects with `SourceTimeoutError` after `timeout` ms if still busy.
+     */
+    ready(timeout?: number): Promise<void>;
+    reset(): Promise<void>;
+    /**
+     * Updates the search query. Debounced by default.
+     * Always returns a `Promise<void>` that resolves when the triggered fetch completes.
+     * Pass `{ immediate: true }` to skip the debounce window.
+     */
+    search(query: string, opts?: SearchOptions): Promise<void>;
+};
+/** Full set of fields patchable in one atomic recompute on a local source. */
+export type LocalSourceQuery<T> = Partial<{
+    filter: Predicate<T> | undefined;
+    limit: number;
+    page: number;
+    search: string;
+    sort: Sorter<T> | undefined;
+}>;
+/**
+ * Full interface for in-memory page-based sources.
+ * Synchronous when no async ops are configured; supports async filter/sort
+ * pipelines (e.g. Web Worker offloading) when `filterAsync`/`sortAsync` are set.
+ */
+export type LocalSource<T> = Omit<PageNavigator<T>, 'patch'> & {
+    /**
+     * Applies one or more query changes atomically — a single recompute for any combination
+     * of limit, page, search, filter, and sort updates.
+     *
+     * @example
+     * ```ts
+     * // Change filter and search in one recompute
+     * await source.patch({ filter: (u) => u.active, search: 'ada', limit: 5 });
+     * ```
+     */
+    patch(changes: LocalSourceQuery<T>): Promise<void>;
+    setData(data: readonly T[]): Promise<void>;
+};
+/**
+ * Full interface for remote page-based sources.
+ * `optimisticUpdate(mutator)` throws if a concurrent update is already pending.
+ */
+export type RemoteSource<T, TFilter = unknown, TSort = unknown> = Omit<PageNavigator<T>, 'patch' | 'query'> & {
+    /**
+     * Applies an optimistic update immediately before a fetch settles.
+     * Returns a rollback function. The optimistic state is automatically cleared
+     * on the next successful fetch, or rolled back on failure.
+     *
+     * @throws {Error} If an optimistic update is already active.
+     */
+    optimisticUpdate(mutator: (current: readonly T[]) => readonly T[], options?: {
+        total?: number;
+    }): () => void;
+    /**
+     * Applies one or more query changes atomically — a single fetch for any combination
+     * of limit, page, search, filter, and sort updates.
+     */
+    patch(changes: Partial<RemoteSourceQuery<TFilter, TSort>>): Promise<void>;
+    /**
+     * The current query state. Use `encodeQuery(source.query)` to serialize to URL params.
+     */
+    readonly query: RemoteSourceQuery<TFilter, TSort>;
+    ready(timeout?: number): Promise<void>;
+    refresh(): Promise<void>;
+};
+export type LocalSourceConfig<T> = Readonly<{
+    debounceMs?: number;
+    filter?: Predicate<T>;
+    /**
+     * Async filter applied after the sync `filter`, enabling Web Worker offloading
+     * via `@vielzeug/familiar`. Sets `meta.isLoading` to `true` during computation.
+     * The signal is aborted when a new computation supersedes this one.
+     */
+    filterAsync?: (items: readonly T[], signal: AbortSignal) => Promise<readonly T[]>;
+    /** Initial data to populate the source. When provided, pass `[]` as the first arg. */
+    initialData?: readonly T[];
+    limit?: number;
+    /**
+     * Custom search function. Default: case-insensitive JSON substring match.
+     * Provide a domain-specific function for better relevance on large datasets.
+     */
+    searchFn?: (items: readonly T[], query: string) => readonly T[];
+    sort?: Sorter<T>;
+    /**
+     * Async sort applied after the sync `sort`. Sets `meta.isLoading` to `true`
+     * during computation, enabling Web Worker offloading.
+     */
+    sortAsync?: (items: readonly T[], signal: AbortSignal) => Promise<readonly T[]>;
+}>;
+export type RemoteConfig<T, TFilter = unknown, TSort = unknown> = Readonly<{
+    /** Automatically fetch on construction. Default: `true`. */
+    autoFetch?: boolean;
+    /** Debounce delay in ms for `search()` calls. Default: `300`. */
+    debounceMs?: number;
+    fetch: (q: RemoteSourceQuery<TFilter, TSort>, signal: AbortSignal) => Promise<Readonly<{
+        items: readonly T[];
+        total: number;
+    }>>;
+    filter?: TFilter;
+    limit?: number;
+    /**
+     * Called after each fetch attempt settles (success or failure).
+     * Useful for logging, telemetry, and debugging.
+     */
+    onFetch?: (event: FetchEvent<RemoteSourceQuery<TFilter, TSort>>) => void;
+    queryKey?: (q: RemoteSourceQuery<TFilter, TSort>) => string;
+    /**
+     * Automatically re-fetch at this interval in ms. The timer is cancelled on `dispose()`.
+     * Useful for live dashboards and real-time data displays.
+     */
+    refreshInterval?: number;
+    retry?: RetryConfig;
+    /**
+     * Pre-populate the source with server-fetched data (SSR / prefetch).
+     * The source starts in a loaded state — no initial loading flash.
+     * Set `autoFetch: false` to suppress the background re-fetch when the snapshot is fresh.
+     */
+    snapshot?: SourceSnapshot<T>;
+    sort?: TSort;
+    /**
+     * Skip re-fetching if the last successful fetch was within this many ms.
+     * Returns cached data immediately. Combine with `refreshInterval` for
+     * stale-while-revalidate behaviour.
+     * Default: `0` (always re-fetch).
+     */
+    staleTime?: number;
+}>;
+export type CursorMeta = Readonly<{
+    error: SourcererError | null;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+    isLoading: boolean;
+    isSearchPending: boolean;
+    pageSize: number;
+    totalItems: number;
+}>;
+export type CursorSource<T, TCursor = string> = ReactiveSource<T, CursorMeta> & {
+    next(): Promise<void>;
+    /**
+     * Applies one or more query changes atomically — a single fetch for any combination
+     * of limit and search updates.
+     */
+    patch(changes: Partial<Pick<CursorSourceQuery<TCursor>, 'limit' | 'search'>>): Promise<void>;
+    prev(): Promise<void>;
+    /** The current query state. Use `encodeQuery(source.query)` to serialize to URL params. */
+    readonly query: CursorSourceQuery<TCursor>;
+    ready(timeout?: number): Promise<void>;
+    refresh(): Promise<void>;
+    reset(): Promise<void>;
+    search(query: string, opts?: SearchOptions): Promise<void>;
+};
+export type CursorConfig<T, TCursor = string> = Readonly<{
+    autoFetch?: boolean;
+    debounceMs?: number;
+    fetch: (q: CursorSourceQuery<TCursor>, signal: AbortSignal) => Promise<Readonly<{
+        items: readonly T[];
+        nextCursor?: TCursor;
+        prevCursor?: TCursor;
+        total?: number;
+    }>>;
+    limit?: number;
+    /** Called after each fetch attempt settles. Useful for logging and telemetry. */
+    onFetch?: (event: FetchEvent<CursorSourceQuery<TCursor>>) => void;
+    queryKey?: (q: CursorSourceQuery<TCursor>) => string;
+    /** Automatically re-fetch at this interval in ms. Cancelled on `dispose()`. */
+    refreshInterval?: number;
+    retry?: RetryConfig;
+}>;
+export type InfiniteMeta = Readonly<{
+    error: SourcererError | null;
+    hasMore: boolean;
+    isLoading: boolean;
+    /** `true` only during `loadMore()` fetches — distinct from the initial load. */
+    isLoadingMore: boolean;
+    isSearchPending: boolean;
+    /** Number of pages appended so far. Resets to 0 on `reset()` or `search()`. */
+    loadedPages: number;
+    pageSize: number;
+    totalItems: number;
+}>;
+export type InfiniteSource<T> = ReactiveSource<T, InfiniteMeta> & {
+    /** Appends the next page of results to `current`. No-op when `meta.hasMore` is false. */
+    loadMore(): Promise<void>;
+    /**
+     * Applies one or more query changes atomically — a single fetch for any combination
+     * of limit and search updates. Resets accumulated pages.
+     */
+    patch(changes: Partial<Pick<InfiniteSourceQuery, 'limit' | 'search'>>): Promise<void>;
+    /** The current query state. Use `encodeQuery(source.query)` to serialize to URL params. */
+    readonly query: InfiniteSourceQuery;
+    /**
+     * Resolves when no fetch is in progress (including `loadMore` fetches).
+     * Rejects after `timeout` ms if still loading.
+     */
+    ready(timeout?: number): Promise<void>;
+    reset(): Promise<void>;
+    search(query: string, opts?: SearchOptions): Promise<void>;
+};
+export type InfiniteConfig<T> = Readonly<{
+    autoFetch?: boolean;
+    debounceMs?: number;
+    fetch: (q: InfiniteSourceQuery, signal: AbortSignal) => Promise<Readonly<{
+        items: readonly T[];
+        total: number;
+    }>>;
+    limit?: number;
+    /** Called after each fetch attempt settles. Useful for logging and telemetry. */
+    onFetch?: (event: FetchEvent<InfiniteSourceQuery>) => void;
+    /** Custom cache key function. Used to deduplicate in-flight requests. Default: stable JSON stringify. */
+    queryKey?: (q: InfiniteSourceQuery) => string;
+    /** Automatically re-fetch (reset to page 1) at this interval in ms. Cancelled on `dispose()`. */
+    refreshInterval?: number;
+    retry?: RetryConfig;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@vielzeug/sourcerer",
+  "version": "1.0.2",
+  "description": "Typed data-source adapter — pagination, filtering, sorting, search, and cursor-based infinite scroll",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "vite build && pnpm run build:bundle && pnpm run build:types",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "fix": "eslint --fix src",
+    "lint": "eslint src",
+    "prepublishOnly": "pnpm run build",
+    "preview": "vite preview",
+    "test": "vitest",
+    "build:bundle": "vite build --config vite.bundle.config.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@vielzeug/arsenal": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.9"
+  }
+}