@jango-blockchained/hoox-cli 0.5.2 → 0.5.7

package/src/ui/banner.ts

@@ -1,141 +0,0 @@
-/**
- * Hoox ASCII banner — variants for the interactive TUI.
- * Each variant provides a different visual style while maintaining
- * consistent branding and theme coloring.
- */
-
-import { theme } from "../utils/theme.js";
-
-const TAGLINE = "Cloudflare Workers Platform";
-const VERSION = "0.3.0";
-
-// ── Shared constants ──────────────────────────────────────────────
-
-/** Disclaimer line rendered below the banner and in the footer. */
-export const DISCLAIMER =
-  "DISCLAIMER: Trading cryptocurrencies involves substantial risk of loss. Use at your own risk.";
-
-// ── Variant 0 — Default (legacy) ──────────────────────────────────
-
-const LEGACY_LINES = [
-  "██╗  ██╗ ██████╗  ██████╗ ██╗  ██╗",
-  "██║  ██║██╔═══██╗██╔═══██╗╚██╗██╔╝",
-  "███████║██║   ██║██║   ██║ ╚███╔╝ ",
-  "██╔══██║██║   ██║██║   ██║ ██╔██╗ ",
-  "██║  ██║╚██████╔╝╚██████╔╝██╔╝ ██╗",
-  "╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝",
-];
-
-function renderLegacy(): string {
-  const bw = 52;
-  const line = ` ${theme.dim("─").repeat(bw - 2)}`;
-  const top = ` ${theme.dim("┌")}${line.slice(2)}${theme.dim("┐")}`;
-  const bottom = ` ${theme.dim("└")}${line.slice(2)}${theme.dim("┘")}`;
-  const ascii = LEGACY_LINES.map((l) => ` ${theme.heading(l)}`);
-  const gap = Math.floor((bw - TAGLINE.length - VERSION.length - 2) / 2);
-  const tag = ` ${" ".repeat(gap)}${theme.dim(TAGLINE)} ${theme.dim(`v${VERSION}`)}`;
-  return [top, ...ascii, line, tag, bottom].join("\n");
-}
-
-// ── Variant 1 — "Horizon" (architectural) ─────────────────────────
-// Uses double-line frame characters and a more open, architectural feel.
-// The "HOOX" wordmark is built from simple geometric blocks.
-
-const HORIZON_LINES = [
-  "╔═══╗ ╔═══╗ ╔═══╗ ╔═══╗",
-  "║ ║ ║ ║   ║ ║   ║ ║ ║ ║",
-  "║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║",
-  "║ ╚═╝ ║ ╚═╝ ║ ║ ║ ║ ╚═╝",
-  "║     ║     ║ ╚═╝ ║     ",
-  "╚═════╝ ╚═════╝ ╚═══╝ ╚═════╝",
-];
-
-export function renderBannerHorizon(): string {
-  const bw = 56;
-  const inner = theme.dim("─").repeat(bw - 2);
-  const top = ` ${theme.dim("╭")}${inner}${theme.dim("╮")}`;
-  const bottom = ` ${theme.dim("╰")}${inner}${theme.dim("╯")}`;
-  const ascii = HORIZON_LINES.map((l) => ` ${theme.accent(l)}`);
-  const gap = Math.floor((bw - TAGLINE.length - VERSION.length - 4) / 2);
-  const tag = ` ${" ".repeat(gap)}${theme.dim(TAGLINE)} ${theme.dim(`v${VERSION}`)}`;
-  return [top, ...ascii, theme.dim("─").repeat(bw), tag, bottom].join("\n");
-}
-
-// ── Variant 2 — "Signal" (data / waveform) ────────────────────────
-// Evokes trading signals and monitoring. Uses a smaller wordmark
-// with a dynamic waveform motif beneath it.
-
-const SIGNAL_LINES = [
-  "  _   _           _   _   ",
-  " | | | | ___   __| | | | ",
-  " | |_| |/ _ \\ / _` | | | ",
-  " |  _  | (_) | (_| | | | ",
-  " |_| |_|\\___/ \\__,_| |_| ",
-];
-
-export function renderBannerSignal(): string {
-  const bw = 54;
-  const line = theme.dim("─").repeat(bw);
-  const top = ` ${theme.dim("┌")}${line.slice(2)}${theme.dim("┐")}`;
-  const bottom = ` ${theme.dim("└")}${line.slice(2)}${theme.dim("┘")}`;
-
-  const wordmark = SIGNAL_LINES.map((l) => {
-    // Colour the letters H O O X, dim the rest
-    return ` ${theme.heading(l.slice(0, 26))}${theme.dim(l.slice(26))}`;
-  });
-
-  // Waveform line — sine-wave art
-  const wave = ` ${theme.accent("~~")}${theme.dim("~")}${theme.accent("_")}${theme.dim(".")}${theme.accent("/\\")}${theme.dim("~")}${theme.accent("\\/")}${theme.dim("..")}${theme.accent("/~~\\")}${theme.dim("~")}  ${theme.dim(TAGLINE)} ${theme.dim(`v${VERSION}`)}`;
-
-  return [top, ...wordmark, line, wave, bottom].join("\n");
-}
-
-// ── Variant 3 — "Minimal" (clean badge) ───────────────────────────
-// No ASCII art — just the project name, version, and a clean
-// double-rule header. Professional and understated.
-
-export function renderBannerMinimal(): string {
-  const bw = 50;
-  const rule = theme.dim("━").repeat(bw);
-  const inner = theme.dim("─").repeat(bw);
-
-  const leftPad = Math.floor((bw - TAGLINE.length - VERSION.length - 8) / 2);
-  const titleLine =
-    " ".repeat(leftPad) +
-    theme.heading("H O O X") +
-    "  " +
-    theme.dim(TAGLINE) +
-    "  " +
-    theme.dim(`v${VERSION}`);
-
-  return [
-    ` ${rule}`,
-    ` ${theme.dim("│")}${" ".repeat(bw - 2)}${theme.dim("│")}`,
-    `${theme.dim("│")}${titleLine}${" ".repeat(Math.max(0, bw - titleLine.length - 2))}${theme.dim("│")}`,
-    ` ${theme.dim("│")}${" ".repeat(bw - 2)}${theme.dim("│")}`,
-    ` ${rule}`,
-  ].join("\n");
-}
-
-// ── Exports ───────────────────────────────────────────────────────
-
-export const BANNER_VARIANTS = {
-  legacy: renderLegacy,
-  horizon: renderBannerHorizon,
-  signal: renderBannerSignal,
-  minimal: renderBannerMinimal,
-} as const;
-
-export type BannerVariant = keyof typeof BANNER_VARIANTS;
-
-/** Default banner — the legacy ASCII block style. */
-export function renderBanner(variant?: BannerVariant): string {
-  return variant ? BANNER_VARIANTS[variant]() : renderLegacy();
-}
-
-/**
- * Render a compact one-line banner for inline display.
- */
-export function renderCompactBanner(): string {
-  return `${theme.heading("Hoox CLI")} ${theme.dim(`${TAGLINE} ${VERSION}`)}`;
-}

package/src/ui/index.ts

@@ -1,8 +0,0 @@
-/**
- * Hoox CLI UI module — interactive TUI components.
- *
- * @module
- */
-
-export { renderBanner } from "./banner.js";
-export { runInteractiveTUI } from "./menu.js";

package/src/ui/menu.ts

@@ -1,490 +0,0 @@
-/**
- * Interactive TUI loop for the Hoox CLI.
- *
- * When `hoox` is called with no arguments, this module takes over:
- * shows the ASCII banner, an interactive clack menu, dispatches to
- * the appropriate Commander action, and returns to the menu.
- */
-
-import { Command } from "commander";
-import {
-  intro,
-  outro,
-  select,
-  text,
-  confirm,
-  log,
-  isCancel,
-  cancel,
-} from "@clack/prompts";
-import { renderBanner, DISCLAIMER } from "./banner.js";
-import { CLIError } from "../utils/errors.js";
-import { theme } from "../utils/theme.js";
-
-// ---------------------------------------------------------------------------
-// Main entry
-// ---------------------------------------------------------------------------
-
-/**
- * Run the interactive TUI loop.
- * - Shows the banner once
- * - Shows a category-selection menu
- * - Each category leads to sub-actions
- * - After each action, returns to the menu
- * - Exit or Ctrl+C to quit
- */
-export async function runInteractiveTUI(program: Command): Promise<void> {
-  // Print banner directly, then start clack prompt session
-  process.stdout.write(renderBanner() + "\n");
-  intro("hoox");
-
-  while (true) {
-    const category = await showMainMenu();
-    if (category === "__exit") break;
-
-    const result = await handleCategory(category, program);
-    if (result === "exit") break;
-    // "back" or "continue" → loop back to main menu
-  }
-
-  // Legal footer
-  process.stdout.write(
-    theme.dim("─".repeat(50)) + "\n" + theme.muted(DISCLAIMER) + "\n"
-  );
-  outro("See you later!");
-}
-
-// ---------------------------------------------------------------------------
-// Main menu
-// ---------------------------------------------------------------------------
-
-const MAIN_CATEGORIES = [
-  {
-    value: "init",
-    label: "⚡ Setup Wizard",
-    hint: "bootstrap or reconfigure project",
-  },
-  { value: "deploy", label: "Deploy", hint: "workers, dashboard" },
-  {
-    value: "manage",
-    label: "Manage",
-    hint: "infrastructure, config, secrets",
-  },
-  {
-    value: "monitor",
-    label: "Monitor",
-    hint: "diagnostics, health, logs, tests",
-  },
-  { value: "tools", label: "Tools", hint: "WAF, clone worker, dashboard UI" },
-  { value: "develop", label: "Develop", hint: "dev server, start project" },
-  { value: "__exit", label: "Exit" },
-] as const;
-
-async function showMainMenu(): Promise<string> {
-  const choice = await select({
-    message: "What would you like to do?",
-    options: [...MAIN_CATEGORIES],
-  });
-
-  if (isCancel(choice)) {
-    cancel("Operation cancelled.");
-    return "__exit";
-  }
-
-  return choice;
-}
-
-// ---------------------------------------------------------------------------
-// Category handlers
-// ---------------------------------------------------------------------------
-
-/**
- * Handle a selected category. Returns "back", "exit", or "continue".
- */
-async function handleCategory(
-  category: string,
-  program: Command
-): Promise<"back" | "exit" | "continue"> {
-  switch (category) {
-    case "init":
-      await runCommand(program, "init");
-      return "continue";
-    case "deploy":
-      return showDeployMenu(program);
-    case "develop":
-      return showDevelopMenu(program);
-    case "manage":
-      return showManageMenu(program);
-    case "monitor":
-      return showMonitorMenu(program);
-    case "tools":
-      return showToolsMenu(program);
-    default:
-      return "back";
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Deploy sub-menu
-// ---------------------------------------------------------------------------
-
-async function showDeployMenu(
-  program: Command
-): Promise<"back" | "exit" | "continue"> {
-  while (true) {
-    const choice = await select({
-      message: "Deploy",
-      options: [
-        { value: "all", label: "All workers + dashboard", hint: "recommended" },
-        { value: "workers", label: "Workers only" },
-        { value: "single", label: "Single worker..." },
-        { value: "dashboard", label: "Dashboard only" },
-        { value: "__back", label: "◀ Back to main menu" },
-      ],
-    });
-
-    if (isCancel(choice)) return "back";
-    if (choice === "__back") return "continue";
-
-    if (choice === "single") {
-      const name = await text({
-        message: "Which worker?",
-        placeholder: "e.g. hoox, trade-worker, d1-worker",
-        validate: (v) =>
-          v === undefined || v.length === 0
-            ? "Worker name is required"
-            : undefined,
-      });
-      if (isCancel(name)) continue;
-      if (!name) continue;
-      await runCommand(program, `deploy worker ${name}`);
-    } else {
-      const cmd = choice === "all" ? "deploy all" : `deploy ${choice}`;
-      await runCommand(program, cmd);
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Develop sub-menu
-// ---------------------------------------------------------------------------
-
-async function showDevelopMenu(
-  program: Command
-): Promise<"back" | "exit" | "continue"> {
-  while (true) {
-    const choice = await select({
-      message: "Develop",
-      options: [
-        {
-          value: "dev start",
-          label: "Start dev server",
-          hint: "runs all workers locally",
-        },
-        { value: "__back", label: "◀ Back to main menu" },
-      ],
-    });
-
-    if (isCancel(choice)) return "back";
-    if (choice === "__back") return "continue";
-
-    await runCommand(program, choice);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Manage sub-menu
-// ---------------------------------------------------------------------------
-
-async function showManageMenu(
-  program: Command
-): Promise<"back" | "exit" | "continue"> {
-  while (true) {
-    const choice = await select({
-      message: "Manage",
-      options: [
-        { value: "infra", label: "Infrastructure", hint: "D1, R2, KV, Queues" },
-        {
-          value: "config",
-          label: "Configuration",
-          hint: "show / set wrangler.jsonc",
-        },
-        { value: "secrets", label: "Secrets", hint: "list, set, sync" },
-        { value: "keys", label: "Auth keys", hint: "generate, list" },
-        { value: "waf", label: "WAF rules" },
-        { value: "__back", label: "◀ Back to main menu" },
-      ],
-    });
-
-    if (isCancel(choice)) return "back";
-    if (choice === "__back") return "continue";
-
-    switch (choice) {
-      case "infra":
-        await runCommand(program, "infra");
-        break;
-      case "config":
-        await showConfigSubMenu(program);
-        break;
-      case "secrets":
-        await showSecretsSubMenu(program);
-        break;
-      case "keys":
-        await showKeysSubMenu(program);
-        break;
-      case "waf":
-        await runCommand(program, "waf");
-        break;
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Config sub-sub-menu
-// ---------------------------------------------------------------------------
-
-async function showConfigSubMenu(program: Command): Promise<void> {
-  const choice = await select({
-    message: "Configuration",
-    options: [
-      { value: "show", label: "Show config", hint: "display wrangler.jsonc" },
-      { value: "set", label: "Set a value..." },
-      { value: "__back", label: "◀ Back to Manage" },
-    ],
-  });
-
-  if (isCancel(choice) || choice === "__back") return;
-
-  if (choice === "set") {
-    const key = await text({
-      message: "Config key (dot-separated path)",
-      placeholder: "e.g. global.cloudflare_account_id",
-      validate: (v) =>
-        v === undefined || v.length === 0 ? "Key is required" : undefined,
-    });
-    if (isCancel(key) || !key) return;
-
-    const value = await text({
-      message: `Value for "${key}"`,
-      placeholder: "enter value",
-    });
-    if (isCancel(value) || value === undefined) return;
-
-    await runCommand(program, `config set ${key} ${value ?? ""}`);
-  } else {
-    await runCommand(program, "config show");
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Secrets sub-sub-menu
-// ---------------------------------------------------------------------------
-
-async function showSecretsSubMenu(program: Command): Promise<void> {
-  const choice = await select({
-    message: "Secrets",
-    options: [
-      { value: "list", label: "List secrets" },
-      { value: "set", label: "Set a secret..." },
-      { value: "sync", label: "Sync to Cloudflare" },
-      { value: "__back", label: "◀ Back to Manage" },
-    ],
-  });
-
-  if (isCancel(choice) || choice === "__back") return;
-
-  switch (choice) {
-    case "list":
-      await runCommand(program, "config secrets list");
-      break;
-    case "set": {
-      const worker = await text({
-        message: "Worker name",
-        placeholder: "e.g. hoox, trade-worker",
-        validate: (v) =>
-          v === undefined || v.length === 0
-            ? "Worker name is required"
-            : undefined,
-      });
-      if (isCancel(worker) || !worker) return;
-
-      const secretName = await text({
-        message: "Secret name",
-        placeholder: "e.g. API_KEY, DATABASE_URL",
-        validate: (v) =>
-          v === undefined || v.length === 0
-            ? "Secret name is required"
-            : undefined,
-      });
-      if (isCancel(secretName) || !secretName) return;
-
-      await runCommand(program, `config secrets set ${worker} ${secretName}`);
-      break;
-    }
-    case "sync":
-      await runCommand(program, "config secrets sync");
-      break;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Keys sub-sub-menu
-// ---------------------------------------------------------------------------
-
-async function showKeysSubMenu(program: Command): Promise<void> {
-  const choice = await select({
-    message: "Auth Keys",
-    options: [
-      { value: "generate", label: "Generate new keys" },
-      { value: "list", label: "List existing keys" },
-      { value: "__back", label: "◀ Back to Manage" },
-    ],
-  });
-
-  if (isCancel(choice) || choice === "__back") return;
-
-  if (choice === "generate") {
-    const proceed = await confirm({
-      message:
-        "Generate new internal auth keys? This will create .keys/*.env files.",
-      initialValue: false,
-    });
-    if (isCancel(proceed) || !proceed) return;
-  }
-
-  await runCommand(program, `config keys ${choice}`);
-}
-
-// ---------------------------------------------------------------------------
-// Monitor sub-menu
-// ---------------------------------------------------------------------------
-
-async function showMonitorMenu(
-  program: Command
-): Promise<"back" | "exit" | "continue"> {
-  while (true) {
-    const choice = await select({
-      message: "Monitor",
-      options: [
-        {
-          value: "check setup",
-          label: "Run diagnostics",
-          hint: "full system validation",
-        },
-        {
-          value: "check health",
-          label: "Health check",
-          hint: "worker connectivity",
-        },
-        { value: "check fix", label: "Auto-repair", hint: "fix common issues" },
-        { value: "__logs", label: "View logs", hint: "real-time log tailing" },
-        { value: "test", label: "Run tests" },
-        { value: "__back", label: "◀ Back to main menu" },
-      ],
-    });
-
-    if (isCancel(choice)) return "back";
-    if (choice === "__back") return "continue";
-
-    if (choice === "__logs") {
-      const target = await select({
-        message: "Tail logs for",
-        options: [
-          { value: "all", label: "All workers" },
-          { value: "single", label: "A specific worker..." },
-          { value: "__back", label: "◀ Back" },
-        ],
-      });
-      if (isCancel(target) || target === "__back") continue;
-      if (target === "single") {
-        const name = await text({
-          message: "Worker name",
-          placeholder: "e.g. hoox, trade-worker, d1-worker",
-        });
-        if (isCancel(name) || !name) continue;
-        await runCommand(program, `logs worker ${name}`);
-      } else {
-        await runCommand(program, "logs all");
-      }
-      continue;
-    }
-
-    await runCommand(program, choice);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Tools sub-menu
-// ---------------------------------------------------------------------------
-
-async function showToolsMenu(
-  program: Command
-): Promise<"back" | "exit" | "continue"> {
-  while (true) {
-    const choice = await select({
-      message: "Tools",
-      options: [
-        {
-          value: "clone",
-          label: "Clone worker",
-          hint: "scaffold from template",
-        },
-        {
-          value: "dashboard",
-          label: "Dashboard UI",
-          hint: "manage dashboard URLs",
-        },
-        {
-          value: "tui",
-          label: "Launch TUI Dashboard",
-          hint: "OpenTUI terminal operations center",
-        },
-        { value: "__back", label: "◀ Back to main menu" },
-      ],
-    });
-
-    if (isCancel(choice)) return "back";
-    if (choice === "__back") return "continue";
-
-    await runCommand(program, choice);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Command execution
-// ---------------------------------------------------------------------------
-
-/**
- * Run a Commander command string inside the TUI loop.
- *
- * Delegates to `program.parseAsync()` with the given arguments.
- * Wraps in try-catch so errors don't terminate the loop.
- */
-async function runCommand(program: Command, commandStr: string): Promise<void> {
-  const args = commandStr.split(" ");
-
-  try {
-    // from: "user" means Commander expects raw user arguments only —
-    // NOT [node, script, ...args] format. So just pass the args directly.
-    await program.parseAsync(args, {
-      from: "user",
-    });
-  } catch (err) {
-    // Check if it's a Commander informational exit (help/version)
-    if (
-      err instanceof Error &&
-      "code" in err &&
-      (err as { code: string }).code === "commander.helpDisplayed"
-    ) {
-      return;
-    }
-
-    const message =
-      err instanceof CLIError
-        ? err.message
-        : err instanceof Error
-          ? err.message
-          : String(err);
-    log.error(`Command failed: ${message}`);
-  }
-}

package/src/utils/error-handler.ts

@@ -1,62 +0,0 @@
-/**
- * Shared CLI error-handling wrapper.
- *
- * Provides a `withErrorHandling()` higher-order function that wraps command
- * handlers with standardized error formatting and exit-code management,
- * eliminating ~23 duplicated try/catch blocks across command files.
- *
- * Inner/recoverable try/catch blocks (e.g. JSON parse, per-key KV errors,
- * API network errors) are left in place — only the outermost handler-level
- * catch-all is replaced.
- */
-
-import { formatError } from "./formatters.js";
-import { CLIError, ExitCode } from "./errors.js";
-import type { FormatOptions } from "./formatters.js";
-
-export type CommandResult = Promise<void>;
-
-/**
- * Wraps a command handler with standardized error handling.
- *
- * @param handler - The command action function to wrap
- * @param options.service - Service name for error prefix (e.g. "db", "kv")
- * @param options.opts   - Optional FormatOptions for JSON/quiet-aware output
- *
- * @returns A wrapped function that catches errors, formats them, and exits
- *
- * @example
- * ```ts
- * .action(withErrorHandling(async (cmd) => {
- *   const opts = getFormatOptions(cmd);
- *   // …command logic…
- * }, { service: "db" }))
- * ```
- */
-export function withErrorHandling<T extends unknown[]>(
-  handler: (...args: T) => Promise<void>,
-  options?: { service?: string; opts?: FormatOptions }
-): (...args: T) => CommandResult {
-  return async (...args: T) => {
-    try {
-      await handler(...args);
-    } catch (error) {
-      const service = options?.service ?? "cli";
-
-      if (error instanceof CLIError) {
-        // CLIError is already structured — pass through for proper formatting
-        formatError(error, options?.opts);
-        process.exit(error.code);
-      } else if (error instanceof Error) {
-        formatError(`[${service}] ${error.message}`, options?.opts);
-        process.exit(ExitCode.ERROR);
-      } else {
-        formatError(
-          `[${service}] Unknown error: ${String(error)}`,
-          options?.opts
-        );
-        process.exit(ExitCode.CommandFailed);
-      }
-    }
-  };
-}