call-control-sdk 6.0.7 → 6.0.9

package/dist/index.d.mts

@@ -1,1203 +1,320 @@
-import { SxProps } from '@mui/material';
 import React from 'react';
 
 /**
- * 🚪 Logout Function Type
- *
- * @type LogoutFunction
- * @description 🎯 Type definition for the logout function
- *              Handles secure agent logout with comprehensive cleanup procedures
- *
- * @returns {Promise<any>} Promise that resolves with API response data or rejects with error
- *
- * @example
- * ```typescript
- * const logout: LogoutFunction = async () => {
- *   // Logout logic
- *   return await apiCall();
- * };
- * ```
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-type LogoutFunction = () => Promise<any>;
-
-/**
- * 📊 Hook State Management Types
- *
- * @type HookStateTypes
- * @description 🎛️ Type definitions for all hook state variables
- *              Provides type safety for loading, success, error, and data states
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-type HookStateTypes$2 = {
-  /**
-   * ⏳ Loading state indicator
-   * @description Boolean flag indicating if a logout operation is in progress
-   * @type {boolean}
-   */
-  isLoading: boolean;
-
-  /**
-   * ✅ Success state indicator
-   * @description Boolean flag indicating if the last logout was successful
-   * @type {boolean}
-   */
-  isSuccess: boolean;
-
-  /**
-   * ❌ Error state indicator
-   * @description Boolean flag indicating if the last logout encountered an error
-   * @type {boolean}
-   */
-  isError: boolean;
-
-  /**
-   * 🛡️ Error object
-   * @description Contains the error object when a logout fails
-   * @type {any}
-   */
-  error: any;
-
-  /**
-   * 📊 Response data
-   * @description Contains the response data from successful logout
-   * @type {any}
-   */
-  data: any;
-};
-
-/**
- * 🚪 useLogout Hook Return Type
- *
- * @interface UseLogoutReturn
- * @description 🎯 Complete return type for the useLogout hook
- *              Contains all functions and state for logout functionality
- *
- * @properties
- * - `logout: LogoutFunction` - 🚪 Logout function
- * - `isLoading: boolean` - ⏳ Loading state indicator
- * - `isSuccess: boolean` - ✅ Success state indicator
- * - `isError: boolean` - ❌ Error state indicator
- * - `error: any` - 🛡️ Error object when logout fails
- * - `data: any` - 📊 Response data from successful logout
- *
- * @example
- * ```typescript
- * const LogoutButton = () => {
- *   const hookReturn: UseLogoutReturn = useLogout();
- *   const {
- *     logout,
- *     isLoading,
- *     isSuccess,
- *     isError,
- *     error
- *   } = hookReturn;
- *
- *   // Use the hook functionality
- * };
- * ```
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-interface UseLogoutReturn extends HookStateTypes$2 {
-  /**
-   * 🚪 Logout function
-   * @description Handles secure agent logout with comprehensive cleanup procedures
-   * @type {LogoutFunction}
-   */
-  logout: LogoutFunction;
-}
-
-/**
- * 🚪 Logout Custom Hook
- *
- * @function useLogout
- * @description 🎯 Custom React hook that provides comprehensive agent logout functionality
- *              for the CTI SDK. It handles secure logout procedures, complete state cleanup,
- *              and storage management with intelligent error handling and proper cleanup.
- *
- * @returns {UseLogoutReturn} Hook return object containing:
- *   - `logout: LogoutFunction` - 🚪 Logout function
- *   - `isLoading: boolean` - ⏳ Loading state indicator
- *   - `isSuccess: boolean` - ✅ Success state indicator
- *   - `isError: boolean` - ❌ Error state indicator
- *   - `error: any` - 🛡️ Error object when logout fails
- *   - `data: any` - 📊 Response data from successful logout
- *
- * @example
- * ```typescript
- * // Basic usage in a component
- * const LogoutButton = () => {
- *   const {
- *     logout,
- *     isLoading,
- *     isSuccess,
- *     isError,
- *     error
- *   } = useLogout();
- *
- *   const handleLogout = async () => {
- *     try {
- *       const result = await logout();
- *       console.log('🚪 Logout successful:', result);
- *       // Redirect to login page or handle success
- *     } catch (err) {
- *       console.error('❌ Logout failed:', err);
- *     }
- *   };
- *
- *   return (
- *     <button
- *       onClick={handleLogout}
- *       disabled={isLoading}
- *     >
- *       {isLoading ? 'Logging out...' : 'Logout'}
- *     </button>
- *   );
- * };
- * ```
- *
- * @features
- * - 🚪 Secure agent logout with API validation
- * - 🗑️ Complete state cleanup and reset
- * - 💾 Storage management (localStorage & sessionStorage)
- * - ⏳ Comprehensive loading state management
- * - 🛡️ Robust error handling and recovery
- * - 📊 Real-time state updates via SDK manager
- * - 🔄 Automatic storage cleanup
- *
- * @logic
- * - 🔍 Retrieves agent state from localStorage
- * - 📦 Constructs logout API payload
- * - 📡 Makes API call to logout agent
- * - 🗑️ Clears SDK state manager
- * - 💾 Clears all storage (localStorage & sessionStorage)
- * - 📊 Handles success/error states
- * - ⏳ Manages loading states
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-declare const useLogout: () => UseLogoutReturn;
-
-/**
- * 📅 End Call Data Interface
- *
- * @interface EndCallData
- * @description 📊 Defines the structure for call termination input data
- *              Contains disposition and callback information for ending calls
- *
- * @properties
- * - `disposition?: string` - 📝 Call outcome classification (default: "RES")
- * - `followUp?: string` - 📅 Follow-up requirement (default: "N")
- * - `callbackDate?: string` - 📅 Scheduled callback date (default: "")
- * - `callbackHrs?: string` - 🕐 Scheduled callback hour (default: "")
- * - `callbackMins?: string` - 🕐 Scheduled callback minute (default: "")
- *
- * @example
- * ```typescript
- * // Basic end call data
- * const endCallData: EndCallData = {
- *   disposition: "RES",
- *   followUp: "N"
- * };
- *
- * // With callback scheduling
- * const endCallWithCallback: EndCallData = {
- *   disposition: "RES",
- *   followUp: "Y",
- *   callbackDate: "2024-01-15",
- *   callbackHrs: "14",
- *   callbackMins: "30"
- * };
- * ```
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-interface EndCallData {
-  /**
-   * 📝 Call outcome classification
-   * @description How the call ended (default: "RES" for Resolved)
-   * @type {string | undefined}
-   */
-  disposition?: string;
-
-  /**
-   * 📅 Follow-up requirement
-   * @description Whether follow-up is required (default: "N" for No)
-   * @type {string | undefined}
-   */
-  followUp?: string;
-
-  /**
-   * 📅 Scheduled callback date
-   * @description Date for callback scheduling (YYYY-MM-DD format)
-   * @type {string | undefined}
-   */
-  callbackDate?: string;
-
-  /**
-   * 🕐 Scheduled callback hour
-   * @description Hour for callback scheduling (0-23)
-   * @type {string | undefined}
-   */
-  callbackHrs?: string;
-
-  /**
-   * 🕐 Scheduled callback minute
-   * @description Minute for callback scheduling (0-59)
-   * @type {string | undefined}
-   */
-  callbackMins?: string;
-}
-
-/**
- * 📞 Call Termination Function Type
- *
- * @type CallTerminationFunction
- * @description 🎯 Type definition for the call termination function
- *              Handles call termination with disposition tracking and callback scheduling
- *
- * @param {EndCallData} data - 📊 Call termination data containing disposition and callback info
- * @returns {Promise<any>} Promise that resolves with API response data or rejects with error
- *
- * @example
- * ```typescript
- * const handleEndCall: CallTerminationFunction = async (data) => {
- *   // Call termination logic
- *   return await apiCall(data);
- * };
- * ```
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-type CallTerminationFunction = (data: EndCallData) => Promise<any>;
-
-/**
- * 📊 Hook State Management Types
- *
- * @type HookStateTypes
- * @description 🎛️ Type definitions for all hook state variables
- *              Provides type safety for loading, success, error, and data states
- *
- * @since 1.0.0
- * @author CTI SDK Team
+ * @fileoverview 📦 TypeScript Declaration File for Call Control SDK
+ * @description Comprehensive CTI (Computer Telephony Integration) SDK for React applications.
+ * Provides complete call control functionality including dialing, conferencing, transferring,
+ * and real-time call management with WebSocket integration.
+ *
+ * @author Achala SDK Team
+ * @version 6.x.x
+ * @since 2024
  */
-type HookStateTypes$1 = {
-  /**
-   * ⏳ Loading state indicator
-   * @description Boolean flag indicating if a call termination operation is in progress
-   * @type {boolean}
-   */
-  isLoading: boolean;
-
-  /**
-   * ✅ Success state indicator
-   * @description Boolean flag indicating if the last call termination was successful
-   * @type {boolean}
-   */
-  isSuccess: boolean;
 
-  /**
-   * ❌ Error state indicator
-   * @description Boolean flag indicating if the last call termination encountered an error
-   * @type {boolean}
-   */
-  isError: boolean;
-
-  /**
-   * 🛡️ Error object
-   * @description Contains the error object when a call termination fails
-   * @type {any}
-   */
-  error: any;
-
-  /**
-   * 📊 Response data
-   * @description Contains the response data from successful call terminations
-   * @type {any}
-   */
-  data: any;
-};
+// =============================================================================
+// 🎯 MAIN SDK FUNCTIONS
+// =============================================================================
 
 /**
- * 📞 useEndCall Hook Return Type
+ * 🚀 SDK Initialization Parameters Interface
  *
- * @interface UseEndCallReturn
- * @description 🎯 Complete return type for the useEndCall hook
- *              Contains all functions and state for call termination functionality
+ * @interface InitSDKParams
+ * @description Parameters required for SDK initialization
  *
  * @properties
- * - `handleEndCall: CallTerminationFunction` - 📞 Call termination function
- * - `isLoading: boolean` - ⏳ Loading state indicator
- * - `isSuccess: boolean` - ✅ Success state indicator
- * - `isError: boolean` - ❌ Error state indicator
- * - `error: any` - 🛡️ Error object when call fails
- * - `data: any` - 📊 Response data from successful calls
+ * - `apiKey: string` - Authentication key for SDK access
+ * - `tenantId: string` - Tenant identifier for multi-tenancy support
+ * - `agentId: string` - Agent identifier for call management
+ * - `sdkConfig?: SDKConfig` - Optional SDK configuration for customizing behavior
  *
  * @example
  * ```typescript
- * const EndCallButton = () => {
- *   const hookReturn: UseEndCallReturn = useEndCall();
- *   const {
- *     handleEndCall,
- *     isLoading,
- *     isSuccess,
- *     isError,
- *     error
- *   } = hookReturn;
- *
- *   // Use the hook functionality
+ * const initParams: InitSDKParams = {
+ *   apiKey: "your-api-key",
+ *   tenantId: "tenant-123",
+ *   agentId: "agent-456",
+ *   sdkConfig: {
+ *     isDraggable: true,
+ *     disableSoftPhone: false
+ *   }
  * };
  * ```
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-interface UseEndCallReturn extends HookStateTypes$1 {
-  /**
-   * 📞 Call termination function
-   * @description Handles call termination with disposition tracking and callback scheduling
-   * @type {CallTerminationFunction}
-   */
-  handleEndCall: CallTerminationFunction;
+interface InitSDKParams {
+	/** Authentication key for SDK access */
+	apiKey: string;
+	/** Tenant identifier for multi-tenancy support */
+	tenantId: string;
+	/** Agent identifier for call management */
+	agentId: string;
+	/** Optional SDK configuration for customizing behavior */
+	sdkConfig?: SDKConfig;
 }
 
 /**
- * 📞 End Call Custom Hook
+ * 🚀 Initialize the Call Control SDK
  *
- * @function useEndCall
- * @description 🎯 Custom React hook that provides comprehensive call termination functionality
- *              for the CTI SDK. It handles call disposition capture, callback scheduling,
- *              and proper call cleanup with intelligent state management and error handling.
+ * @function initSDK
+ * @description Initializes the Call Control SDK with authentication credentials and configuration.
+ * Sets up event tracking, state management, and establishes connection to the CTI system.
  *
- * @returns {UseEndCallReturn} Hook return object containing:
- *   - `handleEndCall: CallTerminationFunction` - 📞 Call termination function
- *   - `isLoading: boolean` - ⏳ Loading state indicator
- *   - `isSuccess: boolean` - ✅ Success state indicator
- *   - `isError: boolean` - ❌ Error state indicator
- *   - `error: any` - 🛡️ Error object when call fails
- *   - `data: any` - 📊 Response data from successful calls
+ * @param {InitSDKParams} params - Object containing API key, tenant ID, agent ID, and optional config
+ * @returns {Promise<void>} Promise that resolves when initialization is complete
  *
  * @example
  * ```typescript
- * // Basic usage in a component
- * const EndCallButton = () => {
- *   const {
- *     handleEndCall,
- *     isLoading,
- *     isSuccess,
- *     isError,
- *     error
- *   } = useEndCall();
- *
- *   const endCall = async () => {
- *     try {
- *       const result = await handleEndCall({
- *         disposition: "RES",
- *         followUp: "N"
- *       });
- *       console.log('📞 Call ended:', result);
- *     } catch (err) {
- *       console.error('❌ End call failed:', err);
- *     }
- *   };
+ * // Basic initialization
+ * await initSDK({
+ *   apiKey: "your-api-key",
+ *   tenantId: "tenant-123",
+ *   agentId: "agent-456"
+ * });
  *
- *   return (
- *     <button
- *       onClick={endCall}
- *       disabled={isLoading}
- *     >
- *       {isLoading ? 'Ending...' : 'End Call'}
- *     </button>
- *   );
- * };
+ * // With custom configuration
+ * await initSDK({
+ *   apiKey: "your-api-key",
+ *   tenantId: "tenant-123",
+ *   agentId: "agent-456",
+ *   sdkConfig: {
+ *     isDraggable: true,
+ *     disableSoftPhone: false,
+ *     disableEndCallButton: false
+ *   }
+ * });
  * ```
  *
- * @features
- * - 🎯 Comprehensive call termination with disposition tracking
- * - 📅 Callback scheduling and follow-up management
- * - 🔄 Intelligent state cleanup and reset
- * - ⏳ Comprehensive loading state management
- * - 🛡️ Robust error handling and recovery
- * - 📊 Real-time state updates via SDK manager
- * - 🔄 Automatic call state management
- *
- * @logic
- * - 🔍 Retrieves agent state from localStorage
- * - 📦 Constructs comprehensive API payload
- * - 📡 Makes API call to end call
- * - 🔄 Updates SDK state manager
- * - 📊 Handles success/error states
- * - ⏳ Manages loading states
+ * @throws {Error} When API key is missing or invalid
+ * @throws {Error} When tenant ID is missing or invalid
+ * @throws {Error} When agent ID is missing or invalid
+ * @throws {Error} When initialization fails due to network or authentication issues
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-declare const useEndCall: () => UseEndCallReturn;
-
-/**
- * @interface CallData
- * @description Comprehensive interface defining call-related data structure for CTI operations.
- * Contains all necessary information about active calls, including metadata, status, and references.
- *
- * @declaration
- * ```typescript
- * interface CallData {
- *   mobileNumber?: string;
- *   callReferenceId?: string;
- *   convoxId?: string;
- *   type?: string;
- *   status?: string;
- *   agent_id?: string;
- *   phone_number?: string;
- *   event_time?: string;
- *   convox_id?: string;
- *   process_id?: string;
- *   process_name?: string;
- * }
- * ```
- *
- * @requiredParams None (all fields are optional for flexibility)
- *
- * @returnType Interface definition
- *
- * @example
- * ```typescript
- * const callData: CallData = {
- *   mobileNumber: "1234567890",
- *   callReferenceId: "REF123456",
- *   status: "ONCALL",
- *   agent_id: "agent001",
- *   process_id: "proc001",
- *   process_name: "Sales Process"
- * };
- * ```
- *
- * @return Interface definition for call data structure
- *
- * @conclusion Essential data structure for all call-related operations and state management.
- */
-interface CallData$1 {
-    /** Mobile number of the caller or callee */
-    mobileNumber?: string;
-    /** Unique reference identifier for the call */
-    callReferenceId?: string;
-    /** Convox system identifier for the call */
-    convoxId?: string;
-    /** Type of call (inbound, outbound, internal, etc.) */
-    type?: string;
-    /** Current status of the call (ONCALL, RINGING, WRAPUP, etc.) */
-    status?: string;
-    /** Agent identifier associated with the call */
-    agent_id?: string;
-    /** Phone number involved in the call */
-    phone_number?: string;
-    /** Timestamp when the call event occurred */
-    event_time?: string;
-    /** Convox system call ID */
-    convox_id?: string;
-    /** Process identifier for the call */
-    process_id?: string;
-    /** Name of the process handling the call */
-    process_name?: string;
-}
-/**
- * @interface CallControlPanelProps
- * @description Props interface for the main CallControlPanel component.
- * Defines the properties that can be passed to customize the call control interface behavior.
- *
- * @declaration
- * ```typescript
- * interface CallControlPanelProps {
- *   onDataChange?: (data: CallData) => void;
- * }
- * ```
- *
- * @requiredParams None (all props are optional)
- *
- * @returnType Interface definition
- *
- * @example
- * ```tsx
- * <CallControlPanel
- *   onDataChange={(callData) => {
- *     console.log('Call status changed:', callData.status);
- *     // Handle call data updates
- *   }}
- * />
- * ```
- *
- * @return Interface definition for component props
- *
- * @conclusion Provides flexible configuration for the call control panel component.
- */
-interface CallControlPanelProps$1 {
-    /** Optional callback function triggered when call data changes */
-    onDataChange?: (data: CallData$1) => void;
-}
-/**
- * @interface SDKConfig
- * @description Configuration interface for customizing the Call Control SDK behavior.
- * Allows disabling specific features and customizing the visual appearance of components.
- *
- * @declaration
- * ```typescript
- * interface SDKConfig {
- *   disableEndCallButton?: boolean;
- *   disabledDialButton?: boolean;
- *   disableCallTransferButton?: boolean;
- *   isDraggable?: boolean;
- *   disableSoftPhone?: boolean;
- *   disableConferenceButton?: boolean;
- *   disabled?: SxProps;
- *   enabled?: SxProps;
- *   outlined?: SxProps;
- * }
- * ```
- *
- * @requiredParams None (all configuration options are optional)
- *
- * @returnType Interface definition
- *
- * @example
- * ```typescript
- * const sdkConfig: SDKConfig = {
- *   disableEndCallButton: false,
- *   disabledDialButton: true,
- *   isDraggable: true,
- *   disableSoftPhone: false,
- *   enabled: { backgroundColor: 'green' },
- *   disabled: { backgroundColor: 'gray' }
- * };
- * ```
- *
- * @return Interface definition for SDK configuration
- *
- * @conclusion Provides comprehensive customization options for the CTI interface.
- */
-interface SDKConfig {
-    /** Whether to disable the end call button */
-    disableEndCallButton?: boolean;
-    /** Whether to disable the dial button */
-    disabledDialButton?: boolean;
-    /** Whether to disable the call transfer button */
-    disableCallTransferButton?: boolean;
-    /** Whether the control panel should be draggable */
-    isDraggable?: boolean;
-    /** Whether to disable the soft phone iframe */
-    disableSoftPhone?: boolean;
-    /** Whether to disable the conference button */
-    disableConferenceButton?: boolean;
-    /** Custom styles for disabled button states */
-    disabled?: SxProps;
-    /** Custom styles for enabled button states */
-    enabled?: SxProps;
-    /** Custom styles for outlined button states */
-    outlined?: SxProps;
-}
-
-/**
- * @fileoverview 📞 TypeScript Declaration File for useClickToCall Hook
- *
- * This file contains TypeScript type definitions for the useClickToCall custom hook
- * and its related interfaces. It provides comprehensive type safety and IntelliSense
- * support for developers using the CTI SDK.
- *
- * 🎯 Key Type Definitions:
- * - 📱 StartCallPayload interface for call initiation data
- * - 📞 useClickToCall hook return type
- * - 🔄 Call initiation function signature
- * - 📊 State management types
- *
- * @author CTI SDK Team
- * @version 6.1.0
- * @since 1.0.0
- */
+declare function initSDK(params: InitSDKParams): Promise<void>;
 
 /**
- * 📱 Start Call Payload Interface
+ * 📋 Get SDK Version
  *
- * @interface StartCallPayload
- * @description 📊 Defines the structure for call initiation payload data
- *              Contains the mobile number required to initiate a call
+ * @function getSDKVersion
+ * @description Returns the current version of the Call Control SDK
  *
- * @properties
- * - `mobileNumber: string` - 📱 The phone number to call (required)
+ * @returns {string} Current SDK version string
  *
  * @example
  * ```typescript
- * // Basic call initiation payload
- * const callPayload: StartCallPayload = {
- *   mobileNumber: "1234567890"
- * };
- *
- * // Usage in component
- * const { handleStartCall } = useClickToCall();
- * await handleStartCall({ mobileNumber: "9876543210" });
+ * const version = getSDKVersion();
+ * console.log(`Using Call Control SDK version: ${version}`);
  * ```
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-interface StartCallPayload {
-  /**
-   * 📱 Phone number to call
-   * @description The mobile number that will be called
-   * @type {string}
-   */
-  mobileNumber: string;
-}
+declare function getSDKVersion(): string;
 
 /**
- * 📞 Call Initiation Function Type
+ * ✅ Check SDK Initialization Status
  *
- * @type CallInitiationFunction
- * @description 🎯 Type definition for the call initiation function
- *              Handles both regular calls and conference calls based on agent state
+ * @function isSDKInitialized
+ * @description Checks if the SDK has been successfully initialized
  *
- * @param {StartCallPayload} data - 📊 Call initiation data containing mobile number
- * @returns {Promise<any>} Promise that resolves with API response data or rejects with error
+ * @returns {boolean} True if SDK is initialized, false otherwise
  *
  * @example
  * ```typescript
- * const handleStartCall: CallInitiationFunction = async (data) => {
- *   // Call initiation logic
- *   return await apiCall(data);
- * };
+ * if (isSDKInitialized()) {
+ *   // SDK is ready to use
+ *   console.log("SDK is initialized and ready");
+ * } else {
+ *   console.log("SDK needs to be initialized first");
+ * }
  * ```
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-type CallInitiationFunction = (data: StartCallPayload) => Promise<any>;
-
-/**
- * 📊 Hook State Management Types
- *
- * @type HookStateTypes
- * @description 🎛️ Type definitions for all hook state variables
- *              Provides type safety for loading, success, error, and data states
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-type HookStateTypes = {
-  /**
-   * ⏳ Loading state indicator
-   * @description Boolean flag indicating if a call operation is currently in progress
-   * @type {boolean}
-   */
-  isLoading: boolean;
-
-  /**
-   * ✅ Success state indicator
-   * @description Boolean flag indicating if the last call operation was successful
-   * @type {boolean}
-   */
-  isSuccess: boolean;
-
-  /**
-   * ❌ Error state indicator
-   * @description Boolean flag indicating if the last call operation encountered an error
-   * @type {boolean}
-   */
-  isError: boolean;
+declare function isSDKInitialized(): boolean;
 
-  /**
-   * 🛡️ Error object
-   * @description Contains the error object when a call operation fails
-   * @type {any}
-   */
-  error: any;
-
-  /**
-   * 📊 Response data
-   * @description Contains the response data from successful call operations
-   * @type {any}
-   */
-  data: any;
-};
+// =============================================================================
+// 🎭 COMPONENT EXPORTS
+// =============================================================================
 
 /**
- * 📞 useClickToCall Hook Return Type
+ * 🎭 Call Control Panel Component
  *
- * @interface UseClickToCallReturn
- * @description 🎯 Complete return type for the useClickToCall hook
- *              Contains all functions and state for call initiation functionality
+ * @component CallControlPanel
+ * @description Main call control panel component for the CTI SDK.
+ * Provides comprehensive call management interface with all necessary controls.
  *
- * @properties
- * - `handleStartCall: CallInitiationFunction` - 📞 Call initiation function
- * - `isLoading: boolean` - ⏳ Loading state indicator
- * - `isSuccess: boolean` - ✅ Success state indicator
- * - `isError: boolean` - ❌ Error state indicator
- * - `error: any` - 🛡️ Error object when call fails
- * - `data: any` - 📊 Response data from successful calls
+ * @param {CallControlPanelProps} props - Component props
+ * @returns {JSX.Element} Call control panel interface
  *
  * @example
- * ```typescript
- * const CallButton = () => {
- *   const hookReturn: UseClickToCallReturn = useClickToCall();
- *   const {
- *     handleStartCall,
- *     isLoading,
- *     isSuccess,
- *     isError,
- *     error
- *   } = hookReturn;
- *
- *   // Use the hook functionality
- * };
+ * ```tsx
+ * <CallControlPanel onDataChange={handleDataChange} />
  * ```
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-interface UseClickToCallReturn extends HookStateTypes {
-  /**
-   * 📞 Call initiation function
-   * @description Handles call initiation with intelligent routing based on agent state
-   * @type {CallInitiationFunction}
-   */
-  handleStartCall: CallInitiationFunction;
-}
+declare const CallControlPanel: React.ComponentType<CallControlPanelProps>;
 
-/**
- * 📞 Click-to-Call Custom Hook
- *
- * @function useClickToCall
- * @description 🎯 Custom React hook that provides comprehensive call initiation functionality
- *              for the CTI SDK. It intelligently handles both regular calls and conference calls
- *              based on the current agent state, with proper loading states and error handling.
- *
- * @returns {UseClickToCallReturn} Hook return object containing:
- *   - `handleStartCall: CallInitiationFunction` - 📞 Call initiation function
- *   - `isLoading: boolean` - ⏳ Loading state indicator
- *   - `isSuccess: boolean` - ✅ Success state indicator
- *   - `isError: boolean` - ❌ Error state indicator
- *   - `error: any` - 🛡️ Error object when call fails
- *   - `data: any` - 📊 Response data from successful calls
- *
- * @example
- * ```typescript
- * // Basic usage in a component
- * const CallButton = () => {
- *   const {
- *     handleStartCall,
- *     isLoading,
- *     isSuccess,
- *     isError,
- *     error
- *   } = useClickToCall();
- *
- *   const makeCall = async () => {
- *     try {
- *       const result = await handleStartCall({
- *         mobileNumber: "1234567890"
- *       });
- *       console.log('📞 Call initiated:', result);
- *     } catch (err) {
- *       console.error('❌ Call failed:', err);
- *     }
- *   };
- *
- *   return (
- *     <button
- *       onClick={makeCall}
- *       disabled={isLoading}
- *     >
- *       {isLoading ? 'Calling...' : 'Make Call'}
- *     </button>
- *   );
- * };
- * ```
- *
- * @features
- * - 🎯 Intelligent call routing based on agent state
- * - 📱 Regular call initiation for idle agents
- * - 👥 Conference call initiation for busy agents
- * - ⏳ Comprehensive loading state management
- * - 🛡️ Robust error handling and recovery
- * - 📊 Real-time state updates via SDK manager
- * - 🔄 Automatic conference dialog management
- *
- * @logic
- * - 🔍 Checks agent status from localStorage state
- * - 📞 Initiates regular call if agent is IDLE
- * - 👥 Initiates conference call if agent is ONCALL
- * - ⚠️ Shows alert if agent is not ready
- * - 🔄 Updates conference line state for conference calls
- * - 🎭 Opens conference dialog for conference calls
- *
- * @since 1.0.0
- * @author CTI SDK Team
- */
-declare const useClickToCall: () => UseClickToCallReturn;
-
-/**
- * @fileoverview 📞 TypeScript Declaration File for CallControlPanel Component
- *
- * This file contains TypeScript type definitions for the CallControlPanel component
- * and its related interfaces. It provides comprehensive type safety and IntelliSense
- * support for developers using the CTI SDK main component.
- *
- * 🎯 Key Type Definitions:
- * - 📞 CallControlPanelProps interface for component props
- * - 📞 CallData interface for call data structure
- * - 🔄 Data change callback types
- * - 📊 Component return types
- * - 🎯 Error handling types
- *
- * @author CTI SDK Team
- * @version 6.1.0
- * @since 1.0.0
- */
+// =============================================================================
+// 🗃️ TYPE EXPORTS
+// =============================================================================
 
 /**
  * 📞 Call Data Interface
  *
  * @interface CallData
- * @description 📊 Comprehensive interface defining call-related data structure for CTI operations.
- *              Contains all necessary information about active calls, including metadata, status, and references.
+ * @description Comprehensive interface defining call-related data structure for CTI operations.
+ * Contains all necessary information about active calls, including metadata, status, and references.
  *
  * @properties
- * - `mobileNumber?: string` - 📱 Mobile number of the caller or callee
- * - `callReferenceId?: string` - 🔗 Unique reference identifier for the call
- * - `convoxId?: string` - 🔗 Convox system identifier for the call
- * - `type?: string` - 📞 Type of call (inbound, outbound, internal, etc.)
- * - `status?: string` - 📊 Current status of the call (ONCALL, RINGING, WRAPUP, etc.)
- * - `agent_id?: string` - 👤 Agent identifier associated with the call
- * - `phone_number?: string` - 📱 Phone number involved in the call
- * - `event_time?: string` - ⏰ Timestamp when the call event occurred
- * - `convox_id?: string` - 🔗 Convox system call ID
- * - `process_id?: string` - ⚙️ Process identifier for the call
- * - `process_name?: string` - 📝 Name of the process handling the call
- *
- * @example
- * ```typescript
- * const callData: CallData = {
- *   mobileNumber: "1234567890",
- *   callReferenceId: "REF123456",
- *   status: "ONCALL",
- *   agent_id: "agent001",
- *   process_id: "proc001",
- *   process_name: "Sales Process"
- * };
- * ```
+ * - `mobileNumber?: string` - Mobile number of the caller or callee
+ * - `callReferenceId?: string` - Unique reference identifier for the call
+ * - `convoxId?: string` - Convox system identifier for the call
+ * - `type?: string` - Type of call (inbound, outbound, internal, etc.)
+ * - `status?: string` - Current status of the call (ONCALL, RINGING, WRAPUP, etc.)
+ * - `agent_id?: string` - Agent identifier associated with the call
+ * - `phone_number?: string` - Phone number involved in the call
+ * - `event_time?: string` - Timestamp when the call event occurred
+ * - `convox_id?: string` - Convox system call ID
+ * - `process_id?: string` - Process identifier for the call
+ * - `process_name?: string` - Name of the process handling the call
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
 interface CallData {
-	/** Mobile number of the caller or callee */
 	mobileNumber?: string;
-	/** Unique reference identifier for the call */
 	callReferenceId?: string;
-	/** Convox system identifier for the call */
 	convoxId?: string;
-	/** Type of call (inbound, outbound, internal, etc.) */
 	type?: string;
-	/** Current status of the call (ONCALL, RINGING, WRAPUP, etc.) */
 	status?: string;
-	/** Agent identifier associated with the call */
 	agent_id?: string;
-	/** Phone number involved in the call */
 	phone_number?: string;
-	/** Timestamp when the call event occurred */
 	event_time?: string;
-	/** Convox system call ID */
 	convox_id?: string;
-	/** Process identifier for the call */
 	process_id?: string;
-	/** Name of the process handling the call */
 	process_name?: string;
 }
 
 /**
- * 🔄 Data Change Callback Type
- *
- * @type DataChangeCallback
- * @description 🎯 Type definition for data change callback function
- *              Called whenever call data changes in the component
+ * ⚙️ SDK Configuration Interface
  *
- * @param {CallData} data - Updated call data
- * @returns {void} No return value
+ * @interface SDKConfig
+ * @description Configuration interface for customizing the Call Control SDK behavior.
+ * Allows disabling specific features and customizing the visual appearance of components.
  *
- * @example
- * ```typescript
- * const onDataChange: DataChangeCallback = (data) => {
- *   console.log('Call data updated:', data);
- *   // Handle call data changes
- * };
- * ```
+ * @properties
+ * - `disableEndCallButton?: boolean` - Whether to disable the end call button
+ * - `disabledDialButton?: boolean` - Whether to disable the dial button
+ * - `disableCallTransferButton?: boolean` - Whether to disable the call transfer button
+ * - `isDraggable?: boolean` - Whether the control panel should be draggable
+ * - `disableSoftPhone?: boolean` - Whether to disable the soft phone iframe
+ * - `disableConferenceButton?: boolean` - Whether to disable the conference button
+ * - `disabled?: SxProps` - Custom styles for disabled button states
+ * - `enabled?: SxProps` - Custom styles for enabled button states
+ * - `outlined?: SxProps` - Custom styles for outlined button states
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-type DataChangeCallback = (data: CallData) => void;
+interface SDKConfig {
+	disableEndCallButton?: boolean;
+	disabledDialButton?: boolean;
+	disableCallTransferButton?: boolean;
+	isDraggable?: boolean;
+	disableSoftPhone?: boolean;
+	disableConferenceButton?: boolean;
+	disabled?: any;
+	enabled?: any;
+	outlined?: any;
+}
 
 /**
- * 📞 Call Control Panel Props Interface
+ * 🎭 Call Control Panel Props Interface
  *
  * @interface CallControlPanelProps
- * @description 📊 Props interface for the main CallControlPanel component.
- *              Defines the properties that can be passed to customize the call control interface behavior.
+ * @description Props interface for the CallControlPanel component.
+ * Defines the properties passed to the call control panel.
  *
  * @properties
- * - `onDataChange?: DataChangeCallback` - 🔄 Optional callback function triggered when call data changes
- *
- * @example
- * ```tsx
- * <CallControlPanel
- *   onDataChange={(callData) => {
- *     console.log('Call status changed:', callData.status);
- *     // Handle call data updates
- *   }}
- * />
- * ```
+ * - `onDataChange?: (data: CallData) => void` - Callback for call data changes
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
 interface CallControlPanelProps {
-	/** Optional callback function triggered when call data changes */
-	onDataChange?: DataChangeCallback;
+	onDataChange?: (data: CallData) => void;
 }
 
+// =============================================================================
+// 🔧 HOOK EXPORTS
+// =============================================================================
+
 /**
- * 📞 Call Control Panel Component Type
+ * 🚪 Logout Hook
  *
- * @type CallControlPanelComponent
- * @description 🎯 Type definition for the CallControlPanel component
- *              Memoized React component with proper prop types
+ * @function useLogout
+ * @description Custom hook for handling agent logout functionality.
+ * Provides logout functionality with proper cleanup and state management.
  *
- * @param {CallControlPanelProps} props - Component props
- * @returns {JSX.Element} React component element
+ * @returns {Function} Logout function
  *
  * @example
  * ```typescript
- * const CallControlPanel: CallControlPanelComponent = memo(({ onDataChange }) => {
- *   // Component implementation
- * });
+ * const logout = useLogout();
+ * logout();
  * ```
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-
-type CallControlPanelComponent = React.MemoExoticComponent<
-	(props: CallControlPanelProps) => React.ReactElement
->;
+declare function useLogout(): () => void;
 
 /**
- * 📞 Call Control Panel Component
+ * 🔚 End Call Hook
  *
- * @function CallControlPanel
- * @description 🎯 Main wrapper component that provides the complete call control interface.
- *              Wraps the CallControls component with necessary providers and context.
+ * @function useEndCall
+ * @description Custom hook for handling call termination functionality.
+ * Provides end call functionality with proper state management and cleanup.
  *
- * @param {CallControlPanelProps} props - Component props including optional data change callback
- * @returns {JSX.Element} React component providing complete call control interface
+ * @returns {Function} End call function
  *
  * @example
- * ```tsx
- * // Basic usage
- * <CallControlPanel />
- *
- * // With data change callback
- * <CallControlPanel
- *   onDataChange={(callData) => {
- *     console.log('Call data updated:', callData);
- *     // Handle call data changes
- *   }}
- * />
+ * ```typescript
+ * const endCall = useEndCall();
+ * endCall();
  * ```
  *
- * @features
- * - 📞 **Complete CTI Interface**: Provides full call control functionality
- * - 🔄 **Data Change Handling**: Optional callback for call data updates
- * - 🛡️ **Error Handling**: Comprehensive error handling for data changes
- * - ⚡ **Performance Optimized**: Uses React.memo for optimal re-rendering
- * - 🎯 **Type Safety**: Full TypeScript support with comprehensive types
- * - 🔧 **Provider Integration**: Wraps components with necessary providers
- * - 📊 **State Management**: Integrated with SDK state management
+ * @since 1.0.0
+ * @author CTI SDK Team
+ */
+declare function useEndCall(): () => void;
+
+/**
+ * 📞 Click to Call Hook
+ *
+ * @function useClickToCall
+ * @description Custom hook for handling click-to-call functionality.
+ * Provides dialing functionality with proper state management and error handling.
  *
- * @logic
- * - 🔄 Creates internal data change handler with error handling
- * - 🎯 Wraps CallControls component with SDKProvider
- * - 📊 Passes data change handler to CallControls
- * - 🛡️ Handles errors gracefully in data change callbacks
- * - ⚡ Uses useCallback for performance optimization
+ * @returns {Function} Click to call function
+ *
+ * @example
+ * ```typescript
+ * const clickToCall = useClickToCall();
+ * clickToCall("1234567890");
+ * ```
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
-declare const CallControlPanel: CallControlPanelComponent;
-
-/**
- * @fileoverview Call Control SDK - Main Entry Point
- * @description Comprehensive CTI (Computer Telephony Integration) SDK for React applications.
- * Provides complete call control functionality including dialing, conferencing, transferring,
- * and real-time call management with WebSocket integration.
- *
- * @author Achala IT Solutions
- * @version 1.0.0
- * @since 2024
- */
-
-/**
- * @interface InitSDKParams
- * @description Parameters required for SDK initialization
- *
- * @declaration
- * ```typescript
- * interface InitSDKParams {
- *   apiKey: string;
- *   tenantId: string;
- *   agentId: string;
- *   sdkConfig?: SDKConfig;
- * }
- * ```
- *
- * @requiredParams
- * - `apiKey: string` - Authentication key for SDK access
- * - `tenantId: string` - Tenant identifier for multi-tenancy support
- * - `agentId: string` - Agent identifier for call management
- *
- * @returnType Interface definition
- *
- * @example
- * ```typescript
- * const initParams: InitSDKParams = {
- *   apiKey: "your-api-key",
- *   tenantId: "tenant-123",
- *   agentId: "agent-456",
- *   sdkConfig: {
- *     isDraggable: true,
- *     disableSoftPhone: false
- *   }
- * };
- * ```
- *
- * @return Interface definition for SDK initialization parameters
- *
- * @conclusion Essential interface for proper SDK initialization with all required parameters.
- */
-interface InitSDKParams {
-    /** Authentication key for SDK access */
-    apiKey: string;
-    /** Tenant identifier for multi-tenancy support */
-    tenantId: string;
-    /** Agent identifier for call management */
-    agentId: string;
-    /** Optional SDK configuration for customizing behavior */
-    sdkConfig?: SDKConfig;
-}
-/**
- * @function initSDK
- * @description Initializes the Call Control SDK with authentication credentials and configuration.
- * Sets up event tracking, state management, and establishes connection to the CTI system.
- *
- * @declaration
- * ```typescript
- * function initSDK(params: InitSDKParams): Promise<void>
- * ```
- *
- * @requiredParams
- * - `params: InitSDKParams` - Object containing API key, tenant ID, agent ID, and optional config
- *
- * @returnType `Promise<void>`
- *
- * @example
- * ```typescript
- * // Basic initialization
- * await initSDK({
- *   apiKey: "your-api-key",
- *   tenantId: "tenant-123",
- *   agentId: "agent-456"
- * });
- *
- * // With custom configuration
- * await initSDK({
- *   apiKey: "your-api-key",
- *   tenantId: "tenant-123",
- *   agentId: "agent-456",
- *   sdkConfig: {
- *     isDraggable: true,
- *     disableSoftPhone: false,
- *     disableEndCallButton: false
- *   }
- * });
- * ```
- *
- * @return Promise that resolves when initialization is complete
- *
- * @throws {Error} When API key is missing or invalid
- * @throws {Error} When tenant ID is missing or invalid
- * @throws {Error} When agent ID is missing or invalid
- * @throws {Error} When initialization fails due to network or authentication issues
- *
- * @conclusion Critical function that must be called before using any SDK functionality.
- */
-declare function initSDK({ apiKey, tenantId, agentId, sdkConfig, }: InitSDKParams): Promise<void>;
-/**
- * @function getSDKVersion
- * @description Returns the current version of the Call Control SDK
- *
- * @declaration
- * ```typescript
- * function getSDKVersion(): string
- * ```
- *
- * @requiredParams None
- *
- * @returnType `string`
- *
- * @example
- * ```typescript
- * const version = getSDKVersion();
- * console.log(`Using Call Control SDK version: ${version}`);
- * ```
- *
- * @return Current SDK version string
- *
- * @conclusion Utility function for version checking and debugging purposes.
- */
-declare function getSDKVersion(): string;
-/**
- * @function isSDKInitialized
- * @description Checks if the SDK has been successfully initialized
- *
- * @declaration
- * ```typescript
- * function isSDKInitialized(): boolean
- * ```
- *
- * @requiredParams None
- *
- * @returnType `boolean`
- *
- * @example
- * ```typescript
- * if (isSDKInitialized()) {
- *   // SDK is ready to use
- *   console.log("SDK is initialized and ready");
- * } else {
- *   console.log("SDK needs to be initialized first");
- * }
- * ```
- *
- * @return True if SDK is initialized, false otherwise
- *
- * @conclusion Utility function for checking SDK initialization status before using features.
- */
-declare function isSDKInitialized(): boolean;
+declare function useClickToCall(): (phoneNumber: string) => void;
 
-export { CallControlPanel, type CallControlPanelProps$1 as CallControlPanelProps, type CallData$1 as CallData, type SDKConfig, getSDKVersion, initSDK, isSDKInitialized, useClickToCall, useEndCall, useLogout };
+export { CallControlPanel, type CallControlPanelProps, type CallData, type InitSDKParams, type SDKConfig, getSDKVersion, initSDK, isSDKInitialized, useClickToCall, useEndCall, useLogout };