backendless 6.3.2 → 6.3.6

package/dist/backendless.js

@@ -1,6 +1,6 @@
 /*
  * ********************************************************************************************************************
- *  Backendless SDK for JavaScript. Version: 6.3.2
+ *  Backendless SDK for JavaScript. Version: 6.3.6
  *
  *  Copyright 2012-2021 BACKENDLESS.COM. All Rights Reserved.
  *
@@ -15466,16 +15466,18 @@ var ChangesTypes = {
   CREATED: 'created',
   UPDATED: 'updated',
   DELETED: 'deleted',
+  UPSERTED: 'upserted',
   BULK_CREATED: 'bulk-created',
   BULK_UPDATED: 'bulk-updated',
-  BULK_DELETED: 'bulk-deleted'
+  BULK_DELETED: 'bulk-deleted',
+  BULK_UPSERTED: 'bulk-upserted'
 };
 var RelationsChangesTypes = {
   ADD: 'add',
   SET: 'set',
   DELETE: 'delete'
 };
-var SingleChangesTypes = [ChangesTypes.CREATED, ChangesTypes.UPDATED, ChangesTypes.DELETED];
+var SingleChangesTypes = [ChangesTypes.CREATED, ChangesTypes.UPDATED, ChangesTypes.DELETED, ChangesTypes.UPSERTED];
 
 var RTHandlers = /*#__PURE__*/function (_RTListeners) {
   (0, _inherits2["default"])(RTHandlers, _RTListeners);
@@ -15518,6 +15520,25 @@ var RTHandlers = /*#__PURE__*/function (_RTListeners) {
 
       this.removeCreateListeners(undefined, callback);
     }
+  }, {
+    key: "addUpsertListener",
+    value: function addUpsertListener(whereClause, callback, onError) {
+      this.addChangesListener(ChangesTypes.UPSERTED, whereClause, callback, onError);
+    }
+  }, {
+    key: "removeUpsertListeners",
+    value: function removeUpsertListeners(whereClause, callback) {
+      this.removeChangesListeners(ChangesTypes.UPSERTED, whereClause, callback);
+    }
+  }, {
+    key: "removeUpsertListener",
+    value: function removeUpsertListener(callback) {
+      if (!callback || typeof callback !== 'function') {
+        throw new Error('Listener Function must be passed.');
+      }
+
+      this.removeUpsertListeners(undefined, callback);
+    }
   }, {
     key: "addUpdateListener",
     value: function addUpdateListener(whereClause, callback, onError) {
@@ -15613,6 +15634,25 @@ var RTHandlers = /*#__PURE__*/function (_RTListeners) {
 
       this.removeBulkDeleteListeners(undefined, callback);
     }
+  }, {
+    key: "addBulkUpsertListener",
+    value: function addBulkUpsertListener(whereClause, callback, onError) {
+      this.addChangesListener(ChangesTypes.BULK_UPSERTED, whereClause, callback, onError);
+    }
+  }, {
+    key: "removeBulkUpsertListeners",
+    value: function removeBulkUpsertListeners() {
+      this.removeChangesListeners(ChangesTypes.BULK_UPSERTED);
+    }
+  }, {
+    key: "removeBulkUpsertListener",
+    value: function removeBulkUpsertListener(callback) {
+      if (!callback || typeof callback !== 'function') {
+        throw new Error('Listener Function must be passed.');
+      }
+
+      this.removeChangesListeners(ChangesTypes.BULK_UPSERTED, undefined, callback);
+    }
   }, {
     key: "addSetRelationListener",
     value: function addSetRelationListener(relationColumnName, parentObjects, callback, onError) {
@@ -15903,21 +15943,23 @@ var DataStore = /*#__PURE__*/function () {
   }, {
     key: "save",
     value: function () {
-      var _save = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee(object) {
+      var _save = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee(object, isUpsert) {
         var _this = this;
 
+        var url;
         return _regenerator["default"].wrap(function _callee$(_context) {
           while (1) {
             switch (_context.prev = _context.next) {
               case 0:
+                url = isUpsert ? this.app.urls.dataTableUpsert(this.className) : this.app.urls.dataTable(this.className);
                 return _context.abrupt("return", this.app.request.put({
-                  url: this.app.urls.dataTable(this.className),
+                  url: url,
                   data: convertToServerRecord(object)
                 }).then(function (result) {
                   return _this.parseResponse(result);
                 }));
 
-              case 1:
+              case 2:
               case "end":
                 return _context.stop();
             }
@@ -15925,7 +15967,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee, this);
       }));
 
-      function save(_x) {
+      function save(_x, _x2) {
         return _save.apply(this, arguments);
       }
 
@@ -15956,7 +15998,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee2, this);
       }));
 
-      function deepSave(_x2) {
+      function deepSave(_x3) {
         return _deepSave.apply(this, arguments);
       }
 
@@ -15993,7 +16035,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee3, this);
       }));
 
-      function remove(_x3) {
+      function remove(_x4) {
         return _remove.apply(this, arguments);
       }
 
@@ -16024,7 +16066,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee4, this);
       }));
 
-      function find(_x4) {
+      function find(_x5) {
         return _find.apply(this, arguments);
       }
 
@@ -16051,7 +16093,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee5, this);
       }));
 
-      function group(_x5) {
+      function group(_x6) {
         return _group.apply(this, arguments);
       }
 
@@ -16086,7 +16128,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee6, this);
       }));
 
-      function countInGroup(_x6) {
+      function countInGroup(_x7) {
         return _countInGroup.apply(this, arguments);
       }
 
@@ -16154,7 +16196,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee7, this);
       }));
 
-      function findById(_x7, _x8) {
+      function findById(_x8, _x9) {
         return _findById.apply(this, arguments);
       }
 
@@ -16185,7 +16227,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee8, this);
       }));
 
-      function findFirst(_x9) {
+      function findFirst(_x10) {
         return _findFirst.apply(this, arguments);
       }
 
@@ -16216,7 +16258,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee9, this);
       }));
 
-      function findLast(_x10) {
+      function findLast(_x11) {
         return _findLast.apply(this, arguments);
       }
 
@@ -16273,7 +16315,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee10, this);
       }));
 
-      function getObjectCount(_x11) {
+      function getObjectCount(_x12) {
         return _getObjectCount.apply(this, arguments);
       }
 
@@ -16326,7 +16368,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee11, this);
       }));
 
-      function loadRelations(_x12, _x13) {
+      function loadRelations(_x13, _x14) {
         return _loadRelations.apply(this, arguments);
       }
 
@@ -16350,7 +16392,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee12, this);
       }));
 
-      function setRelation(_x14, _x15, _x16) {
+      function setRelation(_x15, _x16, _x17) {
         return _setRelation.apply(this, arguments);
       }
 
@@ -16374,7 +16416,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee13, this);
       }));
 
-      function addRelation(_x17, _x18, _x19) {
+      function addRelation(_x18, _x19, _x20) {
         return _addRelation.apply(this, arguments);
       }
 
@@ -16398,7 +16440,7 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee14, this);
       }));
 
-      function deleteRelation(_x20, _x21, _x22) {
+      function deleteRelation(_x21, _x22, _x23) {
         return _deleteRelation.apply(this, arguments);
       }
 
@@ -16443,22 +16485,67 @@ var DataStore = /*#__PURE__*/function () {
         }, _callee15, this);
       }));
 
-      function bulkCreate(_x23) {
+      function bulkCreate(_x24) {
         return _bulkCreate.apply(this, arguments);
       }
 
       return bulkCreate;
     }()
   }, {
-    key: "bulkUpdate",
+    key: "bulkUpsert",
     value: function () {
-      var _bulkUpdate = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee16(condition, changes) {
+      var _bulkUpsert = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee16(objects) {
+        var errorMessage;
         return _regenerator["default"].wrap(function _callee16$(_context16) {
           while (1) {
             switch (_context16.prev = _context16.next) {
+              case 0:
+                errorMessage = 'Objects must be provided and must be an array of objects.';
+
+                if (!(!objects || !Array.isArray(objects) || !objects.length)) {
+                  _context16.next = 3;
+                  break;
+                }
+
+                throw new Error(errorMessage);
+
+              case 3:
+                objects = objects.map(function (object) {
+                  if (!object || (0, _typeof2["default"])(object) !== 'object' || Array.isArray(object)) {
+                    throw new Error(errorMessage);
+                  }
+
+                  return object;
+                });
+                return _context16.abrupt("return", this.app.request.put({
+                  url: this.app.urls.dataBulkTableUpsert(this.className),
+                  data: objects
+                }));
+
+              case 5:
+              case "end":
+                return _context16.stop();
+            }
+          }
+        }, _callee16, this);
+      }));
+
+      function bulkUpsert(_x25) {
+        return _bulkUpsert.apply(this, arguments);
+      }
+
+      return bulkUpsert;
+    }()
+  }, {
+    key: "bulkUpdate",
+    value: function () {
+      var _bulkUpdate = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee17(condition, changes) {
+        return _regenerator["default"].wrap(function _callee17$(_context17) {
+          while (1) {
+            switch (_context17.prev = _context17.next) {
               case 0:
                 if (!(!condition || typeof condition !== 'string')) {
-                  _context16.next = 2;
+                  _context17.next = 2;
                   break;
                 }
 
@@ -16466,14 +16553,14 @@ var DataStore = /*#__PURE__*/function () {
 
               case 2:
                 if (!(!changes || (0, _typeof2["default"])(changes) !== 'object' || Array.isArray(changes))) {
-                  _context16.next = 4;
+                  _context17.next = 4;
                   break;
                 }
 
                 throw new Error('Changes must be provided and must be an object.');
 
               case 4:
-                return _context16.abrupt("return", this.app.request.put({
+                return _context17.abrupt("return", this.app.request.put({
                   url: this.app.urls.dataBulkTable(this.className),
                   query: {
                     where: condition
@@ -16483,13 +16570,13 @@ var DataStore = /*#__PURE__*/function () {
 
               case 5:
               case "end":
-                return _context16.stop();
+                return _context17.stop();
             }
           }
-        }, _callee16, this);
+        }, _callee17, this);
       }));
 
-      function bulkUpdate(_x24, _x25) {
+      function bulkUpdate(_x26, _x27) {
         return _bulkUpdate.apply(this, arguments);
       }
 
@@ -16498,14 +16585,14 @@ var DataStore = /*#__PURE__*/function () {
   }, {
     key: "bulkDelete",
     value: function () {
-      var _bulkDelete = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee17(condition) {
+      var _bulkDelete = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee18(condition) {
         var queryData, objectIds;
-        return _regenerator["default"].wrap(function _callee17$(_context17) {
+        return _regenerator["default"].wrap(function _callee18$(_context18) {
           while (1) {
-            switch (_context17.prev = _context17.next) {
+            switch (_context18.prev = _context18.next) {
               case 0:
                 if (!(!condition || typeof condition !== 'string' && !Array.isArray(condition))) {
-                  _context17.next = 2;
+                  _context18.next = 2;
                   break;
                 }
 
@@ -16529,20 +16616,20 @@ var DataStore = /*#__PURE__*/function () {
                   queryData.where = "objectId in (".concat(objectIds.join(','), ")");
                 }
 
-                return _context17.abrupt("return", this.app.request.post({
+                return _context18.abrupt("return", this.app.request.post({
                   url: this.app.urls.dataBulkTableDelete(this.className),
                   data: queryData
                 }));
 
               case 5:
               case "end":
-                return _context17.stop();
+                return _context18.stop();
             }
           }
-        }, _callee17, this);
+        }, _callee18, this);
       }));
 
-      function bulkDelete(_x26) {
+      function bulkDelete(_x28) {
         return _bulkDelete.apply(this, arguments);
       }
 
@@ -16864,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),
@@ -16904,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) {
@@ -16923,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
@@ -16967,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;
@@ -17003,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);
       }
 
@@ -17025,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;
                 }
 
@@ -17039,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),
@@ -17056,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);
       }
 
@@ -17071,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),
@@ -17086,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);
       }
 
@@ -17101,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),
@@ -17116,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);
       }
 
@@ -17131,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;
                 }
 
@@ -17148,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);
       }
 
@@ -17169,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'
@@ -17192,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);
       }
 
@@ -17207,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);
       }
 
@@ -17242,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;
                 }
 
@@ -17256,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',
@@ -17276,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);
       }
 
@@ -17377,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 = {
@@ -18077,7 +18349,7 @@ var LocalCache = /*#__PURE__*/function () {
   function LocalCache(app) {
     (0, _classCallCheck2["default"])(this, LocalCache);
     this.app = app;
-    this.storageName = "".concat(STORAGE_KEY_NAMESPACE, "_").concat(this.app.appId);
+    this.storageName = this.app.appId ? "".concat(STORAGE_KEY_NAMESPACE, "_").concat(this.app.appId) : STORAGE_KEY_NAMESPACE;
     var Storage = _utils["default"].isLocalStorageSupported ? _localStorage["default"] : _virtualStorage["default"];
     this.setStorage(Storage);
     this.Keys = {
@@ -18344,6 +18616,10 @@ var Logging = /*#__PURE__*/function () {
   }, {
     key: "push",
     value: function push(logger, logLevel, message, exception) {
+      if (typeof message !== 'string') {
+        throw new Error('"message" must be a string');
+      }
+
       this.pool.push({
         logger: logger,
         message: message,
@@ -20346,6 +20622,8 @@ var OperationType = {
   UPDATE_BULK: 'UPDATE_BULK',
   DELETE: 'DELETE',
   DELETE_BULK: 'DELETE_BULK',
+  UPSERT: 'UPSERT',
+  UPSERT_BULK: 'UPSERT_BULK',
   FIND: 'FIND',
   ADD_RELATION: 'ADD_RELATION',
   SET_RELATION: 'SET_RELATION',
@@ -20680,6 +20958,37 @@ var UnitOfWork = /*#__PURE__*/function () {
 
       return this.addOperations(_constants.OperationType.FIND, tableName, payload);
     }
+    /**
+     * upsert(object: object): OpResult;
+     * upsert(tableName: string, object: object): OpResult;
+     * **/
+
+  }, {
+    key: "upsert",
+    value: function upsert() {
+      var tableName;
+      var changes;
+
+      if (arguments.length === 1) {
+        tableName = _utils["default"].getClassName(arguments.length <= 0 ? undefined : arguments[0]);
+        changes = arguments.length <= 0 ? undefined : arguments[0];
+      } else if (arguments.length === 2) {
+        tableName = arguments.length <= 0 ? undefined : arguments[0];
+        changes = arguments.length <= 1 ? undefined : arguments[1];
+      } else {
+        throw new Error('Invalid arguments');
+      }
+
+      if (!tableName || typeof tableName !== 'string') {
+        throw new Error('Invalid arguments');
+      }
+
+      if (!changes || (0, _typeof2["default"])(changes) !== 'object' || Array.isArray(changes)) {
+        throw new Error('Invalid arguments');
+      }
+
+      return this.addOperations(_constants.OperationType.UPSERT, tableName, changes);
+    }
     /**
      * create(object: object): OpResult;
      * create(tableName: string, object: object): OpResult;
@@ -20808,6 +21117,29 @@ var UnitOfWork = /*#__PURE__*/function () {
 
       return this.addOperations(_constants.OperationType.DELETE, tableName, object);
     }
+    /**
+     * bulkUpsert(tableName: string, objects: object[]): OpResult;
+     * bulkUpsert(objects: object[]): OpResult;
+     * **/
+
+  }, {
+    key: "bulkUpsert",
+    value: function bulkUpsert(tableName, objects) {
+      if (Array.isArray(tableName)) {
+        objects = tableName;
+        tableName = _utils["default"].getClassName(objects[0]);
+      }
+
+      if (!objects || !Array.isArray(objects)) {
+        throw new Error('Objects must be an array of objects.');
+      }
+
+      if (!tableName || typeof tableName !== 'string') {
+        throw new Error('Table Name must be a string.');
+      }
+
+      return this.addOperations(_constants.OperationType.UPSERT_BULK, tableName, objects);
+    }
     /**
      * bulkCreate(tableName: string, objects: object[]): OpResult;
      * bulkCreate(objects: object[]): OpResult;
@@ -21184,9 +21516,14 @@ var OperationJSONAdapter = {
         payload = _ref3.payload;
     return uow.update.call(uow, table, resolveOpResultValueReference(uow, payload));
   },
-  UPDATE_BULK: function UPDATE_BULK(uow, _ref4) {
+  UPSERT: function UPSERT(uow, _ref4) {
     var table = _ref4.table,
         payload = _ref4.payload;
+    return uow.upsert.call(uow, table, resolveOpResultValueReference(uow, payload));
+  },
+  UPDATE_BULK: function UPDATE_BULK(uow, _ref5) {
+    var table = _ref5.table,
+        payload = _ref5.payload;
     var args = baseBulkArgs(uow, {
       table: table,
       payload: payload
@@ -21194,55 +21531,60 @@ var OperationJSONAdapter = {
     args.push(resolveOpResultValueReference(uow, payload.changes));
     return uow.bulkUpdate.apply(uow, args);
   },
-  DELETE_BULK: function DELETE_BULK(uow, _ref5) {
-    var table = _ref5.table,
-        payload = _ref5.payload;
+  DELETE_BULK: function DELETE_BULK(uow, _ref6) {
+    var table = _ref6.table,
+        payload = _ref6.payload;
     var args = baseBulkArgs(uow, {
       table: table,
       payload: payload
     });
     return uow.bulkDelete.apply(uow, args);
   },
-  CREATE_BULK: function CREATE_BULK(uow, _ref6) {
-    var table = _ref6.table,
-        payload = _ref6.payload;
-    return uow.bulkCreate.call(uow, table, resolveOpResultValueReference(uow, payload));
-  },
-  SET_RELATION: function SET_RELATION(uow, _ref7) {
+  CREATE_BULK: function CREATE_BULK(uow, _ref7) {
     var table = _ref7.table,
         payload = _ref7.payload;
+    return uow.bulkCreate.call(uow, table, resolveOpResultValueReference(uow, payload));
+  },
+  UPSERT_BULK: function UPSERT_BULK(uow, _ref8) {
+    var table = _ref8.table,
+        payload = _ref8.payload;
+    return uow.bulkUpsert.call(uow, table, resolveOpResultValueReference(uow, payload));
+  },
+  SET_RELATION: function SET_RELATION(uow, _ref9) {
+    var table = _ref9.table,
+        payload = _ref9.payload;
     return updateRelations(uow, 'setRelation', {
       table: table,
       payload: payload
     });
   },
-  DELETE_RELATION: function DELETE_RELATION(uow, _ref8) {
-    var table = _ref8.table,
-        payload = _ref8.payload;
+  DELETE_RELATION: function DELETE_RELATION(uow, _ref10) {
+    var table = _ref10.table,
+        payload = _ref10.payload;
     return updateRelations(uow, 'deleteRelation', {
       table: table,
       payload: payload
     });
   },
-  ADD_RELATION: function ADD_RELATION(uow, _ref9) {
-    var table = _ref9.table,
-        payload = _ref9.payload;
+  ADD_RELATION: function ADD_RELATION(uow, _ref11) {
+    var table = _ref11.table,
+        payload = _ref11.payload;
     return updateRelations(uow, 'addToRelation', {
       table: table,
       payload: payload
     });
   },
-  FIND: function FIND(uow, _ref10) {
-    var table = _ref10.table,
-        payload = _ref10.payload;
+  FIND: function FIND(uow, _ref12) {
+    var table = _ref12.table,
+        payload = _ref12.payload;
     return uow.addOperations(_constants.OperationType.FIND, table, payload);
   }
 };
 exports.OperationJSONAdapter = OperationJSONAdapter;
 
-function baseBulkArgs(uow, _ref11) {
-  var table = _ref11.table,
-      payload = _ref11.payload;
+function baseBulkArgs(uow, _ref13) {
+  var table = _ref13.table,
+      payload = _ref13.payload;
   var args = [];
 
   if (payload.conditional) {
@@ -21262,9 +21604,9 @@ function baseBulkArgs(uow, _ref11) {
   return args;
 }
 
-function updateRelations(uow, method, _ref12) {
-  var table = _ref12.table,
-      payload = _ref12.payload;
+function updateRelations(uow, method, _ref14) {
+  var table = _ref14.table,
+      payload = _ref14.payload;
   var args = [table];
 
   if (typeof payload.parentObject === 'string') {
@@ -21629,6 +21971,11 @@ var Urls = /*#__PURE__*/function () {
     value: function dataTable(tableName) {
       return "".concat(this.data(), "/").concat(tableName);
     }
+  }, {
+    key: "dataTableUpsert",
+    value: function dataTableUpsert(tableName) {
+      return "".concat(this.data(), "/").concat(tableName, "/upsert");
+    }
   }, {
     key: "dataTableDeepSave",
     value: function dataTableDeepSave(tableName) {
@@ -21669,6 +22016,11 @@ var Urls = /*#__PURE__*/function () {
     value: function dataBulkTable(tableName) {
       return "".concat(this.data(), "/bulk/").concat(tableName);
     }
+  }, {
+    key: "dataBulkTableUpsert",
+    value: function dataBulkTableUpsert(tableName) {
+      return "".concat(this.data(), "/bulkupsert/").concat(tableName);
+    }
   }, {
     key: "dataBulkTableDelete",
     value: function dataBulkTableDelete(tableName) {
@@ -21801,6 +22153,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
 
   }, {