jeasx 2.7.5 → 2.8.1

package/build.js

@@ -1,6 +1,6 @@
 import * as esbuild from "esbuild";
-import { writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { glob, stat, writeFile } from "node:fs/promises";
+import { join, sep } from "node:path";
 import env from "./env.js";
 
 env();
@@ -54,22 +54,43 @@ const BROWSER_OPTIONS = {
   ...CONFIG.ESBUILD_BROWSER_OPTIONS?.(),
 };
 
-[SERVER_OPTIONS, BROWSER_OPTIONS].forEach(async (options) => {
+for (const options of [SERVER_OPTIONS, BROWSER_OPTIONS]) {
   if (NODE_ENV_IS_DEVELOPMENT) {
     (await esbuild.context(options)).watch();
   } else {
-    const result = await esbuild.build(options);
-    if (options === SERVER_OPTIONS) {
-      // Create metadata file with all routes
-      if (result.metafile?.outputs) {
-        const routes = Object.keys(result.metafile.outputs)
-          .filter((path) => /\[.+\]\.js$/.test(path))
-          .map((path) => path.slice("dist".length, -".js".length));
-        await writeFile(
-          join(CWD, "dist", "[--metadata--].js"),
-          `export default ${JSON.stringify({ routes })};`,
-        );
-      }
+    await esbuild.build(options);
+  }
+}
+
+// Export path mappings for routes and files
+if (!NODE_ENV_IS_DEVELOPMENT) {
+  /** @type Record<string,string> */
+  const routes = {};
+  /** @type Record<string,string> */
+  const files = {};
+
+  for await (const entry of glob("{dist,public}/**/*")) {
+    const path = entry.split(sep).join("/");
+
+    // Handle server routes.
+    if (/^dist\/.*\[.+\]\.js$/.test(path)) {
+      routes[path.slice("dist".length, -".js".length)] = path;
+      continue;
+    }
+
+    // Skip sourcemaps for server routes.
+    if (/^dist\/.*\[.+\]\.js\.map$/.test(path)) {
+      continue;
+    }
+
+    // Treat all other entries as static files.
+    if ((await stat(join(CWD, path))).isFile()) {
+      files[path.slice(path.indexOf("/"))] = path;
     }
   }
-});
+
+  await writeFile(
+    join(CWD, "dist", "[--metadata--].js"),
+    `export default ${JSON.stringify({ routes, files })};`,
+  );
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jeasx",
-  "version": "2.7.5",
+  "version": "2.8.1",
   "description": "Jeasx - the ease of JSX with the power of SSR",
   "keywords": [
     "async",
@@ -32,10 +32,10 @@
     "@fastify/cookie": "11.0.2",
     "@fastify/formbody": "8.0.2",
     "@fastify/multipart": "10.0.0",
-    "@fastify/static": "9.1.3",
-    "@types/node": "26.0.1",
+    "@fastify/send": "4.1.0",
+    "@types/node": "26.1.0",
     "esbuild": "0.28.1",
-    "fastify": "5.9.0",
+    "fastify": "5.10.0",
     "jsx-async-runtime": "2.1.3"
   },
   "allowScripts": {

package/serverless.js

@@ -1,23 +1,21 @@
 import fastifyCookie from "@fastify/cookie";
 import fastifyFormbody from "@fastify/formbody";
 import fastifyMultipart from "@fastify/multipart";
-import fastifyStatic from "@fastify/static";
+import fastifySend from "@fastify/send";
 import fastify from "fastify";
 import { jsxToString } from "jsx-async-runtime";
 import { stat } from "node:fs/promises";
 import { join } from "node:path";
+import { Readable } from "node:stream";
 import env from "./env.js";
 env();
 const CWD = process.cwd();
 const CONFIG = (await import(`file://${join(CWD, "jeasx.config.js")}`)).default;
 const NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === "development";
-const MODULE_BY_ROUTE = {};
-if (!NODE_ENV_IS_DEVELOPMENT) {
-  const { routes } = (await import(`file://${join(CWD, "dist", "[--metadata--].js")}`)).default;
-  for (const route of routes) {
-    MODULE_BY_ROUTE[route] = join(CWD, "dist", `${route}.js`);
-  }
-}
+const { routes: MODULE_BY_ROUTE, files: FILE_BY_PATH } = NODE_ENV_IS_DEVELOPMENT ? { routes: {}, files: {} } : (await import(`file://${join(CWD, "dist", "[--metadata--].js")}`)).default;
+const FASTIFY_SEND_OPTIONS = {
+  ...CONFIG.FASTIFY_SEND_OPTIONS?.()
+};
 const FASTIFY_SERVER = CONFIG.FASTIFY_SERVER ?? ((fastify2) => fastify2);
 var serverless_default = FASTIFY_SERVER(
   fastify({
@@ -30,12 +28,7 @@ var serverless_default = FASTIFY_SERVER(
     ...CONFIG.FASTIFY_FORMBODY_OPTIONS?.()
   }).register(fastifyMultipart, {
     ...CONFIG.FASTIFY_MULTIPART_OPTIONS?.()
-  }).register(fastifyStatic, {
-    root: ["public", "dist"].map((dir) => join(CWD, dir)),
-    wildcard: false,
-    globIgnore: ["/**/\\[*\\].js?(.map)"],
-    ...CONFIG.FASTIFY_STATIC_OPTIONS?.()
-  }).decorateRequest("route", "").decorateRequest("path", "").addHook("onRequest", async (request) => {
+  }).decorateRequest("route", "").decorateRequest("path", "").decorateReply("file", void 0).addHook("onRequest", async (request) => {
     const index = request.url.indexOf("?");
     request.path = index === -1 ? request.url : request.url.slice(0, index);
   }).all("*", async (request, reply) => {
@@ -56,14 +49,24 @@ async function handler(request, reply) {
   const context = {};
   const props = { request, reply };
   try {
+    reply.file = await tryFile(request);
     for (const route of generateRoutes(request.path)) {
+      if (route === request.path) {
+        if (reply.file) {
+          reply.status(reply.file.statusCode);
+          reply.headers(reply.file.headers);
+          response = reply.file.stream;
+          break;
+        }
+        continue;
+      }
       let module = MODULE_BY_ROUTE[route];
       if (module === void 0 && !NODE_ENV_IS_DEVELOPMENT) {
         continue;
       }
       try {
         if (typeof module === "string") {
-          module = MODULE_BY_ROUTE[route] = await import(`file://${module}`);
+          module = MODULE_BY_ROUTE[route] = await import(`file://${join(CWD, module)}`);
         } else if (module === void 0 && NODE_ENV_IS_DEVELOPMENT) {
           const modulePath = join(CWD, "dist", `${route}.js`);
           if (typeof require === "function" && require.cache[modulePath]) {
@@ -73,7 +76,7 @@ async function handler(request, reply) {
           module = await import(`file://${modulePath}?${mtime}`);
         }
       } catch (e) {
-        switch (e.code) {
+        switch (e?.code) {
           case "ENOENT":
           case "ENOTDIR":
           case "ERR_MODULE_NOT_FOUND":
@@ -82,17 +85,16 @@ async function handler(request, reply) {
             throw e;
         }
       }
-      if (!module || typeof module !== "object") {
-        continue;
-      }
       request.route = route;
-      response = typeof module.default === "function" ? (
-        // Call functions with context as `this` and props as parameters,
-        await module.default.call(context, props)
-      ) : (
-        // otherwise return default export.
-        module.default
-      );
+      if (module && typeof module === "object") {
+        response = typeof module.default === "function" ? (
+          // Call functions with context as `this` and props as parameters,
+          await module.default.call(context, props)
+        ) : (
+          // otherwise return default export.
+          module.default
+        );
+      }
       if (reply.sent) {
         return;
       } else if (route.endsWith("/[404]")) {
@@ -100,24 +102,24 @@ async function handler(request, reply) {
           reply.status(404);
         }
         break;
-      } else if (typeof response === "string" || Buffer.isBuffer(response) || isJSX(response)) {
+      } else if (typeof response === "string" || response instanceof Readable || Buffer.isBuffer(response) || isJSX(response)) {
         break;
-      } else if (route.endsWith("/[...guard]") && (response === void 0 || typeof response === "object")) {
+      } else if (route.endsWith("/[...guard]") && typeof response === "object") {
         Object.assign(props, response);
         continue;
-      } else if (reply.statusCode === 404) {
+      } else if (response === void 0 || reply.statusCode === 404) {
         continue;
       } else {
         break;
       }
     }
-    return await renderJSX(context, response);
+    return await renderResponse(context, response);
   } catch (error) {
     const errorHandler = context["errorHandler"];
     if (typeof errorHandler === "function") {
       reply.status(500);
       response = await errorHandler.call(context, error);
-      return await renderJSX(context, response);
+      return await renderResponse(context, response);
     } else {
       throw error;
     }
@@ -126,27 +128,26 @@ async function handler(request, reply) {
 function generateRoutes(path) {
   const routes = [];
   const segments = [""];
-  let current = "";
+  let edgeSegment = "";
   for (const segment of path.split("/")) {
     if (segment !== "") {
-      current += `/${segment}`;
-      segments.push(current);
+      edgeSegment += `/${segment}`;
+      segments.push(edgeSegment);
     }
   }
-  segments.reverse();
-  for (let i = segments.length - 1; i >= 0; i--) {
+  for (let i = 0; i < segments.length; i++) {
     routes.push(`${segments[i]}/[...guard]`);
   }
-  const edgeSegment = segments[0];
+  routes.push(path);
   const lastSlash = edgeSegment.lastIndexOf("/") + 1;
   if (lastSlash > 0) {
     routes.push(`${edgeSegment.substring(0, lastSlash)}[${edgeSegment.substring(lastSlash)}]`);
   }
   routes.push(`${edgeSegment}/[index]`);
-  for (let i = 0; i < segments.length; i++) {
+  for (let i = segments.length - 1; i >= 0; i--) {
     routes.push(`${segments[i]}/[...path]`);
   }
-  for (let i = 0; i < segments.length; i++) {
+  for (let i = segments.length - 1; i >= 0; i--) {
     routes.push(`${segments[i]}/[404]`);
   }
   return routes;
@@ -154,11 +155,33 @@ function generateRoutes(path) {
 function isJSX(obj) {
   return !!obj && typeof obj === "object" && "type" in obj && "props" in obj;
 }
-async function renderJSX(context, response) {
+async function renderResponse(context, response) {
   const payload = isJSX(response) ? await jsxToString.call(context, response) : response;
   const responseHandler = context["responseHandler"];
   return typeof responseHandler === "function" ? await responseHandler.call(context, payload) : payload;
 }
+async function tryFile(request) {
+  const file = FILE_BY_PATH[request.path];
+  if (file) {
+    return await fastifySend(request.raw, file, FASTIFY_SEND_OPTIONS);
+  }
+  if (NODE_ENV_IS_DEVELOPMENT) {
+    for (const directory of ["dist", "public"]) {
+      try {
+        if ((await stat(join(CWD, directory, request.path))).isFile()) {
+          return await fastifySend(
+            request.raw,
+            `${directory}${request.path}`,
+            FASTIFY_SEND_OPTIONS
+          );
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+  return void 0;
+}
 export {
   serverless_default as default
 };

package/serverless.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["serverless.ts"],
-  "sourcesContent": ["import fastifyCookie, { FastifyCookieOptions } from \"@fastify/cookie\";\nimport fastifyFormbody, { FastifyFormbodyOptions } from \"@fastify/formbody\";\nimport fastifyMultipart, { FastifyMultipartOptions } from \"@fastify/multipart\";\nimport fastifyStatic, { FastifyStaticOptions } from \"@fastify/static\";\nimport fastify, {\n  FastifyInstance,\n  FastifyReply,\n  FastifyRequest,\n  FastifyServerOptions,\n} from \"fastify\";\nimport { jsxToString } from \"jsx-async-runtime\";\nimport { stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport env from \"./env.js\";\n\nenv();\n\nconst CWD = process.cwd();\nconst CONFIG = (await import(`file://${join(CWD, \"jeasx.config.js\")}`)).default;\nconst NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === \"development\";\n\n// Mapping for route modules used in non-development environments.\nconst MODULE_BY_ROUTE: Record<string, { default: Function } | string> = {};\n\n// Initialize the mapping with absolute paths for all known modules.\n// Modules are lazily loaded on their first request for a specific route.\nif (!NODE_ENV_IS_DEVELOPMENT) {\n  const { routes } = (await import(`file://${join(CWD, \"dist\", \"[--metadata--].js\")}`)).default as {\n    routes: string[];\n  };\n  // Map route identifiers to their absolute file system paths in the build directory.\n  for (const route of routes) {\n    MODULE_BY_ROUTE[route] = join(CWD, \"dist\", `${route}.js`);\n  }\n}\n\ndeclare module \"fastify\" {\n  interface FastifyRequest {\n    path: string; // Path without query parameters\n    route: string; // Path to resolved route handler\n  }\n}\n\n// Enhance Fastify server from userland\nconst FASTIFY_SERVER = (CONFIG.FASTIFY_SERVER ?? ((fastify) => fastify)) as (\n  fastify: FastifyInstance,\n) => FastifyInstance;\n\n// Create and export a Fastify instance\nexport default FASTIFY_SERVER(\n  fastify({\n    ...(CONFIG.FASTIFY_SERVER_OPTIONS?.() as FastifyServerOptions),\n  }),\n)\n  // Create encapsulation context\n  .register((fastify) => {\n    fastify\n      .register(fastifyCookie, {\n        ...(CONFIG.FASTIFY_COOKIE_OPTIONS?.() as FastifyCookieOptions),\n      })\n      .register(fastifyFormbody, {\n        ...(CONFIG.FASTIFY_FORMBODY_OPTIONS?.() as FastifyFormbodyOptions),\n      })\n      .register(fastifyMultipart, {\n        ...(CONFIG.FASTIFY_MULTIPART_OPTIONS?.() as FastifyMultipartOptions),\n      })\n      .register(fastifyStatic, {\n        root: [\"public\", \"dist\"].map((dir) => join(CWD, dir)),\n        wildcard: false,\n        globIgnore: [\"/**/\\\\[*\\\\].js?(.map)\"],\n        ...(CONFIG.FASTIFY_STATIC_OPTIONS?.() as FastifyStaticOptions),\n      })\n      .decorateRequest(\"route\", \"\")\n      .decorateRequest(\"path\", \"\")\n      .addHook(\"onRequest\", async (request) => {\n        // Extract path from url\n        const index = request.url.indexOf(\"?\");\n        request.path = index === -1 ? request.url : request.url.slice(0, index);\n      })\n      .all(\"*\", async (request: FastifyRequest, reply: FastifyReply) => {\n        try {\n          const payload = await handler(request, reply);\n          if (\n            reply.getHeader(\"content-type\") === undefined &&\n            (typeof payload === \"string\" || Buffer.isBuffer(payload))\n          ) {\n            reply.type(\"text/html; charset=utf-8\");\n          }\n          return payload;\n        } catch (error) {\n          request.log.error(error);\n          throw error;\n        }\n      });\n  });\n\n/**\n * Resolves route module based on the request path and execute it.\n */\nasync function handler(request: FastifyRequest, reply: FastifyReply) {\n  let response: unknown;\n\n  // Global context object for route handlers\n  const context = {};\n\n  // Default props for route handlers\n  const props = { request, reply };\n\n  try {\n    // Execute route handlers for current request\n    for (const route of generateRoutes(request.path)) {\n      // Resolve module or path to module\n      let module = MODULE_BY_ROUTE[route];\n\n      // Skip processing if the route path was not initialized.\n      if (module === undefined && !NODE_ENV_IS_DEVELOPMENT) {\n        continue;\n      }\n\n      // Module was not loaded yet?\n      try {\n        if (typeof module === \"string\") {\n          // Production: Load and cache module only via pre-calculated path.\n          // This avoids potential path traversal vulnerabilities caused\n          // by unexpected `route` values.\n          module = MODULE_BY_ROUTE[route] = await import(`file://${module}`);\n        } else if (module === undefined && NODE_ENV_IS_DEVELOPMENT) {\n          // Only map module paths depending on `route` during development.\n          const modulePath = join(CWD, \"dist\", `${route}.js`);\n          if (typeof require === \"function\" && require.cache[modulePath]) {\n            // Bun: Remove module from cache before importing\n            // as query parameter for import is ignored.\n            delete require.cache[modulePath];\n          }\n          // Use timestamp as query parameter to update modules.\n          const mtime = (await stat(modulePath)).mtime.getTime();\n          // Dynamic imports are restricted to development environments;\n          // therefore, production-level path validation is not required here.\n          module = await import(`file://${modulePath}?${mtime}`);\n        }\n      } catch (e) {\n        switch (e.code) {\n          case \"ENOENT\":\n          case \"ENOTDIR\":\n          case \"ERR_MODULE_NOT_FOUND\":\n            continue;\n          default:\n            // Module exists, but fails to load.\n            throw e;\n        }\n      }\n\n      // Ensure module is a valid object before processing.\n      if (!module || typeof module !== \"object\") {\n        continue;\n      }\n\n      // Store current route in request.\n      request.route = route;\n\n      response =\n        typeof module.default === \"function\"\n          ? // Call functions with context as `this` and props as parameters,\n            await module.default.call(context, props)\n          : // otherwise return default export.\n            module.default;\n\n      if (reply.sent) {\n        return;\n      } else if (route.endsWith(\"/[404]\")) {\n        // Preserve existing status if a 404 page is requested directly.\n        // If no status is defined, set status to 404 automatically.\n        if (reply.statusCode === 200 && !request.path.endsWith(\"/404\")) {\n          reply.status(404);\n        }\n        break;\n      } else if (typeof response === \"string\" || Buffer.isBuffer(response) || isJSX(response)) {\n        break;\n      } else if (\n        route.endsWith(\"/[...guard]\") &&\n        (response === undefined || typeof response === \"object\")\n      ) {\n        // Add object entries from guard to props\n        Object.assign(props, response);\n        continue;\n      } else if (reply.statusCode === 404) {\n        continue;\n      } else {\n        break;\n      }\n    }\n    return await renderJSX(context, response);\n  } catch (error) {\n    const errorHandler = context[\"errorHandler\"];\n    if (typeof errorHandler === \"function\") {\n      reply.status(500);\n      response = await errorHandler.call(context, error);\n      return await renderJSX(context, response);\n    } else {\n      throw error;\n    }\n  }\n}\n\n/**\n * Generates all possible routes based on the given input path.\n *\n * Example routes for \"/a/b/c\":\n *\n * [\n *  \"/[...guard]\",\"/a/[...guard]\",\"/a/b/[...guard]\",\"/a/b/c/[...guard]\",\n *  \"/a/b/[c]\",\"/a/b/c/[index]\",\n *  \"/a/b/c/[...path]\",\"/a/b/[...path]\",\"/a/[...path]\",\"/[...path]\",\n *  \"/a/b/c/[404]\",\"/a/b/[404]\",\"/a/[404]\",\"/[404]\"\n * ]\n */\nfunction generateRoutes(path: string): string[] {\n  const routes = [];\n\n  // Transform given path into array of all its segments.\n  // \"/a/b/c\" => [\"/a/b/c\", \"/a/b\", \"/a\", \"\"]\n  const segments = [\"\"];\n  let current = \"\";\n  for (const segment of path.split(\"/\")) {\n    // Ignore redundant slashes.\n    if (segment !== \"\") {\n      current += `/${segment}`;\n      segments.push(current);\n    }\n  }\n  segments.reverse();\n\n  // [...guard]s are evaluated from top to bottom\n  for (let i = segments.length - 1; i >= 0; i--) {\n    routes.push(`${segments[i]}/[...guard]`);\n  }\n\n  // \"/a/b/c\" => [\"/a/b/[c]\", \"/a/b/c/[index]\"]\n  const edgeSegment = segments[0];\n  const lastSlash = edgeSegment.lastIndexOf(\"/\") + 1;\n  if (lastSlash > 0) {\n    routes.push(`${edgeSegment.substring(0, lastSlash)}[${edgeSegment.substring(lastSlash)}]`);\n  }\n  routes.push(`${edgeSegment}/[index]`);\n\n  for (let i = 0; i < segments.length; i++) {\n    routes.push(`${segments[i]}/[...path]`);\n  }\n\n  for (let i = 0; i < segments.length; i++) {\n    routes.push(`${segments[i]}/[404]`);\n  }\n\n  return routes;\n}\n\n/**\n * Determines if a given object is a JSX element.\n */\nfunction isJSX(obj: unknown): boolean {\n  return !!obj && typeof obj === \"object\" && \"type\" in obj && \"props\" in obj;\n}\n\n/**\n * Renders JSX to string and applies optional response handler.\n */\nasync function renderJSX(context: object, response: unknown) {\n  const payload = isJSX(response) ? await jsxToString.call(context, response) : response;\n\n  // Post-process the payload with an optional response handler\n  const responseHandler = context[\"responseHandler\"];\n  return typeof responseHandler === \"function\"\n    ? await responseHandler.call(context, payload)\n    : payload;\n}\n"],
-  "mappings": "AAAA,OAAO,mBAA6C;AACpD,OAAO,qBAAiD;AACxD,OAAO,sBAAmD;AAC1D,OAAO,mBAA6C;AACpD,OAAO,aAKA;AACP,SAAS,mBAAmB;AAC5B,SAAS,YAAY;AACrB,SAAS,YAAY;AACrB,OAAO,SAAS;AAEhB,IAAI;AAEJ,MAAM,MAAM,QAAQ,IAAI;AACxB,MAAM,UAAU,MAAM,OAAO,UAAU,KAAK,KAAK,iBAAiB,CAAC,KAAK;AACxE,MAAM,0BAA0B,QAAQ,IAAI,aAAa;AAGzD,MAAM,kBAAkE,CAAC;AAIzE,IAAI,CAAC,yBAAyB;AAC5B,QAAM,EAAE,OAAO,KAAK,MAAM,OAAO,UAAU,KAAK,KAAK,QAAQ,mBAAmB,CAAC,KAAK;AAItF,aAAW,SAAS,QAAQ;AAC1B,oBAAgB,KAAK,IAAI,KAAK,KAAK,QAAQ,GAAG,KAAK,KAAK;AAAA,EAC1D;AACF;AAUA,MAAM,iBAAkB,OAAO,mBAAmB,CAACA,aAAYA;AAK/D,IAAO,qBAAQ;AAAA,EACb,QAAQ;AAAA,IACN,GAAI,OAAO,yBAAyB;AAAA,EACtC,CAAC;AACH,EAEG,SAAS,CAACA,aAAY;AACrB,EAAAA,SACG,SAAS,eAAe;AAAA,IACvB,GAAI,OAAO,yBAAyB;AAAA,EACtC,CAAC,EACA,SAAS,iBAAiB;AAAA,IACzB,GAAI,OAAO,2BAA2B;AAAA,EACxC,CAAC,EACA,SAAS,kBAAkB;AAAA,IAC1B,GAAI,OAAO,4BAA4B;AAAA,EACzC,CAAC,EACA,SAAS,eAAe;AAAA,IACvB,MAAM,CAAC,UAAU,MAAM,EAAE,IAAI,CAAC,QAAQ,KAAK,KAAK,GAAG,CAAC;AAAA,IACpD,UAAU;AAAA,IACV,YAAY,CAAC,uBAAuB;AAAA,IACpC,GAAI,OAAO,yBAAyB;AAAA,EACtC,CAAC,EACA,gBAAgB,SAAS,EAAE,EAC3B,gBAAgB,QAAQ,EAAE,EAC1B,QAAQ,aAAa,OAAO,YAAY;AAEvC,UAAM,QAAQ,QAAQ,IAAI,QAAQ,GAAG;AACrC,YAAQ,OAAO,UAAU,KAAK,QAAQ,MAAM,QAAQ,IAAI,MAAM,GAAG,KAAK;AAAA,EACxE,CAAC,EACA,IAAI,KAAK,OAAO,SAAyB,UAAwB;AAChE,QAAI;AACF,YAAM,UAAU,MAAM,QAAQ,SAAS,KAAK;AAC5C,UACE,MAAM,UAAU,cAAc,MAAM,WACnC,OAAO,YAAY,YAAY,OAAO,SAAS,OAAO,IACvD;AACA,cAAM,KAAK,0BAA0B;AAAA,MACvC;AACA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ,IAAI,MAAM,KAAK;AACvB,YAAM;AAAA,IACR;AAAA,EACF,CAAC;AACL,CAAC;AAKH,eAAe,QAAQ,SAAyB,OAAqB;AACnE,MAAI;AAGJ,QAAM,UAAU,CAAC;AAGjB,QAAM,QAAQ,EAAE,SAAS,MAAM;AAE/B,MAAI;AAEF,eAAW,SAAS,eAAe,QAAQ,IAAI,GAAG;AAEhD,UAAI,SAAS,gBAAgB,KAAK;AAGlC,UAAI,WAAW,UAAa,CAAC,yBAAyB;AACpD;AAAA,MACF;AAGA,UAAI;AACF,YAAI,OAAO,WAAW,UAAU;AAI9B,mBAAS,gBAAgB,KAAK,IAAI,MAAM,OAAO,UAAU,MAAM;AAAA,QACjE,WAAW,WAAW,UAAa,yBAAyB;AAE1D,gBAAM,aAAa,KAAK,KAAK,QAAQ,GAAG,KAAK,KAAK;AAClD,cAAI,OAAO,YAAY,cAAc,QAAQ,MAAM,UAAU,GAAG;AAG9D,mBAAO,QAAQ,MAAM,UAAU;AAAA,UACjC;AAEA,gBAAM,SAAS,MAAM,KAAK,UAAU,GAAG,MAAM,QAAQ;AAGrD,mBAAS,MAAM,OAAO,UAAU,UAAU,IAAI,KAAK;AAAA,QACrD;AAAA,MACF,SAAS,GAAG;AACV,gBAAQ,EAAE,MAAM;AAAA,UACd,KAAK;AAAA,UACL,KAAK;AAAA,UACL,KAAK;AACH;AAAA,UACF;AAEE,kBAAM;AAAA,QACV;AAAA,MACF;AAGA,UAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC;AAAA,MACF;AAGA,cAAQ,QAAQ;AAEhB,iBACE,OAAO,OAAO,YAAY;AAAA;AAAA,QAEtB,MAAM,OAAO,QAAQ,KAAK,SAAS,KAAK;AAAA;AAAA;AAAA,QAExC,OAAO;AAAA;AAEb,UAAI,MAAM,MAAM;AACd;AAAA,MACF,WAAW,MAAM,SAAS,QAAQ,GAAG;AAGnC,YAAI,MAAM,eAAe,OAAO,CAAC,QAAQ,KAAK,SAAS,MAAM,GAAG;AAC9D,gBAAM,OAAO,GAAG;AAAA,QAClB;AACA;AAAA,MACF,WAAW,OAAO,aAAa,YAAY,OAAO,SAAS,QAAQ,KAAK,MAAM,QAAQ,GAAG;AACvF;AAAA,MACF,WACE,MAAM,SAAS,aAAa,MAC3B,aAAa,UAAa,OAAO,aAAa,WAC/C;AAEA,eAAO,OAAO,OAAO,QAAQ;AAC7B;AAAA,MACF,WAAW,MAAM,eAAe,KAAK;AACnC;AAAA,MACF,OAAO;AACL;AAAA,MACF;AAAA,IACF;AACA,WAAO,MAAM,UAAU,SAAS,QAAQ;AAAA,EAC1C,SAAS,OAAO;AACd,UAAM,eAAe,QAAQ,cAAc;AAC3C,QAAI,OAAO,iBAAiB,YAAY;AACtC,YAAM,OAAO,GAAG;AAChB,iBAAW,MAAM,aAAa,KAAK,SAAS,KAAK;AACjD,aAAO,MAAM,UAAU,SAAS,QAAQ;AAAA,IAC1C,OAAO;AACL,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAcA,SAAS,eAAe,MAAwB;AAC9C,QAAM,SAAS,CAAC;AAIhB,QAAM,WAAW,CAAC,EAAE;AACpB,MAAI,UAAU;AACd,aAAW,WAAW,KAAK,MAAM,GAAG,GAAG;AAErC,QAAI,YAAY,IAAI;AAClB,iBAAW,IAAI,OAAO;AACtB,eAAS,KAAK,OAAO;AAAA,IACvB;AAAA,EACF;AACA,WAAS,QAAQ;AAGjB,WAAS,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;AAC7C,WAAO,KAAK,GAAG,SAAS,CAAC,CAAC,aAAa;AAAA,EACzC;AAGA,QAAM,cAAc,SAAS,CAAC;AAC9B,QAAM,YAAY,YAAY,YAAY,GAAG,IAAI;AACjD,MAAI,YAAY,GAAG;AACjB,WAAO,KAAK,GAAG,YAAY,UAAU,GAAG,SAAS,CAAC,IAAI,YAAY,UAAU,SAAS,CAAC,GAAG;AAAA,EAC3F;AACA,SAAO,KAAK,GAAG,WAAW,UAAU;AAEpC,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,WAAO,KAAK,GAAG,SAAS,CAAC,CAAC,YAAY;AAAA,EACxC;AAEA,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,WAAO,KAAK,GAAG,SAAS,CAAC,CAAC,QAAQ;AAAA,EACpC;AAEA,SAAO;AACT;AAKA,SAAS,MAAM,KAAuB;AACpC,SAAO,CAAC,CAAC,OAAO,OAAO,QAAQ,YAAY,UAAU,OAAO,WAAW;AACzE;AAKA,eAAe,UAAU,SAAiB,UAAmB;AAC3D,QAAM,UAAU,MAAM,QAAQ,IAAI,MAAM,YAAY,KAAK,SAAS,QAAQ,IAAI;AAG9E,QAAM,kBAAkB,QAAQ,iBAAiB;AACjD,SAAO,OAAO,oBAAoB,aAC9B,MAAM,gBAAgB,KAAK,SAAS,OAAO,IAC3C;AACN;",
+  "sourcesContent": ["import fastifyCookie, { FastifyCookieOptions } from \"@fastify/cookie\";\nimport fastifyFormbody, { FastifyFormbodyOptions } from \"@fastify/formbody\";\nimport fastifyMultipart, { FastifyMultipartOptions } from \"@fastify/multipart\";\nimport fastifySend, { BaseSendResult, SendOptions } from \"@fastify/send\";\nimport fastify, {\n  FastifyInstance,\n  FastifyReply,\n  FastifyRequest,\n  FastifyServerOptions,\n} from \"fastify\";\nimport { jsxToString } from \"jsx-async-runtime\";\nimport { stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport env from \"./env.js\";\n\nenv();\n\nconst CWD = process.cwd();\nconst CONFIG = (await import(`file://${join(CWD, \"jeasx.config.js\")}`)).default;\nconst NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === \"development\";\n\n// Map routes and files for non-development environments from metadata export.\n// Module paths are initialized at startup but overwritten\n// with resolved modules upon the first request.\nconst { routes: MODULE_BY_ROUTE, files: FILE_BY_PATH } = NODE_ENV_IS_DEVELOPMENT\n  ? { routes: {}, files: {} }\n  : ((await import(`file://${join(CWD, \"dist\", \"[--metadata--].js\")}`)).default as {\n      routes: Record<string, string | { default: Function }>;\n      files: Record<string, string>;\n    });\n\ndeclare module \"fastify\" {\n  interface FastifyRequest {\n    /** Path without query parameters */\n    path: string;\n    /** Path to resolved route handler */\n    route: string;\n  }\n\n  interface FastifyReply {\n    /** Populated when serving a static file; otherwise undefined. */\n    file?: BaseSendResult;\n  }\n}\n\nconst FASTIFY_SEND_OPTIONS = {\n  ...(CONFIG.FASTIFY_SEND_OPTIONS?.() as SendOptions),\n};\n\n// Enhance Fastify server from userland\nconst FASTIFY_SERVER = (CONFIG.FASTIFY_SERVER ?? ((fastify) => fastify)) as (\n  fastify: FastifyInstance,\n) => FastifyInstance;\n\n// Create and export a Fastify instance\nexport default FASTIFY_SERVER(\n  fastify({\n    ...(CONFIG.FASTIFY_SERVER_OPTIONS?.() as FastifyServerOptions),\n  }),\n)\n  // Create encapsulation context\n  .register((fastify) => {\n    fastify\n      .register(fastifyCookie, {\n        ...(CONFIG.FASTIFY_COOKIE_OPTIONS?.() as FastifyCookieOptions),\n      })\n      .register(fastifyFormbody, {\n        ...(CONFIG.FASTIFY_FORMBODY_OPTIONS?.() as FastifyFormbodyOptions),\n      })\n      .register(fastifyMultipart, {\n        ...(CONFIG.FASTIFY_MULTIPART_OPTIONS?.() as FastifyMultipartOptions),\n      })\n      .decorateRequest(\"route\", \"\")\n      .decorateRequest(\"path\", \"\")\n      .decorateReply(\"file\", undefined)\n      .addHook(\"onRequest\", async (request) => {\n        // Extract path from url\n        const index = request.url.indexOf(\"?\");\n        request.path = index === -1 ? request.url : request.url.slice(0, index);\n      })\n      .all(\"*\", async (request: FastifyRequest, reply: FastifyReply) => {\n        try {\n          const payload = await handler(request, reply);\n          if (\n            reply.getHeader(\"content-type\") === undefined &&\n            (typeof payload === \"string\" || Buffer.isBuffer(payload))\n          ) {\n            reply.type(\"text/html; charset=utf-8\");\n          }\n          return payload;\n        } catch (error) {\n          request.log.error(error);\n          throw error;\n        }\n      });\n  });\n\n/**\n * Resolves route module based on the request path and execute it.\n */\nasync function handler(request: FastifyRequest, reply: FastifyReply) {\n  let response: unknown;\n\n  // Global context object for route handlers\n  const context: any = {};\n\n  // Default props for route handlers\n  const props = { request, reply };\n\n  try {\n    // Check for static file and store result for later processing.\n    reply.file = await tryFile(request);\n\n    // Execute route handlers for current request\n    for (const route of generateRoutes(request.path)) {\n      // Try to serve static file when route matches path.\n      if (route === request.path) {\n        if (reply.file) {\n          reply.status(reply.file.statusCode);\n          reply.headers(reply.file.headers);\n          response = reply.file.stream;\n          break;\n        }\n        continue;\n      }\n\n      // Resolve module or path to module\n      let module = MODULE_BY_ROUTE[route];\n\n      // Skip processing if the route path was not initialized.\n      if (module === undefined && !NODE_ENV_IS_DEVELOPMENT) {\n        continue;\n      }\n\n      // Module was not loaded yet?\n      try {\n        if (typeof module === \"string\") {\n          // Production: Load and cache module only via pre-calculated path.\n          // This avoids potential path traversal vulnerabilities caused\n          // by unexpected `route` values.\n          module = MODULE_BY_ROUTE[route] = await import(`file://${join(CWD, module)}`);\n        } else if (module === undefined && NODE_ENV_IS_DEVELOPMENT) {\n          // Only map module paths depending on `route` during development.\n          const modulePath = join(CWD, \"dist\", `${route}.js`);\n          if (typeof require === \"function\" && require.cache[modulePath]) {\n            // Bun: Remove module from cache before importing\n            // as query parameter for import is ignored.\n            delete require.cache[modulePath];\n          }\n          // Use timestamp as query parameter to update modules.\n          const mtime = (await stat(modulePath)).mtime.getTime();\n          // Dynamic imports are restricted to development environments;\n          // therefore, production-level path validation is not required here.\n          module = await import(`file://${modulePath}?${mtime}`);\n        }\n      } catch (e) {\n        switch ((e as any)?.code) {\n          case \"ENOENT\":\n          case \"ENOTDIR\":\n          case \"ERR_MODULE_NOT_FOUND\":\n            continue;\n          default:\n            // Module exists, but fails to load.\n            throw e;\n        }\n      }\n\n      // Store current route in request.\n      request.route = route;\n\n      // Ensure module is a valid object before processing.\n      if (module && typeof module === \"object\") {\n        response =\n          typeof module.default === \"function\"\n            ? // Call functions with context as `this` and props as parameters,\n              await module.default.call(context, props)\n            : // otherwise return default export.\n              module.default;\n      }\n\n      if (reply.sent) {\n        return;\n      } else if (route.endsWith(\"/[404]\")) {\n        // Preserve existing status if a 404 page is requested directly.\n        // If no status is defined, set status to 404 automatically.\n        if (reply.statusCode === 200 && !request.path.endsWith(\"/404\")) {\n          reply.status(404);\n        }\n        break;\n      } else if (\n        typeof response === \"string\" ||\n        response instanceof Readable ||\n        Buffer.isBuffer(response) ||\n        isJSX(response)\n      ) {\n        break;\n      } else if (route.endsWith(\"/[...guard]\") && typeof response === \"object\") {\n        // Add object entries from guard to props\n        Object.assign(props, response);\n        continue;\n      } else if (response === undefined || reply.statusCode === 404) {\n        continue;\n      } else {\n        break;\n      }\n    }\n\n    return await renderResponse(context, response);\n  } catch (error) {\n    const errorHandler = context[\"errorHandler\"];\n    if (typeof errorHandler === \"function\") {\n      reply.status(500);\n      response = await errorHandler.call(context, error);\n      return await renderResponse(context, response);\n    } else {\n      throw error;\n    }\n  }\n}\n\n/**\n * Generates all possible routes based on the given input path.\n *\n * Example routes for \"/a/b/c\":\n *\n * [\n *  \"/[...guard]\",\"/a/[...guard]\",\"/a/b/[...guard]\",\"/a/b/c/[...guard]\",\n *  \"/a/b/c\",\n *  \"/a/b/[c]\",\"/a/b/c/[index]\",\n *  \"/a/b/c/[...path]\",\"/a/b/[...path]\",\"/a/[...path]\",\"/[...path]\",\n *  \"/a/b/c/[404]\",\"/a/b/[404]\",\"/a/[404]\",\"/[404]\"\n * ]\n */\nfunction generateRoutes(path: string): string[] {\n  const routes = [];\n\n  // Transform given path into array of all its segments.\n  // \"/a/b/c\" => [\"\", \"/a\", \"/a/b/\", \"/a/b/c\"]\n  const segments = [\"\"];\n  let edgeSegment = \"\";\n  for (const segment of path.split(\"/\")) {\n    // Ignore redundant slashes.\n    if (segment !== \"\") {\n      edgeSegment += `/${segment}`;\n      segments.push(edgeSegment);\n    }\n  }\n\n  // [...guard]s are pushed from root to edge.\n  for (let i = 0; i < segments.length; i++) {\n    routes.push(`${segments[i]}/[...guard]`);\n  }\n\n  // Append the verbatim path for static file serving.\n  routes.push(path);\n\n  // \"/a/b/c\" => [\"/a/b/[c]\", \"/a/b/c/[index]\"]\n  const lastSlash = edgeSegment.lastIndexOf(\"/\") + 1;\n  if (lastSlash > 0) {\n    routes.push(`${edgeSegment.substring(0, lastSlash)}[${edgeSegment.substring(lastSlash)}]`);\n  }\n  routes.push(`${edgeSegment}/[index]`);\n\n  // [...path]s are pushed from edge to root.\n  for (let i = segments.length - 1; i >= 0; i--) {\n    routes.push(`${segments[i]}/[...path]`);\n  }\n\n  // [404]s are pushed from edge to root.\n  for (let i = segments.length - 1; i >= 0; i--) {\n    routes.push(`${segments[i]}/[404]`);\n  }\n\n  return routes;\n}\n\n/**\n * Determines if a given object is a JSX element.\n */\nfunction isJSX(obj: unknown): boolean {\n  return !!obj && typeof obj === \"object\" && \"type\" in obj && \"props\" in obj;\n}\n\n/**\n * Renders JSX to string and applies optional response handler.\n */\nasync function renderResponse(context: any, response: unknown) {\n  const payload = isJSX(response)\n    ? await jsxToString.call(context, response as JSX.Element)\n    : response;\n\n  // Post-process the payload with an optional response handler\n  const responseHandler = context[\"responseHandler\"];\n  return typeof responseHandler === \"function\"\n    ? await responseHandler.call(context, payload)\n    : payload;\n}\n\n/**\n * Returns stream and metadata for requested file.\n */\nasync function tryFile(request: FastifyRequest): Promise<BaseSendResult | undefined> {\n  // Production: Retrieve files only from pre-initialized mapping.\n  // This avoids potential path traversal vulnerabilities caused\n  // by unexpected `request.path` values.\n  const file = FILE_BY_PATH[request.path];\n  if (file) {\n    return await fastifySend(request.raw, file, FASTIFY_SEND_OPTIONS);\n  }\n\n  if (NODE_ENV_IS_DEVELOPMENT) {\n    for (const directory of [\"dist\", \"public\"]) {\n      try {\n        if ((await stat(join(CWD, directory, request.path))).isFile()) {\n          // Dynamic path loading is restricted to development environments;\n          // therefore, production-level path validation is not required here.\n          return await fastifySend(\n            request.raw,\n            `${directory}${request.path}`,\n            FASTIFY_SEND_OPTIONS,\n          );\n        }\n      } catch {\n        continue;\n      }\n    }\n  }\n\n  return undefined;\n}\n"],
+  "mappings": "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",
   "names": ["fastify"]
 }

package/serverless.ts

@@ -1,7 +1,7 @@
 import fastifyCookie, { FastifyCookieOptions } from "@fastify/cookie";
 import fastifyFormbody, { FastifyFormbodyOptions } from "@fastify/formbody";
 import fastifyMultipart, { FastifyMultipartOptions } from "@fastify/multipart";
-import fastifyStatic, { FastifyStaticOptions } from "@fastify/static";
+import fastifySend, { BaseSendResult, SendOptions } from "@fastify/send";
 import fastify, {
   FastifyInstance,
   FastifyReply,
@@ -11,6 +11,7 @@ import fastify, {
 import { jsxToString } from "jsx-async-runtime";
 import { stat } from "node:fs/promises";
 import { join } from "node:path";
+import { Readable } from "node:stream";
 import env from "./env.js";
 
 env();
@@ -19,28 +20,34 @@ const CWD = process.cwd();
 const CONFIG = (await import(`file://${join(CWD, "jeasx.config.js")}`)).default;
 const NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === "development";
 
-// Mapping for route modules used in non-development environments.
-const MODULE_BY_ROUTE: Record<string, { default: Function } | string> = {};
-
-// Initialize the mapping with absolute paths for all known modules.
-// Modules are lazily loaded on their first request for a specific route.
-if (!NODE_ENV_IS_DEVELOPMENT) {
-  const { routes } = (await import(`file://${join(CWD, "dist", "[--metadata--].js")}`)).default as {
-    routes: string[];
-  };
-  // Map route identifiers to their absolute file system paths in the build directory.
-  for (const route of routes) {
-    MODULE_BY_ROUTE[route] = join(CWD, "dist", `${route}.js`);
-  }
-}
+// Map routes and files for non-development environments from metadata export.
+// Module paths are initialized at startup but overwritten
+// with resolved modules upon the first request.
+const { routes: MODULE_BY_ROUTE, files: FILE_BY_PATH } = NODE_ENV_IS_DEVELOPMENT
+  ? { routes: {}, files: {} }
+  : ((await import(`file://${join(CWD, "dist", "[--metadata--].js")}`)).default as {
+      routes: Record<string, string | { default: Function }>;
+      files: Record<string, string>;
+    });
 
 declare module "fastify" {
   interface FastifyRequest {
-    path: string; // Path without query parameters
-    route: string; // Path to resolved route handler
+    /** Path without query parameters */
+    path: string;
+    /** Path to resolved route handler */
+    route: string;
+  }
+
+  interface FastifyReply {
+    /** Populated when serving a static file; otherwise undefined. */
+    file?: BaseSendResult;
   }
 }
 
+const FASTIFY_SEND_OPTIONS = {
+  ...(CONFIG.FASTIFY_SEND_OPTIONS?.() as SendOptions),
+};
+
 // Enhance Fastify server from userland
 const FASTIFY_SERVER = (CONFIG.FASTIFY_SERVER ?? ((fastify) => fastify)) as (
   fastify: FastifyInstance,
@@ -64,14 +71,9 @@ export default FASTIFY_SERVER(
       .register(fastifyMultipart, {
         ...(CONFIG.FASTIFY_MULTIPART_OPTIONS?.() as FastifyMultipartOptions),
       })
-      .register(fastifyStatic, {
-        root: ["public", "dist"].map((dir) => join(CWD, dir)),
-        wildcard: false,
-        globIgnore: ["/**/\\[*\\].js?(.map)"],
-        ...(CONFIG.FASTIFY_STATIC_OPTIONS?.() as FastifyStaticOptions),
-      })
       .decorateRequest("route", "")
       .decorateRequest("path", "")
+      .decorateReply("file", undefined)
       .addHook("onRequest", async (request) => {
         // Extract path from url
         const index = request.url.indexOf("?");
@@ -101,14 +103,28 @@ async function handler(request: FastifyRequest, reply: FastifyReply) {
   let response: unknown;
 
   // Global context object for route handlers
-  const context = {};
+  const context: any = {};
 
   // Default props for route handlers
   const props = { request, reply };
 
   try {
+    // Check for static file and store result for later processing.
+    reply.file = await tryFile(request);
+
     // Execute route handlers for current request
     for (const route of generateRoutes(request.path)) {
+      // Try to serve static file when route matches path.
+      if (route === request.path) {
+        if (reply.file) {
+          reply.status(reply.file.statusCode);
+          reply.headers(reply.file.headers);
+          response = reply.file.stream;
+          break;
+        }
+        continue;
+      }
+
       // Resolve module or path to module
       let module = MODULE_BY_ROUTE[route];
 
@@ -123,7 +139,7 @@ async function handler(request: FastifyRequest, reply: FastifyReply) {
           // Production: Load and cache module only via pre-calculated path.
           // This avoids potential path traversal vulnerabilities caused
           // by unexpected `route` values.
-          module = MODULE_BY_ROUTE[route] = await import(`file://${module}`);
+          module = MODULE_BY_ROUTE[route] = await import(`file://${join(CWD, module)}`);
         } else if (module === undefined && NODE_ENV_IS_DEVELOPMENT) {
           // Only map module paths depending on `route` during development.
           const modulePath = join(CWD, "dist", `${route}.js`);
@@ -139,7 +155,7 @@ async function handler(request: FastifyRequest, reply: FastifyReply) {
           module = await import(`file://${modulePath}?${mtime}`);
         }
       } catch (e) {
-        switch (e.code) {
+        switch ((e as any)?.code) {
           case "ENOENT":
           case "ENOTDIR":
           case "ERR_MODULE_NOT_FOUND":
@@ -150,20 +166,18 @@ async function handler(request: FastifyRequest, reply: FastifyReply) {
         }
       }
 
-      // Ensure module is a valid object before processing.
-      if (!module || typeof module !== "object") {
-        continue;
-      }
-
       // Store current route in request.
       request.route = route;
 
-      response =
-        typeof module.default === "function"
-          ? // Call functions with context as `this` and props as parameters,
-            await module.default.call(context, props)
-          : // otherwise return default export.
-            module.default;
+      // Ensure module is a valid object before processing.
+      if (module && typeof module === "object") {
+        response =
+          typeof module.default === "function"
+            ? // Call functions with context as `this` and props as parameters,
+              await module.default.call(context, props)
+            : // otherwise return default export.
+              module.default;
+      }
 
       if (reply.sent) {
         return;
@@ -174,28 +188,31 @@ async function handler(request: FastifyRequest, reply: FastifyReply) {
           reply.status(404);
         }
         break;
-      } else if (typeof response === "string" || Buffer.isBuffer(response) || isJSX(response)) {
-        break;
       } else if (
-        route.endsWith("/[...guard]") &&
-        (response === undefined || typeof response === "object")
+        typeof response === "string" ||
+        response instanceof Readable ||
+        Buffer.isBuffer(response) ||
+        isJSX(response)
       ) {
+        break;
+      } else if (route.endsWith("/[...guard]") && typeof response === "object") {
         // Add object entries from guard to props
         Object.assign(props, response);
         continue;
-      } else if (reply.statusCode === 404) {
+      } else if (response === undefined || reply.statusCode === 404) {
         continue;
       } else {
         break;
       }
     }
-    return await renderJSX(context, response);
+
+    return await renderResponse(context, response);
   } catch (error) {
     const errorHandler = context["errorHandler"];
     if (typeof errorHandler === "function") {
       reply.status(500);
       response = await errorHandler.call(context, error);
-      return await renderJSX(context, response);
+      return await renderResponse(context, response);
     } else {
       throw error;
     }
@@ -209,6 +226,7 @@ async function handler(request: FastifyRequest, reply: FastifyReply) {
  *
  * [
  *  "/[...guard]","/a/[...guard]","/a/b/[...guard]","/a/b/c/[...guard]",
+ *  "/a/b/c",
  *  "/a/b/[c]","/a/b/c/[index]",
  *  "/a/b/c/[...path]","/a/b/[...path]","/a/[...path]","/[...path]",
  *  "/a/b/c/[404]","/a/b/[404]","/a/[404]","/[404]"
@@ -218,36 +236,39 @@ function generateRoutes(path: string): string[] {
   const routes = [];
 
   // Transform given path into array of all its segments.
-  // "/a/b/c" => ["/a/b/c", "/a/b", "/a", ""]
+  // "/a/b/c" => ["", "/a", "/a/b/", "/a/b/c"]
   const segments = [""];
-  let current = "";
+  let edgeSegment = "";
   for (const segment of path.split("/")) {
     // Ignore redundant slashes.
     if (segment !== "") {
-      current += `/${segment}`;
-      segments.push(current);
+      edgeSegment += `/${segment}`;
+      segments.push(edgeSegment);
     }
   }
-  segments.reverse();
 
-  // [...guard]s are evaluated from top to bottom
-  for (let i = segments.length - 1; i >= 0; i--) {
+  // [...guard]s are pushed from root to edge.
+  for (let i = 0; i < segments.length; i++) {
     routes.push(`${segments[i]}/[...guard]`);
   }
 
+  // Append the verbatim path for static file serving.
+  routes.push(path);
+
   // "/a/b/c" => ["/a/b/[c]", "/a/b/c/[index]"]
-  const edgeSegment = segments[0];
   const lastSlash = edgeSegment.lastIndexOf("/") + 1;
   if (lastSlash > 0) {
     routes.push(`${edgeSegment.substring(0, lastSlash)}[${edgeSegment.substring(lastSlash)}]`);
   }
   routes.push(`${edgeSegment}/[index]`);
 
-  for (let i = 0; i < segments.length; i++) {
+  // [...path]s are pushed from edge to root.
+  for (let i = segments.length - 1; i >= 0; i--) {
     routes.push(`${segments[i]}/[...path]`);
   }
 
-  for (let i = 0; i < segments.length; i++) {
+  // [404]s are pushed from edge to root.
+  for (let i = segments.length - 1; i >= 0; i--) {
     routes.push(`${segments[i]}/[404]`);
   }
 
@@ -264,8 +285,10 @@ function isJSX(obj: unknown): boolean {
 /**
  * Renders JSX to string and applies optional response handler.
  */
-async function renderJSX(context: object, response: unknown) {
-  const payload = isJSX(response) ? await jsxToString.call(context, response) : response;
+async function renderResponse(context: any, response: unknown) {
+  const payload = isJSX(response)
+    ? await jsxToString.call(context, response as JSX.Element)
+    : response;
 
   // Post-process the payload with an optional response handler
   const responseHandler = context["responseHandler"];
@@ -273,3 +296,36 @@ async function renderJSX(context: object, response: unknown) {
     ? await responseHandler.call(context, payload)
     : payload;
 }
+
+/**
+ * Returns stream and metadata for requested file.
+ */
+async function tryFile(request: FastifyRequest): Promise<BaseSendResult | undefined> {
+  // Production: Retrieve files only from pre-initialized mapping.
+  // This avoids potential path traversal vulnerabilities caused
+  // by unexpected `request.path` values.
+  const file = FILE_BY_PATH[request.path];
+  if (file) {
+    return await fastifySend(request.raw, file, FASTIFY_SEND_OPTIONS);
+  }
+
+  if (NODE_ENV_IS_DEVELOPMENT) {
+    for (const directory of ["dist", "public"]) {
+      try {
+        if ((await stat(join(CWD, directory, request.path))).isFile()) {
+          // Dynamic path loading is restricted to development environments;
+          // therefore, production-level path validation is not required here.
+          return await fastifySend(
+            request.raw,
+            `${directory}${request.path}`,
+            FASTIFY_SEND_OPTIONS,
+          );
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+
+  return undefined;
+}