@esri/hub-common 14.21.1 → 14.22.0

package/dist/esm/groups/addGroupMembers.js

@@ -0,0 +1,79 @@
+import { failSafe } from "../utils";
+import { autoAddUsers } from "./autoAddUsers";
+import { inviteUsers } from "./inviteUsers";
+/**
+ * Add or invite N users to a single group.
+ * If autoAdd is true (if the user doing the adding has the 'portal:admin:assignToGroups' priv)
+ * then we attempt to auto add EVERY user to the group.
+ * If that call fails, then we attempt to invite them.
+ *
+ * @export
+ * @param {string} groupId ID of the group the users will be added to
+ * @param {string[]} usernames usernames of the users to add
+ * @param {IUserRequestOptions} auth Auth
+ * @param {boolean} autoAdd should we auto add users?
+ * @return {*}  {Promise<IAddGroupMembersResult>}
+ */
+export async function addGroupMembers(groupId, usernames, auth, autoAdd) {
+    const added = [];
+    const invited = [];
+    const notAdded = [];
+    const notInvited = [];
+    const responses = [];
+    // iterate through users as we want a distinct add/invite call per user.
+    // This is primarily because batch inviting of users will only return a single consolidated
+    // 'success' response, which provides no granularity on which users were actually successfully invited.
+    // Similarly errors are consolidated into a single array, which again provides no granularity on which users
+    // experienced the error.
+    for (const username of usernames) {
+        let inviteUser = true;
+        const response = {
+            username,
+            add: null,
+            invite: null,
+        };
+        // expand user into an 'IUser' object for add/invite functions to then extract...
+        const user = { username };
+        // Create failSafe functions for add/invite
+        const failSafeAdd = failSafe(autoAddUsers);
+        const failSafeInvite = failSafe(inviteUsers);
+        // If we can add the user automatically, then attempt to do so
+        if (autoAdd) {
+            // fail safe add
+            const addResponse = await failSafeAdd(groupId, [user], auth.authentication);
+            // add response to response obj
+            response.add = addResponse;
+            // if they were added, then don't invite and add to added array
+            if (!addResponse.notAdded || addResponse.notAdded.length === 0) {
+                inviteUser = false;
+                added.push(username);
+            }
+            else {
+                notAdded.push(username);
+            }
+        }
+        if (inviteUser) {
+            // fail safe invite
+            const inviteResponse = await failSafeInvite(groupId, [user], auth.authentication);
+            // add response to response obj
+            response.invite = inviteResponse;
+            // if they were invited, then add to invited array
+            if (inviteResponse.success) {
+                invited.push(username);
+            }
+            else {
+                notInvited.push(username);
+            }
+        }
+        // push response to responses array
+        responses.push(response);
+    }
+    return {
+        added,
+        invited,
+        notAdded,
+        notInvited,
+        responses,
+    };
+}
+//# sourceMappingURL=addGroupMembers.js.map

package/dist/esm/groups/addGroupMembers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addGroupMembers.js","sourceRoot":"","sources":["../../../src/groups/addGroupMembers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,SAAmB,EACnB,IAAyB,EACzB,OAAgB;IAEhB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GAAiC,EAAE,CAAC;IACnD,wEAAwE;IACxE,2FAA2F;IAC3F,uGAAuG;IACvG,4GAA4G;IAC5G,yBAAyB;IACzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;QAChC,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,MAAM,QAAQ,GAA+B;YAC3C,QAAQ;YACR,GAAG,EAAE,IAAI;YACT,MAAM,EAAE,IAAI;SACb,CAAC;QACF,iFAAiF;QACjF,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAW,CAAC;QACnC,2CAA2C;QAC3C,MAAM,WAAW,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,cAAc,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC7C,8DAA8D;QAC9D,IAAI,OAAO,EAAE;YACX,gBAAgB;YAChB,MAAM,WAAW,GAAG,MAAM,WAAW,CACnC,OAAO,EACP,CAAC,IAAI,CAAC,EACN,IAAI,CAAC,cAAc,CACpB,CAAC;YACF,+BAA+B;YAC/B,QAAQ,CAAC,GAAG,GAAG,WAAW,CAAC;YAC3B,+DAA+D;YAC/D,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC9D,UAAU,GAAG,KAAK,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACtB;iBAAM;gBACL,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACzB;SACF;QACD,IAAI,UAAU,EAAE;YACd,mBAAmB;YACnB,MAAM,cAAc,GAAG,MAAM,cAAc,CACzC,OAAO,EACP,CAAC,IAAI,CAAC,EACN,IAAI,CAAC,cAAc,CACpB,CAAC;YACF,+BAA+B;YAC/B,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC;YACjC,kDAAkD;YAClD,IAAI,cAAc,CAAC,OAAO,EAAE;gBAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACxB;iBAAM;gBACL,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aAC3B;SACF;QACD,mCAAmC;QACnC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;KAC1B;IACD,OAAO;QACL,KAAK;QACL,OAAO;QACP,QAAQ;QACR,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/esm/groups/index.js

@@ -3,8 +3,7 @@ export * from "./add-users-workflow";
 export * from "./types";
 export * from "./HubGroups";
 export * from "./HubGroup";
-export * from "./addOrInviteUsersToGroup";
-export * from "./addOrInviteUsersToGroups";
+export * from "./addGroupMembers";
 // TODO: The below are being used in hub-teams. When we deprecate that package we can move
 // The below into _internal and remove the exports from here. They were previously in
 // the add-users-workflow directory

package/dist/esm/groups/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/groups/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,0FAA0F;AAC1F,qFAAqF;AACrF,mCAAmC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/groups/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,0FAA0F;AAC1F,qFAAqF;AACrF,mCAAmC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/node/groups/addGroupMembers.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGroupMembers = void 0;
+const utils_1 = require("../utils");
+const autoAddUsers_1 = require("./autoAddUsers");
+const inviteUsers_1 = require("./inviteUsers");
+/**
+ * Add or invite N users to a single group.
+ * If autoAdd is true (if the user doing the adding has the 'portal:admin:assignToGroups' priv)
+ * then we attempt to auto add EVERY user to the group.
+ * If that call fails, then we attempt to invite them.
+ *
+ * @export
+ * @param {string} groupId ID of the group the users will be added to
+ * @param {string[]} usernames usernames of the users to add
+ * @param {IUserRequestOptions} auth Auth
+ * @param {boolean} autoAdd should we auto add users?
+ * @return {*}  {Promise<IAddGroupMembersResult>}
+ */
+async function addGroupMembers(groupId, usernames, auth, autoAdd) {
+    const added = [];
+    const invited = [];
+    const notAdded = [];
+    const notInvited = [];
+    const responses = [];
+    // iterate through users as we want a distinct add/invite call per user.
+    // This is primarily because batch inviting of users will only return a single consolidated
+    // 'success' response, which provides no granularity on which users were actually successfully invited.
+    // Similarly errors are consolidated into a single array, which again provides no granularity on which users
+    // experienced the error.
+    for (const username of usernames) {
+        let inviteUser = true;
+        const response = {
+            username,
+            add: null,
+            invite: null,
+        };
+        // expand user into an 'IUser' object for add/invite functions to then extract...
+        const user = { username };
+        // Create failSafe functions for add/invite
+        const failSafeAdd = utils_1.failSafe(autoAddUsers_1.autoAddUsers);
+        const failSafeInvite = utils_1.failSafe(inviteUsers_1.inviteUsers);
+        // If we can add the user automatically, then attempt to do so
+        if (autoAdd) {
+            // fail safe add
+            const addResponse = await failSafeAdd(groupId, [user], auth.authentication);
+            // add response to response obj
+            response.add = addResponse;
+            // if they were added, then don't invite and add to added array
+            if (!addResponse.notAdded || addResponse.notAdded.length === 0) {
+                inviteUser = false;
+                added.push(username);
+            }
+            else {
+                notAdded.push(username);
+            }
+        }
+        if (inviteUser) {
+            // fail safe invite
+            const inviteResponse = await failSafeInvite(groupId, [user], auth.authentication);
+            // add response to response obj
+            response.invite = inviteResponse;
+            // if they were invited, then add to invited array
+            if (inviteResponse.success) {
+                invited.push(username);
+            }
+            else {
+                notInvited.push(username);
+            }
+        }
+        // push response to responses array
+        responses.push(response);
+    }
+    return {
+        added,
+        invited,
+        notAdded,
+        notInvited,
+        responses,
+    };
+}
+exports.addGroupMembers = addGroupMembers;
+//# sourceMappingURL=addGroupMembers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addGroupMembers.js","sourceRoot":"","sources":["../../../src/groups/addGroupMembers.ts"],"names":[],"mappings":";;;AAEA,oCAAoC;AACpC,iDAA8C;AAC9C,+CAA4C;AAI5C;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,SAAmB,EACnB,IAAyB,EACzB,OAAgB;IAEhB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GAAiC,EAAE,CAAC;IACnD,wEAAwE;IACxE,2FAA2F;IAC3F,uGAAuG;IACvG,4GAA4G;IAC5G,yBAAyB;IACzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;QAChC,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,MAAM,QAAQ,GAA+B;YAC3C,QAAQ;YACR,GAAG,EAAE,IAAI;YACT,MAAM,EAAE,IAAI;SACb,CAAC;QACF,iFAAiF;QACjF,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAW,CAAC;QACnC,2CAA2C;QAC3C,MAAM,WAAW,GAAG,gBAAQ,CAAC,2BAAY,CAAC,CAAC;QAC3C,MAAM,cAAc,GAAG,gBAAQ,CAAC,yBAAW,CAAC,CAAC;QAC7C,8DAA8D;QAC9D,IAAI,OAAO,EAAE;YACX,gBAAgB;YAChB,MAAM,WAAW,GAAG,MAAM,WAAW,CACnC,OAAO,EACP,CAAC,IAAI,CAAC,EACN,IAAI,CAAC,cAAc,CACpB,CAAC;YACF,+BAA+B;YAC/B,QAAQ,CAAC,GAAG,GAAG,WAAW,CAAC;YAC3B,+DAA+D;YAC/D,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC9D,UAAU,GAAG,KAAK,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACtB;iBAAM;gBACL,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACzB;SACF;QACD,IAAI,UAAU,EAAE;YACd,mBAAmB;YACnB,MAAM,cAAc,GAAG,MAAM,cAAc,CACzC,OAAO,EACP,CAAC,IAAI,CAAC,EACN,IAAI,CAAC,cAAc,CACpB,CAAC;YACF,+BAA+B;YAC/B,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC;YACjC,kDAAkD;YAClD,IAAI,cAAc,CAAC,OAAO,EAAE;gBAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACxB;iBAAM;gBACL,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aAC3B;SACF;QACD,mCAAmC;QACnC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;KAC1B;IACD,OAAO;QACL,KAAK;QACL,OAAO;QACP,QAAQ;QACR,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAxED,0CAwEC"}

package/dist/node/groups/index.js

@@ -6,8 +6,7 @@ tslib_1.__exportStar(require("./add-users-workflow"), exports);
 tslib_1.__exportStar(require("./types"), exports);
 tslib_1.__exportStar(require("./HubGroups"), exports);
 tslib_1.__exportStar(require("./HubGroup"), exports);
-tslib_1.__exportStar(require("./addOrInviteUsersToGroup"), exports);
-tslib_1.__exportStar(require("./addOrInviteUsersToGroups"), exports);
+tslib_1.__exportStar(require("./addGroupMembers"), exports);
 // TODO: The below are being used in hub-teams. When we deprecate that package we can move
 // The below into _internal and remove the exports from here. They were previously in
 // the add-users-workflow directory

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/groups/index.ts"],"names":[],"mappings":";;;AAAA,wEAA8C;AAC9C,+DAAqC;AACrC,kDAAwB;AACxB,sDAA4B;AAC5B,qDAA2B;AAC3B,oEAA0C;AAC1C,qEAA2C;AAC3C,0FAA0F;AAC1F,qFAAqF;AACrF,mCAAmC;AACnC,yDAA+B;AAC/B,wDAA8B;AAC9B,0DAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/groups/index.ts"],"names":[],"mappings":";;;AAAA,wEAA8C;AAC9C,+DAAqC;AACrC,kDAAwB;AACxB,sDAA4B;AAC5B,qDAA2B;AAC3B,4DAAkC;AAClC,0FAA0F;AAC1F,qFAAqF;AACrF,mCAAmC;AACnC,yDAA+B;AAC/B,wDAA8B;AAC9B,0DAAgC"}

package/dist/types/groups/addGroupMembers.d.ts

@@ -0,0 +1,16 @@
+import { IAddGroupMembersResult } from "./types";
+import { IUserRequestOptions } from "@esri/arcgis-rest-auth";
+/**
+ * Add or invite N users to a single group.
+ * If autoAdd is true (if the user doing the adding has the 'portal:admin:assignToGroups' priv)
+ * then we attempt to auto add EVERY user to the group.
+ * If that call fails, then we attempt to invite them.
+ *
+ * @export
+ * @param {string} groupId ID of the group the users will be added to
+ * @param {string[]} usernames usernames of the users to add
+ * @param {IUserRequestOptions} auth Auth
+ * @param {boolean} autoAdd should we auto add users?
+ * @return {*}  {Promise<IAddGroupMembersResult>}
+ */
+export declare function addGroupMembers(groupId: string, usernames: string[], auth: IUserRequestOptions, autoAdd: boolean): Promise<IAddGroupMembersResult>;

package/dist/types/groups/index.d.ts

@@ -3,8 +3,7 @@ export * from "./add-users-workflow";
 export * from "./types";
 export * from "./HubGroups";
 export * from "./HubGroup";
-export * from "./addOrInviteUsersToGroup";
-export * from "./addOrInviteUsersToGroups";
+export * from "./addGroupMembers";
 export * from "./autoAddUsers";
 export * from "./inviteUsers";
 export * from "./emailOrgUsers";

package/dist/types/groups/types/types.d.ts

@@ -1,72 +1,21 @@
-import { ArcGISRequestError, IAuthenticationManager } from "@esri/arcgis-rest-request";
-import { IUser } from "@esri/arcgis-rest-types";
+import { IAddGroupUsersResult, IInviteGroupUsersResult } from "@esri/arcgis-rest-portal";
 export interface IEmail {
     subject?: string;
     body?: string;
     copyMe?: boolean;
 }
 /**
- * User object returned from add users modal in ember application
- * It extends the IUser interface with an additional property
- * that denotes what org relationship the user might have (world|org|community|partnered|collaborationCoordinator)
+ * Interface for result object out of addGroupMembers.
  */
-export interface IUserWithOrgType extends IUser {
-    orgType: "world" | "org" | "community" | "partnered" | "collaborationCoordinator";
-}
-/**
- * User org relationship interface
- * Object contains users parsed by their org relationship (world|org|community|partnered|collaborationCoordinator)
- */
-export interface IUserOrgRelationship {
-    world: IUserWithOrgType[];
-    org: IUserWithOrgType[];
-    community: IUserWithOrgType[];
-    partnered: IUserWithOrgType[];
-    collaborationCoordinator: IUserWithOrgType[];
-}
-/**
- * Interface governing the add or invite response out of process auto add / invite / emailing users
- */
-export interface IAddOrInviteResponse {
-    users: string[];
-    errors: ArcGISRequestError[];
+export interface IAddGroupMembersResult {
+    added: string[];
+    invited: string[];
     notAdded: string[];
     notInvited: string[];
-    notEmailed: string[];
-}
-/**
- * Email input object for add/invite flow
- * contains both the IEmail object and auth for the email.
- */
-export interface IAddOrInviteEmail {
-    message: IEmail;
-    auth: IAuthenticationManager;
-    groupId?: string;
-}
-/**
- * Add or invite flow context - object that contains all the needed
- * inputs for org/world/community users
- */
-export interface IAddOrInviteContext extends IUserOrgRelationship {
-    groupId: string;
-    primaryRO: IAuthenticationManager;
-    allUsers: IUserWithOrgType[];
-    canAutoAddUser: boolean;
-    addUserAsGroupAdmin: boolean;
-    email: IAddOrInviteEmail;
+    responses: IAddOrInviteMemberResponse[];
 }
-/**
- * Interface for result object out of addOrInviteUsersToGroup.
- */
-export interface IAddOrInviteToGroupResult {
-    errors: ArcGISRequestError[];
-    notAdded: string[];
-    notInvited: string[];
-    notEmailed: string[];
-    community: IAddOrInviteResponse;
-    org: IAddOrInviteResponse;
-    world: IAddOrInviteResponse;
-    partnered: IAddOrInviteResponse;
-    collaborationCoordinator: IAddOrInviteResponse;
-    groupId: string;
+export interface IAddOrInviteMemberResponse {
+    username: string;
+    add: IAddGroupUsersResult;
+    invite: IInviteGroupUsersResult;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esri/hub-common",
-  "version": "14.21.1",
+  "version": "14.22.0",
   "description": "Common TypeScript types and utility functions for @esri/hub.js.",
   "main": "dist/node/index.js",
   "module": "dist/esm/index.js",

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

@@ -1,195 +0,0 @@
-import { processAutoAddUsers } from "./processAutoAddUsers";
-import { processInviteUsers } from "./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
- */
-export 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(context, "collaborationCoordinator");
-}
-/**
- * @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
- */
-export 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
-            : 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;
-                    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;
-                shouldEmail = true;
-            }
-        }
-    }
-    // Return/call the function
-    return fnToCall(context, "community", shouldEmail);
-}
-/**
- * @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
- */
-export 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(context, "org")
-        : processInviteUsers(context, "org");
-}
-/**
- * @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
- */
-export 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(context, "partnered");
-}
-/**
- * @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
- */
-export 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(context, "world");
-}
-// 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}
- */
-export async function handleNoUsers(context, userType, shouldEmail) {
-    return {
-        notAdded: [],
-        notEmailed: [],
-        notInvited: [],
-        users: [],
-        errors: [],
-    };
-}
-/**
- * @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)
- */
-export 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: [],
-    });
-}
-//# sourceMappingURL=AddOrInviteUsersToGroupUtils.js.map

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

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

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

@@ -1,62 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,50 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}