@salesforce/plugin-org 2.2.24 → 2.3.0

package/lib/shared/timeUtils.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSecondsToHuman = exports.getTimeComponentsFromSeconds = exports.getClockForSeconds = 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 kit_1 = require("@salesforce/kit");
+const getClockForSeconds = (timeInSec) => {
+    const tc = (0, exports.getTimeComponentsFromSeconds)(timeInSec);
+    const dDisplay = tc.days.days > 0 ? `${tc.days.days.toString()}:` : '';
+    const hDisplay = tc.hours.hours.toString().padStart(2, '0');
+    const mDisplay = tc.minutes.minutes.toString().padStart(2, '0');
+    const sDisplay = tc.seconds.seconds.toString().padStart(2, '0');
+    return `${dDisplay}${hDisplay}:${mDisplay}:${sDisplay}`;
+};
+exports.getClockForSeconds = getClockForSeconds;
+const getTimeComponentsFromSeconds = (timeInSec) => {
+    const days = kit_1.Duration.days(Math.floor(timeInSec / 86400));
+    const hours = kit_1.Duration.hours(Math.floor((timeInSec % 86400) / 3600));
+    const minutes = kit_1.Duration.minutes(Math.floor((timeInSec % 3600) / 60));
+    const seconds = kit_1.Duration.seconds(Math.floor(timeInSec % 60));
+    return { days, hours, minutes, seconds };
+};
+exports.getTimeComponentsFromSeconds = getTimeComponentsFromSeconds;
+const getSecondsToHuman = (timeInSec) => {
+    const tc = (0, exports.getTimeComponentsFromSeconds)(timeInSec);
+    const dDisplay = tc.days.days > 0 ? tc.days.toString() + ' ' : '';
+    const hDisplay = tc.hours.hours > 0 ? tc.hours.toString() + ' ' : '';
+    const mDisplay = tc.minutes.minutes > 0 ? tc.minutes.toString() + ' ' : '';
+    const sDisplay = tc.seconds.seconds > 0 ? tc.seconds.toString() : '';
+    return (dDisplay + hDisplay + mDisplay + sDisplay).trim();
+};
+exports.getSecondsToHuman = getSecondsToHuman;
+//# sourceMappingURL=timeUtils.js.map

package/lib/shared/timeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeUtils.js","sourceRoot":"","sources":["../../src/shared/timeUtils.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,yCAA2C;AASpC,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAU,EAAE;IAC9D,MAAM,EAAE,GAAG,IAAA,oCAA4B,EAAC,SAAS,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAW,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,MAAM,QAAQ,GAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAW,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAW,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAExE,OAAO,GAAG,QAAQ,GAAG,QAAQ,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAC1D,CAAC,CAAC;AATW,QAAA,kBAAkB,sBAS7B;AACK,MAAM,4BAA4B,GAAG,CAAC,SAAiB,EAAkB,EAAE;IAChF,MAAM,IAAI,GAAG,cAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,KAAM,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,cAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAM,CAAC,GAAG,IAAK,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,cAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,IAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,cAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC;IAE7D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC,CAAC;AAPW,QAAA,4BAA4B,gCAOvC;AACK,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAU,EAAE;IAC7D,MAAM,EAAE,GAAG,IAAA,oCAA4B,EAAC,SAAS,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAW,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAW,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,QAAQ,GAAW,EAAE,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,QAAQ,GAAW,EAAE,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7E,OAAO,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC,CAAC;AATW,QAAA,iBAAiB,qBAS5B"}

package/lib/shared/utils.d.ts

@@ -1,5 +1,5 @@
 import { ChildProcess } from 'child_process';
 import * as open from 'open';
-export declare const getAliasByUsername: (username: string) => Promise<string>;
+export declare const getAliasByUsername: (username: string) => Promise<string | undefined>;
 export declare const openUrl: (url: string, options: open.Options) => Promise<ChildProcess>;
 export declare const lowerToUpper: (object: Record<string, unknown>) => Record<string, unknown>;

package/lib/shared/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":";;;AAOA,yCAA6C;AAC7C,2CAAmD;AACnD,6BAA6B;AAEtB,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;IAC5E,MAAM,eAAe,GAAG,MAAM,sBAAe,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtD,sDAAsD;IACtD,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC,CAAC;AALW,QAAA,kBAAkB,sBAK7B;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAAE,OAAqB,EAAyB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAAlG,QAAA,OAAO,WAA2F;AAExG,MAAM,YAAY,GAAG,CAAC,MAA+B,EAA2B,EAAE;AACvF,2GAA2G;AAC3G,qGAAqG;AACrG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAA,gBAAU,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAHhF,QAAA,YAAY,gBAGoE"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":";;;AAOA,yCAA6C;AAC7C,2CAAmD;AACnD,6BAA6B;AAEtB,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAgB,EAA+B,EAAE;IACxF,MAAM,eAAe,GAAG,MAAM,sBAAe,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtD,sDAAsD;IACtD,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC,CAAC;AALW,QAAA,kBAAkB,sBAK7B;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAAE,OAAqB,EAAyB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAAlG,QAAA,OAAO,WAA2F;AAExG,MAAM,YAAY,GAAG,CAAC,MAA+B,EAA2B,EAAE;AACvF,2GAA2G;AAC3G,qGAAqG;AACrG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAA,gBAAU,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAHhF,QAAA,YAAY,gBAGoE"}

package/messages/clone.md

@@ -0,0 +1,67 @@
+# summary
+
+Clone a sandbox org.
+
+# success
+
+The sandbox org cloning process %s is in progress. Run "sfdx force:org:status -n %s" to check for status. If the org is ready, checking the status also logs the requesting user in to the sandbox org and authorizes the org for use with Salesforce CLI.
+
+# description
+
+There are two ways to clone a sandbox: either specify a sandbox definition file or provide key=value pairs at the command line. Key-value pairs at the command-line override their equivalent sandbox definition file values. In either case, you must specify both the "SandboxName" and "SourceSandboxName" options to set the names of the new sandbox and the one being cloned, respectively.
+
+Set the --targetusername (-u) parameter to a production org with sandbox licenses. The --type (-t) parameter is required and must be set to "sandbox".
+
+# examples
+
+- $ <%= config.bin %> <%= command.id %> -t sandbox -f config/dev-sandbox-def.json -u prodOrg -a MyDevSandbox
+
+- $ <%= config.bin %> <%= command.id %> -t sandbox SandboxName=NewClonedSandbox SourceSandboxName=ExistingSandbox -u prodOrg -a MyDevSandbox
+
+# flags.type
+
+Type of org to create.
+
+# flags.wait
+
+Number of minutes to wait while polling for status.
+
+# flags.setdefaultusername
+
+Set the cloned org as your default.
+
+# flags.setalias
+
+Alias for the cloned org.
+
+# flags.definitionfile
+
+Path to the sandbox definition file.
+
+# flagsLong.wait
+
+Sets the streaming client socket timeout, in minutes. If the streaming client socket has no contact from the server for a number of minutes, the client exits. Specify a longer wait time if timeouts occur frequently.
+
+# commandSuccess
+
+The sandbox org cloning process %s is in progress. Run "sfdx force:org:status -n %s" to check for status. If the org is ready, checking the status also logs the requesting user in to the sandbox org and authorizes the org for use with Salesforce CLI.
+
+# missingLicenseType
+
+The sandbox license type is required, but you didn't provide a value. Specify the license type in the sandbox definition file with the "licenseType" option, or specify the option as a name-value pair at the command-line. See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm for more information.
+
+# commandOrganizationTypeNotSupport
+
+The only supported org type is: %s
+
+# commandOrganizationTypeNotSupportAction
+
+force:org:clone -t %s
+
+# missingSourceSandboxName
+
+Specify a value for %s in a definition file or on the command line.
+
+# missingSourceSandboxNameAction
+
+To indicate which sandbox org you want to clone, specify %s in a definition file or as a command line argument.

package/messages/create.md

@@ -0,0 +1,125 @@
+# summary
+
+Create a scratch org or sandbox.
+
+# deprecation
+
+The force:org:create command is deprecated. Use org:create:scratch or org:create:sandbox.
+
+# description
+
+Creates a scratch org or a sandbox org using the values specified in a configuration file or key=value pairs that you specify on the command line. Values specified on the command line override values in the configuration file. Specify a configuration file or provide key=value pairs while creating a scratch org or a sandbox. When creating scratch orgs, —targetdevhubusername (-v) must be a Dev Hub org. When creating sandboxes, the --targetusername (-u) must be a production org with sandbox licenses. The —type (-t) is required if creating a sandbox.
+
+# examples
+
+- $ <%= config.bin %> <%= command.id %> -f config/enterprise-scratch-def.json -a MyScratchOrg
+
+- $ <%= config.bin %> <%= command.id %> edition=Developer -a MyScratchOrg -s -v devHub
+
+- $ <%= config.bin %> <%= command.id %> -f config/enterprise-scratch-def.json -a ScratchOrgWithOverrides username=testuser1@mycompany.org
+
+- $ <%= config.bin %> <%= command.id %> -t sandbox -f config/dev-sandbox-def.json -a MyDevSandbox -u prodOrg
+
+# flags.clientId
+
+Connected app consumer key; not supported for sandbox org creation.
+
+# flags.setDefaultUsername
+
+Set the created org as the default username.
+
+# flags.setAlias
+
+Alias for the created org.
+
+# flags.definitionFile
+
+Path to an org definition file.
+
+# flags.definitionJson
+
+Org definition in JSON format.
+
+# flags.noNamespace
+
+Create the scratch org with no namespace.
+
+# flags.noAncestors
+
+Do not include second-generation package ancestors in the scratch org.
+
+# flags.env
+
+Environment where the scratch org is created: %s.
+
+# flags.type
+
+Type of org to create.
+
+# flags.durationDays
+
+Duration of the scratch org (in days) (default:7, min:1, max:30).
+
+# flags.retry
+
+Number of scratch org auth retries after scratch org is successfully signed up.
+
+# flags.wait
+
+Streaming client socket timeout (in minutes).
+
+# scratchOrgCreateSuccess
+
+Successfully created scratch org: %s, username: %s.
+
+# clientIdNotSupported
+
+-i | --clientid is not supported for the sandbox org create command. Its value, %s, has been ignored.
+
+# noNamespaceNotSupported
+
+-n | --nonamespace is not supported for the sandbox org create command. Its value, %s, has been ignored.
+
+# noAncestorsNotSupported
+
+-c | --noancestors is not supported for the sandbox org create command. Its value, %s, has been ignored.
+
+# durationDaysNotSupported
+
+-d | --durationdays is not supported for the sandbox org create command. Its value, %s, has been ignored.
+
+# retryIsNotValidForSandboxes
+
+One cannot use flag retry with Sandbox org create.
+
+# sandboxSuccess
+
+The sandbox org creation process %s is in progress. Run "sfdx force:org:status -n %s -u %s" to check for status. If the org is ready, checking the status also authorizes the org for use with Salesforce CLI.
+
+# requiresUsername
+
+This command requires a username. Specify it with the -u parameter or with the "sfdx config:set defaultusername=<username>" command.
+
+# missingLicenseType
+
+The sandbox license type is required, but you didn't provide a value. Specify the license type in the sandbox definition file with the "licenseType" option, or specify the option as a name-value pair at the command-line. See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm for more information.
+
+# dnsTimeout
+
+The sandbox was successfully created and authenticated. However, the sandbox DNS records aren't ready yet and so the sandbox may not be available. Run "org:list" and check if the sandbox is listed correctly. If it isn't listed, run "force:org:status" to view its status and, if necessary, authenticate to it again. If this issue happens frequently, try setting the SFDX_DNS_TIMEOUT environment variable to a larger number; the default value is 3 seconds.
+
+# partialSuccess
+
+If you specified the -a or -s parameters, but the sandbox wasn't immediately available, the "force:org:create" command may not have finished setting the alias or defaultusername. If so, set the alias manually with "sfdx alias:set" and the defaultusername with "sfdx config:set".
+
+# noConfig
+
+Please specify an org configuration via file and/or key=value pairs.
+
+# RequiresDevhubUsernameError
+
+This command requires a dev hub org username set either with a flag or by default in the config.
+
+# secretPrompt
+
+OAuth client secret of personal connected app?

package/messages/create.sandbox.md

@@ -0,0 +1,123 @@
+# summary
+
+Create a sandbox org.
+
+# description
+
+There are two ways to create a sandbox org: specify a definition file that contains the sandbox options or use the --name and --license-type flags to specify the two required options. If you want to set an option other than name or license type, such as apexClassId, you must use a definition file.
+
+# examples
+
+- Create a sandbox org using a definition file and give it the alias "MyDevSandbox". The production org that contains the sandbox license has the alias "prodOrg".
+
+  <%= config.bin %> <%= command.id %> -f config/dev-sandbox-def.json --alias MyDevSandbox --target-org prodOrg
+
+- Create a sandbox org by directly specifying its name and type of license (Developer) instead of using a definition file. Set the sandbox org as your default.
+
+  <%= config.bin %> <%= command.id %> --name mysandbox --license-type Developer --alias MyDevSandbox --target-org prodOrg --set-default
+
+# flags.setDefault.summary
+
+Set the sandbox org as your default org.
+
+# flags.alias.summary
+
+Alias for the sandbox org.
+
+# flags.alias.description
+
+When you create a sandbox, the generated usernames are based on the usernames present in the production org. To ensure uniqueness, the new usernames are appended with the name of the sandbox. For example, the username "user@example.com" in the production org results in the username "user@example.com.mysandbox" in a sandbox named "mysandbox". When you set an alias for a sandbox org, it's assigned to the resulting username of the user running this command.
+
+# flags.targetOrg.summary
+
+Username or alias of the production org that contains the sandbox license.
+
+# flags.targetOrg.description
+
+When it creates the sandbox org, Salesforce copies the metadata, and optionally data, from your production org to the new sandbox org.
+
+# flags.definitionFile.summary
+
+Path to a sandbox definition file.
+
+# flags.definitionFile.description
+
+The sandbox definition file is a blueprint for the sandbox. You can create different definition files for each sandbox type that you use in the development process. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_sandbox_definition.htm> for all the options you can specify in the defintion file.
+
+# flags.name.summary
+
+Name of the sandbox org.
+
+# flags.name.description
+
+The name must be a unique alphanumeric string (10 or fewer characters) to identify the sandbox. You can’t reuse a name while a sandbox is in the process of being deleted.
+
+# flags.clone.summary
+
+Name of the sandbox org to clone.
+
+# flags.clone.description
+
+The value of clone must be an existing sandbox in the same target-org.
+
+# flags.licenseType.summary
+
+Type of sandbox license.
+
+# flags.wait.summary
+
+Number of minutes to wait for the sandbox org to be ready.
+
+# flags.wait.description
+
+If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the "<%= config.bin %> org resume sandbox" command you run to check the status of the create. The displayed command includes the job ID for the running sandbox creation.
+
+# flags.poll-interval.summary
+
+Number of seconds to wait between retries.
+
+# flags.async.summary
+
+Request the sandbox creation, but don't wait for it to complete.
+
+# flags.async.description
+
+The command immediately displays the job ID and returns control of the terminal to you. This way, you can continue to use the CLI. To check the status of the sandbox creation, run "<%= config.bin %> org resume sandbox".
+
+# flags.noPrompt.summary
+
+Don't prompt for confirmation about the sandbox configuration.
+
+# flags.no-track-source.summary
+
+Do not use source tracking for this sandbox.
+
+# flags.no-track-source.description
+
+We recommend you enable source tracking in Developer and Developer Pro sandbox, which is why it's the default behavior. Source tracking allows you to track the changes you make to your metadata, both in your local project and in the sandbox, and to detect any conflicts between the two.
+
+To disable source tracking in the new sandbox, specify the --no-track-source flag. The main reason to disable source tracking is for performance. For example, while you probably want to deploy metadata and run Apex tests in your CI/CD jobs, you probably don't want to incur the costs of source tracking (checking for conflicts, polling the SourceMember object, various file system operations.) This is a good use case for disabling source tracking in the sandbox.
+
+# isConfigurationOk
+
+Is the configuration correct?
+
+# warning.NoSandboxNameDefined
+
+No SandboxName defined, generating new SandboxName: %s.
+
+# error.SandboxNameLength
+
+The sandbox name "%s" should be 10 or fewer characters.
+
+# error.UserNotSatisfiedWithSandboxConfig
+
+The sandbox request configuration isn't acceptable.
+
+# error.pollIntervalGreaterThanWait
+
+The poll interval (%d seconds) can't be larger that wait (%d in seconds)
+
+# error.noCloneSource
+
+Could not find the clone sandbox name "%s" in the target org.

package/messages/create_scratch.md

@@ -0,0 +1,109 @@
+# summary
+
+Create a scratch org.
+
+# description
+
+There are two ways to create a scratch org: specify a definition file that contains the options or use the --edition flag to specify the one required option. If you want to set options other than the edition, such as org features or settings, you must use a definition file.
+
+You must specify a Dev Hub to create a scratch org, either with the --target-dev-hub flag or by setting your default Dev Hub with the target-dev-hub configuration variable.
+
+# examples
+
+- Create a Developer edition scratch org using your default Dev Hub and give the scratch org an alias:
+
+  <%= config.bin %> <%= command.id %> --edition=developer --alias my-scratch-org
+
+- Specify the Dev Hub using its alias and a scratch org definition file. Set the scratch org as your default and specify that it expires in 3 days:
+
+  <%= config.bin %> <%= command.id %> --target-dev-hub=MyHub --definition-file config/project-scratch-def.json --set-default --duration-days 3
+
+# flags.target-hub.summary
+
+Username or alias of the Dev Hub org.
+
+# flags.target-hub.description
+
+Overrides the value of the target-dev-hub configuration variable, if set.
+
+# flags.alias.summary
+
+Alias for the scratch org.
+
+# flags.alias.description
+
+New scratch orgs include one administrator by default. The admin user's username is auto-generated and looks something like test-wvkpnfm5z113@example.com. When you set an alias for a new scratch org, it's assigned this username.
+
+# flags.set-default.summary
+
+Set the scratch org as your default org
+
+# flags.no-ancestors.summary
+
+Don't include second-generation managed package (2GP) ancestors in the scratch org.
+
+# flags.edition.summary
+
+Salesforce edition of the scratch org.
+
+# flags.async.summary
+
+Request the org, but don't wait for it to complete.
+
+# flags.async.description
+
+The command immediately displays the job ID and returns control of the terminal to you. This way, you can continue to use the CLI. To resume the scratch org creation, run "<%= config.bin %> org resume scratch".
+
+# flags.edition.description
+
+The editions that begin with "partner-" are available only if the Dev Hub org is a Partner Business Org.
+
+# flags.definition-file.summary
+
+Path to a scratch org definition file.
+
+# flags.definition-file.description
+
+The scratch org definition file is a blueprint for the scratch org. It mimics the shape of an org that you use in the development life cycle, such as acceptance testing, packaging, or production. See <https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs_def_file.htm> for all the option you can specify in the definition file.
+
+# flags.client-id.summary
+
+Consumer key of the Dev Hub connected app.
+
+# flags.wait.summary
+
+Number of minutes to wait for the scratch org to be ready.
+
+# flags.wait.description
+
+If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the job ID. To resume the scratch org creation, run the org resume scratch command and pass it the job ID.
+
+# flags.track-source.summary
+
+Use source tracking for this scratch org. Set --no-track-source to disable source tracking.
+
+# flags.track-source.description
+
+We recommend you enable source tracking in scratch orgs, which is why it's the default behavior. Source tracking allows you to track the changes you make to your metadata, both in your local project and in the scratch org, and to detect any conflicts between the two.
+
+To disable source tracking in the new scratch org, specify the --no-track-source flag. The main reason to disable source tracking is for performance. For example, while you probably want to deploy metadata and run Apex tests in your CI/CD jobs, you probably don't want to incur the costs of source tracking (checking for conflicts, polling the SourceMember object, various file system operations.) This is a good use case for disabling source tracking in the scratch org.
+
+# flags.no-namespace.summary
+
+Create the scratch org with no namespace, even if the Dev Hub has a namespace.
+
+# flags.duration-days.summary
+
+Number of days before the org expires.
+
+# prompt.secret
+
+OAuth client secret of your personal connected app
+
+# success
+
+Your scratch org is ready.
+
+# action.resume
+
+Resume scratch org creation by running "%s org resume scratch --job-id %s"

package/messages/delete.md

@@ -0,0 +1,47 @@
+# summary
+
+Delete a scratch or sandbox org.
+
+# deprecation
+
+The force:org:delete command is deprecated. Use org:delete:scratch or org:delete:sandbox.
+
+# description
+
+Salesforce CLI marks the org for deletion in either the Dev Hub org (for scratch orgs) or production org (for sandboxes) and then deletes all local references to the org from your computer.
+
+To mark the org for deletion without being prompted to confirm, specify --noprompt.
+
+# examples
+
+- $ <%= config.bin %> <%= command.id %> -u me@my.org
+
+- $ <%= config.bin %> <%= command.id %> -u MyOrgAlias -p
+
+# flags.noprompt
+
+No prompt to confirm deletion.
+
+# confirmDelete
+
+Enqueue %s org with name: %s for deletion? Are you sure (y/n)?
+
+# sandboxConfigOnlySuccess
+
+Successfully deleted sandbox org %s.
+
+# ScratchOrgNotFound
+
+Attempting to delete an expired or deleted org
+
+# deleteOrgConfigOnlyCommandSuccess
+
+Successfully deleted scratch org %s.'
+
+# deleteOrgCommandSuccess
+
+Successfully marked scratch org %s for deletion
+
+# commandSandboxSuccess
+
+The sandbox org %s has been successfully removed from your list of CLI authorized orgs. If you created the sandbox with one of the force:org commands, it has also been marked for deletion.

package/messages/delete_sandbox.md

@@ -0,0 +1,46 @@
+# summary
+
+Delete a sandbox.
+
+# description
+
+Salesforce CLI marks the org for deletion in the production org that contains the sandbox licenses and then deletes all local references to the org from your computer.
+Specify a sandbox with either the username you used when you logged into it, or the alias you gave the sandbox when you created it. Run "<%= config.bin %> org list" to view all your orgs, including sandboxes, and their aliases.
+
+# examples
+
+- Delete a sandbox with alias my-sandbox:
+
+  <%= config.bin %> <%= command.id %> --target-org=my-sandbox
+
+- Specify a username instead of an alias:
+
+  <%= config.bin %> <%= command.id %> --target-org=myusername@example.com.qa
+
+- Delete the sandbox without prompting to confirm :
+
+  <%= config.bin %> <%= command.id %> --target-org=my-sandbox --no-prompt
+
+# flags.target-org.summary
+
+Sandbox alias or login user.
+
+# flags.no-prompt.summary
+
+Don't prompt the user to confirm the deletion.
+
+# prompt.confirm
+
+Are you sure you want to delete the sandbox with name: %s?
+
+# success
+
+Successfully marked sandbox %s for deletion.
+
+# success.Idempotent
+
+There is no sandbox with the username %s.
+
+# error.isNotSandbox
+
+The target org, %s, is not a sandbox.

package/messages/delete_scratch.md

@@ -0,0 +1,42 @@
+# summary
+
+Delete a scratch org.
+
+# description
+
+Salesforce CLI marks the org for deletion in the Dev Hub org and then deletes all local references to the org from your computer.
+Specify a scratch org with either the username or the alias you gave the scratch org when you created it. Run "<%= config.bin %> org list" to view all your orgs, including scratch orgs, and their aliases.
+
+# examples
+
+- Delete a scratch org with alias my-scratch-org:
+
+  <%= config.bin %> <%= command.id %> --target-org=my-scratch-org
+
+- Specify a username instead of an alias:
+
+  <%= config.bin %> <%= command.id %> --target-org=test-123456-abcdefg@example.com
+
+- Delete the scratch org without prompting to confirm :
+
+  <%= config.bin %> <%= command.id %> --target-org=my-scratch-org --no-prompt
+
+# flags.target-org.summary
+
+Scratch org alias or login user.
+
+# flags.no-prompt.summary
+
+Don't prompt the user to confirm the deletion.
+
+# prompt.confirm
+
+Are you sure you want to delete the scratch org with name: %s?
+
+# success
+
+Successfully marked scratch org %s for deletion.
+
+# success.Idempotent
+
+Successfully deleted scratch org %s.

package/messages/display.md

@@ -0,0 +1,33 @@
+# summary
+
+Display information about an org.
+
+# description
+
+Output includes your access token, client Id, connected status, org ID, instance URL, username, and alias, if applicable.
+
+Use --verbose to include the SFDX auth URL. WARNING: The SFDX auth URL contains sensitive information, such as a refresh token that can be used to access an org. Don't share or distribute this URL or token.
+
+Including --verbose displays the sfdxAuthUrl property only if you authenticated to the org using auth:web:login (not auth:jwt:grant).
+
+# flags.verbose.summary
+
+Display the sfdxAuthUrl property.
+
+# examples
+
+- Display information about your default org:
+
+  $ <%= config.bin %> <%= command.id %>
+
+- Display information, including the sfdxAuthUrl property, about the org with alias TestOrg1:
+
+  $ <%= config.bin %> <%= command.id %> --target-org TestOrg1 --verbose
+
+# noScratchOrgInfoError
+
+No information for scratch org with ID %s found in Dev Hub %s.
+
+# noScratchOrgInfoAction
+
+First check that you can access your Dev Hub. Then check that the ScratchOrgInfo standard object in your Dev Hub contains a record for your scratch org. In Setup, navigate to the Dev Hub page and click the Scratch Org Infos tab. If you find your scratch org, try again.