@app-connect/core 1.7.25 → 1.7.27

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.
Files changed (138) hide show
  1. package/.env.test +5 -5
  2. package/README.md +441 -441
  3. package/connector/developerPortal.js +31 -31
  4. package/connector/mock.js +84 -77
  5. package/connector/proxy/engine.js +164 -164
  6. package/connector/proxy/index.js +500 -500
  7. package/connector/registry.js +252 -252
  8. package/docs/README.md +50 -50
  9. package/docs/architecture.md +93 -93
  10. package/docs/connectors.md +116 -116
  11. package/docs/handlers.md +125 -125
  12. package/docs/libraries.md +101 -101
  13. package/docs/models.md +144 -144
  14. package/docs/routes.md +115 -115
  15. package/docs/tests.md +73 -73
  16. package/handlers/admin.js +523 -523
  17. package/handlers/appointment.js +193 -0
  18. package/handlers/auth.js +320 -296
  19. package/handlers/calldown.js +99 -99
  20. package/handlers/contact.js +280 -280
  21. package/handlers/disposition.js +82 -80
  22. package/handlers/log.js +990 -973
  23. package/handlers/managedAuth.js +446 -446
  24. package/handlers/managedOAuth.js +247 -0
  25. package/handlers/plugin.js +208 -208
  26. package/handlers/user.js +142 -142
  27. package/index.js +3162 -2652
  28. package/jest.config.js +56 -56
  29. package/lib/analytics.js +54 -54
  30. package/lib/authSession.js +109 -109
  31. package/lib/cacheCleanup.js +21 -0
  32. package/lib/callLogComposer.js +898 -898
  33. package/lib/callLogLookup.js +34 -0
  34. package/lib/constants.js +8 -8
  35. package/lib/debugTracer.js +177 -177
  36. package/lib/encode.js +30 -30
  37. package/lib/errorHandler.js +218 -206
  38. package/lib/generalErrorMessage.js +41 -41
  39. package/lib/jwt.js +18 -18
  40. package/lib/logger.js +190 -190
  41. package/lib/migrateCallLogsSchema.js +116 -0
  42. package/lib/ringcentral.js +266 -266
  43. package/lib/s3ErrorLogReport.js +65 -65
  44. package/lib/sharedSMSComposer.js +471 -471
  45. package/lib/util.js +67 -67
  46. package/mcp/README.md +412 -395
  47. package/mcp/lib/validator.js +91 -91
  48. package/mcp/mcpHandler.js +425 -425
  49. package/mcp/tools/cancelAppointment.js +101 -0
  50. package/mcp/tools/checkAuthStatus.js +105 -105
  51. package/mcp/tools/confirmAppointment.js +101 -0
  52. package/mcp/tools/createAppointment.js +157 -0
  53. package/mcp/tools/createCallLog.js +327 -316
  54. package/mcp/tools/createContact.js +117 -117
  55. package/mcp/tools/createMessageLog.js +287 -287
  56. package/mcp/tools/doAuth.js +60 -60
  57. package/mcp/tools/findContactByName.js +93 -93
  58. package/mcp/tools/findContactByPhone.js +101 -101
  59. package/mcp/tools/getCallLog.js +111 -102
  60. package/mcp/tools/getGoogleFilePicker.js +99 -99
  61. package/mcp/tools/getHelp.js +43 -43
  62. package/mcp/tools/getPublicConnectors.js +94 -94
  63. package/mcp/tools/getSessionInfo.js +90 -90
  64. package/mcp/tools/index.js +51 -41
  65. package/mcp/tools/listAppointments.js +163 -0
  66. package/mcp/tools/logout.js +99 -96
  67. package/mcp/tools/rcGetCallLogs.js +65 -65
  68. package/mcp/tools/updateAppointment.js +154 -0
  69. package/mcp/tools/updateCallLog.js +130 -126
  70. package/mcp/ui/App/App.tsx +358 -358
  71. package/mcp/ui/App/components/AuthInfoForm.tsx +113 -113
  72. package/mcp/ui/App/components/AuthSuccess.tsx +22 -22
  73. package/mcp/ui/App/components/ConnectorList.tsx +82 -82
  74. package/mcp/ui/App/components/DebugPanel.tsx +43 -43
  75. package/mcp/ui/App/components/OAuthConnect.tsx +270 -270
  76. package/mcp/ui/App/lib/callTool.ts +130 -130
  77. package/mcp/ui/App/lib/debugLog.ts +41 -41
  78. package/mcp/ui/App/lib/developerPortal.ts +111 -111
  79. package/mcp/ui/App/main.css +5 -5
  80. package/mcp/ui/App/root.tsx +13 -13
  81. package/mcp/ui/index.html +13 -13
  82. package/mcp/ui/package-lock.json +6356 -6356
  83. package/mcp/ui/package.json +25 -25
  84. package/mcp/ui/tsconfig.json +26 -26
  85. package/mcp/ui/vite.config.ts +16 -16
  86. package/models/accountDataModel.js +33 -33
  87. package/models/adminConfigModel.js +35 -35
  88. package/models/cacheModel.js +30 -26
  89. package/models/callDownListModel.js +34 -34
  90. package/models/callLogModel.js +33 -27
  91. package/models/dynamo/connectorSchema.js +146 -146
  92. package/models/dynamo/lockSchema.js +24 -24
  93. package/models/dynamo/noteCacheSchema.js +29 -29
  94. package/models/llmSessionModel.js +17 -17
  95. package/models/messageLogModel.js +25 -25
  96. package/models/sequelize.js +16 -16
  97. package/models/userModel.js +45 -45
  98. package/package.json +1 -1
  99. package/releaseNotes.json +1101 -1081
  100. package/test/connector/proxy/engine.test.js +126 -126
  101. package/test/connector/proxy/index.test.js +279 -279
  102. package/test/connector/proxy/sample.json +161 -161
  103. package/test/connector/registry.test.js +415 -415
  104. package/test/handlers/admin.test.js +616 -616
  105. package/test/handlers/auth.test.js +1092 -1018
  106. package/test/handlers/contact.test.js +1014 -1014
  107. package/test/handlers/log.test.js +1298 -1160
  108. package/test/handlers/managedAuth.test.js +457 -457
  109. package/test/handlers/plugin.test.js +380 -380
  110. package/test/index.test.js +105 -105
  111. package/test/lib/cacheCleanup.test.js +42 -0
  112. package/test/lib/callLogComposer.test.js +1231 -1231
  113. package/test/lib/debugTracer.test.js +328 -328
  114. package/test/lib/jwt.test.js +176 -176
  115. package/test/lib/logger.test.js +206 -206
  116. package/test/lib/oauth.test.js +359 -359
  117. package/test/lib/ringcentral.test.js +467 -467
  118. package/test/lib/sharedSMSComposer.test.js +1084 -1084
  119. package/test/lib/util.test.js +329 -329
  120. package/test/mcp/tools/checkAuthStatus.test.js +83 -83
  121. package/test/mcp/tools/createCallLog.test.js +436 -436
  122. package/test/mcp/tools/createContact.test.js +58 -58
  123. package/test/mcp/tools/createMessageLog.test.js +595 -595
  124. package/test/mcp/tools/doAuth.test.js +113 -113
  125. package/test/mcp/tools/findContactByName.test.js +275 -275
  126. package/test/mcp/tools/findContactByPhone.test.js +296 -296
  127. package/test/mcp/tools/getCallLog.test.js +298 -298
  128. package/test/mcp/tools/getGoogleFilePicker.test.js +281 -281
  129. package/test/mcp/tools/getPublicConnectors.test.js +107 -107
  130. package/test/mcp/tools/getSessionInfo.test.js +127 -127
  131. package/test/mcp/tools/logout.test.js +233 -233
  132. package/test/mcp/tools/rcGetCallLogs.test.js +56 -56
  133. package/test/mcp/tools/updateCallLog.test.js +360 -360
  134. package/test/models/accountDataModel.test.js +98 -98
  135. package/test/models/dynamo/connectorSchema.test.js +189 -189
  136. package/test/models/models.test.js +568 -539
  137. package/test/routes/managedAuthRoutes.test.js +235 -104
  138. package/test/setup.js +178 -178
@@ -1,500 +1,500 @@
1
- /* eslint-disable no-param-reassign */
2
- const { parsePhoneNumber } = require('awesome-phonenumber');
3
- const moment = require('moment');
4
- const {
5
- performRequest,
6
- mapFindContactResponse,
7
- mapCreateCallLogResponse,
8
- mapGetCallLogResponse,
9
- getByPath,
10
- } = require('./engine');
11
- const { Connector } = require('../../models/dynamo/connectorSchema');
12
- const { UserModel } = require('../../models/userModel');
13
- const logger = require('../../lib/logger');
14
- const { handleDatabaseError } = require('../../lib/errorHandler');
15
-
16
- async function loadPlatformConfig(proxyId) {
17
- if (!proxyId) {
18
- return null;
19
- }
20
- try {
21
- const proxyConfig = await Connector.getProxyConfig(proxyId);
22
- return proxyConfig;
23
- } catch (error) {
24
- logger.error('Error getting proxy config: ', { proxyId, stack: error.stack });
25
- return null;
26
- }
27
- }
28
-
29
- async function getAuthType({ proxyId, proxyConfig } = {}) {
30
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(proxyId));
31
- if (!cfg) {
32
- return 'apiKey';
33
- }
34
- return cfg.auth.type || 'apiKey';
35
- }
36
-
37
- async function getOauthInfo({ proxyId, proxyConfig, tokenUrl } = {}) {
38
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(proxyId));
39
- if (!cfg) {
40
- return {};
41
- }
42
- return {
43
- clientId: cfg.auth.clientId,
44
- clientSecret: cfg.auth.clientSecret,
45
- accessTokenUri: tokenUrl || cfg.auth.tokenUrl,
46
- redirectUri: cfg.auth.redirectUri,
47
- };
48
- }
49
-
50
- function getBasicAuth({ apiKey }) {
51
- return Buffer.from(`${apiKey}:`).toString('base64');
52
- }
53
-
54
- async function getUserInfo({ authHeader, hostname, additionalInfo, platform, apiKey, proxyId, proxyConfig, userEmail } = {}) {
55
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(proxyId));
56
- if (!cfg || !cfg.operations?.getUserInfo) {
57
- // Fallback if no getUserInfo operation defined
58
- return {
59
- successful: false,
60
- returnMessage: {
61
- messageType: 'warning',
62
- message: `Could not load user information. The platform does not support getUserInfo operation.`,
63
- ttl: 1000
64
- }
65
- };
66
- }
67
- const response = await performRequest({
68
- config: cfg,
69
- opName: 'getUserInfo',
70
- inputs: {
71
- additionalInfo,
72
- apiKey,
73
- hostname,
74
- platform,
75
- userEmail,
76
- },
77
- user: {},
78
- authHeader
79
- });
80
- const map = cfg.operations.getUserInfo.responseMapping || {};
81
- const responseCtx = {
82
- body: response.data,
83
- additionalInfo,
84
- apiKey,
85
- hostname,
86
- platform,
87
- };
88
- const rawUserId = map.idPath ? getByPath(responseCtx, map.idPath) : undefined;
89
- const id = `${rawUserId}-${platform}`;
90
- const name = map.namePath ? getByPath(responseCtx, map.namePath) : rawUserId;
91
- const timezoneName = map.timezoneNamePath ? getByPath(responseCtx, map.timezoneNamePath) : undefined;
92
- const overridingApiKey = map.overridingApiKeyPath ? getByPath(responseCtx, map.overridingApiKeyPath) : undefined;
93
- // platformAdditionalInfo mapping and cleanup
94
- const platformAdditionalInfo = Object.assign({}, additionalInfo || {});
95
- if (platformAdditionalInfo.password) delete platformAdditionalInfo.password;
96
- if (map.platformAdditionalInfoPaths && typeof map.platformAdditionalInfoPaths === 'object') {
97
- for (const [key, expr] of Object.entries(map.platformAdditionalInfoPaths)) {
98
- platformAdditionalInfo[key] = getByPath(responseCtx, expr);
99
- }
100
- }
101
- const message = map.messagePath ? (getByPath(responseCtx, map.messagePath) || `Connected to ${platform}.`) : `Connected to ${platform}.`;
102
- return {
103
- successful: true,
104
- platformUserInfo: Object.assign(
105
- { id, name },
106
- timezoneName ? { timezoneName } : {},
107
- overridingApiKey ? { overridingApiKey } : {},
108
- Object.keys(platformAdditionalInfo).length ? { platformAdditionalInfo } : {}
109
- ),
110
- returnMessage: {
111
- messageType: 'success',
112
- message,
113
- ttl: 1000
114
- }
115
- };
116
- }
117
-
118
- async function getUserList({ user, authHeader, proxyConfig }) {
119
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
120
- if (!cfg.operations?.getUserList) {
121
- return [];
122
- }
123
- const response = await performRequest({
124
- config: cfg,
125
- opName: 'getUserList',
126
- inputs: { user },
127
- user,
128
- authHeader
129
- });
130
- const map = cfg.operations.getUserList.responseMapping || {};
131
- const responseCtx = { body: response.data };
132
- const userList = map.listPath ? getByPath(responseCtx, map.listPath) : [];
133
- return (userList || []).map(item => ({
134
- id: getByPath(item, map.idPath || 'id'),
135
- name: getByPath(item, map.namePath || 'name'),
136
- email: getByPath(item, map.emailPath || 'email'),
137
- }));
138
- }
139
-
140
- async function unAuthorize({ user }) {
141
- const cfg = await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId);
142
- if (cfg?.operations?.unAuthorize) {
143
- await performRequest({
144
- config: cfg,
145
- opName: 'unAuthorize',
146
- inputs: {},
147
- user,
148
- });
149
- }
150
- user.accessToken = '';
151
- user.refreshToken = '';
152
- try {
153
- await user.save();
154
- }
155
- catch (error) {
156
- return handleDatabaseError(error, 'Error saving user');
157
- }
158
- return {
159
- successful: true,
160
- returnMessage: {
161
- messageType: 'success',
162
- message: 'Logged out',
163
- ttl: 1000
164
- }
165
- };
166
- }
167
-
168
- async function findContact({ user, authHeader, phoneNumber, overridingFormat, isExtension, proxyConfig }) {
169
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
170
- if (!cfg.operations?.findContact) {
171
- return { successful: true, matchedContactInfo: [] };
172
- }
173
- let formattedPhoneNumber = phoneNumber.replace(' ', '+')
174
- const parsedPhoneNumber = parsePhoneNumber(formattedPhoneNumber);
175
- const response = await performRequest({
176
- config: cfg,
177
- opName: 'findContact',
178
- inputs: { phoneNumber, parsedPhoneNumber, overridingFormat, isExtension },
179
- user,
180
- authHeader
181
- });
182
- const matchedContactInfo = mapFindContactResponse({ config: cfg, response });
183
- return {
184
- successful: true,
185
- matchedContactInfo,
186
- returnMessage: {
187
- messageType: 'success',
188
- message: `Found ${matchedContactInfo.length} contacts`,
189
- ttl: 3000
190
- }
191
- };
192
- }
193
-
194
- async function createContact({ user, authHeader, phoneNumber, newContactName, newContactType, additionalSubmission, proxyConfig }) {
195
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
196
- if (!cfg.operations?.createContact) {
197
- return { contactInfo: null, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
198
- }
199
- const response = await performRequest({
200
- config: cfg,
201
- opName: 'createContact',
202
- inputs: { phoneNumber, newContactName, newContactType, additionalSubmission },
203
- user,
204
- authHeader
205
- });
206
- const map = cfg.operations.createContact.responseMapping || {};
207
- const responseCtx = { body: response.data };
208
- const contactInfo = map.idPath ? {
209
- id: getByPath(responseCtx, map.idPath || 'body.id'),
210
- name: getByPath(responseCtx, map.namePath || 'body.name'),
211
- type: getByPath(responseCtx, map.typePath || 'body.type') || 'Contact',
212
- } : null;
213
- return { contactInfo, returnMessage: { message: 'Contact created', messageType: 'success', ttl: 2000 } };
214
- }
215
-
216
- async function findContactWithName({ user, authHeader, name, proxyConfig }) {
217
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
218
- if (!cfg.operations?.findContactWithName) {
219
- return { successful: true, matchedContactInfo: [] };
220
- }
221
- const response = await performRequest({
222
- config: cfg,
223
- opName: 'findContactWithName',
224
- inputs: { name },
225
- user,
226
- authHeader
227
- });
228
- const matchedContactInfo = mapFindContactResponse({ config: cfg, response });
229
- return {
230
- successful: true,
231
- matchedContactInfo,
232
- returnMessage: {
233
- messageType: 'success',
234
- message: `Found ${matchedContactInfo.length} contacts`,
235
- ttl: 3000
236
- }
237
- };
238
- }
239
-
240
- function getLogFormatType(platform, proxyConfig) {
241
- return proxyConfig ? proxyConfig.meta?.logFormat : 'custom';
242
- }
243
-
244
- async function createCallLog({
245
- user,
246
- contactInfo,
247
- authHeader,
248
- callLog,
249
- note,
250
- additionalSubmission,
251
- aiNote,
252
- transcript,
253
- ringSenseTranscript = '',
254
- ringSenseSummary = '',
255
- ringSenseAIScore = '',
256
- ringSenseBulletedSummary = '',
257
- ringSenseLink = '',
258
- composedLogDetails,
259
- hashedAccountId,
260
- isFromSSCL,
261
- proxyConfig = null,
262
- }) {
263
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
264
- if (!cfg || !cfg.operations?.createCallLog) {
265
- return { logId: undefined, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
266
- }
267
- const response = await performRequest({
268
- config: cfg,
269
- opName: 'createCallLog',
270
- inputs: {
271
- contactInfo,
272
- callLog,
273
- note,
274
- additionalSubmission,
275
- aiNote,
276
- transcript,
277
- composedLogDetails,
278
- hashedAccountId,
279
- isFromSSCL,
280
- subject: callLog.customSubject ?? `${callLog.direction} Call ${callLog.direction === 'Outbound' ? 'to' : 'from'} ${contactInfo.name}`,
281
- startTime: moment(callLog.startTime).utc().toISOString(),
282
- endTime: moment(callLog.startTime).utc().add(callLog.duration, 'seconds').toISOString(),
283
- ringSenseTranscript,
284
- ringSenseSummary,
285
- ringSenseAIScore,
286
- ringSenseBulletedSummary,
287
- ringSenseLink,
288
- },
289
- user,
290
- authHeader
291
- });
292
- const { logId } = mapCreateCallLogResponse({ config: cfg, response });
293
- return {
294
- logId,
295
- returnMessage: {
296
- message: 'Call logged',
297
- messageType: 'success',
298
- ttl: 2000
299
- }
300
- };
301
- }
302
-
303
- async function getCallLog({ user, callLogId, contactId, authHeader, proxyConfig = null }) {
304
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
305
- if (!cfg || !cfg.operations?.getCallLog) {
306
- return { callLogInfo: null, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
307
- }
308
- const response = await performRequest({
309
- config: cfg,
310
- opName: 'getCallLog',
311
- inputs: { thirdPartyLogId: callLogId, contactId },
312
- user,
313
- authHeader
314
- });
315
- const mapped = mapGetCallLogResponse({ config: cfg, response });
316
- return Object.assign(mapped, { returnMessage: { message: 'Call log fetched.', messageType: 'success', ttl: 3000 } });
317
- }
318
-
319
- async function updateCallLog({
320
- user,
321
- existingCallLog,
322
- authHeader,
323
- recordingLink,
324
- recordingDownloadLink,
325
- subject,
326
- note,
327
- startTime,
328
- duration,
329
- result,
330
- aiNote,
331
- transcript,
332
- legs,
333
- ringSenseTranscript = '',
334
- ringSenseSummary = '',
335
- ringSenseAIScore = '',
336
- ringSenseBulletedSummary = '',
337
- ringSenseLink = '',
338
- additionalSubmission,
339
- composedLogDetails,
340
- existingCallLogDetails,
341
- hashedAccountId,
342
- isFromSSCL,
343
- proxyConfig = null,
344
- }) {
345
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
346
- if (!cfg || !cfg.operations?.updateCallLog) {
347
- return { returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
348
- }
349
- await performRequest({
350
- config: cfg,
351
- opName: 'updateCallLog',
352
- inputs: {
353
- thirdPartyLogId: existingCallLog?.thirdPartyLogId,
354
- existingCallLog,
355
- recordingLink,
356
- recordingDownloadLink,
357
- subject,
358
- note,
359
- startTime: moment(startTime).utc().toISOString(),
360
- endTime: moment(startTime).utc().add(duration, 'seconds').toISOString(),
361
- duration,
362
- result,
363
- aiNote,
364
- transcript,
365
- legs,
366
- additionalSubmission,
367
- composedLogDetails,
368
- existingCallLogDetails,
369
- hashedAccountId,
370
- isFromSSCL,
371
- ringSenseTranscript,
372
- ringSenseSummary,
373
- ringSenseAIScore,
374
- ringSenseBulletedSummary,
375
- ringSenseLink,
376
- },
377
- user,
378
- authHeader
379
- });
380
- return {
381
- updatedNote: null,
382
- returnMessage: {
383
- message: 'Call log updated.',
384
- messageType: 'success',
385
- ttl: 3000
386
- }
387
- };
388
- }
389
-
390
- async function upsertCallDisposition({ user, existingCallLog, authHeader, dispositions, proxyConfig }) {
391
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
392
- if (!cfg.operations?.upsertCallDisposition) {
393
- return { returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
394
- }
395
- await performRequest({
396
- config: cfg,
397
- opName: 'upsertCallDisposition',
398
- inputs: { existingCallLog, dispositions, thirdPartyLogId: existingCallLog?.thirdPartyLogId },
399
- user,
400
- authHeader
401
- });
402
- return { logId: existingCallLog.thirdPartyLogId, returnMessage: { message: 'Disposition updated', messageType: 'success', ttl: 2000 } };
403
- }
404
-
405
- async function createMessageLog({ user, contactInfo, authHeader, message, additionalSubmission, recordingLink, faxDocLink, faxDownloadLink, imageLink, videoLink, proxyConfig }) {
406
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
407
- if (!cfg.operations?.createMessageLog) {
408
- return { logId: undefined, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
409
- }
410
- const response = await performRequest({
411
- config: cfg,
412
- opName: 'createMessageLog',
413
- inputs: {
414
- contactInfo,
415
- message,
416
- additionalSubmission,
417
- recordingLink,
418
- faxDocLink,
419
- faxDownloadLink,
420
- imageLink,
421
- videoLink,
422
- creationTime: moment(message.creationTime).utc().toISOString(),
423
- },
424
- user,
425
- authHeader
426
- });
427
- const map = cfg.operations.createMessageLog.responseMapping || {};
428
- const responseCtx = { body: response.data };
429
- const logId = getByPath(responseCtx, map.idPath || 'body.id');
430
- return {
431
- logId: logId ? String(logId) : undefined,
432
- returnMessage: { message: 'Message logged', messageType: 'success', ttl: 1000 }
433
- };
434
- }
435
-
436
- async function updateMessageLog({ user, contactInfo, existingMessageLog, message, authHeader, additionalSubmission, imageLink, videoLink, proxyConfig }) {
437
- const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
438
- if (!cfg.operations?.updateMessageLog) {
439
- return { returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
440
- }
441
- await performRequest({
442
- config: cfg,
443
- opName: 'updateMessageLog',
444
- inputs: {
445
- contactInfo,
446
- existingMessageLog,
447
- thirdPartyLogId: existingMessageLog?.thirdPartyLogId,
448
- message,
449
- additionalSubmission,
450
- imageLink,
451
- videoLink,
452
- creationTime: moment(message.creationTime).utc().toISOString(),
453
- },
454
- user,
455
- authHeader
456
- });
457
- return { returnMessage: { message: 'Message log updated', messageType: 'success', ttl: 3000 } };
458
- }
459
-
460
- async function getLicenseStatus({ userId, platform }) {
461
- const user = await UserModel.findByPk(userId);
462
- if (!user || !user.accessToken) {
463
- return { isLicenseValid: false, licenseStatus: 'Invalid (User not found)', licenseStatusDescription: '' };
464
- }
465
- const proxyId = user.platformAdditionalInfo?.proxyId;
466
- const cfg = await loadPlatformConfig(proxyId);
467
- if (!cfg.operations?.getLicenseStatus) {
468
- return { isLicenseValid: true, licenseStatus: 'Basic', licenseStatusDescription: '' };
469
- }
470
- const response = await performRequest({
471
- config: cfg,
472
- opName: 'getLicenseStatus',
473
- inputs: { userId, platform },
474
- user,
475
- });
476
- const map = cfg.operations.getLicenseStatus.responseMapping || {};
477
- const responseCtx = { body: response.data };
478
- const isLicenseValid = getByPath(responseCtx, map.isLicenseValidPath || 'body.isLicenseValid');
479
- const licenseStatus = getByPath(responseCtx, map.licenseStatusPath || 'body.licenseStatus');
480
- const licenseStatusDescription = getByPath(responseCtx, map.licenseStatusDescriptionPath || 'body.licenseStatusDescription');
481
- return { isLicenseValid, licenseStatus, licenseStatusDescription };
482
- }
483
-
484
- exports.getAuthType = getAuthType;
485
- exports.getOauthInfo = getOauthInfo;
486
- exports.getBasicAuth = getBasicAuth;
487
- exports.getUserInfo = getUserInfo;
488
- exports.createCallLog = createCallLog;
489
- exports.updateCallLog = updateCallLog;
490
- exports.getCallLog = getCallLog;
491
- exports.createMessageLog = createMessageLog;
492
- exports.updateMessageLog = updateMessageLog;
493
- exports.findContact = findContact;
494
- exports.createContact = createContact;
495
- exports.findContactWithName = findContactWithName;
496
- exports.unAuthorize = unAuthorize;
497
- exports.getLicenseStatus = getLicenseStatus;
498
- exports.upsertCallDisposition = upsertCallDisposition;
499
- exports.getUserList = getUserList;
500
- exports.getLogFormatType = getLogFormatType;
1
+ /* eslint-disable no-param-reassign */
2
+ const { parsePhoneNumber } = require('awesome-phonenumber');
3
+ const moment = require('moment');
4
+ const {
5
+ performRequest,
6
+ mapFindContactResponse,
7
+ mapCreateCallLogResponse,
8
+ mapGetCallLogResponse,
9
+ getByPath,
10
+ } = require('./engine');
11
+ const { Connector } = require('../../models/dynamo/connectorSchema');
12
+ const { UserModel } = require('../../models/userModel');
13
+ const logger = require('../../lib/logger');
14
+ const { handleDatabaseError } = require('../../lib/errorHandler');
15
+
16
+ async function loadPlatformConfig(proxyId) {
17
+ if (!proxyId) {
18
+ return null;
19
+ }
20
+ try {
21
+ const proxyConfig = await Connector.getProxyConfig(proxyId);
22
+ return proxyConfig;
23
+ } catch (error) {
24
+ logger.error('Error getting proxy config: ', { proxyId, stack: error.stack });
25
+ return null;
26
+ }
27
+ }
28
+
29
+ async function getAuthType({ proxyId, proxyConfig } = {}) {
30
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(proxyId));
31
+ if (!cfg) {
32
+ return 'apiKey';
33
+ }
34
+ return cfg.auth.type || 'apiKey';
35
+ }
36
+
37
+ async function getOauthInfo({ proxyId, proxyConfig, tokenUrl } = {}) {
38
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(proxyId));
39
+ if (!cfg) {
40
+ return {};
41
+ }
42
+ return {
43
+ clientId: cfg.auth.clientId,
44
+ clientSecret: cfg.auth.clientSecret,
45
+ accessTokenUri: tokenUrl || cfg.auth.tokenUrl,
46
+ redirectUri: cfg.auth.redirectUri,
47
+ };
48
+ }
49
+
50
+ function getBasicAuth({ apiKey }) {
51
+ return Buffer.from(`${apiKey}:`).toString('base64');
52
+ }
53
+
54
+ async function getUserInfo({ authHeader, hostname, additionalInfo, platform, apiKey, proxyId, proxyConfig, userEmail } = {}) {
55
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(proxyId));
56
+ if (!cfg || !cfg.operations?.getUserInfo) {
57
+ // Fallback if no getUserInfo operation defined
58
+ return {
59
+ successful: false,
60
+ returnMessage: {
61
+ messageType: 'warning',
62
+ message: `Could not load user information. The platform does not support getUserInfo operation.`,
63
+ ttl: 1000
64
+ }
65
+ };
66
+ }
67
+ const response = await performRequest({
68
+ config: cfg,
69
+ opName: 'getUserInfo',
70
+ inputs: {
71
+ additionalInfo,
72
+ apiKey,
73
+ hostname,
74
+ platform,
75
+ userEmail,
76
+ },
77
+ user: {},
78
+ authHeader
79
+ });
80
+ const map = cfg.operations.getUserInfo.responseMapping || {};
81
+ const responseCtx = {
82
+ body: response.data,
83
+ additionalInfo,
84
+ apiKey,
85
+ hostname,
86
+ platform,
87
+ };
88
+ const rawUserId = map.idPath ? getByPath(responseCtx, map.idPath) : undefined;
89
+ const id = `${rawUserId}-${platform}`;
90
+ const name = map.namePath ? getByPath(responseCtx, map.namePath) : rawUserId;
91
+ const timezoneName = map.timezoneNamePath ? getByPath(responseCtx, map.timezoneNamePath) : undefined;
92
+ const overridingApiKey = map.overridingApiKeyPath ? getByPath(responseCtx, map.overridingApiKeyPath) : undefined;
93
+ // platformAdditionalInfo mapping and cleanup
94
+ const platformAdditionalInfo = Object.assign({}, additionalInfo || {});
95
+ if (platformAdditionalInfo.password) delete platformAdditionalInfo.password;
96
+ if (map.platformAdditionalInfoPaths && typeof map.platformAdditionalInfoPaths === 'object') {
97
+ for (const [key, expr] of Object.entries(map.platformAdditionalInfoPaths)) {
98
+ platformAdditionalInfo[key] = getByPath(responseCtx, expr);
99
+ }
100
+ }
101
+ const message = map.messagePath ? (getByPath(responseCtx, map.messagePath) || `Connected to ${platform}.`) : `Connected to ${platform}.`;
102
+ return {
103
+ successful: true,
104
+ platformUserInfo: Object.assign(
105
+ { id, name },
106
+ timezoneName ? { timezoneName } : {},
107
+ overridingApiKey ? { overridingApiKey } : {},
108
+ Object.keys(platformAdditionalInfo).length ? { platformAdditionalInfo } : {}
109
+ ),
110
+ returnMessage: {
111
+ messageType: 'success',
112
+ message,
113
+ ttl: 1000
114
+ }
115
+ };
116
+ }
117
+
118
+ async function getUserList({ user, authHeader, proxyConfig }) {
119
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
120
+ if (!cfg.operations?.getUserList) {
121
+ return [];
122
+ }
123
+ const response = await performRequest({
124
+ config: cfg,
125
+ opName: 'getUserList',
126
+ inputs: { user },
127
+ user,
128
+ authHeader
129
+ });
130
+ const map = cfg.operations.getUserList.responseMapping || {};
131
+ const responseCtx = { body: response.data };
132
+ const userList = map.listPath ? getByPath(responseCtx, map.listPath) : [];
133
+ return (userList || []).map(item => ({
134
+ id: getByPath(item, map.idPath || 'id'),
135
+ name: getByPath(item, map.namePath || 'name'),
136
+ email: getByPath(item, map.emailPath || 'email'),
137
+ }));
138
+ }
139
+
140
+ async function unAuthorize({ user }) {
141
+ const cfg = await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId);
142
+ if (cfg?.operations?.unAuthorize) {
143
+ await performRequest({
144
+ config: cfg,
145
+ opName: 'unAuthorize',
146
+ inputs: {},
147
+ user,
148
+ });
149
+ }
150
+ user.accessToken = '';
151
+ user.refreshToken = '';
152
+ try {
153
+ await user.save();
154
+ }
155
+ catch (error) {
156
+ return handleDatabaseError(error, 'Error saving user');
157
+ }
158
+ return {
159
+ successful: true,
160
+ returnMessage: {
161
+ messageType: 'success',
162
+ message: 'Logged out',
163
+ ttl: 1000
164
+ }
165
+ };
166
+ }
167
+
168
+ async function findContact({ user, authHeader, phoneNumber, overridingFormat, isExtension, proxyConfig }) {
169
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
170
+ if (!cfg.operations?.findContact) {
171
+ return { successful: true, matchedContactInfo: [] };
172
+ }
173
+ let formattedPhoneNumber = phoneNumber.replace(' ', '+')
174
+ const parsedPhoneNumber = parsePhoneNumber(formattedPhoneNumber);
175
+ const response = await performRequest({
176
+ config: cfg,
177
+ opName: 'findContact',
178
+ inputs: { phoneNumber, parsedPhoneNumber, overridingFormat, isExtension },
179
+ user,
180
+ authHeader
181
+ });
182
+ const matchedContactInfo = mapFindContactResponse({ config: cfg, response });
183
+ return {
184
+ successful: true,
185
+ matchedContactInfo,
186
+ returnMessage: {
187
+ messageType: 'success',
188
+ message: `Found ${matchedContactInfo.length} contacts`,
189
+ ttl: 3000
190
+ }
191
+ };
192
+ }
193
+
194
+ async function createContact({ user, authHeader, phoneNumber, newContactName, newContactType, additionalSubmission, proxyConfig }) {
195
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
196
+ if (!cfg.operations?.createContact) {
197
+ return { contactInfo: null, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
198
+ }
199
+ const response = await performRequest({
200
+ config: cfg,
201
+ opName: 'createContact',
202
+ inputs: { phoneNumber, newContactName, newContactType, additionalSubmission },
203
+ user,
204
+ authHeader
205
+ });
206
+ const map = cfg.operations.createContact.responseMapping || {};
207
+ const responseCtx = { body: response.data };
208
+ const contactInfo = map.idPath ? {
209
+ id: getByPath(responseCtx, map.idPath || 'body.id'),
210
+ name: getByPath(responseCtx, map.namePath || 'body.name'),
211
+ type: getByPath(responseCtx, map.typePath || 'body.type') || 'Contact',
212
+ } : null;
213
+ return { contactInfo, returnMessage: { message: 'Contact created', messageType: 'success', ttl: 2000 } };
214
+ }
215
+
216
+ async function findContactWithName({ user, authHeader, name, proxyConfig }) {
217
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
218
+ if (!cfg.operations?.findContactWithName) {
219
+ return { successful: true, matchedContactInfo: [] };
220
+ }
221
+ const response = await performRequest({
222
+ config: cfg,
223
+ opName: 'findContactWithName',
224
+ inputs: { name },
225
+ user,
226
+ authHeader
227
+ });
228
+ const matchedContactInfo = mapFindContactResponse({ config: cfg, response });
229
+ return {
230
+ successful: true,
231
+ matchedContactInfo,
232
+ returnMessage: {
233
+ messageType: 'success',
234
+ message: `Found ${matchedContactInfo.length} contacts`,
235
+ ttl: 3000
236
+ }
237
+ };
238
+ }
239
+
240
+ function getLogFormatType(platform, proxyConfig) {
241
+ return proxyConfig ? proxyConfig.meta?.logFormat : 'custom';
242
+ }
243
+
244
+ async function createCallLog({
245
+ user,
246
+ contactInfo,
247
+ authHeader,
248
+ callLog,
249
+ note,
250
+ additionalSubmission,
251
+ aiNote,
252
+ transcript,
253
+ ringSenseTranscript = '',
254
+ ringSenseSummary = '',
255
+ ringSenseAIScore = '',
256
+ ringSenseBulletedSummary = '',
257
+ ringSenseLink = '',
258
+ composedLogDetails,
259
+ hashedAccountId,
260
+ isFromSSCL,
261
+ proxyConfig = null,
262
+ }) {
263
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
264
+ if (!cfg || !cfg.operations?.createCallLog) {
265
+ return { logId: undefined, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
266
+ }
267
+ const response = await performRequest({
268
+ config: cfg,
269
+ opName: 'createCallLog',
270
+ inputs: {
271
+ contactInfo,
272
+ callLog,
273
+ note,
274
+ additionalSubmission,
275
+ aiNote,
276
+ transcript,
277
+ composedLogDetails,
278
+ hashedAccountId,
279
+ isFromSSCL,
280
+ subject: callLog.customSubject ?? `${callLog.direction} Call ${callLog.direction === 'Outbound' ? 'to' : 'from'} ${contactInfo.name}`,
281
+ startTime: moment(callLog.startTime).utc().toISOString(),
282
+ endTime: moment(callLog.startTime).utc().add(callLog.duration, 'seconds').toISOString(),
283
+ ringSenseTranscript,
284
+ ringSenseSummary,
285
+ ringSenseAIScore,
286
+ ringSenseBulletedSummary,
287
+ ringSenseLink,
288
+ },
289
+ user,
290
+ authHeader
291
+ });
292
+ const { logId } = mapCreateCallLogResponse({ config: cfg, response });
293
+ return {
294
+ logId,
295
+ returnMessage: {
296
+ message: 'Call logged',
297
+ messageType: 'success',
298
+ ttl: 2000
299
+ }
300
+ };
301
+ }
302
+
303
+ async function getCallLog({ user, callLogId, contactId, authHeader, proxyConfig = null }) {
304
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
305
+ if (!cfg || !cfg.operations?.getCallLog) {
306
+ return { callLogInfo: null, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
307
+ }
308
+ const response = await performRequest({
309
+ config: cfg,
310
+ opName: 'getCallLog',
311
+ inputs: { thirdPartyLogId: callLogId, contactId },
312
+ user,
313
+ authHeader
314
+ });
315
+ const mapped = mapGetCallLogResponse({ config: cfg, response });
316
+ return Object.assign(mapped, { returnMessage: { message: 'Call log fetched.', messageType: 'success', ttl: 3000 } });
317
+ }
318
+
319
+ async function updateCallLog({
320
+ user,
321
+ existingCallLog,
322
+ authHeader,
323
+ recordingLink,
324
+ recordingDownloadLink,
325
+ subject,
326
+ note,
327
+ startTime,
328
+ duration,
329
+ result,
330
+ aiNote,
331
+ transcript,
332
+ legs,
333
+ ringSenseTranscript = '',
334
+ ringSenseSummary = '',
335
+ ringSenseAIScore = '',
336
+ ringSenseBulletedSummary = '',
337
+ ringSenseLink = '',
338
+ additionalSubmission,
339
+ composedLogDetails,
340
+ existingCallLogDetails,
341
+ hashedAccountId,
342
+ isFromSSCL,
343
+ proxyConfig = null,
344
+ }) {
345
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
346
+ if (!cfg || !cfg.operations?.updateCallLog) {
347
+ return { returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
348
+ }
349
+ await performRequest({
350
+ config: cfg,
351
+ opName: 'updateCallLog',
352
+ inputs: {
353
+ thirdPartyLogId: existingCallLog?.thirdPartyLogId,
354
+ existingCallLog,
355
+ recordingLink,
356
+ recordingDownloadLink,
357
+ subject,
358
+ note,
359
+ startTime: moment(startTime).utc().toISOString(),
360
+ endTime: moment(startTime).utc().add(duration, 'seconds').toISOString(),
361
+ duration,
362
+ result,
363
+ aiNote,
364
+ transcript,
365
+ legs,
366
+ additionalSubmission,
367
+ composedLogDetails,
368
+ existingCallLogDetails,
369
+ hashedAccountId,
370
+ isFromSSCL,
371
+ ringSenseTranscript,
372
+ ringSenseSummary,
373
+ ringSenseAIScore,
374
+ ringSenseBulletedSummary,
375
+ ringSenseLink,
376
+ },
377
+ user,
378
+ authHeader
379
+ });
380
+ return {
381
+ updatedNote: null,
382
+ returnMessage: {
383
+ message: 'Call log updated.',
384
+ messageType: 'success',
385
+ ttl: 3000
386
+ }
387
+ };
388
+ }
389
+
390
+ async function upsertCallDisposition({ user, existingCallLog, authHeader, dispositions, proxyConfig }) {
391
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
392
+ if (!cfg.operations?.upsertCallDisposition) {
393
+ return { returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
394
+ }
395
+ await performRequest({
396
+ config: cfg,
397
+ opName: 'upsertCallDisposition',
398
+ inputs: { existingCallLog, dispositions, thirdPartyLogId: existingCallLog?.thirdPartyLogId },
399
+ user,
400
+ authHeader
401
+ });
402
+ return { logId: existingCallLog.thirdPartyLogId, returnMessage: { message: 'Disposition updated', messageType: 'success', ttl: 2000 } };
403
+ }
404
+
405
+ async function createMessageLog({ user, contactInfo, authHeader, message, additionalSubmission, recordingLink, faxDocLink, faxDownloadLink, imageLink, videoLink, proxyConfig }) {
406
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
407
+ if (!cfg.operations?.createMessageLog) {
408
+ return { logId: undefined, returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
409
+ }
410
+ const response = await performRequest({
411
+ config: cfg,
412
+ opName: 'createMessageLog',
413
+ inputs: {
414
+ contactInfo,
415
+ message,
416
+ additionalSubmission,
417
+ recordingLink,
418
+ faxDocLink,
419
+ faxDownloadLink,
420
+ imageLink,
421
+ videoLink,
422
+ creationTime: moment(message.creationTime).utc().toISOString(),
423
+ },
424
+ user,
425
+ authHeader
426
+ });
427
+ const map = cfg.operations.createMessageLog.responseMapping || {};
428
+ const responseCtx = { body: response.data };
429
+ const logId = getByPath(responseCtx, map.idPath || 'body.id');
430
+ return {
431
+ logId: logId ? String(logId) : undefined,
432
+ returnMessage: { message: 'Message logged', messageType: 'success', ttl: 1000 }
433
+ };
434
+ }
435
+
436
+ async function updateMessageLog({ user, contactInfo, existingMessageLog, message, authHeader, additionalSubmission, imageLink, videoLink, proxyConfig }) {
437
+ const cfg = proxyConfig ? proxyConfig : (await loadPlatformConfig(user?.platformAdditionalInfo?.proxyId));
438
+ if (!cfg.operations?.updateMessageLog) {
439
+ return { returnMessage: { message: 'Not supported', messageType: 'warning', ttl: 2000 } };
440
+ }
441
+ await performRequest({
442
+ config: cfg,
443
+ opName: 'updateMessageLog',
444
+ inputs: {
445
+ contactInfo,
446
+ existingMessageLog,
447
+ thirdPartyLogId: existingMessageLog?.thirdPartyLogId,
448
+ message,
449
+ additionalSubmission,
450
+ imageLink,
451
+ videoLink,
452
+ creationTime: moment(message.creationTime).utc().toISOString(),
453
+ },
454
+ user,
455
+ authHeader
456
+ });
457
+ return { returnMessage: { message: 'Message log updated', messageType: 'success', ttl: 3000 } };
458
+ }
459
+
460
+ async function getLicenseStatus({ userId, platform }) {
461
+ const user = await UserModel.findByPk(userId);
462
+ if (!user || !user.accessToken) {
463
+ return { isLicenseValid: false, licenseStatus: 'Invalid (User not found)', licenseStatusDescription: '' };
464
+ }
465
+ const proxyId = user.platformAdditionalInfo?.proxyId;
466
+ const cfg = await loadPlatformConfig(proxyId);
467
+ if (!cfg.operations?.getLicenseStatus) {
468
+ return { isLicenseValid: true, licenseStatus: 'Basic', licenseStatusDescription: '' };
469
+ }
470
+ const response = await performRequest({
471
+ config: cfg,
472
+ opName: 'getLicenseStatus',
473
+ inputs: { userId, platform },
474
+ user,
475
+ });
476
+ const map = cfg.operations.getLicenseStatus.responseMapping || {};
477
+ const responseCtx = { body: response.data };
478
+ const isLicenseValid = getByPath(responseCtx, map.isLicenseValidPath || 'body.isLicenseValid');
479
+ const licenseStatus = getByPath(responseCtx, map.licenseStatusPath || 'body.licenseStatus');
480
+ const licenseStatusDescription = getByPath(responseCtx, map.licenseStatusDescriptionPath || 'body.licenseStatusDescription');
481
+ return { isLicenseValid, licenseStatus, licenseStatusDescription };
482
+ }
483
+
484
+ exports.getAuthType = getAuthType;
485
+ exports.getOauthInfo = getOauthInfo;
486
+ exports.getBasicAuth = getBasicAuth;
487
+ exports.getUserInfo = getUserInfo;
488
+ exports.createCallLog = createCallLog;
489
+ exports.updateCallLog = updateCallLog;
490
+ exports.getCallLog = getCallLog;
491
+ exports.createMessageLog = createMessageLog;
492
+ exports.updateMessageLog = updateMessageLog;
493
+ exports.findContact = findContact;
494
+ exports.createContact = createContact;
495
+ exports.findContactWithName = findContactWithName;
496
+ exports.unAuthorize = unAuthorize;
497
+ exports.getLicenseStatus = getLicenseStatus;
498
+ exports.upsertCallDisposition = upsertCallDisposition;
499
+ exports.getUserList = getUserList;
500
+ exports.getLogFormatType = getLogFormatType;