@testsmith/api-spector 0.2.2 → 0.2.4

package/out/main/mock.js

@@ -2,7 +2,7 @@
 "use strict";
 const promises = require("fs/promises");
 const path = require("path");
-const mockServer = require("./chunks/mock-server-Cx-xG4pJ.js");
+const mockServer = require("./chunks/mock-server-DmdvwCgj.js");
 require("http");
 require("crypto");
 require("vm");

package/out/main/runner.js

@@ -3,7 +3,8 @@
 const promises = require("fs/promises");
 const path = require("path");
 const undici = require("undici");
-const requestCollection = require("./chunks/request-collection-Dx0ZqB54.js");
+const authBuilder = require("./chunks/auth-builder-B7-LgcGr.js");
+const requestCollection = require("./chunks/request-collection-DIsjTggj.js");
 require("crypto");
 require("dayjs");
 require("vm");
@@ -11,6 +12,7 @@ require("tv4");
 require("jsonpath-plus");
 require("@xmldom/xmldom");
 require("ajv");
+require("./chunks/ipc-validate-CscN4HfG.js");
 function buildJsonReport(results, summary, meta = {}) {
   return JSON.stringify({
     timestamp: meta.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
@@ -266,7 +268,7 @@ function buildHtmlReport(results, summary, meta = {}) {
     const html = document.documentElement
     const isLight = html.classList.toggle('light')
     document.getElementById('themeBtn').textContent = isLight ? '🌙' : '☀️'
-    try { localStorage.setItem('theme', isLight ? 'light' : 'dark') } catch {}
+    try { localStorage.setItem('theme', isLight ? 'light' : 'dark') } catch {} /* private mode / quota — non-fatal */
   }
   // Restore saved preference or respect OS preference
   (function() {
@@ -276,7 +278,7 @@ function buildHtmlReport(results, summary, meta = {}) {
         document.documentElement.classList.add('light')
         document.getElementById('themeBtn').textContent = '🌙'
       }
-    } catch {}
+    } catch {} /* private mode / quota — non-fatal */
   })()
 <\/script>
 </body>
@@ -417,10 +419,10 @@ async function executeRequest(req, collectionVars, envVars, globals, localVars,
   let updatedCollectionVars = { ...collectionVars };
   let updatedGlobals = { ...globals };
   let preScriptError;
-  const dynamicVars = await requestCollection.buildDynamicVars();
-  let vars = requestCollection.mergeVars(envVars, collectionVars, globals, localVars, dynamicVars);
+  const dynamicVars = await authBuilder.buildDynamicVars();
+  let vars = authBuilder.mergeVars(envVars, collectionVars, globals, localVars, dynamicVars);
   if (req.preRequestScript?.trim()) {
-    const r = await requestCollection.runScript(requestCollection.interpolate(req.preRequestScript, vars), {
+    const r = await requestCollection.runScript(authBuilder.interpolate(req.preRequestScript, vars), {
       envVars: { ...envVars },
       collectionVars: { ...collectionVars },
       globals: { ...globals },
@@ -436,36 +438,36 @@ async function executeRequest(req, collectionVars, envVars, globals, localVars,
     if (verbose && r.consoleOutput.length) r.consoleOutput.forEach((l) => console.log(color(`    [pre] ${l}`, C.gray)));
     if (r.error) console.error(color(`    [pre-script error] ${r.error}`, C.red));
   }
-  vars = requestCollection.mergeVars(updatedEnvVars, updatedCollectionVars, updatedGlobals, localVars, dynamicVars);
-  const resolvedUrl = requestCollection.buildUrl(req.url, req.params, vars);
+  vars = authBuilder.mergeVars(updatedEnvVars, updatedCollectionVars, updatedGlobals, localVars, dynamicVars);
+  const resolvedUrl = authBuilder.buildUrl(req.url, req.params, vars);
   base.resolvedUrl = resolvedUrl;
   const start = Date.now();
   try {
     const authH = {};
     if (req.auth.type === "bearer") {
       let token = req.auth.token ?? "";
-      if (!token && req.auth.tokenSecretRef) token = await requestCollection.getSecret(req.auth.tokenSecretRef) ?? "";
-      if (token) authH["Authorization"] = `Bearer ${requestCollection.interpolate(token, vars)}`;
+      if (!token && req.auth.tokenSecretRef) token = await authBuilder.getSecret(req.auth.tokenSecretRef) ?? "";
+      if (token) authH["Authorization"] = `Bearer ${authBuilder.interpolate(token, vars)}`;
     }
     const headers = new undici.Headers();
     for (const h of req.headers) {
-      if (h.enabled && h.key) headers.set(requestCollection.interpolate(h.key, vars), requestCollection.interpolate(h.value, vars));
+      if (h.enabled && h.key) headers.set(authBuilder.interpolate(h.key, vars), authBuilder.interpolate(h.value, vars));
     }
     for (const [k, v] of Object.entries(authH)) headers.set(k, v);
     let body;
     if (req.body.mode === "json" && req.body.json) {
-      body = requestCollection.interpolate(req.body.json, vars);
+      body = authBuilder.interpolate(req.body.json, vars);
       if (!headers.has("content-type")) headers.set("Content-Type", "application/json");
     } else if (req.body.mode === "raw" && req.body.raw) {
-      body = requestCollection.interpolate(req.body.raw, vars);
+      body = authBuilder.interpolate(req.body.raw, vars);
       if (!headers.has("content-type")) headers.set("Content-Type", req.body.rawContentType ?? "text/plain");
     } else if (req.body.mode === "graphql" && req.body.graphql) {
       const gql = req.body.graphql;
-      const gqlBody = { query: requestCollection.interpolate(gql.query, vars) };
+      const gqlBody = { query: authBuilder.interpolate(gql.query, vars) };
       const rawVars = gql.variables?.trim();
       if (rawVars) {
         try {
-          gqlBody.variables = JSON.parse(requestCollection.interpolate(rawVars, vars));
+          gqlBody.variables = JSON.parse(authBuilder.interpolate(rawVars, vars));
         } catch {
         }
       }
@@ -498,7 +500,7 @@ async function executeRequest(req, collectionVars, envVars, globals, localVars,
     let consoleOutput = [];
     let postScriptError;
     if (req.postRequestScript?.trim()) {
-      const r = await requestCollection.runScript(requestCollection.interpolate(req.postRequestScript, vars), {
+      const r = await requestCollection.runScript(authBuilder.interpolate(req.postRequestScript, vars), {
         envVars: updatedEnvVars,
         collectionVars: updatedCollectionVars,
         globals: updatedGlobals,
@@ -626,7 +628,7 @@ async function main() {
   console.log(color(`  Environment: ${env?.name ?? "(none)"}`, C.gray));
   if (filterTags.length) console.log(color(`  Tags:        ${filterTags.join(", ")}`, C.gray));
   console.log("");
-  const envVarsSnapshot = await requestCollection.buildEnvVars(env);
+  const envVarsSnapshot = await authBuilder.buildEnvVars(env);
   const secretValuesToMask = (env?.variables ?? []).filter((v) => v.secret && v.enabled).map((v) => envVarsSnapshot[v.key]).filter((v) => typeof v === "string" && v.length > 0);
   function redact(s) {
     let out = s;
@@ -656,7 +658,7 @@ async function main() {
     const items = requestCollection.collectTagged(col.rootFolder, col.requests, col.collectionVariables ?? {}, filterTags);
     if (items.length === 0) continue;
     if (!firstColName) firstColName = col.name;
-    let runEnvVars = await requestCollection.buildEnvVars(env);
+    let runEnvVars = await authBuilder.buildEnvVars(env);
     let runGlobals = requestCollection.getGlobals();
     let runCollectionVars = { ...col.collectionVariables ?? {} };
     let runLocalVars = {};

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,11 +82,18 @@ 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 ─────────────────────────────────────────────────────
   runContracts: (payload) => electron.ipcRenderer.invoke("contract:run", payload),
   inferContractSchema: (jsonBody) => electron.ipcRenderer.invoke("contract:inferSchema", jsonBody),
+  captureContractSnapshot: (opts) => electron.ipcRenderer.invoke("contract:captureSnapshot", opts),
+  listContractSnapshots: (registered = []) => electron.ipcRenderer.invoke("contract:listSnapshots", registered),
+  loadContractSnapshot: (relPath) => electron.ipcRenderer.invoke("contract:loadSnapshot", relPath),
+  deleteContractSnapshot: (relPath) => electron.ipcRenderer.invoke("contract:deleteSnapshot", relPath),
   // ─── Script hooks ─────────────────────────────────────────────────────────
   runScriptHook: (payload) => electron.ipcRenderer.invoke("script:run-hook", payload),
   // ─── Git ──────────────────────────────────────────────────────────────────
@@ -98,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"),