files.com 1.2.40 → 1.2.42

package/_VERSION

@@ -1 +1 @@
-1.2.40
+1.2.42

package/docs/models/As2Partner.md

@@ -26,7 +26,7 @@
 * `name` (string): The partner's formal AS2 name.
 * `uri` (string): Public URI for sending AS2 message to.
 * `server_certificate` (string): Remote server certificate security setting
-* `mdn_validation_level` (string): MDN Validation Level
+* `mdn_validation_level` (string): MDN Validation Level controls how to evaluate message transfer success based on a partner's MDN response. NOTE: This setting does not affect MDN storage; all MDNs received from a partner are always stored. `none`: MDN is stored for informational purposes only, a successful HTTPS transfer is a successful AS2 transfer. `weak`: Inspect the MDN for MIC and Disposition only. `normal`: `weak` plus validate MDN signature matches body, `strict`: `normal` but do not allow signatures from self-signed or incorrectly purposed certificates.
 * `enable_dedicated_ips` (boolean): `true` if remote server only accepts connections from dedicated IPs
 * `hex_public_certificate_serial` (string): Serial of public certificate used for message security in hex format.
 * `public_certificate_md5` (string): MD5 hash of public certificate used for message security.

package/docs/models/Bundle.md

@@ -76,7 +76,8 @@
   "has_inbox": true,
   "paths": [
     "file.txt"
-  ]
+  ],
+  "bundlepaths": "example"
 }
 ```
 
@@ -118,6 +119,7 @@
 * `watermark_value` (object): Preview watermark settings applied to all bundle items. Uses the same keys as Behavior.value
 * `has_inbox` (boolean): Does this bundle have an associated inbox?
 * `paths` (array): A list of paths in this bundle.  For performance reasons, this is not provided when listing bundles.
+* `bundlepaths` (BundlePath): A list of bundlepaths in this bundle.  For performance reasons, this is not provided when listing bundles.
 * `password` (string): Password for this bundle.
 * `form_field_set_id` (int64): Id of Form Field Set to use with this bundle
 * `create_snapshot` (boolean): If true, create a snapshot of this bundle's contents.
@@ -392,7 +394,8 @@ await bundle.update({
   "has_inbox": true,
   "paths": [
     "file.txt"
-  ]
+  ],
+  "bundlepaths": "example"
 }
 ```
 

package/docs/models/BundlePath.md

@@ -0,0 +1,13 @@
+# BundlePath
+
+## Example BundlePath Object
+
+```
+{
+  "recursive": true,
+  "path": "example"
+}
+```
+
+* `recursive` (boolean): Allow access to subfolders content?
+* `path` (string): The path to the resource relative to filesystem. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.

package/docs/models/Site.md

@@ -169,6 +169,7 @@
   "sftp_host_key_type": "default",
   "active_sftp_host_key_id": 1,
   "sftp_insecure_ciphers": true,
+  "sftp_insecure_diffie_hellman": true,
   "sftp_user_root_enabled": true,
   "sharing_enabled": true,
   "show_request_access_link": true,
@@ -391,7 +392,8 @@
 * `sftp_enabled` (boolean): Is SFTP enabled?
 * `sftp_host_key_type` (string): Sftp Host Key Type
 * `active_sftp_host_key_id` (int64): Id of the currently selected custom SFTP Host Key
-* `sftp_insecure_ciphers` (boolean): Are Insecure Ciphers allowed for SFTP?  Note:  Setting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
+* `sftp_insecure_ciphers` (boolean): If true, we will allow weak and known insecure ciphers to be used for SFTP connections.  Enabling this setting severly weakens the security of your site and it is not recommend, except as a last resort for compatibility.
+* `sftp_insecure_diffie_hellman` (boolean): If true, we will allow weak Diffie Hellman parameters to be used within ciphers for SFTP that are otherwise on our secure list.  This has the effect of making the cipher weaker than our normal threshold for security, but is required to support certain legacy or broken SSH and MFT clients.  Enabling this weakens security, but not nearly as much as enabling the full `sftp_insecure_ciphers` option.
 * `sftp_user_root_enabled` (boolean): Use user FTP roots also for SFTP?
 * `sharing_enabled` (boolean): Allow bundle creation
 * `show_request_access_link` (boolean): Show request access link for users without access?  Currently unused.
@@ -407,7 +409,7 @@
 * `ssl_required` (boolean): Is SSL required?  Disabling this is insecure.
 * `subdomain` (string): Site subdomain
 * `switch_to_plan_date` (date-time): If switching plans, when does the new plan take effect?
-* `tls_disabled` (boolean): Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
+* `tls_disabled` (boolean): DO NOT ENABLE. This setting allows TLSv1.0 and TLSv1.1 to be used on your site.  We intend to remove this capability entirely in early 2024.  If set, the `sftp_insecure_ciphers` flag will be automatically set to true.
 * `trial_days_left` (int64): Number of days left in trial
 * `trial_until` (date-time): When does this Site trial expire?
 * `use_provided_modified_at` (boolean): Allow uploaders to set `provided_modified_at` for uploaded files?
@@ -489,6 +491,7 @@ await Site.update({
   'ssl_required': true,
   'tls_disabled': true,
   'sftp_insecure_ciphers': true,
+  'sftp_insecure_diffie_hellman': true,
   'disable_files_certificate_generation': true,
   'user_lockout': true,
   'user_lockout_tries': 1,
@@ -633,8 +636,9 @@ await Site.update({
 * `left_navigation_visibility` (object): Visibility settings for account navigation
 * `session_expiry` (double): Session expiry in hours
 * `ssl_required` (boolean): Is SSL required?  Disabling this is insecure.
-* `tls_disabled` (boolean): Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
-* `sftp_insecure_ciphers` (boolean): Are Insecure Ciphers allowed for SFTP?  Note:  Setting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
+* `tls_disabled` (boolean): DO NOT ENABLE. This setting allows TLSv1.0 and TLSv1.1 to be used on your site.  We intend to remove this capability entirely in early 2024.  If set, the `sftp_insecure_ciphers` flag will be automatically set to true.
+* `sftp_insecure_ciphers` (boolean): If true, we will allow weak and known insecure ciphers to be used for SFTP connections.  Enabling this setting severly weakens the security of your site and it is not recommend, except as a last resort for compatibility.
+* `sftp_insecure_diffie_hellman` (boolean): If true, we will allow weak Diffie Hellman parameters to be used within ciphers for SFTP that are otherwise on our secure list.  This has the effect of making the cipher weaker than our normal threshold for security, but is required to support certain legacy or broken SSH and MFT clients.  Enabling this weakens security, but not nearly as much as enabling the full `sftp_insecure_ciphers` option.
 * `disable_files_certificate_generation` (boolean): If set, Files.com will not set the CAA records required to generate future SSL certificates for this domain.
 * `user_lockout` (boolean): Will users be locked out after incorrect login attempts?
 * `user_lockout_tries` (int64): Number of login tries within `user_lockout_within` hours before users are locked out

package/lib/Files.js

@@ -11,7 +11,7 @@ var endpointPrefix = '/api/rest/v1';
 var apiKey;
 var baseUrl = 'https://app.files.com';
 var sessionId = null;
-var version = '1.2.40';
+var version = '1.2.42';
 var userAgent = "Files.com JavaScript SDK v".concat(version);
 var logLevel = _Logger.LogLevel.INFO;
 var debugRequest = false;

package/lib/models/As2Partner.js

@@ -68,7 +68,7 @@ var As2Partner = /*#__PURE__*/(0, _createClass2.default)(function As2Partner() {
   (0, _defineProperty2.default)(this, "setServerCertificate", function (value) {
     _this.attributes.server_certificate = value;
   });
-  // string # MDN Validation Level
+  // string # MDN Validation Level controls how to evaluate message transfer success based on a partner's MDN response. NOTE: This setting does not affect MDN storage; all MDNs received from a partner are always stored. `none`: MDN is stored for informational purposes only, a successful HTTPS transfer is a successful AS2 transfer. `weak`: Inspect the MDN for MIC and Disposition only. `normal`: `weak` plus validate MDN signature matches body, `strict`: `normal` but do not allow signatures from self-signed or incorrectly purposed certificates.
   (0, _defineProperty2.default)(this, "getMdnValidationLevel", function () {
     return _this.attributes.mdn_validation_level;
   });

package/lib/models/Bundle.js

@@ -296,6 +296,13 @@ var Bundle = /*#__PURE__*/(0, _createClass2.default)(function Bundle() {
   (0, _defineProperty2.default)(this, "setPaths", function (value) {
     _this.attributes.paths = value;
   });
+  // BundlePath # A list of bundlepaths in this bundle.  For performance reasons, this is not provided when listing bundles.
+  (0, _defineProperty2.default)(this, "getBundlepaths", function () {
+    return _this.attributes.bundlepaths;
+  });
+  (0, _defineProperty2.default)(this, "setBundlepaths", function (value) {
+    _this.attributes.bundlepaths = value;
+  });
   // string # Password for this bundle.
   (0, _defineProperty2.default)(this, "getPassword", function () {
     return _this.attributes.password;

package/lib/models/BundlePath.js

@@ -0,0 +1,55 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+exports.__esModule = true;
+exports.default = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _Api = _interopRequireDefault(require("../Api"));
+var errors = _interopRequireWildcard(require("../Errors"));
+var _utils = require("../utils");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /* eslint-disable no-unused-vars */
+/* eslint-enable no-unused-vars */
+/**
+ * Class BundlePath
+ */
+var BundlePath = /*#__PURE__*/(0, _createClass2.default)(function BundlePath() {
+  var _this = this;
+  var attributes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  (0, _classCallCheck2.default)(this, BundlePath);
+  (0, _defineProperty2.default)(this, "attributes", {});
+  (0, _defineProperty2.default)(this, "options", {});
+  (0, _defineProperty2.default)(this, "isLoaded", function () {
+    return !!_this.attributes.id;
+  });
+  // boolean # Allow access to subfolders content?
+  (0, _defineProperty2.default)(this, "getRecursive", function () {
+    return _this.attributes.recursive;
+  });
+  // string # The path to the resource relative to filesystem. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+  (0, _defineProperty2.default)(this, "getPath", function () {
+    return _this.attributes.path;
+  });
+  Object.entries(attributes).forEach(function (_ref) {
+    var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
+      key = _ref2[0],
+      value = _ref2[1];
+    var normalizedKey = key.replace('?', '');
+    _this.attributes[normalizedKey] = value;
+    Object.defineProperty(_this, normalizedKey, {
+      value: value,
+      writable: false
+    });
+  });
+  this.options = _objectSpread({}, options);
+});
+var _default = exports.default = BundlePath;
+module.exports = BundlePath;
+module.exports.default = BundlePath;

package/lib/models/Site.js

@@ -505,10 +505,14 @@ var Site = /*#__PURE__*/(0, _createClass2.default)(function Site() {
   (0, _defineProperty2.default)(this, "getActiveSftpHostKeyId", function () {
     return _this.attributes.active_sftp_host_key_id;
   });
-  // boolean # Are Insecure Ciphers allowed for SFTP?  Note:  Setting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
+  // boolean # If true, we will allow weak and known insecure ciphers to be used for SFTP connections.  Enabling this setting severly weakens the security of your site and it is not recommend, except as a last resort for compatibility.
   (0, _defineProperty2.default)(this, "getSftpInsecureCiphers", function () {
     return _this.attributes.sftp_insecure_ciphers;
   });
+  // boolean # If true, we will allow weak Diffie Hellman parameters to be used within ciphers for SFTP that are otherwise on our secure list.  This has the effect of making the cipher weaker than our normal threshold for security, but is required to support certain legacy or broken SSH and MFT clients.  Enabling this weakens security, but not nearly as much as enabling the full `sftp_insecure_ciphers` option.
+  (0, _defineProperty2.default)(this, "getSftpInsecureDiffieHellman", function () {
+    return _this.attributes.sftp_insecure_diffie_hellman;
+  });
   // boolean # Use user FTP roots also for SFTP?
   (0, _defineProperty2.default)(this, "getSftpUserRootEnabled", function () {
     return _this.attributes.sftp_user_root_enabled;
@@ -569,7 +573,7 @@ var Site = /*#__PURE__*/(0, _createClass2.default)(function Site() {
   (0, _defineProperty2.default)(this, "getSwitchToPlanDate", function () {
     return _this.attributes.switch_to_plan_date;
   });
-  // boolean # Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
+  // boolean # DO NOT ENABLE. This setting allows TLSv1.0 and TLSv1.1 to be used on your site.  We intend to remove this capability entirely in early 2024.  If set, the `sftp_insecure_ciphers` flag will be automatically set to true.
   (0, _defineProperty2.default)(this, "getTlsDisabled", function () {
     return _this.attributes.tls_disabled;
   });
@@ -743,8 +747,9 @@ _Site = Site;
 //   left_navigation_visibility - object - Visibility settings for account navigation
 //   session_expiry - double - Session expiry in hours
 //   ssl_required - boolean - Is SSL required?  Disabling this is insecure.
-//   tls_disabled - boolean - Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
-//   sftp_insecure_ciphers - boolean - Are Insecure Ciphers allowed for SFTP?  Note:  Setting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
+//   tls_disabled - boolean - DO NOT ENABLE. This setting allows TLSv1.0 and TLSv1.1 to be used on your site.  We intend to remove this capability entirely in early 2024.  If set, the `sftp_insecure_ciphers` flag will be automatically set to true.
+//   sftp_insecure_ciphers - boolean - If true, we will allow weak and known insecure ciphers to be used for SFTP connections.  Enabling this setting severly weakens the security of your site and it is not recommend, except as a last resort for compatibility.
+//   sftp_insecure_diffie_hellman - boolean - If true, we will allow weak Diffie Hellman parameters to be used within ciphers for SFTP that are otherwise on our secure list.  This has the effect of making the cipher weaker than our normal threshold for security, but is required to support certain legacy or broken SSH and MFT clients.  Enabling this weakens security, but not nearly as much as enabling the full `sftp_insecure_ciphers` option.
 //   disable_files_certificate_generation - boolean - If set, Files.com will not set the CAA records required to generate future SSL certificates for this domain.
 //   user_lockout - boolean - Will users be locked out after incorrect login attempts?
 //   user_lockout_tries - int64 - Number of login tries within `user_lockout_within` hours before users are locked out

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "files.com",
-  "version": "1.2.40",
+  "version": "1.2.42",
   "description": "Files.com SDK for JavaScript",
   "keywords": [
     "files.com",

package/src/Files.js

@@ -5,7 +5,7 @@ const endpointPrefix = '/api/rest/v1'
 let apiKey
 let baseUrl = 'https://app.files.com'
 let sessionId = null
-const version = '1.2.40'
+const version = '1.2.42'
 let userAgent = `Files.com JavaScript SDK v${version}`
 
 let logLevel = LogLevel.INFO

package/src/models/As2Partner.js

@@ -63,7 +63,7 @@ class As2Partner {
     this.attributes.server_certificate = value
   }
 
-  // string # MDN Validation Level
+  // string # MDN Validation Level controls how to evaluate message transfer success based on a partner's MDN response. NOTE: This setting does not affect MDN storage; all MDNs received from a partner are always stored. `none`: MDN is stored for informational purposes only, a successful HTTPS transfer is a successful AS2 transfer. `weak`: Inspect the MDN for MIC and Disposition only. `normal`: `weak` plus validate MDN signature matches body, `strict`: `normal` but do not allow signatures from self-signed or incorrectly purposed certificates.
   getMdnValidationLevel = () => this.attributes.mdn_validation_level
 
   setMdnValidationLevel = value => {

package/src/models/Bundle.js

@@ -290,6 +290,13 @@ class Bundle {
     this.attributes.paths = value
   }
 
+  // BundlePath # A list of bundlepaths in this bundle.  For performance reasons, this is not provided when listing bundles.
+  getBundlepaths = () => this.attributes.bundlepaths
+
+  setBundlepaths = value => {
+    this.attributes.bundlepaths = value
+  }
+
   // string # Password for this bundle.
   getPassword = () => this.attributes.password
 

package/src/models/BundlePath.js

@@ -0,0 +1,41 @@
+/* eslint-disable no-unused-vars */
+import Api from '../Api'
+import * as errors from '../Errors'
+import {
+  getType, isArray, isInt, isObject, isString,
+} from '../utils'
+/* eslint-enable no-unused-vars */
+
+/**
+ * Class BundlePath
+ */
+class BundlePath {
+  attributes = {}
+
+  options = {}
+
+  constructor(attributes = {}, options = {}) {
+    Object.entries(attributes).forEach(([key, value]) => {
+      const normalizedKey = key.replace('?', '')
+
+      this.attributes[normalizedKey] = value
+
+      Object.defineProperty(this, normalizedKey, { value, writable: false })
+    })
+
+    this.options = { ...options }
+  }
+
+  isLoaded = () => !!this.attributes.id
+
+  // boolean # Allow access to subfolders content?
+  getRecursive = () => this.attributes.recursive
+
+  // string # The path to the resource relative to filesystem. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+  getPath = () => this.attributes.path
+}
+
+export default BundlePath
+
+module.exports = BundlePath
+module.exports.default = BundlePath

package/src/models/Site.js

@@ -382,9 +382,12 @@ class Site {
   // int64 # Id of the currently selected custom SFTP Host Key
   getActiveSftpHostKeyId = () => this.attributes.active_sftp_host_key_id
 
-  // boolean # Are Insecure Ciphers allowed for SFTP?  Note:  Setting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
+  // boolean # If true, we will allow weak and known insecure ciphers to be used for SFTP connections.  Enabling this setting severly weakens the security of your site and it is not recommend, except as a last resort for compatibility.
   getSftpInsecureCiphers = () => this.attributes.sftp_insecure_ciphers
 
+  // boolean # If true, we will allow weak Diffie Hellman parameters to be used within ciphers for SFTP that are otherwise on our secure list.  This has the effect of making the cipher weaker than our normal threshold for security, but is required to support certain legacy or broken SSH and MFT clients.  Enabling this weakens security, but not nearly as much as enabling the full `sftp_insecure_ciphers` option.
+  getSftpInsecureDiffieHellman = () => this.attributes.sftp_insecure_diffie_hellman
+
   // boolean # Use user FTP roots also for SFTP?
   getSftpUserRootEnabled = () => this.attributes.sftp_user_root_enabled
 
@@ -430,7 +433,7 @@ class Site {
   // date-time # If switching plans, when does the new plan take effect?
   getSwitchToPlanDate = () => this.attributes.switch_to_plan_date
 
-  // boolean # Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
+  // boolean # DO NOT ENABLE. This setting allows TLSv1.0 and TLSv1.1 to be used on your site.  We intend to remove this capability entirely in early 2024.  If set, the `sftp_insecure_ciphers` flag will be automatically set to true.
   getTlsDisabled = () => this.attributes.tls_disabled
 
   // int64 # Number of days left in trial
@@ -542,8 +545,9 @@ class Site {
   //   left_navigation_visibility - object - Visibility settings for account navigation
   //   session_expiry - double - Session expiry in hours
   //   ssl_required - boolean - Is SSL required?  Disabling this is insecure.
-  //   tls_disabled - boolean - Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
-  //   sftp_insecure_ciphers - boolean - Are Insecure Ciphers allowed for SFTP?  Note:  Setting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
+  //   tls_disabled - boolean - DO NOT ENABLE. This setting allows TLSv1.0 and TLSv1.1 to be used on your site.  We intend to remove this capability entirely in early 2024.  If set, the `sftp_insecure_ciphers` flag will be automatically set to true.
+  //   sftp_insecure_ciphers - boolean - If true, we will allow weak and known insecure ciphers to be used for SFTP connections.  Enabling this setting severly weakens the security of your site and it is not recommend, except as a last resort for compatibility.
+  //   sftp_insecure_diffie_hellman - boolean - If true, we will allow weak Diffie Hellman parameters to be used within ciphers for SFTP that are otherwise on our secure list.  This has the effect of making the cipher weaker than our normal threshold for security, but is required to support certain legacy or broken SSH and MFT clients.  Enabling this weakens security, but not nearly as much as enabling the full `sftp_insecure_ciphers` option.
   //   disable_files_certificate_generation - boolean - If set, Files.com will not set the CAA records required to generate future SSL certificates for this domain.
   //   user_lockout - boolean - Will users be locked out after incorrect login attempts?
   //   user_lockout_tries - int64 - Number of login tries within `user_lockout_within` hours before users are locked out