@oclif/core 3.26.6 → 4.0.0-beta.10

package/lib/interfaces/config.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { Command } from '../command';
 import { Hook, Hooks } from './hooks';
-import { PJSON } from './pjson';
+import { OclifConfiguration, PJSON, S3Templates } from './pjson';
 import { Options, Plugin } from './plugin';
 import { Theme } from './theme';
 import { Topic } from './topic';
@@ -34,8 +34,8 @@ export interface Config {
     /**
      * name of any bin aliases that will execute the cli
      */
-    readonly binAliases?: string[];
-    readonly binPath?: string;
+    readonly binAliases?: string[] | undefined;
+    readonly binPath?: string | undefined;
     /**
      * cache directory to use for CLI
      *
@@ -57,22 +57,10 @@ export interface Config {
      * example: ~/.local/share/mycli
      */
     readonly dataDir: string;
-    /**
-     * debugging level
-     *
-     * set by ${BIN}_DEBUG or DEBUG=$BIN
-     */
-    readonly debug: number;
     /**
      * base dirname to use in cacheDir/configDir/dataDir
      */
     readonly dirname: string;
-    /**
-     * points to a file that should be appended to for error logs
-     *
-     * example: ~/Library/Caches/mycli/error.log
-     */
-    readonly errlog: string;
     findCommand(id: string, opts: {
         must: true;
     }): Command.Loadable;
@@ -101,9 +89,9 @@ export interface Config {
     /**
      * npm registry to use for installing plugins
      */
-    readonly npmRegistry?: string;
-    readonly nsisCustomization?: string;
-    readonly pjson: PJSON.CLI;
+    readonly npmRegistry?: string | undefined;
+    readonly nsisCustomization?: string | undefined;
+    readonly pjson: PJSON;
     /**
      * process.platform
      */
@@ -113,7 +101,7 @@ export interface Config {
     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, captureErrors?: boolean): Promise<Hook.Result<Hooks[T]['return']>>;
     s3Key(type: 'unversioned' | 'versioned', ext: '.tar.gz' | '.tar.xz', options?: Config.s3Key.Options): string;
-    s3Key(type: keyof PJSON.S3.Templates, options?: Config.s3Key.Options): string;
+    s3Key(type: keyof S3Templates, options?: Config.s3Key.Options): string;
     s3Url(key: string): string;
     scopedEnvVar(key: string): string | undefined;
     scopedEnvVarKey(key: string): string;
@@ -123,9 +111,10 @@ export interface Config {
      * active shell
      */
     readonly shell: string;
-    readonly theme?: Theme;
+    readonly theme?: Theme | undefined;
     topicSeparator: ' ' | ':';
     readonly topics: Topic[];
+    readonly updateConfig: NonNullable<OclifConfiguration['update']>;
     /**
      * user agent to use for http calls
      *

package/lib/interfaces/errors.d.ts

@@ -3,25 +3,25 @@ export type CommandError = Error & {
 };
 export interface OclifError {
     oclif: {
-        exit?: number;
+        exit?: number | undefined;
     };
 }
 export interface PrettyPrintableError {
     /**
      * a unique error code for this error class
      */
-    code?: string;
+    code?: string | undefined;
     /**
      * message to display related to the error
      */
-    message?: string;
+    message?: string | undefined;
     /**
      * a url to find out more information related to this error
      * or fixing the error
      */
-    ref?: string;
+    ref?: string | undefined;
     /**
      * a suggestion that may be useful or provide additional context
      */
-    suggestions?: string[];
+    suggestions?: string[] | undefined;
 }

package/lib/interfaces/flags.d.ts

@@ -3,12 +3,12 @@ import { FlagInput } from './parser';
  * Infer the flags that are returned by Command.parse. This is useful for when you want to assign the flags as a class property.
  *
  * @example
- * export type StatusFlags = Interfaces.InferredFlags<typeof Status.flags & typeof Status.baseFlags>
+ * export type StatusFlags = Interfaces.InferredFlags<typeof Status.flags && typeof Status.baseFlags>
  *
  * export abstract class BaseCommand extends Command {
  *   static enableJsonFlag = true
  *
- *   static baseFlags = {
+ *   static flags = {
  *     config: Flags.string({
  *       description: 'specify config file',
  *     }),

package/lib/interfaces/index.d.ts

@@ -5,9 +5,10 @@ export type { CommandError, OclifError, PrettyPrintableError } from './errors';
 export type { InferredFlags } from './flags';
 export type { HelpOptions } from './help';
 export type { Hook, Hooks } from './hooks';
+export type { Logger } from './logger';
 export type { Manifest } from './manifest';
 export type { Arg, BooleanFlag, CustomOptions, Deprecation, Flag, FlagDefinition, OptionFlag } from './parser';
-export type { PJSON } from './pjson';
+export type { OclifConfiguration, PJSON, S3, S3Templates, UserPJSON } from './pjson';
 export type { Options, Plugin, PluginOptions } from './plugin';
 export type { S3Manifest } from './s3-manifest';
 export type { Theme } from './theme';

package/lib/interfaces/logger.d.ts

@@ -0,0 +1,9 @@
+export type Logger = {
+    debug: (formatter: unknown, ...args: unknown[]) => void;
+    error: (formatter: unknown, ...args: unknown[]) => void;
+    info: (formatter: unknown, ...args: unknown[]) => void;
+    trace: (formatter: unknown, ...args: unknown[]) => void;
+    warn: (formatter: unknown, ...args: unknown[]) => void;
+    child: (namespace: string) => Logger;
+    namespace: string;
+};

package/lib/interfaces/parser.d.ts

@@ -8,10 +8,10 @@ export type ArgOutput = {
 };
 export type CLIParseErrorOptions = {
     parse: {
-        input?: ParserInput;
-        output?: ParserOutput;
+        input?: ParserInput | undefined;
+        output?: ParserOutput | undefined;
     };
-    exit?: number;
+    exit?: number | undefined;
 };
 export type OutputArgs<T extends ParserInput['args']> = {
     [P in keyof T]: any;
@@ -431,7 +431,7 @@ export type Input<TFlags extends FlagOutput, BFlags extends FlagOutput, AFlags e
     baseFlags?: FlagInput<BFlags>;
     enableJsonFlag?: true | false;
     args?: ArgInput<AFlags>;
-    strict?: boolean;
+    strict?: boolean | undefined;
     context?: ParserContext;
     '--'?: boolean;
 };
@@ -441,10 +441,10 @@ export type ParserInput = {
     args: ArgInput<any>;
     strict: boolean;
     context: ParserContext | undefined;
-    '--'?: boolean;
+    '--'?: boolean | undefined;
 };
 export type ParserContext = Command & {
-    token?: FlagToken | ArgToken;
+    token?: FlagToken | ArgToken | undefined;
 };
 export type FlagInput<T extends FlagOutput = {
     [flag: string]: any;

package/lib/interfaces/pjson.d.ts

@@ -1,21 +1,5 @@
 import { HelpOptions } from './help';
-export interface PJSON {
-    [k: string]: any;
-    dependencies?: {
-        [name: string]: string;
-    };
-    devDependencies?: {
-        [name: string]: string;
-    };
-    oclif: {
-        bin?: string;
-        dirname?: string;
-        hooks?: Record<string, string | string[]>;
-        plugins?: string[];
-        schema?: number;
-    };
-    version: string;
-}
+import { Theme } from './theme';
 export type CommandDiscovery = {
     /**
      * The strategy to use for loading commands.
@@ -96,141 +80,223 @@ export type HookOptions = {
      */
     identifier: string;
 };
-export declare namespace PJSON {
-    interface Plugin extends PJSON {
-        name: string;
-        oclif: PJSON['oclif'] & {
-            additionalHelpFlags?: string[];
-            additionalVersionFlags?: string[];
-            aliases?: {
-                [name: string]: null | string;
-            };
-            commands?: string | CommandDiscovery;
-            /**
-             * Default command id when no command is found. This is used to support single command CLIs.
-             * Only supported value is "."
-             *
-             * @deprecated Use `commands.strategy: 'single'` instead.
-             */
-            default?: string;
+export type HelpLocationOptions = {
+    /**
+     * The file path containing help class.
+     */
+    target: string;
+    /**
+     * The name of the export to use when loading the help class from the `target` file. Defaults to `default`.
+     */
+    identifier: string;
+};
+export type S3Templates = {
+    baseDir?: string;
+    manifest?: string;
+    unversioned?: string;
+    versioned?: string;
+};
+export type S3 = {
+    acl?: string | undefined;
+    bucket?: string | undefined;
+    folder?: string | undefined;
+    gz?: boolean | undefined;
+    host?: string | undefined;
+    indexVersionLimit?: number | undefined;
+    templates?: {
+        target: S3Templates;
+        vanilla: S3Templates;
+    } | undefined;
+    xz?: boolean | undefined;
+};
+export type OclifConfiguration = {
+    /**
+     * Flags in addition to --help that should trigger help output.
+     */
+    additionalHelpFlags?: string[];
+    /**
+     * Flags in addition to --version that should trigger version output.
+     */
+    additionalVersionFlags?: string[];
+    /**
+     * Plugin aliases.
+     */
+    aliases?: {
+        [name: string]: null | string;
+    };
+    /**
+     * The name of the executable.
+     */
+    bin?: string;
+    /**
+     * Aliases for the executable.
+     */
+    binAliases?: string[];
+    commands?: string | CommandDiscovery;
+    /**
+     * Your CLI's description. Overrides the description in the package.json.
+     */
+    description?: string | undefined;
+    /**
+     * Plugins to load when in development mode.
+     */
+    devPlugins?: string[];
+    /**
+     * The directory name to use when determining the cache, config, and data directories.
+     */
+    dirname?: string;
+    /**
+     * Example plugin to use in @oclif/plugin-plugin's help output.
+     */
+    examplePlugin?: string;
+    /**
+     * Customize the exit codes for the CLI.
+     */
+    exitCodes?: {
+        default?: number;
+        failedFlagParsing?: number;
+        failedFlagValidation?: number;
+        invalidArgsSpec?: number;
+        nonExistentFlag?: number;
+        requiredArgs?: number;
+        unexpectedArgs?: number;
+    };
+    /**
+     * Enable flexible taxonomy for commands.
+     */
+    flexibleTaxonomy?: boolean;
+    /**
+     * The location of your custom help class.
+     */
+    helpClass?: string | HelpLocationOptions;
+    /**
+     * Options for the help output.
+     */
+    helpOptions?: HelpOptions;
+    /**
+     * Register hooks to run at various points in the CLI lifecycle.
+     */
+    hooks?: {
+        [name: string]: string | string[] | HookOptions | HookOptions[];
+    };
+    /**
+     * Plugins that can be installed just-in-time.
+     */
+    jitPlugins?: Record<string, string>;
+    macos?: {
+        identifier?: string;
+        sign?: string;
+    };
+    /**
+     * Use a private or alternate npm registry.
+     */
+    npmRegistry?: string;
+    /**
+     * Script to run during postinstall on windows.
+     */
+    nsisCustomization?: string;
+    /**
+     * Plugin prefix to use when working with plugins with @oclif/plugin-plugins.
+     *
+     * Defaults to `plugin-`.
+     */
+    pluginPrefix?: string;
+    /**
+     * Plugins to load.
+     */
+    plugins?: string[];
+    /**
+     * Template string used to build links to source code in CLI's README (when using `oclif readme`).
+     */
+    repositoryPrefix?: string;
+    schema?: number;
+    /**
+     * The namespace to be used for plugins of your CLI, e.g. `@salesforce`.
+     */
+    scope?: string;
+    /**
+     * State of your CLI
+     *
+     * - `beta` - will show message to user that command or CLI is in beta
+     * - `deprecated` - will show message to user that command or CLI is deprecated
+     */
+    state?: 'beta' | 'deprecated' | string;
+    /**
+     * The theme to ship with the CLI.
+     *
+     * Can be a path to a JSON file or a Theme object.
+     */
+    theme?: string | Theme;
+    /**
+     * Separator to use for your CLI. Can be `:` or ` `.
+     */
+    topicSeparator?: ' ' | ':';
+    /**
+     * Customize the topics in the CLI.
+     */
+    topics?: {
+        [k: string]: {
             description?: string;
-            devPlugins?: string[];
-            exitCodes?: {
-                default?: number;
-                failedFlagParsing?: number;
-                failedFlagValidation?: number;
-                invalidArgsSpec?: number;
-                nonExistentFlag?: number;
-                requiredArgs?: number;
-                unexpectedArgs?: number;
-            };
-            flexibleTaxonomy?: boolean;
-            helpClass?: string;
-            helpOptions?: HelpOptions;
-            hooks?: {
-                [name: string]: string | string[] | HookOptions | HookOptions[];
-            };
-            jitPlugins?: Record<string, string>;
-            macos?: {
-                identifier?: string;
-                sign?: string;
-            };
-            plugins?: string[];
-            repositoryPrefix?: string;
-            schema?: number;
-            state?: 'beta' | 'deprecated' | string;
-            theme?: string;
-            topicSeparator?: ' ' | ':';
-            topics?: {
-                [k: string]: {
-                    description?: string;
-                    hidden?: boolean;
-                    subtopics?: Plugin['oclif']['topics'];
-                };
-            };
-            update: {
-                autoupdate?: {
-                    debounce?: number;
-                    rollout?: number;
-                };
-                disableNpmLookup?: boolean;
-                node: {
-                    targets?: string[];
-                    version?: string;
-                    options?: string | string[];
-                };
-                s3: S3;
-            };
-            windows?: {
-                homepage?: string;
-                keypath?: string;
-                name?: string;
-            };
-        };
-        version: string;
-    }
-    interface S3 {
-        acl?: string;
-        bucket?: string;
-        folder?: string;
-        gz?: boolean;
-        host?: string;
-        templates: {
-            target: S3.Templates;
-            vanilla: S3.Templates;
+            hidden?: boolean;
+            subtopics?: OclifConfiguration['topics'];
         };
-        xz?: boolean;
-    }
-    namespace S3 {
-        interface Templates {
-            baseDir?: string;
-            manifest?: string;
-            unversioned?: string;
-            versioned?: string;
-        }
-    }
-    interface CLI extends Plugin {
-        oclif: Plugin['oclif'] & {
-            bin?: string;
-            binAliases?: string[];
-            dirname?: string;
-            flexibleTaxonomy?: boolean;
-            jitPlugins?: Record<string, string>;
-            npmRegistry?: string;
-            nsisCustomization?: string;
-            schema?: number;
-            scope?: string;
-            pluginPrefix?: string;
-            'warn-if-update-available'?: {
-                authorization: string;
-                message: string;
-                registry: string;
-                timeoutInDays: number;
-                frequency: number;
-                frequencyUnit: 'days' | 'hours' | 'minutes' | 'seconds' | 'milliseconds';
-            };
+    };
+    update?: {
+        autoupdate?: {
+            debounce?: number;
+            rollout?: number;
         };
-    }
-    interface User extends PJSON {
-        oclif: PJSON['oclif'] & {
-            plugins?: (PluginTypes.Link | PluginTypes.User | string)[];
+        disableNpmLookup?: boolean;
+        node?: {
+            targets?: string[];
+            version?: string;
+            options?: string | string[];
         };
-        private?: boolean;
-    }
-    type PluginTypes = {
-        root: string;
-    } | PluginTypes.Link | PluginTypes.User;
-    namespace PluginTypes {
-        interface User {
-            name: string;
-            tag?: string;
-            type: 'user';
-            url?: string;
-        }
-        interface Link {
-            name: string;
-            root: string;
-            type: 'link';
-        }
-    }
-}
+        s3?: S3;
+    };
+    'warn-if-update-available'?: {
+        authorization?: string;
+        message?: string;
+        registry?: string;
+        timeoutInDays?: number;
+        frequency?: number;
+        frequencyUnit?: 'days' | 'hours' | 'minutes' | 'seconds' | 'milliseconds';
+    };
+    windows?: {
+        homepage?: string;
+        keypath?: string;
+        name?: string;
+    };
+};
+export type UserPlugin = {
+    name: string;
+    tag?: string;
+    type: 'user';
+    url?: string;
+};
+export type LinkedPlugin = {
+    name: string;
+    root: string;
+    type: 'link';
+};
+export type PluginTypes = {
+    root: string;
+} | UserPlugin | LinkedPlugin;
+export type UserPJSON = {
+    oclif: {
+        plugins?: PluginTypes[];
+    };
+    private?: boolean;
+};
+export type PJSON = {
+    [k: string]: any;
+    dependencies?: {
+        [name: string]: string;
+    };
+    devDependencies?: {
+        [name: string]: string;
+    };
+    name: string;
+    oclif: OclifConfiguration;
+    version: string;
+};

package/lib/interfaces/plugin.d.ts

@@ -1,35 +1,37 @@
 import { Command } from '../command';
+import { Logger } from './logger';
 import { HookOptions, PJSON } from './pjson';
 import { Topic } from './topic';
 export interface PluginOptions {
-    children?: Plugin[];
-    errorOnManifestCreate?: boolean;
-    flexibleTaxonomy?: boolean;
-    ignoreManifest?: boolean;
-    isRoot?: boolean;
-    name?: string;
-    parent?: Plugin;
-    pjson?: PJSON.Plugin;
-    respectNoCacheDefault?: boolean;
+    children?: Plugin[] | undefined;
+    errorOnManifestCreate?: boolean | undefined;
+    flexibleTaxonomy?: boolean | undefined;
+    ignoreManifest?: boolean | undefined;
+    isRoot?: boolean | undefined;
+    name?: string | undefined;
+    parent?: Plugin | undefined;
+    pjson?: PJSON | undefined;
+    respectNoCacheDefault?: boolean | undefined;
     root: string;
-    tag?: string;
-    type?: string;
-    url?: string;
+    tag?: string | undefined;
+    type?: string | undefined;
+    url?: string | undefined;
 }
 export interface Options extends PluginOptions {
-    channel?: string;
-    devPlugins?: boolean;
-    enablePerf?: boolean;
-    jitPlugins?: boolean;
-    pjson?: PJSON.Plugin;
+    channel?: string | undefined;
+    devPlugins?: boolean | undefined;
+    enablePerf?: boolean | undefined;
+    jitPlugins?: boolean | undefined;
+    logger?: Logger | undefined;
+    pjson?: PJSON | undefined;
     pluginAdditions?: {
         core?: string[];
         dev?: string[];
         path?: string;
-    };
-    plugins?: Map<string, Plugin>;
-    userPlugins?: boolean;
-    version?: string;
+    } | undefined;
+    plugins?: Map<string, Plugin> | undefined;
+    userPlugins?: boolean | undefined;
+    version?: string | undefined;
 }
 export interface Plugin {
     /**
@@ -67,13 +69,13 @@ export interface Plugin {
      */
     name: string;
     readonly options: Options;
-    parent?: Plugin;
+    parent?: Plugin | undefined;
     /**
      * full package.json
      *
      * parsed with read-pkg
      */
-    pjson: PJSON.CLI | PJSON.Plugin;
+    pjson: PJSON;
     /**
      * base path of plugin
      */
@@ -82,7 +84,7 @@ export interface Plugin {
      * npm dist-tag of plugin
      * only used for user plugins
      */
-    tag?: string;
+    tag?: string | undefined;
     readonly topics: Topic[];
     /**
      * used to tell the user how the plugin was installed