@testsmith/api-spector 0.3.0 → 0.3.2

package/out/main/mock.js

@@ -1,74 +1,16 @@
 #!/usr/bin/env node
 "use strict";
-const promises = require("fs/promises");
-const path = require("path");
 const mockServer = require("./chunks/mock-server-DSLR2ulH.js");
+const cliCommon = require("./chunks/cli-common-CDQY1erJ.js");
 require("http");
 require("crypto");
 require("vm");
 require("dayjs");
 require("@xmldom/xmldom");
-const C = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  green: "\x1B[32m",
-  red: "\x1B[31m",
-  yellow: "\x1B[33m",
-  cyan: "\x1B[36m",
-  gray: "\x1B[90m",
-  white: "\x1B[97m"
-};
-function color(str, ...codes) {
-  return process.stdout.isTTY ? codes.join("") + str + C.reset : str;
-}
-function parseArgs(argv) {
-  const args = {};
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (!arg.startsWith("--")) continue;
-    const key = arg.slice(2);
-    const next = argv[i + 1];
-    if (!next || next.startsWith("--")) {
-      args[key] = true;
-    } else {
-      if (key === "name") {
-        const prev = args[key];
-        args[key] = Array.isArray(prev) ? [...prev, next] : [next];
-      } else {
-        args[key] = next;
-      }
-      i++;
-    }
-  }
-  return args;
-}
-async function resolveWorkspacePath(wsPath) {
-  const s = await promises.stat(wsPath);
-  if (!s.isDirectory()) return wsPath;
-  const entries = await promises.readdir(wsPath);
-  const spector = entries.find((e) => e.endsWith(".spector"));
-  if (!spector) throw new Error(`No .spector workspace file found in directory: ${wsPath}`);
-  return path.join(wsPath, spector);
-}
-async function loadWorkspace(wsPath) {
-  const resolved = await resolveWorkspacePath(wsPath);
-  const raw = await promises.readFile(resolved, "utf8");
-  return { workspace: JSON.parse(raw), dir: path.dirname(path.resolve(resolved)) };
-}
-async function loadMocks(workspace, dir) {
-  const mocks = [];
-  for (const relPath of workspace.mocks ?? []) {
-    try {
-      const raw = await promises.readFile(path.join(dir, relPath), "utf8");
-      mocks.push(JSON.parse(raw));
-    } catch {
-      console.warn(color(`  [warn] Could not load mock: ${relPath}`, C.yellow));
-    }
-  }
-  return mocks;
-}
+require("fs/promises");
+require("path");
 async function main() {
-  const args = parseArgs(process.argv.slice(2));
+  const args = cliCommon.parseArgs(process.argv.slice(2), ["name"]);
   if (args.help) {
     console.log(
       "\nUsage:\n  api-spector mock --workspace <path> [--name <server-name>] [--log]\n\nOptions:\n  --workspace <path>   Path to workspace.json (required)\n  --name <name>        Start only the named server (repeat for multiple)\n  --log                Print each incoming request (matched and unmatched)\n  --help               Show this message\n"
@@ -77,50 +19,54 @@ async function main() {
   }
   const wsPath = args.workspace;
   if (!wsPath) {
-    console.error(color("Error: --workspace is required", C.red));
+    console.error(cliCommon.color("Error: --workspace is required", cliCommon.C.red));
     process.exit(1);
   }
   let workspace, wsDir;
   try {
     ;
-    ({ workspace, dir: wsDir } = await loadWorkspace(wsPath));
+    ({ workspace, dir: wsDir } = await cliCommon.loadWorkspace(wsPath));
   } catch {
-    console.error(color(`Error: could not read workspace: ${wsPath}`, C.red));
+    console.error(cliCommon.color(`Error: could not read workspace: ${wsPath}`, cliCommon.C.red));
     process.exit(1);
   }
-  const allMocks = await loadMocks(workspace, wsDir);
+  const allMocks = await cliCommon.loadMocks(
+    workspace,
+    wsDir,
+    (relPath) => console.warn(cliCommon.color(`  [warn] Could not load mock: ${relPath}`, cliCommon.C.yellow))
+  );
   if (allMocks.length === 0) {
-    console.error(color("  No mock servers defined in this workspace.", C.yellow));
+    console.error(cliCommon.color("  No mock servers defined in this workspace.", cliCommon.C.yellow));
     process.exit(0);
   }
   const nameFilter = args.name ? (Array.isArray(args.name) ? args.name : [args.name]).map((n) => n.toLowerCase()) : null;
   const toStart = nameFilter ? allMocks.filter((m) => nameFilter.includes(m.name.toLowerCase())) : allMocks;
   if (toStart.length === 0) {
-    console.error(color(`  No mock servers matched the given --name filter.`, C.yellow));
-    console.log(color(`  Available: ${allMocks.map((m) => `"${m.name}"`).join(", ")}`, C.gray));
+    console.error(cliCommon.color(`  No mock servers matched the given --name filter.`, cliCommon.C.yellow));
+    console.log(cliCommon.color(`  Available: ${allMocks.map((m) => `"${m.name}"`).join(", ")}`, cliCommon.C.gray));
     process.exit(1);
   }
   console.log("");
-  console.log(color("  Mock Servers", C.bold, C.white));
-  console.log(color(`  Workspace: ${wsPath}`, C.gray));
+  console.log(cliCommon.color("  Mock Servers", cliCommon.C.bold, cliCommon.C.white));
+  console.log(cliCommon.color(`  Workspace: ${wsPath}`, cliCommon.C.gray));
   console.log("");
   let started = 0;
   for (const mock of toStart) {
     try {
       await mockServer.startMock(mock);
       console.log(
-        color("  ✓", C.green, C.bold) + `  ${color(mock.name, C.white)}  ` + color(`http://127.0.0.1:${mock.port}`, C.cyan) + color(`  (${mock.routes.length} route${mock.routes.length !== 1 ? "s" : ""})`, C.gray)
+        cliCommon.color("  ✓", cliCommon.C.green, cliCommon.C.bold) + `  ${cliCommon.color(mock.name, cliCommon.C.white)}  ` + cliCommon.color(`http://127.0.0.1:${mock.port}`, cliCommon.C.cyan) + cliCommon.color(`  (${mock.routes.length} route${mock.routes.length !== 1 ? "s" : ""})`, cliCommon.C.gray)
       );
       for (const route of mock.routes) {
-        const delay = route.delay ? color(`  ${route.delay}ms`, C.gray) : "";
+        const delay = route.delay ? cliCommon.color(`  ${route.delay}ms`, cliCommon.C.gray) : "";
         console.log(
-          color(`       ${route.method.padEnd(7)} ${route.path}`, C.gray) + color(`  →  ${route.statusCode}`, route.statusCode < 400 ? C.green : C.red) + delay
+          cliCommon.color(`       ${route.method.padEnd(7)} ${route.path}`, cliCommon.C.gray) + cliCommon.color(`  →  ${route.statusCode}`, route.statusCode < 400 ? cliCommon.C.green : cliCommon.C.red) + delay
         );
       }
       started++;
     } catch (e) {
       console.error(
-        color("  ✗", C.red, C.bold) + `  ${mock.name}  ` + color(e instanceof Error ? e.message : String(e), C.red)
+        cliCommon.color("  ✗", cliCommon.C.red, cliCommon.C.bold) + `  ${mock.name}  ` + cliCommon.color(e instanceof Error ? e.message : String(e), cliCommon.C.red)
       );
     }
   }
@@ -138,27 +84,27 @@ async function main() {
     }
     mockServer.setHitCallback((hit) => {
       const ts = new Date(hit.timestamp).toISOString().slice(11, 23);
-      const server = color(serverNames[hit.serverId] ?? hit.serverId, C.white);
+      const server = cliCommon.color(serverNames[hit.serverId] ?? hit.serverId, cliCommon.C.white);
       const method = hit.method.padEnd(7);
       const matched = hit.matchedRouteId !== null;
-      const status = color(String(hit.status), hit.status < 400 ? C.green : C.red);
-      const dur = color(`${hit.durationMs}ms`, C.gray);
+      const status = cliCommon.color(String(hit.status), hit.status < 400 ? cliCommon.C.green : cliCommon.C.red);
+      const dur = cliCommon.color(`${hit.durationMs}ms`, cliCommon.C.gray);
       if (matched) {
-        const route = color(routePaths[hit.matchedRouteId] ?? hit.matchedRouteId, C.gray);
+        const route = cliCommon.color(routePaths[hit.matchedRouteId] ?? hit.matchedRouteId, cliCommon.C.gray);
         console.log(
-          color(`  ${ts}`, C.gray) + `  ${server}  ` + color(method, C.cyan) + color(hit.path, C.white) + `  ${status}  ${dur}` + color(`  → ${route}`, C.gray)
+          cliCommon.color(`  ${ts}`, cliCommon.C.gray) + `  ${server}  ` + cliCommon.color(method, cliCommon.C.cyan) + cliCommon.color(hit.path, cliCommon.C.white) + `  ${status}  ${dur}` + cliCommon.color(`  → ${route}`, cliCommon.C.gray)
         );
       } else {
         console.log(
-          color(`  ${ts}`, C.gray) + `  ${server}  ` + color(method, C.yellow) + color(hit.path, C.yellow) + `  ${status}  ${dur}` + color("  (no match)", C.yellow)
+          cliCommon.color(`  ${ts}`, cliCommon.C.gray) + `  ${server}  ` + cliCommon.color(method, cliCommon.C.yellow) + cliCommon.color(hit.path, cliCommon.C.yellow) + `  ${status}  ${dur}` + cliCommon.color("  (no match)", cliCommon.C.yellow)
         );
       }
     });
   }
   console.log("");
-  console.log(color("  Press Ctrl+C to stop all servers.\n", C.gray));
+  console.log(cliCommon.color("  Press Ctrl+C to stop all servers.\n", cliCommon.C.gray));
   async function shutdown() {
-    console.log(color("\n  Stopping mock servers…", C.gray));
+    console.log(cliCommon.color("\n  Stopping mock servers…", cliCommon.C.gray));
     await mockServer.stopAll();
     process.exit(0);
   }
@@ -168,6 +114,6 @@ async function main() {
   }, 1 << 30);
 }
 main().catch((err) => {
-  console.error(color(`Fatal: ${err.message}`, C.red));
+  console.error(cliCommon.color(`Fatal: ${err.message}`, cliCommon.C.red));
   process.exit(2);
 });

package/out/main/record.js

@@ -3,51 +3,17 @@
 const promises = require("fs/promises");
 const path = require("path");
 const recorder = require("./chunks/recorder-DFxJgn9c.js");
+const cliCommon = require("./chunks/cli-common-CDQY1erJ.js");
 require("http");
 require("crypto");
 require("undici");
-const C = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  dim: "\x1B[2m",
-  green: "\x1B[32m",
-  red: "\x1B[31m",
-  yellow: "\x1B[33m",
-  cyan: "\x1B[36m",
-  gray: "\x1B[90m",
-  white: "\x1B[97m"
-};
-function color(str, ...codes) {
-  return process.stdout.isTTY ? codes.join("") + str + C.reset : str;
-}
 function methodBadge(method) {
   const m = method.toUpperCase();
-  const c = m === "GET" ? C.green : m === "POST" ? C.cyan : m === "PUT" || m === "PATCH" ? C.yellow : m === "DELETE" ? C.red : C.white;
-  return color(m.padEnd(7), c, C.bold);
-}
-function parseArgs(argv) {
-  const args = {};
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (!arg.startsWith("--")) continue;
-    const key = arg.slice(2);
-    const next = argv[i + 1];
-    if (!next || next.startsWith("--")) {
-      args[key] = true;
-    } else {
-      if (key === "mask" || key === "ignore") {
-        const existing = args[key];
-        args[key] = Array.isArray(existing) ? [...existing, next] : [next];
-      } else {
-        args[key] = next;
-      }
-      i++;
-    }
-  }
-  return args;
+  const c = m === "GET" ? cliCommon.C.green : m === "POST" ? cliCommon.C.cyan : m === "PUT" || m === "PATCH" ? cliCommon.C.yellow : m === "DELETE" ? cliCommon.C.red : cliCommon.C.white;
+  return cliCommon.color(m.padEnd(7), c, cliCommon.C.bold);
 }
 async function main() {
-  const args = parseArgs(process.argv.slice(2));
+  const args = cliCommon.parseArgs(process.argv.slice(2), ["mask", "ignore"]);
   if (args.help) {
     console.log(
       "\nUsage:\n  api-spector record --upstream <url> [options]\n\nOptions:\n  --upstream <url>    Real API base URL (required)\n  --port <n>          Local port (default: 4001)\n  --output <path>     Output directory (default: ./recordings)\n  --mask <header>     Mask header value with *** (repeatable)\n  --ignore <header>   Omit header from recordings (repeatable)\n"
@@ -56,7 +22,7 @@ async function main() {
   }
   const upstream = args.upstream?.replace(/\/$/, "");
   if (!upstream) {
-    console.error(color("Error: --upstream <url> is required", C.red));
+    console.error(cliCommon.color("Error: --upstream <url> is required", cliCommon.C.red));
     process.exit(1);
   }
   const port = parseInt(args.port ?? "4001", 10);
@@ -66,24 +32,24 @@ async function main() {
   recorder.setRecorderHitCallback((entry) => {
     const { method, path: path2 } = entry.request;
     const { status, binary } = entry.response;
-    const sc = status < 300 ? C.green : status < 400 ? C.cyan : C.red;
-    const st = status > 0 ? color(String(status), sc, C.bold) : color("ERR", C.red, C.bold);
-    const bin = binary ? color(" [binary]", C.yellow) : "";
-    console.log(`  ${methodBadge(method)} ${color(path2, C.white)}  ${st}  ${color(`${entry.durationMs}ms`, C.gray)}${bin}`);
+    const sc = status < 300 ? cliCommon.C.green : status < 400 ? cliCommon.C.cyan : cliCommon.C.red;
+    const st = status > 0 ? cliCommon.color(String(status), sc, cliCommon.C.bold) : cliCommon.color("ERR", cliCommon.C.red, cliCommon.C.bold);
+    const bin = binary ? cliCommon.color(" [binary]", cliCommon.C.yellow) : "";
+    console.log(`  ${methodBadge(method)} ${cliCommon.color(path2, cliCommon.C.white)}  ${st}  ${cliCommon.color(`${entry.durationMs}ms`, cliCommon.C.gray)}${bin}`);
   });
   await recorder.startRecorder({ upstream, port, maskHeaders: extraMask, ignoreHeaders: extraIgnore });
   console.log("");
-  console.log(color("  API Spector — Record Proxy", C.bold, C.white));
-  console.log(color(`  Upstream:  ${upstream}`, C.gray));
-  console.log(color(`  Listening: http://localhost:${port}`, C.cyan));
-  console.log(color(`  Output:    ${outputDir}`, C.gray));
-  console.log(color("  Press Ctrl+C to stop and save recordings.\n", C.dim));
+  console.log(cliCommon.color("  API Spector — Record Proxy", cliCommon.C.bold, cliCommon.C.white));
+  console.log(cliCommon.color(`  Upstream:  ${upstream}`, cliCommon.C.gray));
+  console.log(cliCommon.color(`  Listening: http://localhost:${port}`, cliCommon.C.cyan));
+  console.log(cliCommon.color(`  Output:    ${outputDir}`, cliCommon.C.gray));
+  console.log(cliCommon.color("  Press Ctrl+C to stop and save recordings.\n", cliCommon.C.dim));
   async function shutdown() {
     console.log("");
     const session = recorder.stopRecorder();
     recorder.setRecorderHitCallback(null);
     if (session.entries.length === 0) {
-      console.log(color("  No requests recorded.", C.yellow));
+      console.log(cliCommon.color("  No requests recorded.", cliCommon.C.yellow));
       process.exit(0);
     }
     await promises.mkdir(outputDir, { recursive: true });
@@ -94,9 +60,9 @@ async function main() {
     const mockServer = recorder.entriesToMockServer(session.entries, upstream, mockName, port);
     const mockPath = path.join(outputDir, `session-${slug}.mock.json`);
     await promises.writeFile(mockPath, JSON.stringify(mockServer, null, 2), "utf8");
-    console.log(color(`  Recorded ${session.entries.length} request${session.entries.length !== 1 ? "s" : ""}.`, C.green, C.bold));
-    console.log(color(`  Session:    ${sessionPath}`, C.gray));
-    console.log(color(`  Mock stubs: ${mockPath}`, C.gray));
+    console.log(cliCommon.color(`  Recorded ${session.entries.length} request${session.entries.length !== 1 ? "s" : ""}.`, cliCommon.C.green, cliCommon.C.bold));
+    console.log(cliCommon.color(`  Session:    ${sessionPath}`, cliCommon.C.gray));
+    console.log(cliCommon.color(`  Mock stubs: ${mockPath}`, cliCommon.C.gray));
     console.log("");
     process.exit(0);
   }
@@ -104,6 +70,6 @@ async function main() {
   process.on("SIGTERM", shutdown);
 }
 main().catch((err) => {
-  console.error(color(`Fatal: ${err instanceof Error ? err.message : String(err)}`, "\x1B[31m"));
+  console.error(cliCommon.color(`Fatal: ${err instanceof Error ? err.message : String(err)}`, "\x1B[31m"));
   process.exit(2);
 });