1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186 |
- "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 _ParseSession = _interopRequireDefault(require("./ParseSession"));
- var _Storage = _interopRequireDefault(require("./Storage"));
- function _interopRequireDefault(obj) {
- return obj && obj.__esModule ? obj : {
- default: obj
- };
- }
- /**
- * @flow
- */
- /*:: import type { AttributeMap } from './ObjectStateMutations';*/
- /*:: import type { RequestOptions, FullOptions } from './RESTController';*/
- /*:: export type AuthData = ?{ [key: string]: mixed };*/
- 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 /*: ?AttributeMap*/) {
- 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 /*: RequestOptions*/) /*: Promise<void>*/{
- 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
- * <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 /*: any*/, options /*: { authData?: AuthData }*/, saveOpts /*:: ?: FullOptions*/ = {}) /*: Promise<ParseUser>*/{
- 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 controller = _CoreManager.default.getUserController();
- return controller.linkWith(this, authData, saveOpts);
- } 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 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 /*: any*/, options /*: { authData?: AuthData }*/, saveOpts /*:: ?: FullOptions*/ = {}) /*: Promise<ParseUser>*/{
- 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 /*: string*/) {
- 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 /*: any*/, options /*:: ?: FullOptions*/) /*: Promise<ParseUser>*/{
- 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 /*: any*/) /*: boolean*/{
- 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 /*: any*/) {
- 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() /*: AttributeMap*/{
- 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() /*: boolean*/{
- 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() /*: Promise<boolean>*/{
- const current = await ParseUser.currentAsync();
- return !!current && current.id === this.id;
- }
- /**
- * Returns get("username").
- *
- * @returns {string}
- */
- getUsername() /*: ?string*/{
- 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 /*: string*/) {
- // Strip anonymity
- 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;
- }
- this.set('username', username);
- }
- /**
- * Calls set("password", password, options) and returns the result.
- *
- * @param {string} password User's Password
- */
- setPassword(password /*: string*/) {
- this.set('password', password);
- }
- /**
- * Returns get("email").
- *
- * @returns {string} User's Email
- */
- getEmail() /*: ?string*/{
- 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 /*: string*/) {
- 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() /*: ?string*/{
- 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() /*: boolean*/{
- 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 /*: AttributeMap*/, options /*:: ?: FullOptions*/) /*: Promise<ParseUser>*/{
- 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 /*:: ?: FullOptions*/) /*: Promise<ParseUser>*/{
- 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;
- }
- 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 /*: Array<any>*/) /*: Promise<ParseUser>*/{
- 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 /*: Array<any>*/) /*: Promise<ParseUser>*/{
- 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 /*: Array<any>*/) /*: Promise<ParseUser>*/{
- 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 /*: Array<any>*/) /*: Promise<ParseUser>*/{
- 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 A password to be verified
- * @param {object} options
- * @returns {Promise} A promise that is fulfilled with a user
- * when the password is correct.
- */
- verifyPassword(password /*: string*/, options /*:: ?: RequestOptions*/) /*: Promise<ParseUser>*/{
- 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 /*: { [prop: string]: any }*/, classProps /*: { [prop: string]: any }*/) {
- 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() /*: ?ParseUser*/{
- 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() /*: Promise<?ParseUser>*/{
- 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 /*: string*/, password /*: string*/, attrs /*: AttributeMap*/, options /*:: ?: FullOptions*/) {
- 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 /*: string*/, password /*: string*/, options /*:: ?: FullOptions*/) {
- 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 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 /*: string*/) {
- 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 /*: string*/, options /*:: ?: RequestOptions*/) {
- if (!canUseCurrentUser) {
- throw new Error('It is not memory-safe to become a user in a server environment');
- }
- options = options || {};
- const becomeOptions /*: RequestOptions*/ = {
- 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 /*: string*/, options /*:: ?: RequestOptions*/ = {}) {
- const controller = _CoreManager.default.getUserController();
- const meOptions /*: RequestOptions*/ = {
- 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 /*: AttributeMap*/) {
- 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 saveOpts
- * @static
- * @returns {Promise}
- */
- static logInWith(provider /*: any*/, options /*: { authData?: AuthData }*/, saveOpts /*:: ?: FullOptions*/) /*: Promise<ParseUser>*/{
- 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 /*: RequestOptions*/ = {}) {
- 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 /*: string*/, options /*:: ?: RequestOptions*/) {
- 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 /*: string*/, options /*:: ?: RequestOptions*/) {
- 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.
- *
- * @param {string} username A username to be used for identificaiton
- * @param {string} password A password to be verified
- * @param {object} options
- * @static
- * @returns {Promise} A promise that is fulfilled with a user
- * when the password is correct.
- */
- static verifyPassword(username /*: string*/, password /*: string*/, options /*:: ?: RequestOptions*/) {
- 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.'));
- }
- options = options || {};
- const verificationOption = {};
- if (options.hasOwnProperty('useMasterKey')) {
- verificationOption.useMasterKey = options.useMasterKey;
- }
- const controller = _CoreManager.default.getUserController();
- return controller.verifyPassword(username, password, verificationOption);
- }
- /**
- * 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 /*: boolean*/) {
- _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 /*:: ?: RequestOptions*/) {
- 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 /*: any*/) {
- 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 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 /*: any*/, options /*: { authData?: AuthData }*/, saveOpts /*:: ?: FullOptions*/) {
- const user = new this();
- return user.linkWith(provider, options, saveOpts);
- }
- static _clearCache() {
- currentUserCache = null;
- currentUserCacheMatchesDisk = false;
- }
- static _setCurrentUserCache(user /*: ParseUser*/) {
- 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() /*: ?ParseUser*/{
- 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() /*: Promise<?ParseUser>*/{
- 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 /*: ParseUser*/, attrs /*: AttributeMap*/, options /*: RequestOptions*/) /*: Promise<ParseUser>*/{
- 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 /*: ParseUser*/, options /*: RequestOptions*/) /*: Promise<ParseUser>*/{
- const RESTController = _CoreManager.default.getRESTController();
- const stateController = _CoreManager.default.getObjectStateController();
- const auth = {
- username: user.get('username'),
- password: user.get('password')
- };
- 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 /*: ParseUser*/, userId /*: string*/) /*: Promise<ParseUser>*/{
- 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 /*: ParseUser*/, options /*: RequestOptions*/) /*: Promise<ParseUser>*/{
- 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 /*: ParseUser*/, userJSON /*: AttributeMap*/) /*: Promise<ParseUser>*/{
- user._finishFetch(userJSON);
- user._setExisted(true);
- if (userJSON.sessionToken && canUseCurrentUser) {
- return DefaultController.setCurrentUser(user);
- } else {
- return Promise.resolve(user);
- }
- },
- me(user /*: ParseUser*/, options /*: RequestOptions*/) /*: Promise<ParseUser>*/{
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('GET', 'users/me', {}, options).then(response => {
- user._finishFetch(response);
- user._setExisted(true);
- return user;
- });
- },
- logOut(options /*: RequestOptions*/) /*: Promise<ParseUser>*/{
- 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 /*: string*/, options /*: RequestOptions*/) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('POST', 'requestPasswordReset', {
- email: email
- }, options);
- },
- async upgradeToRevocableSession(user /*: ParseUser*/, options /*: RequestOptions*/) {
- 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);
- const session = new _ParseSession.default();
- session._finishFetch(result);
- user._finishFetch({
- sessionToken: session.getSessionToken()
- });
- const current = await user.isCurrentAsync();
- if (current) {
- return DefaultController.setCurrentUser(user);
- }
- return Promise.resolve(user);
- },
- linkWith(user /*: ParseUser*/, authData /*: AuthData*/, options /*: FullOptions*/) {
- return user.save({
- authData
- }, options).then(() => {
- if (canUseCurrentUser) {
- return DefaultController.setCurrentUser(user);
- }
- return user;
- });
- },
- verifyPassword(username /*: string*/, password /*: string*/, options /*: RequestOptions*/) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('GET', 'verifyPassword', {
- username,
- password
- }, options);
- },
- requestEmailVerification(email /*: string*/, options /*: RequestOptions*/) {
- const RESTController = _CoreManager.default.getRESTController();
- return RESTController.request('POST', 'verificationEmailRequest', {
- email: email
- }, options);
- }
- };
- _CoreManager.default.setUserController(DefaultController);
- var _default = ParseUser;
- exports.default = _default;
|