> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Release notes and version history for the Telnyx WebRTC React Native SDK, including new features, breaking changes, bug fixes, and upgrade guidance.

# CHANGELOG.md

## [0.1.8-beta.0](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.8-beta.0) (2026-02-27)

### Bug Fixing

• Fixed push data race condition in Expo apps — `clearPendingVoipPush()` is now deferred until the CallKit coordinator fulfills the answer, end, or reject action, preventing push data from being consumed and cleared before the user answers
• Fixed duplicate push notification processing by also checking for `CONNECTING` state (not just `CONNECTED`) in `checkForInitialPushNotification`
• Fixed premature protection-flag resets — `hasProcessingCalls()` now returns `true` while `isCallFromPush` is set, preventing the `calls$` subscription from clearing `isHandlingForegroundCall` and `backgroundDetectorIgnore` before the WebRTC call arrives

## [0.1.7](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.7) (2026-02-20)

### Enhancement

• Added `TelnyxVoipClient.isLaunchedFromPushNotification()` static method to check if the app was cold-started from a push notification, allowing consumers to skip auto-login and avoid double-login races
• `createTelnyxVoipClient()` now returns a singleton — safe to call inside React component bodies without creating a new instance on every render
• Added `destroyTelnyxVoipClient()` to tear down the singleton when a fresh instance is needed
• `TelnyxVoiceApp` now automatically wires the `voipClient` on the CallKit coordinator on mount — consumers no longer need to manually call `setVoipClient()` at the correct component level

### Bug Fixing

• Fixed cold-start push notification failures caused by double-login race between user auto-login and SDK internal push login
• Fixed CallKit coordinator having no `voipClient` reference when user answered a call via CallKit before navigating to the correct screen
• Fixed `call_id` extraction in `checkForInitialPushNotification` — the double-nested path `pushData.metadata?.metadata?.call_id` never resolved, so the CallKit coordinator was bypassed on iOS
• Refactored `checkForInitialPushNotification` into `getAndroidPushData` and `getIOSPushData` helpers to reduce nesting and improve readability

### Deprecation

• `setVoipClient()` on `CallKitCoordinator` and `useCallKitCoordinator()` hook is now deprecated — `TelnyxVoiceApp` handles this automatically

## [0.1.7-beta.0](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.7-beta.0) (2026-02-18)

### Bug Fixing

• Fixed `call_id` extraction in `checkForInitialPushNotification` — the double-nested path `pushData.metadata?.metadata?.call_id` never resolved, so the CallKit coordinator was bypassed and all iOS push calls fell through to direct handling
• Refactored `checkForInitialPushNotification` into `getAndroidPushData` and `getIOSPushData` helpers to reduce nesting and improve readability

## [0.1.6](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.6) (2025-12-09)

### Enhancement

• Added Android native components to npm package for proper distribution
• Complete Android native integration support for Firebase messaging and call management

### Bug Fixing

• Fixed missing Android directory in npm package files array
• Resolved native component availability issues for Android integrations

## [0.1.5](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.5) (2025-12-08)

### Enhancement

• Updated to use @telnyx/react-native-voice-sdk\@0.3.0 with advanced media events support

## [0.1.4](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.4) (2025-11-25)

### Enhancement

• Enhanced 4G/WiFi reconnection mechanism for better network handling
• iOS version integration improvements

## [0.1.3](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.3) (2025-11-20)

### Enhancement

• Fixed background answer functionality for iOS
• Added connecting state to Telnyx client
• Improved reconnection logic for Android using foreground service implementation

## [0.1.2](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.2) (2025-11-04)

### Enhancement

• Comprehensive package README with integration examples
• Documentation for credential-based and token-based authentication
• Native integration guides for Android (MainActivity) and iOS (AppDelegate)
• Examples for push notification setup
• Troubleshooting section

### Bug Fixing

• Package metadata and npm publishing configuration

## [0.1.1](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.1) (2025-11-02)

### Enhancement

• Initial npm package release
• Core VoIP client (`TelnyxVoipClient`)
• TelnyxVoiceApp component for React Native lifecycle management
• CallKit integration for iOS native call UI
• Android ConnectionService support
• Push notification handling (FCM for Android, APNs for iOS)
• Reactive state streams with RxJS
• Call management APIs (make, answer, hold, mute, transfer, hangup)
• Connection state management
• Call state machine
• Automatic reconnection logic
• Session management
• TypeScript type definitions

## [0.1.0](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.0) (2025-11-01)

### Enhancement

• Initial development version
• Basic VoIP functionality
• Call management
• State management interfaces