@app-connect/core 1.7.8 → 1.7.11

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 (69) hide show
  1. package/connector/developerPortal.js +43 -0
  2. package/connector/proxy/index.js +10 -3
  3. package/connector/registry.js +8 -6
  4. package/handlers/admin.js +44 -21
  5. package/handlers/auth.js +97 -69
  6. package/handlers/calldown.js +10 -4
  7. package/handlers/contact.js +45 -112
  8. package/handlers/disposition.js +4 -142
  9. package/handlers/log.js +174 -259
  10. package/handlers/user.js +19 -6
  11. package/index.js +310 -122
  12. package/lib/analytics.js +3 -1
  13. package/lib/authSession.js +68 -0
  14. package/lib/callLogComposer.js +498 -420
  15. package/lib/errorHandler.js +206 -0
  16. package/lib/jwt.js +2 -0
  17. package/lib/logger.js +190 -0
  18. package/lib/oauth.js +21 -12
  19. package/lib/ringcentral.js +2 -10
  20. package/lib/sharedSMSComposer.js +471 -0
  21. package/mcp/SupportedPlatforms.md +12 -0
  22. package/mcp/lib/validator.js +91 -0
  23. package/mcp/mcpHandler.js +166 -0
  24. package/mcp/tools/checkAuthStatus.js +90 -0
  25. package/mcp/tools/collectAuthInfo.js +86 -0
  26. package/mcp/tools/createCallLog.js +299 -0
  27. package/mcp/tools/createMessageLog.js +283 -0
  28. package/mcp/tools/doAuth.js +185 -0
  29. package/mcp/tools/findContactByName.js +87 -0
  30. package/mcp/tools/findContactByPhone.js +96 -0
  31. package/mcp/tools/getCallLog.js +98 -0
  32. package/mcp/tools/getHelp.js +39 -0
  33. package/mcp/tools/getPublicConnectors.js +46 -0
  34. package/mcp/tools/index.js +58 -0
  35. package/mcp/tools/logout.js +63 -0
  36. package/mcp/tools/rcGetCallLogs.js +73 -0
  37. package/mcp/tools/setConnector.js +64 -0
  38. package/mcp/tools/updateCallLog.js +122 -0
  39. package/models/accountDataModel.js +34 -0
  40. package/models/cacheModel.js +3 -0
  41. package/package.json +6 -4
  42. package/releaseNotes.json +36 -0
  43. package/test/connector/registry.test.js +145 -0
  44. package/test/handlers/admin.test.js +583 -0
  45. package/test/handlers/auth.test.js +355 -0
  46. package/test/handlers/contact.test.js +852 -0
  47. package/test/handlers/log.test.js +872 -0
  48. package/test/lib/callLogComposer.test.js +1231 -0
  49. package/test/lib/debugTracer.test.js +328 -0
  50. package/test/lib/logger.test.js +206 -0
  51. package/test/lib/oauth.test.js +359 -0
  52. package/test/lib/ringcentral.test.js +473 -0
  53. package/test/lib/sharedSMSComposer.test.js +1084 -0
  54. package/test/lib/util.test.js +282 -0
  55. package/test/mcp/tools/collectAuthInfo.test.js +192 -0
  56. package/test/mcp/tools/createCallLog.test.js +412 -0
  57. package/test/mcp/tools/createMessageLog.test.js +580 -0
  58. package/test/mcp/tools/doAuth.test.js +363 -0
  59. package/test/mcp/tools/findContactByName.test.js +263 -0
  60. package/test/mcp/tools/findContactByPhone.test.js +284 -0
  61. package/test/mcp/tools/getCallLog.test.js +286 -0
  62. package/test/mcp/tools/getPublicConnectors.test.js +128 -0
  63. package/test/mcp/tools/logout.test.js +169 -0
  64. package/test/mcp/tools/setConnector.test.js +177 -0
  65. package/test/mcp/tools/updateCallLog.test.js +346 -0
  66. package/test/models/accountDataModel.test.js +98 -0
  67. package/test/models/dynamo/connectorSchema.test.js +189 -0
  68. package/test/models/models.test.js +539 -0
  69. package/test/setup.js +176 -176
@@ -0,0 +1,98 @@
1
+ // Use in-memory SQLite for isolated model tests
2
+ jest.mock('../../models/sequelize', () => {
3
+ const { Sequelize } = require('sequelize');
4
+ return {
5
+ sequelize: new Sequelize({
6
+ dialect: 'sqlite',
7
+ storage: ':memory:',
8
+ logging: false,
9
+ }),
10
+ };
11
+ });
12
+
13
+ const { AccountDataModel, getOrRefreshAccountData } = require('../../models/accountDataModel');
14
+ const { sequelize } = require('../../models/sequelize');
15
+
16
+ describe('getOrRefreshAccountData', () => {
17
+ beforeAll(async () => {
18
+ await AccountDataModel.sync({ force: true });
19
+ });
20
+
21
+ afterEach(async () => {
22
+ await AccountDataModel.destroy({ where: {} });
23
+ });
24
+
25
+ afterAll(async () => {
26
+ await sequelize.close();
27
+ });
28
+
29
+ test('returns cached data when record exists and refresh not forced', async () => {
30
+ await AccountDataModel.create({
31
+ rcAccountId: 'acc-1',
32
+ platformName: 'test-platform',
33
+ dataKey: 'key-1',
34
+ data: { cached: true },
35
+ });
36
+
37
+ const fetchFn = jest.fn().mockResolvedValue({ cached: false });
38
+
39
+ const out = await getOrRefreshAccountData({
40
+ rcAccountId: 'acc-1',
41
+ platformName: 'test-platform',
42
+ dataKey: 'key-1',
43
+ forceRefresh: false,
44
+ fetchFn,
45
+ });
46
+
47
+ expect(out).toEqual({ cached: true });
48
+ expect(fetchFn).not.toHaveBeenCalled();
49
+ });
50
+
51
+ test('creates new record when none exists', async () => {
52
+ const fetchFn = jest.fn().mockResolvedValue({ fresh: 'data' });
53
+
54
+ const out = await getOrRefreshAccountData({
55
+ rcAccountId: 'acc-2',
56
+ platformName: 'test-platform',
57
+ dataKey: 'key-2',
58
+ fetchFn,
59
+ });
60
+
61
+ expect(out).toEqual({ fresh: 'data' });
62
+ expect(fetchFn).toHaveBeenCalledTimes(1);
63
+
64
+ const stored = await AccountDataModel.findOne({
65
+ where: { rcAccountId: 'acc-2', platformName: 'test-platform', dataKey: 'key-2' },
66
+ });
67
+ expect(stored).not.toBeNull();
68
+ expect(stored.data).toEqual({ fresh: 'data' });
69
+ });
70
+
71
+ test('refreshes existing record when forceRefresh is true', async () => {
72
+ await AccountDataModel.create({
73
+ rcAccountId: 'acc-3',
74
+ platformName: 'test-platform',
75
+ dataKey: 'key-3',
76
+ data: { cached: true },
77
+ });
78
+
79
+ const fetchFn = jest.fn().mockResolvedValue({ cached: false, updated: true });
80
+
81
+ const out = await getOrRefreshAccountData({
82
+ rcAccountId: 'acc-3',
83
+ platformName: 'test-platform',
84
+ dataKey: 'key-3',
85
+ forceRefresh: true,
86
+ fetchFn,
87
+ });
88
+
89
+ expect(fetchFn).toHaveBeenCalledTimes(1);
90
+ expect(out).toEqual({ cached: false, updated: true });
91
+
92
+ const refreshed = await AccountDataModel.findOne({
93
+ where: { rcAccountId: 'acc-3', platformName: 'test-platform', dataKey: 'key-3' },
94
+ });
95
+ expect(refreshed.data).toEqual({ cached: false, updated: true });
96
+ });
97
+ });
98
+
@@ -0,0 +1,189 @@
1
+ // Mock dynamoose before requiring the module
2
+ jest.mock('dynamoose', () => {
3
+ const mockModel = {
4
+ query: jest.fn().mockReturnThis(),
5
+ eq: jest.fn().mockReturnThis(),
6
+ using: jest.fn().mockReturnThis(),
7
+ exec: jest.fn()
8
+ };
9
+
10
+ return {
11
+ Schema: jest.fn().mockReturnValue({}),
12
+ model: jest.fn().mockReturnValue(mockModel)
13
+ };
14
+ });
15
+
16
+ describe('Connector Schema', () => {
17
+ const originalEnv = process.env.DEVELOPER_APP_SERVER_SECRET_KEY;
18
+
19
+ beforeEach(() => {
20
+ jest.clearAllMocks();
21
+ jest.resetModules();
22
+ process.env.DEVELOPER_APP_SERVER_SECRET_KEY = 'test-secret-key-12345678901234';
23
+ });
24
+
25
+ afterEach(() => {
26
+ if (originalEnv) {
27
+ process.env.DEVELOPER_APP_SERVER_SECRET_KEY = originalEnv;
28
+ } else {
29
+ delete process.env.DEVELOPER_APP_SERVER_SECRET_KEY;
30
+ }
31
+ });
32
+
33
+ describe('getProxyConfig', () => {
34
+ test('should return proxy config when connector found', async () => {
35
+ const mockProxyConfig = {
36
+ operations: {
37
+ createCallLog: { method: 'POST', url: '/api/logs' },
38
+ findContact: { method: 'GET', url: '/api/contacts' }
39
+ }
40
+ };
41
+
42
+ const mockConnector = {
43
+ proxyConfig: mockProxyConfig,
44
+ encodedSecretKey: null
45
+ };
46
+
47
+ // Import fresh module
48
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
49
+
50
+ // Mock the query chain
51
+ Connector.query = jest.fn().mockReturnThis();
52
+ Connector.eq = jest.fn().mockReturnThis();
53
+ Connector.using = jest.fn().mockReturnThis();
54
+ Connector.exec = jest.fn().mockResolvedValue([mockConnector]);
55
+
56
+ const result = await Connector.getProxyConfig('proxy-123');
57
+
58
+ expect(Connector.query).toHaveBeenCalledWith('proxyId');
59
+ expect(Connector.eq).toHaveBeenCalledWith('proxy-123');
60
+ expect(Connector.using).toHaveBeenCalledWith('proxyIdIndex');
61
+ expect(result).toEqual(mockProxyConfig);
62
+ });
63
+
64
+ test('should return null when no connector found', async () => {
65
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
66
+
67
+ Connector.query = jest.fn().mockReturnThis();
68
+ Connector.eq = jest.fn().mockReturnThis();
69
+ Connector.using = jest.fn().mockReturnThis();
70
+ Connector.exec = jest.fn().mockResolvedValue([]);
71
+
72
+ const result = await Connector.getProxyConfig('non-existent-proxy');
73
+
74
+ expect(result).toBeNull();
75
+ });
76
+
77
+ test('should handle proxy config without encoded secret key', async () => {
78
+ const mockProxyConfig = {
79
+ operations: {
80
+ findContact: { method: 'GET', url: '/api/contacts' }
81
+ }
82
+ };
83
+
84
+ const mockConnector = {
85
+ proxyConfig: mockProxyConfig,
86
+ encodedSecretKey: ''
87
+ };
88
+
89
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
90
+
91
+ Connector.query = jest.fn().mockReturnThis();
92
+ Connector.eq = jest.fn().mockReturnThis();
93
+ Connector.using = jest.fn().mockReturnThis();
94
+ Connector.exec = jest.fn().mockResolvedValue([mockConnector]);
95
+
96
+ const result = await Connector.getProxyConfig('proxy-no-secret');
97
+
98
+ expect(result).toEqual(mockProxyConfig);
99
+ expect(result.secretKey).toBeUndefined();
100
+ });
101
+
102
+ test('should handle undefined encoded secret key', async () => {
103
+ const mockProxyConfig = {
104
+ operations: {
105
+ createCallLog: { method: 'POST', url: '/api/logs' }
106
+ }
107
+ };
108
+
109
+ const mockConnector = {
110
+ proxyConfig: mockProxyConfig,
111
+ encodedSecretKey: undefined
112
+ };
113
+
114
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
115
+
116
+ Connector.query = jest.fn().mockReturnThis();
117
+ Connector.eq = jest.fn().mockReturnThis();
118
+ Connector.using = jest.fn().mockReturnThis();
119
+ Connector.exec = jest.fn().mockResolvedValue([mockConnector]);
120
+
121
+ const result = await Connector.getProxyConfig('proxy-undefined-secret');
122
+
123
+ expect(result).toEqual(mockProxyConfig);
124
+ expect(result.secretKey).toBeUndefined();
125
+ });
126
+ });
127
+
128
+ describe('CONNECTOR_STATUS constants', () => {
129
+ test('should have correct status values in schema enum', () => {
130
+ // The status values are defined in the schema
131
+ const expectedStatuses = ['private', 'under_review', 'approved', 'rejected'];
132
+
133
+ // Import the module to verify it loads without error
134
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
135
+
136
+ // The module exports Connector which means schema was created successfully
137
+ expect(Connector).toBeDefined();
138
+ expect(typeof Connector.getProxyConfig).toBe('function');
139
+ });
140
+ });
141
+
142
+ describe('Module Structure', () => {
143
+ test('should export Connector model', () => {
144
+ const connectorModule = require('../../../models/dynamo/connectorSchema');
145
+
146
+ expect(connectorModule.Connector).toBeDefined();
147
+ });
148
+
149
+ test('should have getProxyConfig static method', () => {
150
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
151
+
152
+ expect(typeof Connector.getProxyConfig).toBe('function');
153
+ });
154
+ });
155
+
156
+ describe('getDeveloperCipherKey behavior', () => {
157
+ // These tests verify the cipher key handling indirectly through the module
158
+
159
+ test('should handle secret key of exactly 32 characters', async () => {
160
+ process.env.DEVELOPER_APP_SERVER_SECRET_KEY = '12345678901234567890123456789012'; // exactly 32 chars
161
+
162
+ jest.resetModules();
163
+
164
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
165
+
166
+ // If the key is exactly 32 chars, no padding/truncation needed
167
+ expect(Connector).toBeDefined();
168
+ });
169
+
170
+ test('should throw error when DEVELOPER_APP_SERVER_SECRET_KEY is not set and decode is called', async () => {
171
+ delete process.env.DEVELOPER_APP_SERVER_SECRET_KEY;
172
+
173
+ jest.resetModules();
174
+
175
+ const { Connector } = require('../../../models/dynamo/connectorSchema');
176
+
177
+ Connector.query = jest.fn().mockReturnThis();
178
+ Connector.eq = jest.fn().mockReturnThis();
179
+ Connector.using = jest.fn().mockReturnThis();
180
+ Connector.exec = jest.fn().mockResolvedValue([{
181
+ proxyConfig: { test: true },
182
+ encodedSecretKey: 'some-encrypted-value'
183
+ }]);
184
+
185
+ // The decode function will be called which requires the secret key
186
+ await expect(Connector.getProxyConfig('test')).rejects.toThrow('DEVELOPER_APP_SERVER_SECRET_KEY is not defined');
187
+ });
188
+ });
189
+ });