@app-connect/core 1.7.24 → 1.7.26

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 (137) hide show
  1. package/.env.test +5 -5
  2. package/README.md +441 -441
  3. package/connector/developerPortal.js +31 -42
  4. package/connector/mock.js +84 -77
  5. package/connector/proxy/engine.js +164 -163
  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 -117
  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 +296 -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 +984 -973
  23. package/handlers/managedAuth.js +446 -446
  24. package/handlers/plugin.js +208 -208
  25. package/handlers/user.js +142 -142
  26. package/index.js +3140 -2652
  27. package/jest.config.js +56 -56
  28. package/lib/analytics.js +54 -54
  29. package/lib/authSession.js +109 -109
  30. package/lib/cacheCleanup.js +21 -0
  31. package/lib/callLogComposer.js +898 -898
  32. package/lib/callLogLookup.js +34 -0
  33. package/lib/constants.js +8 -8
  34. package/lib/debugTracer.js +177 -177
  35. package/lib/encode.js +30 -30
  36. package/lib/errorHandler.js +218 -206
  37. package/lib/generalErrorMessage.js +41 -41
  38. package/lib/jwt.js +18 -18
  39. package/lib/logger.js +190 -190
  40. package/lib/migrateCallLogsSchema.js +116 -0
  41. package/lib/ringcentral.js +266 -266
  42. package/lib/s3ErrorLogReport.js +65 -65
  43. package/lib/sharedSMSComposer.js +471 -471
  44. package/lib/util.js +67 -67
  45. package/mcp/README.md +412 -395
  46. package/mcp/lib/validator.js +91 -91
  47. package/mcp/mcpHandler.js +425 -425
  48. package/mcp/tools/cancelAppointment.js +101 -0
  49. package/mcp/tools/checkAuthStatus.js +105 -105
  50. package/mcp/tools/confirmAppointment.js +101 -0
  51. package/mcp/tools/createAppointment.js +157 -0
  52. package/mcp/tools/createCallLog.js +327 -316
  53. package/mcp/tools/createContact.js +117 -117
  54. package/mcp/tools/createMessageLog.js +287 -287
  55. package/mcp/tools/doAuth.js +60 -60
  56. package/mcp/tools/findContactByName.js +93 -93
  57. package/mcp/tools/findContactByPhone.js +101 -101
  58. package/mcp/tools/getCallLog.js +111 -102
  59. package/mcp/tools/getGoogleFilePicker.js +99 -99
  60. package/mcp/tools/getHelp.js +43 -43
  61. package/mcp/tools/getPublicConnectors.js +94 -94
  62. package/mcp/tools/getSessionInfo.js +90 -90
  63. package/mcp/tools/index.js +51 -41
  64. package/mcp/tools/listAppointments.js +163 -0
  65. package/mcp/tools/logout.js +96 -96
  66. package/mcp/tools/rcGetCallLogs.js +65 -65
  67. package/mcp/tools/updateAppointment.js +154 -0
  68. package/mcp/tools/updateCallLog.js +130 -126
  69. package/mcp/ui/App/App.tsx +358 -358
  70. package/mcp/ui/App/components/AuthInfoForm.tsx +113 -113
  71. package/mcp/ui/App/components/AuthSuccess.tsx +22 -22
  72. package/mcp/ui/App/components/ConnectorList.tsx +82 -82
  73. package/mcp/ui/App/components/DebugPanel.tsx +43 -43
  74. package/mcp/ui/App/components/OAuthConnect.tsx +270 -270
  75. package/mcp/ui/App/lib/callTool.ts +130 -130
  76. package/mcp/ui/App/lib/debugLog.ts +41 -41
  77. package/mcp/ui/App/lib/developerPortal.ts +111 -111
  78. package/mcp/ui/App/main.css +5 -5
  79. package/mcp/ui/App/root.tsx +13 -13
  80. package/mcp/ui/index.html +13 -13
  81. package/mcp/ui/package-lock.json +6356 -6356
  82. package/mcp/ui/package.json +25 -25
  83. package/mcp/ui/tsconfig.json +26 -26
  84. package/mcp/ui/vite.config.ts +16 -16
  85. package/models/accountDataModel.js +33 -33
  86. package/models/adminConfigModel.js +35 -35
  87. package/models/cacheModel.js +30 -26
  88. package/models/callDownListModel.js +34 -34
  89. package/models/callLogModel.js +33 -27
  90. package/models/dynamo/connectorSchema.js +146 -146
  91. package/models/dynamo/lockSchema.js +24 -24
  92. package/models/dynamo/noteCacheSchema.js +29 -29
  93. package/models/llmSessionModel.js +17 -17
  94. package/models/messageLogModel.js +25 -25
  95. package/models/sequelize.js +16 -16
  96. package/models/userModel.js +45 -45
  97. package/package.json +72 -72
  98. package/releaseNotes.json +1093 -1073
  99. package/test/connector/proxy/engine.test.js +126 -93
  100. package/test/connector/proxy/index.test.js +279 -279
  101. package/test/connector/proxy/sample.json +161 -161
  102. package/test/connector/registry.test.js +415 -415
  103. package/test/handlers/admin.test.js +616 -616
  104. package/test/handlers/auth.test.js +1018 -1015
  105. package/test/handlers/contact.test.js +1014 -1014
  106. package/test/handlers/log.test.js +1298 -1160
  107. package/test/handlers/managedAuth.test.js +458 -458
  108. package/test/handlers/plugin.test.js +380 -380
  109. package/test/index.test.js +105 -105
  110. package/test/lib/cacheCleanup.test.js +42 -0
  111. package/test/lib/callLogComposer.test.js +1231 -1231
  112. package/test/lib/debugTracer.test.js +328 -328
  113. package/test/lib/jwt.test.js +176 -176
  114. package/test/lib/logger.test.js +206 -206
  115. package/test/lib/oauth.test.js +359 -359
  116. package/test/lib/ringcentral.test.js +467 -467
  117. package/test/lib/sharedSMSComposer.test.js +1084 -1084
  118. package/test/lib/util.test.js +329 -329
  119. package/test/mcp/tools/checkAuthStatus.test.js +83 -82
  120. package/test/mcp/tools/createCallLog.test.js +436 -436
  121. package/test/mcp/tools/createContact.test.js +58 -58
  122. package/test/mcp/tools/createMessageLog.test.js +595 -595
  123. package/test/mcp/tools/doAuth.test.js +113 -113
  124. package/test/mcp/tools/findContactByName.test.js +275 -275
  125. package/test/mcp/tools/findContactByPhone.test.js +296 -296
  126. package/test/mcp/tools/getCallLog.test.js +298 -298
  127. package/test/mcp/tools/getGoogleFilePicker.test.js +281 -281
  128. package/test/mcp/tools/getPublicConnectors.test.js +107 -107
  129. package/test/mcp/tools/getSessionInfo.test.js +127 -127
  130. package/test/mcp/tools/logout.test.js +233 -233
  131. package/test/mcp/tools/rcGetCallLogs.test.js +56 -56
  132. package/test/mcp/tools/updateCallLog.test.js +360 -360
  133. package/test/models/accountDataModel.test.js +98 -98
  134. package/test/models/dynamo/connectorSchema.test.js +189 -189
  135. package/test/models/models.test.js +568 -539
  136. package/test/routes/managedAuthRoutes.test.js +104 -129
  137. package/test/setup.js +178 -178
@@ -1,595 +1,595 @@
1
- const createMessageLog = require('../../../mcp/tools/createMessageLog');
2
- const jwt = require('../../../lib/jwt');
3
- const connectorRegistry = require('../../../connector/registry');
4
- const logCore = require('../../../handlers/log');
5
-
6
- // Mock dependencies
7
- jest.mock('../../../lib/jwt');
8
- jest.mock('../../../connector/registry');
9
- jest.mock('../../../handlers/log');
10
-
11
- describe('MCP Tool: createMessageLog', () => {
12
- beforeEach(() => {
13
- jest.clearAllMocks();
14
- });
15
-
16
- describe('tool definition', () => {
17
- test('should have correct tool definition', () => {
18
- expect(createMessageLog.definition).toBeDefined();
19
- expect(createMessageLog.definition.name).toBe('createMessageLog');
20
- expect(createMessageLog.definition.description).toContain('REQUIRES AUTHENTICATION');
21
- expect(createMessageLog.definition.inputSchema).toBeDefined();
22
- });
23
-
24
- test('should require jwtToken and incomingData parameters', () => {
25
- expect(createMessageLog.definition.inputSchema.required).toContain('jwtToken');
26
- expect(createMessageLog.definition.inputSchema.required).toContain('incomingData');
27
- });
28
-
29
- test('should have detailed inputSchema for incomingData', () => {
30
- const incomingDataSchema = createMessageLog.definition.inputSchema.properties.incomingData;
31
- expect(incomingDataSchema.properties).toHaveProperty('conversation');
32
- expect(incomingDataSchema.properties).toHaveProperty('contactId');
33
- expect(incomingDataSchema.properties).toHaveProperty('contactName');
34
- expect(incomingDataSchema.required).toContain('conversation');
35
- expect(incomingDataSchema.required).toContain('contactId');
36
- expect(incomingDataSchema.required).toContain('contactName');
37
- });
38
- });
39
-
40
- describe('execute', () => {
41
- test('should create message log successfully', async () => {
42
- // Arrange
43
- const mockIncomingData = {
44
- conversation: {
45
- conversationId: 'conv-123',
46
- conversationLogId: 'conv-log-123',
47
- type: 'SMS',
48
- messages: [
49
- {
50
- id: 'msg-123',
51
- conversationId: 'conv-123',
52
- phoneNumber: '+1234567890',
53
- direction: 'Inbound',
54
- creationTime: 1704110400000,
55
- subject: 'Hello',
56
- from: { phoneNumber: '+1234567890', name: 'John Doe' },
57
- to: [{ phoneNumber: '+0987654321' }]
58
- }
59
- ],
60
- correspondents: [
61
- { phoneNumber: '+1234567890' }
62
- ]
63
- },
64
- contactId: 'contact-123',
65
- contactName: 'John Doe',
66
- contactType: 'Contact'
67
- };
68
-
69
- jwt.decodeJwt.mockReturnValue({
70
- id: 'user-123',
71
- platform: 'testCRM'
72
- });
73
-
74
- const mockConnector = {
75
- createMessageLog: jest.fn()
76
- };
77
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
78
-
79
- logCore.createMessageLog.mockResolvedValue({
80
- successful: true,
81
- logIds: ['crm-msg-log-123'],
82
- returnMessage: { message: 'Message logs created successfully' }
83
- });
84
-
85
- // Act
86
- const result = await createMessageLog.execute({
87
- jwtToken: 'mock-jwt-token',
88
- incomingData: mockIncomingData
89
- });
90
-
91
- // Assert
92
- expect(result).toEqual({
93
- success: true,
94
- data: {
95
- logIds: ['crm-msg-log-123'],
96
- message: 'Message logs created successfully'
97
- }
98
- });
99
- expect(jwt.decodeJwt).toHaveBeenCalledWith('mock-jwt-token');
100
- expect(logCore.createMessageLog).toHaveBeenCalledWith({
101
- platform: 'testCRM',
102
- userId: 'user-123',
103
- incomingData: expect.objectContaining({
104
- contactId: 'contact-123',
105
- contactName: 'John Doe',
106
- logInfo: mockIncomingData.conversation
107
- })
108
- });
109
- });
110
-
111
- test('should create message log with multiple messages', async () => {
112
- // Arrange
113
- const mockIncomingData = {
114
- conversation: {
115
- conversationId: 'conv-456',
116
- conversationLogId: 'conv-log-456',
117
- type: 'SMS',
118
- messages: [
119
- {
120
- id: 'msg-456-1',
121
- conversationId: 'conv-456',
122
- phoneNumber: '+1234567890',
123
- direction: 'Outbound',
124
- from: { phoneNumber: '+0987654321' },
125
- to: [{ phoneNumber: '+1234567890' }]
126
- },
127
- {
128
- id: 'msg-456-2',
129
- conversationId: 'conv-456',
130
- phoneNumber: '+1234567890',
131
- direction: 'Inbound',
132
- from: { phoneNumber: '+1234567890' },
133
- to: [{ phoneNumber: '+0987654321' }]
134
- }
135
- ],
136
- correspondents: [
137
- { phoneNumber: '+1234567890' }
138
- ]
139
- },
140
- contactId: 'contact-456',
141
- contactName: 'Jane Smith'
142
- };
143
-
144
- jwt.decodeJwt.mockReturnValue({
145
- id: 'user-123',
146
- platform: 'testCRM'
147
- });
148
-
149
- const mockConnector = {
150
- createMessageLog: jest.fn()
151
- };
152
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
153
-
154
- logCore.createMessageLog.mockResolvedValue({
155
- successful: true,
156
- logIds: ['crm-msg-log-456-1', 'crm-msg-log-456-2']
157
- });
158
-
159
- // Act
160
- const result = await createMessageLog.execute({
161
- jwtToken: 'mock-jwt-token',
162
- incomingData: mockIncomingData
163
- });
164
-
165
- // Assert
166
- expect(result.success).toBe(true);
167
- expect(result.data.logIds).toHaveLength(2);
168
- });
169
-
170
- test('should create message log with attachments', async () => {
171
- // Arrange
172
- const mockIncomingData = {
173
- conversation: {
174
- conversationId: 'conv-789',
175
- conversationLogId: 'conv-log-789',
176
- type: 'MMS',
177
- messages: [
178
- {
179
- id: 'msg-789',
180
- conversationId: 'conv-789',
181
- phoneNumber: '+1234567890',
182
- direction: 'Inbound',
183
- from: { phoneNumber: '+1234567890' },
184
- to: [{ phoneNumber: '+0987654321' }],
185
- attachments: [
186
- {
187
- type: 'image',
188
- link: 'https://example.com/image.jpg',
189
- contentType: 'image/jpeg'
190
- }
191
- ]
192
- }
193
- ],
194
- correspondents: [
195
- { phoneNumber: '+1234567890' }
196
- ]
197
- },
198
- contactId: 'contact-789',
199
- contactName: 'Bob Johnson'
200
- };
201
-
202
- jwt.decodeJwt.mockReturnValue({
203
- id: 'user-123',
204
- platform: 'testCRM'
205
- });
206
-
207
- const mockConnector = {
208
- createMessageLog: jest.fn()
209
- };
210
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
211
-
212
- logCore.createMessageLog.mockResolvedValue({
213
- successful: true,
214
- logIds: ['crm-msg-log-789']
215
- });
216
-
217
- // Act
218
- const result = await createMessageLog.execute({
219
- jwtToken: 'mock-jwt-token',
220
- incomingData: mockIncomingData
221
- });
222
-
223
- // Assert
224
- expect(result.success).toBe(true);
225
- });
226
-
227
- test('should create fax message log', async () => {
228
- // Arrange
229
- const mockIncomingData = {
230
- conversation: {
231
- conversationId: 'conv-fax',
232
- conversationLogId: 'conv-log-fax',
233
- type: 'Fax',
234
- messages: [
235
- {
236
- id: 'msg-fax',
237
- conversationId: 'conv-fax',
238
- phoneNumber: '+1234567890',
239
- direction: 'Inbound',
240
- messageStatus: 'Received',
241
- faxPageCount: 5,
242
- from: { phoneNumber: '+1234567890' },
243
- to: [{ phoneNumber: '+0987654321' }]
244
- }
245
- ],
246
- correspondents: [
247
- { phoneNumber: '+1234567890' }
248
- ]
249
- },
250
- contactId: 'contact-fax',
251
- contactName: 'Fax Sender'
252
- };
253
-
254
- jwt.decodeJwt.mockReturnValue({
255
- id: 'user-123',
256
- platform: 'testCRM'
257
- });
258
-
259
- const mockConnector = {
260
- createMessageLog: jest.fn()
261
- };
262
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
263
-
264
- logCore.createMessageLog.mockResolvedValue({
265
- successful: true,
266
- logIds: ['crm-msg-log-fax']
267
- });
268
-
269
- // Act
270
- const result = await createMessageLog.execute({
271
- jwtToken: 'mock-jwt-token',
272
- incomingData: mockIncomingData
273
- });
274
-
275
- // Assert
276
- expect(result.success).toBe(true);
277
- });
278
-
279
- test('should create message log with additional submission', async () => {
280
- // Arrange
281
- const mockIncomingData = {
282
- conversation: {
283
- conversationId: 'conv-submit',
284
- conversationLogId: 'conv-log-submit',
285
- messages: [
286
- {
287
- id: 'msg-submit',
288
- conversationId: 'conv-submit',
289
- phoneNumber: '+1234567890',
290
- direction: 'Inbound',
291
- from: { phoneNumber: '+1234567890' },
292
- to: [{ phoneNumber: '+0987654321' }]
293
- }
294
- ],
295
- correspondents: [
296
- { phoneNumber: '+1234567890' }
297
- ]
298
- },
299
- contactId: 'contact-submit',
300
- contactName: 'Test User',
301
- additionalSubmission: {
302
- isAssignedToUser: true
303
- }
304
- };
305
-
306
- jwt.decodeJwt.mockReturnValue({
307
- id: 'user-123',
308
- platform: 'testCRM'
309
- });
310
-
311
- const mockConnector = {
312
- createMessageLog: jest.fn()
313
- };
314
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
315
-
316
- logCore.createMessageLog.mockResolvedValue({
317
- successful: true,
318
- logIds: ['crm-msg-log-submit']
319
- });
320
-
321
- // Act
322
- const result = await createMessageLog.execute({
323
- jwtToken: 'mock-jwt-token',
324
- incomingData: mockIncomingData
325
- });
326
-
327
- // Assert
328
- expect(result.success).toBe(true);
329
- });
330
-
331
- test('should handle logInfo alias for conversation', async () => {
332
- // Arrange
333
- const mockIncomingData = {
334
- logInfo: {
335
- conversationId: 'conv-alias',
336
- conversationLogId: 'conv-log-alias',
337
- messages: [
338
- {
339
- id: 'msg-alias',
340
- conversationId: 'conv-alias',
341
- phoneNumber: '+1234567890',
342
- direction: 'Inbound',
343
- from: { phoneNumber: '+1234567890' },
344
- to: [{ phoneNumber: '+0987654321' }]
345
- }
346
- ],
347
- correspondents: [
348
- { phoneNumber: '+1234567890' }
349
- ]
350
- },
351
- contactId: 'contact-alias',
352
- contactName: 'Alias Test'
353
- };
354
-
355
- jwt.decodeJwt.mockReturnValue({
356
- id: 'user-123',
357
- platform: 'testCRM'
358
- });
359
-
360
- const mockConnector = {
361
- createMessageLog: jest.fn()
362
- };
363
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
364
-
365
- logCore.createMessageLog.mockResolvedValue({
366
- successful: true,
367
- logIds: ['crm-msg-log-alias']
368
- });
369
-
370
- // Act
371
- const result = await createMessageLog.execute({
372
- jwtToken: 'mock-jwt-token',
373
- incomingData: mockIncomingData
374
- });
375
-
376
- // Assert
377
- expect(result.success).toBe(true);
378
- });
379
-
380
- test('should return error when jwtToken is missing', async () => {
381
- // Act
382
- const result = await createMessageLog.execute({
383
- incomingData: { conversation: {}, contactId: 'test', contactName: 'Test' }
384
- });
385
-
386
- // Assert
387
- expect(result.success).toBe(false);
388
- expect(result.error).toContain('authorize CRM platform');
389
- });
390
-
391
- test('should return error when incomingData is missing', async () => {
392
- // Act
393
- const result = await createMessageLog.execute({
394
- jwtToken: 'mock-jwt-token'
395
- });
396
-
397
- // Assert
398
- expect(result.success).toBe(false);
399
- expect(result.error).toContain('Incoming data must be provided');
400
- });
401
-
402
- test('should return error when JWT is invalid', async () => {
403
- // Arrange
404
- const mockIncomingData = {
405
- conversation: {
406
- conversationLogId: 'conv-123',
407
- messages: [],
408
- correspondents: []
409
- },
410
- contactId: 'contact-123',
411
- contactName: 'Test'
412
- };
413
-
414
- jwt.decodeJwt.mockReturnValue({
415
- platform: 'testCRM'
416
- // id is missing
417
- });
418
-
419
- // Act
420
- const result = await createMessageLog.execute({
421
- jwtToken: 'invalid-token',
422
- incomingData: mockIncomingData
423
- });
424
-
425
- // Assert
426
- expect(result.success).toBe(false);
427
- expect(result.error).toContain('Invalid JWT token');
428
- });
429
-
430
- test('should return error when decodeJwt returns null', async () => {
431
- jwt.decodeJwt.mockReturnValue(null);
432
-
433
- const result = await createMessageLog.execute({
434
- jwtToken: 'invalid-token',
435
- incomingData: {
436
- sessionId: 'session-123',
437
- messageInfo: { from: { phoneNumber: '+1234567890' }, to: [{ phoneNumber: '+1098765432' }] }
438
- }
439
- });
440
-
441
- expect(result.success).toBe(false);
442
- expect(result.error).toContain('Invalid JWT token');
443
- });
444
-
445
- test('should return error when platform connector not found', async () => {
446
- // Arrange
447
- const mockIncomingData = {
448
- conversation: {
449
- conversationLogId: 'conv-123',
450
- messages: [],
451
- correspondents: []
452
- },
453
- contactId: 'contact-123',
454
- contactName: 'Test'
455
- };
456
-
457
- jwt.decodeJwt.mockReturnValue({
458
- id: 'user-123',
459
- platform: 'unknownCRM'
460
- });
461
-
462
- connectorRegistry.getConnector.mockReturnValue(null);
463
-
464
- // Act
465
- const result = await createMessageLog.execute({
466
- jwtToken: 'mock-jwt-token',
467
- incomingData: mockIncomingData
468
- });
469
-
470
- // Assert
471
- expect(result.success).toBe(false);
472
- expect(result.error).toContain('Platform connector not found');
473
- });
474
-
475
- test('should return error when createMessageLog is not implemented', async () => {
476
- // Arrange
477
- const mockIncomingData = {
478
- conversation: {
479
- conversationLogId: 'conv-123',
480
- messages: [],
481
- correspondents: []
482
- },
483
- contactId: 'contact-123',
484
- contactName: 'Test'
485
- };
486
-
487
- jwt.decodeJwt.mockReturnValue({
488
- id: 'user-123',
489
- platform: 'testCRM'
490
- });
491
-
492
- const mockConnector = {}; // No createMessageLog method
493
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
494
-
495
- // Act
496
- const result = await createMessageLog.execute({
497
- jwtToken: 'mock-jwt-token',
498
- incomingData: mockIncomingData
499
- });
500
-
501
- // Assert
502
- expect(result.success).toBe(false);
503
- expect(result.error).toContain('not implemented');
504
- });
505
-
506
- test('should return error when creation fails', async () => {
507
- // Arrange
508
- const mockIncomingData = {
509
- conversation: {
510
- conversationId: 'conv-fail',
511
- conversationLogId: 'conv-log-fail',
512
- messages: [
513
- {
514
- id: 'msg-fail',
515
- conversationId: 'conv-fail',
516
- phoneNumber: '+1234567890',
517
- direction: 'Inbound',
518
- from: { phoneNumber: '+1234567890' },
519
- to: [{ phoneNumber: '+0987654321' }]
520
- }
521
- ],
522
- correspondents: [
523
- { phoneNumber: '+1234567890' }
524
- ]
525
- },
526
- contactId: 'contact-fail',
527
- contactName: 'Fail Test'
528
- };
529
-
530
- jwt.decodeJwt.mockReturnValue({
531
- id: 'user-123',
532
- platform: 'testCRM'
533
- });
534
-
535
- const mockConnector = {
536
- createMessageLog: jest.fn()
537
- };
538
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
539
-
540
- logCore.createMessageLog.mockResolvedValue({
541
- successful: false,
542
- returnMessage: { message: 'Failed to create message logs in CRM' }
543
- });
544
-
545
- // Act
546
- const result = await createMessageLog.execute({
547
- jwtToken: 'mock-jwt-token',
548
- incomingData: mockIncomingData
549
- });
550
-
551
- // Assert
552
- expect(result.success).toBe(false);
553
- expect(result.error).toBe('Failed to create message logs in CRM');
554
- });
555
-
556
- test('should handle unexpected errors gracefully', async () => {
557
- // Arrange
558
- const mockIncomingData = {
559
- conversation: {
560
- conversationLogId: 'conv-error',
561
- messages: [],
562
- correspondents: []
563
- },
564
- contactId: 'contact-error',
565
- contactName: 'Error Test'
566
- };
567
-
568
- jwt.decodeJwt.mockReturnValue({
569
- id: 'user-123',
570
- platform: 'testCRM'
571
- });
572
-
573
- const mockConnector = {
574
- createMessageLog: jest.fn()
575
- };
576
- connectorRegistry.getConnector.mockReturnValue(mockConnector);
577
-
578
- logCore.createMessageLog.mockRejectedValue(
579
- new Error('Network timeout')
580
- );
581
-
582
- // Act
583
- const result = await createMessageLog.execute({
584
- jwtToken: 'mock-jwt-token',
585
- incomingData: mockIncomingData
586
- });
587
-
588
- // Assert
589
- expect(result.success).toBe(false);
590
- expect(result.error).toBe('Network timeout');
591
- expect(result.errorDetails).toBeDefined();
592
- });
593
- });
594
- });
595
-
1
+ const createMessageLog = require('../../../mcp/tools/createMessageLog');
2
+ const jwt = require('../../../lib/jwt');
3
+ const connectorRegistry = require('../../../connector/registry');
4
+ const logCore = require('../../../handlers/log');
5
+
6
+ // Mock dependencies
7
+ jest.mock('../../../lib/jwt');
8
+ jest.mock('../../../connector/registry');
9
+ jest.mock('../../../handlers/log');
10
+
11
+ describe('MCP Tool: createMessageLog', () => {
12
+ beforeEach(() => {
13
+ jest.clearAllMocks();
14
+ });
15
+
16
+ describe('tool definition', () => {
17
+ test('should have correct tool definition', () => {
18
+ expect(createMessageLog.definition).toBeDefined();
19
+ expect(createMessageLog.definition.name).toBe('createMessageLog');
20
+ expect(createMessageLog.definition.description).toContain('REQUIRES AUTHENTICATION');
21
+ expect(createMessageLog.definition.inputSchema).toBeDefined();
22
+ });
23
+
24
+ test('should require jwtToken and incomingData parameters', () => {
25
+ expect(createMessageLog.definition.inputSchema.required).toContain('jwtToken');
26
+ expect(createMessageLog.definition.inputSchema.required).toContain('incomingData');
27
+ });
28
+
29
+ test('should have detailed inputSchema for incomingData', () => {
30
+ const incomingDataSchema = createMessageLog.definition.inputSchema.properties.incomingData;
31
+ expect(incomingDataSchema.properties).toHaveProperty('conversation');
32
+ expect(incomingDataSchema.properties).toHaveProperty('contactId');
33
+ expect(incomingDataSchema.properties).toHaveProperty('contactName');
34
+ expect(incomingDataSchema.required).toContain('conversation');
35
+ expect(incomingDataSchema.required).toContain('contactId');
36
+ expect(incomingDataSchema.required).toContain('contactName');
37
+ });
38
+ });
39
+
40
+ describe('execute', () => {
41
+ test('should create message log successfully', async () => {
42
+ // Arrange
43
+ const mockIncomingData = {
44
+ conversation: {
45
+ conversationId: 'conv-123',
46
+ conversationLogId: 'conv-log-123',
47
+ type: 'SMS',
48
+ messages: [
49
+ {
50
+ id: 'msg-123',
51
+ conversationId: 'conv-123',
52
+ phoneNumber: '+1234567890',
53
+ direction: 'Inbound',
54
+ creationTime: 1704110400000,
55
+ subject: 'Hello',
56
+ from: { phoneNumber: '+1234567890', name: 'John Doe' },
57
+ to: [{ phoneNumber: '+0987654321' }]
58
+ }
59
+ ],
60
+ correspondents: [
61
+ { phoneNumber: '+1234567890' }
62
+ ]
63
+ },
64
+ contactId: 'contact-123',
65
+ contactName: 'John Doe',
66
+ contactType: 'Contact'
67
+ };
68
+
69
+ jwt.decodeJwt.mockReturnValue({
70
+ id: 'user-123',
71
+ platform: 'testCRM'
72
+ });
73
+
74
+ const mockConnector = {
75
+ createMessageLog: jest.fn()
76
+ };
77
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
78
+
79
+ logCore.createMessageLog.mockResolvedValue({
80
+ successful: true,
81
+ logIds: ['crm-msg-log-123'],
82
+ returnMessage: { message: 'Message logs created successfully' }
83
+ });
84
+
85
+ // Act
86
+ const result = await createMessageLog.execute({
87
+ jwtToken: 'mock-jwt-token',
88
+ incomingData: mockIncomingData
89
+ });
90
+
91
+ // Assert
92
+ expect(result).toEqual({
93
+ success: true,
94
+ data: {
95
+ logIds: ['crm-msg-log-123'],
96
+ message: 'Message logs created successfully'
97
+ }
98
+ });
99
+ expect(jwt.decodeJwt).toHaveBeenCalledWith('mock-jwt-token');
100
+ expect(logCore.createMessageLog).toHaveBeenCalledWith({
101
+ platform: 'testCRM',
102
+ userId: 'user-123',
103
+ incomingData: expect.objectContaining({
104
+ contactId: 'contact-123',
105
+ contactName: 'John Doe',
106
+ logInfo: mockIncomingData.conversation
107
+ })
108
+ });
109
+ });
110
+
111
+ test('should create message log with multiple messages', async () => {
112
+ // Arrange
113
+ const mockIncomingData = {
114
+ conversation: {
115
+ conversationId: 'conv-456',
116
+ conversationLogId: 'conv-log-456',
117
+ type: 'SMS',
118
+ messages: [
119
+ {
120
+ id: 'msg-456-1',
121
+ conversationId: 'conv-456',
122
+ phoneNumber: '+1234567890',
123
+ direction: 'Outbound',
124
+ from: { phoneNumber: '+0987654321' },
125
+ to: [{ phoneNumber: '+1234567890' }]
126
+ },
127
+ {
128
+ id: 'msg-456-2',
129
+ conversationId: 'conv-456',
130
+ phoneNumber: '+1234567890',
131
+ direction: 'Inbound',
132
+ from: { phoneNumber: '+1234567890' },
133
+ to: [{ phoneNumber: '+0987654321' }]
134
+ }
135
+ ],
136
+ correspondents: [
137
+ { phoneNumber: '+1234567890' }
138
+ ]
139
+ },
140
+ contactId: 'contact-456',
141
+ contactName: 'Jane Smith'
142
+ };
143
+
144
+ jwt.decodeJwt.mockReturnValue({
145
+ id: 'user-123',
146
+ platform: 'testCRM'
147
+ });
148
+
149
+ const mockConnector = {
150
+ createMessageLog: jest.fn()
151
+ };
152
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
153
+
154
+ logCore.createMessageLog.mockResolvedValue({
155
+ successful: true,
156
+ logIds: ['crm-msg-log-456-1', 'crm-msg-log-456-2']
157
+ });
158
+
159
+ // Act
160
+ const result = await createMessageLog.execute({
161
+ jwtToken: 'mock-jwt-token',
162
+ incomingData: mockIncomingData
163
+ });
164
+
165
+ // Assert
166
+ expect(result.success).toBe(true);
167
+ expect(result.data.logIds).toHaveLength(2);
168
+ });
169
+
170
+ test('should create message log with attachments', async () => {
171
+ // Arrange
172
+ const mockIncomingData = {
173
+ conversation: {
174
+ conversationId: 'conv-789',
175
+ conversationLogId: 'conv-log-789',
176
+ type: 'MMS',
177
+ messages: [
178
+ {
179
+ id: 'msg-789',
180
+ conversationId: 'conv-789',
181
+ phoneNumber: '+1234567890',
182
+ direction: 'Inbound',
183
+ from: { phoneNumber: '+1234567890' },
184
+ to: [{ phoneNumber: '+0987654321' }],
185
+ attachments: [
186
+ {
187
+ type: 'image',
188
+ link: 'https://example.com/image.jpg',
189
+ contentType: 'image/jpeg'
190
+ }
191
+ ]
192
+ }
193
+ ],
194
+ correspondents: [
195
+ { phoneNumber: '+1234567890' }
196
+ ]
197
+ },
198
+ contactId: 'contact-789',
199
+ contactName: 'Bob Johnson'
200
+ };
201
+
202
+ jwt.decodeJwt.mockReturnValue({
203
+ id: 'user-123',
204
+ platform: 'testCRM'
205
+ });
206
+
207
+ const mockConnector = {
208
+ createMessageLog: jest.fn()
209
+ };
210
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
211
+
212
+ logCore.createMessageLog.mockResolvedValue({
213
+ successful: true,
214
+ logIds: ['crm-msg-log-789']
215
+ });
216
+
217
+ // Act
218
+ const result = await createMessageLog.execute({
219
+ jwtToken: 'mock-jwt-token',
220
+ incomingData: mockIncomingData
221
+ });
222
+
223
+ // Assert
224
+ expect(result.success).toBe(true);
225
+ });
226
+
227
+ test('should create fax message log', async () => {
228
+ // Arrange
229
+ const mockIncomingData = {
230
+ conversation: {
231
+ conversationId: 'conv-fax',
232
+ conversationLogId: 'conv-log-fax',
233
+ type: 'Fax',
234
+ messages: [
235
+ {
236
+ id: 'msg-fax',
237
+ conversationId: 'conv-fax',
238
+ phoneNumber: '+1234567890',
239
+ direction: 'Inbound',
240
+ messageStatus: 'Received',
241
+ faxPageCount: 5,
242
+ from: { phoneNumber: '+1234567890' },
243
+ to: [{ phoneNumber: '+0987654321' }]
244
+ }
245
+ ],
246
+ correspondents: [
247
+ { phoneNumber: '+1234567890' }
248
+ ]
249
+ },
250
+ contactId: 'contact-fax',
251
+ contactName: 'Fax Sender'
252
+ };
253
+
254
+ jwt.decodeJwt.mockReturnValue({
255
+ id: 'user-123',
256
+ platform: 'testCRM'
257
+ });
258
+
259
+ const mockConnector = {
260
+ createMessageLog: jest.fn()
261
+ };
262
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
263
+
264
+ logCore.createMessageLog.mockResolvedValue({
265
+ successful: true,
266
+ logIds: ['crm-msg-log-fax']
267
+ });
268
+
269
+ // Act
270
+ const result = await createMessageLog.execute({
271
+ jwtToken: 'mock-jwt-token',
272
+ incomingData: mockIncomingData
273
+ });
274
+
275
+ // Assert
276
+ expect(result.success).toBe(true);
277
+ });
278
+
279
+ test('should create message log with additional submission', async () => {
280
+ // Arrange
281
+ const mockIncomingData = {
282
+ conversation: {
283
+ conversationId: 'conv-submit',
284
+ conversationLogId: 'conv-log-submit',
285
+ messages: [
286
+ {
287
+ id: 'msg-submit',
288
+ conversationId: 'conv-submit',
289
+ phoneNumber: '+1234567890',
290
+ direction: 'Inbound',
291
+ from: { phoneNumber: '+1234567890' },
292
+ to: [{ phoneNumber: '+0987654321' }]
293
+ }
294
+ ],
295
+ correspondents: [
296
+ { phoneNumber: '+1234567890' }
297
+ ]
298
+ },
299
+ contactId: 'contact-submit',
300
+ contactName: 'Test User',
301
+ additionalSubmission: {
302
+ isAssignedToUser: true
303
+ }
304
+ };
305
+
306
+ jwt.decodeJwt.mockReturnValue({
307
+ id: 'user-123',
308
+ platform: 'testCRM'
309
+ });
310
+
311
+ const mockConnector = {
312
+ createMessageLog: jest.fn()
313
+ };
314
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
315
+
316
+ logCore.createMessageLog.mockResolvedValue({
317
+ successful: true,
318
+ logIds: ['crm-msg-log-submit']
319
+ });
320
+
321
+ // Act
322
+ const result = await createMessageLog.execute({
323
+ jwtToken: 'mock-jwt-token',
324
+ incomingData: mockIncomingData
325
+ });
326
+
327
+ // Assert
328
+ expect(result.success).toBe(true);
329
+ });
330
+
331
+ test('should handle logInfo alias for conversation', async () => {
332
+ // Arrange
333
+ const mockIncomingData = {
334
+ logInfo: {
335
+ conversationId: 'conv-alias',
336
+ conversationLogId: 'conv-log-alias',
337
+ messages: [
338
+ {
339
+ id: 'msg-alias',
340
+ conversationId: 'conv-alias',
341
+ phoneNumber: '+1234567890',
342
+ direction: 'Inbound',
343
+ from: { phoneNumber: '+1234567890' },
344
+ to: [{ phoneNumber: '+0987654321' }]
345
+ }
346
+ ],
347
+ correspondents: [
348
+ { phoneNumber: '+1234567890' }
349
+ ]
350
+ },
351
+ contactId: 'contact-alias',
352
+ contactName: 'Alias Test'
353
+ };
354
+
355
+ jwt.decodeJwt.mockReturnValue({
356
+ id: 'user-123',
357
+ platform: 'testCRM'
358
+ });
359
+
360
+ const mockConnector = {
361
+ createMessageLog: jest.fn()
362
+ };
363
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
364
+
365
+ logCore.createMessageLog.mockResolvedValue({
366
+ successful: true,
367
+ logIds: ['crm-msg-log-alias']
368
+ });
369
+
370
+ // Act
371
+ const result = await createMessageLog.execute({
372
+ jwtToken: 'mock-jwt-token',
373
+ incomingData: mockIncomingData
374
+ });
375
+
376
+ // Assert
377
+ expect(result.success).toBe(true);
378
+ });
379
+
380
+ test('should return error when jwtToken is missing', async () => {
381
+ // Act
382
+ const result = await createMessageLog.execute({
383
+ incomingData: { conversation: {}, contactId: 'test', contactName: 'Test' }
384
+ });
385
+
386
+ // Assert
387
+ expect(result.success).toBe(false);
388
+ expect(result.error).toContain('authorize CRM platform');
389
+ });
390
+
391
+ test('should return error when incomingData is missing', async () => {
392
+ // Act
393
+ const result = await createMessageLog.execute({
394
+ jwtToken: 'mock-jwt-token'
395
+ });
396
+
397
+ // Assert
398
+ expect(result.success).toBe(false);
399
+ expect(result.error).toContain('Incoming data must be provided');
400
+ });
401
+
402
+ test('should return error when JWT is invalid', async () => {
403
+ // Arrange
404
+ const mockIncomingData = {
405
+ conversation: {
406
+ conversationLogId: 'conv-123',
407
+ messages: [],
408
+ correspondents: []
409
+ },
410
+ contactId: 'contact-123',
411
+ contactName: 'Test'
412
+ };
413
+
414
+ jwt.decodeJwt.mockReturnValue({
415
+ platform: 'testCRM'
416
+ // id is missing
417
+ });
418
+
419
+ // Act
420
+ const result = await createMessageLog.execute({
421
+ jwtToken: 'invalid-token',
422
+ incomingData: mockIncomingData
423
+ });
424
+
425
+ // Assert
426
+ expect(result.success).toBe(false);
427
+ expect(result.error).toContain('Invalid JWT token');
428
+ });
429
+
430
+ test('should return error when decodeJwt returns null', async () => {
431
+ jwt.decodeJwt.mockReturnValue(null);
432
+
433
+ const result = await createMessageLog.execute({
434
+ jwtToken: 'invalid-token',
435
+ incomingData: {
436
+ sessionId: 'session-123',
437
+ messageInfo: { from: { phoneNumber: '+1234567890' }, to: [{ phoneNumber: '+1098765432' }] }
438
+ }
439
+ });
440
+
441
+ expect(result.success).toBe(false);
442
+ expect(result.error).toContain('Invalid JWT token');
443
+ });
444
+
445
+ test('should return error when platform connector not found', async () => {
446
+ // Arrange
447
+ const mockIncomingData = {
448
+ conversation: {
449
+ conversationLogId: 'conv-123',
450
+ messages: [],
451
+ correspondents: []
452
+ },
453
+ contactId: 'contact-123',
454
+ contactName: 'Test'
455
+ };
456
+
457
+ jwt.decodeJwt.mockReturnValue({
458
+ id: 'user-123',
459
+ platform: 'unknownCRM'
460
+ });
461
+
462
+ connectorRegistry.getConnector.mockReturnValue(null);
463
+
464
+ // Act
465
+ const result = await createMessageLog.execute({
466
+ jwtToken: 'mock-jwt-token',
467
+ incomingData: mockIncomingData
468
+ });
469
+
470
+ // Assert
471
+ expect(result.success).toBe(false);
472
+ expect(result.error).toContain('Platform connector not found');
473
+ });
474
+
475
+ test('should return error when createMessageLog is not implemented', async () => {
476
+ // Arrange
477
+ const mockIncomingData = {
478
+ conversation: {
479
+ conversationLogId: 'conv-123',
480
+ messages: [],
481
+ correspondents: []
482
+ },
483
+ contactId: 'contact-123',
484
+ contactName: 'Test'
485
+ };
486
+
487
+ jwt.decodeJwt.mockReturnValue({
488
+ id: 'user-123',
489
+ platform: 'testCRM'
490
+ });
491
+
492
+ const mockConnector = {}; // No createMessageLog method
493
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
494
+
495
+ // Act
496
+ const result = await createMessageLog.execute({
497
+ jwtToken: 'mock-jwt-token',
498
+ incomingData: mockIncomingData
499
+ });
500
+
501
+ // Assert
502
+ expect(result.success).toBe(false);
503
+ expect(result.error).toContain('not implemented');
504
+ });
505
+
506
+ test('should return error when creation fails', async () => {
507
+ // Arrange
508
+ const mockIncomingData = {
509
+ conversation: {
510
+ conversationId: 'conv-fail',
511
+ conversationLogId: 'conv-log-fail',
512
+ messages: [
513
+ {
514
+ id: 'msg-fail',
515
+ conversationId: 'conv-fail',
516
+ phoneNumber: '+1234567890',
517
+ direction: 'Inbound',
518
+ from: { phoneNumber: '+1234567890' },
519
+ to: [{ phoneNumber: '+0987654321' }]
520
+ }
521
+ ],
522
+ correspondents: [
523
+ { phoneNumber: '+1234567890' }
524
+ ]
525
+ },
526
+ contactId: 'contact-fail',
527
+ contactName: 'Fail Test'
528
+ };
529
+
530
+ jwt.decodeJwt.mockReturnValue({
531
+ id: 'user-123',
532
+ platform: 'testCRM'
533
+ });
534
+
535
+ const mockConnector = {
536
+ createMessageLog: jest.fn()
537
+ };
538
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
539
+
540
+ logCore.createMessageLog.mockResolvedValue({
541
+ successful: false,
542
+ returnMessage: { message: 'Failed to create message logs in CRM' }
543
+ });
544
+
545
+ // Act
546
+ const result = await createMessageLog.execute({
547
+ jwtToken: 'mock-jwt-token',
548
+ incomingData: mockIncomingData
549
+ });
550
+
551
+ // Assert
552
+ expect(result.success).toBe(false);
553
+ expect(result.error).toBe('Failed to create message logs in CRM');
554
+ });
555
+
556
+ test('should handle unexpected errors gracefully', async () => {
557
+ // Arrange
558
+ const mockIncomingData = {
559
+ conversation: {
560
+ conversationLogId: 'conv-error',
561
+ messages: [],
562
+ correspondents: []
563
+ },
564
+ contactId: 'contact-error',
565
+ contactName: 'Error Test'
566
+ };
567
+
568
+ jwt.decodeJwt.mockReturnValue({
569
+ id: 'user-123',
570
+ platform: 'testCRM'
571
+ });
572
+
573
+ const mockConnector = {
574
+ createMessageLog: jest.fn()
575
+ };
576
+ connectorRegistry.getConnector.mockReturnValue(mockConnector);
577
+
578
+ logCore.createMessageLog.mockRejectedValue(
579
+ new Error('Network timeout')
580
+ );
581
+
582
+ // Act
583
+ const result = await createMessageLog.execute({
584
+ jwtToken: 'mock-jwt-token',
585
+ incomingData: mockIncomingData
586
+ });
587
+
588
+ // Assert
589
+ expect(result.success).toBe(false);
590
+ expect(result.error).toBe('Network timeout');
591
+ expect(result.errorDetails).toBeDefined();
592
+ });
593
+ });
594
+ });
595
+