o2g-node-sdk 2.5.6 → 2.5.8

package/README.md

@@ -54,6 +54,32 @@ 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`
+
 ## What's New in 2.5.6
 
 - Fixed a syntax error in the `UserManagement` service that prevented compiling `createUsers`
@@ -244,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 }) => {
@@ -535,7 +565,7 @@ This SDK follows the O2G API version it targets:
 - **Minor**: O2G API patch version (currently 7.5 → 5)
 - **Patch**: SDK release number
 
-For example, `2.5.5` targets O2G API version 2.7.5.
+For example, `2.5.0` targets O2G API version 2.7.5.
 
 ## License
 

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;
@@ -39846,7 +39874,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _User_companyPhone, _User_firstName, _User_lastName, _User_loginName, _User_voicemail, _User_devices, _User_nodeId, _User_externalLogin;
+var _User_companyPhone, _User_firstName, _User_lastName, _User_loginName, _User_voicemail, _User_devices, _User_nodeId, _User_externalLogin, _User_emailaddress;
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.User = void 0;
 const device_1 = __webpack_require__(/*! ../common/device */ "./src/types/common/device.ts");
@@ -39869,9 +39897,10 @@ class User {
      * @param devices - The user's devices, or undefined if none
      * @param nodeId - The OmniPCX Enterprise node ID
      * @param externalLogin - The user's external login, or undefined if none
+     * @param emailAddress - The user's email address, or undefined if none
      * @private
      */
-    constructor(companyPhone, firstName, lastName, loginName, voicemail, devices, nodeId, externalLogin) {
+    constructor(companyPhone, firstName, lastName, loginName, voicemail, devices, nodeId, externalLogin, emailAddess) {
         _User_companyPhone.set(this, void 0);
         _User_firstName.set(this, void 0);
         _User_lastName.set(this, void 0);
@@ -39880,6 +39909,7 @@ class User {
         _User_devices.set(this, void 0);
         _User_nodeId.set(this, void 0);
         _User_externalLogin.set(this, void 0);
+        _User_emailaddress.set(this, void 0);
         __classPrivateFieldSet(this, _User_companyPhone, companyPhone, "f");
         __classPrivateFieldSet(this, _User_firstName, firstName, "f");
         __classPrivateFieldSet(this, _User_lastName, lastName, "f");
@@ -39888,6 +39918,7 @@ class User {
         __classPrivateFieldSet(this, _User_devices, devices, "f");
         __classPrivateFieldSet(this, _User_nodeId, nodeId, "f");
         __classPrivateFieldSet(this, _User_externalLogin, externalLogin, "f");
+        __classPrivateFieldSet(this, _User_emailaddress, emailAddess, "f");
     }
     /**
      * Returns the user's company phone number.
@@ -39946,6 +39977,13 @@ class User {
     get externalLogin() {
         return __classPrivateFieldGet(this, _User_externalLogin, "f") ?? null;
     }
+    /**
+     * Returns the user's email address.
+     * @returns The email address, or null if none
+     */
+    get emailAddress() {
+        return __classPrivateFieldGet(this, _User_emailaddress, "f") ?? null;
+    }
     /**
      * Creates a new {@link User} instance from JSON data.
      *
@@ -39957,11 +39995,11 @@ class User {
      */
     /** @internal */
     static fromJson(json) {
-        return new User(json.companyPhone, json.firstName, json.lastName, json.loginName, json.voicemail ? voicemail_1.Voicemail.fromJson(json.voicemail) : null, json.devices?.map((d) => device_1.Device.fromJson(d)), Number(json.nodeId), json.externalLogin);
+        return new User(json.companyPhone, json.firstName, json.lastName, json.loginName, json.voicemail ? voicemail_1.Voicemail.fromJson(json.voicemail) : null, json.devices?.map((d) => device_1.Device.fromJson(d)), Number(json.nodeId), json.externalLogin, json.eMailAddress);
     }
 }
 exports.User = User;
-_User_companyPhone = new WeakMap(), _User_firstName = new WeakMap(), _User_lastName = new WeakMap(), _User_loginName = new WeakMap(), _User_voicemail = new WeakMap(), _User_devices = new WeakMap(), _User_nodeId = new WeakMap(), _User_externalLogin = new WeakMap();
+_User_companyPhone = new WeakMap(), _User_firstName = new WeakMap(), _User_lastName = new WeakMap(), _User_loginName = new WeakMap(), _User_voicemail = new WeakMap(), _User_devices = new WeakMap(), _User_nodeId = new WeakMap(), _User_externalLogin = new WeakMap(), _User_emailaddress = new WeakMap();
 
 
 /***/ },