@triveria/wallet 0.0.309 → 0.0.314

package/api.d.ts

@@ -1191,6 +1191,10 @@ export interface WalletNotification {
      * Timestamp in milliseconds
      */
     'createdTs': string;
+    /**
+     * State associated with the notification. Only populated in state-aware events
+     */
+    'state'?: string;
     'time': string;
 }
 /**
@@ -1856,12 +1860,15 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
      */
     walletNotificationHistory: (walletId: string, limit?: number, nextMarker?: string, type?: Array<WalletNotificationEventType>, sort?: ListSort, newerThan?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Provides first-in-first-out queue of notifications for a specific wallet.
+     * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
      * @param {string} walletId Wallet ID
+     * @param {string} [eventType] Event type
+     * @param {string} [state] Event state
+     * @param {string} [lastEventID] SSE last event ID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    walletNotifications: (walletId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    walletNotifications: (walletId: string, eventType?: string, state?: string, lastEventID?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Update wallet metadata and configuration.
      * @param {string} walletId
@@ -2466,12 +2473,15 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
      */
     walletNotificationHistory(walletId: string, limit?: number, nextMarker?: string, type?: Array<WalletNotificationEventType>, sort?: ListSort, newerThan?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<WalletNotificationHistory>>;
     /**
-     * Provides first-in-first-out queue of notifications for a specific wallet.
+     * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
      * @param {string} walletId Wallet ID
+     * @param {string} [eventType] Event type
+     * @param {string} [state] Event state
+     * @param {string} [lastEventID] SSE last event ID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    walletNotifications(walletId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<WalletNotification>>>;
+    walletNotifications(walletId: string, eventType?: string, state?: string, lastEventID?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<File>>;
     /**
      * Update wallet metadata and configuration.
      * @param {string} walletId
@@ -3076,12 +3086,15 @@ export declare const DefaultApiFactory: (configuration?: Configuration, basePath
      */
     walletNotificationHistory(walletId: string, limit?: number, nextMarker?: string, type?: Array<WalletNotificationEventType>, sort?: ListSort, newerThan?: number, options?: RawAxiosRequestConfig): AxiosPromise<WalletNotificationHistory>;
     /**
-     * Provides first-in-first-out queue of notifications for a specific wallet.
+     * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
      * @param {string} walletId Wallet ID
+     * @param {string} [eventType] Event type
+     * @param {string} [state] Event state
+     * @param {string} [lastEventID] SSE last event ID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    walletNotifications(walletId: string, options?: RawAxiosRequestConfig): AxiosPromise<Array<WalletNotification>>;
+    walletNotifications(walletId: string, eventType?: string, state?: string, lastEventID?: string, options?: RawAxiosRequestConfig): AxiosPromise<File>;
     /**
      * Update wallet metadata and configuration.
      * @param {string} walletId
@@ -3686,12 +3699,15 @@ export declare class DefaultApi extends BaseAPI {
      */
     walletNotificationHistory(walletId: string, limit?: number, nextMarker?: string, type?: Array<WalletNotificationEventType>, sort?: ListSort, newerThan?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<WalletNotificationHistory, any, {}>>;
     /**
-     * Provides first-in-first-out queue of notifications for a specific wallet.
+     * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
      * @param {string} walletId Wallet ID
+     * @param {string} [eventType] Event type
+     * @param {string} [state] Event state
+     * @param {string} [lastEventID] SSE last event ID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    walletNotifications(walletId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<WalletNotification[], any, {}>>;
+    walletNotifications(walletId: string, eventType?: string, state?: string, lastEventID?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<File, any, {}>>;
     /**
      * Update wallet metadata and configuration.
      * @param {string} walletId

package/api.js

@@ -2320,12 +2320,15 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Provides first-in-first-out queue of notifications for a specific wallet.
+         * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
          * @param {string} walletId Wallet ID
+         * @param {string} [eventType] Event type
+         * @param {string} [state] Event state
+         * @param {string} [lastEventID] SSE last event ID
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        walletNotifications: (walletId_1, ...args_1) => __awaiter(this, [walletId_1, ...args_1], void 0, function* (walletId, options = {}) {
+        walletNotifications: (walletId_1, eventType_1, state_1, lastEventID_1, ...args_1) => __awaiter(this, [walletId_1, eventType_1, state_1, lastEventID_1, ...args_1], void 0, function* (walletId, eventType, state, lastEventID, options = {}) {
             // verify required parameter 'walletId' is not null or undefined
             (0, common_1.assertParamExists)('walletNotifications', 'walletId', walletId);
             const localVarPath = `/wallets/{wallet_id}/notifications`
@@ -2342,7 +2345,16 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             // authentication accessToken required
             // http bearer authentication required
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
-            localVarHeaderParameter['Accept'] = 'application/json';
+            if (eventType !== undefined) {
+                localVarQueryParameter['eventType'] = eventType;
+            }
+            if (state !== undefined) {
+                localVarQueryParameter['state'] = state;
+            }
+            localVarHeaderParameter['Accept'] = 'text/event-stream,application/json';
+            if (lastEventID != null) {
+                localVarHeaderParameter['Last-Event-ID'] = String(lastEventID);
+            }
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -3937,15 +3949,18 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Provides first-in-first-out queue of notifications for a specific wallet.
+         * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
          * @param {string} walletId Wallet ID
+         * @param {string} [eventType] Event type
+         * @param {string} [state] Event state
+         * @param {string} [lastEventID] SSE last event ID
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        walletNotifications(walletId, options) {
+        walletNotifications(walletId, eventType, state, lastEventID, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.walletNotifications(walletId, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.walletNotifications(walletId, eventType, state, lastEventID, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['DefaultApi.walletNotifications']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -4819,13 +4834,16 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.walletNotificationHistory(walletId, limit, nextMarker, type, sort, newerThan, options).then((request) => request(axios, basePath));
         },
         /**
-         * Provides first-in-first-out queue of notifications for a specific wallet.
+         * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
          * @param {string} walletId Wallet ID
+         * @param {string} [eventType] Event type
+         * @param {string} [state] Event state
+         * @param {string} [lastEventID] SSE last event ID
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        walletNotifications(walletId, options) {
-            return localVarFp.walletNotifications(walletId, options).then((request) => request(axios, basePath));
+        walletNotifications(walletId, eventType, state, lastEventID, options) {
+            return localVarFp.walletNotifications(walletId, eventType, state, lastEventID, options).then((request) => request(axios, basePath));
         },
         /**
          * Update wallet metadata and configuration.
@@ -5579,13 +5597,16 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).walletNotificationHistory(walletId, limit, nextMarker, type, sort, newerThan, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Provides first-in-first-out queue of notifications for a specific wallet.
+     * Provides SSE stream of notifications for a specific wallet. Supports replay of queued notifications via `Last-Event-Id` header parameter.
      * @param {string} walletId Wallet ID
+     * @param {string} [eventType] Event type
+     * @param {string} [state] Event state
+     * @param {string} [lastEventID] SSE last event ID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    walletNotifications(walletId, options) {
-        return (0, exports.DefaultApiFp)(this.configuration).walletNotifications(walletId, options).then((request) => request(this.axios, this.basePath));
+    walletNotifications(walletId, eventType, state, lastEventID, options) {
+        return (0, exports.DefaultApiFp)(this.configuration).walletNotifications(walletId, eventType, state, lastEventID, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * Update wallet metadata and configuration.

package/client.d.ts

@@ -1,5 +1,6 @@
 import { AxiosInstance } from "axios";
 import { DefaultApi } from "./api";
+import { WalletNotificationStream, WalletNotificationStreamOptions } from "./notifications";
 export type ClientConfiguration = {
     clientId: string;
     clientSecret: string;
@@ -14,4 +15,10 @@ export declare class Client extends DefaultApi {
     protected baseURL: string;
     protected axios: AxiosInstance;
     constructor(tokenUrl: string, audience: string, clientId: string, clientSecret: string, baseURL: string, axios?: AxiosInstance);
+    /**
+     * Opens a live stream of notifications for a wallet over SSE.
+     * @param walletId Wallet ID
+     * @param options Stream filtering/reconnect options
+     */
+    streamWalletNotifications(walletId: string, options?: WalletNotificationStreamOptions): WalletNotificationStream;
 }

package/client.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = void 0;
 const api_1 = require("./api");
+const notifications_1 = require("./notifications");
 const axios_1 = __importDefault(require("axios"));
 const auth_1 = require("./auth");
 /**
@@ -23,6 +24,14 @@ class Client extends api_1.DefaultApi {
         this.baseURL = baseURL;
         this.axios = axios;
     }
+    /**
+     * Opens a live stream of notifications for a wallet over SSE.
+     * @param walletId Wallet ID
+     * @param options Stream filtering/reconnect options
+     */
+    streamWalletNotifications(walletId, options = {}) {
+        return new notifications_1.WalletNotificationStream(this.configuration, walletId, Object.assign({ axios: this.axios, basePath: this.basePath }, options));
+    }
 }
 exports.Client = Client;
 function isJsonMime(mime) {

package/notifications.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Hand-written client for the `walletNotifications` SSE endpoint.
+ *
+ * This file is NOT managed by the OpenAPI generator (see .openapi-generator/FILES) -
+ * it builds on top of the generated request builder in `api.ts` to provide an
+ * ergonomic Node.js client for the `GET /wallets/{wallet_id}/notifications`
+ * `text/event-stream` endpoint, including reconnect-with-replay via `Last-Event-ID`.
+ */
+import { EventEmitter } from 'events';
+import type { AxiosInstance } from 'axios';
+import { Configuration } from './configuration';
+import { WalletNotification } from './api';
+export interface WalletNotificationStreamOptions {
+    /** Filter the stream to a single notification event type. */
+    eventType?: string;
+    /** Filter the stream to a single notification state. */
+    state?: string;
+    /** Resume the stream after this event ID (queued notification replay). */
+    lastEventId?: string;
+    /** Axios instance to use for the underlying request. Defaults to the global axios instance. */
+    axios?: AxiosInstance;
+    /** Overrides the base path used to reach the API. */
+    basePath?: string;
+    /** Automatically reconnect (with replay via Last-Event-ID) when the stream drops. Defaults to true. */
+    reconnect?: boolean;
+    /** Delay before reconnecting when the server hasn't sent an SSE `retry:` field. Defaults to 3000ms. */
+    retryDelayMs?: number;
+    /** Upper bound for the reconnect delay, including any server-provided `retry:` value. Defaults to 30000ms. */
+    maxRetryDelayMs?: number;
+}
+export declare interface WalletNotificationStream {
+    on(event: 'open', listener: () => void): this;
+    on(event: 'notification', listener: (notification: WalletNotification) => void): this;
+    on(event: 'error', listener: (error: Error) => void): this;
+    on(event: 'close', listener: () => void): this;
+    once(event: 'open', listener: () => void): this;
+    once(event: 'notification', listener: (notification: WalletNotification) => void): this;
+    once(event: 'error', listener: (error: Error) => void): this;
+    once(event: 'close', listener: () => void): this;
+}
+/**
+ * Live stream of wallet notifications over `GET /wallets/{wallet_id}/notifications`.
+ *
+ * Emits `open`, `notification`, `error` and `close` events, and is itself an
+ * async iterable of {@link WalletNotification}:
+ *
+ * ```ts
+ * const stream = new WalletNotificationStream(configuration, walletId);
+ * for await (const notification of stream) {
+ *     console.log(notification);
+ * }
+ * ```
+ *
+ * Drops are reconnected automatically (replaying queued notifications via
+ * `Last-Event-ID`) unless `options.reconnect` is set to `false`.
+ */
+export declare class WalletNotificationStream extends EventEmitter implements AsyncIterable<WalletNotification> {
+    private readonly configuration;
+    private readonly walletId;
+    private readonly axiosInstance;
+    private readonly basePath;
+    private readonly eventType?;
+    private readonly state?;
+    private readonly reconnect;
+    private readonly retryDelayMs;
+    private readonly maxRetryDelayMs;
+    private lastEventId?;
+    private nextRetryDelayMs?;
+    private abortController?;
+    private retryTimer?;
+    private closed;
+    private readonly queue;
+    private readonly waiters;
+    constructor(configuration: Configuration, walletId: string, options?: WalletNotificationStreamOptions);
+    /** Stops the stream and prevents further reconnection attempts. */
+    close(): void;
+    get isClosed(): boolean;
+    private connect;
+    private scheduleReconnect;
+    private dispatchToQueue;
+    private settleWaiters;
+    [Symbol.asyncIterator](): AsyncIterator<WalletNotification>;
+}

package/notifications.js

@@ -0,0 +1,284 @@
+"use strict";
+/**
+ * Hand-written client for the `walletNotifications` SSE endpoint.
+ *
+ * This file is NOT managed by the OpenAPI generator (see .openapi-generator/FILES) -
+ * it builds on top of the generated request builder in `api.ts` to provide an
+ * ergonomic Node.js client for the `GET /wallets/{wallet_id}/notifications`
+ * `text/event-stream` endpoint, including reconnect-with-replay via `Last-Event-ID`.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletNotificationStream = void 0;
+const events_1 = require("events");
+const axios_1 = __importDefault(require("axios"));
+const base_1 = require("./base");
+const common_1 = require("./common");
+const api_1 = require("./api");
+/**
+ * Parses a raw byte/text stream into Server-Sent Events per the WHATWG spec
+ * (https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation).
+ */
+function parseSseStream(source) {
+    return __asyncGenerator(this, arguments, function* parseSseStream_1() {
+        var _a, e_1, _b, _c;
+        let buffer = '';
+        let eventType;
+        let dataLines = [];
+        let id;
+        let sawData = false;
+        function takeEvent() {
+            const event = sawData
+                ? { kind: 'event', id, event: eventType, data: dataLines.join('\n') }
+                : undefined;
+            eventType = undefined;
+            dataLines = [];
+            sawData = false;
+            return event;
+        }
+        try {
+            for (var _d = true, source_1 = __asyncValues(source), source_1_1; source_1_1 = yield __await(source_1.next()), _a = source_1_1.done, !_a; _d = true) {
+                _c = source_1_1.value;
+                _d = false;
+                const chunk = _c;
+                buffer += typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+                let newlineIndex;
+                while ((newlineIndex = buffer.indexOf('\n')) >= 0) {
+                    let line = buffer.slice(0, newlineIndex);
+                    buffer = buffer.slice(newlineIndex + 1);
+                    if (line.endsWith('\r')) {
+                        line = line.slice(0, -1);
+                    }
+                    if (line === '') {
+                        const event = takeEvent();
+                        if (event)
+                            yield yield __await(event);
+                        continue;
+                    }
+                    if (line.startsWith(':')) {
+                        continue;
+                    }
+                    const colonIndex = line.indexOf(':');
+                    const field = colonIndex === -1 ? line : line.slice(0, colonIndex);
+                    let value = colonIndex === -1 ? '' : line.slice(colonIndex + 1);
+                    if (value.startsWith(' '))
+                        value = value.slice(1);
+                    switch (field) {
+                        case 'event':
+                            eventType = value;
+                            break;
+                        case 'data':
+                            dataLines.push(value);
+                            sawData = true;
+                            break;
+                        case 'id':
+                            // Per spec, an id field containing a NUL character is ignored.
+                            if (!value.includes('\u0000'))
+                                id = value;
+                            break;
+                        case 'retry':
+                            // Unlike `data`/`id`, `retry` is not part of a dispatched event - it
+                            // just updates the reconnection delay for future reconnects.
+                            if (/^\d+$/.test(value))
+                                yield yield __await({ kind: 'retry', delayMs: parseInt(value, 10) });
+                            break;
+                    }
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = source_1.return)) yield __await(_b.call(source_1));
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    });
+}
+/**
+ * Live stream of wallet notifications over `GET /wallets/{wallet_id}/notifications`.
+ *
+ * Emits `open`, `notification`, `error` and `close` events, and is itself an
+ * async iterable of {@link WalletNotification}:
+ *
+ * ```ts
+ * const stream = new WalletNotificationStream(configuration, walletId);
+ * for await (const notification of stream) {
+ *     console.log(notification);
+ * }
+ * ```
+ *
+ * Drops are reconnected automatically (replaying queued notifications via
+ * `Last-Event-ID`) unless `options.reconnect` is set to `false`.
+ */
+class WalletNotificationStream extends events_1.EventEmitter {
+    constructor(configuration, walletId, options = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        super();
+        this.configuration = configuration;
+        this.walletId = walletId;
+        this.closed = false;
+        this.queue = [];
+        this.waiters = [];
+        this.axiosInstance = (_a = options.axios) !== null && _a !== void 0 ? _a : axios_1.default;
+        this.basePath = (_c = (_b = options.basePath) !== null && _b !== void 0 ? _b : configuration.basePath) !== null && _c !== void 0 ? _c : base_1.BASE_PATH;
+        this.eventType = options.eventType;
+        this.state = options.state;
+        this.lastEventId = options.lastEventId;
+        this.reconnect = (_d = options.reconnect) !== null && _d !== void 0 ? _d : true;
+        this.retryDelayMs = (_e = options.retryDelayMs) !== null && _e !== void 0 ? _e : 3000;
+        this.maxRetryDelayMs = (_f = options.maxRetryDelayMs) !== null && _f !== void 0 ? _f : 30000;
+        void this.connect();
+    }
+    /** Stops the stream and prevents further reconnection attempts. */
+    close() {
+        var _a;
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.retryTimer)
+            clearTimeout(this.retryTimer);
+        (_a = this.abortController) === null || _a === void 0 ? void 0 : _a.abort();
+        this.settleWaiters();
+        this.emit('close');
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, e_2, _b, _c;
+            var _d;
+            if (this.closed)
+                return;
+            this.abortController = new AbortController();
+            try {
+                const requestArgs = yield (0, api_1.DefaultApiAxiosParamCreator)(this.configuration).walletNotifications(this.walletId, this.eventType, this.state, this.lastEventId, { signal: this.abortController.signal, responseType: 'stream' });
+                const request = (0, common_1.createRequestFunction)(requestArgs, this.axiosInstance, this.basePath, this.configuration);
+                const response = yield request(this.axiosInstance, this.basePath);
+                this.emit('open');
+                try {
+                    for (var _e = true, _f = __asyncValues(parseSseStream(response.data)), _g; _g = yield _f.next(), _a = _g.done, !_a; _e = true) {
+                        _c = _g.value;
+                        _e = false;
+                        const message = _c;
+                        if (this.closed)
+                            break;
+                        if (message.kind === 'retry') {
+                            this.nextRetryDelayMs = message.delayMs;
+                            continue;
+                        }
+                        if (message.id !== undefined)
+                            this.lastEventId = message.id;
+                        if (!message.data)
+                            continue;
+                        let notification;
+                        try {
+                            notification = JSON.parse(message.data);
+                        }
+                        catch (_h) {
+                            this.emit('error', new Error(`Failed to parse wallet notification payload: ${message.data}`));
+                            continue;
+                        }
+                        this.emit('notification', notification);
+                        this.dispatchToQueue(notification);
+                    }
+                }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                finally {
+                    try {
+                        if (!_e && !_a && (_b = _f.return)) yield _b.call(_f);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                }
+                if (this.closed)
+                    return;
+                this.scheduleReconnect();
+            }
+            catch (err) {
+                if (this.closed)
+                    return;
+                this.emit('error', err instanceof Error ? err : new Error(String(err)));
+                const status = (_d = err === null || err === void 0 ? void 0 : err.response) === null || _d === void 0 ? void 0 : _d.status;
+                if (status !== undefined && status >= 400 && status < 500) {
+                    // Client errors (bad wallet ID, invalid/expired token, ...) won't be fixed by retrying.
+                    this.close();
+                    return;
+                }
+                this.scheduleReconnect();
+            }
+        });
+    }
+    scheduleReconnect() {
+        var _a;
+        if (this.closed || !this.reconnect) {
+            this.close();
+            return;
+        }
+        const delay = Math.min((_a = this.nextRetryDelayMs) !== null && _a !== void 0 ? _a : this.retryDelayMs, this.maxRetryDelayMs);
+        this.retryTimer = setTimeout(() => void this.connect(), delay);
+    }
+    dispatchToQueue(notification) {
+        const waiter = this.waiters.shift();
+        if (waiter) {
+            waiter({ value: notification, done: false });
+        }
+        else {
+            this.queue.push(notification);
+        }
+    }
+    settleWaiters() {
+        while (this.waiters.length) {
+            this.waiters.shift()({ value: undefined, done: true });
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.queue.length) {
+                    return Promise.resolve({ value: this.queue.shift(), done: false });
+                }
+                if (this.closed) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => this.waiters.push(resolve));
+            },
+            return: () => {
+                this.close();
+                return Promise.resolve({ value: undefined, done: true });
+            },
+        };
+    }
+}
+exports.WalletNotificationStream = WalletNotificationStream;

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@triveria/wallet",
   "private": false,
-  "version": "0.0.309",
+  "version": "0.0.314",
   "description": "",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/triveria-com/wallet-sdk-ts.git"
+  },
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",