fiftyone.devicedetection.onpremise 4.4.135 → 4.4.137

package/dataFileMissingPropertyService.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 MissingPropertyService = require('fiftyone.pipeline.engines').MissingPropertyService;
@@ -42,7 +42,7 @@ class DeviceDetectionMissingPropertyService extends MissingPropertyService {
    *
    * @param {string} key missing property key
    * @param {FlowElement} flowElement the FlowElement the key was missing from
-   * @returns {void}
+   * @returns {never} throws an error
    */
   check (key, flowElement) {
     if (flowElement.properties[key]) {

package/deviceDetectionOnPremisePipelineBuilder.js

@@ -40,7 +40,7 @@ class DeviceDetectionOnPremisePipelineBuilder extends PipelineBuilder {
    * simple paramater changes
    *
    * @param {object} options the options for the pipeline builder
-   * @param {string} options.licenceKeys license key(s) used by the
+   * @param {string} [options.licenceKeys] license key(s) used by the
    * data file update service. A key can be obtained from the
    * 51Degrees website: https://51degrees.com/pricing.
    * This parameter MUST be set when using a data file.
@@ -48,57 +48,57 @@ class DeviceDetectionOnPremisePipelineBuilder extends PipelineBuilder {
    * an empty string, but this will cause automatic updates
    * to be disabled.
    * @param {string} options.dataFile dataFile path for the on premise engine
-   * @param {boolean} options.dataUpdateVerifyMd5 whether to check MD5 of datafile
-   * @param {boolean} options.dataUpdateUseUrlFormatter whether to append default URL params for Data File download
-   * @param {boolean} options.autoUpdate whether to autoUpdate the dataFile
-   * @param {string} options.dataUpdateUrl base url for the datafile
-   * @param {number} options.pollingInterval How often to poll for
+   * @param {boolean} [options.dataUpdateVerifyMd5] whether to check MD5 of datafile
+   * @param {boolean} [options.dataUpdateUseUrlFormatter] whether to append default URL params for Data File download
+   * @param {boolean} [options.autoUpdate] whether to autoUpdate the dataFile
+   * @param {string} [options.dataUpdateUrl] base url for the datafile
+   * @param {number} [options.pollingInterval] How often to poll for
    * updates to the datafile (minutes)
-   * @param {number} options.updateTimeMaximumRandomisation
+   * @param {number} [options.updateTimeMaximumRandomisation]
    * Maximum randomisation offset in seconds to polling time interval
-   * @param {boolean} options.shareUsage whether to include the share
+   * @param {boolean} [options.shareUsage] whether to include the share
    * usage element
-   * @param {boolean} options.fileSystemWatcher whether to monitor the datafile
+   * @param {boolean} [options.fileSystemWatcher] whether to monitor the datafile
    * path for changes
-   * @param {boolean} options.updateOnStart whether to download / update a
+   * @param {boolean} [options.updateOnStart] whether to download / update a
    * dataFile to the path specified in options.dataFile on start
-   * @param {number} options.cacheSize size of the default cache
+   * @param {number} [options.cacheSize] size of the default cache
    * (includes cache if set). NOTE: This is not supported for on-premise
    * engine.
-   * @param {Array<string>} options.restrictedProperties list of properties the engine
+   * @param {Array<string>} [options.restrictedProperties] list of properties the engine
    * will be restricted to
-   * @param {string} options.performanceProfile used to control the tradeoff
+   * @param {string} [options.performanceProfile] used to control the tradeoff
    * between performance and system memory usage (Only applies to on-premise,
    * not cloud) options are: LowMemory, MaxPerformance, Balanced,
    * BalancedTemp, HighPerformance
-   * @param {number} options.concurrency defaults to the number of cpus
+   * @param {number} [options.concurrency] defaults to the number of cpus
    * in the machine
-   * @param {boolean} options.updateMatchedUserAgent True if the detection
+   * @param {boolean} [options.updateMatchedUserAgent] True if the detection
    * should record the matched characters from the target User-Agent
-   * @param {number} options.maxMatchedUserAgentLength Number of characters to
+   * @param {number} [options.maxMatchedUserAgentLength] Number of characters to
    * consider in the matched User-Agent. Ignored if updateMatchedUserAgent is
    * false
-   * @param {number} options.drift Set maximum drift in hash position to allow
+   * @param {number} [options.drift] Set maximum drift in hash position to allow
    * when processing HTTP headers.
-   * @param {number} options.difference Set the maximum difference to allow
+   * @param {number} [options.difference] Set the maximum difference to allow
    * when processing HTTP headers. The difference is the difference in hash
    * value between the hash that was found, and the hash that is being searched
    * for. By default this is 0.
-   * @param {string} options.allowUnmatched If set to false, a non-matching
+   * @param {string} [options.allowUnmatched] If set to false, a non-matching
    * User-Agent will result in properties without set values.
    * If set to true, a non-matching User-Agent will cause the 'default profiles'
    * to be returned.
    * This means that properties will always have values
    * (i.e. no need to check .HasValue) but some may be inaccurate.
    * By default, this is false.
-   * @param {boolean} options.createTempDataCopy If true, the engine will
+   * @param {boolean} [options.createTempDataCopy] If true, the engine will
    * create a copy of the data file in a temporary location
    * rather than using the file provided directly. If not
    * loading all data into memory, this is required for
    * automatic data updates to occur.
-   * @param {string} options.tempDataDir The directory to use for the
+   * @param {string} [options.tempDataDir] The directory to use for the
    * temporary data copy if 'createTempDataCopy' is set to true.
-   * @param {DataFileUpdateService} options.dataFileUpdateService Set
+   * @param {DataFileUpdateService} [options.dataFileUpdateService] Set
    * DataFileUpdateService so the datafiles can receive
    * automatic updates
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fiftyone.devicedetection.onpremise",
-  "version": "4.4.135",
+  "version": "4.4.137",
   "description": "Device detection on-premise services for the 51Degrees Pipeline API",
   "keywords": [
     "51degrees",
@@ -21,6 +21,7 @@
     "DeviceAtlas"
   ],
   "main": "index.js",
+  "types": "types/index.d.ts",
   "directories": {
     "test": "tests"
   },
@@ -31,14 +32,7 @@
     "type": "git",
     "url": "https://github.com/51Degrees/device-detection-node"
   },
-  "author": "51Degrees",
-  "contributors": [
-    "Filip Hnízdo <filip@octophin.com> (https://octophindigital.com/)",
-    "Steve Ballantine <stephen@51degrees.com> (https://51degrees.com)",
-    "Ben Shilito <ben@51degrees.com> (https://51degrees.com)",
-    "Joseph Dix <joseph@51degrees.com> (https://51degrees.com)",
-    "Tung Pham <tung@51degrees.com> (https://51degrees.com)"
-  ],
+  "author": "51Degrees Engineering <engineering@51degrees.com>",
   "dependencies": {
     "fiftyone.devicedetection.shared": "4.4.x",
     "fiftyone.pipeline.core": "4.4.x",
@@ -48,7 +42,8 @@
     "n-readlines": "^1.0.1"
   },
   "devDependencies": {
-    "@types/node": "^15.14.9",
+    "@types/jest": "^28.1.8",
+    "@types/node": "^20.14.10",
     "jest": "^28.1.3",
     "jest-junit": "^13.2.0"
   },
@@ -58,6 +53,7 @@
   },
   "files": [
     "build",
-    "*.js"
+    "*.js",
+    "*.ts"
   ]
 }