@testsmith/api-spector 0.2.3 → 0.2.4

package/out/main/wsdl.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+"use strict";
+const promises = require("fs/promises");
+const path = require("path");
+const https = require("https");
+const http = require("http");
+const soapHandler = require("./chunks/soap-handler-Cpj-JwyA.js");
+const _import = require("./chunks/import-C9qdkBCH.js");
+require("@xmldom/xmldom");
+require("uuid");
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      const key = arg.slice(2);
+      const next = argv[i + 1];
+      if (!next || next.startsWith("--")) {
+        args[key] = true;
+      } else {
+        args[key] = next;
+        i++;
+      }
+    }
+  }
+  return args;
+}
+function fetchUrl(url) {
+  return new Promise((resolveP, rejectP) => {
+    const lib = url.startsWith("https") ? https : http;
+    const req = lib.get(url, (res) => {
+      const chunks = [];
+      res.on("data", (c) => chunks.push(c));
+      res.on("end", () => resolveP(Buffer.concat(chunks).toString("utf8")));
+      res.on("error", rejectP);
+    });
+    req.on("error", rejectP);
+    req.setTimeout(15e3, () => {
+      req.destroy();
+      rejectP(new Error("WSDL fetch timed out"));
+    });
+  });
+}
+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)), file: resolved };
+}
+async function ensureDir(dir) {
+  await promises.mkdir(dir, { recursive: true });
+}
+async function cmdDescribe(args) {
+  const url = typeof args["url"] === "string" ? args["url"] : void 0;
+  if (!url) {
+    console.error("  [error] --url <wsdlUrl> is required");
+    process.exit(2);
+  }
+  const wsdlText = await fetchUrl(url);
+  const parsed = soapHandler.parseWsdl(wsdlText);
+  console.log("");
+  console.log(`  Target namespace: ${parsed.targetNamespace || "(none)"}`);
+  if (parsed.endpoints.length) {
+    console.log("  Endpoints:");
+    for (const e of parsed.endpoints) {
+      console.log(`    [${e.soapVersion}] ${e.binding}  →  ${e.address}`);
+    }
+  }
+  console.log("");
+  if (parsed.operations.length === 0) {
+    console.log("  No operations found.");
+    return;
+  }
+  console.log("  Operation                             Ver   SOAPAction");
+  console.log("  ───────────────────────────────────── ───── ──────────────────────────────");
+  for (const op of parsed.operations) {
+    const name = op.name.slice(0, 37).padEnd(37);
+    const ver = op.soapVersion.padEnd(5);
+    const sa = (op.soapAction ?? "—").slice(0, 30);
+    console.log(`  ${name} ${ver} ${sa}`);
+  }
+  console.log("");
+}
+async function loadExistingMockPorts(workspace, dir) {
+  const ports = [];
+  for (const relPath of workspace.mocks ?? []) {
+    try {
+      const raw = await promises.readFile(path.join(dir, relPath), "utf8");
+      const m = JSON.parse(raw);
+      if (typeof m.port === "number") ports.push(m.port);
+    } catch {
+    }
+  }
+  return ports;
+}
+async function cmdImportCollection(args) {
+  const url = typeof args["url"] === "string" ? args["url"] : void 0;
+  const wsArg = typeof args["workspace"] === "string" ? args["workspace"] : void 0;
+  if (!url) {
+    console.error("  [error] --url <wsdlUrl> is required");
+    process.exit(2);
+  }
+  if (!wsArg) {
+    console.error("  [error] --workspace <path> is required");
+    process.exit(2);
+  }
+  const wsdlText = await fetchUrl(url);
+  const { workspace, dir, file } = await loadWorkspace(wsArg);
+  const name = typeof args["name"] === "string" ? args["name"] : void 0;
+  const { collection } = _import.importWsdl(wsdlText, { name });
+  const relPath = _import.defaultCollectionRelPath(workspace, collection);
+  const fullPath = path.resolve(dir, relPath);
+  await ensureDir(path.dirname(fullPath));
+  await promises.writeFile(fullPath, JSON.stringify(collection, null, 2), "utf8");
+  workspace.collections.push(relPath);
+  await promises.writeFile(file, JSON.stringify(workspace, null, 2), "utf8");
+  console.log(`  ✓ Wrote ${relPath} (${Object.keys(collection.requests).length} requests)`);
+}
+async function cmdImportMock(args) {
+  const url = typeof args["url"] === "string" ? args["url"] : void 0;
+  const wsArg = typeof args["workspace"] === "string" ? args["workspace"] : void 0;
+  if (!url) {
+    console.error("  [error] --url <wsdlUrl> is required");
+    process.exit(2);
+  }
+  if (!wsArg) {
+    console.error("  [error] --workspace <path> is required");
+    process.exit(2);
+  }
+  const wsdlText = await fetchUrl(url);
+  const { workspace, dir, file } = await loadWorkspace(wsArg);
+  const existingPorts = await loadExistingMockPorts(workspace, dir);
+  const name = typeof args["name"] === "string" ? args["name"] : void 0;
+  const { mock } = _import.importWsdl(wsdlText, { name, existingMockPorts: existingPorts });
+  const relPath = _import.defaultMockRelPath(mock);
+  const fullPath = path.resolve(dir, relPath);
+  await ensureDir(path.dirname(fullPath));
+  await promises.writeFile(fullPath, JSON.stringify(mock, null, 2), "utf8");
+  if (!workspace.mocks) workspace.mocks = [];
+  workspace.mocks.push(relPath);
+  await promises.writeFile(file, JSON.stringify(workspace, null, 2), "utf8");
+  console.log(`  ✓ Wrote ${relPath} on port ${mock.port} (${mock.routes.length} dispatch route${mock.routes.length === 1 ? "" : "s"})`);
+  if (args["start"] === true) {
+    console.log("  [note] --start is not supported in CLI mode; launch the mock from the app.");
+  }
+}
+async function main() {
+  const [, , sub, ...rest] = process.argv;
+  const args = parseArgs(rest);
+  if (sub === "describe") return cmdDescribe(args);
+  if (sub === "import-collection") return cmdImportCollection(args);
+  if (sub === "import-mock") return cmdImportMock(args);
+  if (args["help"] || !sub) {
+    console.log(`
+  api-spector wsdl describe          --url <wsdlUrl>
+  api-spector wsdl import-collection --workspace <path> --url <wsdlUrl> [--name <label>]
+  api-spector wsdl import-mock       --workspace <path> --url <wsdlUrl> [--name <label>]
+`);
+    return;
+  }
+  console.error(`  [error] Unknown subcommand "${sub}"`);
+  process.exit(2);
+}
+main().catch((e) => {
+  console.error(`  [error] ${e instanceof Error ? e.message : String(e)}`);
+  process.exit(1);
+});

package/out/preload/index.js

@@ -11,6 +11,10 @@ const api = {
   saveCollection: (relPath, col) => electron.ipcRenderer.invoke("file:saveCollection", relPath, col),
   loadEnvironment: (relPath) => electron.ipcRenderer.invoke("file:loadEnvironment", relPath),
   saveEnvironment: (relPath, env) => electron.ipcRenderer.invoke("file:saveEnvironment", relPath, env),
+  /** Idempotent unlink of a workspace-relative file. Used by collection /
+   *  environment / mock delete flows so the file is removed from disk, not
+   *  just from the workspace manifest. */
+  deleteWorkspaceFile: (relPath) => electron.ipcRenderer.invoke("file:deleteWorkspaceFile", relPath),
   // ─── HTTP execution ────────────────────────────────────────────────────────
   sendRequest: (payload) => electron.ipcRenderer.invoke("request:send", payload),
   // ─── Secrets (encrypted, master-key-based) ───────────────────────────────
@@ -78,6 +82,9 @@ const api = {
   },
   // ─── SOAP / WSDL ──────────────────────────────────────────────────────────
   wsdlFetch: (url, extraHeaders) => electron.ipcRenderer.invoke("wsdl:fetch", url, extraHeaders ?? {}),
+  /** Build a Collection + MockServer from a WSDL. Renderer registers the
+   *  returned objects via the usual loadCollection/loadMock + save flows. */
+  wsdlImport: (opts) => electron.ipcRenderer.invoke("wsdl:import", opts),
   // ─── Docs generation ──────────────────────────────────────────────────────
   generateDocs: (payload) => electron.ipcRenderer.invoke("docs:generate", payload),
   // ─── Contract testing ─────────────────────────────────────────────────────
@@ -102,6 +109,7 @@ const api = {
   gitLog: (limit) => electron.ipcRenderer.invoke("git:log", limit),
   gitBranches: () => electron.ipcRenderer.invoke("git:branches"),
   gitCheckout: (branch, create) => electron.ipcRenderer.invoke("git:checkout", branch, create),
+  gitDeleteBranch: (name, force = false) => electron.ipcRenderer.invoke("git:deleteBranch", name, force),
   gitPull: () => electron.ipcRenderer.invoke("git:pull"),
   gitPush: (setUpstream) => electron.ipcRenderer.invoke("git:push", setUpstream),
   gitRemotes: () => electron.ipcRenderer.invoke("git:remotes"),