srv-it 0.3.0 → 0.4.1

package/README.md

@@ -97,3 +97,5 @@ Highlights:
 - HTML pages get an auto-injected websocket client for live reload.
 - CSS changes refresh styles without full page reload unless `--no-css-inject` is enabled.
 - If a folder has `index.html`, that file is served; otherwise a styled directory listing is shown.
+- Watch mode always ignores `.git` and `node_modules`, and also skips common home cache/config paths (`~/.cache`, `~/.local/share`).
+- If the OS watcher limit is reached (`ENOSPC`), srv-it keeps serving files and disables live reload instead of crashing.

package/license.md

@@ -0,0 +1,20 @@
+# The MIT License (MIT)
+
+Copyright (c) 2026 Elouan Grimm.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "srv-it",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Static server with polished CLI UI, directory listing, and live reload",
   "keywords": [
     "server",

package/src/cli.js

@@ -230,7 +230,8 @@ async function run() {
       boxen(content, {
         padding: 1,
         borderStyle: 'single',
-        borderColor: 'cyan',
+        borderColor: '#3b82f6',
+        margin: 1,
       }),
     );
   }

package/src/server.js

@@ -11,6 +11,32 @@ const os = require('node:os');
 const chalk = require('chalk');
 const { WebSocketServer } = require('ws');
 
+const srvLogger = {
+  http: (...message) => console.info(chalk.bgBlue.bold(' HTTP '), ...message),
+  info: (...message) => console.info(chalk.bgMagenta.bold(' INFO '), ...message),
+  warn: (...message) => console.error(chalk.bgYellow.bold(' WARN '), ...message),
+  error: (...message) => console.error(chalk.bgRed.bold(' ERROR '), ...message),
+  log: console.log,
+};
+
+const BASE_WATCH_IGNORES = ['**/.git/**', '**/node_modules/**'];
+
+const DIRECTORY_FAVICON_SVG = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="#0c0a09" d="M3 5.5A2.5 2.5 0 0 1 5.5 3H10l2 2h6.5A2.5 2.5 0 0 1 21 7.5v9A2.5 2.5 0 0 1 18.5 19h-13A2.5 2.5 0 0 1 3 16.5z"/><path fill="#3b82f6" d="M3 8h18v8.5a2.5 2.5 0 0 1-2.5 2.5h-13A2.5 2.5 0 0 1 3 16.5z"/></svg>';
+const DIRECTORY_FAVICON_DATA_URL = `data:image/svg+xml,${encodeURIComponent(DIRECTORY_FAVICON_SVG)}`;
+
+function toGlobPath(value) {
+  return value.replace(/\\/g, '/');
+}
+
+function getDefaultWatchIgnores() {
+  const home = toGlobPath(os.homedir());
+  return [
+    ...BASE_WATCH_IGNORES,
+    `${home}/.cache/**`,
+    `${home}/.local/share/**`,
+  ];
+}
+
 const LIVE_RELOAD_SNIPPET = `\n<script>\n(function(){\n  if(!('WebSocket' in window)) return;\n  function refreshCSS(){\n    var links=[].slice.call(document.querySelectorAll('link[rel="stylesheet"],link:not([rel])'));\n    links.forEach(function(link){\n      var href=link.getAttribute('href');\n      if(!href) return;\n      var u=href.replace(/([?&])_srv=\\d+/,'').replace(/[?&]$/,'');\n      var join=u.indexOf('?')>-1?'&':'?';\n      link.setAttribute('href',u+join+'_srv='+Date.now());\n    });\n  }\n  var proto=location.protocol==='https:'?'wss':'ws';\n  var socket=new WebSocket(proto+'://'+location.host+'/__srv_ws');\n  socket.onmessage=function(event){\n    if(event.data==='refreshcss') refreshCSS();\n    if(event.data==='reload') location.reload();\n  };\n})();\n</script>\n`;
 
 const STYLE_PRESETS = {
@@ -91,6 +117,7 @@ function renderDirListing({ pathnameValue, entries, style, customCss }) {
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width,initial-scale=1" />
   <title>Index of ${pathnameValue}</title>
+  <link rel="icon" href="${DIRECTORY_FAVICON_DATA_URL}" />
   <style>
     :root {
       --stone-050: #fafaf9;
@@ -370,7 +397,7 @@ async function createSrvServer(options) {
       res.statusCode = 500;
       res.end('Internal server error');
       if (options.logLevel >= 1) {
-        console.error('[srv] request error:', error.message);
+        srvLogger.error('[srv] request error:', error.message);
       }
     } finally {
       if (!options.noRequestLogging) {
@@ -381,7 +408,7 @@ async function createSrvServer(options) {
         const formattedTime = `${now.toLocaleDateString()} ${now.toLocaleTimeString()}`;
         const methodColor = method === 'GET' ? 'cyan' : 'magenta';
 
-        console.log(
+        srvLogger.http(
           chalk.dim(formattedTime),
           chalk.yellow(sourceIp),
           chalk[methodColor](`${method} ${pathnameValue}`),
@@ -405,7 +432,7 @@ async function createSrvServer(options) {
         res.statusCode = 500;
         res.end('Internal server error');
         if (options.logLevel >= 1) {
-          console.error('[srv] handler error:', error.message);
+          srvLogger.error('[srv] handler error:', error.message);
         }
       });
     });
@@ -415,7 +442,7 @@ async function createSrvServer(options) {
         res.statusCode = 500;
         res.end('Internal server error');
         if (options.logLevel >= 1) {
-          console.error('[srv] handler error:', error.message);
+          srvLogger.error('[srv] handler error:', error.message);
         }
       });
     });
@@ -428,12 +455,29 @@ async function createSrvServer(options) {
   });
 
   const watchPaths = [root, ...(options.watch || []).map((x) => path.resolve(x))];
+  const ignore = [...getDefaultWatchIgnores(), ...((options.ignore || []).filter(Boolean))];
   const watcher = chokidar.watch(watchPaths, {
     ignoreInitial: true,
-    ignored: options.ignore && options.ignore.length > 0 ? options.ignore : undefined,
+    ignored: Array.from(new Set(ignore)),
+    ignorePermissionErrors: true,
   });
 
+  let liveReloadEnabled = true;
+  let watcherClosed = false;
+
+  const closeWatcher = async () => {
+    if (watcherClosed) {
+      return;
+    }
+    watcherClosed = true;
+    await watcher.close();
+  };
+
   const sendReload = (changePath) => {
+    if (!liveReloadEnabled) {
+      return;
+    }
+
     const isCss = path.extname(changePath).toLowerCase() === '.css' && !options.noCssInject;
     const message = isCss ? 'refreshcss' : 'reload';
     for (const client of clients) {
@@ -442,7 +486,7 @@ async function createSrvServer(options) {
       }
     }
     if (options.logLevel >= 2) {
-      console.log(`[srv] ${isCss ? 'css refresh' : 'reload'}: ${changePath}`);
+      srvLogger.info(`[srv] ${isCss ? 'css refresh' : 'reload'}: ${changePath}`);
     }
   };
 
@@ -451,15 +495,28 @@ async function createSrvServer(options) {
   watcher.on('unlink', sendReload);
   watcher.on('addDir', sendReload);
   watcher.on('unlinkDir', sendReload);
+  watcher.on('error', async (error) => {
+    if (error && error.code === 'ENOSPC') {
+      liveReloadEnabled = false;
+      await closeWatcher();
+      srvLogger.error('[srv] live reload disabled: file watcher limit reached (ENOSPC).');
+      srvLogger.warn('[srv] use --ignore to exclude noisy paths, or raise inotify limits on Linux.');
+      return;
+    }
+
+    if (options.logLevel >= 1) {
+      srvLogger.error(`[srv] watcher error: ${error.message}`);
+    }
+  });
 
   const closeAll = async () => {
-    await watcher.close();
+    await closeWatcher();
     wss.close();
     await new Promise((resolve) => server.close(resolve));
   };
 
   process.on('SIGINT', async () => {
-    console.log('\n[srv] shutting down...');
+    srvLogger.info('\n[srv] shutting down...');
     await closeAll();
     process.exit(0);
   });