@callpromn/rtc-sdk 0.0.3

package/LICENSE.txt

@@ -0,0 +1,32 @@
+SOFTWARE LICENSE AGREEMENT
+
+Copyright © 2025 CallPro LLC. All rights reserved.
+
+This Software License Agreement (“Agreement”) is a legal agreement between you (“Licensee”) and CallPro LLC (“Licensor”) for the use of the "rtc-sdk" software (“Software”). By installing, copying, or otherwise using the Software, you agree to be bound by the terms of this Agreement.
+
+1. Grant of License
+Licensor grants Licensee a non-exclusive, non-transferable, revocable license to use the Software solely for the purpose of developing applications that interact with or make use of the Software’s functionality.
+
+2. Restrictions
+Licensee shall not, directly or indirectly:
+a. Copy, modify, adapt, translate, or create derivative works of the Software.
+b. Reverse-engineer, decompile, disassemble, or otherwise attempt to discover the source code of the Software.
+c. Distribute, sublicense, rent, lease, or sell the Software, in whole or in part, to any third party.
+d. Remove or alter any proprietary notices, labels, or marks from the Software.
+
+3. Ownership
+The Software is licensed, not sold. Licensor retains all rights, title, and interest in and to the Software, including all intellectual property rights therein.
+
+4. Termination
+This Agreement is effective until terminated. Licensor may terminate this Agreement at any time if Licensee breaches any provision. Upon termination, Licensee must cease all use of the Software and destroy all copies in its possession.
+
+5. Disclaimer of Warranty
+The Software is provided “AS IS” without warranty of any kind, whether express, implied, or statutory, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement.
+
+6. Limitation of Liability
+In no event shall Licensor be liable for any indirect, incidental, consequential, special, or punitive damages arising out of or related to the use of the Software.
+
+7. Governing Law
+This Agreement shall be governed by and construed in accordance with the laws of Mongolia, without regard to conflict of law principles.
+
+BY USING THE SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTOOD IT, AND AGREE TO BE BOUND BY ITS TERMS.

package/README.md

@@ -0,0 +1,173 @@
+# RTC-SDK
+
+RTC-SDK нь CallPro компанийн боловсруулсан, дуудлагын үйлчилгээг хурдан, шууд нэгтгэх зориулалттай SDK юм.
+
+Энэхүү санг ашигласнаар та өөрийн системд дэлхийн хаанаас ч үүрэн болон суурин утас руу дуудлага хийх, хүлээн авах боломжийг нэмэх боломжтой.
+
+## Суулгах
+
+RTC-SDK-ийг суулгах
+
+```bash
+  npm install @callpromn/rtc-sdk
+```
+
+## Badges
+
+[![npm version](https://badge.fury.io/js/@callpromn%2Frtc-sdk.svg)](https://www.npmjs.com/package/@callpromn/rtc-sdk)
+[![npm downloads](https://img.shields.io/npm/dm/@callpromn/rtc-sdk.svg)](https://www.npmjs.com/package/@callpromn/rtc-sdk)
+[![MIT License](https://img.shields.io/npm/l/@callpromn/rtc-sdk.svg)](https://choosealicense.com/licenses/mit/)
+
+## 🚀 Quickstart
+
+```javascript
+import CallClient from '@callpromn/rtc-sdk';
+
+// CallClient үүсгэх
+const callClient = CallClient();
+
+// Client-ын instance үүсгэх
+const callClientInstance = await callClient.createClient(config);
+
+// Гарах дуудлага хийх
+await callClientInstance.createCall('12345678');
+```
+
+## ⚙️ Тохиргоо
+
+```javascript
+const config = {
+  socketUrl: 'wss://example.callpro.mn',
+  socketToken: 'token',
+  socketConnectionOptions: {}, // (optional) socket.io холболтын тохиргоо
+  phoneNumber: '12345678', // таны утасны дугаар
+  outboundRoom: 'outboundRoom', // гарах дуудлагын өрөө
+  inboundRoom: 'inboundRoom', // орох дуудлагын өрөө
+};
+```
+
+## APIs
+
+```javascript
+import CallClient from '@callpromn/rtc-sdk';
+
+const callClient = CallClient();
+const callClientInstance = await callClient.createClient(config);
+```
+
+### 📤 Гарах дуудлага
+
+```javascript
+await callClientInstance.createCall('утасны_дугаар'); // Залгах дугаараа оруулан залгах
+```
+
+### 📥 Орох дуудлага
+
+```javascript
+await callClientInstance.acceptCall(); // Ирж буй дуудлагыг хүлээж авах
+await callClientInstance.declineCall(); // Ирж буй дуудлагыг хүлээж авахгүй байх
+```
+
+### Бусад хийх боломжтой үйлдлүүд
+
+#### isConnected()
+
+```javascript
+await callClientInstance.isConnected();
+```
+
+Socket сервертэй холбогдсон эсэхийг шалгана.
+
+#### endCall()
+
+```javascript
+await callClientInstance.endCall();
+```
+
+Идэвхтэй явагдаж буй дуудлагыг дуусгана.
+
+#### toggleMic()
+
+```javascript
+await callClientInstance.toggleMic();
+```
+
+Микрофоныг нээх/хаах (mute/unmute) үйлдэл хийнэ.
+
+#### getInboundUserData()
+
+```javascript
+await callClientInstance.getInboundUserData();
+```
+
+Залгаж буй хэрэглэгчийн мэдээллийг авах
+
+## Эвентүүд
+
+RTC-SDK нь хэрэглэгчид рүү бодит цагын(real-time) эвентүүд илгээдэг.
+Эдгээр эвентүүдийг callClientInstance.on(eventName, callback) хэлбэрээр сонсож ашиглана.
+
+| Эвент нэр       | Параметр                        | Тайлбар                                                                                                                                              |
+| --------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`call_init`** | `"incoming"` эсвэл `"outbound"` | Дуудлага эхлэх үед үүснэ. `"incoming"` нь хэрэглэгч рүү орох дуудлага ирж байгааг, `"outbound"` нь хэрэглэгч гарах дуудлага хийж байгааг илэрхийлнэ. |
+| **`ringing`**   | -                               | Дуудлага холбогдох гэж байх үед (дуугарч байх үед) үүснэ.                                                                                            |
+| **`answered`**  | -                               | Нөгөө тал дуудлагыг хүлээж авсан үед үүснэ.                                                                                                          |
+| **`busy`**      | -                               | Хүлээн авагчийн утас завгүй үед үүснэ.                                                                                                               |
+| **`hangup`**    | -                               | Дуудлага дууссан үед (аль ч талаас тасалсан) үүснэ.                                                                                                  |
+
+### Жишээ
+
+```javascript
+callClientInstance.on('call_init', (direction) => {
+  if (direction === 'incoming') {
+    console.log('📥 Орох дуудлага ирлээ');
+  } else if (direction === 'outbound') {
+    console.log('📤 Гарах дуудлага эхэллээ');
+  }
+});
+
+callClientInstance.on('ringing', () => {
+  console.log('Дуудлага дугарч байна...');
+});
+
+callClientInstance.on('answered', () => {
+  console.log('Дуудлага хүлээж авлаа');
+});
+
+callClientInstance.on('busy', () => {
+  console.log('Хүлээн авагч завгүй байна');
+});
+
+callClientInstance.on('hangup', () => {
+  console.log('Дуудлага дууслаа');
+});
+```
+
+## Холбоотой төслүүд
+
+RTC-SDK-ын Prebuild(UI) хувилбарууд
+
+- [RTC-Kit](https://www.npmjs.com/package/@callpromn/rtc-kit)
+- [RTC-Kit-React](https://www.npmjs.com/package/@callpromn/rtc-kit-react)
+- [RTC-Kit-Angular](https://www.npmjs.com/package/@callpromn/rtc-kit-angular) (coming soon)
+- [RTC-Kit-VueJS](https://www.npmjs.com/package/@callpromn/rtc-kit-vue) (coming soon)
+- [RTC-Kit-Svelte](https://www.npmjs.com/package/@callpromn/rtc-kit-svelte) (coming soon)
+
+RTC-SDK-ын No-Code хувилбар
+
+- [No-Code хувилбар](https://callpro.mn) (coming soon)
+
+RTC-SDK-ын бусад хувилбарууд
+
+- [RTCKit-iOS](https://www.npmjs.com/package/@callpromn/rtc-sdk) (coming soon)
+- [RTCKit-Android](https://www.npmjs.com/package/@callpromn/rtc-sdk) (coming soon)
+
+## 🔗 Холбоосууд
+
+- [Documentation](https://docs.callpro.mn)
+- [Жишээ төсөл](https://github.com/callpromn/nextjs-quickstart)
+
+## Холбоо барих, Тусламж
+
+- Бидэнтэй холбоо барих: [CallPro](https://callpro.mn)
+- Бүтээгдэхүүнтэй холбоотой асуулт, зөвлөгөө, тусламж авах: dev@callpro.mn

package/dist/index.d.mts

@@ -0,0 +1,244 @@
+import { ManagerOptions, SocketOptions } from 'socket.io-client';
+
+/**
+ * Configuration object for creating a CallClient instance.
+ *
+ * @interface CallClientConfig
+ * @property {string} socketUrl - WebSocket server URL for signaling (e.g., 'wss://signaling.example.com')
+ * @property {string} socketToken - Authentication token for signaling server connection
+ * @property {Partial<ManagerOptions & SocketOptions>} [socketConnectionOptions] - Optional Socket.IO connection configuration
+ * @property {string} phoneNumber - Tenant's phone number identifier (e.g., '+1234567890')
+ * @property {string} outboundRoom - Room identifier for outbound calls
+ * @property {string} inboundRoom - Room identifier for inbound calls
+ */
+type CallClientConfig = {
+    socketUrl: string;
+    socketToken: string;
+    socketConnectionOptions?: Partial<ManagerOptions & SocketOptions>;
+    phoneNumber: string;
+    outboundRoom: string;
+    inboundRoom: string;
+};
+/**
+ * Data structure containing information about an incoming call.
+ * This type represents the complete payload received when an inbound call is initiated.
+ *
+ * @interface InboundUserData
+ * @property {string} appId - Unique identifier for the calling application
+ * @property {string} callRoom - WebSocket room identifier for the specific call session
+ * @property {string} destNumber - Destination phone number (the number being called)
+ * @property {string} fromName - Display name of the caller
+ * @property {string} fromNumber - Phone number of the caller
+ * @property {string} method - Call method/action type (e.g., 'call_init', 'ringing', 'answered', 'hangup')
+ * @property {string} roomId - WebRTC room identifier for media communication
+ * @property {string} rtcToken - Authentication token for WebRTC server access
+ * @property {string} serverUrl - WebRTC server URL for media relay
+ * @property {number} tenantId - Unique identifier for the tenant/organization
+ * @property {string} userId - Unique identifier for the calling user
+ *
+ * @example
+ * ```typescript
+ * const inboundData: InboundUserData = {
+ *   appId: 'app_12345',
+ *   callRoom: 'room_67890',
+ *   destNumber: '+1234567890',
+ *   fromName: 'John Doe',
+ *   fromNumber: '+0987654321',
+ *   method: 'call_init',
+ *   roomId: 'rtc_room_abc123',
+ *   rtcToken: 'rtc_token_xyz789',
+ *   serverUrl: 'https://rtc.example.com',
+ *   tenantId: 12345,
+ *   userId: 'user_456'
+ * };
+ * ```
+ */
+type InboundUserData = {
+    appId: string;
+    callRoom: string;
+    destNumber: string;
+    fromName: string;
+    fromNumber: string;
+    method: string;
+    roomId: string;
+    rtcToken: string;
+    serverUrl: string;
+    tenantId: number;
+    userId: string;
+} | null;
+/**
+ * Interface defining the public API for a CallClient instance.
+ * This represents the complete set of methods available for managing real-time voice calls.
+ *
+ * @interface CallClientInstance
+ * @property {Function} createCall - Initiates an outbound call to a specified phone number
+ * @property {Function} acceptCall - Accepts an incoming call that was previously initiated
+ * @property {Function} endCall - Terminates the currently active call session
+ * @property {Function} declineCall - Rejects an incoming call without establishing connection
+ * @property {Function} isConnected - Checks the current WebSocket signaling connection status
+ * @property {Function} toggleMic - Toggles microphone mute/unmute state during active calls
+ * @property {Function} getInboundUserData - Retrieves metadata about the current incoming call
+ * @property {Function} on - Registers event listeners for call-related events
+ *
+ * @example
+ * ```typescript
+ * // Create a CallClient instance
+ * const callClient = CallClient();
+ * const client: CallClientInstance = await callClient.createClient(config);
+ *
+ * // Set up event listeners
+ * client.on('call_init', (direction: string) => {
+ *   if (direction === 'incoming') {
+ *     console.log('Incoming call received');
+ *     // Optionally auto-accept or show UI
+ *     await client.acceptCall();
+ *   }
+ * });
+ *
+ * client.on('answered', () => {
+ *   console.log('Call was answered');
+ * });
+ *
+ * client.on('hangup', () => {
+ *   console.log('Call ended');
+ * });
+ *
+ * // Make an outbound call
+ * await client.createCall('+1234567890');
+ *
+ * // Check connection status
+ * if (client.isConnected()) {
+ *   console.log('Signaling server connected');
+ * }
+ *
+ * // Control microphone during call
+ * await client.toggleMic(); // Mute
+ * await client.toggleMic(); // Unmute
+ *
+ * // End the call
+ * await client.endCall();
+ * ```
+ */
+type CallClientInstance = {
+    /**
+     * Initiates an outbound call to the specified phone number.
+     *
+     * @param {string} toPhoneNumber - The destination phone number (e.g., '+1234567890')
+     * @returns {Promise<void>} Promise that resolves when call initiation is complete
+     * @throws {Error} Throws if signaling server is disconnected or invalid phone number
+     */
+    createCall: (toPhoneNumber: string) => Promise<void>;
+    /**
+     * Accepts an incoming call that was previously initiated.
+     * Must be called after receiving a 'call_init' event with direction 'incoming'.
+     *
+     * @returns {Promise<void>} Promise that resolves when call is successfully accepted
+     * @throws {Error} Throws if no incoming call is available or connection fails
+     */
+    acceptCall: () => Promise<void>;
+    /**
+     * Terminates the currently active call session.
+     * Can be called during any active call state (incoming, outgoing, or established).
+     *
+     * @returns {Promise<void>} Promise that resolves when call is successfully ended
+     */
+    endCall: () => Promise<void>;
+    /**
+     * Rejects an incoming call without establishing a connection.
+     * Must be called after receiving a 'call_init' event with direction 'incoming'.
+     *
+     * @returns {Promise<void>} Promise that resolves when call is successfully declined
+     */
+    declineCall: () => Promise<void>;
+    /**
+     * Checks the current WebSocket signaling connection status.
+     *
+     * @returns {boolean} True if connected to signaling server, false otherwise
+     */
+    isConnected: () => boolean;
+    /**
+     * Toggles the microphone mute state during an active call.
+     * If currently muted, will unmute. If currently unmuted, will mute.
+     *
+     * @returns {Promise<void>} Promise that resolves when microphone state is changed
+     * @throws {Error} Throws if no active call or audio device access fails
+     */
+    toggleMic: () => Promise<void>;
+    /**
+     * Retrieves metadata about the current incoming call.
+     * Returns null if no incoming call is available.
+     *
+     * @returns {Promise<InboundUserData>} Promise resolving to call metadata or null
+     */
+    getInboundUserData: () => Promise<InboundUserData>;
+    /**
+     * Registers an event listener for call-related events.
+     *
+     * Available events:
+     * - 'call_init': Fired when call is initiated (payload: 'incoming' | 'outbound')
+     * - 'ringing': Fired when remote party is ringing
+     * - 'answered': Fired when call is answered by remote party
+     * - 'hangup': Fired when call is terminated
+     * - 'busy': Fired when remote party is busy
+     *
+     * @param {string} event - The event name to listen for
+     * @param {Function} handler - The callback function to execute when event fires
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * client.on('call_init', (direction: string) => {
+     *   console.log(`Call initiated: ${direction}`);
+     * });
+     *
+     * client.on('answered', () => {
+     *   console.log('Call answered - conversation started');
+     * });
+     * ```
+     */
+    on: <T = string>(event: string, handler: (payload: T) => void) => void;
+};
+/**
+ * Creates a CallClient instance with real-time communication capabilities.
+ *
+ * This function initializes a complete calling system that handles both inbound and outbound calls,
+ * signaling through WebSocket connections, and audio/video communication through WebRTC.
+ *
+ * @example
+ * ```typescript
+ * const callClient = CallClient();
+ * const client = await callClient.createClient({
+ *   socketUrl: 'wss://signaling.example.com',
+ *   socketToken: 'your-auth-token',
+ *   phoneNumber: '+1234567890',
+ *   outboundRoom: 'outbound_room_id',
+ *   inboundRoom: 'inbound_room_id',
+ *   socketConnectionOptions: {
+ *     timeout: 5000,
+ *     autoConnect: true
+ *   }
+ * });
+ *
+ * // Listen for incoming calls
+ * client.on('inbound-call', (callData) => {
+ *   console.log('Incoming call:', callData);
+ * });
+ *
+ * // Make an outbound call
+ * await client.createCall('destination-number');
+ * ```
+ */
+declare function CallClient(): {
+    createClient: (config: CallClientConfig) => Promise<{
+        createCall: (toPhoneNumber: string) => Promise<void>;
+        acceptCall: () => Promise<void>;
+        endCall: () => Promise<void>;
+        declineCall: () => Promise<void>;
+        isConnected: () => boolean;
+        toggleMic: () => Promise<void>;
+        getInboundUserData: () => Promise<any>;
+        on: <T = any>(event: string, handler: (payload: T) => void) => void;
+    }>;
+};
+
+export { CallClient, type CallClientConfig, type CallClientInstance, type InboundUserData };

package/dist/index.d.ts

@@ -0,0 +1,244 @@
+import { ManagerOptions, SocketOptions } from 'socket.io-client';
+
+/**
+ * Configuration object for creating a CallClient instance.
+ *
+ * @interface CallClientConfig
+ * @property {string} socketUrl - WebSocket server URL for signaling (e.g., 'wss://signaling.example.com')
+ * @property {string} socketToken - Authentication token for signaling server connection
+ * @property {Partial<ManagerOptions & SocketOptions>} [socketConnectionOptions] - Optional Socket.IO connection configuration
+ * @property {string} phoneNumber - Tenant's phone number identifier (e.g., '+1234567890')
+ * @property {string} outboundRoom - Room identifier for outbound calls
+ * @property {string} inboundRoom - Room identifier for inbound calls
+ */
+type CallClientConfig = {
+    socketUrl: string;
+    socketToken: string;
+    socketConnectionOptions?: Partial<ManagerOptions & SocketOptions>;
+    phoneNumber: string;
+    outboundRoom: string;
+    inboundRoom: string;
+};
+/**
+ * Data structure containing information about an incoming call.
+ * This type represents the complete payload received when an inbound call is initiated.
+ *
+ * @interface InboundUserData
+ * @property {string} appId - Unique identifier for the calling application
+ * @property {string} callRoom - WebSocket room identifier for the specific call session
+ * @property {string} destNumber - Destination phone number (the number being called)
+ * @property {string} fromName - Display name of the caller
+ * @property {string} fromNumber - Phone number of the caller
+ * @property {string} method - Call method/action type (e.g., 'call_init', 'ringing', 'answered', 'hangup')
+ * @property {string} roomId - WebRTC room identifier for media communication
+ * @property {string} rtcToken - Authentication token for WebRTC server access
+ * @property {string} serverUrl - WebRTC server URL for media relay
+ * @property {number} tenantId - Unique identifier for the tenant/organization
+ * @property {string} userId - Unique identifier for the calling user
+ *
+ * @example
+ * ```typescript
+ * const inboundData: InboundUserData = {
+ *   appId: 'app_12345',
+ *   callRoom: 'room_67890',
+ *   destNumber: '+1234567890',
+ *   fromName: 'John Doe',
+ *   fromNumber: '+0987654321',
+ *   method: 'call_init',
+ *   roomId: 'rtc_room_abc123',
+ *   rtcToken: 'rtc_token_xyz789',
+ *   serverUrl: 'https://rtc.example.com',
+ *   tenantId: 12345,
+ *   userId: 'user_456'
+ * };
+ * ```
+ */
+type InboundUserData = {
+    appId: string;
+    callRoom: string;
+    destNumber: string;
+    fromName: string;
+    fromNumber: string;
+    method: string;
+    roomId: string;
+    rtcToken: string;
+    serverUrl: string;
+    tenantId: number;
+    userId: string;
+} | null;
+/**
+ * Interface defining the public API for a CallClient instance.
+ * This represents the complete set of methods available for managing real-time voice calls.
+ *
+ * @interface CallClientInstance
+ * @property {Function} createCall - Initiates an outbound call to a specified phone number
+ * @property {Function} acceptCall - Accepts an incoming call that was previously initiated
+ * @property {Function} endCall - Terminates the currently active call session
+ * @property {Function} declineCall - Rejects an incoming call without establishing connection
+ * @property {Function} isConnected - Checks the current WebSocket signaling connection status
+ * @property {Function} toggleMic - Toggles microphone mute/unmute state during active calls
+ * @property {Function} getInboundUserData - Retrieves metadata about the current incoming call
+ * @property {Function} on - Registers event listeners for call-related events
+ *
+ * @example
+ * ```typescript
+ * // Create a CallClient instance
+ * const callClient = CallClient();
+ * const client: CallClientInstance = await callClient.createClient(config);
+ *
+ * // Set up event listeners
+ * client.on('call_init', (direction: string) => {
+ *   if (direction === 'incoming') {
+ *     console.log('Incoming call received');
+ *     // Optionally auto-accept or show UI
+ *     await client.acceptCall();
+ *   }
+ * });
+ *
+ * client.on('answered', () => {
+ *   console.log('Call was answered');
+ * });
+ *
+ * client.on('hangup', () => {
+ *   console.log('Call ended');
+ * });
+ *
+ * // Make an outbound call
+ * await client.createCall('+1234567890');
+ *
+ * // Check connection status
+ * if (client.isConnected()) {
+ *   console.log('Signaling server connected');
+ * }
+ *
+ * // Control microphone during call
+ * await client.toggleMic(); // Mute
+ * await client.toggleMic(); // Unmute
+ *
+ * // End the call
+ * await client.endCall();
+ * ```
+ */
+type CallClientInstance = {
+    /**
+     * Initiates an outbound call to the specified phone number.
+     *
+     * @param {string} toPhoneNumber - The destination phone number (e.g., '+1234567890')
+     * @returns {Promise<void>} Promise that resolves when call initiation is complete
+     * @throws {Error} Throws if signaling server is disconnected or invalid phone number
+     */
+    createCall: (toPhoneNumber: string) => Promise<void>;
+    /**
+     * Accepts an incoming call that was previously initiated.
+     * Must be called after receiving a 'call_init' event with direction 'incoming'.
+     *
+     * @returns {Promise<void>} Promise that resolves when call is successfully accepted
+     * @throws {Error} Throws if no incoming call is available or connection fails
+     */
+    acceptCall: () => Promise<void>;
+    /**
+     * Terminates the currently active call session.
+     * Can be called during any active call state (incoming, outgoing, or established).
+     *
+     * @returns {Promise<void>} Promise that resolves when call is successfully ended
+     */
+    endCall: () => Promise<void>;
+    /**
+     * Rejects an incoming call without establishing a connection.
+     * Must be called after receiving a 'call_init' event with direction 'incoming'.
+     *
+     * @returns {Promise<void>} Promise that resolves when call is successfully declined
+     */
+    declineCall: () => Promise<void>;
+    /**
+     * Checks the current WebSocket signaling connection status.
+     *
+     * @returns {boolean} True if connected to signaling server, false otherwise
+     */
+    isConnected: () => boolean;
+    /**
+     * Toggles the microphone mute state during an active call.
+     * If currently muted, will unmute. If currently unmuted, will mute.
+     *
+     * @returns {Promise<void>} Promise that resolves when microphone state is changed
+     * @throws {Error} Throws if no active call or audio device access fails
+     */
+    toggleMic: () => Promise<void>;
+    /**
+     * Retrieves metadata about the current incoming call.
+     * Returns null if no incoming call is available.
+     *
+     * @returns {Promise<InboundUserData>} Promise resolving to call metadata or null
+     */
+    getInboundUserData: () => Promise<InboundUserData>;
+    /**
+     * Registers an event listener for call-related events.
+     *
+     * Available events:
+     * - 'call_init': Fired when call is initiated (payload: 'incoming' | 'outbound')
+     * - 'ringing': Fired when remote party is ringing
+     * - 'answered': Fired when call is answered by remote party
+     * - 'hangup': Fired when call is terminated
+     * - 'busy': Fired when remote party is busy
+     *
+     * @param {string} event - The event name to listen for
+     * @param {Function} handler - The callback function to execute when event fires
+     * @returns {void}
+     *
+     * @example
+     * ```typescript
+     * client.on('call_init', (direction: string) => {
+     *   console.log(`Call initiated: ${direction}`);
+     * });
+     *
+     * client.on('answered', () => {
+     *   console.log('Call answered - conversation started');
+     * });
+     * ```
+     */
+    on: <T = string>(event: string, handler: (payload: T) => void) => void;
+};
+/**
+ * Creates a CallClient instance with real-time communication capabilities.
+ *
+ * This function initializes a complete calling system that handles both inbound and outbound calls,
+ * signaling through WebSocket connections, and audio/video communication through WebRTC.
+ *
+ * @example
+ * ```typescript
+ * const callClient = CallClient();
+ * const client = await callClient.createClient({
+ *   socketUrl: 'wss://signaling.example.com',
+ *   socketToken: 'your-auth-token',
+ *   phoneNumber: '+1234567890',
+ *   outboundRoom: 'outbound_room_id',
+ *   inboundRoom: 'inbound_room_id',
+ *   socketConnectionOptions: {
+ *     timeout: 5000,
+ *     autoConnect: true
+ *   }
+ * });
+ *
+ * // Listen for incoming calls
+ * client.on('inbound-call', (callData) => {
+ *   console.log('Incoming call:', callData);
+ * });
+ *
+ * // Make an outbound call
+ * await client.createCall('destination-number');
+ * ```
+ */
+declare function CallClient(): {
+    createClient: (config: CallClientConfig) => Promise<{
+        createCall: (toPhoneNumber: string) => Promise<void>;
+        acceptCall: () => Promise<void>;
+        endCall: () => Promise<void>;
+        declineCall: () => Promise<void>;
+        isConnected: () => boolean;
+        toggleMic: () => Promise<void>;
+        getInboundUserData: () => Promise<any>;
+        on: <T = any>(event: string, handler: (payload: T) => void) => void;
+    }>;
+};
+
+export { CallClient, type CallClientConfig, type CallClientInstance, type InboundUserData };