@triveria/wallet 0.0.308 → 0.0.313

package/api.d.ts

@@ -660,6 +660,10 @@ export interface InitPreAuthOffer {
     'issuerId': string;
     'offerEndpoint'?: string;
     'deferred'?: boolean;
+    /**
+     * ID of an WMP entity with which a WMP connection has already been established. If provided, WMP is used to send the credential offer to the specified recipient.
+     */
+    'wmpEntityId'?: string;
 }
 export interface InputDescriptorSuitableCredentials {
     /**
@@ -1087,6 +1091,10 @@ export interface VpInvalidNotification {
 }
 export interface VpPresentedNotification {
     'credentialIds': Array<string>;
+    /**
+     * True when the presentation was submitted automatically, without user consent, because every requested credential was configured for auto-presentation.
+     */
+    'autoAccepted'?: boolean;
 }
 export interface VpVerifiedNotification {
     'verifierId': string;
@@ -1260,15 +1268,17 @@ export declare const WmpAuthenticateSessionTypeEnum: {
 export type WmpAuthenticateSessionTypeEnum = typeof WmpAuthenticateSessionTypeEnum[keyof typeof WmpAuthenticateSessionTypeEnum];
 /**
  * @type WmpClientRequestBody
- * Action to take on a pending WMP client request, discriminated by `type`: `process` an offer/verification request, `identity_assertion` to present a credential, or `authenticate` to open the session.
+ * Action to take on a pending WMP client request, discriminated by `type`: `process_offer` a pending credential offer, `process_verification_request` a pending verification request, `identity_assertion` to present a credential, or `authenticate` to open the session.
  */
 export type WmpClientRequestBody = {
     type: 'authenticate';
 } & WmpAuthenticateSession | {
     type: 'identity_assertion';
 } & WmpProvideIdentityAssertion | {
-    type: 'process';
-} & WmpProcessClientRequest;
+    type: 'process_offer';
+} & WmpProcessOfferRequest | {
+    type: 'process_verification_request';
+} & WmpProcessVerificationRequest;
 export interface WmpCreateInvitationResponse {
     /**
      * URL at which the invitation can be downloaded
@@ -1317,24 +1327,54 @@ export interface WmpEntityRecord {
     'verified': boolean;
     'identifiers': Array<WmpEntityKeyIdentifier>;
 }
+/**
+ * Metadata for a received WMP message. The body is downloaded as raw bytes from the link this object carries (`bodyUrl`).
+ */
+export interface WmpMessage {
+    /**
+     * Message ID.
+     */
+    'id': string;
+    /**
+     * Sender identifier of the peer that delivered the message.
+     */
+    'from': string;
+    /**
+     * Content type of the primary body.
+     */
+    'contentType': string;
+    /**
+     * Download link for the raw message body.
+     */
+    'bodyUrl': string;
+}
 export interface WmpNotification {
-    'server'?: WmpEntityRecord;
-    'client'?: WmpEntityRecord;
+    'entity'?: WmpEntityRecord;
     'invitationUrl'?: string;
     'id': string;
     'error'?: string;
     'identityAssertion'?: CredentialWrapper;
 }
 /**
- * Process a pending credential offer or verification request identified by the path id.
+ * Process a pending credential offer identified by the path id.
+ */
+export interface WmpProcessOfferRequest {
+    'type': WmpProcessOfferRequestTypeEnum;
+}
+export declare const WmpProcessOfferRequestTypeEnum: {
+    readonly ProcessOffer: "process_offer";
+};
+export type WmpProcessOfferRequestTypeEnum = typeof WmpProcessOfferRequestTypeEnum[keyof typeof WmpProcessOfferRequestTypeEnum];
+/**
+ * Process a pending verification request identified by the path id.
  */
-export interface WmpProcessClientRequest {
-    'type': WmpProcessClientRequestTypeEnum;
+export interface WmpProcessVerificationRequest {
+    'type': WmpProcessVerificationRequestTypeEnum;
 }
-export declare const WmpProcessClientRequestTypeEnum: {
-    readonly Process: "process";
+export declare const WmpProcessVerificationRequestTypeEnum: {
+    readonly ProcessVerificationRequest: "process_verification_request";
 };
-export type WmpProcessClientRequestTypeEnum = typeof WmpProcessClientRequestTypeEnum[keyof typeof WmpProcessClientRequestTypeEnum];
+export type WmpProcessVerificationRequestTypeEnum = typeof WmpProcessVerificationRequestTypeEnum[keyof typeof WmpProcessVerificationRequestTypeEnum];
 /**
  * Provide a credential to present as the identity assertion for the session.
  */
@@ -1816,12 +1856,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
@@ -1898,7 +1941,15 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
      */
     wmpClientGetPendingRequests: (walletId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+     * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+     * @param {string} walletId
+     * @param {string} requestId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpClientGetRequest: (walletId: string, requestId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
      * @param {string} walletId
      * @param {string} requestId
      * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -1945,6 +1996,15 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
      * @throws {RequiredError}
      */
     wmpEntityList: (walletId: string, entityType: WmpEntityListEntityTypeEnum, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+     * @param {string} walletId
+     * @param {string} entityId
+     * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpEntitySendMessage: (walletId: string, entityId: string, body?: File, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
      * @param {string} walletId
@@ -2409,12 +2469,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
@@ -2491,7 +2554,15 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
      */
     wmpClientGetPendingRequests(walletId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<WmpRequest>>>;
     /**
-     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+     * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+     * @param {string} walletId
+     * @param {string} requestId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpClientGetRequest(walletId: string, requestId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<WmpMessage>>;
+    /**
+     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
      * @param {string} walletId
      * @param {string} requestId
      * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -2538,6 +2609,15 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     wmpEntityList(walletId: string, entityType: WmpEntityListEntityTypeEnum, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<WmpEntityRecord>>>;
+    /**
+     * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+     * @param {string} walletId
+     * @param {string} entityId
+     * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpEntitySendMessage(walletId: string, entityId: string, body?: File, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
      * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
      * @param {string} walletId
@@ -3002,12 +3082,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
@@ -3084,7 +3167,15 @@ export declare const DefaultApiFactory: (configuration?: Configuration, basePath
      */
     wmpClientGetPendingRequests(walletId: string, options?: RawAxiosRequestConfig): AxiosPromise<Array<WmpRequest>>;
     /**
-     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+     * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+     * @param {string} walletId
+     * @param {string} requestId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpClientGetRequest(walletId: string, requestId: string, options?: RawAxiosRequestConfig): AxiosPromise<WmpMessage>;
+    /**
+     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
      * @param {string} walletId
      * @param {string} requestId
      * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -3131,6 +3222,15 @@ export declare const DefaultApiFactory: (configuration?: Configuration, basePath
      * @throws {RequiredError}
      */
     wmpEntityList(walletId: string, entityType: WmpEntityListEntityTypeEnum, options?: RawAxiosRequestConfig): AxiosPromise<Array<WmpEntityRecord>>;
+    /**
+     * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+     * @param {string} walletId
+     * @param {string} entityId
+     * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpEntitySendMessage(walletId: string, entityId: string, body?: File, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
      * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
      * @param {string} walletId
@@ -3595,12 +3695,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
@@ -3677,7 +3780,15 @@ export declare class DefaultApi extends BaseAPI {
      */
     wmpClientGetPendingRequests(walletId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<WmpRequest[], any, {}>>;
     /**
-     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+     * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+     * @param {string} walletId
+     * @param {string} requestId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpClientGetRequest(walletId: string, requestId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<WmpMessage, any, {}>>;
+    /**
+     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
      * @param {string} walletId
      * @param {string} requestId
      * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -3724,6 +3835,15 @@ export declare class DefaultApi extends BaseAPI {
      * @throws {RequiredError}
      */
     wmpEntityList(walletId: string, entityType: WmpEntityListEntityTypeEnum, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<WmpEntityRecord[], any, {}>>;
+    /**
+     * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+     * @param {string} walletId
+     * @param {string} entityId
+     * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpEntitySendMessage(walletId: string, entityId: string, body?: File, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
      * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
      * @param {string} walletId

package/api.js

@@ -25,7 +25,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WmpEntityListEntityTypeEnum = exports.CredentialListInteractionEnum = exports.DefaultApi = exports.DefaultApiFactory = exports.DefaultApiFp = exports.DefaultApiAxiosParamCreator = exports.XadesSignatureType = exports.WmpRequestType = exports.WmpProvideIdentityAssertionTypeEnum = exports.WmpProcessClientRequestTypeEnum = exports.WmpAuthenticateSessionTypeEnum = exports.WalletNotificationEventType = exports.WalletCapability = exports.TrustListKind = exports.TrustFrameworkType = exports.SystemImpactStatusEnum = exports.SigningKeyIdentifier = exports.RevokeAccreditationRequestTypeEnum = exports.PresentationDefinitionSubmissionRequirementsRuleEnum = exports.OidcRevisionOidc4vpEnum = exports.OidcRevisionOidc4vciEnum = exports.ObjectVerticalAlignment = exports.ObjectHorizontalAlignment = exports.ListSort = exports.InteractionAuthorizationRequirementsRequirementTypeEnum = exports.HealthStatusStatusEnum = exports.EntityAccreditationRequestTypeEnum = exports.DocumentSignatureValidityVerificationResultEnum = exports.DeferredStatusEnum = exports.CredentialPropertyToVerify = exports.CredentialNotificationEventTypeEnum = exports.CredentialMetadataStatusEnum = exports.CredentialMetadataInteractionEnum = exports.CredentialIssuerDefinitionAuthorizationEnum = exports.CredentialIssuerDefinitionCredentialIssuerEnum = exports.CredentialFormat = exports.CertificateStatus = exports.AccreditationRequestTypeEnum = void 0;
+exports.WmpEntityListEntityTypeEnum = exports.CredentialListInteractionEnum = exports.DefaultApi = exports.DefaultApiFactory = exports.DefaultApiFp = exports.DefaultApiAxiosParamCreator = exports.XadesSignatureType = exports.WmpRequestType = exports.WmpProvideIdentityAssertionTypeEnum = exports.WmpProcessVerificationRequestTypeEnum = exports.WmpProcessOfferRequestTypeEnum = exports.WmpAuthenticateSessionTypeEnum = exports.WalletNotificationEventType = exports.WalletCapability = exports.TrustListKind = exports.TrustFrameworkType = exports.SystemImpactStatusEnum = exports.SigningKeyIdentifier = exports.RevokeAccreditationRequestTypeEnum = exports.PresentationDefinitionSubmissionRequirementsRuleEnum = exports.OidcRevisionOidc4vpEnum = exports.OidcRevisionOidc4vciEnum = exports.ObjectVerticalAlignment = exports.ObjectHorizontalAlignment = exports.ListSort = exports.InteractionAuthorizationRequirementsRequirementTypeEnum = exports.HealthStatusStatusEnum = exports.EntityAccreditationRequestTypeEnum = exports.DocumentSignatureValidityVerificationResultEnum = exports.DeferredStatusEnum = exports.CredentialPropertyToVerify = exports.CredentialNotificationEventTypeEnum = exports.CredentialMetadataStatusEnum = exports.CredentialMetadataInteractionEnum = exports.CredentialIssuerDefinitionAuthorizationEnum = exports.CredentialIssuerDefinitionCredentialIssuerEnum = exports.CredentialFormat = exports.CertificateStatus = exports.AccreditationRequestTypeEnum = void 0;
 const axios_1 = __importDefault(require("axios"));
 // Some imports not used depending on template conditions
 // @ts-ignore
@@ -211,8 +211,11 @@ exports.WalletNotificationEventType = {
 exports.WmpAuthenticateSessionTypeEnum = {
     Authenticate: 'authenticate',
 };
-exports.WmpProcessClientRequestTypeEnum = {
-    Process: 'process',
+exports.WmpProcessOfferRequestTypeEnum = {
+    ProcessOffer: 'process_offer',
+};
+exports.WmpProcessVerificationRequestTypeEnum = {
+    ProcessVerificationRequest: 'process_verification_request',
 };
 exports.WmpProvideIdentityAssertionTypeEnum = {
     IdentityAssertion: 'identity_assertion',
@@ -2317,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`
@@ -2339,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);
@@ -2685,7 +2700,45 @@ const DefaultApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+         * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+         * @param {string} walletId
+         * @param {string} requestId
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        wmpClientGetRequest: (walletId_1, requestId_1, ...args_1) => __awaiter(this, [walletId_1, requestId_1, ...args_1], void 0, function* (walletId, requestId, options = {}) {
+            // verify required parameter 'walletId' is not null or undefined
+            (0, common_1.assertParamExists)('wmpClientGetRequest', 'walletId', walletId);
+            // verify required parameter 'requestId' is not null or undefined
+            (0, common_1.assertParamExists)('wmpClientGetRequest', 'requestId', requestId);
+            const localVarPath = `/wmp/client/requests/{request_id}`
+                .replace('{request_id}', encodeURIComponent(String(requestId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication accessToken required
+            // http bearer authentication required
+            yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            if (walletId != null) {
+                localVarHeaderParameter['wallet-id'] = String(walletId);
+            }
+            (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);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
          * @param {string} walletId
          * @param {string} requestId
          * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -2915,6 +2968,51 @@ const DefaultApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+         * @param {string} walletId
+         * @param {string} entityId
+         * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        wmpEntitySendMessage: (walletId_1, entityId_1, body_1, ...args_1) => __awaiter(this, [walletId_1, entityId_1, body_1, ...args_1], void 0, function* (walletId, entityId, body, options = {}) {
+            // verify required parameter 'walletId' is not null or undefined
+            (0, common_1.assertParamExists)('wmpEntitySendMessage', 'walletId', walletId);
+            // verify required parameter 'entityId' is not null or undefined
+            (0, common_1.assertParamExists)('wmpEntitySendMessage', 'entityId', entityId);
+            const localVarPath = `/wmp/entities/{entity_id}/messages`
+                .replace('{entity_id}', encodeURIComponent(String(entityId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            const localVarFormParams = new ((configuration && configuration.formDataCtor) || FormData)();
+            // authentication accessToken required
+            // http bearer authentication required
+            yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            if (body !== undefined) {
+                localVarFormParams.append('body', body);
+            }
+            localVarHeaderParameter['Content-Type'] = 'multipart/form-data';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            if (walletId != null) {
+                localVarHeaderParameter['wallet-id'] = String(walletId);
+            }
+            (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);
+            localVarRequestOptions.data = localVarFormParams;
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
          * @param {string} walletId
@@ -3851,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);
@@ -4021,7 +4122,23 @@ const DefaultApiFp = function (configuration) {
             });
         },
         /**
-         * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+         * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+         * @param {string} walletId
+         * @param {string} requestId
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        wmpClientGetRequest(walletId, requestId, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.wmpClientGetRequest(walletId, requestId, 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.wmpClientGetRequest']) === 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);
+            });
+        },
+        /**
+         * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
          * @param {string} walletId
          * @param {string} requestId
          * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -4116,6 +4233,23 @@ const DefaultApiFp = function (configuration) {
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+         * @param {string} walletId
+         * @param {string} entityId
+         * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        wmpEntitySendMessage(walletId, entityId, body, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.wmpEntitySendMessage(walletId, entityId, body, 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.wmpEntitySendMessage']) === 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);
+            });
+        },
         /**
          * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
          * @param {string} walletId
@@ -4700,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.
@@ -4804,7 +4941,17 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
             return localVarFp.wmpClientGetPendingRequests(walletId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+         * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+         * @param {string} walletId
+         * @param {string} requestId
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        wmpClientGetRequest(walletId, requestId, options) {
+            return localVarFp.wmpClientGetRequest(walletId, requestId, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
          * @param {string} walletId
          * @param {string} requestId
          * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -4863,6 +5010,17 @@ const DefaultApiFactory = function (configuration, basePath, axios) {
         wmpEntityList(walletId, entityType, options) {
             return localVarFp.wmpEntityList(walletId, entityType, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+         * @param {string} walletId
+         * @param {string} entityId
+         * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        wmpEntitySendMessage(walletId, entityId, body, options) {
+            return localVarFp.wmpEntitySendMessage(walletId, entityId, body, options).then((request) => request(axios, basePath));
+        },
         /**
          * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
          * @param {string} walletId
@@ -5439,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.
@@ -5543,7 +5704,17 @@ class DefaultApi extends base_1.BaseAPI {
         return (0, exports.DefaultApiFp)(this.configuration).wmpClientGetPendingRequests(walletId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process` a credential offer / verification request (returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
+     * Returns metadata for the received message identified by `request_id` (delivered via a `wmp.message` notification carrying its id): its content type and body download link. The body is fetched as raw bytes from the download link included in the response (`bodyUrl`).
+     * @param {string} walletId
+     * @param {string} requestId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpClientGetRequest(walletId, requestId, options) {
+        return (0, exports.DefaultApiFp)(this.configuration).wmpClientGetRequest(walletId, requestId, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Acts on a pending WMP client request identified by `request_id`. The body\'s `type` selects the action: `process_offer` a pending credential offer or `process_verification_request` a pending verification request (either returns its authorization requirements), `identity_assertion` to present a credential as the session identity assertion, or `authenticate` to open the session after the assertion exchange.
      * @param {string} walletId
      * @param {string} requestId
      * @param {WmpClientRequestBody} wmpClientRequestBody
@@ -5602,6 +5773,17 @@ class DefaultApi extends base_1.BaseAPI {
     wmpEntityList(walletId, entityType, options) {
         return (0, exports.DefaultApiFp)(this.configuration).wmpEntityList(walletId, entityType, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Sends a free-form WMP message to a connected entity. The session is auto-resumed if its transport has dropped. The peer receives it as a `wmp.message` notification and can then read the message metadata from `GET /wmp/client/requests/{request_id}` and download its body via the download link it contains.  The request is `multipart/form-data`. Supply the primary body as either the `body` text field (plain text) or a `body` file part (any content type, taken from the part).
+     * @param {string} walletId
+     * @param {string} entityId
+     * @param {File} [body] The primary message body: a plain-text form value, or a file part whose Content-Type becomes the message content type.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    wmpEntitySendMessage(walletId, entityId, body, options) {
+        return (0, exports.DefaultApiFp)(this.configuration).wmpEntitySendMessage(walletId, entityId, body, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Re-establishes or confirms the WebSocket connection to a WMP server entity. Used to reconnect after a dropped connection so the wallet can resume receiving pending requests.
      * @param {string} walletId

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.308",
+  "version": "0.0.313",
   "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",