o2g-node-sdk 2.5.7 → 2.5.8

package/README.md

@@ -54,6 +54,28 @@ await O2G.telephony.makeCall("1234", "5678");
 await O2G.shutdown();
 ```
 
+## What's New in 2.5.8
+
+### Service instance caching — fixes listeners silenced after recovery
+
+Service getters (`O2G.eventSummary`, `O2G.telephony`, …) now return the **same
+instance** for the lifetime of a session. Previously every call created a new
+object, and because each constructor silently overwrites the shared `EventSink`
+registration, any listener attached to an earlier instance would stop receiving
+events — a particularly subtle failure after session recovery.
+
+The instances are automatically invalidated on `O2G_SESSION_LOST` and
+`O2G_RECONNECTED`, so the first access after recovery always binds to the new
+session. Re-attach your listeners once in the `O2G_RECONNECTED` handler and they
+will keep working across any number of recovery cycles.
+
+```typescript
+O2G.on(O2G.O2G_RECONNECTED, () => {
+    // Re-attach — O2G.eventSummary now returns a fresh instance
+    O2G.eventSummary.on(EventSummary.ON_EVENT_SUMMARY_UPDATED, onEventSummary);
+});
+```
+
 ## What's New in 2.5.7
 
 - Add new field `emailAddress` in object `User`
@@ -248,6 +270,10 @@ O2G.on(O2G.O2G_SESSION_LOST, ({ reason }) => {
 
 O2G.on(O2G.O2G_RECONNECTED, () => {
     console.log("Session recovered — resuming activity.");
+    // Re-attach service listeners here: each service getter returns a fresh
+    // instance after recovery, so listeners registered before the outage must
+    // be re-registered (see "Service instance caching" in What's New 2.5.8).
+    O2G.eventSummary.on(EventSummary.ON_EVENT_SUMMARY_UPDATED, onEventSummary);
 });
 
 O2G.on(O2G.O2G_SERVER_SWITCHED, ({ from, to }) => {

package/dist/o2g-node-sdk.js

@@ -11420,6 +11420,34 @@ class O2G {
             throw new Error('O2G has already been initialized.');
         }
         this._application = new o2g_application_1.default(appName, servers, apiVersion);
+        // Service instances are cached per session (see getters below).
+        // On O2G_SESSION_LOST the cache is cleared so stale references are dropped
+        // immediately. On O2G_RECONNECTED the cache is cleared again so that the
+        // first post-recovery access always creates a fresh instance bound to the
+        // new Session — regardless of any transient access that may have occurred
+        // during the outage. Both listeners are registered first so they run before
+        // any application-level handlers (EventEmitter preserves registration order).
+        this._application.on(o2g_application_1.O2G_SESSION_LOST, () => this._clearServiceCache());
+        this._application.on(o2g_application_1.O2G_RECONNECTED, () => this._clearServiceCache());
+    }
+    static _clearServiceCache() {
+        this._routing = null;
+        this._eventSummary = null;
+        this._users = null;
+        this._usersManagement = null;
+        this._telephony = null;
+        this._directory = null;
+        this._comlog = null;
+        this._analytics = null;
+        this._callCenterAgent = null;
+        this._callCenterPilot = null;
+        this._callCenterRealtime = null;
+        this._callCenterStatistics = null;
+        this._callCenterManagement = null;
+        this._maintenance = null;
+        this._pbxManagement = null;
+        this._phoneSetProgramming = null;
+        this._messaging = null;
     }
     /**
      * Sets a custom {@link SessionMonitoringPolicy} to control how the SDK
@@ -11533,7 +11561,7 @@ class O2G {
     static get routing() {
         if (!this._application)
             throw new Error('Routing service not available.');
-        return this._application.getRoutingService();
+        return this._routing ?? (this._routing = this._application.getRoutingService());
     }
     /**
      * Returns the {@link EventSummary} service, which provides access to event summary counters.
@@ -11542,7 +11570,7 @@ class O2G {
     static get eventSummary() {
         if (!this._application)
             throw new Error('EventSummary service not available.');
-        return this._application.getEventSummaryService();
+        return this._eventSummary ?? (this._eventSummary = this._application.getEventSummaryService());
     }
     /**
      * Returns the {@link Users} service, which provides user profile and preference management.
@@ -11551,7 +11579,7 @@ class O2G {
     static get users() {
         if (!this._application)
             throw new Error('Users service not available.');
-        return this._application.getUsersService();
+        return this._users ?? (this._users = this._application.getUsersService());
     }
     /**
      * Returns the {@link UsersManagement} service, which provides administrator-level user management.
@@ -11560,7 +11588,7 @@ class O2G {
     static get usersManagement() {
         if (!this._application)
             throw new Error('UsersManagement service not available.');
-        return this._application.getUserManagementService();
+        return this._usersManagement ?? (this._usersManagement = this._application.getUserManagementService());
     }
     /**
      * Returns the {@link Telephony} service, which provides call control and telephony operations.
@@ -11569,7 +11597,7 @@ class O2G {
     static get telephony() {
         if (!this._application)
             throw new Error('Telephony service not available.');
-        return this._application.getTelephonyService();
+        return this._telephony ?? (this._telephony = this._application.getTelephonyService());
     }
     /**
      * Returns the {@link Directory} service, which provides enterprise directory search.
@@ -11578,7 +11606,7 @@ class O2G {
     static get directory() {
         if (!this._application)
             throw new Error('Directory service not available.');
-        return this._application.getDirectoryService();
+        return this._directory ?? (this._directory = this._application.getDirectoryService());
     }
     /**
      * Returns the {@link CommunicationLog} service, which provides access to communication history records.
@@ -11587,7 +11615,7 @@ class O2G {
     static get comlog() {
         if (!this._application)
             throw new Error('CommunicationLog service not available.');
-        return this._application.getCommunicationLogService();
+        return this._comlog ?? (this._comlog = this._application.getCommunicationLogService());
     }
     /**
      * Returns the {@link Analytics} service, which provides access to charging and incident data.
@@ -11596,7 +11624,7 @@ class O2G {
     static get analytics() {
         if (!this._application)
             throw new Error('Analytics service not available.');
-        return this._application.getAnalyticsService();
+        return this._analytics ?? (this._analytics = this._application.getAnalyticsService());
     }
     /**
      * Returns the {@link CallCenterAgent} service, which provides ACD agent state and skill management.
@@ -11605,7 +11633,7 @@ class O2G {
     static get callCenterAgent() {
         if (!this._application)
             throw new Error('CallCenterAgent service not available.');
-        return this._application.getCallCenterAgentService();
+        return this._callCenterAgent ?? (this._callCenterAgent = this._application.getCallCenterAgentService());
     }
     /**
      * Returns the {@link CallCenterPilot} service, which provides CCD pilot monitoring.
@@ -11614,7 +11642,7 @@ class O2G {
     static get callCenterPilot() {
         if (!this._application)
             throw new Error('CallCenterPilot service not available.');
-        return this._application.getCallCenterPilotService();
+        return this._callCenterPilot ?? (this._callCenterPilot = this._application.getCallCenterPilotService());
     }
     /**
      * Returns the {@link CallCenterRealtime} service, which provides real-time ACD statistics and RTI data.
@@ -11623,7 +11651,7 @@ class O2G {
     static get callCenterRealtime() {
         if (!this._application)
             throw new Error('CallCenterRealtime service not available.');
-        return this._application.getCallCenterRealtimeService();
+        return this._callCenterRealtime ?? (this._callCenterRealtime = this._application.getCallCenterRealtimeService());
     }
     /**
      * Returns the {@link CallCenterStatistics} service, which provides historical ACD statistics and reporting.
@@ -11632,7 +11660,7 @@ class O2G {
     static get callCenterStatistics() {
         if (!this._application)
             throw new Error('CallCenterStatistics service not available.');
-        return this._application.getCallCenterStatisticsService();
+        return this._callCenterStatistics ?? (this._callCenterStatistics = this._application.getCallCenterStatisticsService());
     }
     /**
      * Returns the {@link CallCenterManagement} service, which provides CCD pilot and calendar management.
@@ -11641,7 +11669,7 @@ class O2G {
     static get callCenterManagement() {
         if (!this._application)
             throw new Error('CallCenterManagement service not available.');
-        return this._application.getCallCenterManagementService();
+        return this._callCenterManagement ?? (this._callCenterManagement = this._application.getCallCenterManagementService());
     }
     /**
      * Returns the {@link Maintenance} service, which provides system status and PBX health information.
@@ -11650,7 +11678,7 @@ class O2G {
     static get maintenance() {
         if (!this._application)
             throw new Error('Maintenance service not available.');
-        return this._application.getMaintenanceService();
+        return this._maintenance ?? (this._maintenance = this._application.getMaintenanceService());
     }
     /**
      * Returns the {@link PbxManagement} service, which provides PBX object model access and configuration.
@@ -11659,7 +11687,7 @@ class O2G {
     static get pbxManagement() {
         if (!this._application)
             throw new Error('PbxManagement service not available.');
-        return this._application.getPbxManagementService();
+        return this._pbxManagement ?? (this._pbxManagement = this._application.getPbxManagementService());
     }
     /**
      * Returns the {@link PhoneSetProgramming} service, which provides phone device key and pin management.
@@ -11668,7 +11696,7 @@ class O2G {
     static get phoneSetProgramming() {
         if (!this._application)
             throw new Error('PhoneSetProgramming service not available.');
-        return this._application.getPhoneSetProgrammingService();
+        return this._phoneSetProgramming ?? (this._phoneSetProgramming = this._application.getPhoneSetProgrammingService());
     }
     /**
      * Returns the {@link Messaging} service, which provides voicemail and mailbox management.
@@ -11677,7 +11705,7 @@ class O2G {
     static get messaging() {
         if (!this._application)
             throw new Error('Messaging service not available.');
-        return this._application.getMessagingService();
+        return this._messaging ?? (this._messaging = this._application.getMessagingService());
     }
 }
 exports.O2G = O2G;