@vielzeug/courier 2.0.1 → 2.2.0

package/dist/query.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"query.cjs","names":[],"sources":["../src/query.ts"],"sourcesContent":["import type { AsyncState, QueryCache, QueryContext, QueryDefinition, QueryKey, Unsubscribe } from './types';\n\nimport { warn } from './_dev';\nimport { CourierDisposedError } from './errors';\nimport { hash } from './serialize';\n\nconst DEFAULT_STALE_TIME = 0;\n\ntype Entry = {\n  controller: AbortController | undefined;\n  definition: QueryDefinition<unknown> | undefined;\n  key: QueryKey;\n  promise: Promise<unknown> | undefined;\n  snapshot: AsyncState<unknown>;\n};\n\ntype CancellableQueryCache = QueryCache & {\n  cancelAll(): void;\n};\n\nfunction loading<T>(isFetching = false): AsyncState<T> {\n  return { data: undefined, error: null, isFetching, status: 'loading', updatedAt: undefined };\n}\n\n/** Transport-agnostic cache. Queries are identified by explicit keys and fetch definitions. */\nexport function createQueryCache(options?: { signal?: AbortSignal; staleTime?: number }): CancellableQueryCache {\n  const entries = new Map<string, Entry>();\n  const listeners = new Map<string, Set<Unsubscribe>>();\n  let disposed = options?.signal?.aborted ?? false;\n\n  const notify = (key: QueryKey): void => {\n    for (const listener of [...(listeners.get(hash(key)) ?? [])]) listener();\n  };\n\n  const cancelAll = (): void => {\n    for (const entry of entries.values()) entry.controller?.abort();\n  };\n\n  const clear = (): void => {\n    const keys = [...entries.values()].map((entry) => entry.key);\n\n    cancelAll();\n    entries.clear();\n\n    for (const key of keys) notify(key);\n  };\n\n  options?.signal?.addEventListener(\n    'abort',\n    () => {\n      disposed = true;\n      clear();\n    },\n    { once: true },\n  );\n\n  const entryFor = (key: QueryKey): Entry => {\n    const id = hash(key);\n    let entry = entries.get(id);\n\n    if (!entry) {\n      entry = {\n        controller: undefined,\n        definition: undefined,\n        key,\n        promise: undefined,\n        snapshot: loading(),\n      };\n      entries.set(id, entry);\n    }\n\n    return entry;\n  };\n\n  const fetchEntry = <T>(entry: Entry, force: boolean): Promise<T> => {\n    if (disposed) return Promise.reject(new CourierDisposedError('QueryCache'));\n\n    if (!entry.definition)\n      return Promise.reject(new Error(`No fetch function registered for query ${hash(entry.key)}.`));\n\n    const staleTime = entry.definition.staleTime ?? options?.staleTime ?? DEFAULT_STALE_TIME;\n\n    if (\n      !force &&\n      entry.snapshot.status === 'success' &&\n      Date.now() - entry.snapshot.updatedAt < staleTime &&\n      !entry.snapshot.isFetching\n    ) {\n      return Promise.resolve(entry.snapshot.data as T);\n    }\n\n    if (entry.promise) return entry.promise as Promise<T>;\n\n    const controller = new AbortController();\n\n    entry.controller = controller;\n    entry.snapshot =\n      entry.snapshot.status === 'success' ? { ...entry.snapshot, isFetching: true } : { ...loading<unknown>(true) };\n    notify(entry.key);\n\n    const promise = Promise.resolve()\n      .then(() => entry.definition!.fetch({ key: entry.key, signal: controller.signal } as QueryContext))\n      .then(\n        (data) => {\n          entry.snapshot = { data, error: null, isFetching: false, status: 'success', updatedAt: Date.now() };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n\n          return data;\n        },\n        (cause: unknown) => {\n          const error = cause instanceof Error ? cause : new Error(String(cause));\n\n          entry.snapshot = {\n            data: entry.snapshot.status === 'success' ? entry.snapshot.data : undefined,\n            error,\n            isFetching: false,\n            status: 'error',\n            updatedAt: Date.now(),\n          };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n\n          throw error;\n        },\n      );\n\n    entry.promise = promise;\n\n    return promise as Promise<T>;\n  };\n\n  return {\n    cancelAll,\n    clear,\n    fetch<T>(definition: QueryDefinition<T>, fetchOptions?: { force?: boolean }): Promise<T> {\n      const entry = entryFor(definition.key);\n\n      entry.definition = definition as QueryDefinition<unknown>;\n\n      return fetchEntry<T>(entry, fetchOptions?.force ?? false);\n    },\n    get<T>(key: QueryKey): T | undefined {\n      const entry = entries.get(hash(key));\n\n      return entry?.snapshot.status === 'success' ? (entry.snapshot.data as T) : undefined;\n    },\n    getSnapshot<T>(key: QueryKey): AsyncState<T> | null {\n      return (entries.get(hash(key))?.snapshot as AsyncState<T> | undefined) ?? null;\n    },\n    invalidate(key: QueryKey): void {\n      for (const entry of entries.values()) {\n        const matches =\n          key.length <= entry.key.length && key.every((atom, index) => hash(atom) === hash(entry.key[index]));\n\n        if (matches) {\n          if (entry.snapshot.status === 'success') entry.snapshot = { ...entry.snapshot, updatedAt: 0 };\n\n          notify(entry.key);\n        }\n      }\n    },\n    keys(): QueryKey[] {\n      return [...entries.values()].map((entry) => entry.key);\n    },\n    refetchStale(): void {\n      for (const entry of entries.values()) {\n        if (!entry.definition || entry.snapshot.status !== 'success' || entry.snapshot.isFetching) continue;\n\n        const staleTime = entry.definition.staleTime ?? options?.staleTime ?? DEFAULT_STALE_TIME;\n\n        if (Date.now() - entry.snapshot.updatedAt >= staleTime) {\n          void fetchEntry(entry, true).catch(() => {\n            warn(`Failed to refetch stale query ${hash(entry.key)}.`);\n          });\n        }\n      }\n    },\n    set<T>(key: QueryKey, data: T, setOptions?: { updatedAt?: number }): void {\n      const entry = entryFor(key);\n\n      entry.snapshot = {\n        data,\n        error: null,\n        isFetching: false,\n        status: 'success',\n        updatedAt: setOptions?.updatedAt ?? Date.now(),\n      };\n      notify(key);\n    },\n    subscribe(key: QueryKey, listener: () => void): Unsubscribe {\n      const id = hash(key);\n      const keyListeners = listeners.get(id) ?? new Set<Unsubscribe>();\n\n      keyListeners.add(listener);\n      listeners.set(id, keyListeners);\n\n      return () => {\n        keyListeners.delete(listener);\n\n        if (keyListeners.size === 0) listeners.delete(id);\n      };\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"query.cjs","names":[],"sources":["../src/query.ts"],"sourcesContent":["import { hash } from '@vielzeug/arsenal/object';\nimport { CourierDisposedError } from './errors';\nimport type { AsyncState, QueryCache, QueryContext, QueryDefinition, QueryKey, Unsubscribe } from './types';\n\nconst DEFAULT_STALE_TIME = 0;\nconst DEFAULT_GC_TIME = 5 * 60_000;\n\ntype Entry = {\n  controller: AbortController | undefined;\n  definition: QueryDefinition<unknown> | undefined;\n  key: QueryKey;\n  promise: Promise<unknown> | undefined;\n  snapshot: AsyncState<unknown>;\n};\n\ntype CancellableQueryCache = QueryCache & {\n  cancelAll(): void;\n};\n\nfunction loading<T>(isFetching = false): AsyncState<T> {\n  return { data: undefined, error: null, isFetching, status: 'loading', updatedAt: undefined };\n}\n\n/** Transport-agnostic cache. Queries are identified by explicit keys and fetch definitions.\n *  Entries with no subscribers are garbage-collected after `gcTime` (default 5 min; `Infinity` disables). */\nexport function createQueryCache(options?: {\n  gcTime?: number;\n  signal?: AbortSignal;\n  staleTime?: number;\n}): CancellableQueryCache {\n  const staleTime = options?.staleTime ?? DEFAULT_STALE_TIME;\n  const gcTime = options?.gcTime ?? DEFAULT_GC_TIME;\n  const entries = new Map<string, Entry>();\n  const listeners = new Map<string, Set<Unsubscribe>>();\n  let disposed = options?.signal?.aborted ?? false;\n  let gcTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const hasSubscribers = (id: string): boolean => (listeners.get(id)?.size ?? 0) > 0;\n\n  const notify = (key: QueryKey): void => {\n    for (const listener of [...(listeners.get(hash(key)) ?? [])]) listener();\n  };\n\n  const scheduleGc = (): void => {\n    if (gcTime === Number.POSITIVE_INFINITY || disposed) {\n      if (gcTimer) clearTimeout(gcTimer);\n      gcTimer = undefined;\n      return;\n    }\n\n    if (gcTimer) clearTimeout(gcTimer);\n\n    let earliest: number | undefined;\n\n    for (const entry of entries.values()) {\n      if (entry.snapshot.status !== 'success' || entry.promise) continue;\n      if (hasSubscribers(hash(entry.key))) continue;\n\n      const expiresAt = entry.snapshot.updatedAt + gcTime;\n\n      if (earliest === undefined || expiresAt < earliest) earliest = expiresAt;\n    }\n\n    if (earliest === undefined) {\n      gcTimer = undefined;\n      return;\n    }\n\n    gcTimer = setTimeout(runGc, Math.max(0, earliest - Date.now()));\n  };\n\n  const runGc = (): void => {\n    const now = Date.now();\n\n    for (const [id, entry] of entries) {\n      if (entry.snapshot.status !== 'success' || entry.promise) continue;\n      if (hasSubscribers(id)) continue;\n      if (now - entry.snapshot.updatedAt >= gcTime) entries.delete(id);\n    }\n\n    scheduleGc();\n  };\n\n  const cancelAll = (): void => {\n    for (const entry of entries.values()) entry.controller?.abort();\n  };\n\n  const clear = (): void => {\n    const keys = [...entries.values()].map((entry) => entry.key);\n\n    cancelAll();\n    entries.clear();\n\n    if (gcTimer) {\n      clearTimeout(gcTimer);\n      gcTimer = undefined;\n    }\n\n    for (const key of keys) notify(key);\n  };\n\n  options?.signal?.addEventListener(\n    'abort',\n    () => {\n      disposed = true;\n      clear();\n    },\n    { once: true },\n  );\n\n  const entryFor = (key: QueryKey): Entry => {\n    const id = hash(key);\n    let entry = entries.get(id);\n\n    if (!entry) {\n      entry = {\n        controller: undefined,\n        definition: undefined,\n        key,\n        promise: undefined,\n        snapshot: loading(),\n      };\n      entries.set(id, entry);\n    }\n\n    return entry;\n  };\n\n  const fetchEntry = <T>(entry: Entry, force: boolean): Promise<T> => {\n    if (disposed) return Promise.reject(new CourierDisposedError('QueryCache'));\n\n    if (!entry.definition)\n      return Promise.reject(new Error(`No fetch function registered for query ${hash(entry.key)}.`));\n\n    const entryStaleTime = entry.definition.staleTime ?? staleTime;\n\n    if (\n      !force &&\n      entry.snapshot.status === 'success' &&\n      Date.now() - entry.snapshot.updatedAt < entryStaleTime &&\n      !entry.snapshot.isFetching\n    ) {\n      return Promise.resolve(entry.snapshot.data as T);\n    }\n\n    if (entry.promise) return entry.promise as Promise<T>;\n\n    const controller = new AbortController();\n\n    entry.controller = controller;\n    entry.snapshot =\n      entry.snapshot.status === 'success' ? { ...entry.snapshot, isFetching: true } : { ...loading<unknown>(true) };\n    notify(entry.key);\n\n    const promise = Promise.resolve()\n      .then(() => entry.definition?.fetch({ key: entry.key, signal: controller.signal } as QueryContext))\n      .then(\n        (data) => {\n          entry.snapshot = { data, error: null, isFetching: false, status: 'success', updatedAt: Date.now() };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n          scheduleGc();\n\n          return data;\n        },\n        (cause: unknown) => {\n          const error = cause instanceof Error ? cause : new Error(String(cause));\n\n          entry.snapshot = {\n            data: entry.snapshot.status === 'success' ? entry.snapshot.data : undefined,\n            error,\n            isFetching: false,\n            status: 'error',\n            updatedAt: Date.now(),\n          };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n\n          throw error;\n        },\n      );\n\n    entry.promise = promise;\n\n    return promise as Promise<T>;\n  };\n\n  return {\n    cancelAll,\n    clear,\n    fetch<T>(definition: QueryDefinition<T>, fetchOptions?: { force?: boolean }): Promise<T> {\n      const entry = entryFor(definition.key);\n\n      entry.definition = definition as QueryDefinition<unknown>;\n\n      return fetchEntry<T>(entry, fetchOptions?.force ?? false);\n    },\n    get<T>(key: QueryKey): T | undefined {\n      const entry = entries.get(hash(key));\n\n      return entry?.snapshot.status === 'success' ? (entry.snapshot.data as T) : undefined;\n    },\n    getSnapshot<T>(key: QueryKey): AsyncState<T> | null {\n      return (entries.get(hash(key))?.snapshot as AsyncState<T> | undefined) ?? null;\n    },\n    invalidate(prefix: readonly unknown[], invalidateOptions?: { refetch?: boolean }): void {\n      const refetch = invalidateOptions?.refetch ?? false;\n      let invalidated = false;\n\n      for (const entry of entries.values()) {\n        const matches = prefix.length <= entry.key.length && prefix.every((atom, index) => atom === entry.key[index]);\n\n        if (matches) {\n          if (entry.snapshot.status === 'success') entry.snapshot = { ...entry.snapshot, updatedAt: 0 };\n\n          notify(entry.key);\n\n          if (refetch && entry.definition && !entry.promise) {\n            void fetchEntry(entry, true).catch(() => {\n              /* Error surfaces through cache snapshot; suppress unhandled rejection. */\n            });\n          }\n\n          invalidated = true;\n        }\n      }\n\n      if (invalidated) scheduleGc();\n    },\n    keys(): QueryKey[] {\n      return [...entries.values()].map((entry) => entry.key);\n    },\n    set<T>(key: QueryKey, data: T, setOptions?: { updatedAt?: number }): void {\n      const entry = entryFor(key);\n\n      entry.snapshot = {\n        data,\n        error: null,\n        isFetching: false,\n        status: 'success',\n        updatedAt: setOptions?.updatedAt ?? Date.now(),\n      };\n      notify(key);\n      scheduleGc();\n    },\n    subscribe(key: QueryKey, listener: () => void): Unsubscribe {\n      const id = hash(key);\n      const keyListeners = listeners.get(id) ?? new Set<Unsubscribe>();\n\n      keyListeners.add(listener);\n      listeners.set(id, keyListeners);\n\n      return () => {\n        keyListeners.delete(listener);\n\n        if (keyListeners.size === 0) {\n          listeners.delete(id);\n          scheduleGc();\n        }\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/query.d.ts

@@ -2,8 +2,10 @@ import type { QueryCache } from './types';
 type CancellableQueryCache = QueryCache & {
     cancelAll(): void;
 };
-/** Transport-agnostic cache. Queries are identified by explicit keys and fetch definitions. */
+/** Transport-agnostic cache. Queries are identified by explicit keys and fetch definitions.
+ *  Entries with no subscribers are garbage-collected after `gcTime` (default 5 min; `Infinity` disables). */
 export declare function createQueryCache(options?: {
+    gcTime?: number;
     signal?: AbortSignal;
     staleTime?: number;
 }): CancellableQueryCache;

package/dist/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,UAAU,EAAwD,MAAM,SAAS,CAAC;AAgB5G,KAAK,qBAAqB,GAAG,UAAU,GAAG;IACxC,SAAS,IAAI,IAAI,CAAC;CACnB,CAAC;AAMF,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,qBAAqB,CAqL9G"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,UAAU,EAAwD,MAAM,SAAS,CAAC;AAa5G,KAAK,qBAAqB,GAAG,UAAU,GAAG;IACxC,SAAS,IAAI,IAAI,CAAC;CACnB,CAAC;AAMF;6GAC6G;AAC7G,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CA2OxB"}

package/dist/query.js

@@ -1,2 +1,2 @@
-import{CourierDisposedError as e}from"./errors.js";import{hash as t}from"./serialize.js";import"./_dev.js";var n=0;function r(e=!1){return{data:void 0,error:null,isFetching:e,status:`loading`,updatedAt:void 0}}function i(i){let a=new Map,o=new Map,s=i?.signal?.aborted??!1,c=e=>{for(let n of[...o.get(t(e))??[]])n()},l=()=>{for(let e of a.values())e.controller?.abort()},u=()=>{let e=[...a.values()].map(e=>e.key);l(),a.clear();for(let t of e)c(t)};i?.signal?.addEventListener(`abort`,()=>{s=!0,u()},{once:!0});let d=e=>{let n=t(e),i=a.get(n);return i||(i={controller:void 0,definition:void 0,key:e,promise:void 0,snapshot:r()},a.set(n,i)),i},f=(a,o)=>{if(s)return Promise.reject(new e(`QueryCache`));if(!a.definition)return Promise.reject(Error(`No fetch function registered for query ${t(a.key)}.`));let l=a.definition.staleTime??i?.staleTime??n;if(!o&&a.snapshot.status===`success`&&Date.now()-a.snapshot.updatedAt<l&&!a.snapshot.isFetching)return Promise.resolve(a.snapshot.data);if(a.promise)return a.promise;let u=new AbortController;a.controller=u,a.snapshot=a.snapshot.status===`success`?{...a.snapshot,isFetching:!0}:{...r(!0)},c(a.key);let d=Promise.resolve().then(()=>a.definition.fetch({key:a.key,signal:u.signal})).then(e=>(a.snapshot={data:e,error:null,isFetching:!1,status:`success`,updatedAt:Date.now()},a.controller=void 0,a.promise=void 0,c(a.key),e),e=>{let t=e instanceof Error?e:Error(String(e));throw a.snapshot={data:a.snapshot.status===`success`?a.snapshot.data:void 0,error:t,isFetching:!1,status:`error`,updatedAt:Date.now()},a.controller=void 0,a.promise=void 0,c(a.key),t});return a.promise=d,d};return{cancelAll:l,clear:u,fetch(e,t){let n=d(e.key);return n.definition=e,f(n,t?.force??!1)},get(e){let n=a.get(t(e));return n?.snapshot.status===`success`?n.snapshot.data:void 0},getSnapshot(e){return a.get(t(e))?.snapshot??null},invalidate(e){for(let n of a.values())e.length<=n.key.length&&e.every((e,r)=>t(e)===t(n.key[r]))&&(n.snapshot.status===`success`&&(n.snapshot={...n.snapshot,updatedAt:0}),c(n.key))},keys(){return[...a.values()].map(e=>e.key)},refetchStale(){for(let e of a.values()){if(!e.definition||e.snapshot.status!==`success`||e.snapshot.isFetching)continue;let r=e.definition.staleTime??i?.staleTime??n;Date.now()-e.snapshot.updatedAt>=r&&f(e,!0).catch(()=>{`${t(e.key)}`})}},set(e,t,n){let r=d(e);r.snapshot={data:t,error:null,isFetching:!1,status:`success`,updatedAt:n?.updatedAt??Date.now()},c(e)},subscribe(e,n){let r=t(e),i=o.get(r)??new Set;return i.add(n),o.set(r,i),()=>{i.delete(n),i.size===0&&o.delete(r)}}}}export{i as createQueryCache};
+import{CourierDisposedError as e}from"./errors.js";import{hash as t}from"@vielzeug/arsenal/object";var n=0,r=3e5;function i(e=!1){return{data:void 0,error:null,isFetching:e,status:`loading`,updatedAt:void 0}}function a(a){let o=a?.staleTime??n,s=a?.gcTime??r,c=new Map,l=new Map,u=a?.signal?.aborted??!1,d,f=e=>(l.get(e)?.size??0)>0,p=e=>{for(let n of[...l.get(t(e))??[]])n()},m=()=>{if(s===1/0||u){d&&clearTimeout(d),d=void 0;return}d&&clearTimeout(d);let e;for(let n of c.values()){if(n.snapshot.status!==`success`||n.promise||f(t(n.key)))continue;let r=n.snapshot.updatedAt+s;(e===void 0||r<e)&&(e=r)}if(e===void 0){d=void 0;return}d=setTimeout(h,Math.max(0,e-Date.now()))},h=()=>{let e=Date.now();for(let[t,n]of c)n.snapshot.status!==`success`||n.promise||f(t)||e-n.snapshot.updatedAt>=s&&c.delete(t);m()},g=()=>{for(let e of c.values())e.controller?.abort()},_=()=>{let e=[...c.values()].map(e=>e.key);g(),c.clear(),d&&=(clearTimeout(d),void 0);for(let t of e)p(t)};a?.signal?.addEventListener(`abort`,()=>{u=!0,_()},{once:!0});let v=e=>{let n=t(e),r=c.get(n);return r||(r={controller:void 0,definition:void 0,key:e,promise:void 0,snapshot:i()},c.set(n,r)),r},y=(n,r)=>{if(u)return Promise.reject(new e(`QueryCache`));if(!n.definition)return Promise.reject(Error(`No fetch function registered for query ${t(n.key)}.`));let a=n.definition.staleTime??o;if(!r&&n.snapshot.status===`success`&&Date.now()-n.snapshot.updatedAt<a&&!n.snapshot.isFetching)return Promise.resolve(n.snapshot.data);if(n.promise)return n.promise;let s=new AbortController;n.controller=s,n.snapshot=n.snapshot.status===`success`?{...n.snapshot,isFetching:!0}:{...i(!0)},p(n.key);let c=Promise.resolve().then(()=>n.definition?.fetch({key:n.key,signal:s.signal})).then(e=>(n.snapshot={data:e,error:null,isFetching:!1,status:`success`,updatedAt:Date.now()},n.controller=void 0,n.promise=void 0,p(n.key),m(),e),e=>{let t=e instanceof Error?e:Error(String(e));throw n.snapshot={data:n.snapshot.status===`success`?n.snapshot.data:void 0,error:t,isFetching:!1,status:`error`,updatedAt:Date.now()},n.controller=void 0,n.promise=void 0,p(n.key),t});return n.promise=c,c};return{cancelAll:g,clear:_,fetch(e,t){let n=v(e.key);return n.definition=e,y(n,t?.force??!1)},get(e){let n=c.get(t(e));return n?.snapshot.status===`success`?n.snapshot.data:void 0},getSnapshot(e){return c.get(t(e))?.snapshot??null},invalidate(e,t){let n=t?.refetch??!1,r=!1;for(let t of c.values())e.length<=t.key.length&&e.every((e,n)=>e===t.key[n])&&(t.snapshot.status===`success`&&(t.snapshot={...t.snapshot,updatedAt:0}),p(t.key),n&&t.definition&&!t.promise&&y(t,!0).catch(()=>{}),r=!0);r&&m()},keys(){return[...c.values()].map(e=>e.key)},set(e,t,n){let r=v(e);r.snapshot={data:t,error:null,isFetching:!1,status:`success`,updatedAt:n?.updatedAt??Date.now()},p(e),m()},subscribe(e,n){let r=t(e),i=l.get(r)??new Set;return i.add(n),l.set(r,i),()=>{i.delete(n),i.size===0&&(l.delete(r),m())}}}}export{a as createQueryCache};
 //# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","names":[],"sources":["../src/query.ts"],"sourcesContent":["import type { AsyncState, QueryCache, QueryContext, QueryDefinition, QueryKey, Unsubscribe } from './types';\n\nimport { warn } from './_dev';\nimport { CourierDisposedError } from './errors';\nimport { hash } from './serialize';\n\nconst DEFAULT_STALE_TIME = 0;\n\ntype Entry = {\n  controller: AbortController | undefined;\n  definition: QueryDefinition<unknown> | undefined;\n  key: QueryKey;\n  promise: Promise<unknown> | undefined;\n  snapshot: AsyncState<unknown>;\n};\n\ntype CancellableQueryCache = QueryCache & {\n  cancelAll(): void;\n};\n\nfunction loading<T>(isFetching = false): AsyncState<T> {\n  return { data: undefined, error: null, isFetching, status: 'loading', updatedAt: undefined };\n}\n\n/** Transport-agnostic cache. Queries are identified by explicit keys and fetch definitions. */\nexport function createQueryCache(options?: { signal?: AbortSignal; staleTime?: number }): CancellableQueryCache {\n  const entries = new Map<string, Entry>();\n  const listeners = new Map<string, Set<Unsubscribe>>();\n  let disposed = options?.signal?.aborted ?? false;\n\n  const notify = (key: QueryKey): void => {\n    for (const listener of [...(listeners.get(hash(key)) ?? [])]) listener();\n  };\n\n  const cancelAll = (): void => {\n    for (const entry of entries.values()) entry.controller?.abort();\n  };\n\n  const clear = (): void => {\n    const keys = [...entries.values()].map((entry) => entry.key);\n\n    cancelAll();\n    entries.clear();\n\n    for (const key of keys) notify(key);\n  };\n\n  options?.signal?.addEventListener(\n    'abort',\n    () => {\n      disposed = true;\n      clear();\n    },\n    { once: true },\n  );\n\n  const entryFor = (key: QueryKey): Entry => {\n    const id = hash(key);\n    let entry = entries.get(id);\n\n    if (!entry) {\n      entry = {\n        controller: undefined,\n        definition: undefined,\n        key,\n        promise: undefined,\n        snapshot: loading(),\n      };\n      entries.set(id, entry);\n    }\n\n    return entry;\n  };\n\n  const fetchEntry = <T>(entry: Entry, force: boolean): Promise<T> => {\n    if (disposed) return Promise.reject(new CourierDisposedError('QueryCache'));\n\n    if (!entry.definition)\n      return Promise.reject(new Error(`No fetch function registered for query ${hash(entry.key)}.`));\n\n    const staleTime = entry.definition.staleTime ?? options?.staleTime ?? DEFAULT_STALE_TIME;\n\n    if (\n      !force &&\n      entry.snapshot.status === 'success' &&\n      Date.now() - entry.snapshot.updatedAt < staleTime &&\n      !entry.snapshot.isFetching\n    ) {\n      return Promise.resolve(entry.snapshot.data as T);\n    }\n\n    if (entry.promise) return entry.promise as Promise<T>;\n\n    const controller = new AbortController();\n\n    entry.controller = controller;\n    entry.snapshot =\n      entry.snapshot.status === 'success' ? { ...entry.snapshot, isFetching: true } : { ...loading<unknown>(true) };\n    notify(entry.key);\n\n    const promise = Promise.resolve()\n      .then(() => entry.definition!.fetch({ key: entry.key, signal: controller.signal } as QueryContext))\n      .then(\n        (data) => {\n          entry.snapshot = { data, error: null, isFetching: false, status: 'success', updatedAt: Date.now() };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n\n          return data;\n        },\n        (cause: unknown) => {\n          const error = cause instanceof Error ? cause : new Error(String(cause));\n\n          entry.snapshot = {\n            data: entry.snapshot.status === 'success' ? entry.snapshot.data : undefined,\n            error,\n            isFetching: false,\n            status: 'error',\n            updatedAt: Date.now(),\n          };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n\n          throw error;\n        },\n      );\n\n    entry.promise = promise;\n\n    return promise as Promise<T>;\n  };\n\n  return {\n    cancelAll,\n    clear,\n    fetch<T>(definition: QueryDefinition<T>, fetchOptions?: { force?: boolean }): Promise<T> {\n      const entry = entryFor(definition.key);\n\n      entry.definition = definition as QueryDefinition<unknown>;\n\n      return fetchEntry<T>(entry, fetchOptions?.force ?? false);\n    },\n    get<T>(key: QueryKey): T | undefined {\n      const entry = entries.get(hash(key));\n\n      return entry?.snapshot.status === 'success' ? (entry.snapshot.data as T) : undefined;\n    },\n    getSnapshot<T>(key: QueryKey): AsyncState<T> | null {\n      return (entries.get(hash(key))?.snapshot as AsyncState<T> | undefined) ?? null;\n    },\n    invalidate(key: QueryKey): void {\n      for (const entry of entries.values()) {\n        const matches =\n          key.length <= entry.key.length && key.every((atom, index) => hash(atom) === hash(entry.key[index]));\n\n        if (matches) {\n          if (entry.snapshot.status === 'success') entry.snapshot = { ...entry.snapshot, updatedAt: 0 };\n\n          notify(entry.key);\n        }\n      }\n    },\n    keys(): QueryKey[] {\n      return [...entries.values()].map((entry) => entry.key);\n    },\n    refetchStale(): void {\n      for (const entry of entries.values()) {\n        if (!entry.definition || entry.snapshot.status !== 'success' || entry.snapshot.isFetching) continue;\n\n        const staleTime = entry.definition.staleTime ?? options?.staleTime ?? DEFAULT_STALE_TIME;\n\n        if (Date.now() - entry.snapshot.updatedAt >= staleTime) {\n          void fetchEntry(entry, true).catch(() => {\n            warn(`Failed to refetch stale query ${hash(entry.key)}.`);\n          });\n        }\n      }\n    },\n    set<T>(key: QueryKey, data: T, setOptions?: { updatedAt?: number }): void {\n      const entry = entryFor(key);\n\n      entry.snapshot = {\n        data,\n        error: null,\n        isFetching: false,\n        status: 'success',\n        updatedAt: setOptions?.updatedAt ?? Date.now(),\n      };\n      notify(key);\n    },\n    subscribe(key: QueryKey, listener: () => void): Unsubscribe {\n      const id = hash(key);\n      const keyListeners = listeners.get(id) ?? new Set<Unsubscribe>();\n\n      keyListeners.add(listener);\n      listeners.set(id, keyListeners);\n\n      return () => {\n        keyListeners.delete(listener);\n\n        if (keyListeners.size === 0) listeners.delete(id);\n      };\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"query.js","names":[],"sources":["../src/query.ts"],"sourcesContent":["import { hash } from '@vielzeug/arsenal/object';\nimport { CourierDisposedError } from './errors';\nimport type { AsyncState, QueryCache, QueryContext, QueryDefinition, QueryKey, Unsubscribe } from './types';\n\nconst DEFAULT_STALE_TIME = 0;\nconst DEFAULT_GC_TIME = 5 * 60_000;\n\ntype Entry = {\n  controller: AbortController | undefined;\n  definition: QueryDefinition<unknown> | undefined;\n  key: QueryKey;\n  promise: Promise<unknown> | undefined;\n  snapshot: AsyncState<unknown>;\n};\n\ntype CancellableQueryCache = QueryCache & {\n  cancelAll(): void;\n};\n\nfunction loading<T>(isFetching = false): AsyncState<T> {\n  return { data: undefined, error: null, isFetching, status: 'loading', updatedAt: undefined };\n}\n\n/** Transport-agnostic cache. Queries are identified by explicit keys and fetch definitions.\n *  Entries with no subscribers are garbage-collected after `gcTime` (default 5 min; `Infinity` disables). */\nexport function createQueryCache(options?: {\n  gcTime?: number;\n  signal?: AbortSignal;\n  staleTime?: number;\n}): CancellableQueryCache {\n  const staleTime = options?.staleTime ?? DEFAULT_STALE_TIME;\n  const gcTime = options?.gcTime ?? DEFAULT_GC_TIME;\n  const entries = new Map<string, Entry>();\n  const listeners = new Map<string, Set<Unsubscribe>>();\n  let disposed = options?.signal?.aborted ?? false;\n  let gcTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const hasSubscribers = (id: string): boolean => (listeners.get(id)?.size ?? 0) > 0;\n\n  const notify = (key: QueryKey): void => {\n    for (const listener of [...(listeners.get(hash(key)) ?? [])]) listener();\n  };\n\n  const scheduleGc = (): void => {\n    if (gcTime === Number.POSITIVE_INFINITY || disposed) {\n      if (gcTimer) clearTimeout(gcTimer);\n      gcTimer = undefined;\n      return;\n    }\n\n    if (gcTimer) clearTimeout(gcTimer);\n\n    let earliest: number | undefined;\n\n    for (const entry of entries.values()) {\n      if (entry.snapshot.status !== 'success' || entry.promise) continue;\n      if (hasSubscribers(hash(entry.key))) continue;\n\n      const expiresAt = entry.snapshot.updatedAt + gcTime;\n\n      if (earliest === undefined || expiresAt < earliest) earliest = expiresAt;\n    }\n\n    if (earliest === undefined) {\n      gcTimer = undefined;\n      return;\n    }\n\n    gcTimer = setTimeout(runGc, Math.max(0, earliest - Date.now()));\n  };\n\n  const runGc = (): void => {\n    const now = Date.now();\n\n    for (const [id, entry] of entries) {\n      if (entry.snapshot.status !== 'success' || entry.promise) continue;\n      if (hasSubscribers(id)) continue;\n      if (now - entry.snapshot.updatedAt >= gcTime) entries.delete(id);\n    }\n\n    scheduleGc();\n  };\n\n  const cancelAll = (): void => {\n    for (const entry of entries.values()) entry.controller?.abort();\n  };\n\n  const clear = (): void => {\n    const keys = [...entries.values()].map((entry) => entry.key);\n\n    cancelAll();\n    entries.clear();\n\n    if (gcTimer) {\n      clearTimeout(gcTimer);\n      gcTimer = undefined;\n    }\n\n    for (const key of keys) notify(key);\n  };\n\n  options?.signal?.addEventListener(\n    'abort',\n    () => {\n      disposed = true;\n      clear();\n    },\n    { once: true },\n  );\n\n  const entryFor = (key: QueryKey): Entry => {\n    const id = hash(key);\n    let entry = entries.get(id);\n\n    if (!entry) {\n      entry = {\n        controller: undefined,\n        definition: undefined,\n        key,\n        promise: undefined,\n        snapshot: loading(),\n      };\n      entries.set(id, entry);\n    }\n\n    return entry;\n  };\n\n  const fetchEntry = <T>(entry: Entry, force: boolean): Promise<T> => {\n    if (disposed) return Promise.reject(new CourierDisposedError('QueryCache'));\n\n    if (!entry.definition)\n      return Promise.reject(new Error(`No fetch function registered for query ${hash(entry.key)}.`));\n\n    const entryStaleTime = entry.definition.staleTime ?? staleTime;\n\n    if (\n      !force &&\n      entry.snapshot.status === 'success' &&\n      Date.now() - entry.snapshot.updatedAt < entryStaleTime &&\n      !entry.snapshot.isFetching\n    ) {\n      return Promise.resolve(entry.snapshot.data as T);\n    }\n\n    if (entry.promise) return entry.promise as Promise<T>;\n\n    const controller = new AbortController();\n\n    entry.controller = controller;\n    entry.snapshot =\n      entry.snapshot.status === 'success' ? { ...entry.snapshot, isFetching: true } : { ...loading<unknown>(true) };\n    notify(entry.key);\n\n    const promise = Promise.resolve()\n      .then(() => entry.definition?.fetch({ key: entry.key, signal: controller.signal } as QueryContext))\n      .then(\n        (data) => {\n          entry.snapshot = { data, error: null, isFetching: false, status: 'success', updatedAt: Date.now() };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n          scheduleGc();\n\n          return data;\n        },\n        (cause: unknown) => {\n          const error = cause instanceof Error ? cause : new Error(String(cause));\n\n          entry.snapshot = {\n            data: entry.snapshot.status === 'success' ? entry.snapshot.data : undefined,\n            error,\n            isFetching: false,\n            status: 'error',\n            updatedAt: Date.now(),\n          };\n          entry.controller = undefined;\n          entry.promise = undefined;\n          notify(entry.key);\n\n          throw error;\n        },\n      );\n\n    entry.promise = promise;\n\n    return promise as Promise<T>;\n  };\n\n  return {\n    cancelAll,\n    clear,\n    fetch<T>(definition: QueryDefinition<T>, fetchOptions?: { force?: boolean }): Promise<T> {\n      const entry = entryFor(definition.key);\n\n      entry.definition = definition as QueryDefinition<unknown>;\n\n      return fetchEntry<T>(entry, fetchOptions?.force ?? false);\n    },\n    get<T>(key: QueryKey): T | undefined {\n      const entry = entries.get(hash(key));\n\n      return entry?.snapshot.status === 'success' ? (entry.snapshot.data as T) : undefined;\n    },\n    getSnapshot<T>(key: QueryKey): AsyncState<T> | null {\n      return (entries.get(hash(key))?.snapshot as AsyncState<T> | undefined) ?? null;\n    },\n    invalidate(prefix: readonly unknown[], invalidateOptions?: { refetch?: boolean }): void {\n      const refetch = invalidateOptions?.refetch ?? false;\n      let invalidated = false;\n\n      for (const entry of entries.values()) {\n        const matches = prefix.length <= entry.key.length && prefix.every((atom, index) => atom === entry.key[index]);\n\n        if (matches) {\n          if (entry.snapshot.status === 'success') entry.snapshot = { ...entry.snapshot, updatedAt: 0 };\n\n          notify(entry.key);\n\n          if (refetch && entry.definition && !entry.promise) {\n            void fetchEntry(entry, true).catch(() => {\n              /* Error surfaces through cache snapshot; suppress unhandled rejection. */\n            });\n          }\n\n          invalidated = true;\n        }\n      }\n\n      if (invalidated) scheduleGc();\n    },\n    keys(): QueryKey[] {\n      return [...entries.values()].map((entry) => entry.key);\n    },\n    set<T>(key: QueryKey, data: T, setOptions?: { updatedAt?: number }): void {\n      const entry = entryFor(key);\n\n      entry.snapshot = {\n        data,\n        error: null,\n        isFetching: false,\n        status: 'success',\n        updatedAt: setOptions?.updatedAt ?? Date.now(),\n      };\n      notify(key);\n      scheduleGc();\n    },\n    subscribe(key: QueryKey, listener: () => void): Unsubscribe {\n      const id = hash(key);\n      const keyListeners = listeners.get(id) ?? new Set<Unsubscribe>();\n\n      keyListeners.add(listener);\n      listeners.set(id, keyListeners);\n\n      return () => {\n        keyListeners.delete(listener);\n\n        if (keyListeners.size === 0) {\n          listeners.delete(id);\n          scheduleGc();\n        }\n      };\n    },\n  };\n}\n"],"mappings":"mGAIA,IAAM,EAAqB,EACrB,EAAkB,IAcxB,SAAS,EAAW,EAAa,GAAsB,CACrD,MAAO,CAAE,KAAM,IAAA,GAAW,MAAO,KAAM,aAAY,OAAQ,UAAW,UAAW,IAAA,EAAU,CAC7F,CAIA,SAAgB,EAAiB,EAIP,CACxB,IAAM,EAAY,GAAS,WAAa,EAClC,EAAS,GAAS,QAAU,EAC5B,EAAU,IAAI,IACd,EAAY,IAAI,IAClB,EAAW,GAAS,QAAQ,SAAW,GACvC,EAEE,EAAkB,IAAyB,EAAU,IAAI,CAAE,CAAC,EAAE,MAAQ,GAAK,EAE3E,EAAU,GAAwB,CACtC,IAAK,IAAM,IAAY,CAAC,GAAI,EAAU,IAAI,EAAK,CAAG,CAAC,GAAK,CAAC,CAAE,EAAG,EAAS,CACzE,EAEM,MAAyB,CAC7B,GAAI,IAAW,KAA4B,EAAU,CAC/C,GAAS,aAAa,CAAO,EACjC,EAAU,IAAA,GACV,MACF,CAEI,GAAS,aAAa,CAAO,EAEjC,IAAI,EAEJ,IAAK,IAAM,KAAS,EAAQ,OAAO,EAAG,CAEpC,GADI,EAAM,SAAS,SAAW,WAAa,EAAM,SAC7C,EAAe,EAAK,EAAM,GAAG,CAAC,EAAG,SAErC,IAAM,EAAY,EAAM,SAAS,UAAY,GAEzC,IAAa,IAAA,IAAa,EAAY,KAAU,EAAW,EACjE,CAEA,GAAI,IAAa,IAAA,GAAW,CAC1B,EAAU,IAAA,GACV,MACF,CAEA,EAAU,WAAW,EAAO,KAAK,IAAI,EAAG,EAAW,KAAK,IAAI,CAAC,CAAC,CAChE,EAEM,MAAoB,CACxB,IAAM,EAAM,KAAK,IAAI,EAErB,IAAK,GAAM,CAAC,EAAI,KAAU,EACpB,EAAM,SAAS,SAAW,WAAa,EAAM,SAC7C,EAAe,CAAE,GACjB,EAAM,EAAM,SAAS,WAAa,GAAQ,EAAQ,OAAO,CAAE,EAGjE,EAAW,CACb,EAEM,MAAwB,CAC5B,IAAK,IAAM,KAAS,EAAQ,OAAO,EAAG,EAAM,YAAY,MAAM,CAChE,EAEM,MAAoB,CACxB,IAAM,EAAO,CAAC,GAAG,EAAQ,OAAO,CAAC,CAAC,CAAC,IAAK,GAAU,EAAM,GAAG,EAE3D,EAAU,EACV,EAAQ,MAAM,EAEd,AAEE,KADA,aAAa,CAAO,EACV,IAAA,IAGZ,IAAK,IAAM,KAAO,EAAM,EAAO,CAAG,CACpC,EAEA,GAAS,QAAQ,iBACf,YACM,CACJ,EAAW,GACX,EAAM,CACR,EACA,CAAE,KAAM,EAAK,CACf,EAEA,IAAM,EAAY,GAAyB,CACzC,IAAM,EAAK,EAAK,CAAG,EACf,EAAQ,EAAQ,IAAI,CAAE,EAa1B,OAXK,IACH,EAAQ,CACN,WAAY,IAAA,GACZ,WAAY,IAAA,GACZ,MACA,QAAS,IAAA,GACT,SAAU,EAAQ,CACpB,EACA,EAAQ,IAAI,EAAI,CAAK,GAGhB,CACT,EAEM,GAAiB,EAAc,IAA+B,CAClE,GAAI,EAAU,OAAO,QAAQ,OAAO,IAAI,EAAqB,YAAY,CAAC,EAE1E,GAAI,CAAC,EAAM,WACT,OAAO,QAAQ,OAAW,MAAM,0CAA0C,EAAK,EAAM,GAAG,EAAE,EAAE,CAAC,EAE/F,IAAM,EAAiB,EAAM,WAAW,WAAa,EAErD,GACE,CAAC,GACD,EAAM,SAAS,SAAW,WAC1B,KAAK,IAAI,EAAI,EAAM,SAAS,UAAY,GACxC,CAAC,EAAM,SAAS,WAEhB,OAAO,QAAQ,QAAQ,EAAM,SAAS,IAAS,EAGjD,GAAI,EAAM,QAAS,OAAO,EAAM,QAEhC,IAAM,EAAa,IAAI,gBAEvB,EAAM,WAAa,EACnB,EAAM,SACJ,EAAM,SAAS,SAAW,UAAY,CAAE,GAAG,EAAM,SAAU,WAAY,EAAK,EAAI,CAAE,GAAG,EAAiB,EAAI,CAAE,EAC9G,EAAO,EAAM,GAAG,EAEhB,IAAM,EAAU,QAAQ,QAAQ,CAAC,CAC9B,SAAW,EAAM,YAAY,MAAM,CAAE,IAAK,EAAM,IAAK,OAAQ,EAAW,MAAO,CAAiB,CAAC,CAAC,CAClG,KACE,IACC,EAAM,SAAW,CAAE,OAAM,MAAO,KAAM,WAAY,GAAO,OAAQ,UAAW,UAAW,KAAK,IAAI,CAAE,EAClG,EAAM,WAAa,IAAA,GACnB,EAAM,QAAU,IAAA,GAChB,EAAO,EAAM,GAAG,EAChB,EAAW,EAEJ,GAER,GAAmB,CAClB,IAAM,EAAQ,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EAatE,KAXA,GAAM,SAAW,CACf,KAAM,EAAM,SAAS,SAAW,UAAY,EAAM,SAAS,KAAO,IAAA,GAClE,QACA,WAAY,GACZ,OAAQ,QACR,UAAW,KAAK,IAAI,CACtB,EACA,EAAM,WAAa,IAAA,GACnB,EAAM,QAAU,IAAA,GAChB,EAAO,EAAM,GAAG,EAEV,CACR,CACF,EAIF,MAFA,GAAM,QAAU,EAET,CACT,EAEA,MAAO,CACL,YACA,QACA,MAAS,EAAgC,EAAgD,CACvF,IAAM,EAAQ,EAAS,EAAW,GAAG,EAIrC,MAFA,GAAM,WAAa,EAEZ,EAAc,EAAO,GAAc,OAAS,EAAK,CAC1D,EACA,IAAO,EAA8B,CACnC,IAAM,EAAQ,EAAQ,IAAI,EAAK,CAAG,CAAC,EAEnC,OAAO,GAAO,SAAS,SAAW,UAAa,EAAM,SAAS,KAAa,IAAA,EAC7E,EACA,YAAe,EAAqC,CAClD,OAAQ,EAAQ,IAAI,EAAK,CAAG,CAAC,CAAC,EAAE,UAA0C,IAC5E,EACA,WAAW,EAA4B,EAAiD,CACtF,IAAM,EAAU,GAAmB,SAAW,GAC1C,EAAc,GAElB,IAAK,IAAM,KAAS,EAAQ,OAAO,EACjB,EAAO,QAAU,EAAM,IAAI,QAAU,EAAO,OAAO,EAAM,IAAU,IAAS,EAAM,IAAI,EAAM,IAGtG,EAAM,SAAS,SAAW,YAAW,EAAM,SAAW,CAAE,GAAG,EAAM,SAAU,UAAW,CAAE,GAE5F,EAAO,EAAM,GAAG,EAEZ,GAAW,EAAM,YAAc,CAAC,EAAM,SACxC,EAAgB,EAAO,EAAI,CAAC,CAAC,UAAY,CAEzC,CAAC,EAGH,EAAc,IAId,GAAa,EAAW,CAC9B,EACA,MAAmB,CACjB,MAAO,CAAC,GAAG,EAAQ,OAAO,CAAC,CAAC,CAAC,IAAK,GAAU,EAAM,GAAG,CACvD,EACA,IAAO,EAAe,EAAS,EAA2C,CACxE,IAAM,EAAQ,EAAS,CAAG,EAE1B,EAAM,SAAW,CACf,OACA,MAAO,KACP,WAAY,GACZ,OAAQ,UACR,UAAW,GAAY,WAAa,KAAK,IAAI,CAC/C,EACA,EAAO,CAAG,EACV,EAAW,CACb,EACA,UAAU,EAAe,EAAmC,CAC1D,IAAM,EAAK,EAAK,CAAG,EACb,EAAe,EAAU,IAAI,CAAE,GAAK,IAAI,IAK9C,OAHA,EAAa,IAAI,CAAQ,EACzB,EAAU,IAAI,EAAI,CAAY,MAEjB,CACX,EAAa,OAAO,CAAQ,EAExB,EAAa,OAAS,IACxB,EAAU,OAAO,CAAE,EACnB,EAAW,EAEf,CACF,CACF,CACF"}

package/dist/response.cjs

@@ -1,2 +1,2 @@
-async function e(e,t=`auto`){if(t===`raw`)return e;if(e.status===204||e.status===205||e.status===304)return;if(t===`json`)return e.json();if(t===`text`)return e.text();if(t===`blob`)return e.blob();if(t===`arrayBuffer`)return e.arrayBuffer();let n=e.headers.get(`content-type`)??``;return n.includes(`application/json`)||n.includes(`+json`)?e.json():n.startsWith(`text/`)?e.text():n.startsWith(`image/`)||n.startsWith(`audio/`)||n.startsWith(`video/`)?e.blob():e.text()}exports.parseResponse=e;
+async function e(e){let t=(await e.text()).trim();return t?JSON.parse(t):void 0}async function t(t,n=`auto`){if(n===`raw`)return t;if(t.status===204||t.status===205||t.status===304)return;if(n===`json`)return e(t);if(n===`text`)return t.text();if(n===`blob`)return t.blob();if(n===`arrayBuffer`)return t.arrayBuffer();let r=t.headers.get(`content-type`)??``;return r.includes(`application/json`)||r.includes(`+json`)?e(t):r.startsWith(`text/`)?t.text():r.startsWith(`image/`)||r.startsWith(`audio/`)||r.startsWith(`video/`)?t.blob():t.text()}exports.parseResponse=t;
 //# sourceMappingURL=response.cjs.map

package/dist/response.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"response.cjs","names":[],"sources":["../src/response.ts"],"sourcesContent":["/** Response parsing strategy. 'raw' returns the Response object directly. */\nexport type ResponseType = 'auto' | 'json' | 'text' | 'blob' | 'arrayBuffer' | 'raw';\n\nexport async function parseResponse(res: Response, responseType: ResponseType = 'auto'): Promise<unknown> {\n  if (responseType === 'raw') return res;\n\n  if (res.status === 204 || res.status === 205 || res.status === 304) return;\n\n  if (responseType === 'json') return res.json();\n\n  if (responseType === 'text') return res.text();\n\n  if (responseType === 'blob') return res.blob();\n\n  if (responseType === 'arrayBuffer') return res.arrayBuffer();\n\n  const contentType = res.headers.get('content-type') ?? '';\n\n  if (contentType.includes('application/json') || contentType.includes('+json')) return res.json();\n\n  if (contentType.startsWith('text/')) return res.text();\n\n  if (contentType.startsWith('image/') || contentType.startsWith('audio/') || contentType.startsWith('video/')) {\n    return res.blob();\n  }\n\n  // Unknown content-type — fall back to text, which is always safe to read and debug.\n  return res.text();\n}\n"],"mappings":"AAGA,eAAsB,EAAc,EAAe,EAA6B,OAA0B,CACxG,GAAI,IAAiB,MAAO,OAAO,EAEnC,GAAI,EAAI,SAAW,KAAO,EAAI,SAAW,KAAO,EAAI,SAAW,IAAK,OAEpE,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,cAAe,OAAO,EAAI,YAAY,EAE3D,IAAM,EAAc,EAAI,QAAQ,IAAI,cAAc,GAAK,GAWvD,OATI,EAAY,SAAS,kBAAkB,GAAK,EAAY,SAAS,OAAO,EAAU,EAAI,KAAK,EAE3F,EAAY,WAAW,OAAO,EAAU,EAAI,KAAK,EAEjD,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,EAClG,EAAI,KAAK,EAIX,EAAI,KAAK,CAClB"}
+{"version":3,"file":"response.cjs","names":[],"sources":["../src/response.ts"],"sourcesContent":["/** Response parsing strategy. 'raw' returns the Response object directly. */\nexport type ResponseType = 'auto' | 'json' | 'text' | 'blob' | 'arrayBuffer' | 'raw';\n\nasync function parseJson(res: Response): Promise<unknown> {\n  const text = (await res.text()).trim();\n\n  return text ? JSON.parse(text) : undefined;\n}\n\nexport async function parseResponse(res: Response, responseType: ResponseType = 'auto'): Promise<unknown> {\n  if (responseType === 'raw') return res;\n\n  if (res.status === 204 || res.status === 205 || res.status === 304) return;\n\n  if (responseType === 'json') return parseJson(res);\n\n  if (responseType === 'text') return res.text();\n\n  if (responseType === 'blob') return res.blob();\n\n  if (responseType === 'arrayBuffer') return res.arrayBuffer();\n\n  const contentType = res.headers.get('content-type') ?? '';\n\n  if (contentType.includes('application/json') || contentType.includes('+json')) return parseJson(res);\n\n  if (contentType.startsWith('text/')) return res.text();\n\n  if (contentType.startsWith('image/') || contentType.startsWith('audio/') || contentType.startsWith('video/')) {\n    return res.blob();\n  }\n\n  // Unknown content-type — fall back to text, which is always safe to read and debug.\n  return res.text();\n}\n"],"mappings":"AAGA,eAAe,EAAU,EAAiC,CACxD,IAAM,GAAQ,MAAM,EAAI,KAAK,EAAA,CAAG,KAAK,EAErC,OAAO,EAAO,KAAK,MAAM,CAAI,EAAI,IAAA,EACnC,CAEA,eAAsB,EAAc,EAAe,EAA6B,OAA0B,CACxG,GAAI,IAAiB,MAAO,OAAO,EAEnC,GAAI,EAAI,SAAW,KAAO,EAAI,SAAW,KAAO,EAAI,SAAW,IAAK,OAEpE,GAAI,IAAiB,OAAQ,OAAO,EAAU,CAAG,EAEjD,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,cAAe,OAAO,EAAI,YAAY,EAE3D,IAAM,EAAc,EAAI,QAAQ,IAAI,cAAc,GAAK,GAWvD,OATI,EAAY,SAAS,kBAAkB,GAAK,EAAY,SAAS,OAAO,EAAU,EAAU,CAAG,EAE/F,EAAY,WAAW,OAAO,EAAU,EAAI,KAAK,EAEjD,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,EAClG,EAAI,KAAK,EAIX,EAAI,KAAK,CAClB"}

package/dist/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,KAAK,CAAC;AAErF,wBAAsB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,GAAE,YAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBxG"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,KAAK,CAAC;AAQrF,wBAAsB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,GAAE,YAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBxG"}

package/dist/response.js

@@ -1,2 +1,2 @@
-async function e(e,t=`auto`){if(t===`raw`)return e;if(e.status===204||e.status===205||e.status===304)return;if(t===`json`)return e.json();if(t===`text`)return e.text();if(t===`blob`)return e.blob();if(t===`arrayBuffer`)return e.arrayBuffer();let n=e.headers.get(`content-type`)??``;return n.includes(`application/json`)||n.includes(`+json`)?e.json():n.startsWith(`text/`)?e.text():n.startsWith(`image/`)||n.startsWith(`audio/`)||n.startsWith(`video/`)?e.blob():e.text()}export{e as parseResponse};
+async function e(e){let t=(await e.text()).trim();return t?JSON.parse(t):void 0}async function t(t,n=`auto`){if(n===`raw`)return t;if(t.status===204||t.status===205||t.status===304)return;if(n===`json`)return e(t);if(n===`text`)return t.text();if(n===`blob`)return t.blob();if(n===`arrayBuffer`)return t.arrayBuffer();let r=t.headers.get(`content-type`)??``;return r.includes(`application/json`)||r.includes(`+json`)?e(t):r.startsWith(`text/`)?t.text():r.startsWith(`image/`)||r.startsWith(`audio/`)||r.startsWith(`video/`)?t.blob():t.text()}export{t as parseResponse};
 //# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -1 +1 @@
-{"version":3,"file":"response.js","names":[],"sources":["../src/response.ts"],"sourcesContent":["/** Response parsing strategy. 'raw' returns the Response object directly. */\nexport type ResponseType = 'auto' | 'json' | 'text' | 'blob' | 'arrayBuffer' | 'raw';\n\nexport async function parseResponse(res: Response, responseType: ResponseType = 'auto'): Promise<unknown> {\n  if (responseType === 'raw') return res;\n\n  if (res.status === 204 || res.status === 205 || res.status === 304) return;\n\n  if (responseType === 'json') return res.json();\n\n  if (responseType === 'text') return res.text();\n\n  if (responseType === 'blob') return res.blob();\n\n  if (responseType === 'arrayBuffer') return res.arrayBuffer();\n\n  const contentType = res.headers.get('content-type') ?? '';\n\n  if (contentType.includes('application/json') || contentType.includes('+json')) return res.json();\n\n  if (contentType.startsWith('text/')) return res.text();\n\n  if (contentType.startsWith('image/') || contentType.startsWith('audio/') || contentType.startsWith('video/')) {\n    return res.blob();\n  }\n\n  // Unknown content-type — fall back to text, which is always safe to read and debug.\n  return res.text();\n}\n"],"mappings":"AAGA,eAAsB,EAAc,EAAe,EAA6B,OAA0B,CACxG,GAAI,IAAiB,MAAO,OAAO,EAEnC,GAAI,EAAI,SAAW,KAAO,EAAI,SAAW,KAAO,EAAI,SAAW,IAAK,OAEpE,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,cAAe,OAAO,EAAI,YAAY,EAE3D,IAAM,EAAc,EAAI,QAAQ,IAAI,cAAc,GAAK,GAWvD,OATI,EAAY,SAAS,kBAAkB,GAAK,EAAY,SAAS,OAAO,EAAU,EAAI,KAAK,EAE3F,EAAY,WAAW,OAAO,EAAU,EAAI,KAAK,EAEjD,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,EAClG,EAAI,KAAK,EAIX,EAAI,KAAK,CAClB"}
+{"version":3,"file":"response.js","names":[],"sources":["../src/response.ts"],"sourcesContent":["/** Response parsing strategy. 'raw' returns the Response object directly. */\nexport type ResponseType = 'auto' | 'json' | 'text' | 'blob' | 'arrayBuffer' | 'raw';\n\nasync function parseJson(res: Response): Promise<unknown> {\n  const text = (await res.text()).trim();\n\n  return text ? JSON.parse(text) : undefined;\n}\n\nexport async function parseResponse(res: Response, responseType: ResponseType = 'auto'): Promise<unknown> {\n  if (responseType === 'raw') return res;\n\n  if (res.status === 204 || res.status === 205 || res.status === 304) return;\n\n  if (responseType === 'json') return parseJson(res);\n\n  if (responseType === 'text') return res.text();\n\n  if (responseType === 'blob') return res.blob();\n\n  if (responseType === 'arrayBuffer') return res.arrayBuffer();\n\n  const contentType = res.headers.get('content-type') ?? '';\n\n  if (contentType.includes('application/json') || contentType.includes('+json')) return parseJson(res);\n\n  if (contentType.startsWith('text/')) return res.text();\n\n  if (contentType.startsWith('image/') || contentType.startsWith('audio/') || contentType.startsWith('video/')) {\n    return res.blob();\n  }\n\n  // Unknown content-type — fall back to text, which is always safe to read and debug.\n  return res.text();\n}\n"],"mappings":"AAGA,eAAe,EAAU,EAAiC,CACxD,IAAM,GAAQ,MAAM,EAAI,KAAK,EAAA,CAAG,KAAK,EAErC,OAAO,EAAO,KAAK,MAAM,CAAI,EAAI,IAAA,EACnC,CAEA,eAAsB,EAAc,EAAe,EAA6B,OAA0B,CACxG,GAAI,IAAiB,MAAO,OAAO,EAEnC,GAAI,EAAI,SAAW,KAAO,EAAI,SAAW,KAAO,EAAI,SAAW,IAAK,OAEpE,GAAI,IAAiB,OAAQ,OAAO,EAAU,CAAG,EAEjD,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,OAAQ,OAAO,EAAI,KAAK,EAE7C,GAAI,IAAiB,cAAe,OAAO,EAAI,YAAY,EAE3D,IAAM,EAAc,EAAI,QAAQ,IAAI,cAAc,GAAK,GAWvD,OATI,EAAY,SAAS,kBAAkB,GAAK,EAAY,SAAS,OAAO,EAAU,EAAU,CAAG,EAE/F,EAAY,WAAW,OAAO,EAAU,EAAI,KAAK,EAEjD,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,GAAK,EAAY,WAAW,QAAQ,EAClG,EAAI,KAAK,EAIX,EAAI,KAAK,CAClB"}

package/dist/serialize.cjs

@@ -1,2 +1,2 @@
-require("@vielzeug/arsenal/object");function e(e,n,r,i,a){return r!==void 0&&!t(r)?{...a,body:JSON.stringify(r),headers:{"content-type":`application/json`,...n},method:e.toUpperCase(),signal:i}:{...a,...r!==void 0&&{body:r},headers:n,method:e.toUpperCase(),signal:i}}function t(e){return e instanceof FormData||e instanceof Blob||e instanceof URLSearchParams||typeof e==`string`||e instanceof ArrayBuffer||ArrayBuffer.isView(e)||typeof ReadableStream<`u`&&e instanceof ReadableStream}exports.buildRequestInit=e,exports.isBodyInit=t;
+function e(e,n,r,i,a){return r!==void 0&&!t(r)?{...a,body:JSON.stringify(r),headers:{"content-type":`application/json`,...n},method:e.toUpperCase(),signal:i}:{...a,...r!==void 0&&{body:r},headers:n,method:e.toUpperCase(),signal:i}}function t(e){return e instanceof FormData||e instanceof Blob||e instanceof URLSearchParams||typeof e==`string`||e instanceof ArrayBuffer||ArrayBuffer.isView(e)||typeof ReadableStream<`u`&&e instanceof ReadableStream}exports.buildRequestInit=e,exports.isBodyInit=t;
 //# sourceMappingURL=serialize.cjs.map

package/dist/serialize.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.cjs","names":[],"sources":["../src/serialize.ts"],"sourcesContent":["import { hash } from '@vielzeug/arsenal/object';\n\nexport { hash };\n\n/**\n * Build a `RequestInit` object from the request components, handling body serialisation.\n * Plain objects/arrays are JSON-serialised and `content-type: application/json` is added.\n * BodyInit values (FormData, Blob, etc.) are forwarded as-is.\n */\nexport function buildRequestInit(\n  method: string,\n  headers: Record<string, string>,\n  body: unknown,\n  signal: AbortSignal | undefined,\n  rest: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>,\n): RequestInit {\n  if (body !== undefined && !isBodyInit(body)) {\n    return {\n      ...rest,\n      body: JSON.stringify(body),\n      headers: { 'content-type': 'application/json', ...headers },\n      method: method.toUpperCase(),\n      signal,\n    };\n  }\n\n  return {\n    ...rest,\n    ...(body !== undefined && { body: body as BodyInit }),\n    headers,\n    method: method.toUpperCase(),\n    signal,\n  };\n}\n\nexport function isBodyInit(value: unknown): value is BodyInit {\n  return (\n    value instanceof FormData ||\n    value instanceof Blob ||\n    value instanceof URLSearchParams ||\n    typeof value === 'string' ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value) ||\n    (typeof ReadableStream !== 'undefined' && value instanceof ReadableStream)\n  );\n}\n"],"mappings":"oCASA,SAAgB,EACd,EACA,EACA,EACA,EACA,EACa,CAWb,OAVI,IAAS,IAAA,IAAa,CAAC,EAAW,CAAI,EACjC,CACL,GAAG,EACH,KAAM,KAAK,UAAU,CAAI,EACzB,QAAS,CAAE,eAAgB,mBAAoB,GAAG,CAAQ,EAC1D,OAAQ,EAAO,YAAY,EAC3B,QACF,EAGK,CACL,GAAG,EACH,GAAI,IAAS,IAAA,IAAa,CAAQ,MAAiB,EACnD,UACA,OAAQ,EAAO,YAAY,EAC3B,QACF,CACF,CAEA,SAAgB,EAAW,EAAmC,CAC5D,OACE,aAAiB,UACjB,aAAiB,MACjB,aAAiB,iBACjB,OAAO,GAAU,UACjB,aAAiB,aACjB,YAAY,OAAO,CAAK,GACvB,OAAO,eAAmB,KAAe,aAAiB,cAE/D"}
+{"version":3,"file":"serialize.cjs","names":[],"sources":["../src/serialize.ts"],"sourcesContent":["/**\n * Build a `RequestInit` object from the request components, handling body serialisation.\n * Plain objects/arrays are JSON-serialised and `content-type: application/json` is added.\n * BodyInit values (FormData, Blob, etc.) are forwarded as-is.\n */\nexport function buildRequestInit(\n  method: string,\n  headers: Record<string, string>,\n  body: unknown,\n  signal: AbortSignal | undefined,\n  rest: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>,\n): RequestInit {\n  if (body !== undefined && !isBodyInit(body)) {\n    return {\n      ...rest,\n      body: JSON.stringify(body),\n      headers: { 'content-type': 'application/json', ...headers },\n      method: method.toUpperCase(),\n      signal,\n    };\n  }\n\n  return {\n    ...rest,\n    ...(body !== undefined && { body: body as BodyInit }),\n    headers,\n    method: method.toUpperCase(),\n    signal,\n  };\n}\n\nexport function isBodyInit(value: unknown): value is BodyInit {\n  return (\n    value instanceof FormData ||\n    value instanceof Blob ||\n    value instanceof URLSearchParams ||\n    typeof value === 'string' ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value) ||\n    (typeof ReadableStream !== 'undefined' && value instanceof ReadableStream)\n  );\n}\n"],"mappings":"AAKA,SAAgB,EACd,EACA,EACA,EACA,EACA,EACa,CAWb,OAVI,IAAS,IAAA,IAAa,CAAC,EAAW,CAAI,EACjC,CACL,GAAG,EACH,KAAM,KAAK,UAAU,CAAI,EACzB,QAAS,CAAE,eAAgB,mBAAoB,GAAG,CAAQ,EAC1D,OAAQ,EAAO,YAAY,EAC3B,QACF,EAGK,CACL,GAAG,EACH,GAAI,IAAS,IAAA,IAAa,CAAQ,MAAiB,EACnD,UACA,OAAQ,EAAO,YAAY,EAC3B,QACF,CACF,CAEA,SAAgB,EAAW,EAAmC,CAC5D,OACE,aAAiB,UACjB,aAAiB,MACjB,aAAiB,iBACjB,OAAO,GAAU,UACjB,aAAiB,aACjB,YAAY,OAAO,CAAK,GACvB,OAAO,eAAmB,KAAe,aAAiB,cAE/D"}

package/dist/serialize.d.ts

@@ -1,5 +1,3 @@
-import { hash } from '@vielzeug/arsenal/object';
-export { hash };
 /**
  * Build a `RequestInit` object from the request components, handling body serialisation.
  * Plain objects/arrays are JSON-serialised and `content-type: application/json` is added.

package/dist/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAChE,WAAW,CAkBb;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAU5D"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAChE,WAAW,CAkBb;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAU5D"}

package/dist/serialize.js

@@ -1,2 +1,2 @@
-import{hash as e}from"@vielzeug/arsenal/object";function t(e,t,r,i,a){return r!==void 0&&!n(r)?{...a,body:JSON.stringify(r),headers:{"content-type":`application/json`,...t},method:e.toUpperCase(),signal:i}:{...a,...r!==void 0&&{body:r},headers:t,method:e.toUpperCase(),signal:i}}function n(e){return e instanceof FormData||e instanceof Blob||e instanceof URLSearchParams||typeof e==`string`||e instanceof ArrayBuffer||ArrayBuffer.isView(e)||typeof ReadableStream<`u`&&e instanceof ReadableStream}export{t as buildRequestInit,e as hash,n as isBodyInit};
+function e(e,n,r,i,a){return r!==void 0&&!t(r)?{...a,body:JSON.stringify(r),headers:{"content-type":`application/json`,...n},method:e.toUpperCase(),signal:i}:{...a,...r!==void 0&&{body:r},headers:n,method:e.toUpperCase(),signal:i}}function t(e){return e instanceof FormData||e instanceof Blob||e instanceof URLSearchParams||typeof e==`string`||e instanceof ArrayBuffer||ArrayBuffer.isView(e)||typeof ReadableStream<`u`&&e instanceof ReadableStream}export{e as buildRequestInit,t as isBodyInit};
 //# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.js","names":[],"sources":["../src/serialize.ts"],"sourcesContent":["import { hash } from '@vielzeug/arsenal/object';\n\nexport { hash };\n\n/**\n * Build a `RequestInit` object from the request components, handling body serialisation.\n * Plain objects/arrays are JSON-serialised and `content-type: application/json` is added.\n * BodyInit values (FormData, Blob, etc.) are forwarded as-is.\n */\nexport function buildRequestInit(\n  method: string,\n  headers: Record<string, string>,\n  body: unknown,\n  signal: AbortSignal | undefined,\n  rest: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>,\n): RequestInit {\n  if (body !== undefined && !isBodyInit(body)) {\n    return {\n      ...rest,\n      body: JSON.stringify(body),\n      headers: { 'content-type': 'application/json', ...headers },\n      method: method.toUpperCase(),\n      signal,\n    };\n  }\n\n  return {\n    ...rest,\n    ...(body !== undefined && { body: body as BodyInit }),\n    headers,\n    method: method.toUpperCase(),\n    signal,\n  };\n}\n\nexport function isBodyInit(value: unknown): value is BodyInit {\n  return (\n    value instanceof FormData ||\n    value instanceof Blob ||\n    value instanceof URLSearchParams ||\n    typeof value === 'string' ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value) ||\n    (typeof ReadableStream !== 'undefined' && value instanceof ReadableStream)\n  );\n}\n"],"mappings":"gDASA,SAAgB,EACd,EACA,EACA,EACA,EACA,EACa,CAWb,OAVI,IAAS,IAAA,IAAa,CAAC,EAAW,CAAI,EACjC,CACL,GAAG,EACH,KAAM,KAAK,UAAU,CAAI,EACzB,QAAS,CAAE,eAAgB,mBAAoB,GAAG,CAAQ,EAC1D,OAAQ,EAAO,YAAY,EAC3B,QACF,EAGK,CACL,GAAG,EACH,GAAI,IAAS,IAAA,IAAa,CAAQ,MAAiB,EACnD,UACA,OAAQ,EAAO,YAAY,EAC3B,QACF,CACF,CAEA,SAAgB,EAAW,EAAmC,CAC5D,OACE,aAAiB,UACjB,aAAiB,MACjB,aAAiB,iBACjB,OAAO,GAAU,UACjB,aAAiB,aACjB,YAAY,OAAO,CAAK,GACvB,OAAO,eAAmB,KAAe,aAAiB,cAE/D"}
+{"version":3,"file":"serialize.js","names":[],"sources":["../src/serialize.ts"],"sourcesContent":["/**\n * Build a `RequestInit` object from the request components, handling body serialisation.\n * Plain objects/arrays are JSON-serialised and `content-type: application/json` is added.\n * BodyInit values (FormData, Blob, etc.) are forwarded as-is.\n */\nexport function buildRequestInit(\n  method: string,\n  headers: Record<string, string>,\n  body: unknown,\n  signal: AbortSignal | undefined,\n  rest: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>,\n): RequestInit {\n  if (body !== undefined && !isBodyInit(body)) {\n    return {\n      ...rest,\n      body: JSON.stringify(body),\n      headers: { 'content-type': 'application/json', ...headers },\n      method: method.toUpperCase(),\n      signal,\n    };\n  }\n\n  return {\n    ...rest,\n    ...(body !== undefined && { body: body as BodyInit }),\n    headers,\n    method: method.toUpperCase(),\n    signal,\n  };\n}\n\nexport function isBodyInit(value: unknown): value is BodyInit {\n  return (\n    value instanceof FormData ||\n    value instanceof Blob ||\n    value instanceof URLSearchParams ||\n    typeof value === 'string' ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value) ||\n    (typeof ReadableStream !== 'undefined' && value instanceof ReadableStream)\n  );\n}\n"],"mappings":"AAKA,SAAgB,EACd,EACA,EACA,EACA,EACA,EACa,CAWb,OAVI,IAAS,IAAA,IAAa,CAAC,EAAW,CAAI,EACjC,CACL,GAAG,EACH,KAAM,KAAK,UAAU,CAAI,EACzB,QAAS,CAAE,eAAgB,mBAAoB,GAAG,CAAQ,EAC1D,OAAQ,EAAO,YAAY,EAC3B,QACF,EAGK,CACL,GAAG,EACH,GAAI,IAAS,IAAA,IAAa,CAAQ,MAAiB,EACnD,UACA,OAAQ,EAAO,YAAY,EAC3B,QACF,CACF,CAEA,SAAgB,EAAW,EAAmC,CAC5D,OACE,aAAiB,UACjB,aAAiB,MACjB,aAAiB,iBACjB,OAAO,GAAU,UACjB,aAAiB,aACjB,YAAY,OAAO,CAAK,GACvB,OAAO,eAAmB,KAAe,aAAiB,cAE/D"}

package/dist/stream.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"stream.cjs","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import type { Params } from './url';\n\nimport { classifyRequestError, CourierDisposedError, CourierHttpError, CourierParseError } from './errors';\nimport { buildRequestInit } from './serialize';\nimport { anySignal, buildTimeoutSignal, type TransportCore } from './transport';\nimport { buildUrl } from './url';\n\nexport type StreamOptions<P extends string = string> = {\n  body?: unknown;\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  signal?: AbortSignal;\n  timeout?: number;\n};\n\nexport type StreamEvent<T = unknown> = { readonly data: T; readonly event: string };\n\nfunction abortable<T>(create: (signal: AbortSignal) => AsyncGenerator<T>): AsyncIterableIterator<T> {\n  const controller = new AbortController();\n  const iterator = create(controller.signal);\n\n  return {\n    next: (value?: undefined) => iterator.next(value),\n    return: (value?: T) => {\n      controller.abort();\n\n      return iterator.return(value as T);\n    },\n    [Symbol.asyncIterator]() {\n      return this;\n    },\n    throw: (error?: unknown) => {\n      controller.abort();\n\n      return iterator.throw(error);\n    },\n  };\n}\n\nasync function open(\n  transport: TransportCore,\n  url: string,\n  config: StreamOptions,\n): Promise<{ controller: AbortController; response: Response; untrack: () => void }> {\n  if (transport.disposed) throw new CourierDisposedError('Courier');\n\n  const controller = new AbortController();\n  const untrack = transport.track(controller);\n  const method = (config.method ?? (config.body === undefined ? 'GET' : 'POST')).toUpperCase();\n  const signal = buildTimeoutSignal(\n    config.timeout ?? Number.POSITIVE_INFINITY,\n    anySignal(config.signal, controller.signal),\n  );\n  let fullUrl = url;\n\n  try {\n    fullUrl = buildUrl(transport.baseUrl, url, config.params as Params | undefined, config.query);\n\n    const headers = transport.mergeHeaders(config.headers);\n    const { headers: requestHeaders, ...init } = buildRequestInit(\n      method,\n      headers,\n      config.body,\n      signal,\n      config.fetchInit ?? {},\n    );\n    const response = await transport.dispatch({\n      headers: requestHeaders as Record<string, string>,\n      init,\n      url: fullUrl,\n    });\n\n    if (!response.ok)\n      throw CourierHttpError.fromResponse(response, await response.text().catch(() => ''), method, fullUrl);\n\n    if (!response.body) throw new CourierParseError('Response has no body');\n\n    return { controller, response, untrack };\n  } catch (error) {\n    untrack();\n\n    if (error instanceof CourierHttpError || error instanceof CourierParseError) throw error;\n\n    throw classifyRequestError(error, method, fullUrl, signal);\n  }\n}\n\n/** Platform-shaped streaming primitives: async iteration owns cancellation and backpressure. */\nexport function createStreams(transport: TransportCore) {\n  async function* events<T = unknown, P extends string = string>(\n    url: P,\n    config: StreamOptions<P>,\n  ): AsyncGenerator<StreamEvent<T>> {\n    const { controller, response, untrack } = await open(transport, url, config);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let event = 'message';\n    let data = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) break;\n\n        buffer += decoder.decode(chunk.value, { stream: true }).replace(/\\r\\n?/g, '\\n');\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline);\n\n          buffer = buffer.slice(newline + 1);\n\n          if (line === '') {\n            if (data !== '') {\n              let parsed: unknown = data.endsWith('\\n') ? data.slice(0, -1) : data;\n\n              try {\n                parsed = JSON.parse(parsed as string);\n              } catch {\n                // SSE text payloads are valid raw values.\n              }\n\n              yield { data: parsed as T, event };\n            }\n\n            data = '';\n            event = 'message';\n            continue;\n          }\n\n          if (line.startsWith(':')) continue;\n\n          const separator = line.indexOf(':');\n          const field = separator === -1 ? line : line.slice(0, separator);\n          const value = (separator === -1 ? '' : line.slice(separator + 1)).replace(/^ /, '');\n\n          if (field === 'data') data += `${value}\\n`;\n          else if (field === 'event') event = value;\n        }\n      }\n    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  async function* read<T = string, P extends string = string>(\n    url: P,\n    config: StreamOptions<P> & { parse?: 'ndjson' | 'text' },\n  ): AsyncGenerator<T> {\n    const { controller, response, untrack } = await open(transport, url, config);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) {\n          if (config.parse === 'ndjson' && buffer.trim()) {\n            try {\n              yield JSON.parse(buffer) as T;\n            } catch {\n              throw new CourierParseError(`NDJSON: failed to parse line: ${buffer.slice(0, 200)}`);\n            }\n          }\n\n          break;\n        }\n\n        const text = decoder.decode(chunk.value, { stream: true });\n\n        if (config.parse !== 'ndjson') {\n          yield text as T;\n          continue;\n        }\n\n        buffer += text;\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline).trim();\n\n          buffer = buffer.slice(newline + 1);\n\n          if (!line) continue;\n\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    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  return {\n    events<T = unknown, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> = {},\n    ): AsyncIterableIterator<StreamEvent<T>> {\n      return abortable((signal) =>\n        events<T, P>(url, {\n          ...config,\n          headers: { accept: 'text/event-stream', 'cache-control': 'no-cache', ...config.headers },\n          signal: anySignal(config.signal, signal),\n        }),\n      );\n    },\n    read<T = string, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> & { parse?: 'ndjson' | 'text' } = {},\n    ): AsyncIterableIterator<T> {\n      return abortable((signal) => read<T, P>(url, { ...config, signal: anySignal(config.signal, signal) }));\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"stream.cjs","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import { CourierDisposedError, CourierHttpError, CourierParseError, classifyRequestError } from './errors';\nimport { buildRequestInit } from './serialize';\nimport { anySignal, buildTimeoutSignal, type TransportCore } from './transport';\nimport type { HttpRequestConfig, Params } from './url';\nimport { buildUrl } from './url';\n\nexport type StreamOptions<P extends string = string> = Omit<HttpRequestConfig<P>, 'responseType' | 'schema'> & {\n  method?: string;\n};\n\n/** Runtime config without PathConfig's type-level constraints — open() just forwards params to buildUrl. */\ntype StreamRuntimeConfig = {\n  body?: unknown;\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  headers?: Record<string, string>;\n  method?: string;\n  params?: Params;\n  query?: Params;\n  signal?: AbortSignal;\n  timeout?: number;\n};\n\nexport type StreamEvent<T = unknown> = { readonly data: T; readonly event: string };\n\nfunction abortable<T>(create: (signal: AbortSignal) => AsyncGenerator<T>): AsyncIterableIterator<T> {\n  const controller = new AbortController();\n  const iterator = create(controller.signal);\n\n  return {\n    next: (value?: undefined) => iterator.next(value),\n    return: (value?: T) => {\n      controller.abort();\n\n      return iterator.return(value as T);\n    },\n    [Symbol.asyncIterator]() {\n      return this;\n    },\n    throw: (error?: unknown) => {\n      controller.abort();\n\n      return iterator.throw(error);\n    },\n  };\n}\n\nasync function open(\n  transport: TransportCore,\n  url: string,\n  config: StreamRuntimeConfig,\n): Promise<{ controller: AbortController; response: Response; untrack: () => void }> {\n  if (transport.disposed) throw new CourierDisposedError('Courier');\n\n  const controller = new AbortController();\n  const untrack = transport.track(controller);\n  const method = (config.method ?? (config.body === undefined ? 'GET' : 'POST')).toUpperCase();\n  const signal = buildTimeoutSignal(\n    config.timeout ?? Number.POSITIVE_INFINITY,\n    anySignal(config.signal, controller.signal),\n  );\n  let fullUrl = url;\n\n  try {\n    fullUrl = buildUrl(transport.baseUrl, url, config.params, config.query);\n\n    const headers = transport.mergeHeaders(config.headers);\n    const { headers: requestHeaders, ...init } = buildRequestInit(\n      method,\n      headers,\n      config.body,\n      signal,\n      config.fetchInit ?? {},\n    );\n    const response = await transport.dispatch({\n      headers: requestHeaders as Record<string, string>,\n      init,\n      url: fullUrl,\n    });\n\n    if (!response.ok)\n      throw CourierHttpError.fromResponse(response, await response.text().catch(() => ''), method, fullUrl);\n\n    if (!response.body) throw new CourierParseError('Response has no body');\n\n    return { controller, response, untrack };\n  } catch (error) {\n    untrack();\n\n    if (error instanceof CourierHttpError || error instanceof CourierParseError) throw error;\n\n    throw classifyRequestError(error, method, fullUrl, signal);\n  }\n}\n\n/** Platform-shaped streaming primitives: async iteration owns cancellation and backpressure. */\nexport function createStreams(transport: TransportCore) {\n  async function* events<T = unknown, P extends string = string>(\n    url: P,\n    config: StreamOptions<P>,\n  ): AsyncGenerator<StreamEvent<T>> {\n    const { controller, response, untrack } = await open(transport, url, config as StreamRuntimeConfig);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let event = 'message';\n    let data = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) break;\n\n        buffer += decoder.decode(chunk.value, { stream: true }).replace(/\\r\\n?/g, '\\n');\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline);\n\n          buffer = buffer.slice(newline + 1);\n\n          if (line === '') {\n            if (data !== '') {\n              let parsed: unknown = data.endsWith('\\n') ? data.slice(0, -1) : data;\n\n              try {\n                parsed = JSON.parse(parsed as string);\n              } catch {\n                // SSE text payloads are valid raw values.\n              }\n\n              yield { data: parsed as T, event };\n            }\n\n            data = '';\n            event = 'message';\n            continue;\n          }\n\n          if (line.startsWith(':')) continue;\n\n          const separator = line.indexOf(':');\n          const field = separator === -1 ? line : line.slice(0, separator);\n          const value = (separator === -1 ? '' : line.slice(separator + 1)).replace(/^ /, '');\n\n          if (field === 'data') data += `${value}\\n`;\n          else if (field === 'event') event = value;\n        }\n      }\n    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  async function* read<T = string, P extends string = string>(\n    url: P,\n    config: StreamOptions<P> & { parse?: 'ndjson' | 'text' },\n  ): AsyncGenerator<T> {\n    const { controller, response, untrack } = await open(transport, url, config as StreamRuntimeConfig);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) {\n          if (config.parse === 'ndjson' && buffer.trim()) {\n            try {\n              yield JSON.parse(buffer) as T;\n            } catch {\n              throw new CourierParseError(`NDJSON: failed to parse line: ${buffer.slice(0, 200)}`);\n            }\n          }\n\n          break;\n        }\n\n        const text = decoder.decode(chunk.value, { stream: true });\n\n        if (config.parse !== 'ndjson') {\n          yield text as T;\n          continue;\n        }\n\n        buffer += text;\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline).trim();\n\n          buffer = buffer.slice(newline + 1);\n\n          if (!line) continue;\n\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    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  return {\n    events<T = unknown, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> = {} as StreamOptions<P>,\n    ): AsyncIterableIterator<StreamEvent<T>> {\n      return abortable((signal) =>\n        events<T, P>(url, {\n          ...config,\n          headers: { accept: 'text/event-stream', 'cache-control': 'no-cache', ...config.headers },\n          signal: anySignal(config.signal, signal),\n        }),\n      );\n    },\n    read<T = string, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> & { parse?: 'ndjson' | 'text' } = {} as StreamOptions<P> & {\n        parse?: 'ndjson' | 'text';\n      },\n    ): AsyncIterableIterator<T> {\n      return abortable((signal) => read<T, P>(url, { ...config, signal: anySignal(config.signal, signal) }));\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/stream.d.ts

@@ -1,14 +1,7 @@
-import type { Params } from './url';
 import { type TransportCore } from './transport';
-export type StreamOptions<P extends string = string> = {
-    body?: unknown;
-    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;
-    headers?: Record<string, string>;
+import type { HttpRequestConfig } from './url';
+export type StreamOptions<P extends string = string> = Omit<HttpRequestConfig<P>, 'responseType' | 'schema'> & {
     method?: string;
-    params?: P extends string ? Record<string, string | number | boolean> : never;
-    query?: Params;
-    signal?: AbortSignal;
-    timeout?: number;
 };
 export type StreamEvent<T = unknown> = {
     readonly data: T;

package/dist/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAIpC,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,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,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAwEpF,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa;WAwH3C,CAAC,YAAY,CAAC,SAAS,MAAM,gBAC7B,CAAC,WACE,aAAa,CAAC,CAAC,CAAC,GACvB,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;SASnC,CAAC,WAAW,CAAC,SAAS,MAAM,gBAC1B,CAAC,WACE,aAAa,CAAC,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GACvD,qBAAqB,CAAC,CAAC,CAAC;EAI9B"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAU,MAAM,OAAO,CAAC;AAGvD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,cAAc,GAAG,QAAQ,CAAC,GAAG;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAcF,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAwEpF,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa;WAwH3C,CAAC,YAAY,CAAC,SAAS,MAAM,gBAC7B,CAAC,WACE,aAAa,CAAC,CAAC,CAAC,GACvB,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;SASnC,CAAC,WAAW,CAAC,SAAS,MAAM,gBAC1B,CAAC,WACE,aAAa,CAAC,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAGvD,qBAAqB,CAAC,CAAC,CAAC;EAI9B"}

package/dist/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import type { Params } from './url';\n\nimport { classifyRequestError, CourierDisposedError, CourierHttpError, CourierParseError } from './errors';\nimport { buildRequestInit } from './serialize';\nimport { anySignal, buildTimeoutSignal, type TransportCore } from './transport';\nimport { buildUrl } from './url';\n\nexport type StreamOptions<P extends string = string> = {\n  body?: unknown;\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  signal?: AbortSignal;\n  timeout?: number;\n};\n\nexport type StreamEvent<T = unknown> = { readonly data: T; readonly event: string };\n\nfunction abortable<T>(create: (signal: AbortSignal) => AsyncGenerator<T>): AsyncIterableIterator<T> {\n  const controller = new AbortController();\n  const iterator = create(controller.signal);\n\n  return {\n    next: (value?: undefined) => iterator.next(value),\n    return: (value?: T) => {\n      controller.abort();\n\n      return iterator.return(value as T);\n    },\n    [Symbol.asyncIterator]() {\n      return this;\n    },\n    throw: (error?: unknown) => {\n      controller.abort();\n\n      return iterator.throw(error);\n    },\n  };\n}\n\nasync function open(\n  transport: TransportCore,\n  url: string,\n  config: StreamOptions,\n): Promise<{ controller: AbortController; response: Response; untrack: () => void }> {\n  if (transport.disposed) throw new CourierDisposedError('Courier');\n\n  const controller = new AbortController();\n  const untrack = transport.track(controller);\n  const method = (config.method ?? (config.body === undefined ? 'GET' : 'POST')).toUpperCase();\n  const signal = buildTimeoutSignal(\n    config.timeout ?? Number.POSITIVE_INFINITY,\n    anySignal(config.signal, controller.signal),\n  );\n  let fullUrl = url;\n\n  try {\n    fullUrl = buildUrl(transport.baseUrl, url, config.params as Params | undefined, config.query);\n\n    const headers = transport.mergeHeaders(config.headers);\n    const { headers: requestHeaders, ...init } = buildRequestInit(\n      method,\n      headers,\n      config.body,\n      signal,\n      config.fetchInit ?? {},\n    );\n    const response = await transport.dispatch({\n      headers: requestHeaders as Record<string, string>,\n      init,\n      url: fullUrl,\n    });\n\n    if (!response.ok)\n      throw CourierHttpError.fromResponse(response, await response.text().catch(() => ''), method, fullUrl);\n\n    if (!response.body) throw new CourierParseError('Response has no body');\n\n    return { controller, response, untrack };\n  } catch (error) {\n    untrack();\n\n    if (error instanceof CourierHttpError || error instanceof CourierParseError) throw error;\n\n    throw classifyRequestError(error, method, fullUrl, signal);\n  }\n}\n\n/** Platform-shaped streaming primitives: async iteration owns cancellation and backpressure. */\nexport function createStreams(transport: TransportCore) {\n  async function* events<T = unknown, P extends string = string>(\n    url: P,\n    config: StreamOptions<P>,\n  ): AsyncGenerator<StreamEvent<T>> {\n    const { controller, response, untrack } = await open(transport, url, config);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let event = 'message';\n    let data = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) break;\n\n        buffer += decoder.decode(chunk.value, { stream: true }).replace(/\\r\\n?/g, '\\n');\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline);\n\n          buffer = buffer.slice(newline + 1);\n\n          if (line === '') {\n            if (data !== '') {\n              let parsed: unknown = data.endsWith('\\n') ? data.slice(0, -1) : data;\n\n              try {\n                parsed = JSON.parse(parsed as string);\n              } catch {\n                // SSE text payloads are valid raw values.\n              }\n\n              yield { data: parsed as T, event };\n            }\n\n            data = '';\n            event = 'message';\n            continue;\n          }\n\n          if (line.startsWith(':')) continue;\n\n          const separator = line.indexOf(':');\n          const field = separator === -1 ? line : line.slice(0, separator);\n          const value = (separator === -1 ? '' : line.slice(separator + 1)).replace(/^ /, '');\n\n          if (field === 'data') data += `${value}\\n`;\n          else if (field === 'event') event = value;\n        }\n      }\n    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  async function* read<T = string, P extends string = string>(\n    url: P,\n    config: StreamOptions<P> & { parse?: 'ndjson' | 'text' },\n  ): AsyncGenerator<T> {\n    const { controller, response, untrack } = await open(transport, url, config);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) {\n          if (config.parse === 'ndjson' && buffer.trim()) {\n            try {\n              yield JSON.parse(buffer) as T;\n            } catch {\n              throw new CourierParseError(`NDJSON: failed to parse line: ${buffer.slice(0, 200)}`);\n            }\n          }\n\n          break;\n        }\n\n        const text = decoder.decode(chunk.value, { stream: true });\n\n        if (config.parse !== 'ndjson') {\n          yield text as T;\n          continue;\n        }\n\n        buffer += text;\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline).trim();\n\n          buffer = buffer.slice(newline + 1);\n\n          if (!line) continue;\n\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    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  return {\n    events<T = unknown, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> = {},\n    ): AsyncIterableIterator<StreamEvent<T>> {\n      return abortable((signal) =>\n        events<T, P>(url, {\n          ...config,\n          headers: { accept: 'text/event-stream', 'cache-control': 'no-cache', ...config.headers },\n          signal: anySignal(config.signal, signal),\n        }),\n      );\n    },\n    read<T = string, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> & { parse?: 'ndjson' | 'text' } = {},\n    ): AsyncIterableIterator<T> {\n      return abortable((signal) => read<T, P>(url, { ...config, signal: anySignal(config.signal, signal) }));\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"stream.js","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import { CourierDisposedError, CourierHttpError, CourierParseError, classifyRequestError } from './errors';\nimport { buildRequestInit } from './serialize';\nimport { anySignal, buildTimeoutSignal, type TransportCore } from './transport';\nimport type { HttpRequestConfig, Params } from './url';\nimport { buildUrl } from './url';\n\nexport type StreamOptions<P extends string = string> = Omit<HttpRequestConfig<P>, 'responseType' | 'schema'> & {\n  method?: string;\n};\n\n/** Runtime config without PathConfig's type-level constraints — open() just forwards params to buildUrl. */\ntype StreamRuntimeConfig = {\n  body?: unknown;\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  headers?: Record<string, string>;\n  method?: string;\n  params?: Params;\n  query?: Params;\n  signal?: AbortSignal;\n  timeout?: number;\n};\n\nexport type StreamEvent<T = unknown> = { readonly data: T; readonly event: string };\n\nfunction abortable<T>(create: (signal: AbortSignal) => AsyncGenerator<T>): AsyncIterableIterator<T> {\n  const controller = new AbortController();\n  const iterator = create(controller.signal);\n\n  return {\n    next: (value?: undefined) => iterator.next(value),\n    return: (value?: T) => {\n      controller.abort();\n\n      return iterator.return(value as T);\n    },\n    [Symbol.asyncIterator]() {\n      return this;\n    },\n    throw: (error?: unknown) => {\n      controller.abort();\n\n      return iterator.throw(error);\n    },\n  };\n}\n\nasync function open(\n  transport: TransportCore,\n  url: string,\n  config: StreamRuntimeConfig,\n): Promise<{ controller: AbortController; response: Response; untrack: () => void }> {\n  if (transport.disposed) throw new CourierDisposedError('Courier');\n\n  const controller = new AbortController();\n  const untrack = transport.track(controller);\n  const method = (config.method ?? (config.body === undefined ? 'GET' : 'POST')).toUpperCase();\n  const signal = buildTimeoutSignal(\n    config.timeout ?? Number.POSITIVE_INFINITY,\n    anySignal(config.signal, controller.signal),\n  );\n  let fullUrl = url;\n\n  try {\n    fullUrl = buildUrl(transport.baseUrl, url, config.params, config.query);\n\n    const headers = transport.mergeHeaders(config.headers);\n    const { headers: requestHeaders, ...init } = buildRequestInit(\n      method,\n      headers,\n      config.body,\n      signal,\n      config.fetchInit ?? {},\n    );\n    const response = await transport.dispatch({\n      headers: requestHeaders as Record<string, string>,\n      init,\n      url: fullUrl,\n    });\n\n    if (!response.ok)\n      throw CourierHttpError.fromResponse(response, await response.text().catch(() => ''), method, fullUrl);\n\n    if (!response.body) throw new CourierParseError('Response has no body');\n\n    return { controller, response, untrack };\n  } catch (error) {\n    untrack();\n\n    if (error instanceof CourierHttpError || error instanceof CourierParseError) throw error;\n\n    throw classifyRequestError(error, method, fullUrl, signal);\n  }\n}\n\n/** Platform-shaped streaming primitives: async iteration owns cancellation and backpressure. */\nexport function createStreams(transport: TransportCore) {\n  async function* events<T = unknown, P extends string = string>(\n    url: P,\n    config: StreamOptions<P>,\n  ): AsyncGenerator<StreamEvent<T>> {\n    const { controller, response, untrack } = await open(transport, url, config as StreamRuntimeConfig);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let event = 'message';\n    let data = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) break;\n\n        buffer += decoder.decode(chunk.value, { stream: true }).replace(/\\r\\n?/g, '\\n');\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline);\n\n          buffer = buffer.slice(newline + 1);\n\n          if (line === '') {\n            if (data !== '') {\n              let parsed: unknown = data.endsWith('\\n') ? data.slice(0, -1) : data;\n\n              try {\n                parsed = JSON.parse(parsed as string);\n              } catch {\n                // SSE text payloads are valid raw values.\n              }\n\n              yield { data: parsed as T, event };\n            }\n\n            data = '';\n            event = 'message';\n            continue;\n          }\n\n          if (line.startsWith(':')) continue;\n\n          const separator = line.indexOf(':');\n          const field = separator === -1 ? line : line.slice(0, separator);\n          const value = (separator === -1 ? '' : line.slice(separator + 1)).replace(/^ /, '');\n\n          if (field === 'data') data += `${value}\\n`;\n          else if (field === 'event') event = value;\n        }\n      }\n    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  async function* read<T = string, P extends string = string>(\n    url: P,\n    config: StreamOptions<P> & { parse?: 'ndjson' | 'text' },\n  ): AsyncGenerator<T> {\n    const { controller, response, untrack } = await open(transport, url, config as StreamRuntimeConfig);\n    const reader = response.body!.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    try {\n      while (true) {\n        const chunk = await reader.read();\n\n        if (chunk.done) {\n          if (config.parse === 'ndjson' && buffer.trim()) {\n            try {\n              yield JSON.parse(buffer) as T;\n            } catch {\n              throw new CourierParseError(`NDJSON: failed to parse line: ${buffer.slice(0, 200)}`);\n            }\n          }\n\n          break;\n        }\n\n        const text = decoder.decode(chunk.value, { stream: true });\n\n        if (config.parse !== 'ndjson') {\n          yield text as T;\n          continue;\n        }\n\n        buffer += text;\n\n        let newline: number;\n\n        while ((newline = buffer.indexOf('\\n')) !== -1) {\n          const line = buffer.slice(0, newline).trim();\n\n          buffer = buffer.slice(newline + 1);\n\n          if (!line) continue;\n\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    } finally {\n      reader.releaseLock();\n      controller.abort();\n      untrack();\n    }\n  }\n\n  return {\n    events<T = unknown, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> = {} as StreamOptions<P>,\n    ): AsyncIterableIterator<StreamEvent<T>> {\n      return abortable((signal) =>\n        events<T, P>(url, {\n          ...config,\n          headers: { accept: 'text/event-stream', 'cache-control': 'no-cache', ...config.headers },\n          signal: anySignal(config.signal, signal),\n        }),\n      );\n    },\n    read<T = string, P extends string = string>(\n      url: P,\n      config: StreamOptions<P> & { parse?: 'ndjson' | 'text' } = {} as StreamOptions<P> & {\n        parse?: 'ndjson' | 'text';\n      },\n    ): AsyncIterableIterator<T> {\n      return abortable((signal) => read<T, P>(url, { ...config, signal: anySignal(config.signal, signal) }));\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/transport.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs");function t(e,n,r){return{headers:n,init:r,url:e,withHeaders(i){let a={...n};for(let[e,t]of Object.entries(i))a[e.toLowerCase()]=t;return t(e,a,r)}}}function n(...e){let t=e.filter(e=>e!=null);if(t.length!==0)return t.length===1?t[0]:AbortSignal.any(t)}var r=3e4;function i(t){if((t<=0||!Number.isFinite(t))&&t!==1/0)throw new e.CourierError(`[courier] timeout must be a positive number or Infinity`)}function a(e,t){return e===1/0?t??void 0:n(AbortSignal.timeout(e),t)}function o(e={}){let{baseUrl:n=``,fetch:a=globalThis.fetch,headers:o={},timeout:s=r}=e;i(s);let c=Object.fromEntries(Object.entries(o).map(([e,t])=>[e.toLowerCase(),t])),l=new Set,u=new AbortController,d=[],f=null,p=!1;function m(){if(f)return f;let e=e=>a(e.url,{...e.init,headers:e.headers});return f=d.length===0?e:d.reduceRight((e,t)=>n=>t(n,e),e),f}function h(e){return d.push(e),f=null,()=>{let t=d.indexOf(e);t!==-1&&(d.splice(t,1),f=null)}}function g(e){for(let[t,n]of Object.entries(e)){let e=t.toLowerCase();n===void 0?delete c[e]:c[e]=n}}function _(){return{...c}}function v(e,t){let n=e?Object.fromEntries(Object.entries(e).map(([e,t])=>[e.toLowerCase(),t])):void 0;return{...c,...n,...t}}function y(e){return l.add(e),()=>l.delete(e)}function b(e){return m()(t(e.url,e.headers,e.init))}function x(){for(let e of[...l])e.abort();l.clear()}function S(){if(!p){p=!0,u.abort();for(let e of l)e.abort();l.clear(),d.length=0,f=null}}return{baseUrl:n,cancelAll:x,dispatch:b,get disposalSignal(){return u.signal},dispose:S,get disposed(){return p},getHeaders:_,getTimeout(){return s},headers:g,mergeHeaders:v,track:y,use:h}}exports.DEFAULT_TIMEOUT=r,exports.anySignal=n,exports.buildTimeoutSignal=a,exports.createTransportCore=o,exports.validateTimeout=i;
+const e=require("./errors.cjs");function t(e,n,r){return{headers:n,init:r,url:e,withHeaders(i){let a={...n};for(let[e,t]of Object.entries(i))a[e.toLowerCase()]=t;return t(e,a,r)}}}function n(...e){let t=e.filter(e=>e!=null);if(t.length!==0)return t.length===1?t[0]:AbortSignal.any(t)}var r=3e4;function i(t){if((t<=0||!Number.isFinite(t))&&t!==1/0)throw new e.CourierError(`[courier] timeout must be a positive number or Infinity`)}function a(e,t){return e===1/0?t??void 0:n(AbortSignal.timeout(e),t)}function o(e={}){let{baseUrl:n=``,fetch:a=globalThis.fetch,headers:o={},timeout:s=r}=e;i(s);let c=Object.fromEntries(Object.entries(o).map(([e,t])=>[e.toLowerCase(),t])),l=new Set,u=new AbortController,d=[],f=null,p=!1;function m(){if(f)return f;let e=e=>a(e.url,{...e.init,headers:e.headers});return f=d.length===0?e:d.reduceRight((e,t)=>n=>t(n,e),e),f}function h(e){return d.push(e),f=null,()=>{let t=d.indexOf(e);t!==-1&&(d.splice(t,1),f=null)}}function g(e){for(let[t,n]of Object.entries(e)){let e=t.toLowerCase();n===void 0?delete c[e]:c[e]=n}}function _(){return{...c}}function v(e,t){let n=e?Object.fromEntries(Object.entries(e).map(([e,t])=>[e.toLowerCase(),t])):void 0;return{...c,...n,...t}}function y(e){return l.add(e),()=>l.delete(e)}function b(e){return m()(t(e.url,e.headers,e.init))}function x(){for(let e of[...l])e.abort();l.clear()}function S(){if(!p){p=!0,u.abort();for(let e of l)e.abort();l.clear(),d.length=0,f=null}}return{baseUrl:n,cancelAll:x,dispatch:b,get disposalSignal(){return u.signal},dispose:S,get disposed(){return p},getHeaders:_,getTimeout(){return s},mergeHeaders:v,setHeaders:g,track:y,use:h}}exports.DEFAULT_TIMEOUT=r,exports.anySignal=n,exports.buildTimeoutSignal=a,exports.createTransportCore=o,exports.validateTimeout=i;
 //# sourceMappingURL=transport.cjs.map

package/dist/transport.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transport.cjs","names":[],"sources":["../src/transport.ts"],"sourcesContent":["import { CourierError } from './errors';\n\n/**\n * Immutable request context passed through the interceptor pipeline.\n *\n * **Never mutate `init` or `headers` directly.** Use `ctx.withHeaders(updates)` to\n * produce a new context with merged headers — this is the safe, idiomatic pattern\n * for interceptors that need to add or override headers.\n *\n * @example\n * ```ts\n * // Correct — returns a new context\n * return next(ctx.withHeaders({ authorization: `Bearer ${token}` }));\n *\n * // Wrong — mutates shared state, risks stomping other interceptors\n * ctx.init.headers = { ...ctx.init.headers, authorization: `Bearer ${token}` };\n * ```\n */\nexport type FetchContext = {\n  readonly headers: Readonly<Record<string, string>>;\n  readonly init: Readonly<Omit<RequestInit, 'headers'>>;\n  readonly url: string;\n  /** Returns a new `FetchContext` with the given header overrides merged in (lowercase keys). */\n  withHeaders(updates: Record<string, string>): FetchContext;\n};\n\nfunction makeFetchContext(\n  url: string,\n  headers: Record<string, string>,\n  init: Omit<RequestInit, 'headers'>,\n): FetchContext {\n  const ctx: FetchContext = {\n    headers,\n    init,\n    url,\n    withHeaders(updates: Record<string, string>): FetchContext {\n      const merged = { ...headers };\n\n      for (const [k, v] of Object.entries(updates)) merged[k.toLowerCase()] = v;\n\n      return makeFetchContext(url, merged, init);\n    },\n  };\n\n  return ctx;\n}\n\nexport function anySignal(...signals: ReadonlyArray<AbortSignal | null | undefined>): AbortSignal | undefined {\n  const active = signals.filter((s): s is AbortSignal => s != null);\n\n  if (active.length === 0) return undefined;\n\n  if (active.length === 1) return active[0];\n\n  return AbortSignal.any(active);\n}\nexport type Interceptor = (ctx: FetchContext, next: (ctx: FetchContext) => Promise<Response>) => Promise<Response>;\n\nexport type TransportOptions = {\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  headers?: Record<string, string>;\n  timeout?: number;\n};\n\nexport const DEFAULT_TIMEOUT = 30_000;\n\nexport function validateTimeout(timeoutMs: number): void {\n  if ((timeoutMs <= 0 || !Number.isFinite(timeoutMs)) && timeoutMs !== Number.POSITIVE_INFINITY) {\n    throw new CourierError('[courier] timeout must be a positive number or Infinity');\n  }\n}\n\nexport function buildTimeoutSignal(timeoutMs: number, external?: AbortSignal | null): AbortSignal | undefined {\n  if (timeoutMs === Number.POSITIVE_INFINITY) {\n    return external ?? undefined;\n  }\n\n  return anySignal(AbortSignal.timeout(timeoutMs), external);\n}\n\n/**\n * Shared transport core: interceptor pipeline, header management, AbortController lifecycle.\n * HTTP requests and streams build on this to avoid duplicating infrastructure.\n */\nexport function createTransportCore(opts: TransportOptions = {}) {\n  const {\n    baseUrl = '',\n    fetch: fetchFn = globalThis.fetch,\n    headers: initialHeaders = {},\n    timeout = DEFAULT_TIMEOUT,\n  } = opts;\n\n  validateTimeout(timeout);\n\n  const globalHeaders: Record<string, string> = Object.fromEntries(\n    Object.entries(initialHeaders).map(([k, v]) => [k.toLowerCase(), v]),\n  );\n  const activeControllers = new Set<AbortController>();\n  const disposeController = new AbortController();\n  const interceptors: Interceptor[] = [];\n  let cachedPipeline: ((ctx: FetchContext) => Promise<Response>) | null = null;\n  let disposed = false;\n\n  function getPipeline(): (ctx: FetchContext) => Promise<Response> {\n    if (cachedPipeline) return cachedPipeline;\n\n    const base: (ctx: FetchContext) => Promise<Response> = (ctx) =>\n      fetchFn(ctx.url, { ...ctx.init, headers: ctx.headers });\n\n    cachedPipeline =\n      interceptors.length === 0\n        ? base\n        : interceptors.reduceRight<(ctx: FetchContext) => Promise<Response>>(\n            (next, interceptor) => (ctx) => interceptor(ctx, next),\n            base,\n          );\n\n    return cachedPipeline;\n  }\n\n  function use(interceptor: Interceptor): () => void {\n    interceptors.push(interceptor);\n    cachedPipeline = null;\n\n    return () => {\n      const i = interceptors.indexOf(interceptor);\n\n      if (i !== -1) {\n        interceptors.splice(i, 1);\n        cachedPipeline = null;\n      }\n    };\n  }\n\n  function headers(updates: Record<string, string | undefined>): void {\n    for (const [key, value] of Object.entries(updates)) {\n      const k = key.toLowerCase();\n\n      if (value === undefined) delete globalHeaders[k];\n      else globalHeaders[k] = value;\n    }\n  }\n\n  /** Returns a read-only snapshot of the current global headers. */\n  function getHeaders(): Readonly<Record<string, string>> {\n    return { ...globalHeaders };\n  }\n\n  /**\n   * Merge global headers with optional per-request and extra headers.\n   * Per-request keys are normalised to lowercase.\n   */\n  function mergeHeaders(perRequest?: Record<string, string>, extra?: Record<string, string>): Record<string, string> {\n    const normalized = perRequest\n      ? Object.fromEntries(Object.entries(perRequest).map(([k, v]) => [k.toLowerCase(), v]))\n      : undefined;\n\n    return { ...globalHeaders, ...normalized, ...extra };\n  }\n\n  /** Register an AbortController for lifecycle tracking (cancelAll / dispose). Returns an untrack fn. */\n  function track(ac: AbortController): () => void {\n    activeControllers.add(ac);\n\n    return () => activeControllers.delete(ac);\n  }\n\n  /**\n   * Dispatch a request through the interceptor pipeline.\n   * Accepts a plain `{ url, headers, init }` object and promotes it to a\n   * full `FetchContext` with `withHeaders()` before entering the pipeline.\n   */\n  function dispatch(raw: {\n    headers: Record<string, string>;\n    init: Omit<RequestInit, 'headers'>;\n    url: string;\n  }): Promise<Response> {\n    return getPipeline()(makeFetchContext(raw.url, raw.headers, raw.init));\n  }\n\n  function cancelAll(): void {\n    for (const ac of [...activeControllers]) ac.abort();\n    activeControllers.clear();\n  }\n\n  function dispose(): void {\n    if (disposed) return;\n\n    disposed = true;\n    disposeController.abort();\n\n    for (const ac of activeControllers) ac.abort();\n\n    activeControllers.clear();\n    interceptors.length = 0;\n    cachedPipeline = null;\n  }\n\n  return {\n    baseUrl,\n    cancelAll,\n    dispatch,\n    get disposalSignal() {\n      return disposeController.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    getHeaders,\n    /** Returns the configured request timeout in ms. */\n    getTimeout(): number {\n      return timeout;\n    },\n    headers,\n    mergeHeaders,\n    track,\n    use,\n  };\n}\n\nexport type TransportCore = ReturnType<typeof createTransportCore>;\n"],"mappings":"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"}
+{"version":3,"file":"transport.cjs","names":[],"sources":["../src/transport.ts"],"sourcesContent":["import { CourierError } from './errors';\n\n/**\n * Immutable request context passed through the interceptor pipeline.\n *\n * **Never mutate `init` or `headers` directly.** Use `ctx.withHeaders(updates)` to\n * produce a new context with merged headers — this is the safe, idiomatic pattern\n * for interceptors that need to add or override headers.\n *\n * @example\n * ```ts\n * // Correct — returns a new context\n * return next(ctx.withHeaders({ authorization: `Bearer ${token}` }));\n *\n * // Wrong — mutates shared state, risks stomping other interceptors\n * ctx.init.headers = { ...ctx.init.headers, authorization: `Bearer ${token}` };\n * ```\n */\nexport type FetchContext = {\n  readonly headers: Readonly<Record<string, string>>;\n  readonly init: Readonly<Omit<RequestInit, 'headers'>>;\n  readonly url: string;\n  /** Returns a new `FetchContext` with the given header overrides merged in (lowercase keys). */\n  withHeaders(updates: Record<string, string>): FetchContext;\n};\n\nfunction makeFetchContext(\n  url: string,\n  headers: Record<string, string>,\n  init: Omit<RequestInit, 'headers'>,\n): FetchContext {\n  const ctx: FetchContext = {\n    headers,\n    init,\n    url,\n    withHeaders(updates: Record<string, string>): FetchContext {\n      const merged = { ...headers };\n\n      for (const [k, v] of Object.entries(updates)) merged[k.toLowerCase()] = v;\n\n      return makeFetchContext(url, merged, init);\n    },\n  };\n\n  return ctx;\n}\n\nexport function anySignal(...signals: ReadonlyArray<AbortSignal | null | undefined>): AbortSignal | undefined {\n  const active = signals.filter((s): s is AbortSignal => s != null);\n\n  if (active.length === 0) return undefined;\n\n  if (active.length === 1) return active[0];\n\n  return AbortSignal.any(active);\n}\nexport type Interceptor = (ctx: FetchContext, next: (ctx: FetchContext) => Promise<Response>) => Promise<Response>;\n\nexport type TransportOptions = {\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  headers?: Record<string, string>;\n  timeout?: number;\n};\n\nexport const DEFAULT_TIMEOUT = 30_000;\n\nexport function validateTimeout(timeoutMs: number): void {\n  if ((timeoutMs <= 0 || !Number.isFinite(timeoutMs)) && timeoutMs !== Number.POSITIVE_INFINITY) {\n    throw new CourierError('[courier] timeout must be a positive number or Infinity');\n  }\n}\n\nexport function buildTimeoutSignal(timeoutMs: number, external?: AbortSignal | null): AbortSignal | undefined {\n  if (timeoutMs === Number.POSITIVE_INFINITY) {\n    return external ?? undefined;\n  }\n\n  return anySignal(AbortSignal.timeout(timeoutMs), external);\n}\n\n/**\n * Shared transport core: interceptor pipeline, header management, AbortController lifecycle.\n * HTTP requests and streams build on this to avoid duplicating infrastructure.\n */\nexport function createTransportCore(opts: TransportOptions = {}) {\n  const {\n    baseUrl = '',\n    fetch: fetchFn = globalThis.fetch,\n    headers: initialHeaders = {},\n    timeout = DEFAULT_TIMEOUT,\n  } = opts;\n\n  validateTimeout(timeout);\n\n  const globalHeaders: Record<string, string> = Object.fromEntries(\n    Object.entries(initialHeaders).map(([k, v]) => [k.toLowerCase(), v]),\n  );\n  const activeControllers = new Set<AbortController>();\n  const disposeController = new AbortController();\n  const interceptors: Interceptor[] = [];\n  let cachedPipeline: ((ctx: FetchContext) => Promise<Response>) | null = null;\n  let disposed = false;\n\n  function getPipeline(): (ctx: FetchContext) => Promise<Response> {\n    if (cachedPipeline) return cachedPipeline;\n\n    const base: (ctx: FetchContext) => Promise<Response> = (ctx) =>\n      fetchFn(ctx.url, { ...ctx.init, headers: ctx.headers });\n\n    cachedPipeline =\n      interceptors.length === 0\n        ? base\n        : interceptors.reduceRight<(ctx: FetchContext) => Promise<Response>>(\n            (next, interceptor) => (ctx) => interceptor(ctx, next),\n            base,\n          );\n\n    return cachedPipeline;\n  }\n\n  function use(interceptor: Interceptor): () => void {\n    interceptors.push(interceptor);\n    cachedPipeline = null;\n\n    return () => {\n      const i = interceptors.indexOf(interceptor);\n\n      if (i !== -1) {\n        interceptors.splice(i, 1);\n        cachedPipeline = null;\n      }\n    };\n  }\n\n  function setHeaders(updates: Record<string, string | undefined>): void {\n    for (const [key, value] of Object.entries(updates)) {\n      const k = key.toLowerCase();\n\n      if (value === undefined) delete globalHeaders[k];\n      else globalHeaders[k] = value;\n    }\n  }\n\n  /** Returns a read-only snapshot of the current global headers. */\n  function getHeaders(): Readonly<Record<string, string>> {\n    return { ...globalHeaders };\n  }\n\n  /**\n   * Merge global headers with optional per-request and extra headers.\n   * Per-request keys are normalised to lowercase.\n   */\n  function mergeHeaders(perRequest?: Record<string, string>, extra?: Record<string, string>): Record<string, string> {\n    const normalized = perRequest\n      ? Object.fromEntries(Object.entries(perRequest).map(([k, v]) => [k.toLowerCase(), v]))\n      : undefined;\n\n    return { ...globalHeaders, ...normalized, ...extra };\n  }\n\n  /** Register an AbortController for lifecycle tracking (cancelAll / dispose). Returns an untrack fn. */\n  function track(ac: AbortController): () => void {\n    activeControllers.add(ac);\n\n    return () => activeControllers.delete(ac);\n  }\n\n  /**\n   * Dispatch a request through the interceptor pipeline.\n   * Accepts a plain `{ url, headers, init }` object and promotes it to a\n   * full `FetchContext` with `withHeaders()` before entering the pipeline.\n   */\n  function dispatch(raw: {\n    headers: Record<string, string>;\n    init: Omit<RequestInit, 'headers'>;\n    url: string;\n  }): Promise<Response> {\n    return getPipeline()(makeFetchContext(raw.url, raw.headers, raw.init));\n  }\n\n  function cancelAll(): void {\n    for (const ac of [...activeControllers]) ac.abort();\n    activeControllers.clear();\n  }\n\n  function dispose(): void {\n    if (disposed) return;\n\n    disposed = true;\n    disposeController.abort();\n\n    for (const ac of activeControllers) ac.abort();\n\n    activeControllers.clear();\n    interceptors.length = 0;\n    cachedPipeline = null;\n  }\n\n  return {\n    baseUrl,\n    cancelAll,\n    dispatch,\n    get disposalSignal() {\n      return disposeController.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    getHeaders,\n    /** Returns the configured request timeout in ms. */\n    getTimeout(): number {\n      return timeout;\n    },\n    mergeHeaders,\n    setHeaders,\n    track,\n    use,\n  };\n}\n\nexport type TransportCore = ReturnType<typeof createTransportCore>;\n"],"mappings":"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"}

package/dist/transport.d.ts

@@ -50,8 +50,8 @@ export declare function createTransportCore(opts?: TransportOptions): {
     getHeaders: () => Readonly<Record<string, string>>;
     /** Returns the configured request timeout in ms. */
     getTimeout(): number;
-    headers: (updates: Record<string, string | undefined>) => void;
     mergeHeaders: (perRequest?: Record<string, string>, extra?: Record<string, string>) => Record<string, string>;
+    setHeaders: (updates: Record<string, string | undefined>) => void;
     track: (ac: AbortController) => () => void;
     use: (interceptor: Interceptor) => () => void;
 };

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;CAC5D,CAAC;AAuBF,wBAAgB,SAAS,CAAC,GAAG,OAAO,EAAE,aAAa,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,WAAW,GAAG,SAAS,CAQ5G;AACD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,GAAG,SAAS,CAM5G;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAAqB;;qBAgGvC,IAAI;oBARH;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACnC,GAAG,EAAE,MAAM,CAAC;KACb,KAAG,OAAO,CAAC,QAAQ,CAAC;;mBASD,IAAI;;sBAzCD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAkErD,oDAAoD;kBACtC,MAAM;uBA7EI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAG,IAAI;gCAkBhC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAS/F,eAAe,KAAG,MAAM,IAAI;uBAzCrB,WAAW,KAAG,MAAM,IAAI;EAmGnD;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;CAC5D,CAAC;AAuBF,wBAAgB,SAAS,CAAC,GAAG,OAAO,EAAE,aAAa,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,WAAW,GAAG,SAAS,CAQ5G;AACD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,GAAG,SAAS,CAM5G;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAAqB;;qBAgGvC,IAAI;oBARH;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACnC,GAAG,EAAE,MAAM,CAAC;KACb,KAAG,OAAO,CAAC,QAAQ,CAAC;;mBASD,IAAI;;sBAzCD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAkErD,oDAAoD;kBACtC,MAAM;gCA3Da,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;0BAlBrF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAG,IAAI;gBA2BnD,eAAe,KAAG,MAAM,IAAI;uBAzCrB,WAAW,KAAG,MAAM,IAAI;EAmGnD;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/transport.js

@@ -1,2 +1,2 @@
-import{CourierError as e}from"./errors.js";function t(e,n,r){return{headers:n,init:r,url:e,withHeaders(i){let a={...n};for(let[e,t]of Object.entries(i))a[e.toLowerCase()]=t;return t(e,a,r)}}}function n(...e){let t=e.filter(e=>e!=null);if(t.length!==0)return t.length===1?t[0]:AbortSignal.any(t)}var r=3e4;function i(t){if((t<=0||!Number.isFinite(t))&&t!==1/0)throw new e(`[courier] timeout must be a positive number or Infinity`)}function a(e,t){return e===1/0?t??void 0:n(AbortSignal.timeout(e),t)}function o(e={}){let{baseUrl:n=``,fetch:a=globalThis.fetch,headers:o={},timeout:s=r}=e;i(s);let c=Object.fromEntries(Object.entries(o).map(([e,t])=>[e.toLowerCase(),t])),l=new Set,u=new AbortController,d=[],f=null,p=!1;function m(){if(f)return f;let e=e=>a(e.url,{...e.init,headers:e.headers});return f=d.length===0?e:d.reduceRight((e,t)=>n=>t(n,e),e),f}function h(e){return d.push(e),f=null,()=>{let t=d.indexOf(e);t!==-1&&(d.splice(t,1),f=null)}}function g(e){for(let[t,n]of Object.entries(e)){let e=t.toLowerCase();n===void 0?delete c[e]:c[e]=n}}function _(){return{...c}}function v(e,t){let n=e?Object.fromEntries(Object.entries(e).map(([e,t])=>[e.toLowerCase(),t])):void 0;return{...c,...n,...t}}function y(e){return l.add(e),()=>l.delete(e)}function b(e){return m()(t(e.url,e.headers,e.init))}function x(){for(let e of[...l])e.abort();l.clear()}function S(){if(!p){p=!0,u.abort();for(let e of l)e.abort();l.clear(),d.length=0,f=null}}return{baseUrl:n,cancelAll:x,dispatch:b,get disposalSignal(){return u.signal},dispose:S,get disposed(){return p},getHeaders:_,getTimeout(){return s},headers:g,mergeHeaders:v,track:y,use:h}}export{r as DEFAULT_TIMEOUT,n as anySignal,a as buildTimeoutSignal,o as createTransportCore,i as validateTimeout};
+import{CourierError as e}from"./errors.js";function t(e,n,r){return{headers:n,init:r,url:e,withHeaders(i){let a={...n};for(let[e,t]of Object.entries(i))a[e.toLowerCase()]=t;return t(e,a,r)}}}function n(...e){let t=e.filter(e=>e!=null);if(t.length!==0)return t.length===1?t[0]:AbortSignal.any(t)}var r=3e4;function i(t){if((t<=0||!Number.isFinite(t))&&t!==1/0)throw new e(`[courier] timeout must be a positive number or Infinity`)}function a(e,t){return e===1/0?t??void 0:n(AbortSignal.timeout(e),t)}function o(e={}){let{baseUrl:n=``,fetch:a=globalThis.fetch,headers:o={},timeout:s=r}=e;i(s);let c=Object.fromEntries(Object.entries(o).map(([e,t])=>[e.toLowerCase(),t])),l=new Set,u=new AbortController,d=[],f=null,p=!1;function m(){if(f)return f;let e=e=>a(e.url,{...e.init,headers:e.headers});return f=d.length===0?e:d.reduceRight((e,t)=>n=>t(n,e),e),f}function h(e){return d.push(e),f=null,()=>{let t=d.indexOf(e);t!==-1&&(d.splice(t,1),f=null)}}function g(e){for(let[t,n]of Object.entries(e)){let e=t.toLowerCase();n===void 0?delete c[e]:c[e]=n}}function _(){return{...c}}function v(e,t){let n=e?Object.fromEntries(Object.entries(e).map(([e,t])=>[e.toLowerCase(),t])):void 0;return{...c,...n,...t}}function y(e){return l.add(e),()=>l.delete(e)}function b(e){return m()(t(e.url,e.headers,e.init))}function x(){for(let e of[...l])e.abort();l.clear()}function S(){if(!p){p=!0,u.abort();for(let e of l)e.abort();l.clear(),d.length=0,f=null}}return{baseUrl:n,cancelAll:x,dispatch:b,get disposalSignal(){return u.signal},dispose:S,get disposed(){return p},getHeaders:_,getTimeout(){return s},mergeHeaders:v,setHeaders:g,track:y,use:h}}export{r as DEFAULT_TIMEOUT,n as anySignal,a as buildTimeoutSignal,o as createTransportCore,i as validateTimeout};
 //# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","names":[],"sources":["../src/transport.ts"],"sourcesContent":["import { CourierError } from './errors';\n\n/**\n * Immutable request context passed through the interceptor pipeline.\n *\n * **Never mutate `init` or `headers` directly.** Use `ctx.withHeaders(updates)` to\n * produce a new context with merged headers — this is the safe, idiomatic pattern\n * for interceptors that need to add or override headers.\n *\n * @example\n * ```ts\n * // Correct — returns a new context\n * return next(ctx.withHeaders({ authorization: `Bearer ${token}` }));\n *\n * // Wrong — mutates shared state, risks stomping other interceptors\n * ctx.init.headers = { ...ctx.init.headers, authorization: `Bearer ${token}` };\n * ```\n */\nexport type FetchContext = {\n  readonly headers: Readonly<Record<string, string>>;\n  readonly init: Readonly<Omit<RequestInit, 'headers'>>;\n  readonly url: string;\n  /** Returns a new `FetchContext` with the given header overrides merged in (lowercase keys). */\n  withHeaders(updates: Record<string, string>): FetchContext;\n};\n\nfunction makeFetchContext(\n  url: string,\n  headers: Record<string, string>,\n  init: Omit<RequestInit, 'headers'>,\n): FetchContext {\n  const ctx: FetchContext = {\n    headers,\n    init,\n    url,\n    withHeaders(updates: Record<string, string>): FetchContext {\n      const merged = { ...headers };\n\n      for (const [k, v] of Object.entries(updates)) merged[k.toLowerCase()] = v;\n\n      return makeFetchContext(url, merged, init);\n    },\n  };\n\n  return ctx;\n}\n\nexport function anySignal(...signals: ReadonlyArray<AbortSignal | null | undefined>): AbortSignal | undefined {\n  const active = signals.filter((s): s is AbortSignal => s != null);\n\n  if (active.length === 0) return undefined;\n\n  if (active.length === 1) return active[0];\n\n  return AbortSignal.any(active);\n}\nexport type Interceptor = (ctx: FetchContext, next: (ctx: FetchContext) => Promise<Response>) => Promise<Response>;\n\nexport type TransportOptions = {\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  headers?: Record<string, string>;\n  timeout?: number;\n};\n\nexport const DEFAULT_TIMEOUT = 30_000;\n\nexport function validateTimeout(timeoutMs: number): void {\n  if ((timeoutMs <= 0 || !Number.isFinite(timeoutMs)) && timeoutMs !== Number.POSITIVE_INFINITY) {\n    throw new CourierError('[courier] timeout must be a positive number or Infinity');\n  }\n}\n\nexport function buildTimeoutSignal(timeoutMs: number, external?: AbortSignal | null): AbortSignal | undefined {\n  if (timeoutMs === Number.POSITIVE_INFINITY) {\n    return external ?? undefined;\n  }\n\n  return anySignal(AbortSignal.timeout(timeoutMs), external);\n}\n\n/**\n * Shared transport core: interceptor pipeline, header management, AbortController lifecycle.\n * HTTP requests and streams build on this to avoid duplicating infrastructure.\n */\nexport function createTransportCore(opts: TransportOptions = {}) {\n  const {\n    baseUrl = '',\n    fetch: fetchFn = globalThis.fetch,\n    headers: initialHeaders = {},\n    timeout = DEFAULT_TIMEOUT,\n  } = opts;\n\n  validateTimeout(timeout);\n\n  const globalHeaders: Record<string, string> = Object.fromEntries(\n    Object.entries(initialHeaders).map(([k, v]) => [k.toLowerCase(), v]),\n  );\n  const activeControllers = new Set<AbortController>();\n  const disposeController = new AbortController();\n  const interceptors: Interceptor[] = [];\n  let cachedPipeline: ((ctx: FetchContext) => Promise<Response>) | null = null;\n  let disposed = false;\n\n  function getPipeline(): (ctx: FetchContext) => Promise<Response> {\n    if (cachedPipeline) return cachedPipeline;\n\n    const base: (ctx: FetchContext) => Promise<Response> = (ctx) =>\n      fetchFn(ctx.url, { ...ctx.init, headers: ctx.headers });\n\n    cachedPipeline =\n      interceptors.length === 0\n        ? base\n        : interceptors.reduceRight<(ctx: FetchContext) => Promise<Response>>(\n            (next, interceptor) => (ctx) => interceptor(ctx, next),\n            base,\n          );\n\n    return cachedPipeline;\n  }\n\n  function use(interceptor: Interceptor): () => void {\n    interceptors.push(interceptor);\n    cachedPipeline = null;\n\n    return () => {\n      const i = interceptors.indexOf(interceptor);\n\n      if (i !== -1) {\n        interceptors.splice(i, 1);\n        cachedPipeline = null;\n      }\n    };\n  }\n\n  function headers(updates: Record<string, string | undefined>): void {\n    for (const [key, value] of Object.entries(updates)) {\n      const k = key.toLowerCase();\n\n      if (value === undefined) delete globalHeaders[k];\n      else globalHeaders[k] = value;\n    }\n  }\n\n  /** Returns a read-only snapshot of the current global headers. */\n  function getHeaders(): Readonly<Record<string, string>> {\n    return { ...globalHeaders };\n  }\n\n  /**\n   * Merge global headers with optional per-request and extra headers.\n   * Per-request keys are normalised to lowercase.\n   */\n  function mergeHeaders(perRequest?: Record<string, string>, extra?: Record<string, string>): Record<string, string> {\n    const normalized = perRequest\n      ? Object.fromEntries(Object.entries(perRequest).map(([k, v]) => [k.toLowerCase(), v]))\n      : undefined;\n\n    return { ...globalHeaders, ...normalized, ...extra };\n  }\n\n  /** Register an AbortController for lifecycle tracking (cancelAll / dispose). Returns an untrack fn. */\n  function track(ac: AbortController): () => void {\n    activeControllers.add(ac);\n\n    return () => activeControllers.delete(ac);\n  }\n\n  /**\n   * Dispatch a request through the interceptor pipeline.\n   * Accepts a plain `{ url, headers, init }` object and promotes it to a\n   * full `FetchContext` with `withHeaders()` before entering the pipeline.\n   */\n  function dispatch(raw: {\n    headers: Record<string, string>;\n    init: Omit<RequestInit, 'headers'>;\n    url: string;\n  }): Promise<Response> {\n    return getPipeline()(makeFetchContext(raw.url, raw.headers, raw.init));\n  }\n\n  function cancelAll(): void {\n    for (const ac of [...activeControllers]) ac.abort();\n    activeControllers.clear();\n  }\n\n  function dispose(): void {\n    if (disposed) return;\n\n    disposed = true;\n    disposeController.abort();\n\n    for (const ac of activeControllers) ac.abort();\n\n    activeControllers.clear();\n    interceptors.length = 0;\n    cachedPipeline = null;\n  }\n\n  return {\n    baseUrl,\n    cancelAll,\n    dispatch,\n    get disposalSignal() {\n      return disposeController.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    getHeaders,\n    /** Returns the configured request timeout in ms. */\n    getTimeout(): number {\n      return timeout;\n    },\n    headers,\n    mergeHeaders,\n    track,\n    use,\n  };\n}\n\nexport type TransportCore = ReturnType<typeof createTransportCore>;\n"],"mappings":"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"}
+{"version":3,"file":"transport.js","names":[],"sources":["../src/transport.ts"],"sourcesContent":["import { CourierError } from './errors';\n\n/**\n * Immutable request context passed through the interceptor pipeline.\n *\n * **Never mutate `init` or `headers` directly.** Use `ctx.withHeaders(updates)` to\n * produce a new context with merged headers — this is the safe, idiomatic pattern\n * for interceptors that need to add or override headers.\n *\n * @example\n * ```ts\n * // Correct — returns a new context\n * return next(ctx.withHeaders({ authorization: `Bearer ${token}` }));\n *\n * // Wrong — mutates shared state, risks stomping other interceptors\n * ctx.init.headers = { ...ctx.init.headers, authorization: `Bearer ${token}` };\n * ```\n */\nexport type FetchContext = {\n  readonly headers: Readonly<Record<string, string>>;\n  readonly init: Readonly<Omit<RequestInit, 'headers'>>;\n  readonly url: string;\n  /** Returns a new `FetchContext` with the given header overrides merged in (lowercase keys). */\n  withHeaders(updates: Record<string, string>): FetchContext;\n};\n\nfunction makeFetchContext(\n  url: string,\n  headers: Record<string, string>,\n  init: Omit<RequestInit, 'headers'>,\n): FetchContext {\n  const ctx: FetchContext = {\n    headers,\n    init,\n    url,\n    withHeaders(updates: Record<string, string>): FetchContext {\n      const merged = { ...headers };\n\n      for (const [k, v] of Object.entries(updates)) merged[k.toLowerCase()] = v;\n\n      return makeFetchContext(url, merged, init);\n    },\n  };\n\n  return ctx;\n}\n\nexport function anySignal(...signals: ReadonlyArray<AbortSignal | null | undefined>): AbortSignal | undefined {\n  const active = signals.filter((s): s is AbortSignal => s != null);\n\n  if (active.length === 0) return undefined;\n\n  if (active.length === 1) return active[0];\n\n  return AbortSignal.any(active);\n}\nexport type Interceptor = (ctx: FetchContext, next: (ctx: FetchContext) => Promise<Response>) => Promise<Response>;\n\nexport type TransportOptions = {\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  headers?: Record<string, string>;\n  timeout?: number;\n};\n\nexport const DEFAULT_TIMEOUT = 30_000;\n\nexport function validateTimeout(timeoutMs: number): void {\n  if ((timeoutMs <= 0 || !Number.isFinite(timeoutMs)) && timeoutMs !== Number.POSITIVE_INFINITY) {\n    throw new CourierError('[courier] timeout must be a positive number or Infinity');\n  }\n}\n\nexport function buildTimeoutSignal(timeoutMs: number, external?: AbortSignal | null): AbortSignal | undefined {\n  if (timeoutMs === Number.POSITIVE_INFINITY) {\n    return external ?? undefined;\n  }\n\n  return anySignal(AbortSignal.timeout(timeoutMs), external);\n}\n\n/**\n * Shared transport core: interceptor pipeline, header management, AbortController lifecycle.\n * HTTP requests and streams build on this to avoid duplicating infrastructure.\n */\nexport function createTransportCore(opts: TransportOptions = {}) {\n  const {\n    baseUrl = '',\n    fetch: fetchFn = globalThis.fetch,\n    headers: initialHeaders = {},\n    timeout = DEFAULT_TIMEOUT,\n  } = opts;\n\n  validateTimeout(timeout);\n\n  const globalHeaders: Record<string, string> = Object.fromEntries(\n    Object.entries(initialHeaders).map(([k, v]) => [k.toLowerCase(), v]),\n  );\n  const activeControllers = new Set<AbortController>();\n  const disposeController = new AbortController();\n  const interceptors: Interceptor[] = [];\n  let cachedPipeline: ((ctx: FetchContext) => Promise<Response>) | null = null;\n  let disposed = false;\n\n  function getPipeline(): (ctx: FetchContext) => Promise<Response> {\n    if (cachedPipeline) return cachedPipeline;\n\n    const base: (ctx: FetchContext) => Promise<Response> = (ctx) =>\n      fetchFn(ctx.url, { ...ctx.init, headers: ctx.headers });\n\n    cachedPipeline =\n      interceptors.length === 0\n        ? base\n        : interceptors.reduceRight<(ctx: FetchContext) => Promise<Response>>(\n            (next, interceptor) => (ctx) => interceptor(ctx, next),\n            base,\n          );\n\n    return cachedPipeline;\n  }\n\n  function use(interceptor: Interceptor): () => void {\n    interceptors.push(interceptor);\n    cachedPipeline = null;\n\n    return () => {\n      const i = interceptors.indexOf(interceptor);\n\n      if (i !== -1) {\n        interceptors.splice(i, 1);\n        cachedPipeline = null;\n      }\n    };\n  }\n\n  function setHeaders(updates: Record<string, string | undefined>): void {\n    for (const [key, value] of Object.entries(updates)) {\n      const k = key.toLowerCase();\n\n      if (value === undefined) delete globalHeaders[k];\n      else globalHeaders[k] = value;\n    }\n  }\n\n  /** Returns a read-only snapshot of the current global headers. */\n  function getHeaders(): Readonly<Record<string, string>> {\n    return { ...globalHeaders };\n  }\n\n  /**\n   * Merge global headers with optional per-request and extra headers.\n   * Per-request keys are normalised to lowercase.\n   */\n  function mergeHeaders(perRequest?: Record<string, string>, extra?: Record<string, string>): Record<string, string> {\n    const normalized = perRequest\n      ? Object.fromEntries(Object.entries(perRequest).map(([k, v]) => [k.toLowerCase(), v]))\n      : undefined;\n\n    return { ...globalHeaders, ...normalized, ...extra };\n  }\n\n  /** Register an AbortController for lifecycle tracking (cancelAll / dispose). Returns an untrack fn. */\n  function track(ac: AbortController): () => void {\n    activeControllers.add(ac);\n\n    return () => activeControllers.delete(ac);\n  }\n\n  /**\n   * Dispatch a request through the interceptor pipeline.\n   * Accepts a plain `{ url, headers, init }` object and promotes it to a\n   * full `FetchContext` with `withHeaders()` before entering the pipeline.\n   */\n  function dispatch(raw: {\n    headers: Record<string, string>;\n    init: Omit<RequestInit, 'headers'>;\n    url: string;\n  }): Promise<Response> {\n    return getPipeline()(makeFetchContext(raw.url, raw.headers, raw.init));\n  }\n\n  function cancelAll(): void {\n    for (const ac of [...activeControllers]) ac.abort();\n    activeControllers.clear();\n  }\n\n  function dispose(): void {\n    if (disposed) return;\n\n    disposed = true;\n    disposeController.abort();\n\n    for (const ac of activeControllers) ac.abort();\n\n    activeControllers.clear();\n    interceptors.length = 0;\n    cachedPipeline = null;\n  }\n\n  return {\n    baseUrl,\n    cancelAll,\n    dispatch,\n    get disposalSignal() {\n      return disposeController.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    getHeaders,\n    /** Returns the configured request timeout in ms. */\n    getTimeout(): number {\n      return timeout;\n    },\n    mergeHeaders,\n    setHeaders,\n    track,\n    use,\n  };\n}\n\nexport type TransportCore = ReturnType<typeof createTransportCore>;\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -1,6 +1,4 @@
-export type QueryKeyAtom = string | number | boolean | null | {
-    readonly [key: string]: string | number | boolean | null;
-};
+export type QueryKeyAtom = string | number | boolean | null;
 export type QueryKey = readonly [QueryKeyAtom, ...QueryKeyAtom[]];
 export type Unsubscribe = () => void;
 export type AsyncState<T> = {
@@ -38,9 +36,12 @@ export type QueryCache = {
     }): Promise<T>;
     get<T>(key: QueryKey): T | undefined;
     getSnapshot<T>(key: QueryKey): AsyncState<T> | null;
-    invalidate(key: QueryKey): void;
+    /** Invalidate entries whose key starts with `prefix`. An empty prefix invalidates every entry.
+     *  When `refetch` is true, invalidated entries with a registered definition are refetched in the background. */
+    invalidate(prefix: readonly unknown[], options?: {
+        refetch?: boolean;
+    }): void;
     keys(): QueryKey[];
-    refetchStale(): void;
     set<T>(key: QueryKey, data: T, options?: {
         updatedAt?: number;
     }): void;
@@ -50,6 +51,9 @@ export type MutationContext = {
     readonly signal: AbortSignal;
 };
 export type MutationOptions<T> = {
+    /** Cache key prefixes to invalidate (and refetch) after a successful write. Replaces manual
+     *  `invalidate()` + `refetchStale()` calls in `onSuccess`. */
+    invalidateKeys?: readonly (readonly unknown[])[];
     onSuccess?: (data: T, queries: QueryCache) => void | Promise<void>;
     request: (context: MutationContext) => Promise<T>;
     signal?: AbortSignal;