@salesforce/plugin-devops-center 0.1.0-beta.3 → 1.0.0-beta.2

package/README.md

@@ -39,7 +39,7 @@ To use your plugin, run using the local `./bin/dev` or `./bin/dev.cmd` file.
 
 ```bash
 # Run using local run file.
-./bin/dev deploy pipeline
+./bin/dev project deploy pipeline start
 ```
 
 There should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.
@@ -47,6 +47,7 @@ There should be no differences when running via the Salesforce CLI or using the
 ```bash
 # Link your plugin to the sf cli
 sf plugins link .
+
 # To verify
 sf plugins
 ```
@@ -55,17 +56,17 @@ sf plugins
 
 <!-- commands -->
 
-- [`sf deploy pipeline`](#sf-deploy-pipeline)
-- [`sf deploy pipeline report`](#sf-deploy-pipeline-report)
-- [`sf deploy pipeline resume`](#sf-deploy-pipeline-resume)
+- [`sf project deploy pipeline start`](#sf-project-deploy-pipeline-start)
+- [`sf project deploy pipeline report`](#sf-project-deploy-pipeline-report)
+- [`sf project deploy pipeline resume`](#sf-project-deploy-pipeline-resume)
 
-## `sf deploy pipeline`
+## `sf project deploy pipeline start`
 
 Deploy changes from a branch to the pipeline stage’s org.
 
 ```
 USAGE
-$ sf deploy pipeline [--json] [-c <value>] [-p <value>] [-b <value>] [-v <value>] [-a] [--async | -w <value>] [--concise | --verbose]
+$ sf project deploy pipeline start [--json] [-c <value>] [-p <value>] [-b <value>] [-v <value>] [-a] [--async | -w <value>] [--concise | --verbose]
     [-t <value>] [-l NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg]
 
 FLAGS
@@ -91,11 +92,11 @@ Before you run this command, changes in the branch must be merged in the source
 EXAMPLES
 Deploy changes in the Staging branch to the Staging environment (sandbox), if the previous stage is the bundling stage:
 
-  $ sf deploy pipeline —-devops-center-project-name “Recruiting App” —-branch-name staging —-devops-center-username MyStagingSandbox —-bundle-version-name 1.0
+  $ sf project deploy pipeline start —-devops-center-project-name “Recruiting App” —-branch-name staging —-devops-center-username MyStagingSandbox —-bundle-version-name 1.0
 
 Deploy all changes in the main branch to the release environment:
 
-  $ sf deploy pipeline —-devops-center-project-name “Recruiting App” —-branch-name main —-devops-center-username MyReleaseOrg —-deploy-all
+  $ sf project deploy pipeline start —-devops-center-project-name “Recruiting App” —-branch-name main —-devops-center-username MyReleaseOrg —-deploy-all
 
 FLAG DESCRIPTIONS
 -a, --deploy-all  Deploy all metadata in the branch
@@ -141,21 +142,21 @@ FLAG DESCRIPTIONS
 -w, --wait=<minutes> Number of minutes to wait for command to complete and display results.
 
   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 check the status of the deploy operation, run "sf deploy pipeline report".
+  To check the status of the deploy operation, run "sf project deploy pipeline report".
 
 --async  Run the command asynchronously.
 
   The command immediately returns the job ID and control of the terminal to you. This way, you can continue to use the CLI. To resume the deployment,
-  run "sf deploy pipeline resume". To check the status of the deployment, run "sf deploy pipeline report".
+  run "sf project deploy pipeline resume". To check the status of the deployment, run "sf project deploy pipeline report".
 ```
 
-## `sf deploy pipeline report`
+## `sf project deploy pipeline report`
 
 Check the status of a pipeline deploy operation.
 
 ```
 USAGE
-  $ sf deploy pipeline report [--json] [-c <value>] [-i <value>] [-r]
+  $ sf project deploy pipeline report [--json] [-c <value>] [-i <value>] [-r]
 
 FLAGS
   -c, --devops-center-username=<value>  Username or alias for the DevOps Center org.
@@ -173,11 +174,11 @@ DESCRIPTION
 EXAMPLES
   Check the status using a job ID:
 
-    $ sf deploy pipeline report --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2
+    $ sf project deploy pipeline report --devops-center-username MyStagingSandbox --job-id 0Af0x000017yLUFCA2
 
   Check the status of the most recent deploy operation:
 
-    $ sf deploy pipeline report --devops-center-username MyStagingSandbox --use-most-recent
+    $ sf project deploy pipeline report --devops-center-username MyStagingSandbox --use-most-recent
 
 FLAG DESCRIPTIONS
   -c, --devops-center-username=<value> Username or alias for the DevOps Center org.
@@ -192,19 +193,21 @@ FLAG DESCRIPTIONS
 
 ```
 
-## `sf deploy pipeline resume`
+## `sf project deploy pipeline resume`
 
 Resume watching a pipeline deploy operation.
 
 ```
   USAGE
-    $ sf deploy pipeline resume [--json] [-c <value>] [-i <value>] [-r] [-w <value>]
+    $ sf project deploy pipeline resume [--json] [-c <value>] [-i <value>] [-r] [-w <value>] [--concise | --verbose]
 
   FLAGS
     -c, --devops-center-username=<value>  Username or alias of the DevOps Center org.
     -i, --job-id=<value>                  Job ID of the pipeline deploy operation you want to resume.
     -r, --use-most-recent                 Use the job ID of the most recent deploy operation.
     -w, --wait=<minutes>                  Number of minutes to wait for command to complete and display results.
+    --concise                             Show concise output of the deploy result.
+    --verbose                             Show verbose output of the deploy result.
 
   GLOBAL FLAGS
     --json  Format output as json.
@@ -218,20 +221,20 @@ Resume watching a pipeline deploy operation.
   EXAMPLES
     Resume watching a deploy operation using a job ID:
 
-      $ sf deploy pipeline resume --job-id 0Af0x000017yLUFCA2
+      $ sf project deploy pipeline resume --job-id 0Af0x000017yLUFCA2
 
     Resume watching the most recent deploy operation:
 
-      $ sf deploy pipeline resume --use-most-recent
+      $ sf project deploy pipeline resume --use-most-recent
 
   FLAG DESCRIPTIONS
     -i, --job-id=<value>  Job ID of the pipeline deploy operation you want to resume.
 
       These commands return a job ID if they time out or you specified the --async flag:
 
-      - sf deploy pipeline
-      - sf deploy pipeline validate
-      - sf deploy pipeline quick
+      - sf project deploy pipeline start
+      - sf project deploy pipeline validate
+      - sf project deploy pipeline quick
 
       The job ID is valid for 10 days from when you started the deploy operation.
 
@@ -241,5 +244,5 @@ Resume watching a pipeline deploy operation.
 
     -w, --wait=<minutes>  Number of minutes to wait for command to complete and display results.
 
-      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 check the status of the operation, run "sf deploy pipeline resume report".
+      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 check the status of the operation, run "sf project deploy pipeline report".
 ```

package/lib/commands/project/deploy/pipeline/quick.d.ts

@@ -0,0 +1,23 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import QuickPromotionCommand from '../../../../common/base/abstractQuick';
+import { AsyncOperationResultJson, PromoteOptions } from '../../../../common';
+export default class DeployPipelineQuick extends QuickPromotionCommand<typeof SfCommand> {
+    static readonly description: string;
+    static readonly summary: string;
+    static readonly examples: string[];
+    static readonly state = "beta";
+    protected baseCommand: string;
+    private readonly isUndeployedOnly;
+    run(): Promise<AsyncOperationResultJson>;
+    /**
+     * Computes the source stage Id for quick promotions. Quick promotions are allowed only
+     * in versioned promotions so source stage is previous stage.
+     *
+     * @returns: string. It is the source stage Id.
+     */
+    protected getSourceStageId(): string;
+    /**
+     * Returns the promote option necessary to performs an undeployed only promotion.
+     */
+    protected getPromoteOptions(): Partial<PromoteOptions>;
+}

package/lib/commands/project/deploy/pipeline/quick.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const core_1 = require("@salesforce/core");
+const abstractQuick_1 = require("../../../../common/base/abstractQuick");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'project.deploy.pipeline.quick');
+class DeployPipelineQuick extends abstractQuick_1.default {
+    constructor() {
+        super(...arguments);
+        this.baseCommand = 'project deploy pipeline';
+        this.isUndeployedOnly = true;
+    }
+    async run() {
+        return this.executeQuickPromotion();
+    }
+    /**
+     * Computes the source stage Id for quick promotions. Quick promotions are allowed only
+     * in versioned promotions so source stage is previous stage.
+     *
+     * @returns: string. It is the source stage Id.
+     */
+    getSourceStageId() {
+        // for versioned promotions we always have a previous stage
+        const prevStages = this.getTargetStage().sf_devops__Pipeline_Stages__r;
+        return prevStages.records[0].Id;
+    }
+    /**
+     * Returns the promote option necessary to performs an undeployed only promotion.
+     */
+    getPromoteOptions() {
+        return { undeployedOnly: this.isUndeployedOnly };
+    }
+}
+exports.default = DeployPipelineQuick;
+DeployPipelineQuick.description = messages.getMessage('description');
+DeployPipelineQuick.summary = messages.getMessage('summary');
+DeployPipelineQuick.examples = messages.getMessages('examples');
+DeployPipelineQuick.state = 'beta';
+//# sourceMappingURL=quick.js.map

package/lib/commands/project/deploy/pipeline/quick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick.js","sourceRoot":"","sources":["../../../../../src/commands/project/deploy/pipeline/quick.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,2CAA4C;AAE5C,yEAA0E;AAI1E,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,+BAA+B,CAAC,CAAC;AAE5G,MAAqB,mBAAoB,SAAQ,uBAAuC;IAAxF;;QAMY,gBAAW,GAAG,yBAAyB,CAAC;QACjC,qBAAgB,GAAG,IAAI,CAAC;IAwB3C,CAAC;IAtBQ,KAAK,CAAC,GAAG;QACd,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACO,gBAAgB;QACxB,2DAA2D;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,6BAAuD,CAAC;QACjG,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACO,iBAAiB;QACzB,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACnD,CAAC;;AA9BH,sCA+BC;AA9BwB,+BAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,2BAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,4BAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAC5C,yBAAK,GAAG,MAAM,CAAC"}

package/lib/commands/{deploy → project/deploy}/pipeline/report.d.ts

@@ -1,6 +1,6 @@
 import { SfCommand } from '@salesforce/sf-plugins-core';
-import { PromotePipelineResult } from '../../../common';
-import { ReportOnPromoteCommand } from '../../../common/base/abstractReportOnPromote';
+import { PromotePipelineResult } from '../../../../common';
+import { ReportOnPromoteCommand } from '../../../../common/base/abstractReportOnPromote';
 export default class DeployPipelineReport extends ReportOnPromoteCommand<typeof SfCommand> {
     static readonly description: string;
     static readonly summary: string;

package/lib/commands/{deploy → project/deploy}/pipeline/report.js

@@ -8,9 +8,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 const core_1 = require("@salesforce/core");
 const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
-const abstractReportOnPromote_1 = require("../../../common/base/abstractReportOnPromote");
+const abstractReportOnPromote_1 = require("../../../../common/base/abstractReportOnPromote");
 core_1.Messages.importMessagesDirectory(__dirname);
-const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'deploy.pipeline.report');
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'project.deploy.pipeline.report');
 class DeployPipelineReport extends abstractReportOnPromote_1.ReportOnPromoteCommand {
     constructor() {
         super(...arguments);

package/lib/commands/project/deploy/pipeline/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../../../src/commands/project/deploy/pipeline/report.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,2CAA4C;AAC5C,iEAA+D;AAE/D,6FAAyF;AAEzF,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,gCAAgC,CAAC,CAAC;AAE7G,MAAqB,oBAAqB,SAAQ,gDAAwC;IAA1F;;QAmBY,kBAAa,GAAG,QAAQ,CAAC;IAKrC,CAAC;IAHQ,KAAK,CAAC,GAAG;QACd,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;;AAvBH,uCAwBC;AAvBwB,gCAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,4BAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,6BAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAC5C,0BAAK,GAAG,MAAM,CAAC;AACxB,0BAAK,GAAG;IACpB,QAAQ,EAAE,uBAAK,CAAC,YAAY,CAAC;QAC3B,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;QAC5D,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACpD,UAAU,EAAE,CAAC,iBAAiB,EAAE,QAAQ,CAAC;KAC1C,CAAC;IACF,iBAAiB,EAAE,uBAAK,CAAC,OAAO,CAAC;QAC/B,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,mCAAmC,CAAC;QACrE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,+BAA+B,CAAC;QAC7D,UAAU,EAAE,CAAC,iBAAiB,EAAE,QAAQ,CAAC;KAC1C,CAAC;CACH,CAAC"}

package/lib/commands/{deploy → project/deploy}/pipeline/resume.d.ts

@@ -1,6 +1,6 @@
 import { SfCommand } from '@salesforce/sf-plugins-core';
-import { PromotePipelineResult } from '../../../common';
-import { ResumeCommand } from '../../../common/base/abstractResume';
+import { AsyncOperationResultJson } from '../../../../common';
+import { ResumeCommand } from '../../../../common/base/abstractResume';
 export default class DeployPipelineResume extends ResumeCommand<typeof SfCommand> {
     static readonly summary: string;
     static readonly description: string;
@@ -8,5 +8,5 @@ export default class DeployPipelineResume extends ResumeCommand<typeof SfCommand
     static readonly state = "beta";
     protected operationType: string;
     protected baseCommand: string;
-    run(): Promise<PromotePipelineResult>;
+    run(): Promise<AsyncOperationResultJson>;
 }

package/lib/commands/{deploy → project/deploy}/pipeline/resume.js

@@ -7,14 +7,14 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@salesforce/core");
-const abstractResume_1 = require("../../../common/base/abstractResume");
+const abstractResume_1 = require("../../../../common/base/abstractResume");
 core_1.Messages.importMessagesDirectory(__dirname);
-const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'deploy.pipeline.resume');
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'project.deploy.pipeline.resume');
 class DeployPipelineResume extends abstractResume_1.ResumeCommand {
     constructor() {
         super(...arguments);
         this.operationType = 'Deployment';
-        this.baseCommand = 'deploy pipeline';
+        this.baseCommand = 'project deploy pipeline';
     }
     async run() {
         return this.resumeOperation();

package/lib/commands/project/deploy/pipeline/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../../../src/commands/project/deploy/pipeline/resume.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,2CAA4C;AAG5C,2EAAuE;AAEvE,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,gCAAgC,CAAC,CAAC;AAE7G,MAAqB,oBAAqB,SAAQ,8BAA+B;IAAjF;;QAMY,kBAAa,GAAG,YAAY,CAAC;QAC7B,gBAAW,GAAG,yBAAyB,CAAC;IAKpD,CAAC;IAHQ,KAAK,CAAC,GAAG;QACd,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC;;AAXH,uCAYC;AAXwB,4BAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,gCAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,6BAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAC5C,0BAAK,GAAG,MAAM,CAAC"}

package/lib/commands/{deploy/pipeline.d.ts → project/deploy/pipeline/start.d.ts}

@@ -1,16 +1,18 @@
 import { SfCommand } from '@salesforce/sf-plugins-core';
-import { PromoteCommand } from '../../common/base/abstractPromote';
-import { PromoteOptions, PromotePipelineResult } from '../../common';
+import { PromoteCommand } from '../../../../common/base/abstractPromote';
+import { PromoteOptions } from '../../../../common';
+import { AsyncOperationResultJson } from '../../../../common/types';
 /**
- * Contains the logic to execute the sf deploy pipeline command.
+ * Contains the logic to execute the sf project deploy pipeline start command.
  */
 export default class DeployPipeline extends PromoteCommand<typeof SfCommand> {
     static readonly summary: string;
     static readonly description: string;
     static readonly examples: string[];
     static readonly state = "beta";
+    protected baseCommand: string;
     private readonly isUndeployedOnly;
-    run(): Promise<PromotePipelineResult>;
+    run(): Promise<AsyncOperationResultJson>;
     /**
      * Computes the source stage Id for deployOnly promotions. If the given stage has a previous stage
      * then the source stage is the previous stage. If not the it means this is the

package/lib/commands/{deploy/pipeline.js → project/deploy/pipeline/start.js}

@@ -7,16 +7,17 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@salesforce/core");
-const abstractPromote_1 = require("../../common/base/abstractPromote");
-const constants_1 = require("../../common/constants");
+const abstractPromote_1 = require("../../../../common/base/abstractPromote");
+const constants_1 = require("../../../../common/constants");
 core_1.Messages.importMessagesDirectory(__dirname);
-const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'deploy.pipeline');
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'project.deploy.pipeline.start');
 /**
- * Contains the logic to execute the sf deploy pipeline command.
+ * Contains the logic to execute the sf project deploy pipeline start command.
  */
 class DeployPipeline extends abstractPromote_1.PromoteCommand {
     constructor() {
         super(...arguments);
+        this.baseCommand = 'project deploy pipeline';
         this.isUndeployedOnly = true;
     }
     async run() {
@@ -47,4 +48,4 @@ DeployPipeline.summary = messages.getMessage('summary');
 DeployPipeline.description = messages.getMessage('description');
 DeployPipeline.examples = messages.getMessages('examples');
 DeployPipeline.state = 'beta';
-//# sourceMappingURL=pipeline.js.map
+//# sourceMappingURL=start.js.map

package/lib/commands/project/deploy/pipeline/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../../src/commands/project/deploy/pipeline/start.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,2CAA4C;AAE5C,6EAAyE;AAEzE,4DAAwD;AAGxD,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,+BAA+B,CAAC,CAAC;AAE5G;;GAEG;AACH,MAAqB,cAAe,SAAQ,gCAAgC;IAA5E;;QAKY,gBAAW,GAAG,yBAAyB,CAAC;QACjC,qBAAgB,GAAG,IAAI,CAAC;IA0B3C,CAAC;IAxBQ,KAAK,CAAC,GAAG;QACd,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACO,gBAAgB;QACxB,MAAM,WAAW,GAAkB,IAAI,CAAC,cAAc,EAAE,CAAC;QACzD,OAAO,WAAW,CAAC,6BAA6B;YAC9C,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YACzD,CAAC,CAAC,oBAAQ,CAAC;IACf,CAAC;IAED;;OAEG;IACO,iBAAiB;QACzB,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACnD,CAAC;;AA/BH,iCAgCC;AA/BwB,sBAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,0BAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,uBAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAC5C,oBAAK,GAAG,MAAM,CAAC"}

package/lib/commands/project/deploy/pipeline/validate.d.ts

@@ -0,0 +1,19 @@
+import { PromoteOptions } from '../../../../common';
+import { AsyncOperationResultJson } from '../../../../common/types';
+import DeployPipeline from './start';
+/**
+ * Contains the logic to execute the sf project deploy pipeline validate command.
+ */
+export default class ValidateDeployPipeline extends DeployPipeline {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly state = "beta";
+    protected baseCommand: string;
+    private readonly isCheckDeploy;
+    run(): Promise<AsyncOperationResultJson>;
+    /**
+     * Returns the promote option necessary to perform a validate deploy
+     */
+    protected getPromoteOptions(): Partial<PromoteOptions>;
+}

package/lib/commands/project/deploy/pipeline/validate.js

@@ -0,0 +1,37 @@
+"use strict";
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@salesforce/core");
+const start_1 = require("./start");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'project.deploy.pipeline.validate');
+/**
+ * Contains the logic to execute the sf project deploy pipeline validate command.
+ */
+class ValidateDeployPipeline extends start_1.default {
+    constructor() {
+        super(...arguments);
+        this.baseCommand = 'project deploy pipeline';
+        this.isCheckDeploy = true;
+    }
+    async run() {
+        return this.executePromotion();
+    }
+    /**
+     * Returns the promote option necessary to perform a validate deploy
+     */
+    getPromoteOptions() {
+        return { ...super.getPromoteOptions(), checkDeploy: this.isCheckDeploy };
+    }
+}
+exports.default = ValidateDeployPipeline;
+ValidateDeployPipeline.summary = messages.getMessage('summary');
+ValidateDeployPipeline.description = messages.getMessage('description');
+ValidateDeployPipeline.examples = messages.getMessages('examples');
+ValidateDeployPipeline.state = 'beta';
+//# sourceMappingURL=validate.js.map

package/lib/commands/project/deploy/pipeline/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../../src/commands/project/deploy/pipeline/validate.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,2CAA4C;AAG5C,mCAAqC;AAErC,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,kCAAkC,CAAC,CAAC;AAE/G;;GAEG;AACH,MAAqB,sBAAuB,SAAQ,eAAc;IAAlE;;QAKY,gBAAW,GAAG,yBAAyB,CAAC;QACjC,kBAAa,GAAG,IAAI,CAAC;IAYxC,CAAC;IAVQ,KAAK,CAAC,GAAG;QACd,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACO,iBAAiB;QACzB,OAAO,EAAE,GAAG,KAAK,CAAC,iBAAiB,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;IAC3E,CAAC;;AAjBH,yCAkBC;AAjBwB,8BAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,kCAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,+BAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAC5C,4BAAK,GAAG,MAAM,CAAC"}

package/lib/common/base/abstractAsyncOperation.d.ts

@@ -0,0 +1,42 @@
+import { Org, SfError } from '@salesforce/core';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Duration } from '@salesforce/kit';
+import { AsyncOperationResultJson } from '../types';
+import { PromoteOutputService } from '../outputService';
+export declare abstract class AsyncCommand extends SfCommand<AsyncOperationResultJson> {
+    protected targetOrg: Org;
+    private asyncOperationId;
+    private outputService;
+    protected abstract baseCommand: string;
+    protected setAsyncOperationId(aorId: string): void;
+    protected setOutputService(service: PromoteOutputService): void;
+    /**
+     * Method to handle an in progress async operation. It stores the AOR in cache,
+     * then monitors the state of it and print messages if needed. Finally returns the
+     * final state of the operation.
+     */
+    protected monitorOperation(isAsync: boolean, wait: Duration): Promise<AsyncOperationResultJson>;
+    /**
+     * Default function for catching commands errors.
+     *
+     * @param error
+     * @returns
+     */
+    protected catch(error: Error | SfError): Promise<SfCommand.Error>;
+    /**
+     *
+     * Stores the AOR Id in cache.
+     */
+    protected cacheOperation(): Promise<void>;
+    /**
+     *
+     * Executes a query to get the state of the AOR record.
+     */
+    private getOperationState;
+    /**
+     * Watch changes in the state of the AOR.
+     *
+     * @param wait
+     */
+    private startMonitoring;
+}

package/lib/common/base/abstractAsyncOperation.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncCommand = void 0;
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const core_1 = require("@salesforce/core");
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const deployPipelineCache_1 = require("../deployPipelineCache");
+const types_1 = require("../types");
+const common_1 = require("../../common");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+class AsyncCommand extends sf_plugins_core_1.SfCommand {
+    setAsyncOperationId(aorId) {
+        this.asyncOperationId = aorId;
+    }
+    setOutputService(service) {
+        this.outputService = service;
+    }
+    /**
+     * Method to handle an in progress async operation. It stores the AOR in cache,
+     * then monitors the state of it and print messages if needed. Finally returns the
+     * final state of the operation.
+     */
+    async monitorOperation(isAsync, wait) {
+        await this.cacheOperation();
+        this.outputService.setAorId(this.asyncOperationId);
+        this.outputService.printAorId();
+        this.outputService.printOpSummary();
+        if (isAsync) {
+            return this.getOperationState();
+        }
+        await this.startMonitoring(wait);
+        if (this.outputService.getStatus() === types_1.AsyncOperationStatus.Completed) {
+            this.outputService.displayEndResults();
+        }
+        return this.getOperationState();
+    }
+    /**
+     * Default function for catching commands errors.
+     *
+     * @param error
+     * @returns
+     */
+    catch(error) {
+        if (error.name.includes('GenericTimeoutError')) {
+            const err = messages.createError('error.ClientTimeout', [this.config.bin, this.baseCommand]);
+            return super.catch({ ...error, name: err.name, message: err.message, code: err.code });
+        }
+        return super.catch(error);
+    }
+    /**
+     *
+     * Stores the AOR Id in cache.
+     */
+    async cacheOperation() {
+        await deployPipelineCache_1.DeployPipelineCache.set(this.asyncOperationId, {});
+    }
+    /**
+     *
+     * Executes a query to get the state of the AOR record.
+     */
+    async getOperationState() {
+        const asyncJob = await (0, common_1.fetchAsyncOperationResult)(this.targetOrg.getConnection(), this.asyncOperationId);
+        return {
+            jobId: this.asyncOperationId,
+            status: asyncJob.sf_devops__Status__c,
+            message: asyncJob.sf_devops__Message__c,
+            errorDetails: asyncJob.sf_devops__Error_Details__c,
+        };
+    }
+    /**
+     * Watch changes in the state of the AOR.
+     *
+     * @param wait
+     */
+    async startMonitoring(wait) {
+        const asyncJob = await (0, common_1.fetchAsyncOperationResult)(this.targetOrg.getConnection(), this.asyncOperationId);
+        if (asyncJob.sf_devops__Status__c === undefined ||
+            asyncJob.sf_devops__Status__c === types_1.AsyncOperationStatus.InProgress) {
+            const streamer = (0, common_1.getAsyncOperationStreamer)(this.targetOrg, wait, this.asyncOperationId, this.outputService);
+            await streamer.monitor();
+        }
+        else {
+            this.outputService.printAorStatus(asyncJob);
+        }
+    }
+}
+exports.AsyncCommand = AsyncCommand;
+//# sourceMappingURL=abstractAsyncOperation.js.map

package/lib/common/base/abstractAsyncOperation.js.map

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

package/lib/common/base/abstractPromote.d.ts

@@ -1,9 +1,11 @@
-import { Org, SfError } from '@salesforce/core';
+import { Org } from '@salesforce/core';
 import { SfCommand } from '@salesforce/sf-plugins-core';
 import { Interfaces } from '@oclif/core';
-import { PipelineStage, PromoteOptions, PromotePipelineResult } from '..';
+import { PipelineStage, PromoteOptions } from '..';
+import { AsyncOperationResultJson } from '../../common';
+import { AsyncCommand } from './abstractAsyncOperation';
 export type Flags<T extends typeof SfCommand> = Interfaces.InferredFlags<(typeof PromoteCommand)['baseFlags'] & T['flags']>;
-export declare abstract class PromoteCommand<T extends typeof SfCommand> extends SfCommand<PromotePipelineResult> {
+export declare abstract class PromoteCommand<T extends typeof SfCommand> extends AsyncCommand {
     static baseFlags: {
         'branch-name': Interfaces.OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'bundle-version-name': Interfaces.OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
@@ -22,36 +24,26 @@ export declare abstract class PromoteCommand<T extends typeof SfCommand> extends
     private sourceStageId;
     private deployOptions;
     private numRetries409;
-    private outputService;
     init(): Promise<void>;
-    protected executePromotion(): Promise<PromotePipelineResult>;
+    protected executePromotion(): Promise<AsyncOperationResultJson>;
     /**
      *
      * Sends an Http request to the target org to initiate a promotion.
      *
-     * @param doceOrg target org.
      * @returns Aor Id of promote operation.
      */
-    protected requestPromotionFlow(doceOrg: Org): Promise<string>;
+    protected requestPromotionFlow(): Promise<string>;
     /**
      *
      * Sends an Http request to the target org to initiate a promotion.
      * If it gets a 409/Conflict it will retry till the request successes,
      * gets a differenct error or run out of retry attempts.
      *
-     * @param doceOrg target org.
      * @param numRetries Amount of remaining retry attempts.
      * @returns Aor Id of promote operation
      */
-    protected retryRequestPromotion(doceOrg: Org, numRetries: number): Promise<string>;
+    protected retryRequestPromotion(numRetries: number): Promise<string>;
     protected getTargetStage(): PipelineStage;
-    /**
-     * Default function for catching commands errors.
-     *
-     * @param error
-     * @returns
-     */
-    protected catch(error: Error | SfError): Promise<SfCommand.Error>;
     private requestPromotion;
     private buildPromoteOptions;
     /**