@vielzeug/courier 1.1.2 → 1.1.4

package/dist/stream-shared.d.ts

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

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

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

package/dist/stream-shared.js

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

package/dist/stream-shared.js.map

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

package/dist/stream-sse.cjs

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

package/dist/stream-sse.cjs.map

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

package/dist/stream-sse.d.ts

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

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

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

package/dist/stream-sse.js

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

package/dist/stream-sse.js.map

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

package/dist/stream.cjs

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

package/dist/stream.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"stream.cjs","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import { sleep } from '@vielzeug/arsenal';\n\nimport type { Params } from './url';\n\nimport { classifyRequestError, CourierDisposedError, CourierHttpError, CourierParseError } from './errors';\nimport { fullJitterDelay } from './retry';\nimport { buildRequestInit } from './serialize';\nimport {\n  anySignal,\n  buildTimeoutSignal,\n  createTransportCore,\n  type TransportCore,\n  type TransportOptions,\n  validateTimeout,\n} from './transport';\nimport { buildUrl } from './url';\n\nexport type StreamRequestConfig<P extends string = string> = {\n  body?: unknown;\n  /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  headers?: Record<string, string>;\n  method?: string;\n  params?: P extends string ? Record<string, string | number | boolean> : never;\n  query?: Params;\n  /** External abort signal. Merged with internal cancellation. */\n  signal?: AbortSignal;\n  /** Request timeout in ms. Overrides client default (which is `Infinity` for streaming). */\n  timeout?: number;\n};\n\nexport type ReconnectOptions = {\n  /**\n   * Delay between reconnect attempts in ms, or a zero-based function where\n   * `attempt` is the number of failures so far (0 = waiting before the 2nd try).\n   * Defaults to full-jitter exponential backoff: `[0, min(1s × 2ⁿ, 30s)]`.\n   */\n  delay?: number | ((attempt: number) => number);\n  /** Total reconnect attempts after the first failure. Defaults to `5`. */\n  times?: number;\n};\n\nexport type ReadableConfig<P extends string = string> = StreamRequestConfig<P> & {\n  /**\n   * Called when the reconnect budget is exhausted or a non-retriable error\n   * occurs. Not called when the generator is aborted via signal or dispose.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Response body parsing mode.\n   * - `'text'` (default) — yields raw decoded string chunks as they arrive.\n   * - `'ndjson'` — splits by newline and JSON-parses each complete line; use `T` to type the values.\n   */\n  parse?: 'ndjson' | 'text';\n  /**\n   * Auto-reconnect on connection loss. Uses the same backoff semantics as\n   * `sse()` reconnect. `true` uses defaults (5 attempts). Defaults to `false`.\n   */\n  reconnect?: boolean | ReconnectOptions;\n};\n\nexport type SseOptions<P extends string = string> = StreamRequestConfig<P> & {\n  /**\n   * Called when the connection is permanently lost (reconnect budget exhausted due to error).\n   * Not called on `dispose()`.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Auto-reconnect on connection loss with exponential backoff.\n   * `true` uses defaults (5 attempts). Defaults to `false`.\n   */\n  reconnect?: boolean | ReconnectOptions;\n};\n\n/** Connection lifecycle status for an SSE source. */\nexport type SseStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';\n\n/**\n * Typed SSE event source. `TEvents` maps event name → data type.\n * Non-string data values are automatically JSON-parsed from the raw `data:` field.\n * If parsing fails the raw string is delivered instead.\n */\nexport type SseSource<TEvents extends Record<string, unknown> = Record<string, string>> = {\n  [Symbol.dispose](): void;\n  /** `true` after `dispose()` is called or the reconnect budget is exhausted. */\n  readonly closed: boolean;\n  /** Permanently closes the SSE connection. No further events will be dispatched. */\n  dispose(): void;\n  /**\n   * Registers a handler for a named SSE event. Returns an unsubscribe function.\n   * The special name `'message'` matches events without an explicit `event:` field.\n   * Calling `on()` after `dispose()` returns a no-op unsubscribe.\n   */\n  on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void;\n  /** Current connection lifecycle status. Useful for displaying a live-connection indicator. */\n  readonly status: SseStatus;\n};\n\n/** Parse a raw SSE data string: try JSON, fall back to raw string. */\nfunction parseEventData(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return raw;\n  }\n}\n\n/**\n * Shared stream setup: build URL, combine signals, merge headers, dispatch through\n * transport. Returns the Response so both sse() and readable() can focus on parsing.\n * The caller owns the AbortController lifecycle (track + untrack).\n */\nasync function openStreamWith(\n  transport: TransportCore,\n  url: string,\n  ac: AbortController,\n  config: {\n    body?: unknown;\n    extSignal?: AbortSignal;\n    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n    headers?: Record<string, string>;\n    method: string;\n    params?: Params;\n    query?: Params;\n    timeout?: number;\n  },\n  extraHeaders?: Record<string, string>,\n): Promise<Response> {\n  // Normalize once — error paths and RequestInit both receive the canonical form.\n  const method = config.method.toUpperCase();\n  const full = buildUrl(transport.baseUrl, url, config.params, config.query);\n  const combined = anySignal(config.extSignal, ac.signal) ?? ac.signal;\n  // Streaming connections are long-lived — default to Infinity so the transport's\n  // REST default (30s) does not cut off streams prematurely.\n  const signal = buildTimeoutSignal(config.timeout ?? Number.POSITIVE_INFINITY, combined);\n  const requestHeaders = transport.mergeHeaders(config.headers, extraHeaders);\n  const { headers: initHeaders, ...restInit } = buildRequestInit(\n    method,\n    requestHeaders,\n    config.body,\n    signal,\n    config.fetchInit ?? {},\n  );\n\n  let res: Response;\n\n  try {\n    res = await transport.dispatch({ headers: initHeaders as Record<string, string>, init: restInit, url: full });\n  } catch (err) {\n    throw classifyRequestError(err, method, full, signal ?? combined);\n  }\n\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n\n    throw CourierHttpError.fromResponse(res, text, method, full);\n  }\n\n  if (!res.body) throw new CourierParseError('Response has no body');\n\n  return res;\n}\n\n/**\n * Creates a streaming client exposing `sse()` (Server-Sent Events) and `readable()`\n * (`ReadableStream`/NDJSON). Both share the same interceptor pipeline, header management,\n * and `AbortController` lifecycle as `createApi`.\n *\n * @example\n * ```ts\n * const stream = createStream({ baseUrl: 'https://api.example.com' });\n *\n * const src = stream.sse<{ message: { text: string } }>('/events', { reconnect: true });\n * src.on('message', (data) => console.log(data.text));\n *\n * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n *   process.stdout.write(chunk);\n * }\n *\n * // later:\n * stream.dispose();\n * ```\n */\nexport function createStream(opts?: TransportOptions & { transport?: TransportCore }) {\n  const { transport: sharedTransport, ...transportOpts } = opts ?? {};\n  const ownTransport = !sharedTransport;\n  const transport = sharedTransport ?? createTransportCore(transportOpts);\n\n  /**\n   * Opens a Server-Sent Events connection and returns a typed source.\n   *\n   * - Intercepts request through the same pipeline as `createApi` (auth, logging, etc.)\n   * - Auto-reconnects with exponential backoff when `reconnect` is set\n   * - Sends `Last-Event-ID` header on reconnect to resume from last received event\n   * - Non-string event data is automatically JSON-parsed\n   *\n   * @example\n   * ```ts\n   * const src = stream.sse<{ message: { text: string }; ping: null }>('/events', {\n   *   reconnect: true,\n   *   onError: (err) => console.error(err),\n   * });\n   *\n   * src.on('message', (data) => console.log(data.text));\n   * src.on('ping', () => {});\n   * // later:\n   * src.dispose();\n   * ```\n   */\n  function sse<TEvents extends Record<string, unknown> = Record<string, string>, P extends string = string>(\n    url: P,\n    config: SseOptions<P> = {} as SseOptions<P>,\n  ): SseSource<TEvents> {\n    if (transport.disposed) throw new CourierDisposedError('StreamClient');\n\n    const {\n      body,\n      fetchInit,\n      headers: perRequestHeaders,\n      method = body !== undefined ? 'POST' : 'GET',\n      onError,\n      params,\n      query,\n      reconnect = false,\n      signal: extSignal,\n      timeout: cfgTimeout,\n    } = config as SseOptions;\n\n    if (cfgTimeout !== undefined) validateTimeout(cfgTimeout);\n\n    const listeners = new Map<string, Set<(data: unknown) => void>>();\n    const ac = new AbortController();\n    // Track `ac` once for the entire SSE lifetime — covers active connections AND\n    // reconnect sleep windows, so cancelAll()/dispose() always reach it.\n    const untrack = transport.track(ac);\n    let closed = false;\n    let sseStatus: SseStatus = 'connecting';\n    let lastEventId = '';\n\n    const reconnectOpts: ReconnectOptions = reconnect === true ? {} : reconnect === false ? { times: 0 } : reconnect;\n    const maxReconnects = reconnectOpts.times ?? (reconnect ? 5 : 0);\n    // `activeReconnectDelay` is mutable so the server's `retry:` field can update\n    // the reconnection interval without the caller needing to handle it manually.\n    let activeReconnectDelay: number | ((attempt: number) => number) = reconnectOpts.delay ?? fullJitterDelay;\n\n    function dispatchEvent(event: string, rawData: string): void {\n      const handlers = listeners.get(event);\n\n      if (!handlers?.size) return;\n\n      const data = parseEventData(rawData);\n\n      for (const handler of handlers) handler(data);\n    }\n\n    async function connect(): Promise<void> {\n      const res = await openStreamWith(\n        transport,\n        url,\n        ac,\n        {\n          body,\n          extSignal,\n          fetchInit,\n          headers: perRequestHeaders as Record<string, string> | undefined,\n          method,\n          params: params as Params | undefined,\n          query,\n          timeout: cfgTimeout,\n        },\n        {\n          accept: 'text/event-stream',\n          'cache-control': 'no-cache',\n          ...(lastEventId ? { 'last-event-id': lastEventId } : {}),\n        },\n      );\n\n      const reader = res.body!.getReader();\n      const decoder = new TextDecoder();\n      let buffer = '';\n      let currentEvent = 'message';\n      let currentData = '';\n      let currentId = '';\n\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n\n          if (done) break;\n\n          // Normalise \\r\\n and \\r to \\n before processing\n          buffer += decoder.decode(value, { stream: true }).replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n\n          let nlIdx: number;\n\n          while ((nlIdx = buffer.indexOf('\\n')) !== -1) {\n            const line = buffer.slice(0, nlIdx);\n\n            buffer = buffer.slice(nlIdx + 1);\n\n            if (line === '') {\n              // Empty line → dispatch event\n              if (currentData !== '') {\n                if (currentId) lastEventId = currentId;\n\n                dispatchEvent(currentEvent, currentData.replace(/\\n$/, ''));\n              }\n\n              currentEvent = 'message';\n              currentData = '';\n              currentId = '';\n            } else if (line.startsWith(':')) {\n              // Comment — ignore\n            } else {\n              const colonIdx = line.indexOf(':');\n              const field = colonIdx === -1 ? line : line.slice(0, colonIdx);\n              const value = colonIdx === -1 ? '' : line.slice(colonIdx + 1).replace(/^ /, '');\n\n              if (field === 'event') currentEvent = value;\n              else if (field === 'data') currentData += (currentData ? '\\n' : '') + value;\n              else if (field === 'id' && !value.includes('\\0')) currentId = value;\n              else if (field === 'retry') {\n                // Honor the server's advised reconnect interval (SSE spec §9.2.6).\n                const ms = parseInt(value, 10);\n\n                if (!Number.isNaN(ms)) activeReconnectDelay = ms;\n              }\n            }\n          }\n        }\n      } finally {\n        reader.releaseLock();\n      }\n    }\n\n    async function run(): Promise<void> {\n      let attempt = 0;\n\n      try {\n        while (!closed && !transport.disposed && !ac.signal.aborted) {\n          let connectError: Error | undefined;\n\n          sseStatus = 'connecting';\n\n          try {\n            sseStatus = 'open';\n            await connect();\n            // Clean server-side close — falls through to reconnect logic below.\n            // The attempt counter is intentionally NOT reset here: `times`\n            // bounds total reconnects regardless of whether the close was clean or an\n            // error, preventing infinite reconnection against servers that always close\n            // after a response window (e.g. SSE keepalive patterns).\n          } catch (err) {\n            if (closed || transport.disposed || ac.signal.aborted) break;\n\n            connectError = err instanceof Error ? err : new Error(String(err));\n          }\n\n          if (closed || transport.disposed || ac.signal.aborted) break;\n\n          // No reconnect budget → fire onError for errors, stop either way\n          if (maxReconnects === 0) {\n            if (connectError) onError?.(connectError);\n\n            break;\n          }\n\n          // Budget exhausted → always signal via onError so the caller knows\n          // the reconnect cycle has ended (whether the close was clean or not).\n          if (attempt >= maxReconnects) {\n            onError?.(connectError ?? new Error('[courier] SSE reconnect budget exhausted'));\n\n            break;\n          }\n\n          // Budget available → sleep and retry\n          sseStatus = 'reconnecting';\n\n          const delay =\n            typeof activeReconnectDelay === 'function' ? activeReconnectDelay(attempt) : activeReconnectDelay;\n\n          attempt++;\n          await sleep(delay, ac.signal).catch(() => {});\n        }\n      } finally {\n        sseStatus = 'closed';\n        untrack();\n      }\n    }\n\n    // Surface unexpected programming errors (not network failures) via onError\n    run().catch((err) => {\n      if (!closed && !transport.disposed) {\n        onError?.(err instanceof Error ? err : new Error(String(err)));\n      }\n    });\n\n    return {\n      get closed(): boolean {\n        return closed;\n      },\n\n      dispose(): void {\n        closed = true;\n        ac.abort();\n        listeners.clear();\n      },\n\n      on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void {\n        // After dispose(), return a no-op to avoid silent dead-listener bugs\n        if (closed) return () => {};\n\n        let set = listeners.get(event);\n\n        if (!set) {\n          set = new Set<(data: unknown) => void>();\n          listeners.set(event, set);\n        }\n\n        set.add(handler as (data: unknown) => void);\n\n        return () => set.delete(handler as (data: unknown) => void);\n      },\n\n      get status(): SseStatus {\n        return sseStatus;\n      },\n\n      [Symbol.dispose](): void {\n        this.dispose();\n      },\n    };\n  }\n\n  /**\n   * Opens an HTTP streaming connection and returns an async generator yielding\n   * response body chunks as they arrive.\n   *\n   * - `parse: 'text'` (default) — yields raw decoded string chunks\n   * - `parse: 'ndjson'` — splits by newline and JSON-parses each line; use `T` to\n   *   type the parsed values\n   *\n   * @example\n   * ```ts\n   * // Raw text stream\n   * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n   *   process.stdout.write(chunk);\n   * }\n   *\n   * // NDJSON (e.g. AI token stream, log stream)\n   * for await (const msg of stream.readable<ChatMessage>('/chat', {\n   *   body: { prompt },\n   *   parse: 'ndjson',\n   * })) {\n   *   console.log(msg.content);\n   * }\n   * ```\n   */\n  async function* readable<T = string, P extends string = string>(\n    url: P,\n    config: ReadableConfig<P> = {} as ReadableConfig<P>,\n  ): AsyncGenerator<T> {\n    if (transport.disposed) throw new CourierDisposedError('StreamClient');\n\n    const {\n      body,\n      fetchInit,\n      headers: perRequestHeaders,\n      method = body !== undefined ? 'POST' : 'GET',\n      onError,\n      params,\n      parse = 'text',\n      query,\n      reconnect = false,\n      signal: extSignal,\n      timeout: cfgTimeout,\n    } = config as ReadableConfig;\n\n    if (cfgTimeout !== undefined) validateTimeout(cfgTimeout);\n\n    const reconnectOpts: ReconnectOptions = reconnect === true ? {} : reconnect === false ? { times: 0 } : reconnect;\n    const maxReconnects = reconnectOpts.times ?? (reconnect ? 5 : 0);\n    const reconnectDelay: number | ((attempt: number) => number) = reconnectOpts.delay ?? fullJitterDelay;\n\n    const ac = new AbortController();\n    const untrack = transport.track(ac);\n    let attempt = 0;\n    let overallNaturalEnd = false;\n\n    try {\n      while (!transport.disposed && !ac.signal.aborted) {\n        let connectError: Error | undefined;\n        let connectionNaturalEnd = false;\n\n        try {\n          const res = await openStreamWith(transport, url, ac, {\n            body,\n            extSignal,\n            fetchInit,\n            headers: perRequestHeaders as Record<string, string> | undefined,\n            method,\n            params: params as Params | undefined,\n            query,\n            timeout: cfgTimeout,\n          });\n\n          const reader = res.body!.getReader();\n          const decoder = new TextDecoder();\n\n          try {\n            if (parse === 'ndjson') {\n              let buffer = '';\n\n              while (true) {\n                const { done, value } = await reader.read();\n\n                if (done) {\n                  const remaining = buffer.trim();\n\n                  if (remaining) {\n                    try {\n                      yield JSON.parse(remaining) as T;\n                    } catch {\n                      throw new CourierParseError(`NDJSON: failed to parse line: ${remaining.slice(0, 200)}`);\n                    }\n                  }\n\n                  connectionNaturalEnd = true;\n                  break;\n                }\n\n                buffer += decoder.decode(value, { stream: true });\n\n                let nlIdx: number;\n\n                while ((nlIdx = buffer.indexOf('\\n')) !== -1) {\n                  const line = buffer.slice(0, nlIdx).trim();\n\n                  buffer = buffer.slice(nlIdx + 1);\n\n                  if (line) {\n                    try {\n                      yield JSON.parse(line) as T;\n                    } catch {\n                      throw new CourierParseError(`NDJSON: failed to parse line: ${line.slice(0, 200)}`);\n                    }\n                  }\n                }\n              }\n            } else {\n              while (true) {\n                const { done, value } = await reader.read();\n\n                if (done) {\n                  connectionNaturalEnd = true;\n                  break;\n                }\n\n                yield decoder.decode(value, { stream: true }) as unknown as T;\n              }\n            }\n          } finally {\n            reader.releaseLock();\n          }\n        } catch (err) {\n          if (transport.disposed || ac.signal.aborted) break;\n\n          connectError = err instanceof Error ? err : new Error(String(err));\n        }\n\n        if (transport.disposed || ac.signal.aborted) break;\n\n        // No reconnect budget — throw or call onError on errors, stop either way\n        if (maxReconnects === 0) {\n          if (connectError) {\n            if (onError) {\n              onError(connectError);\n            } else {\n              throw connectError;\n            }\n          } else {\n            overallNaturalEnd = connectionNaturalEnd;\n          }\n\n          break;\n        }\n\n        // Budget exhausted\n        if (attempt >= maxReconnects) {\n          const budgetError = connectError ?? new Error('[courier] readable() reconnect budget exhausted');\n\n          if (onError) {\n            onError(budgetError);\n          } else if (connectError) {\n            throw connectError;\n          }\n\n          break;\n        }\n\n        // Clean server close with no reconnect error — done\n        if (connectionNaturalEnd && !connectError) {\n          overallNaturalEnd = true;\n          break;\n        }\n\n        // Sleep before reconnecting\n        const delay = typeof reconnectDelay === 'function' ? reconnectDelay(attempt) : reconnectDelay;\n\n        attempt++;\n        await sleep(delay, ac.signal).catch(() => {});\n      }\n    } finally {\n      if (!overallNaturalEnd) ac.abort();\n\n      untrack();\n    }\n  }\n\n  return {\n    cancelAll(): void {\n      transport.cancelAll();\n    },\n    get disposalSignal() {\n      return transport.disposalSignal;\n    },\n    dispose(): void {\n      if (ownTransport) transport.dispose();\n    },\n    get disposed() {\n      return transport.disposed;\n    },\n    getHeaders: transport.getHeaders,\n    headers: transport.headers,\n    readable,\n    sse,\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n    use: transport.use,\n  };\n}\n\nexport type StreamClient = ReturnType<typeof createStream>;\n"],"mappings":"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"}
+{"version":3,"file":"stream.cjs","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import type { ReconnectOptions, StreamRequestConfig } from './stream-shared';\n\nimport { readable, type ReadableConfig } from './stream-readable';\nimport { sse, type SseOptions, type SseSource, type SseStatus } from './stream-sse';\nimport { createTransportCore, type TransportCore, type TransportOptions } from './transport';\n\nexport type { ReadableConfig, ReconnectOptions, SseOptions, SseSource, SseStatus, StreamRequestConfig };\n\n/**\n * Creates a streaming client exposing `sse()` (Server-Sent Events) and `readable()`\n * (`ReadableStream`/NDJSON). Both share the same interceptor pipeline, header management,\n * and `AbortController` lifecycle as `createApi`.\n *\n * @example\n * ```ts\n * const stream = createStream({ baseUrl: 'https://api.example.com' });\n *\n * const src = stream.sse<{ message: { text: string } }>('/events', { reconnect: true });\n * src.on('message', (data) => console.log(data.text));\n *\n * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n *   process.stdout.write(chunk);\n * }\n *\n * // later:\n * stream.dispose();\n * ```\n */\nexport function createStream(opts?: TransportOptions & { transport?: TransportCore }) {\n  const { transport: sharedTransport, ...transportOpts } = opts ?? {};\n  const ownTransport = !sharedTransport;\n  const transport = sharedTransport ?? createTransportCore(transportOpts);\n\n  return {\n    cancelAll(): void {\n      transport.cancelAll();\n    },\n    get disposalSignal() {\n      return transport.disposalSignal;\n    },\n    dispose(): void {\n      if (ownTransport) transport.dispose();\n    },\n    get disposed() {\n      return transport.disposed;\n    },\n    getHeaders: transport.getHeaders,\n    headers: transport.headers,\n    readable: <T = string, P extends string = string>(url: P, config?: ReadableConfig<P>): AsyncGenerator<T> =>\n      readable<T, P>(transport, url, config),\n    sse: <TEvents extends Record<string, unknown> = Record<string, string>, P extends string = string>(\n      url: P,\n      config?: SseOptions<P>,\n    ): SseSource<TEvents> => sse<TEvents, P>(transport, url, config),\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n    use: transport.use,\n  };\n}\n\nexport type StreamClient = ReturnType<typeof createStream>;\n"],"mappings":"oGA4BA,SAAgB,EAAa,EAAyD,CACpF,GAAM,CAAE,UAAW,EAAiB,GAAG,GAAkB,GAAQ,CAAC,EAC5D,EAAe,CAAC,EAChB,EAAY,GAAmB,EAAA,oBAAoB,CAAa,EAEtE,MAAO,CACL,WAAkB,CAChB,EAAU,UAAU,CACtB,EACA,IAAI,gBAAiB,CACnB,OAAO,EAAU,cACnB,EACA,SAAgB,CACV,GAAc,EAAU,QAAQ,CACtC,EACA,IAAI,UAAW,CACb,OAAO,EAAU,QACnB,EACA,WAAY,EAAU,WACtB,QAAS,EAAU,QACnB,UAAkD,EAAQ,IACxD,EAAA,SAAe,EAAW,EAAK,CAAM,EACvC,KACE,EACA,IACuB,EAAA,IAAgB,EAAW,EAAK,CAAM,EAC/D,CAAC,OAAO,UAAiB,CACvB,KAAK,QAAQ,CACf,EACA,IAAK,EAAU,GACjB,CACF"}

package/dist/stream.d.ts

@@ -1,80 +1,8 @@
-import type { Params } from './url';
+import type { ReconnectOptions, StreamRequestConfig } from './stream-shared';
+import { type ReadableConfig } from './stream-readable';
+import { type SseOptions, type SseSource, type SseStatus } from './stream-sse';
 import { type TransportCore, type TransportOptions } from './transport';
-export type StreamRequestConfig<P extends string = string> = {
-    body?: unknown;
-    /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */
-    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;
-    headers?: Record<string, string>;
-    method?: string;
-    params?: P extends string ? Record<string, string | number | boolean> : never;
-    query?: Params;
-    /** External abort signal. Merged with internal cancellation. */
-    signal?: AbortSignal;
-    /** Request timeout in ms. Overrides client default (which is `Infinity` for streaming). */
-    timeout?: number;
-};
-export type ReconnectOptions = {
-    /**
-     * Delay between reconnect attempts in ms, or a zero-based function where
-     * `attempt` is the number of failures so far (0 = waiting before the 2nd try).
-     * Defaults to full-jitter exponential backoff: `[0, min(1s × 2ⁿ, 30s)]`.
-     */
-    delay?: number | ((attempt: number) => number);
-    /** Total reconnect attempts after the first failure. Defaults to `5`. */
-    times?: number;
-};
-export type ReadableConfig<P extends string = string> = StreamRequestConfig<P> & {
-    /**
-     * Called when the reconnect budget is exhausted or a non-retriable error
-     * occurs. Not called when the generator is aborted via signal or dispose.
-     */
-    onError?: (error: Error) => void;
-    /**
-     * Response body parsing mode.
-     * - `'text'` (default) — yields raw decoded string chunks as they arrive.
-     * - `'ndjson'` — splits by newline and JSON-parses each complete line; use `T` to type the values.
-     */
-    parse?: 'ndjson' | 'text';
-    /**
-     * Auto-reconnect on connection loss. Uses the same backoff semantics as
-     * `sse()` reconnect. `true` uses defaults (5 attempts). Defaults to `false`.
-     */
-    reconnect?: boolean | ReconnectOptions;
-};
-export type SseOptions<P extends string = string> = StreamRequestConfig<P> & {
-    /**
-     * Called when the connection is permanently lost (reconnect budget exhausted due to error).
-     * Not called on `dispose()`.
-     */
-    onError?: (error: Error) => void;
-    /**
-     * Auto-reconnect on connection loss with exponential backoff.
-     * `true` uses defaults (5 attempts). Defaults to `false`.
-     */
-    reconnect?: boolean | ReconnectOptions;
-};
-/** Connection lifecycle status for an SSE source. */
-export type SseStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';
-/**
- * Typed SSE event source. `TEvents` maps event name → data type.
- * Non-string data values are automatically JSON-parsed from the raw `data:` field.
- * If parsing fails the raw string is delivered instead.
- */
-export type SseSource<TEvents extends Record<string, unknown> = Record<string, string>> = {
-    [Symbol.dispose](): void;
-    /** `true` after `dispose()` is called or the reconnect budget is exhausted. */
-    readonly closed: boolean;
-    /** Permanently closes the SSE connection. No further events will be dispatched. */
-    dispose(): void;
-    /**
-     * Registers a handler for a named SSE event. Returns an unsubscribe function.
-     * The special name `'message'` matches events without an explicit `event:` field.
-     * Calling `on()` after `dispose()` returns a no-op unsubscribe.
-     */
-    on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void;
-    /** Current connection lifecycle status. Useful for displaying a live-connection indicator. */
-    readonly status: SseStatus;
-};
+export type { ReadableConfig, ReconnectOptions, SseOptions, SseSource, SseStatus, StreamRequestConfig };
 /**
  * Creates a streaming client exposing `sse()` (Server-Sent Events) and `readable()`
  * (`ReadableStream`/NDJSON). Both share the same interceptor pipeline, header management,

package/dist/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAO,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE7F,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;AAExG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG;IAAE,SAAS,CAAC,EAAE,aAAa,CAAA;CAAE;iBAMnE,IAAI;;eAMN,IAAI;;;;eAQJ,CAAC,WAAW,CAAC,SAAS,MAAM,gBAAgB,CAAC,WAAW,cAAc,CAAC,CAAC,CAAC,KAAG,cAAc,CAAC,CAAC,CAAC;UAElG,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,2BAA2B,CAAC,SAAS,MAAM,gBACjF,CAAC,WACG,UAAU,CAAC,CAAC,CAAC,KACrB,SAAS,CAAC,OAAO,CAAC;wBACD,IAAI;;EAK3B;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/stream.js

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

package/dist/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import { sleep } from '@vielzeug/arsenal';\n\nimport type { Params } from './url';\n\nimport { classifyRequestError, CourierDisposedError, CourierHttpError, CourierParseError } from './errors';\nimport { fullJitterDelay } from './retry';\nimport { buildRequestInit } from './serialize';\nimport {\n  anySignal,\n  buildTimeoutSignal,\n  createTransportCore,\n  type TransportCore,\n  type TransportOptions,\n  validateTimeout,\n} from './transport';\nimport { buildUrl } from './url';\n\nexport type StreamRequestConfig<P extends string = string> = {\n  body?: unknown;\n  /** Raw fetch options for advanced use (credentials, cache, mode, referrer, etc.). */\n  fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n  headers?: Record<string, string>;\n  method?: string;\n  params?: P extends string ? Record<string, string | number | boolean> : never;\n  query?: Params;\n  /** External abort signal. Merged with internal cancellation. */\n  signal?: AbortSignal;\n  /** Request timeout in ms. Overrides client default (which is `Infinity` for streaming). */\n  timeout?: number;\n};\n\nexport type ReconnectOptions = {\n  /**\n   * Delay between reconnect attempts in ms, or a zero-based function where\n   * `attempt` is the number of failures so far (0 = waiting before the 2nd try).\n   * Defaults to full-jitter exponential backoff: `[0, min(1s × 2ⁿ, 30s)]`.\n   */\n  delay?: number | ((attempt: number) => number);\n  /** Total reconnect attempts after the first failure. Defaults to `5`. */\n  times?: number;\n};\n\nexport type ReadableConfig<P extends string = string> = StreamRequestConfig<P> & {\n  /**\n   * Called when the reconnect budget is exhausted or a non-retriable error\n   * occurs. Not called when the generator is aborted via signal or dispose.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Response body parsing mode.\n   * - `'text'` (default) — yields raw decoded string chunks as they arrive.\n   * - `'ndjson'` — splits by newline and JSON-parses each complete line; use `T` to type the values.\n   */\n  parse?: 'ndjson' | 'text';\n  /**\n   * Auto-reconnect on connection loss. Uses the same backoff semantics as\n   * `sse()` reconnect. `true` uses defaults (5 attempts). Defaults to `false`.\n   */\n  reconnect?: boolean | ReconnectOptions;\n};\n\nexport type SseOptions<P extends string = string> = StreamRequestConfig<P> & {\n  /**\n   * Called when the connection is permanently lost (reconnect budget exhausted due to error).\n   * Not called on `dispose()`.\n   */\n  onError?: (error: Error) => void;\n  /**\n   * Auto-reconnect on connection loss with exponential backoff.\n   * `true` uses defaults (5 attempts). Defaults to `false`.\n   */\n  reconnect?: boolean | ReconnectOptions;\n};\n\n/** Connection lifecycle status for an SSE source. */\nexport type SseStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';\n\n/**\n * Typed SSE event source. `TEvents` maps event name → data type.\n * Non-string data values are automatically JSON-parsed from the raw `data:` field.\n * If parsing fails the raw string is delivered instead.\n */\nexport type SseSource<TEvents extends Record<string, unknown> = Record<string, string>> = {\n  [Symbol.dispose](): void;\n  /** `true` after `dispose()` is called or the reconnect budget is exhausted. */\n  readonly closed: boolean;\n  /** Permanently closes the SSE connection. No further events will be dispatched. */\n  dispose(): void;\n  /**\n   * Registers a handler for a named SSE event. Returns an unsubscribe function.\n   * The special name `'message'` matches events without an explicit `event:` field.\n   * Calling `on()` after `dispose()` returns a no-op unsubscribe.\n   */\n  on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void;\n  /** Current connection lifecycle status. Useful for displaying a live-connection indicator. */\n  readonly status: SseStatus;\n};\n\n/** Parse a raw SSE data string: try JSON, fall back to raw string. */\nfunction parseEventData(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return raw;\n  }\n}\n\n/**\n * Shared stream setup: build URL, combine signals, merge headers, dispatch through\n * transport. Returns the Response so both sse() and readable() can focus on parsing.\n * The caller owns the AbortController lifecycle (track + untrack).\n */\nasync function openStreamWith(\n  transport: TransportCore,\n  url: string,\n  ac: AbortController,\n  config: {\n    body?: unknown;\n    extSignal?: AbortSignal;\n    fetchInit?: Omit<RequestInit, 'body' | 'headers' | 'method' | 'signal'>;\n    headers?: Record<string, string>;\n    method: string;\n    params?: Params;\n    query?: Params;\n    timeout?: number;\n  },\n  extraHeaders?: Record<string, string>,\n): Promise<Response> {\n  // Normalize once — error paths and RequestInit both receive the canonical form.\n  const method = config.method.toUpperCase();\n  const full = buildUrl(transport.baseUrl, url, config.params, config.query);\n  const combined = anySignal(config.extSignal, ac.signal) ?? ac.signal;\n  // Streaming connections are long-lived — default to Infinity so the transport's\n  // REST default (30s) does not cut off streams prematurely.\n  const signal = buildTimeoutSignal(config.timeout ?? Number.POSITIVE_INFINITY, combined);\n  const requestHeaders = transport.mergeHeaders(config.headers, extraHeaders);\n  const { headers: initHeaders, ...restInit } = buildRequestInit(\n    method,\n    requestHeaders,\n    config.body,\n    signal,\n    config.fetchInit ?? {},\n  );\n\n  let res: Response;\n\n  try {\n    res = await transport.dispatch({ headers: initHeaders as Record<string, string>, init: restInit, url: full });\n  } catch (err) {\n    throw classifyRequestError(err, method, full, signal ?? combined);\n  }\n\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n\n    throw CourierHttpError.fromResponse(res, text, method, full);\n  }\n\n  if (!res.body) throw new CourierParseError('Response has no body');\n\n  return res;\n}\n\n/**\n * Creates a streaming client exposing `sse()` (Server-Sent Events) and `readable()`\n * (`ReadableStream`/NDJSON). Both share the same interceptor pipeline, header management,\n * and `AbortController` lifecycle as `createApi`.\n *\n * @example\n * ```ts\n * const stream = createStream({ baseUrl: 'https://api.example.com' });\n *\n * const src = stream.sse<{ message: { text: string } }>('/events', { reconnect: true });\n * src.on('message', (data) => console.log(data.text));\n *\n * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n *   process.stdout.write(chunk);\n * }\n *\n * // later:\n * stream.dispose();\n * ```\n */\nexport function createStream(opts?: TransportOptions & { transport?: TransportCore }) {\n  const { transport: sharedTransport, ...transportOpts } = opts ?? {};\n  const ownTransport = !sharedTransport;\n  const transport = sharedTransport ?? createTransportCore(transportOpts);\n\n  /**\n   * Opens a Server-Sent Events connection and returns a typed source.\n   *\n   * - Intercepts request through the same pipeline as `createApi` (auth, logging, etc.)\n   * - Auto-reconnects with exponential backoff when `reconnect` is set\n   * - Sends `Last-Event-ID` header on reconnect to resume from last received event\n   * - Non-string event data is automatically JSON-parsed\n   *\n   * @example\n   * ```ts\n   * const src = stream.sse<{ message: { text: string }; ping: null }>('/events', {\n   *   reconnect: true,\n   *   onError: (err) => console.error(err),\n   * });\n   *\n   * src.on('message', (data) => console.log(data.text));\n   * src.on('ping', () => {});\n   * // later:\n   * src.dispose();\n   * ```\n   */\n  function sse<TEvents extends Record<string, unknown> = Record<string, string>, P extends string = string>(\n    url: P,\n    config: SseOptions<P> = {} as SseOptions<P>,\n  ): SseSource<TEvents> {\n    if (transport.disposed) throw new CourierDisposedError('StreamClient');\n\n    const {\n      body,\n      fetchInit,\n      headers: perRequestHeaders,\n      method = body !== undefined ? 'POST' : 'GET',\n      onError,\n      params,\n      query,\n      reconnect = false,\n      signal: extSignal,\n      timeout: cfgTimeout,\n    } = config as SseOptions;\n\n    if (cfgTimeout !== undefined) validateTimeout(cfgTimeout);\n\n    const listeners = new Map<string, Set<(data: unknown) => void>>();\n    const ac = new AbortController();\n    // Track `ac` once for the entire SSE lifetime — covers active connections AND\n    // reconnect sleep windows, so cancelAll()/dispose() always reach it.\n    const untrack = transport.track(ac);\n    let closed = false;\n    let sseStatus: SseStatus = 'connecting';\n    let lastEventId = '';\n\n    const reconnectOpts: ReconnectOptions = reconnect === true ? {} : reconnect === false ? { times: 0 } : reconnect;\n    const maxReconnects = reconnectOpts.times ?? (reconnect ? 5 : 0);\n    // `activeReconnectDelay` is mutable so the server's `retry:` field can update\n    // the reconnection interval without the caller needing to handle it manually.\n    let activeReconnectDelay: number | ((attempt: number) => number) = reconnectOpts.delay ?? fullJitterDelay;\n\n    function dispatchEvent(event: string, rawData: string): void {\n      const handlers = listeners.get(event);\n\n      if (!handlers?.size) return;\n\n      const data = parseEventData(rawData);\n\n      for (const handler of handlers) handler(data);\n    }\n\n    async function connect(): Promise<void> {\n      const res = await openStreamWith(\n        transport,\n        url,\n        ac,\n        {\n          body,\n          extSignal,\n          fetchInit,\n          headers: perRequestHeaders as Record<string, string> | undefined,\n          method,\n          params: params as Params | undefined,\n          query,\n          timeout: cfgTimeout,\n        },\n        {\n          accept: 'text/event-stream',\n          'cache-control': 'no-cache',\n          ...(lastEventId ? { 'last-event-id': lastEventId } : {}),\n        },\n      );\n\n      const reader = res.body!.getReader();\n      const decoder = new TextDecoder();\n      let buffer = '';\n      let currentEvent = 'message';\n      let currentData = '';\n      let currentId = '';\n\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n\n          if (done) break;\n\n          // Normalise \\r\\n and \\r to \\n before processing\n          buffer += decoder.decode(value, { stream: true }).replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n\n          let nlIdx: number;\n\n          while ((nlIdx = buffer.indexOf('\\n')) !== -1) {\n            const line = buffer.slice(0, nlIdx);\n\n            buffer = buffer.slice(nlIdx + 1);\n\n            if (line === '') {\n              // Empty line → dispatch event\n              if (currentData !== '') {\n                if (currentId) lastEventId = currentId;\n\n                dispatchEvent(currentEvent, currentData.replace(/\\n$/, ''));\n              }\n\n              currentEvent = 'message';\n              currentData = '';\n              currentId = '';\n            } else if (line.startsWith(':')) {\n              // Comment — ignore\n            } else {\n              const colonIdx = line.indexOf(':');\n              const field = colonIdx === -1 ? line : line.slice(0, colonIdx);\n              const value = colonIdx === -1 ? '' : line.slice(colonIdx + 1).replace(/^ /, '');\n\n              if (field === 'event') currentEvent = value;\n              else if (field === 'data') currentData += (currentData ? '\\n' : '') + value;\n              else if (field === 'id' && !value.includes('\\0')) currentId = value;\n              else if (field === 'retry') {\n                // Honor the server's advised reconnect interval (SSE spec §9.2.6).\n                const ms = parseInt(value, 10);\n\n                if (!Number.isNaN(ms)) activeReconnectDelay = ms;\n              }\n            }\n          }\n        }\n      } finally {\n        reader.releaseLock();\n      }\n    }\n\n    async function run(): Promise<void> {\n      let attempt = 0;\n\n      try {\n        while (!closed && !transport.disposed && !ac.signal.aborted) {\n          let connectError: Error | undefined;\n\n          sseStatus = 'connecting';\n\n          try {\n            sseStatus = 'open';\n            await connect();\n            // Clean server-side close — falls through to reconnect logic below.\n            // The attempt counter is intentionally NOT reset here: `times`\n            // bounds total reconnects regardless of whether the close was clean or an\n            // error, preventing infinite reconnection against servers that always close\n            // after a response window (e.g. SSE keepalive patterns).\n          } catch (err) {\n            if (closed || transport.disposed || ac.signal.aborted) break;\n\n            connectError = err instanceof Error ? err : new Error(String(err));\n          }\n\n          if (closed || transport.disposed || ac.signal.aborted) break;\n\n          // No reconnect budget → fire onError for errors, stop either way\n          if (maxReconnects === 0) {\n            if (connectError) onError?.(connectError);\n\n            break;\n          }\n\n          // Budget exhausted → always signal via onError so the caller knows\n          // the reconnect cycle has ended (whether the close was clean or not).\n          if (attempt >= maxReconnects) {\n            onError?.(connectError ?? new Error('[courier] SSE reconnect budget exhausted'));\n\n            break;\n          }\n\n          // Budget available → sleep and retry\n          sseStatus = 'reconnecting';\n\n          const delay =\n            typeof activeReconnectDelay === 'function' ? activeReconnectDelay(attempt) : activeReconnectDelay;\n\n          attempt++;\n          await sleep(delay, ac.signal).catch(() => {});\n        }\n      } finally {\n        sseStatus = 'closed';\n        untrack();\n      }\n    }\n\n    // Surface unexpected programming errors (not network failures) via onError\n    run().catch((err) => {\n      if (!closed && !transport.disposed) {\n        onError?.(err instanceof Error ? err : new Error(String(err)));\n      }\n    });\n\n    return {\n      get closed(): boolean {\n        return closed;\n      },\n\n      dispose(): void {\n        closed = true;\n        ac.abort();\n        listeners.clear();\n      },\n\n      on<K extends keyof TEvents & string>(event: K, handler: (data: TEvents[K]) => void): () => void {\n        // After dispose(), return a no-op to avoid silent dead-listener bugs\n        if (closed) return () => {};\n\n        let set = listeners.get(event);\n\n        if (!set) {\n          set = new Set<(data: unknown) => void>();\n          listeners.set(event, set);\n        }\n\n        set.add(handler as (data: unknown) => void);\n\n        return () => set.delete(handler as (data: unknown) => void);\n      },\n\n      get status(): SseStatus {\n        return sseStatus;\n      },\n\n      [Symbol.dispose](): void {\n        this.dispose();\n      },\n    };\n  }\n\n  /**\n   * Opens an HTTP streaming connection and returns an async generator yielding\n   * response body chunks as they arrive.\n   *\n   * - `parse: 'text'` (default) — yields raw decoded string chunks\n   * - `parse: 'ndjson'` — splits by newline and JSON-parses each line; use `T` to\n   *   type the parsed values\n   *\n   * @example\n   * ```ts\n   * // Raw text stream\n   * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n   *   process.stdout.write(chunk);\n   * }\n   *\n   * // NDJSON (e.g. AI token stream, log stream)\n   * for await (const msg of stream.readable<ChatMessage>('/chat', {\n   *   body: { prompt },\n   *   parse: 'ndjson',\n   * })) {\n   *   console.log(msg.content);\n   * }\n   * ```\n   */\n  async function* readable<T = string, P extends string = string>(\n    url: P,\n    config: ReadableConfig<P> = {} as ReadableConfig<P>,\n  ): AsyncGenerator<T> {\n    if (transport.disposed) throw new CourierDisposedError('StreamClient');\n\n    const {\n      body,\n      fetchInit,\n      headers: perRequestHeaders,\n      method = body !== undefined ? 'POST' : 'GET',\n      onError,\n      params,\n      parse = 'text',\n      query,\n      reconnect = false,\n      signal: extSignal,\n      timeout: cfgTimeout,\n    } = config as ReadableConfig;\n\n    if (cfgTimeout !== undefined) validateTimeout(cfgTimeout);\n\n    const reconnectOpts: ReconnectOptions = reconnect === true ? {} : reconnect === false ? { times: 0 } : reconnect;\n    const maxReconnects = reconnectOpts.times ?? (reconnect ? 5 : 0);\n    const reconnectDelay: number | ((attempt: number) => number) = reconnectOpts.delay ?? fullJitterDelay;\n\n    const ac = new AbortController();\n    const untrack = transport.track(ac);\n    let attempt = 0;\n    let overallNaturalEnd = false;\n\n    try {\n      while (!transport.disposed && !ac.signal.aborted) {\n        let connectError: Error | undefined;\n        let connectionNaturalEnd = false;\n\n        try {\n          const res = await openStreamWith(transport, url, ac, {\n            body,\n            extSignal,\n            fetchInit,\n            headers: perRequestHeaders as Record<string, string> | undefined,\n            method,\n            params: params as Params | undefined,\n            query,\n            timeout: cfgTimeout,\n          });\n\n          const reader = res.body!.getReader();\n          const decoder = new TextDecoder();\n\n          try {\n            if (parse === 'ndjson') {\n              let buffer = '';\n\n              while (true) {\n                const { done, value } = await reader.read();\n\n                if (done) {\n                  const remaining = buffer.trim();\n\n                  if (remaining) {\n                    try {\n                      yield JSON.parse(remaining) as T;\n                    } catch {\n                      throw new CourierParseError(`NDJSON: failed to parse line: ${remaining.slice(0, 200)}`);\n                    }\n                  }\n\n                  connectionNaturalEnd = true;\n                  break;\n                }\n\n                buffer += decoder.decode(value, { stream: true });\n\n                let nlIdx: number;\n\n                while ((nlIdx = buffer.indexOf('\\n')) !== -1) {\n                  const line = buffer.slice(0, nlIdx).trim();\n\n                  buffer = buffer.slice(nlIdx + 1);\n\n                  if (line) {\n                    try {\n                      yield JSON.parse(line) as T;\n                    } catch {\n                      throw new CourierParseError(`NDJSON: failed to parse line: ${line.slice(0, 200)}`);\n                    }\n                  }\n                }\n              }\n            } else {\n              while (true) {\n                const { done, value } = await reader.read();\n\n                if (done) {\n                  connectionNaturalEnd = true;\n                  break;\n                }\n\n                yield decoder.decode(value, { stream: true }) as unknown as T;\n              }\n            }\n          } finally {\n            reader.releaseLock();\n          }\n        } catch (err) {\n          if (transport.disposed || ac.signal.aborted) break;\n\n          connectError = err instanceof Error ? err : new Error(String(err));\n        }\n\n        if (transport.disposed || ac.signal.aborted) break;\n\n        // No reconnect budget — throw or call onError on errors, stop either way\n        if (maxReconnects === 0) {\n          if (connectError) {\n            if (onError) {\n              onError(connectError);\n            } else {\n              throw connectError;\n            }\n          } else {\n            overallNaturalEnd = connectionNaturalEnd;\n          }\n\n          break;\n        }\n\n        // Budget exhausted\n        if (attempt >= maxReconnects) {\n          const budgetError = connectError ?? new Error('[courier] readable() reconnect budget exhausted');\n\n          if (onError) {\n            onError(budgetError);\n          } else if (connectError) {\n            throw connectError;\n          }\n\n          break;\n        }\n\n        // Clean server close with no reconnect error — done\n        if (connectionNaturalEnd && !connectError) {\n          overallNaturalEnd = true;\n          break;\n        }\n\n        // Sleep before reconnecting\n        const delay = typeof reconnectDelay === 'function' ? reconnectDelay(attempt) : reconnectDelay;\n\n        attempt++;\n        await sleep(delay, ac.signal).catch(() => {});\n      }\n    } finally {\n      if (!overallNaturalEnd) ac.abort();\n\n      untrack();\n    }\n  }\n\n  return {\n    cancelAll(): void {\n      transport.cancelAll();\n    },\n    get disposalSignal() {\n      return transport.disposalSignal;\n    },\n    dispose(): void {\n      if (ownTransport) transport.dispose();\n    },\n    get disposed() {\n      return transport.disposed;\n    },\n    getHeaders: transport.getHeaders,\n    headers: transport.headers,\n    readable,\n    sse,\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n    use: transport.use,\n  };\n}\n\nexport type StreamClient = ReturnType<typeof createStream>;\n"],"mappings":"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"}
+{"version":3,"file":"stream.js","names":[],"sources":["../src/stream.ts"],"sourcesContent":["import type { ReconnectOptions, StreamRequestConfig } from './stream-shared';\n\nimport { readable, type ReadableConfig } from './stream-readable';\nimport { sse, type SseOptions, type SseSource, type SseStatus } from './stream-sse';\nimport { createTransportCore, type TransportCore, type TransportOptions } from './transport';\n\nexport type { ReadableConfig, ReconnectOptions, SseOptions, SseSource, SseStatus, StreamRequestConfig };\n\n/**\n * Creates a streaming client exposing `sse()` (Server-Sent Events) and `readable()`\n * (`ReadableStream`/NDJSON). Both share the same interceptor pipeline, header management,\n * and `AbortController` lifecycle as `createApi`.\n *\n * @example\n * ```ts\n * const stream = createStream({ baseUrl: 'https://api.example.com' });\n *\n * const src = stream.sse<{ message: { text: string } }>('/events', { reconnect: true });\n * src.on('message', (data) => console.log(data.text));\n *\n * for await (const chunk of stream.readable('/completions', { body: { prompt } })) {\n *   process.stdout.write(chunk);\n * }\n *\n * // later:\n * stream.dispose();\n * ```\n */\nexport function createStream(opts?: TransportOptions & { transport?: TransportCore }) {\n  const { transport: sharedTransport, ...transportOpts } = opts ?? {};\n  const ownTransport = !sharedTransport;\n  const transport = sharedTransport ?? createTransportCore(transportOpts);\n\n  return {\n    cancelAll(): void {\n      transport.cancelAll();\n    },\n    get disposalSignal() {\n      return transport.disposalSignal;\n    },\n    dispose(): void {\n      if (ownTransport) transport.dispose();\n    },\n    get disposed() {\n      return transport.disposed;\n    },\n    getHeaders: transport.getHeaders,\n    headers: transport.headers,\n    readable: <T = string, P extends string = string>(url: P, config?: ReadableConfig<P>): AsyncGenerator<T> =>\n      readable<T, P>(transport, url, config),\n    sse: <TEvents extends Record<string, unknown> = Record<string, string>, P extends string = string>(\n      url: P,\n      config?: SseOptions<P>,\n    ): SseSource<TEvents> => sse<TEvents, P>(transport, url, config),\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n    use: transport.use,\n  };\n}\n\nexport type StreamClient = ReturnType<typeof createStream>;\n"],"mappings":"2IA4BA,SAAgB,EAAa,EAAyD,CACpF,GAAM,CAAE,UAAW,EAAiB,GAAG,GAAkB,GAAQ,CAAC,EAC5D,EAAe,CAAC,EAChB,EAAY,GAAmB,EAAoB,CAAa,EAEtE,MAAO,CACL,WAAkB,CAChB,EAAU,UAAU,CACtB,EACA,IAAI,gBAAiB,CACnB,OAAO,EAAU,cACnB,EACA,SAAgB,CACV,GAAc,EAAU,QAAQ,CACtC,EACA,IAAI,UAAW,CACb,OAAO,EAAU,QACnB,EACA,WAAY,EAAU,WACtB,QAAS,EAAU,QACnB,UAAkD,EAAQ,IACxD,EAAe,EAAW,EAAK,CAAM,EACvC,KACE,EACA,IACuB,EAAgB,EAAW,EAAK,CAAM,EAC/D,CAAC,OAAO,UAAiB,CACvB,KAAK,QAAQ,CACf,EACA,IAAK,EAAU,GACjB,CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/courier",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "HTTP client with caching, request deduplication, typed mutations, SSE streaming, and interceptors",
   "type": "module",
   "files": [
@@ -38,10 +38,10 @@
     "registry": "https://registry.npmjs.org/"
   },
   "engines": {
-    "node": ">=20.3.0"
+    "node": ">=22"
   },
   "dependencies": {
-    "@vielzeug/arsenal": "1.1.1"
+    "@vielzeug/arsenal": "1.1.2"
   },
   "devDependencies": {
     "@types/node": "^26.1.0",