isr-engine 4.4.0 → 4.4.1

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 CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { D as loadConfig, G as DEFAULT_PORT, K as package_default, W as logger, a as closeServer, c as prepareProductionBuild, o as startServer, s as createProductionRuntime, t as createISRApp } from "../createISRApp-yBEBvYD5.js";
2
+ import { D as loadConfig, G as DEFAULT_PORT, K as package_default, W as logger, a as closeServer, c as prepareProductionBuild, o as startServer, s as createProductionRuntime, t as createISRApp } from "../createISRApp-BX9sh7P6.js";
3
3
  import { extname, join, resolve, sep } from "node:path";
4
4
  import { open, readFile } from "node:fs/promises";
5
5
  import http from "node:http";
@@ -1,4 +1,4 @@
1
- import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-yBEBvYD5.js";
1
+ import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-BX9sh7P6.js";
2
2
  import express from "express";
3
3
  /** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */
4
4
  var HARD_LIMIT = 1e3;
@@ -106,4 +106,4 @@ function createCacheInspectorMiddleware(handler, opsConfig) {
106
106
  }
107
107
  export { createCacheInspectorMiddleware };
108
108
 
109
- //# sourceMappingURL=createCacheInspectorMiddleware-DUYq46J4.js.map
109
+ //# sourceMappingURL=createCacheInspectorMiddleware-BKpkkkJ8.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"createCacheInspectorMiddleware-DUYq46J4.js","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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"}
1
+ {"version":3,"file":"createCacheInspectorMiddleware-BKpkkkJ8.js","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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"}
@@ -24,6 +24,7 @@ import { pathToFileURL } from "node:url";
24
24
  import { Readable, Writable } from "node:stream";
25
25
  import os from "node:os";
26
26
  import http, { request } from "node:http";
27
+ import { isUint8Array } from "node:util/types";
27
28
  import { LRUCache } from "lru-cache";
28
29
  import { Counter, Gauge, Histogram, Registry, collectDefaultMetrics } from "prom-client";
29
30
  import { pathToFileURL as pathToFileURL$1 } from "url";
@@ -1555,7 +1556,7 @@ function createSecurityMiddleware(isDev, extraConnectSrc = []) {
1555
1556
  * - 若部署在 nginx/Cloudflare 后面,建议禁用本中间件让边缘做压缩
1556
1557
  */
1557
1558
  function createCompressionMiddleware(options = {}) {
1558
- return compression({
1559
+ const compress = compression({
1559
1560
  threshold: options.threshold ?? 1024,
1560
1561
  level: options.level ?? 6,
1561
1562
  filter: (req, res) => {
@@ -1563,6 +1564,33 @@ function createCompressionMiddleware(options = {}) {
1563
1564
  return compression.filter(req, res);
1564
1565
  }
1565
1566
  });
1567
+ return (req, res, next) => {
1568
+ const nativeEnd = res.end;
1569
+ compress(req, res, () => {
1570
+ const compressedEnd = res.end;
1571
+ res.end = function(...args) {
1572
+ if (res.destroyed || res.writableEnded) return Reflect.apply(nativeEnd, res, args);
1573
+ let [chunk, encoding, callback] = args;
1574
+ if (typeof chunk === "function") {
1575
+ callback = chunk;
1576
+ chunk = encoding = void 0;
1577
+ } else if (typeof encoding === "function") {
1578
+ callback = encoding;
1579
+ encoding = void 0;
1580
+ }
1581
+ const finish = typeof callback === "function" ? callback : void 0;
1582
+ if (finish) res.once("finish", finish);
1583
+ try {
1584
+ Reflect.apply(compressedEnd, res, [chunk, encoding]);
1585
+ } catch (error) {
1586
+ if (finish) res.removeListener("finish", finish);
1587
+ throw error;
1588
+ }
1589
+ return res;
1590
+ };
1591
+ next();
1592
+ });
1593
+ };
1566
1594
  }
1567
1595
  /**
1568
1596
  * 创建 JSON 解析中间件
@@ -1615,7 +1643,7 @@ function resolveFetchHandler(module) {
1615
1643
  }
1616
1644
  var package_default = {
1617
1645
  name: "isr-engine",
1618
- version: "4.4.0",
1646
+ version: "4.4.1",
1619
1647
  description: "ISR/SSG/Fallback rendering orchestration on Vite + React 19 RSC.",
1620
1648
  license: "UNLICENSED",
1621
1649
  repository: {
@@ -4961,7 +4989,7 @@ function createIsrCacheMiddleware(explicitConfig, options = {}) {
4961
4989
  development: true
4962
4990
  }));
4963
4991
  try {
4964
- const inspector = opsConfig.inventory.enabled ? (await import("./createCacheInspectorMiddleware-DUYq46J4.js")).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4992
+ const inspector = opsConfig.inventory.enabled ? (await import("./createCacheInspectorMiddleware-BKpkkkJ8.js")).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4965
4993
  handler = nextHandler;
4966
4994
  server.middlewares.use((req, res, next) => {
4967
4995
  if (handler !== nextHandler) return next();
@@ -5522,11 +5550,15 @@ function captureAndStore(res, maxBytes, cacheKey, onFinish) {
5522
5550
  let chunks = [];
5523
5551
  let totalBytes = 0;
5524
5552
  let overflow = false;
5553
+ let captureEnded = false;
5525
5554
  const originalWrite = res.write.bind(res);
5526
5555
  const originalEnd = res.end.bind(res);
5527
- const ingest = (chunk) => {
5556
+ const ingest = (chunk, encoding) => {
5528
5557
  if (!chunk || overflow) return;
5529
- const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
5558
+ let buf;
5559
+ if (typeof chunk === "string") buf = Buffer.from(chunk, typeof encoding === "string" ? encoding : void 0);
5560
+ else if (isUint8Array(chunk)) buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
5561
+ else return;
5530
5562
  totalBytes += buf.length;
5531
5563
  if (maxBytes > 0 && totalBytes > maxBytes) {
5532
5564
  overflow = true;
@@ -5536,12 +5568,18 @@ function captureAndStore(res, maxBytes, cacheKey, onFinish) {
5536
5568
  }
5537
5569
  if (chunks) chunks.push(buf);
5538
5570
  };
5539
- res.write = function patchedWrite(chunk, ...args) {
5540
- ingest(chunk);
5541
- return originalWrite(chunk, ...args);
5571
+ res.write = function patchedWrite(...args) {
5572
+ if (!captureEnded && !res.destroyed && !res.writableEnded) ingest(args[0], args[1]);
5573
+ return originalWrite(...args);
5542
5574
  };
5543
- res.end = function patchedEnd(chunk, ...args) {
5544
- ingest(chunk);
5575
+ res.end = function patchedEnd(...args) {
5576
+ const shouldCapture = !captureEnded && !res.destroyed && !res.writableEnded;
5577
+ if (shouldCapture) {
5578
+ ingest(args[0], args[1]);
5579
+ captureEnded = true;
5580
+ }
5581
+ const response = originalEnd(...args);
5582
+ if (!shouldCapture || res.destroyed) return response;
5545
5583
  try {
5546
5584
  const headers = { ...res.getHeaders() };
5547
5585
  delete headers["content-encoding"];
@@ -5558,7 +5596,7 @@ function captureAndStore(res, maxBytes, cacheKey, onFinish) {
5558
5596
  } catch (err) {
5559
5597
  logger$5.warn("ISR cache 存储回调异常:", err);
5560
5598
  }
5561
- return originalEnd(chunk, ...args);
5599
+ return response;
5562
5600
  };
5563
5601
  }
5564
5602
  function isCacheableMode(mode) {
@@ -7050,9 +7088,9 @@ function createLocaleRedirectMiddleware(options) {
7050
7088
  }
7051
7089
  const cookieLocale = (path === "/" ? readLocalePreference(req, i18n) : void 0) ?? readCookie(req, "locale", "first");
7052
7090
  const target = (cookieLocale && localePrefixes.has(cookieLocale) ? cookieLocale : null) || selectAcceptableLocale(typeof req.headers["accept-language"] === "string" ? req.headers["accept-language"] : null, i18n);
7053
- res.set("Cache-Control", "no-store");
7091
+ res.set("Cache-Control", "no-store").vary("Accept-Language").vary("Cookie");
7054
7092
  if (target === null) {
7055
- res.vary("Accept-Language").vary("Cookie").status(406).end();
7093
+ res.status(406).end();
7056
7094
  return;
7057
7095
  }
7058
7096
  const prefix = localePrefixes.get(target);
@@ -7620,7 +7658,7 @@ async function createProductionRuntime(config, options = {}) {
7620
7658
  });
7621
7659
  cleanups.push(() => cache.destroy());
7622
7660
  if (opsConfig.inventory.enabled) {
7623
- const { createCacheInspectorMiddleware } = await import("./createCacheInspectorMiddleware-DUYq46J4.js");
7661
+ const { createCacheInspectorMiddleware } = await import("./createCacheInspectorMiddleware-BKpkkkJ8.js");
7624
7662
  app.use(createCacheInspectorMiddleware(cache, opsConfig));
7625
7663
  logger$8.info("🔍 ISR cache inventory 已启用:GET /__isr/cache/inventory");
7626
7664
  }
@@ -8536,4 +8574,4 @@ async function createISRApp(appOption) {
8536
8574
  }
8537
8575
  export { parseComponents as $, invalidatorRunsTotal as A, InternalStrategies as B, createCoherentCacheStore as C, loadConfig as D, getOpsRequestLimiter as E, getFallbackChain as F, DEFAULT_PORT as G, extractSsgRoutes as H, getRouteFallbackChain as I, DEFAULT_SCAN_CONFIG as J, package_default as K, matchRoutePattern as L, recordHttpRequest as M, createHybridCacheStore as N, createPrometheusMetricsMiddleware as O, createMemoryCacheStore as P, parseComponentFromFile as Q, resolveRenderMode as R, MemoryCacheAdapter as S, createOpsAuthMiddleware as T, spiderSsgRoutes as U, RenderModes as V, logger$8 as W, scanProject as X, scanComponents as Y, scanRoutes as Z, requestPinnedImage as _, closeServer as a, isDev as at, RedisInvalidationBus as b, prepareProductionBuild as c, CacheCleanup as ct, SEOEngine as d, parseRouteFromFile as et, createSEOEngine as f, createImagePlugin as g, createImageMiddleware as h, startAppServer as i, readDirRecursive as it, promRegistry as j, invalidatorFailuresTotal as k, generateStaticCspManifest as l, Logger as lt, mergeSEOConfig as m, ISREngine as n, isCodeFile as nt, startServer as o, isProd as ot, DEFAULT_SEO_CONFIG as p, resolveFetchHandler as q, shutdownServer as r, isTestFile as rt, createProductionRuntime as s, getEnv as st, createISRApp as t, parseRoutes as tt, createABVariantMiddleware as u, resolveImageOptions as ut, createIsrCacheHandler as v, createDevAssetRequestMiddleware as w, RedisCacheAdapter as x, createIsrCacheMiddleware as y, FallbackChain as z };
8538
8576
 
8539
- //# sourceMappingURL=createISRApp-yBEBvYD5.js.map
8577
+ //# sourceMappingURL=createISRApp-BX9sh7P6.js.map