// A RestWrite encapsulates everything we need to run an operation // that writes to the database. // This could be either a "create" or an "update". import cache from './cache'; var deepcopy = require('deepcopy'); var Auth = require('./Auth'); var Config = require('./Config'); var cryptoUtils = require('./cryptoUtils'); var passwordCrypto = require('./password'); var oauth = require("./oauth"); var Parse = require('parse/node'); var triggers = require('./triggers'); // query and data are both provided in REST API format. So data // types are encoded by plain old objects. // If query is null, this is a "create" and the data in data should be // created. // Otherwise this is an "update" - the object matching the query // should get updated with data. // RestWrite will handle objectId, createdAt, and updatedAt for // everything. It also knows to use triggers and special modifications // for the _User class. function RestWrite(config, auth, className, query, data, originalData) { this.config = config; this.auth = auth; this.className = className; this.storage = {}; this.runOptions = {}; if (!query && data.objectId) { throw new Parse.Error(Parse.Error.INVALID_KEY_NAME, 'objectId ' + 'is an invalid field name.'); } // When the operation is complete, this.response may have several // fields. // response: the actual data to be returned // status: the http status code. if not present, treated like a 200 // location: the location header. if not present, no location header this.response = null; // Processing this operation may mutate our data, so we operate on a // copy this.query = deepcopy(query); this.data = deepcopy(data); // We never change originalData, so we do not need a deep copy this.originalData = originalData; // The timestamp we'll use for this whole operation this.updatedAt = Parse._encode(new Date()).iso; } // A convenient method to perform all the steps of processing the // write, in order. // Returns a promise for a {response, status, location} object. // status and location are optional. RestWrite.prototype.execute = function() { return Promise.resolve().then(() => { return this.getUserAndRoleACL(); }).then(() => { return this.validateClientClassCreation(); }).then(() => { return this.validateSchema(); }).then(() => { return this.handleInstallation(); }).then(() => { return this.handleSession(); }).then(() => { return this.validateAuthData(); }).then(() => { return this.runBeforeTrigger(); }).then(() => { return this.setRequiredFieldsIfNeeded(); }).then(() => { return this.transformUser(); }).then(() => { return this.expandFilesForExistingObjects(); }).then(() => { return this.runDatabaseOperation(); }).then(() => { return this.handleFollowup(); }).then(() => { return this.runAfterTrigger(); }).then(() => { return this.response; }); }; // Uses the Auth object to get the list of roles, adds the user id RestWrite.prototype.getUserAndRoleACL = function() { if (this.auth.isMaster) { return Promise.resolve(); } this.runOptions.acl = ['*']; if (this.auth.user) { return this.auth.getUserRoles().then((roles) => { roles.push(this.auth.user.id); this.runOptions.acl = this.runOptions.acl.concat(roles); return Promise.resolve(); }); }else{ return Promise.resolve(); } }; // Validates this operation against the allowClientClassCreation config. RestWrite.prototype.validateClientClassCreation = function() { let sysClass = ['_User', '_Installation', '_Role', '_Session', '_Product']; if (this.config.allowClientClassCreation === false && !this.auth.isMaster && sysClass.indexOf(this.className) === -1) { return this.config.database.loadSchema().then((schema) => { return schema.hasClass(this.className) }).then((hasClass) => { if (hasClass === true) { return Promise.resolve(); } throw new Parse.Error(Parse.Error.OPERATION_FORBIDDEN, 'This user is not allowed to access ' + 'non-existent class: ' + this.className); }); } else { return Promise.resolve(); } }; // Validates this operation against the schema. RestWrite.prototype.validateSchema = function() { return this.config.database.validateObject(this.className, this.data, this.query); }; // Runs any beforeSave triggers against this operation. // Any change leads to our data being mutated. RestWrite.prototype.runBeforeTrigger = function() { if (this.response) { return; } // Avoid doing any setup for triggers if there is no 'beforeSave' trigger for this class. if (!triggers.triggerExists(this.className, triggers.Types.beforeSave, this.config.applicationId)) { return Promise.resolve(); } // Cloud code gets a bit of extra data for its objects var extraData = {className: this.className}; if (this.query && this.query.objectId) { extraData.objectId = this.query.objectId; } let originalObject = null; let updatedObject = triggers.inflate(extraData, this.originalData); if (this.query && this.query.objectId) { // This is an update for existing object. originalObject = triggers.inflate(extraData, this.originalData); } updatedObject.set(Parse._decode(undefined, this.data)); return Promise.resolve().then(() => { return triggers.maybeRunTrigger(triggers.Types.beforeSave, this.auth, updatedObject, originalObject, this.config.applicationId); }).then((response) => { if (response && response.object) { this.data = response.object; // We should delete the objectId for an update write if (this.query && this.query.objectId) { delete this.data.objectId } } }); }; RestWrite.prototype.setRequiredFieldsIfNeeded = function() { if (this.data) { // Add default fields this.data.updatedAt = this.updatedAt; if (!this.query) { this.data.createdAt = this.updatedAt; this.data.objectId = cryptoUtils.newObjectId(); } } return Promise.resolve(); }; // Transforms auth data for a user object. // Does nothing if this isn't a user object. // Returns a promise for when we're done if it can't finish this tick. RestWrite.prototype.validateAuthData = function() { if (this.className !== '_User') { return; } if (!this.query && !this.data.authData) { if (typeof this.data.username !== 'string') { throw new Parse.Error(Parse.Error.USERNAME_MISSING, 'bad or missing username'); } if (typeof this.data.password !== 'string') { throw new Parse.Error(Parse.Error.PASSWORD_MISSING, 'password is required'); } } if (!this.data.authData || !Object.keys(this.data.authData).length) { return; } var authData = this.data.authData; var anonData = this.data.authData.anonymous; if (this.config.enableAnonymousUsers === true && (anonData === null || (anonData && anonData.id))) { return this.handleAnonymousAuthData(); } // Not anon, try other providers var providers = Object.keys(authData); if (!anonData && providers.length == 1) { var provider = providers[0]; var providerAuthData = authData[provider]; var hasToken = (providerAuthData && providerAuthData.id); if (providerAuthData === null || hasToken) { return this.handleOAuthAuthData(provider); } } throw new Parse.Error(Parse.Error.UNSUPPORTED_SERVICE, 'This authentication method is unsupported.'); }; RestWrite.prototype.handleAnonymousAuthData = function() { var anonData = this.data.authData.anonymous; if (anonData === null && this.query) { // We are unlinking the user from the anonymous provider this.data._auth_data_anonymous = null; return; } // Check if this user already exists return this.config.database.find( this.className, {'authData.anonymous.id': anonData.id}, {}) .then((results) => { if (results.length > 0) { if (!this.query) { // We're signing up, but this user already exists. Short-circuit delete results[0].password; this.response = { response: results[0], location: this.location() }; return; } // If this is a PUT for the same user, allow the linking if (results[0].objectId === this.query.objectId) { // Delete the rest format key before saving delete this.data.authData; return; } // We're trying to create a duplicate account. Forbid it throw new Parse.Error(Parse.Error.ACCOUNT_ALREADY_LINKED, 'this auth is already used'); } // This anonymous user does not already exist, so transform it // to a saveable format this.data._auth_data_anonymous = anonData; // Delete the rest format key before saving delete this.data.authData; }) }; RestWrite.prototype.handleOAuthAuthData = function(provider) { var authData = this.data.authData[provider]; if (authData === null && this.query) { // We are unlinking from the provider. this.data["_auth_data_" + provider ] = null; return; } var appIds; var oauthOptions = this.config.oauth[provider]; if (oauthOptions) { appIds = oauthOptions.appIds; } else if (provider == "facebook") { appIds = this.config.facebookAppIds; } var validateAuthData; var validateAppId; if (oauth[provider]) { validateAuthData = oauth[provider].validateAuthData; validateAppId = oauth[provider].validateAppId; } // Try the configuration methods if (oauthOptions) { if (oauthOptions.module) { validateAuthData = require(oauthOptions.module).validateAuthData; validateAppId = require(oauthOptions.module).validateAppId; }; if (oauthOptions.validateAuthData) { validateAuthData = oauthOptions.validateAuthData; } if (oauthOptions.validateAppId) { validateAppId = oauthOptions.validateAppId; } } // try the custom provider first, fallback on the oauth implementation if (!validateAuthData || !validateAppId) { return false; }; return validateAuthData(authData, oauthOptions) .then(() => { if (appIds && typeof validateAppId === "function") { return validateAppId(appIds, authData, oauthOptions); } // No validation required by the developer return Promise.resolve(); }).then(() => { // Check if this user already exists // TODO: does this handle re-linking correctly? var query = {}; query['authData.' + provider + '.id'] = authData.id; return this.config.database.find( this.className, query, {}); }).then((results) => { this.storage['authProvider'] = provider; if (results.length > 0) { if (!this.query) { // We're signing up, but this user already exists. Short-circuit delete results[0].password; this.response = { response: results[0], location: this.location() }; this.data.objectId = results[0].objectId; return; } // If this is a PUT for the same user, allow the linking if (results[0].objectId === this.query.objectId) { // Delete the rest format key before saving delete this.data.authData; return; } // We're trying to create a duplicate oauth auth. Forbid it throw new Parse.Error(Parse.Error.ACCOUNT_ALREADY_LINKED, 'this auth is already used'); } else { this.data.username = cryptoUtils.newToken(); } // This FB auth does not already exist, so transform it to a // saveable format this.data["_auth_data_" + provider ] = authData; // Delete the rest format key before saving delete this.data.authData; }); } // The non-third-party parts of User transformation RestWrite.prototype.transformUser = function() { if (this.className !== '_User') { return; } var promise = Promise.resolve(); if (!this.query) { var token = 'r:' + cryptoUtils.newToken(); this.storage['token'] = token; promise = promise.then(() => { var expiresAt = new Date(); expiresAt.setFullYear(expiresAt.getFullYear() + 1); var sessionData = { sessionToken: token, user: { __type: 'Pointer', className: '_User', objectId: this.objectId() }, createdWith: { 'action': 'login', 'authProvider': this.storage['authProvider'] || 'password' }, restricted: false, installationId: this.data.installationId, expiresAt: Parse._encode(expiresAt) }; if (this.response && this.response.response) { this.response.response.sessionToken = token; } var create = new RestWrite(this.config, Auth.master(this.config), '_Session', null, sessionData); return create.execute(); }); } return promise.then(() => { // Transform the password if (!this.data.password) { return; } if (this.query && !this.auth.isMaster ) { this.storage['clearSessions'] = true; } return passwordCrypto.hash(this.data.password).then((hashedPassword) => { this.data._hashed_password = hashedPassword; delete this.data.password; }); }).then(() => { // Check for username uniqueness if (!this.data.username) { if (!this.query) { this.data.username = cryptoUtils.randomString(25); } return; } return this.config.database.find( this.className, { username: this.data.username, objectId: {'$ne': this.objectId()} }, {limit: 1}).then((results) => { if (results.length > 0) { throw new Parse.Error(Parse.Error.USERNAME_TAKEN, 'Account already exists for this username'); } return Promise.resolve(); }); }).then(() => { if (!this.data.email) { return; } // Validate basic email address format if (!this.data.email.match(/^.+@.+$/)) { throw new Parse.Error(Parse.Error.INVALID_EMAIL_ADDRESS, 'Email address format is invalid.'); } // Check for email uniqueness return this.config.database.find( this.className, { email: this.data.email, objectId: {'$ne': this.objectId()} }, {limit: 1}).then((results) => { if (results.length > 0) { throw new Parse.Error(Parse.Error.EMAIL_TAKEN, 'Account already exists for this email ' + 'address'); } return Promise.resolve(); }); }); }; // Handles any followup logic RestWrite.prototype.handleFollowup = function() { if (this.storage && this.storage['clearSessions']) { var sessionQuery = { user: { __type: 'Pointer', className: '_User', objectId: this.objectId() } }; delete this.storage['clearSessions']; return this.config.database.destroy('_Session', sessionQuery) .then(this.handleFollowup.bind(this)); } }; // Handles the _Role class specialness. // Does nothing if this isn't a role object. RestWrite.prototype.handleRole = function() { if (this.response || this.className !== '_Role') { return; } if (!this.auth.user && !this.auth.isMaster) { throw new Parse.Error(Parse.Error.INVALID_SESSION_TOKEN, 'Session token required.'); } if (!this.data.name) { throw new Parse.Error(Parse.Error.INVALID_ROLE_NAME, 'Invalid role name.'); } }; // Handles the _Session class specialness. // Does nothing if this isn't an installation object. RestWrite.prototype.handleSession = function() { if (this.response || this.className !== '_Session') { return; } if (!this.auth.user && !this.auth.isMaster) { throw new Parse.Error(Parse.Error.INVALID_SESSION_TOKEN, 'Session token required.'); } // TODO: Verify proper error to throw if (this.data.ACL) { throw new Parse.Error(Parse.Error.INVALID_KEY_NAME, 'Cannot set ' + 'ACL on a Session.'); } if (!this.query && !this.auth.isMaster) { var token = 'r:' + cryptoUtils.newToken(); var expiresAt = new Date(); expiresAt.setFullYear(expiresAt.getFullYear() + 1); var sessionData = { sessionToken: token, user: { __type: 'Pointer', className: '_User', objectId: this.auth.user.id }, createdWith: { 'action': 'create' }, restricted: true, expiresAt: Parse._encode(expiresAt) }; for (var key in this.data) { if (key == 'objectId') { continue; } sessionData[key] = this.data[key]; } var create = new RestWrite(this.config, Auth.master(this.config), '_Session', null, sessionData); return create.execute().then((results) => { if (!results.response) { throw new Parse.Error(Parse.Error.INTERNAL_SERVER_ERROR, 'Error creating session.'); } sessionData['objectId'] = results.response['objectId']; this.response = { status: 201, location: results.location, response: sessionData }; }); } }; // Handles the _Installation class specialness. // Does nothing if this isn't an installation object. // If an installation is found, this can mutate this.query and turn a create // into an update. // Returns a promise for when we're done if it can't finish this tick. RestWrite.prototype.handleInstallation = function() { if (this.response || this.className !== '_Installation') { return; } if (!this.query && !this.data.deviceToken && !this.data.installationId) { throw new Parse.Error(135, 'at least one ID field (deviceToken, installationId) ' + 'must be specified in this operation'); } if (!this.query && !this.data.deviceType) { throw new Parse.Error(135, 'deviceType must be specified in this operation'); } // If the device token is 64 characters long, we assume it is for iOS // and lowercase it. if (this.data.deviceToken && this.data.deviceToken.length == 64) { this.data.deviceToken = this.data.deviceToken.toLowerCase(); } // TODO: We may need installationId from headers, plumb through Auth? // per installation_handler.go // We lowercase the installationId if present if (this.data.installationId) { this.data.installationId = this.data.installationId.toLowerCase(); } var promise = Promise.resolve(); var idMatch; // Will be a match on either objectId or installationId var deviceTokenMatches = []; if (this.query && this.query.objectId) { promise = promise.then(() => { return this.config.database.find('_Installation', { objectId: this.query.objectId }, {}).then((results) => { if (!results.length) { throw new Parse.Error(Parse.Error.OBJECT_NOT_FOUND, 'Object not found for update.'); } idMatch = results[0]; if (this.data.installationId && idMatch.installationId && this.data.installationId !== idMatch.installationId) { throw new Parse.Error(136, 'installationId may not be changed in this ' + 'operation'); } if (this.data.deviceToken && idMatch.deviceToken && this.data.deviceToken !== idMatch.deviceToken && !this.data.installationId && !idMatch.installationId) { throw new Parse.Error(136, 'deviceToken may not be changed in this ' + 'operation'); } if (this.data.deviceType && this.data.deviceType && this.data.deviceType !== idMatch.deviceType) { throw new Parse.Error(136, 'deviceType may not be changed in this ' + 'operation'); } return Promise.resolve(); }); }); } // Check if we already have installations for the installationId/deviceToken promise = promise.then(() => { if (this.data.installationId) { return this.config.database.find('_Installation', { 'installationId': this.data.installationId }); } return Promise.resolve([]); }).then((results) => { if (results && results.length) { // We only take the first match by installationId idMatch = results[0]; } if (this.data.deviceToken) { return this.config.database.find( '_Installation', {'deviceToken': this.data.deviceToken}); } return Promise.resolve([]); }).then((results) => { if (results) { deviceTokenMatches = results; } if (!idMatch) { if (!deviceTokenMatches.length) { return; } else if (deviceTokenMatches.length == 1 && (!deviceTokenMatches[0]['installationId'] || !this.data.installationId) ) { // Single match on device token but none on installationId, and either // the passed object or the match is missing an installationId, so we // can just return the match. return deviceTokenMatches[0]['objectId']; } else if (!this.data.installationId) { throw new Parse.Error(132, 'Must specify installationId when deviceToken ' + 'matches multiple Installation objects'); } else { // Multiple device token matches and we specified an installation ID, // or a single match where both the passed and matching objects have // an installation ID. Try cleaning out old installations that match // the deviceToken, and return nil to signal that a new object should // be created. var delQuery = { 'deviceToken': this.data.deviceToken, 'installationId': { '$ne': this.data.installationId } }; if (this.data.appIdentifier) { delQuery['appIdentifier'] = this.data.appIdentifier; } this.config.database.destroy('_Installation', delQuery); return; } } else { if (deviceTokenMatches.length == 1 && !deviceTokenMatches[0]['installationId']) { // Exactly one device token match and it doesn't have an installation // ID. This is the one case where we want to merge with the existing // object. var delQuery = {objectId: idMatch.objectId}; return this.config.database.destroy('_Installation', delQuery) .then(() => { return deviceTokenMatches[0]['objectId']; }); } else { if (this.data.deviceToken && idMatch.deviceToken != this.data.deviceToken) { // We're setting the device token on an existing installation, so // we should try cleaning out old installations that match this // device token. var delQuery = { 'deviceToken': this.data.deviceToken, 'installationId': { '$ne': this.data.installationId } }; if (this.data.appIdentifier) { delQuery['appIdentifier'] = this.data.appIdentifier; } this.config.database.destroy('_Installation', delQuery); } // In non-merge scenarios, just return the installation match id return idMatch.objectId; } } }).then((objId) => { if (objId) { this.query = {objectId: objId}; delete this.data.objectId; delete this.data.createdAt; } // TODO: Validate ops (add/remove on channels, $inc on badge, etc.) }); return promise; }; // If we short-circuted the object response - then we need to make sure we expand all the files, // since this might not have a query, meaning it won't return the full result back. // TODO: (nlutsenko) This should die when we move to per-class based controllers on _Session/_User RestWrite.prototype.expandFilesForExistingObjects = function() { // Check whether we have a short-circuited response - only then run expansion. if (this.response && this.response.response) { this.config.filesController.expandFilesInObject(this.config, this.response.response); } }; RestWrite.prototype.runDatabaseOperation = function() { if (this.response) { return; } if (this.className === '_User' && this.query && !this.auth.couldUpdateUserId(this.query.objectId)) { throw new Parse.Error(Parse.Error.SESSION_MISSING, 'cannot modify user ' + this.query.objectId); } if (this.className === '_Product' && this.data.download) { this.data.downloadName = this.data.download.name; } // TODO: Add better detection for ACL, ensuring a user can't be locked from // their own user record. if (this.data.ACL && this.data.ACL['*unresolved']) { throw new Parse.Error(Parse.Error.INVALID_ACL, 'Invalid ACL.'); } if (this.query) { // Run an update return this.config.database.update( this.className, this.query, this.data, this.runOptions).then((resp) => { this.response = resp; this.response.updatedAt = this.updatedAt; }); } else { // Set the default ACL for the new _User if (!this.data.ACL && this.className === '_User') { var ACL = {}; ACL[this.data.objectId] = { read: true, write: true }; ACL['*'] = { read: true, write: false }; this.data.ACL = ACL; } // Run a create return this.config.database.create(this.className, this.data, this.runOptions) .then(() => { var resp = { objectId: this.data.objectId, createdAt: this.data.createdAt }; if (this.storage['token']) { resp.sessionToken = this.storage['token']; } this.response = { status: 201, response: resp, location: this.location() }; }); } }; // Returns nothing - doesn't wait for the trigger. RestWrite.prototype.runAfterTrigger = function() { var extraData = {className: this.className}; if (this.query && this.query.objectId) { extraData.objectId = this.query.objectId; } // Build the inflated object, different from beforeSave, originalData is not empty // since developers can change data in the beforeSave. var inflatedObject = triggers.inflate(extraData, this.originalData); inflatedObject._finishFetch(this.data); // Build the original object, we only do this for a update write. var originalObject; if (this.query && this.query.objectId) { originalObject = triggers.inflate(extraData, this.originalData); } triggers.maybeRunTrigger(triggers.Types.afterSave, this.auth, inflatedObject, originalObject, this.config.applicationId); }; // A helper to figure out what location this operation happens at. RestWrite.prototype.location = function() { var middle = (this.className === '_User' ? '/users/' : '/classes/' + this.className + '/'); return this.config.mount + middle + this.data.objectId; }; // A helper to get the object id for this operation. // Because it could be either on the query or on the data RestWrite.prototype.objectId = function() { return this.data.objectId || this.query.objectId; }; module.exports = RestWrite;