isr-engine 3.1.1 → 3.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/cli.js +1 -1
- package/dist/config/loadConfig.d.ts.map +1 -1
- package/dist/{createCacheInspectorMiddleware-BpMpmP_a.js → createCacheInspectorMiddleware-GgzKVkq2.js} +2 -2
- package/dist/{createCacheInspectorMiddleware-BpMpmP_a.js.map → createCacheInspectorMiddleware-GgzKVkq2.js.map} +1 -1
- package/dist/{createISRApp-D88Xp0Fb.js → createISRApp-DPD3Er4F.js} +25 -33
- package/dist/createISRApp-DPD3Er4F.js.map +1 -0
- package/dist/{createImagePlugin-Cdz3QfrJ.js → createImagePlugin-QNvY9vPB.js} +2 -2
- package/dist/{createImagePlugin-Cdz3QfrJ.js.map → createImagePlugin-QNvY9vPB.js.map} +1 -1
- package/dist/defaults/runtime/seo-runtime.d.ts +2 -0
- package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -1
- package/dist/isr-engine.js +3 -3
- package/dist/isr-engine.js.map +1 -1
- package/dist/runtime/routes.d.ts +18 -2
- package/dist/runtime/routes.d.ts.map +1 -1
- package/package.json +20 -28
- package/src/defaults/runtime/defineClientEntry.tsx +26 -15
- package/src/defaults/runtime/defineServerEntry.tsx +47 -44
- package/src/defaults/runtime/request.tsx +2 -2
- package/src/defaults/runtime/seo-runtime.ts +26 -30
- package/src/runtime/routes.tsx +102 -94
- package/dist/Logger-DqBS_3v8.cjs +0 -184
- package/dist/Logger-DqBS_3v8.cjs.map +0 -1
- package/dist/abVariantContext-BvAMuhjj.cjs +0 -510
- package/dist/abVariantContext-BvAMuhjj.cjs.map +0 -1
- package/dist/adapters/observability/index.cjs +0 -152
- package/dist/adapters/observability/index.cjs.map +0 -1
- package/dist/adapters/runtime/index.cjs +0 -100
- package/dist/adapters/runtime/index.cjs.map +0 -1
- package/dist/cli/cli.cjs +0 -372
- package/dist/cli/cli.cjs.map +0 -1
- package/dist/config/defineConfig.cjs +0 -26
- package/dist/config/defineConfig.cjs.map +0 -1
- package/dist/createCacheInspectorMiddleware-DvRhF_-D.cjs +0 -112
- package/dist/createCacheInspectorMiddleware-DvRhF_-D.cjs.map +0 -1
- package/dist/createISRApp-D88Xp0Fb.js.map +0 -1
- package/dist/createISRApp-tRkpdmpp.cjs +0 -8232
- package/dist/createISRApp-tRkpdmpp.cjs.map +0 -1
- package/dist/createImagePlugin-DomuzpoI.cjs +0 -487
- package/dist/createImagePlugin-DomuzpoI.cjs.map +0 -1
- package/dist/defaults/auto-observability.cjs +0 -147
- package/dist/defaults/auto-observability.cjs.map +0 -1
- package/dist/defaults/runtime/defineSiteHooks.cjs +0 -11
- package/dist/defineSiteHooks-BuhvW5YB.cjs +0 -770
- package/dist/defineSiteHooks-BuhvW5YB.cjs.map +0 -1
- package/dist/error500-template-BvZmvKoa.cjs +0 -63
- package/dist/error500-template-BvZmvKoa.cjs.map +0 -1
- package/dist/i18n-CS5QhOO0.cjs +0 -221
- package/dist/i18n-CS5QhOO0.cjs.map +0 -1
- package/dist/image/index.cjs +0 -93
- package/dist/image/index.cjs.map +0 -1
- package/dist/isr-engine.cjs +0 -3332
- package/dist/isr-engine.cjs.map +0 -1
- package/dist/rolldown-runtime-DakpK96I.cjs +0 -43
- package/dist/rsc/browser.cjs +0 -109
- package/dist/rsc/browser.cjs.map +0 -1
- package/dist/rsc/index.cjs +0 -32
- package/dist/rsc-CYT6B6bf.cjs +0 -237
- package/dist/rsc-CYT6B6bf.cjs.map +0 -1
package/dist/cli/cli.cjs
DELETED
|
@@ -1,372 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
const require_rolldown_runtime = require("../rolldown-runtime-DakpK96I.cjs");
|
|
3
|
-
const require_createISRApp = require("../createISRApp-tRkpdmpp.cjs");
|
|
4
|
-
let node_path = require("node:path");
|
|
5
|
-
let node_fs_promises = require("node:fs/promises");
|
|
6
|
-
let node_http = require("node:http");
|
|
7
|
-
node_http = require_rolldown_runtime.__toESM(node_http, 1);
|
|
8
|
-
let commander = require("commander");
|
|
9
|
-
let node_child_process = require("node:child_process");
|
|
10
|
-
//#region src/cli/dev.ts
|
|
11
|
-
/**
|
|
12
|
-
* 开发服务器命令
|
|
13
|
-
*/
|
|
14
|
-
function openBrowser(url) {
|
|
15
|
-
const child = (0, node_child_process.spawn)(process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open", process.platform === "win32" ? [
|
|
16
|
-
"/c",
|
|
17
|
-
"start",
|
|
18
|
-
"",
|
|
19
|
-
url
|
|
20
|
-
] : [url], {
|
|
21
|
-
stdio: "ignore",
|
|
22
|
-
detached: true
|
|
23
|
-
});
|
|
24
|
-
child.on("error", (error) => {
|
|
25
|
-
require_createISRApp.logger.warn("[CLI]", `自动打开浏览器失败:${error.message}`);
|
|
26
|
-
});
|
|
27
|
-
child.unref();
|
|
28
|
-
}
|
|
29
|
-
function getSamplePath(config, mode) {
|
|
30
|
-
const routes = config.routes ?? {};
|
|
31
|
-
for (const [route, value] of Object.entries(routes)) if ((typeof value === "string" ? value : value?.mode) === mode && !route.includes("*")) return route;
|
|
32
|
-
if (mode === "ssg") {
|
|
33
|
-
const ssgRoutes = config.ssg?.routes;
|
|
34
|
-
return Array.isArray(ssgRoutes) ? ssgRoutes[0] ?? "/about" : "/about";
|
|
35
|
-
}
|
|
36
|
-
if (mode === "ssr") return "/login";
|
|
37
|
-
return "/";
|
|
38
|
-
}
|
|
39
|
-
function printRenderModeLinks(baseUrl, config) {
|
|
40
|
-
const trimBase = baseUrl.replace(/\/$/, "");
|
|
41
|
-
const isrPath = getSamplePath(config, "isr");
|
|
42
|
-
const ssrPath = getSamplePath(config, "ssr");
|
|
43
|
-
const ssgPath = getSamplePath(config, "ssg");
|
|
44
|
-
require_createISRApp.logger.info("[Dev Links]", `ISR: ${trimBase}${isrPath}?mode=isr`);
|
|
45
|
-
require_createISRApp.logger.info("[Dev Links]", `SSR: ${trimBase}${ssrPath}?mode=ssr`);
|
|
46
|
-
require_createISRApp.logger.info("[Dev Links]", `SSG: ${trimBase}${ssgPath}?mode=ssg`);
|
|
47
|
-
require_createISRApp.logger.info("[Dev Links]", `CSR fallback: ${trimBase}${isrPath}?__csr-shell=1`);
|
|
48
|
-
require_createISRApp.logger.info("[Dev Links]", `No-JS/SSR HTML: ${trimBase}${isrPath}?__nojs=1`);
|
|
49
|
-
require_createISRApp.logger.info("[Dev Links]", `响应头查看: x-resolved-mode / x-render-strategy / x-fallback-used`);
|
|
50
|
-
}
|
|
51
|
-
async function startDevServer(options) {
|
|
52
|
-
const { port, host, open = false } = options;
|
|
53
|
-
require_createISRApp.logger.info("[CLI]", "启动开发服务器");
|
|
54
|
-
require_createISRApp.logger.spin("初始化开发环境...");
|
|
55
|
-
try {
|
|
56
|
-
const config = await require_createISRApp.loadConfig();
|
|
57
|
-
config.server = config.server || { port: 3e3 };
|
|
58
|
-
if (port) config.server.port = parseInt(port);
|
|
59
|
-
if (host) config.server.host = host;
|
|
60
|
-
const app = await require_createISRApp.createISRApp(config);
|
|
61
|
-
require_createISRApp.logger.stopSpinner("开发环境初始化完成");
|
|
62
|
-
const serverContext = await app.start();
|
|
63
|
-
require_createISRApp.logger.success("[CLI]", "开发服务器已启动");
|
|
64
|
-
if (serverContext.url) {
|
|
65
|
-
require_createISRApp.logger.info("[Server]", `页面地址: ${serverContext.url}/`);
|
|
66
|
-
require_createISRApp.logger.info("[Server]", `服务地址: ${serverContext.url}`);
|
|
67
|
-
require_createISRApp.logger.info("[Server]", `健康检查: ${serverContext.url}/health`);
|
|
68
|
-
printRenderModeLinks(serverContext.url, config);
|
|
69
|
-
if (open) openBrowser(serverContext.url);
|
|
70
|
-
} else {
|
|
71
|
-
require_createISRApp.logger.info("[Server]", `端口: ${config.server.port}`);
|
|
72
|
-
require_createISRApp.logger.info("[Server]", "健康检查: /health");
|
|
73
|
-
}
|
|
74
|
-
require_createISRApp.logger.info("[CLI]", "开发提示:");
|
|
75
|
-
require_createISRApp.logger.info("[CLI]", "- 修改文件将自动重新加载");
|
|
76
|
-
require_createISRApp.logger.info("[CLI]", "- 使用 Ctrl+C 停止服务器");
|
|
77
|
-
require_createISRApp.logger.info("[CLI]", "- 查看实时日志和性能指标");
|
|
78
|
-
let shuttingDown = false;
|
|
79
|
-
const handleShutdown = async (signal) => {
|
|
80
|
-
if (shuttingDown) {
|
|
81
|
-
require_createISRApp.logger.warn("[CLI]", `收到 ${signal} 二次触发 —— 强制退出`);
|
|
82
|
-
process.exit(1);
|
|
83
|
-
}
|
|
84
|
-
shuttingDown = true;
|
|
85
|
-
require_createISRApp.logger.warn("[CLI]", `收到 ${signal},关闭服务器...`);
|
|
86
|
-
const forceExit = setTimeout(() => {
|
|
87
|
-
require_createISRApp.logger.warn("[CLI]", "关闭超时,强制退出");
|
|
88
|
-
process.exit(1);
|
|
89
|
-
}, 3e3);
|
|
90
|
-
forceExit.unref();
|
|
91
|
-
try {
|
|
92
|
-
await app.shutdown();
|
|
93
|
-
} catch (err) {
|
|
94
|
-
require_createISRApp.logger.error("[CLI]", "关闭时发生异常", err);
|
|
95
|
-
}
|
|
96
|
-
clearTimeout(forceExit);
|
|
97
|
-
process.exit(0);
|
|
98
|
-
};
|
|
99
|
-
process.on("SIGINT", () => void handleShutdown("SIGINT"));
|
|
100
|
-
process.on("SIGTERM", () => void handleShutdown("SIGTERM"));
|
|
101
|
-
} catch (error) {
|
|
102
|
-
require_createISRApp.logger.stopSpinner("开发服务器启动失败");
|
|
103
|
-
require_createISRApp.logger.error("[CLI]", "开发服务器启动失败", error);
|
|
104
|
-
throw error;
|
|
105
|
-
}
|
|
106
|
-
}
|
|
107
|
-
//#endregion
|
|
108
|
-
//#region src/cli/start.ts
|
|
109
|
-
/** Production CLI: config, listener and process lifecycle around the shared runtime. */
|
|
110
|
-
async function startProductionServer(options) {
|
|
111
|
-
process.env.NODE_ENV = "production";
|
|
112
|
-
let build;
|
|
113
|
-
try {
|
|
114
|
-
build = await require_createISRApp.prepareProductionBuild();
|
|
115
|
-
} catch (error) {
|
|
116
|
-
if (error.code !== "ENOENT") throw error;
|
|
117
|
-
require_createISRApp.logger.error("[CLI]", "未找到生产构建产物,请先运行 pnpm build");
|
|
118
|
-
process.exit(1);
|
|
119
|
-
}
|
|
120
|
-
const config = await require_createISRApp.loadConfig();
|
|
121
|
-
if (options.port) config.server.port = parseInt(options.port, 10);
|
|
122
|
-
if (options.host) config.server.host = options.host;
|
|
123
|
-
const runtime = await require_createISRApp.createProductionRuntime(config, { build });
|
|
124
|
-
let result;
|
|
125
|
-
try {
|
|
126
|
-
result = await require_createISRApp.startServer(runtime.app, {
|
|
127
|
-
port: config.server?.port ?? 3e3,
|
|
128
|
-
host: config.server?.host,
|
|
129
|
-
strictPort: config.server?.strictPort
|
|
130
|
-
});
|
|
131
|
-
} catch (error) {
|
|
132
|
-
try {
|
|
133
|
-
await runtime.close();
|
|
134
|
-
} catch (cleanupError) {
|
|
135
|
-
require_createISRApp.logger.error("[CLI]", "Production startup cleanup failed", cleanupError);
|
|
136
|
-
}
|
|
137
|
-
throw error;
|
|
138
|
-
}
|
|
139
|
-
require_createISRApp.logger.success("[CLI]", `生产服务器已启动: ${result.url}`);
|
|
140
|
-
let shuttingDown = false;
|
|
141
|
-
const handleShutdown = async (signal) => {
|
|
142
|
-
if (shuttingDown) process.exit(1);
|
|
143
|
-
shuttingDown = true;
|
|
144
|
-
require_createISRApp.logger.warn("[CLI]", `收到 ${signal},关闭生产服务器...`);
|
|
145
|
-
const cleanups = await Promise.allSettled([require_createISRApp.closeServer(result.server)]);
|
|
146
|
-
const forceExit = setTimeout(() => process.exit(1), 3e3);
|
|
147
|
-
forceExit.unref();
|
|
148
|
-
cleanups.push(...await Promise.allSettled([Promise.resolve().then(() => runtime.close())]));
|
|
149
|
-
clearTimeout(forceExit);
|
|
150
|
-
for (const cleanup of cleanups) if (cleanup.status === "rejected") require_createISRApp.logger.error("[CLI]", "Production shutdown failed", cleanup.reason);
|
|
151
|
-
process.exit(cleanups.some((result) => result.status === "rejected") ? 1 : 0);
|
|
152
|
-
};
|
|
153
|
-
process.on("SIGINT", () => void handleShutdown("SIGINT"));
|
|
154
|
-
process.on("SIGTERM", () => void handleShutdown("SIGTERM"));
|
|
155
|
-
}
|
|
156
|
-
//#endregion
|
|
157
|
-
//#region src/cli/fallback.ts
|
|
158
|
-
/**
|
|
159
|
-
* `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理
|
|
160
|
-
*
|
|
161
|
-
* 行为是 nginx `error_page 5xx = @spa_fallback` 的功能等价物,
|
|
162
|
-
* 让开发者**不装 nginx**也能在本地复现整条降级链路。
|
|
163
|
-
*
|
|
164
|
-
* 监听 :PORT(默认 8080):
|
|
165
|
-
* - /assets/*, /covers/*, /favicon.ico, /logo.svg → dist/client/ 静态返回
|
|
166
|
-
* - /api/* → 反代到 mock/upstream API(默认 :3001)
|
|
167
|
-
* - 其它 → 反代到 SSR(默认 :3000);
|
|
168
|
-
* 5xx 或 connect refused → 切 dist/spa/index.html
|
|
169
|
-
* 兜底响应附带 `x-fallback: spa` 头
|
|
170
|
-
*
|
|
171
|
-
* 用法:
|
|
172
|
-
* pnpm build
|
|
173
|
-
* pnpm --filter mock-server start # :3001
|
|
174
|
-
* isr-engine start # :3000 SSR
|
|
175
|
-
* isr-engine test-fallback-local # :8080 ← 用户访问这个
|
|
176
|
-
* open http://localhost:8080/ # → 看到 SSR 渲染
|
|
177
|
-
* kill <ssr pid>; reload # → 自动看到橙色 banner + SPA 兜底
|
|
178
|
-
* 重启 SSR; reload # → 自动切回 SSR
|
|
179
|
-
*
|
|
180
|
-
* 生产环境**不需要**这个命令 —— 用 nginx 的 error_page 即可。
|
|
181
|
-
*/
|
|
182
|
-
var MIME = {
|
|
183
|
-
".html": "text/html; charset=utf-8",
|
|
184
|
-
".js": "application/javascript; charset=utf-8",
|
|
185
|
-
".mjs": "application/javascript; charset=utf-8",
|
|
186
|
-
".css": "text/css; charset=utf-8",
|
|
187
|
-
".svg": "image/svg+xml",
|
|
188
|
-
".png": "image/png",
|
|
189
|
-
".jpg": "image/jpeg",
|
|
190
|
-
".jpeg": "image/jpeg",
|
|
191
|
-
".webp": "image/webp",
|
|
192
|
-
".json": "application/json; charset=utf-8",
|
|
193
|
-
".ico": "image/x-icon"
|
|
194
|
-
};
|
|
195
|
-
function proxyRequest(req, res, target, onUpstreamError) {
|
|
196
|
-
const handleErr = (err) => {
|
|
197
|
-
if (onUpstreamError) onUpstreamError(err);
|
|
198
|
-
else sendError(res, 502, err.message);
|
|
199
|
-
};
|
|
200
|
-
const upstream = node_http.default.request({
|
|
201
|
-
host: target.host,
|
|
202
|
-
port: target.port,
|
|
203
|
-
path: req.url,
|
|
204
|
-
method: req.method,
|
|
205
|
-
headers: {
|
|
206
|
-
...req.headers,
|
|
207
|
-
host: `${target.host}:${target.port}`
|
|
208
|
-
}
|
|
209
|
-
}, (upRes) => {
|
|
210
|
-
const code = upRes.statusCode || 502;
|
|
211
|
-
if (code >= 500 && onUpstreamError) {
|
|
212
|
-
upRes.resume();
|
|
213
|
-
onUpstreamError(/* @__PURE__ */ new Error(`upstream ${code}`));
|
|
214
|
-
return;
|
|
215
|
-
}
|
|
216
|
-
res.writeHead(code, upRes.headers);
|
|
217
|
-
upRes.pipe(res);
|
|
218
|
-
});
|
|
219
|
-
upstream.on("error", handleErr);
|
|
220
|
-
req.pipe(upstream);
|
|
221
|
-
}
|
|
222
|
-
async function serveStatic(req, res, clientRoot) {
|
|
223
|
-
let pathname;
|
|
224
|
-
try {
|
|
225
|
-
pathname = decodeURIComponent(new URL(req.url || "/", "http://x").pathname);
|
|
226
|
-
} catch {
|
|
227
|
-
sendError(res, 400, "invalid request path");
|
|
228
|
-
return;
|
|
229
|
-
}
|
|
230
|
-
const filePath = (0, node_path.join)(clientRoot, pathname);
|
|
231
|
-
if (!filePath.startsWith(clientRoot + node_path.sep)) {
|
|
232
|
-
sendError(res, 403, "forbidden");
|
|
233
|
-
return;
|
|
234
|
-
}
|
|
235
|
-
try {
|
|
236
|
-
const file = await (0, node_fs_promises.open)(filePath, "r");
|
|
237
|
-
let buf;
|
|
238
|
-
try {
|
|
239
|
-
if (!(await file.stat()).isFile()) throw new Error("not file");
|
|
240
|
-
buf = await file.readFile();
|
|
241
|
-
} finally {
|
|
242
|
-
await file.close();
|
|
243
|
-
}
|
|
244
|
-
res.writeHead(200, { "content-type": MIME[(0, node_path.extname)(filePath)] || "application/octet-stream" });
|
|
245
|
-
res.end(buf);
|
|
246
|
-
} catch {
|
|
247
|
-
sendError(res, 404, "not found");
|
|
248
|
-
}
|
|
249
|
-
}
|
|
250
|
-
async function serveSpaShell(res, spaShell) {
|
|
251
|
-
try {
|
|
252
|
-
const html = await (0, node_fs_promises.readFile)(spaShell, "utf8");
|
|
253
|
-
res.writeHead(200, {
|
|
254
|
-
"content-type": "text/html; charset=utf-8",
|
|
255
|
-
"x-fallback": "spa"
|
|
256
|
-
});
|
|
257
|
-
res.end(html);
|
|
258
|
-
} catch {
|
|
259
|
-
sendError(res, 500, `SPA shell not found at ${spaShell} — run \`pnpm build\` first`);
|
|
260
|
-
}
|
|
261
|
-
}
|
|
262
|
-
function sendError(res, code, msg) {
|
|
263
|
-
if (res.headersSent) return;
|
|
264
|
-
res.writeHead(code, { "content-type": "text/plain; charset=utf-8" });
|
|
265
|
-
res.end(`${code} ${msg}\n`);
|
|
266
|
-
}
|
|
267
|
-
/**
|
|
268
|
-
* 创建 fallback 路由 handler(与 listen 解耦),便于单测直接挂到 ephemeral port 上
|
|
269
|
-
* 验证三种分支(static / api proxy / ssr proxy + spa fallback)。
|
|
270
|
-
*/
|
|
271
|
-
function createFallbackRequestHandler(options) {
|
|
272
|
-
const distRoot = (0, node_path.resolve)(process.cwd(), options.dist);
|
|
273
|
-
const clientRoot = (0, node_path.join)(distRoot, "client");
|
|
274
|
-
const spaShell = (0, node_path.join)(distRoot, "spa", "index.html");
|
|
275
|
-
const ssr = {
|
|
276
|
-
host: "127.0.0.1",
|
|
277
|
-
port: parseInt(options.ssrPort, 10)
|
|
278
|
-
};
|
|
279
|
-
const api = {
|
|
280
|
-
host: "127.0.0.1",
|
|
281
|
-
port: parseInt(options.apiPort, 10)
|
|
282
|
-
};
|
|
283
|
-
return (req, res) => {
|
|
284
|
-
const path = (req.url || "/").split("?")[0];
|
|
285
|
-
if (path.startsWith("/assets/") || path.startsWith("/covers/") || path === "/favicon.ico" || path === "/logo.svg") {
|
|
286
|
-
serveStatic(req, res, clientRoot);
|
|
287
|
-
return;
|
|
288
|
-
}
|
|
289
|
-
if (path.startsWith("/api/")) {
|
|
290
|
-
proxyRequest(req, res, api);
|
|
291
|
-
return;
|
|
292
|
-
}
|
|
293
|
-
proxyRequest(req, res, ssr, (err) => {
|
|
294
|
-
require_createISRApp.logger.warn("[fallback]", `SSR 失败 (${err.message}) → 切换 SPA shell: ${path}`);
|
|
295
|
-
serveSpaShell(res, spaShell);
|
|
296
|
-
});
|
|
297
|
-
};
|
|
298
|
-
}
|
|
299
|
-
function startFallbackProxy(options) {
|
|
300
|
-
const spaShell = (0, node_path.join)((0, node_path.resolve)(process.cwd(), options.dist), "spa", "index.html");
|
|
301
|
-
const ssrPort = parseInt(options.ssrPort, 10);
|
|
302
|
-
const apiPort = parseInt(options.apiPort, 10);
|
|
303
|
-
const listenPort = parseInt(options.port, 10);
|
|
304
|
-
const server = node_http.default.createServer(createFallbackRequestHandler(options));
|
|
305
|
-
server.listen(listenPort, "127.0.0.1", () => {
|
|
306
|
-
require_createISRApp.logger.success("[CLI]", `本地 fallback proxy 已启动: http://localhost:${listenPort}`);
|
|
307
|
-
require_createISRApp.logger.info("[CLI]", ` → SSR upstream : http://127.0.0.1:${ssrPort}`);
|
|
308
|
-
require_createISRApp.logger.info("[CLI]", ` → API upstream : http://127.0.0.1:${apiPort}`);
|
|
309
|
-
require_createISRApp.logger.info("[CLI]", ` → 5xx fallback : ${spaShell}`);
|
|
310
|
-
require_createISRApp.logger.info("[CLI]", `提示:杀掉 SSR 进程 + 浏览器 reload,可看到自动切到 SPA shell(响应头 x-fallback: spa)`);
|
|
311
|
-
});
|
|
312
|
-
return server;
|
|
313
|
-
}
|
|
314
|
-
//#endregion
|
|
315
|
-
//#region src/cli/serverOptions.ts
|
|
316
|
-
/**
|
|
317
|
-
* 注册服务监听参数。省略默认值是有意的:只有用户显式传参时,
|
|
318
|
-
* CLI 才应覆盖 ssr.config.ts 中的 server 配置。
|
|
319
|
-
*/
|
|
320
|
-
function addServerBindingOptions(command) {
|
|
321
|
-
return command.option("-p, --port <port>", "端口号").option("-h, --host <host>", "主机地址");
|
|
322
|
-
}
|
|
323
|
-
//#endregion
|
|
324
|
-
//#region src/cli/cli.ts
|
|
325
|
-
/**
|
|
326
|
-
* ISR Engine CLI 主程序
|
|
327
|
-
*
|
|
328
|
-
* 主入口,负责命令注册和程序协调
|
|
329
|
-
*/
|
|
330
|
-
var program = new commander.Command();
|
|
331
|
-
/**
|
|
332
|
-
* 主程序配置
|
|
333
|
-
*/
|
|
334
|
-
program.name("isr-engine").description("ISR Engine — Vite + React 19 RSC 的 ISR/SSG/SSR 编排层").version(require_createISRApp.package_default.version);
|
|
335
|
-
/**
|
|
336
|
-
* dev 命令 - 开发服务器
|
|
337
|
-
*/
|
|
338
|
-
addServerBindingOptions(program.command("dev").description("启动开发服务器")).option("--open", "启动后自动打开浏览器", true).option("--no-open", "启动后不自动打开浏览器").action(async (options) => {
|
|
339
|
-
try {
|
|
340
|
-
await startDevServer(options);
|
|
341
|
-
} catch (error) {
|
|
342
|
-
require_createISRApp.logger.error("[CLI]", "开发服务器启动失败", error);
|
|
343
|
-
process.exit(1);
|
|
344
|
-
}
|
|
345
|
-
});
|
|
346
|
-
/**
|
|
347
|
-
* start 命令 - 生产服务器
|
|
348
|
-
*/
|
|
349
|
-
addServerBindingOptions(program.command("start").description("启动生产服务器")).action(async (options) => {
|
|
350
|
-
try {
|
|
351
|
-
await startProductionServer(options);
|
|
352
|
-
} catch (error) {
|
|
353
|
-
require_createISRApp.logger.error("[CLI]", "生产服务器启动失败", error);
|
|
354
|
-
process.exit(1);
|
|
355
|
-
}
|
|
356
|
-
});
|
|
357
|
-
/**
|
|
358
|
-
* test-fallback-local 命令 - 本地 SSR→SPA 降级链路验证代理(nginx error_page 等价物)
|
|
359
|
-
* 仅本地开发用;生产环境用 nginx
|
|
360
|
-
*/
|
|
361
|
-
program.command("test-fallback-local").description("本地启动 fallback 代理,验证 SSR 死时自动切到 SPA shell").option("-p, --port <port>", "本地代理监听端口", "8080").option("--ssr-port <port>", "SSR 上游端口", String(require_createISRApp.DEFAULT_PORT)).option("--api-port <port>", "API/mock 上游端口", "3001").option("--dist <path>", "dist 根目录(含 client/ + spa/)", "./dist").action((options) => {
|
|
362
|
-
try {
|
|
363
|
-
startFallbackProxy(options);
|
|
364
|
-
} catch (error) {
|
|
365
|
-
require_createISRApp.logger.error("[CLI]", "test-fallback-local proxy 启动失败", error);
|
|
366
|
-
process.exit(1);
|
|
367
|
-
}
|
|
368
|
-
});
|
|
369
|
-
program.parse();
|
|
370
|
-
//#endregion
|
|
371
|
-
|
|
372
|
-
//# sourceMappingURL=cli.cjs.map
|
package/dist/cli/cli.cjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"cli.cjs","names":[],"sources":["../../src/cli/dev.ts","../../src/cli/start.ts","../../src/cli/fallback.ts","../../src/cli/serverOptions.ts","../../src/cli/cli.ts"],"sourcesContent":["/**\n * 开发服务器命令\n */\n\nimport { spawn } from 'node:child_process';\nimport { logger } from '@/logger';\nimport { createISRApp } from '../app/createISRApp';\nimport { loadConfig } from '../config/loadConfig';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport type { ISRConfig } from '@/types';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n open?: boolean;\n}\n\nfunction openBrowser(url: string): void {\n const command =\n process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';\n const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];\n const child = spawn(command, args, { stdio: 'ignore', detached: true });\n child.on('error', error => {\n logger.warn('[CLI]', `自动打开浏览器失败:${error.message}`);\n });\n child.unref();\n}\n\nfunction getSamplePath(config: ISRConfig, mode: 'isr' | 'ssr' | 'ssg'): string {\n const routes = config.routes ?? {};\n for (const [route, value] of Object.entries(routes)) {\n const routeMode = typeof value === 'string' ? value : value?.mode;\n if (routeMode === mode && !route.includes('*')) return route;\n }\n if (mode === 'ssg') {\n const ssgRoutes = config.ssg?.routes;\n return Array.isArray(ssgRoutes) ? (ssgRoutes[0] ?? '/about') : '/about';\n }\n if (mode === 'ssr') return '/login';\n return '/';\n}\n\nfunction printRenderModeLinks(baseUrl: string, config: ISRConfig): void {\n const trimBase = baseUrl.replace(/\\/$/, '');\n const isrPath = getSamplePath(config, 'isr');\n const ssrPath = getSamplePath(config, 'ssr');\n const ssgPath = getSamplePath(config, 'ssg');\n\n logger.info('[Dev Links]', `ISR: ${trimBase}${isrPath}?mode=isr`);\n logger.info('[Dev Links]', `SSR: ${trimBase}${ssrPath}?mode=ssr`);\n logger.info('[Dev Links]', `SSG: ${trimBase}${ssgPath}?mode=ssg`);\n logger.info('[Dev Links]', `CSR fallback: ${trimBase}${isrPath}?__csr-shell=1`);\n logger.info('[Dev Links]', `No-JS/SSR HTML: ${trimBase}${isrPath}?__nojs=1`);\n logger.info('[Dev Links]', `响应头查看: x-resolved-mode / x-render-strategy / x-fallback-used`);\n}\n\nexport async function startDevServer(options: StartOptions) {\n const { port, host, open = false } = options;\n\n logger.info('[CLI]', '启动开发服务器');\n logger.spin('初始化开发环境...');\n\n try {\n // 读取项目配置\n const config = await loadConfig();\n\n // 确保 server 配置存在\n config.server = config.server || {\n port: DEFAULT_PORT,\n };\n\n // CLI 参数覆盖配置\n if (port) {\n config.server.port = parseInt(port);\n }\n if (host) {\n config.server.host = host;\n }\n // 创建应用实例\n const app = await createISRApp(config);\n\n logger.stopSpinner('开发环境初始化完成');\n\n // 启动服务器\n const serverContext = await app.start();\n\n logger.success('[CLI]', '开发服务器已启动');\n if (serverContext.url) {\n logger.info('[Server]', `页面地址: ${serverContext.url}/`);\n logger.info('[Server]', `服务地址: ${serverContext.url}`);\n logger.info('[Server]', `健康检查: ${serverContext.url}/health`);\n printRenderModeLinks(serverContext.url, config);\n if (open) {\n openBrowser(serverContext.url);\n }\n } else {\n logger.info('[Server]', `端口: ${config.server.port}`);\n logger.info('[Server]', '健康检查: /health');\n }\n\n logger.info('[CLI]', '开发提示:');\n logger.info('[CLI]', '- 修改文件将自动重新加载');\n logger.info('[CLI]', '- 使用 Ctrl+C 停止服务器');\n logger.info('[CLI]', '- 查看实时日志和性能指标');\n\n // 优雅关闭:\n // - 第一次 Ctrl+C:走 app.shutdown()(关 Vite + 强制断开 HTTP keep-alive 连接 + 释放端口)\n // - 3 秒内完不成 / 收到第二次信号:强制 process.exit(0)(防僵死)\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n logger.warn('[CLI]', `收到 ${signal} 二次触发 —— 强制退出`);\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭服务器...`);\n\n const forceExit = setTimeout(() => {\n logger.warn('[CLI]', '关闭超时,强制退出');\n process.exit(1);\n }, 3000);\n forceExit.unref();\n\n try {\n await app.shutdown();\n } catch (err) {\n logger.error('[CLI]', '关闭时发生异常', err);\n }\n clearTimeout(forceExit);\n process.exit(0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n } catch (error) {\n logger.stopSpinner('开发服务器启动失败');\n logger.error('[CLI]', '开发服务器启动失败', error);\n throw error;\n }\n}\n","/** Production CLI: config, listener and process lifecycle around the shared runtime. */\nimport { loadConfig } from '../config/loadConfig';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport { startServer, closeServer } from '@/server/httpServer';\nimport { createProductionRuntime, prepareProductionBuild } from '@/server/productionRuntime';\nexport {\n extractRoutesForSitemap,\n applyTelemetryIntegrationEnv,\n createProductionJsonMiddleware,\n nodeToWebRequest,\n pipeWebResponse,\n createStaticHtmlMiddleware,\n createStaticAssetMiddleware,\n} from '@/server/productionRuntime';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n}\nexport async function startProductionServer(options: StartOptions): Promise<void> {\n process.env.NODE_ENV = 'production';\n let build;\n try {\n build = await prepareProductionBuild();\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n logger.error('[CLI]', '未找到生产构建产物,请先运行 pnpm build');\n process.exit(1);\n }\n const config = await loadConfig();\n if (options.port) config.server.port = parseInt(options.port, 10);\n if (options.host) config.server.host = options.host;\n const runtime = await createProductionRuntime(config, { build });\n let result;\n try {\n result = await startServer(runtime.app, {\n port: config.server?.port ?? DEFAULT_PORT,\n host: config.server?.host,\n strictPort: config.server?.strictPort,\n });\n } catch (error) {\n try {\n await runtime.close();\n } catch (cleanupError) {\n logger.error('[CLI]', 'Production startup cleanup failed', cleanupError);\n }\n throw error;\n }\n logger.success('[CLI]', `生产服务器已启动: ${result.url}`);\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭生产服务器...`);\n const cleanups = await Promise.allSettled([closeServer(result.server)]);\n const forceExit = setTimeout(() => process.exit(1), 3000);\n forceExit.unref();\n cleanups.push(...(await Promise.allSettled([Promise.resolve().then(() => runtime.close())])));\n clearTimeout(forceExit);\n for (const cleanup of cleanups) {\n if (cleanup.status === 'rejected')\n logger.error('[CLI]', 'Production shutdown failed', cleanup.reason);\n }\n process.exit(cleanups.some(result => result.status === 'rejected') ? 1 : 0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n}\n","/**\n * `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理\n *\n * 行为是 nginx `error_page 5xx = @spa_fallback` 的功能等价物,\n * 让开发者**不装 nginx**也能在本地复现整条降级链路。\n *\n * 监听 :PORT(默认 8080):\n * - /assets/*, /covers/*, /favicon.ico, /logo.svg → dist/client/ 静态返回\n * - /api/* → 反代到 mock/upstream API(默认 :3001)\n * - 其它 → 反代到 SSR(默认 :3000);\n * 5xx 或 connect refused → 切 dist/spa/index.html\n * 兜底响应附带 `x-fallback: spa` 头\n *\n * 用法:\n * pnpm build\n * pnpm --filter mock-server start # :3001\n * isr-engine start # :3000 SSR\n * isr-engine test-fallback-local # :8080 ← 用户访问这个\n * open http://localhost:8080/ # → 看到 SSR 渲染\n * kill <ssr pid>; reload # → 自动看到橙色 banner + SPA 兜底\n * 重启 SSR; reload # → 自动切回 SSR\n *\n * 生产环境**不需要**这个命令 —— 用 nginx 的 error_page 即可。\n */\nimport http from 'node:http';\nimport { open, readFile } from 'node:fs/promises';\nimport { extname, join, resolve, sep } from 'node:path';\nimport { logger } from '@/logger';\n\nexport interface FallbackProxyOptions {\n /** 监听端口(用户访问此处) */\n port: string;\n /** SSR 上游端口(isr-engine start 监听的) */\n ssrPort: string;\n /** API 上游端口(mock-server / 真后端) */\n apiPort: string;\n /** dist 根目录(绝对或相对路径,相对 cwd) */\n dist: string;\n}\n\nconst MIME: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'application/javascript; charset=utf-8',\n '.mjs': 'application/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.json': 'application/json; charset=utf-8',\n '.ico': 'image/x-icon',\n};\n\ninterface UpstreamTarget {\n host: string;\n port: number;\n}\n\nfunction proxyRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n target: UpstreamTarget,\n onUpstreamError?: (err: Error) => void\n): void {\n const handleErr = (err: Error): void => {\n if (onUpstreamError) onUpstreamError(err);\n else sendError(res, 502, err.message);\n };\n const upstream = http.request(\n {\n host: target.host,\n port: target.port,\n path: req.url,\n method: req.method,\n headers: { ...req.headers, host: `${target.host}:${target.port}` },\n },\n upRes => {\n const code = upRes.statusCode || 502;\n if (code >= 500 && onUpstreamError) {\n upRes.resume();\n onUpstreamError(new Error(`upstream ${code}`));\n return;\n }\n res.writeHead(code, upRes.headers);\n upRes.pipe(res);\n }\n );\n upstream.on('error', handleErr);\n req.pipe(upstream);\n}\n\nasync function serveStatic(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n clientRoot: string\n): Promise<void> {\n let pathname: string;\n try {\n pathname = decodeURIComponent(new URL(req.url || '/', 'http://x').pathname);\n } catch {\n sendError(res, 400, 'invalid request path');\n return;\n }\n const filePath = join(clientRoot, pathname);\n if (!filePath.startsWith(clientRoot + sep)) {\n sendError(res, 403, 'forbidden');\n return;\n }\n try {\n const file = await open(filePath, 'r');\n let buf: Buffer;\n try {\n const s = await file.stat();\n if (!s.isFile()) throw new Error('not file');\n buf = await file.readFile();\n } finally {\n await file.close();\n }\n res.writeHead(200, {\n 'content-type': MIME[extname(filePath)] || 'application/octet-stream',\n });\n res.end(buf);\n } catch {\n sendError(res, 404, 'not found');\n }\n}\n\nasync function serveSpaShell(res: http.ServerResponse, spaShell: string): Promise<void> {\n try {\n const html = await readFile(spaShell, 'utf8');\n res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'x-fallback': 'spa' });\n res.end(html);\n } catch {\n sendError(res, 500, `SPA shell not found at ${spaShell} — run \\`pnpm build\\` first`);\n }\n}\n\nfunction sendError(res: http.ServerResponse, code: number, msg: string): void {\n if (res.headersSent) return;\n res.writeHead(code, { 'content-type': 'text/plain; charset=utf-8' });\n res.end(`${code} ${msg}\\n`);\n}\n\n/**\n * 创建 fallback 路由 handler(与 listen 解耦),便于单测直接挂到 ephemeral port 上\n * 验证三种分支(static / api proxy / ssr proxy + spa fallback)。\n */\nexport function createFallbackRequestHandler(options: FallbackProxyOptions): http.RequestListener {\n const distRoot = resolve(process.cwd(), options.dist);\n const clientRoot = join(distRoot, 'client');\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssr: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.ssrPort, 10) };\n const api: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.apiPort, 10) };\n\n return (req, res) => {\n const path = (req.url || '/').split('?')[0];\n\n if (\n path.startsWith('/assets/') ||\n path.startsWith('/covers/') ||\n path === '/favicon.ico' ||\n path === '/logo.svg'\n ) {\n void serveStatic(req, res, clientRoot);\n return;\n }\n\n if (path.startsWith('/api/')) {\n proxyRequest(req, res, api);\n return;\n }\n\n proxyRequest(req, res, ssr, err => {\n logger.warn('[fallback]', `SSR 失败 (${err.message}) → 切换 SPA shell: ${path}`);\n void serveSpaShell(res, spaShell);\n });\n };\n}\n\nexport function startFallbackProxy(options: FallbackProxyOptions): http.Server {\n const distRoot = resolve(process.cwd(), options.dist);\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssrPort = parseInt(options.ssrPort, 10);\n const apiPort = parseInt(options.apiPort, 10);\n const listenPort = parseInt(options.port, 10);\n\n const server = http.createServer(createFallbackRequestHandler(options));\n\n server.listen(listenPort, '127.0.0.1', () => {\n logger.success('[CLI]', `本地 fallback proxy 已启动: http://localhost:${listenPort}`);\n logger.info('[CLI]', ` → SSR upstream : http://127.0.0.1:${ssrPort}`);\n logger.info('[CLI]', ` → API upstream : http://127.0.0.1:${apiPort}`);\n logger.info('[CLI]', ` → 5xx fallback : ${spaShell}`);\n logger.info(\n '[CLI]',\n `提示:杀掉 SSR 进程 + 浏览器 reload,可看到自动切到 SPA shell(响应头 x-fallback: spa)`\n );\n });\n\n return server;\n}\n","import type { Command } from 'commander';\n\n/**\n * 注册服务监听参数。省略默认值是有意的:只有用户显式传参时,\n * CLI 才应覆盖 ssr.config.ts 中的 server 配置。\n */\nexport function addServerBindingOptions(command: Command): Command {\n return command.option('-p, --port <port>', '端口号').option('-h, --host <host>', '主机地址');\n}\n","#!/usr/bin/env node\n\n/**\n * ISR Engine CLI 主程序\n *\n * 主入口,负责命令注册和程序协调\n */\n\nimport { Command } from 'commander';\nimport pkg from '../../package.json';\n\nimport { startDevServer } from './dev';\nimport { startProductionServer } from './start';\nimport { startFallbackProxy } from './fallback';\nimport { addServerBindingOptions } from './serverOptions';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\n\nconst program = new Command();\n\n/**\n * 主程序配置\n */\nprogram\n .name('isr-engine')\n .description('ISR Engine — Vite + React 19 RSC 的 ISR/SSG/SSR 编排层')\n .version(pkg.version);\n\n/**\n * dev 命令 - 开发服务器\n */\naddServerBindingOptions(program.command('dev').description('启动开发服务器'))\n .option('--open', '启动后自动打开浏览器', true)\n .option('--no-open', '启动后不自动打开浏览器')\n .action(async options => {\n try {\n await startDevServer(options);\n } catch (error) {\n logger.error('[CLI]', '开发服务器启动失败', error);\n process.exit(1);\n }\n });\n\n/**\n * start 命令 - 生产服务器\n */\naddServerBindingOptions(program.command('start').description('启动生产服务器')).action(\n async options => {\n try {\n await startProductionServer(options);\n } catch (error) {\n logger.error('[CLI]', '生产服务器启动失败', error);\n process.exit(1);\n }\n }\n);\n\n/**\n * test-fallback-local 命令 - 本地 SSR→SPA 降级链路验证代理(nginx error_page 等价物)\n * 仅本地开发用;生产环境用 nginx\n */\nprogram\n .command('test-fallback-local')\n .description('本地启动 fallback 代理,验证 SSR 死时自动切到 SPA shell')\n .option('-p, --port <port>', '本地代理监听端口', '8080')\n .option('--ssr-port <port>', 'SSR 上游端口', String(DEFAULT_PORT))\n .option('--api-port <port>', 'API/mock 上游端口', '3001')\n .option('--dist <path>', 'dist 根目录(含 client/ + spa/)', './dist')\n .action(options => {\n try {\n startFallbackProxy(options);\n } catch (error) {\n logger.error('[CLI]', 'test-fallback-local proxy 启动失败', error);\n process.exit(1);\n }\n });\n\n// 主程序入口 - 直接执行\nprogram.parse();\n"],"mappings":"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"}
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
-
//#region src/config/defineConfig.ts
|
|
3
|
-
/**
|
|
4
|
-
* ssr.config.ts 的类型收口入口。
|
|
5
|
-
*
|
|
6
|
-
* 业务侧只需要:
|
|
7
|
-
* import { defineIsrConfig } from 'isr-engine/config';
|
|
8
|
-
* export default defineIsrConfig({ ... })
|
|
9
|
-
*
|
|
10
|
-
* 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,
|
|
11
|
-
* 后续字段演进也只改 engine。
|
|
12
|
-
*
|
|
13
|
-
* 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin
|
|
14
|
-
* 工具链打进 RSC/SSG bundle。
|
|
15
|
-
*/
|
|
16
|
-
function defineIsrConfig(config) {
|
|
17
|
-
return config;
|
|
18
|
-
}
|
|
19
|
-
function defineRuntimeConfig(runtime) {
|
|
20
|
-
return runtime;
|
|
21
|
-
}
|
|
22
|
-
//#endregion
|
|
23
|
-
exports.defineIsrConfig = defineIsrConfig;
|
|
24
|
-
exports.defineRuntimeConfig = defineRuntimeConfig;
|
|
25
|
-
|
|
26
|
-
//# sourceMappingURL=defineConfig.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"defineConfig.cjs","names":[],"sources":["../../src/config/defineConfig.ts"],"sourcesContent":["import type { ISRConfig, RuntimeConfig } from '../types';\n\ntype ExactTopLevel<T, Shape> = T & Record<Exclude<keyof T, keyof Shape>, never>;\ntype IsrServerConfig = ISRConfig['server'];\ntype IsrOpsConfig = IsrServerConfig['ops'];\ntype RuntimeServicesConfig = RuntimeConfig['services'];\ntype ExactOps<T> = T extends { ops: infer Ops }\n ? {\n ops: ExactTopLevel<Ops & IsrOpsConfig, IsrOpsConfig>;\n }\n : unknown;\ntype ExactServer<T> = T extends { server: infer Server }\n ? {\n server: ExactTopLevel<Server & IsrServerConfig, IsrServerConfig> & ExactOps<Server>;\n }\n : unknown;\ntype ExactRuntimeServices<T> = T extends { services: infer Services }\n ? {\n services: ExactTopLevel<Services & RuntimeServicesConfig, RuntimeServicesConfig>;\n }\n : unknown;\ntype ExactRuntime<T extends RuntimeConfig> = ExactTopLevel<T, RuntimeConfig> &\n ExactRuntimeServices<T>;\ntype ExactIsrRuntime<T> = T extends { runtime: infer Runtime }\n ? {\n runtime: ExactRuntime<Runtime & RuntimeConfig>;\n }\n : unknown;\ntype ExactIsrConfig<T extends ISRConfig> = ExactTopLevel<T, ISRConfig> &\n ExactServer<T> &\n ExactIsrRuntime<T>;\n\n/**\n * ssr.config.ts 的类型收口入口。\n *\n * 业务侧只需要:\n * import { defineIsrConfig } from 'isr-engine/config';\n * export default defineIsrConfig({ ... })\n *\n * 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,\n * 后续字段演进也只改 engine。\n *\n * 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin\n * 工具链打进 RSC/SSG bundle。\n */\nexport function defineIsrConfig<const T extends ISRConfig>(config: ExactIsrConfig<T>): T {\n return config;\n}\n\nexport function defineRuntimeConfig<const T extends RuntimeConfig>(runtime: ExactRuntime<T>): T {\n return runtime;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6CA,SAAgB,gBAA2C,QAA8B;CACvF,OAAO;AACT;AAEA,SAAgB,oBAAmD,SAA6B;CAC9F,OAAO;AACT"}
|
|
@@ -1,112 +0,0 @@
|
|
|
1
|
-
const require_rolldown_runtime = require("./rolldown-runtime-DakpK96I.cjs");
|
|
2
|
-
const require_createISRApp = require("./createISRApp-tRkpdmpp.cjs");
|
|
3
|
-
let express = require("express");
|
|
4
|
-
express = require_rolldown_runtime.__toESM(express, 1);
|
|
5
|
-
/** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */
|
|
6
|
-
var HARD_LIMIT = 1e3;
|
|
7
|
-
/** L1 默认 limit */
|
|
8
|
-
var DEFAULT_LIMIT = 100;
|
|
9
|
-
/** L2 SCAN 单次返回硬上限 —— 比 L1 更严,因为每个 entry 一次 STRLEN+TTL 是 2 个 Redis 命令 */
|
|
10
|
-
var L2_HARD_LIMIT = 500;
|
|
11
|
-
/** L2 默认 limit */
|
|
12
|
-
var L2_DEFAULT_LIMIT = 200;
|
|
13
|
-
function parseStatusFilter(raw) {
|
|
14
|
-
if (raw === "fresh" || raw === "stale" || raw === "expired" || raw === "all") return raw;
|
|
15
|
-
return "all";
|
|
16
|
-
}
|
|
17
|
-
function parseLimit(raw) {
|
|
18
|
-
if (!raw) return DEFAULT_LIMIT;
|
|
19
|
-
const n = parseInt(raw, 10);
|
|
20
|
-
if (!Number.isFinite(n) || n <= 0) return DEFAULT_LIMIT;
|
|
21
|
-
return Math.min(n, HARD_LIMIT);
|
|
22
|
-
}
|
|
23
|
-
function parseL2Limit(raw) {
|
|
24
|
-
if (!raw) return L2_DEFAULT_LIMIT;
|
|
25
|
-
const n = parseInt(raw, 10);
|
|
26
|
-
if (!Number.isFinite(n) || n <= 0) return L2_DEFAULT_LIMIT;
|
|
27
|
-
return Math.min(n, L2_HARD_LIMIT);
|
|
28
|
-
}
|
|
29
|
-
function parseBoolFlag(raw, defaultValue) {
|
|
30
|
-
if (raw === null) return defaultValue;
|
|
31
|
-
const v = raw.toLowerCase();
|
|
32
|
-
if (v === "true" || v === "1" || v === "yes") return true;
|
|
33
|
-
if (v === "false" || v === "0" || v === "no") return false;
|
|
34
|
-
return defaultValue;
|
|
35
|
-
}
|
|
36
|
-
/**
|
|
37
|
-
* 创建 inventory 中间件。
|
|
38
|
-
*
|
|
39
|
-
* 必须在 ISR cache middleware 之前挂(路径已在 isBypassPath 但提前挂可以避开
|
|
40
|
-
* cache handler 内部 metric 记录这次 admin 请求)。
|
|
41
|
-
*
|
|
42
|
-
* @param handler ISR cache handler,必须支持 getCacheInspection()
|
|
43
|
-
* @param opsConfig resolveOpsConfig 的输出 —— inventory.enabled 控制端点是否生效
|
|
44
|
-
*/
|
|
45
|
-
function createCacheInspectorMiddleware(handler, opsConfig) {
|
|
46
|
-
if (!opsConfig.inventory.enabled) return (_req, _res, next) => next();
|
|
47
|
-
const auth = require_createISRApp.createOpsAuthMiddleware("inventory", opsConfig);
|
|
48
|
-
const guarded = express.default.Router();
|
|
49
|
-
guarded.use(require_createISRApp.getOpsRequestLimiter(opsConfig));
|
|
50
|
-
guarded.use(auth);
|
|
51
|
-
guarded.use((req, res) => {
|
|
52
|
-
respond(req, res, handler);
|
|
53
|
-
});
|
|
54
|
-
return (req, res, next) => {
|
|
55
|
-
if (req.method !== "GET" && req.method !== "HEAD") {
|
|
56
|
-
next();
|
|
57
|
-
return;
|
|
58
|
-
}
|
|
59
|
-
if ((req.url ?? "/").split("?")[0] !== "/__isr/cache/inventory") {
|
|
60
|
-
next();
|
|
61
|
-
return;
|
|
62
|
-
}
|
|
63
|
-
guarded(req, res, next);
|
|
64
|
-
};
|
|
65
|
-
async function respond(req, res, h) {
|
|
66
|
-
try {
|
|
67
|
-
const snapshot = h.getCacheInspection();
|
|
68
|
-
const params = new URLSearchParams((req.url ?? "").split("?")[1] ?? "");
|
|
69
|
-
const statusFilter = parseStatusFilter(params.get("status"));
|
|
70
|
-
const limit = parseLimit(params.get("limit"));
|
|
71
|
-
const includeL2 = parseBoolFlag(params.get("l2"), true);
|
|
72
|
-
const l2Limit = parseL2Limit(params.get("l2Limit"));
|
|
73
|
-
const filtered = statusFilter === "all" ? snapshot.entries : snapshot.entries.filter((e) => e.status === statusFilter);
|
|
74
|
-
const limited = [...filtered].sort((a, b) => b.ageSeconds - a.ageSeconds).slice(0, limit);
|
|
75
|
-
const sortedInvalidations = [...snapshot.invalidations].sort((a, b) => b.lastInvalidatedMs - a.lastInvalidatedMs);
|
|
76
|
-
const l2Items = includeL2 && snapshot.backend === "hybrid" ? await h.getL2Inspection(l2Limit) : [];
|
|
77
|
-
const body = JSON.stringify({
|
|
78
|
-
now: snapshot.now,
|
|
79
|
-
backend: snapshot.backend,
|
|
80
|
-
size: snapshot.size,
|
|
81
|
-
max: snapshot.max,
|
|
82
|
-
filter: {
|
|
83
|
-
status: statusFilter,
|
|
84
|
-
limit,
|
|
85
|
-
l2: includeL2,
|
|
86
|
-
l2Limit
|
|
87
|
-
},
|
|
88
|
-
filtered: filtered.length,
|
|
89
|
-
entries: limited,
|
|
90
|
-
invalidations: sortedInvalidations,
|
|
91
|
-
l2: {
|
|
92
|
-
scanned: l2Items.length,
|
|
93
|
-
items: l2Items
|
|
94
|
-
}
|
|
95
|
-
}, null, 2);
|
|
96
|
-
if (res.headersSent) return;
|
|
97
|
-
res.statusCode = 200;
|
|
98
|
-
res.setHeader("content-type", "application/json; charset=utf-8");
|
|
99
|
-
res.setHeader("cache-control", "no-store");
|
|
100
|
-
res.end(body);
|
|
101
|
-
} catch (err) {
|
|
102
|
-
if (res.headersSent) return;
|
|
103
|
-
res.statusCode = 500;
|
|
104
|
-
res.setHeader("content-type", "application/json; charset=utf-8");
|
|
105
|
-
res.end(JSON.stringify({ error: err.message }));
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
//#endregion
|
|
110
|
-
exports.createCacheInspectorMiddleware = createCacheInspectorMiddleware;
|
|
111
|
-
|
|
112
|
-
//# sourceMappingURL=createCacheInspectorMiddleware-DvRhF_-D.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"createCacheInspectorMiddleware-DvRhF_-D.cjs","names":[],"sources":["../src/plugin/createCacheInspectorMiddleware.ts"],"sourcesContent":["/**\n * ISR cache inventory 端点 —— 暴露当前 L1 缓存条目元数据 + 最近 invalidate 时间。\n *\n * 用途:回答 “这一刻,哪些页面的缓存是 stale?某 path/tag 上次什么时候被 revalidate?”\n * 这类 *库存视角* 问题。流量视角(按路由 cache 状态分布)走 Prometheus\n * `isr_http_requests_total{cache=\"STALE\",route=...}`;本端点是补充而非替代。\n *\n * 边界(明确写在这里防止滑坡):\n * ✅ 只读 L1(in-process LRU),永不 SCAN Redis(SCAN 阻塞,量大不该走 engine)\n * ✅ 只返回元数据:key / 时间戳 / size / tags;body 一字节都不返回\n * ✅ 只给 JSON,不给 HTML 浏览器(漂亮 UI 走业务自建或单独包)\n * ✅ 鉴权复用 opsConfig.authToken,不引入 SSO/RBAC(那是业务网关的事)\n * ✅ 端点路径 /__isr/cache/inventory 已在 isrCacheMiddleware.isBypassPath 列表,\n * 自身永远不会被 ISR 缓存\n *\n * 查询参数:\n * ?status=fresh|stale|expired|all 过滤 L1 条目状态(默认 all)\n * ?limit=N L1 条目数上限(默认 100,硬上限 1000)\n * ?l2=true|false 是否包含 L2(Redis)SCAN 视图(默认 true,\n * hybrid 模式才有内容;memory 模式恒为 [] 不发请求)\n * ?l2Limit=N L2 SCAN 条目数上限(默认 200,硬上限 500,防 SCAN 流量过大)\n *\n * 响应示例(hybrid 模式):\n * {\n * \"now\": 1715760000000,\n * \"backend\": \"hybrid\",\n * \"size\": 234, // L1 条目数\n * \"max\": 1000, // L1 容量\n * \"filtered\": 12, // L1 过滤后条目数\n * \"entries\": [...], // L1 条目(含 fresh/stale/expired 状态)\n * \"invalidations\": [...], // 最近 invalidate 时间\n * \"l2\": {\n * \"scanned\": 234,\n * \"items\": [\n * { \"key\": \"GET:/books/1\", \"sizeBytes\": 12450, \"ttlSecondsRemaining\": 1800, \"onlyInL2\": false },\n * { \"key\": \"GET:/cold-page\", \"sizeBytes\": 800, \"ttlSecondsRemaining\": 7200, \"onlyInL2\": true }\n * ]\n * }\n * }\n */\nimport type { IncomingMessage, ServerResponse } from 'node:http';\nimport type { Connect } from 'vite';\nimport express from 'express';\nimport type { IsrCacheHandler, IsrCacheInspectionEntry } from './isrCacheMiddleware';\nimport type { ResolvedOpsConfig } from '../server/opsConfig';\nimport { createOpsAuthMiddleware, getOpsRequestLimiter } from '../server/opsConfig';\n\n/** Inventory 端点路径常量 —— 与 isrCacheMiddleware.isBypassPath 中的 /__isr 前缀对齐 */\nexport const CACHE_INVENTORY_PATH = '/__isr/cache/inventory';\n\n/** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */\nconst HARD_LIMIT = 1000;\n/** L1 默认 limit */\nconst DEFAULT_LIMIT = 100;\n/** L2 SCAN 单次返回硬上限 —— 比 L1 更严,因为每个 entry 一次 STRLEN+TTL 是 2 个 Redis 命令 */\nconst L2_HARD_LIMIT = 500;\n/** L2 默认 limit */\nconst L2_DEFAULT_LIMIT = 200;\n\ntype StatusFilter = 'fresh' | 'stale' | 'expired' | 'all';\n\nfunction parseStatusFilter(raw: string | null): StatusFilter {\n if (raw === 'fresh' || raw === 'stale' || raw === 'expired' || raw === 'all') return raw;\n return 'all';\n}\n\nfunction parseLimit(raw: string | null): number {\n if (!raw) return DEFAULT_LIMIT;\n const n = parseInt(raw, 10);\n if (!Number.isFinite(n) || n <= 0) return DEFAULT_LIMIT;\n return Math.min(n, HARD_LIMIT);\n}\n\nfunction parseL2Limit(raw: string | null): number {\n if (!raw) return L2_DEFAULT_LIMIT;\n const n = parseInt(raw, 10);\n if (!Number.isFinite(n) || n <= 0) return L2_DEFAULT_LIMIT;\n return Math.min(n, L2_HARD_LIMIT);\n}\n\nfunction parseBoolFlag(raw: string | null, defaultValue: boolean): boolean {\n if (raw === null) return defaultValue;\n const v = raw.toLowerCase();\n if (v === 'true' || v === '1' || v === 'yes') return true;\n if (v === 'false' || v === '0' || v === 'no') return false;\n return defaultValue;\n}\n\n/**\n * 创建 inventory 中间件。\n *\n * 必须在 ISR cache middleware 之前挂(路径已在 isBypassPath 但提前挂可以避开\n * cache handler 内部 metric 记录这次 admin 请求)。\n *\n * @param handler ISR cache handler,必须支持 getCacheInspection()\n * @param opsConfig resolveOpsConfig 的输出 —— inventory.enabled 控制端点是否生效\n */\nexport function createCacheInspectorMiddleware(\n handler: IsrCacheHandler,\n opsConfig: ResolvedOpsConfig\n): Connect.NextHandleFunction {\n // disabled 时直接返回 no-op,运行期不引入任何分支开销\n if (!opsConfig.inventory.enabled) {\n return (_req, _res, next) => next();\n }\n\n const auth = createOpsAuthMiddleware('inventory', opsConfig);\n const guarded = express.Router();\n guarded.use(getOpsRequestLimiter(opsConfig));\n guarded.use(auth);\n guarded.use((req, res) => {\n void respond(req, res, handler);\n });\n\n return (req: IncomingMessage, res: ServerResponse, next: Connect.NextFunction) => {\n if (req.method !== 'GET' && req.method !== 'HEAD') {\n next();\n return;\n }\n // 用 URL 解析路径(剥 query string)。req.url 一定有,但形态可能含 query。\n const url = req.url ?? '/';\n const pathOnly = url.split('?')[0];\n if (pathOnly !== CACHE_INVENTORY_PATH) {\n next();\n return;\n }\n\n // Admission precedes both authentication and any Redis inspection, including on Connect.\n guarded(req as express.Request, res as express.Response, next);\n };\n\n async function respond(\n req: IncomingMessage,\n res: ServerResponse,\n h: IsrCacheHandler\n ): Promise<void> {\n try {\n const snapshot = h.getCacheInspection();\n const params = new URLSearchParams((req.url ?? '').split('?')[1] ?? '');\n const statusFilter = parseStatusFilter(params.get('status'));\n const limit = parseLimit(params.get('limit'));\n const includeL2 = parseBoolFlag(params.get('l2'), true);\n const l2Limit = parseL2Limit(params.get('l2Limit'));\n\n const filtered: IsrCacheInspectionEntry[] =\n statusFilter === 'all'\n ? snapshot.entries\n : snapshot.entries.filter(e => e.status === statusFilter);\n\n // 排序:fresh 先返回最新入缓存的;stale/expired 先返回最旧的(最该被关注)。\n // 对于 all:按 ageSeconds 降序(旧的优先),方便排错时一眼看到长期未刷新的条目。\n const sorted = [...filtered].sort((a, b) => b.ageSeconds - a.ageSeconds);\n const limited = sorted.slice(0, limit);\n\n const sortedInvalidations = [...snapshot.invalidations].sort(\n (a, b) => b.lastInvalidatedMs - a.lastInvalidatedMs\n );\n\n // L2 视图(仅 hybrid 模式有内容)—— 异步 SCAN 拉取\n const l2Items =\n includeL2 && snapshot.backend === 'hybrid' ? await h.getL2Inspection(l2Limit) : [];\n\n const body = JSON.stringify(\n {\n now: snapshot.now,\n backend: snapshot.backend,\n size: snapshot.size,\n max: snapshot.max,\n filter: { status: statusFilter, limit, l2: includeL2, l2Limit },\n filtered: filtered.length,\n entries: limited,\n invalidations: sortedInvalidations,\n l2: { scanned: l2Items.length, items: l2Items },\n },\n null,\n 2\n );\n\n if (res.headersSent) return;\n res.statusCode = 200;\n res.setHeader('content-type', 'application/json; charset=utf-8');\n res.setHeader('cache-control', 'no-store');\n res.end(body);\n } catch (err) {\n if (res.headersSent) return;\n res.statusCode = 500;\n res.setHeader('content-type', 'application/json; charset=utf-8');\n res.end(JSON.stringify({ error: (err as Error).message }));\n }\n }\n}\n"],"mappings":"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"}
|