jeasx 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # Changelog
 
+## 2025-12-01 - Jeasx 2.2.0 released
+
+🎉 This release introduces a more flexible configuration approach for the underlying Fastify server. You can now customize all Fastify options (including those for all used plugins) according to your needs, without having to use the formerly fixed and very restrictive set of environment variables. This change was made to eliminate the need for increasingly specific environment variables to customise the default behaviour of Jeasx.
+
+**Breaking change**: The previously supported environment variables (~~`FASTIFY_​BODY_​LIMIT, FASTIFY_​DISABLE_​REQUEST_​LOGGING, FASTIFY_​REWRITE_​URL, FASTIFY_​STATIC_​HEADERS, FASTIFY_​TRUST_​PROXY, FASTIFY_​MULTIPART_​ATTACH_​FIELDS_​TO_​BODY`~~) have been completely removed. While this may seem inconvenient for a minor release, the process of migrating your setup to the new configuration approach usually takes less than a minute. This streamlines the code base and documentation, as these features are presumably seldom used.
+
+To configure Fastify (or a specific plugin), you can now use simple JSON objects which mirror the corresponding Fastify options. Have a look at the linked Fastify documentation for a reference of all existing options:
+
+- [`FASTIFY_SERVER_OPTIONS`](<https://fastify.dev/docs/latest/Reference/Server/>)
+- [`FASTIFY_COOKIE_OPTIONS`](<https://github.com/fastify/fastify-cookie#options>)
+- [`FASTIFY_FORMBODY_OPTIONS`](<https://github.com/fastify/fastify-formbody#options>)
+- [`FASTIFY_MULTIPART_OPTIONS`](<https://github.com/fastify/fastify-multipart#options>)
+- [`FASTIFY_STATIC_OPTIONS`](<https://github.com/fastify/fastify-static#options>)
+
+To optimise the developer experience, it is highly recommended that you use the recently introduced `.env.js` file to provide these configuration options. Alternatively, you can also provide them via `.env` or your process environment. Jeasx comes with a minimal set of reasonable [Fastify defaults](https://github.com/jeasx/jeasx/blob/main/serverless.ts), but you can also overwrite them if necessary.
+
+Some Fastify options, such as `rewriteUrl` or `setHeaders`, take a function as a parameter. Jeasx supports this use case by deserialising the stringified function code when the server starts up.
+
+### Example configuration
+
+```js
+const NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === "development";
+
+export default {
+  /** @type import("fastify").FastifyServerOptions */
+  FASTIFY_SERVER_OPTIONS: {
+    disableRequestLogging: NODE_ENV_IS_DEVELOPMENT,
+    bodyLimit: 2 * 1024 * 1024,
+    rewriteUrl: (req) => String(req.url).replace(/^\/jeasx/, ""),
+  },
+
+  /** @type import("@fastify/static").FastifyStaticOptions */
+  FASTIFY_STATIC_OPTIONS: {
+    maxAge: NODE_ENV_IS_DEVELOPMENT ? 0 : "365d",
+  },
+
+  /** @type import("@fastify/cookie").FastifyCookieOptions */
+  // FASTIFY_COOKIE_OPTIONS: {},
+
+  /** @type import("@fastify/formbody").FastifyFormbodyOptions */
+  // FASTIFY_FORMBODY_OPTIONS: {},
+
+  /** @type import("@fastify/multipart").FastifyMultipartOptions */
+  // FASTIFY_MULTIPART_OPTIONS: {},
+};
+```
+
+Another improvement has been made by introducing an automatic approach to determine the maximum size of the internal route cache. Depending on the amount of free memory available at startup, the maximum number of cache entries is calculated. This approach strikes a balance, ensuring the cache is large enough for large-scale projects while keeping maximum memory consumption within reasonable limits given the available resources. This means that you no longer need to worry about providing ~~`JEASX_ROUTE_CACHE_LIMIT`~~ via the environment.
+
+Dependency updates: `@types/node@24.10.1`
+
+## 2025-11-10 - Jeasx 2.1.1 released
+
+🎉 Enhanced configuration for @fastify/static, so you can serve pre-compressed static files (see <https://github.com/fastify/fastify-static?tab=readme-ov-file#precompressed>) from `public` and `dist/browser`. Just run `gzip -rk public dist/browser` as post build for gzipping your static assets. This might be useful if you don't want to run a reverse proxy in front of your Jeasx application and serve compressed files nevertheless. Setting up compression for dynamic content can be wired up in userland via a root guard:
+
+```js
+import { promisify } from "node:util";
+import { gzip } from "node:zlib";
+
+export default function ({ request, reply }) {
+  this.responseHandler = (payload) => {
+    if (
+      typeof payload === "string" &&
+      request.headers["accept-encoding"]?.includes("gzip")
+    ) {
+      reply.header("content-encoding", "gzip");
+      return promisify(gzip)(payload);
+    } else {
+      return payload;
+    }
+  };
+}
+```
+
+Updated `moduleResolution` to `bundler` in `tsconfig.json`.
+
+Dependency updates: `jsx-async-runtime@2.0.1`, `fastify@5.6.2`, `esbuild@0.27.0`, `@types/node@24.9.2`
+
 ## 2025-10-28 - Jeasx 2.1.0 released
 
 🎉 Environment vars can now be loaded from a JavaScript file (`.env.js`) additionally to existing .env-files. This allows enhanced environment setups depending on your workflows.

package/env.js

@@ -30,23 +30,29 @@ export default async function env() {
   }
   try {
     const envFile = `file://${join(process.cwd(), ".env.js")}`;
-    const envObject = (await import(envFile)).default;
-    Object.entries(envObject).forEach(([key, value]) => {
-      if (!(key in process.env)) {
-        switch (typeof value) {
-          case "string":
-            process.env[key] = value;
-            break;
-          case "function":
-            process.env[key] = value.toString();
-            break;
-          default:
-            process.env[key] = JSON.stringify(value);
-            break;
-        }
-      }
-    });
+    const envObject = stringifyFunctions((await import(envFile)).default);
+    Object.entries(envObject)
+      .filter(([key]) => !(key in process.env))
+      .forEach(([key, value]) => {
+        process.env[key] =
+          typeof value === "string" ? value : JSON.stringify(value);
+      });
   } catch (e) {
     // ERR_MODULE_NOT_FOUND
   }
 }
+
+/**
+ * Convert all functions recursively to strings.
+ */
+function stringifyFunctions(obj) {
+  for (const key in obj) {
+    if (typeof obj[key] === "function") {
+      obj[key] = obj[key].toString();
+    }
+    if (typeof obj[key] === "object" && obj[key] !== null) {
+      stringifyFunctions(obj[key]);
+    }
+  }
+  return obj;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jeasx",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Jeasx - the ease of JSX with the power of SSR",
   "keywords": [
     "jsx",
@@ -28,10 +28,10 @@
     "@fastify/formbody": "8.0.2",
     "@fastify/multipart": "9.3.0",
     "@fastify/static": "8.3.0",
-    "@types/node": "24.9.1",
-    "esbuild": "0.25.11",
-    "fastify": "5.6.1",
-    "jsx-async-runtime": "2.0.0"
+    "@types/node": "24.10.1",
+    "esbuild": "0.27.0",
+    "fastify": "5.6.2",
+    "jsx-async-runtime": "2.0.1"
   },
   "scripts": {
     "build": "esbuild --platform=node --format=esm --sourcemap=linked --sources-content=false --outdir=. serverless.ts"

package/serverless.js

@@ -5,41 +5,39 @@ import fastifyStatic from "@fastify/static";
 import Fastify from "fastify";
 import { jsxToString } from "jsx-async-runtime";
 import { stat } from "node:fs/promises";
+import { freemem } from "node:os";
 import { join } from "node:path";
 import env from "./env.js";
 await env();
-const NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === "development";
 const CWD = process.cwd();
-const FASTIFY_STATIC_HEADERS = process.env.FASTIFY_STATIC_HEADERS && JSON.parse(process.env.FASTIFY_STATIC_HEADERS);
-const JEASX_ROUTE_CACHE_LIMIT = process.env.JEASX_ROUTE_CACHE_LIMIT && JSON.parse(process.env.JEASX_ROUTE_CACHE_LIMIT);
+const NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === "development";
+const JEASX_ROUTE_CACHE_LIMIT = Math.floor(freemem() / 1024 / 1024);
 var serverless_default = Fastify({
   logger: true,
-  disableRequestLogging: JSON.parse(
-    process.env.FASTIFY_DISABLE_REQUEST_LOGGING || "false"
-  ),
-  bodyLimit: Number(process.env.FASTIFY_BODY_LIMIT) || void 0,
-  trustProxy: JSON.parse(process.env.FASTIFY_TRUST_PROXY || "false"),
-  rewriteUrl: process.env.FASTIFY_REWRITE_URL && new Function(`return ${process.env.FASTIFY_REWRITE_URL}`)()
-}).register(fastifyCookie).register(fastifyFormbody).register(fastifyMultipart, {
-  attachFieldsToBody: JSON.parse(
-    process.env.FASTIFY_MULTIPART_ATTACH_FIELDS_TO_BODY || '"keyValues"'
+  ...jsonToOptions(
+    process.env.FASTIFY_SERVER_OPTIONS
+  )
+}).register(fastifyCookie, {
+  ...jsonToOptions(
+    process.env.FASTIFY_COOKIE_OPTIONS
+  )
+}).register(fastifyFormbody, {
+  ...jsonToOptions(
+    process.env.FASTIFY_FORMBODY_OPTIONS
+  )
+}).register(fastifyMultipart, {
+  attachFieldsToBody: "keyValues",
+  ...jsonToOptions(
+    process.env.FASTIFY_MULTIPART_OPTIONS
   )
 }).register(fastifyStatic, {
   root: ["public", "dist/browser"].map((dir) => join(CWD, dir)),
   prefix: "/",
   wildcard: false,
-  cacheControl: false,
-  setHeaders: FASTIFY_STATIC_HEADERS ? (reply, path) => {
-    for (const [suffix, headers] of Object.entries(
-      FASTIFY_STATIC_HEADERS
-    )) {
-      if (path.endsWith(suffix)) {
-        for (const [key, value] of Object.entries(headers)) {
-          reply.setHeader(key, value);
-        }
-      }
-    }
-  } : void 0
+  preCompressed: true,
+  ...jsonToOptions(
+    process.env.FASTIFY_STATIC_OPTIONS
+  )
 }).decorateRequest("route", "").decorateRequest("path", "").addHook("onRequest", async (request, reply) => {
   reply.header("Content-Type", "text/html; charset=utf-8");
   const index = request.url.indexOf("?");
@@ -52,6 +50,19 @@ var serverless_default = Fastify({
     throw error;
   }
 });
+function jsonToOptions(json) {
+  const options = JSON.parse(json || "{}");
+  for (const key in options) {
+    if (typeof options[key] === "string" && options[key].includes("=>")) {
+      try {
+        options[key] = new Function(`return ${options[key]}`)();
+      } catch (error) {
+        console.warn("\u26A0\uFE0F", error);
+      }
+    }
+  }
+  return options;
+}
 const modules = /* @__PURE__ */ new Map();
 async function handler(request, reply) {
   let response;
@@ -85,7 +96,7 @@ async function handler(request, reply) {
           }
           continue;
         } finally {
-          if (typeof JEASX_ROUTE_CACHE_LIMIT === "number" && modules.size > JEASX_ROUTE_CACHE_LIMIT) {
+          if (modules.size > JEASX_ROUTE_CACHE_LIMIT) {
             modules.delete(modules.keys().next().value);
           }
         }

package/serverless.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["serverless.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/serverless.ts

@@ -1,25 +1,23 @@
-import fastifyCookie from "@fastify/cookie";
-import fastifyFormbody from "@fastify/formbody";
-import fastifyMultipart from "@fastify/multipart";
-import fastifyStatic from "@fastify/static";
-import Fastify, { FastifyReply, FastifyRequest } from "fastify";
+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 Fastify, {
+  FastifyReply,
+  FastifyRequest,
+  FastifyServerOptions,
+} from "fastify";
 import { jsxToString } from "jsx-async-runtime";
 import { stat } from "node:fs/promises";
+import { freemem } from "node:os";
 import { join } from "node:path";
 import env from "./env.js";
 
 await env();
 
-const NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === "development";
 const CWD = process.cwd();
-
-const FASTIFY_STATIC_HEADERS =
-  process.env.FASTIFY_STATIC_HEADERS &&
-  JSON.parse(process.env.FASTIFY_STATIC_HEADERS);
-
-const JEASX_ROUTE_CACHE_LIMIT =
-  process.env.JEASX_ROUTE_CACHE_LIMIT &&
-  JSON.parse(process.env.JEASX_ROUTE_CACHE_LIMIT);
+const NODE_ENV_IS_DEVELOPMENT = process.env.NODE_ENV === "development";
+const JEASX_ROUTE_CACHE_LIMIT = Math.floor(freemem() / 1024 / 1024);
 
 declare module "fastify" {
   interface FastifyRequest {
@@ -31,40 +29,34 @@ declare module "fastify" {
 // Create and export a Fastify app instance
 export default Fastify({
   logger: true,
-  disableRequestLogging: JSON.parse(
-    process.env.FASTIFY_DISABLE_REQUEST_LOGGING || "false"
-  ),
-  bodyLimit: Number(process.env.FASTIFY_BODY_LIMIT) || undefined,
-  trustProxy: JSON.parse(process.env.FASTIFY_TRUST_PROXY || "false"),
-  rewriteUrl:
-    process.env.FASTIFY_REWRITE_URL &&
-    new Function(`return ${process.env.FASTIFY_REWRITE_URL}`)(),
+  ...(jsonToOptions(
+    process.env.FASTIFY_SERVER_OPTIONS
+  ) as FastifyServerOptions),
 })
-  .register(fastifyCookie)
-  .register(fastifyFormbody)
+  .register(fastifyCookie, {
+    ...(jsonToOptions(
+      process.env.FASTIFY_COOKIE_OPTIONS
+    ) as FastifyCookieOptions),
+  })
+  .register(fastifyFormbody, {
+    ...(jsonToOptions(
+      process.env.FASTIFY_FORMBODY_OPTIONS
+    ) as FastifyFormbodyOptions),
+  })
   .register(fastifyMultipart, {
-    attachFieldsToBody: JSON.parse(
-      process.env.FASTIFY_MULTIPART_ATTACH_FIELDS_TO_BODY || '"keyValues"'
-    ),
+    attachFieldsToBody: "keyValues",
+    ...(jsonToOptions(
+      process.env.FASTIFY_MULTIPART_OPTIONS
+    ) as FastifyMultipartOptions),
   })
   .register(fastifyStatic, {
     root: ["public", "dist/browser"].map((dir) => join(CWD, dir)),
     prefix: "/",
     wildcard: false,
-    cacheControl: false,
-    setHeaders: FASTIFY_STATIC_HEADERS
-      ? (reply, path) => {
-          for (const [suffix, headers] of Object.entries(
-            FASTIFY_STATIC_HEADERS
-          )) {
-            if (path.endsWith(suffix)) {
-              for (const [key, value] of Object.entries(headers)) {
-                reply.setHeader(key, value);
-              }
-            }
-          }
-        }
-      : undefined,
+    preCompressed: true,
+    ...(jsonToOptions(
+      process.env.FASTIFY_STATIC_OPTIONS
+    ) as FastifyStaticOptions),
   })
   .decorateRequest("route", "")
   .decorateRequest("path", "")
@@ -84,6 +76,23 @@ export default Fastify({
     }
   });
 
+/**
+ * Parses JSON and instantiates all stringified functions.
+ */
+function jsonToOptions(json: string) {
+  const options = JSON.parse(json || "{}");
+  for (const key in options) {
+    if (typeof options[key] === "string" && options[key].includes("=>")) {
+      try {
+        options[key] = new Function(`return ${options[key]}`)();
+      } catch (error) {
+        console.warn("⚠️", error);
+      }
+    }
+  }
+  return options;
+}
+
 // Cache for resolved route modules, 'null' means no module exists.
 const modules = new Map<string, { default: Function }>();
 
@@ -137,10 +146,7 @@ async function handler(request: FastifyRequest, reply: FastifyReply) {
           continue;
         } finally {
           // Remove oldest entry from cache if limit is reached
-          if (
-            typeof JEASX_ROUTE_CACHE_LIMIT === "number" &&
-            modules.size > JEASX_ROUTE_CACHE_LIMIT
-          ) {
+          if (modules.size > JEASX_ROUTE_CACHE_LIMIT) {
             modules.delete(modules.keys().next().value);
           }
         }

package/tsconfig.json

@@ -1,8 +1,8 @@
 {
   "compilerOptions": {
-    "module": "ESNext",
-    "moduleResolution": "Node",
-    "target": "ESNext",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "target": "esnext",
     "outDir": "../../dist",
     "allowJs": true,
     "checkJs": true,