@moonsjs/vite 0.1.3 → 0.1.4

package/src/server/handler.ts

@@ -1,6 +1,8 @@
 import {
   MoonsError,
   composeMiddleware,
+  isNotFoundSignal,
+  isRedirectSignal,
   resolveRoute,
   routeKeyFromFile,
   runLoaders,
@@ -12,7 +14,7 @@ import {
 import { encodeSsrPayload, reviveError, serializeError } from "@moonsjs/core/serialize";
 import { renderToMarkup } from "@moonsjs/react/ssr";
 import type { ClientRouteEntry, RouteModuleShape } from "@moonsjs/react/internal";
-import { createRpcHandler, runWithContext } from "@moonsjs/server";
+import { createRpcHandler, runWithContext, runWithRequestCache } from "@moonsjs/server";
 import { ERROR_ROUTE_KEY, NOT_FOUND_ROUTE_KEY } from "../manifest";
 import type { Shell } from "./shell";
 
@@ -28,6 +30,11 @@ export interface RequestHandlerOptions {
   /** Peta import() modul route, key = routeKeyFromFile. */
   loadRoute: Record<string, () => Promise<RouteModule>>;
   shell: Shell;
+  /**
+   * Dipanggil setelah `config.context` per request (Addendum B.4: extender
+   * `extendContext` plugin di-merge ke ctx).
+   */
+  onContext?: (ctx: Ctx) => void;
 }
 
 /**
@@ -63,6 +70,8 @@ export function createRequestHandler(
     const entry: ClientRouteEntry = { page: pageKey, layouts: keys.slice(0, -1) };
     // Addendum A.3: query string ikut ke payload agar server/client identik.
     const searchParams = Object.fromEntries(new URL(request.url).searchParams);
+    // Addendum B.1: eksekusi `meta()` page (data = hasil loader page itu sendiri).
+    const meta = await runRouteMeta(pageModule, data[pageKey], resolved.route.file);
 
     const markup = renderToMarkup(
       entry,
@@ -76,9 +85,10 @@ export function createRequestHandler(
       params: resolved.params,
       searchParams,
       data,
+      ...(meta === undefined ? {} : { meta }),
     });
 
-    return htmlResponse(await shell(markup, payload, request.url), 200);
+    return htmlResponse(await shell(markup, payload, request.url, meta), 200);
   }
 
   /** §11.2: halaman `_404.tsx` kustom (standalone), fallback bawaan. */
@@ -159,6 +169,7 @@ export function createRequestHandler(
       // batas runtime ini. Tanpa cast, tsc app user yang memuat `@moonsjs/vite/server`
       // (mis. `createTestServer` §19.5) melihat `unknown` vs `Ctx` global app.
       const ctx = (await config.context(request)) as Ctx;
+      options.onContext?.(ctx);
 
       const respond = composeMiddleware(config.middleware ?? [], ctx, async () => {
         if (url.pathname.startsWith(RPC_PREFIX)) {
@@ -171,11 +182,21 @@ export function createRequestHandler(
         try {
           return await renderRoute(resolved, request, ctx);
         } catch (error) {
+          // Addendum B.2: sinyal routing dari loader/meta.
+          if (isRedirectSignal(error)) {
+            return new Response(null, {
+              status: error.status,
+              headers: { location: new URL(error.to, request.url).toString() },
+            });
+          }
+          if (isNotFoundSignal(error)) {
+            return await notFoundResponse(request);
+          }
           return await routeErrorResponse(error, request);
         }
       });
 
-      return await runWithContext(ctx, () => respond(request));
+      return await runWithRequestCache(() => runWithContext(ctx, () => respond(request)));
     } catch (error) {
       return internalErrorResponse(error);
     }
@@ -202,6 +223,40 @@ async function loadModules(
   );
 }
 
+async function runRouteMeta(
+  pageModule: RouteModule,
+  pageData: unknown,
+  file: string,
+): Promise<Record<string, unknown> | undefined> {
+  const meta = (pageModule as { meta?: unknown }).meta;
+  if (meta === undefined) {
+    return undefined;
+  }
+  if (typeof meta !== "function") {
+    throw new MoonsError({
+      code: "E_INTERNAL",
+      file,
+      message: "export `meta` harus berupa fungsi `({ data }) => RouteMeta`",
+      details: "Bentuk `meta` mengikuti PRD §11.2 (Addendum B.1).",
+      suggestions: [
+        "Ubah menjadi `export const meta = ({ data }) => ({ title: \"...\" })`",
+        "Atau hapus export `meta`",
+      ],
+    });
+  }
+  const result = await (meta as (args: { data: unknown }) => unknown)({ data: pageData });
+  if (result === null || typeof result !== "object" || Array.isArray(result)) {
+    throw new MoonsError({
+      code: "E_INTERNAL",
+      file,
+      message: "`meta()` harus mengembalikan objek RouteMeta",
+      details: "Nilai yang dikembalikan dipakai untuk <title>/description/og (Addendum B.1).",
+      suggestions: ["Kembalikan objek, mis. `({ title: \"Halaman\" })`"],
+    });
+  }
+  return result as Record<string, unknown>;
+}
+
 function internalErrorResponse(error: unknown, options: { log?: boolean } = {}): Response {
   if (options.log !== false) {
     console.error("[moons] request error:", error);

package/src/server/index.ts

@@ -10,3 +10,5 @@ export { createTestServer } from "./test-server";
 export type { TestServer, TestServerOptions } from "./test-server";
 export { sendNodeResponse, toWebRequest } from "./node";
 export { installDevMiddleware } from "./dev";
+export { createPluginRuntime } from "./plugins";
+export type { PluginRuntime, PluginRuntimeOptions } from "./plugins";

package/src/server/node-server.ts

@@ -2,6 +2,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import { createServer, type Server } from "node:http";
 import { extname, join, resolve, sep } from "node:path";
 import { sendNodeResponse, toWebRequest } from "./node";
+import type { PluginRuntime } from "./plugins";
 import { installGracefulShutdown } from "./shutdown";
 
 const MIME_TYPES: Record<string, string> = {
@@ -33,6 +34,8 @@ export interface NodeServerOptions {
   handleSignals?: boolean;
   /** Batas drain shutdown (default 10_000 ms). */
   shutdownTimeoutMs?: number;
+  /** Lifecycle plugin (Addendum B.4) — onStart/onReady/onShutdown. */
+  plugins?: PluginRuntime;
 }
 
 /**
@@ -73,17 +76,28 @@ export function startNodeServer(
     })();
   });
 
-  server.listen(port, () => {
-    const address = server.address();
-    const boundPort = typeof address === "object" && address !== null ? address.port : port;
-    console.log(`[moons] server listening on http://localhost:${boundPort}`);
-  });
+  // Addendum B.4: onStart sebelum listen, onReady setelah listen.
+  const listenAfterStart = (): void => {
+    server.listen(port, () => {
+      const address = server.address();
+      const boundPort = typeof address === "object" && address !== null ? address.port : port;
+      console.log(`[moons] server listening on http://localhost:${boundPort}`);
+      void options.plugins?.ready();
+    });
+  };
+  if (options.plugins !== undefined) {
+    void options.plugins.start().then(listenAfterStart);
+  } else {
+    listenAfterStart();
+  }
 
   if (options.handleSignals !== false) {
-    const shutdown = installGracefulShutdown(
-      server,
-      options.shutdownTimeoutMs === undefined ? {} : { timeoutMs: options.shutdownTimeoutMs },
-    );
+    const shutdown = installGracefulShutdown(server, {
+      ...(options.shutdownTimeoutMs === undefined ? {} : { timeoutMs: options.shutdownTimeoutMs }),
+      ...(options.plugins === undefined
+        ? {}
+        : { onShutdown: () => options.plugins?.shutdown() }),
+    });
     // `once`: sinyal kedua memakai perilaku default (proses langsung berhenti).
     process.once("SIGTERM", () => shutdown("SIGTERM"));
     process.once("SIGINT", () => shutdown("SIGINT"));

package/src/server/plugins.ts

@@ -0,0 +1,85 @@
+import { MOONS_VERSION, type App, type Middleware, type MoonsConfig, type RouteDefinition } from "@moonsjs/core";
+
+/**
+ * Eksekusi lifecycle plugin (PRD §14.4 / Addendum B.4).
+ * Urutan: registrasi (addRoute per route → addMiddleware per middleware →
+ * extendContext(register)) → onStart → ready/onReady → shutdown/onShutdown.
+ */
+export interface PluginRuntime {
+  readonly app: App;
+  /** Registrasi + `onStart` (sebelum server siap). */
+  start(): Promise<void>;
+  /** Tandai `app.ready = true` lalu panggil `onReady` (server siap). */
+  ready(): Promise<void>;
+  /** Panggil `onShutdown` (selama drain; error dilaporkan, tidak menggagalkan). */
+  shutdown(): Promise<void>;
+  /** Terapkan extender `extendContext` ke ctx request (dipanggil handler). */
+  applyExtensions(ctx: unknown): void;
+}
+
+export interface PluginRuntimeOptions {
+  config: MoonsConfig;
+  routes: RouteDefinition[];
+  /** Rantai middleware final (config.middleware). */
+  middlewares: Middleware[];
+  log?: (message: string) => void;
+}
+
+export function createPluginRuntime(options: PluginRuntimeOptions): PluginRuntime {
+  const log = options.log ?? ((message: string) => console.warn(message));
+  const plugins = options.config.plugins ?? [];
+  const state = { ready: false, version: MOONS_VERSION };
+  const app = state as App;
+  const extensions: Array<(ctx: unknown) => unknown> = [];
+  const register = (fn: (ctx: unknown) => unknown): void => {
+    extensions.push(fn);
+  };
+
+  // Fase registrasi (sinkron): addRoute → addMiddleware → extendContext.
+  for (const plugin of plugins) {
+    for (const route of options.routes) {
+      // Objek beku: hook bersifat observasi di v1 (lihat docs/decisions/0022).
+      const frozen = Object.freeze({
+        ...route,
+        params: [...route.params],
+      }) as RouteDefinition;
+      plugin.addRoute?.(frozen);
+    }
+    for (const middleware of options.middlewares) {
+      plugin.addMiddleware?.(middleware);
+    }
+    plugin.extendContext?.(register as never);
+  }
+
+  return {
+    app,
+    async start(): Promise<void> {
+      for (const plugin of plugins) {
+        await plugin.onStart?.(app);
+      }
+    },
+    async ready(): Promise<void> {
+      state.ready = true;
+      for (const plugin of plugins) {
+        await plugin.onReady?.(app);
+      }
+    },
+    async shutdown(): Promise<void> {
+      for (const plugin of plugins) {
+        try {
+          await plugin.onShutdown?.(app);
+        } catch (error) {
+          log(`[moons] plugin \`${plugin.name}\` gagal saat onShutdown: ${String(error)}`);
+        }
+      }
+    },
+    applyExtensions(ctx: unknown): void {
+      for (const extend of extensions) {
+        const result = extend(ctx);
+        if (result !== null && typeof result === "object" && !Array.isArray(result)) {
+          Object.assign(ctx as Record<string, unknown>, result);
+        }
+      }
+    },
+  };
+}

package/src/server/shell.ts

@@ -3,7 +3,12 @@ import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import type { ViteDevServer } from "vite";
 
-export type Shell = (markup: string, payload: string, url: string) => string | Promise<string>;
+export type Shell = (
+  markup: string,
+  payload: string,
+  url: string,
+  meta?: Record<string, unknown>,
+) => string | Promise<string>;
 
 export const ROOT_PLACEHOLDER = '<div id="root"></div>';
 
@@ -23,8 +28,13 @@ export const DEFAULT_TEMPLATE = [
   "",
 ].join("\n");
 
-/** Inject markup SSR + payload devalue ke shell HTML (PRD §8.2, §17). */
-export function injectShell(template: string, markup: string, payload: string): string {
+/** Inject markup SSR + payload devalue ke shell HTML (PRD §8.2, §17, Addendum B.1). */
+export function injectShell(
+  template: string,
+  markup: string,
+  payload: string,
+  meta?: Record<string, unknown>,
+): string {
   if (!template.includes(ROOT_PLACEHOLDER)) {
     throw new MoonsError({
       code: "E_INTERNAL",
@@ -37,7 +47,51 @@ export function injectShell(template: string, markup: string, payload: string):
     });
   }
   const dataScript = `<script id="__moons_data" type="application/x-moons">${payload}</script>`;
-  return template.replace(ROOT_PLACEHOLDER, `<div id="root">${markup}</div>${dataScript}`);
+  const withRoot = template.replace(ROOT_PLACEHOLDER, `<div id="root">${markup}</div>${dataScript}`);
+  return applyMeta(withRoot, meta);
+}
+
+function escapeHtml(value: string): string {
+  return value
+    .replaceAll("&", "&amp;")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;");
+}
+
+/**
+ * Terapkan meta route ke `<head>` (Addendum B.1): `<title>` + description/og.
+ * Tag yang sudah ada (mis. di index.html) ditimpa; yang belum ada disisipkan
+ * sebelum `</head>`.
+ */
+function applyMeta(html: string, meta: Record<string, unknown> | undefined): string {
+  if (meta === undefined) {
+    return html;
+  }
+  let out = html;
+  if (typeof meta.title === "string") {
+    const title = `<title>${escapeHtml(meta.title)}</title>`;
+    out = /<title>[\s\S]*?<\/title>/.test(out)
+      ? out.replace(/<title>[\s\S]*?<\/title>/, title)
+      : out.replace("</head>", `  ${title}\n</head>`);
+  }
+
+  const tags: Array<{ attr: "name" | "property"; key: string; value: unknown }> = [
+    { attr: "name", key: "description", value: meta.description },
+    { attr: "property", key: "og:title", value: meta.title },
+    { attr: "property", key: "og:description", value: meta.description },
+  ];
+  for (const tag of tags) {
+    if (typeof tag.value !== "string") {
+      continue;
+    }
+    const rendered = `<meta ${tag.attr}="${tag.key}" content="${escapeHtml(tag.value)}" />`;
+    const pattern = new RegExp(`<meta[^>]*${tag.attr}="${tag.key}"[^>]*>`);
+    out = pattern.test(out)
+      ? out.replace(pattern, rendered)
+      : out.replace("</head>", `  ${rendered}\n</head>`);
+  }
+  return out;
 }
 
 /**
@@ -45,11 +99,11 @@ export function injectShell(template: string, markup: string, payload: string):
  * lalu lewatkan ke Vite `transformIndexHtml` (inject `/@vite/client`, dsb).
  */
 export function createDevShell(server: ViteDevServer, options: { templatePath: string }): Shell {
-  return async (markup, payload, url) => {
+  return async (markup, payload, url, meta) => {
     const template = existsSync(options.templatePath)
       ? readFileSync(options.templatePath, "utf8")
       : DEFAULT_TEMPLATE;
-    const html = injectShell(template, markup, payload);
+    const html = injectShell(template, markup, payload, meta);
     return await server.transformIndexHtml(url, html);
   };
 }
@@ -57,7 +111,7 @@ export function createDevShell(server: ViteDevServer, options: { templatePath: s
 /** Shell untuk produksi: baca `dist/client/index.html` sekali dari cwd. */
 export function createFileShell(options: { clientDir?: string } = {}): Shell {
   let cached: string | null = null;
-  return async (markup, payload) => {
+  return async (markup, payload, _url, meta) => {
     if (cached === null) {
       const clientDir = resolve(options.clientDir ?? process.cwd(), "dist/client");
       const file = join(clientDir, "index.html");
@@ -72,6 +126,6 @@ export function createFileShell(options: { clientDir?: string } = {}): Shell {
       }
       cached = readFileSync(file, "utf8");
     }
-    return injectShell(cached, markup, payload);
+    return injectShell(cached, markup, payload, meta);
   };
 }

package/src/server/shutdown.ts

@@ -6,6 +6,12 @@ export interface ShutdownOptions {
   log?: (message: string) => void;
   /** Injectable untuk test; default `process.exit`. */
   exit?: (code: number) => void;
+  /**
+   * Dipanggil setelah drain penuh, sebelum exit (Addendum B.4: onShutdown
+   * plugin). Berbagi batas waktu dengan drain; error dilaporkan, tidak
+   * menggagalkan shutdown.
+   */
+  onShutdown?: () => void | Promise<void>;
 }
 
 /**
@@ -50,13 +56,24 @@ export function installGracefulShutdown(
       // abaikan: fallback timeout tetap ada
     }
 
-    server.close((error?: Error) => {
-      clearTimeout(timer);
+    server.close(async (error?: Error) => {
       if (error !== undefined) {
+        clearTimeout(timer);
         log(`[moons] penutupan server gagal: ${error.message}`);
         exit(1);
         return;
       }
+      if (options.onShutdown !== undefined) {
+        // Tetap berbagi batas waktu dengan drain: timer di-ref kembali agar
+        // proses tidak keluar sebelum hook selesai.
+        (timer as { ref?: () => void }).ref?.();
+        try {
+          await options.onShutdown();
+        } catch (hookError) {
+          log(`[moons] onShutdown gagal: ${String(hookError)}`);
+        }
+      }
+      clearTimeout(timer);
       log("[moons] shutdown selesai (drain penuh)");
       exit(0);
     });

package/src/server/test-server.ts

@@ -26,7 +26,8 @@ export function createTestServer(
   baseUrl = "http://localhost",
 ): TestServer {
   const shell: Shell =
-    options.shell ?? ((markup, payload) => injectShell(DEFAULT_TEMPLATE, markup, payload));
+    options.shell ??
+    ((markup, payload, _url, meta) => injectShell(DEFAULT_TEMPLATE, markup, payload, meta));
 
   const handler = createRequestHandler({
     routes: options.routes,

package/dist/index-1sm9pvvd.js.map

@@ -1,14 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/server/shell.ts", "../src/server/node.ts", "../src/virtual-modules.ts", "../src/server/dev.ts", "../src/manifest.ts"],
-  "sourcesContent": [
-    "import { MoonsError } from \"@moonsjs/core\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport type { ViteDevServer } from \"vite\";\n\nexport type Shell = (markup: string, payload: string, url: string) => string | Promise<string>;\n\nexport const ROOT_PLACEHOLDER = '<div id=\"root\"></div>';\n\nexport const DEFAULT_TEMPLATE = [\n  \"<!doctype html>\",\n  '<html lang=\"id\">',\n  \"<head>\",\n  '  <meta charset=\"utf-8\" />',\n  '  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />',\n  \"  <title>Moons</title>\",\n  \"</head>\",\n  \"<body>\",\n  `  ${ROOT_PLACEHOLDER}`,\n  '  <script type=\"module\" src=\"/src/client/main.tsx\"></script>',\n  \"</body>\",\n  \"</html>\",\n  \"\",\n].join(\"\\n\");\n\n/** Inject markup SSR + payload devalue ke shell HTML (PRD §8.2, §17). */\nexport function injectShell(template: string, markup: string, payload: string): string {\n  if (!template.includes(ROOT_PLACEHOLDER)) {\n    throw new MoonsError({\n      code: \"E_INTERNAL\",\n      message: `shell HTML tidak memuat \\`${ROOT_PLACEHOLDER}\\``,\n      details: \"index.html aplikasi wajib memuat elemen root tersebut agar SSR bisa meng-inject markup.\",\n      suggestions: [\n        `Tambahkan ${ROOT_PLACEHOLDER} ke index.html`,\n        \"Atau hapus index.html untuk memakai shell bawaan\",\n      ],\n    });\n  }\n  const dataScript = `<script id=\"__moons_data\" type=\"application/x-moons\">${payload}</script>`;\n  return template.replace(ROOT_PLACEHOLDER, `<div id=\"root\">${markup}</div>${dataScript}`);\n}\n\n/**\n * Shell untuk dev: baca `index.html` dari disk setiap request (selalu segar)\n * lalu lewatkan ke Vite `transformIndexHtml` (inject `/@vite/client`, dsb).\n */\nexport function createDevShell(server: ViteDevServer, options: { templatePath: string }): Shell {\n  return async (markup, payload, url) => {\n    const template = existsSync(options.templatePath)\n      ? readFileSync(options.templatePath, \"utf8\")\n      : DEFAULT_TEMPLATE;\n    const html = injectShell(template, markup, payload);\n    return await server.transformIndexHtml(url, html);\n  };\n}\n\n/** Shell untuk produksi: baca `dist/client/index.html` sekali dari cwd. */\nexport function createFileShell(options: { clientDir?: string } = {}): Shell {\n  let cached: string | null = null;\n  return async (markup, payload) => {\n    if (cached === null) {\n      const clientDir = resolve(options.clientDir ?? process.cwd(), \"dist/client\");\n      const file = join(clientDir, \"index.html\");\n      if (!existsSync(file)) {\n        throw new MoonsError({\n          code: \"E_INTERNAL\",\n          file,\n          message: \"`dist/client/index.html` tidak ditemukan\",\n          details: \"Build client harus dijalankan sebelum server produksi dinyalakan (PRD §18).\",\n          suggestions: [\"Jalankan `bun run build` lebih dulu\"],\n        });\n      }\n      cached = readFileSync(file, \"utf8\");\n    }\n    return injectShell(cached, markup, payload);\n  };\n}\n",
-    "import type { IncomingMessage, ServerResponse } from \"node:http\";\n\nconst MAX_BODY_BYTES = 32 * 1024 * 1024; // batas defensif transport; limit RPC §7.3 tetap berlaku\n\n/** Konversi request Node → Web `Request` (body diteruskan untuk non-GET/HEAD, §7.3). */\nexport async function toWebRequest(req: IncomingMessage): Promise<Request> {\n  const host = req.headers.host ?? \"localhost\";\n  const url = `http://${host}${req.url ?? \"/\"}`;\n  const method = req.method ?? \"GET\";\n\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined || key === \"content-length\") {\n      // content-length tidak disalin; fetch menghitung ulang dari body.\n      continue;\n    }\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        headers.append(key, item);\n      }\n    } else {\n      headers.set(key, value);\n    }\n  }\n\n  if (method === \"GET\" || method === \"HEAD\") {\n    return new Request(url, { method, headers });\n  }\n\n  const body = await readBody(req);\n  return new Request(url, { method, headers, body: new Uint8Array(body) });\n}\n\nfunction readBody(req: IncomingMessage): Promise<Buffer> {\n  return new Promise((resolvePromise, reject) => {\n    const chunks: Buffer[] = [];\n    let size = 0;\n\n    req.on(\"data\", (chunk: Buffer) => {\n      size += chunk.length;\n      if (size > MAX_BODY_BYTES) {\n        req.destroy();\n        reject(new Error(\"request body melebihi batas transport\"));\n        return;\n      }\n      chunks.push(chunk);\n    });\n    req.on(\"end\", () => resolvePromise(Buffer.concat(chunks)));\n    req.on(\"error\", (error) => reject(error));\n  });\n}\n\n/** Tulis Web `Response` ke `ServerResponse` Node. */\nexport async function sendNodeResponse(res: ServerResponse, response: Response): Promise<void> {\n  res.statusCode = response.status;\n  response.headers.forEach((value, key) => {\n    res.setHeader(key, value);\n  });\n  const body = Buffer.from(await response.arrayBuffer());\n  res.end(body);\n}\n",
-    "/** Nama virtual module PRD §9.4. Semua di-resolve ke id `\\0`-prefix. */\nexport const VIRTUAL_MODULES = {\n  routes: \"virtual:moons/routes\",\n  config: \"virtual:moons/config\",\n  clientEntry: \"virtual:moons/client-entry\",\n  serverEntry: \"virtual:moons/server-entry\",\n} as const;\n\nexport type VirtualModuleName = (typeof VIRTUAL_MODULES)[keyof typeof VIRTUAL_MODULES];\n\nexport function isVirtualModuleId(id: string): id is VirtualModuleName {\n  const clean = id.startsWith(\"\\0\") ? id.slice(1) : id;\n  return (Object.values(VIRTUAL_MODULES) as string[]).includes(clean);\n}\n\nexport function toNullPrefixed(id: VirtualModuleName): `\\0${string}` {\n  return `\\0${id}`;\n}\n\nexport function fromNullPrefixed(id: string): VirtualModuleName | null {\n  const clean = id.startsWith(\"\\0\") ? id.slice(1) : id;\n  return isVirtualModuleId(clean) ? (clean as VirtualModuleName) : null;\n}\n",
-    "import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport type { ViteDevServer } from \"vite\";\nimport { VIRTUAL_MODULES } from \"../virtual-modules\";\nimport type { Shell } from \"./shell\";\nimport { createDevShell } from \"./shell\";\nimport { sendNodeResponse, toWebRequest } from \"./node\";\n\ntype DevServerEntry = {\n  createDevHandler: (shell: Shell) => (request: Request) => Promise<Response>;\n};\n\n/**\n * Middleware SSR dev: dipasang sebelum middleware internal Vite, menangani\n * request HTML dan RPC serverFn (`/_moons/fn/*`) — modul/aset tetap Vite.\n */\nexport function installDevMiddleware(\n  server: ViteDevServer,\n  options: { templatePath: string },\n): void {\n  server.middlewares.use((req, res, next) => {\n    if (!shouldHandle(req)) {\n      next();\n      return;\n    }\n    void handleRequest(server, options)(req, res).catch((error: unknown) => {\n      next(error as Error);\n    });\n  });\n}\n\nfunction handleRequest(server: ViteDevServer, options: { templatePath: string }) {\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    const entry = (await server.ssrLoadModule(VIRTUAL_MODULES.serverEntry)) as DevServerEntry;\n    const handler = entry.createDevHandler(createDevShell(server, options));\n    const response = await handler(await toWebRequest(req));\n    await sendNodeResponse(res, response);\n  };\n}\n\nfunction shouldHandle(req: IncomingMessage): boolean {\n  const path = new URL(req.url ?? \"/\", \"http://localhost\").pathname;\n\n  // RPC serverFn (semua method): dulu hanya GET/HEAD HTML yang dirutekan,\n  // sehingga `POST /_moons/fn/<hash>` jatuh ke Vite (\"Cannot POST\", 404) dan\n  // serverFn tidak bisa dipakai di dev (temuan eval T2 ronde 2; decisions/0016).\n  if (path.startsWith(\"/_moons/fn/\")) {\n    return true;\n  }\n\n  if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n    return false;\n  }\n  if (path.startsWith(\"/@\") || path.startsWith(\"/node_modules/\") || path.startsWith(\"/__\")) {\n    return false;\n  }\n  const lastSegment = path.split(\"/\").pop() ?? \"\";\n  if (lastSegment.includes(\".\")) {\n    return false;\n  }\n  const accept = req.headers.accept ?? \"\";\n  return accept.includes(\"text/html\") || accept.includes(\"*/*\");\n}\n",
-    "import { findLayouts, routeKeyFromFile, type RouteDefinition } from \"@moonsjs/core\";\nimport { relative, sep } from \"node:path\";\n\nexport interface ClientManifestEntry {\n  page: string;\n  layouts: string[];\n}\n\n/** Key manifest untuk halaman kustom `_404` dan `_error` (§11.2). */\nexport const NOT_FOUND_ROUTE_KEY = \"__moons/404\";\nexport const ERROR_ROUTE_KEY = \"__moons/error\";\n\n/**\n * Manifest route untuk client (PRD §8.2): key = key route file\n * (routeKeyFromFile), nilai = page + layout chain dari root ke leaf.\n */\nexport function buildClientManifest(\n  routes: RouteDefinition[],\n  routesDir: string,\n): Record<string, ClientManifestEntry> {\n  const manifest: Record<string, ClientManifestEntry> = {};\n  for (const route of routes) {\n    if (route.kind !== \"page\") {\n      continue;\n    }\n    const key = routeKeyFromFile(routesDir, route.file);\n    manifest[key] = {\n      page: key,\n      layouts: findLayouts(route, routes).map((layout) => routeKeyFromFile(routesDir, layout.file)),\n    };\n  }\n\n  const notFound = routes.find((route) => route.kind === \"404\");\n  if (notFound !== undefined) {\n    manifest[NOT_FOUND_ROUTE_KEY] = { page: routeKeyFromFile(routesDir, notFound.file), layouts: [] };\n  }\n  const errorRoute = routes.find((route) => route.kind === \"error\");\n  if (errorRoute !== undefined) {\n    manifest[ERROR_ROUTE_KEY] = { page: routeKeyFromFile(routesDir, errorRoute.file), layouts: [] };\n  }\n\n  return manifest;\n}\n\n/**\n * Isi `virtual:moons/routes`: daftar RouteDefinition, manifest client, dan\n * peta import() dinamis per file route (specifier root-relative).\n */\nexport function renderRoutesModule(\n  routes: RouteDefinition[],\n  routesDir: string,\n  projectRoot: string,\n): string {\n  const manifest = buildClientManifest(routes, routesDir);\n\n  const loadEntries = routes.map((route) => {\n    const key = routeKeyFromFile(routesDir, route.file);\n    return `  ${JSON.stringify(key)}: () => import(${JSON.stringify(rootSpecifier(projectRoot, route.file))}),`;\n  });\n\n  return [\n    \"// Generated by @moons. Jangan diubah manual.\",\n    `export const routes = ${JSON.stringify(routes, null, 2)};`,\n    \"\",\n    `export const clientManifest = ${JSON.stringify(manifest, null, 2)};`,\n    \"\",\n    \"export const loadRoute = {\",\n    ...loadEntries,\n    \"};\",\n    \"\",\n  ].join(\"\\n\");\n}\n\n/** Path file absolut project → specifier root-relative yang bisa di-resolve Vite. */\nexport function rootSpecifier(projectRoot: string, file: string): string {\n  let rel = relative(projectRoot, file);\n  rel = sep === \"/\" ? rel : rel.split(sep).join(\"/\");\n  return rel.startsWith(\"/\") ? rel : `/${rel}`;\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "6E6FBA2917FCE4BD64756E2164756E21",
-  "names": []
-}