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

package/dist/types/Utils/main-cad-hold.util.d.ts

@@ -0,0 +1,20 @@
+import { ITask } from '@webex/cc-store';
+import { Interaction, TaskUIControls } from '@webex/contact-center';
+export type MainCadHoldInputs = {
+    currentTask: ITask | null;
+    controls: TaskUIControls;
+    agentId?: string;
+    holdDataVersion?: number;
+};
+export type MainCadHoldResult = {
+    isHeld: boolean;
+    interaction: Interaction | undefined;
+    holdTimestampMs: number | null;
+};
+/**
+ * Single source of truth for main CAD "On Hold" chip + timer inputs.
+ *
+ * Covers: simple consult (Agent 2), EP/DN consult, conference nested consult,
+ * plain conference hold, and refresh timer continuity (via resolveMainCadHoldTimestampMs).
+ */
+export declare function deriveMainCadHoldState({ currentTask, controls, agentId, holdDataVersion, }: MainCadHoldInputs): MainCadHoldResult;

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

@@ -1,4 +1,16 @@
 import { Interaction } from '@webex/contact-center';
+type ConsultMediaEntry = {
+    holdTimestamp?: number | null;
+};
+export declare const getHoldAnchorStorageKey: (interactionId: string) => string;
+export declare const getConsultHoldAnchorStorageKey: (interactionId: string) => string;
+export declare const normalizeHoldTimestampMs: (raw: number) => number;
+export declare const readHoldAnchor: (interactionId: string | undefined) => number | null;
+export declare const writeHoldAnchor: (interactionId: string | undefined, timestampMs: number) => void;
+export declare const clearHoldAnchor: (interactionId: string | undefined) => void;
+export declare const readConsultHoldAnchor: (interactionId: string | undefined) => number | null;
+export declare const writeConsultHoldAnchor: (interactionId: string | undefined, timestampMs: number) => void;
+export declare const clearConsultHoldAnchor: (interactionId: string | undefined) => void;
 /**
  * Finds the hold timestamp for a specific media type from an interaction.
  * Used by useHoldTimer for hold duration display.
@@ -7,3 +19,13 @@ import { Interaction } from '@webex/contact-center';
  * This one takes Interaction directly.
  */
 export declare function findHoldTimestamp(interaction: Interaction, mType?: string): number | null;
+/**
+ * Resolve main CAD hold timer anchor in milliseconds.
+ * Prefers interaction media; falls back to session anchor for refresh continuity.
+ */
+export declare function resolveMainCadHoldTimestampMs(interaction: Interaction | undefined, isHeld: boolean, interactionId?: string): number | null;
+/**
+ * Resolve consult-leg hold timer anchor in milliseconds (Agent 1 initiator CAD).
+ */
+export declare function resolveConsultHoldTimestampMs(consultMedia: ConsultMediaEntry | null | undefined, interactionId?: string): number;
+export {};

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

@@ -1,4 +1,5 @@
 import { ITask, TaskUIControls } from '@webex/cc-store';
+import { Interaction } from '@webex/contact-center';
 /**
  * Timer data structure containing label and timestamp
  */
@@ -6,14 +7,39 @@ export interface TimerData {
     label: string | null;
     timestamp: number;
 }
+type MediaEntry = {
+    mType?: string;
+    isHold?: boolean;
+    holdTimestamp?: number | null;
+    lastUpdated?: number;
+    joinTimestamp?: number;
+    eventTime?: number;
+    createdAt?: number;
+    mediaResourceId?: string;
+    participants?: string[];
+};
+type InteractionParticipant = {
+    consultTimestamp?: number;
+    lastUpdated?: number;
+    consultState?: string;
+    isConsulted?: boolean;
+    isWrapUp?: boolean;
+    wrapUpTimestamp?: number | null;
+    currentState?: string | null;
+    currentStateTimestamp?: number | null;
+};
+type InteractionWithMedia = Interaction & {
+    media?: Record<string, MediaEntry>;
+    participants?: Record<string, InteractionParticipant>;
+};
 /**
  * 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.
+ * in the interaction alongside the NEW one. Prefer held consult entries when
+ * present (switch-to-main), otherwise pick the most recent consult leg.
  */
-export declare function findLatestConsultMedia(interaction: any): any;
+export declare function findLatestConsultMedia(interaction: InteractionWithMedia | undefined): MediaEntry | null;
 /**
  * Calculate state timer label and timestamp based on task state.
  * Priority: Wrap Up > Post Call
@@ -23,10 +49,8 @@ export declare function calculateStateTimerData(currentTask: ITask | null, contr
  * Calculate consult timer label and timestamp based on consult state.
  * Handles consult on hold vs active consulting states.
  *
- * 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).
+ * Derives consult on hold from consult media isHold (not uiControls alone).
+ * EP/DN and agent-name: isHold may be true before holdTimestamp arrives — still show Consult on Hold.
  */
 export declare function calculateConsultTimerData(currentTask: ITask | null, controls: TaskUIControls | null, agentId: string): TimerData;
+export {};

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

@@ -1,15 +1,4 @@
-import { ITask } from '@webex/cc-store';
-import { TaskUIControls } from '@webex/contact-center';
 /**
- * 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
+ * Hold timer only — main CAD on-hold boolean is computed in useCallControl (helper.ts).
  */
-export declare const useHoldTimer: (currentTask: ITask | null, controls?: TaskUIControls) => number;
+export declare const useHoldTimer: (mainCallOnHold: boolean, holdTimestampMs: number | null, holdDataVersion?: number, interactionId?: string) => number;

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-task-refactor.1",
+  "version": "1.28.0-task-refactor.2",
   "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-task-refactor.1",
-    "@webex/cc-store": "1.28.0-ccwidgets.126",
+    "@webex/cc-components": "1.28.0-task-refactor.2",
+    "@webex/cc-store": "1.28.0-task-refactor.2",
     "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",
+    "@webex/test-fixtures": "0.0.0-task-refactor.1",
     "babel-jest": "29.7.0",
     "babel-loader": "9.2.1",
     "eslint": "^9.20.1",