backendless 6.3.3 → 6.3.4

package/backendless.d.ts

@@ -447,12 +447,25 @@ declare module Backendless {
 
         let restUrl: string;
 
-        function saveFile(path: string, fileName: string, fileContent: Blob | string, overwrite?: boolean): Promise<boolean>;
+        function saveFile(path: string, fileName: string, fileContent: Blob | Buffer | string, overwrite?: boolean): Promise<string>;
 
-        function upload(file: File, path: string, overwrite?: boolean): Promise<Object>;
-        function upload(fileURL: string, path: string, overwrite?: boolean): Promise<Object>;
         // @ts-ignore - file has to be an instance of File in browser env and an instance of ReadStream in nodejs env
-        function upload(readStream: ReadStream, path: string, overwrite?: boolean): Promise<Object>;
+        function upload(readStream: ReadStream, path: string, overwrite?: boolean): Promise<{ fileURL: string }>;
+        function upload(file: File, path: string, overwrite?: boolean): Promise<{ fileURL: string }>;
+        function upload(fileURL: string, path: string, overwrite?: boolean): Promise<{ fileURL: string }>;
+
+        function append(filePath: string, fileURL: string): Promise<string>;
+        function append(filePath: string, fileContent: Blob | Buffer | ArrayBuffer | number[]): Promise<string>;
+        // @ts-ignore
+        function append(filePath: string, readStream: ReadStream): Promise<string>;
+
+        function append(directoryPath: string, fileName: string, fileURL: string): Promise<string>;
+        function append(directoryPath: string, fileName: string, fileContent: Blob | Buffer | ArrayBuffer | number[]): Promise<string>;
+        // @ts-ignore
+        function append(directoryPath: string, fileName: string, readStream: ReadStream): Promise<string>;
+
+        function appendText(directoryPath: string, fileName: string, fileContent: string): Promise<string>;
+        function appendText(filePath: string, fileContent: string): Promise<string>;
 
         function listing(path: string, pattern?: string, sub?: boolean, pageSize?: number, offset?: number): Promise<Object>;
 

package/dist/backendless.js

@@ -1,6 +1,6 @@
 /*
  * ********************************************************************************************************************
- *  Backendless SDK for JavaScript. Version: 6.3.3
+ *  Backendless SDK for JavaScript. Version: 6.3.4
  *
  *  Copyright 2012-2021 BACKENDLESS.COM. All Rights Reserved.
  *
@@ -16951,7 +16951,7 @@ var Files = /*#__PURE__*/function () {
                   query.overwrite = overwrite;
                 }
 
-                filePath = _utils["default"].preventSlashInPath(filePath);
+                filePath = _utils["default"].trimSlashesInPath(filePath);
                 fileName = _utils["default"].sanitizeFileName(fileName);
                 return _context.abrupt("return", this.app.request.put({
                   url: "".concat(this.app.urls.fileBinaryPath(filePath), "/").concat(fileName),
@@ -16991,7 +16991,7 @@ var Files = /*#__PURE__*/function () {
                   query.overwrite = overwrite;
                 }
 
-                filePath = _utils["default"].preventSlashInPath(filePath);
+                filePath = _utils["default"].trimSlashesInPath(filePath);
                 pathTokens = _utils["default"].parseFilePath(filePath);
 
                 if (pathTokens.fileName) {
@@ -17010,7 +17010,7 @@ var Files = /*#__PURE__*/function () {
                 }
 
                 return _context2.abrupt("return", this.app.request.post({
-                  url: "".concat(this.app.urls.filePath(filePath), "/").concat(fileName || ''),
+                  url: "".concat(this.app.urls.filePath(filePath), "/").concat(fileName),
                   query: query,
                   data: {
                     url: file
@@ -17054,25 +17054,189 @@ var Files = /*#__PURE__*/function () {
       return upload;
     }()
   }, {
-    key: "listing",
+    key: "append",
     value: function () {
-      var _listing = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee3(filePath, pattern, sub, pagesize, offset) {
-        var query;
+      var _append = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee3(filePath, fileName, fileContent) {
+        var pathTokens,
+            _args3 = arguments;
         return _regenerator["default"].wrap(function _callee3$(_context3) {
           while (1) {
             switch (_context3.prev = _context3.next) {
+              case 0:
+                if (!(!filePath || typeof filePath !== 'string')) {
+                  _context3.next = 2;
+                  break;
+                }
+
+                throw new Error('"filePath" must be provided and must be a string.');
+
+              case 2:
+                filePath = _utils["default"].trimSlashesInPath(filePath);
+
+                if (_args3.length === 2) {
+                  fileContent = fileName;
+                  fileName = undefined;
+                  pathTokens = _utils["default"].parseFilePath(filePath);
+
+                  if (pathTokens.fileName) {
+                    filePath = pathTokens.filePath;
+                    fileName = pathTokens.fileName;
+                  }
+                }
+
+                if (fileName) {
+                  _context3.next = 6;
+                  break;
+                }
+
+                throw new Error('Can not resolve target file name');
+
+              case 6:
+                fileName = _utils["default"].sanitizeFileName(fileName);
+
+                if (!(typeof fileContent === 'string')) {
+                  _context3.next = 9;
+                  break;
+                }
+
+                return _context3.abrupt("return", this.app.request.post({
+                  url: "".concat(this.app.urls.fileAppendPath(filePath), "/").concat(fileName),
+                  data: {
+                    url: fileContent
+                  }
+                }));
+
+              case 9:
+                if (!_utils["default"].isBytesArray(fileContent)) {
+                  _context3.next = 14;
+                  break;
+                }
+
+                _context3.next = 12;
+                return _utils["default"].toBase64(fileContent);
+
+              case 12:
+                fileContent = _context3.sent;
+                return _context3.abrupt("return", this.app.request.put({
+                  url: "".concat(this.app.urls.fileAppendBinaryPath(filePath), "/").concat(fileName),
+                  headers: {
+                    'Content-Type': 'text/plain'
+                  },
+                  data: fileContent
+                }));
+
+              case 14:
+                return _context3.abrupt("return", this.app.request.post({
+                  url: "".concat(this.app.urls.fileAppendPath(filePath), "/").concat(fileName),
+                  form: {
+                    file: fileContent
+                  }
+                }));
+
+              case 15:
+              case "end":
+                return _context3.stop();
+            }
+          }
+        }, _callee3, this);
+      }));
+
+      function append(_x8, _x9, _x10) {
+        return _append.apply(this, arguments);
+      }
+
+      return append;
+    }()
+  }, {
+    key: "appendText",
+    value: function () {
+      var _appendText = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee4(filePath, fileName, textContent) {
+        var pathTokens,
+            _args4 = arguments;
+        return _regenerator["default"].wrap(function _callee4$(_context4) {
+          while (1) {
+            switch (_context4.prev = _context4.next) {
+              case 0:
+                if (!(!filePath || typeof filePath !== 'string')) {
+                  _context4.next = 2;
+                  break;
+                }
+
+                throw new Error('"filePath" must be provided and must be a string.');
+
+              case 2:
+                filePath = _utils["default"].trimSlashesInPath(filePath);
+
+                if (_args4.length === 2) {
+                  textContent = fileName;
+                  fileName = undefined;
+                  pathTokens = _utils["default"].parseFilePath(filePath);
+
+                  if (pathTokens.fileName) {
+                    filePath = pathTokens.filePath;
+                    fileName = pathTokens.fileName;
+                  }
+                }
+
+                if (fileName) {
+                  _context4.next = 6;
+                  break;
+                }
+
+                throw new Error('Can not resolve target file name');
+
+              case 6:
+                if (!(typeof textContent !== 'string')) {
+                  _context4.next = 8;
+                  break;
+                }
+
+                throw new Error('"textContent" must be a string');
+
+              case 8:
+                fileName = _utils["default"].sanitizeFileName(fileName);
+                return _context4.abrupt("return", this.app.request.put({
+                  url: "".concat(this.app.urls.fileAppendPath(filePath), "/").concat(fileName),
+                  headers: {
+                    'Content-Type': 'text/plain'
+                  },
+                  data: textContent
+                }));
+
+              case 10:
+              case "end":
+                return _context4.stop();
+            }
+          }
+        }, _callee4, this);
+      }));
+
+      function appendText(_x11, _x12, _x13) {
+        return _appendText.apply(this, arguments);
+      }
+
+      return appendText;
+    }()
+  }, {
+    key: "listing",
+    value: function () {
+      var _listing = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee5(filePath, pattern, sub, pagesize, offset) {
+        var query;
+        return _regenerator["default"].wrap(function _callee5$(_context5) {
+          while (1) {
+            switch (_context5.prev = _context5.next) {
               case 0:
                 query = {};
 
                 if (!(!filePath || typeof filePath !== 'string')) {
-                  _context3.next = 3;
+                  _context5.next = 3;
                   break;
                 }
 
                 throw new Error('"filePath" must be provided and must be a string.');
 
               case 3:
-                filePath = _utils["default"].preventSlashInPath(filePath);
+                filePath = _utils["default"].trimSlashesInPath(filePath);
 
                 if (pattern && typeof pattern === 'string') {
                   query.pattern = pattern;
@@ -17090,20 +17254,20 @@ var Files = /*#__PURE__*/function () {
                   query.offset = offset;
                 }
 
-                return _context3.abrupt("return", this.app.request.get({
+                return _context5.abrupt("return", this.app.request.get({
                   url: this.app.urls.filePath(filePath),
                   query: query
                 }));
 
               case 9:
               case "end":
-                return _context3.stop();
+                return _context5.stop();
             }
           }
-        }, _callee3, this);
+        }, _callee5, this);
       }));
 
-      function listing(_x8, _x9, _x10, _x11, _x12) {
+      function listing(_x14, _x15, _x16, _x17, _x18) {
         return _listing.apply(this, arguments);
       }
 
@@ -17112,13 +17276,13 @@ var Files = /*#__PURE__*/function () {
   }, {
     key: "renameFile",
     value: function () {
-      var _renameFile = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee4(oldPathName, newName) {
-        return _regenerator["default"].wrap(function _callee4$(_context4) {
+      var _renameFile = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee6(oldPathName, newName) {
+        return _regenerator["default"].wrap(function _callee6$(_context6) {
           while (1) {
-            switch (_context4.prev = _context4.next) {
+            switch (_context6.prev = _context6.next) {
               case 0:
                 if (!(!oldPathName || typeof oldPathName !== 'string')) {
-                  _context4.next = 2;
+                  _context6.next = 2;
                   break;
                 }
 
@@ -17126,14 +17290,14 @@ var Files = /*#__PURE__*/function () {
 
               case 2:
                 if (!(!newName || typeof newName !== 'string')) {
-                  _context4.next = 4;
+                  _context6.next = 4;
                   break;
                 }
 
                 throw new Error('New File Name must be provided and must be a string.');
 
               case 4:
-                return _context4.abrupt("return", this.app.request.put({
+                return _context6.abrupt("return", this.app.request.put({
                   url: this.app.urls.fileRename(),
                   data: {
                     oldPathName: _utils["default"].ensureSlashInPath(oldPathName),
@@ -17143,13 +17307,13 @@ var Files = /*#__PURE__*/function () {
 
               case 5:
               case "end":
-                return _context4.stop();
+                return _context6.stop();
             }
           }
-        }, _callee4, this);
+        }, _callee6, this);
       }));
 
-      function renameFile(_x13, _x14) {
+      function renameFile(_x19, _x20) {
         return _renameFile.apply(this, arguments);
       }
 
@@ -17158,12 +17322,12 @@ var Files = /*#__PURE__*/function () {
   }, {
     key: "moveFile",
     value: function () {
-      var _moveFile = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee5(sourcePath, targetPath) {
-        return _regenerator["default"].wrap(function _callee5$(_context5) {
+      var _moveFile = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee7(sourcePath, targetPath) {
+        return _regenerator["default"].wrap(function _callee7$(_context7) {
           while (1) {
-            switch (_context5.prev = _context5.next) {
+            switch (_context7.prev = _context7.next) {
               case 0:
-                return _context5.abrupt("return", this.app.request.put({
+                return _context7.abrupt("return", this.app.request.put({
                   url: this.app.urls.fileMove(),
                   data: {
                     sourcePath: _utils["default"].ensureSlashInPath(sourcePath),
@@ -17173,13 +17337,13 @@ var Files = /*#__PURE__*/function () {
 
               case 1:
               case "end":
-                return _context5.stop();
+                return _context7.stop();
             }
           }
-        }, _callee5, this);
+        }, _callee7, this);
       }));
 
-      function moveFile(_x15, _x16) {
+      function moveFile(_x21, _x22) {
         return _moveFile.apply(this, arguments);
       }
 
@@ -17188,12 +17352,12 @@ var Files = /*#__PURE__*/function () {
   }, {
     key: "copyFile",
     value: function () {
-      var _copyFile = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee6(sourcePath, targetPath) {
-        return _regenerator["default"].wrap(function _callee6$(_context6) {
+      var _copyFile = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee8(sourcePath, targetPath) {
+        return _regenerator["default"].wrap(function _callee8$(_context8) {
           while (1) {
-            switch (_context6.prev = _context6.next) {
+            switch (_context8.prev = _context8.next) {
               case 0:
-                return _context6.abrupt("return", this.app.request.put({
+                return _context8.abrupt("return", this.app.request.put({
                   url: this.app.urls.fileCopy(),
                   data: {
                     sourcePath: _utils["default"].ensureSlashInPath(sourcePath),
@@ -17203,13 +17367,13 @@ var Files = /*#__PURE__*/function () {
 
               case 1:
               case "end":
-                return _context6.stop();
+                return _context8.stop();
             }
           }
-        }, _callee6, this);
+        }, _callee8, this);
       }));
 
-      function copyFile(_x17, _x18) {
+      function copyFile(_x23, _x24) {
         return _copyFile.apply(this, arguments);
       }
 
@@ -17218,13 +17382,13 @@ var Files = /*#__PURE__*/function () {
   }, {
     key: "remove",
     value: function () {
-      var _remove = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee7(filePath) {
-        return _regenerator["default"].wrap(function _callee7$(_context7) {
+      var _remove = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee9(filePath) {
+        return _regenerator["default"].wrap(function _callee9$(_context9) {
           while (1) {
-            switch (_context7.prev = _context7.next) {
+            switch (_context9.prev = _context9.next) {
               case 0:
                 if (!(!filePath || typeof filePath !== 'string')) {
-                  _context7.next = 2;
+                  _context9.next = 2;
                   break;
                 }
 
@@ -17235,19 +17399,19 @@ var Files = /*#__PURE__*/function () {
                   filePath = this.app.urls.filePath(filePath);
                 }
 
-                return _context7.abrupt("return", this.app.request["delete"]({
+                return _context9.abrupt("return", this.app.request["delete"]({
                   url: filePath
                 }));
 
               case 4:
               case "end":
-                return _context7.stop();
+                return _context9.stop();
             }
           }
-        }, _callee7, this);
+        }, _callee9, this);
       }));
 
-      function remove(_x19) {
+      function remove(_x25) {
         return _remove.apply(this, arguments);
       }
 
@@ -17256,21 +17420,21 @@ var Files = /*#__PURE__*/function () {
   }, {
     key: "exists",
     value: function () {
-      var _exists = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee8(filePath) {
-        return _regenerator["default"].wrap(function _callee8$(_context8) {
+      var _exists = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee10(filePath) {
+        return _regenerator["default"].wrap(function _callee10$(_context10) {
           while (1) {
-            switch (_context8.prev = _context8.next) {
+            switch (_context10.prev = _context10.next) {
               case 0:
                 if (!(!filePath || typeof filePath !== 'string')) {
-                  _context8.next = 2;
+                  _context10.next = 2;
                   break;
                 }
 
                 throw new Error('"filePath" must be provided and must be a string.');
 
               case 2:
-                filePath = _utils["default"].preventSlashInPath(filePath);
-                return _context8.abrupt("return", this.app.request.get({
+                filePath = _utils["default"].trimSlashesInPath(filePath);
+                return _context10.abrupt("return", this.app.request.get({
                   url: this.app.urls.filePath(filePath),
                   query: {
                     action: 'exists'
@@ -17279,13 +17443,13 @@ var Files = /*#__PURE__*/function () {
 
               case 4:
               case "end":
-                return _context8.stop();
+                return _context10.stop();
             }
           }
-        }, _callee8, this);
+        }, _callee10, this);
       }));
 
-      function exists(_x20) {
+      function exists(_x26) {
         return _exists.apply(this, arguments);
       }
 
@@ -17294,33 +17458,33 @@ var Files = /*#__PURE__*/function () {
   }, {
     key: "removeDirectory",
     value: function () {
-      var _removeDirectory = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee9(directoryPath) {
-        return _regenerator["default"].wrap(function _callee9$(_context9) {
+      var _removeDirectory = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee11(directoryPath) {
+        return _regenerator["default"].wrap(function _callee11$(_context11) {
           while (1) {
-            switch (_context9.prev = _context9.next) {
+            switch (_context11.prev = _context11.next) {
               case 0:
                 if (!(!directoryPath || typeof directoryPath !== 'string')) {
-                  _context9.next = 2;
+                  _context11.next = 2;
                   break;
                 }
 
                 throw new Error('Directory "path" must be provided and must be a string.');
 
               case 2:
-                directoryPath = _utils["default"].preventSlashInPath(directoryPath);
-                return _context9.abrupt("return", this.app.request["delete"]({
+                directoryPath = _utils["default"].trimSlashesInPath(directoryPath);
+                return _context11.abrupt("return", this.app.request["delete"]({
                   url: this.app.urls.filePath(directoryPath)
                 }));
 
               case 4:
               case "end":
-                return _context9.stop();
+                return _context11.stop();
             }
           }
-        }, _callee9, this);
+        }, _callee11, this);
       }));
 
-      function removeDirectory(_x21) {
+      function removeDirectory(_x27) {
         return _removeDirectory.apply(this, arguments);
       }
 
@@ -17329,13 +17493,13 @@ var Files = /*#__PURE__*/function () {
   }, {
     key: "getFileCount",
     value: function () {
-      var _getFileCount = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee10(filesPath, pattern, sub, countDirectories) {
-        return _regenerator["default"].wrap(function _callee10$(_context10) {
+      var _getFileCount = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee12(filesPath, pattern, sub, countDirectories) {
+        return _regenerator["default"].wrap(function _callee12$(_context12) {
           while (1) {
-            switch (_context10.prev = _context10.next) {
+            switch (_context12.prev = _context12.next) {
               case 0:
                 if (!(!filesPath || typeof filesPath !== 'string')) {
-                  _context10.next = 2;
+                  _context12.next = 2;
                   break;
                 }
 
@@ -17343,15 +17507,15 @@ var Files = /*#__PURE__*/function () {
 
               case 2:
                 if (!(pattern && typeof pattern !== 'string')) {
-                  _context10.next = 4;
+                  _context12.next = 4;
                   break;
                 }
 
                 throw new Error('Files Pattern must be provided and must be a string.');
 
               case 4:
-                filesPath = _utils["default"].preventSlashInPath(filesPath);
-                return _context10.abrupt("return", this.app.request.get({
+                filesPath = _utils["default"].trimSlashesInPath(filesPath);
+                return _context12.abrupt("return", this.app.request.get({
                   url: this.app.urls.filePath(filesPath),
                   query: {
                     action: 'count',
@@ -17363,13 +17527,13 @@ var Files = /*#__PURE__*/function () {
 
               case 6:
               case "end":
-                return _context10.stop();
+                return _context12.stop();
             }
           }
-        }, _callee10, this);
+        }, _callee12, this);
       }));
 
-      function getFileCount(_x22, _x23, _x24, _x25) {
+      function getFileCount(_x28, _x29, _x30, _x31) {
         return _getFileCount.apply(this, arguments);
       }
 
@@ -17464,11 +17628,32 @@ var _regenerator = _interopRequireDefault(__webpack_require__(/*! @babel/runtime
 var _asyncToGenerator2 = _interopRequireDefault(__webpack_require__(/*! @babel/runtime/helpers/asyncToGenerator */ "./node_modules/@babel/runtime/helpers/asyncToGenerator.js"));
 
 var FilesUtils = {
+  isBytesArray: function isBytesArray(data) {
+    if (typeof Buffer !== 'undefined' && data instanceof Buffer) {
+      return true;
+    }
+
+    if (typeof ArrayBuffer !== 'undefined' && data instanceof ArrayBuffer) {
+      return true;
+    }
+
+    return Array.isArray(data);
+  },
   ensureSlashInPath: function ensureSlashInPath(path) {
     return !path.startsWith('/') ? "/".concat(path) : path;
   },
-  preventSlashInPath: function preventSlashInPath(path) {
-    return path && path.startsWith('/') ? path.slice(1) : path;
+  trimSlashesInPath: function trimSlashesInPath(path) {
+    if (path) {
+      if (path.startsWith('/')) {
+        path = path.slice(1);
+      }
+
+      if (path.endsWith('/')) {
+        path = path.slice(0, path.length - 1);
+      }
+    }
+
+    return path;
   },
   parseFilePath: function parseFilePath(path) {
     var result = {
@@ -21964,6 +22149,16 @@ var Urls = /*#__PURE__*/function () {
     key: "fileBinaryPath",
     value: function fileBinaryPath(path) {
       return "".concat(this.files(), "/binary/").concat(path);
+    }
+  }, {
+    key: "fileAppendPath",
+    value: function fileAppendPath(path) {
+      return "".concat(this.files(), "/append/").concat(path);
+    }
+  }, {
+    key: "fileAppendBinaryPath",
+    value: function fileAppendBinaryPath(path) {
+      return "".concat(this.files(), "/append/binary/").concat(path);
     } //users
 
   }, {