@guren/server 1.0.0 → 1.2.0

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   logDevServerBanner,
   parseImportMap,
   startViteDevServer
-} from "./chunk-VXXZIXAP.js";
+} from "./chunk-HLXL2AYJ.js";
 import {
   PendingSchedule,
   Schedule,
@@ -1706,644 +1706,730 @@ var ErrorServiceProvider = class extends ServiceProvider {
   }
 };
 
-// src/http/Application.ts
-var MANAGED_VITE_ENV_FLAG = "GUREN_MANAGED_VITE_DEV_SERVER";
-var DEFAULT_DEV_ENTRY_PATH = "/resources/js/dev-entry.ts";
-function clearManagedViteEnv() {
-  if (typeof process === "undefined") {
-    return;
+// src/mvc/inertia/InertiaEngine.ts
+import { isAbsolute, resolve as resolvePath } from "path";
+import { pathToFileURL } from "url";
+ensureErrorStackTracePolyfill();
+var DEFAULT_TITLE = "Guren";
+var DEV_FALLBACK_IMPORT_MAP = {
+  react: "https://esm.sh/react@19.0.0?dev",
+  "react/jsx-runtime": "https://esm.sh/react@19.0.0/jsx-runtime?dev",
+  "react/jsx-dev-runtime": "https://esm.sh/react@19.0.0/jsx-dev-runtime?dev",
+  "react-dom/client": "https://esm.sh/react-dom@19.0.0/client?dev",
+  "@guren/inertia-client": "/vendor/inertia-client.tsx",
+  "@inertiajs/react": "https://esm.sh/@inertiajs/react@2.2.15?dev&external=react,react-dom/client"
+};
+async function inertia(component, props, options = {}) {
+  const resolvedVersion = options.version ?? process.env.GUREN_INERTIA_VERSION ?? void 0;
+  const page = {
+    component,
+    props,
+    url: options.url ?? "",
+    version: resolvedVersion
+  };
+  const request = options.request;
+  const isInertiaVisit = Boolean(request?.headers.get("X-Inertia"));
+  const prefersJson = request ? acceptsJson(request) : false;
+  const versionHeader = resolvedVersion ? { "X-Inertia-Version": resolvedVersion } : {};
+  if (request && resolvedVersion && isInertiaVisit && request.method === "GET") {
+    const clientVersion = request.headers.get("X-Inertia-Version");
+    if (clientVersion !== resolvedVersion) {
+      return new Response(null, {
+        status: 409,
+        headers: {
+          "X-Inertia-Location": options.url ?? request.url,
+          Vary: "Accept"
+        }
+      });
+    }
   }
-  if (process.env[MANAGED_VITE_ENV_FLAG] === "1") {
-    delete process.env.VITE_DEV_SERVER_URL;
+  if (isInertiaVisit || prefersJson) {
+    return new Response(serializePage(page), {
+      status: options.status ?? 200,
+      headers: {
+        "Content-Type": "application/json; charset=utf-8",
+        "X-Inertia": "true",
+        Vary: "Accept",
+        ...versionHeader,
+        ...options.headers
+      }
+    });
   }
-  delete process.env[MANAGED_VITE_ENV_FLAG];
+  const html = await renderDocument(page, options);
+  return new Response(html, {
+    status: options.status ?? 200,
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      "X-Inertia": "true",
+      Vary: "Accept",
+      ...versionHeader,
+      ...options.headers
+    }
+  });
 }
-function normalizeDevEntryUrl(baseUrl) {
-  return `${baseUrl.replace(/\/$/u, "")}${DEFAULT_DEV_ENTRY_PATH}`;
+async function renderDocument(page, options) {
+  const defaultEntry = process.env.GUREN_INERTIA_ENTRY ?? "/resources/js/app.tsx";
+  const entry = options.entry ?? defaultEntry;
+  const title = escapeHtml(options.title ?? DEFAULT_TITLE);
+  const styles = options.styles ?? parseStylesEnv(process.env.GUREN_INERTIA_STYLES);
+  const envImportMap = parseImportMap(process.env.GUREN_INERTIA_IMPORT_MAP, {
+    context: "GUREN_INERTIA_IMPORT_MAP"
+  });
+  const isProduction = process.env.NODE_ENV === "production";
+  const importMapEntries = {
+    ...isProduction ? {} : DEV_FALLBACK_IMPORT_MAP,
+    ...envImportMap,
+    ...options.importMap ?? {}
+  };
+  const importMap = JSON.stringify({ imports: importMapEntries }, null, 2);
+  const serializedPage = serializePage(page);
+  const stylesheetLinks = renderStyles(styles);
+  const docsHeadBootstrap = renderDocsHeadBootstrap(page.component);
+  const ssrResult = await tryRenderSsr(page, options);
+  const headElements = (ssrResult?.head ?? []).map(normalizeHeadElement);
+  const hasCustomTitle = headElements.some(
+    (element) => /<title\b[^>]*>/iu.test(element)
+  );
+  const headSegments = [
+    '<meta charset="utf-8" />',
+    '<meta name="viewport" content="width=device-width, initial-scale=1" />',
+    hasCustomTitle ? "" : `<title>${title}</title>`,
+    docsHeadBootstrap,
+    stylesheetLinks,
+    ...headElements,
+    Object.keys(importMapEntries).length > 0 ? `<script type="importmap">${importMap}</script>` : "",
+    `<script>window.__INERTIA_PAGE__ = ${serializedPage};</script>`
+  ].filter((segment) => segment && segment.length > 0);
+  const appMarkup = ssrResult?.body ?? `<script data-page="app" type="application/json">${serializedPage}</script><div id="app"></div>`;
+  const bodyClass = resolveBodyClass(page.component);
+  const bodyAttributes = bodyClass ? ` class="${escapeAttribute(bodyClass)}"` : "";
+  const lang = escapeAttribute(options.lang ?? "en");
+  return `<!DOCTYPE html>
+<html lang="${lang}">
+  <head>
+    ${headSegments.join("\n    ")}
+  </head>
+  <body${bodyAttributes}>
+    ${appMarkup}
+    <script type="module" src="${entry}"></script>
+  </body>
+</html>`;
 }
-function syncManagedInertiaDevEntry(devServerUrl) {
-  if (typeof process === "undefined") {
-    return;
-  }
-  const nextEntry = normalizeDevEntryUrl(devServerUrl);
-  const currentEntry = process.env.GUREN_INERTIA_ENTRY;
-  if (!currentEntry || currentEntry.endsWith(DEFAULT_DEV_ENTRY_PATH)) {
-    process.env.GUREN_INERTIA_ENTRY = nextEntry;
+async function tryRenderSsr(page, options) {
+  const ssrOptions = options.ssr;
+  if (ssrOptions?.enabled === false) {
+    return void 0;
   }
-}
-function getGlobalState() {
-  return globalThis;
-}
-async function stopActiveBunServer() {
-  const state = getGlobalState();
-  const previous = state.__gurenActiveServer;
-  if (!previous?.stop) {
-    state.__gurenActiveServer = void 0;
-    return;
+  const manifest = (ssrOptions?.manifest ?? process.env.GUREN_INERTIA_SSR_MANIFEST)?.trim() || void 0;
+  const renderer = ssrOptions?.render ?? await loadSsrRenderer(
+    ssrOptions?.entry ?? process.env.GUREN_INERTIA_SSR_ENTRY
+  );
+  if (!renderer) {
+    return void 0;
   }
   try {
-    await Promise.resolve(previous.stop());
+    const result = await renderer({
+      page,
+      request: options.request,
+      manifest
+    });
+    if (!result || typeof result.body !== "string") {
+      return void 0;
+    }
+    return {
+      body: result.body,
+      head: Array.isArray(result.head) ? result.head : []
+    };
   } catch (error) {
-    console.warn("Failed to stop previous Bun server:", error);
-  } finally {
-    state.__gurenActiveServer = void 0;
+    console.error(
+      "Inertia SSR renderer failed; falling back to client rendering.",
+      error
+    );
+    return void 0;
   }
 }
-function setActiveBunServer(server) {
-  getGlobalState().__gurenActiveServer = server;
-}
-async function stopActiveViteDevServer() {
-  const state = getGlobalState();
-  const previous = state.__gurenActiveViteDevServer;
-  if (!previous) {
-    state.__gurenActiveViteDevServer = void 0;
-    clearManagedViteEnv();
-    return;
+async function loadSsrRenderer(entry) {
+  const specifier = entry?.trim();
+  if (!specifier) {
+    return void 0;
   }
+  const normalized = normalizeSsrSpecifier(specifier);
   try {
-    await previous.close();
+    const module = await import(normalized);
+    const renderCandidate = extractSsrRenderer(module);
+    if (!renderCandidate) {
+      console.warn(
+        `Inertia SSR entry "${specifier}" does not export a renderer. Expected a default export or a named "render" function.`
+      );
+      return void 0;
+    }
+    return renderCandidate;
   } catch (error) {
-    console.warn("Failed to stop previous Vite dev server:", error);
-  } finally {
-    state.__gurenActiveViteDevServer = void 0;
-    clearManagedViteEnv();
+    console.error(`Failed to import Inertia SSR entry "${specifier}".`, error);
+    return void 0;
   }
 }
-function setActiveViteDevServer(server) {
-  getGlobalState().__gurenActiveViteDevServer = server;
-}
-var Application = class {
-  constructor(options = {}) {
-    this.options = options;
-    this.hono = new Hono();
-    this.container = new Container();
-    this.router = new Router();
-    this.authManager = new AuthManager();
-    this.providerManager = new ProviderManager(this.container);
-    this.container.instance("app", this);
-    this.container.instance("hono", this.hono);
-    this.container.instance("auth", this.authManager);
-    this.container.instance("router", this.router);
-    if (!this.authManager.guardNames().length) {
-      this.authManager.registerGuard("web", ({ ctx, session, manager }) => {
-        let provider;
-        try {
-          provider = manager.getProvider("users");
-        } catch {
-          provider = { retrieveById: async () => null, retrieveByCredentials: async () => null, validateCredentials: async () => false };
-        }
-        return new SessionGuard({ provider, session });
-      });
-      this.authManager.setDefaultGuard("web");
-    }
-    if (this.options.auth) {
-      this.providerManager.register(AuthServiceProvider);
-    } else {
-      this.hono.use("*", attachAuthContext((ctx) => this.authManager.createAuthContext(ctx)));
-    }
-    this.providerManager.register(AuthorizationServiceProvider);
-    const userProviders = Array.isArray(this.options.providers) ? this.options.providers : [];
-    const hasUserErrorProvider = userProviders.some(
-      (provider) => provider === ErrorServiceProvider || provider.prototype instanceof ErrorServiceProvider
-    );
-    if (!hasUserErrorProvider) {
-      this.providerManager.register(ErrorServiceProvider);
-    }
-    if (userProviders.length > 0) {
-      this.providerManager.registerMany(userProviders);
-    }
+function extractSsrRenderer(module) {
+  if (!module || typeof module !== "object") {
+    return void 0;
   }
-  hono;
-  container;
-  router;
-  providerManager;
-  authManager;
-  viteDevServer;
-  bunServer;
-  viteTeardownRegistered = false;
-  bunTeardownRegistered = false;
-  autoSessionAttached = false;
-  routesRegistered = false;
-  get auth() {
-    return this.authManager;
+  const candidate = typeof module.render === "function" ? module.render : typeof module.default === "function" ? module.default : void 0;
+  if (!candidate) {
+    return void 0;
   }
-  get authOptions() {
-    return this.options.auth;
+  return (context) => Promise.resolve(candidate(context));
+}
+function normalizeSsrSpecifier(specifier) {
+  if (specifier.startsWith("file://") || isUrlLike(specifier)) {
+    return specifier;
   }
-  markAutoSessionAttached() {
-    this.autoSessionAttached = true;
+  if (specifier.startsWith("./") || specifier.startsWith("../")) {
+    const absolute = resolvePath(process.cwd(), specifier);
+    return pathToFileURL(absolute).href;
   }
-  hasAutoSessionAttached() {
-    return this.autoSessionAttached;
+  if (isAbsolute(specifier)) {
+    return pathToFileURL(specifier).href;
   }
-  /**
-   * Mounts the application router onto the Hono instance.
-   */
-  async mountRoutes() {
-    if (this.options.routes && !this.routesRegistered) {
-      await this.options.routes(this.router);
-      this.routesRegistered = true;
+  return specifier;
+}
+function isUrlLike(specifier) {
+  return /^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(specifier);
+}
+function renderStyles(styles) {
+  if (!styles.length) {
+    return "";
+  }
+  return styles.map((href) => `<link rel="stylesheet" href="${escapeAttribute(href)}" />`).join("\n    ");
+}
+function normalizeHeadElement(element) {
+  const markup = typeof element === "string" ? element : String(element ?? "");
+  const pattern = /href="\/(?!public\/)([^"?]+\.(?:js|css))(\?[^"']*)?"/g;
+  return markup.replace(
+    pattern,
+    (_match, file2, query = "") => `href="/public/assets/${file2}${query}"`
+  );
+}
+function resolveBodyClass(componentName) {
+  return componentName.startsWith("Docs/") ? "docs-theme" : "";
+}
+function renderDocsHeadBootstrap(componentName) {
+  if (!componentName.startsWith("Docs/")) {
+    return "";
+  }
+  const criticalStyles = [
+    "html,body{background:#ffffff;color:#1f2937;}",
+    "body.docs-theme{background:#ffffff;color:#1f2937;}",
+    "html.dark,html.dark body,html.dark body.docs-theme{background:#1a1a2e;color:#e0def4;}",
+    ".size-4{width:1rem;height:1rem;}",
+    ".size-5{width:1.25rem;height:1.25rem;}",
+    ".size-6{width:1.5rem;height:1.5rem;}",
+    ".size-8{width:2rem;height:2rem;}",
+    ".size-9{width:2.25rem;height:2.25rem;}"
+  ].join("");
+  const prepaintScript = [
+    "(function(){",
+    "try{",
+    "var mode=localStorage.getItem('guren-color-mode')||'system';",
+    "var dark=mode==='dark'||(mode!=='light'&&window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches);",
+    "var root=document.documentElement;",
+    "root.classList.toggle('dark',dark);",
+    "root.style.colorScheme=dark?'dark':'light';",
+    "}catch(_){",
+    "}",
+    "})();"
+  ].join("");
+  return `<style id="guren-docs-critical">${criticalStyles}</style><script>${prepaintScript}</script>`;
+}
+function serializePage(page) {
+  return JSON.stringify(page).replace(/[<\u2028\u2029]/gu, (char) => {
+    switch (char) {
+      case "<":
+        return "\\u003c";
+      case "\u2028":
+        return "\\u2028";
+      case "\u2029":
+        return "\\u2029";
+      default:
+        return char;
     }
-    this.router.mount(this.hono, { container: this.container });
+  });
+}
+function acceptsJson(request) {
+  const accept = request.headers.get("accept")?.toLowerCase() ?? "";
+  if (!accept || accept === "*/*") {
+    return false;
   }
-  /**
-   * Allows registering global middlewares directly on the underlying Hono app.
-   */
-  use(path, ...middleware) {
-    this.hono.use(path, ...middleware);
+  if (accept.includes("text/html")) {
+    return false;
   }
-  /**
-   * Executes provider registration, boot callback, mounts routes, and boots providers.
-   */
-  async boot() {
-    this.mountSecurityDefaults();
-    await this.providerManager.registerAll();
-    await this.options.boot?.(this.hono);
-    await this.mountRoutes();
-    await this.mountMcpEndpoint();
-    await this.providerManager.bootAll();
+  return accept.includes("application/json") || accept.includes("json");
+}
+function escapeHtml(value) {
+  return value.replace(/[&<>"']/gu, (char) => {
+    switch (char) {
+      case "&":
+        return "&amp;";
+      case "<":
+        return "&lt;";
+      case ">":
+        return "&gt;";
+      case '"':
+        return "&quot;";
+      case "'":
+        return "&#39;";
+      default:
+        return char;
+    }
+  });
+}
+function escapeAttribute(value) {
+  return value.replace(/[&"]/gu, (char) => {
+    if (char === "&") {
+      return "&amp;";
+    }
+    return "&quot;";
+  });
+}
+function parseStylesEnv(value) {
+  if (!value) {
+    return [];
   }
-  /**
-   * Registers default security middleware (headers + host authorization).
-   */
-  mountSecurityDefaults() {
-    const { securityHeaders } = this.options;
-    if (securityHeaders !== false) {
-      this.hono.use("*", createSecurityHeaders(securityHeaders ?? {}));
+  return value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+}
+
+// src/mvc/ViewEngine.ts
+var ViewEngine = class {
+  static engines = /* @__PURE__ */ new Map();
+  static register(name, renderer) {
+    this.engines.set(name, renderer);
+  }
+  static has(name) {
+    return this.engines.has(name);
+  }
+  static render(name, template, props) {
+    const engine = this.engines.get(name);
+    if (!engine) {
+      throw new Error(`View engine "${name}" has not been registered.`);
     }
-    this.mountHostAuthorization();
+    return engine(template, props);
   }
-  mountHostAuthorization() {
-    const { hostAuthorization } = this.options;
-    if (hostAuthorization === false || !hostAuthorization) return;
-    this.hono.use("*", createHostAuthorizationMiddleware(hostAuthorization));
+};
+
+// src/mvc/inertia/shared.ts
+var resolver = null;
+function setInertiaSharedProps(resolverFn) {
+  resolver = resolverFn;
+}
+function getInertiaSharedPropsResolver() {
+  return resolver;
+}
+function shareInertiaProps(resolverFn) {
+  const previous = resolver;
+  resolver = async (ctx) => {
+    const prev = previous ? await previous(ctx) : {};
+    const next = await resolverFn(ctx);
+    return { ...prev, ...next };
+  };
+}
+async function resolveSharedInertiaProps(ctx) {
+  if (!resolver) return {};
+  const shared = await resolver(ctx);
+  if (shared && typeof shared === "object") {
+    return shared;
+  }
+  return {};
+}
+
+// src/providers/InertiaServiceProvider.ts
+var InertiaServiceProvider = class extends ServiceProvider {
+  register() {
+    if (!ViewEngine.has("inertia")) {
+      ViewEngine.register("inertia", inertia);
+    }
+  }
+  boot() {
+    this.registerValidationRenderer();
+    this.registerSharedErrors();
   }
   /**
-   * Mounts the MCP endpoint at /_guren/mcp when explicitly enabled.
-   * Requires GUREN_MCP=1 environment variable. Never active in production.
-   * This allows AI coding agents to introspect the project.
+   * Register a custom renderer for ValidationException on Inertia requests.
+   * Non-Inertia requests fall through to the default JSON 422 response.
    */
-  async mountMcpEndpoint() {
-    if (typeof process === "undefined" || process.env?.NODE_ENV === "production" || process.env?.GUREN_MCP !== "1") {
-      return;
-    }
+  registerValidationRenderer() {
+    let handler;
     try {
-      const { McpServiceProvider } = await import("./McpServiceProvider-JW6PDVMD.js");
-      const provider = new McpServiceProvider(this.container);
-      provider.register();
-      await provider.boot();
+      handler = this.container.make("exception.handler");
     } catch {
+      return;
     }
+    handler.render(ValidationException, (error, ctx) => {
+      const isInertia = ctx.req.header("X-Inertia");
+      if (!isInertia) {
+        return ctx.json(
+          {
+            message: error.message,
+            errors: error.errors
+          },
+          422
+        );
+      }
+      const session = getSessionFromContext(ctx);
+      if (session) {
+        const flattened = {};
+        for (const [key, messages] of Object.entries(error.errors ?? {})) {
+          flattened[key] = messages[0] ?? "";
+        }
+        session.flash("errors", flattened);
+      }
+      const referer = ctx.req.header("Referer") ?? "/";
+      return new Response(null, {
+        status: 303,
+        headers: { Location: referer }
+      });
+    });
   }
   /**
-   * Fetch handler to integrate with Bun.serve or any standard Fetch runtime.
+   * Wrap existing shared props resolver to auto-inject flashed `errors`.
    */
-  async fetch(request, env, executionCtx) {
-    return this.hono.fetch(request, env, executionCtx);
+  registerSharedErrors() {
+    const previous = getInertiaSharedPropsResolver();
+    setInertiaSharedProps(async (ctx) => {
+      const prev = previous ? await previous(ctx) : {};
+      const session = getSessionFromContext(ctx);
+      const errors = session?.getFlash("errors");
+      return {
+        ...prev,
+        ...errors && Object.keys(errors).length > 0 ? { errors } : {}
+      };
+    });
   }
-  /**
-   * Convenience helper to start a Bun server when available.
-   */
-  async listen(options = {}) {
-    if (!Bun) {
-      throw new Error("Bun runtime is required to call Application.listen");
-    }
-    await stopActiveBunServer();
-    await stopActiveViteDevServer();
-    const { port = 3e3, hostname = "0.0.0.0", assetsUrl, vite } = options;
-    const externalAssetsUrl = typeof process !== "undefined" && process.env?.[MANAGED_VITE_ENV_FLAG] !== "1" ? process.env?.VITE_DEV_SERVER_URL : void 0;
-    let resolvedAssetsUrl = assetsUrl ?? externalAssetsUrl;
-    const shouldStartVite = vite !== false && typeof process !== "undefined" && process.env?.NODE_ENV !== "production" && !resolvedAssetsUrl && process.env?.GUREN_DEV_VITE !== "0";
-    if (shouldStartVite) {
-      const viteOptions = typeof vite === "object" ? vite : void 0;
-      try {
-        await this.closeViteDevServer();
-        const { server: server2, localUrl } = await startViteDevServer({
-          root: viteOptions?.root ?? process.cwd(),
-          config: viteOptions?.config,
-          host: viteOptions?.host ?? true,
-          port: viteOptions?.port
-        });
-        this.viteDevServer = server2;
-        setActiveViteDevServer(server2);
-        resolvedAssetsUrl = localUrl;
-        if (typeof process !== "undefined") {
-          process.env.VITE_DEV_SERVER_URL = resolvedAssetsUrl;
-          process.env[MANAGED_VITE_ENV_FLAG] = "1";
+};
+
+// src/http/Application.ts
+var MANAGED_VITE_ENV_FLAG = "GUREN_MANAGED_VITE_DEV_SERVER";
+var DEFAULT_DEV_ENTRY_PATH = "/resources/js/dev-entry.ts";
+function clearManagedViteEnv() {
+  if (typeof process === "undefined") {
+    return;
+  }
+  if (process.env[MANAGED_VITE_ENV_FLAG] === "1") {
+    delete process.env.VITE_DEV_SERVER_URL;
+  }
+  delete process.env[MANAGED_VITE_ENV_FLAG];
+}
+function normalizeDevEntryUrl(baseUrl) {
+  return `${baseUrl.replace(/\/$/u, "")}${DEFAULT_DEV_ENTRY_PATH}`;
+}
+function syncManagedInertiaDevEntry(devServerUrl) {
+  if (typeof process === "undefined") {
+    return;
+  }
+  const nextEntry = normalizeDevEntryUrl(devServerUrl);
+  const currentEntry = process.env.GUREN_INERTIA_ENTRY;
+  if (!currentEntry || currentEntry.endsWith(DEFAULT_DEV_ENTRY_PATH)) {
+    process.env.GUREN_INERTIA_ENTRY = nextEntry;
+  }
+}
+function getGlobalState() {
+  return globalThis;
+}
+async function stopActiveBunServer() {
+  const state = getGlobalState();
+  const previous = state.__gurenActiveServer;
+  if (!previous?.stop) {
+    state.__gurenActiveServer = void 0;
+    return;
+  }
+  try {
+    await Promise.resolve(previous.stop());
+  } catch (error) {
+    console.warn("Failed to stop previous Bun server:", error);
+  } finally {
+    state.__gurenActiveServer = void 0;
+  }
+}
+function setActiveBunServer(server) {
+  getGlobalState().__gurenActiveServer = server;
+}
+async function stopActiveViteDevServer() {
+  const state = getGlobalState();
+  const previous = state.__gurenActiveViteDevServer;
+  if (!previous) {
+    state.__gurenActiveViteDevServer = void 0;
+    clearManagedViteEnv();
+    return;
+  }
+  try {
+    await previous.close();
+  } catch (error) {
+    console.warn("Failed to stop previous Vite dev server:", error);
+  } finally {
+    state.__gurenActiveViteDevServer = void 0;
+    clearManagedViteEnv();
+  }
+}
+function setActiveViteDevServer(server) {
+  getGlobalState().__gurenActiveViteDevServer = server;
+}
+var Application = class {
+  constructor(options = {}) {
+    this.options = options;
+    this.hono = new Hono();
+    this.container = new Container();
+    this.router = new Router();
+    this.authManager = new AuthManager();
+    this.providerManager = new ProviderManager(this.container);
+    this.container.instance("app", this);
+    this.container.instance("hono", this.hono);
+    this.container.instance("auth", this.authManager);
+    this.container.instance("router", this.router);
+    if (!this.authManager.guardNames().length) {
+      this.authManager.registerGuard("web", ({ ctx, session, manager }) => {
+        let provider;
+        try {
+          provider = manager.getProvider("users");
+        } catch {
+          provider = { retrieveById: async () => null, retrieveByCredentials: async () => null, validateCredentials: async () => false };
         }
-        syncManagedInertiaDevEntry(resolvedAssetsUrl);
-        this.registerViteTeardown();
-      } catch (error) {
-        console.error("Failed to start Vite dev server:", error);
-        process.exit(1);
-      }
-    }
-    const server = Bun.serve({
-      port,
-      hostname,
-      fetch: (request) => this.fetch(request)
-    });
-    this.bunServer = server;
-    setActiveBunServer(server);
-    this.registerBunTeardown();
-    const shouldLogBanner = typeof process === "undefined" || process.env?.NODE_ENV !== "production" && process.env?.GUREN_DEV_BANNER !== "0";
-    if (shouldLogBanner) {
-      this.logDevServerBanner({
-        hostname,
-        port,
-        assetsUrl: resolvedAssetsUrl ?? "http://localhost:5173"
+        return new SessionGuard({ provider, session });
       });
+      this.authManager.setDefaultGuard("web");
+    }
+    if (this.options.auth) {
+      this.providerManager.register(AuthServiceProvider);
+    } else {
+      this.hono.use("*", attachAuthContext((ctx) => this.authManager.createAuthContext(ctx)));
+    }
+    this.providerManager.register(AuthorizationServiceProvider);
+    const userProviders = Array.isArray(this.options.providers) ? this.options.providers : [];
+    const hasUserErrorProvider = userProviders.some(
+      (provider) => provider === ErrorServiceProvider || provider.prototype instanceof ErrorServiceProvider
+    );
+    if (!hasUserErrorProvider) {
+      this.providerManager.register(ErrorServiceProvider);
+    }
+    if (userProviders.length > 0) {
+      this.providerManager.registerMany(userProviders);
+    }
+    const hasUserInertiaProvider = userProviders.some(
+      (provider) => provider === InertiaServiceProvider || provider.prototype instanceof InertiaServiceProvider
+    );
+    if (!hasUserInertiaProvider) {
+      this.providerManager.register(InertiaServiceProvider);
     }
   }
+  hono;
+  container;
+  router;
+  providerManager;
+  authManager;
+  viteDevServer;
+  bunServer;
+  viteTeardownRegistered = false;
+  bunTeardownRegistered = false;
+  autoSessionAttached = false;
+  routesRegistered = false;
+  get auth() {
+    return this.authManager;
+  }
+  get authOptions() {
+    return this.options.auth;
+  }
+  markAutoSessionAttached() {
+    this.autoSessionAttached = true;
+  }
+  hasAutoSessionAttached() {
+    return this.autoSessionAttached;
+  }
   /**
-   * Register a service provider.
+   * Mounts the application router onto the Hono instance.
    */
-  register(provider) {
-    this.providerManager.register(provider);
-    return this;
+  async mountRoutes() {
+    if (this.options.routes && !this.routesRegistered) {
+      await this.options.routes(this.router);
+      this.routesRegistered = true;
+    }
+    this.router.mount(this.hono, { container: this.container });
   }
   /**
-   * Register multiple service providers.
+   * Allows registering global middlewares directly on the underlying Hono app.
    */
-  registerMany(providers) {
-    this.providerManager.registerMany(providers);
-    return this;
+  use(path, ...middleware) {
+    this.hono.use(path, ...middleware);
   }
   /**
-   * Logs the rich development server banner to the console.
+   * Executes provider registration, boot callback, mounts routes, and boots providers.
    */
-  logDevServerBanner(options) {
-    logDevServerBanner(options);
+  async boot() {
+    this.mountSecurityDefaults();
+    await this.providerManager.registerAll();
+    await this.options.boot?.(this.hono);
+    await this.mountRoutes();
+    await this.mountMcpEndpoint();
+    await this.providerManager.bootAll();
   }
-  async closeViteDevServer() {
-    if (!this.viteDevServer) {
+  /**
+   * Registers default security middleware (headers + host authorization).
+   */
+  mountSecurityDefaults() {
+    const { securityHeaders } = this.options;
+    if (securityHeaders !== false) {
+      this.hono.use("*", createSecurityHeaders(securityHeaders ?? {}));
+    }
+    this.mountHostAuthorization();
+  }
+  mountHostAuthorization() {
+    const { hostAuthorization } = this.options;
+    if (hostAuthorization === false || !hostAuthorization) return;
+    this.hono.use("*", createHostAuthorizationMiddleware(hostAuthorization));
+  }
+  /**
+   * Mounts the MCP endpoint at /_guren/mcp when explicitly enabled.
+   * Requires GUREN_MCP=1 environment variable. Never active in production.
+   * This allows AI coding agents to introspect the project.
+   */
+  async mountMcpEndpoint() {
+    if (typeof process === "undefined" || process.env?.NODE_ENV === "production" || process.env?.GUREN_MCP !== "1") {
       return;
     }
     try {
-      await this.viteDevServer.close();
-    } catch (error) {
-      console.error("Error while shutting down Vite dev server:", error);
-    } finally {
-      if (getGlobalState().__gurenActiveViteDevServer === this.viteDevServer) {
-        setActiveViteDevServer();
-      }
-      this.viteDevServer = void 0;
-      this.viteTeardownRegistered = false;
-      clearManagedViteEnv();
+      const { McpServiceProvider } = await import("./McpServiceProvider-JW6PDVMD.js");
+      const provider = new McpServiceProvider(this.container);
+      provider.register();
+      await provider.boot();
+    } catch {
     }
   }
-  registerViteTeardown() {
-    if (this.viteTeardownRegistered || !this.viteDevServer || typeof process === "undefined") {
-      return;
-    }
-    this.viteTeardownRegistered = true;
-    const exitHandler = () => {
-      this.closeViteDevServer().then(() => process.exit(0)).catch(() => process.exit(1));
-    };
-    process.once("SIGINT", exitHandler);
-    process.once("SIGTERM", exitHandler);
-    process.on("exit", () => {
-      if (this.viteDevServer) {
-        void this.viteDevServer.close();
-      }
-    });
-  }
-  registerBunTeardown() {
-    if (this.bunTeardownRegistered || typeof process === "undefined") {
-      return;
-    }
-    this.bunTeardownRegistered = true;
-    const exitHandler = () => {
-      stopActiveBunServer().then(() => process.exit(0)).catch(() => process.exit(1));
-    };
-    process.once("SIGINT", exitHandler);
-    process.once("SIGTERM", exitHandler);
-    process.on("exit", () => {
-      void stopActiveBunServer();
-    });
-  }
-};
-function createApp(options = {}) {
-  return new Application(options);
-}
-
-// src/mvc/inertia/InertiaEngine.ts
-import { isAbsolute, resolve as resolvePath } from "path";
-import { pathToFileURL } from "url";
-ensureErrorStackTracePolyfill();
-var DEFAULT_TITLE = "Guren";
-var DEFAULT_IMPORT_MAP = {
-  react: "https://esm.sh/react@19.0.0?dev",
-  "react/jsx-runtime": "https://esm.sh/react@19.0.0/jsx-runtime?dev",
-  "react/jsx-dev-runtime": "https://esm.sh/react@19.0.0/jsx-dev-runtime?dev",
-  "react-dom/client": "https://esm.sh/react-dom@19.0.0/client?dev",
-  "@guren/inertia-client": "/vendor/inertia-client.tsx",
-  "@inertiajs/react": "https://esm.sh/@inertiajs/react@2.2.15?dev&external=react,react-dom/client"
-};
-async function inertia(component, props, options = {}) {
-  const resolvedVersion = options.version ?? process.env.GUREN_INERTIA_VERSION ?? void 0;
-  const page = {
-    component,
-    props,
-    url: options.url ?? "",
-    version: resolvedVersion
-  };
-  const request = options.request;
-  const isInertiaVisit = Boolean(request?.headers.get("X-Inertia"));
-  const prefersJson = request ? acceptsJson(request) : false;
-  const versionHeader = resolvedVersion ? { "X-Inertia-Version": resolvedVersion } : {};
-  if (request && resolvedVersion && isInertiaVisit && request.method === "GET") {
-    const clientVersion = request.headers.get("X-Inertia-Version");
-    if (clientVersion !== resolvedVersion) {
-      return new Response(null, {
-        status: 409,
-        headers: {
-          "X-Inertia-Location": options.url ?? request.url,
-          Vary: "Accept"
-        }
-      });
-    }
-  }
-  if (isInertiaVisit || prefersJson) {
-    return new Response(serializePage(page), {
-      status: options.status ?? 200,
-      headers: {
-        "Content-Type": "application/json; charset=utf-8",
-        "X-Inertia": "true",
-        Vary: "Accept",
-        ...versionHeader,
-        ...options.headers
-      }
-    });
-  }
-  const html = await renderDocument(page, options);
-  return new Response(html, {
-    status: options.status ?? 200,
-    headers: {
-      "Content-Type": "text/html; charset=utf-8",
-      "X-Inertia": "true",
-      Vary: "Accept",
-      ...versionHeader,
-      ...options.headers
-    }
-  });
-}
-async function renderDocument(page, options) {
-  const defaultEntry = process.env.GUREN_INERTIA_ENTRY ?? "/resources/js/app.tsx";
-  const entry = options.entry ?? defaultEntry;
-  const title = escapeHtml(options.title ?? DEFAULT_TITLE);
-  const styles = options.styles ?? parseStylesEnv(process.env.GUREN_INERTIA_STYLES);
-  const envImportMap = parseImportMap(process.env.GUREN_INERTIA_IMPORT_MAP, {
-    context: "GUREN_INERTIA_IMPORT_MAP"
-  });
-  const importMap = JSON.stringify(
-    {
-      imports: {
-        ...DEFAULT_IMPORT_MAP,
-        ...envImportMap,
-        ...options.importMap ?? {}
-      }
-    },
-    null,
-    2
-  );
-  const serializedPage = serializePage(page);
-  const stylesheetLinks = renderStyles(styles);
-  const docsHeadBootstrap = renderDocsHeadBootstrap(page.component);
-  const ssrResult = await tryRenderSsr(page, options);
-  const headElements = (ssrResult?.head ?? []).map(normalizeHeadElement);
-  const hasCustomTitle = headElements.some(
-    (element) => /<title\b[^>]*>/iu.test(element)
-  );
-  const headSegments = [
-    '<meta charset="utf-8" />',
-    '<meta name="viewport" content="width=device-width, initial-scale=1" />',
-    hasCustomTitle ? "" : `<title>${title}</title>`,
-    docsHeadBootstrap,
-    stylesheetLinks,
-    ...headElements,
-    `<script type="importmap">${importMap}</script>`,
-    `<script>window.__INERTIA_PAGE__ = ${serializedPage};</script>`
-  ].filter((segment) => segment && segment.length > 0);
-  const appMarkup = ssrResult?.body ?? `<script data-page="app" type="application/json">${serializedPage}</script><div id="app"></div>`;
-  const bodyClass = resolveBodyClass(page.component);
-  const bodyAttributes = bodyClass ? ` class="${escapeAttribute(bodyClass)}"` : "";
-  return `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    ${headSegments.join("\n    ")}
-  </head>
-  <body${bodyAttributes}>
-    ${appMarkup}
-    <script type="module" src="${entry}"></script>
-  </body>
-</html>`;
-}
-async function tryRenderSsr(page, options) {
-  const ssrOptions = options.ssr;
-  if (ssrOptions?.enabled === false) {
-    return void 0;
-  }
-  const manifest = (ssrOptions?.manifest ?? process.env.GUREN_INERTIA_SSR_MANIFEST)?.trim() || void 0;
-  const renderer = ssrOptions?.render ?? await loadSsrRenderer(
-    ssrOptions?.entry ?? process.env.GUREN_INERTIA_SSR_ENTRY
-  );
-  if (!renderer) {
-    return void 0;
-  }
-  try {
-    const result = await renderer({
-      page,
-      request: options.request,
-      manifest
-    });
-    if (!result || typeof result.body !== "string") {
-      return void 0;
-    }
-    return {
-      body: result.body,
-      head: Array.isArray(result.head) ? result.head : []
-    };
-  } catch (error) {
-    console.error(
-      "Inertia SSR renderer failed; falling back to client rendering.",
-      error
-    );
-    return void 0;
-  }
-}
-async function loadSsrRenderer(entry) {
-  const specifier = entry?.trim();
-  if (!specifier) {
-    return void 0;
+  /**
+   * Fetch handler to integrate with Bun.serve or any standard Fetch runtime.
+   */
+  async fetch(request, env, executionCtx) {
+    return this.hono.fetch(request, env, executionCtx);
   }
-  const normalized = normalizeSsrSpecifier(specifier);
-  try {
-    const module = await import(normalized);
-    const renderCandidate = extractSsrRenderer(module);
-    if (!renderCandidate) {
-      console.warn(
-        `Inertia SSR entry "${specifier}" does not export a renderer. Expected a default export or a named "render" function.`
-      );
-      return void 0;
+  /**
+   * Convenience helper to start a Bun server when available.
+   */
+  async listen(options = {}) {
+    if (!Bun) {
+      throw new Error("Bun runtime is required to call Application.listen");
     }
-    return renderCandidate;
-  } catch (error) {
-    console.error(`Failed to import Inertia SSR entry "${specifier}".`, error);
-    return void 0;
-  }
-}
-function extractSsrRenderer(module) {
-  if (!module || typeof module !== "object") {
-    return void 0;
-  }
-  const candidate = typeof module.render === "function" ? module.render : typeof module.default === "function" ? module.default : void 0;
-  if (!candidate) {
-    return void 0;
-  }
-  return (context) => Promise.resolve(candidate(context));
-}
-function normalizeSsrSpecifier(specifier) {
-  if (specifier.startsWith("file://") || isUrlLike(specifier)) {
-    return specifier;
-  }
-  if (specifier.startsWith("./") || specifier.startsWith("../")) {
-    const absolute = resolvePath(process.cwd(), specifier);
-    return pathToFileURL(absolute).href;
-  }
-  if (isAbsolute(specifier)) {
-    return pathToFileURL(specifier).href;
-  }
-  return specifier;
-}
-function isUrlLike(specifier) {
-  return /^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(specifier);
-}
-function renderStyles(styles) {
-  if (!styles.length) {
-    return "";
-  }
-  return styles.map((href) => `<link rel="stylesheet" href="${escapeAttribute(href)}" />`).join("\n    ");
-}
-function normalizeHeadElement(element) {
-  const markup = typeof element === "string" ? element : String(element ?? "");
-  const pattern = /href="\/(?!public\/)([^"?]+\.(?:js|css))(\?[^"']*)?"/g;
-  return markup.replace(
-    pattern,
-    (_match, file2, query = "") => `href="/public/assets/${file2}${query}"`
-  );
-}
-function resolveBodyClass(componentName) {
-  return componentName.startsWith("Docs/") ? "docs-theme" : "";
-}
-function renderDocsHeadBootstrap(componentName) {
-  if (!componentName.startsWith("Docs/")) {
-    return "";
-  }
-  const criticalStyles = [
-    "html,body{background:#ffffff;color:#1f2937;}",
-    "body.docs-theme{background:#ffffff;color:#1f2937;}",
-    "html.dark,html.dark body,html.dark body.docs-theme{background:#1a1a2e;color:#e0def4;}",
-    ".size-4{width:1rem;height:1rem;}",
-    ".size-5{width:1.25rem;height:1.25rem;}",
-    ".size-6{width:1.5rem;height:1.5rem;}",
-    ".size-8{width:2rem;height:2rem;}",
-    ".size-9{width:2.25rem;height:2.25rem;}"
-  ].join("");
-  const prepaintScript = [
-    "(function(){",
-    "try{",
-    "var mode=localStorage.getItem('guren-color-mode')||'system';",
-    "var dark=mode==='dark'||(mode!=='light'&&window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches);",
-    "var root=document.documentElement;",
-    "root.classList.toggle('dark',dark);",
-    "root.style.colorScheme=dark?'dark':'light';",
-    "}catch(_){",
-    "}",
-    "})();"
-  ].join("");
-  return `<style id="guren-docs-critical">${criticalStyles}</style><script>${prepaintScript}</script>`;
-}
-function serializePage(page) {
-  return JSON.stringify(page).replace(/[<\u2028\u2029]/gu, (char) => {
-    switch (char) {
-      case "<":
-        return "\\u003c";
-      case "\u2028":
-        return "\\u2028";
-      case "\u2029":
-        return "\\u2029";
-      default:
-        return char;
+    await stopActiveBunServer();
+    await stopActiveViteDevServer();
+    const { port = 3e3, hostname = "0.0.0.0", assetsUrl, vite } = options;
+    const externalAssetsUrl = typeof process !== "undefined" && process.env?.[MANAGED_VITE_ENV_FLAG] !== "1" ? process.env?.VITE_DEV_SERVER_URL : void 0;
+    let resolvedAssetsUrl = assetsUrl ?? externalAssetsUrl;
+    const shouldStartVite = vite !== false && typeof process !== "undefined" && process.env?.NODE_ENV !== "production" && !resolvedAssetsUrl && process.env?.GUREN_DEV_VITE !== "0";
+    if (shouldStartVite) {
+      const viteOptions = typeof vite === "object" ? vite : void 0;
+      try {
+        await this.closeViteDevServer();
+        const { server: server2, localUrl } = await startViteDevServer({
+          root: viteOptions?.root ?? process.cwd(),
+          config: viteOptions?.config,
+          host: viteOptions?.host ?? true,
+          port: viteOptions?.port
+        });
+        this.viteDevServer = server2;
+        setActiveViteDevServer(server2);
+        resolvedAssetsUrl = localUrl;
+        if (typeof process !== "undefined") {
+          process.env.VITE_DEV_SERVER_URL = resolvedAssetsUrl;
+          process.env[MANAGED_VITE_ENV_FLAG] = "1";
+        }
+        syncManagedInertiaDevEntry(resolvedAssetsUrl);
+        this.registerViteTeardown();
+      } catch (error) {
+        console.error("Failed to start Vite dev server:", error);
+        process.exit(1);
+      }
+    }
+    const server = Bun.serve({
+      port,
+      hostname,
+      fetch: (request) => this.fetch(request)
+    });
+    this.bunServer = server;
+    setActiveBunServer(server);
+    this.registerBunTeardown();
+    const shouldLogBanner = typeof process === "undefined" || process.env?.NODE_ENV !== "production" && process.env?.GUREN_DEV_BANNER !== "0";
+    if (shouldLogBanner) {
+      this.logDevServerBanner({
+        hostname,
+        port,
+        assetsUrl: resolvedAssetsUrl ?? "http://localhost:5173"
+      });
     }
-  });
-}
-function acceptsJson(request) {
-  const accept = request.headers.get("accept")?.toLowerCase() ?? "";
-  if (!accept || accept === "*/*") {
-    return false;
   }
-  if (accept.includes("text/html")) {
-    return false;
+  /**
+   * Register a service provider.
+   */
+  register(provider) {
+    this.providerManager.register(provider);
+    return this;
   }
-  return accept.includes("application/json") || accept.includes("json");
-}
-function escapeHtml(value) {
-  return value.replace(/[&<>"']/gu, (char) => {
-    switch (char) {
-      case "&":
-        return "&amp;";
-      case "<":
-        return "&lt;";
-      case ">":
-        return "&gt;";
-      case '"':
-        return "&quot;";
-      case "'":
-        return "&#39;";
-      default:
-        return char;
+  /**
+   * Register multiple service providers.
+   */
+  registerMany(providers) {
+    this.providerManager.registerMany(providers);
+    return this;
+  }
+  /**
+   * Logs the rich development server banner to the console.
+   */
+  logDevServerBanner(options) {
+    logDevServerBanner(options);
+  }
+  async closeViteDevServer() {
+    if (!this.viteDevServer) {
+      return;
     }
-  });
-}
-function escapeAttribute(value) {
-  return value.replace(/[&"]/gu, (char) => {
-    if (char === "&") {
-      return "&amp;";
+    try {
+      await this.viteDevServer.close();
+    } catch (error) {
+      console.error("Error while shutting down Vite dev server:", error);
+    } finally {
+      if (getGlobalState().__gurenActiveViteDevServer === this.viteDevServer) {
+        setActiveViteDevServer();
+      }
+      this.viteDevServer = void 0;
+      this.viteTeardownRegistered = false;
+      clearManagedViteEnv();
     }
-    return "&quot;";
-  });
-}
-function parseStylesEnv(value) {
-  if (!value) {
-    return [];
   }
-  return value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
-}
-
-// src/mvc/inertia/shared.ts
-var resolver = null;
-function setInertiaSharedProps(resolverFn) {
-  resolver = resolverFn;
-}
-function getInertiaSharedPropsResolver() {
-  return resolver;
-}
-function shareInertiaProps(resolverFn) {
-  const previous = resolver;
-  resolver = async (ctx) => {
-    const prev = previous ? await previous(ctx) : {};
-    const next = await resolverFn(ctx);
-    return { ...prev, ...next };
-  };
-}
-async function resolveSharedInertiaProps(ctx) {
-  if (!resolver) return {};
-  const shared = await resolver(ctx);
-  if (shared && typeof shared === "object") {
-    return shared;
+  registerViteTeardown() {
+    if (this.viteTeardownRegistered || !this.viteDevServer || typeof process === "undefined") {
+      return;
+    }
+    this.viteTeardownRegistered = true;
+    const exitHandler = () => {
+      this.closeViteDevServer().then(() => process.exit(0)).catch(() => process.exit(1));
+    };
+    process.once("SIGINT", exitHandler);
+    process.once("SIGTERM", exitHandler);
+    process.on("exit", () => {
+      if (this.viteDevServer) {
+        void this.viteDevServer.close();
+      }
+    });
   }
-  return {};
+  registerBunTeardown() {
+    if (this.bunTeardownRegistered || typeof process === "undefined") {
+      return;
+    }
+    this.bunTeardownRegistered = true;
+    const exitHandler = () => {
+      stopActiveBunServer().then(() => process.exit(0)).catch(() => process.exit(1));
+    };
+    process.once("SIGINT", exitHandler);
+    process.once("SIGTERM", exitHandler);
+    process.on("exit", () => {
+      void stopActiveBunServer();
+    });
+  }
+};
+function createApp(options = {}) {
+  return new Application(options);
 }
 
 // src/mvc/Controller.ts
@@ -2518,6 +2604,7 @@ var Controller = class {
     const propsWithShared = { ...sharedProps, ...props };
     const response = await inertia(component, propsWithShared, {
       ...rest,
+      lang: rest.lang ?? this.#defaultInertiaLang(),
       url: url2,
       request: ctx.req.raw
     });
@@ -2527,6 +2614,27 @@ var Controller = class {
     };
     return response;
   }
+  /**
+   * Default `<html lang>` for Inertia responses when `options.lang` is not
+   * provided: the request-scoped `locale` context variable (set by locale
+   * middleware) wins over the app-wide i18n locale.
+   */
+  #defaultInertiaLang() {
+    const vars = this.ctx.var;
+    const requestLocale = vars?.locale;
+    if (typeof requestLocale === "string" && requestLocale.length > 0) {
+      return requestLocale;
+    }
+    const container = vars?.container;
+    if (container?.has?.("i18n")) {
+      const i18n = container.make?.("i18n");
+      const locale = i18n?.getLocale?.();
+      if (typeof locale === "string" && locale.length > 0) {
+        return locale;
+      }
+    }
+    return void 0;
+  }
   json(data, init = {}) {
     return new Response(JSON.stringify(data), {
       ...init,
@@ -2755,89 +2863,6 @@ var Controller = class {
   }
 };
 
-// src/mvc/ViewEngine.ts
-var ViewEngine = class {
-  static engines = /* @__PURE__ */ new Map();
-  static register(name, renderer) {
-    this.engines.set(name, renderer);
-  }
-  static has(name) {
-    return this.engines.has(name);
-  }
-  static render(name, template, props) {
-    const engine = this.engines.get(name);
-    if (!engine) {
-      throw new Error(`View engine "${name}" has not been registered.`);
-    }
-    return engine(template, props);
-  }
-};
-
-// src/providers/InertiaServiceProvider.ts
-var InertiaServiceProvider = class extends ServiceProvider {
-  register() {
-    if (!ViewEngine.has("inertia")) {
-      ViewEngine.register("inertia", inertia);
-    }
-  }
-  boot() {
-    this.registerValidationRenderer();
-    this.registerSharedErrors();
-  }
-  /**
-   * Register a custom renderer for ValidationException on Inertia requests.
-   * Non-Inertia requests fall through to the default JSON 422 response.
-   */
-  registerValidationRenderer() {
-    let handler;
-    try {
-      handler = this.container.make("exception.handler");
-    } catch {
-      return;
-    }
-    handler.render(ValidationException, (error, ctx) => {
-      const isInertia = ctx.req.header("X-Inertia");
-      if (!isInertia) {
-        return ctx.json(
-          {
-            message: error.message,
-            errors: error.errors
-          },
-          422
-        );
-      }
-      const session = getSessionFromContext(ctx);
-      if (session) {
-        const flattened = {};
-        for (const [key, messages] of Object.entries(error.errors ?? {})) {
-          flattened[key] = messages[0] ?? "";
-        }
-        session.flash("errors", flattened);
-      }
-      const referer = ctx.req.header("Referer") ?? "/";
-      return new Response(null, {
-        status: 303,
-        headers: { Location: referer }
-      });
-    });
-  }
-  /**
-   * Wrap existing shared props resolver to auto-inject flashed `errors`.
-   */
-  registerSharedErrors() {
-    const previous = getInertiaSharedPropsResolver();
-    setInertiaSharedProps(async (ctx) => {
-      const prev = previous ? await previous(ctx) : {};
-      const session = getSessionFromContext(ctx);
-      const errors = session?.getFlash("errors");
-      return {
-        ...prev,
-        ...errors && Object.keys(errors).length > 0 ? { errors } : {}
-      };
-    });
-  }
-};
-
 // src/providers/OAuthServiceProvider.ts
 var OAuthServiceProvider = class extends ServiceProvider {
   register() {