"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.default = void 0; var _ParseACL = _interopRequireDefault(require("./ParseACL")); var _ParseError = _interopRequireDefault(require("./ParseError")); var _ParseObject = _interopRequireDefault(require("./ParseObject")); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } /** * @flow */ /*:: import type { AttributeMap } from './ObjectStateMutations';*/ /*:: import type ParseRelation from './ParseRelation';*/ /** * Represents a Role on the Parse server. Roles represent groupings of * Users for the purposes of granting permissions (e.g. specifying an ACL * for an Object). Roles are specified by their sets of child users and * child roles, all of which are granted any permissions that the parent * role has. * *

Roles must have a name (which cannot be changed after creation of the * role), and must specify an ACL.

* * @alias Parse.Role * @augments Parse.Object */ class ParseRole extends _ParseObject.default { /** * @param {string} name The name of the Role to create. * @param {Parse.ACL} acl The ACL for this role. Roles must have an ACL. * A Parse.Role is a local representation of a role persisted to the Parse * cloud. */ constructor(name /*: string*/, acl /*: ParseACL*/) { super('_Role'); if (typeof name === 'string' && acl instanceof _ParseACL.default) { this.setName(name); this.setACL(acl); } } /** * Gets the name of the role. You can alternatively call role.get("name") * * @returns {string} the name of the role. */ getName() /*: ?string*/{ const name = this.get('name'); if (name == null || typeof name === 'string') { return name; } return ''; } /** * Sets the name for a role. This value must be set before the role has * been saved to the server, and cannot be set once the role has been * saved. * *

* A role's name can only contain alphanumeric characters, _, -, and * spaces. *

* *

This is equivalent to calling role.set("name", name)

* * @param {string} name The name of the role. * @param {object} options Standard options object with success and error * callbacks. * @returns {(ParseObject|boolean)} true if the set succeeded. */ setName(name /*: string*/, options /*:: ?: mixed*/) /*: ParseObject | boolean*/{ this._validateName(name); return this.set('name', name, options); } /** * Gets the Parse.Relation for the Parse.Users that are direct * children of this role. These users are granted any privileges that this * role has been granted (e.g. read or write access through ACLs). You can * add or remove users from the role through this relation. * *

This is equivalent to calling role.relation("users")

* * @returns {Parse.Relation} the relation for the users belonging to this * role. */ getUsers() /*: ParseRelation*/{ return this.relation('users'); } /** * Gets the Parse.Relation for the Parse.Roles that are direct * children of this role. These roles' users are granted any privileges that * this role has been granted (e.g. read or write access through ACLs). You * can add or remove child roles from this role through this relation. * *

This is equivalent to calling role.relation("roles")

* * @returns {Parse.Relation} the relation for the roles belonging to this * role. */ getRoles() /*: ParseRelation*/{ return this.relation('roles'); } _validateName(newName) { if (typeof newName !== 'string') { throw new _ParseError.default(_ParseError.default.OTHER_CAUSE, "A role's name must be a String."); } if (!/^[0-9a-zA-Z\-_ ]+$/.test(newName)) { throw new _ParseError.default(_ParseError.default.OTHER_CAUSE, "A role's name can be only contain alphanumeric characters, _, " + '-, and spaces.'); } } validate(attrs /*: AttributeMap*/, options /*:: ?: mixed*/) /*: ParseError | boolean*/{ const isInvalid = super.validate(attrs, options); if (isInvalid) { return isInvalid; } if ('name' in attrs && attrs.name !== this.getName()) { const newName = attrs.name; if (this.id && this.id !== attrs.objectId) { // Check to see if the objectId being set matches this.id // This happens during a fetch -- the id is set before calling fetch // Let the name be set in this case return new _ParseError.default(_ParseError.default.OTHER_CAUSE, "A role's name can only be set before it has been saved."); } try { this._validateName(newName); } catch (e) { return e; } } return false; } } _ParseObject.default.registerSubclass('_Role', ParseRole); var _default = ParseRole; exports.default = _default;