@salesforce/cli 1.37.0 → 1.40.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.
package/CHANGELOG.md CHANGED
@@ -2,7 +2,15 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
4
4
 
5
- ## [1.37.0](https://github.com/salesforcecli/cli/compare/v1.36.0...v1.37.0) (2022-07-13)
5
+ ## [1.40.0](https://github.com/salesforcecli/cli/compare/v1.39.0...v1.40.0) (2022-08-03)
6
+
7
+ ## [1.39.0](https://github.com/salesforcecli/cli/compare/v1.38.0...v1.39.0) (2022-07-27)
8
+
9
+ ## [1.38.0](https://github.com/salesforcecli/cli/compare/v1.36.0...v1.38.0) (2022-07-20)
10
+
11
+ ### Features
12
+
13
+ - run command match when only one exists ([ab519b8](https://github.com/salesforcecli/cli/commit/ab519b8a7739db232fbb8709e31ae274038bd5c8))
6
14
 
7
15
  ### Bug Fixes
8
16
 
package/README.md CHANGED
@@ -11,6 +11,7 @@
11
11
  - [Getting Started](#getting-started)
12
12
  - [Feedback](#feedback)
13
13
  - [Usage](#usage)
14
+ - [Architecture](#architecture)
14
15
  - [Commands](#commands)
15
16
  <!-- tocstop -->
16
17
 
@@ -31,7 +32,7 @@ $ npm install -g @salesforce/cli
31
32
  $ sf COMMAND
32
33
  running command...
33
34
  $ sf (--version|-v)
34
- @salesforce/cli/1.37.0 linux-x64 node-v14.20.0
35
+ @salesforce/cli/1.40.0 linux-x64 node-v14.20.0
35
36
  $ sf --help [COMMAND]
36
37
  USAGE
37
38
  $ sf COMMAND
@@ -40,6 +41,10 @@ USAGE
40
41
 
41
42
  <!-- usagestop -->
42
43
 
44
+ # Architecture
45
+
46
+ See [architecture page](ARCHITECTURE.md) for diagrams of the Salesforce CLI.
47
+
43
48
  # Commands
44
49
 
45
50
  <!-- commands -->
@@ -96,6 +101,7 @@ USAGE
96
101
  - [`sf plugins:install PLUGIN...`](#sf-pluginsinstall-plugin-1)
97
102
  - [`sf plugins:link PLUGIN`](#sf-pluginslink-plugin)
98
103
  - [`sf plugins:uninstall PLUGIN...`](#sf-pluginsuninstall-plugin)
104
+ - [`sf plugins:trust:verify -n <string> [-r <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sf-pluginstrustverify--n-string--r-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
99
105
  - [`sf plugins:uninstall PLUGIN...`](#sf-pluginsuninstall-plugin-1)
100
106
  - [`sf plugins:uninstall PLUGIN...`](#sf-pluginsuninstall-plugin-2)
101
107
  - [`sf plugins update`](#sf-plugins-update)
@@ -347,16 +353,18 @@ Deploy a Salesforce Function to an org from your local project.
347
353
 
348
354
  ```
349
355
  USAGE
350
- $ sf deploy functions -o <value> [-b <value>] [--force] [-q] [-j]
356
+ $ sf deploy functions -o <value> [--json] [-b <value>] [--force] [-q]
351
357
 
352
358
  FLAGS
353
359
  -b, --branch=<value> Deploy the latest commit from a branch different from the currently active branch.
354
- -j, --json Output list in JSON format.
355
360
  -o, --connected-org=<value> (required) Username or alias for the org that the compute environment should be connected
356
361
  to.
357
362
  -q, --quiet Limit the amount of output displayed from the deploy process.
358
363
  --force Ignore warnings and overwrite remote repository (not allowed in production).
359
364
 
365
+ GLOBAL FLAGS
366
+ --json Format output as json.
367
+
360
368
  DESCRIPTION
361
369
  Deploy a Salesforce Function to an org from your local project.
362
370
 
@@ -988,13 +996,15 @@ Create a compute environment for use with Salesforce Functions.
988
996
 
989
997
  ```
990
998
  USAGE
991
- $ sf env create compute [-o <value>] [-a <value>] [-j]
999
+ $ sf env create compute [--json] [-o <value>] [-a <value>]
992
1000
 
993
1001
  FLAGS
994
1002
  -a, --alias=<value> Alias for the created environment.
995
- -j, --json Output list in JSON format.
996
1003
  -o, --connected-org=<value> Username or alias for the org that the compute environment should be connected to.
997
1004
 
1005
+ GLOBAL FLAGS
1006
+ --json Format output as json.
1007
+
998
1008
  DESCRIPTION
999
1009
  Create a compute environment for use with Salesforce Functions.
1000
1010
 
@@ -1227,13 +1237,15 @@ Delete an environment.
1227
1237
 
1228
1238
  ```
1229
1239
  USAGE
1230
- $ sf env delete [-e <value> | ] [--confirm <value>] [-j]
1240
+ $ sf env delete [--json] [-e <value> | ] [--confirm <value>]
1231
1241
 
1232
1242
  FLAGS
1233
1243
  -e, --target-compute=<value> Environment name.
1234
- -j, --json Output list in JSON format.
1235
1244
  --confirm=name... Confirmation name.
1236
1245
 
1246
+ GLOBAL FLAGS
1247
+ --json Format output as json.
1248
+
1237
1249
  DESCRIPTION
1238
1250
  Delete an environment.
1239
1251
 
@@ -1474,13 +1486,15 @@ Add log drain to a specified environment.
1474
1486
 
1475
1487
  ```
1476
1488
  USAGE
1477
- $ sf env logdrain add [-e <value> | ] [-l <value> | ] [-j]
1489
+ $ sf env logdrain add [--json] [-e <value> | ] [-l <value> | ]
1478
1490
 
1479
1491
  FLAGS
1480
1492
  -e, --target-compute=<value> Environment name.
1481
- -j, --json Output list in JSON format.
1482
1493
  -l, --drain-url=<value> Endpoint that will receive sent logs.
1483
1494
 
1495
+ GLOBAL FLAGS
1496
+ --json Format output as json.
1497
+
1484
1498
  DESCRIPTION
1485
1499
  Add log drain to a specified environment.
1486
1500
 
@@ -1499,11 +1513,13 @@ List log drains connected to a specified environment.
1499
1513
 
1500
1514
  ```
1501
1515
  USAGE
1502
- $ sf env logdrain list [-e <value> | ] [-j]
1516
+ $ sf env logdrain list [--json] [-e <value> | ]
1503
1517
 
1504
1518
  FLAGS
1505
1519
  -e, --target-compute=<value> Environment name.
1506
- -j, --json Output list in JSON format.
1520
+
1521
+ GLOBAL FLAGS
1522
+ --json Format output as json.
1507
1523
 
1508
1524
  EXAMPLES
1509
1525
  List log drains:
@@ -1521,13 +1537,15 @@ Remove log drain from a specified environment.
1521
1537
 
1522
1538
  ```
1523
1539
  USAGE
1524
- $ sf env logdrain remove [-e <value> | ] [-l <value> | ] [-j]
1540
+ $ sf env logdrain remove [--json] [-e <value> | ] [-l <value> | ]
1525
1541
 
1526
1542
  FLAGS
1527
1543
  -e, --target-compute=<value> Environment name.
1528
- -j, --json Output list in JSON format.
1529
1544
  -l, --drain-url=<value> Log drain url to remove.
1530
1545
 
1546
+ GLOBAL FLAGS
1547
+ --json Format output as json.
1548
+
1531
1549
  DESCRIPTION
1532
1550
  Remove log drain from a specified environment.
1533
1551
 
@@ -1700,11 +1718,13 @@ Display a single config variable for an environment.
1700
1718
 
1701
1719
  ```
1702
1720
  USAGE
1703
- $ sf env var get [KEY] [-e <value> | ] [-j]
1721
+ $ sf env var get [KEY] [--json] [-e <value> | ]
1704
1722
 
1705
1723
  FLAGS
1706
1724
  -e, --target-compute=<value> Environment name.
1707
- -j, --json Output list in JSON format.
1725
+
1726
+ GLOBAL FLAGS
1727
+ --json Format output as json.
1708
1728
 
1709
1729
  DESCRIPTION
1710
1730
  Display a single config variable for an environment.
@@ -1723,11 +1743,13 @@ List your environment's config vars in a table.
1723
1743
 
1724
1744
  ```
1725
1745
  USAGE
1726
- $ sf env var list [-e <value> | ] [-j]
1746
+ $ sf env var list [--json] [-e <value> | ]
1727
1747
 
1728
1748
  FLAGS
1729
1749
  -e, --target-compute=<value> Environment name.
1730
- -j, --json Output list in JSON format.
1750
+
1751
+ GLOBAL FLAGS
1752
+ --json Format output as json.
1731
1753
 
1732
1754
  DESCRIPTION
1733
1755
  List your environment's config vars in a table.
@@ -1750,11 +1772,13 @@ Set a single config value for an environment.
1750
1772
 
1751
1773
  ```
1752
1774
  USAGE
1753
- $ sf env var set [-e <value> | ] [-j]
1775
+ $ sf env var set [--json] [-e <value> | ]
1754
1776
 
1755
1777
  FLAGS
1756
1778
  -e, --target-compute=<value> Environment name.
1757
- -j, --json Output list in JSON format.
1779
+
1780
+ GLOBAL FLAGS
1781
+ --json Format output as json.
1758
1782
 
1759
1783
  EXAMPLES
1760
1784
  Set a config value:
@@ -1768,11 +1792,13 @@ Unset a single config value for an environment.
1768
1792
 
1769
1793
  ```
1770
1794
  USAGE
1771
- $ sf env var unset [-e <value> | ] [-j]
1795
+ $ sf env var unset [--json] [-e <value> | ]
1772
1796
 
1773
1797
  FLAGS
1774
1798
  -e, --target-compute=<value> Environment name.
1775
- -j, --json Output list in JSON format.
1799
+
1800
+ GLOBAL FLAGS
1801
+ --json Format output as json.
1776
1802
 
1777
1803
  DESCRIPTION
1778
1804
  Unset a single config value for an environment.
@@ -2016,18 +2042,20 @@ Login using JWT instead of default web-based flow. This will authenticate you wi
2016
2042
 
2017
2043
  ```
2018
2044
  USAGE
2019
- $ sf login functions jwt -u <value> -f <value> -i <value> [-l <value> | ] [-j] [-a <value>] [-d] [-v]
2045
+ $ sf login functions jwt -u <value> -f <value> -i <value> [--json] [-l <value> | ] [-a <value>] [-d] [-v]
2020
2046
 
2021
2047
  FLAGS
2022
2048
  -a, --alias=<value> Alias for the org.
2023
2049
  -d, --set-default Set the org as the default that all org-related commands run against.
2024
2050
  -f, --keyfile=<value> (required) Path to JWT keyfile.
2025
2051
  -i, --clientid=<value> (required) OAuth client ID.
2026
- -j, --json Output list in JSON format.
2027
2052
  -l, --instance-url=<value> The login URL of the instance the org lives on.
2028
2053
  -u, --username=<value> (required) Authentication username.
2029
2054
  -v, --set-default-dev-hub Set the org as the default Dev Hub for scratch org creation.
2030
2055
 
2056
+ GLOBAL FLAGS
2057
+ --json Format output as json.
2058
+
2031
2059
  DESCRIPTION
2032
2060
  Login using JWT instead of default web-based flow. This will authenticate you with both sf and Salesforce Functions.
2033
2061
 
@@ -2264,10 +2292,10 @@ Log out of your Salesforce Functions account.
2264
2292
 
2265
2293
  ```
2266
2294
  USAGE
2267
- $ sf logout functions [-j]
2295
+ $ sf logout functions [--json]
2268
2296
 
2269
- FLAGS
2270
- -j, --json Output list in JSON format.
2297
+ GLOBAL FLAGS
2298
+ --json Format output as json.
2271
2299
 
2272
2300
  EXAMPLES
2273
2301
  Log out:
@@ -2482,6 +2510,33 @@ ALIASES
2482
2510
  $ sf plugins remove
2483
2511
  ```
2484
2512
 
2513
+ ## `sf plugins:trust:verify -n <string> [-r <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
2514
+
2515
+ Validate a digital signature for a npm package.
2516
+
2517
+ ```
2518
+ USAGE
2519
+ $ sf plugins trust verify -n <string> [-r <string>] [--json] [--loglevel
2520
+ trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
2521
+
2522
+ FLAGS
2523
+ -n, --npm=<value> (required) Specify the npm name.
2524
+ This can include a tag/version.
2525
+ -r, --registry=<value> The registry name. The behavior is
2526
+ the same as npm.
2527
+ --json format output as json
2528
+ --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL) [default: warn] logging level for
2529
+ this command invocation
2530
+
2531
+ DESCRIPTION
2532
+ Validate a digital signature for a npm package.
2533
+
2534
+ EXAMPLES
2535
+ $ sf plugins trust verify --npm @scope/npmName --registry http://my.repo.org:4874
2536
+
2537
+ $ sf plugins trust verify --npm @scope/npmName
2538
+ ```
2539
+
2485
2540
  ## `sf plugins:uninstall PLUGIN...`
2486
2541
 
2487
2542
  Removes a plugin from the CLI.
@@ -2666,16 +2721,18 @@ Send a cloudevent to a function.
2666
2721
 
2667
2722
  ```
2668
2723
  USAGE
2669
- $ sf run function [-l <value> | ] [-H <value>] [-p <value>] [-s] [-o <value>] [-j]
2724
+ $ sf run function [--json] [-l <value> | ] [-H <value>] [-p <value>] [-s] [-o <value>]
2670
2725
 
2671
2726
  FLAGS
2672
2727
  -H, --headers=<value>... Set headers.
2673
- -j, --json Output list in JSON format.
2674
2728
  -l, --function-url=<value> URL of the function to run.
2675
2729
  -o, --connected-org=<value> Username or alias for the target org; overrides default target org.
2676
2730
  -p, --payload=<value> Set the payload of the cloudevent as a JSON object or a path to a file via @file.json.
2677
2731
  -s, --structured Set the cloudevent to be emitted as a structured JSON cloudevent.
2678
2732
 
2733
+ GLOBAL FLAGS
2734
+ --json Format output as json.
2735
+
2679
2736
  EXAMPLES
2680
2737
  Run a function:
2681
2738
 
@@ -2885,10 +2942,10 @@ Show information on your Salesforce Functions login.
2885
2942
 
2886
2943
  ```
2887
2944
  USAGE
2888
- $ sf whoami functions [-j]
2945
+ $ sf whoami functions [--json]
2889
2946
 
2890
- FLAGS
2891
- -j, --json Output list in JSON format.
2947
+ GLOBAL FLAGS
2948
+ --json Format output as json.
2892
2949
 
2893
2950
  DESCRIPTION
2894
2951
  Show information on your Salesforce Functions login.
@@ -8,7 +8,9 @@
8
8
  Object.defineProperty(exports, "__esModule", { value: true });
9
9
  const core_1 = require("@oclif/core");
10
10
  const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
11
- const hook = async function ({ config, matches, argv }) {
11
+ async function determineCommand(config, matches) {
12
+ if (matches.length === 1)
13
+ return matches[0].id;
12
14
  const prompter = new sf_plugins_core_1.Prompter();
13
15
  const { command } = await prompter.timedPrompt([
14
16
  {
@@ -18,6 +20,10 @@ const hook = async function ({ config, matches, argv }) {
18
20
  choices: matches.map((p) => (0, core_1.toConfiguredId)(p.id, config)),
19
21
  },
20
22
  ]);
23
+ return command;
24
+ }
25
+ const hook = async function ({ config, matches, argv }) {
26
+ const command = await determineCommand(config, matches);
21
27
  if (argv.includes('--help') || argv.includes('-h')) {
22
28
  return config.runCommand('help', [(0, core_1.toStandardizedId)(command, config)]);
23
29
  }