npm - @rayjp2010/fetch-event-source - Versions diffs - 3.0.0 - Mend

@rayjp2010/fetch-event-source 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+    MIT License
+    Copyright (c) Microsoft Corporation.
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md ADDED Viewed

@@ -0,0 +1,215 @@
+# Fetch Event Source
+This package provides a better API for making [Event Source requests](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events) - also known as server-sent events - with all the features available in the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+The [default browser EventSource API](https://developer.mozilla.org/en-US/docs/Web/API/EventSource) imposes several restrictions on the type of request you're allowed to make: the [only parameters](https://developer.mozilla.org/en-US/docs/Web/API/EventSource/EventSource#Parameters) you're allowed to pass in are the `url` and `withCredentials`, so:
+* You cannot pass in a request body: you have to encode all the information necessary to execute the request inside the URL, which is [limited to 2000 characters](https://stackoverflow.com/questions/417142) in most browsers.
+* You cannot pass in custom request headers
+* You can only make GET requests - there is no way to specify another method.
+* If the connection is cut, you don't have any control over the retry strategy: the browser will silently retry for you a few times and then stop, which is not good enough for any sort of robust application.
+This library provides an alternate interface for consuming server-sent events, based on the Fetch API. It is fully compatible with the [Event Stream format](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format), so if you already have a server emitting these events, you can consume it just like before. However, you now have greater control over the request and response so:
+* You can use any request method/headers/body, plus all the other functionality exposed by fetch(). You can even provide an alternate fetch() implementation, if the default browser implementation doesn't work for you.
+* You have access to the response object if you want to do some custom validation/processing before  parsing the event source. This is useful in case you have API gateways (like nginx) in front of your application server: if the gateway returns an error, you might want to handle it correctly.
+* If the connection gets cut or an error occurs, you have full control over the retry strategy.
+In addition, this library also plugs into the browser's [Page Visibility API](https://developer.mozilla.org/en-US/docs/Web/API/Page_Visibility_API) so the connection closes if the document is hidden (e.g., the user minimizes the window), and automatically retries with the last event ID when it becomes visible again. This reduces the load on your server by not having open connections unnecessarily (but you can opt out of this behavior if you want.)
+# Install
+```sh
+npm install @rayjp2010/fetch-event-source
+```
+# Usage
+```ts
+// BEFORE:
+const sse = new EventSource('/api/sse');
+sse.onmessage = (ev) => {
+    console.log(ev.data);
+};
+// AFTER:
+import { fetchEventSource } from '@rayjp2010/fetch-event-source';
+await fetchEventSource('/api/sse', {
+    onmessage(ev) {
+        console.log(ev.data);
+    }
+});
+```
+You can pass in all the [other parameters](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Parameters) exposed by the default fetch API, for example:
+```ts
+const ctrl = new AbortController();
+fetchEventSource('/api/sse', {
+    method: 'POST',
+    headers: {
+        'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+        foo: 'bar'
+    }),
+    signal: ctrl.signal,
+});
+```
+You can use a function for `headers` to get fresh values on each request/retry, useful for refreshing auth tokens:
+```ts
+fetchEventSource('/api/sse', {
+    headers: () => ({
+        Authorization: `Bearer ${getLatestToken()}`,
+    }),
+    onmessage(msg) {
+        console.log(msg.data);
+    }
+});
+```
+You can add better error handling, for example:
+```ts
+class RetriableError extends Error { }
+class FatalError extends Error { }
+fetchEventSource('/api/sse', {
+    async onopen(response) {
+        if (response.ok && response.headers.get('content-type') === EventStreamContentType) {
+            return; // everything's good
+        } else if (response.status >= 400 && response.status < 500 && response.status !== 429) {
+            // client-side errors are usually non-retriable:
+            throw new FatalError();
+        } else {
+            throw new RetriableError();
+        }
+    },
+    onmessage(msg) {
+        // if the server emits an error message, throw an exception
+        // so it gets handled by the onerror callback below:
+        if (msg.event === 'FatalError') {
+            throw new FatalError(msg.data);
+        }
+    },
+    onclose() {
+        // if the server closes the connection unexpectedly, retry:
+        throw new RetriableError();
+    },
+    onerror(err) {
+        if (err instanceof FatalError) {
+            throw err; // rethrow to stop the operation
+        } else {
+            // do nothing to automatically retry. You can also
+            // return a specific retry interval here.
+        }
+    }
+});
+```
+You can implement exponential backoff to avoid overwhelming the server during outages:
+```ts
+let retryCount = 0;
+fetchEventSource('/api/sse', {
+    async onopen(response) {
+        if (response.ok) {
+            retryCount = 0; // Reset on successful connection
+        }
+    },
+    onerror(err) {
+        retryCount++;
+        // Exponential backoff: 1s, 2s, 4s, 8s... max 30s
+        const backoff = Math.min(1000 * Math.pow(2, retryCount - 1), 30000);
+        console.log(`Retrying in ${backoff}ms...`);
+        return backoff;
+    }
+});
+```
+# Closing the Connection
+To close the connection from the client side, use an `AbortController` and call `abort()` when you want to stop:
+```ts
+const ctrl = new AbortController();
+fetchEventSource('/api/sse', {
+    signal: ctrl.signal,
+    onmessage(msg) {
+        console.log(msg.data);
+        // Close based on a message from the server:
+        if (msg.event === 'done') {
+            ctrl.abort();
+        }
+    }
+});
+// Or close from elsewhere, e.g., when the user clicks a button:
+document.getElementById('stop').addEventListener('click', () => {
+    ctrl.abort();
+});
+// Or close when a component unmounts (React example):
+useEffect(() => {
+    const ctrl = new AbortController();
+    fetchEventSource('/api/sse', { signal: ctrl.signal, ... });
+    return () => ctrl.abort();
+}, []);
+```
+# Page Visibility
+**Important:** By default, this library closes the connection when the page is hidden (e.g., user switches tabs or minimizes the window) and reconnects when visible again. This differs from the native `EventSource` which stays connected.
+To keep the connection open even when the page is hidden, set `openWhenHidden: true`:
+```ts
+fetchEventSource('/api/sse', {
+    openWhenHidden: true, // Keep connection open when page is hidden
+    onmessage(msg) {
+        console.log(msg.data);
+    }
+});
+```
+| `openWhenHidden` | Behavior |
+|------------------|----------|
+| `false` (default) | Connection closes when hidden, reconnects when visible |
+| `true` | Connection stays open regardless of page visibility |
+# Compatibility
+This library is written in typescript and targets ES2017 features supported by all evergreen browsers (Chrome, Firefox, Safari, Edge.) You might need to [polyfill TextDecoder](https://www.npmjs.com/package/fast-text-encoding) for old Edge (versions < 79), though:
+```js
+require('fast-text-encoding');
+```
+# Connection Limits
+This library does not impose any connection limits, but browsers and servers do. Keep these limitations in mind when designing your application:
+| Factor | Typical Limit | Notes |
+|--------|---------------|-------|
+| HTTP/1.1 connections per domain | ~6 | Browser-enforced limit |
+| HTTP/2 streams per connection | ~100-256 | Better multiplexing, but still limited |
+| Browser memory | Varies | Each connection consumes memory |
+| Server connections | Varies | Depends on server configuration |
+**Recommendations for applications requiring many concurrent streams:**
+1. **Use HTTP/2** on your server to benefit from connection multiplexing
+2. **Consolidate streams** - use a single SSE connection with event routing instead of many separate connections
+3. **Consider alternatives** - for 100+ real-time streams, WebSockets or a pub/sub architecture may be more appropriate
+4. **Close unused connections** - use the `AbortController` to close connections when they're no longer needed
+# Contributing
+This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
+the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide
+a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
+provided by the bot. You will only need to do this once across all repos using our CLA.
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

package/lib/cjs/fetch.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+import { EventSourceMessage } from './parse.js';
+export declare const EventStreamContentType = "text/event-stream";
+export interface FetchEventSourceInit extends Omit<RequestInit, 'headers'> {
+    /**
+     * The request headers. FetchEventSource only supports the Record<string,string> format,
+     * or a function that returns headers. Using a function allows dynamic headers that are
+     * refreshed on each retry, useful for updating Authorization tokens.
+     */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /**
+     * Called when a response is received. Use this to validate that the response
+     * actually matches what you expect (and throw if it doesn't.) If not provided,
+     * will default to a basic validation to ensure the content-type is text/event-stream.
+     */
+    onopen?: (response: Response) => Promise<void>;
+    /**
+     * Called when a message is received. NOTE: Unlike the default browser
+     * EventSource.onmessage, this callback is called for _all_ events,
+     * even ones with a custom `event` field.
+     */
+    onmessage?: (ev: EventSourceMessage) => void;
+    /**
+     * Called when a response finishes. If you don't expect the server to kill
+     * the connection, you can throw an exception here and retry using onerror.
+     */
+    onclose?: () => void;
+    /**
+     * Called when there is any error making the request / processing messages /
+     * handling callbacks etc. Use this to control the retry strategy: if the
+     * error is fatal, rethrow the error inside the callback to stop the entire
+     * operation. Otherwise, you can return an interval (in milliseconds) after
+     * which the request will automatically retry (with the last-event-id).
+     * If this callback is not specified, or it returns undefined, fetchEventSource
+     * will treat every error as retriable and will try again after 1 second.
+     */
+    onerror?: (err: any) => number | null | undefined | void;
+    /**
+     * If true, will keep the request open even if the document is hidden.
+     * By default, fetchEventSource will close the request and reopen it
+     * automatically when the document becomes visible again.
+     */
+    openWhenHidden?: boolean;
+    /** The Fetch function to use. Defaults to window.fetch */
+    fetch?: typeof fetch;
+}
+export declare function fetchEventSource(input: RequestInfo, { signal: inputSignal, headers: inputHeaders, onopen: inputOnOpen, onmessage, onclose, onerror, openWhenHidden, fetch: inputFetch, ...rest }: FetchEventSourceInit): Promise<void>;

package/lib/cjs/fetch.js ADDED Viewed

@@ -0,0 +1,135 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventStreamContentType = void 0;
+exports.fetchEventSource = fetchEventSource;
+const parse_js_1 = require("./parse.js");
+exports.EventStreamContentType = 'text/event-stream';
+const DefaultRetryInterval = 1000;
+const LastEventId = 'last-event-id';
+function fetchEventSource(input, _a) {
+    var { signal: inputSignal, headers: inputHeaders, onopen: inputOnOpen, onmessage, onclose, onerror, openWhenHidden, fetch: inputFetch } = _a, rest = __rest(_a, ["signal", "headers", "onopen", "onmessage", "onclose", "onerror", "openWhenHidden", "fetch"]);
+    // Create a function to get headers, supporting both static and dynamic headers
+    const getHeaders = typeof inputHeaders === 'function'
+        ? inputHeaders
+        : () => (Object.assign({}, (inputHeaders !== null && inputHeaders !== void 0 ? inputHeaders : {})));
+    return new Promise((resolve, reject) => {
+        // Handle already-aborted signal immediately to match native fetch behavior
+        if (inputSignal === null || inputSignal === void 0 ? void 0 : inputSignal.aborted) {
+            resolve();
+            return;
+        }
+        // Track last-event-id separately so it persists across retries even with dynamic headers
+        let lastEventId;
+        let curRequestController;
+        function onVisibilityChange() {
+            curRequestController.abort(); // close existing request on every visibility change
+            if (!document.hidden) {
+                create(); // page is now visible again, recreate request.
+            }
+        }
+        if (!openWhenHidden) {
+            document.addEventListener('visibilitychange', onVisibilityChange);
+        }
+        let retryInterval = DefaultRetryInterval;
+        let retryTimer = 0;
+        function dispose() {
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            window.clearTimeout(retryTimer);
+            // Only abort if not already aborted to avoid unnecessary DOMException logs
+            if (!curRequestController.signal.aborted) {
+                curRequestController.abort();
+            }
+        }
+        // if the incoming signal aborts, dispose resources and resolve:
+        inputSignal === null || inputSignal === void 0 ? void 0 : inputSignal.addEventListener('abort', () => {
+            dispose();
+            resolve(); // don't waste time constructing/logging errors
+        });
+        const fetch = inputFetch !== null && inputFetch !== void 0 ? inputFetch : window.fetch;
+        const onopen = inputOnOpen !== null && inputOnOpen !== void 0 ? inputOnOpen : defaultOnOpen;
+        async function create() {
+            var _a;
+            // Get fresh headers on each attempt (supports dynamic headers for token refresh)
+            const headers = getHeaders();
+            if (!headers.accept) {
+                headers.accept = exports.EventStreamContentType;
+            }
+            // Add last-event-id if we have one from a previous connection
+            if (lastEventId) {
+                headers[LastEventId] = lastEventId;
+            }
+            // Store controller in local scope to avoid race condition during rapid tab switches.
+            // Without this, the catch block might check a different controller's abort status.
+            const currentController = new AbortController();
+            curRequestController = currentController;
+            try {
+                const response = await fetch(input, Object.assign(Object.assign({}, rest), { headers, signal: currentController.signal }));
+                await onopen(response);
+                await (0, parse_js_1.getBytes)(response.body, (0, parse_js_1.getLines)((0, parse_js_1.getMessages)(id => {
+                    if (id) {
+                        // store the id and send it back on the next retry:
+                        lastEventId = id;
+                    }
+                    else {
+                        // don't send the last-event-id header anymore:
+                        lastEventId = undefined;
+                    }
+                }, retry => {
+                    retryInterval = retry;
+                }, onmessage)));
+                onclose === null || onclose === void 0 ? void 0 : onclose();
+                dispose();
+                resolve();
+            }
+            catch (err) {
+                if (!currentController.signal.aborted) {
+                    // if we haven't aborted the request ourselves:
+                    try {
+                        // check if we need to retry:
+                        const interval = (_a = onerror === null || onerror === void 0 ? void 0 : onerror(err)) !== null && _a !== void 0 ? _a : retryInterval;
+                        window.clearTimeout(retryTimer);
+                        // if user aborted during onerror callback, stop retrying:
+                        if (inputSignal === null || inputSignal === void 0 ? void 0 : inputSignal.aborted) {
+                            dispose();
+                            resolve();
+                            return;
+                        }
+                        // if page is hidden and openWhenHidden is false, don't retry now.
+                        // onVisibilityChange will call create() when page becomes visible.
+                        if (!openWhenHidden && document.hidden) {
+                            return;
+                        }
+                        retryTimer = window.setTimeout(create, interval);
+                    }
+                    catch (innerErr) {
+                        // we should not retry anymore:
+                        dispose();
+                        reject(innerErr);
+                    }
+                }
+            }
+        }
+        create();
+    });
+}
+function defaultOnOpen(response) {
+    if (!response.ok) {
+        throw new Error(`Request failed with status ${response.status}: ${response.statusText}`);
+    }
+    const contentType = response.headers.get('content-type');
+    if (!(contentType === null || contentType === void 0 ? void 0 : contentType.startsWith(exports.EventStreamContentType))) {
+        throw new Error(`Expected content-type to be ${exports.EventStreamContentType}, Actual: ${contentType}`);
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/lib/cjs/fetch.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/fetch.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventSourceMessage, getBytes, getLines, getMessages } from './parse.js';\r\n\r\nexport const EventStreamContentType = 'text/event-stream';\r\n\r\nconst DefaultRetryInterval = 1000;\r\nconst LastEventId = 'last-event-id';\r\n\r\nexport interface FetchEventSourceInit extends Omit<RequestInit, 'headers'> {\r\n /**\r\n * The request headers. FetchEventSource only supports the Record<string,string> format,\r\n * or a function that returns headers. Using a function allows dynamic headers that are\r\n * refreshed on each retry, useful for updating Authorization tokens.\r\n */\r\n headers?: Record<string, string> | (() => Record<string, string>),\r\n\r\n /**\r\n * Called when a response is received. Use this to validate that the response\r\n * actually matches what you expect (and throw if it doesn't.) If not provided,\r\n * will default to a basic validation to ensure the content-type is text/event-stream.\r\n */\r\n onopen?: (response: Response) => Promise<void>,\r\n\r\n /**\r\n * Called when a message is received. NOTE: Unlike the default browser\r\n * EventSource.onmessage, this callback is called for _all_ events,\r\n * even ones with a custom `event` field.\r\n */\r\n onmessage?: (ev: EventSourceMessage) => void;\r\n\r\n /**\r\n * Called when a response finishes. If you don't expect the server to kill\r\n * the connection, you can throw an exception here and retry using onerror.\r\n */\r\n onclose?: () => void;\r\n\r\n /**\r\n * Called when there is any error making the request / processing messages /\r\n * handling callbacks etc. Use this to control the retry strategy: if the\r\n * error is fatal, rethrow the error inside the callback to stop the entire\r\n * operation. Otherwise, you can return an interval (in milliseconds) after\r\n * which the request will automatically retry (with the last-event-id).\r\n * If this callback is not specified, or it returns undefined, fetchEventSource\r\n * will treat every error as retriable and will try again after 1 second.\r\n */\r\n onerror?: (err: any) => number | null | undefined | void,\r\n\r\n /**\r\n * If true, will keep the request open even if the document is hidden.\r\n * By default, fetchEventSource will close the request and reopen it\r\n * automatically when the document becomes visible again.\r\n */\r\n openWhenHidden?: boolean;\r\n\r\n /** The Fetch function to use. Defaults to window.fetch */\r\n fetch?: typeof fetch;\r\n}\r\n\r\nexport function fetchEventSource(input: RequestInfo, {\r\n signal: inputSignal,\r\n headers: inputHeaders,\r\n onopen: inputOnOpen,\r\n onmessage,\r\n onclose,\r\n onerror,\r\n openWhenHidden,\r\n fetch: inputFetch,\r\n ...rest\r\n}: FetchEventSourceInit) {\r\n // Create a function to get headers, supporting both static and dynamic headers\r\n const getHeaders: () => Record<string, string> = typeof inputHeaders === 'function'\r\n ? inputHeaders\r\n : () => ({ ...(inputHeaders ?? {}) });\r\n\r\n return new Promise<void>((resolve, reject) => {\r\n // Handle already-aborted signal immediately to match native fetch behavior\r\n if (inputSignal?.aborted) {\r\n resolve();\r\n return;\r\n }\r\n\r\n // Track last-event-id separately so it persists across retries even with dynamic headers\r\n let lastEventId: string | undefined;\r\n\r\n let curRequestController: AbortController;\r\n function onVisibilityChange() {\r\n curRequestController.abort(); // close existing request on every visibility change\r\n if (!document.hidden) {\r\n create(); // page is now visible again, recreate request.\r\n }\r\n }\r\n\r\n if (!openWhenHidden) {\r\n document.addEventListener('visibilitychange', onVisibilityChange);\r\n }\r\n\r\n let retryInterval = DefaultRetryInterval;\r\n let retryTimer = 0;\r\n function dispose() {\r\n document.removeEventListener('visibilitychange', onVisibilityChange);\r\n window.clearTimeout(retryTimer);\r\n // Only abort if not already aborted to avoid unnecessary DOMException logs\r\n if (!curRequestController.signal.aborted) {\r\n curRequestController.abort();\r\n }\r\n }\r\n\r\n // if the incoming signal aborts, dispose resources and resolve:\r\n inputSignal?.addEventListener('abort', () => {\r\n dispose();\r\n resolve(); // don't waste time constructing/logging errors\r\n });\r\n\r\n const fetch = inputFetch ?? window.fetch;\r\n const onopen = inputOnOpen ?? defaultOnOpen;\r\n async function create() {\r\n // Get fresh headers on each attempt (supports dynamic headers for token refresh)\r\n const headers = getHeaders();\r\n if (!headers.accept) {\r\n headers.accept = EventStreamContentType;\r\n }\r\n // Add last-event-id if we have one from a previous connection\r\n if (lastEventId) {\r\n headers[LastEventId] = lastEventId;\r\n }\r\n\r\n // Store controller in local scope to avoid race condition during rapid tab switches.\r\n // Without this, the catch block might check a different controller's abort status.\r\n const currentController = new AbortController();\r\n curRequestController = currentController;\r\n try {\r\n const response = await fetch(input, {\r\n ...rest,\r\n headers,\r\n signal: currentController.signal,\r\n });\r\n\r\n await onopen(response);\r\n\r\n await getBytes(response.body!, getLines(getMessages(id => {\r\n if (id) {\r\n // store the id and send it back on the next retry:\r\n lastEventId = id;\r\n } else {\r\n // don't send the last-event-id header anymore:\r\n lastEventId = undefined;\r\n }\r\n }, retry => {\r\n retryInterval = retry;\r\n }, onmessage)));\r\n\r\n onclose?.();\r\n dispose();\r\n resolve();\r\n } catch (err) {\r\n if (!currentController.signal.aborted) {\r\n // if we haven't aborted the request ourselves:\r\n try {\r\n // check if we need to retry:\r\n const interval: any = onerror?.(err) ?? retryInterval;\r\n window.clearTimeout(retryTimer);\r\n // if user aborted during onerror callback, stop retrying:\r\n if (inputSignal?.aborted) {\r\n dispose();\r\n resolve();\r\n return;\r\n }\r\n // if page is hidden and openWhenHidden is false, don't retry now.\r\n // onVisibilityChange will call create() when page becomes visible.\r\n if (!openWhenHidden && document.hidden) {\r\n return;\r\n }\r\n retryTimer = window.setTimeout(create, interval);\r\n } catch (innerErr) {\r\n // we should not retry anymore:\r\n dispose();\r\n reject(innerErr);\r\n }\r\n }\r\n }\r\n }\r\n\r\n create();\r\n });\r\n}\r\n\r\nfunction defaultOnOpen(response: Response) {\r\n if (!response.ok) {\r\n throw new Error(`Request failed with status ${response.status}: ${response.statusText}`);\r\n }\r\n const contentType = response.headers.get('content-type');\r\n if (!contentType?.startsWith(EventStreamContentType)) {\r\n throw new Error(`Expected content-type to be ${EventStreamContentType}, Actual: ${contentType}`);\r\n }\r\n}\r\n"]}

package/lib/cjs/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { fetchEventSource, FetchEventSourceInit, EventStreamContentType } from './fetch.js';
2	+ export { EventSourceMessage } from './parse.js';

package/lib/cjs/index.js ADDED Viewed

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventStreamContentType = exports.fetchEventSource = void 0;
+var fetch_js_1 = require("./fetch.js");
+Object.defineProperty(exports, "fetchEventSource", { enumerable: true, get: function () { return fetch_js_1.fetchEventSource; } });
+Object.defineProperty(exports, "EventStreamContentType", { enumerable: true, get: function () { return fetch_js_1.EventStreamContentType; } });
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAA4F;AAAnF,4GAAA,gBAAgB,OAAA;AAAwB,kHAAA,sBAAsB,OAAA","sourcesContent":["export { fetchEventSource, FetchEventSourceInit, EventStreamContentType } from './fetch.js';\r\nexport { EventSourceMessage } from './parse.js';\r\n"]}

package/lib/cjs/parse.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+/**
+ * Represents a message sent in an event stream
+ * https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format
+ */
+export interface EventSourceMessage {
+    /** The event ID to set the EventSource object's last event ID value. */
+    id: string;
+    /** A string identifying the type of event described. */
+    event: string;
+    /** The event data */
+    data: string;
+    /** The reconnection interval (in milliseconds) to wait before retrying the connection */
+    retry?: number;
+}
+/**
+ * Converts a ReadableStream into a callback pattern.
+ * @param stream The input ReadableStream.
+ * @param onChunk A function that will be called on each new byte chunk in the stream.
+ * @returns {Promise<void>} A promise that will be resolved when the stream closes.
+ */
+export declare function getBytes(stream: ReadableStream<Uint8Array>, onChunk: (arr: Uint8Array) => void): Promise<void>;
+/**
+ * Parses arbitary byte chunks into EventSource line buffers.
+ * Each line should be of the format "field: value" and ends with \r, \n, or \r\n.
+ * @param onLine A function that will be called on each new EventSource line.
+ * @returns A function that should be called for each incoming byte chunk.
+ */
+export declare function getLines(onLine: (line: Uint8Array, fieldLength: number) => void): (arr: Uint8Array) => void;
+/**
+ * Parses line buffers into EventSourceMessages.
+ * @param onId A function that will be called on each `id` field.
+ * @param onRetry A function that will be called on each `retry` field.
+ * @param onMessage A function that will be called on each message.
+ * @returns A function that should be called for each incoming line buffer.
+ */
+export declare function getMessages(onId: (id: string) => void, onRetry: (retry: number) => void, onMessage?: (msg: EventSourceMessage) => void): (line: Uint8Array, fieldLength: number) => void;

package/lib/cjs/parse.js ADDED Viewed

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBytes = getBytes;
+exports.getLines = getLines;
+exports.getMessages = getMessages;
+/**
+ * Converts a ReadableStream into a callback pattern.
+ * @param stream The input ReadableStream.
+ * @param onChunk A function that will be called on each new byte chunk in the stream.
+ * @returns {Promise<void>} A promise that will be resolved when the stream closes.
+ */
+async function getBytes(stream, onChunk) {
+    const reader = stream.getReader();
+    let result;
+    while (!(result = await reader.read()).done) {
+        onChunk(result.value);
+    }
+}
+/**
+ * Parses arbitary byte chunks into EventSource line buffers.
+ * Each line should be of the format "field: value" and ends with \r, \n, or \r\n.
+ * @param onLine A function that will be called on each new EventSource line.
+ * @returns A function that should be called for each incoming byte chunk.
+ */
+function getLines(onLine) {
+    let buffer;
+    let position; // current read position
+    let fieldLength; // length of the `field` portion of the line
+    let discardTrailingNewline = false;
+    // return a function that can process each incoming byte chunk:
+    return function onChunk(arr) {
+        if (buffer === undefined) {
+            buffer = arr;
+            position = 0;
+            fieldLength = -1;
+        }
+        else {
+            // we're still parsing the old line. Append the new bytes into buffer:
+            buffer = concat(buffer, arr);
+        }
+        const bufLength = buffer.length;
+        let lineStart = 0; // index where the current line starts
+        while (position < bufLength) {
+            if (discardTrailingNewline) {
+                if (buffer[position] === 10 /* ControlChars.NewLine */) {
+                    lineStart = ++position; // skip to next char
+                }
+                discardTrailingNewline = false;
+            }
+            // start looking forward till the end of line:
+            let lineEnd = -1; // index of the \r or \n char
+            for (; position < bufLength && lineEnd === -1; ++position) {
+                switch (buffer[position]) {
+                    case 58 /* ControlChars.Colon */:
+                        if (fieldLength === -1) { // first colon in line
+                            fieldLength = position - lineStart;
+                        }
+                        break;
+                    // @ts-ignore:7029 \r case below should fallthrough to \n:
+                    case 13 /* ControlChars.CarriageReturn */:
+                        discardTrailingNewline = true;
+                    case 10 /* ControlChars.NewLine */:
+                        lineEnd = position;
+                        break;
+                }
+            }
+            if (lineEnd === -1) {
+                // We reached the end of the buffer but the line hasn't ended.
+                // Wait for the next arr and then continue parsing:
+                break;
+            }
+            // we've reached the line end, send it out:
+            onLine(buffer.subarray(lineStart, lineEnd), fieldLength);
+            lineStart = position; // we're now on the next line
+            fieldLength = -1;
+        }
+        if (lineStart === bufLength) {
+            buffer = undefined; // we've finished reading it
+        }
+        else if (lineStart !== 0) {
+            // Create a new view into buffer beginning at lineStart so we don't
+            // need to copy over the previous lines when we get the new arr:
+            buffer = buffer.subarray(lineStart);
+            position -= lineStart;
+        }
+    };
+}
+/**
+ * Parses line buffers into EventSourceMessages.
+ * @param onId A function that will be called on each `id` field.
+ * @param onRetry A function that will be called on each `retry` field.
+ * @param onMessage A function that will be called on each message.
+ * @returns A function that should be called for each incoming line buffer.
+ */
+function getMessages(onId, onRetry, onMessage) {
+    let message = newMessage();
+    const decoder = new TextDecoder();
+    // return a function that can process each incoming line buffer:
+    return function onLine(line, fieldLength) {
+        if (line.length === 0) {
+            // empty line denotes end of message. Trigger the callback and start a new message:
+            // per spec: "If the data buffer's last character is a U+000A LINE FEED (LF) character,
+            // then remove the last character from the data buffer."
+            if (message.data.endsWith('\n')) {
+                message.data = message.data.slice(0, -1);
+            }
+            // per spec, only dispatch if data is not empty (ignore comment-only messages)
+            // https://html.spec.whatwg.org/multipage/server-sent-events.html#dispatchMessage
+            if (message.data) {
+                onMessage === null || onMessage === void 0 ? void 0 : onMessage(message);
+            }
+            message = newMessage();
+        }
+        else if (fieldLength > 0) { // exclude comments and lines with no values
+            // line is of format "<field>:<value>" or "<field>: <value>"
+            // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+            const field = decoder.decode(line.subarray(0, fieldLength));
+            const valueOffset = fieldLength + (line[fieldLength + 1] === 32 /* ControlChars.Space */ ? 2 : 1);
+            const value = decoder.decode(line.subarray(valueOffset));
+            switch (field) {
+                case 'data':
+                    // per spec: "Append the field value to the data buffer,
+                    // then append a single U+000A LINE FEED (LF) character to the data buffer."
+                    message.data += value + '\n';
+                    break;
+                case 'event':
+                    message.event = value;
+                    break;
+                case 'id':
+                    onId(message.id = value);
+                    break;
+                case 'retry':
+                    const retry = parseInt(value, 10);
+                    if (!isNaN(retry)) { // per spec, ignore non-integers
+                        onRetry(message.retry = retry);
+                    }
+                    break;
+            }
+        }
+    };
+}
+function concat(a, b) {
+    const res = new Uint8Array(a.length + b.length);
+    res.set(a);
+    res.set(b, a.length);
+    return res;
+}
+function newMessage() {
+    // data, event, and id must be initialized to empty strings:
+    // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+    // retry should be initialized to undefined so we return a consistent shape
+    // to the js engine all the time: https://mathiasbynens.be/notes/shapes-ics#takeaways
+    return {
+        data: '',
+        event: '',
+        id: '',
+        retry: undefined,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/lib/cjs/parse.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/parse.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Represents a message sent in an event stream\r\n * https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format\r\n */\r\nexport interface EventSourceMessage {\r\n /** The event ID to set the EventSource object's last event ID value. */\r\n id: string;\r\n /** A string identifying the type of event described. */\r\n event: string;\r\n /** The event data */\r\n data: string;\r\n /** The reconnection interval (in milliseconds) to wait before retrying the connection */\r\n retry?: number;\r\n}\r\n\r\n/**\r\n * Converts a ReadableStream into a callback pattern.\r\n * @param stream The input ReadableStream.\r\n * @param onChunk A function that will be called on each new byte chunk in the stream.\r\n * @returns {Promise<void>} A promise that will be resolved when the stream closes.\r\n */\r\nexport async function getBytes(stream: ReadableStream<Uint8Array>, onChunk: (arr: Uint8Array) => void) {\r\n const reader = stream.getReader();\r\n let result: ReadableStreamReadResult<Uint8Array>;\r\n while (!(result = await reader.read()).done) {\r\n onChunk(result.value);\r\n }\r\n}\r\n\r\nconst enum ControlChars {\r\n NewLine = 10,\r\n CarriageReturn = 13,\r\n Space = 32,\r\n Colon = 58,\r\n}\r\n\r\n/** \r\n * Parses arbitary byte chunks into EventSource line buffers.\r\n * Each line should be of the format \"field: value\" and ends with \\r, \\n, or \\r\\n. \r\n * @param onLine A function that will be called on each new EventSource line.\r\n * @returns A function that should be called for each incoming byte chunk.\r\n */\r\nexport function getLines(onLine: (line: Uint8Array, fieldLength: number) => void) {\r\n let buffer: Uint8Array | undefined;\r\n let position: number; // current read position\r\n let fieldLength: number; // length of the `field` portion of the line\r\n let discardTrailingNewline = false;\r\n\r\n // return a function that can process each incoming byte chunk:\r\n return function onChunk(arr: Uint8Array) {\r\n if (buffer === undefined) {\r\n buffer = arr;\r\n position = 0;\r\n fieldLength = -1;\r\n } else {\r\n // we're still parsing the old line. Append the new bytes into buffer:\r\n buffer = concat(buffer, arr);\r\n }\r\n\r\n const bufLength = buffer.length;\r\n let lineStart = 0; // index where the current line starts\r\n while (position < bufLength) {\r\n if (discardTrailingNewline) {\r\n if (buffer[position] === ControlChars.NewLine) {\r\n lineStart = ++position; // skip to next char\r\n }\r\n \r\n discardTrailingNewline = false;\r\n }\r\n \r\n // start looking forward till the end of line:\r\n let lineEnd = -1; // index of the \\r or \\n char\r\n for (; position < bufLength && lineEnd === -1; ++position) {\r\n switch (buffer[position]) {\r\n case ControlChars.Colon:\r\n if (fieldLength === -1) { // first colon in line\r\n fieldLength = position - lineStart;\r\n }\r\n break;\r\n // @ts-ignore:7029 \\r case below should fallthrough to \\n:\r\n case ControlChars.CarriageReturn:\r\n discardTrailingNewline = true;\r\n case ControlChars.NewLine:\r\n lineEnd = position;\r\n break;\r\n }\r\n }\r\n\r\n if (lineEnd === -1) {\r\n // We reached the end of the buffer but the line hasn't ended.\r\n // Wait for the next arr and then continue parsing:\r\n break;\r\n }\r\n\r\n // we've reached the line end, send it out:\r\n onLine(buffer.subarray(lineStart, lineEnd), fieldLength);\r\n lineStart = position; // we're now on the next line\r\n fieldLength = -1;\r\n }\r\n\r\n if (lineStart === bufLength) {\r\n buffer = undefined; // we've finished reading it\r\n } else if (lineStart !== 0) {\r\n // Create a new view into buffer beginning at lineStart so we don't\r\n // need to copy over the previous lines when we get the new arr:\r\n buffer = buffer.subarray(lineStart);\r\n position -= lineStart;\r\n }\r\n }\r\n}\r\n\r\n/** \r\n * Parses line buffers into EventSourceMessages.\r\n * @param onId A function that will be called on each `id` field.\r\n * @param onRetry A function that will be called on each `retry` field.\r\n * @param onMessage A function that will be called on each message.\r\n * @returns A function that should be called for each incoming line buffer.\r\n */\r\nexport function getMessages(\r\n onId: (id: string) => void,\r\n onRetry: (retry: number) => void,\r\n onMessage?: (msg: EventSourceMessage) => void\r\n) {\r\n let message = newMessage();\r\n const decoder = new TextDecoder();\r\n\r\n // return a function that can process each incoming line buffer:\r\n return function onLine(line: Uint8Array, fieldLength: number) {\r\n if (line.length === 0) {\r\n // empty line denotes end of message. Trigger the callback and start a new message:\r\n // per spec: \"If the data buffer's last character is a U+000A LINE FEED (LF) character,\r\n // then remove the last character from the data buffer.\"\r\n if (message.data.endsWith('\\n')) {\r\n message.data = message.data.slice(0, -1);\r\n }\r\n // per spec, only dispatch if data is not empty (ignore comment-only messages)\r\n // https://html.spec.whatwg.org/multipage/server-sent-events.html#dispatchMessage\r\n if (message.data) {\r\n onMessage?.(message);\r\n }\r\n message = newMessage();\r\n } else if (fieldLength > 0) { // exclude comments and lines with no values\r\n // line is of format \"<field>:<value>\" or \"<field>: <value>\"\r\n // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation\r\n const field = decoder.decode(line.subarray(0, fieldLength));\r\n const valueOffset = fieldLength + (line[fieldLength + 1] === ControlChars.Space ? 2 : 1);\r\n const value = decoder.decode(line.subarray(valueOffset));\r\n\r\n switch (field) {\r\n case 'data':\r\n // per spec: \"Append the field value to the data buffer,\r\n // then append a single U+000A LINE FEED (LF) character to the data buffer.\"\r\n message.data += value + '\\n';\r\n break;\r\n case 'event':\r\n message.event = value;\r\n break;\r\n case 'id':\r\n onId(message.id = value);\r\n break;\r\n case 'retry':\r\n const retry = parseInt(value, 10);\r\n if (!isNaN(retry)) { // per spec, ignore non-integers\r\n onRetry(message.retry = retry);\r\n }\r\n break;\r\n }\r\n }\r\n }\r\n}\r\n\r\nfunction concat(a: Uint8Array, b: Uint8Array) {\r\n const res = new Uint8Array(a.length + b.length);\r\n res.set(a);\r\n res.set(b, a.length);\r\n return res;\r\n}\r\n\r\nfunction newMessage(): EventSourceMessage {\r\n // data, event, and id must be initialized to empty strings:\r\n // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation\r\n // retry should be initialized to undefined so we return a consistent shape\r\n // to the js engine all the time: https://mathiasbynens.be/notes/shapes-ics#takeaways\r\n return {\r\n data: '',\r\n event: '',\r\n id: '',\r\n retry: undefined,\r\n };\r\n}\r\n"]}

package/lib/esm/fetch.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+import { EventSourceMessage } from './parse.js';
+export declare const EventStreamContentType = "text/event-stream";
+export interface FetchEventSourceInit extends Omit<RequestInit, 'headers'> {
+    /**
+     * The request headers. FetchEventSource only supports the Record<string,string> format,
+     * or a function that returns headers. Using a function allows dynamic headers that are
+     * refreshed on each retry, useful for updating Authorization tokens.
+     */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /**
+     * Called when a response is received. Use this to validate that the response
+     * actually matches what you expect (and throw if it doesn't.) If not provided,
+     * will default to a basic validation to ensure the content-type is text/event-stream.
+     */
+    onopen?: (response: Response) => Promise<void>;
+    /**
+     * Called when a message is received. NOTE: Unlike the default browser
+     * EventSource.onmessage, this callback is called for _all_ events,
+     * even ones with a custom `event` field.
+     */
+    onmessage?: (ev: EventSourceMessage) => void;
+    /**
+     * Called when a response finishes. If you don't expect the server to kill
+     * the connection, you can throw an exception here and retry using onerror.
+     */
+    onclose?: () => void;
+    /**
+     * Called when there is any error making the request / processing messages /
+     * handling callbacks etc. Use this to control the retry strategy: if the
+     * error is fatal, rethrow the error inside the callback to stop the entire
+     * operation. Otherwise, you can return an interval (in milliseconds) after
+     * which the request will automatically retry (with the last-event-id).
+     * If this callback is not specified, or it returns undefined, fetchEventSource
+     * will treat every error as retriable and will try again after 1 second.
+     */
+    onerror?: (err: any) => number | null | undefined | void;
+    /**
+     * If true, will keep the request open even if the document is hidden.
+     * By default, fetchEventSource will close the request and reopen it
+     * automatically when the document becomes visible again.
+     */
+    openWhenHidden?: boolean;
+    /** The Fetch function to use. Defaults to window.fetch */
+    fetch?: typeof fetch;
+}
+export declare function fetchEventSource(input: RequestInfo, { signal: inputSignal, headers: inputHeaders, onopen: inputOnOpen, onmessage, onclose, onerror, openWhenHidden, fetch: inputFetch, ...rest }: FetchEventSourceInit): Promise<void>;

package/lib/esm/fetch.js ADDED Viewed

@@ -0,0 +1,131 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { getBytes, getLines, getMessages } from './parse.js';
+export const EventStreamContentType = 'text/event-stream';
+const DefaultRetryInterval = 1000;
+const LastEventId = 'last-event-id';
+export function fetchEventSource(input, _a) {
+    var { signal: inputSignal, headers: inputHeaders, onopen: inputOnOpen, onmessage, onclose, onerror, openWhenHidden, fetch: inputFetch } = _a, rest = __rest(_a, ["signal", "headers", "onopen", "onmessage", "onclose", "onerror", "openWhenHidden", "fetch"]);
+    // Create a function to get headers, supporting both static and dynamic headers
+    const getHeaders = typeof inputHeaders === 'function'
+        ? inputHeaders
+        : () => (Object.assign({}, (inputHeaders !== null && inputHeaders !== void 0 ? inputHeaders : {})));
+    return new Promise((resolve, reject) => {
+        // Handle already-aborted signal immediately to match native fetch behavior
+        if (inputSignal === null || inputSignal === void 0 ? void 0 : inputSignal.aborted) {
+            resolve();
+            return;
+        }
+        // Track last-event-id separately so it persists across retries even with dynamic headers
+        let lastEventId;
+        let curRequestController;
+        function onVisibilityChange() {
+            curRequestController.abort(); // close existing request on every visibility change
+            if (!document.hidden) {
+                create(); // page is now visible again, recreate request.
+            }
+        }
+        if (!openWhenHidden) {
+            document.addEventListener('visibilitychange', onVisibilityChange);
+        }
+        let retryInterval = DefaultRetryInterval;
+        let retryTimer = 0;
+        function dispose() {
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            window.clearTimeout(retryTimer);
+            // Only abort if not already aborted to avoid unnecessary DOMException logs
+            if (!curRequestController.signal.aborted) {
+                curRequestController.abort();
+            }
+        }
+        // if the incoming signal aborts, dispose resources and resolve:
+        inputSignal === null || inputSignal === void 0 ? void 0 : inputSignal.addEventListener('abort', () => {
+            dispose();
+            resolve(); // don't waste time constructing/logging errors
+        });
+        const fetch = inputFetch !== null && inputFetch !== void 0 ? inputFetch : window.fetch;
+        const onopen = inputOnOpen !== null && inputOnOpen !== void 0 ? inputOnOpen : defaultOnOpen;
+        async function create() {
+            var _a;
+            // Get fresh headers on each attempt (supports dynamic headers for token refresh)
+            const headers = getHeaders();
+            if (!headers.accept) {
+                headers.accept = EventStreamContentType;
+            }
+            // Add last-event-id if we have one from a previous connection
+            if (lastEventId) {
+                headers[LastEventId] = lastEventId;
+            }
+            // Store controller in local scope to avoid race condition during rapid tab switches.
+            // Without this, the catch block might check a different controller's abort status.
+            const currentController = new AbortController();
+            curRequestController = currentController;
+            try {
+                const response = await fetch(input, Object.assign(Object.assign({}, rest), { headers, signal: currentController.signal }));
+                await onopen(response);
+                await getBytes(response.body, getLines(getMessages(id => {
+                    if (id) {
+                        // store the id and send it back on the next retry:
+                        lastEventId = id;
+                    }
+                    else {
+                        // don't send the last-event-id header anymore:
+                        lastEventId = undefined;
+                    }
+                }, retry => {
+                    retryInterval = retry;
+                }, onmessage)));
+                onclose === null || onclose === void 0 ? void 0 : onclose();
+                dispose();
+                resolve();
+            }
+            catch (err) {
+                if (!currentController.signal.aborted) {
+                    // if we haven't aborted the request ourselves:
+                    try {
+                        // check if we need to retry:
+                        const interval = (_a = onerror === null || onerror === void 0 ? void 0 : onerror(err)) !== null && _a !== void 0 ? _a : retryInterval;
+                        window.clearTimeout(retryTimer);
+                        // if user aborted during onerror callback, stop retrying:
+                        if (inputSignal === null || inputSignal === void 0 ? void 0 : inputSignal.aborted) {
+                            dispose();
+                            resolve();
+                            return;
+                        }
+                        // if page is hidden and openWhenHidden is false, don't retry now.
+                        // onVisibilityChange will call create() when page becomes visible.
+                        if (!openWhenHidden && document.hidden) {
+                            return;
+                        }
+                        retryTimer = window.setTimeout(create, interval);
+                    }
+                    catch (innerErr) {
+                        // we should not retry anymore:
+                        dispose();
+                        reject(innerErr);
+                    }
+                }
+            }
+        }
+        create();
+    });
+}
+function defaultOnOpen(response) {
+    if (!response.ok) {
+        throw new Error(`Request failed with status ${response.status}: ${response.statusText}`);
+    }
+    const contentType = response.headers.get('content-type');
+    if (!(contentType === null || contentType === void 0 ? void 0 : contentType.startsWith(EventStreamContentType))) {
+        throw new Error(`Expected content-type to be ${EventStreamContentType}, Actual: ${contentType}`);
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/lib/esm/fetch.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/fetch.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventSourceMessage, getBytes, getLines, getMessages } from './parse.js';\r\n\r\nexport const EventStreamContentType = 'text/event-stream';\r\n\r\nconst DefaultRetryInterval = 1000;\r\nconst LastEventId = 'last-event-id';\r\n\r\nexport interface FetchEventSourceInit extends Omit<RequestInit, 'headers'> {\r\n /**\r\n * The request headers. FetchEventSource only supports the Record<string,string> format,\r\n * or a function that returns headers. Using a function allows dynamic headers that are\r\n * refreshed on each retry, useful for updating Authorization tokens.\r\n */\r\n headers?: Record<string, string> | (() => Record<string, string>),\r\n\r\n /**\r\n * Called when a response is received. Use this to validate that the response\r\n * actually matches what you expect (and throw if it doesn't.) If not provided,\r\n * will default to a basic validation to ensure the content-type is text/event-stream.\r\n */\r\n onopen?: (response: Response) => Promise<void>,\r\n\r\n /**\r\n * Called when a message is received. NOTE: Unlike the default browser\r\n * EventSource.onmessage, this callback is called for _all_ events,\r\n * even ones with a custom `event` field.\r\n */\r\n onmessage?: (ev: EventSourceMessage) => void;\r\n\r\n /**\r\n * Called when a response finishes. If you don't expect the server to kill\r\n * the connection, you can throw an exception here and retry using onerror.\r\n */\r\n onclose?: () => void;\r\n\r\n /**\r\n * Called when there is any error making the request / processing messages /\r\n * handling callbacks etc. Use this to control the retry strategy: if the\r\n * error is fatal, rethrow the error inside the callback to stop the entire\r\n * operation. Otherwise, you can return an interval (in milliseconds) after\r\n * which the request will automatically retry (with the last-event-id).\r\n * If this callback is not specified, or it returns undefined, fetchEventSource\r\n * will treat every error as retriable and will try again after 1 second.\r\n */\r\n onerror?: (err: any) => number | null | undefined | void,\r\n\r\n /**\r\n * If true, will keep the request open even if the document is hidden.\r\n * By default, fetchEventSource will close the request and reopen it\r\n * automatically when the document becomes visible again.\r\n */\r\n openWhenHidden?: boolean;\r\n\r\n /** The Fetch function to use. Defaults to window.fetch */\r\n fetch?: typeof fetch;\r\n}\r\n\r\nexport function fetchEventSource(input: RequestInfo, {\r\n signal: inputSignal,\r\n headers: inputHeaders,\r\n onopen: inputOnOpen,\r\n onmessage,\r\n onclose,\r\n onerror,\r\n openWhenHidden,\r\n fetch: inputFetch,\r\n ...rest\r\n}: FetchEventSourceInit) {\r\n // Create a function to get headers, supporting both static and dynamic headers\r\n const getHeaders: () => Record<string, string> = typeof inputHeaders === 'function'\r\n ? inputHeaders\r\n : () => ({ ...(inputHeaders ?? {}) });\r\n\r\n return new Promise<void>((resolve, reject) => {\r\n // Handle already-aborted signal immediately to match native fetch behavior\r\n if (inputSignal?.aborted) {\r\n resolve();\r\n return;\r\n }\r\n\r\n // Track last-event-id separately so it persists across retries even with dynamic headers\r\n let lastEventId: string | undefined;\r\n\r\n let curRequestController: AbortController;\r\n function onVisibilityChange() {\r\n curRequestController.abort(); // close existing request on every visibility change\r\n if (!document.hidden) {\r\n create(); // page is now visible again, recreate request.\r\n }\r\n }\r\n\r\n if (!openWhenHidden) {\r\n document.addEventListener('visibilitychange', onVisibilityChange);\r\n }\r\n\r\n let retryInterval = DefaultRetryInterval;\r\n let retryTimer = 0;\r\n function dispose() {\r\n document.removeEventListener('visibilitychange', onVisibilityChange);\r\n window.clearTimeout(retryTimer);\r\n // Only abort if not already aborted to avoid unnecessary DOMException logs\r\n if (!curRequestController.signal.aborted) {\r\n curRequestController.abort();\r\n }\r\n }\r\n\r\n // if the incoming signal aborts, dispose resources and resolve:\r\n inputSignal?.addEventListener('abort', () => {\r\n dispose();\r\n resolve(); // don't waste time constructing/logging errors\r\n });\r\n\r\n const fetch = inputFetch ?? window.fetch;\r\n const onopen = inputOnOpen ?? defaultOnOpen;\r\n async function create() {\r\n // Get fresh headers on each attempt (supports dynamic headers for token refresh)\r\n const headers = getHeaders();\r\n if (!headers.accept) {\r\n headers.accept = EventStreamContentType;\r\n }\r\n // Add last-event-id if we have one from a previous connection\r\n if (lastEventId) {\r\n headers[LastEventId] = lastEventId;\r\n }\r\n\r\n // Store controller in local scope to avoid race condition during rapid tab switches.\r\n // Without this, the catch block might check a different controller's abort status.\r\n const currentController = new AbortController();\r\n curRequestController = currentController;\r\n try {\r\n const response = await fetch(input, {\r\n ...rest,\r\n headers,\r\n signal: currentController.signal,\r\n });\r\n\r\n await onopen(response);\r\n\r\n await getBytes(response.body!, getLines(getMessages(id => {\r\n if (id) {\r\n // store the id and send it back on the next retry:\r\n lastEventId = id;\r\n } else {\r\n // don't send the last-event-id header anymore:\r\n lastEventId = undefined;\r\n }\r\n }, retry => {\r\n retryInterval = retry;\r\n }, onmessage)));\r\n\r\n onclose?.();\r\n dispose();\r\n resolve();\r\n } catch (err) {\r\n if (!currentController.signal.aborted) {\r\n // if we haven't aborted the request ourselves:\r\n try {\r\n // check if we need to retry:\r\n const interval: any = onerror?.(err) ?? retryInterval;\r\n window.clearTimeout(retryTimer);\r\n // if user aborted during onerror callback, stop retrying:\r\n if (inputSignal?.aborted) {\r\n dispose();\r\n resolve();\r\n return;\r\n }\r\n // if page is hidden and openWhenHidden is false, don't retry now.\r\n // onVisibilityChange will call create() when page becomes visible.\r\n if (!openWhenHidden && document.hidden) {\r\n return;\r\n }\r\n retryTimer = window.setTimeout(create, interval);\r\n } catch (innerErr) {\r\n // we should not retry anymore:\r\n dispose();\r\n reject(innerErr);\r\n }\r\n }\r\n }\r\n }\r\n\r\n create();\r\n });\r\n}\r\n\r\nfunction defaultOnOpen(response: Response) {\r\n if (!response.ok) {\r\n throw new Error(`Request failed with status ${response.status}: ${response.statusText}`);\r\n }\r\n const contentType = response.headers.get('content-type');\r\n if (!contentType?.startsWith(EventStreamContentType)) {\r\n throw new Error(`Expected content-type to be ${EventStreamContentType}, Actual: ${contentType}`);\r\n }\r\n}\r\n"]}

package/lib/esm/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { fetchEventSource, FetchEventSourceInit, EventStreamContentType } from './fetch.js';
2	+ export { EventSourceMessage } from './parse.js';

package/lib/esm/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { fetchEventSource, EventStreamContentType } from './fetch.js';
2	+ //# sourceMappingURL=index.js.map

package/lib/esm/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAwB,sBAAsB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { fetchEventSource, FetchEventSourceInit, EventStreamContentType } from './fetch.js';\r\nexport { EventSourceMessage } from './parse.js';\r\n"]}

package/lib/esm/parse.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+/**
+ * Represents a message sent in an event stream
+ * https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format
+ */
+export interface EventSourceMessage {
+    /** The event ID to set the EventSource object's last event ID value. */
+    id: string;
+    /** A string identifying the type of event described. */
+    event: string;
+    /** The event data */
+    data: string;
+    /** The reconnection interval (in milliseconds) to wait before retrying the connection */
+    retry?: number;
+}
+/**
+ * Converts a ReadableStream into a callback pattern.
+ * @param stream The input ReadableStream.
+ * @param onChunk A function that will be called on each new byte chunk in the stream.
+ * @returns {Promise<void>} A promise that will be resolved when the stream closes.
+ */
+export declare function getBytes(stream: ReadableStream<Uint8Array>, onChunk: (arr: Uint8Array) => void): Promise<void>;
+/**
+ * Parses arbitary byte chunks into EventSource line buffers.
+ * Each line should be of the format "field: value" and ends with \r, \n, or \r\n.
+ * @param onLine A function that will be called on each new EventSource line.
+ * @returns A function that should be called for each incoming byte chunk.
+ */
+export declare function getLines(onLine: (line: Uint8Array, fieldLength: number) => void): (arr: Uint8Array) => void;
+/**
+ * Parses line buffers into EventSourceMessages.
+ * @param onId A function that will be called on each `id` field.
+ * @param onRetry A function that will be called on each `retry` field.
+ * @param onMessage A function that will be called on each message.
+ * @returns A function that should be called for each incoming line buffer.
+ */
+export declare function getMessages(onId: (id: string) => void, onRetry: (retry: number) => void, onMessage?: (msg: EventSourceMessage) => void): (line: Uint8Array, fieldLength: number) => void;

package/lib/esm/parse.js ADDED Viewed

@@ -0,0 +1,155 @@
+/**
+ * Converts a ReadableStream into a callback pattern.
+ * @param stream The input ReadableStream.
+ * @param onChunk A function that will be called on each new byte chunk in the stream.
+ * @returns {Promise<void>} A promise that will be resolved when the stream closes.
+ */
+export async function getBytes(stream, onChunk) {
+    const reader = stream.getReader();
+    let result;
+    while (!(result = await reader.read()).done) {
+        onChunk(result.value);
+    }
+}
+/**
+ * Parses arbitary byte chunks into EventSource line buffers.
+ * Each line should be of the format "field: value" and ends with \r, \n, or \r\n.
+ * @param onLine A function that will be called on each new EventSource line.
+ * @returns A function that should be called for each incoming byte chunk.
+ */
+export function getLines(onLine) {
+    let buffer;
+    let position; // current read position
+    let fieldLength; // length of the `field` portion of the line
+    let discardTrailingNewline = false;
+    // return a function that can process each incoming byte chunk:
+    return function onChunk(arr) {
+        if (buffer === undefined) {
+            buffer = arr;
+            position = 0;
+            fieldLength = -1;
+        }
+        else {
+            // we're still parsing the old line. Append the new bytes into buffer:
+            buffer = concat(buffer, arr);
+        }
+        const bufLength = buffer.length;
+        let lineStart = 0; // index where the current line starts
+        while (position < bufLength) {
+            if (discardTrailingNewline) {
+                if (buffer[position] === 10 /* ControlChars.NewLine */) {
+                    lineStart = ++position; // skip to next char
+                }
+                discardTrailingNewline = false;
+            }
+            // start looking forward till the end of line:
+            let lineEnd = -1; // index of the \r or \n char
+            for (; position < bufLength && lineEnd === -1; ++position) {
+                switch (buffer[position]) {
+                    case 58 /* ControlChars.Colon */:
+                        if (fieldLength === -1) { // first colon in line
+                            fieldLength = position - lineStart;
+                        }
+                        break;
+                    // @ts-ignore:7029 \r case below should fallthrough to \n:
+                    case 13 /* ControlChars.CarriageReturn */:
+                        discardTrailingNewline = true;
+                    case 10 /* ControlChars.NewLine */:
+                        lineEnd = position;
+                        break;
+                }
+            }
+            if (lineEnd === -1) {
+                // We reached the end of the buffer but the line hasn't ended.
+                // Wait for the next arr and then continue parsing:
+                break;
+            }
+            // we've reached the line end, send it out:
+            onLine(buffer.subarray(lineStart, lineEnd), fieldLength);
+            lineStart = position; // we're now on the next line
+            fieldLength = -1;
+        }
+        if (lineStart === bufLength) {
+            buffer = undefined; // we've finished reading it
+        }
+        else if (lineStart !== 0) {
+            // Create a new view into buffer beginning at lineStart so we don't
+            // need to copy over the previous lines when we get the new arr:
+            buffer = buffer.subarray(lineStart);
+            position -= lineStart;
+        }
+    };
+}
+/**
+ * Parses line buffers into EventSourceMessages.
+ * @param onId A function that will be called on each `id` field.
+ * @param onRetry A function that will be called on each `retry` field.
+ * @param onMessage A function that will be called on each message.
+ * @returns A function that should be called for each incoming line buffer.
+ */
+export function getMessages(onId, onRetry, onMessage) {
+    let message = newMessage();
+    const decoder = new TextDecoder();
+    // return a function that can process each incoming line buffer:
+    return function onLine(line, fieldLength) {
+        if (line.length === 0) {
+            // empty line denotes end of message. Trigger the callback and start a new message:
+            // per spec: "If the data buffer's last character is a U+000A LINE FEED (LF) character,
+            // then remove the last character from the data buffer."
+            if (message.data.endsWith('\n')) {
+                message.data = message.data.slice(0, -1);
+            }
+            // per spec, only dispatch if data is not empty (ignore comment-only messages)
+            // https://html.spec.whatwg.org/multipage/server-sent-events.html#dispatchMessage
+            if (message.data) {
+                onMessage === null || onMessage === void 0 ? void 0 : onMessage(message);
+            }
+            message = newMessage();
+        }
+        else if (fieldLength > 0) { // exclude comments and lines with no values
+            // line is of format "<field>:<value>" or "<field>: <value>"
+            // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+            const field = decoder.decode(line.subarray(0, fieldLength));
+            const valueOffset = fieldLength + (line[fieldLength + 1] === 32 /* ControlChars.Space */ ? 2 : 1);
+            const value = decoder.decode(line.subarray(valueOffset));
+            switch (field) {
+                case 'data':
+                    // per spec: "Append the field value to the data buffer,
+                    // then append a single U+000A LINE FEED (LF) character to the data buffer."
+                    message.data += value + '\n';
+                    break;
+                case 'event':
+                    message.event = value;
+                    break;
+                case 'id':
+                    onId(message.id = value);
+                    break;
+                case 'retry':
+                    const retry = parseInt(value, 10);
+                    if (!isNaN(retry)) { // per spec, ignore non-integers
+                        onRetry(message.retry = retry);
+                    }
+                    break;
+            }
+        }
+    };
+}
+function concat(a, b) {
+    const res = new Uint8Array(a.length + b.length);
+    res.set(a);
+    res.set(b, a.length);
+    return res;
+}
+function newMessage() {
+    // data, event, and id must be initialized to empty strings:
+    // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+    // retry should be initialized to undefined so we return a consistent shape
+    // to the js engine all the time: https://mathiasbynens.be/notes/shapes-ics#takeaways
+    return {
+        data: '',
+        event: '',
+        id: '',
+        retry: undefined,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/lib/esm/parse.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/parse.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Represents a message sent in an event stream\r\n * https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format\r\n */\r\nexport interface EventSourceMessage {\r\n /** The event ID to set the EventSource object's last event ID value. */\r\n id: string;\r\n /** A string identifying the type of event described. */\r\n event: string;\r\n /** The event data */\r\n data: string;\r\n /** The reconnection interval (in milliseconds) to wait before retrying the connection */\r\n retry?: number;\r\n}\r\n\r\n/**\r\n * Converts a ReadableStream into a callback pattern.\r\n * @param stream The input ReadableStream.\r\n * @param onChunk A function that will be called on each new byte chunk in the stream.\r\n * @returns {Promise<void>} A promise that will be resolved when the stream closes.\r\n */\r\nexport async function getBytes(stream: ReadableStream<Uint8Array>, onChunk: (arr: Uint8Array) => void) {\r\n const reader = stream.getReader();\r\n let result: ReadableStreamReadResult<Uint8Array>;\r\n while (!(result = await reader.read()).done) {\r\n onChunk(result.value);\r\n }\r\n}\r\n\r\nconst enum ControlChars {\r\n NewLine = 10,\r\n CarriageReturn = 13,\r\n Space = 32,\r\n Colon = 58,\r\n}\r\n\r\n/** \r\n * Parses arbitary byte chunks into EventSource line buffers.\r\n * Each line should be of the format \"field: value\" and ends with \\r, \\n, or \\r\\n. \r\n * @param onLine A function that will be called on each new EventSource line.\r\n * @returns A function that should be called for each incoming byte chunk.\r\n */\r\nexport function getLines(onLine: (line: Uint8Array, fieldLength: number) => void) {\r\n let buffer: Uint8Array | undefined;\r\n let position: number; // current read position\r\n let fieldLength: number; // length of the `field` portion of the line\r\n let discardTrailingNewline = false;\r\n\r\n // return a function that can process each incoming byte chunk:\r\n return function onChunk(arr: Uint8Array) {\r\n if (buffer === undefined) {\r\n buffer = arr;\r\n position = 0;\r\n fieldLength = -1;\r\n } else {\r\n // we're still parsing the old line. Append the new bytes into buffer:\r\n buffer = concat(buffer, arr);\r\n }\r\n\r\n const bufLength = buffer.length;\r\n let lineStart = 0; // index where the current line starts\r\n while (position < bufLength) {\r\n if (discardTrailingNewline) {\r\n if (buffer[position] === ControlChars.NewLine) {\r\n lineStart = ++position; // skip to next char\r\n }\r\n \r\n discardTrailingNewline = false;\r\n }\r\n \r\n // start looking forward till the end of line:\r\n let lineEnd = -1; // index of the \\r or \\n char\r\n for (; position < bufLength && lineEnd === -1; ++position) {\r\n switch (buffer[position]) {\r\n case ControlChars.Colon:\r\n if (fieldLength === -1) { // first colon in line\r\n fieldLength = position - lineStart;\r\n }\r\n break;\r\n // @ts-ignore:7029 \\r case below should fallthrough to \\n:\r\n case ControlChars.CarriageReturn:\r\n discardTrailingNewline = true;\r\n case ControlChars.NewLine:\r\n lineEnd = position;\r\n break;\r\n }\r\n }\r\n\r\n if (lineEnd === -1) {\r\n // We reached the end of the buffer but the line hasn't ended.\r\n // Wait for the next arr and then continue parsing:\r\n break;\r\n }\r\n\r\n // we've reached the line end, send it out:\r\n onLine(buffer.subarray(lineStart, lineEnd), fieldLength);\r\n lineStart = position; // we're now on the next line\r\n fieldLength = -1;\r\n }\r\n\r\n if (lineStart === bufLength) {\r\n buffer = undefined; // we've finished reading it\r\n } else if (lineStart !== 0) {\r\n // Create a new view into buffer beginning at lineStart so we don't\r\n // need to copy over the previous lines when we get the new arr:\r\n buffer = buffer.subarray(lineStart);\r\n position -= lineStart;\r\n }\r\n }\r\n}\r\n\r\n/** \r\n * Parses line buffers into EventSourceMessages.\r\n * @param onId A function that will be called on each `id` field.\r\n * @param onRetry A function that will be called on each `retry` field.\r\n * @param onMessage A function that will be called on each message.\r\n * @returns A function that should be called for each incoming line buffer.\r\n */\r\nexport function getMessages(\r\n onId: (id: string) => void,\r\n onRetry: (retry: number) => void,\r\n onMessage?: (msg: EventSourceMessage) => void\r\n) {\r\n let message = newMessage();\r\n const decoder = new TextDecoder();\r\n\r\n // return a function that can process each incoming line buffer:\r\n return function onLine(line: Uint8Array, fieldLength: number) {\r\n if (line.length === 0) {\r\n // empty line denotes end of message. Trigger the callback and start a new message:\r\n // per spec: \"If the data buffer's last character is a U+000A LINE FEED (LF) character,\r\n // then remove the last character from the data buffer.\"\r\n if (message.data.endsWith('\\n')) {\r\n message.data = message.data.slice(0, -1);\r\n }\r\n // per spec, only dispatch if data is not empty (ignore comment-only messages)\r\n // https://html.spec.whatwg.org/multipage/server-sent-events.html#dispatchMessage\r\n if (message.data) {\r\n onMessage?.(message);\r\n }\r\n message = newMessage();\r\n } else if (fieldLength > 0) { // exclude comments and lines with no values\r\n // line is of format \"<field>:<value>\" or \"<field>: <value>\"\r\n // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation\r\n const field = decoder.decode(line.subarray(0, fieldLength));\r\n const valueOffset = fieldLength + (line[fieldLength + 1] === ControlChars.Space ? 2 : 1);\r\n const value = decoder.decode(line.subarray(valueOffset));\r\n\r\n switch (field) {\r\n case 'data':\r\n // per spec: \"Append the field value to the data buffer,\r\n // then append a single U+000A LINE FEED (LF) character to the data buffer.\"\r\n message.data += value + '\\n';\r\n break;\r\n case 'event':\r\n message.event = value;\r\n break;\r\n case 'id':\r\n onId(message.id = value);\r\n break;\r\n case 'retry':\r\n const retry = parseInt(value, 10);\r\n if (!isNaN(retry)) { // per spec, ignore non-integers\r\n onRetry(message.retry = retry);\r\n }\r\n break;\r\n }\r\n }\r\n }\r\n}\r\n\r\nfunction concat(a: Uint8Array, b: Uint8Array) {\r\n const res = new Uint8Array(a.length + b.length);\r\n res.set(a);\r\n res.set(b, a.length);\r\n return res;\r\n}\r\n\r\nfunction newMessage(): EventSourceMessage {\r\n // data, event, and id must be initialized to empty strings:\r\n // https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation\r\n // retry should be initialized to undefined so we return a consistent shape\r\n // to the js engine all the time: https://mathiasbynens.be/notes/shapes-ics#takeaways\r\n return {\r\n data: '',\r\n event: '',\r\n id: '',\r\n retry: undefined,\r\n };\r\n}\r\n"]}

package/package.json ADDED Viewed

@@ -0,0 +1,43 @@
+{
+  "name": "@rayjp2010/fetch-event-source",
+  "version": "3.0.0",
+  "description": "A better API for making Event Source requests, with all the features of fetch()",
+  "keywords": [
+    "sse",
+    "server-sent-events",
+    "eventsource",
+    "fetch",
+    "streaming",
+    "event-stream"
+  ],
+  "homepage": "https://github.com/rayjp2010/fetch-event-source#readme",
+  "repository": "github:rayjp2010/fetch-event-source",
+  "bugs": {
+    "url": "https://github.com/rayjp2010/fetch-event-source/issues"
+  },
+  "author": "rayjp2010",
+  "license": "MIT",
+  "main": "lib/cjs/index.js",
+  "module": "lib/esm/index.js",
+  "types": "lib/cjs/index.d.ts",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.1.0",
+    "jest": "^30.2.0",
+    "rimraf": "^6.1.2",
+    "source-map-support": "^0.5.21",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "clean": "rimraf ./lib ./coverage",
+    "prebuild": "pnpm run clean",
+    "build": "tsc && tsc -p tsconfig.esm.json",
+    "test": "jest",
+    "test:coverage": "jest --coverage"
+  }
+}