@kelceyp/caw-server 1.0.224 → 1.0.227

package/dist/cli.js

@@ -799,7 +799,7 @@ function generateParamsTable(params, colors) {
       }
     }
     const env2 = param.env || "";
-    const description = "";
+    const description = param.description || "";
     rows.push({
       name: param.name,
       flags,
@@ -7781,9 +7781,11 @@ function parseCommandPath(argv) {
 class Dispatcher {
   registry;
   strict;
+  version;
   constructor(app) {
     this.registry = new CommandRegistry;
     this.strict = app.strict ?? false;
+    this.version = app.version;
     for (const item of app.commands) {
       this.registry.register(item);
     }
@@ -7795,6 +7797,9 @@ class Dispatcher {
     if (argv[0] === "--help" || argv[0] === "-h") {
       return { type: "show_help" };
     }
+    if ((argv[0] === "--version" || argv[0] === "-v") && this.version) {
+      return { type: "show_version" };
+    }
     const { commandPath, paramArgv } = parseCommandPath(argv);
     if (commandPath.length === 0) {
       return { type: "show_help" };
@@ -8205,6 +8210,10 @@ class AppBuilder {
     const app = this.buildApp();
     const dispatcher = new Dispatcher(app);
     const result = dispatcher.dispatch(argv);
+    if (result.type === "show_version") {
+      console.log(app.version);
+      process.exit(0);
+    }
     if (result.type === "show_help") {
       const helpText = generateAppHelp(app);
       console.log(helpText);
@@ -8272,6 +8281,7 @@ class ParamBuilder {
   _prompt;
   _validate;
   _validationRules = [];
+  _description;
   name(name) {
     if (!name || typeof name !== "string") {
       throw new TypeError("Parameter name must be a non-empty string");
@@ -8360,6 +8370,13 @@ class ParamBuilder {
     }
     return this;
   }
+  description(text) {
+    if (!text || typeof text !== "string" || text.trim() === "") {
+      throw new TypeError("Description must be a non-empty string");
+    }
+    this._description = text;
+    return this;
+  }
   build() {
     if (!this._name) {
       throw new ConfigurationError("Parameter must have a name. Call .name(string) before .build()");
@@ -8385,7 +8402,8 @@ class ParamBuilder {
         stdin: this._stdin,
         prompt: this._prompt,
         validate: this._validate,
-        validationRules: this._validationRules.length > 0 ? this._validationRules : undefined
+        validationRules: this._validationRules.length > 0 ? this._validationRules : undefined,
+        description: this._description
       };
       return param;
     } else {
@@ -8401,7 +8419,8 @@ class ParamBuilder {
         stdin: this._stdin,
         prompt: this._prompt,
         validate: this._validate,
-        validationRules: this._validationRules.length > 0 ? this._validationRules : undefined
+        validationRules: this._validationRules.length > 0 ? this._validationRules : undefined,
+        description: this._description
       };
       return param;
     }