Working

.editorconfig

@@ -0,0 +1,15 @@
+; EditorConfig file: https://EditorConfig.org
+; Install the "EditorConfig" plugin into your editor to use
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.json]
+indent_size = 2

.eslintrc.js

@@ -0,0 +1,15 @@
+'use strict';
+
+module.exports = {
+    env: {
+        es6: true,
+        node: true
+    },
+    extends: ['eslint:recommended'],
+    rules: {
+        indent: ['error', 4],
+        'no-var': ['error'],
+        'no-unused-vars': ['error', {args: 'none'}],
+        'prefer-const': ['error']
+    }
+};

.gitignore

@@ -1,3 +1,4 @@
 npm-debug.log
 node_modules
 
+.idea

.npmignore

@@ -0,0 +1,2 @@
+test
+benchmark

CHANGES.md

@@ -0,0 +1,46 @@
+# CHANGES for `node-static`
+
+## ? (UNRELEASED)
+
+### User-facing
+
+- **Breaking change** (npm): Set `engines` to 10.11.0+
+- Security: Fix dependency vulnerabilities by switching from `optimist` to
+    `neodoc` (@fidian)
+- Security: Update `mime` and `colors` (@fidian)
+- Security Update/fix: Use `URL` constructor over deprecated `url.parse`;
+    should fix Open Redirect issue <https://www.npmjs.com/advisories/1207>
+- Security Update/fix: Protect `fs.stat` calls from bad path arguments; fixes
+    Denial of Service issue <https://www.npmjs.com/advisories/1208>
+    (@brpvieira)
+- Security fix?: The Unauthorized File Access issue
+    <https://www.npmjs.com/advisories/1206> does not appear to be an issue
+    per testing (if it ever was); if you can provide a test case where it
+    fails, please report
+- Fix: Support `bytes=0-0` Range header (@prajwalkman)
+- Fix: Avoid octal (@bgao / @Ilrilan)
+- Fix: For `spa`, allow dots after path (@gjuchault)
+- Enhancement: Allow access with local ip (@flyingsky)
+- Enhancement: Allow `serverInfo` to be `null` (@martindale)
+- Enhancement: Time display logging with leading 0 (@mauris)
+- Enhancement: Respect static `--cache 0` (@matthew-andrews)
+- Enhancement: New option: `defaultExtension` (@fmalk)
+- Enhancement: Added glob matching for setting cache headers (@lightswitch05)
+- Optimization: 'use strict' directive
+- Docs: For examples (and internally) avoid `static` reserved word
+- Docs: Fix header example (@emmanouil)
+- Docs: Sp. (@EdwardBetts)
+- Docs: Add `CHANGES.md`
+
+### Dev-facing
+
+- Linting: Prefer const, no-var, fix indent, comment-out unused,
+    prefer `startsWith` and `includes`
+- Refactoring: Use safer non-prototype version of `colors`
+- Maintenance: Add `.editorconfig`
+- Testing: Add checks for supposed direct `node-static` vulnerabilities
+- Testing: Add test for `null` and non-`null` serverInfo
+- Testing: Allow tests to end (@fmalk)
+- Testing: Add `nyc` for coverage
+- npm: Add eslint devDep. and script
+- npm: Add lock file

LICENSE

@@ -1,4 +1,5 @@
 Copyright (c) 2010-14 Alexis Sellier
+Copyright (c) 2021 Brett Zamir
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

README.md

@@ -1,22 +1,20 @@
-node-static
-===========
+# node-static
 
 > a simple, *rfc 2616 compliant* file streaming module for [node](http://nodejs.org)
 
 node-static understands and supports *conditional GET* and *HEAD* requests.
-node-static was inspired by some of the other static-file serving modules out there,
-such as node-paperboy and antinode.
+node-static was inspired by some of the other static-file serving modules out
+there, such as node-paperboy and antinode.
 
-Synopsis
---------
+# Synopsis
 
 ```js
-var static = require('node-static');
+const statik = require('node-static');
 
 //
 // Create a node-static server instance to serve the './public' folder
 //
-var file = new static.Server('./public');
+const file = new statik.Server('./public');
 
 require('http').createServer(function (request, response) {
     request.addListener('end', function () {
@@ -31,39 +29,40 @@ require('http').createServer(function (request, response) {
 API
 ---
 
-### Creating a node-static Server #
+### Creating a node-static Server
 
 Creating a file server instance is as simple as:
 
 ```js
-new static.Server();
+new statik.Server();
 ```
 
-This will serve files in the current directory. If you want to serve files in a specific
-directory, pass it as the first argument:
+This will serve files in the current directory. If you want to serve files in
+a specific directory, pass it as the first argument:
 
 ```js
-new static.Server('./public');
+new statik.Server('./public');
 ```
 
-You can also specify how long the client is supposed to cache the files node-static serves:
+You can also specify how long the client is supposed to cache the files
+node-static serves:
 
 ```js
-new static.Server('./public', { cache: 3600 });
+new statik.Server('./public', { cache: 3600 });
 ```
 
-This will set the `Cache-Control` header, telling clients to cache the file for an hour.
-This is the default setting.
+This will set the `Cache-Control` header, telling clients to cache the file for
+an hour. This is the default setting.
 
-### Serving files under a directory #
+### Serving files under a directory
 
-To serve files under a directory, simply call the `serve` method on a `Server` instance, passing it
-the HTTP request and response object:
+To serve files under a directory, simply call the `serve` method on a `Server`
+instance, passing it the HTTP request and response object:
 
-```js 
-var static = require('node-static');
+```js
+const statik = require('node-static');
 
-var fileServer = new static.Server('./public');
+var fileServer = new statik.Server('./public');
 
 require('http').createServer(function (request, response) {
     request.addListener('end', function () {
@@ -72,23 +71,28 @@ require('http').createServer(function (request, response) {
 }).listen(8080);
 ```
 
-### Serving specific files #
+### Serving specific files
 
-If you want to serve a specific file, like an error page for example, use the `serveFile` method:
+If you want to serve a specific file, like an error page for example, use the
+`serveFile` method:
 
 ```js
 fileServer.serveFile('/error.html', 500, {}, request, response);
 ```
 
-This will serve the `error.html` file, from under the file root directory, with a `500` status code.
-For example, you could serve an error page, when the initial request wasn't found:
+This will serve the `error.html` file, from under the file root directory, with
+a `500` status code.
+For example, you could serve an error page, when the initial request wasn't
+found:
 
 ```js
 require('http').createServer(function (request, response) {
     request.addListener('end', function () {
         fileServer.serve(request, response, function (e, res) {
             if (e && (e.status === 404)) { // If the file wasn't found
-                fileServer.serveFile('/not-found.html', 404, {}, request, response);
+                fileServer.serveFile(
+                    '/not-found.html', 404, {}, request, response
+                );
             }
         });
     }).resume();
@@ -97,21 +101,24 @@ require('http').createServer(function (request, response) {
 
 More on intercepting errors bellow.
 
-### Intercepting errors & Listening #
+### Intercepting errors & Listening
 
-An optional callback can be passed as last argument, it will be called every time a file
-has been served successfully, or if there was an error serving the file:
+An optional callback can be passed as last argument, it will be called every
+time a file has been served successfully, or if there was an error serving the
+file:
 
 ```js
-var static = require('node-static');
-    
-var fileServer = new static.Server('./public');
+const statik = require('node-static');
+
+const fileServer = new statik.Server('./public');
 
 require('http').createServer(function (request, response) {
     request.addListener('end', function () {
         fileServer.serve(request, response, function (err, result) {
             if (err) { // There was an error serving the file
-                console.error("Error serving " + request.url + " - " + err.message);
+                console.error(
+                    "Error serving " + request.url + " - " + err.message
+                );
 
                 // Respond to the client
                 response.writeHead(err.status, err.headers);
@@ -122,12 +129,12 @@ require('http').createServer(function (request, response) {
 }).listen(8080);
 ```
 
-Note that if you pass a callback, and there is an error serving the file, node-static
-*will not* respond to the client. This gives you the opportunity to re-route the request,
-or handle it differently.
+Note that if you pass a callback, and there is an error serving the file,
+node-static *will not* respond to the client. This gives you the opportunity
+to re-route the request, or handle it differently.
 
-For example, you may want to interpret a request as a static request, but if the file isn't found,
-send it to an application.
+For example, you may want to interpret a request as a static request, but if
+the file isn't found, send it to an application.
 
 If you only want to *listen* for errors, you can use *event listeners*:
 
@@ -137,76 +144,91 @@ fileServer.serve(request, response).addListener('error', function (err) {
 });
 ```
 
-With this method, you don't have to explicitly send the response back, in case of an error.
+With this method, you don't have to explicitly send the response back, in case
+of an error.
 
-### Options when creating an instance of `Server` #
+### Options when creating an instance of `Server`
 
-#### `cache` #
+#### `cache`
 
 Sets the `Cache-Control` header.
 
-example: `{ cache: 7200 }`
+example: `{ cache: 7200 }` will set the max-age for all files to 7200 seconds
+example: `{ cache: {'**/*.css': 300}}` will set the max-age for all CSS files to 5 minutes.
 
 Passing a number will set the cache duration to that number of seconds.
 Passing `false` will disable the `Cache-Control` header.
+Passing a object with [minimatch glob pattern](https://github.com/isaacs/minimatch)
+keys and number values will set cache max-age for any matching paths.
 
 > Defaults to `3600`
 
 
-#### `serverInfo` #
+#### `serverInfo`
 
 Sets the `Server` header.
 
 example: `{ serverInfo: "myserver" }`
 
 > Defaults to `node-static/{version}`
 
-#### `headers` #
+#### `headers`
 
 Sets response headers.
 
-example: `{ 'X-Hello': 'World!' }`
+example: `{ headers: { 'X-Hello': 'World!' } }`
 
 > defaults to `{}`
 
-#### `gzip` #
+#### `gzip`
 
-Enable support for sending compressed responses.  This will enable a check for a
-file with the same name plus '.gz' in the same folder.  If the compressed file is
-found and the client has indicated support for gzip file transfer, the contents
-of the .gz file will be sent in place of the uncompressed file along with a
-Content-Encoding: gzip header to inform the client the data has been compressed.
+Enable support for sending compressed responses.  This will enable a check for
+a file with the same name plus '.gz' in the same folder.  If the compressed
+file is found and the client has indicated support for gzip file transfer,
+the contents of the .gz file will be sent in place of the uncompressed file
+along with a Content-Encoding: gzip header to inform the client the data has
+been compressed.
 
 example: `{ gzip: true }`
 example: `{ gzip: /^\/text/ }`
 
 Passing `true` will enable this check for all files.
-Passing a RegExp instance will only enable this check if the content-type of the
-respond would match that RegExp using its test() method.
+Passing a RegExp instance will only enable this check if the content-type of
+the respond would match that RegExp using its test() method.
 
 > Defaults to `false`
 
-#### `indexFile` #
+#### `indexFile`
 
 Choose a custom index file when serving up directories.
 
 example: `{ indexFile: "index.htm" }`
 
 > Defaults to `index.html`
 
+#### `defaultExtension`
+
+Choose a default extension when serving files.
+A request to '/myFile' would check for a `myFile` folder (first) then a
+`myFile.html` (second).
+
+example: `{ defaultExtension: "html" }`
+
+> Defaults to `null`
+
 
 Command Line Interface
 ----------------------
 
 `node-static` also provides a CLI.
 
-### Installation #
+### Installation
 
 ```sh
 $ npm install -g node-static
 ```
 
-### Example Usage #
+### Example Usage
 
 ```sh
 # serve up the current directory