isr-engine 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/README.md +8 -0
  2. package/dist/Logger-DqBS_3v8.cjs +184 -0
  3. package/dist/Logger-DqBS_3v8.cjs.map +1 -0
  4. package/dist/Logger-bg-doGwZ.js +174 -0
  5. package/dist/Logger-bg-doGwZ.js.map +1 -0
  6. package/dist/{abVariantContext-BcnxBn4V.cjs → abVariantContext-BvAMuhjj.cjs} +194 -122
  7. package/dist/abVariantContext-BvAMuhjj.cjs.map +1 -0
  8. package/dist/{abVariantContext-BmZZi1YZ.js → abVariantContext-Ud3aZ1yk.js} +117 -118
  9. package/dist/abVariantContext-Ud3aZ1yk.js.map +1 -0
  10. package/dist/cli/cli.cjs +1 -1
  11. package/dist/cli/cli.js +1 -1
  12. package/dist/config/normalizeEngineConfig.d.ts.map +1 -1
  13. package/dist/{createCacheInspectorMiddleware-BY6MX88X.js → createCacheInspectorMiddleware-Bjku5v62.js} +10 -5
  14. package/dist/createCacheInspectorMiddleware-Bjku5v62.js.map +1 -0
  15. package/dist/{createCacheInspectorMiddleware-DZr98Zfn.cjs → createCacheInspectorMiddleware-DG1_VLBS.cjs} +12 -5
  16. package/dist/createCacheInspectorMiddleware-DG1_VLBS.cjs.map +1 -0
  17. package/dist/{createISRApp-CS6XfjHl.js → createISRApp-DYVU8ydT.js} +402 -68
  18. package/dist/createISRApp-DYVU8ydT.js.map +1 -0
  19. package/dist/{createISRApp-CHiiWF3P.cjs → createISRApp-HX6X8UNb.cjs} +433 -92
  20. package/dist/createISRApp-HX6X8UNb.cjs.map +1 -0
  21. package/dist/{createImagePlugin-Ddo5t3dJ.js → createImagePlugin-BZJHOvN9.js} +67 -21
  22. package/dist/createImagePlugin-BZJHOvN9.js.map +1 -0
  23. package/dist/{createImagePlugin-BtJzr0t-.cjs → createImagePlugin-Ca4t_WhM.cjs} +73 -21
  24. package/dist/createImagePlugin-Ca4t_WhM.cjs.map +1 -0
  25. package/dist/defaults/runtime/browserObservability.d.ts.map +1 -1
  26. package/dist/defaults/runtime/defineSiteHooks.cjs +2 -2
  27. package/dist/defaults/runtime/defineSiteHooks.js +2 -2
  28. package/dist/{defineSiteHooks-BeVy-qPH.js → defineSiteHooks-CV4tqHvB.js} +11 -5
  29. package/dist/{defineSiteHooks-BeVy-qPH.js.map → defineSiteHooks-CV4tqHvB.js.map} +1 -1
  30. package/dist/{defineSiteHooks-C3v3WLS8.cjs → defineSiteHooks-w2IrF5-D.cjs} +11 -5
  31. package/dist/{defineSiteHooks-C3v3WLS8.cjs.map → defineSiteHooks-w2IrF5-D.cjs.map} +1 -1
  32. package/dist/engine/ISREngine.d.ts.map +1 -1
  33. package/dist/{i18n-CyJIoYJT.cjs → i18n-CS5QhOO0.cjs} +7 -30
  34. package/dist/i18n-CS5QhOO0.cjs.map +1 -0
  35. package/dist/{i18n-Dobe0Wxn.js → i18n-CnXYAgQE.js} +8 -25
  36. package/dist/i18n-CnXYAgQE.js.map +1 -0
  37. package/dist/isr/ISRRoutes.d.ts +3 -1
  38. package/dist/isr/ISRRoutes.d.ts.map +1 -1
  39. package/dist/isr-engine.cjs +576 -94
  40. package/dist/isr-engine.cjs.map +1 -1
  41. package/dist/isr-engine.js +571 -89
  42. package/dist/isr-engine.js.map +1 -1
  43. package/dist/logger/Logger.d.ts +6 -2
  44. package/dist/logger/Logger.d.ts.map +1 -1
  45. package/dist/logger/logRecord.d.ts +11 -0
  46. package/dist/logger/logRecord.d.ts.map +1 -0
  47. package/dist/logger/runtimeLogger.d.ts +6 -0
  48. package/dist/logger/runtimeLogger.d.ts.map +1 -0
  49. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -1
  50. package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -1
  51. package/dist/plugin/createFontPlugin.d.ts +1 -1
  52. package/dist/plugin/createFontPlugin.d.ts.map +1 -1
  53. package/dist/plugin/googleFontAssets.d.ts +23 -0
  54. package/dist/plugin/googleFontAssets.d.ts.map +1 -0
  55. package/dist/plugin/isrCacheMiddleware.d.ts +5 -0
  56. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -1
  57. package/dist/plugin/remoteImageSource.d.ts +3 -3
  58. package/dist/plugin/remoteImageSource.d.ts.map +1 -1
  59. package/dist/rsc/ServerActions.d.ts.map +1 -1
  60. package/dist/rsc/cacheTag.d.ts.map +1 -1
  61. package/dist/rsc/index.cjs +8 -9
  62. package/dist/rsc/index.js +2 -3
  63. package/dist/rsc/revalidate.d.ts.map +1 -1
  64. package/dist/{rsc-BSxvkPHd.js → rsc-BJzB9s8U.js} +4 -6
  65. package/dist/rsc-BJzB9s8U.js.map +1 -0
  66. package/dist/{rsc-NB-Uka7j.cjs → rsc-CYT6B6bf.cjs} +5 -7
  67. package/dist/rsc-CYT6B6bf.cjs.map +1 -0
  68. package/dist/server/manager.d.ts.map +1 -1
  69. package/dist/server/opsConfig.d.ts +7 -1
  70. package/dist/server/opsConfig.d.ts.map +1 -1
  71. package/dist/server/productionRuntime.d.ts +2 -3
  72. package/dist/server/productionRuntime.d.ts.map +1 -1
  73. package/dist/server/requestLimits.d.ts +36 -0
  74. package/dist/server/requestLimits.d.ts.map +1 -0
  75. package/dist/server/safeRedirect.d.ts +6 -0
  76. package/dist/server/safeRedirect.d.ts.map +1 -0
  77. package/dist/types/ISRConfig.d.ts +17 -0
  78. package/dist/types/ISRConfig.d.ts.map +1 -1
  79. package/dist/utils/cookie.d.ts.map +1 -1
  80. package/package.json +3 -1
  81. package/src/defaults/runtime/browserObservability.ts +27 -9
  82. package/src/defaults/runtime/defineServerEntry.tsx +2 -2
  83. package/src/defaults/runtime/defineSiteHooks.ts +12 -7
  84. package/src/types/ISRConfig.ts +19 -0
  85. package/src/utils/cookie.ts +5 -3
  86. package/dist/RequestContext-BVQ-rOmV.js +0 -58
  87. package/dist/RequestContext-BVQ-rOmV.js.map +0 -1
  88. package/dist/RequestContext-DgGEAxcW.cjs +0 -105
  89. package/dist/RequestContext-DgGEAxcW.cjs.map +0 -1
  90. package/dist/abVariantContext-BcnxBn4V.cjs.map +0 -1
  91. package/dist/abVariantContext-BmZZi1YZ.js.map +0 -1
  92. package/dist/createCacheInspectorMiddleware-BY6MX88X.js.map +0 -1
  93. package/dist/createCacheInspectorMiddleware-DZr98Zfn.cjs.map +0 -1
  94. package/dist/createISRApp-CHiiWF3P.cjs.map +0 -1
  95. package/dist/createISRApp-CS6XfjHl.js.map +0 -1
  96. package/dist/createImagePlugin-BtJzr0t-.cjs.map +0 -1
  97. package/dist/createImagePlugin-Ddo5t3dJ.js.map +0 -1
  98. package/dist/i18n-CyJIoYJT.cjs.map +0 -1
  99. package/dist/i18n-Dobe0Wxn.js.map +0 -1
  100. package/dist/rsc-BSxvkPHd.js.map +0 -1
  101. package/dist/rsc-NB-Uka7j.cjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"defineSiteHooks-BeVy-qPH.js","names":[],"sources":["../src/defaults/runtime/createCachedFetcher.ts","../src/defaults/runtime/defineSiteHooks.ts"],"sourcesContent":["/**\n * createCachedFetcher —— 通用 TTL + 并发去重数据加载器\n *\n * 设计目标:\n * - 给 i18n / SEO 这类「url 或本地 json」加载场景一个唯一的成熟实现\n * - 同 key 的并发请求自动合并为一次(避免缓存击穿)\n * - 过期后台刷新可选(SWR 模式)\n *\n * 用例:\n * const loadMessages = createCachedFetcher<IntlPayload>({\n * key: ({ locale }) => `intl:${locale}`,\n * ttl: 60_000,\n * fetch: async ({ locale }) => {\n * const r = await fetch(`https://cdn.example.com/i18n/${locale}.json`);\n * return r.json();\n * },\n * });\n *\n * // 在 hook 里用:\n * loadIntl: (url) => loadMessages({ locale: detectLocale(url) }),\n */\n/**\n * 极简 LRU —— 利用 Map 的插入顺序保留特性\n *\n * 不引外部 lru-cache 包是为了规避用户 RSC bundle 的 ESM/CJS interop 抖动\n * (lru-cache@10 双发布在 rolldown 里偶发 default vs 命名导出错位)\n * 本文件用于 i18n / SEO 数据的请求级缓存(典型 < 100 条),简单 Map 完全够用\n */\nclass TinyLRU<K, V> {\n private store = new Map<K, V>();\n constructor(private max: number) {}\n get(k: K): V | undefined {\n const v = this.store.get(k);\n if (v !== undefined) {\n // 触发 LRU:删后再 set,使其变成最新插入\n this.store.delete(k);\n this.store.set(k, v);\n }\n return v;\n }\n set(k: K, v: V): void {\n if (this.store.has(k)) this.store.delete(k);\n this.store.set(k, v);\n if (this.store.size > this.max) {\n const oldest = this.store.keys().next().value;\n if (oldest !== undefined) this.store.delete(oldest);\n }\n }\n}\n\nexport interface CachedFetcherOptions<TArg, TValue> {\n /** 从入参生成缓存 key */\n key: (arg: TArg) => string;\n /** 实际加载逻辑(network / fs / dynamic import 都可) */\n fetch: (arg: TArg) => Promise<TValue>;\n /** 缓存 TTL(毫秒),默认 60s */\n ttl?: number;\n /** LRU 容量,默认 500 */\n max?: number;\n /** 启用 stale-while-revalidate:过期仍返回旧值,后台异步刷新(默认 false) */\n swr?: boolean;\n /** 拉取失败时的回退值(如不提供则抛错) */\n fallback?: (arg: TArg, error: unknown) => TValue | Promise<TValue>;\n}\n\ninterface Entry<T> {\n value: T;\n expiresAt: number;\n}\n\nexport type CachedFetcher<TArg, TValue> = (arg: TArg) => Promise<TValue>;\n\nexport function createCachedFetcher<TArg, TValue>(\n opts: CachedFetcherOptions<TArg, TValue>\n): CachedFetcher<TArg, TValue> {\n const ttl = opts.ttl ?? 60_000;\n const max = opts.max ?? 500;\n const cache = new TinyLRU<string, Entry<TValue>>(max);\n const inflight = new Map<string, Promise<TValue>>();\n\n async function load(arg: TArg): Promise<TValue> {\n try {\n const v = await opts.fetch(arg);\n cache.set(opts.key(arg), { value: v, expiresAt: Date.now() + ttl });\n return v;\n } catch (err) {\n if (opts.fallback) return await opts.fallback(arg, err);\n throw err;\n }\n }\n\n return async function cachedFetcher(arg: TArg): Promise<TValue> {\n const key = opts.key(arg);\n const entry = cache.get(key);\n const now = Date.now();\n\n if (entry && entry.expiresAt > now) {\n return entry.value;\n }\n\n if (entry && opts.swr) {\n // SWR:返回旧值,后台刷新(不阻塞);如已有 in-flight 则不重复触发\n if (!inflight.has(key)) {\n const p = load(arg).finally(() => inflight.delete(key));\n inflight.set(key, p);\n p.catch(() => {\n /* 后台刷新失败保留旧值 */\n });\n }\n return entry.value;\n }\n\n // miss 或非 SWR 过期:合并并发到同一个 promise\n const existing = inflight.get(key);\n if (existing) return existing;\n\n const p = load(arg).finally(() => inflight.delete(key));\n inflight.set(key, p);\n return p;\n };\n}\n","/**\n * defineSiteHooks —— 高阶 FaaS hooks 工厂(声明式配置 → 完整 ServerEntryHooks)\n *\n * 让用户的 src/entry.server.tsx 收紧到「只写请求期 hooks」。\n * 部署/平台配置(api/site/redis/experiments/i18n/seo/telemetry)放\n * ssr.config.ts 的 runtime 字段;entry.server.tsx 只保留 beforeRequest / onError。\n * 注:experiments 是 experimentation platform 的通用字段名,业务侧可理解为 A/B testing。\n * 内部固化:\n * - i18n 字典缓存(createCachedFetcher: TTL/SWR/dedup/fallback)\n * - SEO 路由表 pattern → resolver\n * - locale 检测(cookie → Accept-Language → 默认)\n * - i18n/seo 远端相对 endpoint 统一使用 runtime.services.api\n * - 服务端渲染错误打印 + runtime.telemetry errors endpoint 上报\n *\n * beforeRequest 的边界:\n * - 它在每次 HTTP/RSC 请求进入渲染前执行。\n * - 返回值会合并进 RequestContext,Server Component 用 getRequestContext() 读取。\n * - 适合放 userId / tenantId / requestSegment 这类请求现场字段。\n * - 不适合放 Redis、SEO、i18n、A/B 定义、慢 API 或数据库查询。\n * - A/B variant 由 runtime.experiments + engine middleware 注入,页面用 getVariant()。\n *\n * 用户态写法(商业项目推荐):\n * import { defineAdminSiteHooks } from 'isr-engine/site-hooks';\n *\n * export default defineAdminSiteHooks({\n * beforeRequest: req => ({\n * userId: req.headers.get('x-user-id') ?? undefined,\n * tenantId: req.headers.get('x-tenant-id') ?? 'public',\n * requestSegment: req.headers.get('x-segment') ?? 'default',\n * }),\n * });\n */\nimport { trimTrailingSlashes } from '../../utils/trimTrailingSlashes';\nimport { createCachedFetcher } from './createCachedFetcher';\nimport type { IntlPayload, PageSeoMeta } from './seo-runtime';\nimport type {\n DynamicSeoResolver,\n ISRConfig,\n RuntimeI18nConfig,\n RuntimeSeoConfig,\n} from '../../types';\nimport { readCookie } from '../../utils/cookie';\nimport { parseLocale, type I18nConfig } from '../../runtime/i18n';\n\nexport { getCookieHeader, parseCookieHeader, readCookie } from '../../utils/cookie';\n\nexport type SiteRuntimeConfig = ISRConfig['runtime'];\n\nexport interface SiteRuntimeContext {\n runtime: SiteRuntimeConfig;\n services: RuntimeServices;\n telemetry?: string;\n site?: string;\n}\n\nexport interface RuntimeServices {\n api?: string;\n telemetry?: string;\n}\n\nfunction createEmptyRuntimeConfig(): SiteRuntimeConfig {\n return {\n site: undefined,\n services: { api: undefined, telemetry: undefined },\n redis: undefined,\n experiments: {},\n i18n: undefined,\n seo: undefined,\n telemetry: false,\n };\n}\n\nexport type RuntimeServiceBase = string | ((ctx: SiteRuntimeContext) => string | null | undefined);\n\nexport type IntlMessagesByLocale = Record<string, Record<string, unknown>>;\n\nexport interface CreateAdminIntlLoaderOptions {\n /** 远端字典端点;相对路径会用 runtime.services.api 拼接 */\n endpoint?: string;\n /** 本地兜底字典,通常来自 ssr.config.ts runtime.i18n.fallbackLocal */\n fallbackMessages?: IntlMessagesByLocale;\n /** 远端和本地都无法命中时使用的 locale */\n defaultLocale?: string;\n /** 远端请求超时,默认 1200ms */\n timeoutMs?: number;\n /** 响应头 / dev inspector 里显示的远端来源名 */\n remoteSource?: string;\n /** 响应头 / dev inspector 里显示的 fallback 来源名 */\n fallbackSource?: string;\n}\n\nexport interface AdminSeoFallbackEntry extends PageSeoMeta {\n path: string;\n group?: string;\n}\n\nexport interface CreateAdminSeoLoaderOptions {\n /** 远端 SEO 端点;支持 {pathname} 和路由 params 占位符 */\n endpoint?: string;\n /** 本地兜底 SEO 条目,通常来自 ssr.config.ts runtime.seo.fallbackLocal */\n fallbackEntries?: readonly AdminSeoFallbackEntry[];\n /** 远端请求超时,默认 1200ms */\n timeoutMs?: number;\n /**\n * 参数化路径解析器;admin endpoint 没命中且 fallback 也没命中时按 pattern 匹配\n * 调一个用户函数。让业务页面零 SEO 代码,所有动态 SEO 集中在 ssr.config.ts。\n */\n dynamicResolvers?: readonly DynamicSeoResolver[];\n}\n\n/**\n * 内部用:把 `/books/:id` 这种 pattern 编译成 RegExp + 参数名列表。\n * `:name` 匹配单段(不跨 /)。`*` 匹配任意后缀(包括 /),收成 \":wildcard\" param。\n * 编译后缓存,避免每次请求重算。\n */\ninterface CompiledSeoResolver {\n re: RegExp;\n paramNames: string[];\n resolver: DynamicSeoResolver;\n}\n\nfunction compileSeoResolver(resolver: DynamicSeoResolver): CompiledSeoResolver {\n const paramNames: string[] = [];\n const reSrc = resolver.pattern\n .replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&')\n .replace(/:([A-Za-z_][A-Za-z0-9_]*)|\\\\\\*/g, (m, name) => {\n if (m === '\\\\*') {\n paramNames.push('wildcard');\n return '(.*)';\n }\n paramNames.push(name);\n return '([^/]+)';\n });\n return {\n re: new RegExp(`^${reSrc}$`),\n paramNames,\n resolver,\n };\n}\n\nexport interface DefineAdminSiteHooksOptions {\n i18n?: {\n locales?: readonly string[];\n defaultLocale?: string;\n endpoint?: string;\n ttl?: number;\n prefixDefault?: boolean;\n detect?: IntlConfig['detect'];\n fallbackLocal?: IntlMessagesByLocale;\n timeoutMs?: number;\n remoteSource?: string;\n fallbackSource?: string;\n };\n seo?: {\n endpoint?: string;\n ttl?: number;\n fallbackLocal?: readonly Record<string, unknown>[];\n timeoutMs?: number;\n /** 参数化路径的 SEO 解析器(参考 RuntimeSeoConfig.dynamicResolvers)。 */\n dynamicResolvers?: readonly DynamicSeoResolver[];\n };\n beforeRequest?: SiteHooksConfig['beforeRequest'];\n onError?: SiteHooksConfig['onError'];\n headExtras?: SiteHooksConfig['headExtras'];\n}\n\nexport interface IntlConfig {\n // ─── URL 路由层(被 parseLocale / withLocale 等消费)───────────\n /** 支持的 locale 列表,如 ['zh', 'en'];用于 URL 前缀解析 */\n locales?: readonly string[];\n /** 默认 locale —— 必须在 locales 内;同时作为 detect 失败的兜底 */\n defaultLocale?: string;\n /** 默认 locale 是否带 URL 前缀(默认 false:'/about';true:'/zh/about') */\n prefixDefault?: boolean;\n\n // ─── 翻译消息加载层(被 SEO/Header 等消费)─────────────────────\n /** 远程 endpoint;`{locale}` 占位符自动替换 */\n endpoint?: string;\n /** 远端响应适配器;支持 admin manifest / SaaS CMS 等非标准响应 */\n transform?: (\n data: unknown,\n locale: string\n ) => IntlPayload | null | undefined | Promise<IntlPayload | null | undefined>;\n /** 本地或自定义加载器;与 endpoint 互斥(优先级更高) */\n load?: (locale: string, ctx: SiteRuntimeContext) => Promise<IntlPayload | null>;\n /** locale 检测(默认:cookie `locale` → Accept-Language 前缀 → defaultLocale) */\n detect?: (req: Request) => string;\n /** 缓存 TTL 毫秒,默认 60_000 */\n ttl?: number;\n}\n\n/** 仅静态值,无远程拉取(PageSeoMeta 直接复用,无需扩展) */\nexport type SeoStaticEntry = PageSeoMeta;\n\nexport interface SeoRemoteEntry<T = unknown> {\n /** 远程 endpoint;`{paramName}` 占位符自动替换为路由捕获组 */\n endpoint: string;\n /** 把远程响应转成 PageSeoMeta */\n transform: (data: T, params: Record<string, string>) => PageSeoMeta | null;\n /** 缓存 TTL 毫秒,默认 300_000(5 分钟) */\n ttl?: number;\n}\n\nexport interface SeoLocalEntry {\n /** 本地加载器:dynamic import / fs.readFile / 内存 Map 都可 */\n load: (\n params: Record<string, string>,\n ctx: SiteRuntimeContext\n ) => Promise<PageSeoMeta | null> | PageSeoMeta | null;\n /** 缓存 TTL 毫秒,默认 300_000 */\n ttl?: number;\n}\n\nexport type SeoEntry = SeoStaticEntry | SeoRemoteEntry | SeoLocalEntry;\n\nexport interface SiteHooksConfig {\n /** i18n 配置 */\n intl?: IntlConfig;\n /** SEO 路由表:path pattern(支持 `:param`)→ 静态 meta 或 remote loader */\n seo?: Record<string, SeoEntry | (() => Promise<PageSeoMeta | null> | PageSeoMeta | null)>;\n /**\n * 错误回调。平台默认会先执行 console + runtime.telemetry errors endpoint 上报;\n * 自定义 onError 作为业务补充回调追加执行,不会关闭平台默认上报。\n */\n onError?: (\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string }\n ) => void | Promise<void>;\n /**\n * 请求级 ctx 扩展(除 engine 基线字段 + locale 之外的业务字段)。\n *\n * 典型用途:userId、tenantId、requestSegment、审计字段。\n * 返回值会合并进 RequestContext;Server Component 使用\n * `getRequestContext()` 读取,Client Component 需要由 Server Component\n * 作为 props 传入。\n *\n * 注意:\n * - 这里处在首屏关键路径上,应只做 header/cookie 解析。\n * - 不要在这里查数据库或慢 API。\n * - 不要在这里解析 A/B cookie;页面用 `getVariant()`。\n */\n beforeRequest?: (req: Request) => Record<string, unknown> | Promise<Record<string, unknown>>;\n /**\n * 注入到 `<head>` 末尾(`</head>` 之前)的 raw HTML 字符串。\n *\n * 通过 SSR HTML stream transformer 注入,**完全脱离 React 树** —— 不进 client RSC\n * payload,不触发 React 19 + plugin-rsc 的 head children mismatch hydration 错误。\n *\n * 典型用途:\n * - 主题 init inline blocking script(避免 FOUC,next-themes 同款)\n * - GA / GTM snippet\n * - A/B variant flag injection\n * - CSP nonce / preload hints\n *\n * 业务侧返回完整的标签 HTML(含 `<script>` / `<style>` / `<meta>` 外壳)。返回\n * 空字符串 / undefined 时跳过注入。\n *\n * ctx.nonce:当前请求的 CSP nonce(engine 自动注入)。业务侧的 inline `<script>`\n * 必须带上 nonce 属性,否则被 nonce-based CSP 阻断:\n *\n * ```ts\n * import { THEME_INIT_SCRIPT } from '@app/ui/theme-utils';\n *\n * defineAdminSiteHooks({\n * headExtras: ({ nonce }) =>\n * `<script${nonce ? ` nonce=\"${nonce}\"` : ''}>${THEME_INIT_SCRIPT}</script>`,\n * });\n * ```\n */\n headExtras?: (ctx: { nonce?: string }) => string | undefined;\n}\n\ninterface CompiledRoute {\n re: RegExp;\n paramNames: string[];\n resolver: (params: Record<string, string>) => Promise<PageSeoMeta | null> | PageSeoMeta | null;\n}\n\n/** 把 `/books/:id/reviews/:rid` 编译成 RegExp + 参数名列表 */\nfunction compilePattern(pattern: string): { re: RegExp; paramNames: string[] } {\n const paramNames: string[] = [];\n const wildcard = pattern.endsWith('/*');\n const base = wildcard ? pattern.slice(0, -2) : pattern;\n const escaped = base.replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&');\n const reSrc = escaped.replace(/:(\\w+)/g, (_, name) => {\n paramNames.push(name);\n return '([^/]+)';\n });\n return { re: new RegExp(`^${reSrc}${wildcard ? '(?:/.*)?' : ''}$`), paramNames };\n}\n\nfunction fillTemplate(template: string, vars: Record<string, string>): string {\n return template.replace(/\\{(\\w+)\\}/g, (_, k) => encodeURIComponent(vars[k] ?? ''));\n}\n\nexport function createAdminIntlLoader(\n options: CreateAdminIntlLoaderOptions = {}\n): NonNullable<IntlConfig['load']> {\n const endpoint = options.endpoint ?? '/api/i18n/{locale}/manifest';\n const fallbackMessages = options.fallbackMessages ?? {};\n const defaultLocale = options.defaultLocale;\n const supportedLocales = Object.keys(fallbackMessages);\n\n return async (locale, ctx) => {\n const normalizedLocale =\n supportedLocales.length && defaultLocale\n ? normalizeLocale(locale, supportedLocales, defaultLocale)\n : locale;\n const remoteUrl = resolveAdminUrl(endpoint, { locale: normalizedLocale }, ctx);\n const remote = remoteUrl\n ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)\n : null;\n const remoteMessages = extractIntlMessagesOrNull(remote);\n const localMessages =\n fallbackMessages[normalizedLocale] ??\n (defaultLocale ? fallbackMessages[defaultLocale] : undefined) ??\n {};\n const messages = remoteMessages ?? normalizeMessages(localMessages);\n\n return {\n locale: normalizedLocale,\n messages,\n direction: rtlOf(normalizedLocale),\n source: remoteMessages\n ? (options.remoteSource ?? 'remote')\n : (options.fallbackSource ?? 'local-fallback'),\n };\n };\n}\n\nexport function createAdminSeoLoader(\n options: CreateAdminSeoLoaderOptions = {}\n): SeoLocalEntry['load'] {\n const endpoint = options.endpoint ?? '/api/seo?path={pathname}';\n const fallbackEntries = options.fallbackEntries ?? [];\n // 编译一次 + 缓存。N 个 resolver 在每个请求里只是 N 次正则 test,cost 可忽略。\n const compiledResolvers: CompiledSeoResolver[] = (options.dynamicResolvers ?? []).map(\n compileSeoResolver\n );\n\n return async (params, ctx) => {\n const pathname = normalizePathname(params.pathname || '/');\n\n // 1. admin endpoint —— 运营在 dashboard 给具体 path 配过的覆盖优先级最高\n const remoteUrl = resolveAdminUrl(endpoint, { ...params, pathname }, ctx);\n const remote = remoteUrl\n ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)\n : null;\n const remoteMeta = extractSeoMetaOrNull(remote);\n if (remoteMeta) return remoteMeta;\n\n // 2. dynamic resolvers —— 参数化路径的请求期数据驱动\n if (compiledResolvers.length > 0) {\n for (const compiled of compiledResolvers) {\n const m = pathname.match(compiled.re);\n if (!m) continue;\n const resolverParams: Record<string, string> = {};\n compiled.paramNames.forEach((name, i) => {\n resolverParams[name] = m[i + 1] ?? '';\n });\n try {\n const result = await compiled.resolver.resolve({\n pathname,\n params: resolverParams,\n locale: typeof params.locale === 'string' ? params.locale : undefined,\n services: ctx.services,\n });\n if (result) return result as PageSeoMeta;\n } catch (err) {\n // resolver 抛错不阻塞渲染:业务异常时把 SEO 当 null 处理\n console.warn('[seo] dynamic resolver threw, falling through to fallback', err);\n }\n // 同 pattern 没命中数据就继续找下一个 resolver / fallback;不退出。\n // 例:/books/:id 解析失败时,可能匹配了更宽的 /:scope/:id resolver 兜底。\n }\n }\n\n // 3. fallbackLocal —— build 期冻结的兜底\n const fallback = fallbackEntries.find(entry => normalizePathname(entry.path) === pathname);\n if (!fallback) return null;\n const meta = { ...fallback } as Record<string, unknown>;\n delete meta.path;\n delete meta.group;\n return meta as PageSeoMeta;\n };\n}\n\nexport function defineAdminSiteHooks(options: DefineAdminSiteHooksOptions = {}): ServerHooksOutput {\n return createAdminSiteHooks(options, createEmptyRuntimeConfig());\n}\n\nfunction createAdminSiteHooks(\n options: DefineAdminSiteHooksOptions,\n runtime: SiteRuntimeConfig\n): ServerHooksOutput {\n const runtimeI18n: Partial<RuntimeI18nConfig> = runtime.i18n ?? {};\n const runtimeSeo: Partial<RuntimeSeoConfig> = runtime.seo ?? {};\n const i18n = options.i18n ?? {};\n const seo = options.seo ?? {};\n const fallbackMessages = i18n.fallbackLocal ?? runtimeI18n.fallbackLocal ?? {};\n const locales =\n i18n.locales ??\n runtimeI18n.locales ??\n (Object.keys(fallbackMessages).length > 0 ? Object.keys(fallbackMessages) : ['en']);\n const defaultLocale = i18n.defaultLocale ?? runtimeI18n.defaultLocale ?? locales[0] ?? 'en';\n\n const output = createSiteHooks(\n {\n beforeRequest: options.beforeRequest,\n onError: options.onError,\n headExtras: options.headExtras,\n intl: {\n locales,\n defaultLocale,\n prefixDefault: i18n.prefixDefault ?? runtimeI18n.prefixDefault,\n detect: i18n.detect,\n load: createAdminIntlLoader({\n endpoint: i18n.endpoint ?? runtimeI18n.endpoint,\n fallbackMessages,\n defaultLocale,\n timeoutMs: i18n.timeoutMs ?? runtimeI18n.timeoutMs,\n remoteSource: i18n.remoteSource ?? runtimeI18n.remoteSource,\n fallbackSource: i18n.fallbackSource ?? runtimeI18n.fallbackSource,\n }),\n ttl: i18n.ttl ?? runtimeI18n.ttl ?? 60_000,\n },\n seo: {\n '/*': {\n load: createAdminSeoLoader({\n endpoint: seo.endpoint ?? runtimeSeo.endpoint,\n fallbackEntries: normalizeAdminSeoFallbackEntries(\n seo.fallbackLocal ?? runtimeSeo.fallbackLocal\n ),\n timeoutMs: seo.timeoutMs ?? runtimeSeo.timeoutMs,\n dynamicResolvers: seo.dynamicResolvers ?? runtimeSeo.dynamicResolvers,\n }),\n ttl: seo.ttl ?? runtimeSeo.ttl ?? 60_000,\n },\n },\n },\n runtime\n );\n Object.defineProperty(output, '__configureRuntime', {\n enumerable: false,\n configurable: true,\n value: (nextRuntime: SiteRuntimeConfig) => createAdminSiteHooks(options, nextRuntime),\n });\n return output;\n}\n\nexport interface ServerHooksOutput {\n /** site URL —— SEO 注入时把 image/canonical 等相对路径解析为绝对 URL */\n siteBaseUrl?: string;\n /** 浏览器可访问的 API base —— 注入到 csr-shell 的 window.__API_BASE__ */\n apiBaseUrl?: string;\n /**\n * 原始 intl 配置(用户在 defineSiteHooks 里写的那份),透传出来给 app.tsx 的 parseLocale 用\n * —— 让 i18n 配置只声明一次,不需要单独 i18n.config.ts\n */\n intl?: IntlConfig;\n beforeRequest: (\n req: Request,\n engineCtx: { traceId: string; startedAt: number }\n ) => Promise<Record<string, unknown>>;\n loadIntl: (req: Request) => Promise<IntlPayload | null>;\n loadSeoMeta: (req: Request) => Promise<PageSeoMeta | null>;\n onError: (\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string }\n ) => void | Promise<void>;\n /** 注入 `<head>` 末尾的 raw HTML —— 详见 SiteHooksConfig.headExtras 注释 */\n headExtras?: (ctx: { nonce?: string }) => string | undefined;\n __configureRuntime?: (runtime: SiteRuntimeConfig) => ServerHooksOutput;\n}\n\nexport function defineSiteHooks(config: SiteHooksConfig): ServerHooksOutput {\n return createSiteHooks(config, createEmptyRuntimeConfig());\n}\n\nexport function applyRuntimeToServerHooks<T extends object>(\n hooks: T,\n runtime: SiteRuntimeConfig\n): T {\n const maybeRuntimeAware = hooks as T & {\n __configureRuntime?: (runtime: SiteRuntimeConfig) => T;\n };\n if (typeof maybeRuntimeAware.__configureRuntime === 'function') {\n return maybeRuntimeAware.__configureRuntime(runtime);\n }\n const baseHooks = hooks as T & {\n siteBaseUrl?: string;\n apiBaseUrl?: string;\n intl?: unknown;\n loadIntl?: unknown;\n loadSeoMeta?: unknown;\n beforeRequest?: SiteHooksConfig['beforeRequest'];\n onError?: SiteHooksConfig['onError'];\n };\n const services = resolveRuntimeServices(runtime);\n const siteBaseUrl = baseHooks.siteBaseUrl ?? runtime.site;\n const apiBaseUrl = baseHooks.apiBaseUrl ?? services.api;\n const hasUserContentHooks =\n !!baseHooks.intl ||\n typeof baseHooks.loadIntl === 'function' ||\n typeof baseHooks.loadSeoMeta === 'function';\n\n if (!hasUserContentHooks && hasRuntimeContentConfig(runtime)) {\n const runtimeHooks = createAdminSiteHooks(\n {\n beforeRequest: baseHooks.beforeRequest,\n onError: baseHooks.onError,\n },\n runtime\n );\n return {\n ...hooks,\n siteBaseUrl,\n apiBaseUrl,\n intl: runtimeHooks.intl,\n beforeRequest: runtimeHooks.beforeRequest,\n loadIntl: runtimeHooks.loadIntl,\n loadSeoMeta: runtimeHooks.loadSeoMeta,\n onError: runtimeHooks.onError,\n } as T;\n }\n\n return {\n ...hooks,\n siteBaseUrl,\n apiBaseUrl,\n } as T;\n}\n\nfunction createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): ServerHooksOutput {\n const services = resolveRuntimeServices(runtime);\n const api = services.api ?? '';\n const site = runtime.site ?? '';\n const runtimeCtx: SiteRuntimeContext = {\n runtime,\n services,\n telemetry: services.telemetry,\n site: site || undefined,\n };\n const fetchJson = async (path: string, baseUrl?: string): Promise<unknown> => {\n try {\n if (!baseUrl) return null;\n const r = await fetch(baseUrl + path);\n if (!r.ok) return null;\n return await r.json();\n } catch {\n return null;\n }\n };\n\n // ─── i18n 缓存(一次创建,请求级复用)──────────────\n const intlCfg = config.intl ?? {};\n const fallbackLocale = intlCfg.defaultLocale ?? 'zh-CN';\n const supportedLocales = intlCfg.locales?.length ? intlCfg.locales : undefined;\n // 默认 detect 优先级(业界标准 i18n 顺序):\n // 1. URL pathname 前缀 /en-US/... → 'en-US' ← 显式路由意图,最高优先级\n // 2. locale cookie ← 用户手动切换过的偏好\n // 3. Accept-Language 头 ← 浏览器系统语言\n // 4. defaultLocale ← 兜底\n //\n // 关键:前缀路由(prefixDefault:true 等场景)下,URL 是源真值。如果不优先用\n // URL,curl /en-US 但 Accept-Language 是 zh 会被错误降级到 zh-CN,跟用户\n // 明确写在 URL 里的意图相反。\n // 业务侧可通过 intlCfg.detect 完全覆盖(任何 (req) => string 都行)。\n const detectLocale =\n intlCfg.detect ??\n ((req: Request): string => {\n // 1. URL 前缀\n if (supportedLocales) {\n try {\n const pathname = new URL(req.url).pathname;\n // 客户端 RSC 导航 URL 带 `_.rsc` 后缀(如 `/ja_.rsc`),不剥掉的话\n // 首段会变成 `ja_.rsc` 命中不了 locale,从而错误回退到 cookie /\n // Accept-Language / defaultLocale —— 这正是「切换语言必须刷新才生效」\n // 的根因(RSC 导航拿到的 intl 语言与 URL 前缀不一致)。\n const cleanPath = pathname.endsWith('_.rsc')\n ? pathname.slice(0, -'_.rsc'.length) || '/'\n : pathname;\n const first = cleanPath.split('/')[1];\n if (first && supportedLocales.includes(first)) return first;\n } catch {\n // 非法 URL(极少见,比如内部调用喂了相对路径)→ 继续后续策略\n }\n }\n // 2. cookie\n const localeCookie = readCookie(req, 'locale');\n if (localeCookie) {\n return supportedLocales\n ? normalizeLocale(localeCookie, supportedLocales, fallbackLocale)\n : localeCookie;\n }\n // 3. Accept-Language → 4. fallbackLocale\n const accept = req.headers.get('accept-language') ?? '';\n return supportedLocales\n ? normalizeLocale(parseAcceptLanguage(accept), supportedLocales, fallbackLocale)\n : inferLocaleFromAcceptLanguage(accept, fallbackLocale);\n });\n\n const intlLoader = createCachedFetcher<string, IntlPayload>({\n key: locale => `intl:${locale}`,\n ttl: intlCfg.ttl ?? 60_000,\n swr: true,\n fetch: async locale => {\n if (intlCfg.load) {\n const r = await intlCfg.load(locale, runtimeCtx);\n return r ?? { locale, messages: {}, direction: rtlOf(locale) };\n }\n if (intlCfg.endpoint) {\n const url = fillTemplate(intlCfg.endpoint, { locale });\n const json = await fetchJson(url, services.api);\n if (json !== null && intlCfg.transform) {\n const transformed = await intlCfg.transform(json, locale);\n if (transformed) {\n return {\n ...transformed,\n direction: transformed.direction ?? rtlOf(transformed.locale),\n };\n }\n }\n return {\n locale,\n messages: extractIntlMessages(json),\n direction: rtlOf(locale),\n };\n }\n return { locale, messages: {}, direction: rtlOf(locale) };\n },\n fallback: locale => ({ locale, messages: {}, direction: rtlOf(locale) }),\n });\n\n // ─── SEO 路由表编译 + 远程 loader 缓存(每个 pattern 一份)─────\n const seoRoutes: CompiledRoute[] = [];\n const remoteCaches = new Map<\n string,\n ReturnType<typeof createCachedFetcher<string, PageSeoMeta | null>>\n >();\n\n for (const [pattern, value] of Object.entries(config.seo ?? {})) {\n const { re, paramNames } = compilePattern(pattern);\n\n if (typeof value === 'function') {\n // 自定义 resolver\n seoRoutes.push({ re, paramNames, resolver: value as CompiledRoute['resolver'] });\n continue;\n }\n if ('endpoint' in value && typeof (value as SeoRemoteEntry).endpoint === 'string') {\n const remote = value as SeoRemoteEntry;\n const cache = createCachedFetcher<string, PageSeoMeta | null>({\n key: paramKey => `seo:${pattern}:${paramKey}`,\n ttl: remote.ttl ?? 300_000,\n fetch: async paramKey => {\n const params = JSON.parse(paramKey) as Record<string, string>;\n const data = await fetchJson(fillTemplate(remote.endpoint, params), services.api);\n if (data === null) return null;\n return remote.transform(data, params);\n },\n fallback: () => null,\n });\n remoteCaches.set(pattern, cache);\n seoRoutes.push({\n re,\n paramNames,\n resolver: params => cache(JSON.stringify(params)),\n });\n continue;\n }\n if ('load' in value && typeof (value as SeoLocalEntry).load === 'function') {\n const local = value as SeoLocalEntry;\n const cache = createCachedFetcher<string, PageSeoMeta | null>({\n key: paramKey => `seo-local:${pattern}:${paramKey}`,\n ttl: local.ttl ?? 300_000,\n fetch: async paramKey => {\n const params = JSON.parse(paramKey) as Record<string, string>;\n return await local.load(params, runtimeCtx);\n },\n fallback: () => null,\n });\n remoteCaches.set(pattern, cache);\n seoRoutes.push({\n re,\n paramNames,\n resolver: params => cache(JSON.stringify(params)),\n });\n continue;\n }\n // 静态 meta\n const staticMeta = value as SeoStaticEntry;\n const withDefaults: PageSeoMeta = {\n ...staticMeta,\n canonical:\n staticMeta.canonical ??\n (site && pattern && pattern !== '/*' ? `${site}${pattern}` : staticMeta.canonical),\n };\n seoRoutes.push({ re, paramNames, resolver: () => withDefaults });\n }\n\n // ─── onError ─────\n const platformOnError = createPlatformOnError(runtime, runtimeCtx);\n const onError: ServerHooksOutput['onError'] = async (err, req, ctx) => {\n platformOnError(err, req, ctx);\n if (config.onError) {\n await config.onError(err, req, ctx);\n }\n };\n\n const output: ServerHooksOutput = {\n siteBaseUrl: site || undefined,\n apiBaseUrl: api || undefined,\n intl: config.intl,\n headExtras: config.headExtras,\n async beforeRequest(req, _engineCtx) {\n const locale = detectLocale(req);\n const userExt = config.beforeRequest ? await config.beforeRequest(req) : {};\n return { locale, ...userExt };\n },\n async loadIntl(req) {\n return intlLoader(detectLocale(req));\n },\n async loadSeoMeta(req) {\n const url = new URL(req.url);\n const locale = detectLocale(req);\n // 客户端 RSC 导航 fetch 的 URL 带 _.rsc 后缀(详见 defaults/runtime/request.tsx)。\n // 先剥后缀,否则 /zh-CN/books/1_.rsc 永远 match 不到 /books/:id route → seoMeta=null →\n // 客户端导航后 head 不更新。HTML 请求没这个后缀,原行为不变。\n let pathForRouting = url.pathname;\n if (pathForRouting.endsWith('_.rsc')) {\n pathForRouting = pathForRouting.slice(0, -'_.rsc'.length) || '/';\n }\n // SEO 表是按\"业务规范路径\"('/' / '/books' / '/about')入库的,\n // 不带 locale 前缀。请求 URL 是带前缀的('/en-US/'、'/zh-CN/books'),\n // 直接喂给 admin 查不到。先用 parseLocale 把 locale 段剥掉,\n // 再去 seoRoutes 里匹配 + 调 admin endpoint。\n // 同时 locale 单独传到 resolver params,让 endpoint 模板里 {locale}\n // 占位符能填对应语言(之前那个 fix 留着,跟 strip 配合一起才完整)。\n const intlConfig = config.intl;\n const cleanPath =\n intlConfig?.locales && intlConfig.locales.length > 0\n ? parseLocale(pathForRouting, {\n locales: intlConfig.locales,\n defaultLocale: intlConfig.defaultLocale ?? intlConfig.locales[0]!,\n prefixDefault: intlConfig.prefixDefault,\n } satisfies I18nConfig).pathname\n : pathForRouting;\n\n for (const { re, paramNames, resolver } of seoRoutes) {\n const m = cleanPath.match(re);\n if (m) {\n const params: Record<string, string> = {\n pathname: cleanPath,\n locale,\n };\n paramNames.forEach((n, i) => (params[n] = m[i + 1] ?? ''));\n return await resolver(params);\n }\n }\n return null;\n },\n onError,\n };\n Object.defineProperty(output, '__configureRuntime', {\n enumerable: false,\n configurable: true,\n value: (nextRuntime: SiteRuntimeConfig) => createSiteHooks(config, nextRuntime),\n });\n return output;\n}\n\nfunction rtlOf(locale: string): 'ltr' | 'rtl' {\n return /^(ar|he|fa|ur)/.test(locale) ? 'rtl' : 'ltr';\n}\n\nfunction parseAcceptLanguage(accept: string): string {\n let best = '';\n let bestQ = -1;\n for (const part of accept.split(',')) {\n const [rawLocale, ...attrs] = part.trim().split(';');\n if (!rawLocale) continue;\n const qAttr = attrs.find(attr => attr.trim().startsWith('q='));\n const q = qAttr ? Number(qAttr.trim().slice(2)) : 1;\n if (Number.isFinite(q) && q > bestQ) {\n best = rawLocale;\n bestQ = q;\n }\n }\n return best;\n}\n\nfunction inferLocaleFromAcceptLanguage(accept: string, fallbackLocale: string): string {\n const best = parseAcceptLanguage(accept);\n if (!best) return fallbackLocale;\n const primary = best.toLowerCase().split('-')[0];\n if (primary === 'zh') return 'zh-CN';\n if (primary === 'en') return 'en';\n return fallbackLocale;\n}\n\nfunction normalizeLocale(\n value: string,\n supportedLocales: readonly string[],\n fallbackLocale: string\n): string {\n const lower = value.toLowerCase();\n const exact = supportedLocales.find(locale => locale.toLowerCase() === lower);\n if (exact) return exact;\n const prefix = lower.split('-')[0];\n const byPrefix = supportedLocales.find(locale => locale.toLowerCase().split('-')[0] === prefix);\n return byPrefix ?? fallbackLocale;\n}\n\nfunction extractIntlMessages(data: unknown): Record<string, unknown> {\n return extractIntlMessagesOrNull(data) ?? {};\n}\n\nfunction extractIntlMessagesOrNull(data: unknown): Record<string, unknown> | null {\n if (!data || typeof data !== 'object') return null;\n const raw = data as Record<string, unknown>;\n const dataValue = raw.data;\n const candidate =\n raw.strings ??\n raw.messages ??\n (isRecord(dataValue) && 'strings' in dataValue ? dataValue.strings : dataValue);\n if (!candidate || typeof candidate !== 'object') return null;\n return normalizeMessages(candidate as Record<string, unknown>);\n}\n\nfunction normalizeMessages(messages: Record<string, unknown>): Record<string, unknown> {\n if (isFlatRecord(messages)) {\n return expandDottedRecord(messages);\n }\n return messages;\n}\n\n/**\n * 逐层剥 envelope —— admin 在不同分支返回三种 shape:\n * - flat:`{ title, description, ... }`(admin no-locale fast path)\n * - 单层:`{ data: { title, ... } }`(旧版本)\n * - 双层:`{ status, code, data: { data: { title, ... }, version } }`\n * (api-envelope plugin 包了一层,resolvePublic 自己又是 `{ data, version }`,\n * 所以 locale-aware 路径会双层 wrap)\n *\n * 停止条件:候选对象有 `title` / `description`(SEO 形状),或没有 `data` 字段可剥。\n */\nfunction extractSeoMetaOrNull(data: unknown): PageSeoMeta | null {\n let candidate: unknown = data;\n for (let i = 0; i < 4; i++) {\n if (!isRecord(candidate)) return null;\n if ('title' in candidate || 'description' in candidate) break;\n if ('data' in candidate) {\n candidate = candidate.data;\n continue;\n }\n return null;\n }\n if (!isRecord(candidate)) return null;\n return candidate as PageSeoMeta;\n}\n\nfunction normalizeAdminSeoFallbackEntries(\n entries: readonly Record<string, unknown>[] = []\n): readonly AdminSeoFallbackEntry[] {\n return entries.filter(\n entry => typeof entry.path === 'string'\n ) as unknown as readonly AdminSeoFallbackEntry[];\n}\n\nfunction createPlatformOnError(\n runtime: SiteRuntimeConfig,\n ctx: SiteRuntimeContext\n): NonNullable<ServerHooksOutput['onError']> {\n const reportServerError = createServerErrorEndpointReporter(runtime, ctx);\n\n return (err, req, errorCtx) => {\n console.error('[onError]', {\n traceId: errorCtx.traceId,\n locale: errorCtx.locale,\n url: req.url,\n msg: err instanceof Error ? err.message : String(err),\n });\n reportServerError?.(err, req, errorCtx);\n };\n}\n\nfunction createServerErrorEndpointReporter(\n runtime: SiteRuntimeConfig,\n ctx: SiteRuntimeContext\n): ((err: unknown, req: Request, errorCtx: { traceId: string; locale?: string }) => void) | null {\n const config = runtime.telemetry;\n if (config === false || !config || config.errors === false) return null;\n\n const errors = config.errors ?? {};\n const endpoint = resolveAdminUrl(errors.endpoint ?? '/api/observability/errors', {}, ctx, {\n baseUrl: runtimeCtx => runtimeCtx.services.telemetry ?? runtimeCtx.services.api,\n });\n if (!endpoint) return null;\n\n const app = config.app ?? 'isr-engine-app';\n const release = config.release;\n const environment = config.environment;\n const includeQueryString = config.includeQueryString === true;\n\n return (err, req, errorCtx) => {\n const report = normalizeServerErrorReport(err, req, errorCtx, {\n release,\n environment,\n includeQueryString,\n });\n\n void fetch(endpoint, {\n method: 'POST',\n headers: {\n 'content-type': 'application/json',\n accept: 'application/json',\n },\n body: JSON.stringify({\n app,\n sentAt: Date.now(),\n reports: [report],\n }),\n signal: typeof AbortSignal !== 'undefined' ? AbortSignal.timeout(1000) : undefined,\n }).catch(() => {\n /* 服务端错误上报不能阻断渲染兜底;失败交给进程日志和外层 adapter */\n });\n };\n}\n\nfunction normalizeServerErrorReport(\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string },\n options: {\n release?: string;\n environment?: string;\n includeQueryString?: boolean;\n }\n): Record<string, unknown> {\n const error = err instanceof Error ? err : null;\n const message = error?.message || String(err);\n const name = error?.name || 'Error';\n const url = safeRequestPath(req.url, options.includeQueryString);\n\n return {\n id: createServerReportId(),\n ts: Date.now(),\n level: 'error',\n message,\n name,\n stack: error?.stack,\n release: options.release,\n environment: options.environment,\n url,\n source: 'server-render',\n tags: {\n traceId: ctx.traceId,\n locale: ctx.locale,\n },\n extra: {\n method: req.method,\n pathname: url.split('?')[0] || '/',\n },\n fingerprint: ['server-render', name, message.slice(0, 160)],\n };\n}\n\nfunction safeRequestPath(rawUrl: string, includeQueryString?: boolean): string {\n try {\n const url = new URL(rawUrl);\n return includeQueryString ? `${url.pathname}${url.search}` : url.pathname;\n } catch {\n return includeQueryString ? rawUrl : '/';\n }\n}\n\nfunction createServerReportId(): string {\n const random =\n typeof crypto !== 'undefined' && 'randomUUID' in crypto\n ? crypto.randomUUID()\n : Math.random().toString(36).slice(2);\n return `srv_${Date.now().toString(36)}_${random}`;\n}\n\nasync function fetchJsonWithTimeout<T>(url: string, timeoutMs = 1200): Promise<T | null> {\n try {\n const response = await fetch(url, {\n headers: { Accept: 'application/json' },\n signal: timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined,\n });\n if (!response.ok) return null;\n return (await response.json()) as T;\n } catch {\n return null;\n }\n}\n\nfunction resolveAdminUrl(\n endpoint: string,\n vars: Record<string, string>,\n ctx: SiteRuntimeContext,\n options: { baseUrl?: RuntimeServiceBase } = {}\n): string | null {\n const filled = fillTemplate(endpoint, vars);\n if (/^(https?:)?\\/\\//i.test(filled)) return filled;\n const base = resolveRuntimeServiceBase(ctx, options.baseUrl);\n if (!base) return null;\n return `${trimTrailingSlashes(base)}/${filled.replace(/^\\/+/, '')}`;\n}\n\nfunction resolveRuntimeServiceBase(\n ctx: SiteRuntimeContext,\n baseUrl?: RuntimeServiceBase\n): string | null {\n if (typeof baseUrl === 'function') {\n return baseUrl(ctx) ?? null;\n }\n if (baseUrl) return baseUrl;\n return ctx.services.api ?? null;\n}\n\nfunction resolveRuntimeServices(runtime: SiteRuntimeConfig): RuntimeServices {\n const services = runtime.services ?? {};\n const api = services.api;\n return {\n api,\n telemetry: services.telemetry ?? api,\n };\n}\n\nfunction hasRuntimeContentConfig(runtime: SiteRuntimeConfig): boolean {\n return !!(\n runtime.i18n?.endpoint ||\n runtime.i18n?.fallbackLocal ||\n runtime.seo?.endpoint ||\n runtime.seo?.fallbackLocal ||\n runtime.telemetry\n );\n}\n\nfunction normalizePathname(pathname: string): string {\n if (pathname === '/') return '/';\n return trimTrailingSlashes(pathname) || '/';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return !!value && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isFlatRecord(value: unknown): boolean {\n if (!value || typeof value !== 'object') return false;\n return Object.keys(value as Record<string, unknown>).some(key => key.includes('.'));\n}\n\nfunction expandDottedRecord(flat: Record<string, unknown>): Record<string, unknown> {\n const out: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(flat)) {\n const parts = key.split('.');\n let cur = out;\n parts.forEach((part, index) => {\n if (index === parts.length - 1) {\n cur[part] = value;\n return;\n }\n const next = cur[part];\n if (!next || typeof next !== 'object') cur[part] = {};\n cur = cur[part] as Record<string, unknown>;\n });\n }\n return out;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"defineSiteHooks-CV4tqHvB.js","names":[],"sources":["../src/defaults/runtime/createCachedFetcher.ts","../src/defaults/runtime/defineSiteHooks.ts"],"sourcesContent":["/**\n * createCachedFetcher —— 通用 TTL + 并发去重数据加载器\n *\n * 设计目标:\n * - 给 i18n / SEO 这类「url 或本地 json」加载场景一个唯一的成熟实现\n * - 同 key 的并发请求自动合并为一次(避免缓存击穿)\n * - 过期后台刷新可选(SWR 模式)\n *\n * 用例:\n * const loadMessages = createCachedFetcher<IntlPayload>({\n * key: ({ locale }) => `intl:${locale}`,\n * ttl: 60_000,\n * fetch: async ({ locale }) => {\n * const r = await fetch(`https://cdn.example.com/i18n/${locale}.json`);\n * return r.json();\n * },\n * });\n *\n * // 在 hook 里用:\n * loadIntl: (url) => loadMessages({ locale: detectLocale(url) }),\n */\n/**\n * 极简 LRU —— 利用 Map 的插入顺序保留特性\n *\n * 不引外部 lru-cache 包是为了规避用户 RSC bundle 的 ESM/CJS interop 抖动\n * (lru-cache@10 双发布在 rolldown 里偶发 default vs 命名导出错位)\n * 本文件用于 i18n / SEO 数据的请求级缓存(典型 < 100 条),简单 Map 完全够用\n */\nclass TinyLRU<K, V> {\n private store = new Map<K, V>();\n constructor(private max: number) {}\n get(k: K): V | undefined {\n const v = this.store.get(k);\n if (v !== undefined) {\n // 触发 LRU:删后再 set,使其变成最新插入\n this.store.delete(k);\n this.store.set(k, v);\n }\n return v;\n }\n set(k: K, v: V): void {\n if (this.store.has(k)) this.store.delete(k);\n this.store.set(k, v);\n if (this.store.size > this.max) {\n const oldest = this.store.keys().next().value;\n if (oldest !== undefined) this.store.delete(oldest);\n }\n }\n}\n\nexport interface CachedFetcherOptions<TArg, TValue> {\n /** 从入参生成缓存 key */\n key: (arg: TArg) => string;\n /** 实际加载逻辑(network / fs / dynamic import 都可) */\n fetch: (arg: TArg) => Promise<TValue>;\n /** 缓存 TTL(毫秒),默认 60s */\n ttl?: number;\n /** LRU 容量,默认 500 */\n max?: number;\n /** 启用 stale-while-revalidate:过期仍返回旧值,后台异步刷新(默认 false) */\n swr?: boolean;\n /** 拉取失败时的回退值(如不提供则抛错) */\n fallback?: (arg: TArg, error: unknown) => TValue | Promise<TValue>;\n}\n\ninterface Entry<T> {\n value: T;\n expiresAt: number;\n}\n\nexport type CachedFetcher<TArg, TValue> = (arg: TArg) => Promise<TValue>;\n\nexport function createCachedFetcher<TArg, TValue>(\n opts: CachedFetcherOptions<TArg, TValue>\n): CachedFetcher<TArg, TValue> {\n const ttl = opts.ttl ?? 60_000;\n const max = opts.max ?? 500;\n const cache = new TinyLRU<string, Entry<TValue>>(max);\n const inflight = new Map<string, Promise<TValue>>();\n\n async function load(arg: TArg): Promise<TValue> {\n try {\n const v = await opts.fetch(arg);\n cache.set(opts.key(arg), { value: v, expiresAt: Date.now() + ttl });\n return v;\n } catch (err) {\n if (opts.fallback) return await opts.fallback(arg, err);\n throw err;\n }\n }\n\n return async function cachedFetcher(arg: TArg): Promise<TValue> {\n const key = opts.key(arg);\n const entry = cache.get(key);\n const now = Date.now();\n\n if (entry && entry.expiresAt > now) {\n return entry.value;\n }\n\n if (entry && opts.swr) {\n // SWR:返回旧值,后台刷新(不阻塞);如已有 in-flight 则不重复触发\n if (!inflight.has(key)) {\n const p = load(arg).finally(() => inflight.delete(key));\n inflight.set(key, p);\n p.catch(() => {\n /* 后台刷新失败保留旧值 */\n });\n }\n return entry.value;\n }\n\n // miss 或非 SWR 过期:合并并发到同一个 promise\n const existing = inflight.get(key);\n if (existing) return existing;\n\n const p = load(arg).finally(() => inflight.delete(key));\n inflight.set(key, p);\n return p;\n };\n}\n","/**\n * defineSiteHooks —— 高阶 FaaS hooks 工厂(声明式配置 → 完整 ServerEntryHooks)\n *\n * 让用户的 src/entry.server.tsx 收紧到「只写请求期 hooks」。\n * 部署/平台配置(api/site/redis/experiments/i18n/seo/telemetry)放\n * ssr.config.ts 的 runtime 字段;entry.server.tsx 只保留 beforeRequest / onError。\n * 注:experiments 是 experimentation platform 的通用字段名,业务侧可理解为 A/B testing。\n * 内部固化:\n * - i18n 字典缓存(createCachedFetcher: TTL/SWR/dedup/fallback)\n * - SEO 路由表 pattern → resolver\n * - locale 检测(cookie → Accept-Language → 默认)\n * - i18n/seo 远端相对 endpoint 统一使用 runtime.services.api\n * - 服务端渲染错误打印 + runtime.telemetry errors endpoint 上报\n *\n * beforeRequest 的边界:\n * - 它在每次 HTTP/RSC 请求进入渲染前执行。\n * - 返回值会合并进 RequestContext,Server Component 用 getRequestContext() 读取。\n * - 适合放 userId / tenantId / requestSegment 这类请求现场字段。\n * - 不适合放 Redis、SEO、i18n、A/B 定义、慢 API 或数据库查询。\n * - A/B variant 由 runtime.experiments + engine middleware 注入,页面用 getVariant()。\n *\n * 用户态写法(商业项目推荐):\n * import { defineAdminSiteHooks } from 'isr-engine/site-hooks';\n *\n * export default defineAdminSiteHooks({\n * beforeRequest: req => ({\n * userId: req.headers.get('x-user-id') ?? undefined,\n * tenantId: req.headers.get('x-tenant-id') ?? 'public',\n * requestSegment: req.headers.get('x-segment') ?? 'default',\n * }),\n * });\n */\nimport { trimTrailingSlashes } from '../../utils/trimTrailingSlashes';\nimport { createCachedFetcher } from './createCachedFetcher';\nimport type { IntlPayload, PageSeoMeta } from './seo-runtime';\nimport type {\n DynamicSeoResolver,\n ISRConfig,\n RuntimeI18nConfig,\n RuntimeSeoConfig,\n} from '../../types';\nimport { readCookie } from '../../utils/cookie';\nimport { parseLocale, type I18nConfig } from '../../runtime/i18n';\n\nexport { getCookieHeader, parseCookieHeader, readCookie } from '../../utils/cookie';\n\nexport type SiteRuntimeConfig = ISRConfig['runtime'];\n\nexport interface SiteRuntimeContext {\n runtime: SiteRuntimeConfig;\n services: RuntimeServices;\n telemetry?: string;\n site?: string;\n}\n\nexport interface RuntimeServices {\n api?: string;\n telemetry?: string;\n}\n\nfunction createEmptyRuntimeConfig(): SiteRuntimeConfig {\n return {\n site: undefined,\n services: { api: undefined, telemetry: undefined },\n redis: undefined,\n experiments: {},\n i18n: undefined,\n seo: undefined,\n telemetry: false,\n };\n}\n\nexport type RuntimeServiceBase = string | ((ctx: SiteRuntimeContext) => string | null | undefined);\n\nexport type IntlMessagesByLocale = Record<string, Record<string, unknown>>;\n\nexport interface CreateAdminIntlLoaderOptions {\n /** 远端字典端点;相对路径会用 runtime.services.api 拼接 */\n endpoint?: string;\n /** 本地兜底字典,通常来自 ssr.config.ts runtime.i18n.fallbackLocal */\n fallbackMessages?: IntlMessagesByLocale;\n /** 远端和本地都无法命中时使用的 locale */\n defaultLocale?: string;\n /** 远端请求超时,默认 1200ms */\n timeoutMs?: number;\n /** 响应头 / dev inspector 里显示的远端来源名 */\n remoteSource?: string;\n /** 响应头 / dev inspector 里显示的 fallback 来源名 */\n fallbackSource?: string;\n}\n\nexport interface AdminSeoFallbackEntry extends PageSeoMeta {\n path: string;\n group?: string;\n}\n\nexport interface CreateAdminSeoLoaderOptions {\n /** 远端 SEO 端点;支持 {pathname} 和路由 params 占位符 */\n endpoint?: string;\n /** 本地兜底 SEO 条目,通常来自 ssr.config.ts runtime.seo.fallbackLocal */\n fallbackEntries?: readonly AdminSeoFallbackEntry[];\n /** 远端请求超时,默认 1200ms */\n timeoutMs?: number;\n /**\n * 参数化路径解析器;admin endpoint 没命中且 fallback 也没命中时按 pattern 匹配\n * 调一个用户函数。让业务页面零 SEO 代码,所有动态 SEO 集中在 ssr.config.ts。\n */\n dynamicResolvers?: readonly DynamicSeoResolver[];\n}\n\n/**\n * 内部用:把 `/books/:id` 这种 pattern 编译成 RegExp + 参数名列表。\n * `:name` 匹配单段(不跨 /)。`*` 匹配任意后缀(包括 /),收成 \":wildcard\" param。\n * 编译后缓存,避免每次请求重算。\n */\ninterface CompiledSeoResolver {\n re: RegExp;\n paramNames: string[];\n resolver: DynamicSeoResolver;\n}\n\nfunction compileSeoResolver(resolver: DynamicSeoResolver): CompiledSeoResolver {\n const paramNames: string[] = [];\n const reSrc = resolver.pattern\n .replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&')\n .replace(/:([A-Za-z_][A-Za-z0-9_]*)|\\\\\\*/g, (m, name) => {\n if (m === '\\\\*') {\n paramNames.push('wildcard');\n return '(.*)';\n }\n paramNames.push(name);\n return '([^/]+)';\n });\n return {\n re: new RegExp(`^${reSrc}$`),\n paramNames,\n resolver,\n };\n}\n\nexport interface DefineAdminSiteHooksOptions {\n i18n?: {\n locales?: readonly string[];\n defaultLocale?: string;\n endpoint?: string;\n ttl?: number;\n prefixDefault?: boolean;\n detect?: IntlConfig['detect'];\n fallbackLocal?: IntlMessagesByLocale;\n timeoutMs?: number;\n remoteSource?: string;\n fallbackSource?: string;\n };\n seo?: {\n endpoint?: string;\n ttl?: number;\n fallbackLocal?: readonly Record<string, unknown>[];\n timeoutMs?: number;\n /** 参数化路径的 SEO 解析器(参考 RuntimeSeoConfig.dynamicResolvers)。 */\n dynamicResolvers?: readonly DynamicSeoResolver[];\n };\n beforeRequest?: SiteHooksConfig['beforeRequest'];\n onError?: SiteHooksConfig['onError'];\n headExtras?: SiteHooksConfig['headExtras'];\n}\n\nexport interface IntlConfig {\n // ─── URL 路由层(被 parseLocale / withLocale 等消费)───────────\n /** 支持的 locale 列表,如 ['zh', 'en'];用于 URL 前缀解析 */\n locales?: readonly string[];\n /** 默认 locale —— 必须在 locales 内;同时作为 detect 失败的兜底 */\n defaultLocale?: string;\n /** 默认 locale 是否带 URL 前缀(默认 false:'/about';true:'/zh/about') */\n prefixDefault?: boolean;\n\n // ─── 翻译消息加载层(被 SEO/Header 等消费)─────────────────────\n /** 远程 endpoint;`{locale}` 占位符自动替换 */\n endpoint?: string;\n /** 远端响应适配器;支持 admin manifest / SaaS CMS 等非标准响应 */\n transform?: (\n data: unknown,\n locale: string\n ) => IntlPayload | null | undefined | Promise<IntlPayload | null | undefined>;\n /** 本地或自定义加载器;与 endpoint 互斥(优先级更高) */\n load?: (locale: string, ctx: SiteRuntimeContext) => Promise<IntlPayload | null>;\n /** locale 检测(默认:cookie `locale` → Accept-Language 前缀 → defaultLocale) */\n detect?: (req: Request) => string;\n /** 缓存 TTL 毫秒,默认 60_000 */\n ttl?: number;\n}\n\n/** 仅静态值,无远程拉取(PageSeoMeta 直接复用,无需扩展) */\nexport type SeoStaticEntry = PageSeoMeta;\n\nexport interface SeoRemoteEntry<T = unknown> {\n /** 远程 endpoint;`{paramName}` 占位符自动替换为路由捕获组 */\n endpoint: string;\n /** 把远程响应转成 PageSeoMeta */\n transform: (data: T, params: Record<string, string>) => PageSeoMeta | null;\n /** 缓存 TTL 毫秒,默认 300_000(5 分钟) */\n ttl?: number;\n}\n\nexport interface SeoLocalEntry {\n /** 本地加载器:dynamic import / fs.readFile / 内存 Map 都可 */\n load: (\n params: Record<string, string>,\n ctx: SiteRuntimeContext\n ) => Promise<PageSeoMeta | null> | PageSeoMeta | null;\n /** 缓存 TTL 毫秒,默认 300_000 */\n ttl?: number;\n}\n\nexport type SeoEntry = SeoStaticEntry | SeoRemoteEntry | SeoLocalEntry;\n\nexport interface SiteHooksConfig {\n /** i18n 配置 */\n intl?: IntlConfig;\n /** SEO 路由表:path pattern(支持 `:param`)→ 静态 meta 或 remote loader */\n seo?: Record<string, SeoEntry | (() => Promise<PageSeoMeta | null> | PageSeoMeta | null)>;\n /**\n * 错误回调。平台默认会先执行 console + runtime.telemetry errors endpoint 上报;\n * 自定义 onError 作为业务补充回调追加执行,不会关闭平台默认上报。\n */\n onError?: (\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string }\n ) => void | Promise<void>;\n /**\n * 请求级 ctx 扩展(除 engine 基线字段 + locale 之外的业务字段)。\n *\n * 典型用途:userId、tenantId、requestSegment、审计字段。\n * 返回值会合并进 RequestContext;Server Component 使用\n * `getRequestContext()` 读取,Client Component 需要由 Server Component\n * 作为 props 传入。\n *\n * 注意:\n * - 这里处在首屏关键路径上,应只做 header/cookie 解析。\n * - 不要在这里查数据库或慢 API。\n * - 不要在这里解析 A/B cookie;页面用 `getVariant()`。\n */\n beforeRequest?: (req: Request) => Record<string, unknown> | Promise<Record<string, unknown>>;\n /**\n * 注入到 `<head>` 末尾(`</head>` 之前)的 raw HTML 字符串。\n *\n * 通过 SSR HTML stream transformer 注入,**完全脱离 React 树** —— 不进 client RSC\n * payload,不触发 React 19 + plugin-rsc 的 head children mismatch hydration 错误。\n *\n * 典型用途:\n * - 主题 init inline blocking script(避免 FOUC,next-themes 同款)\n * - GA / GTM snippet\n * - A/B variant flag injection\n * - CSP nonce / preload hints\n *\n * 业务侧返回完整的标签 HTML(含 `<script>` / `<style>` / `<meta>` 外壳)。返回\n * 空字符串 / undefined 时跳过注入。\n *\n * ctx.nonce:当前请求的 CSP nonce(engine 自动注入)。业务侧的 inline `<script>`\n * 必须带上 nonce 属性,否则被 nonce-based CSP 阻断:\n *\n * ```ts\n * import { THEME_INIT_SCRIPT } from '@app/ui/theme-utils';\n *\n * defineAdminSiteHooks({\n * headExtras: ({ nonce }) =>\n * `<script${nonce ? ` nonce=\"${nonce}\"` : ''}>${THEME_INIT_SCRIPT}</script>`,\n * });\n * ```\n */\n headExtras?: (ctx: { nonce?: string }) => string | undefined;\n}\n\ninterface CompiledRoute {\n re: RegExp;\n paramNames: string[];\n resolver: (params: Record<string, string>) => Promise<PageSeoMeta | null> | PageSeoMeta | null;\n}\n\n/** 把 `/books/:id/reviews/:rid` 编译成 RegExp + 参数名列表 */\nfunction compilePattern(pattern: string): { re: RegExp; paramNames: string[] } {\n const paramNames: string[] = [];\n const wildcard = pattern.endsWith('/*');\n const base = wildcard ? pattern.slice(0, -2) : pattern;\n const escaped = base.replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&');\n const reSrc = escaped.replace(/:(\\w+)/g, (_, name) => {\n paramNames.push(name);\n return '([^/]+)';\n });\n return { re: new RegExp(`^${reSrc}${wildcard ? '(?:/.*)?' : ''}$`), paramNames };\n}\n\nfunction fillTemplate(template: string, vars: Record<string, string>): string {\n return template.replace(/\\{(\\w+)\\}/g, (_, k) => encodeURIComponent(vars[k] ?? ''));\n}\n\nexport function createAdminIntlLoader(\n options: CreateAdminIntlLoaderOptions = {}\n): NonNullable<IntlConfig['load']> {\n const endpoint = options.endpoint ?? '/api/i18n/{locale}/manifest';\n const fallbackMessages = options.fallbackMessages ?? {};\n const defaultLocale = options.defaultLocale;\n const supportedLocales = Object.keys(fallbackMessages);\n\n return async (locale, ctx) => {\n const normalizedLocale =\n supportedLocales.length && defaultLocale\n ? normalizeLocale(locale, supportedLocales, defaultLocale)\n : locale;\n const remoteUrl = resolveAdminUrl(endpoint, { locale: normalizedLocale }, ctx);\n const remote = remoteUrl\n ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)\n : null;\n const remoteMessages = extractIntlMessagesOrNull(remote);\n const localMessages =\n fallbackMessages[normalizedLocale] ??\n (defaultLocale ? fallbackMessages[defaultLocale] : undefined) ??\n {};\n const messages = remoteMessages ?? normalizeMessages(localMessages);\n\n return {\n locale: normalizedLocale,\n messages,\n direction: rtlOf(normalizedLocale),\n source: remoteMessages\n ? (options.remoteSource ?? 'remote')\n : (options.fallbackSource ?? 'local-fallback'),\n };\n };\n}\n\nexport function createAdminSeoLoader(\n options: CreateAdminSeoLoaderOptions = {}\n): SeoLocalEntry['load'] {\n const endpoint = options.endpoint ?? '/api/seo?path={pathname}';\n const fallbackEntries = options.fallbackEntries ?? [];\n // 编译一次 + 缓存。N 个 resolver 在每个请求里只是 N 次正则 test,cost 可忽略。\n const compiledResolvers: CompiledSeoResolver[] = (options.dynamicResolvers ?? []).map(\n compileSeoResolver\n );\n\n return async (params, ctx) => {\n const pathname = normalizePathname(params.pathname || '/');\n\n // 1. admin endpoint —— 运营在 dashboard 给具体 path 配过的覆盖优先级最高\n const remoteUrl = resolveAdminUrl(endpoint, { ...params, pathname }, ctx);\n const remote = remoteUrl\n ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)\n : null;\n const remoteMeta = extractSeoMetaOrNull(remote);\n if (remoteMeta) return remoteMeta;\n\n // 2. dynamic resolvers —— 参数化路径的请求期数据驱动\n if (compiledResolvers.length > 0) {\n for (const compiled of compiledResolvers) {\n const m = pathname.match(compiled.re);\n if (!m) continue;\n const resolverParams: Record<string, string> = {};\n compiled.paramNames.forEach((name, i) => {\n resolverParams[name] = m[i + 1] ?? '';\n });\n try {\n const result = await compiled.resolver.resolve({\n pathname,\n params: resolverParams,\n locale: typeof params.locale === 'string' ? params.locale : undefined,\n services: ctx.services,\n });\n if (result) return result as PageSeoMeta;\n } catch (err) {\n // resolver 抛错不阻塞渲染:业务异常时把 SEO 当 null 处理\n console.warn('[seo] dynamic resolver threw, falling through to fallback', err);\n }\n // 同 pattern 没命中数据就继续找下一个 resolver / fallback;不退出。\n // 例:/books/:id 解析失败时,可能匹配了更宽的 /:scope/:id resolver 兜底。\n }\n }\n\n // 3. fallbackLocal —— build 期冻结的兜底\n const fallback = fallbackEntries.find(entry => normalizePathname(entry.path) === pathname);\n if (!fallback) return null;\n const meta = { ...fallback } as Record<string, unknown>;\n delete meta.path;\n delete meta.group;\n return meta as PageSeoMeta;\n };\n}\n\nexport function defineAdminSiteHooks(options: DefineAdminSiteHooksOptions = {}): ServerHooksOutput {\n return createAdminSiteHooks(options, createEmptyRuntimeConfig());\n}\n\nfunction createAdminSiteHooks(\n options: DefineAdminSiteHooksOptions,\n runtime: SiteRuntimeConfig\n): ServerHooksOutput {\n const runtimeI18n: Partial<RuntimeI18nConfig> = runtime.i18n ?? {};\n const runtimeSeo: Partial<RuntimeSeoConfig> = runtime.seo ?? {};\n const i18n = options.i18n ?? {};\n const seo = options.seo ?? {};\n const fallbackMessages = i18n.fallbackLocal ?? runtimeI18n.fallbackLocal ?? {};\n const locales =\n i18n.locales ??\n runtimeI18n.locales ??\n (Object.keys(fallbackMessages).length > 0 ? Object.keys(fallbackMessages) : ['en']);\n const defaultLocale = i18n.defaultLocale ?? runtimeI18n.defaultLocale ?? locales[0] ?? 'en';\n\n const output = createSiteHooks(\n {\n beforeRequest: options.beforeRequest,\n onError: options.onError,\n headExtras: options.headExtras,\n intl: {\n locales,\n defaultLocale,\n prefixDefault: i18n.prefixDefault ?? runtimeI18n.prefixDefault,\n detect: i18n.detect,\n load: createAdminIntlLoader({\n endpoint: i18n.endpoint ?? runtimeI18n.endpoint,\n fallbackMessages,\n defaultLocale,\n timeoutMs: i18n.timeoutMs ?? runtimeI18n.timeoutMs,\n remoteSource: i18n.remoteSource ?? runtimeI18n.remoteSource,\n fallbackSource: i18n.fallbackSource ?? runtimeI18n.fallbackSource,\n }),\n ttl: i18n.ttl ?? runtimeI18n.ttl ?? 60_000,\n },\n seo: {\n '/*': {\n load: createAdminSeoLoader({\n endpoint: seo.endpoint ?? runtimeSeo.endpoint,\n fallbackEntries: normalizeAdminSeoFallbackEntries(\n seo.fallbackLocal ?? runtimeSeo.fallbackLocal\n ),\n timeoutMs: seo.timeoutMs ?? runtimeSeo.timeoutMs,\n dynamicResolvers: seo.dynamicResolvers ?? runtimeSeo.dynamicResolvers,\n }),\n ttl: seo.ttl ?? runtimeSeo.ttl ?? 60_000,\n },\n },\n },\n runtime\n );\n Object.defineProperty(output, '__configureRuntime', {\n enumerable: false,\n configurable: true,\n value: (nextRuntime: SiteRuntimeConfig) => createAdminSiteHooks(options, nextRuntime),\n });\n return output;\n}\n\nexport interface ServerHooksOutput {\n /** site URL —— SEO 注入时把 image/canonical 等相对路径解析为绝对 URL */\n siteBaseUrl?: string;\n /** 浏览器可访问的 API base —— 注入到 csr-shell 的 window.__API_BASE__ */\n apiBaseUrl?: string;\n /**\n * 原始 intl 配置(用户在 defineSiteHooks 里写的那份),透传出来给 app.tsx 的 parseLocale 用\n * —— 让 i18n 配置只声明一次,不需要单独 i18n.config.ts\n */\n intl?: IntlConfig;\n beforeRequest: (\n req: Request,\n engineCtx: { traceId: string; startedAt: number }\n ) => Promise<Record<string, unknown>>;\n loadIntl: (req: Request) => Promise<IntlPayload | null>;\n loadSeoMeta: (req: Request) => Promise<PageSeoMeta | null>;\n onError: (\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string }\n ) => void | Promise<void>;\n /** 注入 `<head>` 末尾的 raw HTML —— 详见 SiteHooksConfig.headExtras 注释 */\n headExtras?: (ctx: { nonce?: string }) => string | undefined;\n __configureRuntime?: (runtime: SiteRuntimeConfig) => ServerHooksOutput;\n}\n\nexport function defineSiteHooks(config: SiteHooksConfig): ServerHooksOutput {\n return createSiteHooks(config, createEmptyRuntimeConfig());\n}\n\nexport function applyRuntimeToServerHooks<T extends object>(\n hooks: T,\n runtime: SiteRuntimeConfig\n): T {\n const maybeRuntimeAware = hooks as T & {\n __configureRuntime?: (runtime: SiteRuntimeConfig) => T;\n };\n if (typeof maybeRuntimeAware.__configureRuntime === 'function') {\n return maybeRuntimeAware.__configureRuntime(runtime);\n }\n const baseHooks = hooks as T & {\n siteBaseUrl?: string;\n apiBaseUrl?: string;\n intl?: unknown;\n loadIntl?: unknown;\n loadSeoMeta?: unknown;\n beforeRequest?: SiteHooksConfig['beforeRequest'];\n onError?: SiteHooksConfig['onError'];\n };\n const services = resolveRuntimeServices(runtime);\n const siteBaseUrl = baseHooks.siteBaseUrl ?? runtime.site;\n const apiBaseUrl = baseHooks.apiBaseUrl ?? services.api;\n const hasUserContentHooks =\n !!baseHooks.intl ||\n typeof baseHooks.loadIntl === 'function' ||\n typeof baseHooks.loadSeoMeta === 'function';\n\n if (!hasUserContentHooks && hasRuntimeContentConfig(runtime)) {\n const runtimeHooks = createAdminSiteHooks(\n {\n beforeRequest: baseHooks.beforeRequest,\n onError: baseHooks.onError,\n },\n runtime\n );\n return {\n ...hooks,\n siteBaseUrl,\n apiBaseUrl,\n intl: runtimeHooks.intl,\n beforeRequest: runtimeHooks.beforeRequest,\n loadIntl: runtimeHooks.loadIntl,\n loadSeoMeta: runtimeHooks.loadSeoMeta,\n onError: runtimeHooks.onError,\n } as T;\n }\n\n return {\n ...hooks,\n siteBaseUrl,\n apiBaseUrl,\n } as T;\n}\n\nfunction createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): ServerHooksOutput {\n const services = resolveRuntimeServices(runtime);\n const api = services.api ?? '';\n const site = runtime.site ?? '';\n const runtimeCtx: SiteRuntimeContext = {\n runtime,\n services,\n telemetry: services.telemetry,\n site: site || undefined,\n };\n const fetchJson = async (path: string, baseUrl?: string): Promise<unknown> => {\n try {\n if (!baseUrl) return null;\n const r = await fetch(baseUrl + path);\n if (!r.ok) return null;\n return await r.json();\n } catch {\n return null;\n }\n };\n\n // ─── i18n 缓存(一次创建,请求级复用)──────────────\n const intlCfg = config.intl ?? {};\n const fallbackLocale = intlCfg.defaultLocale ?? 'zh-CN';\n const supportedLocales = intlCfg.locales?.length ? intlCfg.locales : undefined;\n // 默认 detect 优先级(业界标准 i18n 顺序):\n // 1. URL pathname 前缀 /en-US/... → 'en-US' ← 显式路由意图,最高优先级\n // 2. locale cookie ← 用户手动切换过的偏好\n // 3. Accept-Language 头 ← 浏览器系统语言\n // 4. defaultLocale ← 兜底\n //\n // 关键:前缀路由(prefixDefault:true 等场景)下,URL 是源真值。如果不优先用\n // URL,curl /en-US 但 Accept-Language 是 zh 会被错误降级到 zh-CN,跟用户\n // 明确写在 URL 里的意图相反。\n // 业务侧可通过 intlCfg.detect 完全覆盖(任何 (req) => string 都行)。\n const detectLocale =\n intlCfg.detect ??\n ((req: Request): string => {\n // 1. URL 前缀\n if (supportedLocales) {\n try {\n const pathname = new URL(req.url).pathname;\n // 客户端 RSC 导航 URL 带 `_.rsc` 后缀(如 `/ja_.rsc`),不剥掉的话\n // 首段会变成 `ja_.rsc` 命中不了 locale,从而错误回退到 cookie /\n // Accept-Language / defaultLocale —— 这正是「切换语言必须刷新才生效」\n // 的根因(RSC 导航拿到的 intl 语言与 URL 前缀不一致)。\n const cleanPath = pathname.endsWith('_.rsc')\n ? pathname.slice(0, -'_.rsc'.length) || '/'\n : pathname;\n const first = cleanPath.split('/')[1];\n if (first && supportedLocales.includes(first)) return first;\n } catch {\n // 非法 URL(极少见,比如内部调用喂了相对路径)→ 继续后续策略\n }\n }\n // 2. cookie\n const localeCookie = readCookie(req, 'locale');\n if (localeCookie) {\n return supportedLocales\n ? normalizeLocale(localeCookie, supportedLocales, fallbackLocale)\n : localeCookie;\n }\n // 3. Accept-Language → 4. fallbackLocale\n const accept = req.headers.get('accept-language') ?? '';\n return supportedLocales\n ? normalizeLocale(parseAcceptLanguage(accept), supportedLocales, fallbackLocale)\n : inferLocaleFromAcceptLanguage(accept, fallbackLocale);\n });\n\n const intlLoader = createCachedFetcher<string, IntlPayload>({\n key: locale => `intl:${locale}`,\n ttl: intlCfg.ttl ?? 60_000,\n swr: true,\n fetch: async locale => {\n if (intlCfg.load) {\n const r = await intlCfg.load(locale, runtimeCtx);\n return r ?? { locale, messages: {}, direction: rtlOf(locale) };\n }\n if (intlCfg.endpoint) {\n const url = fillTemplate(intlCfg.endpoint, { locale });\n const json = await fetchJson(url, services.api);\n if (json !== null && intlCfg.transform) {\n const transformed = await intlCfg.transform(json, locale);\n if (transformed) {\n return {\n ...transformed,\n direction: transformed.direction ?? rtlOf(transformed.locale),\n };\n }\n }\n return {\n locale,\n messages: extractIntlMessages(json),\n direction: rtlOf(locale),\n };\n }\n return { locale, messages: {}, direction: rtlOf(locale) };\n },\n fallback: locale => ({ locale, messages: {}, direction: rtlOf(locale) }),\n });\n\n // ─── SEO 路由表编译 + 远程 loader 缓存(每个 pattern 一份)─────\n const seoRoutes: CompiledRoute[] = [];\n const remoteCaches = new Map<\n string,\n ReturnType<typeof createCachedFetcher<string, PageSeoMeta | null>>\n >();\n\n for (const [pattern, value] of Object.entries(config.seo ?? {})) {\n const { re, paramNames } = compilePattern(pattern);\n\n if (typeof value === 'function') {\n // 自定义 resolver\n seoRoutes.push({ re, paramNames, resolver: value as CompiledRoute['resolver'] });\n continue;\n }\n if ('endpoint' in value && typeof (value as SeoRemoteEntry).endpoint === 'string') {\n const remote = value as SeoRemoteEntry;\n const cache = createCachedFetcher<string, PageSeoMeta | null>({\n key: paramKey => `seo:${pattern}:${paramKey}`,\n ttl: remote.ttl ?? 300_000,\n fetch: async paramKey => {\n const params = JSON.parse(paramKey) as Record<string, string>;\n const data = await fetchJson(fillTemplate(remote.endpoint, params), services.api);\n if (data === null) return null;\n return remote.transform(data, params);\n },\n fallback: () => null,\n });\n remoteCaches.set(pattern, cache);\n seoRoutes.push({\n re,\n paramNames,\n resolver: params => cache(JSON.stringify(params)),\n });\n continue;\n }\n if ('load' in value && typeof (value as SeoLocalEntry).load === 'function') {\n const local = value as SeoLocalEntry;\n const cache = createCachedFetcher<string, PageSeoMeta | null>({\n key: paramKey => `seo-local:${pattern}:${paramKey}`,\n ttl: local.ttl ?? 300_000,\n fetch: async paramKey => {\n const params = JSON.parse(paramKey) as Record<string, string>;\n return await local.load(params, runtimeCtx);\n },\n fallback: () => null,\n });\n remoteCaches.set(pattern, cache);\n seoRoutes.push({\n re,\n paramNames,\n resolver: params => cache(JSON.stringify(params)),\n });\n continue;\n }\n // 静态 meta\n const staticMeta = value as SeoStaticEntry;\n const withDefaults: PageSeoMeta = {\n ...staticMeta,\n canonical:\n staticMeta.canonical ??\n (site && pattern && pattern !== '/*' ? `${site}${pattern}` : staticMeta.canonical),\n };\n seoRoutes.push({ re, paramNames, resolver: () => withDefaults });\n }\n\n // ─── onError ─────\n const platformOnError = createPlatformOnError(runtime, runtimeCtx);\n const onError: ServerHooksOutput['onError'] = async (err, req, ctx) => {\n platformOnError(err, req, ctx);\n if (config.onError) {\n await config.onError(err, req, ctx);\n }\n };\n\n const output: ServerHooksOutput = {\n siteBaseUrl: site || undefined,\n apiBaseUrl: api || undefined,\n intl: config.intl,\n headExtras: config.headExtras,\n async beforeRequest(req, _engineCtx) {\n const locale = detectLocale(req);\n const userExt = config.beforeRequest ? await config.beforeRequest(req) : {};\n return { locale, ...userExt };\n },\n async loadIntl(req) {\n return intlLoader(detectLocale(req));\n },\n async loadSeoMeta(req) {\n const url = new URL(req.url);\n const locale = detectLocale(req);\n // 客户端 RSC 导航 fetch 的 URL 带 _.rsc 后缀(详见 defaults/runtime/request.tsx)。\n // 先剥后缀,否则 /zh-CN/books/1_.rsc 永远 match 不到 /books/:id route → seoMeta=null →\n // 客户端导航后 head 不更新。HTML 请求没这个后缀,原行为不变。\n let pathForRouting = url.pathname;\n if (pathForRouting.endsWith('_.rsc')) {\n pathForRouting = pathForRouting.slice(0, -'_.rsc'.length) || '/';\n }\n // SEO 表是按\"业务规范路径\"('/' / '/books' / '/about')入库的,\n // 不带 locale 前缀。请求 URL 是带前缀的('/en-US/'、'/zh-CN/books'),\n // 直接喂给 admin 查不到。先用 parseLocale 把 locale 段剥掉,\n // 再去 seoRoutes 里匹配 + 调 admin endpoint。\n // 同时 locale 单独传到 resolver params,让 endpoint 模板里 {locale}\n // 占位符能填对应语言(之前那个 fix 留着,跟 strip 配合一起才完整)。\n const intlConfig = config.intl;\n const cleanPath =\n intlConfig?.locales && intlConfig.locales.length > 0\n ? parseLocale(pathForRouting, {\n locales: intlConfig.locales,\n defaultLocale: intlConfig.defaultLocale ?? intlConfig.locales[0]!,\n prefixDefault: intlConfig.prefixDefault,\n } satisfies I18nConfig).pathname\n : pathForRouting;\n\n for (const { re, paramNames, resolver } of seoRoutes) {\n const m = cleanPath.match(re);\n if (m) {\n const params: Record<string, string> = {\n pathname: cleanPath,\n locale,\n };\n paramNames.forEach((n, i) => (params[n] = m[i + 1] ?? ''));\n return await resolver(params);\n }\n }\n return null;\n },\n onError,\n };\n Object.defineProperty(output, '__configureRuntime', {\n enumerable: false,\n configurable: true,\n value: (nextRuntime: SiteRuntimeConfig) => createSiteHooks(config, nextRuntime),\n });\n return output;\n}\n\nfunction rtlOf(locale: string): 'ltr' | 'rtl' {\n return /^(ar|he|fa|ur)/.test(locale) ? 'rtl' : 'ltr';\n}\n\nfunction parseAcceptLanguage(accept: string): string {\n let best = '';\n let bestQ = -1;\n for (const part of accept.split(',')) {\n const [rawLocale, ...attrs] = part.trim().split(';');\n if (!rawLocale) continue;\n const qAttr = attrs.find(attr => attr.trim().startsWith('q='));\n const q = qAttr ? Number(qAttr.trim().slice(2)) : 1;\n if (Number.isFinite(q) && q > bestQ) {\n best = rawLocale;\n bestQ = q;\n }\n }\n return best;\n}\n\nfunction inferLocaleFromAcceptLanguage(accept: string, fallbackLocale: string): string {\n const best = parseAcceptLanguage(accept);\n if (!best) return fallbackLocale;\n const primary = best.toLowerCase().split('-')[0];\n if (primary === 'zh') return 'zh-CN';\n if (primary === 'en') return 'en';\n return fallbackLocale;\n}\n\nfunction normalizeLocale(\n value: string,\n supportedLocales: readonly string[],\n fallbackLocale: string\n): string {\n const lower = value.toLowerCase();\n const exact = supportedLocales.find(locale => locale.toLowerCase() === lower);\n if (exact) return exact;\n const prefix = lower.split('-')[0];\n const byPrefix = supportedLocales.find(locale => locale.toLowerCase().split('-')[0] === prefix);\n return byPrefix ?? fallbackLocale;\n}\n\nfunction extractIntlMessages(data: unknown): Record<string, unknown> {\n return extractIntlMessagesOrNull(data) ?? {};\n}\n\nfunction extractIntlMessagesOrNull(data: unknown): Record<string, unknown> | null {\n if (!data || typeof data !== 'object') return null;\n const raw = data as Record<string, unknown>;\n const dataValue = raw.data;\n const candidate =\n raw.strings ??\n raw.messages ??\n (isRecord(dataValue) && 'strings' in dataValue ? dataValue.strings : dataValue);\n if (!candidate || typeof candidate !== 'object') return null;\n return normalizeMessages(candidate as Record<string, unknown>);\n}\n\nfunction normalizeMessages(messages: Record<string, unknown>): Record<string, unknown> {\n if (isFlatRecord(messages)) {\n return expandDottedRecord(messages);\n }\n return messages;\n}\n\n/**\n * 逐层剥 envelope —— admin 在不同分支返回三种 shape:\n * - flat:`{ title, description, ... }`(admin no-locale fast path)\n * - 单层:`{ data: { title, ... } }`(旧版本)\n * - 双层:`{ status, code, data: { data: { title, ... }, version } }`\n * (api-envelope plugin 包了一层,resolvePublic 自己又是 `{ data, version }`,\n * 所以 locale-aware 路径会双层 wrap)\n *\n * 停止条件:候选对象有 `title` / `description`(SEO 形状),或没有 `data` 字段可剥。\n */\nfunction extractSeoMetaOrNull(data: unknown): PageSeoMeta | null {\n let candidate: unknown = data;\n for (let i = 0; i < 4; i++) {\n if (!isRecord(candidate)) return null;\n if ('title' in candidate || 'description' in candidate) break;\n if ('data' in candidate) {\n candidate = candidate.data;\n continue;\n }\n return null;\n }\n if (!isRecord(candidate)) return null;\n return candidate as PageSeoMeta;\n}\n\nfunction normalizeAdminSeoFallbackEntries(\n entries: readonly Record<string, unknown>[] = []\n): readonly AdminSeoFallbackEntry[] {\n return entries.filter(\n entry => typeof entry.path === 'string'\n ) as unknown as readonly AdminSeoFallbackEntry[];\n}\n\nfunction createPlatformOnError(\n runtime: SiteRuntimeConfig,\n ctx: SiteRuntimeContext\n): NonNullable<ServerHooksOutput['onError']> {\n const reportServerError = createServerErrorEndpointReporter(runtime, ctx);\n\n return (err, req, errorCtx) => {\n console.error('[onError]', {\n traceId: errorCtx.traceId,\n locale: errorCtx.locale,\n url: req.url,\n msg: err instanceof Error ? err.message : String(err),\n });\n reportServerError?.(err, req, errorCtx);\n };\n}\n\nfunction createServerErrorEndpointReporter(\n runtime: SiteRuntimeConfig,\n ctx: SiteRuntimeContext\n): ((err: unknown, req: Request, errorCtx: { traceId: string; locale?: string }) => void) | null {\n const config = runtime.telemetry;\n if (config === false || !config || config.errors === false) return null;\n\n const errors = config.errors ?? {};\n const endpoint = resolveAdminUrl(errors.endpoint ?? '/api/observability/errors', {}, ctx, {\n baseUrl: runtimeCtx => runtimeCtx.services.telemetry ?? runtimeCtx.services.api,\n });\n if (!endpoint) return null;\n\n const app = config.app ?? 'isr-engine-app';\n const release = config.release;\n const environment = config.environment;\n const includeQueryString = config.includeQueryString === true;\n\n return (err, req, errorCtx) => {\n const id = createServerReportId();\n if (!id) return;\n const report = normalizeServerErrorReport(err, req, errorCtx, {\n id,\n release,\n environment,\n includeQueryString,\n });\n\n void fetch(endpoint, {\n method: 'POST',\n headers: {\n 'content-type': 'application/json',\n accept: 'application/json',\n },\n body: JSON.stringify({\n app,\n sentAt: Date.now(),\n reports: [report],\n }),\n signal: typeof AbortSignal !== 'undefined' ? AbortSignal.timeout(1000) : undefined,\n }).catch(() => {\n /* 服务端错误上报不能阻断渲染兜底;失败交给进程日志和外层 adapter */\n });\n };\n}\n\nfunction normalizeServerErrorReport(\n err: unknown,\n req: Request,\n ctx: { traceId: string; locale?: string },\n options: {\n id: string;\n release?: string;\n environment?: string;\n includeQueryString?: boolean;\n }\n): Record<string, unknown> {\n const error = err instanceof Error ? err : null;\n const message = error?.message || String(err);\n const name = error?.name || 'Error';\n const url = safeRequestPath(req.url, options.includeQueryString);\n\n return {\n id: options.id,\n ts: Date.now(),\n level: 'error',\n message,\n name,\n stack: error?.stack,\n release: options.release,\n environment: options.environment,\n url,\n source: 'server-render',\n tags: {\n traceId: ctx.traceId,\n locale: ctx.locale,\n },\n extra: {\n method: req.method,\n pathname: url.split('?')[0] || '/',\n },\n fingerprint: ['server-render', name, message.slice(0, 160)],\n };\n}\n\nfunction safeRequestPath(rawUrl: string, includeQueryString?: boolean): string {\n try {\n const url = new URL(rawUrl);\n return includeQueryString ? `${url.pathname}${url.search}` : url.pathname;\n } catch {\n return includeQueryString ? rawUrl : '/';\n }\n}\n\nfunction createServerReportId(): string | null {\n try {\n return `srv_${crypto.randomUUID()}`;\n } catch {\n // Optional reporting must not weaken IDs or interrupt rendering without Web Crypto.\n return null;\n }\n}\n\nasync function fetchJsonWithTimeout<T>(url: string, timeoutMs = 1200): Promise<T | null> {\n try {\n const response = await fetch(url, {\n headers: { Accept: 'application/json' },\n signal: timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined,\n });\n if (!response.ok) return null;\n return (await response.json()) as T;\n } catch {\n return null;\n }\n}\n\nfunction resolveAdminUrl(\n endpoint: string,\n vars: Record<string, string>,\n ctx: SiteRuntimeContext,\n options: { baseUrl?: RuntimeServiceBase } = {}\n): string | null {\n const filled = fillTemplate(endpoint, vars);\n if (/^(https?:)?\\/\\//i.test(filled)) return filled;\n const base = resolveRuntimeServiceBase(ctx, options.baseUrl);\n if (!base) return null;\n return `${trimTrailingSlashes(base)}/${filled.replace(/^\\/+/, '')}`;\n}\n\nfunction resolveRuntimeServiceBase(\n ctx: SiteRuntimeContext,\n baseUrl?: RuntimeServiceBase\n): string | null {\n if (typeof baseUrl === 'function') {\n return baseUrl(ctx) ?? null;\n }\n if (baseUrl) return baseUrl;\n return ctx.services.api ?? null;\n}\n\nfunction resolveRuntimeServices(runtime: SiteRuntimeConfig): RuntimeServices {\n const services = runtime.services ?? {};\n const api = services.api;\n return {\n api,\n telemetry: services.telemetry ?? api,\n };\n}\n\nfunction hasRuntimeContentConfig(runtime: SiteRuntimeConfig): boolean {\n return !!(\n runtime.i18n?.endpoint ||\n runtime.i18n?.fallbackLocal ||\n runtime.seo?.endpoint ||\n runtime.seo?.fallbackLocal ||\n runtime.telemetry\n );\n}\n\nfunction normalizePathname(pathname: string): string {\n if (pathname === '/') return '/';\n return trimTrailingSlashes(pathname) || '/';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return !!value && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isFlatRecord(value: unknown): boolean {\n if (!value || typeof value !== 'object') return false;\n return Object.keys(value as Record<string, unknown>).some(key => key.includes('.'));\n}\n\nfunction expandDottedRecord(flat: Record<string, unknown>): Record<string, unknown> {\n const out: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(flat)) {\n const parts = key.split('.');\n let cur = out;\n parts.forEach((part, index) => {\n if (index === parts.length - 1) {\n cur[part] = value;\n return;\n }\n const next = cur[part];\n if (!next || typeof next !== 'object') cur[part] = {};\n cur = cur[part] as Record<string, unknown>;\n });\n }\n return out;\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- const require_i18n = require("./i18n-CyJIoYJT.cjs");
1
+ const require_i18n = require("./i18n-CS5QhOO0.cjs");
2
2
  //#region src/defaults/runtime/createCachedFetcher.ts
3
3
  /**
4
4
  * createCachedFetcher —— 通用 TTL + 并发去重数据加载器
@@ -588,7 +588,10 @@ function createServerErrorEndpointReporter(runtime, ctx) {
588
588
  const environment = config.environment;
589
589
  const includeQueryString = config.includeQueryString === true;
590
590
  return (err, req, errorCtx) => {
591
+ const id = createServerReportId();
592
+ if (!id) return;
591
593
  const report = normalizeServerErrorReport(err, req, errorCtx, {
594
+ id,
592
595
  release,
593
596
  environment,
594
597
  includeQueryString
@@ -614,7 +617,7 @@ function normalizeServerErrorReport(err, req, ctx, options) {
614
617
  const name = error?.name || "Error";
615
618
  const url = safeRequestPath(req.url, options.includeQueryString);
616
619
  return {
617
- id: createServerReportId(),
620
+ id: options.id,
618
621
  ts: Date.now(),
619
622
  level: "error",
620
623
  message,
@@ -648,8 +651,11 @@ function safeRequestPath(rawUrl, includeQueryString) {
648
651
  }
649
652
  }
650
653
  function createServerReportId() {
651
- const random = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : Math.random().toString(36).slice(2);
652
- return `srv_${Date.now().toString(36)}_${random}`;
654
+ try {
655
+ return `srv_${crypto.randomUUID()}`;
656
+ } catch {
657
+ return null;
658
+ }
653
659
  }
654
660
  async function fetchJsonWithTimeout(url, timeoutMs = 1200) {
655
661
  try {
@@ -752,4 +758,4 @@ Object.defineProperty(exports, "defineSiteHooks", {
752
758
  }
753
759
  });
754
760
 
755
- //# sourceMappingURL=defineSiteHooks-C3v3WLS8.cjs.map
761
+ //# sourceMappingURL=defineSiteHooks-w2IrF5-D.cjs.map