backendless 6.2.25 → 6.3.3

package/lib/index.js

@@ -7,6 +7,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
@@ -21,6 +23,10 @@ var _urls = _interopRequireDefault(require("./urls"));
 
 var _utils = _interopRequireDefault(require("./utils"));
 
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
 var DEFAULT_PROPS = {
   appId: null,
   apiKey: null,
@@ -71,6 +77,14 @@ var parseInitConfig = function parseInitConfig() {
   };
 };
 
+var validateConfig = function validateConfig(config) {
+  if (config.domain) {
+    if (!config.domain.startsWith('https://') && !config.domain.startsWith('http://')) {
+      throw new Error('When initialize the SDK with a custom domain it should start with http:// or https://, ' + 'for example: Backendless.initApp(\'https://foobar.com\')');
+    }
+  }
+};
+
 var SERVICES = {
   'Logging': function Logging() {
     return require('./logging')["default"];
@@ -129,6 +143,13 @@ var Backendless = /*#__PURE__*/function () {
   (0, _createClass2["default"])(Backendless, [{
     key: "initConfig",
     value: function initConfig(config) {
+      config = _objectSpread({}, config);
+
+      if (config.domain) {
+        delete config.appId;
+        delete config.apiKey;
+      }
+
       for (var key in DEFAULT_PROPS) {
         if (DEFAULT_PROPS.hasOwnProperty(key)) {
           var privateKey = "__".concat(key);
@@ -144,7 +165,7 @@ var Backendless = /*#__PURE__*/function () {
     }
     /**
      * @param {string|Object} appId|domain|config
-     * @param {string} [secretKey]
+     * @param {string} [apiKey]
      * @returns {Backendless}
      */
 
@@ -152,6 +173,7 @@ var Backendless = /*#__PURE__*/function () {
     key: "initApp",
     value: function initApp() {
       var config = parseInitConfig.apply(void 0, arguments);
+      validateConfig(config);
       var app = config.standalone ? new Backendless(this) : this;
       app.initConfig(config);
       app.resetRT();
@@ -200,24 +222,22 @@ var Backendless = /*#__PURE__*/function () {
     },
     set: function set(standalone) {
       throw new Error('Setting value to Backendless.standalone directly is not possible, ' + "instead you must use Backendless.initApp({ appId: [APP_ID], apiKey: [API_KEY], standalone: ".concat(standalone, " })"));
-    } ///--------applicationId-------///
-
+    }
   }, {
-    key: "applicationId",
+    key: "appId",
     get: function get() {
       return this.__appId;
     },
     set: function set(appId) {
-      throw new Error("Setting '".concat(appId, "' value to Backendless.applicationId directly is not possible, ") + "instead you must use Backendless.initApp('".concat(appId, "', API_KEY)"));
-    } ///--------secretKey-------///
-
+      throw new Error("Setting '".concat(appId, "' value to Backendless.appId directly is not possible, ") + "instead you must use Backendless.initApp('".concat(appId, "', API_KEY)"));
+    }
   }, {
-    key: "secretKey",
+    key: "apiKey",
     get: function get() {
       return this.__apiKey;
     },
     set: function set(apiKey) {
-      throw new Error("Setting '".concat(apiKey, "' value to Backendless.secretKey directly is not possible, ") + "instead you must use Backendless.initApp(APP_ID, '".concat(apiKey, "')"));
+      throw new Error("Setting '".concat(apiKey, "' value to Backendless.apiKey directly is not possible, ") + "instead you must use Backendless.initApp(APP_ID, '".concat(apiKey, "')"));
     } ///--------serverURL-------///
 
   }, {
@@ -254,7 +274,7 @@ var Backendless = /*#__PURE__*/function () {
         return this.domain + this.apiURI;
       }
 
-      return [this.serverURL, this.applicationId, this.secretKey].join('/');
+      return [this.serverURL, this.appId, this.apiKey].join('/');
     },
     set: function set(appPath) {
       throw new Error("Setting '".concat(appPath, "' value to Backendless.appPath directly is not possible, ") + 'instead you must use Backendless.initApp(APP_ID, API_KEY) for setup the value');
@@ -439,10 +459,42 @@ var Backendless = /*#__PURE__*/function () {
     ///-------------------------------------///
     ///-------------------------------------///
     ///--------BACKWARD COMPATIBILITY-------///
-    //TODO: do we need to remove it?
 
     /** @deprecated */
 
+  }, {
+    key: "applicationId",
+    get: function get() {
+      // eslint-disable-next-line no-console
+      // temporary comment it because it breaks JS-CodeRunner version less than 6.3.0
+      // console.warn('getter/setter for Backendless.applicationId is deprecated, instead use Backendless.appId')
+      return this.appId;
+    }
+    /** @deprecated */
+    ,
+    set: function set(appId) {
+      // eslint-disable-next-line no-console
+      console.warn('getter/setter for Backendless.applicationId is deprecated, instead use Backendless.appId');
+      this.appId = appId;
+    }
+    /** @deprecated */
+
+  }, {
+    key: "secretKey",
+    get: function get() {
+      // eslint-disable-next-line no-console
+      console.warn('getter/setter for Backendless.secretKey is deprecated, instead use Backendless.apiKey');
+      return this.apiKey;
+    }
+    /** @deprecated */
+    ,
+    set: function set(apiKey) {
+      // eslint-disable-next-line no-console
+      console.warn('getter/setter for Backendless.secretKey is deprecated, instead use Backendless.apiKey');
+      this.apiKey = apiKey;
+    }
+    /** @deprecated */
+
   }, {
     key: "Persistence",
     get: function get() {

package/lib/local-cache/index.js

@@ -23,7 +23,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.applicationId);
+    this.storageName = "".concat(STORAGE_KEY_NAMESPACE, "_").concat(this.app.appId);
     var Storage = _utils["default"].isLocalStorageSupported ? _localStorage["default"] : _virtualStorage["default"];
     this.setStorage(Storage);
     this.Keys = {

package/lib/messaging/helpers/email-envelope.js

@@ -21,6 +21,7 @@ var EmailEnvelope = /*#__PURE__*/function () {
     this.ccAddresses = _utils["default"].castArray(data.ccAddresses);
     this.bccAddresses = _utils["default"].castArray(data.bccAddresses);
     this.query = data.query || null;
+    this.uniqueEmails = data.uniqueEmails || false;
   }
   /**
    *
@@ -147,6 +148,26 @@ var EmailEnvelope = /*#__PURE__*/function () {
     value: function getQuery() {
       return this.query;
     }
+    /**
+     * @param {boolean} uniqueEmails
+     * @returns {EmailEnvelope}
+     */
+
+  }, {
+    key: "setUniqueEmails",
+    value: function setUniqueEmails(uniqueEmails) {
+      this.uniqueEmails = uniqueEmails;
+      return this;
+    }
+    /**
+     * @returns {uniqueEmails|boolean}
+     */
+
+  }, {
+    key: "getUniqueEmails",
+    value: function getUniqueEmails() {
+      return this.uniqueEmails;
+    }
   }, {
     key: "toJSON",
     value: function toJSON() {
@@ -168,6 +189,7 @@ var EmailEnvelope = /*#__PURE__*/function () {
         data.criteria = this.query;
       }
 
+      data.uniqueEmails = this.uniqueEmails;
       return data;
     }
   }], [{

package/lib/messaging/index.js

@@ -247,10 +247,14 @@ var Messaging = /*#__PURE__*/function () {
                 data = envelopeObject.toJSON();
                 data['template-name'] = templateName;
 
-                if (templateValues) {
+                if (templateValues && !Array.isArray(templateValues)) {
                   data['template-values'] = templateValues;
                 }
 
+                if (Array.isArray(templateValues) && !attachments) {
+                  attachments = templateValues;
+                }
+
                 if (attachments) {
                   data.attachment = attachments;
                 }
@@ -260,7 +264,7 @@ var Messaging = /*#__PURE__*/function () {
                   data: data
                 }));
 
-              case 9:
+              case 10:
               case "end":
                 return _context4.stop();
             }

package/lib/rt.js

@@ -7,6 +7,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = exports.RTScopeConnector = exports.RTListeners = void 0;
 
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
@@ -17,6 +21,8 @@ var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime
 
 var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf"));
 
+var _backendlessRequest = _interopRequireDefault(require("backendless-request"));
+
 var _backendlessRtClient = _interopRequireDefault(require("backendless-rt-client"));
 
 var _utils = _interopRequireDefault(require("./utils"));
@@ -30,6 +36,10 @@ exports.RTListeners = RTListeners;
 var RTScopeConnector = _backendlessRtClient["default"].ScopeConnector;
 exports.RTScopeConnector = RTScopeConnector;
 
+function loadAppInfo(appPath) {
+  return _backendlessRequest["default"].get("".concat(appPath, "/info"));
+}
+
 var RT = /*#__PURE__*/function (_BackendlessRTClient) {
   (0, _inherits2["default"])(RT, _BackendlessRTClient);
 
@@ -39,8 +49,8 @@ var RT = /*#__PURE__*/function (_BackendlessRTClient) {
     var _this;
 
     (0, _classCallCheck2["default"])(this, RT);
-    var appId = app.applicationId,
-        apiKey = app.secretKey,
+    var appId = app.appId,
+        apiKey = app.apiKey,
         appPath = app.appPath,
         debugMode = app.debugMode;
 
@@ -48,17 +58,55 @@ var RT = /*#__PURE__*/function (_BackendlessRTClient) {
 
     var lookupPath = "".concat(appPath, "/rt/lookup");
     _this = _super.call(this, {
-      appId: appId,
+      appId: appId || undefined,
       lookupPath: lookupPath,
       debugMode: debugMode,
       connectQuery: function connectQuery() {
         var userToken = app.getCurrentUserToken();
         return {
-          apiKey: apiKey,
+          apiKey: apiKey || undefined,
           clientId: clientId,
           userToken: userToken
         };
-      }
+      },
+      socketConfigTransform: function () {
+        var _socketConfigTransform = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee(socketConfig) {
+          var appInfo;
+          return _regenerator["default"].wrap(function _callee$(_context) {
+            while (1) {
+              switch (_context.prev = _context.next) {
+                case 0:
+                  if (appId) {
+                    _context.next = 7;
+                    break;
+                  }
+
+                  _context.next = 3;
+                  return loadAppInfo(appPath);
+
+                case 3:
+                  appInfo = _context.sent;
+                  socketConfig.url = "".concat(socketConfig.host, "/").concat(appInfo.appId);
+                  socketConfig.options.path = "/".concat(appInfo.appId);
+                  socketConfig.options.query.apiKey = appInfo.apiKey;
+
+                case 7:
+                  return _context.abrupt("return", socketConfig);
+
+                case 8:
+                case "end":
+                  return _context.stop();
+              }
+            }
+          }, _callee);
+        }));
+
+        function socketConfigTransform(_x) {
+          return _socketConfigTransform.apply(this, arguments);
+        }
+
+        return socketConfigTransform;
+      }()
     });
     _this.app = app;
     return _this;

package/lib/unit-of-work/constants.js

@@ -11,6 +11,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',

package/lib/unit-of-work/index.js

@@ -308,6 +308,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;
@@ -436,6 +467,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;

package/lib/unit-of-work/json-adapter.js

@@ -63,9 +63,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
@@ -73,55 +78,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) {
@@ -141,9 +151,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') {

package/lib/urls.js

@@ -142,6 +142,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) {
@@ -182,6 +187,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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backendless",
-  "version": "6.2.25",
+  "version": "6.3.3",
   "description": "Backendless JavaScript SDK for Node.js and the browser",
   "browser": "dist/backendless.js",
   "main": "lib/index.js",
@@ -92,6 +92,6 @@
   "dependencies": {
     "@babel/runtime": "^7.14.6",
     "backendless-request": "^0.1.1",
-    "backendless-rt-client": "0.0.24"
+    "backendless-rt-client": "0.0.25"
   }
 }

package/src/data/rt-handlers.js

@@ -1,13 +1,15 @@
 import { RTListeners } from '../rt'
 
 const ChangesTypes = {
-  CREATED: 'created',
-  UPDATED: 'updated',
-  DELETED: 'deleted',
-
-  BULK_CREATED: 'bulk-created',
-  BULK_UPDATED: 'bulk-updated',
-  BULK_DELETED: 'bulk-deleted',
+  CREATED : 'created',
+  UPDATED : 'updated',
+  DELETED : 'deleted',
+  UPSERTED: 'upserted',
+
+  BULK_CREATED : 'bulk-created',
+  BULK_UPDATED : 'bulk-updated',
+  BULK_DELETED : 'bulk-deleted',
+  BULK_UPSERTED: 'bulk-upserted',
 }
 
 const RelationsChangesTypes = {
@@ -20,6 +22,7 @@ const SingleChangesTypes = [
   ChangesTypes.CREATED,
   ChangesTypes.UPDATED,
   ChangesTypes.DELETED,
+  ChangesTypes.UPSERTED,
 ]
 
 export default class RTHandlers extends RTListeners {
@@ -53,6 +56,22 @@ export default class RTHandlers extends RTListeners {
     this.removeCreateListeners(undefined, callback)
   }
 
+  addUpsertListener(whereClause, callback, onError) {
+    this.addChangesListener(ChangesTypes.UPSERTED, whereClause, callback, onError)
+  }
+
+  removeUpsertListeners(whereClause, callback) {
+    this.removeChangesListeners(ChangesTypes.UPSERTED, whereClause, callback)
+  }
+
+  removeUpsertListener(callback) {
+    if (!callback || typeof callback !== 'function') {
+      throw new Error('Listener Function must be passed.')
+    }
+
+    this.removeUpsertListeners(undefined, callback)
+  }
+
   addUpdateListener(whereClause, callback, onError) {
     this.addChangesListener(ChangesTypes.UPDATED, whereClause, callback, onError)
   }
@@ -133,6 +152,22 @@ export default class RTHandlers extends RTListeners {
     this.removeBulkDeleteListeners(undefined, callback)
   }
 
+  addBulkUpsertListener(whereClause, callback, onError) {
+    this.addChangesListener(ChangesTypes.BULK_UPSERTED, whereClause, callback, onError)
+  }
+
+  removeBulkUpsertListeners() {
+    this.removeChangesListeners(ChangesTypes.BULK_UPSERTED)
+  }
+
+  removeBulkUpsertListener(callback) {
+    if (!callback || typeof callback !== 'function') {
+      throw new Error('Listener Function must be passed.')
+    }
+
+    this.removeChangesListeners(ChangesTypes.BULK_UPSERTED, undefined, callback)
+  }
+
   addSetRelationListener(relationColumnName, parentObjects, callback, onError) {
     this.addRelationsChangesListener(RelationsChangesTypes.SET, relationColumnName, parentObjects, callback, onError)
   }

package/src/data/store.js

@@ -48,10 +48,14 @@ export default class DataStore {
     return this.rtHandlers = this.rtHandlers || new RTHandlers(this)
   }
 
-  async save(object) {
+  async save(object, isUpsert) {
+    const url = isUpsert
+      ? this.app.urls.dataTableUpsert(this.className)
+      : this.app.urls.dataTable(this.className)
+
     return this.app.request
       .put({
-        url : this.app.urls.dataTable(this.className),
+        url,
         data: convertToServerRecord(object),
       })
       .then(result => this.parseResponse(result))
@@ -229,6 +233,27 @@ export default class DataStore {
     })
   }
 
+  async bulkUpsert(objects) {
+    const errorMessage = 'Objects must be provided and must be an array of objects.'
+
+    if (!objects || !Array.isArray(objects) || !objects.length) {
+      throw new Error(errorMessage)
+    }
+
+    objects = objects.map(object => {
+      if (!object || typeof object !== 'object' || Array.isArray(object)) {
+        throw new Error(errorMessage)
+      }
+
+      return object
+    })
+
+    return this.app.request.put({
+      url : this.app.urls.dataBulkTableUpsert(this.className),
+      data: objects,
+    })
+  }
+
   async bulkUpdate(condition, changes) {
     if (!condition || typeof condition !== 'string') {
       throw new Error('Condition must be provided and must be a string.')