isr-engine 3.1.1 → 3.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/dist/cli/cli.js +1 -1
  2. package/dist/config/loadConfig.d.ts.map +1 -1
  3. package/dist/{createCacheInspectorMiddleware-BpMpmP_a.js → createCacheInspectorMiddleware-GgzKVkq2.js} +2 -2
  4. package/dist/{createCacheInspectorMiddleware-BpMpmP_a.js.map → createCacheInspectorMiddleware-GgzKVkq2.js.map} +1 -1
  5. package/dist/{createISRApp-D88Xp0Fb.js → createISRApp-DPD3Er4F.js} +25 -33
  6. package/dist/createISRApp-DPD3Er4F.js.map +1 -0
  7. package/dist/{createImagePlugin-Cdz3QfrJ.js → createImagePlugin-QNvY9vPB.js} +2 -2
  8. package/dist/{createImagePlugin-Cdz3QfrJ.js.map → createImagePlugin-QNvY9vPB.js.map} +1 -1
  9. package/dist/defaults/runtime/seo-runtime.d.ts +2 -0
  10. package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -1
  11. package/dist/isr-engine.js +3 -3
  12. package/dist/isr-engine.js.map +1 -1
  13. package/dist/runtime/routes.d.ts +18 -2
  14. package/dist/runtime/routes.d.ts.map +1 -1
  15. package/package.json +20 -28
  16. package/src/defaults/runtime/defineClientEntry.tsx +26 -15
  17. package/src/defaults/runtime/defineServerEntry.tsx +47 -44
  18. package/src/defaults/runtime/request.tsx +2 -2
  19. package/src/defaults/runtime/seo-runtime.ts +26 -30
  20. package/src/runtime/routes.tsx +102 -94
  21. package/dist/Logger-DqBS_3v8.cjs +0 -184
  22. package/dist/Logger-DqBS_3v8.cjs.map +0 -1
  23. package/dist/abVariantContext-BvAMuhjj.cjs +0 -510
  24. package/dist/abVariantContext-BvAMuhjj.cjs.map +0 -1
  25. package/dist/adapters/observability/index.cjs +0 -152
  26. package/dist/adapters/observability/index.cjs.map +0 -1
  27. package/dist/adapters/runtime/index.cjs +0 -100
  28. package/dist/adapters/runtime/index.cjs.map +0 -1
  29. package/dist/cli/cli.cjs +0 -372
  30. package/dist/cli/cli.cjs.map +0 -1
  31. package/dist/config/defineConfig.cjs +0 -26
  32. package/dist/config/defineConfig.cjs.map +0 -1
  33. package/dist/createCacheInspectorMiddleware-DvRhF_-D.cjs +0 -112
  34. package/dist/createCacheInspectorMiddleware-DvRhF_-D.cjs.map +0 -1
  35. package/dist/createISRApp-D88Xp0Fb.js.map +0 -1
  36. package/dist/createISRApp-tRkpdmpp.cjs +0 -8232
  37. package/dist/createISRApp-tRkpdmpp.cjs.map +0 -1
  38. package/dist/createImagePlugin-DomuzpoI.cjs +0 -487
  39. package/dist/createImagePlugin-DomuzpoI.cjs.map +0 -1
  40. package/dist/defaults/auto-observability.cjs +0 -147
  41. package/dist/defaults/auto-observability.cjs.map +0 -1
  42. package/dist/defaults/runtime/defineSiteHooks.cjs +0 -11
  43. package/dist/defineSiteHooks-BuhvW5YB.cjs +0 -770
  44. package/dist/defineSiteHooks-BuhvW5YB.cjs.map +0 -1
  45. package/dist/error500-template-BvZmvKoa.cjs +0 -63
  46. package/dist/error500-template-BvZmvKoa.cjs.map +0 -1
  47. package/dist/i18n-CS5QhOO0.cjs +0 -221
  48. package/dist/i18n-CS5QhOO0.cjs.map +0 -1
  49. package/dist/image/index.cjs +0 -93
  50. package/dist/image/index.cjs.map +0 -1
  51. package/dist/isr-engine.cjs +0 -3332
  52. package/dist/isr-engine.cjs.map +0 -1
  53. package/dist/rolldown-runtime-DakpK96I.cjs +0 -43
  54. package/dist/rsc/browser.cjs +0 -109
  55. package/dist/rsc/browser.cjs.map +0 -1
  56. package/dist/rsc/index.cjs +0 -32
  57. package/dist/rsc-CYT6B6bf.cjs +0 -237
  58. package/dist/rsc-CYT6B6bf.cjs.map +0 -1
package/dist/cli/cli.js CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { H as DEFAULT_PORT, U as package_default, V as logger, d as startServer, f as createProductionRuntime, p as prepareProductionBuild, t as createISRApp, u as closeServer, w as loadConfig } from "../createISRApp-D88Xp0Fb.js";
2
+ import { H as DEFAULT_PORT, U as package_default, V as logger, d as startServer, f as createProductionRuntime, p as prepareProductionBuild, t as createISRApp, u as closeServer, w as loadConfig } from "../createISRApp-DPD3Er4F.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 +1 @@
1
- {"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../src/config/loadConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AASzC,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqCpF;AAmED;;GAEG;AACH,wBAAgB,gBAAgB,SAE/B"}
1
+ {"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../src/config/loadConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AASzC,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqCpF;AAkED;;GAEG;AACH,wBAAgB,gBAAgB,SAE/B"}
@@ -1,4 +1,4 @@
1
- import { C as getOpsRequestLimiter, S as createOpsAuthMiddleware } from "./createISRApp-D88Xp0Fb.js";
1
+ import { C as getOpsRequestLimiter, S as createOpsAuthMiddleware } from "./createISRApp-DPD3Er4F.js";
2
2
  import express from "express";
3
3
  /** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */
4
4
  var HARD_LIMIT = 1e3;
@@ -107,4 +107,4 @@ function createCacheInspectorMiddleware(handler, opsConfig) {
107
107
  //#endregion
108
108
  export { createCacheInspectorMiddleware };
109
109
 
110
- //# sourceMappingURL=createCacheInspectorMiddleware-BpMpmP_a.js.map
110
+ //# sourceMappingURL=createCacheInspectorMiddleware-GgzKVkq2.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"createCacheInspectorMiddleware-BpMpmP_a.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-GgzKVkq2.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":";;;AAmDA,IAAM,aAAa;;AAEnB,IAAM,gBAAgB;;AAEtB,IAAM,gBAAgB;;AAEtB,IAAM,mBAAmB;AAIzB,SAAS,kBAAkB,KAAkC;CAC3D,IAAI,QAAQ,WAAW,QAAQ,WAAW,QAAQ,aAAa,QAAQ,OAAO,OAAO;CACrF,OAAO;AACT;AAEA,SAAS,WAAW,KAA4B;CAC9C,IAAI,CAAC,KAAK,OAAO;CACjB,MAAM,IAAI,SAAS,KAAK,EAAE;CAC1B,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,KAAK,GAAG,OAAO;CAC1C,OAAO,KAAK,IAAI,GAAG,UAAU;AAC/B;AAEA,SAAS,aAAa,KAA4B;CAChD,IAAI,CAAC,KAAK,OAAO;CACjB,MAAM,IAAI,SAAS,KAAK,EAAE;CAC1B,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,KAAK,GAAG,OAAO;CAC1C,OAAO,KAAK,IAAI,GAAG,aAAa;AAClC;AAEA,SAAS,cAAc,KAAoB,cAAgC;CACzE,IAAI,QAAQ,MAAM,OAAO;CACzB,MAAM,IAAI,IAAI,YAAY;CAC1B,IAAI,MAAM,UAAU,MAAM,OAAO,MAAM,OAAO,OAAO;CACrD,IAAI,MAAM,WAAW,MAAM,OAAO,MAAM,MAAM,OAAO;CACrD,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,+BACd,SACA,WAC4B;CAE5B,IAAI,CAAC,UAAU,UAAU,SACvB,QAAQ,MAAM,MAAM,SAAS,KAAK;CAGpC,MAAM,OAAO,wBAAwB,aAAa,SAAS;CAC3D,MAAM,UAAU,QAAQ,OAAO;CAC/B,QAAQ,IAAI,qBAAqB,SAAS,CAAC;CAC3C,QAAQ,IAAI,IAAI;CAChB,QAAQ,KAAK,KAAK,QAAQ;EACxB,QAAa,KAAK,KAAK,OAAO;CAChC,CAAC;CAED,QAAQ,KAAsB,KAAqB,SAA+B;EAChF,IAAI,IAAI,WAAW,SAAS,IAAI,WAAW,QAAQ;GACjD,KAAK;GACL;EACF;EAIA,KAFY,IAAI,OAAO,IAAA,CACF,MAAM,GAAG,CAAC,CAAC,OAAA,0BACO;GACrC,KAAK;GACL;EACF;EAGA,QAAQ,KAAwB,KAAyB,IAAI;CAC/D;CAEA,eAAe,QACb,KACA,KACA,GACe;EACf,IAAI;GACF,MAAM,WAAW,EAAE,mBAAmB;GACtC,MAAM,SAAS,IAAI,iBAAiB,IAAI,OAAO,GAAA,CAAI,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE;GACtE,MAAM,eAAe,kBAAkB,OAAO,IAAI,QAAQ,CAAC;GAC3D,MAAM,QAAQ,WAAW,OAAO,IAAI,OAAO,CAAC;GAC5C,MAAM,YAAY,cAAc,OAAO,IAAI,IAAI,GAAG,IAAI;GACtD,MAAM,UAAU,aAAa,OAAO,IAAI,SAAS,CAAC;GAElD,MAAM,WACJ,iBAAiB,QACb,SAAS,UACT,SAAS,QAAQ,QAAO,MAAK,EAAE,WAAW,YAAY;GAK5D,MAAM,UADS,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,aAAa,EAAE,UAC7C,CAAA,CAAO,MAAM,GAAG,KAAK;GAErC,MAAM,sBAAsB,CAAC,GAAG,SAAS,aAAa,CAAC,CAAC,MACrD,GAAG,MAAM,EAAE,oBAAoB,EAAE,iBACpC;GAGA,MAAM,UACJ,aAAa,SAAS,YAAY,WAAW,MAAM,EAAE,gBAAgB,OAAO,IAAI,CAAC;GAEnF,MAAM,OAAO,KAAK,UAChB;IACE,KAAK,SAAS;IACd,SAAS,SAAS;IAClB,MAAM,SAAS;IACf,KAAK,SAAS;IACd,QAAQ;KAAE,QAAQ;KAAc;KAAO,IAAI;KAAW;IAAQ;IAC9D,UAAU,SAAS;IACnB,SAAS;IACT,eAAe;IACf,IAAI;KAAE,SAAS,QAAQ;KAAQ,OAAO;IAAQ;GAChD,GACA,MACA,CACF;GAEA,IAAI,IAAI,aAAa;GACrB,IAAI,aAAa;GACjB,IAAI,UAAU,gBAAgB,iCAAiC;GAC/D,IAAI,UAAU,iBAAiB,UAAU;GACzC,IAAI,IAAI,IAAI;EACd,SAAS,KAAK;GACZ,IAAI,IAAI,aAAa;GACrB,IAAI,aAAa;GACjB,IAAI,UAAU,gBAAgB,iCAAiC;GAC/D,IAAI,IAAI,KAAK,UAAU,EAAE,OAAQ,IAAc,QAAQ,CAAC,CAAC;EAC3D;CACF;AACF"}
@@ -1511,7 +1511,7 @@ function resolveFetchHandler(module) {
1511
1511
  }
1512
1512
  var package_default = {
1513
1513
  name: "isr-engine",
1514
- version: "3.1.1",
1514
+ version: "3.1.3",
1515
1515
  description: "ISR/SSG/Fallback rendering orchestration on Vite + React 19 RSC.",
1516
1516
  license: "UNLICENSED",
1517
1517
  repository: {
@@ -1525,7 +1525,7 @@ var package_default = {
1525
1525
  "registry": "https://registry.npmjs.org/"
1526
1526
  },
1527
1527
  type: "module",
1528
- main: "./dist/isr-engine.cjs",
1528
+ main: "./dist/isr-engine.js",
1529
1529
  module: "./dist/isr-engine.js",
1530
1530
  types: "./dist/index.d.ts",
1531
1531
  bin: { "isr-engine": "./dist/cli/cli.js" },
@@ -1544,47 +1544,39 @@ var package_default = {
1544
1544
  ],
1545
1545
  exports: {
1546
1546
  ".": {
1547
- "import": "./dist/isr-engine.js",
1548
- "require": "./dist/isr-engine.cjs",
1549
- "types": "./dist/index.d.ts"
1547
+ "types": "./dist/index.d.ts",
1548
+ "default": "./dist/isr-engine.js"
1550
1549
  },
1551
1550
  "./rsc": {
1551
+ "types": "./dist/rsc/index.d.ts",
1552
1552
  "browser": "./dist/rsc/browser.js",
1553
- "import": "./dist/rsc/index.js",
1554
- "require": "./dist/rsc/index.cjs",
1555
- "types": "./dist/rsc/index.d.ts"
1553
+ "default": "./dist/rsc/index.js"
1556
1554
  },
1557
1555
  "./server-entry": { "default": "./src/defaults/runtime/defineServerEntry.tsx" },
1558
1556
  "./client-entry": { "default": "./src/defaults/runtime/defineClientEntry.tsx" },
1559
1557
  "./auto-observability": {
1560
1558
  "types": "./dist/defaults/auto-observability.d.ts",
1561
- "import": "./dist/defaults/auto-observability.js",
1562
- "require": "./dist/defaults/auto-observability.cjs"
1559
+ "default": "./dist/defaults/auto-observability.js"
1563
1560
  },
1564
1561
  "./site-hooks": {
1565
1562
  "types": "./dist/defaults/runtime/defineSiteHooks.d.ts",
1566
- "import": "./dist/defaults/runtime/defineSiteHooks.js",
1567
- "require": "./dist/defaults/runtime/defineSiteHooks.cjs"
1563
+ "default": "./dist/defaults/runtime/defineSiteHooks.js"
1568
1564
  },
1569
1565
  "./config": {
1570
1566
  "types": "./dist/config/defineConfig.d.ts",
1571
- "import": "./dist/config/defineConfig.js",
1572
- "require": "./dist/config/defineConfig.cjs"
1567
+ "default": "./dist/config/defineConfig.js"
1573
1568
  },
1574
1569
  "./adapters/observability": {
1575
- "import": "./dist/adapters/observability/index.js",
1576
- "require": "./dist/adapters/observability/index.cjs",
1577
- "types": "./dist/adapters/observability/index.d.ts"
1570
+ "types": "./dist/adapters/observability/index.d.ts",
1571
+ "default": "./dist/adapters/observability/index.js"
1578
1572
  },
1579
1573
  "./adapters/runtime": {
1580
- "import": "./dist/adapters/runtime/index.js",
1581
- "require": "./dist/adapters/runtime/index.cjs",
1582
- "types": "./dist/adapters/runtime/index.d.ts"
1574
+ "types": "./dist/adapters/runtime/index.d.ts",
1575
+ "default": "./dist/adapters/runtime/index.js"
1583
1576
  },
1584
1577
  "./image": {
1585
- "import": "./dist/image/index.js",
1586
- "require": "./dist/image/index.cjs",
1587
- "types": "./dist/runtime/Image.d.ts"
1578
+ "types": "./dist/runtime/Image.d.ts",
1579
+ "default": "./dist/image/index.js"
1588
1580
  },
1589
1581
  "./runtime": {
1590
1582
  "types": "./dist/runtime/index.d.ts",
@@ -1593,7 +1585,7 @@ var package_default = {
1593
1585
  "./package.json": "./package.json"
1594
1586
  },
1595
1587
  scripts: {
1596
- "build": "vite build && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && chmod +x dist/cli/cli.js dist/cli/cli.cjs",
1588
+ "build": "vite build && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && chmod +x dist/cli/cli.js",
1597
1589
  "watch": "vite build --watch",
1598
1590
  "clean": "rimraf dist",
1599
1591
  "lint": "eslint . --ext .ts,.tsx,.js,.jsx",
@@ -1607,13 +1599,13 @@ var package_default = {
1607
1599
  "bench": "node bench/runner.mjs",
1608
1600
  "check": "pnpm run type-check && pnpm run lint && pnpm run test",
1609
1601
  "audit:security": "pnpm audit --registry=https://registry.npmjs.org --audit-level=low",
1602
+ "version": "pnpm run build",
1610
1603
  "prepublishOnly": "pnpm run audit:security",
1611
1604
  "release": "semantic-release",
1612
1605
  "prepare": "husky",
1613
- "test:package": "node scripts/check-package-exports.mjs",
1614
- "test:package:installed": "node scripts/check-installed-package.mjs",
1615
- "test:workers": "tsc --noEmit -p scripts/fixtures/tsconfig.json && node scripts/check-workers-runtime.mjs",
1616
- "test:release": "node scripts/check-release.mjs"
1606
+ "test:package": "node e2e/package/check.mjs",
1607
+ "test:workers": "tsc -p e2e/workers && node --test e2e/workers/runtime.test.mjs",
1608
+ "test:release": "node --test e2e/release-policy.test.mjs"
1617
1609
  },
1618
1610
  engines: { "node": "24.15.0" },
1619
1611
  packageManager: "pnpm@9.15.9",
@@ -2768,7 +2760,7 @@ async function resolveImportPath(filePath, options) {
2768
2760
  name: "externalize-except-engine",
2769
2761
  setup(build) {
2770
2762
  build.onResolve({ filter: /^[^./]/ }, (args) => {
2771
- if (/^isr-engine(?:\/|$)/.test(args.path)) return null;
2763
+ if (args.kind === "entry-point" || path$1.isAbsolute(args.path) || /^isr-engine(?:\/|$)/.test(args.path)) return null;
2772
2764
  return {
2773
2765
  path: args.path,
2774
2766
  external: true
@@ -4819,7 +4811,7 @@ function createIsrCacheMiddleware(explicitConfig, options = {}) {
4819
4811
  development: true
4820
4812
  }));
4821
4813
  try {
4822
- const inspector = opsConfig.inventory.enabled ? (await import("./createCacheInspectorMiddleware-BpMpmP_a.js")).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4814
+ const inspector = opsConfig.inventory.enabled ? (await import("./createCacheInspectorMiddleware-GgzKVkq2.js")).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4823
4815
  handler = nextHandler;
4824
4816
  server.middlewares.use((req, res, next) => {
4825
4817
  if (handler !== nextHandler) return next();
@@ -6087,7 +6079,7 @@ async function createProductionRuntime(config, options = {}) {
6087
6079
  app.use("/assets", (_req, res) => {
6088
6080
  res.status(404).set("Cache-Control", "no-store").end();
6089
6081
  });
6090
- const { createImageMiddleware } = await import("./createImagePlugin-Cdz3QfrJ.js").then((n) => n.r);
6082
+ const { createImageMiddleware } = await import("./createImagePlugin-QNvY9vPB.js").then((n) => n.r);
6091
6083
  const { resolveImageOptions } = await Promise.resolve().then(() => resolveImageOptions_exports);
6092
6084
  app.use(createImageMiddleware(resolveImageOptions(config.runtime.images), {}, clientDir));
6093
6085
  const { createAutoCacheStore } = await Promise.resolve().then(() => createAutoCacheStore_exports);
@@ -6160,7 +6152,7 @@ async function createProductionRuntime(config, options = {}) {
6160
6152
  });
6161
6153
  cleanups.push(() => cache.destroy());
6162
6154
  if (opsConfig.inventory.enabled) {
6163
- const { createCacheInspectorMiddleware } = await import("./createCacheInspectorMiddleware-BpMpmP_a.js");
6155
+ const { createCacheInspectorMiddleware } = await import("./createCacheInspectorMiddleware-GgzKVkq2.js");
6164
6156
  app.use(createCacheInspectorMiddleware(cache, opsConfig));
6165
6157
  logger$8.info("🔍 ISR cache inventory 已启用:GET /__isr/cache/inventory");
6166
6158
  }
@@ -7851,4 +7843,4 @@ async function createISRApp(appOption) {
7851
7843
  //#endregion
7852
7844
  export { isCodeFile as $, createHybridCacheStore as A, spiderSsgRoutes as B, getOpsRequestLimiter as C, invalidatorRunsTotal as D, invalidatorFailuresTotal as E, resolveRenderMode as F, DEFAULT_SCAN_CONFIG as G, DEFAULT_PORT as H, FallbackChain as I, scanRoutes as J, scanComponents as K, InternalStrategies as L, getFallbackChain as M, getRouteFallbackChain as N, promRegistry as O, matchRoutePattern as P, parseRoutes as Q, RenderModes as R, createOpsAuthMiddleware as S, createPrometheusMetricsMiddleware as T, package_default as U, logger$8 as V, resolveFetchHandler as W, parseComponents as X, parseComponentFromFile as Y, parseRouteFromFile as Z, RedisInvalidationBus as _, DEFAULT_SEO_CONFIG as a, CacheCleanup as at, createCoherentCacheStore as b, startAppServer as c, startServer as d, isTestFile as et, createProductionRuntime as f, createIsrCacheMiddleware as g, createIsrCacheHandler as h, createSEOEngine as i, getEnv as it, createMemoryCacheStore as j, recordHttpRequest as k, createABVariantMiddleware as l, generateStaticCspManifest as m, ISREngine as n, isDev as nt, mergeSEOConfig as o, assertDistinctHtmlRouteIdentities as ot, prepareProductionBuild as p, scanProject as q, SEOEngine as r, isProd as rt, shutdownServer as s, resolveImageOptions as st, createISRApp as t, readDirRecursive as tt, closeServer as u, RedisCacheAdapter as v, loadConfig as w, createDevAssetRequestMiddleware as x, MemoryCacheAdapter as y, extractSsgRoutes as z };
7853
7845
 
7854
- //# sourceMappingURL=createISRApp-D88Xp0Fb.js.map
7846
+ //# sourceMappingURL=createISRApp-DPD3Er4F.js.map