@salesforce/plugin-settings 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+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.
+
+## 1.0.0 (2022-09-08)
+
+### Bug Fixes
+
+- allow test lib dir ([e7462c3](https://github.com/salesforcecli/plugin-settings/commit/e7462c366cd6e94837628c1c2786023934698694))
+- migrate plugin-config commands ([b1eb3f3](https://github.com/salesforcecli/plugin-settings/commit/b1eb3f397cbfd172e87d73b9038d66f91ce69bc4))
+- whoops ([3765278](https://github.com/salesforcecli/plugin-settings/commit/376527852b5f37c201d813dee9599a3453e25b67))
+
+# Changelog
+
+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.

package/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (c) 2022, Salesforce.com, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+* Neither the name of Salesforce.com nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,214 @@
+# plugin-settings
+
+[![NPM](https://img.shields.io/npm/v/@salesforce/plugin-settings.svg?label=@salesforce/plugin-settings)](https://www.npmjs.com/package/@salesforce/plugin-settings) [![CircleCI](https://circleci.com/gh/salesforcecli/plugin-settings/tree/main.svg?style=shield)](https://circleci.com/gh/salesforcecli/plugin-settings/tree/main) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-settings.svg)](https://npmjs.org/package/@salesforce/plugin-settings) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://raw.githubusercontent.com/salesforcecli/plugin-settings/main/LICENSE.txt)
+
+Config and alias commands for the `sf` Salesforce CLI
+
+> NOTE: This repo combines `plugin-config` and `plugin-alias` for `sf`.
+>
+> If you are looking for the `sfdx` command repos, they can be found here: [plugin-config](https://github.com/salesforcecli/plugin-config) and [plugin-alias](https://github.com/salesforcecli/plugin-alias)
+
+This plugin is bundled with the [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli). For more information on the CLI, read the [getting started guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm).
+
+We always recommend using the latest version of these commands bundled with the CLI, however, you can install a specific version or tag if needed.
+
+## Install
+
+```bash
+sf plugins install settings@x.y.z
+```
+
+## Issues
+
+Please report any issues at https://github.com/forcedotcom/cli/issues
+
+## Contributing
+
+1. Please read our [Code of Conduct](CODE_OF_CONDUCT.md)
+2. Create a new issue before starting your project so that we can keep track of
+   what you are trying to add/fix. That way, we can also offer suggestions or
+   let you know if there is already an effort in progress.
+3. Fork this repository.
+4. [Build the plugin locally](#build)
+5. Create a _topic_ branch in your fork. Note, this step is recommended but technically not required if contributing using a fork.
+6. Edit the code in your fork.
+7. Write appropriate tests for your changes. Try to achieve at least 95% code coverage on any new code. No pull request will be accepted without unit tests.
+8. Sign CLA (see [CLA](#cla) below).
+9. Send us a pull request when you are done. We'll review your code, suggest any needed changes, and merge it in.
+
+### CLA
+
+External contributors will be required to sign a Contributor's License
+Agreement. You can do so by going to https://cla.salesforce.com/sign-cla.
+
+### Build
+
+To build the plugin locally, make sure to have yarn installed and run the following commands:
+
+```bash
+# Clone the repository
+git clone git@github.com:salesforcecli/plugin-settings
+
+# Install the dependencies and compile
+yarn install
+yarn build
+```
+
+To use your plugin, run using the local `./bin/run` or `./bin/run.cmd` file.
+
+```bash
+# Run using local run file.
+./bin/run config
+```
+
+There should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.
+
+```bash
+# Link your plugin to the sf cli
+sf plugins link .
+# To verify
+sf plugins
+```
+
+# Commands
+
+<!-- commands -->
+
+- [`sf config get`](#sf-config-get)
+- [`sf config list`](#sf-config-list)
+- [`sf config set`](#sf-config-set)
+- [`sf config unset`](#sf-config-unset)
+
+## `sf config get`
+
+Get the value of a configuration variable.
+
+```
+USAGE
+  $ sf config get [--json] [--verbose]
+
+FLAGS
+  --verbose  Display whether the configuration variables are set locally or globally.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Get the value of a configuration variable.
+
+  Run "sf config list" to see all the configuration variables you've set. Global configuration variable are always
+  displayed; local ones are displayed if you run the command in a project directory. Run "sf config set" to set a
+  configuration variable.
+
+EXAMPLES
+  Get the value of the "target-org" configuration variable.
+
+    $ sf config get target-org
+
+  Get multiple configuration variables and display whether they're set locally or globally:
+
+    $ sf config get target-org api-version --verbose
+```
+
+## `sf config list`
+
+List the configuration variables that you've previously set.
+
+```
+USAGE
+  $ sf config list [--json]
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List the configuration variables that you've previously set.
+
+  Global configuration variables apply to any directory and are always displayed. If you run this command from a project
+  directory, local configuration variables are also displayed.
+
+EXAMPLES
+  List both global configuration variables and those local to your project:
+
+    $ sf config list
+```
+
+## `sf config set`
+
+Set one or more configuration variables, such as your default org.
+
+```
+USAGE
+  $ sf config set [--json] [-g]
+
+FLAGS
+  -g, --global  Set the configuration variables globally, so they can be used from any directory.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Set one or more configuration variables, such as your default org.
+
+  Use configuration variables to set CLI defaults, such as your default org or the API version you want the CLI to use.
+  For example, if you set the "target-org" configuration variable, you don't need to specify it as a "sf deploy
+  metadata" flag if you're deploying to your default org.
+
+  Local configuration variables apply only to your current project. Global variables, specified with the --global flag,
+  apply in any directory.
+
+  The resolution order if you've set a flag value in multiple ways is as follows:
+
+  1. Flag value specified at the command line.
+
+  2. Local (project-level) configuration variable.
+
+  3. Global configuration variable.
+
+  Run "sf config list" to see the configuration variables you've already set and their level (local or global).
+
+EXAMPLES
+  Set the local target-org configuration variable to an org username:
+
+    $ sf config set target-org=me@my.org
+
+  Set the local target-org configuration variable to an alias:
+
+    $ sf config set target-org=my-scratch-org
+
+  Set the global target-org configuration variable:
+
+    $ sf config set --global target-org=my-scratch-org
+```
+
+## `sf config unset`
+
+Unset local or global configuration variables.
+
+```
+USAGE
+  $ sf config unset [--json] [-g]
+
+FLAGS
+  -g, --global  Unset the configuration variables globally, so they can no longer be used from any directory.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Unset local or global configuration variables.
+
+  Local configuration variables apply only to your current project. Global configuration variables apply in any
+  directory.
+
+EXAMPLES
+  Unset the local "target-org" configuration variable:
+
+    $ sf config unset target-org
+
+  Unset multiple configuration variables globally:
+
+    $ sf config unset target-org api-version --global
+```
+
+<!-- commandsstop -->

package/lib/commands/config/get.d.ts

@@ -0,0 +1,12 @@
+import { ConfigCommand, ConfigResponses } from '../../config';
+export declare class Get extends ConfigCommand<ConfigResponses> {
+    static readonly description: string;
+    static readonly summary: string;
+    static readonly examples: string[];
+    static readonly strict = false;
+    static readonly flags: {
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static configurationVariablesSection: import("@salesforce/sf-plugins-core/lib/util").HelpSection;
+    run(): Promise<ConfigResponses>;
+}

package/lib/commands/config/get.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Get = void 0;
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const core_1 = require("@oclif/core");
+const core_2 = require("@salesforce/core");
+const config_1 = require("../../config");
+core_2.Messages.importMessagesDirectory(__dirname);
+const messages = core_2.Messages.loadMessages('@salesforce/plugin-settings', 'get');
+class Get extends config_1.ConfigCommand {
+    async run() {
+        const { argv, flags } = await this.parse(Get);
+        if (!argv || argv.length === 0) {
+            throw messages.createError('error.NoConfigKeysFound');
+        }
+        else {
+            const aggregator = await core_2.ConfigAggregator.create();
+            argv.forEach((configName) => {
+                try {
+                    this.pushSuccess(aggregator.getInfo(configName, true));
+                }
+                catch (err) {
+                    this.pushFailure(configName, err);
+                }
+            });
+            if (!this.jsonEnabled()) {
+                this.output('Get Config', flags.verbose);
+            }
+            return this.responses;
+        }
+    }
+}
+exports.Get = Get;
+Get.description = messages.getMessage('description');
+Get.summary = messages.getMessage('summary');
+Get.examples = messages.getMessages('examples');
+Get.strict = false;
+Get.flags = {
+    verbose: core_1.Flags.boolean({
+        summary: messages.getMessage('flags.verbose.summary'),
+    }),
+};
+Get.configurationVariablesSection = config_1.CONFIG_HELP_SECTION;
+//# sourceMappingURL=get.js.map

package/lib/commands/config/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/config/get.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,sCAAoC;AACpC,2CAA8D;AAC9D,yCAAmF;AAEnF,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;AAE7E,MAAa,GAAI,SAAQ,sBAA8B;IAa9C,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9B,MAAM,QAAQ,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;SACvD;aAAM;YACL,MAAM,UAAU,GAAG,MAAM,uBAAgB,CAAC,MAAM,EAAE,CAAC;YAEnD,IAAI,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC1B,IAAI;oBACF,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;iBACxD;gBAAC,OAAO,GAAG,EAAE;oBACZ,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,GAAY,CAAC,CAAC;iBAC5C;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;gBACvB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;aAC1C;YACD,OAAO,IAAI,CAAC,SAAS,CAAC;SACvB;IACH,CAAC;;AAlCH,kBAmCC;AAlCwB,eAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,WAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,YAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAC5C,UAAM,GAAG,KAAK,CAAC;AACf,SAAK,GAAG;IAC7B,OAAO,EAAE,YAAK,CAAC,OAAO,CAAC;QACrB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;KACtD,CAAC;CACH,CAAC;AAEY,iCAA6B,GAAG,4BAAmB,CAAC"}

package/lib/commands/config/list.d.ts

@@ -0,0 +1,8 @@
+import { ConfigCommand, ConfigResponses } from '../../config';
+export default class List extends ConfigCommand<ConfigResponses> {
+    static readonly description: string;
+    static readonly summary: string;
+    static readonly examples: string[];
+    static flags: {};
+    run(): Promise<ConfigResponses>;
+}

package/lib/commands/config/list.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const core_1 = require("@salesforce/core");
+const config_1 = require("../../config");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/plugin-settings', 'list');
+class List extends config_1.ConfigCommand {
+    async run() {
+        const aggregator = await core_1.ConfigAggregator.create();
+        aggregator.getConfigInfo().forEach((c) => {
+            this.pushSuccess(c);
+        });
+        if (!this.jsonEnabled()) {
+            this.output('List Config', true);
+        }
+        return this.responses;
+    }
+}
+exports.default = List;
+List.description = messages.getMessage('description');
+List.summary = messages.getMessage('summary');
+List.examples = messages.getMessages('examples');
+List.flags = {};
+//# sourceMappingURL=list.js.map

package/lib/commands/config/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/config/list.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,2CAA8D;AAC9D,yCAA8D;AAE9D,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;AAE9E,MAAqB,IAAK,SAAQ,sBAA8B;IAMvD,KAAK,CAAC,GAAG;QACd,MAAM,UAAU,GAAG,MAAM,uBAAgB,CAAC,MAAM,EAAE,CAAC;QAEnD,UAAU,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACvC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;SAClC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;;AAjBH,uBAkBC;AAjBwB,gBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,YAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,aAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AACrD,UAAK,GAAG,EAAE,CAAC"}

package/lib/commands/config/set.d.ts

@@ -0,0 +1,20 @@
+import { Config } from '@salesforce/core';
+import { ConfigCommand, ConfigResponses } from '../../config';
+export declare class Set extends ConfigCommand<ConfigResponses> {
+    static readonly description: string;
+    static readonly summary: string;
+    static readonly examples: string[];
+    static readonly strict = false;
+    static readonly flags: {
+        global: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static configurationVariablesSection: import("@salesforce/sf-plugins-core/lib/util").HelpSection;
+    run(): Promise<ConfigResponses>;
+    protected resolveArguments(): Promise<string[]>;
+    protected parseConfigKeysAndValues(): Promise<{
+        [index: string]: string;
+    }>;
+    protected loadConfig(global: boolean): Promise<Config>;
+    private isOrgKey;
+    private validateOrg;
+}

package/lib/commands/config/set.js

@@ -0,0 +1,110 @@
+"use strict";
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Set = void 0;
+const core_1 = require("@oclif/core");
+const core_2 = require("@salesforce/core");
+const config_1 = require("../../config");
+core_2.Messages.importMessagesDirectory(__dirname);
+const messages = core_2.Messages.loadMessages('@salesforce/plugin-settings', 'set');
+class Set extends config_1.ConfigCommand {
+    async run() {
+        const { flags } = await this.parse(Set);
+        const config = await this.loadConfig(flags.global);
+        let value = '';
+        const configs = await this.parseConfigKeysAndValues();
+        for (const name of Object.keys(configs)) {
+            try {
+                value = configs[name];
+                // core's builtin config validation requires synchronous functions but there's
+                // currently no way to validate an org synchronously. Therefore, we have to manually
+                // validate the org here and manually set the error message if it fails
+                if (this.isOrgKey(name) && value)
+                    await this.validateOrg(value);
+                config.set(name, value);
+                this.responses.push({ name, value, success: true });
+            }
+            catch (err) {
+                this.pushFailure(name, err, value);
+            }
+        }
+        await config.write();
+        if (!this.jsonEnabled()) {
+            this.output('Set Config', false);
+        }
+        return this.responses;
+    }
+    async resolveArguments() {
+        const { args, argv } = await this.parse(Set);
+        const argVals = Object.values(args);
+        return argv.filter((val) => !argVals.includes(val));
+    }
+    async parseConfigKeysAndValues() {
+        const configs = {};
+        const args = await this.resolveArguments();
+        if (!args.length) {
+            throw messages.createError('error.ArgumentsRequired');
+        }
+        // Support `config set key value`
+        if (args.length === 2 && !args[0].includes('=')) {
+            return { [args[0]]: args[1] };
+        }
+        // Ensure that all args are in the right format (e.g. key=value key1=value1)
+        args.forEach((arg) => {
+            const split = arg.split('=');
+            if (split.length !== 2) {
+                throw messages.createError('error.InvalidArgumentFormat', [arg]);
+            }
+            const [name, value] = split;
+            if (configs[name]) {
+                throw messages.createError('error.DuplicateArgument', [name]);
+            }
+            configs[name] = value || undefined;
+        });
+        return configs;
+    }
+    async loadConfig(global) {
+        try {
+            const config = await core_2.Config.create(core_2.Config.getDefaultOptions(global));
+            await config.read();
+            return config;
+        }
+        catch (error) {
+            if (error instanceof core_2.SfdxError) {
+                error.actions = error.actions || [];
+                error.actions.push('Run with --global to set for your entire workspace.');
+            }
+            throw error;
+        }
+    }
+    isOrgKey(name) {
+        const orgKeys = [core_2.OrgConfigProperties.TARGET_DEV_HUB, core_2.OrgConfigProperties.TARGET_ORG];
+        return orgKeys.includes(name);
+    }
+    async validateOrg(value) {
+        try {
+            await core_2.Org.create({ aliasOrUsername: value });
+        }
+        catch {
+            throw new Error(`Invalid config value: org "${value}" is not authenticated.`);
+        }
+    }
+}
+exports.Set = Set;
+Set.description = messages.getMessage('description');
+Set.summary = messages.getMessage('summary');
+Set.examples = messages.getMessages('examples');
+Set.strict = false;
+Set.flags = {
+    global: core_1.Flags.boolean({
+        char: 'g',
+        summary: messages.getMessage('flags.global.summary'),
+    }),
+};
+Set.configurationVariablesSection = config_1.CONFIG_HELP_SECTION;
+//# sourceMappingURL=set.js.map

package/lib/commands/config/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/commands/config/set.ts"],"names":[],"mappings":"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"}

package/lib/commands/config/unset.d.ts

@@ -0,0 +1,12 @@
+import { ConfigCommand, ConfigResponses } from '../../config';
+export declare class UnSet extends ConfigCommand<ConfigResponses> {
+    static readonly description: string;
+    static readonly summary: string;
+    static readonly examples: string[];
+    static readonly strict = false;
+    static configurationVariablesSection: import("@salesforce/sf-plugins-core/lib/util").HelpSection;
+    static readonly flags: {
+        global: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<ConfigResponses>;
+}

package/lib/commands/config/unset.js

@@ -0,0 +1,53 @@
+"use strict";
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnSet = void 0;
+const core_1 = require("@oclif/core");
+const core_2 = require("@salesforce/core");
+const config_1 = require("../../config");
+core_2.Messages.importMessagesDirectory(__dirname);
+const messages = core_2.Messages.loadMessages('@salesforce/plugin-settings', 'unset');
+class UnSet extends config_1.ConfigCommand {
+    async run() {
+        const { argv, flags } = await this.parse(UnSet);
+        if (!argv || argv.length === 0) {
+            throw messages.createError('error.NoConfigKeysFound');
+        }
+        else {
+            const config = await core_2.Config.create(core_2.Config.getDefaultOptions(flags.global));
+            await config.read();
+            argv.forEach((key) => {
+                try {
+                    config.unset(key);
+                    this.responses.push({ name: key, success: true });
+                }
+                catch (err) {
+                    this.pushFailure(key, err);
+                }
+            });
+            await config.write();
+            if (!this.jsonEnabled()) {
+                this.output('Unset Config', false);
+            }
+        }
+        return this.responses;
+    }
+}
+exports.UnSet = UnSet;
+UnSet.description = messages.getMessage('description');
+UnSet.summary = messages.getMessage('summary');
+UnSet.examples = messages.getMessages('examples');
+UnSet.strict = false;
+UnSet.configurationVariablesSection = config_1.CONFIG_HELP_SECTION;
+UnSet.flags = {
+    global: core_1.Flags.boolean({
+        char: 'g',
+        summary: messages.getMessage('flags.global.summary'),
+    }),
+};
+//# sourceMappingURL=unset.js.map

package/lib/commands/config/unset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset.js","sourceRoot":"","sources":["../../../src/commands/config/unset.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,sCAAoC;AACpC,2CAAoD;AACpD,yCAAmF;AAEnF,eAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,QAAQ,GAAG,eAAQ,CAAC,YAAY,CAAC,6BAA6B,EAAE,OAAO,CAAC,CAAC;AAE/E,MAAa,KAAM,SAAQ,sBAA8B;IAehD,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEhD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9B,MAAM,QAAQ,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;SACvD;aAAM;YACL,MAAM,MAAM,GAAW,MAAM,aAAM,CAAC,MAAM,CAAC,aAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAEnF,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnB,IAAI;oBACF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAClB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACnD;gBAAC,OAAO,GAAG,EAAE;oBACZ,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAY,CAAC,CAAC;iBACrC;YACH,CAAC,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;gBACvB,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;aACpC;SACF;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;;AAtCH,sBAuCC;AAtCwB,iBAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,aAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzC,cAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AAC5C,YAAM,GAAG,KAAK,CAAC;AAExB,mCAA6B,GAAG,4BAAmB,CAAC;AAE3C,WAAK,GAAG;IAC7B,MAAM,EAAE,YAAK,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC;KACrD,CAAC;CACH,CAAC"}

package/lib/config.d.ts

@@ -0,0 +1,19 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { ConfigInfo } from '@salesforce/core';
+export declare type Msg = {
+    name: string;
+    value?: string;
+    success: boolean;
+    location?: string;
+    path?: string;
+    message?: string;
+    error?: Error;
+};
+export declare type ConfigResponses = Msg[];
+export declare const CONFIG_HELP_SECTION: import("@salesforce/sf-plugins-core/lib/util").HelpSection;
+export declare abstract class ConfigCommand<T> extends SfCommand<T> {
+    protected responses: ConfigResponses;
+    protected pushSuccess(configInfo: ConfigInfo): void;
+    protected pushFailure(name: string, err: string | Error, value?: string): void;
+    protected output(title: string, verbose: boolean): void;
+}

package/lib/config.js

@@ -0,0 +1,72 @@
+"use strict";
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigCommand = exports.CONFIG_HELP_SECTION = void 0;
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const core_1 = require("@salesforce/core");
+const sf_plugins_core_2 = require("@salesforce/sf-plugins-core");
+exports.CONFIG_HELP_SECTION = (0, sf_plugins_core_2.toHelpSection)('CONFIGURATION VARIABLES', core_1.SfdxPropertyKeys.API_VERSION, core_1.SfdxPropertyKeys.DISABLE_TELEMETRY, core_1.SfdxPropertyKeys.INSTANCE_URL, core_1.SfdxPropertyKeys.MAX_QUERY_LIMIT, core_1.SfdxPropertyKeys.REST_DEPLOY, core_1.OrgConfigProperties.TARGET_ORG, core_1.OrgConfigProperties.TARGET_DEV_HUB);
+class ConfigCommand extends sf_plugins_core_1.SfCommand {
+    constructor() {
+        super(...arguments);
+        this.responses = [];
+    }
+    pushSuccess(configInfo) {
+        this.responses.push({
+            name: configInfo.key,
+            value: configInfo.value,
+            success: true,
+            location: configInfo.location,
+        });
+    }
+    pushFailure(name, err, value) {
+        const error = core_1.SfdxError.wrap(err);
+        this.responses.push({
+            name,
+            success: false,
+            value,
+            error,
+            message: error.message.replace(/\.\.$/, '.'),
+        });
+        process.exitCode = 1;
+    }
+    output(title, verbose) {
+        if (this.responses.length === 0) {
+            this.log('No results found');
+            return;
+        }
+        const columns = {
+            name: { header: 'Name' },
+        };
+        if (!title.includes('Unset')) {
+            columns.value = {
+                header: 'Value',
+                get: (row) => row.value ?? '',
+            };
+        }
+        if (!title.includes('List')) {
+            columns.success = { header: 'Success' };
+        }
+        if (verbose) {
+            columns.location = {
+                header: 'Location',
+                get: (row) => row.location ?? '',
+            };
+        }
+        if (this.responses.find((msg) => msg.error)) {
+            columns.message = {
+                header: 'Message',
+                get: (row) => row.message ?? '',
+            };
+            this.responses.map((msg) => (msg.message = msg.error?.message));
+        }
+        this.table(this.responses, columns, { title });
+    }
+}
+exports.ConfigCommand = ConfigCommand;
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iEAAwD;AAExD,2CAAgG;AAChG,iEAA4D;AAc/C,QAAA,mBAAmB,GAAG,IAAA,+BAAa,EAC9C,yBAAyB,EACzB,uBAAgB,CAAC,WAAW,EAC5B,uBAAgB,CAAC,iBAAiB,EAClC,uBAAgB,CAAC,YAAY,EAC7B,uBAAgB,CAAC,eAAe,EAChC,uBAAgB,CAAC,WAAW,EAC5B,0BAAmB,CAAC,UAAU,EAC9B,0BAAmB,CAAC,cAAc,CACnC,CAAC;AAEF,MAAsB,aAAiB,SAAQ,2BAAY;IAA3D;;QACY,cAAS,GAAoB,EAAE,CAAC;IA6D5C,CAAC;IA3DW,WAAW,CAAC,UAAsB;QAC1C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAClB,IAAI,EAAE,UAAU,CAAC,GAAG;YACpB,KAAK,EAAE,UAAU,CAAC,KAA2B;YAC7C,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC,CAAC;IACL,CAAC;IAES,WAAW,CAAC,IAAY,EAAE,GAAmB,EAAE,KAAc;QACrE,MAAM,KAAK,GAAG,gBAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAClB,IAAI;YACJ,OAAO,EAAE,KAAK;YACd,KAAK;YACL,KAAK;YACL,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SAC7C,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;IAES,MAAM,CAAC,KAAa,EAAE,OAAgB;QAC9C,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;YAC/B,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC7B,OAAO;SACR;QAED,MAAM,OAAO,GAAmC;YAC9C,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;SACzB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;YAC5B,OAAO,CAAC,KAAK,GAAG;gBACd,MAAM,EAAE,OAAO;gBACf,GAAG,EAAE,CAAC,GAAG,EAAU,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;aACtC,CAAC;SACH;QAED,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;YAC3B,OAAO,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;SACzC;QAED,IAAI,OAAO,EAAE;YACX,OAAO,CAAC,QAAQ,GAAG;gBACjB,MAAM,EAAE,UAAU;gBAClB,GAAG,EAAE,CAAC,GAAG,EAAU,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE;aACzC,CAAC;SACH;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YAC3C,OAAO,CAAC,OAAO,GAAG;gBAChB,MAAM,EAAE,SAAS;gBACjB,GAAG,EAAE,CAAC,GAAG,EAAU,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE;aACxC,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;SACjE;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AA9DD,sCA8DC"}

package/lib/hooks/init/load_config_meta.d.ts

@@ -0,0 +1,3 @@
+import type { Hook } from '@oclif/core';
+declare const hook: Hook<'init'>;
+export default hook;

package/lib/hooks/init/load_config_meta.js

@@ -0,0 +1,59 @@
+"use strict";
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const core_2 = require("@salesforce/core");
+const ts_types_1 = require("@salesforce/ts-types");
+const log = core_2.Logger.childFromRoot('plugin-settings:load_config_meta');
+const OCLIF_META_PJSON_KEY = 'configMeta';
+function loadConfigMeta(plugin) {
+    let configMetaRequireLocation;
+    try {
+        const configMetaPath = (0, ts_types_1.get)(plugin, `pjson.oclif.${OCLIF_META_PJSON_KEY}`, null);
+        if (typeof configMetaPath !== 'string') {
+            return;
+        }
+        const relativePath = (0, core_1.tsPath)(plugin.root, configMetaPath);
+        // use relative path if it exists, require string as is
+        configMetaRequireLocation = relativePath ?? configMetaPath;
+    }
+    catch {
+        return;
+    }
+    if (!configMetaRequireLocation) {
+        return;
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-var-requires
+        const configMetaPathModule = require(configMetaRequireLocation);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access
+        return configMetaPathModule?.default ?? configMetaPathModule;
+    }
+    catch {
+        log.error(`Error trying to load config meta from ${configMetaRequireLocation}`);
+        return;
+    }
+}
+const hook = ({ config }) => {
+    const flattenedConfigMetas = (config.plugins || [])
+        .map((plugin) => {
+        const configMeta = loadConfigMeta(plugin);
+        if (!configMeta) {
+            log.info(`No config meta found for ${plugin.name}`);
+        }
+        return configMeta;
+    })
+        .filter(ts_types_1.isObject)
+        .flat();
+    if (flattenedConfigMetas.length) {
+        core_2.Config.addAllowedProperties(flattenedConfigMetas);
+    }
+    return;
+};
+exports.default = hook;
+//# sourceMappingURL=load_config_meta.js.map

package/lib/hooks/init/load_config_meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_config_meta.js","sourceRoot":"","sources":["../../../src/hooks/init/load_config_meta.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAGH,sCAAqC;AACrC,2CAAsE;AACtE,mDAAqD;AAErD,MAAM,GAAG,GAAG,aAAM,CAAC,aAAa,CAAC,kCAAkC,CAAC,CAAC;AACrE,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAE1C,SAAS,cAAc,CAAC,MAAyB;IAC/C,IAAI,yBAA6C,CAAC;IAElD,IAAI;QACF,MAAM,cAAc,GAAG,IAAA,cAAG,EAAC,MAAM,EAAE,eAAe,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QAEhF,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE;YACtC,OAAO;SACR;QAED,MAAM,YAAY,GAAG,IAAA,aAAM,EAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAEzD,uDAAuD;QACvD,yBAAyB,GAAG,YAAY,IAAI,cAAc,CAAC;KAC5D;IAAC,MAAM;QACN,OAAO;KACR;IAED,IAAI,CAAC,yBAAyB,EAAE;QAC9B,OAAO;KACR;IAED,IAAI;QACF,uGAAuG;QACvG,MAAM,oBAAoB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAEhE,2GAA2G;QAC3G,OAAO,oBAAoB,EAAE,OAAO,IAAI,oBAAoB,CAAC;KAC9D;IAAC,MAAM;QACN,GAAG,CAAC,KAAK,CAAC,yCAAyC,yBAAyB,EAAE,CAAC,CAAC;QAChF,OAAO;KACR;AACH,CAAC;AAED,MAAM,IAAI,GAAiB,CAAC,EAAE,MAAM,EAAE,EAAiB,EAAE;IACvD,MAAM,oBAAoB,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;SAChD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE;YACf,GAAG,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;SACrD;QAED,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;SACD,MAAM,CAAC,mBAAQ,CAAC;SAChB,IAAI,EAAE,CAAC;IAEV,IAAI,oBAAoB,CAAC,MAAM,EAAE;QAC/B,aAAM,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;KACnD;IACD,OAAO;AACT,CAAC,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export = _default;

package/lib/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+module.exports = {};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,iBAAS,EAAE,CAAC"}

package/messages/get.md

@@ -0,0 +1,25 @@
+# summary
+
+Get the value of a configuration variable.
+
+# description
+
+Run "sf config list" to see all the configuration variables you've set. Global configuration variable are always displayed; local ones are displayed if you run the command in a project directory. Run "sf config set" to set a configuration variable.
+
+# examples
+
+- Get the value of the "target-org" configuration variable.
+
+  <%= config.bin %> <%= command.id %> target-org
+
+- Get multiple configuration variables and display whether they're set locally or globally:
+
+  <%= config.bin %> <%= command.id %> target-org api-version --verbose
+
+# flags.verbose.summary
+
+Display whether the configuration variables are set locally or globally.
+
+# error.NoConfigKeysFound
+
+You must provide one or more configuration variables to get. Run "sf config list" to see the configuration variables you've previously set.

package/messages/list.md

@@ -0,0 +1,13 @@
+# summary
+
+List the configuration variables that you've previously set.
+
+# description
+
+Global configuration variables apply to any directory and are always displayed. If you run this command from a project directory, local configuration variables are also displayed.
+
+# examples
+
+- List both global configuration variables and those local to your project:
+
+  $ <%= config.bin %> <%= command.id %>

package/messages/set.md

@@ -0,0 +1,47 @@
+# summary
+
+Set one or more configuration variables, such as your default org.
+
+# description
+
+Use configuration variables to set CLI defaults, such as your default org or the API version you want the CLI to use. For example, if you set the "target-org" configuration variable, you don't need to specify it as a "sf deploy metadata" flag if you're deploying to your default org.
+
+Local configuration variables apply only to your current project. Global variables, specified with the --global flag, apply in any directory.
+
+The resolution order if you've set a flag value in multiple ways is as follows:
+
+    1. Flag value specified at the command line.
+    2. Local (project-level) configuration variable.
+    3. Global configuration variable.
+
+Run "sf config list" to see the configuration variables you've already set and their level (local or global).
+
+# examples
+
+- Set the local target-org configuration variable to an org username:
+
+  <%= config.bin %> <%= command.id %> target-org=me@my.org
+
+- Set the local target-org configuration variable to an alias:
+
+  <%= config.bin %> <%= command.id %> target-org=my-scratch-org
+
+- Set the global target-org configuration variable:
+
+  <%= config.bin %> <%= command.id %> --global target-org=my-scratch-org
+
+# flags.global.summary
+
+Set the configuration variables globally, so they can be used from any directory.
+
+# error.InvalidArgumentFormat
+
+Set configuration variables with this format: key=value or key="value with spaces". Use the --help flag to view the available configuration variables.
+
+# error.DuplicateArgument
+
+Found duplicate argument %s. You can specify a configuration variable only one time in a single command execution. Remove the duplicate and try again.
+
+# error.ArgumentsRequired
+
+You must provide one or more configuration variables to set. Use the --help flag to view the available configuration variables.

package/messages/unset.md

@@ -0,0 +1,25 @@
+# summary
+
+Unset local or global configuration variables.
+
+# description
+
+Local configuration variables apply only to your current project. Global configuration variables apply in any directory.
+
+# examples
+
+- Unset the local "target-org" configuration variable:
+
+  <%= config.bin %> <%= command.id %> target-org
+
+- Unset multiple configuration variables globally:
+
+  <%= config.bin %> <%= command.id %> target-org api-version --global
+
+# flags.global.summary
+
+Unset the configuration variables globally, so they can no longer be used from any directory.
+
+# error.NoConfigKeysFound
+
+You must provide one or more configuration variables to unset. Run "sf config list" to see the configuration variables you've previously set.

package/oclif.manifest.json

@@ -0,0 +1 @@
+{"version":"1.0.0","commands":{"config:get":{"id":"config:get","summary":"Get the value of a configuration variable.","description":"Run \"sf config list\" to see all the configuration variables you've set. Global configuration variable are always displayed; local ones are displayed if you run the command in a project directory. Run \"sf config set\" to set a configuration variable.","strict":false,"pluginName":"@salesforce/plugin-settings","pluginAlias":"@salesforce/plugin-settings","pluginType":"core","aliases":[],"examples":["Get the value of the \"target-org\" configuration variable.\n<%= config.bin %> <%= command.id %> target-org","Get multiple configuration variables and display whether they're set locally or globally:\n<%= config.bin %> <%= command.id %> target-org api-version --verbose"],"flags":{"json":{"name":"json","type":"boolean","description":"Format output as json.","helpGroup":"GLOBAL","allowNo":false},"verbose":{"name":"verbose","type":"boolean","summary":"Display whether the configuration variables are set locally or globally.","allowNo":false}},"args":[],"configurationVariablesSection":{"header":"CONFIGURATION VARIABLES","body":[{"name":"apiVersion","description":"API version of your project. Default: API version of your Dev Hub org. (sfdx only)"},{"name":"disableTelemetry","description":"Disables the collection of usage and user environment information, etc. Default: false. (sfdx only)"},{"name":"instanceUrl","description":"URL of the Salesforce instance hosting your org. Default: https://login.salesforce.com. (sfdx only)"},{"name":"maxQueryLimit","description":"Maximum number of Salesforce records returned by a CLI command. Default: 10,000. (sfdx only)"},{"name":"restDeploy","description":"Whether deployments use the Metadata REST API (true) or SOAP API (false, default value). (sfdx only)"},{"name":"target-org","description":"Username or alias of the org that all commands run against by default. (sf only)"},{"name":"target-dev-hub","description":"Username or alias of your default Dev Hub org. (sf only)"}]}},"config:list":{"id":"config:list","summary":"List the configuration variables that you've previously set.","description":"Global configuration variables apply to any directory and are always displayed. If you run this command from a project directory, local configuration variables are also displayed.","strict":true,"pluginName":"@salesforce/plugin-settings","pluginAlias":"@salesforce/plugin-settings","pluginType":"core","aliases":[],"examples":["List both global configuration variables and those local to your project:\n$ <%= config.bin %> <%= command.id %>"],"flags":{"json":{"name":"json","type":"boolean","description":"Format output as json.","helpGroup":"GLOBAL","allowNo":false}},"args":[]},"config:set":{"id":"config:set","summary":"Set one or more configuration variables, such as your default org.","description":"Use configuration variables to set CLI defaults, such as your default org or the API version you want the CLI to use. For example, if you set the \"target-org\" configuration variable, you don't need to specify it as a \"sf deploy metadata\" flag if you're deploying to your default org.\n\nLocal configuration variables apply only to your current project. Global variables, specified with the --global flag, apply in any directory.\n\nThe resolution order if you've set a flag value in multiple ways is as follows:\n\n    1. Flag value specified at the command line.\n    2. Local (project-level) configuration variable.\n    3. Global configuration variable.\n\nRun \"sf config list\" to see the configuration variables you've already set and their level (local or global).","strict":false,"pluginName":"@salesforce/plugin-settings","pluginAlias":"@salesforce/plugin-settings","pluginType":"core","aliases":[],"examples":["Set the local target-org configuration variable to an org username:\n<%= config.bin %> <%= command.id %> target-org=me@my.org","Set the local target-org configuration variable to an alias:\n<%= config.bin %> <%= command.id %> target-org=my-scratch-org","Set the global target-org configuration variable:\n<%= config.bin %> <%= command.id %> --global target-org=my-scratch-org"],"flags":{"json":{"name":"json","type":"boolean","description":"Format output as json.","helpGroup":"GLOBAL","allowNo":false},"global":{"name":"global","type":"boolean","char":"g","summary":"Set the configuration variables globally, so they can be used from any directory.","allowNo":false}},"args":[],"configurationVariablesSection":{"header":"CONFIGURATION VARIABLES","body":[{"name":"apiVersion","description":"API version of your project. Default: API version of your Dev Hub org. (sfdx only)"},{"name":"disableTelemetry","description":"Disables the collection of usage and user environment information, etc. Default: false. (sfdx only)"},{"name":"instanceUrl","description":"URL of the Salesforce instance hosting your org. Default: https://login.salesforce.com. (sfdx only)"},{"name":"maxQueryLimit","description":"Maximum number of Salesforce records returned by a CLI command. Default: 10,000. (sfdx only)"},{"name":"restDeploy","description":"Whether deployments use the Metadata REST API (true) or SOAP API (false, default value). (sfdx only)"},{"name":"target-org","description":"Username or alias of the org that all commands run against by default. (sf only)"},{"name":"target-dev-hub","description":"Username or alias of your default Dev Hub org. (sf only)"}]}},"config:unset":{"id":"config:unset","summary":"Unset local or global configuration variables.","description":"Local configuration variables apply only to your current project. Global configuration variables apply in any directory.","strict":false,"pluginName":"@salesforce/plugin-settings","pluginAlias":"@salesforce/plugin-settings","pluginType":"core","aliases":[],"examples":["Unset the local \"target-org\" configuration variable:\n<%= config.bin %> <%= command.id %> target-org","Unset multiple configuration variables globally:\n<%= config.bin %> <%= command.id %> target-org api-version --global"],"flags":{"json":{"name":"json","type":"boolean","description":"Format output as json.","helpGroup":"GLOBAL","allowNo":false},"global":{"name":"global","type":"boolean","char":"g","summary":"Unset the configuration variables globally, so they can no longer be used from any directory.","allowNo":false}},"args":[],"configurationVariablesSection":{"header":"CONFIGURATION VARIABLES","body":[{"name":"apiVersion","description":"API version of your project. Default: API version of your Dev Hub org. (sfdx only)"},{"name":"disableTelemetry","description":"Disables the collection of usage and user environment information, etc. Default: false. (sfdx only)"},{"name":"instanceUrl","description":"URL of the Salesforce instance hosting your org. Default: https://login.salesforce.com. (sfdx only)"},{"name":"maxQueryLimit","description":"Maximum number of Salesforce records returned by a CLI command. Default: 10,000. (sfdx only)"},{"name":"restDeploy","description":"Whether deployments use the Metadata REST API (true) or SOAP API (false, default value). (sfdx only)"},{"name":"target-org","description":"Username or alias of the org that all commands run against by default. (sf only)"},{"name":"target-dev-hub","description":"Username or alias of your default Dev Hub org. (sf only)"}]}}}}

package/package.json

@@ -0,0 +1,129 @@
+{
+    "name": "@salesforce/plugin-settings",
+    "description": "configure the Salesforce CLI",
+    "version": "1.0.0",
+    "author": "Salesforce",
+    "bugs": "https://github.com/forcedotcom/cli/issues",
+    "dependencies": {
+        "@oclif/core": "^1.13.10",
+        "@salesforce/core": "^3.26.1",
+        "@salesforce/sf-plugins-core": "^1.13.2",
+        "tslib": "^2"
+    },
+    "devDependencies": {
+        "@oclif/plugin-command-snapshot": "^3.1.3",
+        "@oclif/test": "^2.1.1",
+        "@salesforce/cli-plugins-testkit": "^2.3.10",
+        "@salesforce/dev-config": "^3.1.0",
+        "@salesforce/dev-scripts": "^2.0.4",
+        "@salesforce/kit": "^1.5.45",
+        "@salesforce/plugin-command-reference": "^2.2.8",
+        "@salesforce/prettier-config": "^0.0.2",
+        "@salesforce/ts-sinon": "^1.3.21",
+        "@salesforce/ts-types": "^1.5.20",
+        "@types/fs-extra": "^9.0.13",
+        "@types/shelljs": "^0.8.11",
+        "@typescript-eslint/eslint-plugin": "^4.33.0",
+        "@typescript-eslint/parser": "^4.33.0",
+        "chai": "^4.3.6",
+        "eslint": "^7.32.0",
+        "eslint-config-prettier": "^8.5.0",
+        "eslint-config-salesforce": "^0.1.6",
+        "eslint-config-salesforce-license": "^0.1.6",
+        "eslint-config-salesforce-typescript": "^0.2.8",
+        "eslint-plugin-header": "^3.1.1",
+        "eslint-plugin-import": "2.25.2",
+        "eslint-plugin-jsdoc": "^35.5.1",
+        "eslint-plugin-prettier": "^3.4.1",
+        "eslint-plugin-sf-plugin": "^0.3.0",
+        "fs-extra": "^10.1.0",
+        "husky": "^7.0.4",
+        "lint-staged": "^11.2.6",
+        "mocha": "^9.2.2",
+        "nyc": "^15.1.0",
+        "oclif": "^2.7.0",
+        "prettier": "^2.7.1",
+        "pretty-quick": "^3.1.3",
+        "shelljs": "^0.8.5",
+        "shx": "0.3.3",
+        "sinon": "10.0.0",
+        "ts-node": "^10.9.1",
+        "typescript": "^4.7.4"
+    },
+    "config": {
+        "commitizen": {
+            "path": "cz-conventional-changelog"
+        }
+    },
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "files": [
+        "/lib",
+        "/messages",
+        "/oclif.manifest.json",
+        "/schemas"
+    ],
+    "homepage": "https://github.com/salesforcecli/plugin-settings",
+    "keywords": [
+        "force",
+        "salesforce",
+        "sfdx",
+        "salesforcedx",
+        "sfdx-plugin",
+        "sf-plugin",
+        "sf"
+    ],
+    "license": "BSD-3-Clause",
+    "main": "lib/index.js",
+    "oclif": {
+        "commands": "./lib/commands",
+        "bin": "sf",
+        "topicSeparator": " ",
+        "hooks": {
+            "init": [
+                "./lib/hooks/init/load_config_meta"
+            ]
+        },
+        "devPlugins": [
+            "@oclif/plugin-help",
+            "@oclif/plugin-command-snapshot",
+            "@salesforce/plugin-command-reference"
+        ],
+        "topics": {
+            "config": {
+                "description": "Commands to configure Salesforce CLI."
+            }
+        }
+    },
+    "repository": "salesforcecli/plugin-settings",
+    "scripts": {
+        "build": "sf-build",
+        "clean": "sf-clean",
+        "clean-all": "sf-clean all",
+        "clean:lib": "shx rm -rf lib && shx rm -rf coverage && shx rm -rf .nyc_output && shx rm -f oclif.manifest.json",
+        "compile": "sf-compile",
+        "docs": "sf-docs",
+        "format": "sf-format",
+        "lint": "sf-lint",
+        "postpack": "shx rm -f oclif.manifest.json",
+        "posttest": "yarn lint && yarn test:deprecation-policy && yarn test:json-schema && yarn test:command-reference",
+        "prepack": "sf-prepack",
+        "prepare": "sf-install",
+        "pretest": "sf-compile-test",
+        "reformat": "prettier --config .prettierrc --write './*.{js,json,md}' './**/*.{ts,json,md}'",
+        "test": "sf-test",
+        "test:command-reference": "./bin/dev commandreference:generate --erroronwarnings",
+        "test:deprecation-policy": "./bin/dev snapshot:compare",
+        "test:json-schema": "./bin/dev schema:compare",
+        "test:nuts": "nyc mocha \"**/*.nut.ts\" --slow 4500 --timeout 600000 --parallel",
+        "version": "oclif readme"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "sfdx": {
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-settings/1.0.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-settings/1.0.0.sig"
+    }
+}

package/schemas/config-get.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ConfigResponses",
+  "definitions": {
+    "ConfigResponses": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Msg"
+      }
+    },
+    "Msg": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "location": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "stack": {
+              "type": "string"
+            }
+          },
+          "required": ["name", "message"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["name", "success"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/config-list.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ConfigResponses",
+  "definitions": {
+    "ConfigResponses": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Msg"
+      }
+    },
+    "Msg": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "location": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "stack": {
+              "type": "string"
+            }
+          },
+          "required": ["name", "message"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["name", "success"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/config-set.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ConfigResponses",
+  "definitions": {
+    "ConfigResponses": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Msg"
+      }
+    },
+    "Msg": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "location": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "stack": {
+              "type": "string"
+            }
+          },
+          "required": ["name", "message"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["name", "success"],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/config-unset.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ConfigResponses",
+  "definitions": {
+    "ConfigResponses": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Msg"
+      }
+    },
+    "Msg": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "location": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "error": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "stack": {
+              "type": "string"
+            }
+          },
+          "required": ["name", "message"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["name", "success"],
+      "additionalProperties": false
+    }
+  }
+}