isr-engine 2.6.21 → 3.1.0

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.
Files changed (122) hide show
  1. package/README.md +97 -616
  2. package/dist/Logger-DqBS_3v8.cjs +184 -0
  3. package/dist/Logger-DqBS_3v8.cjs.map +1 -0
  4. package/dist/Logger-bg-doGwZ.js +174 -0
  5. package/dist/Logger-bg-doGwZ.js.map +1 -0
  6. package/dist/abVariantContext-BvAMuhjj.cjs +510 -0
  7. package/dist/abVariantContext-BvAMuhjj.cjs.map +1 -0
  8. package/dist/abVariantContext-Ud3aZ1yk.js +355 -0
  9. package/dist/abVariantContext-Ud3aZ1yk.js.map +1 -0
  10. package/dist/app/createISRApp.d.ts +2 -2
  11. package/dist/cli/cli.cjs +1 -1
  12. package/dist/cli/cli.js +1 -1
  13. package/dist/cli/start.d.ts +1 -1
  14. package/dist/config/loadConfig.d.ts +1 -1
  15. package/dist/config/normalizeEngineConfig.d.ts +1 -1
  16. package/dist/config/normalizeEngineConfig.d.ts.map +1 -1
  17. package/dist/config/resolveRuntimeRedis.d.ts +1 -1
  18. package/dist/{createCacheInspectorMiddleware-DYJ2WGYu.js → createCacheInspectorMiddleware-Bjku5v62.js} +10 -5
  19. package/dist/createCacheInspectorMiddleware-Bjku5v62.js.map +1 -0
  20. package/dist/{createCacheInspectorMiddleware-Byzz8ZlU.cjs → createCacheInspectorMiddleware-DG1_VLBS.cjs} +12 -5
  21. package/dist/createCacheInspectorMiddleware-DG1_VLBS.cjs.map +1 -0
  22. package/dist/{createISRApp-CylUYiIU.js → createISRApp-DYVU8ydT.js} +632 -100
  23. package/dist/createISRApp-DYVU8ydT.js.map +1 -0
  24. package/dist/{createISRApp-C9Bezuit.cjs → createISRApp-HX6X8UNb.cjs} +698 -129
  25. package/dist/createISRApp-HX6X8UNb.cjs.map +1 -0
  26. package/dist/{createImagePlugin-_ntL0DcT.js → createImagePlugin-BZJHOvN9.js} +67 -21
  27. package/dist/createImagePlugin-BZJHOvN9.js.map +1 -0
  28. package/dist/{createImagePlugin-birVNynL.cjs → createImagePlugin-Ca4t_WhM.cjs} +73 -21
  29. package/dist/createImagePlugin-Ca4t_WhM.cjs.map +1 -0
  30. package/dist/defaults/runtime/browserObservability.d.ts.map +1 -1
  31. package/dist/defaults/runtime/defineSiteHooks.cjs +2 -2
  32. package/dist/defaults/runtime/defineSiteHooks.js +2 -2
  33. package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts.map +1 -1
  34. package/dist/{defineSiteHooks-BeVy-qPH.js → defineSiteHooks-CV4tqHvB.js} +11 -5
  35. package/dist/{defineSiteHooks-BeVy-qPH.js.map → defineSiteHooks-CV4tqHvB.js.map} +1 -1
  36. package/dist/{defineSiteHooks-C3v3WLS8.cjs → defineSiteHooks-w2IrF5-D.cjs} +11 -5
  37. package/dist/{defineSiteHooks-C3v3WLS8.cjs.map → defineSiteHooks-w2IrF5-D.cjs.map} +1 -1
  38. package/dist/engine/ISREngine.d.ts +2 -2
  39. package/dist/engine/ISREngine.d.ts.map +1 -1
  40. package/dist/{i18n-CyJIoYJT.cjs → i18n-CS5QhOO0.cjs} +7 -30
  41. package/dist/i18n-CS5QhOO0.cjs.map +1 -0
  42. package/dist/{i18n-Dobe0Wxn.js → i18n-CnXYAgQE.js} +8 -25
  43. package/dist/i18n-CnXYAgQE.js.map +1 -0
  44. package/dist/index.d.ts +3 -3
  45. package/dist/isr/ISRRoutes.d.ts +5 -3
  46. package/dist/isr/ISRRoutes.d.ts.map +1 -1
  47. package/dist/isr-engine.cjs +619 -117
  48. package/dist/isr-engine.cjs.map +1 -1
  49. package/dist/isr-engine.js +609 -107
  50. package/dist/isr-engine.js.map +1 -1
  51. package/dist/logger/Logger.d.ts +6 -2
  52. package/dist/logger/Logger.d.ts.map +1 -1
  53. package/dist/logger/logRecord.d.ts +11 -0
  54. package/dist/logger/logRecord.d.ts.map +1 -0
  55. package/dist/logger/runtimeLogger.d.ts +6 -0
  56. package/dist/logger/runtimeLogger.d.ts.map +1 -0
  57. package/dist/metrics/PromMetrics.d.ts.map +1 -1
  58. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -1
  59. package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -1
  60. package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -1
  61. package/dist/plugin/createFontPlugin.d.ts +1 -1
  62. package/dist/plugin/createFontPlugin.d.ts.map +1 -1
  63. package/dist/plugin/createIsrPlugin.d.ts.map +1 -1
  64. package/dist/plugin/googleFontAssets.d.ts +23 -0
  65. package/dist/plugin/googleFontAssets.d.ts.map +1 -0
  66. package/dist/plugin/isrCacheMiddleware.d.ts +5 -0
  67. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -1
  68. package/dist/plugin/remoteImageSource.d.ts +3 -3
  69. package/dist/plugin/remoteImageSource.d.ts.map +1 -1
  70. package/dist/rsc/ServerActions.d.ts.map +1 -1
  71. package/dist/rsc/cacheTag.d.ts.map +1 -1
  72. package/dist/rsc/index.cjs +8 -9
  73. package/dist/rsc/index.js +2 -3
  74. package/dist/rsc/revalidate.d.ts.map +1 -1
  75. package/dist/rsc/revalidationMetrics.d.ts +6 -0
  76. package/dist/rsc/revalidationMetrics.d.ts.map +1 -0
  77. package/dist/{rsc-lvWPTuVD.js → rsc-BJzB9s8U.js} +4 -6
  78. package/dist/rsc-BJzB9s8U.js.map +1 -0
  79. package/dist/{rsc-H7D_meHu.cjs → rsc-CYT6B6bf.cjs} +5 -7
  80. package/dist/rsc-CYT6B6bf.cjs.map +1 -0
  81. package/dist/server/manager.d.ts +1 -1
  82. package/dist/server/manager.d.ts.map +1 -1
  83. package/dist/server/opsConfig.d.ts +7 -1
  84. package/dist/server/opsConfig.d.ts.map +1 -1
  85. package/dist/server/productionRuntime.d.ts +3 -4
  86. package/dist/server/productionRuntime.d.ts.map +1 -1
  87. package/dist/server/requestLimits.d.ts +36 -0
  88. package/dist/server/requestLimits.d.ts.map +1 -0
  89. package/dist/server/safeRedirect.d.ts +6 -0
  90. package/dist/server/safeRedirect.d.ts.map +1 -0
  91. package/dist/server/types.d.ts +1 -1
  92. package/dist/ssg/spider.d.ts.map +1 -1
  93. package/dist/types/ISRConfig.d.ts +17 -0
  94. package/dist/types/ISRConfig.d.ts.map +1 -1
  95. package/dist/utils/cookie.d.ts.map +1 -1
  96. package/dist/utils/resolveFetchHandler.d.ts.map +1 -1
  97. package/package.json +30 -32
  98. package/src/defaults/runtime/browserObservability.ts +29 -13
  99. package/src/defaults/runtime/defineServerEntry.tsx +2 -2
  100. package/src/defaults/runtime/defineSiteHooks.ts +12 -7
  101. package/src/defaults/runtime/dev-style-resource-dispatcher.server.ts +2 -3
  102. package/src/types/ISRConfig.ts +21 -7
  103. package/src/utils/cookie.ts +5 -3
  104. package/src/utils/resolveFetchHandler.ts +1 -3
  105. package/dist/RequestContext-BVQ-rOmV.js +0 -58
  106. package/dist/RequestContext-BVQ-rOmV.js.map +0 -1
  107. package/dist/RequestContext-DgGEAxcW.cjs +0 -105
  108. package/dist/RequestContext-DgGEAxcW.cjs.map +0 -1
  109. package/dist/abVariantContext-CWCdRSdG.js +0 -549
  110. package/dist/abVariantContext-CWCdRSdG.js.map +0 -1
  111. package/dist/abVariantContext-Cqp-uxtd.cjs +0 -678
  112. package/dist/abVariantContext-Cqp-uxtd.cjs.map +0 -1
  113. package/dist/createCacheInspectorMiddleware-Byzz8ZlU.cjs.map +0 -1
  114. package/dist/createCacheInspectorMiddleware-DYJ2WGYu.js.map +0 -1
  115. package/dist/createISRApp-C9Bezuit.cjs.map +0 -1
  116. package/dist/createISRApp-CylUYiIU.js.map +0 -1
  117. package/dist/createImagePlugin-_ntL0DcT.js.map +0 -1
  118. package/dist/createImagePlugin-birVNynL.cjs.map +0 -1
  119. package/dist/i18n-CyJIoYJT.cjs.map +0 -1
  120. package/dist/i18n-Dobe0Wxn.js.map +0 -1
  121. package/dist/rsc-H7D_meHu.cjs.map +0 -1
  122. package/dist/rsc-lvWPTuVD.js.map +0 -1
@@ -1,21 +1,24 @@
1
1
  const require_rolldown_runtime = require("./rolldown-runtime-DakpK96I.cjs");
2
- const require_RequestContext = require("./RequestContext-DgGEAxcW.cjs");
3
- const require_abVariantContext = require("./abVariantContext-Cqp-uxtd.cjs");
4
- const require_i18n = require("./i18n-CyJIoYJT.cjs");
2
+ const require_abVariantContext = require("./abVariantContext-BvAMuhjj.cjs");
3
+ const require_Logger = require("./Logger-DqBS_3v8.cjs");
4
+ const require_i18n = require("./i18n-CS5QhOO0.cjs");
5
5
  let node_fs = require("node:fs");
6
6
  node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
7
7
  let node_path = require("node:path");
8
8
  node_path = require_rolldown_runtime.__toESM(node_path, 1);
9
- let fs = require("fs");
10
- fs = require_rolldown_runtime.__toESM(fs, 1);
9
+ let express = require("express");
10
+ express = require_rolldown_runtime.__toESM(express, 1);
11
+ let express_rate_limit = require("express-rate-limit");
12
+ let ipaddr_js = require("ipaddr.js");
13
+ ipaddr_js = require_rolldown_runtime.__toESM(ipaddr_js, 1);
11
14
  let path = require("path");
12
15
  path = require_rolldown_runtime.__toESM(path, 1);
16
+ let fs = require("fs");
17
+ fs = require_rolldown_runtime.__toESM(fs, 1);
13
18
  let fs_promises = require("fs/promises");
14
19
  fs_promises = require_rolldown_runtime.__toESM(fs_promises, 1);
15
20
  let typescript = require("typescript");
16
21
  typescript = require_rolldown_runtime.__toESM(typescript, 1);
17
- let express = require("express");
18
- express = require_rolldown_runtime.__toESM(express, 1);
19
22
  let node_net = require("node:net");
20
23
  node_net = require_rolldown_runtime.__toESM(node_net, 1);
21
24
  let vite = require("vite");
@@ -33,6 +36,7 @@ node_os = require_rolldown_runtime.__toESM(node_os, 1);
33
36
  let node_http = require("node:http");
34
37
  node_http = require_rolldown_runtime.__toESM(node_http, 1);
35
38
  let lru_cache = require("lru-cache");
39
+ let prom_client = require("prom-client");
36
40
  let url = require("url");
37
41
  let crypto = require("crypto");
38
42
  let esbuild = require("esbuild");
@@ -129,6 +133,187 @@ function resolveCacheDurations(defaultTtl, overrides = {}, label = "route") {
129
133
  };
130
134
  }
131
135
  //#endregion
136
+ //#region src/server/requestLimits.ts
137
+ /** Per-process admission budgets for engine-owned work, not page-cache hits or application APIs. */
138
+ var DEFAULT_REQUEST_LIMITS = {
139
+ ops: {
140
+ windowMs: 6e4,
141
+ maxRequests: 120,
142
+ globalMaxRequests: 1200,
143
+ maxClients: 1e3
144
+ },
145
+ staticHtml: {
146
+ windowMs: 6e4,
147
+ maxRequests: 600,
148
+ globalMaxRequests: 12e3,
149
+ maxClients: 1e4
150
+ },
151
+ seo: {
152
+ windowMs: 6e4,
153
+ maxRequests: 120,
154
+ globalMaxRequests: 1200,
155
+ maxClients: 1e3
156
+ }
157
+ };
158
+ function resolveRequestLimitPolicy(category, input) {
159
+ if (input !== void 0 && (!input || typeof input !== "object" || Array.isArray(input))) throw new TypeError(`server.requestLimits.${category} must be a positive admission policy`);
160
+ const defaults = DEFAULT_REQUEST_LIMITS[category];
161
+ const result = { ...defaults };
162
+ for (const field of [
163
+ "windowMs",
164
+ "maxRequests",
165
+ "globalMaxRequests",
166
+ "maxClients"
167
+ ]) {
168
+ const value = input?.[field] === void 0 ? defaults[field] : input[field];
169
+ if (!Number.isSafeInteger(value) || value <= 0 || value >= Number.MAX_SAFE_INTEGER) throw new TypeError(`server.requestLimits.${category}.${field} must be a positive safe integer`);
170
+ result[field] = value;
171
+ }
172
+ if (result.windowMs > 2147483647) throw new RangeError(`server.requestLimits.${category}.windowMs must be at most 2147483647`);
173
+ return result;
174
+ }
175
+ function validateRequestLimits(input) {
176
+ if (input !== void 0 && (!input || typeof input !== "object" || Array.isArray(input))) throw new TypeError("server.requestLimits must be an object");
177
+ for (const category of [
178
+ "ops",
179
+ "staticHtml",
180
+ "seo"
181
+ ]) resolveRequestLimitPolicy(category, input?.[category]);
182
+ }
183
+ /**
184
+ * A timer-free express-rate-limit Store. Live quotas are never evicted to admit a new IP.
185
+ * A full store denies new clients until expiry; reclamation scans are bounded to once/second.
186
+ */
187
+ var BoundedRateLimitStore = class {
188
+ windowMs;
189
+ maxClients;
190
+ maxRequests;
191
+ localKeys = true;
192
+ clients = /* @__PURE__ */ new Map();
193
+ nextSweepAt = 0;
194
+ constructor(windowMs, maxClients, maxRequests) {
195
+ this.windowMs = windowMs;
196
+ this.maxClients = maxClients;
197
+ this.maxRequests = maxRequests;
198
+ }
199
+ get size() {
200
+ return this.clients.size;
201
+ }
202
+ get(key) {
203
+ const counter = this.clients.get(key);
204
+ if (!counter || counter.expiresAt <= Date.now()) return void 0;
205
+ return {
206
+ totalHits: counter.totalHits,
207
+ resetTime: new Date(counter.expiresAt)
208
+ };
209
+ }
210
+ increment(key) {
211
+ const now = Date.now();
212
+ if (now >= this.nextSweepAt) {
213
+ for (const [client, counter] of this.clients) if (counter.expiresAt <= now) this.clients.delete(client);
214
+ this.nextSweepAt = now + Math.min(this.windowMs, 1e3);
215
+ }
216
+ let counter = this.clients.get(key);
217
+ if (counter && counter.expiresAt <= now) {
218
+ this.clients.delete(key);
219
+ counter = void 0;
220
+ }
221
+ if (!counter) {
222
+ if (this.clients.size >= this.maxClients) {
223
+ const firstExpiry = this.clients.values().next().value?.expiresAt ?? this.nextSweepAt;
224
+ return {
225
+ totalHits: this.maxRequests + 1,
226
+ resetTime: new Date(Math.max(firstExpiry, this.nextSweepAt))
227
+ };
228
+ }
229
+ counter = {
230
+ totalHits: 0,
231
+ expiresAt: now + this.windowMs
232
+ };
233
+ this.clients.set(key, counter);
234
+ }
235
+ counter.totalHits = Math.min(counter.totalHits + 1, this.maxRequests + 1);
236
+ return {
237
+ totalHits: counter.totalHits,
238
+ resetTime: new Date(counter.expiresAt)
239
+ };
240
+ }
241
+ decrement(key) {
242
+ const counter = this.clients.get(key);
243
+ if (counter) counter.totalHits = Math.max(0, counter.totalHits - 1);
244
+ }
245
+ resetKey(key) {
246
+ this.clients.delete(key);
247
+ }
248
+ resetAll() {
249
+ this.clients.clear();
250
+ this.nextSweepAt = 0;
251
+ }
252
+ };
253
+ /** Connect has no req.ip. An unrestricted trust-proxy setting is never an IP identity boundary. */
254
+ function requestClientKey(req) {
255
+ const selected = req.app?.get("trust proxy") === true ? req.socket?.remoteAddress : req.ip ?? req.socket?.remoteAddress;
256
+ if (!selected || !ipaddr_js.default.isValid(selected)) return "unknown-client";
257
+ return (0, express_rate_limit.ipKeyGenerator)(ipaddr_js.default.process(selected).toString(), 56);
258
+ }
259
+ function createRequestLimiter(category, input) {
260
+ const policy = resolveRequestLimitPolicy(category, input);
261
+ const router = express.default.Router();
262
+ const common = {
263
+ windowMs: policy.windowMs,
264
+ standardHeaders: false,
265
+ legacyHeaders: false,
266
+ requestPropertyName: "isrRequestLimit",
267
+ handler: (req, res) => {
268
+ const remaining = (req.isrRequestLimit?.resetTime?.getTime() ?? Date.now() + policy.windowMs) - Date.now();
269
+ res.statusCode = 429;
270
+ res.setHeader("Retry-After", String(Math.max(1, Math.ceil(remaining / 1e3))));
271
+ res.setHeader("Cache-Control", "no-store");
272
+ res.setHeader("Content-Type", "application/json; charset=utf-8");
273
+ res.end("{\"error\":\"Too many requests\"}");
274
+ }
275
+ };
276
+ router.use((0, express_rate_limit.rateLimit)({
277
+ ...common,
278
+ limit: policy.globalMaxRequests,
279
+ store: new BoundedRateLimitStore(policy.windowMs, 1, policy.globalMaxRequests),
280
+ keyGenerator: () => "origin"
281
+ }));
282
+ router.use((0, express_rate_limit.rateLimit)({
283
+ ...common,
284
+ limit: policy.maxRequests,
285
+ store: new BoundedRateLimitStore(policy.windowMs, policy.maxClients, policy.maxRequests),
286
+ keyGenerator: requestClientKey
287
+ }));
288
+ return router;
289
+ }
290
+ /** Bridge an admission middleware into async work without treating its ended 429 as next(). */
291
+ function admitRequest(limiter, req, res) {
292
+ if (res.writableEnded || res.destroyed) return Promise.resolve(false);
293
+ return new Promise((resolve, reject) => {
294
+ const cleanup = () => {
295
+ res.removeListener("finish", onEnd);
296
+ res.removeListener("close", onEnd);
297
+ };
298
+ const onEnd = () => {
299
+ cleanup();
300
+ resolve(false);
301
+ };
302
+ res.once("finish", onEnd);
303
+ res.once("close", onEnd);
304
+ try {
305
+ limiter(req, res, (error) => {
306
+ cleanup();
307
+ if (error) reject(error);
308
+ else resolve(!res.writableEnded && !res.destroyed);
309
+ });
310
+ } catch (error) {
311
+ cleanup();
312
+ reject(error);
313
+ }
314
+ });
315
+ }
316
+ //#endregion
132
317
  //#region src/config/normalizeEngineConfig.ts
133
318
  /**
134
319
  * Engine-owned config normalization.
@@ -167,6 +352,7 @@ function normalizeEngineConfig(config) {
167
352
  "invalidationChannel"
168
353
  ], "runtime.redis");
169
354
  if (!isRecord(config.server)) throw new Error("ssr.config.ts 必须显式声明 server 对象");
355
+ validateRequestLimits(config.server.requestLimits);
170
356
  if (!isRecord(config.ssg)) throw new Error("ssr.config.ts 必须显式声明 ssg 对象");
171
357
  if (!Array.isArray(config.ssg.routes) && typeof config.ssg.routes !== "function") throw new TypeError("ssr.config.ts ssg.routes must be an array or a route discovery function");
172
358
  if (Array.isArray(config.ssg.routes)) assertDistinctHtmlRouteIdentities(config.ssg.routes);
@@ -203,7 +389,7 @@ function requireOwnProperties(value, keys, label) {
203
389
  }
204
390
  //#endregion
205
391
  //#region src/utils/CacheCleanup.ts
206
- var logger$9 = require_abVariantContext.Logger.getInstance();
392
+ var logger$9 = require_Logger.Logger.getInstance();
207
393
  /**
208
394
  * 缓存清理工具类
209
395
  * 负责在开发环境启动时清理统一的缓存目录
@@ -1048,7 +1234,7 @@ async function resolveHmrPort(preferredPort, host) {
1048
1234
  * 创建 Vite 开发服务器
1049
1235
  */
1050
1236
  async function createViteDevServer() {
1051
- const logger = require_abVariantContext.Logger.getInstance();
1237
+ const logger = require_Logger.Logger.getInstance();
1052
1238
  if (viteServer) return viteServer;
1053
1239
  const loadResult = await (0, vite.loadConfigFromFile)({
1054
1240
  command: "serve",
@@ -1338,7 +1524,7 @@ function resolveFetchHandler(module) {
1338
1524
  }
1339
1525
  var package_default = {
1340
1526
  name: "isr-engine",
1341
- version: "2.6.21",
1527
+ version: "3.1.0",
1342
1528
  description: "ISR/SSG/Fallback rendering orchestration on Vite + React 19 RSC.",
1343
1529
  license: "UNLICENSED",
1344
1530
  repository: {
@@ -1442,37 +1628,38 @@ var package_default = {
1442
1628
  "test:workers": "tsc --noEmit -p scripts/fixtures/tsconfig.json && node scripts/check-workers-runtime.mjs",
1443
1629
  "test:release": "node scripts/check-release.mjs"
1444
1630
  },
1445
- engines: { "node": ">=22.21.1" },
1631
+ engines: { "node": "24.15.0" },
1446
1632
  packageManager: "pnpm@9.15.9",
1447
1633
  dependencies: {
1448
- "@vitejs/plugin-rsc": "0.5.34",
1449
- "chalk": "^5.3.0",
1634
+ "@vitejs/plugin-rsc": "0.5.39",
1635
+ "chalk": "^6.0.1",
1450
1636
  "commander": "^12.1.0",
1451
1637
  "compression": "^1.8.2",
1452
1638
  "css-tree": "^3.2.1",
1453
1639
  "esbuild": "^0.28.2",
1454
1640
  "express": "^5.3.0",
1641
+ "express-rate-limit": "8.7.5",
1455
1642
  "helmet": "^7.1.0",
1456
1643
  "ipaddr.js": "^2.5.0",
1457
1644
  "lru-cache": "^10.4.3",
1458
- "ora": "^8.1.0",
1645
+ "ora": "^10.0.0",
1459
1646
  "parse5": "^8.0.1",
1647
+ "pino": "10.4.0",
1460
1648
  "prom-client": "^15.1.3",
1649
+ "rsc-html-stream": "0.0.7",
1461
1650
  "sharp": "^0.35.5",
1462
- "sitemap": "^8.0.0",
1463
- "typescript": "^5.6.2"
1651
+ "sitemap": "^10.0.0",
1652
+ "typescript": "^6.0.3"
1464
1653
  },
1465
1654
  peerDependencies: {
1466
- "react": "19.3.0-canary-bd6ea412-20260824",
1467
- "react-dom": "19.3.0-canary-bd6ea412-20260824",
1468
- "react-server-dom-webpack": "19.3.0-canary-bd6ea412-20260824",
1469
- "rsc-html-stream": "^0.0.7",
1655
+ "react": "19.3.1",
1656
+ "react-dom": "19.3.1",
1470
1657
  "vite": "8.1.6"
1471
1658
  },
1472
- optionalDependencies: { "ioredis": "^5.4.1" },
1659
+ optionalDependencies: { "ioredis": "^5.11.1" },
1473
1660
  devDependencies: {
1474
- "@eslint/js": "^9.15.0",
1475
- "@playwright/test": "^1.62.1",
1661
+ "@eslint/js": "^9.39.5",
1662
+ "@playwright/test": "1.65.1",
1476
1663
  "@semantic-release/commit-analyzer": "13.0.1",
1477
1664
  "@semantic-release/exec": "7.1.0",
1478
1665
  "@semantic-release/npm": "13.2.0",
@@ -1480,34 +1667,31 @@ var package_default = {
1480
1667
  "@types/compression": "^1.7.5",
1481
1668
  "@types/css-tree": "^3.2.0",
1482
1669
  "@types/express": "^5.0.0",
1483
- "@types/ioredis-mock": "^8.2.5",
1484
- "@types/node": "^22.7.4",
1670
+ "@types/ioredis-mock": "^8.2.8",
1671
+ "@types/node": "24.19.2",
1485
1672
  "@types/react": "^19.2.15",
1486
1673
  "@types/react-dom": "^19.0.0",
1487
- "@typescript-eslint/eslint-plugin": "^8.72.1",
1488
- "@typescript-eslint/parser": "^8.72.1",
1674
+ "@typescript-eslint/eslint-plugin": "8.72.2",
1675
+ "@typescript-eslint/parser": "8.72.2",
1489
1676
  "@vitest/coverage-v8": "^4.1.12",
1490
- "autocannon": "^8.0.0",
1491
1677
  "eslint": "^9.15.0",
1492
- "eslint-config-prettier": "^9.1.0",
1493
- "eslint-plugin-prettier": "^5.5.6",
1678
+ "eslint-config-prettier": "^10.1.8",
1679
+ "eslint-plugin-prettier": "^5.5.7",
1494
1680
  "eslint-plugin-react": "^7.37.2",
1495
- "eslint-plugin-react-hooks": "^5.0.0",
1681
+ "eslint-plugin-react-hooks": "^7.1.1",
1496
1682
  "globals": "^15.9.0",
1497
1683
  "happy-dom": "^21.0.4",
1498
1684
  "husky": "^9.1.7",
1499
1685
  "ioredis-mock": "^8.9.0",
1500
- "jsdom": "^29.1.1",
1501
1686
  "miniflare": "4.20260730.0",
1502
- "prettier": "^3.3.3",
1503
- "react": "19.3.0-canary-bd6ea412-20260824",
1504
- "react-dom": "19.3.0-canary-bd6ea412-20260824",
1505
- "react-server-dom-webpack": "19.3.0-canary-bd6ea412-20260824",
1687
+ "prettier": "^3.10.1",
1688
+ "react": "19.3.1",
1689
+ "react-dom": "19.3.1",
1506
1690
  "rimraf": "^6.1.4",
1507
- "rsc-html-stream": "^0.0.7",
1508
- "sass-embedded": "^1.79.4",
1509
- "semantic-release": "24.2.9",
1510
- "tsc-alias": "^1.8.17",
1691
+ "sass-embedded": "^1.108.2",
1692
+ "semantic-release": "25.0.9",
1693
+ "tsc-alias": "^1.9.10",
1694
+ "undici": "8.12.4",
1511
1695
  "vite": "8.1.6",
1512
1696
  "vitest": "^4.1.12"
1513
1697
  },
@@ -1523,7 +1707,7 @@ var package_default = {
1523
1707
  "undici@7": "7.30.2",
1524
1708
  "js-yaml@4": "4.3.2",
1525
1709
  "form-data@4": "4.0.6",
1526
- "@typescript-eslint/typescript-estree@8.72.1>minimatch": "11.0.5"
1710
+ "@typescript-eslint/typescript-estree>minimatch": "11.0.5"
1527
1711
  } }
1528
1712
  };
1529
1713
  //#endregion
@@ -1538,7 +1722,7 @@ var package_default = {
1538
1722
  var DEFAULT_PORT = 3e3;
1539
1723
  //#endregion
1540
1724
  //#region src/logger/index.ts
1541
- var logger$8 = require_abVariantContext.Logger.getInstance({
1725
+ var logger$8 = require_Logger.Logger.getInstance({
1542
1726
  verbose: true,
1543
1727
  logFile: "./logs/isr-engine.log"
1544
1728
  });
@@ -1573,7 +1757,7 @@ var logger$8 = require_abVariantContext.Logger.getInstance({
1573
1757
  * —— 首次请求不经过 RSC handler,不触发 Flight 流渲染,也就不进 ISR 缓存(也不需要)
1574
1758
  * 对于"变更低频 + SEO 强依赖"的页面(About / 条款 / Landing),SSG 是首选
1575
1759
  */
1576
- var logger$7 = require_abVariantContext.Logger.getInstance();
1760
+ var logger$7 = require_Logger.Logger.getInstance();
1577
1761
  /**
1578
1762
  * CPU-aware 并发默认值。
1579
1763
  * RSC 渲染是 CPU-bound(runs SSR + Flight encode),开太满会让 GC 抖。
@@ -2330,6 +2514,207 @@ function createHybridCacheStore(opts) {
2330
2514
  };
2331
2515
  }
2332
2516
  //#endregion
2517
+ //#region src/metrics/PromMetrics.ts
2518
+ /**
2519
+ * PromMetrics —— prom-client 包装,导出 Prometheus 文本格式
2520
+ *
2521
+ * 设计:
2522
+ * - prom-client 是 Node 生态的事实标准(Grafana / Datadog / Prometheus 直接抓取)
2523
+ * - 单 Registry,避免污染全局;用户业务可拿 `promRegistry` 自行注册自家 metric
2524
+ * - 响应时间用 Histogram(带桶),不是平均值 —— 才能正确算 P95/P99
2525
+ * - 默认采集 process_*(CPU / RSS / event-loop lag)—— 一行 collectDefaultMetrics
2526
+ */
2527
+ var PromMetrics_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
2528
+ cacheEntriesGauge: () => cacheEntriesGauge,
2529
+ cacheHitsTotal: () => cacheHitsTotal,
2530
+ cacheRevalidatingGauge: () => cacheRevalidatingGauge,
2531
+ createPrometheusMetricsMiddleware: () => createPrometheusMetricsMiddleware,
2532
+ httpRequestDurationSeconds: () => httpRequestDurationSeconds,
2533
+ httpRequestsTotal: () => httpRequestsTotal,
2534
+ invalidatorFailuresTotal: () => invalidatorFailuresTotal,
2535
+ invalidatorRunsTotal: () => invalidatorRunsTotal,
2536
+ l2ReadTimeoutsTotal: () => l2ReadTimeoutsTotal,
2537
+ normalizeRoute: () => normalizeRoute,
2538
+ promRegistry: () => promRegistry,
2539
+ recordHttpRequest: () => recordHttpRequest
2540
+ });
2541
+ var promRegistry = new prom_client.Registry();
2542
+ (0, prom_client.collectDefaultMetrics)({
2543
+ register: promRegistry,
2544
+ prefix: "isr_"
2545
+ });
2546
+ var httpRequestsTotal = new prom_client.Counter({
2547
+ name: "isr_http_requests_total",
2548
+ help: "Total ISR HTTP requests",
2549
+ labelNames: [
2550
+ "method",
2551
+ "route",
2552
+ "status",
2553
+ "mode",
2554
+ "cache"
2555
+ ],
2556
+ registers: [promRegistry]
2557
+ });
2558
+ var httpRequestDurationSeconds = new prom_client.Histogram({
2559
+ name: "isr_http_request_duration_seconds",
2560
+ help: "ISR HTTP request duration",
2561
+ labelNames: [
2562
+ "method",
2563
+ "route",
2564
+ "mode",
2565
+ "cache"
2566
+ ],
2567
+ buckets: [
2568
+ .001,
2569
+ .005,
2570
+ .01,
2571
+ .025,
2572
+ .05,
2573
+ .1,
2574
+ .25,
2575
+ .5,
2576
+ 1,
2577
+ 2.5,
2578
+ 5
2579
+ ],
2580
+ registers: [promRegistry]
2581
+ });
2582
+ var cacheEntriesGauge = new prom_client.Gauge({
2583
+ name: "isr_cache_entries",
2584
+ help: "Current ISR cache entries (L1 LRU size)",
2585
+ labelNames: ["backend"],
2586
+ registers: [promRegistry]
2587
+ });
2588
+ var cacheRevalidatingGauge = new prom_client.Gauge({
2589
+ name: "isr_cache_revalidating_inflight",
2590
+ help: "Number of in-flight background revalidations",
2591
+ registers: [promRegistry]
2592
+ });
2593
+ var cacheHitsTotal = new prom_client.Counter({
2594
+ name: "isr_cache_hits_total",
2595
+ help: "ISR cache hits",
2596
+ labelNames: ["status"],
2597
+ registers: [promRegistry]
2598
+ });
2599
+ var invalidatorRunsTotal = new prom_client.Counter({
2600
+ name: "isr_invalidator_runs_total",
2601
+ help: "Total revalidate dispatches (one increment per revalidatePath/Tag call with ≥1 invalidator)",
2602
+ labelNames: ["kind", "target"],
2603
+ registers: [promRegistry]
2604
+ });
2605
+ var invalidatorFailuresTotal = new prom_client.Counter({
2606
+ name: "isr_invalidator_failures_total",
2607
+ help: "Per-invalidator failures during revalidate dispatch (one increment per failing invalidator)",
2608
+ labelNames: ["kind", "target"],
2609
+ registers: [promRegistry]
2610
+ });
2611
+ var l2ReadTimeoutsTotal = new prom_client.Counter({
2612
+ name: "isr_l2_read_timeouts_total",
2613
+ help: "L2 cache async read timeouts (raceWithTimeout fired before underlying promise resolved)",
2614
+ registers: [promRegistry]
2615
+ });
2616
+ /**
2617
+ * 路由归一化 —— 防 Prometheus label 基数爆炸。
2618
+ *
2619
+ * 动态段(id / uuid / hex / 长 hash)直接作为 label 值会让时间序列数爆炸
2620
+ * (每个 /books/123 都是新序列),Prometheus 存储成本线性暴涨、查询变慢。
2621
+ *
2622
+ * 规则:
2623
+ * - 纯数字段(1 ~ 20 位) → `:id`
2624
+ * - UUID v1-v5 → `:uuid`
2625
+ * - 长 hex(≥16 字符全 hex)→ `:hash`
2626
+ * - base64url/大小写混合长串(≥24 字符,含数字和字母)→ `:hash`
2627
+ *
2628
+ * 命中任意规则即替换;其他保留原样(`/books` `/about` 保留)。
2629
+ *
2630
+ * 可用 `addRouteNormalizeRule(pattern, replacement)` 扩展业务特有规则。
2631
+ */
2632
+ var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
2633
+ var LONG_HEX_RE = /^[0-9a-f]{16,}$/i;
2634
+ var OPAQUE_ID_RE = /^[A-Za-z0-9_-]{24,}$/;
2635
+ var PURE_DIGIT_RE = /^\d{1,20}$/;
2636
+ var customRules = [];
2637
+ function normalizeRoute(route) {
2638
+ if (!route || route === "/") return "/";
2639
+ const segments = route.split("/");
2640
+ for (let i = 0; i < segments.length; i++) {
2641
+ const seg = segments[i];
2642
+ if (!seg) continue;
2643
+ let replaced = null;
2644
+ for (const rule of customRules) {
2645
+ replaced = rule(seg);
2646
+ if (replaced) break;
2647
+ }
2648
+ if (replaced) {
2649
+ segments[i] = replaced;
2650
+ continue;
2651
+ }
2652
+ if (PURE_DIGIT_RE.test(seg)) segments[i] = ":id";
2653
+ else if (UUID_RE.test(seg)) segments[i] = ":uuid";
2654
+ else if (LONG_HEX_RE.test(seg)) segments[i] = ":hash";
2655
+ else if (OPAQUE_ID_RE.test(seg)) segments[i] = ":hash";
2656
+ }
2657
+ return segments.join("/");
2658
+ }
2659
+ require_abVariantContext.setRevalidationMetricRecorder((event, kind, target) => {
2660
+ (event === "run" ? invalidatorRunsTotal : invalidatorFailuresTotal).inc({
2661
+ kind,
2662
+ target: kind === "path" ? normalizeRoute(target) : target
2663
+ });
2664
+ });
2665
+ /** 一行调用更新所有计数 —— 给 isrCacheMiddleware / 中间件用 */
2666
+ function recordHttpRequest(opts) {
2667
+ const route = normalizeRoute(opts.route);
2668
+ httpRequestsTotal.inc({
2669
+ method: opts.method,
2670
+ route,
2671
+ status: String(opts.status),
2672
+ mode: opts.mode,
2673
+ cache: opts.cache
2674
+ });
2675
+ httpRequestDurationSeconds.observe({
2676
+ method: opts.method,
2677
+ route,
2678
+ mode: opts.mode,
2679
+ cache: opts.cache
2680
+ }, opts.durationMs / 1e3);
2681
+ if (opts.cache) cacheHitsTotal.inc({ status: opts.cache });
2682
+ }
2683
+ /**
2684
+ * Express / connect 中间件:暴露 /metrics 端点(Prometheus text exposition format)
2685
+ *
2686
+ * 认证:可选 Bearer token —— 未设 token 时保持旧行为(匿名可访问)。
2687
+ * 生产建议:`createPrometheusMetricsMiddleware({ token: process.env.METRICS_TOKEN })`。
2688
+ */
2689
+ function createPrometheusMetricsMiddleware(pathOrOptions = {}) {
2690
+ const options = typeof pathOrOptions === "string" ? { path: pathOrOptions } : pathOrOptions;
2691
+ const path = options.path ?? "/metrics";
2692
+ const token = options.token && options.token !== "" ? options.token : null;
2693
+ const unauthorizedStatus = options.unauthorizedStatus ?? 401;
2694
+ return async function(req, res, next) {
2695
+ if (req.url !== path || req.method !== "GET") return next();
2696
+ if (token) {
2697
+ const authHeader = req.headers?.["authorization"];
2698
+ const raw = Array.isArray(authHeader) ? authHeader[0] : authHeader;
2699
+ if (!(typeof raw === "string" && raw === `Bearer ${token}`)) {
2700
+ res.statusCode = unauthorizedStatus;
2701
+ res.setHeader("WWW-Authenticate", "Bearer realm=\"metrics\"");
2702
+ res.end("Unauthorized");
2703
+ return;
2704
+ }
2705
+ }
2706
+ try {
2707
+ const body = await promRegistry.metrics();
2708
+ res.setHeader("content-type", promRegistry.contentType);
2709
+ res.statusCode = 200;
2710
+ res.end(body);
2711
+ } catch (err) {
2712
+ res.statusCode = 500;
2713
+ res.end(`metrics error: ${err instanceof Error ? err.message : String(err)}`);
2714
+ }
2715
+ };
2716
+ }
2717
+ //#endregion
2333
2718
  //#region src/config/loadConfig.ts
2334
2719
  /**
2335
2720
  * 配置加载工具
@@ -2347,7 +2732,7 @@ var cachedConfig = null;
2347
2732
  */
2348
2733
  async function loadConfig(options = {}) {
2349
2734
  const { forceReload = false, cwd = process.cwd() } = options;
2350
- const logger = require_abVariantContext.Logger.getInstance();
2735
+ const logger = require_Logger.Logger.getInstance();
2351
2736
  if (cachedConfig && !forceReload) return cachedConfig;
2352
2737
  for (const file of CONFIG_FILES) {
2353
2738
  const filePath = path.default.join(cwd, file);
@@ -2414,6 +2799,31 @@ async function resolveImportPath(filePath, options) {
2414
2799
  }
2415
2800
  //#endregion
2416
2801
  //#region src/server/opsConfig.ts
2802
+ var opsConfig_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
2803
+ bindRuntimeOpsConfig: () => bindRuntimeOpsConfig,
2804
+ createOpsAuthMiddleware: () => createOpsAuthMiddleware,
2805
+ getOpsRequestLimiter: () => getOpsRequestLimiter,
2806
+ getRuntimeOpsConfig: () => getRuntimeOpsConfig,
2807
+ resolveOpsConfig: () => resolveOpsConfig
2808
+ });
2809
+ var opsLimiters = /* @__PURE__ */ new WeakMap();
2810
+ var runtimeOpsConfigs = /* @__PURE__ */ new WeakMap();
2811
+ /** Carry one resolved policy from the Vite plugin into its owning Express runtime. */
2812
+ function bindRuntimeOpsConfig(owner, resolved) {
2813
+ runtimeOpsConfigs.set(owner, resolved);
2814
+ }
2815
+ function getRuntimeOpsConfig(owner) {
2816
+ return runtimeOpsConfigs.get(owner);
2817
+ }
2818
+ /** Share one ops admission budget across endpoint handlers owned by this runtime. */
2819
+ function getOpsRequestLimiter(resolved) {
2820
+ let limiter = opsLimiters.get(resolved);
2821
+ if (!limiter) {
2822
+ limiter = createRequestLimiter("ops", resolved.requestLimit);
2823
+ opsLimiters.set(resolved, limiter);
2824
+ }
2825
+ return limiter;
2826
+ }
2417
2827
  var OPS_ENDPOINT_PATHS = {
2418
2828
  health: "/health",
2419
2829
  metrics: "/metrics",
@@ -2482,6 +2892,7 @@ function resolveOpsConfig(config, env) {
2482
2892
  const authToken = trimToUndefined(ops?.authToken);
2483
2893
  return {
2484
2894
  authToken,
2895
+ requestLimit: resolveRequestLimitPolicy("ops", config?.server?.requestLimits?.ops),
2485
2896
  tokenHeader: trimToUndefined(ops?.tokenHeader) ?? DEFAULT_TOKEN_HEADER,
2486
2897
  health: resolveEndpointConfig("health", ops?.health, defaults.health, env, authToken, warnings),
2487
2898
  metrics: resolveEndpointConfig("metrics", ops?.metrics, defaults.metrics, env, authToken, warnings),
@@ -3226,7 +3637,7 @@ var RedisCacheAdapter = class {
3226
3637
  ...config
3227
3638
  };
3228
3639
  this.config = merged;
3229
- this.logger = require_abVariantContext.Logger.getInstance();
3640
+ this.logger = require_Logger.Logger.getInstance();
3230
3641
  if (this.config.enableFallback) this.fallback = new MemoryCacheAdapter(this.config.fallbackConfig);
3231
3642
  const initialization = this.initConnection();
3232
3643
  this.connectionPromise = new Promise((resolve) => {
@@ -3669,7 +4080,7 @@ function hasRuntimeRedisConnection(redis) {
3669
4080
  * - 未显式配置 Redis → MemoryCacheStore(单层 LRU,行为不变)
3670
4081
  */
3671
4082
  var createAutoCacheStore_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ createAutoCacheStore: () => createAutoCacheStore });
3672
- var logger$6 = require_abVariantContext.Logger.getInstance();
4083
+ var logger$6 = require_Logger.Logger.getInstance();
3673
4084
  function createAutoCacheStore(opts = {}) {
3674
4085
  const redisConfig = resolveRuntimeRedisConfig({
3675
4086
  url: opts.redisUrl,
@@ -3714,7 +4125,7 @@ function normalizeTarget(target) {
3714
4125
  };
3715
4126
  }
3716
4127
  var RedisInvalidationBus = class {
3717
- logger = require_abVariantContext.Logger.getInstance();
4128
+ logger = require_Logger.Logger.getInstance();
3718
4129
  origin = (0, node_crypto.randomUUID)();
3719
4130
  channel;
3720
4131
  logKey;
@@ -4077,7 +4488,7 @@ function fnv1a32Base36(input) {
4077
4488
  * 响应头 `X-Cache-Key` 便于排错
4078
4489
  * 响应头 `X-Cache-Age`(HIT/STALE 时命中的年龄,秒)
4079
4490
  */
4080
- var logger$5 = require_abVariantContext.Logger.getInstance();
4491
+ var logger$5 = require_Logger.Logger.getInstance();
4081
4492
  /** bg revalidate 失败时间戳的 LRU 上限 —— 防止失败大量唯一 key 导致内存泄漏 */
4082
4493
  var BG_FAILURE_TRACK_MAX = 1e3;
4083
4494
  /** invalidation 时间戳的 LRU 上限 —— inventory 端点暴露 “target → lastInvalidatedMs” */
@@ -4296,6 +4707,7 @@ function createIsrCacheHandler(config, options = {}) {
4296
4707
  pathTagPrefix: `__isr_path:${cacheNamespace}:`,
4297
4708
  staticSeed: options.staticSeed,
4298
4709
  staticSeedInfo: options.staticSeedInfo,
4710
+ staticSeedAdmission: options.staticSeedAdmission,
4299
4711
  seeded
4300
4712
  }).catch((err) => {
4301
4713
  logger$5.warn("ISR cache handler 异常,回退到下游处理:", err);
@@ -4412,24 +4824,30 @@ function createIsrCacheMiddleware(explicitConfig, options = {}) {
4412
4824
  logger$5.info(`📋 ISR cache: 自动加载 ssr.config.ts 成功(mode=${rules.globalMode}, overrides=${Object.keys(rules.routes).length})`);
4413
4825
  }
4414
4826
  const opsConfig = resolveOpsConfig(resolvedConfig, "development");
4827
+ const { bindRuntimeOpsConfig, getOpsRequestLimiter } = await Promise.resolve().then(() => opsConfig_exports);
4828
+ const opsLimiter = getOpsRequestLimiter(opsConfig);
4829
+ const metricsAuth = createOpsAuthMiddleware("metrics", opsConfig);
4415
4830
  const nextHandler = createIsrCacheHandler(resolvedConfig, withRuntimeCacheOptions(resolvedConfig, {
4416
4831
  ...options,
4417
4832
  development: true
4418
4833
  }));
4419
4834
  try {
4420
- const inspector = opsConfig.inventory.enabled ? (await Promise.resolve().then(() => require("./createCacheInspectorMiddleware-Byzz8ZlU.cjs"))).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4835
+ const inspector = opsConfig.inventory.enabled ? (await Promise.resolve().then(() => require("./createCacheInspectorMiddleware-DG1_VLBS.cjs"))).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4421
4836
  handler = nextHandler;
4422
4837
  server.middlewares.use((req, res, next) => {
4423
4838
  if (handler !== nextHandler) return next();
4424
4839
  if (opsConfig.metrics.enabled && req.url === "/metrics" && req.method === "GET") {
4425
- createOpsAuthMiddleware("metrics", opsConfig)(req, res, () => {
4426
- Promise.resolve().then(() => require("./abVariantContext-Cqp-uxtd.cjs")).then((n) => n.PromMetrics_exports).then(async ({ promRegistry }) => {
4427
- const body = await promRegistry.metrics();
4428
- res.setHeader("content-type", promRegistry.contentType);
4429
- res.end(body);
4430
- }).catch((err) => {
4431
- res.statusCode = 500;
4432
- res.end(`metrics error: ${String(err)}`);
4840
+ opsLimiter(req, res, (error) => {
4841
+ if (error) return next(error);
4842
+ metricsAuth(req, res, () => {
4843
+ Promise.resolve().then(() => PromMetrics_exports).then(async ({ promRegistry }) => {
4844
+ const body = await promRegistry.metrics();
4845
+ res.setHeader("content-type", promRegistry.contentType);
4846
+ res.end(body);
4847
+ }).catch((err) => {
4848
+ res.statusCode = 500;
4849
+ res.end(`metrics error: ${String(err)}`);
4850
+ });
4433
4851
  });
4434
4852
  });
4435
4853
  return;
@@ -4440,6 +4858,7 @@ function createIsrCacheMiddleware(explicitConfig, options = {}) {
4440
4858
  });
4441
4859
  else nextHandler(req, res, next);
4442
4860
  });
4861
+ bindRuntimeOpsConfig(server, opsConfig);
4443
4862
  mounted = true;
4444
4863
  if (inspector) logger$5.info("🔍 ISR cache inventory 已启用:GET /__isr/cache/inventory");
4445
4864
  } catch (error) {
@@ -4454,6 +4873,25 @@ function createIsrCacheMiddleware(explicitConfig, options = {}) {
4454
4873
  }
4455
4874
  };
4456
4875
  }
4876
+ function seedDenial(res) {
4877
+ const retryAfter = res.getHeader("Retry-After");
4878
+ return {
4879
+ statusCode: res.statusCode >= 400 && res.statusCode <= 599 ? res.statusCode : 503,
4880
+ retryAfter: typeof retryAfter === "string" || typeof retryAfter === "number" ? String(retryAfter) : void 0
4881
+ };
4882
+ }
4883
+ function sendSeedDenial(res, denial) {
4884
+ if (res.destroyed || res.writableEnded) return;
4885
+ if (res.headersSent) {
4886
+ res.destroy();
4887
+ return;
4888
+ }
4889
+ res.statusCode = denial.statusCode;
4890
+ res.setHeader("Cache-Control", "no-store");
4891
+ res.setHeader("Content-Type", "application/json; charset=utf-8");
4892
+ if (denial.retryAfter) res.setHeader("Retry-After", denial.retryAfter);
4893
+ res.end(JSON.stringify({ error: denial.statusCode === 429 ? "Too many requests" : "Static seed admission unavailable" }));
4894
+ }
4457
4895
  /**
4458
4896
  * 单次请求的缓存处理
4459
4897
  */
@@ -4479,7 +4917,7 @@ async function handleRequest(req, res, next, ctx) {
4479
4917
  const route = stripRscSuffix(stripQuery$1(url)) || "/";
4480
4918
  const cache = String(res.getHeader("X-Cache-Status") || "BYPASS");
4481
4919
  const mode = String(res.getHeader("X-Resolved-Mode") || "unknown");
4482
- require_abVariantContext.recordHttpRequest({
4920
+ recordHttpRequest({
4483
4921
  method,
4484
4922
  route,
4485
4923
  status: res.statusCode,
@@ -4487,8 +4925,8 @@ async function handleRequest(req, res, next, ctx) {
4487
4925
  cache,
4488
4926
  durationMs
4489
4927
  });
4490
- require_abVariantContext.cacheEntriesGauge.set({ backend: ctx.cache.backend }, ctx.cache.size);
4491
- require_abVariantContext.cacheRevalidatingGauge.set(ctx.revalidating.size);
4928
+ cacheEntriesGauge.set({ backend: ctx.cache.backend }, ctx.cache.size);
4929
+ cacheRevalidatingGauge.set(ctx.revalidating.size);
4492
4930
  } catch {}
4493
4931
  });
4494
4932
  if (method !== "GET" && method !== "HEAD" || isBypassPath(url)) {
@@ -4535,24 +4973,39 @@ async function handleRequest(req, res, next, ctx) {
4535
4973
  let entry = ctx.cache.get(cacheKey);
4536
4974
  if (!entry && ctx.cache.getAsync) try {
4537
4975
  entry = await raceWithTimeout(ctx.cache.getAsync(cacheKey), ctx.l2ReadTimeoutMs, () => {
4538
- require_abVariantContext.l2ReadTimeoutsTotal.inc();
4976
+ l2ReadTimeoutsTotal.inc();
4539
4977
  });
4540
4978
  } catch (err) {
4541
4979
  logger$5.warn(`ISR cache L2 read 失败 ${cacheKey}: ${err.message}`);
4542
4980
  }
4543
4981
  if (!isActive()) return;
4544
4982
  if (!entry && ctx.state.invalidationGeneration === 0 && resolved.mode === "ssg" && ctx.staticSeed && (!ctx.staticSeedInfo || ctx.staticSeedInfo(logicalPath)) && !url.includes("?") && !url.endsWith(RSC_URL_POSTFIX) && !ctx.variantIsolation && !ctx.hostIsolation) {
4545
- if (!ctx.seeded.has(cacheKey)) {
4546
- const seedTask = (async () => {
4983
+ let seedTask = ctx.seeded.get(cacheKey);
4984
+ const leader = !seedTask;
4985
+ if (!seedTask) {
4986
+ seedTask = Promise.resolve().then(async () => {
4987
+ try {
4988
+ if (ctx.staticSeedAdmission && !await ctx.staticSeedAdmission(req, res)) return seedDenial(res);
4989
+ } catch (error) {
4990
+ logger$5.warn("SSG seed admission failed; refusing origin fallback", error);
4991
+ if (!res.headersSent && !res.writableEnded && !res.destroyed) {
4992
+ res.statusCode = 503;
4993
+ res.setHeader("Cache-Control", "no-store");
4994
+ res.end("Static seed admission unavailable");
4995
+ } else if (!res.writableEnded && !res.destroyed) res.destroy(error instanceof Error ? error : void 0);
4996
+ return seedDenial(res);
4997
+ }
4998
+ if (!isActive()) return seedDenial(res);
4547
4999
  const generation = ctx.state.invalidationGeneration;
5000
+ if (generation !== 0) return true;
4548
5001
  const seed = await raceWithTimeout(ctx.staticSeed(logicalPath, String(res.getHeader("content-security-policy") || "default-src 'self'")), ctx.l2ReadTimeoutMs);
4549
5002
  if (!seed) {
4550
5003
  ctx.seeded.delete(cacheKey);
4551
- return;
5004
+ return true;
4552
5005
  }
4553
5006
  const lease = ctx.cache.coherence ? await raceWithTimeout(ctx.cache.coherence.beginRender(), ctx.l2ReadTimeoutMs) : void 0;
4554
- if (generation !== 0 || lease && lease.revision !== "0") return;
4555
- if (generation !== ctx.state.invalidationGeneration) return;
5007
+ if (lease && lease.revision !== "0") return true;
5008
+ if (generation !== ctx.state.invalidationGeneration) return true;
4556
5009
  const ttl = resolved.ttlSeconds * 1e3;
4557
5010
  const seededEntry = {
4558
5011
  ...seed,
@@ -4561,19 +5014,25 @@ async function handleRequest(req, res, next, ctx) {
4561
5014
  hardExpiresAt: seed.storedAt + ttl + resolved.swrSeconds * 1e3,
4562
5015
  pathTag: `${ctx.pathTagPrefix}${logicalPath}`
4563
5016
  };
4564
- if (Date.now() >= seededEntry.hardExpiresAt) return;
5017
+ if (Date.now() >= seededEntry.hardExpiresAt) return true;
4565
5018
  if (ctx.cache.coherence) {
4566
5019
  if (lease && ctx.cache.coherence.seed) await raceWithTimeout(ctx.cache.coherence.seed(cacheKey, seededEntry, lease), ctx.l2ReadTimeoutMs);
4567
5020
  } else ctx.cache.set(cacheKey, seededEntry);
4568
- })();
5021
+ return true;
5022
+ });
4569
5023
  ctx.seeded.set(cacheKey, seedTask);
4570
5024
  }
4571
5025
  try {
4572
- await ctx.seeded.get(cacheKey);
5026
+ const result = await seedTask;
5027
+ if (result !== true) {
5028
+ if (ctx.seeded.get(cacheKey) === seedTask) ctx.seeded.delete(cacheKey);
5029
+ if (!leader && isActive()) sendSeedDenial(res, result);
5030
+ return;
5031
+ }
4573
5032
  if (!isActive()) return;
4574
5033
  entry = ctx.cache.getAsync ? await raceWithTimeout(ctx.cache.getAsync(cacheKey), ctx.l2ReadTimeoutMs) : ctx.cache.get(cacheKey);
4575
5034
  } catch (error) {
4576
- ctx.seeded.delete(cacheKey);
5035
+ if (ctx.seeded.get(cacheKey) === seedTask) ctx.seeded.delete(cacheKey);
4577
5036
  logger$5.warn("SSG build seed unavailable; rendering origin", error);
4578
5037
  }
4579
5038
  }
@@ -4612,7 +5071,7 @@ async function handleRequest(req, res, next, ctx) {
4612
5071
  let recheck = ctx.cache.get(cacheKey);
4613
5072
  if (!recheck && ctx.cache.getAsync) try {
4614
5073
  recheck = await raceWithTimeout(ctx.cache.getAsync(cacheKey), ctx.l2ReadTimeoutMs, () => {
4615
- require_abVariantContext.l2ReadTimeoutsTotal.inc();
5074
+ l2ReadTimeoutsTotal.inc();
4616
5075
  });
4617
5076
  } catch {}
4618
5077
  if (!isActive()) return;
@@ -4679,7 +5138,7 @@ async function runMissPath(_req, res, next, ctx, resolved, cacheKey, bgRevalidat
4679
5138
  captureAndStore(res, ctx.maxCachedBodyBytes, cacheKey, (captured) => {
4680
5139
  if (captured.overflow || renderGeneration !== ctx.state.invalidationGeneration) return;
4681
5140
  if (hasPrivateResponse(captured.headers)) return;
4682
- const requestContext = require_RequestContext.getRequestContext();
5141
+ const requestContext = require_abVariantContext.getRequestContext();
4683
5142
  if (requestContext?.userId || requestContext?.sessionToken || requestContext?.sessionUser) return;
4684
5143
  if (captured.statusCode !== 200) return;
4685
5144
  const ct = String(captured.headers["content-type"] || "");
@@ -5066,7 +5525,7 @@ function normalizeQuery(query) {
5066
5525
  * ABVariantMiddleware 已经写好了 ctx.experiments,这里直接 hash 即可。
5067
5526
  */
5068
5527
  function extractVariantDigest(req, cookieName) {
5069
- const exps = require_RequestContext.getRequestContext()?.experiments;
5528
+ const exps = require_abVariantContext.getRequestContext()?.experiments;
5070
5529
  if (exps && Object.keys(exps).length > 0) return fnv1a32Base36(Object.keys(exps).sort().map((k) => `${k}=${exps[k]}`).join("|"));
5071
5530
  const value = require_i18n.readCookie(req, cookieName);
5072
5531
  return value ? fnv1a32Base36(value) : null;
@@ -5198,6 +5657,36 @@ function refreshHeaders(req, ctx) {
5198
5657
  return headers;
5199
5658
  }
5200
5659
  //#endregion
5660
+ //#region src/server/safeRedirect.ts
5661
+ var REDIRECT_ORIGIN = "https://isr.invalid";
5662
+ /** Validate the final Location value against a fixed origin, never an untrusted Host header. */
5663
+ function isSafeLocalRedirect(target) {
5664
+ if (!target.startsWith("/") || target.startsWith("//")) return false;
5665
+ for (const character of target) {
5666
+ const code = character.charCodeAt(0);
5667
+ if (code < 32 || code === 127) return false;
5668
+ }
5669
+ const pathEnd = target.search(/[?#]/);
5670
+ if (target.slice(0, pathEnd < 0 ? void 0 : pathEnd).includes("\\")) return false;
5671
+ try {
5672
+ return new URL(target, REDIRECT_ORIGIN).origin === REDIRECT_ORIGIN;
5673
+ } catch {
5674
+ return false;
5675
+ }
5676
+ }
5677
+ function readRedirectQuery(url) {
5678
+ const delimiter = url.indexOf("?");
5679
+ return delimiter < 0 ? void 0 : url.slice(delimiter + 1);
5680
+ }
5681
+ function redirectLocal(res, status, pathname, query) {
5682
+ const target = query === void 0 ? pathname : `${pathname}?${query}`;
5683
+ if (!isSafeLocalRedirect(target)) {
5684
+ res.status(400).end();
5685
+ return;
5686
+ }
5687
+ res.redirect(status, target);
5688
+ }
5689
+ //#endregion
5201
5690
  //#region src/security/staticCspManifest.ts
5202
5691
  var STATIC_CSP_MANIFEST = "static-csp-manifest.json";
5203
5692
  var SCHEMA_VERSION = 3;
@@ -5515,6 +6004,7 @@ async function createProductionRuntime(config, options = {}) {
5515
6004
  if (errors.length) throw new AggregateError(errors.map((result) => result.reason), "Production runtime cleanup failed");
5516
6005
  })();
5517
6006
  try {
6007
+ validateRequestLimits(config.server.requestLimits);
5518
6008
  const runtime = config.runtime;
5519
6009
  applyTelemetryIntegrationEnv(runtime);
5520
6010
  const sentryIntegration = runtime?.telemetry ? runtime.telemetry.integrations?.sentry : void 0;
@@ -5536,7 +6026,7 @@ async function createProductionRuntime(config, options = {}) {
5536
6026
  app.use(createSecurityMiddleware(false, extraConnectSrc));
5537
6027
  app.use(createCompressionMiddleware());
5538
6028
  if (extraConnectSrc.length > 0) logger$8.info(`🔒 CSP connect-src 加入:${extraConnectSrc.join(", ")}`);
5539
- const { requestContext } = await Promise.resolve().then(() => require("./RequestContext-DgGEAxcW.cjs")).then((n) => n.RequestContext_exports);
6029
+ const { requestContext } = await Promise.resolve().then(() => require("./abVariantContext-BvAMuhjj.cjs")).then((n) => n.RequestContext_exports);
5540
6030
  const { createServerRequestContext, applyAnonCookie } = await Promise.resolve().then(() => createServerRequestContext_exports);
5541
6031
  const cookieDomain = runtime?.cookieDomain;
5542
6032
  app.use((req, res, next) => {
@@ -5546,7 +6036,7 @@ async function createProductionRuntime(config, options = {}) {
5546
6036
  });
5547
6037
  if (runtime?.i18n?.prefixDefault) {
5548
6038
  const { createLocaleRedirectMiddleware } = await Promise.resolve().then(() => LocaleRedirect_exports);
5549
- const { resolveI18nConfig } = await Promise.resolve().then(() => require("./i18n-CyJIoYJT.cjs")).then((n) => n.i18n_exports);
6039
+ const { resolveI18nConfig } = await Promise.resolve().then(() => require("./i18n-CS5QhOO0.cjs")).then((n) => n.i18n_exports);
5550
6040
  const middleware = createLocaleRedirectMiddleware({ i18n: resolveI18nConfig(runtime.i18n) });
5551
6041
  if (middleware) {
5552
6042
  app.use(middleware);
@@ -5583,7 +6073,7 @@ async function createProductionRuntime(config, options = {}) {
5583
6073
  const expKeys = manifestLoader ? Object.keys(manifestLoader.getCurrent()) : Object.keys(runtime?.experiments ?? {});
5584
6074
  logger$8.info(`🧪 A/B testing 已启用:${expKeys.join(", ") || "(empty)"}${manifestLoader ? " [manifest]" : " [static]"}${exposureQueue ? " + exposure tracking" : ""}`);
5585
6075
  }
5586
- if (opsConfig.health.enabled) app.get("/health", createOpsAuthMiddleware("health", opsConfig), (_req, res) => {
6076
+ if (opsConfig.health.enabled) app.get("/health", getOpsRequestLimiter(opsConfig), createOpsAuthMiddleware("health", opsConfig), (_req, res) => {
5587
6077
  res.json({
5588
6078
  status: "healthy",
5589
6079
  version: package_default.version,
@@ -5592,11 +6082,25 @@ async function createProductionRuntime(config, options = {}) {
5592
6082
  });
5593
6083
  });
5594
6084
  options.setupRoutes?.(app);
6085
+ const staticHtmlLimiter = createRequestLimiter("staticHtml", config.server.requestLimits?.staticHtml);
6086
+ const seoLimiter = createRequestLimiter("seo", config.server.requestLimits?.seo);
6087
+ app.use((req, res, next) => {
6088
+ if (req.method !== "GET" && req.method !== "HEAD") return next();
6089
+ let pathname;
6090
+ try {
6091
+ pathname = normalizeStaticAssetPathname(req.path).toLowerCase().replace(/\/$/, "");
6092
+ } catch {
6093
+ res.status(400).end();
6094
+ return;
6095
+ }
6096
+ if (pathname === "/sitemap.xml" || pathname === "/robots.txt") return seoLimiter(req, res, next);
6097
+ next();
6098
+ });
5595
6099
  app.use(createStaticAssetMiddleware(clientDir));
5596
6100
  app.use("/assets", (_req, res) => {
5597
6101
  res.status(404).set("Cache-Control", "no-store").end();
5598
6102
  });
5599
- const { createImageMiddleware } = await Promise.resolve().then(() => require("./createImagePlugin-birVNynL.cjs")).then((n) => n.createImagePlugin_exports);
6103
+ const { createImageMiddleware } = await Promise.resolve().then(() => require("./createImagePlugin-Ca4t_WhM.cjs")).then((n) => n.createImagePlugin_exports);
5600
6104
  const { resolveImageOptions } = await Promise.resolve().then(() => resolveImageOptions_exports);
5601
6105
  app.use(createImageMiddleware(resolveImageOptions(config.runtime.images), {}, clientDir));
5602
6106
  const { createAutoCacheStore } = await Promise.resolve().then(() => createAutoCacheStore_exports);
@@ -5618,6 +6122,7 @@ async function createProductionRuntime(config, options = {}) {
5618
6122
  }, {
5619
6123
  buildId: process.env.APP_VERSION ?? staticCspIndex.buildId,
5620
6124
  resolveInvalidationPath: resolveSsgIdentity,
6125
+ staticSeedAdmission: (req, res) => admitRequest(staticHtmlLimiter, req, res),
5621
6126
  staticSeedInfo: (pathname) => {
5622
6127
  const htmlPath = ssgFiles.get(pathname);
5623
6128
  if (!htmlPath) return;
@@ -5668,7 +6173,7 @@ async function createProductionRuntime(config, options = {}) {
5668
6173
  });
5669
6174
  cleanups.push(() => cache.destroy());
5670
6175
  if (opsConfig.inventory.enabled) {
5671
- const { createCacheInspectorMiddleware } = await Promise.resolve().then(() => require("./createCacheInspectorMiddleware-Byzz8ZlU.cjs"));
6176
+ const { createCacheInspectorMiddleware } = await Promise.resolve().then(() => require("./createCacheInspectorMiddleware-DG1_VLBS.cjs"));
5672
6177
  app.use(createCacheInspectorMiddleware(cache, opsConfig));
5673
6178
  logger$8.info("🔍 ISR cache inventory 已启用:GET /__isr/cache/inventory");
5674
6179
  }
@@ -5681,20 +6186,20 @@ async function createProductionRuntime(config, options = {}) {
5681
6186
  res.status(400).end();
5682
6187
  return;
5683
6188
  }
5684
- if (!ssgAliases.get(logical)) return next();
5685
- const canonical = resolveSsgIdentity(req.path);
6189
+ const known = ssgAliases.get(logical);
6190
+ if (!known) return next();
6191
+ const canonical = explicitRoutes.get(logical) ?? known;
5686
6192
  if (req.path === canonical) return next();
5687
- const queryStart = req.url.indexOf("?");
5688
- res.redirect(308, canonical + (queryStart < 0 ? "" : req.url.slice(queryStart)));
6193
+ redirectLocal(res, 308, canonical, readRedirectQuery(req.url));
5689
6194
  });
5690
6195
  app.use(cache);
5691
- const staticHtml = createStaticHtmlMiddleware(clientDir, staticCspIndex);
6196
+ const staticHtml = createStaticHtmlMiddlewareWithLimiter(clientDir, staticCspIndex, staticHtmlLimiter);
5692
6197
  app.use((req, res, next) => {
5693
6198
  if (res.getHeader("X-Resolved-Mode") === "ssg" || ssgAliases.has(decodeHtmlPathname(req.path)) && explicitRoutes.has(decodeHtmlPathname(req.path))) return next();
5694
6199
  staticHtml(req, res, next);
5695
6200
  });
5696
- const { promRegistry } = await Promise.resolve().then(() => require("./abVariantContext-Cqp-uxtd.cjs")).then((n) => n.PromMetrics_exports);
5697
- if (opsConfig.metrics.enabled) app.get("/metrics", createOpsAuthMiddleware("metrics", opsConfig), async (_req, res) => {
6201
+ const { promRegistry } = await Promise.resolve().then(() => PromMetrics_exports);
6202
+ if (opsConfig.metrics.enabled) app.get("/metrics", getOpsRequestLimiter(opsConfig), createOpsAuthMiddleware("metrics", opsConfig), async (_req, res) => {
5698
6203
  try {
5699
6204
  res.set("content-type", promRegistry.contentType);
5700
6205
  res.end(await promRegistry.metrics());
@@ -5724,7 +6229,7 @@ async function createProductionRuntime(config, options = {}) {
5724
6229
  res.end(seo.generateRobotsTxt());
5725
6230
  });
5726
6231
  const { renderError500Html } = await Promise.resolve().then(() => require("./error500-template-BvZmvKoa.cjs"));
5727
- const { getTraceId } = await Promise.resolve().then(() => require("./RequestContext-DgGEAxcW.cjs")).then((n) => n.RequestContext_exports);
6232
+ const { getTraceId } = await Promise.resolve().then(() => require("./abVariantContext-BvAMuhjj.cjs")).then((n) => n.RequestContext_exports);
5728
6233
  app.all(/.*/, createProductionRequestHandler(rscHandler, (err, _req, res) => {
5729
6234
  logger$8.error("[Server]", "请求处理异常", err);
5730
6235
  if (!res.headersSent) {
@@ -5855,8 +6360,25 @@ async function pipeWebResponse(response, res) {
5855
6360
  else nodeReadable.pipe(res);
5856
6361
  });
5857
6362
  }
5858
- /** Static HTML can only be served from the build index validated before startup. */
5859
- function createStaticHtmlMiddleware(clientDir, index) {
6363
+ function createStaticHtmlMiddlewareWithLimiter(clientDir, index, limiter) {
6364
+ const targets = /* @__PURE__ */ new WeakMap();
6365
+ const guarded = express.default.Router();
6366
+ guarded.use(limiter);
6367
+ guarded.use((req, res, next) => {
6368
+ const target = targets.get(req);
6369
+ targets.delete(req);
6370
+ if (!target) return next();
6371
+ res.setHeader("Content-Security-Policy", applyStaticScriptPolicy(String(res.getHeader("Content-Security-Policy") ?? "default-src 'self'"), target.hashes));
6372
+ res.setHeader("Cache-Control", "public, max-age=3600");
6373
+ res.setHeader("X-Served-By", "ssg-static");
6374
+ res.sendFile(target.htmlPath, {
6375
+ root: clientDir,
6376
+ maxAge: "1h",
6377
+ dotfiles: "ignore"
6378
+ }, (error) => {
6379
+ if (error) next(error);
6380
+ });
6381
+ });
5860
6382
  return (req, res, next) => {
5861
6383
  if (req.method !== "GET" && req.method !== "HEAD") return next();
5862
6384
  let pathname;
@@ -5870,19 +6392,17 @@ function createStaticHtmlMiddleware(clientDir, index) {
5870
6392
  const htmlPath = relative.endsWith("/") || !relative ? relative + "index.html" : relative.toLowerCase().endsWith(".html") ? relative : relative + "/index.html";
5871
6393
  const hashes = index.scriptHashes.get(htmlPath);
5872
6394
  if (!hashes) return next();
5873
- res.setHeader("Content-Security-Policy", applyStaticScriptPolicy(String(res.getHeader("Content-Security-Policy") ?? "default-src 'self'"), hashes));
5874
- res.setHeader("Cache-Control", "public, max-age=3600");
5875
- res.setHeader("X-Served-By", "ssg-static");
5876
- res.sendFile(htmlPath, {
5877
- root: clientDir,
5878
- maxAge: "1h",
5879
- dotfiles: "ignore"
5880
- }, (error) => {
5881
- if (error) next(error);
6395
+ targets.set(req, {
6396
+ htmlPath,
6397
+ hashes
5882
6398
  });
6399
+ guarded(req, res, next);
5883
6400
  };
5884
6401
  }
5885
6402
  /** Asset serving must never discover HTML outside the validated build manifest. */
6403
+ function normalizeStaticAssetPathname(pathname) {
6404
+ return node_path.default.posix.normalize(decodeURIComponent(new URL(`http://localhost${pathname}`).pathname).replaceAll("\\", "/"));
6405
+ }
5886
6406
  function createStaticAssetMiddleware(clientDir) {
5887
6407
  const assets = express.default.static(clientDir, {
5888
6408
  index: false,
@@ -5897,7 +6417,7 @@ function createStaticAssetMiddleware(clientDir) {
5897
6417
  return (req, res, next) => {
5898
6418
  let pathname;
5899
6419
  try {
5900
- pathname = node_path.default.posix.normalize(decodeURIComponent(new URL(`http://localhost${req.path}`).pathname).replaceAll("\\", "/"));
6420
+ pathname = normalizeStaticAssetPathname(req.path);
5901
6421
  } catch {
5902
6422
  res.status(400).end();
5903
6423
  return;
@@ -5916,7 +6436,7 @@ function createStaticAssetMiddleware(clientDir) {
5916
6436
  * TLS / HTTP/2 / HTTP/3 / Brotli 属于 CDN / Ingress / Nginx / Envoy / ALB 边界。
5917
6437
  * isr-engine 负责 SSR/ISR/RSC/cache/revalidate,不把网关层协议暴露为业务配置。
5918
6438
  */
5919
- var logger$4 = require_abVariantContext.Logger.getInstance();
6439
+ var logger$4 = require_Logger.Logger.getInstance();
5920
6440
  var DEFAULT_TIMEOUTS = {
5921
6441
  requestTimeoutMs: 6e4,
5922
6442
  headersTimeoutMs: 15e3,
@@ -6064,7 +6584,7 @@ function createABVariantMiddleware(options) {
6064
6584
  const { experiments: staticExperiments, assigner = defaultAssigner } = options;
6065
6585
  const { manifestLoader, exposureQueue } = options;
6066
6586
  return function abMiddleware(req, _res, next) {
6067
- const ctx = require_RequestContext.getRequestContext();
6587
+ const ctx = require_abVariantContext.getRequestContext();
6068
6588
  if (!ctx) {
6069
6589
  next();
6070
6590
  return;
@@ -6115,7 +6635,7 @@ var ManifestLoader_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAl
6115
6635
  normalizeManifestExperiments: () => normalizeManifestExperiments,
6116
6636
  resolveManifestLoader: () => resolveManifestLoader
6117
6637
  });
6118
- var logger$3 = require_abVariantContext.Logger.getInstance();
6638
+ var logger$3 = require_Logger.Logger.getInstance();
6119
6639
  /**
6120
6640
  * 把 manifest 里的实验定义归一化为 engine 内部用的 RuntimeExperimentConfig。
6121
6641
  * killed / paused / concluded 状态的实验:**weights 强制变成 [100, 0, 0, ...]**,
@@ -6269,7 +6789,7 @@ var ExposureQueue_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll
6269
6789
  createExposureQueue: () => createExposureQueue,
6270
6790
  resolveExposureQueue: () => resolveExposureQueue
6271
6791
  });
6272
- var logger$2 = require_abVariantContext.Logger.getInstance();
6792
+ var logger$2 = require_Logger.Logger.getInstance();
6273
6793
  /**
6274
6794
  * 创建上报队列。同一进程整个 lifecycle 只创建一个;engine 入口保管 instance。
6275
6795
  * 返回 push() / flush() / destroy() 三个方法。
@@ -6423,7 +6943,11 @@ function createLocaleRedirectMiddleware(options) {
6423
6943
  const { i18n, skipPathPrefixes = [] } = options;
6424
6944
  if (!i18n.prefixDefault) return null;
6425
6945
  if (!i18n.locales || i18n.locales.length === 0) return null;
6426
- const localeSet = new Set(i18n.locales);
6946
+ const localePrefixes = new Map(i18n.locales.map((locale) => [locale, `/${locale}`]));
6947
+ function redirectLocale(res, status, prefix, path, suffix, url) {
6948
+ const tail = path.startsWith("/") ? path.slice(1) : path;
6949
+ redirectLocal(res, status, tail ? `${prefix}/${tail}${suffix}` : prefix + suffix, readRedirectQuery(url));
6950
+ }
6427
6951
  return function localeRedirectMiddleware(req, res, next) {
6428
6952
  if (req.method !== "GET" && req.method !== "HEAD") return next();
6429
6953
  const rawPath = req.path;
@@ -6439,20 +6963,22 @@ function createLocaleRedirectMiddleware(options) {
6439
6963
  if (path.includes(".")) return next();
6440
6964
  const first = path.split("/")[1];
6441
6965
  if (first) {
6442
- if (localeSet.has(first)) return next();
6966
+ if (localePrefixes.has(first)) return next();
6443
6967
  const ci = i18n.locales.find((l) => l.toLowerCase() === first.toLowerCase());
6444
- if (ci) {
6445
- const rest = path.slice(first.length + 1) || "/";
6446
- const search = req.url.includes("?") ? req.url.slice(req.url.indexOf("?")) : "";
6447
- const finalRest = rest === "/" ? "" : rest;
6448
- res.redirect(308, `/${ci}${finalRest}${rscSuffix}${search}`);
6968
+ const prefix = ci ? localePrefixes.get(ci) : void 0;
6969
+ if (prefix) {
6970
+ redirectLocale(res, 308, prefix, path.slice(first.length + 1) || "/", rscSuffix, req.url);
6449
6971
  return;
6450
6972
  }
6451
6973
  }
6452
6974
  const cookieLocale = readCookieLocale(typeof req.headers["cookie"] === "string" ? req.headers["cookie"] : "");
6453
- const target = (cookieLocale && localeSet.has(cookieLocale) ? cookieLocale : null) || require_i18n.negotiateLocale(typeof req.headers["accept-language"] === "string" ? req.headers["accept-language"] : null, i18n);
6454
- const search = req.url.includes("?") ? req.url.slice(req.url.indexOf("?")) : "";
6455
- res.redirect(302, require_i18n.withLocale(path, target, i18n) + rscSuffix + search);
6975
+ const target = (cookieLocale && localePrefixes.has(cookieLocale) ? cookieLocale : null) || require_i18n.negotiateLocale(typeof req.headers["accept-language"] === "string" ? req.headers["accept-language"] : null, i18n);
6976
+ const prefix = localePrefixes.get(target);
6977
+ if (!prefix) {
6978
+ res.status(400).end();
6979
+ return;
6980
+ }
6981
+ redirectLocale(res, 302, prefix, path, rscSuffix, req.url);
6456
6982
  };
6457
6983
  }
6458
6984
  function readCookieLocale(header) {
@@ -6476,7 +7002,7 @@ function readCookieLocale(header) {
6476
7002
  * 整合 Vite 开发服务器、HTTP 服务器和中间件
6477
7003
  * ISREngine 唯一需要关心的服务器入口
6478
7004
  */
6479
- var logger$1 = require_abVariantContext.Logger.getInstance();
7005
+ var logger$1 = require_Logger.Logger.getInstance();
6480
7006
  /** 服务器上下文 */
6481
7007
  var serverContext = null;
6482
7008
  var productionRuntime;
@@ -6508,11 +7034,13 @@ function loadProdManifest() {
6508
7034
  /**
6509
7035
  * 初始化开发模式服务器上下文
6510
7036
  */
6511
- async function initDevContext(requestHandler) {
7037
+ async function initDevContext(requestHandler, config) {
6512
7038
  logger$1.info("🔧 初始化开发模式服务器...");
7039
+ const viteDevMiddleware = await createViteDevServer();
7040
+ bindRuntimeOpsConfig(requestHandler, getRuntimeOpsConfig(viteDevMiddleware) ?? resolveOpsConfig(config, "development"));
6513
7041
  return {
6514
7042
  requestHandler,
6515
- viteDevMiddleware: await createViteDevServer(),
7043
+ viteDevMiddleware,
6516
7044
  isDev: true,
6517
7045
  manifest: null,
6518
7046
  httpServer: null
@@ -6523,14 +7051,14 @@ async function initDevContext(requestHandler) {
6523
7051
  */
6524
7052
  async function initServerContext(config) {
6525
7053
  if (serverContext) return serverContext;
6526
- serverContext = await initDevContext((0, express.default)());
7054
+ serverContext = await initDevContext((0, express.default)(), config);
6527
7055
  developmentCleanups.push(closeViteDevServer);
6528
7056
  applyBaseMiddlewaresWithOptions(serverContext);
6529
7057
  const cookieDomain = config?.runtime?.cookieDomain;
6530
7058
  serverContext.requestHandler.use((req, res, next) => {
6531
7059
  const { data, needsAnonCookie } = createServerRequestContext(req);
6532
7060
  if (needsAnonCookie) applyAnonCookie(res, data.anonId, cookieDomain);
6533
- require_RequestContext.requestContext.run(data, () => next());
7061
+ require_abVariantContext.requestContext.run(data, () => next());
6534
7062
  });
6535
7063
  if (config?.runtime?.i18n?.prefixDefault) {
6536
7064
  const localeRedirect = createLocaleRedirectMiddleware({ i18n: require_i18n.resolveI18nConfig(config.runtime.i18n) });
@@ -6659,14 +7187,18 @@ var ISRRoutes = class {
6659
7187
  logger;
6660
7188
  defaultMode;
6661
7189
  routes;
7190
+ requestLimits;
6662
7191
  constructor(engine, logger, config) {
6663
7192
  this.engine = engine;
6664
7193
  this.logger = logger;
6665
7194
  this.defaultMode = config.renderMode;
6666
7195
  this.routes = config.routes || {};
7196
+ this.requestLimits = config.requestLimits;
6667
7197
  }
6668
7198
  setup(requestHandler) {
6669
- requestHandler.get("/health", (_req, res) => {
7199
+ const seoLimiter = createRequestLimiter("seo", this.requestLimits?.seo);
7200
+ const opsConfig = getRuntimeOpsConfig(requestHandler) ?? resolveOpsConfig({ server: { requestLimits: this.requestLimits } }, "development");
7201
+ if (opsConfig.health.enabled) requestHandler.get("/health", getOpsRequestLimiter(opsConfig), createOpsAuthMiddleware("health", opsConfig), (_req, res) => {
6670
7202
  res.json({
6671
7203
  status: "healthy",
6672
7204
  version: package_default.version,
@@ -6676,7 +7208,7 @@ var ISRRoutes = class {
6676
7208
  timestamp: (/* @__PURE__ */ new Date()).toISOString()
6677
7209
  });
6678
7210
  });
6679
- requestHandler.get("/sitemap.xml", async (_req, res) => {
7211
+ requestHandler.get("/sitemap.xml", seoLimiter, async (_req, res) => {
6680
7212
  try {
6681
7213
  const candidates = [
6682
7214
  node_path.default.resolve(process.cwd(), "dist/client/sitemap.xml"),
@@ -6701,7 +7233,7 @@ var ISRRoutes = class {
6701
7233
  res.status(500).send("Internal Server Error");
6702
7234
  }
6703
7235
  });
6704
- requestHandler.get("/robots.txt", async (_req, res) => {
7236
+ requestHandler.get("/robots.txt", seoLimiter, async (_req, res) => {
6705
7237
  try {
6706
7238
  const candidates = [
6707
7239
  node_path.default.resolve(process.cwd(), "dist/client/robots.txt"),
@@ -6806,7 +7338,7 @@ var SEOEngine_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
6806
7338
  });
6807
7339
  var SEOEngine = class SEOEngine {
6808
7340
  static instance = null;
6809
- logger = require_abVariantContext.Logger.getInstance();
7341
+ logger = require_Logger.Logger.getInstance();
6810
7342
  config;
6811
7343
  initialized = false;
6812
7344
  pageDataCache = /* @__PURE__ */ new Map();
@@ -7042,7 +7574,7 @@ function createSEOEngine(config) {
7042
7574
  * - dev 自动用 localhost,降低本地启动成本
7043
7575
  */
7044
7576
  var resolveSeoConfig_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ resolveSeoConfig: () => resolveSeoConfig });
7045
- var logger = require_abVariantContext.Logger.getInstance();
7577
+ var logger = require_Logger.Logger.getInstance();
7046
7578
  /**
7047
7579
  * 按以下顺序解析 baseUrl:
7048
7580
  * 1. runtime.site
@@ -7072,7 +7604,7 @@ function resolveSeoConfig(config) {
7072
7604
  var MiddlewareComposer = class MiddlewareComposer {
7073
7605
  static instance;
7074
7606
  middlewares = [];
7075
- logger = require_abVariantContext.Logger.getInstance();
7607
+ logger = require_Logger.Logger.getInstance();
7076
7608
  static getInstance() {
7077
7609
  if (!MiddlewareComposer.instance) MiddlewareComposer.instance = new MiddlewareComposer();
7078
7610
  return MiddlewareComposer.instance;
@@ -7159,8 +7691,8 @@ var traceMiddleware = async (context, next) => {
7159
7691
  context.data.requestId = requestId;
7160
7692
  context.data.anonId = anonId;
7161
7693
  }
7162
- await require_RequestContext.requestContext.run(context.data, async () => {
7163
- require_abVariantContext.Logger.getInstance().debug(`[Middleware] Trace initialized: ${traceId}${tp ? " (from W3C traceparent)" : ""}`);
7694
+ await require_abVariantContext.requestContext.run(context.data, async () => {
7695
+ require_Logger.Logger.getInstance().debug(`[Middleware] Trace initialized: ${traceId}${tp ? " (from W3C traceparent)" : ""}`);
7164
7696
  await next();
7165
7697
  });
7166
7698
  };
@@ -7179,7 +7711,7 @@ var traceMiddleware = async (context, next) => {
7179
7711
  */
7180
7712
  var performanceMiddleware = async (context, next) => {
7181
7713
  const start = process.hrtime();
7182
- const logger = require_abVariantContext.Logger.getInstance();
7714
+ const logger = require_Logger.Logger.getInstance();
7183
7715
  try {
7184
7716
  await next();
7185
7717
  } finally {
@@ -7211,7 +7743,7 @@ var performanceMiddleware = async (context, next) => {
7211
7743
  * - SSG 预生成:由 cli/build.ts + ssg/spider 在构建阶段完成
7212
7744
  */
7213
7745
  var ISREngine = class {
7214
- logger = require_abVariantContext.Logger.getInstance();
7746
+ logger = require_Logger.Logger.getInstance();
7215
7747
  config;
7216
7748
  resolvedSeo;
7217
7749
  middlewareComposer;
@@ -7249,7 +7781,8 @@ var ISREngine = class {
7249
7781
  if (!isDev()) return;
7250
7782
  new ISRRoutes(this, this.logger, {
7251
7783
  renderMode: this.config.renderMode,
7252
- routes: this.config.routes
7784
+ routes: this.config.routes,
7785
+ requestLimits: this.config.server.requestLimits
7253
7786
  }).setup(requestHandler);
7254
7787
  });
7255
7788
  return this.serverContext;
@@ -7473,6 +8006,12 @@ Object.defineProperty(exports, "createProductionRuntime", {
7473
8006
  return createProductionRuntime;
7474
8007
  }
7475
8008
  });
8009
+ Object.defineProperty(exports, "createPrometheusMetricsMiddleware", {
8010
+ enumerable: true,
8011
+ get: function() {
8012
+ return createPrometheusMetricsMiddleware;
8013
+ }
8014
+ });
7476
8015
  Object.defineProperty(exports, "createSEOEngine", {
7477
8016
  enumerable: true,
7478
8017
  get: function() {
@@ -7503,12 +8042,30 @@ Object.defineProperty(exports, "getFallbackChain", {
7503
8042
  return getFallbackChain;
7504
8043
  }
7505
8044
  });
8045
+ Object.defineProperty(exports, "getOpsRequestLimiter", {
8046
+ enumerable: true,
8047
+ get: function() {
8048
+ return getOpsRequestLimiter;
8049
+ }
8050
+ });
7506
8051
  Object.defineProperty(exports, "getRouteFallbackChain", {
7507
8052
  enumerable: true,
7508
8053
  get: function() {
7509
8054
  return getRouteFallbackChain;
7510
8055
  }
7511
8056
  });
8057
+ Object.defineProperty(exports, "invalidatorFailuresTotal", {
8058
+ enumerable: true,
8059
+ get: function() {
8060
+ return invalidatorFailuresTotal;
8061
+ }
8062
+ });
8063
+ Object.defineProperty(exports, "invalidatorRunsTotal", {
8064
+ enumerable: true,
8065
+ get: function() {
8066
+ return invalidatorRunsTotal;
8067
+ }
8068
+ });
7512
8069
  Object.defineProperty(exports, "isCodeFile", {
7513
8070
  enumerable: true,
7514
8071
  get: function() {
@@ -7593,12 +8150,24 @@ Object.defineProperty(exports, "prepareProductionBuild", {
7593
8150
  return prepareProductionBuild;
7594
8151
  }
7595
8152
  });
8153
+ Object.defineProperty(exports, "promRegistry", {
8154
+ enumerable: true,
8155
+ get: function() {
8156
+ return promRegistry;
8157
+ }
8158
+ });
7596
8159
  Object.defineProperty(exports, "readDirRecursive", {
7597
8160
  enumerable: true,
7598
8161
  get: function() {
7599
8162
  return readDirRecursive;
7600
8163
  }
7601
8164
  });
8165
+ Object.defineProperty(exports, "recordHttpRequest", {
8166
+ enumerable: true,
8167
+ get: function() {
8168
+ return recordHttpRequest;
8169
+ }
8170
+ });
7602
8171
  Object.defineProperty(exports, "resolveFetchHandler", {
7603
8172
  enumerable: true,
7604
8173
  get: function() {
@@ -7660,4 +8229,4 @@ Object.defineProperty(exports, "startServer", {
7660
8229
  }
7661
8230
  });
7662
8231
 
7663
- //# sourceMappingURL=createISRApp-C9Bezuit.cjs.map
8232
+ //# sourceMappingURL=createISRApp-HX6X8UNb.cjs.map