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,22 @@
1
+ /**
2
+ * 通用 hash 工具 —— 非加密用途的快速字符串 hash。
3
+ *
4
+ * 选 FNV-1a 32 位变种:
5
+ * - 无外部依赖(纯 JS,浏览器 / Node / edge 全部能跑)
6
+ * - 同一字符串永远同一结果(确定性,A/B 分桶 + cache key digest 都需要)
7
+ * - 雪崩效应足够好(单字符变化 → 大范围 bit 变化)
8
+ * - 不用于密码 / 安全场景(那种应当走 SHA / HMAC)
9
+ *
10
+ * 跟 ISR cache 里 extractVariantDigest 用的同一份 hash —— 行为可预测。
11
+ */
12
+ /**
13
+ * FNV-1a 32-bit hash —— 返回无符号 32 位整数。
14
+ *
15
+ * 算法常量遵循 Fowler/Noll/Vo 规范:
16
+ * offset basis = 0x811c9dc5
17
+ * prime = 0x01000193
18
+ */
19
+ export declare function fnv1a32(input: string): number;
20
+ /** FNV-1a 32-bit → base36 字符串。供 cache key digest 用,简短稳定 */
21
+ export declare function fnv1a32Base36(input: string): string;
22
+ //# sourceMappingURL=hash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}
@@ -0,0 +1,12 @@
1
+ /** Shared logical identity for HTML dispatch, aliases and build-time route validation. */
2
+ export declare function decodeHtmlPathname(raw: string): string;
3
+ export interface HtmlRouteDeclarationOptions {
4
+ /** Matching rules are valid configuration, but are never concrete SSG pages. */
5
+ allowPatterns?: boolean;
6
+ }
7
+ export declare function isHtmlRoutePattern(route: string): boolean;
8
+ /** Validate the original declaration before a URL parser can repair or normalize it. */
9
+ export declare function htmlRouteIdentity(route: string, { allowPatterns }?: HtmlRouteDeclarationOptions): string;
10
+ /** Exact duplicates are idempotent; matching rules do not own concrete page identities. */
11
+ export declare function assertDistinctHtmlRouteIdentities(routes: Iterable<string>, options?: HtmlRouteDeclarationOptions): void;
12
+ //# sourceMappingURL=htmlPathname.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"htmlPathname.d.ts","sourceRoot":"","sources":["../../src/utils/htmlPathname.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,EAAE,aAAqB,EAAE,GAAE,2BAAgC,GAC1D,MAAM,CA6BR;AAED,2FAA2F;AAC3F,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,OAAO,GAAE,2BAAgC,GACxC,IAAI,CAaN"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * 工具类集合导出
3
+ */
4
+ export { CacheManager } from '../cache';
5
+ export { Logger } from '../logger/Logger';
6
+ export { RouteManager } from '../route';
7
+ export { createIsrPlugin, createIsrCacheHandler } from '../plugin';
8
+ export * from './CacheCleanup';
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACnE,cAAc,gBAAgB,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { FetchHandler } from '../ssg/spider';
2
+ /** Resolve the built RSC module once, retaining the selected export's receiver. */
3
+ export declare function resolveFetchHandler(module: unknown): FetchHandler;
4
+ //# sourceMappingURL=resolveFetchHandler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveFetchHandler.d.ts","sourceRoot":"","sources":["../../src/utils/resolveFetchHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAejE"}
@@ -0,0 +1,3 @@
1
+ /** Remove only the trailing slash run; each character is inspected at most once. */
2
+ export declare function trimTrailingSlashes(value: string): string;
3
+ //# sourceMappingURL=trimTrailingSlashes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trimTrailingSlashes.d.ts","sourceRoot":"","sources":["../../src/utils/trimTrailingSlashes.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD"}
package/package.json CHANGED
@@ -1,6 +1,202 @@
1
1
  {
2
2
  "name": "isr-engine",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.0.0",
4
+ "description": "ISR/SSG/Fallback rendering orchestration on Vite + React 19 RSC.",
5
+ "license": "UNLICENSED",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/novel-isr/isr-engine.git"
9
+ },
10
+ "homepage": "https://github.com/novel-isr/isr-engine",
11
+ "bugs": "https://github.com/novel-isr/isr-engine/issues",
12
+ "publishConfig": {
13
+ "access": "public",
14
+ "registry": "https://registry.npmjs.org/"
15
+ },
16
+ "type": "module",
17
+ "main": "./dist/isr-engine.cjs",
18
+ "module": "./dist/isr-engine.js",
19
+ "types": "./dist/index.d.ts",
20
+ "bin": {
21
+ "isr-engine": "./dist/cli/cli.js"
22
+ },
23
+ "files": [
24
+ "dist",
25
+ "src/context",
26
+ "src/defaults",
27
+ "src/runtime",
28
+ "src/types",
29
+ "src/utils",
30
+ "!src/**/__tests__/**",
31
+ "!src/**/*.test.*",
32
+ "!src/**/*.spec.*",
33
+ "README.md",
34
+ "CHANGELOG.md"
35
+ ],
36
+ "exports": {
37
+ ".": {
38
+ "import": "./dist/isr-engine.js",
39
+ "require": "./dist/isr-engine.cjs",
40
+ "types": "./dist/index.d.ts"
41
+ },
42
+ "./rsc": {
43
+ "browser": "./dist/rsc/browser.js",
44
+ "import": "./dist/rsc/index.js",
45
+ "require": "./dist/rsc/index.cjs",
46
+ "types": "./dist/rsc/index.d.ts"
47
+ },
48
+ "./server-entry": {
49
+ "default": "./src/defaults/runtime/defineServerEntry.tsx"
50
+ },
51
+ "./client-entry": {
52
+ "default": "./src/defaults/runtime/defineClientEntry.tsx"
53
+ },
54
+ "./auto-observability": {
55
+ "types": "./dist/defaults/auto-observability.d.ts",
56
+ "import": "./dist/defaults/auto-observability.js",
57
+ "require": "./dist/defaults/auto-observability.cjs"
58
+ },
59
+ "./site-hooks": {
60
+ "types": "./dist/defaults/runtime/defineSiteHooks.d.ts",
61
+ "import": "./dist/defaults/runtime/defineSiteHooks.js",
62
+ "require": "./dist/defaults/runtime/defineSiteHooks.cjs"
63
+ },
64
+ "./config": {
65
+ "types": "./dist/config/defineConfig.d.ts",
66
+ "import": "./dist/config/defineConfig.js",
67
+ "require": "./dist/config/defineConfig.cjs"
68
+ },
69
+ "./adapters/observability": {
70
+ "import": "./dist/adapters/observability/index.js",
71
+ "require": "./dist/adapters/observability/index.cjs",
72
+ "types": "./dist/adapters/observability/index.d.ts"
73
+ },
74
+ "./adapters/runtime": {
75
+ "import": "./dist/adapters/runtime/index.js",
76
+ "require": "./dist/adapters/runtime/index.cjs",
77
+ "types": "./dist/adapters/runtime/index.d.ts"
78
+ },
79
+ "./image": {
80
+ "import": "./dist/image/index.js",
81
+ "require": "./dist/image/index.cjs",
82
+ "types": "./dist/runtime/Image.d.ts"
83
+ },
84
+ "./runtime": {
85
+ "types": "./dist/runtime/index.d.ts",
86
+ "default": "./src/runtime/index.ts"
87
+ },
88
+ "./package.json": "./package.json"
89
+ },
90
+ "scripts": {
91
+ "build": "vite build && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && chmod +x dist/cli/cli.js dist/cli/cli.cjs",
92
+ "watch": "vite build --watch",
93
+ "clean": "rimraf dist",
94
+ "lint": "eslint . --ext .ts,.tsx,.js,.jsx",
95
+ "lint:fix": "eslint . --ext .ts,.tsx,.js,.jsx --fix",
96
+ "format": "prettier --write .",
97
+ "type-check": "tsc --noEmit",
98
+ "test": "vitest run",
99
+ "pretest:browser": "pnpm run build",
100
+ "test:browser:production": "pnpm run build && playwright test --config playwright.production.config.ts",
101
+ "test:browser": "playwright test e2e/dev-css-lifecycle/dev-css-lifecycle.spec.ts",
102
+ "bench": "node bench/runner.mjs",
103
+ "check": "pnpm run type-check && pnpm run lint && pnpm run test",
104
+ "audit:security": "pnpm audit --registry=https://registry.npmjs.org --audit-level=low",
105
+ "prepublishOnly": "pnpm run audit:security",
106
+ "release": "semantic-release",
107
+ "prepare": "husky",
108
+ "test:package": "node scripts/check-package-exports.mjs",
109
+ "test:package:installed": "node scripts/check-installed-package.mjs",
110
+ "test:workers": "tsc --noEmit -p scripts/fixtures/tsconfig.json && node scripts/check-workers-runtime.mjs",
111
+ "test:release": "node scripts/check-release.mjs"
112
+ },
113
+ "engines": {
114
+ "node": ">=24.15.0"
115
+ },
116
+ "packageManager": "pnpm@9.15.9",
117
+ "dependencies": {
118
+ "@vitejs/plugin-rsc": "0.5.34",
119
+ "chalk": "^5.3.0",
120
+ "commander": "^12.1.0",
121
+ "compression": "^1.8.2",
122
+ "css-tree": "^3.2.1",
123
+ "esbuild": "^0.28.2",
124
+ "express": "^5.3.0",
125
+ "helmet": "^7.1.0",
126
+ "ipaddr.js": "^2.5.0",
127
+ "lru-cache": "^10.4.3",
128
+ "ora": "^8.1.0",
129
+ "parse5": "^8.0.1",
130
+ "prom-client": "^15.1.3",
131
+ "sharp": "^0.35.5",
132
+ "sitemap": "^8.0.0",
133
+ "typescript": "^5.6.2"
134
+ },
135
+ "peerDependencies": {
136
+ "react": "19.3.0-canary-bd6ea412-20260824",
137
+ "react-dom": "19.3.0-canary-bd6ea412-20260824",
138
+ "react-server-dom-webpack": "19.3.0-canary-bd6ea412-20260824",
139
+ "rsc-html-stream": "^0.0.7",
140
+ "vite": "8.1.6"
141
+ },
142
+ "optionalDependencies": {
143
+ "ioredis": "^5.4.1"
144
+ },
145
+ "devDependencies": {
146
+ "@eslint/js": "^9.15.0",
147
+ "@playwright/test": "^1.62.1",
148
+ "@semantic-release/commit-analyzer": "13.0.1",
149
+ "@semantic-release/exec": "7.1.0",
150
+ "@semantic-release/npm": "13.2.0",
151
+ "@semantic-release/release-notes-generator": "14.1.1",
152
+ "@types/compression": "^1.7.5",
153
+ "@types/css-tree": "^3.2.0",
154
+ "@types/express": "^5.0.0",
155
+ "@types/ioredis-mock": "^8.2.5",
156
+ "@types/node": "^22.7.4",
157
+ "@types/react": "^19.2.15",
158
+ "@types/react-dom": "^19.0.0",
159
+ "@typescript-eslint/eslint-plugin": "^8.72.1",
160
+ "@typescript-eslint/parser": "^8.72.1",
161
+ "@vitest/coverage-v8": "^4.1.12",
162
+ "autocannon": "^8.0.0",
163
+ "eslint": "^9.15.0",
164
+ "eslint-config-prettier": "^9.1.0",
165
+ "eslint-plugin-prettier": "^5.5.6",
166
+ "eslint-plugin-react": "^7.37.2",
167
+ "eslint-plugin-react-hooks": "^5.0.0",
168
+ "globals": "^15.9.0",
169
+ "happy-dom": "^21.0.4",
170
+ "husky": "^9.1.7",
171
+ "ioredis-mock": "^8.9.0",
172
+ "jsdom": "^29.1.1",
173
+ "miniflare": "4.20260730.0",
174
+ "prettier": "^3.3.3",
175
+ "react": "19.3.0-canary-bd6ea412-20260824",
176
+ "react-dom": "19.3.0-canary-bd6ea412-20260824",
177
+ "react-server-dom-webpack": "19.3.0-canary-bd6ea412-20260824",
178
+ "rimraf": "^6.1.4",
179
+ "rsc-html-stream": "^0.0.7",
180
+ "sass-embedded": "^1.79.4",
181
+ "semantic-release": "25.0.9",
182
+ "tsc-alias": "^1.8.17",
183
+ "vite": "8.1.6",
184
+ "vitest": "^4.1.12"
185
+ },
186
+ "pnpm": {
187
+ "overrides": {
188
+ "miniflare>sharp": "0.35.5",
189
+ "hyperid": "4.0.0",
190
+ "fast-uri": "3.1.9",
191
+ "minimatch@3.1.5>brace-expansion": "1.1.21",
192
+ "qs": "6.17.1",
193
+ "tmp": "0.2.7",
194
+ "ws": "8.21.0",
195
+ "proxy-addr": "2.0.8",
196
+ "undici@7": "7.30.2",
197
+ "js-yaml@4": "4.3.2",
198
+ "form-data@4": "4.0.6",
199
+ "@typescript-eslint/typescript-estree@8.72.1>minimatch": "11.0.5"
200
+ }
201
+ }
202
+ }
@@ -0,0 +1,68 @@
1
+ import { AsyncLocalStorage } from 'async_hooks';
2
+ import type { ISRContextData } from '../types/ISRContext';
3
+
4
+ // 复用 ISRContextData 类型,确保 ALS 中的数据结构与 ISRContext.data 一致
5
+ export type RequestContextState = ISRContextData;
6
+
7
+ const REQUEST_CONTEXT_KEY = '__ISR_ENGINE_REQUEST_CONTEXT__';
8
+
9
+ function getGlobalRequestContext(): AsyncLocalStorage<RequestContextState> {
10
+ const globalState = globalThis as typeof globalThis & {
11
+ [REQUEST_CONTEXT_KEY]?: AsyncLocalStorage<RequestContextState>;
12
+ };
13
+
14
+ globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage<RequestContextState>();
15
+ return globalState[REQUEST_CONTEXT_KEY];
16
+ }
17
+
18
+ // 全局 ALS 实例。dev 下 source/dist 可能同时被 Vite 加载,必须共享同一份请求上下文。
19
+ export const requestContext = getGlobalRequestContext();
20
+
21
+ // 获取当前请求上下文的辅助函数
22
+ export const getRequestContext = (): RequestContextState | undefined => {
23
+ return requestContext.getStore();
24
+ };
25
+
26
+ // 获取 Trace ID 的辅助函数 (安全访问)
27
+ export const getTraceId = (): string => {
28
+ const store = requestContext.getStore();
29
+ return store?.traceId || 'system';
30
+ };
31
+
32
+ // 获取 Request ID 的辅助函数 (安全访问)
33
+ export const getRequestId = (): string => {
34
+ const store = requestContext.getStore();
35
+ return store?.requestId || 'unknown';
36
+ };
37
+
38
+ /**
39
+ * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。
40
+ *
41
+ * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值
42
+ * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。
43
+ * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。
44
+ */
45
+ export const getAnonId = (): string => {
46
+ const store = requestContext.getStore();
47
+ return store?.anonId || 'system';
48
+ };
49
+
50
+ /**
51
+ * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。
52
+ * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远
53
+ * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。
54
+ */
55
+ export const getUserId = (): string | null => {
56
+ const store = requestContext.getStore();
57
+ return store?.userId ?? null;
58
+ };
59
+
60
+ /**
61
+ * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。
62
+ * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。
63
+ * 没接 ABVariantMiddleware 时返回空对象。
64
+ */
65
+ export const getExperiments = (): Record<string, string> => {
66
+ const store = requestContext.getStore();
67
+ return store?.experiments ?? {};
68
+ };
@@ -0,0 +1,104 @@
1
+ /**
2
+ * createServerRequestContext —— engine 入口处构造 RequestContext 的统一工厂。
3
+ *
4
+ * 两个入口(cli/start.ts production server + server/manager.ts dev/programmatic)
5
+ * 都通过这里构造 ctx,保证:
6
+ * - traceId / requestId / anonId 三个 ID 的生成逻辑只有一份
7
+ * - anonId 缺失时的 Set-Cookie 落点只有一处
8
+ * - cookies map 解析、X-Request-Id 解析、W3C traceparent 解析的优先级一致
9
+ *
10
+ * 出参 needsAnonCookie:调用方据此在 res 上 appendHeader('Set-Cookie', ...)。
11
+ * 必须在 cache lookup 之前 set,但 cache 层会把 anon 这一条从 captured.headers 里
12
+ * 剥掉再入缓存(见 plugin/isrCacheMiddleware.ts),保证缓存内容 user-agnostic。
13
+ */
14
+ import { randomUUID } from 'node:crypto';
15
+ import type { IncomingMessage, ServerResponse } from 'node:http';
16
+ import type { ISRContextData } from '../types/ISRContext';
17
+ import { parseCookieHeader } from '../utils/cookie';
18
+
19
+ /** anonId cookie 名称 —— engine 全局常量,避免散落字符串。 */
20
+ export const ANON_COOKIE_NAME = 'anon';
21
+
22
+ /** anonId cookie 有效期(秒)。1 年;浏览器侧最大也只能撑到这个量级。 */
23
+ export const ANON_COOKIE_MAX_AGE_SECONDS = 365 * 24 * 60 * 60;
24
+
25
+ export interface CreatedRequestContext {
26
+ /** 直接喂给 requestContext.run() 的 ISRContextData 实例 */
27
+ data: ISRContextData;
28
+ /** true 表示 anonId 是本次新生成的,调用方需要把 Set-Cookie 写到响应头 */
29
+ needsAnonCookie: boolean;
30
+ }
31
+
32
+ /**
33
+ * 从 IncomingMessage 构造 ISRContextData。
34
+ *
35
+ * 优先级:
36
+ * - traceId: W3C traceparent header → 自生成 UUID
37
+ * - requestId: X-Request-Id header → 自生成 UUID
38
+ * - anonId: cookie `anon` → 自生成 UUID(needsAnonCookie=true)
39
+ *
40
+ * userId / sessionToken / sessionUser 留空 —— 业务侧 beforeRequest hook 写入。
41
+ */
42
+ export function createServerRequestContext(req: IncomingMessage): CreatedRequestContext {
43
+ const rawCookie = req.headers['cookie'];
44
+ const cookieHeader = Array.isArray(rawCookie)
45
+ ? rawCookie.join('; ')
46
+ : typeof rawCookie === 'string'
47
+ ? rawCookie
48
+ : '';
49
+ const cookies = parseCookieHeader(cookieHeader);
50
+
51
+ const headerReqId = req.headers['x-request-id'];
52
+ const headerTraceparent = req.headers['traceparent'];
53
+
54
+ const existingAnon = cookies[ANON_COOKIE_NAME];
55
+ const anonId = existingAnon || randomUUID();
56
+ const needsAnonCookie = !existingAnon;
57
+
58
+ // 把新生成的 anonId 回填进 cookies map —— 让本次请求里下游 middleware
59
+ // (AB / SEO / telemetry 等)能从同一来源读到,行为跟"cookie 已存在的请求"一致
60
+ if (needsAnonCookie) {
61
+ cookies[ANON_COOKIE_NAME] = anonId;
62
+ }
63
+
64
+ return {
65
+ data: {
66
+ traceId:
67
+ typeof headerTraceparent === 'string' && headerTraceparent
68
+ ? headerTraceparent
69
+ : randomUUID(),
70
+ requestId: typeof headerReqId === 'string' && headerReqId ? headerReqId : randomUUID(),
71
+ anonId,
72
+ cookies,
73
+ },
74
+ needsAnonCookie,
75
+ };
76
+ }
77
+
78
+ /**
79
+ * 把 anonId Set-Cookie 头写进响应。
80
+ *
81
+ * Set-Cookie 写在 cache lookup 之前(live 响应 client 必收到),但 cache 层
82
+ * 在 captureAndStore 里会从存储的 headers 里剥掉 anon 这条 —— cache entry 永远
83
+ * user-agnostic,可以被多个 anonId 命中(cache key 走 ctx.experiments digest 隔离)。
84
+ *
85
+ * 参数:HttpOnly=false 让客户端 SDK 能读取做曝光上报;SameSite=Lax 让 GET 请求
86
+ * 跨站跳转也带(搜索引擎结果点击进来不会丢 anonId);Path=/ 全站共享。
87
+ * Secure 不强制 —— dev http 也要工作;生产 HTTPS 由 reverse proxy 自动加 Secure 标记
88
+ * 不在 engine 侧加。
89
+ *
90
+ * @param cookieDomain 可选 `Domain` 属性。子域分发部署(www.x / admin.x / api.x)
91
+ * 时设 `.your-domain.com`,让浏览器把 anon cookie 自动带到所有子域 ——
92
+ * SSR 在 www 写、admin-server 在 api 读、客户端 SDK 在 www 读,都能拿到。
93
+ * 单一域名部署时留空,浏览器只把 cookie 关联到当前 host。
94
+ */
95
+ export function applyAnonCookie(res: ServerResponse, anonId: string, cookieDomain?: string): void {
96
+ const parts = [
97
+ `${ANON_COOKIE_NAME}=${anonId}`,
98
+ `Max-Age=${ANON_COOKIE_MAX_AGE_SECONDS}`,
99
+ 'Path=/',
100
+ 'SameSite=Lax',
101
+ ];
102
+ if (cookieDomain) parts.push(`Domain=${cookieDomain}`);
103
+ res.appendHeader('Set-Cookie', parts.join('; '));
104
+ }
@@ -0,0 +1,195 @@
1
+ /**
2
+ * 环境变量驱动的 SDK 自动装配
3
+ *
4
+ * 用户态:什么都不做。明确开启后才接第三方 vendor,没开则跳过。
5
+ *
6
+ * .env
7
+ * SENTRY_ENABLED=true
8
+ * SENTRY_DSN=https://xxx@sentry.io/123 → 自动接 Sentry 服务端
9
+ * DD_SERVICE=my-app → 自动接 Datadog(要求 dd-trace 已安装)
10
+ * OTEL_EXPORTER_OTLP_ENDPOINT=http://... → 自动接 OTel(要求 @opentelemetry/* 已安装)
11
+ *
12
+ * 设计:SDK 都是 dynamic import;用户没装就静默跳过(不阻塞启动)。
13
+ * 多个 vendor 同时配置时采用 fan-out:Sentry / Datadog / OTel 都会执行,
14
+ * 任意一个 vendor 抛错都不能阻断其它 vendor、endpoint 上报或业务 hooks。
15
+ */
16
+ // 不引 Logger(它的 alias 在用户 RSC 上下文不解析);用 console.* 直出
17
+ const logger = {
18
+ info: (...a: unknown[]) => console.log('[isr-engine:auto-obs]', ...a),
19
+ warn: (...a: unknown[]) => console.warn('[isr-engine:auto-obs]', ...a),
20
+ };
21
+
22
+ /**
23
+ * 用 Function 构造器隐藏 import specifier,绕过 rolldown 静态分析
24
+ * —— 这样 SDK 不会被强制解析,用户没装时不会失败构建
25
+ */
26
+ const dynamicImport = new Function('m', 'return import(m)') as (m: string) => Promise<unknown>;
27
+ async function tryImport(name: string): Promise<unknown> {
28
+ return await dynamicImport(name);
29
+ }
30
+
31
+ export interface AutoServerCtx {
32
+ traceId: string;
33
+ startedAt: number;
34
+ [key: string]: unknown;
35
+ }
36
+
37
+ export interface AutoServerHooks {
38
+ beforeRequest?: (
39
+ req: Request,
40
+ baseline: { traceId: string; startedAt: number }
41
+ ) => Record<string, unknown> | Promise<Record<string, unknown>>;
42
+ onResponse?: (res: Response, ctx: AutoServerCtx) => void;
43
+ onError?: (err: unknown, req: Request, ctx: AutoServerCtx) => void;
44
+ }
45
+
46
+ /**
47
+ * 检测 env 自动选 SDK 装配
48
+ * 调用顺序:在 entry.server 加载前后都行;推荐启动时调一次返回的 hooks 用作默认 hooks
49
+ */
50
+ export async function createAutoServerHooks(): Promise<AutoServerHooks> {
51
+ const sentryDsn = resolveSentryDsnFromEnv(process.env);
52
+ const ddService = process.env.DD_SERVICE;
53
+ const otelEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
54
+
55
+ const hooks: AutoServerHooks[] = [];
56
+ if (sentryDsn) hooks.push(await loadSentry(sentryDsn));
57
+ if (ddService) hooks.push(await loadDatadog(ddService));
58
+ if (otelEndpoint) hooks.push(await loadOtel(otelEndpoint));
59
+
60
+ const activeHooks = hooks.filter(hasAnyHook);
61
+ if (activeHooks.length > 0) return composeAutoServerHooks(activeHooks);
62
+
63
+ logger.info(
64
+ '🛰️ telemetry: 未检测到启用的 Sentry/DD_SERVICE/OTEL_EXPORTER_OTLP_ENDPOINT,跳过第三方服务端 adapter'
65
+ );
66
+ return {};
67
+ }
68
+
69
+ export function resolveSentryDsnFromEnv(
70
+ env: Record<string, string | undefined>
71
+ ): string | undefined {
72
+ if (!isTruthyEnv(env.SENTRY_ENABLED)) return undefined;
73
+ const dsn = env.SENTRY_DSN?.trim();
74
+ return dsn || undefined;
75
+ }
76
+
77
+ function isTruthyEnv(value: string | undefined): boolean {
78
+ if (!value) return false;
79
+ return value === '1' || value.toLowerCase() === 'true';
80
+ }
81
+
82
+ export function composeAutoServerHooks(hooks: readonly AutoServerHooks[]): AutoServerHooks {
83
+ const activeHooks = hooks.filter(hasAnyHook);
84
+ if (activeHooks.length === 0) return {};
85
+
86
+ return {
87
+ async beforeRequest(req, baseline) {
88
+ const merged: Record<string, unknown> = {};
89
+ for (const hook of activeHooks) {
90
+ if (!hook.beforeRequest) continue;
91
+ try {
92
+ Object.assign(merged, (await hook.beforeRequest(req, baseline)) ?? {});
93
+ } catch (err) {
94
+ logger.warn('🛰️ observability beforeRequest vendor hook failed', err);
95
+ }
96
+ }
97
+ return merged;
98
+ },
99
+ onResponse(res, ctx) {
100
+ for (const hook of activeHooks) {
101
+ if (!hook.onResponse) continue;
102
+ try {
103
+ hook.onResponse(res, ctx);
104
+ } catch (err) {
105
+ logger.warn('🛰️ observability onResponse vendor hook failed', err);
106
+ }
107
+ }
108
+ },
109
+ onError(err, req, ctx) {
110
+ for (const hook of activeHooks) {
111
+ if (!hook.onError) continue;
112
+ try {
113
+ hook.onError(err, req, ctx);
114
+ } catch (vendorErr) {
115
+ logger.warn('🛰️ observability onError vendor hook failed', vendorErr);
116
+ }
117
+ }
118
+ },
119
+ };
120
+ }
121
+
122
+ function hasAnyHook(hook: AutoServerHooks): boolean {
123
+ return !!(hook.beforeRequest || hook.onResponse || hook.onError);
124
+ }
125
+
126
+ /**
127
+ * 走 npm subpath import 而不是相对路径:
128
+ * - 本文件是 raw-shipped src/,被 consumer bundler 当源码处理
129
+ * - 三个 hook factory 在 dist/ 里通过 `./adapters/observability` 子路径已公开 export
130
+ * - 用 subpath 既避免相对路径依赖(src/adapters/* 不在 npm tarball 里),也复用编译产物
131
+ */
132
+ type ObservabilityAdapters = typeof import('isr-engine/adapters/observability');
133
+
134
+ async function loadObservability(): Promise<ObservabilityAdapters> {
135
+ return (await import('isr-engine/adapters/observability')) as ObservabilityAdapters;
136
+ }
137
+
138
+ async function loadSentry(dsn: string): Promise<AutoServerHooks> {
139
+ try {
140
+ const Sentry = (await tryImport('@sentry/node')) as {
141
+ init: (opts: Record<string, unknown>) => void;
142
+ startInactiveSpan: (opts: Record<string, unknown>) => unknown;
143
+ captureException: (err: unknown, hint?: Record<string, unknown>) => void;
144
+ };
145
+ Sentry.init({
146
+ dsn,
147
+ tracesSampleRate: parseFloat(process.env.SENTRY_TRACES_SAMPLE_RATE ?? '0.1'),
148
+ environment: process.env.SENTRY_ENVIRONMENT ?? process.env.NODE_ENV ?? 'production',
149
+ });
150
+ const { createSentryServerHooks } = await loadObservability();
151
+ logger.info(`🛰️ telemetry: Sentry auto-wired (DSN ${dsn.replace(/\/\/[^@]+@/, '//<key>@')})`);
152
+ return createSentryServerHooks({
153
+ Sentry: Sentry as unknown as Parameters<typeof createSentryServerHooks>[0]['Sentry'],
154
+ }) as AutoServerHooks;
155
+ } catch (err) {
156
+ logger.warn('🛰️ Sentry auto-wire 失败(@sentry/node 未安装?)→ 走默认上报', err);
157
+ return {};
158
+ }
159
+ }
160
+
161
+ async function loadDatadog(service: string): Promise<AutoServerHooks> {
162
+ try {
163
+ const tracerMod = (await tryImport('dd-trace')) as {
164
+ default: { init: (opts: Record<string, unknown>) => unknown };
165
+ };
166
+ const { createDatadogServerHooks } = await loadObservability();
167
+ const tracer = tracerMod.default.init({
168
+ service,
169
+ env: process.env.DD_ENV ?? process.env.NODE_ENV,
170
+ version: process.env.DD_VERSION,
171
+ }) as Parameters<typeof createDatadogServerHooks>[0]['tracer'];
172
+ logger.info(`🛰️ telemetry: Datadog auto-wired (service=${service})`);
173
+ return createDatadogServerHooks({ tracer }) as AutoServerHooks;
174
+ } catch (err) {
175
+ logger.warn('🛰️ Datadog auto-wire 失败(dd-trace 未安装?)', err);
176
+ return {};
177
+ }
178
+ }
179
+
180
+ async function loadOtel(endpoint: string): Promise<AutoServerHooks> {
181
+ try {
182
+ const { createOtelServerHooks } = await loadObservability();
183
+ const otelApi = (await tryImport('@opentelemetry/api')) as {
184
+ trace: {
185
+ getTracer: (name: string) => Parameters<typeof createOtelServerHooks>[0]['tracer'];
186
+ };
187
+ };
188
+ const tracer = otelApi.trace.getTracer(process.env.OTEL_SERVICE_NAME ?? 'isr-engine-app');
189
+ logger.info(`🛰️ telemetry: OTel auto-wired (endpoint=${endpoint})`);
190
+ return createOtelServerHooks({ tracer }) as AutoServerHooks;
191
+ } catch (err) {
192
+ logger.warn('🛰️ OTel auto-wire 失败(@opentelemetry/api 未安装?)', err);
193
+ return {};
194
+ }
195
+ }