@salesforce/plugin-packaging 2.18.4 → 2.19.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/README.md +90 -27
  2. package/lib/commands/package/version/displaydependencies.d.ts +16 -0
  3. package/lib/commands/package/version/displaydependencies.js +54 -0
  4. package/lib/commands/package/version/displaydependencies.js.map +1 -0
  5. package/messages/package_version_displaydependencies.md +37 -0
  6. package/oclif.manifest.json +1358 -1240
  7. package/package.json +8 -8
  8. package/schemas/package-version-displaydependencies.json +16 -0
package/oclif.manifest.json CHANGED
@@ -1168,6 +1168,134 @@
1168
1168
  "list:installed:package"
1169
1169
  ]
1170
1170
  },
1171
+ "package:install:report": {
1172
+ "aliases": [
1173
+ "force:package:install:report"
1174
+ ],
1175
+ "args": {},
1176
+ "deprecateAliases": true,
1177
+ "examples": [
1178
+ "Retrieve the status of a package installation request with the specified ID on your default org:\n<%= config.bin %> <%= command.id %> --request-id 0Hf...",
1179
+ "Similar to previous example, except use the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --request-id 0Hf... --target-org me@example.com"
1180
+ ],
1181
+ "flags": {
1182
+ "json": {
1183
+ "description": "Format output as json.",
1184
+ "helpGroup": "GLOBAL",
1185
+ "name": "json",
1186
+ "allowNo": false,
1187
+ "type": "boolean"
1188
+ },
1189
+ "flags-dir": {
1190
+ "helpGroup": "GLOBAL",
1191
+ "name": "flags-dir",
1192
+ "summary": "Import flag values from a directory.",
1193
+ "hasDynamicHelp": false,
1194
+ "multiple": false,
1195
+ "type": "option"
1196
+ },
1197
+ "target-org": {
1198
+ "aliases": [
1199
+ "targetusername",
1200
+ "u"
1201
+ ],
1202
+ "char": "o",
1203
+ "deprecateAliases": true,
1204
+ "name": "target-org",
1205
+ "noCacheDefault": true,
1206
+ "required": true,
1207
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1208
+ "hasDynamicHelp": true,
1209
+ "multiple": false,
1210
+ "type": "option"
1211
+ },
1212
+ "api-version": {
1213
+ "aliases": [
1214
+ "apiversion"
1215
+ ],
1216
+ "deprecateAliases": true,
1217
+ "description": "Override the api version used for api requests made by this command",
1218
+ "name": "api-version",
1219
+ "hasDynamicHelp": false,
1220
+ "multiple": false,
1221
+ "type": "option"
1222
+ },
1223
+ "loglevel": {
1224
+ "deprecated": {
1225
+ "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
1226
+ },
1227
+ "hidden": true,
1228
+ "name": "loglevel",
1229
+ "hasDynamicHelp": false,
1230
+ "multiple": false,
1231
+ "type": "option"
1232
+ },
1233
+ "request-id": {
1234
+ "aliases": [
1235
+ "requestid"
1236
+ ],
1237
+ "char": "i",
1238
+ "deprecateAliases": true,
1239
+ "name": "request-id",
1240
+ "required": true,
1241
+ "summary": "ID of the package install request you want to check; starts with 0Hf.",
1242
+ "hasDynamicHelp": false,
1243
+ "multiple": false,
1244
+ "type": "option"
1245
+ }
1246
+ },
1247
+ "hasDynamicHelp": true,
1248
+ "hiddenAliases": [],
1249
+ "id": "package:install:report",
1250
+ "pluginAlias": "@salesforce/plugin-packaging",
1251
+ "pluginName": "@salesforce/plugin-packaging",
1252
+ "pluginType": "core",
1253
+ "strict": true,
1254
+ "summary": "Retrieve the status of a package installation request.",
1255
+ "enableJsonFlag": true,
1256
+ "isESM": true,
1257
+ "relativePath": [
1258
+ "lib",
1259
+ "commands",
1260
+ "package",
1261
+ "install",
1262
+ "report.js"
1263
+ ],
1264
+ "aliasPermutations": [
1265
+ "force:package:install:report",
1266
+ "package:force:install:report",
1267
+ "package:install:force:report",
1268
+ "package:install:report:force",
1269
+ "force:install:package:report",
1270
+ "install:force:package:report",
1271
+ "install:package:force:report",
1272
+ "install:package:report:force",
1273
+ "force:install:report:package",
1274
+ "install:force:report:package",
1275
+ "install:report:force:package",
1276
+ "install:report:package:force",
1277
+ "force:package:report:install",
1278
+ "package:force:report:install",
1279
+ "package:report:force:install",
1280
+ "package:report:install:force",
1281
+ "force:report:package:install",
1282
+ "report:force:package:install",
1283
+ "report:package:force:install",
1284
+ "report:package:install:force",
1285
+ "force:report:install:package",
1286
+ "report:force:install:package",
1287
+ "report:install:force:package",
1288
+ "report:install:package:force"
1289
+ ],
1290
+ "permutations": [
1291
+ "package:install:report",
1292
+ "install:package:report",
1293
+ "install:report:package",
1294
+ "package:report:install",
1295
+ "report:package:install",
1296
+ "report:install:package"
1297
+ ]
1298
+ },
1171
1299
  "package:push-upgrade:abort": {
1172
1300
  "aliases": [],
1173
1301
  "args": {},
@@ -1775,15 +1903,19 @@
1775
1903
  "report:uninstall:package"
1776
1904
  ]
1777
1905
  },
1778
- "package:install:report": {
1906
+ "package:version:create": {
1779
1907
  "aliases": [
1780
- "force:package:install:report"
1908
+ "force:package:version:create"
1781
1909
  ],
1782
1910
  "args": {},
1783
1911
  "deprecateAliases": true,
1912
+ "description": "The package version is based on the package contents in the specified directory.\n\nTo retrieve details about a package version create request, including status and package version ID (04t), run \"<%= config.bin %> package version create report -i 08c...\".\n\nWe recommend that you specify the --installation-key parameter to protect the contents of your package and to prevent unauthorized installation of your package.\n\nTo list package version creation requests in the org, run \"<%= config.bin %> package version create list\".\nTo promote a package version to released, you must use the --code-coverage parameter. The package must also meet the code coverage requirements. This requirement applies to both managed and unlocked packages.\n\nWe don’t calculate code coverage for org-dependent unlocked packages, or for package versions that specify --skip-validation.",
1784
1913
  "examples": [
1785
- "Retrieve the status of a package installation request with the specified ID on your default org:\n<%= config.bin %> <%= command.id %> --request-id 0Hf...",
1786
- "Similar to previous example, except use the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --request-id 0Hf... --target-org me@example.com"
1914
+ "Create a package version from the contents of the \"common\" directory and give it an installation key of \"password123\"; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123",
1915
+ "Create a package version from a package with the specified alias; uses the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\" --installation-key password123 --target-dev-hub devhub@example.com",
1916
+ "Create a package version from a package with the specified ID:\n<%= config.bin %> <%= command.id %> --package 0Ho... --installation-key password123",
1917
+ "Create a package version and skip the validation step:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --skip-validation",
1918
+ "Create a package version and perform package validations asynchronously:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --async-validation"
1787
1919
  ],
1788
1920
  "flags": {
1789
1921
  "json": {
@@ -1801,17 +1933,27 @@
1801
1933
  "multiple": false,
1802
1934
  "type": "option"
1803
1935
  },
1804
- "target-org": {
1936
+ "loglevel": {
1937
+ "deprecated": {
1938
+ "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
1939
+ },
1940
+ "hidden": true,
1941
+ "name": "loglevel",
1942
+ "hasDynamicHelp": false,
1943
+ "multiple": false,
1944
+ "type": "option"
1945
+ },
1946
+ "target-dev-hub": {
1805
1947
  "aliases": [
1806
- "targetusername",
1807
- "u"
1948
+ "targetdevhubusername",
1949
+ "target-hub-org"
1808
1950
  ],
1809
- "char": "o",
1951
+ "char": "v",
1810
1952
  "deprecateAliases": true,
1811
- "name": "target-org",
1953
+ "name": "target-dev-hub",
1812
1954
  "noCacheDefault": true,
1813
1955
  "required": true,
1814
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1956
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1815
1957
  "hasDynamicHelp": true,
1816
1958
  "multiple": false,
1817
1959
  "type": "option"
@@ -1827,229 +1969,239 @@
1827
1969
  "multiple": false,
1828
1970
  "type": "option"
1829
1971
  },
1830
- "loglevel": {
1831
- "deprecated": {
1832
- "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
1833
- },
1834
- "hidden": true,
1835
- "name": "loglevel",
1972
+ "branch": {
1973
+ "char": "b",
1974
+ "name": "branch",
1975
+ "summary": "Name of the branch in your source control system that the package version is based on.",
1836
1976
  "hasDynamicHelp": false,
1837
1977
  "multiple": false,
1838
1978
  "type": "option"
1839
1979
  },
1840
- "request-id": {
1980
+ "build-instance": {
1841
1981
  "aliases": [
1842
- "requestid"
1982
+ "buildinstance"
1843
1983
  ],
1844
- "char": "i",
1984
+ "char": "s",
1845
1985
  "deprecateAliases": true,
1846
- "name": "request-id",
1847
- "required": true,
1848
- "summary": "ID of the package install request you want to check; starts with 0Hf.",
1986
+ "hidden": true,
1987
+ "name": "build-instance",
1988
+ "summary": "Instance where the package version will be created, such as NA50.",
1849
1989
  "hasDynamicHelp": false,
1850
1990
  "multiple": false,
1851
1991
  "type": "option"
1852
- }
1853
- },
1854
- "hasDynamicHelp": true,
1855
- "hiddenAliases": [],
1856
- "id": "package:install:report",
1857
- "pluginAlias": "@salesforce/plugin-packaging",
1858
- "pluginName": "@salesforce/plugin-packaging",
1859
- "pluginType": "core",
1860
- "strict": true,
1861
- "summary": "Retrieve the status of a package installation request.",
1862
- "enableJsonFlag": true,
1863
- "isESM": true,
1864
- "relativePath": [
1865
- "lib",
1866
- "commands",
1867
- "package",
1868
- "install",
1869
- "report.js"
1870
- ],
1871
- "aliasPermutations": [
1872
- "force:package:install:report",
1873
- "package:force:install:report",
1874
- "package:install:force:report",
1875
- "package:install:report:force",
1876
- "force:install:package:report",
1877
- "install:force:package:report",
1878
- "install:package:force:report",
1879
- "install:package:report:force",
1880
- "force:install:report:package",
1881
- "install:force:report:package",
1882
- "install:report:force:package",
1883
- "install:report:package:force",
1884
- "force:package:report:install",
1885
- "package:force:report:install",
1886
- "package:report:force:install",
1887
- "package:report:install:force",
1888
- "force:report:package:install",
1889
- "report:force:package:install",
1890
- "report:package:force:install",
1891
- "report:package:install:force",
1892
- "force:report:install:package",
1893
- "report:force:install:package",
1894
- "report:install:force:package",
1895
- "report:install:package:force"
1896
- ],
1897
- "permutations": [
1898
- "package:install:report",
1899
- "install:package:report",
1900
- "install:report:package",
1901
- "package:report:install",
1902
- "report:package:install",
1903
- "report:install:package"
1904
- ]
1905
- },
1906
- "package1:version:create": {
1907
- "aliases": [
1908
- "force:package1:version:create"
1909
- ],
1910
- "args": {},
1911
- "deprecateAliases": true,
1912
- "description": "The package version is based on the contents of the specified metadata package. Omit --managed-released if you want to create an unmanaged package version.",
1913
- "examples": [
1914
- "Create a first-generation package version from the package with the specified ID and name the package version \"example\"; use your default org:\n<%= config.bin %> <%= command.id %> --package-id 033... --name example",
1915
- "Same as previous example, but provide a description and wait for 30 minutes for the package version to be created; use the specified org:\n<%= config.bin %> <%= command.id %> --package-id 033... --name example --description \"example description\" --wait 30 --target-org myorg@example.com"
1916
- ],
1917
- "flags": {
1918
- "json": {
1919
- "description": "Format output as json.",
1920
- "helpGroup": "GLOBAL",
1921
- "name": "json",
1922
- "allowNo": false,
1923
- "type": "boolean"
1924
1992
  },
1925
- "flags-dir": {
1926
- "helpGroup": "GLOBAL",
1927
- "name": "flags-dir",
1928
- "summary": "Import flag values from a directory.",
1993
+ "code-coverage": {
1994
+ "aliases": [
1995
+ "codecoverage"
1996
+ ],
1997
+ "char": "c",
1998
+ "deprecateAliases": true,
1999
+ "description": "Before you can promote and release a managed or unlocked package version, the Apex code must meet a minimum 75% code coverage requirement. We don’t calculate code coverage for org-dependent unlocked packages or for package versions that specify --skip-validation.",
2000
+ "exclusive": [
2001
+ "skip-validation"
2002
+ ],
2003
+ "name": "code-coverage",
2004
+ "summary": "Calculate and store the code coverage percentage by running the packaged Apex tests included in this package version.",
2005
+ "allowNo": false,
2006
+ "type": "boolean"
2007
+ },
2008
+ "definition-file": {
2009
+ "aliases": [
2010
+ "definitionfile"
2011
+ ],
2012
+ "char": "f",
2013
+ "deprecateAliases": true,
2014
+ "description": "For a patch version, the features specified in this file are ignored, and instead the features specified for the ancestor version are used.",
2015
+ "name": "definition-file",
2016
+ "summary": "Path to a definition file similar to scratch org definition file that contains the list of features and org preferences that the metadata of the package version depends on.",
1929
2017
  "hasDynamicHelp": false,
1930
2018
  "multiple": false,
1931
2019
  "type": "option"
1932
2020
  },
1933
- "loglevel": {
1934
- "deprecated": {
1935
- "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
1936
- },
1937
- "hidden": true,
1938
- "name": "loglevel",
2021
+ "installation-key": {
2022
+ "aliases": [
2023
+ "installationkey"
2024
+ ],
2025
+ "char": "k",
2026
+ "deprecateAliases": true,
2027
+ "name": "installation-key",
2028
+ "summary": "Installation key for key-protected package. (either --installation-key or --installation-key-bypass is required)",
1939
2029
  "hasDynamicHelp": false,
1940
2030
  "multiple": false,
1941
2031
  "type": "option"
1942
2032
  },
1943
- "target-org": {
2033
+ "installation-key-bypass": {
1944
2034
  "aliases": [
1945
- "targetusername",
1946
- "u"
2035
+ "installationkeybypass"
1947
2036
  ],
1948
- "char": "o",
2037
+ "char": "x",
1949
2038
  "deprecateAliases": true,
1950
- "name": "target-org",
1951
- "noCacheDefault": true,
1952
- "required": true,
1953
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1954
- "hasDynamicHelp": true,
2039
+ "description": "If you bypass this requirement, anyone can install your package.",
2040
+ "name": "installation-key-bypass",
2041
+ "summary": "Bypass the installation key requirement. (either --installation-key or --installation-key-bypass is required)",
2042
+ "allowNo": false,
2043
+ "type": "boolean"
2044
+ },
2045
+ "package": {
2046
+ "char": "p",
2047
+ "name": "package",
2048
+ "summary": "ID (starts with 0Ho) or alias of the package to create a version of.",
2049
+ "hasDynamicHelp": false,
1955
2050
  "multiple": false,
1956
2051
  "type": "option"
1957
2052
  },
1958
- "api-version": {
2053
+ "path": {
2054
+ "char": "d",
2055
+ "name": "path",
2056
+ "summary": "Path to the directory that contains the contents of the package.",
2057
+ "hasDynamicHelp": false,
2058
+ "multiple": false,
2059
+ "type": "option"
2060
+ },
2061
+ "post-install-script": {
1959
2062
  "aliases": [
1960
- "apiversion"
2063
+ "postinstallscript"
1961
2064
  ],
1962
2065
  "deprecateAliases": true,
1963
- "description": "Override the api version used for api requests made by this command",
1964
- "name": "api-version",
2066
+ "description": "The post-install script is an Apex class within this package that is run in the installing org after installations or upgrades of this package version.",
2067
+ "name": "post-install-script",
2068
+ "summary": "Name of the post-install script; applies to managed packages only.",
1965
2069
  "hasDynamicHelp": false,
1966
2070
  "multiple": false,
1967
2071
  "type": "option"
1968
2072
  },
1969
- "package-id": {
2073
+ "post-install-url": {
1970
2074
  "aliases": [
1971
- "packageid"
2075
+ "postinstallurl"
1972
2076
  ],
1973
- "char": "i",
1974
2077
  "deprecateAliases": true,
1975
- "name": "package-id",
1976
- "required": true,
1977
- "summary": "ID of the metadata package (starts with 033) of which you’re creating a new version.",
2078
+ "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
2079
+ "name": "post-install-url",
2080
+ "summary": "Post-install instructions URL.",
1978
2081
  "hasDynamicHelp": false,
1979
2082
  "multiple": false,
1980
2083
  "type": "option"
1981
2084
  },
1982
- "name": {
1983
- "char": "n",
1984
- "name": "name",
1985
- "required": true,
1986
- "summary": "Package version name.",
2085
+ "preserve": {
2086
+ "char": "r",
2087
+ "hidden": true,
2088
+ "name": "preserve",
2089
+ "summary": "Preserve temp files that would otherwise be deleted.",
2090
+ "allowNo": false,
2091
+ "type": "boolean"
2092
+ },
2093
+ "releasenotes-url": {
2094
+ "aliases": [
2095
+ "releasenotesurl"
2096
+ ],
2097
+ "deprecateAliases": true,
2098
+ "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
2099
+ "name": "releasenotes-url",
2100
+ "summary": "Release notes URL.",
1987
2101
  "hasDynamicHelp": false,
1988
2102
  "multiple": false,
1989
2103
  "type": "option"
1990
2104
  },
1991
- "description": {
1992
- "char": "d",
1993
- "name": "description",
1994
- "summary": "Package version description.",
2105
+ "skip-ancestor-check": {
2106
+ "aliases": [
2107
+ "skipancestorcheck"
2108
+ ],
2109
+ "deprecateAliases": true,
2110
+ "name": "skip-ancestor-check",
2111
+ "summary": "Overrides ancestry requirements, which allows you to specify a package ancestor that isn’t the highest released package version.",
2112
+ "allowNo": false,
2113
+ "type": "boolean"
2114
+ },
2115
+ "skip-validation": {
2116
+ "aliases": [
2117
+ "skipvalidation"
2118
+ ],
2119
+ "deprecateAliases": true,
2120
+ "description": "Skips validation of dependencies, package ancestors, and metadata during package version creation. Skipping validation reduces the time it takes to create a new package version, but you can promote only validated package versions. Skipping validation can suppress important errors that can surface at a later stage. You can specify skip validation or code coverage, but not both. Code coverage is calculated during validation.",
2121
+ "exclusive": [
2122
+ "code-coverage",
2123
+ "async-validation"
2124
+ ],
2125
+ "name": "skip-validation",
2126
+ "summary": "Skip validation during package version creation; you can’t promote unvalidated package versions.",
2127
+ "allowNo": false,
2128
+ "type": "boolean"
2129
+ },
2130
+ "async-validation": {
2131
+ "description": "Specifying async validation returns the package version earlier in the process, allowing you to install and test the new version right away. If your development team is using continuous integration (CI) scripts, async validation can reduce your overall CI run time.",
2132
+ "exclusive": [
2133
+ "skip-validation"
2134
+ ],
2135
+ "name": "async-validation",
2136
+ "summary": "Return a new package version before completing package validations.",
2137
+ "allowNo": false,
2138
+ "type": "boolean"
2139
+ },
2140
+ "tag": {
2141
+ "char": "t",
2142
+ "name": "tag",
2143
+ "summary": "Package version’s tag.",
1995
2144
  "hasDynamicHelp": false,
1996
2145
  "multiple": false,
1997
2146
  "type": "option"
1998
2147
  },
1999
- "version": {
2000
- "char": "v",
2001
- "name": "version",
2002
- "summary": "Package version in major.minor format, for example, 3.2.",
2148
+ "uninstall-script": {
2149
+ "aliases": [
2150
+ "uninstallscript"
2151
+ ],
2152
+ "deprecateAliases": true,
2153
+ "description": "The uninstall script is an Apex class within this package that is run in the installing org after uninstallations of this package.",
2154
+ "name": "uninstall-script",
2155
+ "summary": "Uninstall script name; applies to managed packages only.",
2003
2156
  "hasDynamicHelp": false,
2004
2157
  "multiple": false,
2005
2158
  "type": "option"
2006
2159
  },
2007
- "managed-released": {
2160
+ "validate-schema": {
2008
2161
  "aliases": [
2009
- "managedrelease"
2162
+ "validateschema"
2010
2163
  ],
2011
- "char": "m",
2164
+ "char": "j",
2012
2165
  "deprecateAliases": true,
2013
- "description": "To create a beta version, don’t include this parameter.",
2014
- "name": "managed-released",
2015
- "summary": "Create a managed package version.",
2166
+ "hidden": true,
2167
+ "name": "validate-schema",
2168
+ "summary": "Validate the sfdx-project.json file against the JSON schema.",
2016
2169
  "allowNo": false,
2017
2170
  "type": "boolean"
2018
2171
  },
2019
- "release-notes-url": {
2172
+ "version-description": {
2020
2173
  "aliases": [
2021
- "releasenotesurl"
2174
+ "versiondescription"
2022
2175
  ],
2023
- "char": "r",
2176
+ "char": "e",
2024
2177
  "deprecateAliases": true,
2025
- "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
2026
- "name": "release-notes-url",
2027
- "summary": "Release notes URL.",
2178
+ "name": "version-description",
2179
+ "summary": "Description of the package version to be created; overrides the sfdx-project.json value.",
2028
2180
  "hasDynamicHelp": false,
2029
2181
  "multiple": false,
2030
2182
  "type": "option"
2031
2183
  },
2032
- "post-install-url": {
2184
+ "version-name": {
2033
2185
  "aliases": [
2034
- "postinstallurl"
2186
+ "versionname"
2035
2187
  ],
2036
- "char": "p",
2188
+ "char": "a",
2037
2189
  "deprecateAliases": true,
2038
- "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
2039
- "name": "post-install-url",
2040
- "summary": "Post install URL.",
2190
+ "name": "version-name",
2191
+ "summary": "Name of the package version to be created; overrides the sfdx-project.json value.",
2041
2192
  "hasDynamicHelp": false,
2042
2193
  "multiple": false,
2043
2194
  "type": "option"
2044
2195
  },
2045
- "installation-key": {
2196
+ "version-number": {
2046
2197
  "aliases": [
2047
- "installationkey"
2198
+ "versionnumber"
2048
2199
  ],
2049
- "char": "k",
2200
+ "char": "n",
2050
2201
  "deprecateAliases": true,
2051
- "name": "installation-key",
2052
- "summary": "Installation key for key-protected package (default: null).",
2202
+ "description": "For information about the format of the version number, see https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/sfdx_dev2gp_config_file.htm.",
2203
+ "name": "version-number",
2204
+ "summary": "Version number of the package version to be created; overrides the sfdx-project.json value.",
2053
2205
  "hasDynamicHelp": false,
2054
2206
  "multiple": false,
2055
2207
  "type": "option"
@@ -2057,73 +2209,90 @@
2057
2209
  "wait": {
2058
2210
  "char": "w",
2059
2211
  "name": "wait",
2060
- "summary": "Minutes to wait for the package version to be created (default: 2 minutes).",
2212
+ "summary": "Number of minutes to wait for the package version to be created.",
2061
2213
  "hasDynamicHelp": true,
2062
2214
  "multiple": false,
2063
2215
  "type": "option"
2216
+ },
2217
+ "language": {
2218
+ "description": "Specify the language using a language code listed under \"Supported Languages\" in Salesforce Help. If no language is specified, the language defaults to the language of the Dev Hub user who created the package.",
2219
+ "name": "language",
2220
+ "summary": "Language for the package.",
2221
+ "hasDynamicHelp": false,
2222
+ "multiple": false,
2223
+ "type": "option"
2224
+ },
2225
+ "verbose": {
2226
+ "description": "Display verbose command output. When polling for the status of the creation, this will output status and timeout data on a separate line for each poll request, which is useful in CI systems where timeouts can occur with long periods of no output from commands.",
2227
+ "name": "verbose",
2228
+ "summary": "Display verbose command output.",
2229
+ "allowNo": false,
2230
+ "type": "boolean"
2064
2231
  }
2065
2232
  },
2066
2233
  "hasDynamicHelp": true,
2067
2234
  "hiddenAliases": [],
2068
- "id": "package1:version:create",
2235
+ "id": "package:version:create",
2069
2236
  "pluginAlias": "@salesforce/plugin-packaging",
2070
2237
  "pluginName": "@salesforce/plugin-packaging",
2071
2238
  "pluginType": "core",
2072
2239
  "strict": true,
2073
- "summary": "Create a first-generation package version in the release org.",
2240
+ "summary": "Create a package version in the Dev Hub org.",
2074
2241
  "enableJsonFlag": true,
2242
+ "requiresProject": true,
2075
2243
  "isESM": true,
2076
2244
  "relativePath": [
2077
2245
  "lib",
2078
2246
  "commands",
2079
- "package1",
2247
+ "package",
2080
2248
  "version",
2081
2249
  "create.js"
2082
2250
  ],
2083
2251
  "aliasPermutations": [
2084
- "force:package1:version:create",
2085
- "package1:force:version:create",
2086
- "package1:version:force:create",
2087
- "package1:version:create:force",
2088
- "force:version:package1:create",
2089
- "version:force:package1:create",
2090
- "version:package1:force:create",
2091
- "version:package1:create:force",
2092
- "force:version:create:package1",
2093
- "version:force:create:package1",
2094
- "version:create:force:package1",
2095
- "version:create:package1:force",
2096
- "force:package1:create:version",
2097
- "package1:force:create:version",
2098
- "package1:create:force:version",
2099
- "package1:create:version:force",
2100
- "force:create:package1:version",
2101
- "create:force:package1:version",
2102
- "create:package1:force:version",
2103
- "create:package1:version:force",
2104
- "force:create:version:package1",
2105
- "create:force:version:package1",
2106
- "create:version:force:package1",
2107
- "create:version:package1:force"
2252
+ "force:package:version:create",
2253
+ "package:force:version:create",
2254
+ "package:version:force:create",
2255
+ "package:version:create:force",
2256
+ "force:version:package:create",
2257
+ "version:force:package:create",
2258
+ "version:package:force:create",
2259
+ "version:package:create:force",
2260
+ "force:version:create:package",
2261
+ "version:force:create:package",
2262
+ "version:create:force:package",
2263
+ "version:create:package:force",
2264
+ "force:package:create:version",
2265
+ "package:force:create:version",
2266
+ "package:create:force:version",
2267
+ "package:create:version:force",
2268
+ "force:create:package:version",
2269
+ "create:force:package:version",
2270
+ "create:package:force:version",
2271
+ "create:package:version:force",
2272
+ "force:create:version:package",
2273
+ "create:force:version:package",
2274
+ "create:version:force:package",
2275
+ "create:version:package:force"
2108
2276
  ],
2109
2277
  "permutations": [
2110
- "package1:version:create",
2111
- "version:package1:create",
2112
- "version:create:package1",
2113
- "package1:create:version",
2114
- "create:package1:version",
2115
- "create:version:package1"
2278
+ "package:version:create",
2279
+ "version:package:create",
2280
+ "version:create:package",
2281
+ "package:create:version",
2282
+ "create:package:version",
2283
+ "create:version:package"
2116
2284
  ]
2117
2285
  },
2118
- "package1:version:display": {
2286
+ "package:version:delete": {
2119
2287
  "aliases": [
2120
- "force:package1:version:display"
2288
+ "force:package:version:delete"
2121
2289
  ],
2122
2290
  "args": {},
2123
2291
  "deprecateAliases": true,
2292
+ "description": "Specify the ID or alias of the package version you want to delete. In second-generation managed packaging, only beta package versions can be deleted. Before deleting a package version, review the considerations outlined in https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/sfdx_dev_dev2gp_package_deletion.htm.",
2124
2293
  "examples": [
2125
- "Display details about the first-generation package version with the specified ID in your default org:\n<%= config.bin %> <%= command.id %> --package-version-id 04t...",
2126
- "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --package-version-id 04t... --target-org myorg@example.com"
2294
+ "Delete a package version with the specified alias using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\"",
2295
+ "Delete a package version with the specified ID using the Dev Hub org with username \"devhub@example.com\":\n<%= config.bin %> <%= command.id %> --package 04t... --target-org devhub@example.com"
2127
2296
  ],
2128
2297
  "flags": {
2129
2298
  "json": {
@@ -2151,17 +2320,17 @@
2151
2320
  "multiple": false,
2152
2321
  "type": "option"
2153
2322
  },
2154
- "target-org": {
2323
+ "target-dev-hub": {
2155
2324
  "aliases": [
2156
- "targetusername",
2157
- "u"
2325
+ "targetdevhubusername",
2326
+ "target-hub-org"
2158
2327
  ],
2159
- "char": "o",
2328
+ "char": "v",
2160
2329
  "deprecateAliases": true,
2161
- "name": "target-org",
2330
+ "name": "target-dev-hub",
2162
2331
  "noCacheDefault": true,
2163
2332
  "required": true,
2164
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2333
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
2165
2334
  "hasDynamicHelp": true,
2166
2335
  "multiple": false,
2167
2336
  "type": "option"
@@ -2177,81 +2346,97 @@
2177
2346
  "multiple": false,
2178
2347
  "type": "option"
2179
2348
  },
2180
- "package-version-id": {
2349
+ "no-prompt": {
2181
2350
  "aliases": [
2182
- "packageversionid"
2351
+ "noprompt"
2183
2352
  ],
2184
- "char": "i",
2353
+ "char": "n",
2185
2354
  "deprecateAliases": true,
2186
- "name": "package-version-id",
2355
+ "name": "no-prompt",
2356
+ "summary": "Don’t prompt before deleting the package version.",
2357
+ "allowNo": false,
2358
+ "type": "boolean"
2359
+ },
2360
+ "package": {
2361
+ "char": "p",
2362
+ "name": "package",
2187
2363
  "required": true,
2188
- "summary": "ID (starts with 04t) of the metadata package version whose details you want to display.",
2364
+ "summary": "ID (starts with 04t) or alias of the package version to delete.",
2189
2365
  "hasDynamicHelp": false,
2190
2366
  "multiple": false,
2191
2367
  "type": "option"
2368
+ },
2369
+ "undelete": {
2370
+ "hidden": true,
2371
+ "name": "undelete",
2372
+ "summary": "Undelete a deleted package version.",
2373
+ "allowNo": false,
2374
+ "type": "boolean"
2192
2375
  }
2193
2376
  },
2194
2377
  "hasDynamicHelp": true,
2195
2378
  "hiddenAliases": [],
2196
- "id": "package1:version:display",
2379
+ "id": "package:version:delete",
2197
2380
  "pluginAlias": "@salesforce/plugin-packaging",
2198
2381
  "pluginName": "@salesforce/plugin-packaging",
2199
2382
  "pluginType": "core",
2200
2383
  "strict": true,
2201
- "summary": "Display details about a first-generation package version.",
2384
+ "summary": "Delete a package version.",
2202
2385
  "enableJsonFlag": true,
2203
2386
  "isESM": true,
2204
2387
  "relativePath": [
2205
2388
  "lib",
2206
2389
  "commands",
2207
- "package1",
2390
+ "package",
2208
2391
  "version",
2209
- "display.js"
2392
+ "delete.js"
2210
2393
  ],
2211
2394
  "aliasPermutations": [
2212
- "force:package1:version:display",
2213
- "package1:force:version:display",
2214
- "package1:version:force:display",
2215
- "package1:version:display:force",
2216
- "force:version:package1:display",
2217
- "version:force:package1:display",
2218
- "version:package1:force:display",
2219
- "version:package1:display:force",
2220
- "force:version:display:package1",
2221
- "version:force:display:package1",
2222
- "version:display:force:package1",
2223
- "version:display:package1:force",
2224
- "force:package1:display:version",
2225
- "package1:force:display:version",
2226
- "package1:display:force:version",
2227
- "package1:display:version:force",
2228
- "force:display:package1:version",
2229
- "display:force:package1:version",
2230
- "display:package1:force:version",
2231
- "display:package1:version:force",
2232
- "force:display:version:package1",
2233
- "display:force:version:package1",
2234
- "display:version:force:package1",
2235
- "display:version:package1:force"
2395
+ "force:package:version:delete",
2396
+ "package:force:version:delete",
2397
+ "package:version:force:delete",
2398
+ "package:version:delete:force",
2399
+ "force:version:package:delete",
2400
+ "version:force:package:delete",
2401
+ "version:package:force:delete",
2402
+ "version:package:delete:force",
2403
+ "force:version:delete:package",
2404
+ "version:force:delete:package",
2405
+ "version:delete:force:package",
2406
+ "version:delete:package:force",
2407
+ "force:package:delete:version",
2408
+ "package:force:delete:version",
2409
+ "package:delete:force:version",
2410
+ "package:delete:version:force",
2411
+ "force:delete:package:version",
2412
+ "delete:force:package:version",
2413
+ "delete:package:force:version",
2414
+ "delete:package:version:force",
2415
+ "force:delete:version:package",
2416
+ "delete:force:version:package",
2417
+ "delete:version:force:package",
2418
+ "delete:version:package:force"
2236
2419
  ],
2237
2420
  "permutations": [
2238
- "package1:version:display",
2239
- "version:package1:display",
2240
- "version:display:package1",
2241
- "package1:display:version",
2242
- "display:package1:version",
2243
- "display:version:package1"
2421
+ "package:version:delete",
2422
+ "version:package:delete",
2423
+ "version:delete:package",
2424
+ "package:delete:version",
2425
+ "delete:package:version",
2426
+ "delete:version:package"
2244
2427
  ]
2245
2428
  },
2246
- "package1:version:list": {
2429
+ "package:version:displayancestry": {
2247
2430
  "aliases": [
2248
- "force:package1:version:list"
2431
+ "force:package:version:displayancestry"
2249
2432
  ],
2250
2433
  "args": {},
2251
2434
  "deprecateAliases": true,
2252
2435
  "examples": [
2253
- "List all first-generation package versions in your default org:\n<%= config.bin %> <%= command.id %>",
2254
- "List package versions for the specified first-generation package in the specifief org:\n<%= config.bin %> <%= command.id %> --package-id 033... --target-org myorg@example.com"
2436
+ "Display the ancestry tree for a package version with the specified alias, using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package package_version_alias",
2437
+ "Similar to previous example, but display the output in DOT code:\n<%= config.bin %> <%= command.id %> --package package_version_alias --dot-code",
2438
+ "Display the ancestry tree for a package with the specified ID, using the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package OHo... --target-dev-hub devhub@example.com",
2439
+ "Display the ancestry tree of a package version with the specified ID, using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t..."
2255
2440
  ],
2256
2441
  "flags": {
2257
2442
  "json": {
@@ -2279,17 +2464,17 @@
2279
2464
  "multiple": false,
2280
2465
  "type": "option"
2281
2466
  },
2282
- "target-org": {
2467
+ "target-dev-hub": {
2283
2468
  "aliases": [
2284
- "targetusername",
2285
- "u"
2469
+ "targetdevhubusername",
2470
+ "target-hub-org"
2286
2471
  ],
2287
- "char": "o",
2472
+ "char": "v",
2288
2473
  "deprecateAliases": true,
2289
- "name": "target-org",
2474
+ "name": "target-dev-hub",
2290
2475
  "noCacheDefault": true,
2291
2476
  "required": true,
2292
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2477
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
2293
2478
  "hasDynamicHelp": true,
2294
2479
  "multiple": false,
2295
2480
  "type": "option"
@@ -2305,462 +2490,219 @@
2305
2490
  "multiple": false,
2306
2491
  "type": "option"
2307
2492
  },
2308
- "package-id": {
2309
- "aliases": [
2310
- "packageid"
2311
- ],
2312
- "char": "i",
2313
- "deprecateAliases": true,
2314
- "description": "If not specified, shows all versions for all packages (managed and unmanaged) in the org.",
2315
- "name": "package-id",
2316
- "summary": "Metadata package ID (starts with 033) whose package versions you want to list.",
2493
+ "package": {
2494
+ "char": "p",
2495
+ "description": "If you specify a package ID (starts with 0Ho) or alias, the ancestor tree for every package version associated with the package ID is displayed. If you specify a package version (starts with 04t) or alias, the ancestry tree of the specified package version is displayed.",
2496
+ "name": "package",
2497
+ "required": true,
2498
+ "summary": "ID or alias of the package (starts with 0Ho) or package version (starts with 04t) to display ancestry for.",
2317
2499
  "hasDynamicHelp": false,
2318
2500
  "multiple": false,
2319
2501
  "type": "option"
2502
+ },
2503
+ "dot-code": {
2504
+ "aliases": [
2505
+ "dotcode"
2506
+ ],
2507
+ "deprecateAliases": true,
2508
+ "description": "You can use the DOT code output in graph visualization software to create tree visualizations.",
2509
+ "name": "dot-code",
2510
+ "summary": "Display the ancestry tree in DOT code.",
2511
+ "allowNo": false,
2512
+ "type": "boolean"
2513
+ },
2514
+ "verbose": {
2515
+ "name": "verbose",
2516
+ "summary": "Display both the package version ID (starts with 04t) and the version number (major.minor.patch.build) in the ancestry tree.",
2517
+ "allowNo": false,
2518
+ "type": "boolean"
2320
2519
  }
2321
2520
  },
2322
2521
  "hasDynamicHelp": true,
2323
2522
  "hiddenAliases": [],
2324
- "id": "package1:version:list",
2523
+ "id": "package:version:displayancestry",
2325
2524
  "pluginAlias": "@salesforce/plugin-packaging",
2326
2525
  "pluginName": "@salesforce/plugin-packaging",
2327
2526
  "pluginType": "core",
2328
2527
  "strict": true,
2329
- "summary": "List package versions for the specified first-generation package or for the org.",
2528
+ "summary": "Display the ancestry tree for a 2GP managed package version.",
2330
2529
  "enableJsonFlag": true,
2331
2530
  "isESM": true,
2332
2531
  "relativePath": [
2333
2532
  "lib",
2334
2533
  "commands",
2335
- "package1",
2534
+ "package",
2336
2535
  "version",
2337
- "list.js"
2536
+ "displayancestry.js"
2338
2537
  ],
2339
2538
  "aliasPermutations": [
2340
- "force:package1:version:list",
2341
- "package1:force:version:list",
2342
- "package1:version:force:list",
2343
- "package1:version:list:force",
2344
- "force:version:package1:list",
2345
- "version:force:package1:list",
2346
- "version:package1:force:list",
2347
- "version:package1:list:force",
2348
- "force:version:list:package1",
2349
- "version:force:list:package1",
2350
- "version:list:force:package1",
2351
- "version:list:package1:force",
2352
- "force:package1:list:version",
2353
- "package1:force:list:version",
2354
- "package1:list:force:version",
2355
- "package1:list:version:force",
2356
- "force:list:package1:version",
2357
- "list:force:package1:version",
2358
- "list:package1:force:version",
2359
- "list:package1:version:force",
2360
- "force:list:version:package1",
2361
- "list:force:version:package1",
2362
- "list:version:force:package1",
2363
- "list:version:package1:force"
2364
- ],
2365
- "permutations": [
2366
- "package1:version:list",
2367
- "version:package1:list",
2368
- "version:list:package1",
2369
- "package1:list:version",
2370
- "list:package1:version",
2371
- "list:version:package1"
2372
- ]
2373
- },
2374
- "package:version:create": {
2375
- "aliases": [
2376
- "force:package:version:create"
2377
- ],
2378
- "args": {},
2539
+ "force:package:version:displayancestry",
2540
+ "package:force:version:displayancestry",
2541
+ "package:version:force:displayancestry",
2542
+ "package:version:displayancestry:force",
2543
+ "force:version:package:displayancestry",
2544
+ "version:force:package:displayancestry",
2545
+ "version:package:force:displayancestry",
2546
+ "version:package:displayancestry:force",
2547
+ "force:version:displayancestry:package",
2548
+ "version:force:displayancestry:package",
2549
+ "version:displayancestry:force:package",
2550
+ "version:displayancestry:package:force",
2551
+ "force:package:displayancestry:version",
2552
+ "package:force:displayancestry:version",
2553
+ "package:displayancestry:force:version",
2554
+ "package:displayancestry:version:force",
2555
+ "force:displayancestry:package:version",
2556
+ "displayancestry:force:package:version",
2557
+ "displayancestry:package:force:version",
2558
+ "displayancestry:package:version:force",
2559
+ "force:displayancestry:version:package",
2560
+ "displayancestry:force:version:package",
2561
+ "displayancestry:version:force:package",
2562
+ "displayancestry:version:package:force"
2563
+ ],
2564
+ "permutations": [
2565
+ "package:version:displayancestry",
2566
+ "version:package:displayancestry",
2567
+ "version:displayancestry:package",
2568
+ "package:displayancestry:version",
2569
+ "displayancestry:package:version",
2570
+ "displayancestry:version:package"
2571
+ ]
2572
+ },
2573
+ "package:version:displaydependencies": {
2574
+ "aliases": [],
2575
+ "args": {},
2379
2576
  "deprecateAliases": true,
2380
- "description": "The package version is based on the package contents in the specified directory.\n\nTo retrieve details about a package version create request, including status and package version ID (04t), run \"<%= config.bin %> package version create report -i 08c...\".\n\nWe recommend that you specify the --installation-key parameter to protect the contents of your package and to prevent unauthorized installation of your package.\n\nTo list package version creation requests in the org, run \"<%= config.bin %> package version create list\".\nTo promote a package version to released, you must use the --code-coverage parameter. The package must also meet the code coverage requirements. This requirement applies to both managed and unlocked packages.\n\nWe don’t calculate code coverage for org-dependent unlocked packages, or for package versions that specify --skip-validation.",
2381
2577
  "examples": [
2382
- "Create a package version from the contents of the \"common\" directory and give it an installation key of \"password123\"; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123",
2383
- "Create a package version from a package with the specified alias; uses the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\" --installation-key password123 --target-dev-hub devhub@example.com",
2384
- "Create a package version from a package with the specified ID:\n<%= config.bin %> <%= command.id %> --package 0Ho... --installation-key password123",
2385
- "Create a package version and skip the validation step:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --skip-validation",
2386
- "Create a package version and perform package validations asynchronously:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --async-validation"
2578
+ "Display the dependency graph for a package version with the specified alias, using your default Dev Hub org and the default edge-direction:\n<%= config.bin %> <%= command.id %> --package package_version_alias",
2579
+ "Display the dependency graph for a package version with the specified ID and display the graph using a root-last edge direction. Use the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package 04t... --edge-direction root-last --target-dev-hub devhub@example.com",
2580
+ "Display the dependency graph of a version create request with the specified ID, using your default Dev Hub org and the default edge-direction:\n<%= config.bin %> <%= command.id %> --package 08c..."
2387
2581
  ],
2388
- "flags": {
2389
- "json": {
2390
- "description": "Format output as json.",
2391
- "helpGroup": "GLOBAL",
2392
- "name": "json",
2393
- "allowNo": false,
2394
- "type": "boolean"
2395
- },
2396
- "flags-dir": {
2397
- "helpGroup": "GLOBAL",
2398
- "name": "flags-dir",
2399
- "summary": "Import flag values from a directory.",
2400
- "hasDynamicHelp": false,
2401
- "multiple": false,
2402
- "type": "option"
2403
- },
2404
- "loglevel": {
2405
- "deprecated": {
2406
- "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
2407
- },
2408
- "hidden": true,
2409
- "name": "loglevel",
2410
- "hasDynamicHelp": false,
2411
- "multiple": false,
2412
- "type": "option"
2413
- },
2414
- "target-dev-hub": {
2415
- "aliases": [
2416
- "targetdevhubusername",
2417
- "target-hub-org"
2418
- ],
2419
- "char": "v",
2420
- "deprecateAliases": true,
2421
- "name": "target-dev-hub",
2422
- "noCacheDefault": true,
2423
- "required": true,
2424
- "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
2425
- "hasDynamicHelp": true,
2426
- "multiple": false,
2427
- "type": "option"
2428
- },
2429
- "api-version": {
2430
- "aliases": [
2431
- "apiversion"
2432
- ],
2433
- "deprecateAliases": true,
2434
- "description": "Override the api version used for api requests made by this command",
2435
- "name": "api-version",
2436
- "hasDynamicHelp": false,
2437
- "multiple": false,
2438
- "type": "option"
2439
- },
2440
- "branch": {
2441
- "char": "b",
2442
- "name": "branch",
2443
- "summary": "Name of the branch in your source control system that the package version is based on.",
2444
- "hasDynamicHelp": false,
2445
- "multiple": false,
2446
- "type": "option"
2447
- },
2448
- "build-instance": {
2449
- "aliases": [
2450
- "buildinstance"
2451
- ],
2452
- "char": "s",
2453
- "deprecateAliases": true,
2454
- "hidden": true,
2455
- "name": "build-instance",
2456
- "summary": "Instance where the package version will be created, such as NA50.",
2457
- "hasDynamicHelp": false,
2458
- "multiple": false,
2459
- "type": "option"
2460
- },
2461
- "code-coverage": {
2462
- "aliases": [
2463
- "codecoverage"
2464
- ],
2465
- "char": "c",
2466
- "deprecateAliases": true,
2467
- "description": "Before you can promote and release a managed or unlocked package version, the Apex code must meet a minimum 75% code coverage requirement. We don’t calculate code coverage for org-dependent unlocked packages or for package versions that specify --skip-validation.",
2468
- "exclusive": [
2469
- "skip-validation"
2470
- ],
2471
- "name": "code-coverage",
2472
- "summary": "Calculate and store the code coverage percentage by running the packaged Apex tests included in this package version.",
2473
- "allowNo": false,
2474
- "type": "boolean"
2475
- },
2476
- "definition-file": {
2477
- "aliases": [
2478
- "definitionfile"
2479
- ],
2480
- "char": "f",
2481
- "deprecateAliases": true,
2482
- "description": "For a patch version, the features specified in this file are ignored, and instead the features specified for the ancestor version are used.",
2483
- "name": "definition-file",
2484
- "summary": "Path to a definition file similar to scratch org definition file that contains the list of features and org preferences that the metadata of the package version depends on.",
2485
- "hasDynamicHelp": false,
2486
- "multiple": false,
2487
- "type": "option"
2488
- },
2489
- "installation-key": {
2490
- "aliases": [
2491
- "installationkey"
2492
- ],
2493
- "char": "k",
2494
- "deprecateAliases": true,
2495
- "name": "installation-key",
2496
- "summary": "Installation key for key-protected package. (either --installation-key or --installation-key-bypass is required)",
2497
- "hasDynamicHelp": false,
2498
- "multiple": false,
2499
- "type": "option"
2500
- },
2501
- "installation-key-bypass": {
2502
- "aliases": [
2503
- "installationkeybypass"
2504
- ],
2505
- "char": "x",
2506
- "deprecateAliases": true,
2507
- "description": "If you bypass this requirement, anyone can install your package.",
2508
- "name": "installation-key-bypass",
2509
- "summary": "Bypass the installation key requirement. (either --installation-key or --installation-key-bypass is required)",
2510
- "allowNo": false,
2511
- "type": "boolean"
2512
- },
2513
- "package": {
2514
- "char": "p",
2515
- "name": "package",
2516
- "summary": "ID (starts with 0Ho) or alias of the package to create a version of.",
2517
- "hasDynamicHelp": false,
2518
- "multiple": false,
2519
- "type": "option"
2520
- },
2521
- "path": {
2522
- "char": "d",
2523
- "name": "path",
2524
- "summary": "Path to the directory that contains the contents of the package.",
2525
- "hasDynamicHelp": false,
2526
- "multiple": false,
2527
- "type": "option"
2528
- },
2529
- "post-install-script": {
2530
- "aliases": [
2531
- "postinstallscript"
2532
- ],
2533
- "deprecateAliases": true,
2534
- "description": "The post-install script is an Apex class within this package that is run in the installing org after installations or upgrades of this package version.",
2535
- "name": "post-install-script",
2536
- "summary": "Name of the post-install script; applies to managed packages only.",
2537
- "hasDynamicHelp": false,
2538
- "multiple": false,
2539
- "type": "option"
2540
- },
2541
- "post-install-url": {
2542
- "aliases": [
2543
- "postinstallurl"
2544
- ],
2545
- "deprecateAliases": true,
2546
- "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
2547
- "name": "post-install-url",
2548
- "summary": "Post-install instructions URL.",
2549
- "hasDynamicHelp": false,
2550
- "multiple": false,
2551
- "type": "option"
2552
- },
2553
- "preserve": {
2554
- "char": "r",
2555
- "hidden": true,
2556
- "name": "preserve",
2557
- "summary": "Preserve temp files that would otherwise be deleted.",
2558
- "allowNo": false,
2559
- "type": "boolean"
2560
- },
2561
- "releasenotes-url": {
2562
- "aliases": [
2563
- "releasenotesurl"
2564
- ],
2565
- "deprecateAliases": true,
2566
- "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
2567
- "name": "releasenotes-url",
2568
- "summary": "Release notes URL.",
2569
- "hasDynamicHelp": false,
2570
- "multiple": false,
2571
- "type": "option"
2572
- },
2573
- "skip-ancestor-check": {
2574
- "aliases": [
2575
- "skipancestorcheck"
2576
- ],
2577
- "deprecateAliases": true,
2578
- "name": "skip-ancestor-check",
2579
- "summary": "Overrides ancestry requirements, which allows you to specify a package ancestor that isn’t the highest released package version.",
2580
- "allowNo": false,
2581
- "type": "boolean"
2582
- },
2583
- "skip-validation": {
2584
- "aliases": [
2585
- "skipvalidation"
2586
- ],
2587
- "deprecateAliases": true,
2588
- "description": "Skips validation of dependencies, package ancestors, and metadata during package version creation. Skipping validation reduces the time it takes to create a new package version, but you can promote only validated package versions. Skipping validation can suppress important errors that can surface at a later stage. You can specify skip validation or code coverage, but not both. Code coverage is calculated during validation.",
2589
- "exclusive": [
2590
- "code-coverage",
2591
- "async-validation"
2592
- ],
2593
- "name": "skip-validation",
2594
- "summary": "Skip validation during package version creation; you can’t promote unvalidated package versions.",
2595
- "allowNo": false,
2596
- "type": "boolean"
2597
- },
2598
- "async-validation": {
2599
- "description": "Specifying async validation returns the package version earlier in the process, allowing you to install and test the new version right away. If your development team is using continuous integration (CI) scripts, async validation can reduce your overall CI run time.",
2600
- "exclusive": [
2601
- "skip-validation"
2602
- ],
2603
- "name": "async-validation",
2604
- "summary": "Return a new package version before completing package validations.",
2605
- "allowNo": false,
2606
- "type": "boolean"
2607
- },
2608
- "tag": {
2609
- "char": "t",
2610
- "name": "tag",
2611
- "summary": "Package version’s tag.",
2612
- "hasDynamicHelp": false,
2613
- "multiple": false,
2614
- "type": "option"
2582
+ "flags": {
2583
+ "json": {
2584
+ "description": "Format output as json.",
2585
+ "helpGroup": "GLOBAL",
2586
+ "name": "json",
2587
+ "allowNo": false,
2588
+ "type": "boolean"
2615
2589
  },
2616
- "uninstall-script": {
2617
- "aliases": [
2618
- "uninstallscript"
2619
- ],
2620
- "deprecateAliases": true,
2621
- "description": "The uninstall script is an Apex class within this package that is run in the installing org after uninstallations of this package.",
2622
- "name": "uninstall-script",
2623
- "summary": "Uninstall script name; applies to managed packages only.",
2590
+ "flags-dir": {
2591
+ "helpGroup": "GLOBAL",
2592
+ "name": "flags-dir",
2593
+ "summary": "Import flag values from a directory.",
2624
2594
  "hasDynamicHelp": false,
2625
2595
  "multiple": false,
2626
2596
  "type": "option"
2627
2597
  },
2628
- "validate-schema": {
2629
- "aliases": [
2630
- "validateschema"
2631
- ],
2632
- "char": "j",
2633
- "deprecateAliases": true,
2598
+ "loglevel": {
2599
+ "deprecated": {
2600
+ "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
2601
+ },
2634
2602
  "hidden": true,
2635
- "name": "validate-schema",
2636
- "summary": "Validate the sfdx-project.json file against the JSON schema.",
2637
- "allowNo": false,
2638
- "type": "boolean"
2639
- },
2640
- "version-description": {
2641
- "aliases": [
2642
- "versiondescription"
2643
- ],
2644
- "char": "e",
2645
- "deprecateAliases": true,
2646
- "name": "version-description",
2647
- "summary": "Description of the package version to be created; overrides the sfdx-project.json value.",
2603
+ "name": "loglevel",
2648
2604
  "hasDynamicHelp": false,
2649
2605
  "multiple": false,
2650
2606
  "type": "option"
2651
2607
  },
2652
- "version-name": {
2608
+ "target-dev-hub": {
2653
2609
  "aliases": [
2654
- "versionname"
2610
+ "targetdevhubusername",
2611
+ "target-hub-org"
2655
2612
  ],
2656
- "char": "a",
2613
+ "char": "v",
2657
2614
  "deprecateAliases": true,
2658
- "name": "version-name",
2659
- "summary": "Name of the package version to be created; overrides the sfdx-project.json value.",
2660
- "hasDynamicHelp": false,
2615
+ "name": "target-dev-hub",
2616
+ "noCacheDefault": true,
2617
+ "required": true,
2618
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
2619
+ "hasDynamicHelp": true,
2661
2620
  "multiple": false,
2662
2621
  "type": "option"
2663
2622
  },
2664
- "version-number": {
2623
+ "api-version": {
2665
2624
  "aliases": [
2666
- "versionnumber"
2625
+ "apiversion"
2667
2626
  ],
2668
- "char": "n",
2669
2627
  "deprecateAliases": true,
2670
- "description": "For information about the format of the version number, see https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/sfdx_dev2gp_config_file.htm.",
2671
- "name": "version-number",
2672
- "summary": "Version number of the package version to be created; overrides the sfdx-project.json value.",
2628
+ "description": "Override the api version used for api requests made by this command",
2629
+ "name": "api-version",
2673
2630
  "hasDynamicHelp": false,
2674
2631
  "multiple": false,
2675
2632
  "type": "option"
2676
2633
  },
2677
- "wait": {
2678
- "char": "w",
2679
- "name": "wait",
2680
- "summary": "Number of minutes to wait for the package version to be created.",
2681
- "hasDynamicHelp": true,
2634
+ "package": {
2635
+ "char": "p",
2636
+ "description": "Before running this command, update your sfdx-project.json file to specify the calculateTransitiveDependencies attribute, and set the value to true. This command returns GraphViz code, which can be compiled to a graph using DOT code or another graph visualization software.",
2637
+ "name": "package",
2638
+ "required": true,
2639
+ "summary": "ID or alias of the package version (starts with 04t) or the package version create request (starts with 08c) to display the dependency graph for.",
2640
+ "hasDynamicHelp": false,
2682
2641
  "multiple": false,
2683
2642
  "type": "option"
2684
2643
  },
2685
- "language": {
2686
- "description": "Specify the language using a language code listed under \"Supported Languages\" in Salesforce Help. If no language is specified, the language defaults to the language of the Dev Hub user who created the package.",
2687
- "name": "language",
2688
- "summary": "Language for the package.",
2644
+ "edge-direction": {
2645
+ "description": "A root-first graph declares the root as the package that must be installed last. A root-last graph is the reverse order of root-first. If you specify \"--edge-direction root-last\", the graph displays the packages in the order they must be installed. The root starts with the farthest leaf of the package dependencies and ends with the base package, which must be installed last.",
2646
+ "name": "edge-direction",
2647
+ "summary": "Order (root-first or root-last) in which the dependencies are displayed.",
2648
+ "default": "root-first",
2689
2649
  "hasDynamicHelp": false,
2690
2650
  "multiple": false,
2651
+ "options": [
2652
+ "root-first",
2653
+ "root-last"
2654
+ ],
2691
2655
  "type": "option"
2692
2656
  },
2693
2657
  "verbose": {
2694
- "description": "Display verbose command output. When polling for the status of the creation, this will output status and timeout data on a separate line for each poll request, which is useful in CI systems where timeouts can occur with long periods of no output from commands.",
2695
2658
  "name": "verbose",
2696
- "summary": "Display verbose command output.",
2659
+ "summary": "Display both the package version ID (starts with 04t) and the version number (major.minor.patch.build) in each node.",
2697
2660
  "allowNo": false,
2698
2661
  "type": "boolean"
2699
2662
  }
2700
2663
  },
2701
2664
  "hasDynamicHelp": true,
2702
2665
  "hiddenAliases": [],
2703
- "id": "package:version:create",
2666
+ "id": "package:version:displaydependencies",
2704
2667
  "pluginAlias": "@salesforce/plugin-packaging",
2705
2668
  "pluginName": "@salesforce/plugin-packaging",
2706
2669
  "pluginType": "core",
2707
2670
  "strict": true,
2708
- "summary": "Create a package version in the Dev Hub org.",
2671
+ "summary": "Display the dependency graph for an unlocked or 2GP managed package version.",
2709
2672
  "enableJsonFlag": true,
2710
- "requiresProject": true,
2711
2673
  "isESM": true,
2712
2674
  "relativePath": [
2713
2675
  "lib",
2714
2676
  "commands",
2715
2677
  "package",
2716
2678
  "version",
2717
- "create.js"
2718
- ],
2719
- "aliasPermutations": [
2720
- "force:package:version:create",
2721
- "package:force:version:create",
2722
- "package:version:force:create",
2723
- "package:version:create:force",
2724
- "force:version:package:create",
2725
- "version:force:package:create",
2726
- "version:package:force:create",
2727
- "version:package:create:force",
2728
- "force:version:create:package",
2729
- "version:force:create:package",
2730
- "version:create:force:package",
2731
- "version:create:package:force",
2732
- "force:package:create:version",
2733
- "package:force:create:version",
2734
- "package:create:force:version",
2735
- "package:create:version:force",
2736
- "force:create:package:version",
2737
- "create:force:package:version",
2738
- "create:package:force:version",
2739
- "create:package:version:force",
2740
- "force:create:version:package",
2741
- "create:force:version:package",
2742
- "create:version:force:package",
2743
- "create:version:package:force"
2679
+ "displaydependencies.js"
2744
2680
  ],
2681
+ "aliasPermutations": [],
2745
2682
  "permutations": [
2746
- "package:version:create",
2747
- "version:package:create",
2748
- "version:create:package",
2749
- "package:create:version",
2750
- "create:package:version",
2751
- "create:version:package"
2683
+ "package:version:displaydependencies",
2684
+ "version:package:displaydependencies",
2685
+ "version:displaydependencies:package",
2686
+ "package:displaydependencies:version",
2687
+ "displaydependencies:package:version",
2688
+ "displaydependencies:version:package"
2752
2689
  ]
2753
2690
  },
2754
- "package:version:delete": {
2691
+ "package:version:list": {
2755
2692
  "aliases": [
2756
- "force:package:version:delete"
2693
+ "force:package:version:list"
2757
2694
  ],
2758
2695
  "args": {},
2759
2696
  "deprecateAliases": true,
2760
- "description": "Specify the ID or alias of the package version you want to delete. In second-generation managed packaging, only beta package versions can be deleted. Before deleting a package version, review the considerations outlined in https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/sfdx_dev_dev2gp_package_deletion.htm.",
2697
+ "description": "Description",
2761
2698
  "examples": [
2762
- "Delete a package version with the specified alias using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\"",
2763
- "Delete a package version with the specified ID using the Dev Hub org with username \"devhub@example.com\":\n<%= config.bin %> <%= command.id %> --package 04t... --target-org devhub@example.com"
2699
+ "List package versions in your default Dev Hub org that were created in the last 3 days; show only the released versions and order the list using the PatchVersion field. Display extended details about each package version:\n<%= config.bin %> <%= command.id %> --verbose --created-last-days 3 --released --order-by PatchVersion",
2700
+ "List the released package versions for the two specified packages that were modified today; use the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --packages 0Ho000000000000,0Ho000000000001 --released --modified-last-days 0 --target-dev-hub devhub@example.com",
2701
+ "List all released package versions in your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --released",
2702
+ "List package versions that were modified today in your default Dev Hub org; show limited details about each one:\n<%= config.bin %> <%= command.id %> --concise --modified-last-days 0",
2703
+ "List package versions that are based on the \"featureA\" branch in your source control system that were modified today in your default Dev Hub org; show limited details about each one:\n<%= config.bin %> <%= command.id %> --concise --modified-last-days 0 --branch featureA",
2704
+ "List released package versions that were created in the last 3 days in your default Dev Hub org; show limited details:\n<%= config.bin %> <%= command.id %> --concise --created-last-days 3 --released",
2705
+ "List released package versions that were modified today for the two packages with specified aliases in your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --packages exp-mgr,exp-mgr-util --released --modified-last-days 0"
2764
2706
  ],
2765
2707
  "flags": {
2766
2708
  "json": {
@@ -2814,42 +2756,92 @@
2814
2756
  "multiple": false,
2815
2757
  "type": "option"
2816
2758
  },
2817
- "no-prompt": {
2759
+ "created-last-days": {
2818
2760
  "aliases": [
2819
- "noprompt"
2761
+ "createdlastdays"
2820
2762
  ],
2821
- "char": "n",
2763
+ "char": "c",
2822
2764
  "deprecateAliases": true,
2823
- "name": "no-prompt",
2824
- "summary": "Don’t prompt before deleting the package version.",
2765
+ "name": "created-last-days",
2766
+ "summary": "Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today.",
2767
+ "hasDynamicHelp": false,
2768
+ "multiple": false,
2769
+ "type": "option"
2770
+ },
2771
+ "concise": {
2772
+ "name": "concise",
2773
+ "summary": "Display limited package version details.",
2825
2774
  "allowNo": false,
2826
2775
  "type": "boolean"
2827
2776
  },
2828
- "package": {
2777
+ "show-conversions-only": {
2778
+ "name": "show-conversions-only",
2779
+ "summary": "Filter the list output to display only converted package version.",
2780
+ "allowNo": false,
2781
+ "type": "boolean"
2782
+ },
2783
+ "modified-last-days": {
2784
+ "aliases": [
2785
+ "modifiedlastdays"
2786
+ ],
2787
+ "char": "m",
2788
+ "deprecateAliases": true,
2789
+ "name": "modified-last-days",
2790
+ "summary": "Number of days since the items were modified, starting at 00:00:00 of first day to now. Use 0 for today.",
2791
+ "hasDynamicHelp": false,
2792
+ "multiple": false,
2793
+ "type": "option"
2794
+ },
2795
+ "packages": {
2829
2796
  "char": "p",
2830
- "name": "package",
2831
- "required": true,
2832
- "summary": "ID (starts with 04t) or alias of the package version to delete.",
2797
+ "name": "packages",
2798
+ "summary": "Comma-delimited list of packages (aliases or 0Ho IDs) to list.",
2833
2799
  "hasDynamicHelp": false,
2834
2800
  "multiple": false,
2835
2801
  "type": "option"
2836
2802
  },
2837
- "undelete": {
2838
- "hidden": true,
2839
- "name": "undelete",
2840
- "summary": "Undelete a deleted package version.",
2803
+ "released": {
2804
+ "char": "r",
2805
+ "name": "released",
2806
+ "summary": "Display released versions only (IsReleased=true).",
2807
+ "allowNo": false,
2808
+ "type": "boolean"
2809
+ },
2810
+ "branch": {
2811
+ "char": "b",
2812
+ "name": "branch",
2813
+ "summary": "Branch in your source control system used to filter the results; only package versions based on the specified branch are listed.",
2814
+ "hasDynamicHelp": false,
2815
+ "multiple": false,
2816
+ "type": "option"
2817
+ },
2818
+ "order-by": {
2819
+ "aliases": [
2820
+ "orderby"
2821
+ ],
2822
+ "char": "o",
2823
+ "deprecateAliases": true,
2824
+ "name": "order-by",
2825
+ "summary": "Package version fields used to order the list.",
2826
+ "hasDynamicHelp": false,
2827
+ "multiple": false,
2828
+ "type": "option"
2829
+ },
2830
+ "verbose": {
2831
+ "name": "verbose",
2832
+ "summary": "Display extended package version details.",
2841
2833
  "allowNo": false,
2842
2834
  "type": "boolean"
2843
2835
  }
2844
2836
  },
2845
2837
  "hasDynamicHelp": true,
2846
2838
  "hiddenAliases": [],
2847
- "id": "package:version:delete",
2839
+ "id": "package:version:list",
2848
2840
  "pluginAlias": "@salesforce/plugin-packaging",
2849
2841
  "pluginName": "@salesforce/plugin-packaging",
2850
2842
  "pluginType": "core",
2851
2843
  "strict": true,
2852
- "summary": "Delete a package version.",
2844
+ "summary": "List all package versions in the Dev Hub org.",
2853
2845
  "enableJsonFlag": true,
2854
2846
  "isESM": true,
2855
2847
  "relativePath": [
@@ -2857,54 +2849,54 @@
2857
2849
  "commands",
2858
2850
  "package",
2859
2851
  "version",
2860
- "delete.js"
2852
+ "list.js"
2861
2853
  ],
2862
2854
  "aliasPermutations": [
2863
- "force:package:version:delete",
2864
- "package:force:version:delete",
2865
- "package:version:force:delete",
2866
- "package:version:delete:force",
2867
- "force:version:package:delete",
2868
- "version:force:package:delete",
2869
- "version:package:force:delete",
2870
- "version:package:delete:force",
2871
- "force:version:delete:package",
2872
- "version:force:delete:package",
2873
- "version:delete:force:package",
2874
- "version:delete:package:force",
2875
- "force:package:delete:version",
2876
- "package:force:delete:version",
2877
- "package:delete:force:version",
2878
- "package:delete:version:force",
2879
- "force:delete:package:version",
2880
- "delete:force:package:version",
2881
- "delete:package:force:version",
2882
- "delete:package:version:force",
2883
- "force:delete:version:package",
2884
- "delete:force:version:package",
2885
- "delete:version:force:package",
2886
- "delete:version:package:force"
2855
+ "force:package:version:list",
2856
+ "package:force:version:list",
2857
+ "package:version:force:list",
2858
+ "package:version:list:force",
2859
+ "force:version:package:list",
2860
+ "version:force:package:list",
2861
+ "version:package:force:list",
2862
+ "version:package:list:force",
2863
+ "force:version:list:package",
2864
+ "version:force:list:package",
2865
+ "version:list:force:package",
2866
+ "version:list:package:force",
2867
+ "force:package:list:version",
2868
+ "package:force:list:version",
2869
+ "package:list:force:version",
2870
+ "package:list:version:force",
2871
+ "force:list:package:version",
2872
+ "list:force:package:version",
2873
+ "list:package:force:version",
2874
+ "list:package:version:force",
2875
+ "force:list:version:package",
2876
+ "list:force:version:package",
2877
+ "list:version:force:package",
2878
+ "list:version:package:force"
2887
2879
  ],
2888
2880
  "permutations": [
2889
- "package:version:delete",
2890
- "version:package:delete",
2891
- "version:delete:package",
2892
- "package:delete:version",
2893
- "delete:package:version",
2894
- "delete:version:package"
2881
+ "package:version:list",
2882
+ "version:package:list",
2883
+ "version:list:package",
2884
+ "package:list:version",
2885
+ "list:package:version",
2886
+ "list:version:package"
2895
2887
  ]
2896
2888
  },
2897
- "package:version:displayancestry": {
2889
+ "package:version:promote": {
2898
2890
  "aliases": [
2899
- "force:package:version:displayancestry"
2891
+ "force:package:version:promote"
2900
2892
  ],
2901
2893
  "args": {},
2902
2894
  "deprecateAliases": true,
2895
+ "description": "Supply the ID or alias of the package version you want to promote. Promotes the package version to released status.",
2903
2896
  "examples": [
2904
- "Display the ancestry tree for a package version with the specified alias, using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package package_version_alias",
2905
- "Similar to previous example, but display the output in DOT code:\n<%= config.bin %> <%= command.id %> --package package_version_alias --dot-code",
2906
- "Display the ancestry tree for a package with the specified ID, using the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package OHo... --target-dev-hub devhub@example.com",
2907
- "Display the ancestry tree of a package version with the specified ID, using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t..."
2897
+ "Promote the package version with the specified ID to released; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
2898
+ "Promote the package version with the specified alias to released; uses the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package awesome_package_alias --target-dev-hub devhub@example.com",
2899
+ "Promote the package version with an alias that has spaces to released:\n<%= config.bin %> <%= command.id %> --package \"Awesome Package Alias\""
2908
2900
  ],
2909
2901
  "flags": {
2910
2902
  "json": {
@@ -2960,40 +2952,33 @@
2960
2952
  },
2961
2953
  "package": {
2962
2954
  "char": "p",
2963
- "description": "If you specify a package ID (starts with 0Ho) or alias, the ancestor tree for every package version associated with the package ID is displayed. If you specify a package version (starts with 04t) or alias, the ancestry tree of the specified package version is displayed.",
2964
2955
  "name": "package",
2965
2956
  "required": true,
2966
- "summary": "ID or alias of the package (starts with 0Ho) or package version (starts with 04t) to display ancestry for.",
2957
+ "summary": "ID (starts with 04t) or alias of the package version to promote.",
2967
2958
  "hasDynamicHelp": false,
2968
2959
  "multiple": false,
2969
2960
  "type": "option"
2970
2961
  },
2971
- "dot-code": {
2962
+ "no-prompt": {
2972
2963
  "aliases": [
2973
- "dotcode"
2964
+ "noprompt"
2974
2965
  ],
2966
+ "char": "n",
2975
2967
  "deprecateAliases": true,
2976
- "description": "You can use the DOT code output in graph visualization software to create tree visualizations.",
2977
- "name": "dot-code",
2978
- "summary": "Display the ancestry tree in DOT code.",
2979
- "allowNo": false,
2980
- "type": "boolean"
2981
- },
2982
- "verbose": {
2983
- "name": "verbose",
2984
- "summary": "Display both the package version ID (starts with 04t) and the version number (major.minor.patch.build) in the ancestry tree.",
2968
+ "name": "no-prompt",
2969
+ "summary": "Don't prompt to confirm setting the package version as released.",
2985
2970
  "allowNo": false,
2986
2971
  "type": "boolean"
2987
2972
  }
2988
2973
  },
2989
2974
  "hasDynamicHelp": true,
2990
2975
  "hiddenAliases": [],
2991
- "id": "package:version:displayancestry",
2976
+ "id": "package:version:promote",
2992
2977
  "pluginAlias": "@salesforce/plugin-packaging",
2993
2978
  "pluginName": "@salesforce/plugin-packaging",
2994
2979
  "pluginType": "core",
2995
2980
  "strict": true,
2996
- "summary": "Display the ancestry tree for a 2GP managed package version.",
2981
+ "summary": "Promote a package version to released.",
2997
2982
  "enableJsonFlag": true,
2998
2983
  "isESM": true,
2999
2984
  "relativePath": [
@@ -3001,58 +2986,53 @@
3001
2986
  "commands",
3002
2987
  "package",
3003
2988
  "version",
3004
- "displayancestry.js"
2989
+ "promote.js"
3005
2990
  ],
3006
2991
  "aliasPermutations": [
3007
- "force:package:version:displayancestry",
3008
- "package:force:version:displayancestry",
3009
- "package:version:force:displayancestry",
3010
- "package:version:displayancestry:force",
3011
- "force:version:package:displayancestry",
3012
- "version:force:package:displayancestry",
3013
- "version:package:force:displayancestry",
3014
- "version:package:displayancestry:force",
3015
- "force:version:displayancestry:package",
3016
- "version:force:displayancestry:package",
3017
- "version:displayancestry:force:package",
3018
- "version:displayancestry:package:force",
3019
- "force:package:displayancestry:version",
3020
- "package:force:displayancestry:version",
3021
- "package:displayancestry:force:version",
3022
- "package:displayancestry:version:force",
3023
- "force:displayancestry:package:version",
3024
- "displayancestry:force:package:version",
3025
- "displayancestry:package:force:version",
3026
- "displayancestry:package:version:force",
3027
- "force:displayancestry:version:package",
3028
- "displayancestry:force:version:package",
3029
- "displayancestry:version:force:package",
3030
- "displayancestry:version:package:force"
2992
+ "force:package:version:promote",
2993
+ "package:force:version:promote",
2994
+ "package:version:force:promote",
2995
+ "package:version:promote:force",
2996
+ "force:version:package:promote",
2997
+ "version:force:package:promote",
2998
+ "version:package:force:promote",
2999
+ "version:package:promote:force",
3000
+ "force:version:promote:package",
3001
+ "version:force:promote:package",
3002
+ "version:promote:force:package",
3003
+ "version:promote:package:force",
3004
+ "force:package:promote:version",
3005
+ "package:force:promote:version",
3006
+ "package:promote:force:version",
3007
+ "package:promote:version:force",
3008
+ "force:promote:package:version",
3009
+ "promote:force:package:version",
3010
+ "promote:package:force:version",
3011
+ "promote:package:version:force",
3012
+ "force:promote:version:package",
3013
+ "promote:force:version:package",
3014
+ "promote:version:force:package",
3015
+ "promote:version:package:force"
3031
3016
  ],
3032
3017
  "permutations": [
3033
- "package:version:displayancestry",
3034
- "version:package:displayancestry",
3035
- "version:displayancestry:package",
3036
- "package:displayancestry:version",
3037
- "displayancestry:package:version",
3038
- "displayancestry:version:package"
3018
+ "package:version:promote",
3019
+ "version:package:promote",
3020
+ "version:promote:package",
3021
+ "package:promote:version",
3022
+ "promote:package:version",
3023
+ "promote:version:package"
3039
3024
  ]
3040
3025
  },
3041
- "package:version:list": {
3026
+ "package:version:report": {
3042
3027
  "aliases": [
3043
- "force:package:version:list"
3028
+ "force:package:version:report"
3044
3029
  ],
3045
3030
  "args": {},
3046
3031
  "deprecateAliases": true,
3047
- "description": "Description",
3032
+ "description": "To update package version values, run \"<%= config.bin %> package version update\".",
3048
3033
  "examples": [
3049
- "List package versions in your default Dev Hub org that were created in the last 3 days; show only the released versions and order the list using the PatchVersion field. Display extended details about each package version:\n<%= config.bin %> <%= command.id %> --verbose --created-last-days 3 --released --order-by PatchVersion",
3050
- "List the released package versions for the two specified packages that were modified today; use the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --packages 0Ho000000000000,0Ho000000000001 --released --modified-last-days 0 --target-dev-hub devhub@example.com",
3051
- "List all released package versions in your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --released",
3052
- "List package versions that were modified today in your default Dev Hub org; show limited details about each one:\n<%= config.bin %> <%= command.id %> --concise --modified-last-days 0",
3053
- "List package versions that are based on the \"featureA\" branch in your source control system that were modified today in your default Dev Hub org; show limited details about each one:\n<%= config.bin %> <%= command.id %> --concise --modified-last-days 0 --branch featureA",
3054
- "List released package versions that were created in the last 3 days in your default Dev Hub org; show limited details:\n<%= config.bin %> <%= command.id %> --concise --created-last-days 3 --released",
3055
- "List released package versions that were modified today for the two packages with specified aliases in your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --packages exp-mgr,exp-mgr-util --released --modified-last-days 0"
3034
+ "Retrieve details about the package version with the specified ID from your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
3035
+ "Retrieve details about the package version with the specified alias (that contains spaces) from the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\" --target-dev-hub devhub@example.com"
3056
3036
  ],
3057
3037
  "flags": {
3058
3038
  "json": {
@@ -3106,73 +3086,11 @@
3106
3086
  "multiple": false,
3107
3087
  "type": "option"
3108
3088
  },
3109
- "created-last-days": {
3110
- "aliases": [
3111
- "createdlastdays"
3112
- ],
3113
- "char": "c",
3114
- "deprecateAliases": true,
3115
- "name": "created-last-days",
3116
- "summary": "Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today.",
3117
- "hasDynamicHelp": false,
3118
- "multiple": false,
3119
- "type": "option"
3120
- },
3121
- "concise": {
3122
- "name": "concise",
3123
- "summary": "Display limited package version details.",
3124
- "allowNo": false,
3125
- "type": "boolean"
3126
- },
3127
- "show-conversions-only": {
3128
- "name": "show-conversions-only",
3129
- "summary": "Filter the list output to display only converted package version.",
3130
- "allowNo": false,
3131
- "type": "boolean"
3132
- },
3133
- "modified-last-days": {
3134
- "aliases": [
3135
- "modifiedlastdays"
3136
- ],
3137
- "char": "m",
3138
- "deprecateAliases": true,
3139
- "name": "modified-last-days",
3140
- "summary": "Number of days since the items were modified, starting at 00:00:00 of first day to now. Use 0 for today.",
3141
- "hasDynamicHelp": false,
3142
- "multiple": false,
3143
- "type": "option"
3144
- },
3145
- "packages": {
3089
+ "package": {
3146
3090
  "char": "p",
3147
- "name": "packages",
3148
- "summary": "Comma-delimited list of packages (aliases or 0Ho IDs) to list.",
3149
- "hasDynamicHelp": false,
3150
- "multiple": false,
3151
- "type": "option"
3152
- },
3153
- "released": {
3154
- "char": "r",
3155
- "name": "released",
3156
- "summary": "Display released versions only (IsReleased=true).",
3157
- "allowNo": false,
3158
- "type": "boolean"
3159
- },
3160
- "branch": {
3161
- "char": "b",
3162
- "name": "branch",
3163
- "summary": "Branch in your source control system used to filter the results; only package versions based on the specified branch are listed.",
3164
- "hasDynamicHelp": false,
3165
- "multiple": false,
3166
- "type": "option"
3167
- },
3168
- "order-by": {
3169
- "aliases": [
3170
- "orderby"
3171
- ],
3172
- "char": "o",
3173
- "deprecateAliases": true,
3174
- "name": "order-by",
3175
- "summary": "Package version fields used to order the list.",
3091
+ "name": "package",
3092
+ "required": true,
3093
+ "summary": "ID (starts with 04t) or alias of the package to retrieve details for.",
3176
3094
  "hasDynamicHelp": false,
3177
3095
  "multiple": false,
3178
3096
  "type": "option"
@@ -3186,12 +3104,12 @@
3186
3104
  },
3187
3105
  "hasDynamicHelp": true,
3188
3106
  "hiddenAliases": [],
3189
- "id": "package:version:list",
3107
+ "id": "package:version:report",
3190
3108
  "pluginAlias": "@salesforce/plugin-packaging",
3191
3109
  "pluginName": "@salesforce/plugin-packaging",
3192
3110
  "pluginType": "core",
3193
3111
  "strict": true,
3194
- "summary": "List all package versions in the Dev Hub org.",
3112
+ "summary": "Retrieve details about a package version in the Dev Hub org.",
3195
3113
  "enableJsonFlag": true,
3196
3114
  "isESM": true,
3197
3115
  "relativePath": [
@@ -3199,54 +3117,49 @@
3199
3117
  "commands",
3200
3118
  "package",
3201
3119
  "version",
3202
- "list.js"
3120
+ "report.js"
3203
3121
  ],
3204
3122
  "aliasPermutations": [
3205
- "force:package:version:list",
3206
- "package:force:version:list",
3207
- "package:version:force:list",
3208
- "package:version:list:force",
3209
- "force:version:package:list",
3210
- "version:force:package:list",
3211
- "version:package:force:list",
3212
- "version:package:list:force",
3213
- "force:version:list:package",
3214
- "version:force:list:package",
3215
- "version:list:force:package",
3216
- "version:list:package:force",
3217
- "force:package:list:version",
3218
- "package:force:list:version",
3219
- "package:list:force:version",
3220
- "package:list:version:force",
3221
- "force:list:package:version",
3222
- "list:force:package:version",
3223
- "list:package:force:version",
3224
- "list:package:version:force",
3225
- "force:list:version:package",
3226
- "list:force:version:package",
3227
- "list:version:force:package",
3228
- "list:version:package:force"
3123
+ "force:package:version:report",
3124
+ "package:force:version:report",
3125
+ "package:version:force:report",
3126
+ "package:version:report:force",
3127
+ "force:version:package:report",
3128
+ "version:force:package:report",
3129
+ "version:package:force:report",
3130
+ "version:package:report:force",
3131
+ "force:version:report:package",
3132
+ "version:force:report:package",
3133
+ "version:report:force:package",
3134
+ "version:report:package:force",
3135
+ "force:package:report:version",
3136
+ "package:force:report:version",
3137
+ "package:report:force:version",
3138
+ "package:report:version:force",
3139
+ "force:report:package:version",
3140
+ "report:force:package:version",
3141
+ "report:package:force:version",
3142
+ "report:package:version:force",
3143
+ "force:report:version:package",
3144
+ "report:force:version:package",
3145
+ "report:version:force:package",
3146
+ "report:version:package:force"
3229
3147
  ],
3230
3148
  "permutations": [
3231
- "package:version:list",
3232
- "version:package:list",
3233
- "version:list:package",
3234
- "package:list:version",
3235
- "list:package:version",
3236
- "list:version:package"
3149
+ "package:version:report",
3150
+ "version:package:report",
3151
+ "version:report:package",
3152
+ "package:report:version",
3153
+ "report:package:version",
3154
+ "report:version:package"
3237
3155
  ]
3238
3156
  },
3239
- "package:version:promote": {
3240
- "aliases": [
3241
- "force:package:version:promote"
3242
- ],
3157
+ "package:version:retrieve": {
3158
+ "aliases": [],
3243
3159
  "args": {},
3244
- "deprecateAliases": true,
3245
- "description": "Supply the ID or alias of the package version you want to promote. Promotes the package version to released status.",
3160
+ "description": "Retrieving a package version downloads the metadata into the directory you specify.\n\nSpecify the subscriber package version ID (starts with 04t) and the path to an empty directory when you run this command.",
3246
3161
  "examples": [
3247
- "Promote the package version with the specified ID to released; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
3248
- "Promote the package version with the specified alias to released; uses the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package awesome_package_alias --target-dev-hub devhub@example.com",
3249
- "Promote the package version with an alias that has spaces to released:\n<%= config.bin %> <%= command.id %> --package \"Awesome Package Alias\""
3162
+ "Retrieve package metadata for a converted subscriber package version ID (starts with 04t) into my-folder/ within your Salesforce DX project directory:\n<%= config.bin %> <%= command.id %> --package 04t... --output-dir my-folder –-target-dev-hub my-devhub"
3250
3163
  ],
3251
3164
  "flags": {
3252
3165
  "json": {
@@ -3274,10 +3187,20 @@
3274
3187
  "multiple": false,
3275
3188
  "type": "option"
3276
3189
  },
3190
+ "api-version": {
3191
+ "aliases": [
3192
+ "apiversion"
3193
+ ],
3194
+ "deprecateAliases": true,
3195
+ "description": "Override the api version used for api requests made by this command",
3196
+ "name": "api-version",
3197
+ "hasDynamicHelp": false,
3198
+ "multiple": false,
3199
+ "type": "option"
3200
+ },
3277
3201
  "target-dev-hub": {
3278
3202
  "aliases": [
3279
- "targetdevhubusername",
3280
- "target-hub-org"
3203
+ "targetdevhubusername"
3281
3204
  ],
3282
3205
  "char": "v",
3283
3206
  "deprecateAliases": true,
@@ -3289,100 +3212,65 @@
3289
3212
  "multiple": false,
3290
3213
  "type": "option"
3291
3214
  },
3292
- "api-version": {
3293
- "aliases": [
3294
- "apiversion"
3295
- ],
3296
- "deprecateAliases": true,
3297
- "description": "Override the api version used for api requests made by this command",
3298
- "name": "api-version",
3299
- "hasDynamicHelp": false,
3300
- "multiple": false,
3301
- "type": "option"
3302
- },
3303
3215
  "package": {
3304
3216
  "char": "p",
3305
3217
  "name": "package",
3306
3218
  "required": true,
3307
- "summary": "ID (starts with 04t) or alias of the package version to promote.",
3219
+ "summary": "Subscriber package version ID (starts with 04t).",
3308
3220
  "hasDynamicHelp": false,
3309
3221
  "multiple": false,
3310
3222
  "type": "option"
3311
3223
  },
3312
- "no-prompt": {
3313
- "aliases": [
3314
- "noprompt"
3315
- ],
3316
- "char": "n",
3317
- "deprecateAliases": true,
3318
- "name": "no-prompt",
3319
- "summary": "Don't prompt to confirm setting the package version as released.",
3320
- "allowNo": false,
3321
- "type": "boolean"
3224
+ "output-dir": {
3225
+ "char": "d",
3226
+ "name": "output-dir",
3227
+ "summary": "Path within your Salesforce DX project directory in which to download the metadata. This directory must be empty.",
3228
+ "default": "force-app",
3229
+ "hasDynamicHelp": false,
3230
+ "multiple": false,
3231
+ "type": "option"
3322
3232
  }
3323
3233
  },
3324
3234
  "hasDynamicHelp": true,
3235
+ "hidden": true,
3325
3236
  "hiddenAliases": [],
3326
- "id": "package:version:promote",
3237
+ "id": "package:version:retrieve",
3327
3238
  "pluginAlias": "@salesforce/plugin-packaging",
3328
3239
  "pluginName": "@salesforce/plugin-packaging",
3329
3240
  "pluginType": "core",
3330
3241
  "strict": true,
3331
- "summary": "Promote a package version to released.",
3242
+ "summary": "Retrieve package metadata for a specified package version. Package metadata can be retrieved for converted second-generation managed package versions only.",
3332
3243
  "enableJsonFlag": true,
3244
+ "requiresProject": true,
3333
3245
  "isESM": true,
3334
3246
  "relativePath": [
3335
3247
  "lib",
3336
3248
  "commands",
3337
3249
  "package",
3338
3250
  "version",
3339
- "promote.js"
3340
- ],
3341
- "aliasPermutations": [
3342
- "force:package:version:promote",
3343
- "package:force:version:promote",
3344
- "package:version:force:promote",
3345
- "package:version:promote:force",
3346
- "force:version:package:promote",
3347
- "version:force:package:promote",
3348
- "version:package:force:promote",
3349
- "version:package:promote:force",
3350
- "force:version:promote:package",
3351
- "version:force:promote:package",
3352
- "version:promote:force:package",
3353
- "version:promote:package:force",
3354
- "force:package:promote:version",
3355
- "package:force:promote:version",
3356
- "package:promote:force:version",
3357
- "package:promote:version:force",
3358
- "force:promote:package:version",
3359
- "promote:force:package:version",
3360
- "promote:package:force:version",
3361
- "promote:package:version:force",
3362
- "force:promote:version:package",
3363
- "promote:force:version:package",
3364
- "promote:version:force:package",
3365
- "promote:version:package:force"
3251
+ "retrieve.js"
3366
3252
  ],
3253
+ "aliasPermutations": [],
3367
3254
  "permutations": [
3368
- "package:version:promote",
3369
- "version:package:promote",
3370
- "version:promote:package",
3371
- "package:promote:version",
3372
- "promote:package:version",
3373
- "promote:version:package"
3255
+ "package:version:retrieve",
3256
+ "version:package:retrieve",
3257
+ "version:retrieve:package",
3258
+ "package:retrieve:version",
3259
+ "retrieve:package:version",
3260
+ "retrieve:version:package"
3374
3261
  ]
3375
3262
  },
3376
- "package:version:report": {
3263
+ "package:version:update": {
3377
3264
  "aliases": [
3378
- "force:package:version:report"
3265
+ "force:package:version:update"
3379
3266
  ],
3380
3267
  "args": {},
3381
3268
  "deprecateAliases": true,
3382
- "description": "To update package version values, run \"<%= config.bin %> package version update\".",
3269
+ "description": "Specify a new value for each option you want to update.\n\nTo display details about a package version, run \"<%= config.bin %> package version display\".",
3383
3270
  "examples": [
3384
- "Retrieve details about the package version with the specified ID from your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
3385
- "Retrieve details about the package version with the specified alias (that contains spaces) from the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\" --target-dev-hub devhub@example.com"
3271
+ "Update the package version that has the specified alias (that contains spaces) with a new installation key \"password123\"; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\" --installation-key password123",
3272
+ "Update the package version that has the specified ID with a new branch and tag; use the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package 04t... --branch main --tag 'Release 1.0.7' --target-dev-hub devhub@example.com",
3273
+ "Update the package version that has the specified ID with a new description:\n<%= config.bin %> <%= command.id %> --package 04t... --version-description \"New Package Version Description\""
3386
3274
  ],
3387
3275
  "flags": {
3388
3276
  "json": {
@@ -3440,76 +3328,127 @@
3440
3328
  "char": "p",
3441
3329
  "name": "package",
3442
3330
  "required": true,
3443
- "summary": "ID (starts with 04t) or alias of the package to retrieve details for.",
3331
+ "summary": "ID (starts with 04t) or alias of the package to update a version of.",
3444
3332
  "hasDynamicHelp": false,
3445
3333
  "multiple": false,
3446
3334
  "type": "option"
3447
3335
  },
3448
- "verbose": {
3449
- "name": "verbose",
3450
- "summary": "Display extended package version details.",
3451
- "allowNo": false,
3452
- "type": "boolean"
3336
+ "version-name": {
3337
+ "aliases": [
3338
+ "versionname"
3339
+ ],
3340
+ "char": "a",
3341
+ "deprecateAliases": true,
3342
+ "name": "version-name",
3343
+ "summary": "New package version name.",
3344
+ "hasDynamicHelp": false,
3345
+ "multiple": false,
3346
+ "type": "option"
3347
+ },
3348
+ "version-description": {
3349
+ "aliases": [
3350
+ "versiondescription"
3351
+ ],
3352
+ "char": "e",
3353
+ "deprecateAliases": true,
3354
+ "name": "version-description",
3355
+ "summary": "New package version description.",
3356
+ "hasDynamicHelp": false,
3357
+ "multiple": false,
3358
+ "type": "option"
3359
+ },
3360
+ "branch": {
3361
+ "char": "b",
3362
+ "name": "branch",
3363
+ "summary": "New package version branch.",
3364
+ "hasDynamicHelp": false,
3365
+ "multiple": false,
3366
+ "type": "option"
3367
+ },
3368
+ "tag": {
3369
+ "char": "t",
3370
+ "name": "tag",
3371
+ "summary": "New package version tag.",
3372
+ "hasDynamicHelp": false,
3373
+ "multiple": false,
3374
+ "type": "option"
3375
+ },
3376
+ "installation-key": {
3377
+ "aliases": [
3378
+ "installationkey"
3379
+ ],
3380
+ "char": "k",
3381
+ "deprecateAliases": true,
3382
+ "name": "installation-key",
3383
+ "summary": "New installation key for key-protected package (default: null)",
3384
+ "hasDynamicHelp": false,
3385
+ "multiple": false,
3386
+ "type": "option"
3453
3387
  }
3454
3388
  },
3455
3389
  "hasDynamicHelp": true,
3456
3390
  "hiddenAliases": [],
3457
- "id": "package:version:report",
3391
+ "id": "package:version:update",
3458
3392
  "pluginAlias": "@salesforce/plugin-packaging",
3459
3393
  "pluginName": "@salesforce/plugin-packaging",
3460
3394
  "pluginType": "core",
3461
3395
  "strict": true,
3462
- "summary": "Retrieve details about a package version in the Dev Hub org.",
3396
+ "summary": "Update a package version.",
3463
3397
  "enableJsonFlag": true,
3398
+ "requiresProject": true,
3464
3399
  "isESM": true,
3465
3400
  "relativePath": [
3466
3401
  "lib",
3467
3402
  "commands",
3468
3403
  "package",
3469
3404
  "version",
3470
- "report.js"
3405
+ "update.js"
3471
3406
  ],
3472
3407
  "aliasPermutations": [
3473
- "force:package:version:report",
3474
- "package:force:version:report",
3475
- "package:version:force:report",
3476
- "package:version:report:force",
3477
- "force:version:package:report",
3478
- "version:force:package:report",
3479
- "version:package:force:report",
3480
- "version:package:report:force",
3481
- "force:version:report:package",
3482
- "version:force:report:package",
3483
- "version:report:force:package",
3484
- "version:report:package:force",
3485
- "force:package:report:version",
3486
- "package:force:report:version",
3487
- "package:report:force:version",
3488
- "package:report:version:force",
3489
- "force:report:package:version",
3490
- "report:force:package:version",
3491
- "report:package:force:version",
3492
- "report:package:version:force",
3493
- "force:report:version:package",
3494
- "report:force:version:package",
3495
- "report:version:force:package",
3496
- "report:version:package:force"
3408
+ "force:package:version:update",
3409
+ "package:force:version:update",
3410
+ "package:version:force:update",
3411
+ "package:version:update:force",
3412
+ "force:version:package:update",
3413
+ "version:force:package:update",
3414
+ "version:package:force:update",
3415
+ "version:package:update:force",
3416
+ "force:version:update:package",
3417
+ "version:force:update:package",
3418
+ "version:update:force:package",
3419
+ "version:update:package:force",
3420
+ "force:package:update:version",
3421
+ "package:force:update:version",
3422
+ "package:update:force:version",
3423
+ "package:update:version:force",
3424
+ "force:update:package:version",
3425
+ "update:force:package:version",
3426
+ "update:package:force:version",
3427
+ "update:package:version:force",
3428
+ "force:update:version:package",
3429
+ "update:force:version:package",
3430
+ "update:version:force:package",
3431
+ "update:version:package:force"
3497
3432
  ],
3498
3433
  "permutations": [
3499
- "package:version:report",
3500
- "version:package:report",
3501
- "version:report:package",
3502
- "package:report:version",
3503
- "report:package:version",
3504
- "report:version:package"
3434
+ "package:version:update",
3435
+ "version:package:update",
3436
+ "version:update:package",
3437
+ "package:update:version",
3438
+ "update:package:version",
3439
+ "update:version:package"
3505
3440
  ]
3506
3441
  },
3507
- "package:version:retrieve": {
3508
- "aliases": [],
3442
+ "package1:version:create": {
3443
+ "aliases": [
3444
+ "force:package1:version:create"
3445
+ ],
3509
3446
  "args": {},
3510
- "description": "Retrieving a package version downloads the metadata into the directory you specify.\n\nSpecify the subscriber package version ID (starts with 04t) and the path to an empty directory when you run this command.",
3447
+ "deprecateAliases": true,
3448
+ "description": "The package version is based on the contents of the specified metadata package. Omit --managed-released if you want to create an unmanaged package version.",
3511
3449
  "examples": [
3512
- "Retrieve package metadata for a converted subscriber package version ID (starts with 04t) into my-folder/ within your Salesforce DX project directory:\n<%= config.bin %> <%= command.id %> --package 04t... --output-dir my-folder –-target-dev-hub my-devhub"
3450
+ "Create a first-generation package version from the package with the specified ID and name the package version \"example\"; use your default org:\n<%= config.bin %> <%= command.id %> --package-id 033... --name example",
3451
+ "Same as previous example, but provide a description and wait for 30 minutes for the package version to be created; use the specified org:\n<%= config.bin %> <%= command.id %> --package-id 033... --name example --description \"example description\" --wait 30 --target-org myorg@example.com"
3513
3452
  ],
3514
3453
  "flags": {
3515
3454
  "json": {
@@ -3537,6 +3476,21 @@
3537
3476
  "multiple": false,
3538
3477
  "type": "option"
3539
3478
  },
3479
+ "target-org": {
3480
+ "aliases": [
3481
+ "targetusername",
3482
+ "u"
3483
+ ],
3484
+ "char": "o",
3485
+ "deprecateAliases": true,
3486
+ "name": "target-org",
3487
+ "noCacheDefault": true,
3488
+ "required": true,
3489
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3490
+ "hasDynamicHelp": true,
3491
+ "multiple": false,
3492
+ "type": "option"
3493
+ },
3540
3494
  "api-version": {
3541
3495
  "aliases": [
3542
3496
  "apiversion"
@@ -3548,79 +3502,164 @@
3548
3502
  "multiple": false,
3549
3503
  "type": "option"
3550
3504
  },
3551
- "target-dev-hub": {
3505
+ "package-id": {
3552
3506
  "aliases": [
3553
- "targetdevhubusername"
3507
+ "packageid"
3554
3508
  ],
3555
- "char": "v",
3509
+ "char": "i",
3556
3510
  "deprecateAliases": true,
3557
- "name": "target-dev-hub",
3558
- "noCacheDefault": true,
3511
+ "name": "package-id",
3559
3512
  "required": true,
3560
- "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
3561
- "hasDynamicHelp": true,
3513
+ "summary": "ID of the metadata package (starts with 033) of which you’re creating a new version.",
3514
+ "hasDynamicHelp": false,
3562
3515
  "multiple": false,
3563
3516
  "type": "option"
3564
3517
  },
3565
- "package": {
3566
- "char": "p",
3567
- "name": "package",
3518
+ "name": {
3519
+ "char": "n",
3520
+ "name": "name",
3568
3521
  "required": true,
3569
- "summary": "Subscriber package version ID (starts with 04t).",
3522
+ "summary": "Package version name.",
3570
3523
  "hasDynamicHelp": false,
3571
3524
  "multiple": false,
3572
3525
  "type": "option"
3573
3526
  },
3574
- "output-dir": {
3527
+ "description": {
3575
3528
  "char": "d",
3576
- "name": "output-dir",
3577
- "summary": "Path within your Salesforce DX project directory in which to download the metadata. This directory must be empty.",
3578
- "default": "force-app",
3529
+ "name": "description",
3530
+ "summary": "Package version description.",
3531
+ "hasDynamicHelp": false,
3532
+ "multiple": false,
3533
+ "type": "option"
3534
+ },
3535
+ "version": {
3536
+ "char": "v",
3537
+ "name": "version",
3538
+ "summary": "Package version in major.minor format, for example, 3.2.",
3579
3539
  "hasDynamicHelp": false,
3580
3540
  "multiple": false,
3581
3541
  "type": "option"
3542
+ },
3543
+ "managed-released": {
3544
+ "aliases": [
3545
+ "managedrelease"
3546
+ ],
3547
+ "char": "m",
3548
+ "deprecateAliases": true,
3549
+ "description": "To create a beta version, don’t include this parameter.",
3550
+ "name": "managed-released",
3551
+ "summary": "Create a managed package version.",
3552
+ "allowNo": false,
3553
+ "type": "boolean"
3554
+ },
3555
+ "release-notes-url": {
3556
+ "aliases": [
3557
+ "releasenotesurl"
3558
+ ],
3559
+ "char": "r",
3560
+ "deprecateAliases": true,
3561
+ "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
3562
+ "name": "release-notes-url",
3563
+ "summary": "Release notes URL.",
3564
+ "hasDynamicHelp": false,
3565
+ "multiple": false,
3566
+ "type": "option"
3567
+ },
3568
+ "post-install-url": {
3569
+ "aliases": [
3570
+ "postinstallurl"
3571
+ ],
3572
+ "char": "p",
3573
+ "deprecateAliases": true,
3574
+ "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
3575
+ "name": "post-install-url",
3576
+ "summary": "Post install URL.",
3577
+ "hasDynamicHelp": false,
3578
+ "multiple": false,
3579
+ "type": "option"
3580
+ },
3581
+ "installation-key": {
3582
+ "aliases": [
3583
+ "installationkey"
3584
+ ],
3585
+ "char": "k",
3586
+ "deprecateAliases": true,
3587
+ "name": "installation-key",
3588
+ "summary": "Installation key for key-protected package (default: null).",
3589
+ "hasDynamicHelp": false,
3590
+ "multiple": false,
3591
+ "type": "option"
3592
+ },
3593
+ "wait": {
3594
+ "char": "w",
3595
+ "name": "wait",
3596
+ "summary": "Minutes to wait for the package version to be created (default: 2 minutes).",
3597
+ "hasDynamicHelp": true,
3598
+ "multiple": false,
3599
+ "type": "option"
3582
3600
  }
3583
3601
  },
3584
3602
  "hasDynamicHelp": true,
3585
- "hidden": true,
3586
3603
  "hiddenAliases": [],
3587
- "id": "package:version:retrieve",
3604
+ "id": "package1:version:create",
3588
3605
  "pluginAlias": "@salesforce/plugin-packaging",
3589
3606
  "pluginName": "@salesforce/plugin-packaging",
3590
3607
  "pluginType": "core",
3591
3608
  "strict": true,
3592
- "summary": "Retrieve package metadata for a specified package version. Package metadata can be retrieved for converted second-generation managed package versions only.",
3609
+ "summary": "Create a first-generation package version in the release org.",
3593
3610
  "enableJsonFlag": true,
3594
- "requiresProject": true,
3595
3611
  "isESM": true,
3596
3612
  "relativePath": [
3597
3613
  "lib",
3598
3614
  "commands",
3599
- "package",
3615
+ "package1",
3600
3616
  "version",
3601
- "retrieve.js"
3617
+ "create.js"
3618
+ ],
3619
+ "aliasPermutations": [
3620
+ "force:package1:version:create",
3621
+ "package1:force:version:create",
3622
+ "package1:version:force:create",
3623
+ "package1:version:create:force",
3624
+ "force:version:package1:create",
3625
+ "version:force:package1:create",
3626
+ "version:package1:force:create",
3627
+ "version:package1:create:force",
3628
+ "force:version:create:package1",
3629
+ "version:force:create:package1",
3630
+ "version:create:force:package1",
3631
+ "version:create:package1:force",
3632
+ "force:package1:create:version",
3633
+ "package1:force:create:version",
3634
+ "package1:create:force:version",
3635
+ "package1:create:version:force",
3636
+ "force:create:package1:version",
3637
+ "create:force:package1:version",
3638
+ "create:package1:force:version",
3639
+ "create:package1:version:force",
3640
+ "force:create:version:package1",
3641
+ "create:force:version:package1",
3642
+ "create:version:force:package1",
3643
+ "create:version:package1:force"
3602
3644
  ],
3603
- "aliasPermutations": [],
3604
3645
  "permutations": [
3605
- "package:version:retrieve",
3606
- "version:package:retrieve",
3607
- "version:retrieve:package",
3608
- "package:retrieve:version",
3609
- "retrieve:package:version",
3610
- "retrieve:version:package"
3646
+ "package1:version:create",
3647
+ "version:package1:create",
3648
+ "version:create:package1",
3649
+ "package1:create:version",
3650
+ "create:package1:version",
3651
+ "create:version:package1"
3611
3652
  ]
3612
3653
  },
3613
- "package:version:update": {
3654
+ "package1:version:display": {
3614
3655
  "aliases": [
3615
- "force:package:version:update"
3656
+ "force:package1:version:display"
3616
3657
  ],
3617
3658
  "args": {},
3618
3659
  "deprecateAliases": true,
3619
- "description": "Specify a new value for each option you want to update.\n\nTo display details about a package version, run \"<%= config.bin %> package version display\".",
3620
3660
  "examples": [
3621
- "Update the package version that has the specified alias (that contains spaces) with a new installation key \"password123\"; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\" --installation-key password123",
3622
- "Update the package version that has the specified ID with a new branch and tag; use the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --package 04t... --branch main --tag 'Release 1.0.7' --target-dev-hub devhub@example.com",
3623
- "Update the package version that has the specified ID with a new description:\n<%= config.bin %> <%= command.id %> --package 04t... --version-description \"New Package Version Description\""
3661
+ "Display details about the first-generation package version with the specified ID in your default org:\n<%= config.bin %> <%= command.id %> --package-version-id 04t...",
3662
+ "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --package-version-id 04t... --target-org myorg@example.com"
3624
3663
  ],
3625
3664
  "flags": {
3626
3665
  "json": {
@@ -3648,17 +3687,17 @@
3648
3687
  "multiple": false,
3649
3688
  "type": "option"
3650
3689
  },
3651
- "target-dev-hub": {
3690
+ "target-org": {
3652
3691
  "aliases": [
3653
- "targetdevhubusername",
3654
- "target-hub-org"
3692
+ "targetusername",
3693
+ "u"
3655
3694
  ],
3656
- "char": "v",
3695
+ "char": "o",
3657
3696
  "deprecateAliases": true,
3658
- "name": "target-dev-hub",
3697
+ "name": "target-org",
3659
3698
  "noCacheDefault": true,
3660
3699
  "required": true,
3661
- "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
3700
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3662
3701
  "hasDynamicHelp": true,
3663
3702
  "multiple": false,
3664
3703
  "type": "option"
@@ -3674,63 +3713,15 @@
3674
3713
  "multiple": false,
3675
3714
  "type": "option"
3676
3715
  },
3677
- "package": {
3678
- "char": "p",
3679
- "name": "package",
3680
- "required": true,
3681
- "summary": "ID (starts with 04t) or alias of the package to update a version of.",
3682
- "hasDynamicHelp": false,
3683
- "multiple": false,
3684
- "type": "option"
3685
- },
3686
- "version-name": {
3687
- "aliases": [
3688
- "versionname"
3689
- ],
3690
- "char": "a",
3691
- "deprecateAliases": true,
3692
- "name": "version-name",
3693
- "summary": "New package version name.",
3694
- "hasDynamicHelp": false,
3695
- "multiple": false,
3696
- "type": "option"
3697
- },
3698
- "version-description": {
3699
- "aliases": [
3700
- "versiondescription"
3701
- ],
3702
- "char": "e",
3703
- "deprecateAliases": true,
3704
- "name": "version-description",
3705
- "summary": "New package version description.",
3706
- "hasDynamicHelp": false,
3707
- "multiple": false,
3708
- "type": "option"
3709
- },
3710
- "branch": {
3711
- "char": "b",
3712
- "name": "branch",
3713
- "summary": "New package version branch.",
3714
- "hasDynamicHelp": false,
3715
- "multiple": false,
3716
- "type": "option"
3717
- },
3718
- "tag": {
3719
- "char": "t",
3720
- "name": "tag",
3721
- "summary": "New package version tag.",
3722
- "hasDynamicHelp": false,
3723
- "multiple": false,
3724
- "type": "option"
3725
- },
3726
- "installation-key": {
3716
+ "package-version-id": {
3727
3717
  "aliases": [
3728
- "installationkey"
3718
+ "packageversionid"
3729
3719
  ],
3730
- "char": "k",
3720
+ "char": "i",
3731
3721
  "deprecateAliases": true,
3732
- "name": "installation-key",
3733
- "summary": "New installation key for key-protected package (default: null)",
3722
+ "name": "package-version-id",
3723
+ "required": true,
3724
+ "summary": "ID (starts with 04t) of the metadata package version whose details you want to display.",
3734
3725
  "hasDynamicHelp": false,
3735
3726
  "multiple": false,
3736
3727
  "type": "option"
@@ -3738,66 +3729,65 @@
3738
3729
  },
3739
3730
  "hasDynamicHelp": true,
3740
3731
  "hiddenAliases": [],
3741
- "id": "package:version:update",
3732
+ "id": "package1:version:display",
3742
3733
  "pluginAlias": "@salesforce/plugin-packaging",
3743
3734
  "pluginName": "@salesforce/plugin-packaging",
3744
3735
  "pluginType": "core",
3745
3736
  "strict": true,
3746
- "summary": "Update a package version.",
3737
+ "summary": "Display details about a first-generation package version.",
3747
3738
  "enableJsonFlag": true,
3748
- "requiresProject": true,
3749
3739
  "isESM": true,
3750
3740
  "relativePath": [
3751
3741
  "lib",
3752
3742
  "commands",
3753
- "package",
3743
+ "package1",
3754
3744
  "version",
3755
- "update.js"
3745
+ "display.js"
3756
3746
  ],
3757
3747
  "aliasPermutations": [
3758
- "force:package:version:update",
3759
- "package:force:version:update",
3760
- "package:version:force:update",
3761
- "package:version:update:force",
3762
- "force:version:package:update",
3763
- "version:force:package:update",
3764
- "version:package:force:update",
3765
- "version:package:update:force",
3766
- "force:version:update:package",
3767
- "version:force:update:package",
3768
- "version:update:force:package",
3769
- "version:update:package:force",
3770
- "force:package:update:version",
3771
- "package:force:update:version",
3772
- "package:update:force:version",
3773
- "package:update:version:force",
3774
- "force:update:package:version",
3775
- "update:force:package:version",
3776
- "update:package:force:version",
3777
- "update:package:version:force",
3778
- "force:update:version:package",
3779
- "update:force:version:package",
3780
- "update:version:force:package",
3781
- "update:version:package:force"
3748
+ "force:package1:version:display",
3749
+ "package1:force:version:display",
3750
+ "package1:version:force:display",
3751
+ "package1:version:display:force",
3752
+ "force:version:package1:display",
3753
+ "version:force:package1:display",
3754
+ "version:package1:force:display",
3755
+ "version:package1:display:force",
3756
+ "force:version:display:package1",
3757
+ "version:force:display:package1",
3758
+ "version:display:force:package1",
3759
+ "version:display:package1:force",
3760
+ "force:package1:display:version",
3761
+ "package1:force:display:version",
3762
+ "package1:display:force:version",
3763
+ "package1:display:version:force",
3764
+ "force:display:package1:version",
3765
+ "display:force:package1:version",
3766
+ "display:package1:force:version",
3767
+ "display:package1:version:force",
3768
+ "force:display:version:package1",
3769
+ "display:force:version:package1",
3770
+ "display:version:force:package1",
3771
+ "display:version:package1:force"
3782
3772
  ],
3783
3773
  "permutations": [
3784
- "package:version:update",
3785
- "version:package:update",
3786
- "version:update:package",
3787
- "package:update:version",
3788
- "update:package:version",
3789
- "update:version:package"
3774
+ "package1:version:display",
3775
+ "version:package1:display",
3776
+ "version:display:package1",
3777
+ "package1:display:version",
3778
+ "display:package1:version",
3779
+ "display:version:package1"
3790
3780
  ]
3791
3781
  },
3792
- "package1:version:create:get": {
3782
+ "package1:version:list": {
3793
3783
  "aliases": [
3794
- "force:package1:version:create:get"
3784
+ "force:package1:version:list"
3795
3785
  ],
3796
3786
  "args": {},
3797
3787
  "deprecateAliases": true,
3798
3788
  "examples": [
3799
- "Get the status of the creation request for the package version with the specified ID in your default org:\n<%= config.bin %> <%= command.id %> --request-id 0HD...",
3800
- "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --request-id 0HD... --target-org myorg@example.com"
3789
+ "List all first-generation package versions in your default org:\n<%= config.bin %> <%= command.id %>",
3790
+ "List package versions for the specified first-generation package in the specifief org:\n<%= config.bin %> <%= command.id %> --package-id 033... --target-org myorg@example.com"
3801
3791
  ],
3802
3792
  "flags": {
3803
3793
  "json": {
@@ -3851,15 +3841,15 @@
3851
3841
  "multiple": false,
3852
3842
  "type": "option"
3853
3843
  },
3854
- "request-id": {
3844
+ "package-id": {
3855
3845
  "aliases": [
3856
- "requestid"
3846
+ "packageid"
3857
3847
  ],
3858
3848
  "char": "i",
3859
3849
  "deprecateAliases": true,
3860
- "name": "request-id",
3861
- "required": true,
3862
- "summary": "ID of the PackageUploadRequest (starts with 0HD).",
3850
+ "description": "If not specified, shows all versions for all packages (managed and unmanaged) in the org.",
3851
+ "name": "package-id",
3852
+ "summary": "Metadata package ID (starts with 033) whose package versions you want to list.",
3863
3853
  "hasDynamicHelp": false,
3864
3854
  "multiple": false,
3865
3855
  "type": "option"
@@ -3867,12 +3857,12 @@
3867
3857
  },
3868
3858
  "hasDynamicHelp": true,
3869
3859
  "hiddenAliases": [],
3870
- "id": "package1:version:create:get",
3860
+ "id": "package1:version:list",
3871
3861
  "pluginAlias": "@salesforce/plugin-packaging",
3872
3862
  "pluginName": "@salesforce/plugin-packaging",
3873
3863
  "pluginType": "core",
3874
3864
  "strict": true,
3875
- "summary": "Retrieve the status of a package version creation request.",
3865
+ "summary": "List package versions for the specified first-generation package or for the org.",
3876
3866
  "enableJsonFlag": true,
3877
3867
  "isESM": true,
3878
3868
  "relativePath": [
@@ -3880,156 +3870,41 @@
3880
3870
  "commands",
3881
3871
  "package1",
3882
3872
  "version",
3883
- "create",
3884
- "get.js"
3873
+ "list.js"
3885
3874
  ],
3886
3875
  "aliasPermutations": [
3887
- "force:package1:version:create:get",
3888
- "package1:force:version:create:get",
3889
- "package1:version:force:create:get",
3890
- "package1:version:create:force:get",
3891
- "package1:version:create:get:force",
3892
- "force:version:package1:create:get",
3893
- "version:force:package1:create:get",
3894
- "version:package1:force:create:get",
3895
- "version:package1:create:force:get",
3896
- "version:package1:create:get:force",
3897
- "force:version:create:package1:get",
3898
- "version:force:create:package1:get",
3899
- "version:create:force:package1:get",
3900
- "version:create:package1:force:get",
3901
- "version:create:package1:get:force",
3902
- "force:version:create:get:package1",
3903
- "version:force:create:get:package1",
3904
- "version:create:force:get:package1",
3905
- "version:create:get:force:package1",
3906
- "version:create:get:package1:force",
3907
- "force:package1:create:version:get",
3908
- "package1:force:create:version:get",
3909
- "package1:create:force:version:get",
3910
- "package1:create:version:force:get",
3911
- "package1:create:version:get:force",
3912
- "force:create:package1:version:get",
3913
- "create:force:package1:version:get",
3914
- "create:package1:force:version:get",
3915
- "create:package1:version:force:get",
3916
- "create:package1:version:get:force",
3917
- "force:create:version:package1:get",
3918
- "create:force:version:package1:get",
3919
- "create:version:force:package1:get",
3920
- "create:version:package1:force:get",
3921
- "create:version:package1:get:force",
3922
- "force:create:version:get:package1",
3923
- "create:force:version:get:package1",
3924
- "create:version:force:get:package1",
3925
- "create:version:get:force:package1",
3926
- "create:version:get:package1:force",
3927
- "force:package1:create:get:version",
3928
- "package1:force:create:get:version",
3929
- "package1:create:force:get:version",
3930
- "package1:create:get:force:version",
3931
- "package1:create:get:version:force",
3932
- "force:create:package1:get:version",
3933
- "create:force:package1:get:version",
3934
- "create:package1:force:get:version",
3935
- "create:package1:get:force:version",
3936
- "create:package1:get:version:force",
3937
- "force:create:get:package1:version",
3938
- "create:force:get:package1:version",
3939
- "create:get:force:package1:version",
3940
- "create:get:package1:force:version",
3941
- "create:get:package1:version:force",
3942
- "force:create:get:version:package1",
3943
- "create:force:get:version:package1",
3944
- "create:get:force:version:package1",
3945
- "create:get:version:force:package1",
3946
- "create:get:version:package1:force",
3947
- "force:package1:version:get:create",
3948
- "package1:force:version:get:create",
3949
- "package1:version:force:get:create",
3950
- "package1:version:get:force:create",
3951
- "package1:version:get:create:force",
3952
- "force:version:package1:get:create",
3953
- "version:force:package1:get:create",
3954
- "version:package1:force:get:create",
3955
- "version:package1:get:force:create",
3956
- "version:package1:get:create:force",
3957
- "force:version:get:package1:create",
3958
- "version:force:get:package1:create",
3959
- "version:get:force:package1:create",
3960
- "version:get:package1:force:create",
3961
- "version:get:package1:create:force",
3962
- "force:version:get:create:package1",
3963
- "version:force:get:create:package1",
3964
- "version:get:force:create:package1",
3965
- "version:get:create:force:package1",
3966
- "version:get:create:package1:force",
3967
- "force:package1:get:version:create",
3968
- "package1:force:get:version:create",
3969
- "package1:get:force:version:create",
3970
- "package1:get:version:force:create",
3971
- "package1:get:version:create:force",
3972
- "force:get:package1:version:create",
3973
- "get:force:package1:version:create",
3974
- "get:package1:force:version:create",
3975
- "get:package1:version:force:create",
3976
- "get:package1:version:create:force",
3977
- "force:get:version:package1:create",
3978
- "get:force:version:package1:create",
3979
- "get:version:force:package1:create",
3980
- "get:version:package1:force:create",
3981
- "get:version:package1:create:force",
3982
- "force:get:version:create:package1",
3983
- "get:force:version:create:package1",
3984
- "get:version:force:create:package1",
3985
- "get:version:create:force:package1",
3986
- "get:version:create:package1:force",
3987
- "force:package1:get:create:version",
3988
- "package1:force:get:create:version",
3989
- "package1:get:force:create:version",
3990
- "package1:get:create:force:version",
3991
- "package1:get:create:version:force",
3992
- "force:get:package1:create:version",
3993
- "get:force:package1:create:version",
3994
- "get:package1:force:create:version",
3995
- "get:package1:create:force:version",
3996
- "get:package1:create:version:force",
3997
- "force:get:create:package1:version",
3998
- "get:force:create:package1:version",
3999
- "get:create:force:package1:version",
4000
- "get:create:package1:force:version",
4001
- "get:create:package1:version:force",
4002
- "force:get:create:version:package1",
4003
- "get:force:create:version:package1",
4004
- "get:create:force:version:package1",
4005
- "get:create:version:force:package1",
4006
- "get:create:version:package1:force"
4007
- ],
4008
- "permutations": [
4009
- "package1:version:create:get",
4010
- "version:package1:create:get",
4011
- "version:create:package1:get",
4012
- "version:create:get:package1",
4013
- "package1:create:version:get",
4014
- "create:package1:version:get",
4015
- "create:version:package1:get",
4016
- "create:version:get:package1",
4017
- "package1:create:get:version",
4018
- "create:package1:get:version",
4019
- "create:get:package1:version",
4020
- "create:get:version:package1",
4021
- "package1:version:get:create",
4022
- "version:package1:get:create",
4023
- "version:get:package1:create",
4024
- "version:get:create:package1",
4025
- "package1:get:version:create",
4026
- "get:package1:version:create",
4027
- "get:version:package1:create",
4028
- "get:version:create:package1",
4029
- "package1:get:create:version",
4030
- "get:package1:create:version",
4031
- "get:create:package1:version",
4032
- "get:create:version:package1"
3876
+ "force:package1:version:list",
3877
+ "package1:force:version:list",
3878
+ "package1:version:force:list",
3879
+ "package1:version:list:force",
3880
+ "force:version:package1:list",
3881
+ "version:force:package1:list",
3882
+ "version:package1:force:list",
3883
+ "version:package1:list:force",
3884
+ "force:version:list:package1",
3885
+ "version:force:list:package1",
3886
+ "version:list:force:package1",
3887
+ "version:list:package1:force",
3888
+ "force:package1:list:version",
3889
+ "package1:force:list:version",
3890
+ "package1:list:force:version",
3891
+ "package1:list:version:force",
3892
+ "force:list:package1:version",
3893
+ "list:force:package1:version",
3894
+ "list:package1:force:version",
3895
+ "list:package1:version:force",
3896
+ "force:list:version:package1",
3897
+ "list:force:version:package1",
3898
+ "list:version:force:package1",
3899
+ "list:version:package1:force"
3900
+ ],
3901
+ "permutations": [
3902
+ "package1:version:list",
3903
+ "version:package1:list",
3904
+ "version:list:package1",
3905
+ "package1:list:version",
3906
+ "list:package1:version",
3907
+ "list:version:package1"
4033
3908
  ]
4034
3909
  },
4035
3910
  "package:version:create:list": {
@@ -4547,7 +4422,250 @@
4547
4422
  "report:create:package:version",
4548
4423
  "report:create:version:package"
4549
4424
  ]
4425
+ },
4426
+ "package1:version:create:get": {
4427
+ "aliases": [
4428
+ "force:package1:version:create:get"
4429
+ ],
4430
+ "args": {},
4431
+ "deprecateAliases": true,
4432
+ "examples": [
4433
+ "Get the status of the creation request for the package version with the specified ID in your default org:\n<%= config.bin %> <%= command.id %> --request-id 0HD...",
4434
+ "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --request-id 0HD... --target-org myorg@example.com"
4435
+ ],
4436
+ "flags": {
4437
+ "json": {
4438
+ "description": "Format output as json.",
4439
+ "helpGroup": "GLOBAL",
4440
+ "name": "json",
4441
+ "allowNo": false,
4442
+ "type": "boolean"
4443
+ },
4444
+ "flags-dir": {
4445
+ "helpGroup": "GLOBAL",
4446
+ "name": "flags-dir",
4447
+ "summary": "Import flag values from a directory.",
4448
+ "hasDynamicHelp": false,
4449
+ "multiple": false,
4450
+ "type": "option"
4451
+ },
4452
+ "loglevel": {
4453
+ "deprecated": {
4454
+ "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
4455
+ },
4456
+ "hidden": true,
4457
+ "name": "loglevel",
4458
+ "hasDynamicHelp": false,
4459
+ "multiple": false,
4460
+ "type": "option"
4461
+ },
4462
+ "target-org": {
4463
+ "aliases": [
4464
+ "targetusername",
4465
+ "u"
4466
+ ],
4467
+ "char": "o",
4468
+ "deprecateAliases": true,
4469
+ "name": "target-org",
4470
+ "noCacheDefault": true,
4471
+ "required": true,
4472
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4473
+ "hasDynamicHelp": true,
4474
+ "multiple": false,
4475
+ "type": "option"
4476
+ },
4477
+ "api-version": {
4478
+ "aliases": [
4479
+ "apiversion"
4480
+ ],
4481
+ "deprecateAliases": true,
4482
+ "description": "Override the api version used for api requests made by this command",
4483
+ "name": "api-version",
4484
+ "hasDynamicHelp": false,
4485
+ "multiple": false,
4486
+ "type": "option"
4487
+ },
4488
+ "request-id": {
4489
+ "aliases": [
4490
+ "requestid"
4491
+ ],
4492
+ "char": "i",
4493
+ "deprecateAliases": true,
4494
+ "name": "request-id",
4495
+ "required": true,
4496
+ "summary": "ID of the PackageUploadRequest (starts with 0HD).",
4497
+ "hasDynamicHelp": false,
4498
+ "multiple": false,
4499
+ "type": "option"
4500
+ }
4501
+ },
4502
+ "hasDynamicHelp": true,
4503
+ "hiddenAliases": [],
4504
+ "id": "package1:version:create:get",
4505
+ "pluginAlias": "@salesforce/plugin-packaging",
4506
+ "pluginName": "@salesforce/plugin-packaging",
4507
+ "pluginType": "core",
4508
+ "strict": true,
4509
+ "summary": "Retrieve the status of a package version creation request.",
4510
+ "enableJsonFlag": true,
4511
+ "isESM": true,
4512
+ "relativePath": [
4513
+ "lib",
4514
+ "commands",
4515
+ "package1",
4516
+ "version",
4517
+ "create",
4518
+ "get.js"
4519
+ ],
4520
+ "aliasPermutations": [
4521
+ "force:package1:version:create:get",
4522
+ "package1:force:version:create:get",
4523
+ "package1:version:force:create:get",
4524
+ "package1:version:create:force:get",
4525
+ "package1:version:create:get:force",
4526
+ "force:version:package1:create:get",
4527
+ "version:force:package1:create:get",
4528
+ "version:package1:force:create:get",
4529
+ "version:package1:create:force:get",
4530
+ "version:package1:create:get:force",
4531
+ "force:version:create:package1:get",
4532
+ "version:force:create:package1:get",
4533
+ "version:create:force:package1:get",
4534
+ "version:create:package1:force:get",
4535
+ "version:create:package1:get:force",
4536
+ "force:version:create:get:package1",
4537
+ "version:force:create:get:package1",
4538
+ "version:create:force:get:package1",
4539
+ "version:create:get:force:package1",
4540
+ "version:create:get:package1:force",
4541
+ "force:package1:create:version:get",
4542
+ "package1:force:create:version:get",
4543
+ "package1:create:force:version:get",
4544
+ "package1:create:version:force:get",
4545
+ "package1:create:version:get:force",
4546
+ "force:create:package1:version:get",
4547
+ "create:force:package1:version:get",
4548
+ "create:package1:force:version:get",
4549
+ "create:package1:version:force:get",
4550
+ "create:package1:version:get:force",
4551
+ "force:create:version:package1:get",
4552
+ "create:force:version:package1:get",
4553
+ "create:version:force:package1:get",
4554
+ "create:version:package1:force:get",
4555
+ "create:version:package1:get:force",
4556
+ "force:create:version:get:package1",
4557
+ "create:force:version:get:package1",
4558
+ "create:version:force:get:package1",
4559
+ "create:version:get:force:package1",
4560
+ "create:version:get:package1:force",
4561
+ "force:package1:create:get:version",
4562
+ "package1:force:create:get:version",
4563
+ "package1:create:force:get:version",
4564
+ "package1:create:get:force:version",
4565
+ "package1:create:get:version:force",
4566
+ "force:create:package1:get:version",
4567
+ "create:force:package1:get:version",
4568
+ "create:package1:force:get:version",
4569
+ "create:package1:get:force:version",
4570
+ "create:package1:get:version:force",
4571
+ "force:create:get:package1:version",
4572
+ "create:force:get:package1:version",
4573
+ "create:get:force:package1:version",
4574
+ "create:get:package1:force:version",
4575
+ "create:get:package1:version:force",
4576
+ "force:create:get:version:package1",
4577
+ "create:force:get:version:package1",
4578
+ "create:get:force:version:package1",
4579
+ "create:get:version:force:package1",
4580
+ "create:get:version:package1:force",
4581
+ "force:package1:version:get:create",
4582
+ "package1:force:version:get:create",
4583
+ "package1:version:force:get:create",
4584
+ "package1:version:get:force:create",
4585
+ "package1:version:get:create:force",
4586
+ "force:version:package1:get:create",
4587
+ "version:force:package1:get:create",
4588
+ "version:package1:force:get:create",
4589
+ "version:package1:get:force:create",
4590
+ "version:package1:get:create:force",
4591
+ "force:version:get:package1:create",
4592
+ "version:force:get:package1:create",
4593
+ "version:get:force:package1:create",
4594
+ "version:get:package1:force:create",
4595
+ "version:get:package1:create:force",
4596
+ "force:version:get:create:package1",
4597
+ "version:force:get:create:package1",
4598
+ "version:get:force:create:package1",
4599
+ "version:get:create:force:package1",
4600
+ "version:get:create:package1:force",
4601
+ "force:package1:get:version:create",
4602
+ "package1:force:get:version:create",
4603
+ "package1:get:force:version:create",
4604
+ "package1:get:version:force:create",
4605
+ "package1:get:version:create:force",
4606
+ "force:get:package1:version:create",
4607
+ "get:force:package1:version:create",
4608
+ "get:package1:force:version:create",
4609
+ "get:package1:version:force:create",
4610
+ "get:package1:version:create:force",
4611
+ "force:get:version:package1:create",
4612
+ "get:force:version:package1:create",
4613
+ "get:version:force:package1:create",
4614
+ "get:version:package1:force:create",
4615
+ "get:version:package1:create:force",
4616
+ "force:get:version:create:package1",
4617
+ "get:force:version:create:package1",
4618
+ "get:version:force:create:package1",
4619
+ "get:version:create:force:package1",
4620
+ "get:version:create:package1:force",
4621
+ "force:package1:get:create:version",
4622
+ "package1:force:get:create:version",
4623
+ "package1:get:force:create:version",
4624
+ "package1:get:create:force:version",
4625
+ "package1:get:create:version:force",
4626
+ "force:get:package1:create:version",
4627
+ "get:force:package1:create:version",
4628
+ "get:package1:force:create:version",
4629
+ "get:package1:create:force:version",
4630
+ "get:package1:create:version:force",
4631
+ "force:get:create:package1:version",
4632
+ "get:force:create:package1:version",
4633
+ "get:create:force:package1:version",
4634
+ "get:create:package1:force:version",
4635
+ "get:create:package1:version:force",
4636
+ "force:get:create:version:package1",
4637
+ "get:force:create:version:package1",
4638
+ "get:create:force:version:package1",
4639
+ "get:create:version:force:package1",
4640
+ "get:create:version:package1:force"
4641
+ ],
4642
+ "permutations": [
4643
+ "package1:version:create:get",
4644
+ "version:package1:create:get",
4645
+ "version:create:package1:get",
4646
+ "version:create:get:package1",
4647
+ "package1:create:version:get",
4648
+ "create:package1:version:get",
4649
+ "create:version:package1:get",
4650
+ "create:version:get:package1",
4651
+ "package1:create:get:version",
4652
+ "create:package1:get:version",
4653
+ "create:get:package1:version",
4654
+ "create:get:version:package1",
4655
+ "package1:version:get:create",
4656
+ "version:package1:get:create",
4657
+ "version:get:package1:create",
4658
+ "version:get:create:package1",
4659
+ "package1:get:version:create",
4660
+ "get:package1:version:create",
4661
+ "get:version:package1:create",
4662
+ "get:version:create:package1",
4663
+ "package1:get:create:version",
4664
+ "get:package1:create:version",
4665
+ "get:create:package1:version",
4666
+ "get:create:version:package1"
4667
+ ]
4550
4668
  }
4551
4669
  },
4552
- "version": "2.18.4"
4670
+ "version": "2.19.1"
4553
4671
  }