@stacksjs/rpx 0.2.0 → 0.3.0

package/dist/cli.js

@@ -17,7 +17,7 @@ var __toESM = (mod, isNodeMode, target) => {
 };
 
 // bin/cli.ts
-import os9 from "os";
+import os10 from "os";
 
 // node_modules/@stacksjs/cli/dist/index.js
 import { formatWithOptions } from "util";
@@ -217845,7 +217845,7 @@ var export_mkdirSync = import_fs_extra.mkdirSync;
 var export_fsWatch = import_fs_extra.watch;
 var export_existsSync = import_fs_extra.pathExists;
 // package.json
-var version = "0.2.0";
+var version = "0.3.0";
 
 // src/config.ts
 import os4 from "os";
@@ -217908,22 +217908,188 @@ var config6 = await loadConfig2({
       validityDays: 180,
       verbose: false
     },
+    etcHostsCleanup: false,
     verbose: true
   }
 });
 
 // src/start.ts
-import * as fs6 from "fs";
+import * as fs7 from "fs";
 import * as http from "http";
 import * as https from "https";
 import * as net from "net";
-import os8 from "os";
-import path9 from "path";
-import process23 from "process";
+import os9 from "os";
+import path10 from "path";
+import process24 from "process";
+
+// src/hosts.ts
+import { spawn } from "child_process";
+import fs4 from "fs";
+import os6 from "os";
+import path7 from "path";
+import process22 from "process";
+
+// src/utils.ts
+function debugLog(category, message, verbose) {
+  if (verbose || config6.verbose) {
+    console.debug(`[rpx:${category}] ${message}`);
+  }
+}
+
+// src/hosts.ts
+var hostsFilePath = process22.platform === "win32" ? path7.join(process22.env.windir || "C:\\Windows", "System32", "drivers", "etc", "hosts") : "/etc/hosts";
+async function sudoWrite(operation, content) {
+  return new Promise((resolve5, reject) => {
+    if (process22.platform === "win32") {
+      reject(new Error("Administrator privileges required on Windows"));
+      return;
+    }
+    const tmpFile = path7.join(os6.tmpdir(), "hosts.tmp");
+    try {
+      if (operation === "append") {
+        const currentContent = fs4.readFileSync(hostsFilePath, "utf8");
+        fs4.writeFileSync(tmpFile, currentContent + content, "utf8");
+      } else {
+        fs4.writeFileSync(tmpFile, content, "utf8");
+      }
+      const sudo = spawn("sudo", ["cp", tmpFile, hostsFilePath]);
+      sudo.on("close", (code) => {
+        try {
+          fs4.unlinkSync(tmpFile);
+          if (code === 0)
+            resolve5();
+          else
+            reject(new Error(`sudo process exited with code ${code}`));
+        } catch (err3) {
+          reject(err3);
+        }
+      });
+      sudo.on("error", (err3) => {
+        try {
+          fs4.unlinkSync(tmpFile);
+        } catch {
+        }
+        reject(err3);
+      });
+    } catch (err3) {
+      reject(err3);
+    }
+  });
+}
+async function addHosts(hosts) {
+  debugLog("hosts", `Adding hosts: ${hosts.join(", ")}`, config6.verbose);
+  debugLog("hosts", `Using hosts file at: ${hostsFilePath}`, config6.verbose);
+  try {
+    const existingContent = await fs4.promises.readFile(hostsFilePath, "utf-8");
+    const newEntries = hosts.filter((host) => {
+      const ipv4Entry = `127.0.0.1 ${host}`;
+      const ipv6Entry = `::1 ${host}`;
+      return !existingContent.includes(ipv4Entry) && !existingContent.includes(ipv6Entry);
+    });
+    if (newEntries.length === 0) {
+      debugLog("hosts", "All hosts already exist in hosts file", config6.verbose);
+      log.info("All hosts are already in the hosts file");
+      return;
+    }
+    const hostEntries = newEntries.map((host) => `\n# Added by rpx\n127.0.0.1 ${host}\n::1 ${host}`).join("\n");
+    try {
+      await fs4.promises.appendFile(hostsFilePath, hostEntries, { flag: "a" });
+      log.success(`Added new hosts: ${newEntries.join(", ")}`);
+    } catch (writeErr) {
+      if (writeErr.code === "EACCES") {
+        debugLog("hosts", "Permission denied, attempting with sudo", config6.verbose);
+        try {
+          await sudoWrite("append", hostEntries);
+          log.success(`Added new hosts with sudo: ${newEntries.join(", ")}`);
+        } catch (sudoErr) {
+          log.error("Failed to modify hosts file automatically");
+          log.warn("Please add these entries to your hosts file manually:");
+          hostEntries.split("\n").forEach((entry) => log.warn(entry));
+          if (process22.platform === "win32") {
+            log.warn("\nOn Windows:");
+            log.warn("1. Run notepad as administrator");
+            log.warn("2. Open C:\\Windows\\System32\\drivers\\etc\\hosts");
+          } else {
+            log.warn("\nOn Unix systems:");
+            log.warn(`sudo nano ${hostsFilePath}`);
+          }
+          throw new Error("Failed to modify hosts file: manual intervention required");
+        }
+      } else {
+        throw writeErr;
+      }
+    }
+  } catch (err3) {
+    const error = err3;
+    log.error(`Failed to manage hosts file: ${error.message}`);
+    throw error;
+  }
+}
+async function removeHosts(hosts) {
+  debugLog("hosts", `Removing hosts: ${hosts.join(", ")}`, config6.verbose);
+  try {
+    const content = await fs4.promises.readFile(hostsFilePath, "utf-8");
+    const lines = content.split("\n");
+    const filteredLines = lines.filter((line, index) => {
+      if (line.trim() === "# Added by rpx") {
+        lines.splice(index + 1, 2);
+        return false;
+      }
+      return true;
+    });
+    while (filteredLines[filteredLines.length - 1]?.trim() === "")
+      filteredLines.pop();
+    const newContent = `${filteredLines.join("\n")}\n`;
+    try {
+      await fs4.promises.writeFile(hostsFilePath, newContent);
+      log.success("Hosts removed successfully");
+    } catch (writeErr) {
+      if (writeErr.code === "EACCES") {
+        debugLog("hosts", "Permission denied, attempting with sudo", config6.verbose);
+        try {
+          await sudoWrite("write", newContent);
+          log.success("Hosts removed successfully with sudo");
+        } catch (sudoErr) {
+          log.error("Failed to modify hosts file automatically");
+          log.warn("Please remove these entries from your hosts file manually:");
+          hosts.forEach((host) => {
+            log.warn("# Added by rpx");
+            log.warn(`127.0.0.1 ${host}`);
+            log.warn(`::1 ${host}`);
+          });
+          if (process22.platform === "win32") {
+            log.warn("\nOn Windows:");
+            log.warn("1. Run notepad as administrator");
+            log.warn("2. Open C:\\Windows\\System32\\drivers\\etc\\hosts");
+          } else {
+            log.warn("\nOn Unix systems:");
+            log.warn(`sudo nano ${hostsFilePath}`);
+          }
+          throw new Error("Failed to modify hosts file: manual intervention required");
+        }
+      } else {
+        throw writeErr;
+      }
+    }
+  } catch (err3) {
+    const error = err3;
+    log.error(`Failed to remove hosts: ${error.message}`);
+    throw error;
+  }
+}
+async function checkHosts(hosts) {
+  debugLog("hosts", `Checking hosts: ${hosts}`, config6.verbose);
+  const content = await fs4.promises.readFile(hostsFilePath, "utf-8");
+  return hosts.map((host) => {
+    const ipv4Entry = `127.0.0.1 ${host}`;
+    const ipv6Entry = `::1 ${host}`;
+    return content.includes(ipv4Entry) || content.includes(ipv6Entry);
+  });
+}
 
 // src/https.ts
-import os7 from "os";
-import path8 from "path";
+import os8 from "os";
+import path9 from "path";
 
 // node_modules/@stacksjs/tlsx/dist/index.js
 import fs22 from "fs";
@@ -217962,7 +218128,7 @@ import process82 from "process";
 import process102 from "process";
 import process182 from "process";
 import process112 from "process";
-import os6 from "os";
+import os7 from "os";
 import tty33 from "tty";
 import process142 from "process";
 import process132 from "process";
@@ -217971,10 +218137,10 @@ import process162 from "process";
 import process172 from "process";
 import process192 from "process";
 import os23 from "os";
-import path7 from "path";
+import path8 from "path";
 import { resolve as resolve6 } from "path";
-import process22 from "process";
-import fs4 from "fs";
+import process23 from "process";
+import fs6 from "fs";
 import path22 from "path";
 var __create4 = Object.create;
 var __getProtoOf4 = Object.getPrototypeOf;
@@ -251465,7 +251631,7 @@ function _supportsColor3(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
     return min;
   }
   if (process112.platform === "win32") {
-    const osRelease = os6.release().split(".");
+    const osRelease = os7.release().split(".");
     if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
       return Number(osRelease[2]) >= 14931 ? 3 : 2;
     }
@@ -254018,7 +254184,7 @@ function isObject33(item) {
   return item && typeof item === "object" && !Array.isArray(item);
 }
 async function loadConfig3({ name, cwd, defaultConfig }) {
-  const configPath2 = resolve6(cwd || process22.cwd(), `${name}.config`);
+  const configPath2 = resolve6(cwd || process23.cwd(), `${name}.config`);
   try {
     const importedConfig = await import(configPath2);
     const loadedConfig = importedConfig.default || importedConfig;
@@ -254032,18 +254198,18 @@ var config42 = await loadConfig3({
   defaultConfig: {
     altNameIPs: ["127.0.0.1"],
     altNameURIs: ["localhost"],
-    organizationName: "stacksjs.org",
+    organizationName: "Local Development",
     countryName: "US",
     stateName: "California",
     localityName: "Playa Vista",
     commonName: "stacks.localhost",
     validityDays: 180,
     hostCertCN: "stacks.localhost",
-    domain: "localhost",
+    domain: "stacks.localhost",
     rootCAObject: { certificate: "", privateKey: "" },
-    caCertPath: path7.join(os23.homedir(), ".stacks", "ssl", `tlsx.localhost.ca.crt`),
-    certPath: path7.join(os23.homedir(), ".stacks", "ssl", `tlsx.localhost.crt`),
-    keyPath: path7.join(os23.homedir(), ".stacks", "ssl", `tlsx.localhost.crt.key`),
+    caCertPath: path8.join(os23.homedir(), ".stacks", "ssl", `stacks.localhost.ca.crt`),
+    certPath: path8.join(os23.homedir(), ".stacks", "ssl", `stacks.localhost.crt`),
+    keyPath: path8.join(os23.homedir(), ".stacks", "ssl", `stacks.localhost.crt.key`),
     verbose: false
   }
 });
@@ -254059,10 +254225,10 @@ function findFoldersWithFile(rootDir, fileName) {
   const result2 = [];
   function search(dir) {
     try {
-      const files2 = fs4.readdirSync(dir);
+      const files2 = fs6.readdirSync(dir);
       for (const file of files2) {
         const filePath = path22.join(dir, file);
-        const stats = fs4.lstatSync(filePath);
+        const stats = fs6.lstatSync(filePath);
         if (stats.isDirectory()) {
           search(filePath);
         } else if (file === fileName) {
@@ -254076,29 +254242,29 @@ function findFoldersWithFile(rootDir, fileName) {
   search(rootDir);
   return result2;
 }
-function debugLog(category, message, verbose) {
+function debugLog2(category, message, verbose) {
   if (verbose || config42.verbose) {
     console.debug(`[tlsx:${category}] ${message}`);
   }
 }
 function randomSerialNumber(verbose) {
-  debugLog("cert", "Generating random serial number", verbose);
+  debugLog2("cert", "Generating random serial number", verbose);
   const serialNumber = makeNumberPositive(import_node_forge2.default.util.bytesToHex(import_node_forge2.default.random.getBytesSync(20)));
-  debugLog("cert", `Generated serial number: ${serialNumber}`, verbose);
+  debugLog2("cert", `Generated serial number: ${serialNumber}`, verbose);
   return serialNumber;
 }
 function getCertNotBefore(verbose) {
-  debugLog("cert", "Calculating certificate not-before date", verbose);
+  debugLog2("cert", "Calculating certificate not-before date", verbose);
   const twoDaysAgo = new Date(Date.now() - 172800000);
   const year = twoDaysAgo.getFullYear();
   const month = (twoDaysAgo.getMonth() + 1).toString().padStart(2, "0");
   const day = twoDaysAgo.getDate().toString().padStart(2, "0");
   const date = new Date(`${year}-${month}-${day}T23:59:59Z`);
-  debugLog("cert", `Certificate not-before date: ${date.toISOString()}`, verbose);
+  debugLog2("cert", `Certificate not-before date: ${date.toISOString()}`, verbose);
   return date;
 }
 function getCertNotAfter(notBefore, verbose) {
-  debugLog("cert", "Calculating certificate not-after date", verbose);
+  debugLog2("cert", "Calculating certificate not-after date", verbose);
   const validityDays = config42.validityDays;
   const daysInMillis = validityDays * 60 * 60 * 24 * 1000;
   const notAfterDate = new Date(notBefore.getTime() + daysInMillis);
@@ -254106,27 +254272,27 @@ function getCertNotAfter(notBefore, verbose) {
   const month = (notAfterDate.getMonth() + 1).toString().padStart(2, "0");
   const day = notAfterDate.getDate().toString().padStart(2, "0");
   const date = new Date(`${year}-${month}-${day}T23:59:59Z`);
-  debugLog("cert", `Certificate not-after date: ${date.toISOString()} (${validityDays} days validity)`, verbose);
+  debugLog2("cert", `Certificate not-after date: ${date.toISOString()} (${validityDays} days validity)`, verbose);
   return date;
 }
 function getCANotAfter(notBefore, verbose) {
-  debugLog("cert", "Calculating CA not-after date", verbose);
+  debugLog2("cert", "Calculating CA not-after date", verbose);
   const year = notBefore.getFullYear() + 100;
   const month = (notBefore.getMonth() + 1).toString().padStart(2, "0");
   const day = notBefore.getDate().toString().padStart(2, "0");
   const date = new Date(`${year}-${month}-${day}T23:59:59Z`);
-  debugLog("cert", `CA not-after date: ${date.toISOString()} (100 years validity)`, verbose);
+  debugLog2("cert", `CA not-after date: ${date.toISOString()} (100 years validity)`, verbose);
   return date;
 }
 async function createRootCA(options23) {
-  debugLog("ca", "Creating new Root CA Certificate", options23?.verbose);
-  debugLog("ca", "Generating 2048-bit RSA key pair", options23?.verbose);
+  debugLog2("ca", "Creating new Root CA Certificate", options23?.verbose);
+  debugLog2("ca", "Generating 2048-bit RSA key pair", options23?.verbose);
   const { privateKey, publicKey } = import_node_forge2.pki.rsa.generateKeyPair(2048);
   const mergedOptions = {
     ...config42,
     ...options23 || {}
   };
-  debugLog("ca", "Setting certificate attributes", options23?.verbose);
+  debugLog2("ca", "Setting certificate attributes", options23?.verbose);
   const attributes = [
     { shortName: "C", value: mergedOptions.countryName },
     { shortName: "ST", value: mergedOptions.stateName },
@@ -254134,7 +254300,7 @@ async function createRootCA(options23) {
     { shortName: "O", value: "Local Development CA" },
     { shortName: "CN", value: "Local Development Root CA" }
   ];
-  debugLog("ca", "Setting certificate extensions", options23?.verbose);
+  debugLog2("ca", "Setting certificate extensions", options23?.verbose);
   const extensions = [
     {
       name: "basicConstraints",
@@ -254151,7 +254317,7 @@ async function createRootCA(options23) {
       name: "subjectKeyIdentifier"
     }
   ];
-  debugLog("ca", "Creating CA certificate", options23?.verbose);
+  debugLog2("ca", "Creating CA certificate", options23?.verbose);
   const caCert = import_node_forge2.pki.createCertificate();
   caCert.publicKey = publicKey;
   caCert.serialNumber = randomSerialNumber(options23?.verbose);
@@ -254160,11 +254326,11 @@ async function createRootCA(options23) {
   caCert.setSubject(attributes);
   caCert.setIssuer(attributes);
   caCert.setExtensions(extensions);
-  debugLog("ca", "Signing certificate with SHA-256", options23?.verbose);
+  debugLog2("ca", "Signing certificate with SHA-256", options23?.verbose);
   caCert.sign(privateKey, import_node_forge2.default.md.sha256.create());
   const pemCert = import_node_forge2.pki.certificateToPem(caCert);
   const pemKey = import_node_forge2.pki.privateKeyToPem(privateKey);
-  debugLog("ca", "Root CA Certificate created successfully", options23?.verbose);
+  debugLog2("ca", "Root CA Certificate created successfully", options23?.verbose);
   return {
     certificate: pemCert,
     privateKey: pemKey,
@@ -254173,34 +254339,41 @@ async function createRootCA(options23) {
   };
 }
 async function generateCert(options23) {
-  debugLog("cert", "Generating new host certificate", options23?.verbose);
-  debugLog("cert", `Options: ${JSON.stringify(options23)}`, options23?.verbose);
+  debugLog2("cert", "Generating new host certificate", options23?.verbose);
+  debugLog2("cert", `Options: ${JSON.stringify(options23)}`, options23?.verbose);
   if (!options23?.hostCertCN?.trim()) {
-    debugLog("cert", "Error: hostCertCN is required", options23?.verbose);
+    debugLog2("cert", "Error: hostCertCN is required", options23?.verbose);
     throw new Error('"hostCertCN" must be a String');
   }
   if (!options23.domain?.trim()) {
-    debugLog("cert", "Error: domain is required", options23?.verbose);
+    debugLog2("cert", "Error: domain is required", options23?.verbose);
     throw new Error('"domain" must be a String');
   }
   if (!options23.rootCAObject || !options23.rootCAObject.certificate || !options23.rootCAObject.privateKey) {
-    debugLog("cert", "Error: rootCAObject is invalid or missing", options23?.verbose);
+    debugLog2("cert", "Error: rootCAObject is invalid or missing", options23?.verbose);
     throw new Error('"rootCAObject" must be an Object with the properties "certificate" & "privateKey"');
   }
-  debugLog("cert", "Converting Root CA PEM to forge objects", options23?.verbose);
+  debugLog2("cert", "Converting Root CA PEM to forge objects", options23?.verbose);
   const caCert = import_node_forge2.pki.certificateFromPem(options23.rootCAObject.certificate);
   const caKey = import_node_forge2.pki.privateKeyFromPem(options23.rootCAObject.privateKey);
-  debugLog("cert", "Generating 2048-bit RSA key pair for host certificate", options23?.verbose);
+  debugLog2("cert", "Generating 2048-bit RSA key pair for host certificate", options23?.verbose);
   const hostKeys = import_node_forge2.pki.rsa.generateKeyPair(2048);
-  debugLog("cert", "Setting certificate attributes", options23?.verbose);
+  debugLog2("cert", "Setting certificate attributes", options23?.verbose);
   const attributes = [
-    { shortName: "C", value: config42.countryName },
-    { shortName: "ST", value: config42.stateName },
-    { shortName: "L", value: config42.localityName },
-    { shortName: "O", value: "Local Development" },
-    { shortName: "CN", value: "*.localhost" }
+    { shortName: "C", value: options23.countryName || config42.countryName },
+    { shortName: "ST", value: options23.stateName || config42.stateName },
+    { shortName: "L", value: options23.localityName || config42.localityName },
+    { shortName: "O", value: options23.organizationName || config42.organizationName },
+    { shortName: "CN", value: options23.commonName || config42.commonName }
   ];
-  debugLog("cert", "Setting certificate extensions", options23?.verbose);
+  const domain = options23.domain || config42.domain;
+  const wildcardDomain = `*.${domain.includes(".") ? domain.split(".").slice(1).join(".") : domain}`;
+  const altNames = [
+    { type: 2, value: wildcardDomain },
+    { type: 2, value: "localhost" },
+    { type: 2, value: domain }
+  ];
+  debugLog2("cert", "Setting certificate extensions", options23?.verbose);
   const extensions = [
     {
       name: "basicConstraints",
@@ -254220,30 +254393,25 @@ async function generateCert(options23) {
     },
     {
       name: "subjectAltName",
-      altNames: [
-        { type: 2, value: "*.localhost" },
-        { type: 2, value: "localhost" },
-        { type: 2, value: "stacks.localhost" },
-        { type: 2, value: options23.domain }
-      ]
+      altNames
     }
   ];
-  debugLog("cert", "Creating new host certificate", options23?.verbose);
+  debugLog2("cert", "Creating new host certificate", options23?.verbose);
   const newHostCert = import_node_forge2.pki.createCertificate();
   newHostCert.publicKey = hostKeys.publicKey;
-  debugLog("cert", "Setting certificate properties", options23?.verbose);
+  debugLog2("cert", "Setting certificate properties", options23?.verbose);
   newHostCert.serialNumber = randomSerialNumber(options23?.verbose);
   newHostCert.validity.notBefore = getCertNotBefore(options23?.verbose);
   newHostCert.validity.notAfter = getCertNotAfter(newHostCert.validity.notBefore, options23?.verbose);
   newHostCert.setSubject(attributes);
   newHostCert.setIssuer(caCert.subject.attributes);
   newHostCert.setExtensions(extensions);
-  debugLog("cert", "Signing certificate with SHA-256", options23?.verbose);
+  debugLog2("cert", "Signing certificate with SHA-256", options23?.verbose);
   newHostCert.sign(caKey, import_node_forge2.default.md.sha256.create());
-  debugLog("cert", "Converting certificate to PEM format", options23?.verbose);
+  debugLog2("cert", "Converting certificate to PEM format", options23?.verbose);
   const pemHostCert = import_node_forge2.pki.certificateToPem(newHostCert);
   const pemHostKey = import_node_forge2.pki.privateKeyToPem(hostKeys.privateKey);
-  debugLog("cert", "Host certificate generated successfully", options23?.verbose);
+  debugLog2("cert", "Host certificate generated successfully", options23?.verbose);
   return {
     certificate: pemHostCert,
     privateKey: pemHostKey,
@@ -254252,81 +254420,81 @@ async function generateCert(options23) {
   };
 }
 async function addCertToSystemTrustStoreAndSaveCert(cert, caCert, options23) {
-  debugLog("trust", `Adding certificate to system trust store with options: ${JSON.stringify(options23)}`, options23?.verbose);
-  debugLog("trust", "Storing certificate and private key", options23?.verbose);
+  debugLog2("trust", `Adding certificate to system trust store with options: ${JSON.stringify(options23)}`, options23?.verbose);
+  debugLog2("trust", "Storing certificate and private key", options23?.verbose);
   const certPath = storeCert(cert, options23);
-  debugLog("trust", "Storing CA certificate", options23?.verbose);
+  debugLog2("trust", "Storing CA certificate", options23?.verbose);
   const caCertPath = storeCACert(caCert, options23);
   const platform23 = os42.platform();
-  debugLog("trust", `Detected platform: ${platform23}`, options23?.verbose);
+  debugLog2("trust", `Detected platform: ${platform23}`, options23?.verbose);
   const args = "TC, C, C";
   if (platform23 === "darwin") {
-    debugLog("trust", "Adding certificate to macOS keychain", options23?.verbose);
+    debugLog2("trust", "Adding certificate to macOS keychain", options23?.verbose);
     await runCommand2(`sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ${caCertPath}`);
   } else if (platform23 === "win32") {
-    debugLog("trust", "Adding certificate to Windows certificate store", options23?.verbose);
+    debugLog2("trust", "Adding certificate to Windows certificate store", options23?.verbose);
     await runCommand2(`certutil -f -v -addstore -enterprise Root ${caCertPath}`);
   } else if (platform23 === "linux") {
-    debugLog("trust", "Adding certificate to Linux certificate store", options23?.verbose);
+    debugLog2("trust", "Adding certificate to Linux certificate store", options23?.verbose);
     const rootDirectory = os42.homedir();
     const targetFileName = "cert9.db";
-    debugLog("trust", `Searching for certificate databases in ${rootDirectory}`, options23?.verbose);
+    debugLog2("trust", `Searching for certificate databases in ${rootDirectory}`, options23?.verbose);
     const foldersWithFile = findFoldersWithFile(rootDirectory, targetFileName);
     for (const folder of foldersWithFile) {
-      debugLog("trust", `Processing certificate database in ${folder}`, options23?.verbose);
+      debugLog2("trust", `Processing certificate database in ${folder}`, options23?.verbose);
       try {
-        debugLog("trust", `Attempting to delete existing cert for ${config42.commonName}`, options23?.verbose);
+        debugLog2("trust", `Attempting to delete existing cert for ${config42.commonName}`, options23?.verbose);
         await runCommand2(`certutil -d sql:${folder} -D -n ${config42.commonName}`);
       } catch (error) {
-        debugLog("trust", `Warning: Error deleting existing cert: ${error}`, options23?.verbose);
+        debugLog2("trust", `Warning: Error deleting existing cert: ${error}`, options23?.verbose);
         console.warn(`Error deleting existing cert: ${error}`);
       }
-      debugLog("trust", `Adding new certificate to ${folder}`, options23?.verbose);
+      debugLog2("trust", `Adding new certificate to ${folder}`, options23?.verbose);
       await runCommand2(`certutil -d sql:${folder} -A -t ${args} -n ${config42.commonName} -i ${caCertPath}`);
       log3.info(`Cert added to ${folder}`);
     }
   } else {
-    debugLog("trust", `Error: Unsupported platform ${platform23}`, options23?.verbose);
+    debugLog2("trust", `Error: Unsupported platform ${platform23}`, options23?.verbose);
     throw new Error(`Unsupported platform: ${platform23}`);
   }
-  debugLog("trust", "Certificate successfully added to system trust store", options23?.verbose);
+  debugLog2("trust", "Certificate successfully added to system trust store", options23?.verbose);
   return certPath;
 }
 function storeCert(cert, options23) {
-  debugLog("storage", `Storing certificate and private key with options: ${JSON.stringify(options23)}`, options23?.verbose);
+  debugLog2("storage", `Storing certificate and private key with options: ${JSON.stringify(options23)}`, options23?.verbose);
   const certPath = options23?.certPath || config42.certPath;
   const certKeyPath = options23?.keyPath || config42.keyPath;
-  debugLog("storage", `Certificate path: ${certPath}`, options23?.verbose);
-  debugLog("storage", `Private key path: ${certKeyPath}`, options23?.verbose);
+  debugLog2("storage", `Certificate path: ${certPath}`, options23?.verbose);
+  debugLog2("storage", `Private key path: ${certKeyPath}`, options23?.verbose);
   const certDir = path32.dirname(certPath);
   if (!fs22.existsSync(certDir)) {
-    debugLog("storage", `Creating certificate directory: ${certDir}`, options23?.verbose);
+    debugLog2("storage", `Creating certificate directory: ${certDir}`, options23?.verbose);
     fs22.mkdirSync(certDir, { recursive: true });
   }
-  debugLog("storage", "Writing certificate file", options23?.verbose);
+  debugLog2("storage", "Writing certificate file", options23?.verbose);
   fs22.writeFileSync(certPath, cert.certificate);
   const certKeyDir = path32.dirname(certKeyPath);
   if (!fs22.existsSync(certKeyDir)) {
-    debugLog("storage", `Creating private key directory: ${certKeyDir}`, options23?.verbose);
+    debugLog2("storage", `Creating private key directory: ${certKeyDir}`, options23?.verbose);
     fs22.mkdirSync(certKeyDir, { recursive: true });
   }
-  debugLog("storage", "Writing private key file", options23?.verbose);
+  debugLog2("storage", "Writing private key file", options23?.verbose);
   fs22.writeFileSync(certKeyPath, cert.privateKey);
-  debugLog("storage", "Certificate and private key stored successfully", options23?.verbose);
+  debugLog2("storage", "Certificate and private key stored successfully", options23?.verbose);
   return certPath;
 }
 function storeCACert(caCert, options23) {
-  debugLog("storage", "Storing CA certificate", options23?.verbose);
+  debugLog2("storage", "Storing CA certificate", options23?.verbose);
   const caCertPath = options23?.caCertPath || config42.caCertPath;
-  debugLog("storage", `CA certificate path: ${caCertPath}`, options23?.verbose);
+  debugLog2("storage", `CA certificate path: ${caCertPath}`, options23?.verbose);
   const caCertDir = path32.dirname(caCertPath);
   if (!fs22.existsSync(caCertDir)) {
-    debugLog("storage", `Creating CA certificate directory: ${caCertDir}`, options23?.verbose);
+    debugLog2("storage", `Creating CA certificate directory: ${caCertDir}`, options23?.verbose);
     fs22.mkdirSync(caCertDir, { recursive: true });
   }
-  debugLog("storage", "Writing CA certificate file", options23?.verbose);
+  debugLog2("storage", "Writing CA certificate file", options23?.verbose);
   fs22.writeFileSync(caCertPath, caCert);
-  debugLog("storage", "CA certificate stored successfully", options23?.verbose);
+  debugLog2("storage", "CA certificate stored successfully", options23?.verbose);
   return caCertPath;
 }
 var export_tls = import_node_forge2.tls;
@@ -254334,28 +254502,37 @@ var export_pki = import_node_forge2.pki;
 var export_forge = import_node_forge2.default;
 
 // src/https.ts
-var defaultHttpsConfig = {
-  domain: "stacks.localhost",
-  hostCertCN: "stacks.localhost",
-  caCertPath: path8.join(os7.homedir(), ".stacks", "ssl", `stacks.localhost.ca.crt`),
-  certPath: path8.join(os7.homedir(), ".stacks", "ssl", `stacks.localhost.crt`),
-  keyPath: path8.join(os7.homedir(), ".stacks", "ssl", `stacks.localhost.crt.key`),
-  altNameIPs: ["127.0.0.1"],
-  altNameURIs: ["localhost"],
-  organizationName: "stacksjs.org",
-  countryName: "US",
-  stateName: "California",
-  localityName: "Playa Vista",
-  commonName: "stacks.localhost",
-  validityDays: 180,
-  verbose: false
-};
+function httpsConfig() {
+  const domain = config6.to || "stacks.localhost";
+  const defaultConfig = {
+    domain,
+    hostCertCN: domain,
+    caCertPath: path9.join(os8.homedir(), ".stacks", "ssl", `${domain}.ca.crt`),
+    certPath: path9.join(os8.homedir(), ".stacks", "ssl", `${domain}.crt`),
+    keyPath: path9.join(os8.homedir(), ".stacks", "ssl", `${domain}.crt.key`),
+    altNameIPs: ["127.0.0.1"],
+    altNameURIs: ["localhost"],
+    organizationName: "stacksjs.org",
+    countryName: "US",
+    stateName: "California",
+    localityName: "Playa Vista",
+    commonName: domain,
+    validityDays: 180,
+    verbose: false
+  };
+  if (config6.https === true)
+    return defaultConfig;
+  return {
+    ...defaultConfig,
+    ...config6.https
+  };
+}
 async function generateCertificate(domain) {
   if (config6.https === true)
-    config6.https = defaultHttpsConfig;
+    config6.https = httpsConfig();
   else if (config6.https === false)
     return;
-  domain = domain ?? config6.https.altNameURIs[0];
+  domain = domain ?? config6.https.domain;
   log.info(`Generating a self-signed SSL certificate for: ${domain}`);
   const caCert = await createRootCA(config6.https);
   const hostCert = await generateCert({
@@ -254378,90 +254555,89 @@ async function generateCertificate(domain) {
   log.success("Certificate generated");
 }
 
-// src/utils.ts
-function debugLog2(category, message, verbose) {
-  if (verbose || config6.verbose) {
-    console.debug(`[rpx:${category}] ${message}`);
-  }
-}
-
 // src/start.ts
 var activeServers = new Set;
-function cleanup() {
-  debugLog2("cleanup", "Starting cleanup process", config6.verbose);
+async function cleanup() {
+  debugLog("cleanup", "Starting cleanup process", config6.verbose);
   console.log(`\n`);
   log.info("Shutting down proxy servers...");
-  const closePromises = Array.from(activeServers).map((server) => new Promise((resolve5) => {
+  const cleanupPromises = [];
+  const serverClosePromises = Array.from(activeServers).map((server) => new Promise((resolve5) => {
     server.close(() => {
-      debugLog2("cleanup", "Server closed successfully", config6.verbose);
+      debugLog("cleanup", "Server closed successfully", config6.verbose);
       resolve5();
     });
   }));
-  Promise.all(closePromises).then(() => {
-    debugLog2("cleanup", "All servers closed successfully", config6.verbose);
-    log.success("All proxy servers shut down successfully");
-    process23.exit(0);
-  }).catch((err4) => {
-    debugLog2("cleanup", `Error during shutdown: ${err4}`, config6.verbose);
-    log.error("Error during shutdown:", err4);
-    process23.exit(1);
-  });
-}
-process23.on("SIGINT", cleanup);
-process23.on("SIGTERM", cleanup);
-process23.on("uncaughtException", (err4) => {
-  debugLog2("process", `Uncaught exception: ${err4}`, config6.verbose);
+  cleanupPromises.push(...serverClosePromises);
+  if (config6.etcHostsCleanup) {
+    debugLog("cleanup", "Cleaning up hosts file entries", config6.verbose);
+    try {
+      const toUrl = new URL(config6.to.startsWith("http") ? config6.to : `http://${config6.to}`);
+      const hostname = toUrl.hostname;
+      if (!hostname.includes("localhost") && !hostname.includes("127.0.0.1")) {
+        log.info("Cleaning up hosts file entries...");
+        cleanupPromises.push(removeHosts([hostname]).then(() => {
+          debugLog("cleanup", `Removed hosts entry for ${hostname}`, config6.verbose);
+        }).catch((err4) => {
+          debugLog("cleanup", `Failed to remove hosts entry: ${err4}`, config6.verbose);
+          log.warn(`Failed to clean up hosts file entry for ${hostname}:`, err4);
+        }));
+      }
+    } catch (err4) {
+      debugLog("cleanup", `Error parsing URL during hosts cleanup: ${err4}`, config6.verbose);
+      log.warn("Failed to parse URL for hosts cleanup:", err4);
+    }
+  }
+  try {
+    await Promise.all(cleanupPromises);
+    debugLog("cleanup", "All cleanup tasks completed successfully", config6.verbose);
+    log.success("All cleanup tasks completed successfully");
+    process24.exit(0);
+  } catch (err4) {
+    debugLog("cleanup", `Error during cleanup: ${err4}`, config6.verbose);
+    log.error("Error during cleanup:", err4);
+    process24.exit(1);
+  }
+}
+process24.on("SIGINT", cleanup);
+process24.on("SIGTERM", cleanup);
+process24.on("uncaughtException", (err4) => {
+  debugLog("process", `Uncaught exception: ${err4}`, config6.verbose);
   log.error("Uncaught exception:", err4);
   cleanup();
 });
 async function loadSSLConfig(options4) {
-  debugLog2("ssl", "Loading SSL configuration", options4.verbose);
-  if (options4.https === true) {
-    options4.https = {
-      domain: "stacks.localhost",
-      hostCertCN: "stacks.localhost",
-      caCertPath: path9.join(os8.homedir(), ".stacks", "ssl", `stacks.localhost.ca.crt`),
-      certPath: path9.join(os8.homedir(), ".stacks", "ssl", `stacks.localhost.crt`),
-      keyPath: path9.join(os8.homedir(), ".stacks", "ssl", `stacks.localhost.crt.key`),
-      altNameIPs: ["127.0.0.1"],
-      altNameURIs: ["localhost"],
-      organizationName: "stacksjs.org",
-      countryName: "US",
-      stateName: "California",
-      localityName: "Playa Vista",
-      commonName: "stacks.localhost",
-      validityDays: 180,
-      verbose: false
-    };
-  } else if (options4.https === false) {
+  debugLog("ssl", "Loading SSL configuration", options4.verbose);
+  if (options4.https === true)
+    options4.https = httpsConfig();
+  else if (options4.https === false)
     return null;
-  }
   if (!options4.https?.keyPath && !options4.https?.certPath) {
-    debugLog2("ssl", "No SSL configuration provided", options4.verbose);
+    debugLog("ssl", "No SSL configuration provided", options4.verbose);
     return null;
   }
   if (options4.https?.keyPath && !options4.https?.certPath || !options4.https?.keyPath && options4.https?.certPath) {
     const missing = !options4.https?.keyPath ? "keyPath" : "certPath";
-    debugLog2("ssl", `Invalid SSL configuration - missing ${missing}`, options4.verbose);
+    debugLog("ssl", `Invalid SSL configuration - missing ${missing}`, options4.verbose);
     throw new Error(`SSL Configuration requires both keyPath and certPath. Missing: ${missing}`);
   }
   try {
     if (!options4.https?.keyPath || !options4.https?.certPath)
       return null;
     try {
-      debugLog2("ssl", "Reading SSL certificate files", options4.verbose);
-      const key = await fs6.promises.readFile(options4.https?.keyPath, "utf8");
-      const cert = await fs6.promises.readFile(options4.https?.certPath, "utf8");
-      debugLog2("ssl", "SSL configuration loaded successfully", options4.verbose);
+      debugLog("ssl", "Reading SSL certificate files", options4.verbose);
+      const key = await fs7.promises.readFile(options4.https?.keyPath, "utf8");
+      const cert = await fs7.promises.readFile(options4.https?.certPath, "utf8");
+      debugLog("ssl", "SSL configuration loaded successfully", options4.verbose);
       return { key, cert };
     } catch (error) {
       if (error.code === "ENOENT") {
-        debugLog2("ssl", "Certificates not found, generating new ones", options4.verbose);
-        await generateCertificate();
-        debugLog2("ssl", "Reading newly generated certificates", options4.verbose);
-        const key = await fs6.promises.readFile(options4.https?.keyPath, "utf8");
-        const cert = await fs6.promises.readFile(options4.https?.certPath, "utf8");
-        debugLog2("ssl", "New SSL certificates loaded successfully", options4.verbose);
+        debugLog("ssl", "Certificates not found, generating new ones", options4.verbose);
+        await generateCertificate(options4.to);
+        debugLog("ssl", "Reading newly generated certificates", options4.verbose);
+        const key = await fs7.promises.readFile(options4.https?.keyPath, "utf8");
+        const cert = await fs7.promises.readFile(options4.https?.certPath, "utf8");
+        debugLog("ssl", "New SSL certificates loaded successfully", options4.verbose);
         return { key, cert };
       }
       throw error;
@@ -254469,22 +254645,22 @@ async function loadSSLConfig(options4) {
   } catch (err4) {
     const error = err4;
     const detail = error.code === "ENOENT" ? `File not found: ${error.path}` : error.message;
-    debugLog2("ssl", `SSL configuration error: ${error}`, options4.verbose);
+    debugLog("ssl", `SSL configuration error: ${error}`, options4.verbose);
     throw new Error(`SSL Configuration Error: ${detail}`);
   }
 }
 function isPortInUse(port, hostname, verbose) {
-  debugLog2("port", `Checking if port ${port} is in use on ${hostname}`, verbose);
+  debugLog("port", `Checking if port ${port} is in use on ${hostname}`, verbose);
   return new Promise((resolve5) => {
     const server = net.createServer();
     server.once("error", (err4) => {
       if (err4.code === "EADDRINUSE") {
-        debugLog2("port", `Port ${port} is in use`, verbose);
+        debugLog("port", `Port ${port} is in use`, verbose);
         resolve5(true);
       }
     });
     server.once("listening", () => {
-      debugLog2("port", `Port ${port} is available`, verbose);
+      debugLog("port", `Port ${port} is available`, verbose);
       server.close();
       resolve5(false);
     });
@@ -254492,17 +254668,17 @@ function isPortInUse(port, hostname, verbose) {
   });
 }
 async function findAvailablePort(startPort, hostname, verbose) {
-  debugLog2("port", `Finding available port starting from ${startPort}`, verbose);
+  debugLog("port", `Finding available port starting from ${startPort}`, verbose);
   let port = startPort;
   while (await isPortInUse(port, hostname, verbose)) {
-    debugLog2("port", `Port ${port} is in use, trying ${port + 1}`, verbose);
+    debugLog("port", `Port ${port} is in use, trying ${port + 1}`, verbose);
     port++;
   }
-  debugLog2("port", `Found available port: ${port}`, verbose);
+  debugLog("port", `Found available port: ${port}`, verbose);
   return port;
 }
 async function testConnection(hostname, port, verbose) {
-  debugLog2("connection", `Testing connection to ${hostname}:${port}`, verbose);
+  debugLog("connection", `Testing connection to ${hostname}:${port}`, verbose);
   return new Promise((resolve5, reject) => {
     const socket = net.connect({
       host: hostname,
@@ -254510,58 +254686,89 @@ async function testConnection(hostname, port, verbose) {
       timeout: 5000
     });
     socket.once("connect", () => {
-      debugLog2("connection", `Successfully connected to ${hostname}:${port}`, verbose);
+      debugLog("connection", `Successfully connected to ${hostname}:${port}`, verbose);
       socket.end();
       resolve5();
     });
     socket.once("timeout", () => {
-      debugLog2("connection", `Connection to ${hostname}:${port} timed out`, verbose);
+      debugLog("connection", `Connection to ${hostname}:${port} timed out`, verbose);
       socket.destroy();
       reject(new Error(`Connection to ${hostname}:${port} timed out`));
     });
     socket.once("error", (err4) => {
-      debugLog2("connection", `Failed to connect to ${hostname}:${port}: ${err4}`, verbose);
+      debugLog("connection", `Failed to connect to ${hostname}:${port}: ${err4}`, verbose);
       socket.destroy();
       reject(new Error(`Failed to connect to ${hostname}:${port}: ${err4.message}`));
     });
   });
 }
 async function startServer(options4) {
-  debugLog2("server", `Starting server with options: ${JSON.stringify(options4)}`, options4?.verbose);
+  debugLog("server", `Starting server with options: ${JSON.stringify(options4)}`, options4?.verbose);
   if (!options4)
     options4 = config6;
   if (!options4.from)
     options4.from = config6.from;
   if (!options4.to)
     options4.to = config6.to;
+  const fromUrl = new URL(options4.from.startsWith("http") ? options4.from : `http://${options4.from}`);
+  const toUrl = new URL(options4.to.startsWith("http") ? options4.to : `http://${options4.to}`);
+  const fromPort = Number.parseInt(fromUrl.port) || (fromUrl.protocol.includes("https:") ? 443 : 80);
+  const hostsToCheck = [toUrl.hostname];
+  if (!toUrl.hostname.includes("localhost") && !toUrl.hostname.includes("127.0.0.1")) {
+    debugLog("hosts", `Checking if hosts file entry exists for: ${toUrl.hostname}`, options4.verbose);
+    try {
+      const hostsExist = await checkHosts(hostsToCheck);
+      if (!hostsExist[0]) {
+        log.info(`Adding ${toUrl.hostname} to hosts file...`);
+        log.info("This may require sudo/administrator privileges");
+        try {
+          await addHosts(hostsToCheck);
+        } catch (addError) {
+          log.error("Failed to add hosts entry:", addError.message);
+          log.warn("You can manually add this entry to your hosts file:");
+          log.warn(`127.0.0.1 ${toUrl.hostname}`);
+          log.warn(`::1 ${toUrl.hostname}`);
+          if (process24.platform === "win32") {
+            log.warn("On Windows:");
+            log.warn("1. Run notepad as administrator");
+            log.warn("2. Open C:\\Windows\\System32\\drivers\\etc\\hosts");
+          } else {
+            log.warn("On Unix systems:");
+            log.warn("sudo nano /etc/hosts");
+          }
+        }
+      } else {
+        debugLog("hosts", `Host entry already exists for ${toUrl.hostname}`, options4.verbose);
+      }
+    } catch (checkError) {
+      log.error("Failed to check hosts file:", checkError.message);
+    }
+  }
   if (config6.https) {
     if (config6.https === true)
-      config6.https = defaultHttpsConfig;
-    const domain = config6.https.altNameURIs?.[0] || new URL(options4.to).hostname;
+      config6.https = httpsConfig();
+    const domain = toUrl.hostname;
     if (typeof options4.https !== "boolean" && options4.https) {
-      options4.https.keyPath = config6.https.keyPath || path9.join(os8.homedir(), ".stacks", "ssl", `${domain}.crt.key`);
-      options4.https.certPath = config6.https.certPath || path9.join(os8.homedir(), ".stacks", "ssl", `${domain}.crt`);
-      debugLog2("server", `HTTPS enabled, using cert paths: ${options4.https.keyPath}, ${options4.https.certPath}`, options4.verbose);
+      options4.https.keyPath = config6.https.keyPath || path10.join(os9.homedir(), ".stacks", "ssl", `${domain}.crt.key`);
+      options4.https.certPath = config6.https.certPath || path10.join(os9.homedir(), ".stacks", "ssl", `${domain}.crt`);
+      debugLog("server", `HTTPS enabled, using cert paths: ${options4.https.keyPath}, ${options4.https.certPath}`, options4.verbose);
     }
   }
-  const fromUrl = new URL(options4.from.startsWith("http") ? options4.from : `http://${options4.from}`);
-  const toUrl = new URL(options4.to.startsWith("http") ? options4.to : `http://${options4.to}`);
-  const fromPort = Number.parseInt(fromUrl.port) || (fromUrl.protocol.includes("https:") ? 443 : 80);
-  debugLog2("server", `Parsed URLs - from: ${fromUrl}, to: ${toUrl}`, options4.verbose);
+  debugLog("server", `Parsed URLs - from: ${fromUrl}, to: ${toUrl}`, options4.verbose);
   try {
     await testConnection(fromUrl.hostname, fromPort, options4.verbose);
   } catch (err4) {
-    debugLog2("server", `Connection test failed: ${err4}`, options4.verbose);
+    debugLog("server", `Connection test failed: ${err4}`, options4.verbose);
     log.error(err4.message);
-    process23.exit(1);
+    process24.exit(1);
   }
   let sslConfig = null;
   if (config6.https) {
     try {
       sslConfig = await loadSSLConfig(options4);
     } catch (err4) {
-      debugLog2("server", `SSL config failed, attempting to generate certificates: ${err4}`, options4.verbose);
-      await generateCertificate();
+      debugLog("server", `SSL config failed, attempting to generate certificates: ${err4}`, options4.verbose);
+      await generateCertificate(options4.to);
       sslConfig = await loadSSLConfig(options4);
     }
   }
@@ -254578,9 +254785,9 @@ async function startServer(options4) {
   });
 }
 async function createProxyServer(from, to, fromPort, listenPort, hostname, sourceUrl, ssl, verbose) {
-  debugLog2("proxy", `Creating proxy server ${from} -> ${to}`, verbose);
+  debugLog("proxy", `Creating proxy server ${from} -> ${to}`, verbose);
   const requestHandler = (req, res) => {
-    debugLog2("request", `Incoming request: ${req.method} ${req.url}`, verbose);
+    debugLog("request", `Incoming request: ${req.method} ${req.url}`, verbose);
     const proxyOptions = {
       hostname: sourceUrl.hostname,
       port: fromPort,
@@ -254591,9 +254798,9 @@ async function createProxyServer(from, to, fromPort, listenPort, hostname, sourc
         host: sourceUrl.host
       }
     };
-    debugLog2("request", `Proxy request options: ${JSON.stringify(proxyOptions)}`, verbose);
+    debugLog("request", `Proxy request options: ${JSON.stringify(proxyOptions)}`, verbose);
     const proxyReq = http.request(proxyOptions, (proxyRes) => {
-      debugLog2("response", `Proxy response received with status ${proxyRes.statusCode}`, verbose);
+      debugLog("response", `Proxy response received with status ${proxyRes.statusCode}`, verbose);
       const headers = {
         ...proxyRes.headers,
         "Strict-Transport-Security": "max-age=31536000; includeSubDomains; preload",
@@ -254603,7 +254810,7 @@ async function createProxyServer(from, to, fromPort, listenPort, hostname, sourc
       proxyRes.pipe(res);
     });
     proxyReq.on("error", (err4) => {
-      debugLog2("request", `Proxy request failed: ${err4}`, verbose);
+      debugLog("request", `Proxy request failed: ${err4}`, verbose);
       log.error("Proxy request failed:", err4);
       res.writeHead(502);
       res.end(`Proxy Error: ${err4.message}`);
@@ -254630,11 +254837,11 @@ async function createProxyServer(from, to, fromPort, listenPort, hostname, sourc
     allowHTTP1: true,
     ALPNProtocols: ["h2", "http/1.1"]
   } : undefined;
-  debugLog2("server", `Creating server with SSL config: ${!!ssl}`, verbose);
+  debugLog("server", `Creating server with SSL config: ${!!ssl}`, verbose);
   const server = ssl && serverOptions ? https.createServer(serverOptions, requestHandler) : http.createServer(requestHandler);
   if (ssl) {
     server.on("secureConnection", (tlsSocket) => {
-      debugLog2("tls", `TLS Connection established: ${JSON.stringify({
+      debugLog("tls", `TLS Connection established: ${JSON.stringify({
         protocol: tlsSocket.getProtocol?.(),
         cipher: tlsSocket.getCipher?.(),
         authorized: tlsSocket.authorized,
@@ -254645,7 +254852,7 @@ async function createProxyServer(from, to, fromPort, listenPort, hostname, sourc
   activeServers.add(server);
   return new Promise((resolve5, reject) => {
     server.listen(listenPort, hostname, () => {
-      debugLog2("server", `Server listening on port ${listenPort}`, verbose);
+      debugLog("server", `Server listening on port ${listenPort}`, verbose);
       console.log("");
       console.log(`  ${green(bold("reverse-proxy"))} ${green(`v${version}`)}`);
       console.log("");
@@ -254662,13 +254869,13 @@ async function createProxyServer(from, to, fromPort, listenPort, hostname, sourc
       resolve5();
     });
     server.on("error", (err4) => {
-      debugLog2("server", `Server error: ${err4}`, verbose);
+      debugLog("server", `Server error: ${err4}`, verbose);
       reject(err4);
     });
   });
 }
 async function setupReverseProxy(options4) {
-  debugLog2("setup", `Setting up reverse proxy: ${JSON.stringify(options4)}`, options4.verbose);
+  debugLog("setup", `Setting up reverse proxy: ${JSON.stringify(options4)}`, options4.verbose);
   const { from, to, fromPort, sourceUrl, ssl, verbose } = options4;
   const httpPort = 80;
   const httpsPort = 443;
@@ -254677,72 +254884,72 @@ async function setupReverseProxy(options4) {
     if (ssl) {
       const isHttpPortBusy = await isPortInUse(httpPort, hostname, verbose);
       if (!isHttpPortBusy) {
-        debugLog2("setup", "Starting HTTP redirect server", verbose);
+        debugLog("setup", "Starting HTTP redirect server", verbose);
         startHttpRedirectServer(verbose);
       } else {
-        debugLog2("setup", "Port 80 is in use, skipping HTTP redirect", verbose);
+        debugLog("setup", "Port 80 is in use, skipping HTTP redirect", verbose);
         log.warn("Port 80 is in use, HTTP to HTTPS redirect will not be available");
       }
     }
     const targetPort = ssl ? httpsPort : httpPort;
     const isTargetPortBusy = await isPortInUse(targetPort, hostname, verbose);
     if (isTargetPortBusy) {
-      debugLog2("setup", `Port ${targetPort} is busy, finding alternative`, verbose);
+      debugLog("setup", `Port ${targetPort} is busy, finding alternative`, verbose);
       const availablePort = await findAvailablePort(ssl ? 8443 : 8080, hostname, verbose);
       log.warn(`Port ${targetPort} is in use. Using port ${availablePort} instead.`);
       log.info(`You can use 'sudo lsof -i :${targetPort}' (Unix) or 'netstat -ano | findstr :${targetPort}' (Windows) to check what's using the port.`);
       await createProxyServer(from, to, fromPort, availablePort, hostname, sourceUrl, ssl, verbose);
     } else {
-      debugLog2("setup", `Using default port ${targetPort}`, verbose);
+      debugLog("setup", `Using default port ${targetPort}`, verbose);
       await createProxyServer(from, to, fromPort, targetPort, hostname, sourceUrl, ssl, verbose);
     }
   } catch (err4) {
-    debugLog2("setup", `Setup failed: ${err4}`, verbose);
+    debugLog("setup", `Setup failed: ${err4}`, verbose);
     log.error(`Failed to setup reverse proxy: ${err4.message}`);
     cleanup();
   }
 }
 function startHttpRedirectServer(verbose) {
-  debugLog2("redirect", "Starting HTTP redirect server", verbose);
+  debugLog("redirect", "Starting HTTP redirect server", verbose);
   const server = http.createServer((req, res) => {
     const host = req.headers.host || "";
-    debugLog2("redirect", `Redirecting request from ${host}${req.url} to HTTPS`, verbose);
+    debugLog("redirect", `Redirecting request from ${host}${req.url} to HTTPS`, verbose);
     res.writeHead(301, {
       Location: `https://${host}${req.url}`
     });
     res.end();
   }).listen(80);
   activeServers.add(server);
-  debugLog2("redirect", "HTTP redirect server started", verbose);
+  debugLog("redirect", "HTTP redirect server started", verbose);
 }
 function startProxy(options4) {
   const finalOptions = {
     ...config6,
     ...options4
   };
-  debugLog2("proxy", `Starting proxy with options: ${JSON.stringify({
+  debugLog("proxy", `Starting proxy with options: ${JSON.stringify({
     from: finalOptions.from,
     to: finalOptions.to,
     https: finalOptions.https
   })}`, finalOptions.verbose);
   startServer(finalOptions).catch((err4) => {
-    debugLog2("proxy", `Failed to start proxy: ${err4}`, finalOptions.verbose);
+    debugLog("proxy", `Failed to start proxy: ${err4}`, finalOptions.verbose);
     log.error(`Failed to start proxy: ${err4.message}`);
     cleanup();
   });
 }
 function startProxies(options4) {
   if (Array.isArray(options4)) {
-    debugLog2("proxies", `Starting multiple proxies: ${options4.length}`, options4[0]?.verbose);
+    debugLog("proxies", `Starting multiple proxies: ${options4.length}`, options4[0]?.verbose);
     Promise.all(options4.map((option) => startServer(option))).catch((err4) => {
-      debugLog2("proxies", `Failed to start proxies: ${err4}`, options4[0]?.verbose);
+      debugLog("proxies", `Failed to start proxies: ${err4}`, options4[0]?.verbose);
       log.error("Failed to start proxies:", err4);
       cleanup();
     });
   } else if (options4) {
-    debugLog2("proxies", "Starting single proxy", options4.verbose);
+    debugLog("proxies", "Starting single proxy", options4.verbose);
     startServer(options4).catch((err4) => {
-      debugLog2("proxies", `Failed to start proxy: ${err4}`, options4.verbose);
+      debugLog("proxies", `Failed to start proxy: ${err4}`, options4.verbose);
       log.error("Failed to start proxy:", err4);
       cleanup();
     });
@@ -254762,12 +254969,12 @@ cli.command("start", "Start the Reverse Proxy Server").option("--from <from>", "
 });
 cli.command("update:etc-hosts", "Update the /etc/hosts file with the proxy domains. Please note, this command requires sudo/admin permissions.").alias("update-etc-hosts").example("sudo reverse-proxy update:etc-hosts").example("sudo reverse-proxy update-etc-hosts").action(async () => {
   log.info("Ensuring /etc/hosts file covers the proxy domain/s...");
-  const hostsFilePath = os9.platform() === "win32" ? "C:\\Windows\\System32\\drivers\\etc\\hosts" : "/etc/hosts";
+  const hostsFilePath2 = os10.platform() === "win32" ? "C:\\Windows\\System32\\drivers\\etc\\hosts" : "/etc/hosts";
   if (config6 && typeof config6 === "object") {
     const entriesToAdd = Object.entries(config6).map(([from, to]) => `127.0.0.1 ${to} # reverse-proxy mapping for ${from}`);
     entriesToAdd.push("127.0.0.1 localhost # essential localhost mapping");
     try {
-      let currentHostsContent = export_readFileSync(hostsFilePath, "utf8");
+      let currentHostsContent = export_readFileSync(hostsFilePath2, "utf8");
       let updated = false;
       for (const entry of entriesToAdd) {
         const [ip, host] = entry.split(" ", 2);
@@ -254780,7 +254987,7 @@ cli.command("update:etc-hosts", "Update the /etc/hosts file with the proxy domai
         }
       }
       if (updated) {
-        export_writeFileSync(hostsFilePath, currentHostsContent, "utf8");
+        export_writeFileSync(hostsFilePath2, currentHostsContent, "utf8");
         log.success("Hosts file updated with latest proxy domains.");
       } else {
         log.info("No new entries were added to the hosts file.");