@webex/contact-center 3.12.0-next.12 → 3.12.0-next.121

package/dist/types/services/UserPreference.d.ts

@@ -0,0 +1,118 @@
+import { WebexSDK } from '../types';
+import type { UserPreference as UserPreferenceResponse, CreateUserPreferenceRequest, UpdateUserPreferenceRequest, GetUserPreferenceParams } from './config/types';
+/**
+ * UserPreference API class for managing Webex Contact Center user preferences.
+ * Provides functionality to get, create, update, and delete user preferences.
+ *
+ * @class UserPreference
+ * @public
+ * @example
+ * ```typescript
+ * import Webex from 'webex';
+ *
+ * const webex = new Webex({ credentials: 'YOUR_ACCESS_TOKEN' });
+ * const cc = webex.cc;
+ *
+ * // Register and login first
+ * await cc.register();
+ * await cc.stationLogin({ teamId: 'team123', loginOption: 'BROWSER' });
+ *
+ * // Get UserPreference API instance from ContactCenter
+ * const userPreferenceAPI = cc.userPreference;
+ *
+ * // Get user preferences for the current user
+ * const preferences = await userPreferenceAPI.getUserPreference();
+ *
+ * // Create new user preferences
+ * const newPreferences = await userPreferenceAPI.createUserPreference({
+ *   userId: 'user123',
+ *   preferences: { e911Reminder: true }
+ * });
+ *
+ * // Update user preferences
+ * const updatedPreferences = await userPreferenceAPI.updateUserPreference('user123', {
+ *   preferences: { e911Reminder: false }
+ * });
+ *
+ * // Delete user preferences
+ * await userPreferenceAPI.deleteUserPreference('user123');
+ * ```
+ */
+export declare class UserPreference {
+    private webexRequest;
+    private webex;
+    private getUserId;
+    private metricsManager;
+    /**
+     * Creates an instance of UserPreference
+     * @param {WebexSDK} webex - The Webex SDK instance
+     * @param {() => string} getUserId - Function to get the current user's CI user ID
+     * @public
+     */
+    constructor(webex: WebexSDK, getUserId: () => string);
+    /**
+     * Fetches user preferences for a specific user
+     * @param {GetUserPreferenceParams} [params] - Optional parameters for fetching preferences
+     * @param {string} [params.userId] - User ID to fetch preferences for. Defaults to current user's CI user ID.
+     * @param {number} [params.page=0] - Page number (0-indexed). Default: 0
+     * @param {number} [params.pageSize=100] - Number of items per page. Default: 100
+     * @returns {Promise<UserPreferenceResponse>} Promise resolving to user preferences
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * // Get preferences for current user
+     * const preferences = await userPreferenceAPI.getUserPreference();
+     *
+     * // Get preferences for a specific user
+     * const preferences = await userPreferenceAPI.getUserPreference({ userId: 'user123' });
+     *
+     * // Get preferences with pagination
+     * const preferences = await userPreferenceAPI.getUserPreference({ page: 0, pageSize: 50 });
+     * ```
+     */
+    getUserPreference(params?: GetUserPreferenceParams): Promise<UserPreferenceResponse>;
+    /**
+     * Creates new user preferences
+     * @param {CreateUserPreferenceRequest} data - The user preference data to create
+     * @returns {Promise<UserPreference>} Promise resolving to created user preferences
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * const newPreferences = await userPreferenceAPI.createUserPreference({
+     *   userId: 'user123',
+     *   preferences: { e911Reminder: true, notificationSettings: { email: true } }
+     * });
+     * ```
+     */
+    createUserPreference(data: CreateUserPreferenceRequest): Promise<UserPreferenceResponse>;
+    /**
+     * Updates existing user preferences
+     * @param {string} userId - User ID to update preferences for
+     * @param {UpdateUserPreferenceRequest} data - The user preference data to update
+     * @returns {Promise<UserPreference>} Promise resolving to updated user preferences
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * const updatedPreferences = await userPreferenceAPI.updateUserPreference('user123', {
+     *   preferences: { e911Reminder: false }
+     * });
+     * ```
+     */
+    updateUserPreference(userId: string, data: UpdateUserPreferenceRequest): Promise<UserPreferenceResponse>;
+    /**
+     * Deletes user preferences for a specific user
+     * @param {string} userId - User ID to delete preferences for
+     * @returns {Promise<void>} Promise resolving when deletion is complete
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * await userPreferenceAPI.deleteUserPreference('user123');
+     * ```
+     */
+    deleteUserPreference(userId: string): Promise<void>;
+}
+export default UserPreference;

package/dist/types/services/WebexCrossClientService.d.ts

@@ -0,0 +1,32 @@
+import { WebexSDK } from '../types';
+/**
+ * Publishes usersub cross-client state so Webex App suppresses native calling toasts (WXCC-6026).
+ */
+export default class WebexCrossClientService {
+    private webex;
+    private refreshTimer?;
+    private refreshRetryTimer?;
+    private answerCallsState;
+    private appName;
+    /** Incremented on teardown/disable to ignore stale refresh timer callbacks. */
+    private refreshGeneration;
+    /** Monotonic id for usersub publish metrics timers; stale publishes cancel only their own timer. */
+    private usersubPublishMetricsId;
+    constructor(webex: WebexSDK);
+    private extractDeviceIdFromUrl;
+    private getDeviceUrl;
+    private clearRefreshTimer;
+    private scheduleRefreshRetry;
+    private startRefreshTimer;
+    private publishCrossClientState;
+    setManageWebexCallingInWxcc(enable: boolean, options?: {
+        userId?: string;
+        ttl?: number;
+        appName?: string;
+        trackPublishMetrics?: boolean;
+    }): Promise<void>;
+    private trackUsersubPreflightFailure;
+    teardown(): void;
+    /** Whether usersub `answer-calls-on-wxcc: true` was successfully published this session. */
+    isAnswerCallsStateActive(): boolean;
+}

package/dist/types/services/WxAppTelephonyMercurySync.d.ts

@@ -0,0 +1,28 @@
+import { WebexSDK } from '../types';
+export declare const TELEPHONY_CALL_MUTED = "event:telephony_calls.muted";
+export declare const TELEPHONY_CALL_UNMUTED = "event:telephony_calls.unmuted";
+export type UpdatedCallMuteStateEvent = {
+    data: {
+        actorId: string;
+        callId: string;
+        muted: boolean;
+    };
+};
+type MuteChangeHandler = (callId: string, muted: boolean) => void;
+/**
+ * Subscribes to Mercury telephony mute/unmute events for wxApp thick-client sync (AD parity).
+ */
+export default class WxAppTelephonyMercurySync {
+    private webex;
+    private subscribedAgentId?;
+    private muteChangeHandler?;
+    private boundMuteHandler?;
+    private boundUnmuteHandler?;
+    constructor(webex: WebexSDK);
+    private decodeBase64;
+    private handleMuteStateEvent;
+    subscribe(agentId: string, onMuteChange: MuteChangeHandler): void;
+    unsubscribe(): void;
+    isSubscribed(): boolean;
+}
+export {};

package/dist/types/services/config/constants.d.ts

@@ -1,4 +1,10 @@
 export declare const DEFAULT_PAGE = 0;
+/** Desktop Profile access levels for collaboration destination categories. */
+export declare const COLLABORATION_ACCESS: {
+    readonly ALL: "ALL";
+    readonly SPECIFIC: "SPECIFIC";
+    readonly NONE: "NONE";
+};
 /**
  * Default page size for paginated API requests.
  * @type {number}
@@ -212,16 +218,13 @@ export declare const endPointMap: {
      */
     queueList: (orgId: string, queryParams: string) => string;
     /**
-     * Gets the endpoint for entry points list with custom query parameters.
+     * Gets the desktop-profile-filtered dial-number mappings used by entry-point destination lists.
      * @param orgId - Organization ID.
      * @param queryParams - Query parameters string.
      * @returns The endpoint URL string.
-     * @public
-     * @example
-     * const url = endPointMap.entryPointList('org123', 'page=0&pageSize=10');
      * @ignore
      */
-    entryPointList: (orgId: string, queryParams: string) => string;
+    entryPointDialNumberList: (orgId: string, queryParams: string) => string;
     /**
      * Gets the endpoint for address book entries with custom query parameters.
      * @param orgId - Organization ID.
@@ -246,4 +249,25 @@ export declare const endPointMap: {
      * @ignore
      */
     outdialAniEntries: (orgId: string, outdialANI: string, queryParams: string) => string;
+    /**
+     * Gets the endpoint for user preference by user ID.
+     * @param orgId - Organization ID.
+     * @param userId - User ID.
+     * @returns The endpoint URL string.
+     * @public
+     * @example
+     * const url = endPointMap.userPreference('org123', 'user456');
+     * @ignore
+     */
+    userPreference: (orgId: string, userId: string) => string;
+    /**
+     * Gets the endpoint for creating user preference.
+     * @param orgId - Organization ID.
+     * @returns The endpoint URL string.
+     * @public
+     * @example
+     * const url = endPointMap.userPreferenceCreate('org123');
+     * @ignore
+     */
+    userPreferenceCreate: (orgId: string) => string;
 };

package/dist/types/services/config/types.d.ts

@@ -1,4 +1,7 @@
 import * as Agent from '../agent/types';
+import { COLLABORATION_ACCESS } from './constants';
+/** Desktop Profile access level for a collaboration destination category. */
+export type CollaborationAccess = Enum<typeof COLLABORATION_ACCESS>;
 /**
  * Events emitted on task objects
  * @enum {string}
@@ -50,6 +53,8 @@ export declare const CC_TASK_EVENTS: {
     readonly PARTICIPANT_LEFT_CONFERENCE: "ParticipantLeftConference";
     /** Event emitted when participant leaving conference fails */
     readonly PARTICIPANT_LEFT_CONFERENCE_FAILED: "ParticipantLeftConferenceFailed";
+    /** Event emitted when dropping another conference participant fails */
+    readonly PARTICIPANT_DROP_CONFERENCE_FAILED: "ParticipantDropConferenceFailed";
     /** Event emitted when consultation conference end fails */
     readonly AGENT_CONSULT_CONFERENCE_END_FAILED: "AgentConsultConferenceEndFailed";
     /** Event emitted when conference is successfully transferred */
@@ -58,6 +63,8 @@ export declare const CC_TASK_EVENTS: {
     readonly AGENT_CONFERENCE_TRANSFER_FAILED: "AgentConferenceTransferFailed";
     /** Event emitted for post-call activity by participant */
     readonly PARTICIPANT_POST_CALL_ACTIVITY: "ParticipantPostCallActivity";
+    /** Event emitted when consulted participant is being moved/transferred */
+    readonly CONSULTED_PARTICIPANT_MOVING: "ConsultedParticipantMoving";
     /** Event emitted when contact is blind transferred */
     readonly AGENT_BLIND_TRANSFERRED: "AgentBlindTransferred";
     /** Event emitted when blind transfer fails */
@@ -74,6 +81,8 @@ export declare const CC_TASK_EVENTS: {
     readonly AGENT_CONSULT_TRANSFER_FAILED: "AgentConsultTransferFailed";
     /** Event emitted when contact recording is paused */
     readonly CONTACT_RECORDING_PAUSED: "ContactRecordingPaused";
+    /** Event emitted when contact recording is started */
+    readonly CONTACT_RECORDING_STARTED: "ContactRecordingStarted";
     /** Event emitted when pausing contact recording fails */
     readonly CONTACT_RECORDING_PAUSE_FAILED: "ContactRecordingPauseFailed";
     /** Event emitted when contact recording is resumed */
@@ -84,6 +93,10 @@ export declare const CC_TASK_EVENTS: {
     readonly CONTACT_ENDED: "ContactEnded";
     /** Event emitted when contact is merged */
     readonly CONTACT_MERGED: "ContactMerged";
+    /** Event emitted when contact payload is updated (routing updates) */
+    readonly CONTACT_UPDATED: "ContactUpdated";
+    /** Event emitted when contact owner changes */
+    readonly CONTACT_OWNER_CHANGED: "ContactOwnerChanged";
     /** Event emitted when ending contact fails */
     readonly AGENT_CONTACT_END_FAILED: "AgentContactEndFailed";
     /** Event emitted when agent enters wrap-up state */
@@ -110,8 +123,20 @@ export declare const CC_TASK_EVENTS: {
     readonly CAMPAIGN_CONTACT_UPDATED: "CampaignContactUpdated";
     /** Event emitted when accepting a campaign preview contact fails */
     readonly CAMPAIGN_PREVIEW_ACCEPT_FAILED: "CampaignPreviewAcceptFailed";
+    /** Event emitted when skipping a campaign preview contact fails */
+    readonly CAMPAIGN_PREVIEW_SKIP_FAILED: "CampaignPreviewSkipFailed";
+    /** Event emitted when removing a campaign preview contact fails */
+    readonly CAMPAIGN_PREVIEW_REMOVE_FAILED: "CampaignPreviewRemoveFailed";
     /** Event emitted when a real-time transcript chunk is received */
     readonly REAL_TIME_TRANSCRIPTION: "REAL_TIME_TRANSCRIPTION";
+    /** Event emitted when an AI assistant suggested response is available */
+    readonly SUGGESTED_RESPONSE: "SUGGESTED_RESPONSE";
+    /** Event emitted when backend acknowledges it is listening for more context */
+    readonly SUGGESTED_RESPONSE_ACKNOWLEDGE: "SUGGESTED_RESPONSE_ACKNOWLEDGE";
+    /** Event emitted when a mid-call summary is available */
+    readonly MID_CALL_SUMMARY: "MID_CALL_SUMMARY";
+    /** Event emitted when a post-call summary is available */
+    readonly POST_CALL_SUMMARY: "POST_CALL_SUMMARY";
 };
 /**
  * Events emitted on Contact Center agent operations
@@ -207,6 +232,8 @@ export declare const CC_EVENTS: {
     readonly PARTICIPANT_LEFT_CONFERENCE: "ParticipantLeftConference";
     /** Event emitted when participant leaving conference fails */
     readonly PARTICIPANT_LEFT_CONFERENCE_FAILED: "ParticipantLeftConferenceFailed";
+    /** Event emitted when dropping another conference participant fails */
+    readonly PARTICIPANT_DROP_CONFERENCE_FAILED: "ParticipantDropConferenceFailed";
     /** Event emitted when consultation conference end fails */
     readonly AGENT_CONSULT_CONFERENCE_END_FAILED: "AgentConsultConferenceEndFailed";
     /** Event emitted when conference is successfully transferred */
@@ -215,6 +242,8 @@ export declare const CC_EVENTS: {
     readonly AGENT_CONFERENCE_TRANSFER_FAILED: "AgentConferenceTransferFailed";
     /** Event emitted for post-call activity by participant */
     readonly PARTICIPANT_POST_CALL_ACTIVITY: "ParticipantPostCallActivity";
+    /** Event emitted when consulted participant is being moved/transferred */
+    readonly CONSULTED_PARTICIPANT_MOVING: "ConsultedParticipantMoving";
     /** Event emitted when contact is blind transferred */
     readonly AGENT_BLIND_TRANSFERRED: "AgentBlindTransferred";
     /** Event emitted when blind transfer fails */
@@ -231,6 +260,8 @@ export declare const CC_EVENTS: {
     readonly AGENT_CONSULT_TRANSFER_FAILED: "AgentConsultTransferFailed";
     /** Event emitted when contact recording is paused */
     readonly CONTACT_RECORDING_PAUSED: "ContactRecordingPaused";
+    /** Event emitted when contact recording is started */
+    readonly CONTACT_RECORDING_STARTED: "ContactRecordingStarted";
     /** Event emitted when pausing contact recording fails */
     readonly CONTACT_RECORDING_PAUSE_FAILED: "ContactRecordingPauseFailed";
     /** Event emitted when contact recording is resumed */
@@ -241,6 +272,10 @@ export declare const CC_EVENTS: {
     readonly CONTACT_ENDED: "ContactEnded";
     /** Event emitted when contact is merged */
     readonly CONTACT_MERGED: "ContactMerged";
+    /** Event emitted when contact payload is updated (routing updates) */
+    readonly CONTACT_UPDATED: "ContactUpdated";
+    /** Event emitted when contact owner changes */
+    readonly CONTACT_OWNER_CHANGED: "ContactOwnerChanged";
     /** Event emitted when ending contact fails */
     readonly AGENT_CONTACT_END_FAILED: "AgentContactEndFailed";
     /** Event emitted when agent enters wrap-up state */
@@ -267,8 +302,20 @@ export declare const CC_EVENTS: {
     readonly CAMPAIGN_CONTACT_UPDATED: "CampaignContactUpdated";
     /** Event emitted when accepting a campaign preview contact fails */
     readonly CAMPAIGN_PREVIEW_ACCEPT_FAILED: "CampaignPreviewAcceptFailed";
+    /** Event emitted when skipping a campaign preview contact fails */
+    readonly CAMPAIGN_PREVIEW_SKIP_FAILED: "CampaignPreviewSkipFailed";
+    /** Event emitted when removing a campaign preview contact fails */
+    readonly CAMPAIGN_PREVIEW_REMOVE_FAILED: "CampaignPreviewRemoveFailed";
     /** Event emitted when a real-time transcript chunk is received */
     readonly REAL_TIME_TRANSCRIPTION: "REAL_TIME_TRANSCRIPTION";
+    /** Event emitted when an AI assistant suggested response is available */
+    readonly SUGGESTED_RESPONSE: "SUGGESTED_RESPONSE";
+    /** Event emitted when backend acknowledges it is listening for more context */
+    readonly SUGGESTED_RESPONSE_ACKNOWLEDGE: "SUGGESTED_RESPONSE_ACKNOWLEDGE";
+    /** Event emitted when a mid-call summary is available */
+    readonly MID_CALL_SUMMARY: "MID_CALL_SUMMARY";
+    /** Event emitted when a post-call summary is available */
+    readonly POST_CALL_SUMMARY: "POST_CALL_SUMMARY";
     /** Welcome event when agent connects to websocket/backend */
     readonly WELCOME: "Welcome";
     /** Event emitted when agent re-login is successful */
@@ -314,6 +361,14 @@ export type WelcomeEvent = {
     /** ID of the agent that connected */
     agentId: string;
 };
+/**
+ * Available login options for voice channel access
+ * 'AGENT_DN' - Login using agent's DN
+ * 'EXTENSION' - Login using extension number
+ * 'BROWSER' - Login using browser-based WebRTC
+ * @public
+ */
+export type LoginOption = 'AGENT_DN' | 'EXTENSION' | 'BROWSER';
 /**
  * Response type for welcome events which can be either success or error
  * @public
@@ -384,13 +439,34 @@ export type AgentResponse = {
     dbId?: string;
     /**
      * The default dialed number of the agent.
+     * Note: The API returns this field as "deafultDialledNumber" (with typo).
      */
-    defaultDialledNumber?: string;
+    deafultDialledNumber?: string;
 };
 /**
  * Represents the response from getDesktopProfileById method.
  */
 export type DesktopProfileResponse = {
+    /**
+     * Unique identifier of the agent profile configuration.
+     */
+    id: string;
+    /**
+     * Display name for the agent profile.
+     */
+    name: string;
+    /**
+     * Description of the agent profile.
+     */
+    description: string;
+    /**
+     * Parent entity type for the profile (for example ORGANIZATION).
+     */
+    parentType: string;
+    /**
+     * Indicates whether screen pop is enabled.
+     */
+    screenPopup: boolean;
     /**
      * Represents the voice options of an agent.
      */
@@ -423,6 +499,10 @@ export type DesktopProfileResponse = {
      * Auto wrap-up allowed.
      */
     autoWrapUp: boolean;
+    /**
+     * Whether the agent personal greeting is enabled.
+     */
+    agentPersonalGreeting: boolean;
     /**
      * Auto answer allowed.
      */
@@ -439,6 +519,30 @@ export type DesktopProfileResponse = {
      * Allow auto wrap-up extension.
      */
     allowAutoWrapUpExtension: boolean;
+    /**
+     * Access control for queues assigned to the agent (ALL, SPECIFIC, or NONE).
+     */
+    accessQueue: CollaborationAccess;
+    /**
+     * Queue identifiers available to the agent when access is SPECIFIC.
+     */
+    queues: string[];
+    /**
+     * Access control for entry points assigned to the agent.
+     */
+    accessEntryPoint: CollaborationAccess;
+    /**
+     * Entry point identifiers available to the agent when access is SPECIFIC.
+     */
+    entryPoints: string[];
+    /**
+     * Access control for buddy teams assigned to the agent.
+     */
+    accessBuddyTeam: CollaborationAccess;
+    /**
+     * Buddy team identifiers available to the agent when access is SPECIFIC.
+     */
+    buddyTeams: string[];
     /**
      * Outdial enabled for the agent.
      */
@@ -475,6 +579,10 @@ export type DesktopProfileResponse = {
      * Agent DN validation of the agent.
      */
     agentDNValidation: string;
+    /**
+     * Additional DN validation criteria configured for the agent.
+     */
+    agentDNValidationCriterions: string[];
     /**
      * Dial plans of the agent.
      */
@@ -503,6 +611,26 @@ export type DesktopProfileResponse = {
      * State synchronization in Webex enabled or not.
      */
     stateSynchronizationWebex: boolean;
+    /**
+     * Threshold rules configured for the agent profile.
+     */
+    thresholdRules: Array<Record<string, string | number>>;
+    /**
+     * Whether the agent profile is currently active.
+     */
+    active: boolean;
+    /**
+     * Whether this profile is the system default.
+     */
+    systemDefault: boolean;
+    /**
+     * Timestamp when the profile was created.
+     */
+    createdTime: number;
+    /**
+     * Timestamp when the profile was last updated.
+     */
+    lastUpdatedTime: number;
 };
 /**
  * Response containing multimedia profile configuration for an agent
@@ -898,14 +1026,6 @@ export type WrapupData = {
         allowCancelAutoWrapup?: boolean;
     };
 };
-/**
- * Available login options for voice channel access
- * 'AGENT_DN' - Login using agent's DN
- * 'EXTENSION' - Login using extension number
- * 'BROWSER' - Login using browser-based WebRTC
- * @public
- */
-export type LoginOption = 'AGENT_DN' | 'EXTENSION' | 'BROWSER';
 /**
  * Team configuration information
  * @public
@@ -1073,7 +1193,7 @@ export type Profile = {
     /** Outbound entry point */
     outDialEp: string;
     /** Whether ending calls is enabled */
-    isEndCallEnabled: boolean;
+    isEndTaskEnabled: boolean;
     /** Whether ending consultations is enabled */
     isEndConsultEnabled: boolean;
     /** Optional lifecycle manager URL */
@@ -1084,6 +1204,12 @@ export type Profile = {
     agentAnalyzerId?: string;
     /** Whether consult to queue is allowed */
     allowConsultToQueue: boolean;
+    /** Access control for queues on Desktop Profile Collaboration tab */
+    accessQueue?: CollaborationAccess;
+    /** Access control for entry points on Desktop Profile Collaboration tab */
+    accessEntryPoint?: CollaborationAccess;
+    /** Access control for buddy teams on Desktop Profile Collaboration tab */
+    accessBuddyTeam?: CollaborationAccess;
     /** Additional campaign manager information */
     campaignManagerAdditionalInfo?: string;
     /** Whether personal statistics are enabled */
@@ -1205,3 +1331,51 @@ export type OutdialAniParams = {
     /** Comma-separated list of attributes to include in response (optional) */
     attributes?: string;
 };
+/**
+ * User preference data structure
+ * @public
+ */
+export type UserPreference = {
+    /** Unique identifier for the user preference */
+    id: string;
+    /** Organization ID */
+    organizationId: string;
+    /** User ID (CI user ID) */
+    userId: string;
+    /** User preference data as key-value pairs */
+    preferences: Record<string, unknown>;
+    /** Timestamp when this preference was created (Unix timestamp in milliseconds) */
+    createdTime?: number;
+    /** Timestamp when this preference was last updated (Unix timestamp in milliseconds) */
+    lastUpdatedTime?: number;
+};
+/**
+ * Request payload for creating user preferences
+ * @public
+ */
+export type CreateUserPreferenceRequest = {
+    /** User ID (CI user ID) */
+    userId: string;
+    /** Desktop preference data as a JSON string (required) */
+    desktopPreference: string;
+};
+/**
+ * Request payload for updating user preferences
+ * @public
+ */
+export type UpdateUserPreferenceRequest = {
+    /** Desktop preference data as a JSON string (required) */
+    desktopPreference: string;
+};
+/**
+ * Query parameters for fetching user preferences
+ * @public
+ */
+export type GetUserPreferenceParams = {
+    /** User ID to fetch preferences for. Defaults to current user's CI user ID. */
+    userId?: string;
+    /** Page number (0-indexed). Default: 0 */
+    page?: number;
+    /** Number of items per page. Default: 100 */
+    pageSize?: number;
+};

package/dist/types/services/core/Err.d.ts

@@ -49,6 +49,8 @@ export type TaskErrorIds = {
     'Service.aqm.task.consultAccept': Failure;
 } | {
     'Service.aqm.task.consultConference': Failure;
+} | {
+    'Service.aqm.task.dropConferenceParticipant': Failure;
 } | {
     'Service.aqm.task.consultEnd': Failure;
 } | {
@@ -67,6 +69,10 @@ export type TaskErrorIds = {
     'Service.aqm.dialer.startOutdial': Failure;
 } | {
     'Service.aqm.dialer.acceptPreviewContact': Failure;
+} | {
+    'Service.aqm.dialer.skipPreviewContact': Failure;
+} | {
+    'Service.aqm.dialer.removePreviewContact': Failure;
 } | {
     'Service.reqs.generic.failure': {
         trackingId: string;

package/dist/types/services/core/Utils.d.ts

@@ -1,17 +1,24 @@
 import * as Err from './Err';
 import { LoginOption, WebexRequestPayload } from '../../types';
 import { Failure, AugmentedError } from './GlobalTypes';
-import { TaskData, ConsultTransferPayLoad, Interaction } from '../task/types';
+import { ConsultConferenceData, consultConferencePayloadData, ConsultTransferDestinationType, TaskData, Interaction } from '../task/types';
 import { DialPlan } from '../config/types';
-export declare const FALLBACK_DIAL_NUMBER_REGEX: RegExp;
+/**
+ * Strips characters defined in the dial plan entry from the input string.
+ *
+ * @param input - The dial number to sanitize
+ * @param strippedChars - String of characters to remove from the input
+ * @returns The sanitized input with specified characters removed
+ */
+export declare const stripDialPlanChars: (input: string, strippedChars: string) => string;
 /**
  * Validates a dial number against the provided dial plan regex patterns.
  * A number is valid if it matches at least one regex pattern in the dial plans.
- * Falls back to US/Canada regex validation if no dial plan entries are configured.
+ * Skips validation when no dial plan entries are configured, deferring to the server.
  *
  * @param input - The dial number to validate
  * @param dialPlanEntries - Array of dial plan entries containing regex patterns
- * @returns true if the input matches at least one dial plan regex pattern, false otherwise
+ * @returns true if the input matches at least one dial plan regex pattern or no entries are configured, false otherwise
  */
 export declare const isValidDialNumber: (input: string, dialPlanEntries: DialPlan['dialPlanEntity']) => boolean;
 export declare const getStationLoginErrorData: (failure: Failure, loginOption: LoginOption) => {
@@ -61,14 +68,6 @@ export declare const generateTaskErrorObject: (error: any, methodName: string, m
  * @ignore
  */
 export declare const createErrDetailsObject: (errObj: WebexRequestPayload) => Err.Details<"Service.reqs.generic.failure">;
-/**
- * Gets the consulted agent ID from the media object by finding the agent
- * in the consult media participants (excluding the current agent).
- *
- * @param media - The media object from the interaction
- * @param agentId - The current agent's ID to exclude from the search
- * @returns The consulted agent ID, or empty string if none found
- */
 export declare const getConsultedAgentId: (media: Interaction['media'], agentId: string) => string;
 /**
  * Gets the destination agent ID for CBT (Capacity Based Team) scenarios.
@@ -98,4 +97,25 @@ export declare const calculateDestAgentId: (interaction: Interaction, agentId: s
  * @returns The destination agent ID for determining destination type
  */
 export declare const calculateDestType: (interaction: Interaction, agentId: string) => string;
-export declare const deriveConsultTransferDestinationType: (taskData?: TaskData) => ConsultTransferPayLoad['destinationType'];
+/**
+ * Gets the destination agent ID from participants.
+ * Finds a participant who is not the current agent and is an agent type.
+ *
+ * @param participants - The participants object from interaction
+ * @param agentId - The current agent's ID
+ * @returns The destination agent ID, or undefined if none found
+ */
+export declare const buildConsultConferenceParamData: (dataPassed: consultConferencePayloadData, interactionIdPassed: string) => {
+    interactionId: string;
+    data: ConsultConferenceData;
+};
+/**
+ * Derives the consult transfer destination type based on task data.
+ * This function determines the appropriate destination type for a consult transfer
+ * by examining the destination type stored in the task data.
+ *
+ * @param taskData - The task data containing destination information
+ * @returns The derived consult transfer destination type
+ * @public
+ */
+export declare const deriveConsultTransferDestinationType: (taskData: TaskData) => ConsultTransferDestinationType;

package/dist/types/services/core/WebexRequest.d.ts

@@ -11,6 +11,7 @@ declare class WebexRequest {
         resource: string;
         method: HTTP_METHODS;
         body?: RequestBody;
+        headers?: Record<string, string | null>;
     }): Promise<IHttpResponse>;
     /**
      * This is used for uploading the logs to backend/mats.