idxs 0.0.0 → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present 
+
+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

@@ -0,0 +1,100 @@
+# idxs
+
+TypeScript Interface for [Index Supply](https://indexsupply.net).
+
+## Install
+
+```bash
+npm i idxs
+```
+
+## Usage
+
+### `IndexSupply`
+
+Instantiate and use the `IndexSupply` client to fetch data from the Index Supply API.
+
+```ts
+import { IndexSupply } from 'idxs'
+
+const is = IndexSupply.create()
+
+// Fetch transactions
+const txs = await is.fetch({
+  query: 'select hash, "from", "to", value from txs where chain = 1 limit 10',
+})
+console.log(txs.rows)
+
+// Fetch Transfer events with ABI signature
+const transfers = await is.fetch({
+  query: 'select "from", "to", value from transfer where chain = 1 limit 10',
+  signatures: ['event Transfer(address indexed from, address indexed to, uint256 value)'],
+})
+console.log(transfers.rows)
+
+// Pagination with cursor
+const next = await is.fetch({
+  query: 'select hash, "from", "to", value from txs where chain = 1 limit 10',
+  cursor: txs.cursor,
+})
+
+// Live streaming
+for await (const result of is.live({
+  query: 'select hash, "from", "to" from txs where chain = 1 limit 10',
+})) 
+  console.log(result.rows)
+
+```
+
+### `QueryBuilder`
+
+`idxs` exports a [Kysely-based](https://kysely.dev) type-safe query builder.
+
+```ts
+import { IndexSupply, QueryBuilder } from 'idxs'
+
+const is = IndexSupply.create()
+const qb = QueryBuilder.from(is)
+
+// Query standard tables
+const txs = await qb
+  .selectFrom('txs')
+  .select(['hash', 'from', 'to', 'value'])
+  .where('chain', '=', 1)
+  .limit(10)
+  .execute()
+
+// Query with event signatures
+const transfers = await qb
+  .withSignatures(['event Transfer(address indexed from, address indexed to, uint256 value)'])
+  .selectFrom('transfer')
+  .select(['from', 'to', 'value'])
+  .where('chain', '=', 1)
+  .limit(100)
+  .execute()
+
+// Pagination with cursor
+const next = await qb
+  .atCursor(txs.cursor)
+  .selectFrom('txs')
+  .select(['hash'])
+  .limit(10)
+  .execute()
+
+// Live streaming
+for await (const txs of qb
+  .selectFrom('txs')
+  .select(['hash', 'from', 'to', 'value'])
+  .where('chain', '=', 1)
+  .stream()
+)
+  console.log(txs)
+```
+
+## API
+
+TODO
+
+## License
+
+MIT

package/dist/IndexSupply.d.ts

@@ -0,0 +1,205 @@
+import * as Errors from 'ox/Errors';
+import * as Emitter from './internal/emitter.js';
+import * as Result from './internal/result.js';
+export type IS = {
+    /** The base URL of the Index Supply API. */
+    baseUrl: string;
+    /**
+     * Fetches data from the Index Supply API.
+     *
+     * @example
+     * ```ts
+     * const result = await is.fetch({
+     *   query: 'select hash, "from", "to", value from txs limit 10',
+     * })
+     * console.log(result.rows)
+     * ```
+     *
+     * @example
+     * ```ts
+     * // With event signatures for custom tables
+     * const result = await is.fetch({
+     *   query: 'select "from", "to", value from transfer limit 10',
+     *   signatures: ['event Transfer(address indexed from, address indexed to, uint256 value)'],
+     * })
+     * ```
+     *
+     * @param options - Options for the fetch method.
+     * @returns The result of the operation.
+     */
+    fetch: <const sql extends string = string, const signatures extends readonly Signature[] | undefined = undefined>(options: IS.fetch.Options<sql, signatures>) => Promise<IS.fetch.ReturnValue<sql, signatures>>;
+    /**
+     * Subscribes to live data updates from the Index Supply API via Server-Sent Events.
+     *
+     * @example
+     * ```ts
+     * for await (const result of is.live({
+     *   query: 'select hash, "from", "to", value from txs limit 10',
+     * }))
+     *   console.log(result.rows)
+     * ```
+     *
+     * @param options - Options for the live method.
+     * @returns An iterable AsyncGenerator.
+     */
+    live: <sql extends string = string, signatures extends readonly Signature[] | undefined = undefined>(options: IS.live.Options<sql, signatures>) => AsyncGenerator<IS.fetch.ReturnValue<sql, signatures>, void, unknown>;
+    /**
+     * Registers an event listener to listen for events from the Index Supply instance.
+     *
+     * @example
+     * ```ts
+     * is.on('debug', (event, data) => console.log('Debug:', event, data))
+     * is.on('request', (request) => console.log('Request:', request.url))
+     * is.on('response', (response) => console.log('Response:', response.status))
+     * is.on('error', (error) => console.error('Error:', error.message))
+     * ```
+     */
+    on: Emitter.Emitter['on'];
+};
+/** Cursor type for pagination. Can be a string or an object with `chainId` and `blockNumber`. */
+export type Cursor = string | {
+    chainId: number;
+    blockNumber: number | bigint;
+};
+/** Stringified signature of a function or event. */
+export type Signature = Result.Signature;
+export declare namespace IS {
+    namespace fetch {
+        /**
+         * Options for the `fetch` method.
+         */
+        type Options<sql extends string = string, signatures extends readonly Signature[] | undefined = undefined> = RequestInit & {
+            /** Optional cursor for pagination. */
+            cursor?: Cursor | undefined;
+            /** Optional number of retry attempts on failure. Defaults to 5. */
+            retryCount?: number | undefined;
+            /** Optional array of event/function signatures for custom tables. */
+            signatures?: signatures | readonly Signature[] | undefined;
+            /** SQL query to execute. */
+            query: sql | string;
+        };
+        /**
+         * Return value of the `fetch` method.
+         */
+        type ReturnValue<sql extends string = string, signatures extends readonly Signature[] | undefined = undefined> = Result.Result<sql, signatures>;
+        /**
+         * Error types that can be thrown by the `fetch` method.
+         */
+        type ErrorType = FetchRequestError | Errors.GlobalErrorType;
+    }
+    namespace live {
+        /**
+         * Options for the `live` method.
+         */
+        type Options<sql extends string = string, signatures extends readonly Signature[] | undefined = undefined> = fetch.Options<sql, signatures>;
+        /**
+         * Error types that can be thrown by the `live` method.
+         */
+        type ErrorType = FetchRequestError | SseError | Errors.GlobalErrorType;
+    }
+    /**
+     * Result type returned by fetch and live methods.
+     */
+    type Result = Result.Result;
+}
+/**
+ * Creates an Index Supply client instance.
+ *
+ * @param options - Configuration options for the client.
+ * @returns An Index Supply client instance.
+ *
+ * @example
+ * ```ts
+ * import { IndexSupply } from 'idxs'
+ *
+ * // Create with default options
+ * const is = IndexSupply.create()
+ *
+ * // Create with API key
+ * const is = IndexSupply.create({ apiKey: 'your-api-key' })
+ *
+ * // Create with custom base URL
+ * const is = IndexSupply.create({
+ *   apiKey: 'your-api-key',
+ *   baseUrl: 'https://custom-api.example.com',
+ * })
+ * ```
+ */
+export declare function create(options?: create.Options): create.ReturnValue;
+export declare namespace create {
+    /**
+     * Options for creating an Index Supply client.
+     */
+    type Options = {
+        /** Index Supply API key for authentication. */
+        apiKey?: string | undefined;
+        /** Index Supply API base URL. Defaults to `'https://api.indexsupply.net/v2'`. */
+        baseUrl?: string | undefined;
+    };
+    /**
+     * Return type of the `create` function.
+     */
+    type ReturnValue = IS;
+}
+/**
+ * Error thrown when a fetch request to the Index Supply API fails.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await is.fetch({ query: 'invalid query' })
+ * } catch (error) {
+ *   if (error instanceof IndexSupply.FetchRequestError) {
+ *     console.error('Request failed:', error.message)
+ *     console.error('Status:', error.status)
+ *   }
+ * }
+ * ```
+ */
+export declare class FetchRequestError extends Errors.BaseError {
+    readonly name = "IndexSupply.FetchRequestError";
+    /** The HTTP response object. */
+    response: Response;
+    /** The HTTP status code. */
+    status: number;
+    /**
+     * Creates a new FetchRequestError.
+     *
+     * @param message - The error message.
+     * @param response - The HTTP response object.
+     */
+    constructor(message: string, response: Response);
+}
+/**
+ * Error thrown when a Server-Sent Events (SSE) connection fails.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   for await (const result of is.live({ query: 'select * from txs' })) {
+ *     console.log(result)
+ *   }
+ * } catch (error) {
+ *   if (error instanceof IndexSupply.SseError) {
+ *     console.error('SSE error:', error.message)
+ *     console.error('Error type:', error.type) // 'client' or 'server'
+ *   }
+ * }
+ * ```
+ */
+export declare class SseError extends Errors.BaseError<Error | undefined> {
+    readonly name = "IndexSupply.SseError";
+    /** The type of error: 'client' for client-side errors, 'server' for server-side errors. */
+    type: 'client' | 'server';
+    /**
+     * Creates a new SseError.
+     *
+     * @param message - The error message.
+     * @param options - Error options including cause and type.
+     */
+    constructor(message: string, options: {
+        cause?: Error | undefined;
+        type: 'client' | 'server';
+    });
+}
+//# sourceMappingURL=IndexSupply.d.ts.map

package/dist/IndexSupply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexSupply.d.ts","sourceRoot":"","sources":["../src/IndexSupply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAE9C,MAAM,MAAM,EAAE,GAAG;IACf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,EAAE,CACL,KAAK,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EACjC,KAAK,CAAC,UAAU,SAAS,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,EAErE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,KACvC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;IACnD;;;;;;;;;;;;;OAaG;IACH,IAAI,EAAE,CACJ,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,UAAU,SAAS,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,EAE/D,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,KACtC,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACzE;;;;;;;;;;OAUG;IACH,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B,CAAA;AAED,iGAAiG;AACjG,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAA;AAE/E,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;AAExC,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,UAAiB,KAAK,CAAC;QACrB;;WAEG;QACH,KAAY,OAAO,CACjB,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,UAAU,SAAS,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,IAC7D,WAAW,GAAG;YAChB,sCAAsC;YACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;YAC3B,mEAAmE;YACnE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;YAC/B,qEAAqE;YACrE,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;YAC1D,4BAA4B;YAC5B,KAAK,EAAE,GAAG,GAAG,MAAM,CAAA;SACpB,CAAA;QAED;;WAEG;QACH,KAAY,WAAW,CACrB,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,UAAU,SAAS,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,IAC7D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QAElC;;WAEG;QACH,KAAY,SAAS,GAAG,iBAAiB,GAAG,MAAM,CAAC,eAAe,CAAA;KACnE;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,KAAY,OAAO,CACjB,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,UAAU,SAAS,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,IAC7D,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QAElC;;WAEG;QACH,KAAY,SAAS,GAAG,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAA;KAC9E;IAED;;OAEG;IACH,KAAY,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,MAAM,CAAC,OAAY,GAAG,MAAM,CAAC,WAAW,CAqLvE;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B;;OAEG;IACH,KAAY,OAAO,GAAG;QACpB,+CAA+C;QAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,iFAAiF;QACjF,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;IAED;;OAEG;IACH,KAAY,WAAW,GAAG,EAAE,CAAA;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,SAAQ,MAAM,CAAC,SAAS;IACrD,SAAkB,IAAI,mCAAkC;IAExD,gCAAgC;IAChC,QAAQ,EAAE,QAAQ,CAAA;IAClB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAA;IAEd;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAQhD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,QAAS,SAAQ,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC;IAC/D,SAAkB,IAAI,0BAAyB;IAE/C,2FAA2F;IAC3F,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAEzB;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;QACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAC1B;CAOJ"}

package/dist/IndexSupply.js

@@ -0,0 +1,277 @@
+import * as Errors from 'ox/Errors';
+import * as Emitter from './internal/emitter.js';
+import * as Result from './internal/result.js';
+/**
+ * Creates an Index Supply client instance.
+ *
+ * @param options - Configuration options for the client.
+ * @returns An Index Supply client instance.
+ *
+ * @example
+ * ```ts
+ * import { IndexSupply } from 'idxs'
+ *
+ * // Create with default options
+ * const is = IndexSupply.create()
+ *
+ * // Create with API key
+ * const is = IndexSupply.create({ apiKey: 'your-api-key' })
+ *
+ * // Create with custom base URL
+ * const is = IndexSupply.create({
+ *   apiKey: 'your-api-key',
+ *   baseUrl: 'https://custom-api.example.com',
+ * })
+ * ```
+ */
+export function create(options = {}) {
+    const { apiKey, baseUrl = 'https://api.indexsupply.net/v2' } = options;
+    const emitter = Emitter.create();
+    return {
+        baseUrl,
+        on: emitter.on.bind(emitter),
+        async fetch(options) {
+            const { cursor, signatures, query, retryCount = 5, ...requestInit } = options;
+            const { emit } = emitter.instance();
+            const url = new URL(`${baseUrl}/query`);
+            const requestBody = { query };
+            if (cursor !== undefined)
+                requestBody.cursor =
+                    typeof cursor === 'string' ? cursor : `${cursor.chainId}-${cursor.blockNumber.toString()}`;
+            if (signatures !== undefined)
+                requestBody.signatures = signatures;
+            let count = 0;
+            let lastError;
+            while (count < retryCount) {
+                count++;
+                try {
+                    const request = new Request(url, {
+                        ...requestInit,
+                        body: JSON.stringify([requestBody]),
+                        headers: {
+                            'Content-Type': 'application/json',
+                            ...(apiKey ? { 'Api-Key': apiKey } : {}),
+                        },
+                        method: 'POST',
+                    });
+                    emit('request', request.clone());
+                    const response = await fetch(request);
+                    emit('response', response.clone());
+                    if (!response.ok) {
+                        const raw = await response.text();
+                        const message = (() => {
+                            try {
+                                return JSON.parse(raw).message;
+                            }
+                            catch {
+                                return raw;
+                            }
+                        })();
+                        throw new FetchRequestError(message, response);
+                    }
+                    const [result] = (await response.json());
+                    if (!result)
+                        throw new Errors.BaseError('No results returned');
+                    return Result.parse(result, { query, signatures });
+                }
+                catch (e) {
+                    const error = e;
+                    emit('error', error);
+                    if (!shouldRetry(error))
+                        throw error;
+                    lastError = error;
+                    await new Promise((resolve) => setTimeout(resolve, Math.min(200 * 2 ** (count - 1), 30_000)));
+                }
+            }
+            lastError ??= new Errors.BaseError('Maximum retry attempts reached');
+            throw lastError;
+        },
+        async *live(options) {
+            const { cursor, signatures, query, retryCount = 50, signal, ...requestInit } = options;
+            const { emit } = emitter.instance();
+            let shouldAbort = false;
+            signal?.addEventListener('abort', () => {
+                shouldAbort = true;
+            });
+            let count = 0;
+            let lastError;
+            while (count < retryCount) {
+                count++;
+                try {
+                    const url = new URL(`${baseUrl}/query-live`);
+                    const params = new URLSearchParams();
+                    if (cursor)
+                        params.set('cursor', typeof cursor === 'string'
+                            ? cursor
+                            : `${cursor.chainId}-${cursor.blockNumber.toString()}`);
+                    if (signatures)
+                        for (const sig of signatures)
+                            params.append('signatures', sig);
+                    params.set('query', query);
+                    url.search = params.toString();
+                    const request = new Request(url, {
+                        ...requestInit,
+                        ...(signal ? { signal } : {}),
+                        method: 'GET',
+                        headers: {
+                            ...(apiKey ? { 'Api-Key': apiKey } : {}),
+                        },
+                    });
+                    emit('request', request.clone());
+                    const response = await fetch(request);
+                    emit('response', response.clone());
+                    if (!response.ok) {
+                        const raw = await response.text();
+                        const message = (() => {
+                            try {
+                                return JSON.parse(raw).message;
+                            }
+                            catch {
+                                return raw;
+                            }
+                        })();
+                        throw new FetchRequestError(message, response);
+                    }
+                    if (!response.body)
+                        throw new Errors.BaseError('Response body is null');
+                    const reader = response.body.getReader();
+                    for await (const data of readStream(reader)) {
+                        if ('error' in data)
+                            throw new SseError(data.message, { type: data.error });
+                        for (const item of data)
+                            yield item;
+                        count = 0;
+                    }
+                    return;
+                }
+                catch (e) {
+                    if (shouldAbort)
+                        return;
+                    const error = e;
+                    emit('error', error);
+                    if (!shouldRetry(error))
+                        throw error;
+                    lastError = error;
+                    await new Promise((resolve) => setTimeout(resolve, Math.min(200 * 2 ** (count - 1), 30_000)));
+                }
+            }
+            lastError ??= new Errors.BaseError('Maximum retry attempts reached');
+            throw lastError;
+        },
+    };
+}
+/**
+ * Error thrown when a fetch request to the Index Supply API fails.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await is.fetch({ query: 'invalid query' })
+ * } catch (error) {
+ *   if (error instanceof IndexSupply.FetchRequestError) {
+ *     console.error('Request failed:', error.message)
+ *     console.error('Status:', error.status)
+ *   }
+ * }
+ * ```
+ */
+export class FetchRequestError extends Errors.BaseError {
+    name = 'IndexSupply.FetchRequestError';
+    /** The HTTP response object. */
+    response;
+    /** The HTTP status code. */
+    status;
+    /**
+     * Creates a new FetchRequestError.
+     *
+     * @param message - The error message.
+     * @param response - The HTTP response object.
+     */
+    constructor(message, response) {
+        super(message, {
+            metaMessages: [`Status: ${response.status}`],
+        });
+        this.response = response;
+        this.status = response.status;
+    }
+}
+/**
+ * Error thrown when a Server-Sent Events (SSE) connection fails.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   for await (const result of is.live({ query: 'select * from txs' })) {
+ *     console.log(result)
+ *   }
+ * } catch (error) {
+ *   if (error instanceof IndexSupply.SseError) {
+ *     console.error('SSE error:', error.message)
+ *     console.error('Error type:', error.type) // 'client' or 'server'
+ *   }
+ * }
+ * ```
+ */
+export class SseError extends Errors.BaseError {
+    name = 'IndexSupply.SseError';
+    /** The type of error: 'client' for client-side errors, 'server' for server-side errors. */
+    type;
+    /**
+     * Creates a new SseError.
+     *
+     * @param message - The error message.
+     * @param options - Error options including cause and type.
+     */
+    constructor(message, options) {
+        const { cause, type } = options;
+        super(message, { cause });
+        this.type = type;
+    }
+}
+/** @internal */
+async function* readStream(reader) {
+    const decoder = new TextDecoder('utf-8');
+    let buffer = '';
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            const decoded = decoder.decode(value, { stream: true });
+            buffer += decoded;
+            let idx = buffer.indexOf('\n\n');
+            while (idx !== -1) {
+                const block = buffer.slice(0, idx);
+                buffer = buffer.slice(idx + 2);
+                const lines = block.split('\n');
+                for (const line of lines) {
+                    if (line.startsWith('data:')) {
+                        const json = line.slice(5).trim();
+                        try {
+                            yield JSON.parse(json);
+                        }
+                        catch (e) {
+                            const error = e;
+                            await reader.cancel('Invalid JSON in data line');
+                            throw new SseError(error.message, { cause: error, type: 'client' });
+                        }
+                    }
+                }
+                idx = buffer.indexOf('\n\n');
+            }
+        }
+    }
+    finally {
+        await reader.cancel('Stream closed');
+    }
+}
+/** @internal */
+function shouldRetry(error) {
+    if (error instanceof SseError && error.type === 'server')
+        return true;
+    if (error instanceof FetchRequestError &&
+        (error.status === 408 || error.status === 429 || error.status >= 500))
+        return true;
+    return false;
+}
+//# sourceMappingURL=IndexSupply.js.map

package/dist/IndexSupply.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * as IndexSupply from './IndexSupply.js';
+export * as IS from './IndexSupply.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,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * as IndexSupply from './IndexSupply.js';
+export * as IS from './IndexSupply.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/internal/emitter.d.ts

@@ -0,0 +1,36 @@
+import { EventEmitter } from 'eventemitter3';
+export type Emitter = {
+    instance: () => {
+        emit: EventEmitter<EventTypes>['emit'];
+    };
+    on: EventEmitter<EventTypes<true>>['on'];
+};
+export type Events = [
+    {
+        data: Error;
+        event: 'error';
+    },
+    {
+        data: string;
+        event: 'log';
+    },
+    {
+        data: Request;
+        event: 'request';
+    },
+    {
+        data: Response;
+        event: 'response';
+    }
+];
+export type EventTypes<includeOptions extends boolean = false> = {
+    debug: (event: Events[number]['event'], data: Events[number]['data'], ...rest: includeOptions extends true ? readonly [{
+        id: string;
+    }] : readonly []) => void;
+} & {
+    [K in Events[number] as K['event']]: (parameters: K['data'], ...rest: includeOptions extends true ? readonly [{
+        id: string;
+    }] : readonly []) => void;
+};
+export declare function create(): Emitter;
+//# sourceMappingURL=emitter.d.ts.map