@taujs/server 0.5.3 → 0.5.4

package/dist/index.js

@@ -99,62 +99,19 @@ var require_picocolors = __commonJS({
 
 // src/CreateServer.ts
 var import_picocolors4 = __toESM(require_picocolors(), 1);
-import path5 from "path";
-import { performance as performance3 } from "perf_hooks";
-import Fastify from "fastify";
-
-// src/Setup.ts
+import path6 from "path";
 import { performance } from "perf_hooks";
+import Fastify from "fastify";
 
-// src/constants.ts
-var import_picocolors = __toESM(require_picocolors(), 1);
-var RENDERTYPE = {
-  ssr: "ssr",
-  streaming: "streaming"
-};
-var SSRTAG = {
-  ssrHead: "<!--ssr-head-->",
-  ssrHtml: "<!--ssr-html-->"
-};
-var TEMPLATE = {
-  defaultEntryClient: "entry-client",
-  defaultEntryServer: "entry-server",
-  defaultHtmlTemplate: "index.html"
-};
-var DEV_CSP_DIRECTIVES = {
-  "default-src": ["'self'"],
-  "connect-src": ["'self'", "ws:", "http:"],
-  "style-src": ["'self'", "'unsafe-inline'"],
-  "img-src": ["'self'", "data:"]
-};
-var CONTENT = {
-  TAG: "\u03C4js"
-};
-var DEBUG = {
-  auth: { label: "auth", colour: import_picocolors.default.blue },
-  csp: { label: "csp", colour: import_picocolors.default.yellow },
-  errors: { label: "errors", colour: import_picocolors.default.red },
-  routes: { label: "routes", colour: import_picocolors.default.cyan },
-  security: { label: "security", colour: import_picocolors.default.yellow },
-  trx: { label: "trx", colour: import_picocolors.default.magenta },
-  vite: { label: "vite", colour: import_picocolors.default.yellow }
-};
-var REGEX = {
-  BENIGN_NET_ERR: /\b(?:ECONNRESET|EPIPE|ECONNABORTED)\b|socket hang up|aborted|premature(?: close)?/i,
-  SAFE_TRACE: /^[a-zA-Z0-9-_:.]{1,128}$/
-};
-var ENTRY_EXTENSIONS = [".ts", ".tsx"];
+// src/core/telemetry/Telemetry.ts
+var now = () => globalThis.performance?.now?.() ?? Date.now();
 
-// src/Setup.ts
+// src/core/config/Setup.ts
 var extractBuildConfigs = (config) => {
-  return config.apps.map(({ appId, entryPoint, plugins }) => ({
-    appId,
-    entryPoint,
-    plugins
-  }));
+  return config.apps.map(({ appId, entryPoint, plugins }) => ({ appId, entryPoint, plugins }));
 };
 var extractRoutes = (taujsConfig) => {
-  const t0 = performance.now();
+  const t0 = now();
   const allRoutes = [];
   const apps = [];
   const warnings = [];
@@ -173,7 +130,7 @@ var extractRoutes = (taujsConfig) => {
     if (appIds.length > 1) warnings.push(`Route path "${path7}" is declared in multiple apps: ${appIds.join(", ")}`);
   }
   const sortedRoutes = allRoutes.sort((a, b) => computeScore(b.path) - computeScore(a.path));
-  const durationMs = performance.now() - t0;
+  const durationMs = now() - t0;
   return {
     routes: sortedRoutes,
     apps,
@@ -183,7 +140,7 @@ var extractRoutes = (taujsConfig) => {
   };
 };
 var extractSecurity = (taujsConfig) => {
-  const t0 = performance.now();
+  const t0 = now();
   const user = taujsConfig.security ?? {};
   const userCsp = user.csp;
   const hasExplicitCSP = !!userCsp;
@@ -204,7 +161,7 @@ var extractSecurity = (taujsConfig) => {
     hasReporting: !!normalisedCsp?.reporting?.endpoint,
     reportOnly: !!normalisedCsp?.reporting?.reportOnly
   };
-  const durationMs = performance.now() - t0;
+  const durationMs = now() - t0;
   return {
     security,
     durationMs,
@@ -212,58 +169,11 @@ var extractSecurity = (taujsConfig) => {
     summary
   };
 };
-function printConfigSummary(logger, apps, configsCount, totalRoutes, durationMs, warnings) {
-  logger.info({}, `${CONTENT.TAG} [config] Loaded ${configsCount} app(s), ${totalRoutes} route(s) in ${durationMs.toFixed(1)}ms`);
-  apps.forEach((a) => logger.debug("routes", {}, `\u2022 ${a.appId}: ${a.routeCount} route(s)`));
-  warnings.forEach((w) => logger.warn({}, `${CONTENT.TAG} [warn] ${w}`));
-}
-function printSecuritySummary(logger, routes, security, hasExplicitCSP, securityDurationMs) {
-  const total = routes.length;
-  const disabled = routes.filter((r) => r.attr?.middleware?.csp === false).length;
-  const custom = routes.filter((r) => {
-    const v = r.attr?.middleware?.csp;
-    return v !== void 0 && v !== false;
-  }).length;
-  const enabled = total - disabled;
-  const hasReporting = !!security.csp?.reporting?.endpoint;
-  const mode = security.csp?.defaultMode ?? "merge";
-  let status = "configured";
-  let detail = "";
-  if (hasExplicitCSP) {
-    detail = `explicit, mode=${mode}`;
-    if (hasReporting) detail += ", reporting";
-    if (custom > 0) detail += `, ${custom} route override(s)`;
-  } else {
-    if (process.env.NODE_ENV === "production") {
-      logger.warn({}, "(consider explicit config for production)");
-    }
-  }
-  logger.info({}, `${CONTENT.TAG} [security] CSP ${status} (${enabled}/${total} routes) in ${securityDurationMs.toFixed(1)}ms`);
-}
-function printContractReport(logger, report) {
-  for (const r of report.items) {
-    const line = `${CONTENT.TAG} [security][${r.key}] ${r.message}`;
-    if (r.status === "error") {
-      logger.error({}, line);
-    } else if (r.status === "warning") {
-      logger.warn({}, line);
-    } else if (r.status === "skipped") {
-      logger.debug(r.key, {}, line);
-    } else {
-      logger.info({}, line);
-    }
-  }
-}
 var computeScore = (path7) => {
   return path7.split("/").filter(Boolean).reduce((score, segment) => score + (segment.startsWith(":") ? 1 : 10), 0);
 };
-function printVitePluginSummary(logger, appPlugins, merged) {
-  const mergedNames = merged.map((p) => p?.name).filter((n) => typeof n === "string" && n.length > 0);
-  const appsLine = appPlugins.length === 0 ? "no app plugins" : appPlugins.map((a) => `${a.appId}=[${a.plugins.join(", ") || "none"}]`).join(" ");
-  logger.info(void 0, `${CONTENT.TAG} [vite] Plugins ${appsLine} merged=[${mergedNames.join(", ") || "none"}]`);
-}
 
-// src/logging/AppError.ts
+// src/core/errors/AppError.ts
 var HTTP_STATUS = {
   infra: 500,
   upstream: 502,
@@ -387,6 +297,40 @@ function toReason(e) {
   return new Error(String(e));
 }
 
+// src/constants.ts
+var import_picocolors = __toESM(require_picocolors(), 1);
+var SSRTAG = {
+  ssrHead: "<!--ssr-head-->",
+  ssrHtml: "<!--ssr-html-->"
+};
+var TEMPLATE = {
+  defaultEntryClient: "entry-client",
+  defaultEntryServer: "entry-server",
+  defaultHtmlTemplate: "index.html"
+};
+var ENTRY_EXTENSIONS = [".ts", ".tsx"];
+var DEV_CSP_DIRECTIVES = {
+  "default-src": ["'self'"],
+  "connect-src": ["'self'", "ws:", "http:"],
+  "style-src": ["'self'", "'unsafe-inline'"],
+  "img-src": ["'self'", "data:"]
+};
+var CONTENT = {
+  TAG: "\u03C4js"
+};
+var DEBUG = {
+  auth: { label: "auth", colour: import_picocolors.default.blue },
+  csp: { label: "csp", colour: import_picocolors.default.yellow },
+  errors: { label: "errors", colour: import_picocolors.default.red },
+  routes: { label: "routes", colour: import_picocolors.default.cyan },
+  security: { label: "security", colour: import_picocolors.default.yellow },
+  trx: { label: "trx", colour: import_picocolors.default.magenta },
+  vite: { label: "vite", colour: import_picocolors.default.yellow }
+};
+var REGEX = {
+  BENIGN_NET_ERR: /\b(?:ECONNRESET|EPIPE|ECONNABORTED)\b|socket hang up|aborted|premature(?: close)?/i
+};
+
 // src/logging/Logger.ts
 var import_picocolors2 = __toESM(require_picocolors(), 1);
 
@@ -451,8 +395,10 @@ function parseDebugInput(input) {
   return input;
 }
 
-// src/logging/Logger.ts
+// src/core/logging/types.ts
 var DEBUG_CATEGORIES = ["auth", "routes", "errors", "vite", "network", "ssr"];
+
+// src/logging/Logger.ts
 var Logger = class _Logger {
   constructor(config = {}) {
     this.config = config;
@@ -512,12 +458,12 @@ var Logger = class _Logger {
     return copy;
   }
   formatTimestamp() {
-    const now = /* @__PURE__ */ new Date();
-    if (process.env.NODE_ENV === "production") return now.toISOString();
-    const hours = String(now.getHours()).padStart(2, "0");
-    const minutes = String(now.getMinutes()).padStart(2, "0");
-    const seconds = String(now.getSeconds()).padStart(2, "0");
-    const millis = String(now.getMilliseconds()).padStart(3, "0");
+    const now2 = /* @__PURE__ */ new Date();
+    if (process.env.NODE_ENV === "production") return now2.toISOString();
+    const hours = String(now2.getHours()).padStart(2, "0");
+    const minutes = String(now2.getMinutes()).padStart(2, "0");
+    const seconds = String(now2.getSeconds()).padStart(2, "0");
+    const millis = String(now2.getMilliseconds()).padStart(3, "0");
     return `${hours}:${minutes}:${seconds}.${millis}`;
   }
   emit(level, message, meta, category) {
@@ -765,48 +711,79 @@ var verifyContracts = (app, routes, contracts, security) => {
   return { items };
 };
 
+// src/Setup.ts
+function printConfigSummary(logger, apps, configsCount, totalRoutes, durationMs, warnings) {
+  logger.info({}, `${CONTENT.TAG} [config] Loaded ${configsCount} app(s), ${totalRoutes} route(s) in ${durationMs.toFixed(1)}ms`);
+  apps.forEach((a) => logger.debug("routes", {}, `\u2022 ${a.appId}: ${a.routeCount} route(s)`));
+  warnings.forEach((w) => logger.warn({}, `${CONTENT.TAG} [warn] ${w}`));
+}
+function printSecuritySummary(logger, routes, security, hasExplicitCSP, securityDurationMs) {
+  const total = routes.length;
+  const disabled = routes.filter((r) => r.attr?.middleware?.csp === false).length;
+  const custom = routes.filter((r) => {
+    const v = r.attr?.middleware?.csp;
+    return v !== void 0 && v !== false;
+  }).length;
+  const enabled = total - disabled;
+  const hasReporting = !!security.csp?.reporting?.endpoint;
+  const mode = security.csp?.defaultMode ?? "merge";
+  let status = "configured";
+  let detail = "";
+  if (hasExplicitCSP) {
+    detail = `explicit, mode=${mode}`;
+    if (hasReporting) detail += ", reporting";
+    if (custom > 0) detail += `, ${custom} route override(s)`;
+  } else {
+    if (process.env.NODE_ENV === "production") {
+      logger.warn({}, "(consider explicit config for production)");
+    }
+  }
+  logger.info({}, `${CONTENT.TAG} [security] CSP ${status} (${enabled}/${total} routes) in ${securityDurationMs.toFixed(1)}ms`);
+}
+function printContractReport(logger, report) {
+  for (const r of report.items) {
+    const line = `${CONTENT.TAG} [security][${r.key}] ${r.message}`;
+    if (r.status === "error") {
+      logger.error({}, line);
+    } else if (r.status === "warning") {
+      logger.warn({}, line);
+    } else if (r.status === "skipped") {
+      logger.debug(r.key, {}, line);
+    } else {
+      logger.info({}, line);
+    }
+  }
+}
+function printVitePluginSummary(logger, appPlugins, merged) {
+  const mergedNames = merged.map((p) => p?.name).filter((n) => typeof n === "string" && n.length > 0);
+  const appsLine = appPlugins.length === 0 ? "no app plugins" : appPlugins.map((a) => `${a.appId}=[${a.plugins.join(", ") || "none"}]`).join(" ");
+  logger.info(void 0, `${CONTENT.TAG} [vite] Plugins ${appsLine} merged=[${mergedNames.join(", ") || "none"}]`);
+}
+
 // src/SSRServer.ts
 import fp3 from "fastify-plugin";
 
-// src/logging/utils/index.ts
-var httpStatusFrom = (err, fallback = 500) => err instanceof AppError ? err.httpStatus : fallback;
-var toHttp = (err) => {
-  const app = AppError.from(err);
-  const status = httpStatusFrom(app);
-  const errorMessage = app.safeMessage;
-  return {
-    status,
-    body: {
-      error: errorMessage,
-      ...app.code && { code: app.code },
-      statusText: statusText(status)
-    }
-  };
-};
-var statusText = (status) => {
-  const map = {
-    400: "Bad Request",
-    401: "Unauthorized",
-    403: "Forbidden",
-    404: "Not Found",
-    405: "Method Not Allowed",
-    408: "Request Timeout",
-    422: "Unprocessable Entity",
-    429: "Too Many Requests",
-    499: "Client Closed Request",
-    500: "Internal Server Error",
-    502: "Bad Gateway",
-    503: "Service Unavailable",
-    504: "Gateway Timeout"
-  };
-  return map[status] ?? "Error";
+// src/core/routes/DataRoutes.ts
+import { match } from "path-to-regexp";
+
+// src/core/logging/noop.ts
+var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  },
+  child: () => noopLogger,
+  isDebugEnabled: () => false
 };
 
-// src/utils/DataRoutes.ts
-import { match } from "path-to-regexp";
+// src/core/logging/resolve.ts
+var resolveLogs = (logger) => logger ?? noopLogger;
 
-// src/utils/DataServices.ts
-import { performance as performance2 } from "perf_hooks";
+// src/core/services/DataServices.ts
 function createCaller(registry, ctx) {
   return (serviceName, methodName, args) => callServiceMethod(registry, serviceName, methodName, args ?? {}, ctx);
 }
@@ -819,26 +796,27 @@ async function callServiceMethod(registry, serviceName, methodName, params, ctx)
   if (!service) throw AppError.notFound(`Unknown service: ${serviceName}`);
   const method = service[methodName];
   if (!method) throw AppError.notFound(`Unknown method: ${serviceName}.${methodName}`);
-  const logger = ctx.logger?.child?.({
+  const baseLogger = resolveLogs(ctx.logger);
+  const logger = baseLogger.child({
     component: "service-call",
     service: serviceName,
     method: methodName,
     traceId: ctx.traceId
   });
-  const t0 = performance2.now();
+  const t0 = now();
   try {
     const result = await method(params ?? {}, ctx);
     if (typeof result !== "object" || result === null) {
       throw AppError.internal(`Non-object result from ${serviceName}.${methodName}`);
     }
-    logger?.debug?.({ ms: +(performance2.now() - t0).toFixed(1) }, "Service method ok");
+    logger.debug({ ms: +(now() - t0).toFixed(1) }, "Service method ok");
     return result;
   } catch (err) {
-    logger?.error?.(
+    logger.error(
       {
         params,
         error: err instanceof Error ? { name: err.name, message: err.message, stack: err.stack } : String(err),
-        ms: +(performance2.now() - t0).toFixed(1)
+        ms: +(now() - t0).toFixed(1)
       },
       "Service method failed"
     );
@@ -855,7 +833,7 @@ var isServiceDescriptor = (obj) => {
   return true;
 };
 
-// src/utils/DataRoutes.ts
+// src/core/routes/DataRoutes.ts
 var safeDecode = (value) => {
   try {
     return decodeURIComponent(value);
@@ -953,43 +931,86 @@ var fetchInitialData = async (attr, params, serviceRegistry, ctx, callServiceMet
   }
 };
 
-// src/security/Auth.ts
-var createAuthHook = (routeMatchers, logger) => {
-  return async function authHook(req, reply) {
-    const url = new URL(req.url, `http://${req.headers.host}`).pathname;
-    const match2 = matchRoute(url, routeMatchers);
-    if (!match2) return;
-    const { route } = match2;
-    const authConfig = route.attr?.middleware?.auth;
-    req.routeMeta = {
-      path: route.path,
-      appId: route.appId,
-      attr: {
-        middleware: {
-          auth: route.attr?.middleware?.auth
-        },
-        render: route.attr?.render
-      }
-    };
-    if (!authConfig) {
-      logger.debug("auth", { method: req.method, url: req.url }, "(none)");
-      return;
-    }
-    if (typeof req.server.authenticate !== "function") {
-      logger.warn(
-        {
-          path: url,
-          appId: route.appId
-        },
-        "Route requires auth but Fastify authenticate decorator is missing"
-      );
-      return reply.status(500).send("Server misconfiguration: auth decorator missing.");
-    }
-    try {
-      logger.debug("auth", { method: req.method, url: req.url }, "Invoking authenticate(...)");
-      await req.server.authenticate(req, reply);
-      logger.debug("auth", { method: req.method, url: req.url }, "Authentication successful");
-    } catch (err) {
+// src/System.ts
+import { dirname, join } from "path";
+import "path";
+import { fileURLToPath } from "url";
+var isDevelopment = process.env.NODE_ENV === "development";
+var __filename = fileURLToPath(import.meta.url);
+var DIR_SUFFIX = isDevelopment ? ".." : "./";
+var __dirname = join(dirname(__filename), DIR_SUFFIX);
+
+// src/logging/utils/index.ts
+var httpStatusFrom = (err, fallback = 500) => err instanceof AppError ? err.httpStatus : fallback;
+var toHttp = (err) => {
+  const app = AppError.from(err);
+  const status = httpStatusFrom(app);
+  const errorMessage = app.safeMessage;
+  return {
+    status,
+    body: {
+      error: errorMessage,
+      ...app.code && { code: app.code },
+      statusText: statusText(status)
+    }
+  };
+};
+var statusText = (status) => {
+  const map = {
+    400: "Bad Request",
+    401: "Unauthorized",
+    403: "Forbidden",
+    404: "Not Found",
+    405: "Method Not Allowed",
+    408: "Request Timeout",
+    422: "Unprocessable Entity",
+    429: "Too Many Requests",
+    499: "Client Closed Request",
+    500: "Internal Server Error",
+    502: "Bad Gateway",
+    503: "Service Unavailable",
+    504: "Gateway Timeout"
+  };
+  return map[status] ?? "Error";
+};
+
+// src/security/Auth.ts
+var createAuthHook = (routeMatchers, logger) => {
+  return async function authHook(req, reply) {
+    const url = new URL(req.url, `http://${req.headers.host}`).pathname;
+    const match2 = matchRoute(url, routeMatchers);
+    if (!match2) return;
+    const { route } = match2;
+    const authConfig = route.attr?.middleware?.auth;
+    req.routeMeta = {
+      path: route.path,
+      appId: route.appId,
+      attr: {
+        middleware: {
+          auth: route.attr?.middleware?.auth
+        },
+        render: route.attr?.render
+      }
+    };
+    if (!authConfig) {
+      logger.debug("auth", { method: req.method, url: req.url }, "(none)");
+      return;
+    }
+    if (typeof req.server.authenticate !== "function") {
+      logger.warn(
+        {
+          path: url,
+          appId: route.appId
+        },
+        "Route requires auth but Fastify authenticate decorator is missing"
+      );
+      return reply.status(500).send("Server misconfiguration: auth decorator missing.");
+    }
+    try {
+      logger.debug("auth", { method: req.method, url: req.url }, "Invoking authenticate(...)");
+      await req.server.authenticate(req, reply);
+      logger.debug("auth", { method: req.method, url: req.url }, "Authentication successful");
+    } catch (err) {
       logger.debug("auth", { method: req.method, url: req.url }, "Authentication failed");
       return reply.send(err);
     }
@@ -999,16 +1020,6 @@ var createAuthHook = (routeMatchers, logger) => {
 // src/security/CSP.ts
 import fp from "fastify-plugin";
 import crypto from "crypto";
-
-// src/utils/System.ts
-import { dirname, join } from "path";
-import "path";
-import { fileURLToPath } from "url";
-var isDevelopment = process.env.NODE_ENV === "development";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = join(dirname(__filename), !isDevelopment ? "./" : "..");
-
-// src/security/CSP.ts
 var defaultGenerateCSP = (directives, nonce, req) => {
   const merged = { ...directives };
   merged["script-src"] = merged["script-src"] || ["'self'"];
@@ -1232,7 +1243,6 @@ var cspReportPlugin = fp2(
 );
 
 // src/utils/AssetManager.ts
-import { existsSync } from "fs";
 import { readFile } from "fs/promises";
 import path2 from "path";
 import { pathToFileURL } from "url";
@@ -1344,14 +1354,6 @@ var rebuildTemplate = (parts, headContent, bodyContent) => {
 };
 
 // src/utils/AssetManager.ts
-function resolveEntryFile(clientRoot, stem) {
-  for (const ext of ENTRY_EXTENSIONS) {
-    const filename = `${stem}${ext}`;
-    const absPath = path2.join(clientRoot, filename);
-    if (existsSync(absPath)) return filename;
-  }
-  throw new Error(`Entry file "${stem}" not found in ${clientRoot}. Tried: ${ENTRY_EXTENSIONS.map((e) => stem + e).join(", ")}`);
-}
 var createMaps = () => ({
   bootstrapModules: /* @__PURE__ */ new Map(),
   cssLinks: /* @__PURE__ */ new Map(),
@@ -1364,108 +1366,104 @@ var createMaps = () => ({
 var processConfigs = (configs, baseClientRoot, templateDefaults) => {
   return configs.map((config) => {
     const clientRoot = path2.resolve(baseClientRoot, config.entryPoint);
-    const entryClient = config.entryClient || templateDefaults.defaultEntryClient;
-    const entryServer = config.entryServer || templateDefaults.defaultEntryServer;
-    const entryClientFile = resolveEntryFile(clientRoot, entryClient);
-    const entryServerFile = resolveEntryFile(clientRoot, entryServer);
     return {
       clientRoot,
       entryPoint: config.entryPoint,
-      entryClient,
-      entryServer,
+      entryClient: config.entryClient || templateDefaults.defaultEntryClient,
+      // stem
+      entryServer: config.entryServer || templateDefaults.defaultEntryServer,
+      // stem
       htmlTemplate: config.htmlTemplate || templateDefaults.defaultHtmlTemplate,
       appId: config.appId,
-      plugins: config.plugins ?? [],
-      entryClientFile,
-      entryServerFile
+      plugins: config.plugins ?? []
     };
   });
 };
+var logAssetError = (logger, stage, err) => {
+  if (err instanceof AppError) {
+    logger.error(
+      {
+        error: {
+          name: err.name,
+          message: err.message,
+          stack: err.stack,
+          code: err.code
+        },
+        stage
+      },
+      "Asset load failed"
+    );
+    return;
+  }
+  logger.error(
+    {
+      error: err instanceof Error ? { name: err.name, message: err.message, stack: err.stack } : String(err),
+      stage
+    },
+    "Asset load failed"
+  );
+};
+var findManifestEntry = (manifest, stem) => {
+  for (const ext of ENTRY_EXTENSIONS) {
+    const entry = manifest[`${stem}${ext}`];
+    if (entry?.file) return entry;
+  }
+  return null;
+};
 var loadAssets = async (processedConfigs, baseClientRoot, bootstrapModules, cssLinks, manifests, preloadLinks, renderModules, ssrManifests, templates, opts = {}) => {
-  const logger = opts.logger ?? createLogger({
-    debug: opts.debug,
-    includeContext: true
-  });
+  const logger = resolveLogs(opts.logger);
   for (const config of processedConfigs) {
-    const { clientRoot, entryClient, entryServer, htmlTemplate, entryPoint, entryClientFile, entryServerFile } = config;
+    const { clientRoot, entryServer, entryClient, htmlTemplate, entryPoint } = config;
     try {
       const templateHtmlPath = path2.join(clientRoot, htmlTemplate);
-      const templateHtml = await readFile(templateHtmlPath, "utf-8");
-      templates.set(clientRoot, templateHtml);
+      templates.set(clientRoot, await readFile(templateHtmlPath, "utf-8"));
       const relativeBasePath = path2.relative(baseClientRoot, clientRoot).replace(/\\/g, "/");
       const adjustedRelativePath = relativeBasePath ? `/${relativeBasePath}` : "";
-      if (!isDevelopment) {
-        try {
-          const distRoot = path2.dirname(baseClientRoot);
-          const ssrRoot = path2.join(distRoot, "ssr");
-          const clientDistPath = path2.join(baseClientRoot, entryPoint);
-          const manifestPath = path2.join(clientDistPath, ".vite/manifest.json");
-          const manifestContent = await readFile(manifestPath, "utf-8");
-          const manifest = JSON.parse(manifestContent);
-          manifests.set(clientRoot, manifest);
-          const ssrDistPath = path2.join(ssrRoot, entryPoint);
-          const ssrManifestPath = path2.join(ssrDistPath, ".vite/ssr-manifest.json");
-          const ssrManifestContent = await readFile(ssrManifestPath, "utf-8");
-          const ssrManifest = JSON.parse(ssrManifestContent);
-          ssrManifests.set(clientRoot, ssrManifest);
-          const manifestEntry = manifest[entryClientFile];
-          if (!manifestEntry?.file) {
-            throw AppError.internal(`Entry client file not found in manifest for ${entryClientFile}`, {
-              details: {
-                clientRoot,
-                entryClientFile,
-                availableKeys: Object.keys(manifest)
-              }
-            });
-          }
-          const bootstrapModule = `/${adjustedRelativePath}/${manifestEntry.file}`.replace(/\/{2,}/g, "/");
-          bootstrapModules.set(clientRoot, bootstrapModule);
-          const preloadLink = renderPreloadLinks(ssrManifest, adjustedRelativePath);
-          preloadLinks.set(clientRoot, preloadLink);
-          const cssLink = getCssLinks(manifest, adjustedRelativePath);
-          cssLinks.set(clientRoot, cssLink);
-          const renderModulePath = path2.join(ssrDistPath, `${entryServer}.js`);
-          const moduleUrl = pathToFileURL(renderModulePath).href;
-          try {
-            const importedModule = await import(moduleUrl);
-            renderModules.set(clientRoot, importedModule);
-          } catch (err) {
-            throw AppError.internal(`Failed to load render module ${renderModulePath}`, {
-              cause: err,
-              details: { moduleUrl, clientRoot, entryServer, ssrDistPath }
-            });
-          }
-        } catch (err) {
-          if (err instanceof AppError) {
-            logger.error(
-              {
-                error: { name: err.name, message: err.message, stack: err.stack, code: err.code },
-                stage: "loadAssets:production"
-              },
-              "Asset load failed"
-            );
-          } else {
-            logger.error(
-              {
-                error: err instanceof Error ? { name: err.name, message: err.message, stack: err.stack } : String(err),
-                stage: "loadAssets:production"
-              },
-              "Asset load failed"
-            );
+      if (isDevelopment) {
+        const bootstrapModule2 = `/${adjustedRelativePath}/${entryClient}`.replace(/\/{2,}/g, "/");
+        bootstrapModules.set(clientRoot, bootstrapModule2);
+        continue;
+      }
+      const distRoot = path2.dirname(baseClientRoot);
+      const ssrRoot = path2.join(distRoot, "ssr");
+      const clientDistPath = path2.join(baseClientRoot, entryPoint);
+      const manifestPath = path2.join(clientDistPath, ".vite/manifest.json");
+      const manifest = JSON.parse(await readFile(manifestPath, "utf-8"));
+      manifests.set(clientRoot, manifest);
+      const ssrDistPath = path2.join(ssrRoot, entryPoint);
+      const ssrManifestPath = path2.join(ssrDistPath, ".vite/ssr-manifest.json");
+      const ssrManifest = JSON.parse(await readFile(ssrManifestPath, "utf-8"));
+      ssrManifests.set(clientRoot, ssrManifest);
+      const manifestEntry = findManifestEntry(manifest, entryClient);
+      if (!manifestEntry?.file) {
+        throw AppError.internal(`Entry "${entryClient}" not found in manifest`, {
+          details: {
+            tried: ENTRY_EXTENSIONS.map((e) => `${entryClient}${e}`),
+            availableKeys: Object.keys(manifest),
+            clientRoot,
+            entryPoint,
+            manifestPath
           }
-        }
-      } else {
-        const bootstrapModule = `/${adjustedRelativePath}/${entryClientFile}`.replace(/\/{2,}/g, "/");
-        bootstrapModules.set(clientRoot, bootstrapModule);
+        });
+      }
+      const bootstrapModule = `/${adjustedRelativePath}/${manifestEntry.file}`.replace(/\/{2,}/g, "/");
+      bootstrapModules.set(clientRoot, bootstrapModule);
+      preloadLinks.set(clientRoot, renderPreloadLinks(ssrManifest, adjustedRelativePath));
+      cssLinks.set(clientRoot, getCssLinks(manifest, adjustedRelativePath));
+      const renderModulePath = path2.join(ssrDistPath, `${entryServer}.js`);
+      const moduleUrl = pathToFileURL(renderModulePath).href;
+      try {
+        const importedModule = await import(moduleUrl);
+        renderModules.set(clientRoot, importedModule);
+      } catch (err) {
+        throw AppError.internal(`Failed to load render module ${renderModulePath}`, {
+          cause: err,
+          details: { moduleUrl, clientRoot, entryServer, ssrDistPath }
+        });
       }
     } catch (err) {
-      logger.error(
-        {
-          error: err instanceof Error ? { name: err.name, message: err.message, stack: err.stack } : String(err),
-          stage: "loadAssets:config"
-        },
-        "Failed to process config"
-      );
+      logAssetError(logger, isDevelopment ? "loadAssets:development" : "loadAssets:production", err);
+      if (!isDevelopment) throw err;
     }
   }
 };
@@ -1544,27 +1542,284 @@ var setupDevServer = async (app, baseClientRoot, alias, debug, devNet, plugins =
         protocol: "ws"
       }
     }
-  });
-  overrideCSSHMRConsoleError();
-  app.addHook("onRequest", async (request, reply) => {
-    await new Promise((resolve) => {
-      viteDevServer.middlewares(request.raw, reply.raw, () => {
-        if (!reply.sent) resolve();
-      });
-    });
-  });
-  return viteDevServer;
-};
-
-// src/utils/HandleRender.ts
-import path4 from "path";
-import { PassThrough } from "stream";
+  });
+  overrideCSSHMRConsoleError();
+  app.addHook("onRequest", async (request, reply) => {
+    await new Promise((resolve) => {
+      viteDevServer.middlewares(request.raw, reply.raw, () => {
+        if (!reply.sent) resolve();
+      });
+    });
+  });
+  return viteDevServer;
+};
+
+// src/utils/HandleRender.ts
+import path5 from "path";
+import { PassThrough } from "stream";
+
+// src/core/constants.ts
+var RENDERTYPE = {
+  ssr: "ssr",
+  streaming: "streaming"
+};
+var REGEX2 = {
+  SAFE_TRACE: /^[a-zA-Z0-9-_:.]{1,128}$/
+};
+
+// src/Build.ts
+import { existsSync } from "fs";
+import * as fs from "fs";
+import path4 from "path";
+import { build } from "vite";
+function resolveInputs(isSSRBuild, mainExists, paths) {
+  if (isSSRBuild) return { server: paths.server };
+  if (mainExists) return { client: paths.client, main: paths.main };
+  return { client: paths.client };
+}
+function resolveEntryFile(clientRoot, stem, exists = fs.existsSync) {
+  for (const ext of ENTRY_EXTENSIONS) {
+    const filename = `${stem}${ext}`;
+    if (exists(path4.join(clientRoot, filename))) return filename;
+  }
+  throw new Error(`Entry file "${stem}" not found in ${clientRoot}. Tried: ${ENTRY_EXTENSIONS.map((e) => stem + e).join(", ")}`);
+}
+function getFrameworkInvariants(config) {
+  return {
+    root: config.root || "",
+    base: config.base || "/",
+    publicDir: config.publicDir === void 0 ? "public" : config.publicDir,
+    build: {
+      outDir: config.build?.outDir || "",
+      manifest: config.build?.manifest ?? false,
+      ssr: config.build?.ssr ?? void 0,
+      // Preserve exact type
+      ssrManifest: config.build?.ssrManifest ?? false,
+      format: config.build?.format,
+      target: config.build?.target,
+      rollupOptions: {
+        input: config.build?.rollupOptions?.input || {}
+      }
+    }
+  };
+}
+var normalisePlugins = (p) => Array.isArray(p) ? p : p ? [p] : [];
+function mergeViteConfig(framework, userOverride, context) {
+  if (!userOverride) return framework;
+  const userConfig = typeof userOverride === "function" && context ? userOverride(context) : userOverride;
+  const invariants = getFrameworkInvariants(framework);
+  const merged = {
+    ...framework,
+    build: { ...framework.build ?? {} },
+    css: { ...framework.css ?? {} },
+    resolve: { ...framework.resolve ?? {} },
+    plugins: [...framework.plugins ?? []],
+    define: { ...framework.define ?? {} }
+  };
+  const ignoredKeys = [];
+  if (userConfig.plugins) merged.plugins = [...normalisePlugins(merged.plugins), ...normalisePlugins(userConfig.plugins)];
+  if (userConfig.define && typeof userConfig.define === "object") merged.define = { ...merged.define, ...userConfig.define };
+  if (userConfig.css?.preprocessorOptions) {
+    const fpp = merged.css?.preprocessorOptions ?? {};
+    const upp = userConfig.css.preprocessorOptions;
+    merged.css ??= {};
+    merged.css.preprocessorOptions ??= {};
+    merged.css.preprocessorOptions = Object.keys({ ...fpp, ...upp }).reduce((acc, engine) => {
+      acc[engine] = {
+        ...fpp[engine],
+        ...upp[engine]
+      };
+      return acc;
+    }, {});
+  }
+  if (userConfig.build) {
+    const protectedBuildFields = ["outDir", "ssr", "ssrManifest", "format", "target"];
+    for (const field of protectedBuildFields) {
+      if (field in userConfig.build) ignoredKeys.push(`build.${field}`);
+    }
+    if ("sourcemap" in userConfig.build) merged.build.sourcemap = userConfig.build.sourcemap;
+    if ("minify" in userConfig.build) merged.build.minify = userConfig.build.minify;
+    if (userConfig.build.terserOptions) {
+      merged.build.terserOptions = {
+        ...merged.build.terserOptions,
+        ...userConfig.build.terserOptions
+      };
+    }
+    if (userConfig.build.rollupOptions) {
+      const userRollup = userConfig.build.rollupOptions;
+      const ro = merged.build.rollupOptions ??= {};
+      if ("input" in userRollup) ignoredKeys.push("build.rollupOptions.input");
+      if ("external" in userRollup) ro.external = userRollup.external;
+      if (userRollup.output) {
+        const uo = Array.isArray(userRollup.output) ? userRollup.output[0] : userRollup.output;
+        ro.output = {
+          ...Array.isArray(ro.output) ? ro.output[0] : ro.output,
+          ...uo?.manualChunks ? { manualChunks: uo.manualChunks } : {}
+        };
+      }
+    }
+  }
+  if (userConfig.resolve) {
+    const { alias: _ignore, ...rest } = userConfig.resolve;
+    if (_ignore) ignoredKeys.push("resolve.alias");
+    merged.resolve = { ...merged.resolve, ...rest };
+  }
+  if (userConfig.server) ignoredKeys.push("server");
+  if ("root" in userConfig) ignoredKeys.push("root");
+  if ("base" in userConfig) ignoredKeys.push("base");
+  if ("publicDir" in userConfig) ignoredKeys.push("publicDir");
+  for (const key of ["esbuild", "logLevel", "envPrefix", "optimizeDeps", "ssr"]) {
+    if (key in userConfig) merged[key] = userConfig[key];
+  }
+  merged.root = invariants.root;
+  merged.base = invariants.base;
+  merged.publicDir = invariants.publicDir;
+  merged.build.outDir = invariants.build.outDir;
+  merged.build.manifest = invariants.build.manifest;
+  merged.build.ssr = invariants.build.ssr;
+  merged.build.ssrManifest = invariants.build.ssrManifest;
+  merged.build.format = invariants.build.format;
+  merged.build.target = invariants.build.target;
+  if (invariants.build.ssr === void 0) delete merged.build.ssr;
+  if (invariants.build.format === void 0) delete merged.build.format;
+  if (invariants.build.target === void 0) delete merged.build.target;
+  (merged.build.rollupOptions ??= {}).input = invariants.build.rollupOptions.input;
+  if (ignoredKeys.length > 0) {
+    const prefix = context ? `[taujs:build:${context.entryPoint}]` : "[taujs:build]";
+    console.warn(`${prefix} Ignored Vite config overrides: ${[...new Set(ignoredKeys)].join(", ")}`);
+  }
+  return merged;
+}
+function resolveAppFilter(argv, env) {
+  const read = (keys) => {
+    const end = argv.indexOf("--");
+    const limit = end === -1 ? argv.length : end;
+    for (let i = 0; i < limit; i++) {
+      const arg = argv[i];
+      if (!arg) continue;
+      for (const key of keys) {
+        if (arg === key) {
+          const next = argv[i + 1];
+          if (!next || next.startsWith("-")) return "";
+          return next.trim();
+        }
+        const pref = `${key}=`;
+        if (arg.startsWith(pref)) {
+          const v = arg.slice(pref.length).trim();
+          return v;
+        }
+      }
+    }
+    return void 0;
+  };
+  const envFilter = env.TAUJS_APP || env.TAUJS_APPS;
+  const cliFilter = read(["--app", "--apps", "-a"]);
+  const raw = (cliFilter ?? envFilter)?.trim() || void 0;
+  if (!raw) return { selectedIds: null, raw: void 0 };
+  const selectedIds = new Set(
+    raw.split(",").map((s) => s.trim()).filter(Boolean)
+  );
+  return { selectedIds, raw };
+}
+async function taujsBuild({
+  config,
+  projectRoot,
+  clientBaseDir,
+  isSSRBuild = process.env.BUILD_MODE === "ssr",
+  alias: userAlias,
+  vite: userViteConfig
+}) {
+  const deleteDist = async () => {
+    const { rm } = await import("fs/promises");
+    const distPath = path4.resolve(projectRoot, "dist");
+    try {
+      await rm(distPath, { recursive: true, force: true });
+      console.log("Deleted the dist directory\n");
+    } catch (err) {
+      console.error("Error deleting dist directory:", err);
+    }
+  };
+  const extractedConfigs = extractBuildConfigs(config);
+  const processedConfigs = processConfigs(extractedConfigs, clientBaseDir, TEMPLATE);
+  const { selectedIds, raw: appFilterRaw } = resolveAppFilter(process.argv.slice(2), process.env);
+  const configsToBuild = selectedIds ? processedConfigs.filter(({ appId, entryPoint }) => selectedIds.has(appId) || selectedIds.has(entryPoint)) : processedConfigs;
+  if (selectedIds && configsToBuild.length === 0) {
+    console.error(
+      `[taujs:build] No apps match filter "${appFilterRaw}". Known apps: ${processedConfigs.map((c) => `${c.appId}${c.entryPoint ? ` (entry: ${c.entryPoint})` : ""}`).join(", ")}`
+    );
+    process.exit(1);
+  }
+  if (!isSSRBuild) await deleteDist();
+  for (const appConfig of configsToBuild) {
+    const { appId, entryPoint, clientRoot, entryClient, entryServer, htmlTemplate, plugins = [] } = appConfig;
+    const outDir = path4.resolve(projectRoot, isSSRBuild ? `dist/ssr/${entryPoint}` : `dist/client/${entryPoint}`);
+    const root = entryPoint ? path4.resolve(clientBaseDir, entryPoint) : clientBaseDir;
+    const defaultAlias = {
+      "@client": root,
+      "@server": path4.resolve(projectRoot, "src/server"),
+      "@shared": path4.resolve(projectRoot, "src/shared")
+    };
+    const resolvedAlias = { ...defaultAlias, ...userAlias ?? {} };
+    const entryClientFile = resolveEntryFile(clientRoot, entryClient);
+    const entryServerFile = resolveEntryFile(clientRoot, entryServer);
+    const server = path4.resolve(clientRoot, entryServerFile);
+    const client = path4.resolve(clientRoot, entryClientFile);
+    const main = path4.resolve(clientRoot, htmlTemplate);
+    const inputs = resolveInputs(isSSRBuild, !isSSRBuild && existsSync(main), { server, client, main });
+    const nodeVersion = process.versions.node.split(".")[0];
+    const frameworkConfig = {
+      base: entryPoint ? `/${entryPoint}/` : "/",
+      build: {
+        outDir,
+        emptyOutDir: true,
+        manifest: !isSSRBuild,
+        rollupOptions: {
+          input: inputs
+        },
+        ssr: isSSRBuild ? server : void 0,
+        ssrManifest: isSSRBuild,
+        ...isSSRBuild && {
+          format: "esm",
+          target: `node${nodeVersion}`,
+          copyPublicDir: false
+        }
+      },
+      css: {
+        preprocessorOptions: {
+          scss: { api: "modern-compiler" }
+        }
+      },
+      plugins,
+      publicDir: isSSRBuild ? false : "public",
+      resolve: { alias: resolvedAlias },
+      root
+    };
+    const buildContext = {
+      appId,
+      entryPoint,
+      isSSRBuild,
+      clientRoot
+    };
+    const finalConfig = mergeViteConfig(frameworkConfig, userViteConfig, buildContext);
+    try {
+      const mode = isSSRBuild ? "SSR" : "Client";
+      console.log(`[taujs:build:${entryPoint}] Building \u2192 ${mode}`);
+      await build(finalConfig);
+      console.log(`[taujs:build:${entryPoint}] \u2713 Complete
+`);
+    } catch (error) {
+      console.error(`[taujs:build:${entryPoint}] \u2717 Failed
+`, error);
+      process.exit(1);
+    }
+  }
+}
 
 // src/utils/Telemetry.ts
 import crypto2 from "crypto";
 function createRequestContext(req, reply, baseLogger) {
   const raw = typeof req.headers["x-trace-id"] === "string" ? req.headers["x-trace-id"] : "";
-  const traceId = raw && REGEX.SAFE_TRACE.test(raw) ? raw : typeof req.id === "string" ? req.id : crypto2.randomUUID();
+  const traceId = raw && REGEX2.SAFE_TRACE.test(raw) ? raw : typeof req.id === "string" ? req.id : crypto2.randomUUID();
   reply.header("x-trace-id", traceId);
   const anyLogger = baseLogger;
   const child = anyLogger.child;
@@ -1615,7 +1870,7 @@ var handleRender = async (req, reply, routeMatchers, processedConfigs, serviceRe
         }
       });
     }
-    const { clientRoot, entryServerFile } = config;
+    const { clientRoot, entryServer } = config;
     let template = ensureNonNull(maps.templates.get(clientRoot), `Template not found for clientRoot: ${clientRoot}`);
     const bootstrapModule = maps.bootstrapModules.get(clientRoot);
     const cssLink = maps.cssLinks.get(clientRoot);
@@ -1627,7 +1882,8 @@ var handleRender = async (req, reply, routeMatchers, processedConfigs, serviceRe
       try {
         template = template.replace(/<script type="module" src="\/@vite\/client"><\/script>/g, "");
         template = template.replace(/<style type="text\/css">[\s\S]*?<\/style>/g, "");
-        const entryServerPath = path4.join(clientRoot, entryServerFile);
+        const entryServerFile = resolveEntryFile(clientRoot, entryServer);
+        const entryServerPath = path5.join(clientRoot, entryServerFile);
         const executedModule = await viteDevServer.ssrLoadModule(entryServerPath);
         renderModule = executedModule;
         const styles = await collectStyle(viteDevServer, [entryServerPath]);
@@ -1635,7 +1891,7 @@ var handleRender = async (req, reply, routeMatchers, processedConfigs, serviceRe
         template = template?.replace("</head>", `<style type="text/css"${styleNonce}>${styles}</style></head>`);
         template = await viteDevServer.transformIndexHtml(url, template);
       } catch (error) {
-        throw AppError.internal("Failed to load dev assets", { cause: error, details: { clientRoot, entryServerFile, url } });
+        throw AppError.internal("Failed to load dev assets", { cause: error, details: { clientRoot, entryServer, url } });
       }
     } else {
       renderModule = maps.renderModules.get(clientRoot);
@@ -1904,28 +2160,30 @@ var handleNotFound = async (req, reply, processedConfigs, maps, opts = {}) => {
   }
 };
 
-// src/utils/ResolveRouteData.ts
-async function resolveRouteData(url, opts) {
-  const { req, reply, routeMatchers, serviceRegistry, logger } = opts;
-  const match2 = matchRoute(url, routeMatchers);
+// src/core/routes/ResolveRouteData.ts
+async function resolveRouteDataCore(url, opts) {
+  const match2 = matchRoute(url, opts.routeMatchers);
   if (!match2) {
-    throw AppError.notFound("route_not_found", {
-      details: { url }
-    });
+    throw AppError.notFound("route_not_found", { details: { url } });
   }
   const { route, params } = match2;
-  const attr = route.attr;
-  if (!attr?.data) {
+  if (!route.attr?.data) {
     throw AppError.notFound("no_data_handler", {
-      details: {
-        url,
-        path: route.path,
-        appId: route.appId
-      }
+      details: { url, path: route.path, appId: route.appId }
     });
   }
-  const ctx = createRequestContext(req, reply, logger);
-  return fetchInitialData(attr, params, serviceRegistry, ctx);
+  const ctx = opts.getCtx();
+  return fetchInitialData(route.attr, params, opts.serviceRegistry, ctx);
+}
+
+// src/utils/ResolveRouteData.ts
+async function resolveRouteData(url, opts) {
+  const { req, reply, routeMatchers, serviceRegistry, logger } = opts;
+  return resolveRouteDataCore(url, {
+    routeMatchers,
+    serviceRegistry,
+    getCtx: () => createRequestContext(req, reply, logger)
+  });
 }
 
 // src/utils/StaticAssets.ts
@@ -2000,10 +2258,7 @@ var SSRServer = fp3(
       maps.renderModules,
       maps.ssrManifests,
       maps.templates,
-      {
-        debug: opts.debug,
-        logger
-      }
+      { logger }
     );
     if (!isDevelopment && !opts.staticAssets) {
       const fastifyStatic = await import("@fastify/static");
@@ -2111,13 +2366,13 @@ var SSRServer = fp3(
 
 // src/CreateServer.ts
 var resolveClientRoot = (userClientRoot) => {
-  if (userClientRoot) return path5.isAbsolute(userClientRoot) ? userClientRoot : path5.resolve(process.cwd(), userClientRoot);
+  if (userClientRoot) return path6.isAbsolute(userClientRoot) ? userClientRoot : path6.resolve(process.cwd(), userClientRoot);
   const cwd = process.cwd();
-  if (process.env.NODE_ENV === "production") return path5.resolve(cwd, "dist/client");
-  return path5.resolve(cwd, "src/client");
+  if (process.env.NODE_ENV === "production") return path6.resolve(cwd, "dist/client");
+  return path6.resolve(cwd, "src/client");
 };
 var createServer = async (opts) => {
-  const t0 = performance3.now();
+  const t0 = performance.now();
   const clientRoot = resolveClientRoot(opts.clientRoot);
   const app = opts.fastify ?? Fastify({ logger: false });
   const fastifyLogger = app.log && app.log.level && app.log.level !== "silent" ? app.log : void 0;
@@ -2178,7 +2433,7 @@ var createServer = async (opts) => {
       "Failed to register SSRServer"
     );
   }
-  const t1 = performance3.now();
+  const t1 = performance.now();
   console.log(`
 ${import_picocolors4.default.bgGreen(import_picocolors4.default.black(` ${CONTENT.TAG} `))} configured in ${(t1 - t0).toFixed(0)}ms
 `);
@@ -2186,264 +2441,11 @@ ${import_picocolors4.default.bgGreen(import_picocolors4.default.black(` ${CONTEN
   return { app, net };
 };
 
-// src/Build.ts
-import { existsSync as existsSync2 } from "fs";
-import path6 from "path";
-import { build } from "vite";
-function resolveInputs(isSSRBuild, mainExists, paths) {
-  if (isSSRBuild) return { server: paths.server };
-  if (mainExists) return { client: paths.client, main: paths.main };
-  return { client: paths.client };
-}
-function getFrameworkInvariants(config) {
-  return {
-    root: config.root || "",
-    base: config.base || "/",
-    publicDir: config.publicDir === void 0 ? "public" : config.publicDir,
-    build: {
-      outDir: config.build?.outDir || "",
-      manifest: config.build?.manifest ?? false,
-      ssr: config.build?.ssr ?? void 0,
-      // Preserve exact type
-      ssrManifest: config.build?.ssrManifest ?? false,
-      format: config.build?.format,
-      target: config.build?.target,
-      rollupOptions: {
-        input: config.build?.rollupOptions?.input || {}
-      }
-    }
-  };
-}
-function mergeViteConfig(framework, userOverride, context) {
-  if (!userOverride) return framework;
-  const userConfig = typeof userOverride === "function" && context ? userOverride(context) : userOverride;
-  const invariants = getFrameworkInvariants(framework);
-  const merged = {
-    ...framework,
-    build: { ...framework.build ?? {} },
-    css: { ...framework.css ?? {} },
-    resolve: { ...framework.resolve ?? {} },
-    plugins: [...framework.plugins ?? []],
-    define: { ...framework.define ?? {} }
-  };
-  const ignoredKeys = [];
-  if (userConfig.plugins) {
-    const frameworkPlugins = merged.plugins;
-    merged.plugins = [...frameworkPlugins, ...userConfig.plugins];
-  }
-  if (userConfig.define && typeof userConfig.define === "object") {
-    merged.define = {
-      ...merged.define,
-      ...userConfig.define
-    };
-  }
-  if (userConfig.css?.preprocessorOptions && typeof userConfig.css.preprocessorOptions === "object") {
-    const fpp = merged.css.preprocessorOptions ?? {};
-    const upp = userConfig.css.preprocessorOptions;
-    merged.css.preprocessorOptions = Object.keys({ ...fpp, ...upp }).reduce((acc, engine) => {
-      const fppEngine = fpp[engine];
-      const uppEngine = upp[engine];
-      acc[engine] = { ...fppEngine ?? {}, ...uppEngine ?? {} };
-      return acc;
-    }, {});
-  }
-  if (userConfig.build) {
-    const protectedBuildFields = ["outDir", "ssr", "ssrManifest", "format", "target"];
-    for (const field of protectedBuildFields) {
-      if (field in userConfig.build) {
-        ignoredKeys.push(`build.${field}`);
-      }
-    }
-    if ("sourcemap" in userConfig.build) merged.build.sourcemap = userConfig.build.sourcemap;
-    if ("minify" in userConfig.build) merged.build.minify = userConfig.build.minify;
-    if (userConfig.build.terserOptions && typeof userConfig.build.terserOptions === "object") {
-      merged.build.terserOptions = {
-        ...merged.build.terserOptions ?? {},
-        ...userConfig.build.terserOptions
-      };
-    }
-    if (userConfig.build.rollupOptions) {
-      if (!merged.build.rollupOptions) {
-        merged.build.rollupOptions = {};
-      }
-      const userRollup = userConfig.build.rollupOptions;
-      if ("input" in userRollup) ignoredKeys.push("build.rollupOptions.input");
-      if ("external" in userRollup) merged.build.rollupOptions.external = userRollup.external;
-      if (userRollup.output) {
-        const mro = merged.build.rollupOptions ??= {};
-        const uo = Array.isArray(userRollup.output) ? userRollup.output[0] : userRollup.output;
-        const baseOut = Array.isArray(mro.output) ? mro.output[0] ?? {} : mro.output ?? {};
-        mro.output = { ...baseOut, ...uo?.manualChunks ? { manualChunks: uo.manualChunks } : {} };
-      }
-    }
-  }
-  if (userConfig.resolve) {
-    const userResolve = userConfig.resolve;
-    const { alias: _ignore, ...resolveRest } = userResolve;
-    if (_ignore) ignoredKeys.push("resolve.alias");
-    merged.resolve = {
-      ...merged.resolve,
-      ...resolveRest
-    };
-  }
-  if (userConfig.server) ignoredKeys.push("server (ignored in build; dev-only)");
-  if ("root" in userConfig) ignoredKeys.push("root");
-  if ("base" in userConfig) ignoredKeys.push("base");
-  if ("publicDir" in userConfig) ignoredKeys.push("publicDir");
-  const safeTopLevelKeys = /* @__PURE__ */ new Set([
-    "esbuild",
-    "logLevel",
-    "envPrefix",
-    "optimizeDeps",
-    "ssr"
-    // NOTE: NOT 'server' (build-time irrelevant; dev-server only)
-  ]);
-  for (const [key, value] of Object.entries(userConfig)) {
-    if (safeTopLevelKeys.has(key)) merged[key] = value;
-  }
-  merged.root = invariants.root;
-  merged.base = invariants.base;
-  merged.publicDir = invariants.publicDir;
-  merged.build.outDir = invariants.build.outDir;
-  merged.build.manifest = invariants.build.manifest;
-  if (invariants.build.ssr !== void 0) merged.build.ssr = invariants.build.ssr;
-  merged.build.ssrManifest = invariants.build.ssrManifest;
-  if (invariants.build.format) merged.build.format = invariants.build.format;
-  if (invariants.build.target) merged.build.target = invariants.build.target;
-  if (!merged.build.rollupOptions) merged.build.rollupOptions = {};
-  merged.build.rollupOptions.input = invariants.build.rollupOptions.input;
-  if (ignoredKeys.length > 0) {
-    const uniqueKeys = [...new Set(ignoredKeys)];
-    const prefix = context ? `[taujs:build:${context.entryPoint}]` : "[taujs:build]";
-    console.warn(`${prefix} Ignored Vite config overrides: ${uniqueKeys.join(", ")}`);
-  }
-  return merged;
-}
-function resolveAppFilter(argv, env) {
-  const read = (keys) => {
-    const end = argv.indexOf("--");
-    const limit = end === -1 ? argv.length : end;
-    for (let i = 0; i < limit; i++) {
-      const arg = argv[i];
-      if (!arg) continue;
-      for (const key of keys) {
-        if (arg === key) {
-          const next = argv[i + 1];
-          if (!next || next.startsWith("-")) return "";
-          return next.trim();
-        }
-        const pref = `${key}=`;
-        if (arg.startsWith(pref)) {
-          const v = arg.slice(pref.length).trim();
-          return v;
-        }
-      }
-    }
-    return void 0;
-  };
-  const envFilter = env.TAUJS_APP || env.TAUJS_APPS;
-  const cliFilter = read(["--app", "--apps", "-a"]);
-  const raw = (cliFilter ?? envFilter)?.trim() || void 0;
-  if (!raw) return { selectedIds: null, raw: void 0 };
-  const selectedIds = new Set(
-    raw.split(",").map((s) => s.trim()).filter(Boolean)
-  );
-  return { selectedIds, raw };
-}
-async function taujsBuild({
-  config,
-  projectRoot,
-  clientBaseDir,
-  isSSRBuild = process.env.BUILD_MODE === "ssr",
-  alias: userAlias,
-  vite: userViteConfig
-}) {
-  const deleteDist = async () => {
-    const { rm } = await import("fs/promises");
-    const distPath = path6.resolve(projectRoot, "dist");
-    try {
-      await rm(distPath, { recursive: true, force: true });
-      console.log("Deleted the dist directory\n");
-    } catch (err) {
-      console.error("Error deleting dist directory:", err);
-    }
-  };
-  const extractedConfigs = extractBuildConfigs(config);
-  const processedConfigs = processConfigs(extractedConfigs, clientBaseDir, TEMPLATE);
-  const { selectedIds, raw: appFilterRaw } = resolveAppFilter(process.argv.slice(2), process.env);
-  const configsToBuild = selectedIds ? processedConfigs.filter(({ appId, entryPoint }) => selectedIds.has(appId) || selectedIds.has(entryPoint)) : processedConfigs;
-  if (selectedIds && configsToBuild.length === 0) {
-    console.error(
-      `[taujs:build] No apps match filter "${appFilterRaw}". Known apps: ${processedConfigs.map((c) => `${c.appId}${c.entryPoint ? ` (entry: ${c.entryPoint})` : ""}`).join(", ")}`
-    );
-    process.exit(1);
-  }
-  if (!isSSRBuild) await deleteDist();
-  for (const appConfig of configsToBuild) {
-    const { appId, entryPoint, clientRoot, entryClientFile, entryServerFile, htmlTemplate, plugins = [] } = appConfig;
-    const outDir = path6.resolve(projectRoot, isSSRBuild ? `dist/ssr/${entryPoint}` : `dist/client/${entryPoint}`);
-    const root = entryPoint ? path6.resolve(clientBaseDir, entryPoint) : clientBaseDir;
-    const defaultAlias = {
-      "@client": root,
-      "@server": path6.resolve(projectRoot, "src/server"),
-      "@shared": path6.resolve(projectRoot, "src/shared")
-    };
-    const resolvedAlias = { ...defaultAlias, ...userAlias ?? {} };
-    const server = path6.resolve(clientRoot, entryServerFile);
-    const client = path6.resolve(clientRoot, entryClientFile);
-    const main = path6.resolve(clientRoot, htmlTemplate);
-    const inputs = resolveInputs(isSSRBuild, !isSSRBuild && existsSync2(main), { server, client, main });
-    const nodeVersion = process.versions.node.split(".")[0];
-    const frameworkConfig = {
-      base: entryPoint ? `/${entryPoint}/` : "/",
-      build: {
-        outDir,
-        emptyOutDir: true,
-        manifest: !isSSRBuild,
-        rollupOptions: {
-          input: inputs
-        },
-        ssr: isSSRBuild ? server : void 0,
-        ssrManifest: isSSRBuild,
-        ...isSSRBuild && {
-          format: "esm",
-          target: `node${nodeVersion}`,
-          copyPublicDir: false
-        }
-      },
-      css: {
-        preprocessorOptions: {
-          scss: { api: "modern-compiler" }
-        }
-      },
-      plugins,
-      publicDir: isSSRBuild ? false : "public",
-      resolve: { alias: resolvedAlias },
-      root
-    };
-    const buildContext = {
-      appId,
-      entryPoint,
-      isSSRBuild,
-      clientRoot
-    };
-    const finalConfig = mergeViteConfig(frameworkConfig, userViteConfig, buildContext);
-    try {
-      const mode = isSSRBuild ? "SSR" : "Client";
-      console.log(`[taujs:build:${entryPoint}] Building \u2192 ${mode}`);
-      await build(finalConfig);
-      console.log(`[taujs:build:${entryPoint}] \u2713 Complete
-`);
-    } catch (error) {
-      console.error(`[taujs:build:${entryPoint}] \u2717 Failed
-`, error);
-      process.exit(1);
-    }
-  }
-}
-
 // src/logging/Adapters.ts
-var cleanMeta = (m) => m && Object.keys(m).length === 0 ? void 0 : m;
+var cleanMeta = (meta) => {
+  if (meta && typeof meta === "object" && !Array.isArray(meta)) return Object.keys(meta).length ? meta : void 0;
+  return void 0;
+};
 function messageMetaAdapter(sink) {
   return {
     debug: (meta, message) => sink.debug?.(message, cleanMeta(meta)),