ahs-cti 1.0.1-beta.2 → 1.0.1-beta.21

package/dist/index.d.mts

@@ -1,411 +1,413 @@
 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;
-	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;
-	convoxId?: string;
-	type?: string;
-	status: string;
-	agent_id: number;
-	phone_number?: string;
-	event_time?: string;
-	convox_id?: string;
-	process_id?: string;
-	process_name?: string;
-	mute?: number;
-	hold?: number;
-};
-
-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;
-	convox_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;
-
-	/**
-	 * 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}
- */
+/**
+ * @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;
+
+	/**
+	 * 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;
 
 /**
@@ -583,12 +585,22 @@ declare const CallControlPanel: React.ComponentType<CallControlPanelProps>;
  *
  * @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
+ * - `AgentPerformanceReport` - Agent Performance Report page component
+ * - `AgentDetailReport` - Agent Detail Report page component
  *
  * @since 1.0.0
  * @author CTI SDK Team
  */
 declare const SDKPages: {
 	readonly CallHistory: React.ComponentType<any>;
+	readonly Campaigns: React.ComponentType<any>;
+	readonly LoginReport: React.ComponentType<any>;
+	readonly CdrReports: React.ComponentType<any>;
+	readonly AgentPerformanceReport: React.ComponentType<any>;
+	readonly AgentDetailReport: React.ComponentType<any>;
 };
 
 // =============================================================================
@@ -620,6 +632,8 @@ interface CallData {
 	phone_number?: string;
 	process_id?: string;
 	process_name?: string;
+	/** Raw socket/state call data — full unprocessed snapshot from the SDK state manager */
+	socket_info?: any;
 }
 
 /**
@@ -645,6 +659,7 @@ interface CallData {
  */
 interface SDKConfig {
 	disableEndCallButton?: boolean;
+	disableEndConference?: boolean;
 	disabledDialButton?: boolean;
 	enableSmsServices?: boolean;
 	enableQueueName?: boolean;
@@ -665,7 +680,7 @@ interface URLConfig {
 	password: string;
 	webSocketURL: string;
 	coreBaseURL: string;
-	accessToken: string;
+	accessToken?: string;
 }
 
 /**
@@ -708,126 +723,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;
 }
 
 /**
@@ -1142,7 +1095,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
@@ -1154,7 +1107,7 @@ interface EndCallPayLoadData {
 	 * @description Unique identifier for the call
 	 * @type {string}
 	 */
-	convox_id: string;
+	call_id: string;
 
 	/**
 	 * 📱 Customer phone number
@@ -1718,13 +1671,17 @@ interface StartCallPayload {
 	/** Optional auto-answer flag; defaults to false when omitted. */
 	auto_answer?: boolean;
 	/** Optional Convox call id passthrough. */
-	convox_id?: string;
+	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 {
@@ -2237,16 +2194,6 @@ interface ErrorResponse {
 // ⚡ FRAMEWORK-AGNOSTIC ACTION EXPORTS (for Angular / non-React consumers)
 // =============================================================================
 
-interface EndCallOptions {
-  disposition?: string;
-  followUp?: string;
-  callbackDate?: string;
-  callbackHrs?: string;
-  callbackMins?: string;
-  isBreak?: boolean;
-  patientLog?: any;
-}
-
 type SupervisorMonitorMode = "listen" | "whisper" | "barge";
 
 interface StartMonitoringPayload {
@@ -2269,7 +2216,7 @@ interface ChangeModePayload {
 
 declare function clickToCall(payload: StartCallPayload): Promise<any>;
 declare function clickToConference(payload: ConferenceCallPayload): Promise<any>;
-declare function endCall(options?: EndCallOptions): 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>;
@@ -2288,6 +2235,162 @@ interface UseClickToConferenceReturn {
   data: any;
 }
 
-declare function useClickToConference(): UseClickToConferenceReturn;
+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";
+};
+
+/** 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 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";
+};
+
+// ─── 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 ChangeModePayload, type CleanupOperation, type ConferenceCallPayload, type ConferenceLine, type DispositionType, type EndCallData, type EndCallOptions, type EndCallPayLoadData, type EndCallPayload, type ErrorResponse, type FollowUpType, type HookStateTypes, type InitSDKParams, type LogoutFunction, type LogoutHookStateTypes, type LogoutPayload, type ProcessData, type SDKConfig, SDKPages, type SDKState, SDKStateManager, type StartCallPayload, type StartCalltData, type StartCalltHookStateTypes, type StartMonitoringPayload, type StopMonitoringPayload, type StorageType, type SupervisorMonitorMode, type URLConfig, type UseClickToCallReturn, type UseClickToConferenceReturn, type UseEndCallReturn, type UseLogoutReturn, changeMonitorMode, clickToCall, clickToConference, endCall, getSDKVersion, initSDK, isSDKInitialized, logout, sdkStateManager, startMonitoring, stopMonitoring, useClickToCall, useClickToConference, useEndCall, useGetAuthorizationToken, useGetCallerData, useLogout };
+export { type APIResponse, type AgentStatus, CallControlPanel, type CallControlPanelProps, type CallData, type CallInitiationFunction, type CallTerminationFunction, type ChangeModePayload, type CleanupOperation, type ConferenceCallPayload, type ConferenceLine, type ControlsFromPermissions, type DispositionType, type EndCallData, type EndCallPayLoadData, type EndCallPayload, type ErrorResponse, type FollowUpType, type HookStateTypes, type InitSDKParams, type LogoutFunction, type LogoutHookStateTypes, type LogoutPayload, type ProcessData, SDKAccessDenied, type SDKAccessDeniedProps, type SDKBit, type SDKConfig, type SDKEntitlement, type SDKEntitlements, SDKPages, type SDKPermissionContextValue, SDKPermissionGuard, type SDKPermissionGuardProps, type SDKPermissionState, type SDKPermissionsHook, type SDKState, SDKStateManager, SDK_MENU_CODES, SDK_PERMISSIONS, SDK_WILDCARD, type StartCallPayload, type StartCalltData, type StartCalltHookStateTypes, type StartMonitoringPayload, type StopMonitoringPayload, type StorageType, type SupervisorMonitorMode, type URLConfig, type UseCallMonitoringReturn, type UseClickToCallReturn, type UseClickToConferenceReturn, type UseEndCallReturn, type UseLogoutReturn, changeMonitorMode, clickToCall, clickToConference, endCall, getSDKVersion, initSDK, isSDKInitialized, logout, sdkStateManager, startMonitoring, stopMonitoring, useCallMonitoring, useClickToCall, useClickToConference, useEndCall, useGetAuthorizationToken, useGetCallerData, useLogout, useSDKPermissions, useSDKState };