@vielzeug/sourcerer 1.1.0 → 2.0.1

package/dist/_utils.d.ts

@@ -1,28 +0,0 @@
-import { hash, retry } from '@vielzeug/arsenal';
-export { retry };
-export declare const defaultKeyOf: typeof hash;
-/** Extracts a user-facing error message from a caught exception. */
-export declare const extractError: (reason: unknown) => string;
-/** Default exponential backoff: 1 s, 2 s, 4 s, … capped at 30 s. Receives a 0-indexed failure count. */
-export declare const defaultRetryDelay: (attempt: number) => number;
-/**
- * Strips control characters (which could otherwise inject terminal escape sequences into
- * `console.warn`/`console.debug` output) and caps length before interpolating caller- or
- * user-controlled text into a dev warning. Same approach as `@vielzeug/forge`'s
- * `sanitizeForLog` — duplicated rather than shared, per this repo's zero-cross-package-utility
- * convention for internal-only helpers.
- */
-export declare function sanitizeForLog(text: string, maxLength?: number): string;
-/**
- * Coerces a user-supplied `limit`/`page`/target value to a positive integer, warning once per
- * `(apiLabel, fieldName)` call site in dev when the raw input needed clamping (negative, zero,
- * or non-finite) — every source factory previously did `Math.max(1, Math.trunc(value))`
- * silently, so a typo'd or miscalculated config value (e.g. `limit: -1`) produced no signal at
- * all. The once-per-call-site de-dup matters here specifically because `limit`/`page` reach this
- * function via `patch()`, which realistically sits behind live UI (a numeric input, a stepper) —
- * without it, a single persistently-invalid bound value would re-warn on every keystroke.
- * Fractional inputs (e.g. `2.5`) are truncated without a warning — that's a harmless
- * normalization, not a likely mistake.
- */
-export declare function clampPositiveInt(value: number, apiLabel: string, fieldName: string): number;
-//# sourceMappingURL=_utils.d.ts.map

package/dist/_utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../src/_utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,IAAI,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,EAAE,KAAK,EAAE,CAAC;AAGjB,eAAO,MAAM,YAAY,aAAO,CAAC;AAEjC,oEAAoE;AACpE,eAAO,MAAM,YAAY,GAAI,QAAQ,OAAO,KAAG,MAM9C,CAAC;AAEF,wGAAwG;AACxG,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,MAA0B,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAEpE;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAe3F"}

package/dist/_utils.js

@@ -1,20 +0,0 @@
-import { devOnly as e, warn as t } from "./_dev.js";
-import { backoff as n, hash as r, retry as i } from "@vielzeug/arsenal";
-//#region src/_utils.ts
-var a = r, o = (e) => e instanceof Error ? e.message : typeof e == "string" && e.length > 0 ? e : "Request failed", s = (e) => n(e);
-function c(e, t = 200) {
-	return e.replace(/\p{C}/gu, "?").slice(0, t);
-}
-var l = /* @__PURE__ */ new Set();
-function u(n, r, i) {
-	let a = Number.isFinite(n) ? Math.max(1, Math.trunc(n)) : 1;
-	if (!Number.isFinite(n) || n < 1) {
-		let o = `${r}:${i}`;
-		l.has(o) || (l.add(o), e(() => t(`${r}: ${i} ${n} is invalid — clamped to ${a}. Must be a positive integer.`)));
-	}
-	return a;
-}
-//#endregion
-export { u as clampPositiveInt, a as defaultKeyOf, s as defaultRetryDelay, o as extractError, i as retry, c as sanitizeForLog };
-
-//# sourceMappingURL=_utils.js.map

package/dist/_utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_utils.js","names":[],"sources":["../src/_utils.ts"],"sourcesContent":["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"],"mappings":";;;AAOA,IAAa,IAAe,GAGf,KAAgB,MACvB,aAAkB,QAAc,EAAO,UAEvC,OAAO,KAAW,YAAY,EAAO,SAAS,IAAU,IAErD,kBAII,KAAqB,MAA4B,EAAQ,CAAO;AAS7E,SAAgB,EAAe,GAAc,IAAY,KAAa;CACpE,OAAO,EAAK,QAAQ,WAAW,GAAG,CAAC,CAAC,MAAM,GAAG,CAAS;AACxD;AAEA,IAAM,oBAAe,IAAI,IAAY;AAarC,SAAgB,EAAiB,GAAe,GAAkB,GAA2B;CAC3F,IAAM,IAAU,OAAO,SAAS,CAAK,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,CAAK,CAAC,IAAI;CAE1E,IAAI,CAAC,OAAO,SAAS,CAAK,KAAK,IAAQ,GAAG;EACxC,IAAM,IAAM,GAAG,EAAS,GAAG;EAE3B,AAAK,EAAa,IAAI,CAAG,MACvB,EAAa,IAAI,CAAG,GACpB,QACE,EAAK,GAAG,EAAS,IAAI,EAAU,GAAG,EAAM,2BAA2B,EAAQ,8BAA8B,CAC3G;CAEJ;CAEA,OAAO;AACT"}

package/dist/asyncSearch.cjs

@@ -1,2 +0,0 @@
-function e(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()}}}exports.createAsyncSearchCoordinator=e;
-//# sourceMappingURL=asyncSearch.cjs.map

package/dist/asyncSearch.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"asyncSearch.cjs","names":[],"sources":["../src/asyncSearch.ts"],"sourcesContent":["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"],"mappings":"AAaA,SAAgB,EAA6B,EAAkB,EAA4C,CACzG,IAAI,EAAsC,KAEpC,MAAuB,CAC3B,AAEE,KADA,EAAe,EACE,KAErB,EAEA,MAAO,CACL,QAAS,CACP,EAAK,YAAY,EACjB,EAAe,CACjB,EAEA,SAAU,CACR,EAAe,CACjB,EAEA,SAAS,EAAK,EAAS,CACrB,EAAe,EAEf,IAAM,EAAU,IAAI,QAAe,GAAY,CAC7C,EAAiB,CACnB,CAAC,EAKD,OAHA,EAAK,SAAS,EAAK,CAAO,EAC1B,EAAO,EAEA,CACT,EAEA,aAAa,EAAc,CACrB,IAAiB,GAAG,EAAe,CACzC,CACF,CACF"}

package/dist/asyncSearch.d.ts

@@ -1,13 +0,0 @@
-import type { SourceCore } from './core';
-export type AsyncSearchCoordinator = Readonly<{
-    cancel(): void;
-    dispose(): void;
-    schedule(run: () => void, delayMs: number): Promise<void>;
-    settleIfIdle(pendingCount: number): void;
-}>;
-/**
- * Shared debounced-search promise orchestration for async sources.
- * Keeps search() promise lifecycles consistent across remote/cursor/infinite sources.
- */
-export declare function createAsyncSearchCoordinator(core: SourceCore, notify: () => void): AsyncSearchCoordinator;
-//# sourceMappingURL=asyncSearch.d.ts.map

package/dist/asyncSearch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"asyncSearch.d.ts","sourceRoot":"","sources":["../src/asyncSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,sBAAsB,CAqCzG"}

package/dist/asyncSearch.js

@@ -1,28 +0,0 @@
-//#region src/asyncSearch.ts
-function e(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();
-		}
-	};
-}
-//#endregion
-export { e as createAsyncSearchCoordinator };
-
-//# sourceMappingURL=asyncSearch.js.map

package/dist/asyncSearch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asyncSearch.js","names":[],"sources":["../src/asyncSearch.ts"],"sourcesContent":["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"],"mappings":";AAaA,SAAgB,EAA6B,GAAkB,GAA4C;CACzG,IAAI,IAAsC,MAEpC,UAAuB;EAC3B,AAEE,OADA,EAAe,GACE;CAErB;CAEA,OAAO;EACL,SAAS;GAEP,AADA,EAAK,YAAY,GACjB,EAAe;EACjB;EAEA,UAAU;GACR,EAAe;EACjB;EAEA,SAAS,GAAK,GAAS;GACrB,EAAe;GAEf,IAAM,IAAU,IAAI,SAAe,MAAY;IAC7C,IAAiB;GACnB,CAAC;GAKD,OAHA,EAAK,SAAS,GAAK,CAAO,GAC1B,EAAO,GAEA;EACT;EAEA,aAAa,GAAc;GACzB,AAAI,MAAiB,KAAG,EAAe;EACzC;CACF;AACF"}

package/dist/codecs.cjs

@@ -1,2 +0,0 @@
-const e=require("./_dev.cjs"),t=require("./_utils.cjs"),n=require("./errors.cjs");var r=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},i=(r,i={})=>{let a=r instanceof URLSearchParams?Object.fromEntries(r.entries()):r,{defaultLimit:o=20,strict:s=!1}=i,c=(n,r,i)=>{if(r===void 0)return i;let a=Array.isArray(r)?r[0]:r,o=Number(a);return Number.isInteger(o)&&o>0?o:(e.devOnly(()=>e.warn(`decodeQuery: ${n} "${t.sanitizeForLog(a,80)}" is not a positive integer — using ${i}.`)),i)},l=(e,r)=>{if(r===void 0)return;let i=Array.isArray(r)?r[0]:r;try{return JSON.parse(i)}catch{if(s)throw new n.SourcererError(`Invalid query param "${e}": ${t.sanitizeForLog(i,80)}`);return}},u=a.limit,d=a.page,f=a.search,p=a.filter,m=a.sort,h=p===void 0?void 0:l(`filter`,p),g=m===void 0?void 0:l(`sort`,m);return{...h!==void 0&&{filter:h},...g!==void 0&&{sort:g},...f!==void 0&&{search:Array.isArray(f)?f[0]:f},limit:c(`limit`,u,o),page:c(`page`,d,1)}};exports.decodeQuery=i,exports.encodeQuery=r;
-//# sourceMappingURL=codecs.cjs.map

package/dist/codecs.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"codecs.cjs","names":[],"sources":["../src/codecs.ts"],"sourcesContent":["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"],"mappings":"kFAmBA,IAAa,EACX,GACgB,CAChB,IAAM,EAAoB,CACxB,GAAI,EAAM,QAAU,CAAE,OAAQ,EAAM,MAAO,EAC3C,MAAO,OAAO,EAAM,KAAK,EACzB,KAAM,OAAO,EAAM,IAAI,CACzB,EAEM,EAAK,EAUX,OARI,EAAG,SAAW,IAAA,KAChB,EAAK,OAAY,KAAK,UAAU,EAAG,MAAM,GAGvC,EAAG,OAAS,IAAA,KACd,EAAK,KAAU,KAAK,UAAU,EAAG,IAAI,GAGhC,CACT,EAgBa,GACX,EACA,EAA8B,CAAC,IACkB,CACjD,IAAM,EACJ,aAAkB,gBAAmB,OAAO,YAAY,EAAO,QAAQ,CAAC,EAAyB,EAE7F,CAAE,eAAe,GAAI,SAAS,IAAU,EAYxC,GAAoB,EAAmB,EAAsC,IAA6B,CAC9G,GAAI,IAAU,IAAA,GAAW,OAAO,EAEhC,IAAM,EAAM,MAAM,QAAQ,CAAK,EAAI,EAAM,GAAK,EACxC,EAAI,OAAO,CAAG,EAQpB,OANI,OAAO,UAAU,CAAC,GAAK,EAAI,EAAU,GAEzC,EAAA,YACE,EAAA,KAAK,gBAAgB,EAAU,IAAI,EAAA,eAAe,EAAK,EAAE,EAAE,sCAAsC,EAAS,EAAE,CAC9G,EAEO,EACT,EAIM,GAAa,EAAa,IAAkD,CAChF,GAAI,IAAU,IAAA,GAAW,OAEzB,IAAM,EAAM,MAAM,QAAQ,CAAK,EAAI,EAAM,GAAK,EAE9C,GAAI,CACF,OAAO,KAAK,MAAM,CAAG,CACvB,MAAQ,CACN,GAAI,EAAQ,MAAM,IAAI,EAAA,eAAe,wBAAwB,EAAI,KAAK,EAAA,eAAe,EAAK,EAAE,GAAG,EAE/F,MACF,CACF,EAEM,EAAW,EAAI,MACf,EAAU,EAAI,KACd,EAAY,EAAI,OAChB,EAAY,EAAI,OAChB,EAAU,EAAI,KAEd,EAAS,IAAc,IAAA,GAA6C,IAAA,GAAjC,EAAU,SAAU,CAAS,EAChE,EAAO,IAAY,IAAA,GAAyC,IAAA,GAA7B,EAAU,OAAQ,CAAO,EAU9D,MAAO,CAPL,GAAI,IAAW,IAAA,IAAa,CAAE,QAAO,EACrC,GAAI,IAAS,IAAA,IAAa,CAAE,MAAK,EACjC,GAAI,IAAc,IAAA,IAAa,CAAE,OAAQ,MAAM,QAAQ,CAAS,EAAI,EAAU,GAAK,CAAU,EAC7F,MAAO,EAAiB,QAAS,EAAU,CAAY,EACvD,KAAM,EAAiB,OAAQ,EAAS,CAAC,CAGpC,CACT"}

package/dist/codecs.d.ts

@@ -1,30 +0,0 @@
-import type { QueryParams, QueryParamsInput, RemoteSourceQuery, SourceQuery } from './types';
-/**
- * Serialises a `SourceQuery` or `RemoteSourceQuery` into plain URL-safe string params.
- *
- * ⚠️ `filter` and `sort` are JSON-stringified without a try/catch. A circular object reference
- * throws a native `TypeError` ("Converting circular structure to JSON") straight out of this
- * function — ensure filter/sort values are plain serialisable objects, or wrap the call yourself.
- *
- * ⚠️ Round-trip fidelity: `page` and `limit` must be positive integers. `encodeQuery` will
- * serialise any number (including 0), but `decodeQuery` clamps non-positive values to 1/defaultLimit.
- *
- * `encodeQuery` + `decodeQuery` form a round-trip pair: filter/sort values are JSON-stringified
- * on encode and JSON-parsed on decode.
- */
-export declare const encodeQuery: <TFilter = unknown, TSort = unknown>(query: RemoteSourceQuery<TFilter, TSort> | SourceQuery) => QueryParams;
-export type DecodeQueryOptions = Readonly<{
-    defaultLimit?: number;
-    strict?: boolean;
-}>;
-/**
- * Parses URL query params into a `Partial<RemoteSourceQuery<unknown, unknown>>`.
- * Accepts either a plain `Record<string, string | string[] | undefined>` or a `URLSearchParams` instance.
- *
- * - `filter` and `sort` are JSON-parsed and typed as `unknown` — validate and narrow them
- *   with a runtime schema (e.g. Zod) before passing to `source.patch(...)`.
- * - `search` is omitted from the result when the param is absent (rather than defaulting to `''`).
- * - `limit` and `page` are parsed as positive integers; invalid values fall back to defaults.
- */
-export declare const decodeQuery: (params: QueryParamsInput | URLSearchParams, options?: DecodeQueryOptions) => Partial<RemoteSourceQuery<unknown, unknown>>;
-//# sourceMappingURL=codecs.d.ts.map

package/dist/codecs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../src/codecs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM7F;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAC5D,OAAO,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,WAAW,KACrD,WAkBF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,gBAAgB,GAAG,eAAe,EAC1C,UAAS,kBAAuB,KAC/B,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAiE7C,CAAC"}

package/dist/codecs.js

@@ -1,38 +0,0 @@
-import { devOnly as e, warn as t } from "./_dev.js";
-import { sanitizeForLog as n } from "./_utils.js";
-import { SourcererError as r } from "./errors.js";
-//#region src/codecs.ts
-var i = (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;
-}, a = (i, a = {}) => {
-	let o = i instanceof URLSearchParams ? Object.fromEntries(i.entries()) : i, { defaultLimit: s = 20, strict: c = !1 } = a, l = (r, i, a) => {
-		if (i === void 0) return a;
-		let o = Array.isArray(i) ? i[0] : i, s = Number(o);
-		return Number.isInteger(s) && s > 0 ? s : (e(() => t(`decodeQuery: ${r} "${n(o, 80)}" is not a positive integer — using ${a}.`)), a);
-	}, u = (e, t) => {
-		if (t === void 0) return;
-		let i = Array.isArray(t) ? t[0] : t;
-		try {
-			return JSON.parse(i);
-		} catch {
-			if (c) throw new r(`Invalid query param "${e}": ${n(i, 80)}`);
-			return;
-		}
-	}, d = o.limit, f = o.page, p = o.search, m = o.filter, h = o.sort, g = m === void 0 ? void 0 : u("filter", m), _ = h === void 0 ? void 0 : u("sort", h);
-	return {
-		...g !== void 0 && { filter: g },
-		..._ !== void 0 && { sort: _ },
-		...p !== void 0 && { search: Array.isArray(p) ? p[0] : p },
-		limit: l("limit", d, s),
-		page: l("page", f, 1)
-	};
-};
-//#endregion
-export { a as decodeQuery, i as encodeQuery };
-
-//# sourceMappingURL=codecs.js.map

package/dist/codecs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"codecs.js","names":[],"sources":["../src/codecs.ts"],"sourcesContent":["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"],"mappings":";;;;AAmBA,IAAa,KACX,MACgB;CAChB,IAAM,IAAoB;EACxB,GAAI,EAAM,UAAU,EAAE,QAAQ,EAAM,OAAO;EAC3C,OAAO,OAAO,EAAM,KAAK;EACzB,MAAM,OAAO,EAAM,IAAI;CACzB,GAEM,IAAK;CAUX,OARI,EAAG,WAAW,KAAA,MAChB,EAAK,SAAY,KAAK,UAAU,EAAG,MAAM,IAGvC,EAAG,SAAS,KAAA,MACd,EAAK,OAAU,KAAK,UAAU,EAAG,IAAI,IAGhC;AACT,GAgBa,KACX,GACA,IAA8B,CAAC,MACkB;CACjD,IAAM,IACJ,aAAkB,kBAAmB,OAAO,YAAY,EAAO,QAAQ,CAAC,IAAyB,GAE7F,EAAE,kBAAe,IAAI,YAAS,OAAU,GAYxC,KAAoB,GAAmB,GAAsC,MAA6B;EAC9G,IAAI,MAAU,KAAA,GAAW,OAAO;EAEhC,IAAM,IAAM,MAAM,QAAQ,CAAK,IAAI,EAAM,KAAK,GACxC,IAAI,OAAO,CAAG;EAQpB,OANI,OAAO,UAAU,CAAC,KAAK,IAAI,IAAU,KAEzC,QACE,EAAK,gBAAgB,EAAU,IAAI,EAAe,GAAK,EAAE,EAAE,sCAAsC,EAAS,EAAE,CAC9G,GAEO;CACT,GAIM,KAAa,GAAa,MAAkD;EAChF,IAAI,MAAU,KAAA,GAAW;EAEzB,IAAM,IAAM,MAAM,QAAQ,CAAK,IAAI,EAAM,KAAK;EAE9C,IAAI;GACF,OAAO,KAAK,MAAM,CAAG;EACvB,QAAQ;GACN,IAAI,GAAQ,MAAM,IAAI,EAAe,wBAAwB,EAAI,KAAK,EAAe,GAAK,EAAE,GAAG;GAE/F;EACF;CACF,GAEM,IAAW,EAAI,OACf,IAAU,EAAI,MACd,IAAY,EAAI,QAChB,IAAY,EAAI,QAChB,IAAU,EAAI,MAEd,IAAS,MAAc,KAAA,IAA6C,KAAA,IAAjC,EAAU,UAAU,CAAS,GAChE,IAAO,MAAY,KAAA,IAAyC,KAAA,IAA7B,EAAU,QAAQ,CAAO;CAU9D,OAAO;EAPL,GAAI,MAAW,KAAA,KAAa,EAAE,UAAO;EACrC,GAAI,MAAS,KAAA,KAAa,EAAE,QAAK;EACjC,GAAI,MAAc,KAAA,KAAa,EAAE,QAAQ,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,EAAU;EAC7F,OAAO,EAAiB,SAAS,GAAU,CAAY;EACvD,MAAM,EAAiB,QAAQ,GAAS,CAAC;CAGpC;AACT"}

package/dist/core.cjs

@@ -1,2 +0,0 @@
-const e=require("./errors.cjs");function t(t){let n=new Set,r=new Set,i=new AbortController,a,o=!1;return{cancelTimer(){a&&=(clearTimeout(a),void 0)},get disposalSignal(){return i.signal},dispose(){a&&=(clearTimeout(a),void 0);for(let t of r)t.timeoutId!==void 0&&clearTimeout(t.timeoutId),t.reject(new e.SourcererDisposedError);r.clear(),n.clear(),o=!0,i.abort()},flush(e){return a?(clearTimeout(a),a=void 0,e()):Promise.resolve()},get isDisposed(){return o},get isScheduled(){return a!==void 0},notify(e){if(!o){(e??t?.onBeforeNotify)?.();for(let e of n)e();for(let e of r)e.check()}},ready(t,n){return o?Promise.reject(new e.SourcererDisposedError):t()?Promise.resolve():new Promise((i,a)=>{let o={check:()=>{t()&&(o.timeoutId!==void 0&&clearTimeout(o.timeoutId),r.delete(o),i())},reject:a};n!==void 0&&(o.timeoutId=setTimeout(()=>{r.delete(o),a(new e.SourcererTimeoutError(n))},n)),r.add(o)})},schedule(e,t){o||(a&&clearTimeout(a),a=setTimeout(()=>{a=void 0,e()},t))},subscribe(e){return o?()=>{}:(n.add(e),()=>n.delete(e))}}}exports.createSourceCore=t;
-//# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.cjs","names":[],"sources":["../src/core.ts"],"sourcesContent":["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"],"mappings":"gCA+EA,SAAgB,EAAiB,EAAoD,CACnF,IAAM,EAAY,IAAI,IAChB,EAAe,IAAI,IAKnB,EAAa,IAAI,gBACnB,EACA,EAAW,GAEf,MAAO,CACL,aAAc,CACZ,AAEE,KADA,aAAa,CAAK,EACV,IAAA,GAEZ,EAEA,IAAI,gBAAiB,CACnB,OAAO,EAAW,MACpB,EAEA,SAAU,CACR,AAEE,KADA,aAAa,CAAK,EACV,IAAA,IAGV,IAAK,IAAM,KAAU,EACf,EAAO,YAAc,IAAA,IAAW,aAAa,EAAO,SAAS,EAEjE,EAAO,OAAO,IAAI,EAAA,sBAAwB,EAG5C,EAAa,MAAM,EACnB,EAAU,MAAM,EAChB,EAAW,GACX,EAAW,MAAM,CACnB,EAEA,MAAM,EAAI,CAMR,OALK,GAEL,aAAa,CAAK,EAClB,EAAQ,IAAA,GAED,EAAG,GALS,QAAQ,QAAQ,CAMrC,EAEA,IAAI,YAAa,CACf,OAAO,CACT,EAEA,IAAI,aAAc,CAChB,OAAO,IAAU,IAAA,EACnB,EAEA,OAAO,EAAuB,CACxB,MAEJ,EAAC,GAAY,GAAM,eAAA,GAAkB,EAErC,IAAK,IAAM,KAAY,EACrB,EAAS,EAGX,IAAK,IAAM,KAAU,EACnB,EAAO,MAAM,CAPsB,CASvC,EAEA,MAAM,EAAQ,EAAW,CAKvB,OAJI,EAAiB,QAAQ,OAAO,IAAI,EAAA,sBAAwB,EAE5D,EAAO,EAAU,QAAQ,QAAQ,EAE9B,IAAI,SAAe,EAAS,IAAW,CAC5C,IAAM,EACJ,CACE,UAAa,CACP,EAAO,IACL,EAAO,YAAc,IAAA,IAAW,aAAa,EAAO,SAAS,EAEjE,EAAa,OAAO,CAAM,EAC1B,EAAQ,EAEZ,EACA,QACF,EAEE,IAAc,IAAA,KAChB,EAAO,UAAY,eAAiB,CAClC,EAAa,OAAO,CAAM,EAC1B,EAAO,IAAI,EAAA,sBAAsB,CAAS,CAAC,CAC7C,EAAG,CAAS,GAGd,EAAa,IAAI,CAAM,CACzB,CAAC,CACH,EAEA,SAAS,EAAI,EAAS,CAChB,IAEA,GAAO,aAAa,CAAK,EAE7B,EAAQ,eAAiB,CACvB,EAAQ,IAAA,GACR,EAAG,CACL,EAAG,CAAO,EACZ,EAEA,UAAU,EAAU,CAKlB,OAJI,MAAuB,CAAC,GAE5B,EAAU,IAAI,CAAQ,MAET,EAAU,OAAO,CAAQ,EACxC,CACF,CACF"}

package/dist/core.d.ts

@@ -1,71 +0,0 @@
-/**
- * Shared source infrastructure: change notification, debounce scheduling, and ready() polling.
- * All source factories compose this core rather than duplicating the same patterns.
- *
- * Change notification is a plain `Set<listener>` — deliberately NOT `@vielzeug/ripple`, despite
- * that being the repo-wide convention for "reactive" packages. Tried it; reverted. Two concrete
- * problems, not just aesthetics:
- *
- * 1. `prefetchSource()`/`prefetchSourceAndKeep()` are explicitly documented for SSR, and every
- *    source factory routes through this file's `signal`-backed notify. Ripple's own scheduler
- *    warns that its module-level flush queue is shared across concurrent requests in Node.js
- *    unless the caller opts into `@vielzeug/ripple/ssr`'s per-request isolation — a real,
- *    unaddressed risk in exactly the code path meant to run on a server handling concurrent
- *    requests.
- * 2. `subscribe()`'s public contract is "fire on every notify()", not per-field reactivity —
- *    ripple's dependency-tracking machinery (a real subscription object per `watch()` call)
- *    buys nothing over a bare `Set.add()` for that contract, since there's exactly one thing
- *    ever being watched (an internal version counter, not real data).
- *
- * `current`/`meta` themselves were never ripple signals either way — the public shape has
- * always been plain getters + `subscribe()`, framework-agnostic by design (see `types.ts`'s
- * `ReactiveSource` doc comment). Nothing about restoring a plain `Set` changes that contract.
- *
- * Debounce scheduling and `ready()`'s "resolve when idle, with a timeout" polling were never
- * ripple's job either way: ripple is a dependency-tracking signal system ("notify when a value
- * changes"), not an async-coordination library ("wait for a condition, with a timeout, and
- * reject if disposed first").
- */
-export type SourceCore = {
-    /** Cancels any pending timer without invoking the callback. */
-    cancelTimer(): void;
-    /** `AbortSignal` that is aborted when `dispose()` is called. */
-    readonly disposalSignal: AbortSignal;
-    /**
-     * Clears all listeners, cancels any pending timer, and marks the core as disposed.
-     * Subsequent method calls on the core become no-ops.
-     */
-    dispose(): void;
-    /**
-     * If a timer is scheduled, cancels it and immediately invokes `fn`.
-     * Returns a resolved Promise when no timer is pending.
-     */
-    flush(fn: () => Promise<void>): Promise<void>;
-    /** Whether `dispose()` has been called. All methods become no-ops after disposal. */
-    readonly isDisposed: boolean;
-    /** Whether a debounce timer is currently scheduled (drives `meta.isSearchPending`). */
-    readonly isScheduled: boolean;
-    /**
-     * Fire all registered listeners and wake any `ready()` waiters.
-     * When provided, `onBefore` runs once before listeners are called — use it to
-     * refresh cached meta/current before subscribers observe the new state.
-     */
-    notify(onBefore?: () => void): void;
-    /**
-     * Returns a Promise that resolves when `isIdle()` returns true.
-     * Resolves synchronously if already idle.
-     * Rejects with a `TimeoutError` after `timeoutMs` ms if still not idle.
-     */
-    ready(isIdle: () => boolean, timeoutMs?: number): Promise<void>;
-    /**
-     * Schedules a debounced callback, replacing any pending timer.
-     * The callback is invoked after `delayMs` ms of inactivity.
-     */
-    schedule(fn: () => void, delayMs: number): void;
-    /** Subscribe to change notifications. Returns an unsubscribe function. */
-    subscribe(listener: () => void): () => void;
-};
-export declare function createSourceCore(opts?: {
-    onBeforeNotify?: () => void;
-}): SourceCore;
-//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,+DAA+D;IAC/D,WAAW,IAAI,IAAI,CAAC;IAEpB,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IAErC;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,uFAAuF;IACvF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEpC;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,UAAU,CAyHnF"}

package/dist/core.js

@@ -1,59 +0,0 @@
-import { SourcererDisposedError as e, SourcererTimeoutError as t } from "./errors.js";
-//#region src/core.ts
-function n(n) {
-	let r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), a = new AbortController(), o, s = !1;
-	return {
-		cancelTimer() {
-			o &&= (clearTimeout(o), void 0);
-		},
-		get disposalSignal() {
-			return a.signal;
-		},
-		dispose() {
-			o &&= (clearTimeout(o), void 0);
-			for (let t of i) t.timeoutId !== void 0 && clearTimeout(t.timeoutId), t.reject(new e());
-			i.clear(), r.clear(), s = !0, a.abort();
-		},
-		flush(e) {
-			return o ? (clearTimeout(o), o = void 0, e()) : Promise.resolve();
-		},
-		get isDisposed() {
-			return s;
-		},
-		get isScheduled() {
-			return o !== void 0;
-		},
-		notify(e) {
-			if (!s) {
-				(e ?? n?.onBeforeNotify)?.();
-				for (let e of r) e();
-				for (let e of i) e.check();
-			}
-		},
-		ready(n, r) {
-			return s ? Promise.reject(new e()) : n() ? Promise.resolve() : new Promise((e, a) => {
-				let o = {
-					check: () => {
-						n() && (o.timeoutId !== void 0 && clearTimeout(o.timeoutId), i.delete(o), e());
-					},
-					reject: a
-				};
-				r !== void 0 && (o.timeoutId = setTimeout(() => {
-					i.delete(o), a(new t(r));
-				}, r)), i.add(o);
-			});
-		},
-		schedule(e, t) {
-			s || (o && clearTimeout(o), o = setTimeout(() => {
-				o = void 0, e();
-			}, t));
-		},
-		subscribe(e) {
-			return s ? () => {} : (r.add(e), () => r.delete(e));
-		}
-	};
-}
-//#endregion
-export { n as createSourceCore };
-
-//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["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"],"mappings":";;AA+EA,SAAgB,EAAiB,GAAoD;CACnF,IAAM,oBAAY,IAAI,IAAgB,GAChC,oBAAe,IAAI,IAItB,GACG,IAAa,IAAI,gBAAgB,GACnC,GACA,IAAW;CAEf,OAAO;EACL,cAAc;GACZ,AAEE,OADA,aAAa,CAAK,GACV,KAAA;EAEZ;EAEA,IAAI,iBAAiB;GACnB,OAAO,EAAW;EACpB;EAEA,UAAU;GACR,AAEE,OADA,aAAa,CAAK,GACV,KAAA;GAGV,KAAK,IAAM,KAAU,GAGnB,AAFI,EAAO,cAAc,KAAA,KAAW,aAAa,EAAO,SAAS,GAEjE,EAAO,OAAO,IAAI,EAAuB,CAAC;GAM5C,AAHA,EAAa,MAAM,GACnB,EAAU,MAAM,GAChB,IAAW,IACX,EAAW,MAAM;EACnB;EAEA,MAAM,GAAI;GAMR,OALK,KAEL,aAAa,CAAK,GAClB,IAAQ,KAAA,GAED,EAAG,KALS,QAAQ,QAAQ;EAMrC;EAEA,IAAI,aAAa;GACf,OAAO;EACT;EAEA,IAAI,cAAc;GAChB,OAAO,MAAU,KAAA;EACnB;EAEA,OAAO,GAAuB;GACxB,QAEJ;KAAC,KAAY,GAAM,eAAA,GAAkB;IAErC,KAAK,IAAM,KAAY,GACrB,EAAS;IAGX,KAAK,IAAM,KAAU,GACnB,EAAO,MAAM;GAPsB;EASvC;EAEA,MAAM,GAAQ,GAAW;GAKvB,OAJI,IAAiB,QAAQ,OAAO,IAAI,EAAuB,CAAC,IAE5D,EAAO,IAAU,QAAQ,QAAQ,IAE9B,IAAI,SAAe,GAAS,MAAW;IAC5C,IAAM,IACJ;KACE,aAAa;MACX,AAAI,EAAO,MACL,EAAO,cAAc,KAAA,KAAW,aAAa,EAAO,SAAS,GAEjE,EAAa,OAAO,CAAM,GAC1B,EAAQ;KAEZ;KACA;IACF;IASF,AAPI,MAAc,KAAA,MAChB,EAAO,YAAY,iBAAiB;KAElC,AADA,EAAa,OAAO,CAAM,GAC1B,EAAO,IAAI,EAAsB,CAAS,CAAC;IAC7C,GAAG,CAAS,IAGd,EAAa,IAAI,CAAM;GACzB,CAAC;EACH;EAEA,SAAS,GAAI,GAAS;GAChB,MAEA,KAAO,aAAa,CAAK,GAE7B,IAAQ,iBAAiB;IAEvB,AADA,IAAQ,KAAA,GACR,EAAG;GACL,GAAG,CAAO;EACZ;EAEA,UAAU,GAAU;GAKlB,OAJI,UAAuB,CAAC,KAE5B,EAAU,IAAI,CAAQ,SAET,EAAU,OAAO,CAAQ;EACxC;CACF;AACF"}

package/dist/derive.cjs

@@ -1,2 +0,0 @@
-const e=require("./core.cjs");function t(t,n){let r=e.createSourceCore(),i=[],a=()=>{i=n(t.current)};a();let o=t.subscribe(()=>{a(),r.notify()}),s={get current(){return i},get disposalSignal(){return r.disposalSignal},dispose(){r.isDisposed||(o(),r.dispose())},get disposed(){return r.isDisposed},get meta(){return t.meta},subscribe(e){return r.subscribe(e)},[Symbol.dispose](){s.dispose()}};return t.disposalSignal instanceof AbortSignal&&t.disposalSignal.addEventListener(`abort`,()=>s.dispose(),{once:!0}),s}exports.deriveSource=t;
-//# sourceMappingURL=derive.cjs.map

package/dist/derive.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"derive.cjs","names":[],"sources":["../src/derive.ts"],"sourcesContent":["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"],"mappings":"8BAyBA,SAAgB,EACd,EAMA,EACyB,CACzB,IAAM,EAAO,EAAA,iBAAiB,EAC1B,EAA8B,CAAC,EAE7B,MAAuB,CAC3B,EAAgB,EAAU,EAAO,OAAO,CAC1C,EAEA,EAAe,EAEf,IAAM,EAAoB,EAAO,cAAgB,CAC/C,EAAe,EACf,EAAK,OAAO,CACd,CAAC,EAEK,EAAkC,CACtC,IAAI,SAAU,CACZ,OAAO,CACT,EAEA,IAAI,gBAAiB,CACnB,OAAO,EAAK,cACd,EAEA,SAAU,CACJ,EAAK,aAET,EAAkB,EAClB,EAAK,QAAQ,EACf,EAEA,IAAI,UAAW,CACb,OAAO,EAAK,UACd,EAEA,IAAI,MAAO,CACT,OAAO,EAAO,IAChB,EAEA,UAAU,EAAU,CAClB,OAAO,EAAK,UAAU,CAAQ,CAChC,EAEA,CAAC,OAAO,UAAW,CACjB,EAAO,QAAQ,CACjB,CACF,EAUA,OAJI,EAAO,0BAA0B,aACnC,EAAO,eAAe,iBAAiB,YAAe,EAAO,QAAQ,EAAG,CAAE,KAAM,EAAK,CAAC,EAGjF,CACT"}

package/dist/derive.d.ts

@@ -1,29 +0,0 @@
-import type { DerivedSource } from './types';
-/**
- * Creates a reactive read-only projection derived from a parent source.
- *
- * The derived source mirrors the parent's `meta` and applies `transform` to `current`
- * whenever the parent changes. This is useful for client-side projections (e.g. additional
- * filtering, mapping, or sorting) over a remote source without re-fetching.
- *
- * Call `dispose()` to stop listening to the parent.
- *
- * @example
- * ```ts
- * const source = createRemoteSource<User>({ fetch: fetchUsers, limit: 20 });
- *
- * // Show only active users without re-fetching.
- * const activeUsers = deriveSource(source, (items) => items.filter((u) => u.active));
- *
- * activeUsers.subscribe(() => {
- *   console.log(activeUsers.current, activeUsers.meta.totalItems);
- * });
- * ```
- */
-export declare function deriveSource<T, U, TMeta>(parent: {
-    readonly current: readonly T[];
-    readonly disposalSignal?: AbortSignal;
-    readonly meta: TMeta;
-    subscribe(listener: () => void): () => void;
-}, transform: (items: readonly T[]) => readonly U[]): DerivedSource<U, TMeta>;
-//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EACtC,MAAM,EAAE;IACN,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C,EACD,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,GAC/C,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,CAyDzB"}

package/dist/derive.js

@@ -1,38 +0,0 @@
-import { createSourceCore as e } from "./core.js";
-//#region src/derive.ts
-function t(t, n) {
-	let r = e(), i = [], a = () => {
-		i = n(t.current);
-	};
-	a();
-	let o = t.subscribe(() => {
-		a(), r.notify();
-	}), s = {
-		get current() {
-			return i;
-		},
-		get disposalSignal() {
-			return r.disposalSignal;
-		},
-		dispose() {
-			r.isDisposed || (o(), r.dispose());
-		},
-		get disposed() {
-			return r.isDisposed;
-		},
-		get meta() {
-			return t.meta;
-		},
-		subscribe(e) {
-			return r.subscribe(e);
-		},
-		[Symbol.dispose]() {
-			s.dispose();
-		}
-	};
-	return t.disposalSignal instanceof AbortSignal && t.disposalSignal.addEventListener("abort", () => s.dispose(), { once: !0 }), s;
-}
-//#endregion
-export { t as deriveSource };
-
-//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"derive.js","names":[],"sources":["../src/derive.ts"],"sourcesContent":["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"],"mappings":";;AAyBA,SAAgB,EACd,GAMA,GACyB;CACzB,IAAM,IAAO,EAAiB,GAC1B,IAA8B,CAAC,GAE7B,UAAuB;EAC3B,IAAgB,EAAU,EAAO,OAAO;CAC1C;CAEA,EAAe;CAEf,IAAM,IAAoB,EAAO,gBAAgB;EAE/C,AADA,EAAe,GACf,EAAK,OAAO;CACd,CAAC,GAEK,IAAkC;EACtC,IAAI,UAAU;GACZ,OAAO;EACT;EAEA,IAAI,iBAAiB;GACnB,OAAO,EAAK;EACd;EAEA,UAAU;GACJ,EAAK,eAET,EAAkB,GAClB,EAAK,QAAQ;EACf;EAEA,IAAI,WAAW;GACb,OAAO,EAAK;EACd;EAEA,IAAI,OAAO;GACT,OAAO,EAAO;EAChB;EAEA,UAAU,GAAU;GAClB,OAAO,EAAK,UAAU,CAAQ;EAChC;EAEA,CAAC,OAAO,WAAW;GACjB,EAAO,QAAQ;EACjB;CACF;CAUA,OAJI,EAAO,0BAA0B,eACnC,EAAO,eAAe,iBAAiB,eAAe,EAAO,QAAQ,GAAG,EAAE,MAAM,GAAK,CAAC,GAGjF;AACT"}

package/dist/errors.cjs

@@ -1,2 +0,0 @@
-var e=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}},t=class extends e{timeoutMs;constructor(e){super(`Source.ready() timed out after ${e}ms`),this.timeoutMs=e}},n=class extends e{constructor(){super(`Source disposed while waiting for ready()`)}};exports.SourcererDisposedError=n,exports.SourcererError=e,exports.SourcererTimeoutError=t;
-//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.cjs","names":["#opts"],"sources":["../src/errors.ts"],"sourcesContent":["/**\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"],"mappings":"AA6BA,IAAa,EAAb,MAAa,UAAuB,KAAM,CACxC,GAMA,YACE,EACA,EAII,CAAC,EACL,CACA,MAAM,EAAS,EAAK,QAAU,IAAA,GAAoC,IAAA,GAAxB,CAAE,MAAO,EAAK,KAAM,CAAa,EAC3E,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,SAAS,EAChD,KAAKA,GAAQ,CACf,CAEA,IAAI,SAAkB,CACpB,OAAO,KAAKA,GAAM,SAAW,CAC/B,CAGA,IAAI,SAA6C,CAC/C,OAAO,KAAKA,GAAM,OACpB,CAEA,OAAO,GAAG,EAAqC,CAC7C,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAA2C,CAAe,CAExD,UAEA,YAAY,EAAmB,CAC7B,MAAM,kCAAkC,EAAU,GAAG,EACrD,KAAK,UAAY,CACnB,CACF,EAGa,EAAb,cAA4C,CAAe,CACzD,aAAc,CACZ,MAAM,2CAA2C,CACnD,CACF"}

package/dist/errors.d.ts

@@ -1,62 +0,0 @@
-/**
- * Structured context carried by `SourcererError`.
- * Discriminated on `kind` — narrow with `error.context?.kind` to access typed fields.
- *
- * @example
- * ```ts
- * if (source.meta.error?.context?.kind === 'remote') {
- *   console.log('Failed page', source.meta.error.context.page);
- * }
- * ```
- */
-export type SourcererErrorContext = Readonly<{
-    kind: 'cursor';
-    limit: number;
-    search?: string;
-}> | Readonly<{
-    kind: 'infinite';
-    limit: number;
-    page: number;
-    search?: string;
-}> | Readonly<{
-    kind: 'remote';
-    limit: number;
-    page: number;
-    search?: string;
-}>;
-/**
- * Base class for all sourcerer errors. Catch with `instanceof SourcererError` to handle any
- * sourcerer-originated error regardless of specific subtype.
- *
- * Carries the original cause, structured context, and the attempt number.
- *
- * @example
- * ```ts
- * if (source.meta.error) {
- *   console.error(source.meta.error.message, source.meta.error.context);
- * }
- * ```
- */
-export declare class SourcererError extends Error {
-    #private;
-    constructor(message: string, opts?: {
-        readonly attempt?: number;
-        readonly cause?: unknown;
-        readonly context?: SourcererErrorContext;
-    });
-    get attempt(): number;
-    /** Context bag for the error — safe to log. */
-    get context(): SourcererErrorContext | undefined;
-    static is(err: unknown): err is SourcererError;
-}
-/** Thrown by `ready()` when the source timed out waiting for the first successful fetch. */
-export declare class SourcererTimeoutError extends SourcererError {
-    /** The configured timeout in milliseconds. */
-    readonly timeoutMs: number;
-    constructor(timeoutMs: number);
-}
-/** Thrown by `ready()` when the source is disposed while waiting. */
-export declare class SourcererDisposedError extends SourcererError {
-    constructor();
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5D,QAAQ,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5E,QAAQ,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/E;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,SAAQ,KAAK;;gBAQrC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;QACJ,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;KACrC;IAQR,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,+CAA+C;IAC/C,IAAI,OAAO,IAAI,qBAAqB,GAAG,SAAS,CAE/C;IAED,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc;CAG/C;AAED,4FAA4F;AAC5F,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAI9B;AAED,qEAAqE;AACrE,qBAAa,sBAAuB,SAAQ,cAAc;;CAIzD"}