@mcp-use/inspector 20.0.0-beta.4 → 20.0.0-beta.40

package/dist/server/chunk-K2F2AJOI.js

@@ -1,619 +0,0 @@
-// src/server/proxy/oauth-proxy.ts
-import { lookup } from "dns/promises";
-import { isIP } from "net";
-var SAFE_REQUEST_HEADERS = /* @__PURE__ */ new Set([
-  "accept",
-  "authorization",
-  "content-type",
-  "dpop"
-]);
-var SAFE_RESPONSE_HEADERS = /* @__PURE__ */ new Set([
-  "cache-control",
-  "content-type",
-  "dpop-nonce",
-  "expires",
-  "pragma",
-  "retry-after",
-  "www-authenticate"
-]);
-var ENDPOINT_FIELDS = [
-  ["registration_endpoint", "registration"],
-  ["token_endpoint", "token"],
-  ["revocation_endpoint", "revocation"],
-  ["introspection_endpoint", "introspection"]
-];
-var BINDING_TTL_MS = 10 * 60 * 1e3;
-var MAX_BINDINGS = 100;
-function mountOAuthProxy(app, options = {}) {
-  const {
-    basePath = "/oauth",
-    allowedOrigins = [],
-    allowLoopback = false,
-    timeoutMs = 1e4,
-    maxRequestBodyBytes = 64 * 1024,
-    maxResponseBodyBytes = 1024 * 1024,
-    enableLogging = true,
-    authenticate,
-    validateServerUrl
-  } = options;
-  const origins = new Set(allowedOrigins.map(normalizeOrigin));
-  const bindings = /* @__PURE__ */ new Map();
-  app.use(`${basePath}/*`, async (c, next) => {
-    const origin = c.req.header("Origin");
-    if (origin && !isAllowedOrigin(origin, c.req.url, origins)) {
-      return c.json({ error: "Origin not allowed" }, 403);
-    }
-    if (c.req.method === "OPTIONS") {
-      return corsResponse(origin);
-    }
-    await next();
-    if (origin) setCorsHeaders(c.res.headers, origin);
-  });
-  app.get(`${basePath}/metadata`, async (c) => {
-    if (!await isAuthenticated(c, authenticate)) {
-      return c.json({ error: "Unauthorized" }, 401);
-    }
-    const serverUrlResult = await validateUrl(
-      c.req.query("serverUrl"),
-      allowLoopback
-    );
-    if ("error" in serverUrlResult) {
-      return c.json({ error: serverUrlResult.error }, 400);
-    }
-    const serverUrl = serverUrlResult.url;
-    if (validateServerUrl && !await validateServerUrl(serverUrl.toString(), c)) {
-      return c.json({ error: "MCP server URL not allowed" }, 403);
-    }
-    const targetResult = await validateUrl(c.req.query("url"), allowLoopback);
-    if ("error" in targetResult) {
-      return c.json({ error: targetResult.error }, 400);
-    }
-    const target = targetResult.url;
-    const key = canonicalUrl(serverUrl);
-    const binding = getBinding(bindings, key);
-    let metadataKind = classifyMetadataTarget(serverUrl, target, binding);
-    if (!metadataKind && binding.authorizationServers.size === 0) {
-      try {
-        await hydrateBinding(
-          serverUrl,
-          binding,
-          allowLoopback,
-          timeoutMs,
-          maxResponseBodyBytes
-        );
-        bindings.set(key, binding);
-        metadataKind = classifyMetadataTarget(serverUrl, target, binding);
-      } catch {
-      }
-    }
-    if (!metadataKind) {
-      return c.json(
-        { error: "Metadata target is not bound to this MCP server" },
-        403
-      );
-    }
-    try {
-      log(enableLogging, `GET ${target}`);
-      const upstream = await safeFetch(target, {
-        method: "GET",
-        headers: { Accept: "application/json" },
-        redirect: "manual",
-        signal: AbortSignal.timeout(timeoutMs)
-      });
-      if (isRedirect(upstream.status)) {
-        return c.json(
-          { error: "OAuth metadata redirects are not allowed" },
-          502
-        );
-      }
-      const raw = await readCapped(upstream, maxResponseBodyBytes);
-      if (!upstream.ok) {
-        return c.body(raw, upstream.status, {
-          "Content-Type": upstream.headers.get("content-type") ?? "application/json"
-        });
-      }
-      const metadata = parseObject(raw);
-      if (metadataKind.type === "protected-resource") {
-        await bindProtectedResource(
-          metadata,
-          serverUrl,
-          binding,
-          allowLoopback
-        );
-      } else {
-        await bindAuthorizationServer(
-          metadata,
-          metadataKind.issuer,
-          binding,
-          allowLoopback
-        );
-      }
-      binding.updatedAt = Date.now();
-      bindings.set(key, binding);
-      pruneBindings(bindings);
-      return c.body(raw, 200, {
-        "Content-Type": upstream.headers.get("content-type") ?? "application/json"
-      });
-    } catch (error) {
-      return proxyError(c, error, enableLogging);
-    }
-  });
-  app.post(`${basePath}/proxy`, async (c) => {
-    if (!await isAuthenticated(c, authenticate)) {
-      return c.json({ error: "Unauthorized" }, 401);
-    }
-    let request;
-    try {
-      request = JSON.parse(
-        await readRequestCapped(c.req.raw, maxRequestBodyBytes)
-      );
-    } catch (error) {
-      return c.json(
-        {
-          error: error instanceof BodyTooLargeError ? "Request body too large" : "Invalid JSON request body"
-        },
-        error instanceof BodyTooLargeError ? 413 : 400
-      );
-    }
-    const serverUrlResult = await validateUrl(request.serverUrl, allowLoopback);
-    if ("error" in serverUrlResult) {
-      return c.json({ error: serverUrlResult.error }, 400);
-    }
-    const serverUrl = serverUrlResult.url;
-    if (validateServerUrl && !await validateServerUrl(serverUrl.toString(), c)) {
-      return c.json({ error: "MCP server URL not allowed" }, 403);
-    }
-    const targetResult = await validateUrl(request.url, allowLoopback);
-    if ("error" in targetResult) {
-      return c.json({ error: targetResult.error }, 400);
-    }
-    const target = targetResult.url;
-    if (request.method !== void 0 && request.method !== "POST") {
-      return c.json({ error: "Only OAuth endpoint POST is allowed" }, 405);
-    }
-    const bindingKey = canonicalUrl(serverUrl);
-    const binding = getBinding(bindings, bindingKey);
-    if (binding.endpoints.size === 0) {
-      try {
-        await hydrateBinding(
-          serverUrl,
-          binding,
-          allowLoopback,
-          timeoutMs,
-          maxResponseBodyBytes
-        );
-        bindings.set(bindingKey, binding);
-        pruneBindings(bindings);
-      } catch (error) {
-        return proxyError(c, error, enableLogging);
-      }
-    }
-    const endpointKind = binding.endpoints.get(canonicalUrl(target));
-    if (!endpointKind) {
-      return c.json(
-        { error: "OAuth endpoint is not bound to this MCP server" },
-        403
-      );
-    }
-    try {
-      const headers = filterRequestHeaders(request.headers);
-      const body = serializeBody(request.body, headers);
-      if (new TextEncoder().encode(body ?? "").byteLength > maxRequestBodyBytes) {
-        return c.json({ error: "OAuth request body too large" }, 413);
-      }
-      log(enableLogging, `POST ${endpointKind} ${target}`);
-      const upstream = await safeFetch(target, {
-        method: "POST",
-        headers,
-        body,
-        redirect: "manual",
-        signal: AbortSignal.timeout(timeoutMs)
-      });
-      if (isRedirect(upstream.status)) {
-        return c.json(
-          { error: "OAuth endpoint redirects are not allowed" },
-          502
-        );
-      }
-      const raw = await readCapped(upstream, maxResponseBodyBytes);
-      const responseHeaders = filterResponseHeaders(upstream.headers);
-      const contentType = upstream.headers.get("content-type") ?? "";
-      let responseBody = raw;
-      if (contentType.includes("json")) {
-        try {
-          responseBody = JSON.parse(raw);
-        } catch {
-        }
-      }
-      return c.json({
-        status: upstream.status,
-        statusText: upstream.statusText,
-        headers: responseHeaders,
-        body: responseBody
-      });
-    } catch (error) {
-      return proxyError(c, error, enableLogging);
-    }
-  });
-  log(enableLogging, `Mounted at ${basePath}/metadata and ${basePath}/proxy`);
-}
-async function validateUrl(value, allowLoopback) {
-  if (typeof value !== "string" || !value) {
-    return { error: "Missing or invalid URL" };
-  }
-  let url;
-  try {
-    url = new URL(value);
-  } catch {
-    return { error: "Invalid URL" };
-  }
-  if (url.username || url.password || url.hash) {
-    return { error: "URL credentials and fragments are not allowed" };
-  }
-  const loopback = isLoopbackHostname(url.hostname);
-  if (url.protocol !== "https:") {
-    if (!(allowLoopback && loopback && url.protocol === "http:")) {
-      return { error: "HTTPS is required" };
-    }
-  }
-  if (loopback) {
-    return allowLoopback ? { url } : { error: "Loopback URL not allowed" };
-  }
-  if (isLocalHostname(url.hostname)) {
-    return { error: "Local network URL not allowed" };
-  }
-  try {
-    const addresses = isIP(url.hostname) ? [url.hostname] : (await lookup(url.hostname, { all: true, verbatim: true })).map(
-      ({ address }) => address
-    );
-    if (addresses.length === 0 || addresses.some((address) => !isPublicAddress(address))) {
-      return { error: "Private or non-routable URL not allowed" };
-    }
-  } catch {
-    return { error: "URL hostname could not be resolved" };
-  }
-  return { url };
-}
-async function isSafeProxyTarget(value, allowLoopback = false) {
-  return !("error" in await validateUrl(value, allowLoopback));
-}
-function classifyMetadataTarget(serverUrl, target, binding) {
-  const targetUrl = canonicalUrl(target);
-  if (protectedResourceMetadataUrls(serverUrl).some(
-    (candidate) => canonicalUrl(candidate) === targetUrl
-  )) {
-    return { type: "protected-resource" };
-  }
-  for (const issuer of binding.authorizationServers) {
-    if (authorizationServerMetadataUrls(new URL(issuer)).some(
-      (candidate) => canonicalUrl(candidate) === targetUrl
-    )) {
-      return { type: "authorization-server", issuer };
-    }
-  }
-  return void 0;
-}
-function protectedResourceMetadataUrls(serverUrl) {
-  const path = serverUrl.pathname === "/" ? "" : serverUrl.pathname;
-  return [
-    new URL(`/.well-known/oauth-protected-resource${path}`, serverUrl.origin),
-    new URL("/.well-known/oauth-protected-resource", serverUrl.origin)
-  ];
-}
-function authorizationServerMetadataUrls(issuer) {
-  const path = issuer.pathname === "/" ? "" : issuer.pathname;
-  return [
-    new URL(`/.well-known/oauth-authorization-server${path}`, issuer.origin),
-    new URL(`/.well-known/openid-configuration${path}`, issuer.origin),
-    new URL(`${path || ""}/.well-known/openid-configuration`, issuer.origin)
-  ];
-}
-async function bindProtectedResource(metadata, serverUrl, binding, allowLoopback) {
-  if (typeof metadata.resource !== "string" || canonicalUrl(new URL(metadata.resource)) !== canonicalUrl(serverUrl)) {
-    throw new InvalidUpstreamError(
-      "Protected-resource metadata does not match serverUrl"
-    );
-  }
-  if (!Array.isArray(metadata.authorization_servers) || metadata.authorization_servers.length === 0) {
-    throw new InvalidUpstreamError(
-      "Protected-resource metadata has no authorization servers"
-    );
-  }
-  const issuers = /* @__PURE__ */ new Set();
-  for (const value of metadata.authorization_servers) {
-    const result = await validateUrl(value, allowLoopback);
-    if ("error" in result) {
-      throw new InvalidUpstreamError(
-        `Unsafe authorization server: ${result.error}`
-      );
-    }
-    issuers.add(canonicalUrl(result.url));
-  }
-  binding.authorizationServers = issuers;
-  binding.endpoints.clear();
-}
-async function bindAuthorizationServer(metadata, expectedIssuer, binding, allowLoopback) {
-  if (typeof metadata.issuer !== "string" || canonicalUrl(new URL(metadata.issuer)) !== expectedIssuer) {
-    throw new InvalidUpstreamError(
-      "Authorization-server metadata issuer mismatch"
-    );
-  }
-  binding.endpoints.clear();
-  for (const [field, kind] of ENDPOINT_FIELDS) {
-    const value = metadata[field];
-    if (value === void 0) continue;
-    const result = await validateUrl(value, allowLoopback);
-    if ("error" in result) {
-      throw new InvalidUpstreamError(`Unsafe ${field}: ${result.error}`);
-    }
-    binding.endpoints.set(canonicalUrl(result.url), kind);
-  }
-}
-async function hydrateBinding(serverUrl, binding, allowLoopback, timeoutMs, maxResponseBodyBytes) {
-  for (const metadataUrl of protectedResourceMetadataUrls(serverUrl)) {
-    const response = await safeFetch(metadataUrl, {
-      method: "GET",
-      headers: { Accept: "application/json" },
-      redirect: "manual",
-      signal: AbortSignal.timeout(timeoutMs)
-    });
-    if (isRedirect(response.status)) {
-      throw new InvalidUpstreamError(
-        "OAuth metadata redirects are not allowed"
-      );
-    }
-    if (!response.ok) continue;
-    await bindProtectedResource(
-      parseObject(await readCapped(response, maxResponseBodyBytes)),
-      serverUrl,
-      binding,
-      allowLoopback
-    );
-    break;
-  }
-  if (binding.authorizationServers.size === 0) {
-    throw new InvalidUpstreamError(
-      "Protected-resource metadata could not be discovered"
-    );
-  }
-  for (const issuer of binding.authorizationServers) {
-    let bound = false;
-    for (const metadataUrl of authorizationServerMetadataUrls(
-      new URL(issuer)
-    )) {
-      const response = await safeFetch(metadataUrl, {
-        method: "GET",
-        headers: { Accept: "application/json" },
-        redirect: "manual",
-        signal: AbortSignal.timeout(timeoutMs)
-      });
-      if (isRedirect(response.status)) {
-        throw new InvalidUpstreamError(
-          "OAuth metadata redirects are not allowed"
-        );
-      }
-      if (!response.ok) continue;
-      await bindAuthorizationServer(
-        parseObject(await readCapped(response, maxResponseBodyBytes)),
-        issuer,
-        binding,
-        allowLoopback
-      );
-      bound = true;
-      break;
-    }
-    if (bound) break;
-  }
-  if (binding.endpoints.size === 0) {
-    throw new InvalidUpstreamError(
-      "Authorization-server metadata could not be discovered"
-    );
-  }
-  binding.updatedAt = Date.now();
-}
-async function safeFetch(url, init) {
-  return fetch(url, init);
-}
-function filterRequestHeaders(value) {
-  const result = new Headers();
-  if (!value || typeof value !== "object" || Array.isArray(value))
-    return result;
-  for (const [name, rawValue] of Object.entries(value)) {
-    const lower = name.toLowerCase();
-    if (SAFE_REQUEST_HEADERS.has(lower) && typeof rawValue === "string") {
-      result.set(lower, rawValue);
-    }
-  }
-  return result;
-}
-function filterResponseHeaders(headers) {
-  const result = {};
-  headers.forEach((value, name) => {
-    if (SAFE_RESPONSE_HEADERS.has(name.toLowerCase())) result[name] = value;
-  });
-  return result;
-}
-function serializeBody(body, headers) {
-  if (body === void 0 || body === null) return void 0;
-  if (typeof body === "string") return body;
-  const contentType = headers.get("content-type") ?? "";
-  if (contentType.includes("application/x-www-form-urlencoded") && typeof body === "object" && !Array.isArray(body)) {
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(
-      body
-    )) {
-      params.append(key, String(value));
-    }
-    return params.toString();
-  }
-  if (!headers.has("content-type")) {
-    headers.set("content-type", "application/json");
-  }
-  return JSON.stringify(body);
-}
-async function readRequestCapped(request, maxBytes) {
-  const declared = Number(request.headers.get("content-length"));
-  if (Number.isFinite(declared) && declared > maxBytes) {
-    throw new BodyTooLargeError();
-  }
-  return readStreamCapped(request.body, maxBytes);
-}
-async function readCapped(response, maxBytes) {
-  const declared = Number(response.headers.get("content-length"));
-  if (Number.isFinite(declared) && declared > maxBytes) {
-    await response.body?.cancel();
-    throw new BodyTooLargeError();
-  }
-  return readStreamCapped(response.body, maxBytes);
-}
-async function readStreamCapped(stream, maxBytes) {
-  if (!stream) return "";
-  const reader = stream.getReader();
-  const chunks = [];
-  let size = 0;
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    size += value.byteLength;
-    if (size > maxBytes) {
-      await reader.cancel();
-      throw new BodyTooLargeError();
-    }
-    chunks.push(value);
-  }
-  const bytes = new Uint8Array(size);
-  let offset = 0;
-  for (const chunk of chunks) {
-    bytes.set(chunk, offset);
-    offset += chunk.byteLength;
-  }
-  return new TextDecoder().decode(bytes);
-}
-function parseObject(value) {
-  let parsed;
-  try {
-    parsed = JSON.parse(value);
-  } catch {
-    throw new InvalidUpstreamError("OAuth metadata is not valid JSON");
-  }
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new InvalidUpstreamError("OAuth metadata is not an object");
-  }
-  return parsed;
-}
-function getBinding(bindings, key) {
-  const existing = bindings.get(key);
-  if (existing && Date.now() - existing.updatedAt <= BINDING_TTL_MS) {
-    return existing;
-  }
-  bindings.delete(key);
-  return {
-    authorizationServers: /* @__PURE__ */ new Set(),
-    endpoints: /* @__PURE__ */ new Map(),
-    updatedAt: Date.now()
-  };
-}
-function pruneBindings(bindings) {
-  const now = Date.now();
-  for (const [key, binding] of bindings) {
-    if (now - binding.updatedAt > BINDING_TTL_MS) bindings.delete(key);
-  }
-  while (bindings.size > MAX_BINDINGS) {
-    const oldest = bindings.keys().next().value;
-    if (!oldest) break;
-    bindings.delete(oldest);
-  }
-}
-function canonicalUrl(url) {
-  const copy = new URL(url);
-  copy.hash = "";
-  if (copy.protocol === "https:" && copy.port === "443" || copy.protocol === "http:" && copy.port === "80") {
-    copy.port = "";
-  }
-  return copy.toString().replace(/\/$/, "");
-}
-function normalizeOrigin(origin) {
-  const url = new URL(origin);
-  if (url.pathname !== "/" || url.search || url.hash) {
-    throw new Error(`OAuth proxy allowed origin must be an origin: ${origin}`);
-  }
-  return url.origin;
-}
-function isAllowedOrigin(origin, requestUrl, allowed) {
-  try {
-    const normalized = normalizeOrigin(origin);
-    return normalized === new URL(requestUrl).origin || allowed.has(normalized);
-  } catch {
-    return false;
-  }
-}
-function corsResponse(origin) {
-  const headers = new Headers();
-  if (origin) setCorsHeaders(headers, origin);
-  headers.set("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-  headers.set(
-    "Access-Control-Allow-Headers",
-    "Accept, Authorization, Content-Type"
-  );
-  headers.set("Access-Control-Max-Age", "600");
-  return new Response(null, { status: 204, headers });
-}
-function setCorsHeaders(headers, origin) {
-  headers.set("Access-Control-Allow-Origin", origin);
-  headers.append("Vary", "Origin");
-}
-async function isAuthenticated(c, authenticate) {
-  return authenticate ? authenticate(c) : true;
-}
-function isRedirect(status) {
-  return status >= 300 && status < 400;
-}
-function isLoopbackHostname(hostname) {
-  const normalized = hostname.toLowerCase().replace(/^\[|\]$/g, "");
-  return normalized === "localhost" || normalized.endsWith(".localhost") || normalized === "::1" || normalized.startsWith("127.");
-}
-function isLocalHostname(hostname) {
-  const normalized = hostname.toLowerCase();
-  return normalized.endsWith(".local") || normalized.endsWith(".internal") || normalized.endsWith(".home.arpa");
-}
-function isPublicAddress(address) {
-  if (address.includes(":")) {
-    const lower = address.toLowerCase();
-    if (lower.startsWith("::ffff:")) {
-      return isPublicAddress(lower.slice(7));
-    }
-    return !(lower === "::" || lower === "::1" || lower.startsWith("fc") || lower.startsWith("fd") || /^fe[89ab]/.test(lower) || lower.startsWith("ff") || lower.startsWith("2001:db8:"));
-  }
-  const parts = address.split(".").map(Number);
-  if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part))) {
-    return false;
-  }
-  const [a, b, c] = parts;
-  return !(a === 0 || a === 10 || a === 127 || a === 100 && b >= 64 && b <= 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 0 && c === 0 || a === 192 && b === 0 && c === 2 || a === 192 && b === 168 || a === 198 && (b === 18 || b === 19) || a === 198 && b === 51 && c === 100 || a === 203 && b === 0 && c === 113 || a >= 224);
-}
-function log(enabled, message) {
-  if (enabled) console.log(`[OAuth BFF] ${message}`);
-}
-function proxyError(c, error, logging) {
-  const message = error instanceof Error ? error.message : "Unknown error";
-  if (logging) console.error("[OAuth BFF]", message);
-  if (error instanceof BodyTooLargeError) {
-    return c.json({ error: "Upstream response too large" }, 502);
-  }
-  if (error instanceof InvalidUpstreamError) {
-    return c.json({ error: error.message }, 502);
-  }
-  if (error instanceof DOMException && error.name === "TimeoutError") {
-    return c.json({ error: "OAuth upstream timed out" }, 504);
-  }
-  return c.json({ error: "OAuth upstream request failed" }, 502);
-}
-var BodyTooLargeError = class extends Error {
-};
-var InvalidUpstreamError = class extends Error {
-};
-
-export {
-  mountOAuthProxy,
-  isSafeProxyTarget
-};

package/dist/server/chunk-KD7K27XK.js

@@ -1,77 +0,0 @@
-// src/server/utils.ts
-function isValidUrl(urlString) {
-  try {
-    const url = new URL(urlString);
-    return url.protocol === "http:" || url.protocol === "https:";
-  } catch {
-    return false;
-  }
-}
-async function findAvailablePort(startPort = 8080, maxAttempts = 100) {
-  const net = await import("net");
-  for (let port = startPort; port < startPort + maxAttempts; port++) {
-    try {
-      await new Promise((resolve, reject) => {
-        const server = net.createServer();
-        server.listen(port, () => {
-          server.close(() => resolve());
-        });
-        server.on("error", (err) => reject(err));
-      });
-      return port;
-    } catch {
-      continue;
-    }
-  }
-  throw new Error(
-    `No available port found after trying ${maxAttempts} ports starting from ${startPort}`
-  );
-}
-async function isPortAvailable(port) {
-  const net = await import("net");
-  return new Promise((resolve) => {
-    const server = net.createServer();
-    server.listen(port, () => {
-      server.close(() => resolve(true));
-    });
-    server.on("error", () => resolve(false));
-  });
-}
-function parsePortFromArgs() {
-  const portArgIndex = process.argv.indexOf("--port");
-  if (portArgIndex !== -1 && portArgIndex + 1 < process.argv.length) {
-    const portValue = Number.parseInt(process.argv[portArgIndex + 1], 10);
-    if (!Number.isNaN(portValue) && portValue >= 1 && portValue <= 65535) {
-      return portValue;
-    }
-  }
-  return null;
-}
-function hasNoOpenFlag() {
-  return process.argv.includes("--no-open");
-}
-function formatErrorResponse(error, context) {
-  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-  const errorMessage = error instanceof Error ? error.message : "Unknown error";
-  const errorStack = error instanceof Error ? error.stack : void 0;
-  console.error(`[${timestamp}] Error in ${context}:`, {
-    message: errorMessage,
-    stack: errorStack
-  });
-  return {
-    error: errorMessage,
-    context,
-    timestamp,
-    // Only include stack in development mode
-    ...process.env.NODE_ENV === "development" && errorStack ? { stack: errorStack } : {}
-  };
-}
-
-export {
-  isValidUrl,
-  findAvailablePort,
-  isPortAvailable,
-  parsePortFromArgs,
-  hasNoOpenFlag,
-  formatErrorResponse
-};