ahs-cti 0.0.2-beta.9 → 0.0.2

package/dist/index.d.ts

@@ -1,5 +1,431 @@
 import React from 'react';
 
+/**
+ * @fileoverview TypeScript Declaration File for SDK State Manager
+ * @description Type declarations for the SDK state management system.
+ * Provides type definitions for centralized state management in the Call Control SDK.
+ *
+ * @author CTI SDK Team
+ * @version 6.x.x
+ * @since 2024
+ */
+
+/**
+ * Inline type definitions to avoid Rollup DTS bundler resolution issues
+ * with relative imports from handwritten .d.ts files.
+ */
+type SDKConfig$1 = {
+	disableEndCallButton?: boolean;
+	disableEndConference?: boolean;
+	enableSmsServices?: boolean;
+	enableQueueName?: boolean;
+	enableRingtone?: boolean;
+	disabledMoreOptionsButton?: boolean;
+	disabledDialButton?: boolean;
+	disableCallTransferButton?: boolean;
+	disableBlindTransfer?: boolean;
+	disableAttendedTransfer?: boolean;
+	disableWarmTransfer?: boolean;
+	isDraggable?: boolean;
+	disableSoftPhone?: boolean;
+	disableConferenceButton?: boolean;
+	disableHoldButton?: boolean;
+	disableMuteButton?: boolean;
+	disabled?: any;
+	enabled?: any;
+	outlined?: any;
+	auto_wrapup_time?: number;
+	break_time?: number;
+	sdkPosition?: "horizontal" | "vertical";
+};
+
+type CallStatus =
+	| "IDLE"
+	| "READY"
+	| "BREAK"
+	| "ONCALL"
+	| "WRAPUP"
+	| "RINGING"
+	| "DIALING"
+	| "MISSED"
+	| "HOLD"
+	| "UNHOLD"
+	| "MUTE"
+	| "UNMUTE"
+	| "DISCONNECTED"
+	| "CONFERENCE"
+	| string;
+
+type CallData$1 = {
+	mode?: string;
+	queue_name?: string;
+	mobileNumber?: string;
+	callReferenceId?: string;
+	callId?: string;
+	type?: string;
+	status: string;
+	agent_id: number;
+	phone_number?: string;
+	event_time?: string;
+	call_id?: string;
+	process_id?: string;
+	process_name?: string;
+	mute?: number;
+	hold?: number;
+	auto_wrapup_time?: number | null;
+};
+
+type ConferenceLineTypes = {
+	line: number;
+	status: string;
+	type: "external" | "internal" | "";
+	phone: string;
+	isMute: boolean;
+	isHold: boolean;
+	isCallStart: boolean;
+	isMergeCall: boolean;
+};
+
+type SDKState$1 = {
+	authorization: any;
+	openConferenceDialog: boolean;
+	openCallTransferDialog: boolean;
+	process?: { process_id: number; process_name: string } | null;
+	agentId: string;
+	sessionId?: string;
+	sdkConfig: SDKConfig$1 | null;
+	urlConfig: any | null;
+	isInitialized: boolean;
+	call_id?: string;
+	process_id?: number;
+	callStartTime: number | null;
+	position?: { x: number; y: number };
+	controlPanelPosition: { x: number; y: number };
+	iframePosition: { x: number; y: number };
+	callData: CallData$1;
+	conferenceLine: ConferenceLineTypes[];
+	hold: number;
+	mute: number;
+	agentStatus: string;
+	sdk: any | null;
+	isPermissionsLoaded: boolean;
+	userPermissions: string[] | null;
+	menuEntitlements: Array<{ code: string; name: string; enabled: boolean }> | null;
+	consultInfo: any | null;
+};
+
+/**
+ * @interface SDKStateManager
+ * @description Interface for the SDK state manager class
+ */
+interface SDKStateManager {
+	/**
+	 * Initialize the SDK with API key, tenant ID, agent ID, and optional configuration
+	 * @param apiKey - API key for authentication
+	 * @param tenantId - Tenant identifier
+	 * @param agentId - Agent identifier
+	 * @param urlConfig - Optional URL configuration
+	 * @param res - Optional initialization response
+	 * @param callControlConfig - Optional call control configuration
+	 */
+	initialize(apiKey: string, tenantId: string, agentId: string, urlConfig?: any, res?: any, callControlConfig?: SDKConfig$1): void;
+
+	/**
+	 * Get the current state
+	 * @returns Current SDK state
+	 */
+	getState(): SDKState$1;
+
+	/**
+	 * Subscribe to state changes
+	 * @param listener - Callback function to be called on state changes
+	 * @returns Unsubscribe function
+	 */
+	subscribe(listener: () => void): () => void;
+
+	/**
+	 * Set holding state
+	 * @param isHolding - Whether call is on hold
+	 */
+	setHolding(isHolding: boolean): void;
+
+	/**
+	 * Set muted state
+	 * @param isMuted - Whether call is muted
+	 */
+	setMuted(isMuted: boolean): void;
+
+	/**
+	 * Set call status
+	 * @param status - Current call status
+	 */
+	setStatus(status: CallStatus): void;
+
+	/**
+	 * Set process information
+	 * @param process - Process data with ID and name
+	 */
+	setProcess(process: { process_id: number; process_name: string }): void;
+
+	/**
+	 * Set control panel position
+	 * @param position - X and Y coordinates
+	 */
+	setControlPanelPosition(position: { x: number; y: number }): void;
+
+	/**
+	 * Set iframe position
+	 * @param position - X and Y coordinates
+	 */
+	setIframePosition(position: { x: number; y: number }): void;
+
+	/**
+	 * Start a call (set start time and status)
+	 */
+	startCall(): void;
+
+	/**
+	 * End a call (reset call state)
+	 */
+	endCall(): void;
+
+	/**
+	 * Set initialization check flag
+	 */
+	setInitCheck(): void;
+
+	/**
+	 * Set conference dialog open state
+	 * @param open - Whether conference dialog is open
+	 */
+	setOpenConferenceDialog(open: boolean): void;
+
+	/**
+	 * Set call transfer dialog open state
+	 * @param open - Whether call transfer dialog is open
+	 */
+	setOpenCallTransferDialog(open: boolean): void;
+
+	/**
+	 * Update call data
+	 * @param data - Partial call data to update
+	 */
+	updateCallData(data: Partial<CallData$1>): void;
+
+	/**
+	 * Update conference data
+	 * @param data - Array of conference line data
+	 */
+	updateConferenceData(data: ConferenceLineTypes[]): void;
+
+	/**
+	 * Set specific conference line
+	 * @param line - Conference line data
+	 */
+	setConferenceLine(line: ConferenceLineTypes): void;
+
+	/**
+	 * Reset conference lines to initial state
+	 */
+	resetConferenceLines(): void;
+
+	/**
+	 * Clear storage and reset to initial state
+	 */
+	clearStorageAndReset(): void;
+
+	/**
+	 * Debug storage data
+	 */
+	debugStorage(): void;
+
+	/**
+	 * Get conference lines
+	 * @returns Array of conference line data
+	 */
+	getConferenceLines(): ConferenceLineTypes[];
+
+	/**
+	 * Set SDK permissions from user info
+	 * @param userInfo - User info object from init response
+	 */
+	setSDKPermissions(userInfo: any): void;
+
+	/**
+	 * Get entitlement-based controls configuration
+	 * @returns Controls configuration derived from permissions
+	 */
+	getControlsConfig(): Partial<SDKConfig$1>;
+}
+
+/**
+ * @class SDKStateManager
+ * @description Centralized state management class for the Call Control SDK.
+ * Handles state persistence, subscriptions, and provides methods for state updates.
+ */
+declare class SDKStateManager implements SDKStateManager {
+	/**
+	 * Initialize the SDK with API key, tenant ID, agent ID, and optional configuration
+	 * @param apiKey - API key for authentication
+	 * @param tenantId - Tenant identifier
+	 * @param agentId - Agent identifier
+	 * @param urlConfig - Optional URL configuration
+	 * @param res - Optional initialization response
+	 * @param callControlConfig - Optional call control configuration
+	 */
+	public initialize(apiKey: string, tenantId: string, agentId: string, urlConfig?: any, res?: any, callControlConfig?: SDKConfig$1): void;
+
+	/**
+	 * Get the current state
+	 * @returns Current SDK state
+	 */
+	public getState(): SDKState$1;
+
+	/**
+	 * Subscribe to state changes
+	 * @param listener - Callback function to be called on state changes
+	 * @returns Unsubscribe function
+	 */
+	public subscribe(listener: () => void): () => void;
+
+	/**
+	 * Store lead data to be attached as lead_data in the transfer API payload.
+	 * Call this whenever lead details change in the host application.
+	 */
+	public setTransferLeadData(data: any): void;
+
+	/**
+	 * Get the currently stored lead data.
+	 */
+	public getTransferLeadData(): any;
+
+	/**
+	 * Clear stored lead data (called automatically when call goes IDLE).
+	 */
+	public clearTransferLeadData(): void;
+
+	/**
+	 * Set holding state
+	 * @param isHolding - Whether call is on hold
+	 */
+	public setHolding(isHolding: boolean): void;
+
+	/**
+	 * Set muted state
+	 * @param isMuted - Whether call is muted
+	 */
+	public setMuted(isMuted: boolean): void;
+
+	/**
+	 * Set call status
+	 * @param status - Current call status
+	 */
+	public setStatus(status: CallStatus): void;
+
+	/**
+	 * Set process information
+	 * @param process - Process data with ID and name
+	 */
+	public setProcess(process: { process_id: number; process_name: string }): void;
+
+	/**
+	 * Set control panel position
+	 * @param position - X and Y coordinates
+	 */
+	public setControlPanelPosition(position: { x: number; y: number }): void;
+
+	/**
+	 * Set iframe position
+	 * @param position - X and Y coordinates
+	 */
+	public setIframePosition(position: { x: number; y: number }): void;
+
+	/**
+	 * Start a call (set start time and status)
+	 */
+	public startCall(): void;
+
+	/**
+	 * End a call (reset call state)
+	 */
+	public endCall(): void;
+
+	/**
+	 * Set initialization check flag
+	 */
+	public setInitCheck(): void;
+
+	/**
+	 * Set conference dialog open state
+	 * @param open - Whether conference dialog is open
+	 */
+	public setOpenConferenceDialog(open: boolean): void;
+
+	/**
+	 * Set call transfer dialog open state
+	 * @param open - Whether call transfer dialog is open
+	 */
+	public setOpenCallTransferDialog(open: boolean): void;
+
+	/**
+	 * Update call data
+	 * @param data - Partial call data to update
+	 */
+	public updateCallData(data: Partial<CallData$1>): void;
+
+	/**
+	 * Update conference data
+	 * @param data - Array of conference line data
+	 */
+	public updateConferenceData(data: ConferenceLineTypes[]): void;
+
+	/**
+	 * Set specific conference line
+	 * @param line - Conference line data
+	 */
+	public setConferenceLine(line: ConferenceLineTypes): void;
+
+	/**
+	 * Reset conference lines to initial state
+	 */
+	public resetConferenceLines(): void;
+
+	/**
+	 * Clear storage and reset to initial state
+	 */
+	public clearStorageAndReset(): void;
+
+	/**
+	 * Debug storage data
+	 */
+	public debugStorage(): void;
+
+	/**
+	 * Get conference lines
+	 * @returns Array of conference line data
+	 */
+	public getConferenceLines(): ConferenceLineTypes[];
+
+	/**
+	 * Set SDK permissions from user info
+	 * @param userInfo - User info object from init response
+	 */
+	public setSDKPermissions(userInfo: any): void;
+
+	/**
+	 * Get entitlement-based controls configuration
+	 * @returns Controls configuration derived from permissions
+	 */
+	public getControlsConfig(): Partial<SDKConfig$1>;
+}
+
+/**
+ * @constant sdkStateManager
+ * @description Singleton instance of the SDK state manager
+ * @type {SDKStateManager}
+ */
+declare const sdkStateManager: SDKStateManager;
+
 /**
  * @fileoverview 📦 TypeScript Declaration File for Call Control SDK
  * @description Comprehensive CTI (Computer Telephony Integration) SDK for agent platform applications.
@@ -96,7 +522,15 @@ interface InitSDKParams {
  * @since 1.0.0
  * @author CTI SDK Team
  */
-declare function initSDK(params: InitSDKParams): Promise<void>;
+interface SDKInitResult {
+	accessToken: string;
+	expiration: string;
+	ticketId: string;
+	callControls: any;
+	userInfo: any;
+}
+
+declare function initSDK(params: InitSDKParams): Promise<SDKInitResult>;
 
 /**
  * 📋 Get SDK Version
@@ -168,6 +602,45 @@ declare function isSDKInitialized(): boolean;
  */
 declare const CallControlPanel: React.ComponentType<CallControlPanelProps>;
 
+/**
+ * 📄 SDK Pages
+ *
+ * @description Pre-built pages provided by the SDK, automatically protected by permission guards.
+ *
+ * @properties
+ * - `CallHistory` - Call History page component
+ * - `Campaigns` - Campaigns / Call Scheduling page component
+ * - `LoginReport` - Agent Login Report page component
+ * - `CdrReports` - CDR (Call Detail Records) Report page component
+ * - `AuditReportPage` - Stand-alone (full-tab) audit report page component
+ * - `AgentPerformanceReport` - Agent Performance Report page component
+ * - `AgentDetailReport` - Agent Detail Report page component
+ * - `LiveStatus` - Supervisor Live Status / Wallboard page component
+ *
+ * @since 1.0.0
+ * @author CTI SDK Team
+ */
+
+interface LiveStatusPageProps {
+	/** When true, renders the TV/wallboard variant: shows the top bar with clock, hides monitor action buttons */
+	isTvDashboard?: boolean;
+}
+
+declare const SDKPages: {
+	readonly CallHistory: React.ComponentType<any>;
+	readonly Campaigns: React.ComponentType<any>;
+	readonly LoginReport: React.ComponentType<any>;
+	readonly CdrReports: React.ComponentType<any>;
+	readonly AuditReportPage: React.ComponentType<{ callUuid?: string }>;
+	readonly AgentPerformanceReport: React.ComponentType<any>;
+	readonly AgentDetailReport: React.ComponentType<any>;
+	readonly LiveStatus: React.ComponentType<LiveStatusPageProps>;
+	readonly ManagementDashboard: React.ComponentType<any>;
+	readonly CaroVoiceAI: React.ComponentType<any>;
+	readonly QualityAuditDashboard: React.ComponentType<any>;
+	readonly CaroQualityAuditDashboard: React.ComponentType<any>;
+};
+
 // =============================================================================
 // 🗃️ TYPE EXPORTS
 // =============================================================================
@@ -191,12 +664,40 @@ declare const CallControlPanel: React.ComponentType<CallControlPanelProps>;
  * @author CTI SDK Team
  */
 interface CallData {
+	mode?: string;
+	queue_name?: string;
+	mobileNumber?: string;
 	callReferenceId?: string;
-	status?: string;
-	agent_id?: string;
+	convoxId?: string;
+	type?: string;
+	status: string;
+	agent_id: number;
 	phone_number?: string;
+	event_time?: string;
+	call_id?: string;
 	process_id?: string;
 	process_name?: string;
+	mute?: number;
+	hold?: number;
+	auto_wrapup_time?: number | null;
+	call_details?: {
+		extension?: string;
+		call_type?: string;
+		caller_direction?: string;
+		agent_id?: number;
+		queue_name?: string;
+		did_number?: string;
+		call_uuid?: string;
+		[key: string]: any;
+	};
+	/** Lead data set by the host app; attached when available */
+	lead_data?: any;
+	/** Raw socket payload from the most recent WebSocket message */
+	socket_info?: any;
+	break_details?: {
+		type: string;
+		value: string;
+	} | null;
 }
 
 /**
@@ -222,6 +723,7 @@ interface CallData {
  */
 interface SDKConfig {
 	disableEndCallButton?: boolean;
+	disableEndConference?: boolean;
 	disabledDialButton?: boolean;
 	enableSmsServices?: boolean;
 	enableQueueName?: boolean;
@@ -235,12 +737,14 @@ interface SDKConfig {
 }
 
 interface URLConfig {
-	id: string;
+	id?: string;
 	baseURL: string;
 	iframeURL: string;
 	iframeAPIURL: string;
 	password: string;
 	webSocketURL: string;
+	coreBaseURL: string;
+	accessToken?: string;
 }
 
 /**
@@ -283,126 +787,64 @@ interface CallControlPanelProps {
  */
 
 /**
- * 📞 End Call Payload Interface
+ * End Call Payload Interface
  *
  * @interface EndCallPayload
- * @description 📊 Defines the structure for call termination API payload data
- *              Contains all necessary information for ending a call with proper disposition
+ * @description Defines the options for ending a call. All fields are optional —
+ *              any omitted field falls back to the current session/call state automatically.
  *
  * @properties
- * - `action: string` - 🎯 API action type ("ENDCALL")
- * - `disposition: string` - 📝 Call outcome classification
- * - `userId: string` - 👤 Agent identifier
- * - `processid: string` - ⚙️ Process identifier
- * - `mobile_number: string` - 📱 Customer phone number
- * - `set_followUp: string` - 📅 Follow-up requirement ("Y" or "N")
- * - `callback_date: string` - 📅 Scheduled callback date
- * - `callback_hrs: string` - 🕐 Scheduled callback hour
- * - `callback_mins: string` - 🕐 Scheduled callback minute
- * - `refno?: string` - 🔗 Optional call reference number
+ * - `call_id?: string`         - Convox call ID (defaults to active call's call_id)
+ * - `agent_id?: string`          - Agent identifier (defaults to logged-in agent)
+ * - `set_followUp?: string`      - Whether a follow-up is required: "Y" or "N" (default: "N")
+ * - `callback_date?: string`     - Scheduled callback date (YYYY-MM-DD)
+ * - `callback_hrs?: number`      - Scheduled callback hour (0–23)
+ * - `callback_mins?: number`     - Scheduled callback minute (0–59)
+ * - `mobile_number?: string`     - Customer phone number (defaults to active call's phone_number)
+ * - `list_comments?: string`     - Optional comments for the call log
+ * - `call_reference_id?: string` - Call reference ID (defaults to active call's call_id)
+ * - `disposition?: string`       - Call outcome code (default: "RES")
+ * - `line_number?: number`       - Conference line number (default: 0)
+ * - `reason?: string`            - End reason sent to server (default: "normal")
+ * - `is_mark_as_break?: boolean` - Whether agent is going on break after the call (sent in request body)
+ * - `patientLog?: any`           - Optional patient/contact log data
  *
  * @example
  * ```typescript
- * // Basic end call payload
- * const endCallPayload: EndCallPayload = {
- *   action: "ENDCALL",
- *   disposition: "RES",
- *   userId: "agent123",
- *   processid: "proc001",
- *   mobile_number: "1234567890",
- *   set_followUp: "N",
- *   callback_date: "",
- *   callback_hrs: "",
- *   callback_mins: ""
- * };
+ * // Minimal — all defaults applied from session state
+ * await endCall();
  *
- * // With callback scheduling
- * const endCallWithCallback: EndCallPayload = {
- *   action: "ENDCALL",
+ * // With disposition and follow-up callback
+ * await endCall({
  *   disposition: "RES",
- *   userId: "agent123",
- *   processid: "proc001",
- *   mobile_number: "1234567890",
  *   set_followUp: "Y",
- *   callback_date: "2024-01-15",
- *   callback_hrs: "14",
- *   callback_mins: "30"
- * };
+ *   callback_date: "2026-05-20",
+ *   callback_hrs: 10,
+ *   callback_mins: 30,
+ * });
+ *
+ * // Agent going on break after call
+ * await endCall({ disposition: "RES", is_mark_as_break: true });
  * ```
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
 interface EndCallPayload {
-	/**
-	 * 🎯 API action type
-	 * @description The action type for the API call
-	 * @type {string}
-	 */
-	action: string;
-
-	/**
-	 * 📝 Call outcome classification
-	 * @description Classification of how the call ended
-	 * @type {string}
-	 */
-	disposition: string;
-
-	/**
-	 * 👤 Agent identifier
-	 * @description Unique identifier for the agent ending the call
-	 * @type {string}
-	 */
-	userId: string;
-
-	/**
-	 * ⚙️ Process identifier
-	 * @description Unique identifier for the process
-	 * @type {string}
-	 */
-	processid: string;
-
-	/**
-	 * 📱 Customer phone number
-	 * @description Phone number of the customer
-	 * @type {string}
-	 */
-	mobile_number: string;
-
-	/**
-	 * 📅 Follow-up requirement
-	 * @description Whether a follow-up is required ("Y" or "N")
-	 * @type {string}
-	 */
-	set_followUp: string;
-
-	/**
-	 * 📅 Scheduled callback date
-	 * @description Date for scheduled callback (YYYY-MM-DD format)
-	 * @type {string}
-	 */
-	callback_date: string;
-
-	/**
-	 * 🕐 Scheduled callback hour
-	 * @description Hour for scheduled callback (0-23)
-	 * @type {string}
-	 */
-	callback_hrs: string;
-
-	/**
-	 * 🕐 Scheduled callback minute
-	 * @description Minute for scheduled callback (0-59)
-	 * @type {string}
-	 */
-	callback_mins: string;
-
-	/**
-	 * 🔗 Optional call reference number
-	 * @description Optional reference number for the call
-	 * @type {string | undefined}
-	 */
-	refno?: string;
+	call_id?: string;
+	agent_id?: string;
+	set_followUp?: string;
+	callback_date?: string;
+	callback_hrs?: number;
+	callback_mins?: number;
+	mobile_number?: string;
+	list_comments?: string;
+	call_reference_id?: string;
+	is_mark_as_break?: boolean;
+	disposition?: string;
+	line_number?: number;
+	reason?: string;
+	patientLog?: any;
 }
 
 /**
@@ -717,7 +1159,7 @@ interface ProcessData {
  *              Contains information about the current call
  *
  * @properties
- * - `convox_id: string` - 🔗 Call reference identifier
+ * - `call_id: string` - 🔗 Call reference identifier
  * - `phone_number: string` - 📱 Customer phone number
  *
  * @since 1.0.0
@@ -729,7 +1171,7 @@ interface EndCallPayLoadData {
 	 * @description Unique identifier for the call
 	 * @type {string}
 	 */
-	convox_id: string;
+	call_id: string;
 
 	/**
 	 * 📱 Customer phone number
@@ -1288,6 +1730,27 @@ interface StartCallPayload {
 	 * @type {string}
 	 */
 	mobileNumber: string;
+	/** Optional user id; defaults to the logged-in agent id when omitted. */
+	user?: string;
+	/** Optional auto-answer flag; defaults to false when omitted. */
+	auto_answer?: boolean;
+	/** Optional Convox call id passthrough. */
+	call_id?: string;
+	/** Optional caller-provided reference id. */
+	reference_id?: string;
+	/** Optional source identifier (e.g. campaign, dialpad). */
+	call_source?: string;
+	/** Optional case id passthrough. */
+	caseId?: string;
+	/** Whether the call is being made during wrap-up. */
+	isWrapup?: boolean;
+	/** Convox call UUID of the parent call; used for wrap-up chaining. */
+	parentCallUuid?: string;
+}
+
+interface ConferenceCallPayload {
+	mobileNumber: string;
+	lineNumber?: number;
 }
 
 /**
@@ -1788,6 +2251,227 @@ interface ErrorResponse {
 	 * @type {any}
 	 */
 	details?: any;
-}
+}
+
+
+// =============================================================================
+// ⚡ FRAMEWORK-AGNOSTIC ACTION EXPORTS (for Angular / non-React consumers)
+// =============================================================================
+
+type SupervisorMonitorMode = "listen" | "whisper" | "barge";
+
+interface StartMonitoringPayload {
+  call_id: string;
+  mode: SupervisorMonitorMode;
+  supervisor_extension?: string;
+  agent_extension?: string;
+}
+
+interface StopMonitoringPayload {
+  call_uuid: string;
+  session_id?: string;
+}
+
+interface ChangeModePayload {
+  call_uuid: string;
+  mode: SupervisorMonitorMode;
+  session_id?: string;
+}
+
+declare function clickToCall(payload: StartCallPayload): Promise<any>;
+declare function clickToConference(payload: ConferenceCallPayload): Promise<any>;
+declare function endCall(options?: EndCallPayload): Promise<any>;
+declare function logout(): Promise<void>;
+declare function startMonitoring(payload: StartMonitoringPayload): Promise<any>;
+declare function stopMonitoring(payload: StopMonitoringPayload): Promise<any>;
+declare function changeMonitorMode(payload: ChangeModePayload): Promise<any>;
+declare function setTransferLeadData(data: any): void;
+
+// =============================================================================
+// ⚛️ REACT HOOKS
+// =============================================================================
+
+interface UseClickToConferenceReturn {
+  handleStartConferenceCall: (payload: ConferenceCallPayload) => Promise<any>;
+  isLoading: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  error: any;
+  data: any;
+}
+
+declare function useClickToConference(): UseClickToConferenceReturn;
+
+// =============================================================================
+// 📊 CALL MONITORING HOOK
+// =============================================================================
+
+interface UseCallMonitoringReturn {
+	startMonitoring: (payload: StartMonitoringPayload) => Promise<any>;
+	stopMonitoring: (payload: StopMonitoringPayload) => Promise<any>;
+	changeMode: (payload: ChangeModePayload) => Promise<any>;
+	isLoading: boolean;
+	isSuccess: boolean;
+	isError: boolean;
+	error: any;
+	data: any;
+}
+
+declare const useCallMonitoring: () => UseCallMonitoringReturn;
+
+// =============================================================================
+// 🗃️ SDK STATE HOOK
+// =============================================================================
+
+declare const useSDKState: () => any;
+
+// =============================================================================
+// 🛡️ ENTITLEMENTS / PERMISSIONS
+// =============================================================================
+
+/** "*" wildcard literal used in permission and menu codes. */
+declare const SDK_WILDCARD: "*";
+
+/** Menu entitlement codes (used by SDKPages and SDKPermissionGuard). */
+declare const SDK_MENU_CODES: {
+	readonly WILDCARD: "*";
+	readonly CALL_HISTORY: "call_history";
+	readonly CAMPAIGNS: "dialer_auto";
+	readonly LOGIN_REPORT: "login_report";
+	readonly CDR_REPORT: "cdr_report";
+	readonly AGENT_PERFORMANCE_REPORT: "agent_performance";
+	readonly AGENT_DETAIL_REPORT: "agent_detail";
+	readonly LIVE_STATUS: "live_status";
+	readonly MANAGEMENT_DASHBOARD: "management_dashboard";
+	readonly CARO_VOICE_AI: "caro_voice_ai";
+	readonly QUALITY_AUDIT_DASHBOARD: "management_dashboard";
+	readonly CARO_QUALITY_AUDIT_DASHBOARD: "management_dashboard";
+};
+
+/** SDK permission codes — feature-level entitlements. */
+declare const SDK_PERMISSIONS: {
+	readonly WILDCARD: "*";
+	readonly CALLS: "calls";
+	readonly CALL_TRANSFER: "call_transfer";
+	readonly CALL_CONFERENCE: "call_conference";
+	readonly CALL_INBOUND: "call_inbound";
+	readonly CALL_OUTBOUND: "call_outbound";
+	readonly CONFERENCE: "call_conference";
+	readonly TRANSFER_BLIND: "call_transfer_blind";
+	readonly TRANSFER_ATTENDED: "call_transfer_attended";
+	readonly TRANSFER_WARM: "call_transfer_warm";
+	readonly CAMPAIGNS_CREATE: "campaigns:create";
+	readonly CAMPAIGNS_READ: "campaigns:read";
+	readonly CAMPAIGNS_UPDATE: "campaigns:update";
+	readonly CAMPAIGNS_DELETE: "campaigns:delete";
+	readonly CAMPAIGNS_MANAGE: "campaigns:manage";
+	readonly CAMPAIGNS_CONTROL: "campaigns:control";
+	readonly CAMPAIGNS_LEADS_CREATE: "leads:create";
+	readonly CAMPAIGNS_LEADS_READ: "leads:read";
+	readonly CAMPAIGNS_LEADS_DELETE: "leads:delete";
+	readonly CAMPAIGNS_LEADS_IMPORT: "leads:import";
+	readonly REPORTS_AGENT_LOGIN_READ: "reports:agent_login:read";
+	readonly REPORTS_AGENT_LOGIN_EXPORT: "reports:agent_login:export";
+	readonly REPORTS_AGENT_LOGIN_MANAGE: "reports:agent_login:manage";
+	readonly REPORTS_CDR_READ: "reports:cdr:read";
+	readonly REPORTS_CDR_EXPORT: "reports:cdr:export";
+	readonly REPORTS_CDR_MANAGE: "reports:cdr:manage";
+	readonly REPORTS_AGENT_PERFORMANCE_READ: "reports:agent_performance:read";
+	readonly REPORTS_AGENT_PERFORMANCE_EXPORT: "reports:agent_performance:export";
+	readonly REPORTS_AGENT_PERFORMANCE_MANAGE: "reports:agent_performance:manage";
+	readonly SUPERVISOR_MONITOR_LISTEN: "supervisor:monitor:listen";
+	readonly SUPERVISOR_MONITOR_WHISPER: "supervisor:monitor:whisper";
+	readonly SUPERVISOR_MONITOR_BARGE: "supervisor:monitor:barge";
+};
+
+// ─── Entitlement types ────────────────────────────────────────────────────────
+
+interface SDKBit {
+	code: string;
+	enabled: boolean;
+}
+
+interface SDKEntitlement {
+	enabled: boolean;
+	items: SDKBit[];
+}
+
+interface SDKEntitlements {
+	calls?: SDKEntitlement;
+	call_controls?: SDKEntitlement;
+	call_transfer?: SDKEntitlement;
+	call_conference?: SDKEntitlement;
+	[key: string]: any;
+}
+
+interface SDKPermissionState {
+	sdk: SDKEntitlements | null;
+	isLoaded: boolean;
+	error: Error | null;
+}
+
+interface ControlsFromPermissions {
+	disabledDialButton: boolean;
+	disableEndCallButton: boolean;
+	disableCallTransferButton: boolean;
+	disableBlindTransfer: boolean;
+	disableAttendedTransfer: boolean;
+	disableWarmTransfer: boolean;
+	disableConferenceButton: boolean;
+	disableHoldButton: boolean;
+	disableMuteButton: boolean;
+	disabledMoreOptionsButton: boolean;
+}
+
+interface SDKPermissionContextValue {
+	state: SDKPermissionState;
+	isBitEnabled: (category: keyof SDKEntitlements, bitCode: string) => boolean;
+	getControlsConfig: () => ControlsFromPermissions;
+}
+
+// ─── useSDKPermissions hook ───────────────────────────────────────────────────
+
+interface SDKPermissionsHook {
+	permissions: string[];
+	menuEntitlements: Array<{ code: string; name: string; enabled: boolean }>;
+	isLoaded: boolean;
+	hasPermission: (permission: string) => boolean;
+	hasAnyPermission: (permissions: string[]) => boolean;
+	hasAllPermissions: (permissions: string[]) => boolean;
+	hasMenuFeature: (code: string) => boolean;
+}
+
+declare function useSDKPermissions(): SDKPermissionsHook;
+
+// ─── Permission guard & access denied components ──────────────────────────────
+
+interface SDKPermissionGuardProps {
+	children?: React.ReactNode;
+	/** Single permission code (e.g. "calls:inbound") */
+	permission?: string;
+	/** Multiple permission codes — ANY match grants access by default */
+	permissions?: string[];
+	/** When true, ALL permissions must be granted */
+	requireAll?: boolean;
+	/** One or more menu feature codes — ANY match grants access by default */
+	menuFeature?: string | string[];
+	/** When true, ALL menu features must be enabled */
+	requireAllMenus?: boolean;
+	/** Custom fallback rendered when access is denied */
+	fallback?: React.ReactNode;
+	/** Show the default Access Denied UI when denied. Defaults to true. */
+	showFallback?: boolean;
+	/** Callback fired when the guard denies access */
+	onDenied?: () => void;
+}
+
+declare const SDKPermissionGuard: React.FC<SDKPermissionGuardProps>;
+
+interface SDKAccessDeniedProps {
+	message?: string;
+}
+
+declare const SDKAccessDenied: React.FC<SDKAccessDeniedProps>;
 
-export { type APIResponse, type AgentStatus, CallControlPanel, type CallControlPanelProps, type CallData, type CallInitiationFunction, type CallTerminationFunction, type CleanupOperation, type ConferenceLine, type DispositionType, type EndCallData, type EndCallPayLoadData, type EndCallPayload, type ErrorResponse, type FollowUpType, type HookStateTypes, type InitSDKParams, type LogoutFunction, type LogoutHookStateTypes, type LogoutPayload, type ProcessData, type SDKConfig, type SDKState, type StartCallPayload, type StartCalltData, type StartCalltHookStateTypes, type StorageType, type URLConfig, type UseClickToCallReturn, type UseEndCallReturn, type UseLogoutReturn, getSDKVersion, initSDK, isSDKInitialized, useClickToCall, useEndCall, useGetAuthorizationToken, useGetCallerData, useLogout };
+export type { APIResponse, AgentStatus, CallControlPanelProps, CallData, CallInitiationFunction, CallTerminationFunction, ChangeModePayload, CleanupOperation, ConferenceCallPayload, ConferenceLine, ControlsFromPermissions, DispositionType, EndCallData, EndCallPayLoadData, EndCallPayload, ErrorResponse, FollowUpType, HookStateTypes, InitSDKParams, LiveStatusPageProps, LogoutFunction, LogoutHookStateTypes, LogoutPayload, ProcessData, SDKAccessDeniedProps, SDKBit, SDKConfig, SDKEntitlement, SDKEntitlements, SDKInitResult, SDKPermissionContextValue, SDKPermissionGuardProps, SDKPermissionState, SDKPermissionsHook, SDKState, StartCallPayload, StartCalltData, StartCalltHookStateTypes, StartMonitoringPayload, StopMonitoringPayload, StorageType, SupervisorMonitorMode, URLConfig, UseCallMonitoringReturn, UseClickToCallReturn, UseClickToConferenceReturn, UseEndCallReturn, UseLogoutReturn }
+export { CallControlPanel, SDKAccessDenied, SDKPages, SDKPermissionGuard, SDKStateManager, SDK_MENU_CODES, SDK_PERMISSIONS, SDK_WILDCARD, changeMonitorMode, clickToCall, clickToConference, endCall, getSDKVersion, initSDK, isSDKInitialized, logout, sdkStateManager, setTransferLeadData, startMonitoring, stopMonitoring, useCallMonitoring, useClickToCall, useClickToConference, useEndCall, useGetAuthorizationToken, useGetCallerData, useLogout, useSDKPermissions, useSDKState };