@finesoft/front 0.1.45 → 0.1.47

package/dist/index.mjs

@@ -1,5 +1,4 @@
-import { a as dynamicImport, c as injectSSRContent, i as createInternalFetch, n as createSSRApp, o as SSR_PLACEHOLDERS, s as injectCSRShell } from "./app-FO_8yAY7.mjs";
-import { n as parseAcceptLanguage } from "./locale-iP9ABD4H.mjs";
+import { n as parseAcceptLanguage } from "./locale-CvU-U6aP.mjs";
 import { Hono } from "hono";
 //#region ../core/src/actions/types.ts
 /**
@@ -1457,6 +1456,30 @@ function createSSRRender(config) {
 	});
 }
 //#endregion
+//#region ../ssr/src/inject.ts
+/**
+* injectSSRContent — 将 SSR 渲染结果注入 HTML 模板
+*/
+/** SSR HTML 模板占位符常量 */
+const SSR_PLACEHOLDERS = {
+	LANG: "<!--ssr-lang-->",
+	HEAD: "<!--ssr-head-->",
+	BODY: "<!--ssr-body-->",
+	DATA: "<!--ssr-data-->"
+};
+function injectSSRContent(options) {
+	const { template, locale, head, css, html, serializedData } = options;
+	const cssTag = css ? `<style>${css}</style>` : "";
+	return template.replace(SSR_PLACEHOLDERS.LANG, locale).replace(SSR_PLACEHOLDERS.HEAD, `${head}\n${cssTag}`).replace(SSR_PLACEHOLDERS.BODY, html).replace(SSR_PLACEHOLDERS.DATA, `<script id="serialized-server-data" type="application/json">${serializedData}<\/script>`);
+}
+/**
+* CSR 空壳注入 — 只替换 lang，清空 body/head/data 占位符
+* 用于 renderMode === "csr" 的路由
+*/
+function injectCSRShell(template, locale) {
+	return template.replace(SSR_PLACEHOLDERS.LANG, locale).replace(SSR_PLACEHOLDERS.HEAD, "").replace(SSR_PLACEHOLDERS.BODY, "").replace(SSR_PLACEHOLDERS.DATA, "");
+}
+//#endregion
 //#region ../ssr/src/server-data.ts
 const HTML_REPLACEMENTS = {
 	"<": "\\u003C",
@@ -1470,6 +1493,29 @@ function serializeServerData(data) {
 	return JSON.stringify(data).replace(HTML_ESCAPE_PATTERN, (match) => HTML_REPLACEMENTS[match] ?? match);
 }
 //#endregion
+//#region ../server/src/dynamic-import.ts
+/** Cache for stable (non-file://) modules — avoids redundant resolution. */
+const moduleCache = /* @__PURE__ */ new Map();
+const rawImport = new Function("u", "return import(u)");
+const debugEnabled = typeof process !== "undefined" && process.env?.FINESOFT_DEBUG === "1";
+function logDebug(msg) {
+	if (debugEnabled) console.debug(`[finesoft:dynamic-import] ${msg}`);
+}
+async function dynamicImport(specifier) {
+	const cacheable = !specifier.startsWith("file:") && !specifier.startsWith("/");
+	if (cacheable) {
+		const cached = moduleCache.get(specifier);
+		if (cached) {
+			logDebug(`cache hit  → ${specifier}`);
+			return cached;
+		}
+	}
+	logDebug(`importing  → ${specifier}`);
+	const mod = await rawImport(specifier);
+	if (cacheable) moduleCache.set(specifier, mod);
+	return mod;
+}
+//#endregion
 //#region ../server/src/proxy.ts
 /**
 * 校验代理路径，防止 SSRF（协议相对 URL 绕过）。
@@ -1584,6 +1630,30 @@ const BUILD_TOOL_EXTERNALS = [
 	"lightningcss"
 ];
 /**
+* Common Node.js built-in modules. Listed explicitly so that Rolldown's
+* vite-resolve plugin does not emit "Automatically externalized" warnings.
+*/
+const NODE_BUILTINS = [
+	"node:async_hooks",
+	"node:buffer",
+	"node:crypto",
+	"node:fs",
+	"node:http",
+	"node:http2",
+	"node:module",
+	"node:net",
+	"node:os",
+	"node:path",
+	"node:stream",
+	"node:url",
+	"node:util",
+	"node:zlib",
+	"crypto",
+	"http",
+	"http2",
+	"stream"
+];
+/**
 * 生成 SSR serverless/edge 入口源码
 *
 * 内联 parseAcceptLanguage / injectSSR 以避免
@@ -1738,13 +1808,13 @@ async function buildBundle(ctx, opts) {
 		build: {
 			ssr: opts.entry,
 			outDir: opts.outDir,
-			emptyOutDir: true,
+			emptyOutDir: opts.emptyOutDir ?? true,
 			target: opts.target ?? "node18",
 			rollupOptions: { output: { entryFileNames: opts.fileName ?? "index.mjs" } }
 		},
 		ssr: {
 			noExternal: opts.noExternal !== false,
-			external: opts.external ?? BUILD_TOOL_EXTERNALS
+			external: [...opts.external ?? BUILD_TOOL_EXTERNALS, ...NODE_BUILTINS]
 		},
 		resolve: ctx.resolvedResolve,
 		css: ctx.resolvedCss
@@ -1765,10 +1835,7 @@ function copyStaticAssets(ctx, destDir, opts) {
 */
 async function prerenderRoutes(ctx) {
 	const { fs, path, root, vite } = ctx;
-	const { pathToFileURL } = await import(
-		/* @vite-ignore */
-		"node:url"
-);
+	const { pathToFileURL } = await dynamicImport("node:url");
 	const routesExport = ctx.bootstrapEntry ?? "src/lib/bootstrap.ts";
 	let routes = [];
 	if (fs.existsSync(path.resolve(root, routesExport))) {
@@ -1998,7 +2065,8 @@ serve({ fetch: app.fetch, port }, (info) => {
 				await buildBundle(ctx, {
 					entry: ".node-entry.tmp.mjs",
 					outDir: path.resolve(root, "dist/server"),
-					target: "node18"
+					target: "node18",
+					emptyOutDir: false
 				});
 			} finally {
 				fs.rmSync(tempEntry, { force: true });
@@ -2038,10 +2106,7 @@ function staticAdapter(opts = {}) {
 				force: true
 			});
 			fs.mkdirSync(outputDir, { recursive: true });
-			const { pathToFileURL } = await import(
-				/* @vite-ignore */
-				"node:url"
-);
+			const { pathToFileURL } = await dynamicImport("node:url");
 			const ssrPath = pathToFileURL(path.resolve(root, "dist/server/ssr.js")).href;
 			const ssrModule = await dynamicImport(ssrPath);
 			ctx.copyStaticAssets(outputDir, { excludeHtml: true });
@@ -2079,10 +2144,7 @@ async function extractRoutesWithModes(ctx, opts) {
 	const paths = [];
 	const defs = [];
 	try {
-		const { pathToFileURL } = await import(
-			/* @vite-ignore */
-			"node:url"
-);
+		const { pathToFileURL } = await dynamicImport("node:url");
 		await ctx.vite.build({
 			root: ctx.root,
 			build: {
@@ -2288,7 +2350,138 @@ function detectPlatform() {
 	return "node";
 }
 //#endregion
+//#region ../server/src/internal-fetch.ts
+/**
+* createInternalFetch — SSR 内部路由回环 fetch 包装器
+*
+* 将相对路径（/api/…）请求转为 Hono app.fetch 内存调用，
+* 绝对 URL 和非字符串 input 走 globalThis.fetch（真实网络）。
+*
+* 递归深度保护采用请求头传递：每次 SSR 回环在请求头中写入深度值，
+* SSR catch-all 读取深度判断是否超限。对比闭包计数器方案：
+* - 并发安全：无共享可变状态
+* - 跨渲染准确：深度随请求在 Hono 路由链中传递
+*/
+const SSR_DEPTH_HEADER = "x-ssr-depth";
+/**
+* 创建请求级 internal fetch
+*
+* @param appFetch - Hono app.fetch（父级路由）
+* @param depth - 当前 SSR 深度（由 catch-all handler 从请求头读取后 +1 传入）
+*/
+function createInternalFetch(appFetch, depth = 1) {
+	return ((input, init) => {
+		if (typeof input === "string" && input.startsWith("/")) {
+			const request = new Request(`http://localhost${input}`, init);
+			request.headers.set(SSR_DEPTH_HEADER, String(depth));
+			return Promise.resolve(appFetch(request));
+		}
+		return globalThis.fetch(input, init);
+	});
+}
+//#endregion
+//#region ../server/src/app.ts
+/**
+* createSSRApp — 创建 Hono SSR 应用
+*
+* 提供 SSR 通配路由，读取模板、加载 SSR 模块、渲染。
+* 应用层可在此之上追加自定义路由（API 代理等）。
+*/
+/**
+* 匹配 Vite 配置级别的 renderMode 覆盖。
+* 精确路径优先，然后 glob 模式。
+*/
+function matchRenderModeOverride(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 escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+		if (new RegExp("^" + escaped.replace(/\*/g, ".*") + "$").test(path)) return mode;
+	}
+	return null;
+}
+function createSSRApp(options) {
+	const { root, vite, isProduction, ssrEntryPath = "/src/ssr.ts", ssrProductionModule, supportedLocales, defaultLocale, parentFetch, renderModes } = options;
+	const app = new Hono();
+	/** ISR 内存缓存（prerender 路由首次请求后缓存，LRU 驱逐） */
+	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);
+	}
+	/** 生产环境模板缓存（模板不变，避免每请求重复读盘） */
+	let templateCache;
+	async function readTemplate(url) {
+		if (!isProduction && vite) {
+			const { readFileSync } = await dynamicImport("node:fs");
+			const raw = readFileSync((await dynamicImport("node:path")).resolve(root, "index.html"), "utf-8");
+			return vite.transformIndexHtml(url, raw);
+		}
+		if (templateCache) return templateCache;
+		if (typeof globalThis.Deno !== "undefined") {
+			const base = import.meta.url;
+			templateCache = globalThis.Deno.readTextFileSync(new URL("../dist/client/index.html", base));
+			return templateCache;
+		}
+		const { readFileSync } = await dynamicImport("node:fs");
+		templateCache = readFileSync((await dynamicImport("node:path")).resolve(root, "dist/client/index.html"), "utf-8");
+		return templateCache;
+	}
+	async function loadSSRModule() {
+		if (!isProduction && vite) return await vite.ssrLoadModule(ssrEntryPath);
+		if (ssrProductionModule) return dynamicImport(ssrProductionModule);
+		const path = await dynamicImport("node:path");
+		const { pathToFileURL } = await dynamicImport("node:url");
+		const absPath = pathToFileURL(path.resolve(root, "dist/server/ssr.js")).href;
+		return dynamicImport(absPath);
+	}
+	app.get("*", async (c) => {
+		const ssrDepth = parseInt(c.req.header("x-ssr-depth") ?? "0", 10);
+		if (ssrDepth >= 5) return c.text("SSR recursion loop detected", 508);
+		const url = c.req.path + (c.req.url.includes("?") ? "?" + c.req.url.split("?")[1] : "");
+		try {
+			const template = await readTemplate(url);
+			const { render, serializeServerData } = await loadSSRModule();
+			const locale = parseAcceptLanguage(c.req.header("accept-language"), supportedLocales, defaultLocale);
+			const overrideMode = matchRenderModeOverride(url, renderModes);
+			if (overrideMode === "csr") return c.html(injectCSRShell(template, locale));
+			const cacheKey = `${locale}:${url}`;
+			const cached = isrCache.get(cacheKey);
+			if (cached) return c.html(cached);
+			const requestFetch = parentFetch ? createInternalFetch(parentFetch, ssrDepth + 1) : void 0;
+			const ssrContext = { request: c.req.raw };
+			if (requestFetch) ssrContext.fetch = requestFetch;
+			const { html: appHtml, head, css, serverData, renderMode, redirect: middlewareRedirect } = await render(url, locale, ssrContext);
+			if (middlewareRedirect) return c.redirect(middlewareRedirect.url, middlewareRedirect.status);
+			if (renderMode === "csr") return c.html(injectCSRShell(template, locale));
+			const finalHtml = injectSSRContent({
+				template,
+				locale,
+				head,
+				css,
+				html: appHtml,
+				serializedData: serializeServerData(serverData)
+			});
+			if (renderMode === "prerender" || overrideMode === "prerender") isrSet(cacheKey, finalHtml);
+			return c.html(finalHtml);
+		} catch (e) {
+			if (!isProduction && vite) vite.ssrFixStacktrace(e);
+			console.error("[SSR Error]", e);
+			return c.text("Internal Server Error", 500);
+		}
+	});
+	return app;
+}
+//#endregion
 //#region ../server/src/runtime.ts
+/**
+* runtime — 运行时检测 + 项目根路径推导
+*/
 /** 检测当前运行时环境 */
 function detectRuntime() {
 	return {
@@ -2310,14 +2503,8 @@ async function resolveRoot(importMetaUrl, levelsUp = 0) {
 		for (let i = 0; i < levelsUp; i++) url = new URL("..", url);
 		return url.pathname;
 	}
-	const path = await import(
-		/* @vite-ignore */
-		"node:path"
-);
-	const { fileURLToPath } = await import(
-		/* @vite-ignore */
-		"node:url"
-);
+	const path = await dynamicImport("node:path");
+	const { fileURLToPath } = await dynamicImport("node:url");
 	let dir = path.normalize(path.dirname(fileURLToPath(importMetaUrl)));
 	for (let i = 0; i < levelsUp; i++) dir = path.resolve(dir, "..");
 	return dir;
@@ -2348,24 +2535,15 @@ async function startServer(options) {
 	if (!isProduction) {
 		let devVite = vite;
 		if (!devVite) {
-			const { createServer: createViteServer } = await import(
-				/* @vite-ignore */
-				"vite"
-);
+			const { createServer: createViteServer } = await dynamicImport("vite");
 			devVite = await createViteServer({
 				root,
 				server: { middlewareMode: true },
 				appType: "custom"
 			});
 		}
-		const { getRequestListener } = await import(
-			/* @vite-ignore */
-			"@hono/node-server"
-);
-		const { createServer } = await import(
-			/* @vite-ignore */
-			"node:http"
-);
+		const { getRequestListener } = await dynamicImport("@hono/node-server");
+		const { createServer } = await dynamicImport("node:http");
 		const listener = getRequestListener(app.fetch);
 		createServer((req, res) => {
 			devVite.middlewares(req, res, () => listener(req, res));
@@ -2376,14 +2554,8 @@ async function startServer(options) {
 	}
 	if (isDeno) globalThis.Deno.serve({ port }, app.fetch);
 	else if (isBun) {} else {
-		const { serveStatic } = await import(
-			/* @vite-ignore */
-			"@hono/node-server/serve-static"
-);
-		const path = await import(
-			/* @vite-ignore */
-			"node:path"
-);
+		const { serveStatic } = await dynamicImport("@hono/node-server/serve-static");
+		const path = await dynamicImport("node:path");
 		const prodApp = new Hono();
 		const clientDir = path.resolve(root, "dist/client");
 		prodApp.use("/*", serveStatic({
@@ -2391,10 +2563,7 @@ async function startServer(options) {
 			rewriteRequestPath: (path) => path.endsWith("/") ? "/__nosuchfile__" : path
 		}));
 		prodApp.route("/", app);
-		const { serve } = await import(
-			/* @vite-ignore */
-			"@hono/node-server"
-);
+		const { serve } = await dynamicImport("@hono/node-server");
 		serve({
 			fetch: prodApp.fetch,
 			port
@@ -2427,28 +2596,16 @@ async function startServer(options) {
 async function createServer(config = {}) {
 	const { root: rootOverride, locales, defaultLocale, port = Number(process.env.PORT) || 3e3, setup, proxies, ssr } = config;
 	const root = rootOverride ?? process.cwd();
-	const { existsSync } = await import(
-		/* @vite-ignore */
-		"node:fs"
-);
-	const envPath = (await import(
-		/* @vite-ignore */
-		"node:path"
-)).resolve(root, ".env");
+	const { existsSync } = await dynamicImport("node:fs");
+	const envPath = (await dynamicImport("node:path")).resolve(root, ".env");
 	if (existsSync(envPath)) try {
-		const { config: dotenvConfig } = await import(
-			/* @vite-ignore */
-			"dotenv"
-);
+		const { config: dotenvConfig } = await dynamicImport("dotenv");
 		dotenvConfig({ path: envPath });
 	} catch {}
 	const runtime = detectRuntime();
 	let vite;
 	if (!runtime.isProduction && !runtime.isVercel) {
-		const { createServer: createViteServer } = await import(
-			/* @vite-ignore */
-			"vite"
-);
+		const { createServer: createViteServer } = await dynamicImport("vite");
 		vite = await createViteServer({
 			root,
 			server: { middlewareMode: true },
@@ -2526,9 +2683,9 @@ function finesoftFrontViteConfig(options = {}) {
 	const CSS_EXTENSIONS = /\.(css|scss|less|sass|styl|stylus|pcss|postcss)($|\?)/;
 	return {
 		name: "finesoft-front",
-		config(userConfig, env) {
+		config(userConfig) {
 			const overrides = { appType: "custom" };
-			if (env.command === "build" && !process.env.__FINESOFT_SUB_BUILD__) overrides.build = { outDir: userConfig.build?.outDir ?? "dist/client" };
+			if (!process.env.__FINESOFT_SUB_BUILD__) overrides.build = { outDir: userConfig.build?.outDir ?? "dist/client" };
 			return overrides;
 		},
 		configResolved(config) {
@@ -2578,15 +2735,8 @@ function finesoftFrontViteConfig(options = {}) {
 		},
 		configureServer(server) {
 			return async () => {
-				const { Hono: HonoClass } = await import(
-					/* @vite-ignore */
-					"hono"
-);
-				const { createSSRApp } = await import("./app-FO_8yAY7.mjs").then((n) => n.t);
-				const { getRequestListener } = await import(
-					/* @vite-ignore */
-					"@hono/node-server"
-);
+				const { Hono: HonoClass } = await dynamicImport("hono");
+				const { getRequestListener } = await dynamicImport("@hono/node-server");
 				const app = new HonoClass();
 				if (options.proxies?.length) registerProxyRoutes(app, options.proxies);
 				if (typeof options.setup === "function") await options.setup(app);
@@ -2613,27 +2763,12 @@ function finesoftFrontViteConfig(options = {}) {
 		},
 		configurePreviewServer(server) {
 			return async () => {
-				const { readFileSync } = await import(
-					/* @vite-ignore */
-					"node:fs"
-);
-				const path = await import(
-					/* @vite-ignore */
-					"node:path"
-);
-				const { pathToFileURL } = await import(
-					/* @vite-ignore */
-					"node:url"
-);
-				const { Hono: HonoClass } = await import(
-					/* @vite-ignore */
-					"hono"
-);
-				const { parseAcceptLanguage } = await import("./locale-iP9ABD4H.mjs").then((n) => n.t);
-				const { getRequestListener } = await import(
-					/* @vite-ignore */
-					"@hono/node-server"
-);
+				const { readFileSync } = await dynamicImport("node:fs");
+				const path = await dynamicImport("node:path");
+				const { pathToFileURL } = await dynamicImport("node:url");
+				const { Hono: HonoClass } = await dynamicImport("hono");
+				const { parseAcceptLanguage } = await import("./locale-CvU-U6aP.mjs").then((n) => n.t);
+				const { getRequestListener } = await dynamicImport("@hono/node-server");
 				const app = new HonoClass();
 				const isrCache = /* @__PURE__ */ new Map();
 				if (options.proxies?.length) registerProxyRoutes(app, options.proxies);
@@ -2687,18 +2822,9 @@ function finesoftFrontViteConfig(options = {}) {
 			if (resolvedCommand !== "build") return;
 			process.env.__FINESOFT_SUB_BUILD__ = "1";
 			try {
-				const vite = await import(
-					/* @vite-ignore */
-					"vite"
-);
-				const fs = await import(
-					/* @vite-ignore */
-					"node:fs"
-);
-				const path = await import(
-					/* @vite-ignore */
-					"node:path"
-);
+				const vite = await dynamicImport("vite");
+				const fs = await dynamicImport("node:fs");
+				const path = await dynamicImport("node:path");
 				console.log("\n  Building SSR bundle...\n");
 				await vite.build({
 					root,
@@ -2706,6 +2832,7 @@ function finesoftFrontViteConfig(options = {}) {
 						ssr: ssrEntry,
 						outDir: "dist/server"
 					},
+					ssr: { external: NODE_BUILTINS },
 					resolve: resolvedResolve,
 					css: resolvedCss
 				});