@webex/cc-task 1.28.0-rtt.2 → 1.28.0-task-refactor.1

package/dist/index.js.LICENSE.txt

@@ -1,5 +1,69 @@
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+
+/*!
+ * Copyright (c) 2015-2024 Cisco Systems, Inc. See LICENSE file.
+ */
+
+/*!
+ * Platform.js v1.3.6
+ * Copyright 2014-2020 Benjamin Tan
+ * Copyright 2011-2013 John-David Dalton
+ * Available under MIT license
+ */
+
+/*!
+ * The buffer module from node.js, for the browser.
+ *
+ * @author   Feross Aboukhadijeh <https://feross.org>
+ * @license  MIT
+ */
+
+/*!
+ * js-logger - http://github.com/jonnyreeves/js-logger
+ * Jonny Reeves, http://jonnyreeves.co.uk/
+ * js-logger may be freely distributed under the MIT license.
+ */
+
+/*!
+ * urlsafe-base64
+ */
+
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
 /*! For license information please see index.js.LICENSE.txt */
 
+/*! https://mths.be/punycode v1.4.1 by @mathias */
+
+/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
+
+/*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */
+
+/*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */
+
+/**
+ * @license
+ * Lodash <https://lodash.com/>
+ * Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
+ * Released under MIT license <https://lodash.com/license>
+ * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
+ * Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
+ */
+
 /**
  * @license React
  * use-sync-external-store-shim.production.js
@@ -9,3 +73,11 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+
+/**
+ * core-decorators.js
+ * (c) 2017 Jay Phelps and contributors
+ * MIT Licensed
+ * https://github.com/jayphelps/core-decorators.js
+ * @license
+ */

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

@@ -1,125 +1,9 @@
-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;
+import { Interaction } from '@webex/contact-center';
 /**
- * Get visibility for Merge Conference button
+ * Finds the hold timestamp for a specific media type from an interaction.
+ * Used by useHoldTimer for hold duration display.
+ *
+ * Note: There is a separate findHoldTimestamp in @webex/cc-store that takes ITask.
+ * This one takes Interaction directly.
  */
-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
- * @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, 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

@@ -1,5 +1,4 @@
-import { ITask } from '@webex/cc-store';
-import { ControlVisibility } from '@webex/cc-components';
+import { ITask, TaskUIControls } from '@webex/cc-store';
 /**
  * Timer data structure containing label and timestamp
  */
@@ -7,23 +6,27 @@ export interface TimerData {
     label: string | null;
     timestamp: number;
 }
+/**
+ * Find the latest (most recently added) consult media from the interaction.
+ *
+ * After transfer → re-consult the backend may leave the OLD consult media
+ * in the interaction alongside the NEW one.  Using Array.find() would return
+ * the first (stale) entry; we need the last one which is the active consult.
+ */
+export declare function findLatestConsultMedia(interaction: any): any;
 /**
  * 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;
+export declare function calculateStateTimerData(currentTask: ITask | null, controls: TaskUIControls | 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
+ * Approach mirrors the original next-branch pattern: derive consultCallHeld
+ * from the consult media's isHold flag (task data), NOT from SDK uiControls
+ * properties like activeLeg or switch button visibility.  Those UI properties
+ * have different lifecycle timing and broader semantics that cause false
+ * positives (e.g., switch.isVisible is true during CONSULT_INITIATING).
  */
-export declare function calculateConsultTimerData(currentTask: ITask | null, controlVisibility: ControlVisibility | null, agentId: string): TimerData;
+export declare function calculateConsultTimerData(currentTask: ITask | null, controls: TaskUIControls | null, agentId: string): TimerData;

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

@@ -1,9 +1,15 @@
 import { ITask } from '@webex/cc-store';
+import { TaskUIControls } from '@webex/contact-center';
 /**
- * Custom hook to manage hold timer using a Web Worker
- * Prioritizes consult hold over main call hold
+ * Custom hook to manage hold timer using a Web Worker.
+ *
+ * Derives two stable primitives from props — a boolean hold flag and a
+ * numeric timestamp — and uses them as the sole effect dependencies.
+ * This prevents the worker from being killed/recreated on every
+ * currentTask or controls reference change.
  *
  * @param currentTask - The current task object
+ * @param controls - SDK-computed UI controls with activeLeg
  * @returns holdTime - The elapsed time in seconds since the call was put on hold
  */
-export declare const useHoldTimer: (currentTask: ITask | null) => number;
+export declare const useHoldTimer: (currentTask: ITask | null, controls?: TaskUIControls) => number;

package/dist/types/helper.d.ts

@@ -1,5 +1,5 @@
-import { AddressBookEntriesResponse, AddressBookEntrySearchParams, ITask } from '@webex/contact-center';
-import { useCallControlProps, UseTaskListProps, UseTaskProps, UseRealtimeTranscriptInternalProps, RealtimeTranscriptEntry, useOutdialCallProps, TargetType } from './task.types';
+import { AddressBookEntriesResponse, AddressBookEntrySearchParams, ITask, TaskUIControls } 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) => {
@@ -7,24 +7,20 @@ export declare const useTaskList: (props: UseTaskListProps) => {
     acceptTask: (task: ITask) => void;
     declineTask: (task: ITask) => void;
     onTaskSelect: (task: ITask) => void;
-    isBrowser: boolean;
-};
-export declare const useRealtimeTranscript: (props: UseRealtimeTranscriptInternalProps) => {
-    ivrTranscript: string;
-    liveTranscriptEntries: RealtimeTranscriptEntry[];
-    activeTab: import("@webex/cc-components/dist/types/components/task/task.types").TranscriptTab;
-    onTabChange: (tab: import("@webex/cc-components/dist/types/components/task/task.types").TranscriptTab) => void;
-    className: string;
 };
 export declare const useIncomingTask: (props: UseTaskProps) => {
     incomingTask: ITask;
     accept: () => void;
     reject: () => void;
-    isBrowser: boolean;
-    isDeclineButtonEnabled: boolean;
+    acceptControl: import("@webex/contact-center").TaskUIControlState;
+    declineControl: {
+        isEnabled: boolean;
+        isVisible: boolean;
+    };
 };
 export declare const useCallControl: (props: useCallControlProps) => {
     currentTask: ITask;
+    isHeld: boolean;
     endCall: () => void;
     toggleHold: (hold: boolean) => void;
     toggleRecording: () => void;
@@ -54,35 +50,8 @@ export declare const useCallControl: (props: useCallControlProps) => {
     consultTimerTimestamp: number;
     lastTargetType: TargetType;
     setLastTargetType: import("react").Dispatch<import("react").SetStateAction<TargetType>>;
-    controlVisibility: {
-        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;
-    };
+    controls: TaskUIControls;
+    conferenceEnabled: boolean;
     secondsUntilAutoWrapup: number;
     cancelAutoWrapup: () => void;
     conferenceParticipants: Participant[];

package/dist/types/index.d.ts

@@ -3,5 +3,4 @@ import { TaskList } from './TaskList';
 import { CallControl } from './CallControl';
 import { OutdialCall } from './OutdialCall';
 import { CallControlCAD } from './CallControlCAD';
-import { RealtimeTranscript } from './ReatimeTranscript';
-export { IncomingTask, TaskList, CallControl, OutdialCall, CallControlCAD, RealtimeTranscript };
+export { IncomingTask, TaskList, CallControl, OutdialCall, CallControlCAD };

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

@@ -1,19 +1,11 @@
-import { TaskProps, ControlProps, OutdialCallProps, RealtimeTranscriptComponentProps, RealtimeTranscriptEntry, TranscriptTab } from '@webex/cc-components';
-import { RealtimeTranscriptLine } from '@webex/cc-store';
-export type UseTaskProps = Pick<TaskProps, 'incomingTask' | 'deviceType' | 'logger'> & Partial<Pick<TaskProps, 'onAccepted' | 'onRejected'>>;
-export type UseTaskListProps = Pick<TaskProps, 'cc' | 'taskList' | 'deviceType' | 'logger'> & Partial<Pick<TaskProps, 'onTaskAccepted' | 'onTaskDeclined' | 'onTaskSelected'>>;
+import { TaskProps, ControlProps, OutdialCallProps } from '@webex/cc-components';
+export type UseTaskProps = Pick<TaskProps, 'incomingTask' | 'logger'> & Partial<Pick<TaskProps, 'onAccepted' | 'onRejected'>>;
+export type UseTaskListProps = Pick<TaskProps, 'cc' | 'taskList' | '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 RealtimeTranscriptProps = Pick<RealtimeTranscriptComponentProps, 'ivrTranscript' | 'liveTranscriptEntries'> & Partial<Pick<RealtimeTranscriptComponentProps, 'activeTab' | 'onTabChange' | 'className'>>;
-export type UseRealtimeTranscriptProps = RealtimeTranscriptProps;
-export type UseRealtimeTranscriptInternalProps = UseRealtimeTranscriptProps & {
-    currentTaskId?: string;
-    realtimeTranscriptLines?: RealtimeTranscriptLine[];
-};
 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 useCallControlProps = Pick<ControlProps, 'currentTask' | 'logger' | 'isMuted' | 'conferenceEnabled' | 'agentId'> & Partial<Pick<ControlProps, 'onHoldResume' | 'onEnd' | 'onWrapUp' | 'onRecordingToggle' | 'onToggleMute'>>;
 export type useOutdialCallProps = Pick<OutdialCallProps, 'cc' | 'logger'>;
-export type { RealtimeTranscriptEntry, TranscriptTab };
 export interface OutdialProps {
     /**
      * Flag to determine if the address book is enabled.
@@ -21,14 +13,6 @@ export interface OutdialProps {
      */
     isAddressBookEnabled?: boolean;
 }
-/**
- * Helper interface for device type checks
- */
-export interface DeviceTypeFlags {
-    isBrowser: boolean;
-    isAgentDN: boolean;
-    isExtension: boolean;
-}
 /**
  * Target types for consult/transfer operations
  */

package/package.json

@@ -2,7 +2,7 @@
   "name": "@webex/cc-task",
   "description": "Webex Contact Center Widgets: Task",
   "license": "Cisco's General Terms (https://www.cisco.com/site/us/en/about/legal/contract-experience/index.html)",
-  "version": "1.28.0-rtt.2",
+  "version": "1.28.0-task-refactor.1",
   "main": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "publishConfig": {
@@ -23,8 +23,8 @@
     "deploy:npm": "yarn npm publish"
   },
   "dependencies": {
-    "@webex/cc-components": "1.28.0-rtt.2",
-    "@webex/cc-store": "1.28.0-rtt.2",
+    "@webex/cc-components": "1.28.0-task-refactor.1",
+    "@webex/cc-store": "1.28.0-ccwidgets.126",
     "mobx-react-lite": "^4.1.0",
     "react-error-boundary": "^6.0.0"
   },
@@ -39,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-rtt.1",
+    "@webex/test-fixtures": "0.0.0",
     "babel-jest": "29.7.0",
     "babel-loader": "9.2.1",
     "eslint": "^9.20.1",

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

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