@app-connect/core 1.7.25 → 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 -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 +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 +1 -1
  98. package/releaseNotes.json +1093 -1081
  99. package/test/connector/proxy/engine.test.js +126 -126
  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 -1018
  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 +457 -457
  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 -83
  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 -104
  137. package/test/setup.js +178 -178
@@ -1,176 +1,176 @@
1
- const jwt = require('../../lib/jwt');
2
-
3
- describe('JWT Utility', () => {
4
- beforeEach(() => {
5
- // Reset environment
6
- process.env.APP_SERVER_SECRET_KEY = 'test-secret-key';
7
- });
8
-
9
- describe('generateJwt', () => {
10
- test('should generate JWT token from payload', () => {
11
- // Arrange
12
- const payload = {
13
- id: 'test-user-id',
14
- platform: 'testCRM'
15
- };
16
-
17
- // Act
18
- const token = jwt.generateJwt(payload);
19
-
20
- // Assert
21
- expect(token).toBeDefined();
22
- expect(typeof token).toBe('string');
23
- expect(token.split('.')).toHaveLength(3); // JWT has 3 parts
24
- });
25
-
26
- test('should generate different tokens for different payloads', () => {
27
- // Arrange
28
- const payload1 = { id: 'user1', platform: 'testCRM' };
29
- const payload2 = { id: 'user2', platform: 'testCRM' };
30
-
31
- // Act
32
- const token1 = jwt.generateJwt(payload1);
33
- const token2 = jwt.generateJwt(payload2);
34
-
35
- // Assert
36
- expect(token1).not.toBe(token2);
37
- });
38
-
39
- test('should generate token with about 2 weeks lifetime', () => {
40
- // Arrange
41
- const payload = { id: 'user-ttl', platform: 'testCRM' };
42
-
43
- // Act
44
- const token = jwt.generateJwt(payload);
45
- const decoded = jwt.decodeJwt(token);
46
- const lifetimeSeconds = decoded.exp - decoded.iat;
47
-
48
- // Assert
49
- // Keep a tiny tolerance to avoid timing flakiness.
50
- expect(lifetimeSeconds).toBeGreaterThanOrEqual((14 * 24 * 60 * 60) - 2);
51
- expect(lifetimeSeconds).toBeLessThanOrEqual((14 * 24 * 60 * 60) + 2);
52
- });
53
- });
54
-
55
- describe('decodeJwt', () => {
56
- test('should decode valid JWT token', () => {
57
- // Arrange
58
- const payload = {
59
- id: 'test-user-id',
60
- platform: 'testCRM'
61
- };
62
- const token = jwt.generateJwt(payload);
63
-
64
- // Act
65
- const decoded = jwt.decodeJwt(token);
66
-
67
- // Assert
68
- expect(decoded).toMatchObject(payload);
69
- expect(decoded).toHaveProperty('exp');
70
- expect(decoded).toHaveProperty('iat');
71
- });
72
-
73
- test('should return null for invalid token', () => {
74
- // Arrange
75
- const invalidToken = 'invalid.jwt.token';
76
-
77
- // Act
78
- const decoded = jwt.decodeJwt(invalidToken);
79
-
80
- // Assert
81
- expect(decoded).toBeNull();
82
- });
83
-
84
- test('should return null for malformed token', () => {
85
- // Arrange
86
- const malformedToken = 'not-a-jwt-token';
87
-
88
- // Act
89
- const decoded = jwt.decodeJwt(malformedToken);
90
-
91
- // Assert
92
- expect(decoded).toBeNull();
93
- });
94
-
95
- test('should return null for token with wrong secret', () => {
96
- // Arrange
97
- const payload = { id: 'test-user-id', platform: 'testCRM' };
98
- const token = jwt.generateJwt(payload);
99
-
100
- // Change secret temporarily
101
- const originalSecret = process.env.APP_SERVER_SECRET_KEY;
102
- process.env.APP_SERVER_SECRET_KEY = 'different-secret';
103
-
104
- // Act
105
- const decoded = jwt.decodeJwt(token);
106
-
107
- // Restore secret
108
- process.env.APP_SERVER_SECRET_KEY = originalSecret;
109
-
110
- // Assert
111
- expect(decoded).toBeNull();
112
- });
113
- });
114
-
115
- describe('generateJwt and decodeJwt round trip', () => {
116
- test('should successfully generate and decode complex payload', () => {
117
- // Arrange
118
- const complexPayload = {
119
- id: 'test-user-id',
120
- platform: 'testCRM',
121
- timestamp: Date.now(),
122
- metadata: {
123
- timezone: 'America/Los_Angeles',
124
- preferences: {
125
- autoLog: true,
126
- callPop: false
127
- }
128
- }
129
- };
130
-
131
- // Act
132
- const token = jwt.generateJwt(complexPayload);
133
- const decoded = jwt.decodeJwt(token);
134
-
135
- // Assert
136
- expect(decoded).toMatchObject(complexPayload);
137
- expect(decoded).toHaveProperty('exp');
138
- expect(decoded).toHaveProperty('iat');
139
- });
140
-
141
- test('should handle empty payload', () => {
142
- // Arrange
143
- const emptyPayload = {};
144
-
145
- // Act
146
- const token = jwt.generateJwt(emptyPayload);
147
- const decoded = jwt.decodeJwt(token);
148
-
149
- // Assert
150
- expect(decoded).toMatchObject(emptyPayload);
151
- expect(decoded).toHaveProperty('exp');
152
- expect(decoded).toHaveProperty('iat');
153
- });
154
- });
155
-
156
- describe('error handling', () => {
157
- test('should handle missing secret key', () => {
158
- // Arrange
159
- const payload = { id: 'test-user-id' };
160
- delete process.env.APP_SERVER_SECRET_KEY;
161
-
162
- // Act & Assert
163
- expect(() => jwt.generateJwt(payload)).toThrow();
164
- });
165
-
166
- test('should handle null payload', () => {
167
- // Act & Assert
168
- expect(() => jwt.generateJwt(null)).toThrow();
169
- });
170
-
171
- test('should handle undefined payload', () => {
172
- // Act & Assert
173
- expect(() => jwt.generateJwt(undefined)).toThrow();
174
- });
175
- });
176
- });
1
+ const jwt = require('../../lib/jwt');
2
+
3
+ describe('JWT Utility', () => {
4
+ beforeEach(() => {
5
+ // Reset environment
6
+ process.env.APP_SERVER_SECRET_KEY = 'test-secret-key';
7
+ });
8
+
9
+ describe('generateJwt', () => {
10
+ test('should generate JWT token from payload', () => {
11
+ // Arrange
12
+ const payload = {
13
+ id: 'test-user-id',
14
+ platform: 'testCRM'
15
+ };
16
+
17
+ // Act
18
+ const token = jwt.generateJwt(payload);
19
+
20
+ // Assert
21
+ expect(token).toBeDefined();
22
+ expect(typeof token).toBe('string');
23
+ expect(token.split('.')).toHaveLength(3); // JWT has 3 parts
24
+ });
25
+
26
+ test('should generate different tokens for different payloads', () => {
27
+ // Arrange
28
+ const payload1 = { id: 'user1', platform: 'testCRM' };
29
+ const payload2 = { id: 'user2', platform: 'testCRM' };
30
+
31
+ // Act
32
+ const token1 = jwt.generateJwt(payload1);
33
+ const token2 = jwt.generateJwt(payload2);
34
+
35
+ // Assert
36
+ expect(token1).not.toBe(token2);
37
+ });
38
+
39
+ test('should generate token with about 2 weeks lifetime', () => {
40
+ // Arrange
41
+ const payload = { id: 'user-ttl', platform: 'testCRM' };
42
+
43
+ // Act
44
+ const token = jwt.generateJwt(payload);
45
+ const decoded = jwt.decodeJwt(token);
46
+ const lifetimeSeconds = decoded.exp - decoded.iat;
47
+
48
+ // Assert
49
+ // Keep a tiny tolerance to avoid timing flakiness.
50
+ expect(lifetimeSeconds).toBeGreaterThanOrEqual((14 * 24 * 60 * 60) - 2);
51
+ expect(lifetimeSeconds).toBeLessThanOrEqual((14 * 24 * 60 * 60) + 2);
52
+ });
53
+ });
54
+
55
+ describe('decodeJwt', () => {
56
+ test('should decode valid JWT token', () => {
57
+ // Arrange
58
+ const payload = {
59
+ id: 'test-user-id',
60
+ platform: 'testCRM'
61
+ };
62
+ const token = jwt.generateJwt(payload);
63
+
64
+ // Act
65
+ const decoded = jwt.decodeJwt(token);
66
+
67
+ // Assert
68
+ expect(decoded).toMatchObject(payload);
69
+ expect(decoded).toHaveProperty('exp');
70
+ expect(decoded).toHaveProperty('iat');
71
+ });
72
+
73
+ test('should return null for invalid token', () => {
74
+ // Arrange
75
+ const invalidToken = 'invalid.jwt.token';
76
+
77
+ // Act
78
+ const decoded = jwt.decodeJwt(invalidToken);
79
+
80
+ // Assert
81
+ expect(decoded).toBeNull();
82
+ });
83
+
84
+ test('should return null for malformed token', () => {
85
+ // Arrange
86
+ const malformedToken = 'not-a-jwt-token';
87
+
88
+ // Act
89
+ const decoded = jwt.decodeJwt(malformedToken);
90
+
91
+ // Assert
92
+ expect(decoded).toBeNull();
93
+ });
94
+
95
+ test('should return null for token with wrong secret', () => {
96
+ // Arrange
97
+ const payload = { id: 'test-user-id', platform: 'testCRM' };
98
+ const token = jwt.generateJwt(payload);
99
+
100
+ // Change secret temporarily
101
+ const originalSecret = process.env.APP_SERVER_SECRET_KEY;
102
+ process.env.APP_SERVER_SECRET_KEY = 'different-secret';
103
+
104
+ // Act
105
+ const decoded = jwt.decodeJwt(token);
106
+
107
+ // Restore secret
108
+ process.env.APP_SERVER_SECRET_KEY = originalSecret;
109
+
110
+ // Assert
111
+ expect(decoded).toBeNull();
112
+ });
113
+ });
114
+
115
+ describe('generateJwt and decodeJwt round trip', () => {
116
+ test('should successfully generate and decode complex payload', () => {
117
+ // Arrange
118
+ const complexPayload = {
119
+ id: 'test-user-id',
120
+ platform: 'testCRM',
121
+ timestamp: Date.now(),
122
+ metadata: {
123
+ timezone: 'America/Los_Angeles',
124
+ preferences: {
125
+ autoLog: true,
126
+ callPop: false
127
+ }
128
+ }
129
+ };
130
+
131
+ // Act
132
+ const token = jwt.generateJwt(complexPayload);
133
+ const decoded = jwt.decodeJwt(token);
134
+
135
+ // Assert
136
+ expect(decoded).toMatchObject(complexPayload);
137
+ expect(decoded).toHaveProperty('exp');
138
+ expect(decoded).toHaveProperty('iat');
139
+ });
140
+
141
+ test('should handle empty payload', () => {
142
+ // Arrange
143
+ const emptyPayload = {};
144
+
145
+ // Act
146
+ const token = jwt.generateJwt(emptyPayload);
147
+ const decoded = jwt.decodeJwt(token);
148
+
149
+ // Assert
150
+ expect(decoded).toMatchObject(emptyPayload);
151
+ expect(decoded).toHaveProperty('exp');
152
+ expect(decoded).toHaveProperty('iat');
153
+ });
154
+ });
155
+
156
+ describe('error handling', () => {
157
+ test('should handle missing secret key', () => {
158
+ // Arrange
159
+ const payload = { id: 'test-user-id' };
160
+ delete process.env.APP_SERVER_SECRET_KEY;
161
+
162
+ // Act & Assert
163
+ expect(() => jwt.generateJwt(payload)).toThrow();
164
+ });
165
+
166
+ test('should handle null payload', () => {
167
+ // Act & Assert
168
+ expect(() => jwt.generateJwt(null)).toThrow();
169
+ });
170
+
171
+ test('should handle undefined payload', () => {
172
+ // Act & Assert
173
+ expect(() => jwt.generateJwt(undefined)).toThrow();
174
+ });
175
+ });
176
+ });