fiftyone.pipeline.cloudrequestengine 4.4.91 → 4.4.93

package/cloudRequestEngine.js

@@ -1,23 +1,23 @@
-/* *********************************************************************
- * This Original Work is copyright of 51 Degrees Mobile Experts Limited.
- * Copyright 2023 51 Degrees Mobile Experts Limited, Davidson House,
- * Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
- *
- * This Original Work is licensed under the European Union Public Licence
- * (EUPL) v.1.2 and is subject to its terms as set out below.
- *
- * If a copy of the EUPL was not distributed with this file, You can obtain
- * one at https://opensource.org/licenses/EUPL-1.2.
- *
- * The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
- * amended by the European Commission) shall be deemed incompatible for
- * the purposes of the Work and the provisions of the compatibility
- * clause in Article 5 of the EUPL shall not apply.
- *
- * If using the Work as, or as part of, a network application, by
- * including the attribution notice(s) required under Article 5 of the EUPL
- * in the end user terms of the application under an appropriate heading,
- * such notice(s) shall fulfill the requirements of that article.
+/* *********************************************************************
+ * This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+ * Copyright 2023 51 Degrees Mobile Experts Limited, Davidson House,
+ * Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+ *
+ * This Original Work is licensed under the European Union Public Licence
+ * (EUPL) v.1.2 and is subject to its terms as set out below.
+ *
+ * If a copy of the EUPL was not distributed with this file, You can obtain
+ * one at https://opensource.org/licenses/EUPL-1.2.
+ *
+ * The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+ * amended by the European Commission) shall be deemed incompatible for
+ * the purposes of the Work and the provisions of the compatibility
+ * clause in Article 5 of the EUPL shall not apply.
+ *
+ * If using the Work as, or as part of, a network application, by
+ * including the attribution notice(s) required under Article 5 of the EUPL
+ * in the end user terms of the application under an appropriate heading,
+ * such notice(s) shall fulfill the requirements of that article.
  * ********************************************************************* */
 
 const util = require('util');
@@ -52,7 +52,7 @@ class CloudRequestEngine extends Engine {
    * made from a origin matching those allowed by the resource key.
    * For more detail, see the 'Request Headers' section in the
    * <a href="https://cloud.51degrees.com/api-docs/index.html">cloud documentation</a>.
-   * @param options.requestClient
+   * @param {RequestClient} options.requestClient Set predefined RequestClient.
    */
   constructor (
     {
@@ -176,8 +176,7 @@ class CloudRequestEngine extends Engine {
    * However, transport level errors or other failures can result in
    * responses that are plain text. This function handles these cases.
    *
-   * @param {string} response the response data to process
-   * @param responseBody
+   * @param {string} responseBody the response data to process
    * @returns {Array} The error messages
    */
   getErrorMessages (responseBody) {
@@ -196,7 +195,8 @@ class CloudRequestEngine extends Engine {
   /**
    * Used to handle errors from http requests
    *
-   * @param response
+   * @param {http.ServerResponse} response Responce to get errors from
+   * @returns {Array<CloudRequestError>} Array of CloudRequestError from response
    */
   getErrorsFromResponse (response) {
     let content = response;
@@ -370,7 +370,7 @@ class CloudRequestEngine extends Engine {
    * If there are evidence keys other than 'query.' that conflict then
    * this is unexpected so a warning will be logged.
    *
-   * @param {FlowData} flowData
+   * @param {FlowData} flowData FlowData to get evidence from
    * @returns {Evidence} Evidence Dictionary
    */
   getContent (flowData) {
@@ -393,7 +393,7 @@ class CloudRequestEngine extends Engine {
   /**
    * Add query data to the evidence.
    *
-   * @param flowData
+   * @param {FlowData} flowData FlowData for logging
    * @param {object} queryData The destination dictionary to add query data to.
    * @param {Evidence} allEvidence All evidence in the flow data. This is used to
    * report which evidence keys are conflicting.
@@ -449,6 +449,7 @@ class CloudRequestEngine extends Engine {
    *
    * @param {Evidence} evidence All evidence in the flow data.
    * @param {stirng} type Required evidence key prefix
+   * @returns {Evidence} Selected evidence
    */
   getSelectedEvidence (evidence, type) {
     let selectedEvidence = {};
@@ -483,7 +484,7 @@ class CloudRequestEngine extends Engine {
    *
    * @param {string} itemKey Key to check
    * @param {string} prefix The prefix to check for.
-   * @returns True if the key has the prefix.
+   * @returns {boolean} True if the key has the prefix.
    */
   hasKeyPrefix (itemKey, prefix) {
     return itemKey.startsWith(prefix + '.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fiftyone.pipeline.cloudrequestengine",
-  "version": "4.4.91",
+  "version": "4.4.93",
   "description": "Cloud request engine for the 51Degrees Pipeline API",
   "keywords": [
     "51degrees",

package/requestClient.js

@@ -28,7 +28,7 @@ class RequestClient {
    * @param {*} data The data to send in the body of the request
    * @param {*} origin The value to use for the Origin header when
    * making the request
-   * @returns a Promise. The resolve function will be passed the content
+   * @returns {Promise} The resolve function will be passed the content
    * from the response and the reject function will be passed
    * an object with 3 properties:
    * headers = HTTP headers in the response
@@ -43,9 +43,8 @@ class RequestClient {
     } else {
       httpModule = require('http');
     }
-
+    let requestData = '';
     if (data) {
-      var requestData = '';
       const keys = Object.keys(data);
       for (let i = 0; i < keys.length; i++) {
         requestData += encodeURIComponent(keys[i]) + '=' + encodeURIComponent(data[keys[i]]);
@@ -104,7 +103,7 @@ class RequestClient {
    * @param {*} url The url to send a request to
    * @param {*} origin The value to use for the Origin header when
    * making the request
-   * @returns a Promise. The resolve function will be passed the content
+   * @returns {Promise} The resolve function will be passed the content
    * from the response and the reject function will be passed
    * an object with 3 properties:
    * headers = HTTP headers in the response

package/tests/cloudResponse.test.js

@@ -215,9 +215,10 @@ test('validate case when cloud unavailable', (done) => {
 });
 
 /**
+ *  Check if Properties contains name
  *
- * @param properties
- * @param name
+ * @param {object} properties Object of properties
+ * @param {string} name Name of the property
  */
 function propertiesContainName (properties, name) {
   expect(properties[name.toLowerCase()]).not.toBeUndefined();