@dephub/command@1.0.1

Author: estarlincito

README.md

@@ -60,7 +60,7 @@ const cmd = new Command()
   });
 
 try {
-  await clit.run(); // (defaults tokens `process.argv.slice(2)`)
+  await cmd.run(); // (defaults tokens `process.argv.slice(2)`)
 } catch (err) {
   if (err instanceof CommandError) {
     console.error(`\nError: ${err.message}\n`);
@@ -86,7 +86,7 @@ const cmd = new Command()
   });
 
 try {
-  await clit.run(); // (defaults tokens `process.argv.slice(2)`)
+  await cmd.run(); // (defaults tokens `process.argv.slice(2)`)
 } catch (err) {
   if (err instanceof CommandError) {
     console.error(`\nError: ${err.message}\n`);

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dephub/command",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A type-safe CLI command builder for Node.js, enabling easy creation of commands with arguments, options, subcommands, and handlers.",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",

src/cli.ts

@@ -1,11 +1,21 @@
 #!/usr/bin/env node
+/* eslint-disable no-console */
 import { description, name, version } from '@/helpers/pkg.js';
 
-import { Command } from './index.js';
+import { Command, CommandError } from './index.js';
 
 const cmd = new Command()
   .name(name.split('/')[1] ?? 'command')
   .description(description)
   .version(version);
 
-await cmd.run();
+try {
+  await cmd.run();
+} catch (err) {
+  if (err instanceof CommandError) {
+    console.error(`\nError: ${err.message}\n`);
+    cmd.help();
+    process.exit(1);
+  }
+  throw err;
+}

src/core/command.ts

@@ -76,7 +76,7 @@ export class Command<
 
   /**
    * Parses the provided tokens (or default CLI arguments) into a typed CommandInput.
-   * @param tokens - Optional array of tokens to parse; defaults to process/Deno args.
+   * @param tokens - Optional array of tokens to parse; defaults to process.argv.slice(2).
    * @returns The parsed CommandInput with typed args, options, and unparsed tokens.
    */
   parse(tokens?: string[]): CommandInput<Options, Arguments> {
@@ -90,26 +90,10 @@ export class Command<
    * Runs the command with the provided tokens (or default CLI arguments).
    * Parses input, handles flags like --help/--version, executes handlers, and processes subcommands.
    * Automatically adds --help/-h and --version/-v options unless hidden.
-   * @param tokens - Optional array of tokens to run with; defaults to process/Deno args.
+   * @param tokens - Optional array of tokens to run with; defaults to process.argv.slice(2).
    * @returns A Promise that resolves when the command execution completes.
    */
   async run(tokens?: string[]): Promise<void> {
-    // Auto-add --help / --version unless hidden
-    if (!this[$config]().hidden.help) {
-      this.option('--help', {
-        description: `Show help`,
-        kind: 'flag',
-        shortFlag: '-h',
-      });
-    }
-
-    if (!this[$config]().hidden.version) {
-      this.option('--version', {
-        description: `Show version`,
-        kind: 'flag',
-        shortFlag: '-v',
-      });
-    }
     await runner(this[$config](), tokens);
   }
 

src/helpers/help.ts

@@ -148,4 +148,3 @@ export const showHelp = <
   printSubcommands();
   console.log('');
 };
-// deno --allow-all test.ts url -h

src/helpers/runner.ts

@@ -27,6 +27,34 @@ export const runner = async <
   config: CommandConfig<Options, Arguments>,
   tokens?: string[],
 ) => {
+  // Auto-add --help unless hidden
+  if (
+    !config.hidden.help &&
+    !config.options.some((o) => o.longFlag === '--help')
+  ) {
+    config.options.push({
+      description: 'Show help',
+      kind: 'flag',
+      longFlag: '--help',
+      optional: true,
+      shortFlag: '-h',
+    });
+  }
+
+  // Auto-add --version unless hidden
+  if (
+    !config.hidden.version &&
+    !config.options.some((o) => o.longFlag === '--version')
+  ) {
+    config.options.push({
+      description: 'Show version',
+      kind: 'flag',
+      longFlag: '--version',
+      optional: true,
+      shortFlag: '-v',
+    });
+  }
+
   const parsed = parseRuntime(config, tokens);
   const { handlers, hidden, name, subcommands, version } = config;