@finesoft/front 0.1.19 → 0.1.21

package/dist/index.js

@@ -7,17 +7,18 @@ import {
   registerFlowActionHandler,
   startBrowserApp,
   tryScroll
-} from "./chunk-T2AQHAYK.js";
+} from "./chunk-H3RNYNSD.js";
 import {
   createSSRApp
-} from "./chunk-Z4MHYAS3.js";
+} from "./chunk-IITKGRCO.js";
 import {
   SSR_PLACEHOLDERS,
   createSSRRender,
+  injectCSRShell,
   injectSSRContent,
   serializeServerData,
   ssrRender
-} from "./chunk-2VETWTN5.js";
+} from "./chunk-5ZECBECP.js";
 import {
   ACTION_KINDS,
   ActionDispatcher,
@@ -57,7 +58,7 @@ import {
   resetFilterCache,
   shouldLog,
   stableStringify
-} from "./chunk-RVKDILGM.js";
+} from "./chunk-BUYWNNNQ.js";
 import {
   parseAcceptLanguage
 } from "./chunk-FYP2ZYYV.js";
@@ -75,6 +76,20 @@ function generateSSREntry(ctx, opts) {
   const setupCall = ctx.setupPath ? `if (typeof _setupDefault === "function") await _setupDefault(app);` : ``;
   const locales = JSON.stringify(ctx.locales);
   const defaultLocale = JSON.stringify(ctx.defaultLocale);
+  const renderModes = JSON.stringify(ctx.renderModes ?? {});
+  const cacheImpl = opts.platformCache ? opts.platformCache : `
+const ISR_CACHE_MAX = 1000;
+const _isrMap = new Map();
+async function platformCacheGet(url) {
+  return _isrMap.get(url) ?? null;
+}
+async function platformCacheSet(url, html) {
+  if (_isrMap.size >= ISR_CACHE_MAX) {
+    const first = _isrMap.keys().next().value;
+    _isrMap.delete(first);
+  }
+  _isrMap.set(url, html);
+}`;
   return `
 import { Hono } from "hono";
 ${opts.platformImport}
@@ -84,6 +99,8 @@ ${setupImport}
 const TEMPLATE = ${JSON.stringify(ctx.templateHtml)};
 const LOCALES = ${locales};
 const DEFAULT_LOCALE = ${defaultLocale};
+const RENDER_MODES = ${renderModes};
+${cacheImpl}
 
 function parseAcceptLanguage(header) {
   if (!header) return DEFAULT_LOCALE;
@@ -106,16 +123,62 @@ function injectSSR(t, locale, head, css, html, data) {
     .replace("<!--ssr-data-->", '<script id="serialized-server-data" type="application/json">' + data + "</script>");
 }
 
+function injectCSRShell(t, locale) {
+  return t
+    .replace("<!--ssr-lang-->", locale)
+    .replace("<!--ssr-head-->", "")
+    .replace("<!--ssr-body-->", "")
+    .replace("<!--ssr-data-->", "");
+}
+
+function matchRenderMode(url) {
+  const path = url.split("?")[0];
+  if (RENDER_MODES[path]) return RENDER_MODES[path];
+  for (const [pattern, mode] of Object.entries(RENDER_MODES)) {
+    if (pattern.includes("*")) {
+      const re = new RegExp("^" + pattern.replace(/\\*/g, ".*") + "$");
+      if (re.test(path)) return mode;
+    }
+  }
+  return null;
+}
+
 const app = new Hono();
 ${setupCall}
+${opts.platformMiddleware ?? ""}
 
 app.get("*", async (c) => {
   const url = c.req.path + (c.req.url.includes("?") ? "?" + c.req.url.split("?")[1] : "");
   try {
     const locale = parseAcceptLanguage(c.req.header("accept-language"));
-    const { html: appHtml, head, css, serverData } = await render(url, locale);
+
+    // Vite \u914D\u7F6E\u7EA7\u522B\u8986\u76D6: CSR \u76F4\u63A5\u8FD4\u56DE\u7A7A\u58F3
+    const overrideMode = matchRenderMode(url);
+    if (overrideMode === "csr") {
+      return c.html(injectCSRShell(TEMPLATE, locale));
+    }
+
+    // ISR \u7F13\u5B58\u547D\u4E2D
+    const cached = await platformCacheGet(url);
+    if (cached) return c.html(cached);
+
+    const { html: appHtml, head, css, serverData, renderMode } = await render(url, locale);
+
+    // \u8DEF\u7531\u7EA7 CSR
+    if (renderMode === "csr") {
+      return c.html(injectCSRShell(TEMPLATE, locale));
+    }
+
     const serializedData = serializeServerData(serverData);
-    return c.html(injectSSR(TEMPLATE, locale, head, css, appHtml, serializedData));
+    const finalHtml = injectSSR(TEMPLATE, locale, head, css, appHtml, serializedData);
+
+    // Prerender ISR \u7F13\u5B58\uFF08\u5305\u62EC Vite \u914D\u7F6E\u8986\u76D6\u548C\u8DEF\u7531\u7EA7\uFF09
+    if (renderMode === "prerender" || overrideMode === "prerender") {
+      await platformCacheSet(url, finalHtml);
+      ${opts.platformPrerenderResponseHook ?? ""}
+    }
+
+    return c.html(finalHtml);
   } catch (e) {
     console.error("[SSR Error]", e);
     return c.text("Internal Server Error", 500);
@@ -154,6 +217,89 @@ function copyStaticAssets(ctx, destDir, opts) {
     fs.rmSync(path.join(destDir, "index.html"), { force: true });
   }
 }
+async function prerenderRoutes(ctx, routesExport = "src/lib/bootstrap.ts") {
+  const { fs, path, root, vite } = ctx;
+  const { pathToFileURL } = await import(
+    /* @vite-ignore */
+    "url"
+  );
+  await vite.build({
+    root,
+    build: {
+      ssr: routesExport,
+      outDir: path.resolve(root, "dist/server"),
+      emptyOutDir: false,
+      rollupOptions: {
+        output: { entryFileNames: "_routes_prerender.mjs" }
+      }
+    },
+    resolve: ctx.resolvedResolve
+  });
+  const routesPath = pathToFileURL(
+    path.resolve(root, "dist/server/_routes_prerender.mjs")
+  ).href;
+  const routesMod = await import(
+    /* @vite-ignore */
+    routesPath
+  );
+  const routes = routesMod.routes ?? routesMod.default ?? [];
+  fs.rmSync(path.resolve(root, "dist/server/_routes_prerender.mjs"), {
+    force: true
+  });
+  const prerenderPaths = /* @__PURE__ */ new Set();
+  for (const r of routes) {
+    if (r.renderMode === "prerender" && r.path && !r.path.includes(":")) {
+      prerenderPaths.add(r.path);
+    }
+  }
+  if (ctx.renderModes) {
+    for (const [pattern, mode] of Object.entries(ctx.renderModes)) {
+      if (mode === "prerender" && !pattern.includes("*") && !pattern.includes(":")) {
+        prerenderPaths.add(pattern);
+      }
+    }
+  }
+  if (prerenderPaths.size === 0) return [];
+  const ssrPath = pathToFileURL(
+    path.resolve(root, "dist/server/ssr.js")
+  ).href;
+  const ssrModule = await import(
+    /* @vite-ignore */
+    ssrPath
+  );
+  const results = [];
+  for (const routePath of prerenderPaths) {
+    for (const locale of ctx.locales) {
+      const url = locale === ctx.defaultLocale ? routePath : `/${locale}${routePath === "/" ? "" : routePath}`;
+      try {
+        const {
+          html: appHtml,
+          head,
+          css,
+          serverData
+        } = await ssrModule.render(url, locale);
+        const serializedData = ssrModule.serializeServerData(serverData);
+        const finalHtml = ctx.templateHtml.replace("<!--ssr-lang-->", locale).replace(
+          "<!--ssr-head-->",
+          head + "\n<style>" + css + "</style>"
+        ).replace("<!--ssr-body-->", appHtml).replace(
+          "<!--ssr-data-->",
+          '<script id="serialized-server-data" type="application/json">' + serializedData + "</script>"
+        );
+        results.push({ url, html: finalHtml });
+      } catch (e) {
+        console.warn(`  [prerender] Failed to render ${url}:`, e);
+      }
+    }
+  }
+  if (results.length > 0) {
+    console.log(
+      `  Pre-rendered ${results.length} pages (${prerenderPaths.size} routes \xD7 ${ctx.locales.length} locales)
+`
+    );
+  }
+  return results;
+}
 
 // ../server/src/adapters/cloudflare.ts
 function cloudflareAdapter() {
@@ -165,7 +311,29 @@ function cloudflareAdapter() {
       fs.rmSync(outputDir, { recursive: true, force: true });
       const entrySource = generateSSREntry(ctx, {
         platformImport: ``,
-        platformExport: `export default app;`
+        platformExport: `export default app;`,
+        // Cloudflare Cache API — 持久化 ISR 缓存到 CDN 边缘节点
+        platformCache: `
+const ISR_CACHE_TTL = 3600; // 1 hour
+async function platformCacheGet(url) {
+  try {
+    const cache = caches.default;
+    const cacheKey = new Request("https://isr-cache/" + encodeURIComponent(url));
+    const resp = await cache.match(cacheKey);
+    if (resp) return await resp.text();
+  } catch {}
+  return null;
+}
+async function platformCacheSet(url, html) {
+  try {
+    const cache = caches.default;
+    const cacheKey = new Request("https://isr-cache/" + encodeURIComponent(url));
+    const resp = new Response(html, {
+      headers: { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "public, max-age=" + ISR_CACHE_TTL },
+    });
+    await cache.put(cacheKey, resp);
+  } catch {}
+}`
       });
       const tempEntry = path.resolve(root, ".cf-entry.tmp.mjs");
       fs.writeFileSync(tempEntry, entrySource);
@@ -179,6 +347,14 @@ function cloudflareAdapter() {
           // 这些构建工具运行时不需要，且 fsevents 是 macOS .node 原生二进制无法打包
         });
         copyStaticAssets(ctx, path.resolve(outputDir, "assets"));
+        const prerendered = await prerenderRoutes(ctx);
+        for (const { url, html } of prerendered) {
+          const filePath = url === "/" ? path.join(outputDir, "assets", "index.html") : path.join(outputDir, "assets", url, "index.html");
+          fs.mkdirSync(path.resolve(filePath, ".."), {
+            recursive: true
+          });
+          fs.writeFileSync(filePath, html);
+        }
       } finally {
         fs.rmSync(tempEntry, { force: true });
       }
@@ -203,7 +379,25 @@ function netlifyAdapter() {
       });
       const entrySource = generateSSREntry(ctx, {
         platformImport: `import { handle } from "hono/netlify";`,
-        platformExport: `export default handle(app);`
+        platformExport: `export default handle(app);
+export const config = { path: "/*", preferStatic: true };`,
+        // Netlify CDN 缓存 — 使用 Netlify-CDN-Cache-Control 头做 ISR
+        platformCache: `
+const ISR_SWR_TTL = 3600;
+const ISR_CACHE_MAX = 1000;
+const _isrMap = new Map();
+async function platformCacheGet(url) {
+  return _isrMap.get(url) ?? null;
+}
+async function platformCacheSet(url, html) {
+  if (_isrMap.size >= ISR_CACHE_MAX) {
+    const first = _isrMap.keys().next().value;
+    _isrMap.delete(first);
+  }
+  _isrMap.set(url, html);
+}`,
+        platformPrerenderResponseHook: `c.header("Cache-Control", "public, max-age=0, must-revalidate");
+      c.header("Netlify-CDN-Cache-Control", "public, max-age=" + ISR_SWR_TTL + ", stale-while-revalidate=" + ISR_SWR_TTL + ", durable");`
       });
       const tempEntry = path.resolve(root, ".netlify-entry.tmp.mjs");
       fs.writeFileSync(tempEntry, entrySource);
@@ -222,6 +416,13 @@ function netlifyAdapter() {
         path.resolve(root, "dist/client/_redirects"),
         redirects
       );
+      const prerendered = await prerenderRoutes(ctx);
+      const clientDir = path.resolve(root, "dist/client");
+      for (const { url, html } of prerendered) {
+        const filePath = url === "/" ? path.join(clientDir, "index.html") : path.join(clientDir, url, "index.html");
+        fs.mkdirSync(path.resolve(filePath, ".."), { recursive: true });
+        fs.writeFileSync(filePath, html);
+      }
       console.log(
         "  Netlify output \u2192 .netlify/functions-internal/ssr/\n  Publish dir: dist/client/\n"
       );
@@ -236,7 +437,31 @@ function nodeAdapter() {
     async build(ctx) {
       const { fs, path, root } = ctx;
       const entrySource = generateSSREntry(ctx, {
-        platformImport: `import { serve } from "@hono/node-server";`,
+        platformImport: `import { serve } from "@hono/node-server";
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";`,
+        platformMiddleware: `
+// \u9884\u6E32\u67D3\u6587\u4EF6\u4E2D\u95F4\u4EF6\uFF1A\u68C0\u67E5 dist/prerender/ \u4E0B\u662F\u5426\u6709\u5BF9\u5E94\u7684\u9759\u6001 HTML
+const __entry_dirname = dirname(fileURLToPath(import.meta.url));
+const prerenderDir = resolve(__entry_dirname, "../prerender");
+
+app.use("*", async (c, next) => {
+  const urlPath = c.req.path;
+  const candidates = [
+    resolve(prerenderDir, "." + urlPath, "index.html"),
+    resolve(prerenderDir, "." + urlPath + ".html"),
+  ];
+  if (urlPath === "/") candidates.unshift(resolve(prerenderDir, "index.html"));
+  for (const f of candidates) {
+    if (existsSync(f)) {
+      const html = readFileSync(f, "utf-8");
+      return c.html(html);
+    }
+  }
+  await next();
+});
+`,
         platformExport: `
 const port = +(process.env.PORT || 3000);
 serve({ fetch: app.fetch, port }, (info) => {
@@ -255,6 +480,18 @@ serve({ fetch: app.fetch, port }, (info) => {
       } finally {
         fs.rmSync(tempEntry, { force: true });
       }
+      const prerendered = await prerenderRoutes(ctx);
+      if (prerendered.length > 0) {
+        const prerenderDir = path.resolve(root, "dist/prerender");
+        fs.mkdirSync(prerenderDir, { recursive: true });
+        for (const { url, html } of prerendered) {
+          const filePath = url === "/" ? path.join(prerenderDir, "index.html") : path.join(prerenderDir, url, "index.html");
+          fs.mkdirSync(path.resolve(filePath, ".."), {
+            recursive: true
+          });
+          fs.writeFileSync(filePath, html);
+        }
+      }
       console.log(
         "  Node output \u2192 dist/server/index.mjs\n  Run: node dist/server/index.mjs\n"
       );
@@ -283,7 +520,7 @@ function staticAdapter(opts = {}) {
         ssrPath
       );
       ctx.copyStaticAssets(outputDir, { excludeHtml: true });
-      const routePaths = await extractRoutes(ctx, opts);
+      const { paths: routePaths, defs: routeDefs } = await extractRoutesWithModes(ctx, opts);
       const allUrls = [];
       for (const routePath of routePaths) {
         for (const locale of ctx.locales) {
@@ -302,21 +539,37 @@ function staticAdapter(opts = {}) {
             ctx.locales,
             ctx.defaultLocale
           );
-          const {
-            html: appHtml,
-            head,
-            css,
-            serverData
-          } = await ssrModule.render(url, locale);
-          const serializedData = ssrModule.serializeServerData(serverData);
-          const finalHtml = injectSSRForStatic(
-            ctx.templateHtml,
-            locale,
-            head,
-            css,
-            appHtml,
-            serializedData
+          const routeDef = routeDefs.find(
+            (r) => r.path === stripLocalePrefix(url, ctx.locales)
+          );
+          const mode = resolveRenderMode(
+            stripLocalePrefix(url, ctx.locales),
+            routeDef?.renderMode,
+            ctx.renderModes
           );
+          let finalHtml;
+          if (mode === "csr") {
+            finalHtml = injectCSRShellForStatic(
+              ctx.templateHtml,
+              locale
+            );
+          } else {
+            const {
+              html: appHtml,
+              head,
+              css,
+              serverData
+            } = await ssrModule.render(url, locale);
+            const serializedData = ssrModule.serializeServerData(serverData);
+            finalHtml = injectSSRForStatic(
+              ctx.templateHtml,
+              locale,
+              head,
+              css,
+              appHtml,
+              serializedData
+            );
+          }
           const filePath = url === "/" ? path.join(outputDir, "index.html") : path.join(outputDir, url, "index.html");
           fs.mkdirSync(path.resolve(filePath, ".."), {
             recursive: true
@@ -331,9 +584,10 @@ function staticAdapter(opts = {}) {
     }
   };
 }
-async function extractRoutes(ctx, opts) {
+async function extractRoutesWithModes(ctx, opts) {
   const routesFile = opts.routesExport ?? "src/lib/bootstrap.ts";
   const paths = [];
+  const defs = [];
   try {
     const { pathToFileURL } = await import(
       /* @vite-ignore */
@@ -363,6 +617,7 @@ async function extractRoutes(ctx, opts) {
       for (const r of routes) {
         if (r.path && !r.path.includes(":")) {
           paths.push(r.path);
+          defs.push({ path: r.path, renderMode: r.renderMode });
         }
       }
     }
@@ -382,7 +637,7 @@ async function extractRoutes(ctx, opts) {
     }
   }
   if (paths.length === 0) paths.push("/");
-  return paths;
+  return { paths, defs };
 }
 function inferLocale(url, locales, defaultLocale) {
   const segments = url.split("/").filter(Boolean);
@@ -397,6 +652,29 @@ function injectSSRForStatic(template, locale, head, css, html, serializedData) {
     '<script id="serialized-server-data" type="application/json">' + serializedData + "</script>"
   );
 }
+function injectCSRShellForStatic(template, locale) {
+  return template.replace("<!--ssr-lang-->", locale).replace("<!--ssr-head-->", "").replace("<!--ssr-body-->", "").replace("<!--ssr-data-->", "");
+}
+function stripLocalePrefix(url, locales) {
+  const segments = url.split("/").filter(Boolean);
+  if (segments.length > 0 && locales.includes(segments[0])) {
+    const rest = segments.slice(1).join("/");
+    return rest ? `/${rest}` : "/";
+  }
+  return url;
+}
+function resolveRenderMode(routePath, routeRenderMode, renderModes) {
+  if (renderModes) {
+    if (renderModes[routePath]) return renderModes[routePath];
+    for (const [pattern, mode] of Object.entries(renderModes)) {
+      if (pattern.includes("*")) {
+        const re = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+        if (re.test(routePath)) return mode;
+      }
+    }
+  }
+  return routeRenderMode ?? "ssr";
+}
 
 // ../server/src/adapters/vercel.ts
 function vercelAdapter() {
@@ -445,7 +723,7 @@ function vercelAdapter() {
               version: 3,
               routes: [
                 { handle: "filesystem" },
-                { src: "/(.*)", dest: "/ssr" }
+                { src: "/(.*)", dest: "/ssr/$1" }
               ]
             },
             null,
@@ -455,6 +733,39 @@ function vercelAdapter() {
       } finally {
         fs.rmSync(tempEntry, { force: true });
       }
+      const prerendered = await prerenderRoutes(ctx);
+      const staticDir = path.resolve(root, ".vercel/output/static");
+      for (const { url, html } of prerendered) {
+        const filePath = url === "/" ? path.join(staticDir, "index.html") : path.join(staticDir, url, "index.html");
+        fs.mkdirSync(path.resolve(filePath, ".."), { recursive: true });
+        fs.writeFileSync(filePath, html);
+      }
+      if (prerendered.length > 0) {
+        const configPath = path.resolve(
+          root,
+          ".vercel/output/config.json"
+        );
+        const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        config.overrides = config.overrides ?? {};
+        for (const { url } of prerendered) {
+          const key = url === "/" ? "index.html" : `${url.replace(/^\//, "")}/index.html`;
+          config.overrides[key] = {
+            path: url === "/" ? "/" : url,
+            contentType: "text/html; charset=utf-8"
+          };
+        }
+        const isrRoutes = prerendered.map(({ url }) => ({
+          src: `^${url.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/?$`,
+          dest: url,
+          has: [{ type: "header", key: "x-vercel-isr" }]
+        }));
+        config.routes = [
+          ...isrRoutes,
+          { handle: "filesystem" },
+          { src: "/(.*)", dest: "/ssr/$1" }
+        ];
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      }
       console.log("  Vercel output \u2192 .vercel/output/\n");
     }
   };
@@ -720,6 +1031,18 @@ function resolveSetupFn(mod) {
   const first = Object.values(mod).find((v) => typeof v === "function");
   return first ?? null;
 }
+function matchRenderModeConfig(url, renderModes) {
+  if (!renderModes) return null;
+  const path = url.split("?")[0];
+  if (renderModes[path]) return renderModes[path];
+  for (const [pattern, mode] of Object.entries(renderModes)) {
+    if (pattern.includes("*")) {
+      const re = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+      if (re.test(path)) return mode;
+    }
+  }
+  return null;
+}
 function finesoftFrontViteConfig(options = {}) {
   const ssrEntry = options.ssr?.entry ?? "src/ssr.ts";
   let root = process.cwd();
@@ -752,7 +1075,7 @@ function finesoftFrontViteConfig(options = {}) {
           /* @vite-ignore */
           "hono"
         );
-        const { createSSRApp: createSSRApp2 } = await import("./app-MYBG3TGV.js");
+        const { createSSRApp: createSSRApp2 } = await import("./app-BPO26FAD.js");
         const { getRequestListener } = await import(
           /* @vite-ignore */
           "@hono/node-server"
@@ -799,9 +1122,9 @@ function finesoftFrontViteConfig(options = {}) {
           /* @vite-ignore */
           "hono"
         );
-        const { injectSSRContent: injectSSRContent2 } = await import(
+        const { injectSSRContent: injectSSRContent2, injectCSRShell: injectCSRShell2 } = await import(
           /* @vite-ignore */
-          "./src-7D236CLJ.js"
+          "./src-KUWACLPD.js"
         );
         const { parseAcceptLanguage: parseAcceptLanguage2 } = await import("./locale-YK3THSI6.js");
         const { getRequestListener } = await import(
@@ -809,6 +1132,7 @@ function finesoftFrontViteConfig(options = {}) {
           "@hono/node-server"
         );
         const app = new HonoClass();
+        const isrCache = /* @__PURE__ */ new Map();
         if (typeof options.setup === "function") {
           await options.setup(app);
         } else if (typeof options.setup === "string") {
@@ -847,12 +1171,25 @@ function finesoftFrontViteConfig(options = {}) {
               options.locales,
               options.defaultLocale
             );
+            const overrideMode = matchRenderModeConfig(
+              url,
+              options.renderModes
+            );
+            if (overrideMode === "csr") {
+              return c.html(injectCSRShell2(template, locale));
+            }
+            const cached = isrCache.get(url);
+            if (cached) return c.html(cached);
             const {
               html: appHtml,
               head,
               css,
-              serverData
+              serverData,
+              renderMode
             } = await ssrModule.render(url, locale);
+            if (renderMode === "csr") {
+              return c.html(injectCSRShell2(template, locale));
+            }
             const serializedData = ssrModule.serializeServerData(serverData);
             const finalHtml = injectSSRContent2({
               template,
@@ -862,6 +1199,9 @@ function finesoftFrontViteConfig(options = {}) {
               html: appHtml,
               serializedData
             });
+            if (renderMode === "prerender" || overrideMode === "prerender") {
+              isrCache.set(url, finalHtml);
+            }
             return c.html(finalHtml);
           } catch (e) {
             console.error("[SSR Preview Error]", e);
@@ -932,6 +1272,7 @@ function finesoftFrontViteConfig(options = {}) {
             locales,
             defaultLocale,
             templateHtml,
+            renderModes: options.renderModes,
             resolvedResolve,
             resolvedCss,
             vite,
@@ -990,6 +1331,7 @@ export {
   finesoftFrontViteConfig,
   generateUuid,
   getBaseUrl,
+  injectCSRShell,
   injectSSRContent,
   isCompoundAction,
   isExternalUrlAction,