@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,467 +1,467 @@
1
- jest.mock('node-fetch');
2
-
3
- const fetch = require('node-fetch');
4
- const { RingCentral, isRefreshTokenValid, isAccessTokenValid } = require('../../lib/ringcentral');
5
-
6
- describe('ringcentral', () => {
7
- beforeEach(() => {
8
- jest.clearAllMocks();
9
- });
10
-
11
- describe('isRefreshTokenValid', () => {
12
- test('should return true if refresh token is not expired', () => {
13
- const token = {
14
- refresh_token_expire_time: Date.now() + 60000 // 1 minute in future
15
- };
16
-
17
- expect(isRefreshTokenValid(token)).toBe(true);
18
- });
19
-
20
- test('should return false if refresh token is expired', () => {
21
- const token = {
22
- refresh_token_expire_time: Date.now() - 1000 // 1 second ago
23
- };
24
-
25
- expect(isRefreshTokenValid(token)).toBe(false);
26
- });
27
-
28
- test('should respect custom handicap', () => {
29
- const token = {
30
- refresh_token_expire_time: Date.now() + 5000 // 5 seconds in future
31
- };
32
-
33
- // With 10s handicap, should be invalid
34
- expect(isRefreshTokenValid(token, 10000)).toBe(false);
35
-
36
- // With 1s handicap, should be valid
37
- expect(isRefreshTokenValid(token, 1000)).toBe(true);
38
- });
39
- });
40
-
41
- describe('isAccessTokenValid', () => {
42
- test('should return true if access token is not expired', () => {
43
- const token = {
44
- expire_time: Date.now() + 120000 // 2 minutes in future
45
- };
46
-
47
- expect(isAccessTokenValid(token)).toBe(true);
48
- });
49
-
50
- test('should return false if access token is expired', () => {
51
- const token = {
52
- expire_time: Date.now() - 1000
53
- };
54
-
55
- expect(isAccessTokenValid(token)).toBe(false);
56
- });
57
-
58
- test('should respect default 1 minute handicap', () => {
59
- const token = {
60
- expire_time: Date.now() + 30000 // 30 seconds in future
61
- };
62
-
63
- // With default 1 minute handicap, should be invalid
64
- expect(isAccessTokenValid(token)).toBe(false);
65
- });
66
- });
67
-
68
- describe('RingCentral class', () => {
69
- let rc;
70
- const options = {
71
- server: 'https://platform.ringcentral.com',
72
- clientId: 'test-client-id',
73
- clientSecret: 'test-client-secret',
74
- redirectUri: 'https://app.example.com/callback'
75
- };
76
-
77
- beforeEach(() => {
78
- rc = new RingCentral(options);
79
- });
80
-
81
- describe('loginUrl', () => {
82
- test('should generate login URL with required parameters', () => {
83
- const url = rc.loginUrl({});
84
-
85
- expect(url).toContain('https://platform.ringcentral.com/restapi/oauth/authorize');
86
- expect(url).toContain('response_type=code');
87
- expect(url).toContain(`client_id=${options.clientId}`);
88
- expect(url).toContain(`redirect_uri=${encodeURIComponent(options.redirectUri)}`);
89
- });
90
-
91
- test('should include state parameter when provided', () => {
92
- const url = rc.loginUrl({ state: 'custom-state-123' });
93
-
94
- expect(url).toContain('state=custom-state-123');
95
- });
96
- });
97
-
98
- describe('generateToken', () => {
99
- test('should generate token successfully', async () => {
100
- const mockResponse = {
101
- status: 200,
102
- json: jest.fn().mockResolvedValue({
103
- access_token: 'new-access-token',
104
- refresh_token: 'new-refresh-token',
105
- token_type: 'bearer',
106
- expires_in: 3600,
107
- refresh_token_expires_in: 604800,
108
- scope: 'ReadAccounts',
109
- endpoint_id: 'endpoint-123'
110
- })
111
- };
112
- fetch.mockResolvedValue(mockResponse);
113
-
114
- const result = await rc.generateToken({ code: 'auth-code-123' });
115
-
116
- expect(fetch).toHaveBeenCalledWith(
117
- 'https://platform.ringcentral.com/restapi/oauth/token',
118
- expect.objectContaining({
119
- method: 'POST',
120
- headers: expect.objectContaining({
121
- 'Content-Type': 'application/x-www-form-urlencoded'
122
- })
123
- })
124
- );
125
- expect(result.access_token).toBe('new-access-token');
126
- expect(result.refresh_token).toBe('new-refresh-token');
127
- expect(result.expire_time).toBeDefined();
128
- expect(result.refresh_token_expire_time).toBeDefined();
129
- });
130
-
131
- test('should throw error on failed token generation', async () => {
132
- const mockResponse = { status: 401 };
133
- fetch.mockResolvedValue(mockResponse);
134
-
135
- await expect(rc.generateToken({ code: 'invalid-code' }))
136
- .rejects.toThrow('Generate Token error');
137
- });
138
- });
139
-
140
- describe('refreshToken', () => {
141
- test('should refresh token successfully', async () => {
142
- const existingToken = {
143
- refresh_token: 'old-refresh-token',
144
- expires_in: 3600,
145
- refresh_token_expires_in: 604800
146
- };
147
-
148
- const mockResponse = {
149
- status: 200,
150
- json: jest.fn().mockResolvedValue({
151
- access_token: 'refreshed-access-token',
152
- refresh_token: 'new-refresh-token',
153
- token_type: 'bearer',
154
- expires_in: 3600,
155
- refresh_token_expires_in: 604800,
156
- scope: 'ReadAccounts',
157
- endpoint_id: 'endpoint-456'
158
- })
159
- };
160
- fetch.mockResolvedValue(mockResponse);
161
-
162
- const result = await rc.refreshToken(existingToken);
163
-
164
- expect(result.access_token).toBe('refreshed-access-token');
165
- expect(result.refresh_token).toBe('new-refresh-token');
166
- expect(result.expire_time).toBeDefined();
167
- });
168
-
169
- test('should throw error on failed refresh', async () => {
170
- const mockResponse = { status: 401 };
171
- fetch.mockResolvedValue(mockResponse);
172
-
173
- await expect(rc.refreshToken({ refresh_token: 'expired' }))
174
- .rejects.toThrow('Refresh Token error');
175
- });
176
- });
177
-
178
- describe('revokeToken', () => {
179
- test('should revoke token successfully', async () => {
180
- const mockResponse = { status: 200 };
181
- fetch.mockResolvedValue(mockResponse);
182
-
183
- await expect(rc.revokeToken({ access_token: 'token-to-revoke' }))
184
- .resolves.not.toThrow();
185
-
186
- expect(fetch).toHaveBeenCalledWith(
187
- 'https://platform.ringcentral.com/restapi/oauth/revoke',
188
- expect.objectContaining({ method: 'POST' })
189
- );
190
- });
191
-
192
- test('should throw error on failed revocation', async () => {
193
- const mockResponse = { status: 500 };
194
- fetch.mockResolvedValue(mockResponse);
195
-
196
- await expect(rc.revokeToken({ access_token: 'token' }))
197
- .rejects.toThrow('Revoke Token error');
198
- });
199
- });
200
-
201
- describe('request', () => {
202
- const token = {
203
- token_type: 'bearer',
204
- access_token: 'test-access-token'
205
- };
206
-
207
- test('should make authenticated request', async () => {
208
- const mockResponse = {
209
- status: 200,
210
- json: jest.fn().mockResolvedValue({ data: 'test' })
211
- };
212
- fetch.mockResolvedValue(mockResponse);
213
-
214
- const response = await rc.request({
215
- path: '/restapi/v1.0/account/~',
216
- method: 'GET'
217
- }, token);
218
-
219
- expect(fetch).toHaveBeenCalledWith(
220
- 'https://platform.ringcentral.com/restapi/v1.0/account/~',
221
- expect.objectContaining({
222
- method: 'GET',
223
- headers: expect.objectContaining({
224
- 'Authorization': 'bearer test-access-token'
225
- })
226
- })
227
- );
228
- expect(response).toBe(mockResponse);
229
- });
230
-
231
- test('should include query parameters', async () => {
232
- const mockResponse = { status: 200 };
233
- fetch.mockResolvedValue(mockResponse);
234
-
235
- await rc.request({
236
- path: '/restapi/v1.0/extension/~/call-log',
237
- method: 'GET',
238
- query: { dateFrom: '2024-01-01', dateTo: '2024-01-31' }
239
- }, token);
240
-
241
- expect(fetch).toHaveBeenCalledWith(
242
- expect.stringContaining('dateFrom=2024-01-01'),
243
- expect.any(Object)
244
- );
245
- });
246
-
247
- test('should include JSON body', async () => {
248
- const mockResponse = { status: 200 };
249
- fetch.mockResolvedValue(mockResponse);
250
-
251
- await rc.request({
252
- path: '/restapi/v1.0/subscription',
253
- method: 'POST',
254
- body: { eventFilters: ['/restapi/v1.0/account/~/extension/~/presence'] }
255
- }, token);
256
-
257
- expect(fetch).toHaveBeenCalledWith(
258
- expect.any(String),
259
- expect.objectContaining({
260
- method: 'POST',
261
- body: expect.stringContaining('eventFilters')
262
- })
263
- );
264
- });
265
-
266
- test('should throw error on failed request', async () => {
267
- const mockResponse = {
268
- status: 401,
269
- text: jest.fn().mockResolvedValue('Unauthorized')
270
- };
271
- fetch.mockResolvedValue(mockResponse);
272
-
273
- await expect(rc.request({ path: '/test', method: 'GET' }, token))
274
- .rejects.toThrow('Unauthorized');
275
- });
276
-
277
- test('should use custom server if provided', async () => {
278
- const mockResponse = { status: 200 };
279
- fetch.mockResolvedValue(mockResponse);
280
-
281
- await rc.request({
282
- server: 'https://custom-server.com',
283
- path: '/api/test',
284
- method: 'GET'
285
- }, token);
286
-
287
- expect(fetch).toHaveBeenCalledWith(
288
- 'https://custom-server.com/api/test',
289
- expect.any(Object)
290
- );
291
- });
292
- });
293
-
294
- describe('createSubscription', () => {
295
- const token = { token_type: 'bearer', access_token: 'token' };
296
-
297
- test('should create webhook subscription', async () => {
298
- const mockResponse = {
299
- status: 200,
300
- json: jest.fn().mockResolvedValue({
301
- id: 'sub-123',
302
- expirationTime: '2024-01-20T00:00:00Z',
303
- uri: 'https://platform.ringcentral.com/subscription/sub-123',
304
- creationTime: '2024-01-13T00:00:00Z',
305
- deliveryMode: { transportType: 'WebHook' },
306
- status: 'Active'
307
- })
308
- };
309
- fetch.mockResolvedValue(mockResponse);
310
-
311
- const result = await rc.createSubscription({
312
- eventFilters: ['/restapi/v1.0/account/~/extension/~/presence'],
313
- webhookUri: 'https://app.example.com/webhook'
314
- }, token);
315
-
316
- expect(result.id).toBe('sub-123');
317
- });
318
- });
319
-
320
- describe('getExtensionInfo', () => {
321
- const token = { token_type: 'bearer', access_token: 'token' };
322
-
323
- test('should get extension info', async () => {
324
- const extensionInfo = {
325
- id: 12345,
326
- name: 'John Doe',
327
- extensionNumber: '101'
328
- };
329
- const mockResponse = {
330
- status: 200,
331
- json: jest.fn().mockResolvedValue(extensionInfo)
332
- };
333
- fetch.mockResolvedValue(mockResponse);
334
-
335
- const result = await rc.getExtensionInfo('~', token);
336
-
337
- expect(result).toEqual(extensionInfo);
338
- });
339
- });
340
-
341
- describe('getAccountInfo', () => {
342
- const token = { token_type: 'bearer', access_token: 'token' };
343
-
344
- test('should get account info', async () => {
345
- const accountInfo = {
346
- id: 'account-123',
347
- mainNumber: '+1234567890'
348
- };
349
- const mockResponse = {
350
- status: 200,
351
- json: jest.fn().mockResolvedValue(accountInfo)
352
- };
353
- fetch.mockResolvedValue(mockResponse);
354
-
355
- const result = await rc.getAccountInfo(token);
356
-
357
- expect(result).toEqual(accountInfo);
358
- });
359
- });
360
-
361
- describe('getCallsAggregationData', () => {
362
- const token = { token_type: 'bearer', access_token: 'token' };
363
-
364
- test('should get calls aggregation data', async () => {
365
- const aggregationData = {
366
- records: [{ callsCount: 100, duration: 36000 }]
367
- };
368
- const mockResponse = {
369
- status: 200,
370
- json: jest.fn().mockResolvedValue(aggregationData)
371
- };
372
- fetch.mockResolvedValue(mockResponse);
373
-
374
- const result = await rc.getCallsAggregationData({
375
- token,
376
- timezone: 'America/New_York',
377
- timeFrom: '2024-01-01',
378
- timeTo: '2024-01-31',
379
- groupBy: 'Users'
380
- });
381
-
382
- expect(result).toEqual(aggregationData);
383
- expect(fetch).toHaveBeenCalledWith(
384
- expect.stringContaining('/analytics/calls/v1/accounts/~/aggregation/fetch'),
385
- expect.objectContaining({ method: 'POST' })
386
- );
387
- });
388
- });
389
-
390
- describe('getCallLogData', () => {
391
- const token = { token_type: 'bearer', access_token: 'token' };
392
-
393
- test('should get call log data with pagination', async () => {
394
- const page1 = {
395
- records: [{ id: 'call-1' }, { id: 'call-2' }],
396
- navigation: { nextPage: { uri: 'next-page' } }
397
- };
398
- const page2 = {
399
- records: [{ id: 'call-3' }],
400
- navigation: {}
401
- };
402
-
403
- fetch
404
- .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page1) })
405
- .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page2) });
406
-
407
- const result = await rc.getCallLogData({
408
- token,
409
- timezone: 'UTC',
410
- timeFrom: '2024-01-01',
411
- timeTo: '2024-01-31'
412
- });
413
-
414
- expect(result.records).toHaveLength(3);
415
- expect(fetch).toHaveBeenCalledTimes(2);
416
- });
417
-
418
- test('should handle single page of results', async () => {
419
- const response = {
420
- records: [{ id: 'call-1' }],
421
- navigation: {}
422
- };
423
- fetch.mockResolvedValue({ status: 200, json: () => Promise.resolve(response) });
424
-
425
- const result = await rc.getCallLogData({
426
- extensionId: '12345',
427
- token,
428
- timezone: 'UTC',
429
- timeFrom: '2024-01-01',
430
- timeTo: '2024-01-31'
431
- });
432
-
433
- expect(result.records).toHaveLength(1);
434
- expect(fetch).toHaveBeenCalledTimes(1);
435
- });
436
- });
437
-
438
- describe('getSMSData', () => {
439
- const token = { token_type: 'bearer', access_token: 'token' };
440
-
441
- test('should get SMS data with pagination', async () => {
442
- const page1 = {
443
- records: [{ id: 'sms-1' }],
444
- navigation: { nextPage: { uri: 'next' } }
445
- };
446
- const page2 = {
447
- records: [{ id: 'sms-2' }],
448
- navigation: {}
449
- };
450
-
451
- fetch
452
- .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page1) })
453
- .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page2) });
454
-
455
- const result = await rc.getSMSData({
456
- token,
457
- timezone: 'UTC',
458
- timeFrom: '2024-01-01',
459
- timeTo: '2024-01-31'
460
- });
461
-
462
- expect(result.records).toHaveLength(2);
463
- });
464
- });
465
- });
466
- });
467
-
1
+ jest.mock('node-fetch');
2
+
3
+ const fetch = require('node-fetch');
4
+ const { RingCentral, isRefreshTokenValid, isAccessTokenValid } = require('../../lib/ringcentral');
5
+
6
+ describe('ringcentral', () => {
7
+ beforeEach(() => {
8
+ jest.clearAllMocks();
9
+ });
10
+
11
+ describe('isRefreshTokenValid', () => {
12
+ test('should return true if refresh token is not expired', () => {
13
+ const token = {
14
+ refresh_token_expire_time: Date.now() + 60000 // 1 minute in future
15
+ };
16
+
17
+ expect(isRefreshTokenValid(token)).toBe(true);
18
+ });
19
+
20
+ test('should return false if refresh token is expired', () => {
21
+ const token = {
22
+ refresh_token_expire_time: Date.now() - 1000 // 1 second ago
23
+ };
24
+
25
+ expect(isRefreshTokenValid(token)).toBe(false);
26
+ });
27
+
28
+ test('should respect custom handicap', () => {
29
+ const token = {
30
+ refresh_token_expire_time: Date.now() + 5000 // 5 seconds in future
31
+ };
32
+
33
+ // With 10s handicap, should be invalid
34
+ expect(isRefreshTokenValid(token, 10000)).toBe(false);
35
+
36
+ // With 1s handicap, should be valid
37
+ expect(isRefreshTokenValid(token, 1000)).toBe(true);
38
+ });
39
+ });
40
+
41
+ describe('isAccessTokenValid', () => {
42
+ test('should return true if access token is not expired', () => {
43
+ const token = {
44
+ expire_time: Date.now() + 120000 // 2 minutes in future
45
+ };
46
+
47
+ expect(isAccessTokenValid(token)).toBe(true);
48
+ });
49
+
50
+ test('should return false if access token is expired', () => {
51
+ const token = {
52
+ expire_time: Date.now() - 1000
53
+ };
54
+
55
+ expect(isAccessTokenValid(token)).toBe(false);
56
+ });
57
+
58
+ test('should respect default 1 minute handicap', () => {
59
+ const token = {
60
+ expire_time: Date.now() + 30000 // 30 seconds in future
61
+ };
62
+
63
+ // With default 1 minute handicap, should be invalid
64
+ expect(isAccessTokenValid(token)).toBe(false);
65
+ });
66
+ });
67
+
68
+ describe('RingCentral class', () => {
69
+ let rc;
70
+ const options = {
71
+ server: 'https://platform.ringcentral.com',
72
+ clientId: 'test-client-id',
73
+ clientSecret: 'test-client-secret',
74
+ redirectUri: 'https://app.example.com/callback'
75
+ };
76
+
77
+ beforeEach(() => {
78
+ rc = new RingCentral(options);
79
+ });
80
+
81
+ describe('loginUrl', () => {
82
+ test('should generate login URL with required parameters', () => {
83
+ const url = rc.loginUrl({});
84
+
85
+ expect(url).toContain('https://platform.ringcentral.com/restapi/oauth/authorize');
86
+ expect(url).toContain('response_type=code');
87
+ expect(url).toContain(`client_id=${options.clientId}`);
88
+ expect(url).toContain(`redirect_uri=${encodeURIComponent(options.redirectUri)}`);
89
+ });
90
+
91
+ test('should include state parameter when provided', () => {
92
+ const url = rc.loginUrl({ state: 'custom-state-123' });
93
+
94
+ expect(url).toContain('state=custom-state-123');
95
+ });
96
+ });
97
+
98
+ describe('generateToken', () => {
99
+ test('should generate token successfully', async () => {
100
+ const mockResponse = {
101
+ status: 200,
102
+ json: jest.fn().mockResolvedValue({
103
+ access_token: 'new-access-token',
104
+ refresh_token: 'new-refresh-token',
105
+ token_type: 'bearer',
106
+ expires_in: 3600,
107
+ refresh_token_expires_in: 604800,
108
+ scope: 'ReadAccounts',
109
+ endpoint_id: 'endpoint-123'
110
+ })
111
+ };
112
+ fetch.mockResolvedValue(mockResponse);
113
+
114
+ const result = await rc.generateToken({ code: 'auth-code-123' });
115
+
116
+ expect(fetch).toHaveBeenCalledWith(
117
+ 'https://platform.ringcentral.com/restapi/oauth/token',
118
+ expect.objectContaining({
119
+ method: 'POST',
120
+ headers: expect.objectContaining({
121
+ 'Content-Type': 'application/x-www-form-urlencoded'
122
+ })
123
+ })
124
+ );
125
+ expect(result.access_token).toBe('new-access-token');
126
+ expect(result.refresh_token).toBe('new-refresh-token');
127
+ expect(result.expire_time).toBeDefined();
128
+ expect(result.refresh_token_expire_time).toBeDefined();
129
+ });
130
+
131
+ test('should throw error on failed token generation', async () => {
132
+ const mockResponse = { status: 401 };
133
+ fetch.mockResolvedValue(mockResponse);
134
+
135
+ await expect(rc.generateToken({ code: 'invalid-code' }))
136
+ .rejects.toThrow('Generate Token error');
137
+ });
138
+ });
139
+
140
+ describe('refreshToken', () => {
141
+ test('should refresh token successfully', async () => {
142
+ const existingToken = {
143
+ refresh_token: 'old-refresh-token',
144
+ expires_in: 3600,
145
+ refresh_token_expires_in: 604800
146
+ };
147
+
148
+ const mockResponse = {
149
+ status: 200,
150
+ json: jest.fn().mockResolvedValue({
151
+ access_token: 'refreshed-access-token',
152
+ refresh_token: 'new-refresh-token',
153
+ token_type: 'bearer',
154
+ expires_in: 3600,
155
+ refresh_token_expires_in: 604800,
156
+ scope: 'ReadAccounts',
157
+ endpoint_id: 'endpoint-456'
158
+ })
159
+ };
160
+ fetch.mockResolvedValue(mockResponse);
161
+
162
+ const result = await rc.refreshToken(existingToken);
163
+
164
+ expect(result.access_token).toBe('refreshed-access-token');
165
+ expect(result.refresh_token).toBe('new-refresh-token');
166
+ expect(result.expire_time).toBeDefined();
167
+ });
168
+
169
+ test('should throw error on failed refresh', async () => {
170
+ const mockResponse = { status: 401 };
171
+ fetch.mockResolvedValue(mockResponse);
172
+
173
+ await expect(rc.refreshToken({ refresh_token: 'expired' }))
174
+ .rejects.toThrow('Refresh Token error');
175
+ });
176
+ });
177
+
178
+ describe('revokeToken', () => {
179
+ test('should revoke token successfully', async () => {
180
+ const mockResponse = { status: 200 };
181
+ fetch.mockResolvedValue(mockResponse);
182
+
183
+ await expect(rc.revokeToken({ access_token: 'token-to-revoke' }))
184
+ .resolves.not.toThrow();
185
+
186
+ expect(fetch).toHaveBeenCalledWith(
187
+ 'https://platform.ringcentral.com/restapi/oauth/revoke',
188
+ expect.objectContaining({ method: 'POST' })
189
+ );
190
+ });
191
+
192
+ test('should throw error on failed revocation', async () => {
193
+ const mockResponse = { status: 500 };
194
+ fetch.mockResolvedValue(mockResponse);
195
+
196
+ await expect(rc.revokeToken({ access_token: 'token' }))
197
+ .rejects.toThrow('Revoke Token error');
198
+ });
199
+ });
200
+
201
+ describe('request', () => {
202
+ const token = {
203
+ token_type: 'bearer',
204
+ access_token: 'test-access-token'
205
+ };
206
+
207
+ test('should make authenticated request', async () => {
208
+ const mockResponse = {
209
+ status: 200,
210
+ json: jest.fn().mockResolvedValue({ data: 'test' })
211
+ };
212
+ fetch.mockResolvedValue(mockResponse);
213
+
214
+ const response = await rc.request({
215
+ path: '/restapi/v1.0/account/~',
216
+ method: 'GET'
217
+ }, token);
218
+
219
+ expect(fetch).toHaveBeenCalledWith(
220
+ 'https://platform.ringcentral.com/restapi/v1.0/account/~',
221
+ expect.objectContaining({
222
+ method: 'GET',
223
+ headers: expect.objectContaining({
224
+ 'Authorization': 'bearer test-access-token'
225
+ })
226
+ })
227
+ );
228
+ expect(response).toBe(mockResponse);
229
+ });
230
+
231
+ test('should include query parameters', async () => {
232
+ const mockResponse = { status: 200 };
233
+ fetch.mockResolvedValue(mockResponse);
234
+
235
+ await rc.request({
236
+ path: '/restapi/v1.0/extension/~/call-log',
237
+ method: 'GET',
238
+ query: { dateFrom: '2024-01-01', dateTo: '2024-01-31' }
239
+ }, token);
240
+
241
+ expect(fetch).toHaveBeenCalledWith(
242
+ expect.stringContaining('dateFrom=2024-01-01'),
243
+ expect.any(Object)
244
+ );
245
+ });
246
+
247
+ test('should include JSON body', async () => {
248
+ const mockResponse = { status: 200 };
249
+ fetch.mockResolvedValue(mockResponse);
250
+
251
+ await rc.request({
252
+ path: '/restapi/v1.0/subscription',
253
+ method: 'POST',
254
+ body: { eventFilters: ['/restapi/v1.0/account/~/extension/~/presence'] }
255
+ }, token);
256
+
257
+ expect(fetch).toHaveBeenCalledWith(
258
+ expect.any(String),
259
+ expect.objectContaining({
260
+ method: 'POST',
261
+ body: expect.stringContaining('eventFilters')
262
+ })
263
+ );
264
+ });
265
+
266
+ test('should throw error on failed request', async () => {
267
+ const mockResponse = {
268
+ status: 401,
269
+ text: jest.fn().mockResolvedValue('Unauthorized')
270
+ };
271
+ fetch.mockResolvedValue(mockResponse);
272
+
273
+ await expect(rc.request({ path: '/test', method: 'GET' }, token))
274
+ .rejects.toThrow('Unauthorized');
275
+ });
276
+
277
+ test('should use custom server if provided', async () => {
278
+ const mockResponse = { status: 200 };
279
+ fetch.mockResolvedValue(mockResponse);
280
+
281
+ await rc.request({
282
+ server: 'https://custom-server.com',
283
+ path: '/api/test',
284
+ method: 'GET'
285
+ }, token);
286
+
287
+ expect(fetch).toHaveBeenCalledWith(
288
+ 'https://custom-server.com/api/test',
289
+ expect.any(Object)
290
+ );
291
+ });
292
+ });
293
+
294
+ describe('createSubscription', () => {
295
+ const token = { token_type: 'bearer', access_token: 'token' };
296
+
297
+ test('should create webhook subscription', async () => {
298
+ const mockResponse = {
299
+ status: 200,
300
+ json: jest.fn().mockResolvedValue({
301
+ id: 'sub-123',
302
+ expirationTime: '2024-01-20T00:00:00Z',
303
+ uri: 'https://platform.ringcentral.com/subscription/sub-123',
304
+ creationTime: '2024-01-13T00:00:00Z',
305
+ deliveryMode: { transportType: 'WebHook' },
306
+ status: 'Active'
307
+ })
308
+ };
309
+ fetch.mockResolvedValue(mockResponse);
310
+
311
+ const result = await rc.createSubscription({
312
+ eventFilters: ['/restapi/v1.0/account/~/extension/~/presence'],
313
+ webhookUri: 'https://app.example.com/webhook'
314
+ }, token);
315
+
316
+ expect(result.id).toBe('sub-123');
317
+ });
318
+ });
319
+
320
+ describe('getExtensionInfo', () => {
321
+ const token = { token_type: 'bearer', access_token: 'token' };
322
+
323
+ test('should get extension info', async () => {
324
+ const extensionInfo = {
325
+ id: 12345,
326
+ name: 'John Doe',
327
+ extensionNumber: '101'
328
+ };
329
+ const mockResponse = {
330
+ status: 200,
331
+ json: jest.fn().mockResolvedValue(extensionInfo)
332
+ };
333
+ fetch.mockResolvedValue(mockResponse);
334
+
335
+ const result = await rc.getExtensionInfo('~', token);
336
+
337
+ expect(result).toEqual(extensionInfo);
338
+ });
339
+ });
340
+
341
+ describe('getAccountInfo', () => {
342
+ const token = { token_type: 'bearer', access_token: 'token' };
343
+
344
+ test('should get account info', async () => {
345
+ const accountInfo = {
346
+ id: 'account-123',
347
+ mainNumber: '+1234567890'
348
+ };
349
+ const mockResponse = {
350
+ status: 200,
351
+ json: jest.fn().mockResolvedValue(accountInfo)
352
+ };
353
+ fetch.mockResolvedValue(mockResponse);
354
+
355
+ const result = await rc.getAccountInfo(token);
356
+
357
+ expect(result).toEqual(accountInfo);
358
+ });
359
+ });
360
+
361
+ describe('getCallsAggregationData', () => {
362
+ const token = { token_type: 'bearer', access_token: 'token' };
363
+
364
+ test('should get calls aggregation data', async () => {
365
+ const aggregationData = {
366
+ records: [{ callsCount: 100, duration: 36000 }]
367
+ };
368
+ const mockResponse = {
369
+ status: 200,
370
+ json: jest.fn().mockResolvedValue(aggregationData)
371
+ };
372
+ fetch.mockResolvedValue(mockResponse);
373
+
374
+ const result = await rc.getCallsAggregationData({
375
+ token,
376
+ timezone: 'America/New_York',
377
+ timeFrom: '2024-01-01',
378
+ timeTo: '2024-01-31',
379
+ groupBy: 'Users'
380
+ });
381
+
382
+ expect(result).toEqual(aggregationData);
383
+ expect(fetch).toHaveBeenCalledWith(
384
+ expect.stringContaining('/analytics/calls/v1/accounts/~/aggregation/fetch'),
385
+ expect.objectContaining({ method: 'POST' })
386
+ );
387
+ });
388
+ });
389
+
390
+ describe('getCallLogData', () => {
391
+ const token = { token_type: 'bearer', access_token: 'token' };
392
+
393
+ test('should get call log data with pagination', async () => {
394
+ const page1 = {
395
+ records: [{ id: 'call-1' }, { id: 'call-2' }],
396
+ navigation: { nextPage: { uri: 'next-page' } }
397
+ };
398
+ const page2 = {
399
+ records: [{ id: 'call-3' }],
400
+ navigation: {}
401
+ };
402
+
403
+ fetch
404
+ .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page1) })
405
+ .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page2) });
406
+
407
+ const result = await rc.getCallLogData({
408
+ token,
409
+ timezone: 'UTC',
410
+ timeFrom: '2024-01-01',
411
+ timeTo: '2024-01-31'
412
+ });
413
+
414
+ expect(result.records).toHaveLength(3);
415
+ expect(fetch).toHaveBeenCalledTimes(2);
416
+ });
417
+
418
+ test('should handle single page of results', async () => {
419
+ const response = {
420
+ records: [{ id: 'call-1' }],
421
+ navigation: {}
422
+ };
423
+ fetch.mockResolvedValue({ status: 200, json: () => Promise.resolve(response) });
424
+
425
+ const result = await rc.getCallLogData({
426
+ extensionId: '12345',
427
+ token,
428
+ timezone: 'UTC',
429
+ timeFrom: '2024-01-01',
430
+ timeTo: '2024-01-31'
431
+ });
432
+
433
+ expect(result.records).toHaveLength(1);
434
+ expect(fetch).toHaveBeenCalledTimes(1);
435
+ });
436
+ });
437
+
438
+ describe('getSMSData', () => {
439
+ const token = { token_type: 'bearer', access_token: 'token' };
440
+
441
+ test('should get SMS data with pagination', async () => {
442
+ const page1 = {
443
+ records: [{ id: 'sms-1' }],
444
+ navigation: { nextPage: { uri: 'next' } }
445
+ };
446
+ const page2 = {
447
+ records: [{ id: 'sms-2' }],
448
+ navigation: {}
449
+ };
450
+
451
+ fetch
452
+ .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page1) })
453
+ .mockResolvedValueOnce({ status: 200, json: () => Promise.resolve(page2) });
454
+
455
+ const result = await rc.getSMSData({
456
+ token,
457
+ timezone: 'UTC',
458
+ timeFrom: '2024-01-01',
459
+ timeTo: '2024-01-31'
460
+ });
461
+
462
+ expect(result.records).toHaveLength(2);
463
+ });
464
+ });
465
+ });
466
+ });
467
+