@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,436 +1,436 @@
1
- const createCallLog = require('../../../mcp/tools/createCallLog');
2
- const jwt = require('../../../lib/jwt');
3
- const connectorRegistry = require('../../../connector/registry');
4
- const logCore = require('../../../handlers/log');
5
- const contactCore = require('../../../handlers/contact');
6
- const util = require('../../../lib/util');
7
- const { CallLogModel } = require('../../../models/callLogModel');
8
-
9
- // Mock dependencies
10
- jest.mock('../../../lib/jwt');
11
- jest.mock('../../../connector/registry');
12
- jest.mock('../../../handlers/log');
13
- jest.mock('../../../handlers/contact');
14
- jest.mock('../../../lib/util');
15
- jest.mock('../../../models/callLogModel');
16
-
17
- describe('MCP Tool: createCallLog', () => {
18
- beforeEach(() => {
19
- jest.clearAllMocks();
20
- process.env.HASH_KEY = 'test-hash-key';
21
- });
22
-
23
- describe('tool definition', () => {
24
- test('should have correct tool definition', () => {
25
- expect(createCallLog.definition).toBeDefined();
26
- expect(createCallLog.definition.name).toBe('createCallLog');
27
- expect(createCallLog.definition.description).toContain('REQUIRES CRM CONNECTION');
28
- expect(createCallLog.definition.inputSchema).toBeDefined();
29
- });
30
-
31
- test('should require incomingData parameter (jwtToken is server-injected)', () => {
32
- expect(createCallLog.definition.inputSchema.required).not.toContain('jwtToken');
33
- expect(createCallLog.definition.inputSchema.required).toContain('incomingData');
34
- });
35
-
36
- test('should have detailed inputSchema for incomingData', () => {
37
- const incomingDataSchema = createCallLog.definition.inputSchema.properties.incomingData;
38
- expect(incomingDataSchema.properties).toHaveProperty('logInfo');
39
- expect(incomingDataSchema.properties).toHaveProperty('note');
40
- expect(incomingDataSchema.required).toContain('logInfo');
41
- });
42
- });
43
-
44
- describe('execute', () => {
45
- test('should create call log successfully', async () => {
46
- // Arrange
47
- const mockIncomingData = {
48
- logInfo: {
49
- id: 'rc-call-123',
50
- sessionId: 'session-123',
51
- direction: 'Inbound',
52
- startTime: '2024-01-01T10:00:00Z',
53
- duration: 120,
54
- from: { phoneNumber: '+1234567890', name: 'John Doe' },
55
- to: { phoneNumber: '+0987654321', name: 'Company' },
56
- accountId: 'rc-account-123'
57
- },
58
- contactName: 'John Doe',
59
- contactType: 'Contact',
60
- note: 'Test call note'
61
- };
62
-
63
- jwt.decodeJwt.mockReturnValue({
64
- id: 'user-123',
65
- platform: 'testCRM'
66
- });
67
-
68
- const mockConnector = {
69
- createCallLog: jest.fn()
70
- };
71
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
72
-
73
- CallLogModel.findOne.mockResolvedValue(null); // No existing log
74
-
75
- util.getHashValue.mockReturnValue('hashed-account-id');
76
-
77
- // Mock contactCore.findContact to return a contact
78
- contactCore.findContact.mockResolvedValue({
79
- successful: true,
80
- contact: [{ id: 'contact-123', isNewContact: false }]
81
- });
82
-
83
- logCore.createCallLog.mockResolvedValue({
84
- successful: true,
85
- logId: 'crm-log-123',
86
- returnMessage: { message: 'Call logged successfully' }
87
- });
88
-
89
- // Act
90
- const result = await createCallLog.execute({
91
- jwtToken: 'mock-jwt-token',
92
- incomingData: mockIncomingData
93
- });
94
-
95
- // Assert
96
- expect(result).toEqual({
97
- success: true,
98
- data: {
99
- logId: 'crm-log-123',
100
- message: 'Call logged successfully'
101
- }
102
- });
103
- expect(jwt.decodeJwt).toHaveBeenCalledWith('mock-jwt-token');
104
- expect(CallLogModel.findOne).toHaveBeenCalledWith({
105
- where: { sessionId: 'session-123' }
106
- });
107
- });
108
-
109
- test('should create call log with AI note and transcript', async () => {
110
- // Arrange
111
- const mockIncomingData = {
112
- logInfo: {
113
- id: 'rc-call-456',
114
- sessionId: 'session-456',
115
- direction: 'Outbound',
116
- startTime: '2024-01-01T11:00:00Z',
117
- duration: 300,
118
- from: { phoneNumber: '+0987654321' },
119
- to: { phoneNumber: '+1234567890' }
120
- },
121
- aiNote: 'AI generated summary of the call',
122
- transcript: 'Full call transcript text'
123
- };
124
-
125
- jwt.decodeJwt.mockReturnValue({
126
- id: 'user-123',
127
- platform: 'testCRM'
128
- });
129
-
130
- const mockConnector = {
131
- createCallLog: jest.fn()
132
- };
133
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
134
-
135
- CallLogModel.findOne.mockResolvedValue(null);
136
-
137
- // Mock contactCore.findContact to return a contact
138
- contactCore.findContact.mockResolvedValue({
139
- successful: true,
140
- contact: [{ id: 'contact-456', isNewContact: false }]
141
- });
142
-
143
- logCore.createCallLog.mockResolvedValue({
144
- successful: true,
145
- logId: 'crm-log-456'
146
- });
147
-
148
- // Act
149
- const result = await createCallLog.execute({
150
- jwtToken: 'mock-jwt-token',
151
- incomingData: mockIncomingData
152
- });
153
-
154
- // Assert
155
- expect(result.success).toBe(true);
156
- expect(result.data.logId).toBe('crm-log-456');
157
- });
158
-
159
- test('should create call log with additional submission', async () => {
160
- // Arrange
161
- const mockIncomingData = {
162
- logInfo: {
163
- id: 'rc-call-789',
164
- sessionId: 'session-789',
165
- direction: 'Inbound',
166
- startTime: '2024-01-01T12:00:00Z',
167
- duration: 60,
168
- from: { phoneNumber: '+1234567890' },
169
- to: { phoneNumber: '+0987654321' }
170
- },
171
- additionalSubmission: {
172
- isAssignedToUser: true,
173
- adminAssignedUserToken: 'admin-jwt-token',
174
- adminAssignedUserRcId: 'rc-ext-101'
175
- }
176
- };
177
-
178
- jwt.decodeJwt.mockReturnValue({
179
- id: 'user-123',
180
- platform: 'testCRM'
181
- });
182
-
183
- const mockConnector = {
184
- createCallLog: jest.fn()
185
- };
186
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
187
-
188
- CallLogModel.findOne.mockResolvedValue(null);
189
-
190
- // Mock contactCore.findContact to return a contact
191
- contactCore.findContact.mockResolvedValue({
192
- successful: true,
193
- contact: [{ id: 'contact-789', isNewContact: false }]
194
- });
195
-
196
- logCore.createCallLog.mockResolvedValue({
197
- successful: true,
198
- logId: 'crm-log-789'
199
- });
200
-
201
- // Act
202
- const result = await createCallLog.execute({
203
- jwtToken: 'mock-jwt-token',
204
- incomingData: mockIncomingData
205
- });
206
-
207
- // Assert
208
- expect(result.success).toBe(true);
209
- });
210
-
211
- test('should return error when call log already exists', async () => {
212
- // Arrange
213
- const mockIncomingData = {
214
- logInfo: {
215
- sessionId: 'existing-session'
216
- }
217
- };
218
-
219
- CallLogModel.findOne.mockResolvedValue({
220
- id: 'existing-log',
221
- sessionId: 'existing-session'
222
- });
223
-
224
- // Act
225
- const result = await createCallLog.execute({
226
- jwtToken: 'mock-jwt-token',
227
- incomingData: mockIncomingData
228
- });
229
-
230
- // Assert
231
- expect(result.success).toBe(false);
232
- expect(result.error).toContain('already exists');
233
- });
234
-
235
- test('should return error when jwtToken is missing', async () => {
236
- // Act
237
- const result = await createCallLog.execute({
238
- incomingData: { logInfo: {} }
239
- });
240
-
241
- // Assert
242
- expect(result.success).toBe(false);
243
- expect(result.error).toContain('authorize CRM platform');
244
- });
245
-
246
- test('should return error when incomingData is missing', async () => {
247
- // Act
248
- const result = await createCallLog.execute({
249
- jwtToken: 'mock-jwt-token'
250
- });
251
-
252
- // Assert
253
- expect(result.success).toBe(false);
254
- expect(result.error).toContain('Incoming data must be provided');
255
- });
256
-
257
- test('should return error when logInfo is missing', async () => {
258
- // Act
259
- const result = await createCallLog.execute({
260
- jwtToken: 'mock-jwt-token',
261
- incomingData: { contactId: 'contact-123' }
262
- });
263
-
264
- // Assert
265
- expect(result.success).toBe(false);
266
- expect(result.error).toContain('logInfo is required');
267
- });
268
-
269
- test('should return error when JWT is invalid', async () => {
270
- // Arrange
271
- const mockIncomingData = {
272
- logInfo: {
273
- sessionId: 'session-123'
274
- }
275
- };
276
-
277
- CallLogModel.findOne.mockResolvedValue(null);
278
-
279
- jwt.decodeJwt.mockReturnValue({
280
- platform: 'testCRM'
281
- // id is missing
282
- });
283
-
284
- // Act
285
- const result = await createCallLog.execute({
286
- jwtToken: 'invalid-token',
287
- incomingData: mockIncomingData
288
- });
289
-
290
- // Assert
291
- expect(result.success).toBe(false);
292
- expect(result.error).toContain('Invalid JWT token');
293
- });
294
-
295
- test('should return error when decodeJwt returns null', async () => {
296
- jwt.decodeJwt.mockReturnValue(null);
297
- const result = await createCallLog.execute({
298
- jwtToken: 'invalid-token',
299
- incomingData: { logInfo: { sessionId: 'session-123' } }
300
- });
301
-
302
- expect(result.success).toBe(false);
303
- expect(result.error).toContain('Invalid JWT token');
304
- });
305
-
306
- test('should return error when platform connector not found', async () => {
307
- // Arrange
308
- const mockIncomingData = {
309
- logInfo: {
310
- sessionId: 'session-123'
311
- }
312
- };
313
-
314
- CallLogModel.findOne.mockResolvedValue(null);
315
-
316
- jwt.decodeJwt.mockReturnValue({
317
- id: 'user-123',
318
- platform: 'unknownCRM'
319
- });
320
-
321
- connectorRegistry.getConnector.mockReturnValue(null);
322
-
323
- // Act
324
- const result = await createCallLog.execute({
325
- jwtToken: 'mock-jwt-token',
326
- incomingData: mockIncomingData
327
- });
328
-
329
- // Assert
330
- expect(result.success).toBe(false);
331
- expect(result.error).toContain('Platform connector not found');
332
- });
333
-
334
- test('should return error when createCallLog is not implemented', async () => {
335
- // Arrange
336
- const mockIncomingData = {
337
- logInfo: {
338
- sessionId: 'session-123'
339
- }
340
- };
341
-
342
- CallLogModel.findOne.mockResolvedValue(null);
343
-
344
- jwt.decodeJwt.mockReturnValue({
345
- id: 'user-123',
346
- platform: 'testCRM'
347
- });
348
-
349
- const mockConnector = {}; // No createCallLog method
350
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
351
-
352
- // Act
353
- const result = await createCallLog.execute({
354
- jwtToken: 'mock-jwt-token',
355
- incomingData: mockIncomingData
356
- });
357
-
358
- // Assert
359
- expect(result.success).toBe(false);
360
- expect(result.error).toContain('not implemented');
361
- });
362
-
363
- test('should return error when creation fails', async () => {
364
- // Arrange
365
- const mockIncomingData = {
366
- logInfo: {
367
- id: 'rc-call-999',
368
- sessionId: 'session-999',
369
- direction: 'Inbound',
370
- startTime: '2024-01-01T13:00:00Z',
371
- duration: 45,
372
- from: { phoneNumber: '+1234567890' },
373
- to: { phoneNumber: '+0987654321' }
374
- }
375
- };
376
-
377
- jwt.decodeJwt.mockReturnValue({
378
- id: 'user-123',
379
- platform: 'testCRM'
380
- });
381
-
382
- const mockConnector = {
383
- createCallLog: jest.fn()
384
- };
385
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
386
-
387
- CallLogModel.findOne.mockResolvedValue(null);
388
-
389
- // Mock contactCore.findContact to return a contact
390
- contactCore.findContact.mockResolvedValue({
391
- successful: true,
392
- contact: [{ id: 'contact-999', isNewContact: false }]
393
- });
394
-
395
- logCore.createCallLog.mockResolvedValue({
396
- successful: false,
397
- returnMessage: { message: 'Failed to create log in CRM' }
398
- });
399
-
400
- // Act
401
- const result = await createCallLog.execute({
402
- jwtToken: 'mock-jwt-token',
403
- incomingData: mockIncomingData
404
- });
405
-
406
- // Assert
407
- expect(result.success).toBe(false);
408
- expect(result.error).toBe('Failed to create log in CRM');
409
- });
410
-
411
- test('should handle unexpected errors gracefully', async () => {
412
- // Arrange
413
- const mockIncomingData = {
414
- logInfo: {
415
- sessionId: 'session-error'
416
- }
417
- };
418
-
419
- CallLogModel.findOne.mockRejectedValue(
420
- new Error('Database connection failed')
421
- );
422
-
423
- // Act
424
- const result = await createCallLog.execute({
425
- jwtToken: 'mock-jwt-token',
426
- incomingData: mockIncomingData
427
- });
428
-
429
- // Assert
430
- expect(result.success).toBe(false);
431
- expect(result.error).toBe('Database connection failed');
432
- expect(result.errorDetails).toBeDefined();
433
- });
434
- });
435
- });
436
-
1
+ const createCallLog = require('../../../mcp/tools/createCallLog');
2
+ const jwt = require('../../../lib/jwt');
3
+ const connectorRegistry = require('../../../connector/registry');
4
+ const logCore = require('../../../handlers/log');
5
+ const contactCore = require('../../../handlers/contact');
6
+ const util = require('../../../lib/util');
7
+ const { CallLogModel } = require('../../../models/callLogModel');
8
+
9
+ // Mock dependencies
10
+ jest.mock('../../../lib/jwt');
11
+ jest.mock('../../../connector/registry');
12
+ jest.mock('../../../handlers/log');
13
+ jest.mock('../../../handlers/contact');
14
+ jest.mock('../../../lib/util');
15
+ jest.mock('../../../models/callLogModel');
16
+
17
+ describe('MCP Tool: createCallLog', () => {
18
+ beforeEach(() => {
19
+ jest.clearAllMocks();
20
+ process.env.HASH_KEY = 'test-hash-key';
21
+ });
22
+
23
+ describe('tool definition', () => {
24
+ test('should have correct tool definition', () => {
25
+ expect(createCallLog.definition).toBeDefined();
26
+ expect(createCallLog.definition.name).toBe('createCallLog');
27
+ expect(createCallLog.definition.description).toContain('REQUIRES CRM CONNECTION');
28
+ expect(createCallLog.definition.inputSchema).toBeDefined();
29
+ });
30
+
31
+ test('should require incomingData parameter (jwtToken is server-injected)', () => {
32
+ expect(createCallLog.definition.inputSchema.required).not.toContain('jwtToken');
33
+ expect(createCallLog.definition.inputSchema.required).toContain('incomingData');
34
+ });
35
+
36
+ test('should have detailed inputSchema for incomingData', () => {
37
+ const incomingDataSchema = createCallLog.definition.inputSchema.properties.incomingData;
38
+ expect(incomingDataSchema.properties).toHaveProperty('logInfo');
39
+ expect(incomingDataSchema.properties).toHaveProperty('note');
40
+ expect(incomingDataSchema.required).toContain('logInfo');
41
+ });
42
+ });
43
+
44
+ describe('execute', () => {
45
+ test('should create call log successfully', async () => {
46
+ // Arrange
47
+ const mockIncomingData = {
48
+ logInfo: {
49
+ id: 'rc-call-123',
50
+ sessionId: 'session-123',
51
+ direction: 'Inbound',
52
+ startTime: '2024-01-01T10:00:00Z',
53
+ duration: 120,
54
+ from: { phoneNumber: '+1234567890', name: 'John Doe' },
55
+ to: { phoneNumber: '+0987654321', name: 'Company' },
56
+ accountId: 'rc-account-123'
57
+ },
58
+ contactName: 'John Doe',
59
+ contactType: 'Contact',
60
+ note: 'Test call note'
61
+ };
62
+
63
+ jwt.decodeJwt.mockReturnValue({
64
+ id: 'user-123',
65
+ platform: 'testCRM'
66
+ });
67
+
68
+ const mockConnector = {
69
+ createCallLog: jest.fn()
70
+ };
71
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
72
+
73
+ CallLogModel.findOne.mockResolvedValue(null); // No existing log
74
+
75
+ util.getHashValue.mockReturnValue('hashed-account-id');
76
+
77
+ // Mock contactCore.findContact to return a contact
78
+ contactCore.findContact.mockResolvedValue({
79
+ successful: true,
80
+ contact: [{ id: 'contact-123', isNewContact: false }]
81
+ });
82
+
83
+ logCore.createCallLog.mockResolvedValue({
84
+ successful: true,
85
+ logId: 'crm-log-123',
86
+ returnMessage: { message: 'Call logged successfully' }
87
+ });
88
+
89
+ // Act
90
+ const result = await createCallLog.execute({
91
+ jwtToken: 'mock-jwt-token',
92
+ incomingData: mockIncomingData
93
+ });
94
+
95
+ // Assert
96
+ expect(result).toEqual({
97
+ success: true,
98
+ data: {
99
+ logId: 'crm-log-123',
100
+ message: 'Call logged successfully'
101
+ }
102
+ });
103
+ expect(jwt.decodeJwt).toHaveBeenCalledWith('mock-jwt-token');
104
+ expect(CallLogModel.findOne).toHaveBeenCalledWith({
105
+ where: { sessionId: 'session-123' }
106
+ });
107
+ });
108
+
109
+ test('should create call log with AI note and transcript', async () => {
110
+ // Arrange
111
+ const mockIncomingData = {
112
+ logInfo: {
113
+ id: 'rc-call-456',
114
+ sessionId: 'session-456',
115
+ direction: 'Outbound',
116
+ startTime: '2024-01-01T11:00:00Z',
117
+ duration: 300,
118
+ from: { phoneNumber: '+0987654321' },
119
+ to: { phoneNumber: '+1234567890' }
120
+ },
121
+ aiNote: 'AI generated summary of the call',
122
+ transcript: 'Full call transcript text'
123
+ };
124
+
125
+ jwt.decodeJwt.mockReturnValue({
126
+ id: 'user-123',
127
+ platform: 'testCRM'
128
+ });
129
+
130
+ const mockConnector = {
131
+ createCallLog: jest.fn()
132
+ };
133
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
134
+
135
+ CallLogModel.findOne.mockResolvedValue(null);
136
+
137
+ // Mock contactCore.findContact to return a contact
138
+ contactCore.findContact.mockResolvedValue({
139
+ successful: true,
140
+ contact: [{ id: 'contact-456', isNewContact: false }]
141
+ });
142
+
143
+ logCore.createCallLog.mockResolvedValue({
144
+ successful: true,
145
+ logId: 'crm-log-456'
146
+ });
147
+
148
+ // Act
149
+ const result = await createCallLog.execute({
150
+ jwtToken: 'mock-jwt-token',
151
+ incomingData: mockIncomingData
152
+ });
153
+
154
+ // Assert
155
+ expect(result.success).toBe(true);
156
+ expect(result.data.logId).toBe('crm-log-456');
157
+ });
158
+
159
+ test('should create call log with additional submission', async () => {
160
+ // Arrange
161
+ const mockIncomingData = {
162
+ logInfo: {
163
+ id: 'rc-call-789',
164
+ sessionId: 'session-789',
165
+ direction: 'Inbound',
166
+ startTime: '2024-01-01T12:00:00Z',
167
+ duration: 60,
168
+ from: { phoneNumber: '+1234567890' },
169
+ to: { phoneNumber: '+0987654321' }
170
+ },
171
+ additionalSubmission: {
172
+ isAssignedToUser: true,
173
+ adminAssignedUserToken: 'admin-jwt-token',
174
+ adminAssignedUserRcId: 'rc-ext-101'
175
+ }
176
+ };
177
+
178
+ jwt.decodeJwt.mockReturnValue({
179
+ id: 'user-123',
180
+ platform: 'testCRM'
181
+ });
182
+
183
+ const mockConnector = {
184
+ createCallLog: jest.fn()
185
+ };
186
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
187
+
188
+ CallLogModel.findOne.mockResolvedValue(null);
189
+
190
+ // Mock contactCore.findContact to return a contact
191
+ contactCore.findContact.mockResolvedValue({
192
+ successful: true,
193
+ contact: [{ id: 'contact-789', isNewContact: false }]
194
+ });
195
+
196
+ logCore.createCallLog.mockResolvedValue({
197
+ successful: true,
198
+ logId: 'crm-log-789'
199
+ });
200
+
201
+ // Act
202
+ const result = await createCallLog.execute({
203
+ jwtToken: 'mock-jwt-token',
204
+ incomingData: mockIncomingData
205
+ });
206
+
207
+ // Assert
208
+ expect(result.success).toBe(true);
209
+ });
210
+
211
+ test('should return error when call log already exists', async () => {
212
+ // Arrange
213
+ const mockIncomingData = {
214
+ logInfo: {
215
+ sessionId: 'existing-session'
216
+ }
217
+ };
218
+
219
+ CallLogModel.findOne.mockResolvedValue({
220
+ id: 'existing-log',
221
+ sessionId: 'existing-session'
222
+ });
223
+
224
+ // Act
225
+ const result = await createCallLog.execute({
226
+ jwtToken: 'mock-jwt-token',
227
+ incomingData: mockIncomingData
228
+ });
229
+
230
+ // Assert
231
+ expect(result.success).toBe(false);
232
+ expect(result.error).toContain('already exists');
233
+ });
234
+
235
+ test('should return error when jwtToken is missing', async () => {
236
+ // Act
237
+ const result = await createCallLog.execute({
238
+ incomingData: { logInfo: {} }
239
+ });
240
+
241
+ // Assert
242
+ expect(result.success).toBe(false);
243
+ expect(result.error).toContain('authorize CRM platform');
244
+ });
245
+
246
+ test('should return error when incomingData is missing', async () => {
247
+ // Act
248
+ const result = await createCallLog.execute({
249
+ jwtToken: 'mock-jwt-token'
250
+ });
251
+
252
+ // Assert
253
+ expect(result.success).toBe(false);
254
+ expect(result.error).toContain('Incoming data must be provided');
255
+ });
256
+
257
+ test('should return error when logInfo is missing', async () => {
258
+ // Act
259
+ const result = await createCallLog.execute({
260
+ jwtToken: 'mock-jwt-token',
261
+ incomingData: { contactId: 'contact-123' }
262
+ });
263
+
264
+ // Assert
265
+ expect(result.success).toBe(false);
266
+ expect(result.error).toContain('logInfo is required');
267
+ });
268
+
269
+ test('should return error when JWT is invalid', async () => {
270
+ // Arrange
271
+ const mockIncomingData = {
272
+ logInfo: {
273
+ sessionId: 'session-123'
274
+ }
275
+ };
276
+
277
+ CallLogModel.findOne.mockResolvedValue(null);
278
+
279
+ jwt.decodeJwt.mockReturnValue({
280
+ platform: 'testCRM'
281
+ // id is missing
282
+ });
283
+
284
+ // Act
285
+ const result = await createCallLog.execute({
286
+ jwtToken: 'invalid-token',
287
+ incomingData: mockIncomingData
288
+ });
289
+
290
+ // Assert
291
+ expect(result.success).toBe(false);
292
+ expect(result.error).toContain('Invalid JWT token');
293
+ });
294
+
295
+ test('should return error when decodeJwt returns null', async () => {
296
+ jwt.decodeJwt.mockReturnValue(null);
297
+ const result = await createCallLog.execute({
298
+ jwtToken: 'invalid-token',
299
+ incomingData: { logInfo: { sessionId: 'session-123' } }
300
+ });
301
+
302
+ expect(result.success).toBe(false);
303
+ expect(result.error).toContain('Invalid JWT token');
304
+ });
305
+
306
+ test('should return error when platform connector not found', async () => {
307
+ // Arrange
308
+ const mockIncomingData = {
309
+ logInfo: {
310
+ sessionId: 'session-123'
311
+ }
312
+ };
313
+
314
+ CallLogModel.findOne.mockResolvedValue(null);
315
+
316
+ jwt.decodeJwt.mockReturnValue({
317
+ id: 'user-123',
318
+ platform: 'unknownCRM'
319
+ });
320
+
321
+ connectorRegistry.getConnector.mockReturnValue(null);
322
+
323
+ // Act
324
+ const result = await createCallLog.execute({
325
+ jwtToken: 'mock-jwt-token',
326
+ incomingData: mockIncomingData
327
+ });
328
+
329
+ // Assert
330
+ expect(result.success).toBe(false);
331
+ expect(result.error).toContain('Platform connector not found');
332
+ });
333
+
334
+ test('should return error when createCallLog is not implemented', async () => {
335
+ // Arrange
336
+ const mockIncomingData = {
337
+ logInfo: {
338
+ sessionId: 'session-123'
339
+ }
340
+ };
341
+
342
+ CallLogModel.findOne.mockResolvedValue(null);
343
+
344
+ jwt.decodeJwt.mockReturnValue({
345
+ id: 'user-123',
346
+ platform: 'testCRM'
347
+ });
348
+
349
+ const mockConnector = {}; // No createCallLog method
350
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
351
+
352
+ // Act
353
+ const result = await createCallLog.execute({
354
+ jwtToken: 'mock-jwt-token',
355
+ incomingData: mockIncomingData
356
+ });
357
+
358
+ // Assert
359
+ expect(result.success).toBe(false);
360
+ expect(result.error).toContain('not implemented');
361
+ });
362
+
363
+ test('should return error when creation fails', async () => {
364
+ // Arrange
365
+ const mockIncomingData = {
366
+ logInfo: {
367
+ id: 'rc-call-999',
368
+ sessionId: 'session-999',
369
+ direction: 'Inbound',
370
+ startTime: '2024-01-01T13:00:00Z',
371
+ duration: 45,
372
+ from: { phoneNumber: '+1234567890' },
373
+ to: { phoneNumber: '+0987654321' }
374
+ }
375
+ };
376
+
377
+ jwt.decodeJwt.mockReturnValue({
378
+ id: 'user-123',
379
+ platform: 'testCRM'
380
+ });
381
+
382
+ const mockConnector = {
383
+ createCallLog: jest.fn()
384
+ };
385
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
386
+
387
+ CallLogModel.findOne.mockResolvedValue(null);
388
+
389
+ // Mock contactCore.findContact to return a contact
390
+ contactCore.findContact.mockResolvedValue({
391
+ successful: true,
392
+ contact: [{ id: 'contact-999', isNewContact: false }]
393
+ });
394
+
395
+ logCore.createCallLog.mockResolvedValue({
396
+ successful: false,
397
+ returnMessage: { message: 'Failed to create log in CRM' }
398
+ });
399
+
400
+ // Act
401
+ const result = await createCallLog.execute({
402
+ jwtToken: 'mock-jwt-token',
403
+ incomingData: mockIncomingData
404
+ });
405
+
406
+ // Assert
407
+ expect(result.success).toBe(false);
408
+ expect(result.error).toBe('Failed to create log in CRM');
409
+ });
410
+
411
+ test('should handle unexpected errors gracefully', async () => {
412
+ // Arrange
413
+ const mockIncomingData = {
414
+ logInfo: {
415
+ sessionId: 'session-error'
416
+ }
417
+ };
418
+
419
+ CallLogModel.findOne.mockRejectedValue(
420
+ new Error('Database connection failed')
421
+ );
422
+
423
+ // Act
424
+ const result = await createCallLog.execute({
425
+ jwtToken: 'mock-jwt-token',
426
+ incomingData: mockIncomingData
427
+ });
428
+
429
+ // Assert
430
+ expect(result.success).toBe(false);
431
+ expect(result.error).toBe('Database connection failed');
432
+ expect(result.errorDetails).toBeDefined();
433
+ });
434
+ });
435
+ });
436
+