diff --git a/README.md b/README.md index 08890841b..c32bc109d 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ $ npm install -g @salesforce/cli $ sf COMMAND running command... $ sf (--version|-v) -@salesforce/cli/2.93.5 linux-x64 node-v22.16.0 +@salesforce/cli/2.93.6 linux-x64 node-v22.16.0 $ sf --help [COMMAND] USAGE $ sf COMMAND @@ -5506,7 +5506,7 @@ _See code: [@salesforce/plugin-org](https://github.com/salesforcecli/plugin-org/ ## `sf package convert` -Create a second-generation package version from a first-generation package. +Convert a managed-released first-generation managed package into a second-generation managed package. ``` USAGE @@ -5514,12 +5514,12 @@ USAGE ] [-x] [-w ] [-m ] [--verbose] [-a ] FLAGS - -a, --patch-version= Specific released patch version to convert + -a, --patch-version= Specific released patch version to be converted. -f, --definition-file= Path to a definition file that contains features and org preferences that the metadata of the package version depends on. -k, --installation-key= Installation key for key-protected package. -m, --seed-metadata= Directory containing metadata to be deployed prior to conversion. - -p, --package= (required) ID (starts with 033) of the first-generation package to convert. + -p, --package= (required) ID (starts with 033) of the first-generation managed package to convert. -v, --target-dev-hub= (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set. -w, --wait= Minutes to wait for the package version to be created. @@ -5532,21 +5532,18 @@ GLOBAL FLAGS --json Format output as json. DESCRIPTION - Create a second-generation package version from a first-generation package. + Convert a managed-released first-generation managed package into a second-generation managed package. - The package convert creates a new package in the Dev Hub if one does not already exist for the specified - first-generation package. + The package conversion command automatically selects the latest released major.minor first-generation managed package + version, and converts it into a second-generation managed package version. - It then creates a new package version in the Dev Hub with contents based on the specified first-generation package. - - By default, the latest released non-patch version from the specified first-generation package will be converted. Use - --patch-version to override the default. Read more about --patch-version option in help + Use --patch-version to specify a released patch version. To retrieve details about a package version create request, including status and package version ID (04t), run "sf package version create report -i 08c...". - We recommend specifying the --installation-key to protect the contents of your package and to prevent unauthorized - installation of your package. + To protect the contents of your package and to prevent unauthorized installation of your package, specify the + --installation-key flag. To list package version creation requests in the org, run "sf package version create list". @@ -5554,8 +5551,8 @@ ALIASES $ sf force package convert EXAMPLES - Create a second-generation package version from the first-generation package with the specified ID and give it the - installation key "password123"; uses your default Dev Hub org: + Create a second-generation managed package version from the first-generation managed package with the specified ID + and give it the installation key "password123"; uses your default Dev Hub org: $ sf package convert --package 033... --installation-key password123 @@ -5564,9 +5561,9 @@ EXAMPLES $ sf package convert --package 033... --installation-key password123 --target-dev-hub devhuborg@example.com FLAG DESCRIPTIONS - -a, --patch-version= Specific released patch version to convert + -a, --patch-version= Specific released patch version to be converted. - Specify a released patch version as major.minor.patch.build to convert to second generation package version + Specify a released patch version as major.minor.patch to convert to a second-generation managed package version. -f, --definition-file= @@ -5581,7 +5578,7 @@ FLAG DESCRIPTIONS -m, --seed-metadata= Directory containing metadata to be deployed prior to conversion. - The directory containing metadata that will be deployed on the build org prior to attempting conversion. + The directory containing metadata that will be deployed on the build org prior to attempting package conversion. -x, --installation-key-bypass Bypass the installation key requirement. @@ -5589,7 +5586,7 @@ FLAG DESCRIPTIONS --installation-key-bypass flag is required. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/convert.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/convert.ts)_ ## `sf package create` @@ -5668,7 +5665,7 @@ FLAG DESCRIPTIONS Org-Dependent Unlocked Packages" in the Salesforce DX Developer Guide. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/create.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/create.ts)_ ## `sf package delete` @@ -5710,7 +5707,7 @@ EXAMPLES $ sf package delete --package 0Ho... --target-dev-hub devhub@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/delete.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/delete.ts)_ ## `sf package install` @@ -5809,7 +5806,7 @@ FLAG DESCRIPTIONS - Delete: Delete all removed components that can be safely deleted, and deprecate the other components. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/install.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/install.ts)_ ## `sf package install report` @@ -5842,7 +5839,7 @@ EXAMPLES $ sf package install report --request-id 0Hf... --target-org me@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/install/report.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/install/report.ts)_ ## `sf package installed list` @@ -5874,7 +5871,7 @@ EXAMPLES $ sf package installed list --target-org me@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/installed/list.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/installed/list.ts)_ ## `sf package list` @@ -5912,7 +5909,7 @@ EXAMPLES $ sf package list --target-dev-hub devhub@example.com --verbose ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/list.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/list.ts)_ ## `sf package push-upgrade abort` @@ -5952,7 +5949,7 @@ EXAMPLES $ sf package push-upgrade abort --push-request-id 0DV... --target-dev-hub devhub@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/abort.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/abort.ts)_ ## `sf package push-upgrade list` @@ -6011,7 +6008,7 @@ EXAMPLES $ sf package push-upgrade list --package 033xyz –-status Failed ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/list.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/list.ts)_ ## `sf package push-upgrade report` @@ -6053,7 +6050,7 @@ EXAMPLES $ sf package push-upgrade report --push-request-id 0DV... --target-dev-hub devhub@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/report.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/report.ts)_ ## `sf package push-upgrade schedule` @@ -6135,7 +6132,7 @@ FLAG DESCRIPTIONS Overrides the value of the target-dev-hub configuration variable, if set. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/push-upgrade/schedule.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/push-upgrade/schedule.ts)_ ## `sf package uninstall` @@ -6183,7 +6180,7 @@ EXAMPLES $ sf package uninstall --package "Undesirable Package Alias" ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/uninstall.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/uninstall.ts)_ ## `sf package uninstall report` @@ -6216,7 +6213,7 @@ EXAMPLES $ sf package uninstall report --request-id 06y... --target-org me@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/uninstall/report.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/uninstall/report.ts)_ ## `sf package update` @@ -6271,7 +6268,7 @@ FLAG DESCRIPTIONS associated with your package. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/update.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/update.ts)_ ## `sf package version create` @@ -6446,7 +6443,7 @@ FLAG DESCRIPTIONS periods of no output from commands. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/create.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/create.ts)_ ## `sf package version create list` @@ -6507,7 +6504,7 @@ EXAMPLES $ sf package version create list --created-last-days 0 --status Success ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/create/list.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/create/list.ts)_ ## `sf package version create report` @@ -6550,7 +6547,7 @@ EXAMPLES $ sf package version create report --package-create-request-id 08c... --target-dev-hub devhub@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/create/report.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/create/report.ts)_ ## `sf package version delete` @@ -6591,7 +6588,7 @@ EXAMPLES $ sf package version delete --package 04t... --target-org devhub@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/delete.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/delete.ts)_ ## `sf package version displayancestry` @@ -6651,7 +6648,7 @@ FLAG DESCRIPTIONS You can use the DOT code output in graph visualization software to create tree visualizations. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/displayancestry.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/displayancestry.ts)_ ## `sf package version list` @@ -6727,7 +6724,7 @@ EXAMPLES $ sf package version list --packages exp-mgr,exp-mgr-util --released --modified-last-days 0 ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/list.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/list.ts)_ ## `sf package version promote` @@ -6771,7 +6768,7 @@ EXAMPLES $ sf package version promote --package "Awesome Package Alias" ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/promote.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/promote.ts)_ ## `sf package version report` @@ -6811,7 +6808,7 @@ EXAMPLES $ sf package version report --package "Your Package Alias" --target-dev-hub devhub@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/report.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/report.ts)_ ## `sf package version update` @@ -6864,7 +6861,7 @@ EXAMPLES $ sf package version update --package 04t... --version-description "New Package Version Description" ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package/version/update.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package/version/update.ts)_ ## `sf package1 version create` @@ -6931,7 +6928,7 @@ FLAG DESCRIPTIONS subscribers. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/create.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/create.ts)_ ## `sf package1 version create get` @@ -6964,7 +6961,7 @@ EXAMPLES $ sf package1 version create get --request-id 0HD... --target-org myorg@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/create/get.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/create/get.ts)_ ## `sf package1 version display` @@ -6998,7 +6995,7 @@ EXAMPLES $ sf package1 version display --package-version-id 04t... --target-org myorg@example.com ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/display.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/display.ts)_ ## `sf package1 version list` @@ -7036,7 +7033,7 @@ FLAG DESCRIPTIONS If not specified, shows all versions for all packages (managed and unmanaged) in the org. ``` -_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.3/src/commands/package1/version/list.ts)_ +_See code: [@salesforce/plugin-packaging](https://github.com/salesforcecli/plugin-packaging/blob/2.15.4/src/commands/package1/version/list.ts)_ ## `sf plugins` diff --git a/package.json b/package.json index 1c77b9485..ddaf2d146 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@salesforce/cli", "description": "The Salesforce CLI", - "version": "2.93.5", + "version": "2.93.6", "author": "Salesforce", "bin": { "sf": "./bin/run.js",