@ecopages/core 0.2.0-alpha.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 (342) hide show
  1. package/CHANGELOG.md +89 -0
  2. package/LICENSE +21 -0
  3. package/README.md +32 -0
  4. package/package.json +279 -0
  5. package/src/adapters/abstract/application-adapter.d.ts +168 -0
  6. package/src/adapters/abstract/application-adapter.js +109 -0
  7. package/src/adapters/abstract/application-adapter.ts +337 -0
  8. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  9. package/src/adapters/abstract/router-adapter.js +5 -0
  10. package/src/adapters/abstract/router-adapter.ts +30 -0
  11. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  12. package/src/adapters/abstract/server-adapter.js +15 -0
  13. package/src/adapters/abstract/server-adapter.ts +79 -0
  14. package/src/adapters/bun/client-bridge.d.ts +34 -0
  15. package/src/adapters/bun/client-bridge.js +48 -0
  16. package/src/adapters/bun/client-bridge.ts +62 -0
  17. package/src/adapters/bun/create-app.d.ts +60 -0
  18. package/src/adapters/bun/create-app.js +117 -0
  19. package/src/adapters/bun/create-app.ts +189 -0
  20. package/src/adapters/bun/define-api-handler.d.ts +61 -0
  21. package/src/adapters/bun/define-api-handler.js +15 -0
  22. package/src/adapters/bun/define-api-handler.ts +114 -0
  23. package/src/adapters/bun/hmr-manager.d.ts +84 -0
  24. package/src/adapters/bun/hmr-manager.js +227 -0
  25. package/src/adapters/bun/hmr-manager.ts +281 -0
  26. package/src/adapters/bun/index.d.ts +3 -0
  27. package/src/adapters/bun/index.js +8 -0
  28. package/src/adapters/bun/index.ts +3 -0
  29. package/src/adapters/bun/server-adapter.d.ts +155 -0
  30. package/src/adapters/bun/server-adapter.js +368 -0
  31. package/src/adapters/bun/server-adapter.ts +492 -0
  32. package/src/adapters/bun/server-lifecycle.d.ts +52 -0
  33. package/src/adapters/bun/server-lifecycle.js +120 -0
  34. package/src/adapters/bun/server-lifecycle.ts +154 -0
  35. package/src/adapters/index.d.ts +6 -0
  36. package/src/adapters/index.js +14 -0
  37. package/src/adapters/index.ts +6 -0
  38. package/src/adapters/node/create-app.d.ts +21 -0
  39. package/src/adapters/node/create-app.js +143 -0
  40. package/src/adapters/node/create-app.ts +179 -0
  41. package/src/adapters/node/index.d.ts +4 -0
  42. package/src/adapters/node/index.js +8 -0
  43. package/src/adapters/node/index.ts +9 -0
  44. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  45. package/src/adapters/node/node-client-bridge.js +66 -0
  46. package/src/adapters/node/node-client-bridge.ts +79 -0
  47. package/src/adapters/node/node-hmr-manager.d.ts +62 -0
  48. package/src/adapters/node/node-hmr-manager.js +221 -0
  49. package/src/adapters/node/node-hmr-manager.ts +271 -0
  50. package/src/adapters/node/server-adapter.d.ts +190 -0
  51. package/src/adapters/node/server-adapter.js +420 -0
  52. package/src/adapters/node/server-adapter.ts +561 -0
  53. package/src/adapters/node/static-content-server.d.ts +24 -0
  54. package/src/adapters/node/static-content-server.js +166 -0
  55. package/src/adapters/node/static-content-server.ts +203 -0
  56. package/src/adapters/shared/api-response.d.ts +52 -0
  57. package/src/adapters/shared/api-response.js +96 -0
  58. package/src/adapters/shared/api-response.ts +104 -0
  59. package/src/adapters/shared/application-adapter.d.ts +18 -0
  60. package/src/adapters/shared/application-adapter.js +90 -0
  61. package/src/adapters/shared/application-adapter.ts +199 -0
  62. package/src/adapters/shared/explicit-static-route-matcher.d.ts +38 -0
  63. package/src/adapters/shared/explicit-static-route-matcher.js +100 -0
  64. package/src/adapters/shared/explicit-static-route-matcher.ts +134 -0
  65. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
  66. package/src/adapters/shared/file-route-middleware-pipeline.js +98 -0
  67. package/src/adapters/shared/file-route-middleware-pipeline.ts +123 -0
  68. package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
  69. package/src/adapters/shared/fs-server-response-factory.js +97 -0
  70. package/src/adapters/shared/fs-server-response-factory.ts +118 -0
  71. package/src/adapters/shared/fs-server-response-matcher.d.ts +71 -0
  72. package/src/adapters/shared/fs-server-response-matcher.js +155 -0
  73. package/src/adapters/shared/fs-server-response-matcher.ts +198 -0
  74. package/src/adapters/shared/render-context.d.ts +14 -0
  75. package/src/adapters/shared/render-context.js +69 -0
  76. package/src/adapters/shared/render-context.ts +105 -0
  77. package/src/adapters/shared/server-adapter.d.ts +87 -0
  78. package/src/adapters/shared/server-adapter.js +353 -0
  79. package/src/adapters/shared/server-adapter.ts +442 -0
  80. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  81. package/src/adapters/shared/server-route-handler.js +120 -0
  82. package/src/adapters/shared/server-route-handler.ts +166 -0
  83. package/src/adapters/shared/server-static-builder.d.ts +38 -0
  84. package/src/adapters/shared/server-static-builder.js +46 -0
  85. package/src/adapters/shared/server-static-builder.ts +82 -0
  86. package/src/build/build-adapter.d.ts +74 -0
  87. package/src/build/build-adapter.js +54 -0
  88. package/src/build/build-adapter.ts +132 -0
  89. package/src/build/build-types.d.ts +57 -0
  90. package/src/build/build-types.js +0 -0
  91. package/src/build/build-types.ts +83 -0
  92. package/src/build/esbuild-build-adapter.d.ts +69 -0
  93. package/src/build/esbuild-build-adapter.js +390 -0
  94. package/src/build/esbuild-build-adapter.ts +510 -0
  95. package/src/config/config-builder.d.ts +227 -0
  96. package/src/config/config-builder.js +392 -0
  97. package/src/config/config-builder.ts +474 -0
  98. package/src/constants.d.ts +32 -0
  99. package/src/constants.js +21 -0
  100. package/src/constants.ts +39 -0
  101. package/src/create-app.d.ts +17 -0
  102. package/src/create-app.js +66 -0
  103. package/src/create-app.ts +87 -0
  104. package/src/declarations.d.ts +26 -0
  105. package/src/define-api-handler.d.ts +25 -0
  106. package/src/define-api-handler.js +15 -0
  107. package/src/define-api-handler.ts +66 -0
  108. package/src/dev/sc-server.d.ts +30 -0
  109. package/src/dev/sc-server.js +111 -0
  110. package/src/dev/sc-server.ts +143 -0
  111. package/src/eco/README.md +636 -0
  112. package/src/eco/component-render-context.d.ts +105 -0
  113. package/src/eco/component-render-context.js +77 -0
  114. package/src/eco/component-render-context.ts +202 -0
  115. package/src/eco/eco.d.ts +9 -0
  116. package/src/eco/eco.js +110 -0
  117. package/src/eco/eco.ts +221 -0
  118. package/src/eco/eco.types.d.ts +170 -0
  119. package/src/eco/eco.types.js +0 -0
  120. package/src/eco/eco.types.ts +202 -0
  121. package/src/eco/eco.utils.d.ts +40 -0
  122. package/src/eco/eco.utils.js +40 -0
  123. package/src/eco/eco.utils.ts +89 -0
  124. package/src/eco/global-injector-map.d.ts +16 -0
  125. package/src/eco/global-injector-map.js +80 -0
  126. package/src/eco/global-injector-map.ts +112 -0
  127. package/src/eco/lazy-injector-map.d.ts +8 -0
  128. package/src/eco/lazy-injector-map.js +70 -0
  129. package/src/eco/lazy-injector-map.ts +120 -0
  130. package/src/eco/module-dependencies.d.ts +18 -0
  131. package/src/eco/module-dependencies.js +49 -0
  132. package/src/eco/module-dependencies.ts +75 -0
  133. package/src/env.d.ts +20 -0
  134. package/src/errors/http-error.d.ts +31 -0
  135. package/src/errors/http-error.js +50 -0
  136. package/src/errors/http-error.ts +72 -0
  137. package/src/errors/index.d.ts +2 -0
  138. package/src/errors/index.js +4 -0
  139. package/src/errors/index.ts +2 -0
  140. package/src/errors/locals-access-error.d.ts +4 -0
  141. package/src/errors/locals-access-error.js +9 -0
  142. package/src/errors/locals-access-error.ts +7 -0
  143. package/src/global/app-logger.d.ts +2 -0
  144. package/src/global/app-logger.js +6 -0
  145. package/src/global/app-logger.ts +4 -0
  146. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-have-HMR-script-injected-in-page-1.png +0 -0
  147. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  148. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  149. package/src/hmr/client/hmr-runtime.d.ts +10 -0
  150. package/src/hmr/client/hmr-runtime.js +86 -0
  151. package/src/hmr/client/hmr-runtime.ts +121 -0
  152. package/src/hmr/hmr-strategy.d.ts +159 -0
  153. package/src/hmr/hmr-strategy.js +29 -0
  154. package/src/hmr/hmr-strategy.ts +172 -0
  155. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  156. package/src/hmr/hmr.test.e2e.js +50 -0
  157. package/src/hmr/hmr.test.e2e.ts +75 -0
  158. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  159. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  160. package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
  161. package/src/hmr/strategies/js-hmr-strategy.d.ts +136 -0
  162. package/src/hmr/strategies/js-hmr-strategy.js +179 -0
  163. package/src/hmr/strategies/js-hmr-strategy.ts +308 -0
  164. package/src/index.browser.d.ts +3 -0
  165. package/src/index.browser.js +4 -0
  166. package/src/index.browser.ts +3 -0
  167. package/src/index.d.ts +5 -0
  168. package/src/index.js +10 -0
  169. package/src/index.ts +5 -0
  170. package/src/integrations/ghtml/ghtml-renderer.d.ts +15 -0
  171. package/src/integrations/ghtml/ghtml-renderer.js +60 -0
  172. package/src/integrations/ghtml/ghtml-renderer.ts +93 -0
  173. package/src/integrations/ghtml/ghtml.plugin.d.ts +20 -0
  174. package/src/integrations/ghtml/ghtml.plugin.js +21 -0
  175. package/src/integrations/ghtml/ghtml.plugin.ts +32 -0
  176. package/src/internal-types.d.ts +200 -0
  177. package/src/internal-types.js +0 -0
  178. package/src/internal-types.ts +212 -0
  179. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  180. package/src/plugins/alias-resolver-plugin.js +39 -0
  181. package/src/plugins/alias-resolver-plugin.ts +45 -0
  182. package/src/plugins/eco-component-meta-plugin.d.ts +95 -0
  183. package/src/plugins/eco-component-meta-plugin.js +157 -0
  184. package/src/plugins/eco-component-meta-plugin.ts +474 -0
  185. package/src/plugins/integration-plugin.d.ts +102 -0
  186. package/src/plugins/integration-plugin.js +100 -0
  187. package/src/plugins/integration-plugin.ts +184 -0
  188. package/src/plugins/processor.d.ts +82 -0
  189. package/src/plugins/processor.js +122 -0
  190. package/src/plugins/processor.ts +220 -0
  191. package/src/public-types.d.ts +1094 -0
  192. package/src/public-types.js +0 -0
  193. package/src/public-types.ts +1255 -0
  194. package/src/route-renderer/GRAPH.md +387 -0
  195. package/src/route-renderer/README.md +135 -0
  196. package/src/route-renderer/component-graph-executor.d.ts +32 -0
  197. package/src/route-renderer/component-graph-executor.js +31 -0
  198. package/src/route-renderer/component-graph-executor.ts +84 -0
  199. package/src/route-renderer/component-graph.d.ts +42 -0
  200. package/src/route-renderer/component-graph.js +72 -0
  201. package/src/route-renderer/component-graph.ts +159 -0
  202. package/src/route-renderer/component-marker.d.ts +52 -0
  203. package/src/route-renderer/component-marker.js +46 -0
  204. package/src/route-renderer/component-marker.ts +117 -0
  205. package/src/route-renderer/dependency-resolver.d.ts +24 -0
  206. package/src/route-renderer/dependency-resolver.js +428 -0
  207. package/src/route-renderer/dependency-resolver.ts +596 -0
  208. package/src/route-renderer/html-post-processing.service.d.ts +40 -0
  209. package/src/route-renderer/html-post-processing.service.js +86 -0
  210. package/src/route-renderer/html-post-processing.service.ts +103 -0
  211. package/src/route-renderer/integration-renderer.d.ts +339 -0
  212. package/src/route-renderer/integration-renderer.js +526 -0
  213. package/src/route-renderer/integration-renderer.ts +696 -0
  214. package/src/route-renderer/marker-graph-resolver.d.ts +76 -0
  215. package/src/route-renderer/marker-graph-resolver.js +93 -0
  216. package/src/route-renderer/marker-graph-resolver.ts +153 -0
  217. package/src/route-renderer/page-module-loader.d.ts +61 -0
  218. package/src/route-renderer/page-module-loader.js +102 -0
  219. package/src/route-renderer/page-module-loader.ts +153 -0
  220. package/src/route-renderer/render-execution.service.d.ts +69 -0
  221. package/src/route-renderer/render-execution.service.js +91 -0
  222. package/src/route-renderer/render-execution.service.ts +158 -0
  223. package/src/route-renderer/render-preparation.service.d.ts +112 -0
  224. package/src/route-renderer/render-preparation.service.js +243 -0
  225. package/src/route-renderer/render-preparation.service.ts +358 -0
  226. package/src/route-renderer/route-renderer.d.ts +26 -0
  227. package/src/route-renderer/route-renderer.js +68 -0
  228. package/src/route-renderer/route-renderer.ts +80 -0
  229. package/src/router/fs-router-scanner.d.ts +41 -0
  230. package/src/router/fs-router-scanner.js +155 -0
  231. package/src/router/fs-router-scanner.ts +217 -0
  232. package/src/router/fs-router.d.ts +26 -0
  233. package/src/router/fs-router.js +100 -0
  234. package/src/router/fs-router.ts +122 -0
  235. package/src/services/asset-processing-service/asset-processing.service.d.ts +41 -0
  236. package/src/services/asset-processing-service/asset-processing.service.js +250 -0
  237. package/src/services/asset-processing-service/asset-processing.service.ts +306 -0
  238. package/src/services/asset-processing-service/asset.factory.d.ts +17 -0
  239. package/src/services/asset-processing-service/asset.factory.js +82 -0
  240. package/src/services/asset-processing-service/asset.factory.ts +105 -0
  241. package/src/services/asset-processing-service/assets.types.d.ts +88 -0
  242. package/src/services/asset-processing-service/assets.types.js +0 -0
  243. package/src/services/asset-processing-service/assets.types.ts +112 -0
  244. package/src/services/asset-processing-service/index.d.ts +3 -0
  245. package/src/services/asset-processing-service/index.js +3 -0
  246. package/src/services/asset-processing-service/index.ts +3 -0
  247. package/src/services/asset-processing-service/processor.interface.d.ts +22 -0
  248. package/src/services/asset-processing-service/processor.interface.js +6 -0
  249. package/src/services/asset-processing-service/processor.interface.ts +27 -0
  250. package/src/services/asset-processing-service/processor.registry.d.ts +8 -0
  251. package/src/services/asset-processing-service/processor.registry.js +15 -0
  252. package/src/services/asset-processing-service/processor.registry.ts +18 -0
  253. package/src/services/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  254. package/src/services/asset-processing-service/processors/base/base-processor.js +59 -0
  255. package/src/services/asset-processing-service/processors/base/base-processor.ts +76 -0
  256. package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +16 -0
  257. package/src/services/asset-processing-service/processors/base/base-script-processor.js +80 -0
  258. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +105 -0
  259. package/src/services/asset-processing-service/processors/index.d.ts +5 -0
  260. package/src/services/asset-processing-service/processors/index.js +5 -0
  261. package/src/services/asset-processing-service/processors/index.ts +5 -0
  262. package/src/services/asset-processing-service/processors/script/content-script.processor.d.ts +5 -0
  263. package/src/services/asset-processing-service/processors/script/content-script.processor.js +57 -0
  264. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +66 -0
  265. package/src/services/asset-processing-service/processors/script/file-script.processor.d.ts +8 -0
  266. package/src/services/asset-processing-service/processors/script/file-script.processor.js +76 -0
  267. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +88 -0
  268. package/src/services/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  269. package/src/services/asset-processing-service/processors/script/node-module-script.processor.js +74 -0
  270. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +84 -0
  271. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -0
  272. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +25 -0
  273. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +27 -0
  274. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  275. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +63 -0
  276. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +77 -0
  277. package/src/services/cache/cache.types.d.ts +107 -0
  278. package/src/services/cache/cache.types.js +0 -0
  279. package/src/services/cache/cache.types.ts +126 -0
  280. package/src/services/cache/index.d.ts +7 -0
  281. package/src/services/cache/index.js +7 -0
  282. package/src/services/cache/index.ts +18 -0
  283. package/src/services/cache/memory-cache-store.d.ts +42 -0
  284. package/src/services/cache/memory-cache-store.js +98 -0
  285. package/src/services/cache/memory-cache-store.ts +130 -0
  286. package/src/services/cache/page-cache-service.d.ts +70 -0
  287. package/src/services/cache/page-cache-service.js +152 -0
  288. package/src/services/cache/page-cache-service.ts +202 -0
  289. package/src/services/html-transformer.service.d.ts +50 -0
  290. package/src/services/html-transformer.service.js +163 -0
  291. package/src/services/html-transformer.service.ts +217 -0
  292. package/src/services/page-module-import.service.d.ts +37 -0
  293. package/src/services/page-module-import.service.js +88 -0
  294. package/src/services/page-module-import.service.ts +129 -0
  295. package/src/services/page-request-cache-coordinator.service.d.ts +75 -0
  296. package/src/services/page-request-cache-coordinator.service.js +107 -0
  297. package/src/services/page-request-cache-coordinator.service.ts +128 -0
  298. package/src/services/schema-validation-service.d.ts +122 -0
  299. package/src/services/schema-validation-service.js +101 -0
  300. package/src/services/schema-validation-service.ts +204 -0
  301. package/src/services/validation/standard-schema.types.d.ts +65 -0
  302. package/src/services/validation/standard-schema.types.js +0 -0
  303. package/src/services/validation/standard-schema.types.ts +68 -0
  304. package/src/static-site-generator/static-site-generator.d.ts +57 -0
  305. package/src/static-site-generator/static-site-generator.js +272 -0
  306. package/src/static-site-generator/static-site-generator.ts +359 -0
  307. package/src/utils/css.d.ts +1 -0
  308. package/src/utils/css.js +7 -0
  309. package/src/utils/css.ts +5 -0
  310. package/src/utils/deep-merge.d.ts +14 -0
  311. package/src/utils/deep-merge.js +32 -0
  312. package/src/utils/deep-merge.ts +47 -0
  313. package/src/utils/hash.d.ts +1 -0
  314. package/src/utils/hash.js +7 -0
  315. package/src/utils/hash.ts +5 -0
  316. package/src/utils/html.d.ts +1 -0
  317. package/src/utils/html.js +4 -0
  318. package/src/utils/html.ts +1 -0
  319. package/src/utils/invariant.d.ts +5 -0
  320. package/src/utils/invariant.js +11 -0
  321. package/src/utils/invariant.ts +15 -0
  322. package/src/utils/locals-utils.d.ts +15 -0
  323. package/src/utils/locals-utils.js +24 -0
  324. package/src/utils/locals-utils.ts +37 -0
  325. package/src/utils/parse-cli-args.d.ts +24 -0
  326. package/src/utils/parse-cli-args.js +47 -0
  327. package/src/utils/parse-cli-args.ts +83 -0
  328. package/src/utils/path-utils.module.d.ts +5 -0
  329. package/src/utils/path-utils.module.js +14 -0
  330. package/src/utils/path-utils.module.ts +14 -0
  331. package/src/utils/runtime.d.ts +11 -0
  332. package/src/utils/runtime.js +40 -0
  333. package/src/utils/runtime.ts +44 -0
  334. package/src/utils/server-utils.module.d.ts +19 -0
  335. package/src/utils/server-utils.module.js +56 -0
  336. package/src/utils/server-utils.module.ts +67 -0
  337. package/src/watchers/project-watcher.d.ts +120 -0
  338. package/src/watchers/project-watcher.js +238 -0
  339. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  340. package/src/watchers/project-watcher.test-helpers.js +51 -0
  341. package/src/watchers/project-watcher.test-helpers.ts +40 -0
  342. package/src/watchers/project-watcher.ts +306 -0
package/src/route-renderer/integration-renderer.js ADDED
@@ -0,0 +1,526 @@
1
+ import {} from "../services/asset-processing-service/index.js";
2
+ import { HtmlTransformerService } from "../services/html-transformer.service.js";
3
+ import { invariant } from "../utils/invariant.js";
4
+ import { HttpError } from "../errors/http-error.js";
5
+ import { LocalsAccessError } from "../errors/locals-access-error.js";
6
+ import { DependencyResolverService } from "./dependency-resolver.js";
7
+ import { HtmlPostProcessingService } from "./html-post-processing.service.js";
8
+ import { PageModuleLoaderService } from "./page-module-loader.js";
9
+ import { MarkerGraphResolver } from "./marker-graph-resolver.js";
10
+ import { RenderExecutionService } from "./render-execution.service.js";
11
+ import { RenderPreparationService } from "./render-preparation.service.js";
12
+ function createLocalsProxy(filePath) {
13
+ const errorMessage = `[ecopages] Request locals are only available during request-time rendering with cache: 'dynamic'. Page: ${filePath}. If you meant to use locals here, set cache: 'dynamic' and provide locals from route middleware/handlers.`;
14
+ return new Proxy(
15
+ {},
16
+ {
17
+ get: () => {
18
+ throw new LocalsAccessError(errorMessage);
19
+ },
20
+ set: () => {
21
+ throw new LocalsAccessError(errorMessage);
22
+ },
23
+ has: () => {
24
+ throw new LocalsAccessError(errorMessage);
25
+ },
26
+ ownKeys: () => {
27
+ throw new LocalsAccessError(errorMessage);
28
+ },
29
+ deleteProperty: () => {
30
+ throw new LocalsAccessError(errorMessage);
31
+ },
32
+ defineProperty: () => {
33
+ throw new LocalsAccessError(errorMessage);
34
+ },
35
+ getOwnPropertyDescriptor: () => {
36
+ throw new LocalsAccessError(errorMessage);
37
+ }
38
+ }
39
+ );
40
+ }
41
+ class IntegrationRenderer {
42
+ appConfig;
43
+ assetProcessingService;
44
+ htmlTransformer;
45
+ hmrManager;
46
+ resolvedIntegrationDependencies = [];
47
+ runtimeOrigin;
48
+ dependencyResolverService;
49
+ pageModuleLoaderService;
50
+ markerGraphResolver;
51
+ renderPreparationService;
52
+ htmlPostProcessingService;
53
+ renderExecutionService;
54
+ DOC_TYPE = "<!DOCTYPE html>";
55
+ setHmrManager(hmrManager) {
56
+ this.hmrManager = hmrManager;
57
+ if (this.assetProcessingService) {
58
+ this.assetProcessingService.setHmrManager(hmrManager);
59
+ }
60
+ }
61
+ /**
62
+ * Build response headers with optional custom headers.
63
+ * @param contentType - The Content-Type header value
64
+ * @param customHeaders - Optional custom headers to merge
65
+ * @returns Headers object
66
+ */
67
+ buildHeaders(contentType, customHeaders) {
68
+ const headers = new Headers({ "Content-Type": contentType });
69
+ if (customHeaders) {
70
+ const incoming = new Headers(customHeaders);
71
+ incoming.forEach((value, key) => headers.set(key, value));
72
+ }
73
+ return headers;
74
+ }
75
+ /**
76
+ * Create an HTML Response.
77
+ * @param body - Response body (string or ReadableStream)
78
+ * @param ctx - Render context with status and headers
79
+ * @returns Response object
80
+ */
81
+ createHtmlResponse(body, ctx) {
82
+ return new Response(body, {
83
+ status: ctx.status ?? 200,
84
+ headers: this.buildHeaders("text/html; charset=utf-8", ctx.headers)
85
+ });
86
+ }
87
+ /**
88
+ * Create an HttpError for render failures.
89
+ * @param message - Error message
90
+ * @param cause - Original error if available
91
+ * @returns HttpError with 500 status
92
+ */
93
+ createRenderError(message, cause) {
94
+ const errorMessage = cause instanceof Error ? `${message}: ${cause.message}` : message;
95
+ return HttpError.InternalServerError(errorMessage);
96
+ }
97
+ /**
98
+ * Prepares dependencies for renderToResponse by resolving component dependencies
99
+ * and configuring the HTML transformer.
100
+ * @param view - The view component being rendered
101
+ * @param layout - Optional layout component
102
+ * @returns Resolved processed assets
103
+ */
104
+ async prepareViewDependencies(view, layout) {
105
+ const HtmlTemplate = await this.getHtmlTemplate();
106
+ const componentsToResolve = layout ? [HtmlTemplate, layout, view] : [HtmlTemplate, view];
107
+ const resolvedDependencies = this.htmlPostProcessingService.dedupeProcessedAssets(
108
+ await this.resolveDependencies(componentsToResolve)
109
+ );
110
+ this.htmlTransformer.setProcessedDependencies(resolvedDependencies);
111
+ return resolvedDependencies;
112
+ }
113
+ constructor({
114
+ appConfig,
115
+ assetProcessingService,
116
+ resolvedIntegrationDependencies,
117
+ runtimeOrigin
118
+ }) {
119
+ this.appConfig = appConfig;
120
+ this.assetProcessingService = assetProcessingService;
121
+ this.htmlTransformer = new HtmlTransformerService();
122
+ this.resolvedIntegrationDependencies = resolvedIntegrationDependencies || [];
123
+ this.runtimeOrigin = runtimeOrigin;
124
+ this.dependencyResolverService = new DependencyResolverService(appConfig, assetProcessingService);
125
+ this.pageModuleLoaderService = new PageModuleLoaderService(appConfig, runtimeOrigin);
126
+ this.markerGraphResolver = new MarkerGraphResolver();
127
+ this.renderPreparationService = new RenderPreparationService(appConfig, assetProcessingService);
128
+ this.htmlPostProcessingService = new HtmlPostProcessingService();
129
+ this.renderExecutionService = new RenderExecutionService();
130
+ }
131
+ /**
132
+ * Returns the HTML path from the provided file path.
133
+ * It extracts the path relative to the pages directory and removes the 'index' part if present.
134
+ *
135
+ * @param file - The file path to extract the HTML path from.
136
+ * @returns The extracted HTML path.
137
+ */
138
+ getHtmlPath({ file }) {
139
+ const pagesDir = this.appConfig.absolutePaths.pagesDir;
140
+ const pagesIndex = file.indexOf(pagesDir);
141
+ if (pagesIndex === -1) return file;
142
+ const startIndex = file.indexOf(pagesDir) + pagesDir.length;
143
+ const endIndex = file.lastIndexOf("/");
144
+ const path = file.substring(startIndex, endIndex);
145
+ if (path === "/index") return "";
146
+ return path;
147
+ }
148
+ /**
149
+ * Returns the HTML template component.
150
+ * It imports the HTML template from the specified path in the app configuration.
151
+ *
152
+ * @returns The HTML template component.
153
+ */
154
+ async getHtmlTemplate() {
155
+ const { absolutePaths } = this.appConfig;
156
+ try {
157
+ const { default: HtmlTemplate } = await this.importPageFile(absolutePaths.htmlTemplatePath);
158
+ return HtmlTemplate;
159
+ } catch (error) {
160
+ invariant(false, `Error importing HtmlTemplate: ${error}`);
161
+ }
162
+ }
163
+ /**
164
+ * Returns the static props for the page.
165
+ * It calls the provided getStaticProps function with the given options.
166
+ *
167
+ * @param getStaticProps - The function to get static props.
168
+ * @param options - The options to pass to the getStaticProps function.
169
+ * @returns The static props and metadata.
170
+ */
171
+ async getStaticProps(getStaticProps, options) {
172
+ return this.pageModuleLoaderService.getStaticPropsForPage({
173
+ getStaticProps,
174
+ params: options?.params
175
+ });
176
+ }
177
+ /**
178
+ * Returns the metadata properties for the page.
179
+ * It calls the provided getMetadata function with the given context.
180
+ *
181
+ * @param getMetadata - The function to get metadata.
182
+ * @param context - The context to pass to the getMetadata function.
183
+ * @returns The metadata properties.
184
+ */
185
+ async getMetadataProps(getMetadata, { props, params, query }) {
186
+ return this.pageModuleLoaderService.getMetadataPropsForPage({
187
+ getMetadata,
188
+ context: { props, params, query }
189
+ });
190
+ }
191
+ /**
192
+ * Imports the page file from the specified path.
193
+ * It uses dynamic import to load the file and returns the imported module.
194
+ *
195
+ * @param file - The file path to import.
196
+ * @returns The imported module.
197
+ */
198
+ async importPageFile(file) {
199
+ return this.pageModuleLoaderService.importPageFile(file);
200
+ }
201
+ /**
202
+ * Resolves the dependency path based on the component directory.
203
+ * It combines the component directory with the provided path URL.
204
+ *
205
+ * @param componentDir - The component directory path.
206
+ * @param pathUrl - The path URL to resolve.
207
+ * @returns The resolved dependency path.
208
+ */
209
+ resolveDependencyPath(componentDir, pathUrl) {
210
+ return this.dependencyResolverService.resolveDependencyPath(componentDir, pathUrl);
211
+ }
212
+ /**
213
+ * Extracts the dependencies from the provided component configuration.
214
+ * It resolves the paths for scripts and stylesheets based on the component directory.
215
+ *
216
+ * @param componentDir - The component directory path.
217
+ * @param scripts - The scripts to extract.
218
+ * @param stylesheets - The stylesheets to extract.
219
+ * @returns The extracted dependencies.
220
+ */
221
+ extractDependencies({
222
+ componentDir,
223
+ scripts,
224
+ stylesheets
225
+ }) {
226
+ const scriptsPaths = [
227
+ ...new Set(
228
+ (scripts ?? []).filter((script) => typeof script === "string" ? true : !script.lazy).map((script) => typeof script === "string" ? script : script.src).filter((script) => Boolean(script)).map((script) => this.resolveDependencyPath(componentDir, script))
229
+ )
230
+ ];
231
+ const stylesheetsPaths = [
232
+ ...new Set(
233
+ (stylesheets ?? []).map((style) => typeof style === "string" ? style : style.src).filter((style) => Boolean(style)).map((style) => this.resolveDependencyPath(componentDir, style))
234
+ )
235
+ ];
236
+ return {
237
+ scripts: scriptsPaths,
238
+ stylesheets: stylesheetsPaths
239
+ };
240
+ }
241
+ /**
242
+ * Resolves lazy script paths to public asset URLs.
243
+ * Converts source paths to their final bundled output paths.
244
+ *
245
+ * @param componentDir - The component directory path.
246
+ * @param scripts - The lazy script paths to resolve.
247
+ * @returns Comma-separated string of resolved public script paths.
248
+ */
249
+ resolveLazyScripts(componentDir, scripts) {
250
+ return this.dependencyResolverService.resolveLazyScripts(componentDir, scripts);
251
+ }
252
+ /**
253
+ * Collects the dependencies for the provided components.
254
+ * Combines component-specific dependencies with global integration dependencies.
255
+ *
256
+ * @param components - The components to collect dependencies from.
257
+ */
258
+ async resolveDependencies(components) {
259
+ const componentDeps = await this.processComponentDependencies(components);
260
+ return this.resolvedIntegrationDependencies.concat(componentDeps);
261
+ }
262
+ /**
263
+ * Processes component-specific dependencies WITHOUT prepending global integration dependencies.
264
+ * Use this method when you need only the component's own assets.
265
+ *
266
+ * @param components - The components to collect dependencies from.
267
+ */
268
+ async processComponentDependencies(components) {
269
+ return this.dependencyResolverService.processComponentDependencies(components, this.name);
270
+ }
271
+ /**
272
+ * Prepares the render options for the integration renderer.
273
+ * It imports the page file, collects dependencies, and prepares the render options.
274
+ *
275
+ * @param options - The route renderer options.
276
+ * @returns The prepared render options.
277
+ */
278
+ async prepareRenderOptions(options) {
279
+ return this.renderPreparationService.prepare(options, this.name, {
280
+ resolvePageModule: (file) => this.resolvePageModule(file),
281
+ getHtmlTemplate: () => this.getHtmlTemplate(),
282
+ resolvePageData: (pageModule, routeOptions) => this.resolvePageData(pageModule, routeOptions),
283
+ resolveDependencies: (components) => this.resolveDependencies(components),
284
+ buildRouteRenderAssets: (file) => this.buildRouteRenderAssets(file),
285
+ shouldRenderPageComponent: (input) => this.shouldRenderPageComponent(input),
286
+ renderPageComponent: ({ component, props }) => this.renderComponent({
287
+ component,
288
+ props,
289
+ integrationContext: {
290
+ componentInstanceId: "eco-page-root"
291
+ }
292
+ }),
293
+ getComponentRenderBoundaryContext: () => this.getComponentRenderBoundaryContext(),
294
+ setProcessedDependencies: (dependencies) => this.htmlTransformer.setProcessedDependencies(dependencies),
295
+ dedupeProcessedAssets: (assets) => this.htmlPostProcessingService.dedupeProcessedAssets(assets),
296
+ createPageLocalsProxy: (filePath) => createLocalsProxy(filePath)
297
+ });
298
+ }
299
+ /**
300
+ * Controls whether the page root should be rendered through `renderComponent()`
301
+ * during route option preparation in component-capable modes.
302
+ *
303
+ * Integrations that already own page-level hydration (for example router-driven
304
+ * React rendering) can override this and return `false` to avoid duplicate root
305
+ * mount assets and competing hydration entrypoints.
306
+ */
307
+ shouldRenderPageComponent(_input) {
308
+ return true;
309
+ }
310
+ /**
311
+ * Resolves the page module and normalizes exports.
312
+ */
313
+ async resolvePageModule(file) {
314
+ return this.pageModuleLoaderService.resolvePageModule({
315
+ file,
316
+ importPageFileFn: (targetFile) => this.importPageFile(targetFile)
317
+ });
318
+ }
319
+ /**
320
+ * Resolves static props and metadata for the page.
321
+ */
322
+ async resolvePageData(pageModule, options) {
323
+ return this.pageModuleLoaderService.resolvePageData({
324
+ pageModule,
325
+ routeOptions: options
326
+ });
327
+ }
328
+ /**
329
+ * Executes the integration renderer with the provided options.
330
+ *
331
+ * Execution flow:
332
+ * 1. Build normalized render options (`prepareRenderOptions`).
333
+ * 2. Render once inside component render context to capture marker graph refs.
334
+ * 3. Merge captured refs with optional explicit page-module graph context.
335
+ * 4. Resolve any `eco-marker` graph bottom-up and merge produced assets.
336
+ * 5. Optionally apply root attributes for page/component root boundaries.
337
+ * 6. Run HTML transformer with final dependency set.
338
+ *
339
+ * Stream-safety note: the first render result is normalized to a string once,
340
+ * then the pipeline continues with that immutable HTML value to avoid disturbed
341
+ * response-body errors.
342
+ *
343
+ * @param options Route renderer options.
344
+ * @returns Rendered route body plus effective cache strategy.
345
+ */
346
+ async execute(options) {
347
+ return this.renderExecutionService.execute(options, this.name, {
348
+ prepareRenderOptions: (routeOptions) => this.prepareRenderOptions(routeOptions),
349
+ render: (renderOptions) => this.render(renderOptions),
350
+ getComponentRenderBoundaryContext: () => this.getComponentRenderBoundaryContext(),
351
+ resolveMarkerGraphHtml: (input) => this.resolveMarkerGraphHtml({
352
+ html: input.html,
353
+ componentsToResolve: input.componentsToResolve,
354
+ graphContext: input.graphContext
355
+ }),
356
+ dedupeProcessedAssets: (assets) => this.htmlPostProcessingService.dedupeProcessedAssets(assets),
357
+ getProcessedDependencies: () => this.htmlTransformer.getProcessedDependencies(),
358
+ setProcessedDependencies: (dependencies) => this.htmlTransformer.setProcessedDependencies(dependencies),
359
+ applyAttributesToFirstBodyElement: (html, attributes) => this.htmlPostProcessingService.applyAttributesToFirstBodyElement(html, attributes),
360
+ transformHtml: async (html) => {
361
+ const response = await this.htmlTransformer.transform(
362
+ new Response(html, {
363
+ headers: {
364
+ "Content-Type": "text/html"
365
+ }
366
+ })
367
+ );
368
+ return response.body;
369
+ }
370
+ });
371
+ }
372
+ /**
373
+ * Resolves all `eco-marker` placeholders in rendered HTML using integration
374
+ * dispatch and bottom-up graph execution.
375
+ *
376
+ * Responsibility split:
377
+ * - core decodes markers into component refs, props, slot children, and target
378
+ * integration dispatch
379
+ * - the selected integration renderer performs the actual component render via
380
+ * `renderComponent()`
381
+ *
382
+ * Resolver callback behavior per marker:
383
+ * - resolve component definition by `componentRef`
384
+ * - resolve serialized props by `propsRef`
385
+ * - stitch resolved child HTML when `slotRef` is present
386
+ * - dispatch to target integration `renderComponent`
387
+ * - collect produced assets and apply root attributes when attachable
388
+ *
389
+ * @param options.html HTML that may still contain marker tokens.
390
+ * @param options.componentsToResolve Component set used to build component ref registry.
391
+ * @param options.graphContext Props/slot linkage captured during render.
392
+ * @returns Resolved HTML plus any component-scoped assets produced while resolving nodes.
393
+ * @throws Error when marker component refs or props refs cannot be resolved.
394
+ */
395
+ async resolveMarkerGraphHtml(options) {
396
+ const integrationRendererCache = /* @__PURE__ */ new Map();
397
+ return this.markerGraphResolver.resolve({
398
+ html: options.html,
399
+ componentsToResolve: options.componentsToResolve,
400
+ graphContext: options.graphContext,
401
+ resolveRenderer: (integrationName) => this.getIntegrationRendererForName(integrationName, integrationRendererCache),
402
+ applyAttributesToFirstElement: (html, attributes) => this.htmlPostProcessingService.applyAttributesToFirstElement(html, attributes)
403
+ });
404
+ }
405
+ /**
406
+ * Returns a renderer instance for a given integration name.
407
+ *
408
+ * Uses a per-execution cache to avoid repeated renderer initialization.
409
+ *
410
+ * @param integrationName Target integration name.
411
+ * @param cache Render-pass renderer cache.
412
+ * @returns Renderer for the requested integration.
413
+ * @throws Error when no integration plugin matches `integrationName`.
414
+ */
415
+ getIntegrationRendererForName(integrationName, cache) {
416
+ if (cache.has(integrationName)) {
417
+ return cache.get(integrationName);
418
+ }
419
+ if (integrationName === this.name) {
420
+ cache.set(integrationName, this);
421
+ return this;
422
+ }
423
+ const integrationPlugin = this.appConfig.integrations.find(
424
+ (integration) => integration.name === integrationName
425
+ );
426
+ invariant(!!integrationPlugin, `[ecopages] Integration not found for marker: ${integrationName}`);
427
+ const renderer = integrationPlugin.initializeRenderer();
428
+ cache.set(integrationName, renderer);
429
+ return renderer;
430
+ }
431
+ /**
432
+ * Render a single component and return structured output for orchestration paths.
433
+ *
434
+ * Default behavior delegates to `renderToResponse` in partial mode and wraps
435
+ * the resulting HTML into the `ComponentRenderResult` contract.
436
+ *
437
+ * In marker resolution, this method is the integration-owned step that turns an
438
+ * already-resolved deferred boundary into concrete HTML, assets, and optional
439
+ * root attributes.
440
+ *
441
+ * Integrations can override this for richer behavior (asset emission,
442
+ * root attributes, integration-specific hydration metadata).
443
+ *
444
+ * @param input Component render request.
445
+ * @returns Structured render result used by marker/page orchestration.
446
+ */
447
+ async renderComponent(input) {
448
+ const response = await this.renderToResponse(
449
+ input.component,
450
+ input.props,
451
+ { partial: true }
452
+ );
453
+ const html = await response.text();
454
+ return {
455
+ html,
456
+ canAttachAttributes: true,
457
+ rootTag: this.getRootTagName(html),
458
+ integrationName: this.name
459
+ };
460
+ }
461
+ /**
462
+ * Extracts the first root element tag name from HTML output.
463
+ *
464
+ * @param html HTML fragment.
465
+ * @returns Root tag name when present; otherwise `undefined`.
466
+ */
467
+ getRootTagName(html) {
468
+ const rootTag = html.match(/^\s*<([a-zA-Z][a-zA-Z0-9:-]*)\b/);
469
+ return rootTag?.[1];
470
+ }
471
+ /**
472
+ * Method to build route render assets.
473
+ * This method can be optionally overridden by the specific integration renderer.
474
+ *
475
+ * @param file - The file path to build assets for.
476
+ * @returns The processed assets or undefined.
477
+ */
478
+ buildRouteRenderAssets(_file) {
479
+ return void 0;
480
+ }
481
+ /**
482
+ * Builds the narrow boundary policy facade injected into component render
483
+ * context for this render pass.
484
+ *
485
+ * `eco.component()` consumes this facade without knowing about integration
486
+ * registries or plugin instances.
487
+ *
488
+ * @returns Boundary policy context for the active integration renderer.
489
+ */
490
+ getComponentRenderBoundaryContext() {
491
+ return {
492
+ decideBoundaryRender: (input) => this.shouldDeferComponentBoundary(input) ? "defer" : "inline"
493
+ };
494
+ }
495
+ /**
496
+ * Resolves whether a component boundary should be deferred by consulting the
497
+ * target integration plugin.
498
+ *
499
+ * Boundaries targeting the current integration always render inline. Cross-
500
+ * integration boundaries delegate the decision to the target integration's
501
+ * `shouldDeferComponentBoundary()` policy.
502
+ *
503
+ * @param input Boundary metadata for the active render pass.
504
+ * @returns `true` when the boundary should emit a marker; otherwise `false`.
505
+ */
506
+ shouldDeferComponentBoundary(input) {
507
+ if (!input.targetIntegration || input.targetIntegration === input.currentIntegration) {
508
+ return false;
509
+ }
510
+ const targetIntegration = this.appConfig.integrations.find(
511
+ (integration) => integration.name === input.targetIntegration
512
+ );
513
+ invariant(
514
+ !!targetIntegration,
515
+ `[ecopages] Integration not found for component boundary: ${input.targetIntegration}`
516
+ );
517
+ return targetIntegration.shouldDeferComponentBoundary({
518
+ currentIntegration: input.currentIntegration,
519
+ targetIntegration: input.targetIntegration,
520
+ component: input.component
521
+ });
522
+ }
523
+ }
524
+ export {
525
+ IntegrationRenderer
526
+ };