@cadenya/widgets 1.0.0

package/dist/core/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,MAAM,OAAO,IAAI;IAEJ;IACA;IACQ;IAHnB,YACW,KAAU,EACV,UAA8B,EACtB,SAA+C;QAFvD,UAAK,GAAL,KAAK,CAAK;QACV,eAAU,GAAV,UAAU,CAAoB;QACtB,cAAS,GAAT,SAAS,CAAsC;IAC/D,CAAC;IAEJ,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAoB,CAAC,CAAC;IACnD,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,IAAI,IAAI,GAAmB,IAAI,CAAC;QAChC,OAAO,IAAI,EAAE,CAAC;YACZ,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,CAAC;YAC1C,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;CACF","sourcesContent":["/** Cursor pagination. Pages are async-iterable across page boundaries. */\n\nexport class Page<T> implements AsyncIterable<T> {\n  constructor(\n    readonly items: T[],\n    readonly nextCursor: string | undefined,\n    private readonly fetchPage: (cursor: string) => Promise<Page<T>>,\n  ) {}\n\n  hasNextPage(): boolean {\n    return this.nextCursor !== undefined && this.nextCursor !== '';\n  }\n\n  async getNextPage(): Promise<Page<T> | null> {\n    if (!this.hasNextPage()) return null;\n    return this.fetchPage(this.nextCursor as string);\n  }\n\n  /** Iterate every item on every page, fetching lazily. */\n  async *[Symbol.asyncIterator](): AsyncIterator<T> {\n    let page: Page<T> | null = this;\n    while (page) {\n      for (const item of page.items) yield item;\n      page = await page.getNextPage();\n    }\n  }\n}\n"]}

package/dist/core/sse.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Server-sent events over fetch. Parses the wire format incrementally from a
+ * ReadableStream — multi-line data, event names, comments, CRLF — with no
+ * dependencies. Each event's `data` is JSON-decoded to `T`.
+ */
+export interface ServerSentEvent<T> {
+    event: string | undefined;
+    data: T;
+    id: string | undefined;
+}
+export declare class Stream<T> implements AsyncIterable<T> {
+    private response;
+    private readonly signal?;
+    private readonly skipEvents;
+    private readonly reconnect?;
+    /**
+     * The resume checkpoint: seeded from the id this stream was resumed with,
+     * then updated by `id:` fields (persistent across events per the SSE
+     * spec). Pass it as `options.lastEventId` to resume after a disconnect.
+     */
+    lastEventId: string | undefined;
+    private releaseDeadline;
+    /** Server `retry:` hint (ms), used as the reconnection delay when set. */
+    private retryHintMs;
+    /** Stream-owned cancellation: close() trips it so backoff sleeps and
+     * in-flight reconnect handshakes settle immediately. */
+    private readonly closer;
+    private closed;
+    private consumed;
+    private activeReader;
+    constructor(response: Response, signal?: AbortSignal | undefined, resumedFrom?: string, skipEvents?: readonly string[], reconnect?: ((lastEventId: string | undefined, signal: AbortSignal) => Promise<Response>) | undefined);
+    /**
+     * Idempotent explicit close: cancels the underlying response body exactly
+     * once and detaches deadline state. Safe before iteration (an opened but
+     * never-iterated stream would otherwise hold its connection), during
+     * iteration from another control path, and after EOF.
+     */
+    close(): Promise<void>;
+    /** Iterate decoded event payloads. */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    /** Iterate full events (name + id + decoded data). */
+    events(): AsyncGenerator<ServerSentEvent<T>>;
+}
+//# sourceMappingURL=sse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/core/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CACxB;AAED,qBAAa,MAAM,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAmB9C,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAIxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAM3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IA7B7B;;;;OAIG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,OAAO,CAAC,eAAe,CAA2B;IAClD,0EAA0E;IAC1E,OAAO,CAAC,WAAW,CAAqB;IACxC;4DACwD;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAsD;gBAGhE,QAAQ,EAAE,QAAQ,EACT,MAAM,CAAC,EAAE,WAAW,YAAA,EACrC,WAAW,CAAC,EAAE,MAAM,EAGH,UAAU,GAAE,SAAS,MAAM,EAAO,EAMlC,SAAS,CAAC,GAAE,CAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,QAAQ,CAAC,aAAA;IAMxB;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B,sCAAsC;IAC/B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAMjD,sDAAsD;IAC/C,MAAM,IAAI,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAoPpD"}

package/dist/core/sse.js

@@ -0,0 +1,350 @@
+/**
+ * Server-sent events over fetch. Parses the wire format incrementally from a
+ * ReadableStream — multi-line data, event names, comments, CRLF — with no
+ * dependencies. Each event's `data` is JSON-decoded to `T`.
+ */
+import { APIConnectionError, APIResponseError, APIUserAbortError } from './error.js';
+import { takeStreamCleanup } from './http.js';
+export class Stream {
+    response;
+    signal;
+    skipEvents;
+    reconnect;
+    /**
+     * The resume checkpoint: seeded from the id this stream was resumed with,
+     * then updated by `id:` fields (persistent across events per the SSE
+     * spec). Pass it as `options.lastEventId` to resume after a disconnect.
+     */
+    lastEventId;
+    releaseDeadline;
+    /** Server `retry:` hint (ms), used as the reconnection delay when set. */
+    retryHintMs;
+    /** Stream-owned cancellation: close() trips it so backoff sleeps and
+     * in-flight reconnect handshakes settle immediately. */
+    closer = new AbortController();
+    closed = false;
+    consumed = false;
+    activeReader;
+    constructor(response, signal, resumedFrom, 
+    // Transport-housekeeping event names (`event:` field) skipped without
+    // decoding; their `id:` fields still advance the resume checkpoint.
+    skipEvents = [], 
+    // Re-issues the request with the current resume checkpoint. When set,
+    // a MID-STREAM transport drop reconnects automatically (like the
+    // platform's EventSource): bounded attempts, backoff honoring the
+    // server's `retry:` hint, counter reset once events flow again. A clean
+    // EOF, an explicit close(), and a caller abort NEVER reconnect.
+    reconnect) {
+        this.response = response;
+        this.signal = signal;
+        this.skipEvents = skipEvents;
+        this.reconnect = reconnect;
+        this.lastEventId = resumedFrom;
+        this.releaseDeadline = takeStreamCleanup(response);
+    }
+    /**
+     * Idempotent explicit close: cancels the underlying response body exactly
+     * once and detaches deadline state. Safe before iteration (an opened but
+     * never-iterated stream would otherwise hold its connection), during
+     * iteration from another control path, and after EOF.
+     */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.closer.abort();
+        if (this.activeReader) {
+            // The body is LOCKED to the active reader: body.cancel() would
+            // reject, silently doing nothing. Cancel the reader itself — the
+            // pending read() settles, the generator's finally runs the terminal
+            // cleanup (deadline release included), and the consumer unblocks.
+            try {
+                await this.activeReader.cancel();
+            }
+            catch {
+                // Reader already errored/released; the generator finally cleans up.
+            }
+            return;
+        }
+        // Pre-iteration close: no reader owns the body yet.
+        this.releaseDeadline?.();
+        try {
+            await this.response.body?.cancel();
+        }
+        catch {
+            // Already closed.
+        }
+    }
+    /** Iterate decoded event payloads. */
+    async *[Symbol.asyncIterator]() {
+        for await (const event of this.events()) {
+            yield event.data;
+        }
+    }
+    /** Iterate full events (name + id + decoded data). */
+    async *events() {
+        // One Stream wraps exactly one response body. The consumed transition
+        // is synchronous (before any await/getReader), so a competing second
+        // iterator — concurrent or after EOF/error — deterministically gets the
+        // stable SDK error instead of a raw locked-stream TypeError or a silent
+        // empty sequence. A closed-but-never-consumed stream still ends empty.
+        if (this.closed && !this.consumed)
+            return;
+        if (this.consumed) {
+            throw new Error('stream already consumed — reconnect with a new call passing { lastEventId: stream.lastEventId }');
+        }
+        this.consumed = true;
+        const firstBody = this.response.body;
+        if (!firstBody)
+            throw new Error('SSE response has no body');
+        // Connection-local: a reconnect swaps in a FRESH decoder, so a partial
+        // UTF-8 code point from the dead connection cannot corrupt the first
+        // resumed event.
+        let decoder = new TextDecoder();
+        let reader = firstBody.getReader();
+        this.activeReader = reader;
+        let buffer = '';
+        let dataLines = [];
+        let eventName;
+        // Consecutive failed reconnects; reset whenever a chunk arrives.
+        let reconnectAttempts = 0;
+        const MAX_RECONNECTS = 5;
+        // A mid-stream transport drop swaps in a fresh connection resumed from
+        // the checkpoint. Partial buffered lines from the dead connection are
+        // DISCARDED — the server re-sends everything after Last-Event-ID.
+        const tryReconnect = async () => {
+            while (this.reconnect && !this.closed && !this.signal?.aborted && reconnectAttempts < MAX_RECONNECTS) {
+                const delay = this.retryHintMs ?? Math.min(500 * 2 ** reconnectAttempts, 10_000);
+                reconnectAttempts++;
+                // Abortable sleep: BOTH the caller's signal and the stream's own
+                // closer wake it, and listeners are removed on every exit path so a
+                // long-lived flapping stream cannot accumulate them.
+                await new Promise((resolve) => {
+                    const finish = () => {
+                        clearTimeout(timer);
+                        this.signal?.removeEventListener('abort', finish);
+                        this.closer.signal.removeEventListener('abort', finish);
+                        resolve();
+                    };
+                    const timer = setTimeout(finish, delay);
+                    this.signal?.addEventListener('abort', finish);
+                    this.closer.signal.addEventListener('abort', finish);
+                });
+                if (this.closed || this.signal?.aborted)
+                    return false;
+                let next;
+                try {
+                    next = await this.reconnect(this.lastEventId, this.closer.signal);
+                }
+                catch (err) {
+                    if (this.closed)
+                        return false;
+                    // A TRANSPORT handshake failure (server restarting, connection
+                    // refused) consumes budget and retries; an HTTP-level failure
+                    // (e.g. expired credentials -> APIError) propagates immediately —
+                    // reconnecting cannot fix it and must not mask it.
+                    if (err instanceof APIConnectionError)
+                        continue;
+                    throw err;
+                }
+                if (this.closed) {
+                    void next.body?.cancel().catch(() => { });
+                    return false;
+                }
+                // Release the SUPERSEDED connection completely: cancel its reader
+                // (unlocking the old body) and its deadline cleanup, exactly once.
+                try {
+                    await reader.cancel();
+                }
+                catch {
+                    // Dead reader.
+                }
+                reader.releaseLock();
+                this.releaseDeadline?.();
+                this.response = next;
+                this.releaseDeadline = takeStreamCleanup(next);
+                const nextBody = next.body;
+                if (!nextBody)
+                    throw new Error('SSE response has no body');
+                reader = nextBody.getReader();
+                this.activeReader = reader;
+                buffer = '';
+                dataLines = [];
+                eventName = undefined;
+                decoder = new TextDecoder();
+                return true;
+            }
+            return false;
+        };
+        const flush = () => {
+            if (dataLines.length === 0)
+                return undefined;
+            const raw = dataLines.join('\n');
+            dataLines = [];
+            const name = eventName;
+            eventName = undefined;
+            // Housekeeping frames (e.g. ping/open) never reach the consumer and
+            // never JSON-decode - but their id: has already advanced the resume
+            // checkpoint above.
+            if (name !== undefined && this.skipEvents.includes(name))
+                return undefined;
+            let data;
+            try {
+                data = JSON.parse(raw);
+            }
+            catch (err) {
+                // Malformed event JSON is a PROTOCOL error, distinct from transport
+                // failure.
+                throw new APIResponseError(this.response.status, 'SSE event data is not valid JSON', err);
+            }
+            // Per the SSE spec the last-event-ID buffer persists across events
+            // until another `id:` field changes it (an empty one resets it).
+            return { event: name, data, id: this.lastEventId };
+        };
+        // WHATWG event streams terminate lines with LF, CRLF, OR bare CR; a CR
+        // at a chunk boundary must wait for the next chunk to see whether an LF
+        // follows (CRLF is one terminator, never two).
+        const nextLine = (atEof) => {
+            for (let i = 0; i < buffer.length; i++) {
+                const ch = buffer[i];
+                if (ch === '\n') {
+                    const line = buffer.slice(0, i);
+                    buffer = buffer.slice(i + 1);
+                    return line;
+                }
+                if (ch === '\r') {
+                    if (i + 1 < buffer.length) {
+                        const line = buffer.slice(0, i);
+                        buffer = buffer.slice(buffer[i + 1] === '\n' ? i + 2 : i + 1);
+                        return line;
+                    }
+                    if (atEof) {
+                        const line = buffer.slice(0, i);
+                        buffer = '';
+                        return line;
+                    }
+                    return null; // possible CRLF split across chunks
+                }
+            }
+            return null;
+        };
+        const processLine = (line) => {
+            if (line === '')
+                return flush();
+            if (line.startsWith(':'))
+                return undefined; // comment / keep-alive
+            const colonAt = line.indexOf(':');
+            const field = colonAt === -1 ? line : line.slice(0, colonAt);
+            let value = colonAt === -1 ? '' : line.slice(colonAt + 1);
+            if (value.startsWith(' '))
+                value = value.slice(1);
+            switch (field) {
+                case 'data':
+                    dataLines.push(value);
+                    break;
+                case 'event':
+                    eventName = value;
+                    break;
+                case 'id':
+                    // Per the event-stream algorithm, ids containing U+0000 are
+                    // ignored entirely; an empty id resets the buffer.
+                    if (!value.includes('\0')) {
+                        this.lastEventId = value === '' ? undefined : value;
+                    }
+                    break;
+                case 'retry':
+                    // Reconnection-delay hint; honored when auto-reconnect is active.
+                    if (/^[0-9]+$/.test(value))
+                        this.retryHintMs = Math.min(Number(value), 60_000);
+                    break;
+            }
+            return undefined;
+        };
+        try {
+            while (true) {
+                if (this.signal?.aborted)
+                    throw new APIUserAbortError();
+                let done;
+                let value;
+                try {
+                    ({ done, value } = await reader.read());
+                }
+                catch (err) {
+                    // A user abort mid-read surfaces as a raw AbortError DOMException;
+                    // the public contract is APIUserAbortError regardless of when the
+                    // abort lands. Partial buffered events are NOT flushed. Any other
+                    // read failure is a transport failure — auto-reconnect resumes
+                    // from the checkpoint when configured; otherwise the public
+                    // contract is APIConnectionError before AND after response
+                    // headers, never a runtime-specific error shape.
+                    if (this.signal?.aborted)
+                        throw new APIUserAbortError();
+                    if (this.closed)
+                        break;
+                    if (await tryReconnect())
+                        continue;
+                    if (this.closed || this.signal?.aborted)
+                        break;
+                    throw new APIConnectionError(err);
+                }
+                // Re-check AFTER every awaited read: a chunk that arrives
+                // concurrently with close() must not be processed.
+                if (this.closed)
+                    break;
+                if (done)
+                    break;
+                // Bytes flowing again: the reconnect budget is per-outage.
+                reconnectAttempts = 0;
+                buffer += decoder.decode(value, { stream: true });
+                let line;
+                while ((line = nextLine(false)) !== null) {
+                    const event = processLine(line);
+                    if (event)
+                        yield event;
+                }
+            }
+            // The stream may end without a trailing newline: the leftover buffer
+            // is still line data and must be parsed, not dropped.
+            buffer += decoder.decode();
+            let tail;
+            while ((tail = nextLine(true)) !== null) {
+                const event = processLine(tail);
+                if (event)
+                    yield event;
+            }
+            if (buffer !== '') {
+                const event = processLine(buffer);
+                if (event)
+                    yield event;
+            }
+            // Spec-compliant servers end with a blank line, but flush a trailing
+            // event if the stream closed without one.
+            const last = flush();
+            if (last)
+                yield last;
+        }
+        finally {
+            // EVERY terminal path — EOF, decode error, transport error, caller
+            // abort, explicit close, early consumer return — releases the
+            // deadline listener and the body exactly once.
+            this.closed = true;
+            this.activeReader = undefined;
+            this.releaseDeadline?.();
+            try {
+                await reader.cancel();
+            }
+            catch {
+                // Already cancelled/errored.
+            }
+            reader.releaseLock();
+            try {
+                // The CURRENT connection's body (reconnects swap this.response).
+                await this.response.body?.cancel();
+            }
+            catch {
+                // Already closed.
+            }
+        }
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/core/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/core/sse.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Server-sent events over fetch. Parses the wire format incrementally from a\n * ReadableStream — multi-line data, event names, comments, CRLF — with no\n * dependencies. Each event's `data` is JSON-decoded to `T`.\n */\n\nimport { APIConnectionError, APIResponseError, APIUserAbortError } from './error.js';\nimport { takeStreamCleanup } from './http.js';\n\nexport interface ServerSentEvent<T> {\n  event: string | undefined;\n  data: T;\n  id: string | undefined;\n}\n\nexport class Stream<T> implements AsyncIterable<T> {\n  /**\n   * The resume checkpoint: seeded from the id this stream was resumed with,\n   * then updated by `id:` fields (persistent across events per the SSE\n   * spec). Pass it as `options.lastEventId` to resume after a disconnect.\n   */\n  lastEventId: string | undefined;\n\n  private releaseDeadline: (() => void) | undefined;\n  /** Server `retry:` hint (ms), used as the reconnection delay when set. */\n  private retryHintMs: number | undefined;\n  /** Stream-owned cancellation: close() trips it so backoff sleeps and\n   * in-flight reconnect handshakes settle immediately. */\n  private readonly closer = new AbortController();\n  private closed = false;\n  private consumed = false;\n  private activeReader: ReadableStreamDefaultReader<Uint8Array> | undefined;\n\n  constructor(\n    private response: Response,\n    private readonly signal?: AbortSignal,\n    resumedFrom?: string,\n    // Transport-housekeeping event names (`event:` field) skipped without\n    // decoding; their `id:` fields still advance the resume checkpoint.\n    private readonly skipEvents: readonly string[] = [],\n    // Re-issues the request with the current resume checkpoint. When set,\n    // a MID-STREAM transport drop reconnects automatically (like the\n    // platform's EventSource): bounded attempts, backoff honoring the\n    // server's `retry:` hint, counter reset once events flow again. A clean\n    // EOF, an explicit close(), and a caller abort NEVER reconnect.\n    private readonly reconnect?: (\n      lastEventId: string | undefined,\n      signal: AbortSignal,\n    ) => Promise<Response>,\n  ) {\n    this.lastEventId = resumedFrom;\n    this.releaseDeadline = takeStreamCleanup(response);\n  }\n\n  /**\n   * Idempotent explicit close: cancels the underlying response body exactly\n   * once and detaches deadline state. Safe before iteration (an opened but\n   * never-iterated stream would otherwise hold its connection), during\n   * iteration from another control path, and after EOF.\n   */\n  async close(): Promise<void> {\n    if (this.closed) return;\n    this.closed = true;\n    this.closer.abort();\n    if (this.activeReader) {\n      // The body is LOCKED to the active reader: body.cancel() would\n      // reject, silently doing nothing. Cancel the reader itself — the\n      // pending read() settles, the generator's finally runs the terminal\n      // cleanup (deadline release included), and the consumer unblocks.\n      try {\n        await this.activeReader.cancel();\n      } catch {\n        // Reader already errored/released; the generator finally cleans up.\n      }\n      return;\n    }\n    // Pre-iteration close: no reader owns the body yet.\n    this.releaseDeadline?.();\n    try {\n      await this.response.body?.cancel();\n    } catch {\n      // Already closed.\n    }\n  }\n\n  /** Iterate decoded event payloads. */\n  async *[Symbol.asyncIterator](): AsyncIterator<T> {\n    for await (const event of this.events()) {\n      yield event.data;\n    }\n  }\n\n  /** Iterate full events (name + id + decoded data). */\n  async *events(): AsyncGenerator<ServerSentEvent<T>> {\n    // One Stream wraps exactly one response body. The consumed transition\n    // is synchronous (before any await/getReader), so a competing second\n    // iterator — concurrent or after EOF/error — deterministically gets the\n    // stable SDK error instead of a raw locked-stream TypeError or a silent\n    // empty sequence. A closed-but-never-consumed stream still ends empty.\n    if (this.closed && !this.consumed) return;\n    if (this.consumed) {\n      throw new Error(\n        'stream already consumed — reconnect with a new call passing { lastEventId: stream.lastEventId }',\n      );\n    }\n    this.consumed = true;\n    const firstBody = this.response.body;\n    if (!firstBody) throw new Error('SSE response has no body');\n    // Connection-local: a reconnect swaps in a FRESH decoder, so a partial\n    // UTF-8 code point from the dead connection cannot corrupt the first\n    // resumed event.\n    let decoder = new TextDecoder();\n    let reader = firstBody.getReader();\n    this.activeReader = reader;\n    let buffer = '';\n    let dataLines: string[] = [];\n    let eventName: string | undefined;\n    // Consecutive failed reconnects; reset whenever a chunk arrives.\n    let reconnectAttempts = 0;\n    const MAX_RECONNECTS = 5;\n\n    // A mid-stream transport drop swaps in a fresh connection resumed from\n    // the checkpoint. Partial buffered lines from the dead connection are\n    // DISCARDED — the server re-sends everything after Last-Event-ID.\n    const tryReconnect = async (): Promise<boolean> => {\n      while (this.reconnect && !this.closed && !this.signal?.aborted && reconnectAttempts < MAX_RECONNECTS) {\n        const delay = this.retryHintMs ?? Math.min(500 * 2 ** reconnectAttempts, 10_000);\n        reconnectAttempts++;\n        // Abortable sleep: BOTH the caller's signal and the stream's own\n        // closer wake it, and listeners are removed on every exit path so a\n        // long-lived flapping stream cannot accumulate them.\n        await new Promise<void>((resolve) => {\n          const finish = () => {\n            clearTimeout(timer);\n            this.signal?.removeEventListener('abort', finish);\n            this.closer.signal.removeEventListener('abort', finish);\n            resolve();\n          };\n          const timer = setTimeout(finish, delay);\n          this.signal?.addEventListener('abort', finish);\n          this.closer.signal.addEventListener('abort', finish);\n        });\n        if (this.closed || this.signal?.aborted) return false;\n        let next: Response;\n        try {\n          next = await this.reconnect(this.lastEventId, this.closer.signal);\n        } catch (err) {\n          if (this.closed) return false;\n          // A TRANSPORT handshake failure (server restarting, connection\n          // refused) consumes budget and retries; an HTTP-level failure\n          // (e.g. expired credentials -> APIError) propagates immediately —\n          // reconnecting cannot fix it and must not mask it.\n          if (err instanceof APIConnectionError) continue;\n          throw err;\n        }\n        if (this.closed) {\n          void next.body?.cancel().catch(() => {});\n          return false;\n        }\n        // Release the SUPERSEDED connection completely: cancel its reader\n        // (unlocking the old body) and its deadline cleanup, exactly once.\n        try {\n          await reader.cancel();\n        } catch {\n          // Dead reader.\n        }\n        reader.releaseLock();\n        this.releaseDeadline?.();\n        this.response = next;\n        this.releaseDeadline = takeStreamCleanup(next);\n        const nextBody = next.body;\n        if (!nextBody) throw new Error('SSE response has no body');\n        reader = nextBody.getReader();\n        this.activeReader = reader;\n        buffer = '';\n        dataLines = [];\n        eventName = undefined;\n        decoder = new TextDecoder();\n        return true;\n      }\n      return false;\n    };\n\n    const flush = (): ServerSentEvent<T> | undefined => {\n      if (dataLines.length === 0) return undefined;\n      const raw = dataLines.join('\\n');\n      dataLines = [];\n      const name = eventName;\n      eventName = undefined;\n      // Housekeeping frames (e.g. ping/open) never reach the consumer and\n      // never JSON-decode - but their id: has already advanced the resume\n      // checkpoint above.\n      if (name !== undefined && this.skipEvents.includes(name)) return undefined;\n      let data: T;\n      try {\n        data = JSON.parse(raw) as T;\n      } catch (err) {\n        // Malformed event JSON is a PROTOCOL error, distinct from transport\n        // failure.\n        throw new APIResponseError(this.response.status, 'SSE event data is not valid JSON', err);\n      }\n      // Per the SSE spec the last-event-ID buffer persists across events\n      // until another `id:` field changes it (an empty one resets it).\n      return { event: name, data, id: this.lastEventId };\n    };\n\n    // WHATWG event streams terminate lines with LF, CRLF, OR bare CR; a CR\n    // at a chunk boundary must wait for the next chunk to see whether an LF\n    // follows (CRLF is one terminator, never two).\n    const nextLine = (atEof: boolean): string | null => {\n      for (let i = 0; i < buffer.length; i++) {\n        const ch = buffer[i];\n        if (ch === '\\n') {\n          const line = buffer.slice(0, i);\n          buffer = buffer.slice(i + 1);\n          return line;\n        }\n        if (ch === '\\r') {\n          if (i + 1 < buffer.length) {\n            const line = buffer.slice(0, i);\n            buffer = buffer.slice(buffer[i + 1] === '\\n' ? i + 2 : i + 1);\n            return line;\n          }\n          if (atEof) {\n            const line = buffer.slice(0, i);\n            buffer = '';\n            return line;\n          }\n          return null; // possible CRLF split across chunks\n        }\n      }\n      return null;\n    };\n\n    const processLine = (line: string): ServerSentEvent<T> | undefined => {\n      if (line === '') return flush();\n      if (line.startsWith(':')) return undefined; // comment / keep-alive\n\n      const colonAt = line.indexOf(':');\n      const field = colonAt === -1 ? line : line.slice(0, colonAt);\n      let value = colonAt === -1 ? '' : line.slice(colonAt + 1);\n      if (value.startsWith(' ')) value = value.slice(1);\n\n      switch (field) {\n        case 'data':\n          dataLines.push(value);\n          break;\n        case 'event':\n          eventName = value;\n          break;\n        case 'id':\n          // Per the event-stream algorithm, ids containing U+0000 are\n          // ignored entirely; an empty id resets the buffer.\n          if (!value.includes('\\0')) {\n            this.lastEventId = value === '' ? undefined : value;\n          }\n          break;\n        case 'retry':\n          // Reconnection-delay hint; honored when auto-reconnect is active.\n          if (/^[0-9]+$/.test(value)) this.retryHintMs = Math.min(Number(value), 60_000);\n          break;\n      }\n      return undefined;\n    };\n\n    try {\n      while (true) {\n        if (this.signal?.aborted) throw new APIUserAbortError();\n        let done: boolean;\n        let value: Uint8Array | undefined;\n        try {\n          ({ done, value } = await reader.read());\n        } catch (err) {\n          // A user abort mid-read surfaces as a raw AbortError DOMException;\n          // the public contract is APIUserAbortError regardless of when the\n          // abort lands. Partial buffered events are NOT flushed. Any other\n          // read failure is a transport failure — auto-reconnect resumes\n          // from the checkpoint when configured; otherwise the public\n          // contract is APIConnectionError before AND after response\n          // headers, never a runtime-specific error shape.\n          if (this.signal?.aborted) throw new APIUserAbortError();\n          if (this.closed) break;\n          if (await tryReconnect()) continue;\n          if (this.closed || this.signal?.aborted) break;\n          throw new APIConnectionError(err);\n        }\n        // Re-check AFTER every awaited read: a chunk that arrives\n        // concurrently with close() must not be processed.\n        if (this.closed) break;\n        if (done) break;\n        // Bytes flowing again: the reconnect budget is per-outage.\n        reconnectAttempts = 0;\n        buffer += decoder.decode(value, { stream: true });\n\n        let line: string | null;\n        while ((line = nextLine(false)) !== null) {\n          const event = processLine(line);\n          if (event) yield event;\n        }\n      }\n      // The stream may end without a trailing newline: the leftover buffer\n      // is still line data and must be parsed, not dropped.\n      buffer += decoder.decode();\n      let tail: string | null;\n      while ((tail = nextLine(true)) !== null) {\n        const event = processLine(tail);\n        if (event) yield event;\n      }\n      if (buffer !== '') {\n        const event = processLine(buffer);\n        if (event) yield event;\n      }\n      // Spec-compliant servers end with a blank line, but flush a trailing\n      // event if the stream closed without one.\n      const last = flush();\n      if (last) yield last;\n    } finally {\n      // EVERY terminal path — EOF, decode error, transport error, caller\n      // abort, explicit close, early consumer return — releases the\n      // deadline listener and the body exactly once.\n      this.closed = true;\n      this.activeReader = undefined;\n      this.releaseDeadline?.();\n      try {\n        await reader.cancel();\n      } catch {\n        // Already cancelled/errored.\n      }\n      reader.releaseLock();\n      try {\n        // The CURRENT connection's body (reconnects swap this.response).\n        await this.response.body?.cancel();\n      } catch {\n        // Already closed.\n      }\n    }\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { CadenyaWidgets, CadenyaWidgets as default } from './client.js';
+export type { ClientOptions } from './client.js';
+export { APIError, APIConnectionError, APIUserAbortError, APIRequestError, APIResponseError, APITimeoutError } from './core/error.js';
+export type { RequestOptions } from './core/http.js';
+export { APIPromise } from './core/http.js';
+export { Page } from './core/pagination.js';
+export { Stream } from './core/sse.js';
+export type { ServerSentEvent } from './core/sse.js';
+export * from './types.js';
+export * from './resources/config.js';
+export * from './resources/conversations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtI,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// Generated by redwood. Do not edit by hand.
+export { CadenyaWidgets, CadenyaWidgets as default } from './client.js';
+export { APIError, APIConnectionError, APIUserAbortError, APIRequestError, APIResponseError, APITimeoutError } from './core/error.js';
+export { APIPromise } from './core/http.js';
+export { Page } from './core/pagination.js';
+export { Stream } from './core/sse.js';
+export * from './types.js';
+export * from './resources/config.js';
+export * from './resources/conversations.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,cAAc,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtI,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nexport { CadenyaWidgets, CadenyaWidgets as default } from './client.js';\nexport type { ClientOptions } from './client.js';\nexport { APIError, APIConnectionError, APIUserAbortError, APIRequestError, APIResponseError, APITimeoutError } from './core/error.js';\nexport type { RequestOptions } from './core/http.js';\nexport { APIPromise } from './core/http.js';\nexport { Page } from './core/pagination.js';\nexport { Stream } from './core/sse.js';\nexport type { ServerSentEvent } from './core/sse.js';\nexport * from './types.js';\nexport * from './resources/config.js';\nexport * from './resources/conversations.js';\n"]}

package/dist/resources/config.d.ts

@@ -0,0 +1,16 @@
+import { HttpClient, RequestOptions, APIPromise } from '../core/http.js';
+import type { WidgetConfig } from '../types.js';
+export declare class Config {
+    private readonly _client;
+    constructor(_client: HttpClient);
+    /**
+     * Get widget config
+     *
+     * @example
+     * ```ts
+     * const widgetConfig = await client.config.retrieveWidget();
+     * ```
+     */
+    retrieveWidget(options?: RequestOptions): APIPromise<WidgetConfig>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/resources/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/resources/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,UAAU;IAEhD;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;CAKnE"}

package/dist/resources/config.js

@@ -0,0 +1,21 @@
+// Generated by redwood. Do not edit by hand.
+export class Config {
+    _client;
+    constructor(_client) {
+        this._client = _client;
+    }
+    /**
+     * Get widget config
+     *
+     * @example
+     * ```ts
+     * const widgetConfig = await client.config.retrieveWidget();
+     * ```
+     */
+    retrieveWidget(options) {
+        return this._client.requestAPI(() => {
+            return { method: 'GET', path: `/v1/config` };
+        }, options);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/resources/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/resources/config.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAK7C,MAAM,OAAO,MAAM;IACY;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,cAAc,CAAC,OAAwB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAe,GAAG,EAAE;YAChD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAC/C,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;CACF","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { HttpClient, RequestOptions, APIPromise } from '../core/http.js';\nimport type { WidgetConfig } from '../types.js';\n\nexport class Config {\n  constructor(private readonly _client: HttpClient) {}\n\n  /**\n   * Get widget config\n   * \n   * @example\n   * ```ts\n   * const widgetConfig = await client.config.retrieveWidget();\n   * ```\n   */\n  retrieveWidget(options?: RequestOptions): APIPromise<WidgetConfig> {\n    return this._client.requestAPI<WidgetConfig>(() => {\n      return { method: 'GET', path: `/v1/config` };\n    }, options);\n  }\n}\n"]}