isr-engine 0.0.0-stage → 1.0.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 (452) hide show
  1. package/CHANGELOG.md +755 -0
  2. package/README.md +694 -2
  3. package/dist/RequestContext-BVQ-rOmV.js +58 -0
  4. package/dist/RequestContext-BVQ-rOmV.js.map +1 -0
  5. package/dist/RequestContext-DgGEAxcW.cjs +105 -0
  6. package/dist/RequestContext-DgGEAxcW.cjs.map +1 -0
  7. package/dist/abVariantContext-CWCdRSdG.js +549 -0
  8. package/dist/abVariantContext-CWCdRSdG.js.map +1 -0
  9. package/dist/abVariantContext-Cqp-uxtd.cjs +678 -0
  10. package/dist/abVariantContext-Cqp-uxtd.cjs.map +1 -0
  11. package/dist/adapters/observability/client/sentry.d.ts +42 -0
  12. package/dist/adapters/observability/client/sentry.d.ts.map +1 -0
  13. package/dist/adapters/observability/index.cjs +152 -0
  14. package/dist/adapters/observability/index.cjs.map +1 -0
  15. package/dist/adapters/observability/index.d.ts +17 -0
  16. package/dist/adapters/observability/index.d.ts.map +1 -0
  17. package/dist/adapters/observability/index.js +148 -0
  18. package/dist/adapters/observability/index.js.map +1 -0
  19. package/dist/adapters/observability/server/datadog.d.ts +45 -0
  20. package/dist/adapters/observability/server/datadog.d.ts.map +1 -0
  21. package/dist/adapters/observability/server/otel.d.ts +51 -0
  22. package/dist/adapters/observability/server/otel.d.ts.map +1 -0
  23. package/dist/adapters/observability/server/sentry.d.ts +67 -0
  24. package/dist/adapters/observability/server/sentry.d.ts.map +1 -0
  25. package/dist/adapters/observability/types.d.ts +39 -0
  26. package/dist/adapters/observability/types.d.ts.map +1 -0
  27. package/dist/adapters/runtime/cloudflare.d.ts +33 -0
  28. package/dist/adapters/runtime/cloudflare.d.ts.map +1 -0
  29. package/dist/adapters/runtime/errorResponse.d.ts +3 -0
  30. package/dist/adapters/runtime/errorResponse.d.ts.map +1 -0
  31. package/dist/adapters/runtime/index.cjs +100 -0
  32. package/dist/adapters/runtime/index.cjs.map +1 -0
  33. package/dist/adapters/runtime/index.d.ts +10 -0
  34. package/dist/adapters/runtime/index.d.ts.map +1 -0
  35. package/dist/adapters/runtime/index.js +97 -0
  36. package/dist/adapters/runtime/index.js.map +1 -0
  37. package/dist/adapters/runtime/types.d.ts +24 -0
  38. package/dist/adapters/runtime/types.d.ts.map +1 -0
  39. package/dist/adapters/runtime/vercel-edge.d.ts +59 -0
  40. package/dist/adapters/runtime/vercel-edge.d.ts.map +1 -0
  41. package/dist/app/createISRApp.d.ts +19 -0
  42. package/dist/app/createISRApp.d.ts.map +1 -0
  43. package/dist/cache/CacheManager.d.ts +81 -0
  44. package/dist/cache/CacheManager.d.ts.map +1 -0
  45. package/dist/cache/ICacheAdapter.d.ts +84 -0
  46. package/dist/cache/ICacheAdapter.d.ts.map +1 -0
  47. package/dist/cache/MemoryCacheAdapter.d.ts +50 -0
  48. package/dist/cache/MemoryCacheAdapter.d.ts.map +1 -0
  49. package/dist/cache/RedisCacheAdapter.d.ts +111 -0
  50. package/dist/cache/RedisCacheAdapter.d.ts.map +1 -0
  51. package/dist/cache/RedisInvalidationBus.d.ts +59 -0
  52. package/dist/cache/RedisInvalidationBus.d.ts.map +1 -0
  53. package/dist/cache/RedisResponseCacheBackend.d.ts +30 -0
  54. package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -0
  55. package/dist/cache/ResponseCacheBackend.d.ts +28 -0
  56. package/dist/cache/ResponseCacheBackend.d.ts.map +1 -0
  57. package/dist/cache/createAutoCacheStore.d.ts +26 -0
  58. package/dist/cache/createAutoCacheStore.d.ts.map +1 -0
  59. package/dist/cache/index.d.ts +18 -0
  60. package/dist/cache/index.d.ts.map +1 -0
  61. package/dist/cli/cli.cjs +372 -0
  62. package/dist/cli/cli.cjs.map +1 -0
  63. package/dist/cli/cli.d.ts +8 -0
  64. package/dist/cli/cli.d.ts.map +1 -0
  65. package/dist/cli/cli.js +370 -0
  66. package/dist/cli/cli.js.map +1 -0
  67. package/dist/cli/dev.d.ts +11 -0
  68. package/dist/cli/dev.d.ts.map +1 -0
  69. package/dist/cli/fallback.d.ts +42 -0
  70. package/dist/cli/fallback.d.ts.map +1 -0
  71. package/dist/cli/serverOptions.d.ts +7 -0
  72. package/dist/cli/serverOptions.d.ts.map +1 -0
  73. package/dist/cli/start.d.ts +7 -0
  74. package/dist/cli/start.d.ts.map +1 -0
  75. package/dist/config/defaults.d.ts +11 -0
  76. package/dist/config/defaults.d.ts.map +1 -0
  77. package/dist/config/defineConfig.cjs +26 -0
  78. package/dist/config/defineConfig.cjs.map +1 -0
  79. package/dist/config/defineConfig.d.ts +44 -0
  80. package/dist/config/defineConfig.d.ts.map +1 -0
  81. package/dist/config/defineConfig.js +24 -0
  82. package/dist/config/defineConfig.js.map +1 -0
  83. package/dist/config/getEnv.d.ts +9 -0
  84. package/dist/config/getEnv.d.ts.map +1 -0
  85. package/dist/config/getStatus.d.ts +3 -0
  86. package/dist/config/getStatus.d.ts.map +1 -0
  87. package/dist/config/loadConfig.d.ts +18 -0
  88. package/dist/config/loadConfig.d.ts.map +1 -0
  89. package/dist/config/normalizeEngineConfig.d.ts +10 -0
  90. package/dist/config/normalizeEngineConfig.d.ts.map +1 -0
  91. package/dist/config/resolveImageOptions.d.ts +5 -0
  92. package/dist/config/resolveImageOptions.d.ts.map +1 -0
  93. package/dist/config/resolveRuntimeRedis.d.ts +11 -0
  94. package/dist/config/resolveRuntimeRedis.d.ts.map +1 -0
  95. package/dist/context/RequestContext.d.ts +28 -0
  96. package/dist/context/RequestContext.d.ts.map +1 -0
  97. package/dist/context/createServerRequestContext.d.ts +42 -0
  98. package/dist/context/createServerRequestContext.d.ts.map +1 -0
  99. package/dist/createCacheInspectorMiddleware-B32Suct_.js +105 -0
  100. package/dist/createCacheInspectorMiddleware-B32Suct_.js.map +1 -0
  101. package/dist/createCacheInspectorMiddleware-CAzxgGNh.cjs +105 -0
  102. package/dist/createCacheInspectorMiddleware-CAzxgGNh.cjs.map +1 -0
  103. package/dist/createISRApp-Bvs5_63N.cjs +7663 -0
  104. package/dist/createISRApp-Bvs5_63N.cjs.map +1 -0
  105. package/dist/createISRApp-CfGFTcw-.js +7322 -0
  106. package/dist/createISRApp-CfGFTcw-.js.map +1 -0
  107. package/dist/createImagePlugin-BHVUkFBd.js +416 -0
  108. package/dist/createImagePlugin-BHVUkFBd.js.map +1 -0
  109. package/dist/createImagePlugin-C-hHZCqj.cjs +435 -0
  110. package/dist/createImagePlugin-C-hHZCqj.cjs.map +1 -0
  111. package/dist/defaults/auto-observability.cjs +147 -0
  112. package/dist/defaults/auto-observability.cjs.map +1 -0
  113. package/dist/defaults/auto-observability.d.ts +21 -0
  114. package/dist/defaults/auto-observability.d.ts.map +1 -0
  115. package/dist/defaults/auto-observability.js +144 -0
  116. package/dist/defaults/auto-observability.js.map +1 -0
  117. package/dist/defaults/runtime/browserObservability.d.ts +73 -0
  118. package/dist/defaults/runtime/browserObservability.d.ts.map +1 -0
  119. package/dist/defaults/runtime/client-navigation-policy.d.ts +10 -0
  120. package/dist/defaults/runtime/client-navigation-policy.d.ts.map +1 -0
  121. package/dist/defaults/runtime/createCachedFetcher.d.ts +17 -0
  122. package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -0
  123. package/dist/defaults/runtime/defineSiteHooks.cjs +11 -0
  124. package/dist/defaults/runtime/defineSiteHooks.d.ts +197 -0
  125. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -0
  126. package/dist/defaults/runtime/defineSiteHooks.js +3 -0
  127. package/dist/defaults/runtime/dev-css-handoff.client.d.ts +2 -0
  128. package/dist/defaults/runtime/dev-css-handoff.client.d.ts.map +1 -0
  129. package/dist/defaults/runtime/dev-render-inspector.d.ts +57 -0
  130. package/dist/defaults/runtime/dev-render-inspector.d.ts.map +1 -0
  131. package/dist/defaults/runtime/dev-rsc-response.client.d.ts +7 -0
  132. package/dist/defaults/runtime/dev-rsc-response.client.d.ts.map +1 -0
  133. package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts +9 -0
  134. package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts.map +1 -0
  135. package/dist/defaults/runtime/dev-style-declarations.server.d.ts +15 -0
  136. package/dist/defaults/runtime/dev-style-declarations.server.d.ts.map +1 -0
  137. package/dist/defaults/runtime/dev-style-id.d.ts +9 -0
  138. package/dist/defaults/runtime/dev-style-id.d.ts.map +1 -0
  139. package/dist/defaults/runtime/dev-style-navigation.client.d.ts +26 -0
  140. package/dist/defaults/runtime/dev-style-navigation.client.d.ts.map +1 -0
  141. package/dist/defaults/runtime/dev-style-registry.client.d.ts +19 -0
  142. package/dist/defaults/runtime/dev-style-registry.client.d.ts.map +1 -0
  143. package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts +4 -0
  144. package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts.map +1 -0
  145. package/dist/defaults/runtime/empty-routes.d.ts +3 -0
  146. package/dist/defaults/runtime/empty-routes.d.ts.map +1 -0
  147. package/dist/defaults/runtime/error-boundary.d.ts +9 -0
  148. package/dist/defaults/runtime/error-boundary.d.ts.map +1 -0
  149. package/dist/defaults/runtime/error500-template.d.ts +21 -0
  150. package/dist/defaults/runtime/error500-template.d.ts.map +1 -0
  151. package/dist/defaults/runtime/head-extras-runtime.d.ts +17 -0
  152. package/dist/defaults/runtime/head-extras-runtime.d.ts.map +1 -0
  153. package/dist/defaults/runtime/hydration-shell.d.ts +12 -0
  154. package/dist/defaults/runtime/hydration-shell.d.ts.map +1 -0
  155. package/dist/defaults/runtime/i18n-server.d.ts +7 -0
  156. package/dist/defaults/runtime/i18n-server.d.ts.map +1 -0
  157. package/dist/defaults/runtime/navigation-history.client.d.ts +16 -0
  158. package/dist/defaults/runtime/navigation-history.client.d.ts.map +1 -0
  159. package/dist/defaults/runtime/navigation-request.client.d.ts +5 -0
  160. package/dist/defaults/runtime/navigation-request.client.d.ts.map +1 -0
  161. package/dist/defaults/runtime/seo-runtime.d.ts +41 -0
  162. package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -0
  163. package/dist/defineSiteHooks-BeVy-qPH.js +720 -0
  164. package/dist/defineSiteHooks-BeVy-qPH.js.map +1 -0
  165. package/dist/defineSiteHooks-C3v3WLS8.cjs +755 -0
  166. package/dist/defineSiteHooks-C3v3WLS8.cjs.map +1 -0
  167. package/dist/discovery/componentDiscovery.d.ts +71 -0
  168. package/dist/discovery/componentDiscovery.d.ts.map +1 -0
  169. package/dist/discovery/directiveParser.d.ts +197 -0
  170. package/dist/discovery/directiveParser.d.ts.map +1 -0
  171. package/dist/discovery/exportParser.d.ts +45 -0
  172. package/dist/discovery/exportParser.d.ts.map +1 -0
  173. package/dist/discovery/fileSystem.d.ts +33 -0
  174. package/dist/discovery/fileSystem.d.ts.map +1 -0
  175. package/dist/discovery/index.d.ts +18 -0
  176. package/dist/discovery/index.d.ts.map +1 -0
  177. package/dist/discovery/routeDiscovery.d.ts +121 -0
  178. package/dist/discovery/routeDiscovery.d.ts.map +1 -0
  179. package/dist/discovery/scan.d.ts +54 -0
  180. package/dist/discovery/scan.d.ts.map +1 -0
  181. package/dist/discovery/types.d.ts +61 -0
  182. package/dist/discovery/types.d.ts.map +1 -0
  183. package/dist/engine/ISREngine.d.ts +54 -0
  184. package/dist/engine/ISREngine.d.ts.map +1 -0
  185. package/dist/engine/RenderMode.d.ts +23 -0
  186. package/dist/engine/RenderMode.d.ts.map +1 -0
  187. package/dist/engine/i18n/types.d.ts +6 -0
  188. package/dist/engine/i18n/types.d.ts.map +1 -0
  189. package/dist/engine/seo/PageSeoMeta.d.ts +9 -0
  190. package/dist/engine/seo/PageSeoMeta.d.ts.map +1 -0
  191. package/dist/engine/seo/SEOEngine.d.ts +61 -0
  192. package/dist/engine/seo/SEOEngine.d.ts.map +1 -0
  193. package/dist/engine/seo/config.d.ts +9 -0
  194. package/dist/engine/seo/config.d.ts.map +1 -0
  195. package/dist/engine/seo/index.d.ts +10 -0
  196. package/dist/engine/seo/index.d.ts.map +1 -0
  197. package/dist/engine/seo/injectSeoMeta.d.ts +5 -0
  198. package/dist/engine/seo/injectSeoMeta.d.ts.map +1 -0
  199. package/dist/engine/seo/resolveSeoConfig.d.ts +15 -0
  200. package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -0
  201. package/dist/engine/seo/types.d.ts +75 -0
  202. package/dist/engine/seo/types.d.ts.map +1 -0
  203. package/dist/error500-template-BvZmvKoa.cjs +63 -0
  204. package/dist/error500-template-BvZmvKoa.cjs.map +1 -0
  205. package/dist/error500-template-DhaZzLOB.js +63 -0
  206. package/dist/error500-template-DhaZzLOB.js.map +1 -0
  207. package/dist/experiments/ExposureQueue.d.ts +54 -0
  208. package/dist/experiments/ExposureQueue.d.ts.map +1 -0
  209. package/dist/experiments/ManifestLoader.d.ts +57 -0
  210. package/dist/experiments/ManifestLoader.d.ts.map +1 -0
  211. package/dist/i18n-CyJIoYJT.cjs +244 -0
  212. package/dist/i18n-CyJIoYJT.cjs.map +1 -0
  213. package/dist/i18n-Dobe0Wxn.js +191 -0
  214. package/dist/i18n-Dobe0Wxn.js.map +1 -0
  215. package/dist/image/index.cjs +93 -0
  216. package/dist/image/index.cjs.map +1 -0
  217. package/dist/image/index.js +67 -0
  218. package/dist/image/index.js.map +1 -0
  219. package/dist/index.d.ts +59 -0
  220. package/dist/index.d.ts.map +1 -0
  221. package/dist/isr/ISRRoutes.d.ts +25 -0
  222. package/dist/isr/ISRRoutes.d.ts.map +1 -0
  223. package/dist/isr-engine.cjs +2830 -0
  224. package/dist/isr-engine.cjs.map +1 -0
  225. package/dist/isr-engine.js +2740 -0
  226. package/dist/isr-engine.js.map +1 -0
  227. package/dist/logger/Logger.d.ts +33 -0
  228. package/dist/logger/Logger.d.ts.map +1 -0
  229. package/dist/logger/index.d.ts +3 -0
  230. package/dist/logger/index.d.ts.map +1 -0
  231. package/dist/manifest/ManifestLoader.d.ts +98 -0
  232. package/dist/manifest/ManifestLoader.d.ts.map +1 -0
  233. package/dist/manifest/index.d.ts +8 -0
  234. package/dist/manifest/index.d.ts.map +1 -0
  235. package/dist/manifest/types.d.ts +76 -0
  236. package/dist/manifest/types.d.ts.map +1 -0
  237. package/dist/metrics/MetricsCollector.d.ts +90 -0
  238. package/dist/metrics/MetricsCollector.d.ts.map +1 -0
  239. package/dist/metrics/PromMetrics.d.ts +59 -0
  240. package/dist/metrics/PromMetrics.d.ts.map +1 -0
  241. package/dist/metrics/index.d.ts +7 -0
  242. package/dist/metrics/index.d.ts.map +1 -0
  243. package/dist/middlewares/ABVariantMiddleware.d.ts +74 -0
  244. package/dist/middlewares/ABVariantMiddleware.d.ts.map +1 -0
  245. package/dist/middlewares/LocaleRedirect.d.ts +27 -0
  246. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -0
  247. package/dist/middlewares/MiddlewareComposer.d.ts +20 -0
  248. package/dist/middlewares/MiddlewareComposer.d.ts.map +1 -0
  249. package/dist/middlewares/PerformanceMiddleware.d.ts +14 -0
  250. package/dist/middlewares/PerformanceMiddleware.d.ts.map +1 -0
  251. package/dist/middlewares/TraceMiddleware.d.ts +24 -0
  252. package/dist/middlewares/TraceMiddleware.d.ts.map +1 -0
  253. package/dist/middlewares/abVariantContext.d.ts +7 -0
  254. package/dist/middlewares/abVariantContext.d.ts.map +1 -0
  255. package/dist/middlewares/index.d.ts +5 -0
  256. package/dist/middlewares/index.d.ts.map +1 -0
  257. package/dist/middlewares/types.d.ts +4 -0
  258. package/dist/middlewares/types.d.ts.map +1 -0
  259. package/dist/plugin/clientObservabilityConfig.d.ts +16 -0
  260. package/dist/plugin/clientObservabilityConfig.d.ts.map +1 -0
  261. package/dist/plugin/coherentCacheStore.d.ts +11 -0
  262. package/dist/plugin/coherentCacheStore.d.ts.map +1 -0
  263. package/dist/plugin/createAutomaticImagePlugin.d.ts +4 -0
  264. package/dist/plugin/createAutomaticImagePlugin.d.ts.map +1 -0
  265. package/dist/plugin/createCacheInspectorMiddleware.d.ts +16 -0
  266. package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -0
  267. package/dist/plugin/createDevCssHandoffPlugin.d.ts +25 -0
  268. package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -0
  269. package/dist/plugin/createFontPlugin.d.ts +15 -0
  270. package/dist/plugin/createFontPlugin.d.ts.map +1 -0
  271. package/dist/plugin/createImagePlugin.d.ts +46 -0
  272. package/dist/plugin/createImagePlugin.d.ts.map +1 -0
  273. package/dist/plugin/createIsrPlugin.d.ts +43 -0
  274. package/dist/plugin/createIsrPlugin.d.ts.map +1 -0
  275. package/dist/plugin/createSsgPostBuildPlugin.d.ts +4 -0
  276. package/dist/plugin/createSsgPostBuildPlugin.d.ts.map +1 -0
  277. package/dist/plugin/devAssetRequestMiddleware.d.ts +10 -0
  278. package/dist/plugin/devAssetRequestMiddleware.d.ts.map +1 -0
  279. package/dist/plugin/index.d.ts +11 -0
  280. package/dist/plugin/index.d.ts.map +1 -0
  281. package/dist/plugin/isrCacheMiddleware.d.ts +223 -0
  282. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -0
  283. package/dist/plugin/isrCacheStore.d.ts +88 -0
  284. package/dist/plugin/isrCacheStore.d.ts.map +1 -0
  285. package/dist/plugin/remoteImageSource.d.ts +19 -0
  286. package/dist/plugin/remoteImageSource.d.ts.map +1 -0
  287. package/dist/plugin/transformDevCssModule.d.ts +3 -0
  288. package/dist/plugin/transformDevCssModule.d.ts.map +1 -0
  289. package/dist/renderer/RenderHeaders.d.ts +28 -0
  290. package/dist/renderer/RenderHeaders.d.ts.map +1 -0
  291. package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
  292. package/dist/rolldown-runtime-DakpK96I.cjs +43 -0
  293. package/dist/route/RouteManager.d.ts +22 -0
  294. package/dist/route/RouteManager.d.ts.map +1 -0
  295. package/dist/route/index.d.ts +2 -0
  296. package/dist/route/index.d.ts.map +1 -0
  297. package/dist/rsc/ServerActions.d.ts +65 -0
  298. package/dist/rsc/ServerActions.d.ts.map +1 -0
  299. package/dist/rsc/browser.cjs +109 -0
  300. package/dist/rsc/browser.cjs.map +1 -0
  301. package/dist/rsc/browser.d.ts +59 -0
  302. package/dist/rsc/browser.d.ts.map +1 -0
  303. package/dist/rsc/browser.js +85 -0
  304. package/dist/rsc/browser.js.map +1 -0
  305. package/dist/rsc/cacheTag.d.ts +52 -0
  306. package/dist/rsc/cacheTag.d.ts.map +1 -0
  307. package/dist/rsc/constants.d.ts +10 -0
  308. package/dist/rsc/constants.d.ts.map +1 -0
  309. package/dist/rsc/i18n.d.ts +3 -0
  310. package/dist/rsc/i18n.d.ts.map +1 -0
  311. package/dist/rsc/index.cjs +33 -0
  312. package/dist/rsc/index.d.ts +20 -0
  313. package/dist/rsc/index.d.ts.map +1 -0
  314. package/dist/rsc/index.js +4 -0
  315. package/dist/rsc/revalidate.d.ts +77 -0
  316. package/dist/rsc/revalidate.d.ts.map +1 -0
  317. package/dist/rsc-H7D_meHu.cjs +239 -0
  318. package/dist/rsc-H7D_meHu.cjs.map +1 -0
  319. package/dist/rsc-lvWPTuVD.js +168 -0
  320. package/dist/rsc-lvWPTuVD.js.map +1 -0
  321. package/dist/runtime/Image.d.ts +48 -0
  322. package/dist/runtime/Image.d.ts.map +1 -0
  323. package/dist/runtime/LocaleContext.d.ts +14 -0
  324. package/dist/runtime/LocaleContext.d.ts.map +1 -0
  325. package/dist/runtime/boundary.d.ts +27 -0
  326. package/dist/runtime/boundary.d.ts.map +1 -0
  327. package/dist/runtime/edge-context.d.ts +17 -0
  328. package/dist/runtime/edge-context.d.ts.map +1 -0
  329. package/dist/runtime/i18n-store.d.ts +11 -0
  330. package/dist/runtime/i18n-store.d.ts.map +1 -0
  331. package/dist/runtime/i18n.d.ts +115 -0
  332. package/dist/runtime/i18n.d.ts.map +1 -0
  333. package/dist/runtime/index.d.ts +16 -0
  334. package/dist/runtime/index.d.ts.map +1 -0
  335. package/dist/runtime/routes.d.ts +88 -0
  336. package/dist/runtime/routes.d.ts.map +1 -0
  337. package/dist/runtime/telemetry.d.ts +48 -0
  338. package/dist/runtime/telemetry.d.ts.map +1 -0
  339. package/dist/security/cspNonceTemplate.d.ts +10 -0
  340. package/dist/security/cspNonceTemplate.d.ts.map +1 -0
  341. package/dist/security/staticCspManifest.d.ts +37 -0
  342. package/dist/security/staticCspManifest.d.ts.map +1 -0
  343. package/dist/server/httpServer.d.ts +17 -0
  344. package/dist/server/httpServer.d.ts.map +1 -0
  345. package/dist/server/index.d.ts +3 -0
  346. package/dist/server/index.d.ts.map +1 -0
  347. package/dist/server/manager.d.ts +17 -0
  348. package/dist/server/manager.d.ts.map +1 -0
  349. package/dist/server/middleware.d.ts +87 -0
  350. package/dist/server/middleware.d.ts.map +1 -0
  351. package/dist/server/opsConfig.d.ts +17 -0
  352. package/dist/server/opsConfig.d.ts.map +1 -0
  353. package/dist/server/productionRuntime.d.ts +41 -0
  354. package/dist/server/productionRuntime.d.ts.map +1 -0
  355. package/dist/server/types.d.ts +41 -0
  356. package/dist/server/types.d.ts.map +1 -0
  357. package/dist/server/viteDevServer.d.ts +21 -0
  358. package/dist/server/viteDevServer.d.ts.map +1 -0
  359. package/dist/ssg/spider.d.ts +142 -0
  360. package/dist/ssg/spider.d.ts.map +1 -0
  361. package/dist/types/IFlightData.d.ts +23 -0
  362. package/dist/types/IFlightData.d.ts.map +1 -0
  363. package/dist/types/IHelmetData.d.ts +24 -0
  364. package/dist/types/IHelmetData.d.ts.map +1 -0
  365. package/dist/types/IRenderMetadata.d.ts +46 -0
  366. package/dist/types/IRenderMetadata.d.ts.map +1 -0
  367. package/dist/types/IRenderResult.d.ts +16 -0
  368. package/dist/types/IRenderResult.d.ts.map +1 -0
  369. package/dist/types/ISRConfig.d.ts +463 -0
  370. package/dist/types/ISRConfig.d.ts.map +1 -0
  371. package/dist/types/ISRContext.d.ts +104 -0
  372. package/dist/types/ISRContext.d.ts.map +1 -0
  373. package/dist/types/index.d.ts +7 -0
  374. package/dist/types/index.d.ts.map +1 -0
  375. package/dist/utils/CacheCleanup.d.ts +32 -0
  376. package/dist/utils/CacheCleanup.d.ts.map +1 -0
  377. package/dist/utils/cacheDuration.d.ts +12 -0
  378. package/dist/utils/cacheDuration.d.ts.map +1 -0
  379. package/dist/utils/cookie.d.ts +7 -0
  380. package/dist/utils/cookie.d.ts.map +1 -0
  381. package/dist/utils/hash.d.ts +22 -0
  382. package/dist/utils/hash.d.ts.map +1 -0
  383. package/dist/utils/htmlPathname.d.ts +12 -0
  384. package/dist/utils/htmlPathname.d.ts.map +1 -0
  385. package/dist/utils/index.d.ts +9 -0
  386. package/dist/utils/index.d.ts.map +1 -0
  387. package/dist/utils/resolveFetchHandler.d.ts +4 -0
  388. package/dist/utils/resolveFetchHandler.d.ts.map +1 -0
  389. package/dist/utils/trimTrailingSlashes.d.ts +3 -0
  390. package/dist/utils/trimTrailingSlashes.d.ts.map +1 -0
  391. package/package.json +200 -4
  392. package/src/context/RequestContext.ts +68 -0
  393. package/src/context/createServerRequestContext.ts +104 -0
  394. package/src/defaults/auto-observability.ts +195 -0
  395. package/src/defaults/entry.server.ssr.tsx +257 -0
  396. package/src/defaults/entry.server.tsx +117 -0
  397. package/src/defaults/entry.tsx +23 -0
  398. package/src/defaults/runtime/browserObservability.ts +839 -0
  399. package/src/defaults/runtime/client-navigation-policy.ts +67 -0
  400. package/src/defaults/runtime/createCachedFetcher.ts +121 -0
  401. package/src/defaults/runtime/defineClientEntry.tsx +773 -0
  402. package/src/defaults/runtime/defineServerEntry.tsx +421 -0
  403. package/src/defaults/runtime/defineSiteHooks.ts +1073 -0
  404. package/src/defaults/runtime/dev-css-handoff.client.ts +5 -0
  405. package/src/defaults/runtime/dev-render-inspector.ts +597 -0
  406. package/src/defaults/runtime/dev-rsc-response.client.ts +48 -0
  407. package/src/defaults/runtime/dev-style-commit-boundary.client.tsx +20 -0
  408. package/src/defaults/runtime/dev-style-declarations.server.ts +158 -0
  409. package/src/defaults/runtime/dev-style-id.ts +91 -0
  410. package/src/defaults/runtime/dev-style-navigation.client.ts +152 -0
  411. package/src/defaults/runtime/dev-style-registry.client.ts +744 -0
  412. package/src/defaults/runtime/dev-style-resource-dispatcher.server.ts +42 -0
  413. package/src/defaults/runtime/empty-config.ts +5 -0
  414. package/src/defaults/runtime/empty-routes.ts +2 -0
  415. package/src/defaults/runtime/error-boundary.style.css +35 -0
  416. package/src/defaults/runtime/error-boundary.tsx +65 -0
  417. package/src/defaults/runtime/error500-template.ts +66 -0
  418. package/src/defaults/runtime/head-extras-runtime.ts +64 -0
  419. package/src/defaults/runtime/hydration-shell.tsx +20 -0
  420. package/src/defaults/runtime/i18n-server.ts +27 -0
  421. package/src/defaults/runtime/navigation-history.client.ts +80 -0
  422. package/src/defaults/runtime/navigation-request.client.ts +21 -0
  423. package/src/defaults/runtime/request.tsx +100 -0
  424. package/src/defaults/runtime/seo-runtime.ts +257 -0
  425. package/src/defaults/tsconfig.json +10 -0
  426. package/src/defaults/types.d.ts +23 -0
  427. package/src/runtime/Image.tsx +124 -0
  428. package/src/runtime/LocaleContext.tsx +38 -0
  429. package/src/runtime/boundary.module.css +46 -0
  430. package/src/runtime/boundary.tsx +136 -0
  431. package/src/runtime/edge-context.ts +32 -0
  432. package/src/runtime/i18n-store.ts +76 -0
  433. package/src/runtime/i18n.ts +189 -0
  434. package/src/runtime/index.ts +61 -0
  435. package/src/runtime/routes.tsx +247 -0
  436. package/src/runtime/scss.d.ts +13 -0
  437. package/src/runtime/telemetry.ts +116 -0
  438. package/src/types/IFlightData.ts +27 -0
  439. package/src/types/IHelmetData.ts +9 -0
  440. package/src/types/IRenderMetadata.ts +52 -0
  441. package/src/types/IRenderResult.ts +16 -0
  442. package/src/types/ISRConfig.ts +512 -0
  443. package/src/types/ISRContext.ts +106 -0
  444. package/src/types/index.ts +6 -0
  445. package/src/utils/CacheCleanup.ts +74 -0
  446. package/src/utils/cacheDuration.ts +37 -0
  447. package/src/utils/cookie.ts +59 -0
  448. package/src/utils/hash.ts +32 -0
  449. package/src/utils/htmlPathname.ts +75 -0
  450. package/src/utils/index.ts +9 -0
  451. package/src/utils/resolveFetchHandler.ts +19 -0
  452. package/src/utils/trimTrailingSlashes.ts +6 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routeDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/routeDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzE,YAAY,EAAE,SAAS,EAAE,CAAC;AAI1B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,oBAAoB,CAAC;IACpD,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,cAAc;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa;IACb,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,uBAAuB;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,oBAAoB,GAC3B,WAAW,GAAG,IAAI,CAoBpB;AAyLD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,oBAAoB,GAAG,WAAW,EAAE,CAyB1F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EAAE,GACpB,KAAK,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA+CrE;AAID;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,UAAU,GAAG,IAAI,CAgBrF;AA2DD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAmB1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG;IAC1D,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAmBA"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * 目录扫描器 —— 轻量文件发现(用于 engine 启动日志 / sitemap 路由枚举)
3
+ *
4
+ * 精简后只做:
5
+ * - 扫描 pages 目录计数页面路由
6
+ * - 扫描 api 目录计数 API 路由
7
+ * - 扫描 components 目录解析组件元数据
8
+ *
9
+ * "use client" / "use server" 指令识别、路径转路由、动态段解析等,
10
+ * 全部交给 @vitejs/plugin-rsc 在构建/运行时完成。本模块不再重造。
11
+ */
12
+ import { type EnhancedComponentMetadata } from './componentDiscovery';
13
+ import type { ComponentMetadata, FileInfo } from './types';
14
+ export interface ScanConfig {
15
+ /** 页面目录,默认 src/pages */
16
+ pagesDir: string;
17
+ /** API 目录,默认 src/api */
18
+ apiDir: string;
19
+ /** 组件目录列表,默认 ['src/components'] */
20
+ componentDirs: string[];
21
+ /** 是否扫描组件,默认 true */
22
+ scanComponents: boolean;
23
+ /** 是否启用 API 路由扫描,默认 true */
24
+ enableApiRoutes: boolean;
25
+ /** 只读取文件头部(性能优化),默认 true */
26
+ headerOnly: boolean;
27
+ /** 头部行数,默认 50 */
28
+ headerLines: number;
29
+ }
30
+ export declare const DEFAULT_SCAN_CONFIG: ScanConfig;
31
+ export interface ScanResult {
32
+ /** 扫描到的路由(页面 + API) */
33
+ routes: {
34
+ pages: FileInfo[];
35
+ apis: FileInfo[];
36
+ };
37
+ /** 组件元数据 */
38
+ components: EnhancedComponentMetadata[] | ComponentMetadata[];
39
+ /** 扫描耗时(毫秒) */
40
+ scanTime: number;
41
+ }
42
+ /**
43
+ * 扫描项目目录
44
+ */
45
+ export declare function scanProject(projectRoot: string, config?: Partial<ScanConfig>): Promise<ScanResult>;
46
+ /**
47
+ * 仅扫描路由文件(不解析组件)
48
+ */
49
+ export declare function scanRoutes(projectRoot: string, config?: Partial<Pick<ScanConfig, 'pagesDir' | 'apiDir' | 'enableApiRoutes'>>): Promise<ScanResult['routes']>;
50
+ /**
51
+ * 仅扫描组件
52
+ */
53
+ export declare function scanComponents(projectRoot: string, componentDirs?: string[]): Promise<EnhancedComponentMetadata[]>;
54
+ //# sourceMappingURL=scan.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/discovery/scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAmB,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,4BAA4B;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,4BAA4B;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,EAAE,UAQjC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,IAAI,EAAE,QAAQ,EAAE,CAAC;KAClB,CAAC;IACF,YAAY;IACZ,UAAU,EAAE,yBAAyB,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAC9D,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiDD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,OAAO,CAAC,UAAU,CAAM,GAC/B,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,iBAAiB,CAAC,CAAM,GAChF,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAK/B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,aAAa,GAAE,MAAM,EAAuB,GAC3C,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAGtC"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * 发现模块类型定义
3
+ */
4
+ /** 组件类型 */
5
+ export type ComponentType = 'server' | 'client';
6
+ /**
7
+ * 路由类型
8
+ * - page: 页面组件
9
+ * - api: API 路由
10
+ * - layout: 布局组件
11
+ * - component: 普通组件
12
+ */
13
+ export type RouteType = 'page' | 'api' | 'layout' | 'component';
14
+ /**
15
+ * 支持的文件扩展名
16
+ */
17
+ export declare const SUPPORTED_EXTENSIONS: readonly [".tsx", ".jsx", ".ts", ".js"];
18
+ /** 组件元数据 */
19
+ export interface ComponentMetadata {
20
+ id: string;
21
+ name: string;
22
+ path: string;
23
+ type: ComponentType;
24
+ exports: string[];
25
+ }
26
+ /** 路由元数据 */
27
+ export interface RouteMetadata {
28
+ urlPath: string;
29
+ filePath: string;
30
+ type: RouteType;
31
+ }
32
+ /** 扫描结果 */
33
+ export interface ScanResult {
34
+ routes: RouteMetadata[];
35
+ components: ComponentMetadata[];
36
+ }
37
+ /** 文件信息 —— content 仅在需要内容解析(如组件元数据)时填充 */
38
+ export interface FileInfo {
39
+ absolutePath: string;
40
+ relativePath: string;
41
+ content?: string;
42
+ }
43
+ /** 路由发现器配置 */
44
+ export interface RouteDiscoveryConfig {
45
+ /** 项目根目录 */
46
+ rootDir: string;
47
+ /** 源码目录(相对于 rootDir) */
48
+ srcDir: string;
49
+ /** 页面目录模式(Pages Router) */
50
+ pagesDir: string;
51
+ /** 自定义路由目录(可选) */
52
+ routesDir?: string;
53
+ }
54
+ /** 组件发现器配置 */
55
+ export interface ComponentDiscoveryConfig {
56
+ /** 项目根目录 */
57
+ rootDir: string;
58
+ /** 源码目录(相对于 rootDir) */
59
+ srcDir: string;
60
+ }
61
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/discovery/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,WAAW;AACX,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,oBAAoB,yCAA0C,CAAC;AAE5E,YAAY;AACZ,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,cAAc;AACd,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,cAAc;AACd,MAAM,WAAW,wBAAwB;IACvC,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * ISR 引擎 —— ISR/SSG/Fallback 编排层(plugin-rsc 模式)
3
+ *
4
+ * 职责范围:
5
+ * - 配置归一化(补齐 defaults,收口 cache / routes / renderMode)
6
+ * - 项目扫描(路由发现,供 virtual:isr-routes 和 sitemap 使用)
7
+ * - SEO 引擎初始化(sitemap / robots 生成)
8
+ * - 启动 Express 服务器 + 挂载 ops 路由(/health / sitemap.xml / robots.txt)
9
+ * - ISR 缓存失效 invalidator 的注册(来自 revalidatePath / revalidateTag 调用)
10
+ *
11
+ * 非职责:
12
+ * - 渲染:由 @vitejs/plugin-rsc 在 rsc/ssr/client 三环境完成
13
+ * - Flight 协议:由 react-server-dom-webpack 承担
14
+ * - ISR 内存缓存:由 createIsrCacheHandler 在 Vite/Express 中间件链里提供
15
+ * - SSG 预生成:由 cli/build.ts + ssg/spider 在构建阶段完成
16
+ */
17
+ import type { ISRConfig } from '../types';
18
+ export { normalizeEngineConfig } from '../config/normalizeEngineConfig';
19
+ import { type ServerContext } from '../server';
20
+ export default class ISREngine {
21
+ private readonly logger;
22
+ private readonly config;
23
+ private readonly resolvedSeo;
24
+ private readonly middlewareComposer;
25
+ private readonly seoEngine;
26
+ private serverContext?;
27
+ constructor(config: ISRConfig);
28
+ /**
29
+ * 初始化(不依赖 serverContext 的部分)
30
+ */
31
+ initialize(): Promise<void>;
32
+ private initializeProject;
33
+ /**
34
+ * 启动服务器;生产运维与缓存生命周期由共享运行时负责
35
+ */
36
+ start(): Promise<ServerContext>;
37
+ /**
38
+ * plugin-rsc 模式标识(供 ISRRoutes 等决定是否注册 * 渲染路由)
39
+ */
40
+ isPluginRscMode(): boolean;
41
+ /**
42
+ * 生成站点地图 + robots.txt
43
+ */
44
+ generateSeo(): Promise<void>;
45
+ /**
46
+ * 关闭引擎
47
+ *
48
+ * 所有清理步骤用 allSettled 跑,保证其中一步失败不会阻止后续释放。
49
+ * 否则 shutdownServer 抛错时 seoEngine 永不清理 → sitemap 写盘 handle 泄漏、
50
+ * 下次进程启动 `.isr-hyou/ssg` 里残留旧 robots.txt。
51
+ */
52
+ shutdown(): Promise<void>;
53
+ }
54
+ //# sourceMappingURL=ISREngine.d.ts.map
@@ -0,0 +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;AAQ9E,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;IAgBrC;;OAEG;IACH,eAAe,IAAI,OAAO;IAK1B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAWlC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAwBhC"}
@@ -0,0 +1,23 @@
1
+ import { type RenderModeType, type InternalStrategyType, type RouteRule } from '../types';
2
+ /**
3
+ * 获取指定渲染模式的降级链
4
+ */
5
+ export declare function getFallbackChain(mode: RenderModeType): InternalStrategyType[];
6
+ /**
7
+ * 根据路由和覆盖配置,获取实际的渲染模式
8
+ */
9
+ export declare function resolveRenderMode(url: string, globalMode: RenderModeType, overrides?: Record<string, RouteRule>): RenderModeType;
10
+ /** Match exact, dynamic, interior glob and combined dynamic/glob patterns. */
11
+ export declare function matchRoutePattern(url: string, pattern: string): boolean;
12
+ /**
13
+ * Exact paths win. Otherwise prefer more literal characters, fewer unrestricted
14
+ * globs, then more constrained parameters. Parameter names never affect ranking.
15
+ * Equal specificity keeps declaration order; both consumers select the whole rule
16
+ * so mode, TTL and SWR cannot come from different matching algorithms.
17
+ */
18
+ export declare function selectRouteRule(url: string, routes: Record<string, RouteRule>): RouteRule | undefined;
19
+ /**
20
+ * 获取路由的完整降级链
21
+ */
22
+ export declare function getRouteFallbackChain(url: string, globalMode: RenderModeType, overrides?: Record<string, RouteRule>): InternalStrategyType[];
23
+ //# sourceMappingURL=RenderMode.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RenderMode.d.ts","sourceRoot":"","sources":["../../src/engine/RenderMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAelB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,oBAAoB,EAAE,CAE7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,cAAc,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,cAAc,CAKhB;AAqED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAChC,SAAS,GAAG,SAAS,CAqBvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,cAAc,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,oBAAoB,EAAE,CAGxB"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Re-export shim —— 真实定义在 src/defaults/runtime/seo-runtime.ts
3
+ * (IntlPayload 与 PageSeoMeta 一起作为运行时载荷,集中在 defaults 边界)
4
+ */
5
+ export type { IntlPayload } from '../../defaults/runtime/seo-runtime';
6
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engine/i18n/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Re-export shim —— 真实定义在 src/defaults/runtime/seo-runtime.ts
3
+ *
4
+ * 原因:defaults/ 在用户的 plugin-rsc 上下文里被打包;不能跨引 src/engine/。
5
+ * 因此运行时类型 + 注入 helper 集中在 defaults/runtime/,这里仅做公共 API 转发。
6
+ */
7
+ export type { PageSeoMeta } from '../../defaults/runtime/seo-runtime';
8
+ export { renderPageSeoMeta } from '../../defaults/runtime/seo-runtime';
9
+ //# sourceMappingURL=PageSeoMeta.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PageSeoMeta.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/PageSeoMeta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * SEO 引擎 - 单例模式
3
+ *
4
+ * 核心功能:
5
+ * - Meta 标签生成
6
+ * - 结构化数据(JSON-LD)生成
7
+ * - 站点地图生成
8
+ * - Open Graph / Twitter Cards
9
+ */
10
+ import type { SEOConfig, DeepPartial } from './types';
11
+ export declare class SEOEngine {
12
+ private static instance;
13
+ private readonly logger;
14
+ private config;
15
+ private initialized;
16
+ private pageDataCache;
17
+ private sitemapCache;
18
+ private sitemapLastGenerated;
19
+ private constructor();
20
+ /** 获取单例实例 */
21
+ static getInstance(config?: DeepPartial<SEOConfig>): SEOEngine;
22
+ /** 重置实例(仅用于测试) */
23
+ static resetInstance(): void;
24
+ /** 更新配置 */
25
+ updateConfig(config: DeepPartial<SEOConfig>): void;
26
+ /** 获取当前配置 */
27
+ getConfig(): SEOConfig;
28
+ /** 初始化 */
29
+ initialize(): Promise<void>;
30
+ /** 优化页面 SEO */
31
+ optimizePage<T extends {
32
+ html: string;
33
+ meta?: unknown;
34
+ }>(url: string, context: unknown, result: T): Promise<T & {
35
+ seoScore: number;
36
+ }>;
37
+ /** 生成站点地图 */
38
+ generateSitemap(routes?: string[]): Promise<string>;
39
+ /** 生成 Robots.txt */
40
+ generateRobotsTxt(): string;
41
+ /** 清理缓存 */
42
+ clearCache(): void;
43
+ /** 关闭引擎 */
44
+ shutdown(): Promise<void>;
45
+ private getOrCreatePageData;
46
+ private generateAllTags;
47
+ private generateStructuredData;
48
+ private insertSEOTags;
49
+ private calculateScore;
50
+ private detectPageType;
51
+ private generateTitle;
52
+ private generateDescription;
53
+ private extractKeywordsFromUrl;
54
+ private detectLanguage;
55
+ private shouldExcludeUrl;
56
+ private getUrlPriority;
57
+ private getUrlChangeFreq;
58
+ }
59
+ /** 创建 SEO 引擎实例(获取单例) */
60
+ export declare function createSEOEngine(config?: DeepPartial<SEOConfig>): SEOEngine;
61
+ //# sourceMappingURL=SEOEngine.d.ts.map
@@ -0,0 +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;AAGnE,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,CAAuB;IAC3C,OAAO,CAAC,oBAAoB,CAAK;IAEjC,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,aAAa;IACP,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCzD,oBAAoB;IACpB,iBAAiB,IAAI,MAAM;IAW3B,WAAW;IACX,UAAU,IAAI,IAAI;IAMlB,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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * SEO 默认配置
3
+ */
4
+ import type { SEOConfig, DeepPartial } from './types';
5
+ /** 默认 SEO 配置 */
6
+ export declare const DEFAULT_SEO_CONFIG: SEOConfig;
7
+ /** 深度合并配置 */
8
+ export declare function mergeSEOConfig(base: SEOConfig, override: DeepPartial<SEOConfig>): SEOConfig;
9
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtD,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,SA4ChC,CAAC;AAEF,aAAa;AACb,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,SAAS,CAS3F"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * SEO 模块导出
3
+ */
4
+ export { SEOEngine, createSEOEngine } from './SEOEngine';
5
+ export { DEFAULT_SEO_CONFIG, mergeSEOConfig } from './config';
6
+ export { resolveSeoConfig, type ResolvedSeoConfig } from './resolveSeoConfig';
7
+ export { renderPageSeoMeta, type PageSeoMeta } from './PageSeoMeta';
8
+ export { injectSeoMeta } from './injectSeoMeta';
9
+ export type { SEOConfig, SEOPageData, DeepPartial } from './types';
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Re-export shim —— 真实实现在 src/defaults/runtime/seo-runtime.ts
3
+ */
4
+ export { injectSeoMeta } from '../../defaults/runtime/seo-runtime';
5
+ //# sourceMappingURL=injectSeoMeta.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"injectSeoMeta.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/injectSeoMeta.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC"}
@@ -0,0 +1,15 @@
1
+ import type { ISRConfig } from '../../types';
2
+ export interface ResolvedSeoConfig {
3
+ /** 真实可用的 baseUrl(已解析所有 fallback);prod 未配置时为空串 */
4
+ baseUrl: string;
5
+ /** 解析来源(便于 admin / 日志) */
6
+ baseUrlSource: 'runtime.site' | 'dev-default' | 'unset';
7
+ }
8
+ /**
9
+ * 按以下顺序解析 baseUrl:
10
+ * 1. runtime.site
11
+ * 2. dev 模式:`http://localhost:${server.port||3000}`
12
+ * 3. prod 且未配置:返回空串(SEOEngine 在调用 generateSitemap 时报错给出修复提示)
13
+ */
14
+ export declare function resolveSeoConfig(config: ISRConfig): ResolvedSeoConfig;
15
+ //# sourceMappingURL=resolveSeoConfig.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * SEO 模块类型定义
3
+ */
4
+ /** SEO 引擎配置 */
5
+ export interface SEOConfig {
6
+ /** 站点基础 URL */
7
+ baseUrl: string;
8
+ /** 站点名称 */
9
+ siteName: string;
10
+ /** 默认语言 */
11
+ defaultLanguage: string;
12
+ /** 支持的语言列表 */
13
+ supportedLanguages: string[];
14
+ /** 默认标题 */
15
+ defaultTitle: string;
16
+ /** 默认描述 */
17
+ defaultDescription: string;
18
+ /** 标题模板,%s 为页面标题占位符 */
19
+ titleTemplate: string;
20
+ /** 关键词 */
21
+ keywords: string[];
22
+ /** 作者 */
23
+ author: string;
24
+ /** Robots 指令 */
25
+ robots: string;
26
+ /** 站点地图配置 */
27
+ sitemap: {
28
+ /** URL 优先级映射 (pattern -> priority) */
29
+ priority: Record<string, number>;
30
+ /** URL 更新频率映射 (pattern -> changefreq) */
31
+ changeFreq: Record<string, string>;
32
+ /** 排除的 URL 模式 */
33
+ excludePatterns: string[];
34
+ /** 缓存超时时间(秒) */
35
+ cacheTimeout: number;
36
+ };
37
+ /** Open Graph 配置 */
38
+ openGraph: {
39
+ enabled: boolean;
40
+ locale: string;
41
+ defaultImage: string;
42
+ };
43
+ /** Twitter Cards 配置 */
44
+ twitter: {
45
+ enabled: boolean;
46
+ card: string;
47
+ site: string;
48
+ };
49
+ /** 结构化数据配置 */
50
+ structuredData: {
51
+ enabled: boolean;
52
+ organizationLogo?: string;
53
+ };
54
+ }
55
+ /** 页面 SEO 数据 */
56
+ export interface SEOPageData {
57
+ url: string;
58
+ title: string;
59
+ description: string;
60
+ keywords?: string[];
61
+ image?: string;
62
+ type: 'website' | 'article' | 'product';
63
+ language: string;
64
+ publishedTime?: string;
65
+ modifiedTime?: string;
66
+ author?: string;
67
+ }
68
+ /**
69
+ * 深度部分类型
70
+ * 数组保持原样不递归(避免破坏 readonly tuple / 数组泛型推断)
71
+ */
72
+ export type DeepPartial<T> = T extends unknown[] ? T : T extends object ? {
73
+ [P in keyof T]?: DeepPartial<T[P]>;
74
+ } : T;
75
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engine/seo/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc;IACd,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B,WAAW;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU;IACV,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IAEf,aAAa;IACb,OAAO,EAAE;QACP,sCAAsC;QACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,yCAAyC;QACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,iBAAiB;QACjB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,gBAAgB;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,oBAAoB;IACpB,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,uBAAuB;IACvB,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,cAAc;IACd,cAAc,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,GAC5C,CAAC,GACD,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtC,CAAC,CAAC"}
@@ -0,0 +1,63 @@
1
+ //#region src/defaults/runtime/error500-template.ts
2
+ /**
3
+ * 静态 500 兜底 HTML 模板 —— engine 入口 catch-all 在最坏情况下的最后一道墙。
4
+ *
5
+ * 触发条件:rscHandler 抛错且 SSR / csr-shell 兜底也失败 —— 此时 React 树根本没机会
6
+ * 渲染 GlobalErrorBoundary,必须在 Express 层用纯字符串模板返回一个最小可读页面。
7
+ *
8
+ * 设计:
9
+ * - 零依赖、纯字符串拼接:再差的环境也能渲染(主进程 OOM 后兜底也不会再失败)
10
+ * - 含 traceId:让用户能贴给 support 一查到底;engine 已生成(traceId 必有值)
11
+ * - 不含任何业务文案:不假设业务品牌,业务侧想覆盖直接 monkey-patch 这个函数
12
+ * 或在 reverse proxy / nginx 层用 error_page 替换
13
+ * - 转义 traceId 防 XSS:理论上 traceId 由 engine 生成应安全,但纵深防御
14
+ */
15
+ /** HTML escape —— 把 traceId 中的 5 个特殊字符替换成 entity */
16
+ function escapeHtml(s) {
17
+ return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
18
+ }
19
+ /**
20
+ * 渲染 500 兜底页面。
21
+ *
22
+ * @param traceId 用户向 support 反馈时引用的请求标识;engine 入口生成保证非空。
23
+ * 空串 / undefined 显示 'unknown'。
24
+ */
25
+ function renderError500Html(traceId) {
26
+ return `<!DOCTYPE html>
27
+ <html lang="zh-CN">
28
+ <head>
29
+ <meta charset="UTF-8">
30
+ <meta name="viewport" content="width=device-width,initial-scale=1">
31
+ <meta name="robots" content="noindex,nofollow">
32
+ <title>500 · 服务暂时不可用</title>
33
+ <style>
34
+ *{box-sizing:border-box;margin:0;padding:0}
35
+ html,body{height:100%}
36
+ body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;background:#fafafa;color:#111;display:flex;align-items:center;justify-content:center;padding:24px;line-height:1.5}
37
+ main{max-width:480px;width:100%;background:#fff;border-radius:12px;padding:32px;box-shadow:0 1px 3px rgba(0,0,0,.05),0 1px 2px rgba(0,0,0,.03)}
38
+ h1{font-size:20px;font-weight:600;margin-bottom:8px}
39
+ p{font-size:14px;color:#555;margin-bottom:16px}
40
+ .trace{font-family:ui-monospace,'SF Mono',Menlo,Consolas,monospace;font-size:12px;background:#f4f4f5;color:#333;padding:8px 12px;border-radius:6px;word-break:break-all;user-select:all}
41
+ .actions{margin-top:20px;display:flex;gap:8px}
42
+ a,button{display:inline-block;font-size:14px;padding:8px 14px;border-radius:6px;border:1px solid #d4d4d8;background:#fff;color:#111;text-decoration:none;cursor:pointer;font-family:inherit}
43
+ a:hover,button:hover{background:#f4f4f5}
44
+ </style>
45
+ </head>
46
+ <body>
47
+ <main>
48
+ <h1>服务暂时不可用</h1>
49
+ <p>页面渲染遇到异常。问题已经记录,稍后请重试。</p>
50
+ <p>如果反馈给客服,请附上以下追踪 ID:</p>
51
+ <div class="trace" aria-label="trace id">${escapeHtml(traceId && traceId.length > 0 ? traceId : "unknown")}</div>
52
+ <div class="actions">
53
+ <a href="/">返回首页</a>
54
+ <button type="button" onclick="location.reload()">重试</button>
55
+ </div>
56
+ </main>
57
+ </body>
58
+ </html>`;
59
+ }
60
+ //#endregion
61
+ exports.renderError500Html = renderError500Html;
62
+
63
+ //# sourceMappingURL=error500-template-BvZmvKoa.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error500-template-BvZmvKoa.cjs","names":[],"sources":["../src/defaults/runtime/error500-template.ts"],"sourcesContent":["/**\n * 静态 500 兜底 HTML 模板 —— engine 入口 catch-all 在最坏情况下的最后一道墙。\n *\n * 触发条件:rscHandler 抛错且 SSR / csr-shell 兜底也失败 —— 此时 React 树根本没机会\n * 渲染 GlobalErrorBoundary,必须在 Express 层用纯字符串模板返回一个最小可读页面。\n *\n * 设计:\n * - 零依赖、纯字符串拼接:再差的环境也能渲染(主进程 OOM 后兜底也不会再失败)\n * - 含 traceId:让用户能贴给 support 一查到底;engine 已生成(traceId 必有值)\n * - 不含任何业务文案:不假设业务品牌,业务侧想覆盖直接 monkey-patch 这个函数\n * 或在 reverse proxy / nginx 层用 error_page 替换\n * - 转义 traceId 防 XSS:理论上 traceId 由 engine 生成应安全,但纵深防御\n */\n\n/** HTML escape —— 把 traceId 中的 5 个特殊字符替换成 entity */\nfunction escapeHtml(s: string): string {\n return s\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&#39;');\n}\n\n/**\n * 渲染 500 兜底页面。\n *\n * @param traceId 用户向 support 反馈时引用的请求标识;engine 入口生成保证非空。\n * 空串 / undefined 显示 'unknown'。\n */\nexport function renderError500Html(traceId: string | undefined): string {\n const safeTrace = escapeHtml(traceId && traceId.length > 0 ? traceId : 'unknown');\n return `<!DOCTYPE html>\n<html lang=\"zh-CN\">\n<head>\n<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow\">\n<title>500 · 服务暂时不可用</title>\n<style>\n *{box-sizing:border-box;margin:0;padding:0}\n html,body{height:100%}\n body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;background:#fafafa;color:#111;display:flex;align-items:center;justify-content:center;padding:24px;line-height:1.5}\n main{max-width:480px;width:100%;background:#fff;border-radius:12px;padding:32px;box-shadow:0 1px 3px rgba(0,0,0,.05),0 1px 2px rgba(0,0,0,.03)}\n h1{font-size:20px;font-weight:600;margin-bottom:8px}\n p{font-size:14px;color:#555;margin-bottom:16px}\n .trace{font-family:ui-monospace,'SF Mono',Menlo,Consolas,monospace;font-size:12px;background:#f4f4f5;color:#333;padding:8px 12px;border-radius:6px;word-break:break-all;user-select:all}\n .actions{margin-top:20px;display:flex;gap:8px}\n a,button{display:inline-block;font-size:14px;padding:8px 14px;border-radius:6px;border:1px solid #d4d4d8;background:#fff;color:#111;text-decoration:none;cursor:pointer;font-family:inherit}\n a:hover,button:hover{background:#f4f4f5}\n</style>\n</head>\n<body>\n<main>\n <h1>服务暂时不可用</h1>\n <p>页面渲染遇到异常。问题已经记录,稍后请重试。</p>\n <p>如果反馈给客服,请附上以下追踪 ID:</p>\n <div class=\"trace\" aria-label=\"trace id\">${safeTrace}</div>\n <div class=\"actions\">\n <a href=\"/\">返回首页</a>\n <button type=\"button\" onclick=\"location.reload()\">重试</button>\n </div>\n</main>\n</body>\n</html>`;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAS,WAAW,GAAmB;CACrC,OAAO,EACJ,QAAQ,MAAM,OAAO,CAAC,CACtB,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,QAAQ,CAAC,CACvB,QAAQ,MAAM,OAAO;AAC1B;;;;;;;AAQA,SAAgB,mBAAmB,SAAqC;CAEtE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;6CADW,WAAW,WAAW,QAAQ,SAAS,IAAI,UAAU,SA0B5B,EAAU;;;;;;;;AAQvD"}
@@ -0,0 +1,63 @@
1
+ //#region src/defaults/runtime/error500-template.ts
2
+ /**
3
+ * 静态 500 兜底 HTML 模板 —— engine 入口 catch-all 在最坏情况下的最后一道墙。
4
+ *
5
+ * 触发条件:rscHandler 抛错且 SSR / csr-shell 兜底也失败 —— 此时 React 树根本没机会
6
+ * 渲染 GlobalErrorBoundary,必须在 Express 层用纯字符串模板返回一个最小可读页面。
7
+ *
8
+ * 设计:
9
+ * - 零依赖、纯字符串拼接:再差的环境也能渲染(主进程 OOM 后兜底也不会再失败)
10
+ * - 含 traceId:让用户能贴给 support 一查到底;engine 已生成(traceId 必有值)
11
+ * - 不含任何业务文案:不假设业务品牌,业务侧想覆盖直接 monkey-patch 这个函数
12
+ * 或在 reverse proxy / nginx 层用 error_page 替换
13
+ * - 转义 traceId 防 XSS:理论上 traceId 由 engine 生成应安全,但纵深防御
14
+ */
15
+ /** HTML escape —— 把 traceId 中的 5 个特殊字符替换成 entity */
16
+ function escapeHtml(s) {
17
+ return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
18
+ }
19
+ /**
20
+ * 渲染 500 兜底页面。
21
+ *
22
+ * @param traceId 用户向 support 反馈时引用的请求标识;engine 入口生成保证非空。
23
+ * 空串 / undefined 显示 'unknown'。
24
+ */
25
+ function renderError500Html(traceId) {
26
+ return `<!DOCTYPE html>
27
+ <html lang="zh-CN">
28
+ <head>
29
+ <meta charset="UTF-8">
30
+ <meta name="viewport" content="width=device-width,initial-scale=1">
31
+ <meta name="robots" content="noindex,nofollow">
32
+ <title>500 · 服务暂时不可用</title>
33
+ <style>
34
+ *{box-sizing:border-box;margin:0;padding:0}
35
+ html,body{height:100%}
36
+ body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;background:#fafafa;color:#111;display:flex;align-items:center;justify-content:center;padding:24px;line-height:1.5}
37
+ main{max-width:480px;width:100%;background:#fff;border-radius:12px;padding:32px;box-shadow:0 1px 3px rgba(0,0,0,.05),0 1px 2px rgba(0,0,0,.03)}
38
+ h1{font-size:20px;font-weight:600;margin-bottom:8px}
39
+ p{font-size:14px;color:#555;margin-bottom:16px}
40
+ .trace{font-family:ui-monospace,'SF Mono',Menlo,Consolas,monospace;font-size:12px;background:#f4f4f5;color:#333;padding:8px 12px;border-radius:6px;word-break:break-all;user-select:all}
41
+ .actions{margin-top:20px;display:flex;gap:8px}
42
+ a,button{display:inline-block;font-size:14px;padding:8px 14px;border-radius:6px;border:1px solid #d4d4d8;background:#fff;color:#111;text-decoration:none;cursor:pointer;font-family:inherit}
43
+ a:hover,button:hover{background:#f4f4f5}
44
+ </style>
45
+ </head>
46
+ <body>
47
+ <main>
48
+ <h1>服务暂时不可用</h1>
49
+ <p>页面渲染遇到异常。问题已经记录,稍后请重试。</p>
50
+ <p>如果反馈给客服,请附上以下追踪 ID:</p>
51
+ <div class="trace" aria-label="trace id">${escapeHtml(traceId && traceId.length > 0 ? traceId : "unknown")}</div>
52
+ <div class="actions">
53
+ <a href="/">返回首页</a>
54
+ <button type="button" onclick="location.reload()">重试</button>
55
+ </div>
56
+ </main>
57
+ </body>
58
+ </html>`;
59
+ }
60
+ //#endregion
61
+ export { renderError500Html };
62
+
63
+ //# sourceMappingURL=error500-template-DhaZzLOB.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error500-template-DhaZzLOB.js","names":[],"sources":["../src/defaults/runtime/error500-template.ts"],"sourcesContent":["/**\n * 静态 500 兜底 HTML 模板 —— engine 入口 catch-all 在最坏情况下的最后一道墙。\n *\n * 触发条件:rscHandler 抛错且 SSR / csr-shell 兜底也失败 —— 此时 React 树根本没机会\n * 渲染 GlobalErrorBoundary,必须在 Express 层用纯字符串模板返回一个最小可读页面。\n *\n * 设计:\n * - 零依赖、纯字符串拼接:再差的环境也能渲染(主进程 OOM 后兜底也不会再失败)\n * - 含 traceId:让用户能贴给 support 一查到底;engine 已生成(traceId 必有值)\n * - 不含任何业务文案:不假设业务品牌,业务侧想覆盖直接 monkey-patch 这个函数\n * 或在 reverse proxy / nginx 层用 error_page 替换\n * - 转义 traceId 防 XSS:理论上 traceId 由 engine 生成应安全,但纵深防御\n */\n\n/** HTML escape —— 把 traceId 中的 5 个特殊字符替换成 entity */\nfunction escapeHtml(s: string): string {\n return s\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&#39;');\n}\n\n/**\n * 渲染 500 兜底页面。\n *\n * @param traceId 用户向 support 反馈时引用的请求标识;engine 入口生成保证非空。\n * 空串 / undefined 显示 'unknown'。\n */\nexport function renderError500Html(traceId: string | undefined): string {\n const safeTrace = escapeHtml(traceId && traceId.length > 0 ? traceId : 'unknown');\n return `<!DOCTYPE html>\n<html lang=\"zh-CN\">\n<head>\n<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow\">\n<title>500 · 服务暂时不可用</title>\n<style>\n *{box-sizing:border-box;margin:0;padding:0}\n html,body{height:100%}\n body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;background:#fafafa;color:#111;display:flex;align-items:center;justify-content:center;padding:24px;line-height:1.5}\n main{max-width:480px;width:100%;background:#fff;border-radius:12px;padding:32px;box-shadow:0 1px 3px rgba(0,0,0,.05),0 1px 2px rgba(0,0,0,.03)}\n h1{font-size:20px;font-weight:600;margin-bottom:8px}\n p{font-size:14px;color:#555;margin-bottom:16px}\n .trace{font-family:ui-monospace,'SF Mono',Menlo,Consolas,monospace;font-size:12px;background:#f4f4f5;color:#333;padding:8px 12px;border-radius:6px;word-break:break-all;user-select:all}\n .actions{margin-top:20px;display:flex;gap:8px}\n a,button{display:inline-block;font-size:14px;padding:8px 14px;border-radius:6px;border:1px solid #d4d4d8;background:#fff;color:#111;text-decoration:none;cursor:pointer;font-family:inherit}\n a:hover,button:hover{background:#f4f4f5}\n</style>\n</head>\n<body>\n<main>\n <h1>服务暂时不可用</h1>\n <p>页面渲染遇到异常。问题已经记录,稍后请重试。</p>\n <p>如果反馈给客服,请附上以下追踪 ID:</p>\n <div class=\"trace\" aria-label=\"trace id\">${safeTrace}</div>\n <div class=\"actions\">\n <a href=\"/\">返回首页</a>\n <button type=\"button\" onclick=\"location.reload()\">重试</button>\n </div>\n</main>\n</body>\n</html>`;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAS,WAAW,GAAmB;CACrC,OAAO,EACJ,QAAQ,MAAM,OAAO,CAAC,CACtB,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,QAAQ,CAAC,CACvB,QAAQ,MAAM,OAAO;AAC1B;;;;;;;AAQA,SAAgB,mBAAmB,SAAqC;CAEtE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;6CADW,WAAW,WAAW,QAAQ,SAAS,IAAI,UAAU,SA0B5B,EAAU;;;;;;;;AAQvD"}