axios-eventsource 0.1.0

package/README.md

@@ -0,0 +1,139 @@
+# axios-eventsource
+
+[![NPM Package][npm]][npm-url]
+[![NPM Downloads][npm-downloads]][npmtrends-url]
+[![Tests][tests-badge]][tests-url]
+[![Coverage][coverage-badge]][coverage-url]
+
+Server-Sent Events (SSE) for Axios — one HTTP client for your whole app.
+
+Native `EventSource` only supports GET and can’t send custom headers (e.g. Auth tokens). Workarounds — like fetching a one-time token with Axios and passing it in the URL — are brittle. This library gives you real SSE over your existing Axios setup: same interceptors, same auth, same base URL and headers, with an API that matches the native `EventSource` where it matters.
+
+## Why use this
+
+- **One stack**: Use your existing Axios instance for both REST and SSE — no separate `EventSource` or fetch-based streaming.
+- **Auth and headers**: Send `Authorization`, API keys, or any headers via interceptors or built-in `auth` options. No URL token hacks.
+- **Familiar API**: `onopen`, `onmessage`, `onerror`, `addEventListener`, `readyState`, and `close()` work like native `EventSource`.
+- **Production behavior**: Automatic reconnects with exponential backoff, `Last-Event-ID` replay, and server `retry:` support.
+- **Everywhere**: Browser (with fetch adapter) and Node.js 18+.
+
+## Install
+
+```sh
+pnpm add axios-eventsource axios
+```
+
+## Quick Start
+
+```ts
+import axios from "axios";
+import { axiosEventSource } from "axios-eventsource";
+
+const client = axios.create({
+  baseURL: "https://api.example.com",
+});
+
+const stream = axiosEventSource(client, "/events", {
+  reconnect: { initialDelayMs: 1_000, maxDelayMs: 30_000 },
+  onopen: (event) => {
+    console.log("SSE connected, type:", event.type);
+  },
+  onerror: (event) => {
+    console.error("SSE error:", event.error);
+  },
+});
+
+stream.onmessage = (event) => {
+  console.log("message:", event.data, "lastEventId:", event.lastEventId);
+};
+
+stream.addEventListener("tick", (event) => {
+  const payload = JSON.parse(event.data) as { count: number };
+  console.log("tick:", payload.count);
+});
+
+// Later
+// stream.close();
+```
+
+## Authentication
+
+Use the same Axios client and interceptors you already have:
+
+```ts
+const client = axios.create();
+client.interceptors.request.use(async (config) => {
+  config.headers.Authorization = `Bearer ${await getFreshAccessToken()}`;
+  return config;
+});
+const stream = axiosEventSource(client, "https://api.example.com/sse");
+```
+
+Or use built-in auth so you don’t need a pre-configured instance:
+
+```ts
+axiosEventSource("https://api.example.com/sse", {
+  auth: { type: "bearer", token: async () => getFreshAccessToken() },
+});
+
+// Or: auth: { type: "none" } | { type: "basic", username, password }
+```
+
+## EventSource parity and behavior
+
+The client follows the SSE spec and native `EventSource` semantics where possible:
+
+- **`Last-Event-ID`**: Stored and sent on reconnect so the server can resume.
+- **Server `retry:`**: Reconnect delay can be overridden by the server.
+- **MessageEvent-like events**: Each event has `type`, `data`, `origin`, `lastEventId`, `source`, `ports`.
+- **Lifecycle**: `open` and `error` via `addEventListener`; `once` and `handleEvent` object listeners supported.
+- **EventTarget**: The returned instance extends `EventTarget`; `url`, `readyState` (CONNECTING/OPEN/CLOSED), and `close()` behave like native.
+
+Additional options: configurable reconnect backoff (`initialDelayMs`, `maxDelayMs`), optional `reconnect.maxRetries`, `encoding` (default UTF-8), and `rejectNonEventStream` (default `true`) to reject non–`text/event-stream` responses. Full TypeScript types are exported.
+
+## API overview
+
+- **`axiosEventSource(axiosInstance, url, options?)`** or **`axiosEventSource(url, options?)`** — returns an `EventTarget`-like stream.
+- **Properties**: `readyState`, `url`, `withCredentials`; **callbacks**: `onopen`, `onmessage`, `onerror`.
+- **Methods**: `addEventListener(type, listener, options?)`, `removeEventListener(type, listener)`, `close()`.
+- **Options**: Any Axios request config (method, headers, etc.) plus `auth`, `reconnect`, `encoding`, `rejectNonEventStream`, `signal`, `withCredentials`, `onopen`, `onerror`.
+
+Constants `CONNECTING`, `OPEN`, `CLOSED` and the `SseErrorEvent` class are exported; types such as `AxiosEventSourceOptions`, `SseMessageEvent`, and `AuthStrategy` are available for TypeScript.
+
+### Differences from native `EventSource`
+
+| Area | Native `EventSource` | `axios-eventsource` |
+| :--- | :--- | :--- |
+| Constructor | `new EventSource(url)` | `axiosEventSource(client, url, opts)` |
+| `onerror` | Bare `Event` | `SseErrorEvent` with `.error` for the real failure |
+| Transport | Browser built-in | Axios + fetch adapter (interceptors, auth, Node.js) |
+| Custom headers / POST | No | Yes |
+
+### Requirements
+
+- **Adapter**: Uses Axios with the fetch adapter; response body must be a `ReadableStream<Uint8Array>`.
+- **Node**: Node 18+ for `EventTarget` and `MessageEvent`.
+- **Reconnect**: Runs until `close()` or `signal` abort, unless `reconnect.maxRetries` is set.
+
+## Local Development
+
+```sh
+pnpm install
+pnpm dev
+pnpm test
+```
+
+`pnpm dev` runs the library in watch mode, Express and Fastify SSE demos, and a demo site. See the repo for layout (`packages/axios-eventsource`, `examples/`, etc.).
+
+## Author
+
+[Ben Houston](https://benhouston3d.com), Sponsored by [Land of Assets](https://landofassets.com)
+
+[npm]: https://img.shields.io/npm/v/axios-eventsource
+[npm-url]: https://www.npmjs.com/package/axios-eventsource
+[npm-downloads]: https://img.shields.io/npm/dw/axios-eventsource
+[npmtrends-url]: https://www.npmtrends.com/axios-eventsource
+[tests-badge]: https://github.com/bhouston/axios-eventsource/workflows/Tests/badge.svg
+[tests-url]: https://github.com/bhouston/axios-eventsource/actions/workflows/test.yml
+[coverage-badge]: https://codecov.io/gh/bhouston/axios-eventsource/branch/main/graph/badge.svg
+[coverage-url]: https://codecov.io/gh/bhouston/axios-eventsource

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { type AxiosInstance } from "axios";
+import type { AxiosEventSourceFactory, AxiosEventSourceOptions, AxiosEventSourceReadyState, SseErrorEventPayload, SseEvent, SseMessageEvent } from "./types.js";
+/** ReadyState constant: connection not yet open. */
+export declare const CONNECTING: 0;
+/** ReadyState constant: connection is open. */
+export declare const OPEN: 1;
+/** ReadyState constant: connection is closed. */
+export declare const CLOSED: 2;
+/**
+ * Error event with an .error property for the underlying failure.
+ * Dispatched when the connection fails or encounters an error.
+ */
+export declare class SseErrorEvent extends Event {
+    readonly error: unknown;
+    constructor(error: unknown);
+}
+/**
+ * SSE client that extends EventTarget and matches the EventSource API surface.
+ * Uses Axios for the request so interceptors, auth, and config are reused.
+ */
+export declare class AxiosEventSource extends EventTarget {
+    private readonly _client;
+    private readonly _options;
+    readonly withCredentials: boolean;
+    private _readyState;
+    private _url;
+    private _initialUrl;
+    private _origin;
+    private _abortController;
+    private _onopen;
+    private _onmessage;
+    private _onerror;
+    constructor(_client: AxiosInstance, url: string, _options?: AxiosEventSourceOptions);
+    get readyState(): AxiosEventSourceReadyState;
+    get url(): string;
+    get onopen(): ((event: SseEvent) => void) | null;
+    set onopen(value: ((event: SseEvent) => void) | null);
+    get onmessage(): ((event: SseMessageEvent) => void) | null;
+    set onmessage(value: ((event: SseMessageEvent) => void) | null);
+    get onerror(): ((event: SseErrorEventPayload) => void) | null;
+    set onerror(value: ((event: SseErrorEventPayload) => void) | null);
+    close(): void;
+    /** Called by the factory to start the connection loop. */
+    _start(): void;
+}
+export declare const axiosEventSource: AxiosEventSourceFactory;
+export type { AddEventListenerOptions, AuthStrategy, AxiosEventSourceLike, AxiosEventSourceOptions, ReconnectOptions, SseErrorEventPayload, SseEvent, SseEventListener, SseMessageEvent, } from "./types.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":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAmD,MAAM,OAAO,CAAC;AAGnG,OAAO,KAAK,EACV,uBAAuB,EAEvB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,QAAQ,EACR,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,oDAAoD;AACpD,eAAO,MAAM,UAAU,EAAG,CAAU,CAAC;AACrC,+CAA+C;AAC/C,eAAO,MAAM,IAAI,EAAG,CAAU,CAAC;AAC/B,iDAAiD;AACjD,eAAO,MAAM,MAAM,EAAG,CAAU,CAAC;AAMjC;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBACZ,KAAK,EAAE,OAAO;CAI3B;AA8DD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAY7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAb3B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,WAAW,CAAsD;IACzE,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,UAAU,CAAmD;IACrE,OAAO,CAAC,QAAQ,CAAwD;gBAGrD,OAAO,EAAE,aAAa,EACvC,GAAG,EAAE,MAAM,EACM,QAAQ,GAAE,uBAA4B;IAWzD,IAAI,UAAU,IAAI,0BAA0B,CAE3C;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,CAE/C;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,EAEnD;IAED,IAAI,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,IAAI,CAEzD;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,IAAI,EAE7D;IAED,IAAI,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC,GAAG,IAAI,CAE5D;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC,GAAG,IAAI,EAEhE;IAED,KAAK,IAAI,IAAI;IAOb,0DAA0D;IAC1D,MAAM,IAAI,IAAI;CAqIf;AAED,eAAO,MAAM,gBAAgB,EAAE,uBAc9B,CAAC;AAEF,YAAY,EACV,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,243 @@
+import axios from "axios";
+import { parseSseStream } from "./parseSseStream.js";
+import { getNextDelay, getReconnectConfig, sleepWithAbort } from "./reconnect.js";
+/** ReadyState constant: connection not yet open. */
+export const CONNECTING = 0;
+/** ReadyState constant: connection is open. */
+export const OPEN = 1;
+/** ReadyState constant: connection is closed. */
+export const CLOSED = 2;
+const READY_STATE_CONNECTING = CONNECTING;
+const READY_STATE_OPEN = OPEN;
+const READY_STATE_CLOSED = CLOSED;
+/**
+ * Error event with an .error property for the underlying failure.
+ * Dispatched when the connection fails or encounters an error.
+ */
+export class SseErrorEvent extends Event {
+    error;
+    constructor(error) {
+        super("error");
+        this.error = error;
+    }
+}
+function isAxiosInstance(value) {
+    const candidate = value;
+    return ((typeof value === "function" || (typeof value === "object" && value !== null)) &&
+        typeof candidate.request === "function" &&
+        typeof candidate.get === "function");
+}
+function toBase64(value) {
+    if (typeof btoa === "function") {
+        return btoa(value);
+    }
+    return Buffer.from(value).toString("base64");
+}
+async function resolveAuthHeaders(options) {
+    const auth = options?.auth;
+    if (!auth || auth.type === "none") {
+        return {};
+    }
+    if (auth.type === "basic") {
+        const token = toBase64(`${auth.username}:${auth.password}`);
+        return { Authorization: `Basic ${token}` };
+    }
+    const token = typeof auth.token === "function" ? await auth.token() : auth.token;
+    return token ? { Authorization: `Bearer ${token}` } : {};
+}
+function getOrigin(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return "";
+    }
+}
+/** Try to get the final URL from the response (e.g. after redirects). */
+function getResponseUrl(response) {
+    const r = response;
+    if (typeof r.url === "string")
+        return r.url;
+    if (typeof r.request?.responseURL === "string")
+        return r.request.responseURL;
+    if (typeof r.request?.url === "string")
+        return r.request.url;
+    return undefined;
+}
+function isEventStreamResponse(response) {
+    const ct = response.headers?.["content-type"];
+    if (typeof ct !== "string")
+        return false;
+    const base = ct.split(";")[0]?.trim().toLowerCase() ?? "";
+    return base === "text/event-stream";
+}
+/**
+ * SSE client that extends EventTarget and matches the EventSource API surface.
+ * Uses Axios for the request so interceptors, auth, and config are reused.
+ */
+export class AxiosEventSource extends EventTarget {
+    _client;
+    _options;
+    withCredentials;
+    _readyState = READY_STATE_CONNECTING;
+    _url;
+    _initialUrl;
+    _origin;
+    _abortController = new AbortController();
+    _onopen = null;
+    _onmessage = null;
+    _onerror = null;
+    constructor(_client, url, _options = {}) {
+        super();
+        this._client = _client;
+        this._options = _options;
+        this._initialUrl = url;
+        this._url = url;
+        this._origin = getOrigin(url);
+        this.withCredentials = _options.withCredentials ?? false;
+        this._onopen = _options.onopen ?? null;
+        this._onerror = _options.onerror ?? null;
+    }
+    get readyState() {
+        return this._readyState;
+    }
+    get url() {
+        return this._url;
+    }
+    get onopen() {
+        return this._onopen;
+    }
+    set onopen(value) {
+        this._onopen = value;
+    }
+    get onmessage() {
+        return this._onmessage;
+    }
+    set onmessage(value) {
+        this._onmessage = value;
+    }
+    get onerror() {
+        return this._onerror;
+    }
+    set onerror(value) {
+        this._onerror = value;
+    }
+    close() {
+        if (!this._abortController.signal.aborted) {
+            this._abortController.abort();
+        }
+        this._readyState = READY_STATE_CLOSED;
+    }
+    /** Called by the factory to start the connection loop. */
+    _start() {
+        const options = this._options;
+        const reconnect = getReconnectConfig(options.reconnect);
+        const rejectNonEventStream = options.rejectNonEventStream !== false;
+        const encoding = options.encoding ?? "utf-8";
+        const { auth: _ignoredAuth, method: _ignoredMethod, reconnect: _ignoredReconnect, onopen: _ignoredOnopen, onerror: _ignoredOnerror, encoding: _ignoredEncoding, rejectNonEventStream: _ignoredReject, ...requestOptions } = options;
+        const method = options.method ?? "GET";
+        const url = this._initialUrl;
+        // If external signal is already aborted, close immediately.
+        if (options.signal?.aborted) {
+            this.close();
+            return;
+        }
+        options.signal?.addEventListener("abort", () => this.close(), { once: true });
+        const connect = async () => {
+            let lastEventId = "";
+            let baseReconnectDelay = reconnect.initialDelayMs;
+            let reconnectDelay = baseReconnectDelay;
+            let retryCount = 0;
+            while (!this._abortController.signal.aborted) {
+                try {
+                    const authHeaders = await resolveAuthHeaders(options);
+                    const response = await this._client.request({
+                        method,
+                        url,
+                        ...requestOptions,
+                        headers: {
+                            Accept: "text/event-stream",
+                            "Cache-Control": "no-cache",
+                            ...(options.headers ?? {}),
+                            ...authHeaders,
+                            ...(lastEventId !== "" ? { "Last-Event-ID": lastEventId } : {}),
+                        },
+                        responseType: "stream",
+                        adapter: "fetch",
+                        decompress: false,
+                        signal: this._abortController.signal,
+                    });
+                    if (response.status !== 200) {
+                        throw new Error(`Unexpected status code: ${response.status}`);
+                    }
+                    if (rejectNonEventStream && !isEventStreamResponse(response)) {
+                        throw new Error(`Expected Content-Type text/event-stream, got ${response.headers?.["content-type"] ?? "unknown"}`);
+                    }
+                    const responseUrl = getResponseUrl(response);
+                    if (responseUrl !== undefined) {
+                        this._url = responseUrl;
+                        this._origin = getOrigin(responseUrl);
+                    }
+                    this._readyState = READY_STATE_OPEN;
+                    reconnectDelay = baseReconnectDelay;
+                    retryCount = 0;
+                    const openEvent = new Event("open");
+                    this.dispatchEvent(openEvent);
+                    this._onopen?.(openEvent);
+                    for await (const parsed of parseSseStream(response.data, {
+                        onRetry: (ms) => {
+                            baseReconnectDelay = ms;
+                            reconnectDelay = ms;
+                        },
+                    }, encoding)) {
+                        if (this._abortController.signal.aborted) {
+                            return;
+                        }
+                        lastEventId = parsed.lastEventId;
+                        const messageEvent = new MessageEvent(parsed.type, {
+                            data: parsed.data,
+                            origin: this._origin,
+                            lastEventId: parsed.lastEventId,
+                        });
+                        if (parsed.type === "message") {
+                            this._onmessage?.(messageEvent);
+                        }
+                        this.dispatchEvent(messageEvent);
+                    }
+                }
+                catch (error) {
+                    if (this._abortController.signal.aborted) {
+                        return;
+                    }
+                    retryCount += 1;
+                    const errorEvent = new SseErrorEvent(error);
+                    this.dispatchEvent(errorEvent);
+                    this._onerror?.(errorEvent);
+                }
+                if (this._abortController.signal.aborted) {
+                    return;
+                }
+                const maxRetries = reconnect.maxRetries;
+                if (maxRetries !== undefined && retryCount >= maxRetries) {
+                    this.close();
+                    return;
+                }
+                this._readyState = READY_STATE_CONNECTING;
+                await sleepWithAbort(reconnectDelay, this._abortController.signal);
+                reconnectDelay = getNextDelay(reconnectDelay, reconnect.maxDelayMs);
+            }
+        };
+        void connect();
+    }
+}
+export const axiosEventSource = (clientOrUrl, urlOrOptions, maybeOptions) => {
+    const client = isAxiosInstance(clientOrUrl) ? clientOrUrl : axios.create();
+    const url = isAxiosInstance(clientOrUrl) ? urlOrOptions : clientOrUrl;
+    const options = isAxiosInstance(clientOrUrl)
+        ? maybeOptions
+        : urlOrOptions;
+    const instance = new AxiosEventSource(client, url, options);
+    instance._start();
+    return instance;
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/parseSseStream.d.ts

@@ -0,0 +1,10 @@
+export type ParsedSseEvent = {
+    type: string;
+    data: string;
+    lastEventId: string;
+};
+export type ParseSseStreamCallbacks = {
+    onRetry?: (delayMs: number) => void;
+};
+export declare function parseSseStream(stream: ReadableStream<Uint8Array>, callbacks?: ParseSseStreamCallbacks, encoding?: string): AsyncGenerator<ParsedSseEvent>;
+//# sourceMappingURL=parseSseStream.d.ts.map

package/dist/parseSseStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSseStream.d.ts","sourceRoot":"","sources":["../src/parseSseStream.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAuB,cAAc,CACnC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,SAAS,CAAC,EAAE,uBAAuB,EACnC,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAAC,cAAc,CAAC,CAqDhC"}

package/dist/parseSseStream.js

@@ -0,0 +1,55 @@
+import { createParser } from "eventsource-parser";
+export async function* parseSseStream(stream, callbacks, encoding) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder(encoding ?? "utf-8");
+    const queue = [];
+    // lastEventId accumulates across events per the SSE spec: if no id: is present
+    // in an event block, the event inherits the most recently seen id.
+    let accumulatedLastEventId = "";
+    const parser = createParser({
+        onEvent(event) {
+            if (event.id !== undefined) {
+                accumulatedLastEventId = event.id;
+            }
+            // Default to "message" only when event field is absent (undefined). Empty string is passed through.
+            const type = event.event === undefined ? "message" : event.event;
+            queue.push({
+                type,
+                data: event.data,
+                lastEventId: accumulatedLastEventId,
+            });
+        },
+        onRetry(interval) {
+            callbacks?.onRetry?.(interval);
+        },
+        onError() {
+            // Ignore malformed chunks and continue parsing.
+        },
+    });
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            parser.feed(decoder.decode(value, { stream: true }));
+            while (queue.length > 0) {
+                const nextEvent = queue.shift();
+                if (nextEvent) {
+                    yield nextEvent;
+                }
+            }
+        }
+        parser.feed(decoder.decode());
+        while (queue.length > 0) {
+            const nextEvent = queue.shift();
+            if (nextEvent) {
+                yield nextEvent;
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=parseSseStream.js.map

package/dist/parseSseStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSseStream.js","sourceRoot":"","sources":["../src/parseSseStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2B,MAAM,oBAAoB,CAAC;AAY3E,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,MAAkC,EAClC,SAAmC,EACnC,QAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,+EAA+E;IAC/E,mEAAmE;IACnE,IAAI,sBAAsB,GAAG,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,OAAO,CAAC,KAAyB;YAC/B,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;gBAC3B,sBAAsB,GAAG,KAAK,CAAC,EAAE,CAAC;YACpC,CAAC;YACD,oGAAoG;YACpG,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI;gBACJ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,sBAAsB;aACpC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,QAAQ;YACd,SAAS,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QACD,OAAO;YACL,gDAAgD;QAClD,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM;YACR,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,SAAS,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,SAAS,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/parseSseStream.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSseStream.test.d.ts","sourceRoot":"","sources":["../src/parseSseStream.test.ts"],"names":[],"mappings":""}

package/dist/reconnect.d.ts

@@ -0,0 +1,9 @@
+import type { ReconnectOptions } from "./types.js";
+export declare const DEFAULT_RECONNECT_INITIAL_DELAY_MS = 1000;
+export declare const DEFAULT_RECONNECT_MAX_DELAY_MS = 30000;
+export declare function getReconnectConfig(options?: ReconnectOptions): Required<Pick<ReconnectOptions, "initialDelayMs" | "maxDelayMs">> & {
+    maxRetries?: number;
+};
+export declare function getNextDelay(currentDelayMs: number, maxDelayMs: number): number;
+export declare function sleepWithAbort(ms: number, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=reconnect.d.ts.map

package/dist/reconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.d.ts","sourceRoot":"","sources":["../src/reconnect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,kCAAkC,OAAQ,CAAC;AACxD,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CACtE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,CAAC,CACxD,GAAG;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CASA;AAED,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnF"}

package/dist/reconnect.js

@@ -0,0 +1,24 @@
+export const DEFAULT_RECONNECT_INITIAL_DELAY_MS = 1_000;
+export const DEFAULT_RECONNECT_MAX_DELAY_MS = 30_000;
+export function getReconnectConfig(options) {
+    const initialDelayMs = Math.max(0, options?.initialDelayMs ?? DEFAULT_RECONNECT_INITIAL_DELAY_MS);
+    const maxDelayMs = Math.max(initialDelayMs, options?.maxDelayMs ?? DEFAULT_RECONNECT_MAX_DELAY_MS);
+    const maxRetries = options?.maxRetries;
+    return { initialDelayMs, maxDelayMs, ...(maxRetries !== undefined && { maxRetries }) };
+}
+export function getNextDelay(currentDelayMs, maxDelayMs) {
+    return Math.min(currentDelayMs * 2, maxDelayMs);
+}
+export async function sleepWithAbort(ms, signal) {
+    if (signal.aborted || ms <= 0) {
+        return;
+    }
+    await new Promise((resolve) => {
+        const timeout = setTimeout(resolve, ms);
+        signal.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            resolve();
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=reconnect.js.map

package/dist/reconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.js","sourceRoot":"","sources":["../src/reconnect.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kCAAkC,GAAG,KAAK,CAAC;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAErD,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAK3D,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,IAAI,kCAAkC,CAAC,CAAC;IAClG,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACzB,cAAc,EACd,OAAO,EAAE,UAAU,IAAI,8BAA8B,CACtD,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IAEvC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,cAAsB,EAAE,UAAkB;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAU,EAAE,MAAmB;IAClE,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/reconnect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.test.d.ts","sourceRoot":"","sources":["../src/reconnect.test.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+import type { AxiosInstance, AxiosRequestConfig, RawAxiosRequestHeaders } from "axios";
+export type AxiosEventSourceReadyState = 0 | 1 | 2;
+export type AuthStrategy = {
+    type: "none";
+} | {
+    type: "basic";
+    username: string;
+    password: string;
+} | {
+    type: "bearer";
+    token: string | (() => string | Promise<string>);
+};
+export type ReconnectOptions = {
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    /** Maximum number of reconnect attempts after a failure. Omit for unlimited. */
+    maxRetries?: number;
+};
+/**
+ * Mirrors the minimal Event interface for open events.
+ */
+export type SseEvent = {
+    readonly type: string;
+};
+/**
+ * Mirrors the browser MessageEvent for SSE message events.
+ * `source` is always null and `ports` is always empty for SSE streams.
+ */
+export type SseMessageEvent = {
+    readonly type: string;
+    readonly data: string;
+    readonly origin: string;
+    readonly lastEventId: string;
+    readonly source: null;
+    readonly ports: readonly [];
+};
+/**
+ * Shape of the error event (type + error). The dispatched event is an instance of {@link SseErrorEvent} (class).
+ */
+export type SseErrorEventPayload = {
+    readonly type: "error";
+    readonly error: unknown;
+};
+/**
+ * Options passed to addEventListener / removeEventListener.
+ * Mirrors the browser AddEventListenerOptions (subset relevant to SSE).
+ */
+export type AddEventListenerOptions = {
+    once?: boolean;
+};
+/**
+ * A listener that is either a callback function or an object with a `handleEvent` method,
+ * matching the browser EventListenerOrEventListenerObject pattern.
+ */
+export type SseEventListener<T> = ((event: T) => void) | {
+    handleEvent(event: T): void;
+};
+export type AxiosEventSourceOptions = Omit<AxiosRequestConfig, "adapter" | "auth" | "decompress" | "method" | "responseType" | "signal"> & {
+    auth?: AuthStrategy;
+    headers?: RawAxiosRequestHeaders;
+    method?: "GET" | "POST";
+    reconnect?: ReconnectOptions;
+    signal?: AbortSignal;
+    withCredentials?: boolean;
+    /** Text decoding for the stream. Default `"utf-8"`. Passed to `TextDecoder`. */
+    encoding?: string;
+    /** Reject non-200 responses or responses whose Content-Type is not `text/event-stream`. Default `true`. */
+    rejectNonEventStream?: boolean;
+    onopen?: (event: SseEvent) => void;
+    onerror?: (event: SseErrorEventPayload) => void;
+};
+export type AxiosEventSourceLike = EventTarget & {
+    readonly readyState: AxiosEventSourceReadyState;
+    readonly url: string;
+    readonly withCredentials: boolean;
+    onopen: ((event: SseEvent) => void) | null;
+    onmessage: ((event: SseMessageEvent) => void) | null;
+    onerror: ((event: SseErrorEventPayload) => void) | null;
+    close(): void;
+};
+export type AxiosEventSourceFactory = {
+    (axios: AxiosInstance, url: string, options?: AxiosEventSourceOptions): AxiosEventSourceLike;
+    (url: string, options?: AxiosEventSourceOptions): AxiosEventSourceLike;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAEvF,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG;IAAE,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,kBAAkB,EAClB,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,CACzE,GAAG;IACF,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2GAA2G;IAC3G,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG;IAC/C,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,oBAAoB,CAAC;IAC7F,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,oBAAoB,CAAC;CACxE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "axios-eventsource",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "axios": "^1.11.0",
+    "eventsource-parser": "^3.0.6"
+  }
+}