@finesoft/front 0.1.20 → 0.1.21

package/dist/{app-Z3EFLAP2.js → app-BPO26FAD.js}

@@ -1,10 +1,10 @@
 import {
   createSSRApp
-} from "./chunk-SN3OO3DU.js";
+} from "./chunk-IITKGRCO.js";
 import "./chunk-5ZECBECP.js";
 import "./chunk-BUYWNNNQ.js";
 import "./chunk-FYP2ZYYV.js";
 export {
   createSSRApp
 };
-//# sourceMappingURL=app-Z3EFLAP2.js.map
+//# sourceMappingURL=app-BPO26FAD.js.map

package/dist/{chunk-SN3OO3DU.js → chunk-IITKGRCO.js}

@@ -19,7 +19,15 @@ function createSSRApp(options) {
     defaultLocale
   } = options;
   const app = new Hono();
+  const ISR_CACHE_MAX = 1e3;
   const isrCache = /* @__PURE__ */ new Map();
+  function isrSet(key, val) {
+    if (isrCache.size >= ISR_CACHE_MAX) {
+      const first = isrCache.keys().next().value;
+      if (first !== void 0) isrCache.delete(first);
+    }
+    isrCache.set(key, val);
+  }
   async function readTemplate(url) {
     if (!isProduction && vite) {
       const { readFileSync: readFileSync2 } = await import(
@@ -100,7 +108,7 @@ function createSSRApp(options) {
         serializedData
       });
       if (renderMode === "prerender") {
-        isrCache.set(cacheKey, finalHtml);
+        isrSet(cacheKey, finalHtml);
       }
       return c.html(finalHtml);
     } catch (e) {
@@ -117,4 +125,4 @@ function createSSRApp(options) {
 export {
   createSSRApp
 };
-//# sourceMappingURL=chunk-SN3OO3DU.js.map
+//# sourceMappingURL=chunk-IITKGRCO.js.map

package/dist/chunk-IITKGRCO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../server/src/app.ts"],"sourcesContent":["/**\n * createSSRApp — 创建 Hono SSR 应用\n *\n * 提供 SSR 通配路由，读取模板、加载 SSR 模块、渲染。\n * 应用层可在此之上追加自定义路由（API 代理等）。\n */\n\nimport { injectCSRShell, injectSSRContent } from \"@finesoft/ssr\";\nimport { Hono } from \"hono\";\nimport type { ViteDevServer } from \"vite\";\nimport { parseAcceptLanguage } from \"./locale\";\n\nexport interface SSRModule {\n\trender: (\n\t\turl: string,\n\t\tlocale: string,\n\t) => Promise<{\n\t\thtml: string;\n\t\thead: string;\n\t\tcss: string;\n\t\tserverData: unknown;\n\t\trenderMode?: string;\n\t}>;\n\tserializeServerData: (data: unknown) => string;\n}\n\nexport interface SSRAppOptions {\n\t/** 项目根路径 */\n\troot: string;\n\t/** Vite dev server（仅开发模式） */\n\tvite?: ViteDevServer;\n\t/** 是否生产环境 */\n\tisProduction: boolean;\n\t/** SSR 入口文件路径（开发用，如 \"/src/ssr.ts\"） */\n\tssrEntryPath?: string;\n\t/** 生产环境 SSR 模块路径（如 \"../dist/server/ssr.js\"） */\n\tssrProductionModule?: string;\n\t/** 支持的语言列表 */\n\tsupportedLocales?: string[];\n\t/** 默认语言 */\n\tdefaultLocale?: string;\n}\n\nexport function createSSRApp(options: SSRAppOptions): Hono {\n\tconst {\n\t\troot,\n\t\tvite,\n\t\tisProduction,\n\t\tssrEntryPath = \"/src/ssr.ts\",\n\t\tssrProductionModule,\n\t\tsupportedLocales,\n\t\tdefaultLocale,\n\t} = options;\n\n\tconst app = new Hono();\n\n\t/** ISR 内存缓存（prerender 路由首次请求后缓存，LRU 驱逐） */\n\tconst ISR_CACHE_MAX = 1000;\n\tconst isrCache = new Map<string, string>();\n\tfunction isrSet(key: string, val: string) {\n\t\tif (isrCache.size >= ISR_CACHE_MAX) {\n\t\t\tconst first = isrCache.keys().next().value;\n\t\t\tif (first !== undefined) isrCache.delete(first);\n\t\t}\n\t\tisrCache.set(key, val);\n\t}\n\n\tasync function readTemplate(url: string): Promise<string> {\n\t\tif (!isProduction && vite) {\n\t\t\tconst { readFileSync } = await import(/* @vite-ignore */ \"node:fs\");\n\t\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\t\tconst raw = readFileSync(resolve(root, \"index.html\"), \"utf-8\");\n\t\t\treturn vite.transformIndexHtml(url, raw);\n\t\t}\n\n\t\tconst isDeno = typeof (globalThis as any).Deno !== \"undefined\";\n\t\tif (isDeno) {\n\t\t\treturn (globalThis as any).Deno.readTextFileSync(\n\t\t\t\tnew URL(\"../dist/client/index.html\", import.meta.url),\n\t\t\t);\n\t\t}\n\n\t\tconst { readFileSync } = await import(/* @vite-ignore */ \"node:fs\");\n\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\treturn readFileSync(resolve(root, \"dist/client/index.html\"), \"utf-8\");\n\t}\n\n\tasync function loadSSRModule(): Promise<SSRModule> {\n\t\tif (!isProduction && vite) {\n\t\t\treturn (await vite.ssrLoadModule(ssrEntryPath)) as SSRModule;\n\t\t}\n\t\tif (ssrProductionModule) {\n\t\t\treturn import(ssrProductionModule) as Promise<SSRModule>;\n\t\t}\n\t\tconst { resolve } = await import(/* @vite-ignore */ \"node:path\");\n\t\tconst { pathToFileURL } = await import(/* @vite-ignore */ \"node:url\");\n\t\tconst absPath = pathToFileURL(resolve(root, \"dist/server/ssr.js\")).href;\n\t\treturn import(absPath) as Promise<SSRModule>;\n\t}\n\n\tapp.get(\"*\", async (c) => {\n\t\tconst url =\n\t\t\tc.req.path +\n\t\t\t(c.req.url.includes(\"?\") ? \"?\" + c.req.url.split(\"?\")[1] : \"\");\n\n\t\ttry {\n\t\t\t// ISR 缓存命中\n\t\t\tconst cacheKey = url;\n\t\t\tconst cached = isrCache.get(cacheKey);\n\t\t\tif (cached) return c.html(cached);\n\n\t\t\tconst template = await readTemplate(url);\n\t\t\tconst { render, serializeServerData } = await loadSSRModule();\n\n\t\t\tconst locale = parseAcceptLanguage(\n\t\t\t\tc.req.header(\"accept-language\"),\n\t\t\t\tsupportedLocales,\n\t\t\t\tdefaultLocale,\n\t\t\t);\n\n\t\t\tconst {\n\t\t\t\thtml: appHtml,\n\t\t\t\thead,\n\t\t\t\tcss,\n\t\t\t\tserverData,\n\t\t\t\trenderMode,\n\t\t\t} = await render(url, locale);\n\n\t\t\t// CSR 模式：返回空壳 HTML\n\t\t\tif (renderMode === \"csr\") {\n\t\t\t\treturn c.html(injectCSRShell(template, locale));\n\t\t\t}\n\n\t\t\tconst serializedData = serializeServerData(serverData);\n\n\t\t\tconst finalHtml = injectSSRContent({\n\t\t\t\ttemplate,\n\t\t\t\tlocale,\n\t\t\t\thead,\n\t\t\t\tcss,\n\t\t\t\thtml: appHtml,\n\t\t\t\tserializedData,\n\t\t\t});\n\n\t\t\t// Prerender ISR 缓存\n\t\t\tif (renderMode === \"prerender\") {\n\t\t\t\tisrSet(cacheKey, finalHtml);\n\t\t\t}\n\n\t\t\treturn c.html(finalHtml);\n\t\t} catch (e) {\n\t\t\tif (!isProduction && vite) {\n\t\t\t\tvite.ssrFixStacktrace(e as Error);\n\t\t\t}\n\t\t\tconsole.error(\"[SSR Error]\", e);\n\t\t\treturn c.text(\"Internal Server Error\", 500);\n\t\t}\n\t});\n\n\treturn app;\n}\n"],"mappings":"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","names":["readFileSync","resolve"]}

package/dist/index.cjs

@@ -1149,7 +1149,15 @@ function createSSRApp(options) {
     defaultLocale
   } = options;
   const app = new import_hono.Hono();
+  const ISR_CACHE_MAX = 1e3;
   const isrCache = /* @__PURE__ */ new Map();
+  function isrSet(key, val) {
+    if (isrCache.size >= ISR_CACHE_MAX) {
+      const first = isrCache.keys().next().value;
+      if (first !== void 0) isrCache.delete(first);
+    }
+    isrCache.set(key, val);
+  }
   async function readTemplate(url) {
     if (!isProduction && vite) {
       const { readFileSync: readFileSync2 } = await import(
@@ -1230,7 +1238,7 @@ function createSSRApp(options) {
         serializedData
       });
       if (renderMode === "prerender") {
-        isrCache.set(cacheKey, finalHtml);
+        isrSet(cacheKey, finalHtml);
       }
       return c.html(finalHtml);
     } catch (e) {
@@ -1675,6 +1683,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}
@@ -1685,6 +1706,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;
@@ -1727,10 +1749,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] : "");
@@ -1744,7 +1765,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);
@@ -1759,7 +1780,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);
@@ -1895,7 +1917,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);
@@ -1941,7 +1985,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);
@@ -1981,7 +2043,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) => {
@@ -2243,7 +2329,7 @@ function vercelAdapter() {
               version: 3,
               routes: [
                 { handle: "filesystem" },
-                { src: "/(.*)", dest: "/ssr" }
+                { src: "/(.*)", dest: "/ssr/$1" }
               ]
             },
             null,
@@ -2260,6 +2346,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");
     }
   };