12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232 |
- "use strict";
- Object.defineProperty(exports, "__esModule", {
- value: true
- });
- exports.default = void 0;
- var _CoreManager = _interopRequireDefault(require("./CoreManager"));
- var _isRevocableSession = _interopRequireDefault(require("./isRevocableSession"));
- var _ParseError = _interopRequireDefault(require("./ParseError"));
- var _ParseObject = _interopRequireDefault(require("./ParseObject"));
- var _Storage = _interopRequireDefault(require("./Storage"));
- function _interopRequireDefault(e) {
- return e && e.__esModule ? e : {
- default: e
- };
- }
- const CURRENT_USER_KEY = 'currentUser';
- let canUseCurrentUser = !_CoreManager.default.get('IS_NODE');
- let currentUserCacheMatchesDisk = false;
- let currentUserCache = null;
- const authProviders = {};
- /**
- * <p>A Parse.User object is a local representation of a user persisted to the
- * Parse cloud. This class is a subclass of a Parse.Object, and retains the
- * same functionality of a Parse.Object, but also extends it with various
- * user specific methods, like authentication, signing up, and validation of
- * uniqueness.</p>
- *
- * @alias Parse.User
- * @augments Parse.Object
- */
- class ParseUser extends _ParseObject.default {
- /**
- * @param {object} attributes The initial set of data to store in the user.
- */
- constructor(attributes) {
- super('_User');
- if (attributes && typeof attributes === 'object') {
- if (!this.set(attributes || {})) {
- throw new Error("Can't create an invalid Parse User");
- }
- }
- }
- /**
- * Request a revocable session token to replace the older style of token.
- *
- * @param {object} options
- * @returns {Promise} A promise that is resolved when the replacement
- * token has been fetched.
- */
- _upgradeToRevocableSession(options) {
- options = options || {};
- const upgradeOptions = {};
- if (options.hasOwnProperty('useMasterKey')) {
- upgradeOptions.useMasterKey = options.useMasterKey;
- }
- const controller = _CoreManager.default.getUserController();
- return controller.upgradeToRevocableSession(this, upgradeOptions);
- }
- /**
- * Parse allows you to link your users with {@link https://docs.parseplatform.org/parse-server/guide/#oauth-and-3rd-party-authentication 3rd party authentication}, enabling
- * your users to sign up or log into your application using their existing identities.
- * Since 2.9.0
- *
- * @see {@link https://docs.parseplatform.org/js/guide/#linking-users Linking Users}
- * @param {string | AuthProvider} provider Name of auth provider or {@link https://parseplatform.org/Parse-SDK-JS/api/master/AuthProvider.html AuthProvider}
- * @param {object} options
- * @param {object} [options.authData] AuthData to link with
- * <ul>
- * <li>If provider is string, options is {@link http://docs.parseplatform.org/parse-server/guide/#supported-3rd-party-authentications authData}
- * <li>If provider is AuthProvider, options is saveOpts
- * </ul>
- * @param {object} saveOpts useMasterKey / sessionToken
- * @returns {Promise} A promise that is fulfilled with the user is linked
- */
- linkWith(provider, options, saveOpts = {}) {
- saveOpts.sessionToken = saveOpts.sessionToken || this.getSessionToken() || '';
- let authType;
- if (typeof provider === 'string') {
- authType = provider;
- if (authProviders[provider]) {
- provider = authProviders[provider];
- } else {
- const authProvider = {
- restoreAuthentication() {
- return true;
- },
- getAuthType() {
- return authType;
- }
- };
- authProviders[authProvider.getAuthType()] = authProvider;
- provider = authProvider;
- }
- } else {
- authType = provider.getAuthType();
- }
- if (options && options.hasOwnProperty('authData')) {
- const authData = this.get('authData') || {};
- if (typeof authData !== 'object') {
- throw new Error('Invalid type: authData field should be an object');
- }
- authData[authType] = options.authData;
- const oldAnonymousData = authData.anonymous;
- this.stripAnonymity();
- const controller = _CoreManager.default.getUserController();
- return controller.linkWith(this, authData, saveOpts).catch(e => {
- delete authData[authType];
- this.restoreAnonimity(oldAnonymousData);
- throw e;
- });
- } else {
- return new Promise((resolve, reject) => {
- provider.authenticate({
- success: (provider, result) => {
- const opts = {};
- opts.authData = result;
- this.linkWith(provider, opts, saveOpts).then(() => {
- resolve(this);
- }, error => {
- reject(error);
- });
- },
- error: (provider, error) => {
- reject(error);
- }
- });
- });
- }
- }
- /**
- * @param provider
- * @param options
- * @param {object} [options.authData]
- * @param saveOpts
- * @deprecated since 2.9.0 see {@link https://parseplatform.org/Parse-SDK-JS/api/master/Parse.User.html#linkWith linkWith}
- * @returns {Promise}
- */
- _linkWith(provider, options, saveOpts = {}) {
- return this.linkWith(provider, options, saveOpts);
- }
- /**
- * Synchronizes auth data for a provider (e.g. puts the access token in the
- * right place to be used by the Facebook SDK).
- *
- * @param provider
- */
- _synchronizeAuthData(provider) {
- if (!this.isCurrent() || !provider) {
- return;
- }
- let authType;
- if (typeof provider === 'string') {
- authType = provider;
- provider = authProviders[authType];
- } else {
- authType = provider.getAuthType();
- }
- const authData = this.get('authData');
- if (!provider || !authData || typeof authData !== 'object') {
- return;
- }
- const success = provider.restoreAuthentication(authData[authType]);
- if (!success) {
- this._unlinkFrom(provider);
- }
- }
- /**
- * Synchronizes authData for all providers.
- */
- _synchronizeAllAuthData() {
- const authData = this.get('authData');
- if (typeof authData !== 'object') {
- return;
- }
- for (const key in authData) {
- this._synchronizeAuthData(key);
- }
- }
- /**
- * Removes null values from authData (which exist temporarily for unlinking)
- */
- _cleanupAuthData() {
- if (!this.isCurrent()) {
- return;
- }
- const authData = this.get('authData');
- if (typeof authData !== 'object') {
- return;
- }
- for (const key in authData) {
- if (!authData[key]) {
- delete authData[key];
- }
- }
- }
- /**
- * Unlinks a user from a service.
- *
- * @param {string | AuthProvider} provider Name of auth provider or {@link https://parseplatform.org/Parse-SDK-JS/api/master/AuthProvider.html AuthProvider}
- * @param {object} options MasterKey / SessionToken
- * @returns {Promise} A promise that is fulfilled when the unlinking
- * finishes.
- */
- _unlinkFrom(provider, options) {
- return this.linkWith(provider, {
- authData: null
- }, options).then(() => {
- this._synchronizeAuthData(provider);
- return Promise.resolve(this);
- });
- }
- /**
- * Checks whether a user is linked to a service.
- *
- * @param {object} provider service to link to
- * @returns {boolean} true if link was successful
- */
- _isLinked(provider) {
- let authType;
- if (typeof provider === 'string') {
- authType = provider;
- } else {
- authType = provider.getAuthType();
- }
- const authData = this.get('authData') || {};
- if (typeof authData !== 'object') {
- return false;
- }
- return !!authData[authType];
- }
- /**
- * Deauthenticates all providers.
- */
- _logOutWithAll() {
- const authData = this.get('authData');
- if (typeof authData !== 'object') {
- return;
- }
- for (const key in authData) {
- this._logOutWith(key);
- }
- }
- /**
- * Deauthenticates a single provider (e.g. removing access tokens from the
- * Facebook SDK).
- *
- * @param {object} provider service to logout of
- */
- _logOutWith(provider) {
- if (!this.isCurrent()) {
- return;
- }
- if (typeof provider === 'string') {
- provider = authProviders[provider];
- }
- if (provider && provider.deauthenticate) {
- provider.deauthenticate();
- }
- }
- /**
- * Class instance method used to maintain specific keys when a fetch occurs.
- * Used to ensure that the session token is not lost.
- *
- * @returns {object} sessionToken
- */
- _preserveFieldsOnFetch() {
- return {
- sessionToken: this.get('sessionToken')
- };
- }
- /**
- * Returns true if <code>current</code> would return this user.
- *
- * @returns {boolean} true if user is cached on disk
- */
- isCurrent() {
- const current = ParseUser.current();
- return !!current && current.id === this.id;
- }
- /**
- * Returns true if <code>current</code> would return this user.
- *
- * @returns {Promise<boolean>} true if user is cached on disk
- */
- async isCurrentAsync() {
- const current = await ParseUser.currentAsync();
- return !!current && current.id === this.id;
- }
- stripAnonymity() {
- const authData = this.get('authData');
- if (authData && typeof authData === 'object' && authData.hasOwnProperty('anonymous')) {
- // We need to set anonymous to null instead of deleting it in order to remove it from Parse.
- authData.anonymous = null;
- }
- }
- restoreAnonimity(anonymousData) {
- if (anonymousData) {
- const authData = this.get('authData');
- authData.anonymous = anonymousData;
- }
- }
- /**
- * Returns get("username").
- *
- * @returns {string}
- */
- getUsername() {
- const username = this.get('username');
- if (username == null || typeof username === 'string') {
- return username;
- }
- return '';
- }
- /**
- * Calls set("username", username, options) and returns the result.
- *
- * @param {string} username
- */
- setUsername(username) {
- this.stripAnonymity();
- this.set('username', username);
- }
- /**
- * Calls set("password", password, options) and returns the result.
- *
- * @param {string} password User's Password
- */
- setPassword(password) {
- this.set('password', password);
- }
- /**
- * Returns get("email").
- *
- * @returns {string} User's Email
- */
- getEmail() {
- const email = this.get('email');
- if (email == null || typeof email === 'string') {
- return email;
- }
- return '';
- }
- /**
- * Calls set("email", email) and returns the result.
- *
- * @param {string} email
- * @returns {boolean}
- */
- setEmail(email) {
- return this.set('email', email);
- }
- /**
- * Returns the session token for this user, if the user has been logged in,
- * or if it is the result of a query with the master key. Otherwise, returns
- * undefined.
- *
- * @returns {string} the session token, or undefined
- */
- getSessionToken() {
- const token = this.get('sessionToken');
- if (token == null || typeof token === 'string') {
- return token;
- }
- return '';
- }
- /**
- * Checks whether this user is the current user and has been authenticated.
- *
- * @returns {boolean} whether this user is the current user and is logged in.
- */
- authenticated() {
- const current = ParseUser.current();
- return !!this.get('sessionToken') && !!current && current.id === this.id;
- }
- /**
- * Signs up a new user. You should call this instead of save for
- * new Parse.Users. This will create a new Parse.User on the server, and
- * also persist the session on disk so that you can access the user using
- * <code>current</code>.
- *
- * <p>A username and password must be set before calling signUp.</p>
- *
- * @param {object} attrs Extra fields to set on the new user, or null.
- * @param {object} options
- * @returns {Promise} A promise that is fulfilled when the signup
- * finishes.
- */
- signUp(attrs, options) {
- options = options || {};
- const signupOptions = {};
- if (options.hasOwnProperty('useMasterKey')) {
- signupOptions.useMasterKey = options.useMasterKey;
- }
- if (options.hasOwnProperty('installationId')) {
- signupOptions.installationId = options.installationId;
- }
- if (options.hasOwnProperty('context') && Object.prototype.toString.call(options.context) === '[object Object]') {
- signupOptions.context = options.context;
- }
- const controller = _CoreManager.default.getUserController();
- return controller.signUp(this, attrs, signupOptions);
- }
- /**
- * Logs in a Parse.User. On success, this saves the session to disk,
- * so you can retrieve the currently logged in user using
- * <code>current</code>.
- *
- * <p>A username and password must be set before calling logIn.</p>
- *
- * @param {object} options
- * @returns {Promise} A promise that is fulfilled with the user when
- * the login is complete.
- */
- logIn(options = {}) {
- options = options || {};
- const loginOptions = {
- usePost: true
- };
- if (options.hasOwnProperty('useMasterKey')) {
- loginOptions.useMasterKey = options.useMasterKey;
- }
- if (options.hasOwnProperty('installationId')) {
- loginOptions.installationId = options.installationId;
- }
- if (options.hasOwnProperty('usePost')) {
- loginOptions.usePost = options.usePost;
- }
- if (options.hasOwnProperty('context') && Object.prototype.toString.call(options.context) === '[object Object]') {
- loginOptions.context = options.context;
- }
- const controller = _CoreManager.default.getUserController();
- return controller.logIn(this, loginOptions);
- }
- /**
- * Wrap the default save behavior with functionality to save to local
- * storage if this is current user.
- *
- * @param {...any} args
- * @returns {Promise}
- */
- async save(...args) {
- await super.save.apply(this, args);
- const current = await this.isCurrentAsync();
- if (current) {
- return _CoreManager.default.getUserController().updateUserOnDisk(this);
- }
- return this;
- }
- /**
- * Wrap the default destroy behavior with functionality that logs out
- * the current user when it is destroyed
- *
- * @param {...any} args
- * @returns {Parse.User}
- */
- async destroy(...args) {
- await super.destroy.apply(this, args);
- const current = await this.isCurrentAsync();
- if (current) {
- return _CoreManager.default.getUserController().removeUserFromDisk();
- }
- return this;
- }
- /**
- * Wrap the default fetch behavior with functionality to save to local
- * storage if this is current user.
- *
- * @param {...any} args
- * @returns {Parse.User}
- */
- async fetch(...args) {
- await super.fetch.apply(this, args);
- const current = await this.isCurrentAsync();
- if (current) {
- return _CoreManager.default.getUserController().updateUserOnDisk(this);
- }
- return this;
- }
- /**
- * Wrap the default fetchWithInclude behavior with functionality to save to local
- * storage if this is current user.
- *
- * @param {...any} args
- * @returns {Parse.User}
- */
- async fetchWithInclude(...args) {
- await super.fetchWithInclude.apply(this, args);
- const current = await this.isCurrentAsync();
- if (current) {
- return _CoreManager.default.getUserController().updateUserOnDisk(this);
- }
- return this;
- }
- /**
- * Verify whether a given password is the password of the current user.
- *
- * @param {string} password The password to be verified.
- * @param {object} options The options.
- * @param {boolean} [options.ignoreEmailVerification] Set to `true` to bypass email verification and verify
- * the password regardless of whether the email has been verified. This requires the master key.
- * @returns {Promise} A promise that is fulfilled with a user when the password is correct.
- */
- verifyPassword(password, options) {
- const username = this.getUsername() || '';
- return ParseUser.verifyPassword(username, password, options);
- }
- static readOnlyAttributes() {
- return ['sessionToken'];
- }
- /**
- * Adds functionality to the existing Parse.User class.
- *
- * @param {object} protoProps A set of properties to add to the prototype
- * @param {object} classProps A set of static properties to add to the class
- * @static
- * @returns {Parse.User} The newly extended Parse.User class
- */
- static extend(protoProps, classProps) {
- if (protoProps) {
- for (const prop in protoProps) {
- if (prop !== 'className') {
- Object.defineProperty(ParseUser.prototype, prop, {
- value: protoProps[prop],
- enumerable: false,
- writable: true,
- configurable: true
- });
- }
- }
- }
- if (classProps) {
- for (const prop in classProps) {
- if (prop !== 'className') {
- Object.defineProperty(ParseUser, prop, {
- value: classProps[prop],
- enumerable: false,
- writable: true,
- configurable: true
- });
- }
- }
- }
- return ParseUser;
- }
- /**
- * Retrieves the currently logged in ParseUser with a valid session,
- * either from memory or localStorage, if necessary.
- *
- * @static
- * @returns {Parse.Object} The currently logged in Parse.User.
- */
- static current() {
- if (!canUseCurrentUser) {
- return null;
- }
- const controller = _CoreManager.default.getUserController();
- return controller.currentUser();
- }
- /**
- * Retrieves the currently logged in ParseUser from asynchronous Storage.
- *
- * @static
- * @returns {Promise} A Promise that is resolved with the currently
- * logged in Parse User
- */
- static currentAsync() {
- if (!canUseCurrentUser) {
- return Promise.resolve(null);
- }
- const controller = _CoreManager.default.getUserController();
- return controller.currentUserAsync();
- }
- /**
- * Signs up a new user with a username (or email) and password.
- * This will create a new Parse.User on the server, and also persist the
- * session in localStorage so that you can access the user using
- * {@link #current}.
- *
- * @param {string} username The username (or email) to sign up with.
- * @param {string} password The password to sign up with.
- * @param {object} attrs Extra fields to set on the new user.
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is fulfilled with the user when
- * the signup completes.
- */
- static signUp(username, password, attrs, options) {
- attrs = attrs || {};
- attrs.username = username;
- attrs.password = password;
- const user = new this(attrs);
- return user.signUp({}, options);
- }
- /**
- * Logs in a user with a username (or email) and password. On success, this
- * saves the session to disk, so you can retrieve the currently logged in
- * user using <code>current</code>.
- *
- * @param {string} username The username (or email) to log in with.
- * @param {string} password The password to log in with.
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is fulfilled with the user when
- * the login completes.
- */
- static logIn(username, password, options) {
- if (typeof username !== 'string') {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Username must be a string.'));
- } else if (typeof password !== 'string') {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Password must be a string.'));
- }
- const user = new this();
- user._finishFetch({
- username: username,
- password: password
- });
- return user.logIn(options);
- }
- /**
- * Logs in a user with a username (or email) and password, and authData. On success, this
- * saves the session to disk, so you can retrieve the currently logged in
- * user using <code>current</code>.
- *
- * @param {string} username The username (or email) to log in with.
- * @param {string} password The password to log in with.
- * @param {object} authData The authData to log in with.
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is fulfilled with the user when
- * the login completes.
- */
- static logInWithAdditionalAuth(username, password, authData, options) {
- if (typeof username !== 'string') {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Username must be a string.'));
- }
- if (typeof password !== 'string') {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Password must be a string.'));
- }
- if (Object.prototype.toString.call(authData) !== '[object Object]') {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Auth must be an object.'));
- }
- const user = new this();
- user._finishFetch({
- username: username,
- password: password,
- authData
- });
- return user.logIn(options);
- }
- /**
- * Logs in a user with an objectId. On success, this saves the session
- * to disk, so you can retrieve the currently logged in user using
- * <code>current</code>.
- *
- * @param {string} userId The objectId for the user.
- * @static
- * @returns {Promise} A promise that is fulfilled with the user when
- * the login completes.
- */
- static loginAs(userId) {
- if (!userId) {
- throw new _ParseError.default(_ParseError.default.USERNAME_MISSING, 'Cannot log in as user with an empty user id');
- }
- const controller = _CoreManager.default.getUserController();
- const user = new this();
- return controller.loginAs(user, userId);
- }
- /**
- * Logs in a user with a session token. On success, this saves the session
- * to disk, so you can retrieve the currently logged in user using
- * <code>current</code>.
- *
- * @param {string} sessionToken The sessionToken to log in with.
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is fulfilled with the user when
- * the login completes.
- */
- static become(sessionToken, options) {
- if (!canUseCurrentUser) {
- throw new Error('It is not memory-safe to become a user in a server environment');
- }
- options = options || {};
- const becomeOptions = {
- sessionToken: sessionToken
- };
- if (options.hasOwnProperty('useMasterKey')) {
- becomeOptions.useMasterKey = options.useMasterKey;
- }
- const controller = _CoreManager.default.getUserController();
- const user = new this();
- return controller.become(user, becomeOptions);
- }
- /**
- * Retrieves a user with a session token.
- *
- * @param {string} sessionToken The sessionToken to get user with.
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is fulfilled with the user is fetched.
- */
- static me(sessionToken, options = {}) {
- const controller = _CoreManager.default.getUserController();
- const meOptions = {
- sessionToken: sessionToken
- };
- if (options.useMasterKey) {
- meOptions.useMasterKey = options.useMasterKey;
- }
- const user = new this();
- return controller.me(user, meOptions);
- }
- /**
- * Logs in a user with a session token. On success, this saves the session
- * to disk, so you can retrieve the currently logged in user using
- * <code>current</code>. If there is no session token the user will not logged in.
- *
- * @param {object} userJSON The JSON map of the User's data
- * @static
- * @returns {Promise} A promise that is fulfilled with the user when
- * the login completes.
- */
- static hydrate(userJSON) {
- const controller = _CoreManager.default.getUserController();
- const user = new this();
- return controller.hydrate(user, userJSON);
- }
- /**
- * Static version of {@link https://parseplatform.org/Parse-SDK-JS/api/master/Parse.User.html#linkWith linkWith}
- *
- * @param provider
- * @param options
- * @param {object} [options.authData]
- * @param saveOpts
- * @static
- * @returns {Promise}
- */
- static logInWith(provider, options, saveOpts) {
- const user = new this();
- return user.linkWith(provider, options, saveOpts);
- }
- /**
- * Logs out the currently logged in user session. This will remove the
- * session from disk, log out of linked services, and future calls to
- * <code>current</code> will return <code>null</code>.
- *
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is resolved when the session is
- * destroyed on the server.
- */
- static logOut(options = {}) {
- const controller = _CoreManager.default.getUserController();
- return controller.logOut(options);
- }
- /**
- * Requests a password reset email to be sent to the specified email address
- * associated with the user account. This email allows the user to securely
- * reset their password on the Parse site.
- *
- * @param {string} email The email address associated with the user that
- * forgot their password.
- * @param {object} options
- * @static
- * @returns {Promise}
- */
- static requestPasswordReset(email, options) {
- options = options || {};
- const requestOptions = {};
- if (options.hasOwnProperty('useMasterKey')) {
- requestOptions.useMasterKey = options.useMasterKey;
- }
- const controller = _CoreManager.default.getUserController();
- return controller.requestPasswordReset(email, requestOptions);
- }
- /**
- * Request an email verification.
- *
- * @param {string} email The email address associated with the user that
- * needs to verify their email.
- * @param {object} options
- * @static
- * @returns {Promise}
- */
- static requestEmailVerification(email, options) {
- options = options || {};
- const requestOptions = {};
- if (options.hasOwnProperty('useMasterKey')) {
- requestOptions.useMasterKey = options.useMasterKey;
- }
- const controller = _CoreManager.default.getUserController();
- return controller.requestEmailVerification(email, requestOptions);
- }
- /**
- * Verify whether a given password is the password of the current user.
- * @static
- *
- * @param {string} username The username of the user whose password should be verified.
- * @param {string} password The password to be verified.
- * @param {object} options The options.
- * @param {boolean} [options.ignoreEmailVerification] Set to `true` to bypass email verification and verify
- * the password regardless of whether the email has been verified. This requires the master key.
- * @returns {Promise} A promise that is fulfilled with a user when the password is correct.
- */
- static verifyPassword(username, password, options) {
- if (typeof username !== 'string') {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Username must be a string.'));
- }
- if (typeof password !== 'string') {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Password must be a string.'));
- }
- const controller = _CoreManager.default.getUserController();
- return controller.verifyPassword(username, password, options || {});
- }
- /**
- * Allow someone to define a custom User class without className
- * being rewritten to _User. The default behavior is to rewrite
- * User to _User for legacy reasons. This allows developers to
- * override that behavior.
- *
- * @param {boolean} isAllowed Whether or not to allow custom User class
- * @static
- */
- static allowCustomUserClass(isAllowed) {
- _CoreManager.default.set('PERFORM_USER_REWRITE', !isAllowed);
- }
- /**
- * Allows a legacy application to start using revocable sessions. If the
- * current session token is not revocable, a request will be made for a new,
- * revocable session.
- * It is not necessary to call this method from cloud code unless you are
- * handling user signup or login from the server side. In a cloud code call,
- * this function will not attempt to upgrade the current token.
- *
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is resolved when the process has
- * completed. If a replacement session token is requested, the promise
- * will be resolved after a new token has been fetched.
- */
- static enableRevocableSession(options) {
- options = options || {};
- _CoreManager.default.set('FORCE_REVOCABLE_SESSION', true);
- if (canUseCurrentUser) {
- const current = ParseUser.current();
- if (current) {
- return current._upgradeToRevocableSession(options);
- }
- }
- return Promise.resolve();
- }
- /**
- * Enables the use of become or the current user in a server
- * environment. These features are disabled by default, since they depend on
- * global objects that are not memory-safe for most servers.
- *
- * @static
- */
- static enableUnsafeCurrentUser() {
- canUseCurrentUser = true;
- }
- /**
- * Disables the use of become or the current user in any environment.
- * These features are disabled on servers by default, since they depend on
- * global objects that are not memory-safe for most servers.
- *
- * @static
- */
- static disableUnsafeCurrentUser() {
- canUseCurrentUser = false;
- }
- /**
- * When registering users with {@link https://parseplatform.org/Parse-SDK-JS/api/master/Parse.User.html#linkWith linkWith} a basic auth provider
- * is automatically created for you.
- *
- * For advanced authentication, you can register an Auth provider to
- * implement custom authentication, deauthentication.
- *
- * @param provider
- * @see {@link https://parseplatform.org/Parse-SDK-JS/api/master/AuthProvider.html AuthProvider}
- * @see {@link https://docs.parseplatform.org/js/guide/#custom-authentication-module Custom Authentication Module}
- * @static
- */
- static _registerAuthenticationProvider(provider) {
- authProviders[provider.getAuthType()] = provider;
- // Synchronize the current user with the auth provider.
- ParseUser.currentAsync().then(current => {
- if (current) {
- current._synchronizeAuthData(provider.getAuthType());
- }
- });
- }
- /**
- * @param provider
- * @param options
- * @param {object} [options.authData]
- * @param saveOpts
- * @deprecated since 2.9.0 see {@link https://parseplatform.org/Parse-SDK-JS/api/master/Parse.User.html#logInWith logInWith}
- * @static
- * @returns {Promise}
- */
- static _logInWith(provider, options, saveOpts) {
- const user = new this();
- return user.linkWith(provider, options, saveOpts);
- }
- static _clearCache() {
- currentUserCache = null;
- currentUserCacheMatchesDisk = false;
- }
- static _setCurrentUserCache(user) {
- currentUserCache = user;
- }
- }
- _ParseObject.default.registerSubclass('_User', ParseUser);
- const DefaultController = {
- updateUserOnDisk(user) {
- const path = _Storage.default.generatePath(CURRENT_USER_KEY);
- const json = user.toJSON();
- delete json.password;
- json.className = '_User';
- let userData = JSON.stringify(json);
- if (_CoreManager.default.get('ENCRYPTED_USER')) {
- const crypto = _CoreManager.default.getCryptoController();
- userData = crypto.encrypt(json, _CoreManager.default.get('ENCRYPTED_KEY'));
- }
- return _Storage.default.setItemAsync(path, userData).then(() => {
- return user;
- });
- },
- removeUserFromDisk() {
- const path = _Storage.default.generatePath(CURRENT_USER_KEY);
- currentUserCacheMatchesDisk = true;
- currentUserCache = null;
- return _Storage.default.removeItemAsync(path);
- },
- setCurrentUser(user) {
- currentUserCache = user;
- user._cleanupAuthData();
- user._synchronizeAllAuthData();
- return DefaultController.updateUserOnDisk(user);
- },
- currentUser() {
- if (currentUserCache) {
- return currentUserCache;
- }
- if (currentUserCacheMatchesDisk) {
- return null;
- }
- if (_Storage.default.async()) {
- throw new Error('Cannot call currentUser() when using a platform with an async ' + 'storage system. Call currentUserAsync() instead.');
- }
- const path = _Storage.default.generatePath(CURRENT_USER_KEY);
- let userData = _Storage.default.getItem(path);
- currentUserCacheMatchesDisk = true;
- if (!userData) {
- currentUserCache = null;
- return null;
- }
- if (_CoreManager.default.get('ENCRYPTED_USER')) {
- const crypto = _CoreManager.default.getCryptoController();
- userData = crypto.decrypt(userData, _CoreManager.default.get('ENCRYPTED_KEY'));
- }
- userData = JSON.parse(userData);
- if (!userData.className) {
- userData.className = '_User';
- }
- if (userData._id) {
- if (userData.objectId !== userData._id) {
- userData.objectId = userData._id;
- }
- delete userData._id;
- }
- if (userData._sessionToken) {
- userData.sessionToken = userData._sessionToken;
- delete userData._sessionToken;
- }
- const current = _ParseObject.default.fromJSON(userData);
- currentUserCache = current;
- current._synchronizeAllAuthData();
- return current;
- },
- currentUserAsync() {
- if (currentUserCache) {
- return Promise.resolve(currentUserCache);
- }
- if (currentUserCacheMatchesDisk) {
- return Promise.resolve(null);
- }
- const path = _Storage.default.generatePath(CURRENT_USER_KEY);
- return _Storage.default.getItemAsync(path).then(userData => {
- currentUserCacheMatchesDisk = true;
- if (!userData) {
- currentUserCache = null;
- return Promise.resolve(null);
- }
- if (_CoreManager.default.get('ENCRYPTED_USER')) {
- const crypto = _CoreManager.default.getCryptoController();
- userData = crypto.decrypt(userData.toString(), _CoreManager.default.get('ENCRYPTED_KEY'));
- }
- userData = JSON.parse(userData);
- if (!userData.className) {
- userData.className = '_User';
- }
- if (userData._id) {
- if (userData.objectId !== userData._id) {
- userData.objectId = userData._id;
- }
- delete userData._id;
- }
- if (userData._sessionToken) {
- userData.sessionToken = userData._sessionToken;
- delete userData._sessionToken;
- }
- const current = _ParseObject.default.fromJSON(userData);
- currentUserCache = current;
- current._synchronizeAllAuthData();
- return Promise.resolve(current);
- });
- },
- signUp(user, attrs, options) {
- const username = attrs && attrs.username || user.get('username');
- const password = attrs && attrs.password || user.get('password');
- if (!username || !username.length) {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Cannot sign up user with an empty username.'));
- }
- if (!password || !password.length) {
- return Promise.reject(new _ParseError.default(_ParseError.default.OTHER_CAUSE, 'Cannot sign up user with an empty password.'));
- }
- return user.save(attrs, options).then(() => {
- // Clear the password field
- user._finishFetch({
- password: undefined
- });
- if (canUseCurrentUser) {
- return DefaultController.setCurrentUser(user);
- }
- return user;
- });
- },
- logIn(user, options) {
- const RESTController = _CoreManager.default.getRESTController();
- const stateController = _CoreManager.default.getObjectStateController();
- const auth = {
- username: user.get('username'),
- password: user.get('password'),
- authData: user.get('authData')
- };
- return RESTController.request(options.usePost ? 'POST' : 'GET', 'login', auth, options).then(response => {
- user._migrateId(response.objectId);
- user._setExisted(true);
- stateController.setPendingOp(user._getStateIdentifier(), 'username', undefined);
- stateController.setPendingOp(user._getStateIdentifier(), 'password', undefined);
- response.password = undefined;
- user._finishFetch(response);
- if (!canUseCurrentUser) {
- // We can't set the current user, so just return the one we logged in
- return Promise.resolve(user);
- }
- return DefaultController.setCurrentUser(user);
- });
- },
- loginAs(user, userId) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('POST', 'loginAs', {
- userId
- }, {
- useMasterKey: true
- }).then(response => {
- user._finishFetch(response);
- user._setExisted(true);
- if (!canUseCurrentUser) {
- return Promise.resolve(user);
- }
- return DefaultController.setCurrentUser(user);
- });
- },
- become(user, options) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('GET', 'users/me', {}, options).then(response => {
- user._finishFetch(response);
- user._setExisted(true);
- return DefaultController.setCurrentUser(user);
- });
- },
- hydrate(user, userJSON) {
- user._finishFetch(userJSON);
- user._setExisted(true);
- if (userJSON.sessionToken && canUseCurrentUser) {
- return DefaultController.setCurrentUser(user);
- } else {
- return Promise.resolve(user);
- }
- },
- me(user, options) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('GET', 'users/me', {}, options).then(response => {
- user._finishFetch(response);
- user._setExisted(true);
- return user;
- });
- },
- logOut(options) {
- const RESTController = _CoreManager.default.getRESTController();
- if (options.sessionToken) {
- return RESTController.request('POST', 'logout', {}, options);
- }
- return DefaultController.currentUserAsync().then(currentUser => {
- const path = _Storage.default.generatePath(CURRENT_USER_KEY);
- let promise = _Storage.default.removeItemAsync(path);
- if (currentUser !== null) {
- const currentSession = currentUser.getSessionToken();
- if (currentSession && (0, _isRevocableSession.default)(currentSession)) {
- promise = promise.then(() => {
- return RESTController.request('POST', 'logout', {}, {
- sessionToken: currentSession
- });
- });
- }
- currentUser._logOutWithAll();
- currentUser._finishFetch({
- sessionToken: undefined
- });
- }
- currentUserCacheMatchesDisk = true;
- currentUserCache = null;
- return promise;
- });
- },
- requestPasswordReset(email, options) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('POST', 'requestPasswordReset', {
- email: email
- }, options);
- },
- async upgradeToRevocableSession(user, options) {
- const token = user.getSessionToken();
- if (!token) {
- return Promise.reject(new _ParseError.default(_ParseError.default.SESSION_MISSING, 'Cannot upgrade a user with no session token'));
- }
- options.sessionToken = token;
- const RESTController = _CoreManager.default.getRESTController();
- const result = await RESTController.request('POST', 'upgradeToRevocableSession', {}, options);
- user._finishFetch({
- sessionToken: (result === null || result === void 0 ? void 0 : result.sessionToken) || ''
- });
- const current = await user.isCurrentAsync();
- if (current) {
- return DefaultController.setCurrentUser(user);
- }
- return Promise.resolve(user);
- },
- linkWith(user, authData, options) {
- return user.save({
- authData
- }, options).then(() => {
- if (canUseCurrentUser) {
- return DefaultController.setCurrentUser(user);
- }
- return user;
- });
- },
- verifyPassword(username, password, options) {
- const RESTController = _CoreManager.default.getRESTController();
- const data = {
- username,
- password,
- ...(options.ignoreEmailVerification !== undefined && {
- ignoreEmailVerification: options.ignoreEmailVerification
- })
- };
- return RESTController.request('GET', 'verifyPassword', data, options);
- },
- requestEmailVerification(email, options) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('POST', 'verificationEmailRequest', {
- email: email
- }, options);
- }
- };
- _CoreManager.default.setParseUser(ParseUser);
- _CoreManager.default.setUserController(DefaultController);
- var _default = exports.default = ParseUser;
|