@explorins/pers-sdk 2.1.15 → 2.1.18

package/README.md

@@ -453,12 +453,12 @@ unsubscribe();
 
 | Domain | Manager | Events |
 |--------|---------|--------|
-| `authentication` | `sdk.auth` | `LOGIN_SUCCESS` |
-| `user` | `sdk.users` | `PROFILE_UPDATED` |
-| `business` | `sdk.businesses` | `BUSINESS_CREATED`, `BUSINESS_UPDATED`, `MEMBERSHIP_UPDATED` |
-| `campaign` | `sdk.campaigns` | `CAMPAIGN_CLAIMED` |
-| `redemption` | `sdk.redemptions` | `REDEMPTION_COMPLETED` |
-| `transaction` | `sdk.transactions` | `TRANSACTION_CREATED`, `TRANSACTION_SUBMITTED` |
+| `authentication` | `sdk.auth` | `login_success` |
+| `user` | `sdk.users` | `profile_updated` |
+| `business` | `sdk.businesses` | `business_created`, `business_updated`, `membership_updated` |
+| `campaign` | `sdk.campaigns` | `claim_success` |
+| `redemption` | `sdk.redemptions` | `redeem_success` |
+| `transaction` | `sdk.transactions` | `transaction_created`, `transaction_submitted` |
 
 #### Event Types
 

package/dist/chunks/{pers-sdk-BiP7UMJ3.js → pers-sdk-CycADST7.js}

@@ -8,7 +8,7 @@ import { CampaignService, CampaignApi } from '../campaign.js';
 import { a as RedemptionService, R as RedemptionApi } from './redemption-service-C_UTTDag.js';
 import { a as TransactionService, T as TransactionApi } from './transaction-request.builder-C3C19kCx.js';
 import { a as PaymentService, P as PurchaseApi } from './payment-service-IvM6rryM.js';
-import { T as TenantManager } from './tenant-manager-Bbj0bKoo.js';
+import { T as TenantManager } from './tenant-manager-DkWkZfCF.js';
 import { b as buildPaginationParams, n as normalizeToPaginated } from './pagination-utils-9vQ-Npkr.js';
 import { a as AnalyticsService, A as AnalyticsApi } from './analytics-service-vm7B7LhS.js';
 import { DonationService, DonationApi } from '../donation.js';
@@ -1109,6 +1109,12 @@ class PersApiClient {
                     try {
                         const refreshSuccessful = await this.refreshManager.attemptInternalRefresh();
                         if (refreshSuccessful) {
+                            // Emit TOKEN_REFRESHED event so WS clients can retry if they gave up
+                            this._events?.emitSuccess({
+                                type: 'token_refreshed',
+                                domain: 'authentication',
+                                userMessage: 'Authentication token refreshed',
+                            });
                             return await this.request(method, endpoint, body, { ...options, retryCount: 1 });
                         }
                     }
@@ -1495,7 +1501,7 @@ class PersEventEmitter {
      * ```typescript
      * sdk.events.emitSuccess({
      *   domain: 'transaction',  // Only business domains allowed
-     *   type: 'CONFIRMED',
+     *   type: 'transaction_confirmed',
      *   userMessage: 'Transaction confirmed!'
      * });
      * ```
@@ -1522,7 +1528,7 @@ class PersEventEmitter {
      * ```typescript
      * sdk.events.emitError({
      *   domain: 'validation',  // Technical domains allowed
-     *   type: 'INVALID_INPUT',
+     *   type: 'validation_failed',
      *   userMessage: 'Please check your input'
      * });
      * ```
@@ -1656,7 +1662,7 @@ class AuthManager {
             : await authService.loginUser(jwtToken);
         this.events?.emitSuccess({
             domain: 'authentication',
-            type: 'LOGIN_SUCCESS',
+            type: 'login_success',
             userMessage: 'Successfully logged in'
         });
         return result;
@@ -2029,7 +2035,7 @@ class UserManager {
         const result = await this.userService.updateRemoteUser(userData);
         this.events?.emitSuccess({
             domain: 'user',
-            type: 'PROFILE_UPDATED',
+            type: 'profile_updated',
             userMessage: 'Profile updated successfully',
             details: { userId: result.id }
         });
@@ -2309,7 +2315,7 @@ class UserManager {
         const result = await this.userService.deleteUser(identifier);
         this.events?.emitSuccess({
             domain: 'user',
-            type: 'USER_DELETED',
+            type: 'user_deleted',
             userMessage: 'User deleted successfully',
             details: { identifier }
         });
@@ -2342,7 +2348,7 @@ class UserManager {
         const result = await this.userService.restoreUser(identifier);
         this.events?.emitSuccess({
             domain: 'user',
-            type: 'USER_RESTORED',
+            type: 'user_restored',
             userMessage: 'User restored successfully',
             details: { identifier, userId: result.id }
         });
@@ -3032,7 +3038,7 @@ class BusinessManager {
         const result = await this.businessService.createBusinessByDisplayName(displayName);
         this.events?.emitSuccess({
             domain: 'business',
-            type: 'BUSINESS_CREATED',
+            type: 'business_created',
             userMessage: 'Business created successfully',
             details: { businessId: result.id, displayName: result.displayName }
         });
@@ -3067,7 +3073,7 @@ class BusinessManager {
         const result = await this.businessService.updateBusiness(businessId, businessData);
         this.events?.emitSuccess({
             domain: 'business',
-            type: 'BUSINESS_UPDATED',
+            type: 'business_updated',
             userMessage: 'Business updated successfully',
             details: { businessId: result.id, displayName: result.displayName }
         });
@@ -3239,7 +3245,7 @@ class BusinessManager {
         const result = await this.membershipService.updateMemberRole(businessId, userId, newRole);
         this.events?.emitSuccess({
             domain: 'business',
-            type: 'MEMBERSHIP_UPDATED',
+            type: 'membership_updated',
             userMessage: 'Membership role updated',
             details: { businessId, userId, role: newRole }
         });
@@ -3517,7 +3523,7 @@ class CampaignManager {
         const result = await this.campaignService.claimCampaign(claimRequest);
         this.events?.emitSuccess({
             domain: 'campaign',
-            type: 'CLAIM_SUCCESS',
+            type: 'claim_success',
             userMessage: 'Campaign reward claimed successfully',
             details: { campaignId: claimRequest.campaignId }
         });
@@ -3785,7 +3791,7 @@ class CampaignManager {
         const result = await this.campaignService.createCampaignTrigger(data);
         this.events?.emitSuccess({
             domain: 'campaign',
-            type: 'CAMPAIGN_TRIGGER_CREATED',
+            type: 'campaign_trigger_created',
             userMessage: `Trigger "${data.name}" created successfully`,
             details: { triggerId: result.id, name: data.name }
         });
@@ -3810,7 +3816,7 @@ class CampaignManager {
         const result = await this.campaignService.updateCampaignTrigger(triggerId, data);
         this.events?.emitSuccess({
             domain: 'campaign',
-            type: 'CAMPAIGN_TRIGGER_UPDATED',
+            type: 'campaign_trigger_updated',
             userMessage: 'Trigger updated successfully',
             details: { triggerId, updates: Object.keys(data) }
         });
@@ -3831,7 +3837,7 @@ class CampaignManager {
         const result = await this.campaignService.deleteCampaignTrigger(triggerId);
         this.events?.emitSuccess({
             domain: 'campaign',
-            type: 'CAMPAIGN_TRIGGER_DELETED',
+            type: 'campaign_trigger_deleted',
             userMessage: 'Trigger deleted successfully',
             details: { triggerId }
         });
@@ -3860,7 +3866,7 @@ class CampaignManager {
         const result = await this.campaignService.setCampaignTrigger(campaignId, triggerId);
         this.events?.emitSuccess({
             domain: 'campaign',
-            type: 'CAMPAIGN_TRIGGER_ASSIGNED',
+            type: 'campaign_trigger_assigned',
             userMessage: 'Trigger assigned to campaign',
             details: { campaignId, triggerId }
         });
@@ -3889,7 +3895,7 @@ class CampaignManager {
         const result = await this.campaignService.removeCampaignTrigger(campaignId, triggerId);
         this.events?.emitSuccess({
             domain: 'campaign',
-            type: 'CAMPAIGN_TRIGGER_REMOVED',
+            type: 'campaign_trigger_removed',
             userMessage: 'Trigger removed from campaign',
             details: { campaignId, triggerId }
         });
@@ -4225,7 +4231,7 @@ class CampaignManager {
         const result = await this.campaignService.assignTriggerSourceToCampaign(campaignId, triggerSourceId);
         this.events?.emitSuccess({
             domain: 'campaign',
-            type: 'TRIGGER_SOURCE_ASSIGNED',
+            type: 'trigger_source_assigned',
             userMessage: 'Trigger source assigned to campaign',
             details: { campaignId, triggerSourceId }
         });
@@ -4573,7 +4579,7 @@ class RedemptionManager {
         const result = await this.redemptionService.redeemRedemption(redemptionId);
         this.events?.emitSuccess({
             domain: 'redemption',
-            type: 'REDEEM_SUCCESS',
+            type: 'redeem_success',
             userMessage: 'Reward redeemed successfully',
             details: { redemptionId }
         });
@@ -5091,7 +5097,7 @@ class TransactionManager {
         const result = await this.transactionService.createTransaction(transactionData);
         this.events?.emitSuccess({
             domain: 'transaction',
-            type: 'TRANSACTION_CREATED',
+            type: 'transaction_created',
             userMessage: 'Transaction created successfully',
             details: { transactionId: result.transaction?.id }
         });
@@ -5330,7 +5336,7 @@ class TransactionManager {
         const result = await this.transactionService.submitSignedTransaction(signedTxData);
         this.events?.emitSuccess({
             domain: 'transaction',
-            type: 'TRANSACTION_SUBMITTED',
+            type: 'transaction_submitted',
             userMessage: 'Transaction submitted successfully',
             details: { transactionId: result.transaction?.id }
         });
@@ -7254,7 +7260,7 @@ class TriggerSourceManager {
         const result = await this.triggerSourceService.createTriggerSource(triggerSource);
         this.events?.emitSuccess({
             domain: 'trigger-source',
-            type: 'TRIGGER_SOURCE_CREATED',
+            type: 'trigger_source_created',
             userMessage: 'Trigger source created successfully',
             details: { triggerSourceId: result.id, type: result.type }
         });
@@ -7286,7 +7292,7 @@ class TriggerSourceManager {
         const result = await this.triggerSourceService.updateTriggerSource(triggerSourceId, triggerSource);
         this.events?.emitSuccess({
             domain: 'trigger-source',
-            type: 'TRIGGER_SOURCE_UPDATED',
+            type: 'trigger_source_updated',
             userMessage: 'Trigger source updated successfully',
             details: { triggerSourceId }
         });
@@ -7313,7 +7319,7 @@ class TriggerSourceManager {
         const result = await this.triggerSourceService.deleteTriggerSource(triggerSourceId);
         this.events?.emitSuccess({
             domain: 'trigger-source',
-            type: 'TRIGGER_SOURCE_DELETED',
+            type: 'trigger_source_deleted',
             userMessage: 'Trigger source deleted successfully',
             details: { triggerSourceId }
         });
@@ -7787,7 +7793,7 @@ class WebhookManager {
         const result = await this.webhookService.createWebhook(webhook);
         this.events?.emitSuccess({
             domain: 'webhook',
-            type: 'WEBHOOK_CREATED',
+            type: 'webhook_created',
             userMessage: 'Webhook created successfully',
             details: { webhookId: result.id, name: result.name }
         });
@@ -7804,7 +7810,7 @@ class WebhookManager {
         const result = await this.webhookService.updateWebhook(webhookId, webhook);
         this.events?.emitSuccess({
             domain: 'webhook',
-            type: 'WEBHOOK_UPDATED',
+            type: 'webhook_updated',
             userMessage: 'Webhook updated successfully',
             details: { webhookId }
         });
@@ -7832,7 +7838,7 @@ class WebhookManager {
         const result = await this.webhookService.deleteWebhook(webhookId);
         this.events?.emitSuccess({
             domain: 'webhook',
-            type: 'WEBHOOK_DELETED',
+            type: 'webhook_deleted',
             userMessage: 'Webhook deleted successfully',
             details: { webhookId }
         });
@@ -7889,7 +7895,7 @@ class WebhookManager {
         const result = await this.webhookService.post(hookId, body);
         this.events?.emitSuccess({
             domain: 'webhook',
-            type: 'WEBHOOK_TRIGGERED',
+            type: 'webhook_triggered',
             userMessage: 'Webhook triggered',
             details: { hookId, executionId: result.executionId }
         });
@@ -8459,12 +8465,22 @@ class WalletEventsManager {
         this.client = null;
         this.pendingHandlers = [];
         this.unsubscribes = [];
+        // Track if WS gave up reconnecting (so we can retry on token refresh)
+        this.reconnectGaveUp = false;
+        this.lastSubscriptions = { wallets: [], chains: [] };
         this.config = {
             autoReconnect: true,
             connectionTimeout: 30000,
             debug: false,
             ...config,
         };
+        // Subscribe to auth events to retry WS connection when tokens are refreshed
+        this.authEventUnsubscribe = this.eventEmitter.subscribe((event) => {
+            if (event.type === 'token_refreshed' && this.reconnectGaveUp) {
+                // Tokens were refreshed and WS had given up - retry connection
+                this.retryAfterTokenRefresh();
+            }
+        }, { domains: ['authentication'], levels: ['success'] });
     }
     /**
      * Connect to real-time wallet events
@@ -8493,8 +8509,11 @@ class WalletEventsManager {
         const wsUrl = this.config.wsUrl
             || sdkConfig.walletEventsWsUrl
             || buildWalletEventsWsUrl(sdkConfig.environment);
-        // Create token refresher that fetches fresh token from auth provider
+        // Create token refresher that ensures valid token before reconnecting
+        // This triggers actual token refresh if expired, not just retrieval
         const tokenRefresher = async () => {
+            // Ensure token is refreshed if expired (calls refresh API if needed)
+            await this.apiClient.ensureValidToken();
             const freshToken = await authProvider.getToken();
             if (!freshToken) {
                 throw new Error('Failed to refresh token');
@@ -8509,6 +8528,32 @@ class WalletEventsManager {
             tokenRefresher,
         });
         await this.client.connect(token);
+        // Reset gave-up flag on successful connection
+        this.reconnectGaveUp = false;
+        // Track previous state to detect reconnections and give-ups
+        let previousState = 'connected';
+        // Clean up previous state change listener (prevent duplicate listeners)
+        this.stateChangeUnsubscribe?.();
+        // Listen for state changes
+        this.stateChangeUnsubscribe = this.client.onStateChange((state) => {
+            if (state === 'disconnected' && previousState === 'reconnecting') {
+                // Transitioned from reconnecting to disconnected = exhausted all attempts
+                this.reconnectGaveUp = true;
+            }
+            else if (state === 'connected') {
+                this.reconnectGaveUp = false;
+                // Emit reconnected event so apps can refresh state (catch missed events)
+                if (previousState === 'reconnecting') {
+                    this.eventEmitter.emitSuccess({
+                        type: 'wallet_reconnected',
+                        domain: 'wallet',
+                        userMessage: 'Wallet events reconnected',
+                        details: { previousState }
+                    });
+                }
+            }
+            previousState = state;
+        });
         // Clear previous unsubscribes on new connection (prevent memory leak)
         this.unsubscribes.forEach(unsub => unsub());
         this.unsubscribes = [];
@@ -8525,11 +8570,26 @@ class WalletEventsManager {
      * Disconnect from real-time events
      */
     disconnect() {
+        // Clear gave-up flag to prevent auto-reconnect after intentional disconnect
+        this.reconnectGaveUp = false;
+        this.stateChangeUnsubscribe?.();
+        this.stateChangeUnsubscribe = undefined;
         this.unsubscribes.forEach(unsub => unsub());
         this.unsubscribes = [];
         this.client?.disconnect();
         this.client = null;
     }
+    /**
+     * Full cleanup - disconnect and remove all subscriptions including auth listener
+     * Call this when completely done with the manager (e.g., SDK disposal)
+     */
+    destroy() {
+        this.disconnect();
+        this.authEventUnsubscribe?.();
+        this.authEventUnsubscribe = undefined;
+        this.reconnectGaveUp = false;
+        this.lastSubscriptions = { wallets: [], chains: [] };
+    }
     // ─────────────────────────────────────────────────────────────────────────────
     // Subscription Methods (v1.2.0)
     // ─────────────────────────────────────────────────────────────────────────────
@@ -8554,6 +8614,8 @@ class WalletEventsManager {
         if (!this.client) {
             throw new Error('Not connected. Call connect() first.');
         }
+        // Save subscriptions for auto-resubscribe on reconnect
+        this.lastSubscriptions.wallets = wallets;
         return this.client.subscribeWallets(wallets);
     }
     /**
@@ -8575,6 +8637,8 @@ class WalletEventsManager {
         if (!this.client) {
             throw new Error('Not connected. Call connect() first.');
         }
+        // Save subscriptions for auto-resubscribe on reconnect
+        this.lastSubscriptions.chains = chains;
         return this.client.subscribeChains(chains);
     }
     /**
@@ -8664,6 +8728,36 @@ class WalletEventsManager {
     isConnected() {
         return this.getState() === 'connected';
     }
+    /**
+     * Check if WS reconnection gave up (exhausted all attempts)
+     * Used to determine if we should retry on token refresh
+     */
+    hasReconnectGivenUp() {
+        return this.reconnectGaveUp;
+    }
+    /**
+     * Retry connection after token refresh
+     * Called when auth tokens are refreshed and WS had previously given up
+     * Automatically resubscribes to previous subscriptions
+     */
+    async retryAfterTokenRefresh() {
+        if (!this.reconnectGaveUp) {
+            return; // Not in gave-up state, nothing to retry
+        }
+        try {
+            await this.connect();
+            // Restore previous subscriptions
+            if (this.lastSubscriptions.wallets.length > 0) {
+                await this.subscribeWallets(this.lastSubscriptions.wallets);
+            }
+            if (this.lastSubscriptions.chains.length > 0) {
+                await this.subscribeChains(this.lastSubscriptions.chains);
+            }
+        }
+        catch (error) {
+            console.warn('[WalletEventsManager] Retry after token refresh failed:', error);
+        }
+    }
     /**
      * Get connection info (wallets, active chains)
      */
@@ -8868,7 +8962,7 @@ class PersSDK {
         }
         // Listen for login success events (both fresh login and session restoration)
         this._events.subscribe((event) => {
-            if (event.level === 'success' && (event.type === 'LOGIN_SUCCESS' || event.type === 'session_restored')) {
+            if (event.level === 'success' && (event.type === 'login_success' || event.type === 'session_restored')) {
                 // Auto-connect and subscribe to wallet events (fire and forget, log errors)
                 this.connectWalletEvents().catch((err) => {
                     console.warn('[PersSDK] Failed to auto-connect wallet events:', err.message);
@@ -9482,4 +9576,4 @@ function createPersSDK(httpClient, config) {
 }
 
 export { AuthStatus as A, BusinessManager as B, CampaignManager as C, DefaultAuthProvider as D, FileApi as E, FileManager as F, FileService as G, ApiKeyApi as H, WebhookApi as I, WebhookService as J, PersEventsClient as K, LocalStorageTokenStorage as L, MemoryTokenStorage as M, createPersEventsClient as N, PersSDK as P, RedemptionManager as R, SDK_NAME as S, TokenManager as T, UserManager as U, WebDPoPCryptoProvider as W, AuthTokenManager as a, AUTH_STORAGE_KEYS as b, createPersSDK as c, DPOP_STORAGE_KEYS as d, SDK_VERSION as e, SDK_USER_AGENT as f, PersApiClient as g, DEFAULT_PERS_CONFIG as h, buildApiRoot as i, buildWalletEventsWsUrl as j, StaticJwtAuthProvider as k, AuthApi as l, mergeWithDefaults as m, AuthService as n, DPoPManager as o, PersEventEmitter as p, AuthManager as q, UserStatusManager as r, TransactionManager as s, PurchaseManager as t, ApiKeyManager as u, AnalyticsManager as v, DonationManager as w, TriggerSourceManager as x, WebhookManager as y, WalletEventsManager as z };
-//# sourceMappingURL=pers-sdk-BiP7UMJ3.js.map
+//# sourceMappingURL=pers-sdk-CycADST7.js.map