@vielzeug/courier 1.1.4 → 2.0.0

package/dist/query-cache.d.ts

@@ -1,88 +0,0 @@
-import type { RetryOptions } from './retry';
-import type { QueryKey } from './types';
-export declare const DEFAULT_GC: number;
-export type QueryFn<T> = (ctx: QueryFnContext) => Promise<T>;
-export type QueryFnContext = {
-    key: QueryKey;
-    signal: AbortSignal;
-};
-export type FetchConfig<T = unknown> = {
-    delay: RetryOptions['delay'];
-    fn: QueryFn<T>;
-    gcTime: number;
-    shouldRetry: RetryOptions['shouldRetry'];
-    staleTime: number;
-    times: number;
-};
-export type EntryStatus = 'loading' | 'success' | 'error';
-export type CacheEntry<T = unknown> = {
-    data: T | undefined;
-    error: Error | null;
-    hash: string;
-    inflight: {
-        controller: AbortController;
-        promise: Promise<T>;
-    } | null;
-    isFetching: boolean;
-    key: QueryKey;
-    lastConfig: FetchConfig<T> | undefined;
-    observers: Set<import('./query-observe').QueryObserver<unknown, unknown>>;
-    segmentHashes: readonly string[];
-    status: EntryStatus;
-    updatedAt: number | undefined;
-};
-export type EntrySnapshot<T> = {
-    data: T | undefined;
-    error: Error | null;
-    status: EntryStatus;
-    updatedAt: number | undefined;
-};
-export type CacheContext = {
-    delayDefault: RetryOptions['delay'];
-    disposed: boolean;
-    entries: Map<string, CacheEntry>;
-    gcTimeDefault: number;
-    gcTimers: Map<string, ReturnType<typeof setTimeout>>;
-    notify: (entry: CacheEntry) => void;
-    shouldRetryDefault: RetryOptions['shouldRetry'];
-    staleTimeDefault: number;
-    timesDefault: number;
-};
-export declare function makeLoadingState(): {
-    data: undefined;
-    error: null;
-    isFetching: true;
-    isLoading: true;
-    status: 'loading';
-    updatedAt: undefined;
-};
-export declare function resolveValue<T>(v: T | (() => T | undefined) | undefined): T | undefined;
-export declare function hashKey(key: QueryKey): string;
-export declare function hashAtom(atom: QueryKey[number]): string;
-export declare function ensureEntry<T>(ctx: CacheContext, key: QueryKey): CacheEntry<T>;
-export declare function cancelGc(ctx: CacheContext, entryHash: string): void;
-export declare function scheduleGc<T>(ctx: CacheContext, entry: CacheEntry<T>, gcTime: number): void;
-export declare function deleteEntry<T>(ctx: CacheContext, entry: CacheEntry<T>): void;
-export declare function isKeyOrPrefix(entry: CacheEntry, prefixHash: readonly string[]): boolean;
-export declare function markFetching<T>(ctx: CacheContext, entry: CacheEntry<T>): void;
-export declare function commitSuccess<T>(ctx: CacheContext, entry: CacheEntry<T>, data: T, gcTime: number): void;
-export declare function commitError<T>(ctx: CacheContext, entry: CacheEntry<T>, error: Error, gcTime: number): void;
-export declare function rollback<T>(ctx: CacheContext, entry: CacheEntry<T>, previous: EntrySnapshot<T>, gcTime: number): void;
-export declare function evictEntry<T>(ctx: CacheContext, entry: CacheEntry<T>): void;
-export declare function startFetch<T>(ctx: CacheContext, entry: CacheEntry<T>, config: FetchConfig<T>): Promise<T>;
-export declare function makeFetchConfig<T>(ctx: CacheContext, options: {
-    delay?: RetryOptions['delay'];
-    fn: QueryFn<T>;
-    gcTime?: number;
-    shouldRetry?: RetryOptions['shouldRetry'];
-    staleTime?: number;
-    times?: number;
-}): FetchConfig<T>;
-export declare function buildCacheContext(opts: {
-    delay?: RetryOptions['delay'];
-    gcTime?: number;
-    shouldRetry?: RetryOptions['shouldRetry'];
-    staleTime?: number;
-    times?: number;
-}, entries: Map<string, CacheEntry>, gcTimers: Map<string, ReturnType<typeof setTimeout>>, notify: (entry: CacheEntry) => void): CacheContext;
-//# sourceMappingURL=query-cache.d.ts.map

package/dist/query-cache.d.ts.map

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

package/dist/query-cache.js

@@ -1,2 +0,0 @@
-import{hash as e}from"./serialize.js";import{resolveRetryDelay as t}from"./retry.js";import{isAbortError as n,retry as r}from"@vielzeug/arsenal";var i=5*6e4;function a(e){return typeof e==`function`?e():e}function o(t){return e(t)}function s(t){return e(t)}function c(t,n){let r=e(n),i=t.entries.get(r);return i||(i={data:void 0,error:null,hash:r,inflight:null,isFetching:!1,key:n,lastConfig:void 0,observers:new Set,segmentHashes:n.map(t=>e(t)),status:`loading`,updatedAt:void 0},t.entries.set(r,i)),i}function l(e,t){let n=e.gcTimers.get(t);n&&(clearTimeout(n),e.gcTimers.delete(t))}function u(e,t,n){if(e.disposed||(l(e,t.hash),t.observers.size>0))return;if(n===0){e.entries.delete(t.hash);return}let r=setTimeout(()=>{let n=e.entries.get(t.hash);!n||n.observers.size>0||n.isFetching||(e.entries.delete(t.hash),e.gcTimers.delete(t.hash))},n);e.gcTimers.set(t.hash,r)}function d(e,t){t.inflight?.controller.abort(),l(e,t.hash),e.entries.delete(t.hash)}function f(e,t){return t.length>e.segmentHashes.length?!1:t.every((t,n)=>t===e.segmentHashes[n])}function p(e,t){t.isFetching=!0,t.status=`loading`,t.error=null,e.notify(t)}function m(e,t,n,r){t.data=n,t.error=null,t.status=`success`,t.updatedAt=Date.now(),t.isFetching=!1,t.inflight=null,u(e,t,r),e.notify(t)}function h(e,t,n,r){t.error=n,t.status=`error`,t.updatedAt=Date.now(),t.isFetching=!1,t.inflight=null,u(e,t,r),e.notify(t)}function g(e,t,n,r){if(t.data=n.data,t.error=n.error,t.status=n.status,t.updatedAt=n.updatedAt,t.isFetching=!1,t.inflight=null,t.observers.size===0&&t.status===`loading`&&t.data===void 0){d(e,t);return}u(e,t,r),e.notify(t)}function _(e,t){if(t.inflight?.controller.abort(),t.observers.size>0){t.inflight=null,t.isFetching=!1,t.status=`loading`,t.data=void 0,t.error=null,t.updatedAt=void 0,e.notify(t);return}d(e,t)}function v(e,i,a){if(i.inflight)return i.inflight.promise;let{delay:o,fn:s,gcTime:c,shouldRetry:l,times:u}=a,d=new AbortController,f={data:i.data,error:i.error,status:i.status,updatedAt:i.updatedAt},_=(async()=>{try{let n=await r(()=>s({key:i.key,signal:d.signal}),{delay:e=>t(e,o),shouldRetry:l,signal:d.signal,times:u});return m(e,i,n,c),n}catch(t){let r=t instanceof Error?t:Error(String(t));throw d.signal.aborted||n(r)?g(e,i,f,c):h(e,i,r,c),r}})();return i.inflight={controller:d,promise:_},p(e,i),_}function y(e,t){return{delay:t.delay??e.delayDefault,fn:t.fn,gcTime:t.gcTime??e.gcTimeDefault,shouldRetry:t.shouldRetry??e.shouldRetryDefault,staleTime:t.staleTime??e.staleTimeDefault,times:t.times??e.timesDefault}}function b(e,t,n,r){return{delayDefault:e.delay,disposed:!1,entries:t,gcTimeDefault:e.gcTime??3e5,gcTimers:n,notify:r,shouldRetryDefault:e.shouldRetry,staleTimeDefault:e.staleTime??0,timesDefault:e.times??1}}export{i as DEFAULT_GC,b as buildCacheContext,l as cancelGc,h as commitError,m as commitSuccess,d as deleteEntry,c as ensureEntry,_ as evictEntry,s as hashAtom,o as hashKey,f as isKeyOrPrefix,y as makeFetchConfig,p as markFetching,a as resolveValue,g as rollback,u as scheduleGc,v as startFetch};
-//# sourceMappingURL=query-cache.js.map

package/dist/query-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"query-cache.js","names":[],"sources":["../src/query-cache.ts"],"sourcesContent":["import { isAbortError, retry } from '@vielzeug/arsenal';\n\nimport type { RetryOptions } from './retry';\nimport type { QueryKey } from './types';\n\nimport { DEFAULT_TIMES, resolveRetryDelay } from './retry';\nimport { hash } from './serialize';\n\nexport const DEFAULT_GC = 5 * 60_000;\n\nexport type QueryFn<T> = (ctx: QueryFnContext) => Promise<T>;\n\nexport type QueryFnContext = {\n  key: QueryKey;\n  signal: AbortSignal;\n};\n\nexport type FetchConfig<T = unknown> = {\n  delay: RetryOptions['delay'];\n  fn: QueryFn<T>;\n  gcTime: number;\n  shouldRetry: RetryOptions['shouldRetry'];\n  staleTime: number;\n  times: number;\n};\n\nexport type EntryStatus = 'loading' | 'success' | 'error';\n\nexport type CacheEntry<T = unknown> = {\n  data: T | undefined;\n  error: Error | null;\n  hash: string;\n  inflight: { controller: AbortController; promise: Promise<T> } | null;\n  isFetching: boolean;\n  key: QueryKey;\n  lastConfig: FetchConfig<T> | undefined;\n  observers: Set<import('./query-observe').QueryObserver<unknown, unknown>>;\n  segmentHashes: readonly string[];\n  status: EntryStatus;\n  updatedAt: number | undefined;\n};\n\nexport type EntrySnapshot<T> = {\n  data: T | undefined;\n  error: Error | null;\n  status: EntryStatus;\n  updatedAt: number | undefined;\n};\n\nexport type CacheContext = {\n  delayDefault: RetryOptions['delay'];\n  disposed: boolean;\n  entries: Map<string, CacheEntry>;\n  gcTimeDefault: number;\n  gcTimers: Map<string, ReturnType<typeof setTimeout>>;\n  notify: (entry: CacheEntry) => void;\n  shouldRetryDefault: RetryOptions['shouldRetry'];\n  staleTimeDefault: number;\n  timesDefault: number;\n};\n\nexport function makeLoadingState(): {\n  data: undefined;\n  error: null;\n  isFetching: true;\n  isLoading: true;\n  status: 'loading';\n  updatedAt: undefined;\n} {\n  return {\n    data: undefined,\n    error: null,\n    isFetching: true,\n    isLoading: true,\n    status: 'loading',\n    updatedAt: undefined,\n  };\n}\n\nexport function resolveValue<T>(v: T | (() => T | undefined) | undefined): T | undefined {\n  return typeof v === 'function' ? (v as () => T | undefined)() : v;\n}\n\nexport function hashKey(key: QueryKey): string {\n  return hash(key);\n}\n\nexport function hashAtom(atom: QueryKey[number]): string {\n  return hash(atom);\n}\n\nexport function ensureEntry<T>(ctx: CacheContext, key: QueryKey): CacheEntry<T> {\n  const entryHash = hash(key);\n  let entry = ctx.entries.get(entryHash) as CacheEntry<T> | undefined;\n\n  if (!entry) {\n    entry = {\n      data: undefined,\n      error: null,\n      hash: entryHash,\n      inflight: null,\n      isFetching: false,\n      key,\n      lastConfig: undefined,\n      observers: new Set(),\n      segmentHashes: key.map((k) => hash(k)),\n      status: 'loading',\n      updatedAt: undefined,\n    };\n    ctx.entries.set(entryHash, entry as CacheEntry<unknown>);\n  }\n\n  return entry;\n}\n\nexport function cancelGc(ctx: CacheContext, entryHash: string): void {\n  const timer = ctx.gcTimers.get(entryHash);\n\n  if (!timer) return;\n\n  clearTimeout(timer);\n  ctx.gcTimers.delete(entryHash);\n}\n\nexport function scheduleGc<T>(ctx: CacheContext, entry: CacheEntry<T>, gcTime: number): void {\n  if (ctx.disposed) return;\n\n  cancelGc(ctx, entry.hash);\n\n  if (entry.observers.size > 0) return;\n\n  if (gcTime === 0) {\n    ctx.entries.delete(entry.hash);\n\n    return;\n  }\n\n  const timer = setTimeout(() => {\n    const current = ctx.entries.get(entry.hash);\n\n    if (!current || current.observers.size > 0 || current.isFetching) return;\n\n    ctx.entries.delete(entry.hash);\n    ctx.gcTimers.delete(entry.hash);\n  }, gcTime);\n\n  ctx.gcTimers.set(entry.hash, timer);\n}\n\nexport function deleteEntry<T>(ctx: CacheContext, entry: CacheEntry<T>): void {\n  entry.inflight?.controller.abort();\n  cancelGc(ctx, entry.hash);\n  ctx.entries.delete(entry.hash);\n}\n\nexport function isKeyOrPrefix(entry: CacheEntry, prefixHash: readonly string[]): boolean {\n  if (prefixHash.length > entry.segmentHashes.length) return false;\n\n  return prefixHash.every((seg, i) => seg === entry.segmentHashes[i]);\n}\n\nexport function markFetching<T>(ctx: CacheContext, entry: CacheEntry<T>): void {\n  entry.isFetching = true;\n  entry.status = 'loading';\n  entry.error = null;\n  ctx.notify(entry);\n}\n\nexport function commitSuccess<T>(ctx: CacheContext, entry: CacheEntry<T>, data: T, gcTime: number): void {\n  entry.data = data;\n  entry.error = null;\n  entry.status = 'success';\n  entry.updatedAt = Date.now();\n  entry.isFetching = false;\n  entry.inflight = null;\n  scheduleGc(ctx, entry, gcTime);\n  ctx.notify(entry);\n}\n\nexport function commitError<T>(ctx: CacheContext, entry: CacheEntry<T>, error: Error, gcTime: number): void {\n  entry.error = error;\n  entry.status = 'error';\n  entry.updatedAt = Date.now();\n  entry.isFetching = false;\n  entry.inflight = null;\n  scheduleGc(ctx, entry, gcTime);\n  ctx.notify(entry);\n}\n\nexport function rollback<T>(ctx: CacheContext, entry: CacheEntry<T>, previous: EntrySnapshot<T>, gcTime: number): void {\n  entry.data = previous.data;\n  entry.error = previous.error;\n  entry.status = previous.status;\n  entry.updatedAt = previous.updatedAt;\n  entry.isFetching = false;\n  entry.inflight = null;\n\n  if (entry.observers.size === 0 && entry.status === 'loading' && entry.data === undefined) {\n    deleteEntry(ctx, entry);\n\n    return;\n  }\n\n  scheduleGc(ctx, entry, gcTime);\n  ctx.notify(entry);\n}\n\nexport function evictEntry<T>(ctx: CacheContext, entry: CacheEntry<T>): void {\n  entry.inflight?.controller.abort();\n\n  if (entry.observers.size > 0) {\n    entry.inflight = null;\n    entry.isFetching = false;\n    entry.status = 'loading';\n    entry.data = undefined;\n    entry.error = null;\n    entry.updatedAt = undefined;\n    ctx.notify(entry);\n\n    return;\n  }\n\n  deleteEntry(ctx, entry);\n}\n\nexport function startFetch<T>(ctx: CacheContext, entry: CacheEntry<T>, config: FetchConfig<T>): Promise<T> {\n  if (entry.inflight) return entry.inflight.promise;\n\n  const { delay, fn, gcTime, shouldRetry, times } = config;\n  const controller = new AbortController();\n  const prev: EntrySnapshot<T> = {\n    data: entry.data,\n    error: entry.error,\n    status: entry.status,\n    updatedAt: entry.updatedAt,\n  };\n\n  const promise = (async () => {\n    try {\n      const data = await retry(() => fn({ key: entry.key, signal: controller.signal }), {\n        delay: (attempt) => resolveRetryDelay(attempt, delay),\n        shouldRetry,\n        signal: controller.signal,\n        times,\n      });\n\n      commitSuccess(ctx, entry, data, gcTime);\n\n      return data;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      const isAborted = controller.signal.aborted || isAbortError(error);\n\n      if (isAborted) {\n        rollback(ctx, entry, prev, gcTime);\n      } else {\n        commitError(ctx, entry, error, gcTime);\n      }\n\n      throw error;\n    }\n  })();\n\n  entry.inflight = { controller, promise };\n  markFetching(ctx, entry);\n\n  return promise;\n}\n\nexport function makeFetchConfig<T>(\n  ctx: CacheContext,\n  options: {\n    delay?: RetryOptions['delay'];\n    fn: QueryFn<T>;\n    gcTime?: number;\n    shouldRetry?: RetryOptions['shouldRetry'];\n    staleTime?: number;\n    times?: number;\n  },\n): FetchConfig<T> {\n  return {\n    delay: options.delay ?? ctx.delayDefault,\n    fn: options.fn,\n    gcTime: options.gcTime ?? ctx.gcTimeDefault,\n    shouldRetry: options.shouldRetry ?? ctx.shouldRetryDefault,\n    staleTime: options.staleTime ?? ctx.staleTimeDefault,\n    times: options.times ?? ctx.timesDefault,\n  };\n}\n\nexport function buildCacheContext(\n  opts: {\n    delay?: RetryOptions['delay'];\n    gcTime?: number;\n    shouldRetry?: RetryOptions['shouldRetry'];\n    staleTime?: number;\n    times?: number;\n  },\n  entries: Map<string, CacheEntry>,\n  gcTimers: Map<string, ReturnType<typeof setTimeout>>,\n  notify: (entry: CacheEntry) => void,\n): CacheContext {\n  return {\n    delayDefault: opts.delay,\n    disposed: false,\n    entries,\n    gcTimeDefault: opts.gcTime ?? DEFAULT_GC,\n    gcTimers,\n    notify,\n    shouldRetryDefault: opts.shouldRetry,\n    staleTimeDefault: opts.staleTime ?? 0,\n    timesDefault: opts.times ?? DEFAULT_TIMES,\n  };\n}\n"],"mappings":"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"}

package/dist/query-observe.cjs

@@ -1,2 +0,0 @@
-const e=require("./query-cache.cjs");var t=Object.freeze({data:void 0,error:null,isFetching:!1,isLoading:!0,status:`loading`,updatedAt:void 0});function n(e){return e.status===`loading`?{data:void 0,error:null,isFetching:e.isFetching,isLoading:!0,status:`loading`,updatedAt:void 0}:e.status===`success`?{data:e.data,error:null,isFetching:e.isFetching,isLoading:!1,status:`success`,updatedAt:e.updatedAt}:{data:e.data,error:e.error,isFetching:e.isFetching,isLoading:!1,status:`error`,updatedAt:e.updatedAt}}function r(t,r){let i=n(t);if(i.status===`loading`){let t=e.resolveValue(r.placeholderData);return{...i,data:t}}let a=r.select?r.select(i.data):i.data;return{...i,data:a}}function i(e){for(let t of e.observers){let n=t,i=r(e,n),a=n.previous,o=Object.is(a?.data,i.data),s=!!a&&a.status===i.status&&a.isFetching===i.isFetching&&Object.is(a.error,i.error);(n.select?s&&o:s&&a?.updatedAt===i.updatedAt&&o)||(n.previous=i,n.listener())}}function a(n,i,a){let o={listener:()=>{},...a};return{peek(){let a=n.entries.get(e.hashKey(i));return a?r(a,o):t},subscribe(t){if(n.disposed)return()=>{};let s=e.ensureEntry(n,i);e.cancelGc(n,s.hash);let c={...a,listener:t,previous:r(s,o)};return s.observers.add(c),()=>{s.observers.delete(c),s.observers.size===0&&e.scheduleGc(n,s,s.lastConfig?.gcTime??n.gcTimeDefault)}}}}exports.notify=i,exports.toBaseState=n,exports.toObserverState=r,exports.watchInternal=a;
-//# sourceMappingURL=query-observe.cjs.map

package/dist/query-observe.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"query-observe.cjs","names":[],"sources":["../src/query-observe.ts"],"sourcesContent":["import type { CacheContext, CacheEntry } from './query-cache';\nimport type { AsyncState, QueryState, SyncStore, Unsubscribe } from './types';\n\nimport { cancelGc, ensureEntry, hashKey, resolveValue, scheduleGc } from './query-cache';\n\nexport type QueryObserver<T, S> = {\n  listener: () => void;\n  placeholderData?: S | (() => S | undefined);\n  previous?: QueryState<S>;\n  select?: (data: T | undefined) => S | undefined;\n};\n\nconst LOADING_STATE: AsyncState<unknown> = Object.freeze({\n  data: undefined,\n  error: null,\n  isFetching: false,\n  isLoading: true,\n  status: 'loading',\n  updatedAt: undefined,\n});\n\nexport function toBaseState<T>(entry: CacheEntry<T>): QueryState<T> {\n  if (entry.status === 'loading') {\n    return {\n      data: undefined,\n      error: null,\n      isFetching: entry.isFetching,\n      isLoading: true,\n      status: 'loading',\n      updatedAt: undefined,\n    } as QueryState<T>;\n  }\n\n  if (entry.status === 'success') {\n    return {\n      data: entry.data as T,\n      error: null,\n      isFetching: entry.isFetching,\n      isLoading: false,\n      status: 'success',\n      updatedAt: entry.updatedAt as number,\n    };\n  }\n\n  return {\n    data: entry.data,\n    error: entry.error as Error,\n    isFetching: entry.isFetching,\n    isLoading: false,\n    status: 'error',\n    updatedAt: entry.updatedAt as number,\n  };\n}\n\nexport function toObserverState<T, S>(entry: CacheEntry<T>, observer: QueryObserver<T, S>): QueryState<S> {\n  const base = toBaseState(entry);\n\n  if (base.status === 'loading') {\n    const placeholder = resolveValue(observer.placeholderData as S | (() => S | undefined) | undefined);\n\n    return { ...base, data: placeholder } as QueryState<S>;\n  }\n\n  const selected = observer.select ? observer.select(base.data as T | undefined) : (base.data as S | undefined);\n\n  return { ...base, data: selected } as QueryState<S>;\n}\n\nexport function notify<T>(entry: CacheEntry<T>): void {\n  for (const observer of entry.observers) {\n    const typed = observer as QueryObserver<T, unknown>;\n    const next = toObserverState(entry, typed);\n    const prev = typed.previous;\n\n    const dataUnchanged = Object.is(prev?.data, next.data);\n    const metaUnchanged =\n      !!prev && prev.status === next.status && prev.isFetching === next.isFetching && Object.is(prev.error, next.error);\n\n    const shouldSkip = typed.select\n      ? metaUnchanged && dataUnchanged\n      : metaUnchanged && prev?.updatedAt === next.updatedAt && dataUnchanged;\n\n    if (shouldSkip) continue;\n\n    typed.previous = next;\n    typed.listener();\n  }\n}\n\nexport function watchInternal<T = unknown, S = T>(\n  ctx: CacheContext,\n  key: Parameters<typeof ensureEntry>[1],\n  opts?: { placeholderData?: S | (() => S | undefined); select?: (data: T | undefined) => S | undefined },\n): SyncStore<QueryState<S>> {\n  const peekObserver: QueryObserver<T, S> = { listener: () => {}, ...opts };\n\n  return {\n    peek(): QueryState<S> {\n      const entry = ctx.entries.get(hashKey(key)) as CacheEntry<T> | undefined;\n\n      if (!entry) return LOADING_STATE as QueryState<S>;\n\n      return toObserverState(entry, peekObserver);\n    },\n\n    subscribe(onStoreChange: () => void): Unsubscribe {\n      if (ctx.disposed) return () => {};\n\n      const entry = ensureEntry<T>(ctx, key);\n\n      cancelGc(ctx, entry.hash);\n\n      const observer: QueryObserver<T, S> = {\n        ...opts,\n        listener: onStoreChange,\n        previous: toObserverState(entry, peekObserver),\n      };\n\n      entry.observers.add(observer as QueryObserver<unknown, unknown>);\n\n      return () => {\n        entry.observers.delete(observer as QueryObserver<unknown, unknown>);\n\n        if (entry.observers.size === 0) {\n          scheduleGc(ctx, entry, entry.lastConfig?.gcTime ?? ctx.gcTimeDefault);\n        }\n      };\n    },\n  };\n}\n"],"mappings":"qCAYA,IAAM,EAAqC,OAAO,OAAO,CACvD,KAAM,IAAA,GACN,MAAO,KACP,WAAY,GACZ,UAAW,GACX,OAAQ,UACR,UAAW,IAAA,EACb,CAAC,EAED,SAAgB,EAAe,EAAqC,CAuBlE,OAtBI,EAAM,SAAW,UACZ,CACL,KAAM,IAAA,GACN,MAAO,KACP,WAAY,EAAM,WAClB,UAAW,GACX,OAAQ,UACR,UAAW,IAAA,EACb,EAGE,EAAM,SAAW,UACZ,CACL,KAAM,EAAM,KACZ,MAAO,KACP,WAAY,EAAM,WAClB,UAAW,GACX,OAAQ,UACR,UAAW,EAAM,SACnB,EAGK,CACL,KAAM,EAAM,KACZ,MAAO,EAAM,MACb,WAAY,EAAM,WAClB,UAAW,GACX,OAAQ,QACR,UAAW,EAAM,SACnB,CACF,CAEA,SAAgB,EAAsB,EAAsB,EAA8C,CACxG,IAAM,EAAO,EAAY,CAAK,EAE9B,GAAI,EAAK,SAAW,UAAW,CAC7B,IAAM,EAAc,EAAA,aAAa,EAAS,eAAwD,EAElG,MAAO,CAAE,GAAG,EAAM,KAAM,CAAY,CACtC,CAEA,IAAM,EAAW,EAAS,OAAS,EAAS,OAAO,EAAK,IAAqB,EAAK,EAAK,KAEvF,MAAO,CAAE,GAAG,EAAM,KAAM,CAAS,CACnC,CAEA,SAAgB,EAAU,EAA4B,CACpD,IAAK,IAAM,KAAY,EAAM,UAAW,CACtC,IAAM,EAAQ,EACR,EAAO,EAAgB,EAAO,CAAK,EACnC,EAAO,EAAM,SAEb,EAAgB,OAAO,GAAG,GAAM,KAAM,EAAK,IAAI,EAC/C,EACJ,CAAC,CAAC,GAAQ,EAAK,SAAW,EAAK,QAAU,EAAK,aAAe,EAAK,YAAc,OAAO,GAAG,EAAK,MAAO,EAAK,KAAK,GAE/F,EAAM,OACrB,GAAiB,EACjB,GAAiB,GAAM,YAAc,EAAK,WAAa,KAI3D,EAAM,SAAW,EACjB,EAAM,SAAS,EACjB,CACF,CAEA,SAAgB,EACd,EACA,EACA,EAC0B,CAC1B,IAAM,EAAoC,CAAE,aAAgB,CAAC,EAAG,GAAG,CAAK,EAExE,MAAO,CACL,MAAsB,CACpB,IAAM,EAAQ,EAAI,QAAQ,IAAI,EAAA,QAAQ,CAAG,CAAC,EAI1C,OAFK,EAEE,EAAgB,EAAO,CAAY,EAFvB,CAGrB,EAEA,UAAU,EAAwC,CAChD,GAAI,EAAI,SAAU,UAAa,CAAC,EAEhC,IAAM,EAAQ,EAAA,YAAe,EAAK,CAAG,EAErC,EAAA,SAAS,EAAK,EAAM,IAAI,EAExB,IAAM,EAAgC,CACpC,GAAG,EACH,SAAU,EACV,SAAU,EAAgB,EAAO,CAAY,CAC/C,EAIA,OAFA,EAAM,UAAU,IAAI,CAA2C,MAElD,CACX,EAAM,UAAU,OAAO,CAA2C,EAE9D,EAAM,UAAU,OAAS,GAC3B,EAAA,WAAW,EAAK,EAAO,EAAM,YAAY,QAAU,EAAI,aAAa,CAExE,CACF,CACF,CACF"}

package/dist/query-observe.d.ts

@@ -1,17 +0,0 @@
-import type { CacheContext, CacheEntry } from './query-cache';
-import type { QueryState, SyncStore } from './types';
-import { ensureEntry } from './query-cache';
-export type QueryObserver<T, S> = {
-    listener: () => void;
-    placeholderData?: S | (() => S | undefined);
-    previous?: QueryState<S>;
-    select?: (data: T | undefined) => S | undefined;
-};
-export declare function toBaseState<T>(entry: CacheEntry<T>): QueryState<T>;
-export declare function toObserverState<T, S>(entry: CacheEntry<T>, observer: QueryObserver<T, S>): QueryState<S>;
-export declare function notify<T>(entry: CacheEntry<T>): void;
-export declare function watchInternal<T = unknown, S = T>(ctx: CacheContext, key: Parameters<typeof ensureEntry>[1], opts?: {
-    placeholderData?: S | (() => S | undefined);
-    select?: (data: T | undefined) => S | undefined;
-}): SyncStore<QueryState<S>>;
-//# sourceMappingURL=query-observe.d.ts.map

package/dist/query-observe.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"query-observe.d.ts","sourceRoot":"","sources":["../src/query-observe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAc,UAAU,EAAE,SAAS,EAAe,MAAM,SAAS,CAAC;AAE9E,OAAO,EAAY,WAAW,EAAqC,MAAM,eAAe,CAAC;AAEzF,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,IAAI;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS,CAAC;CACjD,CAAC;AAWF,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CA+BlE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAYxG;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAmBpD;AAED,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,EAC9C,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,EACtC,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS,CAAA;CAAE,GACtG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAoC1B"}

package/dist/query-observe.js

@@ -1,2 +0,0 @@
-import{cancelGc as e,ensureEntry as t,hashKey as n,resolveValue as r,scheduleGc as i}from"./query-cache.js";var a=Object.freeze({data:void 0,error:null,isFetching:!1,isLoading:!0,status:`loading`,updatedAt:void 0});function o(e){return e.status===`loading`?{data:void 0,error:null,isFetching:e.isFetching,isLoading:!0,status:`loading`,updatedAt:void 0}:e.status===`success`?{data:e.data,error:null,isFetching:e.isFetching,isLoading:!1,status:`success`,updatedAt:e.updatedAt}:{data:e.data,error:e.error,isFetching:e.isFetching,isLoading:!1,status:`error`,updatedAt:e.updatedAt}}function s(e,t){let n=o(e);if(n.status===`loading`){let e=r(t.placeholderData);return{...n,data:e}}let i=t.select?t.select(n.data):n.data;return{...n,data:i}}function c(e){for(let t of e.observers){let n=t,r=s(e,n),i=n.previous,a=Object.is(i?.data,r.data),o=!!i&&i.status===r.status&&i.isFetching===r.isFetching&&Object.is(i.error,r.error);(n.select?o&&a:o&&i?.updatedAt===r.updatedAt&&a)||(n.previous=r,n.listener())}}function l(r,o,c){let l={listener:()=>{},...c};return{peek(){let e=r.entries.get(n(o));return e?s(e,l):a},subscribe(n){if(r.disposed)return()=>{};let a=t(r,o);e(r,a.hash);let u={...c,listener:n,previous:s(a,l)};return a.observers.add(u),()=>{a.observers.delete(u),a.observers.size===0&&i(r,a,a.lastConfig?.gcTime??r.gcTimeDefault)}}}}export{c as notify,o as toBaseState,s as toObserverState,l as watchInternal};
-//# sourceMappingURL=query-observe.js.map

package/dist/query-observe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"query-observe.js","names":[],"sources":["../src/query-observe.ts"],"sourcesContent":["import type { CacheContext, CacheEntry } from './query-cache';\nimport type { AsyncState, QueryState, SyncStore, Unsubscribe } from './types';\n\nimport { cancelGc, ensureEntry, hashKey, resolveValue, scheduleGc } from './query-cache';\n\nexport type QueryObserver<T, S> = {\n  listener: () => void;\n  placeholderData?: S | (() => S | undefined);\n  previous?: QueryState<S>;\n  select?: (data: T | undefined) => S | undefined;\n};\n\nconst LOADING_STATE: AsyncState<unknown> = Object.freeze({\n  data: undefined,\n  error: null,\n  isFetching: false,\n  isLoading: true,\n  status: 'loading',\n  updatedAt: undefined,\n});\n\nexport function toBaseState<T>(entry: CacheEntry<T>): QueryState<T> {\n  if (entry.status === 'loading') {\n    return {\n      data: undefined,\n      error: null,\n      isFetching: entry.isFetching,\n      isLoading: true,\n      status: 'loading',\n      updatedAt: undefined,\n    } as QueryState<T>;\n  }\n\n  if (entry.status === 'success') {\n    return {\n      data: entry.data as T,\n      error: null,\n      isFetching: entry.isFetching,\n      isLoading: false,\n      status: 'success',\n      updatedAt: entry.updatedAt as number,\n    };\n  }\n\n  return {\n    data: entry.data,\n    error: entry.error as Error,\n    isFetching: entry.isFetching,\n    isLoading: false,\n    status: 'error',\n    updatedAt: entry.updatedAt as number,\n  };\n}\n\nexport function toObserverState<T, S>(entry: CacheEntry<T>, observer: QueryObserver<T, S>): QueryState<S> {\n  const base = toBaseState(entry);\n\n  if (base.status === 'loading') {\n    const placeholder = resolveValue(observer.placeholderData as S | (() => S | undefined) | undefined);\n\n    return { ...base, data: placeholder } as QueryState<S>;\n  }\n\n  const selected = observer.select ? observer.select(base.data as T | undefined) : (base.data as S | undefined);\n\n  return { ...base, data: selected } as QueryState<S>;\n}\n\nexport function notify<T>(entry: CacheEntry<T>): void {\n  for (const observer of entry.observers) {\n    const typed = observer as QueryObserver<T, unknown>;\n    const next = toObserverState(entry, typed);\n    const prev = typed.previous;\n\n    const dataUnchanged = Object.is(prev?.data, next.data);\n    const metaUnchanged =\n      !!prev && prev.status === next.status && prev.isFetching === next.isFetching && Object.is(prev.error, next.error);\n\n    const shouldSkip = typed.select\n      ? metaUnchanged && dataUnchanged\n      : metaUnchanged && prev?.updatedAt === next.updatedAt && dataUnchanged;\n\n    if (shouldSkip) continue;\n\n    typed.previous = next;\n    typed.listener();\n  }\n}\n\nexport function watchInternal<T = unknown, S = T>(\n  ctx: CacheContext,\n  key: Parameters<typeof ensureEntry>[1],\n  opts?: { placeholderData?: S | (() => S | undefined); select?: (data: T | undefined) => S | undefined },\n): SyncStore<QueryState<S>> {\n  const peekObserver: QueryObserver<T, S> = { listener: () => {}, ...opts };\n\n  return {\n    peek(): QueryState<S> {\n      const entry = ctx.entries.get(hashKey(key)) as CacheEntry<T> | undefined;\n\n      if (!entry) return LOADING_STATE as QueryState<S>;\n\n      return toObserverState(entry, peekObserver);\n    },\n\n    subscribe(onStoreChange: () => void): Unsubscribe {\n      if (ctx.disposed) return () => {};\n\n      const entry = ensureEntry<T>(ctx, key);\n\n      cancelGc(ctx, entry.hash);\n\n      const observer: QueryObserver<T, S> = {\n        ...opts,\n        listener: onStoreChange,\n        previous: toObserverState(entry, peekObserver),\n      };\n\n      entry.observers.add(observer as QueryObserver<unknown, unknown>);\n\n      return () => {\n        entry.observers.delete(observer as QueryObserver<unknown, unknown>);\n\n        if (entry.observers.size === 0) {\n          scheduleGc(ctx, entry, entry.lastConfig?.gcTime ?? ctx.gcTimeDefault);\n        }\n      };\n    },\n  };\n}\n"],"mappings":"4GAYA,IAAM,EAAqC,OAAO,OAAO,CACvD,KAAM,IAAA,GACN,MAAO,KACP,WAAY,GACZ,UAAW,GACX,OAAQ,UACR,UAAW,IAAA,EACb,CAAC,EAED,SAAgB,EAAe,EAAqC,CAuBlE,OAtBI,EAAM,SAAW,UACZ,CACL,KAAM,IAAA,GACN,MAAO,KACP,WAAY,EAAM,WAClB,UAAW,GACX,OAAQ,UACR,UAAW,IAAA,EACb,EAGE,EAAM,SAAW,UACZ,CACL,KAAM,EAAM,KACZ,MAAO,KACP,WAAY,EAAM,WAClB,UAAW,GACX,OAAQ,UACR,UAAW,EAAM,SACnB,EAGK,CACL,KAAM,EAAM,KACZ,MAAO,EAAM,MACb,WAAY,EAAM,WAClB,UAAW,GACX,OAAQ,QACR,UAAW,EAAM,SACnB,CACF,CAEA,SAAgB,EAAsB,EAAsB,EAA8C,CACxG,IAAM,EAAO,EAAY,CAAK,EAE9B,GAAI,EAAK,SAAW,UAAW,CAC7B,IAAM,EAAc,EAAa,EAAS,eAAwD,EAElG,MAAO,CAAE,GAAG,EAAM,KAAM,CAAY,CACtC,CAEA,IAAM,EAAW,EAAS,OAAS,EAAS,OAAO,EAAK,IAAqB,EAAK,EAAK,KAEvF,MAAO,CAAE,GAAG,EAAM,KAAM,CAAS,CACnC,CAEA,SAAgB,EAAU,EAA4B,CACpD,IAAK,IAAM,KAAY,EAAM,UAAW,CACtC,IAAM,EAAQ,EACR,EAAO,EAAgB,EAAO,CAAK,EACnC,EAAO,EAAM,SAEb,EAAgB,OAAO,GAAG,GAAM,KAAM,EAAK,IAAI,EAC/C,EACJ,CAAC,CAAC,GAAQ,EAAK,SAAW,EAAK,QAAU,EAAK,aAAe,EAAK,YAAc,OAAO,GAAG,EAAK,MAAO,EAAK,KAAK,GAE/F,EAAM,OACrB,GAAiB,EACjB,GAAiB,GAAM,YAAc,EAAK,WAAa,KAI3D,EAAM,SAAW,EACjB,EAAM,SAAS,EACjB,CACF,CAEA,SAAgB,EACd,EACA,EACA,EAC0B,CAC1B,IAAM,EAAoC,CAAE,aAAgB,CAAC,EAAG,GAAG,CAAK,EAExE,MAAO,CACL,MAAsB,CACpB,IAAM,EAAQ,EAAI,QAAQ,IAAI,EAAQ,CAAG,CAAC,EAI1C,OAFK,EAEE,EAAgB,EAAO,CAAY,EAFvB,CAGrB,EAEA,UAAU,EAAwC,CAChD,GAAI,EAAI,SAAU,UAAa,CAAC,EAEhC,IAAM,EAAQ,EAAe,EAAK,CAAG,EAErC,EAAS,EAAK,EAAM,IAAI,EAExB,IAAM,EAAgC,CACpC,GAAG,EACH,SAAU,EACV,SAAU,EAAgB,EAAO,CAAY,CAC/C,EAIA,OAFA,EAAM,UAAU,IAAI,CAA2C,MAElD,CACX,EAAM,UAAU,OAAO,CAA2C,EAE9D,EAAM,UAAU,OAAS,GAC3B,EAAW,EAAK,EAAO,EAAM,YAAY,QAAU,EAAI,aAAa,CAExE,CACF,CACF,CACF"}

package/dist/retry.cjs

@@ -1,2 +0,0 @@
-let e=require("@vielzeug/arsenal");function t(t){return Math.random()*(0,e.backoff)(t)}function n(e,n){if(typeof n==`function`){let t=n(e);return Number.isFinite(t)?Math.max(0,t):0}return typeof n==`number`?Number.isFinite(n)?Math.max(0,n):0:t(e)}exports.fullJitterDelay=t,exports.resolveRetryDelay=n;
-//# sourceMappingURL=retry.cjs.map

package/dist/retry.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry.cjs","names":[],"sources":["../src/retry.ts"],"sourcesContent":["import { backoff } from '@vielzeug/arsenal';\n\n/** Internal default: one attempt, no retries. */\nexport const DEFAULT_TIMES = 1;\n\nexport type RetryOptions = {\n  /**\n   * Delay between retry attempts in ms, or a function receiving the zero-based\n   * attempt index (`attempt = 0` means the wait before the 2nd try, after the\n   * 1st failure). Defaults to full-jitter exponential backoff: a random delay\n   * in `[0, min(1 s × 2ⁿ, 30 s)]` where `n` is the zero-based attempt index.\n   *\n   * @example\n   * ```ts\n   * // Linear backoff: 500 ms, 1 000 ms, 1 500 ms, …\n   * delay: (attempt) => (attempt + 1) * 500\n   * ```\n   */\n  delay?: number | ((attempt: number) => number);\n  /**\n   * Return `false` to skip retrying for a specific error (e.g. 4xx HTTP errors).\n   * `attempt` is zero-based: `0` means \"deciding whether to retry after the 1st\n   * failure\", `1` means \"after the 2nd failure\", and so on.\n   */\n  shouldRetry?: (error: unknown, attempt: number) => boolean;\n  /** Total number of attempts including the first. `1` means a single try with no retries. Defaults to `1`. */\n  times?: number;\n};\n\n/**\n * Full-jitter exponential backoff: a random delay in `[0, min(1s × 2ⁿ, 30s)]` where `n` is the\n * zero-based attempt index. Shared default delay for both retries (`retry()`/mutations/queries)\n * and stream reconnects (`sse()`/`readable()`).\n */\nexport function fullJitterDelay(attempt: number): number {\n  return Math.random() * backoff(attempt);\n}\n\n/** Compute the inter-attempt delay from a courier RetryOptions configuration. */\nexport function resolveRetryDelay(attempt: number, userDelay?: number | ((attempt: number) => number)): number {\n  if (typeof userDelay === 'function') {\n    const ms = userDelay(attempt);\n\n    return Number.isFinite(ms) ? Math.max(0, ms) : 0;\n  }\n\n  if (typeof userDelay === 'number') {\n    return Number.isFinite(userDelay) ? Math.max(0, userDelay) : 0;\n  }\n\n  return fullJitterDelay(attempt);\n}\n"],"mappings":"mCAkCA,SAAgB,EAAgB,EAAyB,CACvD,OAAO,KAAK,OAAO,GAAA,EAAA,EAAA,QAAA,CAAY,CAAO,CACxC,CAGA,SAAgB,EAAkB,EAAiB,EAA4D,CAC7G,GAAI,OAAO,GAAc,WAAY,CACnC,IAAM,EAAK,EAAU,CAAO,EAE5B,OAAO,OAAO,SAAS,CAAE,EAAI,KAAK,IAAI,EAAG,CAAE,EAAI,CACjD,CAMA,OAJI,OAAO,GAAc,SAChB,OAAO,SAAS,CAAS,EAAI,KAAK,IAAI,EAAG,CAAS,EAAI,EAGxD,EAAgB,CAAO,CAChC"}

package/dist/retry.d.ts

@@ -1,34 +0,0 @@
-/** Internal default: one attempt, no retries. */
-export declare const DEFAULT_TIMES = 1;
-export type RetryOptions = {
-    /**
-     * Delay between retry attempts in ms, or a function receiving the zero-based
-     * attempt index (`attempt = 0` means the wait before the 2nd try, after the
-     * 1st failure). Defaults to full-jitter exponential backoff: a random delay
-     * in `[0, min(1 s × 2ⁿ, 30 s)]` where `n` is the zero-based attempt index.
-     *
-     * @example
-     * ```ts
-     * // Linear backoff: 500 ms, 1 000 ms, 1 500 ms, …
-     * delay: (attempt) => (attempt + 1) * 500
-     * ```
-     */
-    delay?: number | ((attempt: number) => number);
-    /**
-     * Return `false` to skip retrying for a specific error (e.g. 4xx HTTP errors).
-     * `attempt` is zero-based: `0` means "deciding whether to retry after the 1st
-     * failure", `1` means "after the 2nd failure", and so on.
-     */
-    shouldRetry?: (error: unknown, attempt: number) => boolean;
-    /** Total number of attempts including the first. `1` means a single try with no retries. Defaults to `1`. */
-    times?: number;
-};
-/**
- * Full-jitter exponential backoff: a random delay in `[0, min(1s × 2ⁿ, 30s)]` where `n` is the
- * zero-based attempt index. Shared default delay for both retries (`retry()`/mutations/queries)
- * and stream reconnects (`sse()`/`readable()`).
- */
-export declare function fullJitterDelay(attempt: number): number;
-/** Compute the inter-attempt delay from a courier RetryOptions configuration. */
-export declare function resolveRetryDelay(attempt: number, userDelay?: number | ((attempt: number) => number)): number;
-//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC/C;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,6GAA6G;IAC7G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,MAAM,CAY7G"}

package/dist/retry.js

@@ -1,2 +0,0 @@
-import{backoff as e}from"@vielzeug/arsenal";function t(t){return Math.random()*e(t)}function n(e,n){if(typeof n==`function`){let t=n(e);return Number.isFinite(t)?Math.max(0,t):0}return typeof n==`number`?Number.isFinite(n)?Math.max(0,n):0:t(e)}export{t as fullJitterDelay,n as resolveRetryDelay};
-//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry.js","names":[],"sources":["../src/retry.ts"],"sourcesContent":["import { backoff } from '@vielzeug/arsenal';\n\n/** Internal default: one attempt, no retries. */\nexport const DEFAULT_TIMES = 1;\n\nexport type RetryOptions = {\n  /**\n   * Delay between retry attempts in ms, or a function receiving the zero-based\n   * attempt index (`attempt = 0` means the wait before the 2nd try, after the\n   * 1st failure). Defaults to full-jitter exponential backoff: a random delay\n   * in `[0, min(1 s × 2ⁿ, 30 s)]` where `n` is the zero-based attempt index.\n   *\n   * @example\n   * ```ts\n   * // Linear backoff: 500 ms, 1 000 ms, 1 500 ms, …\n   * delay: (attempt) => (attempt + 1) * 500\n   * ```\n   */\n  delay?: number | ((attempt: number) => number);\n  /**\n   * Return `false` to skip retrying for a specific error (e.g. 4xx HTTP errors).\n   * `attempt` is zero-based: `0` means \"deciding whether to retry after the 1st\n   * failure\", `1` means \"after the 2nd failure\", and so on.\n   */\n  shouldRetry?: (error: unknown, attempt: number) => boolean;\n  /** Total number of attempts including the first. `1` means a single try with no retries. Defaults to `1`. */\n  times?: number;\n};\n\n/**\n * Full-jitter exponential backoff: a random delay in `[0, min(1s × 2ⁿ, 30s)]` where `n` is the\n * zero-based attempt index. Shared default delay for both retries (`retry()`/mutations/queries)\n * and stream reconnects (`sse()`/`readable()`).\n */\nexport function fullJitterDelay(attempt: number): number {\n  return Math.random() * backoff(attempt);\n}\n\n/** Compute the inter-attempt delay from a courier RetryOptions configuration. */\nexport function resolveRetryDelay(attempt: number, userDelay?: number | ((attempt: number) => number)): number {\n  if (typeof userDelay === 'function') {\n    const ms = userDelay(attempt);\n\n    return Number.isFinite(ms) ? Math.max(0, ms) : 0;\n  }\n\n  if (typeof userDelay === 'number') {\n    return Number.isFinite(userDelay) ? Math.max(0, userDelay) : 0;\n  }\n\n  return fullJitterDelay(attempt);\n}\n"],"mappings":"4CAkCA,SAAgB,EAAgB,EAAyB,CACvD,OAAO,KAAK,OAAO,EAAI,EAAQ,CAAO,CACxC,CAGA,SAAgB,EAAkB,EAAiB,EAA4D,CAC7G,GAAI,OAAO,GAAc,WAAY,CACnC,IAAM,EAAK,EAAU,CAAO,EAE5B,OAAO,OAAO,SAAS,CAAE,EAAI,KAAK,IAAI,EAAG,CAAE,EAAI,CACjD,CAMA,OAJI,OAAO,GAAc,SAChB,OAAO,SAAS,CAAS,EAAI,KAAK,IAAI,EAAG,CAAS,EAAI,EAGxD,EAAgB,CAAO,CAChC"}

package/dist/stream-readable.cjs

@@ -1,3 +0,0 @@
-const e=require("./errors.cjs"),t=require("./transport.cjs"),n=require("./retry.cjs"),r=require("./stream-shared.cjs");let i=require("@vielzeug/arsenal");async function*a(a,o,s={}){if(a.disposed)throw new e.CourierDisposedError(`StreamClient`);let{body:c,fetchInit:l,headers:u,method:d=c===void 0?`GET`:`POST`,onError:f,params:p,parse:m=`text`,query:h,reconnect:g=!1,signal:_,timeout:v}=s;v!==void 0&&t.validateTimeout(v);let y=g===!0?{}:g===!1?{times:0}:g,b=y.times??(g?5:0),x=y.delay??n.fullJitterDelay,S=new AbortController,C=a.track(S),w=0,T=!1;try{for(;!a.disposed&&!S.signal.aborted;){let t,n=!1;try{let t=(await r.openStreamWith(a,o,S,{body:c,extSignal:_,fetchInit:l,headers:u,method:d,params:p,query:h,timeout:v})).body.getReader(),i=new TextDecoder;try{if(m===`ndjson`){let r=``;for(;;){let{done:a,value:o}=await t.read();if(a){let t=r.trim();if(t)try{yield JSON.parse(t)}catch{throw new e.CourierParseError(`NDJSON: failed to parse line: ${t.slice(0,200)}`)}n=!0;break}r+=i.decode(o,{stream:!0});let s;for(;(s=r.indexOf(`
-`))!==-1;){let t=r.slice(0,s).trim();if(r=r.slice(s+1),t)try{yield JSON.parse(t)}catch{throw new e.CourierParseError(`NDJSON: failed to parse line: ${t.slice(0,200)}`)}}}}else for(;;){let{done:e,value:r}=await t.read();if(e){n=!0;break}yield i.decode(r,{stream:!0})}}finally{t.releaseLock()}}catch(e){if(a.disposed||S.signal.aborted)break;t=e instanceof Error?e:Error(String(e))}if(a.disposed||S.signal.aborted)break;if(b===0){if(t)if(f)f(t);else throw t;else T=n;break}if(w>=b){let e=t??Error(`[courier] readable() reconnect budget exhausted`);if(f)f(e);else if(t)throw t;break}if(n&&!t){T=!0;break}let s=typeof x==`function`?x(w):x;w++,await(0,i.sleep)(s,S.signal).catch(()=>{})}}finally{T||S.abort(),C()}}exports.readable=a;
-//# sourceMappingURL=stream-readable.cjs.map

package/dist/stream-readable.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-readable.cjs","names":[],"sources":["../src/stream-readable.ts"],"sourcesContent":["import { sleep } from '@vielzeug/arsenal';\n\nimport type { Params } from './url';\n\nimport { CourierDisposedError, CourierParseError } from './errors';\nimport { fullJitterDelay } from './retry';\nimport { openStreamWith, type ReconnectOptions, type StreamRequestConfig } from './stream-shared';\nimport { type TransportCore, validateTimeout } from './transport';\n\nexport type ReadableConfig<P extends string = string> = StreamRequestConfig<P> & {\n  /**\n   * Called when the reconnect budget is exhausted or a non-retriable error\n   * occurs. Not called when the generator is aborted via signal or dispose.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Response body parsing mode.\n   * - `'text'` (default) — yields raw decoded string chunks as they arrive.\n   * - `'ndjson'` — splits by newline and JSON-parses each complete line; use `T` to type the values.\n   */\n  parse?: 'ndjson' | 'text';\n  /**\n   * Auto-reconnect on connection loss. Uses the same backoff semantics as\n   * `sse()` reconnect. `true` uses defaults (5 attempts). Defaults to `false`.\n   */\n  reconnect?: boolean | ReconnectOptions;\n};\n\n/**\n * Opens an HTTP streaming connection and returns an async generator yielding\n * response body chunks as they arrive.\n *\n * - `parse: 'text'` (default) — yields raw decoded string chunks\n * - `parse: 'ndjson'` — splits by newline and JSON-parses each line; use `T` to\n *   type the parsed values\n *\n * @example\n * ```ts\n * // Raw text stream\n * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n *   process.stdout.write(chunk);\n * }\n *\n * // NDJSON (e.g. AI token stream, log stream)\n * for await (const msg of stream.readable<ChatMessage>('/chat', {\n *   body: { prompt },\n *   parse: 'ndjson',\n * })) {\n *   console.log(msg.content);\n * }\n * ```\n */\nexport async function* readable<T = string, P extends string = string>(\n  transport: TransportCore,\n  url: P,\n  config: ReadableConfig<P> = {} as ReadableConfig<P>,\n): AsyncGenerator<T> {\n  if (transport.disposed) throw new CourierDisposedError('StreamClient');\n\n  const {\n    body,\n    fetchInit,\n    headers: perRequestHeaders,\n    method = body !== undefined ? 'POST' : 'GET',\n    onError,\n    params,\n    parse = 'text',\n    query,\n    reconnect = false,\n    signal: extSignal,\n    timeout: cfgTimeout,\n  } = config as ReadableConfig;\n\n  if (cfgTimeout !== undefined) validateTimeout(cfgTimeout);\n\n  const reconnectOpts: ReconnectOptions = reconnect === true ? {} : reconnect === false ? { times: 0 } : reconnect;\n  const maxReconnects = reconnectOpts.times ?? (reconnect ? 5 : 0);\n  const reconnectDelay: number | ((attempt: number) => number) = reconnectOpts.delay ?? fullJitterDelay;\n\n  const ac = new AbortController();\n  const untrack = transport.track(ac);\n  let attempt = 0;\n  let overallNaturalEnd = false;\n\n  try {\n    while (!transport.disposed && !ac.signal.aborted) {\n      let connectError: Error | undefined;\n      let connectionNaturalEnd = false;\n\n      try {\n        const res = await openStreamWith(transport, url, ac, {\n          body,\n          extSignal,\n          fetchInit,\n          headers: perRequestHeaders as Record<string, string> | undefined,\n          method,\n          params: params as Params | undefined,\n          query,\n          timeout: cfgTimeout,\n        });\n\n        const reader = res.body!.getReader();\n        const decoder = new TextDecoder();\n\n        try {\n          if (parse === 'ndjson') {\n            let buffer = '';\n\n            while (true) {\n              const { done, value } = await reader.read();\n\n              if (done) {\n                const remaining = buffer.trim();\n\n                if (remaining) {\n                  try {\n                    yield JSON.parse(remaining) as T;\n                  } catch {\n                    throw new CourierParseError(`NDJSON: failed to parse line: ${remaining.slice(0, 200)}`);\n                  }\n                }\n\n                connectionNaturalEnd = true;\n                break;\n              }\n\n              buffer += decoder.decode(value, { stream: true });\n\n              let nlIdx: number;\n\n              while ((nlIdx = buffer.indexOf('\\n')) !== -1) {\n                const line = buffer.slice(0, nlIdx).trim();\n\n                buffer = buffer.slice(nlIdx + 1);\n\n                if (line) {\n                  try {\n                    yield JSON.parse(line) as T;\n                  } catch {\n                    throw new CourierParseError(`NDJSON: failed to parse line: ${line.slice(0, 200)}`);\n                  }\n                }\n              }\n            }\n          } else {\n            while (true) {\n              const { done, value } = await reader.read();\n\n              if (done) {\n                connectionNaturalEnd = true;\n                break;\n              }\n\n              yield decoder.decode(value, { stream: true }) as unknown as T;\n            }\n          }\n        } finally {\n          reader.releaseLock();\n        }\n      } catch (err) {\n        if (transport.disposed || ac.signal.aborted) break;\n\n        connectError = err instanceof Error ? err : new Error(String(err));\n      }\n\n      if (transport.disposed || ac.signal.aborted) break;\n\n      // No reconnect budget — throw or call onError on errors, stop either way\n      if (maxReconnects === 0) {\n        if (connectError) {\n          if (onError) {\n            onError(connectError);\n          } else {\n            throw connectError;\n          }\n        } else {\n          overallNaturalEnd = connectionNaturalEnd;\n        }\n\n        break;\n      }\n\n      // Budget exhausted\n      if (attempt >= maxReconnects) {\n        const budgetError = connectError ?? new Error('[courier] readable() reconnect budget exhausted');\n\n        if (onError) {\n          onError(budgetError);\n        } else if (connectError) {\n          throw connectError;\n        }\n\n        break;\n      }\n\n      // Clean server close with no reconnect error — done\n      if (connectionNaturalEnd && !connectError) {\n        overallNaturalEnd = true;\n        break;\n      }\n\n      // Sleep before reconnecting\n      const delay = typeof reconnectDelay === 'function' ? reconnectDelay(attempt) : reconnectDelay;\n\n      attempt++;\n      await sleep(delay, ac.signal).catch(() => {});\n    }\n  } finally {\n    if (!overallNaturalEnd) ac.abort();\n\n    untrack();\n  }\n}\n"],"mappings":"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"}

package/dist/stream-readable.d.ts

@@ -1,46 +0,0 @@
-import { type ReconnectOptions, type StreamRequestConfig } from './stream-shared';
-import { type TransportCore } from './transport';
-export type ReadableConfig<P extends string = string> = StreamRequestConfig<P> & {
-    /**
-     * Called when the reconnect budget is exhausted or a non-retriable error
-     * occurs. Not called when the generator is aborted via signal or dispose.
-     */
-    onError?: (error: Error) => void;
-    /**
-     * Response body parsing mode.
-     * - `'text'` (default) — yields raw decoded string chunks as they arrive.
-     * - `'ndjson'` — splits by newline and JSON-parses each complete line; use `T` to type the values.
-     */
-    parse?: 'ndjson' | 'text';
-    /**
-     * Auto-reconnect on connection loss. Uses the same backoff semantics as
-     * `sse()` reconnect. `true` uses defaults (5 attempts). Defaults to `false`.
-     */
-    reconnect?: boolean | ReconnectOptions;
-};
-/**
- * Opens an HTTP streaming connection and returns an async generator yielding
- * response body chunks as they arrive.
- *
- * - `parse: 'text'` (default) — yields raw decoded string chunks
- * - `parse: 'ndjson'` — splits by newline and JSON-parses each line; use `T` to
- *   type the parsed values
- *
- * @example
- * ```ts
- * // Raw text stream
- * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {
- *   process.stdout.write(chunk);
- * }
- *
- * // NDJSON (e.g. AI token stream, log stream)
- * for await (const msg of stream.readable<ChatMessage>('/chat', {
- *   body: { prompt },
- *   parse: 'ndjson',
- * })) {
- *   console.log(msg.content);
- * }
- * ```
- */
-export declare function readable<T = string, P extends string = string>(transport: TransportCore, url: P, config?: ReadableConfig<P>): AsyncGenerator<T>;
-//# sourceMappingURL=stream-readable.d.ts.map

package/dist/stream-readable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-readable.d.ts","sourceRoot":"","sources":["../src/stream-readable.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG;IAC/E;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAuB,QAAQ,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACnE,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,CAAC,EACN,MAAM,GAAE,cAAc,CAAC,CAAC,CAA2B,GAClD,cAAc,CAAC,CAAC,CAAC,CA4JnB"}

package/dist/stream-readable.js

@@ -1,3 +0,0 @@
-import{CourierDisposedError as e,CourierParseError as t}from"./errors.js";import{validateTimeout as n}from"./transport.js";import{fullJitterDelay as r}from"./retry.js";import{openStreamWith as i}from"./stream-shared.js";import{sleep as a}from"@vielzeug/arsenal";async function*o(o,s,c={}){if(o.disposed)throw new e(`StreamClient`);let{body:l,fetchInit:u,headers:d,method:f=l===void 0?`GET`:`POST`,onError:p,params:m,parse:h=`text`,query:g,reconnect:_=!1,signal:v,timeout:y}=c;y!==void 0&&n(y);let b=_===!0?{}:_===!1?{times:0}:_,x=b.times??(_?5:0),S=b.delay??r,C=new AbortController,w=o.track(C),T=0,E=!1;try{for(;!o.disposed&&!C.signal.aborted;){let e,n=!1;try{let e=(await i(o,s,C,{body:l,extSignal:v,fetchInit:u,headers:d,method:f,params:m,query:g,timeout:y})).body.getReader(),r=new TextDecoder;try{if(h===`ndjson`){let i=``;for(;;){let{done:a,value:o}=await e.read();if(a){let e=i.trim();if(e)try{yield JSON.parse(e)}catch{throw new t(`NDJSON: failed to parse line: ${e.slice(0,200)}`)}n=!0;break}i+=r.decode(o,{stream:!0});let s;for(;(s=i.indexOf(`
-`))!==-1;){let e=i.slice(0,s).trim();if(i=i.slice(s+1),e)try{yield JSON.parse(e)}catch{throw new t(`NDJSON: failed to parse line: ${e.slice(0,200)}`)}}}}else for(;;){let{done:t,value:i}=await e.read();if(t){n=!0;break}yield r.decode(i,{stream:!0})}}finally{e.releaseLock()}}catch(t){if(o.disposed||C.signal.aborted)break;e=t instanceof Error?t:Error(String(t))}if(o.disposed||C.signal.aborted)break;if(x===0){if(e)if(p)p(e);else throw e;else E=n;break}if(T>=x){let t=e??Error(`[courier] readable() reconnect budget exhausted`);if(p)p(t);else if(e)throw e;break}if(n&&!e){E=!0;break}let r=typeof S==`function`?S(T):S;T++,await a(r,C.signal).catch(()=>{})}}finally{E||C.abort(),w()}}export{o as readable};
-//# sourceMappingURL=stream-readable.js.map

package/dist/stream-readable.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-readable.js","names":[],"sources":["../src/stream-readable.ts"],"sourcesContent":["import { sleep } from '@vielzeug/arsenal';\n\nimport type { Params } from './url';\n\nimport { CourierDisposedError, CourierParseError } from './errors';\nimport { fullJitterDelay } from './retry';\nimport { openStreamWith, type ReconnectOptions, type StreamRequestConfig } from './stream-shared';\nimport { type TransportCore, validateTimeout } from './transport';\n\nexport type ReadableConfig<P extends string = string> = StreamRequestConfig<P> & {\n  /**\n   * Called when the reconnect budget is exhausted or a non-retriable error\n   * occurs. Not called when the generator is aborted via signal or dispose.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Response body parsing mode.\n   * - `'text'` (default) — yields raw decoded string chunks as they arrive.\n   * - `'ndjson'` — splits by newline and JSON-parses each complete line; use `T` to type the values.\n   */\n  parse?: 'ndjson' | 'text';\n  /**\n   * Auto-reconnect on connection loss. Uses the same backoff semantics as\n   * `sse()` reconnect. `true` uses defaults (5 attempts). Defaults to `false`.\n   */\n  reconnect?: boolean | ReconnectOptions;\n};\n\n/**\n * Opens an HTTP streaming connection and returns an async generator yielding\n * response body chunks as they arrive.\n *\n * - `parse: 'text'` (default) — yields raw decoded string chunks\n * - `parse: 'ndjson'` — splits by newline and JSON-parses each line; use `T` to\n *   type the parsed values\n *\n * @example\n * ```ts\n * // Raw text stream\n * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n *   process.stdout.write(chunk);\n * }\n *\n * // NDJSON (e.g. AI token stream, log stream)\n * for await (const msg of stream.readable<ChatMessage>('/chat', {\n *   body: { prompt },\n *   parse: 'ndjson',\n * })) {\n *   console.log(msg.content);\n * }\n * ```\n */\nexport async function* readable<T = string, P extends string = string>(\n  transport: TransportCore,\n  url: P,\n  config: ReadableConfig<P> = {} as ReadableConfig<P>,\n): AsyncGenerator<T> {\n  if (transport.disposed) throw new CourierDisposedError('StreamClient');\n\n  const {\n    body,\n    fetchInit,\n    headers: perRequestHeaders,\n    method = body !== undefined ? 'POST' : 'GET',\n    onError,\n    params,\n    parse = 'text',\n    query,\n    reconnect = false,\n    signal: extSignal,\n    timeout: cfgTimeout,\n  } = config as ReadableConfig;\n\n  if (cfgTimeout !== undefined) validateTimeout(cfgTimeout);\n\n  const reconnectOpts: ReconnectOptions = reconnect === true ? {} : reconnect === false ? { times: 0 } : reconnect;\n  const maxReconnects = reconnectOpts.times ?? (reconnect ? 5 : 0);\n  const reconnectDelay: number | ((attempt: number) => number) = reconnectOpts.delay ?? fullJitterDelay;\n\n  const ac = new AbortController();\n  const untrack = transport.track(ac);\n  let attempt = 0;\n  let overallNaturalEnd = false;\n\n  try {\n    while (!transport.disposed && !ac.signal.aborted) {\n      let connectError: Error | undefined;\n      let connectionNaturalEnd = false;\n\n      try {\n        const res = await openStreamWith(transport, url, ac, {\n          body,\n          extSignal,\n          fetchInit,\n          headers: perRequestHeaders as Record<string, string> | undefined,\n          method,\n          params: params as Params | undefined,\n          query,\n          timeout: cfgTimeout,\n        });\n\n        const reader = res.body!.getReader();\n        const decoder = new TextDecoder();\n\n        try {\n          if (parse === 'ndjson') {\n            let buffer = '';\n\n            while (true) {\n              const { done, value } = await reader.read();\n\n              if (done) {\n                const remaining = buffer.trim();\n\n                if (remaining) {\n                  try {\n                    yield JSON.parse(remaining) as T;\n                  } catch {\n                    throw new CourierParseError(`NDJSON: failed to parse line: ${remaining.slice(0, 200)}`);\n                  }\n                }\n\n                connectionNaturalEnd = true;\n                break;\n              }\n\n              buffer += decoder.decode(value, { stream: true });\n\n              let nlIdx: number;\n\n              while ((nlIdx = buffer.indexOf('\\n')) !== -1) {\n                const line = buffer.slice(0, nlIdx).trim();\n\n                buffer = buffer.slice(nlIdx + 1);\n\n                if (line) {\n                  try {\n                    yield JSON.parse(line) as T;\n                  } catch {\n                    throw new CourierParseError(`NDJSON: failed to parse line: ${line.slice(0, 200)}`);\n                  }\n                }\n              }\n            }\n          } else {\n            while (true) {\n              const { done, value } = await reader.read();\n\n              if (done) {\n                connectionNaturalEnd = true;\n                break;\n              }\n\n              yield decoder.decode(value, { stream: true }) as unknown as T;\n            }\n          }\n        } finally {\n          reader.releaseLock();\n        }\n      } catch (err) {\n        if (transport.disposed || ac.signal.aborted) break;\n\n        connectError = err instanceof Error ? err : new Error(String(err));\n      }\n\n      if (transport.disposed || ac.signal.aborted) break;\n\n      // No reconnect budget — throw or call onError on errors, stop either way\n      if (maxReconnects === 0) {\n        if (connectError) {\n          if (onError) {\n            onError(connectError);\n          } else {\n            throw connectError;\n          }\n        } else {\n          overallNaturalEnd = connectionNaturalEnd;\n        }\n\n        break;\n      }\n\n      // Budget exhausted\n      if (attempt >= maxReconnects) {\n        const budgetError = connectError ?? new Error('[courier] readable() reconnect budget exhausted');\n\n        if (onError) {\n          onError(budgetError);\n        } else if (connectError) {\n          throw connectError;\n        }\n\n        break;\n      }\n\n      // Clean server close with no reconnect error — done\n      if (connectionNaturalEnd && !connectError) {\n        overallNaturalEnd = true;\n        break;\n      }\n\n      // Sleep before reconnecting\n      const delay = typeof reconnectDelay === 'function' ? reconnectDelay(attempt) : reconnectDelay;\n\n      attempt++;\n      await sleep(delay, ac.signal).catch(() => {});\n    }\n  } finally {\n    if (!overallNaturalEnd) ac.abort();\n\n    untrack();\n  }\n}\n"],"mappings":"sQAoDA,eAAuB,EACrB,EACA,EACA,EAA4B,CAAC,EACV,CACnB,GAAI,EAAU,SAAU,MAAM,IAAI,EAAqB,cAAc,EAErE,GAAM,CACJ,OACA,YACA,QAAS,EACT,SAAS,IAAS,IAAA,GAAqB,MAAT,OAC9B,UACA,SACA,QAAQ,OACR,QACA,YAAY,GACZ,OAAQ,EACR,QAAS,GACP,EAEA,IAAe,IAAA,IAAW,EAAgB,CAAU,EAExD,IAAM,EAAkC,IAAc,GAAO,CAAC,EAAI,IAAc,GAAQ,CAAE,MAAO,CAAE,EAAI,EACjG,EAAgB,EAAc,QAAU,EAAY,EAAI,GACxD,EAAyD,EAAc,OAAS,EAEhF,EAAK,IAAI,gBACT,EAAU,EAAU,MAAM,CAAE,EAC9B,EAAU,EACV,EAAoB,GAExB,GAAI,CACF,KAAO,CAAC,EAAU,UAAY,CAAC,EAAG,OAAO,SAAS,CAChD,IAAI,EACA,EAAuB,GAE3B,GAAI,CAYF,IAAM,GAAS,MAXG,EAAe,EAAW,EAAK,EAAI,CACnD,OACA,YACA,YACA,QAAS,EACT,SACQ,SACR,QACA,QAAS,CACX,CAAC,EAAA,CAEkB,KAAM,UAAU,EAC7B,EAAU,IAAI,YAEpB,GAAI,CACF,GAAI,IAAU,SAAU,CACtB,IAAI,EAAS,GAEb,OAAa,CACX,GAAM,CAAE,OAAM,SAAU,MAAM,EAAO,KAAK,EAE1C,GAAI,EAAM,CACR,IAAM,EAAY,EAAO,KAAK,EAE9B,GAAI,EACF,GAAI,CACF,MAAM,KAAK,MAAM,CAAS,CAC5B,MAAQ,CACN,MAAM,IAAI,EAAkB,iCAAiC,EAAU,MAAM,EAAG,GAAG,GAAG,CACxF,CAGF,EAAuB,GACvB,KACF,CAEA,GAAU,EAAQ,OAAO,EAAO,CAAE,OAAQ,EAAK,CAAC,EAEhD,IAAI,EAEJ,MAAQ,EAAQ,EAAO,QAAQ;CAAI,KAAO,IAAI,CAC5C,IAAM,EAAO,EAAO,MAAM,EAAG,CAAK,CAAC,CAAC,KAAK,EAIzC,GAFA,EAAS,EAAO,MAAM,EAAQ,CAAC,EAE3B,EACF,GAAI,CACF,MAAM,KAAK,MAAM,CAAI,CACvB,MAAQ,CACN,MAAM,IAAI,EAAkB,iCAAiC,EAAK,MAAM,EAAG,GAAG,GAAG,CACnF,CAEJ,CACF,CACF,MACE,OAAa,CACX,GAAM,CAAE,OAAM,SAAU,MAAM,EAAO,KAAK,EAE1C,GAAI,EAAM,CACR,EAAuB,GACvB,KACF,CAEA,MAAM,EAAQ,OAAO,EAAO,CAAE,OAAQ,EAAK,CAAC,CAC9C,CAEJ,QAAU,CACR,EAAO,YAAY,CACrB,CACF,OAAS,EAAK,CACZ,GAAI,EAAU,UAAY,EAAG,OAAO,QAAS,MAE7C,EAAe,aAAe,MAAQ,EAAU,MAAM,OAAO,CAAG,CAAC,CACnE,CAEA,GAAI,EAAU,UAAY,EAAG,OAAO,QAAS,MAG7C,GAAI,IAAkB,EAAG,CACvB,GAAI,EACF,GAAI,EACF,EAAQ,CAAY,OAEpB,MAAM,MAGR,GAAoB,EAGtB,KACF,CAGA,GAAI,GAAW,EAAe,CAC5B,IAAM,EAAc,GAAoB,MAAM,iDAAiD,EAE/F,GAAI,EACF,EAAQ,CAAW,OACd,GAAI,EACT,MAAM,EAGR,KACF,CAGA,GAAI,GAAwB,CAAC,EAAc,CACzC,EAAoB,GACpB,KACF,CAGA,IAAM,EAAQ,OAAO,GAAmB,WAAa,EAAe,CAAO,EAAI,EAE/E,IACA,MAAM,EAAM,EAAO,EAAG,MAAM,CAAC,CAAC,UAAY,CAAC,CAAC,CAC9C,CACF,QAAU,CACH,GAAmB,EAAG,MAAM,EAEjC,EAAQ,CACV,CACF"}

package/dist/stream-shared.cjs

@@ -1,2 +0,0 @@
-const e=require("./errors.cjs"),t=require("./serialize.cjs"),n=require("./transport.cjs"),r=require("./url.cjs");async function i(i,a,o,s,c){let l=s.method.toUpperCase(),u=r.buildUrl(i.baseUrl,a,s.params,s.query),d=n.anySignal(s.extSignal,o.signal)??o.signal,f=n.buildTimeoutSignal(s.timeout??1/0,d),{headers:p,...m}=t.buildRequestInit(l,i.mergeHeaders(s.headers,c),s.body,f,s.fetchInit??{}),h;try{h=await i.dispatch({headers:p,init:m,url:u})}catch(t){throw e.classifyRequestError(t,l,u,f??d)}if(!h.ok){let t=await h.text().catch(()=>``);throw e.CourierHttpError.fromResponse(h,t,l,u)}if(!h.body)throw new e.CourierParseError(`Response has no body`);return h}exports.openStreamWith=i;
-//# sourceMappingURL=stream-shared.cjs.map

package/dist/stream-shared.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-shared.cjs","names":[],"sources":["../src/stream-shared.ts"],"sourcesContent":["import type { Params } from './url';\n\nimport { classifyRequestError, CourierHttpError, CourierParseError } from './errors';\nimport { buildRequestInit } from './serialize';\nimport { anySignal, buildTimeoutSignal, type TransportCore } from './transport';\nimport { buildUrl } from './url';\n\nexport type StreamRequestConfig<P extends string = string> = {\n  body?: unknown;\n  /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  headers?: Record<string, string>;\n  method?: string;\n  params?: P extends string ? Record<string, string | number | boolean> : never;\n  query?: Params;\n  /** External abort signal. Merged with internal cancellation. */\n  signal?: AbortSignal;\n  /** Request timeout in ms. Overrides client default (which is `Infinity` for streaming). */\n  timeout?: number;\n};\n\nexport type ReconnectOptions = {\n  /**\n   * Delay between reconnect attempts in ms, or a zero-based function where\n   * `attempt` is the number of failures so far (0 = waiting before the 2nd try).\n   * Defaults to full-jitter exponential backoff: `[0, min(1s × 2ⁿ, 30s)]`.\n   */\n  delay?: number | ((attempt: number) => number);\n  /** Total reconnect attempts after the first failure. Defaults to `5`. */\n  times?: number;\n};\n\n/**\n * Shared stream setup: build URL, combine signals, merge headers, dispatch through\n * transport. Returns the Response so both sse() and readable() can focus on parsing.\n * The caller owns the AbortController lifecycle (track + untrack).\n */\nexport async function openStreamWith(\n  transport: TransportCore,\n  url: string,\n  ac: AbortController,\n  config: {\n    body?: unknown;\n    extSignal?: AbortSignal;\n    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n    headers?: Record<string, string>;\n    method: string;\n    params?: Params;\n    query?: Params;\n    timeout?: number;\n  },\n  extraHeaders?: Record<string, string>,\n): Promise<Response> {\n  // Normalize once — error paths and RequestInit both receive the canonical form.\n  const method = config.method.toUpperCase();\n  const full = buildUrl(transport.baseUrl, url, config.params, config.query);\n  const combined = anySignal(config.extSignal, ac.signal) ?? ac.signal;\n  // Streaming connections are long-lived — default to Infinity so the transport's\n  // REST default (30s) does not cut off streams prematurely.\n  const signal = buildTimeoutSignal(config.timeout ?? Number.POSITIVE_INFINITY, combined);\n  const requestHeaders = transport.mergeHeaders(config.headers, extraHeaders);\n  const { headers: initHeaders, ...restInit } = buildRequestInit(\n    method,\n    requestHeaders,\n    config.body,\n    signal,\n    config.fetchInit ?? {},\n  );\n\n  let res: Response;\n\n  try {\n    res = await transport.dispatch({ headers: initHeaders as Record<string, string>, init: restInit, url: full });\n  } catch (err) {\n    throw classifyRequestError(err, method, full, signal ?? combined);\n  }\n\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n\n    throw CourierHttpError.fromResponse(res, text, method, full);\n  }\n\n  if (!res.body) throw new CourierParseError('Response has no body');\n\n  return res;\n}\n"],"mappings":"iHAqCA,eAAsB,EACpB,EACA,EACA,EACA,EAUA,EACmB,CAEnB,IAAM,EAAS,EAAO,OAAO,YAAY,EACnC,EAAO,EAAA,SAAS,EAAU,QAAS,EAAK,EAAO,OAAQ,EAAO,KAAK,EACnE,EAAW,EAAA,UAAU,EAAO,UAAW,EAAG,MAAM,GAAK,EAAG,OAGxD,EAAS,EAAA,mBAAmB,EAAO,SAAW,IAA0B,CAAQ,EAEhF,CAAE,QAAS,EAAa,GAAG,GAAa,EAAA,iBAC5C,EAFqB,EAAU,aAAa,EAAO,QAAS,CAG5D,EACA,EAAO,KACP,EACA,EAAO,WAAa,CAAC,CACvB,EAEI,EAEJ,GAAI,CACF,EAAM,MAAM,EAAU,SAAS,CAAE,QAAS,EAAuC,KAAM,EAAU,IAAK,CAAK,CAAC,CAC9G,OAAS,EAAK,CACZ,MAAM,EAAA,qBAAqB,EAAK,EAAQ,EAAM,GAAU,CAAQ,CAClE,CAEA,GAAI,CAAC,EAAI,GAAI,CACX,IAAM,EAAO,MAAM,EAAI,KAAK,CAAC,CAAC,UAAY,EAAE,EAE5C,MAAM,EAAA,iBAAiB,aAAa,EAAK,EAAM,EAAQ,CAAI,CAC7D,CAEA,GAAI,CAAC,EAAI,KAAM,MAAM,IAAI,EAAA,kBAAkB,sBAAsB,EAEjE,OAAO,CACT"}

package/dist/stream-shared.d.ts

@@ -1,41 +0,0 @@
-import type { Params } from './url';
-import { type TransportCore } from './transport';
-export type StreamRequestConfig<P extends string = string> = {
-    body?: unknown;
-    /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */
-    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;
-    headers?: Record<string, string>;
-    method?: string;
-    params?: P extends string ? Record<string, string | number | boolean> : never;
-    query?: Params;
-    /** External abort signal. Merged with internal cancellation. */
-    signal?: AbortSignal;
-    /** Request timeout in ms. Overrides client default (which is `Infinity` for streaming). */
-    timeout?: number;
-};
-export type ReconnectOptions = {
-    /**
-     * Delay between reconnect attempts in ms, or a zero-based function where
-     * `attempt` is the number of failures so far (0 = waiting before the 2nd try).
-     * Defaults to full-jitter exponential backoff: `[0, min(1s × 2ⁿ, 30s)]`.
-     */
-    delay?: number | ((attempt: number) => number);
-    /** Total reconnect attempts after the first failure. Defaults to `5`. */
-    times?: number;
-};
-/**
- * Shared stream setup: build URL, combine signals, merge headers, dispatch through
- * transport. Returns the Response so both sse() and readable() can focus on parsing.
- * The caller owns the AbortController lifecycle (track + untrack).
- */
-export declare function openStreamWith(transport: TransportCore, url: string, ac: AbortController, config: {
-    body?: unknown;
-    extSignal?: AbortSignal;
-    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;
-    headers?: Record<string, string>;
-    method: string;
-    params?: Params;
-    query?: Params;
-    timeout?: number;
-}, extraHeaders?: Record<string, string>): Promise<Response>;
-//# sourceMappingURL=stream-shared.d.ts.map

package/dist/stream-shared.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-shared.d.ts","sourceRoot":"","sources":["../src/stream-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAIpC,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,KAAK,CAAC;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC/C,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,EACD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,QAAQ,CAAC,CAkCnB"}

package/dist/stream-shared.js

@@ -1,2 +0,0 @@
-import{CourierHttpError as e,CourierParseError as t,classifyRequestError as n}from"./errors.js";import{buildRequestInit as r}from"./serialize.js";import{anySignal as i,buildTimeoutSignal as a}from"./transport.js";import{buildUrl as o}from"./url.js";async function s(s,c,l,u,d){let f=u.method.toUpperCase(),p=o(s.baseUrl,c,u.params,u.query),m=i(u.extSignal,l.signal)??l.signal,h=a(u.timeout??1/0,m),{headers:g,..._}=r(f,s.mergeHeaders(u.headers,d),u.body,h,u.fetchInit??{}),v;try{v=await s.dispatch({headers:g,init:_,url:p})}catch(e){throw n(e,f,p,h??m)}if(!v.ok){let t=await v.text().catch(()=>``);throw e.fromResponse(v,t,f,p)}if(!v.body)throw new t(`Response has no body`);return v}export{s as openStreamWith};
-//# sourceMappingURL=stream-shared.js.map

package/dist/stream-shared.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-shared.js","names":[],"sources":["../src/stream-shared.ts"],"sourcesContent":["import type { Params } from './url';\n\nimport { classifyRequestError, CourierHttpError, CourierParseError } from './errors';\nimport { buildRequestInit } from './serialize';\nimport { anySignal, buildTimeoutSignal, type TransportCore } from './transport';\nimport { buildUrl } from './url';\n\nexport type StreamRequestConfig<P extends string = string> = {\n  body?: unknown;\n  /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  headers?: Record<string, string>;\n  method?: string;\n  params?: P extends string ? Record<string, string | number | boolean> : never;\n  query?: Params;\n  /** External abort signal. Merged with internal cancellation. */\n  signal?: AbortSignal;\n  /** Request timeout in ms. Overrides client default (which is `Infinity` for streaming). */\n  timeout?: number;\n};\n\nexport type ReconnectOptions = {\n  /**\n   * Delay between reconnect attempts in ms, or a zero-based function where\n   * `attempt` is the number of failures so far (0 = waiting before the 2nd try).\n   * Defaults to full-jitter exponential backoff: `[0, min(1s × 2ⁿ, 30s)]`.\n   */\n  delay?: number | ((attempt: number) => number);\n  /** Total reconnect attempts after the first failure. Defaults to `5`. */\n  times?: number;\n};\n\n/**\n * Shared stream setup: build URL, combine signals, merge headers, dispatch through\n * transport. Returns the Response so both sse() and readable() can focus on parsing.\n * The caller owns the AbortController lifecycle (track + untrack).\n */\nexport async function openStreamWith(\n  transport: TransportCore,\n  url: string,\n  ac: AbortController,\n  config: {\n    body?: unknown;\n    extSignal?: AbortSignal;\n    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n    headers?: Record<string, string>;\n    method: string;\n    params?: Params;\n    query?: Params;\n    timeout?: number;\n  },\n  extraHeaders?: Record<string, string>,\n): Promise<Response> {\n  // Normalize once — error paths and RequestInit both receive the canonical form.\n  const method = config.method.toUpperCase();\n  const full = buildUrl(transport.baseUrl, url, config.params, config.query);\n  const combined = anySignal(config.extSignal, ac.signal) ?? ac.signal;\n  // Streaming connections are long-lived — default to Infinity so the transport's\n  // REST default (30s) does not cut off streams prematurely.\n  const signal = buildTimeoutSignal(config.timeout ?? Number.POSITIVE_INFINITY, combined);\n  const requestHeaders = transport.mergeHeaders(config.headers, extraHeaders);\n  const { headers: initHeaders, ...restInit } = buildRequestInit(\n    method,\n    requestHeaders,\n    config.body,\n    signal,\n    config.fetchInit ?? {},\n  );\n\n  let res: Response;\n\n  try {\n    res = await transport.dispatch({ headers: initHeaders as Record<string, string>, init: restInit, url: full });\n  } catch (err) {\n    throw classifyRequestError(err, method, full, signal ?? combined);\n  }\n\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n\n    throw CourierHttpError.fromResponse(res, text, method, full);\n  }\n\n  if (!res.body) throw new CourierParseError('Response has no body');\n\n  return res;\n}\n"],"mappings":"yPAqCA,eAAsB,EACpB,EACA,EACA,EACA,EAUA,EACmB,CAEnB,IAAM,EAAS,EAAO,OAAO,YAAY,EACnC,EAAO,EAAS,EAAU,QAAS,EAAK,EAAO,OAAQ,EAAO,KAAK,EACnE,EAAW,EAAU,EAAO,UAAW,EAAG,MAAM,GAAK,EAAG,OAGxD,EAAS,EAAmB,EAAO,SAAW,IAA0B,CAAQ,EAEhF,CAAE,QAAS,EAAa,GAAG,GAAa,EAC5C,EAFqB,EAAU,aAAa,EAAO,QAAS,CAG5D,EACA,EAAO,KACP,EACA,EAAO,WAAa,CAAC,CACvB,EAEI,EAEJ,GAAI,CACF,EAAM,MAAM,EAAU,SAAS,CAAE,QAAS,EAAuC,KAAM,EAAU,IAAK,CAAK,CAAC,CAC9G,OAAS,EAAK,CACZ,MAAM,EAAqB,EAAK,EAAQ,EAAM,GAAU,CAAQ,CAClE,CAEA,GAAI,CAAC,EAAI,GAAI,CACX,IAAM,EAAO,MAAM,EAAI,KAAK,CAAC,CAAC,UAAY,EAAE,EAE5C,MAAM,EAAiB,aAAa,EAAK,EAAM,EAAQ,CAAI,CAC7D,CAEA,GAAI,CAAC,EAAI,KAAM,MAAM,IAAI,EAAkB,sBAAsB,EAEjE,OAAO,CACT"}

package/dist/stream-sse.cjs

@@ -1,6 +0,0 @@
-const e=require("./errors.cjs"),t=require("./transport.cjs"),n=require("./retry.cjs"),r=require("./stream-shared.cjs");let i=require("@vielzeug/arsenal");function a(e){try{return JSON.parse(e)}catch{return e}}function o(o,s,c={}){if(o.disposed)throw new e.CourierDisposedError(`StreamClient`);let{body:l,fetchInit:u,headers:d,method:f=l===void 0?`GET`:`POST`,onError:p,params:m,query:h,reconnect:g=!1,signal:_,timeout:v}=c;v!==void 0&&t.validateTimeout(v);let y=new Map,b=new AbortController,x=o.track(b),S=!1,C=`connecting`,w=``,T=g===!0?{}:g===!1?{times:0}:g,E=T.times??(g?5:0),D=T.delay??n.fullJitterDelay;function O(e,t){let n=y.get(e);if(!n?.size)return;let r=a(t);for(let e of n)e(r)}async function k(){let e=(await r.openStreamWith(o,s,b,{body:l,extSignal:_,fetchInit:u,headers:d,method:f,params:m,query:h,timeout:v},{accept:`text/event-stream`,"cache-control":`no-cache`,...w?{"last-event-id":w}:{}})).body.getReader(),t=new TextDecoder,n=``,i=`message`,a=``,c=``;try{for(;;){let{done:r,value:o}=await e.read();if(r)break;n+=t.decode(o,{stream:!0}).replace(/\r\n/g,`
-`).replace(/\r/g,`
-`);let s;for(;(s=n.indexOf(`
-`))!==-1;){let e=n.slice(0,s);if(n=n.slice(s+1),e===``)a!==``&&(c&&(w=c),O(i,a.replace(/\n$/,``))),i=`message`,a=``,c=``;else if(!e.startsWith(`:`)){let t=e.indexOf(`:`),n=t===-1?e:e.slice(0,t),r=t===-1?``:e.slice(t+1).replace(/^ /,``);if(n===`event`)i=r;else if(n===`data`)a+=(a?`
-`:``)+r;else if(n===`id`&&!r.includes(`\0`))c=r;else if(n===`retry`){let e=parseInt(r,10);Number.isNaN(e)||(D=e)}}}}}finally{e.releaseLock()}}async function A(){let e=0;try{for(;!S&&!o.disposed&&!b.signal.aborted;){let t;C=`connecting`;try{C=`open`,await k()}catch(e){if(S||o.disposed||b.signal.aborted)break;t=e instanceof Error?e:Error(String(e))}if(S||o.disposed||b.signal.aborted)break;if(E===0){t&&p?.(t);break}if(e>=E){p?.(t??Error(`[courier] SSE reconnect budget exhausted`));break}C=`reconnecting`;let n=typeof D==`function`?D(e):D;e++,await(0,i.sleep)(n,b.signal).catch(()=>{})}}finally{C=`closed`,x()}}return A().catch(e=>{!S&&!o.disposed&&p?.(e instanceof Error?e:Error(String(e)))}),{get closed(){return S},dispose(){S=!0,b.abort(),y.clear()},on(e,t){if(S)return()=>{};let n=y.get(e);return n||(n=new Set,y.set(e,n)),n.add(t),()=>n.delete(t)},get status(){return C},[Symbol.dispose](){this.dispose()}}}exports.sse=o;
-//# sourceMappingURL=stream-sse.cjs.map

package/dist/stream-sse.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-sse.cjs","names":[],"sources":["../src/stream-sse.ts"],"sourcesContent":["import { sleep } from '@vielzeug/arsenal';\n\nimport type { Params } from './url';\n\nimport { CourierDisposedError } from './errors';\nimport { fullJitterDelay } from './retry';\nimport { openStreamWith, type ReconnectOptions, type StreamRequestConfig } from './stream-shared';\nimport { type TransportCore, validateTimeout } from './transport';\n\nexport type SseOptions<P extends string = string> = StreamRequestConfig<P> & {\n  /**\n   * Called when the connection is permanently lost (reconnect budget exhausted due to error).\n   * Not called on `dispose()`.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Auto-reconnect on connection loss with exponential backoff.\n   * `true` uses defaults (5 attempts). Defaults to `false`.\n   */\n  reconnect?: boolean | ReconnectOptions;\n};\n\n/** Connection lifecycle status for an SSE source. */\nexport type SseStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';\n\n/**\n * Typed SSE event source. `TEvents` maps event name → data type.\n * Non-string data values are automatically JSON-parsed from the raw `data:` field.\n * If parsing fails the raw string is delivered instead.\n */\nexport type SseSource<TEvents extends Record<string, unknown> = Record<string, string>> = {\n  [Symbol.dispose](): void;\n  /** `true` after `dispose()` is called or the reconnect budget is exhausted. */\n  readonly closed: boolean;\n  /** Permanently closes the SSE connection. No further events will be dispatched. */\n  dispose(): void;\n  /**\n   * Registers a handler for a named SSE event. Returns an unsubscribe function.\n   * The special name `'message'` matches events without an explicit `event:` field.\n   * Calling `on()` after `dispose()` returns a no-op unsubscribe.\n   */\n  on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void;\n  /** Current connection lifecycle status. Useful for displaying a live-connection indicator. */\n  readonly status: SseStatus;\n};\n\n/** Parse a raw SSE data string: try JSON, fall back to raw string. */\nfunction parseEventData(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return raw;\n  }\n}\n\n/**\n * Opens a Server-Sent Events connection and returns a typed source.\n *\n * - Intercepts request through the same pipeline as `createApi` (auth, logging, etc.)\n * - Auto-reconnects with exponential backoff when `reconnect` is set\n * - Sends `Last-Event-ID` header on reconnect to resume from last received event\n * - Non-string event data is automatically JSON-parsed\n *\n * @example\n * ```ts\n * const src = stream.sse<{ message: { text: string }; ping: null }>('/events', {\n *   reconnect: true,\n *   onError: (err) => console.error(err),\n * });\n *\n * src.on('message', (data) => console.log(data.text));\n * src.on('ping', () => {});\n * // later:\n * src.dispose();\n * ```\n */\nexport function sse<TEvents extends Record<string, unknown> = Record<string, string>, P extends string = string>(\n  transport: TransportCore,\n  url: P,\n  config: SseOptions<P> = {} as SseOptions<P>,\n): SseSource<TEvents> {\n  if (transport.disposed) throw new CourierDisposedError('StreamClient');\n\n  const {\n    body,\n    fetchInit,\n    headers: perRequestHeaders,\n    method = body !== undefined ? 'POST' : 'GET',\n    onError,\n    params,\n    query,\n    reconnect = false,\n    signal: extSignal,\n    timeout: cfgTimeout,\n  } = config as SseOptions;\n\n  if (cfgTimeout !== undefined) validateTimeout(cfgTimeout);\n\n  const listeners = new Map<string, Set<(data: unknown) => void>>();\n  const ac = new AbortController();\n  // Track `ac` once for the entire SSE lifetime — covers active connections AND\n  // reconnect sleep windows, so cancelAll()/dispose() always reach it.\n  const untrack = transport.track(ac);\n  let closed = false;\n  let sseStatus: SseStatus = 'connecting';\n  let lastEventId = '';\n\n  const reconnectOpts: ReconnectOptions = reconnect === true ? {} : reconnect === false ? { times: 0 } : reconnect;\n  const maxReconnects = reconnectOpts.times ?? (reconnect ? 5 : 0);\n  // `activeReconnectDelay` is mutable so the server's `retry:` field can update\n  // the reconnection interval without the caller needing to handle it manually.\n  let activeReconnectDelay: number | ((attempt: number) => number) = reconnectOpts.delay ?? fullJitterDelay;\n\n  function dispatchEvent(event: string, rawData: string): void {\n    const handlers = listeners.get(event);\n\n    if (!handlers?.size) return;\n\n    const data = parseEventData(rawData);\n\n    for (const handler of handlers) handler(data);\n  }\n\n  async function connect(): Promise<void> {\n    const res = await openStreamWith(\n      transport,\n      url,\n      ac,\n      {\n        body,\n        extSignal,\n        fetchInit,\n        headers: perRequestHeaders as Record<string, string> | undefined,\n        method,\n        params: params as Params | undefined,\n        query,\n        timeout: cfgTimeout,\n      },\n      {\n        accept: 'text/event-stream',\n        'cache-control': 'no-cache',\n        ...(lastEventId ? { 'last-event-id': lastEventId } : {}),\n      },\n    );\n\n    const reader = res.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let currentEvent = 'message';\n    let currentData = '';\n    let currentId = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n\n        if (done) break;\n\n        // Normalise \\r\\n and \\r to \\n before processing\n        buffer += decoder.decode(value, { stream: true }).replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n\n        let nlIdx: number;\n\n        while ((nlIdx = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, nlIdx);\n\n          buffer = buffer.slice(nlIdx + 1);\n\n          if (line === '') {\n            // Empty line → dispatch event\n            if (currentData !== '') {\n              if (currentId) lastEventId = currentId;\n\n              dispatchEvent(currentEvent, currentData.replace(/\\n$/, ''));\n            }\n\n            currentEvent = 'message';\n            currentData = '';\n            currentId = '';\n          } else if (line.startsWith(':')) {\n            // Comment — ignore\n          } else {\n            const colonIdx = line.indexOf(':');\n            const field = colonIdx === -1 ? line : line.slice(0, colonIdx);\n            const value = colonIdx === -1 ? '' : line.slice(colonIdx + 1).replace(/^ /, '');\n\n            if (field === 'event') currentEvent = value;\n            else if (field === 'data') currentData += (currentData ? '\\n' : '') + value;\n            else if (field === 'id' && !value.includes('\\0')) currentId = value;\n            else if (field === 'retry') {\n              // Honor the server's advised reconnect interval (SSE spec §9.2.6).\n              const ms = parseInt(value, 10);\n\n              if (!Number.isNaN(ms)) activeReconnectDelay = ms;\n            }\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  async function run(): Promise<void> {\n    let attempt = 0;\n\n    try {\n      while (!closed && !transport.disposed && !ac.signal.aborted) {\n        let connectError: Error | undefined;\n\n        sseStatus = 'connecting';\n\n        try {\n          sseStatus = 'open';\n          await connect();\n          // Clean server-side close — falls through to reconnect logic below.\n          // The attempt counter is intentionally NOT reset here: `times`\n          // bounds total reconnects regardless of whether the close was clean or an\n          // error, preventing infinite reconnection against servers that always close\n          // after a response window (e.g. SSE keepalive patterns).\n        } catch (err) {\n          if (closed || transport.disposed || ac.signal.aborted) break;\n\n          connectError = err instanceof Error ? err : new Error(String(err));\n        }\n\n        if (closed || transport.disposed || ac.signal.aborted) break;\n\n        // No reconnect budget → fire onError for errors, stop either way\n        if (maxReconnects === 0) {\n          if (connectError) onError?.(connectError);\n\n          break;\n        }\n\n        // Budget exhausted → always signal via onError so the caller knows\n        // the reconnect cycle has ended (whether the close was clean or not).\n        if (attempt >= maxReconnects) {\n          onError?.(connectError ?? new Error('[courier] SSE reconnect budget exhausted'));\n\n          break;\n        }\n\n        // Budget available → sleep and retry\n        sseStatus = 'reconnecting';\n\n        const delay = typeof activeReconnectDelay === 'function' ? activeReconnectDelay(attempt) : activeReconnectDelay;\n\n        attempt++;\n        await sleep(delay, ac.signal).catch(() => {});\n      }\n    } finally {\n      sseStatus = 'closed';\n      untrack();\n    }\n  }\n\n  // Surface unexpected programming errors (not network failures) via onError\n  run().catch((err) => {\n    if (!closed && !transport.disposed) {\n      onError?.(err instanceof Error ? err : new Error(String(err)));\n    }\n  });\n\n  return {\n    get closed(): boolean {\n      return closed;\n    },\n\n    dispose(): void {\n      closed = true;\n      ac.abort();\n      listeners.clear();\n    },\n\n    on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void {\n      // After dispose(), return a no-op to avoid silent dead-listener bugs\n      if (closed) return () => {};\n\n      let set = listeners.get(event);\n\n      if (!set) {\n        set = new Set<(data: unknown) => void>();\n        listeners.set(event, set);\n      }\n\n      set.add(handler as (data: unknown) => void);\n\n      return () => set.delete(handler as (data: unknown) => void);\n    },\n\n    get status(): SseStatus {\n      return sseStatus;\n    },\n\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/stream-sse.d.ts

@@ -1,59 +0,0 @@
-import { type ReconnectOptions, type StreamRequestConfig } from './stream-shared';
-import { type TransportCore } from './transport';
-export type SseOptions<P extends string = string> = StreamRequestConfig<P> & {
-    /**
-     * Called when the connection is permanently lost (reconnect budget exhausted due to error).
-     * Not called on `dispose()`.
-     */
-    onError?: (error: Error) => void;
-    /**
-     * Auto-reconnect on connection loss with exponential backoff.
-     * `true` uses defaults (5 attempts). Defaults to `false`.
-     */
-    reconnect?: boolean | ReconnectOptions;
-};
-/** Connection lifecycle status for an SSE source. */
-export type SseStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';
-/**
- * Typed SSE event source. `TEvents` maps event name → data type.
- * Non-string data values are automatically JSON-parsed from the raw `data:` field.
- * If parsing fails the raw string is delivered instead.
- */
-export type SseSource<TEvents extends Record<string, unknown> = Record<string, string>> = {
-    [Symbol.dispose](): void;
-    /** `true` after `dispose()` is called or the reconnect budget is exhausted. */
-    readonly closed: boolean;
-    /** Permanently closes the SSE connection. No further events will be dispatched. */
-    dispose(): void;
-    /**
-     * Registers a handler for a named SSE event. Returns an unsubscribe function.
-     * The special name `'message'` matches events without an explicit `event:` field.
-     * Calling `on()` after `dispose()` returns a no-op unsubscribe.
-     */
-    on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void;
-    /** Current connection lifecycle status. Useful for displaying a live-connection indicator. */
-    readonly status: SseStatus;
-};
-/**
- * Opens a Server-Sent Events connection and returns a typed source.
- *
- * - Intercepts request through the same pipeline as `createApi` (auth, logging, etc.)
- * - Auto-reconnects with exponential backoff when `reconnect` is set
- * - Sends `Last-Event-ID` header on reconnect to resume from last received event
- * - Non-string event data is automatically JSON-parsed
- *
- * @example
- * ```ts
- * const src = stream.sse<{ message: { text: string }; ping: null }>('/events', {
- *   reconnect: true,
- *   onError: (err) => console.error(err),
- * });
- *
- * src.on('message', (data) => console.log(data.text));
- * src.on('ping', () => {});
- * // later:
- * src.dispose();
- * ```
- */
-export declare function sse<TEvents extends Record<string, unknown> = Record<string, string>, P extends string = string>(transport: TransportCore, url: P, config?: SseOptions<P>): SseSource<TEvents>;
-//# sourceMappingURL=stream-sse.d.ts.map

package/dist/stream-sse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-sse.d.ts","sourceRoot":"","sources":["../src/stream-sse.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG;IAC3E;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CACxC,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;IACxF,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,OAAO,IAAI,IAAI,CAAC;IAChB;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAChG,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B,CAAC;AAWF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,GAAG,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAC7G,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,CAAC,EACN,MAAM,GAAE,UAAU,CAAC,CAAC,CAAuB,GAC1C,SAAS,CAAC,OAAO,CAAC,CA2NpB"}

package/dist/stream-sse.js

@@ -1,6 +0,0 @@
-import{CourierDisposedError as e}from"./errors.js";import{validateTimeout as t}from"./transport.js";import{fullJitterDelay as n}from"./retry.js";import{openStreamWith as r}from"./stream-shared.js";import{sleep as i}from"@vielzeug/arsenal";function a(e){try{return JSON.parse(e)}catch{return e}}function o(o,s,c={}){if(o.disposed)throw new e(`StreamClient`);let{body:l,fetchInit:u,headers:d,method:f=l===void 0?`GET`:`POST`,onError:p,params:m,query:h,reconnect:g=!1,signal:_,timeout:v}=c;v!==void 0&&t(v);let y=new Map,b=new AbortController,x=o.track(b),S=!1,C=`connecting`,w=``,T=g===!0?{}:g===!1?{times:0}:g,E=T.times??(g?5:0),D=T.delay??n;function O(e,t){let n=y.get(e);if(!n?.size)return;let r=a(t);for(let e of n)e(r)}async function k(){let e=(await r(o,s,b,{body:l,extSignal:_,fetchInit:u,headers:d,method:f,params:m,query:h,timeout:v},{accept:`text/event-stream`,"cache-control":`no-cache`,...w?{"last-event-id":w}:{}})).body.getReader(),t=new TextDecoder,n=``,i=`message`,a=``,c=``;try{for(;;){let{done:r,value:o}=await e.read();if(r)break;n+=t.decode(o,{stream:!0}).replace(/\r\n/g,`
-`).replace(/\r/g,`
-`);let s;for(;(s=n.indexOf(`
-`))!==-1;){let e=n.slice(0,s);if(n=n.slice(s+1),e===``)a!==``&&(c&&(w=c),O(i,a.replace(/\n$/,``))),i=`message`,a=``,c=``;else if(!e.startsWith(`:`)){let t=e.indexOf(`:`),n=t===-1?e:e.slice(0,t),r=t===-1?``:e.slice(t+1).replace(/^ /,``);if(n===`event`)i=r;else if(n===`data`)a+=(a?`
-`:``)+r;else if(n===`id`&&!r.includes(`\0`))c=r;else if(n===`retry`){let e=parseInt(r,10);Number.isNaN(e)||(D=e)}}}}}finally{e.releaseLock()}}async function A(){let e=0;try{for(;!S&&!o.disposed&&!b.signal.aborted;){let t;C=`connecting`;try{C=`open`,await k()}catch(e){if(S||o.disposed||b.signal.aborted)break;t=e instanceof Error?e:Error(String(e))}if(S||o.disposed||b.signal.aborted)break;if(E===0){t&&p?.(t);break}if(e>=E){p?.(t??Error(`[courier] SSE reconnect budget exhausted`));break}C=`reconnecting`;let n=typeof D==`function`?D(e):D;e++,await i(n,b.signal).catch(()=>{})}}finally{C=`closed`,x()}}return A().catch(e=>{!S&&!o.disposed&&p?.(e instanceof Error?e:Error(String(e)))}),{get closed(){return S},dispose(){S=!0,b.abort(),y.clear()},on(e,t){if(S)return()=>{};let n=y.get(e);return n||(n=new Set,y.set(e,n)),n.add(t),()=>n.delete(t)},get status(){return C},[Symbol.dispose](){this.dispose()}}}export{o as sse};
-//# sourceMappingURL=stream-sse.js.map