@webex/webex-core 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/lib/services/service-host.js

@@ -1,23 +1,15 @@
 "use strict";
 
 var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-
 var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
-
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-
 exports.default = void 0;
-
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
-
 var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
-
 var _url = _interopRequireDefault(require("url"));
-
 var _constants = require("./constants");
-
 /**
  * The parameter transfer object for {@link ServiceHost#constructor}.
  *
@@ -29,7 +21,6 @@ var _constants = require("./constants");
  * @property {number} ServiceHostConstructorPTO.priority - The host's priority.
  * @property {string} ServiceHostConstructorPTO.uri - The host's uri.
  */
-
 /**
  * The parameter transfer object for {@link ServiceHost#polyGenerate}.
  *
@@ -38,7 +29,6 @@ var _constants = require("./constants");
  * @property {string} ServiceHostPolyGeneratePTO.name - The service name.
  * @property {string} ServiceHostPolyGeneratePTO.url - The service url.
  */
-
 /**
  * @class
  * @classdesc - Manages a single service host and its associated data.
@@ -55,8 +45,9 @@ var ServiceHost = /*#__PURE__*/function () {
   function ServiceHost(pto) {
     (0, _classCallCheck2.default)(this, ServiceHost);
     // Validate the parameter transfer object.
-    ServiceHost.validate(pto); // Map the parameter transfer object to the class object.
+    ServiceHost.validate(pto);
 
+    // Map the parameter transfer object to the class object.
     /**
      * The catalog name that the {@link ServiceHost} is associated with.
      *
@@ -65,8 +56,8 @@ var ServiceHost = /*#__PURE__*/function () {
      * @public
      * @memberof ServiceHost
      */
-
     this.catalog = pto.catalog;
+
     /**
      * The default URI for the {@link ServiceHost}.
      *
@@ -75,8 +66,8 @@ var ServiceHost = /*#__PURE__*/function () {
      * @public
      * @memberof ServiceHost
      */
-
     this.default = pto.defaultUri;
+
     /**
      * The host group that the {@link ServiceHost} is associated with.
      *
@@ -85,8 +76,8 @@ var ServiceHost = /*#__PURE__*/function () {
      * @public
      * @memberof ServiceHost
      */
-
     this.hostGroup = pto.hostGroup;
+
     /**
      * The cluster ID of the {@link ServiceHost}.
      *
@@ -95,8 +86,8 @@ var ServiceHost = /*#__PURE__*/function () {
      * @public
      * @memberof ServiceHost
      */
-
     this.id = pto.id;
+
     /**
      * The priority value of the {@link ServiceHost}. The lower the number, the
      * higher the priority.
@@ -106,8 +97,8 @@ var ServiceHost = /*#__PURE__*/function () {
      * @public
      * @memberof ServiceHost
      */
-
     this.priority = pto.priority;
+
     /**
      * The host uri of the {@link ServiceHost}.
      *
@@ -116,9 +107,9 @@ var ServiceHost = /*#__PURE__*/function () {
      * @public
      * @memberof ServiceHost
      */
+    this.uri = pto.uri;
 
-    this.uri = pto.uri; // Generate flags.
-
+    // Generate flags.
     /**
      * If the {@link ServiceHost} is marked as failed.
      *
@@ -127,8 +118,8 @@ var ServiceHost = /*#__PURE__*/function () {
      * @protected
      * @memberof ServiceHost
      */
-
     this.failed = false;
+
     /**
      * If the {@link ServiceHost} is marked as replaced.
      *
@@ -137,9 +128,9 @@ var ServiceHost = /*#__PURE__*/function () {
      * @protected
      * @memberof ServiceHost
      */
-
     this.replaced = false;
   }
+
   /**
    * If the {@link ServiceHost} is in an active state.
    *
@@ -147,14 +138,13 @@ var ServiceHost = /*#__PURE__*/function () {
    * @memberof ServiceHost
    * @type {boolean} - `true` if the service is active and usable.
    */
-
-
   (0, _createClass2.default)(ServiceHost, [{
     key: "active",
     get: function get() {
       // Validate that the `ServiceHost` was not marked as failed or replaced.
       return !this.failed && !this.replaced;
     }
+
     /**
      * If the host is local to the user's cluster.
      *
@@ -162,12 +152,12 @@ var ServiceHost = /*#__PURE__*/function () {
      * @memberof ServiceHost
      * @type {boolean} - If the host is local.
      */
-
   }, {
     key: "local",
     get: function get() {
       return this.default.includes(this.hostGroup);
     }
+
     /**
      * The service value.
      *
@@ -175,12 +165,12 @@ var ServiceHost = /*#__PURE__*/function () {
      * @memberof ServiceHost
      * @type {string} - The service value.
      */
-
   }, {
     key: "service",
     get: function get() {
       return this.id.split(':')[3];
     }
+
     /**
      * The formatted url for the host.
      *
@@ -188,18 +178,19 @@ var ServiceHost = /*#__PURE__*/function () {
      * @memberof ServiceHost
      * @type {string} - The service url.
      */
-
   }, {
     key: "url",
     get: function get() {
       // Generate a url object from the default url.
-      var urlObj = _url.default.parse(this.default); // Format the host of the generated url object.
-
+      var urlObj = _url.default.parse(this.default);
 
-      urlObj.host = "".concat(this.uri).concat(urlObj.port ? ":".concat(urlObj.port) : ''); // Assign the formatted url to this.
+      // Format the host of the generated url object.
+      urlObj.host = "".concat(this.uri).concat(urlObj.port ? ":".concat(urlObj.port) : '');
 
+      // Assign the formatted url to this.
       return _url.default.format(urlObj);
     }
+
     /**
      * Set one or more of the status properties of the class object.
      *
@@ -210,23 +201,20 @@ var ServiceHost = /*#__PURE__*/function () {
      * @property {boolean} [pto.replaced] - the replaced status to set.
      * @returns {this}
      */
-
   }, {
     key: "setStatus",
     value: function setStatus(_ref) {
       var failed = _ref.failed,
-          replaced = _ref.replaced;
-
+        replaced = _ref.replaced;
       if (failed !== undefined) {
         this.failed = failed;
       }
-
       if (replaced !== undefined) {
         this.replaced = replaced;
       }
-
       return this;
     }
+
     /**
      * Generate a service host using only a catalog, name, and URL.
      *
@@ -236,13 +224,12 @@ var ServiceHost = /*#__PURE__*/function () {
      * @param {ServiceHostPolyGeneratePTO} pto
      * @returns {ServiceHost} - The generated service host.
      */
-
   }], [{
     key: "polyGenerate",
     value: function polyGenerate(_ref2) {
       var catalog = _ref2.catalog,
-          name = _ref2.name,
-          url = _ref2.url;
+        name = _ref2.name,
+        url = _ref2.url;
       return new ServiceHost({
         catalog: catalog,
         defaultUri: url,
@@ -252,6 +239,7 @@ var ServiceHost = /*#__PURE__*/function () {
         uri: _url.default.parse(url).host
       });
     }
+
     /**
      * Validate that a constructor parameter transfer object is valid.
      *
@@ -262,55 +250,52 @@ var ServiceHost = /*#__PURE__*/function () {
      * @throws - If the parameter transfer object is not valid.
      * @returns {undefined}
      */
-
   }, {
     key: "validate",
     value: function validate(_ref3) {
       var catalog = _ref3.catalog,
-          defaultUri = _ref3.defaultUri,
-          hostGroup = _ref3.hostGroup,
-          id = _ref3.id,
-          priority = _ref3.priority,
-          uri = _ref3.uri;
-
+        defaultUri = _ref3.defaultUri,
+        hostGroup = _ref3.hostGroup,
+        id = _ref3.id,
+        priority = _ref3.priority,
+        uri = _ref3.uri;
       // Generate error-throwing method.
       var throwError = function throwError(msg) {
         throw new Error("service-host: invalid constructor parameters, ".concat(msg));
-      }; // Validate the catalog property.
-
+      };
 
+      // Validate the catalog property.
       if (!_constants.SERVICE_CATALOGS.includes(catalog)) {
-        throwError('\'catalog\' must be a string');
-      } // Validate the `defaultUri` property.
-
+        throwError("'catalog' must be a string");
+      }
 
+      // Validate the `defaultUri` property.
       if (typeof defaultUri !== 'string') {
-        throwError('\'defaultUri\' must be a string');
-      } // Validate the `hostGroup` property.
-
+        throwError("'defaultUri' must be a string");
+      }
 
+      // Validate the `hostGroup` property.
       if (typeof hostGroup !== 'string') {
-        throwError('\'hostGroup\' must be a string');
-      } // Validate the `id` property.
-
+        throwError("'hostGroup' must be a string");
+      }
 
+      // Validate the `id` property.
       if (typeof id !== 'string' || id.split(':').length !== 4) {
-        throwError('\'id\' must be a string that contains 3 \':\' characters');
-      } // Validate the `priority` property.
-
+        throwError("'id' must be a string that contains 3 ':' characters");
+      }
 
+      // Validate the `priority` property.
       if (typeof priority !== 'number') {
-        throwError('\'priority\' must be a number');
-      } // Validate the `uri` property.
-
+        throwError("'priority' must be a number");
+      }
 
+      // Validate the `uri` property.
       if (typeof uri !== 'string') {
-        throwError('\'uri\' must be a string');
+        throwError("'uri' must be a string");
       }
     }
   }]);
   return ServiceHost;
 }();
-
 exports.default = ServiceHost;
 //# sourceMappingURL=service-host.js.map

package/dist/lib/services/service-host.js.map

@@ -1 +1 @@
-{"version":3,"names":["ServiceHost","pto","validate","catalog","default","defaultUri","hostGroup","id","priority","uri","failed","replaced","includes","split","urlObj","Url","parse","host","port","format","undefined","name","url","throwError","msg","Error","SERVICE_CATALOGS","length"],"sources":["service-host.js"],"sourcesContent":["import Url from 'url';\n\nimport {SERVICE_CATALOGS} from './constants';\n\n/**\n * The parameter transfer object for {@link ServiceHost#constructor}.\n *\n * @typedef {Object} ServiceHostConstructorPTO\n * @property {string} ServiceHostConstructorPTO.catalog - The host's catalog.\n * @property {string} ServiceHostConstructorPTO.defaultUri - The host's default.\n * @property {string} ServiceHostConstructorPTO.hostGroup - The host's group.\n * @property {string} ServiceHostConstructorPTO.id - The host's clusterId.\n * @property {number} ServiceHostConstructorPTO.priority - The host's priority.\n * @property {string} ServiceHostConstructorPTO.uri - The host's uri.\n */\n\n/**\n * The parameter transfer object for {@link ServiceHost#polyGenerate}.\n *\n * @typedef {Object} ServiceHostPolyGeneratePTO\n * @property {string} ServiceHostPolyGeneratePTO.catalog - The target catalog.\n * @property {string} ServiceHostPolyGeneratePTO.name - The service name.\n * @property {string} ServiceHostPolyGeneratePTO.url - The service url.\n */\n\n/**\n * @class\n * @classdesc - Manages a single service host and its associated data.\n */\nexport default class ServiceHost {\n  /**\n   * Generate a new {@link ServiceHost}.\n   *\n   * @public\n   * @constructor\n   * @memberof ServiceHost\n   * @param {ServiceHostConstructorPTO} pto\n   */\n  constructor(pto) {\n    // Validate the parameter transfer object.\n    ServiceHost.validate(pto);\n\n    // Map the parameter transfer object to the class object.\n    /**\n     * The catalog name that the {@link ServiceHost} is associated with.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.catalog = pto.catalog;\n\n    /**\n     * The default URI for the {@link ServiceHost}.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.default = pto.defaultUri;\n\n    /**\n     * The host group that the {@link ServiceHost} is associated with.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.hostGroup = pto.hostGroup;\n\n    /**\n     * The cluster ID of the {@link ServiceHost}.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.id = pto.id;\n\n    /**\n     * The priority value of the {@link ServiceHost}. The lower the number, the\n     * higher the priority.\n     *\n     * @instance\n     * @type {number}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.priority = pto.priority;\n\n    /**\n     * The host uri of the {@link ServiceHost}.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.uri = pto.uri;\n\n    // Generate flags.\n    /**\n     * If the {@link ServiceHost} is marked as failed.\n     *\n     * @instance\n     * @type {boolean}\n     * @protected\n     * @memberof ServiceHost\n     */\n    this.failed = false;\n\n    /**\n     * If the {@link ServiceHost} is marked as replaced.\n     *\n     * @instance\n     * @type {boolean}\n     * @protected\n     * @memberof ServiceHost\n     */\n    this.replaced = false;\n  }\n\n  /**\n   * If the {@link ServiceHost} is in an active state.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {boolean} - `true` if the service is active and usable.\n   */\n  get active() {\n    // Validate that the `ServiceHost` was not marked as failed or replaced.\n    return (!this.failed && !this.replaced);\n  }\n\n  /**\n   * If the host is local to the user's cluster.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {boolean} - If the host is local.\n   */\n  get local() {\n    return this.default.includes(this.hostGroup);\n  }\n\n  /**\n   * The service value.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {string} - The service value.\n   */\n  get service() {\n    return this.id.split(':')[3];\n  }\n\n  /**\n   * The formatted url for the host.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {string} - The service url.\n   */\n  get url() {\n    // Generate a url object from the default url.\n    const urlObj = Url.parse(this.default);\n\n    // Format the host of the generated url object.\n    urlObj.host = `${this.uri}${urlObj.port ? `:${urlObj.port}` : ''}`;\n\n    // Assign the formatted url to this.\n    return Url.format(urlObj);\n  }\n\n  /**\n   * Set one or more of the status properties of the class object.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @param {Object} pto - The parameter transfer object.\n   * @property {boolean} [pto.failed] - The failed status to set.\n   * @property {boolean} [pto.replaced] - the replaced status to set.\n   * @returns {this}\n   */\n  setStatus({failed, replaced}) {\n    if (failed !== undefined) {\n      this.failed = failed;\n    }\n\n    if (replaced !== undefined) {\n      this.replaced = replaced;\n    }\n\n    return this;\n  }\n\n  /**\n   * Generate a service host using only a catalog, name, and URL.\n   *\n   * @public\n   * @static\n   * @memberof ServiceHost\n   * @param {ServiceHostPolyGeneratePTO} pto\n   * @returns {ServiceHost} - The generated service host.\n   */\n  static polyGenerate({catalog, name, url}) {\n    return new ServiceHost({\n      catalog,\n      defaultUri: url,\n      hostGroup: Url.parse(url).host,\n      id: (name) ? `poly-head:poly-group:poly-cluster:${name}` : undefined,\n      priority: 1,\n      uri: Url.parse(url).host\n    });\n  }\n\n  /**\n   * Validate that a constructor parameter transfer object is valid.\n   *\n   * @public\n   * @static\n   * @memberof ServiceHost\n   * @param {ServiceHostConstructorPTO} pto\n   * @throws - If the parameter transfer object is not valid.\n   * @returns {undefined}\n   */\n  static validate({\n    catalog,\n    defaultUri,\n    hostGroup,\n    id,\n    priority,\n    uri\n  }) {\n    // Generate error-throwing method.\n    const throwError = (msg) => {\n      throw new Error(`service-host: invalid constructor parameters, ${msg}`);\n    };\n\n    // Validate the catalog property.\n    if (!SERVICE_CATALOGS.includes(catalog)) {\n      throwError('\\'catalog\\' must be a string');\n    }\n\n    // Validate the `defaultUri` property.\n    if (typeof defaultUri !== 'string') {\n      throwError('\\'defaultUri\\' must be a string');\n    }\n\n    // Validate the `hostGroup` property.\n    if (typeof hostGroup !== 'string') {\n      throwError('\\'hostGroup\\' must be a string');\n    }\n\n    // Validate the `id` property.\n    if (typeof id !== 'string' || id.split(':').length !== 4) {\n      throwError('\\'id\\' must be a string that contains 3 \\':\\' characters');\n    }\n\n    // Validate the `priority` property.\n    if (typeof priority !== 'number') {\n      throwError('\\'priority\\' must be a number');\n    }\n\n    // Validate the `uri` property.\n    if (typeof uri !== 'string') {\n      throwError('\\'uri\\' must be a string');\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;IACqBA,W;EACnB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,qBAAYC,GAAZ,EAAiB;IAAA;IACf;IACAD,WAAW,CAACE,QAAZ,CAAqBD,GAArB,EAFe,CAIf;;IACA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKE,OAAL,GAAeF,GAAG,CAACE,OAAnB;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKC,OAAL,GAAeH,GAAG,CAACI,UAAnB;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKC,SAAL,GAAiBL,GAAG,CAACK,SAArB;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKC,EAAL,GAAUN,GAAG,CAACM,EAAd;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKC,QAAL,GAAgBP,GAAG,CAACO,QAApB;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKC,GAAL,GAAWR,GAAG,CAACQ,GAAf,CAhEe,CAkEf;;IACA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKC,MAAL,GAAc,KAAd;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;IACI,KAAKC,QAAL,GAAgB,KAAhB;EACD;EAED;AACF;AACA;AACA;AACA;AACA;AACA;;;;;SACE,eAAa;MACX;MACA,OAAQ,CAAC,KAAKD,MAAN,IAAgB,CAAC,KAAKC,QAA9B;IACD;IAED;AACF;AACA;AACA;AACA;AACA;AACA;;;;SACE,eAAY;MACV,OAAO,KAAKP,OAAL,CAAaQ,QAAb,CAAsB,KAAKN,SAA3B,CAAP;IACD;IAED;AACF;AACA;AACA;AACA;AACA;AACA;;;;SACE,eAAc;MACZ,OAAO,KAAKC,EAAL,CAAQM,KAAR,CAAc,GAAd,EAAmB,CAAnB,CAAP;IACD;IAED;AACF;AACA;AACA;AACA;AACA;AACA;;;;SACE,eAAU;MACR;MACA,IAAMC,MAAM,GAAGC,YAAA,CAAIC,KAAJ,CAAU,KAAKZ,OAAf,CAAf,CAFQ,CAIR;;;MACAU,MAAM,CAACG,IAAP,aAAiB,KAAKR,GAAtB,SAA4BK,MAAM,CAACI,IAAP,cAAkBJ,MAAM,CAACI,IAAzB,IAAkC,EAA9D,EALQ,CAOR;;MACA,OAAOH,YAAA,CAAII,MAAJ,CAAWL,MAAX,CAAP;IACD;IAED;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;;WACE,yBAA8B;MAAA,IAAnBJ,MAAmB,QAAnBA,MAAmB;MAAA,IAAXC,QAAW,QAAXA,QAAW;;MAC5B,IAAID,MAAM,KAAKU,SAAf,EAA0B;QACxB,KAAKV,MAAL,GAAcA,MAAd;MACD;;MAED,IAAIC,QAAQ,KAAKS,SAAjB,EAA4B;QAC1B,KAAKT,QAAL,GAAgBA,QAAhB;MACD;;MAED,OAAO,IAAP;IACD;IAED;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;;WACE,6BAA0C;MAAA,IAArBR,OAAqB,SAArBA,OAAqB;MAAA,IAAZkB,IAAY,SAAZA,IAAY;MAAA,IAANC,GAAM,SAANA,GAAM;MACxC,OAAO,IAAItB,WAAJ,CAAgB;QACrBG,OAAO,EAAPA,OADqB;QAErBE,UAAU,EAAEiB,GAFS;QAGrBhB,SAAS,EAAES,YAAA,CAAIC,KAAJ,CAAUM,GAAV,EAAeL,IAHL;QAIrBV,EAAE,EAAGc,IAAD,+CAA8CA,IAA9C,IAAuDD,SAJtC;QAKrBZ,QAAQ,EAAE,CALW;QAMrBC,GAAG,EAAEM,YAAA,CAAIC,KAAJ,CAAUM,GAAV,EAAeL;MANC,CAAhB,CAAP;IAQD;IAED;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;;WACE,yBAOG;MAAA,IANDd,OAMC,SANDA,OAMC;MAAA,IALDE,UAKC,SALDA,UAKC;MAAA,IAJDC,SAIC,SAJDA,SAIC;MAAA,IAHDC,EAGC,SAHDA,EAGC;MAAA,IAFDC,QAEC,SAFDA,QAEC;MAAA,IADDC,GACC,SADDA,GACC;;MACD;MACA,IAAMc,UAAU,GAAG,SAAbA,UAAa,CAACC,GAAD,EAAS;QAC1B,MAAM,IAAIC,KAAJ,yDAA2DD,GAA3D,EAAN;MACD,CAFD,CAFC,CAMD;;;MACA,IAAI,CAACE,2BAAA,CAAiBd,QAAjB,CAA0BT,OAA1B,CAAL,EAAyC;QACvCoB,UAAU,CAAC,8BAAD,CAAV;MACD,CATA,CAWD;;;MACA,IAAI,OAAOlB,UAAP,KAAsB,QAA1B,EAAoC;QAClCkB,UAAU,CAAC,iCAAD,CAAV;MACD,CAdA,CAgBD;;;MACA,IAAI,OAAOjB,SAAP,KAAqB,QAAzB,EAAmC;QACjCiB,UAAU,CAAC,gCAAD,CAAV;MACD,CAnBA,CAqBD;;;MACA,IAAI,OAAOhB,EAAP,KAAc,QAAd,IAA0BA,EAAE,CAACM,KAAH,CAAS,GAAT,EAAcc,MAAd,KAAyB,CAAvD,EAA0D;QACxDJ,UAAU,CAAC,0DAAD,CAAV;MACD,CAxBA,CA0BD;;;MACA,IAAI,OAAOf,QAAP,KAAoB,QAAxB,EAAkC;QAChCe,UAAU,CAAC,+BAAD,CAAV;MACD,CA7BA,CA+BD;;;MACA,IAAI,OAAOd,GAAP,KAAe,QAAnB,EAA6B;QAC3Bc,UAAU,CAAC,0BAAD,CAAV;MACD;IACF"}
+{"version":3,"names":["ServiceHost","pto","validate","catalog","default","defaultUri","hostGroup","id","priority","uri","failed","replaced","includes","split","urlObj","Url","parse","host","port","format","undefined","name","url","throwError","msg","Error","SERVICE_CATALOGS","length"],"sources":["service-host.js"],"sourcesContent":["import Url from 'url';\n\nimport {SERVICE_CATALOGS} from './constants';\n\n/**\n * The parameter transfer object for {@link ServiceHost#constructor}.\n *\n * @typedef {Object} ServiceHostConstructorPTO\n * @property {string} ServiceHostConstructorPTO.catalog - The host's catalog.\n * @property {string} ServiceHostConstructorPTO.defaultUri - The host's default.\n * @property {string} ServiceHostConstructorPTO.hostGroup - The host's group.\n * @property {string} ServiceHostConstructorPTO.id - The host's clusterId.\n * @property {number} ServiceHostConstructorPTO.priority - The host's priority.\n * @property {string} ServiceHostConstructorPTO.uri - The host's uri.\n */\n\n/**\n * The parameter transfer object for {@link ServiceHost#polyGenerate}.\n *\n * @typedef {Object} ServiceHostPolyGeneratePTO\n * @property {string} ServiceHostPolyGeneratePTO.catalog - The target catalog.\n * @property {string} ServiceHostPolyGeneratePTO.name - The service name.\n * @property {string} ServiceHostPolyGeneratePTO.url - The service url.\n */\n\n/**\n * @class\n * @classdesc - Manages a single service host and its associated data.\n */\nexport default class ServiceHost {\n  /**\n   * Generate a new {@link ServiceHost}.\n   *\n   * @public\n   * @constructor\n   * @memberof ServiceHost\n   * @param {ServiceHostConstructorPTO} pto\n   */\n  constructor(pto) {\n    // Validate the parameter transfer object.\n    ServiceHost.validate(pto);\n\n    // Map the parameter transfer object to the class object.\n    /**\n     * The catalog name that the {@link ServiceHost} is associated with.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.catalog = pto.catalog;\n\n    /**\n     * The default URI for the {@link ServiceHost}.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.default = pto.defaultUri;\n\n    /**\n     * The host group that the {@link ServiceHost} is associated with.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.hostGroup = pto.hostGroup;\n\n    /**\n     * The cluster ID of the {@link ServiceHost}.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.id = pto.id;\n\n    /**\n     * The priority value of the {@link ServiceHost}. The lower the number, the\n     * higher the priority.\n     *\n     * @instance\n     * @type {number}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.priority = pto.priority;\n\n    /**\n     * The host uri of the {@link ServiceHost}.\n     *\n     * @instance\n     * @type {string}\n     * @public\n     * @memberof ServiceHost\n     */\n    this.uri = pto.uri;\n\n    // Generate flags.\n    /**\n     * If the {@link ServiceHost} is marked as failed.\n     *\n     * @instance\n     * @type {boolean}\n     * @protected\n     * @memberof ServiceHost\n     */\n    this.failed = false;\n\n    /**\n     * If the {@link ServiceHost} is marked as replaced.\n     *\n     * @instance\n     * @type {boolean}\n     * @protected\n     * @memberof ServiceHost\n     */\n    this.replaced = false;\n  }\n\n  /**\n   * If the {@link ServiceHost} is in an active state.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {boolean} - `true` if the service is active and usable.\n   */\n  get active() {\n    // Validate that the `ServiceHost` was not marked as failed or replaced.\n    return !this.failed && !this.replaced;\n  }\n\n  /**\n   * If the host is local to the user's cluster.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {boolean} - If the host is local.\n   */\n  get local() {\n    return this.default.includes(this.hostGroup);\n  }\n\n  /**\n   * The service value.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {string} - The service value.\n   */\n  get service() {\n    return this.id.split(':')[3];\n  }\n\n  /**\n   * The formatted url for the host.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @type {string} - The service url.\n   */\n  get url() {\n    // Generate a url object from the default url.\n    const urlObj = Url.parse(this.default);\n\n    // Format the host of the generated url object.\n    urlObj.host = `${this.uri}${urlObj.port ? `:${urlObj.port}` : ''}`;\n\n    // Assign the formatted url to this.\n    return Url.format(urlObj);\n  }\n\n  /**\n   * Set one or more of the status properties of the class object.\n   *\n   * @public\n   * @memberof ServiceHost\n   * @param {Object} pto - The parameter transfer object.\n   * @property {boolean} [pto.failed] - The failed status to set.\n   * @property {boolean} [pto.replaced] - the replaced status to set.\n   * @returns {this}\n   */\n  setStatus({failed, replaced}) {\n    if (failed !== undefined) {\n      this.failed = failed;\n    }\n\n    if (replaced !== undefined) {\n      this.replaced = replaced;\n    }\n\n    return this;\n  }\n\n  /**\n   * Generate a service host using only a catalog, name, and URL.\n   *\n   * @public\n   * @static\n   * @memberof ServiceHost\n   * @param {ServiceHostPolyGeneratePTO} pto\n   * @returns {ServiceHost} - The generated service host.\n   */\n  static polyGenerate({catalog, name, url}) {\n    return new ServiceHost({\n      catalog,\n      defaultUri: url,\n      hostGroup: Url.parse(url).host,\n      id: name ? `poly-head:poly-group:poly-cluster:${name}` : undefined,\n      priority: 1,\n      uri: Url.parse(url).host,\n    });\n  }\n\n  /**\n   * Validate that a constructor parameter transfer object is valid.\n   *\n   * @public\n   * @static\n   * @memberof ServiceHost\n   * @param {ServiceHostConstructorPTO} pto\n   * @throws - If the parameter transfer object is not valid.\n   * @returns {undefined}\n   */\n  static validate({catalog, defaultUri, hostGroup, id, priority, uri}) {\n    // Generate error-throwing method.\n    const throwError = (msg) => {\n      throw new Error(`service-host: invalid constructor parameters, ${msg}`);\n    };\n\n    // Validate the catalog property.\n    if (!SERVICE_CATALOGS.includes(catalog)) {\n      throwError(\"'catalog' must be a string\");\n    }\n\n    // Validate the `defaultUri` property.\n    if (typeof defaultUri !== 'string') {\n      throwError(\"'defaultUri' must be a string\");\n    }\n\n    // Validate the `hostGroup` property.\n    if (typeof hostGroup !== 'string') {\n      throwError(\"'hostGroup' must be a string\");\n    }\n\n    // Validate the `id` property.\n    if (typeof id !== 'string' || id.split(':').length !== 4) {\n      throwError(\"'id' must be a string that contains 3 ':' characters\");\n    }\n\n    // Validate the `priority` property.\n    if (typeof priority !== 'number') {\n      throwError(\"'priority' must be a number\");\n    }\n\n    // Validate the `uri` property.\n    if (typeof uri !== 'string') {\n      throwError(\"'uri' must be a string\");\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AAEA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AAHA,IAIqBA,WAAW;EAC9B;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,qBAAYC,GAAG,EAAE;IAAA;IACf;IACAD,WAAW,CAACE,QAAQ,CAACD,GAAG,CAAC;;IAEzB;IACA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACE,OAAO,GAAGF,GAAG,CAACE,OAAO;;IAE1B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACC,OAAO,GAAGH,GAAG,CAACI,UAAU;;IAE7B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACC,SAAS,GAAGL,GAAG,CAACK,SAAS;;IAE9B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACC,EAAE,GAAGN,GAAG,CAACM,EAAE;;IAEhB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACC,QAAQ,GAAGP,GAAG,CAACO,QAAQ;;IAE5B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACC,GAAG,GAAGR,GAAG,CAACQ,GAAG;;IAElB;IACA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACC,MAAM,GAAG,KAAK;;IAEnB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,IAAI,CAACC,QAAQ,GAAG,KAAK;EACvB;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EANE;IAAA;IAAA,KAOA,eAAa;MACX;MACA,OAAO,CAAC,IAAI,CAACD,MAAM,IAAI,CAAC,IAAI,CAACC,QAAQ;IACvC;;IAEA;AACF;AACA;AACA;AACA;AACA;AACA;EANE;IAAA;IAAA,KAOA,eAAY;MACV,OAAO,IAAI,CAACP,OAAO,CAACQ,QAAQ,CAAC,IAAI,CAACN,SAAS,CAAC;IAC9C;;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"}