@zyratalk1/zyra-twilio-wrapper 1.3.0 → 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;
@@ -321,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>;
@@ -375,10 +402,60 @@ declare class ReactNativeVoipSdk {
      * 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)`.
@@ -399,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;
@@ -321,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>;
@@ -375,10 +402,60 @@ declare class ReactNativeVoipSdk {
      * 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)`.
@@ -399,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.js

@@ -30,6 +30,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_SERVER_URL: () => DEFAULT_SERVER_URL,
+  DEFAULT_WEBSOCKET_URL: () => DEFAULT_WEBSOCKET_URL,
+  MemberStatusWebSocketClient: () => MemberStatusWebSocketClient,
   ReactNativeVoipSdk: () => ReactNativeVoipSdk,
   default: () => ZyraTwilioWrapper
 });
@@ -46,6 +49,137 @@ function createErrorResult(error) {
   };
 }
 
+// src/defaults.ts
+var DEFAULT_SERVER_URL = "https://nextdev.zyratalk.com/api/trpc";
+var DEFAULT_WEBSOCKET_URL = "wss://nextdev.zyratalk.com/websocket/";
+function resolveWebSocketUrl(value) {
+  const trimmed = value?.trim();
+  return trimmed || DEFAULT_WEBSOCKET_URL;
+}
+
+// src/memberStatusWebSocket.ts
+var DEFAULT_MAX_RECONNECT_ATTEMPTS = 5;
+var DEFAULT_RECONNECT_DELAY_MS = 3e3;
+var MemberStatusWebSocketClient = class {
+  constructor(options) {
+    this.ws = null;
+    this.reconnectTimeout = null;
+    this.reconnectAttempts = 0;
+    this.isConnecting = false;
+    this.intentionalClose = false;
+    this.statusMap = /* @__PURE__ */ new Map();
+    this.url = options.url;
+    this.maxReconnectAttempts = options.maxReconnectAttempts ?? DEFAULT_MAX_RECONNECT_ATTEMPTS;
+    this.reconnectDelayMs = options.reconnectDelayMs ?? DEFAULT_RECONNECT_DELAY_MS;
+    this.onStatusUpdate = options.onStatusUpdate;
+    this.onConnected = options.onConnected;
+    this.onDisconnected = options.onDisconnected;
+    this.onError = options.onError;
+  }
+  get isConnected() {
+    return this.ws?.readyState === WebSocket.OPEN;
+  }
+  getStatus(memberId) {
+    return this.statusMap.get(memberId);
+  }
+  getStatusMap() {
+    return this.statusMap;
+  }
+  connect() {
+    if (typeof WebSocket === "undefined") {
+      this.onError?.(
+        new Error("WebSocket is not available in this environment.")
+      );
+      return;
+    }
+    if (this.isConnecting || this.isConnected) {
+      return;
+    }
+    this.intentionalClose = false;
+    this.isConnecting = true;
+    try {
+      const ws = new WebSocket(this.url);
+      ws.onopen = () => {
+        this.isConnecting = false;
+        this.reconnectAttempts = 0;
+        this.clearReconnectTimeout();
+        console.log("[VOIP WEBSOCKET] connected", { url: this.url });
+        this.onConnected?.();
+      };
+      ws.onmessage = (event) => {
+        try {
+          const raw = typeof event.data === "string" ? event.data : String(event.data);
+          console.log("[VOIP WEBSOCKET] message", raw);
+          const message = JSON.parse(raw);
+          console.log("[VOIP WEBSOCKET] parsed", message);
+          if (message.type === "connected") {
+            console.log("[VOIP WEBSOCKET] handshake", message.message);
+          }
+          if (message.type === "status_update" && message.data) {
+            const { memberId, status, timestamp } = message.data;
+            console.log("[VOIP WEBSOCKET] status_update", {
+              memberId,
+              status,
+              timestamp
+            });
+            this.statusMap.set(memberId, status);
+            this.onStatusUpdate?.(message.data);
+          }
+        } catch (error) {
+          const parseError = error instanceof Error ? error : new Error("Failed to parse WebSocket message");
+          this.onError?.(parseError);
+        }
+      };
+      ws.onerror = () => {
+        this.isConnecting = false;
+        console.warn("[VOIP WEBSOCKET] error", { url: this.url });
+        this.onError?.(new Error("WebSocket connection error"));
+      };
+      ws.onclose = (event) => {
+        this.isConnecting = false;
+        this.ws = null;
+        console.log("[VOIP WEBSOCKET] closed", {
+          code: event.code,
+          reason: event.reason,
+          wasClean: event.wasClean
+        });
+        this.onDisconnected?.();
+        if (!this.intentionalClose && !event.wasClean && this.reconnectAttempts < this.maxReconnectAttempts) {
+          this.reconnectAttempts += 1;
+          const delay = this.reconnectDelayMs * Math.pow(2, this.reconnectAttempts - 1);
+          this.reconnectTimeout = setTimeout(() => {
+            this.connect();
+          }, delay);
+        }
+      };
+      this.ws = ws;
+    } catch (error) {
+      this.isConnecting = false;
+      const connectError = error instanceof Error ? error : new Error("Failed to create WebSocket connection");
+      this.onError?.(connectError);
+    }
+  }
+  disconnect() {
+    this.intentionalClose = true;
+    this.clearReconnectTimeout();
+    this.reconnectAttempts = 0;
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+  }
+  destroy() {
+    this.disconnect();
+    this.statusMap.clear();
+  }
+  clearReconnectTimeout() {
+    if (this.reconnectTimeout) {
+      clearTimeout(this.reconnectTimeout);
+      this.reconnectTimeout = null;
+    }
+  }
+};
+
 // src/react-native-voip-sdk/bridge/event-emitter.ts
 var BridgeEventEmitter = class {
   constructor() {
@@ -1779,10 +1913,16 @@ function logVoipDebug(message, payload) {
   }
   console.log(`[VOIP SDK] ${message}`);
 }
+function isIdleMemberStatus(status) {
+  return String(status).toLowerCase() === "idle";
+}
 var ReactNativeVoipSdk = class {
   constructor(config, nativeModule) {
+    this.memberStatusWebSocket = null;
     this.initialized = false;
     this.activeCallId = null;
+    this.pendingIncomingCallId = null;
+    this.incomingCallAccepted = false;
     logVoipDebug("constructor() invoked", {
       hasServerUrl: Boolean(config.serverUrl),
       hasIdentity: Boolean(config.identity),
@@ -1790,6 +1930,9 @@ var ReactNativeVoipSdk = class {
       hasAccessToken: Boolean(config.accessToken)
     });
     this.internalConferenceName = `conf_${config.identity}_${Date.now()}`;
+    this.websocketUrl = resolveWebSocketUrl(config.websocketUrl);
+    this.autoConnectMemberStatus = config.autoConnectMemberStatus ?? true;
+    this.memberId = config.memberId;
     this.sdkConfig = {
       serverUrl: config.serverUrl,
       consumerId: config.identity,
@@ -1827,6 +1970,79 @@ var ReactNativeVoipSdk = class {
       sdkToken: this.sdkConfig.sdkToken,
       ensureAuthenticated: this.ensureAuthenticated.bind(this)
     });
+    this.setupIncomingCallTracking();
+  }
+  setupIncomingCallTracking() {
+    this.bridge.on("onCallRinging", (payload) => {
+      const direction = payload.direction;
+      if (direction === "OUTBOUND") {
+        return;
+      }
+      const callId = payload.callId;
+      if (typeof callId === "string" && callId.length > 0) {
+        this.pendingIncomingCallId = callId;
+        this.incomingCallAccepted = false;
+        logVoipDebug("incoming call ringing (pending)", { callId });
+      }
+    });
+    this.bridge.on("onCallConnected", () => {
+      this.incomingCallAccepted = true;
+      this.pendingIncomingCallId = null;
+    });
+    this.bridge.on("onMissedCall", () => {
+      this.pendingIncomingCallId = null;
+      this.incomingCallAccepted = false;
+    });
+    this.bridge.on("onCallEnded", (payload) => {
+      const callId = payload.callId;
+      if (typeof callId === "string" && callId === this.pendingIncomingCallId) {
+        this.pendingIncomingCallId = null;
+        this.incomingCallAccepted = false;
+      }
+    });
+  }
+  handleMemberStatusUpdate(update) {
+    logVoipDebug("WebSocket member status", {
+      memberId: update.memberId,
+      status: update.status,
+      timestamp: update.timestamp,
+      pendingIncomingCallId: this.pendingIncomingCallId,
+      incomingCallAccepted: this.incomingCallAccepted
+    });
+    this.onMemberStatusUpdate?.(update);
+    if (!this.pendingIncomingCallId || this.incomingCallAccepted) {
+      return;
+    }
+    if (this.memberId != null && update.memberId !== this.memberId) {
+      return;
+    }
+    if (isIdleMemberStatus(update.status)) {
+      logVoipDebug("member Idle while incoming ringing \u2014 caller likely hung up", {
+        memberId: update.memberId,
+        callId: this.pendingIncomingCallId
+      });
+      void this.dismissIncomingCallFromMemberIdle();
+    }
+  }
+  async dismissIncomingCallFromMemberIdle() {
+    const callId = this.pendingIncomingCallId;
+    if (!callId || this.incomingCallAccepted) {
+      return;
+    }
+    this.pendingIncomingCallId = null;
+    try {
+      if (this.bridge.nativeModule.rejectCall) {
+        await this.bridge.nativeModule.rejectCall({ callId });
+      } else {
+        await this.endCall(callId);
+      }
+    } catch (error) {
+      logVoipDebug("dismissIncomingCallFromMemberIdle failed", {
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+    this.bridge.emit("onMissedCall", { callId, reason: "member_idle" });
+    this.bridge.emit("onCallEnded", { callId, reason: "member_idle" });
   }
   on(eventName, listener) {
     return this.bridge.on(eventName, listener);
@@ -1859,6 +2075,9 @@ var ReactNativeVoipSdk = class {
       }
       this.initialized = true;
       logVoipDebug("initializeSDK() success");
+      if (this.websocketUrl && this.autoConnectMemberStatus) {
+        this.connectMemberStatusWebSocket();
+      }
     } catch (error) {
       logVoipDebug("initializeSDK() config check failure", {
         message: error instanceof Error ? error.message : String(error)
@@ -1999,6 +2218,8 @@ var ReactNativeVoipSdk = class {
     try {
       const id = callId ?? this.activeCallId;
       if (!id) return createErrorResult("No active call to answer");
+      this.incomingCallAccepted = true;
+      this.pendingIncomingCallId = null;
       await this.answerCall(id);
       return createSuccessResult("Call accepted", null);
     } catch (error) {
@@ -2010,6 +2231,8 @@ var ReactNativeVoipSdk = class {
       if (!this.bridge.nativeModule.rejectCall) {
         return createErrorResult("rejectCall not supported by native module");
       }
+      this.pendingIncomingCallId = null;
+      this.incomingCallAccepted = false;
       const result = await this.bridge.nativeModule.rejectCall({ callId });
       if (!result.success) {
         return createErrorResult(result.error ?? "Failed to reject call");
@@ -2264,8 +2487,61 @@ var ReactNativeVoipSdk = class {
   async holdMusicUrlConfig(audioUrl) {
     return this.configService.holdMusicUrlConfig(audioUrl);
   }
+  /**
+   * Connect to member status WebSocket (default: wss://nextdev.zyratalk.com/websocket).
+   */
+  connectMemberStatusWebSocket(url) {
+    const wsUrl = (url ?? this.websocketUrl)?.trim();
+    if (!wsUrl) {
+      throw new Error(
+        "WebSocket URL is required. Pass url or set websocketUrl in config."
+      );
+    }
+    this.disconnectMemberStatusWebSocket();
+    this.memberStatusWebSocket = new MemberStatusWebSocketClient({
+      url: wsUrl,
+      onStatusUpdate: (update) => this.handleMemberStatusUpdate(update),
+      onConnected: () => {
+        logVoipDebug("WebSocket connected", { url: wsUrl });
+        this.onMemberStatusWebSocketConnected?.();
+      },
+      onDisconnected: () => {
+        logVoipDebug("WebSocket disconnected", { url: wsUrl });
+        this.onMemberStatusWebSocketDisconnected?.();
+      },
+      onError: (error) => {
+        logVoipDebug("member status WebSocket error", {
+          message: error.message
+        });
+        this.bridge.emit("onError", {
+          scope: "member_status_websocket",
+          message: error.message
+        });
+      }
+    });
+    this.memberStatusWebSocket.connect();
+    logVoipDebug("member status WebSocket connecting", { url: wsUrl });
+  }
+  disconnectMemberStatusWebSocket() {
+    if (this.memberStatusWebSocket) {
+      this.memberStatusWebSocket.destroy();
+      this.memberStatusWebSocket = null;
+    }
+  }
+  get isMemberStatusWebSocketConnected() {
+    return this.memberStatusWebSocket?.isConnected ?? false;
+  }
+  getMemberStatus(memberId) {
+    return this.memberStatusWebSocket?.getStatus(memberId);
+  }
+  getMemberStatusMap() {
+    return this.memberStatusWebSocket?.getStatusMap() ?? /* @__PURE__ */ new Map();
+  }
   destroy() {
     logVoipDebug("destroy() invoked");
+    this.disconnectMemberStatusWebSocket();
+    this.pendingIncomingCallId = null;
+    this.incomingCallAccepted = false;
     this.authManager.destroy();
     this.bridge.destroy();
     this.initialized = false;
@@ -2322,6 +2598,9 @@ var ZyraTwilioWrapper = class extends ReactNativeVoipSdk {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_SERVER_URL,
+  DEFAULT_WEBSOCKET_URL,
+  MemberStatusWebSocketClient,
   ReactNativeVoipSdk
 });
 //# sourceMappingURL=index.js.map