@itentialopensource/adapter-efficientip_solidserver 0.4.5 → 0.5.0

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 +8 -4
  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 -27
  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 +79670 -0
  21. package/report/updateReport1748555310414.json +120 -0
  22. package/sampleProperties.json +4 -0
  23. package/test/integration/adapterTestBasicGet.js +88 -54
  24. package/test/integration/adapterTestConnectivity.js +15 -16
  25. package/test/integration/adapterTestIntegration.js +12 -45
  26. package/test/unit/adapterBaseTestUnit.js +641 -39
  27. package/test/unit/adapterTestUnit.js +28 -61
  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,13 +1,12 @@
1
1
  {
2
2
  "name": "@itentialopensource/adapter-efficientip_solidserver",
3
- "version": "0.4.5",
3
+ "version": "0.5.0",
4
4
  "description": "This adapter integrates with system described as: efficientip solidserver",
5
5
  "main": "adapter.js",
6
6
  "wizardVersion": "2.44.7",
7
- "engineVersion": "1.68.2",
7
+ "engineVersion": "1.69.14",
8
8
  "adapterType": "http",
9
9
  "scripts": {
10
- "artifactize": "npm i && node utils/packModificationScript.js",
11
10
  "preinstall": "node utils/setup.js",
12
11
  "deinstall": "node utils/removeHooks.js",
13
12
  "lint": "node --max_old_space_size=4096 ./node_modules/eslint/bin/eslint.js . --ext .json --ext .js",
@@ -16,7 +15,6 @@
16
15
  "test:unit": "mocha test/unit/adapterTestUnit.js --LOG=error",
17
16
  "test:integration": "mocha test/integration/adapterTestIntegration.js --LOG=error",
18
17
  "test": "npm run test:baseunit && npm run test:unit && npm run test:integration",
19
- "adapter:install": "npm i && node utils/tbScript.js install",
20
18
  "adapter:checkMigrate": "node utils/checkMigrate.js",
21
19
  "adapter:findPath": "node utils/findPath.js",
22
20
  "adapter:migrate": "node utils/modify.js -m",
@@ -31,7 +29,7 @@
31
29
  },
32
30
  "keywords": [
33
31
  "Itential",
34
- "IAP",
32
+ "Itential Platform",
35
33
  "Automation",
36
34
  "Integration",
37
35
  "App-Artifacts",
@@ -53,30 +51,29 @@
53
51
  "author": "Itential",
54
52
  "homepage": "https://gitlab.com/itentialopensource/adapters/adapter-efficientip_solidserver#readme",
55
53
  "dependencies": {
56
- "@itentialopensource/adapter-utils": "^5.10.1",
57
- "acorn": "^8.14.0",
58
- "ajv": "^8.17.1",
59
- "axios": "^1.7.9",
60
- "commander": "^11.0.0",
61
- "dns-lookup-promise": "^1.0.4",
62
- "fs-extra": "^11.2.0",
63
- "json-query": "^2.2.2",
64
- "mocha": "^10.8.2",
65
- "mocha-param": "^2.0.1",
66
- "mongodb": "^4.17.2",
67
- "ping": "^0.4.4",
68
- "prompts": "^2.4.2",
69
- "readline-sync": "^1.4.10",
70
- "semver": "^7.6.3",
71
- "winston": "^3.17.0"
54
+ "@itentialopensource/adapter-utils": "5.10.16",
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"
72
69
  },
73
70
  "devDependencies": {
74
- "chai": "^4.3.7",
75
- "eslint": "^8.44.0",
76
- "eslint-config-airbnb-base": "^15.0.0",
77
- "eslint-plugin-import": "^2.27.5",
78
- "eslint-plugin-json": "^3.1.0",
79
- "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"
80
77
  },
81
78
  "private": false
82
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",
@@ -764,6 +764,14 @@
764
764
  "security/ca.pem"
765
765
  ]
766
766
  },
767
+ "ca_file_content": {
768
+ "type": "string",
769
+ "description": "The content of the CA file used for SSL",
770
+ "default": "",
771
+ "examples": [
772
+ "-----BEGIN CERTIFICATE-----"
773
+ ]
774
+ },
767
775
  "key_file": {
768
776
  "type": "string",
769
777
  "description": "The fully qualified path name to the key file used for SSL",
@@ -853,32 +861,48 @@
853
861
  "mongo": {
854
862
  "type": "object",
855
863
  "properties": {
864
+ "url": {
865
+ "type": "string",
866
+ "description": "Mongo's complete connection URL. This property overrides host, port, database, username, password and replSet settings.",
867
+ "examples": [
868
+ "mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]",
869
+ "mongodb+srv://[username:password@]cluster0.xxxxx.mongodb.net/[defaultauthdb][?options]",
870
+ "mongodb+srv://cluster0.xxxxx.mongodb.net/[defaultauthdb][?options]"
871
+ ]
872
+ },
856
873
  "host": {
857
874
  "type": "string",
858
- "description": "host where mongo database can be found",
875
+ "description": "Host information for the Mongo server",
859
876
  "default": "",
860
877
  "examples": [
861
- "localhost"
878
+ "localhost",
879
+ "cluster0.xxxxx.mongodb.net",
880
+ "my-cluster.example.com"
862
881
  ]
863
882
  },
864
883
  "port": {
865
884
  "type": "integer",
866
- "description": "port on which to connect to the mongo database",
885
+ "description": "Port information for the Mongo server. Not used when using mongodb+srv:// protocol",
867
886
  "default": 443,
868
887
  "minimum": 0,
869
888
  "maximum": 65535
870
889
  },
871
890
  "database": {
872
891
  "type": "string",
873
- "description": "The name of the database to store adapter information in",
892
+ "description": "The database for the adapter to use for its data.",
874
893
  "default": "",
875
894
  "examples": [
876
895
  "adapter-xyz"
877
896
  ]
878
897
  },
898
+ "dbAuth": {
899
+ "type": "boolean",
900
+ "description": "Whether to use authentication for MongoDB connection. Default is false.",
901
+ "default": false
902
+ },
879
903
  "username": {
880
904
  "type": "string",
881
- "description": "The user to connect to the database with",
905
+ "description": "If credentials are required to access Mongo, this is the user to login as.",
882
906
  "default": "",
883
907
  "examples": [
884
908
  "username"
@@ -886,7 +910,7 @@
886
910
  },
887
911
  "password": {
888
912
  "type": "string",
889
- "description": "The password to connect to the database with",
913
+ "description": "If credentials are required to access Mongo, this is the password to login with.",
890
914
  "default": "",
891
915
  "examples": [
892
916
  "password"
@@ -894,12 +918,17 @@
894
918
  },
895
919
  "replSet": {
896
920
  "type": "string",
897
- "description": "The replica set for the database",
921
+ "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",
898
922
  "default": "",
899
923
  "examples": [
900
924
  "my_repolica_set"
901
925
  ]
902
926
  },
927
+ "addSrv": {
928
+ "type": "boolean",
929
+ "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",
930
+ "default": false
931
+ },
903
932
  "db_ssl": {
904
933
  "type": "object",
905
934
  "description": "SSL for mongo database connection",
@@ -940,6 +969,38 @@
940
969
  }
941
970
  }
942
971
  }
972
+ },
973
+ "dependencies": {
974
+ "dbAuth": {
975
+ "oneOf": [
976
+ {
977
+ "properties": {
978
+ "dbAuth": {
979
+ "const": false
980
+ }
981
+ }
982
+ },
983
+ {
984
+ "properties": {
985
+ "dbAuth": {
986
+ "const": true
987
+ },
988
+ "username": {
989
+ "type": "string",
990
+ "minLength": 1
991
+ },
992
+ "password": {
993
+ "type": "string",
994
+ "minLength": 1
995
+ }
996
+ },
997
+ "required": [
998
+ "username",
999
+ "password"
1000
+ ]
1001
+ }
1002
+ ]
1003
+ }
943
1004
  }
944
1005
  },
945
1006
  "devicebroker": {
@@ -1,10 +1,10 @@
1
1
  {
2
- "version": "0.4.2",
3
- "configLines": 41133,
4
- "scriptLines": 1783,
5
- "codeLines": 19147,
6
- "testLines": 12850,
7
- "testCases": 578,
8
- "totalCodeLines": 33780,
2
+ "version": "0.4.6",
3
+ "configLines": 47774,
4
+ "scriptLines": 2498,
5
+ "codeLines": 19183,
6
+ "testLines": 13419,
7
+ "testCases": 591,
8
+ "totalCodeLines": 35100,
9
9
  "wfTasks": 241
10
10
  }