@esri/hub-common 13.17.2 → 13.17.4

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

@@ -0,0 +1,94 @@
+/**
+ * Group Permission Policies
+ * These define the requirements any user must meet to perform related actions
+ * @private
+ */
+export const 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
+ */
+export const 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/esm/groups/_internal/GroupBusinessRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupBusinessRules.js","sourceRoot":"","sources":["../../../../src/groups/_internal/GroupBusinessRules.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,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;AACH,MAAM,CAAC,MAAM,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/esm/groups/_internal/GroupSchema.js

@@ -0,0 +1,31 @@
+import { ENTITY_IMAGE_SCHEMA, ENTITY_NAME_SCHEMA, ENTITY_SUMMARY_SCHEMA, } from "../../core/schemas/shared";
+export const GroupEditorTypes = [
+    "hub:group:edit",
+    "hub:group:settings",
+];
+/**
+ * Defines the JSON schema for a Hub Group's editable fields
+ */
+export const GroupSchema = {
+    required: ["name"],
+    type: "object",
+    properties: {
+        name: ENTITY_NAME_SCHEMA,
+        summary: Object.assign(Object.assign({}, ENTITY_SUMMARY_SCHEMA), { 
+            // group snippets (mapped to summary on the entity) have
+            // a max char limit of 250
+            maxLength: 250 }),
+        _thumbnail: 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/esm/groups/_internal/GroupSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupSchema.js","sourceRoot":"","sources":["../../../../src/groups/_internal/GroupSchema.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB;IAChB,oBAAoB;CACZ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,kBAAkB;QACxB,OAAO,kCACF,qBAAqB;YACxB,wDAAwD;YACxD,0BAA0B;YAC1B,SAAS,EAAE,GAAG,GACf;QACD,UAAU,EAAE,mBAAmB;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"}

package/dist/esm/groups/_internal/GroupUiSchemaEdit.js

@@ -0,0 +1,62 @@
+/**
+ * @private
+ * constructs the complete edit uiSchema for Hub Groups
+ * This defines how the schema properties should be
+ * rendered in the group editing experience
+ */
+export const buildUiSchema = async (i18nScope, entity, context) => {
+    return {
+        type: "Layout",
+        elements: [
+            {
+                type: "Section",
+                labelKey: `${i18nScope}.sections.basicInfo.label`,
+                elements: [
+                    {
+                        labelKey: `${i18nScope}.fields.name.label`,
+                        scope: "/properties/name",
+                        type: "Control",
+                        options: {
+                            messages: [
+                                {
+                                    type: "ERROR",
+                                    keyword: "required",
+                                    icon: true,
+                                    labelKey: `${i18nScope}.fields.name.requiredError`,
+                                },
+                            ],
+                        },
+                    },
+                    {
+                        labelKey: `${i18nScope}.fields.summary.label`,
+                        scope: "/properties/summary",
+                        type: "Control",
+                        options: {
+                            control: "hub-field-input-input",
+                            type: "textarea",
+                        },
+                    },
+                    {
+                        labelKey: `${i18nScope}.fields._thumbnail.label`,
+                        scope: "/properties/_thumbnail",
+                        type: "Control",
+                        options: {
+                            control: "hub-field-input-image-picker",
+                            imgSrc: entity.thumbnailUrl,
+                            maxWidth: 727,
+                            maxHeight: 484,
+                            aspectRatio: 1,
+                            helperText: {
+                                labelKey: `${i18nScope}.fields._thumbnail.helperText`,
+                            },
+                            sizeDescription: {
+                                labelKey: `${i18nScope}.fields._thumbnail.sizeDescription`,
+                            },
+                        },
+                    },
+                ],
+            },
+        ],
+    };
+};
+//# sourceMappingURL=GroupUiSchemaEdit.js.map

package/dist/esm/groups/_internal/GroupUiSchemaEdit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupUiSchemaEdit.js","sourceRoot":"","sources":["../../../../src/groups/_internal/GroupUiSchemaEdit.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAAiB,EACjB,MAAiB,EACjB,OAAuB,EACH,EAAE;IACtB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,GAAG,SAAS,2BAA2B;gBACjD,QAAQ,EAAE;oBACR;wBACE,QAAQ,EAAE,GAAG,SAAS,oBAAoB;wBAC1C,KAAK,EAAE,kBAAkB;wBACzB,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,QAAQ,EAAE;gCACR;oCACE,IAAI,EAAE,OAAO;oCACb,OAAO,EAAE,UAAU;oCACnB,IAAI,EAAE,IAAI;oCACV,QAAQ,EAAE,GAAG,SAAS,4BAA4B;iCACnD;6BACF;yBACF;qBACF;oBACD;wBACE,QAAQ,EAAE,GAAG,SAAS,uBAAuB;wBAC7C,KAAK,EAAE,qBAAqB;wBAC5B,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,OAAO,EAAE,uBAAuB;4BAChC,IAAI,EAAE,UAAU;yBACjB;qBACF;oBACD;wBACE,QAAQ,EAAE,GAAG,SAAS,0BAA0B;wBAChD,KAAK,EAAE,wBAAwB;wBAC/B,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,OAAO,EAAE,8BAA8B;4BACvC,MAAM,EAAE,MAAM,CAAC,YAAY;4BAC3B,QAAQ,EAAE,GAAG;4BACb,SAAS,EAAE,GAAG;4BACd,WAAW,EAAE,CAAC;4BACd,UAAU,EAAE;gCACV,QAAQ,EAAE,GAAG,SAAS,+BAA+B;6BACtD;4BACD,eAAe,EAAE;gCACf,QAAQ,EAAE,GAAG,SAAS,oCAAoC;6BAC3D;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/groups/_internal/GroupUiSchemaSettings.js

@@ -0,0 +1,46 @@
+/**
+ * @private
+ * constructs the complete settings uiSchema for Hub Groups
+ * This defines how the schema properties should be
+ * rendered in the group settings experience
+ */
+export const buildUiSchema = async (i18nScope, entity, context) => {
+    return {
+        type: "Layout",
+        elements: [
+            {
+                type: "Section",
+                labelKey: `${i18nScope}.sections.membershipAccess.label`,
+                elements: [
+                    {
+                        labelKey: `${i18nScope}.fields.membershipAccess.label`,
+                        scope: "/properties/membershipAccess",
+                        type: "Control",
+                        options: {
+                            control: "hub-field-input-radio",
+                            labels: [
+                                `{{${i18nScope}.fields.membershipAccess.org:translate}}`,
+                                `{{${i18nScope}.fields.membershipAccess.collab:translate}}`,
+                                `{{${i18nScope}.fields.membershipAccess.any:translate}}`,
+                            ],
+                            disabled: [false, false, entity.isSharedUpdate],
+                        },
+                    },
+                    {
+                        labelKey: `${i18nScope}.fields.contributeContent.label`,
+                        scope: "/properties/isViewOnly",
+                        type: "Control",
+                        options: {
+                            control: "hub-field-input-radio",
+                            labels: [
+                                `{{${i18nScope}.fields.contributeContent.all:translate}}`,
+                                `{{${i18nScope}.fields.contributeContent.admins:translate}}`,
+                            ],
+                        },
+                    },
+                ],
+            },
+        ],
+    };
+};
+//# sourceMappingURL=GroupUiSchemaSettings.js.map

package/dist/esm/groups/_internal/GroupUiSchemaSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupUiSchemaSettings.js","sourceRoot":"","sources":["../../../../src/groups/_internal/GroupUiSchemaSettings.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAAiB,EACjB,MAAiB,EACjB,OAAuB,EACH,EAAE;IACtB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,GAAG,SAAS,kCAAkC;gBACxD,QAAQ,EAAE;oBACR;wBACE,QAAQ,EAAE,GAAG,SAAS,gCAAgC;wBACtD,KAAK,EAAE,8BAA8B;wBACrC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,OAAO,EAAE,uBAAuB;4BAChC,MAAM,EAAE;gCACN,KAAK,SAAS,0CAA0C;gCACxD,KAAK,SAAS,6CAA6C;gCAC3D,KAAK,SAAS,0CAA0C;6BACzD;4BACD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;yBAChD;qBACF;oBACD;wBACE,QAAQ,EAAE,GAAG,SAAS,iCAAiC;wBACvD,KAAK,EAAE,wBAAwB;wBAC/B,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,OAAO,EAAE,uBAAuB;4BAChC,MAAM,EAAE;gCACN,KAAK,SAAS,2CAA2C;gCACzD,KAAK,SAAS,8CAA8C;6BAC7D;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/groups/_internal/autoAddUsersAsAdmins.js

@@ -0,0 +1,24 @@
+import { addGroupUsers, } from "@esri/arcgis-rest-portal";
+/**
+ * @private
+ * Auto add N users to a single group, with users added as admins of that group
+ *
+ * @export
+ * @param {string} id Group ID
+ * @param {IUser[]} admins array of users to add to group as admin
+ * @param {IAuthenticationManager} authentication authentication manager
+ * @return {IAddGroupUsersResult} Result of the transaction (null if no users are passed in)
+ */
+export function autoAddUsersAsAdmins(id, admins, authentication) {
+    let response = Promise.resolve(null);
+    if (admins.length) {
+        const args = {
+            id,
+            admins: admins.map((a) => a.username),
+            authentication,
+        };
+        response = addGroupUsers(args);
+    }
+    return response;
+}
+//# sourceMappingURL=autoAddUsersAsAdmins.js.map

package/dist/esm/groups/_internal/autoAddUsersAsAdmins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoAddUsersAsAdmins.js","sourceRoot":"","sources":["../../../../src/groups/_internal/autoAddUsersAsAdmins.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,GACd,MAAM,0BAA0B,CAAC;AAGlC;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAU,EACV,MAAe,EACf,cAAsC;IAEtC,IAAI,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,EAAE;QACjB,MAAM,IAAI,GAAG;YACX,EAAE;YACF,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACrC,cAAc;SACf,CAAC;QACF,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;KAChC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/esm/groups/_internal/computeProps.js

@@ -0,0 +1,45 @@
+import { isDiscussable } from "../../discussions";
+import { getGroupThumbnailUrl } from "../../search/utils";
+/**
+ * Given a model and a group, set various computed properties that can't be directly mapped
+ * @private
+ * @param group
+ * @param hubGroup
+ * @param requestOptions
+ * @returns
+ */
+export function computeProps(group, hubGroup, requestOptions) {
+    var _a, _b, _c;
+    let token;
+    if (requestOptions.authentication) {
+        const session = requestOptions.authentication;
+        token = session.token;
+    }
+    // thumbnail url
+    hubGroup.thumbnailUrl = getGroupThumbnailUrl(requestOptions.portal, group, token);
+    // Handle Dates
+    hubGroup.createdDate = new Date(group.created);
+    hubGroup.createdDateSource = "group.created";
+    hubGroup.updatedDate = new Date(group.modified);
+    hubGroup.updatedDateSource = "group.modified";
+    hubGroup.type = "Group";
+    hubGroup.isDiscussable = isDiscussable(group);
+    // This tells us on if the group is an edit/view group.
+    // If it has the `updateitemcontrol` capability, it is an edit group
+    hubGroup.isSharedUpdate = (group.capabilities || []).includes("updateitemcontrol");
+    hubGroup.memberType = (_a = group.userMembership) === null || _a === void 0 ? void 0 : _a.memberType;
+    hubGroup.membershipAccess = "anyone";
+    if (group.membershipAccess === "org") {
+        hubGroup.membershipAccess = "organization";
+    }
+    if (group.membershipAccess === "collaboration") {
+        hubGroup.membershipAccess = "collaborators";
+    }
+    hubGroup.canEdit =
+        ((_b = group.userMembership) === null || _b === void 0 ? void 0 : _b.memberType) === "owner" ||
+            ((_c = group.userMembership) === null || _c === void 0 ? void 0 : _c.memberType) === "admin";
+    hubGroup.canDelete = hubGroup.canEdit;
+    // cast b/c this takes a partial but returns a full group
+    return hubGroup;
+}
+//# sourceMappingURL=computeProps.js.map

package/dist/esm/groups/_internal/computeProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeProps.js","sourceRoot":"","sources":["../../../../src/groups/_internal/computeProps.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,QAA4B,EAC5B,cAA+B;;IAE/B,IAAI,KAAa,CAAC;IAClB,IAAI,cAAc,CAAC,cAAc,EAAE;QACjC,MAAM,OAAO,GAAgB,cAAc,CAAC,cAA6B,CAAC;QAC1E,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;KACvB;IACD,gBAAgB;IAChB,QAAQ,CAAC,YAAY,GAAG,oBAAoB,CAC1C,cAAc,CAAC,MAAM,EACrB,KAAK,EACL,KAAK,CACN,CAAC;IAEF,eAAe;IACf,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,GAAG,eAAe,CAAC;IAC7C,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,QAAQ,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAE9C,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC;IAExB,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAE9C,uDAAuD;IACvD,oEAAoE;IACpE,QAAQ,CAAC,cAAc,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAC3D,mBAAmB,CACpB,CAAC;IAEF,QAAQ,CAAC,UAAU,SAAG,KAAK,CAAC,cAAc,0CAAE,UAAU,CAAC;IAEvD,QAAQ,CAAC,gBAAgB,GAAG,QAAQ,CAAC;IACrC,IAAI,KAAK,CAAC,gBAAgB,KAAK,KAAK,EAAE;QACpC,QAAQ,CAAC,gBAAgB,GAAG,cAAc,CAAC;KAC5C;IACD,IAAI,KAAK,CAAC,gBAAgB,KAAK,eAAe,EAAE;QAC9C,QAAQ,CAAC,gBAAgB,GAAG,eAAe,CAAC;KAC7C;IAED,QAAQ,CAAC,OAAO;QACd,OAAA,KAAK,CAAC,cAAc,0CAAE,UAAU,MAAK,OAAO;YAC5C,OAAA,KAAK,CAAC,cAAc,0CAAE,UAAU,MAAK,OAAO,CAAC;IAC/C,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC;IAEtC,yDAAyD;IACzD,OAAO,QAAqB,CAAC;AAC/B,CAAC"}

package/dist/esm/groups/_internal/convertGroupToHubGroup.js

@@ -0,0 +1,14 @@
+import { PropertyMapper } from "../../core/_internal/PropertyMapper";
+import { computeProps } from "./computeProps";
+import { getPropertyMap } from "./getPropertyMap";
+/**
+ * Convert an IGroup to a Hub Group
+ * @param group
+ * @param requestOptions
+ */
+export function convertGroupToHubGroup(group, requestOptions) {
+    const mapper = new PropertyMapper(getPropertyMap());
+    const hubGroup = mapper.storeToEntity(group, {});
+    return computeProps(group, hubGroup, requestOptions);
+}
+//# sourceMappingURL=convertGroupToHubGroup.js.map

package/dist/esm/groups/_internal/convertGroupToHubGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertGroupToHubGroup.js","sourceRoot":"","sources":["../../../../src/groups/_internal/convertGroupToHubGroup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;GAIG;AAEH,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,cAAmC;IAEnC,MAAM,MAAM,GAAG,IAAI,cAAc,CAC/B,cAAc,EAAE,CACjB,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,CAAc,CAAC;IAC9D,OAAO,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC"}

package/dist/esm/groups/_internal/convertHubGroupToGroup.js

@@ -0,0 +1,26 @@
+import { PropertyMapper } from "../../core/_internal/PropertyMapper";
+import { getPropertyMap } from "./getPropertyMap";
+/**
+ * Convert a Hub Group to an IGroup
+ * @param hubGroup
+ */
+export function convertHubGroupToGroup(hubGroup) {
+    const mapper = new PropertyMapper(getPropertyMap());
+    const group = mapper.entityToStore(hubGroup, {});
+    // convert the values for membershipAccess back to
+    // the ones the API accepts
+    if (group.membershipAccess === "organization") {
+        group.membershipAccess = "org";
+    }
+    if (group.membershipAccess === "collaborators") {
+        group.membershipAccess = "collaboration";
+    }
+    // since we are setting null to a prop, we need to
+    // send clearEmptyFields: true to the updateGroup call
+    if (group.membershipAccess === "anyone") {
+        group.membershipAccess = null;
+        group._clearEmptyFields = true;
+    }
+    return group;
+}
+//# sourceMappingURL=convertHubGroupToGroup.js.map

package/dist/esm/groups/_internal/convertHubGroupToGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertHubGroupToGroup.js","sourceRoot":"","sources":["../../../../src/groups/_internal/convertHubGroupToGroup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AAEH,MAAM,UAAU,sBAAsB,CAAC,QAAmB;IACxD,MAAM,MAAM,GAAG,IAAI,cAAc,CAC/B,cAAc,EAAE,CACjB,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAChC,QAAQ,EACR,EAAuB,CACd,CAAC;IACZ,kDAAkD;IAClD,2BAA2B;IAC3B,IAAI,KAAK,CAAC,gBAAgB,KAAK,cAAc,EAAE;QAC7C,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC;KAChC;IACD,IAAI,KAAK,CAAC,gBAAgB,KAAK,eAAe,EAAE;QAC9C,KAAK,CAAC,gBAAgB,GAAG,eAAe,CAAC;KAC1C;IACD,kDAAkD;IAClD,sDAAsD;IACtD,IAAI,KAAK,CAAC,gBAAgB,KAAK,QAAQ,EAAE;QACvC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC9B,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;KAChC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/groups/_internal/getPropertyMap.js

@@ -0,0 +1,40 @@
+/**
+ * Returns an Array of IPropertyMap objects
+ * that define the projection of properties from a IGroup to an IHubGroup
+ * @returns
+ * @private
+ */
+export function getPropertyMap() {
+    const map = [];
+    /**
+     * group-specific mappings
+     */
+    map.push({ entityKey: "name", storeKey: "title" });
+    map.push({ entityKey: "summary", storeKey: "snippet" });
+    map.push({ entityKey: "permissions", storeKey: "properties.permissions" });
+    // features is intentionally left out
+    const groupProps = [
+        "access",
+        "autoJoin",
+        "description",
+        "id",
+        "isInvitationOnly",
+        "isDiscussable",
+        "isReadOnly",
+        "isViewOnly",
+        "membershipAccess",
+        "owner",
+        "protected",
+        "sortField",
+        "sortOrder",
+        "tags",
+        "thumbnail",
+        "thumbnailUrl",
+        "userMembership",
+    ];
+    groupProps.forEach((entry) => {
+        map.push({ entityKey: entry, storeKey: entry });
+    });
+    return map;
+}
+//# sourceMappingURL=getPropertyMap.js.map

package/dist/esm/groups/_internal/getPropertyMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPropertyMap.js","sourceRoot":"","sources":["../../../../src/groups/_internal/getPropertyMap.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAmB,EAAE,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IACxD,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAE3E,qCAAqC;IAErC,MAAM,UAAU,GAAG;QACjB,QAAQ;QACR,UAAU;QACV,aAAa;QACb,IAAI;QACJ,kBAAkB;QAClB,eAAe;QACf,YAAY;QACZ,YAAY;QACZ,kBAAkB;QAClB,OAAO;QACP,WAAW;QACX,WAAW;QACX,WAAW;QACX,MAAM;QACN,WAAW;QACX,cAAc;QACd,gBAAgB;KACjB,CAAC;IACF,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/esm/groups/_internal/processAutoAddUsers.js

@@ -0,0 +1,62 @@
+import { getProp } from "../../objects/get-prop";
+import { autoAddUsers } from "../autoAddUsers";
+import { processEmailUsers } from "./processEmailUsers";
+import { autoAddUsersAsAdmins } from "./autoAddUsersAsAdmins";
+/**
+ * @private
+ * Governs logic for automatically adding N users to a group.
+ * Users are added as either a regular user OR as an administrator of the group
+ * depending on the addUserAsGroupAdmin prop on the IAddOrInviteContext.
+ * If there is an email object on the IAddOrInviteContext, then email notifications are sent.
+ *
+ * @export
+ * @param {IAddOrInviteContext} context context object
+ * @param {string} userType what type of user is it: org | world | community
+ * @param {boolean} [shouldEmail=false] should the user be emailed?
+ * @return {IAddOrInviteResponse} response object
+ */
+export async function processAutoAddUsers(context, userType, shouldEmail = false) {
+    // fetch users out of context object
+    const users = getProp(context, userType);
+    let autoAddResponse;
+    let emailResponse;
+    let notAdded = [];
+    let errors = [];
+    // fetch addUserAsGroupAdmin out of context
+    const { addUserAsGroupAdmin } = context;
+    if (addUserAsGroupAdmin) {
+        // if is core group we elevate user to admin
+        autoAddResponse = await autoAddUsersAsAdmins(getProp(context, "groupId"), users, getProp(context, "primaryRO"));
+    }
+    else {
+        // if not then we are just auto adding them
+        autoAddResponse = await autoAddUsers(getProp(context, "groupId"), users, getProp(context, "primaryRO"));
+    }
+    // handle notAdded users
+    if (autoAddResponse.notAdded) {
+        notAdded = notAdded.concat(autoAddResponse.notAdded);
+    }
+    // Merge errors into empty array
+    if (autoAddResponse.errors) {
+        errors = errors.concat(autoAddResponse.errors);
+    }
+    // run email process
+    if (shouldEmail) {
+        emailResponse = await processEmailUsers(context);
+        // merge errors in to overall errors array to keep things flat
+        if (emailResponse.errors && emailResponse.errors.length > 0) {
+            errors = errors.concat(emailResponse.errors);
+        }
+    }
+    // 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 {
+        users: users.map((u) => u.username),
+        notAdded,
+        errors,
+        notEmailed: (emailResponse === null || emailResponse === void 0 ? void 0 : emailResponse.notEmailed) || [],
+        notInvited: [],
+    };
+}
+//# sourceMappingURL=processAutoAddUsers.js.map

package/dist/esm/groups/_internal/processAutoAddUsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processAutoAddUsers.js","sourceRoot":"","sources":["../../../../src/groups/_internal/processAutoAddUsers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA4B,EAC5B,QAK8B,EAC9B,cAAuB,KAAK;IAE5B,oCAAoC;IACpC,MAAM,KAAK,GAAY,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,eAAe,CAAC;IACpB,IAAI,aAAa,CAAC;IAClB,IAAI,QAAQ,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,GAAyB,EAAE,CAAC;IACtC,2CAA2C;IAC3C,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;IAExC,IAAI,mBAAmB,EAAE;QACvB,4CAA4C;QAC5C,eAAe,GAAG,MAAM,oBAAoB,CAC1C,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EAC3B,KAAK,EACL,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAC9B,CAAC;KACH;SAAM;QACL,2CAA2C;QAC3C,eAAe,GAAG,MAAM,YAAY,CAClC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EAC3B,KAAK,EACL,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAC9B,CAAC;KACH;IACD,wBAAwB;IACxB,IAAI,eAAe,CAAC,QAAQ,EAAE;QAC5B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;KACtD;IACD,gCAAgC;IAChC,IAAI,eAAe,CAAC,MAAM,EAAE;QAC1B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;KAChD;IACD,oBAAoB;IACpB,IAAI,WAAW,EAAE;QACf,aAAa,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACjD,8DAA8D;QAC9D,IAAI,aAAa,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;YAC3D,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;SAC9C;KACF;IACD,oCAAoC;IACpC,8EAA8E;IAC9E,oEAAoE;IACpE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnC,QAAQ;QACR,MAAM;QACN,UAAU,EAAE,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,UAAU,KAAI,EAAE;QAC3C,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC"}

package/dist/esm/groups/_internal/processEmailUsers.js

@@ -0,0 +1,50 @@
+import { getProp } from "../../objects/get-prop";
+import { emailOrgUsers } from "../emailOrgUsers";
+/**
+ * @private
+ * Governs the logic for emailing N users. It acts under the assumption
+ * that all the 'community' users are the ones being emailed (this is due to platform rules we conform to)
+ * Function is called upstream depending on if an email object is attached to the context.
+ * Email object contains its own auth as it'll require the community admin to send the email itself.
+ * An individual email call goes out for each user due to how the response of multiple users in a single call works.
+ *
+ * @export
+ * @param {IAddOrInviteContext} context context object
+ * @return {IAddOrInviteResponse} response object
+ */
+export async function processEmailUsers(context) {
+    // Fetch users out of context. We only email community users so we are
+    // explicit about that
+    const users = getProp(context, "community");
+    const notEmailed = [];
+    let errors = [];
+    // iterate through users as we want a distinct email call per user due to how
+    // batch email will only respond with success: true/false
+    // and if there is an error then it gets priority even though successes do still go through
+    for (const user of users) {
+        // Make email call...
+        const emailResponse = await emailOrgUsers([user], getProp(context, "email.message"), getProp(context, "email.auth"), true);
+        // If it's just a failed email
+        // then add username to notEmailed array
+        if (!emailResponse.success) {
+            notEmailed.push(user.username);
+            // If there was a legit error
+            // Then only the error returns from
+            // online. Add error AND include username in notEmailed array.
+            if (emailResponse.errors) {
+                errors = errors.concat(emailResponse.errors);
+            }
+        }
+    }
+    // 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 {
+        users: users.map((u) => u.username),
+        notEmailed,
+        errors,
+        notInvited: [],
+        notAdded: [],
+    };
+}
+//# sourceMappingURL=processEmailUsers.js.map

package/dist/esm/groups/_internal/processEmailUsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processEmailUsers.js","sourceRoot":"","sources":["../../../../src/groups/_internal/processEmailUsers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA4B;IAE5B,sEAAsE;IACtE,sBAAsB;IACtB,MAAM,KAAK,GAAY,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,MAAM,GAAyB,EAAE,CAAC;IACtC,6EAA6E;IAC7E,yDAAyD;IACzD,2FAA2F;IAC3F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACxB,qBAAqB;QACrB,MAAM,aAAa,GAAG,MAAM,aAAa,CACvC,CAAC,IAAI,CAAC,EACN,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,EACjC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,EAC9B,IAAI,CACL,CAAC;QACF,8BAA8B;QAC9B,wCAAwC;QACxC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;YAC1B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,6BAA6B;YAC7B,mCAAmC;YACnC,8DAA8D;YAC9D,IAAI,aAAa,CAAC,MAAM,EAAE;gBACxB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;aAC9C;SACF;KACF;IACD,oCAAoC;IACpC,8EAA8E;IAC9E,oEAAoE;IACpE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnC,UAAU;QACV,MAAM;QACN,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC"}

package/dist/esm/groups/_internal/processInviteUsers.js

@@ -0,0 +1,51 @@
+import { getProp } from "../../objects/get-prop";
+import { inviteUsers } from "../inviteUsers";
+/**
+ * @private
+ * Governs the logic for inviting N users to a single group.
+ * An individual invite call goes out for each user and the results are consolidated.
+ * See comment in function about the for...of loop which explains reasoning.
+ *
+ * @export
+ * @param {IAddOrInviteContext} context context object
+ * @param {string} userType what type of user is it: org | world | community
+ * @return {IAddOrInviteResponse} response object
+ */
+export async function processInviteUsers(context, userType) {
+    // Fetch users out of context based on userType
+    const users = getProp(context, userType);
+    const notInvited = [];
+    let errors = [];
+    const { addUserAsGroupAdmin } = context;
+    // iterate through users as we want a distinct invite call per user due to how
+    // batch invites will only respond with success: true/false
+    // and if there is an error then it gets priority even though successes do still go through
+    for (const user of users) {
+        // Invite users call
+        const inviteResponse = await inviteUsers(getProp(context, "groupId"), [user], getProp(context, "primaryRO"), 20160, // timeout
+        addUserAsGroupAdmin ? "group_admin" : "group_member" // if we are in a core group we want to invite them as a group admin, otherwise a group member
+        );
+        // If it's just a failed invite then
+        // add username to notInvited array
+        if (!inviteResponse.success) {
+            notInvited.push(user.username);
+            // If there was a legit error
+            // Then only the error returns from
+            // online. Add error AND include username in notInvited array.
+            if (inviteResponse.errors) {
+                errors = errors.concat(inviteResponse.errors);
+            }
+        }
+    }
+    // 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 {
+        users: users.map((u) => u.username),
+        notInvited,
+        errors,
+        notEmailed: [],
+        notAdded: [],
+    };
+}
+//# sourceMappingURL=processInviteUsers.js.map

package/dist/esm/groups/_internal/processInviteUsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processInviteUsers.js","sourceRoot":"","sources":["../../../../src/groups/_internal/processInviteUsers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA4B,EAC5B,QAAqD;IAErD,+CAA+C;IAC/C,MAAM,KAAK,GAAY,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,MAAM,GAAyB,EAAE,CAAC;IACtC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;IACxC,8EAA8E;IAC9E,2DAA2D;IAC3D,2FAA2F;IAC3F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACxB,oBAAoB;QACpB,MAAM,cAAc,GAAG,MAAM,WAAW,CACtC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,EAC3B,CAAC,IAAI,CAAC,EACN,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,EAC7B,KAAK,EAAE,UAAU;QACjB,mBAAmB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,8FAA8F;SACpJ,CAAC;QACF,oCAAoC;QACpC,mCAAmC;QACnC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC3B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,6BAA6B;YAC7B,mCAAmC;YACnC,8DAA8D;YAC9D,IAAI,cAAc,CAAC,MAAM,EAAE;gBACzB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;aAC/C;SACF;KACF;IACD,oCAAoC;IACpC,8EAA8E;IAC9E,oEAAoE;IACpE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnC,UAAU;QACV,MAAM;QACN,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC"}