@astrale-os/kernel-client 0.5.0 → 0.6.0-beta.1

package/dist/wire/controller.d.ts

@@ -1,38 +0,0 @@
-/**
- * Compose a caller-supplied `AbortSignal` with an internal timeout timer
- * into a single signal the transport uses for its fetch/websocket call.
- *
- * - The returned `signal` fires when either the caller aborts or the
- *   timeout elapses. The abort reason is preserved from the upstream
- *   signal when available; on timeout the reason is a typed
- *   `TimeoutError`.
- * - `clear()` disarms the timeout timer AND removes the listener from
- *   the upstream signal. Call it once the transport is done so neither
- *   the timer nor the listener leaks. A long-lived caller signal
- *   (React component, per-session controller) that services thousands
- *   of calls stays leak-free.
- * - `clear()` does NOT abort the returned signal. The signal remains
- *   available for post-completion cleanup (e.g. cancelling a stream
- *   reader) until its owning transport releases it.
- * - `timeout <= 0` disables the internal timer.
- */
-export type WireController = {
-    signal: AbortSignal;
-    clear: () => void;
-};
-export type ControllerInput = {
-    /** Optional caller-supplied signal composed into the returned one. */
-    signal?: AbortSignal;
-    /**
-     * Timeout in ms. `<= 0` or `undefined` disables the internal timer —
-     * the caller's signal (if any) remains the only abort source.
-     */
-    timeout?: number;
-    /**
-     * Request id used as the `TimeoutError.requestId` when the internal
-     * timer fires. Kept short — the caller already has structured context.
-     */
-    requestId?: string;
-};
-export declare function createController(input: ControllerInput): WireController;
-//# sourceMappingURL=controller.d.ts.map

package/dist/wire/controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/wire/controller.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAmCvE"}

package/dist/wire/controller.js

@@ -1,38 +0,0 @@
-import { TimeoutError } from '../errors/errors.js';
-export function createController(input) {
-    const controller = new AbortController();
-    const upstream = input.signal;
-    // Forward upstream aborts onto the returned signal. Keep a handler
-    // reference so `clear()` can remove it — a long-lived upstream signal
-    // reused across many calls must not accumulate listeners.
-    let onUpstreamAbort;
-    if (upstream) {
-        if (upstream.aborted) {
-            controller.abort(reasonOf(upstream));
-        }
-        else {
-            onUpstreamAbort = () => controller.abort(reasonOf(upstream));
-            upstream.addEventListener('abort', onUpstreamAbort, { once: true });
-        }
-    }
-    const timeout = input.timeout ?? 0;
-    const timer = timeout > 0
-        ? setTimeout(() => controller.abort(new TimeoutError(input.requestId ?? '-', timeout)), timeout)
-        : undefined;
-    return {
-        signal: controller.signal,
-        clear: () => {
-            if (timer)
-                clearTimeout(timer);
-            if (upstream && onUpstreamAbort) {
-                upstream.removeEventListener('abort', onUpstreamAbort);
-            }
-        },
-    };
-}
-function reasonOf(signal) {
-    if (signal.reason instanceof Error)
-        return signal.reason;
-    return new Error('Aborted');
-}
-//# sourceMappingURL=controller.js.map

package/dist/wire/controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/wire/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAyClD,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAA;IAE7B,mEAAmE;IACnE,sEAAsE;IACtE,0DAA0D;IAC1D,IAAI,eAAyC,CAAA;IAC7C,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtC,CAAC;aAAM,CAAC;YACN,eAAe,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;YAC5D,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAA;IAClC,MAAM,KAAK,GACT,OAAO,GAAG,CAAC;QACT,CAAC,CAAC,UAAU,CACR,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC,EACzE,OAAO,CACR;QACH,CAAC,CAAC,SAAS,CAAA;IAEf,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAA;YAC9B,IAAI,QAAQ,IAAI,eAAe,EAAE,CAAC;gBAChC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;YACxD,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,MAAmB;IACnC,IAAI,MAAM,CAAC,MAAM,YAAY,KAAK;QAAE,OAAO,MAAM,CAAC,MAAM,CAAA;IACxD,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,CAAA;AAC7B,CAAC"}

package/dist/wire/index.d.ts

@@ -1,7 +0,0 @@
-export { createController } from './controller.js';
-export type { ControllerInput, WireController } from './controller.js';
-export { parseEnvelopedSseEvent, parseRawSseEvent, readSseBlocks, splitSseBlocks } from './sse.js';
-export type { EnvelopedSseEvent, RawSseEvent } from './sse.js';
-export { DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_WS_CONNECT_TIMEOUT_MS, DEFAULT_WS_STREAM_QUEUE_SIZE, headersToRecord, } from './meta.js';
-export type { TransportName, WireMeta, WireProtocolMeta } from './meta.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/wire/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAClG,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,eAAe,GAChB,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA"}

package/dist/wire/index.js

@@ -1,4 +0,0 @@
-export { createController } from './controller.js';
-export { parseEnvelopedSseEvent, parseRawSseEvent, readSseBlocks, splitSseBlocks } from './sse.js';
-export { DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_WS_CONNECT_TIMEOUT_MS, DEFAULT_WS_STREAM_QUEUE_SIZE, headersToRecord, } from './meta.js';
-//# sourceMappingURL=index.js.map

package/dist/wire/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAElG,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,eAAe,GAChB,MAAM,WAAW,CAAA"}

package/dist/wire/meta.d.ts

@@ -1,81 +0,0 @@
-import type { RequestId } from '@astrale-os/kernel-api';
-/**
- * Default request timeout (ms). `0` = disabled — the client imposes no
- * per-request timeout and the call runs until the wire (or the OS
- * network stack) returns. Callers opt in explicitly via
- * `ClientConfig.requestTimeout` / `CallOptions.timeout`.
- *
- * Rationale: a hidden default (e.g. 30s) causes CLI/shell commands to
- * sit spinning for seconds on a dead connection when the caller would
- * have preferred to fail fast or to wait indefinitely. "No surprises"
- * means no timeouts the caller didn't ask for.
- */
-export declare const DEFAULT_REQUEST_TIMEOUT_MS = 0;
-/**
- * Default WebSocket connect timeout (ms). `0` = disabled — the WS
- * handshake runs until the server accepts or rejects. Matches the
- * request-timeout default for consistency.
- */
-export declare const DEFAULT_WS_CONNECT_TIMEOUT_MS = 0;
-/** Default stream buffer size for WS streams — producer-ahead limit. */
-export declare const DEFAULT_WS_STREAM_QUEUE_SIZE = 1024;
-/** Transport identity reported on every result's meta. */
-export type TransportName = 'http-envelope' | 'ws-envelope' | 'http-routed';
-/**
- * Protocol-specific metadata, discriminated by `kind`. HTTP transports
- * expose `status` and a flat header map (captured via
- * `Object.fromEntries(res.headers)` so it serialises cleanly in logs);
- * WS exposes only the kind.
- *
- * Multi-valued HTTP headers collapse to their last value on extraction,
- * which matches how most kernel responses behave. A consumer that needs
- * every value for a header sets one via `ClientConfig.fetch` that
- * captures the raw `Headers` upstream of the client.
- */
-export type WireProtocolMeta = {
-    kind: 'http';
-    status: number;
-    headers: Readonly<Record<string, string>>;
-} | {
-    kind: 'ws';
-};
-/**
- * Metadata carried on every `Send*Result`. Populated by the transport
- * at the moment the result was produced: for unary calls the completion,
- * for streams the open (time-to-first-frame). Read-only after emission —
- * mid-stream reconnects do NOT update `durationMs` or `wire`.
- */
-export type WireMeta = Readonly<{
-    /** Server-echoed request id, if present on the wire. */
-    requestId?: RequestId;
-    /**
-     * Wall-clock ms: client-send → client-receive (unary / binary) or
-     * time-to-first-frame (streams). Set once on emission; never updated
-     * thereafter, even on transport-level reconnect.
-     */
-    durationMs: number;
-    /** Codec used for this exchange. */
-    codec: 'json' | 'msgpack';
-    /** Protocol-specific fields, discriminated by `wire.kind`. */
-    wire: WireProtocolMeta;
-    /** Which transport class served this call. */
-    transport: TransportName;
-}>;
-/**
- * Convert a DOM `Headers` to a plain `Record<string, string>` suitable
- * for `WireMeta.wire.headers`. Contract:
- *
- *   - Keys are case-normalised to lower-case by the DOM `Headers` class
- *     on iteration.
- *   - Repeated headers are comma-joined per the Fetch spec (e.g.
- *     `Link: <a>, <b>` surfaces as one entry with both values). The
- *     `Set-Cookie` exception — where each line surfaces as a separate
- *     iteration — collapses to last-wins here; consumers that need
- *     every cookie capture the raw `Headers` upstream (via
- *     `ClientConfig.fetch`).
- *   - The returned record is **frozen** so it can be shared into hook
- *     contexts without defensive copies. Caller mutation throws
- *     `TypeError` in strict mode.
- */
-export declare function headersToRecord(headers: Headers): Readonly<Record<string, string>>;
-//# sourceMappingURL=meta.d.ts.map

package/dist/wire/meta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/wire/meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAEvD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAE9C,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,OAAO,CAAA;AAEhD,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,aAAa,CAAA;AAE3E;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAA;AAElB;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,wDAAwD;IACxD,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,8DAA8D;IAC9D,IAAI,EAAE,gBAAgB,CAAA;IACtB,8CAA8C;IAC9C,SAAS,EAAE,aAAa,CAAA;CACzB,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAMlF"}

package/dist/wire/meta.js

@@ -1,44 +0,0 @@
-/**
- * Default request timeout (ms). `0` = disabled — the client imposes no
- * per-request timeout and the call runs until the wire (or the OS
- * network stack) returns. Callers opt in explicitly via
- * `ClientConfig.requestTimeout` / `CallOptions.timeout`.
- *
- * Rationale: a hidden default (e.g. 30s) causes CLI/shell commands to
- * sit spinning for seconds on a dead connection when the caller would
- * have preferred to fail fast or to wait indefinitely. "No surprises"
- * means no timeouts the caller didn't ask for.
- */
-export const DEFAULT_REQUEST_TIMEOUT_MS = 0;
-/**
- * Default WebSocket connect timeout (ms). `0` = disabled — the WS
- * handshake runs until the server accepts or rejects. Matches the
- * request-timeout default for consistency.
- */
-export const DEFAULT_WS_CONNECT_TIMEOUT_MS = 0;
-/** Default stream buffer size for WS streams — producer-ahead limit. */
-export const DEFAULT_WS_STREAM_QUEUE_SIZE = 1024;
-/**
- * Convert a DOM `Headers` to a plain `Record<string, string>` suitable
- * for `WireMeta.wire.headers`. Contract:
- *
- *   - Keys are case-normalised to lower-case by the DOM `Headers` class
- *     on iteration.
- *   - Repeated headers are comma-joined per the Fetch spec (e.g.
- *     `Link: <a>, <b>` surfaces as one entry with both values). The
- *     `Set-Cookie` exception — where each line surfaces as a separate
- *     iteration — collapses to last-wins here; consumers that need
- *     every cookie capture the raw `Headers` upstream (via
- *     `ClientConfig.fetch`).
- *   - The returned record is **frozen** so it can be shared into hook
- *     contexts without defensive copies. Caller mutation throws
- *     `TypeError` in strict mode.
- */
-export function headersToRecord(headers) {
-    const out = {};
-    headers.forEach((value, key) => {
-        out[key] = value;
-    });
-    return Object.freeze(out);
-}
-//# sourceMappingURL=meta.js.map

package/dist/wire/meta.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/wire/meta.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAA;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAA;AAE9C,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAA;AA2ChD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC7B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC"}

package/dist/wire/sse.d.ts

@@ -1,67 +0,0 @@
-/**
- * Shared SSE framing, consumed by two transports:
- *
- *  - **Enveloped SSE** — `http-envelope` wraps each frame in a kernel
- *    `{ stream: { id, data } }` envelope delivered on `data:` lines.
- *    `parseEnvelopedSseEvent` pulls the `data` payload from the event
- *    block; the caller then JSON-parses and routes through
- *    `parseStreamFrame` from `@astrale-os/kernel-api/envelope`.
- *
- *  - **Raw SSE** — `http-routed` speaks native SSE: `event: …` and
- *    `data: …` lines per spec, no kernel envelope. `parseRawSseEvent`
- *    surfaces the `event` name alongside the `data` payload so the
- *    transport can distinguish `message` / `end` / `error`.
- *
- * Both parsers implement the Server-Sent Events field parsing per the
- * WHATWG spec: field name = characters before the first colon; value =
- * characters after, with a single optional leading U+0020 space stripped.
- * Bare `data` (no colon) is equivalent to `data:` (empty value).
- */
-/** One SSE event, in the enveloped flavour (data-only). */
-export type EnvelopedSseEvent = {
-    data: string;
-};
-/** One SSE event, in the raw flavour (event-typed). */
-export type RawSseEvent = {
-    event: string;
-    data: string;
-};
-/**
- * Parse an enveloped SSE event block. Returns the concatenated `data`
- * payload, or `null` if the block contains no `data` fields.
- *
- * Per spec, multi-line `data:` continuations concatenate with `\n`. An
- * event that contained at least one `data` field returns `{ data }`
- * even when the resulting string is empty.
- */
-export declare function parseEnvelopedSseEvent(block: string): EnvelopedSseEvent | null;
-/**
- * Parse a raw SSE event block. Returns `{ event, data }` with the event
- * name defaulting to `'message'`. Returns `null` only for blocks that
- * have neither an `event:` field nor a `data:` field (pure comment/blank
- * blocks); events with an explicit name but empty data are surfaced.
- */
-export declare function parseRawSseEvent(block: string): RawSseEvent | null;
-/**
- * Pull complete SSE event blocks from a running buffer. The buffer is
- * consumed, and the returned `remainder` is the partial trailing block
- * the caller feeds back in on the next chunk. Callers keep invoking
- * this on each chunk until the reader is done.
- */
-export declare function splitSseBlocks(buffer: string): {
-    blocks: string[];
-    remainder: string;
-};
-/**
- * Read an SSE response body as a stream of event blocks. Handles chunk
- * buffering, cross-chunk block boundaries, and cleanup (the reader is
- * cancelled and released in a `finally` so the underlying connection is
- * closed even when the caller drops the iterator early). `onClose` runs
- * once, after the reader is fully torn down.
- *
- * The caller parses each block into its expected flavour
- * (`parseEnvelopedSseEvent` / `parseRawSseEvent`) and interprets the
- * fields.
- */
-export declare function readSseBlocks(res: Response, callerSignal: AbortSignal | undefined, onClose: () => void): AsyncGenerator<string>;
-//# sourceMappingURL=sse.d.ts.map

package/dist/wire/sse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/wire/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhD,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAuBzD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAkBlE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAItF;AAED;;;;;;;;;;GAUG;AACH,wBAAuB,aAAa,CAClC,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,WAAW,GAAG,SAAS,EACrC,OAAO,EAAE,MAAM,IAAI,GAClB,cAAc,CAAC,MAAM,CAAC,CAkDxB"}

package/dist/wire/sse.js

@@ -1,170 +0,0 @@
-/**
- * Shared SSE framing, consumed by two transports:
- *
- *  - **Enveloped SSE** — `http-envelope` wraps each frame in a kernel
- *    `{ stream: { id, data } }` envelope delivered on `data:` lines.
- *    `parseEnvelopedSseEvent` pulls the `data` payload from the event
- *    block; the caller then JSON-parses and routes through
- *    `parseStreamFrame` from `@astrale-os/kernel-api/envelope`.
- *
- *  - **Raw SSE** — `http-routed` speaks native SSE: `event: …` and
- *    `data: …` lines per spec, no kernel envelope. `parseRawSseEvent`
- *    surfaces the `event` name alongside the `data` payload so the
- *    transport can distinguish `message` / `end` / `error`.
- *
- * Both parsers implement the Server-Sent Events field parsing per the
- * WHATWG spec: field name = characters before the first colon; value =
- * characters after, with a single optional leading U+0020 space stripped.
- * Bare `data` (no colon) is equivalent to `data:` (empty value).
- */
-/**
- * Parse a single SSE line into a `{ name, value }` field, or `null` for
- * comments / blank lines. Handles:
- *
- *   - `name: value`  → `{ name, value }`
- *   - `name:value`   → `{ name, value }` (no leading-space strip)
- *   - `name: `       → `{ name, '' }`
- *   - `name`         → `{ name, '' }` (bare field, equivalent to empty value)
- *   - `: comment`    → `null` (SSE comment)
- *   - ``             → `null` (blank)
- */
-function parseSseField(line) {
-    if (line === '' || line.startsWith(':'))
-        return null;
-    const idx = line.indexOf(':');
-    if (idx === -1)
-        return { name: line, value: '' };
-    const name = line.slice(0, idx);
-    let value = line.slice(idx + 1);
-    if (value.startsWith(' '))
-        value = value.slice(1);
-    return { name, value };
-}
-/**
- * Parse an enveloped SSE event block. Returns the concatenated `data`
- * payload, or `null` if the block contains no `data` fields.
- *
- * Per spec, multi-line `data:` continuations concatenate with `\n`. An
- * event that contained at least one `data` field returns `{ data }`
- * even when the resulting string is empty.
- */
-export function parseEnvelopedSseEvent(block) {
-    let data = '';
-    let hasData = false;
-    for (const line of block.split('\n')) {
-        const field = parseSseField(line);
-        if (!field || field.name !== 'data')
-            continue;
-        data = hasData ? `${data}\n${field.value}` : field.value;
-        hasData = true;
-    }
-    return hasData ? { data } : null;
-}
-/**
- * Parse a raw SSE event block. Returns `{ event, data }` with the event
- * name defaulting to `'message'`. Returns `null` only for blocks that
- * have neither an `event:` field nor a `data:` field (pure comment/blank
- * blocks); events with an explicit name but empty data are surfaced.
- */
-export function parseRawSseEvent(block) {
-    let event = 'message';
-    let data = '';
-    let hasData = false;
-    let hasEvent = false;
-    for (const line of block.split('\n')) {
-        const field = parseSseField(line);
-        if (!field)
-            continue;
-        if (field.name === 'event') {
-            event = field.value.trim() || 'message';
-            hasEvent = true;
-        }
-        else if (field.name === 'data') {
-            data = hasData ? `${data}\n${field.value}` : field.value;
-            hasData = true;
-        }
-    }
-    if (!hasData && !hasEvent)
-        return null;
-    return { event, data };
-}
-/**
- * Pull complete SSE event blocks from a running buffer. The buffer is
- * consumed, and the returned `remainder` is the partial trailing block
- * the caller feeds back in on the next chunk. Callers keep invoking
- * this on each chunk until the reader is done.
- */
-export function splitSseBlocks(buffer) {
-    const parts = buffer.split('\n\n');
-    const remainder = parts.pop() ?? '';
-    return { blocks: parts, remainder };
-}
-/**
- * Read an SSE response body as a stream of event blocks. Handles chunk
- * buffering, cross-chunk block boundaries, and cleanup (the reader is
- * cancelled and released in a `finally` so the underlying connection is
- * closed even when the caller drops the iterator early). `onClose` runs
- * once, after the reader is fully torn down.
- *
- * The caller parses each block into its expected flavour
- * (`parseEnvelopedSseEvent` / `parseRawSseEvent`) and interprets the
- * fields.
- */
-export async function* readSseBlocks(res, callerSignal, onClose) {
-    if (!res.body) {
-        onClose();
-        return;
-    }
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = '';
-    // CallTransport the caller's abort signal to reader.cancel() so an abort during
-    // server silence unblocks the pending `reader.read()`. Without this,
-    // a stream with a dead server and no data keeps `read()` parked
-    // forever, even though `callerSignal.aborted` is true. Remove the
-    // listener in `finally`.
-    let onAbort;
-    if (callerSignal) {
-        if (callerSignal.aborted) {
-            reader.cancel().catch(() => { });
-        }
-        else {
-            onAbort = () => {
-                reader.cancel().catch(() => { });
-            };
-            callerSignal.addEventListener('abort', onAbort, { once: true });
-        }
-    }
-    try {
-        while (true) {
-            if (callerSignal?.aborted)
-                return;
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            buffer += decoder.decode(value, { stream: true });
-            const { blocks, remainder } = splitSseBlocks(buffer);
-            buffer = remainder;
-            for (const block of blocks)
-                yield block;
-        }
-    }
-    finally {
-        if (callerSignal && onAbort)
-            callerSignal.removeEventListener('abort', onAbort);
-        try {
-            await reader.cancel();
-        }
-        catch {
-            /* noop */
-        }
-        try {
-            reader.releaseLock();
-        }
-        catch {
-            /* noop */
-        }
-        onClose();
-    }
-}
-//# sourceMappingURL=sse.js.map

package/dist/wire/sse.js.map

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