files.com 1.2.178 → 1.2.179

package/README.md

@@ -545,28 +545,12 @@ Error
 |     `SiteConfiguration_TrialLockedError`|  `SiteConfigurationError` |
 |     `SiteConfiguration_UserRequestsEnabledRequiredError`|  `SiteConfigurationError` |
 
-## Mock Server
-
-Files.com publishes a Files.com API server, which is useful for testing your use of the Files.com
-SDKs and other direct integrations against the Files.com API in an integration test environment.
-
-It is a Ruby app that operates as a minimal server for the purpose of testing basic network
-operations and JSON encoding for your SDK or API client. It does not maintain state and it does not
-deeply inspect your submissions for correctness.
-
-Eventually we will add more features intended for integration testing, such as the ability to
-intentionally provoke errors.
-
-Download the server as a Docker image via [Docker Hub](https://hub.docker.com/r/filescom/files-mock-server).
-
-The Source Code is also available on [GitHub](https://github.com/Files-com/files-mock-server).
-
-A README is available on the GitHub link.
-
-## File/Folder Operations
+## Examples
 
 ### Upload
 
+#### Upload a File
+
 ```javascript
 import File from 'files.com/lib/models/File.js';
 import { isBrowser } from 'files.com/lib/utils.js';
@@ -583,6 +567,16 @@ if (!isBrowser()) {
 }
 ```
 
+#### Create a Folder
+
+```javascript
+import Folder from 'files.com/lib/models/Folder.js';
+
+await Folder.create('path/to/folder/to/be/created', {
+  mkdir_parents: true,
+});
+```
+
 ### Download
 
 #### Get a Downloadable File Object by Path
@@ -613,10 +607,57 @@ if (!isBrowser()) {
 
 ### List
 
+#### List Folder Contents
+
 ```javascript
 import Folder from 'files.com/lib/models/Folder.js';
 
-const dirFiles = await Folder.listFor('/');
+const items = await Folder.listFor('remote/path/to/folder/');
+for (const item of items) {
+  console.log(item.path);
+}
+```
+
+### Copy
+
+The copy method works for both files and folders.
+
+```javascript
+import File from 'files.com/lib/models/File.js';
+
+const file = new File({ path: 'source/path' });
+await file.copy({ destination: 'destination/path' });
+```
+
+### Move
+
+The move method works for both files and folders.
+
+```javascript
+import File from 'files.com/lib/models/File.js';
+
+const file = new File({ path: 'source/path' });
+await file.move({ destination: 'destination/path' });
+```
+
+### Delete
+
+The delete method works for both files and folders.
+
+```javascript
+import File from 'files.com/lib/models/File.js';
+
+const file = new File({ path: 'path/to/file/or/folder' });
+await file.delete();
+```
+
+In case the folder is not empty, you can use the `recursive` argument:
+
+```javascript
+import File from 'files.com/lib/models/File.js';
+
+const folder = new File({ path: 'path/to/folder' });
+await folder.delete({ recursive: true });
 ```
 
 ### Comparing Case-Insensitive Files and Paths
@@ -630,3 +671,21 @@ if (pathNormalizer.same('Fïłèńämê.Txt', 'filename.txt')) {
   // the paths are the same
 }
 ```
+
+## Mock Server
+
+Files.com publishes a Files.com API server, which is useful for testing your use of the Files.com
+SDKs and other direct integrations against the Files.com API in an integration test environment.
+
+It is a Ruby app that operates as a minimal server for the purpose of testing basic network
+operations and JSON encoding for your SDK or API client. It does not maintain state and it does not
+deeply inspect your submissions for correctness.
+
+Eventually we will add more features intended for integration testing, such as the ability to
+intentionally provoke errors.
+
+Download the server as a Docker image via [Docker Hub](https://hub.docker.com/r/filescom/files-mock-server).
+
+The Source Code is also available on [GitHub](https://github.com/Files-com/files-mock-server).
+
+A README is available on the GitHub link.

package/_VERSION

@@ -1 +1 @@
-1.2.178
+1.2.179

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

package/package.json

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