@webex/cc-task 1.28.0-ccwidgets.99 → 1.28.0-next.10

package/dist/types/OutdialCall/index.d.ts

@@ -1,3 +1,4 @@
 import React from 'react';
-declare const OutdialCall: React.FunctionComponent;
+import { OutdialProps } from '../task.types';
+declare const OutdialCall: React.FunctionComponent<OutdialProps>;
 export { OutdialCall };

package/dist/types/Utils/constants.d.ts

@@ -0,0 +1,15 @@
+export declare const MEDIA_TYPE_TELEPHONY = "telephony";
+export declare const MEDIA_TYPE_CHAT = "chat";
+export declare const MEDIA_TYPE_EMAIL = "email";
+export declare const MAX_PARTICIPANTS_IN_MULTIPARTY_CONFERENCE = 7;
+export declare enum DestinationAgentType {
+    EP_DN = "EpDn",
+    EPDN = "EPDN",
+    ENTRY_POINT = "EntryPoint",
+    EP = "EP"
+}
+export declare const TIMER_LABEL_WRAP_UP = "Wrap Up";
+export declare const TIMER_LABEL_POST_CALL = "Post Call";
+export declare const TIMER_LABEL_CONSULT_ON_HOLD = "Consult on Hold";
+export declare const TIMER_LABEL_CONSULT_REQUESTED = "Consult Requested";
+export declare const TIMER_LABEL_CONSULTING = "Consulting";

package/dist/types/Utils/task-util.d.ts

@@ -1,23 +1,125 @@
-import { ITask } from '@webex/plugin-cc';
+import { ILogger } from '@webex/cc-store';
+import { ITask, Interaction } from '@webex/contact-center';
+import { Visibility } from '@webex/cc-components';
+export declare function findHoldTimestamp(interaction: Interaction, mType?: string): number | null;
+/**
+ * Get visibility for Accept button
+ */
+export declare function getAcceptButtonVisibility(isBrowser: boolean, isPhoneDevice: boolean, webRtcEnabled: boolean, isCall: boolean, isDigitalChannel: boolean): Visibility;
+/**
+ * Get visibility for Decline button
+ */
+export declare function getDeclineButtonVisibility(isBrowser: boolean, webRtcEnabled: boolean, isCall: boolean): Visibility;
+/**
+ * Get visibility for End button (matches Agent Desktop behavior)
+ */
+export declare function getEndButtonVisibility(isBrowser: boolean, isEndCallEnabled: boolean, isCall: boolean, isConsultInitiatedOrAcceptedOrBeingConsulted: boolean, isConferenceInProgress: boolean, isConsultCompleted: boolean, isHeld: boolean, consultCallHeld: boolean, task?: ITask, agentId?: string): Visibility;
+/**
+ * Get visibility for Mute/Unmute button
+ */
+export declare function getMuteUnmuteButtonVisibility(isBrowser: boolean, webRtcEnabled: boolean, isCall: boolean, isBeingConsulted: boolean): Visibility;
+/**
+ * Get visibility for Hold/Resume button
+ */
+export declare function getHoldResumeButtonVisibility(isTelephonySupported: boolean, isCall: boolean, isConferenceInProgress: boolean, isConsultInProgress: boolean, isHeld: boolean, isBeingConsulted: boolean, isConsultCompleted: boolean): Visibility;
+/**
+ * Get visibility for Pause/Resume Recording button
+ */
+export declare function getPauseResumeRecordingButtonVisibility(isTelephonySupported: boolean, isCall: boolean, isConferenceInProgress: boolean, isConsultInitiatedOrAccepted: boolean): Visibility;
+/**
+ * Get visibility for Recording Indicator
+ */
+export declare function getRecordingIndicatorVisibility(isCall: boolean): Visibility;
+/**
+ * Get visibility for Transfer button
+ */
+export declare function getTransferButtonVisibility(isTransferVisibility: boolean, isConferenceInProgress: boolean, isConsultInitiatedOrAccepted: boolean): Visibility;
+/**
+ * Get visibility for Conference button
+ */
+export declare function getConferenceButtonVisibility(isBrowser: boolean, webRtcEnabled: boolean, isCall: boolean, isChat: boolean, isBeingConsulted: boolean, conferenceEnabled: boolean): Visibility;
+/**
+ * Get visibility for Exit Conference button
+ */
+export declare function getExitConferenceButtonVisibility(isConferenceInProgress: boolean, isConsultInitiatedOrAccepted: boolean, consultCallHeld: boolean, isHeld: boolean, isConsultCompleted: boolean, conferenceEnabled: boolean): Visibility;
+/**
+ * Get visibility for Merge Conference button
+ */
+export declare function getMergeConferenceButtonVisibility(isConsultInitiatedOrAccepted: boolean, isConsultAccepted: boolean, consultCallHeld: boolean, isConferenceInProgress: boolean, isCustomerInCall: boolean, conferenceEnabled: boolean): Visibility;
+/**
+ * Get visibility for Consult button
+ */
+export declare function getConsultButtonVisibility(isTelephonySupported: boolean, isCall: boolean, isConsultInProgress: boolean, isCustomerInCall: boolean, conferenceParticipantsCount: number, maxParticipantsInConference: number, isBeingConsulted: boolean, isHeld: boolean, isConsultCompleted: boolean, isConferenceInProgress: boolean): Visibility;
+/**
+ * Get visibility for End Consult button
+ */
+export declare function getEndConsultButtonVisibility(isEndConsultEnabled: boolean, isTelephonySupported: boolean, isCall: boolean, isConsultInitiatedOrAccepted: boolean): Visibility;
+/**
+ * Get visibility for Consult Transfer button
+ */
+export declare function getConsultTransferButtonVisibility(isConsultInitiatedOrAccepted: boolean, isConsultAccepted: boolean, consultCallHeld: boolean, isConferenceInProgress: boolean, isCustomerInCall: boolean): Visibility;
+/**
+ * Get visibility for Merge Conference Consult button
+ */
+export declare function getMergeConferenceConsultButtonVisibility(isConsultAccepted: boolean, isConsultInitiated: boolean, consultCallHeld: boolean, isCustomerInCall: boolean, conferenceEnabled: boolean): Visibility;
+/**
+ * Get visibility for Consult Transfer Consult button
+ */
+export declare function getConsultTransferConsultButtonVisibility(isConsultAccepted: boolean, isConsultInitiated: boolean, consultCallHeld: boolean, isCustomerInCall: boolean): Visibility;
+/**
+ * Get visibility for Mute/Unmute Consult button
+ */
+export declare function getMuteUnmuteConsultButtonVisibility(isBrowser: boolean, webRtcEnabled: boolean, isCall: boolean, isConsultInitiated: boolean, isBeingConsulted: boolean): Visibility;
+/**
+ * Get visibility for Switch to Main Call button
+ */
+export declare function getSwitchToMainCallButtonVisibility(isBeingConsulted: boolean, isConsultAccepted: boolean, isConsultInitiated: boolean, consultCallHeld: boolean, isCustomerInCall: boolean, isConferenceInProgress: boolean): Visibility;
+/**
+ * Get visibility for Switch to Consult button
+ */
+export declare function getSwitchToConsultButtonVisibility(isBeingConsulted: boolean, consultCallHeld: boolean): Visibility;
+/**
+ * Get visibility for Wrapup button
+ */
+export declare function getWrapupButtonVisibility(task: ITask): Visibility;
 /**
  * This function determines the visibility of various controls based on the task's data.
+ * @param deviceType The device type (Browser, Extension, AgentDN)
+ * @param featureFlags Feature flags configuration object
  * @param task The task object
- * @returns An object containing the visibility of various controls based on the task's data
+ * @param agentId The agent ID
+ * @param conferenceEnabled Whether conference is enabled
+ * @param logger Optional logger instance
+ * @returns An object containing the visibility and state of various controls
  */
 export declare function getControlsVisibility(deviceType: string, featureFlags: {
     [key: string]: boolean;
-}, task: ITask): {
-    accept: boolean;
-    decline: boolean;
-    end: boolean;
-    muteUnmute: boolean;
-    holdResume: boolean;
-    consult: boolean;
-    transfer: boolean;
-    conference: boolean;
-    wrapup: boolean;
-    pauseResumeRecording: boolean;
-    endConsult: boolean;
-    recordingIndicator: boolean;
+}, task: ITask, agentId: string, conferenceEnabled: boolean, logger?: ILogger): {
+    accept: Visibility;
+    decline: Visibility;
+    end: Visibility;
+    muteUnmute: Visibility;
+    holdResume: Visibility;
+    pauseResumeRecording: Visibility;
+    recordingIndicator: Visibility;
+    transfer: Visibility;
+    conference: Visibility;
+    exitConference: Visibility;
+    mergeConference: Visibility;
+    consult: Visibility;
+    endConsult: Visibility;
+    consultTransfer: Visibility;
+    consultTransferConsult: Visibility;
+    mergeConferenceConsult: Visibility;
+    muteUnmuteConsult: Visibility;
+    switchToMainCall: Visibility;
+    switchToConsult: Visibility;
+    wrapup: Visibility;
+    isConferenceInProgress: boolean;
+    isConsultInitiated: boolean;
+    isConsultInitiatedAndAccepted: boolean;
+    isConsultReceived: boolean;
+    isConsultInitiatedOrAccepted: boolean;
+    isHeld: boolean;
+    consultCallHeld: boolean;
 };
-export declare function findHoldTimestamp(interaction: Interaction, mType?: string): number | null;

package/dist/types/Utils/timer-utils.d.ts

@@ -0,0 +1,29 @@
+import { ITask } from '@webex/cc-store';
+import { ControlVisibility } from '@webex/cc-components';
+/**
+ * Timer data structure containing label and timestamp
+ */
+export interface TimerData {
+    label: string | null;
+    timestamp: number;
+}
+/**
+ * Calculate state timer label and timestamp based on task state.
+ * Priority: Wrap Up > Post Call
+ *
+ * @param currentTask - The current task object
+ * @param controlVisibility - Control visibility flags
+ * @param agentId - The current agent ID
+ * @returns TimerData object with label and timestamp
+ */
+export declare function calculateStateTimerData(currentTask: ITask | null, controlVisibility: ControlVisibility | null, agentId: string): TimerData;
+/**
+ * Calculate consult timer label and timestamp based on consult state.
+ * Handles consult on hold vs active consulting states.
+ *
+ * @param currentTask - The current task object
+ * @param controlVisibility - Control visibility flags
+ * @param agentId - The current agent ID
+ * @returns TimerData object with label and timestamp
+ */
+export declare function calculateConsultTimerData(currentTask: ITask | null, controlVisibility: ControlVisibility | null, agentId: string): TimerData;

package/dist/types/Utils/useHoldTimer.d.ts

@@ -0,0 +1,9 @@
+import { ITask } from '@webex/cc-store';
+/**
+ * Custom hook to manage hold timer using a Web Worker
+ * Prioritizes consult hold over main call hold
+ *
+ * @param currentTask - The current task object
+ * @returns holdTime - The elapsed time in seconds since the call was put on hold
+ */
+export declare const useHoldTimer: (currentTask: ITask | null) => number;

package/dist/types/helper.d.ts

@@ -1,6 +1,7 @@
-import { ITask } from '@webex/plugin-cc';
-import { useCallControlProps, UseTaskListProps, UseTaskProps, useOutdialCallProps } from './task.types';
-import { BuddyDetails, DestinationType, ContactServiceQueue } from '@webex/cc-store';
+import { AddressBookEntriesResponse, AddressBookEntrySearchParams, ITask } from '@webex/contact-center';
+import { useCallControlProps, UseTaskListProps, UseTaskProps, useOutdialCallProps, TargetType } from './task.types';
+import { BuddyDetails, DestinationType, PaginatedListParams, Participant } from '@webex/cc-store';
+import { OutdialAniEntriesResponse } from '@webex/contact-center/dist/types/services/config/types';
 export declare const useTaskList: (props: UseTaskListProps) => {
     taskList: Record<string, ITask>;
     acceptTask: (task: ITask) => void;
@@ -13,6 +14,7 @@ export declare const useIncomingTask: (props: UseTaskProps) => {
     accept: () => void;
     reject: () => void;
     isBrowser: boolean;
+    isDeclineButtonEnabled: boolean;
 };
 export declare const useCallControl: (props: useCallControlProps) => {
     currentTask: ITask;
@@ -22,43 +24,82 @@ export declare const useCallControl: (props: useCallControlProps) => {
     toggleMute: () => Promise<void>;
     isMuted: boolean;
     wrapupCall: (wrapUpReason: string, auxCodeId: string) => void;
-    isHeld: boolean;
-    setIsHeld: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     isRecording: boolean;
     setIsRecording: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     buddyAgents: BuddyDetails[];
+    loadingBuddyAgents: boolean;
     loadBuddyAgents: () => Promise<void>;
-    queues: ContactServiceQueue[];
-    loadQueues: () => Promise<void>;
     transferCall: (to: string, type: DestinationType) => Promise<void>;
-    consultCall: (consultDestination: string, destinationType: DestinationType) => Promise<void>;
+    consultCall: (consultDestination: string, destinationType: DestinationType, allowParticipantsToInteract: boolean) => Promise<void>;
     endConsultCall: () => Promise<void>;
-    consultTransfer: (transferDestination: string, destinationType: DestinationType) => Promise<void>;
+    consultTransfer: () => Promise<void>;
+    consultConference: () => Promise<void>;
+    switchToMainCall: () => Promise<void>;
+    switchToConsult: () => Promise<void>;
+    exitConference: () => Promise<void>;
     consultAgentName: string;
     setConsultAgentName: import("react").Dispatch<import("react").SetStateAction<string>>;
-    consultAgentId: string;
-    setConsultAgentId: import("react").Dispatch<import("react").SetStateAction<string>>;
     holdTime: number;
     startTimestamp: number;
-    lastTargetType: "agent" | "queue";
-    setLastTargetType: import("react").Dispatch<import("react").SetStateAction<"agent" | "queue">>;
+    stateTimerLabel: string;
+    stateTimerTimestamp: number;
+    consultTimerLabel: string;
+    consultTimerTimestamp: number;
+    lastTargetType: TargetType;
+    setLastTargetType: import("react").Dispatch<import("react").SetStateAction<TargetType>>;
     controlVisibility: {
-        accept: boolean;
-        decline: boolean;
-        end: boolean;
-        muteUnmute: boolean;
-        holdResume: boolean;
-        consult: boolean;
-        transfer: boolean;
-        conference: boolean;
-        wrapup: boolean;
-        pauseResumeRecording: boolean;
-        endConsult: boolean;
-        recordingIndicator: boolean;
+        accept: import("@webex/cc-components").Visibility;
+        decline: import("@webex/cc-components").Visibility;
+        end: import("@webex/cc-components").Visibility;
+        muteUnmute: import("@webex/cc-components").Visibility;
+        holdResume: import("@webex/cc-components").Visibility;
+        pauseResumeRecording: import("@webex/cc-components").Visibility;
+        recordingIndicator: import("@webex/cc-components").Visibility;
+        transfer: import("@webex/cc-components").Visibility;
+        conference: import("@webex/cc-components").Visibility;
+        exitConference: import("@webex/cc-components").Visibility;
+        mergeConference: import("@webex/cc-components").Visibility;
+        consult: import("@webex/cc-components").Visibility;
+        endConsult: import("@webex/cc-components").Visibility;
+        consultTransfer: import("@webex/cc-components").Visibility;
+        consultTransferConsult: import("@webex/cc-components").Visibility;
+        mergeConferenceConsult: import("@webex/cc-components").Visibility;
+        muteUnmuteConsult: import("@webex/cc-components").Visibility;
+        switchToMainCall: import("@webex/cc-components").Visibility;
+        switchToConsult: import("@webex/cc-components").Visibility;
+        wrapup: import("@webex/cc-components").Visibility;
+        isConferenceInProgress: boolean;
+        isConsultInitiated: boolean;
+        isConsultInitiatedAndAccepted: boolean;
+        isConsultReceived: boolean;
+        isConsultInitiatedOrAccepted: boolean;
+        isHeld: boolean;
+        consultCallHeld: boolean;
     };
     secondsUntilAutoWrapup: number;
     cancelAutoWrapup: () => void;
+    conferenceParticipants: Participant[];
+    getAddressBookEntries: ({ page, pageSize, search }: PaginatedListParams) => Promise<AddressBookEntriesResponse>;
+    getEntryPoints: ({ page, pageSize, search }: PaginatedListParams) => Promise<import("@webex/contact-center").EntryPointListResponse>;
+    getQueuesFetcher: ({ page, pageSize, search }: PaginatedListParams) => Promise<{
+        data: import("@webex/contact-center").ContactServiceQueue[];
+        meta: {
+            page: number;
+            pageSize: number;
+            total: number;
+            totalPages: number;
+        };
+    } | {
+        data: any[];
+        meta: {
+            page: number;
+            totalPages: number;
+        };
+    }>;
 };
 export declare const useOutdialCall: (props: useOutdialCallProps) => {
-    startOutdial: (destination: string) => void;
+    startOutdial: (destination: string, origin?: string) => void;
+    getOutdialANIEntries: () => Promise<OutdialAniEntriesResponse>;
+    getAddressBookEntries: (params: AddressBookEntrySearchParams) => Promise<AddressBookEntriesResponse>;
+    isTelephonyTaskActive: boolean;
 };

package/dist/types/task.types.d.ts

@@ -3,11 +3,31 @@ export type UseTaskProps = Pick<TaskProps, 'incomingTask' | 'deviceType' | 'logg
 export type UseTaskListProps = Pick<TaskProps, 'cc' | 'taskList' | 'deviceType' | 'logger'> & Partial<Pick<TaskProps, 'onTaskAccepted' | 'onTaskDeclined' | 'onTaskSelected'>>;
 export type IncomingTaskProps = Pick<TaskProps, 'incomingTask'> & Partial<Pick<TaskProps, 'onAccepted' | 'onRejected'>>;
 export type TaskListProps = Partial<Pick<TaskProps, 'onTaskAccepted' | 'onTaskDeclined' | 'onTaskSelected'>>;
-export type CallControlProps = Partial<Pick<ControlProps, 'onHoldResume' | 'onEnd' | 'onWrapUp' | 'onRecordingToggle' | 'callControlClassName' | 'callControlConsultClassName' | 'onToggleMute'>>;
-export type useCallControlProps = Pick<ControlProps, 'currentTask' | 'logger' | 'consultInitiated' | 'deviceType' | 'featureFlags' | 'isMuted'> & Partial<Pick<ControlProps, 'onHoldResume' | 'onEnd' | 'onWrapUp' | 'onRecordingToggle' | 'onToggleMute'>>;
-export type Participant = {
-    id: string;
-    pType: 'Customer' | 'Agent' | string;
-    name?: string;
-};
+export type CallControlProps = Partial<Pick<ControlProps, 'onHoldResume' | 'onEnd' | 'onWrapUp' | 'onRecordingToggle' | 'callControlClassName' | 'callControlConsultClassName' | 'onToggleMute' | 'conferenceEnabled' | 'consultTransferOptions'>>;
+export type useCallControlProps = Pick<ControlProps, 'currentTask' | 'logger' | 'deviceType' | 'featureFlags' | 'isMuted' | 'conferenceEnabled' | 'agentId'> & Partial<Pick<ControlProps, 'onHoldResume' | 'onEnd' | 'onWrapUp' | 'onRecordingToggle' | 'onToggleMute'>>;
 export type useOutdialCallProps = Pick<OutdialCallProps, 'cc' | 'logger'>;
+export interface OutdialProps {
+    /**
+     * Flag to determine if the address book is enabled.
+     * Defaults to true if not provided.
+     */
+    isAddressBookEnabled?: boolean;
+}
+/**
+ * Helper interface for device type checks
+ */
+export interface DeviceTypeFlags {
+    isBrowser: boolean;
+    isAgentDN: boolean;
+    isExtension: boolean;
+}
+/**
+ * Target types for consult/transfer operations
+ */
+export declare const TARGET_TYPE: {
+    readonly AGENT: "agent";
+    readonly QUEUE: "queue";
+    readonly ENTRY_POINT: "entryPoint";
+    readonly DIAL_NUMBER: "dialNumber";
+};
+export type TargetType = (typeof TARGET_TYPE)[keyof typeof TARGET_TYPE];

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@webex/cc-task",
   "description": "Webex Contact Center Widgets: Task",
-  "version": "1.28.0-ccwidgets.99",
+  "license": "Cisco's General Terms (https://www.cisco.com/site/us/en/about/legal/contract-experience/index.html)",
+  "version": "1.28.0-next.10",
   "main": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "publishConfig": {
@@ -18,12 +19,14 @@
     "build:src": "yarn run clean:dist && webpack",
     "build:watch": "webpack --watch",
     "test:unit": "tsc --project tsconfig.test.json && jest --coverage",
-    "test:styles": "eslint"
+    "test:styles": "eslint",
+    "deploy:npm": "yarn npm publish"
   },
   "dependencies": {
-    "@webex/cc-components": "1.28.0-ccwidgets.99",
-    "@webex/cc-store": "1.28.0-ccwidgets.99",
-    "mobx-react-lite": "^4.1.0"
+    "@webex/cc-components": "1.28.0-next.10",
+    "@webex/cc-store": "1.28.0-next.4",
+    "mobx-react-lite": "^4.1.0",
+    "react-error-boundary": "^6.0.0"
   },
   "devDependencies": {
     "@babel/core": "7.25.2",
@@ -36,7 +39,7 @@
     "@testing-library/react": "16.0.1",
     "@types/jest": "29.5.14",
     "@types/react-test-renderer": "18",
-    "@webex/test-fixtures": "0.0.0",
+    "@webex/test-fixtures": "0.0.0-next.1",
     "babel-jest": "29.7.0",
     "babel-loader": "9.2.1",
     "eslint": "^9.20.1",