@salesforce/plugin-packaging 2.11.0 → 2.11.1

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