isr-engine 4.0.1 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +4 -1
  2. package/dist/cli/cli.js +1 -1
  3. package/dist/config/defineConfig.d.ts +1 -1
  4. package/dist/config/defineConfig.d.ts.map +1 -1
  5. package/dist/config/defineConfig.js +2 -1
  6. package/dist/config/defineConfig.js.map +1 -1
  7. package/dist/cookie-DcUeYm6E.js +42 -0
  8. package/dist/cookie-DcUeYm6E.js.map +1 -0
  9. package/dist/{createCacheInspectorMiddleware-C2QOaq2z.js → createCacheInspectorMiddleware-D6c-CINz.js} +2 -2
  10. package/dist/{createCacheInspectorMiddleware-C2QOaq2z.js.map → createCacheInspectorMiddleware-D6c-CINz.js.map} +1 -1
  11. package/dist/{createISRApp-CR1EeHfI.js → createISRApp-DTlZvKBm.js} +49 -28
  12. package/dist/createISRApp-DTlZvKBm.js.map +1 -0
  13. package/dist/defaults/runtime/client-navigation-policy.d.ts +1 -0
  14. package/dist/defaults/runtime/client-navigation-policy.d.ts.map +1 -1
  15. package/dist/defaults/runtime/defineSiteHooks.d.ts +1 -1
  16. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -1
  17. package/dist/defaults/runtime/defineSiteHooks.js +2 -2
  18. package/dist/defaults/runtime/locale-links.client.d.ts +6 -0
  19. package/dist/defaults/runtime/locale-links.client.d.ts.map +1 -0
  20. package/dist/defaults/runtime/navigation-history.client.d.ts +8 -0
  21. package/dist/defaults/runtime/navigation-history.client.d.ts.map +1 -1
  22. package/dist/{defineSiteHooks-DUEds_hB.js → defineSiteHooks-iwLiVChy.js} +15 -32
  23. package/dist/defineSiteHooks-iwLiVChy.js.map +1 -0
  24. package/dist/engine/ISREngine.d.ts.map +1 -1
  25. package/dist/engine/seo/SEOEngine.d.ts +2 -3
  26. package/dist/engine/seo/SEOEngine.d.ts.map +1 -1
  27. package/dist/engine/seo/resolveSeoConfig.d.ts +2 -0
  28. package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -1
  29. package/dist/{i18n-CJ0leKhc.js → i18n-B2mWmifk.js} +79 -57
  30. package/dist/i18n-B2mWmifk.js.map +1 -0
  31. package/dist/isr-engine.js +4 -3
  32. package/dist/isr-engine.js.map +1 -1
  33. package/dist/middlewares/LocaleRedirect.d.ts +4 -3
  34. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -1
  35. package/dist/runtime/LocaleLink.d.ts +9 -0
  36. package/dist/runtime/LocaleLink.d.ts.map +1 -0
  37. package/dist/runtime/i18n.d.ts +6 -1
  38. package/dist/runtime/i18n.d.ts.map +1 -1
  39. package/dist/runtime/index.d.ts +1 -0
  40. package/dist/runtime/index.d.ts.map +1 -1
  41. package/dist/server/productionRuntime.d.ts.map +1 -1
  42. package/dist/types/ISRConfig.d.ts +1 -1
  43. package/dist/types/ISRConfig.d.ts.map +1 -1
  44. package/package.json +1 -1
  45. package/src/defaults/runtime/client-navigation-policy.ts +11 -0
  46. package/src/defaults/runtime/defineClientEntry.tsx +86 -43
  47. package/src/defaults/runtime/defineServerEntry.tsx +9 -1
  48. package/src/defaults/runtime/defineSiteHooks.ts +19 -41
  49. package/src/defaults/runtime/locale-links.client.ts +85 -0
  50. package/src/defaults/runtime/navigation-history.client.ts +166 -1
  51. package/src/runtime/LocaleContext.tsx +1 -1
  52. package/src/runtime/LocaleLink.tsx +26 -0
  53. package/src/runtime/i18n.ts +67 -19
  54. package/src/runtime/index.ts +1 -0
  55. package/src/types/ISRConfig.ts +1 -1
  56. package/dist/createISRApp-CR1EeHfI.js.map +0 -1
  57. package/dist/defineSiteHooks-DUEds_hB.js.map +0 -1
  58. package/dist/i18n-CJ0leKhc.js.map +0 -1
package/README.md CHANGED
@@ -155,7 +155,7 @@ curl -fsS -H "x-isr-admin-token: $ISR_OPS_TOKEN" \
155
155
  | 导入路径 | 用途 |
156
156
  | --- | --- |
157
157
  | `isr-engine` | Vite 插件、Node 编排 API 与公共类型。 |
158
- | `isr-engine/config` | `defineIsrConfig`、`defineRuntimeConfig`。 |
158
+ | `isr-engine/config` | `ssr.config.ts` 使用的 `defineIsrConfig`、`defineRuntimeConfig`、`withLocale`、`alternates`。 |
159
159
  | `isr-engine/rsc` | 缓存标签、失效、服务端请求上下文。 |
160
160
  | `isr-engine/runtime` | 页面路由、边界、i18n 与浏览器 telemetry。 |
161
161
  | `isr-engine/site-hooks` | 请求 hooks 工厂与 Cookie 工具。 |
@@ -167,6 +167,9 @@ curl -fsS -H "x-isr-admin-token: $ISR_OPS_TOKEN" \
167
167
 
168
168
  ## 文档与发布
169
169
 
170
+ 语言切换可从 `isr-engine/runtime` 使用 `<LocaleLink locale="ja" config={i18n}>日本語</LocaleLink>`。
171
+ 组件在引擎接管后可操作,沿用当前路径、查询参数和锚点。
172
+
170
173
  配置字段与默认行为见 [公共配置类型](./src/types/ISRConfig.ts) 和 [默认配置](./src/config/defaults.ts)。
171
174
 
172
175
  `main` 的自动发布流程通过验证后由 semantic-release 计算版本,以 npm OIDC 发布到 `registry.npmjs.org`;配置见 [发布工作流](./.github/workflows/publish.yml) 与 [release.config.mjs](./release.config.mjs)。npm 端需绑定对应仓库和工作流的 Trusted Publisher。
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-CR1EeHfI.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-DTlZvKBm.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,5 @@
1
1
  import type { ISRConfig, RuntimeConfig } from '../types';
2
+ export { alternates, withLocale, type I18nConfig } from '../runtime/i18n';
2
3
  type ExactTopLevel<T, Shape> = T & Record<Exclude<keyof T, keyof Shape>, never>;
3
4
  type IsrServerConfig = ISRConfig['server'];
4
5
  type IsrOpsConfig = IsrServerConfig['ops'];
@@ -40,5 +41,4 @@ type ExactIsrConfig<T extends ISRConfig> = ExactTopLevel<T, ISRConfig> & ExactSe
40
41
  */
41
42
  export declare function defineIsrConfig<const T extends ISRConfig>(config: ExactIsrConfig<T>): T;
42
43
  export declare function defineRuntimeConfig<const T extends RuntimeConfig>(runtime: ExactRuntime<T>): T;
43
- export {};
44
44
  //# sourceMappingURL=defineConfig.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../src/config/defineConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzD,KAAK,aAAa,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAChF,KAAK,eAAe,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC3C,KAAK,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAC3C,KAAK,qBAAqB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AACvD,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,GAAG,CAAA;CAAE,GAC3C;IACE,GAAG,EAAE,aAAa,CAAC,GAAG,GAAG,YAAY,EAAE,YAAY,CAAC,CAAC;CACtD,GACD,OAAO,CAAC;AACZ,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,MAAM,CAAA;CAAE,GACpD;IACE,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,eAAe,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;CACrF,GACD,OAAO,CAAC;AACZ,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;CAAE,GACjE;IACE,QAAQ,EAAE,aAAa,CAAC,QAAQ,GAAG,qBAAqB,EAAE,qBAAqB,CAAC,CAAC;CAClF,GACD,OAAO,CAAC;AACZ,KAAK,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,GAC1E,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAC1B,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,OAAO,CAAA;CAAE,GAC1D;IACE,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC;CAChD,GACD,OAAO,CAAC;AACZ,KAAK,cAAc,CAAC,CAAC,SAAS,SAAS,IAAI,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC,GACpE,WAAW,CAAC,CAAC,CAAC,GACd,eAAe,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAE9F"}
1
+ {"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../src/config/defineConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1E,KAAK,aAAa,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAChF,KAAK,eAAe,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC3C,KAAK,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAC3C,KAAK,qBAAqB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AACvD,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,GAAG,CAAA;CAAE,GAC3C;IACE,GAAG,EAAE,aAAa,CAAC,GAAG,GAAG,YAAY,EAAE,YAAY,CAAC,CAAC;CACtD,GACD,OAAO,CAAC;AACZ,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,MAAM,CAAA;CAAE,GACpD;IACE,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,eAAe,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;CACrF,GACD,OAAO,CAAC;AACZ,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;CAAE,GACjE;IACE,QAAQ,EAAE,aAAa,CAAC,QAAQ,GAAG,qBAAqB,EAAE,qBAAqB,CAAC,CAAC;CAClF,GACD,OAAO,CAAC;AACZ,KAAK,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,GAC1E,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAC1B,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,OAAO,CAAA;CAAE,GAC1D;IACE,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC;CAChD,GACD,OAAO,CAAC;AACZ,KAAK,cAAc,CAAC,CAAC,SAAS,SAAS,IAAI,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC,GACpE,WAAW,CAAC,CAAC,CAAC,GACd,eAAe,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAE9F"}
@@ -1,3 +1,4 @@
1
+ import { o as withLocale, t as alternates } from "../i18n-B2mWmifk.js";
1
2
  // src/config/defineConfig.ts
2
3
  /**
3
4
  * ssr.config.ts 的类型收口入口。
@@ -18,6 +19,6 @@ function defineIsrConfig(config) {
18
19
  function defineRuntimeConfig(runtime) {
19
20
  return runtime;
20
21
  }
21
- export { defineIsrConfig, defineRuntimeConfig };
22
+ export { alternates, defineIsrConfig, defineRuntimeConfig, withLocale };
22
23
 
23
24
  //# sourceMappingURL=defineConfig.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"defineConfig.js","names":[],"sources":["../../src/config/defineConfig.ts"],"sourcesContent":["import type { ISRConfig, RuntimeConfig } from '../types';\n\ntype ExactTopLevel<T, Shape> = T & Record<Exclude<keyof T, keyof Shape>, never>;\ntype IsrServerConfig = ISRConfig['server'];\ntype IsrOpsConfig = IsrServerConfig['ops'];\ntype RuntimeServicesConfig = RuntimeConfig['services'];\ntype ExactOps<T> = T extends { ops: infer Ops }\n ? {\n ops: ExactTopLevel<Ops & IsrOpsConfig, IsrOpsConfig>;\n }\n : unknown;\ntype ExactServer<T> = T extends { server: infer Server }\n ? {\n server: ExactTopLevel<Server & IsrServerConfig, IsrServerConfig> & ExactOps<Server>;\n }\n : unknown;\ntype ExactRuntimeServices<T> = T extends { services: infer Services }\n ? {\n services: ExactTopLevel<Services & RuntimeServicesConfig, RuntimeServicesConfig>;\n }\n : unknown;\ntype ExactRuntime<T extends RuntimeConfig> = ExactTopLevel<T, RuntimeConfig> &\n ExactRuntimeServices<T>;\ntype ExactIsrRuntime<T> = T extends { runtime: infer Runtime }\n ? {\n runtime: ExactRuntime<Runtime & RuntimeConfig>;\n }\n : unknown;\ntype ExactIsrConfig<T extends ISRConfig> = ExactTopLevel<T, ISRConfig> &\n ExactServer<T> &\n ExactIsrRuntime<T>;\n\n/**\n * ssr.config.ts 的类型收口入口。\n *\n * 业务侧只需要:\n * import { defineIsrConfig } from 'isr-engine/config';\n * export default defineIsrConfig({ ... })\n *\n * 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,\n * 后续字段演进也只改 engine。\n *\n * 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin\n * 工具链打进 RSC/SSG bundle。\n */\nexport function defineIsrConfig<const T extends ISRConfig>(config: ExactIsrConfig<T>): T {\n return config;\n}\n\nexport function defineRuntimeConfig<const T extends RuntimeConfig>(runtime: ExactRuntime<T>): T {\n return runtime;\n}\n"],"mappings":";;;;;;;;;;;;;;AA6CA,SAAgB,gBAA2C,QAA8B;CACvF,OAAO;AACT;AAEA,SAAgB,oBAAmD,SAA6B;CAC9F,OAAO;AACT"}
1
+ {"version":3,"file":"defineConfig.js","names":[],"sources":["../../src/config/defineConfig.ts"],"sourcesContent":["import type { ISRConfig, RuntimeConfig } from '../types';\n\nexport { alternates, withLocale, type I18nConfig } from '../runtime/i18n';\n\ntype ExactTopLevel<T, Shape> = T & Record<Exclude<keyof T, keyof Shape>, never>;\ntype IsrServerConfig = ISRConfig['server'];\ntype IsrOpsConfig = IsrServerConfig['ops'];\ntype RuntimeServicesConfig = RuntimeConfig['services'];\ntype ExactOps<T> = T extends { ops: infer Ops }\n ? {\n ops: ExactTopLevel<Ops & IsrOpsConfig, IsrOpsConfig>;\n }\n : unknown;\ntype ExactServer<T> = T extends { server: infer Server }\n ? {\n server: ExactTopLevel<Server & IsrServerConfig, IsrServerConfig> & ExactOps<Server>;\n }\n : unknown;\ntype ExactRuntimeServices<T> = T extends { services: infer Services }\n ? {\n services: ExactTopLevel<Services & RuntimeServicesConfig, RuntimeServicesConfig>;\n }\n : unknown;\ntype ExactRuntime<T extends RuntimeConfig> = ExactTopLevel<T, RuntimeConfig> &\n ExactRuntimeServices<T>;\ntype ExactIsrRuntime<T> = T extends { runtime: infer Runtime }\n ? {\n runtime: ExactRuntime<Runtime & RuntimeConfig>;\n }\n : unknown;\ntype ExactIsrConfig<T extends ISRConfig> = ExactTopLevel<T, ISRConfig> &\n ExactServer<T> &\n ExactIsrRuntime<T>;\n\n/**\n * ssr.config.ts 的类型收口入口。\n *\n * 业务侧只需要:\n * import { defineIsrConfig } from 'isr-engine/config';\n * export default defineIsrConfig({ ... })\n *\n * 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,\n * 后续字段演进也只改 engine。\n *\n * 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin\n * 工具链打进 RSC/SSG bundle。\n */\nexport function defineIsrConfig<const T extends ISRConfig>(config: ExactIsrConfig<T>): T {\n return config;\n}\n\nexport function defineRuntimeConfig<const T extends RuntimeConfig>(runtime: ExactRuntime<T>): T {\n return runtime;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+CA,SAAgB,gBAA2C,QAA8B;CACvF,OAAO;AACT;AAEA,SAAgB,oBAAmD,SAA6B;CAC9F,OAAO;AACT"}
@@ -0,0 +1,42 @@
1
+ // src/utils/cookie.ts
2
+ function getCookieHeader(source) {
3
+ if (!source) return "";
4
+ if (typeof source === "string") return source;
5
+ const headers = source.headers;
6
+ if (!headers) return "";
7
+ if (typeof headers.get === "function") return headers.get("cookie") ?? "";
8
+ const record = headers;
9
+ const raw = record.cookie ?? record.Cookie;
10
+ if (Array.isArray(raw)) return raw.join("; ");
11
+ return raw === void 0 || raw === null ? "" : String(raw);
12
+ }
13
+ function readCookie(source, name) {
14
+ if (!name) return void 0;
15
+ return parseCookieHeader(getCookieHeader(source))[name];
16
+ }
17
+ function parseCookieHeader(header) {
18
+ const entries = /* @__PURE__ */ new Map();
19
+ for (const part of header.split(";")) {
20
+ const trimmed = part.trim();
21
+ if (!trimmed) continue;
22
+ const index = trimmed.indexOf("=");
23
+ if (index <= 0) continue;
24
+ const key = trimmed.slice(0, index).trim();
25
+ if (!key) continue;
26
+ const rawValue = trimmed.slice(index + 1).trim();
27
+ entries.set(key, safeDecodeCookieValue(rawValue));
28
+ }
29
+ const cookies = Object.fromEntries(entries);
30
+ Object.setPrototypeOf(cookies, null);
31
+ return cookies;
32
+ }
33
+ function safeDecodeCookieValue(value) {
34
+ try {
35
+ return decodeURIComponent(value);
36
+ } catch {
37
+ return value;
38
+ }
39
+ }
40
+ export { parseCookieHeader as n, readCookie as r, getCookieHeader as t };
41
+
42
+ //# sourceMappingURL=cookie-DcUeYm6E.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie-DcUeYm6E.js","names":[],"sources":["../src/utils/cookie.ts"],"sourcesContent":["export type CookieHeaderSource =\n | string\n | null\n | undefined\n | {\n headers?: Headers | Record<string, string | string[] | number | undefined | null>;\n };\n\nexport function getCookieHeader(source: CookieHeaderSource): string {\n if (!source) return '';\n if (typeof source === 'string') return source;\n\n const headers = source.headers;\n if (!headers) return '';\n\n if (typeof (headers as Headers).get === 'function') {\n return (headers as Headers).get('cookie') ?? '';\n }\n\n const record = headers as Record<string, string | string[] | number | undefined | null>;\n const raw = record.cookie ?? record.Cookie;\n if (Array.isArray(raw)) return raw.join('; ');\n return raw === undefined || raw === null ? '' : String(raw);\n}\n\nexport function readCookie(source: CookieHeaderSource, name: string): string | undefined {\n if (!name) return undefined;\n const cookies = parseCookieHeader(getCookieHeader(source));\n return cookies[name];\n}\n\nexport function parseCookieHeader(header: string): Record<string, string> {\n const entries = new Map<string, string>();\n\n for (const part of header.split(';')) {\n const trimmed = part.trim();\n if (!trimmed) continue;\n\n const index = trimmed.indexOf('=');\n if (index <= 0) continue;\n\n const key = trimmed.slice(0, index).trim();\n if (!key) continue;\n\n const rawValue = trimmed.slice(index + 1).trim();\n entries.set(key, safeDecodeCookieValue(rawValue));\n }\n\n // fromEntries creates own data properties, including __proto__, without invoking setters.\n const cookies = Object.fromEntries(entries);\n Object.setPrototypeOf(cookies, null);\n return cookies;\n}\n\nfunction safeDecodeCookieValue(value: string): string {\n try {\n return decodeURIComponent(value);\n } catch {\n return value;\n }\n}\n"],"mappings":";AAQA,SAAgB,gBAAgB,QAAoC;CAClE,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,WAAW,UAAU,OAAO;CAEvC,MAAM,UAAU,OAAO;CACvB,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI,OAAQ,QAAoB,QAAQ,YACtC,OAAQ,QAAoB,IAAI,QAAQ,KAAK;CAG/C,MAAM,SAAS;CACf,MAAM,MAAM,OAAO,UAAU,OAAO;CACpC,IAAI,MAAM,QAAQ,GAAG,GAAG,OAAO,IAAI,KAAK,IAAI;CAC5C,OAAO,QAAQ,KAAA,KAAa,QAAQ,OAAO,KAAK,OAAO,GAAG;AAC5D;AAEA,SAAgB,WAAW,QAA4B,MAAkC;CACvF,IAAI,CAAC,MAAM,OAAO,KAAA;CAElB,OADgB,kBAAkB,gBAAgB,MAAM,CACjD,CAAA,CAAQ;AACjB;AAEA,SAAgB,kBAAkB,QAAwC;CACxE,MAAM,0BAAU,IAAI,IAAoB;CAExC,KAAK,MAAM,QAAQ,OAAO,MAAM,GAAG,GAAG;EACpC,MAAM,UAAU,KAAK,KAAK;EAC1B,IAAI,CAAC,SAAS;EAEd,MAAM,QAAQ,QAAQ,QAAQ,GAAG;EACjC,IAAI,SAAS,GAAG;EAEhB,MAAM,MAAM,QAAQ,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK;EACzC,IAAI,CAAC,KAAK;EAEV,MAAM,WAAW,QAAQ,MAAM,QAAQ,CAAC,CAAC,CAAC,KAAK;EAC/C,QAAQ,IAAI,KAAK,sBAAsB,QAAQ,CAAC;CAClD;CAGA,MAAM,UAAU,OAAO,YAAY,OAAO;CAC1C,OAAO,eAAe,SAAS,IAAI;CACnC,OAAO;AACT;AAEA,SAAS,sBAAsB,OAAuB;CACpD,IAAI;EACF,OAAO,mBAAmB,KAAK;CACjC,QAAQ;EACN,OAAO;CACT;AACF"}
@@ -1,4 +1,4 @@
1
- import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-CR1EeHfI.js";
1
+ import { E as getOpsRequestLimiter, T as createOpsAuthMiddleware } from "./createISRApp-DTlZvKBm.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-C2QOaq2z.js.map
109
+ //# sourceMappingURL=createCacheInspectorMiddleware-D6c-CINz.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"createCacheInspectorMiddleware-C2QOaq2z.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-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":"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"}
@@ -1,5 +1,6 @@
1
1
  import { C as getTraceId, S as getRequestId, T as requestContext, _ as escapeSupplementalLogControls, a as isUncacheable, f as setRevalidationMetricRecorder, g as encodeSpinnerMessage, h as encodeLogField, l as registerInvalidator, m as setOriginLogger, r as collectTags, s as runWithTagStore, v as snapshotLogArgument, x as getRequestContext } from "./abVariantContext-CGBlCt0q.js";
2
- import { o as parseCookieHeader, r as resolveI18nConfig, s as readCookie, t as negotiateLocale } from "./i18n-CJ0leKhc.js";
2
+ import { n as parseCookieHeader, r as readCookie } from "./cookie-DcUeYm6E.js";
3
+ import { a as selectAcceptableLocale, i as resolveI18nConfig } from "./i18n-B2mWmifk.js";
3
4
  import fs, { createReadStream, promises } from "node:fs";
4
5
  import path from "node:path";
5
6
  import express from "express";
@@ -1654,7 +1655,7 @@ function resolveFetchHandler(module) {
1654
1655
  }
1655
1656
  var package_default = {
1656
1657
  name: "isr-engine",
1657
- version: "4.0.1",
1658
+ version: "4.1.0",
1658
1659
  description: "ISR/SSG/Fallback rendering orchestration on Vite + React 19 RSC.",
1659
1660
  license: "UNLICENSED",
1660
1661
  repository: {
@@ -4900,7 +4901,7 @@ function createIsrCacheMiddleware(explicitConfig, options = {}) {
4900
4901
  development: true
4901
4902
  }));
4902
4903
  try {
4903
- const inspector = opsConfig.inventory.enabled ? (await import("./createCacheInspectorMiddleware-C2QOaq2z.js")).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4904
+ const inspector = opsConfig.inventory.enabled ? (await import("./createCacheInspectorMiddleware-D6c-CINz.js")).createCacheInspectorMiddleware(nextHandler, opsConfig) : void 0;
4904
4905
  handler = nextHandler;
4905
4906
  server.middlewares.use((req, res, next) => {
4906
4907
  if (handler !== nextHandler) return next();
@@ -6240,6 +6241,12 @@ function mergeSEOConfig(base, override) {
6240
6241
  * - 站点地图生成
6241
6242
  * - Open Graph / Twitter Cards
6242
6243
  */
6244
+ var SITEMAP_DATE = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:\d{2}))?$/;
6245
+ function validLastModified(value) {
6246
+ if (!value || !SITEMAP_DATE.test(value) || !Number.isFinite(Date.parse(value))) return;
6247
+ const day = value.slice(0, 10);
6248
+ if (new Date(day).toISOString().slice(0, 10) === day) return value;
6249
+ }
6243
6250
  var SEOEngine = class SEOEngine {
6244
6251
  static instance = null;
6245
6252
  logger = Logger.getInstance();
@@ -6247,7 +6254,6 @@ var SEOEngine = class SEOEngine {
6247
6254
  initialized = false;
6248
6255
  pageDataCache = /* @__PURE__ */ new Map();
6249
6256
  sitemapCache = null;
6250
- sitemapLastGenerated = 0;
6251
6257
  constructor(config) {
6252
6258
  this.config = config ? mergeSEOConfig(DEFAULT_SEO_CONFIG, config) : { ...DEFAULT_SEO_CONFIG };
6253
6259
  }
@@ -6292,28 +6298,33 @@ var SEOEngine = class SEOEngine {
6292
6298
  }
6293
6299
  };
6294
6300
  }
6295
- /** 生成站点地图 */
6296
- async generateSitemap(routes) {
6301
+ /** 生成站点地图;lastModifiedByUrl 只接受已知的页面内容更新时间。 */
6302
+ async generateSitemap(routes, lastModifiedByUrl) {
6303
+ const urls = routes ?? Array.from(this.pageDataCache.keys());
6304
+ const entries = (urls.length > 0 ? urls : ["/"]).filter((url) => !this.shouldExcludeUrl(url)).map((url) => ({
6305
+ url,
6306
+ lastmod: validLastModified(lastModifiedByUrl?.get(url))
6307
+ }));
6308
+ const key = JSON.stringify(entries);
6297
6309
  const now = Date.now();
6298
- if (this.sitemapCache && now - this.sitemapLastGenerated < this.config.sitemap.cacheTimeout * 1e3) return this.sitemapCache;
6310
+ if (this.sitemapCache?.key === key && now - this.sitemapCache.generatedAt < this.config.sitemap.cacheTimeout * 1e3) return this.sitemapCache.xml;
6299
6311
  if (!this.config.baseUrl) throw new Error("SEO baseUrl 未配置,无法生成 sitemap。请设置 ssr.config.ts runtime.site。");
6300
6312
  const sitemap = new SitemapStream({ hostname: this.config.baseUrl });
6301
- const urls = routes || Array.from(this.pageDataCache.keys());
6302
- const finalUrls = urls.length > 0 ? urls : ["/"];
6303
- for (const url of finalUrls) {
6304
- if (this.shouldExcludeUrl(url)) continue;
6305
- sitemap.write({
6306
- url,
6307
- priority: this.getUrlPriority(url),
6308
- changefreq: this.getUrlChangeFreq(url),
6309
- lastmod: (/* @__PURE__ */ new Date()).toISOString()
6310
- });
6311
- }
6313
+ for (const { url, lastmod } of entries) sitemap.write({
6314
+ url,
6315
+ priority: this.getUrlPriority(url),
6316
+ changefreq: this.getUrlChangeFreq(url),
6317
+ lastmod
6318
+ });
6312
6319
  sitemap.end();
6313
- this.sitemapCache = (await streamToPromise(sitemap)).toString();
6314
- this.sitemapLastGenerated = now;
6315
- this.logger.info(`✅ 站点地图已生成: ${urls.length} 个页面`);
6316
- return this.sitemapCache;
6320
+ const xml = (await streamToPromise(sitemap)).toString();
6321
+ this.sitemapCache = {
6322
+ key,
6323
+ xml,
6324
+ generatedAt: now
6325
+ };
6326
+ this.logger.info(`✅ 站点地图已生成: ${entries.length} 个页面`);
6327
+ return xml;
6317
6328
  }
6318
6329
  /** 生成 Robots.txt */
6319
6330
  generateRobotsTxt() {
@@ -6330,7 +6341,6 @@ var SEOEngine = class SEOEngine {
6330
6341
  clearCache() {
6331
6342
  this.pageDataCache.clear();
6332
6343
  this.sitemapCache = null;
6333
- this.sitemapLastGenerated = 0;
6334
6344
  }
6335
6345
  /** 关闭引擎 */
6336
6346
  async shutdown() {
@@ -6501,6 +6511,12 @@ function resolveSeoConfig(config) {
6501
6511
  baseUrlSource: source
6502
6512
  };
6503
6513
  }
6514
+ /** 取本地 SEO 条目明确声明的内容更新时间,仅用于完全匹配的 sitemap URL。 */
6515
+ function resolveSitemapLastModified(config) {
6516
+ const timestamps = /* @__PURE__ */ new Map();
6517
+ for (const { path, modifiedTime } of config.runtime?.seo?.fallbackLocal ?? []) if (typeof path === "string" && typeof modifiedTime === "string" && !timestamps.has(path)) timestamps.set(path, modifiedTime);
6518
+ return timestamps;
6519
+ }
6504
6520
  // src/experiments/ExposureQueue.ts
6505
6521
  /**
6506
6522
  * ExposureQueue —— 曝光事件批量上报队列
@@ -6935,7 +6951,11 @@ function createLocaleRedirectMiddleware(options) {
6935
6951
  }
6936
6952
  }
6937
6953
  const cookieLocale = readCookieLocale(typeof req.headers["cookie"] === "string" ? req.headers["cookie"] : "");
6938
- const target = (cookieLocale && localePrefixes.has(cookieLocale) ? cookieLocale : null) || negotiateLocale(typeof req.headers["accept-language"] === "string" ? req.headers["accept-language"] : null, i18n);
6954
+ const target = (cookieLocale && localePrefixes.has(cookieLocale) ? cookieLocale : null) || selectAcceptableLocale(typeof req.headers["accept-language"] === "string" ? req.headers["accept-language"] : null, i18n);
6955
+ if (target === null) {
6956
+ res.vary("Accept-Language").vary("Cookie").status(406).end();
6957
+ return;
6958
+ }
6939
6959
  const prefix = localePrefixes.get(target);
6940
6960
  if (!prefix) {
6941
6961
  res.status(400).end();
@@ -7431,7 +7451,7 @@ async function createProductionRuntime(config, options = {}) {
7431
7451
  });
7432
7452
  cleanups.push(() => cache.destroy());
7433
7453
  if (opsConfig.inventory.enabled) {
7434
- const { createCacheInspectorMiddleware } = await import("./createCacheInspectorMiddleware-C2QOaq2z.js");
7454
+ const { createCacheInspectorMiddleware } = await import("./createCacheInspectorMiddleware-D6c-CINz.js");
7435
7455
  app.use(createCacheInspectorMiddleware(cache, opsConfig));
7436
7456
  logger$8.info("🔍 ISR cache inventory 已启用:GET /__isr/cache/inventory");
7437
7457
  }
@@ -7466,11 +7486,12 @@ async function createProductionRuntime(config, options = {}) {
7466
7486
  });
7467
7487
  const seoCfg = resolveSeoConfig(config);
7468
7488
  const seo = SEOEngine.getInstance({ baseUrl: seoCfg.baseUrl });
7489
+ const sitemapLastModified = resolveSitemapLastModified(config);
7469
7490
  cleanups.push(() => seo.shutdown());
7470
7491
  await seo.initialize();
7471
7492
  app.get("/sitemap.xml", async (_req, res) => {
7472
7493
  try {
7473
- const xml = await seo.generateSitemap(extractRoutesForSitemap(config));
7494
+ const xml = await seo.generateSitemap(extractRoutesForSitemap(config), sitemapLastModified);
7474
7495
  res.set("content-type", "application/xml; charset=utf-8");
7475
7496
  res.set("cache-control", "public, max-age=3600");
7476
7497
  res.end(xml);
@@ -8260,7 +8281,7 @@ var ISREngine = class {
8260
8281
  await fs.promises.mkdir(outputDir, { recursive: true });
8261
8282
  const robotsTxt = this.seoEngine.generateRobotsTxt();
8262
8283
  await fs.promises.writeFile(path.join(outputDir, "robots.txt"), robotsTxt, "utf-8");
8263
- const sitemapXml = await this.seoEngine.generateSitemap();
8284
+ const sitemapXml = await this.seoEngine.generateSitemap(void 0, resolveSitemapLastModified(this.config));
8264
8285
  await fs.promises.writeFile(path.join(outputDir, "sitemap.xml"), sitemapXml, "utf-8");
8265
8286
  }
8266
8287
  /**
@@ -8321,4 +8342,4 @@ async function createISRApp(appOption) {
8321
8342
  }
8322
8343
  export { parseComponents as $, invalidatorRunsTotal as A, InternalStrategies as B, createCoherentCacheStore as C, loadConfig as D, getOpsRequestLimiter as E, getFallbackChain as F, DEFAULT_PORT as G, extractSsgRoutes as H, getRouteFallbackChain as I, DEFAULT_SCAN_CONFIG as J, package_default as K, matchRoutePattern as L, recordHttpRequest as M, createHybridCacheStore as N, createPrometheusMetricsMiddleware as O, createMemoryCacheStore as P, parseComponentFromFile as Q, resolveRenderMode as R, MemoryCacheAdapter as S, createOpsAuthMiddleware as T, spiderSsgRoutes as U, RenderModes as V, logger$8 as W, scanProject as X, scanComponents as Y, scanRoutes as Z, requestPinnedImage as _, closeServer as a, isDev as at, RedisInvalidationBus as b, prepareProductionBuild as c, CacheCleanup as ct, SEOEngine as d, resolveImageOptions as dt, parseRouteFromFile as et, createSEOEngine as f, createImagePlugin as g, createImageMiddleware as h, startAppServer as i, readDirRecursive as it, promRegistry as j, invalidatorFailuresTotal as k, generateStaticCspManifest as l, Logger as lt, mergeSEOConfig as m, ISREngine as n, isCodeFile as nt, startServer as o, isProd as ot, DEFAULT_SEO_CONFIG as p, resolveFetchHandler as q, shutdownServer as r, isTestFile as rt, createProductionRuntime as s, getEnv as st, createISRApp as t, parseRoutes as tt, createABVariantMiddleware as u, assertDistinctHtmlRouteIdentities as ut, createIsrCacheHandler as v, createDevAssetRequestMiddleware as w, RedisCacheAdapter as x, createIsrCacheMiddleware as y, FallbackChain as z };
8323
8344
 
8324
- //# sourceMappingURL=createISRApp-CR1EeHfI.js.map
8345
+ //# sourceMappingURL=createISRApp-DTlZvKBm.js.map