@jshookmcp/jshook 0.2.5 → 0.2.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jshookmcp/jshook",
-  "version": "0.2.5",
-  "description": "MCP server with 327 built-in tools across 23 domains for AI-assisted JavaScript analysis and security analysis — browser automation, CDP debugging, network monitoring, JS hooks, code analysis, and workflow orchestration",
+  "version": "0.2.7",
+  "description": "MCP server with built-in tools across multiple domains for AI-assisted JavaScript analysis and security analysis — browser automation, CDP debugging, network monitoring, JS hooks, code analysis, and workflow orchestration",
   "keywords": [
     "ai",
     "anti-detection",
@@ -40,8 +40,8 @@
     "url": "https://github.com/vmoranv/jshookmcp.git"
   },
   "bin": {
-    "jshook": "dist/src/index.js",
-    "jshookmcp": "dist/src/index.js"
+    "jshook": "dist/index.mjs",
+    "jshookmcp": "dist/index.mjs"
   },
   "files": [
     "dist",
@@ -50,103 +50,136 @@
     "scripts/postinstall.cjs"
   ],
   "type": "module",
-  "main": "dist/src/index.js",
-  "types": "dist/src/index.d.ts",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
     },
     "./plugin-api": {
-      "import": "./dist/src/server/plugin-api.js",
-      "types": "./dist/src/server/plugin-api.d.ts"
+      "import": "./dist/server/plugin-api.mjs",
+      "types": "./dist/server/plugin-api.d.mts"
     }
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "scripts": {
+    "build": "node scripts/clean-dist.mjs && node scripts/generate-domains-index.mjs && tsdown && corepack pnpm -C packages/extension-sdk build",
+    "typecheck": "tsc --noEmit -p tsconfig.json && corepack pnpm -C packages/extension-sdk typecheck",
+    "deps:update": "corepack pnpm update -r",
+    "dev": "tsx --conditions=development watch src/index.ts",
+    "start": "node dist/index.mjs",
+    "doctor": "tsx src/cli/doctor.ts",
+    "docs:generate": "node scripts/generate-vitepress-reference.mjs",
+    "docs:dev": "vitepress dev docs --host 127.0.0.1 --port 5173",
+    "docs:build": "corepack pnpm run docs:generate && vitepress build docs",
+    "docs:preview": "vitepress preview docs --host 127.0.0.1 --port 4173",
+    "lint:md": "corepack pnpm dlx markdownlint-cli2 README.md README.zh.md CONTRIBUTING.md docs/**/*.md",
+    "lint": "oxlint src/ tests/",
+    "lint:fix": "oxlint --fix src/ tests/",
+    "format": "oxfmt \"src/**\" \"tests/**\" \"!tests/tmp/**\" --write --no-error-on-unmatched-pattern",
+    "format:check": "oxfmt \"src/**\" \"tests/**\" \"!tests/tmp/**\" --check --no-error-on-unmatched-pattern",
+    "test": "node scripts/run-vitest-smart.mjs run",
+    "test:e2e": "cross-env E2E_TARGET_URL=https://vmoranv.github.io/jshookmcp/ vitest run --config tests/e2e/vitest.e2e.config.ts",
+    "test:coverage": "node -e \"require('fs').mkdirSync('coverage/.tmp', { recursive: true })\" && cross-env ENABLE_INJECTION_TOOLS=true COVERAGE_FULL=true node scripts/run-vitest-smart.mjs run --coverage",
+    "prepack": "corepack pnpm run metadata:check && corepack pnpm run build",
+    "package:verify-bin": "node scripts/verify-packed-bin.mjs",
+    "package:verify-install": "node scripts/verify-packed-install.mjs",
+    "package:verify-release": "node scripts/verify-release-artifact.mjs",
+    "audit:tools": "tsx scripts/audit-tools.mjs",
+    "git:refresh-noise": "node scripts/refresh-git-noise.mjs",
+    "check": "corepack pnpm run metadata:check && corepack pnpm run lint && corepack pnpm run format:check && corepack pnpm run typecheck && corepack pnpm run test",
+    "package": "corepack pnpm pack",
+    "prepublishOnly": "corepack pnpm run check",
+    "postinstall": "node scripts/postinstall.cjs",
+    "install:full": "corepack pnpm install && corepack pnpm exec camoufox-js fetch",
+    "metadata:sync": "node scripts/generate-metadata.mjs --write",
+    "metadata:check": "node scripts/generate-metadata.mjs --check",
+    "check:docs-format": "corepack pnpm run lint:md"
+  },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.78.0",
     "@babel/generator": "^7.29.1",
-    "@babel/parser": "^7.29.0",
+    "@babel/parser": "^7.29.2",
     "@babel/traverse": "^7.29.0",
     "@babel/types": "^7.29.0",
-    "@huggingface/transformers": "^3.8.1",
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@huggingface/transformers": "^4.0.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "dotenv": "^17.3.1",
-    "koffi": "^2.15.1",
-    "openai": "^6.25.0",
+    "dotenv": "^17.4.1",
+    "koffi": "^2.15.6",
+    "mockttp": "^4.3.1",
+    "openai": "^6.34.0",
     "ora": "^9.3.0",
     "quickjs-emscripten": "^0.32.0",
     "rebrowser-puppeteer-core": "^24.8.1",
-    "tinyglobby": "^0.2.15",
+    "tinyglobby": "^0.2.16",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.27.0",
     "@types/babel__traverse": "^7.28.0",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^25.3.0",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@types/node": "^25.5.2",
+    "@vitest/coverage-v8": "^4.1.4",
     "cross-env": "^10.1.0",
-    "estree-walker": "^2.0.2",
-    "lefthook": "^2.1.3",
+    "estree-walker": "^3.0.3",
+    "lefthook": "^2.1.5",
     "medium-zoom": "^1.1.0",
-    "nodemon": "^3.1.14",
-    "oxfmt": "^0.41.0",
-    "oxlint": "^1.56.0",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.59.0",
+    "rolldown": "1.0.0-rc.15",
     "tsc-alias": "^1.8.16",
+    "tsdown": "^0.21.7",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vite": "^6.0.0",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.8",
     "vitepress": "1.6.4",
-    "vitest": "^4.0.18",
-    "vue": "^3.5.30"
+    "vitest": "^4.1.4",
+    "vue": "^3.5.32"
   },
   "optionalDependencies": {
-    "better-sqlite3": "12.6.2",
-    "camoufox-js": "^0.9.1",
-    "playwright-core": "^1.58.2",
+    "@devicefarmer/adbkit": "^3.3.8",
+    "better-sqlite3": "12.8.0",
+    "camoufox-js": "^0.9.3",
+    "playwright-core": "^1.59.1",
     "webcrack": "^2.15.1"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": "^20.19.0 || >=22.12.0"
   },
-  "mcpName": "io.github.vmoranv/jshookmcp",
-  "scripts": {
-    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json --resolve-full-paths && pnpm -C packages/extension-sdk build && node scripts/copy-native-scripts.mjs && node scripts/generate-entry-reexport.mjs && node scripts/fix-bin-permissions.mjs",
-    "typecheck": "tsc --noEmit -p tsconfig.build.json && pnpm -C packages/extension-sdk typecheck",
-    "dev": "tsx --conditions=development watch src/index.ts",
-    "start": "node dist/src/index.js",
-    "doctor": "tsx src/cli/doctor.ts",
-    "docs:generate": "node scripts/generate-vitepress-reference.mjs",
-    "docs:dev": "vitepress dev docs --host 127.0.0.1 --port 5173",
-    "docs:build": "pnpm run docs:generate && vitepress build docs",
-    "docs:preview": "vitepress preview docs --host 127.0.0.1 --port 4173",
-    "lint:md": "pnpm dlx markdownlint-cli2",
-    "lint": "oxlint src/ tests/",
-    "lint:fix": "oxlint --fix src/ tests/",
-    "format": "oxfmt \"src/**\" \"tests/**\" \"!tests/tmp/**\" --write --no-error-on-unmatched-pattern",
-    "format:check": "oxfmt \"src/**\" \"tests/**\" \"!tests/tmp/**\" --check --no-error-on-unmatched-pattern",
-    "test": "vitest run",
-    "test:e2e": "cross-env E2E_TARGET_URL=https://vmoranv.github.io/jshookmcp/ vitest run --config tests/e2e/vitest.e2e.config.ts",
-    "test:coverage": "cross-env ENABLE_INJECTION_TOOLS=true vitest run --coverage",
-    "package:verify-bin": "node scripts/verify-packed-bin.mjs",
-    "package:verify-install": "node scripts/verify-packed-install.mjs",
-    "package:verify-release": "node scripts/verify-release-artifact.mjs",
-    "audit:tools": "tsx scripts/audit-tools.mjs",
-    "git:refresh-noise": "node scripts/refresh-git-noise.mjs",
-    "check": "pnpm run metadata:check && pnpm run lint && pnpm run format:check && pnpm run typecheck && pnpm run test",
-    "package": "pnpm pack",
-    "postinstall": "node scripts/postinstall.cjs",
-    "install:full": "pnpm install && pnpm exec camoufox-js fetch",
-    "metadata:sync": "node scripts/generate-metadata.mjs --write",
-    "metadata:check": "node scripts/generate-metadata.mjs --check",
-    "check:docs-format": "pnpm run lint:md"
-  }
-}
+  "packageManager": "pnpm@10.33.0",
+  "pnpm": {
+    "overrides": {
+      "hono": ">=4.12.14",
+      "@hono/node-server": "1.19.13",
+      "express-rate-limit": "8.3.0",
+      "basic-ftp": ">=5.3.0",
+      "brace-expansion": "5.0.5",
+      "minimatch": "10.2.4",
+      "esbuild": "0.27.3",
+      "isolated-vm": "6.1.2",
+      "flatted": ">=3.4.2",
+      "path-to-regexp": "8.4.0",
+      "protobufjs": ">=7.5.5",
+      "picomatch@^2.0.0": "2.3.2",
+      "picomatch@^4.0.0": "4.0.4",
+      "vitepress>vite": "$vite"
+    },
+    "onlyBuiltDependencies": [
+      "better-sqlite3",
+      "esbuild",
+      "isolated-vm",
+      "koffi",
+      "lefthook",
+      "onnxruntime-node",
+      "protobufjs"
+    ]
+  },
+  "mcpName": "io.github.vmoranv/jshookmcp"
+}

package/scripts/postinstall.cjs

@@ -1,37 +1,148 @@
-const fs = require('node:fs');
-const path = require('node:path');
-const { spawnSync } = require('node:child_process');
-
-const repoGitDir = path.join(process.cwd(), '.git');
-const localBin = path.join(
-  process.cwd(),
-  'node_modules',
-  '.bin',
-  process.platform === 'win32' ? 'lefthook.cmd' : 'lefthook'
-);
-
-if (!fs.existsSync(repoGitDir)) {
-  process.exit(0);
-}
-
-if (!fs.existsSync(localBin)) {
-  console.warn('[postinstall] lefthook not found locally; skipping git hook installation.');
-  process.exit(0);
-}
-
-const result = spawnSync(localBin, ['install'], {
-  stdio: 'inherit',
-  shell: process.platform === 'win32',
-});
-
-if (result.error) {
-  console.warn(
-    `[postinstall] lefthook install failed to spawn: ${result.error.message}; skipping git hook installation.`
-  );
-} else if (result.status !== 0) {
-  console.warn(
-    `[postinstall] lefthook install exited with status ${result.status}; skipping git hook installation.`
-  );
-}
-
-process.exit(0);
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+// ── Native module ABI compatibility check ──────────────────────────────────
+// When switching Node versions, native modules (better-sqlite3, isolated-vm,
+// koffi) may have been compiled against a different NODE_MODULE_VERSION.
+// Detect this and auto-rebuild to avoid runtime ERR_DLOPEN_FAILED errors.
+
+const NATIVE_MODULES = ['better-sqlite3', 'isolated-vm', 'koffi'];
+
+function checkNativeModuleAbi() {
+  const isCiEnv = process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
+  if (isCiEnv) return; // CI handles its own builds
+
+  const needsRebuild = [];
+
+  for (const mod of NATIVE_MODULES) {
+    try {
+      require(mod);
+    } catch (err) {
+      const msg = err && err.message ? err.message : '';
+      if (
+        msg.includes('NODE_MODULE_VERSION') ||
+        msg.includes('ERR_DLOPEN_FAILED') ||
+        msg.includes('was compiled against a different')
+      ) {
+        needsRebuild.push(mod);
+      }
+      // Other errors (e.g. module not installed) are fine — skip silently
+    }
+  }
+
+  if (needsRebuild.length === 0) return;
+
+  console.log(
+    `[postinstall] Native module ABI mismatch detected for: ${needsRebuild.join(', ')}`
+  );
+  console.log(
+    `[postinstall] Auto-rebuilding for Node ${process.version} (ABI ${process.versions.modules})...`
+  );
+
+  for (const mod of needsRebuild) {
+    const result = spawnSync(
+      process.execPath,
+      [
+        path.join(process.cwd(), 'node_modules', '.pnpm', 'node_modules', '.bin', 'node-gyp') ||
+          'node-gyp',
+        'rebuild',
+      ],
+      {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        cwd: path.dirname(require.resolve(`${mod}/package.json`)),
+        shell: process.platform === 'win32',
+        timeout: 120_000,
+      }
+    );
+
+    // Fallback: use npm rebuild for the specific module
+    if (result.status !== 0) {
+      const npmResult = spawnSync('npm', ['rebuild', mod, '--foreground-scripts'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        cwd: process.cwd(),
+        shell: true,
+        timeout: 120_000,
+      });
+      if (npmResult.status === 0) {
+        console.log(`[postinstall] ✓ Rebuilt ${mod} successfully`);
+      } else {
+        console.warn(
+          `[postinstall] ✗ Failed to rebuild ${mod}. Run manually: npm rebuild ${mod} --foreground-scripts`
+        );
+      }
+    } else {
+      console.log(`[postinstall] ✓ Rebuilt ${mod} successfully`);
+    }
+  }
+}
+
+try {
+  checkNativeModuleAbi();
+} catch (err) {
+  // Never let the ABI check block installation
+  console.warn(`[postinstall] ABI check failed (non-fatal): ${err && err.message ? err.message : err}`);
+}
+
+const repoGitDir = path.join(process.cwd(), '.git');
+const localBin = path.join(
+  process.cwd(),
+  'node_modules',
+  '.bin',
+  process.platform === 'win32' ? 'lefthook.cmd' : 'lefthook'
+);
+const isCi = process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
+
+if (isCi || !fs.existsSync(repoGitDir)) {
+  process.exit(0);
+}
+
+if (!fs.existsSync(localBin)) {
+  console.warn('[postinstall] lefthook not found locally; skipping git hook installation.');
+  process.exit(0);
+}
+
+const hooksPathResult = spawnSync('git', ['config', '--local', '--get', 'core.hooksPath'], {
+  encoding: 'utf8',
+  shell: process.platform === 'win32',
+});
+
+const configuredHooksPath = hooksPathResult.status === 0 ? hooksPathResult.stdout.trim() : '';
+if (configuredHooksPath) {
+  const resolvedHooksPath = path.resolve(process.cwd(), configuredHooksPath);
+  const defaultHooksPath = path.resolve(repoGitDir, 'hooks');
+
+  if (resolvedHooksPath === defaultHooksPath) {
+    process.exit(0);
+  }
+
+  console.warn(
+    `[postinstall] core.hooksPath is already set to "${configuredHooksPath}"; skipping git hook installation.`
+  );
+  process.exit(0);
+}
+
+const result = spawnSync(localBin, ['install'], {
+  encoding: 'utf8',
+  stdio: ['ignore', 'pipe', 'pipe'],
+  shell: process.platform === 'win32',
+});
+
+if (result.error) {
+  console.warn(
+    `[postinstall] lefthook install failed to spawn: ${result.error.message}; skipping git hook installation.`
+  );
+} else if (result.status !== 0) {
+  const firstDetailLine = [result.stdout, result.stderr]
+    .join('\n')
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .find(Boolean);
+  console.warn(
+    `[postinstall] lefthook install exited with status ${result.status}; skipping git hook installation${firstDetailLine ? ` (${firstDetailLine})` : ''}.`
+  );
+}
+
+process.exit(0);

package/dist/index.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export * from './src/index.js';

package/dist/packages/extension-sdk/src/bridges/shared.d.ts

@@ -1,40 +0,0 @@
-export type JsonObject = Record<string, unknown>;
-export type TextToolResponse = {
-    content: Array<{
-        type: 'text';
-        text: string;
-    }>;
-};
-export type ProcessRunResult = {
-    ok: boolean;
-    exitCode: number | null;
-    signal: NodeJS.Signals | null;
-    stdout: string;
-    stderr: string;
-    durationMs: number;
-    truncated: boolean;
-};
-export type HttpJsonResult = {
-    status: number;
-    data: JsonObject;
-    text: string;
-};
-export declare function toTextResponse(payload: Record<string, unknown>): TextToolResponse;
-export declare function toErrorResponse(tool: string, error: unknown, extra?: Record<string, unknown>): TextToolResponse;
-export declare function parseStringArg(args: Record<string, unknown>, key: string, required?: boolean): string | undefined;
-export declare function toDisplayPath(absolutePath: string): string;
-export declare function resolveOutputDirectory(toolName: string, target: string, requestedDir?: string): Promise<{
-    absolutePath: string;
-    displayPath: string;
-}>;
-export declare function checkExternalCommand(command: string, versionArgs: string[], label: string, installHint?: string): Promise<TextToolResponse>;
-export declare function runProcess(command: string, args: string[], options?: {
-    timeoutMs?: number;
-    maxStdoutBytes?: number;
-    maxStderrBytes?: number;
-    cwd?: string;
-}): Promise<ProcessRunResult>;
-export declare function assertLoopbackUrl(value: string, label?: string): string;
-export declare function normalizeBaseUrl(value: string): string;
-export declare function buildUrl(baseUrl: string, path: string, query?: Record<string, unknown>): string;
-export declare function requestJson(url: string, method?: string, bodyObj?: Record<string, unknown>, timeoutMs?: number): Promise<HttpJsonResult>;

package/dist/packages/extension-sdk/src/bridges/shared.js

@@ -1,196 +0,0 @@
-import { execFile, spawn } from 'node:child_process';
-import { mkdir } from 'node:fs/promises';
-import { relative, resolve } from 'node:path';
-import { promisify } from 'node:util';
-const execFileAsync = promisify(execFile);
-export function toTextResponse(payload) {
-    return {
-        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
-    };
-}
-export function toErrorResponse(tool, error, extra = {}) {
-    return toTextResponse({
-        success: false,
-        tool,
-        error: error instanceof Error ? error.message : String(error),
-        ...extra,
-    });
-}
-export function parseStringArg(args, key, required = false) {
-    const value = args[key];
-    if (typeof value === 'string') {
-        const trimmed = value.trim();
-        if (trimmed.length > 0)
-            return trimmed;
-    }
-    if (required) {
-        throw new Error(`${key} must be a non-empty string`);
-    }
-    return undefined;
-}
-export function toDisplayPath(absolutePath) {
-    const relPath = relative(process.cwd(), absolutePath).replace(/\\/g, '/');
-    if (relPath.length === 0)
-        return '.';
-    return relPath.startsWith('..') ? absolutePath.replace(/\\/g, '/') : relPath;
-}
-function sanitizePathSegment(value) {
-    return value.replace(/[^a-zA-Z0-9._-]/g, '_');
-}
-export async function resolveOutputDirectory(toolName, target, requestedDir) {
-    if (requestedDir) {
-        const absolutePath = resolve(requestedDir);
-        await mkdir(absolutePath, { recursive: true });
-        return { absolutePath, displayPath: toDisplayPath(absolutePath) };
-    }
-    const absolutePath = resolve(process.cwd(), 'artifacts', toolName, `${sanitizePathSegment(target)}-${Date.now()}`);
-    await mkdir(absolutePath, { recursive: true });
-    return { absolutePath, displayPath: toDisplayPath(absolutePath) };
-}
-export async function checkExternalCommand(command, versionArgs, label, installHint) {
-    try {
-        const { stdout, stderr } = await execFileAsync(command, versionArgs, {
-            timeout: 10_000,
-        });
-        const version = (stdout || stderr).trim().split('\n')[0];
-        return toTextResponse({
-            success: true,
-            tool: label,
-            available: true,
-            version,
-        });
-    }
-    catch (error) {
-        return toTextResponse({
-            success: true,
-            tool: label,
-            available: false,
-            reason: error instanceof Error ? error.message : String(error),
-            ...(installHint ? { installHint } : {}),
-        });
-    }
-}
-export async function runProcess(command, args, options = {}) {
-    const timeoutMs = options.timeoutMs ?? 300_000;
-    const maxStdout = options.maxStdoutBytes ?? 10 * 1024 * 1024;
-    const maxStderr = options.maxStderrBytes ?? 1 * 1024 * 1024;
-    return await new Promise((resolveResult) => {
-        const startedAt = Date.now();
-        const child = spawn(command, args, {
-            shell: false,
-            windowsHide: true,
-            cwd: options.cwd,
-            stdio: ['ignore', 'pipe', 'pipe'],
-        });
-        let stdout = '';
-        let stderr = '';
-        let stdoutTruncated = false;
-        let stderrTruncated = false;
-        let settled = false;
-        let timedOut = false;
-        const finish = (exitCode, signal) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timeoutHandle);
-            resolveResult({
-                ok: exitCode === 0 && !timedOut,
-                exitCode,
-                signal,
-                stdout,
-                stderr,
-                durationMs: Date.now() - startedAt,
-                truncated: stdoutTruncated || stderrTruncated,
-            });
-        };
-        const timeoutHandle = setTimeout(() => {
-            timedOut = true;
-            child.kill('SIGTERM');
-            setTimeout(() => child.kill('SIGKILL'), 2_000);
-        }, timeoutMs);
-        child.stdout.on('data', (chunk) => {
-            if (stdout.length >= maxStdout) {
-                stdoutTruncated = true;
-                return;
-            }
-            const raw = chunk.toString('utf-8');
-            const remaining = maxStdout - stdout.length;
-            stdout += raw.slice(0, remaining);
-            if (raw.length > remaining)
-                stdoutTruncated = true;
-        });
-        child.stderr.on('data', (chunk) => {
-            if (stderr.length >= maxStderr) {
-                stderrTruncated = true;
-                return;
-            }
-            const raw = chunk.toString('utf-8');
-            const remaining = maxStderr - stderr.length;
-            stderr += raw.slice(0, remaining);
-            if (raw.length > remaining)
-                stderrTruncated = true;
-        });
-        child.on('close', (code, signal) => {
-            finish(code, signal);
-        });
-        child.on('error', (error) => {
-            stderr += `${stderr ? '\n' : ''}Spawn error: ${error.message}`;
-            finish(1, null);
-        });
-    });
-}
-export function assertLoopbackUrl(value, label = 'endpoint') {
-    let url;
-    try {
-        url = new URL(value);
-    }
-    catch {
-        throw new Error(`Invalid ${label} URL: ${value}`);
-    }
-    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
-        throw new Error(`${label}: only http/https protocols are allowed, got ${url.protocol}`);
-    }
-    const host = url.hostname.replace(/^\[|\]$/g, '');
-    const isLoopback = host === '127.0.0.1' || host === 'localhost' || host === '::1';
-    if (!isLoopback) {
-        throw new Error(`${label}: only loopback hosts are allowed (127.0.0.1/localhost/::1), got ${host}`);
-    }
-    return url.toString();
-}
-export function normalizeBaseUrl(value) {
-    const url = new URL(value);
-    return `${url.protocol}//${url.host}`;
-}
-export function buildUrl(baseUrl, path, query = {}) {
-    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
-    const url = new URL(`${baseUrl.replace(/\/$/, '')}${normalizedPath}`);
-    for (const [key, value] of Object.entries(query)) {
-        if (value === undefined || value === null || value === '')
-            continue;
-        url.searchParams.set(key, String(value));
-    }
-    return url.toString();
-}
-export async function requestJson(url, method = 'GET', bodyObj, timeoutMs = 15_000) {
-    const body = bodyObj ? JSON.stringify(bodyObj) : undefined;
-    const response = await fetch(url, {
-        method,
-        headers: {
-            Accept: 'application/json',
-            ...(body ? { 'Content-Type': 'application/json' } : {}),
-        },
-        ...(body === undefined ? {} : { body }),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    const text = await response.text();
-    let data = {};
-    if (text.length > 0) {
-        try {
-            data = JSON.parse(text);
-        }
-        catch {
-            data = { text };
-        }
-    }
-    return { status: response.status, data, text };
-}