@telnyx/webrtc 2.27.4-beta.2 → 2.27.4

package/lib/src/Modules/Verto/BrowserSession.d.ts

@@ -19,7 +19,9 @@ export default abstract class BrowserSession extends BaseSession {
     ringbackFile?: string;
     private _iceServers;
     private _localElement;
+    private _localElementId;
     private _remoteElement;
+    private _remoteElementId;
     protected _jwtAuth: boolean;
     protected _audioConstraints: boolean | MediaTrackConstraints;
     private _previousAudioConstraints;
@@ -54,8 +56,10 @@ export default abstract class BrowserSession extends BaseSession {
     get speaker(): string;
     set localElement(tag: HTMLMediaElement | string | Function);
     get localElement(): HTMLMediaElement | string | Function;
+    get localElementId(): string;
     set remoteElement(tag: HTMLMediaElement | string | Function);
     get remoteElement(): HTMLMediaElement | string | Function;
+    get remoteElementId(): string;
     vertoBroadcast({ nodeId, channel: eventChannel, data, }: BroadcastParams): void;
     vertoSubscribe({ nodeId, channels: eventChannel, handler, }: SubscribeParams): Promise<any>;
     vertoUnsubscribe({ nodeId, channels: eventChannel, }: SubscribeParams): Promise<any>;

package/lib/src/Modules/Verto/util/constants/errorCodes.d.ts

@@ -45,6 +45,7 @@ export declare const TELNYX_WARNING_CODES: {
     readonly AUDIO_INPUT_DEVICE_CHANGE_SKIPPED: 33009;
     readonly MULTIPLE_ACTIVE_CALLS_DETECTED: 33010;
     readonly DUPLICATE_INBOUND_ANSWER: 33007;
+    readonly SHARED_REMOTE_ELEMENT_OVERWRITE: 33011;
     readonly TOKEN_EXPIRING_SOON: 34001;
     readonly UNKNOWN_REATTACHED_SESSION: 35002;
     readonly SIGNALING_RECOVERY_REQUIRED: 36003;
@@ -52,5 +53,5 @@ export declare const TELNYX_WARNING_CODES: {
     readonly RECONNECTION_FAILED_WITH_NO_AUTO_RECONNECT: 36005;
 };
 export declare const SDP_CREATE_OFFER_FAILED: 40001, SDP_CREATE_ANSWER_FAILED: 40002, SDP_SET_LOCAL_DESCRIPTION_FAILED: 40003, SDP_SET_REMOTE_DESCRIPTION_FAILED: 40004, SDP_SEND_FAILED: 40005, MEDIA_MICROPHONE_PERMISSION_DENIED: 42001, MEDIA_DEVICE_NOT_FOUND: 42002, MEDIA_GET_USER_MEDIA_FAILED: 42003, HOLD_FAILED: 44001, INVALID_CALL_PARAMETERS: 44002, BYE_SEND_FAILED: 44003, SUBSCRIBE_FAILED: 44004, PEER_CLOSED_DURING_INIT: 44005, WEBSOCKET_CONNECTION_FAILED: 45001, WEBSOCKET_ERROR: 45002, RECONNECTION_EXHAUSTED: 45003, GATEWAY_FAILED: 45004, LOGIN_FAILED: 46001, INVALID_CREDENTIALS: 46002, AUTHENTICATION_REQUIRED: 46003, ICE_RESTART_FAILED: 47001, NETWORK_OFFLINE: 48001, SESSION_NOT_REATTACHED: 48501, UNEXPECTED_ERROR: 49001;
-export declare const HIGH_RTT: 31001, HIGH_JITTER: 31002, HIGH_PACKET_LOSS: 31003, LOW_MOS: 31004, LOW_LOCAL_AUDIO: 31005, LOW_INBOUND_AUDIO: 31006, LOW_BYTES_RECEIVED: 32001, LOW_BYTES_SENT: 32002, RECORDING_UNAVAILABLE: 32003, RECORDING_BUFFER_OVERFLOW: 32004, ICE_CONNECTIVITY_LOST: 33001, ICE_GATHERING_TIMEOUT: 33002, ICE_GATHERING_EMPTY: 33003, PEER_CONNECTION_FAILED: 33004, ONLY_HOST_ICE_CANDIDATES: 33005, ANSWER_WHILE_PEER_ACTIVE: 33006, ICE_CANDIDATE_PAIR_CHANGED: 33008, AUDIO_INPUT_DEVICE_CHANGE_SKIPPED: 33009, MULTIPLE_ACTIVE_CALLS_DETECTED: 33010, DUPLICATE_INBOUND_ANSWER: 33007, TOKEN_EXPIRING_SOON: 34001, UNKNOWN_REATTACHED_SESSION: 35002, SIGNALING_RECOVERY_REQUIRED: 36003, MEDIA_RECOVERY_REQUIRED: 36004, RECONNECTION_FAILED_WITH_NO_AUTO_RECONNECT: 36005;
+export declare const HIGH_RTT: 31001, HIGH_JITTER: 31002, HIGH_PACKET_LOSS: 31003, LOW_MOS: 31004, LOW_LOCAL_AUDIO: 31005, LOW_INBOUND_AUDIO: 31006, LOW_BYTES_RECEIVED: 32001, LOW_BYTES_SENT: 32002, RECORDING_UNAVAILABLE: 32003, RECORDING_BUFFER_OVERFLOW: 32004, ICE_CONNECTIVITY_LOST: 33001, ICE_GATHERING_TIMEOUT: 33002, ICE_GATHERING_EMPTY: 33003, PEER_CONNECTION_FAILED: 33004, ONLY_HOST_ICE_CANDIDATES: 33005, ANSWER_WHILE_PEER_ACTIVE: 33006, ICE_CANDIDATE_PAIR_CHANGED: 33008, AUDIO_INPUT_DEVICE_CHANGE_SKIPPED: 33009, MULTIPLE_ACTIVE_CALLS_DETECTED: 33010, DUPLICATE_INBOUND_ANSWER: 33007, SHARED_REMOTE_ELEMENT_OVERWRITE: 33011, TOKEN_EXPIRING_SOON: 34001, UNKNOWN_REATTACHED_SESSION: 35002, SIGNALING_RECOVERY_REQUIRED: 36003, MEDIA_RECOVERY_REQUIRED: 36004, RECONNECTION_FAILED_WITH_NO_AUTO_RECONNECT: 36005;
 export declare const HAS_NON_HOST_ICE_CANDIDATE_REGEX: RegExp;

package/lib/src/Modules/Verto/util/constants/index.d.ts

@@ -27,6 +27,16 @@ export declare const STUN_SERVER: {
 export declare const STUN_DEV_SERVER: {
     urls: string;
 };
+export declare const TURN_UDP_3478_SERVER: {
+    urls: string;
+    username: string;
+    credential: string;
+};
+export declare const TURN_TCP_3478_SERVER: {
+    urls: string;
+    username: string;
+    credential: string;
+};
 export declare const TURN_SERVER: {
     urls: string;
     username: string;
@@ -37,8 +47,41 @@ export declare const TURN_DEV_SERVER: {
     username: string;
     credential: string;
 }[];
+export declare const TURN_TLS_443_SERVER: {
+    urls: string;
+    username: string;
+    credential: string;
+};
+export declare const TURN_TLS_443_DEV_SERVER: {
+    urls: string;
+    username: string;
+    credential: string;
+};
 export declare const DEFAULT_PROD_ICE_SERVERS: RTCIceServer[];
 export declare const DEFAULT_DEV_ICE_SERVERS: RTCIceServer[];
+export declare const TELNYX_ICE_SERVERS: {
+    readonly GOOGLE_STUN: {
+        urls: string;
+    };
+    readonly TELNYX_STUN: {
+        urls: string;
+    };
+    readonly TELNYX_TURN_UDP_3478: {
+        urls: string;
+        username: string;
+        credential: string;
+    };
+    readonly TELNYX_TURN_TCP_3478: {
+        urls: string;
+        username: string;
+        credential: string;
+    };
+    readonly TELNYX_TURNS_TCP_443: {
+        urls: string;
+        username: string;
+        credential: string;
+    };
+};
 export declare enum SwEvent {
     SocketOpen = "telnyx.socket.open",
     SocketClose = "telnyx.socket.close",

package/lib/src/Modules/Verto/util/constants/warnings.d.ts

@@ -180,6 +180,13 @@ export declare const SDK_WARNINGS: {
         readonly causes: readonly ["Application created an outbound call while another call is active", "An inbound call arrived while another call is already active", "Application did not hang up the previous call before starting a new one", "Call waiting or multi-call scenario (may be intentional)"];
         readonly solutions: readonly ["Verify this is the expected behavior for your application", "Ensure the previous call is hung up before creating a new one if only one call is expected", "Use call.hold() before starting a new call if needed", "Check the warning payload for call IDs to correlate which calls are involved"];
     };
+    readonly 33011: {
+        readonly name: "SHARED_REMOTE_ELEMENT_OVERWRITE";
+        readonly message: "Remote media element overwritten by another call";
+        readonly description: "A new MediaStream was attached to an HTML media element (audio/video) that already held a different MediaStream from another active call. The SDK overwrote the existing stream (last-writer-wins), which disrupts the other call remote media playout. This happens when two concurrent calls share a single remoteElement instead of each having its own. Use a per-call remoteElement (client.newCall({ remoteElement }) or call.answer({ remoteElement })) so each call owns a distinct element.";
+        readonly causes: readonly ["Two concurrent calls share one remoteElement (legacy single-element app)", "Application did not pass a per-call remoteElement to newCall() or answer()", "A second inbound call rang into a session using one session-level remoteElement"];
+        readonly solutions: readonly ["Pass a distinct remoteElement per call via client.newCall({ remoteElement })", "For inbound calls, override at answer time via call.answer({ remoteElement })", "Give each call its own <audio>/<video> element so attach/detach lifecycles are independent"];
+    };
     readonly 35002: {
         readonly name: "UNKNOWN_REATTACHED_SESSION";
         readonly message: "Unknown reattach session after reconnect";

package/lib/src/Modules/Verto/util/reconnect.d.ts

@@ -2,6 +2,8 @@ import { IWebRTCCall } from '../webrtc/interfaces';
 export interface IStoredActiveCall {
     id: IWebRTCCall['id'];
     customHeaders: IWebRTCCall['options']['customHeaders'];
+    remoteElement?: string;
+    localElement?: string;
 }
 export interface IStoredActiveCalls {
     sessionId: string;

package/lib/src/Modules/Verto/util/webrtc/index.d.ts

@@ -8,7 +8,12 @@ declare const getSupportedConstraints: () => MediaTrackSupportedConstraints;
 declare const streamIsValid: (stream: MediaStream) => boolean;
 declare const audioIsMediaTrackConstraints: (audio: boolean | MediaTrackConstraints) => boolean;
 declare const videoIsMediaTrackConstraints: (video: boolean | MediaTrackConstraints) => boolean;
-declare const attachMediaStream: (tag: any, stream: MediaStream) => void;
+export interface IAttachMediaStreamContext {
+    callId?: string;
+    sessionId?: string;
+    eventTarget?: string;
+}
+declare const attachMediaStream: (tag: any, stream: MediaStream, context?: IAttachMediaStreamContext) => void;
 declare const detachMediaStream: (tag: any, stream?: MediaStream) => void;
 declare const muteMediaElement: (tag: any) => void;
 declare const unmuteMediaElement: (tag: any) => void;

package/lib/src/Modules/Verto/util/webrtc/index.native.d.ts

@@ -4,7 +4,11 @@ declare const _getUserMedia: (constraints: MediaStreamConstraints) => any;
 declare const _enumerateDevices: () => any;
 declare const streamIsValid: (stream: MediaStream) => boolean;
 declare const getSupportedConstraints: () => {};
-declare const attachMediaStream: (htmlElementId: string, stream: MediaStream) => any;
+declare const attachMediaStream: (htmlElementId: string, stream: MediaStream, _context?: {
+    callId?: string;
+    sessionId?: string;
+    eventTarget?: string;
+}) => any;
 declare const detachMediaStream: (htmlElementId: string, _stream?: MediaStream) => any;
 declare const muteMediaElement: (htmlElementId: string) => any;
 declare const unmuteMediaElement: (htmlElementId: string) => any;

package/lib/src/Modules/Verto/webrtc/interfaces.d.ts

@@ -83,6 +83,8 @@ export interface AnswerParams {
         value: string;
     }>;
     video?: boolean;
+    remoteElement?: HTMLMediaElement | string | Function;
+    localElement?: HTMLMediaElement | string | Function;
 }
 export interface IWebRTCCall {
     id: string;

package/lib/src/index.d.ts

@@ -1,9 +1,9 @@
 import TelnyxRTC from './TelnyxRTC';
 import { IClientOptions, ICallOptions, ICredentials, INotification } from './utils/interfaces';
-import { SwEvent } from './Modules/Verto/util/constants';
+import { SwEvent, TELNYX_ICE_SERVERS } from './Modules/Verto/util/constants';
 import { NOTIFICATION_TYPE, ERROR_TYPE } from './Modules/Verto/webrtc/constants';
 import Call from './Modules/Verto/webrtc/Call';
-export { Call, TelnyxRTC, IClientOptions, ICallOptions, ICredentials, INotification, SwEvent, NOTIFICATION_TYPE, ERROR_TYPE, };
+export { Call, TelnyxRTC, IClientOptions, ICallOptions, ICredentials, INotification, SwEvent, TELNYX_ICE_SERVERS, NOTIFICATION_TYPE, ERROR_TYPE, };
 export { SDK_ERRORS, SDK_WARNINGS, TelnyxError, isMediaRecoveryErrorEvent, } from './Modules/Verto/util/errors';
 export { TELNYX_ERROR_CODES, TELNYX_WARNING_CODES, } from './Modules/Verto/util/constants/errorCodes';
 export type { ITelnyxError, ITelnyxMediaError, ITelnyxErrorEvent, ITelnyxMediaRecoveryErrorEvent, ITelnyxStandardErrorEvent, TelnyxMediaErrorCode, } from './Modules/Verto/util/errors';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/webrtc",
-  "version": "2.27.4-beta.2",
+  "version": "2.27.4",
   "description": "Telnyx WebRTC Client",
   "keywords": [
     "telnyx",