@oclif/core 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.8.0](https://github.com/oclif/core/compare/v1.7.0...v1.8.0) (2022-05-06)
+
+
+### Features
+
+* improve Command interface ([#416](https://github.com/oclif/core/issues/416)) ([ed625e1](https://github.com/oclif/core/commit/ed625e1554a09e578e645ddd7aa2ddb1b368c03f))
+
 ## [1.7.0](https://github.com/oclif/core/compare/v1.6.4...v1.7.0) (2022-04-11)
 
 

package/lib/config/config.d.ts

@@ -43,16 +43,16 @@ export declare class Config implements IConfig {
     loadDevPlugins(): Promise<void>;
     loadUserPlugins(): Promise<void>;
     runHook<T extends keyof Hooks>(event: T, opts: Hooks[T]['options'], timeout?: number): Promise<Hook.Result<Hooks[T]['return']>>;
-    runCommand<T = unknown>(id: string, argv?: string[], cachedCommand?: Command.Plugin): Promise<T>;
+    runCommand<T = unknown>(id: string, argv?: string[], cachedCommand?: Command.Loadable): Promise<T>;
     scopedEnvVar(k: string): string | undefined;
     scopedEnvVarTrue(k: string): boolean;
     scopedEnvVarKey(k: string): string;
     findCommand(id: string, opts: {
         must: true;
-    }): Command.Plugin;
+    }): Command.Loadable;
     findCommand(id: string, opts?: {
         must: boolean;
-    }): Command.Plugin | undefined;
+    }): Command.Loadable | undefined;
     findTopic(id: string, opts: {
         must: true;
     }): Topic;
@@ -72,18 +72,18 @@ export declare class Config implements IConfig {
      * @param argv string[] process.argv containing the flags and arguments provided by the user
      * @returns string[]
      */
-    findMatches(partialCmdId: string, argv: string[]): Command.Plugin[];
+    findMatches(partialCmdId: string, argv: string[]): Command.Loadable[];
     /**
      * Returns an array of all commands. If flexible taxonomy is enabled then all permutations will be appended to the array.
-     * @returns Command.Plugin[]
+     * @returns Command.Loadable[]
      */
-    getAllCommands(): Command.Plugin[];
+    getAllCommands(): Command.Loadable[];
     /**
      * Returns an array of all command ids. If flexible taxonomy is enabled then all permutations will be appended to the array.
      * @returns string[]
      */
     getAllCommandIDs(): string[];
-    get commands(): Command.Plugin[];
+    get commands(): Command.Loadable[];
     get commandIDs(): string[];
     get topics(): Topic[];
     s3Key(type: keyof PJSON.S3.Templates, ext?: '.tar.gz' | '.tar.xz' | IConfig.s3Key.Options, options?: IConfig.s3Key.Options): string;
@@ -126,7 +126,7 @@ export declare class Config implements IConfig {
      * plugin as discovered (will not change the order)
      *
      * @param commands commands to determine the priority of
-     * @returns command instance {Command.Plugin} or undefined
+     * @returns command instance {Command.Loadable} or undefined
      */
     private determinePriority;
 }

package/lib/config/config.js

@@ -324,7 +324,7 @@ class Config {
     }
     /**
      * Returns an array of all commands. If flexible taxonomy is enabled then all permutations will be appended to the array.
-     * @returns Command.Plugin[]
+     * @returns Command.Loadable[]
      */
     getAllCommands() {
         const commands = [...this._commands.values()];
@@ -573,7 +573,7 @@ class Config {
      * plugin as discovered (will not change the order)
      *
      * @param commands commands to determine the priority of
-     * @returns command instance {Command.Plugin} or undefined
+     * @returns command instance {Command.Loadable} or undefined
      */
     determinePriority(commands) {
         var _a, _b;

package/lib/config/plugin.d.ts

@@ -14,7 +14,7 @@ export declare class Plugin implements IPlugin {
     alias: string;
     tag?: string;
     manifest: Manifest;
-    commands: Command.Plugin[];
+    commands: Command.Loadable[];
     hooks: {
         [k: string]: string[];
     };

package/lib/help/index.d.ts

@@ -20,7 +20,7 @@ export declare abstract class HelpBase extends HelpFormatter {
 export declare class Help extends HelpBase {
     protected CommandHelpClass: typeof CommandHelp;
     private get _topics();
-    protected get sortedCommands(): Interfaces.Command.Plugin[];
+    protected get sortedCommands(): Interfaces.Command.Loadable[];
     protected get sortedTopics(): Interfaces.Topic[];
     constructor(config: Interfaces.Config, opts?: Partial<Interfaces.HelpOptions>);
     showHelp(argv: string[]): Promise<void>;

package/lib/interfaces/command.d.ts

@@ -1,5 +1,6 @@
 import { Config, LoadOptions } from './config';
 import { ArgInput, BooleanFlagProps, FlagInput, OptionFlagProps } from './parser';
+import { Plugin as IPlugin } from './plugin';
 export declare type Example = string | {
     description: string;
     command: string;
@@ -78,7 +79,7 @@ export declare namespace Command {
         _base: string;
     }
     interface Class extends Base {
-        plugin?: Plugin;
+        plugin?: IPlugin;
         flags?: FlagInput<any>;
         args?: ArgInput;
         strict: boolean;
@@ -89,6 +90,12 @@ export declare namespace Command {
     interface Instance {
         _run(argv: string[]): Promise<any>;
     }
+    interface Loadable extends Command {
+        load(): Promise<Class>;
+    }
+    /**
+     * @deprecated use Command.Loadable instead.
+     */
     interface Plugin extends Command {
         load(): Promise<Class>;
     }

package/lib/interfaces/config.d.ts

@@ -88,27 +88,27 @@ export interface Config {
     valid: boolean;
     flexibleTaxonomy?: boolean;
     topicSeparator: ':' | ' ';
-    readonly commands: Command.Plugin[];
+    readonly commands: Command.Loadable[];
     readonly topics: Topic[];
     readonly commandIDs: string[];
     runCommand<T = unknown>(id: string, argv?: string[]): Promise<T>;
-    runCommand<T = unknown>(id: string, argv?: string[], cachedCommand?: Command.Plugin): Promise<T>;
+    runCommand<T = unknown>(id: string, argv?: string[], cachedCommand?: Command.Loadable): Promise<T>;
     runHook<T extends keyof Hooks>(event: T, opts: Hooks[T]['options'], timeout?: number): Promise<Hook.Result<Hooks[T]['return']>>;
     getAllCommandIDs(): string[];
-    getAllCommands(): Command.Plugin[];
+    getAllCommands(): Command.Loadable[];
     findCommand(id: string, opts: {
         must: true;
-    }): Command.Plugin;
+    }): Command.Loadable;
     findCommand(id: string, opts?: {
         must: boolean;
-    }): Command.Plugin | undefined;
+    }): Command.Loadable | undefined;
     findTopic(id: string, opts: {
         must: true;
     }): Topic;
     findTopic(id: string, opts?: {
         must: boolean;
     }): Topic | undefined;
-    findMatches(id: string, argv: string[]): Command.Plugin[];
+    findMatches(id: string, argv: string[]): Command.Loadable[];
     scopedEnvVar(key: string): string | undefined;
     scopedEnvVarKey(key: string): string;
     scopedEnvVarTrue(key: string): boolean;

package/lib/interfaces/hooks.d.ts

@@ -54,7 +54,7 @@ export interface Hooks {
         options: {
             id: string;
             argv: string[];
-            matches: Command.Plugin[];
+            matches: Command.Loadable[];
         };
         return: unknown;
     };

package/lib/interfaces/plugin.d.ts

@@ -60,7 +60,7 @@ export interface Plugin {
      * if it appears to be an npm package but does not look like it's really a CLI plugin, this is set to false
      */
     valid: boolean;
-    commands: Command.Plugin[];
+    commands: Command.Loadable[];
     hooks: {
         [k: string]: string[];
     };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/core",
   "description": "base library for oclif CLIs",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/core/issues",
   "dependencies": {
@@ -13,7 +13,7 @@
     "chalk": "^4.1.2",
     "clean-stack": "^3.0.1",
     "cli-progress": "^3.10.0",
-    "debug": "^4.3.3",
+    "debug": "^4.3.4",
     "ejs": "^3.1.6",
     "fs-extra": "^9.1.0",
     "get-package-type": "^0.1.0",
@@ -49,7 +49,7 @@
     "@types/fs-extra": "^9.0.13",
     "@types/indent-string": "^4.0.1",
     "@types/js-yaml": "^3.12.7",
-    "@types/lodash": "^4.14.178",
+    "@types/lodash": "^4.14.182",
     "@types/mocha": "^8.2.3",
     "@types/nock": "^11.1.0",
     "@types/node": "^15.14.9",