@testsmith/api-spector 0.3.9 → 0.4.1

package/out/main/chunks/{handle-Coax8Nz1.js → handle-BGYDylL2.js}

@@ -3,7 +3,9 @@ const IPC = {
   // ─── Workspace / File ──────────────────────────────────────────────────────
   file: {
     openWorkspace: "file:openWorkspace",
+    openWorkspacePath: "file:openWorkspacePath",
     getLastWorkspace: "file:getLastWorkspace",
+    getRecentWorkspaces: "file:getRecentWorkspaces",
     saveWorkspace: "file:saveWorkspace",
     newWorkspace: "file:newWorkspace",
     closeWorkspace: "file:closeWorkspace",
@@ -153,6 +155,10 @@ const IPC = {
   // ─── Shell ─────────────────────────────────────────────────────────────────
   shell: {
     openExternal: "shell:openExternal"
+  },
+  // ─── App ───────────────────────────────────────────────────────────────────
+  app: {
+    checkUpdate: "app:checkUpdate"
   }
 };
 function handleIpc(ipc, channel, fn) {

package/out/main/chunks/{import-Bilo697Z.js → import-CUcjlmSK.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const uuid = require("uuid");
-const soapHandler = require("./soap-handler-B1Huudj7.js");
-require("./handle-Coax8Nz1.js");
+const soapHandler = require("./soap-handler-CAyUjzxB.js");
+require("./handle-BGYDylL2.js");
 require("https");
 require("http");
 require("@xmldom/xmldom");

package/out/main/chunks/{request-exec-C0DnGKdd.js → request-exec-DlvyG4rn.js}

@@ -23,7 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 const undici = require("undici");
 const promises = require("fs/promises");
-const handle = require("./handle-Coax8Nz1.js");
+const handle = require("./handle-BGYDylL2.js");
 const crypto = require("crypto");
 const path = require("path");
 const dayjs = require("dayjs");

package/out/main/chunks/{snapshots-CatB4zLh.js → snapshots-B7rDeWNy.js}

@@ -1,6 +1,6 @@
 "use strict";
 const undici = require("undici");
-const requestExec = require("./request-exec-C0DnGKdd.js");
+const requestExec = require("./request-exec-DlvyG4rn.js");
 const promises = require("fs/promises");
 const path = require("path");
 const Ajv = require("ajv");

package/out/main/chunks/{soap-handler-B1Huudj7.js → soap-handler-CAyUjzxB.js}

@@ -1,5 +1,5 @@
 "use strict";
-const handle = require("./handle-Coax8Nz1.js");
+const handle = require("./handle-BGYDylL2.js");
 const https = require("https");
 const http = require("http");
 const xmldom = require("@xmldom/xmldom");
@@ -315,7 +315,7 @@ function registerSoapHandlers(ipc) {
   handle.handleIpc(ipc, handle.IPC.wsdl.import, async (_event, opts) => {
     const { validateWsdlImport } = await Promise.resolve().then(() => require("./ipc-validate-k6KI8adf.js"));
     validateWsdlImport(opts);
-    const { importWsdl } = await Promise.resolve().then(() => require("./import-Bilo697Z.js"));
+    const { importWsdl } = await Promise.resolve().then(() => require("./import-CUcjlmSK.js"));
     const wsdlText = opts.xml ?? (opts.url ? await fetchUrl(opts.url) : "");
     if (!wsdlText) throw new Error("wsdl:import requires either `url` or `xml`");
     return importWsdl(wsdlText, { name: opts.name, existingMockPorts: opts.existingMockPorts });

package/out/main/contract.js

@@ -24,14 +24,14 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 const promises = require("fs/promises");
 const path = require("path");
-const snapshots = require("./chunks/snapshots-CatB4zLh.js");
+const snapshots = require("./chunks/snapshots-B7rDeWNy.js");
 const crypto = require("crypto");
 const undici = require("undici");
 const os = require("os");
 const cliCommon = require("./chunks/cli-common-CDQY1erJ.js");
 const environments = require("./chunks/environments-iM3SUM-4.js");
-require("./chunks/request-exec-C0DnGKdd.js");
-require("./chunks/handle-Coax8Nz1.js");
+require("./chunks/request-exec-DlvyG4rn.js");
+require("./chunks/handle-BGYDylL2.js");
 require("dayjs");
 require("vm");
 require("tv4");

package/out/main/index.js

@@ -22,12 +22,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 const electron = require("electron");
-const handle = require("./chunks/handle-Coax8Nz1.js");
+const handle = require("./chunks/handle-BGYDylL2.js");
 const path = require("path");
 const fs = require("fs");
 const promises = require("fs/promises");
 const crypto = require("crypto");
-const requestExec = require("./chunks/request-exec-C0DnGKdd.js");
+const requestExec = require("./chunks/request-exec-DlvyG4rn.js");
 const ipcValidate = require("./chunks/ipc-validate-k6KI8adf.js");
 const uuid = require("uuid");
 const jsYaml = require("js-yaml");
@@ -37,9 +37,9 @@ const requestCollection = require("./chunks/request-collection-CJoXpvOw.js");
 const mockServer = require("./chunks/mock-server-DSLR2ulH.js");
 const http = require("http");
 const WebSocket = require("ws");
-const soapHandler = require("./chunks/soap-handler-B1Huudj7.js");
+const soapHandler = require("./chunks/soap-handler-CAyUjzxB.js");
 const os = require("os");
-const snapshots = require("./chunks/snapshots-CatB4zLh.js");
+const snapshots = require("./chunks/snapshots-B7rDeWNy.js");
 const simpleGit = require("simple-git");
 const recorder = require("./chunks/recorder-0Ij921El.js");
 require("dayjs");
@@ -50,8 +50,29 @@ require("@xmldom/xmldom");
 require("ajv");
 require("https");
 const LAST_WS_FILE = path.join(electron.app.getPath("userData"), "last-workspace.json");
+const RECENTS_FILE = path.join(electron.app.getPath("userData"), "recent-workspaces.json");
+const MAX_RECENTS = 10;
+async function readRecentWorkspaces() {
+  try {
+    const list = JSON.parse(await promises.readFile(RECENTS_FILE, "utf8"));
+    return Array.isArray(list) ? list : [];
+  } catch {
+    return [];
+  }
+}
+async function pushRecentWorkspace(wsPath) {
+  const name = path.basename(wsPath).replace(/\.(spector|json)$/i, "");
+  const list = (await readRecentWorkspaces()).filter((r) => r.path !== wsPath);
+  list.unshift({ path: wsPath, name, lastOpened: Date.now() });
+  try {
+    await promises.writeFile(RECENTS_FILE, JSON.stringify(list.slice(0, MAX_RECENTS), null, 2), "utf8");
+  } catch (err) {
+    console.warn("file-handler: could not update recent-workspaces", err);
+  }
+}
 async function saveLastWorkspacePath(wsPath) {
   await promises.writeFile(LAST_WS_FILE, JSON.stringify({ path: wsPath }), "utf8");
+  await pushRecentWorkspace(wsPath);
 }
 async function readLastWorkspacePath() {
   try {
@@ -380,6 +401,33 @@ Create a workspace in this folder and add "${path.basename(wsPath)}" to it? The
       return null;
     }
   });
+  handle.handleIpc(ipc, handle.IPC.file.getRecentWorkspaces, async () => {
+    const list = await readRecentWorkspaces();
+    const alive = await Promise.all(list.map(async (r) => {
+      try {
+        await promises.readFile(r.path, "utf8");
+        return r;
+      } catch {
+        return null;
+      }
+    }));
+    return alive.filter((r) => r !== null);
+  });
+  handle.handleIpc(ipc, handle.IPC.file.openWorkspacePath, async (_e, wsPath) => {
+    let raw;
+    try {
+      raw = await promises.readFile(wsPath, "utf8");
+    } catch {
+      return null;
+    }
+    const parsed = JSON.parse(raw);
+    if (looksLikeCollection(parsed)) return null;
+    workspaceDir = path.dirname(wsPath);
+    workspaceFile = wsPath;
+    await requestExec.loadGlobals(workspaceDir);
+    await saveLastWorkspacePath(wsPath);
+    return { workspace: parsed, workspacePath: wsPath };
+  });
 }
 async function tryOpenWorkspaceInDir(dir) {
   let entries;
@@ -475,6 +523,19 @@ function formatRequestError(err, context) {
   if (causeMessage) {
     lines.push(`[request:send] cause=${causeMessage}${causeCode ? ` (code=${causeCode})` : ""}`);
   }
+  const certCodes = /* @__PURE__ */ new Set([
+    "SELF_SIGNED_CERT_IN_CHAIN",
+    "DEPTH_ZERO_SELF_SIGNED_CERT",
+    "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+    "UNABLE_TO_GET_ISSUER_CERT_LOCALLY",
+    "CERT_HAS_EXPIRED",
+    "ERR_TLS_CERT_ALTNAME_INVALID"
+  ]);
+  if (certCodes.has(code ?? "") || certCodes.has(causeCode ?? "")) {
+    lines.push(
+      '[request:send] hint=A self-signed or untrusted TLS certificate was rejected. Uncheck "Reject unauthorized / self-signed certificates" in Collection or Workspace settings, which also relaxes verification for the proxy connection, or add the CA certificate under TLS settings.'
+    );
+  }
   if (stack) {
     const preview = stack.split("\n").slice(0, 6).join("\n");
     lines.push("[request:send] stack:");
@@ -1470,12 +1531,12 @@ function toRequestBody(bodyText, headers) {
   return { mode: "raw", raw: bodyText, rawContentType: ct || "text/plain" };
 }
 function extractAuth(headers) {
-  const authHeader = headers.find((h) => h.key.toLowerCase() === "authorization");
-  if (authHeader) {
-    const bearer = /^Bearer\s+(.+)$/i.exec(authHeader.value.trim());
+  const authHeader2 = headers.find((h) => h.key.toLowerCase() === "authorization");
+  if (authHeader2) {
+    const bearer = /^Bearer\s+(.+)$/i.exec(authHeader2.value.trim());
     if (bearer) {
       return {
-        headers: headers.filter((h) => h !== authHeader),
+        headers: headers.filter((h) => h !== authHeader2),
         auth: { type: "bearer", token: bearer[1].trim() }
       };
     }
@@ -3965,10 +4026,10 @@ function generateKarate(collection, environment) {
   files.unshift({ path: "README.md", content: buildReadme(collection.name, files.map((f) => f.path)) });
   return files;
 }
-function mapOut(s) {
+function mapOut$1(s) {
   return s.replace(/\{\{\s*(\$[A-Za-z]+)\s*\}\}/g, (_m, name) => `{{${SPECTOR_TO_HTTP[name] ?? name}}}`);
 }
-function orderedRequests(collection) {
+function orderedRequests$1(collection) {
   const out = [];
   const walk = (folder) => {
     for (const id of folder.requestIds) {
@@ -3998,7 +4059,7 @@ function authToHeader(auth) {
       return null;
   }
 }
-function buildUrl(req) {
+function buildUrl$1(req) {
   const query = (req.params ?? []).filter((p) => p.enabled && p.key && p.paramType !== "path");
   if (req.auth.type === "apikey" && req.auth.apiKeyIn === "query" && req.auth.apiKeyName) {
     query.push({ key: req.auth.apiKeyName, value: req.auth.apiKeyValue ?? "", enabled: true });
@@ -4036,33 +4097,141 @@ function generateHttpFile(collection, environment) {
   Object.assign(vars, collection.collectionVariables ?? {});
   const varKeys = Object.keys(vars);
   if (varKeys.length) {
-    for (const k of varKeys) lines.push(`@${k} = ${mapOut(vars[k])}`);
+    for (const k of varKeys) lines.push(`@${k} = ${mapOut$1(vars[k])}`);
     lines.push("");
   }
-  orderedRequests(collection).forEach((req, idx) => {
+  orderedRequests$1(collection).forEach((req, idx) => {
     if (idx > 0) lines.push("");
     lines.push(`### ${req.name}`);
     if (req.description?.trim()) {
       for (const l of req.description.trim().split(/\r?\n/)) lines.push(`# ${l}`);
     }
-    lines.push(`${req.method} ${mapOut(buildUrl(req))}`);
+    lines.push(`${req.method} ${mapOut$1(buildUrl$1(req))}`);
     const headers = [...(req.headers ?? []).filter((h) => h.enabled && h.key)];
-    const authHeader = authToHeader(req.auth);
-    if (authHeader) headers.unshift(authHeader);
+    const authHeader2 = authToHeader(req.auth);
+    if (authHeader2) headers.unshift(authHeader2);
     const body = bodyLines(req);
     const hasCT = headers.some((h) => h.key.toLowerCase() === "content-type");
     if (body.text && body.contentType && !hasCT) {
       headers.push({ key: "Content-Type", value: body.contentType, enabled: true });
     }
-    for (const h of headers) lines.push(`${h.key}: ${mapOut(h.value)}`);
+    for (const h of headers) lines.push(`${h.key}: ${mapOut$1(h.value)}`);
     if (body.text) {
       lines.push("");
-      lines.push(mapOut(body.text));
+      lines.push(mapOut$1(body.text));
     }
   });
   const slug2 = collection.name.replace(/\W+/g, "-").replace(/^-+|-+$/g, "").toLowerCase() || "collection";
   return [{ path: `${slug2}.http`, content: lines.join("\n") + "\n" }];
 }
+function mapOut(s) {
+  return s.replace(/\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g, (_m, name) => `\${${name}}`);
+}
+function shq(s) {
+  return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+function dq(s) {
+  return `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function orderedRequests(collection) {
+  const out = [];
+  const walk = (folder) => {
+    for (const id of folder.requestIds) {
+      const req = collection.requests[id];
+      if (req) out.push(req);
+    }
+    for (const sub of folder.folders) walk(sub);
+  };
+  walk(collection.rootFolder);
+  return out;
+}
+function authHeader(auth) {
+  switch (auth.type) {
+    case "bearer":
+      return auth.token ? { key: "Authorization", value: `Bearer ${auth.token}`, enabled: true } : null;
+    case "apikey":
+      if (auth.apiKeyIn === "query") return null;
+      return auth.apiKeyName ? { key: auth.apiKeyName, value: auth.apiKeyValue ?? "", enabled: true } : null;
+    default:
+      return null;
+  }
+}
+function buildUrl(req) {
+  const query = (req.params ?? []).filter((p) => p.enabled && p.key && p.paramType !== "path");
+  if (req.auth.type === "apikey" && req.auth.apiKeyIn === "query" && req.auth.apiKeyName) {
+    query.push({ key: req.auth.apiKeyName, value: req.auth.apiKeyValue ?? "", enabled: true });
+  }
+  if (!query.length) return req.url;
+  const qs = query.map((p) => `${p.key}=${p.value}`).join("&");
+  return req.url + (req.url.includes("?") ? "&" : "?") + qs;
+}
+function bodyOf(req) {
+  const b = req.body;
+  switch (b.mode) {
+    case "json":
+      return { contentType: "application/json", text: b.json ?? "" };
+    case "graphql":
+      return { contentType: "application/json", text: JSON.stringify({ query: b.graphql?.query ?? "", variables: b.graphql?.variables ? safeParse(b.graphql.variables) : void 0 }) };
+    case "soap":
+      return { contentType: "text/xml", text: b.soap?.envelope ?? "" };
+    case "raw":
+      return { contentType: b.rawContentType, text: b.raw ?? "" };
+    case "form":
+      return {
+        contentType: "application/x-www-form-urlencoded",
+        text: (b.form ?? []).filter((f) => f.enabled && f.key).map((f) => `${f.key}=${f.value}`).join("&")
+      };
+    default:
+      return {};
+  }
+}
+function safeParse(s) {
+  try {
+    return JSON.parse(s);
+  } catch {
+    return s;
+  }
+}
+function generateCurl(collection, environment) {
+  const lines = ["#!/usr/bin/env bash", "set -euo pipefail", ""];
+  const vars = {};
+  for (const v of environment?.variables ?? []) {
+    if (v.enabled && !v.secret) vars[v.key] = v.value;
+  }
+  Object.assign(vars, collection.collectionVariables ?? {});
+  const varKeys = Object.keys(vars);
+  if (varKeys.length) {
+    lines.push("# Variables (override via the environment before running)");
+    for (const k of varKeys) lines.push(`${k}=${shq(vars[k])}`);
+    lines.push("");
+  }
+  orderedRequests(collection).forEach((req, idx) => {
+    if (idx > 0) lines.push("");
+    lines.push(`# ${req.name}`);
+    if (req.description?.trim()) {
+      for (const l of req.description.trim().split(/\r?\n/)) lines.push(`# ${l}`);
+    }
+    const args = [`curl -sS -X ${req.method} ${dq(mapOut(buildUrl(req)))}`];
+    if (req.auth.type === "basic") {
+      const user = mapOut(req.auth.username ?? "");
+      const pass = mapOut(req.auth.password ?? "");
+      args.push(`-u ${dq(`${user}:${pass}`)}`);
+    }
+    const headers = [...(req.headers ?? []).filter((h) => h.enabled && h.key)];
+    const ah = authHeader(req.auth);
+    if (ah) headers.unshift(ah);
+    const body = bodyOf(req);
+    const hasCT = headers.some((h) => h.key.toLowerCase() === "content-type");
+    if (body.text && body.contentType && !hasCT) {
+      headers.push({ key: "Content-Type", value: body.contentType, enabled: true });
+    }
+    for (const h of headers) args.push(`-H ${dq(`${h.key}: ${mapOut(h.value)}`)}`);
+    if (body.text) args.push(`--data ${dq(mapOut(body.text))}`);
+    lines.push(args.join(" \\\n  "));
+  });
+  const slug2 = collection.name.replace(/\W+/g, "-").replace(/^-+|-+$/g, "").toLowerCase() || "collection";
+  return [{ path: `${slug2}.sh`, content: lines.join("\n") + "\n" }];
+}
 function registerGenerateHandlers(ipc) {
   handle.handleIpc(ipc, handle.IPC.generate.code, (_e, opts) => {
     const { collection, environment, target } = opts;
@@ -4083,6 +4252,8 @@ function registerGenerateHandlers(ipc) {
         return generateKarate(collection, environment);
       case "http_file":
         return generateHttpFile(collection, environment);
+      case "curl":
+        return generateCurl(collection, environment);
       default:
         throw new Error(`Unknown target: ${target}`);
     }
@@ -4993,6 +5164,33 @@ function registerRecordHandlers(ipc, getWebContents) {
     return recorder.entriesToMockServer(entries, upstream, name, port);
   });
 }
+const REGISTRY_URL = "https://registry.npmjs.org/@testsmith/api-spector/latest";
+function isNewer(a, b) {
+  const core = (v) => v.split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
+  const [a0, a1, a2] = core(a);
+  const [b0, b1, b2] = core(b);
+  if (a0 !== b0) return a0 > b0;
+  if (a1 !== b1) return a1 > b1;
+  return a2 > b2;
+}
+async function checkForUpdate() {
+  const current = "0.4.1";
+  try {
+    const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(4e3) });
+    if (!res.ok) return null;
+    const data = await res.json();
+    const latest = data.version;
+    if (!latest) return null;
+    return {
+      current,
+      latest,
+      updateAvailable: isNewer(latest, current),
+      command: "npm update -g @testsmith/api-spector"
+    };
+  } catch {
+    return null;
+  }
+}
 if (process.env.ELECTRON_NO_SANDBOX === "1") {
   electron.app.commandLine.appendSwitch("no-sandbox");
   electron.app.commandLine.appendSwitch("disable-features", "RendererCodeIntegrity");
@@ -5097,6 +5295,7 @@ electron.app.whenReady().then(async () => {
   registerGitHandlers(electron.ipcMain);
   registerRecordHandlers(electron.ipcMain, () => electron.BrowserWindow.getAllWindows()[0]?.webContents ?? null);
   handle.handleIpc(electron.ipcMain, handle.IPC.shell.openExternal, (_e, url) => electron.shell.openExternal(url));
+  handle.handleIpc(electron.ipcMain, handle.IPC.app.checkUpdate, () => checkForUpdate());
   createWindow();
   electron.app.on("activate", () => {
     if (electron.BrowserWindow.getAllWindows().length === 0) createWindow();

package/out/main/runner.js

@@ -2,12 +2,12 @@
 "use strict";
 const promises = require("fs/promises");
 const path = require("path");
-const requestExec = require("./chunks/request-exec-C0DnGKdd.js");
+const requestExec = require("./chunks/request-exec-DlvyG4rn.js");
 const requestCollection = require("./chunks/request-collection-CJoXpvOw.js");
 const environments = require("./chunks/environments-iM3SUM-4.js");
 const cliCommon = require("./chunks/cli-common-CDQY1erJ.js");
 require("undici");
-require("./chunks/handle-Coax8Nz1.js");
+require("./chunks/handle-BGYDylL2.js");
 require("crypto");
 require("dayjs");
 require("vm");
@@ -396,7 +396,7 @@ async function main() {
   } else if (!envName && workspace.settings?.defaultEnvironment && !env) {
     console.warn(cliCommon.color(`Warning: default environment "${workspace.settings.defaultEnvironment}" not found. Running without environment.`, cliCommon.C.yellow));
   }
-  const version = `v${"0.3.9"}`;
+  const version = `v${"0.4.1"}`;
   console.log("");
   console.log(cliCommon.color("  API Test Runner" + (version ? ` ${version}` : ""), cliCommon.C.bold, cliCommon.C.white));
   console.log(cliCommon.color(`  Workspace:   ${wsPath}`, cliCommon.C.gray));

package/out/main/wsdl.js

@@ -4,10 +4,10 @@ const promises = require("fs/promises");
 const path = require("path");
 const https = require("https");
 const http = require("http");
-const soapHandler = require("./chunks/soap-handler-B1Huudj7.js");
-const _import = require("./chunks/import-Bilo697Z.js");
+const soapHandler = require("./chunks/soap-handler-CAyUjzxB.js");
+const _import = require("./chunks/import-CUcjlmSK.js");
 const cliCommon = require("./chunks/cli-common-CDQY1erJ.js");
-require("./chunks/handle-Coax8Nz1.js");
+require("./chunks/handle-BGYDylL2.js");
 require("@xmldom/xmldom");
 require("uuid");
 function fetchUrl(url) {

package/out/preload/index.js

@@ -4,7 +4,9 @@ const IPC = {
   // ─── Workspace / File ──────────────────────────────────────────────────────
   file: {
     openWorkspace: "file:openWorkspace",
+    openWorkspacePath: "file:openWorkspacePath",
     getLastWorkspace: "file:getLastWorkspace",
+    getRecentWorkspaces: "file:getRecentWorkspaces",
     saveWorkspace: "file:saveWorkspace",
     newWorkspace: "file:newWorkspace",
     closeWorkspace: "file:closeWorkspace",
@@ -154,12 +156,18 @@ const IPC = {
   // ─── Shell ─────────────────────────────────────────────────────────────────
   shell: {
     openExternal: "shell:openExternal"
+  },
+  // ─── App ───────────────────────────────────────────────────────────────────
+  app: {
+    checkUpdate: "app:checkUpdate"
   }
 };
 const api = {
   // ─── Workspace / File ──────────────────────────────────────────────────────
   openWorkspace: () => electron.ipcRenderer.invoke(IPC.file.openWorkspace),
   getLastWorkspace: () => electron.ipcRenderer.invoke(IPC.file.getLastWorkspace),
+  getRecentWorkspaces: () => electron.ipcRenderer.invoke(IPC.file.getRecentWorkspaces),
+  openWorkspacePath: (path) => electron.ipcRenderer.invoke(IPC.file.openWorkspacePath, path),
   saveWorkspace: (ws) => electron.ipcRenderer.invoke(IPC.file.saveWorkspace, ws),
   newWorkspace: () => electron.ipcRenderer.invoke(IPC.file.newWorkspace),
   closeWorkspace: () => electron.ipcRenderer.invoke(IPC.file.closeWorkspace),
@@ -297,6 +305,7 @@ const api = {
   },
   // ─── Shell ────────────────────────────────────────────────────────────────
   openExternal: (url) => electron.ipcRenderer.invoke(IPC.shell.openExternal, url),
+  checkForUpdate: () => electron.ipcRenderer.invoke(IPC.app.checkUpdate),
   // ─── Zoom ─────────────────────────────────────────────────────────────────
   setZoomFactor: (factor) => electron.webFrame.setZoomFactor(factor),
   // ─── Platform ─────────────────────────────────────────────────────────────