green_link_api 1.1.2 → 1.2.0

package/README.md

@@ -4,8 +4,8 @@ GreenLinkApi - JavaScript client for green_link_api
 ⚡GreenLink API documentation with interactive tools for testing API endpoints.⚡
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 1.1.2
-- Package version: 1.1.2
+- API version: 1.2.0
+- Package version: 1.2.0
 - Build package: org.openapitools.codegen.languages.JavascriptClientCodegen
 
 ## Installation
@@ -194,6 +194,10 @@ Class | Method | HTTP request | Description
 *GreenLinkApi.LocationsApi* | [**locationsProductionSitesRetrieve**](docs/LocationsApi.md#locationsProductionSitesRetrieve) | **GET** /locations/production-sites/ | 
 *GreenLinkApi.LocationsApi* | [**locationsRetrieve**](docs/LocationsApi.md#locationsRetrieve) | **GET** /locations/{id}/ | 
 *GreenLinkApi.LocationsApi* | [**locationsUpdate**](docs/LocationsApi.md#locationsUpdate) | **PUT** /locations/{id}/ | 
+*GreenLinkApi.LogsApi* | [**logsCertificatesCreate**](docs/LogsApi.md#logsCertificatesCreate) | **POST** /logs/certificates/ | 
+*GreenLinkApi.LogsApi* | [**logsCertificatesDestroy**](docs/LogsApi.md#logsCertificatesDestroy) | **DELETE** /logs/certificates/{id}/ | 
+*GreenLinkApi.LogsApi* | [**logsCertificatesList**](docs/LogsApi.md#logsCertificatesList) | **GET** /logs/certificates/ | 
+*GreenLinkApi.LogsApi* | [**logsCertificatesRetrieve**](docs/LogsApi.md#logsCertificatesRetrieve) | **GET** /logs/certificates/{id}/ | 
 *GreenLinkApi.LogsApi* | [**logsProductionEpiasDestroy**](docs/LogsApi.md#logsProductionEpiasDestroy) | **DELETE** /logs/production-epias/{id}/ | 
 *GreenLinkApi.LogsApi* | [**logsProductionEpiasList**](docs/LogsApi.md#logsProductionEpiasList) | **GET** /logs/production-epias/ | 
 *GreenLinkApi.LogsApi* | [**logsProductionEpiasRetrieve**](docs/LogsApi.md#logsProductionEpiasRetrieve) | **GET** /logs/production-epias/{id}/ | 
@@ -257,6 +261,7 @@ Class | Method | HTTP request | Description
 ## Documentation for Models
 
  - [GreenLinkApi.BlockchainTransaction](docs/BlockchainTransaction.md)
+ - [GreenLinkApi.Certificates](docs/Certificates.md)
  - [GreenLinkApi.Consumer](docs/Consumer.md)
  - [GreenLinkApi.ConsumptionDataFileList](docs/ConsumptionDataFileList.md)
  - [GreenLinkApi.ConsumptionDataFromRetailerRequest](docs/ConsumptionDataFromRetailerRequest.md)
@@ -271,6 +276,7 @@ Class | Method | HTTP request | Description
  - [GreenLinkApi.ConsumptionSiteListOrDetail](docs/ConsumptionSiteListOrDetail.md)
  - [GreenLinkApi.ConsumptionSiteMany](docs/ConsumptionSiteMany.md)
  - [GreenLinkApi.ContentTypeEnum](docs/ContentTypeEnum.md)
+ - [GreenLinkApi.EacTypeEnum](docs/EacTypeEnum.md)
  - [GreenLinkApi.EmissionFactor](docs/EmissionFactor.md)
  - [GreenLinkApi.EnergySourceEnum](docs/EnergySourceEnum.md)
  - [GreenLinkApi.EnergySourcePreference](docs/EnergySourcePreference.md)
@@ -285,6 +291,7 @@ Class | Method | HTTP request | Description
  - [GreenLinkApi.MatchingConsumerRequest](docs/MatchingConsumerRequest.md)
  - [GreenLinkApi.MatchingSiteRequest](docs/MatchingSiteRequest.md)
  - [GreenLinkApi.OrganizationTypeEnum](docs/OrganizationTypeEnum.md)
+ - [GreenLinkApi.PaginatedCertificatesList](docs/PaginatedCertificatesList.md)
  - [GreenLinkApi.PaginatedConsumerList](docs/PaginatedConsumerList.md)
  - [GreenLinkApi.PaginatedConsumptionDataPointListOrDetailList](docs/PaginatedConsumptionDataPointListOrDetailList.md)
  - [GreenLinkApi.PaginatedConsumptionSiteListOrDetailList](docs/PaginatedConsumptionSiteListOrDetailList.md)

package/dist/ApiClient.js

@@ -21,7 +21,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 
 /**
 * @module ApiClient
-* @version 1.1.2
+* @version 1.2.0
 */
 
 /**
@@ -79,7 +79,7 @@ var ApiClient = /*#__PURE__*/function () {
      */
 
     this.defaultHeaders = {
-      'User-Agent': 'OpenAPI-Generator/1.1.2/Javascript'
+      'User-Agent': 'OpenAPI-Generator/1.2.0/Javascript'
     };
     /**
      * The default HTTP timeout for all API calls.

package/dist/api/BlockchainApi.js

@@ -24,7 +24,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * Blockchain service.
 * @module api/BlockchainApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var BlockchainApi = /*#__PURE__*/function () {
   /**

package/dist/api/EnergyAssetsApi.js

@@ -46,7 +46,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * EnergyAssets service.
 * @module api/EnergyAssetsApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var EnergyAssetsApi = /*#__PURE__*/function () {
   /**

package/dist/api/EnergyDataApi.js

@@ -66,7 +66,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * EnergyData service.
 * @module api/EnergyDataApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var EnergyDataApi = /*#__PURE__*/function () {
   /**

package/dist/api/HealthCheckApi.js

@@ -18,7 +18,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * HealthCheck service.
 * @module api/HealthCheckApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var HealthCheckApi = /*#__PURE__*/function () {
   /**

package/dist/api/LicensedProductionSitesOnEpiasApi.js

@@ -18,7 +18,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * LicensedProductionSitesOnEpias service.
 * @module api/LicensedProductionSitesOnEpiasApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var LicensedProductionSitesOnEpiasApi = /*#__PURE__*/function () {
   /**

package/dist/api/LocationsApi.js

@@ -24,7 +24,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * Locations service.
 * @module api/LocationsApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var LocationsApi = /*#__PURE__*/function () {
   /**

package/dist/api/LogsApi.js

@@ -7,6 +7,10 @@ exports["default"] = void 0;
 
 var _ApiClient = _interopRequireDefault(require("../ApiClient"));
 
+var _Certificates = _interopRequireDefault(require("../model/Certificates"));
+
+var _PaginatedCertificatesList = _interopRequireDefault(require("../model/PaginatedCertificatesList"));
+
 var _PaginatedProductionDataFromEpiasRequestList = _interopRequireDefault(require("../model/PaginatedProductionDataFromEpiasRequestList"));
 
 var _PaginatedUnprocessedRowList = _interopRequireDefault(require("../model/PaginatedUnprocessedRowList"));
@@ -30,7 +34,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * Logs service.
 * @module api/LogsApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var LogsApi = /*#__PURE__*/function () {
   /**
@@ -46,21 +50,179 @@ var LogsApi = /*#__PURE__*/function () {
     this.apiClient = apiClient || _ApiClient["default"].instance;
   }
   /**
-   * Callback function to receive the result of the logsProductionEpiasDestroy operation.
-   * @callback module:api/LogsApi~logsProductionEpiasDestroyCallback
+   * Callback function to receive the result of the logsCertificatesCreate operation.
+   * @callback module:api/LogsApi~logsCertificatesCreateCallback
    * @param {String} error Error message, if any.
-   * @param data This operation does not return a value.
+   * @param {module:model/Certificates} data The data returned by the service call.
    * @param {String} response The complete HTTP response.
    */
 
   /**
    * Enforces object-level permissions in ``rest_framework.viewsets.ViewSet``, deriving the permission type from the particular action to be performed..  As with ``rules.contrib.views.AutoPermissionRequiredMixin``, this only works when model permissions are registered using ``rules.contrib.models.RulesModelMixin``.
-   * @param {String} id A UUID string identifying this production data from epias request.
-   * @param {module:api/LogsApi~logsProductionEpiasDestroyCallback} callback The callback function, accepting three arguments: error, data, response
+   * @param {module:model/Certificates} certificates 
+   * @param {module:api/LogsApi~logsCertificatesCreateCallback} callback The callback function, accepting three arguments: error, data, response
+   * data is of type: {@link module:model/Certificates}
    */
 
 
   _createClass(LogsApi, [{
+    key: "logsCertificatesCreate",
+    value: function logsCertificatesCreate(certificates, callback) {
+      var postBody = certificates; // verify the required parameter 'certificates' is set
+
+      if (certificates === undefined || certificates === null) {
+        throw new Error("Missing the required parameter 'certificates' when calling logsCertificatesCreate");
+      }
+
+      var pathParams = {};
+      var queryParams = {};
+      var headerParams = {};
+      var formParams = {};
+      var authNames = ['basicAuth', 'jwtAuth', 'tokenAuth'];
+      var contentTypes = ['application/json', 'application/x-www-form-urlencoded', 'multipart/form-data'];
+      var accepts = ['application/json'];
+      var returnType = _Certificates["default"];
+      return this.apiClient.callApi('/logs/certificates/', 'POST', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+    /**
+     * Callback function to receive the result of the logsCertificatesDestroy operation.
+     * @callback module:api/LogsApi~logsCertificatesDestroyCallback
+     * @param {String} error Error message, if any.
+     * @param data This operation does not return a value.
+     * @param {String} response The complete HTTP response.
+     */
+
+    /**
+     * Enforces object-level permissions in ``rest_framework.viewsets.ViewSet``, deriving the permission type from the particular action to be performed..  As with ``rules.contrib.views.AutoPermissionRequiredMixin``, this only works when model permissions are registered using ``rules.contrib.models.RulesModelMixin``.
+     * @param {String} id A UUID string identifying this certificates file.
+     * @param {module:api/LogsApi~logsCertificatesDestroyCallback} callback The callback function, accepting three arguments: error, data, response
+     */
+
+  }, {
+    key: "logsCertificatesDestroy",
+    value: function logsCertificatesDestroy(id, callback) {
+      var postBody = null; // verify the required parameter 'id' is set
+
+      if (id === undefined || id === null) {
+        throw new Error("Missing the required parameter 'id' when calling logsCertificatesDestroy");
+      }
+
+      var pathParams = {
+        'id': id
+      };
+      var queryParams = {};
+      var headerParams = {};
+      var formParams = {};
+      var authNames = ['basicAuth', 'jwtAuth', 'tokenAuth'];
+      var contentTypes = [];
+      var accepts = [];
+      var returnType = null;
+      return this.apiClient.callApi('/logs/certificates/{id}/', 'DELETE', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+    /**
+     * Callback function to receive the result of the logsCertificatesList operation.
+     * @callback module:api/LogsApi~logsCertificatesListCallback
+     * @param {String} error Error message, if any.
+     * @param {module:model/PaginatedCertificatesList} data The data returned by the service call.
+     * @param {String} response The complete HTTP response.
+     */
+
+    /**
+     * Enforces object-level permissions in ``rest_framework.viewsets.ViewSet``, deriving the permission type from the particular action to be performed..  As with ``rules.contrib.views.AutoPermissionRequiredMixin``, this only works when model permissions are registered using ``rules.contrib.models.RulesModelMixin``.
+     * @param {Object} opts Optional parameters
+     * @param {String} opts.consumer 
+     * @param {Date} opts.createdAt 
+     * @param {module:model/String} opts.eacType Required. Select from available choices.
+     * @param {String} opts.id 
+     * @param {Number} opts.limit Number of results to return per page.
+     * @param {String} opts.name 
+     * @param {Number} opts.offset The initial index from which to return the results.
+     * @param {Array.<module:model/String>} opts.orderBy Ordering
+     * @param {String} opts.owner 
+     * @param {String} opts.producer 
+     * @param {module:model/String} opts.status Status is set to `started` or `finished` if the file has been processed. Default `unstarted`.
+     * @param {module:api/LogsApi~logsCertificatesListCallback} callback The callback function, accepting three arguments: error, data, response
+     * data is of type: {@link module:model/PaginatedCertificatesList}
+     */
+
+  }, {
+    key: "logsCertificatesList",
+    value: function logsCertificatesList(opts, callback) {
+      opts = opts || {};
+      var postBody = null;
+      var pathParams = {};
+      var queryParams = {
+        'consumer': opts['consumer'],
+        'created_at': opts['createdAt'],
+        'eac_type': opts['eacType'],
+        'id': opts['id'],
+        'limit': opts['limit'],
+        'name': opts['name'],
+        'offset': opts['offset'],
+        'order_by': this.apiClient.buildCollectionParam(opts['orderBy'], 'csv'),
+        'owner': opts['owner'],
+        'producer': opts['producer'],
+        'status': opts['status']
+      };
+      var headerParams = {};
+      var formParams = {};
+      var authNames = ['basicAuth', 'jwtAuth', 'tokenAuth'];
+      var contentTypes = [];
+      var accepts = ['application/json'];
+      var returnType = _PaginatedCertificatesList["default"];
+      return this.apiClient.callApi('/logs/certificates/', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+    /**
+     * Callback function to receive the result of the logsCertificatesRetrieve operation.
+     * @callback module:api/LogsApi~logsCertificatesRetrieveCallback
+     * @param {String} error Error message, if any.
+     * @param {module:model/Certificates} data The data returned by the service call.
+     * @param {String} response The complete HTTP response.
+     */
+
+    /**
+     * Enforces object-level permissions in ``rest_framework.viewsets.ViewSet``, deriving the permission type from the particular action to be performed..  As with ``rules.contrib.views.AutoPermissionRequiredMixin``, this only works when model permissions are registered using ``rules.contrib.models.RulesModelMixin``.
+     * @param {String} id A UUID string identifying this certificates file.
+     * @param {module:api/LogsApi~logsCertificatesRetrieveCallback} callback The callback function, accepting three arguments: error, data, response
+     * data is of type: {@link module:model/Certificates}
+     */
+
+  }, {
+    key: "logsCertificatesRetrieve",
+    value: function logsCertificatesRetrieve(id, callback) {
+      var postBody = null; // verify the required parameter 'id' is set
+
+      if (id === undefined || id === null) {
+        throw new Error("Missing the required parameter 'id' when calling logsCertificatesRetrieve");
+      }
+
+      var pathParams = {
+        'id': id
+      };
+      var queryParams = {};
+      var headerParams = {};
+      var formParams = {};
+      var authNames = ['basicAuth', 'jwtAuth', 'tokenAuth'];
+      var contentTypes = [];
+      var accepts = ['application/json'];
+      var returnType = _Certificates["default"];
+      return this.apiClient.callApi('/logs/certificates/{id}/', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+    /**
+     * Callback function to receive the result of the logsProductionEpiasDestroy operation.
+     * @callback module:api/LogsApi~logsProductionEpiasDestroyCallback
+     * @param {String} error Error message, if any.
+     * @param data This operation does not return a value.
+     * @param {String} response The complete HTTP response.
+     */
+
+    /**
+     * Enforces object-level permissions in ``rest_framework.viewsets.ViewSet``, deriving the permission type from the particular action to be performed..  As with ``rules.contrib.views.AutoPermissionRequiredMixin``, this only works when model permissions are registered using ``rules.contrib.models.RulesModelMixin``.
+     * @param {String} id A UUID string identifying this production data from epias request.
+     * @param {module:api/LogsApi~logsProductionEpiasDestroyCallback} callback The callback function, accepting three arguments: error, data, response
+     */
+
+  }, {
     key: "logsProductionEpiasDestroy",
     value: function logsProductionEpiasDestroy(id, callback) {
       var postBody = null; // verify the required parameter 'id' is set

package/dist/api/MaintenanceCheckApi.js

@@ -18,7 +18,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * MaintenanceCheck service.
 * @module api/MaintenanceCheckApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var MaintenanceCheckApi = /*#__PURE__*/function () {
   /**

package/dist/api/OrganizationprofilesApi.js

@@ -24,7 +24,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * Organizationprofiles service.
 * @module api/OrganizationprofilesApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var OrganizationprofilesApi = /*#__PURE__*/function () {
   /**
@@ -120,8 +120,16 @@ var OrganizationprofilesApi = /*#__PURE__*/function () {
     /**
      * **List all consumer energy source preferences related to the user's organization.**  User should be *authenticated* and have an *active* (is_active=True) account.  **Roles required**: Staff and/or Admin  **User employed by an active allowed organization**: Consumer or Retailer
      * @param {Object} opts Optional parameters
+     * @param {String} opts.consumer 
+     * @param {Date} opts.createdAt 
+     * @param {module:model/String} opts.energySource 
+     * @param {String} opts.id 
      * @param {Number} opts.limit Number of results to return per page.
      * @param {Number} opts.offset The initial index from which to return the results.
+     * @param {String} opts.owner 
+     * @param {module:model/Number} opts.priority Highest priority is 1. Default is 1.
+     * @param {String} opts.retailer 
+     * @param {Date} opts.updatedAt 
      * @param {module:api/OrganizationprofilesApi~organizationprofilesEnergySourcePreferenceListCallback} callback The callback function, accepting three arguments: error, data, response
      * data is of type: {@link module:model/PaginatedEnergySourcePreferenceList}
      */
@@ -133,8 +141,16 @@ var OrganizationprofilesApi = /*#__PURE__*/function () {
       var postBody = null;
       var pathParams = {};
       var queryParams = {
+        'consumer': opts['consumer'],
+        'created_at': opts['createdAt'],
+        'energy_source': opts['energySource'],
+        'id': opts['id'],
         'limit': opts['limit'],
-        'offset': opts['offset']
+        'offset': opts['offset'],
+        'owner': opts['owner'],
+        'priority': opts['priority'],
+        'retailer': opts['retailer'],
+        'updated_at': opts['updatedAt']
       };
       var headerParams = {};
       var formParams = {};

package/dist/api/OrganizationsApi.js

@@ -48,7 +48,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * Organizations service.
 * @module api/OrganizationsApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var OrganizationsApi = /*#__PURE__*/function () {
   /**

package/dist/api/SchemaApi.js

@@ -18,7 +18,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * Schema service.
 * @module api/SchemaApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var SchemaApi = /*#__PURE__*/function () {
   /**

package/dist/api/SentryDebugApi.js

@@ -18,7 +18,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * SentryDebug service.
 * @module api/SentryDebugApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var SentryDebugApi = /*#__PURE__*/function () {
   /**

package/dist/api/UsersApi.js

@@ -34,7 +34,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
 * Users service.
 * @module api/UsersApi
-* @version 1.1.2
+* @version 1.2.0
 */
 var UsersApi = /*#__PURE__*/function () {
   /**

package/dist/index.js

@@ -21,6 +21,12 @@ Object.defineProperty(exports, "BlockchainTransaction", {
     return _BlockchainTransaction["default"];
   }
 });
+Object.defineProperty(exports, "Certificates", {
+  enumerable: true,
+  get: function get() {
+    return _Certificates["default"];
+  }
+});
 Object.defineProperty(exports, "Consumer", {
   enumerable: true,
   get: function get() {
@@ -105,6 +111,12 @@ Object.defineProperty(exports, "ContentTypeEnum", {
     return _ContentTypeEnum["default"];
   }
 });
+Object.defineProperty(exports, "EacTypeEnum", {
+  enumerable: true,
+  get: function get() {
+    return _EacTypeEnum["default"];
+  }
+});
 Object.defineProperty(exports, "EmissionFactor", {
   enumerable: true,
   get: function get() {
@@ -243,6 +255,12 @@ Object.defineProperty(exports, "OrganizationsApi", {
     return _OrganizationsApi["default"];
   }
 });
+Object.defineProperty(exports, "PaginatedCertificatesList", {
+  enumerable: true,
+  get: function get() {
+    return _PaginatedCertificatesList["default"];
+  }
+});
 Object.defineProperty(exports, "PaginatedConsumerList", {
   enumerable: true,
   get: function get() {
@@ -596,6 +614,8 @@ var _ApiClient = _interopRequireDefault(require("./ApiClient"));
 
 var _BlockchainTransaction = _interopRequireDefault(require("./model/BlockchainTransaction"));
 
+var _Certificates = _interopRequireDefault(require("./model/Certificates"));
+
 var _Consumer = _interopRequireDefault(require("./model/Consumer"));
 
 var _ConsumptionDataFileList = _interopRequireDefault(require("./model/ConsumptionDataFileList"));
@@ -624,6 +644,8 @@ var _ConsumptionSiteMany = _interopRequireDefault(require("./model/ConsumptionSi
 
 var _ContentTypeEnum = _interopRequireDefault(require("./model/ContentTypeEnum"));
 
+var _EacTypeEnum = _interopRequireDefault(require("./model/EacTypeEnum"));
+
 var _EmissionFactor = _interopRequireDefault(require("./model/EmissionFactor"));
 
 var _EnergySourceEnum = _interopRequireDefault(require("./model/EnergySourceEnum"));
@@ -652,6 +674,8 @@ var _MatchingSiteRequest = _interopRequireDefault(require("./model/MatchingSiteR
 
 var _OrganizationTypeEnum = _interopRequireDefault(require("./model/OrganizationTypeEnum"));
 
+var _PaginatedCertificatesList = _interopRequireDefault(require("./model/PaginatedCertificatesList"));
+
 var _PaginatedConsumerList = _interopRequireDefault(require("./model/PaginatedConsumerList"));
 
 var _PaginatedConsumptionDataPointListOrDetailList = _interopRequireDefault(require("./model/PaginatedConsumptionDataPointListOrDetailList"));

package/dist/model/BlockchainTransaction.js

@@ -22,7 +22,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
  * The BlockchainTransaction model module.
  * @module model/BlockchainTransaction
- * @version 1.1.2
+ * @version 1.2.0
  */
 var BlockchainTransaction = /*#__PURE__*/function () {
   /**