feat: add --wait flag to resume scratch org (#1376)

* feat: add --wait flag to resume scratch org

* fix: update the wait flags

* fix: update the flags wait for resume scratch

* chore: bump sfdx-core

---------

Co-authored-by: Cristian Dominguez <[email protected]>

Author: soridalac

command-snapshot.json

@@ -176,8 +176,8 @@
     "alias": ["env:resume:scratch"],
     "command": "org:resume:scratch",
     "flagAliases": [],
-    "flagChars": ["i", "r"],
-    "flags": ["flags-dir", "job-id", "json", "use-most-recent"],
+    "flagChars": ["i", "r", "w"],
+    "flags": ["flags-dir", "job-id", "json", "use-most-recent", "wait"],
     "plugin": "@salesforce/plugin-org"
   }
 ]

messages/resume_scratch.md

@@ -28,6 +28,14 @@ The job ID is the same as the record ID of the incomplete scratch org in the Scr
 
 The job ID is valid for 24 hours after you start the scratch org creation.
 
+# flags.wait.summary
+
+Number of minutes to wait for the scratch org to be ready.
+
+# flags.wait.description
+
+If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To resume checking the scratch creation, rerun this command.
+
 # flags.use-most-recent.summary
 
 Use the job ID of the most recent incomplete scratch org.

package.json

@@ -7,7 +7,7 @@
   "dependencies": {
     "@oclif/core": "^4.2.10",
     "@oclif/multi-stage-output": "^0.8.12",
-    "@salesforce/core": "^8.8.7",
+    "@salesforce/core": "^8.9.0",
     "@salesforce/kit": "^3.2.3",
     "@salesforce/sf-plugins-core": "^12.2.1",
     "@salesforce/source-deploy-retrieve": "^12.18.2",

src/commands/org/resume/scratch.ts

@@ -46,6 +46,15 @@ export default class OrgResumeScratch extends SfCommand<ScratchCreateResponse> {
       summary: messages.getMessage('flags.use-most-recent.summary'),
       exactlyOne: ['use-most-recent', 'job-id'],
     }),
+    wait: Flags.duration({
+      char: 'w',
+      summary: messages.getMessage('flags.wait.summary'),
+      description: messages.getMessage('flags.wait.description'),
+      min: 0,
+      unit: 'minutes',
+      helpValue: '<minutes>',
+      defaultValue: 0,
+    }),
   };
 
   public async run(): Promise<ScratchCreateResponse> {
@@ -105,7 +114,8 @@ export default class OrgResumeScratch extends SfCommand<ScratchCreateResponse> {
     });
 
     try {
-      const { username, scratchOrgInfo, authFields, warnings } = await scratchOrgResume(jobId);
+      const { username, scratchOrgInfo, authFields, warnings } = await scratchOrgResume(jobId, flags.wait);
+
       this.log();
       this.logSuccess(messages.getMessage('success'));
       return { username, scratchOrgInfo, authFields, warnings, orgId: authFields?.orgId };