@finesoft/front 0.1.20 → 0.1.22

package/dist/index.d.cts

@@ -118,6 +118,8 @@ interface AdapterContext {
     ssrEntry: string;
     /** setup 文件相对路径（如 "src/proxies.ts"），仅当 options.setup 为 string 时有值 */
     setupPath?: string;
+    /** 路由定义入口文件（用于预渲染时加载路由），如 "src/lib/bootstrap.ts" */
+    bootstrapEntry?: string;
     /** 支持的语言列表 */
     locales: string[];
     /** 默认语言 */
@@ -151,6 +153,25 @@ interface GenerateSSREntryOptions {
     platformImport: string;
     /** 平台特定的导出语句（如 `export default handle(app);`） */
     platformExport: string;
+    /**
+     * 平台特定的 ISR 缓存实现代码（可选）。
+     * 需提供 `async function platformCacheGet(url)` 返回 string|null，
+     * 和 `async function platformCacheSet(url, html)` 的函数定义。
+     * 不提供时使用内置的内存 Map 缓存。
+     */
+    platformCache?: string;
+    /**
+     * 平台特定的响应后处理代码（可选）。
+     * 在 prerender 路由返回前执行，可用于设置 CDN 缓存头等。
+     * 代码中可使用变量 `c`（Hono Context）。
+     */
+    platformPrerenderResponseHook?: string;
+    /**
+     * 平台特定的中间件代码（可选）。
+     * 插入在 catch-all GET 路由之前，可用于添加静态文件服务等。
+     * 代码中可使用变量 `app`（Hono 实例）。
+     */
+    platformMiddleware?: string;
 }
 interface BuildBundleOptions {
     /** 临时入口文件路径 */
@@ -440,6 +461,11 @@ interface FinesoftFrontViteOptions {
      * ```
      */
     renderModes?: Record<string, "ssr" | "csr" | "prerender">;
+    /**
+     * 路由定义入口文件（用于预渲染时加载路由），默认 "src/lib/bootstrap.ts"。
+     * 如果项目不使用声明式路由定义，可以不设置。
+     */
+    bootstrapEntry?: string;
 }
 declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
     name: string;

package/dist/index.d.ts

@@ -118,6 +118,8 @@ interface AdapterContext {
     ssrEntry: string;
     /** setup 文件相对路径（如 "src/proxies.ts"），仅当 options.setup 为 string 时有值 */
     setupPath?: string;
+    /** 路由定义入口文件（用于预渲染时加载路由），如 "src/lib/bootstrap.ts" */
+    bootstrapEntry?: string;
     /** 支持的语言列表 */
     locales: string[];
     /** 默认语言 */
@@ -151,6 +153,25 @@ interface GenerateSSREntryOptions {
     platformImport: string;
     /** 平台特定的导出语句（如 `export default handle(app);`） */
     platformExport: string;
+    /**
+     * 平台特定的 ISR 缓存实现代码（可选）。
+     * 需提供 `async function platformCacheGet(url)` 返回 string|null，
+     * 和 `async function platformCacheSet(url, html)` 的函数定义。
+     * 不提供时使用内置的内存 Map 缓存。
+     */
+    platformCache?: string;
+    /**
+     * 平台特定的响应后处理代码（可选）。
+     * 在 prerender 路由返回前执行，可用于设置 CDN 缓存头等。
+     * 代码中可使用变量 `c`（Hono Context）。
+     */
+    platformPrerenderResponseHook?: string;
+    /**
+     * 平台特定的中间件代码（可选）。
+     * 插入在 catch-all GET 路由之前，可用于添加静态文件服务等。
+     * 代码中可使用变量 `app`（Hono 实例）。
+     */
+    platformMiddleware?: string;
 }
 interface BuildBundleOptions {
     /** 临时入口文件路径 */
@@ -440,6 +461,11 @@ interface FinesoftFrontViteOptions {
      * ```
      */
     renderModes?: Record<string, "ssr" | "csr" | "prerender">;
+    /**
+     * 路由定义入口文件（用于预渲染时加载路由），默认 "src/lib/bootstrap.ts"。
+     * 如果项目不使用声明式路由定义，可以不设置。
+     */
+    bootstrapEntry?: string;
 }
 declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
     name: string;

package/dist/index.js

@@ -10,7 +10,7 @@ import {
 } from "./chunk-H3RNYNSD.js";
 import {
   createSSRApp
-} from "./chunk-SN3OO3DU.js";
+} from "./chunk-IITKGRCO.js";
 import {
   SSR_PLACEHOLDERS,
   createSSRRender,
@@ -77,6 +77,19 @@ function generateSSREntry(ctx, opts) {
   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}
@@ -87,6 +100,7 @@ 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;
@@ -129,10 +143,9 @@ function matchRenderMode(url) {
   return null;
 }
 
-const isrCache = new Map();
-
 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] : "");
@@ -146,7 +159,7 @@ app.get("*", async (c) => {
     }
 
     // ISR \u7F13\u5B58\u547D\u4E2D
-    const cached = isrCache.get(url);
+    const cached = await platformCacheGet(url);
     if (cached) return c.html(cached);
 
     const { html: appHtml, head, css, serverData, renderMode } = await render(url, locale);
@@ -161,7 +174,8 @@ app.get("*", async (c) => {
 
     // Prerender ISR \u7F13\u5B58\uFF08\u5305\u62EC Vite \u914D\u7F6E\u8986\u76D6\u548C\u8DEF\u7531\u7EA7\uFF09
     if (renderMode === "prerender" || overrideMode === "prerender") {
-      isrCache.set(url, finalHtml);
+      await platformCacheSet(url, finalHtml);
+      ${opts.platformPrerenderResponseHook ?? ""}
     }
 
     return c.html(finalHtml);
@@ -203,35 +217,40 @@ function copyStaticAssets(ctx, destDir, opts) {
     fs.rmSync(path.join(destDir, "index.html"), { force: true });
   }
 }
-async function prerenderRoutes(ctx, routesExport = "src/lib/bootstrap.ts") {
+async function prerenderRoutes(ctx) {
   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 routesExport = ctx.bootstrapEntry ?? "src/lib/bootstrap.ts";
+  let routes = [];
+  const routesFileExists = fs.existsSync(path.resolve(root, routesExport));
+  if (routesFileExists) {
+    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
+    );
+    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(":")) {
@@ -297,7 +316,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);
@@ -343,7 +384,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);
@@ -383,7 +442,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) => {
@@ -645,7 +728,7 @@ function vercelAdapter() {
               version: 3,
               routes: [
                 { handle: "filesystem" },
-                { src: "/(.*)", dest: "/ssr" }
+                { src: "/(.*)", dest: "/ssr/$1" }
               ]
             },
             null,
@@ -662,6 +745,32 @@ function vercelAdapter() {
         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");
     }
   };
@@ -971,7 +1080,7 @@ function finesoftFrontViteConfig(options = {}) {
           /* @vite-ignore */
           "hono"
         );
-        const { createSSRApp: createSSRApp2 } = await import("./app-Z3EFLAP2.js");
+        const { createSSRApp: createSSRApp2 } = await import("./app-BPO26FAD.js");
         const { getRequestListener } = await import(
           /* @vite-ignore */
           "@hono/node-server"
@@ -1165,6 +1274,7 @@ function finesoftFrontViteConfig(options = {}) {
             root,
             ssrEntry,
             setupPath: typeof options.setup === "string" ? options.setup : void 0,
+            bootstrapEntry: options.bootstrapEntry,
             locales,
             defaultLocale,
             templateHtml,