files.com 1.2.205 → 1.2.206

package/_VERSION

@@ -1 +1 @@
-1.2.205
+1.2.206

package/docs/models/Permission.md

@@ -11,7 +11,8 @@
   "group_id": 1,
   "group_name": "example",
   "permission": "full",
-  "recursive": true
+  "recursive": true,
+  "site_id": 1
 }
 ```
 
@@ -23,6 +24,7 @@
 * `group_name` (string): Group name (if applicable)
 * `permission` (string): Permission type.  See the table referenced in the documentation for an explanation of each permission.
 * `recursive` (boolean): Recursive: does this permission apply to subfolders?
+* `site_id` (int64): Site ID
 
 ---
 
@@ -42,7 +44,7 @@ await Permission.list({
 
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `group_id`, `path` or `user_id`.
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `site_id`, `group_id`, `path` or `user_id`.
 * `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `path`, `group_id` or `user_id`. Valid field combinations are `[ group_id, path ]`, `[ user_id, path ]` or `[ user_id, group_id ]`.
 * `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `path`.
 * `path` (string): Permission path.  If provided, will scope all permissions(including upward) to this path.
@@ -63,6 +65,7 @@ await Permission.create({
   'user_id': 1,
   'username': "user",
   'group_name': "example",
+  'site_id': 1,
 })
 ```
 
@@ -76,6 +79,7 @@ await Permission.create({
 * `user_id` (int64): User ID.  Provide `username` or `user_id`
 * `username` (string): User username.  Provide `username` or `user_id`
 * `group_name` (string): Group name.  Provide `group_name` or `group_id`
+* `site_id` (int64): Site ID. If not provided, will default to current site. Used when creating a permission for a child site.
 
 ---
 

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.205';
+var version = '1.2.206';
 var userAgent = "Files.com JavaScript SDK v".concat(version);
 var logLevel = _Logger.LogLevel.INFO;
 var debugRequest = false;

package/lib/models/Permission.js

@@ -89,6 +89,13 @@ var Permission = /*#__PURE__*/(0, _createClass2.default)(function Permission() {
   (0, _defineProperty2.default)(this, "setRecursive", function (value) {
     _this.attributes.recursive = value;
   });
+  // int64 # Site ID
+  (0, _defineProperty2.default)(this, "getSiteId", function () {
+    return _this.attributes.site_id;
+  });
+  (0, _defineProperty2.default)(this, "setSiteId", function (value) {
+    _this.attributes.site_id = value;
+  });
   (0, _defineProperty2.default)(this, "delete", /*#__PURE__*/(0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee() {
     var params,
       _args = arguments;
@@ -181,7 +188,7 @@ _Permission = Permission;
 // Parameters:
 //   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 //   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-//   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `group_id`, `path` or `user_id`.
+//   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `site_id`, `group_id`, `path` or `user_id`.
 //   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `path`, `group_id` or `user_id`. Valid field combinations are `[ group_id, path ]`, `[ user_id, path ]` or `[ user_id, group_id ]`.
 //   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `path`.
 //   path - string - Permission path.  If provided, will scope all permissions(including upward) to this path.
@@ -255,6 +262,7 @@ _Permission = Permission;
 //   user_id - int64 - User ID.  Provide `username` or `user_id`
 //   username - string - User username.  Provide `username` or `user_id`
 //   group_name - string - Group name.  Provide `group_name` or `group_id`
+//   site_id - int64 - Site ID. If not provided, will default to current site. Used when creating a permission for a child site.
 (0, _defineProperty2.default)(Permission, "create", /*#__PURE__*/(0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee4() {
   var params,
     options,
@@ -307,12 +315,18 @@ _Permission = Permission;
         }
         throw new errors.InvalidParameterError("Bad parameter: group_name must be of type String, received ".concat((0, _utils.getType)(params.group_name)));
       case 16:
-        _context4.next = 18;
-        return _Api.default.sendRequest('/permissions', 'POST', params, options);
+        if (!(params.site_id && !(0, _utils.isInt)(params.site_id))) {
+          _context4.next = 18;
+          break;
+        }
+        throw new errors.InvalidParameterError("Bad parameter: site_id must be of type Int, received ".concat((0, _utils.getType)(params.site_id)));
       case 18:
+        _context4.next = 20;
+        return _Api.default.sendRequest('/permissions', 'POST', params, options);
+      case 20:
         response = _context4.sent;
         return _context4.abrupt("return", new _Permission(response === null || response === void 0 ? void 0 : response.data, options));
-      case 20:
+      case 22:
       case "end":
         return _context4.stop();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "files.com",
-  "version": "1.2.205",
+  "version": "1.2.206",
   "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.205'
+const version = '1.2.206'
 let userAgent = `Files.com JavaScript SDK v${version}`
 
 let logLevel = LogLevel.INFO

package/src/models/Permission.js

@@ -84,6 +84,13 @@ class Permission {
     this.attributes.recursive = value
   }
 
+  // int64 # Site ID
+  getSiteId = () => this.attributes.site_id
+
+  setSiteId = value => {
+    this.attributes.site_id = value
+  }
+
   delete = async (params = {}) => {
     if (!this.attributes.id) {
       throw new errors.EmptyPropertyError('Current object has no id')
@@ -125,7 +132,7 @@ class Permission {
   // Parameters:
   //   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
   //   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-  //   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `group_id`, `path` or `user_id`.
+  //   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `site_id`, `group_id`, `path` or `user_id`.
   //   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `path`, `group_id` or `user_id`. Valid field combinations are `[ group_id, path ]`, `[ user_id, path ]` or `[ user_id, group_id ]`.
   //   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `path`.
   //   path - string - Permission path.  If provided, will scope all permissions(including upward) to this path.
@@ -169,6 +176,7 @@ class Permission {
   //   user_id - int64 - User ID.  Provide `username` or `user_id`
   //   username - string - User username.  Provide `username` or `user_id`
   //   group_name - string - Group name.  Provide `group_name` or `group_id`
+  //   site_id - int64 - Site ID. If not provided, will default to current site. Used when creating a permission for a child site.
   static create = async (params = {}, options = {}) => {
     if (!params.path) {
       throw new errors.MissingParameterError('Parameter missing: path')
@@ -198,6 +206,10 @@ class Permission {
       throw new errors.InvalidParameterError(`Bad parameter: group_name must be of type String, received ${getType(params.group_name)}`)
     }
 
+    if (params.site_id && !isInt(params.site_id)) {
+      throw new errors.InvalidParameterError(`Bad parameter: site_id must be of type Int, received ${getType(params.site_id)}`)
+    }
+
     const response = await Api.sendRequest('/permissions', 'POST', params, options)
 
     return new Permission(response?.data, options)