@finesoft/front 0.1.20 → 0.1.21

package/dist/index.d.cts

@@ -151,6 +151,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 {
     /** 临时入口文件路径 */

package/dist/index.d.ts

@@ -151,6 +151,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 {
     /** 临时入口文件路径 */

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);
@@ -297,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);
@@ -343,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);
@@ -383,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) => {
@@ -645,7 +723,7 @@ function vercelAdapter() {
               version: 3,
               routes: [
                 { handle: "filesystem" },
-                { src: "/(.*)", dest: "/ssr" }
+                { src: "/(.*)", dest: "/ssr/$1" }
               ]
             },
             null,
@@ -662,6 +740,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 +1075,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"