@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
package/handlers/auth.js CHANGED
@@ -1,296 +1,320 @@
1
- const oauth = require('../lib/oauth');
2
- const { UserModel } = require('../models/userModel');
3
- const connectorRegistry = require('../connector/registry');
4
- const Op = require('sequelize').Op;
5
- const { RingCentral } = require('../lib/ringcentral');
6
- const adminCore = require('./admin');
7
- const { Connector } = require('../models/dynamo/connectorSchema');
8
- const { handleDatabaseError } = require('../lib/errorHandler');
9
- const managedAuthCore = require('./managedAuth');
10
- const { getHashValue } = require('../lib/util');
11
-
12
- async function onOAuthCallback({ platform, hostname, tokenUrl, query, hashedRcExtensionId, isFromMCP = false }) {
13
- const callbackUri = query.callbackUri;
14
- const apiUrl = query.apiUrl;
15
- const username = query.username;
16
- const proxyId = query.proxyId;
17
- const userEmail = query.userEmail;
18
- const platformModule = connectorRegistry.getConnector(platform);
19
- let proxyConfig = null;
20
- if (proxyId) {
21
- proxyConfig = await Connector.getProxyConfig(proxyId);
22
- }
23
- const oauthInfo = await platformModule.getOauthInfo({ tokenUrl, hostname, rcAccountId: query.rcAccountId, proxyId, proxyConfig, userEmail, isFromMCP });
24
- if (oauthInfo.failMessage) {
25
- return {
26
- userInfo: null,
27
- returnMessage: {
28
- messageType: 'danger',
29
- message: oauthInfo.failMessage
30
- }
31
- }
32
- }
33
-
34
- // Some platforms require different oauth queries, this won't affect normal OAuth process unless CRM module implements getOverridingOAuthOption() method
35
- let overridingOAuthOption = null;
36
- if (platformModule.getOverridingOAuthOption != null) {
37
- const code = new URL(callbackUri).searchParams.get('code');
38
- overridingOAuthOption = platformModule.getOverridingOAuthOption({ code });
39
- }
40
- const oauthApp = oauth.getOAuthApp(oauthInfo);
41
- const { accessToken, refreshToken, expires, data } = await oauthApp.code.getToken(callbackUri, overridingOAuthOption);
42
- const authHeader = `Bearer ${accessToken}`;
43
- const { successful, platformUserInfo, returnMessage } = await platformModule.getUserInfo({ authHeader, tokenUrl, apiUrl, hostname, platform, username, callbackUri, query, proxyId, proxyConfig, userEmail, data });
44
-
45
- if (successful) {
46
- let userInfo = null;
47
- try {
48
- userInfo = await saveUserInfo({
49
- platformUserInfo,
50
- platform,
51
- tokenUrl,
52
- apiUrl,
53
- username,
54
- hostname: platformUserInfo?.overridingHostname ? platformUserInfo.overridingHostname : hostname,
55
- accessToken,
56
- refreshToken,
57
- tokenExpiry: isNaN(expires) ? null : expires,
58
- rcAccountId: query?.rcAccountId,
59
- hashedRcExtensionId,
60
- proxyId
61
- });
62
- }
63
- catch (error) {
64
- return handleDatabaseError(error, 'Error saving user info');
65
- }
66
- if (platformModule.postSaveUserInfo) {
67
- userInfo = await platformModule.postSaveUserInfo({ userInfo, oauthApp });
68
- }
69
- return {
70
- userInfo,
71
- returnMessage
72
- };
73
- }
74
- else {
75
- return {
76
- userInfo: null,
77
- returnMessage
78
- }
79
- }
80
- }
81
-
82
- async function onApiKeyLogin({ platform, hostname, apiKey, proxyId, rcAccountId, rcExtensionId, connectorId, isPrivate, hashedRcExtensionId, additionalInfo }) {
83
- const platformModule = connectorRegistry.getConnector(platform);
84
- let resolvedAdditionalInfo = {
85
- ...(additionalInfo ?? {})
86
- };
87
- if (resolvedAdditionalInfo.apiKey === undefined && apiKey !== undefined) {
88
- resolvedAdditionalInfo.apiKey = apiKey;
89
- }
90
- let resolvedApiKey = apiKey;
91
- let managedFieldDefinitions = [];
92
- if (rcAccountId) {
93
- managedFieldDefinitions = await managedAuthCore.getManagedFieldDefinitions({ rcAccountId, platform, connectorId, isPrivate });
94
- const shouldFallbackToManualAuth = managedFieldDefinitions.length > 0
95
- && await managedAuthCore.hasManagedAuthLoginFailure({ rcAccountId, platform, rcExtensionId });
96
- const managedAuthResult = await managedAuthCore.resolveApiKeyLoginFields({
97
- platform,
98
- rcAccountId,
99
- rcExtensionId,
100
- connectorId,
101
- isPrivate,
102
- apiKey,
103
- additionalInfo: resolvedAdditionalInfo,
104
- preferSubmittedValuesForManagedFields: shouldFallbackToManualAuth
105
- });
106
- resolvedAdditionalInfo = managedAuthResult.resolvedAdditionalInfo;
107
- resolvedApiKey = managedAuthResult.resolvedApiKey;
108
- const missingRequiredFieldConsts = managedAuthResult.missingRequiredFieldConsts;
109
- if (missingRequiredFieldConsts.length > 0) {
110
- return {
111
- userInfo: null,
112
- returnMessage: {
113
- messageType: 'warning',
114
- message: 'Missing required authentication fields.',
115
- ttl: 3000,
116
- missingRequiredFieldConsts
117
- }
118
- };
119
- }
120
- }
121
- const basicAuth = platformModule.getBasicAuth({ apiKey: resolvedApiKey });
122
- const { successful, platformUserInfo, returnMessage } = await platformModule.getUserInfo({
123
- authHeader: `Basic ${basicAuth}`,
124
- hostname,
125
- platform,
126
- additionalInfo: resolvedAdditionalInfo,
127
- apiKey: resolvedApiKey,
128
- proxyId
129
- });
130
- if (successful) {
131
- await managedAuthCore.clearManagedAuthLoginFailure({ rcAccountId, platform, rcExtensionId });
132
- let userInfo = null;
133
- try {
134
- userInfo = await saveUserInfo({
135
- platformUserInfo,
136
- platform,
137
- hostname,
138
- proxyId,
139
- hashedRcExtensionId,
140
- rcAccountId,
141
- accessToken: platformUserInfo.overridingApiKey ?? resolvedApiKey
142
- });
143
- }
144
- catch (error) {
145
- return handleDatabaseError(error, 'Error saving user info');
146
- }
147
- if (platformModule.postSaveUserInfo) {
148
- userInfo = await platformModule.postSaveUserInfo({ userInfo });
149
- }
150
- return {
151
- userInfo,
152
- returnMessage
153
- };
154
- }
155
- if (managedFieldDefinitions.length > 0) {
156
- await managedAuthCore.markManagedAuthLoginFailure({ rcAccountId, platform, rcExtensionId });
157
- }
158
- return {
159
- userInfo: null,
160
- returnMessage
161
- }
162
- }
163
-
164
- async function saveUserInfo({ platformUserInfo, platform, hostname, accessToken, refreshToken, tokenExpiry, rcAccountId, hashedRcExtensionId, proxyId }) {
165
- const id = platformUserInfo.id;
166
- const name = platformUserInfo.name;
167
- const existingUser = await UserModel.findByPk(id);
168
- const timezoneName = platformUserInfo.timezoneName;
169
- const timezoneOffset = platformUserInfo.timezoneOffset;
170
- const platformAdditionalInfo = platformUserInfo.platformAdditionalInfo || {};
171
- platformAdditionalInfo.proxyId = proxyId;
172
- if (existingUser) {
173
- try {
174
- await existingUser.update(
175
- {
176
- platform,
177
- hostname,
178
- timezoneName,
179
- timezoneOffset,
180
- accessToken,
181
- refreshToken,
182
- tokenExpiry,
183
- rcAccountId,
184
- hashedRcExtensionId,
185
- platformAdditionalInfo: {
186
- ...existingUser.platformAdditionalInfo, // keep existing platformAdditionalInfo
187
- ...platformAdditionalInfo,
188
- }
189
- }
190
- );
191
- }
192
- catch (error) {
193
- return handleDatabaseError(error, 'Error saving user info');
194
- }
195
- }
196
- else {
197
- try {
198
- await UserModel.create({
199
- id,
200
- hostname,
201
- timezoneName,
202
- timezoneOffset,
203
- platform,
204
- accessToken,
205
- refreshToken,
206
- tokenExpiry,
207
- rcAccountId,
208
- hashedRcExtensionId,
209
- platformAdditionalInfo,
210
- userSettings: {}
211
- });
212
- }
213
- catch (error) {
214
- return handleDatabaseError(error, 'Error saving user info');
215
- }
216
- }
217
- return {
218
- id,
219
- name
220
- };
221
- }
222
-
223
- async function getLicenseStatus({ userId, platform }) {
224
- const user = await UserModel.findByPk(userId);
225
- if (!user) {
226
- return {
227
- isLicenseValid: false,
228
- licenseStatus: 'Invalid (User not found)',
229
- licenseStatusDescription: ''
230
- }
231
- }
232
- const platformModule = connectorRegistry.getConnector(platform);
233
- const licenseStatus = await platformModule.getLicenseStatus({ userId, platform, user });
234
- return licenseStatus;
235
- }
236
-
237
- // Just for oauth ATM
238
- async function authValidation({ platform, userId }) {
239
- let existingUser = await UserModel.findOne({
240
- where: {
241
- [Op.and]: [
242
- {
243
- id: userId,
244
- platform
245
- }
246
- ]
247
- }
248
- });
249
- if (existingUser) {
250
- const platformModule = connectorRegistry.getConnector(platform);
251
- const proxyId = existingUser?.platformAdditionalInfo?.proxyId;
252
- const oauthApp = oauth.getOAuthApp((await platformModule.getOauthInfo({ tokenUrl: existingUser?.platformAdditionalInfo?.tokenUrl, hostname: existingUser?.hostname, proxyId })));
253
- existingUser = await oauth.checkAndRefreshAccessToken(oauthApp, existingUser);
254
- const { successful, returnMessage, status } = await platformModule.authValidation({ user: existingUser });
255
- return {
256
- successful,
257
- returnMessage,
258
- status,
259
- failReason: successful ? '' : 'CRM. API failed'
260
- }
261
- }
262
- else {
263
- return {
264
- successful: false,
265
- status: 404,
266
- failReason: 'App Connect. User not found in database'
267
- }
268
- }
269
- }
270
-
271
- // Ringcentral
272
- async function onRingcentralOAuthCallback({ code, rcAccountId }) {
273
- if (!process.env.RINGCENTRAL_SERVER || !process.env.RINGCENTRAL_CLIENT_ID || !process.env.RINGCENTRAL_CLIENT_SECRET) {
274
- return;
275
- }
276
- const rcSDK = new RingCentral({
277
- server: process.env.RINGCENTRAL_SERVER,
278
- clientId: process.env.RINGCENTRAL_CLIENT_ID,
279
- clientSecret: process.env.RINGCENTRAL_CLIENT_SECRET,
280
- redirectUri: `${process.env.APP_SERVER}/ringcentral/oauth/callback`
281
- });
282
- const { access_token, refresh_token, expire_time } = await rcSDK.generateToken({ code });
283
- const hashedRcAccountId = getHashValue(rcAccountId, process.env.HASH_KEY);
284
- await adminCore.updateAdminRcTokens({
285
- hashedRcAccountId,
286
- adminAccessToken: access_token,
287
- adminRefreshToken: refresh_token,
288
- adminTokenExpiry: expire_time
289
- });
290
- }
291
-
292
- exports.onOAuthCallback = onOAuthCallback;
293
- exports.onApiKeyLogin = onApiKeyLogin;
294
- exports.authValidation = authValidation;
295
- exports.getLicenseStatus = getLicenseStatus;
296
- exports.onRingcentralOAuthCallback = onRingcentralOAuthCallback;
1
+ const oauth = require('../lib/oauth');
2
+ const { UserModel } = require('../models/userModel');
3
+ const connectorRegistry = require('../connector/registry');
4
+ const Op = require('sequelize').Op;
5
+ const { RingCentral } = require('../lib/ringcentral');
6
+ const adminCore = require('./admin');
7
+ const { Connector } = require('../models/dynamo/connectorSchema');
8
+ const { handleDatabaseError } = require('../lib/errorHandler');
9
+ const managedAuthCore = require('./managedAuth');
10
+ const managedOAuthCore = require('./managedOAuth');
11
+ const { getHashValue } = require('../lib/util');
12
+
13
+ async function onOAuthCallback({ platform, hostname, tokenUrl, query, hashedRcExtensionId, isFromMCP = false }) {
14
+ const callbackUri = query.callbackUri;
15
+ const apiUrl = query.apiUrl;
16
+ const username = query.username;
17
+ const proxyId = query.proxyId;
18
+ const userEmail = query.userEmail;
19
+ const platformModule = connectorRegistry.getConnector(platform);
20
+ let proxyConfig = null;
21
+ if (proxyId) {
22
+ proxyConfig = await Connector.getProxyConfig(proxyId);
23
+ }
24
+ let managedOAuthSource = null;
25
+ let oauthInfo = null;
26
+ if (query.rcAccountId) {
27
+ const managedOAuthResult = await managedOAuthCore.resolveManagedOAuthInfo({
28
+ rcAccountId: query.rcAccountId,
29
+ platform
30
+ });
31
+ managedOAuthSource = managedOAuthResult.source;
32
+ oauthInfo = managedOAuthResult.oauthInfo;
33
+ }
34
+ if (!oauthInfo) {
35
+ oauthInfo = await platformModule.getOauthInfo({ tokenUrl, hostname, rcAccountId: query.rcAccountId, proxyId, proxyConfig, userEmail, isFromMCP });
36
+ }
37
+ if (oauthInfo.failMessage) {
38
+ return {
39
+ userInfo: null,
40
+ returnMessage: {
41
+ messageType: 'danger',
42
+ message: oauthInfo.failMessage
43
+ }
44
+ }
45
+ }
46
+
47
+ // Some platforms require different oauth queries, this won't affect normal OAuth process unless CRM module implements getOverridingOAuthOption() method
48
+ let overridingOAuthOption = null;
49
+ if (platformModule.getOverridingOAuthOption != null) {
50
+ const code = new URL(callbackUri).searchParams.get('code');
51
+ overridingOAuthOption = platformModule.getOverridingOAuthOption({ code });
52
+ }
53
+ const oauthApp = oauth.getOAuthApp(oauthInfo);
54
+ const { accessToken, refreshToken, expires, data } = await oauthApp.code.getToken(callbackUri, overridingOAuthOption);
55
+ const authHeader = `Bearer ${accessToken}`;
56
+ const { successful, platformUserInfo, returnMessage } = await platformModule.getUserInfo({ authHeader, tokenUrl, apiUrl, hostname, platform, username, callbackUri, query, proxyId, proxyConfig, userEmail, data });
57
+
58
+ if (successful) {
59
+ let userInfo = null;
60
+ try {
61
+ userInfo = await saveUserInfo({
62
+ platformUserInfo,
63
+ platform,
64
+ tokenUrl,
65
+ apiUrl,
66
+ username,
67
+ hostname: platformUserInfo?.overridingHostname ? platformUserInfo.overridingHostname : hostname,
68
+ accessToken,
69
+ refreshToken,
70
+ tokenExpiry: isNaN(expires) ? null : expires,
71
+ rcAccountId: query?.rcAccountId,
72
+ hashedRcExtensionId,
73
+ proxyId
74
+ });
75
+ }
76
+ catch (error) {
77
+ return handleDatabaseError(error, 'Error saving user info');
78
+ }
79
+ if (platformModule.postSaveUserInfo) {
80
+ userInfo = await platformModule.postSaveUserInfo({ userInfo, oauthApp });
81
+ }
82
+ if (managedOAuthSource === 'pending') {
83
+ await managedOAuthCore.migratePendingManagedOAuth({
84
+ rcAccountId: query.rcAccountId,
85
+ platform
86
+ });
87
+ }
88
+ return {
89
+ userInfo,
90
+ returnMessage
91
+ };
92
+ }
93
+ else {
94
+ return {
95
+ userInfo: null,
96
+ returnMessage
97
+ }
98
+ }
99
+ }
100
+
101
+ async function onApiKeyLogin({ platform, hostname, apiKey, proxyId, rcAccountId, rcExtensionId, connectorId, isPrivate, hashedRcExtensionId, additionalInfo }) {
102
+ const platformModule = connectorRegistry.getConnector(platform);
103
+ let resolvedAdditionalInfo = {
104
+ ...(additionalInfo ?? {})
105
+ };
106
+ if (resolvedAdditionalInfo.apiKey === undefined && apiKey !== undefined) {
107
+ resolvedAdditionalInfo.apiKey = apiKey;
108
+ }
109
+ let resolvedApiKey = apiKey;
110
+ let managedFieldDefinitions = [];
111
+ if (rcAccountId) {
112
+ managedFieldDefinitions = await managedAuthCore.getManagedFieldDefinitions({ rcAccountId, platform, connectorId, isPrivate });
113
+ const shouldFallbackToManualAuth = managedFieldDefinitions.length > 0
114
+ && await managedAuthCore.hasManagedAuthLoginFailure({ rcAccountId, platform, rcExtensionId });
115
+ const managedAuthResult = await managedAuthCore.resolveApiKeyLoginFields({
116
+ platform,
117
+ rcAccountId,
118
+ rcExtensionId,
119
+ connectorId,
120
+ isPrivate,
121
+ apiKey,
122
+ additionalInfo: resolvedAdditionalInfo,
123
+ preferSubmittedValuesForManagedFields: shouldFallbackToManualAuth
124
+ });
125
+ resolvedAdditionalInfo = managedAuthResult.resolvedAdditionalInfo;
126
+ resolvedApiKey = managedAuthResult.resolvedApiKey;
127
+ const missingRequiredFieldConsts = managedAuthResult.missingRequiredFieldConsts;
128
+ if (missingRequiredFieldConsts.length > 0) {
129
+ return {
130
+ userInfo: null,
131
+ returnMessage: {
132
+ messageType: 'warning',
133
+ message: 'Missing required authentication fields.',
134
+ ttl: 3000,
135
+ missingRequiredFieldConsts
136
+ }
137
+ };
138
+ }
139
+ }
140
+ const basicAuth = platformModule.getBasicAuth({ apiKey: resolvedApiKey });
141
+ const { successful, platformUserInfo, returnMessage } = await platformModule.getUserInfo({
142
+ authHeader: `Basic ${basicAuth}`,
143
+ hostname,
144
+ platform,
145
+ additionalInfo: resolvedAdditionalInfo,
146
+ apiKey: resolvedApiKey,
147
+ proxyId
148
+ });
149
+ if (successful) {
150
+ await managedAuthCore.clearManagedAuthLoginFailure({ rcAccountId, platform, rcExtensionId });
151
+ let userInfo = null;
152
+ try {
153
+ userInfo = await saveUserInfo({
154
+ platformUserInfo,
155
+ platform,
156
+ hostname,
157
+ proxyId,
158
+ hashedRcExtensionId,
159
+ rcAccountId,
160
+ accessToken: platformUserInfo.overridingApiKey ?? resolvedApiKey
161
+ });
162
+ }
163
+ catch (error) {
164
+ return handleDatabaseError(error, 'Error saving user info');
165
+ }
166
+ if (platformModule.postSaveUserInfo) {
167
+ userInfo = await platformModule.postSaveUserInfo({ userInfo });
168
+ }
169
+ return {
170
+ userInfo,
171
+ returnMessage
172
+ };
173
+ }
174
+ if (managedFieldDefinitions.length > 0) {
175
+ await managedAuthCore.markManagedAuthLoginFailure({ rcAccountId, platform, rcExtensionId });
176
+ }
177
+ return {
178
+ userInfo: null,
179
+ returnMessage
180
+ }
181
+ }
182
+
183
+ async function saveUserInfo({ platformUserInfo, platform, hostname, accessToken, refreshToken, tokenExpiry, rcAccountId, hashedRcExtensionId, proxyId }) {
184
+ const id = platformUserInfo.id;
185
+ const name = platformUserInfo.name;
186
+ const existingUser = await UserModel.findByPk(id);
187
+ const timezoneName = platformUserInfo.timezoneName;
188
+ const timezoneOffset = platformUserInfo.timezoneOffset;
189
+ const platformAdditionalInfo = platformUserInfo.platformAdditionalInfo || {};
190
+ platformAdditionalInfo.proxyId = proxyId;
191
+ if (existingUser) {
192
+ try {
193
+ await existingUser.update(
194
+ {
195
+ platform,
196
+ hostname,
197
+ timezoneName,
198
+ timezoneOffset,
199
+ accessToken,
200
+ refreshToken,
201
+ tokenExpiry,
202
+ rcAccountId,
203
+ hashedRcExtensionId,
204
+ platformAdditionalInfo: {
205
+ ...existingUser.platformAdditionalInfo, // keep existing platformAdditionalInfo
206
+ ...platformAdditionalInfo,
207
+ }
208
+ }
209
+ );
210
+ }
211
+ catch (error) {
212
+ return handleDatabaseError(error, 'Error saving user info');
213
+ }
214
+ }
215
+ else {
216
+ try {
217
+ await UserModel.create({
218
+ id,
219
+ hostname,
220
+ timezoneName,
221
+ timezoneOffset,
222
+ platform,
223
+ accessToken,
224
+ refreshToken,
225
+ tokenExpiry,
226
+ rcAccountId,
227
+ hashedRcExtensionId,
228
+ platformAdditionalInfo,
229
+ userSettings: {}
230
+ });
231
+ }
232
+ catch (error) {
233
+ return handleDatabaseError(error, 'Error saving user info');
234
+ }
235
+ }
236
+ return {
237
+ id,
238
+ name
239
+ };
240
+ }
241
+
242
+ async function getLicenseStatus({ userId, platform }) {
243
+ const user = await UserModel.findByPk(userId);
244
+ if (!user) {
245
+ return {
246
+ isLicenseValid: false,
247
+ licenseStatus: 'Invalid (User not found)',
248
+ licenseStatusDescription: ''
249
+ }
250
+ }
251
+ const platformModule = connectorRegistry.getConnector(platform);
252
+ const licenseStatus = await platformModule.getLicenseStatus({ userId, platform, user });
253
+ return licenseStatus;
254
+ }
255
+
256
+ // Just for oauth ATM
257
+ async function authValidation({ platform, userId }) {
258
+ let existingUser = await UserModel.findOne({
259
+ where: {
260
+ [Op.and]: [
261
+ {
262
+ id: userId,
263
+ platform
264
+ }
265
+ ]
266
+ }
267
+ });
268
+ if (existingUser) {
269
+ const platformModule = connectorRegistry.getConnector(platform);
270
+ const proxyId = existingUser?.platformAdditionalInfo?.proxyId;
271
+ const managedOAuthResult = await managedOAuthCore.resolveManagedOAuthInfo({
272
+ rcAccountId: existingUser.rcAccountId,
273
+ platform
274
+ });
275
+ const oauthInfo = managedOAuthResult.oauthInfo ?? await platformModule.getOauthInfo({ tokenUrl: existingUser?.platformAdditionalInfo?.tokenUrl, hostname: existingUser?.hostname, proxyId });
276
+ const oauthApp = oauth.getOAuthApp(oauthInfo);
277
+ existingUser = await oauth.checkAndRefreshAccessToken(oauthApp, existingUser);
278
+ const { successful, returnMessage, status } = await platformModule.authValidation({ user: existingUser });
279
+ return {
280
+ successful,
281
+ returnMessage,
282
+ status,
283
+ failReason: successful ? '' : 'CRM. API failed'
284
+ }
285
+ }
286
+ else {
287
+ return {
288
+ successful: false,
289
+ status: 404,
290
+ failReason: 'App Connect. User not found in database'
291
+ }
292
+ }
293
+ }
294
+
295
+ // Ringcentral
296
+ async function onRingcentralOAuthCallback({ code, rcAccountId }) {
297
+ if (!process.env.RINGCENTRAL_SERVER || !process.env.RINGCENTRAL_CLIENT_ID || !process.env.RINGCENTRAL_CLIENT_SECRET) {
298
+ return;
299
+ }
300
+ const rcSDK = new RingCentral({
301
+ server: process.env.RINGCENTRAL_SERVER,
302
+ clientId: process.env.RINGCENTRAL_CLIENT_ID,
303
+ clientSecret: process.env.RINGCENTRAL_CLIENT_SECRET,
304
+ redirectUri: `${process.env.APP_SERVER}/ringcentral/oauth/callback`
305
+ });
306
+ const { access_token, refresh_token, expire_time } = await rcSDK.generateToken({ code });
307
+ const hashedRcAccountId = getHashValue(rcAccountId, process.env.HASH_KEY);
308
+ await adminCore.updateAdminRcTokens({
309
+ hashedRcAccountId,
310
+ adminAccessToken: access_token,
311
+ adminRefreshToken: refresh_token,
312
+ adminTokenExpiry: expire_time
313
+ });
314
+ }
315
+
316
+ exports.onOAuthCallback = onOAuthCallback;
317
+ exports.onApiKeyLogin = onApiKeyLogin;
318
+ exports.authValidation = authValidation;
319
+ exports.getLicenseStatus = getLicenseStatus;
320
+ exports.onRingcentralOAuthCallback = onRingcentralOAuthCallback;