@salesforce/sf-plugins-core 1.14.0 → 1.15.0

package/README.md

@@ -13,7 +13,7 @@ The SfCommand abstract class extends [@oclif/core's Command class](https://githu
 - Enable the json flag support by default
 - Provides functions that help place success messages, warnings and errors into the correct location in JSON results
 - Enables additional help sections to the standard oclif command help output
-- Provides access to the [cli-ux cli actions](https://github.com/oclif/cli-ux#cliaction) via the public property `spinner` in SfCommand. This avoids having to import that interface from cli-ux.
+- Provides access to the [cli-ux cli actions](https://github.com/oclif/cli-ux#cliaction). This avoids having to import that interface from cli-ux and manually handling the `--json` flag.
 
 ## Sf Hooks
 

package/lib/deauthorizer.d.ts

@@ -1,7 +1,6 @@
 import { JsonMap } from '@salesforce/ts-types';
 /**
- * The Deauthorizer is an abstract class that is used to implement a concrete implementations
- * of deauthorizing an environment.
+ * The Deauthorizer is an abstract class that is used to implement a concrete implementation of deauthorizing an environment.
  */
 export declare abstract class Deauthorizer<T = JsonMap> {
     removeAll(): Promise<Deauthorizer.Result>;

package/lib/deauthorizer.js

@@ -8,8 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Deauthorizer = void 0;
 /**
- * The Deauthorizer is an abstract class that is used to implement a concrete implementations
- * of deauthorizing an environment.
+ * The Deauthorizer is an abstract class that is used to implement a concrete implementation of deauthorizing an environment.
  */
 class Deauthorizer {
     async removeAll() {
@@ -20,6 +19,8 @@ class Deauthorizer {
         const environments = await this.find();
         for (const id of Object.keys(environments)) {
             try {
+                // avoid configFile collision bug
+                // eslint-disable-next-line no-await-in-loop
                 await this.remove(id);
                 result.successes.push(id);
             }

package/lib/deployer.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
 import { AnyJson, JsonMap } from '@salesforce/ts-types';
-import { QuestionCollection } from 'inquirer';
+import { QuestionCollection, Answers } from 'inquirer';
 export declare type DeployerResult = {
     exitCode: number;
 };
@@ -33,7 +33,7 @@ export declare abstract class Deployer extends EventEmitter {
     /**
      * Prompt user for additional information
      */
-    prompt<T>(questions: QuestionCollection<T>, initialAnswers?: Partial<T>): Promise<T>;
+    prompt<T extends Answers>(questions: QuestionCollection<T>, initialAnswers?: Partial<T>): Promise<T>;
     /**
      * Overwrite the deployables property on the class.
      */
@@ -62,6 +62,9 @@ export declare namespace Deployer {
     };
     /**
      * This interface represents the aggregation of all deployer options, e.g.
+     *
+     * @example
+     * ```
      * {
      *   'Salesforce Apps': {
      *      testLevel: 'RunLocalTests',
@@ -69,6 +72,7 @@ export declare namespace Deployer {
      *    },
      *   'Salesforce Functions': { username: 'user@salesforce.com' },
      * }
+     * ```
      */
     type Options<T = AnyJson> = JsonMap & {
         [key: string]: T;

package/lib/deployer.js

@@ -5,6 +5,7 @@
  * 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
  */
+/* eslint-disable @typescript-eslint/explicit-member-accessibility */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Deployer = exports.Deployable = void 0;
 const events_1 = require("events");
@@ -30,11 +31,12 @@ class Deployer extends events_1.EventEmitter {
     /**
      * Method for displaying deploy progress to the user
      */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-empty-function
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-empty-function, class-methods-use-this
     progress(current, total, message) { }
     /**
      * Log messages to the console
      */
+    // eslint-disable-next-line class-methods-use-this
     log(msg, ...args) {
         core_1.CliUx.ux.log(msg, ...args);
     }

package/lib/exported.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { Flags as OclifFlags } from '@oclif/core';
-export { toHelpSection } from './util';
+export { toHelpSection, parseVarArgs } from './util';
 export { Deployable, Deployer, DeployerResult } from './deployer';
 export { Deauthorizer } from './deauthorizer';
 export { Progress, Prompter, generateTableChoices } from './ux';

package/lib/exported.js

@@ -20,10 +20,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Flags = exports.StandardColors = exports.SfCommand = exports.SfHook = exports.generateTableChoices = exports.Prompter = exports.Progress = exports.Deauthorizer = exports.Deployer = exports.Deployable = exports.toHelpSection = void 0;
+exports.Flags = exports.StandardColors = exports.SfCommand = exports.SfHook = exports.generateTableChoices = exports.Prompter = exports.Progress = exports.Deauthorizer = exports.Deployer = exports.Deployable = exports.parseVarArgs = exports.toHelpSection = void 0;
 const core_1 = require("@oclif/core");
 var util_1 = require("./util");
 Object.defineProperty(exports, "toHelpSection", { enumerable: true, get: function () { return util_1.toHelpSection; } });
+Object.defineProperty(exports, "parseVarArgs", { enumerable: true, get: function () { return util_1.parseVarArgs; } });
 var deployer_1 = require("./deployer");
 Object.defineProperty(exports, "Deployable", { enumerable: true, get: function () { return deployer_1.Deployable; } });
 Object.defineProperty(exports, "Deployer", { enumerable: true, get: function () { return deployer_1.Deployer; } });

package/lib/flags/duration.d.ts

@@ -12,9 +12,11 @@ export declare type DurationFlagConfig = {
  * Defaults to undefined if you don't specify a default
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
- *    'wait': duration({
+ *    wait: Flags.duration({
  *       min: 1,
  *       unit: 'minutes'
  *       defaultValue: 33,
@@ -22,6 +24,7 @@ export declare type DurationFlagConfig = {
  *       description: 'Wait time in minutes'
  *    }),
  * }
+ * ```
  */
 export declare const durationFlag: import("@oclif/core/lib/interfaces").Definition<Duration, DurationFlagConfig>;
 export {};

package/lib/flags/duration.js

@@ -18,9 +18,11 @@ const messages = core_2.Messages.loadMessages('@salesforce/sf-plugins-core', 'me
  * Defaults to undefined if you don't specify a default
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
- *    'wait': duration({
+ *    wait: Flags.duration({
  *       min: 1,
  *       unit: 'minutes'
  *       defaultValue: 33,
@@ -28,12 +30,11 @@ const messages = core_2.Messages.loadMessages('@salesforce/sf-plugins-core', 'me
  *       description: 'Wait time in minutes'
  *    }),
  * }
+ * ```
  */
 exports.durationFlag = core_1.Flags.custom({
     parse: async (input, _, opts) => validate(input, opts),
-    default: async (context) => {
-        return context.options.defaultValue ? toDuration(context.options.defaultValue, context.options.unit) : undefined;
-    },
+    default: async (context) => context.options.defaultValue ? toDuration(context.options.defaultValue, context.options.unit) : undefined,
 });
 const validate = (input, config) => {
     const { min, max, unit } = config || {};
@@ -55,7 +56,5 @@ const validate = (input, config) => {
     }
     return toDuration(parsedInput, unit);
 };
-const toDuration = (parsedInput, unit) => {
-    return kit_1.Duration[unit](parsedInput);
-};
+const toDuration = (parsedInput, unit) => kit_1.Duration[unit](parsedInput);
 //# sourceMappingURL=duration.js.map

package/lib/flags/orgApiVersion.d.ts

@@ -8,6 +8,18 @@ export declare const maxDeprecatedUrl = "https://help.salesforce.com/s/articleVi
  *
  * CAVEAT: unlike the apiversion flag on sfdxCommand, this does not set the version on the org/connection
  * We leave this up to the plugins to implement
+ *
+ * @example
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
+ * public static flags = {
+ *    'api-version': Flags.orgApiVersion({
+ *       char: 'a',
+ *       description: 'api version for the org'
+ *    }),
+ * }
+ * ```
  */
 export declare const orgApiVersionFlag: import("@oclif/core/lib/interfaces").Definition<string, Record<string, unknown>>;
 //# sourceMappingURL=orgApiVersion.d.ts.map

package/lib/flags/orgApiVersion.js

@@ -23,18 +23,29 @@ exports.maxDeprecatedUrl = 'https://help.salesforce.com/s/articleView?id=0003544
  *
  * CAVEAT: unlike the apiversion flag on sfdxCommand, this does not set the version on the org/connection
  * We leave this up to the plugins to implement
+ *
+ * @example
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
+ * public static flags = {
+ *    'api-version': Flags.orgApiVersion({
+ *       char: 'a',
+ *       description: 'api version for the org'
+ *    }),
+ * }
+ * ```
  */
 exports.orgApiVersionFlag = core_1.Flags.custom({
     parse: async (input) => validate(input),
-    default: async () => await getDefaultFromConfig(),
+    default: async () => getDefaultFromConfig(),
     description: messages.getMessage('flags.apiVersion.description'),
 });
 const getDefaultFromConfig = async () => {
-    var _a;
     // (perf) only import ConfigAggregator if necessary
     const { ConfigAggregator } = await Promise.resolve().then(() => require('@salesforce/core'));
     const config = await ConfigAggregator.create();
-    const apiVersionFromConfig = (_a = config.getInfo(core_2.OrgConfigProperties.ORG_API_VERSION)) === null || _a === void 0 ? void 0 : _a.value;
+    const apiVersionFromConfig = config.getInfo(core_2.OrgConfigProperties.ORG_API_VERSION)?.value;
     if (apiVersionFromConfig) {
         await core_2.Lifecycle.getInstance().emitWarning(messages.getMessage('flags.apiVersion.overrideWarning', [apiVersionFromConfig]));
         return validate(apiVersionFromConfig);

package/lib/flags/orgFlags.d.ts

@@ -5,7 +5,9 @@ import { Org } from '@salesforce/core';
  * Will not throw if the specified org and default do not exist
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // setting length or prefix
  *    'target-org': Flags.optionalOrg(),
@@ -15,6 +17,7 @@ import { Org } from '@salesforce/core';
  *        description: 'flag2 description',
  *     }),
  * }
+ * ```
  */
 export declare const optionalOrgFlag: import("@oclif/core/lib/interfaces").Definition<Org | undefined, Record<string, unknown>>;
 /**
@@ -24,7 +27,9 @@ export declare const optionalOrgFlag: import("@oclif/core/lib/interfaces").Defin
  * Will throw if no default org exists and none is specified
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // setting length or prefix
  *    'target-org': Flags.requiredOrg(),
@@ -35,6 +40,7 @@ export declare const optionalOrgFlag: import("@oclif/core/lib/interfaces").Defin
  *        char: 'o'
  *     }),
  * }
+ * ```
  */
 export declare const requiredOrgFlag: import("@oclif/core/lib/interfaces").Definition<Org, Record<string, unknown>>;
 /**
@@ -44,7 +50,9 @@ export declare const requiredOrgFlag: import("@oclif/core/lib/interfaces").Defin
  * Will throw if no default deb hub exists and none is specified
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // setting length or prefix
  *    'target-org': requiredHub(),
@@ -55,6 +63,7 @@ export declare const requiredOrgFlag: import("@oclif/core/lib/interfaces").Defin
  *        char: 'h'
  *     }),
  * }
+ * ```
  */
 export declare const requiredHubFlag: import("@oclif/core/lib/interfaces").Definition<Org, Record<string, unknown>>;
 //# sourceMappingURL=orgFlags.d.ts.map

package/lib/flags/orgFlags.js

@@ -32,11 +32,10 @@ const getOrgOrThrow = async (input) => {
     return org;
 };
 const getHubOrThrow = async (aliasOrUsername) => {
-    var _a;
     if (!aliasOrUsername) {
         // check config for a default
         const config = await core_2.ConfigAggregator.create();
-        aliasOrUsername = (_a = config.getInfo(core_2.OrgConfigProperties.TARGET_DEV_HUB)) === null || _a === void 0 ? void 0 : _a.value;
+        aliasOrUsername = config.getInfo(core_2.OrgConfigProperties.TARGET_DEV_HUB)?.value;
         if (!aliasOrUsername) {
             throw messages.createError('errors.NoDefaultDevHub');
         }
@@ -53,7 +52,9 @@ const getHubOrThrow = async (aliasOrUsername) => {
  * Will not throw if the specified org and default do not exist
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // setting length or prefix
  *    'target-org': Flags.optionalOrg(),
@@ -63,12 +64,13 @@ const getHubOrThrow = async (aliasOrUsername) => {
  *        description: 'flag2 description',
  *     }),
  * }
+ * ```
  */
 exports.optionalOrgFlag = core_1.Flags.custom({
     char: 'e',
-    parse: async (input) => await maybeGetOrg(input),
-    default: async () => await maybeGetOrg(),
-    defaultHelp: async () => { var _a; return (_a = (await maybeGetOrg())) === null || _a === void 0 ? void 0 : _a.getUsername(); },
+    parse: async (input) => maybeGetOrg(input),
+    default: async () => maybeGetOrg(),
+    defaultHelp: async () => (await maybeGetOrg())?.getUsername(),
 });
 /**
  * A required org, specified by username or alias
@@ -77,7 +79,9 @@ exports.optionalOrgFlag = core_1.Flags.custom({
  * Will throw if no default org exists and none is specified
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // setting length or prefix
  *    'target-org': Flags.requiredOrg(),
@@ -88,12 +92,13 @@ exports.optionalOrgFlag = core_1.Flags.custom({
  *        char: 'o'
  *     }),
  * }
+ * ```
  */
 exports.requiredOrgFlag = core_1.Flags.custom({
     char: 'e',
-    parse: async (input) => await getOrgOrThrow(input),
-    default: async () => await getOrgOrThrow(),
-    defaultHelp: async () => { var _a; return (_a = (await getOrgOrThrow())) === null || _a === void 0 ? void 0 : _a.getUsername(); },
+    parse: async (input) => getOrgOrThrow(input),
+    default: async () => getOrgOrThrow(),
+    defaultHelp: async () => (await getOrgOrThrow())?.getUsername(),
 });
 /**
  * A required org that is a devHub
@@ -102,7 +107,9 @@ exports.requiredOrgFlag = core_1.Flags.custom({
  * Will throw if no default deb hub exists and none is specified
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // setting length or prefix
  *    'target-org': requiredHub(),
@@ -113,11 +120,12 @@ exports.requiredOrgFlag = core_1.Flags.custom({
  *        char: 'h'
  *     }),
  * }
+ * ```
  */
 exports.requiredHubFlag = core_1.Flags.custom({
     char: 'v',
-    parse: async (input) => await getHubOrThrow(input),
-    default: async () => await getHubOrThrow(),
-    defaultHelp: async () => { var _a; return (_a = (await getHubOrThrow())) === null || _a === void 0 ? void 0 : _a.getUsername(); },
+    parse: async (input) => getHubOrThrow(input),
+    default: async () => getHubOrThrow(),
+    defaultHelp: async () => (await getHubOrThrow())?.getUsername(),
 });
 //# sourceMappingURL=orgFlags.js.map

package/lib/flags/salesforceId.d.ts

@@ -12,7 +12,9 @@ export declare type IdFlagConfig = {
  * Id flag with built-in validation.  Short character is `i`
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // set length or prefix
  *    'flag-name': salesforceId({ length: 15, startsWith: '00D' }),
@@ -26,6 +28,7 @@ export declare type IdFlagConfig = {
  *        char: 'j',
  *     }),
  * }
+ * ```
  */
 export declare const salesforceIdFlag: import("@oclif/core/lib/interfaces").Definition<string, IdFlagConfig>;
 //# sourceMappingURL=salesforceId.d.ts.map

package/lib/flags/salesforceId.js

@@ -15,7 +15,9 @@ const messages = core_2.Messages.loadMessages('@salesforce/sf-plugins-core', 'me
  * Id flag with built-in validation.  Short character is `i`
  *
  * @example
- * import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+ *
+ * ```
+ * import { Flags } from '@salesforce/sf-plugins-core';
  * public static flags = {
  *     // set length or prefix
  *    'flag-name': salesforceId({ length: 15, startsWith: '00D' }),
@@ -29,13 +31,14 @@ const messages = core_2.Messages.loadMessages('@salesforce/sf-plugins-core', 'me
  *        char: 'j',
  *     }),
  * }
+ * ```
  */
 exports.salesforceIdFlag = core_1.Flags.custom({
     parse: async (input, _ctx, opts) => validate(input, opts),
     char: 'i',
 });
 const validate = (input, config) => {
-    const { length, startsWith } = config || {};
+    const { length, startsWith } = config ?? {};
     if (length && input.length !== length) {
         throw messages.createError('errors.InvalidIdLength', [length]);
     }

package/lib/hooks.d.ts

@@ -15,9 +15,12 @@ interface SfHooks<T = unknown> extends Hooks {
 }
 declare type GenericHook<T extends keyof SfHooks, P> = Hook<T, SfHooks<P>>;
 /**
- * Class that provides a static method to run a well known hook.
+ * Class that provides a static method to run a pre-defined sf hook. See {@link SfHooks}.
  */
 export declare class SfHook {
+    /**
+     * Executes a well known Unified CLI hook. See {@link SfHooks}.
+     */
     static run<T extends keyof SfHooks>(config: Config, hookName: T, options?: SfHooks[T]['options']): Promise<Hook.Result<SfHooks[T]['return']>>;
 }
 export declare namespace SfHook {

package/lib/hooks.js

@@ -10,11 +10,14 @@ exports.SfHook = void 0;
 const kit_1 = require("@salesforce/kit");
 const core_1 = require("@oclif/core");
 /**
- * Class that provides a static method to run a well known hook.
+ * Class that provides a static method to run a pre-defined sf hook. See {@link SfHooks}.
  */
 class SfHook {
+    /**
+     * Executes a well known Unified CLI hook. See {@link SfHooks}.
+     */
     static async run(config, hookName, options = {}) {
-        const timeout = kit_1.Duration.milliseconds(kit_1.env.getNumber('SF_HOOK_TIMEOUT_MS') || 5000);
+        const timeout = kit_1.Duration.milliseconds(kit_1.env.getNumber('SF_HOOK_TIMEOUT_MS') ?? 5000);
         const results = await config.runHook(hookName, options, timeout.milliseconds);
         results.failures.forEach((failure) => {
             core_1.CliUx.ux.debug(`Failed to run ${hookName} hook for ${failure.plugin.name}`);

package/lib/sfCommand.d.ts

@@ -15,49 +15,148 @@ export declare const StandardColors: {
     success: chalk.Chalk;
 };
 /**
- * A base command that provides convenient access to CLI help
- * output formatting. Extend this command and set specific properties
- * to add help sections to the command's help output.
+ * A base command that provided common functionality for all sf commands.
+ * Functionality includes:
+ *  - JSON support
+ *  - progress bars
+ *  - spinners
+ *  - prompts
+ *  - stylized output (JSON, url, objects, headers)
+ *  - lifecycle events
+ *  - configuration variables help section
+ *  - environment variables help section
+ *  - error codes help section
  *
- * @extends @oclif/core/command
- * @see https://github.com/oclif/core/blob/main/src/command.ts
+ * All implementations of this class need to implement the run() method.
+ *
+ * Additionally, all implementations of this class need to provide a generic type that describes the JSON output.
+ *
+ * See {@link https://github.com/salesforcecli/plugin-template-sf/blob/main/src/commands/hello/world.ts example implementation}.
+ *
+ * @example
+ *
+ * ```
+ * import { SfCommand } from '@salesforce/sf-plugins-core';
+ * export type MyJsonOutput = { success: boolean };
+ * export default class MyCommand extends SfCommand<MyJsonOutput> {
+ *   public async run(): Promise<MyJsonOutput> {
+ *    return { success: true };
+ *  }
+ * }
+ * ```
  */
 export declare abstract class SfCommand<T> extends Command {
     static SF_ENV: string;
     static enableJsonFlag: boolean;
+    /**
+     * Add a CONFIGURATION VARIABLES section to the help output.
+     *
+     * @example
+     * ```
+     * import { SfCommand, toHelpSection } from '@salesforce/sf-plugins-core';
+     * import { OrgConfigProperties } from '@salesforce/core';
+     * export default class MyCommand extends SfCommand {
+     *   public static configurationVariablesSection = toHelpSection(
+     *     'CONFIGURATION VARIABLES',
+     *     OrgConfigProperties.TARGET_ORG,
+     *     OrgConfigProperties.ORG_API_VERSION,
+     *   );
+     * }
+     * ```
+     */
     static configurationVariablesSection?: HelpSection;
+    /**
+     * Add an Environment VARIABLES section to the help output.
+     *
+     * @example
+     * ```
+     * import { SfCommand, toHelpSection } from '@salesforce/sf-plugins-core';
+     * import { EnvironmentVariable } from '@salesforce/core';
+     * export default class MyCommand extends SfCommand {
+     *   public static envVariablesSection = toHelpSection(
+     *     'ENVIRONMENT VARIABLES',
+     *     EnvironmentVariable.SF_TARGET_ORG,
+     *     EnvironmentVariable.SF_USE_PROGRESS_BAR,
+     *   );
+     * }
+     * ```
+     */
     static envVariablesSection?: HelpSection;
+    /**
+     * Add an ERROR CODES section to the help output.
+     *
+     * @example
+     * ```
+     * import { SfCommand, toHelpSection } from '@salesforce/sf-plugins-core';
+     * export default class MyCommand extends SfCommand {
+     *   public static errorCodes = toHelpSection(
+     *     'ERROR CODES',
+     *     { 0: 'Success', 1: 'Failure' },
+     *   );
+     * }
+     * ```
+     */
     static errorCodes?: HelpSection;
+    /**
+     * Flags that you can use for manipulating tables.
+     *
+     * @example
+     * ```
+     * import { SfCommand } from '@salesforce/sf-plugins-core';
+     * export default class MyCommand extends SfCommand {
+     *   public static flags = {
+     *    ...SfCommand.tableFags,
+     *    'my-flags: flags.string({ char: 'm', description: 'my flag' }),
+     *   }
+     * }
+     * ```
+     */
     static tableFlags: typeof CliUx.Table.table.flags;
+    /**
+     * Set to true if the command must be executed inside a Salesforce project directory.
+     *
+     * If set to true the command will throw an error if the command is executed outside of a Salesforce project directory.
+     * Additionally, this.project will be set to the current Salesforce project (SfProject).
+     *
+     */
     static requiresProject: boolean;
+    /**
+     * Add a spinner to the console. {@link Spinner}
+     */
     spinner: Spinner;
+    /**
+     * Add a progress bar to the console. {@link Progress}
+     */
     progress: Progress;
     project: SfProject;
     private warnings;
     private ux;
     private prompter;
     private lifecycle;
-    protected get statics(): typeof SfCommand;
     constructor(argv: string[], config: Config);
+    protected get statics(): typeof SfCommand;
     /**
-     * Log a success message that has the standard success message color applied
+     * Log a success message that has the standard success message color applied.
      *
-     * @param message
-     * @param args
+     * @param message The message to log.
      */
     logSuccess(message: string): void;
     /**
-     * Log warning to users. If --json is enabled, then the warning
-     * will be added to the json output under the warnings property.
+     * Log warning to users. If --json is enabled, then the warning will be added to the json output under the warnings property.
+     *
+     * @param input {@link SfCommand.Warning} The message to log.
      */
     warn(input: SfCommand.Warning): SfCommand.Warning;
     /**
      * Log info message to users.
+     *
+     * @param input {@link SfCommand.Info} The message to log.
      */
     info(input: SfCommand.Info): void;
     /**
-     * Warn user about sensitive information (access tokens, etc...) before
-     * logging to the console.
+     * Warn user about sensitive information (access tokens, etc...) before logging to the console.
+     *
+     * @param msg The message to log.
      */
     logSensitive(msg?: string): void;
     /**
@@ -66,18 +165,27 @@ export declare abstract class SfCommand<T> extends Command {
     table<R extends Ux.Table.Data>(data: R[], columns: Ux.Table.Columns<R>, options?: Ux.Table.Options): void;
     /**
      * Log a stylized url to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param text The text to display for the url.
+     * @param uri The url to display.
      */
     url(text: string, uri: string, params?: {}): void;
     /**
      * Log stylized JSON to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param obj The JSON to log.
      */
     styledJSON(obj: AnyJson): void;
     /**
      * Log stylized object to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param obj The object to log.
      */
     styledObject(obj: AnyJson): void;
     /**
      * Log stylized header to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param text the text to display as a header.
      */
     styledHeader(text: string): void;
     /**
@@ -93,9 +201,9 @@ export declare abstract class SfCommand<T> extends Command {
      *   await this.prompt();
      * }
      */
-    prompt<R = Prompter.Answers>(questions: Prompter.Questions<R>, initialAnswers?: Partial<R>): Promise<R>;
+    prompt<R extends Prompter.Answers>(questions: Prompter.Questions<R>, initialAnswers?: Partial<R>): Promise<R>;
     /**
-     * Simplified prompt for single-question confirmation.  Times out and throws after 10s
+     * Simplified prompt for single-question confirmation. Times out and throws after 10s
      *
      * @param message text to display.  Do not include a question mark.
      * @param ms milliseconds to wait for user input.  Defaults to 10s.
@@ -105,7 +213,7 @@ export declare abstract class SfCommand<T> extends Command {
     /**
      * Prompt user for information with a timeout (in milliseconds). See https://www.npmjs.com/package/inquirer for more.
      */
-    timedPrompt<R = Prompter.Answers>(questions: Prompter.Questions<R>, ms?: number, initialAnswers?: Partial<R>): Promise<R>;
+    timedPrompt<R extends Prompter.Answers>(questions: Prompter.Questions<R>, ms?: number, initialAnswers?: Partial<R>): Promise<R>;
     _run<R>(): Promise<R | undefined>;
     /**
      * Wrap the command result into the standardized JSON structure.

package/lib/sfCommand.js

@@ -21,12 +21,35 @@ exports.StandardColors = {
     success: chalk.bold.green,
 };
 /**
- * A base command that provides convenient access to CLI help
- * output formatting. Extend this command and set specific properties
- * to add help sections to the command's help output.
+ * A base command that provided common functionality for all sf commands.
+ * Functionality includes:
+ *  - JSON support
+ *  - progress bars
+ *  - spinners
+ *  - prompts
+ *  - stylized output (JSON, url, objects, headers)
+ *  - lifecycle events
+ *  - configuration variables help section
+ *  - environment variables help section
+ *  - error codes help section
  *
- * @extends @oclif/core/command
- * @see https://github.com/oclif/core/blob/main/src/command.ts
+ * All implementations of this class need to implement the run() method.
+ *
+ * Additionally, all implementations of this class need to provide a generic type that describes the JSON output.
+ *
+ * See {@link https://github.com/salesforcecli/plugin-template-sf/blob/main/src/commands/hello/world.ts example implementation}.
+ *
+ * @example
+ *
+ * ```
+ * import { SfCommand } from '@salesforce/sf-plugins-core';
+ * export type MyJsonOutput = { success: boolean };
+ * export default class MyCommand extends SfCommand<MyJsonOutput> {
+ *   public async run(): Promise<MyJsonOutput> {
+ *    return { success: true };
+ *  }
+ * }
+ * ```
  */
 class SfCommand extends core_1.Command {
     constructor(argv, config) {
@@ -43,40 +66,43 @@ class SfCommand extends core_1.Command {
         return this.constructor;
     }
     /**
-     * Log a success message that has the standard success message color applied
+     * Log a success message that has the standard success message color applied.
      *
-     * @param message
-     * @param args
+     * @param message The message to log.
      */
     logSuccess(message) {
         this.log(exports.StandardColors.success(message));
     }
     /**
-     * Log warning to users. If --json is enabled, then the warning
-     * will be added to the json output under the warnings property.
+     * Log warning to users. If --json is enabled, then the warning will be added to the json output under the warnings property.
+     *
+     * @param input {@link SfCommand.Warning} The message to log.
      */
     warn(input) {
         const colorizedArgs = [];
         this.warnings.push(input);
         const message = typeof input === 'string' ? input : input.message;
         colorizedArgs.push(`${exports.StandardColors.warning(messages.getMessage('warning.prefix'))} ${message}`);
-        colorizedArgs.push(...this.formatActions(typeof input === 'string' ? [] : input.actions || [], { actionColor: exports.StandardColors.info }));
+        colorizedArgs.push(...this.formatActions(typeof input === 'string' ? [] : input.actions ?? [], { actionColor: exports.StandardColors.info }));
         this.log(colorizedArgs.join(os.EOL));
         return input;
     }
     /**
      * Log info message to users.
+     *
+     * @param input {@link SfCommand.Info} The message to log.
      */
     info(input) {
         const colorizedArgs = [];
         const message = typeof input === 'string' ? input : input.message;
         colorizedArgs.push(`${exports.StandardColors.info(message)}`);
-        colorizedArgs.push(...this.formatActions(typeof input === 'string' ? [] : input.actions || [], { actionColor: exports.StandardColors.info }));
+        colorizedArgs.push(...this.formatActions(typeof input === 'string' ? [] : input.actions ?? [], { actionColor: exports.StandardColors.info }));
         this.log(colorizedArgs.join(os.EOL));
     }
     /**
-     * Warn user about sensitive information (access tokens, etc...) before
-     * logging to the console.
+     * Warn user about sensitive information (access tokens, etc...) before logging to the console.
+     *
+     * @param msg The message to log.
      */
     logSensitive(msg) {
         this.warn(messages.getMessage('warning.security'));
@@ -90,24 +116,33 @@ class SfCommand extends core_1.Command {
     }
     /**
      * Log a stylized url to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param text The text to display for the url.
+     * @param uri The url to display.
      */
     url(text, uri, params = {}) {
         this.ux.url(text, uri, params);
     }
     /**
      * Log stylized JSON to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param obj The JSON to log.
      */
     styledJSON(obj) {
         this.ux.styledJSON(obj);
     }
     /**
      * Log stylized object to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param obj The object to log.
      */
     styledObject(obj) {
         this.ux.styledObject(obj);
     }
     /**
      * Log stylized header to the console. Will automatically be suppressed when --json flag is present.
+     *
+     * @param text the text to display as a header.
      */
     styledHeader(text) {
         this.ux.styledHeader(text);
@@ -129,7 +164,7 @@ class SfCommand extends core_1.Command {
         return this.prompter.prompt(questions, initialAnswers);
     }
     /**
-     * Simplified prompt for single-question confirmation.  Times out and throws after 10s
+     * Simplified prompt for single-question confirmation. Times out and throws after 10s
      *
      * @param message text to display.  Do not include a question mark.
      * @param ms milliseconds to wait for user input.  Defaults to 10s.
@@ -167,9 +202,8 @@ class SfCommand extends core_1.Command {
      * Wrap the command result into the standardized JSON structure.
      */
     toSuccessJson(result) {
-        var _a;
         return {
-            status: (_a = process.exitCode) !== null && _a !== void 0 ? _a : 0,
+            status: process.exitCode ?? 0,
             result,
             warnings: this.warnings,
         };
@@ -183,6 +217,7 @@ class SfCommand extends core_1.Command {
             warnings: this.warnings,
         };
     }
+    // eslint-disable-next-line class-methods-use-this
     async assignProject() {
         try {
             return await core_2.SfProject.resolve();
@@ -195,10 +230,9 @@ class SfCommand extends core_1.Command {
         }
     }
     async catch(error) {
-        var _a, _b;
         // transform an unknown error into one that conforms to the interface
         const codeFromError = error instanceof core_2.SfError ? error.exitCode : 1;
-        (_a = process.exitCode) !== null && _a !== void 0 ? _a : (process.exitCode = codeFromError);
+        process.exitCode ?? (process.exitCode = codeFromError);
         const sfErrorProperties = error instanceof core_2.SfError
             ? { data: error.data, actions: error.actions, code: codeFromError, context: error.context }
             : {};
@@ -206,7 +240,7 @@ class SfCommand extends core_1.Command {
             ...sfErrorProperties,
             ...{
                 message: error.message,
-                name: (_b = error.name) !== null && _b !== void 0 ? _b : 'Error',
+                name: error.name ?? 'Error',
                 status: process.exitCode,
                 stack: error.stack,
                 exitCode: process.exitCode,
@@ -234,7 +268,7 @@ class SfCommand extends core_1.Command {
         const errorCode = error.code ? ` (${error.code})` : '';
         const errorPrefix = `${exports.StandardColors.error(messages.getMessage('error.prefix', [errorCode]))}`;
         colorizedArgs.push(`${errorPrefix} ${error.message}`);
-        colorizedArgs.push(...this.formatActions(error.actions || []));
+        colorizedArgs.push(...this.formatActions(error.actions ?? []));
         if (error.stack && core_2.envVars.getString(SfCommand.SF_ENV) === core_2.Mode.DEVELOPMENT) {
             colorizedArgs.push(exports.StandardColors.info(`\n*** Internal Diagnostic ***\n\n${error.stack}\n******\n`));
         }
@@ -247,10 +281,11 @@ class SfCommand extends core_1.Command {
      * @param options
      * @private
      */
+    // eslint-disable-next-line class-methods-use-this
     formatActions(actions, options = { actionColor: exports.StandardColors.info }) {
         const colorizedArgs = [];
         // Format any actions.
-        if (actions === null || actions === void 0 ? void 0 : actions.length) {
+        if (actions?.length) {
             colorizedArgs.push(`\n${exports.StandardColors.info(messages.getMessage('actions.tryThis'))}\n`);
             actions.forEach((action) => {
                 colorizedArgs.push(`${options.actionColor(action)}`);
@@ -262,5 +297,19 @@ class SfCommand extends core_1.Command {
 exports.SfCommand = SfCommand;
 SfCommand.SF_ENV = 'SF_ENV';
 SfCommand.enableJsonFlag = true;
+/**
+ * Flags that you can use for manipulating tables.
+ *
+ * @example
+ * ```
+ * import { SfCommand } from '@salesforce/sf-plugins-core';
+ * export default class MyCommand extends SfCommand {
+ *   public static flags = {
+ *    ...SfCommand.tableFags,
+ *    'my-flags: flags.string({ char: 'm', description: 'my flag' }),
+ *   }
+ * }
+ * ```
+ */
 SfCommand.tableFlags = core_1.CliUx.ux.table.flags;
 //# sourceMappingURL=sfCommand.js.map

package/lib/types/index.d.ts

@@ -9,13 +9,18 @@ export declare type JsonObject = {
  * you can specify how a key should be displayed to the user.
  *
  * @example
+ *
+ * ```
  * { data: { theURL: 'https://example.com' } }
  * // Renders as:
  * Key     Value
  * ------- -------------------
  * The URL https://example.com
+ * ```
  *
  * @example
+ *
+ * ```
  * {
  *   data: { theURL: 'https://example.com' }
  *   keys: { theURL: 'Url' },
@@ -24,11 +29,13 @@ export declare type JsonObject = {
  * Key Value
  * --- -------------------
  * Url https://example.com
- *
+ *```
  * If no environment matches the provided targetEnv, then return null in the data field.
  *
  * @example
+ * ```
  * { data: null }
+ * ```
  */
 export declare namespace EnvDisplay {
     type Keys<T> = Record<keyof T, string>;
@@ -50,6 +57,8 @@ export declare namespace EnvDisplay {
  * the `keys` property.
  *
  * @example
+ *
+ * ```
  * {
  *   title: 'My Envs',
  *   data: [{ username: 'foo', theURL: 'https://example.com' }]
@@ -59,8 +68,11 @@ export declare namespace EnvDisplay {
  * ================================
  * | Username | The URL
  * | foo      | https://example.com
+ *```
  *
  * @example
+ *
+ * ```
  * {
  *   data: [{ username: 'foo', theURL: 'https://example.com' }]
  *   keys: { theURL: 'Url', username: 'Name' },
@@ -71,6 +83,8 @@ export declare namespace EnvDisplay {
  * ============================
  * | Name | Url
  * | foo  | https://example.com
+ *
+ *```
  */
 export declare namespace EnvList {
     export enum EnvType {

package/lib/types/index.js

@@ -14,6 +14,8 @@ exports.EnvList = void 0;
  * the `keys` property.
  *
  * @example
+ *
+ * ```
  * {
  *   title: 'My Envs',
  *   data: [{ username: 'foo', theURL: 'https://example.com' }]
@@ -23,8 +25,11 @@ exports.EnvList = void 0;
  * ================================
  * | Username | The URL
  * | foo      | https://example.com
+ *```
  *
  * @example
+ *
+ * ```
  * {
  *   data: [{ username: 'foo', theURL: 'https://example.com' }]
  *   keys: { theURL: 'Url', username: 'Name' },
@@ -35,6 +40,8 @@ exports.EnvList = void 0;
  * ============================
  * | Name | Url
  * | foo  | https://example.com
+ *
+ *```
  */
 var EnvList;
 (function (EnvList) {

package/lib/util.d.ts

@@ -16,4 +16,5 @@ export declare type HelpSection = {
  * @param vars
  */
 export declare function toHelpSection(header: string, ...vars: Array<OrgConfigProperties | SfdxPropertyKeys | EnvironmentVariable | string | Record<string, string>>): HelpSection;
+export declare function parseVarArgs(args: Record<string, unknown>, argv: string[]): Record<string, unknown>;
 //# sourceMappingURL=util.d.ts.map

package/lib/util.js

@@ -6,8 +6,10 @@
  * 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.toHelpSection = void 0;
+exports.parseVarArgs = exports.toHelpSection = void 0;
 const core_1 = require("@salesforce/core");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@salesforce/sf-plugins-core', 'messages');
 /**
  * Function to build a help section for command help.
  * Takes a string to be used as section header text and an array of enums
@@ -21,9 +23,7 @@ function toHelpSection(header, ...vars) {
     const body = vars
         .flatMap((v) => {
         if (typeof v === 'string') {
-            const orgConfig = core_1.ORG_CONFIG_ALLOWED_PROPERTIES.find(({ key }) => {
-                return key === v;
-            });
+            const orgConfig = core_1.ORG_CONFIG_ALLOWED_PROPERTIES.find(({ key }) => key === v);
             if (orgConfig) {
                 return { name: orgConfig.key, description: orgConfig.description };
             }
@@ -46,4 +46,28 @@ function toHelpSection(header, ...vars) {
     return { header, body };
 }
 exports.toHelpSection = toHelpSection;
+function parseVarArgs(args, argv) {
+    const final = {};
+    const argVals = Object.values(args);
+    // Remove arguments from varargs
+    const varargs = argv.filter((val) => !argVals.includes(val));
+    // Support `config set key value`
+    if (varargs.length === 2 && !varargs[0].includes('=')) {
+        return { [varargs[0]]: varargs[1] };
+    }
+    // Ensure that all args are in the right format (e.g. key=value key1=value1)
+    varargs.forEach((arg) => {
+        const split = arg.split('=');
+        if (split.length !== 2) {
+            throw messages.createError('error.InvalidArgumentFormat', [arg]);
+        }
+        const [name, value] = split;
+        if (final[name]) {
+            throw messages.createError('error.DuplicateArgument', [name]);
+        }
+        final[name] = value || undefined;
+    });
+    return final;
+}
+exports.parseVarArgs = parseVarArgs;
 //# sourceMappingURL=util.js.map

package/lib/ux/prompter.d.ts

@@ -4,24 +4,27 @@ export declare class Prompter {
     /**
      * Prompt user for information. See https://www.npmjs.com/package/inquirer for more.
      */
-    prompt<T = Prompter.Answers>(questions: Prompter.Questions<T>, initialAnswers?: Partial<T>): Promise<T>;
+    prompt<T extends Prompter.Answers>(questions: Prompter.Questions<T>, initialAnswers?: Partial<T>): Promise<T>;
     /**
      * Prompt user for information with a timeout (in milliseconds). See https://www.npmjs.com/package/inquirer for more.
      */
-    timedPrompt<T = Prompter.Answers>(questions: Prompter.Questions<T>, ms?: number, initialAnswers?: Partial<T>): Promise<T>;
+    timedPrompt<T extends Prompter.Answers>(questions: Prompter.Questions<T>, ms?: number, initialAnswers?: Partial<T>): Promise<T>;
 }
 export declare namespace Prompter {
     type Answers<T = Record<string, unknown>> = T & Record<string, unknown>;
-    type Questions<T> = QuestionCollection<T>;
+    type Questions<T extends Answers> = QuestionCollection<T>;
 }
 /**
  * Generate a formatted table for list and checkbox prompts
  *
  * Each option should contain the same keys as specified in columns.
- * For example,
+ *
+ * @example
+ * ```
  * const columns = { name: 'Name', type: 'Type', path: 'Path' };
  * const options = [{ name: 'foo', type: 'org', path: '/path/to/foo/' }];
  * generateTableChoices(columns, options);
+ * ```
  */
 export declare function generateTableChoices<T>(columns: Dictionary<string>, choices: Array<Dictionary<Nullable<string> | T>>, padForCheckbox?: boolean): ChoiceBase[];
 //# sourceMappingURL=prompter.d.ts.map

package/lib/ux/prompter.js

@@ -14,6 +14,7 @@ class Prompter {
     /**
      * Prompt user for information. See https://www.npmjs.com/package/inquirer for more.
      */
+    // eslint-disable-next-line class-methods-use-this
     async prompt(questions, initialAnswers) {
         const answers = await (0, inquirer_1.prompt)(questions, initialAnswers);
         return answers;
@@ -21,6 +22,7 @@ class Prompter {
     /**
      * Prompt user for information with a timeout (in milliseconds). See https://www.npmjs.com/package/inquirer for more.
      */
+    // eslint-disable-next-line class-methods-use-this
     async timedPrompt(questions, ms = 10000, initialAnswers) {
         let id;
         const thePrompt = (0, inquirer_1.prompt)(questions, initialAnswers);
@@ -45,10 +47,13 @@ exports.Prompter = Prompter;
  * Generate a formatted table for list and checkbox prompts
  *
  * Each option should contain the same keys as specified in columns.
- * For example,
+ *
+ * @example
+ * ```
  * const columns = { name: 'Name', type: 'Type', path: 'Path' };
  * const options = [{ name: 'foo', type: 'org', path: '/path/to/foo/' }];
  * generateTableChoices(columns, options);
+ * ```
  */
 function generateTableChoices(columns, choices, 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -58,7 +63,7 @@ padForCheckbox = true) {
         .length)) + 1);
     const choicesOptions = [
         new inquirer_1.Separator(`${padForCheckbox ? ' '.repeat(2) : ''}${columnEntries
-            .map(([, value], index) => value === null || value === void 0 ? void 0 : value.padEnd(columnLengths[index], ' '))
+            .map(([, value], index) => value?.padEnd(columnLengths[index], ' '))
             .join('')}`),
     ];
     for (const meta of choices) {

package/lib/ux/spinner.d.ts

@@ -5,6 +5,14 @@ import { UxBase } from '.';
  */
 export declare class Spinner extends UxBase {
     constructor(outputEnabled: boolean);
+    /**
+     * Get the status of the current spinner.
+     */
+    get status(): string | undefined;
+    /**
+     * Set the status of the current spinner.
+     */
+    set status(status: string | undefined);
     /**
      * Start a spinner on the console.
      */
@@ -15,14 +23,6 @@ export declare class Spinner extends UxBase {
      * Stop the spinner on the console.
      */
     stop(msg?: string): void;
-    /**
-     * Set the status of the current spinner.
-     */
-    set status(status: string | undefined);
-    /**
-     * Get the status of the current spinner.
-     */
-    get status(): string | undefined;
     /**
      * Pause the spinner on the console.
      */

package/lib/ux/spinner.js

@@ -18,28 +18,30 @@ class Spinner extends _1.UxBase {
         super(outputEnabled);
     }
     /**
-     * Start a spinner on the console.
-     */
-    start(action, status, opts) {
-        this.maybeNoop(() => core_1.CliUx.ux.action.start(action, status, opts));
-    }
-    /**
-     * Stop the spinner on the console.
+     * Get the status of the current spinner.
      */
-    stop(msg) {
-        this.maybeNoop(() => core_1.CliUx.ux.action.stop(msg));
+    // eslint-disable-next-line class-methods-use-this
+    get status() {
+        return core_1.CliUx.ux.action.status;
     }
     /**
      * Set the status of the current spinner.
      */
+    // eslint-disable-next-line class-methods-use-this
     set status(status) {
         core_1.CliUx.ux.action.status = status;
     }
     /**
-     * Get the status of the current spinner.
+     * Start a spinner on the console.
      */
-    get status() {
-        return core_1.CliUx.ux.action.status;
+    start(action, status, opts) {
+        this.maybeNoop(() => core_1.CliUx.ux.action.start(action, status, opts));
+    }
+    /**
+     * Stop the spinner on the console.
+     */
+    stop(msg) {
+        this.maybeNoop(() => core_1.CliUx.ux.action.stop(msg));
     }
     /**
      * Pause the spinner on the console.

package/messages/messages.md

@@ -73,3 +73,11 @@ Try this:
 # warning.CommandInBeta
 
 This command is currently in beta. Any aspect of this command can change without advanced notice. Don't use beta commands in your scripts.
+
+# error.InvalidArgumentFormat
+
+Set varargs with this format: key=value or key="value with spaces".
+
+# error.DuplicateArgument
+
+Found duplicate argument %s.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sf-plugins-core",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Utils for writing deploy and retrieve plugins",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",
@@ -32,44 +32,43 @@
     "/messages"
   ],
   "dependencies": {
-    "@oclif/core": "^1.15.0",
-    "@salesforce/core": "^3.25.0",
+    "@oclif/core": "^1.16.4",
+    "@salesforce/core": "^3.30.9",
     "@salesforce/kit": "^1.5.44",
     "@salesforce/ts-types": "^1.5.20",
     "chalk": "^4",
-    "inquirer": "^8.2.0"
+    "inquirer": "^8.2.3"
   },
   "devDependencies": {
     "@oclif/test": "^2.1.0",
-    "@salesforce/dev-config": "^2.1.3",
-    "@salesforce/dev-scripts": "^1.0.4",
+    "@salesforce/dev-config": "^3.0.0",
+    "@salesforce/dev-scripts": "^3.1.0",
     "@salesforce/prettier-config": "^0.0.2",
     "@salesforce/ts-sinon": "^1.3.21",
-    "@types/inquirer": "^8.2.0",
-    "@typescript-eslint/eslint-plugin": "^4.33.0",
-    "@typescript-eslint/parser": "^4.33.0",
+    "@types/inquirer": "^8.2.3",
+    "@typescript-eslint/eslint-plugin": "^5.33.0",
+    "@typescript-eslint/parser": "^5.33.0",
     "chai": "^4.3.6",
-    "eslint": "^7.32.0",
-    "eslint-config-prettier": "^6.15.0",
-    "eslint-config-salesforce": "^0.1.6",
+    "eslint": "^8.21.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-config-salesforce": "^1.1.0",
     "eslint-config-salesforce-license": "^0.1.6",
-    "eslint-config-salesforce-typescript": "^0.2.8",
+    "eslint-config-salesforce-typescript": "^1.1.1",
     "eslint-plugin-header": "^3.1.1",
-    "eslint-plugin-import": "^2.25.4",
-    "eslint-plugin-jsdoc": "^35.1.2",
-    "eslint-plugin-prettier": "^3.4.1",
+    "eslint-plugin-import": "^2.26.0",
+    "eslint-plugin-jsdoc": "^39.3.6",
     "husky": "^7.0.4",
-    "mocha": "^8.4.0",
+    "mocha": "^9.1.3",
     "nyc": "^15.1.0",
-    "prettier": "^2.5.1",
+    "prettier": "^2.7.1",
     "pretty-quick": "^3.1.3",
     "shelljs": "0.8.5",
     "sinon": "10.0.1",
     "strip-ansi": "6.0.1",
     "ts-node": "^10.7.0",
-    "typescript": "^4.5.5"
+    "typescript": "^4.8.4"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}