@salesforce/plugin-packaging 2.13.5 → 2.13.6

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 (3) hide show
  1. package/README.md +22 -22
  2. package/oclif.manifest.json +1388 -1388
  3. package/package.json +4 -4
package/oclif.manifest.json CHANGED
@@ -1047,16 +1047,15 @@
1047
1047
  "update:package"
1048
1048
  ]
1049
1049
  },
1050
- "package1:version:create": {
1050
+ "package:install:report": {
1051
1051
  "aliases": [
1052
- "force:package1:version:create"
1052
+ "force:package:install:report"
1053
1053
  ],
1054
1054
  "args": {},
1055
1055
  "deprecateAliases": true,
1056
- "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.",
1057
1056
  "examples": [
1058
- "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",
1059
- "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"
1057
+ "Retrieve the status of a package installation request with the specified ID on your default org:\n<%= config.bin %> <%= command.id %> --request-id 0Hf...",
1058
+ "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"
1060
1059
  ],
1061
1060
  "flags": {
1062
1061
  "json": {
@@ -1074,16 +1073,6 @@
1074
1073
  "multiple": false,
1075
1074
  "type": "option"
1076
1075
  },
1077
- "loglevel": {
1078
- "deprecated": {
1079
- "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."
1080
- },
1081
- "hidden": true,
1082
- "name": "loglevel",
1083
- "hasDynamicHelp": false,
1084
- "multiple": false,
1085
- "type": "option"
1086
- },
1087
1076
  "target-org": {
1088
1077
  "aliases": [
1089
1078
  "targetusername",
@@ -1110,164 +1099,91 @@
1110
1099
  "multiple": false,
1111
1100
  "type": "option"
1112
1101
  },
1113
- "package-id": {
1114
- "aliases": [
1115
- "packageid"
1116
- ],
1117
- "char": "i",
1118
- "deprecateAliases": true,
1119
- "name": "package-id",
1120
- "required": true,
1121
- "summary": "ID of the metadata package (starts with 033) of which you’re creating a new version.",
1122
- "hasDynamicHelp": false,
1123
- "multiple": false,
1124
- "type": "option"
1125
- },
1126
- "name": {
1127
- "char": "n",
1128
- "name": "name",
1129
- "required": true,
1130
- "summary": "Package version name.",
1131
- "hasDynamicHelp": false,
1132
- "multiple": false,
1133
- "type": "option"
1134
- },
1135
- "description": {
1136
- "char": "d",
1137
- "name": "description",
1138
- "summary": "Package version description.",
1139
- "hasDynamicHelp": false,
1140
- "multiple": false,
1141
- "type": "option"
1142
- },
1143
- "version": {
1144
- "char": "v",
1145
- "name": "version",
1146
- "summary": "Package version in major.minor format, for example, 3.2.",
1147
- "hasDynamicHelp": false,
1148
- "multiple": false,
1149
- "type": "option"
1150
- },
1151
- "managed-released": {
1152
- "aliases": [
1153
- "managedrelease"
1154
- ],
1155
- "char": "m",
1156
- "deprecateAliases": true,
1157
- "description": "To create a beta version, don’t include this parameter.",
1158
- "name": "managed-released",
1159
- "summary": "Create a managed package version.",
1160
- "allowNo": false,
1161
- "type": "boolean"
1162
- },
1163
- "release-notes-url": {
1164
- "aliases": [
1165
- "releasenotesurl"
1166
- ],
1167
- "char": "r",
1168
- "deprecateAliases": true,
1169
- "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
1170
- "name": "release-notes-url",
1171
- "summary": "Release notes URL.",
1172
- "hasDynamicHelp": false,
1173
- "multiple": false,
1174
- "type": "option"
1175
- },
1176
- "post-install-url": {
1177
- "aliases": [
1178
- "postinstallurl"
1179
- ],
1180
- "char": "p",
1181
- "deprecateAliases": true,
1182
- "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
1183
- "name": "post-install-url",
1184
- "summary": "Post install URL.",
1102
+ "loglevel": {
1103
+ "deprecated": {
1104
+ "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."
1105
+ },
1106
+ "hidden": true,
1107
+ "name": "loglevel",
1185
1108
  "hasDynamicHelp": false,
1186
1109
  "multiple": false,
1187
1110
  "type": "option"
1188
1111
  },
1189
- "installation-key": {
1112
+ "request-id": {
1190
1113
  "aliases": [
1191
- "installationkey"
1114
+ "requestid"
1192
1115
  ],
1193
- "char": "k",
1116
+ "char": "i",
1194
1117
  "deprecateAliases": true,
1195
- "name": "installation-key",
1196
- "summary": "Installation key for key-protected package (default: null).",
1118
+ "name": "request-id",
1119
+ "required": true,
1120
+ "summary": "ID of the package install request you want to check; starts with 0Hf.",
1197
1121
  "hasDynamicHelp": false,
1198
1122
  "multiple": false,
1199
1123
  "type": "option"
1200
- },
1201
- "wait": {
1202
- "char": "w",
1203
- "name": "wait",
1204
- "summary": "Minutes to wait for the package version to be created (default: 2 minutes).",
1205
- "hasDynamicHelp": true,
1206
- "multiple": false,
1207
- "type": "option"
1208
1124
  }
1209
1125
  },
1210
1126
  "hasDynamicHelp": true,
1211
1127
  "hiddenAliases": [],
1212
- "id": "package1:version:create",
1128
+ "id": "package:install:report",
1213
1129
  "pluginAlias": "@salesforce/plugin-packaging",
1214
1130
  "pluginName": "@salesforce/plugin-packaging",
1215
1131
  "pluginType": "core",
1216
1132
  "strict": true,
1217
- "summary": "Create a first-generation package version in the release org.",
1133
+ "summary": "Retrieve the status of a package installation request.",
1218
1134
  "enableJsonFlag": true,
1219
1135
  "isESM": true,
1220
1136
  "relativePath": [
1221
1137
  "lib",
1222
1138
  "commands",
1223
- "package1",
1224
- "version",
1225
- "create.js"
1139
+ "package",
1140
+ "install",
1141
+ "report.js"
1226
1142
  ],
1227
1143
  "aliasPermutations": [
1228
- "force:package1:version:create",
1229
- "package1:force:version:create",
1230
- "package1:version:force:create",
1231
- "package1:version:create:force",
1232
- "force:version:package1:create",
1233
- "version:force:package1:create",
1234
- "version:package1:force:create",
1235
- "version:package1:create:force",
1236
- "force:version:create:package1",
1237
- "version:force:create:package1",
1238
- "version:create:force:package1",
1239
- "version:create:package1:force",
1240
- "force:package1:create:version",
1241
- "package1:force:create:version",
1242
- "package1:create:force:version",
1243
- "package1:create:version:force",
1244
- "force:create:package1:version",
1245
- "create:force:package1:version",
1246
- "create:package1:force:version",
1247
- "create:package1:version:force",
1248
- "force:create:version:package1",
1249
- "create:force:version:package1",
1250
- "create:version:force:package1",
1251
- "create:version:package1:force"
1144
+ "force:package:install:report",
1145
+ "package:force:install:report",
1146
+ "package:install:force:report",
1147
+ "package:install:report:force",
1148
+ "force:install:package:report",
1149
+ "install:force:package:report",
1150
+ "install:package:force:report",
1151
+ "install:package:report:force",
1152
+ "force:install:report:package",
1153
+ "install:force:report:package",
1154
+ "install:report:force:package",
1155
+ "install:report:package:force",
1156
+ "force:package:report:install",
1157
+ "package:force:report:install",
1158
+ "package:report:force:install",
1159
+ "package:report:install:force",
1160
+ "force:report:package:install",
1161
+ "report:force:package:install",
1162
+ "report:package:force:install",
1163
+ "report:package:install:force",
1164
+ "force:report:install:package",
1165
+ "report:force:install:package",
1166
+ "report:install:force:package",
1167
+ "report:install:package:force"
1252
1168
  ],
1253
1169
  "permutations": [
1254
- "package1:version:create",
1255
- "version:package1:create",
1256
- "version:create:package1",
1257
- "package1:create:version",
1258
- "create:package1:version",
1259
- "create:version:package1"
1170
+ "package:install:report",
1171
+ "install:package:report",
1172
+ "install:report:package",
1173
+ "package:report:install",
1174
+ "report:package:install",
1175
+ "report:install:package"
1260
1176
  ]
1261
1177
  },
1262
- "package1:version:display": {
1178
+ "package:installed:list": {
1263
1179
  "aliases": [
1264
- "force:package1:version:display"
1180
+ "force:package:installed:list"
1265
1181
  ],
1266
1182
  "args": {},
1267
1183
  "deprecateAliases": true,
1268
1184
  "examples": [
1269
- "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...",
1270
- "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --package-version-id 04t... --target-org myorg@example.com"
1185
+ "List the installed packages in your default org:\n<%= config.bin %> <%= command.id %>",
1186
+ "List the installed packages in the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --target-org me@example.com"
1271
1187
  ],
1272
1188
  "flags": {
1273
1189
  "json": {
@@ -1320,82 +1236,69 @@
1320
1236
  "hasDynamicHelp": false,
1321
1237
  "multiple": false,
1322
1238
  "type": "option"
1323
- },
1324
- "package-version-id": {
1325
- "aliases": [
1326
- "packageversionid"
1327
- ],
1328
- "char": "i",
1329
- "deprecateAliases": true,
1330
- "name": "package-version-id",
1331
- "required": true,
1332
- "summary": "ID (starts with 04t) of the metadata package version whose details you want to display.",
1333
- "hasDynamicHelp": false,
1334
- "multiple": false,
1335
- "type": "option"
1336
1239
  }
1337
1240
  },
1338
1241
  "hasDynamicHelp": true,
1339
1242
  "hiddenAliases": [],
1340
- "id": "package1:version:display",
1243
+ "id": "package:installed:list",
1341
1244
  "pluginAlias": "@salesforce/plugin-packaging",
1342
1245
  "pluginName": "@salesforce/plugin-packaging",
1343
1246
  "pluginType": "core",
1344
1247
  "strict": true,
1345
- "summary": "Display details about a first-generation package version.",
1248
+ "summary": "List the org’s installed packages.",
1346
1249
  "enableJsonFlag": true,
1347
1250
  "isESM": true,
1348
1251
  "relativePath": [
1349
1252
  "lib",
1350
1253
  "commands",
1351
- "package1",
1352
- "version",
1353
- "display.js"
1254
+ "package",
1255
+ "installed",
1256
+ "list.js"
1354
1257
  ],
1355
1258
  "aliasPermutations": [
1356
- "force:package1:version:display",
1357
- "package1:force:version:display",
1358
- "package1:version:force:display",
1359
- "package1:version:display:force",
1360
- "force:version:package1:display",
1361
- "version:force:package1:display",
1362
- "version:package1:force:display",
1363
- "version:package1:display:force",
1364
- "force:version:display:package1",
1365
- "version:force:display:package1",
1366
- "version:display:force:package1",
1367
- "version:display:package1:force",
1368
- "force:package1:display:version",
1369
- "package1:force:display:version",
1370
- "package1:display:force:version",
1371
- "package1:display:version:force",
1372
- "force:display:package1:version",
1373
- "display:force:package1:version",
1374
- "display:package1:force:version",
1375
- "display:package1:version:force",
1376
- "force:display:version:package1",
1377
- "display:force:version:package1",
1378
- "display:version:force:package1",
1379
- "display:version:package1:force"
1380
- ],
1381
- "permutations": [
1382
- "package1:version:display",
1383
- "version:package1:display",
1384
- "version:display:package1",
1385
- "package1:display:version",
1386
- "display:package1:version",
1387
- "display:version:package1"
1388
- ]
1389
- },
1390
- "package1:version:list": {
1391
- "aliases": [
1392
- "force:package1:version:list"
1393
- ],
1394
- "args": {},
1259
+ "force:package:installed:list",
1260
+ "package:force:installed:list",
1261
+ "package:installed:force:list",
1262
+ "package:installed:list:force",
1263
+ "force:installed:package:list",
1264
+ "installed:force:package:list",
1265
+ "installed:package:force:list",
1266
+ "installed:package:list:force",
1267
+ "force:installed:list:package",
1268
+ "installed:force:list:package",
1269
+ "installed:list:force:package",
1270
+ "installed:list:package:force",
1271
+ "force:package:list:installed",
1272
+ "package:force:list:installed",
1273
+ "package:list:force:installed",
1274
+ "package:list:installed:force",
1275
+ "force:list:package:installed",
1276
+ "list:force:package:installed",
1277
+ "list:package:force:installed",
1278
+ "list:package:installed:force",
1279
+ "force:list:installed:package",
1280
+ "list:force:installed:package",
1281
+ "list:installed:force:package",
1282
+ "list:installed:package:force"
1283
+ ],
1284
+ "permutations": [
1285
+ "package:installed:list",
1286
+ "installed:package:list",
1287
+ "installed:list:package",
1288
+ "package:list:installed",
1289
+ "list:package:installed",
1290
+ "list:installed:package"
1291
+ ]
1292
+ },
1293
+ "package:uninstall:report": {
1294
+ "aliases": [
1295
+ "force:package:uninstall:report"
1296
+ ],
1297
+ "args": {},
1395
1298
  "deprecateAliases": true,
1396
1299
  "examples": [
1397
- "List all first-generation package versions in your default org:\n<%= config.bin %> <%= command.id %>",
1398
- "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"
1300
+ "Retrieve the status of a package uninstall in your default org using the specified request ID:\n<%= config.bin %> <%= command.id %> --request-id 06y...",
1301
+ "Similar to previous example, but use the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --request-id 06y... --target-org me@example.com"
1399
1302
  ],
1400
1303
  "flags": {
1401
1304
  "json": {
@@ -1449,15 +1352,15 @@
1449
1352
  "multiple": false,
1450
1353
  "type": "option"
1451
1354
  },
1452
- "package-id": {
1355
+ "request-id": {
1453
1356
  "aliases": [
1454
- "packageid"
1357
+ "requestid"
1455
1358
  ],
1456
1359
  "char": "i",
1457
1360
  "deprecateAliases": true,
1458
- "description": "If not specified, shows all versions for all packages (managed and unmanaged) in the org.",
1459
- "name": "package-id",
1460
- "summary": "Metadata package ID (starts with 033) whose package versions you want to list.",
1361
+ "name": "request-id",
1362
+ "required": true,
1363
+ "summary": "ID of the package uninstall request you want to check; starts with 06y.",
1461
1364
  "hasDynamicHelp": false,
1462
1365
  "multiple": false,
1463
1366
  "type": "option"
@@ -1465,65 +1368,69 @@
1465
1368
  },
1466
1369
  "hasDynamicHelp": true,
1467
1370
  "hiddenAliases": [],
1468
- "id": "package1:version:list",
1371
+ "id": "package:uninstall:report",
1469
1372
  "pluginAlias": "@salesforce/plugin-packaging",
1470
1373
  "pluginName": "@salesforce/plugin-packaging",
1471
1374
  "pluginType": "core",
1472
1375
  "strict": true,
1473
- "summary": "List package versions for the specified first-generation package or for the org.",
1376
+ "summary": "Retrieve the status of a package uninstall request.",
1474
1377
  "enableJsonFlag": true,
1475
1378
  "isESM": true,
1476
1379
  "relativePath": [
1477
1380
  "lib",
1478
1381
  "commands",
1479
- "package1",
1480
- "version",
1481
- "list.js"
1382
+ "package",
1383
+ "uninstall",
1384
+ "report.js"
1482
1385
  ],
1483
1386
  "aliasPermutations": [
1484
- "force:package1:version:list",
1485
- "package1:force:version:list",
1486
- "package1:version:force:list",
1487
- "package1:version:list:force",
1488
- "force:version:package1:list",
1489
- "version:force:package1:list",
1490
- "version:package1:force:list",
1491
- "version:package1:list:force",
1492
- "force:version:list:package1",
1493
- "version:force:list:package1",
1494
- "version:list:force:package1",
1495
- "version:list:package1:force",
1496
- "force:package1:list:version",
1497
- "package1:force:list:version",
1498
- "package1:list:force:version",
1499
- "package1:list:version:force",
1500
- "force:list:package1:version",
1501
- "list:force:package1:version",
1502
- "list:package1:force:version",
1503
- "list:package1:version:force",
1504
- "force:list:version:package1",
1505
- "list:force:version:package1",
1506
- "list:version:force:package1",
1507
- "list:version:package1:force"
1387
+ "force:package:uninstall:report",
1388
+ "package:force:uninstall:report",
1389
+ "package:uninstall:force:report",
1390
+ "package:uninstall:report:force",
1391
+ "force:uninstall:package:report",
1392
+ "uninstall:force:package:report",
1393
+ "uninstall:package:force:report",
1394
+ "uninstall:package:report:force",
1395
+ "force:uninstall:report:package",
1396
+ "uninstall:force:report:package",
1397
+ "uninstall:report:force:package",
1398
+ "uninstall:report:package:force",
1399
+ "force:package:report:uninstall",
1400
+ "package:force:report:uninstall",
1401
+ "package:report:force:uninstall",
1402
+ "package:report:uninstall:force",
1403
+ "force:report:package:uninstall",
1404
+ "report:force:package:uninstall",
1405
+ "report:package:force:uninstall",
1406
+ "report:package:uninstall:force",
1407
+ "force:report:uninstall:package",
1408
+ "report:force:uninstall:package",
1409
+ "report:uninstall:force:package",
1410
+ "report:uninstall:package:force"
1508
1411
  ],
1509
1412
  "permutations": [
1510
- "package1:version:list",
1511
- "version:package1:list",
1512
- "version:list:package1",
1513
- "package1:list:version",
1514
- "list:package1:version",
1515
- "list:version:package1"
1413
+ "package:uninstall:report",
1414
+ "uninstall:package:report",
1415
+ "uninstall:report:package",
1416
+ "package:report:uninstall",
1417
+ "report:package:uninstall",
1418
+ "report:uninstall:package"
1516
1419
  ]
1517
1420
  },
1518
- "package:install:report": {
1421
+ "package:version:create": {
1519
1422
  "aliases": [
1520
- "force:package:install:report"
1423
+ "force:package:version:create"
1521
1424
  ],
1522
1425
  "args": {},
1523
1426
  "deprecateAliases": true,
1427
+ "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.",
1524
1428
  "examples": [
1525
- "Retrieve the status of a package installation request with the specified ID on your default org:\n<%= config.bin %> <%= command.id %> --request-id 0Hf...",
1526
- "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"
1429
+ "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",
1430
+ "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",
1431
+ "Create a package version from a package with the specified ID:\n<%= config.bin %> <%= command.id %> --package 0Ho... --installation-key password123",
1432
+ "Create a package version and skip the validation step:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --skip-validation",
1433
+ "Create a package version and perform package validations asynchronously:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --async-validation"
1527
1434
  ],
1528
1435
  "flags": {
1529
1436
  "json": {
@@ -1541,17 +1448,27 @@
1541
1448
  "multiple": false,
1542
1449
  "type": "option"
1543
1450
  },
1544
- "target-org": {
1451
+ "loglevel": {
1452
+ "deprecated": {
1453
+ "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."
1454
+ },
1455
+ "hidden": true,
1456
+ "name": "loglevel",
1457
+ "hasDynamicHelp": false,
1458
+ "multiple": false,
1459
+ "type": "option"
1460
+ },
1461
+ "target-dev-hub": {
1545
1462
  "aliases": [
1546
- "targetusername",
1547
- "u"
1463
+ "targetdevhubusername",
1464
+ "target-hub-org"
1548
1465
  ],
1549
- "char": "o",
1466
+ "char": "v",
1550
1467
  "deprecateAliases": true,
1551
- "name": "target-org",
1468
+ "name": "target-dev-hub",
1552
1469
  "noCacheDefault": true,
1553
1470
  "required": true,
1554
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1471
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1555
1472
  "hasDynamicHelp": true,
1556
1473
  "multiple": false,
1557
1474
  "type": "option"
@@ -1567,715 +1484,622 @@
1567
1484
  "multiple": false,
1568
1485
  "type": "option"
1569
1486
  },
1570
- "loglevel": {
1571
- "deprecated": {
1572
- "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."
1573
- },
1574
- "hidden": true,
1575
- "name": "loglevel",
1487
+ "branch": {
1488
+ "char": "b",
1489
+ "name": "branch",
1490
+ "summary": "Name of the branch in your source control system that the package version is based on.",
1576
1491
  "hasDynamicHelp": false,
1577
1492
  "multiple": false,
1578
1493
  "type": "option"
1579
1494
  },
1580
- "request-id": {
1495
+ "build-instance": {
1581
1496
  "aliases": [
1582
- "requestid"
1497
+ "buildinstance"
1583
1498
  ],
1584
- "char": "i",
1499
+ "char": "s",
1585
1500
  "deprecateAliases": true,
1586
- "name": "request-id",
1587
- "required": true,
1588
- "summary": "ID of the package install request you want to check; starts with 0Hf.",
1501
+ "hidden": true,
1502
+ "name": "build-instance",
1503
+ "summary": "Instance where the package version will be created, such as NA50.",
1589
1504
  "hasDynamicHelp": false,
1590
1505
  "multiple": false,
1591
1506
  "type": "option"
1592
- }
1593
- },
1594
- "hasDynamicHelp": true,
1595
- "hiddenAliases": [],
1596
- "id": "package:install:report",
1597
- "pluginAlias": "@salesforce/plugin-packaging",
1598
- "pluginName": "@salesforce/plugin-packaging",
1599
- "pluginType": "core",
1600
- "strict": true,
1601
- "summary": "Retrieve the status of a package installation request.",
1602
- "enableJsonFlag": true,
1603
- "isESM": true,
1604
- "relativePath": [
1605
- "lib",
1606
- "commands",
1607
- "package",
1608
- "install",
1609
- "report.js"
1610
- ],
1611
- "aliasPermutations": [
1612
- "force:package:install:report",
1613
- "package:force:install:report",
1614
- "package:install:force:report",
1615
- "package:install:report:force",
1616
- "force:install:package:report",
1617
- "install:force:package:report",
1618
- "install:package:force:report",
1619
- "install:package:report:force",
1620
- "force:install:report:package",
1621
- "install:force:report:package",
1622
- "install:report:force:package",
1623
- "install:report:package:force",
1624
- "force:package:report:install",
1625
- "package:force:report:install",
1626
- "package:report:force:install",
1627
- "package:report:install:force",
1628
- "force:report:package:install",
1629
- "report:force:package:install",
1630
- "report:package:force:install",
1631
- "report:package:install:force",
1632
- "force:report:install:package",
1633
- "report:force:install:package",
1634
- "report:install:force:package",
1635
- "report:install:package:force"
1636
- ],
1637
- "permutations": [
1638
- "package:install:report",
1639
- "install:package:report",
1640
- "install:report:package",
1641
- "package:report:install",
1642
- "report:package:install",
1643
- "report:install:package"
1644
- ]
1645
- },
1646
- "package:installed:list": {
1647
- "aliases": [
1648
- "force:package:installed:list"
1649
- ],
1650
- "args": {},
1651
- "deprecateAliases": true,
1652
- "examples": [
1653
- "List the installed packages in your default org:\n<%= config.bin %> <%= command.id %>",
1654
- "List the installed packages in the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --target-org me@example.com"
1655
- ],
1656
- "flags": {
1657
- "json": {
1658
- "description": "Format output as json.",
1659
- "helpGroup": "GLOBAL",
1660
- "name": "json",
1661
- "allowNo": false,
1662
- "type": "boolean"
1663
1507
  },
1664
- "flags-dir": {
1665
- "helpGroup": "GLOBAL",
1666
- "name": "flags-dir",
1667
- "summary": "Import flag values from a directory.",
1668
- "hasDynamicHelp": false,
1669
- "multiple": false,
1670
- "type": "option"
1508
+ "code-coverage": {
1509
+ "aliases": [
1510
+ "codecoverage"
1511
+ ],
1512
+ "char": "c",
1513
+ "deprecateAliases": true,
1514
+ "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.",
1515
+ "exclusive": [
1516
+ "skip-validation"
1517
+ ],
1518
+ "name": "code-coverage",
1519
+ "summary": "Calculate and store the code coverage percentage by running the packaged Apex tests included in this package version.",
1520
+ "allowNo": false,
1521
+ "type": "boolean"
1671
1522
  },
1672
- "loglevel": {
1673
- "deprecated": {
1674
- "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."
1675
- },
1676
- "hidden": true,
1677
- "name": "loglevel",
1523
+ "definition-file": {
1524
+ "aliases": [
1525
+ "definitionfile"
1526
+ ],
1527
+ "char": "f",
1528
+ "deprecateAliases": true,
1529
+ "description": "For a patch version, the features specified in this file are ignored, and instead the features specified for the ancestor version are used.",
1530
+ "name": "definition-file",
1531
+ "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.",
1678
1532
  "hasDynamicHelp": false,
1679
1533
  "multiple": false,
1680
1534
  "type": "option"
1681
1535
  },
1682
- "target-org": {
1536
+ "installation-key": {
1683
1537
  "aliases": [
1684
- "targetusername",
1685
- "u"
1538
+ "installationkey"
1686
1539
  ],
1687
- "char": "o",
1540
+ "char": "k",
1688
1541
  "deprecateAliases": true,
1689
- "name": "target-org",
1690
- "noCacheDefault": true,
1691
- "required": true,
1692
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1693
- "hasDynamicHelp": true,
1542
+ "name": "installation-key",
1543
+ "summary": "Installation key for key-protected package. (either --installation-key or --installation-key-bypass is required)",
1544
+ "hasDynamicHelp": false,
1694
1545
  "multiple": false,
1695
1546
  "type": "option"
1696
1547
  },
1697
- "api-version": {
1548
+ "installation-key-bypass": {
1698
1549
  "aliases": [
1699
- "apiversion"
1550
+ "installationkeybypass"
1700
1551
  ],
1552
+ "char": "x",
1701
1553
  "deprecateAliases": true,
1702
- "description": "Override the api version used for api requests made by this command",
1703
- "name": "api-version",
1704
- "hasDynamicHelp": false,
1705
- "multiple": false,
1706
- "type": "option"
1707
- }
1708
- },
1709
- "hasDynamicHelp": true,
1710
- "hiddenAliases": [],
1711
- "id": "package:installed:list",
1712
- "pluginAlias": "@salesforce/plugin-packaging",
1713
- "pluginName": "@salesforce/plugin-packaging",
1714
- "pluginType": "core",
1715
- "strict": true,
1716
- "summary": "List the org’s installed packages.",
1717
- "enableJsonFlag": true,
1718
- "isESM": true,
1719
- "relativePath": [
1720
- "lib",
1721
- "commands",
1722
- "package",
1723
- "installed",
1724
- "list.js"
1725
- ],
1726
- "aliasPermutations": [
1727
- "force:package:installed:list",
1728
- "package:force:installed:list",
1729
- "package:installed:force:list",
1730
- "package:installed:list:force",
1731
- "force:installed:package:list",
1732
- "installed:force:package:list",
1733
- "installed:package:force:list",
1734
- "installed:package:list:force",
1735
- "force:installed:list:package",
1736
- "installed:force:list:package",
1737
- "installed:list:force:package",
1738
- "installed:list:package:force",
1739
- "force:package:list:installed",
1740
- "package:force:list:installed",
1741
- "package:list:force:installed",
1742
- "package:list:installed:force",
1743
- "force:list:package:installed",
1744
- "list:force:package:installed",
1745
- "list:package:force:installed",
1746
- "list:package:installed:force",
1747
- "force:list:installed:package",
1748
- "list:force:installed:package",
1749
- "list:installed:force:package",
1750
- "list:installed:package:force"
1751
- ],
1752
- "permutations": [
1753
- "package:installed:list",
1754
- "installed:package:list",
1755
- "installed:list:package",
1756
- "package:list:installed",
1757
- "list:package:installed",
1758
- "list:installed:package"
1759
- ]
1760
- },
1761
- "package:uninstall:report": {
1762
- "aliases": [
1763
- "force:package:uninstall:report"
1764
- ],
1765
- "args": {},
1766
- "deprecateAliases": true,
1767
- "examples": [
1768
- "Retrieve the status of a package uninstall in your default org using the specified request ID:\n<%= config.bin %> <%= command.id %> --request-id 06y...",
1769
- "Similar to previous example, but use the org with username me@example.com:\n<%= config.bin %> <%= command.id %> --request-id 06y... --target-org me@example.com"
1770
- ],
1771
- "flags": {
1772
- "json": {
1773
- "description": "Format output as json.",
1774
- "helpGroup": "GLOBAL",
1775
- "name": "json",
1554
+ "description": "If you bypass this requirement, anyone can install your package.",
1555
+ "name": "installation-key-bypass",
1556
+ "summary": "Bypass the installation key requirement. (either --installation-key or --installation-key-bypass is required)",
1776
1557
  "allowNo": false,
1777
1558
  "type": "boolean"
1778
1559
  },
1779
- "flags-dir": {
1780
- "helpGroup": "GLOBAL",
1781
- "name": "flags-dir",
1782
- "summary": "Import flag values from a directory.",
1560
+ "package": {
1561
+ "char": "p",
1562
+ "name": "package",
1563
+ "summary": "ID (starts with 0Ho) or alias of the package to create a version of.",
1783
1564
  "hasDynamicHelp": false,
1784
1565
  "multiple": false,
1785
1566
  "type": "option"
1786
1567
  },
1787
- "loglevel": {
1788
- "deprecated": {
1789
- "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."
1790
- },
1791
- "hidden": true,
1792
- "name": "loglevel",
1568
+ "path": {
1569
+ "char": "d",
1570
+ "name": "path",
1571
+ "summary": "Path to the directory that contains the contents of the package.",
1793
1572
  "hasDynamicHelp": false,
1794
1573
  "multiple": false,
1795
1574
  "type": "option"
1796
1575
  },
1797
- "target-org": {
1576
+ "post-install-script": {
1798
1577
  "aliases": [
1799
- "targetusername",
1800
- "u"
1578
+ "postinstallscript"
1801
1579
  ],
1802
- "char": "o",
1803
1580
  "deprecateAliases": true,
1804
- "name": "target-org",
1805
- "noCacheDefault": true,
1806
- "required": true,
1807
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1808
- "hasDynamicHelp": true,
1581
+ "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.",
1582
+ "name": "post-install-script",
1583
+ "summary": "Name of the post-install script; applies to managed packages only.",
1584
+ "hasDynamicHelp": false,
1809
1585
  "multiple": false,
1810
1586
  "type": "option"
1811
1587
  },
1812
- "api-version": {
1588
+ "post-install-url": {
1813
1589
  "aliases": [
1814
- "apiversion"
1590
+ "postinstallurl"
1815
1591
  ],
1816
1592
  "deprecateAliases": true,
1817
- "description": "Override the api version used for api requests made by this command",
1818
- "name": "api-version",
1593
+ "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
1594
+ "name": "post-install-url",
1595
+ "summary": "Post-install instructions URL.",
1819
1596
  "hasDynamicHelp": false,
1820
1597
  "multiple": false,
1821
1598
  "type": "option"
1822
1599
  },
1823
- "request-id": {
1600
+ "preserve": {
1601
+ "char": "r",
1602
+ "hidden": true,
1603
+ "name": "preserve",
1604
+ "summary": "Preserve temp files that would otherwise be deleted.",
1605
+ "allowNo": false,
1606
+ "type": "boolean"
1607
+ },
1608
+ "releasenotes-url": {
1824
1609
  "aliases": [
1825
- "requestid"
1610
+ "releasenotesurl"
1826
1611
  ],
1827
- "char": "i",
1828
1612
  "deprecateAliases": true,
1829
- "name": "request-id",
1830
- "required": true,
1831
- "summary": "ID of the package uninstall request you want to check; starts with 06y.",
1613
+ "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
1614
+ "name": "releasenotes-url",
1615
+ "summary": "Release notes URL.",
1832
1616
  "hasDynamicHelp": false,
1833
1617
  "multiple": false,
1834
1618
  "type": "option"
1835
- }
1836
- },
1837
- "hasDynamicHelp": true,
1838
- "hiddenAliases": [],
1839
- "id": "package:uninstall:report",
1840
- "pluginAlias": "@salesforce/plugin-packaging",
1841
- "pluginName": "@salesforce/plugin-packaging",
1842
- "pluginType": "core",
1843
- "strict": true,
1844
- "summary": "Retrieve the status of a package uninstall request.",
1845
- "enableJsonFlag": true,
1846
- "isESM": true,
1847
- "relativePath": [
1848
- "lib",
1849
- "commands",
1850
- "package",
1851
- "uninstall",
1852
- "report.js"
1853
- ],
1854
- "aliasPermutations": [
1855
- "force:package:uninstall:report",
1856
- "package:force:uninstall:report",
1857
- "package:uninstall:force:report",
1858
- "package:uninstall:report:force",
1859
- "force:uninstall:package:report",
1860
- "uninstall:force:package:report",
1861
- "uninstall:package:force:report",
1862
- "uninstall:package:report:force",
1863
- "force:uninstall:report:package",
1864
- "uninstall:force:report:package",
1865
- "uninstall:report:force:package",
1866
- "uninstall:report:package:force",
1867
- "force:package:report:uninstall",
1868
- "package:force:report:uninstall",
1869
- "package:report:force:uninstall",
1870
- "package:report:uninstall:force",
1871
- "force:report:package:uninstall",
1872
- "report:force:package:uninstall",
1873
- "report:package:force:uninstall",
1874
- "report:package:uninstall:force",
1875
- "force:report:uninstall:package",
1876
- "report:force:uninstall:package",
1877
- "report:uninstall:force:package",
1878
- "report:uninstall:package:force"
1879
- ],
1880
- "permutations": [
1881
- "package:uninstall:report",
1882
- "uninstall:package:report",
1883
- "uninstall:report:package",
1884
- "package:report:uninstall",
1885
- "report:package:uninstall",
1886
- "report:uninstall:package"
1887
- ]
1888
- },
1889
- "package:version:create": {
1890
- "aliases": [
1891
- "force:package:version:create"
1892
- ],
1893
- "args": {},
1894
- "deprecateAliases": true,
1895
- "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.",
1896
- "examples": [
1897
- "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",
1898
- "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",
1899
- "Create a package version from a package with the specified ID:\n<%= config.bin %> <%= command.id %> --package 0Ho... --installation-key password123",
1900
- "Create a package version and skip the validation step:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --skip-validation",
1901
- "Create a package version and perform package validations asynchronously:\n<%= config.bin %> <%= command.id %> --path common --installation-key password123 --async-validation"
1902
- ],
1903
- "flags": {
1904
- "json": {
1905
- "description": "Format output as json.",
1906
- "helpGroup": "GLOBAL",
1907
- "name": "json",
1619
+ },
1620
+ "skip-ancestor-check": {
1621
+ "aliases": [
1622
+ "skipancestorcheck"
1623
+ ],
1624
+ "deprecateAliases": true,
1625
+ "name": "skip-ancestor-check",
1626
+ "summary": "Overrides ancestry requirements, which allows you to specify a package ancestor that isn’t the highest released package version.",
1908
1627
  "allowNo": false,
1909
1628
  "type": "boolean"
1910
1629
  },
1911
- "flags-dir": {
1912
- "helpGroup": "GLOBAL",
1913
- "name": "flags-dir",
1914
- "summary": "Import flag values from a directory.",
1630
+ "skip-validation": {
1631
+ "aliases": [
1632
+ "skipvalidation"
1633
+ ],
1634
+ "deprecateAliases": true,
1635
+ "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.",
1636
+ "exclusive": [
1637
+ "code-coverage",
1638
+ "async-validation"
1639
+ ],
1640
+ "name": "skip-validation",
1641
+ "summary": "Skip validation during package version creation; you can’t promote unvalidated package versions.",
1642
+ "allowNo": false,
1643
+ "type": "boolean"
1644
+ },
1645
+ "async-validation": {
1646
+ "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.",
1647
+ "exclusive": [
1648
+ "skip-validation"
1649
+ ],
1650
+ "name": "async-validation",
1651
+ "summary": "Return a new package version before completing package validations.",
1652
+ "allowNo": false,
1653
+ "type": "boolean"
1654
+ },
1655
+ "tag": {
1656
+ "char": "t",
1657
+ "name": "tag",
1658
+ "summary": "Package version’s tag.",
1915
1659
  "hasDynamicHelp": false,
1916
1660
  "multiple": false,
1917
1661
  "type": "option"
1918
1662
  },
1919
- "loglevel": {
1920
- "deprecated": {
1921
- "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."
1922
- },
1923
- "hidden": true,
1924
- "name": "loglevel",
1663
+ "uninstall-script": {
1664
+ "aliases": [
1665
+ "uninstallscript"
1666
+ ],
1667
+ "deprecateAliases": true,
1668
+ "description": "The uninstall script is an Apex class within this package that is run in the installing org after uninstallations of this package.",
1669
+ "name": "uninstall-script",
1670
+ "summary": "Uninstall script name; applies to managed packages only.",
1925
1671
  "hasDynamicHelp": false,
1926
1672
  "multiple": false,
1927
1673
  "type": "option"
1928
1674
  },
1929
- "target-dev-hub": {
1675
+ "validate-schema": {
1930
1676
  "aliases": [
1931
- "targetdevhubusername",
1932
- "target-hub-org"
1677
+ "validateschema"
1933
1678
  ],
1934
- "char": "v",
1679
+ "char": "j",
1935
1680
  "deprecateAliases": true,
1936
- "name": "target-dev-hub",
1937
- "noCacheDefault": true,
1938
- "required": true,
1939
- "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1940
- "hasDynamicHelp": true,
1941
- "multiple": false,
1942
- "type": "option"
1681
+ "hidden": true,
1682
+ "name": "validate-schema",
1683
+ "summary": "Validate the sfdx-project.json file against the JSON schema.",
1684
+ "allowNo": false,
1685
+ "type": "boolean"
1943
1686
  },
1944
- "api-version": {
1687
+ "version-description": {
1945
1688
  "aliases": [
1946
- "apiversion"
1689
+ "versiondescription"
1947
1690
  ],
1691
+ "char": "e",
1948
1692
  "deprecateAliases": true,
1949
- "description": "Override the api version used for api requests made by this command",
1950
- "name": "api-version",
1693
+ "name": "version-description",
1694
+ "summary": "Description of the package version to be created; overrides the sfdx-project.json value.",
1951
1695
  "hasDynamicHelp": false,
1952
1696
  "multiple": false,
1953
1697
  "type": "option"
1954
1698
  },
1955
- "branch": {
1956
- "char": "b",
1957
- "name": "branch",
1958
- "summary": "Name of the branch in your source control system that the package version is based on.",
1699
+ "version-name": {
1700
+ "aliases": [
1701
+ "versionname"
1702
+ ],
1703
+ "char": "a",
1704
+ "deprecateAliases": true,
1705
+ "name": "version-name",
1706
+ "summary": "Name of the package version to be created; overrides the sfdx-project.json value.",
1959
1707
  "hasDynamicHelp": false,
1960
1708
  "multiple": false,
1961
1709
  "type": "option"
1962
1710
  },
1963
- "build-instance": {
1711
+ "version-number": {
1964
1712
  "aliases": [
1965
- "buildinstance"
1713
+ "versionnumber"
1966
1714
  ],
1967
- "char": "s",
1715
+ "char": "n",
1968
1716
  "deprecateAliases": true,
1969
- "hidden": true,
1970
- "name": "build-instance",
1971
- "summary": "Instance where the package version will be created, such as NA50.",
1717
+ "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.",
1718
+ "name": "version-number",
1719
+ "summary": "Version number of the package version to be created; overrides the sfdx-project.json value.",
1972
1720
  "hasDynamicHelp": false,
1973
1721
  "multiple": false,
1974
1722
  "type": "option"
1975
1723
  },
1976
- "code-coverage": {
1977
- "aliases": [
1978
- "codecoverage"
1979
- ],
1980
- "char": "c",
1981
- "deprecateAliases": true,
1982
- "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.",
1983
- "exclusive": [
1984
- "skip-validation"
1985
- ],
1986
- "name": "code-coverage",
1987
- "summary": "Calculate and store the code coverage percentage by running the packaged Apex tests included in this package version.",
1724
+ "wait": {
1725
+ "char": "w",
1726
+ "name": "wait",
1727
+ "summary": "Number of minutes to wait for the package version to be created.",
1728
+ "hasDynamicHelp": true,
1729
+ "multiple": false,
1730
+ "type": "option"
1731
+ },
1732
+ "language": {
1733
+ "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.",
1734
+ "name": "language",
1735
+ "summary": "Language for the package.",
1736
+ "hasDynamicHelp": false,
1737
+ "multiple": false,
1738
+ "type": "option"
1739
+ },
1740
+ "verbose": {
1741
+ "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.",
1742
+ "name": "verbose",
1743
+ "summary": "Display verbose command output.",
1744
+ "allowNo": false,
1745
+ "type": "boolean"
1746
+ }
1747
+ },
1748
+ "hasDynamicHelp": true,
1749
+ "hiddenAliases": [],
1750
+ "id": "package:version:create",
1751
+ "pluginAlias": "@salesforce/plugin-packaging",
1752
+ "pluginName": "@salesforce/plugin-packaging",
1753
+ "pluginType": "core",
1754
+ "strict": true,
1755
+ "summary": "Create a package version in the Dev Hub org.",
1756
+ "enableJsonFlag": true,
1757
+ "requiresProject": true,
1758
+ "isESM": true,
1759
+ "relativePath": [
1760
+ "lib",
1761
+ "commands",
1762
+ "package",
1763
+ "version",
1764
+ "create.js"
1765
+ ],
1766
+ "aliasPermutations": [
1767
+ "force:package:version:create",
1768
+ "package:force:version:create",
1769
+ "package:version:force:create",
1770
+ "package:version:create:force",
1771
+ "force:version:package:create",
1772
+ "version:force:package:create",
1773
+ "version:package:force:create",
1774
+ "version:package:create:force",
1775
+ "force:version:create:package",
1776
+ "version:force:create:package",
1777
+ "version:create:force:package",
1778
+ "version:create:package:force",
1779
+ "force:package:create:version",
1780
+ "package:force:create:version",
1781
+ "package:create:force:version",
1782
+ "package:create:version:force",
1783
+ "force:create:package:version",
1784
+ "create:force:package:version",
1785
+ "create:package:force:version",
1786
+ "create:package:version:force",
1787
+ "force:create:version:package",
1788
+ "create:force:version:package",
1789
+ "create:version:force:package",
1790
+ "create:version:package:force"
1791
+ ],
1792
+ "permutations": [
1793
+ "package:version:create",
1794
+ "version:package:create",
1795
+ "version:create:package",
1796
+ "package:create:version",
1797
+ "create:package:version",
1798
+ "create:version:package"
1799
+ ]
1800
+ },
1801
+ "package:version:delete": {
1802
+ "aliases": [
1803
+ "force:package:version:delete"
1804
+ ],
1805
+ "args": {},
1806
+ "deprecateAliases": true,
1807
+ "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.",
1808
+ "examples": [
1809
+ "Delete a package version with the specified alias using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\"",
1810
+ "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"
1811
+ ],
1812
+ "flags": {
1813
+ "json": {
1814
+ "description": "Format output as json.",
1815
+ "helpGroup": "GLOBAL",
1816
+ "name": "json",
1988
1817
  "allowNo": false,
1989
1818
  "type": "boolean"
1990
1819
  },
1991
- "definition-file": {
1992
- "aliases": [
1993
- "definitionfile"
1994
- ],
1995
- "char": "f",
1996
- "deprecateAliases": true,
1997
- "description": "For a patch version, the features specified in this file are ignored, and instead the features specified for the ancestor version are used.",
1998
- "name": "definition-file",
1999
- "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.",
1820
+ "flags-dir": {
1821
+ "helpGroup": "GLOBAL",
1822
+ "name": "flags-dir",
1823
+ "summary": "Import flag values from a directory.",
2000
1824
  "hasDynamicHelp": false,
2001
1825
  "multiple": false,
2002
1826
  "type": "option"
2003
1827
  },
2004
- "installation-key": {
2005
- "aliases": [
2006
- "installationkey"
2007
- ],
2008
- "char": "k",
2009
- "deprecateAliases": true,
2010
- "name": "installation-key",
2011
- "summary": "Installation key for key-protected package. (either --installation-key or --installation-key-bypass is required)",
1828
+ "loglevel": {
1829
+ "deprecated": {
1830
+ "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."
1831
+ },
1832
+ "hidden": true,
1833
+ "name": "loglevel",
2012
1834
  "hasDynamicHelp": false,
2013
1835
  "multiple": false,
2014
1836
  "type": "option"
2015
1837
  },
2016
- "installation-key-bypass": {
1838
+ "target-dev-hub": {
2017
1839
  "aliases": [
2018
- "installationkeybypass"
1840
+ "targetdevhubusername",
1841
+ "target-hub-org"
2019
1842
  ],
2020
- "char": "x",
1843
+ "char": "v",
2021
1844
  "deprecateAliases": true,
2022
- "description": "If you bypass this requirement, anyone can install your package.",
2023
- "name": "installation-key-bypass",
2024
- "summary": "Bypass the installation key requirement. (either --installation-key or --installation-key-bypass is required)",
2025
- "allowNo": false,
2026
- "type": "boolean"
2027
- },
2028
- "package": {
2029
- "char": "p",
2030
- "name": "package",
2031
- "summary": "ID (starts with 0Ho) or alias of the package to create a version of.",
2032
- "hasDynamicHelp": false,
2033
- "multiple": false,
2034
- "type": "option"
2035
- },
2036
- "path": {
2037
- "char": "d",
2038
- "name": "path",
2039
- "summary": "Path to the directory that contains the contents of the package.",
2040
- "hasDynamicHelp": false,
1845
+ "name": "target-dev-hub",
1846
+ "noCacheDefault": true,
1847
+ "required": true,
1848
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1849
+ "hasDynamicHelp": true,
2041
1850
  "multiple": false,
2042
1851
  "type": "option"
2043
1852
  },
2044
- "post-install-script": {
1853
+ "api-version": {
2045
1854
  "aliases": [
2046
- "postinstallscript"
1855
+ "apiversion"
2047
1856
  ],
2048
1857
  "deprecateAliases": true,
2049
- "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.",
2050
- "name": "post-install-script",
2051
- "summary": "Name of the post-install script; applies to managed packages only.",
1858
+ "description": "Override the api version used for api requests made by this command",
1859
+ "name": "api-version",
2052
1860
  "hasDynamicHelp": false,
2053
1861
  "multiple": false,
2054
1862
  "type": "option"
2055
1863
  },
2056
- "post-install-url": {
1864
+ "no-prompt": {
2057
1865
  "aliases": [
2058
- "postinstallurl"
1866
+ "noprompt"
2059
1867
  ],
1868
+ "char": "n",
2060
1869
  "deprecateAliases": true,
2061
- "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
2062
- "name": "post-install-url",
2063
- "summary": "Post-install instructions URL.",
2064
- "hasDynamicHelp": false,
2065
- "multiple": false,
2066
- "type": "option"
2067
- },
2068
- "preserve": {
2069
- "char": "r",
2070
- "hidden": true,
2071
- "name": "preserve",
2072
- "summary": "Preserve temp files that would otherwise be deleted.",
1870
+ "name": "no-prompt",
1871
+ "summary": "Don’t prompt before deleting the package version.",
2073
1872
  "allowNo": false,
2074
1873
  "type": "boolean"
2075
1874
  },
2076
- "releasenotes-url": {
2077
- "aliases": [
2078
- "releasenotesurl"
2079
- ],
2080
- "deprecateAliases": true,
2081
- "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
2082
- "name": "releasenotes-url",
2083
- "summary": "Release notes URL.",
1875
+ "package": {
1876
+ "char": "p",
1877
+ "name": "package",
1878
+ "required": true,
1879
+ "summary": "ID (starts with 04t) or alias of the package version to delete.",
2084
1880
  "hasDynamicHelp": false,
2085
1881
  "multiple": false,
2086
1882
  "type": "option"
2087
1883
  },
2088
- "skip-ancestor-check": {
2089
- "aliases": [
2090
- "skipancestorcheck"
2091
- ],
2092
- "deprecateAliases": true,
2093
- "name": "skip-ancestor-check",
2094
- "summary": "Overrides ancestry requirements, which allows you to specify a package ancestor that isn’t the highest released package version.",
2095
- "allowNo": false,
2096
- "type": "boolean"
2097
- },
2098
- "skip-validation": {
2099
- "aliases": [
2100
- "skipvalidation"
2101
- ],
2102
- "deprecateAliases": true,
2103
- "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.",
2104
- "exclusive": [
2105
- "code-coverage",
2106
- "async-validation"
2107
- ],
2108
- "name": "skip-validation",
2109
- "summary": "Skip validation during package version creation; you can’t promote unvalidated package versions.",
1884
+ "undelete": {
1885
+ "hidden": true,
1886
+ "name": "undelete",
1887
+ "summary": "Undelete a deleted package version.",
2110
1888
  "allowNo": false,
2111
1889
  "type": "boolean"
2112
- },
2113
- "async-validation": {
2114
- "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.",
2115
- "exclusive": [
2116
- "skip-validation"
2117
- ],
2118
- "name": "async-validation",
2119
- "summary": "Return a new package version before completing package validations.",
1890
+ }
1891
+ },
1892
+ "hasDynamicHelp": true,
1893
+ "hiddenAliases": [],
1894
+ "id": "package:version:delete",
1895
+ "pluginAlias": "@salesforce/plugin-packaging",
1896
+ "pluginName": "@salesforce/plugin-packaging",
1897
+ "pluginType": "core",
1898
+ "strict": true,
1899
+ "summary": "Delete a package version.",
1900
+ "enableJsonFlag": true,
1901
+ "isESM": true,
1902
+ "relativePath": [
1903
+ "lib",
1904
+ "commands",
1905
+ "package",
1906
+ "version",
1907
+ "delete.js"
1908
+ ],
1909
+ "aliasPermutations": [
1910
+ "force:package:version:delete",
1911
+ "package:force:version:delete",
1912
+ "package:version:force:delete",
1913
+ "package:version:delete:force",
1914
+ "force:version:package:delete",
1915
+ "version:force:package:delete",
1916
+ "version:package:force:delete",
1917
+ "version:package:delete:force",
1918
+ "force:version:delete:package",
1919
+ "version:force:delete:package",
1920
+ "version:delete:force:package",
1921
+ "version:delete:package:force",
1922
+ "force:package:delete:version",
1923
+ "package:force:delete:version",
1924
+ "package:delete:force:version",
1925
+ "package:delete:version:force",
1926
+ "force:delete:package:version",
1927
+ "delete:force:package:version",
1928
+ "delete:package:force:version",
1929
+ "delete:package:version:force",
1930
+ "force:delete:version:package",
1931
+ "delete:force:version:package",
1932
+ "delete:version:force:package",
1933
+ "delete:version:package:force"
1934
+ ],
1935
+ "permutations": [
1936
+ "package:version:delete",
1937
+ "version:package:delete",
1938
+ "version:delete:package",
1939
+ "package:delete:version",
1940
+ "delete:package:version",
1941
+ "delete:version:package"
1942
+ ]
1943
+ },
1944
+ "package:version:displayancestry": {
1945
+ "aliases": [
1946
+ "force:package:version:displayancestry"
1947
+ ],
1948
+ "args": {},
1949
+ "deprecateAliases": true,
1950
+ "examples": [
1951
+ "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",
1952
+ "Similar to previous example, but display the output in DOT code:\n<%= config.bin %> <%= command.id %> --package package_version_alias --dot-code",
1953
+ "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",
1954
+ "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..."
1955
+ ],
1956
+ "flags": {
1957
+ "json": {
1958
+ "description": "Format output as json.",
1959
+ "helpGroup": "GLOBAL",
1960
+ "name": "json",
2120
1961
  "allowNo": false,
2121
1962
  "type": "boolean"
2122
1963
  },
2123
- "tag": {
2124
- "char": "t",
2125
- "name": "tag",
2126
- "summary": "Package version’s tag.",
2127
- "hasDynamicHelp": false,
2128
- "multiple": false,
2129
- "type": "option"
2130
- },
2131
- "uninstall-script": {
2132
- "aliases": [
2133
- "uninstallscript"
2134
- ],
2135
- "deprecateAliases": true,
2136
- "description": "The uninstall script is an Apex class within this package that is run in the installing org after uninstallations of this package.",
2137
- "name": "uninstall-script",
2138
- "summary": "Uninstall script name; applies to managed packages only.",
1964
+ "flags-dir": {
1965
+ "helpGroup": "GLOBAL",
1966
+ "name": "flags-dir",
1967
+ "summary": "Import flag values from a directory.",
2139
1968
  "hasDynamicHelp": false,
2140
1969
  "multiple": false,
2141
1970
  "type": "option"
2142
1971
  },
2143
- "validate-schema": {
2144
- "aliases": [
2145
- "validateschema"
2146
- ],
2147
- "char": "j",
2148
- "deprecateAliases": true,
1972
+ "loglevel": {
1973
+ "deprecated": {
1974
+ "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."
1975
+ },
2149
1976
  "hidden": true,
2150
- "name": "validate-schema",
2151
- "summary": "Validate the sfdx-project.json file against the JSON schema.",
2152
- "allowNo": false,
2153
- "type": "boolean"
2154
- },
2155
- "version-description": {
2156
- "aliases": [
2157
- "versiondescription"
2158
- ],
2159
- "char": "e",
2160
- "deprecateAliases": true,
2161
- "name": "version-description",
2162
- "summary": "Description of the package version to be created; overrides the sfdx-project.json value.",
1977
+ "name": "loglevel",
2163
1978
  "hasDynamicHelp": false,
2164
1979
  "multiple": false,
2165
1980
  "type": "option"
2166
1981
  },
2167
- "version-name": {
1982
+ "target-dev-hub": {
2168
1983
  "aliases": [
2169
- "versionname"
1984
+ "targetdevhubusername",
1985
+ "target-hub-org"
2170
1986
  ],
2171
- "char": "a",
1987
+ "char": "v",
2172
1988
  "deprecateAliases": true,
2173
- "name": "version-name",
2174
- "summary": "Name of the package version to be created; overrides the sfdx-project.json value.",
2175
- "hasDynamicHelp": false,
1989
+ "name": "target-dev-hub",
1990
+ "noCacheDefault": true,
1991
+ "required": true,
1992
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1993
+ "hasDynamicHelp": true,
2176
1994
  "multiple": false,
2177
1995
  "type": "option"
2178
1996
  },
2179
- "version-number": {
1997
+ "api-version": {
2180
1998
  "aliases": [
2181
- "versionnumber"
1999
+ "apiversion"
2182
2000
  ],
2183
- "char": "n",
2184
2001
  "deprecateAliases": true,
2185
- "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.",
2186
- "name": "version-number",
2187
- "summary": "Version number of the package version to be created; overrides the sfdx-project.json value.",
2002
+ "description": "Override the api version used for api requests made by this command",
2003
+ "name": "api-version",
2188
2004
  "hasDynamicHelp": false,
2189
2005
  "multiple": false,
2190
2006
  "type": "option"
2191
2007
  },
2192
- "wait": {
2193
- "char": "w",
2194
- "name": "wait",
2195
- "summary": "Number of minutes to wait for the package version to be created.",
2196
- "hasDynamicHelp": true,
2197
- "multiple": false,
2198
- "type": "option"
2199
- },
2200
- "language": {
2201
- "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.",
2202
- "name": "language",
2203
- "summary": "Language for the package.",
2008
+ "package": {
2009
+ "char": "p",
2010
+ "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.",
2011
+ "name": "package",
2012
+ "required": true,
2013
+ "summary": "ID or alias of the package (starts with 0Ho) or package version (starts with 04t) to display ancestry for.",
2204
2014
  "hasDynamicHelp": false,
2205
2015
  "multiple": false,
2206
2016
  "type": "option"
2207
2017
  },
2018
+ "dot-code": {
2019
+ "aliases": [
2020
+ "dotcode"
2021
+ ],
2022
+ "deprecateAliases": true,
2023
+ "description": "You can use the DOT code output in graph visualization software to create tree visualizations.",
2024
+ "name": "dot-code",
2025
+ "summary": "Display the ancestry tree in DOT code.",
2026
+ "allowNo": false,
2027
+ "type": "boolean"
2028
+ },
2208
2029
  "verbose": {
2209
- "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.",
2210
2030
  "name": "verbose",
2211
- "summary": "Display verbose command output.",
2031
+ "summary": "Display both the package version ID (starts with 04t) and the version number (major.minor.patch.build) in the ancestry tree.",
2212
2032
  "allowNo": false,
2213
2033
  "type": "boolean"
2214
2034
  }
2215
2035
  },
2216
2036
  "hasDynamicHelp": true,
2217
2037
  "hiddenAliases": [],
2218
- "id": "package:version:create",
2038
+ "id": "package:version:displayancestry",
2219
2039
  "pluginAlias": "@salesforce/plugin-packaging",
2220
2040
  "pluginName": "@salesforce/plugin-packaging",
2221
2041
  "pluginType": "core",
2222
2042
  "strict": true,
2223
- "summary": "Create a package version in the Dev Hub org.",
2043
+ "summary": "Display the ancestry tree for a 2GP managed package version.",
2224
2044
  "enableJsonFlag": true,
2225
- "requiresProject": true,
2226
2045
  "isESM": true,
2227
2046
  "relativePath": [
2228
2047
  "lib",
2229
2048
  "commands",
2230
2049
  "package",
2231
2050
  "version",
2232
- "create.js"
2051
+ "displayancestry.js"
2233
2052
  ],
2234
2053
  "aliasPermutations": [
2235
- "force:package:version:create",
2236
- "package:force:version:create",
2237
- "package:version:force:create",
2238
- "package:version:create:force",
2239
- "force:version:package:create",
2240
- "version:force:package:create",
2241
- "version:package:force:create",
2242
- "version:package:create:force",
2243
- "force:version:create:package",
2244
- "version:force:create:package",
2245
- "version:create:force:package",
2246
- "version:create:package:force",
2247
- "force:package:create:version",
2248
- "package:force:create:version",
2249
- "package:create:force:version",
2250
- "package:create:version:force",
2251
- "force:create:package:version",
2252
- "create:force:package:version",
2253
- "create:package:force:version",
2254
- "create:package:version:force",
2255
- "force:create:version:package",
2256
- "create:force:version:package",
2257
- "create:version:force:package",
2258
- "create:version:package:force"
2054
+ "force:package:version:displayancestry",
2055
+ "package:force:version:displayancestry",
2056
+ "package:version:force:displayancestry",
2057
+ "package:version:displayancestry:force",
2058
+ "force:version:package:displayancestry",
2059
+ "version:force:package:displayancestry",
2060
+ "version:package:force:displayancestry",
2061
+ "version:package:displayancestry:force",
2062
+ "force:version:displayancestry:package",
2063
+ "version:force:displayancestry:package",
2064
+ "version:displayancestry:force:package",
2065
+ "version:displayancestry:package:force",
2066
+ "force:package:displayancestry:version",
2067
+ "package:force:displayancestry:version",
2068
+ "package:displayancestry:force:version",
2069
+ "package:displayancestry:version:force",
2070
+ "force:displayancestry:package:version",
2071
+ "displayancestry:force:package:version",
2072
+ "displayancestry:package:force:version",
2073
+ "displayancestry:package:version:force",
2074
+ "force:displayancestry:version:package",
2075
+ "displayancestry:force:version:package",
2076
+ "displayancestry:version:force:package",
2077
+ "displayancestry:version:package:force"
2259
2078
  ],
2260
2079
  "permutations": [
2261
- "package:version:create",
2262
- "version:package:create",
2263
- "version:create:package",
2264
- "package:create:version",
2265
- "create:package:version",
2266
- "create:version:package"
2080
+ "package:version:displayancestry",
2081
+ "version:package:displayancestry",
2082
+ "version:displayancestry:package",
2083
+ "package:displayancestry:version",
2084
+ "displayancestry:package:version",
2085
+ "displayancestry:version:package"
2267
2086
  ]
2268
2087
  },
2269
- "package:version:delete": {
2088
+ "package:version:list": {
2270
2089
  "aliases": [
2271
- "force:package:version:delete"
2090
+ "force:package:version:list"
2272
2091
  ],
2273
2092
  "args": {},
2274
2093
  "deprecateAliases": true,
2275
- "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.",
2094
+ "description": "Description",
2276
2095
  "examples": [
2277
- "Delete a package version with the specified alias using your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package \"Your Package Alias\"",
2278
- "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"
2096
+ "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",
2097
+ "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",
2098
+ "List all released package versions in your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --released",
2099
+ "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",
2100
+ "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",
2101
+ "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",
2102
+ "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"
2279
2103
  ],
2280
2104
  "flags": {
2281
2105
  "json": {
@@ -2329,42 +2153,92 @@
2329
2153
  "multiple": false,
2330
2154
  "type": "option"
2331
2155
  },
2332
- "no-prompt": {
2156
+ "created-last-days": {
2333
2157
  "aliases": [
2334
- "noprompt"
2158
+ "createdlastdays"
2335
2159
  ],
2336
- "char": "n",
2160
+ "char": "c",
2337
2161
  "deprecateAliases": true,
2338
- "name": "no-prompt",
2339
- "summary": "Don’t prompt before deleting the package version.",
2162
+ "name": "created-last-days",
2163
+ "summary": "Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today.",
2164
+ "hasDynamicHelp": false,
2165
+ "multiple": false,
2166
+ "type": "option"
2167
+ },
2168
+ "concise": {
2169
+ "name": "concise",
2170
+ "summary": "Display limited package version details.",
2340
2171
  "allowNo": false,
2341
2172
  "type": "boolean"
2342
2173
  },
2343
- "package": {
2174
+ "show-conversions-only": {
2175
+ "name": "show-conversions-only",
2176
+ "summary": "Filter the list output to display only converted package version.",
2177
+ "allowNo": false,
2178
+ "type": "boolean"
2179
+ },
2180
+ "modified-last-days": {
2181
+ "aliases": [
2182
+ "modifiedlastdays"
2183
+ ],
2184
+ "char": "m",
2185
+ "deprecateAliases": true,
2186
+ "name": "modified-last-days",
2187
+ "summary": "Number of days since the items were modified, starting at 00:00:00 of first day to now. Use 0 for today.",
2188
+ "hasDynamicHelp": false,
2189
+ "multiple": false,
2190
+ "type": "option"
2191
+ },
2192
+ "packages": {
2344
2193
  "char": "p",
2345
- "name": "package",
2346
- "required": true,
2347
- "summary": "ID (starts with 04t) or alias of the package version to delete.",
2194
+ "name": "packages",
2195
+ "summary": "Comma-delimited list of packages (aliases or 0Ho IDs) to list.",
2348
2196
  "hasDynamicHelp": false,
2349
2197
  "multiple": false,
2350
2198
  "type": "option"
2351
2199
  },
2352
- "undelete": {
2353
- "hidden": true,
2354
- "name": "undelete",
2355
- "summary": "Undelete a deleted package version.",
2200
+ "released": {
2201
+ "char": "r",
2202
+ "name": "released",
2203
+ "summary": "Display released versions only (IsReleased=true).",
2204
+ "allowNo": false,
2205
+ "type": "boolean"
2206
+ },
2207
+ "branch": {
2208
+ "char": "b",
2209
+ "name": "branch",
2210
+ "summary": "Branch in your source control system used to filter the results; only package versions based on the specified branch are listed.",
2211
+ "hasDynamicHelp": false,
2212
+ "multiple": false,
2213
+ "type": "option"
2214
+ },
2215
+ "order-by": {
2216
+ "aliases": [
2217
+ "orderby"
2218
+ ],
2219
+ "char": "o",
2220
+ "deprecateAliases": true,
2221
+ "name": "order-by",
2222
+ "summary": "Package version fields used to order the list.",
2223
+ "hasDynamicHelp": false,
2224
+ "multiple": false,
2225
+ "type": "option"
2226
+ },
2227
+ "verbose": {
2228
+ "name": "verbose",
2229
+ "summary": "Display extended package version details.",
2356
2230
  "allowNo": false,
2357
2231
  "type": "boolean"
2358
2232
  }
2359
2233
  },
2360
2234
  "hasDynamicHelp": true,
2361
2235
  "hiddenAliases": [],
2362
- "id": "package:version:delete",
2236
+ "id": "package:version:list",
2363
2237
  "pluginAlias": "@salesforce/plugin-packaging",
2364
2238
  "pluginName": "@salesforce/plugin-packaging",
2365
2239
  "pluginType": "core",
2366
2240
  "strict": true,
2367
- "summary": "Delete a package version.",
2241
+ "summary": "List all package versions in the Dev Hub org.",
2368
2242
  "enableJsonFlag": true,
2369
2243
  "isESM": true,
2370
2244
  "relativePath": [
@@ -2372,54 +2246,54 @@
2372
2246
  "commands",
2373
2247
  "package",
2374
2248
  "version",
2375
- "delete.js"
2249
+ "list.js"
2376
2250
  ],
2377
2251
  "aliasPermutations": [
2378
- "force:package:version:delete",
2379
- "package:force:version:delete",
2380
- "package:version:force:delete",
2381
- "package:version:delete:force",
2382
- "force:version:package:delete",
2383
- "version:force:package:delete",
2384
- "version:package:force:delete",
2385
- "version:package:delete:force",
2386
- "force:version:delete:package",
2387
- "version:force:delete:package",
2388
- "version:delete:force:package",
2389
- "version:delete:package:force",
2390
- "force:package:delete:version",
2391
- "package:force:delete:version",
2392
- "package:delete:force:version",
2393
- "package:delete:version:force",
2394
- "force:delete:package:version",
2395
- "delete:force:package:version",
2396
- "delete:package:force:version",
2397
- "delete:package:version:force",
2398
- "force:delete:version:package",
2399
- "delete:force:version:package",
2400
- "delete:version:force:package",
2401
- "delete:version:package:force"
2252
+ "force:package:version:list",
2253
+ "package:force:version:list",
2254
+ "package:version:force:list",
2255
+ "package:version:list:force",
2256
+ "force:version:package:list",
2257
+ "version:force:package:list",
2258
+ "version:package:force:list",
2259
+ "version:package:list:force",
2260
+ "force:version:list:package",
2261
+ "version:force:list:package",
2262
+ "version:list:force:package",
2263
+ "version:list:package:force",
2264
+ "force:package:list:version",
2265
+ "package:force:list:version",
2266
+ "package:list:force:version",
2267
+ "package:list:version:force",
2268
+ "force:list:package:version",
2269
+ "list:force:package:version",
2270
+ "list:package:force:version",
2271
+ "list:package:version:force",
2272
+ "force:list:version:package",
2273
+ "list:force:version:package",
2274
+ "list:version:force:package",
2275
+ "list:version:package:force"
2402
2276
  ],
2403
2277
  "permutations": [
2404
- "package:version:delete",
2405
- "version:package:delete",
2406
- "version:delete:package",
2407
- "package:delete:version",
2408
- "delete:package:version",
2409
- "delete:version:package"
2278
+ "package:version:list",
2279
+ "version:package:list",
2280
+ "version:list:package",
2281
+ "package:list:version",
2282
+ "list:package:version",
2283
+ "list:version:package"
2410
2284
  ]
2411
2285
  },
2412
- "package:version:displayancestry": {
2286
+ "package:version:promote": {
2413
2287
  "aliases": [
2414
- "force:package:version:displayancestry"
2288
+ "force:package:version:promote"
2415
2289
  ],
2416
2290
  "args": {},
2417
2291
  "deprecateAliases": true,
2292
+ "description": "Supply the ID or alias of the package version you want to promote. Promotes the package version to released status.",
2418
2293
  "examples": [
2419
- "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",
2420
- "Similar to previous example, but display the output in DOT code:\n<%= config.bin %> <%= command.id %> --package package_version_alias --dot-code",
2421
- "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",
2422
- "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..."
2294
+ "Promote the package version with the specified ID to released; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
2295
+ "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",
2296
+ "Promote the package version with an alias that has spaces to released:\n<%= config.bin %> <%= command.id %> --package \"Awesome Package Alias\""
2423
2297
  ],
2424
2298
  "flags": {
2425
2299
  "json": {
@@ -2475,40 +2349,33 @@
2475
2349
  },
2476
2350
  "package": {
2477
2351
  "char": "p",
2478
- "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.",
2479
2352
  "name": "package",
2480
2353
  "required": true,
2481
- "summary": "ID or alias of the package (starts with 0Ho) or package version (starts with 04t) to display ancestry for.",
2354
+ "summary": "ID (starts with 04t) or alias of the package version to promote.",
2482
2355
  "hasDynamicHelp": false,
2483
2356
  "multiple": false,
2484
2357
  "type": "option"
2485
2358
  },
2486
- "dot-code": {
2359
+ "no-prompt": {
2487
2360
  "aliases": [
2488
- "dotcode"
2361
+ "noprompt"
2489
2362
  ],
2363
+ "char": "n",
2490
2364
  "deprecateAliases": true,
2491
- "description": "You can use the DOT code output in graph visualization software to create tree visualizations.",
2492
- "name": "dot-code",
2493
- "summary": "Display the ancestry tree in DOT code.",
2494
- "allowNo": false,
2495
- "type": "boolean"
2496
- },
2497
- "verbose": {
2498
- "name": "verbose",
2499
- "summary": "Display both the package version ID (starts with 04t) and the version number (major.minor.patch.build) in the ancestry tree.",
2365
+ "name": "no-prompt",
2366
+ "summary": "Don't prompt to confirm setting the package version as released.",
2500
2367
  "allowNo": false,
2501
2368
  "type": "boolean"
2502
2369
  }
2503
2370
  },
2504
2371
  "hasDynamicHelp": true,
2505
2372
  "hiddenAliases": [],
2506
- "id": "package:version:displayancestry",
2373
+ "id": "package:version:promote",
2507
2374
  "pluginAlias": "@salesforce/plugin-packaging",
2508
2375
  "pluginName": "@salesforce/plugin-packaging",
2509
2376
  "pluginType": "core",
2510
2377
  "strict": true,
2511
- "summary": "Display the ancestry tree for a 2GP managed package version.",
2378
+ "summary": "Promote a package version to released.",
2512
2379
  "enableJsonFlag": true,
2513
2380
  "isESM": true,
2514
2381
  "relativePath": [
@@ -2516,58 +2383,53 @@
2516
2383
  "commands",
2517
2384
  "package",
2518
2385
  "version",
2519
- "displayancestry.js"
2386
+ "promote.js"
2520
2387
  ],
2521
2388
  "aliasPermutations": [
2522
- "force:package:version:displayancestry",
2523
- "package:force:version:displayancestry",
2524
- "package:version:force:displayancestry",
2525
- "package:version:displayancestry:force",
2526
- "force:version:package:displayancestry",
2527
- "version:force:package:displayancestry",
2528
- "version:package:force:displayancestry",
2529
- "version:package:displayancestry:force",
2530
- "force:version:displayancestry:package",
2531
- "version:force:displayancestry:package",
2532
- "version:displayancestry:force:package",
2533
- "version:displayancestry:package:force",
2534
- "force:package:displayancestry:version",
2535
- "package:force:displayancestry:version",
2536
- "package:displayancestry:force:version",
2537
- "package:displayancestry:version:force",
2538
- "force:displayancestry:package:version",
2539
- "displayancestry:force:package:version",
2540
- "displayancestry:package:force:version",
2541
- "displayancestry:package:version:force",
2542
- "force:displayancestry:version:package",
2543
- "displayancestry:force:version:package",
2544
- "displayancestry:version:force:package",
2545
- "displayancestry:version:package:force"
2389
+ "force:package:version:promote",
2390
+ "package:force:version:promote",
2391
+ "package:version:force:promote",
2392
+ "package:version:promote:force",
2393
+ "force:version:package:promote",
2394
+ "version:force:package:promote",
2395
+ "version:package:force:promote",
2396
+ "version:package:promote:force",
2397
+ "force:version:promote:package",
2398
+ "version:force:promote:package",
2399
+ "version:promote:force:package",
2400
+ "version:promote:package:force",
2401
+ "force:package:promote:version",
2402
+ "package:force:promote:version",
2403
+ "package:promote:force:version",
2404
+ "package:promote:version:force",
2405
+ "force:promote:package:version",
2406
+ "promote:force:package:version",
2407
+ "promote:package:force:version",
2408
+ "promote:package:version:force",
2409
+ "force:promote:version:package",
2410
+ "promote:force:version:package",
2411
+ "promote:version:force:package",
2412
+ "promote:version:package:force"
2546
2413
  ],
2547
2414
  "permutations": [
2548
- "package:version:displayancestry",
2549
- "version:package:displayancestry",
2550
- "version:displayancestry:package",
2551
- "package:displayancestry:version",
2552
- "displayancestry:package:version",
2553
- "displayancestry:version:package"
2415
+ "package:version:promote",
2416
+ "version:package:promote",
2417
+ "version:promote:package",
2418
+ "package:promote:version",
2419
+ "promote:package:version",
2420
+ "promote:version:package"
2554
2421
  ]
2555
2422
  },
2556
- "package:version:list": {
2423
+ "package:version:report": {
2557
2424
  "aliases": [
2558
- "force:package:version:list"
2425
+ "force:package:version:report"
2559
2426
  ],
2560
2427
  "args": {},
2561
2428
  "deprecateAliases": true,
2562
- "description": "Description",
2429
+ "description": "To update package version values, run \"<%= config.bin %> package version update\".",
2563
2430
  "examples": [
2564
- "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",
2565
- "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",
2566
- "List all released package versions in your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --released",
2567
- "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",
2568
- "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",
2569
- "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",
2570
- "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"
2431
+ "Retrieve details about the package version with the specified ID from your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
2432
+ "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"
2571
2433
  ],
2572
2434
  "flags": {
2573
2435
  "json": {
@@ -2621,73 +2483,11 @@
2621
2483
  "multiple": false,
2622
2484
  "type": "option"
2623
2485
  },
2624
- "created-last-days": {
2625
- "aliases": [
2626
- "createdlastdays"
2627
- ],
2628
- "char": "c",
2629
- "deprecateAliases": true,
2630
- "name": "created-last-days",
2631
- "summary": "Number of days since the request was created, starting at 00:00:00 of first day to now. Use 0 for today.",
2632
- "hasDynamicHelp": false,
2633
- "multiple": false,
2634
- "type": "option"
2635
- },
2636
- "concise": {
2637
- "name": "concise",
2638
- "summary": "Display limited package version details.",
2639
- "allowNo": false,
2640
- "type": "boolean"
2641
- },
2642
- "show-conversions-only": {
2643
- "name": "show-conversions-only",
2644
- "summary": "Filter the list output to display only converted package version.",
2645
- "allowNo": false,
2646
- "type": "boolean"
2647
- },
2648
- "modified-last-days": {
2649
- "aliases": [
2650
- "modifiedlastdays"
2651
- ],
2652
- "char": "m",
2653
- "deprecateAliases": true,
2654
- "name": "modified-last-days",
2655
- "summary": "Number of days since the items were modified, starting at 00:00:00 of first day to now. Use 0 for today.",
2656
- "hasDynamicHelp": false,
2657
- "multiple": false,
2658
- "type": "option"
2659
- },
2660
- "packages": {
2486
+ "package": {
2661
2487
  "char": "p",
2662
- "name": "packages",
2663
- "summary": "Comma-delimited list of packages (aliases or 0Ho IDs) to list.",
2664
- "hasDynamicHelp": false,
2665
- "multiple": false,
2666
- "type": "option"
2667
- },
2668
- "released": {
2669
- "char": "r",
2670
- "name": "released",
2671
- "summary": "Display released versions only (IsReleased=true).",
2672
- "allowNo": false,
2673
- "type": "boolean"
2674
- },
2675
- "branch": {
2676
- "char": "b",
2677
- "name": "branch",
2678
- "summary": "Branch in your source control system used to filter the results; only package versions based on the specified branch are listed.",
2679
- "hasDynamicHelp": false,
2680
- "multiple": false,
2681
- "type": "option"
2682
- },
2683
- "order-by": {
2684
- "aliases": [
2685
- "orderby"
2686
- ],
2687
- "char": "o",
2688
- "deprecateAliases": true,
2689
- "name": "order-by",
2690
- "summary": "Package version fields used to order the list.",
2488
+ "name": "package",
2489
+ "required": true,
2490
+ "summary": "ID (starts with 04t) or alias of the package to retrieve details for.",
2691
2491
  "hasDynamicHelp": false,
2692
2492
  "multiple": false,
2693
2493
  "type": "option"
@@ -2701,12 +2501,12 @@
2701
2501
  },
2702
2502
  "hasDynamicHelp": true,
2703
2503
  "hiddenAliases": [],
2704
- "id": "package:version:list",
2504
+ "id": "package:version:report",
2705
2505
  "pluginAlias": "@salesforce/plugin-packaging",
2706
2506
  "pluginName": "@salesforce/plugin-packaging",
2707
2507
  "pluginType": "core",
2708
2508
  "strict": true,
2709
- "summary": "List all package versions in the Dev Hub org.",
2509
+ "summary": "Retrieve details about a package version in the Dev Hub org.",
2710
2510
  "enableJsonFlag": true,
2711
2511
  "isESM": true,
2712
2512
  "relativePath": [
@@ -2714,54 +2514,49 @@
2714
2514
  "commands",
2715
2515
  "package",
2716
2516
  "version",
2717
- "list.js"
2517
+ "report.js"
2718
2518
  ],
2719
2519
  "aliasPermutations": [
2720
- "force:package:version:list",
2721
- "package:force:version:list",
2722
- "package:version:force:list",
2723
- "package:version:list:force",
2724
- "force:version:package:list",
2725
- "version:force:package:list",
2726
- "version:package:force:list",
2727
- "version:package:list:force",
2728
- "force:version:list:package",
2729
- "version:force:list:package",
2730
- "version:list:force:package",
2731
- "version:list:package:force",
2732
- "force:package:list:version",
2733
- "package:force:list:version",
2734
- "package:list:force:version",
2735
- "package:list:version:force",
2736
- "force:list:package:version",
2737
- "list:force:package:version",
2738
- "list:package:force:version",
2739
- "list:package:version:force",
2740
- "force:list:version:package",
2741
- "list:force:version:package",
2742
- "list:version:force:package",
2743
- "list:version:package:force"
2520
+ "force:package:version:report",
2521
+ "package:force:version:report",
2522
+ "package:version:force:report",
2523
+ "package:version:report:force",
2524
+ "force:version:package:report",
2525
+ "version:force:package:report",
2526
+ "version:package:force:report",
2527
+ "version:package:report:force",
2528
+ "force:version:report:package",
2529
+ "version:force:report:package",
2530
+ "version:report:force:package",
2531
+ "version:report:package:force",
2532
+ "force:package:report:version",
2533
+ "package:force:report:version",
2534
+ "package:report:force:version",
2535
+ "package:report:version:force",
2536
+ "force:report:package:version",
2537
+ "report:force:package:version",
2538
+ "report:package:force:version",
2539
+ "report:package:version:force",
2540
+ "force:report:version:package",
2541
+ "report:force:version:package",
2542
+ "report:version:force:package",
2543
+ "report:version:package:force"
2744
2544
  ],
2745
2545
  "permutations": [
2746
- "package:version:list",
2747
- "version:package:list",
2748
- "version:list:package",
2749
- "package:list:version",
2750
- "list:package:version",
2751
- "list:version:package"
2546
+ "package:version:report",
2547
+ "version:package:report",
2548
+ "version:report:package",
2549
+ "package:report:version",
2550
+ "report:package:version",
2551
+ "report:version:package"
2752
2552
  ]
2753
2553
  },
2754
- "package:version:promote": {
2755
- "aliases": [
2756
- "force:package:version:promote"
2757
- ],
2554
+ "package:version:retrieve": {
2555
+ "aliases": [],
2758
2556
  "args": {},
2759
- "deprecateAliases": true,
2760
- "description": "Supply the ID or alias of the package version you want to promote. Promotes the package version to released status.",
2557
+ "description": "Retrieving a package version downloads the metadata into the directory you specify.\n\nYou can retrieve metadata for a second- or first-generation managed package, or an unlocked package.\n\nSpecify the subscriber package version ID (starts with 04t) and the path to an empty directory when you run this command.",
2761
2558
  "examples": [
2762
- "Promote the package version with the specified ID to released; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
2763
- "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",
2764
- "Promote the package version with an alias that has spaces to released:\n<%= config.bin %> <%= command.id %> --package \"Awesome Package Alias\""
2559
+ "Retrieve package metadata for a 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-org my-scratch\nIf you omit --target-org, this command runs against your default org."
2765
2560
  ],
2766
2561
  "flags": {
2767
2562
  "json": {
@@ -2789,29 +2584,29 @@
2789
2584
  "multiple": false,
2790
2585
  "type": "option"
2791
2586
  },
2792
- "target-dev-hub": {
2587
+ "api-version": {
2793
2588
  "aliases": [
2794
- "targetdevhubusername",
2795
- "target-hub-org"
2589
+ "apiversion"
2796
2590
  ],
2797
- "char": "v",
2798
2591
  "deprecateAliases": true,
2799
- "name": "target-dev-hub",
2800
- "noCacheDefault": true,
2801
- "required": true,
2802
- "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
2803
- "hasDynamicHelp": true,
2592
+ "description": "Override the api version used for api requests made by this command",
2593
+ "name": "api-version",
2594
+ "hasDynamicHelp": false,
2804
2595
  "multiple": false,
2805
2596
  "type": "option"
2806
2597
  },
2807
- "api-version": {
2598
+ "target-org": {
2808
2599
  "aliases": [
2809
- "apiversion"
2600
+ "targetusername",
2601
+ "u"
2810
2602
  ],
2603
+ "char": "o",
2811
2604
  "deprecateAliases": true,
2812
- "description": "Override the api version used for api requests made by this command",
2813
- "name": "api-version",
2814
- "hasDynamicHelp": false,
2605
+ "name": "target-org",
2606
+ "noCacheDefault": true,
2607
+ "required": true,
2608
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2609
+ "hasDynamicHelp": true,
2815
2610
  "multiple": false,
2816
2611
  "type": "option"
2817
2612
  },
@@ -2819,85 +2614,61 @@
2819
2614
  "char": "p",
2820
2615
  "name": "package",
2821
2616
  "required": true,
2822
- "summary": "ID (starts with 04t) or alias of the package version to promote.",
2617
+ "summary": "Subscriber package version ID (starts with 04t).",
2823
2618
  "hasDynamicHelp": false,
2824
2619
  "multiple": false,
2825
2620
  "type": "option"
2826
2621
  },
2827
- "no-prompt": {
2828
- "aliases": [
2829
- "noprompt"
2830
- ],
2831
- "char": "n",
2832
- "deprecateAliases": true,
2833
- "name": "no-prompt",
2834
- "summary": "Don't prompt to confirm setting the package version as released.",
2835
- "allowNo": false,
2836
- "type": "boolean"
2622
+ "output-dir": {
2623
+ "char": "d",
2624
+ "name": "output-dir",
2625
+ "summary": "Path within your Salesforce DX project directory in which to download the metadata. This directory must be empty.",
2626
+ "default": "force-app",
2627
+ "hasDynamicHelp": false,
2628
+ "multiple": false,
2629
+ "type": "option"
2837
2630
  }
2838
2631
  },
2839
2632
  "hasDynamicHelp": true,
2633
+ "hidden": true,
2840
2634
  "hiddenAliases": [],
2841
- "id": "package:version:promote",
2635
+ "id": "package:version:retrieve",
2842
2636
  "pluginAlias": "@salesforce/plugin-packaging",
2843
2637
  "pluginName": "@salesforce/plugin-packaging",
2844
2638
  "pluginType": "core",
2845
2639
  "strict": true,
2846
- "summary": "Promote a package version to released.",
2640
+ "summary": "Retrieve package metadata for a specified package version.",
2847
2641
  "enableJsonFlag": true,
2642
+ "requiresProject": true,
2848
2643
  "isESM": true,
2849
2644
  "relativePath": [
2850
2645
  "lib",
2851
2646
  "commands",
2852
2647
  "package",
2853
2648
  "version",
2854
- "promote.js"
2855
- ],
2856
- "aliasPermutations": [
2857
- "force:package:version:promote",
2858
- "package:force:version:promote",
2859
- "package:version:force:promote",
2860
- "package:version:promote:force",
2861
- "force:version:package:promote",
2862
- "version:force:package:promote",
2863
- "version:package:force:promote",
2864
- "version:package:promote:force",
2865
- "force:version:promote:package",
2866
- "version:force:promote:package",
2867
- "version:promote:force:package",
2868
- "version:promote:package:force",
2869
- "force:package:promote:version",
2870
- "package:force:promote:version",
2871
- "package:promote:force:version",
2872
- "package:promote:version:force",
2873
- "force:promote:package:version",
2874
- "promote:force:package:version",
2875
- "promote:package:force:version",
2876
- "promote:package:version:force",
2877
- "force:promote:version:package",
2878
- "promote:force:version:package",
2879
- "promote:version:force:package",
2880
- "promote:version:package:force"
2649
+ "retrieve.js"
2881
2650
  ],
2651
+ "aliasPermutations": [],
2882
2652
  "permutations": [
2883
- "package:version:promote",
2884
- "version:package:promote",
2885
- "version:promote:package",
2886
- "package:promote:version",
2887
- "promote:package:version",
2888
- "promote:version:package"
2653
+ "package:version:retrieve",
2654
+ "version:package:retrieve",
2655
+ "version:retrieve:package",
2656
+ "package:retrieve:version",
2657
+ "retrieve:package:version",
2658
+ "retrieve:version:package"
2889
2659
  ]
2890
2660
  },
2891
- "package:version:report": {
2661
+ "package:version:update": {
2892
2662
  "aliases": [
2893
- "force:package:version:report"
2663
+ "force:package:version:update"
2894
2664
  ],
2895
2665
  "args": {},
2896
2666
  "deprecateAliases": true,
2897
- "description": "To update package version values, run \"<%= config.bin %> package version update\".",
2667
+ "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\".",
2898
2668
  "examples": [
2899
- "Retrieve details about the package version with the specified ID from your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 04t...",
2900
- "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"
2669
+ "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",
2670
+ "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",
2671
+ "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\""
2901
2672
  ],
2902
2673
  "flags": {
2903
2674
  "json": {
@@ -2955,76 +2726,127 @@
2955
2726
  "char": "p",
2956
2727
  "name": "package",
2957
2728
  "required": true,
2958
- "summary": "ID (starts with 04t) or alias of the package to retrieve details for.",
2729
+ "summary": "ID (starts with 04t) or alias of the package to update a version of.",
2959
2730
  "hasDynamicHelp": false,
2960
2731
  "multiple": false,
2961
2732
  "type": "option"
2962
2733
  },
2963
- "verbose": {
2964
- "name": "verbose",
2965
- "summary": "Display extended package version details.",
2966
- "allowNo": false,
2967
- "type": "boolean"
2734
+ "version-name": {
2735
+ "aliases": [
2736
+ "versionname"
2737
+ ],
2738
+ "char": "a",
2739
+ "deprecateAliases": true,
2740
+ "name": "version-name",
2741
+ "summary": "New package version name.",
2742
+ "hasDynamicHelp": false,
2743
+ "multiple": false,
2744
+ "type": "option"
2745
+ },
2746
+ "version-description": {
2747
+ "aliases": [
2748
+ "versiondescription"
2749
+ ],
2750
+ "char": "e",
2751
+ "deprecateAliases": true,
2752
+ "name": "version-description",
2753
+ "summary": "New package version description.",
2754
+ "hasDynamicHelp": false,
2755
+ "multiple": false,
2756
+ "type": "option"
2757
+ },
2758
+ "branch": {
2759
+ "char": "b",
2760
+ "name": "branch",
2761
+ "summary": "New package version branch.",
2762
+ "hasDynamicHelp": false,
2763
+ "multiple": false,
2764
+ "type": "option"
2765
+ },
2766
+ "tag": {
2767
+ "char": "t",
2768
+ "name": "tag",
2769
+ "summary": "New package version tag.",
2770
+ "hasDynamicHelp": false,
2771
+ "multiple": false,
2772
+ "type": "option"
2773
+ },
2774
+ "installation-key": {
2775
+ "aliases": [
2776
+ "installationkey"
2777
+ ],
2778
+ "char": "k",
2779
+ "deprecateAliases": true,
2780
+ "name": "installation-key",
2781
+ "summary": "New installation key for key-protected package (default: null)",
2782
+ "hasDynamicHelp": false,
2783
+ "multiple": false,
2784
+ "type": "option"
2968
2785
  }
2969
2786
  },
2970
2787
  "hasDynamicHelp": true,
2971
2788
  "hiddenAliases": [],
2972
- "id": "package:version:report",
2789
+ "id": "package:version:update",
2973
2790
  "pluginAlias": "@salesforce/plugin-packaging",
2974
2791
  "pluginName": "@salesforce/plugin-packaging",
2975
2792
  "pluginType": "core",
2976
2793
  "strict": true,
2977
- "summary": "Retrieve details about a package version in the Dev Hub org.",
2794
+ "summary": "Update a package version.",
2978
2795
  "enableJsonFlag": true,
2796
+ "requiresProject": true,
2979
2797
  "isESM": true,
2980
2798
  "relativePath": [
2981
2799
  "lib",
2982
2800
  "commands",
2983
2801
  "package",
2984
2802
  "version",
2985
- "report.js"
2803
+ "update.js"
2986
2804
  ],
2987
2805
  "aliasPermutations": [
2988
- "force:package:version:report",
2989
- "package:force:version:report",
2990
- "package:version:force:report",
2991
- "package:version:report:force",
2992
- "force:version:package:report",
2993
- "version:force:package:report",
2994
- "version:package:force:report",
2995
- "version:package:report:force",
2996
- "force:version:report:package",
2997
- "version:force:report:package",
2998
- "version:report:force:package",
2999
- "version:report:package:force",
3000
- "force:package:report:version",
3001
- "package:force:report:version",
3002
- "package:report:force:version",
3003
- "package:report:version:force",
3004
- "force:report:package:version",
3005
- "report:force:package:version",
3006
- "report:package:force:version",
3007
- "report:package:version:force",
3008
- "force:report:version:package",
3009
- "report:force:version:package",
3010
- "report:version:force:package",
3011
- "report:version:package:force"
2806
+ "force:package:version:update",
2807
+ "package:force:version:update",
2808
+ "package:version:force:update",
2809
+ "package:version:update:force",
2810
+ "force:version:package:update",
2811
+ "version:force:package:update",
2812
+ "version:package:force:update",
2813
+ "version:package:update:force",
2814
+ "force:version:update:package",
2815
+ "version:force:update:package",
2816
+ "version:update:force:package",
2817
+ "version:update:package:force",
2818
+ "force:package:update:version",
2819
+ "package:force:update:version",
2820
+ "package:update:force:version",
2821
+ "package:update:version:force",
2822
+ "force:update:package:version",
2823
+ "update:force:package:version",
2824
+ "update:package:force:version",
2825
+ "update:package:version:force",
2826
+ "force:update:version:package",
2827
+ "update:force:version:package",
2828
+ "update:version:force:package",
2829
+ "update:version:package:force"
3012
2830
  ],
3013
2831
  "permutations": [
3014
- "package:version:report",
3015
- "version:package:report",
3016
- "version:report:package",
3017
- "package:report:version",
3018
- "report:package:version",
3019
- "report:version:package"
2832
+ "package:version:update",
2833
+ "version:package:update",
2834
+ "version:update:package",
2835
+ "package:update:version",
2836
+ "update:package:version",
2837
+ "update:version:package"
3020
2838
  ]
3021
2839
  },
3022
- "package:version:retrieve": {
3023
- "aliases": [],
2840
+ "package1:version:create": {
2841
+ "aliases": [
2842
+ "force:package1:version:create"
2843
+ ],
3024
2844
  "args": {},
3025
- "description": "Retrieving a package version downloads the metadata into the directory you specify.\n\nYou can retrieve metadata for a second- or first-generation managed package, or an unlocked package.\n\nSpecify the subscriber package version ID (starts with 04t) and the path to an empty directory when you run this command.",
2845
+ "deprecateAliases": true,
2846
+ "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.",
3026
2847
  "examples": [
3027
- "Retrieve package metadata for a 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-org my-scratch\nIf you omit --target-org, this command runs against your default org."
2848
+ "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",
2849
+ "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"
3028
2850
  ],
3029
2851
  "flags": {
3030
2852
  "json": {
@@ -3052,6 +2874,21 @@
3052
2874
  "multiple": false,
3053
2875
  "type": "option"
3054
2876
  },
2877
+ "target-org": {
2878
+ "aliases": [
2879
+ "targetusername",
2880
+ "u"
2881
+ ],
2882
+ "char": "o",
2883
+ "deprecateAliases": true,
2884
+ "name": "target-org",
2885
+ "noCacheDefault": true,
2886
+ "required": true,
2887
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2888
+ "hasDynamicHelp": true,
2889
+ "multiple": false,
2890
+ "type": "option"
2891
+ },
3055
2892
  "api-version": {
3056
2893
  "aliases": [
3057
2894
  "apiversion"
@@ -3063,80 +2900,164 @@
3063
2900
  "multiple": false,
3064
2901
  "type": "option"
3065
2902
  },
3066
- "target-org": {
2903
+ "package-id": {
3067
2904
  "aliases": [
3068
- "targetusername",
3069
- "u"
2905
+ "packageid"
3070
2906
  ],
3071
- "char": "o",
2907
+ "char": "i",
3072
2908
  "deprecateAliases": true,
3073
- "name": "target-org",
3074
- "noCacheDefault": true,
2909
+ "name": "package-id",
3075
2910
  "required": true,
3076
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3077
- "hasDynamicHelp": true,
2911
+ "summary": "ID of the metadata package (starts with 033) of which you’re creating a new version.",
2912
+ "hasDynamicHelp": false,
3078
2913
  "multiple": false,
3079
2914
  "type": "option"
3080
2915
  },
3081
- "package": {
3082
- "char": "p",
3083
- "name": "package",
2916
+ "name": {
2917
+ "char": "n",
2918
+ "name": "name",
3084
2919
  "required": true,
3085
- "summary": "Subscriber package version ID (starts with 04t).",
2920
+ "summary": "Package version name.",
3086
2921
  "hasDynamicHelp": false,
3087
2922
  "multiple": false,
3088
2923
  "type": "option"
3089
2924
  },
3090
- "output-dir": {
2925
+ "description": {
3091
2926
  "char": "d",
3092
- "name": "output-dir",
3093
- "summary": "Path within your Salesforce DX project directory in which to download the metadata. This directory must be empty.",
3094
- "default": "force-app",
2927
+ "name": "description",
2928
+ "summary": "Package version description.",
2929
+ "hasDynamicHelp": false,
2930
+ "multiple": false,
2931
+ "type": "option"
2932
+ },
2933
+ "version": {
2934
+ "char": "v",
2935
+ "name": "version",
2936
+ "summary": "Package version in major.minor format, for example, 3.2.",
3095
2937
  "hasDynamicHelp": false,
3096
2938
  "multiple": false,
3097
2939
  "type": "option"
2940
+ },
2941
+ "managed-released": {
2942
+ "aliases": [
2943
+ "managedrelease"
2944
+ ],
2945
+ "char": "m",
2946
+ "deprecateAliases": true,
2947
+ "description": "To create a beta version, don’t include this parameter.",
2948
+ "name": "managed-released",
2949
+ "summary": "Create a managed package version.",
2950
+ "allowNo": false,
2951
+ "type": "boolean"
2952
+ },
2953
+ "release-notes-url": {
2954
+ "aliases": [
2955
+ "releasenotesurl"
2956
+ ],
2957
+ "char": "r",
2958
+ "deprecateAliases": true,
2959
+ "description": "This link is displayed in the package installation UI to provide release notes for this package version to subscribers.",
2960
+ "name": "release-notes-url",
2961
+ "summary": "Release notes URL.",
2962
+ "hasDynamicHelp": false,
2963
+ "multiple": false,
2964
+ "type": "option"
2965
+ },
2966
+ "post-install-url": {
2967
+ "aliases": [
2968
+ "postinstallurl"
2969
+ ],
2970
+ "char": "p",
2971
+ "deprecateAliases": true,
2972
+ "description": "The contents of the post-installation instructions URL are displayed in the UI after installation of the package version.",
2973
+ "name": "post-install-url",
2974
+ "summary": "Post install URL.",
2975
+ "hasDynamicHelp": false,
2976
+ "multiple": false,
2977
+ "type": "option"
2978
+ },
2979
+ "installation-key": {
2980
+ "aliases": [
2981
+ "installationkey"
2982
+ ],
2983
+ "char": "k",
2984
+ "deprecateAliases": true,
2985
+ "name": "installation-key",
2986
+ "summary": "Installation key for key-protected package (default: null).",
2987
+ "hasDynamicHelp": false,
2988
+ "multiple": false,
2989
+ "type": "option"
2990
+ },
2991
+ "wait": {
2992
+ "char": "w",
2993
+ "name": "wait",
2994
+ "summary": "Minutes to wait for the package version to be created (default: 2 minutes).",
2995
+ "hasDynamicHelp": true,
2996
+ "multiple": false,
2997
+ "type": "option"
3098
2998
  }
3099
2999
  },
3100
3000
  "hasDynamicHelp": true,
3101
- "hidden": true,
3102
3001
  "hiddenAliases": [],
3103
- "id": "package:version:retrieve",
3002
+ "id": "package1:version:create",
3104
3003
  "pluginAlias": "@salesforce/plugin-packaging",
3105
3004
  "pluginName": "@salesforce/plugin-packaging",
3106
3005
  "pluginType": "core",
3107
3006
  "strict": true,
3108
- "summary": "Retrieve package metadata for a specified package version.",
3007
+ "summary": "Create a first-generation package version in the release org.",
3109
3008
  "enableJsonFlag": true,
3110
- "requiresProject": true,
3111
3009
  "isESM": true,
3112
3010
  "relativePath": [
3113
3011
  "lib",
3114
3012
  "commands",
3115
- "package",
3013
+ "package1",
3116
3014
  "version",
3117
- "retrieve.js"
3015
+ "create.js"
3016
+ ],
3017
+ "aliasPermutations": [
3018
+ "force:package1:version:create",
3019
+ "package1:force:version:create",
3020
+ "package1:version:force:create",
3021
+ "package1:version:create:force",
3022
+ "force:version:package1:create",
3023
+ "version:force:package1:create",
3024
+ "version:package1:force:create",
3025
+ "version:package1:create:force",
3026
+ "force:version:create:package1",
3027
+ "version:force:create:package1",
3028
+ "version:create:force:package1",
3029
+ "version:create:package1:force",
3030
+ "force:package1:create:version",
3031
+ "package1:force:create:version",
3032
+ "package1:create:force:version",
3033
+ "package1:create:version:force",
3034
+ "force:create:package1:version",
3035
+ "create:force:package1:version",
3036
+ "create:package1:force:version",
3037
+ "create:package1:version:force",
3038
+ "force:create:version:package1",
3039
+ "create:force:version:package1",
3040
+ "create:version:force:package1",
3041
+ "create:version:package1:force"
3118
3042
  ],
3119
- "aliasPermutations": [],
3120
3043
  "permutations": [
3121
- "package:version:retrieve",
3122
- "version:package:retrieve",
3123
- "version:retrieve:package",
3124
- "package:retrieve:version",
3125
- "retrieve:package:version",
3126
- "retrieve:version:package"
3044
+ "package1:version:create",
3045
+ "version:package1:create",
3046
+ "version:create:package1",
3047
+ "package1:create:version",
3048
+ "create:package1:version",
3049
+ "create:version:package1"
3127
3050
  ]
3128
3051
  },
3129
- "package:version:update": {
3052
+ "package1:version:display": {
3130
3053
  "aliases": [
3131
- "force:package:version:update"
3054
+ "force:package1:version:display"
3132
3055
  ],
3133
3056
  "args": {},
3134
3057
  "deprecateAliases": true,
3135
- "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\".",
3136
3058
  "examples": [
3137
- "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",
3138
- "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",
3139
- "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\""
3059
+ "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...",
3060
+ "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --package-version-id 04t... --target-org myorg@example.com"
3140
3061
  ],
3141
3062
  "flags": {
3142
3063
  "json": {
@@ -3164,17 +3085,17 @@
3164
3085
  "multiple": false,
3165
3086
  "type": "option"
3166
3087
  },
3167
- "target-dev-hub": {
3088
+ "target-org": {
3168
3089
  "aliases": [
3169
- "targetdevhubusername",
3170
- "target-hub-org"
3090
+ "targetusername",
3091
+ "u"
3171
3092
  ],
3172
- "char": "v",
3093
+ "char": "o",
3173
3094
  "deprecateAliases": true,
3174
- "name": "target-dev-hub",
3095
+ "name": "target-org",
3175
3096
  "noCacheDefault": true,
3176
3097
  "required": true,
3177
- "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
3098
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3178
3099
  "hasDynamicHelp": true,
3179
3100
  "multiple": false,
3180
3101
  "type": "option"
@@ -3190,63 +3111,15 @@
3190
3111
  "multiple": false,
3191
3112
  "type": "option"
3192
3113
  },
3193
- "package": {
3194
- "char": "p",
3195
- "name": "package",
3196
- "required": true,
3197
- "summary": "ID (starts with 04t) or alias of the package to update a version of.",
3198
- "hasDynamicHelp": false,
3199
- "multiple": false,
3200
- "type": "option"
3201
- },
3202
- "version-name": {
3203
- "aliases": [
3204
- "versionname"
3205
- ],
3206
- "char": "a",
3207
- "deprecateAliases": true,
3208
- "name": "version-name",
3209
- "summary": "New package version name.",
3210
- "hasDynamicHelp": false,
3211
- "multiple": false,
3212
- "type": "option"
3213
- },
3214
- "version-description": {
3215
- "aliases": [
3216
- "versiondescription"
3217
- ],
3218
- "char": "e",
3219
- "deprecateAliases": true,
3220
- "name": "version-description",
3221
- "summary": "New package version description.",
3222
- "hasDynamicHelp": false,
3223
- "multiple": false,
3224
- "type": "option"
3225
- },
3226
- "branch": {
3227
- "char": "b",
3228
- "name": "branch",
3229
- "summary": "New package version branch.",
3230
- "hasDynamicHelp": false,
3231
- "multiple": false,
3232
- "type": "option"
3233
- },
3234
- "tag": {
3235
- "char": "t",
3236
- "name": "tag",
3237
- "summary": "New package version tag.",
3238
- "hasDynamicHelp": false,
3239
- "multiple": false,
3240
- "type": "option"
3241
- },
3242
- "installation-key": {
3114
+ "package-version-id": {
3243
3115
  "aliases": [
3244
- "installationkey"
3116
+ "packageversionid"
3245
3117
  ],
3246
- "char": "k",
3118
+ "char": "i",
3247
3119
  "deprecateAliases": true,
3248
- "name": "installation-key",
3249
- "summary": "New installation key for key-protected package (default: null)",
3120
+ "name": "package-version-id",
3121
+ "required": true,
3122
+ "summary": "ID (starts with 04t) of the metadata package version whose details you want to display.",
3250
3123
  "hasDynamicHelp": false,
3251
3124
  "multiple": false,
3252
3125
  "type": "option"
@@ -3254,66 +3127,65 @@
3254
3127
  },
3255
3128
  "hasDynamicHelp": true,
3256
3129
  "hiddenAliases": [],
3257
- "id": "package:version:update",
3130
+ "id": "package1:version:display",
3258
3131
  "pluginAlias": "@salesforce/plugin-packaging",
3259
3132
  "pluginName": "@salesforce/plugin-packaging",
3260
3133
  "pluginType": "core",
3261
3134
  "strict": true,
3262
- "summary": "Update a package version.",
3135
+ "summary": "Display details about a first-generation package version.",
3263
3136
  "enableJsonFlag": true,
3264
- "requiresProject": true,
3265
3137
  "isESM": true,
3266
3138
  "relativePath": [
3267
3139
  "lib",
3268
3140
  "commands",
3269
- "package",
3141
+ "package1",
3270
3142
  "version",
3271
- "update.js"
3143
+ "display.js"
3272
3144
  ],
3273
3145
  "aliasPermutations": [
3274
- "force:package:version:update",
3275
- "package:force:version:update",
3276
- "package:version:force:update",
3277
- "package:version:update:force",
3278
- "force:version:package:update",
3279
- "version:force:package:update",
3280
- "version:package:force:update",
3281
- "version:package:update:force",
3282
- "force:version:update:package",
3283
- "version:force:update:package",
3284
- "version:update:force:package",
3285
- "version:update:package:force",
3286
- "force:package:update:version",
3287
- "package:force:update:version",
3288
- "package:update:force:version",
3289
- "package:update:version:force",
3290
- "force:update:package:version",
3291
- "update:force:package:version",
3292
- "update:package:force:version",
3293
- "update:package:version:force",
3294
- "force:update:version:package",
3295
- "update:force:version:package",
3296
- "update:version:force:package",
3297
- "update:version:package:force"
3146
+ "force:package1:version:display",
3147
+ "package1:force:version:display",
3148
+ "package1:version:force:display",
3149
+ "package1:version:display:force",
3150
+ "force:version:package1:display",
3151
+ "version:force:package1:display",
3152
+ "version:package1:force:display",
3153
+ "version:package1:display:force",
3154
+ "force:version:display:package1",
3155
+ "version:force:display:package1",
3156
+ "version:display:force:package1",
3157
+ "version:display:package1:force",
3158
+ "force:package1:display:version",
3159
+ "package1:force:display:version",
3160
+ "package1:display:force:version",
3161
+ "package1:display:version:force",
3162
+ "force:display:package1:version",
3163
+ "display:force:package1:version",
3164
+ "display:package1:force:version",
3165
+ "display:package1:version:force",
3166
+ "force:display:version:package1",
3167
+ "display:force:version:package1",
3168
+ "display:version:force:package1",
3169
+ "display:version:package1:force"
3298
3170
  ],
3299
3171
  "permutations": [
3300
- "package:version:update",
3301
- "version:package:update",
3302
- "version:update:package",
3303
- "package:update:version",
3304
- "update:package:version",
3305
- "update:version:package"
3172
+ "package1:version:display",
3173
+ "version:package1:display",
3174
+ "version:display:package1",
3175
+ "package1:display:version",
3176
+ "display:package1:version",
3177
+ "display:version:package1"
3306
3178
  ]
3307
3179
  },
3308
- "package1:version:create:get": {
3180
+ "package1:version:list": {
3309
3181
  "aliases": [
3310
- "force:package1:version:create:get"
3182
+ "force:package1:version:list"
3311
3183
  ],
3312
3184
  "args": {},
3313
3185
  "deprecateAliases": true,
3314
3186
  "examples": [
3315
- "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...",
3316
- "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --request-id 0HD... --target-org myorg@example.com"
3187
+ "List all first-generation package versions in your default org:\n<%= config.bin %> <%= command.id %>",
3188
+ "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"
3317
3189
  ],
3318
3190
  "flags": {
3319
3191
  "json": {
@@ -3367,15 +3239,15 @@
3367
3239
  "multiple": false,
3368
3240
  "type": "option"
3369
3241
  },
3370
- "request-id": {
3242
+ "package-id": {
3371
3243
  "aliases": [
3372
- "requestid"
3244
+ "packageid"
3373
3245
  ],
3374
3246
  "char": "i",
3375
3247
  "deprecateAliases": true,
3376
- "name": "request-id",
3377
- "required": true,
3378
- "summary": "ID of the PackageUploadRequest (starts with 0HD).",
3248
+ "description": "If not specified, shows all versions for all packages (managed and unmanaged) in the org.",
3249
+ "name": "package-id",
3250
+ "summary": "Metadata package ID (starts with 033) whose package versions you want to list.",
3379
3251
  "hasDynamicHelp": false,
3380
3252
  "multiple": false,
3381
3253
  "type": "option"
@@ -3383,12 +3255,12 @@
3383
3255
  },
3384
3256
  "hasDynamicHelp": true,
3385
3257
  "hiddenAliases": [],
3386
- "id": "package1:version:create:get",
3258
+ "id": "package1:version:list",
3387
3259
  "pluginAlias": "@salesforce/plugin-packaging",
3388
3260
  "pluginName": "@salesforce/plugin-packaging",
3389
3261
  "pluginType": "core",
3390
3262
  "strict": true,
3391
- "summary": "Retrieve the status of a package version creation request.",
3263
+ "summary": "List package versions for the specified first-generation package or for the org.",
3392
3264
  "enableJsonFlag": true,
3393
3265
  "isESM": true,
3394
3266
  "relativePath": [
@@ -3396,156 +3268,41 @@
3396
3268
  "commands",
3397
3269
  "package1",
3398
3270
  "version",
3399
- "create",
3400
- "get.js"
3271
+ "list.js"
3401
3272
  ],
3402
3273
  "aliasPermutations": [
3403
- "force:package1:version:create:get",
3404
- "package1:force:version:create:get",
3405
- "package1:version:force:create:get",
3406
- "package1:version:create:force:get",
3407
- "package1:version:create:get:force",
3408
- "force:version:package1:create:get",
3409
- "version:force:package1:create:get",
3410
- "version:package1:force:create:get",
3411
- "version:package1:create:force:get",
3412
- "version:package1:create:get:force",
3413
- "force:version:create:package1:get",
3414
- "version:force:create:package1:get",
3415
- "version:create:force:package1:get",
3416
- "version:create:package1:force:get",
3417
- "version:create:package1:get:force",
3418
- "force:version:create:get:package1",
3419
- "version:force:create:get:package1",
3420
- "version:create:force:get:package1",
3421
- "version:create:get:force:package1",
3422
- "version:create:get:package1:force",
3423
- "force:package1:create:version:get",
3424
- "package1:force:create:version:get",
3425
- "package1:create:force:version:get",
3426
- "package1:create:version:force:get",
3427
- "package1:create:version:get:force",
3428
- "force:create:package1:version:get",
3429
- "create:force:package1:version:get",
3430
- "create:package1:force:version:get",
3431
- "create:package1:version:force:get",
3432
- "create:package1:version:get:force",
3433
- "force:create:version:package1:get",
3434
- "create:force:version:package1:get",
3435
- "create:version:force:package1:get",
3436
- "create:version:package1:force:get",
3437
- "create:version:package1:get:force",
3438
- "force:create:version:get:package1",
3439
- "create:force:version:get:package1",
3440
- "create:version:force:get:package1",
3441
- "create:version:get:force:package1",
3442
- "create:version:get:package1:force",
3443
- "force:package1:create:get:version",
3444
- "package1:force:create:get:version",
3445
- "package1:create:force:get:version",
3446
- "package1:create:get:force:version",
3447
- "package1:create:get:version:force",
3448
- "force:create:package1:get:version",
3449
- "create:force:package1:get:version",
3450
- "create:package1:force:get:version",
3451
- "create:package1:get:force:version",
3452
- "create:package1:get:version:force",
3453
- "force:create:get:package1:version",
3454
- "create:force:get:package1:version",
3455
- "create:get:force:package1:version",
3456
- "create:get:package1:force:version",
3457
- "create:get:package1:version:force",
3458
- "force:create:get:version:package1",
3459
- "create:force:get:version:package1",
3460
- "create:get:force:version:package1",
3461
- "create:get:version:force:package1",
3462
- "create:get:version:package1:force",
3463
- "force:package1:version:get:create",
3464
- "package1:force:version:get:create",
3465
- "package1:version:force:get:create",
3466
- "package1:version:get:force:create",
3467
- "package1:version:get:create:force",
3468
- "force:version:package1:get:create",
3469
- "version:force:package1:get:create",
3470
- "version:package1:force:get:create",
3471
- "version:package1:get:force:create",
3472
- "version:package1:get:create:force",
3473
- "force:version:get:package1:create",
3474
- "version:force:get:package1:create",
3475
- "version:get:force:package1:create",
3476
- "version:get:package1:force:create",
3477
- "version:get:package1:create:force",
3478
- "force:version:get:create:package1",
3479
- "version:force:get:create:package1",
3480
- "version:get:force:create:package1",
3481
- "version:get:create:force:package1",
3482
- "version:get:create:package1:force",
3483
- "force:package1:get:version:create",
3484
- "package1:force:get:version:create",
3485
- "package1:get:force:version:create",
3486
- "package1:get:version:force:create",
3487
- "package1:get:version:create:force",
3488
- "force:get:package1:version:create",
3489
- "get:force:package1:version:create",
3490
- "get:package1:force:version:create",
3491
- "get:package1:version:force:create",
3492
- "get:package1:version:create:force",
3493
- "force:get:version:package1:create",
3494
- "get:force:version:package1:create",
3495
- "get:version:force:package1:create",
3496
- "get:version:package1:force:create",
3497
- "get:version:package1:create:force",
3498
- "force:get:version:create:package1",
3499
- "get:force:version:create:package1",
3500
- "get:version:force:create:package1",
3501
- "get:version:create:force:package1",
3502
- "get:version:create:package1:force",
3503
- "force:package1:get:create:version",
3504
- "package1:force:get:create:version",
3505
- "package1:get:force:create:version",
3506
- "package1:get:create:force:version",
3507
- "package1:get:create:version:force",
3508
- "force:get:package1:create:version",
3509
- "get:force:package1:create:version",
3510
- "get:package1:force:create:version",
3511
- "get:package1:create:force:version",
3512
- "get:package1:create:version:force",
3513
- "force:get:create:package1:version",
3514
- "get:force:create:package1:version",
3515
- "get:create:force:package1:version",
3516
- "get:create:package1:force:version",
3517
- "get:create:package1:version:force",
3518
- "force:get:create:version:package1",
3519
- "get:force:create:version:package1",
3520
- "get:create:force:version:package1",
3521
- "get:create:version:force:package1",
3522
- "get:create:version:package1:force"
3523
- ],
3524
- "permutations": [
3525
- "package1:version:create:get",
3526
- "version:package1:create:get",
3527
- "version:create:package1:get",
3528
- "version:create:get:package1",
3529
- "package1:create:version:get",
3530
- "create:package1:version:get",
3531
- "create:version:package1:get",
3532
- "create:version:get:package1",
3533
- "package1:create:get:version",
3534
- "create:package1:get:version",
3535
- "create:get:package1:version",
3536
- "create:get:version:package1",
3537
- "package1:version:get:create",
3538
- "version:package1:get:create",
3539
- "version:get:package1:create",
3540
- "version:get:create:package1",
3541
- "package1:get:version:create",
3542
- "get:package1:version:create",
3543
- "get:version:package1:create",
3544
- "get:version:create:package1",
3545
- "package1:get:create:version",
3546
- "get:package1:create:version",
3547
- "get:create:package1:version",
3548
- "get:create:version:package1"
3274
+ "force:package1:version:list",
3275
+ "package1:force:version:list",
3276
+ "package1:version:force:list",
3277
+ "package1:version:list:force",
3278
+ "force:version:package1:list",
3279
+ "version:force:package1:list",
3280
+ "version:package1:force:list",
3281
+ "version:package1:list:force",
3282
+ "force:version:list:package1",
3283
+ "version:force:list:package1",
3284
+ "version:list:force:package1",
3285
+ "version:list:package1:force",
3286
+ "force:package1:list:version",
3287
+ "package1:force:list:version",
3288
+ "package1:list:force:version",
3289
+ "package1:list:version:force",
3290
+ "force:list:package1:version",
3291
+ "list:force:package1:version",
3292
+ "list:package1:force:version",
3293
+ "list:package1:version:force",
3294
+ "force:list:version:package1",
3295
+ "list:force:version:package1",
3296
+ "list:version:force:package1",
3297
+ "list:version:package1:force"
3298
+ ],
3299
+ "permutations": [
3300
+ "package1:version:list",
3301
+ "version:package1:list",
3302
+ "version:list:package1",
3303
+ "package1:list:version",
3304
+ "list:package1:version",
3305
+ "list:version:package1"
3549
3306
  ]
3550
3307
  },
3551
3308
  "package:version:create:list": {
@@ -4063,7 +3820,250 @@
4063
3820
  "report:create:package:version",
4064
3821
  "report:create:version:package"
4065
3822
  ]
3823
+ },
3824
+ "package1:version:create:get": {
3825
+ "aliases": [
3826
+ "force:package1:version:create:get"
3827
+ ],
3828
+ "args": {},
3829
+ "deprecateAliases": true,
3830
+ "examples": [
3831
+ "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...",
3832
+ "Same as previous example, but use the specified org:\n<%= config.bin %> <%= command.id %> --request-id 0HD... --target-org myorg@example.com"
3833
+ ],
3834
+ "flags": {
3835
+ "json": {
3836
+ "description": "Format output as json.",
3837
+ "helpGroup": "GLOBAL",
3838
+ "name": "json",
3839
+ "allowNo": false,
3840
+ "type": "boolean"
3841
+ },
3842
+ "flags-dir": {
3843
+ "helpGroup": "GLOBAL",
3844
+ "name": "flags-dir",
3845
+ "summary": "Import flag values from a directory.",
3846
+ "hasDynamicHelp": false,
3847
+ "multiple": false,
3848
+ "type": "option"
3849
+ },
3850
+ "loglevel": {
3851
+ "deprecated": {
3852
+ "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."
3853
+ },
3854
+ "hidden": true,
3855
+ "name": "loglevel",
3856
+ "hasDynamicHelp": false,
3857
+ "multiple": false,
3858
+ "type": "option"
3859
+ },
3860
+ "target-org": {
3861
+ "aliases": [
3862
+ "targetusername",
3863
+ "u"
3864
+ ],
3865
+ "char": "o",
3866
+ "deprecateAliases": true,
3867
+ "name": "target-org",
3868
+ "noCacheDefault": true,
3869
+ "required": true,
3870
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
3871
+ "hasDynamicHelp": true,
3872
+ "multiple": false,
3873
+ "type": "option"
3874
+ },
3875
+ "api-version": {
3876
+ "aliases": [
3877
+ "apiversion"
3878
+ ],
3879
+ "deprecateAliases": true,
3880
+ "description": "Override the api version used for api requests made by this command",
3881
+ "name": "api-version",
3882
+ "hasDynamicHelp": false,
3883
+ "multiple": false,
3884
+ "type": "option"
3885
+ },
3886
+ "request-id": {
3887
+ "aliases": [
3888
+ "requestid"
3889
+ ],
3890
+ "char": "i",
3891
+ "deprecateAliases": true,
3892
+ "name": "request-id",
3893
+ "required": true,
3894
+ "summary": "ID of the PackageUploadRequest (starts with 0HD).",
3895
+ "hasDynamicHelp": false,
3896
+ "multiple": false,
3897
+ "type": "option"
3898
+ }
3899
+ },
3900
+ "hasDynamicHelp": true,
3901
+ "hiddenAliases": [],
3902
+ "id": "package1:version:create:get",
3903
+ "pluginAlias": "@salesforce/plugin-packaging",
3904
+ "pluginName": "@salesforce/plugin-packaging",
3905
+ "pluginType": "core",
3906
+ "strict": true,
3907
+ "summary": "Retrieve the status of a package version creation request.",
3908
+ "enableJsonFlag": true,
3909
+ "isESM": true,
3910
+ "relativePath": [
3911
+ "lib",
3912
+ "commands",
3913
+ "package1",
3914
+ "version",
3915
+ "create",
3916
+ "get.js"
3917
+ ],
3918
+ "aliasPermutations": [
3919
+ "force:package1:version:create:get",
3920
+ "package1:force:version:create:get",
3921
+ "package1:version:force:create:get",
3922
+ "package1:version:create:force:get",
3923
+ "package1:version:create:get:force",
3924
+ "force:version:package1:create:get",
3925
+ "version:force:package1:create:get",
3926
+ "version:package1:force:create:get",
3927
+ "version:package1:create:force:get",
3928
+ "version:package1:create:get:force",
3929
+ "force:version:create:package1:get",
3930
+ "version:force:create:package1:get",
3931
+ "version:create:force:package1:get",
3932
+ "version:create:package1:force:get",
3933
+ "version:create:package1:get:force",
3934
+ "force:version:create:get:package1",
3935
+ "version:force:create:get:package1",
3936
+ "version:create:force:get:package1",
3937
+ "version:create:get:force:package1",
3938
+ "version:create:get:package1:force",
3939
+ "force:package1:create:version:get",
3940
+ "package1:force:create:version:get",
3941
+ "package1:create:force:version:get",
3942
+ "package1:create:version:force:get",
3943
+ "package1:create:version:get:force",
3944
+ "force:create:package1:version:get",
3945
+ "create:force:package1:version:get",
3946
+ "create:package1:force:version:get",
3947
+ "create:package1:version:force:get",
3948
+ "create:package1:version:get:force",
3949
+ "force:create:version:package1:get",
3950
+ "create:force:version:package1:get",
3951
+ "create:version:force:package1:get",
3952
+ "create:version:package1:force:get",
3953
+ "create:version:package1:get:force",
3954
+ "force:create:version:get:package1",
3955
+ "create:force:version:get:package1",
3956
+ "create:version:force:get:package1",
3957
+ "create:version:get:force:package1",
3958
+ "create:version:get:package1:force",
3959
+ "force:package1:create:get:version",
3960
+ "package1:force:create:get:version",
3961
+ "package1:create:force:get:version",
3962
+ "package1:create:get:force:version",
3963
+ "package1:create:get:version:force",
3964
+ "force:create:package1:get:version",
3965
+ "create:force:package1:get:version",
3966
+ "create:package1:force:get:version",
3967
+ "create:package1:get:force:version",
3968
+ "create:package1:get:version:force",
3969
+ "force:create:get:package1:version",
3970
+ "create:force:get:package1:version",
3971
+ "create:get:force:package1:version",
3972
+ "create:get:package1:force:version",
3973
+ "create:get:package1:version:force",
3974
+ "force:create:get:version:package1",
3975
+ "create:force:get:version:package1",
3976
+ "create:get:force:version:package1",
3977
+ "create:get:version:force:package1",
3978
+ "create:get:version:package1:force",
3979
+ "force:package1:version:get:create",
3980
+ "package1:force:version:get:create",
3981
+ "package1:version:force:get:create",
3982
+ "package1:version:get:force:create",
3983
+ "package1:version:get:create:force",
3984
+ "force:version:package1:get:create",
3985
+ "version:force:package1:get:create",
3986
+ "version:package1:force:get:create",
3987
+ "version:package1:get:force:create",
3988
+ "version:package1:get:create:force",
3989
+ "force:version:get:package1:create",
3990
+ "version:force:get:package1:create",
3991
+ "version:get:force:package1:create",
3992
+ "version:get:package1:force:create",
3993
+ "version:get:package1:create:force",
3994
+ "force:version:get:create:package1",
3995
+ "version:force:get:create:package1",
3996
+ "version:get:force:create:package1",
3997
+ "version:get:create:force:package1",
3998
+ "version:get:create:package1:force",
3999
+ "force:package1:get:version:create",
4000
+ "package1:force:get:version:create",
4001
+ "package1:get:force:version:create",
4002
+ "package1:get:version:force:create",
4003
+ "package1:get:version:create:force",
4004
+ "force:get:package1:version:create",
4005
+ "get:force:package1:version:create",
4006
+ "get:package1:force:version:create",
4007
+ "get:package1:version:force:create",
4008
+ "get:package1:version:create:force",
4009
+ "force:get:version:package1:create",
4010
+ "get:force:version:package1:create",
4011
+ "get:version:force:package1:create",
4012
+ "get:version:package1:force:create",
4013
+ "get:version:package1:create:force",
4014
+ "force:get:version:create:package1",
4015
+ "get:force:version:create:package1",
4016
+ "get:version:force:create:package1",
4017
+ "get:version:create:force:package1",
4018
+ "get:version:create:package1:force",
4019
+ "force:package1:get:create:version",
4020
+ "package1:force:get:create:version",
4021
+ "package1:get:force:create:version",
4022
+ "package1:get:create:force:version",
4023
+ "package1:get:create:version:force",
4024
+ "force:get:package1:create:version",
4025
+ "get:force:package1:create:version",
4026
+ "get:package1:force:create:version",
4027
+ "get:package1:create:force:version",
4028
+ "get:package1:create:version:force",
4029
+ "force:get:create:package1:version",
4030
+ "get:force:create:package1:version",
4031
+ "get:create:force:package1:version",
4032
+ "get:create:package1:force:version",
4033
+ "get:create:package1:version:force",
4034
+ "force:get:create:version:package1",
4035
+ "get:force:create:version:package1",
4036
+ "get:create:force:version:package1",
4037
+ "get:create:version:force:package1",
4038
+ "get:create:version:package1:force"
4039
+ ],
4040
+ "permutations": [
4041
+ "package1:version:create:get",
4042
+ "version:package1:create:get",
4043
+ "version:create:package1:get",
4044
+ "version:create:get:package1",
4045
+ "package1:create:version:get",
4046
+ "create:package1:version:get",
4047
+ "create:version:package1:get",
4048
+ "create:version:get:package1",
4049
+ "package1:create:get:version",
4050
+ "create:package1:get:version",
4051
+ "create:get:package1:version",
4052
+ "create:get:version:package1",
4053
+ "package1:version:get:create",
4054
+ "version:package1:get:create",
4055
+ "version:get:package1:create",
4056
+ "version:get:create:package1",
4057
+ "package1:get:version:create",
4058
+ "get:package1:version:create",
4059
+ "get:version:package1:create",
4060
+ "get:version:create:package1",
4061
+ "package1:get:create:version",
4062
+ "get:package1:create:version",
4063
+ "get:create:package1:version",
4064
+ "get:create:version:package1"
4065
+ ]
4066
4066
  }
4067
4067
  },
4068
- "version": "2.13.5"
4068
+ "version": "2.13.6"
4069
4069
  }