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

package/lib/common/selectors/deploymentResultsSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploymentResultsSelector.js","sourceRoot":"","sources":["../../../src/common/selectors/deploymentResultsSelector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAKH;;;GAGG;AACI,KAAK,UAAU,qCAAqC,CACzD,GAAe,EACf,UAAkB;IAElB,MAAM,QAAQ,GAAG;;;;;uDAKoC,UAAU,GAAG,CAAC;IACnE,OAAO,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAXD,sFAWC"}

package/lib/common/selectors/environmentSelector.d.ts

@@ -0,0 +1,11 @@
+import { QueryResult } from 'jsforce';
+import { Connection } from '@salesforce/core';
+import { PipelineStage } from '../types';
+export type EnvQueryResult = {
+    sf_devops__Named_Credential__c: string;
+    sf_devops__Pipeline_Stages__r: QueryResult<PipelineStage>;
+};
+/**
+ * Returns the named credential and pipeline stage name associated with the envId sent
+ */
+export declare function selectPipelineStageByEnvironment(con: Connection, envId: string): Promise<EnvQueryResult>;

package/lib/common/selectors/environmentSelector.js

@@ -0,0 +1,22 @@
+"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.selectPipelineStageByEnvironment = void 0;
+/**
+ * Returns the named credential and pipeline stage name associated with the envId sent
+ */
+async function selectPipelineStageByEnvironment(con, envId) {
+    const queryStr = `SELECT sf_devops__Named_Credential__c, 
+                    (SELECT Name FROM sf_devops__Pipeline_Stages__r)
+                    FROM sf_devops__Environment__c 
+                    WHERE Id = '${envId}'`;
+    const resp = await con.query(queryStr);
+    return resp.records[0];
+}
+exports.selectPipelineStageByEnvironment = selectPipelineStageByEnvironment;
+//# sourceMappingURL=environmentSelector.js.map

package/lib/common/selectors/environmentSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentSelector.js","sourceRoot":"","sources":["../../../src/common/selectors/environmentSelector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAYH;;GAEG;AACI,KAAK,UAAU,gCAAgC,CAAC,GAAe,EAAE,KAAa;IACnF,MAAM,QAAQ,GAAG;;;kCAGe,KAAK,GAAG,CAAC;IACzC,MAAM,IAAI,GAAgC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC;AAPD,4EAOC"}

package/lib/common/selectors/namedCredentialSelector.d.ts

@@ -0,0 +1,6 @@
+import { Connection } from '@salesforce/core';
+import { NamedCredential } from '../types';
+/**
+ * Given a named credential it returns the org url (endpoint) associated with it
+ */
+export declare function selectNamedCredentialByName(con: Connection, name: string): Promise<NamedCredential>;

package/lib/common/selectors/namedCredentialSelector.js

@@ -0,0 +1,24 @@
+"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.selectNamedCredentialByName = void 0;
+/**
+ * Given a named credential it returns the org url (endpoint) associated with it
+ */
+async function selectNamedCredentialByName(con, name) {
+    const queryStr = `
+    SELECT Endpoint
+    FROM NamedCredential
+    WHERE DeveloperName = '${name}'
+    AND NamespacePrefix = 'sf_devops'
+    LIMIT 1`;
+    const resp = await con.query(queryStr);
+    return resp.records[0];
+}
+exports.selectNamedCredentialByName = selectNamedCredentialByName;
+//# sourceMappingURL=namedCredentialSelector.js.map

package/lib/common/selectors/namedCredentialSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namedCredentialSelector.js","sourceRoot":"","sources":["../../../src/common/selectors/namedCredentialSelector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAMH;;GAEG;AACI,KAAK,UAAU,2BAA2B,CAAC,GAAe,EAAE,IAAY;IAC7E,MAAM,QAAQ,GAAG;;;6BAGU,IAAI;;YAErB,CAAC;IACX,MAAM,IAAI,GAAiC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC;AATD,kEASC"}

package/lib/common/selectors/pipelineStageSelector.d.ts

@@ -0,0 +1,7 @@
+import { Connection } from '@salesforce/core';
+import { PipelineStage } from '../types';
+/**
+ *
+ * Returns an array of a pipeline stages filtering by project name.
+ */
+export declare function selectPipelineStagesByProject(con: Connection, projectName: string): Promise<PipelineStage[]>;

package/lib/common/selectors/pipelineStageSelector.js

@@ -0,0 +1,22 @@
+"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.selectPipelineStagesByProject = void 0;
+/**
+ *
+ * Returns an array of a pipeline stages filtering by project name.
+ */
+async function selectPipelineStagesByProject(con, projectName) {
+    const queryStr = `SELECT Id, sf_devops__Pipeline__r.sf_devops__Project__c, sf_devops__Branch__r.sf_devops__Name__c, (SELECT Id FROM sf_devops__Pipeline_Stages__r)
+                    FROM sf_devops__Pipeline_Stage__c  
+                    WHERE sf_devops__Pipeline__r.sf_devops__Project__r.Name = '${projectName}'`;
+    const resp = await con.query(queryStr);
+    return resp.records;
+}
+exports.selectPipelineStagesByProject = selectPipelineStagesByProject;
+//# sourceMappingURL=pipelineStageSelector.js.map

package/lib/common/selectors/pipelineStageSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineStageSelector.js","sourceRoot":"","sources":["../../../src/common/selectors/pipelineStageSelector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAMH;;;GAGG;AACI,KAAK,UAAU,6BAA6B,CAAC,GAAe,EAAE,WAAmB;IACtF,MAAM,QAAQ,GAAG;;iFAE8D,WAAW,GAAG,CAAC;IAC9F,MAAM,IAAI,GAA+B,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AAND,sEAMC"}

package/lib/common/selectors/workItemSelector.d.ts

@@ -0,0 +1,11 @@
+import { QueryResult } from 'jsforce';
+import { Connection } from '@salesforce/core';
+import { WorkItem } from '../types';
+export type WorkItemsQueryResult = {
+    Id: string;
+    sf_devops__Work_Items__r: QueryResult<WorkItem>;
+};
+/**
+ * Returns the work items included in the change bundles sent
+ */
+export declare function selectWorkItemsByChangeBundles(con: Connection, changeBundles: string[]): Promise<WorkItemsQueryResult[]>;

package/lib/common/selectors/workItemSelector.js

@@ -0,0 +1,22 @@
+"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.selectWorkItemsByChangeBundles = void 0;
+/**
+ * Returns the work items included in the change bundles sent
+ */
+async function selectWorkItemsByChangeBundles(con, changeBundles) {
+    const queryStr = `SELECT Id,
+                    (SELECT Name FROM sf_devops__Work_Items__r)
+                    FROM sf_devops__Change_Bundle__c
+                    WHERE Id IN (${changeBundles.map((id) => "'" + id + "'").join(', ')})`;
+    const resp = await con.query(queryStr);
+    return resp.records;
+}
+exports.selectWorkItemsByChangeBundles = selectWorkItemsByChangeBundles;
+//# sourceMappingURL=workItemSelector.js.map

package/lib/common/selectors/workItemSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workItemSelector.js","sourceRoot":"","sources":["../../../src/common/selectors/workItemSelector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAYH;;GAEG;AACI,KAAK,UAAU,8BAA8B,CAClD,GAAe,EACf,aAAuB;IAEvB,MAAM,QAAQ,GAAG;;;mCAGgB,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACzF,MAAM,IAAI,GAAsC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AAVD,wEAUC"}

package/lib/common/types.d.ts

@@ -0,0 +1,98 @@
+export type PromotePipelineResult = {
+    jobId: string;
+    status?: string;
+    message?: string;
+    errorDetails?: string;
+};
+export type Pipeline = {
+    sf_devops__Project__c: string;
+};
+export type PipelineStage = {
+    Id: string;
+    Name: string;
+    sf_devops__Branch__r: Branch;
+    sf_devops__Pipeline__r: Pipeline;
+    sf_devops__Pipeline_Stages__r?: PreviousPipelineStages;
+    sf_devops__Environment__r: Environment;
+};
+export type PreviousPipelineStages = {
+    records: PipelineStage[];
+};
+export type Branch = {
+    sf_devops__Name__c: string;
+};
+export declare enum TestLevel {
+    NoTestRun = "NoTestRun",
+    RunSpecifiedTests = "RunSpecifiedTests",
+    RunLocalTests = "RunLocalTests",
+    RunAllTestsInOrg = "RunAllTestsInOrg"
+}
+export interface ApiError extends Error {
+    errorCode: string;
+    name: string;
+}
+export type WorkItem = {
+    Name: string;
+};
+export type WorkItemPromote = {
+    sf_devops__Pipeline_Stage__r: PipelineStage;
+    sf_devops__Work_Item__r: WorkItem;
+};
+export type Environment = {
+    Id: string;
+    sf_devops__Named_Credential__c: string;
+};
+export type ChangeBundleInstall = {
+    sf_devops__Environment__r: Environment;
+    sf_devops__Change_Bundle__r: ChangeBundle;
+};
+export type ChangeBundle = {
+    Id: string;
+    sf_devops__Version_Name__c: string;
+};
+export type PromoteOptions = {
+    fullDeploy: boolean;
+    testLevel: string;
+    runTests: string;
+    undeployedOnly: boolean;
+    checkDeploy: boolean;
+    deploymentId: string;
+};
+export type DeploymentResult = {
+    sf_devops__Full_Deploy__c: boolean;
+    sf_devops__Check_Deploy__c: boolean;
+    sf_devops__Completion_Date__c: string;
+    sf_devops__Test_Level__c: string;
+    sf_devops__Run_Tests__c: string;
+    sf_devops__Status__r: AsyncOperationResult;
+};
+export type AsyncOperationResult = {
+    Id: string;
+    CreatedDate?: string;
+    CreatedById?: string;
+    CreatedBy?: User;
+    LastModifiedDate?: string;
+    sf_devops__Message__c?: string;
+    sf_devops__Status__c?: AsyncOperationStatus;
+    sf_devops__Error_Details__c?: string;
+};
+export type User = {
+    Id?: string;
+    Name: string;
+};
+export declare enum AsyncOperationStatus {
+    Error = "Error",
+    Completed = "Completed",
+    Ignored = "Ignored",
+    InProgress = "In Progress"
+}
+export type NamedCredential = {
+    Endpoint: string;
+};
+export type DeployComponent = {
+    sf_devops__Source_Component__c: string;
+    sf_devops__Operation__c: string;
+    sf_devops__File_Path__c: string;
+    Type?: string;
+    Name?: string;
+};

package/lib/common/types.js

@@ -0,0 +1,24 @@
+"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 });
+exports.AsyncOperationStatus = exports.TestLevel = void 0;
+var TestLevel;
+(function (TestLevel) {
+    TestLevel["NoTestRun"] = "NoTestRun";
+    TestLevel["RunSpecifiedTests"] = "RunSpecifiedTests";
+    TestLevel["RunLocalTests"] = "RunLocalTests";
+    TestLevel["RunAllTestsInOrg"] = "RunAllTestsInOrg";
+})(TestLevel = exports.TestLevel || (exports.TestLevel = {}));
+var AsyncOperationStatus;
+(function (AsyncOperationStatus) {
+    AsyncOperationStatus["Error"] = "Error";
+    AsyncOperationStatus["Completed"] = "Completed";
+    AsyncOperationStatus["Ignored"] = "Ignored";
+    AsyncOperationStatus["InProgress"] = "In Progress";
+})(AsyncOperationStatus = exports.AsyncOperationStatus || (exports.AsyncOperationStatus = {}));
+//# sourceMappingURL=types.js.map

package/lib/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA8BH,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,oDAAuC,CAAA;IACvC,4CAA+B,CAAA;IAC/B,kDAAqC,CAAA;AACvC,CAAC,EALW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAKpB;AAiED,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,uCAAe,CAAA;IACf,+CAAuB,CAAA;IACvB,2CAAmB,CAAA;IACnB,kDAA0B,CAAA;AAC5B,CAAC,EALW,oBAAoB,GAApB,4BAAoB,KAApB,4BAAoB,QAK/B"}

package/lib/common/utils.d.ts

@@ -0,0 +1,75 @@
+import { Connection, Org } from '@salesforce/core';
+import { Duration } from '@salesforce/kit';
+import { Nullable } from '@salesforce/ts-types';
+import { PipelineStage, TestLevel } from '../common';
+import AsyncOpStreaming from '../streamer/processors/asyncOpStream';
+import { AorOutputService } from './outputService/aorOutputService';
+import { AsyncOperationResult, DeployComponent } from './types';
+/**
+ * @description validates the following:
+ * - if RunSpecifiedTests is specified, then it needs to indicate tests to run.
+ * - if other than RunSpecifiedTests is specified, then it can't indicate tests to run.
+ * @param testLevel specified test level
+ * @param tests specific tests to run
+ */
+export declare function validateTestFlags(testLevel: Nullable<TestLevel>, tests: Nullable<string[]>): void;
+/**
+ *
+ * Query the target org to get a pipeline stage filtering by project name and branch name.
+ * Also uses the same query to validate that Devops Center is installed in the target org.
+ *
+ * @param targetOrg Org. Target org.
+ * @param projectName string. Name of the project.
+ * @param branchName string. Name of the branch.
+ * @throws if Devops Center is not installed in the target org.
+ * @throws if it cant' find the given project.
+ * @throws if it cant' find the a pipeline stge that matches the given branch.
+ */
+export declare function fetchAndValidatePipelineStage(targetOrg: Org, projectName: string, branchName: string): Promise<PipelineStage>;
+export declare function fetchAsyncOperationResult(con: Connection, aorId: string): Promise<AsyncOperationResult>;
+export declare function getAsyncOperationStreamer(org: Org, waitTime: Duration, idToInspect: string, outputService: AorOutputService): AsyncOpStreaming;
+/**
+ *
+ * Helper to inspect an array of SF ids to check if it contains the given Id,
+ * independently if it is a 15 or 18 characters long.
+ *
+ * @param idsToInspect array of ids which might contain the given id
+ * @param idToFind id to look for
+ * @returns true is the array contains the given id
+ */
+export declare function containsSfId(idsToInspect: string[], idToFind: string): boolean;
+/**
+ *
+ * Helper to compare to SF Ids independently if they are 15 or 18 characters long.
+ *
+ * @param firstId
+ * @param secondId
+ * @returns true is the Ids match
+ */
+export declare function matchesSfId(firstId: string, secondId: string): boolean;
+/**
+ * Helper to convert an sObject into an array of {key : value}
+ * and format the keys.
+ *
+ * @param sObj sObject to convert.
+ * @returns an array of {key : value}
+ */
+export declare function sObjectToArrayOfKeyValue(sObj: object): Array<{
+    key: string;
+    value: unknown;
+}>;
+/**
+ * Helper to remove the prefix, sufix and underscores in a DOCe sObject field name.
+ *
+ * @param fieldName DOCe field name.
+ * @returns formatted field name.
+ */
+export declare function formatFieldName(fieldName: string): string;
+/**
+ * Helper to return a formatted DeployComponent list (Type/Name filled).
+ *
+ * @param con The connection needed for the query
+ * @param asyncOpId The Id of the AsyncOperation
+ * @returns A list of DeployComponent
+ */
+export declare function getFormattedDeployComponentsByAyncOpId(con: Connection, asyncOpId: string): Promise<DeployComponent[]>;

package/lib/common/utils.js

@@ -0,0 +1,176 @@
+"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 });
+exports.getFormattedDeployComponentsByAyncOpId = exports.formatFieldName = exports.sObjectToArrayOfKeyValue = exports.matchesSfId = exports.containsSfId = exports.getAsyncOperationStreamer = exports.fetchAsyncOperationResult = exports.fetchAndValidatePipelineStage = exports.validateTestFlags = void 0;
+const core_1 = require("@salesforce/core");
+const ts_types_1 = require("@salesforce/ts-types");
+const common_1 = require("../common");
+const pipelineStageSelector_1 = require("../common/selectors/pipelineStageSelector");
+const asyncOpStream_1 = require("../streamer/processors/asyncOpStream");
+const outputUtils_1 = require("./outputService/outputUtils");
+const asyncOperationResultsSelector_1 = require("./selectors/asyncOperationResultsSelector");
+const deployComponentsSelector_1 = require("./selectors/deployComponentsSelector");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'commonErrors');
+/**
+ * @description validates the following:
+ * - if RunSpecifiedTests is specified, then it needs to indicate tests to run.
+ * - if other than RunSpecifiedTests is specified, then it can't indicate tests to run.
+ * @param testLevel specified test level
+ * @param tests specific tests to run
+ */
+function validateTestFlags(testLevel, tests) {
+    if (testLevel === common_1.TestLevel.RunSpecifiedTests && (tests ?? []).length === 0) {
+        throw messages.createError('error.NoTestsSpecified');
+    }
+    else if (testLevel !== common_1.TestLevel.RunSpecifiedTests && tests) {
+        throw messages.createError('error.InvalidRunTests');
+    }
+}
+exports.validateTestFlags = validateTestFlags;
+/**
+ *
+ * Query the target org to get a pipeline stage filtering by project name and branch name.
+ * Also uses the same query to validate that Devops Center is installed in the target org.
+ *
+ * @param targetOrg Org. Target org.
+ * @param projectName string. Name of the project.
+ * @param branchName string. Name of the branch.
+ * @throws if Devops Center is not installed in the target org.
+ * @throws if it cant' find the given project.
+ * @throws if it cant' find the a pipeline stge that matches the given branch.
+ */
+async function fetchAndValidatePipelineStage(targetOrg, projectName, branchName) {
+    let stages;
+    try {
+        stages = await (0, pipelineStageSelector_1.selectPipelineStagesByProject)(targetOrg.getConnection(), projectName);
+    }
+    catch (err) {
+        const error = err;
+        if (error.errorCode === 'INVALID_TYPE') {
+            throw messages.createError('error.DevopsAppNotInstalled');
+        }
+        throw new core_1.SfError((0, ts_types_1.getString)(err, 'errorMessage', 'unknown'), (0, ts_types_1.getString)(err, 'errorStatusCode', 'unknown'));
+    }
+    if (!stages.length) {
+        throw messages.createError('error.ProjectNotFound', [projectName]);
+    }
+    // find stage by branch name
+    const stage = stages.find((s) => s.sf_devops__Branch__r.sf_devops__Name__c.toUpperCase() === branchName.toUpperCase());
+    if (!stage) {
+        throw messages.createError('error.BranchNotFound', [branchName, projectName]);
+    }
+    return stage;
+}
+exports.fetchAndValidatePipelineStage = fetchAndValidatePipelineStage;
+async function fetchAsyncOperationResult(con, aorId) {
+    let aor;
+    try {
+        aor = await (0, asyncOperationResultsSelector_1.selectAsyncOperationResultById)(con, aorId);
+    }
+    catch (err) {
+        const error = err;
+        if (error.name === 'SingleRecordQuery_NoRecords') {
+            throw messages.createError('error.InvalidAorId', [aorId]);
+        }
+        throw err;
+    }
+    return aor;
+}
+exports.fetchAsyncOperationResult = fetchAsyncOperationResult;
+function getAsyncOperationStreamer(org, waitTime, idToInspect, outputService) {
+    return new asyncOpStream_1.default(org, waitTime, idToInspect, outputService);
+}
+exports.getAsyncOperationStreamer = getAsyncOperationStreamer;
+/**
+ *
+ * Helper to inspect an array of SF ids to check if it contains the given Id,
+ * independently if it is a 15 or 18 characters long.
+ *
+ * @param idsToInspect array of ids which might contain the given id
+ * @param idToFind id to look for
+ * @returns true is the array contains the given id
+ */
+function containsSfId(idsToInspect, idToFind) {
+    let shortId;
+    if (idToFind.length === 18) {
+        shortId = idToFind.substring(0, 15);
+    }
+    else if (idToFind.length === 15) {
+        shortId = idToFind;
+    }
+    else {
+        return false;
+    }
+    return idsToInspect.some((k) => k.startsWith(shortId));
+}
+exports.containsSfId = containsSfId;
+/**
+ *
+ * Helper to compare to SF Ids independently if they are 15 or 18 characters long.
+ *
+ * @param firstId
+ * @param secondId
+ * @returns true is the Ids match
+ */
+function matchesSfId(firstId, secondId) {
+    return containsSfId([firstId], secondId);
+}
+exports.matchesSfId = matchesSfId;
+/**
+ * Helper to convert an sObject into an array of {key : value}
+ * and format the keys.
+ *
+ * @param sObj sObject to convert.
+ * @returns an array of {key : value}
+ */
+function sObjectToArrayOfKeyValue(sObj) {
+    const acumulator = [];
+    return Object.entries(sObj).reduce((res, [key, value]) => {
+        if (key !== 'attributes') {
+            if (typeof value === 'object' && value !== null) {
+                return res.concat(sObjectToArrayOfKeyValue(value));
+            }
+            else if (key === 'sf_devops__Status__c') {
+                return res.concat({ key: formatFieldName(key), value: (0, outputUtils_1.colorStatus)(value) });
+            }
+            else {
+                return res.concat({ key: formatFieldName(key), value: value });
+            }
+        }
+        return res;
+    }, acumulator);
+}
+exports.sObjectToArrayOfKeyValue = sObjectToArrayOfKeyValue;
+/**
+ * Helper to remove the prefix, sufix and underscores in a DOCe sObject field name.
+ *
+ * @param fieldName DOCe field name.
+ * @returns formatted field name.
+ */
+function formatFieldName(fieldName) {
+    return fieldName.replace('sf_devops__', '').replace('__c', '').replace('_', '');
+}
+exports.formatFieldName = formatFieldName;
+/**
+ * Helper to return a formatted DeployComponent list (Type/Name filled).
+ *
+ * @param con The connection needed for the query
+ * @param asyncOpId The Id of the AsyncOperation
+ * @returns A list of DeployComponent
+ */
+async function getFormattedDeployComponentsByAyncOpId(con, asyncOpId) {
+    const components = await (0, deployComponentsSelector_1.selectDeployComponentsByAsyncOpId)(con, asyncOpId);
+    components.forEach((component) => {
+        component.Type = component.sf_devops__Source_Component__c.split(':')[0];
+        component.Name = component.sf_devops__Source_Component__c.split(':')[1];
+    });
+    return components;
+}
+exports.getFormattedDeployComponentsByAyncOpId = getFormattedDeployComponentsByAyncOpId;
+//# sourceMappingURL=utils.js.map

package/lib/common/utils.js.map

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

package/lib/configMeta.d.ts

@@ -0,0 +1,13 @@
+export declare enum ConfigVars {
+    TARGET_DEVOPS_CENTER = "target-devops-center"
+}
+/**
+ * Creates a configuration variable called --target-devops-center.
+ * Once set, it acts as the default target devops center org for the commands in this plugin.
+ */
+declare const _default: {
+    key: ConfigVars;
+    description: string;
+    hidden: boolean;
+}[];
+export default _default;

package/lib/configMeta.js

@@ -0,0 +1,28 @@
+"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.ConfigVars = void 0;
+const core_1 = require("@salesforce/core");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-devops-center', 'config');
+var ConfigVars;
+(function (ConfigVars) {
+    ConfigVars["TARGET_DEVOPS_CENTER"] = "target-devops-center";
+})(ConfigVars = exports.ConfigVars || (exports.ConfigVars = {}));
+/**
+ * Creates a configuration variable called --target-devops-center.
+ * Once set, it acts as the default target devops center org for the commands in this plugin.
+ */
+exports.default = [
+    {
+        key: ConfigVars.TARGET_DEVOPS_CENTER,
+        description: messages.getMessage(ConfigVars.TARGET_DEVOPS_CENTER),
+        hidden: false,
+    },
+];
+//# sourceMappingURL=configMeta.js.map

package/lib/configMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configMeta.js","sourceRoot":"","sources":["../src/configMeta.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2CAA4C;AAE5C,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,kCAAkC,EAAE,QAAQ,CAAC,CAAC;AAErF,IAAY,UAEX;AAFD,WAAY,UAAU;IACpB,2DAA6C,CAAA;AAC/C,CAAC,EAFW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAErB;AAED;;;GAGG;AACH,kBAAe;IACb;QACE,GAAG,EAAE,UAAU,CAAC,oBAAoB;QACpC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,oBAAoB,CAAC;QACjE,MAAM,EAAE,KAAK;KACd;CACF,CAAC"}

package/lib/streamer/doceMonitor.d.ts

@@ -0,0 +1,7 @@
+import { AnyJson } from '@salesforce/ts-types';
+/**
+ * Common interface used to monitor the progress of something in the DevOps Center.
+ **/
+export default interface DoceMonitor {
+    monitor(): Promise<void | AnyJson>;
+}

package/lib/streamer/doceMonitor.js

@@ -0,0 +1,9 @@
+"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 });
+//# sourceMappingURL=doceMonitor.js.map

package/lib/streamer/doceMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doceMonitor.js","sourceRoot":"","sources":["../../src/streamer/doceMonitor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/lib/streamer/doceStream.d.ts

@@ -0,0 +1,20 @@
+import { Org, StatusResult } from '@salesforce/core';
+import { AnyJson, JsonMap } from '@salesforce/ts-types';
+import { Duration } from '@salesforce/kit';
+import DoceMonitor from './doceMonitor';
+/**
+ * Common base class for DOCe monitor that use the streaming api to listen to a streaming channel (CDC).
+ */
+export default abstract class DOCeStreaming implements DoceMonitor {
+    private doceOrg;
+    private wait;
+    constructor(org: Org, wait: Duration);
+    /**
+     * This creates the streaming client and starts listening the desired streaming channel.
+     *
+     * @param channel The channel we want to listen (CDC)
+     * @param processor The specific processor we want to use for the event
+     */
+    protected startStream(channel: string, processor: (message: JsonMap) => StatusResult): Promise<void | AnyJson>;
+    abstract monitor(): Promise<void | AnyJson>;
+}