@salesforce/plugin-auth 2.5.1 → 2.6.0

package/lib/commands/org/logout.js

@@ -0,0 +1,188 @@
+"use strict";
+/*
+ * Copyright (c) 2020, 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 os = require("os");
+const core_1 = require("@salesforce/core");
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const inquirer_1 = require("inquirer");
+const chalk = require("chalk");
+const authBaseCommand_1 = require("../../authBaseCommand");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-auth', 'logout');
+const commonMessages = core_1.Messages.loadMessages('@salesforce/plugin-auth', 'messages');
+class Logout extends authBaseCommand_1.AuthBaseCommand {
+    static buildChoices(orgAuths, all) {
+        const maxUsernameLength = Math.max('Username'.length, ...orgAuths.map((orgAuth) => orgAuth.username.length));
+        const maxAliasLength = Math.max('Aliases'.length, ...orgAuths.map((orgAuth) => (orgAuth.aliases ? orgAuth.aliases.join(',') : '').length));
+        const maxConfigLength = Math.max('Configs'.length, ...orgAuths.map((orgAuth) => (orgAuth.configs ? orgAuth.configs.join(',') : '').length));
+        const maxTypeLength = Math.max('Type'.length, ...orgAuths.map((orgAuth) => {
+            if (orgAuth.isScratchOrg) {
+                return 'Scratch'.length;
+            }
+            if (orgAuth.isDevHub) {
+                return 'DevHub'.length;
+            }
+            if (orgAuth.isSandbox) {
+                return 'Sandbox'.length;
+            }
+            return 0;
+        }));
+        const choices = orgAuths
+            .map((orgAuth) => {
+            const aliasString = (orgAuth.aliases ? orgAuth.aliases.join(',') : '').padEnd(maxAliasLength, ' ');
+            const configString = (orgAuth.configs ? orgAuth.configs.join(',') : '').padEnd(maxConfigLength, ' ');
+            const typeString = chalk.dim((orgAuth.isScratchOrg ? 'Scratch' : orgAuth.isDevHub ? 'DevHub' : orgAuth.isSandbox ? 'Sandbox' : '').padEnd(maxTypeLength, ' '));
+            // username - aliases - configs
+            const key = `${chalk.bold(orgAuth.username.padEnd(maxUsernameLength))} | ${typeString} | ${aliasString} | ${chalk.yellowBright(configString)}`;
+            return { name: key, value: orgAuth, checked: all, short: `${os.EOL}${orgAuth.username}` };
+        })
+            .sort((a, b) => a.value.username.localeCompare(b.value.username));
+        const userHeader = `${'Username'.padEnd(maxUsernameLength, ' ')}`;
+        const aliasHeader = `${'Aliases'.padEnd(maxAliasLength, ' ')}`;
+        const configHeader = `${'Configs'.padEnd(maxConfigLength, ' ')}`;
+        const typeHeader = `${'Type'.padEnd(maxTypeLength, ' ')}`;
+        return [new inquirer_1.Separator(`  ${userHeader} | ${typeHeader} | ${aliasHeader} | ${configHeader}`), ...choices];
+    }
+    async run() {
+        const { flags } = await this.parse(Logout);
+        this.flags = flags;
+        this.configAggregator = await core_1.ConfigAggregator.create();
+        const remover = await core_1.AuthRemover.create();
+        let orgAuths = [];
+        const targetUsername = this.flags['target-org'] ?? this.configAggregator.getInfo(core_1.OrgConfigProperties.TARGET_ORG).value;
+        // if no-prompt, there must be a resolved target-org or --all
+        if (flags['no-prompt'] && !targetUsername && !flags.all) {
+            throw messages.createError('noOrgSpecifiedWithNoPrompt');
+        }
+        if (this.jsonEnabled() && !targetUsername && !flags.all) {
+            throw messages.createError('noOrgSpecifiedWithJson');
+        }
+        if (this.shouldFindAllAuths(targetUsername)) {
+            orgAuths = await core_1.AuthInfo.listAllAuthorizations();
+        }
+        else if (targetUsername) {
+            orgAuths = await core_1.AuthInfo.listAllAuthorizations((orgAuth) => orgAuth.username === targetUsername || !!orgAuth.aliases?.includes(targetUsername));
+        }
+        else {
+            // just for clarity
+            orgAuths = [];
+        }
+        if (orgAuths.length === 0) {
+            if (this.flags['target-org']) {
+                // user specified a target org but it was not resolved, issue success message and return
+                this.logSuccess(messages.getMessage('logoutOrgCommandSuccess', [this.flags['target-org']]));
+                return [this.flags['target-org']];
+            }
+            this.info(messages.getMessage('noOrgsFound'));
+            return [];
+        }
+        const { orgs, confirmed } = await this.promptForOrgsToRemove(orgAuths, flags.all);
+        if (confirmed) {
+            for (const org of orgs) {
+                // run sequentially to avoid configFile concurrency issues
+                // eslint-disable-next-line no-await-in-loop
+                await remover.removeAuth(org.username);
+            }
+            const loggedOutUsernames = orgs.map((org) => org.username);
+            this.logSuccess(messages.getMessage('logoutOrgCommandSuccess', [loggedOutUsernames.join(os.EOL)]));
+            return loggedOutUsernames;
+        }
+        else {
+            this.info(messages.getMessage('noOrgsSelected'));
+            return [];
+        }
+    }
+    shouldFindAllAuths(targetUsername) {
+        if (targetUsername && !this.flags.all) {
+            return false;
+        }
+        return this.flags.all || core_1.Global.getEnvironmentMode() === core_1.Mode.DEMO || !this.flags['no-prompt'];
+    }
+    async promptForOrgsToRemove(orgAuths, all) {
+        if (this.flags['no-prompt'] || this.jsonEnabled()) {
+            return { orgs: orgAuths, confirmed: true };
+        }
+        if (orgAuths.length === 1) {
+            if (orgAuths[0].isScratchOrg) {
+                this.warn(messages.getMessage('warning'));
+            }
+            if (await this.confirm(messages.getMessage('prompt.confirm.single', [orgAuths[0].username]), 30000, false)) {
+                return { orgs: orgAuths, confirmed: true };
+            }
+            else {
+                return { orgs: [], confirmed: false };
+            }
+        }
+        // pick the orgs to delete - if this.flags.all - set each org to selected
+        // otherwise prompt the user to select the orgs to delete
+        const choices = Logout.buildChoices(orgAuths, all);
+        const { orgs, confirmed } = await this.timedPrompt([
+            {
+                name: 'orgs',
+                message: messages.getMessage('prompt.select-envs'),
+                type: 'checkbox',
+                choices,
+                loop: true,
+            },
+            {
+                name: 'confirmed',
+                when: (answers) => answers.orgs.length > 0,
+                message: (answers) => {
+                    const hasScratchOrgs = answers.orgs.some((org) => org.isScratchOrg);
+                    if (hasScratchOrgs) {
+                        this.warn(messages.getMessage('warning'));
+                    }
+                    const names = answers.orgs.map((org) => org.username);
+                    if (names.length === orgAuths.length) {
+                        return messages.getMessage('prompt.confirm-all');
+                    }
+                    else {
+                        return messages.getMessage('prompt.confirm', [names.length, names.length > 1 ? 's' : '']);
+                    }
+                },
+                type: 'confirm',
+                default: false,
+            },
+        ], 30000);
+        return {
+            orgs: orgs.map((a) => a),
+            confirmed,
+        };
+    }
+}
+exports.default = Logout;
+Logout.summary = messages.getMessage('summary');
+Logout.description = messages.getMessage('description');
+Logout.examples = messages.getMessages('examples');
+Logout.deprecateAliases = true;
+Logout.aliases = ['force:auth:logout', 'auth:logout'];
+Logout.flags = {
+    'target-org': sf_plugins_core_1.Flags.string({
+        summary: messages.getMessage('flags.target-org.summary'),
+        char: 'o',
+        aliases: ['targetusername', 'u'],
+        deprecateAliases: true,
+    }),
+    all: sf_plugins_core_1.Flags.boolean({
+        char: 'a',
+        summary: messages.getMessage('flags.all.summary'),
+        description: messages.getMessage('flags.all.description'),
+        required: false,
+        default: false,
+        exclusive: ['target-org'],
+    }),
+    'no-prompt': sf_plugins_core_1.Flags.boolean({
+        char: 'p',
+        summary: commonMessages.getMessage('flags.no-prompt.summary'),
+        required: false,
+        deprecateAliases: true,
+        aliases: ['noprompt'],
+    }),
+    loglevel: sf_plugins_core_1.loglevel,
+};
+//# sourceMappingURL=logout.js.map

package/lib/commands/org/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../../src/commands/org/logout.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,yBAAyB;AACzB,2CAS0B;AAC1B,iEAA8D;AAE9D,uCAAqC;AACrC,+BAA+B;AAC/B,2DAAwD;AAExD,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;AAC5E,MAAM,cAAc,GAAG,eAAQ,CAAC,YAAY,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC;AAKpF,MAAqB,MAAO,SAAQ,iCAAkC;IAmC5D,MAAM,CAAC,YAAY,CAAC,QAA4B,EAAE,GAAY;QACpE,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7G,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC7B,SAAS,CAAC,MAAM,EAChB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CACxF,CAAC;QACF,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAC9B,SAAS,CAAC,MAAM,EAChB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CACxF,CAAC;QACF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,MAAM,CAAC,MAAM,EACb,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAC1B,IAAI,OAAO,CAAC,YAAY,EAAE;gBACxB,OAAO,SAAS,CAAC,MAAM,CAAC;aACzB;YACD,IAAI,OAAO,CAAC,QAAQ,EAAE;gBACpB,OAAO,QAAQ,CAAC,MAAM,CAAC;aACxB;YACD,IAAI,OAAO,CAAC,SAAS,EAAE;gBACrB,OAAO,SAAS,CAAC,MAAM,CAAC;aACzB;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CACH,CAAC;QACF,MAAM,OAAO,GAAG,QAAQ;aACrB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACf,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;YACnG,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;YACrG,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAC1B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAC1G,aAAa,EACb,GAAG,CACJ,CACF,CAAC;YACF,+BAA+B;YAC/B,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,CACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAC3C,MAAM,UAAU,MAAM,WAAW,MAAM,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3E,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC5F,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,iBAAiB,EAAE,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,WAAW,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,YAAY,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,IAAI,oBAAS,CAAC,KAAK,UAAU,MAAM,UAAU,MAAM,WAAW,MAAM,YAAY,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC;IAC3G,CAAC;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,gBAAgB,GAAG,MAAM,uBAAgB,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,kBAAW,CAAC,MAAM,EAAE,CAAC;QAC3C,IAAI,QAAQ,GAAuB,EAAE,CAAC;QACtC,MAAM,cAAc,GAClB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAK,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,0BAAmB,CAAC,UAAU,CAAC,CAAC,KAAgB,CAAC;QAE9G,6DAA6D;QAC7D,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACvD,MAAM,QAAQ,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;SAC1D;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACvD,MAAM,QAAQ,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;SACtD;QAED,IAAI,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,EAAE;YAC3C,QAAQ,GAAG,MAAM,eAAQ,CAAC,qBAAqB,EAAE,CAAC;SACnD;aAAM,IAAI,cAAc,EAAE;YACzB,QAAQ,GAAG,MAAM,eAAQ,CAAC,qBAAqB,CAC7C,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,cAAc,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,CAChG,CAAC;SACH;aAAM;YACL,mBAAmB;YACnB,QAAQ,GAAG,EAAE,CAAC;SACf;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;YACzB,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE;gBAC5B,wFAAwF;gBACxF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5F,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;aACnC;YACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;SACX;QAED,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAElF,IAAI,SAAS,EAAE;YACb,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;gBACtB,0DAA0D;gBAC1D,4CAA4C;gBAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;aACxC;YACD,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC3D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACnG,OAAO,kBAAkB,CAAC;SAC3B;aAAM;YACL,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACjD,OAAO,EAAE,CAAC;SACX;IACH,CAAC;IAEO,kBAAkB,CAAC,cAAkC;QAC3D,IAAI,cAAc,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACrC,OAAO,KAAK,CAAC;SACd;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,aAAM,CAAC,kBAAkB,EAAE,KAAK,WAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACjG,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,QAA4B,EAC5B,GAAY;QAEZ,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE;YACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SAC5C;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;YACzB,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE;gBAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;aAC3C;YACD,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAM,EAAE,KAAK,CAAC,EAAE;gBAC3G,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;aAC5C;iBAAM;gBACL,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;aACvC;SACF;QAED,yEAAyE;QACzE,yDAAyD;QACzD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAChD;YACE;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;gBAClD,IAAI,EAAE,UAAU;gBAChB,OAAO;gBACP,IAAI,EAAE,IAAI;aACX;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,CAAC,OAAO,EAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBACnD,OAAO,EAAE,CAAC,OAAO,EAAU,EAAE;oBAC3B,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;oBACpE,IAAI,cAAc,EAAE;wBAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;qBAC3C;oBACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACtD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE;wBACpC,OAAO,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;qBAClD;yBAAM;wBACL,OAAO,QAAQ,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;qBAC3F;gBACH,CAAC;gBACD,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;aACf;SACF,EACD,KAAM,CACP,CAAC;QACF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACxB,SAAS;SACV,CAAC;IACJ,CAAC;;AA3MH,yBA4MC;AA3MwB,cAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,kBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,eAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAE5C,uBAAgB,GAAG,IAAI,CAAC;AACjC,cAAO,GAAG,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAEtC,YAAK,GAAG;IAC7B,YAAY,EAAE,uBAAK,CAAC,MAAM,CAAC;QACzB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;QACxD,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC;QAChC,gBAAgB,EAAE,IAAI;KACvB,CAAC;IACF,GAAG,EAAE,uBAAK,CAAC,OAAO,CAAC;QACjB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC;QACjD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;QACzD,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,CAAC,YAAY,CAAC;KAC1B,CAAC;IACF,WAAW,EAAE,uBAAK,CAAC,OAAO,CAAC;QACzB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,yBAAyB,CAAC;QAC7D,QAAQ,EAAE,KAAK;QACf,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE,CAAC,UAAU,CAAC;KACtB,CAAC;IACF,QAAQ,EAAR,0BAAQ;CACT,CAAC"}

package/messages/accesstoken.store.md

@@ -1,20 +1,22 @@
 # summary
 
-authorize an org using an existing Salesforce access token
+Authorize an org using an existing Salesforce access token.
 
 # description
 
-authorize an org using an existing Salesforce access token
 By default, the command runs interactively and asks you for the access token. If you previously authorized the org, the command prompts whether you want to overwrite the local file. Specify --no-prompt to not be prompted.
+
 To use the command in a CI/CD script, set the SFDX_ACCESS_TOKEN environment variable to the access token. Then run the command with the --no-prompt parameter.
 
 # examples
 
-- $ <%= config.bin %> <%= command.id %> --instance-url https://mycompany.my.salesforce.com
+- Authorize an org on https://mycompany.my.salesforce.com; the command prompts you for the access token:
+
+  <%= config.bin %> <%= command.id %> --instance-url https://mycompany.my.salesforce.com
 
-- $ export SFDX_ACCESS_TOKEN=00Dxx0000000000!xxxxx
+- Authorize the org without being prompted; you must have previously set the SFDX_ACCESS_TOKEN environment variable to the access token:
 
-- $ <%= config.bin %> <%= command.id %> --instance-url https://dev-hub.my.salesforce.com --no-prompt
+  <%= config.bin %> <%= command.id %> --instance-url https://dev-hub.my.salesforce.com --no-prompt
 
 # invalidAccessTokenFormat
 

package/messages/device.login.md

@@ -1,19 +1,26 @@
 # summary
 
-authorize an org using a device code
+Authorize an org using a device code.
 
 # description
 
-authorize an org using a device code
-You must open a browser, navigate to the verification URL, and enter the code. Log in, if not already logged in, and you’ll be prompted to allow the device to connect to the org.
+Use this command to allow a device to connect to an org.
+
+When you run this command, it first displays an 8-digit device code and the URL for verifying the code on your org. The default instance URL is https://login.salesforce.com, so if the org you're authorizing is on a different instance, use the --instance-url. The command waits while you complete the verification. Open a browser and navigate to the displayed verification URL, enter the code, then click Connect. If you aren't already logged into your org, log in, and then you're prompted to allow the device to connect to the org. After you successfully authorize the org, you can close the browser window.
 
 # examples
 
-- $ <%= config.bin %> <%= command.id %> -d -a TestOrg1
+- Authorize an org using a device code, give the org the alias TestOrg1, and set it as your default Dev Hub org:
+
+  <%= config.bin %> <%= command.id %> --set-default-dev-hub --alias TestOrg1
+
+- Authorize an org in which you've created a custom connected app with the specified client ID (consumer key):
+
+  <%= config.bin %> <%= command.id %> --client-id <OAuth client id>
 
-- $ <%= config.bin %> <%= command.id %> -i <OAuth client id>
+- Authorize a sandbox org with the specified instance URL:
 
-- $ <%= config.bin %> <%= command.id %> -r https://MyDomainName--SandboxName.sandbox.my.salesforce.com
+  <%= config.bin %> <%= command.id %> --instance-url https://MyDomainName--SandboxName.sandbox.my.salesforce.com
 
 # actionRequired
 
@@ -21,7 +28,7 @@ Action Required!
 
 # enterCode
 
-Enter %s user code in the verification URL %s
+Enter %s device code in this verification URL: %s
 
 # success
 

package/messages/jwt.grant.md

@@ -1,28 +1,48 @@
 # summary
 
-authorize an org using the JWT flow
+Log in to a Salesforce org using a JSON web token (JWT).
 
 # description
 
-authorize an org using the JWT flow
-Use a certificate associated with your private key that has been uploaded to a personal connected app.
-If you specify an --instanc-eurl value, this value overrides the sfdcLoginUrl value in your sfdx-project.json file. To specify a My Domain URL, use the format MyDomainName.my.salesforce.com (not MyDomainName.lightning.force.com). To specify a sandbox, set --instance-url to https://MyDomainName--SandboxName.sandbox.my.salesforce.com.
+Use this command in automated environments where you can’t interactively log in with a browser, such as in CI/CD scripts.
+
+Logging into an org authorizes the CLI to run other commands that connect to that org, such as deploying or retrieving a project. You can log into many types of orgs, such as sandboxes, Dev Hubs, Env Hubs, production orgs, and scratch orgs.
+
+Complete these steps before you run this command:
+
+    1. Create a digital certificate (also called digital signature) and the private key to sign the certificate. You can use your own key and certificate issued by a certification authority. Or use OpenSSL to create a key and a self-signed digital certificate.
+    2. Store the private key in a file on your computer. When you run this command, you set the --jwt-key-file flag to this file.
+    3. Create a custom connected app in your org using the digital certificate. Make note of the consumer key (also called client id) that’s generated for you. Be sure the username of the user logging in is approved to use the connected app. When you run this command, you set the --client-id flag to the consumer key.
+
+See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_auth_jwt_flow.htm for more information.
+
+We recommend that you set an alias when you log into an org. Aliases make it easy to later reference this org when running commands that require it. If you don’t set an alias, you use the username that you specified when you logged in to the org. If you run multiple commands that reference the same org, consider setting the org as your default. Use --set-default for your default scratch org or sandbox, or --set-default-dev-hub for your default Dev Hub.
 
 # examples
 
-- $ <%= config.bin %> <%= command.id %> -o me@my.org -f <path to jwt key file> -i <OAuth client id>
+- Log into an org with username jdoe@example.org and on the default instance URL (https://login.salesforce.org). The private key is stored in the file /Users/jdoe/JWT/server.key and the command uses the connected app with consumer key (client id) 04580y4051234051.
+
+  <%= config.bin %> <%= command.id %> --username jdoe@example.org --jwt-key-file /Users/jdoe/JWT/server.key --client-id 04580y4051234051
+
+- Set the org as the default and give it an alias:
+
+  <%= config.bin %> <%= command.id %> --username jdoe@example.org --jwt-key-file /Users/jdoe/JWT/server.key --client-id 04580y4051234051 --alias ci-org --set-default
+
+- Set the org as the default Dev Hub and give it an alias:
+
+  <%= config.bin %> <%= command.id %> --username jdoe@example.org --jwt-key-file /Users/jdoe/JWT/server.key --client-id 04580y4051234051 --alias ci-dev-hub --set-default-dev-hub
 
-- $ <%= config.bin %> <%= command.id %> -o me@my.org -f <path to jwt key file> -i <OAuth client id> -s -a MyDefaultOrg
+- Log in to a sandbox using URL https://MyDomainName--SandboxName.sandbox.my.salesforce.com:
 
-- $ <%= config.bin %> <%= command.id %> -o me@acme.org -f <path to jwt key file> -i <OAuth client id> -r https://acme.my.salesforce.com
+  <%= config.bin %> <%= command.id %> --username jdoe@example.org --jwt-key-file /Users/jdoe/JWT/server.key --client-id 04580y4051234051 --alias ci-org --set-default --instance-url https://MyDomainName--SandboxName.sandbox.my.salesforce.com
 
-# username
+# flags.username.summary
 
-authentication username
+Username of the user logging in.
 
-# key
+# flags.jwt-key-file.summary
 
-path to a file containing the private key
+Path to a file containing the private key.
 
 # JwtGrantError
 

package/messages/list.md

@@ -1,15 +1,17 @@
 # summary
 
-List auth connection information
+List authorization information about the orgs you created or logged into.
 
 # description
 
-list auth connection information
+This command uses local authorization information that Salesforce CLI caches when you create a scratch org or log into an org. The command doesn't actually connect to the orgs to verify that they're still active. As a result, this command executes very quickly. If you want to view live information about your authorized orgs, such as their connection status, use the "org list" command.
 
 # examples
 
-- $ <%= config.bin %> <%= command.id %>
+- List local authorization information about your orgs:
+
+  <%= config.bin %> <%= command.id %>
 
 # noResultsFound
 
-No results found
+No results found.

package/messages/logout.md

@@ -1,45 +1,81 @@
 # summary
 
-log out from authorized orgs
+Log out of a Salesforce org.
 
 # description
 
-log out from authorized orgs
-By default, this command logs you out from your default scratch org.
+If you run this command with no flags, it first displays a list of orgs you've created or logged into, with none of the orgs selected. Use the arrow keys to scroll through the list and the space bar to select the orgs you want to log out of. Press Enter when you're done; the command asks for a final confirmation before logging out of the selected orgs.
+
+The process is similar if you specify --all, except that in the initial list of orgs, they're all selected. Use --target-org to logout of a specific org. In both these cases by default, you must still confirm that you want to log out. Use --no-prompt to never be asked for confirmation when also using --all or --target-org.
+
+Be careful! If you log out of a scratch org without having access to its password, you can't access the scratch org again, either through the CLI or the Salesforce UI.
 
 # examples
 
-- $ <%= config.bin %> <%= command.id %> -o me@my.org
+- Interactively select the orgs to log out of:
 
-- $ <%= config.bin %> <%= command.id %> -a
+  <%= config.bin %> <%= command.id %>
 
-- $ <%= config.bin %> <%= command.id %> -p
+- Log out of the org with username me@my.org:
 
-# flags.target-org.summary
+  <%= config.bin %> <%= command.id %> --target-org me@my.org
 
-Username or alias of the target org.
+- Log out of all orgs after confirmation:
+
+  <%= config.bin %> <%= command.id %> --all
 
-# all
+- Logout of the org with alias my-scratch and don't prompt for confirmation:
 
-include all authenticated orgs
+  <%= config.bin %> <%= command.id %> --target-org my-scratch --no-prompt
 
-# allLong
+# flags.target-org.summary
 
-Includes all authenticated orgs: for example, Dev Hubs, sandboxes, DE orgs, and expired, deleted, and unknown-status scratch orgs.
+Username or alias of the target org.
 
-# logoutCommandYesNo
+# flags.all.summary
 
-Are you sure you want to log out from these org(s)?
-%s
+Include all authenticated orgs.
 
-Important: You need a password to reauthorize scratch orgs. By default, scratch orgs have no password. If you still need your scratch orgs, run "%s org:generate:password" before logging out. If you don't need the scratch orgs anymore, run "%s org:delete:scratch" or "%s org:delete:sandbox"instead of logging out.
+# flags.all.description
 
-Log out?
+All orgs includes Dev Hubs, sandboxes, DE orgs, and expired, deleted, and unknown-status scratch orgs.
 
 # logoutOrgCommandSuccess
 
 Successfully logged out of orgs: %s
 
-# logoutOrgCommandNoOrgsFound
+# noOrgsFound
 
 No orgs found to log out of.
+
+# noOrgsSelected
+
+No orgs selected for logout.
+
+# prompt.select-envs
+
+Select the orgs you want to log out of:
+
+# prompt.confirm
+
+Are you sure you want to log out of %d org%s?
+
+# prompt.confirm-all
+
+Are you sure you want to log out of all your orgs?
+
+# prompt.confirm.single
+
+Are you sure you want to log out of %s?
+
+# warning
+
+Warning: If you log out of a scratch org without having access to its password, you can't access this org again, either through the CLI or the Salesforce UI.
+
+# noOrgSpecifiedWithNoPrompt
+
+You must specify a target-org (or default target-org config is set) or use --all flag when using the --no-prompt flag.
+
+# noOrgSpecifiedWithJson
+
+You must specify a target-org (or default target-org config is set) or use --all flag when using the --json flag.

package/messages/messages.md

@@ -1,22 +1,30 @@
-# clientId
+# flags.client-id.summary
 
-OAuth client ID (sometimes called the consumer key)
+OAuth client ID (also called consumer key) of your custom connected app.
 
-# setDefaultDevHub
+# flags.set-default-dev-hub.summary
 
-set the authenticated org as the default dev hub org for scratch org creation
+Set the authenticated org as the default Dev Hub.
 
-# setDefaultUsername
+# flags.set-default.summary
 
-set the authenticated org as the default username that all commands run against
+Set the authenticated org as the default that all org-related commands run against.
 
-# setAlias
+# flags.alias.summary
 
-set an alias for the authenticated org
+Alias for the org.
 
-# instanceUrl
+# flags.instance-url.summary
 
-the login URL of the instance the org lives on
+URL of the instance that the org lives on.
+
+# flags.instance-url.description
+
+If you specify an --instance-url value, this value overrides the sfdcLoginUrl value in your sfdx-project.json file.
+
+To specify a My Domain URL, use the format https://yourcompanyname.my.salesforce.com.
+
+To specify a sandbox, set --instance-url to https://MyDomainName--SandboxName.sandbox.my.salesforce.com.
 
 # authorizeCommandSuccess
 
@@ -24,17 +32,17 @@ Successfully authorized %s with org ID %s
 
 # warnAuth
 
-Logging in to a business or production org is not recommended on a demo or shared machine. Please run "%s auth:logout --target-org <your username> --no-prompt" when finished using this org, which is similar to logging out of the org in the browser.
+Logging in to a business or production org is not recommended on a demo or shared machine. Please run "%s org:logout --target-org <your username> --no-prompt" when finished using this org, which is similar to logging out of the org in the browser.
 
 Do you want to authorize this org for use with the Salesforce CLI?
 
-# noPromptAuth
+# flags.no-prompt.summary
 
-do not prompt for auth confirmation in demo mode
+Don't prompt for confirmation.
 
-# disableMasking
+# flags.disable-masking.summary
 
-disable masking of user input (for use with problematic terminals)
+Disable masking of user input; use with problematic terminals.
 
 # clientSecretStdin
 

package/messages/sfdxurl.store.md

@@ -1,27 +1,33 @@
 # summary
 
-authorize an org using an SFDX auth URL stored within a file
+Authorize an org using a Salesforce DX authorization URL stored in a file.
 
 # description
 
-authorize an org using an SFDX auth URL stored within a file
-The SFDX auth URL must have the format "%s". NOTE: The SFDX auth URL uses the "force" protocol, and not "http" or "https". Also, the "instanceUrl" inside the SFDX auth URL doesn't include the protocol ("https://").
+The Salesforce DX (SFDX) authorization URL must have the format "%s". NOTE: The SFDX authorization URL uses the "force" protocol, and not "http" or "https". Also, the "instanceUrl" inside the SFDX authorization URL doesn't include the protocol ("https://").
 
-You have three options when creating the auth file. The easiest option is to redirect the output of the `<%= config.bin %> org:display --verbose --json` command into a file. For example, using an org you have already authorized:
+You have three options when creating the authorization file. The easiest option is to redirect the output of the "<%= config.bin %> org display --verbose --json" command into a file. For example, using an org with alias my-org that you've already authorized:
 
-    $ <%= config.bin %> org:display -o <OrgUsername> --verbose --json > authFile.json
-    $ <%= config.bin %> <%= command.id %> -f authFile.json
+    $ <%= config.bin %> org display --target-org my-org --verbose --json > authFile.json
 
-The resulting JSON file contains the URL in the sfdxAuthUrl property inside of a results object. NOTE: The `org:display --verbose` command displays the refresh token only for orgs authorized with the web server flow, and not the JWT bearer flow.
+The resulting JSON file contains the URL in the "sfdxAuthUrl" property of the "result" object. You can then reference the file when running this command:
 
-You can also create a JSON file that has a top-level property named sfdxAuthUrl whose value is the auth URL. Finally, you can create a normal text file that includes just the URL and nothing else.
+    $ <%= config.bin %> <%= command.id %> --sfdx-url-file authFile.json
 
-# file
+NOTE: The "<%= config.bin %> org display --verbose" command displays the refresh token only for orgs authorized with the web server flow, and not the JWT bearer flow.
 
-path to a file containing the sfdx url
+You can also create a JSON file that has a top-level property named sfdxAuthUrl whose value is the authorization URL. Finally, you can create a normal text file that includes just the URL and nothing else.
+
+# flags.sfdx-url-file.summary
+
+Path to a file that contains the Salesforce DX authorization URL.
 
 # examples
 
-- $ <%= config.bin %> <%= command.id %> -f <path to sfdxAuthUrl file>
+- Authorize an org using the SFDX authorization URL in the files/authFile.json file:
+
+  <%= config.bin %> <%= command.id %> --sfdx-url-file files/authFile.json
+
+- Similar to previous example, but set the org as your default and give it an alias MyDefaultOrg:
 
-- $ <%= config.bin %> <%= command.id %> -f <path to sfdxAuthUrl file> -s -a MyDefaultOrg
+  <%= config.bin %> <%= command.id %> --sfdx-url-file files/authFile.json --set-default --alias MyDefaultOrg