@vielzeug/courier 2.3.0 → 3.0.0

package/dist/query.cjs.map

@@ -1 +0,0 @@
-{"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()) {\n      entry.controller?.abort();\n      entry.controller = undefined;\n      entry.promise = undefined;\n    }\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          if (entry.promise !== promise) return data;\n\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          if (entry.promise !== promise) throw cause;\n\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    delete(key: QueryKey): void {\n      const id = hash(key);\n      const entry = entries.get(id);\n\n      if (!entry) return;\n\n      // Prevent an aborted in-flight promise from writing a stale error snapshot\n      // after this entry has been explicitly removed.\n      entry.promise = undefined;\n      entry.controller?.abort();\n      entry.controller = undefined;\n\n      entries.delete(id);\n      notify(key);\n      scheduleGc();\n    },\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

@@ -1,13 +0,0 @@
-import type { QueryCache } from './types';
-type CancellableQueryCache = QueryCache & {
-    cancelAll(): void;
-};
-/** 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;
-export {};
-//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -1 +0,0 @@
-{"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,CAmQxB"}

package/dist/query.js

@@ -1,2 +0,0 @@
-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(),e.controller=void 0,e.promise=void 0},_=()=>{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.promise===c?(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,e=>{if(n.promise!==c)throw 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:_,delete(e){let n=t(e),r=c.get(n);r&&(r.promise=void 0,r.controller?.abort(),r.controller=void 0,c.delete(n),p(e),m())},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 +0,0 @@
-{"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()) {\n      entry.controller?.abort();\n      entry.controller = undefined;\n      entry.promise = undefined;\n    }\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          if (entry.promise !== promise) return data;\n\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          if (entry.promise !== promise) throw cause;\n\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    delete(key: QueryKey): void {\n      const id = hash(key);\n      const entry = entries.get(id);\n\n      if (!entry) return;\n\n      // Prevent an aborted in-flight promise from writing a stale error snapshot\n      // after this entry has been explicitly removed.\n      entry.promise = undefined;\n      entry.controller?.abort();\n      entry.controller = undefined;\n\n      entries.delete(id);\n      notify(key);\n      scheduleGc();\n    },\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,EACjC,EAAM,YAAY,MAAM,EACxB,EAAM,WAAa,IAAA,GACnB,EAAM,QAAU,IAAA,EAEpB,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,GACK,EAAM,UAAY,GAEtB,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,GAR+B,EAUvC,GAAmB,CAClB,GAAI,EAAM,UAAY,EAAS,MAAM,EAErC,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,OAAO,EAAqB,CAC1B,IAAM,EAAK,EAAK,CAAG,EACb,EAAQ,EAAQ,IAAI,CAAE,EAEvB,IAIL,EAAM,QAAU,IAAA,GAChB,EAAM,YAAY,MAAM,EACxB,EAAM,WAAa,IAAA,GAEnB,EAAQ,OAAO,CAAE,EACjB,EAAO,CAAG,EACV,EAAW,EACb,EACA,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 +0,0 @@
-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 +0,0 @@
-{"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.js

@@ -1,2 +0,0 @@
-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 +0,0 @@
-{"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 +0,0 @@
-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 +0,0 @@
-{"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.js

@@ -1,2 +0,0 @@
-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 +0,0 @@
-{"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

@@ -1,6 +0,0 @@
-const e=require("./errors.cjs"),t=require("./serialize.cjs"),n=require("./transport.cjs"),r=require("./url.cjs");function i(e){let t=new AbortController,n=e(t.signal);return{next:e=>n.next(e),return:e=>(t.abort(),n.return(e)),[Symbol.asyncIterator](){return this},throw:e=>(t.abort(),n.throw(e))}}async function a(i,a,o){if(i.disposed)throw new e.CourierDisposedError(`Courier`);let s=new AbortController,c=i.track(s),l=(o.method??(o.body===void 0?`GET`:`POST`)).toUpperCase(),u=n.buildTimeoutSignal(o.timeout??1/0,n.anySignal(o.signal,s.signal)),d=a;try{d=r.buildUrl(i.baseUrl,a,o.params,o.query);let n=i.mergeHeaders(o.headers),{headers:f,...p}=t.buildRequestInit(l,n,o.body,u,o.fetchInit??{}),m=await i.dispatch({headers:f,init:p,url:d});if(!m.ok)throw e.CourierHttpError.fromResponse(m,await m.text().catch(()=>``),l,d);if(!m.body)throw new e.CourierParseError(`Response has no body`);return{controller:s,response:m,untrack:c}}catch(t){throw c(),t instanceof e.CourierHttpError||t instanceof e.CourierParseError?t:e.classifyRequestError(t,l,d,u)}}function o(t){async function*r(e,n){let{controller:r,response:i,untrack:o}=await a(t,e,n),s=i.body.getReader(),c=new TextDecoder,l=``,u=`message`,d=``;try{for(;;){let e=await s.read();if(e.done)break;l+=c.decode(e.value,{stream:!0}).replace(/\r\n?/g,`
-`);let t;for(;(t=l.indexOf(`
-`))!==-1;){let e=l.slice(0,t);if(l=l.slice(t+1),e===``){if(d!==``){let e=d.endsWith(`
-`)?d.slice(0,-1):d;try{e=JSON.parse(e)}catch{}yield{data:e,event:u}}d=``,u=`message`;continue}if(e.startsWith(`:`))continue;let n=e.indexOf(`:`),r=n===-1?e:e.slice(0,n),i=(n===-1?``:e.slice(n+1)).replace(/^ /,``);r===`data`?d+=`${i}\n`:r===`event`&&(u=i)}}}finally{s.releaseLock(),r.abort(),o()}}async function*o(n,r){let{controller:i,response:o,untrack:s}=await a(t,n,r),c=o.body.getReader(),l=new TextDecoder,u=``;try{for(;;){let t=await c.read();if(t.done){if(r.parse===`ndjson`&&u.trim())try{yield JSON.parse(u)}catch{throw new e.CourierParseError(`NDJSON: failed to parse line: ${u.slice(0,200)}`)}break}let n=l.decode(t.value,{stream:!0});if(r.parse!==`ndjson`){yield n;continue}u+=n;let i;for(;(i=u.indexOf(`
-`))!==-1;){let t=u.slice(0,i).trim();if(u=u.slice(i+1),t)try{yield JSON.parse(t)}catch{throw new e.CourierParseError(`NDJSON: failed to parse line: ${t.slice(0,200)}`)}}}}finally{c.releaseLock(),i.abort(),s()}}return{events(e,t={}){return i(i=>r(e,{...t,headers:{accept:`text/event-stream`,"cache-control":`no-cache`,...t.headers},signal:n.anySignal(t.signal,i)}))},read(e,t={}){return i(r=>o(e,{...t,signal:n.anySignal(t.signal,r)}))}}}exports.createStreams=o;
-//# sourceMappingURL=stream.cjs.map

package/dist/stream.cjs.map

@@ -1 +0,0 @@
-{"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 } from './url';\nimport { buildUrl } from './url';\n\nexport type StreamOptions<P extends string = string> = Omit<HttpRequestConfig<P>, 'responseType' | 'schema'> & {\n  method?: string;\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<P extends string>(\n  transport: TransportCore,\n  url: string,\n  config: StreamOptions<P>,\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);\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> = {} 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,17 +0,0 @@
-import { type TransportCore } from './transport';
-import type { HttpRequestConfig } from './url';
-export type StreamOptions<P extends string = string> = Omit<HttpRequestConfig<P>, 'responseType' | 'schema'> & {
-    method?: string;
-};
-export type StreamEvent<T = unknown> = {
-    readonly data: T;
-    readonly event: string;
-};
-/** Platform-shaped streaming primitives: async iteration owns cancellation and backpressure. */
-export declare function createStreams(transport: TransportCore): {
-    events<T = unknown, P extends string = string>(url: P, config?: StreamOptions<P>): AsyncIterableIterator<StreamEvent<T>>;
-    read<T = string, P extends string = string>(url: P, config?: StreamOptions<P> & {
-        parse?: "ndjson" | "text";
-    }): AsyncIterableIterator<T>;
-};
-//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -1 +0,0 @@
-{"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,EAAE,MAAM,OAAO,CAAC;AAG/C,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;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,GAGvD,qBAAqB,CAAC,CAAC,CAAC;EAI9B"}

package/dist/stream.js

@@ -1,6 +0,0 @@
-import{CourierDisposedError as e,CourierHttpError as t,CourierParseError as n,classifyRequestError as r}from"./errors.js";import{buildRequestInit as i}from"./serialize.js";import{anySignal as a,buildTimeoutSignal as o}from"./transport.js";import{buildUrl as s}from"./url.js";function c(e){let t=new AbortController,n=e(t.signal);return{next:e=>n.next(e),return:e=>(t.abort(),n.return(e)),[Symbol.asyncIterator](){return this},throw:e=>(t.abort(),n.throw(e))}}async function l(c,l,u){if(c.disposed)throw new e(`Courier`);let d=new AbortController,f=c.track(d),p=(u.method??(u.body===void 0?`GET`:`POST`)).toUpperCase(),m=o(u.timeout??1/0,a(u.signal,d.signal)),h=l;try{h=s(c.baseUrl,l,u.params,u.query);let e=c.mergeHeaders(u.headers),{headers:r,...a}=i(p,e,u.body,m,u.fetchInit??{}),o=await c.dispatch({headers:r,init:a,url:h});if(!o.ok)throw t.fromResponse(o,await o.text().catch(()=>``),p,h);if(!o.body)throw new n(`Response has no body`);return{controller:d,response:o,untrack:f}}catch(e){throw f(),e instanceof t||e instanceof n?e:r(e,p,h,m)}}function u(e){async function*t(t,n){let{controller:r,response:i,untrack:a}=await l(e,t,n),o=i.body.getReader(),s=new TextDecoder,c=``,u=`message`,d=``;try{for(;;){let e=await o.read();if(e.done)break;c+=s.decode(e.value,{stream:!0}).replace(/\r\n?/g,`
-`);let t;for(;(t=c.indexOf(`
-`))!==-1;){let e=c.slice(0,t);if(c=c.slice(t+1),e===``){if(d!==``){let e=d.endsWith(`
-`)?d.slice(0,-1):d;try{e=JSON.parse(e)}catch{}yield{data:e,event:u}}d=``,u=`message`;continue}if(e.startsWith(`:`))continue;let n=e.indexOf(`:`),r=n===-1?e:e.slice(0,n),i=(n===-1?``:e.slice(n+1)).replace(/^ /,``);r===`data`?d+=`${i}\n`:r===`event`&&(u=i)}}}finally{o.releaseLock(),r.abort(),a()}}async function*r(t,r){let{controller:i,response:a,untrack:o}=await l(e,t,r),s=a.body.getReader(),c=new TextDecoder,u=``;try{for(;;){let e=await s.read();if(e.done){if(r.parse===`ndjson`&&u.trim())try{yield JSON.parse(u)}catch{throw new n(`NDJSON: failed to parse line: ${u.slice(0,200)}`)}break}let t=c.decode(e.value,{stream:!0});if(r.parse!==`ndjson`){yield t;continue}u+=t;let i;for(;(i=u.indexOf(`
-`))!==-1;){let e=u.slice(0,i).trim();if(u=u.slice(i+1),e)try{yield JSON.parse(e)}catch{throw new n(`NDJSON: failed to parse line: ${e.slice(0,200)}`)}}}}finally{s.releaseLock(),i.abort(),o()}}return{events(e,n={}){return c(r=>t(e,{...n,headers:{accept:`text/event-stream`,"cache-control":`no-cache`,...n.headers},signal:a(n.signal,r)}))},read(e,t={}){return c(n=>r(e,{...t,signal:a(t.signal,n)}))}}}export{u as createStreams};
-//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -1 +0,0 @@
-{"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 } from './url';\nimport { buildUrl } from './url';\n\nexport type StreamOptions<P extends string = string> = Omit<HttpRequestConfig<P>, 'responseType' | 'schema'> & {\n  method?: string;\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<P extends string>(\n  transport: TransportCore,\n  url: string,\n  config: StreamOptions<P>,\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);\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> = {} 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 +0,0 @@
-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 +0,0 @@
-{"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.js

@@ -1,2 +0,0 @@
-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 +0,0 @@
-{"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,62 +0,0 @@
-export type QueryKeyAtom = string | number | boolean | null;
-export type QueryKey = readonly [QueryKeyAtom, ...QueryKeyAtom[]];
-export type Unsubscribe = () => void;
-export type AsyncState<T> = {
-    readonly data: undefined;
-    readonly error: null;
-    readonly isFetching: boolean;
-    readonly status: 'loading';
-    readonly updatedAt: undefined;
-} | {
-    readonly data: T;
-    readonly error: null;
-    readonly isFetching: boolean;
-    readonly status: 'success';
-    readonly updatedAt: number;
-} | {
-    readonly data: T | undefined;
-    readonly error: Error;
-    readonly isFetching: false;
-    readonly status: 'error';
-    readonly updatedAt: number;
-};
-export type QueryContext = {
-    readonly key: QueryKey;
-    readonly signal: AbortSignal;
-};
-export type QueryDefinition<T> = {
-    fetch: (context: QueryContext) => Promise<T>;
-    key: QueryKey;
-    staleTime?: number;
-};
-export type QueryCache = {
-    clear(): void;
-    delete(key: QueryKey): void;
-    fetch<T>(definition: QueryDefinition<T>, options?: {
-        force?: boolean;
-    }): Promise<T>;
-    get<T>(key: QueryKey): T | undefined;
-    getSnapshot<T>(key: QueryKey): AsyncState<T> | null;
-    /** 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[];
-    set<T>(key: QueryKey, data: T, options?: {
-        updatedAt?: number;
-    }): void;
-    subscribe(key: QueryKey, listener: () => void): Unsubscribe;
-};
-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;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/url.cjs

@@ -1,2 +0,0 @@
-const e=require("./errors.cjs");function t(t,n,r,i){let a=t.replace(/\/+$/,``),o=n.replace(/^\/+/,``);o=o.replace(/\{([^}]+)\}/g,(t,i)=>{let a=r?.[i];if(a==null)throw new e.CourierParseError(`unresolved path param {${i}} in '${n}'`);return encodeURIComponent(String(a))});let s=a&&o?`${a}/${o}`:a||o;if(!i)return s;let c=new URLSearchParams;for(let[e,t]of Object.entries(i))if(t!==void 0){if(Array.isArray(t)){for(let n of t)n!==void 0&&c.append(e,n===null?``:String(n));continue}c.append(e,t===null?``:String(t))}let l=c.toString();return l?`${s}${s.includes(`?`)?`&`:`?`}${l}`:s}exports.buildUrl=t;
-//# sourceMappingURL=url.cjs.map

package/dist/url.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"url.cjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["import { CourierParseError } from './errors';\nimport type { ResponseType } from './response';\n\ntype QueryScalar = string | number | boolean | null;\n\nexport type ParamValue = QueryScalar | readonly QueryScalar[] | undefined;\nexport type Params = Record<string, ParamValue>;\n\n// Type-safe path params: extracts {param} placeholders from a path string\ntype ExtractPathParams<P extends string> = P extends `${string}{${infer K}}${infer R}`\n  ? K | ExtractPathParams<R>\n  : never;\n\nexport type PathConfig<P extends string> = [ExtractPathParams<P>] extends [never]\n  ? { params?: never }\n  : { params: Record<ExtractPathParams<P>, string | number | boolean> };\n\nexport type CourierRequestConfig<P extends string = string, T = unknown> = PathConfig<P> & {\n  /** Request body. Plain objects → JSON. BodyInit values passed as-is. */\n  body?: unknown;\n  /** Query string parameters. */\n  query?: Params;\n  /** Response parsing strategy. */\n  responseType?: ResponseType;\n  /**\n   * Optional schema for response validation. Any object with a `parse(data)` method\n   * works — e.g. a `@vielzeug/spell` schema or a plain validator function wrapper.\n   * Called after the response body is parsed; throws if validation fails.\n   * The schema's return type must be assignable to `T`.\n   */\n  schema?: { parse(data: unknown): T };\n  /** Request timeout in ms. Overrides client default. */\n  timeout?: number;\n};\n\nexport type HttpRequestConfig<P extends string = string, T = unknown> = CourierRequestConfig<P, T> & {\n  /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  /** Per-request headers merged with (and overriding) global client headers. */\n  headers?: Record<string, string>;\n  /** External abort signal merged with internal cancellation. */\n  signal?: AbortSignal;\n};\n\nexport function buildUrl(base: string, path: string, params?: Params, query?: Params): string {\n  const baseClean = base.replace(/\\/+$/, '');\n  let pathClean = path.replace(/^\\/+/, '');\n\n  pathClean = pathClean.replace(/\\{([^}]+)\\}/g, (_, key: string) => {\n    const val = params?.[key];\n\n    if (val === undefined || val === null) throw new CourierParseError(`unresolved path param {${key}} in '${path}'`);\n\n    return encodeURIComponent(String(val));\n  });\n\n  const url = baseClean && pathClean ? `${baseClean}/${pathClean}` : baseClean || pathClean;\n\n  if (!query) return url;\n\n  const qs = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      for (const entry of value) {\n        if (entry !== undefined) {\n          qs.append(key, entry === null ? '' : String(entry));\n        }\n      }\n\n      continue;\n    }\n\n    qs.append(key, value === null ? '' : String(value));\n  }\n\n  const queryString = qs.toString();\n\n  return queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n}\n"],"mappings":"gCA4CA,SAAgB,EAAS,EAAc,EAAc,EAAiB,EAAwB,CAC5F,IAAM,EAAY,EAAK,QAAQ,OAAQ,EAAE,EACrC,EAAY,EAAK,QAAQ,OAAQ,EAAE,EAEvC,EAAY,EAAU,QAAQ,gBAAiB,EAAG,IAAgB,CAChE,IAAM,EAAM,IAAS,GAErB,GAAI,GAA6B,KAAM,MAAM,IAAI,EAAA,kBAAkB,0BAA0B,EAAI,QAAQ,EAAK,EAAE,EAEhH,OAAO,mBAAmB,OAAO,CAAG,CAAC,CACvC,CAAC,EAED,IAAM,EAAM,GAAa,EAAY,GAAG,EAAU,GAAG,IAAc,GAAa,EAEhF,GAAI,CAAC,EAAO,OAAO,EAEnB,IAAM,EAAK,IAAI,gBAEf,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAK,EACzC,OAAU,IAAA,GAId,IAAI,MAAM,QAAQ,CAAK,EAAG,CACxB,IAAK,IAAM,KAAS,EACd,IAAU,IAAA,IACZ,EAAG,OAAO,EAAK,IAAU,KAAO,GAAK,OAAO,CAAK,CAAC,EAItD,QACF,CAEA,EAAG,OAAO,EAAK,IAAU,KAAO,GAAK,OAAO,CAAK,CAAC,CAFlD,CAKF,IAAM,EAAc,EAAG,SAAS,EAEhC,OAAO,EAAc,GAAG,IAAM,EAAI,SAAS,GAAG,EAAI,IAAM,MAAM,IAAgB,CAChF"}

package/dist/url.js

@@ -1,2 +0,0 @@
-import{CourierParseError as e}from"./errors.js";function t(t,n,r,i){let a=t.replace(/\/+$/,``),o=n.replace(/^\/+/,``);o=o.replace(/\{([^}]+)\}/g,(t,i)=>{let a=r?.[i];if(a==null)throw new e(`unresolved path param {${i}} in '${n}'`);return encodeURIComponent(String(a))});let s=a&&o?`${a}/${o}`:a||o;if(!i)return s;let c=new URLSearchParams;for(let[e,t]of Object.entries(i))if(t!==void 0){if(Array.isArray(t)){for(let n of t)n!==void 0&&c.append(e,n===null?``:String(n));continue}c.append(e,t===null?``:String(t))}let l=c.toString();return l?`${s}${s.includes(`?`)?`&`:`?`}${l}`:s}export{t as buildUrl};
-//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"url.js","names":[],"sources":["../src/url.ts"],"sourcesContent":["import { CourierParseError } from './errors';\nimport type { ResponseType } from './response';\n\ntype QueryScalar = string | number | boolean | null;\n\nexport type ParamValue = QueryScalar | readonly QueryScalar[] | undefined;\nexport type Params = Record<string, ParamValue>;\n\n// Type-safe path params: extracts {param} placeholders from a path string\ntype ExtractPathParams<P extends string> = P extends `${string}{${infer K}}${infer R}`\n  ? K | ExtractPathParams<R>\n  : never;\n\nexport type PathConfig<P extends string> = [ExtractPathParams<P>] extends [never]\n  ? { params?: never }\n  : { params: Record<ExtractPathParams<P>, string | number | boolean> };\n\nexport type CourierRequestConfig<P extends string = string, T = unknown> = PathConfig<P> & {\n  /** Request body. Plain objects → JSON. BodyInit values passed as-is. */\n  body?: unknown;\n  /** Query string parameters. */\n  query?: Params;\n  /** Response parsing strategy. */\n  responseType?: ResponseType;\n  /**\n   * Optional schema for response validation. Any object with a `parse(data)` method\n   * works — e.g. a `@vielzeug/spell` schema or a plain validator function wrapper.\n   * Called after the response body is parsed; throws if validation fails.\n   * The schema's return type must be assignable to `T`.\n   */\n  schema?: { parse(data: unknown): T };\n  /** Request timeout in ms. Overrides client default. */\n  timeout?: number;\n};\n\nexport type HttpRequestConfig<P extends string = string, T = unknown> = CourierRequestConfig<P, T> & {\n  /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  /** Per-request headers merged with (and overriding) global client headers. */\n  headers?: Record<string, string>;\n  /** External abort signal merged with internal cancellation. */\n  signal?: AbortSignal;\n};\n\nexport function buildUrl(base: string, path: string, params?: Params, query?: Params): string {\n  const baseClean = base.replace(/\\/+$/, '');\n  let pathClean = path.replace(/^\\/+/, '');\n\n  pathClean = pathClean.replace(/\\{([^}]+)\\}/g, (_, key: string) => {\n    const val = params?.[key];\n\n    if (val === undefined || val === null) throw new CourierParseError(`unresolved path param {${key}} in '${path}'`);\n\n    return encodeURIComponent(String(val));\n  });\n\n  const url = baseClean && pathClean ? `${baseClean}/${pathClean}` : baseClean || pathClean;\n\n  if (!query) return url;\n\n  const qs = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      for (const entry of value) {\n        if (entry !== undefined) {\n          qs.append(key, entry === null ? '' : String(entry));\n        }\n      }\n\n      continue;\n    }\n\n    qs.append(key, value === null ? '' : String(value));\n  }\n\n  const queryString = qs.toString();\n\n  return queryString ? `${url}${url.includes('?') ? '&' : '?'}${queryString}` : url;\n}\n"],"mappings":"gDA4CA,SAAgB,EAAS,EAAc,EAAc,EAAiB,EAAwB,CAC5F,IAAM,EAAY,EAAK,QAAQ,OAAQ,EAAE,EACrC,EAAY,EAAK,QAAQ,OAAQ,EAAE,EAEvC,EAAY,EAAU,QAAQ,gBAAiB,EAAG,IAAgB,CAChE,IAAM,EAAM,IAAS,GAErB,GAAI,GAA6B,KAAM,MAAM,IAAI,EAAkB,0BAA0B,EAAI,QAAQ,EAAK,EAAE,EAEhH,OAAO,mBAAmB,OAAO,CAAG,CAAC,CACvC,CAAC,EAED,IAAM,EAAM,GAAa,EAAY,GAAG,EAAU,GAAG,IAAc,GAAa,EAEhF,GAAI,CAAC,EAAO,OAAO,EAEnB,IAAM,EAAK,IAAI,gBAEf,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAK,EACzC,OAAU,IAAA,GAId,IAAI,MAAM,QAAQ,CAAK,EAAG,CACxB,IAAK,IAAM,KAAS,EACd,IAAU,IAAA,IACZ,EAAG,OAAO,EAAK,IAAU,KAAO,GAAK,OAAO,CAAK,CAAC,EAItD,QACF,CAEA,EAAG,OAAO,EAAK,IAAU,KAAO,GAAK,OAAO,CAAK,CAAC,CAFlD,CAKF,IAAM,EAAc,EAAG,SAAS,EAEhC,OAAO,EAAc,GAAG,IAAM,EAAI,SAAS,GAAG,EAAI,IAAM,MAAM,IAAgB,CAChF"}