@webex/contact-center 3.12.0 → 3.13.0-next.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.repo-context.json +704 -0
- package/.sdd/manifest.json +1613 -0
- package/AGENTS.md +969 -0
- package/dist/cc.js +1102 -47
- package/dist/cc.js.map +1 -1
- package/dist/config.js +13 -0
- package/dist/config.js.map +1 -1
- package/dist/constants.js +46 -3
- package/dist/constants.js.map +1 -1
- package/dist/index.js +86 -17
- package/dist/index.js.map +1 -1
- package/dist/metrics/MetricsManager.js +16 -0
- package/dist/metrics/MetricsManager.js.map +1 -1
- package/dist/metrics/behavioral-events.js +211 -0
- package/dist/metrics/behavioral-events.js.map +1 -1
- package/dist/metrics/constants.js +58 -4
- package/dist/metrics/constants.js.map +1 -1
- package/dist/services/AddressBook.js +18 -15
- package/dist/services/AddressBook.js.map +1 -1
- package/dist/services/AnswerCallOnWebexService.js +202 -0
- package/dist/services/AnswerCallOnWebexService.js.map +1 -0
- package/dist/services/ApiAiAssistant.js +369 -14
- package/dist/services/ApiAiAssistant.js.map +1 -1
- package/dist/services/EntryPoint.js +46 -68
- package/dist/services/EntryPoint.js.map +1 -1
- package/dist/services/Queue.js +27 -22
- package/dist/services/Queue.js.map +1 -1
- package/dist/services/UserPreference.js +427 -0
- package/dist/services/UserPreference.js.map +1 -0
- package/dist/services/WebCallingService.js +287 -37
- package/dist/services/WebCallingService.js.map +1 -1
- package/dist/services/WebexCrossClientService.js +225 -0
- package/dist/services/WebexCrossClientService.js.map +1 -0
- package/dist/services/WxAppTelephonyMercurySync.js +111 -0
- package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
- package/dist/services/config/Util.js +48 -48
- package/dist/services/config/Util.js.map +1 -1
- package/dist/services/config/constants.js +57 -79
- package/dist/services/config/constants.js.map +1 -1
- package/dist/services/config/index.js +100 -226
- package/dist/services/config/index.js.map +1 -1
- package/dist/services/config/types.js +100 -40
- package/dist/services/config/types.js.map +1 -1
- package/dist/services/constants.js +19 -1
- package/dist/services/constants.js.map +1 -1
- package/dist/services/core/Err.js.map +1 -1
- package/dist/services/core/Utils.js +131 -32
- package/dist/services/core/Utils.js.map +1 -1
- package/dist/services/core/WebexRequest.js +6 -2
- package/dist/services/core/WebexRequest.js.map +1 -1
- package/dist/services/core/aqm-reqs.js +17 -11
- package/dist/services/core/aqm-reqs.js.map +1 -1
- package/dist/services/core/constants.js +9 -1
- package/dist/services/core/constants.js.map +1 -1
- package/dist/services/core/types.js.map +1 -1
- package/dist/services/core/websocket/WebSocketManager.js +26 -6
- package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
- package/dist/services/core/websocket/connection-service.js +3 -1
- package/dist/services/core/websocket/connection-service.js.map +1 -1
- package/dist/services/core/websocket/types.js.map +1 -1
- package/dist/services/index.js +6 -0
- package/dist/services/index.js.map +1 -1
- package/dist/services/task/Task.js +955 -0
- package/dist/services/task/Task.js.map +1 -0
- package/dist/services/task/TaskFactory.js +50 -0
- package/dist/services/task/TaskFactory.js.map +1 -0
- package/dist/services/task/TaskManager.js +1275 -504
- package/dist/services/task/TaskManager.js.map +1 -1
- package/dist/services/task/TaskUtils.js +221 -27
- package/dist/services/task/TaskUtils.js.map +1 -1
- package/dist/services/task/WebexCallingUtils.js +70 -0
- package/dist/services/task/WebexCallingUtils.js.map +1 -0
- package/dist/services/task/constants.js +22 -2
- package/dist/services/task/constants.js.map +1 -1
- package/dist/services/task/contact.js +29 -0
- package/dist/services/task/contact.js.map +1 -1
- package/dist/services/task/dialer.js +78 -0
- package/dist/services/task/dialer.js.map +1 -1
- package/dist/services/task/digital/Digital.js +78 -0
- package/dist/services/task/digital/Digital.js.map +1 -0
- package/dist/services/task/state-machine/TaskStateMachine.js +982 -0
- package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -0
- package/dist/services/task/state-machine/actions.js +572 -0
- package/dist/services/task/state-machine/actions.js.map +1 -0
- package/dist/services/task/state-machine/constants.js +161 -0
- package/dist/services/task/state-machine/constants.js.map +1 -0
- package/dist/services/task/state-machine/guards.js +379 -0
- package/dist/services/task/state-machine/guards.js.map +1 -0
- package/dist/services/task/state-machine/index.js +53 -0
- package/dist/services/task/state-machine/index.js.map +1 -0
- package/dist/services/task/state-machine/types.js +54 -0
- package/dist/services/task/state-machine/types.js.map +1 -0
- package/dist/services/task/state-machine/uiControlsComputer.js +703 -0
- package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -0
- package/dist/services/task/taskDataNormalizer.js +99 -0
- package/dist/services/task/taskDataNormalizer.js.map +1 -0
- package/dist/services/task/types.js +259 -5
- package/dist/services/task/types.js.map +1 -1
- package/dist/services/task/voice/Voice.js +1504 -0
- package/dist/services/task/voice/Voice.js.map +1 -0
- package/dist/services/task/voice/WebRTC.js +152 -0
- package/dist/services/task/voice/WebRTC.js.map +1 -0
- package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
- package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
- package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
- package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
- package/dist/services/wxAppDiagnosticLogging.js +159 -0
- package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
- package/dist/services/wxAppTelephonyUtils.js +19 -0
- package/dist/services/wxAppTelephonyUtils.js.map +1 -0
- package/dist/types/cc.d.ts +222 -10
- package/dist/types/config.d.ts +13 -0
- package/dist/types/constants.d.ts +40 -1
- package/dist/types/index.d.ts +58 -22
- package/dist/types/metrics/MetricsManager.d.ts +6 -0
- package/dist/types/metrics/constants.d.ts +52 -1
- package/dist/types/services/AddressBook.d.ts +2 -1
- package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
- package/dist/types/services/ApiAiAssistant.d.ts +67 -5
- package/dist/types/services/EntryPoint.d.ts +7 -5
- package/dist/types/services/Queue.d.ts +5 -3
- package/dist/types/services/UserPreference.d.ts +118 -0
- package/dist/types/services/WebexCrossClientService.d.ts +32 -0
- package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
- package/dist/types/services/config/Util.d.ts +4 -8
- package/dist/types/services/config/constants.d.ts +49 -76
- package/dist/types/services/config/index.d.ts +16 -64
- package/dist/types/services/config/types.d.ts +252 -114
- package/dist/types/services/constants.d.ts +16 -0
- package/dist/types/services/core/Err.d.ts +6 -0
- package/dist/types/services/core/Utils.d.ts +43 -13
- package/dist/types/services/core/WebexRequest.d.ts +1 -0
- package/dist/types/services/core/constants.d.ts +7 -0
- package/dist/types/services/core/types.d.ts +2 -0
- package/dist/types/services/core/websocket/WebSocketManager.d.ts +2 -0
- package/dist/types/services/core/websocket/types.d.ts +1 -1
- package/dist/types/services/index.d.ts +2 -0
- package/dist/types/services/task/Task.d.ts +186 -0
- package/dist/types/services/task/TaskFactory.d.ts +14 -0
- package/dist/types/services/task/TaskUtils.d.ts +54 -2
- package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
- package/dist/types/services/task/constants.d.ts +20 -0
- package/dist/types/services/task/contact.d.ts +4 -0
- package/dist/types/services/task/dialer.d.ts +30 -0
- package/dist/types/services/task/digital/Digital.d.ts +23 -0
- package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +1442 -0
- package/dist/types/services/task/state-machine/actions.d.ts +10 -0
- package/dist/types/services/task/state-machine/constants.d.ts +107 -0
- package/dist/types/services/task/state-machine/guards.d.ts +103 -0
- package/dist/types/services/task/state-machine/index.d.ts +13 -0
- package/dist/types/services/task/state-machine/types.d.ts +277 -0
- package/dist/types/services/task/state-machine/uiControlsComputer.d.ts +9 -0
- package/dist/types/services/task/taskDataNormalizer.d.ts +10 -0
- package/dist/types/services/task/types.d.ts +790 -66
- package/dist/types/services/task/voice/Voice.d.ts +241 -0
- package/dist/types/services/task/voice/WebRTC.d.ts +54 -0
- package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
- package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
- package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
- package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
- package/dist/types/types.d.ts +258 -11
- package/dist/types/utils/PageCache.d.ts +20 -3
- package/dist/types/webex.d.ts +1 -0
- package/dist/types.js +204 -6
- package/dist/types.js.map +1 -1
- package/dist/utils/PageCache.js +19 -5
- package/dist/utils/PageCache.js.map +1 -1
- package/dist/webex.js +22 -2
- package/dist/webex.js.map +1 -1
- package/docs/adr/0001-spec-source-policy.md +97 -0
- package/docs/adr/0002-consult-transfer-list-policy.md +345 -0
- package/docs/adr/0003-repo-standards-migration.md +104 -0
- package/docs/adr/index.md +35 -0
- package/docs/architecture.md +460 -0
- package/docs/getting-started.md +142 -0
- package/docs/index.md +53 -0
- package/docs/specs/README.md +98 -0
- package/package.json +17 -12
- package/schemas/repo-context.schema.json +796 -0
- package/src/cc.ts +1439 -105
- package/src/config.ts +13 -0
- package/src/constants.ts +53 -1
- package/src/docs/README.md +727 -0
- package/src/index.ts +72 -16
- package/src/metrics/MetricsManager.ts +16 -0
- package/src/metrics/behavioral-events.ts +218 -0
- package/src/metrics/constants.ts +63 -4
- package/src/metrics/docs/README.md +710 -0
- package/src/services/AddressBook.ts +17 -6
- package/src/services/AnswerCallOnWebexService.ts +239 -0
- package/src/services/ApiAiAssistant.ts +494 -15
- package/src/services/EntryPoint.ts +59 -60
- package/src/services/Queue.ts +29 -12
- package/src/services/UserPreference.ts +509 -0
- package/src/services/WebCallingService.ts +362 -40
- package/src/services/WebexCrossClientService.ts +298 -0
- package/src/services/WxAppTelephonyMercurySync.ts +142 -0
- package/src/services/agent/docs/README.md +673 -0
- package/src/services/config/Util.ts +54 -84
- package/src/services/config/constants.ts +64 -86
- package/src/services/config/docs/README.md +530 -0
- package/src/services/config/index.ts +116 -277
- package/src/services/config/types.ts +238 -125
- package/src/services/constants.ts +18 -0
- package/src/services/core/Err.ts +3 -0
- package/src/services/core/Utils.ts +151 -37
- package/src/services/core/WebexRequest.ts +3 -1
- package/src/services/core/aqm-reqs.ts +18 -12
- package/src/services/core/constants.ts +8 -0
- package/src/services/core/docs/README.md +993 -0
- package/src/services/core/types.ts +33 -1
- package/src/services/core/websocket/WebSocketManager.ts +37 -8
- package/src/services/core/websocket/connection-service.ts +5 -1
- package/src/services/core/websocket/types.ts +1 -1
- package/src/services/docs/README.md +765 -0
- package/src/services/index.ts +4 -0
- package/src/services/task/Task.ts +1211 -0
- package/src/services/task/TaskFactory.ts +82 -0
- package/src/services/task/TaskManager.ts +1551 -584
- package/src/services/task/TaskUtils.ts +316 -25
- package/src/services/task/WebexCallingUtils.ts +136 -0
- package/src/services/task/constants.ts +21 -0
- package/src/services/task/contact.ts +30 -0
- package/src/services/task/dialer.ts +80 -0
- package/src/services/task/digital/Digital.ts +102 -0
- package/src/services/task/docs/README.md +1569 -0
- package/src/services/task/state-machine/TaskStateMachine.ts +1320 -0
- package/src/services/task/state-machine/actions.ts +741 -0
- package/src/services/task/state-machine/constants.ts +172 -0
- package/src/services/task/state-machine/docs/README.md +1388 -0
- package/src/services/task/state-machine/guards.ts +442 -0
- package/src/services/task/state-machine/index.ts +28 -0
- package/src/services/task/state-machine/types.ts +258 -0
- package/src/services/task/state-machine/uiControlsComputer.ts +1135 -0
- package/src/services/task/taskDataNormalizer.ts +137 -0
- package/src/services/task/types.ts +974 -70
- package/src/services/task/voice/Voice.ts +1878 -0
- package/src/services/task/voice/WebRTC.ts +194 -0
- package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
- package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
- package/src/services/wxAppDiagnosticLogging.ts +286 -0
- package/src/services/wxAppTelephonyUtils.ts +14 -0
- package/src/types.ts +323 -13
- package/src/utils/AGENTS.md +291 -0
- package/src/utils/PageCache.ts +38 -5
- package/src/utils/docs/README.md +413 -0
- package/src/webex.js +10 -0
- package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
- package/test/unit/spec/cc.ts +4046 -181
- package/test/unit/spec/index.ts +891 -0
- package/test/unit/spec/logger-proxy.ts +70 -0
- package/test/unit/spec/metrics/MetricsManager.ts +25 -0
- package/test/unit/spec/metrics/behavioral-events.ts +60 -0
- package/test/unit/spec/services/AddressBook.ts +37 -6
- package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
- package/test/unit/spec/services/ApiAiAssistant.ts +442 -23
- package/test/unit/spec/services/EntryPoint.ts +87 -40
- package/test/unit/spec/services/Queue.ts +123 -12
- package/test/unit/spec/services/UserPreference.ts +401 -0
- package/test/unit/spec/services/WebCallingService.ts +484 -49
- package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
- package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
- package/test/unit/spec/services/config/Util.ts +501 -0
- package/test/unit/spec/services/config/index.ts +318 -548
- package/test/unit/spec/services/core/Utils.ts +447 -8
- package/test/unit/spec/services/core/WebexRequest.ts +8 -7
- package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
- package/test/unit/spec/services/core/websocket/WebSocketManager.ts +132 -56
- package/test/unit/spec/services/core/websocket/connection-service.ts +3 -1
- package/test/unit/spec/services/task/AutoWrapup.ts +63 -0
- package/test/unit/spec/services/task/Task.ts +2723 -0
- package/test/unit/spec/services/task/TaskFactory.ts +116 -0
- package/test/unit/spec/services/task/TaskManager.ts +4800 -1586
- package/test/unit/spec/services/task/TaskUtils.ts +307 -0
- package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
- package/test/unit/spec/services/task/contact.ts +33 -0
- package/test/unit/spec/services/task/dialer.ts +190 -0
- package/test/unit/spec/services/task/digital/Digital.ts +105 -0
- package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +4060 -0
- package/test/unit/spec/services/task/state-machine/guards.ts +839 -0
- package/test/unit/spec/services/task/state-machine/types.ts +18 -0
- package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +3101 -0
- package/test/unit/spec/services/task/taskTestUtils.ts +87 -0
- package/test/unit/spec/services/task/voice/Voice.ts +2355 -0
- package/test/unit/spec/services/task/voice/WebRTC.ts +235 -0
- package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
- package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
- package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
- package/test/unit/spec/wellnessSampleUtils.ts +288 -0
- package/typedoc.md +1 -1
- package/umd/contact-center.min.js +2 -2
- package/umd/contact-center.min.js.map +1 -1
- package/dist/services/task/index.js +0 -1525
- package/dist/services/task/index.js.map +0 -1
- package/dist/types/services/task/index.d.ts +0 -650
- package/src/services/task/index.ts +0 -1801
- package/test/unit/spec/services/task/index.ts +0 -2184
|
@@ -74,7 +74,8 @@ export class AddressBook {
|
|
|
74
74
|
|
|
75
75
|
/**
|
|
76
76
|
* Fetches address book entries for a specific address book using the entry API
|
|
77
|
-
* @param {AddressBookEntrySearchParams} [params] - Search and
|
|
77
|
+
* @param {AddressBookEntrySearchParams} [params] - Search, pagination, and optional sort parameters
|
|
78
|
+
* including addressBookId. Sorting defaults to name ascending.
|
|
78
79
|
* @returns {Promise<AddressBookEntriesResponse>} Promise resolving to address book entries
|
|
79
80
|
* @throws {Error} If the API call fails
|
|
80
81
|
* @public
|
|
@@ -102,12 +103,21 @@ export class AddressBook {
|
|
|
102
103
|
search,
|
|
103
104
|
filter,
|
|
104
105
|
attributes,
|
|
106
|
+
sortBy = 'name',
|
|
107
|
+
sortOrder = 'asc',
|
|
105
108
|
} = params;
|
|
106
109
|
|
|
107
110
|
// Use provided addressBookId or fall back to agent's address book
|
|
108
111
|
const bookId = addressBookId || this.getAddressBookId();
|
|
109
112
|
const orgId = this.webex.credentials.getOrgId();
|
|
110
|
-
const
|
|
113
|
+
const hasCustomSort = sortBy !== 'name' || sortOrder !== 'asc';
|
|
114
|
+
const isSearchRequest = !!(search || filter || attributes || hasCustomSort);
|
|
115
|
+
const canUseCache = this.pageCache.canUseCache({
|
|
116
|
+
search,
|
|
117
|
+
filter,
|
|
118
|
+
attributes,
|
|
119
|
+
sortBy: hasCustomSort ? sortBy : undefined,
|
|
120
|
+
});
|
|
111
121
|
|
|
112
122
|
LoggerProxy.info('Fetching address book entries', {
|
|
113
123
|
module: 'AddressBook',
|
|
@@ -121,8 +131,8 @@ export class AddressBook {
|
|
|
121
131
|
},
|
|
122
132
|
});
|
|
123
133
|
|
|
124
|
-
//
|
|
125
|
-
if (
|
|
134
|
+
// Default name-ascending pagination is cache-compatible; result-changing overrides are not.
|
|
135
|
+
if (canUseCache) {
|
|
126
136
|
const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);
|
|
127
137
|
const cachedPage = this.pageCache.getCachedPage(cacheKey);
|
|
128
138
|
|
|
@@ -190,6 +200,7 @@ export class AddressBook {
|
|
|
190
200
|
if (filter) queryParams.append('filter', filter);
|
|
191
201
|
if (attributes) queryParams.append('attributes', attributes);
|
|
192
202
|
if (search) queryParams.append('search', search);
|
|
203
|
+
if (sortBy) queryParams.append('sort', `${sortBy},${sortOrder.toUpperCase()}`);
|
|
193
204
|
|
|
194
205
|
const resource = endPointMap.addressBookEntries(orgId, bookId, queryParams.toString());
|
|
195
206
|
|
|
@@ -244,8 +255,8 @@ export class AddressBook {
|
|
|
244
255
|
);
|
|
245
256
|
}
|
|
246
257
|
|
|
247
|
-
// Cache the
|
|
248
|
-
if (
|
|
258
|
+
// Cache only the invariant default-order pagination shape.
|
|
259
|
+
if (canUseCache && response.body?.data) {
|
|
249
260
|
const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);
|
|
250
261
|
this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);
|
|
251
262
|
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import LoggerProxy from '../logger-proxy';
|
|
2
|
+
import {CC_FILE, METHODS} from '../constants';
|
|
3
|
+
import {HTTP_METHODS, IHttpResponse, WebexSDK} from '../types';
|
|
4
|
+
import {getErrorDetails} from './core/Utils';
|
|
5
|
+
import {isWxAppCallNotFoundError} from './wxAppTelephonyUtils';
|
|
6
|
+
|
|
7
|
+
const ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';
|
|
8
|
+
|
|
9
|
+
export type WxAppTelephonyError = Error & {
|
|
10
|
+
isWxAppTelephonyError: true;
|
|
11
|
+
trackingId?: string;
|
|
12
|
+
status?: number | string;
|
|
13
|
+
};
|
|
14
|
+
|
|
15
|
+
const extractWxAppTrackingId = (source: unknown): string | undefined => {
|
|
16
|
+
const sourceObj = source as {details?: {trackingId?: string}; trackingId?: string};
|
|
17
|
+
|
|
18
|
+
return sourceObj?.details?.trackingId || sourceObj?.trackingId;
|
|
19
|
+
};
|
|
20
|
+
|
|
21
|
+
const extractWxAppHttpStatus = (source: unknown): number | string | undefined => {
|
|
22
|
+
const obj = source as {
|
|
23
|
+
statusCode?: number;
|
|
24
|
+
status?: number | string;
|
|
25
|
+
details?: {status?: number | string};
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
return obj?.statusCode ?? obj?.status ?? obj?.details?.status;
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
const markWxAppTelephonyError = (error: Error, source: unknown): WxAppTelephonyError => {
|
|
32
|
+
const marked = error as WxAppTelephonyError;
|
|
33
|
+
marked.isWxAppTelephonyError = true;
|
|
34
|
+
const trackingId = extractWxAppTrackingId(source);
|
|
35
|
+
if (trackingId) {
|
|
36
|
+
marked.trackingId = trackingId;
|
|
37
|
+
}
|
|
38
|
+
const status = extractWxAppHttpStatus(source);
|
|
39
|
+
if (status !== undefined) {
|
|
40
|
+
marked.status = status;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
return marked;
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
export type AnswerCallParams = {
|
|
47
|
+
callId: string;
|
|
48
|
+
endpointId: string;
|
|
49
|
+
lineOwnerId?: string;
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
export type CallIdParams = {
|
|
53
|
+
callId: string;
|
|
54
|
+
lineOwnerId?: string;
|
|
55
|
+
};
|
|
56
|
+
|
|
57
|
+
export type TransmitDtmfParams = CallIdParams & {
|
|
58
|
+
dtmf: string;
|
|
59
|
+
};
|
|
60
|
+
|
|
61
|
+
export type CallDetailsResponse = {
|
|
62
|
+
muted?: boolean;
|
|
63
|
+
};
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* REST telephony client for wxApp thick-client answer (WXCC-6026).
|
|
67
|
+
* Separate from WebCallingService (WebRTC/Mobius).
|
|
68
|
+
*/
|
|
69
|
+
export default class AnswerCallOnWebexService {
|
|
70
|
+
private webex: WebexSDK;
|
|
71
|
+
|
|
72
|
+
constructor(webex: WebexSDK) {
|
|
73
|
+
this.webex = webex;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
private getTelephonyBaseUrl(): string {
|
|
77
|
+
const services = this.webex.internal.services;
|
|
78
|
+
const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');
|
|
79
|
+
|
|
80
|
+
if (!hydraUrl) {
|
|
81
|
+
throw new Error('Telephony base URL is unavailable');
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
return `${hydraUrl.replace(/\/$/, '')}/telephony/calls`;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
private extractTrackingId(source: unknown): string | undefined {
|
|
88
|
+
return extractWxAppTrackingId(source);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
private async telephonyRequest(
|
|
92
|
+
resource: string,
|
|
93
|
+
method: HTTP_METHODS,
|
|
94
|
+
body: Record<string, unknown>,
|
|
95
|
+
logMethod: string
|
|
96
|
+
): Promise<IHttpResponse> {
|
|
97
|
+
try {
|
|
98
|
+
const uri = `${this.getTelephonyBaseUrl()}${resource}`;
|
|
99
|
+
|
|
100
|
+
LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} request`, {
|
|
101
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
102
|
+
method: logMethod,
|
|
103
|
+
data: {uri, bodyKeys: Object.keys(body)},
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
const response = (await this.webex.request({
|
|
107
|
+
uri,
|
|
108
|
+
method,
|
|
109
|
+
body,
|
|
110
|
+
addAuthHeader: true,
|
|
111
|
+
})) as IHttpResponse;
|
|
112
|
+
|
|
113
|
+
LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} success`, {
|
|
114
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
115
|
+
method: logMethod,
|
|
116
|
+
data: {statusCode: response.statusCode},
|
|
117
|
+
});
|
|
118
|
+
|
|
119
|
+
return response;
|
|
120
|
+
} catch (error) {
|
|
121
|
+
const trackingId = this.extractTrackingId(error);
|
|
122
|
+
LoggerProxy.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {
|
|
123
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
124
|
+
method: logMethod,
|
|
125
|
+
data: {
|
|
126
|
+
trackingId,
|
|
127
|
+
status: extractWxAppHttpStatus(error),
|
|
128
|
+
},
|
|
129
|
+
});
|
|
130
|
+
const {error: detailedError} = getErrorDetails(error, logMethod, CC_FILE);
|
|
131
|
+
throw markWxAppTelephonyError(detailedError, error);
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
public answerCall(params: AnswerCallParams): Promise<IHttpResponse> {
|
|
136
|
+
const {callId, endpointId, lineOwnerId} = params;
|
|
137
|
+
|
|
138
|
+
return this.telephonyRequest(
|
|
139
|
+
'/answer',
|
|
140
|
+
HTTP_METHODS.POST,
|
|
141
|
+
{
|
|
142
|
+
callId,
|
|
143
|
+
endpointId,
|
|
144
|
+
...(lineOwnerId ? {lineOwnerId} : {}),
|
|
145
|
+
},
|
|
146
|
+
METHODS.ACCEPT
|
|
147
|
+
);
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
public rejectCall(params: CallIdParams): Promise<IHttpResponse> {
|
|
151
|
+
const {callId, lineOwnerId} = params;
|
|
152
|
+
|
|
153
|
+
return this.telephonyRequest(
|
|
154
|
+
'/reject',
|
|
155
|
+
HTTP_METHODS.POST,
|
|
156
|
+
{callId, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
157
|
+
METHODS.REJECT
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
public muteCall(params: CallIdParams): Promise<IHttpResponse> {
|
|
162
|
+
const {callId, lineOwnerId} = params;
|
|
163
|
+
|
|
164
|
+
return this.telephonyRequest(
|
|
165
|
+
'/mute',
|
|
166
|
+
HTTP_METHODS.POST,
|
|
167
|
+
{callId, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
168
|
+
METHODS.TOGGLE_MUTE
|
|
169
|
+
);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
public unmuteCall(params: CallIdParams): Promise<IHttpResponse> {
|
|
173
|
+
const {callId, lineOwnerId} = params;
|
|
174
|
+
|
|
175
|
+
return this.telephonyRequest(
|
|
176
|
+
'/unmute',
|
|
177
|
+
HTTP_METHODS.POST,
|
|
178
|
+
{callId, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
179
|
+
METHODS.TOGGLE_MUTE
|
|
180
|
+
);
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
public transmitDtmf(params: TransmitDtmfParams): Promise<IHttpResponse> {
|
|
184
|
+
const {callId, dtmf, lineOwnerId} = params;
|
|
185
|
+
|
|
186
|
+
return this.telephonyRequest(
|
|
187
|
+
'/transmitDtmf',
|
|
188
|
+
HTTP_METHODS.POST,
|
|
189
|
+
{callId, dtmf, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
190
|
+
METHODS.TRANSMIT_DTMF
|
|
191
|
+
);
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
public async getCallDetails(params: CallIdParams): Promise<CallDetailsResponse> {
|
|
195
|
+
const {callId, lineOwnerId} = params;
|
|
196
|
+
const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';
|
|
197
|
+
const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;
|
|
198
|
+
|
|
199
|
+
try {
|
|
200
|
+
LoggerProxy.log('AnswerCallOnWebexService.getCallDetails request', {
|
|
201
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
202
|
+
method: METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
203
|
+
data: {callIdSuffix: callId.length <= 8 ? callId : callId.slice(-8)},
|
|
204
|
+
});
|
|
205
|
+
|
|
206
|
+
const response = (await this.webex.request({
|
|
207
|
+
uri,
|
|
208
|
+
method: HTTP_METHODS.GET,
|
|
209
|
+
addAuthHeader: true,
|
|
210
|
+
})) as IHttpResponse;
|
|
211
|
+
|
|
212
|
+
return (response.body ?? {}) as CallDetailsResponse;
|
|
213
|
+
} catch (error) {
|
|
214
|
+
if (isWxAppCallNotFoundError(error)) {
|
|
215
|
+
const err =
|
|
216
|
+
error instanceof Error
|
|
217
|
+
? error
|
|
218
|
+
: new Error(String((error as {message?: string})?.message ?? error));
|
|
219
|
+
throw markWxAppTelephonyError(err, error);
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
const trackingId = this.extractTrackingId(error);
|
|
223
|
+
LoggerProxy.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {
|
|
224
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
225
|
+
method: METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
226
|
+
data: {
|
|
227
|
+
trackingId,
|
|
228
|
+
status: extractWxAppHttpStatus(error),
|
|
229
|
+
},
|
|
230
|
+
});
|
|
231
|
+
const {error: detailedError} = getErrorDetails(
|
|
232
|
+
error,
|
|
233
|
+
METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
234
|
+
CC_FILE
|
|
235
|
+
);
|
|
236
|
+
throw markWxAppTelephonyError(detailedError, error);
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
}
|