feat: allow assigning role during user creation via developername

.gitignore

@@ -47,3 +47,7 @@ node_modules
 # os specific files
 .DS_Store
 .idea
+
+# exclude sfdx and sf config files
+.sf 
+.sfdx

src/commands/org/create/user.ts

@@ -197,6 +197,9 @@ export class CreateUserCommand extends SfCommand<CreateUserOutput> {
         } else if (key.toLowerCase() === 'profilename') {
           // @ts-expect-error standardize profileName casing
           defaultFields['profileName'] = this.varargs[key];
+        } else if (key.toLowerCase() === 'roledevelopername') {
+          // @ts-expect-error standardize roleDeveloperName casing
+          defaultFields['roleDeveloperName'] = this.varargs[key];
         } else {
           // @ts-expect-error all other varargs are left "as is"
           defaultFields[lowerFirstLetter(key)] = this.varargs[key];
@@ -220,6 +223,18 @@ export class CreateUserCommand extends SfCommand<CreateUserOutput> {
       defaultFields.profileId = profile.Id;
     }
 
+    // @ts-expect-error check if "roleDeveloperName" was passed, this needs to become a userRoleId before calling User.create
+    if (defaultFields['roleDeveloperName']) {
+      // @ts-expect-error roleDeveloperName is not a valid field on UserFields
+      const devName = defaultFields['roleDeveloperName'] as string;
+      logger.debug(`Querying org for user role name [${devName}]`);
+      const userRole = await this.flags['target-org']
+        .getConnection(this.flags['api-version'])
+        .singleRecordQuery<{ Id: string }>(`SELECT id FROM userrole WHERE developername='${devName}'`);
+      // @ts-expect-error userRoleId is an optional field therefore not defined on UserFields
+      defaultFields['userRoleId'] = userRole.Id;
+    }
+
     return defaultFields;
   }
 
@@ -280,7 +295,7 @@ const lowerFirstLetter = (word: string): string => word[0].toLowerCase() + word.
  * @private
  */
 const stripInvalidAPIFields = (fields: UserFields & Dictionary<string>): UserFields =>
-  omit(fields, ['permsets', 'generatepassword', 'generatePassword', 'profileName']);
+  omit(fields, ['permsets', 'generatepassword', 'generatePassword', 'profileName', 'roleDeveloperName']);
 
 const getNewUserAuthInfo = async (
   targetOrgUser: User,

test/commands/create.test.ts

@@ -157,7 +157,9 @@ describe('org:create:user', () => {
     }
 
     if (readsFile) {
-      $$.SANDBOXES.CONNECTION.stub(Connection.prototype, 'singleRecordQuery').resolves({ Id: '12345678' });
+      $$.SANDBOXES.CONNECTION.stub(Connection.prototype, 'singleRecordQuery')
+      .withArgs('SELECT id FROM profile WHERE name=\'profileFromArgs\'').resolves({ Id: '12345678' })
+      .withArgs('SELECT id FROM userrole WHERE developername=\'roleFromArgs\'').resolves({ Id: '87654321' })
       $$.SANDBOX.stub(Logger.prototype, 'debug');
       if (typeof readsFile !== 'boolean') {
         const fsStub = $$.SANDBOX.stub(fs.promises, 'readFile');

test/df17AppBuilding/config/complexUser.json

@@ -8,5 +8,6 @@
   "LanguageLocaleKey": "en_US",
   "profileName": "Standard Platform User",
   "permsets": ["VolunteeringApp"],
+  "roleDeveloperName": "Guide",
   "generatePassword": true
 }

test/df17AppBuilding/config/project-scratch-def.json

@@ -4,6 +4,7 @@
   "edition": "Developer",
   "description": "nuts for plugin-user",
   "features": ["EnableSetPasswordInApi", "AnalyticsAppEmbedded", "DataMaskUser"],
+  "language": "en_US",
   "settings": {
     "lightningExperienceSettings": {
       "enableS1DesktopEnabled": true

test/df17AppBuilding/force-app/main/default/roles/Guide.role-meta.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Role xmlns="http://soap.sforce.com/2006/04/metadata">
+    <caseAccessLevel>Edit</caseAccessLevel>
+    <contactAccessLevel>Edit</contactAccessLevel>
+    <mayForecastManagerShare>false</mayForecastManagerShare>
+    <name>Guide</name>
+    <opportunityAccessLevel>Edit</opportunityAccessLevel>
+</Role>