@zyratalk1/zyra-twilio-wrapper 1.2.9 → 1.3.1

package/dist/index.d.mts

@@ -1,8 +1,23 @@
+type MemberStatus = "Idle" | "Active" | "Ringing" | "ringing";
+interface MemberStatusUpdate {
+    memberId: number;
+    status: MemberStatus;
+    timestamp: string;
+}
 interface Config {
     serverUrl: string;
     identity: string;
     waitUrl?: string;
     sdkToken: string;
+    /** WebSocket URL for member status (default: wss://nextdev.zyratalk.com/websocket) */
+    websocketUrl?: string;
+    /** Connect member-status WebSocket after init (default: true) */
+    autoConnectMemberStatus?: boolean;
+    /**
+     * Routing member id for this agent. When set, Idle status updates for this member
+     * dismiss a ringing incoming call if the caller hung up before answer.
+     */
+    memberId?: number;
     accessToken?: string;
     enableAndroidVoiceRegister?: boolean;
     requestTimeoutMs?: number;
@@ -79,6 +94,11 @@ interface WelcomeConfigResult {
     welcomeType: WelcomeType;
     routingConfigId: number;
 }
+interface HoldMusicUrlConfigResult {
+    success: boolean;
+    message: string;
+    routingConfigId: number;
+}
 /**
  * Routing Config
  */
@@ -316,16 +336,28 @@ declare class BridgeClient {
 
 declare class ReactNativeVoipSdk {
     private readonly sdkConfig;
+    private readonly websocketUrl;
+    private readonly autoConnectMemberStatus;
+    private readonly memberId?;
     protected readonly bridge: BridgeClient;
     private readonly retry;
     private readonly authManager;
     private readonly callEngine;
     private readonly conferenceManager;
     private readonly configService;
+    private memberStatusWebSocket;
     private initialized;
     protected activeCallId: string | null;
     protected internalConferenceName: string;
+    private pendingIncomingCallId;
+    private incomingCallAccepted;
+    onMemberStatusUpdate?: (update: MemberStatusUpdate) => void;
+    onMemberStatusWebSocketConnected?: () => void;
+    onMemberStatusWebSocketDisconnected?: () => void;
     constructor(config: Config, nativeModule?: NativeModule);
+    private setupIncomingCallTracking;
+    private handleMemberStatusUpdate;
+    private dismissIncomingCallFromMemberIdle;
     on(eventName: SDKEventName | string, listener: (payload: Record<string, unknown>) => void): () => void;
     initializeSDK(config?: Partial<SDKConfig>): Promise<void>;
     authenticate(payload?: AuthPayload): Promise<ConsumerAuth>;
@@ -366,10 +398,64 @@ declare class ReactNativeVoipSdk {
     deregisterWebhook(): Promise<CallResponse<null>>;
     isWebhookConfigured(): Promise<CallResponse<WebhookConfigResult>>;
     welcomeMessageConfig(welcomeType: "audio" | "tts", welcomeMessage: string): Promise<CallResponse<WelcomeConfigResult>>;
+    /**
+     * Set hold music audio URL (MP3 or WAV HTTPS URL, e.g. from upload-audio).
+     */
+    holdMusicUrlConfig(audioUrl: string): Promise<CallResponse<HoldMusicUrlConfigResult>>;
+    /**
+     * Connect to member status WebSocket (default: wss://nextdev.zyratalk.com/websocket).
+     */
+    connectMemberStatusWebSocket(url?: string): void;
+    disconnectMemberStatusWebSocket(): void;
+    get isMemberStatusWebSocketConnected(): boolean;
+    getMemberStatus(memberId: number): MemberStatus | undefined;
+    getMemberStatusMap(): ReadonlyMap<number, MemberStatus>;
     destroy(): void;
     private ensureAuthenticated;
 }
 
+interface MemberStatusWebSocketOptions {
+    url: string;
+    maxReconnectAttempts?: number;
+    reconnectDelayMs?: number;
+    onStatusUpdate?: (update: MemberStatusUpdate) => void;
+    onConnected?: () => void;
+    onDisconnected?: () => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * WebSocket client for real-time routing member status updates.
+ * Protocol matches zyratalk-next websocket-service (same as browser VOIP wrapper).
+ */
+declare class MemberStatusWebSocketClient {
+    private readonly url;
+    private readonly maxReconnectAttempts;
+    private readonly reconnectDelayMs;
+    private readonly onStatusUpdate?;
+    private readonly onConnected?;
+    private readonly onDisconnected?;
+    private readonly onError?;
+    private ws;
+    private reconnectTimeout;
+    private reconnectAttempts;
+    private isConnecting;
+    private intentionalClose;
+    private readonly statusMap;
+    constructor(options: MemberStatusWebSocketOptions);
+    get isConnected(): boolean;
+    getStatus(memberId: number): MemberStatus | undefined;
+    getStatusMap(): ReadonlyMap<number, MemberStatus>;
+    connect(): void;
+    disconnect(): void;
+    destroy(): void;
+    private clearReconnectTimeout;
+}
+
+/** Default API base URL when `serverUrl` is omitted (nextdev). */
+declare const DEFAULT_SERVER_URL = "https://nextdev.zyratalk.com/api/trpc";
+/** Default member-status WebSocket URL when `websocketUrl` is omitted (nextdev). */
+declare const DEFAULT_WEBSOCKET_URL = "wss://nextdev.zyratalk.com/websocket/";
+
 /**
  * Backward-compatible wrapper class retaining the original export name.
  * Existing consumers can continue to construct `new ZyraTwilioWrapper(config)`.
@@ -390,4 +476,4 @@ declare class ZyraTwilioWrapper extends ReactNativeVoipSdk {
     destroy(): void;
 }
 
-export { type AuthPayload, type CallSession, type ConsumerAuth, type NativeModule, type Participant, ReactNativeVoipSdk, type SDKConfig, type SDKEventName, ZyraTwilioWrapper as default };
+export { type AuthPayload, type CallSession, type ConsumerAuth, DEFAULT_SERVER_URL, DEFAULT_WEBSOCKET_URL, type MemberStatus, type MemberStatusUpdate, MemberStatusWebSocketClient, type NativeModule, type Participant, ReactNativeVoipSdk, type SDKConfig, type SDKEventName, ZyraTwilioWrapper as default };

package/dist/index.d.ts

@@ -1,8 +1,23 @@
+type MemberStatus = "Idle" | "Active" | "Ringing" | "ringing";
+interface MemberStatusUpdate {
+    memberId: number;
+    status: MemberStatus;
+    timestamp: string;
+}
 interface Config {
     serverUrl: string;
     identity: string;
     waitUrl?: string;
     sdkToken: string;
+    /** WebSocket URL for member status (default: wss://nextdev.zyratalk.com/websocket) */
+    websocketUrl?: string;
+    /** Connect member-status WebSocket after init (default: true) */
+    autoConnectMemberStatus?: boolean;
+    /**
+     * Routing member id for this agent. When set, Idle status updates for this member
+     * dismiss a ringing incoming call if the caller hung up before answer.
+     */
+    memberId?: number;
     accessToken?: string;
     enableAndroidVoiceRegister?: boolean;
     requestTimeoutMs?: number;
@@ -79,6 +94,11 @@ interface WelcomeConfigResult {
     welcomeType: WelcomeType;
     routingConfigId: number;
 }
+interface HoldMusicUrlConfigResult {
+    success: boolean;
+    message: string;
+    routingConfigId: number;
+}
 /**
  * Routing Config
  */
@@ -316,16 +336,28 @@ declare class BridgeClient {
 
 declare class ReactNativeVoipSdk {
     private readonly sdkConfig;
+    private readonly websocketUrl;
+    private readonly autoConnectMemberStatus;
+    private readonly memberId?;
     protected readonly bridge: BridgeClient;
     private readonly retry;
     private readonly authManager;
     private readonly callEngine;
     private readonly conferenceManager;
     private readonly configService;
+    private memberStatusWebSocket;
     private initialized;
     protected activeCallId: string | null;
     protected internalConferenceName: string;
+    private pendingIncomingCallId;
+    private incomingCallAccepted;
+    onMemberStatusUpdate?: (update: MemberStatusUpdate) => void;
+    onMemberStatusWebSocketConnected?: () => void;
+    onMemberStatusWebSocketDisconnected?: () => void;
     constructor(config: Config, nativeModule?: NativeModule);
+    private setupIncomingCallTracking;
+    private handleMemberStatusUpdate;
+    private dismissIncomingCallFromMemberIdle;
     on(eventName: SDKEventName | string, listener: (payload: Record<string, unknown>) => void): () => void;
     initializeSDK(config?: Partial<SDKConfig>): Promise<void>;
     authenticate(payload?: AuthPayload): Promise<ConsumerAuth>;
@@ -366,10 +398,64 @@ declare class ReactNativeVoipSdk {
     deregisterWebhook(): Promise<CallResponse<null>>;
     isWebhookConfigured(): Promise<CallResponse<WebhookConfigResult>>;
     welcomeMessageConfig(welcomeType: "audio" | "tts", welcomeMessage: string): Promise<CallResponse<WelcomeConfigResult>>;
+    /**
+     * Set hold music audio URL (MP3 or WAV HTTPS URL, e.g. from upload-audio).
+     */
+    holdMusicUrlConfig(audioUrl: string): Promise<CallResponse<HoldMusicUrlConfigResult>>;
+    /**
+     * Connect to member status WebSocket (default: wss://nextdev.zyratalk.com/websocket).
+     */
+    connectMemberStatusWebSocket(url?: string): void;
+    disconnectMemberStatusWebSocket(): void;
+    get isMemberStatusWebSocketConnected(): boolean;
+    getMemberStatus(memberId: number): MemberStatus | undefined;
+    getMemberStatusMap(): ReadonlyMap<number, MemberStatus>;
     destroy(): void;
     private ensureAuthenticated;
 }
 
+interface MemberStatusWebSocketOptions {
+    url: string;
+    maxReconnectAttempts?: number;
+    reconnectDelayMs?: number;
+    onStatusUpdate?: (update: MemberStatusUpdate) => void;
+    onConnected?: () => void;
+    onDisconnected?: () => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * WebSocket client for real-time routing member status updates.
+ * Protocol matches zyratalk-next websocket-service (same as browser VOIP wrapper).
+ */
+declare class MemberStatusWebSocketClient {
+    private readonly url;
+    private readonly maxReconnectAttempts;
+    private readonly reconnectDelayMs;
+    private readonly onStatusUpdate?;
+    private readonly onConnected?;
+    private readonly onDisconnected?;
+    private readonly onError?;
+    private ws;
+    private reconnectTimeout;
+    private reconnectAttempts;
+    private isConnecting;
+    private intentionalClose;
+    private readonly statusMap;
+    constructor(options: MemberStatusWebSocketOptions);
+    get isConnected(): boolean;
+    getStatus(memberId: number): MemberStatus | undefined;
+    getStatusMap(): ReadonlyMap<number, MemberStatus>;
+    connect(): void;
+    disconnect(): void;
+    destroy(): void;
+    private clearReconnectTimeout;
+}
+
+/** Default API base URL when `serverUrl` is omitted (nextdev). */
+declare const DEFAULT_SERVER_URL = "https://nextdev.zyratalk.com/api/trpc";
+/** Default member-status WebSocket URL when `websocketUrl` is omitted (nextdev). */
+declare const DEFAULT_WEBSOCKET_URL = "wss://nextdev.zyratalk.com/websocket/";
+
 /**
  * Backward-compatible wrapper class retaining the original export name.
  * Existing consumers can continue to construct `new ZyraTwilioWrapper(config)`.
@@ -390,4 +476,4 @@ declare class ZyraTwilioWrapper extends ReactNativeVoipSdk {
     destroy(): void;
 }
 
-export { type AuthPayload, type CallSession, type ConsumerAuth, type NativeModule, type Participant, ReactNativeVoipSdk, type SDKConfig, type SDKEventName, ZyraTwilioWrapper as default };
+export { type AuthPayload, type CallSession, type ConsumerAuth, DEFAULT_SERVER_URL, DEFAULT_WEBSOCKET_URL, type MemberStatus, type MemberStatusUpdate, MemberStatusWebSocketClient, type NativeModule, type Participant, ReactNativeVoipSdk, type SDKConfig, type SDKEventName, ZyraTwilioWrapper as default };