@itentialopensource/adapter-sevone 2.6.6 → 2.7.1

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 (45) hide show
  1. package/.eslintrc.js +1 -0
  2. package/AUTH.md +4 -4
  3. package/BROKER.md +4 -4
  4. package/CALLS.md +9 -9
  5. package/ENHANCE.md +3 -3
  6. package/PROPERTIES.md +24 -9
  7. package/README.md +24 -23
  8. package/SUMMARY.md +2 -2
  9. package/SYSTEMINFO.md +1 -1
  10. package/TAB1.md +2 -2
  11. package/TAB2.md +11 -7
  12. package/TROUBLESHOOT.md +10 -1
  13. package/UTILITIES.md +473 -0
  14. package/adapter.js +12 -12
  15. package/adapterBase.js +52 -16
  16. package/package.json +24 -28
  17. package/pronghorn.json +15 -13
  18. package/propertiesSchema.json +68 -7
  19. package/report/adapterInfo.json +7 -7
  20. package/report/auto-adapter-openapi.json +51802 -0
  21. package/report/updateReport1748556340163.json +120 -0
  22. package/sampleProperties.json +6 -2
  23. package/test/integration/adapterTestBasicGet.js +88 -54
  24. package/test/integration/adapterTestConnectivity.js +15 -16
  25. package/test/integration/adapterTestIntegration.js +1 -38
  26. package/test/unit/adapterBaseTestUnit.js +641 -39
  27. package/test/unit/adapterTestUnit.js +17 -54
  28. package/utils/adapterInfo.js +114 -164
  29. package/utils/argParser.js +44 -0
  30. package/utils/checkMigrate.js +77 -38
  31. package/utils/entitiesToDB.js +53 -42
  32. package/utils/logger.js +26 -0
  33. package/utils/modify.js +56 -55
  34. package/utils/mongoDbConnection.js +79 -0
  35. package/utils/mongoUtils.js +162 -0
  36. package/utils/taskMover.js +31 -32
  37. package/utils/tbScript.js +36 -172
  38. package/utils/tbUtils.js +84 -226
  39. package/utils/troubleshootingAdapter.js +68 -84
  40. package/utils/updateAdapterConfig.js +158 -0
  41. package/utils/addAuth.js +0 -94
  42. package/utils/artifactize.js +0 -146
  43. package/utils/basicGet.js +0 -50
  44. package/utils/packModificationScript.js +0 -35
  45. package/utils/patches2bundledDeps.js +0 -90
package/adapterBase.js CHANGED
@@ -32,6 +32,7 @@ const entitiesToDB = require(path.join(__dirname, 'utils/entitiesToDB'));
32
32
  const troubleshootingAdapter = require(path.join(__dirname, 'utils/troubleshootingAdapter'));
33
33
  const tbUtils = require(path.join(__dirname, 'utils/tbUtils'));
34
34
  const taskMover = require(path.join(__dirname, 'utils/taskMover'));
35
+ const { updateMongoDBConfig } = require(path.join(__dirname, 'utils/updateAdapterConfig'));
35
36
 
36
37
  let propUtil = null;
37
38
  let choosepath = null;
@@ -366,7 +367,6 @@ class AdapterBase extends EventEmitterCl {
366
367
  // if we were healthy, toggle health
367
368
  if (this.healthy) {
368
369
  this.emit('OFFLINE', { id: this.id });
369
- this.emit('DEGRADED', { id: this.id });
370
370
  this.healthy = false;
371
371
  if (typeof error === 'object') {
372
372
  log.error(`${origin}: HEALTH CHECK - Error ${JSON.stringify(error)}`);
@@ -385,7 +385,6 @@ class AdapterBase extends EventEmitterCl {
385
385
 
386
386
  // if we were unhealthy, toggle health
387
387
  if (!this.healthy) {
388
- this.emit('FIXED', { id: this.id });
389
388
  this.emit('ONLINE', { id: this.id });
390
389
  this.healthy = true;
391
390
  log.info(`${origin}: HEALTH CHECK SUCCESSFUL`);
@@ -583,21 +582,32 @@ class AdapterBase extends EventEmitterCl {
583
582
 
584
583
  // take action based on type of file being changed
585
584
  if (type === 'action') {
586
- // BACKUP???
587
585
  const ares = updateAction(epath, action, changes);
588
586
  if (ares) {
589
587
  const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, `Incomplete Configuration Change: ${ares}`, [], null, null, null);
590
588
  log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
591
589
  return callback(null, errorObj);
592
590
  }
593
- // AJV CHECK???
594
- // RESTORE IF NEEDED???
591
+ // Update MongoDB if possible
592
+ updateMongoDBConfig({
593
+ id: this.id,
594
+ mongoProps: this.allProps.mongo,
595
+ entity,
596
+ type,
597
+ configFile,
598
+ changes,
599
+ action,
600
+ replace
601
+ }).catch((error) => {
602
+ log.error(`${origin}: Error updating MongoDB configuration: ${error.message}`);
603
+ });
595
604
  const result = {
596
605
  response: `Action updates completed to entity: ${entity} - ${action}`
597
606
  };
598
607
  log.info(result.response);
599
608
  return callback(result, null);
600
609
  }
610
+
601
611
  if (type === 'schema') {
602
612
  const sres = updateSchema(epath, configFile, changes);
603
613
  if (sres) {
@@ -605,12 +615,26 @@ class AdapterBase extends EventEmitterCl {
605
615
  log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
606
616
  return callback(null, errorObj);
607
617
  }
618
+ // Update MongoDB if possible
619
+ updateMongoDBConfig({
620
+ id: this.id,
621
+ mongoProps: this.allProps.mongo,
622
+ entity,
623
+ type,
624
+ configFile,
625
+ changes,
626
+ action,
627
+ replace
628
+ }).catch((error) => {
629
+ log.error(`${origin}: Error updating MongoDB configuration: ${error.message}`);
630
+ });
608
631
  const result = {
609
632
  response: `Schema updates completed to entity: ${entity} - ${configFile}`
610
633
  };
611
634
  log.info(result.response);
612
635
  return callback(result, null);
613
636
  }
637
+
614
638
  if (type === 'mock') {
615
639
  // if the mock directory does not exist - error
616
640
  const mpath = `${__dirname}/entities/${entity}/mockdatafiles`;
@@ -624,18 +648,31 @@ class AdapterBase extends EventEmitterCl {
624
648
  return callback(null, errorObj);
625
649
  }
626
650
  const mres = updateMock(mpath, configFile, changes, replace);
627
-
628
651
  if (mres) {
629
652
  const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, `Incomplete Configuration Change: ${mres}`, [], null, null, null);
630
653
  log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
631
654
  return callback(null, errorObj);
632
655
  }
656
+ // Update MongoDB if possible
657
+ updateMongoDBConfig({
658
+ id: this.id,
659
+ mongoProps: this.allProps.mongo,
660
+ entity,
661
+ type,
662
+ configFile,
663
+ changes,
664
+ action,
665
+ replace
666
+ }).catch((error) => {
667
+ log.error(`${origin}: Error updating MongoDB configuration: ${error.message}`);
668
+ });
633
669
  const result = {
634
670
  response: `Mock data updates completed to entity: ${entity} - ${configFile}`
635
671
  };
636
672
  log.info(result.response);
637
673
  return callback(result, null);
638
674
  }
675
+
639
676
  const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, `Incomplete Configuration Change: Unsupported Type - ${type}`, [], null, null, null);
640
677
  log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
641
678
  return callback(null, errorObj);
@@ -831,14 +868,13 @@ class AdapterBase extends EventEmitterCl {
831
868
  *
832
869
  * @function iapTroubleshootAdapter
833
870
  * @param {Object} props - the connection, healthcheck and authentication properties
834
- * @param {boolean} persistFlag - whether the adapter properties should be updated
835
871
  * @param {Adapter} adapter - adapter instance to troubleshoot
836
872
  * @param {Callback} callback - callback function to return troubleshoot results
837
873
  */
838
- async iapTroubleshootAdapter(props, persistFlag, adapter, callback) {
874
+ async iapTroubleshootAdapter(props, adapter, callback) {
839
875
  try {
840
- const result = await troubleshootingAdapter.troubleshoot(props, false, persistFlag, adapter);
841
- if (result.healthCheck && result.connectivity.failCount === 0 && result.basicGet.failCount === 0) {
876
+ const result = await troubleshootingAdapter.troubleshoot(props, false, adapter);
877
+ if (result.healthCheck && result.connectivity.failCount === 0 && result.basicGet.passCount !== 0) {
842
878
  return callback(result);
843
879
  }
844
880
  return callback(null, result);
@@ -875,8 +911,7 @@ class AdapterBase extends EventEmitterCl {
875
911
  */
876
912
  async iapRunAdapterConnectivity(callback) {
877
913
  try {
878
- const { host } = this.allProps;
879
- const result = tbUtils.runConnectivity(host, false);
914
+ const result = tbUtils.runConnectivity(this.allProps.host, false);
880
915
  if (result.failCount > 0) {
881
916
  return callback(null, result);
882
917
  }
@@ -890,12 +925,13 @@ class AdapterBase extends EventEmitterCl {
890
925
  * @summary runs basicGet script for adapter
891
926
  *
892
927
  * @function iapRunAdapterBasicGet
928
+ * @param {number} maxCalls - how many GETs to run (optional)
893
929
  * @param {Callback} callback - callback function to return basicGet result
894
930
  */
895
- iapRunAdapterBasicGet(callback) {
931
+ iapRunAdapterBasicGet(maxCalls, callback) {
896
932
  try {
897
- const result = tbUtils.runBasicGet(false);
898
- if (result.failCount > 0) {
933
+ const result = tbUtils.runBasicGet(this.allProps, false, maxCalls);
934
+ if (result.passCount === 0) {
899
935
  return callback(null, result);
900
936
  }
901
937
  return callback(result);
@@ -917,7 +953,7 @@ class AdapterBase extends EventEmitterCl {
917
953
  log.trace(origin);
918
954
 
919
955
  try {
920
- const result = await entitiesToDB.moveEntitiesToDB(__dirname, { pronghornProps: this.allProps, id: this.id });
956
+ const result = await entitiesToDB.moveEntitiesToDB(__dirname, { pronghornProps: { mongo: this.allProps && this.allProps.mongo }, id: this.id });
921
957
  return callback(result, null);
922
958
  } catch (err) {
923
959
  const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'Caught Exception', null, null, null, err);
package/package.json CHANGED
@@ -1,14 +1,13 @@
1
1
  {
2
2
  "name": "@itentialopensource/adapter-sevone",
3
- "version": "2.6.6",
3
+ "version": "2.7.1",
4
4
  "description": "Itential SevOne Adapter",
5
5
  "main": "adapter.js",
6
6
  "systemName": "SevOne",
7
7
  "wizardVersion": "2.44.7",
8
- "engineVersion": "1.68.2",
8
+ "engineVersion": "1.69.14",
9
9
  "adapterType": "http",
10
10
  "scripts": {
11
- "artifactize": "npm i && node utils/packModificationScript.js",
12
11
  "preinstall": "node utils/setup.js",
13
12
  "deinstall": "node utils/removeHooks.js",
14
13
  "lint": "node --max_old_space_size=4096 ./node_modules/eslint/bin/eslint.js . --ext .json --ext .js",
@@ -17,7 +16,6 @@
17
16
  "test:unit": "mocha test/unit/adapterTestUnit.js --LOG=error",
18
17
  "test:integration": "mocha test/integration/adapterTestIntegration.js --LOG=error",
19
18
  "test": "npm run test:baseunit && npm run test:unit && npm run test:integration",
20
- "adapter:install": "npm i && node utils/tbScript.js install",
21
19
  "adapter:checkMigrate": "node utils/checkMigrate.js",
22
20
  "adapter:findPath": "node utils/findPath.js",
23
21
  "adapter:migrate": "node utils/modify.js -m",
@@ -32,10 +30,9 @@
32
30
  },
33
31
  "keywords": [
34
32
  "Itential",
35
- "IAP",
33
+ "Itential Platform",
36
34
  "Automation",
37
35
  "Integration",
38
- "App-Artifacts",
39
36
  "Adapter",
40
37
  "Telemetry",
41
38
  "Analytics",
@@ -54,30 +51,29 @@
54
51
  "author": "Itential",
55
52
  "homepage": "https://gitlab.com/itentialopensource/adapters/adapter-sevone#readme",
56
53
  "dependencies": {
57
- "@itentialopensource/adapter-utils": "^5.9.4",
58
- "acorn": "^8.12.1",
59
- "ajv": "^8.17.1",
60
- "axios": "^1.8.2",
61
- "commander": "^11.0.0",
62
- "dns-lookup-promise": "^1.0.4",
63
- "fs-extra": "^11.2.0",
64
- "json-query": "^2.2.2",
65
- "mocha": "^10.7.3",
66
- "mocha-param": "^2.0.1",
67
- "mongodb": "^4.16.0",
68
- "ping": "^0.4.4",
69
- "prompts": "^2.4.2",
70
- "readline-sync": "^1.4.10",
71
- "semver": "^7.6.3",
72
- "winston": "^3.14.2"
54
+ "@itentialopensource/adapter-utils": "5.10.19",
55
+ "acorn": "8.14.1",
56
+ "ajv": "8.17.1",
57
+ "axios": "1.9.0",
58
+ "commander": "11.1.0",
59
+ "fs-extra": "11.3.0",
60
+ "json-query": "2.2.2",
61
+ "mocha": "10.8.2",
62
+ "mocha-param": "2.0.1",
63
+ "mongodb": "4.17.2",
64
+ "ping": "0.4.4",
65
+ "prompts": "2.4.2",
66
+ "readline-sync": "1.4.10",
67
+ "semver": "7.7.2",
68
+ "winston": "3.17.0"
73
69
  },
74
70
  "devDependencies": {
75
- "chai": "^4.3.7",
76
- "eslint": "^8.44.0",
77
- "eslint-config-airbnb-base": "^15.0.0",
78
- "eslint-plugin-import": "^2.27.5",
79
- "eslint-plugin-json": "^3.1.0",
80
- "testdouble": "^3.18.0"
71
+ "chai": "4.5.0",
72
+ "eslint": "8.57.0",
73
+ "eslint-config-airbnb-base": "15.0.0",
74
+ "eslint-plugin-import": "2.31.0",
75
+ "eslint-plugin-json": "3.1.0",
76
+ "testdouble": "3.18.0"
81
77
  },
82
78
  "private": false
83
79
  }
package/pronghorn.json CHANGED
@@ -226,16 +226,6 @@
226
226
  "title": "props",
227
227
  "type": "object"
228
228
  }
229
- },
230
- {
231
- "name": "persistFlag",
232
- "type": "boolean",
233
- "info": "Whether the input properties should be saved",
234
- "required": true,
235
- "schema": {
236
- "title": "persistFlag",
237
- "type": "boolean"
238
- }
239
229
  }
240
230
  ],
241
231
  "output": {
@@ -306,7 +296,19 @@
306
296
  "name": "iapRunAdapterBasicGet",
307
297
  "summary": "Runs basicGet script for adapter",
308
298
  "description": "Runs basicGet script for adapter",
309
- "input": [],
299
+ "input": [
300
+ {
301
+ "name": "maxCalls",
302
+ "required": false,
303
+ "type": "number",
304
+ "info": "How many GET endpoints to test (defaults to 5)",
305
+ "schema": {
306
+ "title": "maxCalls",
307
+ "type": "number",
308
+ "default": 5
309
+ }
310
+ }
311
+ ],
310
312
  "output": {
311
313
  "name": "result",
312
314
  "type": "object",
@@ -327,8 +329,8 @@
327
329
  },
328
330
  {
329
331
  "name": "iapMoveAdapterEntitiesToDB",
330
- "summary": "Moves entities from an adapter into the IAP database",
331
- "description": "Moves entities from an adapter into the IAP database",
332
+ "summary": "Moves entities from an adapter into the Itential Platform database",
333
+ "description": "Moves entities from an adapter into the Itential Platform database",
332
334
  "input": [],
333
335
  "output": {
334
336
  "name": "res",
@@ -787,6 +787,14 @@
787
787
  "security/ca.pem"
788
788
  ]
789
789
  },
790
+ "ca_file_content": {
791
+ "type": "string",
792
+ "description": "The content of the CA file used for SSL",
793
+ "default": "",
794
+ "examples": [
795
+ "-----BEGIN CERTIFICATE-----"
796
+ ]
797
+ },
790
798
  "key_file": {
791
799
  "type": "string",
792
800
  "description": "The fully qualified path name to the key file used for SSL",
@@ -876,32 +884,48 @@
876
884
  "mongo": {
877
885
  "type": "object",
878
886
  "properties": {
887
+ "url": {
888
+ "type": "string",
889
+ "description": "Mongo's complete connection URL. This property overrides host, port, database, username, password and replSet settings.",
890
+ "examples": [
891
+ "mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]",
892
+ "mongodb+srv://[username:password@]cluster0.xxxxx.mongodb.net/[defaultauthdb][?options]",
893
+ "mongodb+srv://cluster0.xxxxx.mongodb.net/[defaultauthdb][?options]"
894
+ ]
895
+ },
879
896
  "host": {
880
897
  "type": "string",
881
- "description": "host where mongo database can be found",
898
+ "description": "Host information for the Mongo server",
882
899
  "default": "",
883
900
  "examples": [
884
- "localhost"
901
+ "localhost",
902
+ "cluster0.xxxxx.mongodb.net",
903
+ "my-cluster.example.com"
885
904
  ]
886
905
  },
887
906
  "port": {
888
907
  "type": "integer",
889
- "description": "port on which to connect to the mongo database",
908
+ "description": "Port information for the Mongo server. Not used when using mongodb+srv:// protocol",
890
909
  "default": 443,
891
910
  "minimum": 0,
892
911
  "maximum": 65535
893
912
  },
894
913
  "database": {
895
914
  "type": "string",
896
- "description": "The name of the database to store adapter information in",
915
+ "description": "The database for the adapter to use for its data.",
897
916
  "default": "",
898
917
  "examples": [
899
918
  "adapter-xyz"
900
919
  ]
901
920
  },
921
+ "dbAuth": {
922
+ "type": "boolean",
923
+ "description": "Whether to use authentication for MongoDB connection. Default is false.",
924
+ "default": false
925
+ },
902
926
  "username": {
903
927
  "type": "string",
904
- "description": "The user to connect to the database with",
928
+ "description": "If credentials are required to access Mongo, this is the user to login as.",
905
929
  "default": "",
906
930
  "examples": [
907
931
  "username"
@@ -909,7 +933,7 @@
909
933
  },
910
934
  "password": {
911
935
  "type": "string",
912
- "description": "The password to connect to the database with",
936
+ "description": "If credentials are required to access Mongo, this is the password to login with.",
913
937
  "default": "",
914
938
  "examples": [
915
939
  "password"
@@ -917,12 +941,17 @@
917
941
  },
918
942
  "replSet": {
919
943
  "type": "string",
920
- "description": "The replica set for the database",
944
+ "description": "If the database is set up to use replica sets, define it here so it can be added to the database connection. Not used when using mongodb+srv:// protocol",
921
945
  "default": "",
922
946
  "examples": [
923
947
  "my_repolica_set"
924
948
  ]
925
949
  },
950
+ "addSrv": {
951
+ "type": "boolean",
952
+ "description": "Whether the connection requires the mongodb+srv:// protocol. If true, uses mongodb+srv:// protocol. Note: mongodb+srv:// can also be used for non-Atlas deployments that support DNS SRV records",
953
+ "default": false
954
+ },
926
955
  "db_ssl": {
927
956
  "type": "object",
928
957
  "description": "SSL for mongo database connection",
@@ -963,6 +992,38 @@
963
992
  }
964
993
  }
965
994
  }
995
+ },
996
+ "dependencies": {
997
+ "dbAuth": {
998
+ "oneOf": [
999
+ {
1000
+ "properties": {
1001
+ "dbAuth": {
1002
+ "const": false
1003
+ }
1004
+ }
1005
+ },
1006
+ {
1007
+ "properties": {
1008
+ "dbAuth": {
1009
+ "const": true
1010
+ },
1011
+ "username": {
1012
+ "type": "string",
1013
+ "minLength": 1
1014
+ },
1015
+ "password": {
1016
+ "type": "string",
1017
+ "minLength": 1
1018
+ }
1019
+ },
1020
+ "required": [
1021
+ "username",
1022
+ "password"
1023
+ ]
1024
+ }
1025
+ ]
1026
+ }
966
1027
  }
967
1028
  },
968
1029
  "devicebroker": {
@@ -1,10 +1,10 @@
1
1
  {
2
- "version": "2.6.2",
3
- "configLines": 40825,
4
- "scriptLines": 1783,
5
- "codeLines": 26148,
6
- "testLines": 28742,
7
- "testCases": 1371,
8
- "totalCodeLines": 56673,
2
+ "version": "2.6.6",
3
+ "configLines": 50812,
4
+ "scriptLines": 2498,
5
+ "codeLines": 26184,
6
+ "testLines": 29303,
7
+ "testCases": 1384,
8
+ "totalCodeLines": 57985,
9
9
  "wfTasks": 360
10
10
  }