@explorins/pers-sdk 2.1.15 → 2.1.18

package/dist/chunks/{pers-sdk-Cv7hM1I7.cjs → pers-sdk-DMoQbCgs.cjs}

@@ -10,7 +10,7 @@ var campaign = require('../campaign.cjs');
 var redemptionService = require('./redemption-service-C61Qr2vI.cjs');
 var transactionRequest_builder = require('./transaction-request.builder-CW3Wwdi3.cjs');
 var paymentService = require('./payment-service-Bkw7ZXev.cjs');
-var tenantManager = require('./tenant-manager-BUiFM33X.cjs');
+var tenantManager = require('./tenant-manager-B4FygDMF.cjs');
 var paginationUtils = require('./pagination-utils-B2jRHMSO.cjs');
 var analyticsService = require('./analytics-service-CF9AsMQH.cjs');
 var donation = require('../donation.cjs');
@@ -1111,6 +1111,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 });
                         }
                     }
@@ -1497,7 +1503,7 @@ class PersEventEmitter {
      * ```typescript
      * sdk.events.emitSuccess({
      *   domain: 'transaction',  // Only business domains allowed
-     *   type: 'CONFIRMED',
+     *   type: 'transaction_confirmed',
      *   userMessage: 'Transaction confirmed!'
      * });
      * ```
@@ -1524,7 +1530,7 @@ class PersEventEmitter {
      * ```typescript
      * sdk.events.emitError({
      *   domain: 'validation',  // Technical domains allowed
-     *   type: 'INVALID_INPUT',
+     *   type: 'validation_failed',
      *   userMessage: 'Please check your input'
      * });
      * ```
@@ -1658,7 +1664,7 @@ class AuthManager {
             : await authService.loginUser(jwtToken);
         this.events?.emitSuccess({
             domain: 'authentication',
-            type: 'LOGIN_SUCCESS',
+            type: 'login_success',
             userMessage: 'Successfully logged in'
         });
         return result;
@@ -2031,7 +2037,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 }
         });
@@ -2311,7 +2317,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 }
         });
@@ -2344,7 +2350,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 }
         });
@@ -3034,7 +3040,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 }
         });
@@ -3069,7 +3075,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 }
         });
@@ -3241,7 +3247,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 }
         });
@@ -3519,7 +3525,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 }
         });
@@ -3787,7 +3793,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 }
         });
@@ -3812,7 +3818,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) }
         });
@@ -3833,7 +3839,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 }
         });
@@ -3862,7 +3868,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 }
         });
@@ -3891,7 +3897,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 }
         });
@@ -4227,7 +4233,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 }
         });
@@ -4575,7 +4581,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 }
         });
@@ -5093,7 +5099,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 }
         });
@@ -5332,7 +5338,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 }
         });
@@ -7256,7 +7262,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 }
         });
@@ -7288,7 +7294,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 }
         });
@@ -7315,7 +7321,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 }
         });
@@ -7789,7 +7795,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 }
         });
@@ -7806,7 +7812,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 }
         });
@@ -7834,7 +7840,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 }
         });
@@ -7891,7 +7897,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 }
         });
@@ -8461,12 +8467,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
@@ -8495,8 +8511,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');
@@ -8511,6 +8530,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 = [];
@@ -8527,11 +8572,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)
     // ─────────────────────────────────────────────────────────────────────────────
@@ -8556,6 +8616,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);
     }
     /**
@@ -8577,6 +8639,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);
     }
     /**
@@ -8666,6 +8730,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)
      */
@@ -8870,7 +8964,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);
@@ -9528,4 +9622,4 @@ exports.buildWalletEventsWsUrl = buildWalletEventsWsUrl;
 exports.createPersEventsClient = createPersEventsClient;
 exports.createPersSDK = createPersSDK;
 exports.mergeWithDefaults = mergeWithDefaults;
-//# sourceMappingURL=pers-sdk-Cv7hM1I7.cjs.map
+//# sourceMappingURL=pers-sdk-DMoQbCgs.cjs.map