@caboodle-tech/node-simple-server 4.2.3 → 4.2.7

package/README.md

@@ -16,36 +16,42 @@ A small but effective node based server for development sites, customizable live
 
 ## Installation
 
-### Manually:
-
-Node Simple Server (NSS) can be manually incorporated into your development process/ application. Extract the `nss` folder from the [latest release](https://github.com/caboodle-tech/node-simple-server/releases/) and then `import` the server module into your code, similar to:
-
-```javascript
-import NodeSimpleServer from './nss.js';
-```
-
 ### Locally:
 
-You can install and use NSS locally in a project with:
+Like any other Node based application you can install NSS automatically with `pnpm` or `npm` and then reference it in your code. This is the recommended way to install and use NSS.
 
 ```bash
-# As a normal dependency:
+# Install using pnpm:
+pnpm add @caboodle-tech/node-simple-server
+
+# Or install using npm:
 npm install @caboodle-tech/node-simple-server
+```
+
+Then use in your code with:
 
-# or as a development dependency:
-npm install @caboodle-tech/node-simple-server --save-dev
+```javascript
+import NodeSimpleServer from '@caboodle-tech/node-simple-server';
 ```
 
-Depending on how you use and incorporate NSS into your project will determine the best dependency strategy to use.
+### Manually:
+
+Node Simple Server (NSS) can be manually incorporated into your development process/ application. Extract the `nss` folder from the [latest release](https://github.com/caboodle-tech/node-simple-server/releases/) and then `import` the server module into your code, similar to:
+
+```javascript
+import NodeSimpleServer from './nss.js';
+```
 
 ### Globally:
 
 You can install and use NSS globally with:
 
 ```bash
-npm install --global @caboodle-tech/node-simple-server
+pnpm install -g @caboodle-tech/node-simple-server
 ```
 
+Depending on how you use and incorporate NSS into your project will determine the best dependency strategy to use.
+
 ## Usage
 
 NSS is designed to be controlled and/or wrapped by another application. The bare minimum code needed to use NSS in your application is:
@@ -78,7 +84,8 @@ const serverOptions = {
 const Server = new NodeSimpleServer(serverOptions);
 
 // A bare minimum callback to handle most development changes.
-function watcherCallback(event, path, extension) {
+function watcherCallback(event, path, statsOrDetails) {
+    const extension = statsOrDetails.ext;
     if (extension === 'css') {
         Server.reloadAllStyles();
         return;
@@ -283,7 +290,7 @@ With your new instance of NSS you can call any of the following public methods:
 
 -   Send a message (`msg`) via WebSocket to the page that matches the `pageId`, or send to a page or pages that match the `pattern`.
 
-### **printListeningAddresses(port, \[returnInstead = false\])**
+### **printListeningAddresses(\[returnInstead = false\])**
 
 -   Prints a message to console with all the addresses the server is available at. If you want full control of the printing you can set `returnInstead` to `true`.
 

package/bin/nss.js

@@ -10,9 +10,8 @@ import ContentTypes from '../handlers/js/content-types.js';
 import HTTPStatus from '../handlers/js/http-status.js';
 import Print from './print.js';
 
-// eslint-disable-next-line no-underscore-dangle
 const __filename = fileURLToPath(import.meta.url);
-// eslint-disable-next-line no-underscore-dangle
+
 const __dirname = Path.dirname(__filename);
 const APP_ROOT = Path.join(__dirname, '../');
 
@@ -44,7 +43,7 @@ class NodeSimpleServer {
         map: {}
     };
 
-    #VERSION = '4.2.3';
+    #VERSION = '4.2.7';
 
     #watching = [];
 
@@ -125,16 +124,23 @@ class NodeSimpleServer {
      * Get an array of all the IP addresses you can reach this server at either from
      * the machine itself or on the LAN.
      *
+     * @param {number} [port] The port number to use in the addresses. If not provided,
+     *                        will use the port currently in use by the server, or the
+     *                        configured port if the server hasn't started yet.
      * @return {Array} An array of loop back ip addresses and LAN addresses to this server.
      */
     getAddresses(port) {
+        // Use provided port, or fall back to portInUse (actual port server is using),
+        // or finally to the configured port
+        // Check for undefined/null specifically to allow 0 if explicitly provided (though unlikely)
+        const actualPort = port !== undefined && port !== null ? port : this.#OPS.portInUse || this.#OPS.port;
         const locals = this.#getLocalAddresses();
         const addresses = [
-            `http://localhost:${port}`,
-            `http://127.0.0.1:${port}`
+            `http://localhost:${actualPort}`,
+            `http://127.0.0.1:${actualPort}`
         ];
         Object.keys(locals).forEach((key) => {
-            addresses.push(`http://${locals[key]}:${port}`);
+            addresses.push(`http://${locals[key]}:${actualPort}`);
         });
         return addresses;
     }
@@ -156,8 +162,8 @@ class NodeSimpleServer {
                 files.push(item);
             }
         });
-        files.sort((a, b) => a.localeCompare(b));
-        dirs.sort((a, b) => a.localeCompare(b));
+        files.sort((a, b) => { return a.localeCompare(b); });
+        dirs.sort((a, b) => { return a.localeCompare(b); });
         // Build the innerHTML for the directory and files unordered list.
         let fileHtml = '';
         let dirHtml = '';
@@ -222,18 +228,11 @@ class NodeSimpleServer {
         let hour = timestamp.getUTCHours();
         let minute = timestamp.getUTCMinutes();
         let second = timestamp.getUTCSeconds();
-        if (dayNum.length < 10) {
-            dayNum = `0${dayNum}`;
-        }
-        if (hour.length < 10) {
-            hour = `0${hour}`;
-        }
-        if (minute.length < 10) {
-            minute = `0${minute}`;
-        }
-        if (second.length < 10) {
-            second = `0${second}`;
-        }
+        // Convert to string and pad with leading zero if needed
+        dayNum = String(dayNum).padStart(2, '0');
+        hour = String(hour).padStart(2, '0');
+        minute = String(minute).padStart(2, '0');
+        second = String(second).padStart(2, '0');
         return `${dayStr}, ${dayNum} ${monStr} ${timestamp.getUTCFullYear()} ${hour}:${minute}:${second} GMT`;
     }
 
@@ -288,7 +287,7 @@ class NodeSimpleServer {
         // Standard headers that should always be set for NSS.
         let mtime = new Date().toUTCString();
         if (settings?.file) {
-            mtime = Fs.statSync(settings.file).mtime;
+            ({ mtime } = Fs.statSync(settings.file));
         }
         const nssHeaders = {
             'Cache-Control': 'public, max-age=0',
@@ -324,7 +323,7 @@ class NodeSimpleServer {
      * like directory listing, page not found, access denied, and so on.
      */
     #loadHandlers() {
-        // eslint-disable-next-line max-len, no-template-curly-in-string
+        // eslint-disable-next-line max-len
         const internalError = '<!DOCTYPE html><html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>500 Internal Server Error</title><style>body,html{margin:0;padding:0}body{padding:15px}</style></head><body><h1>500 Internal Server Error</h1><p>Could not locate source file.</p><hr><p><i>Node Simple Server (NSS) {{version}} Server <script type="text/javascript">document.write(`${document.location.protocol}//${document.location.hostname}`);</script> Port <script type="text/javascript">document.write(document.location.port)</script></i></p>{{liveReloading}}</body></html>';
 
         const dirListingSrc = Path.join(APP_ROOT, 'handlers', 'dir-listing.html');
@@ -377,18 +376,32 @@ class NodeSimpleServer {
      * Print the addresses the server is listening on to the console; this is useful for users who
      * are not sure what address to use to access the server.
      *
-     * @param {int} port The port number being listened on.
+     * @param {number|boolean} [portOrReturn] If a number, the port to use in the addresses.
+     *                                         If a boolean, whether to return the message instead of printing.
      * @param {boolean} [returnInstead=false] If true the function will return the message string instead.
      */
-    // eslint-disable-next-line consistent-return
-    printListeningAddresses(port, returnInstead = false) {
+
+    printListeningAddresses(portOrReturn, returnInstead = false) {
+        // Handle backward compatibility: if first arg is boolean, it's returnInstead
+        let port;
+        let shouldReturn = returnInstead;
+        if (typeof portOrReturn === 'boolean') {
+            shouldReturn = portOrReturn;
+            port = undefined;
+        } else if (typeof portOrReturn === 'number') {
+            port = portOrReturn;
+        } else {
+            port = undefined;
+        }
+
         let message = 'Node Simple Server live @:\n';
         const addresses = this.getAddresses(port);
         addresses.forEach((address) => {
-            message += `    ${address}`;
+            message += `    ${address}\n`;
         });
+        message += '\n';
 
-        if (returnInstead) {
+        if (shouldReturn) {
             return message;
         }
         Print.notice(message);
@@ -408,7 +421,7 @@ class NodeSimpleServer {
             }
             if (pattern[0] === '/' && pattern[pattern.length - 1] === '/') {
                 // eslint-disable-next-line no-param-reassign
-                pattern = pattern.substr(1, pattern.length - 2);
+                pattern = pattern.slice(1, -1);
             }
             return new RegExp(`^${pattern}$`);
         } catch (e) {
@@ -753,7 +766,8 @@ class NodeSimpleServer {
      */
     #socketListener(socket, request) {
         // Strip the page ID and /ws tag off the url to get the actual url.
-        let cleanURL = request.url.substr(1, request.url.indexOf('/ws?id=') - 1);
+        const wsIndex = request.url.indexOf('/ws?id=');
+        let cleanURL = wsIndex > 0 ? request.url.slice(1, wsIndex) : '';
         if (!cleanURL) {
             cleanURL = this.#OPS.indexPage;
         }
@@ -779,17 +793,16 @@ class NodeSimpleServer {
 
         let pageId;
         if (idStartIndex !== -1) {
-            pageId = request.url.substr(idStartIndex).replace('?id=', '');
+            pageId = request.url.slice(idStartIndex).replace('?id=', '');
         } else {
             pageId = 'unknown';
         }
 
-        // eslint-disable-next-line no-param-reassign
         socket.nssUid = pageId;
 
         // Overwrite the default send method to NSS's standard.
         const originalSend = socket.send.bind(socket);
-        // eslint-disable-next-line no-param-reassign
+
         socket.send = (message) => {
             originalSend(JSON.stringify({
                 message,
@@ -835,7 +848,7 @@ class NodeSimpleServer {
             // Pull out specific route if there is one.
             let route = null;
             if ('route' in msgObj) {
-                route = msgObj.route;
+                ({ route } = msgObj);
             }
 
             // See if the message belongs to a callback and send it there.
@@ -927,7 +940,7 @@ class NodeSimpleServer {
              * requests so they get passed on to the this.#socket.connection listener.
              */
             if (request.headers.upgrade === 'websocket') {
-                // eslint-disable-next-line no-useless-return
+
                 return;
             }
         });
@@ -997,12 +1010,14 @@ class NodeSimpleServer {
             // If any back-end files are being watched for changes stop monitoring them.
             this.watchEnd();
             // Close all socket connections; these would force the server to stay up.
-            const keys = Object.keys(this.#sockets);
+            const keys = Object.keys(this.#sockets.routes);
             keys.forEach((key) => {
-                this.#sockets.routes[key].forEach((socket) => {
-                    socket.send('close');
-                    socket.close();
-                });
+                if (this.#sockets.routes[key]) {
+                    this.#sockets.routes[key].forEach((socket) => {
+                        socket.send('close');
+                        socket.close();
+                    });
+                }
             });
             // Now gracefully close SERVER and SOCKET.
             this.#server.close();
@@ -1064,7 +1079,7 @@ class NodeSimpleServer {
          * directory to NSS's root if the setting is missing.
          */
         if (!options.cwd) {
-            // eslint-disable-next-line no-param-reassign
+
             options.cwd = this.#OPS.root;
         }
         // Convert paths to array if it's not already.
@@ -1078,7 +1093,7 @@ class NodeSimpleServer {
             this.#watching.push(watcher);
             // Prepare to modify some of the standard Chokidar listeners.
             const alterAddUpdates = ['add', 'addDir', 'change'];
-            const alterCatachAlls = ['all', 'raw'];
+            const alterCatchAlls = ['all', 'raw'];
             const alterUnlinks = ['unlink', 'unlinkDir'];
             // Hookup requested listeners; they are case sensitive so type them right in your code!
             Object.keys(options.events).forEach((key) => {
@@ -1088,12 +1103,12 @@ class NodeSimpleServer {
                  * Chokidar provides paths in the correct OS format but NSS will change
                  * all backslashes (\) into forward slashes (/).
                  */
-                if (alterCatachAlls.includes(key)) {
+                if (alterCatchAlls.includes(key)) {
                     watcher.on(key, (evt, path, statsOrDetails = {}) => {
                         // Capture the call and alter the path before passing it on.
                         const altPath = path.replace(/\\/g, '/');
                         // Since we're messing with the path already grab the extension for the user.
-                        // eslint-disable-next-line no-param-reassign
+
                         statsOrDetails.ext = Path.extname(altPath).replace('.', '');
                         options.events[key](evt, altPath, statsOrDetails);
                     });
@@ -1102,7 +1117,7 @@ class NodeSimpleServer {
                         // Capture the call and alter the path before passing it on.
                         const altPath = path.replace(/\\/g, '/');
                         // Since we're messing with the path already grab the extension for the user.
-                        // eslint-disable-next-line no-param-reassign
+
                         statsOrDetails.ext = Path.extname(altPath).replace('.', '');
                         options.events[key](altPath, statsOrDetails);
                     });
@@ -1145,7 +1160,7 @@ class NodeSimpleServer {
      */
     whatIs(unknown) {
         try {
-            return ({}).toString.call(unknown).match(/\s([^\]]+)/)[1].toLowerCase();
+            return {}.toString.call(unknown).match(/\s([^\]]+)/)[1].toLowerCase();
         } catch (e) { return undefined; }
     }
 

package/bin/print.js

@@ -1,5 +1,3 @@
-/* eslint-disable no-console */
-
 class Print {
 
     #enabled = true;

package/changelogs/v4.md

@@ -1,3 +1,31 @@
+### NSS 4.2.7 (5 January 2026)
+
+- build: Migrate ESLint configuration to flat config format
+- build: Add custom ESLint rules for HTML, JavaScript, and JSON
+- deps: Update chokidar from ^3.5.3 to ^5.0.0
+- deps: Update ws from ^8.13.0 to ^8.19.0
+- deps: Replace eslint-config-airbnb-base with @html-eslint/eslint-plugin and eslint-plugin-jsonc
+- deps: Update ESLint from ^8.2.0 to ^9.39.2
+- deps: Add engines field specifying Node.js >=14.0.0 requirement
+- feat: Enhance getAddresses() to handle optional port parameter with fallback logic
+- feat: Enhance printListeningAddresses() to accept port parameter while maintaining backward compatibility
+- fix: Replace deprecated substr() with slice() method
+- fix: Use object destructuring for better code quality (prefer-destructuring rule)
+- fix: Update arrow functions to use block statements (arrow-body-style rule)
+- refactor: Replace manual string padding with padStart() method
+- refactor: Remove unused eslint-disable directives
+- style: Fix HTML meta tags formatting (remove self-closing, sort attributes)
+- style: Remove unnecessary type attributes from script tags
+- style: Fix SVG attribute ordering in HTML handlers
+- docs: Update README.md with pnpm installation instructions
+- docs: Improve installation documentation structure
+- docs: Update watcher callback example to reflect Chokidar v4+ API changes
+
+### NSS 4.2.5 (23 July 2024)
+
+- chore: Document changes since 4.2.2 here in the changelog:
+    - Allow users to control address printing instead or printing it automatically.
+
 ### NSS 4.2.2 (24 January 2024)
 
 - feat: Add WebSocket to connection with backend routes.

package/eslint/html-rules.js

@@ -0,0 +1,24 @@
+/**
+ * Caboodle Tech's opinionated rules for linting HTML with ESLint. Feel free to adapt or modify
+ * these rules to suit your needs.
+ *
+ * ESLint Plugin: {@link https://www.npmjs.com/package/@html-eslint/eslint-plugin @html-eslint/eslint-plugin}
+ * HTML ESLint Parser: {@link https://html-eslint.org/docs/rules HTML ESLint Docs}
+ */
+export default {
+    '@html-eslint/indent': ['error', 4],
+    '@html-eslint/no-duplicate-attrs': 'error',
+    '@html-eslint/no-duplicate-id': 'error',
+    '@html-eslint/no-extra-spacing-attrs': 'error',
+    '@html-eslint/no-inline-styles': 'warn',
+    '@html-eslint/no-multiple-empty-lines': ['error', { max: 1 }],
+    '@html-eslint/no-obsolete-tags': 'error',
+    '@html-eslint/no-script-style-type': 'error',
+    '@html-eslint/no-trailing-spaces': 'error',
+    '@html-eslint/require-button-type': 'warn',
+    '@html-eslint/require-closing-tags': 'error',
+    '@html-eslint/require-doctype': 'error',
+    '@html-eslint/require-li-container': 'warn',
+    '@html-eslint/require-meta-viewport': 'error',
+    '@html-eslint/sort-attrs': 'warn'
+};

package/eslint/js-rules.js

@@ -0,0 +1,143 @@
+/**
+ * Caboodle Tech's opinionated rules for linting JavaScript with ESLint. Feel free to adapt or
+ * modify these rules to suit your needs.
+ *
+ * ESLint Rules: {@link https://eslint.org/docs/latest/rules/ ESLint Docs}
+ */
+export default {
+    'class-methods-use-this': 'off',
+    'comma-dangle': ['error', 'never'],
+    'default-case': 'off',
+    indent: [
+        'error',
+        4,
+        {
+            SwitchCase: 1
+        }
+    ],
+    'max-len': ['warn', 120],
+    'no-continue': 'warn',
+    'no-param-reassign': 'warn',
+    'no-plusplus': [
+        'error',
+        {
+            allowForLoopAfterthoughts: true
+        }
+    ],
+    'no-restricted-syntax': 'off',
+    'no-use-before-define': 'off',
+    'no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    'object-curly-spacing': ['error', 'always'],
+    'padded-blocks': [
+        'error',
+        {
+            classes: 'always'
+        }
+    ],
+    'arrow-body-style': ['error', 'always'],
+    'arrow-parens': ['error', 'always'],
+    'arrow-spacing': ['error', { before: true, after: true }],
+    'block-spacing': ['error', 'always'],
+    'brace-style': ['error', '1tbs', { allowSingleLine: true }],
+    'comma-spacing': ['error', { before: false, after: true }],
+    'computed-property-spacing': ['error', 'never'],
+    'dot-location': ['error', 'property'],
+    'dot-notation': ['error', { allowKeywords: true }],
+    'eol-last': ['error', 'always'],
+    eqeqeq: ['error', 'always', { null: 'ignore' }],
+    'func-call-spacing': ['error', 'never'],
+    'func-name-matching': 'error',
+    'func-names': ['error', 'always'],
+    'func-style': [
+        'error',
+        'declaration',
+        { allowArrowFunctions: true }
+    ],
+    'generator-star-spacing': ['error', { before: true, after: true }],
+    'key-spacing': ['error', { beforeColon: false, afterColon: true }],
+    'keyword-spacing': ['error', { before: true, after: true }],
+    'lines-between-class-members': [
+        'error',
+        'always',
+        { exceptAfterSingleLine: true }
+    ],
+    'newline-per-chained-call': ['error', { ignoreChainWithDepth: 4 }],
+    'no-confusing-arrow': ['error', { allowParens: true }],
+    'no-dupe-class-members': 'error',
+    'no-duplicate-imports': 'error',
+    'no-else-return': ['error', { allowElseIf: false }],
+    'no-eval': 'error',
+    'no-extra-parens': [
+        'error',
+        'all',
+        { nestedBinaryExpressions: false }
+    ],
+    'no-floating-decimal': 'error',
+    'no-lonely-if': 'error',
+    'no-mixed-operators': 'error',
+    'no-multi-assign': 'error',
+    'no-multiple-empty-lines': [
+        'error',
+        { max: 1, maxEOF: 0, maxBOF: 0 }
+    ],
+    'no-return-await': 'error',
+    'no-self-compare': 'error',
+    'no-trailing-spaces': 'error',
+    'no-unneeded-ternary': 'error',
+    'no-useless-concat': 'error',
+    'no-var': 'error',
+    'object-curly-newline': ['error', { consistent: true }],
+    'object-curly-spacing': ['error', 'always'],
+    'object-shorthand': [
+        'error',
+        'always',
+        { ignoreConstructors: false, avoidQuotes: true }
+    ],
+    'one-var': ['error', 'never'],
+    'one-var-declaration-per-line': ['error', 'always'],
+    'operator-assignment': ['error', 'always'],
+    'operator-linebreak': ['error', 'after'],
+    'prefer-arrow-callback': 'error',
+    'prefer-const': 'error',
+    'prefer-destructuring': [
+        'error',
+        {
+            VariableDeclarator: { array: false, object: true },
+            AssignmentExpression: { array: true, object: true }
+        }
+    ],
+    'prefer-numeric-literals': 'error',
+    'prefer-template': 'error',
+    'quote-props': ['error', 'as-needed'],
+    quotes: [
+        'error',
+        'single',
+        { avoidEscape: true, allowTemplateLiterals: true }
+    ],
+    'require-await': 'off',
+    'rest-spread-spacing': ['error', 'never'],
+    semi: ['error', 'always'],
+    'semi-spacing': ['error', { before: false, after: true }],
+    'semi-style': ['error', 'last'],
+    'space-before-blocks': 'error',
+    'space-before-function-paren': ['error', 'never'],
+    'space-in-parens': ['error', 'never'],
+    'space-infix-ops': 'error',
+    'space-unary-ops': ['error', { words: true, nonwords: false }],
+    'spaced-comment': [
+        'error',
+        'always',
+        {
+            line: { markers: ['/'] },
+            block: {
+                balanced: true,
+                markers: ['*'],
+                exceptions: ['*']
+            }
+        }
+    ],
+    'template-curly-spacing': ['error', 'never'],
+    'template-tag-spacing': ['error', 'never'],
+    yoda: ['error', 'never', { exceptRange: true }]
+};
+

package/eslint/json-rules.js

@@ -0,0 +1,21 @@
+/**
+ * Caboodle Tech's opinionated rules for linting JSON with ESLint. Feel free to adapt or modify
+ * these rules to suit your needs.
+ *
+ * ESLint Plugin: {@link https://www.npmjs.com/package/eslint-plugin-jsonc eslint-plugin-jsonc}
+ * JSON ESLint Parser: {@link https://www.npmjs.com/package/jsonc-eslint-parser jsonc-eslint-parser}
+ * JSON ESLint Rules: {@link https://ota-meshi.github.io/eslint-plugin-jsonc/rules/ JSON ESLint Docs}
+ */
+export default {
+    'jsonc/array-bracket-spacing': ['error', 'never'],
+    'jsonc/comma-dangle': ['error', 'never'],
+    'jsonc/comma-style': ['error', 'last'],
+    'jsonc/indent': ['error', 4],
+    'jsonc/key-spacing': ['error', { beforeColon: false, afterColon: true }],
+    'jsonc/object-curly-newline': ['error', { consistent: true }],
+    'jsonc/object-curly-spacing': ['error', 'always'],
+    'jsonc/object-property-newline': ['error', { allowMultiplePropertiesPerLine: true }],
+    'jsonc/quote-props': ['error', 'always'],
+    'jsonc/quotes': ['error', 'double']
+};
+

package/eslint.config.js

@@ -0,0 +1,44 @@
+import HtmlParser from '@html-eslint/parser';
+import HtmlPlugin from '@html-eslint/eslint-plugin';
+import HtmlRules from './eslint/html-rules.js';
+import JsRules from './eslint/js-rules.js';
+import JsonRules from './eslint/json-rules.js';
+import JsoncParser from 'jsonc-eslint-parser';
+import JsoncPlugin from 'eslint-plugin-jsonc';
+
+export default [
+    {
+        // Caboodle Tech HTML settings.
+        ...HtmlPlugin.configs['flat/recommended'],
+        files: ['**/*.html'],
+        plugins: {
+            '@html-eslint': HtmlPlugin
+        },
+        rules: { ...HtmlRules },
+        languageOptions: {
+            parser: HtmlParser
+        }
+    },
+    {
+        // Caboodle Tech JavaScript settings.
+        files: ['**/*.js'],
+        languageOptions: {
+            ecmaVersion: 'latest',
+            sourceType: 'module'
+        },
+        rules: { ...JsRules }
+    },
+    {
+        // Caboodle Tech JSON settings.
+        files: ['**/*.json'],
+        languageOptions: {
+            parser: JsoncParser,
+            ecmaVersion: 'latest'
+        },
+        plugins: {
+            jsonc: JsoncPlugin
+        },
+        rules: { ...JsonRules }
+    }
+];
+

package/examples/controllers/prod-website.js

@@ -57,6 +57,9 @@ const WebsiteDemo = () => {
      * setting up `watch`.
      */
     server.watch(websiteRoot, watcherOptions);
+
+    // Log the server's address so we can access it.
+    server.printListeningAddresses();
 };
 
 export default WebsiteDemo;

package/examples/controllers/website.js

@@ -55,6 +55,9 @@ const WebsiteDemo = () => {
      * setting up `watch`.
      */
     server.watch(websiteRoot, watcherOptions);
+
+    // Log the server's address so we can access it.
+    server.printListeningAddresses();
 };
 
 export default WebsiteDemo;

package/examples/controllers/websocket.js

@@ -77,6 +77,9 @@ const WebsocketDemo = () => {
     // Register our websocket handler to respond to only index pages.
     server.addWebsocketCallback('index.html', websocketHandler);
 
+    // Log the server's address so we can access it.
+    server.printListeningAddresses();
+
     // NOTE: We could add as many callbacks as we like for different pages or patterns.
 };
 

package/handlers/dir-listing.html

@@ -2,8 +2,8 @@
 <html>
     <head>
         <!-- This is NSS's directory listing page. -->
-        <meta charset="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <meta charset="UTF-8">
+        <meta content="width=device-width, initial-scale=1.0" name="viewport">
         <title>Directory Listing</title>
         <style>
             html,
@@ -90,7 +90,7 @@
             <div class="col">
                 <h1>
                     Listing
-                    <script type="text/javascript">
+                    <script>
                         document.write(document.location.pathname);
                     </script>
                 </h1>
@@ -98,8 +98,8 @@
         </div>
         <div class="row content">
             <div class="col">
-                <svg class="icon" width="24" height="24" xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd">
-                    <path d="M22 24h-20v-24h14l6 6v18zm-7-23h-12v22h18v-16h-6v-6zm3 15v1h-12v-1h12zm0-3v1h-12v-1h12zm0-3v1h-12v-1h12zm-2-4h4.586l-4.586-4.586v4.586z" />
+                <svg class="icon" clip-rule="evenodd" fill-rule="evenodd" height="24" width="24" xmlns="http://www.w3.org/2000/svg">
+                    <path d="M22 24h-20v-24h14l6 6v18zm-7-23h-12v22h18v-16h-6v-6zm3 15v1h-12v-1h12zm0-3v1h-12v-1h12zm0-3v1h-12v-1h12zm-2-4h4.586l-4.586-4.586v4.586z"/>
                 </svg>
                 <span class="title">Files</span>
                 <ul>
@@ -107,8 +107,8 @@
                 </ul>
             </div>
             <div class="col">
-                <svg class="icon" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
-                    <path d="M6.083 4c1.38 1.612 2.578 3 4.917 3h11v13h-20v-16h4.083zm.917-2h-7v20h24v-17h-13c-1.629 0-2.305-1.058-4-3z" />
+                <svg class="icon" height="24" viewBox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg">
+                    <path d="M6.083 4c1.38 1.612 2.578 3 4.917 3h11v13h-20v-16h4.083zm.917-2h-7v20h24v-17h-13c-1.629 0-2.305-1.058-4-3z"/>
                 </svg>
                 <span class="title">Directories</span>
                 <ul>
@@ -121,11 +121,11 @@
                 <p>
                     <i>
                         Node Simple Server (NSS) {{version}} Server
-                        <script type="text/javascript">
+                        <script>
                             document.write(`${document.location.protocol}//${document.location.hostname}`);
                         </script>
                         Port
-                        <script type="text/javascript">
+                        <script>
                             document.write(document.location.port);
                         </script>
                     </i>

package/handlers/forbidden.html

@@ -2,8 +2,8 @@
 <html>
     <head>
         <!-- This is NSS's forbidden page. -->
-        <meta charset="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <meta charset="UTF-8">
+        <meta content="width=device-width, initial-scale=1.0" name="viewport">
         <title>403 Forbidden</title>
         <style>
             html,
@@ -20,7 +20,7 @@
         <h1>403 Forbidden</h1>
         <p>
             You don't have permission to access
-            <script type="text/javascript">
+            <script>
                 document.write(document.location.pathname);
             </script>
             on this server.
@@ -29,11 +29,11 @@
         <p>
             <i>
                 Node Simple Server (NSS) {{version}} Server
-                <script type="text/javascript">
+                <script>
                     document.write(`${document.location.protocol}//${document.location.hostname}`);
                 </script>
                 port
-                <script type="text/javascript">
+                <script>
                     document.write(document.location.port);
                 </script>
             </i>

package/handlers/live-reloading.html

@@ -2,7 +2,7 @@
 <style>
     #NSS_WS{display:flex;justify-content:center;align-items:center;position:fixed;right:15px;bottom:15px;z-index:9000;width:80px;height:45px;border-radius:25px;background:#000}#NSS_WS svg{margin-left:5px;fill:#ffffff}#NSS_WS span{display:inline-block;margin-right:5px;font-family:monospace;font-size:22px;color:#fff}
 </style>
-<script type='text/javascript'>
+<script>
     // <![CDATA[
     if ('WebSocket' in window) {
         NSS_WS = (() => {

package/handlers/not-found.html

@@ -2,8 +2,8 @@
 <html>
     <head>
         <!-- This is NSS's 404 page. -->
-        <meta charset="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <meta charset="UTF-8">
+        <meta content="width=device-width, initial-scale=1.0" name="viewport">
         <title>404 Not Found</title>
         <style>
             html,
@@ -20,7 +20,7 @@
         <h1>404 Not Found</h1>
         <p>
             The requested URL
-            <script type="text/javascript">
+            <script>
                 document.write(document.location.pathname);
             </script>
             was not found on this server.
@@ -29,11 +29,11 @@
         <p>
             <i>
                 Node Simple Server (NSS) {{version}} Server
-                <script type="text/javascript">
+                <script>
                     document.write(`${document.location.protocol}//${document.location.hostname}`);
                 </script>
                 Port
-                <script type="text/javascript">
+                <script>
                     document.write(document.location.port);
                 </script>
             </i>

package/handlers/websocket-only.html

@@ -1,5 +1,5 @@
 <!-- Code injected by Node Simple Server. -->
-<script type="text/javascript">
+<script>
     // <![CDATA[
     if ("WebSocket" in window) {
         NSS_WS = (() => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@caboodle-tech/node-simple-server",
-    "version": "4.2.3",
+    "version": "4.2.7",
     "description": "Node Simple Server (NSS): A small but effective node based server for development sites, customizable live reloading, and websocket support built-in.",
     "main": "bin/nss.js",
     "scripts": {
@@ -36,13 +36,18 @@
         "url": "https://github.com/caboodle-tech/node-simple-server/issues"
     },
     "homepage": "https://github.com/caboodle-tech/node-simple-server#readme",
+    "engines": {
+        "node": ">=14.0.0"
+    },
     "dependencies": {
-        "chokidar": "^3.5.3",
-        "ws": "^8.13.0"
+        "chokidar": "^5.0.0",
+        "ws": "^8.19.0"
     },
     "devDependencies": {
-        "eslint": "^8.2.0",
-        "eslint-config-airbnb-base": "^15.0.0",
-        "eslint-plugin-import": "^2.25.2"
+        "@html-eslint/eslint-plugin": "^0.32.0",
+        "@html-eslint/parser": "^0.32.0",
+        "eslint": "^9.39.2",
+        "eslint-plugin-jsonc": "^2.21.0",
+        "jsonc-eslint-parser": "^2.4.2"
     }
 }

package/.eslintrc.json

@@ -1,50 +0,0 @@
-{
-    "env": {
-        "browser": true,
-        "commonjs": true,
-        "es2021": true
-    },
-    "extends": [
-        "airbnb-base"
-    ],
-    "overrides": [],
-    "parserOptions": {
-        "ecmaVersion": "latest"
-    },
-    "rules": {
-        "class-methods-use-this": "off",
-        "comma-dangle": [
-            "error",
-            "never"
-        ],
-        "default-case": "off",
-        "import/extensions": ["error", "always", {"ignorePackages": true} ],
-        "import/no-extraneous-dependencies": [
-            "error",
-            {
-                "devDependencies": true
-            }
-        ],
-        "indent": [
-            "error",
-            4,
-            {
-                "SwitchCase": 1
-            }
-        ],
-        "max-len": ["warn", { "code": 120 }],
-        "no-plusplus": [
-            "error",
-            {
-                "allowForLoopAfterthoughts": true
-            }
-        ],
-        "no-use-before-define": "off",
-        "padded-blocks": [
-            "error",
-            {
-                "classes": "always"
-            }
-        ]
-    }
-}