@salesforce/plugin-devops-center 0.1.0-beta.1

package/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (c) 2023, Salesforce.com, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+* Neither the name of Salesforce.com nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,245 @@
+**NOTE: This command is currently in beta. Any aspect of this command can change without advanced notice. Don't use beta commands in your scripts.**
+
+# plugin-devops-center
+
+<!--[![NPM](https://img.shields.io/npm/v/@salesforce/plugin-template-sf.svg?label=@salesforce/plugin-template-sf)](https://www.npmjs.com/package/@salesforce/plugin-template-sf) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-template-sf.svg)](https://npmjs.org/package/@salesforce/plugin-template-sf) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://raw.githubusercontent.com/salesforcecli/plugin-template-sf/main/LICENSE.txt) -->
+
+## Contributing
+
+1. Please read our [Code of Conduct](CODE_OF_CONDUCT.md)
+2. Create a new issue before starting your project so that we can keep track of
+   what you are trying to add/fix. That way, we can also offer suggestions or
+   let you know if there is already an effort in progress.
+3. Fork this repository.
+4. [Build the plugin locally](#build)
+5. Create a _topic_ branch in your fork. Note, this step is recommended but technically not required if contributing using a fork.
+6. Edit the code in your fork.
+7. Write appropriate tests for your changes. Try to achieve at least 95% code coverage on any new code. No pull request will be accepted without unit tests.
+8. Sign CLA (see [CLA](#cla) below).
+9. Send us a pull request when you are done. We'll review your code, suggest any needed changes, and merge it in.
+
+### CLA
+
+External contributors will be required to sign a Contributor's License
+Agreement. You can do so by going to https://cla.salesforce.com/sign-cla.
+
+### Build
+
+To build the plugin locally, make sure to have yarn installed and run the following commands:
+
+```bash
+# Clone the repository
+git clone git@github.com:salesforcecli/plugin-devops-center
+
+# Install the dependencies and compile
+yarn && yarn build
+```
+
+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
+```
+
+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.
+
+```bash
+# Link your plugin to the sf cli
+sf plugins link .
+# To verify
+sf plugins
+```
+
+## Commands
+
+<!-- commands -->
+
+- [`sf deploy pipeline`](#sf-deploy-pipeline)
+- [`sf deploy pipeline report`](#sf-deploy-pipeline-report)
+- [`sf deploy pipeline resume`](#sf-deploy-pipeline-resume)
+
+## `sf deploy pipeline`
+
+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]
+    [-t <value>] [-l NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg]
+
+FLAGS
+  -a, --deploy-all                                Deploy all metadata in the branch.
+  -b, --branch-name=<value>                       Name of the branch in the source control repository from which to deploy changes to the stage’s org.
+  -c, --devops-center-username=<value>            Username or alias for the DevOps Center org.
+  -l, --test-level=<option>                       [default: NoTestRun] Deployment Apex testing level.
+                                                  <options: NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg>
+  -p, --devops-center-project-name=<value>        Name of the DevOps Center project.
+  -t, --tests=<value>...                          Apex tests to run when --test-level is RunSpecifiedTests.
+  -v, --bundle-version-name=<value>               Version name of the bundle.
+  -w, --wait=<minutes>                            Number of minutes to wait for command to complete and display results.
+  --async                                         Run the command asynchronously.
+  --concise                                       Show concise output of the deploy result.
+  --verbose                                       Show verbose output of the deploy result.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+Before you run this command, changes in the branch must be merged in the source control repository.
+
+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
+
+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
+
+FLAG DESCRIPTIONS
+-a, --deploy-all  Deploy all metadata in the branch
+
+  If you don’t specify this flag, only changes in the stage’s branch are deployed.
+
+-b, --branch-name=<value> Name of the branch in the source control repository from which to deploy changes to the stage’s org.
+
+-c, --devops-center-username=<value> Username or alias for the DevOps Center org.
+
+-l, --test-level=NoTestRun|RunSpecifiedTests|RunLocalTests|RunAllTestsInOrg  Deployment Apex testing level.
+
+    Valid values are:
+
+    - NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as
+    sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.
+
+    - RunSpecifiedTests — Runs only the tests that you specify with the --run-tests flag. Code coverage requirements
+    differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of
+    75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and
+    trigger individually and is different than the overall coverage percentage.
+
+    - RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked
+    packages. This test level is the default for production deployments that include Apex classes or triggers.
+
+    - RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.
+
+    If you don’t specify a test level, the default behavior depends on the contents of your deployment package. For more
+    information, see [Running Tests in a
+    Deployment](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm)
+    in the "Metadata API Developer Guide".
+
+-p, --devops-center-project-name=<value> Name of the DevOps Center project.
+
+-t, --tests=<value>... Apex tests to run when --test-level is RunSpecifiedTests.
+
+  Separate multiple test names with commas, and enclose the entire flag value in double quotes if a test contains a space.
+
+-v, --bundle-version-name=<value> Version name of the bundle
+
+  You must indicate the bundle version if deploying to the environment that corresponds to the first stage after the bundling stage.
+
+-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".
+
+--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".
+```
+
+## `sf deploy pipeline report`
+
+Check the status of a pipeline deploy operation.
+
+```
+USAGE
+  $ sf deploy pipeline report [--json] [-c <value>] [-i <value>] [-r]
+
+FLAGS
+  -c, --devops-center-username=<value>  Username or alias for the DevOps Center org.
+  -i, --job-id=<value>                  Job ID of the pipeline deployment you want to check the status of.
+  -r, --use-most-recent                 Use the job ID of the most recent deploy operation.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Check the status of a pipeline deploy operation.
+
+  Run this command by either passing it a job ID or specifying the —use-most-recent flag to use the job ID of the most recent deploy operation.
+
+EXAMPLES
+  Check the status using a job ID:
+
+    $ sf 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
+
+FLAG DESCRIPTIONS
+  -c, --devops-center-username=<value> Username or alias for the DevOps Center org.
+
+  -i, --job-id=<value>  Job ID of the pipeline deployment you want to check the status of.
+
+      The job ID is valid for 10 days from when you started the deploy operation.
+
+  -r, --use-most-recent  Use the job ID of the most recent deploy operation.
+
+      For performance reasons, this flag uses job IDs for deploy operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.
+
+```
+
+## `sf deploy pipeline resume`
+
+Resume watching a pipeline deploy operation.
+
+```
+  USAGE
+    $ sf deploy pipeline resume [--json] [-c <value>] [-i <value>] [-r] [-w <value>]
+
+  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.
+
+  GLOBAL FLAGS
+    --json  Format output as json.
+
+  DESCRIPTION
+    Resume watching a pipeline deploy operation.
+
+    Use this command to resume watching a pipeline deploy operation if the original command times out or you specified the --async flag.
+    Run this command by either passing it a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.
+
+  EXAMPLES
+    Resume watching a deploy operation using a job ID:
+
+      $ sf deploy pipeline resume --job-id 0Af0x000017yLUFCA2
+
+    Resume watching the most recent deploy operation:
+
+      $ sf 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
+
+      The job ID is valid for 10 days from when you started the deploy operation.
+
+    -r, --use-most-recent  Use the job ID of the most recent deploy operation.
+
+      For performance reasons, this flag uses job IDs for operations that started in the past 3 days or fewer. If your most recent operation was longer than 3 days ago, this flag won't find a job ID.
+
+    -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".
+```

package/lib/commands/deploy/pipeline/report.d.ts

@@ -0,0 +1,15 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+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;
+    static readonly examples: string[];
+    static readonly state = "beta";
+    static flags: {
+        'job-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'use-most-recent': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    protected operationName: string;
+    run(): Promise<PromotePipelineResult>;
+}

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

@@ -0,0 +1,42 @@
+"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 sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+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');
+class DeployPipelineReport extends abstractReportOnPromote_1.ReportOnPromoteCommand {
+    constructor() {
+        super(...arguments);
+        this.operationName = 'Deploy';
+    }
+    async run() {
+        return this.getOperationReport();
+    }
+}
+exports.default = DeployPipelineReport;
+DeployPipelineReport.description = messages.getMessage('description');
+DeployPipelineReport.summary = messages.getMessage('summary');
+DeployPipelineReport.examples = messages.getMessages('examples');
+DeployPipelineReport.state = 'beta';
+DeployPipelineReport.flags = {
+    'job-id': sf_plugins_core_1.Flags.salesforceId({
+        char: 'i',
+        description: messages.getMessage('flags.job-id.description'),
+        summary: messages.getMessage('flags.job-id.summary'),
+        exactlyOne: ['use-most-recent', 'job-id'],
+    }),
+    'use-most-recent': sf_plugins_core_1.Flags.boolean({
+        char: 'r',
+        description: messages.getMessage('flags.use-most-recent.description'),
+        summary: messages.getMessage('flags.use-most-recent.summary'),
+        exactlyOne: ['use-most-recent', 'job-id'],
+    }),
+};
+//# sourceMappingURL=report.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../../src/commands/deploy/pipeline/report.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,2CAA4C;AAC5C,iEAA+D;AAE/D,0FAAsF;AAEtF,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,wBAAwB,CAAC,CAAC;AAErG,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/pipeline/resume.d.ts

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

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

@@ -0,0 +1,28 @@
+"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 abstractResume_1 = require("../../../common/base/abstractResume");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'deploy.pipeline.resume');
+class DeployPipelineResume extends abstractResume_1.ResumeCommand {
+    constructor() {
+        super(...arguments);
+        this.operationType = 'Deployment';
+        this.baseCommand = 'deploy pipeline';
+    }
+    async run() {
+        return this.resumeOperation();
+    }
+}
+exports.default = DeployPipelineResume;
+DeployPipelineResume.summary = messages.getMessage('summary');
+DeployPipelineResume.description = messages.getMessage('description');
+DeployPipelineResume.examples = messages.getMessages('examples');
+DeployPipelineResume.state = 'beta';
+//# sourceMappingURL=resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../../src/commands/deploy/pipeline/resume.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,2CAA4C;AAG5C,wEAAoE;AAEpE,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,wBAAwB,CAAC,CAAC;AAErG,MAAqB,oBAAqB,SAAQ,8BAA+B;IAAjF;;QAMY,kBAAa,GAAG,YAAY,CAAC;QAC7B,gBAAW,GAAG,iBAAiB,CAAC;IAK5C,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

@@ -0,0 +1,26 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { PromoteCommand } from '../../common/base/abstractPromote';
+import { PromoteOptions, PromotePipelineResult } from '../../common';
+/**
+ * Contains the logic to execute the sf deploy pipeline 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";
+    private readonly isUndeployedOnly;
+    run(): Promise<PromotePipelineResult>;
+    /**
+     * 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
+     * first stage of the pipeline and source stage Id = Approved.
+     *
+     * @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/deploy/pipeline.js

@@ -0,0 +1,50 @@
+"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 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');
+/**
+ * Contains the logic to execute the sf deploy pipeline command.
+ */
+class DeployPipeline extends abstractPromote_1.PromoteCommand {
+    constructor() {
+        super(...arguments);
+        this.isUndeployedOnly = true;
+    }
+    async run() {
+        return this.executePromotion();
+    }
+    /**
+     * 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
+     * first stage of the pipeline and source stage Id = Approved.
+     *
+     * @returns: string. It is the source stage Id.
+     */
+    getSourceStageId() {
+        const targetStage = this.getTargetStage();
+        return targetStage.sf_devops__Pipeline_Stages__r
+            ? targetStage.sf_devops__Pipeline_Stages__r.records[0].Id
+            : constants_1.APPROVED;
+    }
+    /**
+     * Returns the promote option necessary to performs an undeployed only promotion
+     */
+    getPromoteOptions() {
+        return { undeployedOnly: this.isUndeployedOnly };
+    }
+}
+exports.default = DeployPipeline;
+DeployPipeline.summary = messages.getMessage('summary');
+DeployPipeline.description = messages.getMessage('description');
+DeployPipeline.examples = messages.getMessages('examples');
+DeployPipeline.state = 'beta';
+//# sourceMappingURL=pipeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/commands/deploy/pipeline.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,2CAA4C;AAE5C,uEAAmE;AAEnE,sDAAkD;AAElD,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,iBAAiB,CAAC,CAAC;AAE9F;;GAEG;AACH,MAAqB,cAAe,SAAQ,gCAAgC;IAA5E;;QAKmB,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;;AA9BH,iCA+BC;AA9BwB,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/common/base/abstractPromote.d.ts

@@ -0,0 +1,69 @@
+import { Org, SfError } from '@salesforce/core';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Interfaces } from '@oclif/core';
+import { PipelineStage, PromoteOptions, PromotePipelineResult } from '..';
+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> {
+    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>;
+        'deploy-all': Interfaces.BooleanFlag<boolean>;
+        'devops-center-project-name': Interfaces.OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'devops-center-username': Interfaces.OptionFlag<Org | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        tests: Interfaces.OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'test-level': Interfaces.OptionFlag<import("..").TestLevel | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        async: Interfaces.BooleanFlag<boolean>;
+        wait: Interfaces.OptionFlag<import("@salesforce/kit").Duration, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        verbose: Interfaces.BooleanFlag<boolean>;
+        concise: Interfaces.BooleanFlag<boolean>;
+    };
+    protected flags: Flags<T>;
+    private targetStage;
+    private sourceStageId;
+    private deployOptions;
+    private numRetries409;
+    private outputService;
+    init(): Promise<void>;
+    protected executePromotion(): Promise<PromotePipelineResult>;
+    /**
+     *
+     * 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>;
+    /**
+     *
+     * 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 getTargetStage(): PipelineStage;
+    /**
+     * Default function for catching commands errors.
+     *
+     * @param error
+     * @returns
+     */
+    protected catch(error: Error | SfError): Promise<SfCommand.Error>;
+    private requestPromotion;
+    private buildPromoteOptions;
+    /**
+     * Knows how to compute the target pipeline stage Id based on the type of promotion.
+     *
+     * @returns: string. It is the source stage Id.
+     */
+    protected abstract getSourceStageId(): string;
+    /**
+     * Returns the specific promote options specific for every concrete implementations.
+     *
+     * @returns: Partial<PromoteOptions>.
+     */
+    protected abstract getPromoteOptions(): Partial<PromoteOptions>;
+}