@chenpu17/serve-here 1.0.2 → 2.0.1

package/bin/serve-here.js

@@ -1,434 +1,43 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const process = require('process');
-const { spawn } = require('child_process');
-
-const { createStaticServer } = require('../src/server');
-const pkg = require('../package.json');
-
-const DEFAULT_PORT = 8080;
-const DEFAULT_HOST = '0.0.0.0';
-const PID_DIR = path.join(os.homedir(), '.serve-here');
-const LOG_DIR = path.join(os.homedir(), '.serve-here', 'logs');
-
-function ensureDirectories() {
-  if (!fs.existsSync(PID_DIR)) {
-    fs.mkdirSync(PID_DIR, { recursive: true });
-  }
-  if (!fs.existsSync(LOG_DIR)) {
-    fs.mkdirSync(LOG_DIR, { recursive: true });
-  }
-}
-
-function getPidFile(port) {
-  return path.join(PID_DIR, `serve-here-${port}.pid`);
-}
-
-function getLogFile(port) {
-  return path.join(LOG_DIR, `serve-here-${port}.log`);
-}
-
-function readPidFile(port) {
-  const pidFile = getPidFile(port);
-  if (fs.existsSync(pidFile)) {
-    try {
-      const content = fs.readFileSync(pidFile, 'utf8').trim();
-      const lines = content.split('\n');
-      const pid = parseInt(lines[0], 10);
-      const rootDir = lines[1] || '';
-      return { pid, rootDir };
-    } catch (error) {
-      return null;
-    }
-  }
-  return null;
-}
-
-function writePidFile(port, pid, rootDir) {
-  const pidFile = getPidFile(port);
-  fs.writeFileSync(pidFile, `${pid}\n${rootDir}`);
-}
-
-function removePidFile(port) {
-  const pidFile = getPidFile(port);
-  if (fs.existsSync(pidFile)) {
-    fs.unlinkSync(pidFile);
-  }
-}
-
-function isProcessRunning(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (error) {
-    return false;
-  }
-}
-
-function startDaemon(options) {
-  ensureDirectories();
-
-  const rootDir = path.resolve(options.directory || process.cwd());
-  const port = options.port || DEFAULT_PORT;
-  const host = options.host || DEFAULT_HOST;
-
-  // Check if already running
-  const pidInfo = readPidFile(port);
-  if (pidInfo && isProcessRunning(pidInfo.pid)) {
-    console.error(`Error: Server already running on port ${port} (PID: ${pidInfo.pid})`);
-    console.error(`Serving: ${pidInfo.rootDir}`);
-    process.exit(1);
-  }
-
-  // Validate directory
-  let stats;
-  try {
-    stats = fs.statSync(rootDir);
-  } catch (error) {
-    console.error(`Error: directory "${rootDir}" does not exist or is not accessible.`);
-    process.exit(1);
-  }
-  if (!stats.isDirectory()) {
-    console.error(`Error: path "${rootDir}" is not a directory.`);
-    process.exit(1);
-  }
-
-  const logFile = getLogFile(port);
-  const out = fs.openSync(logFile, 'a');
-  const err = fs.openSync(logFile, 'a');
-
-  const child = spawn(process.execPath, [__filename, '--daemon-child', '-d', rootDir, '-p', String(port), '-H', host], {
-    detached: true,
-    stdio: ['ignore', out, err],
-    env: process.env
-  });
-
-  child.unref();
-
-  writePidFile(port, child.pid, rootDir);
-
-  console.log(`Server started in background (PID: ${child.pid})`);
-  console.log(`Serving: ${rootDir}`);
-  console.log(`Listening on port: ${port}`);
-  console.log(`Log file: ${logFile}`);
-  console.log(`\nTo stop: serve-here --stop -p ${port}`);
-}
-
-function stopDaemon(port) {
-  const pidInfo = readPidFile(port);
-  if (!pidInfo) {
-    console.error(`No server running on port ${port}`);
-    process.exit(1);
-  }
-
-  if (!isProcessRunning(pidInfo.pid)) {
-    console.log(`Server (PID: ${pidInfo.pid}) is not running, cleaning up...`);
-    removePidFile(port);
-    process.exit(0);
-  }
-
-  try {
-    process.kill(pidInfo.pid, 'SIGTERM');
-    console.log(`Stopping server (PID: ${pidInfo.pid})...`);
-
-    // Wait for process to stop
-    let attempts = 0;
-    const checkInterval = setInterval(() => {
-      attempts++;
-      if (!isProcessRunning(pidInfo.pid)) {
-        clearInterval(checkInterval);
-        removePidFile(port);
-        console.log('Server stopped.');
-        process.exit(0);
-      } else if (attempts >= 10) {
-        clearInterval(checkInterval);
-        console.error('Server did not stop gracefully, force killing...');
-        try {
-          process.kill(pidInfo.pid, 'SIGKILL');
-        } catch (e) {}
-        removePidFile(port);
-        process.exit(0);
-      }
-    }, 500);
-  } catch (error) {
-    console.error(`Failed to stop server: ${error.message}`);
-    removePidFile(port);
-    process.exit(1);
-  }
-}
-
-function showStatus(port) {
-  if (port) {
-    const pidInfo = readPidFile(port);
-    if (!pidInfo) {
-      console.log(`No server running on port ${port}`);
-      return;
-    }
-
-    const running = isProcessRunning(pidInfo.pid);
-    console.log(`Port ${port}:`);
-    console.log(`  PID: ${pidInfo.pid}`);
-    console.log(`  Status: ${running ? 'running' : 'stopped'}`);
-    console.log(`  Directory: ${pidInfo.rootDir}`);
-    console.log(`  Log: ${getLogFile(port)}`);
-
-    if (!running) {
-      removePidFile(port);
-    }
+const { spawnSync } = require("child_process");
+const path = require("path");
+
+function getBinaryPath() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  let pkgName;
+  if (platform === "darwin" && arch === "x64") {
+    pkgName = "@chenpu17/serve-here-darwin-x64";
+  } else if (platform === "darwin" && arch === "arm64") {
+    pkgName = "@chenpu17/serve-here-darwin-arm64";
+  } else if (platform === "linux" && arch === "x64") {
+    pkgName = "@chenpu17/serve-here-linux-x64";
+  } else if (platform === "linux" && arch === "arm64") {
+    pkgName = "@chenpu17/serve-here-linux-arm64";
+  } else if (platform === "win32" && arch === "x64") {
+    pkgName = "@chenpu17/serve-here-windows-x64";
   } else {
-    // Show all
-    ensureDirectories();
-    const files = fs.readdirSync(PID_DIR).filter(f => f.endsWith('.pid'));
-
-    if (files.length === 0) {
-      console.log('No servers running.');
-      return;
-    }
-
-    console.log('Running servers:\n');
-    for (const file of files) {
-      const match = file.match(/serve-here-(\d+)\.pid/);
-      if (match) {
-        const p = parseInt(match[1], 10);
-        const pidInfo = readPidFile(p);
-        if (pidInfo) {
-          const running = isProcessRunning(pidInfo.pid);
-          console.log(`Port ${p}:`);
-          console.log(`  PID: ${pidInfo.pid}`);
-          console.log(`  Status: ${running ? 'running' : 'stopped'}`);
-          console.log(`  Directory: ${pidInfo.rootDir}`);
-          console.log('');
-
-          if (!running) {
-            removePidFile(p);
-          }
-        }
-      }
-    }
+    console.error("Unsupported platform: " + platform + "-" + arch);
+    process.exit(1);
   }
-}
 
-function main() {
+  const binaryName = platform === "win32" ? "serve-here.exe" : "serve-here";
   try {
-    const options = parseArguments(process.argv.slice(2));
-
-    if (options.help) {
-      printHelp();
-      process.exit(0);
-    }
-
-    if (options.version) {
-      console.log(pkg.version);
-      process.exit(0);
-    }
-
-    // Handle daemon commands
-    if (options.stop) {
-      stopDaemon(options.port || DEFAULT_PORT);
-      return;
-    }
-
-    if (options.status) {
-      showStatus(options.port);
-      return;
-    }
-
-    if (options.daemon && !options.daemonChild) {
-      startDaemon(options);
-      return;
-    }
-
-    const rootDir = path.resolve(options.directory || process.cwd());
-
-    let stats;
-    try {
-      stats = fs.statSync(rootDir);
-    } catch (error) {
-      console.error(`Error: directory "${rootDir}" does not exist or is not accessible.`);
-      process.exit(1);
-    }
-
-    if (!stats.isDirectory()) {
-      console.error(`Error: path "${rootDir}" is not a directory.`);
-      process.exit(1);
-    }
-
-    const server = createStaticServer({ rootDir });
-    const port = options.port || DEFAULT_PORT;
-    const host = options.host || DEFAULT_HOST;
-
-    if (options.daemonChild) {
-      ensureDirectories();
-      process.on('exit', () => removePidFile(port));
-    }
-
-    server.on('error', error => {
-      console.error('Failed to start server:', error.message);
-      if (options.daemonChild) {
-        removePidFile(port);
-      }
-      process.exit(1);
-    });
-
-    server.listen(port, host, () => {
-      const messageLines = [
-        `Serving ${rootDir}`,
-        `Listening on:`,
-        ...formatListeningAddresses(host, port)
-      ];
-      console.log(messageLines.join('\n  '));
-
-      // Write PID file when running as daemon child
-      if (options.daemonChild) {
-        writePidFile(port, process.pid, rootDir);
-      }
-    });
-
-    const shutdown = () => {
-      console.log('\nShutting down...');
-      if (options.daemonChild) {
-        removePidFile(port);
-      }
-      server.close(() => process.exit(0));
-    };
-
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-  } catch (error) {
-    console.error(error.message);
+    return require.resolve(pkgName + "/bin/" + binaryName);
+  } catch (e) {
+    console.error("Could not find binary for " + pkgName + ".");
+    console.error("Try reinstalling the package.");
     process.exit(1);
   }
 }
 
-function parseArguments(args) {
-  const options = {
-    directory: undefined,
-    port: undefined,
-    host: undefined,
-    help: false,
-    version: false,
-    daemon: false,
-    daemonChild: false,
-    stop: false,
-    status: false
-  };
-
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-
-    switch (arg) {
-      case '-h':
-      case '--help':
-        options.help = true;
-        break;
-      case '-V':
-      case '--version':
-        options.version = true;
-        break;
-      case '-d':
-      case '--dir':
-      case '--directory':
-        options.directory = requireValue(args, ++i, '--dir');
-        break;
-      case '-p':
-      case '--port':
-        options.port = parsePort(requireValue(args, ++i, '--port'));
-        break;
-      case '-H':
-      case '--host':
-        options.host = requireValue(args, ++i, '--host');
-        break;
-      case '-D':
-      case '--daemon':
-        options.daemon = true;
-        break;
-      case '--daemon-child':
-        options.daemonChild = true;
-        break;
-      case '--stop':
-        options.stop = true;
-        break;
-      case '--status':
-        options.status = true;
-        break;
-      default:
-        if (arg.startsWith('-')) {
-          throw new Error(`Unknown option: ${arg}`);
-        }
-        if (options.directory) {
-          throw new Error('Multiple directories specified. Use --dir <path> to set the directory.');
-        }
-        options.directory = arg;
-        break;
-    }
-  }
-
-  return options;
-}
-
-function requireValue(args, index, flagName) {
-  const value = args[index];
-  if (value === undefined) {
-    throw new Error(`Missing value for ${flagName}`);
-  }
-  return value;
-}
-
-function parsePort(value) {
-  const port = Number.parseInt(value, 10);
-  if (!Number.isInteger(port) || port < 1 || port > 65535) {
-    throw new Error(`Invalid port: ${value}`);
-  }
-  return port;
+const binaryPath = getBinaryPath();
+const args = process.argv.slice(2);
+const result = spawnSync(binaryPath, args, { stdio: "inherit" });
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
 }
-
-function formatListeningAddresses(host, port) {
-  const addresses = [];
-
-  if (host === '0.0.0.0' || host === '::') {
-    addresses.push(`http://localhost:${port}/`);
-    const interfaces = os.networkInterfaces();
-    for (const iface of Object.values(interfaces)) {
-      if (!iface) continue;
-      for (const addrInfo of iface) {
-        if (addrInfo.internal) continue;
-        if (addrInfo.family !== 'IPv4' && addrInfo.family !== 4) continue;
-        addresses.push(`http://${addrInfo.address}:${port}/`);
-      }
-    }
-  } else {
-    addresses.push(`http://${host}:${port}/`);
-  }
-
-  return [...new Set(addresses)];
-}
-
-function printHelp() {
-  console.log(`serve-here v${pkg.version}
-
-Usage:
-  serve-here [options] [directory]
-
-Options:
-  -d, --dir <path>        Directory to serve (defaults to current working directory)
-  -p, --port <number>     Port to listen on (default: ${DEFAULT_PORT})
-  -H, --host <address>    Hostname or IP to bind (default: ${DEFAULT_HOST})
-  -D, --daemon            Run as a background daemon (does not occupy terminal)
-  --stop                  Stop a running daemon (use with -p to specify port)
-  --status                Show status of running daemon(s)
-  -h, --help              Show this help message
-  -V, --version           Show version
-
-Examples:
-  serve-here                      Start server in foreground on port 8080
-  serve-here -D                   Start server as daemon on port 8080
-  serve-here -D -p 3000           Start daemon on port 3000
-  serve-here --stop               Stop daemon on port 8080
-  serve-here --stop -p 3000       Stop daemon on port 3000
-  serve-here --status             Show all running daemons`);
-}
-
-main();
+process.exit(result.status ?? 1);

package/package.json

@@ -1,13 +1,20 @@
 {
   "name": "@chenpu17/serve-here",
-  "version": "1.0.2",
+  "version": "2.0.1",
   "description": "A minimal CLI to serve static files from a directory over HTTP.",
   "bin": {
     "serve-here": "bin/serve-here.js"
   },
-  "type": "commonjs",
-  "scripts": {
-    "start": "node bin/serve-here.js"
+  "files": [
+    "bin",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@chenpu17/serve-here-darwin-x64": "2.0.1",
+    "@chenpu17/serve-here-darwin-arm64": "2.0.1",
+    "@chenpu17/serve-here-linux-x64": "2.0.1",
+    "@chenpu17/serve-here-linux-arm64": "2.0.1",
+    "@chenpu17/serve-here-windows-x64": "2.0.1"
   },
   "keywords": [
     "cli",
@@ -26,17 +33,5 @@
   "bugs": {
     "url": "https://github.com/chenpu17/serve-here/issues"
   },
-  "homepage": "https://github.com/chenpu17/serve-here#readme",
-  "files": [
-    "bin",
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=14"
-  },
-  "dependencies": {
-    "mime-types": "^2.1.35"
-  }
+  "homepage": "https://github.com/chenpu17/serve-here#readme"
 }

package/README.md

@@ -1,64 +0,0 @@
-# serve-here
-
-Serve any local directory over HTTP with a single command.  
-用一条命令把任意本地目录通过 HTTP 暴露出去。
-
-## Features | 功能特点
-- Instant static hosting for the current or specified directory.  
-  立即托管当前目录或指定目录。
-- Automatic `index.html` support plus clean directory listings.  
-  自动识别 `index.html`，无首页时提供整洁的目录列表。
-- Safe redirects for non-ASCII directory names (e.g. 中文路径).  
-  支持中文等非 ASCII 路径的安全重定向。
-- Directory rows include file size and last modified time.  
-  列表项展示文件大小与最近修改时间。
-- Works as a global install or `npx` one-off.  
-  支持全局安装或通过 `npx` 临时使用。
-
-## Installation | 安装
-
-```sh
-npm install -g @chenpu17/serve-here
-```
-
-Or run it ad‑hoc without installing globally:  
-或者临时使用：
-
-```sh
-npx @chenpu17/serve-here
-```
-
-## Usage | 使用方式
-
-```sh
-serve-here [options] [directory]
-```
-
-- Installed globally, invoke via `serve-here`; with `npx`, run `npx @chenpu17/serve-here`.  
-  全局安装后直接使用 `serve-here`；临时使用时运行 `npx @chenpu17/serve-here`。
-
-- `directory`: Directory to share; defaults to the current working directory.  
-  `directory`：要共享的目录，默认使用当前工作目录。
-- `-d, --dir <path>`: Explicit directory override.  
-  `-d, --dir <path>`：显式指定要共享的目录。
-- `-p, --port <number>`: Port to listen on (default `8080`).  
-  `-p, --port <number>`：设置监听端口（默认 `8080`）。
-- `-H, --host <address>`: Host/IP to bind (default `0.0.0.0`).  
-  `-H, --host <address>`：指定绑定的主机或 IP（默认 `0.0.0.0`）。
-- `-h, --help`: Show help.  
-  `-h, --help`：查看帮助信息。
-- `-V, --version`: Print version.  
-  `-V, --version`：查看版本号。
-
-After startup you’ll see the bound addresses in the terminal. Opening them in a browser displays your static files or a table view of the directory contents.  
-启动后终端会打印可访问的地址，浏览器打开即可查看静态文件；若目录中没有 `index.html`，将显示带有文件大小和修改时间的目录表格。
-
-## Development | 开发
-
-```sh
-npm install
-npm start
-```
-
-`npm start` serves the current project directory so you can test quickly with a browser or `curl`.  
-`npm start` 会把当前项目目录作为静态资源根目录，方便通过浏览器或 `curl` 快速验证。

package/src/server.js

@@ -1,403 +0,0 @@
-const http = require('http');
-const fs = require('fs');
-const path = require('path');
-const { lookup } = require('mime-types');
-
-const { readdir, stat } = fs.promises;
-
-/**
- * Creates an HTTP server that serves static files rooted at the provided directory.
- *
- * @param {object} options
- * @param {string} options.rootDir Absolute or relative directory to serve.
- * @param {string[]} [options.indexFiles] Index files to try when a directory is requested.
- * @param {boolean} [options.enableDirectoryListing] Whether to render a simple directory listing when no index file exists.
- * @param {Console} [options.logger] Logger implementation, defaults to console.
- * @returns {http.Server}
- */
-function createStaticServer({
-  rootDir,
-  indexFiles = ['index.html', 'index.htm'],
-  enableDirectoryListing = true,
-  logger = console
-}) {
-  if (!rootDir) {
-    throw new Error('rootDir is required to create a static server');
-  }
-
-  const resolvedRoot = path.resolve(rootDir);
-  const rootWithSep = resolvedRoot.endsWith(path.sep)
-    ? resolvedRoot
-    : `${resolvedRoot}${path.sep}`;
-
-  const server = http.createServer((req, res) => {
-    const startTime = Date.now();
-
-    void (async () => {
-      if (!req.url) {
-        sendError(res, 400, 'Bad Request', req.method === 'HEAD');
-        return;
-      }
-
-      if (req.method !== 'GET' && req.method !== 'HEAD') {
-        res.setHeader('Allow', 'GET, HEAD');
-        sendError(res, 405, 'Method Not Allowed', false);
-        logRequest(logger, req, res.statusCode, startTime);
-        return;
-      }
-
-      let decodedPath;
-      let requestPathname;
-      let requestSearch;
-      try {
-        const url = new URL(req.url, 'http://localhost');
-        requestPathname = url.pathname;
-        requestSearch = url.search;
-        decodedPath = decodeURIComponent(requestPathname);
-      } catch (error) {
-        sendError(res, 400, 'Bad Request', req.method === 'HEAD');
-        logRequest(logger, req, res.statusCode, startTime, error);
-        return;
-      }
-
-      const candidateSegments = decodedPath
-        .split('/')
-        .filter(segment => segment && segment !== '.');
-      const resolvedPath = path.resolve(resolvedRoot, ...candidateSegments);
-
-      if (!resolvedPath.startsWith(rootWithSep) && resolvedPath !== resolvedRoot) {
-        sendError(res, 403, 'Forbidden', req.method === 'HEAD');
-        logRequest(logger, req, res.statusCode, startTime);
-        return;
-      }
-
-      let stats;
-      try {
-        stats = await stat(resolvedPath);
-      } catch (error) {
-        if (error.code === 'ENOENT') {
-          sendError(res, 404, 'Not Found', req.method === 'HEAD');
-        } else {
-          sendError(res, 500, 'Internal Server Error', req.method === 'HEAD');
-          logger.error('Error reading path', resolvedPath, error);
-        }
-        logRequest(logger, req, res.statusCode, startTime, error);
-        return;
-      }
-
-      if (stats.isDirectory()) {
-        if (!requestPathname.endsWith('/')) {
-          // Align with browser expectations for relative asset loading.
-          const location = `${requestPathname}/${requestSearch}`;
-          try {
-            // Use the encoded pathname for headers (Node rejects non-ASCII in Location).
-            res.statusCode = 301;
-            res.setHeader('Location', location);
-            res.end();
-            logRequest(logger, req, res.statusCode, startTime);
-            return;
-          } catch (error) {
-            sendError(res, 400, 'Bad Request', req.method === 'HEAD');
-            logRequest(logger, req, res.statusCode, startTime, error);
-            return;
-          }
-        }
-
-        for (const indexFile of indexFiles) {
-          const candidate = path.join(resolvedPath, indexFile);
-          try {
-            const indexStats = await stat(candidate);
-            if (indexStats.isFile()) {
-              await serveFile(res, candidate, indexStats, req.method === 'HEAD');
-              logRequest(logger, req, res.statusCode, startTime);
-              return;
-            }
-          } catch (error) {
-            if (error.code !== 'ENOENT') {
-              logger.error('Error reading index file', candidate, error);
-            }
-          }
-        }
-
-        if (!enableDirectoryListing) {
-          sendError(res, 403, 'Directory listing disabled', req.method === 'HEAD');
-          logRequest(logger, req, res.statusCode, startTime);
-          return;
-        }
-
-        try {
-          await serveDirectoryListing(
-            res,
-            decodedPath,
-            resolvedPath,
-            req.method === 'HEAD'
-          );
-          logRequest(logger, req, res.statusCode, startTime);
-          return;
-        } catch (error) {
-          sendError(res, 500, 'Internal Server Error', req.method === 'HEAD');
-          logger.error('Error generating directory listing', resolvedPath, error);
-          logRequest(logger, req, res.statusCode, startTime, error);
-          return;
-        }
-      }
-
-      if (stats.isFile()) {
-        try {
-          await serveFile(res, resolvedPath, stats, req.method === 'HEAD');
-        } catch (error) {
-          logger.error('Error serving file', resolvedPath, error);
-          // Stream errors may happen after headers were sent.
-        }
-        logRequest(logger, req, res.statusCode, startTime);
-        return;
-      }
-
-      sendError(res, 403, 'Forbidden', req.method === 'HEAD');
-      logRequest(logger, req, res.statusCode, startTime);
-    })().catch(error => {
-      if (!res.headersSent) {
-        sendError(res, 500, 'Internal Server Error', req.method === 'HEAD');
-      } else {
-        res.destroy();
-      }
-      logger.error('Unhandled request error', error);
-      logRequest(logger, req, res.statusCode || 500, startTime, error);
-    });
-  });
-
-  return server;
-}
-
-function sendError(res, statusCode, message, headOnly = false) {
-  if (res.headersSent) {
-    if (!res.writableEnded) {
-      res.end();
-    }
-    return;
-  }
-
-  res.statusCode = statusCode;
-  res.setHeader('Content-Type', 'text/plain; charset=utf-8');
-  res.setHeader('Cache-Control', 'no-store');
-
-  if (headOnly) {
-    res.end();
-    return;
-  }
-
-  res.end(`${statusCode} ${message}`);
-}
-
-async function serveFile(res, filePath, stats, headOnly) {
-  const mimeType = lookup(filePath) || 'application/octet-stream';
-  res.statusCode = 200;
-  res.setHeader('Content-Type', mimeType);
-  res.setHeader('Content-Length', stats.size);
-  res.setHeader('Last-Modified', stats.mtime.toUTCString());
-  res.setHeader('Cache-Control', 'no-cache');
-
-  if (headOnly) {
-    res.end();
-    return;
-  }
-
-  await streamFile(res, filePath);
-}
-
-function streamFile(res, filePath) {
-  return new Promise((resolve, reject) => {
-    const stream = fs.createReadStream(filePath);
-    let settled = false;
-
-    const settle = (fn, arg) => {
-      if (settled) return;
-      settled = true;
-      cleanup();
-      fn(arg);
-    };
-
-    const onResponseClose = () => {
-      if (!stream.destroyed) {
-        stream.destroy();
-      }
-      settle(resolve);
-    };
-
-    const onResponseError = error => {
-      if (!stream.destroyed) {
-        stream.destroy(error);
-      }
-      settle(reject, error);
-    };
-
-    const onStreamError = error => {
-      if (!res.headersSent) {
-        sendError(res, 500, 'Internal Server Error');
-      } else {
-        res.destroy(error);
-      }
-      settle(reject, error);
-    };
-
-    const onStreamEnd = () => settle(resolve);
-
-    const cleanup = () => {
-      res.removeListener('close', onResponseClose);
-      res.removeListener('error', onResponseError);
-      stream.removeListener('error', onStreamError);
-      stream.removeListener('end', onStreamEnd);
-    };
-
-    res.on('close', onResponseClose);
-    res.on('error', onResponseError);
-    stream.on('error', onStreamError);
-    stream.on('end', onStreamEnd);
-    stream.pipe(res);
-  });
-}
-
-async function serveDirectoryListing(res, requestPath, directoryPath, headOnly) {
-  const entries = await readdir(directoryPath, { withFileTypes: true });
-  const items = entries
-    .map(entry => ({
-      name: entry.name,
-      isDirectory: entry.isDirectory()
-    }))
-    .sort((a, b) => {
-      if (a.isDirectory && !b.isDirectory) return -1;
-      if (!a.isDirectory && b.isDirectory) return 1;
-      return a.name.localeCompare(b.name);
-    });
-
-  const detailedItems = [];
-  for (const item of items) {
-    const fullPath = path.join(directoryPath, item.name);
-    try {
-      const stats = await stat(fullPath);
-      detailedItems.push({
-        ...item,
-        size: stats.isFile() ? stats.size : null,
-        mtime: stats.mtime
-      });
-    } catch (error) {
-      detailedItems.push({
-        ...item,
-        size: null,
-        mtime: null
-      });
-    }
-  }
-
-  const tableRows = detailedItems
-    .map(item => {
-      const trailingSlash = item.isDirectory ? '/' : '';
-      const href = encodeURIComponent(item.name) + trailingSlash;
-      const displayName = `${escapeHtml(item.name)}${trailingSlash}`;
-      const size = item.isDirectory ? '-' : formatBytes(item.size);
-      const modified = item.mtime ? formatDate(item.mtime) : '-';
-      return `<tr><td><a href="${href}">${displayName}</a></td><td>${size}</td><td>${modified}</td></tr>`;
-    })
-    .join('\n');
-
-  const body = `<!doctype html>
-<html>
-  <head>
-    <meta charset="utf-8">
-    <title>Index of ${escapeHtml(requestPath)}</title>
-    <style>
-      body { font-family: sans-serif; padding: 1rem 2rem; }
-      h1 { font-size: 1.5rem; margin-bottom: 1rem; }
-      table { border-collapse: collapse; width: 100%; max-width: 60rem; }
-      th, td { text-align: left; padding: 0.35rem 0.5rem; border-bottom: 1px solid #e1e4e8; }
-      th { font-weight: 600; background: #f6f8fa; }
-      td:nth-child(2), th:nth-child(2) { width: 8rem; }
-      td:nth-child(3), th:nth-child(3) { width: 16rem; }
-      a { text-decoration: none; color: #0366d6; }
-      a:hover { text-decoration: underline; }
-      @media (max-width: 600px) {
-        table { font-size: 0.9rem; }
-        td:nth-child(3), th:nth-child(3) { width: auto; }
-      }
-    </style>
-  </head>
-  <body>
-    <h1>Index of ${escapeHtml(requestPath)}</h1>
-    <table>
-      <thead>
-        <tr><th>Name</th><th>Size</th><th>Last Modified</th></tr>
-      </thead>
-      <tbody>
-        ${requestPath !== '/' ? '<tr><td><a href="../">../</a></td><td>-</td><td>-</td></tr>' : ''}
-        ${tableRows}
-      </tbody>
-    </table>
-    <footer>
-      <p>
-        Served by <a href="https://github.com/chenpu17/serve-here" target="_blank" rel="noreferrer">serve-here</a>
-      </p>
-    </footer>
-  </body>
-</html>`;
-
-  res.statusCode = 200;
-  res.setHeader('Content-Type', 'text/html; charset=utf-8');
-  res.setHeader('Cache-Control', 'no-cache');
-
-  if (headOnly) {
-    res.end();
-    return;
-  }
-
-  res.end(body);
-}
-
-function escapeHtml(value) {
-  return value.replace(/[&<>"']/g, character => {
-    const replacements = {
-      '&': '&amp;',
-      '<': '&lt;',
-      '>': '&gt;',
-      '"': '&quot;',
-      "'": '&#39;'
-    };
-    return replacements[character] || character;
-  });
-}
-
-function formatBytes(bytes) {
-  if (bytes === null || bytes === undefined) {
-    return '-';
-  }
-  if (bytes === 0) {
-    return '0 B';
-  }
-  const units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
-  const exponent = Math.min(
-    Math.floor(Math.log(bytes) / Math.log(1024)),
-    units.length - 1
-  );
-  const size = bytes / 1024 ** exponent;
-  return `${size >= 10 ? size.toFixed(0) : size.toFixed(1)} ${units[exponent]}`;
-}
-
-function formatDate(date) {
-  if (!date) return '-';
-  return date.toLocaleString();
-}
-
-function logRequest(logger, req, statusCode, startTime, error) {
-  const duration = Date.now() - startTime;
-  const method = req.method;
-  const url = req.url;
-  const message = `${method} ${url} ${statusCode} ${duration}ms`;
-  if (error) {
-    logger.error(message);
-  } else {
-    logger.info ? logger.info(message) : logger.log(message);
-  }
-}
-
-module.exports = {
-  createStaticServer
-};