@jvittechs/jai1-cli 0.1.61 → 0.1.62

package/dist/cli.js

@@ -33,7 +33,7 @@ var NetworkError = class extends Jai1Error {
 // package.json
 var package_default = {
   name: "@jvittechs/jai1-cli",
-  version: "0.1.61",
+  version: "0.1.62",
   description: "Unified CLI for Jai1 Framework Management and Redmine Context Sync",
   type: "module",
   bin: {
@@ -5067,7 +5067,14 @@ async function handlePasswordGeneration(options) {
   }
 }
 function createPasswordCommand() {
-  const cmd = new Command14("password").description("Generate secure random password").option("-l, --length <number>", "Password length", "16").option("--no-lowercase", "Exclude lowercase letters").option("--no-uppercase", "Exclude uppercase letters").option("--no-digits", "Exclude digits").option("--no-symbols", "Exclude symbols").option("--symbol-chars <chars>", "Custom symbol characters").option("-c, --count <number>", "Number of passwords to generate", "1").action(async (options) => {
+  const cmd = new Command14("password").description("Generate secure random password").option("-l, --length <number>", "Password length", "16").option("--no-lowercase", "Exclude lowercase letters").option("--no-uppercase", "Exclude uppercase letters").option("--no-digits", "Exclude digits").option("--no-symbols", "Exclude symbols").option("--symbol-chars <chars>", "Custom symbol characters").option("-c, --count <number>", "Number of passwords to generate", "1").addHelpText("after", `
+Examples:
+  $ jai1 utils password
+  $ jai1 utils password --length 24
+  $ jai1 utils password --no-symbols
+  $ jai1 utils password --count 5
+  $ jai1 utils password -l 32 --no-digits
+`).action(async (options) => {
     await handlePasswordGeneration({
       ...options,
       length: parseInt(options.length, 10),
@@ -5106,7 +5113,14 @@ async function handleUuidGeneration(options) {
   }
 }
 function createUuidCommand() {
-  const cmd = new Command15("uuid").description("Generate UUID v4 identifier").option("-c, --count <number>", "Number of UUIDs to generate", "1").option("--uppercase", "Output in uppercase").option("--no-hyphens", "Remove hyphens from output").action(async (options) => {
+  const cmd = new Command15("uuid").description("Generate UUID v4 identifier").option("-c, --count <number>", "Number of UUIDs to generate", "1").option("--uppercase", "Output in uppercase").option("--no-hyphens", "Remove hyphens from output").addHelpText("after", `
+Examples:
+  $ jai1 utils uuid
+  $ jai1 utils uuid --count 10
+  $ jai1 utils uuid --uppercase
+  $ jai1 utils uuid --no-hyphens
+  $ jai1 utils uuid --uppercase --no-hyphens
+`).action(async (options) => {
     await handleUuidGeneration({
       ...options,
       count: parseInt(options.count, 10)
@@ -5160,7 +5174,15 @@ function createHashCommand() {
     "-a, --algorithm <algorithm>",
     "Hash algorithm (md5, sha1, sha256, sha512, bcrypt)",
     "sha256"
-  ).option("-f, --file <path>", "Hash file contents instead of text").option("-r, --rounds <number>", "Bcrypt rounds (only for bcrypt)", "10").action(async (input, options) => {
+  ).option("-f, --file <path>", "Hash file contents instead of text").option("-r, --rounds <number>", "Bcrypt rounds (only for bcrypt)", "10").addHelpText("after", `
+Examples:
+  $ jai1 utils hash "hello world"
+  $ jai1 utils hash "hello" --algorithm md5
+  $ jai1 utils hash "password" --algorithm bcrypt
+  $ jai1 utils hash "password" --algorithm bcrypt --rounds 12
+  $ jai1 utils hash --file ./myfile.txt
+  $ jai1 utils hash --file ./image.png --algorithm sha512
+`).action(async (input, options) => {
     await handleHashGeneration(input, {
       ...options,
       rounds: parseInt(options.rounds, 10)
@@ -5203,7 +5225,13 @@ async function handleBase64Encode(input, options) {
   }
 }
 function createBase64EncodeCommand() {
-  const cmd = new Command17("base64-encode").description("Encode text or file to Base64").argument("[input]", "Text to encode").option("-f, --file <path>", "Encode file contents").option("--url-safe", "Use URL-safe Base64 encoding").action(async (input, options) => {
+  const cmd = new Command17("base64-encode").description("Encode text or file to Base64").argument("[input]", "Text to encode").option("-f, --file <path>", "Encode file contents").option("--url-safe", "Use URL-safe Base64 encoding").addHelpText("after", `
+Examples:
+  $ jai1 utils base64-encode "hello world"
+  $ jai1 utils base64-encode "hello world" --url-safe
+  $ jai1 utils base64-encode --file ./document.txt
+  $ jai1 utils base64-encode --file ./image.png
+`).action(async (input, options) => {
     await handleBase64Encode(input, options);
   });
   return cmd;
@@ -5242,7 +5270,13 @@ async function handleBase64Decode(input, options) {
   }
 }
 function createBase64DecodeCommand() {
-  const cmd = new Command18("base64-decode").description("Decode Base64 string").argument("[input]", "Base64 string to decode").option("-f, --file <path>", "Decode from file").option("-o, --output <path>", "Write decoded output to file").action(async (input, options) => {
+  const cmd = new Command18("base64-decode").description("Decode Base64 string").argument("[input]", "Base64 string to decode").option("-f, --file <path>", "Decode from file").option("-o, --output <path>", "Write decoded output to file").addHelpText("after", `
+Examples:
+  $ jai1 utils base64-decode "aGVsbG8gd29ybGQ="
+  $ jai1 utils base64-decode --file ./encoded.txt
+  $ jai1 utils base64-decode "aGVsbG8=" --output ./decoded.txt
+  $ jai1 utils base64-decode --file ./encoded.txt --output ./image.png
+`).action(async (input, options) => {
     await handleBase64Decode(input, options);
   });
   return cmd;
@@ -5315,7 +5349,15 @@ async function handleHttpRequest(url, options) {
   }
 }
 function createHttpCommand() {
-  const cmd = new Command19("http").description("Make HTTP request with formatted output").argument("<url>", "Target URL").option("-X, --method <method>", "HTTP method", "GET").option("-H, --header <header...>", "Request headers (repeatable)").option("-d, --data <data>", "Request body (JSON string)").option("--file <path>", "Read body from file").option("--timeout <ms>", "Request timeout in milliseconds", "30000").option("--no-follow", "Do not follow redirects").option("--only-headers", "Show only response headers").option("--only-body", "Show only response body").action(async (url, options) => {
+  const cmd = new Command19("http").description("Make HTTP request with formatted output").argument("<url>", "Target URL").option("-X, --method <method>", "HTTP method", "GET").option("-H, --header <header...>", "Request headers (repeatable)").option("-d, --data <data>", "Request body (JSON string)").option("--file <path>", "Read body from file").option("--timeout <ms>", "Request timeout in milliseconds", "30000").option("--no-follow", "Do not follow redirects").option("--only-headers", "Show only response headers").option("--only-body", "Show only response body").addHelpText("after", `
+Examples:
+  $ jai1 utils http https://api.example.com/users
+  $ jai1 utils http https://api.example.com/users -X POST -d '{"name":"John"}'
+  $ jai1 utils http https://api.example.com -H "Authorization: Bearer token123"
+  $ jai1 utils http https://api.example.com -H "Content-Type: application/json" -H "Accept: application/json"
+  $ jai1 utils http https://api.example.com --timeout 5000
+  $ jai1 utils http https://api.example.com --only-body
+`).showHelpAfterError("(add --help for additional examples)").action(async (url, options) => {
     await handleHttpRequest(url, {
       ...options,
       timeout: parseInt(options.timeout, 10)
@@ -5365,12 +5407,22 @@ async function handleJwtEncode(options) {
 }
 function createJwtCommand() {
   const jwtCommand = new Command20("jwt").description("Decode and encode JWT tokens");
-  jwtCommand.command("decode").description("Decode JWT token").argument("<token>", "JWT token to decode").action(async (token) => {
+  jwtCommand.command("decode").description("Decode JWT token").argument("<token>", "JWT token to decode").addHelpText("after", `
+Examples:
+  $ jai1 utils jwt decode "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
+  $ jai1 utils jwt decode $JWT_TOKEN
+`).action(async (token) => {
     await handleJwtDecode(token);
   });
-  jwtCommand.command("encode").description("Encode JWT token (HS256)").requiredOption("-p, --payload <json>", "Payload as JSON string").requiredOption("-s, --secret <secret>", "Secret key for signing").option("-h, --header <json>", "Custom header as JSON string").action(async (options) => {
+  const encodeCommand = jwtCommand.command("encode").description("Encode JWT token (HS256)").requiredOption("-p, --payload <json>", "Payload as JSON string").requiredOption("-s, --secret <secret>", "Secret key for signing").option("-h, --header <json>", "Custom header as JSON string").addHelpText("after", `
+Examples:
+  $ jai1 utils jwt encode --payload '{"sub":"123","name":"John"}' --secret "mysecret"
+  $ jai1 utils jwt encode -p '{"userId":"456"}' -s "key123"
+  $ jai1 utils jwt encode -p '{"sub":"789"}' -s "secret" -h '{"alg":"HS256","typ":"JWT"}'
+`).action(async (options) => {
     await handleJwtEncode(options);
   });
+  encodeCommand.showHelpAfterError("(add --help for additional examples)");
   return jwtCommand;
 }
 
@@ -5423,7 +5475,15 @@ async function handleUnixTime(input, options) {
   }
 }
 function createUnixTimeCommand() {
-  const cmd = new Command21("unix-time").description("Convert unix timestamps to/from dates").argument("[input]", "Unix timestamp or date string").option("-f, --format <format>", "Output format (iso, local, utc)", "iso").option("--ms", "Use milliseconds instead of seconds").action(async (input, options) => {
+  const cmd = new Command21("unix-time").description("Convert unix timestamps to/from dates").argument("[input]", "Unix timestamp or date string").option("-f, --format <format>", "Output format (iso, local, utc)", "iso").option("--ms", "Use milliseconds instead of seconds").addHelpText("after", `
+Examples:
+  $ jai1 utils unix-time
+  $ jai1 utils unix-time 1702550400
+  $ jai1 utils unix-time 1702550400000 --ms
+  $ jai1 utils unix-time "2024-01-15 10:30:00"
+  $ jai1 utils unix-time "2024-01-15" --format local
+  $ jai1 utils unix-time --ms
+`).action(async (input, options) => {
     await handleUnixTime(input, options);
   });
   return cmd;
@@ -5467,7 +5527,13 @@ async function handleTimezoneConversion(time, options) {
   }
 }
 function createTimezoneCommand() {
-  const cmd = new Command22("timezone").description("Convert time between timezones").argument("[time]", 'Time to convert (e.g., "2024-01-15 10:00")').option("--from <timezone>", "Source timezone").option("--to <timezone>", "Target timezone").option("--list", "Show available timezones").action(async (time, options) => {
+  const cmd = new Command22("timezone").description("Convert time between timezones").argument("[time]", 'Time to convert (e.g., "2024-01-15 10:00")').option("--from <timezone>", "Source timezone").option("--to <timezone>", "Target timezone").option("--list", "Show available timezones").addHelpText("after", `
+Examples:
+  $ jai1 utils timezone --list
+  $ jai1 utils timezone "2024-01-15 10:00" --from "America/New_York" --to "Asia/Tokyo"
+  $ jai1 utils timezone "2024-01-15 14:30" --from "UTC" --to "America/Los_Angeles"
+  $ jai1 utils timezone "2024-12-25 12:00" --from "Europe/London" --to "Asia/Ho_Chi_Minh"
+`).action(async (time, options) => {
     await handleTimezoneConversion(time, options);
   });
   return cmd;
@@ -5495,7 +5561,13 @@ async function handleUrlEncode(input, options) {
   }
 }
 function createUrlEncodeCommand() {
-  const cmd = new Command23("url-encode").description("Encode URL component or full URL").argument("<input>", "Text to encode").option("--full", "Encode full URL (use encodeURI instead of encodeURIComponent)").action(async (input, options) => {
+  const cmd = new Command23("url-encode").description("Encode URL component or full URL").argument("<input>", "Text to encode").option("--full", "Encode full URL (use encodeURI instead of encodeURIComponent)").addHelpText("after", `
+Examples:
+  $ jai1 utils url-encode "hello world"
+  $ jai1 utils url-encode "hello world & test"
+  $ jai1 utils url-encode "name=John Doe&age=30"
+  $ jai1 utils url-encode "https://example.com/path with spaces" --full
+`).showHelpAfterError("(add --help for additional examples)").action(async (input, options) => {
     await handleUrlEncode(input, options);
   });
   return cmd;
@@ -5523,7 +5595,13 @@ async function handleUrlDecode(input, options) {
   }
 }
 function createUrlDecodeCommand() {
-  const cmd = new Command24("url-decode").description("Decode URL-encoded string").argument("<input>", "Text to decode").option("--full", "Decode full URL (use decodeURI instead of decodeURIComponent)").action(async (input, options) => {
+  const cmd = new Command24("url-decode").description("Decode URL-encoded string").argument("<input>", "Text to decode").option("--full", "Decode full URL (use decodeURI instead of decodeURIComponent)").addHelpText("after", `
+Examples:
+  $ jai1 utils url-decode "hello%20world"
+  $ jai1 utils url-decode "hello%20world%20%26%20test"
+  $ jai1 utils url-decode "name%3DJohn%20Doe%26age%3D30"
+  $ jai1 utils url-decode "https://example.com/path%20with%20spaces" --full
+`).showHelpAfterError("(add --help for additional examples)").action(async (input, options) => {
     await handleUrlDecode(input, options);
   });
   return cmd;
@@ -5573,7 +5651,14 @@ async function handleCronParse(expression) {
   }
 }
 function createCronCommand() {
-  const cmd = new Command25("cron").description("Parse and explain cron expression").argument("<expression>", 'Cron expression (e.g., "0 5 * * *")').action(async (expression) => {
+  const cmd = new Command25("cron").description("Parse and explain cron expression").argument("<expression>", 'Cron expression (e.g., "0 5 * * *")').addHelpText("after", `
+Examples:
+  $ jai1 utils cron "0 5 * * *"
+  $ jai1 utils cron "*/15 * * * *"
+  $ jai1 utils cron "0 0 1 * *"
+  $ jai1 utils cron "0 9-17 * * 1-5"
+  $ jai1 utils cron "30 2 * * 0"
+`).showHelpAfterError("(add --help for additional examples)").action(async (expression) => {
     await handleCronParse(expression);
   });
   return cmd;
@@ -5608,7 +5693,13 @@ async function handleMarkdownPreview(file, options) {
   }
 }
 function createMarkdownPreviewCommand() {
-  const cmd = new Command26("markdown-preview").description("Preview markdown file in terminal").argument("<file>", "Markdown file path").option("--raw", "Show raw markdown instead of rendered").action(async (file, options) => {
+  const cmd = new Command26("markdown-preview").description("Preview markdown file in terminal").argument("<file>", "Markdown file path").option("--raw", "Show raw markdown instead of rendered").addHelpText("after", `
+Examples:
+  $ jai1 utils markdown-preview README.md
+  $ jai1 utils markdown-preview ./docs/guide.md
+  $ jai1 utils markdown-preview CHANGELOG.md --raw
+  $ jai1 utils markdown-preview ./notes.md
+`).showHelpAfterError("(add --help for additional examples)").action(async (file, options) => {
     await handleMarkdownPreview(file, options);
   });
   return cmd;