@salesforce/plugin-deploy-retrieve 1.5.2 → 1.5.5

package/lib/utils/previewOutput.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConflictFiles = exports.printTables = exports.compileResults = void 0;
+/*
+ * 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
+ */
+const path = require("path");
+const core_1 = require("@oclif/core");
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const chalk_1 = require("chalk");
+const core_2 = require("@salesforce/core");
+const source_deploy_retrieve_1 = require("@salesforce/source-deploy-retrieve");
+const filePathGenerator_1 = require("@salesforce/source-deploy-retrieve/lib/src/utils/filePathGenerator");
+core_2.Messages.importMessagesDirectory(__dirname);
+const messages = core_2.Messages.load('@salesforce/plugin-deploy-retrieve', 'previewMessages', [
+    'conflicts.header',
+    'conflicts.none',
+    'ignored.header',
+    'ignored.none',
+    'deploy.none',
+    'deploy.header',
+    'delete.header',
+    'delete.none',
+    'retrieve.header',
+    'retrieve.none',
+]);
+const ensureAbsolutePath = (f) => (path.isAbsolute(f) ? f : path.resolve(f));
+// borrowed from STL populateFilesPaths.
+// TODO: this goes in SDR maybe?
+const resolvePaths = (filenames) => {
+    // component set generated from the filenames on all local changes
+    const resolver = new source_deploy_retrieve_1.MetadataResolver(undefined, source_deploy_retrieve_1.VirtualTreeContainer.fromFilePaths(filenames), false);
+    const sourceComponents = filenames
+        .flatMap((filename) => {
+        try {
+            return resolver.getComponentsFromPath(filename);
+        }
+        catch (e) {
+            // resolver will do logging before throw we don't do it here
+            return undefined;
+        }
+    })
+        .filter((sc) => sc && 'fullName' in sc && 'type' in sc)
+        .map((sc) => ({ fullName: sc.fullName, type: sc.type.name, path: ensureAbsolutePath(sc.xml) }));
+    // dedupe by xml path
+    return Array.from(new Map(sourceComponents.map((sc) => [sc.path, sc])).values());
+};
+const calculateDeployOperation = (destructiveChangesType) => {
+    switch (destructiveChangesType) {
+        case source_deploy_retrieve_1.DestructiveChangesType.POST:
+            return 'deletePost';
+        case source_deploy_retrieve_1.DestructiveChangesType.PRE:
+            return 'deletePre';
+        default:
+            return 'deploy';
+    }
+};
+const getNonIgnoredConflicts = (files) => files.filter((f) => f.conflict && !f.ignored);
+const willGo = (previewFile) => !previewFile.conflict && !previewFile.ignored;
+const getWillDeploy = (files) => files.filter((f) => willGo(f) && f.operation === 'deploy');
+const getWillRetrieve = (files) => files.filter((f) => willGo(f) && f.operation === 'retrieve');
+const getWillDelete = (files) => files.filter((f) => willGo(f) && ['deletePre', 'deletePost'].includes(f.operation));
+// relative paths are easier on tables
+const columns = { type: {}, fullName: {}, projectRelativePath: { header: 'Path' } };
+const makeKey = ({ type, fullName }) => `${type.name}#${fullName}`;
+const compileResults = ({ componentSet, projectPath, filesWithConflicts, forceIgnore, baseOperation, remoteDeletes, }) => {
+    // when we iterate all the componentSet,
+    // this map makes it easy to get the source-backed local components
+    const sourceBackedComponents = new Map(componentSet.getSourceComponents().map((sc) => [makeKey({ type: sc.type, fullName: sc.fullName }), sc]));
+    const sourceComponentToPreviewFile = (c) => ({
+        type: c.type.name,
+        fullName: c.fullName,
+        conflict: [c.xml, c.content].some((v) => v && filesWithConflicts.has(v)),
+        ignored: [c.xml, c.content].some((v) => v && forceIgnore.denies(v)),
+        path: path.isAbsolute(c.xml) ? c.xml : path.resolve(c.xml),
+        projectRelativePath: path.relative(projectPath, c.xml), // for cleaner output
+        // There should not be anything in forceignore returned by the componentSet
+    });
+    const actionableFiles = componentSet
+        .toArray()
+        .map((c) => sourceBackedComponents.get(makeKey(c)) ?? c)
+        .map((cmp) => {
+        const maybeSourceBackedComponent = sourceBackedComponents.get(makeKey(cmp)) ?? cmp;
+        if ('xml' in maybeSourceBackedComponent) {
+            // source backed components exist locally
+            return {
+                ...sourceComponentToPreviewFile(maybeSourceBackedComponent),
+                operation: baseOperation === 'deploy'
+                    ? calculateDeployOperation(maybeSourceBackedComponent.getDestructiveChangesType())
+                    : baseOperation,
+            };
+        }
+        else {
+            return {
+                type: maybeSourceBackedComponent.type.name,
+                fullName: maybeSourceBackedComponent.fullName,
+                // if it doesn't exist locally, it can't be a conflict
+                conflict: false,
+                operation: baseOperation,
+                // we have to calculate the "potential filename" to know if a remote retrieve would be ignored
+                ignored: (0, filePathGenerator_1.filePathsFromMetadataComponent)(maybeSourceBackedComponent).some((p) => forceIgnore.denies(p)),
+            };
+        }
+    })
+        // remote deletes are not in the componentSet
+        .concat((remoteDeletes ?? []).map((c) => ({
+        ...sourceComponentToPreviewFile(c),
+        operation: 'deletePre',
+    })));
+    // Source backed components won't appear in the ComponentSet if ignored
+    const ignoredSourceComponents = resolvePaths([...(componentSet.forceIgnoredPaths ?? [])]).map((resolved) => ({
+        ...resolved,
+        projectRelativePath: path.relative(projectPath, resolved.path),
+        conflict: false,
+        ignored: true,
+    }));
+    return {
+        ignored: ignoredSourceComponents.concat(actionableFiles.filter((f) => f.ignored)),
+        toDeploy: getWillDeploy(actionableFiles),
+        toRetrieve: getWillRetrieve(actionableFiles),
+        toDelete: getWillDelete(actionableFiles),
+        conflicts: getNonIgnoredConflicts(actionableFiles),
+    };
+};
+exports.compileResults = compileResults;
+const printDeployTable = (files) => {
+    core_1.CliUx.ux.log();
+    if (files.length === 0) {
+        core_1.CliUx.ux.log((0, chalk_1.dim)(messages.getMessage('deploy.none')));
+    }
+    else {
+        // not using table title property to avoid all the ASCII art
+        core_1.CliUx.ux.log(sf_plugins_core_1.StandardColors.success((0, chalk_1.bold)(messages.getMessage('deploy.header', [files.length]))));
+        core_1.CliUx.ux.table(files, columns);
+    }
+};
+const printRetrieveTable = (files) => {
+    core_1.CliUx.ux.log();
+    if (files.length === 0) {
+        core_1.CliUx.ux.log((0, chalk_1.dim)(messages.getMessage('retrieve.none')));
+    }
+    else {
+        // not using table title property to avoid all the ASCII art
+        core_1.CliUx.ux.log(sf_plugins_core_1.StandardColors.success((0, chalk_1.bold)(messages.getMessage('retrieve.header', [files.length]))));
+        core_1.CliUx.ux.table(files, columns);
+    }
+};
+const printDeleteTable = (files) => {
+    core_1.CliUx.ux.log();
+    if (files.length === 0) {
+        core_1.CliUx.ux.log((0, chalk_1.dim)(messages.getMessage('delete.none')));
+    }
+    else {
+        core_1.CliUx.ux.log(sf_plugins_core_1.StandardColors.warning((0, chalk_1.bold)(messages.getMessage('delete.header', [files.length]))));
+        core_1.CliUx.ux.table(files, columns);
+    }
+};
+const printConflictsTable = (files, baseOperation) => {
+    core_1.CliUx.ux.log();
+    if (files.length === 0) {
+        core_1.CliUx.ux.log((0, chalk_1.dim)(messages.getMessage('conflicts.none')));
+    }
+    else {
+        core_1.CliUx.ux.log(sf_plugins_core_1.StandardColors.error((0, chalk_1.bold)(messages.getMessage('conflicts.header', [files.length, baseOperation]))));
+        core_1.CliUx.ux.table(files, columns, { sort: 'path' });
+    }
+};
+const printIgnoredTable = (files, baseOperation) => {
+    core_1.CliUx.ux.log();
+    if (files.length === 0) {
+        core_1.CliUx.ux.log((0, chalk_1.dim)(messages.getMessage('ignored.none')));
+    }
+    else {
+        core_1.CliUx.ux.log((0, chalk_1.dim)(messages.getMessage('ignored.header', [files.length, baseOperation])));
+        core_1.CliUx.ux.table(files, columns, { sort: 'path' });
+    }
+};
+const printTables = (result, baseOperation) => {
+    printConflictsTable(result.conflicts, baseOperation);
+    printDeleteTable(result.toDelete);
+    if (baseOperation === 'deploy') {
+        printDeployTable(result.toDeploy);
+    }
+    else if (baseOperation === 'retrieve') {
+        printRetrieveTable(result.toRetrieve);
+    }
+    printIgnoredTable(result.ignored, baseOperation);
+};
+exports.printTables = printTables;
+const getConflictFiles = async (stl, ignore = false) => {
+    return !stl || ignore
+        ? new Set()
+        : new Set((await stl.getConflicts()).flatMap((conflict) => conflict.filenames.map((f) => path.resolve(f))));
+};
+exports.getConflictFiles = getConflictFiles;
+//# sourceMappingURL=previewOutput.js.map

package/lib/utils/previewOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewOutput.js","sourceRoot":"","sources":["../../src/utils/previewOutput.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,6BAA6B;AAC7B,sCAAoC;AACpC,iEAA6D;AAC7D,iCAAkC;AAClC,2CAA4C;AAC5C,+EAQ4C;AAC5C,0GAAoH;AAIpH,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,IAAI,CAAC,oCAAoC,EAAE,iBAAiB,EAAE;IACtF,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,eAAe;IACf,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,eAAe;CAChB,CAAC,CAAC;AAwBH,MAAM,kBAAkB,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7F,wCAAwC;AACxC,gCAAgC;AAChC,MAAM,YAAY,GAAG,CAAC,SAAmB,EAA0D,EAAE;IACnG,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,yCAAgB,CAAC,SAAS,EAAE,6CAAoB,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IACvG,MAAM,gBAAgB,GAAG,SAAS;SAC/B,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpB,IAAI;YACF,OAAO,QAAQ,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;SACjD;QAAC,OAAO,CAAC,EAAE;YACV,4DAA4D;YAC5D,OAAO,SAAS,CAAC;SAClB;IACH,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,UAAU,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,qBAAqB;IACrB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,sBAA+C,EAA4B,EAAE;IAC7G,QAAQ,sBAAsB,EAAE;QAC9B,KAAK,+CAAsB,CAAC,IAAI;YAC9B,OAAO,YAAY,CAAC;QACtB,KAAK,+CAAsB,CAAC,GAAG;YAC7B,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,QAAQ,CAAC;KACnB;AACH,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,KAAoB,EAAiB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAEtH,MAAM,MAAM,GAAG,CAAC,WAAwB,EAAW,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;AAEpG,MAAM,aAAa,GAAG,CAAC,KAAoB,EAAiB,EAAE,CAC5D,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;AAE7D,MAAM,eAAe,GAAG,CAAC,KAAoB,EAAiB,EAAE,CAC9D,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC;AAE/D,MAAM,aAAa,GAAG,CAAC,KAAoB,EAAiB,EAAE,CAC5D,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAEtF,sCAAsC;AACtC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;AACpF,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAA4C,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;AAE9G,MAAM,cAAc,GAAG,CAAC,EAC7B,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,GAQd,EAAiB,EAAE;IAClB,wCAAwC;IACxC,mEAAmE;IACnE,MAAM,sBAAsB,GAAG,IAAI,GAAG,CACpC,YAAY,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CACxG,CAAC;IAEF,MAAM,4BAA4B,GAAG,CAAC,CAAkB,EAAkC,EAAE,CAAC,CAAC;QAC5F,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;QACjB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1D,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,qBAAqB;QAC7E,2EAA2E;KAC5E,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,YAAY;SACjC,OAAO,EAAE;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,GAAG,EAAe,EAAE;QACxB,MAAM,0BAA0B,GAAG,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;QACnF,IAAI,KAAK,IAAI,0BAA0B,EAAE;YACvC,yCAAyC;YACzC,OAAO;gBACL,GAAG,4BAA4B,CAAC,0BAA0B,CAAC;gBAC3D,SAAS,EACP,aAAa,KAAK,QAAQ;oBACxB,CAAC,CAAC,wBAAwB,CAAC,0BAA0B,CAAC,yBAAyB,EAAE,CAAC;oBAClF,CAAC,CAAC,aAAa;aACpB,CAAC;SACH;aAAM;YACL,OAAO;gBACL,IAAI,EAAE,0BAA0B,CAAC,IAAI,CAAC,IAAI;gBAC1C,QAAQ,EAAE,0BAA0B,CAAC,QAAQ;gBAC7C,sDAAsD;gBACtD,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE,aAAa;gBACxB,8FAA8F;gBAC9F,OAAO,EAAE,IAAA,kDAA8B,EAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;aACvG,CAAC;SACH;IACH,CAAC,CAAC;QACF,6CAA6C;SAC5C,MAAM,CACL,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CACvB,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC;QACnB,GAAG,4BAA4B,CAAC,CAAC,CAAC;QAClC,SAAS,EAAE,WAAW;KACvB,CAAC,CACH,CACF,CAAC;IAEJ,uEAAuE;IACvE,MAAM,uBAAuB,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAC3F,CAAC,QAAQ,EAAe,EAAE,CAAC,CAAC;QAC1B,GAAG,QAAQ;QACX,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC;QAC9D,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,IAAI;KACd,CAAC,CACH,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,uBAAuB,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjF,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC;QACxC,UAAU,EAAE,eAAe,CAAC,eAAe,CAAC;QAC5C,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC;QACxC,SAAS,EAAE,sBAAsB,CAAC,eAAe,CAAC;KACnD,CAAC;AACJ,CAAC,CAAC;AApFW,QAAA,cAAc,kBAoFzB;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAAoB,EAAQ,EAAE;IACtD,YAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAA,WAAG,EAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;KACvD;SAAM;QACL,4DAA4D;QAC5D,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAc,CAAC,OAAO,CAAC,IAAA,YAAI,EAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,YAAK,CAAC,EAAE,CAAC,KAAK,CAAc,KAAK,EAAE,OAAO,CAAC,CAAC;KAC7C;AACH,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAoB,EAAQ,EAAE;IACxD,YAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAA,WAAG,EAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;KACzD;SAAM;QACL,4DAA4D;QAC5D,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAc,CAAC,OAAO,CAAC,IAAA,YAAI,EAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnG,YAAK,CAAC,EAAE,CAAC,KAAK,CAAc,KAAK,EAAE,OAAO,CAAC,CAAC;KAC7C;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAAoB,EAAQ,EAAE;IACtD,YAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAA,WAAG,EAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;KACvD;SAAM;QACL,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAc,CAAC,OAAO,CAAC,IAAA,YAAI,EAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,YAAK,CAAC,EAAE,CAAC,KAAK,CAAc,KAAK,EAAE,OAAO,CAAC,CAAC;KAC7C;AACH,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,KAAoB,EAAE,aAA4B,EAAQ,EAAE;IACvF,YAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAA,WAAG,EAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;KAC1D;SAAM;QACL,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAc,CAAC,KAAK,CAAC,IAAA,YAAI,EAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjH,YAAK,CAAC,EAAE,CAAC,KAAK,CAAc,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;KAC/D;AACH,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAAoB,EAAE,aAA4B,EAAQ,EAAE;IACrF,YAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAA,WAAG,EAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;KACxD;SAAM;QACL,YAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAA,WAAG,EAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,YAAK,CAAC,EAAE,CAAC,KAAK,CAAc,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;KAC/D;AACH,CAAC,CAAC;AAEK,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAE,aAA4B,EAAQ,EAAE;IACvF,mBAAmB,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACrD,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,aAAa,KAAK,QAAQ,EAAE;QAC9B,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;KACnC;SAAM,IAAI,aAAa,KAAK,UAAU,EAAE;QACvC,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;KACvC;IACD,iBAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC,CAAC;AATW,QAAA,WAAW,eAStB;AAEK,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAoB,EAAE,MAAM,GAAG,KAAK,EAAwB,EAAE;IACnG,OAAO,CAAC,GAAG,IAAI,MAAM;QACnB,CAAC,CAAC,IAAI,GAAG,EAAU;QACnB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChH,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B"}

package/lib/utils/progressBar.js

@@ -20,7 +20,6 @@ class DeployProgress extends sf_plugins_core_1.Progress {
     start() {
         super.start(0, { status: 'Waiting' }, DeployProgress.OPTIONS);
         this.deploy.onUpdate((data) => {
-            var _a;
             // the numCompTot. isn't computed right away, wait to start until we know how many we have
             if (data.numberComponentsTotal) {
                 this.setTotal(data.numberComponentsTotal + data.numberTestsTotal);
@@ -29,7 +28,7 @@ class DeployProgress extends sf_plugins_core_1.Progress {
                 });
             }
             else {
-                this.update(0, { status: (_a = mdTrasferMessages.getMessage(data.status)) !== null && _a !== void 0 ? _a : 'Waiting' });
+                this.update(0, { status: mdTrasferMessages.getMessage(data.status) ?? 'Waiting' });
             }
             // the numTestsTot. isn't computed until validated as tests by the server, update the PB once we know
             if (data.numberTestsTotal && data.numberComponentsTotal) {

package/lib/utils/progressBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"progressBar.js","sourceRoot":"","sources":["../../src/utils/progressBar.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2CAAuE;AAEvE,2CAA4C;AAC5C,iEAAuD;AAEvD,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,iBAAiB,GAAG,eAAQ,CAAC,YAAY,CAAC,oCAAoC,EAAE,mBAAmB,CAAC,CAAC;AAE3G,MAAa,cAAe,SAAQ,0BAAQ;IAS1C,YAA2B,MAAyB,EAAE,WAAW,GAAG,KAAK;QACvE,KAAK,CAAC,CAAC,WAAW,IAAI,cAAG,CAAC,UAAU,CAAC,0BAAmB,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC;QAD5D,WAAM,GAAN,MAAM,CAAmB;IAEpD,CAAC;IAEM,KAAK;QACV,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;;YAC5B,0FAA0F;YAC1F,IAAI,IAAI,CAAC,qBAAqB,EAAE;gBAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC,oBAAoB,EAAE;oBACrE,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;iBAClD,CAAC,CAAC;aACJ;iBAAM;gBACL,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAA,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,mCAAI,SAAS,EAAE,CAAC,CAAC;aACpF;YAED,qGAAqG;YACrG,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,qBAAqB,EAAE;gBACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;aACnE;QACH,CAAC,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5G,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAY,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;;AAzCH,wCA0CC;AAzCgB,sBAAO,GAAG;IACvB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,mDAAmD;IAC3D,eAAe,EAAE,QAAQ;IACzB,iBAAiB,EAAE,QAAQ;IAC3B,QAAQ,EAAE,IAAI;CACf,CAAC"}
+{"version":3,"file":"progressBar.js","sourceRoot":"","sources":["../../src/utils/progressBar.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2CAAuE;AAEvE,2CAA4C;AAC5C,iEAAuD;AAEvD,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,iBAAiB,GAAG,eAAQ,CAAC,YAAY,CAAC,oCAAoC,EAAE,mBAAmB,CAAC,CAAC;AAE3G,MAAa,cAAe,SAAQ,0BAAQ;IAS1C,YAA2B,MAAyB,EAAE,WAAW,GAAG,KAAK;QACvE,KAAK,CAAC,CAAC,WAAW,IAAI,cAAG,CAAC,UAAU,CAAC,0BAAmB,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC;QAD5D,WAAM,GAAN,MAAM,CAAmB;IAEpD,CAAC;IAEM,KAAK;QACV,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5B,0FAA0F;YAC1F,IAAI,IAAI,CAAC,qBAAqB,EAAE;gBAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC,oBAAoB,EAAE;oBACrE,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;iBAClD,CAAC,CAAC;aACJ;iBAAM;gBACL,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;aACpF;YAED,qGAAqG;YACrG,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,qBAAqB,EAAE;gBACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;aACnE;QACH,CAAC,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5G,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAY,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;;AAzCH,wCA0CC;AAzCgB,sBAAO,GAAG;IACvB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,mDAAmD;IAC3D,eAAe,EAAE,QAAQ;IACzB,iBAAiB,EAAE,QAAQ;IAC3B,QAAQ,EAAE,IAAI;CACf,CAAC"}

package/messages/deploy.md

@@ -44,3 +44,39 @@ Initialization Failures. The following table describes each failure:
 # warning.TargetOrgIsExpired
 
 The target-org, "%s", is expired. Do you want to pick another org?
+
+# AnalyzingProject
+
+Analyzing project
+
+# UsingOptionsFromFile
+
+Using options found in %s.
+
+# FoundNothingToDeploy
+
+Found nothing in the project to deploy.
+
+# NothingSelectedToDeploy
+
+Nothing was selected to deploy.
+
+# DeployOptionsSavedToFile
+
+Your deploy options have been saved to %s.
+
+# DeployOptionsIncludedInGitIgnore
+
+We added %s to the .gitignore for you.
+
+# DeployersHaveNonZeroExitCode
+
+One or more of the selected deployers exited with a non-zero exit code.
+
+# DeployerExitCode
+
+Deployer "%s" exited with code %d.
+
+# save.as.default
+
+Save username %s as default?

package/messages/deploy.metadata.md

@@ -156,7 +156,7 @@ Target API version for the deploy.
 
 # flags.api-version.description
 
-Use this flag to override the default API version, which is the latest version supported the CLI, with the API version of your package.xml file.
+Use this flag to override the default API version with the API version of your package.xml file. The default API version is the latest version supported by the CLI.
 
 # flags.async.summary
 
@@ -204,3 +204,11 @@ There are changes in the org that conflict with the local changes you're trying
 - To overwrite the remote changes, rerun this command with the --ignore-conflicts flag.
 
 - To overwrite the local changes, run the "sf retrieve metadata" command with the --ignore-conflicts flag.
+
+# error.nothingToDeploy
+
+No local changes to deploy.
+
+# error.nothingToDeploy.Actions
+
+- To see conflicts and ignored files, run "sf deploy metadata preview" with any of the manifest, directory, or metadata flags.

package/messages/deploy.metadata.preview.md

@@ -0,0 +1,93 @@
+# summary
+
+Preview a deployment to see what will deploy to the org, the potential conflicts, and the ignored files.
+
+# description
+
+You must run this command from within a project.
+
+The command outputs a table that describes what will happen if you run the "sf deploy metadata" command. The table lists the metadata components that will be deployed and deleted. The table also lists the current conflicts between files in your local project and components in the org. Finally, the table lists the files that won't be deployed because they're included in your .forceignore file.
+
+If your org allows source tracking, then this command considers conflicts between the org and local. Some orgs, such as production orgs, never allow source tracking. Use the "--no-track-source" flag when you create a scratch or sandbox org to disable source tracking.
+
+To preview the deployment of multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to --manifest and --source-dir.
+
+# examples
+
+- NOTE: The commands to preview a deployment and actually deploy it use similar flags. We provide a few preview examples here, but see the help for "sf deploy metadata" for more examples that you can adapt for previewing.
+
+- Preview the deployment of source files in a directory, such as force-app:
+
+      <%= config.bin %> <%= command.id %>  --source-dir force-app
+
+- Preview the deployment of all Apex classes:
+
+      <%= config.bin %> <%= command.id %> --metadata ApexClass
+
+- Preview deployment of a specific Apex class:
+
+      <%= config.bin %> <%= command.id %> --metadata ApexClass:MyApexClass
+
+- Preview deployment of all components listed in a manifest:
+
+      <%= config.bin %> <%= command.id %> --manifest path/to/package.xml
+
+# flags.target-org.summary
+
+Login username or alias for the target org.
+
+# flags.target-org.description
+
+Overrides your default org.
+
+# flags.metadata.summary
+
+Metadata component names to preview.
+
+# flags.source-dir.summary
+
+Path to the local source files to preview.
+
+# flags.source-dir.description
+
+The supplied path can be to a single file (in which case the operation is applied to only one file) or to a folder (in which case the operation is applied to all metadata types in the directory and its subdirectories).
+
+If you specify this flag, don’t specify --metadata or --manifest.
+
+# flags.manifest.summary
+
+Full file path for manifest (package.xml) of components to preview.
+
+# flags.manifest.description
+
+All child components are included. If you specify this flag, don’t specify --metadata or --source-dir.
+
+# flags.ignore-conflicts.summary
+
+Ignore conflicts and deploy local files, even if they overwrite changes in the org.
+
+# flags.ignore-conflicts.description
+
+This flag applies only to orgs that allow source tracking. It has no effect on orgs that don't allow it, such as production orgs.
+
+# flags.concise.summary
+
+Omit ignored files.
+
+# flags.api-version.summary
+
+Target API version for the preview.
+
+# flags.api-version.description
+
+Use this flag to override the default API version with the API version of your package.xml file. The default API version is the latest version supported by the CLI.
+
+# error.Conflicts
+
+There are changes in the org that conflict with the local changes you're trying to preview.
+
+# error.Conflicts.Actions
+
+- To overwrite the remote changes, rerun this command with the --ignore-conflicts flag.
+
+- To overwrite the local changes, run the "sf retrieve metadata" command with the --ignore-conflicts flag.

package/messages/deploy.metadata.validate.md

@@ -104,7 +104,7 @@ Target API version for the validation.
 
 # flags.api-version.description
 
-Use this flag to override the default API version, which is the latest version supported the CLI, with the API version in your package.xml file.
+Use this flag to override the default API version with the API version of your package.xml file. The default API version is the latest version supported by the CLI.
 
 # flags.async.summary
 

package/messages/previewMessages.md

@@ -0,0 +1,39 @@
+# conflicts.none
+
+No conflicts found.
+
+# conflicts.header
+
+Conflicts [%s]. Run the command with the --ignore-conflicts flag to override.
+
+# ignored.none
+
+No files were ignored. Update your your .forceignore file if you want to ignore certain files.
+
+# ignored.header
+
+Ignored [%s] files. These files won't %s because they're ignored by your .forceignore file.
+
+# deploy.header
+
+Will Deploy [%s] files.
+
+# deploy.none
+
+No files will be deployed.
+
+# retrieve.header
+
+Will Retrieve [%s] files.
+
+# retrieve.none
+
+No files will be retrieved.
+
+# delete.header
+
+Will Delete [%s] files.
+
+# delete.none
+
+No files will be deleted.

package/messages/retrieve.metadata.preview.md

@@ -0,0 +1,59 @@
+# summary
+
+Preview a retrieval to see what will be retrieved from the org, the potential conflicts, and the ignored files.
+
+# description
+
+You must run this command from within a project.
+
+The command outputs a table that describes what will happen if you run the "sf retrieve metadata" command. The table lists the metadata components that will be retrieved and deleted. The table also lists the current conflicts between files in your local project and components in the org. Finally, the table lists the files that won't be retrieved because they're included in your .forceignore file.
+
+If your org allows source tracking, then this command considers conflicts between the org and local. Some orgs, such as production orgs, never allow source tracking. Use the "--no-track-source" flag when you create a scratch or sandbox org to disable source tracking.
+
+# examples
+
+- Preview the retrieve of all changes from the org:
+
+  <%= config.bin %> <%= command.id %>
+
+- Preview the retrieve when ignoring any conflicts:
+
+  <%= config.bin %> <%= command.id %> --ignore-conflicts
+
+# flags.target-org.summary
+
+Login username or alias for the target org.
+
+# flags.target-org.description
+
+Overrides your default org.
+
+# flags.ignore-conflicts.summary
+
+Ignore conflicts and preview the retrieve of remote components, even if they will overwrite local changes.
+
+# flags.ignore-conflicts.description
+
+This flag applies only to orgs that allow source tracking. It has no effect on orgs that don't allow it, such as production orgs.
+
+# flags.concise.summary
+
+Omit ignored files.
+
+# flags.api-version.summary
+
+Target API version for the deploy.
+
+# flags.api-version.description
+
+Use this flag to override the default API version with the API version of your package.xml file. The default API version is the latest version supported by the CLI.
+
+# error.Conflicts
+
+There are local changes that conflict with the remote changes that would be retrieved.
+
+# error.Conflicts.Actions
+
+- To overwrite the remote changes, run the "sf deploy metadata" command with the --ignore-conflicts flag.
+
+- To overwrite the local changes, run the "sf retrieve metadata" command with the --ignore-conflicts flag.