isr-engine 4.1.0 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +9 -0
  2. package/dist/CacheTagContext-Btmq8KCD.js +69 -0
  3. package/dist/CacheTagContext-Btmq8KCD.js.map +1 -0
  4. package/dist/{abVariantContext-CGBlCt0q.js → abVariantContext-yWZOqscY.js} +118 -38
  5. package/dist/abVariantContext-yWZOqscY.js.map +1 -0
  6. package/dist/cache/RedisInvalidationBus.d.ts.map +1 -1
  7. package/dist/cache/RedisResponseCacheBackend.d.ts +1 -0
  8. package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -1
  9. package/dist/cache/ResponseCacheBackend.d.ts +6 -0
  10. package/dist/cache/ResponseCacheBackend.d.ts.map +1 -1
  11. package/dist/cli/cli.js +1 -1
  12. package/dist/config/defineConfig.js +1 -1
  13. package/dist/context/CacheTagContext.d.ts +10 -0
  14. package/dist/context/CacheTagContext.d.ts.map +1 -0
  15. package/dist/{createCacheInspectorMiddleware-D6c-CINz.js → createCacheInspectorMiddleware-glgtcBcQ.js} +2 -2
  16. package/dist/{createCacheInspectorMiddleware-D6c-CINz.js.map → createCacheInspectorMiddleware-glgtcBcQ.js.map} +1 -1
  17. package/dist/createCachedFetcher-CgJscexq.js +186 -0
  18. package/dist/createCachedFetcher-CgJscexq.js.map +1 -0
  19. package/dist/{createISRApp-DTlZvKBm.js → createISRApp-BG-s3uuL.js} +356 -162
  20. package/dist/createISRApp-BG-s3uuL.js.map +1 -0
  21. package/dist/defaults/runtime/contentRevalidation.d.ts +26 -0
  22. package/dist/defaults/runtime/contentRevalidation.d.ts.map +1 -0
  23. package/dist/defaults/runtime/createCachedFetcher.d.ts +8 -2
  24. package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -1
  25. package/dist/defaults/runtime/defineSiteHooks.d.ts +4 -7
  26. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -1
  27. package/dist/defaults/runtime/defineSiteHooks.js +655 -2
  28. package/dist/defaults/runtime/defineSiteHooks.js.map +1 -0
  29. package/dist/defaults/runtime/locale-links.client.d.ts.map +1 -1
  30. package/dist/defaults/runtime/renderCancellation.d.ts +3 -0
  31. package/dist/defaults/runtime/renderCancellation.d.ts.map +1 -0
  32. package/dist/engine/ISREngine.d.ts.map +1 -1
  33. package/dist/engine/seo/SEOEngine.d.ts +3 -0
  34. package/dist/engine/seo/SEOEngine.d.ts.map +1 -1
  35. package/dist/engine/seo/resolveSeoConfig.d.ts +6 -0
  36. package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -1
  37. package/dist/{i18n-B2mWmifk.js → i18n-BZpAOZeO.js} +3 -2
  38. package/dist/{i18n-B2mWmifk.js.map → i18n-BZpAOZeO.js.map} +1 -1
  39. package/dist/index.d.ts +2 -2
  40. package/dist/index.d.ts.map +1 -1
  41. package/dist/isr/ISRRoutes.d.ts +2 -0
  42. package/dist/isr/ISRRoutes.d.ts.map +1 -1
  43. package/dist/isr-engine.js +7 -7
  44. package/dist/middlewares/LocaleRedirect.d.ts +4 -3
  45. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -1
  46. package/dist/plugin/coherentCacheStore.d.ts.map +1 -1
  47. package/dist/plugin/isrCacheMiddleware.d.ts +7 -6
  48. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -1
  49. package/dist/plugin/isrCacheStore.d.ts +2 -0
  50. package/dist/plugin/isrCacheStore.d.ts.map +1 -1
  51. package/dist/rsc/browser.d.ts +3 -0
  52. package/dist/rsc/browser.d.ts.map +1 -1
  53. package/dist/rsc/browser.js +4 -9
  54. package/dist/rsc/browser.js.map +1 -1
  55. package/dist/rsc/cacheTag.d.ts +1 -8
  56. package/dist/rsc/cacheTag.d.ts.map +1 -1
  57. package/dist/rsc/index.d.ts +1 -1
  58. package/dist/rsc/index.d.ts.map +1 -1
  59. package/dist/rsc/index.js +4 -3
  60. package/dist/rsc/revalidate.d.ts +18 -9
  61. package/dist/rsc/revalidate.d.ts.map +1 -1
  62. package/dist/{rsc-DWwcqD4W.js → rsc-BYq2vvnh.js} +2 -2
  63. package/dist/{rsc-DWwcqD4W.js.map → rsc-BYq2vvnh.js.map} +1 -1
  64. package/dist/runtime/LocaleLink.d.ts.map +1 -1
  65. package/dist/runtime/i18n.d.ts +3 -0
  66. package/dist/runtime/i18n.d.ts.map +1 -1
  67. package/dist/runtime/localePreference.d.ts +7 -0
  68. package/dist/runtime/localePreference.d.ts.map +1 -0
  69. package/dist/server/contentRevalidationRoute.d.ts +4 -0
  70. package/dist/server/contentRevalidationRoute.d.ts.map +1 -0
  71. package/dist/server/manager.d.ts.map +1 -1
  72. package/dist/server/opsConfig.d.ts +6 -1
  73. package/dist/server/opsConfig.d.ts.map +1 -1
  74. package/dist/server/productionRuntime.d.ts +2 -0
  75. package/dist/server/productionRuntime.d.ts.map +1 -1
  76. package/dist/server/publishedSitemap.d.ts +8 -0
  77. package/dist/server/publishedSitemap.d.ts.map +1 -0
  78. package/dist/types/ISRConfig.d.ts +27 -0
  79. package/dist/types/ISRConfig.d.ts.map +1 -1
  80. package/dist/utils/cookie.d.ts +2 -2
  81. package/dist/utils/cookie.d.ts.map +1 -1
  82. package/dist/utils/isrPath.d.ts +6 -0
  83. package/dist/utils/isrPath.d.ts.map +1 -0
  84. package/package.json +2 -2
  85. package/src/context/CacheTagContext.ts +20 -0
  86. package/src/defaults/entry.server.ssr.tsx +10 -0
  87. package/src/defaults/runtime/contentRevalidation.ts +96 -0
  88. package/src/defaults/runtime/createCachedFetcher.ts +76 -20
  89. package/src/defaults/runtime/defineServerEntry.tsx +30 -29
  90. package/src/defaults/runtime/defineSiteHooks.ts +117 -80
  91. package/src/defaults/runtime/locale-links.client.ts +14 -4
  92. package/src/defaults/runtime/renderCancellation.ts +10 -0
  93. package/src/runtime/LocaleLink.tsx +8 -2
  94. package/src/runtime/i18n.ts +4 -0
  95. package/src/runtime/localePreference.ts +36 -0
  96. package/src/types/ISRConfig.ts +29 -0
  97. package/src/utils/cookie.ts +11 -4
  98. package/src/utils/isrPath.ts +24 -0
  99. package/dist/abVariantContext-CGBlCt0q.js.map +0 -1
  100. package/dist/cookie-DcUeYm6E.js +0 -42
  101. package/dist/cookie-DcUeYm6E.js.map +0 -1
  102. package/dist/createISRApp-DTlZvKBm.js.map +0 -1
  103. package/dist/defineSiteHooks-iwLiVChy.js +0 -716
  104. package/dist/defineSiteHooks-iwLiVChy.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defineSiteHooks.js","names":[],"sources":["../../../src/defaults/runtime/defineSiteHooks.ts"],"sourcesContent":["/**\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 { contentPathname, RSC_URL_POSTFIX } from '../../utils/isrPath';\nimport { createCachedFetcher } from './createCachedFetcher';\nimport { registerContentInvalidator } from './contentRevalidation';\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 {\n negotiateLocale,\n parseLocale,\n resolveI18nConfig,\n type I18nConfig,\n} from '../../runtime/i18n';\nimport { readLocalePreference } from '../../runtime/localePreference';\nimport { markUncacheable } from '../../context/CacheTagContext';\n\nexport { getCookieHeader, parseCookieHeader, readCookie } from '../../utils/cookie';\n\nexport type SiteRuntimeConfig = ISRConfig['runtime'];\n\nconst CONTENT_INVALIDATOR = Symbol('contentInvalidator');\nconst MARK_METADATA_DEGRADED = Symbol('markMetadataDegraded');\n\nexport interface SiteRuntimeContext {\n runtime: SiteRuntimeConfig;\n services: RuntimeServices;\n telemetry?: string;\n site?: string;\n [MARK_METADATA_DEGRADED]?: () => void;\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\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 extends Partial<I18nConfig> {\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 检测(默认:URL 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 CompiledSeoPattern {\n re: RegExp;\n paramNames: string[];\n}\n\ninterface SeoRouteRequest {\n pathname: string;\n locale: string;\n params: Record<string, string>;\n}\n\ninterface CompiledRoute extends CompiledSeoPattern {\n resolver: (request: SeoRouteRequest) => Promise<PageSeoMeta | null> | PageSeoMeta | null;\n}\n\nfunction escapeSeoPatternLiteral(literal: string): string {\n return literal.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/** Both SEO entry points recognize named parameters and a terminal /* before escaping literals. */\nfunction compileSeoPattern(pattern: string, captureWildcard = false): CompiledSeoPattern {\n const paramNames: string[] = [];\n const wildcard = pattern.endsWith('/*');\n const base = wildcard ? pattern.slice(0, -2) : pattern;\n let cursor = 0;\n let source = '';\n for (const match of base.matchAll(/:(\\w+)/g)) {\n source += escapeSeoPatternLiteral(base.slice(cursor, match.index)) + '([^/]+)';\n paramNames.push(match[1]);\n cursor = match.index + match[0].length;\n }\n source += escapeSeoPatternLiteral(base.slice(cursor));\n\n if (wildcard) {\n if (captureWildcard) paramNames.push('wildcard');\n source += captureWildcard ? '(?:/(.*))?' : '(?:/.*)?';\n }\n return { re: new RegExp(`^${source}$`), 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 ? (matchConfiguredLocale(locale, supportedLocales) ?? defaultLocale)\n : locale;\n const remoteUrl = resolveAdminUrl(endpoint, { locale: normalizedLocale }, ctx);\n const remote = remoteUrl\n ? await fetchMetadataJson(remoteUrl, options.timeoutMs, ctx[MARK_METADATA_DEGRADED])\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 = (options.dynamicResolvers ?? []).map(resolver => ({\n ...compileSeoPattern(resolver.pattern, true),\n resolver,\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 fetchMetadataJson(remoteUrl, options.timeoutMs, ctx[MARK_METADATA_DEGRADED])\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 ctx[MARK_METADATA_DEGRADED]?.();\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 createAdminSeoEntry(\n seo: NonNullable<DefineAdminSiteHooksOptions['seo']>,\n runtimeSeo: Partial<RuntimeSeoConfig>\n): SeoLocalEntry {\n return {\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\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 '/*': createAdminSeoEntry(seo, runtimeSeo),\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 // A dynamic SEO table on its own does not opt a plain server entry into the admin i18n\n // loader or wrap its beforeRequest callback.\n const runtimeSeo = runtime.seo;\n const runtimeSeoHook =\n !hasUserContentHooks && runtimeSeo?.dynamicResolvers?.length\n ? createSiteHooks(\n { intl: runtime.i18n, seo: { '/*': createAdminSeoEntry({}, runtimeSeo) } },\n runtime\n ).loadSeoMeta\n : undefined;\n return {\n ...hooks,\n siteBaseUrl,\n apiBaseUrl,\n ...(runtimeSeoHook && { loadSeoMeta: runtimeSeoHook }),\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 metadataContext = (markDegraded?: () => void): SiteRuntimeContext => ({\n ...runtimeCtx,\n [MARK_METADATA_DEGRADED]: markDegraded,\n });\n const fetchJson = (path: string, markDegraded?: () => void) =>\n api ? fetchMetadataJson(api + path, null, markDegraded) : Promise.resolve(null);\n\n // ─── i18n 缓存(一次创建,请求级复用)──────────────\n const runtimeLocale = runtime.i18n;\n const rememberLocale = runtimeLocale?.prefixDefault && runtimeLocale.rememberLocale;\n const intlCfg = rememberLocale\n ? { ...config.intl, ...resolveI18nConfig(runtimeLocale) }\n : (config.intl ?? {});\n const supportedLocales = intlCfg.locales?.length ? intlCfg.locales : undefined;\n const negotiationConfig = supportedLocales\n ? resolveI18nConfig(intlCfg)\n : { locales: ['zh-CN', 'en'], defaultLocale: intlCfg.defaultLocale ?? 'zh-CN' };\n // 默认 detect 优先级(业界标准 i18n 顺序):\n // 1. URL pathname 前缀 /en-US/... → 'en-US' ← 显式路由意图,最高优先级\n // 2. engine locale preference on the unprefixed root / legacy 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 if (cleanPath === '/' && rememberLocale && runtimeLocale) {\n const preference = readLocalePreference(req, runtimeLocale);\n if (preference) return preference;\n }\n } catch {\n // 非法 URL(极少见,比如内部调用喂了相对路径)→ 继续后续策略\n }\n }\n // 2. cookie\n const localeCookie = readCookie(req, 'locale');\n if (localeCookie) {\n const matchedCookie = supportedLocales\n ? matchConfiguredLocale(localeCookie, supportedLocales)\n : localeCookie;\n if (matchedCookie) return matchedCookie;\n }\n // 3. Accept-Language → 4. fallbackLocale\n return negotiateLocale(req.headers.get('accept-language'), negotiationConfig);\n });\n\n const intlLoader = createCachedFetcher<string, IntlPayload>({\n key: locale => `intl:${locale}`,\n ttl: intlCfg.ttl ?? 60_000,\n swr: true,\n onDegraded: markUncacheable,\n fetch: async (locale, markDegraded) => {\n if (intlCfg.load) {\n const r = await intlCfg.load(locale, metadataContext(markDegraded));\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, markDegraded);\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 seoCaches: Array<\n ReturnType<typeof createCachedFetcher<SeoRouteRequest, PageSeoMeta | null>>\n > = [];\n const seoLocaleConfig = supportedLocales ? resolveI18nConfig(intlCfg) : undefined;\n const seoPath = (pathname: string) =>\n seoLocaleConfig ? parseLocale(pathname, seoLocaleConfig).pathname : pathname;\n\n for (const [pattern, value] of Object.entries(config.seo ?? {})) {\n const { re, paramNames } = compileSeoPattern(pattern);\n\n if (typeof value === 'function') {\n // 自定义 resolver\n const resolve = value as (\n params: Record<string, string>\n ) => PageSeoMeta | null | Promise<PageSeoMeta | null>;\n seoRoutes.push({ re, paramNames, resolver: ({ params }) => resolve(params) });\n continue;\n }\n if ('endpoint' in value && typeof (value as SeoRemoteEntry).endpoint === 'string') {\n const remote = value as SeoRemoteEntry;\n const cache = createCachedFetcher<SeoRouteRequest, PageSeoMeta | null>({\n key: request => JSON.stringify(request),\n ttl: remote.ttl ?? 300_000,\n onDegraded: markUncacheable,\n fetch: async ({ params }, markDegraded) => {\n const data = await fetchJson(fillTemplate(remote.endpoint, params), markDegraded);\n if (data === null) return null;\n return remote.transform(data, { ...params });\n },\n fallback: () => null,\n });\n seoCaches.push(cache);\n seoRoutes.push({ re, paramNames, resolver: cache });\n continue;\n }\n if ('load' in value && typeof (value as SeoLocalEntry).load === 'function') {\n const local = value as SeoLocalEntry;\n const cache = createCachedFetcher<SeoRouteRequest, PageSeoMeta | null>({\n key: request => JSON.stringify(request),\n ttl: local.ttl ?? 300_000,\n onDegraded: markUncacheable,\n fetch: async ({ params }, markDegraded) =>\n local.load({ ...params }, metadataContext(markDegraded)),\n fallback: () => null,\n });\n seoCaches.push(cache);\n seoRoutes.push({ re, paramNames, resolver: cache });\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: rememberLocale ? intlCfg : 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 // SEO 表是按\"业务规范路径\"('/' / '/books' / '/about')入库的,\n // 不带 locale 前缀。请求 URL 是带前缀的('/en-US/'、'/zh-CN/books'),\n // 直接喂给 admin 查不到。先用 parseLocale 把 locale 段剥掉,\n // 再去 seoRoutes 里匹配 + 调 admin endpoint。\n // locale 单独传给 resolver,支持 endpoint 模板里的 {locale}。\n const pathForRouting = url.pathname.endsWith(RSC_URL_POSTFIX)\n ? url.pathname.slice(0, -RSC_URL_POSTFIX.length) || '/'\n : url.pathname;\n const cleanPath = seoPath(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({ pathname: cleanPath, locale, params });\n }\n }\n return null;\n },\n onError,\n };\n const invalidate: Parameters<typeof registerContentInvalidator>[0] = scopes => {\n const locales = new Set(scopes.locales);\n if (scopes.allPageMetadata || locales.size) {\n intlLoader.invalidate(\n locale => !!scopes.allPageMetadata || locales.has(locale.toLowerCase())\n );\n }\n if (scopes.allPageMetadata || scopes.tags.length) {\n for (const cache of seoCaches) cache.invalidate();\n return;\n }\n if (!scopes.paths.length && !locales.size) return;\n const paths = new Set(\n scopes.paths.map(pathname => trimTrailingSlashes(seoPath(contentPathname(pathname))))\n );\n for (const cache of seoCaches) {\n cache.invalidate(\n ({ pathname, locale }) =>\n paths.has(trimTrailingSlashes(pathname)) || locales.has(locale.toLowerCase())\n );\n }\n };\n // Keep the weak listener alive when the runtime copies these hooks into a server entry.\n Object.defineProperty(output.loadIntl, CONTENT_INVALIDATOR, { value: invalidate });\n Object.defineProperty(output.loadSeoMeta, CONTENT_INVALIDATOR, { value: invalidate });\n registerContentInvalidator(invalidate, { weak: true });\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 matchConfiguredLocale(\n value: string,\n supportedLocales: readonly string[]\n): string | undefined {\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 return supportedLocales.find(locale => locale.toLowerCase().split('-')[0] === prefix);\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 fetchMetadataJson(\n url: string,\n timeoutMs: number | null = 1200,\n markDegraded?: () => void\n): Promise<unknown> {\n try {\n const response =\n timeoutMs === null\n ? await fetch(url)\n : await fetch(url, {\n headers: { Accept: 'application/json' },\n signal: timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined,\n });\n if (!response.ok) {\n if (response.status !== 404) markDegraded?.();\n void response.body?.cancel().catch(() => undefined);\n return null;\n }\n if (response.status === 204) return null;\n return await response.json();\n } catch {\n markDegraded?.();\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,IAAM,sBAAsB,OAAO,oBAAoB;AACvD,IAAM,yBAAyB,OAAO,sBAAsB;AAe5D,SAAS,2BAA8C;CACrD,OAAO;EACL,MAAM,KAAA;EACN,UAAU;GAAE,KAAK,KAAA;GAAW,WAAW,KAAA;EAAU;EACjD,OAAO,KAAA;EACP,aAAa,CAAC;EACd,MAAM,KAAA;EACN,KAAK,KAAA;EACL,WAAW;CACb;AACF;AAoLA,SAAS,wBAAwB,SAAyB;CACxD,OAAO,QAAQ,QAAQ,uBAAuB,MAAM;AACtD;;AAGA,SAAS,kBAAkB,SAAiB,kBAAkB,OAA2B;CACvF,MAAM,aAAuB,CAAC;CAC9B,MAAM,WAAW,QAAQ,SAAS,IAAI;CACtC,MAAM,OAAO,WAAW,QAAQ,MAAM,GAAG,EAAE,IAAI;CAC/C,IAAI,SAAS;CACb,IAAI,SAAS;CACb,KAAK,MAAM,SAAS,KAAK,SAAS,SAAS,GAAG;EAC5C,UAAU,wBAAwB,KAAK,MAAM,QAAQ,MAAM,KAAK,CAAC,IAAI;EACrE,WAAW,KAAK,MAAM,EAAE;EACxB,SAAS,MAAM,QAAQ,MAAM,EAAE,CAAC;CAClC;CACA,UAAU,wBAAwB,KAAK,MAAM,MAAM,CAAC;CAEpD,IAAI,UAAU;EACZ,IAAI,iBAAiB,WAAW,KAAK,UAAU;EAC/C,UAAU,kBAAkB,eAAe;CAC7C;CACA,OAAO;EAAE,IAAI,IAAI,OAAO,IAAI,OAAO,EAAE;EAAG;CAAW;AACrD;AAEA,SAAS,aAAa,UAAkB,MAAsC;CAC5E,OAAO,SAAS,QAAQ,eAAe,GAAG,MAAM,mBAAmB,KAAK,MAAM,EAAE,CAAC;AACnF;AAEA,SAAgB,sBACd,UAAwC,CAAC,GACR;CACjC,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,mBAAmB,QAAQ,oBAAoB,CAAC;CACtD,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,mBAAmB,OAAO,KAAK,gBAAgB;CAErD,OAAO,OAAO,QAAQ,QAAQ;EAC5B,MAAM,mBACJ,iBAAiB,UAAU,gBACtB,sBAAsB,QAAQ,gBAAgB,KAAK,gBACpD;EACN,MAAM,YAAY,gBAAgB,UAAU,EAAE,QAAQ,iBAAiB,GAAG,GAAG;EAI7E,MAAM,iBAAiB,0BAHR,YACX,MAAM,kBAAkB,WAAW,QAAQ,WAAW,IAAI,uBAAuB,IACjF,IACmD;EACvD,MAAM,gBACJ,iBAAiB,sBAChB,gBAAgB,iBAAiB,iBAAiB,KAAA,MACnD,CAAC;EAGH,OAAO;GACL,QAAQ;GACR,UAJe,kBAAkB,kBAAkB,aAAa;GAKhE,WAAW,MAAM,gBAAgB;GACjC,QAAQ,iBACH,QAAQ,gBAAgB,WACxB,QAAQ,kBAAkB;EACjC;CACF;AACF;AAEA,SAAgB,qBACd,UAAuC,CAAC,GACjB;CACvB,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,kBAAkB,QAAQ,mBAAmB,CAAC;CAEpD,MAAM,qBAAqB,QAAQ,oBAAoB,CAAC,EAAA,CAAG,KAAI,cAAa;EAC1E,GAAG,kBAAkB,SAAS,SAAS,IAAI;EAC3C;CACF,EAAE;CAEF,OAAO,OAAO,QAAQ,QAAQ;EAC5B,MAAM,WAAW,kBAAkB,OAAO,YAAY,GAAG;EAGzD,MAAM,YAAY,gBAAgB,UAAU;GAAE,GAAG;GAAQ;EAAS,GAAG,GAAG;EAIxE,MAAM,aAAa,qBAHJ,YACX,MAAM,kBAAkB,WAAW,QAAQ,WAAW,IAAI,uBAAuB,IACjF,IAC0C;EAC9C,IAAI,YAAY,OAAO;EAGvB,IAAI,kBAAkB,SAAS,GAC7B,KAAK,MAAM,YAAY,mBAAmB;GACxC,MAAM,IAAI,SAAS,MAAM,SAAS,EAAE;GACpC,IAAI,CAAC,GAAG;GACR,MAAM,iBAAyC,CAAC;GAChD,SAAS,WAAW,SAAS,MAAM,MAAM;IACvC,eAAe,QAAQ,EAAE,IAAI,MAAM;GACrC,CAAC;GACD,IAAI;IACF,MAAM,SAAS,MAAM,SAAS,SAAS,QAAQ;KAC7C;KACA,QAAQ;KACR,QAAQ,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS,KAAA;KAC5D,UAAU,IAAI;IAChB,CAAC;IACD,IAAI,QAAQ,OAAO;GACrB,SAAS,KAAK;IACZ,IAAI,uBAAuB,GAAG;IAE9B,QAAQ,KAAK,6DAA6D,GAAG;GAC/E;EAGF;EAIF,MAAM,WAAW,gBAAgB,MAAK,UAAS,kBAAkB,MAAM,IAAI,MAAM,QAAQ;EACzF,IAAI,CAAC,UAAU,OAAO;EACtB,MAAM,OAAO,EAAE,GAAG,SAAS;EAC3B,OAAO,KAAK;EACZ,OAAO,KAAK;EACZ,OAAO;CACT;AACF;AAEA,SAAgB,qBAAqB,UAAuC,CAAC,GAAsB;CACjG,OAAO,qBAAqB,SAAS,yBAAyB,CAAC;AACjE;AAEA,SAAS,oBACP,KACA,YACe;CACf,OAAO;EACL,MAAM,qBAAqB;GACzB,UAAU,IAAI,YAAY,WAAW;GACrC,iBAAiB,iCACf,IAAI,iBAAiB,WAAW,aAClC;GACA,WAAW,IAAI,aAAa,WAAW;GACvC,kBAAkB,IAAI,oBAAoB,WAAW;EACvD,CAAC;EACD,KAAK,IAAI,OAAO,WAAW,OAAO;CACpC;AACF;AAEA,SAAS,qBACP,SACA,SACmB;CACnB,MAAM,cAA0C,QAAQ,QAAQ,CAAC;CACjE,MAAM,aAAwC,QAAQ,OAAO,CAAC;CAC9D,MAAM,OAAO,QAAQ,QAAQ,CAAC;CAC9B,MAAM,MAAM,QAAQ,OAAO,CAAC;CAC5B,MAAM,mBAAmB,KAAK,iBAAiB,YAAY,iBAAiB,CAAC;CAC7E,MAAM,UACJ,KAAK,WACL,YAAY,YACX,OAAO,KAAK,gBAAgB,CAAC,CAAC,SAAS,IAAI,OAAO,KAAK,gBAAgB,IAAI,CAAC,IAAI;CACnF,MAAM,gBAAgB,KAAK,iBAAiB,YAAY,iBAAiB,QAAQ,MAAM;CAEvF,MAAM,SAAS,gBACb;EACE,eAAe,QAAQ;EACvB,SAAS,QAAQ;EACjB,YAAY,QAAQ;EACpB,MAAM;GACJ;GACA;GACA,eAAe,KAAK,iBAAiB,YAAY;GACjD,QAAQ,KAAK;GACb,MAAM,sBAAsB;IAC1B,UAAU,KAAK,YAAY,YAAY;IACvC;IACA;IACA,WAAW,KAAK,aAAa,YAAY;IACzC,cAAc,KAAK,gBAAgB,YAAY;IAC/C,gBAAgB,KAAK,kBAAkB,YAAY;GACrD,CAAC;GACD,KAAK,KAAK,OAAO,YAAY,OAAO;EACtC;EACA,KAAK,EACH,MAAM,oBAAoB,KAAK,UAAU,EAC3C;CACF,GACA,OACF;CACA,OAAO,eAAe,QAAQ,sBAAsB;EAClD,YAAY;EACZ,cAAc;EACd,QAAQ,gBAAmC,qBAAqB,SAAS,WAAW;CACtF,CAAC;CACD,OAAO;AACT;AA4BA,SAAgB,gBAAgB,QAA4C;CAC1E,OAAO,gBAAgB,QAAQ,yBAAyB,CAAC;AAC3D;AAEA,SAAgB,0BACd,OACA,SACG;CACH,MAAM,oBAAoB;CAG1B,IAAI,OAAO,kBAAkB,uBAAuB,YAClD,OAAO,kBAAkB,mBAAmB,OAAO;CAErD,MAAM,YAAY;CASlB,MAAM,WAAW,uBAAuB,OAAO;CAC/C,MAAM,cAAc,UAAU,eAAe,QAAQ;CACrD,MAAM,aAAa,UAAU,cAAc,SAAS;CACpD,MAAM,sBACJ,CAAC,CAAC,UAAU,QACZ,OAAO,UAAU,aAAa,cAC9B,OAAO,UAAU,gBAAgB;CAEnC,IAAI,CAAC,uBAAuB,wBAAwB,OAAO,GAAG;EAC5D,MAAM,eAAe,qBACnB;GACE,eAAe,UAAU;GACzB,SAAS,UAAU;EACrB,GACA,OACF;EACA,OAAO;GACL,GAAG;GACH;GACA;GACA,MAAM,aAAa;GACnB,eAAe,aAAa;GAC5B,UAAU,aAAa;GACvB,aAAa,aAAa;GAC1B,SAAS,aAAa;EACxB;CACF;CAIA,MAAM,aAAa,QAAQ;CAC3B,MAAM,iBACJ,CAAC,uBAAuB,YAAY,kBAAkB,SAClD,gBACE;EAAE,MAAM,QAAQ;EAAM,KAAK,EAAE,MAAM,oBAAoB,CAAC,GAAG,UAAU,EAAE;CAAE,GACzE,OACF,CAAC,CAAC,cACF,KAAA;CACN,OAAO;EACL,GAAG;EACH;EACA;EACA,GAAI,kBAAkB,EAAE,aAAa,eAAe;CACtD;AACF;AAEA,SAAS,gBAAgB,QAAyB,SAA+C;CAC/F,MAAM,WAAW,uBAAuB,OAAO;CAC/C,MAAM,MAAM,SAAS,OAAO;CAC5B,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,aAAiC;EACrC;EACA;EACA,WAAW,SAAS;EACpB,MAAM,QAAQ,KAAA;CAChB;CACA,MAAM,mBAAmB,kBAAmD;EAC1E,GAAG;GACF,yBAAyB;CAC5B;CACA,MAAM,aAAa,MAAc,iBAC/B,MAAM,kBAAkB,MAAM,MAAM,MAAM,YAAY,IAAI,QAAQ,QAAQ,IAAI;CAGhF,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,iBAAiB,eAAe,iBAAiB,cAAc;CACrE,MAAM,UAAU,iBACZ;EAAE,GAAG,OAAO;EAAM,GAAG,kBAAkB,aAAa;CAAE,IACrD,OAAO,QAAQ,CAAC;CACrB,MAAM,mBAAmB,QAAQ,SAAS,SAAS,QAAQ,UAAU,KAAA;CACrE,MAAM,oBAAoB,mBACtB,kBAAkB,OAAO,IACzB;EAAE,SAAS,CAAC,SAAS,IAAI;EAAG,eAAe,QAAQ,iBAAiB;CAAQ;CAWhF,MAAM,eACJ,QAAQ,YACN,QAAyB;EAEzB,IAAI,kBACF,IAAI;GACF,MAAM,WAAW,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;GAKlC,MAAM,YAAY,SAAS,SAAS,OAAO,IACvC,SAAS,MAAM,GAAG,EAAe,KAAK,MACtC;GACJ,MAAM,QAAQ,UAAU,MAAM,GAAG,CAAC,CAAC;GACnC,IAAI,SAAS,iBAAiB,SAAS,KAAK,GAAG,OAAO;GACtD,IAAI,cAAc,OAAO,kBAAkB,eAAe;IACxD,MAAM,aAAa,qBAAqB,KAAK,aAAa;IAC1D,IAAI,YAAY,OAAO;GACzB;EACF,QAAQ,CAER;EAGF,MAAM,eAAe,WAAW,KAAK,QAAQ;EAC7C,IAAI,cAAc;GAChB,MAAM,gBAAgB,mBAClB,sBAAsB,cAAc,gBAAgB,IACpD;GACJ,IAAI,eAAe,OAAO;EAC5B;EAEA,OAAO,gBAAgB,IAAI,QAAQ,IAAI,iBAAiB,GAAG,iBAAiB;CAC9E;CAEF,MAAM,aAAa,oBAAyC;EAC1D,MAAK,WAAU,QAAQ;EACvB,KAAK,QAAQ,OAAO;EACpB,KAAK;EACL,YAAY;EACZ,OAAO,OAAO,QAAQ,iBAAiB;GACrC,IAAI,QAAQ,MAEV,OAAO,MADS,QAAQ,KAAK,QAAQ,gBAAgB,YAAY,CAAC,KACtD;IAAE;IAAQ,UAAU,CAAC;IAAG,WAAW,MAAM,MAAM;GAAE;GAE/D,IAAI,QAAQ,UAAU;IACpB,MAAM,MAAM,aAAa,QAAQ,UAAU,EAAE,OAAO,CAAC;IACrD,MAAM,OAAO,MAAM,UAAU,KAAK,YAAY;IAC9C,IAAI,SAAS,QAAQ,QAAQ,WAAW;KACtC,MAAM,cAAc,MAAM,QAAQ,UAAU,MAAM,MAAM;KACxD,IAAI,aACF,OAAO;MACL,GAAG;MACH,WAAW,YAAY,aAAa,MAAM,YAAY,MAAM;KAC9D;IAEJ;IACA,OAAO;KACL;KACA,UAAU,oBAAoB,IAAI;KAClC,WAAW,MAAM,MAAM;IACzB;GACF;GACA,OAAO;IAAE;IAAQ,UAAU,CAAC;IAAG,WAAW,MAAM,MAAM;GAAE;EAC1D;EACA,WAAU,YAAW;GAAE;GAAQ,UAAU,CAAC;GAAG,WAAW,MAAM,MAAM;EAAE;CACxE,CAAC;CAGD,MAAM,YAA6B,CAAC;CACpC,MAAM,YAEF,CAAC;CACL,MAAM,kBAAkB,mBAAmB,kBAAkB,OAAO,IAAI,KAAA;CACxE,MAAM,WAAW,aACf,kBAAkB,YAAY,UAAU,eAAe,CAAC,CAAC,WAAW;CAEtE,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,GAAG;EAC/D,MAAM,EAAE,IAAI,eAAe,kBAAkB,OAAO;EAEpD,IAAI,OAAO,UAAU,YAAY;GAE/B,MAAM,UAAU;GAGhB,UAAU,KAAK;IAAE;IAAI;IAAY,WAAW,EAAE,aAAa,QAAQ,MAAM;GAAE,CAAC;GAC5E;EACF;EACA,IAAI,cAAc,SAAS,OAAQ,MAAyB,aAAa,UAAU;GACjF,MAAM,SAAS;GACf,MAAM,QAAQ,oBAAyD;IACrE,MAAK,YAAW,KAAK,UAAU,OAAO;IACtC,KAAK,OAAO,OAAO;IACnB,YAAY;IACZ,OAAO,OAAO,EAAE,UAAU,iBAAiB;KACzC,MAAM,OAAO,MAAM,UAAU,aAAa,OAAO,UAAU,MAAM,GAAG,YAAY;KAChF,IAAI,SAAS,MAAM,OAAO;KAC1B,OAAO,OAAO,UAAU,MAAM,EAAE,GAAG,OAAO,CAAC;IAC7C;IACA,gBAAgB;GAClB,CAAC;GACD,UAAU,KAAK,KAAK;GACpB,UAAU,KAAK;IAAE;IAAI;IAAY,UAAU;GAAM,CAAC;GAClD;EACF;EACA,IAAI,UAAU,SAAS,OAAQ,MAAwB,SAAS,YAAY;GAC1E,MAAM,QAAQ;GACd,MAAM,QAAQ,oBAAyD;IACrE,MAAK,YAAW,KAAK,UAAU,OAAO;IACtC,KAAK,MAAM,OAAO;IAClB,YAAY;IACZ,OAAO,OAAO,EAAE,UAAU,iBACxB,MAAM,KAAK,EAAE,GAAG,OAAO,GAAG,gBAAgB,YAAY,CAAC;IACzD,gBAAgB;GAClB,CAAC;GACD,UAAU,KAAK,KAAK;GACpB,UAAU,KAAK;IAAE;IAAI;IAAY,UAAU;GAAM,CAAC;GAClD;EACF;EAEA,MAAM,aAAa;EACnB,MAAM,eAA4B;GAChC,GAAG;GACH,WACE,WAAW,cACV,QAAQ,WAAW,YAAY,OAAO,GAAG,OAAO,YAAY,WAAW;EAC5E;EACA,UAAU,KAAK;GAAE;GAAI;GAAY,gBAAgB;EAAa,CAAC;CACjE;CAGA,MAAM,kBAAkB,sBAAsB,SAAS,UAAU;CACjE,MAAM,UAAwC,OAAO,KAAK,KAAK,QAAQ;EACrE,gBAAgB,KAAK,KAAK,GAAG;EAC7B,IAAI,OAAO,SACT,MAAM,OAAO,QAAQ,KAAK,KAAK,GAAG;CAEtC;CAEA,MAAM,SAA4B;EAChC,aAAa,QAAQ,KAAA;EACrB,YAAY,OAAO,KAAA;EACnB,MAAM,iBAAiB,UAAU,OAAO;EACxC,YAAY,OAAO;EACnB,MAAM,cAAc,KAAK,YAAY;GAGnC,OAAO;IAAE,QAFM,aAAa,GAEnB;IAAQ,GADD,OAAO,gBAAgB,MAAM,OAAO,cAAc,GAAG,IAAI,CAAC;GAC9C;EAC9B;EACA,MAAM,SAAS,KAAK;GAClB,OAAO,WAAW,aAAa,GAAG,CAAC;EACrC;EACA,MAAM,YAAY,KAAK;GACrB,MAAM,MAAM,IAAI,IAAI,IAAI,GAAG;GAC3B,MAAM,SAAS,aAAa,GAAG;GAS/B,MAAM,iBAAiB,IAAI,SAAS,SAAA,OAAwB,IACxD,IAAI,SAAS,MAAM,GAAG,EAAuB,KAAK,MAClD,IAAI;GACR,MAAM,YAAY,QAAQ,cAAc;GAExC,KAAK,MAAM,EAAE,IAAI,YAAY,cAAc,WAAW;IACpD,MAAM,IAAI,UAAU,MAAM,EAAE;IAC5B,IAAI,GAAG;KACL,MAAM,SAAiC;MACrC,UAAU;MACV;KACF;KACA,WAAW,SAAS,GAAG,MAAO,OAAO,KAAK,EAAE,IAAI,MAAM,EAAG;KACzD,OAAO,MAAM,SAAS;MAAE,UAAU;MAAW;MAAQ;KAAO,CAAC;IAC/D;GACF;GACA,OAAO;EACT;EACA;CACF;CACA,MAAM,cAA+D,WAAU;EAC7E,MAAM,UAAU,IAAI,IAAI,OAAO,OAAO;EACtC,IAAI,OAAO,mBAAmB,QAAQ,MACpC,WAAW,YACT,WAAU,CAAC,CAAC,OAAO,mBAAmB,QAAQ,IAAI,OAAO,YAAY,CAAC,CACxE;EAEF,IAAI,OAAO,mBAAmB,OAAO,KAAK,QAAQ;GAChD,KAAK,MAAM,SAAS,WAAW,MAAM,WAAW;GAChD;EACF;EACA,IAAI,CAAC,OAAO,MAAM,UAAU,CAAC,QAAQ,MAAM;EAC3C,MAAM,QAAQ,IAAI,IAChB,OAAO,MAAM,KAAI,aAAY,oBAAoB,QAAQ,gBAAgB,QAAQ,CAAC,CAAC,CAAC,CACtF;EACA,KAAK,MAAM,SAAS,WAClB,MAAM,YACH,EAAE,UAAU,aACX,MAAM,IAAI,oBAAoB,QAAQ,CAAC,KAAK,QAAQ,IAAI,OAAO,YAAY,CAAC,CAChF;CAEJ;CAEA,OAAO,eAAe,OAAO,UAAU,qBAAqB,EAAE,OAAO,WAAW,CAAC;CACjF,OAAO,eAAe,OAAO,aAAa,qBAAqB,EAAE,OAAO,WAAW,CAAC;CACpF,2BAA2B,YAAY,EAAE,MAAM,KAAK,CAAC;CACrD,OAAO,eAAe,QAAQ,sBAAsB;EAClD,YAAY;EACZ,cAAc;EACd,QAAQ,gBAAmC,gBAAgB,QAAQ,WAAW;CAChF,CAAC;CACD,OAAO;AACT;AAEA,SAAS,MAAM,QAA+B;CAC5C,OAAO,iBAAiB,KAAK,MAAM,IAAI,QAAQ;AACjD;AAEA,SAAS,sBACP,OACA,kBACoB;CACpB,MAAM,QAAQ,MAAM,YAAY;CAChC,MAAM,QAAQ,iBAAiB,MAAK,WAAU,OAAO,YAAY,MAAM,KAAK;CAC5E,IAAI,OAAO,OAAO;CAClB,MAAM,SAAS,MAAM,MAAM,GAAG,CAAC,CAAC;CAChC,OAAO,iBAAiB,MAAK,WAAU,OAAO,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,MAAM;AACtF;AAEA,SAAS,oBAAoB,MAAwC;CACnE,OAAO,0BAA0B,IAAI,KAAK,CAAC;AAC7C;AAEA,SAAS,0BAA0B,MAA+C;CAChF,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU,OAAO;CAC9C,MAAM,MAAM;CACZ,MAAM,YAAY,IAAI;CACtB,MAAM,YACJ,IAAI,WACJ,IAAI,aACH,SAAS,SAAS,KAAK,aAAa,YAAY,UAAU,UAAU;CACvE,IAAI,CAAC,aAAa,OAAO,cAAc,UAAU,OAAO;CACxD,OAAO,kBAAkB,SAAoC;AAC/D;AAEA,SAAS,kBAAkB,UAA4D;CACrF,IAAI,aAAa,QAAQ,GACvB,OAAO,mBAAmB,QAAQ;CAEpC,OAAO;AACT;;;;;;;;;;;AAYA,SAAS,qBAAqB,MAAmC;CAC/D,IAAI,YAAqB;CACzB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,IAAI,CAAC,SAAS,SAAS,GAAG,OAAO;EACjC,IAAI,WAAW,aAAa,iBAAiB,WAAW;EACxD,IAAI,UAAU,WAAW;GACvB,YAAY,UAAU;GACtB;EACF;EACA,OAAO;CACT;CACA,IAAI,CAAC,SAAS,SAAS,GAAG,OAAO;CACjC,OAAO;AACT;AAEA,SAAS,iCACP,UAA8C,CAAC,GACb;CAClC,OAAO,QAAQ,QACb,UAAS,OAAO,MAAM,SAAS,QACjC;AACF;AAEA,SAAS,sBACP,SACA,KAC2C;CAC3C,MAAM,oBAAoB,kCAAkC,SAAS,GAAG;CAExE,QAAQ,KAAK,KAAK,aAAa;EAC7B,QAAQ,MAAM,aAAa;GACzB,SAAS,SAAS;GAClB,QAAQ,SAAS;GACjB,KAAK,IAAI;GACT,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;EACtD,CAAC;EACD,oBAAoB,KAAK,KAAK,QAAQ;CACxC;AACF;AAEA,SAAS,kCACP,SACA,KAC+F;CAC/F,MAAM,SAAS,QAAQ;CACvB,IAAI,WAAW,SAAS,CAAC,UAAU,OAAO,WAAW,OAAO,OAAO;CAGnE,MAAM,WAAW,iBADF,OAAO,UAAU,CAAC,EAAA,CACO,YAAY,6BAA6B,CAAC,GAAG,KAAK,EACxF,UAAS,eAAc,WAAW,SAAS,aAAa,WAAW,SAAS,IAC9E,CAAC;CACD,IAAI,CAAC,UAAU,OAAO;CAEtB,MAAM,MAAM,OAAO,OAAO;CAC1B,MAAM,UAAU,OAAO;CACvB,MAAM,cAAc,OAAO;CAC3B,MAAM,qBAAqB,OAAO,uBAAuB;CAEzD,QAAQ,KAAK,KAAK,aAAa;EAC7B,MAAM,KAAK,qBAAqB;EAChC,IAAI,CAAC,IAAI;EACT,MAAM,SAAS,2BAA2B,KAAK,KAAK,UAAU;GAC5D;GACA;GACA;GACA;EACF,CAAC;EAED,MAAW,UAAU;GACnB,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,QAAQ;GACV;GACA,MAAM,KAAK,UAAU;IACnB;IACA,QAAQ,KAAK,IAAI;IACjB,SAAS,CAAC,MAAM;GAClB,CAAC;GACD,QAAQ,OAAO,gBAAgB,cAAc,YAAY,QAAQ,GAAI,IAAI,KAAA;EAC3E,CAAC,CAAC,CAAC,YAAY,CAEf,CAAC;CACH;AACF;AAEA,SAAS,2BACP,KACA,KACA,KACA,SAMyB;CACzB,MAAM,QAAQ,eAAe,QAAQ,MAAM;CAC3C,MAAM,UAAU,OAAO,WAAW,OAAO,GAAG;CAC5C,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,MAAM,gBAAgB,IAAI,KAAK,QAAQ,kBAAkB;CAE/D,OAAO;EACL,IAAI,QAAQ;EACZ,IAAI,KAAK,IAAI;EACb,OAAO;EACP;EACA;EACA,OAAO,OAAO;EACd,SAAS,QAAQ;EACjB,aAAa,QAAQ;EACrB;EACA,QAAQ;EACR,MAAM;GACJ,SAAS,IAAI;GACb,QAAQ,IAAI;EACd;EACA,OAAO;GACL,QAAQ,IAAI;GACZ,UAAU,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM;EACjC;EACA,aAAa;GAAC;GAAiB;GAAM,QAAQ,MAAM,GAAG,GAAG;EAAC;CAC5D;AACF;AAEA,SAAS,gBAAgB,QAAgB,oBAAsC;CAC7E,IAAI;EACF,MAAM,MAAM,IAAI,IAAI,MAAM;EAC1B,OAAO,qBAAqB,GAAG,IAAI,WAAW,IAAI,WAAW,IAAI;CACnE,QAAQ;EACN,OAAO,qBAAqB,SAAS;CACvC;AACF;AAEA,SAAS,uBAAsC;CAC7C,IAAI;EACF,OAAO,OAAO,OAAO,WAAW;CAClC,QAAQ;EAEN,OAAO;CACT;AACF;AAEA,eAAe,kBACb,KACA,YAA2B,MAC3B,cACkB;CAClB,IAAI;EACF,MAAM,WACJ,cAAc,OACV,MAAM,MAAM,GAAG,IACf,MAAM,MAAM,KAAK;GACf,SAAS,EAAE,QAAQ,mBAAmB;GACtC,QAAQ,YAAY,IAAI,YAAY,QAAQ,SAAS,IAAI,KAAA;EAC3D,CAAC;EACP,IAAI,CAAC,SAAS,IAAI;GAChB,IAAI,SAAS,WAAW,KAAK,eAAe;GAC5C,SAAc,MAAM,OAAO,CAAC,CAAC,YAAY,KAAA,CAAS;GAClD,OAAO;EACT;EACA,IAAI,SAAS,WAAW,KAAK,OAAO;EACpC,OAAO,MAAM,SAAS,KAAK;CAC7B,QAAQ;EACN,eAAe;EACf,OAAO;CACT;AACF;AAEA,SAAS,gBACP,UACA,MACA,KACA,UAA4C,CAAC,GAC9B;CACf,MAAM,SAAS,aAAa,UAAU,IAAI;CAC1C,IAAI,mBAAmB,KAAK,MAAM,GAAG,OAAO;CAC5C,MAAM,OAAO,0BAA0B,KAAK,QAAQ,OAAO;CAC3D,IAAI,CAAC,MAAM,OAAO;CAClB,OAAO,GAAG,oBAAoB,IAAI,EAAE,GAAG,OAAO,QAAQ,QAAQ,EAAE;AAClE;AAEA,SAAS,0BACP,KACA,SACe;CACf,IAAI,OAAO,YAAY,YACrB,OAAO,QAAQ,GAAG,KAAK;CAEzB,IAAI,SAAS,OAAO;CACpB,OAAO,IAAI,SAAS,OAAO;AAC7B;AAEA,SAAS,uBAAuB,SAA6C;CAC3E,MAAM,WAAW,QAAQ,YAAY,CAAC;CACtC,MAAM,MAAM,SAAS;CACrB,OAAO;EACL;EACA,WAAW,SAAS,aAAa;CACnC;AACF;AAEA,SAAS,wBAAwB,SAAqC;CACpE,OAAO,CAAC,EACN,QAAQ,MAAM,YACd,QAAQ,MAAM,iBACd,QAAQ,KAAK,YACb,QAAQ,KAAK,iBACb,QAAQ;AAEZ;AAEA,SAAS,kBAAkB,UAA0B;CACnD,IAAI,aAAa,KAAK,OAAO;CAC7B,OAAO,oBAAoB,QAAQ,KAAK;AAC1C;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AACrE;AAEA,SAAS,aAAa,OAAyB;CAC7C,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU,OAAO;CAChD,OAAO,OAAO,KAAK,KAAgC,CAAC,CAAC,MAAK,QAAO,IAAI,SAAS,GAAG,CAAC;AACpF;AAEA,SAAS,mBAAmB,MAAwD;CAClF,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,GAAG;EAC/C,MAAM,QAAQ,IAAI,MAAM,GAAG;EAC3B,IAAI,MAAM;EACV,MAAM,SAAS,MAAM,UAAU;GAC7B,IAAI,UAAU,MAAM,SAAS,GAAG;IAC9B,IAAI,QAAQ;IACZ;GACF;GACA,MAAM,OAAO,IAAI;GACjB,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU,IAAI,QAAQ,CAAC;GACpD,MAAM,IAAI;EACZ,CAAC;CACH;CACA,OAAO;AACT"}
@@ -1 +1 @@
1
- {"version":3,"file":"locale-links.client.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/locale-links.client.ts"],"names":[],"mappings":"AAwBA,8FAA8F;AAC9F,wBAAgB,kBAAkB;;;EA2DjC"}
1
+ {"version":3,"file":"locale-links.client.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/locale-links.client.ts"],"names":[],"mappings":"AA2BA,8FAA8F;AAC9F,wBAAgB,kBAAkB;;;EAkEjC"}
@@ -0,0 +1,3 @@
1
+ export declare function isRenderCancellation(signal: AbortSignal | undefined, error: unknown): boolean;
2
+ export declare function createRenderErrorHandler(signal: AbortSignal | undefined): (error: unknown) => void;
3
+ //# sourceMappingURL=renderCancellation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"renderCancellation.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/renderCancellation.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAG7F;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,IAC9D,OAAO,OAAO,KAAG,IAAI,CAG9B"}
@@ -1 +1 @@
1
- {"version":3,"file":"ISREngine.d.ts","sourceRoot":"","sources":["../../src/engine/ISREngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAOvE,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAS9E,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAE1B,MAAM,EAAE,SAAS;IAc7B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAKnB,iBAAiB;IAkB/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAiBrC;;OAEG;IACH,eAAe,IAAI,OAAO;IAK1B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAclC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAwBhC"}
1
+ {"version":3,"file":"ISREngine.d.ts","sourceRoot":"","sources":["../../src/engine/ISREngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAOvE,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAS9E,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAE1B,MAAM,EAAE,SAAS;IAc7B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAKnB,iBAAiB;IAkB/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAkBrC;;OAEG;IACH,eAAe,IAAI,OAAO;IAK1B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAalC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAwBhC"}
@@ -7,6 +7,7 @@
7
7
  * - 站点地图生成
8
8
  * - Open Graph / Twitter Cards
9
9
  */
10
+ import type { RuntimeSitemapEntry } from '../../types';
10
11
  import type { SEOConfig, DeepPartial } from './types';
11
12
  export declare class SEOEngine {
12
13
  private static instance;
@@ -35,6 +36,8 @@ export declare class SEOEngine {
35
36
  }>;
36
37
  /** 生成站点地图;lastModifiedByUrl 只接受已知的页面内容更新时间。 */
37
38
  generateSitemap(routes?: readonly string[], lastModifiedByUrl?: ReadonlyMap<string, string>): Promise<string>;
39
+ generatePublishedSitemap(catalog: readonly RuntimeSitemapEntry[]): Promise<string>;
40
+ private renderSitemap;
38
41
  /** 生成 Robots.txt */
39
42
  generateRobotsTxt(): string;
40
43
  /** 清理缓存 */
@@ -1 +1 @@
1
- {"version":3,"file":"SEOEngine.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/SEOEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAe,WAAW,EAAE,MAAM,SAAS,CAAC;AAcnE,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,YAAY,CAAkE;IAEtF,OAAO;IAIP,aAAa;IACb,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,SAAS;IAO9D,kBAAkB;IAClB,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B,WAAW;IACX,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,IAAI;IAKlD,aAAa;IACb,SAAS,IAAI,SAAS;IAItB,UAAU;IACJ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,eAAe;IACT,YAAY,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAC3D,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAcpC,+CAA+C;IACzC,eAAe,CACnB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,EAC1B,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC;IAsClB,oBAAoB;IACpB,iBAAiB,IAAI,MAAM;IAW3B,WAAW;IACX,UAAU,IAAI,IAAI;IAKlB,WAAW;IACL,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,gBAAgB;CAQzB;AAED,wBAAwB;AACxB,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,SAAS,CAE1E"}
1
+ {"version":3,"file":"SEOEngine.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/SEOEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAe,WAAW,EAAE,MAAM,SAAS,CAAC;AAoBnE,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,YAAY,CAAkE;IAEtF,OAAO;IAIP,aAAa;IACb,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,SAAS;IAO9D,kBAAkB;IAClB,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B,WAAW;IACX,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,IAAI;IAKlD,aAAa;IACb,SAAS,IAAI,SAAS;IAItB,UAAU;IACJ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,eAAe;IACT,YAAY,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAC3D,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAcpC,+CAA+C;IACzC,eAAe,CACnB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,EAC1B,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC;IAkBZ,wBAAwB,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YA+B1E,aAAa;IA8C3B,oBAAoB;IACpB,iBAAiB,IAAI,MAAM;IAW3B,WAAW;IACX,UAAU,IAAI,IAAI;IAKlB,WAAW;IACL,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,gBAAgB;CAQzB;AAED,wBAAwB;AACxB,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,SAAS,CAE1E"}
@@ -1,4 +1,5 @@
1
1
  import type { ISRConfig } from '../../types';
2
+ import { SEOEngine } from './SEOEngine';
2
3
  export interface ResolvedSeoConfig {
3
4
  /** 真实可用的 baseUrl(已解析所有 fallback);prod 未配置时为空串 */
4
5
  baseUrl: string;
@@ -14,4 +15,9 @@ export interface ResolvedSeoConfig {
14
15
  export declare function resolveSeoConfig(config: ISRConfig): ResolvedSeoConfig;
15
16
  /** 取本地 SEO 条目明确声明的内容更新时间,仅用于完全匹配的 sitemap URL。 */
16
17
  export declare function resolveSitemapLastModified(config: ISRConfig): ReadonlyMap<string, string>;
18
+ export declare function resolveSitemapLoader(config: ISRConfig, engine?: SEOEngine): {
19
+ ttl: number;
20
+ staleIfErrorMs: number;
21
+ load: () => Promise<string>;
22
+ } | undefined;
17
23
  //# sourceMappingURL=resolveSeoConfig.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"resolveSeoConfig.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/resolveSeoConfig.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,aAAa,EAAE,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAuBrE;AAED,kDAAkD;AAClD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAQzF"}
1
+ {"version":3,"file":"resolveSeoConfig.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/resolveSeoConfig.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,aAAa,EAAE,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAuBrE;AAED,kDAAkD;AAClD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAQzF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS;;;;cAWzE"}
@@ -179,9 +179,10 @@ function resolveI18nConfig(intl) {
179
179
  return {
180
180
  locales,
181
181
  defaultLocale: intl?.defaultLocale ?? locales[0],
182
- prefixDefault: intl?.prefixDefault
182
+ prefixDefault: intl?.prefixDefault,
183
+ ...intl?.rememberLocale && { rememberLocale: true }
183
184
  };
184
185
  }
185
186
  export { selectAcceptableLocale as a, resolveI18nConfig as i, negotiateLocale as n, withLocale as o, parseLocale as r, trimTrailingSlashes as s, alternates as t };
186
187
 
187
- //# sourceMappingURL=i18n-B2mWmifk.js.map
188
+ //# sourceMappingURL=i18n-BZpAOZeO.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"i18n-B2mWmifk.js","names":[],"sources":["../src/utils/trimTrailingSlashes.ts","../src/runtime/i18n.ts"],"sourcesContent":["/** Remove only the trailing slash run; each character is inspected at most once. */\nexport function trimTrailingSlashes(value: string): string {\n let end = value.length;\n while (end > 0 && value[end - 1] === '/') end--;\n return value.slice(0, end);\n}\n","/**\n * i18n 路由工具 —— URL 前缀自动处理(无 React 依赖,server + client 通用)\n *\n * 业务侧用法:\n *\n * import { parseLocale, withLocale, negotiateLocale } from 'isr-engine/runtime';\n *\n * const I18N = { locales: ['zh', 'en'] as const, defaultLocale: 'zh' };\n *\n * // SSR 入口:从 URL 拆 locale + 干净 pathname 给路由\n * const { locale, pathname } = parseLocale(url.pathname, I18N);\n * return <Layout lang={locale}>{resolveRoute({ pathname, locale })}</Layout>;\n *\n * // Header 切换语言\n * const href = withLocale('/books/1', 'en', I18N); // → '/en/books/1'\n * const href = withLocale('/books/1', 'zh', I18N); // → '/books/1'(默认 locale 不前缀)\n *\n * // 服务器协商:Accept-Language 头 → locale\n * const locale = negotiateLocale(req.headers.get('accept-language'), I18N);\n *\n * 设计取舍:\n * - 默认 locale 不带前缀('/about'),其他 locale 带('/en/about')\n * → 与 Next.js i18n routing 默认 + Vue I18n 一致;SEO 友好(默认语言 URL 简洁)\n * - 用 `prefixDefault: true` 切到\"全部带前缀\"模式(如 '/zh/about')\n * - 不内置消息字典 / 翻译机制 —— 那是 react-intl / FormatJS / lingui 的活\n */\n\nimport { trimTrailingSlashes } from '../utils/trimTrailingSlashes';\nexport interface I18nConfig {\n /** 支持的 locale 列表,如 ['zh', 'en', 'ja'] */\n locales: readonly string[];\n /** 默认 locale —— 必须在 locales 内 */\n defaultLocale: string;\n /** 是否给默认 locale 也加 URL 前缀(默认 false:'/about';true:'/zh/about') */\n prefixDefault?: boolean;\n}\n\nexport interface ParsedLocale {\n /** 解析出的 locale(命中 URL 前缀则取前缀,否则取 defaultLocale) */\n locale: string;\n /** 去掉 locale 前缀后的\"业务 pathname\",路由表只需匹配这个 */\n pathname: string;\n /** URL 是否真的带了 locale 前缀 */\n hasPrefix: boolean;\n}\n\n/**\n * 从 pathname 拆出 locale 与业务 pathname\n *\n * '/zh/books/1' + { locales: ['zh','en'], defaultLocale: 'en' }\n * → { locale: 'zh', pathname: '/books/1', hasPrefix: true }\n *\n * '/books/1' 同上\n * → { locale: 'en', pathname: '/books/1', hasPrefix: false }\n */\nexport function parseLocale(pathname: string, config: I18nConfig): ParsedLocale {\n const segments = pathname.split('/');\n // segments[0] 是空串(leading '/'),segments[1] 才是首段\n const first = segments[1];\n if (first && config.locales.includes(first)) {\n const rest = '/' + segments.slice(2).join('/');\n return {\n locale: first,\n pathname: rest === '/' ? '/' : trimTrailingSlashes(rest),\n hasPrefix: true,\n };\n }\n return { locale: config.defaultLocale, pathname: pathname || '/', hasPrefix: false };\n}\n\n/**\n * 给业务 pathname 套上 locale 前缀(生成可跳转 URL)\n *\n * withLocale('/about', 'en', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/en/about'\n *\n * withLocale('/about', 'zh', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/about' (默认 locale 不前缀)\n *\n * withLocale('/about', 'zh', { ..., prefixDefault: true })\n * → '/zh/about'\n */\nexport function withLocale(pathname: string, locale: string, config: I18nConfig): string {\n if (!config.locales.includes(locale)) {\n throw new Error(`[i18n] unknown locale \"${locale}\"; allowed: ${config.locales.join(', ')}`);\n }\n const clean = pathname.startsWith('/') ? pathname : '/' + pathname;\n if (locale === config.defaultLocale && !config.prefixDefault) return clean;\n return `/${locale}${clean === '/' ? '' : clean}`;\n}\n\n/**\n * 按权重协商 Accept-Language(支持主语言回退和通配符)\n *\n * negotiateLocale('zh-CN,en;q=0.9', { locales: ['zh','en'], defaultLocale: 'en' })\n * → 'zh' ('zh-CN' 命中 'zh')\n *\n * negotiateLocale('en-GB', { locales: ['zh-hans','en-us'], defaultLocale: 'zh-hans' })\n * → 'en-us' ('en-GB' 主语言 'en' 回退到第一个 en-*)\n *\n * negotiateLocale(null, ...) → defaultLocale\n *\n * @throws {RangeError} When the header explicitly rejects every available locale.\n */\nexport function negotiateLocale(\n acceptLanguage: string | null | undefined,\n config: I18nConfig\n): string {\n const locale = selectAcceptableLocale(acceptLanguage, config);\n if (locale !== null) return locale;\n const error = new RangeError('[i18n] no supported locale is acceptable');\n Object.defineProperty(error, NO_ACCEPTABLE_LOCALE, { value: true });\n throw error;\n}\n\n// The server entry and SiteHooks can load separately bundled copies of this module.\nconst NO_ACCEPTABLE_LOCALE = Symbol.for('isr-engine.no-acceptable-locale');\n\nexport function isNoAcceptableLocaleError(error: unknown): boolean {\n return error instanceof RangeError && NO_ACCEPTABLE_LOCALE in error;\n}\n\n/** Returns null when the header explicitly rejects every available locale. */\nexport function selectAcceptableLocale(\n acceptLanguage: string | null | undefined,\n config: I18nConfig\n): string | null {\n if (!acceptLanguage) return config.defaultLocale;\n const ranked = acceptLanguage\n .split(',')\n .flatMap(part => {\n const [rawTag, ...params] = part.split(';');\n const tag = rawTag.trim().toLowerCase();\n const weight = params\n .map(param => param.trim())\n .find(param => /^q=/i.test(param))\n ?.slice(2)\n .trim();\n const q = weight === undefined ? 1 : Number(weight);\n return tag && weight !== '' && q >= 0 && q <= 1 ? [{ tag, q }] : [];\n })\n .sort((a, b) => b.q - a.q);\n\n // Apply the most specific range to each available tag before lookup or fallback.\n const bySpecificity = [...ranked].sort(\n (a, b) => rangeSpecificity(b.tag) - rangeSpecificity(a.tag) || a.q - b.q\n );\n const matchingRange = (locale: string) =>\n bySpecificity.find(({ tag }) => tag === '*' || locale === tag || locale.startsWith(tag + '-'));\n const defaultRange = matchingRange(config.defaultLocale.toLowerCase());\n const supported = config.locales\n .map(locale => {\n const tag = locale.toLowerCase();\n return { locale, tag, range: matchingRange(tag) };\n })\n .filter(({ range }) => range?.q !== 0);\n\n for (const preferred of ranked) {\n const { tag, q } = preferred;\n if (q === 0) continue;\n if (tag === '*') {\n if (defaultRange?.tag === '*' && defaultRange.q > 0) return config.defaultLocale;\n const match = supported.find(locale => locale.range?.tag === '*');\n if (match) return match.locale;\n continue;\n }\n const primary = tag.split('-')[0];\n const candidates = supported.filter(\n ({ range }) => !range || range.tag === '*' || range === preferred\n );\n const match =\n candidates.find(locale => locale.tag === tag) ??\n candidates.find(locale => locale.tag === primary) ??\n candidates.find(locale => locale.tag.startsWith(primary + '-'));\n if (match) return match.locale;\n }\n\n return defaultRange?.q === 0 ? (supported[0]?.locale ?? null) : config.defaultLocale;\n}\n\nfunction rangeSpecificity(tag: string): number {\n return tag === '*' ? 0 : tag.length;\n}\n\n/**\n * 列出某业务 pathname 在所有 locale 下的 URL —— 用于 <link rel=\"alternate\" hreflang>\n *\n * alternates('/about', { locales: ['zh','en'], defaultLocale: 'zh' })\n * → [{ hreflang: 'zh', href: '/about' }, { hreflang: 'en', href: '/en/about' }]\n */\nexport function alternates(\n pathname: string,\n config: I18nConfig\n): Array<{ hreflang: string; href: string }> {\n return config.locales.map(locale => ({\n hreflang: locale,\n href: withLocale(pathname, locale, config),\n }));\n}\n\n/**\n * 从 SiteHooks 的 intl 字段提取 URL 路由配置并填默认值\n *\n * 用途:消除消费者侧 `app.tsx` 里那段「从 siteHooks.intl 抠出 locales/defaultLocale/prefixDefault\n * 再补默认值组装 I18nConfig」的重复样板。\n *\n * // before\n * const intl = siteHooks.intl ?? {};\n * const I18N: I18nConfig = {\n * locales: intl.locales ?? ['en'],\n * defaultLocale: intl.defaultLocale ?? 'en',\n * prefixDefault: intl.prefixDefault,\n * };\n *\n * // after\n * const I18N = resolveI18nConfig(siteHooks.intl);\n *\n * 行为:\n * - 缺省 → `{ locales: ['en'], defaultLocale: 'en' }`(单语言英文兜底)\n * - locales 给了但 defaultLocale 没给 → 取 locales[0]\n * - 多余字段(endpoint / load / ttl / detect)忽略,只挑 URL 路由相关\n */\nexport function resolveI18nConfig(\n intl?: {\n locales?: readonly string[];\n defaultLocale?: string;\n prefixDefault?: boolean;\n } | null\n): I18nConfig {\n const locales = intl?.locales && intl.locales.length > 0 ? intl.locales : ['en'];\n const defaultLocale = intl?.defaultLocale ?? locales[0];\n return {\n locales,\n defaultLocale,\n prefixDefault: intl?.prefixDefault,\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"i18n-BZpAOZeO.js","names":[],"sources":["../src/utils/trimTrailingSlashes.ts","../src/runtime/i18n.ts"],"sourcesContent":["/** Remove only the trailing slash run; each character is inspected at most once. */\nexport function trimTrailingSlashes(value: string): string {\n let end = value.length;\n while (end > 0 && value[end - 1] === '/') end--;\n return value.slice(0, end);\n}\n","/**\n * i18n 路由工具 —— URL 前缀自动处理(无 React 依赖,server + client 通用)\n *\n * 业务侧用法:\n *\n * import { parseLocale, withLocale, negotiateLocale } from 'isr-engine/runtime';\n *\n * const I18N = { locales: ['zh', 'en'] as const, defaultLocale: 'zh' };\n *\n * // SSR 入口:从 URL 拆 locale + 干净 pathname 给路由\n * const { locale, pathname } = parseLocale(url.pathname, I18N);\n * return <Layout lang={locale}>{resolveRoute({ pathname, locale })}</Layout>;\n *\n * // Header 切换语言\n * const href = withLocale('/books/1', 'en', I18N); // → '/en/books/1'\n * const href = withLocale('/books/1', 'zh', I18N); // → '/books/1'(默认 locale 不前缀)\n *\n * // 服务器协商:Accept-Language 头 → locale\n * const locale = negotiateLocale(req.headers.get('accept-language'), I18N);\n *\n * 设计取舍:\n * - 默认 locale 不带前缀('/about'),其他 locale 带('/en/about')\n * → 与 Next.js i18n routing 默认 + Vue I18n 一致;SEO 友好(默认语言 URL 简洁)\n * - 用 `prefixDefault: true` 切到\"全部带前缀\"模式(如 '/zh/about')\n * - 不内置消息字典 / 翻译机制 —— 那是 react-intl / FormatJS / lingui 的活\n */\n\nimport { trimTrailingSlashes } from '../utils/trimTrailingSlashes';\nexport interface I18nConfig {\n /** 支持的 locale 列表,如 ['zh', 'en', 'ja'] */\n locales: readonly string[];\n /** 默认 locale —— 必须在 locales 内 */\n defaultLocale: string;\n /** 是否给默认 locale 也加 URL 前缀(默认 false:'/about';true:'/zh/about') */\n prefixDefault?: boolean;\n /** Remember deliberate LocaleLink selections for the unprefixed root in prefixDefault mode. */\n rememberLocale?: boolean;\n}\n\nexport interface ParsedLocale {\n /** 解析出的 locale(命中 URL 前缀则取前缀,否则取 defaultLocale) */\n locale: string;\n /** 去掉 locale 前缀后的\"业务 pathname\",路由表只需匹配这个 */\n pathname: string;\n /** URL 是否真的带了 locale 前缀 */\n hasPrefix: boolean;\n}\n\n/**\n * 从 pathname 拆出 locale 与业务 pathname\n *\n * '/zh/books/1' + { locales: ['zh','en'], defaultLocale: 'en' }\n * → { locale: 'zh', pathname: '/books/1', hasPrefix: true }\n *\n * '/books/1' 同上\n * → { locale: 'en', pathname: '/books/1', hasPrefix: false }\n */\nexport function parseLocale(pathname: string, config: I18nConfig): ParsedLocale {\n const segments = pathname.split('/');\n // segments[0] 是空串(leading '/'),segments[1] 才是首段\n const first = segments[1];\n if (first && config.locales.includes(first)) {\n const rest = '/' + segments.slice(2).join('/');\n return {\n locale: first,\n pathname: rest === '/' ? '/' : trimTrailingSlashes(rest),\n hasPrefix: true,\n };\n }\n return { locale: config.defaultLocale, pathname: pathname || '/', hasPrefix: false };\n}\n\n/**\n * 给业务 pathname 套上 locale 前缀(生成可跳转 URL)\n *\n * withLocale('/about', 'en', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/en/about'\n *\n * withLocale('/about', 'zh', { defaultLocale: 'zh', locales: ['zh','en'] })\n * → '/about' (默认 locale 不前缀)\n *\n * withLocale('/about', 'zh', { ..., prefixDefault: true })\n * → '/zh/about'\n */\nexport function withLocale(pathname: string, locale: string, config: I18nConfig): string {\n if (!config.locales.includes(locale)) {\n throw new Error(`[i18n] unknown locale \"${locale}\"; allowed: ${config.locales.join(', ')}`);\n }\n const clean = pathname.startsWith('/') ? pathname : '/' + pathname;\n if (locale === config.defaultLocale && !config.prefixDefault) return clean;\n return `/${locale}${clean === '/' ? '' : clean}`;\n}\n\n/**\n * 按权重协商 Accept-Language(支持主语言回退和通配符)\n *\n * negotiateLocale('zh-CN,en;q=0.9', { locales: ['zh','en'], defaultLocale: 'en' })\n * → 'zh' ('zh-CN' 命中 'zh')\n *\n * negotiateLocale('en-GB', { locales: ['zh-hans','en-us'], defaultLocale: 'zh-hans' })\n * → 'en-us' ('en-GB' 主语言 'en' 回退到第一个 en-*)\n *\n * negotiateLocale(null, ...) → defaultLocale\n *\n * @throws {RangeError} When the header explicitly rejects every available locale.\n */\nexport function negotiateLocale(\n acceptLanguage: string | null | undefined,\n config: I18nConfig\n): string {\n const locale = selectAcceptableLocale(acceptLanguage, config);\n if (locale !== null) return locale;\n const error = new RangeError('[i18n] no supported locale is acceptable');\n Object.defineProperty(error, NO_ACCEPTABLE_LOCALE, { value: true });\n throw error;\n}\n\n// The server entry and SiteHooks can load separately bundled copies of this module.\nconst NO_ACCEPTABLE_LOCALE = Symbol.for('isr-engine.no-acceptable-locale');\n\nexport function isNoAcceptableLocaleError(error: unknown): boolean {\n return error instanceof RangeError && NO_ACCEPTABLE_LOCALE in error;\n}\n\n/** Returns null when the header explicitly rejects every available locale. */\nexport function selectAcceptableLocale(\n acceptLanguage: string | null | undefined,\n config: I18nConfig\n): string | null {\n if (!acceptLanguage) return config.defaultLocale;\n const ranked = acceptLanguage\n .split(',')\n .flatMap(part => {\n const [rawTag, ...params] = part.split(';');\n const tag = rawTag.trim().toLowerCase();\n const weight = params\n .map(param => param.trim())\n .find(param => /^q=/i.test(param))\n ?.slice(2)\n .trim();\n const q = weight === undefined ? 1 : Number(weight);\n return tag && weight !== '' && q >= 0 && q <= 1 ? [{ tag, q }] : [];\n })\n .sort((a, b) => b.q - a.q);\n\n // Apply the most specific range to each available tag before lookup or fallback.\n const bySpecificity = [...ranked].sort(\n (a, b) => rangeSpecificity(b.tag) - rangeSpecificity(a.tag) || a.q - b.q\n );\n const matchingRange = (locale: string) =>\n bySpecificity.find(({ tag }) => tag === '*' || locale === tag || locale.startsWith(tag + '-'));\n const defaultRange = matchingRange(config.defaultLocale.toLowerCase());\n const supported = config.locales\n .map(locale => {\n const tag = locale.toLowerCase();\n return { locale, tag, range: matchingRange(tag) };\n })\n .filter(({ range }) => range?.q !== 0);\n\n for (const preferred of ranked) {\n const { tag, q } = preferred;\n if (q === 0) continue;\n if (tag === '*') {\n if (defaultRange?.tag === '*' && defaultRange.q > 0) return config.defaultLocale;\n const match = supported.find(locale => locale.range?.tag === '*');\n if (match) return match.locale;\n continue;\n }\n const primary = tag.split('-')[0];\n const candidates = supported.filter(\n ({ range }) => !range || range.tag === '*' || range === preferred\n );\n const match =\n candidates.find(locale => locale.tag === tag) ??\n candidates.find(locale => locale.tag === primary) ??\n candidates.find(locale => locale.tag.startsWith(primary + '-'));\n if (match) return match.locale;\n }\n\n return defaultRange?.q === 0 ? (supported[0]?.locale ?? null) : config.defaultLocale;\n}\n\nfunction rangeSpecificity(tag: string): number {\n return tag === '*' ? 0 : tag.length;\n}\n\n/**\n * 列出某业务 pathname 在所有 locale 下的 URL —— 用于 <link rel=\"alternate\" hreflang>\n *\n * alternates('/about', { locales: ['zh','en'], defaultLocale: 'zh' })\n * → [{ hreflang: 'zh', href: '/about' }, { hreflang: 'en', href: '/en/about' }]\n */\nexport function alternates(\n pathname: string,\n config: I18nConfig\n): Array<{ hreflang: string; href: string }> {\n return config.locales.map(locale => ({\n hreflang: locale,\n href: withLocale(pathname, locale, config),\n }));\n}\n\n/**\n * 从 SiteHooks 的 intl 字段提取 URL 路由配置并填默认值\n *\n * 用途:消除消费者侧 `app.tsx` 里那段「从 siteHooks.intl 抠出 locales/defaultLocale/prefixDefault\n * 再补默认值组装 I18nConfig」的重复样板。\n *\n * // before\n * const intl = siteHooks.intl ?? {};\n * const I18N: I18nConfig = {\n * locales: intl.locales ?? ['en'],\n * defaultLocale: intl.defaultLocale ?? 'en',\n * prefixDefault: intl.prefixDefault,\n * };\n *\n * // after\n * const I18N = resolveI18nConfig(siteHooks.intl);\n *\n * 行为:\n * - 缺省 → `{ locales: ['en'], defaultLocale: 'en' }`(单语言英文兜底)\n * - locales 给了但 defaultLocale 没给 → 取 locales[0]\n * - 多余字段(endpoint / load / ttl / detect)忽略,只挑 URL 路由相关\n */\nexport function resolveI18nConfig(\n intl?: {\n locales?: readonly string[];\n defaultLocale?: string;\n prefixDefault?: boolean;\n rememberLocale?: boolean;\n } | null\n): I18nConfig {\n const locales = intl?.locales && intl.locales.length > 0 ? intl.locales : ['en'];\n const defaultLocale = intl?.defaultLocale ?? locales[0];\n return {\n locales,\n defaultLocale,\n prefixDefault: intl?.prefixDefault,\n ...(intl?.rememberLocale && { rememberLocale: true }),\n };\n}\n"],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -45,8 +45,8 @@ export { installBrowserObservability } from './defaults/runtime/browserObservabi
45
45
  export type { BrowserAnalyticsOptions, BrowserErrorReportingOptions, BrowserObservabilityHandle, BrowserObservabilityOptions, BrowserObservabilityUser, } from './defaults/runtime/browserObservability';
46
46
  export { applyRuntimeToServerHooks, createAdminIntlLoader, createAdminSeoLoader, defineAdminSiteHooks, defineSiteHooks, } from './defaults/runtime/defineSiteHooks';
47
47
  export type { AdminSeoFallbackEntry, CreateAdminIntlLoaderOptions, CreateAdminSeoLoaderOptions, DefineAdminSiteHooksOptions, IntlMessagesByLocale, RuntimeServiceBase, RuntimeServices, SiteHooksConfig, SiteRuntimeConfig, SiteRuntimeContext, IntlConfig, SeoEntry, SeoStaticEntry, SeoRemoteEntry, ServerHooksOutput, } from './defaults/runtime/defineSiteHooks';
48
- export { revalidatePath, revalidateTag, cacheTag, collectTags, runWithTagStore, registerInvalidator, RevalidationError, serverActionsRegistry, createServerAction, ServerActionUtils, SERVER_ACTION_ENDPOINT, LEGACY_SERVER_ACTION_ENDPOINT, getI18n, getI18nLocale, } from './rsc';
49
- export type { RevalidateInvalidator, ServerActionMetadata, ServerActionHandler, I18nParams, Translate, } from './rsc';
48
+ export { revalidatePath, revalidateTag, revalidateContent, cacheTag, collectTags, runWithTagStore, registerInvalidator, RevalidationError, serverActionsRegistry, createServerAction, ServerActionUtils, SERVER_ACTION_ENDPOINT, LEGACY_SERVER_ACTION_ENDPOINT, getI18n, getI18nLocale, } from './rsc';
49
+ export type { RevalidateInvalidator, ContentRevalidationOptions, ServerActionMetadata, ServerActionHandler, I18nParams, Translate, } from './rsc';
50
50
  export { Logger } from './logger/Logger.js';
51
51
  export { CacheCleanup } from './utils/CacheCleanup.js';
52
52
  export { getCookieHeader, parseCookieHeader, readCookie, type CookieHeaderSource, } from './utils/cookie.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -17,10 +17,12 @@ export declare class ISRRoutes {
17
17
  private readonly defaultMode;
18
18
  private readonly routes;
19
19
  private readonly requestLimits;
20
+ private readonly seoAlreadyLimited;
20
21
  constructor(engine: ISREngine, logger: Logger, config: {
21
22
  renderMode: RenderModeType;
22
23
  routes?: Record<string, RouteRule>;
23
24
  requestLimits?: RequestLimitsConfig;
25
+ seoAlreadyLimited?: boolean;
24
26
  });
25
27
  setup(requestHandler: Express): void;
26
28
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ISRRoutes.d.ts","sourceRoot":"","sources":["../../src/isr/ISRRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAK1D,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQ9E,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,qBAAa,SAAS;IAMlB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;gBAGtD,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACtB,MAAM,EAAE;QACN,UAAU,EAAE,cAAc,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACnC,aAAa,CAAC,EAAE,mBAAmB,CAAC;KACrC;IAOH,KAAK,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI;CA2FrC"}
1
+ {"version":3,"file":"ISRRoutes.d.ts","sourceRoot":"","sources":["../../src/isr/ISRRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAK1D,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQ9E,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,qBAAa,SAAS;IAOlB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAPhB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;gBAGlC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACtB,MAAM,EAAE;QACN,UAAU,EAAE,cAAc,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACnC,aAAa,CAAC,EAAE,mBAAmB,CAAC;QACpC,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B;IAQH,KAAK,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI;CA6FrC"}
@@ -1,10 +1,10 @@
1
- import { $ as parseComponents, A as invalidatorRunsTotal, B as InternalStrategies, C as createCoherentCacheStore, D as loadConfig, F as getFallbackChain, H as extractSsgRoutes, I as getRouteFallbackChain, J as DEFAULT_SCAN_CONFIG, K as package_default, L as matchRoutePattern, M as recordHttpRequest, N as createHybridCacheStore, O as createPrometheusMetricsMiddleware, P as createMemoryCacheStore, Q as parseComponentFromFile, R as resolveRenderMode, S as MemoryCacheAdapter, U as spiderSsgRoutes, V as RenderModes, W as logger$1, X as scanProject, Y as scanComponents, Z as scanRoutes, _ as requestPinnedImage, at as isDev, b as RedisInvalidationBus, ct as CacheCleanup, d as SEOEngine, dt as resolveImageOptions, et as parseRouteFromFile, f as createSEOEngine, g as createImagePlugin, h as createImageMiddleware, i as startAppServer, it as readDirRecursive, j as promRegistry, k as invalidatorFailuresTotal, l as generateStaticCspManifest, lt as Logger, m as mergeSEOConfig, n as ISREngine, nt as isCodeFile, ot as isProd, p as DEFAULT_SEO_CONFIG, q as resolveFetchHandler, r as shutdownServer, rt as isTestFile, st as getEnv, t as createISRApp, tt as parseRoutes, u as createABVariantMiddleware, ut as assertDistinctHtmlRouteIdentities, v as createIsrCacheHandler, w as createDevAssetRequestMiddleware, x as RedisCacheAdapter, y as createIsrCacheMiddleware, z as FallbackChain } from "./createISRApp-DTlZvKBm.js";
1
+ import { $ as parseComponents, A as invalidatorRunsTotal, B as InternalStrategies, C as createCoherentCacheStore, D as loadConfig, F as getFallbackChain, H as extractSsgRoutes, I as getRouteFallbackChain, J as DEFAULT_SCAN_CONFIG, K as package_default, L as matchRoutePattern, M as recordHttpRequest, N as createHybridCacheStore, O as createPrometheusMetricsMiddleware, P as createMemoryCacheStore, Q as parseComponentFromFile, R as resolveRenderMode, S as MemoryCacheAdapter, U as spiderSsgRoutes, V as RenderModes, W as logger$1, X as scanProject, Y as scanComponents, Z as scanRoutes, _ as requestPinnedImage, at as isDev, b as RedisInvalidationBus, ct as CacheCleanup, d as SEOEngine, et as parseRouteFromFile, f as createSEOEngine, g as createImagePlugin, h as createImageMiddleware, i as startAppServer, it as readDirRecursive, j as promRegistry, k as invalidatorFailuresTotal, l as generateStaticCspManifest, lt as Logger, m as mergeSEOConfig, n as ISREngine, nt as isCodeFile, ot as isProd, p as DEFAULT_SEO_CONFIG, q as resolveFetchHandler, r as shutdownServer, rt as isTestFile, st as getEnv, t as createISRApp, tt as parseRoutes, u as createABVariantMiddleware, ut as resolveImageOptions, v as createIsrCacheHandler, w as createDevAssetRequestMiddleware, x as RedisCacheAdapter, y as createIsrCacheMiddleware, z as FallbackChain } from "./createISRApp-BG-s3uuL.js";
2
2
  import { defineIsrConfig, defineRuntimeConfig } from "./config/defineConfig.js";
3
- import { T as requestContext, c as RevalidationError, d as revalidateTag, l as registerInvalidator, n as cacheTag, r as collectTags, s as runWithTagStore, t as getVariant, u as revalidatePath, x as getRequestContext } from "./abVariantContext-CGBlCt0q.js";
4
- import { a as defineSiteHooks, i as defineAdminSiteHooks, n as createAdminIntlLoader, o as createCachedFetcher, r as createAdminSeoLoader, t as applyRuntimeToServerHooks } from "./defineSiteHooks-iwLiVChy.js";
5
- import { a as LEGACY_SERVER_ACTION_ENDPOINT, d as createServerAction, f as serverActionsRegistry, i as getI18nLocale, o as SERVER_ACTION_ENDPOINT, r as getI18n, u as ServerActionUtils } from "./rsc-DWwcqD4W.js";
6
- import { n as parseCookieHeader, r as readCookie, t as getCookieHeader } from "./cookie-DcUeYm6E.js";
7
- import { s as trimTrailingSlashes } from "./i18n-B2mWmifk.js";
3
+ import { D as assertDistinctHtmlRouteIdentities, E as requestContext, S as getRequestContext, d as revalidatePath, f as revalidateTag, l as registerInvalidator, n as cacheTag, o as runWithTagStore, r as collectTags, s as RevalidationError, t as getVariant, u as revalidateContent } from "./abVariantContext-yWZOqscY.js";
4
+ import { a as getCookieHeader, o as parseCookieHeader, s as readCookie, t as createCachedFetcher } from "./createCachedFetcher-CgJscexq.js";
5
+ import { applyRuntimeToServerHooks, createAdminIntlLoader, createAdminSeoLoader, defineAdminSiteHooks, defineSiteHooks } from "./defaults/runtime/defineSiteHooks.js";
6
+ import { a as LEGACY_SERVER_ACTION_ENDPOINT, d as createServerAction, f as serverActionsRegistry, i as getI18nLocale, o as SERVER_ACTION_ENDPOINT, r as getI18n, u as ServerActionUtils } from "./rsc-BYq2vvnh.js";
7
+ import { s as trimTrailingSlashes } from "./i18n-BZpAOZeO.js";
8
8
  import fs, { existsSync, promises, readFileSync, realpathSync } from "node:fs";
9
9
  import path from "node:path";
10
10
  import { resolve as resolve$1 } from "path";
@@ -3228,6 +3228,6 @@ function createIsrPlugin(options = {}) {
3228
3228
  plugins.push(createSsgPostBuildPlugin(userConfig));
3229
3229
  return plugins;
3230
3230
  }
3231
- export { CacheCleanup, CacheManager, DEFAULT_SCAN_CONFIG, DEFAULT_SEO_CONFIG, FallbackChain, ISREngine, InternalStrategies, LEGACY_SERVER_ACTION_ENDPOINT, Logger, ManifestLoader, MetricsCollector, RedisCacheAdapter, RedisInvalidationBus, RenderModes, RevalidationError, RouteManager, SEOEngine, SERVER_ACTION_ENDPOINT, ServerActionUtils, applyRuntimeToServerHooks, cacheTag, collectTags, createABVariantMiddleware, createAdminIntlLoader, createAdminSeoLoader, createCachedFetcher, createCoherentCacheStore, createFontPlugin, createHybridCacheStore, createISRApp, createImageMiddleware, createImagePlugin, createIsrCacheHandler, createIsrCacheMiddleware, createIsrPlugin, createMemoryCacheStore, createPrometheusMetricsMiddleware, createSEOEngine, createServerAction, defineAdminSiteHooks, defineIsrConfig, defineRuntimeConfig, defineSiteHooks, getCookieHeader, getEnv, getFallbackChain, getI18n, getI18nLocale, getRequestContext, getRouteFallbackChain, getVariant, injectSeoMeta, installBrowserObservability, invalidatorFailuresTotal, invalidatorRunsTotal, isCodeFile, isDev, isProd, isTestFile, loadConfig, matchRoutePattern, mergeSEOConfig, parseComponentFromFile, parseComponents, parseCookieHeader, parseRouteFromFile, parseRoutes, promRegistry, readCookie, readDirRecursive, recordHttpRequest, registerInvalidator, renderPageSeoMeta, requestContext, resolveRenderMode, revalidatePath, revalidateTag, runWithTagStore, scanComponents, scanProject, scanRoutes, serverActionsRegistry, shutdownServer, startAppServer };
3231
+ export { CacheCleanup, CacheManager, DEFAULT_SCAN_CONFIG, DEFAULT_SEO_CONFIG, FallbackChain, ISREngine, InternalStrategies, LEGACY_SERVER_ACTION_ENDPOINT, Logger, ManifestLoader, MetricsCollector, RedisCacheAdapter, RedisInvalidationBus, RenderModes, RevalidationError, RouteManager, SEOEngine, SERVER_ACTION_ENDPOINT, ServerActionUtils, applyRuntimeToServerHooks, cacheTag, collectTags, createABVariantMiddleware, createAdminIntlLoader, createAdminSeoLoader, createCachedFetcher, createCoherentCacheStore, createFontPlugin, createHybridCacheStore, createISRApp, createImageMiddleware, createImagePlugin, createIsrCacheHandler, createIsrCacheMiddleware, createIsrPlugin, createMemoryCacheStore, createPrometheusMetricsMiddleware, createSEOEngine, createServerAction, defineAdminSiteHooks, defineIsrConfig, defineRuntimeConfig, defineSiteHooks, getCookieHeader, getEnv, getFallbackChain, getI18n, getI18nLocale, getRequestContext, getRouteFallbackChain, getVariant, injectSeoMeta, installBrowserObservability, invalidatorFailuresTotal, invalidatorRunsTotal, isCodeFile, isDev, isProd, isTestFile, loadConfig, matchRoutePattern, mergeSEOConfig, parseComponentFromFile, parseComponents, parseCookieHeader, parseRouteFromFile, parseRoutes, promRegistry, readCookie, readDirRecursive, recordHttpRequest, registerInvalidator, renderPageSeoMeta, requestContext, resolveRenderMode, revalidateContent, revalidatePath, revalidateTag, runWithTagStore, scanComponents, scanProject, scanRoutes, serverActionsRegistry, shutdownServer, startAppServer };
3232
3232
 
3233
3233
  //# sourceMappingURL=isr-engine.js.map
@@ -3,9 +3,10 @@
3
3
  *
4
4
  * `runtime.i18n.prefixDefault: true` 时,根目录 / 业务路径裸 URL(无 locale 前缀)
5
5
  * 302 到 `/{negotiated}/path`。negotiated 来源优先级:
6
- * 1. cookie 'locale'(用户上次切过的)
7
- * 2. Accept-Language 头协商(按权重匹配 i18n.locales)
8
- * 3. i18n.defaultLocale 或首个未被拒绝的 locale
6
+ * 1. 根路径上启用的 LocaleLink 偏好
7
+ * 2. 应用提供的 `locale` cookie
8
+ * 3. Accept-Language 头协商(按权重匹配 i18n.locales)
9
+ * 4. i18n.defaultLocale 或首个未被拒绝的 locale
9
10
  * 所有 locale 都被 Accept-Language 明确拒绝时返回 406。
10
11
  *
11
12
  * 命中条件外的请求一概放行:
@@ -1 +1 @@
1
- {"version":3,"file":"LocaleRedirect.d.ts","sourceRoot":"","sources":["../../src/middlewares/LocaleRedirect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AA0BD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,2BAA2B,GACnC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,CAgFpE"}
1
+ {"version":3,"file":"LocaleRedirect.d.ts","sourceRoot":"","sources":["../../src/middlewares/LocaleRedirect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAuBD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,2BAA2B,GACnC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,CAgFpE"}
@@ -1 +1 @@
1
- {"version":3,"file":"coherentCacheStore.d.ts","sourceRoot":"","sources":["../../src/plugin/coherentCacheStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,oBAAoB,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA2BrE,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,EACP,GAAU,EACV,QAA2B,GAC5B,EAAE;IACD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,aAAa,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;CAAE,CAgIlF"}
1
+ {"version":3,"file":"coherentCacheStore.d.ts","sourceRoot":"","sources":["../../src/plugin/coherentCacheStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,oBAAoB,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA2BrE,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,EACP,GAAU,EACV,QAA2B,GAC5B,EAAE;IACD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,aAAa,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;CAAE,CAyIlF"}
@@ -2,6 +2,8 @@ import { type IsrCacheStore, type IsrCachedEntry } from './isrCacheStore';
2
2
  import type { Plugin, Connect } from 'vite';
3
3
  import type { IncomingMessage, ServerResponse } from 'node:http';
4
4
  import type { ISRConfig } from '../types';
5
+ import { type RevalidateTarget } from '../rsc/revalidate.js';
6
+ import { type ContentPublication } from '../defaults/runtime/contentRevalidation.js';
5
7
  /** 单条缓存条目 —— 与 IsrCacheStore 对齐 */
6
8
  type CachedEntry = IsrCachedEntry;
7
9
  /** STALE 响应头的原因枚举 —— 让 SRE 区分 “正常 SWR” vs “bg 失败” vs “bg 进行中” */
@@ -129,13 +131,12 @@ export interface IsrCacheMiddlewareOptions {
129
131
  */
130
132
  singleflightWaitMs?: number;
131
133
  }
132
- export type IsrInvalidationTarget = {
133
- kind: 'path';
134
- value: string;
134
+ export type IsrInvalidationTarget = (RevalidateTarget & {
135
135
  protocol?: 'response-v1';
136
- } | {
137
- kind: 'tag';
138
- value: string;
136
+ }) | {
137
+ kind: 'content';
138
+ value: ContentPublication['id'];
139
+ scopes: ContentPublication['scopes'];
139
140
  protocol?: 'response-v1';
140
141
  };
141
142
  export interface IsrInvalidationBus {
@@ -1 +1 @@
1
- {"version":3,"file":"isrCacheMiddleware.d.ts","sourceRoot":"","sources":["../../src/plugin/isrCacheMiddleware.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"isrCacheMiddleware.d.ts","sourceRoot":"","sources":["../../src/plugin/isrCacheMiddleware.ts"],"names":[],"mappings":"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"}
@@ -52,6 +52,8 @@ export interface IsrCacheStore {
52
52
  delete(key: string): boolean;
53
53
  /** Await durable invalidation, including entries evicted from L1. */
54
54
  invalidateByTag?(tag: string): Promise<void>;
55
+ /** Atomic response invalidation with durable content metadata fencing. */
56
+ invalidateTags?(tags: readonly string[], publicationId: string): Promise<void>;
55
57
  /** 清空(同步 L1 + 异步 L2)*/
56
58
  clear(): void;
57
59
  /** L1 中遍历 —— 用于 tag 失效与内部测试/诊断 */
@@ -1 +1 @@
1
- {"version":3,"file":"isrCacheStore.d.ts","sourceRoot":"","sources":["../../src/plugin/isrCacheStore.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"isrCacheStore.d.ts","sourceRoot":"","sources":["../../src/plugin/isrCacheStore.ts"],"names":[],"mappings":"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"}
@@ -6,6 +6,8 @@
6
6
  * are statically discoverable. Browser condition resolves here and keeps these APIs
7
7
  * inert outside the RSC/server runtime.
8
8
  */
9
+ import type { ContentRevalidationOptions } from '../defaults/runtime/contentRevalidation';
10
+ export type { ContentRevalidationOptions } from '../defaults/runtime/contentRevalidation';
9
11
  export declare class RevalidationError extends Error {
10
12
  }
11
13
  export type RevalidateInvalidator = (target: {
@@ -23,6 +25,7 @@ export declare function isUncacheable(): boolean;
23
25
  export declare function runWithTagStore<T>(fn: () => T | Promise<T>): T | Promise<T>;
24
26
  export declare function revalidatePath(): Promise<void>;
25
27
  export declare function revalidateTag(): Promise<void>;
28
+ export declare function revalidateContent(_options: ContentRevalidationOptions): Promise<void>;
26
29
  export declare function registerInvalidator(): () => void;
27
30
  export declare const serverActionsRegistry: {
28
31
  initialize: () => Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/rsc/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAClC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KACrE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,IAAI,CAIhD;AAED,eAAO,MAAM,qBAAqB;;;;;;;CAOjC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAEnD;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;CAS7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE,wBAAgB,iCAAiC,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMpF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAE/C;AAMD,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,SAAM,GAAG,MAAM,CAE9F;AAED,wBAAgB,aAAa,CAAC,QAAQ,SAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7D;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC"}
1
+ {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/rsc/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,YAAY,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAE1F,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,MAAM,MAAM,qBAAqB,GAAG,CAClC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KACrE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED,wBAAgB,mBAAmB,IAAI,MAAM,IAAI,CAIhD;AAED,eAAO,MAAM,qBAAqB;;;;;;;CAOjC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAEnD;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;CAS7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE,wBAAgB,iCAAiC,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMpF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAE/C;AAMD,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,SAAM,GAAG,MAAM,CAE9F;AAED,wBAAgB,aAAa,CAAC,QAAQ,SAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7D;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC"}
@@ -1,12 +1,4 @@
1
1
  // src/rsc/browser.ts
2
- /**
3
- * Browser stub for isr-engine/rsc.
4
- *
5
- * Server Components may be referenced from a shared route manifest. Client builds must
6
- * never pull Node-only cache/action infrastructure just because those server modules
7
- * are statically discoverable. Browser condition resolves here and keeps these APIs
8
- * inert outside the RSC/server runtime.
9
- */
10
2
  var RevalidationError = class extends Error {};
11
3
  function cacheTag() {}
12
4
  function markUncacheable() {}
@@ -26,6 +18,9 @@ async function revalidatePath() {
26
18
  async function revalidateTag() {
27
19
  await Promise.resolve();
28
20
  }
21
+ async function revalidateContent(_options) {
22
+ throw new Error("revalidateContent requires an active ISR runtime");
23
+ }
29
24
  function registerInvalidator() {
30
25
  return () => {};
31
26
  }
@@ -79,6 +74,6 @@ function getCurrentI18n() {
79
74
  function runWithI18n(_intl, fn) {
80
75
  return fn();
81
76
  }
82
- export { LEGACY_SERVER_ACTION_ENDPOINT, RevalidationError, SERVER_ACTION_ENDPOINT, ServerActionUtils, cacheTag, collectTags, createServerAction, debugTagStore, getCurrentI18n, getI18n, getI18nLocale, getRequestContext, getServerActionEndpointCandidates, getVariant, isLegacyServerActionEndpoint, isUncacheable, markUncacheable, registerInvalidator, revalidatePath, revalidateTag, runWithI18n, runWithTagStore, serverActionsRegistry, shouldSkipServerActionEndpointRetry };
77
+ export { LEGACY_SERVER_ACTION_ENDPOINT, RevalidationError, SERVER_ACTION_ENDPOINT, ServerActionUtils, cacheTag, collectTags, createServerAction, debugTagStore, getCurrentI18n, getI18n, getI18nLocale, getRequestContext, getServerActionEndpointCandidates, getVariant, isLegacyServerActionEndpoint, isUncacheable, markUncacheable, registerInvalidator, revalidateContent, revalidatePath, revalidateTag, runWithI18n, runWithTagStore, serverActionsRegistry, shouldSkipServerActionEndpointRetry };
83
78
 
84
79
  //# sourceMappingURL=browser.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"browser.js","names":[],"sources":["../../src/rsc/browser.ts"],"sourcesContent":["/**\n * Browser stub for isr-engine/rsc.\n *\n * Server Components may be referenced from a shared route manifest. Client builds must\n * never pull Node-only cache/action infrastructure just because those server modules\n * are statically discoverable. Browser condition resolves here and keeps these APIs\n * inert outside the RSC/server runtime.\n */\n\nexport class RevalidationError extends Error {}\n\nexport type RevalidateInvalidator = (\n target: { kind: 'path'; value: string } | { kind: 'tag'; value: string }\n) => Promise<void> | void;\n\nexport function cacheTag(): void {\n void 0;\n}\n\nexport function markUncacheable(): void {\n void 0;\n}\n\nexport function collectTags(): string[] {\n return [];\n}\n\nexport function debugTagStore(): void {\n void 0;\n}\n\nexport function isUncacheable(): boolean {\n return false;\n}\n\nexport function runWithTagStore<T>(fn: () => T | Promise<T>): T | Promise<T> {\n return fn();\n}\n\nexport async function revalidatePath(): Promise<void> {\n await Promise.resolve();\n}\n\nexport async function revalidateTag(): Promise<void> {\n await Promise.resolve();\n}\n\nexport function registerInvalidator(): () => void {\n return () => {\n void 0;\n };\n}\n\nexport const serverActionsRegistry = {\n initialize: async () => Promise.resolve(),\n cleanup: async () => Promise.resolve(),\n register: () => '',\n getAllActions: () => [],\n hasAction: () => false,\n getMetadata: () => undefined,\n};\n\nexport function createServerAction<T>(handler: T): T {\n return handler;\n}\n\nexport const ServerActionUtils = {\n isServer: () => false,\n isClient: () => true,\n getExecutionContext: () => ({\n environment: 'client' as const,\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n url: typeof window !== 'undefined' ? window.location.href : undefined,\n timestamp: new Date().toISOString(),\n }),\n};\n\nexport const SERVER_ACTION_ENDPOINT = '/_rsc/action';\nexport const LEGACY_SERVER_ACTION_ENDPOINT = '/api/server-actions';\n\nexport function getServerActionEndpointCandidates(primaryEndpoint?: string): string[] {\n return [\n primaryEndpoint || SERVER_ACTION_ENDPOINT,\n SERVER_ACTION_ENDPOINT,\n LEGACY_SERVER_ACTION_ENDPOINT,\n ];\n}\n\nexport function isLegacyServerActionEndpoint(endpoint: string): boolean {\n return endpoint === LEGACY_SERVER_ACTION_ENDPOINT;\n}\n\nexport function shouldSkipServerActionEndpointRetry(endpoint: string): boolean {\n return isLegacyServerActionEndpoint(endpoint);\n}\n\nexport function getVariant(): string | undefined {\n return undefined;\n}\n\n// 浏览器/客户端不持有 AsyncLocalStorage 请求上下文 —— 任何业务在 'use client'\n// 树里走到 getRequestContext() 都拿 undefined,跟 Server Component 里没有\n// 命中作用域时一致。空 stub 让 plugin-rsc 的 client/browser bundle 链不至于\n// 因为符号缺失炸开。\nexport function getRequestContext(): undefined {\n return undefined;\n}\n\nexport function getI18n(key: string, _params?: Record<string, unknown>, fallback = key): string {\n return fallback;\n}\n\nexport function getI18nLocale(fallback = ''): string {\n return fallback;\n}\n\nexport function getCurrentI18n(): null {\n return null;\n}\n\nexport function runWithI18n<T>(_intl: unknown, fn: () => T): T {\n return fn();\n}\n\nexport type I18nParams = Record<string, string | number | boolean | null | undefined>;\nexport type Translate = (key: string, params?: I18nParams, fallback?: string) => string;\n"],"mappings":";;;;;;;;;AASA,IAAa,oBAAb,cAAuC,MAAM,CAAC;AAM9C,SAAgB,WAAiB,CAEjC;AAEA,SAAgB,kBAAwB,CAExC;AAEA,SAAgB,cAAwB;CACtC,OAAO,CAAC;AACV;AAEA,SAAgB,gBAAsB,CAEtC;AAEA,SAAgB,gBAAyB;CACvC,OAAO;AACT;AAEA,SAAgB,gBAAmB,IAA0C;CAC3E,OAAO,GAAG;AACZ;AAEA,eAAsB,iBAAgC;CACpD,MAAM,QAAQ,QAAQ;AACxB;AAEA,eAAsB,gBAA+B;CACnD,MAAM,QAAQ,QAAQ;AACxB;AAEA,SAAgB,sBAAkC;CAChD,aAAa,CAEb;AACF;AAEA,IAAa,wBAAwB;CACnC,YAAY,YAAY,QAAQ,QAAQ;CACxC,SAAS,YAAY,QAAQ,QAAQ;CACrC,gBAAgB;CAChB,qBAAqB,CAAC;CACtB,iBAAiB;CACjB,mBAAmB,KAAA;AACrB;AAEA,SAAgB,mBAAsB,SAAe;CACnD,OAAO;AACT;AAEA,IAAa,oBAAoB;CAC/B,gBAAgB;CAChB,gBAAgB;CAChB,4BAA4B;EAC1B,aAAa;EACb,WAAW,OAAO,cAAc,cAAc,UAAU,YAAY,KAAA;EACpE,KAAK,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,KAAA;EAC5D,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;CACpC;AACF;AAEA,IAAa,yBAAyB;AACtC,IAAa,gCAAgC;AAE7C,SAAgB,kCAAkC,iBAAoC;CACpF,OAAO;EACL,mBAAA;EACA;EACA;CACF;AACF;AAEA,SAAgB,6BAA6B,UAA2B;CACtE,OAAO,aAAa;AACtB;AAEA,SAAgB,oCAAoC,UAA2B;CAC7E,OAAO,6BAA6B,QAAQ;AAC9C;AAEA,SAAgB,aAAiC,CAEjD;AAMA,SAAgB,oBAA+B,CAE/C;AAEA,SAAgB,QAAQ,KAAa,SAAmC,WAAW,KAAa;CAC9F,OAAO;AACT;AAEA,SAAgB,cAAc,WAAW,IAAY;CACnD,OAAO;AACT;AAEA,SAAgB,iBAAuB;CACrC,OAAO;AACT;AAEA,SAAgB,YAAe,OAAgB,IAAgB;CAC7D,OAAO,GAAG;AACZ"}
1
+ {"version":3,"file":"browser.js","names":[],"sources":["../../src/rsc/browser.ts"],"sourcesContent":["/**\n * Browser stub for isr-engine/rsc.\n *\n * Server Components may be referenced from a shared route manifest. Client builds must\n * never pull Node-only cache/action infrastructure just because those server modules\n * are statically discoverable. Browser condition resolves here and keeps these APIs\n * inert outside the RSC/server runtime.\n */\n\nimport type { ContentRevalidationOptions } from '../defaults/runtime/contentRevalidation';\nexport type { ContentRevalidationOptions } from '../defaults/runtime/contentRevalidation';\n\nexport class RevalidationError extends Error {}\n\nexport type RevalidateInvalidator = (\n target: { kind: 'path'; value: string } | { kind: 'tag'; value: string }\n) => Promise<void> | void;\n\nexport function cacheTag(): void {\n void 0;\n}\n\nexport function markUncacheable(): void {\n void 0;\n}\n\nexport function collectTags(): string[] {\n return [];\n}\n\nexport function debugTagStore(): void {\n void 0;\n}\n\nexport function isUncacheable(): boolean {\n return false;\n}\n\nexport function runWithTagStore<T>(fn: () => T | Promise<T>): T | Promise<T> {\n return fn();\n}\n\nexport async function revalidatePath(): Promise<void> {\n await Promise.resolve();\n}\n\nexport async function revalidateTag(): Promise<void> {\n await Promise.resolve();\n}\n\nexport async function revalidateContent(_options: ContentRevalidationOptions): Promise<void> {\n throw new Error('revalidateContent requires an active ISR runtime');\n}\n\nexport function registerInvalidator(): () => void {\n return () => {\n void 0;\n };\n}\n\nexport const serverActionsRegistry = {\n initialize: async () => Promise.resolve(),\n cleanup: async () => Promise.resolve(),\n register: () => '',\n getAllActions: () => [],\n hasAction: () => false,\n getMetadata: () => undefined,\n};\n\nexport function createServerAction<T>(handler: T): T {\n return handler;\n}\n\nexport const ServerActionUtils = {\n isServer: () => false,\n isClient: () => true,\n getExecutionContext: () => ({\n environment: 'client' as const,\n userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n url: typeof window !== 'undefined' ? window.location.href : undefined,\n timestamp: new Date().toISOString(),\n }),\n};\n\nexport const SERVER_ACTION_ENDPOINT = '/_rsc/action';\nexport const LEGACY_SERVER_ACTION_ENDPOINT = '/api/server-actions';\n\nexport function getServerActionEndpointCandidates(primaryEndpoint?: string): string[] {\n return [\n primaryEndpoint || SERVER_ACTION_ENDPOINT,\n SERVER_ACTION_ENDPOINT,\n LEGACY_SERVER_ACTION_ENDPOINT,\n ];\n}\n\nexport function isLegacyServerActionEndpoint(endpoint: string): boolean {\n return endpoint === LEGACY_SERVER_ACTION_ENDPOINT;\n}\n\nexport function shouldSkipServerActionEndpointRetry(endpoint: string): boolean {\n return isLegacyServerActionEndpoint(endpoint);\n}\n\nexport function getVariant(): string | undefined {\n return undefined;\n}\n\n// 浏览器/客户端不持有 AsyncLocalStorage 请求上下文 —— 任何业务在 'use client'\n// 树里走到 getRequestContext() 都拿 undefined,跟 Server Component 里没有\n// 命中作用域时一致。空 stub 让 plugin-rsc 的 client/browser bundle 链不至于\n// 因为符号缺失炸开。\nexport function getRequestContext(): undefined {\n return undefined;\n}\n\nexport function getI18n(key: string, _params?: Record<string, unknown>, fallback = key): string {\n return fallback;\n}\n\nexport function getI18nLocale(fallback = ''): string {\n return fallback;\n}\n\nexport function getCurrentI18n(): null {\n return null;\n}\n\nexport function runWithI18n<T>(_intl: unknown, fn: () => T): T {\n return fn();\n}\n\nexport type I18nParams = Record<string, string | number | boolean | null | undefined>;\nexport type Translate = (key: string, params?: I18nParams, fallback?: string) => string;\n"],"mappings":";AAYA,IAAa,oBAAb,cAAuC,MAAM,CAAC;AAM9C,SAAgB,WAAiB,CAEjC;AAEA,SAAgB,kBAAwB,CAExC;AAEA,SAAgB,cAAwB;CACtC,OAAO,CAAC;AACV;AAEA,SAAgB,gBAAsB,CAEtC;AAEA,SAAgB,gBAAyB;CACvC,OAAO;AACT;AAEA,SAAgB,gBAAmB,IAA0C;CAC3E,OAAO,GAAG;AACZ;AAEA,eAAsB,iBAAgC;CACpD,MAAM,QAAQ,QAAQ;AACxB;AAEA,eAAsB,gBAA+B;CACnD,MAAM,QAAQ,QAAQ;AACxB;AAEA,eAAsB,kBAAkB,UAAqD;CAC3F,MAAM,IAAI,MAAM,kDAAkD;AACpE;AAEA,SAAgB,sBAAkC;CAChD,aAAa,CAEb;AACF;AAEA,IAAa,wBAAwB;CACnC,YAAY,YAAY,QAAQ,QAAQ;CACxC,SAAS,YAAY,QAAQ,QAAQ;CACrC,gBAAgB;CAChB,qBAAqB,CAAC;CACtB,iBAAiB;CACjB,mBAAmB,KAAA;AACrB;AAEA,SAAgB,mBAAsB,SAAe;CACnD,OAAO;AACT;AAEA,IAAa,oBAAoB;CAC/B,gBAAgB;CAChB,gBAAgB;CAChB,4BAA4B;EAC1B,aAAa;EACb,WAAW,OAAO,cAAc,cAAc,UAAU,YAAY,KAAA;EACpE,KAAK,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,KAAA;EAC5D,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;CACpC;AACF;AAEA,IAAa,yBAAyB;AACtC,IAAa,gCAAgC;AAE7C,SAAgB,kCAAkC,iBAAoC;CACpF,OAAO;EACL,mBAAA;EACA;EACA;CACF;AACF;AAEA,SAAgB,6BAA6B,UAA2B;CACtE,OAAO,aAAa;AACtB;AAEA,SAAgB,oCAAoC,UAA2B;CAC7E,OAAO,6BAA6B,QAAQ;AAC9C;AAEA,SAAgB,aAAiC,CAEjD;AAMA,SAAgB,oBAA+B,CAE/C;AAEA,SAAgB,QAAQ,KAAa,SAAmC,WAAW,KAAa;CAC9F,OAAO;AACT;AAEA,SAAgB,cAAc,WAAW,IAAY;CACnD,OAAO;AACT;AAEA,SAAgB,iBAAuB;CACrC,OAAO;AACT;AAEA,SAAgB,YAAe,OAAgB,IAAgB;CAC7D,OAAO,GAAG;AACZ"}