@webtypen/webframez-react 0.0.13 → 0.0.15

package/dist/http.cjs

@@ -34,6 +34,7 @@ __export(http_exports, {
 module.exports = __toCommonJS(http_exports);
 var import_node_fs2 = __toESM(require("node:fs"), 1);
 var import_node_path3 = __toESM(require("node:path"), 1);
+var import_node_url = require("node:url");
 var import_node_child_process = require("node:child_process");
 
 // src/server.ts
@@ -428,6 +429,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = import_node_path2.default.join(pagesDir, "layout.js");
   const errorPath = import_node_path2.default.join(pagesDir, "errors.js");
+  const middlewaresPath = import_node_path2.default.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -470,6 +472,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!import_node_fs.default.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -495,10 +566,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = import_node_fs.default.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);
@@ -801,6 +874,38 @@ function parseCookies(rawCookieHeader) {
   }
   return output;
 }
+function normalizeClientManifest(manifest, options) {
+  const normalized = { ...manifest };
+  const candidateNodeModulesDirs = /* @__PURE__ */ new Set([
+    import_node_path3.default.resolve(options.cwd, "node_modules"),
+    import_node_path3.default.resolve(options.distRootDir, "..", "..", "node_modules")
+  ]);
+  for (const [key, value] of Object.entries(manifest)) {
+    if (!key.startsWith("file://")) {
+      continue;
+    }
+    let absolutePath = "";
+    try {
+      absolutePath = (0, import_node_url.fileURLToPath)(key);
+    } catch {
+      continue;
+    }
+    const marker = `${import_node_path3.default.sep}node_modules${import_node_path3.default.sep}`;
+    const markerIndex = absolutePath.lastIndexOf(marker);
+    if (markerIndex < 0) {
+      continue;
+    }
+    const relativeModulePath = absolutePath.slice(markerIndex + marker.length);
+    for (const nodeModulesDir of candidateNodeModulesDirs) {
+      const aliasPath = import_node_path3.default.join(nodeModulesDir, relativeModulePath);
+      const aliasKey = (0, import_node_url.pathToFileURL)(aliasPath).href;
+      if (!(aliasKey in normalized)) {
+        normalized[aliasKey] = value;
+      }
+    }
+  }
+  return normalized;
+}
 function createNodeRequestHandler(options) {
   const devServerId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
   const distRootDir = import_node_path3.default.resolve(options.distRootDir);
@@ -818,7 +923,13 @@ function createNodeRequestHandler(options) {
   const liveReloadPath = !liveReloadEnabled ? "" : options.liveReloadPath ?? `${basePath || ""}/__webframez_live_reload`;
   const liveReloadClients = /* @__PURE__ */ new Set();
   const router = createFileRouter({ pagesDir });
-  const moduleMap = JSON.parse(import_node_fs2.default.readFileSync(manifestPath, "utf-8"));
+  const moduleMap = normalizeClientManifest(
+    JSON.parse(import_node_fs2.default.readFileSync(manifestPath, "utf-8")),
+    {
+      distRootDir,
+      cwd: process.cwd()
+    }
+  );
   const initialHtmlWorker = createInitialHtmlWorker(pagesDir);
   const disposeInitialHtmlWorker = () => {
     initialHtmlWorker.dispose();

package/dist/http.js

@@ -9,6 +9,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/http.ts
 import fs2 from "node:fs";
 import path3 from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { spawn } from "node:child_process";
 
 // src/server.ts
@@ -403,6 +404,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = path2.join(pagesDir, "layout.js");
   const errorPath = path2.join(pagesDir, "errors.js");
+  const middlewaresPath = path2.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -445,6 +447,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!fs.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -470,10 +541,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = fs.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);
@@ -776,6 +849,38 @@ function parseCookies(rawCookieHeader) {
   }
   return output;
 }
+function normalizeClientManifest(manifest, options) {
+  const normalized = { ...manifest };
+  const candidateNodeModulesDirs = /* @__PURE__ */ new Set([
+    path3.resolve(options.cwd, "node_modules"),
+    path3.resolve(options.distRootDir, "..", "..", "node_modules")
+  ]);
+  for (const [key, value] of Object.entries(manifest)) {
+    if (!key.startsWith("file://")) {
+      continue;
+    }
+    let absolutePath = "";
+    try {
+      absolutePath = fileURLToPath(key);
+    } catch {
+      continue;
+    }
+    const marker = `${path3.sep}node_modules${path3.sep}`;
+    const markerIndex = absolutePath.lastIndexOf(marker);
+    if (markerIndex < 0) {
+      continue;
+    }
+    const relativeModulePath = absolutePath.slice(markerIndex + marker.length);
+    for (const nodeModulesDir of candidateNodeModulesDirs) {
+      const aliasPath = path3.join(nodeModulesDir, relativeModulePath);
+      const aliasKey = pathToFileURL(aliasPath).href;
+      if (!(aliasKey in normalized)) {
+        normalized[aliasKey] = value;
+      }
+    }
+  }
+  return normalized;
+}
 function createNodeRequestHandler(options) {
   const devServerId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
   const distRootDir = path3.resolve(options.distRootDir);
@@ -793,7 +898,13 @@ function createNodeRequestHandler(options) {
   const liveReloadPath = !liveReloadEnabled ? "" : options.liveReloadPath ?? `${basePath || ""}/__webframez_live_reload`;
   const liveReloadClients = /* @__PURE__ */ new Set();
   const router = createFileRouter({ pagesDir });
-  const moduleMap = JSON.parse(fs2.readFileSync(manifestPath, "utf-8"));
+  const moduleMap = normalizeClientManifest(
+    JSON.parse(fs2.readFileSync(manifestPath, "utf-8")),
+    {
+      distRootDir,
+      cwd: process.cwd()
+    }
+  );
   const initialHtmlWorker = createInitialHtmlWorker(pagesDir);
   const disposeInitialHtmlWorker = () => {
     initialHtmlWorker.dispose();

package/dist/index.cjs

@@ -462,6 +462,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = import_node_path2.default.join(pagesDir, "layout.js");
   const errorPath = import_node_path2.default.join(pagesDir, "errors.js");
+  const middlewaresPath = import_node_path2.default.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -504,6 +505,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!import_node_fs.default.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -529,10 +599,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = import_node_fs.default.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);
@@ -565,6 +637,7 @@ function parseSearchParams(query) {
 // src/http.ts
 var import_node_fs2 = __toESM(require("node:fs"), 1);
 var import_node_path3 = __toESM(require("node:path"), 1);
+var import_node_url = require("node:url");
 var import_node_child_process = require("node:child_process");
 function createInitialHtmlErrorMarkup(message) {
   return `<main style="font-family:system-ui,sans-serif;padding:24px"><h1 style="margin:0 0 12px">500</h1><p style="margin:0">${message}</p></main>`;
@@ -838,6 +911,38 @@ function parseCookies(rawCookieHeader) {
   }
   return output;
 }
+function normalizeClientManifest(manifest, options) {
+  const normalized = { ...manifest };
+  const candidateNodeModulesDirs = /* @__PURE__ */ new Set([
+    import_node_path3.default.resolve(options.cwd, "node_modules"),
+    import_node_path3.default.resolve(options.distRootDir, "..", "..", "node_modules")
+  ]);
+  for (const [key, value] of Object.entries(manifest)) {
+    if (!key.startsWith("file://")) {
+      continue;
+    }
+    let absolutePath = "";
+    try {
+      absolutePath = (0, import_node_url.fileURLToPath)(key);
+    } catch {
+      continue;
+    }
+    const marker = `${import_node_path3.default.sep}node_modules${import_node_path3.default.sep}`;
+    const markerIndex = absolutePath.lastIndexOf(marker);
+    if (markerIndex < 0) {
+      continue;
+    }
+    const relativeModulePath = absolutePath.slice(markerIndex + marker.length);
+    for (const nodeModulesDir of candidateNodeModulesDirs) {
+      const aliasPath = import_node_path3.default.join(nodeModulesDir, relativeModulePath);
+      const aliasKey = (0, import_node_url.pathToFileURL)(aliasPath).href;
+      if (!(aliasKey in normalized)) {
+        normalized[aliasKey] = value;
+      }
+    }
+  }
+  return normalized;
+}
 function createNodeRequestHandler(options) {
   const devServerId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
   const distRootDir = import_node_path3.default.resolve(options.distRootDir);
@@ -855,7 +960,13 @@ function createNodeRequestHandler(options) {
   const liveReloadPath = !liveReloadEnabled ? "" : options.liveReloadPath ?? `${basePath || ""}/__webframez_live_reload`;
   const liveReloadClients = /* @__PURE__ */ new Set();
   const router = createFileRouter({ pagesDir });
-  const moduleMap = JSON.parse(import_node_fs2.default.readFileSync(manifestPath, "utf-8"));
+  const moduleMap = normalizeClientManifest(
+    JSON.parse(import_node_fs2.default.readFileSync(manifestPath, "utf-8")),
+    {
+      distRootDir,
+      cwd: process.cwd()
+    }
+  );
   const initialHtmlWorker = createInitialHtmlWorker(pagesDir);
   const disposeInitialHtmlWorker = () => {
     initialHtmlWorker.dispose();

package/dist/index.js

@@ -426,6 +426,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = path2.join(pagesDir, "layout.js");
   const errorPath = path2.join(pagesDir, "errors.js");
+  const middlewaresPath = path2.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -468,6 +469,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!fs.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -493,10 +563,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = fs.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);
@@ -529,6 +601,7 @@ function parseSearchParams(query) {
 // src/http.ts
 import fs2 from "node:fs";
 import path3 from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { spawn } from "node:child_process";
 function createInitialHtmlErrorMarkup(message) {
   return `<main style="font-family:system-ui,sans-serif;padding:24px"><h1 style="margin:0 0 12px">500</h1><p style="margin:0">${message}</p></main>`;
@@ -802,6 +875,38 @@ function parseCookies(rawCookieHeader) {
   }
   return output;
 }
+function normalizeClientManifest(manifest, options) {
+  const normalized = { ...manifest };
+  const candidateNodeModulesDirs = /* @__PURE__ */ new Set([
+    path3.resolve(options.cwd, "node_modules"),
+    path3.resolve(options.distRootDir, "..", "..", "node_modules")
+  ]);
+  for (const [key, value] of Object.entries(manifest)) {
+    if (!key.startsWith("file://")) {
+      continue;
+    }
+    let absolutePath = "";
+    try {
+      absolutePath = fileURLToPath(key);
+    } catch {
+      continue;
+    }
+    const marker = `${path3.sep}node_modules${path3.sep}`;
+    const markerIndex = absolutePath.lastIndexOf(marker);
+    if (markerIndex < 0) {
+      continue;
+    }
+    const relativeModulePath = absolutePath.slice(markerIndex + marker.length);
+    for (const nodeModulesDir of candidateNodeModulesDirs) {
+      const aliasPath = path3.join(nodeModulesDir, relativeModulePath);
+      const aliasKey = pathToFileURL(aliasPath).href;
+      if (!(aliasKey in normalized)) {
+        normalized[aliasKey] = value;
+      }
+    }
+  }
+  return normalized;
+}
 function createNodeRequestHandler(options) {
   const devServerId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
   const distRootDir = path3.resolve(options.distRootDir);
@@ -819,7 +924,13 @@ function createNodeRequestHandler(options) {
   const liveReloadPath = !liveReloadEnabled ? "" : options.liveReloadPath ?? `${basePath || ""}/__webframez_live_reload`;
   const liveReloadClients = /* @__PURE__ */ new Set();
   const router = createFileRouter({ pagesDir });
-  const moduleMap = JSON.parse(fs2.readFileSync(manifestPath, "utf-8"));
+  const moduleMap = normalizeClientManifest(
+    JSON.parse(fs2.readFileSync(manifestPath, "utf-8")),
+    {
+      distRootDir,
+      cwd: process.cwd()
+    }
+  );
   const initialHtmlWorker = createInitialHtmlWorker(pagesDir);
   const disposeInitialHtmlWorker = () => {
     initialHtmlWorker.dispose();

package/dist/router.cjs

@@ -298,6 +298,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = import_node_path.default.join(pagesDir, "layout.js");
   const errorPath = import_node_path.default.join(pagesDir, "errors.js");
+  const middlewaresPath = import_node_path.default.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -340,6 +341,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!import_node_fs.default.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -365,10 +435,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = import_node_fs.default.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);

package/dist/router.js

@@ -268,6 +268,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = path.join(pagesDir, "layout.js");
   const errorPath = path.join(pagesDir, "errors.js");
+  const middlewaresPath = path.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -310,6 +311,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!fs.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -335,10 +405,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = fs.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);

package/dist/types.d.ts

@@ -69,10 +69,18 @@ export type PageDataResolver<TData = unknown> = (
   context: RouteContext
 ) => TData | Promise<TData>;
 
+export type RouteMiddlewareResult = Record<string, unknown> | undefined | void;
+export type RouteMiddlewareResolver<TData = unknown> = (
+  context: RouteContext<TData>
+) => RouteMiddlewareResult | Promise<RouteMiddlewareResult>;
+export type RouteMiddlewareRegistry = Record<string, RouteMiddlewareResolver<any>>;
+export type RouteMiddlewareConfig = string | string[];
+
 export type PageModule<TData = unknown> = {
   default: (props: PageProps<TData>) => ReactNode | Promise<ReactNode>;
   Head?: HeadResolver<PageProps<TData>>;
   Data?: PageDataResolver<TData>;
+  middlewares?: RouteMiddlewareConfig;
 };
 
 export type LayoutModule = {
@@ -91,6 +99,8 @@ export type CreateHtmlShellOptions = {
   clientScriptUrl?: string;
   headTags?: string;
   rootHtml?: string;
+  initialFlightData?: string;
+  clientRenderMode?: "hydrate" | "mount";
   basename?: string;
   liveReloadPath?: string;
   liveReloadServerId?: string;

package/dist/webframez-core.cjs

@@ -37,6 +37,7 @@ module.exports = __toCommonJS(webframez_core_exports);
 // src/http.ts
 var import_node_fs2 = __toESM(require("node:fs"), 1);
 var import_node_path3 = __toESM(require("node:path"), 1);
+var import_node_url = require("node:url");
 var import_node_child_process = require("node:child_process");
 
 // src/server.ts
@@ -431,6 +432,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = import_node_path2.default.join(pagesDir, "layout.js");
   const errorPath = import_node_path2.default.join(pagesDir, "errors.js");
+  const middlewaresPath = import_node_path2.default.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -473,6 +475,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!import_node_fs.default.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -498,10 +569,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = import_node_fs.default.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);
@@ -804,6 +877,38 @@ function parseCookies(rawCookieHeader) {
   }
   return output;
 }
+function normalizeClientManifest(manifest, options) {
+  const normalized = { ...manifest };
+  const candidateNodeModulesDirs = /* @__PURE__ */ new Set([
+    import_node_path3.default.resolve(options.cwd, "node_modules"),
+    import_node_path3.default.resolve(options.distRootDir, "..", "..", "node_modules")
+  ]);
+  for (const [key, value] of Object.entries(manifest)) {
+    if (!key.startsWith("file://")) {
+      continue;
+    }
+    let absolutePath = "";
+    try {
+      absolutePath = (0, import_node_url.fileURLToPath)(key);
+    } catch {
+      continue;
+    }
+    const marker = `${import_node_path3.default.sep}node_modules${import_node_path3.default.sep}`;
+    const markerIndex = absolutePath.lastIndexOf(marker);
+    if (markerIndex < 0) {
+      continue;
+    }
+    const relativeModulePath = absolutePath.slice(markerIndex + marker.length);
+    for (const nodeModulesDir of candidateNodeModulesDirs) {
+      const aliasPath = import_node_path3.default.join(nodeModulesDir, relativeModulePath);
+      const aliasKey = (0, import_node_url.pathToFileURL)(aliasPath).href;
+      if (!(aliasKey in normalized)) {
+        normalized[aliasKey] = value;
+      }
+    }
+  }
+  return normalized;
+}
 function createNodeRequestHandler(options) {
   const devServerId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
   const distRootDir = import_node_path3.default.resolve(options.distRootDir);
@@ -821,7 +926,13 @@ function createNodeRequestHandler(options) {
   const liveReloadPath = !liveReloadEnabled ? "" : options.liveReloadPath ?? `${basePath || ""}/__webframez_live_reload`;
   const liveReloadClients = /* @__PURE__ */ new Set();
   const router = createFileRouter({ pagesDir });
-  const moduleMap = JSON.parse(import_node_fs2.default.readFileSync(manifestPath, "utf-8"));
+  const moduleMap = normalizeClientManifest(
+    JSON.parse(import_node_fs2.default.readFileSync(manifestPath, "utf-8")),
+    {
+      distRootDir,
+      cwd: process.cwd()
+    }
+  );
   const initialHtmlWorker = createInitialHtmlWorker(pagesDir);
   const disposeInitialHtmlWorker = () => {
     initialHtmlWorker.dispose();

package/dist/webframez-core.js

@@ -9,6 +9,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/http.ts
 import fs2 from "node:fs";
 import path3 from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { spawn } from "node:child_process";
 
 // src/server.ts
@@ -403,6 +404,7 @@ function createFileRouter(options) {
   const pagesDir = options.pagesDir;
   const layoutPath = path2.join(pagesDir, "layout.js");
   const errorPath = path2.join(pagesDir, "errors.js");
+  const middlewaresPath = path2.join(pagesDir, "middlewares.js");
   function buildRouteEntries() {
     const files = walkFiles(pagesDir);
     return files.map((filePath) => toRouteEntry(pagesDir, filePath)).filter((entry) => entry !== null).sort((a, b) => {
@@ -445,6 +447,75 @@ function createFileRouter(options) {
       head: mergeHead(layoutHead, errorHead)
     };
   }
+  function normalizeMiddlewareNames(config) {
+    if (!config) {
+      return [];
+    }
+    return Array.isArray(config) ? config : [config];
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeRouteData(currentData, nextData) {
+    if (typeof nextData === "undefined") {
+      return currentData;
+    }
+    if (isPlainObject(currentData) && isPlainObject(nextData)) {
+      return {
+        ...currentData,
+        ...nextData
+      };
+    }
+    return nextData;
+  }
+  async function resolveMiddlewares(config, context) {
+    const middlewareNames = normalizeMiddlewareNames(config);
+    const requiresNamedMiddleware = middlewareNames.length > 0;
+    if (!fs.existsSync(middlewaresPath)) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const middlewareModule = resolveModule(middlewaresPath);
+    const registry = middlewareModule.middlewares;
+    if (!registry) {
+      if (!requiresNamedMiddleware) {
+        return context;
+      }
+      throw createAbort({
+        status: 500,
+        message: `Invalid middleware '${middlewareNames[0]}'`
+      });
+    }
+    const orderedMiddlewareNames = typeof registry["*"] === "function" ? ["*", ...middlewareNames] : middlewareNames;
+    if (orderedMiddlewareNames.length === 0) {
+      return context;
+    }
+    let nextContext = context;
+    for (const middlewareName of orderedMiddlewareNames) {
+      const middleware = registry[middlewareName];
+      if (typeof middleware !== "function") {
+        throw createAbort({
+          status: 500,
+          message: `Invalid middleware '${middlewareName}'`
+        });
+      }
+      const middlewareData = await middleware(nextContext);
+      nextContext = {
+        ...nextContext,
+        data: mergeRouteData(nextContext.data, middlewareData)
+      };
+    }
+    return nextContext;
+  }
   async function resolve(input) {
     const pathname = normalizePathname(input.pathname);
     const contextBase = {
@@ -470,10 +541,12 @@ function createFileRouter(options) {
       activeContext = context;
       const pageModule = resolveModule(match.entry.filePath);
       const layoutModule = fs.existsSync(layoutPath) ? resolveModule(layoutPath) : null;
-      const pageData = await resolvePageData(pageModule, context);
+      const middlewareContext = await resolveMiddlewares(pageModule.middlewares, context);
+      activeContext = middlewareContext;
+      const pageData = await resolvePageData(pageModule, middlewareContext);
       const pageContext = {
-        ...context,
-        data: pageData
+        ...middlewareContext,
+        data: mergeRouteData(middlewareContext.data, pageData)
       };
       activeContext = pageContext;
       const pageNode = await pageModule.default(pageContext);
@@ -776,6 +849,38 @@ function parseCookies(rawCookieHeader) {
   }
   return output;
 }
+function normalizeClientManifest(manifest, options) {
+  const normalized = { ...manifest };
+  const candidateNodeModulesDirs = /* @__PURE__ */ new Set([
+    path3.resolve(options.cwd, "node_modules"),
+    path3.resolve(options.distRootDir, "..", "..", "node_modules")
+  ]);
+  for (const [key, value] of Object.entries(manifest)) {
+    if (!key.startsWith("file://")) {
+      continue;
+    }
+    let absolutePath = "";
+    try {
+      absolutePath = fileURLToPath(key);
+    } catch {
+      continue;
+    }
+    const marker = `${path3.sep}node_modules${path3.sep}`;
+    const markerIndex = absolutePath.lastIndexOf(marker);
+    if (markerIndex < 0) {
+      continue;
+    }
+    const relativeModulePath = absolutePath.slice(markerIndex + marker.length);
+    for (const nodeModulesDir of candidateNodeModulesDirs) {
+      const aliasPath = path3.join(nodeModulesDir, relativeModulePath);
+      const aliasKey = pathToFileURL(aliasPath).href;
+      if (!(aliasKey in normalized)) {
+        normalized[aliasKey] = value;
+      }
+    }
+  }
+  return normalized;
+}
 function createNodeRequestHandler(options) {
   const devServerId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
   const distRootDir = path3.resolve(options.distRootDir);
@@ -793,7 +898,13 @@ function createNodeRequestHandler(options) {
   const liveReloadPath = !liveReloadEnabled ? "" : options.liveReloadPath ?? `${basePath || ""}/__webframez_live_reload`;
   const liveReloadClients = /* @__PURE__ */ new Set();
   const router = createFileRouter({ pagesDir });
-  const moduleMap = JSON.parse(fs2.readFileSync(manifestPath, "utf-8"));
+  const moduleMap = normalizeClientManifest(
+    JSON.parse(fs2.readFileSync(manifestPath, "utf-8")),
+    {
+      distRootDir,
+      cwd: process.cwd()
+    }
+  );
   const initialHtmlWorker = createInitialHtmlWorker(pagesDir);
   const disposeInitialHtmlWorker = () => {
     initialHtmlWorker.dispose();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webtypen/webframez-react",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "TypeScript React RSC addition for @webtypen/webframez-core",
   "homepage": "https://webtypen.de/",
   "author": {