@kirrosh/zond 0.26.0 → 0.27.0

package/src/cli/commands/describe.ts

@@ -1,120 +0,0 @@
-import { describeEndpoint, describeCompact, describeAllParams } from "../../core/generator/describe.ts";
-import { printError } from "../output.ts";
-import { jsonOk, jsonError, printJson } from "../json-envelope.ts";
-
-export interface DescribeOptions {
-  specPath: string;
-  method?: string;
-  path?: string;
-  compact?: boolean;
-  listParams?: boolean;
-  json?: boolean;
-}
-
-export async function describeCommand(options: DescribeOptions): Promise<number> {
-  try {
-    if (options.listParams) {
-      const params = await describeAllParams(options.specPath);
-      if (options.json) {
-        printJson(jsonOk("describe", { params }));
-      } else {
-        const grouped = new Map<string, typeof params>();
-        for (const p of params) {
-          const arr = grouped.get(p.in) ?? [];
-          arr.push(p);
-          grouped.set(p.in, arr);
-        }
-        for (const [location, locationParams] of grouped) {
-          console.log(`\n${location.toUpperCase()} parameters:`);
-          for (const p of locationParams) {
-            const req = p.required ? " (required)" : "";
-            const type = p.type ? ` [${p.type}]` : "";
-            console.log(`  ${p.name}${type}${req} — used in ${p.usedBy.length} endpoint(s)`);
-          }
-        }
-        console.log(`\n${params.length} unique parameter(s)`);
-      }
-      return 0;
-    }
-
-    // No flags = compact listing. Erroring out (exit 2) on `zond describe`
-    // breaks scripts that pipe the listing; the listing IS the only useful
-    // default since the spec is the only required arg. Single-endpoint detail
-    // remains opt-in via --method/--path.
-    const useCompact = options.compact || (!options.method && !options.path);
-
-    if (useCompact) {
-      const endpoints = await describeCompact(options.specPath);
-
-      if (options.json) {
-        printJson(jsonOk("describe", { endpoints }));
-      } else {
-        for (const ep of endpoints) {
-          const parts = [ep.method.padEnd(7), ep.path];
-          if (ep.operationId) parts.push(`(${ep.operationId})`);
-          if (ep.summary) parts.push(`— ${ep.summary}`);
-          if (ep.deprecated) parts.push("[deprecated]");
-          console.log(parts.join(" "));
-        }
-        console.log(`\n${endpoints.length} endpoint(s)`);
-      }
-      return 0;
-    }
-
-    // We get here only when one of --method/--path is set but not both —
-    // single-endpoint detail needs both halves of the address.
-    if (!options.method || !options.path) {
-      const msg = "--method and --path must be used together for single-endpoint detail. Drop both for the compact listing.";
-      if (options.json) {
-        printJson(jsonError("describe", [msg]));
-      } else {
-        printError(msg);
-      }
-      return 2;
-    }
-
-    const result = await describeEndpoint(options.specPath, options.method, options.path);
-
-    if (options.json) {
-      printJson(jsonOk("describe", result));
-    } else {
-      console.log(JSON.stringify(result, null, 2));
-    }
-    return 0;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (options.json) {
-      printJson(jsonError("describe", [message]));
-    } else {
-      printError(message);
-    }
-    return 2;
-  }
-}
-
-import type { Command } from "commander";
-import { globalJson, resolveSpecArg } from "../resolve.ts";
-
-export function registerDescribe(program: Command): void {
-  program
-    .command("describe [spec]")
-    .description("Describe endpoints from OpenAPI spec")
-    .option("--api <name>", "Use the registered API's spec (apis/<name>/spec.json)")
-    .option("--db <path>", "Path to SQLite database file")
-    .option("--compact", "List all endpoints briefly")
-    .option("--list-params", "List all unique parameters across all endpoints")
-    .option("--method <method>", "HTTP method for single endpoint detail")
-    .option("--path <path>", "Endpoint path for single endpoint detail")
-    .action(async (specPos: string | undefined, opts, cmd: Command) => {
-      const resolved = resolveSpecArg(specPos, opts.api, opts.db);
-      if ("error" in resolved) { printError(resolved.error); process.exitCode = 2; return; }
-      process.exitCode = await describeCommand({
-        specPath: resolved.spec,
-        compact: opts.compact === true,
-        listParams: opts.listParams === true,
-        method: opts.method,
-        path: opts.path,
-        json: globalJson(cmd),
-      });
-    });
-}