dinou 7.2.0 → 7.3.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ 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/).
 
+## [7.3.0]
+
+### Added
+- **Universal Setup Files & Environment Polyfills**:
+  - Early-stage execution guarantee: Setup scripts are injected at Line 1 of all compilation bundles before any module imports or engine code run, enabling browser/canvas polyfills (`DOMMatrix`, `ImageData`, `Path2D`) and APM/telemetry agents without ejecting.
+  - Unified configuration hierarchy: `plugin.setupFiles` (plugins run first) -> explicit `setupFiles: [...]` in `dinou.config.*` (strict source of truth; replaces convention) -> zero-config root convention `./dinou.setup.(mjs|js|ts)`.
+  - Comprehensive multi-platform support: Injected uniformly across Node.js (`Pass A`, `Pass B`, `Pass C`), Bun native AOT, Cloudflare Workers, Deno / Deno Deploy, Static Site Generation (SSG), and Hot-Reload Dev Server.
+  - Added TypeScript definitions for `setupFiles?: string[]` in both `DinouConfig` and `DinouPlugin`.
+
+### Fixed
+- **Bun Standalone Compilation Port Collision (`EADDRINUSE`)**:
+  - Resolved port binding conflict when compiling the Node.js orchestrator into a standalone executable using `bun build --compile`.
+  - Separated exports in `.dinou/node/server.mjs`: `fetch` is now exported exclusively as a named export (`export { fetch }`), while `export default` exposes `{ port, startServer }`, preventing Bun's runtime from launching a duplicate background `Bun.serve` instance over Node's `http.createServer()`.
+  - Robust `isMain` execution detection supporting both Node.js (`process.argv[1]`) and compiled Bun binaries (`import.meta.main`).
+
 ## [7.2.0]
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # **Dinou**
 
-[![Documentation](https://img.shields.io/badge/docs-dinou.dev-blue?style=flat-square)](https://dinou.dev) [![Version](https://img.shields.io/badge/version-7.2.0-orange?style=flat-square)](https://www.npmjs.com/package/dinou)
+[![Documentation](https://img.shields.io/badge/docs-dinou.dev-blue?style=flat-square)](https://dinou.dev) [![Version](https://img.shields.io/badge/version-7.3.0-orange?style=flat-square)](https://www.npmjs.com/package/dinou)
 
 ### **Full-Stack React 19 Framework**
 

package/cli.js

@@ -121,91 +121,91 @@ program
     runCommand(`cross-env NODE_ENV=production DINOU_BUILD_TOOL=webpack node ${p("adapters/node.mjs")}`);
   });
 
-// --- NODE (COMPILE VIA BUN) ---
-
-const nodeTargets = [
-  { name: "", flags: "", outfile: "dist/server" },
-  { name: ":linux", flags: "--target=bun-linux-x64 ", outfile: "dist/server-linux" },
-  { name: ":linux_arm", flags: "--target=bun-linux-arm64 ", outfile: "dist/server-linux-arm" },
-  { name: ":mac", flags: "--target=bun-darwin-arm64 ", outfile: "dist/server-mac" },
-  { name: ":win", flags: "--target=bun-windows-x64 ", outfile: "dist/server-win" },
-];
-
-const runNodeBuild = (bundler) => {
-  const bundlerCmd = bundler === "rollup"
-    ? `cross-env NODE_ENV=production npx rollup -c ${p("rollup/rollup.config.js")}`
-    : bundler === "webpack"
-    ? `cross-env NODE_ENV=production npx webpack --config ${p("webpack/webpack.config.js")}`
-    : `cross-env NODE_ENV=production node ${p("esbuild/build.mjs")}`;
-
-  const envPrefix = bundler === "webpack" ? "cross-env DINOU_BUILD_TOOL=webpack " : "";
-  return `${bundlerCmd} && ${envPrefix}node ${p("node/build.mjs")}`;
-};
-
-for (const t of nodeTargets) {
-  for (const b of ["esbuild", "rollup", "webpack"]) {
-    const cmdNames = b === "esbuild"
-      ? [`build:node:compile${t.name}`, `build:node:compile${t.name}:esbuild`]
-      : [`build:node:compile${t.name}:${b}`];
-    for (const cmdName of cmdNames) {
-      program
-        .command(cmdName)
-        .description(`Compile standalone Node.js server executable with Bun (${t.name || "host"}, ${b})`)
-        .action(() => {
-          runCommand(`${runNodeBuild(b)} && bun build --compile ${t.flags}.dinou/node/server.mjs --outfile ${t.outfile}`);
-        });
-    }
-  }
-}
-
-// --- NODE (PURE BUN RUNNER COMPILE) ---
-
-const runNodePureBuild = (bundler) => {
-  if (bundler === "rollup") {
-    return `cross-env NODE_ENV=production npx rollup -c ${p("rollup/rollup.config.js")} && bun ${p("node/build.mjs")}`;
-  }
-  if (bundler === "webpack") {
-    return `cross-env NODE_ENV=production npx webpack --config ${p("webpack/webpack.config.js")} && cross-env DINOU_BUILD_TOOL=webpack bun ${p("node/build.mjs")}`;
-  }
-  return `cross-env NODE_ENV=production bun ${p("esbuild/build.mjs")} && bun ${p("node/build.mjs")}`;
-};
-
-program
-  .command("build:node:pure")
-  .description("Build the app for Node.js with 100% Bun (using esbuild)")
-  .action(() => { runCommand(runNodePureBuild("esbuild")); });
-
-program
-  .command("build:node:pure:esbuild")
-  .description("Build the app for Node.js with 100% Bun (Esbuild)")
-  .action(() => { runCommand(runNodePureBuild("esbuild")); });
-
-program
-  .command("build:node:pure:rollup")
-  .description("Build the app for Node.js with 100% Bun (Rollup)")
-  .action(() => { runCommand(runNodePureBuild("rollup")); });
-
-program
-  .command("build:node:pure:webpack")
-  .description("Build the app for Node.js with 100% Bun (Webpack)")
-  .action(() => { runCommand(runNodePureBuild("webpack")); });
-
-for (const t of nodeTargets) {
-  for (const b of ["esbuild", "rollup", "webpack"]) {
-    const cmdNames = b === "esbuild"
-      ? [`build:node:pure:compile${t.name}`, `build:node:pure:compile${t.name}:esbuild`]
-      : [`build:node:pure:compile${t.name}:${b}`];
-    for (const cmdName of cmdNames) {
-      program
-        .command(cmdName)
-        .description(`Compile standalone Node.js server executable with 100% Bun (${t.name || "host"}, ${b})`)
-        .action(() => {
-          runCommand(`${runNodePureBuild(b)} && bun build --compile ${t.flags}.dinou/node/server.mjs --outfile ${t.outfile}`);
-        });
-    }
-  }
-}
-
+// --- NODE (COMPILE VIA BUN) ---
+
+const nodeTargets = [
+  { name: "", flags: "", outfile: "dist/server" },
+  { name: ":linux", flags: "--target=bun-linux-x64 ", outfile: "dist/server-linux" },
+  { name: ":linux_arm", flags: "--target=bun-linux-arm64 ", outfile: "dist/server-linux-arm" },
+  { name: ":mac", flags: "--target=bun-darwin-arm64 ", outfile: "dist/server-mac" },
+  { name: ":win", flags: "--target=bun-windows-x64 ", outfile: "dist/server-win" },
+];
+
+const runNodeBuild = (bundler) => {
+  const bundlerCmd = bundler === "rollup"
+    ? `cross-env NODE_ENV=production npx rollup -c ${p("rollup/rollup.config.js")}`
+    : bundler === "webpack"
+    ? `cross-env NODE_ENV=production npx webpack --config ${p("webpack/webpack.config.js")}`
+    : `cross-env NODE_ENV=production node ${p("esbuild/build.mjs")}`;
+
+  const envPrefix = bundler === "webpack" ? "cross-env DINOU_BUILD_TOOL=webpack " : "";
+  return `${bundlerCmd} && ${envPrefix}node ${p("node/build.mjs")}`;
+};
+
+for (const t of nodeTargets) {
+  for (const b of ["esbuild", "rollup", "webpack"]) {
+    const cmdNames = b === "esbuild"
+      ? [`build:node:compile${t.name}`, `build:node:compile${t.name}:esbuild`]
+      : [`build:node:compile${t.name}:${b}`];
+    for (const cmdName of cmdNames) {
+      program
+        .command(cmdName)
+        .description(`Compile standalone Node.js server executable with Bun (${t.name || "host"}, ${b})`)
+        .action(() => {
+          runCommand(`${runNodeBuild(b)} && bun build --compile ${t.flags}.dinou/node/server.mjs --outfile ${t.outfile}`);
+        });
+    }
+  }
+}
+
+// --- NODE (PURE BUN RUNNER COMPILE) ---
+
+const runNodePureBuild = (bundler) => {
+  if (bundler === "rollup") {
+    return `cross-env NODE_ENV=production npx rollup -c ${p("rollup/rollup.config.js")} && bun ${p("node/build.mjs")}`;
+  }
+  if (bundler === "webpack") {
+    return `cross-env NODE_ENV=production npx webpack --config ${p("webpack/webpack.config.js")} && cross-env DINOU_BUILD_TOOL=webpack bun ${p("node/build.mjs")}`;
+  }
+  return `cross-env NODE_ENV=production bun ${p("esbuild/build.mjs")} && bun ${p("node/build.mjs")}`;
+};
+
+program
+  .command("build:node:pure")
+  .description("Build the app for Node.js with 100% Bun (using esbuild)")
+  .action(() => { runCommand(runNodePureBuild("esbuild")); });
+
+program
+  .command("build:node:pure:esbuild")
+  .description("Build the app for Node.js with 100% Bun (Esbuild)")
+  .action(() => { runCommand(runNodePureBuild("esbuild")); });
+
+program
+  .command("build:node:pure:rollup")
+  .description("Build the app for Node.js with 100% Bun (Rollup)")
+  .action(() => { runCommand(runNodePureBuild("rollup")); });
+
+program
+  .command("build:node:pure:webpack")
+  .description("Build the app for Node.js with 100% Bun (Webpack)")
+  .action(() => { runCommand(runNodePureBuild("webpack")); });
+
+for (const t of nodeTargets) {
+  for (const b of ["esbuild", "rollup", "webpack"]) {
+    const cmdNames = b === "esbuild"
+      ? [`build:node:pure:compile${t.name}`, `build:node:pure:compile${t.name}:esbuild`]
+      : [`build:node:pure:compile${t.name}:${b}`];
+    for (const cmdName of cmdNames) {
+      program
+        .command(cmdName)
+        .description(`Compile standalone Node.js server executable with 100% Bun (${t.name || "host"}, ${b})`)
+        .action(() => {
+          runCommand(`${runNodePureBuild(b)} && bun build --compile ${t.flags}.dinou/node/server.mjs --outfile ${t.outfile}`);
+        });
+    }
+  }
+}
+
 // --- CLOUDFLARE WORKERS ---
 
 program

package/dinou/bun/build.mjs

@@ -19,11 +19,19 @@ const {
   isSupportedClientModule,
   scanProjectDependenciesForClientComponents,
 } = require("../core/scan-dependency-components.js");
+const { getDinouConfig } = require("../core/load-dinou-config.js");
+const { resolveSetupFiles } = require("../core/resolve-setup-files.js");
 
 const projectRoot = process.cwd();
 const bunDir = path.resolve(projectRoot, ".dinou/bun");
 fs.mkdirSync(bunDir, { recursive: true });
 
+const dinouConfig = await getDinouConfig(projectRoot);
+const setupFiles = resolveSetupFiles(projectRoot, dinouConfig);
+if (setupFiles.length > 0) {
+  console.log(`  🔌 [Dinou Setup] Active setup files (${setupFiles.length}): ${setupFiles.map((f) => path.basename(f)).join(", ")}`);
+}
+
 try {
   generateRouteTypes(projectRoot);
 } catch (e) {}
@@ -1012,6 +1020,7 @@ try {
     alias: commonAlias,
     loader: commonLoader,
     jsx: "automatic",
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     define: {
       "process.env.NODE_ENV": '"production"',
       "process.env.DINOU_RUNTIME": '"bun-bundle"',
@@ -1035,6 +1044,7 @@ try {
     alias: commonAlias,
     loader: commonLoader,
     jsx: "automatic",
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     define: {
       "process.env.NODE_ENV": '"production"',
       "process.env.DINOU_RUNTIME": '"bun-bundle"',
@@ -1056,6 +1066,7 @@ try {
     conditions: ["bun", "worker", "browser"],
     external: externalList,
     banner,
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     alias: commonAlias,
     loader: commonLoader,
     define: {

package/dinou/cloudflare/build.mjs

@@ -19,11 +19,19 @@ const {
   isSupportedClientModule,
   scanProjectDependenciesForClientComponents,
 } = require("../core/scan-dependency-components.js");
+const { getDinouConfig } = require("../core/load-dinou-config.js");
+const { resolveSetupFiles } = require("../core/resolve-setup-files.js");
 
 const projectRoot = process.cwd();
 const cloudflareDir = path.resolve(projectRoot, ".dinou/cloudflare");
 fs.mkdirSync(cloudflareDir, { recursive: true });
 
+const dinouConfig = await getDinouConfig(projectRoot);
+const setupFiles = resolveSetupFiles(projectRoot, dinouConfig);
+if (setupFiles.length > 0) {
+  console.log(`  🔌 [Dinou Setup] Active setup files (${setupFiles.length}): ${setupFiles.map((f) => path.basename(f)).join(", ")}`);
+}
+
 try {
   generateRouteTypes(projectRoot);
 } catch (e) {}
@@ -1057,6 +1065,7 @@ try {
     alias: commonAlias,
     loader: commonLoader,
     jsx: "automatic",
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     define: {
       "process.env.NODE_ENV": '"production"',
       "process.env.DINOU_RUNTIME": '"edge"',
@@ -1080,6 +1089,7 @@ try {
     alias: commonAlias,
     loader: commonLoader,
     jsx: "automatic",
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     define: {
       "process.env.NODE_ENV": '"production"',
       "process.env.DINOU_RUNTIME": '"edge"',
@@ -1101,6 +1111,7 @@ try {
     conditions: ["workerd", "worker", "browser"],
     external: externalList,
     banner,
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     alias: commonAlias,
     loader: commonLoader,
     define: {

package/dinou/core/resolve-setup-files.js

@@ -0,0 +1,69 @@
+// dinou/core/resolve-setup-files.js
+const fs = require("node:fs");
+const path = require("node:path");
+
+/**
+ * Resolves setup files according to Dinou's configuration hierarchy:
+ * 1. Plugin setup files (plugin.setupFiles) always execute first.
+ * 2. User setup files:
+ *    - If config.setupFiles is explicitly provided in dinou.config.mjs, it is the sole source of truth.
+ *    - Otherwise, falls back to checking the project root for dinou.setup.mjs, dinou.setup.js, or dinou.setup.ts.
+ *
+ * @param {string} projectRoot
+ * @param {object} config - Dinou config object
+ * @returns {string[]} Array of absolute file paths to inject/execute
+ */
+function resolveSetupFiles(projectRoot, config = {}) {
+  const pluginSetupFiles = [];
+  if (config.plugins && Array.isArray(config.plugins)) {
+    for (const plugin of config.plugins) {
+      if (plugin && Array.isArray(plugin.setupFiles)) {
+        for (const file of plugin.setupFiles) {
+          const resolved = path.isAbsolute(file)
+            ? file
+            : path.resolve(projectRoot, file);
+          if (fs.existsSync(resolved)) {
+            pluginSetupFiles.push(resolved);
+          } else {
+            console.warn(
+              `⚠️ [Dinou] Plugin "${plugin.name || "unnamed"}" specified setup file not found: ${file}`,
+            );
+          }
+        }
+      }
+    }
+  }
+
+  let userSetupFiles = [];
+  if (Array.isArray(config.setupFiles)) {
+    // Explicit configuration takes precedence over convention
+    for (const file of config.setupFiles) {
+      const resolved = path.isAbsolute(file)
+        ? file
+        : path.resolve(projectRoot, file);
+      if (fs.existsSync(resolved)) {
+        userSetupFiles.push(resolved);
+      } else {
+        console.warn(`⚠️ [Dinou] Configured setupFile not found: ${file}`);
+      }
+    }
+  } else {
+    // Convention: check ONLY project root
+    const rootCandidates = [
+      "dinou.setup.mjs",
+      "dinou.setup.js",
+      "dinou.setup.ts",
+    ];
+    for (const name of rootCandidates) {
+      const fullPath = path.resolve(projectRoot, name);
+      if (fs.existsSync(fullPath)) {
+        userSetupFiles.push(fullPath);
+        break; // Only pick the highest priority extension match
+      }
+    }
+  }
+
+  return [...new Set([...pluginSetupFiles, ...userSetupFiles])];
+}
+
+module.exports = { resolveSetupFiles };

package/dinou/deno/build.mjs

@@ -19,11 +19,19 @@ const {
   isSupportedClientModule,
   scanProjectDependenciesForClientComponents,
 } = require("../core/scan-dependency-components.js");
+const { getDinouConfig } = require("../core/load-dinou-config.js");
+const { resolveSetupFiles } = require("../core/resolve-setup-files.js");
 
 const projectRoot = process.cwd();
 const denoDir = path.resolve(projectRoot, ".dinou/deno");
 fs.mkdirSync(denoDir, { recursive: true });
 
+const dinouConfig = await getDinouConfig(projectRoot);
+const setupFiles = resolveSetupFiles(projectRoot, dinouConfig);
+if (setupFiles.length > 0) {
+  console.log(`  🔌 [Dinou Setup] Active setup files (${setupFiles.length}): ${setupFiles.map((f) => path.basename(f)).join(", ")}`);
+}
+
 try {
   generateRouteTypes(projectRoot);
 } catch (e) {}
@@ -1046,6 +1054,7 @@ try {
     alias: commonAlias,
     loader: commonLoader,
     jsx: "automatic",
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     define: {
       "process.env.NODE_ENV": '"production"',
       "process.env.DINOU_RUNTIME": '"deno-edge"',
@@ -1069,6 +1078,7 @@ try {
     alias: commonAlias,
     loader: commonLoader,
     jsx: "automatic",
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     define: {
       "process.env.NODE_ENV": '"production"',
       "process.env.DINOU_RUNTIME": '"deno-edge"',
@@ -1090,6 +1100,7 @@ try {
     conditions: ["deno", "worker", "browser"],
     external: externalList,
     banner,
+    inject: setupFiles.length > 0 ? setupFiles : undefined,
     alias: commonAlias,
     loader: commonLoader,
     define: {

package/dinou/index.d.ts

@@ -143,6 +143,12 @@ export interface DinouPlugin {
    */
   configureServer?(context: ServerHookContext): Promise<void> | void;
 
+  /**
+   * Array of setup/polyfill file paths to be executed at the earliest stage
+   * and injected into all bundled engines before any modules are loaded.
+   */
+  setupFiles?: string[];
+
   /**
    * Universal Web Standards middleware and webhook handler.
    * Runs on every incoming HTTP request before React rendering.
@@ -182,6 +188,13 @@ export interface DinouConfig {
    */
   storage?: any;
 
+  /**
+   * Array of setup/polyfill file paths to be executed at the earliest stage
+   * before any server or client components are imported.
+   * If provided, overrides the root `dinou.setup.(mjs|js|ts)` convention.
+   */
+  setupFiles?: string[];
+
   /**
    * Array of Dinou plugins.
    */

package/dinou/node/build.mjs

@@ -23,7 +23,7 @@ try {
     outDir: ".dinou/node",
   });
 
-  const { dinouDirSlash, externalList, banner, commonAlias, commonLoader, isWebpackBuild } = engineResult;
+  const { dinouDirSlash, externalList, banner, commonAlias, commonLoader, isWebpackBuild, setupFiles } = engineResult;
 
   // Pass C: Node Orchestrator Entry
   const nodeEntryContent = `// Auto-generated main entry for Node.js (Dual-Bundle)
@@ -189,17 +189,20 @@ export async function startServer(port = PORT, host = "0.0.0.0") {
 
 export default {
   port: PORT,
-  fetch,
   startServer,
 };
 
-const isMain = typeof process !== "undefined" &&
-  process.argv[1] &&
-  (path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url)));
+const isMain = Boolean(
+  (typeof import.meta !== "undefined" && import.meta.main) ||
+  (typeof process !== "undefined" &&
+    process.argv[1] &&
+    (path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))))
+);
 
 if (isMain) {
   startServer(PORT);
 }
+
 `;
   const nodeEntryPath = path.join(nodeDir, "node-entry.mjs");
   fs.writeFileSync(nodeEntryPath, nodeEntryContent, "utf8");
@@ -218,6 +221,7 @@ if (isMain) {
     conditions: ["node", "worker", "browser"],
     external: [...externalList, "./rsc-engine.mjs", "./ssr-engine.mjs"],
     banner,
+    inject: setupFiles,
     alias: commonAlias,
     loader: commonLoader,
     define: {

package/dinou/node/bundle-dual-engine.mjs

@@ -20,6 +20,8 @@ const {
   isSupportedClientModule,
   scanProjectDependenciesForClientComponents,
 } = require("../core/scan-dependency-components.js");
+const { getDinouConfig } = require("../core/load-dinou-config.js");
+const { resolveSetupFiles } = require("../core/resolve-setup-files.js");
 
 export async function bundleDualEngine(options = {}) {
   const isDev = Boolean(options.isDev);
@@ -27,6 +29,12 @@ export async function bundleDualEngine(options = {}) {
   const nodeDir = path.resolve(projectRoot, options.outDir || ".dinou/node");
   fs.mkdirSync(nodeDir, { recursive: true });
 
+  const dinouConfig = await getDinouConfig();
+  const setupFiles = resolveSetupFiles(projectRoot, dinouConfig);
+  if (setupFiles.length > 0) {
+    console.log(`  🔌 [Dinou Setup] Active setup files (${setupFiles.length}):`, setupFiles.map((f) => path.relative(projectRoot, f)).join(", "));
+  }
+
   try {
     generateRouteTypes(projectRoot);
   } catch (e) {}
@@ -956,6 +964,7 @@ var __webpack_chunk_load__ = function(chunkId) {
     conditions: ["node", "worker", "react-server"],
     external: externalList,
     banner,
+    inject: setupFiles,
     plugins: [clientReferencesPlugin, serverReferencesPlugin, serverAssetPlugin],
     alias: commonAlias,
     loader: commonLoader,
@@ -980,6 +989,7 @@ var __webpack_chunk_load__ = function(chunkId) {
     conditions: ["node", "worker", "browser"],
     external: externalList,
     banner,
+    inject: setupFiles,
     plugins: [serverReferencesPluginSsr, serverAssetPlugin],
     alias: commonAlias,
     loader: commonLoader,
@@ -1006,6 +1016,7 @@ var __webpack_chunk_load__ = function(chunkId) {
     commonAlias,
     commonLoader,
     isWebpackBuild,
+    setupFiles,
   };
 }
 

package/dinou/node/dev.mjs

@@ -76,6 +76,22 @@ const dinouDir = fs.existsSync(path.resolve(projectRoot, "dinou"))
   : path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const dinouDirSlash = dinouDir.replace(/\\/g, "/");
 
+// Resolve and execute setupFiles immediately before any compilation
+const { getDinouConfig } = require(path.join(dinouDir, "core/load-dinou-config.js"));
+const { resolveSetupFiles } = require(path.join(dinouDir, "core/resolve-setup-files.js"));
+const dinouConfig = await getDinouConfig();
+const setupFiles = resolveSetupFiles(projectRoot, dinouConfig);
+if (setupFiles.length > 0) {
+  console.log(`  🔌 [Dinou Setup] Executing setup files (${setupFiles.length}):`, setupFiles.map((f) => path.relative(projectRoot, f)).join(", "));
+  for (const f of setupFiles) {
+    try {
+      await dynamicImportWithRetry(pathToFileURL(f).href);
+    } catch (e) {
+      console.error(`❌ [Dinou Dev] Error executing setupFile "${f}":`, e);
+    }
+  }
+}
+
 function getFallbackChunkId(absPath) {
   const norm = absPath.replace(/\\/g, "/");
   const name = path.basename(absPath, path.extname(absPath));
@@ -1463,6 +1479,7 @@ const ctxA = await esbuild.context({
   conditions: ["node", "worker", "react-server"],
   external: externalList,
   banner,
+  inject: setupFiles,
   plugins: [clientReferencesPlugin, serverReferencesPlugin, serverAssetPlugin, createDevExternalPackagesPlugin(true)],
   alias: commonAlias,
   loader: commonLoader,
@@ -1490,6 +1507,7 @@ const ctxB = await esbuild.context({
   conditions: ["node", "worker", "browser"],
   external: externalList,
   banner,
+  inject: setupFiles,
   plugins: [serverReferencesPluginSsr, serverAssetPlugin, createDevExternalPackagesPlugin(false)],
   alias: commonAlias,
   loader: commonLoader,

package/dinou/package.json

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

package/eject.js

@@ -28,50 +28,50 @@ const ejectedScripts = {
   "build:node:esbuild": "npm run build:node",
   "build:node:rollup": "npm run build:client:rollup && node ./dinou/node/build.mjs",
   "build:node:webpack": "npm run build:client:webpack && cross-env DINOU_BUILD_TOOL=webpack node ./dinou/node/build.mjs",
-  "build:node:compile": "npm run build:node:compile:esbuild",
-  "build:node:compile:esbuild": "npm run build:node:esbuild && bun build --compile .dinou/node/server.mjs --outfile dist/server",
-  "build:node:compile:rollup": "npm run build:node:rollup && bun build --compile .dinou/node/server.mjs --outfile dist/server",
-  "build:node:compile:webpack": "npm run build:node:webpack && bun build --compile .dinou/node/server.mjs --outfile dist/server",
-  "build:node:compile:linux": "npm run build:node:compile:linux:esbuild",
-  "build:node:compile:linux:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
-  "build:node:compile:linux:rollup": "npm run build:node:rollup && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
-  "build:node:compile:linux:webpack": "npm run build:node:webpack && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
-  "build:node:compile:linux_arm": "npm run build:node:compile:linux_arm:esbuild",
-  "build:node:compile:linux_arm:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
-  "build:node:compile:linux_arm:rollup": "npm run build:node:rollup && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
-  "build:node:compile:linux_arm:webpack": "npm run build:node:webpack && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
-  "build:node:compile:mac": "npm run build:node:compile:mac:esbuild",
-  "build:node:compile:mac:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
-  "build:node:compile:mac:rollup": "npm run build:node:rollup && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
-  "build:node:compile:mac:webpack": "npm run build:node:webpack && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
-  "build:node:compile:win": "npm run build:node:compile:win:esbuild",
-  "build:node:compile:win:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
-  "build:node:compile:win:rollup": "npm run build:node:rollup && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
-  "build:node:compile:win:webpack": "npm run build:node:webpack && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
-  "build:node:pure": "npm run build:node:pure:esbuild",
-  "build:node:pure:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs",
-  "build:node:pure:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs",
-  "build:node:pure:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs",
-  "build:node:pure:compile": "npm run build:node:pure:compile:esbuild",
-  "build:node:pure:compile:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile .dinou/node/server.mjs --outfile dist/server",
-  "build:node:pure:compile:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile .dinou/node/server.mjs --outfile dist/server",
-  "build:node:pure:compile:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile .dinou/node/server.mjs --outfile dist/server",
-  "build:node:pure:compile:linux": "npm run build:node:pure:compile:linux:esbuild",
-  "build:node:pure:compile:linux:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
-  "build:node:pure:compile:linux:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
-  "build:node:pure:compile:linux:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
-  "build:node:pure:compile:linux_arm": "npm run build:node:pure:compile:linux_arm:esbuild",
-  "build:node:pure:compile:linux_arm:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
-  "build:node:pure:compile:linux_arm:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
-  "build:node:pure:compile:linux_arm:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
-  "build:node:pure:compile:mac": "npm run build:node:pure:compile:mac:esbuild",
-  "build:node:pure:compile:mac:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
-  "build:node:pure:compile:mac:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
-  "build:node:pure:compile:mac:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
-  "build:node:pure:compile:win": "npm run build:node:pure:compile:win:esbuild",
-  "build:node:pure:compile:win:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
-  "build:node:pure:compile:win:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
-  "build:node:pure:compile:win:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
+  "build:node:compile": "npm run build:node:compile:esbuild",
+  "build:node:compile:esbuild": "npm run build:node:esbuild && bun build --compile .dinou/node/server.mjs --outfile dist/server",
+  "build:node:compile:rollup": "npm run build:node:rollup && bun build --compile .dinou/node/server.mjs --outfile dist/server",
+  "build:node:compile:webpack": "npm run build:node:webpack && bun build --compile .dinou/node/server.mjs --outfile dist/server",
+  "build:node:compile:linux": "npm run build:node:compile:linux:esbuild",
+  "build:node:compile:linux:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
+  "build:node:compile:linux:rollup": "npm run build:node:rollup && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
+  "build:node:compile:linux:webpack": "npm run build:node:webpack && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
+  "build:node:compile:linux_arm": "npm run build:node:compile:linux_arm:esbuild",
+  "build:node:compile:linux_arm:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
+  "build:node:compile:linux_arm:rollup": "npm run build:node:rollup && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
+  "build:node:compile:linux_arm:webpack": "npm run build:node:webpack && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
+  "build:node:compile:mac": "npm run build:node:compile:mac:esbuild",
+  "build:node:compile:mac:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
+  "build:node:compile:mac:rollup": "npm run build:node:rollup && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
+  "build:node:compile:mac:webpack": "npm run build:node:webpack && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
+  "build:node:compile:win": "npm run build:node:compile:win:esbuild",
+  "build:node:compile:win:esbuild": "npm run build:node:esbuild && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
+  "build:node:compile:win:rollup": "npm run build:node:rollup && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
+  "build:node:compile:win:webpack": "npm run build:node:webpack && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
+  "build:node:pure": "npm run build:node:pure:esbuild",
+  "build:node:pure:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs",
+  "build:node:pure:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs",
+  "build:node:pure:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs",
+  "build:node:pure:compile": "npm run build:node:pure:compile:esbuild",
+  "build:node:pure:compile:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile .dinou/node/server.mjs --outfile dist/server",
+  "build:node:pure:compile:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile .dinou/node/server.mjs --outfile dist/server",
+  "build:node:pure:compile:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile .dinou/node/server.mjs --outfile dist/server",
+  "build:node:pure:compile:linux": "npm run build:node:pure:compile:linux:esbuild",
+  "build:node:pure:compile:linux:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
+  "build:node:pure:compile:linux:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
+  "build:node:pure:compile:linux:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-x64 .dinou/node/server.mjs --outfile dist/server-linux",
+  "build:node:pure:compile:linux_arm": "npm run build:node:pure:compile:linux_arm:esbuild",
+  "build:node:pure:compile:linux_arm:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
+  "build:node:pure:compile:linux_arm:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
+  "build:node:pure:compile:linux_arm:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-linux-arm64 .dinou/node/server.mjs --outfile dist/server-linux-arm",
+  "build:node:pure:compile:mac": "npm run build:node:pure:compile:mac:esbuild",
+  "build:node:pure:compile:mac:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
+  "build:node:pure:compile:mac:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
+  "build:node:pure:compile:mac:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-darwin-arm64 .dinou/node/server.mjs --outfile dist/server-mac",
+  "build:node:pure:compile:win": "npm run build:node:pure:compile:win:esbuild",
+  "build:node:pure:compile:win:esbuild": "cross-env NODE_ENV=production bun dinou/esbuild/build.mjs && bun ./dinou/node/build.mjs && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
+  "build:node:pure:compile:win:rollup": "cross-env NODE_ENV=production rollup -c ./dinou/rollup/rollup.config.js && bun ./dinou/node/build.mjs && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
+  "build:node:pure:compile:win:webpack": "cross-env NODE_ENV=production webpack --config dinou/webpack/webpack.config.js && cross-env DINOU_BUILD_TOOL=webpack bun ./dinou/node/build.mjs && bun build --compile --target=bun-windows-x64 .dinou/node/server.mjs --outfile dist/server-win",
   "start:node": "cross-env NODE_ENV=production node dinou/adapters/node.mjs",
   "start:node:esbuild": "npm run start:node",
   "start:node:rollup": "npm run start:node",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dinou",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "description": "Full-stack React 19 framework with native RSC, Server Functions, progressive streaming, and zero vendor lock-in.",
   "main": "index.js",
   "bin": {