@esri/hub-common 13.17.2 → 13.17.4

package/dist/node/features/types.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHubFeature = void 0;
+/**
+ * Hub System Features
+ */
+const validFeaures = [
+    "workspaces",
+];
+/**
+ * Validate a feature. This is used because the libary can be used outside of typescript and we want to be able to return a message is the string passed in is not a valid capability
+ * @param Feature
+ * @returns
+ */
+function isHubFeature(maybeFeature) {
+    return validFeaures.includes(maybeFeature);
+}
+exports.isHubFeature = isHubFeature;
+// /**
+//  * All capability checks for an Entity's workspace
+//  */
+// export interface IWorkspaceCapabilityResponse {
+//   /**
+//    * Array of capabilities the current user has access to, in the context of a given entity
+//    */
+//   granted: Capability[];
+//   /**
+//    * Detailed checks for each capability. Used for observability
+//    */
+//   details: ICapabilityAccessResponse[];
+// }
+//# sourceMappingURL=types.js.map

package/dist/node/features/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/types.ts"],"names":[],"mappings":";;;AAOA;;GAEG;AACH,MAAM,YAAY,GAAG;IACnB,YAAY;CACJ,CAAC;AAcX;;;;GAIG;AACH,SAAgB,YAAY,CAAC,YAAoB;IAC/C,OAAO,YAAY,CAAC,QAAQ,CAAC,YAA0B,CAAC,CAAC;AAC3D,CAAC;AAFD,oCAEC;AAyBD,MAAM;AACN,qDAAqD;AACrD,MAAM;AACN,kDAAkD;AAClD,QAAQ;AACR,8FAA8F;AAC9F,QAAQ;AACR,2BAA2B;AAC3B,QAAQ;AACR,mEAAmE;AACnE,QAAQ;AACR,0CAA0C;AAC1C,IAAI"}

package/dist/node/groups/HubGroup.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubGroup = void 0;
+const HubGroups_1 = require("./HubGroups");
+const convertHubGroupToGroup_1 = require("./_internal/convertHubGroupToGroup");
+const defaults_1 = require("./defaults");
+const permissions_1 = require("../permissions");
+const util_1 = require("../util");
+const getEditorConfig_1 = require("../core/schemas/getEditorConfig");
+const setGroupThumbnail_1 = require("./setGroupThumbnail");
+const utils_1 = require("../search/utils");
+const deleteGroupThumbnail_1 = require("./deleteGroupThumbnail");
+const enrichEntity_1 = require("../core/enrichEntity");
+/**
+ * Hub Group Class
+ */
+class HubGroup {
+    constructor(group, context) {
+        this.isDestroyed = false;
+        this.thumbnailCache = null;
+        this.entity = group;
+        this.context = context;
+    }
+    /**
+     * Whether the user can edit the group,
+     * only the owner or admins of the group can
+     */
+    get canEdit() {
+        return ((this.entity.memberType &&
+            (this.entity.memberType === "owner" ||
+                this.entity.memberType === "admin")) ||
+            this.entity.owner === this.context.currentUser.username);
+    }
+    /**
+     * Whether the user can delete the group
+     * only the owner or admins of the group can
+     */
+    get canDelete() {
+        return this.canEdit;
+    }
+    /**
+     * Whether the group is protected, if so, it can't be deleted
+     */
+    get isProtected() {
+        return this.entity.protected;
+    }
+    /**
+     * Create an instance from an IHubGroup object
+     * @param json - JSON object to create a HubGroup from
+     * @param context - ArcGIS context
+     * @returns
+     */
+    static fromJson(json, context) {
+        // merge what we have with the default values
+        const pojo = this.applyDefaults(json);
+        return new HubGroup(pojo, context);
+    }
+    /**
+     * Create a new HubGroup, returning a HubGroup instance.
+     * Note: This does not persist the Group into the backing store
+     * @param partialGroup
+     * @param context
+     * @returns
+     */
+    static async create(partialGroup, context, save = false) {
+        const pojo = this.applyDefaults(partialGroup);
+        // return an instance of HubGroup
+        const instance = HubGroup.fromJson(pojo, context);
+        if (save) {
+            await instance.save();
+        }
+        return instance;
+    }
+    /**
+     * Fetch a Group from the backing store and return a HubGroup instance.
+     * @param identifier - Identifier of the group to load
+     * @param context
+     * @returns
+     */
+    static async fetch(identifier, context) {
+        try {
+            const group = await HubGroups_1.fetchHubGroup(identifier, context.userRequestOptions);
+            // create an instance of HubGroup from the group
+            return HubGroup.fromJson(group, context);
+        }
+        catch (ex) {
+            if (ex.message ===
+                "COM_0003: Group does not exist or is inaccessible.") {
+                throw new Error(`Group not found.`);
+            }
+            else {
+                throw ex;
+            }
+        }
+    }
+    static applyDefaults(partialGroup) {
+        // extend the partial over the defaults
+        return Object.assign(Object.assign({}, defaults_1.DEFAULT_GROUP), partialGroup);
+    }
+    /**
+     * Return the backing entity as an object literal
+     */
+    toJson() {
+        if (this.isDestroyed) {
+            throw new Error("HubGroup is already destroyed.");
+        }
+        return util_1.cloneObject(this.entity);
+    }
+    /**
+     * Apply a new state to the instance
+     * @param changes
+     */
+    update(changes) {
+        if (this.isDestroyed) {
+            throw new Error("HubGroup is already destroyed.");
+        }
+        // merge partial onto existing entity
+        this.entity = Object.assign(Object.assign({}, this.entity), changes);
+    }
+    /**
+     * Save the HubGroup to the backing store
+     * @returns
+     */
+    async save() {
+        if (this.isDestroyed) {
+            throw new Error("HubGroup is already destroyed.");
+        }
+        if (this.entity.id) {
+            // update it
+            this.entity = await HubGroups_1.updateHubGroup(this.entity, this.context.userRequestOptions);
+        }
+        else {
+            // create it
+            this.entity = await HubGroups_1.createHubGroup(this.entity, this.context.userRequestOptions);
+        }
+        return;
+    }
+    /**
+     * Delete the HubGroup from the store
+     * set a flag to indicate that it is destroyed
+     * @returns
+     */
+    async delete() {
+        if (this.isDestroyed) {
+            throw new Error("HubGroup is already destroyed.");
+        }
+        this.isDestroyed = true;
+        // Delegate to module fn
+        await HubGroups_1.deleteHubGroup(this.entity.id, this.context.userRequestOptions);
+    }
+    /**
+     * Check if current user has a specific permission, accounting for
+     * both system and entity level policies
+     * @param permission
+     * @returns
+     */
+    checkPermission(permission) {
+        return permissions_1.checkPermission(permission, this.context, this.entity);
+    }
+    /**
+     * Get all policies related to a specific permission
+     * @param permission
+     * @returns
+     */
+    getPermissionPolicies(permission) {
+        const permissions = this.entity.permissions;
+        return permissions.filter((p) => p.permission === permission);
+    }
+    /**
+     * Add a policy to the entity
+     * @param policy
+     */
+    addPermissionPolicy(policy) {
+        this.entity.permissions = permissions_1.addPermissionPolicy(this.entity.permissions, policy);
+    }
+    /**
+     * Remove a policy from the entity
+     * @param permission
+     * @param id
+     */
+    removePermissionPolicy(permission, id) {
+        this.entity.permissions = permissions_1.removePermissionPolicy(this.entity.permissions, permission, id);
+    }
+    /*
+     * Get the editor config for the HubGroup entity.
+     * @param i18nScope translation scope to be interpolated into the uiSchema
+     * @param type editor type - corresonds to the returned uiSchema
+     * @param options optional hash of dynamic uiSchema element options
+     */
+    async getEditorConfig(i18nScope, type) {
+        // delegate to the schema subsystem
+        return getEditorConfig_1.getEditorConfig(i18nScope, type, this.entity, this.context);
+    }
+    /**
+     * Return the group as an editor object
+     */
+    async toEditor(editorContext = {}, include = []) {
+        // 1. optionally enrich entity and cast to editor
+        const editor = include.length
+            ? (await enrichEntity_1.enrichEntity(util_1.cloneObject(this.entity), include, this.context.hubRequestOptions))
+            : util_1.cloneObject(this.entity);
+        // 2. Apply transforms to relevant entity values so they
+        // can be consumed by the editor
+        return editor;
+    }
+    /**
+     * Load the group from the editor object
+     * @param editor
+     * @returns
+     */
+    async fromEditor(editor) {
+        const isCreate = !editor.id;
+        // Setting the thumbnailCache will ensure that
+        // the thumbnail is updated on next save
+        if (editor._thumbnail) {
+            if (editor._thumbnail.blob) {
+                this.thumbnailCache = {
+                    file: editor._thumbnail.blob,
+                    filename: editor._thumbnail.fileName,
+                    clear: false,
+                };
+            }
+            else {
+                this.thumbnailCache = {
+                    clear: true,
+                };
+            }
+        }
+        delete editor._thumbnail;
+        if (this.thumbnailCache) {
+            if (this.thumbnailCache.clear) {
+                await deleteGroupThumbnail_1.deleteGroupThumbnail(this.entity.id, this.context.userRequestOptions);
+            }
+            else {
+                await setGroupThumbnail_1.setGroupThumbnail(this.entity.id, this.thumbnailCache.file, this.thumbnailCache.filename, this.context.userRequestOptions, this.entity.owner);
+                // Note: updating the thumbnail alone does not update the modified date of the group
+                // thus we can just set props on the entity w/o re-fetching
+                this.entity.thumbnail = `thumbnail/${this.thumbnailCache.filename}`;
+                // Cover the Hub Group to an IGoup
+                const group = convertHubGroupToGroup_1.convertHubGroupToGroup(this.entity);
+                this.entity.thumbnailUrl = utils_1.getGroupThumbnailUrl(this.context.userRequestOptions.portal, group);
+                // clear the thumbnail cache
+                this.thumbnailCache = null;
+            }
+        }
+        // convert back to an entity. Apply any reverse transforms used in
+        // of the toEditor method
+        const entity = util_1.cloneObject(editor);
+        // create it if it does not yet exist...
+        if (isCreate) {
+            throw new Error("Cannot create group using the Editor.");
+        }
+        else {
+            // ...otherwise, update the in-memory entity and save it
+            this.entity = entity;
+            await this.save();
+        }
+        return this.entity;
+    }
+}
+exports.HubGroup = HubGroup;
+//# sourceMappingURL=HubGroup.js.map

package/dist/node/groups/HubGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HubGroup.js","sourceRoot":"","sources":["../../../src/groups/HubGroup.ts"],"names":[],"mappings":"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"}

package/dist/node/groups/_internal/AddOrInviteUsersToGroupUtils.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groupUsersByOrgRelationship = exports.handleNoUsers = exports.addOrInviteWorldUsers = exports.addOrInvitePartneredUsers = exports.addOrInviteOrgUsers = exports.addOrInviteCommunityUsers = exports.addOrInviteCollaborationCoordinators = void 0;
+const processAutoAddUsers_1 = require("./processAutoAddUsers");
+const processInviteUsers_1 = require("./processInviteUsers");
+// Add or invite flow based on the type of user begins here
+/**
+ * @private
+ * Handles add/invite logic for collaboration coordinators inside partnered orgs.
+ * This is intentionally split out from the invitation of partnered org normal members,
+ * because the two types of partnered org usres (regular and collaboration coordinator)
+ * always come from the same 'bucket', however have distinctly different add paths Invite vs auto add.
+ * It returns either an empty instance of the addOrInviteResponse
+ * object, or their response from auto adding users.
+ *
+ * @export
+ * @param {IAddOrInviteContext} context context object
+ * @return {IAddOrInviteResponse} response object
+ */
+async function addOrInviteCollaborationCoordinators(context) {
+    // If there are no org users return handling no users
+    if (!context.collaborationCoordinator ||
+        context.collaborationCoordinator.length === 0) {
+        // we return an empty object because
+        // if you leave out any of the props
+        // from the final object and you are concatting together arrays you can concat
+        // an undeifined inside an array which will throw off array lengths.
+        return handleNoUsers();
+    }
+    return processAutoAddUsers_1.processAutoAddUsers(context, "collaborationCoordinator");
+}
+exports.addOrInviteCollaborationCoordinators = addOrInviteCollaborationCoordinators;
+/**
+ * @private
+ * Handles add/invite logic for community users
+ * It returns either an empty instance of the addOrInviteResponse
+ * object, or either ther esponse from processing auto adding
+ * users or inviting users. If an email has been passed in it also notifies
+ * processAutoAddUsers that emails should be sent.
+ *
+ * @export
+ * @param {IAddOrInviteContext} context context object
+ * @return {IAddOrInviteResponse} response object
+ */
+async function addOrInviteCommunityUsers(context) {
+    // We default to handleNoUsers
+    // we return an empty object because
+    // if you leave out any of the props
+    // from the final object and you are concatting together arrays you can concat
+    // an undeifined inside an array which will throw off array lengths.
+    let fnToCall = handleNoUsers;
+    let shouldEmail = false;
+    // If community users were passed in...
+    if (context.community && context.community.length > 0) {
+        // Default to either autoAdd or invite based on canAutoAddUser.
+        fnToCall = context.canAutoAddUser
+            ? processAutoAddUsers_1.processAutoAddUsers
+            : processInviteUsers_1.processInviteUsers;
+        // If we have an email object
+        // Then we will auto add...
+        // But whether or not we email is still in question
+        if (context.email) {
+            // If the email object has the groupId property...
+            if (context.email.hasOwnProperty("groupId")) {
+                // If the email objects groupId property is the same as the current groupId in context...
+                // (This function is part of a flow that could work for N groupIds)
+                if (context.email.groupId === context.groupId) {
+                    // Then we auto add and send email
+                    fnToCall = processAutoAddUsers_1.processAutoAddUsers;
+                    shouldEmail = true;
+                } // ELSE if the groupId's do NOT match, we will fall back
+                // To autoAdd or invite as per line 32.
+                // We are doing the above logic (lines 43 - 47) because
+                // We wish to add users to core groups, followers, and content groups
+                // but only to email the core group.
+            }
+            else {
+                // If it does not have a groupId at all then we will autoAdd and email.
+                fnToCall = processAutoAddUsers_1.processAutoAddUsers;
+                shouldEmail = true;
+            }
+        }
+    }
+    // Return/call the function
+    return fnToCall(context, "community", shouldEmail);
+}
+exports.addOrInviteCommunityUsers = addOrInviteCommunityUsers;
+/**
+ * @private
+ * Handles add/invite logic for Org users
+ * It returns either an empty instance of the addOrInviteResponse
+ * object, or either ther esponse from processing auto adding a users or inviting a user
+ *
+ * @export
+ * @param {IAddOrInviteContext} context context object
+ * @return {IAddOrInviteResponse} response object
+ */
+async function addOrInviteOrgUsers(context) {
+    // If there are no org users return handling no users
+    if (!context.org || context.org.length === 0) {
+        // we return an empty object because
+        // if you leave out any of the props
+        // from the final object and you are concatting together arrays you can concat
+        // an undeifined inside an array which will throw off array lengths.
+        return handleNoUsers();
+    }
+    // for org user if you have assignUsers then auto add the user
+    // if not then invite the user
+    return context.canAutoAddUser
+        ? processAutoAddUsers_1.processAutoAddUsers(context, "org")
+        : processInviteUsers_1.processInviteUsers(context, "org");
+}
+exports.addOrInviteOrgUsers = addOrInviteOrgUsers;
+/**
+ * @private
+ * Handles add/invite logic for partnered org users.
+ * It returns either an empty instance of the addOrInviteResponse
+ * object, or their response from inviting users.
+ *
+ * @export
+ * @param {IAddOrInviteContext} context context object
+ * @return {IAddOrInviteResponse} response object
+ */
+async function addOrInvitePartneredUsers(context) {
+    // If there are no org users return handling no users
+    if (!context.partnered || context.partnered.length === 0) {
+        // we return an empty object because
+        // if you leave out any of the props
+        // from the final object and you are concatting together arrays you can concat
+        // an undeifined inside an array which will throw off array lengths.
+        return handleNoUsers();
+    }
+    // process invite
+    return processInviteUsers_1.processInviteUsers(context, "partnered");
+}
+exports.addOrInvitePartneredUsers = addOrInvitePartneredUsers;
+/**
+ * @private
+ * Handles add/invite logic for world users
+ * It either returns an empty instance of the add/invite response
+ * object, or a populated version from processInviteUsers
+ *
+ * @export
+ * @param {IAddOrInviteContext} context Context object
+ * @return {IAddOrInviteResponse} Response object
+ */
+async function addOrInviteWorldUsers(context) {
+    // If there are no world users return handling no users
+    if (!context.world || context.world.length === 0) {
+        // we return an empty object because
+        // if you leave out any of the props
+        // from the final object and you are concatting together arrays you can concat
+        // an undeifined inside an array which will throw off array lengths.
+        return handleNoUsers();
+    }
+    // process invite
+    return processInviteUsers_1.processInviteUsers(context, "world");
+}
+exports.addOrInviteWorldUsers = addOrInviteWorldUsers;
+// Add or invite flow based on the type of user ends here
+/**
+ * @private
+ * Returns an empty instance of the addorinviteresponse object.
+ * We are using this because if you leave out any of the props
+ * from the final object and you are concatting together arrays you can concat
+ * an undeifined inside an array which will throw off array lengths.
+ *
+ * @export
+ * @return {IAddOrInviteResponse}
+ */
+async function handleNoUsers(context, userType, shouldEmail) {
+    return {
+        notAdded: [],
+        notEmailed: [],
+        notInvited: [],
+        users: [],
+        errors: [],
+    };
+}
+exports.handleNoUsers = handleNoUsers;
+/**
+ * @private
+ * Takes users array and sorts them into an object by the type of user they are
+ * based on the orgType prop (world|org|community)
+ *
+ * @export
+ * @param {IUserWithOrgType[]} users array of users
+ * @return {IUserOrgRelationship} Object of users sorted by type (world, org, community)
+ */
+function groupUsersByOrgRelationship(users) {
+    return users.reduce((acc, user) => {
+        // keyof needed to make bracket notation work without TS throwing a wobbly.
+        const orgType = user.orgType;
+        acc[orgType].push(user);
+        return acc;
+    }, {
+        world: [],
+        org: [],
+        community: [],
+        partnered: [],
+        collaborationCoordinator: [],
+    });
+}
+exports.groupUsersByOrgRelationship = groupUsersByOrgRelationship;
+//# sourceMappingURL=AddOrInviteUsersToGroupUtils.js.map

package/dist/node/groups/_internal/AddOrInviteUsersToGroupUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddOrInviteUsersToGroupUtils.js","sourceRoot":"","sources":["../../../../src/groups/_internal/AddOrInviteUsersToGroupUtils.ts"],"names":[],"mappings":"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"}

package/dist/node/groups/_internal/GroupBusinessRules.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupPermissionPolicies = exports.GroupPermissions = void 0;
+/**
+ * Group Permission Policies
+ * These define the requirements any user must meet to perform related actions
+ * @private
+ */
+exports.GroupPermissions = [
+    "hub:group",
+    "hub:group:create",
+    "hub:group:delete",
+    "hub:group:edit",
+    "hub:group:view",
+    "hub:group:owner",
+    "hub:group:workspace:overview",
+    "hub:group:workspace:dashboard",
+    "hub:group:workspace:details",
+    "hub:group:workspace:settings",
+    "hub:group:workspace:collaborators",
+    "hub:group:workspace:content",
+    "hub:group:workspace:members",
+    "hub:group:shareContent",
+    "hub:group:manage",
+];
+/**
+ * Group permission policies
+ * @private
+ */
+exports.GroupPermissionPolicies = [
+    {
+        permission: "hub:group",
+        services: ["portal"],
+    },
+    {
+        permission: "hub:group:create",
+        dependencies: ["hub:group"],
+        authenticated: true,
+        privileges: ["portal:user:createGroup"],
+    },
+    {
+        permission: "hub:group:view",
+        dependencies: ["hub:group"],
+    },
+    {
+        permission: "hub:group:edit",
+        dependencies: ["hub:group"],
+        authenticated: true,
+        entityEdit: true,
+    },
+    {
+        permission: "hub:group:delete",
+        dependencies: ["hub:group"],
+        authenticated: true,
+        entityOwner: true,
+    },
+    {
+        permission: "hub:group:owner",
+        dependencies: ["hub:group"],
+        authenticated: true,
+        entityOwner: true,
+    },
+    {
+        permission: "hub:group:workspace:details",
+        dependencies: ["hub:group:edit"],
+    },
+    {
+        permission: "hub:group:workspace:settings",
+        dependencies: ["hub:group:edit"],
+    },
+    {
+        permission: "hub:group:workspace:content",
+        dependencies: ["hub:group:view"],
+    },
+    {
+        permission: "hub:group:workspace:members",
+        dependencies: ["hub:group:view"],
+    },
+    {
+        permission: "hub:group:shareContent",
+        dependencies: ["hub:group"],
+        authenticated: true,
+        privileges: ["portal:user:shareToGroup"],
+        assertions: [
+            {
+                property: "context:currentUser",
+                type: "is-group-member",
+                value: "entity:id",
+            },
+        ],
+    },
+    {
+        permission: "hub:group:manage",
+        dependencies: ["hub:group:edit"],
+    },
+];
+//# sourceMappingURL=GroupBusinessRules.js.map

package/dist/node/groups/_internal/GroupBusinessRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupBusinessRules.js","sourceRoot":"","sources":["../../../../src/groups/_internal/GroupBusinessRules.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACU,QAAA,gBAAgB,GAAG;IAC9B,WAAW;IACX,kBAAkB;IAClB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,8BAA8B;IAC9B,+BAA+B;IAC/B,6BAA6B;IAC7B,8BAA8B;IAC9B,mCAAmC;IACnC,6BAA6B;IAC7B,6BAA6B;IAC7B,wBAAwB;IACxB,kBAAkB;CACV,CAAC;AAEX;;;GAGG;AACU,QAAA,uBAAuB,GAAwB;IAC1D;QACE,UAAU,EAAE,WAAW;QACvB,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD;QACE,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,CAAC,yBAAyB,CAAC;KACxC;IACD;QACE,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,CAAC,WAAW,CAAC;KAC5B;IACD;QACE,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,IAAI;KACjB;IACD;QACE,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,UAAU,EAAE,6BAA6B;QACzC,YAAY,EAAE,CAAC,gBAAgB,CAAC;KACjC;IACD;QACE,UAAU,EAAE,8BAA8B;QAC1C,YAAY,EAAE,CAAC,gBAAgB,CAAC;KACjC;IACD;QACE,UAAU,EAAE,6BAA6B;QACzC,YAAY,EAAE,CAAC,gBAAgB,CAAC;KACjC;IACD;QACE,UAAU,EAAE,6BAA6B;QACzC,YAAY,EAAE,CAAC,gBAAgB,CAAC;KACjC;IACD;QACE,UAAU,EAAE,wBAAwB;QACpC,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,CAAC,0BAA0B,CAAC;QACxC,UAAU,EAAE;YACV;gBACE,QAAQ,EAAE,qBAAqB;gBAC/B,IAAI,EAAE,iBAAiB;gBACvB,KAAK,EAAE,WAAW;aACnB;SACF;KACF;IACD;QACE,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,CAAC,gBAAgB,CAAC;KACjC;CACF,CAAC"}

package/dist/node/groups/_internal/GroupSchema.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupSchema = exports.GroupEditorTypes = void 0;
+const shared_1 = require("../../core/schemas/shared");
+exports.GroupEditorTypes = [
+    "hub:group:edit",
+    "hub:group:settings",
+];
+/**
+ * Defines the JSON schema for a Hub Group's editable fields
+ */
+exports.GroupSchema = {
+    required: ["name"],
+    type: "object",
+    properties: {
+        name: shared_1.ENTITY_NAME_SCHEMA,
+        summary: Object.assign(Object.assign({}, shared_1.ENTITY_SUMMARY_SCHEMA), { 
+            // group snippets (mapped to summary on the entity) have
+            // a max char limit of 250
+            maxLength: 250 }),
+        _thumbnail: shared_1.ENTITY_IMAGE_SCHEMA,
+        membershipAccess: {
+            type: "string",
+            enum: ["organization", "collaborators", "anyone"],
+            default: "anyone",
+        },
+        isViewOnly: {
+            type: "boolean",
+            enum: [false, true],
+            default: false,
+        },
+    },
+};
+//# sourceMappingURL=GroupSchema.js.map

package/dist/node/groups/_internal/GroupSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupSchema.js","sourceRoot":"","sources":["../../../../src/groups/_internal/GroupSchema.ts"],"names":[],"mappings":";;;AACA,sDAImC;AAGtB,QAAA,gBAAgB,GAAG;IAC9B,gBAAgB;IAChB,oBAAoB;CACZ,CAAC;AAEX;;GAEG;AACU,QAAA,WAAW,GAAyB;IAC/C,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,2BAAkB;QACxB,OAAO,kCACF,8BAAqB;YACxB,wDAAwD;YACxD,0BAA0B;YAC1B,SAAS,EAAE,GAAG,GACf;QACD,UAAU,EAAE,4BAAmB;QAC/B,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,QAAQ,CAAC;YACjD,OAAO,EAAE,QAAQ;SAClB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;YACnB,OAAO,EAAE,KAAK;SACf;KACF;CACsB,CAAC"}