@salesforce/plugin-packaging 2.13.6 → 2.15.0

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 (28) hide show
  1. package/README.md +337 -22
  2. package/lib/commands/package/convert.d.ts +0 -1
  3. package/lib/commands/package/convert.js +0 -2
  4. package/lib/commands/package/convert.js.map +1 -1
  5. package/lib/commands/package/push-upgrade/abort.d.ts +15 -0
  6. package/lib/commands/package/push-upgrade/abort.js +38 -0
  7. package/lib/commands/package/push-upgrade/abort.js.map +1 -0
  8. package/lib/commands/package/push-upgrade/list.d.ts +18 -0
  9. package/lib/commands/package/push-upgrade/list.js +91 -0
  10. package/lib/commands/package/push-upgrade/list.js.map +1 -0
  11. package/lib/commands/package/push-upgrade/report.d.ts +18 -0
  12. package/lib/commands/package/push-upgrade/report.js +139 -0
  13. package/lib/commands/package/push-upgrade/report.js.map +1 -0
  14. package/lib/commands/package/push-upgrade/schedule.d.ts +17 -0
  15. package/lib/commands/package/push-upgrade/schedule.js +98 -0
  16. package/lib/commands/package/push-upgrade/schedule.js.map +1 -0
  17. package/lib/commands/package/version/list.js +8 -7
  18. package/lib/commands/package/version/list.js.map +1 -1
  19. package/messages/package_pushupgrade_abort.md +51 -0
  20. package/messages/package_pushupgrade_list.md +61 -0
  21. package/messages/package_pushupgrade_report.md +27 -0
  22. package/messages/package_pushupgrade_schedule.md +109 -0
  23. package/oclif.manifest.json +480 -3
  24. package/package.json +6 -6
  25. package/schemas/package-push__upgrade-abort.json +18 -0
  26. package/schemas/package-push__upgrade-list.json +77 -0
  27. package/schemas/package-push__upgrade-report.json +106 -0
  28. package/schemas/package-push__upgrade-schedule.json +25 -0
@@ -0,0 +1,109 @@
1
+ # summary
2
+
3
+ Schedule a package push upgrade.
4
+
5
+ # description
6
+
7
+ Represents a push upgrade request for upgrading a package in one or many orgs from one version to another version.
8
+ To initiate a push upgrade for an unlocked or second-generation managed package, the Create and Update Second-Generation Packages user permission is required.
9
+ For second-generation managed packages, the push upgrade feature is available only for packages that have passed AppExchange security review. To enable push upgrades for your managed package, log a support case in the Salesforce Partner Community.
10
+ For unlocked packages, push upgrades are enabled by default.
11
+
12
+ Use the -–migrate-to-2GP flag to indicate you’re installing a converted second-generation managed package into an org that has the first-generation managed package version of that package installed.
13
+
14
+ # flags.target-dev-hub.summary
15
+
16
+ Username or alias of the Dev Hub org.
17
+
18
+ # flags.target-dev-hub.description
19
+
20
+ Overrides the value of the target-dev-hub configuration variable, if set.
21
+
22
+ # flags.package.summary
23
+
24
+ ID (starts with 04t) of the package version that the package is being upgraded to. The package version must be an active, non-beta package version.
25
+
26
+ # flags.start-time.summary
27
+
28
+ Date and time (UTC) when the push upgrade is processed. Set to the earliest time that you want Salesforce to attempt to start the upgrade.
29
+
30
+ # flags.start-time.description
31
+
32
+ Scheduled push upgrades begin as soon as resources are available on the Salesforce instance, which is either at or after the start time you specify. In certain scenarios, the push upgrade starts a few hours after the scheduled start time.
33
+
34
+ As a best practice, schedule push upgrades at off-peak hours like 1:00 AM Saturday.
35
+ If you don't specify this flag, the push upgrade is scheduled to run as soon as resources are available on the Salesforce instance.
36
+
37
+ # flags.org-file.summary
38
+
39
+ Filename of the CSV file that contains the list of orgs that need the package upgrade.
40
+
41
+ # flags.org-file.description
42
+
43
+ The file must contain one org per line. The org ID must be the only value in each row.
44
+ All listed orgs must have a package version installed in their org that is lower than the package version you specified for the --package-version flag.
45
+
46
+ # flags.org-list.summary
47
+
48
+ Comma-separated list of subscriber org IDs that need the package upgrade.
49
+
50
+ # flags.migrate-to-2gp.summary
51
+
52
+ Upgrade from a first-generation managed package (1GP) to a second-generation managed package (2GP). Required when you’re pushing a 2GP package to orgs with the 1GP version installed.
53
+
54
+ # error.invalid-package-version
55
+
56
+ Invalid package version.
57
+
58
+ # error.empty-org-list
59
+
60
+ Can’t schedule the package push upgrade. The
61
+ org file you specified is empty. Review the file you specified, and retry this command.
62
+
63
+ # error.empty-org-input
64
+
65
+ There are no org Ids.
66
+
67
+ # error.invalid-org-file
68
+
69
+ Can’t schedule the package push upgrade. The org file you specified is invalid. The org file must be a CSV file, and each row can contain only one org ID. Review and update your org file and retry this command.
70
+
71
+ # error.invalid-org-input
72
+
73
+ Can’t schedule the package push upgrade. One or more of the orgs IDs you specified in the org list is an invalid org ID. Review the list of orgs you specified, and retry this command
74
+
75
+ # error.no-org-file-or-org-list-input
76
+
77
+ Can’t schedule the package push upgrade. You must specify either a list of orgs, or a file containing the list of orgs to be upgraded. Retry this command using either --org-list or --org-file flag and include the required details.
78
+
79
+ # examples
80
+
81
+ - Schedule a push upgrade that initiates at a specified time:
82
+ <%= config.bin %> <%= command.id %> --package 04txyz --start-time "2024-12-06T21:00:00" --org-file upgrade-orgs.csv
83
+
84
+ - Schedule a push upgrade that initiates as soon as possible:
85
+ <%= config.bin %> <%= command.id %> --package 04txyz --org-file upgrade-orgs.csv
86
+
87
+ - Schedule a push migration from a 1GP package to a 2GP package:
88
+ <%= config.bin %> <%= command.id %> --migrate-to-2gp --package 04txyz --start-time "2024-12-06T21:00:00" --org-file upgrade-orgs.csv --target-dev-hub myHub
89
+
90
+ # id
91
+
92
+ ID
93
+
94
+ # status
95
+
96
+ Status
97
+
98
+ # package-id
99
+
100
+ Package Id
101
+
102
+ # packageVersionId
103
+
104
+ Package Version Id
105
+
106
+ # output
107
+
108
+ Push upgrade has been scheduled. To check the status of this push upgrade, use push upgrade request ID [%s] with either "package push-upgrade list" or "package push-upgrade report".
109
+ Orgs scheduled for push upgrade: {%s}
@@ -153,7 +153,6 @@
153
153
  "char": "a",
154
154
  "deprecateAliases": true,
155
155
  "description": "Specify a released patch version as major.minor.patch.build to convert to second generation package version",
156
- "hidden": true,
157
156
  "name": "patch-version",
158
157
  "summary": "Specific released patch version to convert",
159
158
  "hasDynamicHelp": false,
@@ -162,7 +161,6 @@
162
161
  }
163
162
  },
164
163
  "hasDynamicHelp": true,
165
- "hidden": true,
166
164
  "hiddenAliases": [],
167
165
  "id": "package:convert",
168
166
  "pluginAlias": "@salesforce/plugin-packaging",
@@ -1290,6 +1288,485 @@
1290
1288
  "list:installed:package"
1291
1289
  ]
1292
1290
  },
1291
+ "package:push-upgrade:abort": {
1292
+ "aliases": [],
1293
+ "args": {},
1294
+ "description": "Specify the request ID for which you want abort the request. If applicable, the command displays errors related to the request.\n\nTo show all requests in the org, run \"<%= config.bin %> package pushupgrade list --package 033...\".",
1295
+ "examples": [
1296
+ "Cancel the specified package push upgrade request with the specified ID; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --push-request-id 0DV...",
1297
+ "Cancel the specified package push upgrade request in the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --push-request-id 0DV... --target-dev-hub devhub@example.com"
1298
+ ],
1299
+ "flags": {
1300
+ "json": {
1301
+ "description": "Format output as json.",
1302
+ "helpGroup": "GLOBAL",
1303
+ "name": "json",
1304
+ "allowNo": false,
1305
+ "type": "boolean"
1306
+ },
1307
+ "flags-dir": {
1308
+ "helpGroup": "GLOBAL",
1309
+ "name": "flags-dir",
1310
+ "summary": "Import flag values from a directory.",
1311
+ "hasDynamicHelp": false,
1312
+ "multiple": false,
1313
+ "type": "option"
1314
+ },
1315
+ "target-dev-hub": {
1316
+ "char": "v",
1317
+ "name": "target-dev-hub",
1318
+ "noCacheDefault": true,
1319
+ "required": true,
1320
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1321
+ "hasDynamicHelp": true,
1322
+ "multiple": false,
1323
+ "type": "option"
1324
+ },
1325
+ "api-version": {
1326
+ "description": "Override the api version used for api requests made by this command",
1327
+ "name": "api-version",
1328
+ "hasDynamicHelp": false,
1329
+ "multiple": false,
1330
+ "type": "option"
1331
+ },
1332
+ "push-request-id": {
1333
+ "char": "i",
1334
+ "name": "push-request-id",
1335
+ "required": true,
1336
+ "summary": "ID of the package push request (starts with 0DV). This ID is returned after the package push-upgrade schedule command completes successfully.",
1337
+ "hasDynamicHelp": false,
1338
+ "multiple": false,
1339
+ "type": "option"
1340
+ }
1341
+ },
1342
+ "hasDynamicHelp": true,
1343
+ "hiddenAliases": [],
1344
+ "id": "package:push-upgrade:abort",
1345
+ "pluginAlias": "@salesforce/plugin-packaging",
1346
+ "pluginName": "@salesforce/plugin-packaging",
1347
+ "pluginType": "core",
1348
+ "strict": true,
1349
+ "summary": "Abort a package push upgrade that has been scheduled. Only push upgrade requests with a status of Created or Pending can be aborted.",
1350
+ "enableJsonFlag": true,
1351
+ "isESM": true,
1352
+ "relativePath": [
1353
+ "lib",
1354
+ "commands",
1355
+ "package",
1356
+ "push-upgrade",
1357
+ "abort.js"
1358
+ ],
1359
+ "aliasPermutations": [],
1360
+ "permutations": [
1361
+ "package:push-upgrade:abort",
1362
+ "push-upgrade:package:abort",
1363
+ "push-upgrade:abort:package",
1364
+ "package:abort:push-upgrade",
1365
+ "abort:package:push-upgrade",
1366
+ "abort:push-upgrade:package"
1367
+ ]
1368
+ },
1369
+ "package:push-upgrade:list": {
1370
+ "aliases": [
1371
+ "force:package:push-upgrade:list"
1372
+ ],
1373
+ "args": {},
1374
+ "description": "Shows the details of each request to create a push upgrade in the Dev Hub org.\n\nAll filter parameters are applied using the AND logical operator (not OR).\n\nTo get information about a specific request, run \"sf package pushupgrade report\" and supply the request ID.",
1375
+ "examples": [
1376
+ "List all package push upgrade requests in the specified Dev Hub org:\n<%= config.bin %> <%= command.id %> --package 033xyz --target-dev-hub myHub",
1377
+ "List all package push upgrade requests in the specified Dev Hub org scheduled in the last 30 days:\n<%= config.bin %> <%= command.id %> --package 033xyz --scheduled-last-days 30 --target-dev-hub myHub",
1378
+ "List all package push upgrade with a status Succeeded:\n<%= config.bin %> <%= command.id %> --package 033xyz –-status Succeeded",
1379
+ "List all package push upgrade with a status Failed:\n<%= config.bin %> <%= command.id %> --package 033xyz –-status Failed"
1380
+ ],
1381
+ "flags": {
1382
+ "json": {
1383
+ "description": "Format output as json.",
1384
+ "helpGroup": "GLOBAL",
1385
+ "name": "json",
1386
+ "allowNo": false,
1387
+ "type": "boolean"
1388
+ },
1389
+ "flags-dir": {
1390
+ "helpGroup": "GLOBAL",
1391
+ "name": "flags-dir",
1392
+ "summary": "Import flag values from a directory.",
1393
+ "hasDynamicHelp": false,
1394
+ "multiple": false,
1395
+ "type": "option"
1396
+ },
1397
+ "target-dev-hub": {
1398
+ "aliases": [
1399
+ "targetdevhubusername",
1400
+ "target-hub-org"
1401
+ ],
1402
+ "char": "v",
1403
+ "deprecateAliases": true,
1404
+ "name": "target-dev-hub",
1405
+ "noCacheDefault": true,
1406
+ "required": true,
1407
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1408
+ "hasDynamicHelp": true,
1409
+ "multiple": false,
1410
+ "type": "option"
1411
+ },
1412
+ "api-version": {
1413
+ "aliases": [
1414
+ "apiversion"
1415
+ ],
1416
+ "deprecateAliases": true,
1417
+ "description": "Override the api version used for api requests made by this command",
1418
+ "name": "api-version",
1419
+ "hasDynamicHelp": false,
1420
+ "multiple": false,
1421
+ "type": "option"
1422
+ },
1423
+ "package": {
1424
+ "char": "p",
1425
+ "name": "package",
1426
+ "required": true,
1427
+ "summary": "Package ID (starts with 033) of the package that you want push upgrade information for.",
1428
+ "hasDynamicHelp": false,
1429
+ "multiple": false,
1430
+ "type": "option"
1431
+ },
1432
+ "scheduled-last-days": {
1433
+ "aliases": [
1434
+ "scheduledlastdays"
1435
+ ],
1436
+ "char": "l",
1437
+ "deprecateAliases": true,
1438
+ "name": "scheduled-last-days",
1439
+ "summary": "Number of days in the past for which to display the list of push upgrade requests that were scheduled. Used to filter the list output to only recently scheduled push upgrades.",
1440
+ "hasDynamicHelp": false,
1441
+ "multiple": false,
1442
+ "type": "option"
1443
+ },
1444
+ "status": {
1445
+ "char": "s",
1446
+ "name": "status",
1447
+ "summary": "Status used to filter the list output Valid values are: Created, Canceled, Pending, In Progress, Failed, or Succeeded",
1448
+ "hasDynamicHelp": false,
1449
+ "multiple": false,
1450
+ "options": [
1451
+ "Created",
1452
+ "Cancelled",
1453
+ "Pending",
1454
+ "In Progress",
1455
+ "Failed",
1456
+ "Succeeded"
1457
+ ],
1458
+ "type": "option"
1459
+ },
1460
+ "show-push-migrations-only": {
1461
+ "name": "show-push-migrations-only",
1462
+ "summary": "Display only push upgrade requests for package migrations.",
1463
+ "allowNo": false,
1464
+ "type": "boolean"
1465
+ }
1466
+ },
1467
+ "hasDynamicHelp": true,
1468
+ "hiddenAliases": [],
1469
+ "id": "package:push-upgrade:list",
1470
+ "pluginAlias": "@salesforce/plugin-packaging",
1471
+ "pluginName": "@salesforce/plugin-packaging",
1472
+ "pluginType": "core",
1473
+ "strict": true,
1474
+ "summary": "Lists the status of push upgrade requests for a given package.",
1475
+ "enableJsonFlag": true,
1476
+ "isESM": true,
1477
+ "relativePath": [
1478
+ "lib",
1479
+ "commands",
1480
+ "package",
1481
+ "push-upgrade",
1482
+ "list.js"
1483
+ ],
1484
+ "aliasPermutations": [
1485
+ "force:package:push-upgrade:list",
1486
+ "package:force:push-upgrade:list",
1487
+ "package:push-upgrade:force:list",
1488
+ "package:push-upgrade:list:force",
1489
+ "force:push-upgrade:package:list",
1490
+ "push-upgrade:force:package:list",
1491
+ "push-upgrade:package:force:list",
1492
+ "push-upgrade:package:list:force",
1493
+ "force:push-upgrade:list:package",
1494
+ "push-upgrade:force:list:package",
1495
+ "push-upgrade:list:force:package",
1496
+ "push-upgrade:list:package:force",
1497
+ "force:package:list:push-upgrade",
1498
+ "package:force:list:push-upgrade",
1499
+ "package:list:force:push-upgrade",
1500
+ "package:list:push-upgrade:force",
1501
+ "force:list:package:push-upgrade",
1502
+ "list:force:package:push-upgrade",
1503
+ "list:package:force:push-upgrade",
1504
+ "list:package:push-upgrade:force",
1505
+ "force:list:push-upgrade:package",
1506
+ "list:force:push-upgrade:package",
1507
+ "list:push-upgrade:force:package",
1508
+ "list:push-upgrade:package:force"
1509
+ ],
1510
+ "permutations": [
1511
+ "package:push-upgrade:list",
1512
+ "push-upgrade:package:list",
1513
+ "push-upgrade:list:package",
1514
+ "package:list:push-upgrade",
1515
+ "list:package:push-upgrade",
1516
+ "list:push-upgrade:package"
1517
+ ]
1518
+ },
1519
+ "package:push-upgrade:report": {
1520
+ "aliases": [
1521
+ "force:package:push-upgrade:report"
1522
+ ],
1523
+ "args": {},
1524
+ "deprecateAliases": true,
1525
+ "description": "Specify the request ID for which you want to view details. If applicable, the command displays errors related to the request.\n\nTo show all requests in the org, run \"<%= config.bin %> package pushupgrade list\".",
1526
+ "examples": [
1527
+ "Retrieve details about the package push upgrade with the specified ID; uses your default Dev Hub org:\n<%= config.bin %> <%= command.id %> --push-request-id 0DV...",
1528
+ "Retrieve details about the specified package push request in the Dev Hub org with username devhub@example.com:\n<%= config.bin %> <%= command.id %> --push-request-id 0DV... --target-dev-hub devhub@example.com"
1529
+ ],
1530
+ "flags": {
1531
+ "json": {
1532
+ "description": "Format output as json.",
1533
+ "helpGroup": "GLOBAL",
1534
+ "name": "json",
1535
+ "allowNo": false,
1536
+ "type": "boolean"
1537
+ },
1538
+ "flags-dir": {
1539
+ "helpGroup": "GLOBAL",
1540
+ "name": "flags-dir",
1541
+ "summary": "Import flag values from a directory.",
1542
+ "hasDynamicHelp": false,
1543
+ "multiple": false,
1544
+ "type": "option"
1545
+ },
1546
+ "loglevel": {
1547
+ "deprecated": {
1548
+ "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."
1549
+ },
1550
+ "hidden": true,
1551
+ "name": "loglevel",
1552
+ "hasDynamicHelp": false,
1553
+ "multiple": false,
1554
+ "type": "option"
1555
+ },
1556
+ "target-dev-hub": {
1557
+ "aliases": [
1558
+ "targetdevhubusername",
1559
+ "target-hub-org"
1560
+ ],
1561
+ "char": "v",
1562
+ "deprecateAliases": true,
1563
+ "name": "target-dev-hub",
1564
+ "noCacheDefault": true,
1565
+ "required": true,
1566
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
1567
+ "hasDynamicHelp": true,
1568
+ "multiple": false,
1569
+ "type": "option"
1570
+ },
1571
+ "api-version": {
1572
+ "aliases": [
1573
+ "apiversion"
1574
+ ],
1575
+ "deprecateAliases": true,
1576
+ "description": "Override the api version used for api requests made by this command",
1577
+ "name": "api-version",
1578
+ "hasDynamicHelp": false,
1579
+ "multiple": false,
1580
+ "type": "option"
1581
+ },
1582
+ "push-request-id": {
1583
+ "aliases": [
1584
+ "pushrequestid"
1585
+ ],
1586
+ "char": "i",
1587
+ "deprecateAliases": true,
1588
+ "name": "push-request-id",
1589
+ "required": true,
1590
+ "summary": "ID of the package push request (starts with 0DV). This ID is returned after the package push-upgrade schedule command completes successfully.",
1591
+ "hasDynamicHelp": false,
1592
+ "multiple": false,
1593
+ "type": "option"
1594
+ }
1595
+ },
1596
+ "hasDynamicHelp": true,
1597
+ "hiddenAliases": [],
1598
+ "id": "package:push-upgrade:report",
1599
+ "pluginAlias": "@salesforce/plugin-packaging",
1600
+ "pluginName": "@salesforce/plugin-packaging",
1601
+ "pluginType": "core",
1602
+ "strict": true,
1603
+ "summary": "Retrieve the status of a package push upgrade.",
1604
+ "enableJsonFlag": true,
1605
+ "isESM": true,
1606
+ "relativePath": [
1607
+ "lib",
1608
+ "commands",
1609
+ "package",
1610
+ "push-upgrade",
1611
+ "report.js"
1612
+ ],
1613
+ "aliasPermutations": [
1614
+ "force:package:push-upgrade:report",
1615
+ "package:force:push-upgrade:report",
1616
+ "package:push-upgrade:force:report",
1617
+ "package:push-upgrade:report:force",
1618
+ "force:push-upgrade:package:report",
1619
+ "push-upgrade:force:package:report",
1620
+ "push-upgrade:package:force:report",
1621
+ "push-upgrade:package:report:force",
1622
+ "force:push-upgrade:report:package",
1623
+ "push-upgrade:force:report:package",
1624
+ "push-upgrade:report:force:package",
1625
+ "push-upgrade:report:package:force",
1626
+ "force:package:report:push-upgrade",
1627
+ "package:force:report:push-upgrade",
1628
+ "package:report:force:push-upgrade",
1629
+ "package:report:push-upgrade:force",
1630
+ "force:report:package:push-upgrade",
1631
+ "report:force:package:push-upgrade",
1632
+ "report:package:force:push-upgrade",
1633
+ "report:package:push-upgrade:force",
1634
+ "force:report:push-upgrade:package",
1635
+ "report:force:push-upgrade:package",
1636
+ "report:push-upgrade:force:package",
1637
+ "report:push-upgrade:package:force"
1638
+ ],
1639
+ "permutations": [
1640
+ "package:push-upgrade:report",
1641
+ "push-upgrade:package:report",
1642
+ "push-upgrade:report:package",
1643
+ "package:report:push-upgrade",
1644
+ "report:package:push-upgrade",
1645
+ "report:push-upgrade:package"
1646
+ ]
1647
+ },
1648
+ "package:push-upgrade:schedule": {
1649
+ "aliases": [],
1650
+ "args": {},
1651
+ "description": "Represents a push upgrade request for upgrading a package in one or many orgs from one version to another version.\nTo initiate a push upgrade for an unlocked or second-generation managed package, the Create and Update Second-Generation Packages user permission is required.\nFor second-generation managed packages, the push upgrade feature is available only for packages that have passed AppExchange security review. To enable push upgrades for your managed package, log a support case in the Salesforce Partner Community.\nFor unlocked packages, push upgrades are enabled by default.\n\nUse the -–migrate-to-2GP flag to indicate you’re installing a converted second-generation managed package into an org that has the first-generation managed package version of that package installed.",
1652
+ "examples": [
1653
+ "Schedule a push upgrade that initiates at a specified time:\n<%= config.bin %> <%= command.id %> --package 04txyz --start-time \"2024-12-06T21:00:00\" --org-file upgrade-orgs.csv",
1654
+ "Schedule a push upgrade that initiates as soon as possible:\n<%= config.bin %> <%= command.id %> --package 04txyz --org-file upgrade-orgs.csv",
1655
+ "Schedule a push migration from a 1GP package to a 2GP package:\n<%= config.bin %> <%= command.id %> --migrate-to-2gp --package 04txyz --start-time \"2024-12-06T21:00:00\" --org-file upgrade-orgs.csv --target-dev-hub myHub"
1656
+ ],
1657
+ "flags": {
1658
+ "json": {
1659
+ "description": "Format output as json.",
1660
+ "helpGroup": "GLOBAL",
1661
+ "name": "json",
1662
+ "allowNo": false,
1663
+ "type": "boolean"
1664
+ },
1665
+ "flags-dir": {
1666
+ "helpGroup": "GLOBAL",
1667
+ "name": "flags-dir",
1668
+ "summary": "Import flag values from a directory.",
1669
+ "hasDynamicHelp": false,
1670
+ "multiple": false,
1671
+ "type": "option"
1672
+ },
1673
+ "target-dev-hub": {
1674
+ "char": "v",
1675
+ "description": "Overrides the value of the target-dev-hub configuration variable, if set.",
1676
+ "name": "target-dev-hub",
1677
+ "noCacheDefault": true,
1678
+ "required": true,
1679
+ "summary": "Username or alias of the Dev Hub org.",
1680
+ "hasDynamicHelp": true,
1681
+ "multiple": false,
1682
+ "type": "option"
1683
+ },
1684
+ "api-version": {
1685
+ "aliases": [
1686
+ "apiversion"
1687
+ ],
1688
+ "deprecateAliases": true,
1689
+ "description": "Override the api version used for api requests made by this command",
1690
+ "name": "api-version",
1691
+ "hasDynamicHelp": false,
1692
+ "multiple": false,
1693
+ "type": "option"
1694
+ },
1695
+ "package": {
1696
+ "char": "p",
1697
+ "name": "package",
1698
+ "required": true,
1699
+ "summary": "ID (starts with 04t) of the package version that the package is being upgraded to. The package version must be an active, non-beta package version.",
1700
+ "hasDynamicHelp": false,
1701
+ "multiple": false,
1702
+ "type": "option"
1703
+ },
1704
+ "start-time": {
1705
+ "char": "t",
1706
+ "description": "Scheduled push upgrades begin as soon as resources are available on the Salesforce instance, which is either at or after the start time you specify. In certain scenarios, the push upgrade starts a few hours after the scheduled start time.\n\nAs a best practice, schedule push upgrades at off-peak hours like 1:00 AM Saturday. \nIf you don't specify this flag, the push upgrade is scheduled to run as soon as resources are available on the Salesforce instance.",
1707
+ "name": "start-time",
1708
+ "summary": "Date and time (UTC) when the push upgrade is processed. Set to the earliest time that you want Salesforce to attempt to start the upgrade.",
1709
+ "hasDynamicHelp": false,
1710
+ "multiple": false,
1711
+ "type": "option"
1712
+ },
1713
+ "org-list": {
1714
+ "char": "l",
1715
+ "exclusive": [
1716
+ "org-file"
1717
+ ],
1718
+ "name": "org-list",
1719
+ "summary": "Comma-separated list of subscriber org IDs that need the package upgrade.",
1720
+ "hasDynamicHelp": false,
1721
+ "multiple": false,
1722
+ "type": "option"
1723
+ },
1724
+ "org-file": {
1725
+ "char": "f",
1726
+ "description": "The file must contain one org per line. The org ID must be the only value in each row. \nAll listed orgs must have a package version installed in their org that is lower than the package version you specified for the --package-version flag.",
1727
+ "exclusive": [
1728
+ "org-list"
1729
+ ],
1730
+ "name": "org-file",
1731
+ "summary": "Filename of the CSV file that contains the list of orgs that need the package upgrade.",
1732
+ "hasDynamicHelp": false,
1733
+ "multiple": false,
1734
+ "type": "option"
1735
+ },
1736
+ "migrate-to-2gp": {
1737
+ "name": "migrate-to-2gp",
1738
+ "summary": "Upgrade from a first-generation managed package (1GP) to a second-generation managed package (2GP). Required when you’re pushing a 2GP package to orgs with the 1GP version installed.",
1739
+ "allowNo": false,
1740
+ "type": "boolean"
1741
+ }
1742
+ },
1743
+ "hasDynamicHelp": true,
1744
+ "hiddenAliases": [],
1745
+ "id": "package:push-upgrade:schedule",
1746
+ "pluginAlias": "@salesforce/plugin-packaging",
1747
+ "pluginName": "@salesforce/plugin-packaging",
1748
+ "pluginType": "core",
1749
+ "strict": true,
1750
+ "summary": "Schedule a package push upgrade.",
1751
+ "enableJsonFlag": true,
1752
+ "isESM": true,
1753
+ "relativePath": [
1754
+ "lib",
1755
+ "commands",
1756
+ "package",
1757
+ "push-upgrade",
1758
+ "schedule.js"
1759
+ ],
1760
+ "aliasPermutations": [],
1761
+ "permutations": [
1762
+ "package:push-upgrade:schedule",
1763
+ "push-upgrade:package:schedule",
1764
+ "push-upgrade:schedule:package",
1765
+ "package:schedule:push-upgrade",
1766
+ "schedule:package:push-upgrade",
1767
+ "schedule:push-upgrade:package"
1768
+ ]
1769
+ },
1293
1770
  "package:uninstall:report": {
1294
1771
  "aliases": [
1295
1772
  "force:package:uninstall:report"
@@ -4065,5 +4542,5 @@
4065
4542
  ]
4066
4543
  }
4067
4544
  },
4068
- "version": "2.13.6"
4545
+ "version": "2.15.0"
4069
4546
  }
package/package.json CHANGED
@@ -1,22 +1,22 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-packaging",
3
3
  "description": "SF plugin that support Salesforce Packaging Platform",
4
- "version": "2.13.6",
4
+ "version": "2.15.0",
5
5
  "author": "Salesforce",
6
6
  "bugs": "https://github.com/forcedotcom/cli/issues",
7
7
  "dependencies": {
8
8
  "@oclif/core": "^4",
9
9
  "@salesforce/core": "^8.11.1",
10
10
  "@salesforce/kit": "^3.2.3",
11
- "@salesforce/packaging": "^4.5.0",
11
+ "@salesforce/packaging": "^4.6.0",
12
12
  "@salesforce/sf-plugins-core": "^12.2.2",
13
13
  "chalk": "^5.4.1"
14
14
  },
15
15
  "devDependencies": {
16
- "@oclif/plugin-command-snapshot": "^5.2.38",
16
+ "@oclif/plugin-command-snapshot": "^5.2.40",
17
17
  "@salesforce/cli-plugins-testkit": "^5.3.39",
18
18
  "@salesforce/dev-scripts": "^11.0.2",
19
- "@salesforce/plugin-command-reference": "^3.1.50",
19
+ "@salesforce/plugin-command-reference": "^3.1.54",
20
20
  "eslint-plugin-sf-plugin": "^1.20.23",
21
21
  "oclif": "^4.17.46",
22
22
  "ts-node": "^10.9.2",
@@ -247,7 +247,7 @@
247
247
  "exports": "./lib/index.js",
248
248
  "type": "module",
249
249
  "sfdx": {
250
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.13.6.crt",
251
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.13.6.sig"
250
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.15.0.crt",
251
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-packaging/2.15.0.sig"
252
252
  }
253
253
  }
@@ -0,0 +1,18 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/PackagePushUpgradeAbortResult",
4
+ "definitions": {
5
+ "PackagePushUpgradeAbortResult": {
6
+ "type": "object",
7
+ "properties": {
8
+ "success": {
9
+ "type": "boolean"
10
+ }
11
+ },
12
+ "required": [
13
+ "success"
14
+ ],
15
+ "additionalProperties": false
16
+ }
17
+ }
18
+ }