@anvia/client 1.4.3 → 1.5.0

package/README.md

@@ -47,7 +47,9 @@ server; keep `UIMessage[]` as presentation state in your application.
 - Typed custom stream data, Agent interactions, and HTTP resume cursors.
 
 For React, `@anvia/react` manages this state through `useChat` and `useCompletion`. Generic JSONL/SSE
-readers are also available from `@anvia/client/transport` for other event contracts.
+readers are also available from `@anvia/client/transport` for other event contracts. Malformed
+frames are skipped and reported through `onParseError` (or thrown with `strict: true`), and
+`readSseFrames` exposes SSE event names, last event IDs, and retry hints.
 
 ## Learn more
 

package/dist/chunk-PD72KNCV.js

@@ -0,0 +1,150 @@
+// src/transport/streams.ts
+var EventStreamParseError = class extends Error {
+  format;
+  /** The raw JSONL line or joined SSE `data` payload. */
+  raw;
+  /** 1-based physical line number of the malformed JSONL line. */
+  line;
+  /** SSE event name of the malformed frame. */
+  event;
+  /** SSE last event ID in effect when the malformed frame was dispatched. */
+  lastEventId;
+  constructor(options) {
+    super(`Malformed ${options.format === "sse" ? "SSE" : "JSONL"} frame: invalid JSON.`, {
+      cause: options.cause
+    });
+    this.name = "EventStreamParseError";
+    this.format = options.format;
+    this.raw = options.raw;
+    this.line = options.line;
+    this.event = options.event;
+    this.lastEventId = options.lastEventId;
+  }
+};
+async function* readJsonlStream(stream, options = {}) {
+  let lineNumber = 0;
+  for await (const line of readLines(stream)) {
+    lineNumber += 1;
+    const raw = line.trim();
+    if (raw.length === 0) continue;
+    const parsed = parseJson(raw, options, () => ({ format: "jsonl", raw, line: lineNumber }));
+    if (parsed.ok) yield parsed.value;
+  }
+}
+async function* readSseStream(stream, options = {}) {
+  for await (const frame of readSseFrames(stream, options)) yield frame.data;
+}
+async function* readSseFrames(stream, options = {}) {
+  let data = [];
+  let event = "";
+  let lastEventId = "";
+  let retry;
+  function dispatch() {
+    const raw = data.join("\n");
+    const name = event === "" ? "message" : event;
+    const hasData = data.length > 0;
+    data = [];
+    event = "";
+    if (!hasData || raw.trim().length === 0) return void 0;
+    const parsed = parseJson(raw, options, () => ({
+      format: "sse",
+      raw,
+      event: name,
+      lastEventId
+    }));
+    if (!parsed.ok) return void 0;
+    const frame2 = { data: parsed.value, event: name, lastEventId };
+    if (retry !== void 0) frame2.retry = retry;
+    return frame2;
+  }
+  for await (const line of readLines(stream)) {
+    if (line === "") {
+      const frame2 = dispatch();
+      if (frame2 !== void 0) yield frame2;
+      continue;
+    }
+    if (line.startsWith(":")) continue;
+    const separator = line.indexOf(":");
+    const field = separator === -1 ? line : line.slice(0, separator);
+    let value = separator === -1 ? "" : line.slice(separator + 1);
+    if (value.startsWith(" ")) value = value.slice(1);
+    if (field === "data") {
+      data.push(value);
+    } else if (field === "event") {
+      event = value;
+    } else if (field === "id") {
+      if (!value.includes("\0")) lastEventId = value;
+    } else if (field === "retry") {
+      if (/^\d+$/.test(value)) retry = Number(value);
+    }
+  }
+  const frame = dispatch();
+  if (frame !== void 0) yield frame;
+}
+async function* readLines(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let skipLeadingLf = false;
+  let completed = false;
+  function* split(text) {
+    let chunk = text;
+    if (skipLeadingLf && chunk.length > 0) {
+      skipLeadingLf = false;
+      if (chunk.startsWith("\n")) chunk = chunk.slice(1);
+    }
+    let start = 0;
+    let index = buffer.length;
+    buffer += chunk;
+    for (; index < buffer.length; index += 1) {
+      const char = buffer.charCodeAt(index);
+      if (char !== 10 && char !== 13) continue;
+      yield buffer.slice(start, index);
+      if (char === 13) {
+        if (index + 1 === buffer.length) skipLeadingLf = true;
+        else if (buffer.charCodeAt(index + 1) === 10) index += 1;
+      }
+      start = index + 1;
+    }
+    buffer = buffer.slice(start);
+  }
+  try {
+    while (true) {
+      const next = await reader.read();
+      if (next.done) {
+        completed = true;
+        break;
+      }
+      yield* split(decoder.decode(next.value, { stream: true }));
+    }
+    yield* split(decoder.decode());
+    if (buffer.length > 0) yield buffer;
+  } finally {
+    if (!completed) await cancelReader(reader);
+    reader.releaseLock();
+  }
+}
+function parseJson(raw, options, details) {
+  try {
+    return { ok: true, value: JSON.parse(raw) };
+  } catch (cause) {
+    const error = new EventStreamParseError({ ...details(), cause });
+    options.onParseError?.(error);
+    if (options.strict === true) throw error;
+    return { ok: false };
+  }
+}
+async function cancelReader(reader) {
+  try {
+    await reader.cancel();
+  } catch {
+  }
+}
+
+export {
+  EventStreamParseError,
+  readJsonlStream,
+  readSseStream,
+  readSseFrames
+};
+//# sourceMappingURL=chunk-PD72KNCV.js.map

package/dist/chunk-PD72KNCV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/streams.ts"],"sourcesContent":["import type { EventStreamFormat } from \"./types\";\n\n/** A malformed JSONL line or SSE data payload that could not be parsed as JSON. */\nexport class EventStreamParseError extends Error {\n  readonly format: EventStreamFormat;\n  /** The raw JSONL line or joined SSE `data` payload. */\n  readonly raw: string;\n  /** 1-based physical line number of the malformed JSONL line. */\n  readonly line: number | undefined;\n  /** SSE event name of the malformed frame. */\n  readonly event: string | undefined;\n  /** SSE last event ID in effect when the malformed frame was dispatched. */\n  readonly lastEventId: string | undefined;\n\n  constructor(options: {\n    format: EventStreamFormat;\n    raw: string;\n    cause: unknown;\n    line?: number;\n    event?: string;\n    lastEventId?: string;\n  }) {\n    super(`Malformed ${options.format === \"sse\" ? \"SSE\" : \"JSONL\"} frame: invalid JSON.`, {\n      cause: options.cause,\n    });\n    this.name = \"EventStreamParseError\";\n    this.format = options.format;\n    this.raw = options.raw;\n    this.line = options.line;\n    this.event = options.event;\n    this.lastEventId = options.lastEventId;\n  }\n}\n\nexport type EventStreamReadOptions = {\n  /**\n   * Receives frames whose payload is not valid JSON. Malformed frames are skipped and the\n   * stream continues. Throwing from this callback aborts the stream with that error.\n   */\n  onParseError?: (error: EventStreamParseError) => void;\n  /** Throw the parse error instead of skipping malformed frames. */\n  strict?: boolean;\n};\n\n/** A dispatched Server-Sent Event with its parsed JSON payload. */\nexport type SseFrame<TEvent> = {\n  data: TEvent;\n  /** Event name from the `event:` field, `\"message\"` when absent. */\n  event: string;\n  /** Last event ID set by an `id:` field in this or an earlier frame, `\"\"` when none. */\n  lastEventId: string;\n  /** Most recent valid `retry:` reconnection time in milliseconds. */\n  retry?: number;\n};\n\nexport async function* readJsonlStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n  options: EventStreamReadOptions = {},\n): AsyncIterable<TEvent> {\n  let lineNumber = 0;\n  for await (const line of readLines(stream)) {\n    lineNumber += 1;\n    const raw = line.trim();\n    if (raw.length === 0) continue;\n    const parsed = parseJson(raw, options, () => ({ format: \"jsonl\", raw, line: lineNumber }));\n    if (parsed.ok) yield parsed.value as TEvent;\n  }\n}\n\nexport async function* readSseStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n  options: EventStreamReadOptions = {},\n): AsyncIterable<TEvent> {\n  for await (const frame of readSseFrames<TEvent>(stream, options)) yield frame.data;\n}\n\nexport async function* readSseFrames<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n  options: EventStreamReadOptions = {},\n): AsyncIterable<SseFrame<TEvent>> {\n  let data: string[] = [];\n  let event = \"\";\n  let lastEventId = \"\";\n  let retry: number | undefined;\n\n  function dispatch(): SseFrame<TEvent> | undefined {\n    const raw = data.join(\"\\n\");\n    const name = event === \"\" ? \"message\" : event;\n    const hasData = data.length > 0;\n    data = [];\n    event = \"\";\n    // Whitespace-only payloads (for example `data:` heartbeats) carry no JSON event.\n    if (!hasData || raw.trim().length === 0) return undefined;\n    const parsed = parseJson(raw, options, () => ({\n      format: \"sse\",\n      raw,\n      event: name,\n      lastEventId,\n    }));\n    if (!parsed.ok) return undefined;\n    const frame: SseFrame<TEvent> = { data: parsed.value as TEvent, event: name, lastEventId };\n    if (retry !== undefined) frame.retry = retry;\n    return frame;\n  }\n\n  for await (const line of readLines(stream)) {\n    if (line === \"\") {\n      const frame = dispatch();\n      if (frame !== undefined) yield frame;\n      continue;\n    }\n    if (line.startsWith(\":\")) continue;\n    const separator = line.indexOf(\":\");\n    const field = separator === -1 ? line : line.slice(0, separator);\n    let value = separator === -1 ? \"\" : line.slice(separator + 1);\n    if (value.startsWith(\" \")) value = value.slice(1);\n    if (field === \"data\") {\n      data.push(value);\n    } else if (field === \"event\") {\n      event = value;\n    } else if (field === \"id\") {\n      if (!value.includes(\"\\0\")) lastEventId = value;\n    } else if (field === \"retry\") {\n      if (/^\\d+$/.test(value)) retry = Number(value);\n    }\n  }\n  // Leniently dispatch a final event that was not followed by a blank line.\n  const frame = dispatch();\n  if (frame !== undefined) yield frame;\n}\n\n/** Splits a byte stream into lines terminated by CRLF, LF, or a bare CR. */\nasync function* readLines(stream: ReadableStream<Uint8Array>): AsyncIterable<string> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let skipLeadingLf = false;\n  let completed = false;\n\n  function* split(text: string): Iterable<string> {\n    let chunk = text;\n    if (skipLeadingLf && chunk.length > 0) {\n      skipLeadingLf = false;\n      if (chunk.startsWith(\"\\n\")) chunk = chunk.slice(1);\n    }\n    let start = 0;\n    let index = buffer.length;\n    buffer += chunk;\n    for (; index < buffer.length; index += 1) {\n      const char = buffer.charCodeAt(index);\n      if (char !== 10 && char !== 13) continue;\n      yield buffer.slice(start, index);\n      if (char === 13) {\n        if (index + 1 === buffer.length) skipLeadingLf = true;\n        else if (buffer.charCodeAt(index + 1) === 10) index += 1;\n      }\n      start = index + 1;\n    }\n    buffer = buffer.slice(start);\n  }\n\n  try {\n    while (true) {\n      const next = await reader.read();\n      if (next.done) {\n        completed = true;\n        break;\n      }\n      yield* split(decoder.decode(next.value, { stream: true }));\n    }\n    yield* split(decoder.decode());\n    if (buffer.length > 0) yield buffer;\n  } finally {\n    if (!completed) await cancelReader(reader);\n    reader.releaseLock();\n  }\n}\n\nfunction parseJson(\n  raw: string,\n  options: EventStreamReadOptions,\n  details: () => Omit<ConstructorParameters<typeof EventStreamParseError>[0], \"cause\">,\n): { ok: true; value: unknown } | { ok: false } {\n  try {\n    return { ok: true, value: JSON.parse(raw) };\n  } catch (cause) {\n    const error = new EventStreamParseError({ ...details(), cause });\n    options.onParseError?.(error);\n    if (options.strict === true) throw error;\n    return { ok: false };\n  }\n}\n\nasync function cancelReader(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void> {\n  try {\n    await reader.cancel();\n  } catch {\n    // The request may already have been aborted by its owner.\n  }\n}\n"],"mappings":"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","names":["frame"]}

package/dist/{chunk-HZZDET2H.js → chunk-RK5U6WVJ.js}

@@ -1,7 +1,7 @@
 import {
   readJsonlStream,
   readSseStream
-} from "./chunk-63JX2QNP.js";
+} from "./chunk-PD72KNCV.js";
 
 // src/transport/fetch.ts
 var EventStreamHttpError = class extends Error {
@@ -22,10 +22,12 @@ async function* fetchEventStream(options) {
   options.validateResponse?.(response);
   if (response.body === null) throw new Error("Event stream response does not include a body.");
   const format = options.format === void 0 || options.format === "auto" ? inferEventStreamFormat(response.headers.get("content-type")) : options.format;
+  const readOptions = {};
+  if (options.onParseError !== void 0) readOptions.onParseError = options.onParseError;
   if (format === "sse") {
-    yield* readSseStream(response.body);
+    yield* readSseStream(response.body, readOptions);
   } else {
-    yield* readJsonlStream(response.body);
+    yield* readJsonlStream(response.body, readOptions);
   }
 }
 function fetchOptions(options) {
@@ -34,6 +36,7 @@ function fetchOptions(options) {
     format: _format,
     fetch: _fetch,
     validateResponse: _validate,
+    onParseError: _onParseError,
     ...init
   } = options;
   return init;
@@ -62,6 +65,7 @@ function createFetchEventTransport(options) {
       if (transportOptions.abortSignal !== void 0) init.signal = transportOptions.abortSignal;
       if (options.fetch !== void 0) init.fetch = options.fetch;
       if (options.validateResponse !== void 0) init.validateResponse = options.validateResponse;
+      if (options.onParseError !== void 0) init.onParseError = options.onParseError;
       for await (const event of fetchEventStream(init)) {
         yield options.mapEvent === void 0 ? event : options.mapEvent(event);
       }
@@ -120,4 +124,4 @@ export {
   createFetchEventTransport,
   createDirectEventTransport
 };
-//# sourceMappingURL=chunk-HZZDET2H.js.map
+//# sourceMappingURL=chunk-RK5U6WVJ.js.map

package/dist/chunk-RK5U6WVJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/fetch.ts","../src/transport/event-transport.ts"],"sourcesContent":["import { type EventStreamReadOptions, readJsonlStream, readSseStream } from \"./streams\";\nimport type { EventStreamFormat } from \"./types\";\n\nexport type FetchEventStreamOptions = Omit<RequestInit, \"headers\"> & {\n  input: string | URL | Request;\n  format?: EventStreamFormat | \"auto\";\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n  validateResponse?: (response: Response) => void;\n  onParseError?: EventStreamReadOptions[\"onParseError\"];\n};\n\nexport class EventStreamHttpError extends Error {\n  constructor(\n    readonly response: Response,\n    readonly body: string,\n  ) {\n    super(`Event stream request failed with status ${response.status}`);\n    this.name = \"EventStreamHttpError\";\n  }\n}\n\nexport async function* fetchEventStream<TEvent>(\n  options: FetchEventStreamOptions,\n): AsyncIterable<TEvent> {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n  if (fetchImpl === undefined) throw new Error(\"fetchEventStream requires a fetch implementation.\");\n\n  const response = await fetchImpl(options.input, fetchOptions(options));\n  if (!response.ok) throw new EventStreamHttpError(response, await response.text());\n  options.validateResponse?.(response);\n  if (response.body === null) throw new Error(\"Event stream response does not include a body.\");\n\n  const format =\n    options.format === undefined || options.format === \"auto\"\n      ? inferEventStreamFormat(response.headers.get(\"content-type\"))\n      : options.format;\n  const readOptions: EventStreamReadOptions = {};\n  if (options.onParseError !== undefined) readOptions.onParseError = options.onParseError;\n  if (format === \"sse\") {\n    yield* readSseStream<TEvent>(response.body, readOptions);\n  } else {\n    yield* readJsonlStream<TEvent>(response.body, readOptions);\n  }\n}\n\nfunction fetchOptions(options: FetchEventStreamOptions): RequestInit {\n  const {\n    input: _input,\n    format: _format,\n    fetch: _fetch,\n    validateResponse: _validate,\n    onParseError: _onParseError,\n    ...init\n  } = options;\n  return init;\n}\n\nfunction inferEventStreamFormat(contentType: string | null): EventStreamFormat {\n  return contentType?.toLowerCase().includes(\"text/event-stream\") ? \"sse\" : \"jsonl\";\n}\n","import { type FetchEventStreamOptions, fetchEventStream } from \"./fetch\";\nimport type { EventStreamFormat, EventTransport, EventTransportSendOptions } from \"./types\";\n\nexport type EventTransportContext<TRequest> = EventTransportSendOptions<TRequest>;\n\nexport type EventTransportBodyContext<TRequest> = Omit<\n  EventTransportContext<TRequest>,\n  \"headers\"\n> & {\n  headers: Headers;\n};\n\nexport type CreateFetchEventTransportOptions<TRequest, TEvent> = {\n  endpoint: string | URL | ((context: EventTransportContext<TRequest>) => string | URL);\n  method?: string;\n  format?: EventStreamFormat | \"auto\";\n  fetch?: typeof fetch;\n  headers?:\n    | HeadersInit\n    | ((context: EventTransportContext<TRequest>) => HeadersInit | Promise<HeadersInit>);\n  body?: (\n    context: EventTransportBodyContext<TRequest>,\n  ) => BodyInit | null | undefined | Promise<BodyInit | null | undefined>;\n  init?: Omit<RequestInit, \"body\" | \"headers\" | \"method\" | \"signal\">;\n  mapEvent?: (event: unknown) => TEvent;\n  validateResponse?: (response: Response) => void;\n  /** Receives malformed frames that were skipped instead of aborting the stream. */\n  onParseError?: FetchEventStreamOptions[\"onParseError\"];\n};\n\nexport function createFetchEventTransport<TRequest, TEvent = unknown>(\n  options: CreateFetchEventTransportOptions<TRequest, TEvent>,\n): EventTransport<TRequest, TEvent> {\n  return {\n    async *send(transportOptions) {\n      const endpoint =\n        typeof options.endpoint === \"function\"\n          ? options.endpoint(transportOptions)\n          : options.endpoint;\n      const requestHeaders = await resolveHeaders(options.headers, transportOptions);\n      const headers = mergeHeaders(requestHeaders, transportOptions.headers);\n      const method = options.method ?? \"POST\";\n      const body = await resolveBody(options.body, transportOptions, headers, method);\n      const init: FetchEventStreamOptions = {\n        ...options.init,\n        input: endpoint,\n        method,\n        headers,\n        format: options.format ?? \"auto\",\n      };\n      if (body !== undefined) init.body = body;\n      if (transportOptions.abortSignal !== undefined) init.signal = transportOptions.abortSignal;\n      if (options.fetch !== undefined) init.fetch = options.fetch;\n      if (options.validateResponse !== undefined) init.validateResponse = options.validateResponse;\n      if (options.onParseError !== undefined) init.onParseError = options.onParseError;\n\n      for await (const event of fetchEventStream<unknown>(init)) {\n        yield options.mapEvent === undefined ? (event as TEvent) : options.mapEvent(event);\n      }\n    },\n  };\n}\n\nexport function createDirectEventTransport<TRequest, TEvent>(options: {\n  handler(context: EventTransportContext<TRequest>): AsyncIterable<TEvent>;\n}): EventTransport<TRequest, TEvent> {\n  return {\n    async *send(context) {\n      const iterator = options.handler(context)[Symbol.asyncIterator]();\n      let closePromise: Promise<unknown> | undefined;\n      const close = () => {\n        closePromise ??= Promise.resolve(iterator.return?.());\n        return closePromise;\n      };\n      const onAbort = () => {\n        void close();\n      };\n      context.abortSignal?.addEventListener(\"abort\", onAbort, { once: true });\n      try {\n        while (!context.abortSignal?.aborted) {\n          const next = await iterator.next();\n          if (next.done) break;\n          yield next.value;\n        }\n      } finally {\n        context.abortSignal?.removeEventListener(\"abort\", onAbort);\n        await close();\n      }\n    },\n  };\n}\n\nasync function resolveHeaders<TRequest>(\n  headers: CreateFetchEventTransportOptions<TRequest, unknown>[\"headers\"],\n  context: EventTransportContext<TRequest>,\n): Promise<HeadersInit | undefined> {\n  return typeof headers === \"function\" ? headers(context) : headers;\n}\n\nasync function resolveBody<TRequest>(\n  body: CreateFetchEventTransportOptions<TRequest, unknown>[\"body\"],\n  context: EventTransportContext<TRequest>,\n  headers: Headers,\n  method: string,\n): Promise<BodyInit | null | undefined> {\n  if (body !== undefined) return body({ ...context, headers });\n  if (method.toUpperCase() === \"GET\" || method.toUpperCase() === \"HEAD\") return undefined;\n  if (!headers.has(\"content-type\")) headers.set(\"content-type\", \"application/json\");\n  return JSON.stringify(context.request);\n}\n\nfunction mergeHeaders(...values: Array<HeadersInit | undefined>): Headers {\n  const headers = new Headers();\n  for (const value of values) {\n    if (value === undefined) continue;\n    new Headers(value).forEach((headerValue, key) => {\n      headers.set(key, headerValue);\n    });\n  }\n  return headers;\n}\n"],"mappings":";;;;;;AAYO,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAC9C,YACW,UACA,MACT;AACA,UAAM,2CAA2C,SAAS,MAAM,EAAE;AAHzD;AACA;AAGT,SAAK,OAAO;AAAA,EACd;AAAA,EALW;AAAA,EACA;AAKb;AAEA,gBAAuB,iBACrB,SACuB;AACvB,QAAM,YAAY,QAAQ,SAAS,WAAW;AAC9C,MAAI,cAAc,OAAW,OAAM,IAAI,MAAM,mDAAmD;AAEhG,QAAM,WAAW,MAAM,UAAU,QAAQ,OAAO,aAAa,OAAO,CAAC;AACrE,MAAI,CAAC,SAAS,GAAI,OAAM,IAAI,qBAAqB,UAAU,MAAM,SAAS,KAAK,CAAC;AAChF,UAAQ,mBAAmB,QAAQ;AACnC,MAAI,SAAS,SAAS,KAAM,OAAM,IAAI,MAAM,gDAAgD;AAE5F,QAAM,SACJ,QAAQ,WAAW,UAAa,QAAQ,WAAW,SAC/C,uBAAuB,SAAS,QAAQ,IAAI,cAAc,CAAC,IAC3D,QAAQ;AACd,QAAM,cAAsC,CAAC;AAC7C,MAAI,QAAQ,iBAAiB,OAAW,aAAY,eAAe,QAAQ;AAC3E,MAAI,WAAW,OAAO;AACpB,WAAO,cAAsB,SAAS,MAAM,WAAW;AAAA,EACzD,OAAO;AACL,WAAO,gBAAwB,SAAS,MAAM,WAAW;AAAA,EAC3D;AACF;AAEA,SAAS,aAAa,SAA+C;AACnE,QAAM;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,kBAAkB;AAAA,IAClB,cAAc;AAAA,IACd,GAAG;AAAA,EACL,IAAI;AACJ,SAAO;AACT;AAEA,SAAS,uBAAuB,aAA+C;AAC7E,SAAO,aAAa,YAAY,EAAE,SAAS,mBAAmB,IAAI,QAAQ;AAC5E;;;AC9BO,SAAS,0BACd,SACkC;AAClC,SAAO;AAAA,IACL,OAAO,KAAK,kBAAkB;AAC5B,YAAM,WACJ,OAAO,QAAQ,aAAa,aACxB,QAAQ,SAAS,gBAAgB,IACjC,QAAQ;AACd,YAAM,iBAAiB,MAAM,eAAe,QAAQ,SAAS,gBAAgB;AAC7E,YAAM,UAAU,aAAa,gBAAgB,iBAAiB,OAAO;AACrE,YAAM,SAAS,QAAQ,UAAU;AACjC,YAAM,OAAO,MAAM,YAAY,QAAQ,MAAM,kBAAkB,SAAS,MAAM;AAC9E,YAAM,OAAgC;AAAA,QACpC,GAAG,QAAQ;AAAA,QACX,OAAO;AAAA,QACP;AAAA,QACA;AAAA,QACA,QAAQ,QAAQ,UAAU;AAAA,MAC5B;AACA,UAAI,SAAS,OAAW,MAAK,OAAO;AACpC,UAAI,iBAAiB,gBAAgB,OAAW,MAAK,SAAS,iBAAiB;AAC/E,UAAI,QAAQ,UAAU,OAAW,MAAK,QAAQ,QAAQ;AACtD,UAAI,QAAQ,qBAAqB,OAAW,MAAK,mBAAmB,QAAQ;AAC5E,UAAI,QAAQ,iBAAiB,OAAW,MAAK,eAAe,QAAQ;AAEpE,uBAAiB,SAAS,iBAA0B,IAAI,GAAG;AACzD,cAAM,QAAQ,aAAa,SAAa,QAAmB,QAAQ,SAAS,KAAK;AAAA,MACnF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,2BAA6C,SAExB;AACnC,SAAO;AAAA,IACL,OAAO,KAAK,SAAS;AACnB,YAAM,WAAW,QAAQ,QAAQ,OAAO,EAAE,OAAO,aAAa,EAAE;AAChE,UAAI;AACJ,YAAM,QAAQ,MAAM;AAClB,yBAAiB,QAAQ,QAAQ,SAAS,SAAS,CAAC;AACpD,eAAO;AAAA,MACT;AACA,YAAM,UAAU,MAAM;AACpB,aAAK,MAAM;AAAA,MACb;AACA,cAAQ,aAAa,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AACtE,UAAI;AACF,eAAO,CAAC,QAAQ,aAAa,SAAS;AACpC,gBAAM,OAAO,MAAM,SAAS,KAAK;AACjC,cAAI,KAAK,KAAM;AACf,gBAAM,KAAK;AAAA,QACb;AAAA,MACF,UAAE;AACA,gBAAQ,aAAa,oBAAoB,SAAS,OAAO;AACzD,cAAM,MAAM;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,eACb,SACA,SACkC;AAClC,SAAO,OAAO,YAAY,aAAa,QAAQ,OAAO,IAAI;AAC5D;AAEA,eAAe,YACb,MACA,SACA,SACA,QACsC;AACtC,MAAI,SAAS,OAAW,QAAO,KAAK,EAAE,GAAG,SAAS,QAAQ,CAAC;AAC3D,MAAI,OAAO,YAAY,MAAM,SAAS,OAAO,YAAY,MAAM,OAAQ,QAAO;AAC9E,MAAI,CAAC,QAAQ,IAAI,cAAc,EAAG,SAAQ,IAAI,gBAAgB,kBAAkB;AAChF,SAAO,KAAK,UAAU,QAAQ,OAAO;AACvC;AAEA,SAAS,gBAAgB,QAAiD;AACxE,QAAM,UAAU,IAAI,QAAQ;AAC5B,aAAW,SAAS,QAAQ;AAC1B,QAAI,UAAU,OAAW;AACzB,QAAI,QAAQ,KAAK,EAAE,QAAQ,CAAC,aAAa,QAAQ;AAC/C,cAAQ,IAAI,KAAK,WAAW;AAAA,IAC9B,CAAC;AAAA,EACH;AACA,SAAO;AACT;","names":[]}

package/dist/durable.js

@@ -1,6 +1,6 @@
 import {
   readSseStream
-} from "./chunk-63JX2QNP.js";
+} from "./chunk-PD72KNCV.js";
 
 // src/durable.ts
 import {
@@ -90,7 +90,7 @@ var DurableClient = class {
     );
     if (!response.headers.get("content-type")?.startsWith("text/event-stream") || response.body === null)
       throw new TypeError("Expected a task SSE response.");
-    for await (const value of readSseStream(response.body)) {
+    for await (const value of readSseStream(response.body, { strict: true })) {
       options.abortSignal?.throwIfAborted();
       const event = parseTaskEvent(value);
       if (event.rootId !== snapshot.task.rootId || event.sequence <= cursor)
@@ -137,7 +137,7 @@ var DurableClient = class {
     );
     if (!response.headers.get("content-type")?.startsWith("text/event-stream") || response.body === null)
       throw new TypeError("Expected a graph SSE response.");
-    for await (const value of readSseStream(response.body)) {
+    for await (const value of readSseStream(response.body, { strict: true })) {
       options.abortSignal?.throwIfAborted();
       const event = parseDurableGraphEvent(value);
       if (event.graphId !== graphId || event.sequence <= cursor)
@@ -147,14 +147,12 @@ var DurableClient = class {
     }
   }
   async submit(submission, options = {}) {
-    return parseDurableSnapshot(
-      await (await this.request(
-        "/runs",
-        "POST",
-        { ...submission, ...options.enqueue === void 0 ? {} : { enqueue: options.enqueue } },
-        options
-      )).json()
-    );
+    const body = { ...submission };
+    if (options.enqueue !== void 0) {
+      body.enqueue = options.enqueue;
+    }
+    const response = await this.request("/runs", "POST", body, options);
+    return parseDurableSnapshot(await response.json());
   }
   async listRuns(filter, options = {}) {
     const query = new URLSearchParams();
@@ -182,7 +180,7 @@ var DurableClient = class {
     );
     if (!response.headers.get("content-type")?.startsWith("text/event-stream") || response.body === null)
       throw new TypeError("Expected a durable SSE response.");
-    for await (const value of readSseStream(response.body)) {
+    for await (const value of readSseStream(response.body, { strict: true })) {
       options.abortSignal?.throwIfAborted();
       const event = parseDurableEvent(value);
       if (event.runId !== runId || event.sequence <= cursor)
@@ -192,14 +190,13 @@ var DurableClient = class {
     }
   }
   async steer(runId, input, options = {}) {
-    return parseDurableSteerReceipt(
-      await (await this.request(
-        `${this.path(runId)}/steer`,
-        "POST",
-        { input, ...options.requestId === void 0 ? {} : { requestId: options.requestId } },
-        options
-      )).json()
-    );
+    const path = `${this.path(runId)}/steer`;
+    const body = { input };
+    if (options.requestId !== void 0) {
+      body.requestId = options.requestId;
+    }
+    const response = await this.request(path, "POST", body, options);
+    return parseDurableSteerReceipt(await response.json());
   }
   async respond(runId, interactionId, response, options = {}) {
     await this.request(`${this.path(runId)}/respond`, "POST", { interactionId, response }, options);
@@ -232,13 +229,22 @@ var DurableClient = class {
     const supplied = typeof this.options.headers === "function" ? await this.options.headers() : this.options.headers;
     const headers = new Headers(supplied);
     if (body !== void 0) headers.set("content-type", "application/json");
-    const response = await (this.options.fetch ?? globalThis.fetch)(`${this.endpoint}${path}`, {
+    const fetch = this.options.fetch ?? globalThis.fetch;
+    const url = `${this.endpoint}${path}`;
+    const init = {
       method,
-      headers,
-      ...body === void 0 ? {} : { body: JSON.stringify(body) },
-      ...options.abortSignal === void 0 ? {} : { signal: options.abortSignal },
-      ...this.options.credentials === void 0 ? {} : { credentials: this.options.credentials }
-    });
+      headers
+    };
+    if (body !== void 0) {
+      init.body = JSON.stringify(body);
+    }
+    if (options.abortSignal !== void 0) {
+      init.signal = options.abortSignal;
+    }
+    if (this.options.credentials !== void 0) {
+      init.credentials = this.options.credentials;
+    }
+    const response = await fetch(url, init);
     if (!response.ok) {
       await response.body?.cancel();
       throw new DurableHttpError(response.status);

package/dist/durable.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/durable.ts"],"sourcesContent":["import {\n  parseTaskSnapshot,\n  parseTaskGraph,\n  parseTaskPage,\n  parseTaskEvent,\n  type TaskSubmission,\n  type TaskSnapshot,\n  type TaskGraphSnapshot,\n  type TaskPage,\n  type TaskListOptions,\n  type TaskEvent,\n} from \"@anvia/durable/protocol\";\nimport type { AgentSteerInput, AgentSteerReceipt } from \"@anvia/core/agent\";\nimport type { AgentInteractionResponse } from \"@anvia/core/agent/interactions\";\nimport type { JsonValue, ToolResultOutput } from \"@anvia/core/completion\";\nimport {\n  parseDurableEvent,\n  parseDurableSteerReceipt,\n  type DurableSteerOptions,\n  parseDurableGraphSnapshot,\n  parseDurableGraphEvent,\n  parseDurableGraphPage,\n  type DurableGraphSubmission,\n  type DurableGraphSnapshot,\n  type DurableGraphListOptions,\n  type DurableGraphPage,\n  type DurableGraphEvent,\n  parseDurableRunPage,\n  parseDurableSnapshot,\n  type DurableEvent,\n  type DurableListOptions,\n  type DurableRunPage,\n  type DurableSnapshot,\n  type DurableSubmission,\n  type DurableSubmitOptions,\n} from \"@anvia/durable/protocol\";\nimport { readSseStream } from \"./transport/streams\";\n\nexport type DurableRequestOptions = { abortSignal?: AbortSignal };\nexport type DurableClientOptions = {\n  /** Absolute HTTP(S) URL matching the server handler's basePath. */\n  endpoint: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);\n  credentials?: RequestCredentials;\n};\nexport class DurableHttpError extends Error {\n  constructor(readonly status: number) {\n    super(`Durable request failed with HTTP ${status}.`);\n    this.name = \"DurableHttpError\";\n  }\n}\n\n/** Browser-safe HTTP client. Reconnect explicitly using a snapshot or last applied event cursor. */\nexport class DurableClient {\n  private readonly endpoint: string;\n  constructor(private readonly options: DurableClientOptions) {\n    const endpoint = new URL(options.endpoint);\n    if (\n      ![\"http:\", \"https:\"].includes(endpoint.protocol) ||\n      endpoint.search ||\n      endpoint.hash ||\n      endpoint.username ||\n      endpoint.password\n    )\n      throw new TypeError(\n        \"endpoint must be an HTTP(S) base URL without credentials, query, or fragment.\",\n      );\n    this.endpoint = endpoint.href.replace(/\\/$/, \"\");\n  }\n\n  async submitTask(\n    /** Trace context is set by the server's `trace` hook. */\n    submission: Omit<TaskSubmission, \"trace\">,\n    options: DurableRequestOptions = {},\n  ): Promise<TaskSnapshot> {\n    return parseTaskSnapshot(\n      await (await this.request(\"/tasks\", \"POST\", submission, options)).json(),\n    );\n  }\n  async taskSnapshot(id: string, options: DurableRequestOptions = {}): Promise<TaskSnapshot> {\n    const snapshot = parseTaskSnapshot(\n      await (await this.request(this.taskPath(id), \"GET\", undefined, options)).json(),\n    );\n    if (snapshot.task.id !== id) throw new TypeError(\"Snapshot belongs to another task.\");\n    return snapshot;\n  }\n  async taskGraph(id: string, options: DurableRequestOptions = {}): Promise<TaskGraphSnapshot> {\n    const graph = parseTaskGraph(\n      await (await this.request(`${this.taskPath(id)}/graph`, \"GET\", undefined, options)).json(),\n    );\n    if (!graph.nodes.some((task) => task.id === id))\n      throw new TypeError(\"Graph belongs to another task.\");\n    return graph;\n  }\n  async listTasks(\n    filter: TaskListOptions & { sessionId: string },\n    options: DurableRequestOptions = {},\n  ): Promise<TaskPage> {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(filter))\n      if (value !== undefined) query.set(key, String(value));\n    return parseTaskPage(\n      await (await this.request(`/tasks?${query}`, \"GET\", undefined, options)).json(),\n    );\n  }\n  async signalTask(\n    id: string,\n    name: string,\n    requestId: string,\n    value: JsonValue,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(`${this.taskPath(id)}/signal`, \"POST\", { name, requestId, value }, options);\n  }\n  async resolveEffect(\n    id: string,\n    key: string,\n    value: JsonValue,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(`${this.taskPath(id)}/resolve-effect`, \"POST\", { key, value }, options);\n  }\n  async retryTask(id: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.taskPath(id)}/retry`, \"POST\", undefined, options);\n  }\n  async cancelTask(id: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.taskPath(id)}/cancel`, \"POST\", undefined, options);\n  }\n  async *streamTask(\n    id: string,\n    options: DurableRequestOptions & { after?: number } = {},\n  ): AsyncIterable<TaskEvent> {\n    let cursor = options.after ?? 0;\n    if (!Number.isSafeInteger(cursor) || cursor < 0) throw new TypeError(\"Invalid task cursor.\");\n    const snapshot = await this.taskSnapshot(id, options);\n    const response = await this.request(\n      `${this.taskPath(id)}/events?after=${cursor}`,\n      \"GET\",\n      undefined,\n      options,\n    );\n    if (\n      !response.headers.get(\"content-type\")?.startsWith(\"text/event-stream\") ||\n      response.body === null\n    )\n      throw new TypeError(\"Expected a task SSE response.\");\n    for await (const value of readSseStream<unknown>(response.body)) {\n      options.abortSignal?.throwIfAborted();\n      const event = parseTaskEvent(value);\n      if (event.rootId !== snapshot.task.rootId || event.sequence <= cursor)\n        throw new TypeError(\"Invalid task event order or root ID.\");\n      cursor = event.sequence;\n      yield event;\n    }\n  }\n  private taskPath(id: string): string {\n    if (id.trim().length === 0 || id === \".\" || id === \"..\") throw new TypeError(\"Invalid taskId.\");\n    return `/tasks/${encodeURIComponent(id)}`;\n  }\n\n  async submitGraph(\n    submission: DurableGraphSubmission,\n    options: DurableRequestOptions = {},\n  ): Promise<DurableGraphSnapshot> {\n    return parseDurableGraphSnapshot(\n      await (await this.request(\"/graphs\", \"POST\", submission, options)).json(),\n    );\n  }\n  async graphSnapshot(\n    graphId: string,\n    options: DurableRequestOptions = {},\n  ): Promise<DurableGraphSnapshot> {\n    const snapshot = parseDurableGraphSnapshot(\n      await (await this.request(this.graphPath(graphId), \"GET\", undefined, options)).json(),\n    );\n    if (snapshot.id !== graphId) throw new TypeError(\"Snapshot belongs to another graph.\");\n    return snapshot;\n  }\n  async listGraphs(\n    filter: DurableGraphListOptions & { sessionId: string },\n    options: DurableRequestOptions = {},\n  ): Promise<DurableGraphPage> {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(filter))\n      if (value !== undefined) query.set(key, String(value));\n    return parseDurableGraphPage(\n      await (await this.request(`/graphs?${query}`, \"GET\", undefined, options)).json(),\n    );\n  }\n  async cancelGraph(graphId: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.graphPath(graphId)}/cancel`, \"POST\", undefined, options);\n  }\n  async *streamGraph(\n    graphId: string,\n    options: DurableRequestOptions & { after?: number } = {},\n  ): AsyncIterable<DurableGraphEvent> {\n    let cursor = options.after ?? 0;\n    if (!Number.isSafeInteger(cursor) || cursor < 0) throw new TypeError(\"Invalid graph cursor.\");\n    const response = await this.request(\n      `${this.graphPath(graphId)}/events?after=${cursor}`,\n      \"GET\",\n      undefined,\n      options,\n    );\n    if (\n      !response.headers.get(\"content-type\")?.startsWith(\"text/event-stream\") ||\n      response.body === null\n    )\n      throw new TypeError(\"Expected a graph SSE response.\");\n    for await (const value of readSseStream<unknown>(response.body)) {\n      options.abortSignal?.throwIfAborted();\n      const event = parseDurableGraphEvent(value);\n      if (event.graphId !== graphId || event.sequence <= cursor)\n        throw new TypeError(\"Invalid graph event order or ID.\");\n      cursor = event.sequence;\n      yield event;\n    }\n  }\n\n  async submit(\n    /** Trace context is set by the server's `trace` hook. */\n    submission: Omit<DurableSubmission, \"trace\">,\n    options: DurableSubmitOptions & DurableRequestOptions = {},\n  ): Promise<DurableSnapshot> {\n    return parseDurableSnapshot(\n      await (\n        await this.request(\n          \"/runs\",\n          \"POST\",\n          { ...submission, ...(options.enqueue === undefined ? {} : { enqueue: options.enqueue }) },\n          options,\n        )\n      ).json(),\n    );\n  }\n  async listRuns(\n    filter: DurableListOptions & { sessionId: string },\n    options: DurableRequestOptions = {},\n  ): Promise<DurableRunPage> {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(filter))\n      if (value !== undefined) query.set(key, String(value));\n    return parseDurableRunPage(\n      await (await this.request(`/runs?${query}`, \"GET\", undefined, options)).json(),\n    );\n  }\n  async snapshot(runId: string, options: DurableRequestOptions = {}): Promise<DurableSnapshot> {\n    const snapshot = parseDurableSnapshot(\n      await (await this.request(this.path(runId), \"GET\", undefined, options)).json(),\n    );\n    if (snapshot.run.id !== runId) throw new TypeError(\"Durable snapshot belongs to another run.\");\n    return snapshot;\n  }\n  async *stream(\n    runId: string,\n    options: DurableRequestOptions & { after?: number } = {},\n  ): AsyncIterable<DurableEvent> {\n    let cursor = options.after ?? 0;\n    if (!Number.isSafeInteger(cursor) || cursor < 0) throw new TypeError(\"Invalid event cursor.\");\n    const response = await this.request(\n      `${this.path(runId)}/events?after=${cursor}`,\n      \"GET\",\n      undefined,\n      options,\n    );\n    if (\n      !response.headers.get(\"content-type\")?.startsWith(\"text/event-stream\") ||\n      response.body === null\n    )\n      throw new TypeError(\"Expected a durable SSE response.\");\n    for await (const value of readSseStream<unknown>(response.body)) {\n      options.abortSignal?.throwIfAborted();\n      const event = parseDurableEvent(value);\n      if (event.runId !== runId || event.sequence <= cursor)\n        throw new TypeError(\"Invalid durable event order or run ID.\");\n      cursor = event.sequence;\n      yield event;\n    }\n  }\n  async steer(\n    runId: string,\n    input: AgentSteerInput,\n    options: DurableSteerOptions & DurableRequestOptions = {},\n  ): Promise<AgentSteerReceipt> {\n    return parseDurableSteerReceipt(\n      await (\n        await this.request(\n          `${this.path(runId)}/steer`,\n          \"POST\",\n          { input, ...(options.requestId === undefined ? {} : { requestId: options.requestId }) },\n          options,\n        )\n      ).json(),\n    );\n  }\n  async respond(\n    runId: string,\n    interactionId: string,\n    response: AgentInteractionResponse,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(`${this.path(runId)}/respond`, \"POST\", { interactionId, response }, options);\n  }\n  async resolveTool(\n    runId: string,\n    operationId: string,\n    output: ToolResultOutput,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(\n      `${this.path(runId)}/resolve-tool`,\n      \"POST\",\n      { operationId, output },\n      options,\n    );\n  }\n  async retry(runId: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.path(runId)}/retry`, \"POST\", undefined, options);\n  }\n  async cancel(runId: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.path(runId)}/cancel`, \"POST\", undefined, options);\n  }\n\n  private graphPath(id: string): string {\n    if (id.trim().length === 0 || id === \".\" || id === \"..\")\n      throw new TypeError(\"Invalid graphId.\");\n    return `/graphs/${encodeURIComponent(id)}`;\n  }\n  private path(id: string): string {\n    if (id.trim().length === 0) throw new TypeError(\"runId must not be empty.\");\n    return `/runs/${encodeURIComponent(id)}`;\n  }\n  private async request(\n    path: string,\n    method: string,\n    body: unknown,\n    options: DurableRequestOptions,\n  ): Promise<Response> {\n    options.abortSignal?.throwIfAborted();\n    const supplied =\n      typeof this.options.headers === \"function\"\n        ? await this.options.headers()\n        : this.options.headers;\n    const headers = new Headers(supplied);\n    if (body !== undefined) headers.set(\"content-type\", \"application/json\");\n    const response = await (this.options.fetch ?? globalThis.fetch)(`${this.endpoint}${path}`, {\n      method,\n      headers,\n      ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n      ...(options.abortSignal === undefined ? {} : { signal: options.abortSignal }),\n      ...(this.options.credentials === undefined ? {} : { credentials: this.options.credentials }),\n    });\n    if (!response.ok) {\n      await response.body?.cancel();\n      throw new DurableHttpError(response.status);\n    }\n    return response;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/durable.ts"],"sourcesContent":["import {\n  parseTaskSnapshot,\n  parseTaskGraph,\n  parseTaskPage,\n  parseTaskEvent,\n  type TaskSubmission,\n  type TaskSnapshot,\n  type TaskGraphSnapshot,\n  type TaskPage,\n  type TaskListOptions,\n  type TaskEvent,\n} from \"@anvia/durable/protocol\";\nimport type { AgentSteerInput, AgentSteerReceipt } from \"@anvia/core/agent\";\nimport type { AgentInteractionResponse } from \"@anvia/core/agent/interactions\";\nimport type { JsonValue, ToolResultOutput } from \"@anvia/core/completion\";\nimport {\n  parseDurableEvent,\n  parseDurableSteerReceipt,\n  type DurableSteerOptions,\n  parseDurableGraphSnapshot,\n  parseDurableGraphEvent,\n  parseDurableGraphPage,\n  type DurableGraphSubmission,\n  type DurableGraphSnapshot,\n  type DurableGraphListOptions,\n  type DurableGraphPage,\n  type DurableGraphEvent,\n  parseDurableRunPage,\n  parseDurableSnapshot,\n  type DurableEvent,\n  type DurableListOptions,\n  type DurableRunPage,\n  type DurableSnapshot,\n  type DurableSubmission,\n  type DurableSubmitOptions,\n} from \"@anvia/durable/protocol\";\nimport { readSseStream } from \"./transport/streams\";\n\nexport type DurableRequestOptions = { abortSignal?: AbortSignal };\nexport type DurableClientOptions = {\n  /** Absolute HTTP(S) URL matching the server handler's basePath. */\n  endpoint: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);\n  credentials?: RequestCredentials;\n};\nexport class DurableHttpError extends Error {\n  constructor(readonly status: number) {\n    super(`Durable request failed with HTTP ${status}.`);\n    this.name = \"DurableHttpError\";\n  }\n}\n\n/** Browser-safe HTTP client. Reconnect explicitly using a snapshot or last applied event cursor. */\nexport class DurableClient {\n  private readonly endpoint: string;\n  constructor(private readonly options: DurableClientOptions) {\n    const endpoint = new URL(options.endpoint);\n    if (\n      ![\"http:\", \"https:\"].includes(endpoint.protocol) ||\n      endpoint.search ||\n      endpoint.hash ||\n      endpoint.username ||\n      endpoint.password\n    )\n      throw new TypeError(\n        \"endpoint must be an HTTP(S) base URL without credentials, query, or fragment.\",\n      );\n    this.endpoint = endpoint.href.replace(/\\/$/, \"\");\n  }\n\n  async submitTask(\n    /** Trace context is set by the server's `trace` hook. */\n    submission: Omit<TaskSubmission, \"trace\">,\n    options: DurableRequestOptions = {},\n  ): Promise<TaskSnapshot> {\n    return parseTaskSnapshot(\n      await (await this.request(\"/tasks\", \"POST\", submission, options)).json(),\n    );\n  }\n  async taskSnapshot(id: string, options: DurableRequestOptions = {}): Promise<TaskSnapshot> {\n    const snapshot = parseTaskSnapshot(\n      await (await this.request(this.taskPath(id), \"GET\", undefined, options)).json(),\n    );\n    if (snapshot.task.id !== id) throw new TypeError(\"Snapshot belongs to another task.\");\n    return snapshot;\n  }\n  async taskGraph(id: string, options: DurableRequestOptions = {}): Promise<TaskGraphSnapshot> {\n    const graph = parseTaskGraph(\n      await (await this.request(`${this.taskPath(id)}/graph`, \"GET\", undefined, options)).json(),\n    );\n    if (!graph.nodes.some((task) => task.id === id))\n      throw new TypeError(\"Graph belongs to another task.\");\n    return graph;\n  }\n  async listTasks(\n    filter: TaskListOptions & { sessionId: string },\n    options: DurableRequestOptions = {},\n  ): Promise<TaskPage> {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(filter))\n      if (value !== undefined) query.set(key, String(value));\n    return parseTaskPage(\n      await (await this.request(`/tasks?${query}`, \"GET\", undefined, options)).json(),\n    );\n  }\n  async signalTask(\n    id: string,\n    name: string,\n    requestId: string,\n    value: JsonValue,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(`${this.taskPath(id)}/signal`, \"POST\", { name, requestId, value }, options);\n  }\n  async resolveEffect(\n    id: string,\n    key: string,\n    value: JsonValue,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(`${this.taskPath(id)}/resolve-effect`, \"POST\", { key, value }, options);\n  }\n  async retryTask(id: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.taskPath(id)}/retry`, \"POST\", undefined, options);\n  }\n  async cancelTask(id: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.taskPath(id)}/cancel`, \"POST\", undefined, options);\n  }\n  async *streamTask(\n    id: string,\n    options: DurableRequestOptions & { after?: number } = {},\n  ): AsyncIterable<TaskEvent> {\n    let cursor = options.after ?? 0;\n    if (!Number.isSafeInteger(cursor) || cursor < 0) throw new TypeError(\"Invalid task cursor.\");\n    const snapshot = await this.taskSnapshot(id, options);\n    const response = await this.request(\n      `${this.taskPath(id)}/events?after=${cursor}`,\n      \"GET\",\n      undefined,\n      options,\n    );\n    if (\n      !response.headers.get(\"content-type\")?.startsWith(\"text/event-stream\") ||\n      response.body === null\n    )\n      throw new TypeError(\"Expected a task SSE response.\");\n    for await (const value of readSseStream<unknown>(response.body, { strict: true })) {\n      options.abortSignal?.throwIfAborted();\n      const event = parseTaskEvent(value);\n      if (event.rootId !== snapshot.task.rootId || event.sequence <= cursor)\n        throw new TypeError(\"Invalid task event order or root ID.\");\n      cursor = event.sequence;\n      yield event;\n    }\n  }\n  private taskPath(id: string): string {\n    if (id.trim().length === 0 || id === \".\" || id === \"..\") throw new TypeError(\"Invalid taskId.\");\n    return `/tasks/${encodeURIComponent(id)}`;\n  }\n\n  async submitGraph(\n    submission: DurableGraphSubmission,\n    options: DurableRequestOptions = {},\n  ): Promise<DurableGraphSnapshot> {\n    return parseDurableGraphSnapshot(\n      await (await this.request(\"/graphs\", \"POST\", submission, options)).json(),\n    );\n  }\n  async graphSnapshot(\n    graphId: string,\n    options: DurableRequestOptions = {},\n  ): Promise<DurableGraphSnapshot> {\n    const snapshot = parseDurableGraphSnapshot(\n      await (await this.request(this.graphPath(graphId), \"GET\", undefined, options)).json(),\n    );\n    if (snapshot.id !== graphId) throw new TypeError(\"Snapshot belongs to another graph.\");\n    return snapshot;\n  }\n  async listGraphs(\n    filter: DurableGraphListOptions & { sessionId: string },\n    options: DurableRequestOptions = {},\n  ): Promise<DurableGraphPage> {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(filter))\n      if (value !== undefined) query.set(key, String(value));\n    return parseDurableGraphPage(\n      await (await this.request(`/graphs?${query}`, \"GET\", undefined, options)).json(),\n    );\n  }\n  async cancelGraph(graphId: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.graphPath(graphId)}/cancel`, \"POST\", undefined, options);\n  }\n  async *streamGraph(\n    graphId: string,\n    options: DurableRequestOptions & { after?: number } = {},\n  ): AsyncIterable<DurableGraphEvent> {\n    let cursor = options.after ?? 0;\n    if (!Number.isSafeInteger(cursor) || cursor < 0) throw new TypeError(\"Invalid graph cursor.\");\n    const response = await this.request(\n      `${this.graphPath(graphId)}/events?after=${cursor}`,\n      \"GET\",\n      undefined,\n      options,\n    );\n    if (\n      !response.headers.get(\"content-type\")?.startsWith(\"text/event-stream\") ||\n      response.body === null\n    )\n      throw new TypeError(\"Expected a graph SSE response.\");\n    for await (const value of readSseStream<unknown>(response.body, { strict: true })) {\n      options.abortSignal?.throwIfAborted();\n      const event = parseDurableGraphEvent(value);\n      if (event.graphId !== graphId || event.sequence <= cursor)\n        throw new TypeError(\"Invalid graph event order or ID.\");\n      cursor = event.sequence;\n      yield event;\n    }\n  }\n\n  async submit(\n    /** Trace context is set by the server's `trace` hook. */\n    submission: Omit<DurableSubmission, \"trace\">,\n    options: DurableSubmitOptions & DurableRequestOptions = {},\n  ): Promise<DurableSnapshot> {\n    const body: Omit<DurableSubmission, \"trace\"> & DurableSubmitOptions = { ...submission };\n\n    if (options.enqueue !== undefined) {\n      body.enqueue = options.enqueue;\n    }\n\n    const response = await this.request(\"/runs\", \"POST\", body, options);\n\n    return parseDurableSnapshot(await response.json());\n  }\n\n  async listRuns(\n    filter: DurableListOptions & { sessionId: string },\n    options: DurableRequestOptions = {},\n  ): Promise<DurableRunPage> {\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(filter))\n      if (value !== undefined) query.set(key, String(value));\n    return parseDurableRunPage(\n      await (await this.request(`/runs?${query}`, \"GET\", undefined, options)).json(),\n    );\n  }\n  async snapshot(runId: string, options: DurableRequestOptions = {}): Promise<DurableSnapshot> {\n    const snapshot = parseDurableSnapshot(\n      await (await this.request(this.path(runId), \"GET\", undefined, options)).json(),\n    );\n    if (snapshot.run.id !== runId) throw new TypeError(\"Durable snapshot belongs to another run.\");\n    return snapshot;\n  }\n  async *stream(\n    runId: string,\n    options: DurableRequestOptions & { after?: number } = {},\n  ): AsyncIterable<DurableEvent> {\n    let cursor = options.after ?? 0;\n    if (!Number.isSafeInteger(cursor) || cursor < 0) throw new TypeError(\"Invalid event cursor.\");\n    const response = await this.request(\n      `${this.path(runId)}/events?after=${cursor}`,\n      \"GET\",\n      undefined,\n      options,\n    );\n    if (\n      !response.headers.get(\"content-type\")?.startsWith(\"text/event-stream\") ||\n      response.body === null\n    )\n      throw new TypeError(\"Expected a durable SSE response.\");\n    for await (const value of readSseStream<unknown>(response.body, { strict: true })) {\n      options.abortSignal?.throwIfAborted();\n      const event = parseDurableEvent(value);\n      if (event.runId !== runId || event.sequence <= cursor)\n        throw new TypeError(\"Invalid durable event order or run ID.\");\n      cursor = event.sequence;\n      yield event;\n    }\n  }\n  async steer(\n    runId: string,\n    input: AgentSteerInput,\n    options: DurableSteerOptions & DurableRequestOptions = {},\n  ): Promise<AgentSteerReceipt> {\n    const path = `${this.path(runId)}/steer`;\n    const body: { input: AgentSteerInput; requestId?: string } = { input };\n\n    if (options.requestId !== undefined) {\n      body.requestId = options.requestId;\n    }\n\n    const response = await this.request(path, \"POST\", body, options);\n\n    return parseDurableSteerReceipt(await response.json());\n  }\n\n  async respond(\n    runId: string,\n    interactionId: string,\n    response: AgentInteractionResponse,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(`${this.path(runId)}/respond`, \"POST\", { interactionId, response }, options);\n  }\n  async resolveTool(\n    runId: string,\n    operationId: string,\n    output: ToolResultOutput,\n    options: DurableRequestOptions = {},\n  ): Promise<void> {\n    await this.request(\n      `${this.path(runId)}/resolve-tool`,\n      \"POST\",\n      { operationId, output },\n      options,\n    );\n  }\n  async retry(runId: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.path(runId)}/retry`, \"POST\", undefined, options);\n  }\n  async cancel(runId: string, options: DurableRequestOptions = {}): Promise<void> {\n    await this.request(`${this.path(runId)}/cancel`, \"POST\", undefined, options);\n  }\n\n  private graphPath(id: string): string {\n    if (id.trim().length === 0 || id === \".\" || id === \"..\")\n      throw new TypeError(\"Invalid graphId.\");\n    return `/graphs/${encodeURIComponent(id)}`;\n  }\n  private path(id: string): string {\n    if (id.trim().length === 0) throw new TypeError(\"runId must not be empty.\");\n    return `/runs/${encodeURIComponent(id)}`;\n  }\n  private async request(\n    path: string,\n    method: string,\n    body: unknown,\n    options: DurableRequestOptions,\n  ): Promise<Response> {\n    options.abortSignal?.throwIfAborted();\n    const supplied =\n      typeof this.options.headers === \"function\"\n        ? await this.options.headers()\n        : this.options.headers;\n    const headers = new Headers(supplied);\n    if (body !== undefined) headers.set(\"content-type\", \"application/json\");\n\n    const fetch = this.options.fetch ?? globalThis.fetch;\n    const url = `${this.endpoint}${path}`;\n    const init: RequestInit = {\n      method,\n      headers,\n    };\n\n    if (body !== undefined) {\n      init.body = JSON.stringify(body);\n    }\n\n    if (options.abortSignal !== undefined) {\n      init.signal = options.abortSignal;\n    }\n\n    if (this.options.credentials !== undefined) {\n      init.credentials = this.options.credentials;\n    }\n\n    const response = await fetch(url, init);\n    if (!response.ok) {\n      await response.body?.cancel();\n      throw new DurableHttpError(response.status);\n    }\n    return response;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { isJsonValue } from '@anvia/core/completion';
 import { AgentInteractionRequest, AgentInteractionResponse } from '@anvia/core/agent/interactions';
 import { GuardrailDecisionRecord } from '@anvia/core/guardrails';
 import { MemoryCompactionInfo } from '@anvia/core/memory';
-import { C as CreateFetchEventTransportOptions } from './event-transport-CC5RD-hT.js';
+import { CreateFetchEventTransportOptions } from './transport/index.js';
 
 declare const CLIENT_STREAM_PROTOCOL: "anvia.client.v3";
 type ClientDataMap = Record<string, JsonValue>;

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createFetchEventTransport
-} from "./chunk-HZZDET2H.js";
-import "./chunk-63JX2QNP.js";
+} from "./chunk-RK5U6WVJ.js";
+import "./chunk-PD72KNCV.js";
 
 // src/adapters.ts
 import {

package/dist/transport/index.d.ts

@@ -1,5 +1,55 @@
-import { E as EventStreamFormat } from '../event-transport-CC5RD-hT.js';
-export { C as CreateFetchEventTransportOptions, a as EventTransport, b as EventTransportSendOptions, c as createDirectEventTransport, d as createFetchEventTransport } from '../event-transport-CC5RD-hT.js';
+type EventStreamFormat = "jsonl" | "sse";
+type EventTransportSendOptions<TRequest> = {
+    request: TRequest;
+    abortSignal?: AbortSignal;
+    headers?: HeadersInit;
+};
+type EventTransport<TRequest, TEvent> = {
+    send(options: EventTransportSendOptions<TRequest>): AsyncIterable<TEvent>;
+};
+
+/** A malformed JSONL line or SSE data payload that could not be parsed as JSON. */
+declare class EventStreamParseError extends Error {
+    readonly format: EventStreamFormat;
+    /** The raw JSONL line or joined SSE `data` payload. */
+    readonly raw: string;
+    /** 1-based physical line number of the malformed JSONL line. */
+    readonly line: number | undefined;
+    /** SSE event name of the malformed frame. */
+    readonly event: string | undefined;
+    /** SSE last event ID in effect when the malformed frame was dispatched. */
+    readonly lastEventId: string | undefined;
+    constructor(options: {
+        format: EventStreamFormat;
+        raw: string;
+        cause: unknown;
+        line?: number;
+        event?: string;
+        lastEventId?: string;
+    });
+}
+type EventStreamReadOptions = {
+    /**
+     * Receives frames whose payload is not valid JSON. Malformed frames are skipped and the
+     * stream continues. Throwing from this callback aborts the stream with that error.
+     */
+    onParseError?: (error: EventStreamParseError) => void;
+    /** Throw the parse error instead of skipping malformed frames. */
+    strict?: boolean;
+};
+/** A dispatched Server-Sent Event with its parsed JSON payload. */
+type SseFrame<TEvent> = {
+    data: TEvent;
+    /** Event name from the `event:` field, `"message"` when absent. */
+    event: string;
+    /** Last event ID set by an `id:` field in this or an earlier frame, `""` when none. */
+    lastEventId: string;
+    /** Most recent valid `retry:` reconnection time in milliseconds. */
+    retry?: number;
+};
+declare function readJsonlStream<TEvent>(stream: ReadableStream<Uint8Array>, options?: EventStreamReadOptions): AsyncIterable<TEvent>;
+declare function readSseStream<TEvent>(stream: ReadableStream<Uint8Array>, options?: EventStreamReadOptions): AsyncIterable<TEvent>;
+declare function readSseFrames<TEvent>(stream: ReadableStream<Uint8Array>, options?: EventStreamReadOptions): AsyncIterable<SseFrame<TEvent>>;
 
 type FetchEventStreamOptions = Omit<RequestInit, "headers"> & {
     input: string | URL | Request;
@@ -7,6 +57,7 @@ type FetchEventStreamOptions = Omit<RequestInit, "headers"> & {
     fetch?: typeof fetch;
     headers?: HeadersInit;
     validateResponse?: (response: Response) => void;
+    onParseError?: EventStreamReadOptions["onParseError"];
 };
 declare class EventStreamHttpError extends Error {
     readonly response: Response;
@@ -15,7 +66,26 @@ declare class EventStreamHttpError extends Error {
 }
 declare function fetchEventStream<TEvent>(options: FetchEventStreamOptions): AsyncIterable<TEvent>;
 
-declare function readJsonlStream<TEvent>(stream: ReadableStream<Uint8Array>): AsyncIterable<TEvent>;
-declare function readSseStream<TEvent>(stream: ReadableStream<Uint8Array>): AsyncIterable<TEvent>;
+type EventTransportContext<TRequest> = EventTransportSendOptions<TRequest>;
+type EventTransportBodyContext<TRequest> = Omit<EventTransportContext<TRequest>, "headers"> & {
+    headers: Headers;
+};
+type CreateFetchEventTransportOptions<TRequest, TEvent> = {
+    endpoint: string | URL | ((context: EventTransportContext<TRequest>) => string | URL);
+    method?: string;
+    format?: EventStreamFormat | "auto";
+    fetch?: typeof fetch;
+    headers?: HeadersInit | ((context: EventTransportContext<TRequest>) => HeadersInit | Promise<HeadersInit>);
+    body?: (context: EventTransportBodyContext<TRequest>) => BodyInit | null | undefined | Promise<BodyInit | null | undefined>;
+    init?: Omit<RequestInit, "body" | "headers" | "method" | "signal">;
+    mapEvent?: (event: unknown) => TEvent;
+    validateResponse?: (response: Response) => void;
+    /** Receives malformed frames that were skipped instead of aborting the stream. */
+    onParseError?: FetchEventStreamOptions["onParseError"];
+};
+declare function createFetchEventTransport<TRequest, TEvent = unknown>(options: CreateFetchEventTransportOptions<TRequest, TEvent>): EventTransport<TRequest, TEvent>;
+declare function createDirectEventTransport<TRequest, TEvent>(options: {
+    handler(context: EventTransportContext<TRequest>): AsyncIterable<TEvent>;
+}): EventTransport<TRequest, TEvent>;
 
-export { EventStreamFormat, EventStreamHttpError, type FetchEventStreamOptions, fetchEventStream, readJsonlStream, readSseStream };
+export { type CreateFetchEventTransportOptions, type EventStreamFormat, EventStreamHttpError, EventStreamParseError, type EventStreamReadOptions, type EventTransport, type EventTransportSendOptions, type FetchEventStreamOptions, type SseFrame, createDirectEventTransport, createFetchEventTransport, fetchEventStream, readJsonlStream, readSseFrames, readSseStream };

package/dist/transport/index.js

@@ -3,17 +3,21 @@ import {
   createDirectEventTransport,
   createFetchEventTransport,
   fetchEventStream
-} from "../chunk-HZZDET2H.js";
+} from "../chunk-RK5U6WVJ.js";
 import {
+  EventStreamParseError,
   readJsonlStream,
+  readSseFrames,
   readSseStream
-} from "../chunk-63JX2QNP.js";
+} from "../chunk-PD72KNCV.js";
 export {
   EventStreamHttpError,
+  EventStreamParseError,
   createDirectEventTransport,
   createFetchEventTransport,
   fetchEventStream,
   readJsonlStream,
+  readSseFrames,
   readSseStream
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvia/client",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "Framework-neutral client protocol, transports, and UI message state for Anvia.",
   "author": "anvia",
   "license": "MIT",
@@ -37,12 +37,12 @@
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@anvia/core": "1.14.1",
-    "@anvia/durable": "0.11.0"
+    "@anvia/core": "1.16.0",
+    "@anvia/durable": "0.12.0"
   },
   "peerDependencies": {
-    "@anvia/durable": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0",
-    "@anvia/core": "^1.14.1"
+    "@anvia/durable": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0",
+    "@anvia/core": "^1.16.0"
   },
   "peerDependenciesMeta": {
     "@anvia/durable": {

package/dist/chunk-63JX2QNP.js

@@ -1,86 +0,0 @@
-// src/transport/streams.ts
-async function* readJsonlStream(stream) {
-  const reader = stream.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  let completed = false;
-  try {
-    while (true) {
-      const next = await reader.read();
-      if (next.done) {
-        completed = true;
-        break;
-      }
-      buffer += decoder.decode(next.value, { stream: true });
-      const lines = buffer.split(/\r?\n/);
-      buffer = lines.pop() ?? "";
-      for (const line of lines) {
-        const value2 = line.trim();
-        if (value2.length > 0) yield JSON.parse(value2);
-      }
-    }
-    buffer += decoder.decode();
-    const value = buffer.trim();
-    if (value.length > 0) yield JSON.parse(value);
-  } finally {
-    if (!completed) await cancelReader(reader);
-    reader.releaseLock();
-  }
-}
-async function* readSseStream(stream) {
-  const reader = stream.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  let data = [];
-  let completed = false;
-  function parseLine(line) {
-    if (line === "") {
-      const complete = data.length === 0 ? void 0 : data.join("\n");
-      data = [];
-      return complete;
-    }
-    if (line.startsWith(":")) return void 0;
-    const separator = line.indexOf(":");
-    const field = separator === -1 ? line : line.slice(0, separator);
-    const value = separator === -1 ? "" : line.slice(separator + 1).replace(/^ /, "");
-    if (field === "data") data.push(value);
-    return void 0;
-  }
-  try {
-    while (true) {
-      const next = await reader.read();
-      if (next.done) {
-        completed = true;
-        break;
-      }
-      buffer += decoder.decode(next.value, { stream: true });
-      const lines = buffer.split(/\r?\n/);
-      buffer = lines.pop() ?? "";
-      for (const line of lines) {
-        const complete = parseLine(line);
-        if (complete !== void 0) yield JSON.parse(complete);
-      }
-    }
-    buffer += decoder.decode();
-    if (buffer.length > 0) {
-      const complete = parseLine(buffer);
-      if (complete !== void 0) yield JSON.parse(complete);
-    }
-    if (data.length > 0) yield JSON.parse(data.join("\n"));
-  } finally {
-    if (!completed) await cancelReader(reader);
-    reader.releaseLock();
-  }
-}
-async function cancelReader(reader) {
-  try {
-    await reader.cancel();
-  } catch {
-  }
-}
-
-export {
-  readJsonlStream,
-  readSseStream
-};
-//# sourceMappingURL=chunk-63JX2QNP.js.map

package/dist/chunk-63JX2QNP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/transport/streams.ts"],"sourcesContent":["export async function* readJsonlStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<TEvent> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let completed = false;\n\n  try {\n    while (true) {\n      const next = await reader.read();\n      if (next.done) {\n        completed = true;\n        break;\n      }\n      buffer += decoder.decode(next.value, { stream: true });\n      const lines = buffer.split(/\\r?\\n/);\n      buffer = lines.pop() ?? \"\";\n      for (const line of lines) {\n        const value = line.trim();\n        if (value.length > 0) yield JSON.parse(value) as TEvent;\n      }\n    }\n    buffer += decoder.decode();\n    const value = buffer.trim();\n    if (value.length > 0) yield JSON.parse(value) as TEvent;\n  } finally {\n    if (!completed) await cancelReader(reader);\n    reader.releaseLock();\n  }\n}\n\nexport async function* readSseStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<TEvent> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let data: string[] = [];\n  let completed = false;\n\n  function parseLine(line: string): string | undefined {\n    if (line === \"\") {\n      const complete = data.length === 0 ? undefined : data.join(\"\\n\");\n      data = [];\n      return complete;\n    }\n    if (line.startsWith(\":\")) return undefined;\n    const separator = line.indexOf(\":\");\n    const field = separator === -1 ? line : line.slice(0, separator);\n    const value = separator === -1 ? \"\" : line.slice(separator + 1).replace(/^ /, \"\");\n    if (field === \"data\") data.push(value);\n    return undefined;\n  }\n\n  try {\n    while (true) {\n      const next = await reader.read();\n      if (next.done) {\n        completed = true;\n        break;\n      }\n      buffer += decoder.decode(next.value, { stream: true });\n      const lines = buffer.split(/\\r?\\n/);\n      buffer = lines.pop() ?? \"\";\n      for (const line of lines) {\n        const complete = parseLine(line);\n        if (complete !== undefined) yield JSON.parse(complete) as TEvent;\n      }\n    }\n    buffer += decoder.decode();\n    if (buffer.length > 0) {\n      const complete = parseLine(buffer);\n      if (complete !== undefined) yield JSON.parse(complete) as TEvent;\n    }\n    if (data.length > 0) yield JSON.parse(data.join(\"\\n\")) as TEvent;\n  } finally {\n    if (!completed) await cancelReader(reader);\n    reader.releaseLock();\n  }\n}\n\nasync function cancelReader(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void> {\n  try {\n    await reader.cancel();\n  } catch {\n    // The request may already have been aborted by its owner.\n  }\n}\n"],"mappings":";AAAA,gBAAuB,gBACrB,QACuB;AACvB,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,UAAU,IAAI,YAAY;AAChC,MAAI,SAAS;AACb,MAAI,YAAY;AAEhB,MAAI;AACF,WAAO,MAAM;AACX,YAAM,OAAO,MAAM,OAAO,KAAK;AAC/B,UAAI,KAAK,MAAM;AACb,oBAAY;AACZ;AAAA,MACF;AACA,gBAAU,QAAQ,OAAO,KAAK,OAAO,EAAE,QAAQ,KAAK,CAAC;AACrD,YAAM,QAAQ,OAAO,MAAM,OAAO;AAClC,eAAS,MAAM,IAAI,KAAK;AACxB,iBAAW,QAAQ,OAAO;AACxB,cAAMA,SAAQ,KAAK,KAAK;AACxB,YAAIA,OAAM,SAAS,EAAG,OAAM,KAAK,MAAMA,MAAK;AAAA,MAC9C;AAAA,IACF;AACA,cAAU,QAAQ,OAAO;AACzB,UAAM,QAAQ,OAAO,KAAK;AAC1B,QAAI,MAAM,SAAS,EAAG,OAAM,KAAK,MAAM,KAAK;AAAA,EAC9C,UAAE;AACA,QAAI,CAAC,UAAW,OAAM,aAAa,MAAM;AACzC,WAAO,YAAY;AAAA,EACrB;AACF;AAEA,gBAAuB,cACrB,QACuB;AACvB,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,UAAU,IAAI,YAAY;AAChC,MAAI,SAAS;AACb,MAAI,OAAiB,CAAC;AACtB,MAAI,YAAY;AAEhB,WAAS,UAAU,MAAkC;AACnD,QAAI,SAAS,IAAI;AACf,YAAM,WAAW,KAAK,WAAW,IAAI,SAAY,KAAK,KAAK,IAAI;AAC/D,aAAO,CAAC;AACR,aAAO;AAAA,IACT;AACA,QAAI,KAAK,WAAW,GAAG,EAAG,QAAO;AACjC,UAAM,YAAY,KAAK,QAAQ,GAAG;AAClC,UAAM,QAAQ,cAAc,KAAK,OAAO,KAAK,MAAM,GAAG,SAAS;AAC/D,UAAM,QAAQ,cAAc,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC,EAAE,QAAQ,MAAM,EAAE;AAChF,QAAI,UAAU,OAAQ,MAAK,KAAK,KAAK;AACrC,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,MAAM;AACX,YAAM,OAAO,MAAM,OAAO,KAAK;AAC/B,UAAI,KAAK,MAAM;AACb,oBAAY;AACZ;AAAA,MACF;AACA,gBAAU,QAAQ,OAAO,KAAK,OAAO,EAAE,QAAQ,KAAK,CAAC;AACrD,YAAM,QAAQ,OAAO,MAAM,OAAO;AAClC,eAAS,MAAM,IAAI,KAAK;AACxB,iBAAW,QAAQ,OAAO;AACxB,cAAM,WAAW,UAAU,IAAI;AAC/B,YAAI,aAAa,OAAW,OAAM,KAAK,MAAM,QAAQ;AAAA,MACvD;AAAA,IACF;AACA,cAAU,QAAQ,OAAO;AACzB,QAAI,OAAO,SAAS,GAAG;AACrB,YAAM,WAAW,UAAU,MAAM;AACjC,UAAI,aAAa,OAAW,OAAM,KAAK,MAAM,QAAQ;AAAA,IACvD;AACA,QAAI,KAAK,SAAS,EAAG,OAAM,KAAK,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,EACvD,UAAE;AACA,QAAI,CAAC,UAAW,OAAM,aAAa,MAAM;AACzC,WAAO,YAAY;AAAA,EACrB;AACF;AAEA,eAAe,aAAa,QAAgE;AAC1F,MAAI;AACF,UAAM,OAAO,OAAO;AAAA,EACtB,QAAQ;AAAA,EAER;AACF;","names":["value"]}

package/dist/chunk-HZZDET2H.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/transport/fetch.ts","../src/transport/event-transport.ts"],"sourcesContent":["import { readJsonlStream, readSseStream } from \"./streams\";\nimport type { EventStreamFormat } from \"./types\";\n\nexport type FetchEventStreamOptions = Omit<RequestInit, \"headers\"> & {\n  input: string | URL | Request;\n  format?: EventStreamFormat | \"auto\";\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n  validateResponse?: (response: Response) => void;\n};\n\nexport class EventStreamHttpError extends Error {\n  constructor(\n    readonly response: Response,\n    readonly body: string,\n  ) {\n    super(`Event stream request failed with status ${response.status}`);\n    this.name = \"EventStreamHttpError\";\n  }\n}\n\nexport async function* fetchEventStream<TEvent>(\n  options: FetchEventStreamOptions,\n): AsyncIterable<TEvent> {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n  if (fetchImpl === undefined) throw new Error(\"fetchEventStream requires a fetch implementation.\");\n\n  const response = await fetchImpl(options.input, fetchOptions(options));\n  if (!response.ok) throw new EventStreamHttpError(response, await response.text());\n  options.validateResponse?.(response);\n  if (response.body === null) throw new Error(\"Event stream response does not include a body.\");\n\n  const format =\n    options.format === undefined || options.format === \"auto\"\n      ? inferEventStreamFormat(response.headers.get(\"content-type\"))\n      : options.format;\n  if (format === \"sse\") {\n    yield* readSseStream<TEvent>(response.body);\n  } else {\n    yield* readJsonlStream<TEvent>(response.body);\n  }\n}\n\nfunction fetchOptions(options: FetchEventStreamOptions): RequestInit {\n  const {\n    input: _input,\n    format: _format,\n    fetch: _fetch,\n    validateResponse: _validate,\n    ...init\n  } = options;\n  return init;\n}\n\nfunction inferEventStreamFormat(contentType: string | null): EventStreamFormat {\n  return contentType?.toLowerCase().includes(\"text/event-stream\") ? \"sse\" : \"jsonl\";\n}\n","import { type FetchEventStreamOptions, fetchEventStream } from \"./fetch\";\nimport type { EventStreamFormat, EventTransport, EventTransportSendOptions } from \"./types\";\n\nexport type EventTransportContext<TRequest> = EventTransportSendOptions<TRequest>;\n\nexport type EventTransportBodyContext<TRequest> = Omit<\n  EventTransportContext<TRequest>,\n  \"headers\"\n> & {\n  headers: Headers;\n};\n\nexport type CreateFetchEventTransportOptions<TRequest, TEvent> = {\n  endpoint: string | URL | ((context: EventTransportContext<TRequest>) => string | URL);\n  method?: string;\n  format?: EventStreamFormat | \"auto\";\n  fetch?: typeof fetch;\n  headers?:\n    | HeadersInit\n    | ((context: EventTransportContext<TRequest>) => HeadersInit | Promise<HeadersInit>);\n  body?: (\n    context: EventTransportBodyContext<TRequest>,\n  ) => BodyInit | null | undefined | Promise<BodyInit | null | undefined>;\n  init?: Omit<RequestInit, \"body\" | \"headers\" | \"method\" | \"signal\">;\n  mapEvent?: (event: unknown) => TEvent;\n  validateResponse?: (response: Response) => void;\n};\n\nexport function createFetchEventTransport<TRequest, TEvent = unknown>(\n  options: CreateFetchEventTransportOptions<TRequest, TEvent>,\n): EventTransport<TRequest, TEvent> {\n  return {\n    async *send(transportOptions) {\n      const endpoint =\n        typeof options.endpoint === \"function\"\n          ? options.endpoint(transportOptions)\n          : options.endpoint;\n      const requestHeaders = await resolveHeaders(options.headers, transportOptions);\n      const headers = mergeHeaders(requestHeaders, transportOptions.headers);\n      const method = options.method ?? \"POST\";\n      const body = await resolveBody(options.body, transportOptions, headers, method);\n      const init: FetchEventStreamOptions = {\n        ...options.init,\n        input: endpoint,\n        method,\n        headers,\n        format: options.format ?? \"auto\",\n      };\n      if (body !== undefined) init.body = body;\n      if (transportOptions.abortSignal !== undefined) init.signal = transportOptions.abortSignal;\n      if (options.fetch !== undefined) init.fetch = options.fetch;\n      if (options.validateResponse !== undefined) init.validateResponse = options.validateResponse;\n\n      for await (const event of fetchEventStream<unknown>(init)) {\n        yield options.mapEvent === undefined ? (event as TEvent) : options.mapEvent(event);\n      }\n    },\n  };\n}\n\nexport function createDirectEventTransport<TRequest, TEvent>(options: {\n  handler(context: EventTransportContext<TRequest>): AsyncIterable<TEvent>;\n}): EventTransport<TRequest, TEvent> {\n  return {\n    async *send(context) {\n      const iterator = options.handler(context)[Symbol.asyncIterator]();\n      let closePromise: Promise<unknown> | undefined;\n      const close = () => {\n        closePromise ??= Promise.resolve(iterator.return?.());\n        return closePromise;\n      };\n      const onAbort = () => {\n        void close();\n      };\n      context.abortSignal?.addEventListener(\"abort\", onAbort, { once: true });\n      try {\n        while (!context.abortSignal?.aborted) {\n          const next = await iterator.next();\n          if (next.done) break;\n          yield next.value;\n        }\n      } finally {\n        context.abortSignal?.removeEventListener(\"abort\", onAbort);\n        await close();\n      }\n    },\n  };\n}\n\nasync function resolveHeaders<TRequest>(\n  headers: CreateFetchEventTransportOptions<TRequest, unknown>[\"headers\"],\n  context: EventTransportContext<TRequest>,\n): Promise<HeadersInit | undefined> {\n  return typeof headers === \"function\" ? headers(context) : headers;\n}\n\nasync function resolveBody<TRequest>(\n  body: CreateFetchEventTransportOptions<TRequest, unknown>[\"body\"],\n  context: EventTransportContext<TRequest>,\n  headers: Headers,\n  method: string,\n): Promise<BodyInit | null | undefined> {\n  if (body !== undefined) return body({ ...context, headers });\n  if (method.toUpperCase() === \"GET\" || method.toUpperCase() === \"HEAD\") return undefined;\n  if (!headers.has(\"content-type\")) headers.set(\"content-type\", \"application/json\");\n  return JSON.stringify(context.request);\n}\n\nfunction mergeHeaders(...values: Array<HeadersInit | undefined>): Headers {\n  const headers = new Headers();\n  for (const value of values) {\n    if (value === undefined) continue;\n    new Headers(value).forEach((headerValue, key) => {\n      headers.set(key, headerValue);\n    });\n  }\n  return headers;\n}\n"],"mappings":"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","names":[]}

package/dist/event-transport-CC5RD-hT.d.ts

@@ -1,31 +0,0 @@
-type EventStreamFormat = "jsonl" | "sse";
-type EventTransportSendOptions<TRequest> = {
-    request: TRequest;
-    abortSignal?: AbortSignal;
-    headers?: HeadersInit;
-};
-type EventTransport<TRequest, TEvent> = {
-    send(options: EventTransportSendOptions<TRequest>): AsyncIterable<TEvent>;
-};
-
-type EventTransportContext<TRequest> = EventTransportSendOptions<TRequest>;
-type EventTransportBodyContext<TRequest> = Omit<EventTransportContext<TRequest>, "headers"> & {
-    headers: Headers;
-};
-type CreateFetchEventTransportOptions<TRequest, TEvent> = {
-    endpoint: string | URL | ((context: EventTransportContext<TRequest>) => string | URL);
-    method?: string;
-    format?: EventStreamFormat | "auto";
-    fetch?: typeof fetch;
-    headers?: HeadersInit | ((context: EventTransportContext<TRequest>) => HeadersInit | Promise<HeadersInit>);
-    body?: (context: EventTransportBodyContext<TRequest>) => BodyInit | null | undefined | Promise<BodyInit | null | undefined>;
-    init?: Omit<RequestInit, "body" | "headers" | "method" | "signal">;
-    mapEvent?: (event: unknown) => TEvent;
-    validateResponse?: (response: Response) => void;
-};
-declare function createFetchEventTransport<TRequest, TEvent = unknown>(options: CreateFetchEventTransportOptions<TRequest, TEvent>): EventTransport<TRequest, TEvent>;
-declare function createDirectEventTransport<TRequest, TEvent>(options: {
-    handler(context: EventTransportContext<TRequest>): AsyncIterable<TEvent>;
-}): EventTransport<TRequest, TEvent>;
-
-export { type CreateFetchEventTransportOptions as C, type EventStreamFormat as E, type EventTransport as a, type EventTransportSendOptions as b, createDirectEventTransport as c, createFetchEventTransport as d };