@telnyx/react-voice-commons-sdk 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG.md
 
+## [0.3.1] (2026-04-16)
+
+### Bug Fixing
+
+- Fixed stale `CONNECTED` state during background disconnect: `SessionManager.disconnect()` now emits `DISCONNECTED` before awaiting the underlying client teardown. Previously, observers (including the auto-reconnect logic in `TelnyxVoiceApp`) could read a stale `CONNECTED` value while the socket was being torn down, causing auto-reconnection to be skipped and subsequent `newCall()` attempts to fail with `Cannot make call when connection state is: DISCONNECTED` or `No connection exists. Please connect first.`
+- Tracked calls are now cleared on disconnect. Previously, calls left in non-terminal states when the socket was torn down would accumulate across background/foreground cycles, since a dead socket never emits the `ENDED`/`FAILED` events that normally trigger per-call cleanup.
+
 ## [0.3.0] (2026-04-15)
 
 ### ⚠️ Breaking changes

package/lib/internal/calls/call-state-controller.d.ts

@@ -71,6 +71,13 @@ export declare class CallStateController {
     isWaitingForInvite: () => boolean;
     onInviteAutoAccepted: () => void;
   }): void;
+  /**
+   * Clear all tracked calls. Called when the session disconnects so that
+   * calls left in non-terminal states (because the socket died before
+   * their ENDED/FAILED events could arrive) don't accumulate as ghosts
+   * across reconnect cycles.
+   */
+  clearAllCalls(): void;
   /**
    * Dispose of the controller and clean up resources
    */

package/lib/internal/calls/call-state-controller.js

@@ -161,6 +161,29 @@ class CallStateController {
     this._isWaitingForInvite = callbacks.isWaitingForInvite;
     this._onInviteAutoAccepted = callbacks.onInviteAutoAccepted;
   }
+  /**
+   * Clear all tracked calls. Called when the session disconnects so that
+   * calls left in non-terminal states (because the socket died before
+   * their ENDED/FAILED events could arrive) don't accumulate as ghosts
+   * across reconnect cycles.
+   */
+  clearAllCalls() {
+    if (this._callMap.size === 0) {
+      return;
+    }
+    console.log(
+      `CallStateController: Clearing ${this._callMap.size} tracked call(s) on disconnect`
+    );
+    for (const call of this._callMap.values()) {
+      try {
+        call.dispose();
+      } catch (error) {
+        console.warn('CallStateController: Error disposing call during clear:', error);
+      }
+    }
+    this._callMap.clear();
+    this._calls.next([]);
+  }
   /**
    * Dispose of the controller and clean up resources
    */

package/lib/internal/session/session-manager.d.ts

@@ -15,6 +15,7 @@ export declare class SessionManager {
   private _sessionId;
   private _disposed;
   private _onClientReady?;
+  private _onDisconnect?;
   constructor();
   /**
    * Observable stream of connection state changes
@@ -24,6 +25,11 @@ export declare class SessionManager {
    * Set callback to be called when the Telnyx client is ready
    */
   setOnClientReady(callback: () => void): void;
+  /**
+   * Set callback to be called when the session disconnects, so dependent
+   * subsystems (e.g. the call state controller) can clear their state.
+   */
+  setOnDisconnect(callback: () => void): void;
   /**
    * Current connection state (synchronous access)
    */
@@ -45,7 +51,14 @@ export declare class SessionManager {
    */
   connectWithToken(config: TokenConfig): Promise<void>;
   /**
-   * Disconnect from the Telnyx platform
+   * Disconnect from the Telnyx platform.
+   *
+   * The DISCONNECTED state is emitted BEFORE awaiting the underlying
+   * client teardown so that observers (including the auto-reconnect logic
+   * in TelnyxVoiceApp) cannot read a stale CONNECTED value during the
+   * short window while the socket is being torn down. Tracked calls are
+   * cleared here too, since a torn-down socket will never emit the
+   * ENDED/FAILED events that normally trigger per-call cleanup.
    */
   disconnect(): Promise<void>;
   /**

package/lib/internal/session/session-manager.js

@@ -85,6 +85,13 @@ class SessionManager {
   setOnClientReady(callback) {
     this._onClientReady = callback;
   }
+  /**
+   * Set callback to be called when the session disconnects, so dependent
+   * subsystems (e.g. the call state controller) can clear their state.
+   */
+  setOnDisconnect(callback) {
+    this._onDisconnect = callback;
+  }
   /**
    * Current connection state (synchronous access)
    */
@@ -124,13 +131,28 @@ class SessionManager {
     await this._connect();
   }
   /**
-   * Disconnect from the Telnyx platform
+   * Disconnect from the Telnyx platform.
+   *
+   * The DISCONNECTED state is emitted BEFORE awaiting the underlying
+   * client teardown so that observers (including the auto-reconnect logic
+   * in TelnyxVoiceApp) cannot read a stale CONNECTED value during the
+   * short window while the socket is being torn down. Tracked calls are
+   * cleared here too, since a torn-down socket will never emit the
+   * ENDED/FAILED events that normally trigger per-call cleanup.
    */
   async disconnect() {
     if (this._disposed) {
       return;
     }
     this._currentConfig = undefined;
+    this._connectionState.next(connection_state_1.TelnyxConnectionState.DISCONNECTED);
+    if (this._onDisconnect) {
+      try {
+        this._onDisconnect();
+      } catch (error) {
+        console.error('Error in onDisconnect callback:', error);
+      }
+    }
     if (this._telnyxClient) {
       try {
         await this._telnyxClient.disconnect();
@@ -138,7 +160,6 @@ class SessionManager {
         console.error('Error during disconnect:', error);
       }
     }
-    this._connectionState.next(connection_state_1.TelnyxConnectionState.DISCONNECTED);
   }
   /**
    * Disable push notifications for the current session.

package/lib/telnyx-voip-client.js

@@ -66,6 +66,11 @@ class TelnyxVoipClient {
       );
       this._callStateController.initializeClientListeners();
     });
+    // Clear any tracked calls when the session disconnects, so ghosts
+    // don't accumulate across background → foreground reconnect cycles.
+    this._sessionManager.setOnDisconnect(() => {
+      this._callStateController.clearAllCalls();
+    });
     if (this._options.debug) {
       console.log('TelnyxVoipClient initialized with options:', this._options);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/react-voice-commons-sdk",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "A high-level, state-agnostic, drop-in module for the Telnyx React Native SDK that simplifies WebRTC voice calling integration",
   "main": "lib/index.js",
   "module": "lib/index.js",
@@ -59,7 +59,7 @@
   "homepage": "https://github.com/team-telnyx/react-native-voice-commons",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/team-telnyx/react-native-voice-commons.git"
+    "url": "https://github.com/team-telnyx/react-native-voice-commons.git"
   },
   "bugs": {
     "url": "https://github.com/team-telnyx/react-native-voice-commons/issues"
@@ -112,6 +112,7 @@
     "node": ">=16"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   }
 }

package/src/internal/calls/call-state-controller.ts

@@ -190,6 +190,32 @@ export class CallStateController {
     this._onInviteAutoAccepted = callbacks.onInviteAutoAccepted;
   }
 
+  /**
+   * Clear all tracked calls. Called when the session disconnects so that
+   * calls left in non-terminal states (because the socket died before
+   * their ENDED/FAILED events could arrive) don't accumulate as ghosts
+   * across reconnect cycles.
+   */
+  clearAllCalls(): void {
+    if (this._callMap.size === 0) {
+      return;
+    }
+
+    console.log(
+      `CallStateController: Clearing ${this._callMap.size} tracked call(s) on disconnect`
+    );
+
+    for (const call of this._callMap.values()) {
+      try {
+        call.dispose();
+      } catch (error) {
+        console.warn('CallStateController: Error disposing call during clear:', error);
+      }
+    }
+    this._callMap.clear();
+    this._calls.next([]);
+  }
+
   /**
    * Dispose of the controller and clean up resources
    */

package/src/internal/session/session-manager.ts

@@ -26,6 +26,7 @@ export class SessionManager {
   private _sessionId: string;
   private _disposed = false;
   private _onClientReady?: () => void;
+  private _onDisconnect?: () => void;
 
   constructor() {
     this._sessionId = this._generateSessionId();
@@ -45,6 +46,14 @@ export class SessionManager {
     this._onClientReady = callback;
   }
 
+  /**
+   * Set callback to be called when the session disconnects, so dependent
+   * subsystems (e.g. the call state controller) can clear their state.
+   */
+  setOnDisconnect(callback: () => void): void {
+    this._onDisconnect = callback;
+  }
+
   /**
    * Current connection state (synchronous access)
    */
@@ -91,7 +100,14 @@ export class SessionManager {
   }
 
   /**
-   * Disconnect from the Telnyx platform
+   * Disconnect from the Telnyx platform.
+   *
+   * The DISCONNECTED state is emitted BEFORE awaiting the underlying
+   * client teardown so that observers (including the auto-reconnect logic
+   * in TelnyxVoiceApp) cannot read a stale CONNECTED value during the
+   * short window while the socket is being torn down. Tracked calls are
+   * cleared here too, since a torn-down socket will never emit the
+   * ENDED/FAILED events that normally trigger per-call cleanup.
    */
   async disconnect(): Promise<void> {
     if (this._disposed) {
@@ -99,6 +115,15 @@ export class SessionManager {
     }
 
     this._currentConfig = undefined;
+    this._connectionState.next(TelnyxConnectionState.DISCONNECTED);
+
+    if (this._onDisconnect) {
+      try {
+        this._onDisconnect();
+      } catch (error) {
+        console.error('Error in onDisconnect callback:', error);
+      }
+    }
 
     if (this._telnyxClient) {
       try {
@@ -107,8 +132,6 @@ export class SessionManager {
         console.error('Error during disconnect:', error);
       }
     }
-
-    this._connectionState.next(TelnyxConnectionState.DISCONNECTED);
   }
 
   /**

package/src/telnyx-voip-client.ts

@@ -82,6 +82,12 @@ export class TelnyxVoipClient {
       this._callStateController.initializeClientListeners();
     });
 
+    // Clear any tracked calls when the session disconnects, so ghosts
+    // don't accumulate across background → foreground reconnect cycles.
+    this._sessionManager.setOnDisconnect(() => {
+      this._callStateController.clearAllCalls();
+    });
+
     if (this._options.debug) {
       console.log('TelnyxVoipClient initialized with options:', this._options);
     }