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

package/lib/common/base/abstractPromote.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromoteCommand = 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 asyncOpStream_1 = require("../../streamer/processors/asyncOpStream");
+const __1 = require("..");
+const flags_1 = require("../flags/flags");
+const promoteFlags_1 = require("../flags/promote/promoteFlags");
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+const outputService_1 = require("../outputService");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+class PromoteCommand extends sf_plugins_core_1.SfCommand {
+    constructor() {
+        super(...arguments);
+        this.numRetries409 = 50; // this is the number of times we retry if we get a http-409-Conflict response
+    }
+    async init() {
+        await super.init();
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const { flags } = await this.parse({
+            flags: this.ctor.flags,
+            baseFlags: super.ctor.baseFlags,
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        this.flags = flags;
+        this.outputService = new outputService_1.OutputServiceFactory().forDeployment(this.flags, this.flags['devops-center-username'].getConnection());
+    }
+    async executePromotion() {
+        (0, __1.validateTestFlags)(this.flags['test-level'], this.flags.tests);
+        const doceOrg = this.flags['devops-center-username'];
+        this.targetStage = await (0, __1.fetchAndValidatePipelineStage)(doceOrg, this.flags['devops-center-project-name'], this.flags['branch-name']);
+        this.sourceStageId = this.getSourceStageId();
+        const asyncOperationId = await this.requestPromotionFlow(doceOrg);
+        this.outputService.setAorId(asyncOperationId);
+        this.outputService.printAorId();
+        // eslint-disable-next-line @typescript-eslint/await-thenable
+        await this.outputService.printOpSummary();
+        await deployPipelineCache_1.DeployPipelineCache.set(asyncOperationId, {});
+        if (this.flags.async) {
+            return {
+                jobId: asyncOperationId,
+                status: types_1.AsyncOperationStatus.InProgress,
+            };
+        }
+        const doceMonitor = new asyncOpStream_1.default(doceOrg, this.flags.wait, asyncOperationId, this.outputService);
+        await doceMonitor.monitor();
+        if (this.outputService.getStatus() === types_1.AsyncOperationStatus.Completed) {
+            await this.outputService.displayEndResults();
+        }
+        // get final state of the async job
+        const asyncJob = await (0, utils_1.fetchAsyncOperationResult)(doceOrg.getConnection(), asyncOperationId);
+        return {
+            jobId: asyncOperationId,
+            status: asyncJob.sf_devops__Status__c,
+            message: asyncJob.sf_devops__Message__c,
+            errorDetails: asyncJob.sf_devops__Error_Details__c,
+        };
+    }
+    /**
+     *
+     * Sends an Http request to the target org to initiate a promotion.
+     *
+     * @param doceOrg target org.
+     * @returns Aor Id of promote operation.
+     */
+    async requestPromotionFlow(doceOrg) {
+        let spinnerStarted = false;
+        try {
+            return await this.requestPromotion(doceOrg);
+        }
+        catch (error) {
+            const err = error;
+            // if we get a 409 error then call the retry flow
+            if (err.errorCode === constants_1.HTTP_CONFLICT_CODE) {
+                this.spinner.start('Synchronization of source control system events in progress');
+                spinnerStarted = true;
+                return await this.retryRequestPromotion(doceOrg, this.numRetries409);
+            }
+            throw error;
+        }
+        finally {
+            if (spinnerStarted)
+                this.spinner.stop();
+        }
+    }
+    /**
+     *
+     * 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
+     */
+    async retryRequestPromotion(doceOrg, numRetries) {
+        try {
+            return await this.requestPromotion(doceOrg);
+        }
+        catch (error) {
+            const err = error;
+            // if we still get a 409 error and haven't run out of retry attempts then retry again
+            if (err.errorCode === constants_1.HTTP_CONFLICT_CODE && numRetries > 1) {
+                return this.retryRequestPromotion(doceOrg, numRetries - 1);
+            }
+            throw error;
+        }
+    }
+    getTargetStage() {
+        return this.targetStage;
+    }
+    /**
+     * 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.id]);
+            return super.catch({ ...error, name: err.name, message: err.message, code: err.code });
+        }
+        return super.catch(error);
+    }
+    async requestPromotion(targetOrg) {
+        this.buildPromoteOptions();
+        const req = {
+            method: 'POST',
+            url: `${constants_1.REST_PROMOTE_BASE_URL}${this.targetStage.sf_devops__Pipeline__r.sf_devops__Project__c}/pipelineName/${this.sourceStageId}`,
+            body: JSON.stringify({
+                changeBundleName: this.flags['bundle-version-name'],
+                promoteOptions: this.deployOptions,
+            }),
+        };
+        return targetOrg.getConnection().request(req);
+    }
+    buildPromoteOptions() {
+        this.deployOptions = {
+            fullDeploy: this.flags['deploy-all'],
+            testLevel: this.flags['test-level'] ?? 'Default',
+            runTests: this.flags.tests ? this.flags.tests.join(',') : undefined,
+            // get more promote options from the concrete implementation if needed
+            ...this.getPromoteOptions(),
+        };
+    }
+}
+exports.PromoteCommand = PromoteCommand;
+// common flags that can be inherited by any command that extends PromoteCommand
+PromoteCommand.baseFlags = {
+    'branch-name': promoteFlags_1.branchName,
+    'bundle-version-name': promoteFlags_1.bundleVersionName,
+    'deploy-all': promoteFlags_1.deployAll,
+    'devops-center-project-name': flags_1.devopsCenterProjectName,
+    'devops-center-username': (0, flags_1.requiredDoceOrgFlag)(),
+    tests: promoteFlags_1.specificTests,
+    'test-level': (0, promoteFlags_1.testLevel)(),
+    async: promoteFlags_1.async,
+    wait: flags_1.wait,
+    verbose: flags_1.verbose,
+    concise: flags_1.concise,
+};
+//# sourceMappingURL=abstractPromote.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { Org } from '@salesforce/core';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Interfaces } from '@oclif/core';
+import { PromotePipelineResult } from '../../common';
+export type Flags<T extends typeof SfCommand> = Interfaces.InferredFlags<(typeof ReportOnPromoteCommand)['baseFlags'] & T['flags']>;
+export declare abstract class ReportOnPromoteCommand<T extends typeof SfCommand> extends SfCommand<PromotePipelineResult> {
+    static baseFlags: {
+        'devops-center-username': Interfaces.OptionFlag<Org | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    protected flags: Flags<T>;
+    protected abstract operationName: string;
+    init(): Promise<void>;
+    /**
+     * Prints a report of an async operation.
+     */
+    protected getOperationReport(): Promise<PromotePipelineResult>;
+}

package/lib/common/base/abstractReportOnPromote.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportOnPromoteCommand = 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("../../common/deployPipelineCache");
+const flags_1 = require("../../common/flags/flags");
+const deploymentResultsSelector_1 = require("./../selectors/deploymentResultsSelector");
+const outputServiceFactory_1 = require("./../outputService/outputServiceFactory");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+class ReportOnPromoteCommand extends sf_plugins_core_1.SfCommand {
+    async init() {
+        await super.init();
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const { flags } = await this.parse({
+            flags: this.ctor.flags,
+            baseFlags: super.ctor.baseFlags,
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        this.flags = flags;
+    }
+    /**
+     * Prints a report of an async operation.
+     */
+    async getOperationReport() {
+        const asyncJobId = this.flags['use-most-recent']
+            ? (await deployPipelineCache_1.DeployPipelineCache.create()).getLatestKeyOrThrow()
+            : this.flags['job-id'];
+        const org = this.flags['devops-center-username'];
+        try {
+            // query the deployment result related to the promote operation.
+            const operationResult = await (0, deploymentResultsSelector_1.selectOneDeploymentResultByAsyncJobId)(org.getConnection(), asyncJobId);
+            if (!this.jsonEnabled()) {
+                const displayer = new outputServiceFactory_1.OutputServiceFactory().forPromotionReport(this.flags, operationResult, this.operationName);
+                displayer.printOpSummary();
+            }
+            return {
+                jobId: asyncJobId,
+                status: operationResult.sf_devops__Status__r.sf_devops__Status__c,
+                message: operationResult.sf_devops__Status__r.sf_devops__Message__c,
+                errorDetails: operationResult.sf_devops__Status__r.sf_devops__Error_Details__c,
+            };
+        }
+        catch (err) {
+            const error = err;
+            if (error.name === 'SingleRecordQuery_NoRecords') {
+                throw messages.createError('error.InvalidAorId', [asyncJobId]);
+            }
+            throw err;
+        }
+    }
+}
+exports.ReportOnPromoteCommand = ReportOnPromoteCommand;
+ReportOnPromoteCommand.baseFlags = {
+    'devops-center-username': (0, flags_1.requiredDoceOrgFlag)(),
+};
+//# sourceMappingURL=abstractReportOnPromote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstractReportOnPromote.js","sourceRoot":"","sources":["../../../src/common/base/abstractReportOnPromote.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,2CAAiD;AACjD,iEAAwD;AAExD,0EAAuE;AAEvE,oDAA+D;AAE/D,wFAAiG;AAEjG,kFAA+E;AAE/E,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,cAAc,CAAC,CAAC;AAM3F,MAAsB,sBAAmD,SAAQ,2BAAgC;IAOxG,KAAK,CAAC,IAAI;QACf,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,mEAAmE;QACnE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;YACjC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,SAAS,EAAG,KAAK,CAAC,IAAsC,CAAC,SAAS;SACnE,CAAC,CAAC;QACH,mEAAmE;QACnE,IAAI,CAAC,KAAK,GAAG,KAAiB,CAAC;IACjC,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,kBAAkB;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;YAC9C,CAAC,CAAC,CAAC,MAAM,yCAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,mBAAmB,EAAE;YAC5D,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAQ,CAAC;QAExD,IAAI;YACF,gEAAgE;YAChE,MAAM,eAAe,GAAqB,MAAM,IAAA,iEAAqC,EACnF,GAAG,CAAC,aAAa,EAAE,EACnB,UAAU,CACX,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;gBACvB,MAAM,SAAS,GAAkB,IAAI,2CAAoB,EAAE,CAAC,kBAAkB,CAC5E,IAAI,CAAC,KAAK,EACV,eAAe,EACf,IAAI,CAAC,aAAa,CACnB,CAAC;gBACF,SAAS,CAAC,cAAc,EAAE,CAAC;aAC5B;YAED,OAAO;gBACL,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,eAAe,CAAC,oBAAoB,CAAC,oBAAoB;gBACjE,OAAO,EAAE,eAAe,CAAC,oBAAoB,CAAC,qBAAqB;gBACnE,YAAY,EAAE,eAAe,CAAC,oBAAoB,CAAC,2BAA2B;aAC/E,CAAC;SACH;QAAC,OAAO,GAAG,EAAE;YACZ,MAAM,KAAK,GAAG,GAAY,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,6BAA6B,EAAE;gBAChD,MAAM,QAAQ,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;aAChE;YACD,MAAM,GAAG,CAAC;SACX;IACH,CAAC;;AAvDH,wDAwDC;AAvDe,gCAAS,GAAG;IACxB,wBAAwB,EAAE,IAAA,2BAAmB,GAAE;CAChD,CAAC"}

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

@@ -0,0 +1,37 @@
+import { Org, SfError } from '@salesforce/core';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Interfaces } from '@oclif/core';
+import { AsyncOperationStatus, PromotePipelineResult } from '../../common';
+/**
+ * Helper to determine if an operation has finished and therefore is not resumable
+ *
+ * @param status status of the async operation
+ * @returns true if the operation has finished
+ */
+export declare function isNotResumable(status: AsyncOperationStatus): boolean;
+export type Flags<T extends typeof SfCommand> = Interfaces.InferredFlags<(typeof ResumeCommand)['baseFlags'] & T['flags']>;
+/**
+ *
+ * Base class with the common logic to resume an in progress opeation
+ */
+export declare abstract class ResumeCommand<T extends typeof SfCommand> extends SfCommand<PromotePipelineResult> {
+    static baseFlags: {
+        'devops-center-username': Interfaces.OptionFlag<Org | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'job-id': Interfaces.OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'use-most-recent': Interfaces.BooleanFlag<boolean>;
+        wait: Interfaces.OptionFlag<import("@salesforce/kit").Duration, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    protected flags: Flags<T>;
+    private outputService;
+    protected abstract operationType: string;
+    protected abstract baseCommand: string;
+    init(): Promise<void>;
+    protected resumeOperation(): Promise<PromotePipelineResult>;
+    /**
+     * Default function for catching commands errors.
+     *
+     * @param error
+     * @returns
+     */
+    protected catch(error: Error | SfError): Promise<SfCommand.Error>;
+}

package/lib/common/base/abstractResume.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResumeCommand = exports.isNotResumable = 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 common_1 = require("../../common");
+const flags_1 = require("../../common/flags/flags");
+const deployPipelineCache_1 = require("./../deployPipelineCache");
+const outputService_1 = require("./../outputService");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+/**
+ * Helper to determine if an operation has finished and therefore is not resumable
+ *
+ * @param status status of the async operation
+ * @returns true if the operation has finished
+ */
+function isNotResumable(status) {
+    return [common_1.AsyncOperationStatus.Completed, common_1.AsyncOperationStatus.Error, common_1.AsyncOperationStatus.Ignored].includes(status);
+}
+exports.isNotResumable = isNotResumable;
+/**
+ *
+ * Base class with the common logic to resume an in progress opeation
+ */
+class ResumeCommand extends sf_plugins_core_1.SfCommand {
+    async init() {
+        await super.init();
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const { flags } = await this.parse({
+            flags: this.ctor.flags,
+            baseFlags: super.ctor.baseFlags,
+        }); // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        this.flags = flags;
+        this.outputService = new outputService_1.OutputServiceFactory().forResume(this.operationType);
+    }
+    async resumeOperation() {
+        const asyncJobId = this.flags['use-most-recent']
+            ? (await deployPipelineCache_1.DeployPipelineCache.create()).getLatestKeyOrThrow()
+            : this.flags['job-id'];
+        // get the latest state of the async job and validate that it's resumable
+        const doceOrg = this.flags['devops-center-username'];
+        let asyncJob = await (0, common_1.fetchAsyncOperationResult)(doceOrg.getConnection(), asyncJobId);
+        if (asyncJob.sf_devops__Status__c && isNotResumable(asyncJob.sf_devops__Status__c)) {
+            throw messages.createError('error.JobNotResumable', [asyncJobId, asyncJob.sf_devops__Status__c]);
+        }
+        // it is resumable so we can start monitoring the operation
+        this.outputService.setAorId(asyncJobId);
+        this.outputService.printOpSummary();
+        this.outputService.printAorId();
+        const streamer = (0, common_1.getAsyncOperationStreamer)(doceOrg, this.flags.wait, asyncJobId, this.outputService);
+        await streamer.monitor();
+        // get final state of the async job
+        asyncJob = await (0, common_1.fetchAsyncOperationResult)(doceOrg.getConnection(), asyncJobId);
+        return {
+            jobId: asyncJobId,
+            status: asyncJob.sf_devops__Status__c,
+            message: asyncJob.sf_devops__Message__c,
+            errorDetails: asyncJob.sf_devops__Error_Details__c,
+        };
+    }
+    /**
+     * 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);
+    }
+}
+exports.ResumeCommand = ResumeCommand;
+// common flags that can be inherited by any command that extends ResumeCommand
+ResumeCommand.baseFlags = {
+    'devops-center-username': (0, flags_1.requiredDoceOrgFlag)(),
+    'job-id': flags_1.jobId,
+    'use-most-recent': flags_1.useMostRecent,
+    wait: flags_1.wait,
+};
+//# sourceMappingURL=abstractResume.js.map

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

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

package/lib/common/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const APPROVED = "Approved";
+export declare const ASYNC_OPERATION_CDC = "/data/Async_Operation_Result__ChangeEvent";
+export declare const REST_PROMOTE_BASE_URL = "/services/apexrest/sf_devops/pipeline/promote/v1/";
+export declare const HTTP_CONFLICT_CODE = "CONFLICT";
+export declare enum AsyncOperationType {
+    AD_HOC_PROMOTE = "AD_HOC_PROMOTE",
+    VERSIONED_PROMOTE = "VERSIONED_PROMOTE",
+    SOUP_PROMOTE = "SOUP_PROMOTE"
+}

package/lib/common/constants.js

@@ -0,0 +1,20 @@
+"use strict";
+/*
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncOperationType = exports.HTTP_CONFLICT_CODE = exports.REST_PROMOTE_BASE_URL = exports.ASYNC_OPERATION_CDC = exports.APPROVED = void 0;
+exports.APPROVED = 'Approved';
+exports.ASYNC_OPERATION_CDC = '/data/Async_Operation_Result__ChangeEvent';
+exports.REST_PROMOTE_BASE_URL = '/services/apexrest/sf_devops/pipeline/promote/v1/';
+exports.HTTP_CONFLICT_CODE = 'CONFLICT';
+var AsyncOperationType;
+(function (AsyncOperationType) {
+    AsyncOperationType["AD_HOC_PROMOTE"] = "AD_HOC_PROMOTE";
+    AsyncOperationType["VERSIONED_PROMOTE"] = "VERSIONED_PROMOTE";
+    AsyncOperationType["SOUP_PROMOTE"] = "SOUP_PROMOTE";
+})(AsyncOperationType = exports.AsyncOperationType || (exports.AsyncOperationType = {}));
+//# sourceMappingURL=constants.js.map

package/lib/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,QAAQ,GAAG,UAAU,CAAC;AACtB,QAAA,mBAAmB,GAAG,2CAA2C,CAAC;AAClE,QAAA,qBAAqB,GAAG,mDAAmD,CAAC;AAC5E,QAAA,kBAAkB,GAAG,UAAU,CAAC;AAC7C,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,uDAAiC,CAAA;IACjC,6DAAuC,CAAA;IACvC,mDAA6B,CAAA;AAC/B,CAAC,EAJW,kBAAkB,GAAlB,0BAAkB,KAAlB,0BAAkB,QAI7B"}

package/lib/common/deployPipelineCache.d.ts

@@ -0,0 +1,39 @@
+import { TTLConfig } from '@salesforce/core';
+import { JsonMap } from '@salesforce/ts-types';
+export type AsyncOperationData = Record<string, never>;
+/**
+ * Caches the AOR data
+ *
+ * @author JuanStenghele-sf
+ */
+export declare class DeployPipelineCache extends TTLConfig<TTLConfig.Options, AsyncOperationData> {
+    /**
+     * Returns the cache's filename
+     */
+    static getFileName(): string;
+    /**
+     * Returns the cache's options
+     */
+    static getDefaultOptions(): TTLConfig.Options;
+    /**
+     * Caches the data sent
+     */
+    static set(aorId: string, data: AsyncOperationData): Promise<void>;
+    /**
+     * Removes the data associated with the aorId
+     */
+    static unset(aorId: string): Promise<void>;
+    /**
+     * Updates the aorId with the data sent
+     * Merges the data sent with the existing one
+     */
+    static update(aorId: string, data: JsonMap): Promise<void>;
+    /**
+     * Returns the data associated with the aorId
+     */
+    get(aorId: string): TTLConfig.Entry<AsyncOperationData>;
+    /**
+     * Returns the latest data cached or throws if can't find any.
+     */
+    getLatestKeyOrThrow(): string;
+}

package/lib/common/deployPipelineCache.js

@@ -0,0 +1,81 @@
+"use strict";
+/*
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeployPipelineCache = void 0;
+const core_1 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
+core_1.Messages.importMessagesDirectory(__dirname);
+const cacheMessages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'cache');
+/**
+ * Caches the AOR data
+ *
+ * @author JuanStenghele-sf
+ */
+class DeployPipelineCache extends core_1.TTLConfig {
+    /**
+     * Returns the cache's filename
+     */
+    static getFileName() {
+        return 'deploy-pipeline-cache.json';
+    }
+    /**
+     * Returns the cache's options
+     */
+    static getDefaultOptions() {
+        return {
+            isGlobal: true,
+            isState: false,
+            filename: this.getFileName(),
+            stateFolder: core_1.Global.SF_STATE_FOLDER,
+            ttl: kit_1.Duration.days(3),
+        };
+    }
+    /**
+     * Caches the data sent
+     */
+    static async set(aorId, data) {
+        const cache = await DeployPipelineCache.create();
+        cache.set(aorId, data);
+        await cache.write();
+    }
+    /**
+     * Removes the data associated with the aorId
+     */
+    static async unset(aorId) {
+        const cache = await DeployPipelineCache.create();
+        cache.unset(aorId);
+        await cache.write();
+    }
+    /**
+     * Updates the aorId with the data sent
+     * Merges the data sent with the existing one
+     */
+    static async update(aorId, data) {
+        const cache = await DeployPipelineCache.create();
+        cache.update(aorId, data);
+        await cache.write();
+    }
+    /**
+     * Returns the data associated with the aorId
+     */
+    get(aorId) {
+        return super.get(aorId);
+    }
+    /**
+     * Returns the latest data cached or throws if can't find any.
+     */
+    getLatestKeyOrThrow() {
+        const aorId = this.getLatestKey();
+        if (!aorId) {
+            throw cacheMessages.createError('error.NoRecentAorId');
+        }
+        return aorId;
+    }
+}
+exports.DeployPipelineCache = DeployPipelineCache;
+//# sourceMappingURL=deployPipelineCache.js.map

package/lib/common/deployPipelineCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployPipelineCache.js","sourceRoot":"","sources":["../../src/common/deployPipelineCache.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2CAA+D;AAC/D,yCAA2C;AAG3C,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,aAAa,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,OAAO,CAAC,CAAC;AAKzF;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,gBAAgD;IACvF;;OAEG;IACI,MAAM,CAAC,WAAW;QACvB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,iBAAiB;QAC7B,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE;YAC5B,WAAW,EAAE,aAAM,CAAC,eAAe;YACnC,GAAG,EAAE,cAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,IAAwB;QAC7D,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,CAAC;QACjD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAa;QACrC,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,CAAC;QACjD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAAa;QACrD,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,CAAC;QACjD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,KAAa;QACtB,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,mBAAmB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,aAAa,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;SACxD;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAlED,kDAkEC"}

package/lib/common/flags/flags.d.ts

@@ -0,0 +1,19 @@
+import { Org } from '@salesforce/core';
+import { Duration } from '@salesforce/kit';
+import { BooleanFlag, OptionFlag } from '@oclif/core/lib/interfaces';
+export declare const devopsCenterProjectName: OptionFlag<string>;
+/**
+ * Wait flag
+ * This is used to determine how many minutes we are going to stream results before giving back the control of the terminal to the user.
+ */
+export declare const wait: OptionFlag<Duration>;
+/**
+ * Custom flag for the target devops center org.
+ * Makes this flag required and validates that passed in alias/username corresponds to an authenticated org.
+ * If no value is passed in, then it looks for the alias/username set in the --target-devops-center config variable.
+ */
+export declare const requiredDoceOrgFlag: import("@oclif/core/lib/interfaces/parser").FlagDefinition<Org, Record<string, unknown>>;
+export declare const jobId: OptionFlag<string | undefined>;
+export declare const useMostRecent: BooleanFlag<boolean>;
+export declare const verbose: BooleanFlag<boolean>;
+export declare const concise: BooleanFlag<boolean>;