@jsenv/server 17.0.0 → 17.0.2

package/dist/jsenv_server.js

@@ -5370,10 +5370,24 @@ const createResourcePattern = (pattern) => {
     });
   }
 
+  const patternEndsWithSlash = pathnamePatternString.endsWith("/");
+
   return {
     match: (resource) => {
       const [pathname, search, hash] = resourceToParts(resource);
-      let result = pathnamePattern.match(decodeURIComponent(pathname));
+      let decodedPathname = decodeURIComponent(pathname);
+      let result;
+      if (patternEndsWithSlash && !searchPattern && !hashPattern) {
+        if (!decodedPathname.startsWith(pathnamePatternString)) {
+          return null;
+        }
+        result = {
+          named: {},
+          stars: [decodedPathname.slice(pathnamePatternString.length)],
+        };
+      } else {
+        result = pathnamePattern.match(decodedPathname);
+      }
       if (!result) {
         return null;
       }
@@ -8014,6 +8028,76 @@ const bufferToEtag = (buffer) => {
   return `"${length.toString(16)}-${hashBase64StringSubset}"`;
 };
 
+const fetchDirectory = (
+  url,
+  { headers = {}, rootDirectoryUrl } = {},
+) => {
+  url = String(url);
+  url = url[url.length - 1] === "/" ? url : `${url}/`;
+  const directoryContentArray = readdirSync(new URL(url));
+  const responseProducers = {
+    "application/json": () => {
+      const directoryContentJson = JSON.stringify(
+        directoryContentArray,
+        null,
+        "  ",
+      );
+      return {
+        status: 200,
+        headers: {
+          "content-type": "application/json",
+          "content-length": directoryContentJson.length,
+        },
+        body: directoryContentJson,
+      };
+    },
+    "text/html": () => {
+      const directoryAsHtml = `<!DOCTYPE html>
+<html>
+  <head>
+    <title>Directory explorer</title>
+    <meta charset="utf-8" />
+    <link rel="icon" href="data:," />
+  </head>
+
+  <body>
+    <h1>Content of directory ${url}</h1>
+    <ul>
+      ${directoryContentArray.map((filename) => {
+        const fileUrlObject = new URL(filename, url);
+        const fileUrl = String(fileUrlObject);
+        let fileUrlRelativeToServer = fileUrl.slice(
+          String(rootDirectoryUrl).length,
+        );
+        if (lstatSync(fileUrlObject).isDirectory()) {
+          fileUrlRelativeToServer += "/";
+        }
+        return `<li>
+        <a href="/${fileUrlRelativeToServer}">${fileUrlRelativeToServer}</a>
+      </li>`;
+      }).join(`
+      `)}
+    </ul>
+  </body>
+</html>`;
+
+      return {
+        status: 200,
+        headers: {
+          "content-type": "text/html",
+          "content-length": Buffer.byteLength(directoryAsHtml),
+        },
+        body: directoryAsHtml,
+      };
+    },
+  };
+  const bestContentType = pickContentType(
+    { headers },
+    Object.keys(responseProducers),
+  );
+  return responseProducers[bestContentType || "application/json"]();
+};
+
 const convertFileSystemErrorToResponseProperties = (error) => {
   // https://iojs.org/api/errors.html#errors_eacces_permission_denied
   if (isErrorWithCode(error, "EACCES")) {
@@ -8099,76 +8183,6 @@ const fileSystemPathToUrl = (value) => {
   return String(pathToFileURL(value));
 };
 
-const serveDirectory = (
-  url,
-  { headers = {}, rootDirectoryUrl } = {},
-) => {
-  url = String(url);
-  url = url[url.length - 1] === "/" ? url : `${url}/`;
-  const directoryContentArray = readdirSync(new URL(url));
-  const responseProducers = {
-    "application/json": () => {
-      const directoryContentJson = JSON.stringify(
-        directoryContentArray,
-        null,
-        "  ",
-      );
-      return {
-        status: 200,
-        headers: {
-          "content-type": "application/json",
-          "content-length": directoryContentJson.length,
-        },
-        body: directoryContentJson,
-      };
-    },
-    "text/html": () => {
-      const directoryAsHtml = `<!DOCTYPE html>
-<html>
-  <head>
-    <title>Directory explorer</title>
-    <meta charset="utf-8" />
-    <link rel="icon" href="data:," />
-  </head>
-
-  <body>
-    <h1>Content of directory ${url}</h1>
-    <ul>
-      ${directoryContentArray.map((filename) => {
-        const fileUrlObject = new URL(filename, url);
-        const fileUrl = String(fileUrlObject);
-        let fileUrlRelativeToServer = fileUrl.slice(
-          String(rootDirectoryUrl).length,
-        );
-        if (lstatSync(fileUrlObject).isDirectory()) {
-          fileUrlRelativeToServer += "/";
-        }
-        return `<li>
-        <a href="/${fileUrlRelativeToServer}">${fileUrlRelativeToServer}</a>
-      </li>`;
-      }).join(`
-      `)}
-    </ul>
-  </body>
-</html>`;
-
-      return {
-        status: 200,
-        headers: {
-          "content-type": "text/html",
-          "content-length": Buffer.byteLength(directoryAsHtml),
-        },
-        body: directoryAsHtml,
-      };
-    },
-  };
-  const bestContentType = pickContentType(
-    { headers },
-    Object.keys(responseProducers),
-  );
-  return responseProducers[bestContentType || "application/json"]();
-};
-
 /*
  * This function returns response properties in a plain object like
  * { status: 200, body: "Hello world" }.
@@ -8187,17 +8201,17 @@ const fetchFileSystem = async (
   helpers,
   directoryUrl,
   {
+    mainFileRelativeUrl = null,
     etagEnabled = false,
     etagMemory = true,
     etagMemoryMaxSize = 1000,
     mtimeEnabled = false,
     compressionEnabled = false,
     compressionSizeThreshold = 1024,
-    cacheControl = etagEnabled || mtimeEnabled
-      ? "private,max-age=0,must-revalidate"
-      : "no-store",
+    cacheControl,
+    isVersioned = defaultIsVersioned,
     canReadDirectory = false,
-    ENOENTFallback = () => {},
+    ENOENTFallback = () => null,
   } = {},
 ) => {
   let directoryUrlString = asUrlString(directoryUrl);
@@ -8223,7 +8237,11 @@ const fetchFileSystem = async (
   const filesystemUrl = new URL(resource, directoryUrl);
   const urlString = asUrlString(filesystemUrl);
 
-  if (typeof cacheControl === "function") {
+  if (cacheControl === undefined) {
+    cacheControl = isVersioned(request)
+      ? `private,max-age=${SECONDS_IN_30_DAYS},immutable`
+      : "private,max-age=0,must-revalidate";
+  } else if (typeof cacheControl === "function") {
     cacheControl = cacheControl(request);
   }
 
@@ -8259,12 +8277,15 @@ const fetchFileSystem = async (
 
       if (fileStat.isDirectory()) {
         if (canReadDirectory) {
-          return serveDirectory(fileUrl, {
+          return fetchDirectory(fileUrl, {
             headers: request.headers,
             canReadDirectory,
             rootDirectoryUrl: directoryUrl,
           });
         }
+        if (mainFileRelativeUrl && fileUrl === directoryUrlString) {
+          return serveFile(new URL(mainFileRelativeUrl, directoryUrl).href);
+        }
         return {
           status: 403,
           statusText: "not allowed to read directory",
@@ -8335,6 +8356,15 @@ const fetchFileSystem = async (
       return composeTwoResponses(intermediateResponse, clientCacheResponse);
     } catch (e) {
       if (e.code === "ENOENT") {
+        if (mainFileRelativeUrl) {
+          if (
+            !urlToExtension(fileUrl) &&
+            !urlToPathname(fileUrl).endsWith("/")
+          ) {
+            const mainFileUrl = new URL(mainFileRelativeUrl, directoryUrl);
+            return serveFile(mainFileUrl);
+          }
+        }
         const fallbackFileUrl = ENOENTFallback();
         if (fallbackFileUrl) {
           return serveFile(fallbackFileUrl);
@@ -8606,46 +8636,15 @@ const asUrlString = (value) => {
   return null;
 };
 
-const serverPluginStaticFiles = ({ directoryUrl, mainFilePath }) => {
-  return {
-    name: "jsenv:static_files",
-    routes: [
-      {
-        endpoint: "GET *",
-        description: "Serve static files.",
-        fetch: (request, helpers) => {
-          const urlIsVersioned = new URL(request.url).searchParams.has("v");
-          if (mainFilePath && request.resource === "/") {
-            request = {
-              ...request,
-              resource: `/${mainFilePath}`,
-            };
-          }
-          const urlObject = new URL(request.resource.slice(1), directoryUrl);
-          return createFileSystemFetch(directoryUrl, {
-            cacheControl: urlIsVersioned
-              ? `private,max-age=${SECONDS_IN_30_DAYS},immutable`
-              : "private,max-age=0,must-revalidate",
-            etagEnabled: true,
-            compressionEnabled: true,
-            canReadDirectory: true,
-            ENOENTFallback: () => {
-              if (
-                !urlToExtension(urlObject) &&
-                !urlToPathname(urlObject).endsWith("/")
-              ) {
-                return new URL(mainFilePath, directoryUrl);
-              }
-              return null;
-            },
-          })(request, helpers);
-        },
-      },
-    ],
-  };
-};
 const SECONDS_IN_30_DAYS = 60 * 60 * 24 * 30;
 
+const defaultIsVersioned = (request) => {
+  if (!request.url) {
+    return false;
+  }
+  return new URL(request.url).searchParams.has("v");
+};
+
 const serverPluginResponseAcceptanceCheck = () => {
   return {
     name: "jsenv:response_acceptance_check",
@@ -8735,4 +8734,4 @@ const replaceResource = (resourceBeforeAlias, newValue) => {
   return resource;
 };
 
-export { LazyServerEvents, ProgressiveResponse, STOP_REASON_INTERNAL_ERROR, STOP_REASON_NOT_SPECIFIED, STOP_REASON_PROCESS_BEFORE_EXIT, STOP_REASON_PROCESS_EXIT, STOP_REASON_PROCESS_SIGHUP, STOP_REASON_PROCESS_SIGINT, STOP_REASON_PROCESS_SIGTERM, ServerEvents, WebSocketResponse, composeTwoResponses, createFileSystemFetch, createPluginsController, fetchFileSystem, findFreePort, jsenvAccessControlAllowedHeaders, jsenvAccessControlAllowedMethods, pickContentEncoding, pickContentLanguage, pickContentType, serveDirectory, serverPluginCORS, serverPluginErrorHandler, serverPluginRequestAliases, serverPluginResponseAcceptanceCheck, serverPluginStaticFiles, startServer };
+export { LazyServerEvents, ProgressiveResponse, STOP_REASON_INTERNAL_ERROR, STOP_REASON_NOT_SPECIFIED, STOP_REASON_PROCESS_BEFORE_EXIT, STOP_REASON_PROCESS_EXIT, STOP_REASON_PROCESS_SIGHUP, STOP_REASON_PROCESS_SIGINT, STOP_REASON_PROCESS_SIGTERM, ServerEvents, WebSocketResponse, composeTwoResponses, createFileSystemFetch, createPluginsController, fetchDirectory, fetchFileSystem, findFreePort, jsenvAccessControlAllowedHeaders, jsenvAccessControlAllowedMethods, pickContentEncoding, pickContentLanguage, pickContentType, serverPluginCORS, serverPluginErrorHandler, serverPluginRequestAliases, serverPluginResponseAcceptanceCheck, startServer };

package/index.js

@@ -37,9 +37,8 @@ export {
 export {
   createFileSystemFetch,
   fetchFileSystem,
-} from "./src/plugins/filesystem/fetch_filesystem.js";
-export { serveDirectory } from "./src/plugins/filesystem/serve_directory.js";
-export { serverPluginStaticFiles } from "./src/plugins/filesystem/server_plugin_static_files.js";
+} from "./src/plugins/filesystem/fetch_file.js";
+export { fetchDirectory } from "./src/plugins/filesystem/fetch_directory.js";
 
 // content-negotiation
 export { pickContentType } from "./src/content_negotiation/pick_content_type.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/server",
-  "version": "17.0.0",
+  "version": "17.0.2",
   "description": "A modern Node.js HTTP server with declarative routing, content negotiation, and WebSocket support",
   "repository": {
     "type": "git",

package/src/plugins/filesystem/{serve_directory.js → fetch_directory.js}

@@ -2,7 +2,7 @@ import { lstatSync, readdirSync } from "node:fs";
 
 import { pickContentType } from "../../content_negotiation/pick_content_type.js";
 
-export const serveDirectory = (
+export const fetchDirectory = (
   url,
   { headers = {}, rootDirectoryUrl } = {},
 ) => {

package/src/plugins/filesystem/{fetch_filesystem.js → fetch_file.js}

@@ -4,18 +4,19 @@
  * It is meant to be used inside "requestToResponse"
  */
 
+import { urlToExtension, urlToPathname } from "@jsenv/urls";
 import { CONTENT_TYPE } from "@jsenv/utils/src/content_type/content_type.js";
 import { createReadStream, readFile, statSync } from "node:fs";
 
 import { pickContentEncoding } from "../../content_negotiation/pick_content_encoding.js";
 import { composeTwoResponses } from "../../internal/response_composition.js";
 import { bufferToEtag } from "./etag.js";
+import { fetchDirectory } from "./fetch_directory.js";
 import { convertFileSystemErrorToResponseProperties } from "./filesystem_error_to_response.js";
 import {
   fileSystemPathToUrl,
   isFileSystemPath,
 } from "./filesystem_path_and_url.js";
-import { serveDirectory } from "./serve_directory.js";
 
 export const createFileSystemFetch = (directoryUrl, options) => {
   return (request, helpers) => {
@@ -28,17 +29,17 @@ export const fetchFileSystem = async (
   helpers,
   directoryUrl,
   {
+    mainFileRelativeUrl = null,
     etagEnabled = false,
     etagMemory = true,
     etagMemoryMaxSize = 1000,
     mtimeEnabled = false,
     compressionEnabled = false,
     compressionSizeThreshold = 1024,
-    cacheControl = etagEnabled || mtimeEnabled
-      ? "private,max-age=0,must-revalidate"
-      : "no-store",
+    cacheControl,
+    isVersioned = defaultIsVersioned,
     canReadDirectory = false,
-    ENOENTFallback = () => {},
+    ENOENTFallback = () => null,
   } = {},
 ) => {
   let directoryUrlString = asUrlString(directoryUrl);
@@ -64,7 +65,11 @@ export const fetchFileSystem = async (
   const filesystemUrl = new URL(resource, directoryUrl);
   const urlString = asUrlString(filesystemUrl);
 
-  if (typeof cacheControl === "function") {
+  if (cacheControl === undefined) {
+    cacheControl = isVersioned(request)
+      ? `private,max-age=${SECONDS_IN_30_DAYS},immutable`
+      : "private,max-age=0,must-revalidate";
+  } else if (typeof cacheControl === "function") {
     cacheControl = cacheControl(request);
   }
 
@@ -100,12 +105,15 @@ export const fetchFileSystem = async (
 
       if (fileStat.isDirectory()) {
         if (canReadDirectory) {
-          return serveDirectory(fileUrl, {
+          return fetchDirectory(fileUrl, {
             headers: request.headers,
             canReadDirectory,
             rootDirectoryUrl: directoryUrl,
           });
         }
+        if (mainFileRelativeUrl && fileUrl === directoryUrlString) {
+          return serveFile(new URL(mainFileRelativeUrl, directoryUrl).href);
+        }
         return {
           status: 403,
           statusText: "not allowed to read directory",
@@ -176,6 +184,15 @@ export const fetchFileSystem = async (
       return composeTwoResponses(intermediateResponse, clientCacheResponse);
     } catch (e) {
       if (e.code === "ENOENT") {
+        if (mainFileRelativeUrl) {
+          if (
+            !urlToExtension(fileUrl) &&
+            !urlToPathname(fileUrl).endsWith("/")
+          ) {
+            const mainFileUrl = new URL(mainFileRelativeUrl, directoryUrl);
+            return serveFile(mainFileUrl);
+          }
+        }
         const fallbackFileUrl = ENOENTFallback();
         if (fallbackFileUrl) {
           return serveFile(fallbackFileUrl);
@@ -446,3 +463,12 @@ const asUrlString = (value) => {
   }
   return null;
 };
+
+const SECONDS_IN_30_DAYS = 60 * 60 * 24 * 30;
+
+const defaultIsVersioned = (request) => {
+  if (!request.url) {
+    return false;
+  }
+  return new URL(request.url).searchParams.has("v");
+};

package/src/plugins/filesystem/server_plugin_static_files.js

@@ -1,44 +0,0 @@
-import { urlToExtension, urlToPathname } from "@jsenv/urls";
-
-import { createFileSystemFetch } from "./fetch_filesystem.js";
-
-export const serverPluginStaticFiles = ({ directoryUrl, mainFilePath }) => {
-  return {
-    name: "jsenv:static_files",
-    routes: [
-      {
-        endpoint: "GET *",
-        description: "Serve static files.",
-        fetch: (request, helpers) => {
-          const urlIsVersioned = new URL(request.url).searchParams.has("v");
-          if (mainFilePath && request.resource === "/") {
-            request = {
-              ...request,
-              resource: `/${mainFilePath}`,
-            };
-          }
-          const urlObject = new URL(request.resource.slice(1), directoryUrl);
-          return createFileSystemFetch(directoryUrl, {
-            cacheControl: urlIsVersioned
-              ? `private,max-age=${SECONDS_IN_30_DAYS},immutable`
-              : "private,max-age=0,must-revalidate",
-            etagEnabled: true,
-            compressionEnabled: true,
-            rootDirectoryUrl: directoryUrl,
-            canReadDirectory: true,
-            ENOENTFallback: () => {
-              if (
-                !urlToExtension(urlObject) &&
-                !urlToPathname(urlObject).endsWith("/")
-              ) {
-                return new URL(mainFilePath, directoryUrl);
-              }
-              return null;
-            },
-          })(request, helpers);
-        },
-      },
-    ],
-  };
-};
-const SECONDS_IN_30_DAYS = 60 * 60 * 24 * 30;