dinou 5.1.1 → 5.2.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [5.2.0] - 2026-07-13
+
+### Added
+- **Lightweight Plugin System & `dinou.config.js` support**: Added native support for extending the framework without manually modifying the core Express server.
+  * **Config Loader**: Automatically loads a `dinou.config.js` file at the root of the project to initialize custom plugins.
+  * **`onServerInit(app)` Hook**: Allows plugins to register global Express middlewares, custom endpoints (like webhooks), or API routes.
+  * **`onRequestContext(req, res, context)` Hook**: Allows plugins to inject custom properties (like `locale` or `userId`) into the RSC context across standard page requests, Server Actions, and dynamic compilation child processes.
+  * **Try-Catch Isolation**: Wrapped plugin hooks in safe boundaries with named logging to prevent third-party plugin errors from crashing the server.
+
+### Fixed
+- **URL resolution for search params**: Fixed `useSearchParams` and `usePathname` to work correctly with URL hashes.
+- **Server Actions with FormData**: Fixed server actions to correctly handle FormData arguments, supporting formData in any position in the args list.
+
+## [5.1.2] - 2026-07-12
+
+### Fixed
+- **Client Link Import Resolution**: Fixed `TypeError: Failed to resolve module specifier 'dinou/core/link.jsx'` client-side crashes occurring when importing and rendering `<Link>` from `"dinou"` inside Server Components under Esbuild and Rollup compilation environments.
+
 ## [5.1.1] - 2026-07-12
 
 ### Fixed

package/dinou/core/navigation.js

@@ -126,7 +126,7 @@ export function usePathname() {
     return "";
   }
 
-  const path = fullRoute.split("?")[0];
+  const path = fullRoute.split("#")[0].split("?")[0];
   return normalizePath(path);
 }
 
@@ -165,6 +165,6 @@ export function useSearchParams() {
 
   if (typeof fullRoute !== "string") return new URLSearchParams();
 
-  const searchPart = fullRoute.split("?")[1] || "";
+  const searchPart = (fullRoute.split("?")[1] || "").split("#")[0];
   return new URLSearchParams(searchPart);
 }

package/dinou/core/server-function-proxy-webpack.js

@@ -22,13 +22,17 @@ function createServerFunctionProxy(id) {
         "x-server-function-call": "1",
       };
 
-      if (args[0] instanceof FormData) {
-        const formData = args[0];
+      const formDataIndex = args.findIndex((arg) => arg instanceof FormData);
+
+      if (formDataIndex !== -1) {
+        const formData = args[formDataIndex];
 
         formData.append("__dinou_func_id", id);
+        formData.append("__dinou_formData_index", String(formDataIndex));
 
         if (args.length > 1) {
-          formData.append("__dinou_args", JSON.stringify(args.slice(1)));
+          const serializedArgs = args.map((arg, i) => (i === formDataIndex ? null : arg));
+          formData.append("__dinou_args", JSON.stringify(serializedArgs));
         }
 
         body = formData;

package/dinou/core/server-function-proxy.js

@@ -23,13 +23,17 @@ export function createServerFunctionProxy(id) {
         "x-server-function-call": "1",
       };
 
-      if (args[0] instanceof FormData) {
-        const formData = args[0];
+      const formDataIndex = args.findIndex((arg) => arg instanceof FormData);
+
+      if (formDataIndex !== -1) {
+        const formData = args[formDataIndex];
 
         formData.append("__dinou_func_id", id);
+        formData.append("__dinou_formData_index", String(formDataIndex));
 
         if (args.length > 1) {
-          formData.append("__dinou_args", JSON.stringify(args.slice(1)));
+          const serializedArgs = args.map((arg, i) => (i === formDataIndex ? null : arg));
+          formData.append("__dinou_args", JSON.stringify(serializedArgs));
         }
 
         body = formData;

package/dinou/core/server.js

@@ -72,6 +72,18 @@ addHook({
 });
 const importModule = require("./import-module");
 const generateStatic = require("./generate-static.js");
+
+// Load Dinou configuration and plugins
+let dinouConfig = { plugins: [] };
+const dinouConfigPath = path.resolve(process.cwd(), "dinou.config.js");
+if (existsSync(dinouConfigPath)) {
+  try {
+    dinouConfig = require(dinouConfigPath);
+  } catch (err) {
+    console.error("[Dinou] Error loading dinou.config.js:", err);
+  }
+}
+
 const renderAppToHtml = require("./render-app-to-html.js");
 const { revalidating, regenerating } = require("./revalidating.js");
 const isDevelopment = process.env.NODE_ENV !== "production";
@@ -283,6 +295,21 @@ const cookieParser = require("cookie-parser");
 const appUseCookieParser = cookieParser();
 const app = express();
 app.use(appUseCookieParser);
+
+// Run plugins onServerInit hook
+if (dinouConfig.plugins && Array.isArray(dinouConfig.plugins)) {
+  for (const plugin of dinouConfig.plugins) {
+    if (typeof plugin.onServerInit === "function") {
+      try {
+        plugin.onServerInit(app);
+        console.log(`[Dinou] Plugin initialized: "${plugin.name || "unnamed"}"`);
+      } catch (err) {
+        console.error(`[Dinou] Error initializing plugin "${plugin.name || "unnamed"}":`, err);
+      }
+    }
+  }
+}
+
 app.use(express.json());
 
 // ============================================================
@@ -406,6 +433,20 @@ function getContext(req, res) {
       redirect: (...args) => safeResCall("redirect", ...args),
     },
   };
+
+  // Run plugins onRequestContext hook
+  if (dinouConfig.plugins && Array.isArray(dinouConfig.plugins)) {
+    for (const plugin of dinouConfig.plugins) {
+      if (typeof plugin.onRequestContext === "function") {
+        try {
+          plugin.onRequestContext(req, res, context);
+        } catch (err) {
+          console.error(`[Dinou] Error running onRequestContext in plugin "${plugin.name || "unnamed"}":`, err);
+        }
+      }
+    }
+  }
+
   return context;
 }
 
@@ -534,6 +575,20 @@ function getContextForServerFunctionEndpoint(req, res) {
       },
     },
   };
+
+  // Run plugins onRequestContext hook
+  if (dinouConfig.plugins && Array.isArray(dinouConfig.plugins)) {
+    for (const plugin of dinouConfig.plugins) {
+      if (typeof plugin.onRequestContext === "function") {
+        try {
+          plugin.onRequestContext(req, res, context);
+        } catch (err) {
+          console.error(`[Dinou] Error running onRequestContext in plugin "${plugin.name || "unnamed"}":`, err);
+        }
+      }
+    }
+  }
+
   return context;
 }
 
@@ -1084,6 +1139,20 @@ app.get(/^\/.*\/?$/, async (req, res) => {
       },
       // Do not include res here
     };
+
+    // Run plugins onRequestContext hook
+    if (dinouConfig.plugins && Array.isArray(dinouConfig.plugins)) {
+      for (const plugin of dinouConfig.plugins) {
+        if (typeof plugin.onRequestContext === "function") {
+          try {
+            plugin.onRequestContext(req, res, contextForChild);
+          } catch (err) {
+            console.error(`[Dinou] Error running onRequestContext in plugin "${plugin.name || "unnamed"}":`, err);
+          }
+        }
+      }
+    }
+
     processLimiter
       .run(async () => {
         const isDynamic = true;
@@ -1211,7 +1280,12 @@ app.post("/____server_function____", async (req, res) => {
       const formData = new FormData();
 
       for (const key in req.body) {
-        if (key === "__dinou_func_id" || key === "__dinou_args") continue;
+        if (
+          key === "__dinou_func_id" ||
+          key === "__dinou_args" ||
+          key === "__dinou_formData_index"
+        )
+          continue;
         formData.append(key, req.body[key]);
       }
 
@@ -1222,15 +1296,22 @@ app.post("/____server_function____", async (req, res) => {
         }
       }
 
-      args = [formData];
-
       if (req.body.__dinou_args) {
         try {
-          const extraArgs = JSON.parse(req.body.__dinou_args);
-          args.push(...extraArgs);
+          const parsedArgs = JSON.parse(req.body.__dinou_args);
+          if (req.body.__dinou_formData_index !== undefined) {
+            const formDataIndex = parseInt(req.body.__dinou_formData_index, 10);
+            parsedArgs[formDataIndex] = formData;
+            args = parsedArgs;
+          } else {
+            args = [formData, ...parsedArgs];
+          }
         } catch (e) {
-          console.error("Error parsing extra args in multipart request");
+          console.error("Error parsing extra args in multipart request", e);
+          args = [formData];
         }
+      } else {
+        args = [formData];
       }
     } else {
       id = req.body.id;

package/dinou/esbuild/build.mjs

@@ -18,6 +18,10 @@ const absPathToClientRedirect = path.resolve(
   __dirname,
   "../core/client-redirect.jsx"
 );
+const absPathToLink = path.resolve(
+  __dirname,
+  "../core/link.jsx"
+);
 
 const frameworkEntryPoints = {
   main: path.resolve(__dirname, "../core/client.jsx"),
@@ -32,6 +36,7 @@ const frameworkEntryPoints = {
     "react-refresh/react-refresh-entry.js"
   ),
   dinouClientRedirect: absPathToClientRedirect,
+  dinouLink: absPathToLink,
 };
 
 try {
@@ -46,6 +51,12 @@ try {
     true,
     manifest
   );
+  updateManifestForModule(
+    absPathToLink,
+    await fs.readFile(absPathToLink, "utf8"),
+    true,
+    manifest
+  );
 
   const componentEntryPoints = [...esbuildEntries].reduce(
     (acc, dCE) => ({ ...acc, [dCE.outfileName]: dCE.absPath }),

package/dinou/esbuild/dev.mjs

@@ -26,6 +26,10 @@ const absPathToClientRedirect = path.resolve(
   __dirname,
   "../core/client-redirect.jsx"
 );
+const absPathToLink = path.resolve(
+  __dirname,
+  "../core/link.jsx"
+);
 
 const frameworkEntryPoints = {
   main: path.resolve(__dirname, "../core/client.jsx"),
@@ -40,6 +44,7 @@ const frameworkEntryPoints = {
     "react-refresh/react-refresh-entry.js"
   ),
   dinouClientRedirect: absPathToClientRedirect,
+  dinouLink: absPathToLink,
 };
 
 const changedIds = new Set();
@@ -70,6 +75,12 @@ async function updateEntriesAndComponents() {
     true,
     manifest
   );
+  updateManifestForModule(
+    absPathToLink,
+    await fs.readFile(absPathToLink, "utf8"),
+    true,
+    manifest
+  );
 
   currentServerFiles = new Set(
     serverFiles.map((f) => normalizePath(path.resolve(f)))

package/dinou/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dinou-ejected",
-  "version": "5.1.1",
+  "version": "5.2.0",
   "main": "index.js",
   "private": true,
   "exports": {

package/dinou/rollup/rollup.config.js

@@ -52,6 +52,10 @@ module.exports = async function () {
           __dirname,
           "../core/client-redirect.jsx",
         ),
+        dinouLink: path.resolve(
+          __dirname,
+          "../core/link.jsx",
+        ),
       }
       : {
         main: path.resolve(__dirname, "../core/client.jsx"),
@@ -64,6 +68,10 @@ module.exports = async function () {
           __dirname,
           "../core/client-redirect.jsx",
         ),
+        dinouLink: path.resolve(
+          __dirname,
+          "../core/link.jsx",
+        ),
       },
     output: {
       dir: outputDirectory,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dinou",
-  "version": "5.1.1",
+  "version": "5.2.0",
   "description": "Lightweight-Ejectable Full-Stack React 19 Framework with support for React Server Components (RSC), Server Functions, Server-Side Rendering (SSR), Static Generation (SSG), Incremental Static Generation (ISG), and Incremental Static Regeneration (ISR)",
   "main": "index.js",
   "bin": {