@telnyx/react-voice-commons-sdk 0.1.2 → 0.1.3

package/lib/internal/user-defaults-helpers.js

@@ -1,59 +1,69 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVoipToken = getVoipToken;
 exports.getPendingVoipPush = getPendingVoipPush;
 exports.clearPendingVoipPush = clearPendingVoipPush;
 exports.getPendingVoipAction = getPendingVoipAction;
 exports.clearPendingVoipAction = clearPendingVoipAction;
-const voice_pn_bridge_1 = require('./voice-pn-bridge');
-const react_native_1 = require('react-native');
+const voice_pn_bridge_1 = require("./voice-pn-bridge");
+const react_native_1 = require("react-native");
 /**
  * Helper functions that use VoicePnBridge for UserDefaults functionality on iOS
  * These functions provide the same interface as the UserDefaultsModule from main branch
  * but route through the VoicePnBridge instead
  */
 async function getVoipToken() {
-  if (react_native_1.Platform.OS !== 'ios') return null;
-  try {
-    return await voice_pn_bridge_1.VoicePnBridge.getVoipToken();
-  } catch (error) {
-    console.warn('[UserDefaults] getVoipToken error:', error);
-    return null;
-  }
+    if (react_native_1.Platform.OS !== 'ios')
+        return null;
+    try {
+        return await voice_pn_bridge_1.VoicePnBridge.getVoipToken();
+    }
+    catch (error) {
+        console.warn('[UserDefaults] getVoipToken error:', error);
+        return null;
+    }
 }
 async function getPendingVoipPush() {
-  if (react_native_1.Platform.OS !== 'ios') return null;
-  try {
-    return await voice_pn_bridge_1.VoicePnBridge.getPendingVoipPush();
-  } catch (error) {
-    console.warn('[UserDefaults] getPendingVoipPush error:', error);
-    return null;
-  }
+    if (react_native_1.Platform.OS !== 'ios')
+        return null;
+    try {
+        return await voice_pn_bridge_1.VoicePnBridge.getPendingVoipPush();
+    }
+    catch (error) {
+        console.warn('[UserDefaults] getPendingVoipPush error:', error);
+        return null;
+    }
 }
 async function clearPendingVoipPush() {
-  if (react_native_1.Platform.OS !== 'ios') return true;
-  try {
-    return await voice_pn_bridge_1.VoicePnBridge.clearPendingVoipPush();
-  } catch (error) {
-    console.warn('[UserDefaults] clearPendingVoipPush error:', error);
-    return false;
-  }
+    if (react_native_1.Platform.OS !== 'ios')
+        return true;
+    try {
+        return await voice_pn_bridge_1.VoicePnBridge.clearPendingVoipPush();
+    }
+    catch (error) {
+        console.warn('[UserDefaults] clearPendingVoipPush error:', error);
+        return false;
+    }
 }
 async function getPendingVoipAction() {
-  if (react_native_1.Platform.OS !== 'ios') return null;
-  try {
-    return await voice_pn_bridge_1.VoicePnBridge.getPendingVoipAction();
-  } catch (error) {
-    console.warn('[UserDefaults] getPendingVoipAction error:', error);
-    return null;
-  }
+    if (react_native_1.Platform.OS !== 'ios')
+        return null;
+    try {
+        return await voice_pn_bridge_1.VoicePnBridge.getPendingVoipAction();
+    }
+    catch (error) {
+        console.warn('[UserDefaults] getPendingVoipAction error:', error);
+        return null;
+    }
 }
 async function clearPendingVoipAction() {
-  if (react_native_1.Platform.OS !== 'ios') return true;
-  try {
-    return await voice_pn_bridge_1.VoicePnBridge.clearPendingVoipAction();
-  } catch (error) {
-    console.warn('[UserDefaults] clearPendingVoipAction error:', error);
-    return false;
-  }
+    if (react_native_1.Platform.OS !== 'ios')
+        return true;
+    try {
+        return await voice_pn_bridge_1.VoicePnBridge.clearPendingVoipAction();
+    }
+    catch (error) {
+        console.warn('[UserDefaults] clearPendingVoipAction error:', error);
+        return false;
+    }
 }

package/lib/internal/voice-pn-bridge.d.ts

@@ -1,14 +1,116 @@
+import { EmitterSubscription } from 'react-native';
+export interface CallActionEvent {
+    action: string;
+    callId?: string;
+    timestamp: number;
+}
 export interface VoicePnBridgeInterface {
-  getPendingPushAction(): Promise<{
-    action: string | null;
-    metadata: string | null;
-  }>;
-  setPendingPushAction(action: string, metadata: string): Promise<boolean>;
-  clearPendingPushAction(): Promise<boolean>;
-  getVoipToken(): Promise<string | null>;
-  getPendingVoipPush(): Promise<string | null>;
-  clearPendingVoipPush(): Promise<boolean>;
-  getPendingVoipAction(): Promise<string | null>;
-  clearPendingVoipAction(): Promise<boolean>;
+    getPendingPushAction(): Promise<{
+        action: string | null;
+        metadata: string | null;
+    }>;
+    setPendingPushAction(action: string, metadata: string): Promise<boolean>;
+    clearPendingPushAction(): Promise<boolean>;
+    getPendingCallAction(): Promise<{
+        action: string | null;
+        callId: string | null;
+        timestamp: number | null;
+    }>;
+    clearPendingCallAction(): Promise<boolean>;
+    endCall(callId: string | null): Promise<boolean>;
+    showOngoingCallNotification(callerName: string | null, callerNumber: string | null, callId: string | null): Promise<boolean>;
+    hideOngoingCallNotification(): Promise<boolean>;
+    hideIncomingCallNotification(): Promise<boolean>;
+    getVoipToken(): Promise<string | null>;
+    getPendingVoipPush(): Promise<string | null>;
+    clearPendingVoipPush(): Promise<boolean>;
+    getPendingVoipAction(): Promise<string | null>;
+    clearPendingVoipAction(): Promise<boolean>;
+}
+declare const NativeBridge: VoicePnBridgeInterface;
+/**
+ * Enhanced VoicePnBridge with call control and event handling capabilities
+ */
+export declare class VoicePnBridge {
+    /**
+     * Get any pending push notification action from native side
+     */
+    static getPendingPushAction(): Promise<{
+        action?: string;
+        metadata?: string;
+    }>;
+    /**
+     * Set a pending push notification action to native side
+     */
+    static setPendingPushAction(action: string, metadata: string): Promise<boolean>;
+    /**
+     * Get any pending call action from native side (reliable polling pattern)
+     */
+    static getPendingCallAction(): Promise<{
+        action?: string;
+        callId?: string;
+        timestamp?: number;
+    }>;
+    /**
+     * Clear any pending call action
+     */
+    static clearPendingCallAction(): Promise<boolean>;
+    /**
+     * Clear any pending push notification action
+     */
+    static clearPendingPushAction(): Promise<boolean>;
+    /**
+     * React Native → Android: End/hang up the current call
+     * This will hide the ongoing call notification and notify the native side
+     */
+    static endCall(callId?: string): Promise<boolean>;
+    /**
+     * React Native → Android: Show ongoing call notification to keep app alive
+     * Should be called when a call becomes active to prevent background termination
+     */
+    static showOngoingCallNotification(callerName?: string, callerNumber?: string, callId?: string): Promise<boolean>;
+    /**
+     * React Native → Android: Hide ongoing call notification
+     * Should be called when a call ends to clean up notifications
+     */
+    static hideOngoingCallNotification(): Promise<boolean>;
+    /**
+     * React Native → Android: Hide incoming call notification
+     * Useful for dismissing notifications when call is answered/rejected in app
+     */
+    static hideIncomingCallNotification(): Promise<boolean>;
+    /**
+     * Get VoIP token from native storage
+     */
+    static getVoipToken(): Promise<string | null>;
+    /**
+     * Get pending VoIP push from native storage
+     */
+    static getPendingVoipPush(): Promise<string | null>;
+    /**
+     * Clear pending VoIP push from native storage
+     */
+    static clearPendingVoipPush(): Promise<boolean>;
+    /**
+     * Get pending VoIP action from native storage
+     */
+    static getPendingVoipAction(): Promise<string | null>;
+    /**
+     * Clear pending VoIP action from native storage
+     */
+    static clearPendingVoipAction(): Promise<boolean>;
+    /**
+     * Android → React Native: Listen for immediate call action events from notification buttons
+     * Use this for active calls where immediate response is needed (e.g., ending ongoing calls)
+     */
+    static addCallActionListener(listener: (event: CallActionEvent) => void): EmitterSubscription;
+    /**
+     * Remove call action listener
+     */
+    static removeCallActionListener(subscription: EmitterSubscription): void;
+    /**
+     * Remove all call action listeners
+     */
+    static removeAllCallActionListeners(): void;
 }
-export declare const VoicePnBridge: VoicePnBridgeInterface;
+export { NativeBridge as VoicePnBridgeNative };

package/lib/internal/voice-pn-bridge.js

@@ -1,5 +1,212 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.VoicePnBridge = void 0;
-const react_native_1 = require('react-native');
-exports.VoicePnBridge = react_native_1.NativeModules.VoicePnBridge;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoicePnBridgeNative = exports.VoicePnBridge = void 0;
+const react_native_1 = require("react-native");
+const NativeBridge = react_native_1.NativeModules.VoicePnBridge;
+exports.VoicePnBridgeNative = NativeBridge;
+/**
+ * Enhanced VoicePnBridge with call control and event handling capabilities
+ */
+class VoicePnBridge {
+    /**
+     * Get any pending push notification action from native side
+     */
+    static async getPendingPushAction() {
+        try {
+            const result = await NativeBridge.getPendingPushAction();
+            return {
+                action: result?.action || undefined,
+                metadata: result?.metadata || undefined,
+            };
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error getting pending push action:', error);
+            return {};
+        }
+    }
+    /**
+     * Set a pending push notification action to native side
+     */
+    static async setPendingPushAction(action, metadata) {
+        try {
+            return await NativeBridge.setPendingPushAction(action, metadata);
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error setting pending push action:', error);
+            return false;
+        }
+    }
+    /**
+     * Get any pending call action from native side (reliable polling pattern)
+     */
+    static async getPendingCallAction() {
+        try {
+            const result = await NativeBridge.getPendingCallAction();
+            return {
+                action: result?.action || undefined,
+                callId: result?.callId || undefined,
+                timestamp: result?.timestamp || undefined,
+            };
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error getting pending call action:', error);
+            return {};
+        }
+    }
+    /**
+     * Clear any pending call action
+     */
+    static async clearPendingCallAction() {
+        try {
+            return await NativeBridge.clearPendingCallAction();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error clearing pending call action:', error);
+            return false;
+        }
+    }
+    /**
+     * Clear any pending push notification action
+     */
+    static async clearPendingPushAction() {
+        try {
+            return await NativeBridge.clearPendingPushAction();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error clearing pending push action:', error);
+            return false;
+        }
+    }
+    /**
+     * React Native → Android: End/hang up the current call
+     * This will hide the ongoing call notification and notify the native side
+     */
+    static async endCall(callId) {
+        try {
+            return await NativeBridge.endCall(callId || null);
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error ending call:', error);
+            return false;
+        }
+    }
+    /**
+     * React Native → Android: Show ongoing call notification to keep app alive
+     * Should be called when a call becomes active to prevent background termination
+     */
+    static async showOngoingCallNotification(callerName, callerNumber, callId) {
+        try {
+            return await NativeBridge.showOngoingCallNotification(callerName || null, callerNumber || null, callId || null);
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error showing ongoing call notification:', error);
+            return false;
+        }
+    }
+    /**
+     * React Native → Android: Hide ongoing call notification
+     * Should be called when a call ends to clean up notifications
+     */
+    static async hideOngoingCallNotification() {
+        try {
+            return await NativeBridge.hideOngoingCallNotification();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error hiding ongoing call notification:', error);
+            return false;
+        }
+    }
+    /**
+     * React Native → Android: Hide incoming call notification
+     * Useful for dismissing notifications when call is answered/rejected in app
+     */
+    static async hideIncomingCallNotification() {
+        try {
+            return await NativeBridge.hideIncomingCallNotification();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error hiding incoming call notification:', error);
+            return false;
+        }
+    }
+    /**
+     * Get VoIP token from native storage
+     */
+    static async getVoipToken() {
+        try {
+            return await NativeBridge.getVoipToken();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error getting VoIP token:', error);
+            return null;
+        }
+    }
+    /**
+     * Get pending VoIP push from native storage
+     */
+    static async getPendingVoipPush() {
+        try {
+            return await NativeBridge.getPendingVoipPush();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error getting pending VoIP push:', error);
+            return null;
+        }
+    }
+    /**
+     * Clear pending VoIP push from native storage
+     */
+    static async clearPendingVoipPush() {
+        try {
+            return await NativeBridge.clearPendingVoipPush();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error clearing pending VoIP push:', error);
+            return false;
+        }
+    }
+    /**
+     * Get pending VoIP action from native storage
+     */
+    static async getPendingVoipAction() {
+        try {
+            return await NativeBridge.getPendingVoipAction();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error getting pending VoIP action:', error);
+            return null;
+        }
+    }
+    /**
+     * Clear pending VoIP action from native storage
+     */
+    static async clearPendingVoipAction() {
+        try {
+            return await NativeBridge.clearPendingVoipAction();
+        }
+        catch (error) {
+            console.error('VoicePnBridge: Error clearing pending VoIP action:', error);
+            return false;
+        }
+    }
+    /**
+     * Android → React Native: Listen for immediate call action events from notification buttons
+     * Use this for active calls where immediate response is needed (e.g., ending ongoing calls)
+     */
+    static addCallActionListener(listener) {
+        return react_native_1.DeviceEventEmitter.addListener('TelnyxCallAction', listener);
+    }
+    /**
+     * Remove call action listener
+     */
+    static removeCallActionListener(subscription) {
+        subscription.remove();
+    }
+    /**
+     * Remove all call action listeners
+     */
+    static removeAllCallActionListeners() {
+        react_native_1.DeviceEventEmitter.removeAllListeners('TelnyxCallAction');
+    }
+}
+exports.VoicePnBridge = VoicePnBridge;

package/lib/models/call-state.d.ts

@@ -5,18 +5,20 @@
  * the complexity of the underlying SIP call states.
  */
 export declare enum TelnyxCallState {
-  /** Call is being initiated (outgoing) or received (incoming) */
-  RINGING = 'RINGING',
-  /** Call is connecting after being answered (usually from push notification) */
-  CONNECTING = 'CONNECTING',
-  /** Call has been answered and media is flowing */
-  ACTIVE = 'ACTIVE',
-  /** Call is on hold */
-  HELD = 'HELD',
-  /** Call has ended normally */
-  ENDED = 'ENDED',
-  /** Call failed to connect or was rejected */
-  FAILED = 'FAILED',
+    /** Call is being initiated (outgoing) or received (incoming) */
+    RINGING = "RINGING",
+    /** Call is connecting after being answered (usually from push notification) */
+    CONNECTING = "CONNECTING",
+    /** Call has been answered and media is flowing */
+    ACTIVE = "ACTIVE",
+    /** Call is on hold */
+    HELD = "HELD",
+    /** Call has ended normally */
+    ENDED = "ENDED",
+    /** Call failed to connect or was rejected */
+    FAILED = "FAILED",
+    /** Call was dropped due to network issues */
+    DROPPED = "DROPPED"
 }
 /**
  * Type guard to check if a value is a valid TelnyxCallState
@@ -26,36 +28,36 @@ export declare function isTelnyxCallState(value: any): value is TelnyxCallState;
  * Helper functions to determine what actions are available in each state
  */
 export declare const CallStateHelpers: {
-  /**
-   * Can the call be answered in this state?
-   */
-  canAnswer(state: TelnyxCallState): boolean;
-  /**
-   * Can the call be hung up in this state?
-   */
-  canHangup(state: TelnyxCallState): boolean;
-  /**
-   * Can the call be put on hold in this state?
-   */
-  canHold(state: TelnyxCallState): boolean;
-  /**
-   * Can the call be resumed from hold in this state?
-   */
-  canResume(state: TelnyxCallState): boolean;
-  /**
-   * Can the call be muted/unmuted in this state?
-   */
-  canToggleMute(state: TelnyxCallState): boolean;
-  /**
-   * Is the call in a terminated state?
-   */
-  isTerminated(state: TelnyxCallState): boolean;
-  /**
-   * Is the call in an active state (can have media)?
-   */
-  isActive(state: TelnyxCallState): boolean;
-  /**
-   * Is the call in a connecting state (answered but not yet active)?
-   */
-  isConnecting(state: TelnyxCallState): boolean;
+    /**
+     * Can the call be answered in this state?
+     */
+    canAnswer(state: TelnyxCallState): boolean;
+    /**
+     * Can the call be hung up in this state?
+     */
+    canHangup(state: TelnyxCallState): boolean;
+    /**
+     * Can the call be put on hold in this state?
+     */
+    canHold(state: TelnyxCallState): boolean;
+    /**
+     * Can the call be resumed from hold in this state?
+     */
+    canResume(state: TelnyxCallState): boolean;
+    /**
+     * Can the call be muted/unmuted in this state?
+     */
+    canToggleMute(state: TelnyxCallState): boolean;
+    /**
+     * Is the call in a terminated state?
+     */
+    isTerminated(state: TelnyxCallState): boolean;
+    /**
+     * Is the call in an active state (can have media)?
+     */
+    isActive(state: TelnyxCallState): boolean;
+    /**
+     * Is the call in a connecting state (answered but not yet active)?
+     */
+    isConnecting(state: TelnyxCallState): boolean;
 };