@vielzeug/sourcerer 2.2.1 → 3.0.0

package/README.md

@@ -1,43 +1,42 @@
 # @vielzeug/sourcerer
 
-Atomic reactive sources for local, numbered-page, cursor, and infinite collections.
+> Reactive collection sources with local, page, cursor, and infinite pagination
+
+## Installation
 
 ```sh
 pnpm add @vielzeug/sourcerer
+npm install @vielzeug/sourcerer
+yarn add @vielzeug/sourcerer
 ```
 
+## Quick Start
+
 ```ts
 import { createPageSource } from '@vielzeug/sourcerer';
 
 const users = createPageSource({
-  autoStart: false,
-  initialQuery: { pageSize: 20 },
-  load: async () => ({ data: [{ id: 1, name: 'Ada' }], total: 1 }),
+  load: async ({ page, pageSize }) => ({
+    items: [{ id: page, name: 'Ada' }].slice(0, pageSize),
+    totalItems: 1,
+  }),
+  pageSize: 20,
 });
 
 await users.reload();
-console.log(users.snapshot.data);
-console.log(users.snapshot.pagination.total);
+console.log(users.state.items);
+console.log(users.state.pagination.totalItems);
 users.dispose();
 ```
 
-Every source exposes an atomic `snapshot` and `subscribe(listener)`. `setQuery()` changes query fields; `page.*` changes page index. While newer work is active, `pendingQuery` records it without mixing it into loaded data. Page sources cancel superseded requests and preserve successful data on background refresh failures.
-
-| Factory | Purpose |
-| --- | --- |
-| `createLocalSource()` | Synchronous in-memory collection |
-| `createPageSource()` | Numbered async pages |
-| `createCursorSource()` | Cursor-based async pages |
-| `createInfiniteSource()` | Appended async pages |
-
-Sourcerer manages collection state and request succession. Configure retries, cache, polling, URL serialization, and optimistic mutation with your transport or application layer.
-
 ## Documentation
 
 - [Overview](https://vielzeug.dev/sourcerer/)
 - [Usage Guide](https://vielzeug.dev/sourcerer/usage)
 - [API Reference](https://vielzeug.dev/sourcerer/api)
+- [Examples](https://vielzeug.dev/sourcerer/examples)
+- [Migration Guide](https://vielzeug.dev/sourcerer/migration)
 
 ## License
 
-MIT © Helmuth Saatkamp — part of Vielzeug.
+MIT © [Helmuth Saatkamp](https://github.com/helmuthdu) — part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.

package/dist/asyncSource.cjs

@@ -1,2 +1,2 @@
-const e=require("./requestController.cjs"),t=require("./sourceStore.cjs");function n(n){let r=t.createSourceStore(n),i=e.createRequestController();return{get disposalSignal(){return r.disposalSignal},dispose(){i.dispose(),r.dispose()},get disposed(){return r.disposed},async fetch(t){if(r.disposed)return;let n=i.begin(),a=r.value;r.set(t.pending(a));let o;try{o=t.success(await t.load(n.signal))}catch(i){if(!n.isCurrent()||r.disposed)return;let o=e.toError(i);throw r.set(t.failure(a,o)),o}finally{n.finish()}!n.isCurrent()||r.disposed||r.set(o)},get snapshot(){return r.value},subscribe:r.subscribe}}exports.createAsyncSource=n;
+const e=require("./errors.cjs"),t=require("./requestController.cjs"),n=require("./sourceStore.cjs");let r=require("@vielzeug/arsenal");var i=(e,t)=>new Promise((n,i)=>{let a=()=>i((0,r.abortError)(t,`The operation was aborted.`));if(t.aborted){a();return}t.addEventListener(`abort`,a,{once:!0});let o;try{o=e(t)}catch(e){t.removeEventListener(`abort`,a),i(e);return}o.then(e=>{t.removeEventListener(`abort`,a),n(e)},e=>{t.removeEventListener(`abort`,a),i(e)})});function a(r){let a=n.createSourceStore(r),o=t.createRequestController();return{get disposalSignal(){return a.disposalSignal},dispose(){o.dispose(),a.dispose()},get disposed(){return a.disposed},async fetch(n){if(a.disposed)throw new e.SourcererDisposedError;let r=o.begin(),s=a.value;a.set(n.pending(s));try{let e=await i(n.load,r.signal);if(!r.isCurrent()||a.disposed)return;let t=n.success(e);n.commit?.(t,e),a.set(t)}catch(e){if(!r.isCurrent()||a.disposed)return;let i=t.toError(e);throw a.set(n.failure(s,i)),i}finally{r.finish()}},get state(){return a.value},subscribe:a.subscribe}}exports.createAsyncSource=a;
 //# sourceMappingURL=asyncSource.cjs.map

package/dist/asyncSource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"asyncSource.cjs","names":[],"sources":["../src/asyncSource.ts"],"sourcesContent":["import { createRequestController, toError } from './requestController';\nimport { createSourceStore } from './sourceStore';\nimport type { AnyPagination, SourceSnapshot } from './types';\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"],"mappings":"0EAmBA,SAAgB,EACd,EACqC,CACrC,IAAM,EAAQ,EAAA,kBAAkB,CAAO,EACjC,EAAW,EAAA,wBAAwB,EAEzC,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAO,EAAM,cACf,EAEA,SAAU,CACR,EAAS,QAAQ,EACjB,EAAM,QAAQ,CAChB,EAEA,IAAI,UAAW,CACb,OAAO,EAAM,QACf,EAEA,MAAM,MAAM,EAAS,CACnB,GAAI,EAAM,SAAU,OAEpB,IAAM,EAAU,EAAS,MAAM,EACzB,EAAW,EAAM,MAEvB,EAAM,IAAI,EAAQ,QAAQ,CAAQ,CAAC,EAEnC,IAAI,EAEJ,GAAI,CACF,EAAO,EAAQ,QAAQ,MAAM,EAAQ,KAAK,EAAQ,MAAM,CAAC,CAC3D,OAAS,EAAiB,CACxB,GAAI,CAAC,EAAQ,UAAU,GAAK,EAAM,SAAU,OAE5C,IAAM,EAAQ,EAAA,QAAQ,CAAM,EAG5B,MADA,EAAM,IAAI,EAAQ,QAAQ,EAAU,CAAK,CAAC,EACpC,CACR,QAAU,CACR,EAAQ,OAAO,CACjB,CAEI,CAAC,EAAQ,UAAU,GAAK,EAAM,UAElC,EAAM,IAAI,CAAI,CAChB,EAEA,IAAI,UAAW,CACb,OAAO,EAAM,KACf,EAEA,UAAW,EAAM,SACnB,CACF"}
+{"version":3,"file":"asyncSource.cjs","names":[],"sources":["../src/asyncSource.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal';\n\nimport { SourcererDisposedError } from './errors';\nimport { createRequestController, toError } from './requestController';\nimport { createSourceStore } from './sourceStore';\n\nconst loadWithSignal = <T>(load: (signal: AbortSignal) => Promise<T>, signal: AbortSignal): Promise<T> =>\n  new Promise((resolve, reject) => {\n    const abort = (): void => reject(abortError(signal, 'The operation was aborted.'));\n    if (signal.aborted) {\n      abort();\n      return;\n    }\n\n    signal.addEventListener('abort', abort, { once: true });\n    let result: Promise<T>;\n    try {\n      result = load(signal);\n    } catch (error) {\n      signal.removeEventListener('abort', abort);\n      reject(error);\n      return;\n    }\n\n    result.then(\n      (value) => {\n        signal.removeEventListener('abort', abort);\n        resolve(value);\n      },\n      (error: unknown) => {\n        signal.removeEventListener('abort', abort);\n        reject(error);\n      },\n    );\n  });\n\ntype FetchOptions<TState, TResult> = {\n  load(signal: AbortSignal): Promise<TResult>;\n  success(result: TResult): TState;\n  commit?(state: TState, result: TResult): void;\n  pending(previous: TState): TState;\n  failure(previous: TState, error: Error): TState;\n};\n\ntype AsyncSource<TState> = Readonly<{\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  fetch<TResult>(options: FetchOptions<TState, TResult>): Promise<void>;\n  readonly state: TState;\n  subscribe(listener: (state: TState) => void): () => void;\n}>;\n\n/** Only the current request may commit; superseded work settles without changing source state. */\nexport function createAsyncSource<TState>(initial: TState): AsyncSource<TState> {\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) throw new SourcererDisposedError();\n\n      const request = requests.begin();\n      const previous = store.value;\n      store.set(options.pending(previous));\n\n      try {\n        const result = await loadWithSignal(options.load, request.signal);\n        if (!request.isCurrent() || store.disposed) return;\n\n        const state = options.success(result);\n        options.commit?.(state, result);\n        store.set(state);\n      } catch (reason: unknown) {\n        if (!request.isCurrent() || store.disposed) return;\n\n        const error = toError(reason);\n        store.set(options.failure(previous, error));\n        throw error;\n      } finally {\n        request.finish();\n      }\n    },\n\n    get state() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n  };\n}\n"],"mappings":"uIAMA,IAAM,GAAqB,EAA2C,IACpE,IAAI,SAAS,EAAS,IAAW,CAC/B,IAAM,MAAoB,GAAA,EAAO,EAAA,WAAA,CAAW,EAAQ,4BAA4B,CAAC,EACjF,GAAI,EAAO,QAAS,CAClB,EAAM,EACN,MACF,CAEA,EAAO,iBAAiB,QAAS,EAAO,CAAE,KAAM,EAAK,CAAC,EACtD,IAAI,EACJ,GAAI,CACF,EAAS,EAAK,CAAM,CACtB,OAAS,EAAO,CACd,EAAO,oBAAoB,QAAS,CAAK,EACzC,EAAO,CAAK,EACZ,MACF,CAEA,EAAO,KACJ,GAAU,CACT,EAAO,oBAAoB,QAAS,CAAK,EACzC,EAAQ,CAAK,CACf,EACC,GAAmB,CAClB,EAAO,oBAAoB,QAAS,CAAK,EACzC,EAAO,CAAK,CACd,CACF,CACF,CAAC,EAoBH,SAAgB,EAA0B,EAAsC,CAC9E,IAAM,EAAQ,EAAA,kBAAkB,CAAO,EACjC,EAAW,EAAA,wBAAwB,EAEzC,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAO,EAAM,cACf,EAEA,SAAU,CACR,EAAS,QAAQ,EACjB,EAAM,QAAQ,CAChB,EAEA,IAAI,UAAW,CACb,OAAO,EAAM,QACf,EAEA,MAAM,MAAM,EAAS,CACnB,GAAI,EAAM,SAAU,MAAM,IAAI,EAAA,uBAE9B,IAAM,EAAU,EAAS,MAAM,EACzB,EAAW,EAAM,MACvB,EAAM,IAAI,EAAQ,QAAQ,CAAQ,CAAC,EAEnC,GAAI,CACF,IAAM,EAAS,MAAM,EAAe,EAAQ,KAAM,EAAQ,MAAM,EAChE,GAAI,CAAC,EAAQ,UAAU,GAAK,EAAM,SAAU,OAE5C,IAAM,EAAQ,EAAQ,QAAQ,CAAM,EACpC,EAAQ,SAAS,EAAO,CAAM,EAC9B,EAAM,IAAI,CAAK,CACjB,OAAS,EAAiB,CACxB,GAAI,CAAC,EAAQ,UAAU,GAAK,EAAM,SAAU,OAE5C,IAAM,EAAQ,EAAA,QAAQ,CAAM,EAE5B,MADA,EAAM,IAAI,EAAQ,QAAQ,EAAU,CAAK,CAAC,EACpC,CACR,QAAU,CACR,EAAQ,OAAO,CACjB,CACF,EAEA,IAAI,OAAQ,CACV,OAAO,EAAM,KACf,EAEA,UAAW,EAAM,SACnB,CACF"}

package/dist/asyncSource.d.ts

@@ -1,18 +1,19 @@
-import type { AnyPagination, SourceSnapshot } from './types';
-type AsyncSource<T, TQuery, TPagination extends AnyPagination> = Readonly<{
+type FetchOptions<TState, TResult> = {
+    load(signal: AbortSignal): Promise<TResult>;
+    success(result: TResult): TState;
+    commit?(state: TState, result: TResult): void;
+    pending(previous: TState): TState;
+    failure(previous: TState, error: Error): TState;
+};
+type AsyncSource<TState> = Readonly<{
     readonly disposalSignal: AbortSignal;
     dispose(): void;
     readonly disposed: boolean;
-    fetch<TResult>(options: {
-        failure(previous: SourceSnapshot<T, TQuery, TPagination>, error: Error): SourceSnapshot<T, TQuery, TPagination>;
-        load(signal: AbortSignal): Promise<TResult>;
-        pending(previous: SourceSnapshot<T, TQuery, TPagination>): SourceSnapshot<T, TQuery, TPagination>;
-        success(result: TResult): SourceSnapshot<T, TQuery, TPagination>;
-    }): Promise<void>;
-    readonly snapshot: SourceSnapshot<T, TQuery, TPagination>;
-    subscribe(listener: (snapshot: SourceSnapshot<T, TQuery, TPagination>) => void): () => void;
+    fetch<TResult>(options: FetchOptions<TState, TResult>): Promise<void>;
+    readonly state: TState;
+    subscribe(listener: (state: TState) => void): () => void;
 }>;
-/** Request failures and observer failures stay separate so observers cannot corrupt source state. */
-export declare function createAsyncSource<T, TQuery, TPagination extends AnyPagination>(initial: SourceSnapshot<T, TQuery, TPagination>): AsyncSource<T, TQuery, TPagination>;
+/** Only the current request may commit; superseded work settles without changing source state. */
+export declare function createAsyncSource<TState>(initial: TState): AsyncSource<TState>;
 export {};
 //# sourceMappingURL=asyncSource.d.ts.map

package/dist/asyncSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asyncSource.d.ts","sourceRoot":"","sources":["../src/asyncSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE7D,KAAK,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,SAAS,aAAa,IAAI,QAAQ,CAAC;IACxE,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE;QACtB,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAChH,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAClG,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;KAClE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1D,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7F,CAAC,CAAC;AAEH,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,SAAS,aAAa,EAC5E,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,GAC9C,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAoDrC"}
+{"version":3,"file":"asyncSource.d.ts","sourceRoot":"","sources":["../src/asyncSource.ts"],"names":[],"mappings":"AAoCA,KAAK,YAAY,CAAC,MAAM,EAAE,OAAO,IAAI;IACnC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;CACjD,CAAC;AAEF,KAAK,WAAW,CAAC,MAAM,IAAI,QAAQ,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC1D,CAAC,CAAC;AAEH,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAiD9E"}

package/dist/asyncSource.js

@@ -1,41 +1,64 @@
-import { createRequestController as e, toError as t } from "./requestController.js";
-import { createSourceStore as n } from "./sourceStore.js";
+import { SourcererDisposedError as e } from "./errors.js";
+import { createRequestController as t, toError as n } from "./requestController.js";
+import { createSourceStore as r } from "./sourceStore.js";
+import { abortError as i } from "@vielzeug/arsenal";
 //#region src/asyncSource.ts
-function r(r) {
-	let i = n(r), a = e();
+var a = (e, t) => new Promise((n, r) => {
+	let a = () => r(i(t, "The operation was aborted."));
+	if (t.aborted) {
+		a();
+		return;
+	}
+	t.addEventListener("abort", a, { once: !0 });
+	let o;
+	try {
+		o = e(t);
+	} catch (e) {
+		t.removeEventListener("abort", a), r(e);
+		return;
+	}
+	o.then((e) => {
+		t.removeEventListener("abort", a), n(e);
+	}, (e) => {
+		t.removeEventListener("abort", a), r(e);
+	});
+});
+function o(i) {
+	let o = r(i), s = t();
 	return {
 		get disposalSignal() {
-			return i.disposalSignal;
+			return o.disposalSignal;
 		},
 		dispose() {
-			a.dispose(), i.dispose();
+			s.dispose(), o.dispose();
 		},
 		get disposed() {
-			return i.disposed;
+			return o.disposed;
 		},
-		async fetch(e) {
-			if (i.disposed) return;
-			let n = a.begin(), r = i.value;
-			i.set(e.pending(r));
-			let o;
+		async fetch(t) {
+			if (o.disposed) throw new e();
+			let r = s.begin(), i = o.value;
+			o.set(t.pending(i));
 			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;
+				let e = await a(t.load, r.signal);
+				if (!r.isCurrent() || o.disposed) return;
+				let n = t.success(e);
+				t.commit?.(n, e), o.set(n);
+			} catch (e) {
+				if (!r.isCurrent() || o.disposed) return;
+				let a = n(e);
+				throw o.set(t.failure(i, a)), a;
 			} finally {
-				n.finish();
+				r.finish();
 			}
-			!n.isCurrent() || i.disposed || i.set(o);
 		},
-		get snapshot() {
-			return i.value;
+		get state() {
+			return o.value;
 		},
-		subscribe: i.subscribe
+		subscribe: o.subscribe
 	};
 }
 //#endregion
-export { r as createAsyncSource };
+export { o as createAsyncSource };
 
 //# sourceMappingURL=asyncSource.js.map

package/dist/asyncSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"asyncSource.js","names":[],"sources":["../src/asyncSource.ts"],"sourcesContent":["import { createRequestController, toError } from './requestController';\nimport { createSourceStore } from './sourceStore';\nimport type { AnyPagination, SourceSnapshot } from './types';\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"],"mappings":";;;AAmBA,SAAgB,EACd,GACqC;CACrC,IAAM,IAAQ,EAAkB,CAAO,GACjC,IAAW,EAAwB;CAEzC,OAAO;EACL,IAAI,iBAAiB;GACnB,OAAO,EAAM;EACf;EAEA,UAAU;GAER,AADA,EAAS,QAAQ,GACjB,EAAM,QAAQ;EAChB;EAEA,IAAI,WAAW;GACb,OAAO,EAAM;EACf;EAEA,MAAM,MAAM,GAAS;GACnB,IAAI,EAAM,UAAU;GAEpB,IAAM,IAAU,EAAS,MAAM,GACzB,IAAW,EAAM;GAEvB,EAAM,IAAI,EAAQ,QAAQ,CAAQ,CAAC;GAEnC,IAAI;GAEJ,IAAI;IACF,IAAO,EAAQ,QAAQ,MAAM,EAAQ,KAAK,EAAQ,MAAM,CAAC;GAC3D,SAAS,GAAiB;IACxB,IAAI,CAAC,EAAQ,UAAU,KAAK,EAAM,UAAU;IAE5C,IAAM,IAAQ,EAAQ,CAAM;IAG5B,MADA,EAAM,IAAI,EAAQ,QAAQ,GAAU,CAAK,CAAC,GACpC;GACR,UAAU;IACR,EAAQ,OAAO;GACjB;GAEI,CAAC,EAAQ,UAAU,KAAK,EAAM,YAElC,EAAM,IAAI,CAAI;EAChB;EAEA,IAAI,WAAW;GACb,OAAO,EAAM;EACf;EAEA,WAAW,EAAM;CACnB;AACF"}
+{"version":3,"file":"asyncSource.js","names":[],"sources":["../src/asyncSource.ts"],"sourcesContent":["import { abortError } from '@vielzeug/arsenal';\n\nimport { SourcererDisposedError } from './errors';\nimport { createRequestController, toError } from './requestController';\nimport { createSourceStore } from './sourceStore';\n\nconst loadWithSignal = <T>(load: (signal: AbortSignal) => Promise<T>, signal: AbortSignal): Promise<T> =>\n  new Promise((resolve, reject) => {\n    const abort = (): void => reject(abortError(signal, 'The operation was aborted.'));\n    if (signal.aborted) {\n      abort();\n      return;\n    }\n\n    signal.addEventListener('abort', abort, { once: true });\n    let result: Promise<T>;\n    try {\n      result = load(signal);\n    } catch (error) {\n      signal.removeEventListener('abort', abort);\n      reject(error);\n      return;\n    }\n\n    result.then(\n      (value) => {\n        signal.removeEventListener('abort', abort);\n        resolve(value);\n      },\n      (error: unknown) => {\n        signal.removeEventListener('abort', abort);\n        reject(error);\n      },\n    );\n  });\n\ntype FetchOptions<TState, TResult> = {\n  load(signal: AbortSignal): Promise<TResult>;\n  success(result: TResult): TState;\n  commit?(state: TState, result: TResult): void;\n  pending(previous: TState): TState;\n  failure(previous: TState, error: Error): TState;\n};\n\ntype AsyncSource<TState> = Readonly<{\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  fetch<TResult>(options: FetchOptions<TState, TResult>): Promise<void>;\n  readonly state: TState;\n  subscribe(listener: (state: TState) => void): () => void;\n}>;\n\n/** Only the current request may commit; superseded work settles without changing source state. */\nexport function createAsyncSource<TState>(initial: TState): AsyncSource<TState> {\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) throw new SourcererDisposedError();\n\n      const request = requests.begin();\n      const previous = store.value;\n      store.set(options.pending(previous));\n\n      try {\n        const result = await loadWithSignal(options.load, request.signal);\n        if (!request.isCurrent() || store.disposed) return;\n\n        const state = options.success(result);\n        options.commit?.(state, result);\n        store.set(state);\n      } catch (reason: unknown) {\n        if (!request.isCurrent() || store.disposed) return;\n\n        const error = toError(reason);\n        store.set(options.failure(previous, error));\n        throw error;\n      } finally {\n        request.finish();\n      }\n    },\n\n    get state() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n  };\n}\n"],"mappings":";;;;;AAMA,IAAM,KAAqB,GAA2C,MACpE,IAAI,SAAS,GAAS,MAAW;CAC/B,IAAM,UAAoB,EAAO,EAAW,GAAQ,4BAA4B,CAAC;CACjF,IAAI,EAAO,SAAS;EAClB,EAAM;EACN;CACF;CAEA,EAAO,iBAAiB,SAAS,GAAO,EAAE,MAAM,GAAK,CAAC;CACtD,IAAI;CACJ,IAAI;EACF,IAAS,EAAK,CAAM;CACtB,SAAS,GAAO;EAEd,AADA,EAAO,oBAAoB,SAAS,CAAK,GACzC,EAAO,CAAK;EACZ;CACF;CAEA,EAAO,MACJ,MAAU;EAET,AADA,EAAO,oBAAoB,SAAS,CAAK,GACzC,EAAQ,CAAK;CACf,IACC,MAAmB;EAElB,AADA,EAAO,oBAAoB,SAAS,CAAK,GACzC,EAAO,CAAK;CACd,CACF;AACF,CAAC;AAoBH,SAAgB,EAA0B,GAAsC;CAC9E,IAAM,IAAQ,EAAkB,CAAO,GACjC,IAAW,EAAwB;CAEzC,OAAO;EACL,IAAI,iBAAiB;GACnB,OAAO,EAAM;EACf;EAEA,UAAU;GAER,AADA,EAAS,QAAQ,GACjB,EAAM,QAAQ;EAChB;EAEA,IAAI,WAAW;GACb,OAAO,EAAM;EACf;EAEA,MAAM,MAAM,GAAS;GACnB,IAAI,EAAM,UAAU,MAAM,IAAI,EAAuB;GAErD,IAAM,IAAU,EAAS,MAAM,GACzB,IAAW,EAAM;GACvB,EAAM,IAAI,EAAQ,QAAQ,CAAQ,CAAC;GAEnC,IAAI;IACF,IAAM,IAAS,MAAM,EAAe,EAAQ,MAAM,EAAQ,MAAM;IAChE,IAAI,CAAC,EAAQ,UAAU,KAAK,EAAM,UAAU;IAE5C,IAAM,IAAQ,EAAQ,QAAQ,CAAM;IAEpC,AADA,EAAQ,SAAS,GAAO,CAAM,GAC9B,EAAM,IAAI,CAAK;GACjB,SAAS,GAAiB;IACxB,IAAI,CAAC,EAAQ,UAAU,KAAK,EAAM,UAAU;IAE5C,IAAM,IAAQ,EAAQ,CAAM;IAE5B,MADA,EAAM,IAAI,EAAQ,QAAQ,GAAU,CAAK,CAAC,GACpC;GACR,UAAU;IACR,EAAQ,OAAO;GACjB;EACF;EAEA,IAAI,QAAQ;GACV,OAAO,EAAM;EACf;EAEA,WAAW,EAAM;CACnB;AACF"}

package/dist/cursorSource.cjs

@@ -1,2 +1,2 @@
-const e=require("./_dev.cjs"),t=require("./asyncSource.cjs"),n=require("./pagination.cjs");var r=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:n.totalItems(e.total)}}),i=(e,t={})=>{if(t.after!==void 0&&t.before!==void 0)throw RangeError(`Cursor query cannot include both after and before`);let r=t.pageSize!==void 0||t.search!==void 0,i=r||`before`in t?void 0:`after`in t?t.after:e.after,a=r||`after`in t?void 0:`before`in t?t.before:e.before;return{...i!==void 0&&{after:i},...a!==void 0&&{before:a},pageSize:n.positiveInteger(t.pageSize??e.pageSize,`pageSize`),search:t.search??e.search}};function a(a){let o=i({pageSize:20,search:``},a.initialQuery),s=t.createAsyncSource({data:[],error:null,isFetching:!1,pagination:r(),query:o}),c=e=>s.fetch({failure:(e,t)=>({...e,error:t,isFetching:!1,pendingQuery:void 0}),load:t=>a.load({query:e,signal:t}),pending:t=>({...t,error:null,isFetching:!0,pendingQuery:e}),success:t=>({data:t.data,error:null,isFetching:!1,pagination:r(t),query:e})}),l=()=>c(o),u=async e=>{let t=i(s.snapshot.pendingQuery??s.snapshot.query,e);n.sameQuery(t,o)||(o=t,await c(t))},d={get disposalSignal(){return s.disposalSignal},dispose:s.dispose,get disposed(){return s.disposed},page:{next(){let e=s.snapshot.pagination.nextCursor;return s.snapshot.isFetching||e===void 0?Promise.resolve():u({after:e})},previous(){let e=s.snapshot.pagination.previousCursor;return s.snapshot.isFetching||e===void 0?Promise.resolve():u({before:e})}},reload:l,setQuery:u,get snapshot(){return s.snapshot},subscribe:s.subscribe,[Symbol.dispose](){d.dispose()}};return a.autoStart!==!1&&l().catch(()=>e.warn(`Initial load failed. Inspect source.snapshot.error.`)),d}exports.createCursorSource=a;
+const e=require("./errors.cjs"),t=require("./asyncSource.cjs"),n=require("./pagination.cjs");var r=(e,t)=>({...t?.nextCursor!==void 0&&{nextCursor:t.nextCursor},pageSize:e,...t?.previousCursor!==void 0&&{previousCursor:t.previousCursor},...t?.totalItems!==void 0&&{totalItems:n.totalItems(t.totalItems)}});function i(i){if(i.after!==void 0&&i.before!==void 0)throw new e.SourcererConfigurationError(`Cursor source cannot start with both after and before`);let a={...i.after!==void 0&&{after:i.after},...i.before!==void 0&&{before:i.before},pageSize:n.positiveInteger(i.pageSize??20,`pageSize`),params:i.params},o=t.createAsyncSource({error:null,items:[],loading:!1,pagination:r(a.pageSize),params:a.params}),s=()=>{if(o.disposed)throw new e.SourcererDisposedError},c=e=>o.fetch({failure:(e,t)=>({...e,error:t,loading:!1,pendingParams:void 0}),load:t=>i.load({...e,signal:t}),pending:t=>({...t,error:null,loading:!0,...Object.is(e.params,t.params)?{}:{pendingParams:e.params}}),success:t=>({error:null,items:[...t.items],loading:!1,pagination:r(e.pageSize,t),params:e.params})}),l={get disposalSignal(){return o.disposalSignal},dispose:o.dispose,get disposed(){return o.disposed},async next(){s();let e=o.state.pagination.nextCursor;o.state.loading||e===void 0||(a={after:e,pageSize:a.pageSize,params:a.params},await c(a))},async previous(){s();let e=o.state.pagination.previousCursor;o.state.loading||e===void 0||(a={before:e,pageSize:a.pageSize,params:a.params},await c(a))},reload(){return c(a)},async setPageSize(e){s();let t=n.positiveInteger(e,`pageSize`);if(t===a.pageSize&&a.after===void 0&&a.before===void 0){if(o.state.loading||o.state.pagination.pageSize===t&&Object.is(o.state.params,a.params))return;await c(a);return}a={pageSize:t,params:a.params},await c(a)},async setParams(e){if(s(),Object.is(e,a.params)){!o.state.loading&&!Object.is(e,o.state.params)&&await c(a);return}a={pageSize:a.pageSize,params:e},await c(a)},get state(){return o.state},subscribe:o.subscribe,[Symbol.dispose](){l.dispose()}};return l}exports.createCursorSource=i;
 //# sourceMappingURL=cursorSource.cjs.map

package/dist/cursorSource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cursorSource.cjs","names":[],"sources":["../src/cursorSource.ts"],"sourcesContent":["import { warn } from './_dev';\nimport { createAsyncSource } from './asyncSource';\nimport { positiveInteger, sameQuery, totalItems } from './pagination';\nimport type { CursorPagination, CursorQuery, CursorQueryPatch, CursorSource, CursorSourceConfig } from './types';\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"],"mappings":"2FAKA,IAAM,EAA6B,IAID,CAChC,QAAS,GAAQ,aAAe,IAAA,GAChC,YAAa,GAAQ,iBAAmB,IAAA,GACxC,KAAM,SACN,GAAI,GAAQ,aAAe,IAAA,IAAa,CAAE,WAAY,EAAO,UAAW,EACxE,GAAI,GAAQ,iBAAmB,IAAA,IAAa,CAAE,eAAgB,EAAO,cAAe,EACpF,GAAI,GAAQ,QAAU,IAAA,IAAa,CAAE,MAAO,EAAA,WAAW,EAAO,KAAK,CAAE,CACvE,GAEM,GACJ,EACA,EAAmC,CAAC,IACX,CACzB,GAAI,EAAM,QAAU,IAAA,IAAa,EAAM,SAAW,IAAA,GAChD,MAAU,WAAW,mDAAmD,EAG1E,IAAM,EAAe,EAAM,WAAa,IAAA,IAAa,EAAM,SAAW,IAAA,GAChE,EAAQ,GAAgB,WAAY,EAAQ,IAAA,GAAY,UAAW,EAAQ,EAAM,MAAQ,EAAQ,MACjG,EAAS,GAAgB,UAAW,EAAQ,IAAA,GAAY,WAAY,EAAQ,EAAM,OAAS,EAAQ,OAEzG,MAAO,CACL,GAAI,IAAU,IAAA,IAAa,CAAE,OAAM,EACnC,GAAI,IAAW,IAAA,IAAa,CAAE,QAAO,EACrC,SAAU,EAAA,gBAAgB,EAAM,UAAY,EAAQ,SAAU,UAAU,EACxE,OAAQ,EAAM,QAAU,EAAQ,MAClC,CACF,EAGA,SAAgB,EACd,EAC0B,CAE1B,IAAI,EAAiB,EAAe,CADS,SAAU,GAAI,OAAQ,EAC/B,EAAc,EAAO,YAAY,EAC/D,EAAc,EAAA,kBAAsE,CACxF,KAAM,CAAC,EACP,MAAO,KACP,WAAY,GACZ,WAAY,EAAiB,EAC7B,MAAO,CACT,CAAC,EAEK,EAAS,GACb,EAAY,MAAM,CAChB,SAAU,EAAU,KAAW,CAAE,GAAG,EAAU,QAAO,WAAY,GAAO,aAAc,IAAA,EAAU,GAChG,KAAO,GAAW,EAAO,KAAK,CAAE,QAAO,QAAO,CAAC,EAC/C,QAAU,IAAc,CAAE,GAAG,EAAU,MAAO,KAAM,WAAY,GAAM,aAAc,CAAM,GAC1F,QAAU,IAAY,CACpB,KAAM,EAAO,KACb,MAAO,KACP,WAAY,GACZ,WAAY,EAAiB,CAAM,EACnC,OACF,EACF,CAAC,EAEG,MAA8B,EAAM,CAAc,EAElD,EAAW,KAAO,IAAoD,CAE1E,IAAM,EAAO,EADG,EAAY,SAAS,cAAgB,EAAY,SAAS,MACrC,CAAK,EAEtC,EAAA,UAAU,EAAM,CAAc,IAElC,EAAiB,EACjB,MAAM,EAAM,CAAI,EAClB,EAEM,EAAmC,CACvC,IAAI,gBAAiB,CACnB,OAAO,EAAY,cACrB,EAEA,QAAS,EAAY,QAErB,IAAI,UAAW,CACb,OAAO,EAAY,QACrB,EAEA,KAAM,CACJ,MAAO,CACL,IAAM,EAAS,EAAY,SAAS,WAAW,WAE/C,OAAO,EAAY,SAAS,YAAc,IAAW,IAAA,GACjD,QAAQ,QAAQ,EAChB,EAAS,CAAE,MAAO,CAAO,CAAC,CAChC,EAEA,UAAW,CACT,IAAM,EAAS,EAAY,SAAS,WAAW,eAE/C,OAAO,EAAY,SAAS,YAAc,IAAW,IAAA,GACjD,QAAQ,QAAQ,EAChB,EAAS,CAAE,OAAQ,CAAO,CAAC,CACjC,CACF,EAEA,SACA,WAEA,IAAI,UAAW,CACb,OAAO,EAAY,QACrB,EAEA,UAAW,EAAY,UAEvB,CAAC,OAAO,UAAW,CACjB,EAAO,QAAQ,CACjB,CACF,EAKA,OAHI,EAAO,YAAc,IACvB,EAAY,CAAC,CAAC,UAAY,EAAA,KAAK,qDAAqD,CAAC,EAEhF,CACT"}
+{"version":3,"file":"cursorSource.cjs","names":[],"sources":["../src/cursorSource.ts"],"sourcesContent":["import { createAsyncSource } from './asyncSource';\nimport { SourcererConfigurationError, SourcererDisposedError } from './errors';\nimport { positiveInteger, totalItems } from './pagination';\nimport type { CursorPagination, CursorResult, CursorSource, CursorSourceConfig, CursorSourceState } from './types';\n\ntype Request<TParams, TCursor> = Readonly<{\n  after?: TCursor;\n  before?: TCursor;\n  pageSize: number;\n  params: TParams;\n}>;\n\nconst createPagination = <TCursor>(\n  pageSize: number,\n  result?: CursorResult<unknown, TCursor>,\n): CursorPagination<TCursor> => ({\n  ...(result?.nextCursor !== undefined && { nextCursor: result.nextCursor }),\n  pageSize,\n  ...(result?.previousCursor !== undefined && { previousCursor: result.previousCursor }),\n  ...(result?.totalItems !== undefined && { totalItems: totalItems(result.totalItems) }),\n});\n\n/** Cursor sources retain committed items and cursors while replacement work is pending. */\nexport function createCursorSource<T, TParams = undefined, TCursor = string>(\n  config: CursorSourceConfig<T, TParams, TCursor>,\n): CursorSource<T, TParams, TCursor> {\n  if (config.after !== undefined && config.before !== undefined) {\n    throw new SourcererConfigurationError('Cursor source cannot start with both after and before');\n  }\n\n  let requested: Request<TParams, TCursor> = {\n    ...(config.after !== undefined && { after: config.after }),\n    ...(config.before !== undefined && { before: config.before }),\n    pageSize: positiveInteger(config.pageSize ?? 20, 'pageSize'),\n    params: config.params as TParams,\n  };\n  const asyncSource = createAsyncSource<CursorSourceState<T, TParams, TCursor>>({\n    error: null,\n    items: [],\n    loading: false,\n    pagination: createPagination(requested.pageSize),\n    params: requested.params,\n  });\n  const assertLive = (): void => {\n    if (asyncSource.disposed) throw new SourcererDisposedError();\n  };\n\n  const fetch = (request: Request<TParams, TCursor>): Promise<void> =>\n    asyncSource.fetch({\n      failure: (previous, error) => ({ ...previous, error, loading: false, pendingParams: undefined }),\n      load: (signal) => config.load({ ...request, signal }),\n      pending: (previous) => ({\n        ...previous,\n        error: null,\n        loading: true,\n        ...(Object.is(request.params, previous.params) ? {} : { pendingParams: request.params }),\n      }),\n      success: (result) => ({\n        error: null,\n        items: [...result.items],\n        loading: false,\n        pagination: createPagination(request.pageSize, result),\n        params: request.params,\n      }),\n    });\n\n  const source: CursorSource<T, TParams, 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    async next() {\n      assertLive();\n      const cursor = asyncSource.state.pagination.nextCursor;\n      if (asyncSource.state.loading || cursor === undefined) return;\n      requested = { after: cursor, pageSize: requested.pageSize, params: requested.params };\n      await fetch(requested);\n    },\n\n    async previous() {\n      assertLive();\n      const cursor = asyncSource.state.pagination.previousCursor;\n      if (asyncSource.state.loading || cursor === undefined) return;\n      requested = { before: cursor, pageSize: requested.pageSize, params: requested.params };\n      await fetch(requested);\n    },\n\n    reload() {\n      return fetch(requested);\n    },\n\n    async setPageSize(pageSize) {\n      assertLive();\n      const normalized = positiveInteger(pageSize, 'pageSize');\n      if (normalized === requested.pageSize && requested.after === undefined && requested.before === undefined) {\n        if (\n          asyncSource.state.loading ||\n          (asyncSource.state.pagination.pageSize === normalized &&\n            Object.is(asyncSource.state.params, requested.params))\n        )\n          return;\n        await fetch(requested);\n        return;\n      }\n      requested = { pageSize: normalized, params: requested.params };\n      await fetch(requested);\n    },\n\n    async setParams(params) {\n      assertLive();\n      if (Object.is(params, requested.params)) {\n        if (!asyncSource.state.loading && !Object.is(params, asyncSource.state.params)) await fetch(requested);\n        return;\n      }\n      requested = { pageSize: requested.pageSize, params };\n      await fetch(requested);\n    },\n\n    get state() {\n      return asyncSource.state;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":"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"}

package/dist/cursorSource.d.ts

@@ -1,4 +1,4 @@
 import type { CursorSource, CursorSourceConfig } from './types';
-/** Cursor sources retain loaded cursors while pendingQuery records newer navigation. */
-export declare function createCursorSource<T, TCursor = string>(config: CursorSourceConfig<T, TCursor>): CursorSource<T, TCursor>;
+/** Cursor sources retain committed items and cursors while replacement work is pending. */
+export declare function createCursorSource<T, TParams = undefined, TCursor = string>(config: CursorSourceConfig<T, TParams, TCursor>): CursorSource<T, TParams, TCursor>;
 //# sourceMappingURL=cursorSource.d.ts.map

package/dist/cursorSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursorSource.d.ts","sourceRoot":"","sources":["../src/cursorSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAmCjH,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,EACpD,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,GACrC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAoF1B"}
+{"version":3,"file":"cursorSource.d.ts","sourceRoot":"","sources":["../src/cursorSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAkC,YAAY,EAAE,kBAAkB,EAAqB,MAAM,SAAS,CAAC;AAmBnH,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,GAAG,MAAM,EACzE,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAC9C,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CA+GnC"}

package/dist/cursorSource.js

@@ -1,62 +1,53 @@
-import { warn as e } from "./_dev.js";
-import { createAsyncSource as t } from "./asyncSource.js";
-import { positiveInteger as n, sameQuery as r, totalItems as i } from "./pagination.js";
+import { SourcererConfigurationError as e, SourcererDisposedError as t } from "./errors.js";
+import { createAsyncSource as n } from "./asyncSource.js";
+import { positiveInteger as r, totalItems as i } from "./pagination.js";
 //#region src/cursorSource.ts
-var a = (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: i(e.total) }
-}), o = (e, t = {}) => {
-	if (t.after !== void 0 && t.before !== void 0) throw RangeError("Cursor query cannot include both after and before");
-	let r = t.pageSize !== void 0 || t.search !== void 0, i = r || "before" in t ? void 0 : "after" in t ? t.after : e.after, a = r || "after" in t ? void 0 : "before" in t ? t.before : e.before;
-	return {
-		...i !== void 0 && { after: i },
-		...a !== void 0 && { before: a },
-		pageSize: n(t.pageSize ?? e.pageSize, "pageSize"),
-		search: t.search ?? e.search
-	};
-};
-function s(n) {
-	let i = o({
-		pageSize: 20,
-		search: ""
-	}, n.initialQuery), s = t({
-		data: [],
+var a = (e, t) => ({
+	...t?.nextCursor !== void 0 && { nextCursor: t.nextCursor },
+	pageSize: e,
+	...t?.previousCursor !== void 0 && { previousCursor: t.previousCursor },
+	...t?.totalItems !== void 0 && { totalItems: i(t.totalItems) }
+});
+function o(i) {
+	if (i.after !== void 0 && i.before !== void 0) throw new e("Cursor source cannot start with both after and before");
+	let o = {
+		...i.after !== void 0 && { after: i.after },
+		...i.before !== void 0 && { before: i.before },
+		pageSize: r(i.pageSize ?? 20, "pageSize"),
+		params: i.params
+	}, s = n({
 		error: null,
-		isFetching: !1,
-		pagination: a(),
-		query: i
-	}), c = (e) => s.fetch({
+		items: [],
+		loading: !1,
+		pagination: a(o.pageSize),
+		params: o.params
+	}), c = () => {
+		if (s.disposed) throw new t();
+	}, l = (e) => s.fetch({
 		failure: (e, t) => ({
 			...e,
 			error: t,
-			isFetching: !1,
-			pendingQuery: void 0
+			loading: !1,
+			pendingParams: void 0
 		}),
-		load: (t) => n.load({
-			query: e,
+		load: (t) => i.load({
+			...e,
 			signal: t
 		}),
 		pending: (t) => ({
 			...t,
 			error: null,
-			isFetching: !0,
-			pendingQuery: e
+			loading: !0,
+			...Object.is(e.params, t.params) ? {} : { pendingParams: e.params }
 		}),
 		success: (t) => ({
-			data: t.data,
 			error: null,
-			isFetching: !1,
-			pagination: a(t),
-			query: e
+			items: [...t.items],
+			loading: !1,
+			pagination: a(e.pageSize, t),
+			params: e.params
 		})
-	}), l = () => c(i), u = async (e) => {
-		let t = o(s.snapshot.pendingQuery ?? s.snapshot.query, e);
-		r(t, i) || (i = t, await c(t));
-	}, d = {
+	}), u = {
 		get disposalSignal() {
 			return s.disposalSignal;
 		},
@@ -64,29 +55,61 @@ function s(n) {
 		get disposed() {
 			return s.disposed;
 		},
-		page: {
-			next() {
-				let e = s.snapshot.pagination.nextCursor;
-				return s.snapshot.isFetching || e === void 0 ? Promise.resolve() : u({ after: e });
-			},
-			previous() {
-				let e = s.snapshot.pagination.previousCursor;
-				return s.snapshot.isFetching || e === void 0 ? Promise.resolve() : u({ before: e });
+		async next() {
+			c();
+			let e = s.state.pagination.nextCursor;
+			s.state.loading || e === void 0 || (o = {
+				after: e,
+				pageSize: o.pageSize,
+				params: o.params
+			}, await l(o));
+		},
+		async previous() {
+			c();
+			let e = s.state.pagination.previousCursor;
+			s.state.loading || e === void 0 || (o = {
+				before: e,
+				pageSize: o.pageSize,
+				params: o.params
+			}, await l(o));
+		},
+		reload() {
+			return l(o);
+		},
+		async setPageSize(e) {
+			c();
+			let t = r(e, "pageSize");
+			if (t === o.pageSize && o.after === void 0 && o.before === void 0) {
+				if (s.state.loading || s.state.pagination.pageSize === t && Object.is(s.state.params, o.params)) return;
+				await l(o);
+				return;
+			}
+			o = {
+				pageSize: t,
+				params: o.params
+			}, await l(o);
+		},
+		async setParams(e) {
+			if (c(), Object.is(e, o.params)) {
+				!s.state.loading && !Object.is(e, s.state.params) && await l(o);
+				return;
 			}
+			o = {
+				pageSize: o.pageSize,
+				params: e
+			}, await l(o);
 		},
-		reload: l,
-		setQuery: u,
-		get snapshot() {
-			return s.snapshot;
+		get state() {
+			return s.state;
 		},
 		subscribe: s.subscribe,
 		[Symbol.dispose]() {
-			d.dispose();
+			u.dispose();
 		}
 	};
-	return n.autoStart !== !1 && l().catch(() => /* @__PURE__ */ e("Initial load failed. Inspect source.snapshot.error.")), d;
+	return u;
 }
 //#endregion
-export { s as createCursorSource };
+export { o as createCursorSource };
 
 //# sourceMappingURL=cursorSource.js.map

package/dist/cursorSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursorSource.js","names":[],"sources":["../src/cursorSource.ts"],"sourcesContent":["import { warn } from './_dev';\nimport { createAsyncSource } from './asyncSource';\nimport { positiveInteger, sameQuery, totalItems } from './pagination';\nimport type { CursorPagination, CursorQuery, CursorQueryPatch, CursorSource, CursorSourceConfig } from './types';\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"],"mappings":";;;;AAKA,IAAM,KAA6B,OAID;CAChC,SAAS,GAAQ,eAAe,KAAA;CAChC,aAAa,GAAQ,mBAAmB,KAAA;CACxC,MAAM;CACN,GAAI,GAAQ,eAAe,KAAA,KAAa,EAAE,YAAY,EAAO,WAAW;CACxE,GAAI,GAAQ,mBAAmB,KAAA,KAAa,EAAE,gBAAgB,EAAO,eAAe;CACpF,GAAI,GAAQ,UAAU,KAAA,KAAa,EAAE,OAAO,EAAW,EAAO,KAAK,EAAE;AACvE,IAEM,KACJ,GACA,IAAmC,CAAC,MACX;CACzB,IAAI,EAAM,UAAU,KAAA,KAAa,EAAM,WAAW,KAAA,GAChD,MAAU,WAAW,mDAAmD;CAG1E,IAAM,IAAe,EAAM,aAAa,KAAA,KAAa,EAAM,WAAW,KAAA,GAChE,IAAQ,KAAgB,YAAY,IAAQ,KAAA,IAAY,WAAW,IAAQ,EAAM,QAAQ,EAAQ,OACjG,IAAS,KAAgB,WAAW,IAAQ,KAAA,IAAY,YAAY,IAAQ,EAAM,SAAS,EAAQ;CAEzG,OAAO;EACL,GAAI,MAAU,KAAA,KAAa,EAAE,SAAM;EACnC,GAAI,MAAW,KAAA,KAAa,EAAE,UAAO;EACrC,UAAU,EAAgB,EAAM,YAAY,EAAQ,UAAU,UAAU;EACxE,QAAQ,EAAM,UAAU,EAAQ;CAClC;AACF;AAGA,SAAgB,EACd,GAC0B;CAE1B,IAAI,IAAiB,EAAe;EADS,UAAU;EAAI,QAAQ;CAC/B,GAAc,EAAO,YAAY,GAC/D,IAAc,EAAsE;EACxF,MAAM,CAAC;EACP,OAAO;EACP,YAAY;EACZ,YAAY,EAAiB;EAC7B,OAAO;CACT,CAAC,GAEK,KAAS,MACb,EAAY,MAAM;EAChB,UAAU,GAAU,OAAW;GAAE,GAAG;GAAU;GAAO,YAAY;GAAO,cAAc,KAAA;EAAU;EAChG,OAAO,MAAW,EAAO,KAAK;GAAE;GAAO;EAAO,CAAC;EAC/C,UAAU,OAAc;GAAE,GAAG;GAAU,OAAO;GAAM,YAAY;GAAM,cAAc;EAAM;EAC1F,UAAU,OAAY;GACpB,MAAM,EAAO;GACb,OAAO;GACP,YAAY;GACZ,YAAY,EAAiB,CAAM;GACnC;EACF;CACF,CAAC,GAEG,UAA8B,EAAM,CAAc,GAElD,IAAW,OAAO,MAAoD;EAE1E,IAAM,IAAO,EADG,EAAY,SAAS,gBAAgB,EAAY,SAAS,OACrC,CAAK;EAEtC,EAAU,GAAM,CAAc,MAElC,IAAiB,GACjB,MAAM,EAAM,CAAI;CAClB,GAEM,IAAmC;EACvC,IAAI,iBAAiB;GACnB,OAAO,EAAY;EACrB;EAEA,SAAS,EAAY;EAErB,IAAI,WAAW;GACb,OAAO,EAAY;EACrB;EAEA,MAAM;GACJ,OAAO;IACL,IAAM,IAAS,EAAY,SAAS,WAAW;IAE/C,OAAO,EAAY,SAAS,cAAc,MAAW,KAAA,IACjD,QAAQ,QAAQ,IAChB,EAAS,EAAE,OAAO,EAAO,CAAC;GAChC;GAEA,WAAW;IACT,IAAM,IAAS,EAAY,SAAS,WAAW;IAE/C,OAAO,EAAY,SAAS,cAAc,MAAW,KAAA,IACjD,QAAQ,QAAQ,IAChB,EAAS,EAAE,QAAQ,EAAO,CAAC;GACjC;EACF;EAEA;EACA;EAEA,IAAI,WAAW;GACb,OAAO,EAAY;EACrB;EAEA,WAAW,EAAY;EAEvB,CAAC,OAAO,WAAW;GACjB,EAAO,QAAQ;EACjB;CACF;CAKA,OAHI,EAAO,cAAc,MACvB,EAAY,CAAC,CAAC,YAAY,kBAAK,qDAAqD,CAAC,GAEhF;AACT"}
+{"version":3,"file":"cursorSource.js","names":[],"sources":["../src/cursorSource.ts"],"sourcesContent":["import { createAsyncSource } from './asyncSource';\nimport { SourcererConfigurationError, SourcererDisposedError } from './errors';\nimport { positiveInteger, totalItems } from './pagination';\nimport type { CursorPagination, CursorResult, CursorSource, CursorSourceConfig, CursorSourceState } from './types';\n\ntype Request<TParams, TCursor> = Readonly<{\n  after?: TCursor;\n  before?: TCursor;\n  pageSize: number;\n  params: TParams;\n}>;\n\nconst createPagination = <TCursor>(\n  pageSize: number,\n  result?: CursorResult<unknown, TCursor>,\n): CursorPagination<TCursor> => ({\n  ...(result?.nextCursor !== undefined && { nextCursor: result.nextCursor }),\n  pageSize,\n  ...(result?.previousCursor !== undefined && { previousCursor: result.previousCursor }),\n  ...(result?.totalItems !== undefined && { totalItems: totalItems(result.totalItems) }),\n});\n\n/** Cursor sources retain committed items and cursors while replacement work is pending. */\nexport function createCursorSource<T, TParams = undefined, TCursor = string>(\n  config: CursorSourceConfig<T, TParams, TCursor>,\n): CursorSource<T, TParams, TCursor> {\n  if (config.after !== undefined && config.before !== undefined) {\n    throw new SourcererConfigurationError('Cursor source cannot start with both after and before');\n  }\n\n  let requested: Request<TParams, TCursor> = {\n    ...(config.after !== undefined && { after: config.after }),\n    ...(config.before !== undefined && { before: config.before }),\n    pageSize: positiveInteger(config.pageSize ?? 20, 'pageSize'),\n    params: config.params as TParams,\n  };\n  const asyncSource = createAsyncSource<CursorSourceState<T, TParams, TCursor>>({\n    error: null,\n    items: [],\n    loading: false,\n    pagination: createPagination(requested.pageSize),\n    params: requested.params,\n  });\n  const assertLive = (): void => {\n    if (asyncSource.disposed) throw new SourcererDisposedError();\n  };\n\n  const fetch = (request: Request<TParams, TCursor>): Promise<void> =>\n    asyncSource.fetch({\n      failure: (previous, error) => ({ ...previous, error, loading: false, pendingParams: undefined }),\n      load: (signal) => config.load({ ...request, signal }),\n      pending: (previous) => ({\n        ...previous,\n        error: null,\n        loading: true,\n        ...(Object.is(request.params, previous.params) ? {} : { pendingParams: request.params }),\n      }),\n      success: (result) => ({\n        error: null,\n        items: [...result.items],\n        loading: false,\n        pagination: createPagination(request.pageSize, result),\n        params: request.params,\n      }),\n    });\n\n  const source: CursorSource<T, TParams, 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    async next() {\n      assertLive();\n      const cursor = asyncSource.state.pagination.nextCursor;\n      if (asyncSource.state.loading || cursor === undefined) return;\n      requested = { after: cursor, pageSize: requested.pageSize, params: requested.params };\n      await fetch(requested);\n    },\n\n    async previous() {\n      assertLive();\n      const cursor = asyncSource.state.pagination.previousCursor;\n      if (asyncSource.state.loading || cursor === undefined) return;\n      requested = { before: cursor, pageSize: requested.pageSize, params: requested.params };\n      await fetch(requested);\n    },\n\n    reload() {\n      return fetch(requested);\n    },\n\n    async setPageSize(pageSize) {\n      assertLive();\n      const normalized = positiveInteger(pageSize, 'pageSize');\n      if (normalized === requested.pageSize && requested.after === undefined && requested.before === undefined) {\n        if (\n          asyncSource.state.loading ||\n          (asyncSource.state.pagination.pageSize === normalized &&\n            Object.is(asyncSource.state.params, requested.params))\n        )\n          return;\n        await fetch(requested);\n        return;\n      }\n      requested = { pageSize: normalized, params: requested.params };\n      await fetch(requested);\n    },\n\n    async setParams(params) {\n      assertLive();\n      if (Object.is(params, requested.params)) {\n        if (!asyncSource.state.loading && !Object.is(params, asyncSource.state.params)) await fetch(requested);\n        return;\n      }\n      requested = { pageSize: requested.pageSize, params };\n      await fetch(requested);\n    },\n\n    get state() {\n      return asyncSource.state;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":"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"}

package/dist/errors.cjs

@@ -0,0 +1,2 @@
+var e=class extends Error{static errorName=`SourcererError`;constructor(e,t){super(e,t),this.name=new.target.errorName,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{static errorName=`SourcererConfigurationError`},n=class extends e{static errorName=`SourcererDisposedError`;constructor(e=`Sourcerer source disposed`){super(e)}};exports.SourcererConfigurationError=t,exports.SourcererDisposedError=n,exports.SourcererError=e;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all sourcerer errors. Use `instanceof SourcererError` to catch any sourcerer-originated error. */\nexport class SourcererError extends Error {\n  protected static readonly errorName: string = 'SourcererError';\n\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = (new.target as typeof SourcererError).errorName;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a source is configured or queried with invalid arguments. */\nexport class SourcererConfigurationError extends SourcererError {\n  protected static override readonly errorName = 'SourcererConfigurationError';\n}\n\nexport class SourcererDisposedError extends SourcererError {\n  protected static override readonly errorName = 'SourcererDisposedError';\n\n  constructor(message = 'Sourcerer source disposed') {\n    super(message);\n  }\n}\n"],"mappings":"AACA,IAAa,EAAb,cAAoC,KAAM,CACxC,OAA0B,UAAoB,iBAE9C,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAQ,WAAqC,UAClD,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,EAAb,cAAiD,CAAe,CAC9D,OAAmC,UAAY,6BACjD,EAEa,EAAb,cAA4C,CAAe,CACzD,OAAmC,UAAY,yBAE/C,YAAY,EAAU,4BAA6B,CACjD,MAAM,CAAO,CACf,CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+/** Base class for all sourcerer errors. Use `instanceof SourcererError` to catch any sourcerer-originated error. */
+export declare class SourcererError extends Error {
+    protected static readonly errorName: string;
+    constructor(message: string, opts?: ErrorOptions);
+}
+/** Thrown when a source is configured or queried with invalid arguments. */
+export declare class SourcererConfigurationError extends SourcererError {
+    protected static readonly errorName = "SourcererConfigurationError";
+}
+export declare class SourcererDisposedError extends SourcererError {
+    protected static readonly errorName = "SourcererDisposedError";
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAoB;gBAEnD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAKjD;AAED,4EAA4E;AAC5E,qBAAa,2BAA4B,SAAQ,cAAc;IAC7D,0BAAmC,SAAS,iCAAiC;CAC9E;AAED,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,0BAAmC,SAAS,4BAA4B;gBAE5D,OAAO,SAA8B;CAGlD"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+//#region src/errors.ts
+var e = class extends Error {
+	static errorName = "SourcererError";
+	constructor(e, t) {
+		super(e, t), this.name = new.target.errorName, Object.setPrototypeOf(this, new.target.prototype);
+	}
+}, t = class extends e {
+	static errorName = "SourcererConfigurationError";
+}, n = class extends e {
+	static errorName = "SourcererDisposedError";
+	constructor(e = "Sourcerer source disposed") {
+		super(e);
+	}
+};
+//#endregion
+export { t as SourcererConfigurationError, n as SourcererDisposedError, e as SourcererError };
+
+//# sourceMappingURL=errors.js.map