isr-engine 4.1.0 → 4.3.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 (104) hide show
  1. package/README.md +9 -0
  2. package/dist/CacheTagContext-Btmq8KCD.js +69 -0
  3. package/dist/CacheTagContext-Btmq8KCD.js.map +1 -0
  4. package/dist/{abVariantContext-CGBlCt0q.js → abVariantContext-yWZOqscY.js} +118 -38
  5. package/dist/abVariantContext-yWZOqscY.js.map +1 -0
  6. package/dist/cache/RedisInvalidationBus.d.ts.map +1 -1
  7. package/dist/cache/RedisResponseCacheBackend.d.ts +1 -0
  8. package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -1
  9. package/dist/cache/ResponseCacheBackend.d.ts +6 -0
  10. package/dist/cache/ResponseCacheBackend.d.ts.map +1 -1
  11. package/dist/cli/cli.js +1 -1
  12. package/dist/config/defineConfig.js +1 -1
  13. package/dist/context/CacheTagContext.d.ts +10 -0
  14. package/dist/context/CacheTagContext.d.ts.map +1 -0
  15. package/dist/{createCacheInspectorMiddleware-D6c-CINz.js → createCacheInspectorMiddleware-glgtcBcQ.js} +2 -2
  16. package/dist/{createCacheInspectorMiddleware-D6c-CINz.js.map → createCacheInspectorMiddleware-glgtcBcQ.js.map} +1 -1
  17. package/dist/createCachedFetcher-CgJscexq.js +186 -0
  18. package/dist/createCachedFetcher-CgJscexq.js.map +1 -0
  19. package/dist/{createISRApp-DTlZvKBm.js → createISRApp-BG-s3uuL.js} +356 -162
  20. package/dist/createISRApp-BG-s3uuL.js.map +1 -0
  21. package/dist/defaults/runtime/contentRevalidation.d.ts +26 -0
  22. package/dist/defaults/runtime/contentRevalidation.d.ts.map +1 -0
  23. package/dist/defaults/runtime/createCachedFetcher.d.ts +8 -2
  24. package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -1
  25. package/dist/defaults/runtime/defineSiteHooks.d.ts +4 -7
  26. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -1
  27. package/dist/defaults/runtime/defineSiteHooks.js +655 -2
  28. package/dist/defaults/runtime/defineSiteHooks.js.map +1 -0
  29. package/dist/defaults/runtime/locale-links.client.d.ts.map +1 -1
  30. package/dist/defaults/runtime/renderCancellation.d.ts +3 -0
  31. package/dist/defaults/runtime/renderCancellation.d.ts.map +1 -0
  32. package/dist/engine/ISREngine.d.ts.map +1 -1
  33. package/dist/engine/seo/SEOEngine.d.ts +3 -0
  34. package/dist/engine/seo/SEOEngine.d.ts.map +1 -1
  35. package/dist/engine/seo/resolveSeoConfig.d.ts +6 -0
  36. package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -1
  37. package/dist/{i18n-B2mWmifk.js → i18n-BZpAOZeO.js} +3 -2
  38. package/dist/{i18n-B2mWmifk.js.map → i18n-BZpAOZeO.js.map} +1 -1
  39. package/dist/index.d.ts +2 -2
  40. package/dist/index.d.ts.map +1 -1
  41. package/dist/isr/ISRRoutes.d.ts +2 -0
  42. package/dist/isr/ISRRoutes.d.ts.map +1 -1
  43. package/dist/isr-engine.js +7 -7
  44. package/dist/middlewares/LocaleRedirect.d.ts +4 -3
  45. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -1
  46. package/dist/plugin/coherentCacheStore.d.ts.map +1 -1
  47. package/dist/plugin/isrCacheMiddleware.d.ts +7 -6
  48. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -1
  49. package/dist/plugin/isrCacheStore.d.ts +2 -0
  50. package/dist/plugin/isrCacheStore.d.ts.map +1 -1
  51. package/dist/rsc/browser.d.ts +3 -0
  52. package/dist/rsc/browser.d.ts.map +1 -1
  53. package/dist/rsc/browser.js +4 -9
  54. package/dist/rsc/browser.js.map +1 -1
  55. package/dist/rsc/cacheTag.d.ts +1 -8
  56. package/dist/rsc/cacheTag.d.ts.map +1 -1
  57. package/dist/rsc/index.d.ts +1 -1
  58. package/dist/rsc/index.d.ts.map +1 -1
  59. package/dist/rsc/index.js +4 -3
  60. package/dist/rsc/revalidate.d.ts +18 -9
  61. package/dist/rsc/revalidate.d.ts.map +1 -1
  62. package/dist/{rsc-DWwcqD4W.js → rsc-BYq2vvnh.js} +2 -2
  63. package/dist/{rsc-DWwcqD4W.js.map → rsc-BYq2vvnh.js.map} +1 -1
  64. package/dist/runtime/LocaleLink.d.ts.map +1 -1
  65. package/dist/runtime/i18n.d.ts +3 -0
  66. package/dist/runtime/i18n.d.ts.map +1 -1
  67. package/dist/runtime/localePreference.d.ts +7 -0
  68. package/dist/runtime/localePreference.d.ts.map +1 -0
  69. package/dist/server/contentRevalidationRoute.d.ts +4 -0
  70. package/dist/server/contentRevalidationRoute.d.ts.map +1 -0
  71. package/dist/server/manager.d.ts.map +1 -1
  72. package/dist/server/opsConfig.d.ts +6 -1
  73. package/dist/server/opsConfig.d.ts.map +1 -1
  74. package/dist/server/productionRuntime.d.ts +2 -0
  75. package/dist/server/productionRuntime.d.ts.map +1 -1
  76. package/dist/server/publishedSitemap.d.ts +8 -0
  77. package/dist/server/publishedSitemap.d.ts.map +1 -0
  78. package/dist/types/ISRConfig.d.ts +27 -0
  79. package/dist/types/ISRConfig.d.ts.map +1 -1
  80. package/dist/utils/cookie.d.ts +2 -2
  81. package/dist/utils/cookie.d.ts.map +1 -1
  82. package/dist/utils/isrPath.d.ts +6 -0
  83. package/dist/utils/isrPath.d.ts.map +1 -0
  84. package/package.json +2 -2
  85. package/src/context/CacheTagContext.ts +20 -0
  86. package/src/defaults/entry.server.ssr.tsx +10 -0
  87. package/src/defaults/runtime/contentRevalidation.ts +96 -0
  88. package/src/defaults/runtime/createCachedFetcher.ts +76 -20
  89. package/src/defaults/runtime/defineServerEntry.tsx +30 -29
  90. package/src/defaults/runtime/defineSiteHooks.ts +117 -80
  91. package/src/defaults/runtime/locale-links.client.ts +14 -4
  92. package/src/defaults/runtime/renderCancellation.ts +10 -0
  93. package/src/runtime/LocaleLink.tsx +8 -2
  94. package/src/runtime/i18n.ts +4 -0
  95. package/src/runtime/localePreference.ts +36 -0
  96. package/src/types/ISRConfig.ts +29 -0
  97. package/src/utils/cookie.ts +11 -4
  98. package/src/utils/isrPath.ts +24 -0
  99. package/dist/abVariantContext-CGBlCt0q.js.map +0 -1
  100. package/dist/cookie-DcUeYm6E.js +0 -42
  101. package/dist/cookie-DcUeYm6E.js.map +0 -1
  102. package/dist/createISRApp-DTlZvKBm.js.map +0 -1
  103. package/dist/defineSiteHooks-iwLiVChy.js +0 -716
  104. package/dist/defineSiteHooks-iwLiVChy.js.map +0 -1
package/README.md CHANGED
@@ -126,6 +126,14 @@ TTL 与 SWR 单位为秒。`routes` 控制渲染策略;页面路由可使用 `
126
126
  - 授权头、普通业务 Cookie,以及 `private`/`no-store` 等响应会触发缓存保护;不要依赖这些保护代替路由策略。`anon` 与实验 Cookie 有专门的共享缓存规则。
127
127
  - Server Component 使用 `cacheTag('site-content')` 声明依赖;数据更新成功后,在受业务鉴权保护的服务端代码中 `await revalidateTag('site-content')` 或 `await revalidatePath('/about')`,从 `isr-engine/rsc` 导入。
128
128
 
129
+ 发布、撤稿或索引状态更新提交后,在站点引擎进程中调用 `isr-engine/rsc` 的 `revalidateContent()`。调用缺少活动引擎时会抛错。独立后台可在 Node 生产站点启用 `server.ops.contentRevalidation: true` 并配置 `server.ops.authToken`,向 `POST /__isr/content/revalidate` 发送相同 JSON 参数。请求携带 Bearer 运维令牌,失效完成后返回 `204`。
130
+
131
+ `paths` 使用实际页面路径,`tags` 失效声明了对应标签的页面,`locales` 指定字典语言,`sitemap: true` 刷新站点地图。使用 `{ localizedPaths: ['/work/arcane'], locales: ['ja'] }` 可按站点语言配置将业务路径展开为 `/ja/work/arcane`,同时保留其他语言的 ISR 页面缓存。引擎先刷新元数据,再失效页面响应。其他实例的进程内元数据通过 Redis 广播刷新,断连后可在回放或缓存到期时更新。
132
+
133
+ `runtime.seo.sitemap.load({ services })` 从已提交的数据批量读取完整目录。每条包含站内绝对路径 `path`、`status`,可带 `noindex` 和真实内容更新时间 `modifiedTime`。引擎只输出已发布且可索引的条目,缺少更新时间时省略 `lastmod`。单份 sitemap 上限为 50,000 个 URL 和 50 MiB。
134
+
135
+ 临时降级或使用过期字典及 SEO 数据的响应跳过 ISR 写入。动态 sitemap 刷新失败时,默认可在目录过期后的 5 分钟内沿用上一份有效结果,可用 `runtime.seo.sitemap.staleIfErrorMs` 调整。发布事件会丢弃旧目录,缺少可用目录时返回 `503`。
136
+
129
137
  请求期扩展可放在可选的 `src/entry.server.tsx`,默认导出 `defineAdminSiteHooks({ beforeRequest, onError })`(从 `isr-engine/site-hooks` 导入)。部署配置留在 `ssr.config.ts`;Server Component 用 `getRequestContext()` 读取 hooks 注入的上下文。
130
138
 
131
139
  `Logger.spin()` 返回 Ora 10 对象。`prefixText`、`suffixText` 可为字符串或生成函数;`color` 接受颜色名、`false` 或 `undefined`;自定义 spinner 的 `interval` 必须是正安全整数。
@@ -169,6 +177,7 @@ curl -fsS -H "x-isr-admin-token: $ISR_OPS_TOKEN" \
169
177
 
170
178
  语言切换可从 `isr-engine/runtime` 使用 `<LocaleLink locale="ja" config={i18n}>日本語</LocaleLink>`。
171
179
  组件在引擎接管后可操作,沿用当前路径、查询参数和锚点。
180
+ 使用 `runtime.i18n.prefixDefault: true` 的站点可选设 `rememberLocale: true`。`LocaleLink` 保存主动切换的语言,下次访问裸根路径时优先采用,带语言前缀的 URL 始终优先。语言协商跳转默认发送 `Cache-Control: no-store`。
172
181
 
173
182
  配置字段与默认行为见 [公共配置类型](./src/types/ISRConfig.ts) 和 [默认配置](./src/config/defaults.ts)。
174
183
 
@@ -0,0 +1,69 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ // src/defaults/runtime/contentRevalidation.ts
3
+ var KEY$1 = Symbol.for("isr-engine:content-invalidators");
4
+ var runtime$1 = globalThis;
5
+ function registerContentInvalidator(invalidate, { weak = false } = {}) {
6
+ const registry = runtime$1[KEY$1] ??= /* @__PURE__ */ new Set();
7
+ for (const entry of registry) if (typeof entry !== "function" && !entry.deref()) registry.delete(entry);
8
+ const entry = weak ? new WeakRef(invalidate) : invalidate;
9
+ registry.add(entry);
10
+ return () => {
11
+ registry.delete(entry);
12
+ };
13
+ }
14
+ /** The default scope recovers page metadata after a missed Redis notification. */
15
+ function invalidateContentCaches(scopes = {
16
+ paths: [],
17
+ tags: [],
18
+ locales: [],
19
+ sitemap: false,
20
+ allPageMetadata: true
21
+ }) {
22
+ const errors = [];
23
+ const registry = runtime$1[KEY$1];
24
+ if (!registry) return;
25
+ for (const entry of registry) {
26
+ const invalidate = typeof entry === "function" ? entry : entry.deref();
27
+ if (!invalidate) {
28
+ registry.delete(entry);
29
+ continue;
30
+ }
31
+ try {
32
+ invalidate(scopes);
33
+ } catch (error) {
34
+ errors.push(error);
35
+ }
36
+ }
37
+ if (errors.length) throw new AggregateError(errors, "Content metadata invalidation failed");
38
+ }
39
+ function normalizeContentScopes(input) {
40
+ if (!input || typeof input !== "object" || Array.isArray(input)) throw new TypeError("Invalid content revalidation scopes");
41
+ const { paths, localizedPaths, tags, locales, sitemap } = input;
42
+ function read(values) {
43
+ if (values === void 0) return [];
44
+ if (!Array.isArray(values) || Array.from(values).some((value) => typeof value !== "string" || !value.trim())) throw new TypeError("Content revalidation scopes must contain non-empty strings");
45
+ return values;
46
+ }
47
+ if (sitemap !== void 0 && typeof sitemap !== "boolean") throw new TypeError("Content revalidation sitemap must be a boolean");
48
+ return {
49
+ paths: [...new Set(read(paths))],
50
+ ...localizedPaths !== void 0 && { localizedPaths: [...new Set(read(localizedPaths))] },
51
+ tags: [...new Set(read(tags))],
52
+ locales: [...new Set(read(locales).map((locale) => locale.trim().toLowerCase()))],
53
+ sitemap: sitemap ?? false
54
+ };
55
+ }
56
+ // src/context/CacheTagContext.ts
57
+ var KEY = Symbol.for("isr-engine:cache-tag-als");
58
+ var runtime = globalThis;
59
+ function getCacheTagStorage() {
60
+ return runtime[KEY] ??= new AsyncLocalStorage();
61
+ }
62
+ /** Exclude a successful but degraded render from the shared response cache. */
63
+ function markUncacheable() {
64
+ const store = getCacheTagStorage().getStore();
65
+ if (store) store.uncacheable = true;
66
+ }
67
+ export { registerContentInvalidator as a, normalizeContentScopes as i, markUncacheable as n, invalidateContentCaches as r, getCacheTagStorage as t };
68
+
69
+ //# sourceMappingURL=CacheTagContext-Btmq8KCD.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CacheTagContext-Btmq8KCD.js","names":["KEY","runtime"],"sources":["../src/defaults/runtime/contentRevalidation.ts","../src/context/CacheTagContext.ts"],"sourcesContent":["/** Data and response cache scopes to invalidate after a content write commits. */\nexport interface ContentRevalidationOptions {\n /** Exact site paths, including any locale prefix. */\n paths?: readonly string[];\n /** Business pathnames expanded using the runtime's routing config and the supplied locales. */\n localizedPaths?: readonly string[];\n tags?: readonly string[];\n locales?: readonly string[];\n sitemap?: boolean;\n}\n\nexport interface ContentPublication {\n id: string;\n scopes: Readonly<Omit<Required<ContentRevalidationOptions>, 'localizedPaths'>>;\n}\n\ntype ContentInvalidation = ContentPublication['scopes'] & { allPageMetadata?: true };\ntype ContentInvalidator = (scopes: ContentInvalidation) => void;\n\n// Node, the RSC bundle, and the published site-hooks entry have separate module graphs.\nconst KEY = Symbol.for('isr-engine:content-invalidators');\nconst runtime = globalThis as typeof globalThis & {\n [KEY]?: Set<ContentInvalidator | WeakRef<ContentInvalidator>>;\n};\n\nexport function registerContentInvalidator(\n invalidate: ContentInvalidator,\n { weak = false } = {}\n): () => void {\n const registry = (runtime[KEY] ??= new Set());\n for (const entry of registry) {\n if (typeof entry !== 'function' && !entry.deref()) registry.delete(entry);\n }\n const entry = weak ? new WeakRef(invalidate) : invalidate;\n registry.add(entry);\n return () => {\n registry.delete(entry);\n };\n}\n\n/** The default scope recovers page metadata after a missed Redis notification. */\nexport function invalidateContentCaches(\n scopes: ContentInvalidation = {\n paths: [],\n tags: [],\n locales: [],\n sitemap: false,\n allPageMetadata: true,\n }\n): void {\n const errors: unknown[] = [];\n const registry = runtime[KEY];\n if (!registry) return;\n for (const entry of registry) {\n const invalidate = typeof entry === 'function' ? entry : entry.deref();\n if (!invalidate) {\n registry.delete(entry);\n continue;\n }\n try {\n invalidate(scopes);\n } catch (error) {\n errors.push(error);\n }\n }\n if (errors.length) throw new AggregateError(errors, 'Content metadata invalidation failed');\n}\n\nexport function normalizeContentScopes(\n input: unknown\n): ContentPublication['scopes'] & Pick<ContentRevalidationOptions, 'localizedPaths'> {\n if (!input || typeof input !== 'object' || Array.isArray(input)) {\n throw new TypeError('Invalid content revalidation scopes');\n }\n const { paths, localizedPaths, tags, locales, sitemap } = input as ContentRevalidationOptions;\n function read(values: unknown): string[] {\n if (values === undefined) return [];\n if (\n !Array.isArray(values) ||\n Array.from(values).some(value => typeof value !== 'string' || !value.trim())\n ) {\n throw new TypeError('Content revalidation scopes must contain non-empty strings');\n }\n return values;\n }\n if (sitemap !== undefined && typeof sitemap !== 'boolean') {\n throw new TypeError('Content revalidation sitemap must be a boolean');\n }\n return {\n paths: [...new Set(read(paths))],\n ...(localizedPaths !== undefined && { localizedPaths: [...new Set(read(localizedPaths))] }),\n tags: [...new Set(read(tags))],\n locales: [...new Set(read(locales).map(locale => locale.trim().toLowerCase()))],\n sitemap: sitemap ?? false,\n };\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\n\ninterface TagStore {\n tags: Set<string>;\n uncacheable: boolean;\n}\n\n// The Vite RSC bundle and the Node response cache share this request context.\nconst KEY = Symbol.for('isr-engine:cache-tag-als');\nconst runtime = globalThis as typeof globalThis & { [KEY]?: AsyncLocalStorage<TagStore> };\n\nexport function getCacheTagStorage(): AsyncLocalStorage<TagStore> {\n return (runtime[KEY] ??= new AsyncLocalStorage<TagStore>());\n}\n\n/** Exclude a successful but degraded render from the shared response cache. */\nexport function markUncacheable(): void {\n const store = getCacheTagStorage().getStore();\n if (store) store.uncacheable = true;\n}\n"],"mappings":";;AAoBA,IAAMA,QAAM,OAAO,IAAI,iCAAiC;AACxD,IAAMC,YAAU;AAIhB,SAAgB,2BACd,YACA,EAAE,OAAO,UAAU,CAAC,GACR;CACZ,MAAM,WAAY,UAAQD,2BAAS,IAAI,IAAI;CAC3C,KAAK,MAAM,SAAS,UAClB,IAAI,OAAO,UAAU,cAAc,CAAC,MAAM,MAAM,GAAG,SAAS,OAAO,KAAK;CAE1E,MAAM,QAAQ,OAAO,IAAI,QAAQ,UAAU,IAAI;CAC/C,SAAS,IAAI,KAAK;CAClB,aAAa;EACX,SAAS,OAAO,KAAK;CACvB;AACF;;AAGA,SAAgB,wBACd,SAA8B;CAC5B,OAAO,CAAC;CACR,MAAM,CAAC;CACP,SAAS,CAAC;CACV,SAAS;CACT,iBAAiB;AACnB,GACM;CACN,MAAM,SAAoB,CAAC;CAC3B,MAAM,WAAWC,UAAQD;CACzB,IAAI,CAAC,UAAU;CACf,KAAK,MAAM,SAAS,UAAU;EAC5B,MAAM,aAAa,OAAO,UAAU,aAAa,QAAQ,MAAM,MAAM;EACrE,IAAI,CAAC,YAAY;GACf,SAAS,OAAO,KAAK;GACrB;EACF;EACA,IAAI;GACF,WAAW,MAAM;EACnB,SAAS,OAAO;GACd,OAAO,KAAK,KAAK;EACnB;CACF;CACA,IAAI,OAAO,QAAQ,MAAM,IAAI,eAAe,QAAQ,sCAAsC;AAC5F;AAEA,SAAgB,uBACd,OACmF;CACnF,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAC5D,MAAM,IAAI,UAAU,qCAAqC;CAE3D,MAAM,EAAE,OAAO,gBAAgB,MAAM,SAAS,YAAY;CAC1D,SAAS,KAAK,QAA2B;EACvC,IAAI,WAAW,KAAA,GAAW,OAAO,CAAC;EAClC,IACE,CAAC,MAAM,QAAQ,MAAM,KACrB,MAAM,KAAK,MAAM,CAAC,CAAC,MAAK,UAAS,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,CAAC,GAE3E,MAAM,IAAI,UAAU,4DAA4D;EAElF,OAAO;CACT;CACA,IAAI,YAAY,KAAA,KAAa,OAAO,YAAY,WAC9C,MAAM,IAAI,UAAU,gDAAgD;CAEtE,OAAO;EACL,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC;EAC/B,GAAI,mBAAmB,KAAA,KAAa,EAAE,gBAAgB,CAAC,GAAG,IAAI,IAAI,KAAK,cAAc,CAAC,CAAC,EAAE;EACzF,MAAM,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;EAC7B,SAAS,CAAC,GAAG,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,KAAI,WAAU,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;EAC9E,SAAS,WAAW;CACtB;AACF;;ACvFA,IAAM,MAAM,OAAO,IAAI,0BAA0B;AACjD,IAAM,UAAU;AAEhB,SAAgB,qBAAkD;CAChE,OAAQ,QAAQ,SAAS,IAAI,kBAA4B;AAC3D;;AAGA,SAAgB,kBAAwB;CACtC,MAAM,QAAQ,mBAAmB,CAAC,CAAC,SAAS;CAC5C,IAAI,OAAO,MAAM,cAAc;AACjC"}
@@ -1,5 +1,49 @@
1
+ import { i as normalizeContentScopes, r as invalidateContentCaches, t as getCacheTagStorage } from "./CacheTagContext-Btmq8KCD.js";
2
+ import { o as withLocale } from "./i18n-BZpAOZeO.js";
1
3
  import { AsyncLocalStorage } from "async_hooks";
2
- import { AsyncLocalStorage as AsyncLocalStorage$1 } from "node:async_hooks";
4
+ import { randomUUID } from "node:crypto";
5
+ // src/utils/htmlPathname.ts
6
+ /** Shared logical identity for HTML dispatch, aliases and build-time route validation. */
7
+ function decodeHtmlPathname(raw) {
8
+ const pathname = decodeURIComponent(raw);
9
+ if (pathname.includes("\\") || pathname.includes("\0") || pathname.split("/").some((segment) => segment === ".." || segment === ".")) throw new Error("Invalid HTML pathname");
10
+ return pathname;
11
+ }
12
+ function isHtmlRoutePattern(route) {
13
+ return route.includes("*") || route.split("/").some((segment) => segment.startsWith(":"));
14
+ }
15
+ /** Validate the original declaration before a URL parser can repair or normalize it. */
16
+ function htmlRouteIdentity(route, { allowPatterns = false } = {}) {
17
+ const invalid = (reason) => /* @__PURE__ */ new Error(`Invalid HTML route ${JSON.stringify(route)}: ${reason}`);
18
+ if (typeof route !== "string") throw invalid("expected a path string");
19
+ if (allowPatterns && route === "*") return route;
20
+ if (!(allowPatterns ? /^\/[A-Za-z0-9%\-._~/*:]*$/ : /^\/[A-Za-z0-9%\-._~/]*$/).test(route) || route.startsWith("//")) throw invalid("expected one origin-relative, percent-encoded pathname without query or fragment");
21
+ const segments = route.slice(1).split("/");
22
+ if (segments.at(-1) === "") segments.pop();
23
+ if (segments.some((segment) => !segment)) throw invalid("empty path segment");
24
+ let identity;
25
+ try {
26
+ identity = decodeHtmlPathname(route);
27
+ } catch (cause) {
28
+ throw new Error(`Invalid HTML route ${JSON.stringify(route)}: malformed or unsafe pathname`, { cause });
29
+ }
30
+ if (Array.from(identity).some((character) => {
31
+ const code = character.charCodeAt(0);
32
+ return code < 32 || code === 127;
33
+ })) throw invalid("control characters are forbidden");
34
+ return identity;
35
+ }
36
+ /** Exact duplicates are idempotent; matching rules do not own concrete page identities. */
37
+ function assertDistinctHtmlRouteIdentities(routes, options = {}) {
38
+ const owners = /* @__PURE__ */ new Map();
39
+ for (const route of routes) {
40
+ const identity = htmlRouteIdentity(route, options);
41
+ if (options.allowPatterns && isHtmlRoutePattern(route)) continue;
42
+ const owner = owners.get(identity);
43
+ if (owner !== void 0 && owner !== route) throw new Error(`Route identity collision: ${JSON.stringify(owner)} and ${JSON.stringify(route)} resolve to ${JSON.stringify(identity)}`);
44
+ owners.set(identity, route);
45
+ }
46
+ }
3
47
  // src/context/RequestContext.ts
4
48
  var REQUEST_CONTEXT_KEY = "__ISR_ENGINE_REQUEST_CONTEXT__";
5
49
  function getGlobalRequestContext() {
@@ -137,22 +181,24 @@ function recordRevalidationMetric(...args) {
137
181
  *
138
182
  * 注意:
139
183
  * - 本模块不持有任何缓存实现,纯做路由分发
140
- * - 若未注册 invalidator(例如脱离 engine 的纯 RSC 场景),调用静默为 no-op
184
+ * - revalidatePath 与 revalidateTag 在无注册时保留 no-op;发布要求活跃的引擎运行时
141
185
  */
142
186
  /** 全局单例 key(Symbol.for 保证跨模块图复用同一注册表) */
143
187
  var REGISTRY_KEY = Symbol.for("isr-engine:revalidate-registry");
144
188
  function getRegistry() {
145
189
  const g = globalThis;
146
- if (!g[REGISTRY_KEY]) g[REGISTRY_KEY] = /* @__PURE__ */ new Set();
147
- return g[REGISTRY_KEY];
190
+ return g[REGISTRY_KEY] ??= /* @__PURE__ */ new Map();
148
191
  }
149
192
  /**
150
193
  * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)
151
194
  * 返回取消注册的函数
152
195
  */
153
- function registerInvalidator(fn) {
196
+ function registerInvalidator(fn, invalidatePublication, i18n) {
154
197
  const registry = getRegistry();
155
- registry.add(fn);
198
+ registry.set(fn, invalidatePublication && {
199
+ publish: invalidatePublication,
200
+ i18n
201
+ });
156
202
  return () => {
157
203
  registry.delete(fn);
158
204
  };
@@ -182,6 +228,15 @@ var RevalidationError = class extends Error {
182
228
  this.causes = causes;
183
229
  }
184
230
  };
231
+ function contentResponseTargets(scopes) {
232
+ return [...scopes.paths.map((value) => ({
233
+ kind: "path",
234
+ value
235
+ })), ...scopes.tags.map((value) => ({
236
+ kind: "tag",
237
+ value
238
+ }))];
239
+ }
185
240
  /**
186
241
  * 内部统一分发:跑所有 invalidator,把失败聚合成 RevalidationError 抛出。
187
242
  *
@@ -189,15 +244,15 @@ var RevalidationError = class extends Error {
189
244
  * 这样即使 Redis 回源失败,进程内 LRU 至少能清干净;进程内 LRU 失败也不会拖累 Redis。
190
245
  */
191
246
  async function dispatch(target) {
192
- const registry = getRegistry();
193
- const targetLabel = `${target.kind}:${target.value}`;
194
- if (registry.size === 0) {
247
+ await runInvalidators(`${target.kind}:${target.value}`, Array.from(getRegistry().keys(), (invalidate) => () => invalidate(target)), target);
248
+ }
249
+ async function runInvalidators(targetLabel, invalidators, target) {
250
+ if (invalidators.length === 0) {
195
251
  runtimeLogger.debug(`revalidate(${targetLabel}) —— 无 invalidator 注册,忽略`);
196
252
  return;
197
253
  }
198
- recordRevalidationMetric("run", target.kind, target.value);
199
- const invalidators = Array.from(registry);
200
- const results = await Promise.allSettled(invalidators.map(async (fn) => fn(target)));
254
+ if (target) recordRevalidationMetric("run", target.kind, target.value);
255
+ const results = await Promise.allSettled(invalidators.map(async (fn) => fn()));
201
256
  const causes = [];
202
257
  let successCount = 0;
203
258
  let failureCount = 0;
@@ -209,11 +264,11 @@ async function dispatch(target) {
209
264
  failureCount++;
210
265
  const err = r.reason instanceof Error ? r.reason : new Error(String(r.reason));
211
266
  causes.push(err);
212
- recordRevalidationMetric("failure", target.kind, target.value);
267
+ if (target) recordRevalidationMetric("failure", target.kind, target.value);
213
268
  runtimeLogger.error(`[revalidate] invalidator #${idx} failed for ${targetLabel}: ${err.message}`, err);
214
269
  });
215
270
  if (failureCount > 0) throw new RevalidationError(targetLabel, successCount, failureCount, causes);
216
- runtimeLogger.debug(`✅ revalidate(${targetLabel}) —— 已分发到 ${registry.size} 个 invalidator(全部成功)`);
271
+ runtimeLogger.debug(`✅ revalidate(${targetLabel}) —— 已分发到 ${invalidators.length} 个 invalidator(全部成功)`);
217
272
  }
218
273
  /**
219
274
  * 使指定路径的缓存失效
@@ -239,6 +294,48 @@ async function revalidateTag(tag) {
239
294
  value: tag
240
295
  });
241
296
  }
297
+ /** Invalidate managed metadata before invalidating the affected rendered responses. */
298
+ async function revalidateContent(options) {
299
+ const { localizedPaths = [], ...scopes } = normalizeContentScopes(options);
300
+ const targets = contentResponseTargets(scopes);
301
+ if (!targets.length && !localizedPaths.length && !scopes.locales.length && !scopes.sitemap) throw new TypeError("Content revalidation requires at least one scope");
302
+ if (localizedPaths.length && !scopes.locales.length) throw new TypeError("localizedPaths requires locales");
303
+ const registry = Array.from(getRegistry());
304
+ if (!registry.length || (localizedPaths.length || scopes.locales.length || scopes.sitemap) && !registry.some(([, handler]) => handler)) throw new Error("revalidateContent requires an active ISR runtime. Deliver the publication to the site runtime.");
305
+ const id = randomUUID();
306
+ const invalidators = registry.flatMap(([invalidate, handler]) => {
307
+ if (!handler) return targets.map((target) => () => invalidate(target));
308
+ const paths = localizedPaths.length ? [.../* @__PURE__ */ new Set([...scopes.paths, ...expandLocalizedPaths(localizedPaths, scopes.locales, handler.i18n)])] : scopes.paths;
309
+ return [() => handler.publish({
310
+ id,
311
+ scopes: {
312
+ ...scopes,
313
+ paths
314
+ }
315
+ })];
316
+ });
317
+ invalidateContentCaches(scopes);
318
+ await runInvalidators("content", invalidators);
319
+ }
320
+ function expandLocalizedPaths(paths, locales, i18n) {
321
+ if (!i18n) throw new TypeError("localizedPaths requires runtime.i18n configuration");
322
+ const configured = new Map(i18n.locales.map((locale) => [locale.toLowerCase(), locale]));
323
+ const requested = locales.map((locale) => {
324
+ const match = configured.get(locale);
325
+ if (!match) throw new TypeError("Unknown publication locale");
326
+ return match;
327
+ });
328
+ return paths.flatMap((path) => {
329
+ let identity;
330
+ try {
331
+ identity = htmlRouteIdentity(path);
332
+ } catch {
333
+ throw new TypeError("localizedPaths requires origin-relative pathnames without queries or fragments");
334
+ }
335
+ if (configured.has(identity.split("/")[1]?.toLowerCase() ?? "")) throw new TypeError("Use paths for page paths that already contain a locale prefix");
336
+ return requested.map((locale) => withLocale(path, locale, i18n));
337
+ });
338
+ }
242
339
  // src/rsc/cacheTag.ts
243
340
  /**
244
341
  * 缓存 Tag 上下文 —— 支持 Server Component 在渲染期声明 tag,便于后续 revalidateTag 精细失效
@@ -259,12 +356,6 @@ async function revalidateTag(tag) {
259
356
  * 导致 cacheTag 写入的 store 与 collectTags 读取的 store 不互通。
260
357
  * 故本模块把 ALS 实例挂在 `globalThis` 上作为跨模块图单例(Symbol.for key)
261
358
  */
262
- var ALS_KEY = Symbol.for("isr-engine:cache-tag-als");
263
- function getALS() {
264
- const g = globalThis;
265
- if (!g[ALS_KEY]) g[ALS_KEY] = new AsyncLocalStorage$1();
266
- return g[ALS_KEY];
267
- }
268
359
  /**
269
360
  * 在独立的 tag 作用域中执行 fn —— 通常由 ISR 缓存中间件在每次请求前调用
270
361
  *
@@ -272,25 +363,14 @@ function getALS() {
272
363
  * 写入本作用域,不会污染父作用域或兄弟请求
273
364
  */
274
365
  function runWithTagStore(fn) {
275
- return getALS().run({
366
+ return getCacheTagStorage().run({
276
367
  tags: /* @__PURE__ */ new Set(),
277
368
  uncacheable: false
278
369
  }, fn);
279
370
  }
280
- /**
281
- * 在 Server Component / loader 内显式声明本次渲染产物**不应入缓存**。
282
- * 适用场景:上游接口失败、降级渲染了一段错误提示 UI、命中风控/限流等
283
- * —— 渲染结果是 200,但内容会让用户困惑或马上过期,不应被 ISR HIT 反复回放。
284
- *
285
- * 调用一次即可;后续 cacheTag(...) 仍可继续调用但不会改变 uncacheable 决定。
286
- */
287
- function markUncacheable() {
288
- const store = getALS().getStore();
289
- if (store) store.uncacheable = true;
290
- }
291
371
  /** 读取本次渲染是否被标记为不可缓存(ISR 缓存中间件在响应捕获阶段调用) */
292
372
  function isUncacheable() {
293
- return getALS().getStore()?.uncacheable === true;
373
+ return getCacheTagStorage().getStore()?.uncacheable === true;
294
374
  }
295
375
  /**
296
376
  * Server Component / server action / server-only util 内声明:
@@ -299,7 +379,7 @@ function isUncacheable() {
299
379
  * 多次调用会合并 tag;无 tag 作用域(例如脱离缓存中间件时)静默忽略
300
380
  */
301
381
  function cacheTag(...tags) {
302
- const store = getALS().getStore();
382
+ const store = getCacheTagStorage().getStore();
303
383
  if (!store) return;
304
384
  for (const tag of tags) if (typeof tag === "string" && tag.length > 0) store.tags.add(tag);
305
385
  }
@@ -307,14 +387,14 @@ function cacheTag(...tags) {
307
387
  * 读取当前 tag 作用域的 tag 列表(ISR 缓存中间件在响应捕获阶段调用)
308
388
  */
309
389
  function collectTags() {
310
- const store = getALS().getStore();
390
+ const store = getCacheTagStorage().getStore();
311
391
  return store ? Array.from(store.tags) : [];
312
392
  }
313
393
  /**
314
394
  * 调试:打印当前 tag store 状态
315
395
  */
316
396
  function debugTagStore(label = "") {
317
- const store = getALS().getStore();
397
+ const store = getCacheTagStorage().getStore();
318
398
  runtimeLogger.debug(`[cacheTag] ${label} store=${store ? JSON.stringify(Array.from(store.tags)) : "<none>"}`);
319
399
  }
320
400
  // src/middlewares/abVariantContext.ts
@@ -333,6 +413,6 @@ function getVariant(experimentName) {
333
413
  const v = getRequestContext()?.flags?.[experimentName];
334
414
  return typeof v === "string" ? v : void 0;
335
415
  }
336
- export { getTraceId as C, getRequestId as S, requestContext as T, escapeSupplementalLogControls as _, isUncacheable as a, getExperiments as b, RevalidationError as c, revalidateTag as d, setRevalidationMetricRecorder as f, encodeSpinnerMessage as g, encodeLogField as h, debugTagStore as i, registerInvalidator as l, setOriginLogger as m, cacheTag as n, markUncacheable as o, runtimeLogger as p, collectTags as r, runWithTagStore as s, getVariant as t, revalidatePath as u, snapshotLogArgument as v, getUserId as w, getRequestContext as x, getAnonId as y };
416
+ export { isHtmlRoutePattern as A, getRequestId as C, assertDistinctHtmlRouteIdentities as D, requestContext as E, decodeHtmlPathname as O, getRequestContext as S, getUserId as T, encodeSpinnerMessage as _, isUncacheable as a, getAnonId as b, contentResponseTargets as c, revalidatePath as d, revalidateTag as f, encodeLogField as g, setOriginLogger as h, debugTagStore as i, htmlRouteIdentity as k, registerInvalidator as l, runtimeLogger as m, cacheTag as n, runWithTagStore as o, setRevalidationMetricRecorder as p, collectTags as r, RevalidationError as s, getVariant as t, revalidateContent as u, escapeSupplementalLogControls as v, getTraceId as w, getExperiments as x, snapshotLogArgument as y };
337
417
 
338
- //# sourceMappingURL=abVariantContext-CGBlCt0q.js.map
418
+ //# sourceMappingURL=abVariantContext-yWZOqscY.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"abVariantContext-yWZOqscY.js","names":["runtime"],"sources":["../src/utils/htmlPathname.ts","../src/context/RequestContext.ts","../src/logger/logRecord.ts","../src/logger/runtimeLogger.ts","../src/rsc/revalidationMetrics.ts","../src/rsc/revalidate.ts","../src/rsc/cacheTag.ts","../src/middlewares/abVariantContext.ts"],"sourcesContent":["/** Shared logical identity for HTML dispatch, aliases and build-time route validation. */\nexport function decodeHtmlPathname(raw: string): string {\n const pathname = decodeURIComponent(raw);\n if (\n pathname.includes('\\\\') ||\n pathname.includes('\\0') ||\n pathname.split('/').some(segment => segment === '..' || segment === '.')\n ) {\n throw new Error('Invalid HTML pathname');\n }\n return pathname;\n}\n\nexport interface HtmlRouteDeclarationOptions {\n /** Matching rules are valid configuration, but are never concrete SSG pages. */\n allowPatterns?: boolean;\n}\n\nexport function isHtmlRoutePattern(route: string): boolean {\n return route.includes('*') || route.split('/').some(segment => segment.startsWith(':'));\n}\n\n/** Validate the original declaration before a URL parser can repair or normalize it. */\nexport function htmlRouteIdentity(\n route: string,\n { allowPatterns = false }: HtmlRouteDeclarationOptions = {}\n): string {\n const invalid = (reason: string) =>\n new Error(`Invalid HTML route ${JSON.stringify(route)}: ${reason}`);\n if (typeof route !== 'string') throw invalid('expected a path string');\n if (allowPatterns && route === '*') return route;\n const syntax = allowPatterns ? /^\\/[A-Za-z0-9%\\-._~/*:]*$/ : /^\\/[A-Za-z0-9%\\-._~/]*$/;\n if (!syntax.test(route) || route.startsWith('//'))\n throw invalid(\n 'expected one origin-relative, percent-encoded pathname without query or fragment'\n );\n const segments = route.slice(1).split('/');\n if (segments.at(-1) === '') segments.pop();\n if (segments.some(segment => !segment)) throw invalid('empty path segment');\n let identity: string;\n try {\n identity = decodeHtmlPathname(route);\n } catch (cause) {\n throw new Error(`Invalid HTML route ${JSON.stringify(route)}: malformed or unsafe pathname`, {\n cause,\n });\n }\n if (\n Array.from(identity).some(character => {\n const code = character.charCodeAt(0);\n return code < 32 || code === 127;\n })\n )\n throw invalid('control characters are forbidden');\n return identity;\n}\n\n/** Exact duplicates are idempotent; matching rules do not own concrete page identities. */\nexport function assertDistinctHtmlRouteIdentities(\n routes: Iterable<string>,\n options: HtmlRouteDeclarationOptions = {}\n): void {\n const owners = new Map<string, string>();\n for (const route of routes) {\n const identity = htmlRouteIdentity(route, options);\n if (options.allowPatterns && isHtmlRoutePattern(route)) continue;\n const owner = owners.get(identity);\n if (owner !== undefined && owner !== route) {\n throw new Error(\n `Route identity collision: ${JSON.stringify(owner)} and ${JSON.stringify(route)} resolve to ${JSON.stringify(identity)}`\n );\n }\n owners.set(identity, route);\n }\n}\n","import { AsyncLocalStorage } from 'async_hooks';\nimport type { ISRContextData } from '../types/ISRContext';\n\n// 复用 ISRContextData 类型,确保 ALS 中的数据结构与 ISRContext.data 一致\nexport type RequestContextState = ISRContextData;\n\nconst REQUEST_CONTEXT_KEY = '__ISR_ENGINE_REQUEST_CONTEXT__';\n\nfunction getGlobalRequestContext(): AsyncLocalStorage<RequestContextState> {\n const globalState = globalThis as typeof globalThis & {\n [REQUEST_CONTEXT_KEY]?: AsyncLocalStorage<RequestContextState>;\n };\n\n globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage<RequestContextState>();\n return globalState[REQUEST_CONTEXT_KEY];\n}\n\n// 全局 ALS 实例。dev 下 source/dist 可能同时被 Vite 加载,必须共享同一份请求上下文。\nexport const requestContext = getGlobalRequestContext();\n\n// 获取当前请求上下文的辅助函数\nexport const getRequestContext = (): RequestContextState | undefined => {\n return requestContext.getStore();\n};\n\n// 获取 Trace ID 的辅助函数 (安全访问)\nexport const getTraceId = (): string => {\n const store = requestContext.getStore();\n return store?.traceId || 'system';\n};\n\n// 获取 Request ID 的辅助函数 (安全访问)\nexport const getRequestId = (): string => {\n const store = requestContext.getStore();\n return store?.requestId || 'unknown';\n};\n\n/**\n * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。\n *\n * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值\n * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。\n * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。\n */\nexport const getAnonId = (): string => {\n const store = requestContext.getStore();\n return store?.anonId || 'system';\n};\n\n/**\n * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。\n * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远\n * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。\n */\nexport const getUserId = (): string | null => {\n const store = requestContext.getStore();\n return store?.userId ?? null;\n};\n\n/**\n * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。\n * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。\n * 没接 ABVariantMiddleware 时返回空对象。\n */\nexport const getExperiments = (): Record<string, string> => {\n const store = requestContext.getStore();\n return store?.experiments ?? {};\n};\n","export type LogValue = null | boolean | number | string | LogValue[] | { [key: string]: LogValue };\n\n/** Snapshot once so console and file output cannot invoke a caller's toJSON twice. */\nexport function snapshotLogArgument(value: unknown): LogValue {\n try {\n const seen = new WeakSet<object>();\n const serialized = JSON.stringify(value, (_key, item: unknown) => {\n if (typeof item === 'bigint') return `${item}n`;\n if (item && typeof item === 'object') {\n if (seen.has(item)) return '[Circular]';\n seen.add(item);\n if (item instanceof Error) {\n return {\n ...item,\n name: item.name,\n message: item.message,\n stack: item.stack,\n cause: item.cause,\n };\n }\n }\n return item;\n });\n return serialized === undefined ? String(value) : (JSON.parse(serialized) as LogValue);\n } catch {\n return '[Unserializable log argument]';\n }\n}\n\n/** JSON handles C0/CR/LF; these additional controls are legal raw JSON characters. */\nexport function escapeSupplementalLogControls(serialized: string): string {\n return serialized.replace(\n /[\\u007f-\\u009f\\u061c\\u200e\\u200f\\u2028-\\u202e\\u2066-\\u2069]/g,\n character => `\\\\u${character.charCodeAt(0).toString(16).padStart(4, '0')}`\n );\n}\n\n/** Keep every untrusted console field visibly quoted and inside one physical line. */\nexport function encodeLogField(value: LogValue): string {\n return escapeSupplementalLogControls(JSON.stringify(value));\n}\n\nexport function encodeSpinnerMessage(value: string): string {\n return encodeLogField(value).slice(1, -1);\n}\n","import { encodeLogField, snapshotLogArgument } from './logRecord';\n\ntype RuntimeLogLevel = 'debug' | 'info' | 'error';\ntype RuntimeLogger = Record<RuntimeLogLevel, (...args: unknown[]) => void>;\n\nconst LOGGER_KEY = Symbol.for('isr-engine:origin-logger');\nconst runtime = globalThis as typeof globalThis & { [LOGGER_KEY]?: RuntimeLogger };\n\nexport function setOriginLogger(logger: RuntimeLogger): void {\n runtime[LOGGER_KEY] = logger;\n}\n\n/** Rendered modules share the origin logger without bundling its file transport. */\nfunction log(level: RuntimeLogLevel, args: unknown[]): void {\n const origin = runtime[LOGGER_KEY];\n if (origin) {\n origin[level](...args);\n } else if (level !== 'debug') {\n console[level](encodeLogField({ level, args: args.map(snapshotLogArgument) }));\n }\n}\n\nexport const runtimeLogger: RuntimeLogger = {\n debug: (...args) => log('debug', args),\n info: (...args) => log('info', args),\n error: (...args) => log('error', args),\n};\n","type RevalidationMetricRecorder = (\n event: 'run' | 'failure',\n kind: 'path' | 'tag',\n target: string\n) => void;\n\nconst RECORDER_KEY = Symbol.for('isr-engine:revalidation-metric-recorder');\nconst runtime = globalThis as typeof globalThis & {\n [RECORDER_KEY]?: RevalidationMetricRecorder;\n};\n\n/** The Node origin owns the metrics registry, including events from the separate Vite RSC graph. */\nexport function setRevalidationMetricRecorder(recorder: RevalidationMetricRecorder): void {\n runtime[RECORDER_KEY] = recorder;\n}\n\nexport function recordRevalidationMetric(...args: Parameters<RevalidationMetricRecorder>): void {\n runtime[RECORDER_KEY]?.(...args);\n}\n","/**\n * 缓存失效契约 —— `revalidatePath(path)` 按路径精准失效;`revalidateTag(tag)` 按渲染期声明的 tag 失效\n *\n * 跨环境状态共享:\n * Server Action 在 Vite 的 `rsc` 环境中执行(模块图 A),\n * 而 ISR 缓存中间件注册 invalidator 在 Node 上下文(模块图 B),\n * 两份模块图下,同名模块可能各自持有独立的 ES 模块状态。\n * 因此本模块把 invalidator 注册表挂在 `globalThis` 上作为跨环境单例,\n * 确保 `revalidatePath/Tag` 调用能分发到所有已注册的 invalidator。\n *\n * 失败语义(v2.0.x 起):\n * 过去版本用 `Promise.all`,**首个失败的 invalidator 会抛出,剩余的可能仍在执行\n * 但 reject 被吞**——多 invalidator 场景下出现\"看似成功但部分缓存没清\"的脏状态。\n * 现在改为:\n * 1. `Promise.allSettled` 让所有 invalidator 都跑到底\n * 2. 每个失败单独打 metric + log(含 trace 上下文)\n * 3. 整体 ≥ 1 个失败 → 抛聚合 `RevalidationError`(含 successCount/failureCount/causes)\n * 调用方(Server Action)务必 `try { await revalidateTag(...) } catch (e) { ... }`,\n * 否则用户提交后看到的是 200 但底层有部分 cache 未清——这种\"沉默错误\"比抛错更危险。\n *\n * 用法:\n * 1. Server Action 内部调用 `revalidatePath('/books')` 或 `revalidateTag('books')`\n * 2. ISR cache 中间件 / ISREngine 启动时通过 `registerInvalidator(fn)` 注册\n * 3. 分发到所有注册的 invalidator,清理对应缓存条目\n *\n * 注意:\n * - 本模块不持有任何缓存实现,纯做路由分发\n * - revalidatePath 与 revalidateTag 在无注册时保留 no-op;发布要求活跃的引擎运行时\n */\n\nimport { randomUUID } from 'node:crypto';\nimport { runtimeLogger as logger } from '../logger/runtimeLogger';\nimport {\n invalidateContentCaches,\n normalizeContentScopes,\n type ContentPublication,\n type ContentRevalidationOptions,\n} from '../defaults/runtime/contentRevalidation';\nimport { recordRevalidationMetric } from './revalidationMetrics';\nimport { withLocale, type I18nConfig } from '../runtime/i18n';\nimport { htmlRouteIdentity } from '../utils/htmlPathname';\n\n/** Invalidator 签名:接收失效目标描述 */\nexport interface RevalidateInvalidator {\n (target: RevalidateTarget): Promise<void> | void;\n}\n\ntype ContentResponseInvalidator = (publication: ContentPublication) => Promise<void> | void;\n\n/** 全局单例 key(Symbol.for 保证跨模块图复用同一注册表) */\nconst REGISTRY_KEY = Symbol.for('isr-engine:revalidate-registry');\ntype Registry = Map<\n RevalidateInvalidator,\n { publish: ContentResponseInvalidator; i18n?: I18nConfig } | undefined\n>;\n\ntype GlobalWithRegistry = typeof globalThis & {\n [REGISTRY_KEY]?: Registry;\n};\n\nfunction getRegistry(): Registry {\n const g = globalThis as GlobalWithRegistry;\n return (g[REGISTRY_KEY] ??= new Map());\n}\n\n/**\n * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)\n * 返回取消注册的函数\n */\nexport function registerInvalidator(\n fn: RevalidateInvalidator,\n invalidatePublication?: ContentResponseInvalidator,\n i18n?: I18nConfig\n): () => void {\n const registry = getRegistry();\n registry.set(fn, invalidatePublication && { publish: invalidatePublication, i18n });\n return () => {\n registry.delete(fn);\n };\n}\n\n/**\n * 聚合失效错误 —— 当一个或多个 invalidator 失败时抛出。\n *\n * 含:\n * - successCount / failureCount:方便调用方决定补偿策略\n * - causes:每个失败的原始 Error(按注册顺序)\n * - target:触发本次 revalidate 的描述('tag:books' / 'path:/books')\n *\n * 注意:用 `extends Error` 而非 `AggregateError`,因为 AggregateError 在某些 Node\n * 版本对 stack/message 序列化不稳,自定义 class 更可控且 instanceof 检测可靠。\n */\nexport class RevalidationError extends Error {\n public readonly target: string;\n public readonly successCount: number;\n public readonly failureCount: number;\n public readonly causes: readonly Error[];\n\n constructor(\n target: string,\n successCount: number,\n failureCount: number,\n causes: readonly Error[]\n ) {\n super(\n `revalidate(${target}) —— ${failureCount} invalidator(s) failed, ` +\n `${successCount} succeeded. First cause: ${causes[0]?.message ?? '(unknown)'}`\n );\n this.name = 'RevalidationError';\n this.target = target;\n this.successCount = successCount;\n this.failureCount = failureCount;\n this.causes = causes;\n }\n}\n\nexport type RevalidateTarget = { kind: 'path'; value: string } | { kind: 'tag'; value: string };\n\nexport function contentResponseTargets(scopes: ContentPublication['scopes']): RevalidateTarget[] {\n return [\n ...scopes.paths.map(value => ({ kind: 'path' as const, value })),\n ...scopes.tags.map(value => ({ kind: 'tag' as const, value })),\n ];\n}\n\n/**\n * 内部统一分发:跑所有 invalidator,把失败聚合成 RevalidationError 抛出。\n *\n * `Promise.allSettled` 保证任意 invalidator 抛错都不会中断其他 invalidator 的执行——\n * 这样即使 Redis 回源失败,进程内 LRU 至少能清干净;进程内 LRU 失败也不会拖累 Redis。\n */\nasync function dispatch(target: RevalidateTarget): Promise<void> {\n const targetLabel = `${target.kind}:${target.value}`;\n await runInvalidators(\n targetLabel,\n Array.from(getRegistry().keys(), invalidate => () => invalidate(target)),\n target\n );\n}\n\nasync function runInvalidators(\n targetLabel: string,\n invalidators: Array<() => Promise<void> | void>,\n target?: RevalidateTarget\n): Promise<void> {\n if (invalidators.length === 0) {\n logger.debug(`revalidate(${targetLabel}) —— 无 invalidator 注册,忽略`);\n return;\n }\n\n if (target) recordRevalidationMetric('run', target.kind, target.value);\n\n // 包一层 async 函数:把同步抛错也转成 Promise rejection,让 allSettled 能统一处理\n // (直接 `fn(target)` 在 fn 同步抛错时会在 `.map` 里 escape,allSettled 收不到)\n const results = await Promise.allSettled(invalidators.map(async fn => fn()));\n\n const causes: Error[] = [];\n let successCount = 0;\n let failureCount = 0;\n\n results.forEach((r, idx) => {\n if (r.status === 'fulfilled') {\n successCount++;\n return;\n }\n failureCount++;\n const err = r.reason instanceof Error ? r.reason : new Error(String(r.reason));\n causes.push(err);\n if (target) recordRevalidationMetric('failure', target.kind, target.value);\n // 单独 log 每个失败,方便从 stack 定位是哪个 invalidator\n logger.error(`[revalidate] invalidator #${idx} failed for ${targetLabel}: ${err.message}`, err);\n });\n\n if (failureCount > 0) {\n throw new RevalidationError(targetLabel, successCount, failureCount, causes);\n }\n\n logger.debug(\n `✅ revalidate(${targetLabel}) —— 已分发到 ${invalidators.length} 个 invalidator(全部成功)`\n );\n}\n\n/**\n * 使指定路径的缓存失效\n *\n * @param path 形如 '/books' / '/posts/42' 的路径\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidatePath(path: string): Promise<void> {\n await dispatch({ kind: 'path', value: path });\n}\n\n/**\n * 使指定 tag 标记的所有缓存条目失效\n *\n * @param tag 业务语义 tag(如 'books' / `book:${id}`)\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidateTag(tag: string): Promise<void> {\n await dispatch({ kind: 'tag', value: tag });\n}\n\n/** Invalidate managed metadata before invalidating the affected rendered responses. */\nexport async function revalidateContent(options: ContentRevalidationOptions): Promise<void> {\n const { localizedPaths = [], ...scopes } = normalizeContentScopes(options);\n const targets = contentResponseTargets(scopes);\n if (!targets.length && !localizedPaths.length && !scopes.locales.length && !scopes.sitemap) {\n throw new TypeError('Content revalidation requires at least one scope');\n }\n if (localizedPaths.length && !scopes.locales.length) {\n throw new TypeError('localizedPaths requires locales');\n }\n const registry = Array.from(getRegistry());\n if (\n !registry.length ||\n ((localizedPaths.length || scopes.locales.length || scopes.sitemap) &&\n !registry.some(([, handler]) => handler))\n ) {\n throw new Error(\n 'revalidateContent requires an active ISR runtime. Deliver the publication to the site runtime.'\n );\n }\n const id = randomUUID();\n const invalidators = registry.flatMap(([invalidate, handler]) => {\n if (!handler) return targets.map(target => () => invalidate(target));\n const paths = localizedPaths.length\n ? [\n ...new Set([\n ...scopes.paths,\n ...expandLocalizedPaths(localizedPaths, scopes.locales, handler.i18n),\n ]),\n ]\n : scopes.paths;\n return [() => handler.publish({ id, scopes: { ...scopes, paths } })];\n });\n // Resolve every target before changing local metadata or shared caches.\n invalidateContentCaches(scopes);\n await runInvalidators('content', invalidators);\n}\n\nfunction expandLocalizedPaths(\n paths: readonly string[],\n locales: readonly string[],\n i18n?: I18nConfig\n): string[] {\n if (!i18n) throw new TypeError('localizedPaths requires runtime.i18n configuration');\n const configured = new Map(i18n.locales.map(locale => [locale.toLowerCase(), locale]));\n const requested = locales.map(locale => {\n const match = configured.get(locale);\n if (!match) throw new TypeError('Unknown publication locale');\n return match;\n });\n return paths.flatMap(path => {\n let identity: string;\n try {\n identity = htmlRouteIdentity(path);\n } catch {\n throw new TypeError(\n 'localizedPaths requires origin-relative pathnames without queries or fragments'\n );\n }\n if (configured.has(identity.split('/')[1]?.toLowerCase() ?? '')) {\n throw new TypeError('Use paths for page paths that already contain a locale prefix');\n }\n return requested.map(locale => withLocale(path, locale, i18n));\n });\n}\n\nexport { registerContentInvalidator } from '../defaults/runtime/contentRevalidation';\nexport type { ContentRevalidationOptions } from '../defaults/runtime/contentRevalidation';\n","/**\n * 缓存 Tag 上下文 —— 支持 Server Component 在渲染期声明 tag,便于后续 revalidateTag 精细失效\n *\n * 协作模型:\n * 1. ISR 缓存中间件在进入 handler 前 `runWithTagStore(() => rscHandler(request))`\n * —— 给本次请求开一个 AsyncLocalStorage 作用域,内部放 `{ tags: Set<string> }`\n * 2. Server Component 体内任意位置调用 `cacheTag('books', `book:${id}`)`\n * → 写入当前作用域的 tags Set\n * 3. 响应捕获阶段 `collectTags()` 读出 tag 列表,写入 CachedEntry.tags\n * 4. `revalidateTag('books')` 被 invalidator 接收后,遍历 cache 条目,\n * 命中 tags 列表的精准清除(无副作用污染其他条目)\n *\n * 跨环境状态共享:\n * Server Component 在 Vite `rsc` 环境执行(模块图 A),\n * ISR 缓存中间件在 Node(模块图 B)。\n * ES 模块作用域的 `new AsyncLocalStorage()` 会被双模块图各持有一份副本,\n * 导致 cacheTag 写入的 store 与 collectTags 读取的 store 不互通。\n * 故本模块把 ALS 实例挂在 `globalThis` 上作为跨模块图单例(Symbol.for key)\n */\n\nimport { getCacheTagStorage } from '../context/CacheTagContext';\nimport { runtimeLogger as logger } from '../logger/runtimeLogger';\n\nexport { markUncacheable } from '../context/CacheTagContext';\n\n/**\n * 在独立的 tag 作用域中执行 fn —— 通常由 ISR 缓存中间件在每次请求前调用\n *\n * fn 内部以及 fn 启动的任何 async/Promise 链路内,调用 cacheTag(...) 都会\n * 写入本作用域,不会污染父作用域或兄弟请求\n */\nexport function runWithTagStore<T>(fn: () => T | Promise<T>): T | Promise<T> {\n return getCacheTagStorage().run({ tags: new Set<string>(), uncacheable: false }, fn);\n}\n\n/** 读取本次渲染是否被标记为不可缓存(ISR 缓存中间件在响应捕获阶段调用) */\nexport function isUncacheable(): boolean {\n return getCacheTagStorage().getStore()?.uncacheable === true;\n}\n\n/**\n * Server Component / server action / server-only util 内声明:\n * 本次渲染/调用产出的缓存条目应关联以下 tag\n *\n * 多次调用会合并 tag;无 tag 作用域(例如脱离缓存中间件时)静默忽略\n */\nexport function cacheTag(...tags: string[]): void {\n const store = getCacheTagStorage().getStore();\n if (!store) {\n return;\n }\n for (const tag of tags) {\n if (typeof tag === 'string' && tag.length > 0) {\n store.tags.add(tag);\n }\n }\n}\n\n/**\n * 读取当前 tag 作用域的 tag 列表(ISR 缓存中间件在响应捕获阶段调用)\n */\nexport function collectTags(): string[] {\n const store = getCacheTagStorage().getStore();\n return store ? Array.from(store.tags) : [];\n}\n\n/**\n * 调试:打印当前 tag store 状态\n */\nexport function debugTagStore(label = ''): void {\n const store = getCacheTagStorage().getStore();\n logger.debug(\n `[cacheTag] ${label} store=${store ? JSON.stringify(Array.from(store.tags)) : '<none>'}`\n );\n}\n","/**\n * A/B variant 在 Server Component 里读取的 helper —— 与 express middleware 解耦\n *\n * RSC 环境通过本文件 import(不引入 express 类型,bundle 更轻);\n * Express 中间件在 ABVariantMiddleware.ts。\n */\nimport { getRequestContext } from '../context/RequestContext';\n\n/**\n * 在 Server Component 里读取 variant\n *\n * 不在 A/B middleware 后调用 → 返回 undefined\n */\nexport function getVariant(experimentName: string): string | undefined {\n const ctx = getRequestContext();\n const v = ctx?.flags?.[experimentName];\n return typeof v === 'string' ? v : undefined;\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"RedisInvalidationBus.d.ts","sourceRoot":"","sources":["../../src/cache/RedisInvalidationBus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE9F,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AA0BD,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsE;IAChG,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,gBAAgB,CAA+D;IACvF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAgB;IACnC,iEAAiE;IACjE,OAAO,CAAC,cAAc,CAAK;gBAEf,MAAM,GAAE,0BAA+B;IAsB7C,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C3D,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,IAAI;IAOlF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAahB,IAAI;YAgEJ,gBAAgB;IA+B9B;;;OAGG;YACW,YAAY;IAmB1B,OAAO,CAAC,YAAY;YAcN,eAAe;YASf,aAAa;IAqB3B,OAAO,CAAC,YAAY;CAcrB"}
1
+ {"version":3,"file":"RedisInvalidationBus.d.ts","sourceRoot":"","sources":["../../src/cache/RedisInvalidationBus.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE9F,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAyBD,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsE;IAChG,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,gBAAgB,CAA+D;IACvF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAgB;IACnC,iEAAiE;IACjE,OAAO,CAAC,cAAc,CAAK;gBAEf,MAAM,GAAE,0BAA+B;IAsB7C,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C3D,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,IAAI;IAOlF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAahB,IAAI;YAgEJ,gBAAgB;IA+B9B;;;OAGG;YACW,YAAY;IAmB1B,OAAO,CAAC,YAAY;YAcN,eAAe;YASf,aAAa;IAqB3B,OAAO,CAAC,YAAY;CAcrB"}
@@ -18,6 +18,7 @@ export declare class RedisResponseCacheBackend implements ResponseCacheBackend {
18
18
  commit(key: string, value: unknown, lease: CacheRenderLease, tags: string[], ttlMs: number, staticSeedUntil?: number, admission?: 'render' | 'seed'): Promise<boolean>;
19
19
  seed(key: string, value: unknown, lease: CacheRenderLease, tags: string[], ttlMs: number): Promise<boolean>;
20
20
  invalidateTag(tag: string): Promise<void>;
21
+ invalidateTags(tags: readonly string[], publicationId?: string): Promise<void>;
21
22
  remove(key: string): Promise<void>;
22
23
  clear(): Promise<void>;
23
24
  inspect(limit: number): Promise<{
@@ -1 +1 @@
1
- {"version":3,"file":"RedisResponseCacheBackend.d.ts","sourceRoot":"","sources":["../../src/cache/RedisResponseCacheBackend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,mBAAmB,QAA2B,CAAC;AAmI5D,qFAAqF;AACrF,qBAAa,yBAA0B,YAAW,oBAAoB;IAOlE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IARzB,QAAQ,CAAC,QAAQ,SAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,SAAS,CAAS;gBAGP,UAAU,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EACjD,SAAS,EAAE,MAAM,EACA,KAAK,CAAC,GAAE,MAAM,OAAO,CAAC,IAAI,CAAC,aAAA;IAQ9C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;YAIF,OAAO;IAOf,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAKpC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAejF,MAAM,CACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM,EACxB,SAAS,GAAE,QAAQ,GAAG,MAAiB,GACtC,OAAO,CAAC,OAAO,CAAC;IAyBnB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM;IAIlF,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,CAAC,KAAK,EAAE,MAAM;aAQlB,MAAM;mBACA,MAAM;6BACI,MAAM,GAAG,SAAS;;IAuBrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}
1
+ {"version":3,"file":"RedisResponseCacheBackend.d.ts","sourceRoot":"","sources":["../../src/cache/RedisResponseCacheBackend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,mBAAmB,QAA2B,CAAC;AAqJ5D,qFAAqF;AACrF,qBAAa,yBAA0B,YAAW,oBAAoB;IAOlE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IARzB,QAAQ,CAAC,QAAQ,SAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,SAAS,CAAS;gBAGP,UAAU,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EACjD,SAAS,EAAE,MAAM,EACA,KAAK,CAAC,GAAE,MAAM,OAAO,CAAC,IAAI,CAAC,aAAA;IAQ9C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;YAIF,OAAO;IAOf,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAWpC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAejF,MAAM,CACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM,EACxB,SAAS,GAAE,QAAQ,GAAG,MAAiB,GACtC,OAAO,CAAC,OAAO,CAAC;IAyBnB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM;IAIlF,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,aAAa,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,CAAC,KAAK,EAAE,MAAM;aAQlB,MAAM;mBACA,MAAM;6BACI,MAAM,GAAG,SAAS;;IAuBrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}
@@ -2,6 +2,10 @@
2
2
  export interface CacheRenderLease {
3
3
  incarnation: string;
4
4
  revision: string;
5
+ /** Durable revisions at the two latest publications, if the backend tracks them. */
6
+ contentRevision?: string;
7
+ previousContentRevision?: string;
8
+ contentPublication?: string;
5
9
  }
6
10
  export interface ResponseCacheSnapshot {
7
11
  lease: CacheRenderLease;
@@ -16,6 +20,8 @@ export interface ResponseCacheBackend {
16
20
  commit(key: string, value: unknown, lease: CacheRenderLease, tags: string[], ttlMs: number, staticSeedUntil?: number): Promise<boolean>;
17
21
  seed?(key: string, value: unknown, lease: CacheRenderLease, tags: string[], ttlMs: number): Promise<boolean>;
18
22
  invalidateTag(tag: string): Promise<void>;
23
+ /** Atomically invalidate a publication's response tags and advance its content revision. */
24
+ invalidateTags?(tags: readonly string[], publicationId: string): Promise<void>;
19
25
  remove(key: string): Promise<void>;
20
26
  clear(): Promise<void>;
21
27
  inspect?(limit: number): Promise<Array<{
@@ -1 +1 @@
1
- {"version":3,"file":"ResponseCacheBackend.d.ts","sourceRoot":"","sources":["../../src/cache/ResponseCacheBackend.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClF,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC,CACH,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,CACN,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC;IAC/F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
1
+ {"version":3,"file":"ResponseCacheBackend.d.ts","sourceRoot":"","sources":["../../src/cache/ResponseCacheBackend.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClF,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC,CACH,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,4FAA4F;IAC5F,cAAc,CAAC,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,CACN,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC;IAC/F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
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-DTlZvKBm.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-BG-s3uuL.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 { o as withLocale, t as alternates } from "../i18n-B2mWmifk.js";
1
+ import { o as withLocale, t as alternates } from "../i18n-BZpAOZeO.js";
2
2
  // src/config/defineConfig.ts
3
3
  /**
4
4
  * ssr.config.ts 的类型收口入口。
@@ -0,0 +1,10 @@
1
+ import { AsyncLocalStorage } from 'node:async_hooks';
2
+ interface TagStore {
3
+ tags: Set<string>;
4
+ uncacheable: boolean;
5
+ }
6
+ export declare function getCacheTagStorage(): AsyncLocalStorage<TagStore>;
7
+ /** Exclude a successful but degraded render from the shared response cache. */
8
+ export declare function markUncacheable(): void;
9
+ export {};
10
+ //# sourceMappingURL=CacheTagContext.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CacheTagContext.d.ts","sourceRoot":"","sources":["../../src/context/CacheTagContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,UAAU,QAAQ;IAChB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAMD,wBAAgB,kBAAkB,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAEhE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}
@@ -1,4 +1,4 @@
1
- import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-DTlZvKBm.js";
1
+ import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-BG-s3uuL.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-D6c-CINz.js.map
109
+ //# sourceMappingURL=createCacheInspectorMiddleware-glgtcBcQ.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"createCacheInspectorMiddleware-D6c-CINz.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"}
1
+ {"version":3,"file":"createCacheInspectorMiddleware-glgtcBcQ.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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"}