@webex/cc-components 1.28.0-next.44 → 1.28.0-next.46

package/dist/types/components/task/CallControl/CallControlCustom/call-control-custom.utils.d.ts

@@ -1,4 +1,4 @@
-import { BuddyDetails, ContactServiceQueue, ILogger, TaskUIControls } from '@webex/cc-store';
+import { BuddyDetails, ContactServiceQueue, ILogger, ITask, TaskUIControls } from '@webex/cc-store';
 import { ButtonConfig } from '../../task.types';
 /**
  * Interface for list item data
@@ -10,7 +10,7 @@ export interface ListItemData {
 /**
  * Creates the consult button configuration array
  */
-export declare const createConsultButtons: (isMuted: boolean, controls: TaskUIControls, consultTransfer: () => void, toggleConsultMute: () => void, endConsultCall: () => void, consultConference: () => void, switchToMainCall: () => void, logger?: any, conferenceEnabled?: boolean) => ButtonConfig[];
+export declare const createConsultButtons: (isMuted: boolean, controls: TaskUIControls, consultTransfer: () => void, toggleConsultMute: () => void, endConsultCall: () => void, consultConference: () => void, switchToMainCall: () => void, logger?: any, conferenceEnabled?: boolean, enableWxBetterTogether?: boolean, task?: ITask | null) => ButtonConfig[];
 /**
  * Filters buttons that should be visible
  */

package/dist/types/components/task/CallControl/call-control-dtmf-keypad.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { ILogger } from '@webex/cc-store';
+export type CallControlDtmfKeypadProps = {
+    onDigitPress: (digit: string) => void | Promise<void>;
+    logger?: ILogger;
+    disabled?: boolean;
+};
+/**
+ * In-call DTMF keypad for wxApp telephony sessions (Extension login).
+ * Each key press sends a single tone via SDK task.transmitDtmf().
+ */
+declare const CallControlDtmfKeypad: React.FunctionComponent<CallControlDtmfKeypadProps>;
+export default CallControlDtmfKeypad;

package/dist/types/components/task/CallControl/call-control.utils.d.ts

@@ -9,7 +9,7 @@ export declare const handleToggleHold: (isHeld: boolean, toggleHold: (hold: bool
 /**
  * Handles mute toggle functionality with disabled state management
  */
-export declare const handleMuteToggle: (toggleMute: () => void, setIsMuteButtonDisabled: (disabled: boolean) => void, logger: ILogger) => void;
+export declare const handleMuteToggle: (toggleMute: () => void | Promise<void>, setIsMuteButtonDisabled: (disabled: boolean) => void, logger: ILogger) => Promise<void>;
 /**
  * Handles wrapup call submission
  */
@@ -26,6 +26,11 @@ export declare const handleTargetSelect: (id: string, name: string, type: Destin
  * Gets the media type information
  */
 export declare const getMediaType: (mediaType: MediaChannelType, mediaChannel: MediaChannelType, logger?: any) => MediaTypeInfo;
+/**
+ * Thin defense layer for thick-client flag ON: suppresses visible+disabled ghost controls.
+ * SDK owns isVisible/isEnabled for wxApp engaged calls; widgets pass through when SDK is correct.
+ */
+export declare const applyWxAppTelephonyControlVisibility: (buttons: CallControlButton[], task: ITask | null | undefined, controls: TaskUIControls | undefined, isTelephony: boolean, enableWxBetterTogether?: boolean, agentDeviceType?: string) => CallControlButton[];
 /**
  * Checks if the media type is telephony
  */

package/dist/types/components/task/CallControlCAD/call-control-cad.types.d.ts

@@ -0,0 +1,10 @@
+import { ConferenceParticipantDropTarget } from '@webex/cc-store';
+export type ParticipantRosterSectionProps = {
+    heading: 'Customer' | 'Participants';
+    headingId: string;
+    targets: ConferenceParticipantDropTarget[];
+    pendingParticipantDropId: string | null;
+    participantDropIsPending: boolean;
+    rosterDropDisabled: boolean;
+    onParticipantDropRequest: (target: ConferenceParticipantDropTarget) => void;
+};

package/dist/types/components/task/OutdialCall/constants.d.ts

@@ -10,7 +10,46 @@ export declare const OutdialStrings: {
     TAB_ADDRESS_BOOK: string;
     TAB_DIALPAD: string;
 };
-export declare const KEY_LIST: string[];
+export declare const DTMF_KEYPAD_PLACEHOLDER = "Enter the number";
+/** Dialpad key metadata — mirrors Agent Desktop DIALPAD_BUTTONS_ARRAY (visual labels only). */
+export declare const DIALPAD_BUTTONS: readonly [{
+    readonly val: "1";
+    readonly label: "";
+}, {
+    readonly val: "2";
+    readonly label: "ABC";
+}, {
+    readonly val: "3";
+    readonly label: "DEF";
+}, {
+    readonly val: "4";
+    readonly label: "GHI";
+}, {
+    readonly val: "5";
+    readonly label: "JKL";
+}, {
+    readonly val: "6";
+    readonly label: "MNO";
+}, {
+    readonly val: "7";
+    readonly label: "PQRS";
+}, {
+    readonly val: "8";
+    readonly label: "TUV";
+}, {
+    readonly val: "9";
+    readonly label: "WXYZ";
+}, {
+    readonly val: "*";
+    readonly label: "";
+}, {
+    readonly val: "0";
+    readonly label: "+";
+}, {
+    readonly val: "#";
+    readonly label: "";
+}];
+export declare const KEY_LIST: ("0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "*" | "#")[];
 export declare const TABS: {
     DIAL_PAD: string;
     ADDRESS_BOOK: string;

package/dist/types/components/task/Task/index.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { PressEvent } from '@react-types/shared';
-import type { MEDIA_CHANNEL as MediaChannelType } from '../task.types';
+import type { MEDIA_CHANNEL as MediaChannelType, WxAppTelephonyErrorDisplay } from '../task.types';
 import './styles.scss';
 export interface TaskProps {
     interactionId?: string;
@@ -21,6 +21,7 @@ export interface TaskProps {
     styles?: string;
     mediaType?: MediaChannelType;
     mediaChannel?: MediaChannelType;
+    actionError?: WxAppTelephonyErrorDisplay | null;
 }
 declare const Task: React.FC<TaskProps>;
 export default Task;

package/dist/types/components/task/Task/task.utils.d.ts

@@ -63,7 +63,7 @@ export declare const shouldShowTimeLeft: (isIncomingTask?: boolean, ronaTimeout?
  * @param styles - Additional styles
  * @returns The combined CSS class string
  */
-export declare const getTaskListItemClasses: (selected?: boolean, styles?: string, logger?: any) => string;
+export declare const getTaskListItemClasses: (selected?: boolean, styles?: string, logger?: any, hasActionError?: boolean) => string;
 /**
  * Extracts and processes all data needed for rendering the Task component
  * @param props - The Task component props

package/dist/types/components/task/TelephonyActionToast/telephony-action-toast.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { WxAppTelephonyErrorDisplay } from '../task.types';
+import './telephony-action-toast.style.scss';
+export type TelephonyActionToastProps = {
+    error: WxAppTelephonyErrorDisplay;
+    onDismiss: () => void;
+};
+declare const TelephonyActionToast: React.FunctionComponent<TelephonyActionToastProps>;
+export default TelephonyActionToast;

package/dist/types/components/task/WxAppOfferActionError/wxapp-offer-action-error.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { WxAppTelephonyErrorDisplay } from '../task.types';
+import './wxapp-offer-action-error.style.scss';
+export type WxAppOfferActionErrorProps = {
+    error: WxAppTelephonyErrorDisplay;
+};
+declare const WxAppOfferActionError: React.FunctionComponent<WxAppOfferActionErrorProps>;
+export default WxAppOfferActionError;

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

@@ -1,4 +1,4 @@
-import { ILogger, ITask, IContactCenter, IWrapupCode, BuddyDetails, DestinationType, ContactServiceQueue, AddressBookEntry, EntryPointRecord, FetchPaginatedList, Participant, AddressBookEntrySearchParams, AddressBookEntriesResponse, TaskUIControls } from '@webex/cc-store';
+import { ILogger, ITask, IContactCenter, IWrapupCode, BuddyDetails, DestinationType, ContactServiceQueue, AddressBookEntry, EntryPointRecord, FetchPaginatedList, Participant, ConferenceParticipantDropRoster, ConferenceParticipantDropTarget, AddressBookEntrySearchParams, AddressBookEntriesResponse, TaskUIControls } from '@webex/cc-store';
 import { CampaignErrorType } from './CampaignErrorDialog/campaign-error-dialog.types';
 type Enum<T extends Record<string, unknown>> = T[keyof T];
 /**
@@ -32,6 +32,10 @@ export declare const TARGET_TYPE: {
     readonly DIAL_NUMBER: "dialNumber";
 };
 export type TargetType = (typeof TARGET_TYPE)[keyof typeof TARGET_TYPE];
+export type ParticipantDropAnnouncement = {
+    type: 'success' | 'error';
+    message: string;
+};
 /**
  * Interface representing the TaskProps of a user.
  */
@@ -152,10 +156,20 @@ export type IncomingTaskComponentProps = Pick<TaskProps, 'accept' | 'reject' | '
     };
     isDeclineButtonEnabled?: boolean;
     isBrowser?: boolean;
+    offerActionError?: WxAppTelephonyErrorDisplay | null;
+    clearOfferActionError?: () => void;
+};
+export type WxAppTelephonyErrorDisplay = {
+    message: string;
+    trackingId?: string;
+    status?: number | string;
+    isWxAppTelephonyError: boolean;
 };
 export type TaskListComponentProps = Pick<TaskProps, 'acceptTask' | 'declineTask' | 'onTaskSelect' | 'logger' | 'agentId' | 'cc'> & Partial<Pick<TaskProps, 'currentTask' | 'taskList' | 'hasCampaignPreviewEnabled' | 'acceptedCampaignIds'>> & {
     isDeclineButtonEnabled?: boolean;
     isBrowser?: boolean;
+    taskActionErrors?: Record<string, WxAppTelephonyErrorDisplay | null>;
+    clearTaskActionError?: (interactionId: string) => void;
 };
 export interface RealTimeTranscriptEntry {
     id: string;
@@ -254,6 +268,10 @@ export interface ControlProps {
      * Function to handle mute/unmute actions.
      */
     toggleMute: () => void;
+    /**
+     * Sends a DTMF tone on wxApp engaged telephony calls.
+     */
+    sendDtmf?: (digit: string) => void;
     /**
      * Function to handle ending the call.
      */
@@ -419,6 +437,22 @@ export interface ControlProps {
      * List of participants in the conference excluding the agent themselves.
      */
     conferenceParticipants: Participant[];
+    /** Owner-aware conference roster used by the CallControlCAD Drop menu. */
+    conferenceParticipantDropRoster: ConferenceParticipantDropRoster | null;
+    /** Drop target currently waiting for routing-event completion. */
+    pendingParticipantDropId: string | null;
+    /** Generic screen-reader and visible feedback for the most recent Drop request. */
+    participantDropAnnouncement: ParticipantDropAnnouncement | null;
+    /** Customer target currently awaiting explicit confirmation. */
+    participantDropConfirmationTarget: ConferenceParticipantDropTarget | null;
+    /** Whether the current Customer confirmation action is unavailable. */
+    participantDropConfirmationDisabled: boolean;
+    /** Validates a Drop target, opening confirmation for Customer or invoking Drop immediately. */
+    requestParticipantDrop: (target: ConferenceParticipantDropTarget) => Promise<void>;
+    /** Confirms and invokes the currently selected Customer Drop. */
+    confirmParticipantDrop: () => Promise<void>;
+    /** Cancels the currently selected Customer Drop. */
+    cancelParticipantDropConfirmation: () => void;
     /** Fetch paginated address book entries for dial numbers */
     getAddressBookEntries?: FetchPaginatedList<AddressBookEntry>;
     /** Fetch paginated entry points */
@@ -433,14 +467,32 @@ export interface ControlProps {
      * Agent ID of the logged-in user
      */
     agentId: string;
+    /**
+     * Host init flag `enableWxBetterTogether` (`webexConfig.cc.enableWxBetterTogether`) for wxApp
+     * thick-client main-bar Mute/Keypad visibility gating and wxApp mute seed gate.
+     */
+    enableWxBetterTogether?: boolean;
+    /**
+     * Logged-in agent device type (BROWSER, EXTENSION, AGENT_DN) for Extension-only ghost control suppression.
+     */
+    agentDeviceType?: string;
 }
-export type CallControlComponentProps = Pick<ControlProps, 'currentTask' | 'isHeld' | 'wrapupCodes' | 'toggleHold' | 'toggleRecording' | 'toggleMute' | 'isMuted' | 'endCall' | 'wrapupCall' | 'isRecording' | 'setIsRecording' | 'buddyAgents' | 'loadingBuddyAgents' | 'loadBuddyAgents' | 'transferCall' | 'consultCall' | 'consultConference' | 'switchToMainCall' | 'switchToConsult' | 'exitConference' | 'endConsultCall' | 'consultTransfer' | 'callControlAudio' | 'consultAgentName' | 'setConsultAgentName' | 'holdTime' | 'callControlClassName' | 'callControlConsultClassName' | 'startTimestamp' | 'stateTimerLabel' | 'stateTimerTimestamp' | 'consultTimerLabel' | 'consultTimerTimestamp' | 'allowConsultToQueue' | 'lastTargetType' | 'setLastTargetType' | 'controls' | 'logger' | 'secondsUntilAutoWrapup' | 'cancelAutoWrapup' | 'conferenceParticipants' | 'getAddressBookEntries' | 'getEntryPoints' | 'getQueuesFetcher' | 'consultTransferOptions' | 'conferenceEnabled'> & {
+export type CallControlComponentProps = Pick<ControlProps, 'currentTask' | 'isHeld' | 'wrapupCodes' | 'toggleHold' | 'toggleRecording' | 'toggleMute' | 'sendDtmf' | 'isMuted' | 'endCall' | 'wrapupCall' | 'isRecording' | 'setIsRecording' | 'buddyAgents' | 'loadingBuddyAgents' | 'loadBuddyAgents' | 'transferCall' | 'consultCall' | 'consultConference' | 'switchToMainCall' | 'switchToConsult' | 'exitConference' | 'endConsultCall' | 'consultTransfer' | 'callControlAudio' | 'consultAgentName' | 'setConsultAgentName' | 'holdTime' | 'callControlClassName' | 'callControlConsultClassName' | 'startTimestamp' | 'stateTimerLabel' | 'stateTimerTimestamp' | 'consultTimerLabel' | 'consultTimerTimestamp' | 'allowConsultToQueue' | 'lastTargetType' | 'setLastTargetType' | 'controls' | 'logger' | 'secondsUntilAutoWrapup' | 'cancelAutoWrapup' | 'conferenceParticipants' | 'getAddressBookEntries' | 'getEntryPoints' | 'getQueuesFetcher' | 'consultTransferOptions' | 'conferenceEnabled'> & Partial<Pick<ControlProps, 'conferenceParticipantDropRoster' | 'pendingParticipantDropId' | 'participantDropAnnouncement' | 'participantDropConfirmationTarget' | 'participantDropConfirmationDisabled' | 'requestParticipantDrop' | 'confirmParticipantDrop' | 'cancelParticipantDropConfirmation'>> & {
     /**
      * Whether the current task is an accepted campaign preview call.
      * When `true`, the header renders the campaign icon and
      * "Campaign call" label instead of the standard media type.
      */
     isCampaignCall?: boolean;
+    /**
+     * Host init flag `enableWxBetterTogether` (`webexConfig.cc.enableWxBetterTogether`) for wxApp
+     * thick-client main-bar Mute/Keypad visibility gating and wxApp mute seed gate.
+     */
+    enableWxBetterTogether?: boolean;
+    /**
+     * Logged-in agent device type for Extension-only ghost control suppression.
+     */
+    agentDeviceType?: string;
 };
 export type OutdialAniEntry = {
     /** Unique identifier for the ANI entry */
@@ -554,11 +606,13 @@ export interface CallControlConsultComponentsProps {
     controls: TaskUIControls;
     toggleConsultMute: () => void;
     conferenceEnabled: boolean;
+    enableWxBetterTogether?: boolean;
+    currentTask?: ITask | null;
 }
 /**
  * Type representing the possible menu types in call control.
  */
-export type CallControlMenuType = 'Consult' | 'Transfer' | 'ExitConference';
+export type CallControlMenuType = 'Consult' | 'Transfer' | 'ExitConference' | 'Keypad';
 export declare const MEDIA_CHANNEL: {
     readonly EMAIL: "email";
     readonly CHAT: "chat";

package/dist/types/index.d.ts

@@ -11,7 +11,9 @@ import CampaignTaskComponent from './components/task/CampaignTask/campaign-task'
 import RealTimeTranscriptComponent from './components/task/RealTimeTranscript/real-time-transcript';
 import E911Modal from './components/StationLogin/E911Modal/e911-modal';
 import AIAssistantComponent from './components/AIAssistant/ai-assistant';
-export { UserStateComponent, StationLoginComponent, CallControlComponent, CallControlCADComponent, IncomingTaskComponent, TaskListComponent, OutdialCallComponent, CampaignErrorDialogComponent, CampaignCountdownComponent, CampaignTaskComponent, RealTimeTranscriptComponent, E911Modal, AIAssistantComponent, };
+import TelephonyActionToast from './components/task/TelephonyActionToast/telephony-action-toast';
+import WxAppOfferActionError from './components/task/WxAppOfferActionError/wxapp-offer-action-error';
+export { UserStateComponent, StationLoginComponent, CallControlComponent, CallControlCADComponent, IncomingTaskComponent, TaskListComponent, OutdialCallComponent, CampaignErrorDialogComponent, CampaignCountdownComponent, CampaignTaskComponent, RealTimeTranscriptComponent, E911Modal, AIAssistantComponent, TelephonyActionToast, WxAppOfferActionError, };
 export * from './components/StationLogin/constants';
 export * from './components/StationLogin/E911Modal/e911-modal.types';
 export * from './components/StationLogin/station-login.types';
@@ -20,3 +22,4 @@ export * from './components/task/task.types';
 export * from './components/task/CampaignErrorDialog/campaign-error-dialog.types';
 export * from './components/task/CampaignCountdown/campaign-countdown.types';
 export * from './components/AIAssistant/ai-assistant.types';
+export { isWxAppEngagedCall, shouldShowWxAppTelephonyControls } from './utils/wxapp-telephony.utils';

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

@@ -1,5 +1,6 @@
 import { MediaInfo } from '../components/task/task.types';
 import type { MEDIA_CHANNEL as MediaChannelType } from '../components/task/task.types';
+export { isWxAppEngagedCall, shouldShowWxAppTelephonyControls } from './wxapp-telephony.utils';
 export declare const formatTime: (time: number) => string;
 /**
  * Returns media information (icon, class, label, and brand visual flag)

package/dist/types/utils/wxapp-telephony.utils.d.ts

@@ -0,0 +1,12 @@
+import { ITask } from '@webex/cc-store';
+/**
+ * Returns true when the task represents an active wxApp thick-client telephony session.
+ * Visibility gate only — does not route mute or DTMF SDK calls.
+ */
+export declare const isWxAppEngagedCall: (task: ITask | null | undefined) => boolean;
+/**
+ * Thick-client main-bar Mute/Keypad visibility gate.
+ * Requires `enableWxBetterTogether` (host init flag at `webexConfig.cc.enableWxBetterTogether`)
+ * and an engaged wxApp call id on the task.
+ */
+export declare const shouldShowWxAppTelephonyControls: (enableWxBetterTogether: boolean, task: ITask | null | undefined) => boolean;