httpath 1.0.0

package/dist/index.mjs

@@ -0,0 +1,532 @@
+#!/usr/bin/env node
+import{parseArgs as e}from"node:util";import{extname as t,join as n,normalize as r,resolve as i,sep as a}from"node:path";import{createServer as o}from"node:http";import{access as s,readFile as c,readdir as l,stat as u}from"node:fs/promises";import{createReadStream as d,watch as f}from"node:fs";import{spawn as p}from"node:child_process";import{EventEmitter as m}from"node:events";const h=e=>({success:!0,data:e}),g=e=>({success:!1,error:e}),_=e=>e.success===!0,v=(e,t)=>{try{return h(e())}catch(e){return g(t?t(e):e)}},y=async(e,t)=>{try{return h(await e())}catch(e){return g(t?t(e):e)}};var b=class extends Error{constructor(e,t,n,r){super(e),this.code=t,this.statusCode=n,this.path=r,this.name=`HTTPathError`}},ee=class extends b{constructor(e,t){super(e,`FS_ERROR`,500,t),this.name=`FileSystemError`}},te=class extends b{constructor(e,t){super(e,`SECURITY_ERROR`,403,t),this.name=`SecurityError`}},ne=class extends b{constructor(e){super(e,`CONFIG_ERROR`,500),this.name=`ConfigurationError`}},re=class extends b{constructor(e){super(e,`NETWORK_ERROR`,500),this.name=`NetworkError`}};const x=e=>(t,...n)=>t instanceof e?t:new e(t instanceof Error?t.message:String(t),...n),S=x(ee),C=x(te),ie=x(ne),w=x(re);globalThis.success=h,globalThis.failure=g,globalThis.isSuccess=_;const T={port:8080,rootPath:process.cwd(),reload:!1,ignorePatterns:[`node_modules`,`.git`,`.DS_Store`],enableDirectoryListing:!0,restartOnChange:!1,logLevel:`info`,debounceMs:500},ae={port:{type:`string`,short:`p`,default:T.port.toString()},path:{type:`string`,short:`d`,default:T.rootPath},reload:{type:`boolean`,short:`r`,default:T.reload},ignore:{type:`string`,short:`i`,default:(T.ignorePatterns||[]).join(`,`)},"no-listing":{type:`boolean`,default:!T.enableDirectoryListing},"restart-on-change":{type:`boolean`,default:T.restartOnChange},log:{type:`string`,default:T.logLevel},help:{type:`boolean`,short:`h`,default:!1},version:{type:`boolean`,short:`v`,default:!1}},E=`
+HTTPath - A minimalist Node.js file server with hot-reload capabilities
+
+Usage: httpath [options]
+
+Options:
+  -p, --port <number>     Port number to listen on (default: 8080)
+  -d, --path <directory>  Directory to serve files from (default: current directory)
+  -r, --reload            Enable hot-reload functionality (default: false)
+  -i, --ignore <patterns>  Comma-separated patterns to ignore (default: node_modules,.git,.DS_Store)
+  --no-listing            Disable directory listing (default: false)
+  --restart-on-change     Restart server process on file changes (default: false)
+  --log <level>           Log level: debug, info, warn, error (default: info)
+  -h, --help              Show this help message
+  -v, --version           Show version number
+
+Examples:
+  httpath                           # Start server on port 8080 in current directory
+  httpath --port 3000               # Start server on port 3000
+  httpath --path ./public           # Serve files from ./public directory
+  httpath --reload                  # Enable hot-reload for development
+  httpath -p 3000 -d ./dist -r      # Combined options
+
+Documentation: https://github.com/MetalbolicX/httpath
+`,D={name:`HTTPath`,version:`0.1.0`,description:`A minimalist Node.js file server with hot-reload capabilities`,author:`José Martínez Santana`,license:`MIT`},O=(t=process.argv.slice(2))=>{let n=v(()=>{let{values:n}=e({args:t,options:ae,allowPositionals:!0});n.help&&(console.log(E),process.exit(0)),n.version&&(console.log(`${D.name} v${D.version}\n${D.description}`),process.exit(0));let r=parseInt(n.port,10);if(isNaN(r)||r<1||r>65535)throw Error(`Invalid port number: ${n.port}. Port must be between 1 and 65535.`);let a=i(n.path),o=n.ignore?n.ignore.split(`,`).map(e=>e.trim()).filter(Boolean):T.ignorePatterns;return{port:r,rootPath:a,reload:!!n.reload,ignorePatterns:o,enableDirectoryListing:!n[`no-listing`],restartOnChange:!!n[`restart-on-change`],logLevel:n.log||T.logLevel}},ie);return n.success||(console.error(`❌ Error parsing arguments: ${n.error.message}`),console.log(E),process.exit(1)),n},k=e=>!Number.isInteger(e.port)||e.port<1||e.port>65535?(console.error(`❌ Invalid port: ${e.port}. Port must be between 1 and 65535.`),!1):typeof e.rootPath!=`string`||e.rootPath.length===0?(console.error(`❌ Invalid root path: ${e.rootPath}`),!1):typeof e.reload==`boolean`?!0:(console.error(`❌ Invalid reload flag: ${e.reload}. Must be boolean.`),!1),oe={allowDotFiles:!1,maxPathLength:1e3,blockedPatterns:`../,..\\,%2e%2e%2f,%2e%2e%5c,..%2f,..%5c,\0,%00,\r,
+,	,CON,PRN,AUX,NUL,COM1,COM2,COM3,COM4,COM5,COM6,COM7,COM8,COM9,LPT1,LPT2,LPT3,LPT4,LPT5,LPT6,LPT7,LPT8,LPT9`.split(`,`)},se=new Set([`windows`,`system32`,`program files`,`program files (x86)`,`users`,`documents and settings`,`boot`,`etc`,`bin`,`sbin`,`usr`,`var`,`proc`,`sys`,`dev`,`root`,`home`]),ce=(e,t,n={})=>{let o={...oe,...n};if(!e||typeof e!=`string`)return failure(C(Error({isValid:!1,resolvedPath:``,error:`Invalid path: path must be a non-empty string`}.error)));if(!t||typeof t!=`string`)return failure(C(Error({isValid:!1,resolvedPath:``,error:`Invalid root path: root path must be a non-empty string`}.error)));if(e.length>o.maxPathLength){let e={isValid:!1,resolvedPath:``,error:`Path too long: exceeds ${o.maxPathLength} characters`};return failure(C(Error(e.error)))}let s=v(()=>decodeURIComponent(e),()=>C(Error(`Invalid URL encoding in path`)));if(!s.success)return failure(s.error);let c=s.data,l=c.toLowerCase();for(let e of o.blockedPatterns)if(l.includes(e.toLowerCase())){let t={isValid:!1,resolvedPath:``,error:`Blocked pattern detected: ${e}`};return failure(C(Error(t.error)))}let u=c.replace(/\\/g,`/`),d=v(()=>i(t,u.startsWith(`/`)?u.slice(1):u),C);if(!d.success)return failure(d.error);let f=d.data,p=r(t),m=r(f);if(!m.startsWith(p+a)&&m!==p)return failure(C(Error({isValid:!1,resolvedPath:``,error:`Path traversal detected: path is outside root directory`}.error)));if(!o.allowDotFiles){let e=u.split(`/`);for(let t of e)if(t.startsWith(`.`)&&t!==`.`&&t!==`..`)return failure(C(Error({isValid:!1,resolvedPath:``,error:`Dot files not allowed`}.error)))}let h=m.toLowerCase().split(a);for(let e of h)if(se.has(e)){let t={isValid:!1,resolvedPath:``,error:`Access to protected directory denied: ${e}`};return failure(C(Error(t.error)))}let g={isValid:!0,resolvedPath:m};return success(g)},le={".html":`text/html`,".htm":`text/html`,".css":`text/css`,".js":`text/javascript`,".mjs":`text/javascript`,".ts":`text/typescript`,".jsx":`text/jsx`,".tsx":`text/tsx`,".json":`application/json`,".xml":`application/xml`,".rss":`application/rss+xml`,".atom":`application/atom+xml`,".png":`image/png`,".jpg":`image/jpeg`,".jpeg":`image/jpeg`,".gif":`image/gif`,".svg":`image/svg+xml`,".ico":`image/x-icon`,".webp":`image/webp`,".bmp":`image/bmp`,".tiff":`image/tiff`,".tif":`image/tiff`,".woff":`font/woff`,".woff2":`font/woff2`,".ttf":`font/ttf`,".otf":`font/otf`,".eot":`application/vnd.ms-fontobject`,".pdf":`application/pdf`,".doc":`application/msword`,".docx":`application/vnd.openxmlformats-officedocument.wordprocessingml.document`,".xls":`application/vnd.ms-excel`,".xlsx":`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,".ppt":`application/vnd.ms-powerpoint`,".pptx":`application/vnd.openxmlformats-officedocument.presentationml.presentation`,".txt":`text/plain`,".md":`text/markdown`,".csv":`text/csv`,".log":`text/plain`,".yaml":`text/yaml`,".yml":`text/yaml`,".toml":`text/plain`,".ini":`text/plain`,".conf":`text/plain`,".cfg":`text/plain`,".zip":`application/zip`,".rar":`application/vnd.rar`,".7z":`application/x-7z-compressed`,".tar":`application/x-tar`,".gz":`application/gzip`,".bz2":`application/x-bzip2`,".mp3":`audio/mpeg`,".wav":`audio/wav`,".ogg":`audio/ogg`,".m4a":`audio/mp4`,".aac":`audio/aac`,".flac":`audio/flac`,".mp4":`video/mp4`,".avi":`video/x-msvideo`,".mov":`video/quicktime`,".wmv":`video/x-ms-wmv`,".flv":`video/x-flv`,".webm":`video/webm`,".mkv":`video/x-matroska`,".exe":`application/octet-stream`,".msi":`application/x-msdownload`,".deb":`application/vnd.debian.binary-package`,".rpm":`application/x-rpm`,".dmg":`application/x-apple-diskimage`,".iso":`application/x-iso9660-image`,".map":`application/json`,".lock":`text/plain`,".gitignore":`text/plain`,".env":`text/plain`,".dockerfile":`text/plain`,".makefile":`text/plain`},ue=new Set([`text/html`,`text/css`,`text/javascript`,`text/plain`,`text/markdown`,`text/xml`,`application/json`,`application/xml`,`image/svg+xml`]),de=(e,t={})=>{let{defaultType:n=`application/octet-stream`,customMappings:r={}}=t,i=e.startsWith(`.`)?e.toLowerCase():`.${e.toLowerCase()}`;return r[i]||le[i]||n},fe=e=>ue.has(e)||e.startsWith(`text/`),pe=e=>{let t=e.lastIndexOf(`.`);return t===-1||t===0?``:e.slice(t).toLowerCase()},A=(e,t={})=>de(pe(e),t),j={showHidden:!1,sortBy:`name`,sortOrder:`asc`},M={customCSS:``,customJS:``,favicon:`data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><text y=".9em" font-size="90">📁</text></svg>`,theme:`auto`},N=async(e,t={})=>{let r={...j,...t},i=await y(()=>l(e),S);if(!i.success)return g(i.error);let a=[];for(let t of i.data){if(!r.showHidden&&t.startsWith(`.`))continue;let i=n(e,t),o=await y(()=>u(i),S);o.success?a=[...a,{name:t,isDir:o.data.isDirectory(),size:o.data.size,lastModified:o.data.mtime}]:console.warn(`Warning: Cannot access file ${t}:`,o.error)}return a.sort((e,t)=>{if(e.isDir&&!t.isDir)return-1;if(!e.isDir&&t.isDir)return 1;let n=0;switch(r.sortBy){case`size`:n=(e.size||0)-(t.size||0);break;case`date`:n=(e.lastModified?.getTime()||0)-(t.lastModified?.getTime()||0);break;default:n=e.name.localeCompare(t.name);break}return r.sortOrder===`desc`?-n:n}),h(a)},P=async(e,t,n={})=>{let r={...j,...n},i={...M,...n},a=await N(e,r);return a.success?h(z({title:`Directory listing for ${t}`,path:t,files:a.data,parentPath:t===`/`?void 0:F(t),serverInfo:{name:`HTTPath`,version:`0.1.0`,uptime:process.uptime()}},i)):h(B(`Error reading directory`,a.error.message))},F=e=>{let t=e.split(`/`).filter(e=>e);return t.pop(),t.length>0?`/`+t.join(`/`):`/`},I=e=>{if(e===0)return`0 B`;let t=[`B`,`KB`,`MB`,`GB`,`TB`],n=Math.floor(Math.log(e)/Math.log(1024));return`${(e/1024**n).toFixed(n===0?0:1)} ${t[n]}`},L=e=>e.toLocaleString(`en-US`,{year:`numeric`,month:`short`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`}),R=e=>{if(e.isDir)return`📁`;let n=t(e.name).toLowerCase();return{".html":`🌐`,".htm":`🌐`,".css":`🎨`,".js":`⚡`,".mjs":`⚡`,".ts":`📘`,".jsx":`⚛️`,".tsx":`⚛️`,".json":`📋`,".xml":`📋`,".txt":`📄`,".md":`📝`,".pdf":`📕`,".doc":`📘`,".docx":`📘`,".xls":`📗`,".xlsx":`📗`,".png":`🖼️`,".jpg":`🖼️`,".jpeg":`🖼️`,".gif":`🖼️`,".svg":`🎨`,".mp3":`🎵`,".wav":`🎵`,".mp4":`🎬`,".avi":`🎬`,".zip":`📦`,".tar":`📦`,".gz":`📦`}[n]||`📄`},z=(e,t)=>{let{title:r,path:i,files:a,parentPath:o}=e,s=o?`<tr><td><a href="${o}" class="parent-link">📁 ..</a></td><td>-</td><td>-</td></tr>`:``,c=a.map(e=>{let t=n(i,e.name).replace(/\\/g,`/`),r=e.isDir?`${e.name}/`:e.name,a=R(e),o=e.isDir?`-`:I(e.size||0),s=e.lastModified?L(e.lastModified):`-`;return`
+      <tr>
+        <td><a href="${t}" class="${e.isDir?`directory`:`file`}">${a} ${r}</a></td>
+        <td>${o}</td>
+        <td>${s}</td>
+      </tr>`}).join(``);return`
+<!DOCTYPE html>
+<html lang="en" class="${t.theme===`dark`?`theme-dark`:t.theme===`light`?`theme-light`:``}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${r}</title>
+    <link rel="icon" href="${t.favicon}">
+    <style>
+        :root {
+            --bg-color: #ffffff;
+            --text-color: #333333;
+            --border-color: #e1e5e9;
+            --hover-color: #f8f9fa;
+            --link-color: #0066cc;
+            --header-bg: #f8f9fa;
+        }
+
+        .theme-dark {
+            --bg-color: #1a1a1a;
+            --text-color: #e1e1e1;
+            --border-color: #333333;
+            --hover-color: #2a2a2a;
+            --link-color: #4da6ff;
+            --header-bg: #2a2a2a;
+        }
+
+        @media (prefers-color-scheme: dark) {
+            :root {
+                --bg-color: #1a1a1a;
+                --text-color: #e1e1e1;
+                --border-color: #333333;
+                --hover-color: #2a2a2a;
+                --link-color: #4da6ff;
+                --header-bg: #2a2a2a;
+            }
+        }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            line-height: 1.6;
+            margin: 0;
+            padding: 20px;
+            background-color: var(--bg-color);
+            color: var(--text-color);
+        }
+
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+        }
+
+        h1 {
+            border-bottom: 2px solid var(--border-color);
+            padding-bottom: 10px;
+            margin-bottom: 20px;
+            display: flex;
+            align-items: center;
+            gap: 10px;
+        }
+
+        .breadcrumb {
+            font-size: 0.9em;
+            color: var(--link-color);
+            margin-bottom: 15px;
+        }
+
+        .breadcrumb a {
+            color: var(--link-color);
+            text-decoration: none;
+        }
+
+        .breadcrumb a:hover {
+            text-decoration: underline;
+        }
+
+        table {
+            width: 100%;
+            border-collapse: collapse;
+            margin-bottom: 20px;
+            background: var(--bg-color);
+            border-radius: 8px;
+            overflow: hidden;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+        }
+
+        th {
+            background-color: var(--header-bg);
+            padding: 12px 15px;
+            text-align: left;
+            font-weight: 600;
+            border-bottom: 1px solid var(--border-color);
+        }
+
+        td {
+            padding: 10px 15px;
+            border-bottom: 1px solid var(--border-color);
+        }
+
+        tr:hover {
+            background-color: var(--hover-color);
+        }
+
+        tr:last-child td {
+            border-bottom: none;
+        }
+
+        a {
+            color: var(--link-color);
+            text-decoration: none;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        a:hover {
+            text-decoration: underline;
+        }
+
+        .parent-link {
+            font-weight: 600;
+            opacity: 0.8;
+        }
+
+        .directory {
+            font-weight: 500;
+        }
+
+        .footer {
+            margin-top: 30px;
+            padding-top: 20px;
+            border-top: 1px solid var(--border-color);
+            text-align: center;
+            color: var(--text-color);
+            opacity: 0.7;
+            font-size: 0.9em;
+        }
+
+        .stats {
+            display: flex;
+            justify-content: space-between;
+            margin-bottom: 20px;
+            font-size: 0.9em;
+            color: var(--text-color);
+            opacity: 0.8;
+        }
+
+        @media (max-width: 768px) {
+            body {
+                padding: 10px;
+            }
+
+            table {
+                font-size: 0.9em;
+            }
+
+            .stats {
+                flex-direction: column;
+                gap: 5px;
+            }
+        }
+
+        ${t.customCSS}
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>📁 Directory listing for ${i}</h1>
+
+        <div class="stats">
+            <span>${a.length} items</span>
+            <span>Served by HTTPath v${e.serverInfo?.version}</span>
+        </div>
+
+        <table>
+            <thead>
+                <tr>
+                    <th>Name</th>
+                    <th>Size</th>
+                    <th>Modified</th>
+                </tr>
+            </thead>
+            <tbody>
+                ${s}
+                ${c}
+            </tbody>
+        </table>
+
+        <div class="footer">
+            <p>HTTPath - A minimalist Node.js file server</p>
+        </div>
+    </div>
+
+    ${t.customJS?`<script>${t.customJS}<\/script>`:``}
+</body>
+</html>`},B=(e,t)=>`
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Error - HTTPath</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            min-height: 100vh;
+            margin: 0;
+            background-color: #f8f9fa;
+            color: #333;
+        }
+        .error-container {
+            text-align: center;
+            padding: 40px;
+            background: white;
+            border-radius: 8px;
+            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+        }
+        .error-icon {
+            font-size: 4em;
+            margin-bottom: 20px;
+        }
+        h1 {
+            color: #dc3545;
+            margin-bottom: 10px;
+        }
+        p {
+            color: #666;
+            line-height: 1.6;
+        }
+    </style>
+</head>
+<body>
+    <div class="error-container">
+        <div class="error-icon">❌</div>
+        <h1>${e}</h1>
+        <p>${t}</p>
+    </div>
+</body>
+</html>`,V=async e=>h((await y(()=>s(e),S)).success),H=async e=>await y(()=>u(e),S),me=async e=>await y(()=>c(e,`utf8`),S),he=e=>d(e),ge=e=>fe(A(e))?`buffer`:`stream`,U={watchPath:process.cwd(),ignored:[`node_modules`,`.git`,`.vscode`,`.idea`,`dist`,`build`,`.next`,`.nuxt`,`coverage`,`.nyc_output`,`*.log`,`.DS_Store`,`Thumbs.db`],debounceMs:500,restartOnChange:!1},W=`
+<script>
+(function() {
+  'use strict';
+
+  let eventSource;
+  let reconnectAttempts = 0;
+  const maxReconnectAttempts = 10;
+  const baseReconnectDelay = 1000;
+
+  function connect() {
+    console.log('[HTTPath] Connecting to hot-reload server...');
+
+    eventSource = new EventSource('/__reload__');
+
+    eventSource.onopen = function() {
+      console.log('[HTTPath] Hot-reload connected');
+      reconnectAttempts = 0;
+
+      // Show connection indicator
+      showConnectionStatus('connected');
+    };
+
+    eventSource.onmessage = function(event) {
+      const data = event.data;
+      console.log('[HTTPath] Received reload signal:', data);
+
+      if (data === 'reload') {
+        console.log('[HTTPath] Reloading page...');
+        showReloadNotification();
+
+        // Small delay to show notification
+        setTimeout(() => {
+          window.location.reload();
+        }, 200);
+      }
+    };
+
+    eventSource.onerror = function() {
+      console.warn('[HTTPath] Hot-reload connection lost');
+      eventSource.close();
+
+      showConnectionStatus('disconnected');
+
+      if (reconnectAttempts < maxReconnectAttempts) {
+        reconnectAttempts++;
+        const delay = baseReconnectDelay * Math.pow(1.5, reconnectAttempts - 1);
+
+        console.log(\`[HTTPath] Reconnecting in \${delay}ms... (attempt \${reconnectAttempts})\`);
+
+        setTimeout(connect, delay);
+      } else {
+        console.error('[HTTPath] Max reconnection attempts reached. Please refresh the page.');
+        showConnectionStatus('failed');
+      }
+    };
+  }
+
+  function showConnectionStatus(status) {
+    const indicator = getOrCreateIndicator();
+
+    switch (status) {
+      case 'connected':
+        indicator.style.background = '#28a745';
+        indicator.title = 'Hot-reload connected';
+        indicator.textContent = '🔄';
+        break;
+      case 'disconnected':
+        indicator.style.background = '#ffc107';
+        indicator.title = 'Hot-reload disconnected - attempting to reconnect...';
+        indicator.textContent = '⏳';
+        break;
+      case 'failed':
+        indicator.style.background = '#dc3545';
+        indicator.title = 'Hot-reload failed - refresh page to reconnect';
+        indicator.textContent = '❌';
+        break;
+    }
+  }
+
+  function showReloadNotification() {
+    const notification = document.createElement('div');
+    notification.style.cssText = \`
+      position: fixed;
+      top: 20px;
+      right: 20px;
+      background: #007bff;
+      color: white;
+      padding: 12px 20px;
+      border-radius: 6px;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      font-size: 14px;
+      font-weight: 500;
+      box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+      z-index: 10000;
+      animation: slideIn 0.3s ease-out;
+    \`;
+
+    notification.textContent = '🔄 Reloading...';
+
+    const style = document.createElement('style');
+    style.textContent = \`
+      @keyframes slideIn {
+        from { transform: translateX(100%); opacity: 0; }
+        to { transform: translateX(0); opacity: 1; }
+      }
+    \`;
+
+    document.head.appendChild(style);
+    document.body.appendChild(notification);
+  }
+
+  function getOrCreateIndicator() {
+    let indicator = document.getElementById('httpath-reload-indicator');
+
+    if (!indicator) {
+      indicator = document.createElement('div');
+      indicator.id = 'httpath-reload-indicator';
+      indicator.style.cssText = \`
+        position: fixed;
+        bottom: 20px;
+        right: 20px;
+        width: 40px;
+        height: 40px;
+        border-radius: 50%;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-size: 16px;
+        color: white;
+        font-weight: bold;
+        cursor: pointer;
+        box-shadow: 0 2px 8px rgba(0,0,0,0.2);
+        z-index: 9999;
+        transition: all 0.3s ease;
+        user-select: none;
+      \`;
+
+      indicator.addEventListener('click', () => {
+        if (eventSource && eventSource.readyState === EventSource.OPEN) {
+          window.location.reload();
+        } else {
+          connect();
+        }
+      });
+
+      document.body.appendChild(indicator);
+    }
+
+    return indicator;
+  }
+
+  // Start connection when DOM is ready
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', connect);
+  } else {
+    connect();
+  }
+
+  // Cleanup on page unload
+  window.addEventListener('beforeunload', () => {
+    if (eventSource) {
+      eventSource.close();
+    }
+  });
+})();
+<\/script>`;var G=class extends m{constructor(e={}){super(),this.watcher=null,this.clients=new Map,this.debounceTimer=null,this.options={...U,...e}}start(){this.watcher&&this.stop();let e=v(()=>{this.watcher=f(this.options.watchPath,{recursive:!0},(e,t)=>{t&&this.handleFileChange(e,t)}),console.log(`🔄 Hot-reload watching: ${this.options.watchPath}`),process.on(`SIGINT`,()=>this.stop()),process.on(`SIGTERM`,()=>this.stop())},S);return e.success?h(void 0):(console.warn(`File watching not supported on this system:`,e.error),g(e.error))}stop(){this.watcher&&=(this.watcher.close(),null);for(let e of this.clients.values())this.removeClient(e.id);this.debounceTimer&&=(clearTimeout(this.debounceTimer),null),console.log(`🔄 Hot-reload stopped`)}handleSSEConnection(e,t){let n=this.generateClientId();t.writeHead(200,{"Content-Type":`text/event-stream`,"Cache-Control":`no-cache`,Connection:`keep-alive`,"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Headers":`Cache-Control`,"Access-Control-Allow-Methods":`GET, OPTIONS`}),t.write(`data: connected
+
+`);let r={response:t,id:n,connectedAt:new Date};this.clients.set(n,r),e.on(`close`,()=>{this.removeClient(n)}),e.on(`aborted`,()=>{this.removeClient(n)}),t.on(`error`,e=>{console.warn(`SSE client error for ${n}:`,e.message),this.removeClient(n)}),console.log(`🔗 Hot-reload client connected: ${n} (${this.clients.size} total)`),this.emit(`client-connected`,n)}broadcastReload(e){if(this.clients.size===0)return;let t=[];for(let[e,n]of this.clients)try{n.response.write(`data: reload
+
+`)}catch(n){console.warn(`Failed to send reload signal to client ${e}:`,n),t=[...t,e]}for(let e of t)this.removeClient(e);console.log(`📡 Reload signal sent to ${this.clients.size} clients`),e&&this.emit(`reload-triggered`,e)}injectScript(e){return e.includes(`</body>`)?e.replace(`</body>`,`${W}</body>`):e.includes(`</html>`)?e.replace(`</html>`,`${W}</html>`):e+W}getClientCount(){return this.clients.size}getClientInfo(){return Array.from(this.clients.values()).map(e=>({id:e.id,connectedAt:e.connectedAt}))}handleFileChange(e,t){this.shouldIgnoreFile(t)||(this.debounceTimer&&clearTimeout(this.debounceTimer),this.debounceTimer=setTimeout(()=>{console.log(`📝 File changed: ${t}`);let n={type:this.getEventType(e),path:t,timestamp:new Date},r=this.shouldRestartServer([t]),i=this.shouldTriggerBrowserReload([t]);if(this.options.restartOnChange||r){console.log(`🔁 Restart requested due to change: ${t}`);try{this.restartProcess()}catch(e){console.warn(`Failed to restart process:`,e)}return}i&&this.broadcastReload(n),this.emit(`file-changed`,n)},this.options.debounceMs))}shouldIgnoreFile(e){return this.options.ignored.some(t=>t.includes(`*`)?new RegExp(t.replace(/\*/g,`.*`),`i`).test(e):e.includes(t))}getEventType(e){switch(e){case`change`:return`file-changed`;case`rename`:return`file-added`;default:return`file-changed`}}shouldRestartServer(e){let t=[/\.ts$/i,/\.js$/i,/\.mjs$/i,/\.json$/i,/\.toml$/i,/\.ya?ml$/i,/deno\.json/i,/deno\.lock/i,/package\.json/i];return e.some(e=>t.some(t=>t.test(e)))}shouldTriggerBrowserReload(e){let t=[/\.html?$/i,/\.css$/i,/\.s[ac]ss$/i,/\.less$/i,/\.js$/i,/\.jsx$/i,/\.ts$/i,/\.tsx$/i,/\.vue$/i,/\.svelte$/i,/\.md$/i,/\.(png|jpe?g|gif|svg|webp|ico)$/i,/\.(woff2?|ttf|eot)$/i,/\.json$/i];return e.some(e=>t.some(t=>t.test(e)))}restartProcess(){let e=process.argv.slice(1);p(process.execPath,e,{detached:!0,stdio:`inherit`}).unref(),console.log(`🔁 Spawned replacement process, exiting current process...`),process.exit(0)}generateClientId(){return`client_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}removeClient(e){let t=this.clients.get(e);t&&(v(()=>t.response.end(),()=>Error(`Error closing connection`)),this.clients.delete(e),console.log(`🔗 Hot-reload client disconnected: ${e} (${this.clients.size} remaining)`),this.emit(`client-disconnected`,e))}};const _e=e=>new G(e),ve={level:`info`,format:`simple`,includeTimestamp:!0,colorize:!0},K={reset:`\x1B[0m`,bright:`\x1B[1m`,dim:`\x1B[2m`,red:`\x1B[31m`,green:`\x1B[32m`,yellow:`\x1B[33m`,blue:`\x1B[34m`,magenta:`\x1B[35m`,cyan:`\x1B[36m`,white:`\x1B[37m`,gray:`\x1B[90m`},q={debug:0,info:1,warn:2,error:3},ye={debug:K.gray,info:K.blue,warn:K.yellow,error:K.red};var be=class{constructor(e={}){this.options={...ve,...e},this.startTime=Date.now()}debug(e,...t){this.log(`debug`,e,...t)}info(e,...t){this.log(`info`,e,...t)}warn(e,...t){this.log(`warn`,e,...t)}error(e,...t){this.log(`error`,e,...t)}logRequest(e,t,n){let r=this.formatTimestamp(),i=`${this.colorize(e,K.cyan)} ${this.colorize(t,K.white)}`;this.options.format===`detailed`&&n&&(i+=this.colorize(` - ${n}`,K.gray)),this.writeLog(`info`,i,r)}logResponse(e,t){let n=this.formatTimestamp(),r=this.getStatusColor(e),i=`Response: ${this.colorize(e.toString(),r)}`;if(t!==void 0){let e=t>1e3?K.yellow:t>500?K.cyan:K.green,n=this.colorize(`${t}ms`,e);i+=` in ${n}`}this.writeLog(`info`,i,n)}createLogEntry(e,t,n){return{level:e,message:t,timestamp:new Date,...n}}setLevel(e){this.options.level=e}getLevel(){return this.options.level}shouldLog(e){return q[e]>=q[this.options.level]}getUptime(){return Date.now()-this.startTime}formatUptime(){let e=this.getUptime(),t=Math.floor(e/1e3)%60,n=Math.floor(e/(1e3*60))%60,r=Math.floor(e/(1e3*60*60));return r>0?`${r}h ${n}m ${t}s`:n>0?`${n}m ${t}s`:`${t}s`}log(e,t,...n){if(!this.shouldLog(e))return;let r=this.formatTimestamp(),i=this.formatMessage(t,n);this.writeLog(e,i,r)}writeLog(e,t,n){let r=``;if(this.options.includeTimestamp&&n&&(r+=this.colorize(`[${n}] `,K.gray)),this.options.format!==`simple`){let t=e.toUpperCase().padEnd(5);r+=this.colorize(`${t} `,ye[e])}r+=t,(e===`error`?process.stderr:process.stdout).write(r+`
+`)}formatMessage(e,t){if(t.length===0)return e;let n=e;for(let e of t)typeof e==`object`?n+=` `+JSON.stringify(e,null,2):n+=` `+String(e);return n}formatTimestamp(){let e=new Date;return this.options.format===`json`?e.toISOString():e.toLocaleTimeString(`en-US`,{hour12:!1})}colorize(e,t){return!this.options.colorize||!process.stdout.isTTY?e:t+e+K.reset}getStatusColor(e){return e>=200&&e<300?K.green:e>=300&&e<400?K.cyan:e>=400&&e<500?K.yellow:e>=500?K.red:K.white}};const J=e=>new be(e);J();const xe={startPort:8080,endPort:8180,timeout:2e3},Se=(e,t=2e3)=>new Promise(n=>{let r=o(),i=!1,a=setTimeout(()=>{i||(i=!0,r.close(),n(h(!1)))},t);r.once(`error`,e=>{i||(i=!0,clearTimeout(a),r.close(),e.code===`EADDRINUSE`?n(h(!1)):n(g(w(e))))}),r.once(`listening`,()=>{i||(i=!0,clearTimeout(a),r.close(()=>{n(h(!0))}))}),r.listen(e)}),Y=async(e={})=>{let t={...xe,...e};if(t.startPort<1||t.startPort>65535)return g(w(Error(`Invalid start port: ${t.startPort}. Must be between 1 and 65535.`)));if(t.endPort<t.startPort||t.endPort>65535)return g(w(Error(`Invalid end port: ${t.endPort}. Must be between ${t.startPort} and 65535.`)));for(let e=t.startPort;e<=t.endPort;e++){let n=await Se(e,t.timeout);if(_(n)&&n.data)return h(e)}return g(w(Error(`No available ports found in range ${t.startPort}-${t.endPort}`)))};var Ce=class{constructor(e){this.server=null,this.hotReload=null,this.logger=J(),this.isRunning=!1,this.config=e,e.reload&&(this.hotReload=new G({watchPath:e.rootPath,ignored:e.ignorePatterns||void 0,debounceMs:e.debounceMs||void 0,restartOnChange:e.restartOnChange||!1}))}async start(){if(this.isRunning)throw Error(`Server is already running`);let e=await Y({startPort:this.config.port});if(!_(e))throw Error(`Failed to find available port: ${e.error.message}`);let t=e.data;if(this.server=o((e,t)=>{this.handleRequest(e,t)}),this.hotReload){let e=this.hotReload.start();_(e)?this.logger.info(`🔄 Hot-reload enabled`):this.logger.warn(`Hot-reload failed to start:`,e.error)}return new Promise((e,n)=>{this.server.listen(t,()=>{this.isRunning=!0,this.logger.info(`🚀 Server running at http://localhost:${t}`),this.logger.info(`📁 Serving files from: ${this.config.rootPath}`),this.logger.info(`
+Press Ctrl+C to stop the server
+`),e({port:t,server:this.server,config:this.config,stop:()=>this.stop()})}),this.server.on(`error`,e=>{e.code===`EADDRINUSE`?n(Error(`Port ${t} is already in use`)):n(e)})})}async stop(){if(!(!this.isRunning||!this.server))return this.logger.info(`
+
+👋 Shutting down gracefully...`),this.hotReload&&this.hotReload.stop(),new Promise(e=>{this.server.close(()=>{this.isRunning=!1,this.logger.info(`✅ Server stopped`),e()})})}async handleRequest(e,t){let n=Date.now(),r=e.url||`/`,i=e.method||`GET`,a=500;try{if(this.logger.logRequest(i,r),r===`/__reload__`&&this.hotReload){this.hotReload.handleSSEConnection(e,t),a=200;return}if(i!==`GET`){this.sendError(t,405,`Method Not Allowed`),a=405;return}let n=ce(r,this.config.rootPath);if(!_(n)){this.logger.warn(`Security violation: ${n.error.message} - ${r}`),this.sendError(t,403,`Forbidden - Access denied`),a=403;return}let o=n.data;if(!o.isValid){this.logger.warn(`Security violation: ${o.error} - ${r}`),this.sendError(t,403,`Forbidden - Access denied`),a=403;return}let s=o.resolvedPath,c=await V(s);if(!_(c)||!c.data){this.sendError(t,404,`Not Found`),a=404;return}let l=await H(s);if(!_(l)){this.sendError(t,500,`Internal Server Error`),a=500;return}l.data.isDirectory()?await this.handleDirectoryRequest(s,r,t):await this.handleFileRequest(s,t),a=200}catch(e){let n=e;n instanceof Error?this.logger.error(`Unhandled exception during request handling:`,n.message,n.stack):this.logger.error(`Unhandled exception during request handling:`,n),t.headersSent||this.sendError(t,500,`Internal Server Error`),a=500}finally{let e=Date.now()-n;this.logger.logResponse(a,e)}}async handleDirectoryRequest(e,t,r){let i=n(e,`index.html`),a=await V(i);if(_(a)&&a.data){await this.handleFileRequest(i,r);return}if(this.config&&this.config.enableDirectoryListing===!1){this.sendError(r,403,`Directory listing disabled`);return}let o=await P(e,t);if(!_(o)){this.sendError(r,500,`Error generating directory listing`);return}let s=o.data;this.hotReload&&(s=this.hotReload.injectScript(s)),r.writeHead(200,{"Content-Type":`text/html; charset=utf-8`,"Content-Length":Buffer.byteLength(s,`utf8`).toString()}),r.end(s)}async handleFileRequest(e,n){let r=await H(e);if(!_(r)){this.sendError(n,500,`Internal Server Error`);return}let i=r.data,a=t(e).toLowerCase(),o=A(e),s=ge(e),c={"Content-Type":o,"Content-Length":i.size.toString(),"Last-Modified":i.mtime.toUTCString(),"Cache-Control":`public, max-age=0`};if(s===`buffer`&&(a===`.html`||a===`.htm`)&&this.hotReload){let t=await me(e);if(_(t)){let e=this.hotReload.injectScript(t.data);c[`Content-Length`]=Buffer.byteLength(e,`utf8`).toString(),n.writeHead(200,c),n.end(e);return}else this.logger.warn(`Failed to read HTML file for script injection, falling back to streaming`)}n.writeHead(200,c);let l=he(e);l.pipe(n),l.on(`error`,e=>{this.logger.error(`File stream error:`,e),n.headersSent||this.sendError(n,500,`Internal Server Error`)}),n.on(`error`,e=>{this.logger.error(`Response error:`,e)})}sendError(e,t,n){if(e.headersSent)return;let r=this.generateErrorPage(t,n);e.writeHead(t,{"Content-Type":`text/html; charset=utf-8`,"Content-Length":Buffer.byteLength(r,`utf8`).toString()}),e.end(r)}generateErrorPage(e,t){return`
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${e} ${t} - HTTPath</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            min-height: 100vh;
+            margin: 0;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+        }
+        .error-container {
+            text-align: center;
+            padding: 60px 40px;
+            background: rgba(255, 255, 255, 0.1);
+            backdrop-filter: blur(10px);
+            border-radius: 16px;
+            border: 1px solid rgba(255, 255, 255, 0.2);
+            box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
+            max-width: 500px;
+        }
+        .error-code {
+            font-size: 6rem;
+            font-weight: 700;
+            margin-bottom: 20px;
+            text-shadow: 0 4px 8px rgba(0, 0, 0, 0.3);
+        }
+        .error-title {
+            font-size: 2rem;
+            margin-bottom: 16px;
+            font-weight: 600;
+        }
+        .error-message {
+            font-size: 1.1rem;
+            margin-bottom: 30px;
+            opacity: 0.9;
+            line-height: 1.6;
+        }
+        .error-footer {
+            font-size: 0.9rem;
+            opacity: 0.7;
+            border-top: 1px solid rgba(255, 255, 255, 0.2);
+            padding-top: 20px;
+            margin-top: 30px;
+        }
+        .back-link {
+            display: inline-block;
+            margin-top: 20px;
+            padding: 12px 24px;
+            background: rgba(255, 255, 255, 0.2);
+            border: 1px solid rgba(255, 255, 255, 0.3);
+            border-radius: 8px;
+            color: white;
+            text-decoration: none;
+            font-weight: 500;
+            transition: all 0.3s ease;
+        }
+        .back-link:hover {
+            background: rgba(255, 255, 255, 0.3);
+            transform: translateY(-2px);
+        }
+    </style>
+</head>
+<body>
+    <div class="error-container">
+        <div class="error-code">${e}</div>
+        <h1 class="error-title">${t}</h1>
+        <p class="error-message">${{403:`You do not have permission to access this resource.`,404:`The requested file or directory was not found.`,405:`The requested method is not allowed for this resource.`,500:`An internal server error occurred.`}[e]||`An error occurred.`}</p>
+        <a href="/" class="back-link">← Go Home</a>
+        <div class="error-footer">
+            HTTPath Server
+        </div>
+    </div>
+</body>
+</html>`}};const X=e=>new Ce(e),Z=J({level:`info`,format:`simple`,colorize:!0});let Q=null;const $=async()=>{we();let e=O();_(e)||(Z.error(`❌ Failed to parse CLI arguments:`,e.error.message),process.exit(1));let t=e.data;k(t)||process.exit(1);try{Q=await X(t).start(),Te()}catch(e){Z.error(`❌ Failed to start server:`,e instanceof Error?e.message:String(e)),process.exit(1)}},we=()=>{console.log(`
+🚀 ${D.name} v${D.version}
+${D.description}
+`)},Te=()=>{for(let e of[`SIGINT`,`SIGTERM`])process.on(e,async()=>{if(Z.info(`\n\n👋 Received ${e}, shutting down gracefully...`),Q)try{await Q.stop(),Z.info(`✅ Server stopped successfully`),process.exit(0)}catch(e){Z.error(`❌ Error stopping server:`,e),process.exit(1)}else process.exit(0)});process.on(`uncaughtException`,e=>{Z.error(`💥 Uncaught Exception:`,e),Q?Q.stop().finally(()=>process.exit(1)):process.exit(1)}),process.on(`unhandledRejection`,(e,t)=>{Z.error(`💥 Unhandled Promise Rejection:`,e),Z.debug(`Promise:`,t),Q?Q.stop().finally(()=>process.exit(1)):process.exit(1)})};process.argv[1]&&(process.argv[1].endsWith(`/index.mjs`)||process.argv[1].endsWith(`\\index.mjs`)||process.argv[1].includes(`dist`))&&$().catch(e=>{Z.error(`💥 Application crashed:`,e),process.exit(1)});export{D as VERSION_INFO,X as createHTTPServer,_e as createHotReloadService,J as createLogger,Y as findAvailablePort,$ as main,O as parseCliArgs,k as validateConfig};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "httpath",
+  "version": "1.0.0",
+  "description": "A lightweight, feature-rich static file server similar to Python's `python -m http.server` but with modern Node.js features and more.",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "main": "./dist/index.umd.js",
+  "bin": {
+    "httpath": "./dist/index.mjs"
+  },
+  "exports": {
+    "imports": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "type": "module",
+  "author": {
+    "name": "José Martínez Santana"
+  },
+  "repository": {
+    "type": "github",
+    "url": "https://github.com/MetalbolicX/httpath.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MetalbolicX/httpath/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "tsdown": "^0.20.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "start": "node ./dist/index.mjs",
+    "dev": "node ./dist/index.mjs --reload",
+    "serve": "node ./dist/index.mjs --port 3000 --path .",
+    "test": "node test-server.mjs"
+  }
+}