isr-engine 0.0.0-stage → 1.0.1

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 +170 -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-DGSjHQJd.cjs +105 -0
  100. package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs.map +1 -0
  101. package/dist/createCacheInspectorMiddleware-Dmuobpcb.js +105 -0
  102. package/dist/createCacheInspectorMiddleware-Dmuobpcb.js.map +1 -0
  103. package/dist/createISRApp-CDkyUuW3.js +7321 -0
  104. package/dist/createISRApp-CDkyUuW3.js.map +1 -0
  105. package/dist/createISRApp-Nv9mwX8I.cjs +7662 -0
  106. package/dist/createISRApp-Nv9mwX8I.cjs.map +1 -0
  107. package/dist/createImagePlugin-BVUPlPOz.js +416 -0
  108. package/dist/createImagePlugin-BVUPlPOz.js.map +1 -0
  109. package/dist/createImagePlugin-D-X_HGlR.cjs +435 -0
  110. package/dist/createImagePlugin-D-X_HGlR.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 +199 -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 +837 -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 +41 -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 +507 -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 +17 -0
  452. package/src/utils/trimTrailingSlashes.ts +6 -0
package/README.md CHANGED
@@ -1,3 +1,171 @@
1
- # Temporary Holding Version
1
+ # isr-engine
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 基于 Vite 与 React Server Components 的页面渲染编排层,提供按路由配置的 ISR、SSG、SSR、缓存失效和渲染失败恢复。Flight 编译与传输由 `@vitejs/plugin-rsc` 处理。
4
+
5
+ ## 运行要求与安装
6
+
7
+ - Node.js **24.15.0**;仓库使用 pnpm 9.15.9。
8
+ - Vite **8.1.6**;内置 `@vitejs/plugin-rsc` **0.5.34**,无需额外注册 React 插件。
9
+ - `react`、`react-dom`、`react-server-dom-webpack` 必须同为 **19.3.0-canary-bd6ea412-20260824**。当前支持该精确 canary 组合。
10
+ - `rsc-html-stream` peer 范围为 `^0.0.7`,仓库锁定版本为 **0.0.7**。
11
+
12
+ 在应用目录安装公共 npm 包及其 peer 依赖:
13
+
14
+ ```bash
15
+ npm install isr-engine --registry=https://registry.npmjs.org/
16
+ npm install --save-exact \
17
+ react@19.3.0-canary-bd6ea412-20260824 \
18
+ react-dom@19.3.0-canary-bd6ea412-20260824 \
19
+ react-server-dom-webpack@19.3.0-canary-bd6ea412-20260824 \
20
+ rsc-html-stream@0.0.7
21
+ npm install --save-dev --save-exact vite@8.1.6 typescript@5.9.3 \
22
+ @types/node@24.19.2 @types/react@19.2.15 @types/react-dom@19.2.3
23
+ ```
24
+
25
+ 应用 `package.json` 设置 `"type": "module"`,并保留锁文件以复现依赖组合。
26
+
27
+ ## 最小应用
28
+
29
+ `vite.config.ts`:
30
+
31
+ ```ts
32
+ import { defineConfig } from 'vite';
33
+ import { createIsrPlugin } from 'isr-engine';
34
+
35
+ export default defineConfig({ plugins: [...createIsrPlugin()] });
36
+ ```
37
+
38
+ `src/app.tsx` 是应用根 Server Component,必须命名导出 `App`。交互组件单独使用 `'use client'`:
39
+
40
+ ```tsx
41
+ import { cacheTag } from 'isr-engine/rsc';
42
+
43
+ export function App({ url }: { url: URL }) {
44
+ cacheTag('site-content');
45
+ return (
46
+ <html lang="zh-CN">
47
+ <head><meta charSet="utf-8" /><title>My site</title></head>
48
+ <body><main><h1>{url.pathname}</h1></main></body>
49
+ </html>
50
+ );
51
+ }
52
+ ```
53
+
54
+ 项目根目录的 `ssr.config.ts` 声明渲染策略与部署配置:
55
+
56
+ ```ts
57
+ import { defineIsrConfig } from 'isr-engine/config';
58
+
59
+ export default defineIsrConfig({
60
+ renderMode: 'isr',
61
+ revalidate: 60,
62
+ routes: {
63
+ '/': { mode: 'isr', ttl: 60, staleWhileRevalidate: 300 },
64
+ '/about': 'ssg',
65
+ '/account/*': 'ssr',
66
+ },
67
+ runtime: {
68
+ site: process.env.SITE_URL ?? 'http://localhost:3000',
69
+ services: { api: undefined, telemetry: undefined },
70
+ redis: process.env.REDIS_URL ? {
71
+ url: process.env.REDIS_URL,
72
+ host: undefined, port: undefined, password: undefined,
73
+ keyPrefix: 'my-site:', invalidationChannel: 'my-site:invalidate',
74
+ } : undefined,
75
+ experiments: {},
76
+ i18n: undefined, seo: undefined, telemetry: false,
77
+ },
78
+ server: {
79
+ port: Number(process.env.PORT ?? 3000),
80
+ host: process.env.HOST,
81
+ strictPort: process.env.NODE_ENV === 'production',
82
+ ops: {
83
+ authToken: process.env.ISR_OPS_TOKEN,
84
+ tokenHeader: 'x-isr-admin-token',
85
+ health: { enabled: true, public: true },
86
+ metrics: { enabled: process.env.ENABLE_METRICS === '1', public: false },
87
+ inventory: { enabled: true, public: false },
88
+ },
89
+ },
90
+ ssg: {
91
+ routes: ['/about'], concurrent: 3,
92
+ requestTimeoutMs: 30_000, maxRetries: 3,
93
+ retryBaseDelayMs: 200, failBuildThreshold: 0.05,
94
+ },
95
+ });
96
+ ```
97
+
98
+ `package.json` 脚本:
99
+
100
+ ```json
101
+ {
102
+ "scripts": {
103
+ "dev": "isr-engine dev",
104
+ "build": "vite build",
105
+ "start": "isr-engine start"
106
+ }
107
+ }
108
+ ```
109
+
110
+ ```bash
111
+ npm run dev # 默认 http://localhost:3000
112
+ npm run build # 构建 RSC/SSR/client,并预渲染 SSG 路由
113
+ NODE_ENV=production npm run start # 从应用根目录启动生产服务
114
+ ```
115
+
116
+ `dev`、`start` 接受 `--port <port>` 和 `--host <host>`,显式参数覆盖配置。`dev --no-open` 关闭自动打开浏览器。构建和启动生产进程时通过运行环境设置 `NODE_ENV`,避免 `.env*` 中的 `NODE_ENV=development` 影响生产构建。
117
+
118
+ ## 渲染与生产缓存
119
+
120
+ | 模式 | 行为 |
121
+ | --- | --- |
122
+ | `isr` | 按 TTL 缓存;SWR 窗口内返回旧响应并后台重渲,窗口结束后重新生成。 |
123
+ | `ssg` | 构建时预生成配置的路由;运行时仍受缓存新鲜度与失效策略管理。 |
124
+ | `ssr` | 每次请求渲染,跳过共享页面缓存。 |
125
+
126
+ TTL 与 SWR 单位为秒。`routes` 控制渲染策略;页面路由可使用 `isr-engine/runtime` 的 `defineRoutes` 统一声明。渲染异常的 `csr-shell` 是自动恢复策略;origin 进程不可用时的切换需在反向代理/CDN 配置。
127
+
128
+ - 未配置 `runtime.redis.url/host` 时使用进程内存缓存,重启即清空,各实例独立。
129
+ - 显式配置 Redis 后启用远端版本校验和跨实例失效广播,需保留可选依赖 `ioredis`;Redis 连接只读取配置,须如示例显式接入环境变量。多实例共享相同应用的前缀与频道,不同应用/环境使用独立命名空间。
130
+ - 登录态、权限相关或个性化页面应配置为 `ssr`,并在业务层验证身份。请求 hooks 与缓存标签不提供访问控制,也不会自动按用户隔离页面。
131
+ - 授权头、普通业务 Cookie,以及 `private`/`no-store` 等响应会触发缓存保护;不要依赖这些保护代替路由策略。`anon` 与实验 Cookie 有专门的共享缓存规则。
132
+ - Server Component 使用 `cacheTag('site-content')` 声明依赖;数据更新成功后,在受业务鉴权保护的服务端代码中 `await revalidateTag('site-content')` 或 `await revalidatePath('/about')`,从 `isr-engine/rsc` 导入。
133
+
134
+ 请求期扩展可放在可选的 `src/entry.server.tsx`,默认导出 `defineAdminSiteHooks({ beforeRequest, onError })`(从 `isr-engine/site-hooks` 导入)。部署配置留在 `ssr.config.ts`;Server Component 用 `getRequestContext()` 读取 hooks 注入的上下文。
135
+
136
+ ## 运维与部署
137
+
138
+ 部署保留完整 `dist/`、应用依赖及 `ssr.config.*`;配置编译需要应用根目录可写的 `.isr-cache/`。容器按需设置 `HOST=0.0.0.0`,反向代理后显式配置 `server.trustProxy` 的可信来源。
139
+
140
+ `/health` 默认公开。生产 `/metrics` 默认关闭;非公开 metrics/inventory 未配置 `server.ops.authToken` 会自动关闭。启用后通过 `Authorization: Bearer <token>` 或配置的 token header 访问;设为 `public: true` 会绕过 token 校验。
141
+
142
+ ```bash
143
+ curl -fsS http://localhost:3000/health
144
+ curl -fsS -H "x-isr-admin-token: $ISR_OPS_TOKEN" \
145
+ http://localhost:3000/__isr/cache/inventory
146
+ ```
147
+
148
+ 排查页面时先看 `X-Cache-Status`、`X-Resolved-Mode`、`X-Render-Strategy`。本地代理验证可用 `isr-engine test-fallback-local --help`;生产切换由部署层完成,浏览器恢复仍依赖可用的资源与数据服务。
149
+
150
+ ## 公共入口
151
+
152
+ | 导入路径 | 用途 |
153
+ | --- | --- |
154
+ | `isr-engine` | Vite 插件、Node 编排 API 与公共类型。 |
155
+ | `isr-engine/config` | `defineIsrConfig`、`defineRuntimeConfig`。 |
156
+ | `isr-engine/rsc` | 缓存标签、失效、服务端请求上下文。 |
157
+ | `isr-engine/runtime` | 页面路由、边界、i18n 与浏览器 telemetry。 |
158
+ | `isr-engine/site-hooks` | 请求 hooks 工厂与 Cookie 工具。 |
159
+ | `isr-engine/server-entry`、`isr-engine/client-entry` | 高级入口工厂;由 Vite 转译其源码。 |
160
+ | `isr-engine/image` | 图片组件。 |
161
+ | `isr-engine/auto-observability`、`isr-engine/adapters/observability` | 自动观测与观测适配器。 |
162
+ | `isr-engine/adapters/runtime` | Fetch handler 的平台适配器。 |
163
+ | `isr-engine/package.json` | 包元数据。 |
164
+
165
+ ## 文档与发布
166
+
167
+ 配置字段与默认行为见 [公共配置类型](./src/types/ISRConfig.ts) 和 [默认配置](./src/config/defaults.ts)。
168
+
169
+ `main` 的自动发布流程通过验证后由 semantic-release 计算版本,以 npm OIDC 发布到 `registry.npmjs.org`;配置见 [发布工作流](./.github/workflows/publish.yml) 与 [release.config.mjs](./release.config.mjs)。npm 端需绑定对应仓库和工作流的 Trusted Publisher。
170
+
171
+ 许可证声明为 **UNLICENSED**,以 `package.json` 为准。
@@ -0,0 +1,58 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
2
+ import { AsyncLocalStorage } from "async_hooks";
3
+ //#region src/context/RequestContext.ts
4
+ var RequestContext_exports = /* @__PURE__ */ __exportAll({
5
+ getAnonId: () => getAnonId,
6
+ getExperiments: () => getExperiments,
7
+ getRequestContext: () => getRequestContext,
8
+ getRequestId: () => getRequestId,
9
+ getTraceId: () => getTraceId,
10
+ getUserId: () => getUserId,
11
+ requestContext: () => requestContext
12
+ });
13
+ var REQUEST_CONTEXT_KEY = "__ISR_ENGINE_REQUEST_CONTEXT__";
14
+ function getGlobalRequestContext() {
15
+ const globalState = globalThis;
16
+ globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage();
17
+ return globalState[REQUEST_CONTEXT_KEY];
18
+ }
19
+ var requestContext = getGlobalRequestContext();
20
+ var getRequestContext = () => {
21
+ return requestContext.getStore();
22
+ };
23
+ var getTraceId = () => {
24
+ return requestContext.getStore()?.traceId || "system";
25
+ };
26
+ var getRequestId = () => {
27
+ return requestContext.getStore()?.requestId || "unknown";
28
+ };
29
+ /**
30
+ * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。
31
+ *
32
+ * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值
33
+ * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。
34
+ * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。
35
+ */
36
+ var getAnonId = () => {
37
+ return requestContext.getStore()?.anonId || "system";
38
+ };
39
+ /**
40
+ * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。
41
+ * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远
42
+ * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。
43
+ */
44
+ var getUserId = () => {
45
+ return requestContext.getStore()?.userId ?? null;
46
+ };
47
+ /**
48
+ * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。
49
+ * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。
50
+ * 没接 ABVariantMiddleware 时返回空对象。
51
+ */
52
+ var getExperiments = () => {
53
+ return requestContext.getStore()?.experiments ?? {};
54
+ };
55
+ //#endregion
56
+ export { getRequestId as a, requestContext as c, getRequestContext as i, getAnonId as n, getTraceId as o, getExperiments as r, getUserId as s, RequestContext_exports as t };
57
+
58
+ //# sourceMappingURL=RequestContext-BVQ-rOmV.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RequestContext-BVQ-rOmV.js","names":[],"sources":["../src/context/RequestContext.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'async_hooks';\nimport type { ISRContextData } from '../types/ISRContext';\n\n// 复用 ISRContextData 类型,确保 ALS 中的数据结构与 ISRContext.data 一致\nexport type RequestContextState = ISRContextData;\n\nconst REQUEST_CONTEXT_KEY = '__ISR_ENGINE_REQUEST_CONTEXT__';\n\nfunction getGlobalRequestContext(): AsyncLocalStorage<RequestContextState> {\n const globalState = globalThis as typeof globalThis & {\n [REQUEST_CONTEXT_KEY]?: AsyncLocalStorage<RequestContextState>;\n };\n\n globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage<RequestContextState>();\n return globalState[REQUEST_CONTEXT_KEY];\n}\n\n// 全局 ALS 实例。dev 下 source/dist 可能同时被 Vite 加载,必须共享同一份请求上下文。\nexport const requestContext = getGlobalRequestContext();\n\n// 获取当前请求上下文的辅助函数\nexport const getRequestContext = (): RequestContextState | undefined => {\n return requestContext.getStore();\n};\n\n// 获取 Trace ID 的辅助函数 (安全访问)\nexport const getTraceId = (): string => {\n const store = requestContext.getStore();\n return store?.traceId || 'system';\n};\n\n// 获取 Request ID 的辅助函数 (安全访问)\nexport const getRequestId = (): string => {\n const store = requestContext.getStore();\n return store?.requestId || 'unknown';\n};\n\n/**\n * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。\n *\n * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值\n * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。\n * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。\n */\nexport const getAnonId = (): string => {\n const store = requestContext.getStore();\n return store?.anonId || 'system';\n};\n\n/**\n * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。\n * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远\n * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。\n */\nexport const getUserId = (): string | null => {\n const store = requestContext.getStore();\n return store?.userId ?? null;\n};\n\n/**\n * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。\n * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。\n * 没接 ABVariantMiddleware 时返回空对象。\n */\nexport const getExperiments = (): Record<string, string> => {\n const store = requestContext.getStore();\n return store?.experiments ?? {};\n};\n"],"mappings":";;;;;;;;;;;;AAMA,IAAM,sBAAsB;AAE5B,SAAS,0BAAkE;CACzE,MAAM,cAAc;CAIpB,YAAY,yBAAyB,IAAI,kBAAuC;CAChF,OAAO,YAAY;AACrB;AAGA,IAAa,iBAAiB,wBAAwB;AAGtD,IAAa,0BAA2D;CACtE,OAAO,eAAe,SAAS;AACjC;AAGA,IAAa,mBAA2B;CAEtC,OADc,eAAe,SACtB,CAAA,EAAO,WAAW;AAC3B;AAGA,IAAa,qBAA6B;CAExC,OADc,eAAe,SACtB,CAAA,EAAO,aAAa;AAC7B;;;;;;;;AASA,IAAa,kBAA0B;CAErC,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,kBAAiC;CAE5C,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,uBAA+C;CAE1D,OADc,eAAe,SACtB,CAAA,EAAO,eAAe,CAAC;AAChC"}
@@ -0,0 +1,105 @@
1
+ const require_rolldown_runtime = require("./rolldown-runtime-DakpK96I.cjs");
2
+ let async_hooks = require("async_hooks");
3
+ //#region src/context/RequestContext.ts
4
+ var RequestContext_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
5
+ getAnonId: () => getAnonId,
6
+ getExperiments: () => getExperiments,
7
+ getRequestContext: () => getRequestContext,
8
+ getRequestId: () => getRequestId,
9
+ getTraceId: () => getTraceId,
10
+ getUserId: () => getUserId,
11
+ requestContext: () => requestContext
12
+ });
13
+ var REQUEST_CONTEXT_KEY = "__ISR_ENGINE_REQUEST_CONTEXT__";
14
+ function getGlobalRequestContext() {
15
+ const globalState = globalThis;
16
+ globalState[REQUEST_CONTEXT_KEY] ??= new async_hooks.AsyncLocalStorage();
17
+ return globalState[REQUEST_CONTEXT_KEY];
18
+ }
19
+ var requestContext = getGlobalRequestContext();
20
+ var getRequestContext = () => {
21
+ return requestContext.getStore();
22
+ };
23
+ var getTraceId = () => {
24
+ return requestContext.getStore()?.traceId || "system";
25
+ };
26
+ var getRequestId = () => {
27
+ return requestContext.getStore()?.requestId || "unknown";
28
+ };
29
+ /**
30
+ * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。
31
+ *
32
+ * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值
33
+ * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。
34
+ * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。
35
+ */
36
+ var getAnonId = () => {
37
+ return requestContext.getStore()?.anonId || "system";
38
+ };
39
+ /**
40
+ * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。
41
+ * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远
42
+ * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。
43
+ */
44
+ var getUserId = () => {
45
+ return requestContext.getStore()?.userId ?? null;
46
+ };
47
+ /**
48
+ * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。
49
+ * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。
50
+ * 没接 ABVariantMiddleware 时返回空对象。
51
+ */
52
+ var getExperiments = () => {
53
+ return requestContext.getStore()?.experiments ?? {};
54
+ };
55
+ //#endregion
56
+ Object.defineProperty(exports, "RequestContext_exports", {
57
+ enumerable: true,
58
+ get: function() {
59
+ return RequestContext_exports;
60
+ }
61
+ });
62
+ Object.defineProperty(exports, "getAnonId", {
63
+ enumerable: true,
64
+ get: function() {
65
+ return getAnonId;
66
+ }
67
+ });
68
+ Object.defineProperty(exports, "getExperiments", {
69
+ enumerable: true,
70
+ get: function() {
71
+ return getExperiments;
72
+ }
73
+ });
74
+ Object.defineProperty(exports, "getRequestContext", {
75
+ enumerable: true,
76
+ get: function() {
77
+ return getRequestContext;
78
+ }
79
+ });
80
+ Object.defineProperty(exports, "getRequestId", {
81
+ enumerable: true,
82
+ get: function() {
83
+ return getRequestId;
84
+ }
85
+ });
86
+ Object.defineProperty(exports, "getTraceId", {
87
+ enumerable: true,
88
+ get: function() {
89
+ return getTraceId;
90
+ }
91
+ });
92
+ Object.defineProperty(exports, "getUserId", {
93
+ enumerable: true,
94
+ get: function() {
95
+ return getUserId;
96
+ }
97
+ });
98
+ Object.defineProperty(exports, "requestContext", {
99
+ enumerable: true,
100
+ get: function() {
101
+ return requestContext;
102
+ }
103
+ });
104
+
105
+ //# sourceMappingURL=RequestContext-DgGEAxcW.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RequestContext-DgGEAxcW.cjs","names":[],"sources":["../src/context/RequestContext.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'async_hooks';\nimport type { ISRContextData } from '../types/ISRContext';\n\n// 复用 ISRContextData 类型,确保 ALS 中的数据结构与 ISRContext.data 一致\nexport type RequestContextState = ISRContextData;\n\nconst REQUEST_CONTEXT_KEY = '__ISR_ENGINE_REQUEST_CONTEXT__';\n\nfunction getGlobalRequestContext(): AsyncLocalStorage<RequestContextState> {\n const globalState = globalThis as typeof globalThis & {\n [REQUEST_CONTEXT_KEY]?: AsyncLocalStorage<RequestContextState>;\n };\n\n globalState[REQUEST_CONTEXT_KEY] ??= new AsyncLocalStorage<RequestContextState>();\n return globalState[REQUEST_CONTEXT_KEY];\n}\n\n// 全局 ALS 实例。dev 下 source/dist 可能同时被 Vite 加载,必须共享同一份请求上下文。\nexport const requestContext = getGlobalRequestContext();\n\n// 获取当前请求上下文的辅助函数\nexport const getRequestContext = (): RequestContextState | undefined => {\n return requestContext.getStore();\n};\n\n// 获取 Trace ID 的辅助函数 (安全访问)\nexport const getTraceId = (): string => {\n const store = requestContext.getStore();\n return store?.traceId || 'system';\n};\n\n// 获取 Request ID 的辅助函数 (安全访问)\nexport const getRequestId = (): string => {\n const store = requestContext.getStore();\n return store?.requestId || 'unknown';\n};\n\n/**\n * 获取 anonId —— 浏览器 / 设备维度稳定 UUID。\n *\n * engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值\n * (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。\n * 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。\n */\nexport const getAnonId = (): string => {\n const store = requestContext.getStore();\n return store?.anonId || 'system';\n};\n\n/**\n * 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。\n * 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远\n * 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。\n */\nexport const getUserId = (): string | null => {\n const store = requestContext.getStore();\n return store?.userId ?? null;\n};\n\n/**\n * 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。\n * 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。\n * 没接 ABVariantMiddleware 时返回空对象。\n */\nexport const getExperiments = (): Record<string, string> => {\n const store = requestContext.getStore();\n return store?.experiments ?? {};\n};\n"],"mappings":";;;;;;;;;;;;AAMA,IAAM,sBAAsB;AAE5B,SAAS,0BAAkE;CACzE,MAAM,cAAc;CAIpB,YAAY,yBAAyB,IAAI,YAAA,kBAAuC;CAChF,OAAO,YAAY;AACrB;AAGA,IAAa,iBAAiB,wBAAwB;AAGtD,IAAa,0BAA2D;CACtE,OAAO,eAAe,SAAS;AACjC;AAGA,IAAa,mBAA2B;CAEtC,OADc,eAAe,SACtB,CAAA,EAAO,WAAW;AAC3B;AAGA,IAAa,qBAA6B;CAExC,OADc,eAAe,SACtB,CAAA,EAAO,aAAa;AAC7B;;;;;;;;AASA,IAAa,kBAA0B;CAErC,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,kBAAiC;CAE5C,OADc,eAAe,SACtB,CAAA,EAAO,UAAU;AAC1B;;;;;;AAOA,IAAa,uBAA+C;CAE1D,OADc,eAAe,SACtB,CAAA,EAAO,eAAe,CAAC;AAChC"}