@kirrosh/zond 0.21.0 → 0.23.0

package/src/cli/commands/serve.ts

@@ -1,81 +0,0 @@
-import { startServer } from "../../web/server.ts";
-
-export interface ServeOptions {
-  port?: number;
-  host?: string;
-  dbPath?: string;
-  watch?: boolean;
-  open?: boolean;
-}
-
-/** Kill any existing process listening on the given port (Windows + Unix) */
-async function killPortHolder(port: number): Promise<void> {
-  const isWin = process.platform === "win32";
-  try {
-    if (isWin) {
-      // PowerShell: find PID on port, then kill it
-      const find = Bun.spawn(["powershell", "-NoProfile", "-Command",
-        `(Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue).OwningProcess`], {
-        stdout: "pipe", stderr: "ignore",
-      });
-      const out = await new Response(find.stdout).text();
-      const pids = [...new Set(out.trim().split(/\s+/).filter(s => /^\d+$/.test(s) && s !== "0"))];
-      for (const pid of pids) {
-        Bun.spawn(["powershell", "-NoProfile", "-Command",
-          `Stop-Process -Id ${pid} -Force -ErrorAction SilentlyContinue`], {
-          stdout: "ignore", stderr: "ignore",
-        });
-      }
-      if (pids.length > 0) {
-        // Give OS time to release the port
-        await Bun.sleep(500);
-      }
-    } else {
-      // Unix: lsof + kill
-      const find = Bun.spawn(["lsof", "-ti", `:${port}`], {
-        stdout: "pipe", stderr: "ignore",
-      });
-      const out = await new Response(find.stdout).text();
-      const pids = out.trim().split(/\s+/).filter(s => /^\d+$/.test(s));
-      for (const pid of pids) {
-        Bun.spawn(["kill", "-9", pid], { stdout: "ignore", stderr: "ignore" });
-      }
-      if (pids.length > 0) {
-        await Bun.sleep(300);
-      }
-    }
-  } catch {
-    // Best effort — if we can't kill, startServer will fail with port-in-use
-  }
-}
-
-export async function serveCommand(options: ServeOptions): Promise<number> {
-  const port = options.port ?? 8080;
-
-  // Kill previous instance on the same port
-  await killPortHolder(port);
-
-  await startServer({
-    port,
-    host: options.host,
-    dbPath: options.dbPath,
-    dev: options.watch,
-  });
-
-  // Open browser if requested
-  if (options.open) {
-    const host = options.host === "0.0.0.0" || !options.host ? "localhost" : options.host;
-    const url = `http://${host}:${port}`;
-    try {
-      const cmd = process.platform === "win32" ? ["cmd", "/c", "start", url]
-        : process.platform === "darwin" ? ["open", url]
-        : ["xdg-open", url];
-      Bun.spawn(cmd, { stdout: "ignore", stderr: "ignore" });
-    } catch {
-      // Best effort — if browser can't open, server still runs
-    }
-  }
-
-  // Keep running — Bun.serve keeps the process alive
-  return 0;
-}

package/src/cli/commands/sync.ts

@@ -1,269 +0,0 @@
-import { join } from "path";
-import { mkdir } from "fs/promises";
-import {
-  readOpenApiSpec,
-  extractEndpoints,
-  extractSecuritySchemes,
-  serializeSuite,
-  buildCatalog,
-  serializeCatalog,
-} from "../../core/generator/index.ts";
-import { generateSuites } from "../../core/generator/suite-generator.ts";
-import { filterByTag } from "../../core/generator/chunker.ts";
-import { readMeta, writeMeta, hashSpec, buildFileMeta } from "../../core/meta/meta-store.ts";
-import { diffEndpoints } from "../../core/sync/spec-differ.ts";
-import { decycleSchema } from "../../core/generator/schema-utils.ts";
-import { printError, printSuccess, printWarning } from "../output.ts";
-import { jsonOk, jsonError, printJson } from "../json-envelope.ts";
-import { version as ZOND_VERSION } from "../../../package.json";
-import { getDb } from "../../db/schema.ts";
-import { findCollectionByTestPath, updateCollection } from "../../db/queries.ts";
-
-export interface SyncOptions {
-  specPath: string;
-  testsDir: string;
-  dryRun?: boolean;
-  tag?: string;
-  json?: boolean;
-}
-
-export async function syncCommand(options: SyncOptions): Promise<number> {
-  try {
-    // Load existing metadata
-    const meta = await readMeta(options.testsDir);
-    if (!meta) {
-      const msg =
-        "No .zond-meta.json found. Run `zond generate <spec> --output <dir>` first to initialize metadata.";
-      if (options.json) {
-        printJson(jsonError("sync", [msg]));
-      } else {
-        printError(msg);
-      }
-      return 2;
-    }
-
-    // Load current spec
-    const doc = await readOpenApiSpec(options.specPath);
-    const specContent = JSON.stringify(decycleSchema(doc));
-    const currentHash = hashSpec(specContent);
-
-    if (currentHash === meta.specHash) {
-      const msg = "Spec unchanged — nothing to sync.";
-      if (options.json) {
-        printJson(jsonOk("sync", { newEndpoints: [], generatedFiles: [], removedKeys: [], specChanged: false }, [msg]));
-      } else {
-        console.log(msg);
-      }
-      return 0;
-    }
-
-    // Extract current endpoints
-    let currentEndpoints = extractEndpoints(doc);
-    const securitySchemes = extractSecuritySchemes(doc);
-
-    if (options.tag) {
-      currentEndpoints = filterByTag(currentEndpoints, options.tag);
-    }
-
-    // Collect all previously known endpoint keys from meta
-    const prevKeys = Object.values(meta.files).flatMap((f) => f.endpoints);
-
-    // Compute diff
-    const { newEndpoints, removedKeys } = diffEndpoints(prevKeys, currentEndpoints);
-
-    const warnings: string[] = [];
-
-    if (removedKeys.length > 0) {
-      for (const key of removedKeys) {
-        warnings.push(`Removed endpoint not deleted from tests (review manually): ${key}`);
-      }
-    }
-
-    if (newEndpoints.length === 0) {
-      // Update catalog even when no new endpoints — spec schema may have changed
-      const allEndpoints = extractEndpoints(doc);
-      const catalog = buildCatalog({
-        endpoints: allEndpoints,
-        securitySchemes,
-        specSource: options.specPath,
-        specHash: currentHash,
-        apiName: (doc as any).info?.title,
-        apiVersion: (doc as any).info?.version,
-        baseUrl: (doc as any).servers?.[0]?.url,
-      });
-      await Bun.write(join(options.testsDir, ".api-catalog.yaml"), serializeCatalog(catalog));
-
-      const msg = "Spec changed (hash differs) but no new endpoints detected. Existing tests may need manual review.";
-      warnings.push(msg);
-      if (options.json) {
-        printJson(jsonOk("sync", {
-          newEndpoints: [],
-          removedKeys,
-          generatedFiles: [],
-          specChanged: true,
-        }, warnings));
-      } else {
-        console.log(msg);
-        for (const w of warnings) {
-          printWarning(w);
-        }
-      }
-      return 0;
-    }
-
-    // Generate suites for new endpoints only
-    const suites = generateSuites({ endpoints: newEndpoints, securitySchemes });
-
-    if (options.dryRun) {
-      const newEndpointKeys = newEndpoints.map((ep) => `${ep.method.toUpperCase()} ${ep.path}`);
-      const plannedFiles = suites.map((s) => ({
-        file: `${s.fileStem ?? s.name}.yaml`,
-        suite: s.name,
-        tests: s.tests.length,
-      }));
-
-      if (options.json) {
-        printJson(jsonOk("sync", {
-          dryRun: true,
-          newEndpoints: newEndpointKeys,
-          removedKeys,
-          plannedFiles,
-          specChanged: true,
-        }, warnings));
-      } else {
-        console.log(`[dry-run] Detected ${newEndpoints.length} new endpoint(s):`);
-        for (const ep of newEndpoints) {
-          console.log(`  + ${ep.method.toUpperCase()} ${ep.path}`);
-        }
-        console.log(`\nWould generate ${suites.length} new suite file(s):`);
-        for (const f of plannedFiles) {
-          console.log(`  ${f.file}  (${f.tests} tests)`);
-        }
-        if (removedKeys.length > 0) {
-          console.log("\nRemoved endpoints (not deleted — review tests):");
-          for (const key of removedKeys) {
-            console.log(`  - ${key}`);
-          }
-        }
-        console.log("\nNo files written (dry-run).");
-      }
-      return 0;
-    }
-
-    // Write new files (skip if file already exists)
-    await mkdir(options.testsDir, { recursive: true });
-
-    const generatedFiles: Array<{ file: string; suite: string; tests: number }> = [];
-    const skippedFiles: string[] = [];
-    const updatedMetaFiles: Record<string, import("../../core/meta/types.ts").FileMeta> = {};
-
-    for (const suite of suites) {
-      const fileName = `${suite.fileStem ?? suite.name}.yaml`;
-      const filePath = join(options.testsDir, fileName);
-      const existing = Bun.file(filePath);
-
-      if (await existing.exists()) {
-        skippedFiles.push(fileName);
-        warnings.push(`Skipped ${fileName} (already exists — add new endpoints manually)`);
-        continue;
-      }
-
-      const yaml = serializeSuite(suite);
-      await Bun.write(filePath, yaml);
-      generatedFiles.push({ file: filePath, suite: suite.name, tests: suite.tests.length });
-      updatedMetaFiles[fileName] = buildFileMeta(suite, ZOND_VERSION);
-    }
-
-    // Update metadata: merge new file entries, update hash and timestamp
-    await writeMeta(options.testsDir, {
-      zondVersion: ZOND_VERSION,
-      lastSyncedAt: new Date().toISOString(),
-      specUrl: options.specPath,
-      specHash: currentHash,
-      files: { ...meta.files, ...updatedMetaFiles },
-    });
-
-    // Update .api-catalog.yaml with current spec state
-    const allEndpoints = extractEndpoints(doc);
-    const catalog = buildCatalog({
-      endpoints: allEndpoints,
-      securitySchemes,
-      specSource: options.specPath,
-      specHash: currentHash,
-      apiName: (doc as any).info?.title,
-      apiVersion: (doc as any).info?.version,
-      baseUrl: (doc as any).servers?.[0]?.url,
-    });
-    await Bun.write(join(options.testsDir, ".api-catalog.yaml"), serializeCatalog(catalog));
-
-    // Sync DB collection if one is registered for this tests directory
-    try {
-      getDb();
-      const collection = findCollectionByTestPath(options.testsDir);
-      if (collection && collection.openapi_spec !== options.specPath) {
-        updateCollection(collection.id, { openapi_spec: options.specPath });
-        warnings.push(`Updated collection '${collection.name}' spec reference: ${collection.openapi_spec ?? "(none)"} → ${options.specPath}`);
-      }
-    } catch {
-      // DB unavailable (e.g. no zond.db yet) — not a fatal error for sync
-    }
-
-    const newEndpointKeys = newEndpoints.map((ep) => `${ep.method.toUpperCase()} ${ep.path}`);
-
-    if (options.json) {
-      printJson(jsonOk("sync", {
-        newEndpoints: newEndpointKeys,
-        removedKeys,
-        generatedFiles,
-        skippedFiles,
-        specChanged: true,
-      }, warnings));
-    } else {
-      console.log(`Spec changed. Detected ${newEndpoints.length} new endpoint(s):`);
-      for (const ep of newEndpoints) {
-        console.log(`  + ${ep.method.toUpperCase()} ${ep.path}`);
-      }
-
-      if (generatedFiles.length > 0) {
-        console.log(`\nGenerated ${generatedFiles.length} new suite file(s):`);
-        for (const f of generatedFiles) {
-          console.log(`  ${f.file}  (${f.tests} tests)`);
-        }
-      }
-
-      if (skippedFiles.length > 0) {
-        console.log("\nSkipped (file exists, review manually):");
-        for (const f of skippedFiles) {
-          console.log(`  ${f}`);
-        }
-      }
-
-      if (removedKeys.length > 0) {
-        console.log("\nRemoved endpoints (not deleted — review tests):");
-        for (const key of removedKeys) {
-          console.log(`  - ${key}`);
-        }
-      }
-
-      if (generatedFiles.length > 0) {
-        printSuccess(`\nSync complete. ${generatedFiles.length} file(s) written.`);
-      } else {
-        printWarning("No new files written — all target files already exist.");
-      }
-
-      for (const w of warnings) {
-        printWarning(w);
-      }
-    }
-
-    return 0;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (options.json) {
-      printJson(jsonError("sync", [message]));
-    } else {
-      printError(message);
-    }
-    return 2;
-  }
-}

package/src/cli/commands/update.ts

@@ -1,189 +0,0 @@
-import { VERSION } from "../index.ts";
-import { isCompiledBinary } from "../runtime.ts";
-import { printError, printSuccess, printWarning } from "../output.ts";
-import { jsonOk, jsonError, printJson } from "../json-envelope.ts";
-
-export interface UpdateOptions {
-  json?: boolean;
-  check?: boolean;
-}
-
-const REPO = "kirrosh/zond";
-const GITHUB_API = `https://api.github.com/repos/${REPO}/releases/latest`;
-
-interface GitHubRelease {
-  tag_name: string;
-  assets: { name: string; browser_download_url: string }[];
-}
-
-function getTarget(): { target: string; ext: string } | null {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  if (platform === "linux" && arch === "x64") return { target: "linux-x64", ext: "tar.gz" };
-  if (platform === "darwin" && arch === "arm64") return { target: "darwin-arm64", ext: "tar.gz" };
-  if (platform === "win32" && arch === "x64") return { target: "win-x64", ext: "zip" };
-  return null;
-}
-
-async function fetchLatestRelease(): Promise<GitHubRelease> {
-  const resp = await fetch(GITHUB_API, {
-    headers: { "User-Agent": `zond/${VERSION}` },
-  });
-  if (!resp.ok) {
-    throw new Error(`GitHub API returned ${resp.status}: ${resp.statusText}`);
-  }
-  return resp.json() as Promise<GitHubRelease>;
-}
-
-export async function updateCommand(options: UpdateOptions): Promise<number> {
-  try {
-    if (!isCompiledBinary()) {
-      const msg = "Self-update is only available for standalone binaries. Install binary: curl -fsSL https://raw.githubusercontent.com/kirrosh/zond/master/install.sh | sh";
-      if (options.json) {
-        printJson(jsonOk("update", { action: "skip", reason: "not-standalone", installHint: "curl -fsSL https://raw.githubusercontent.com/kirrosh/zond/master/install.sh | sh" }, [msg]));
-      } else {
-        printWarning(msg);
-      }
-      return 3;
-    }
-
-    const target = getTarget();
-    if (!target) {
-      const msg = `Unsupported platform: ${process.platform}-${process.arch}`;
-      if (options.json) {
-        printJson(jsonError("update", [msg]));
-      } else {
-        printError(msg);
-      }
-      return 2;
-    }
-
-    const release = await fetchLatestRelease();
-    const latest = release.tag_name.replace(/^v/, "");
-
-    if (latest === VERSION) {
-      const msg = `Already up to date (${VERSION})`;
-      if (options.json) {
-        printJson(jsonOk("update", { action: "none", currentVersion: VERSION, latestVersion: latest }));
-      } else {
-        console.log(msg);
-      }
-      return 0;
-    }
-
-    if (options.check) {
-      const msg = `Update available: ${VERSION} → ${latest}`;
-      if (options.json) {
-        printJson(jsonOk("update", { action: "available", currentVersion: VERSION, latestVersion: latest }));
-      } else {
-        console.log(msg);
-      }
-      return 0;
-    }
-
-    // Find the right asset
-    const assetName = `zond-${target.target}.${target.ext}`;
-    const asset = release.assets.find(a => a.name === assetName);
-    if (!asset) {
-      const msg = `Binary not found for ${target.target} in release ${release.tag_name}`;
-      if (options.json) {
-        printJson(jsonError("update", [msg]));
-      } else {
-        printError(msg);
-      }
-      return 2;
-    }
-
-    console.log(`Updating zond ${VERSION} → ${latest}...`);
-    console.log(`Downloading ${assetName}...`);
-
-    // Download the archive
-    const resp = await fetch(asset.browser_download_url, {
-      headers: { "User-Agent": `zond/${VERSION}` },
-    });
-    if (!resp.ok) {
-      throw new Error(`Download failed: ${resp.status} ${resp.statusText}`);
-    }
-    const archiveData = new Uint8Array(await resp.arrayBuffer());
-
-    const currentBinary = process.execPath;
-    const { join, dirname } = await import("path");
-    const tmpDir = join(dirname(currentBinary), `.zond-update-${Date.now()}`);
-    const { mkdir, rm, rename, chmod } = await import("fs/promises");
-    await mkdir(tmpDir, { recursive: true });
-
-    try {
-      const archivePath = join(tmpDir, assetName);
-      await Bun.write(archivePath, archiveData);
-
-      // Extract
-      if (target.ext === "tar.gz") {
-        const proc = Bun.spawn(["tar", "-xzf", archivePath, "-C", tmpDir]);
-        const exitCode = await proc.exited;
-        if (exitCode !== 0) throw new Error(`tar extraction failed (exit ${exitCode})`);
-      } else {
-        // Windows zip
-        const proc = Bun.spawn([
-          "powershell", "-NoProfile", "-Command",
-          `Expand-Archive -Path '${archivePath}' -DestinationPath '${tmpDir}' -Force`,
-        ]);
-        const exitCode = await proc.exited;
-        if (exitCode !== 0) throw new Error(`Zip extraction failed (exit ${exitCode})`);
-      }
-
-      // Find the extracted binary
-      const binaryName = process.platform === "win32" ? "zond.exe" : "zond";
-      const newBinary = join(tmpDir, binaryName);
-      const file = Bun.file(newBinary);
-      if (!await file.exists()) {
-        throw new Error(`Binary '${binaryName}' not found in archive`);
-      }
-
-      // Replace current binary
-      try {
-        if (process.platform === "win32") {
-          // Windows: rename current to .old, move new, clean up
-          const oldBinary = currentBinary + ".old";
-          try { await rm(oldBinary, { force: true }); } catch {}
-          await rename(currentBinary, oldBinary);
-          await rename(newBinary, currentBinary);
-          try { await rm(oldBinary, { force: true }); } catch {}
-        } else {
-          await rename(newBinary, currentBinary);
-          await chmod(currentBinary, 0o755);
-        }
-      } catch (replaceErr: any) {
-        if (replaceErr?.code === "EACCES" || replaceErr?.code === "EPERM") {
-          const hint = process.platform === "win32"
-            ? `Permission denied. Run the terminal as Administrator.`
-            : `Permission denied writing to ${currentBinary}. Run: sudo zond update`;
-          if (options.json) {
-            printJson(jsonError("update", [hint]));
-          } else {
-            printError(hint);
-          }
-          return 2;
-        }
-        throw replaceErr;
-      }
-
-      if (options.json) {
-        printJson(jsonOk("update", { action: "updated", previousVersion: VERSION, newVersion: latest }));
-      } else {
-        printSuccess(`Updated zond ${VERSION} → ${latest}`);
-      }
-      return 0;
-    } finally {
-      try { await rm(tmpDir, { recursive: true, force: true }); } catch {}
-    }
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (options.json) {
-      printJson(jsonError("update", [message]));
-    } else {
-      printError(message);
-    }
-    return 2;
-  }
-}

package/src/cli/commands/validate.ts

@@ -1,34 +0,0 @@
-import { parse } from "../../core/parser/yaml-parser.ts";
-import { printError, printSuccess } from "../output.ts";
-import { jsonOk, jsonError, printJson } from "../json-envelope.ts";
-
-export interface ValidateOptions {
-  path: string;
-  json?: boolean;
-}
-
-export async function validateCommand(options: ValidateOptions): Promise<number> {
-  try {
-    const suites = await parse(options.path);
-    const totalSteps = suites.reduce((sum, s) => sum + s.tests.length, 0);
-    if (options.json) {
-      printJson(jsonOk("validate", {
-        files: suites.length,
-        suites: suites.length,
-        tests: totalSteps,
-        valid: true,
-      }));
-    } else {
-      printSuccess(`OK: ${suites.length} suite(s), ${totalSteps} test(s) validated successfully`);
-    }
-    return 0;
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (options.json) {
-      printJson(jsonError("validate", [message]));
-    } else {
-      printError(message);
-    }
-    return 2;
-  }
-}