@ecopages/core 0.2.0-alpha.4 → 0.2.0-alpha.6

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 (418) hide show
  1. package/README.md +213 -12
  2. package/package.json +100 -188
  3. package/src/adapters/README.md +39 -0
  4. package/src/adapters/bun/hmr-manager.test.ts +267 -0
  5. package/src/adapters/bun/hmr-manager.ts +181 -68
  6. package/src/adapters/bun/index.ts +1 -2
  7. package/src/adapters/bun/server-adapter.ts +41 -34
  8. package/src/adapters/bun/server-lifecycle.ts +40 -70
  9. package/src/adapters/index.ts +1 -1
  10. package/src/adapters/node/bootstrap-dependency-resolver.test.ts +282 -0
  11. package/src/adapters/node/bootstrap-dependency-resolver.ts +301 -0
  12. package/src/adapters/node/index.ts +7 -0
  13. package/src/adapters/node/node-client-bridge.test.ts +198 -0
  14. package/src/adapters/node/node-hmr-manager.test.ts +322 -0
  15. package/src/adapters/node/node-hmr-manager.ts +208 -116
  16. package/src/adapters/node/runtime-adapter.test.ts +868 -0
  17. package/src/adapters/node/runtime-adapter.ts +439 -0
  18. package/src/adapters/node/server-adapter.ts +31 -104
  19. package/src/adapters/node/static-content-server.test.ts +60 -0
  20. package/src/adapters/node/static-content-server.ts +36 -0
  21. package/src/adapters/node/write-runtime-manifest.ts +38 -0
  22. package/src/adapters/shared/api-response.test.ts +97 -0
  23. package/src/{define-api-handler.ts → adapters/shared/define-api-handler.ts} +1 -1
  24. package/src/adapters/shared/explicit-static-route-matcher.test.ts +381 -0
  25. package/src/adapters/shared/explicit-static-route-matcher.ts +7 -1
  26. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +90 -0
  27. package/src/adapters/shared/file-route-middleware-pipeline.ts +6 -2
  28. package/src/adapters/shared/fs-server-response-factory.test.ts +187 -0
  29. package/src/adapters/shared/fs-server-response-matcher.test.ts +286 -0
  30. package/src/adapters/shared/fs-server-response-matcher.ts +17 -10
  31. package/src/adapters/shared/hmr-entrypoint-registrar.ts +149 -0
  32. package/src/adapters/shared/hmr-html-response.ts +52 -0
  33. package/src/adapters/shared/hmr-manager.contract.test.ts +196 -0
  34. package/src/adapters/shared/hmr-manager.dispatch.test.ts +220 -0
  35. package/src/adapters/shared/render-context.test.ts +146 -0
  36. package/src/adapters/shared/render-context.ts +21 -6
  37. package/src/adapters/shared/runtime-bootstrap.ts +79 -0
  38. package/src/adapters/shared/server-adapter.test.ts +77 -0
  39. package/src/adapters/shared/server-adapter.ts +51 -4
  40. package/src/adapters/shared/server-route-handler.test.ts +110 -0
  41. package/src/adapters/shared/server-route-handler.ts +5 -18
  42. package/src/adapters/shared/server-static-builder.test.ts +316 -0
  43. package/src/adapters/shared/server-static-builder.ts +92 -8
  44. package/src/build/README.md +101 -0
  45. package/src/build/build-adapter-serialization.test.ts +268 -0
  46. package/src/build/build-adapter.test.ts +815 -0
  47. package/src/build/build-adapter.ts +235 -6
  48. package/src/build/build-manifest.ts +54 -0
  49. package/src/build/dev-build-coordinator.ts +221 -0
  50. package/src/build/esbuild-build-adapter.ts +132 -83
  51. package/src/build/runtime-build-executor.ts +34 -0
  52. package/src/build/runtime-specifier-alias-plugin.test.ts +43 -0
  53. package/src/build/runtime-specifier-alias-plugin.ts +58 -0
  54. package/src/config/README.md +33 -0
  55. package/src/config/config-builder.test.ts +410 -0
  56. package/src/config/config-builder.ts +281 -49
  57. package/src/constants.ts +15 -0
  58. package/src/declarations.d.ts +18 -13
  59. package/src/eco/README.md +70 -16
  60. package/src/eco/component-render-context.ts +39 -17
  61. package/src/eco/eco.test.ts +678 -0
  62. package/src/eco/eco.ts +29 -8
  63. package/src/eco/eco.types.ts +20 -1
  64. package/src/eco/eco.utils.test.ts +124 -0
  65. package/src/eco/global-injector-map.test.ts +42 -0
  66. package/src/eco/lazy-injector-map.test.ts +66 -0
  67. package/src/eco/module-dependencies.test.ts +30 -0
  68. package/src/errors/http-error.test.ts +134 -0
  69. package/src/global/utils.test.ts +12 -0
  70. package/src/hmr/README.md +26 -0
  71. 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
  72. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  73. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  74. package/src/hmr/client/hmr-runtime.ts +38 -7
  75. package/src/hmr/hmr-strategy.test.ts +124 -0
  76. package/src/hmr/hmr.postcss.test.e2e.ts +41 -0
  77. package/src/hmr/hmr.test.e2e.ts +29 -38
  78. package/src/hmr/strategies/js-hmr-strategy.test.ts +335 -0
  79. package/src/hmr/strategies/js-hmr-strategy.ts +115 -115
  80. package/src/index.ts +1 -1
  81. package/src/integrations/ghtml/ghtml-renderer.test.ts +63 -0
  82. package/src/integrations/ghtml/ghtml-renderer.ts +4 -1
  83. package/src/internal-types.ts +39 -19
  84. package/src/plugins/README.md +34 -0
  85. package/src/plugins/alias-resolver-plugin.test.ts +41 -0
  86. package/src/plugins/alias-resolver-plugin.ts +21 -3
  87. package/src/plugins/eco-component-meta-plugin.test.ts +380 -0
  88. package/src/plugins/eco-component-meta-plugin.ts +10 -3
  89. package/src/plugins/integration-plugin.test.ts +111 -0
  90. package/src/plugins/integration-plugin.ts +45 -3
  91. package/src/plugins/processor.test.ts +148 -0
  92. package/src/plugins/processor.ts +22 -2
  93. package/src/plugins/runtime-capability.ts +14 -0
  94. package/src/public-types.ts +73 -16
  95. package/src/route-renderer/GRAPH.md +16 -20
  96. package/src/route-renderer/README.md +8 -21
  97. package/src/route-renderer/component-graph/component-graph-executor.test.ts +41 -0
  98. package/src/route-renderer/component-graph/component-graph.test.ts +63 -0
  99. package/src/route-renderer/component-graph/component-marker.test.ts +73 -0
  100. package/src/route-renderer/component-graph/component-reference.ts +29 -0
  101. package/src/route-renderer/component-graph/marker-graph-resolver.test.ts +135 -0
  102. package/src/route-renderer/{marker-graph-resolver.ts → component-graph/marker-graph-resolver.ts} +11 -9
  103. package/src/route-renderer/orchestration/integration-renderer.test.ts +936 -0
  104. package/src/route-renderer/{integration-renderer.ts → orchestration/integration-renderer.ts} +113 -19
  105. package/src/route-renderer/orchestration/render-execution.service.test.ts +97 -0
  106. package/src/route-renderer/{render-execution.service.ts → orchestration/render-execution.service.ts} +109 -37
  107. package/src/route-renderer/orchestration/render-preparation.service.test.ts +235 -0
  108. package/src/route-renderer/{render-preparation.service.ts → orchestration/render-preparation.service.ts} +127 -9
  109. package/src/route-renderer/page-loading/dependency-resolver.test.ts +345 -0
  110. package/src/route-renderer/{dependency-resolver.ts → page-loading/dependency-resolver.ts} +28 -12
  111. package/src/route-renderer/page-loading/page-module-loader.test.ts +96 -0
  112. package/src/route-renderer/{page-module-loader.ts → page-loading/page-module-loader.ts} +49 -21
  113. package/src/route-renderer/route-renderer.ts +36 -1
  114. package/src/router/README.md +26 -0
  115. package/src/router/client/link-intent.d.ts +53 -0
  116. package/src/router/client/link-intent.test.browser.ts +51 -0
  117. package/src/router/client/link-intent.ts +92 -0
  118. package/src/router/client/navigation-coordinator.test.ts +237 -0
  119. package/src/router/client/navigation-coordinator.ts +433 -0
  120. package/src/router/server/fs-router-scanner.test.ts +83 -0
  121. package/src/router/{fs-router-scanner.ts → server/fs-router-scanner.ts} +12 -10
  122. package/src/router/server/fs-router.test.ts +214 -0
  123. package/src/router/{fs-router.ts → server/fs-router.ts} +2 -2
  124. package/src/services/README.md +29 -0
  125. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +385 -0
  126. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.ts +101 -6
  127. package/src/services/assets/asset-processing-service/asset.factory.test.ts +63 -0
  128. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.ts +2 -2
  129. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.ts +2 -1
  130. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +72 -0
  131. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +95 -0
  132. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +67 -0
  133. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +78 -0
  134. package/src/services/{asset-processing-service → assets/asset-processing-service}/index.ts +2 -0
  135. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.ts +1 -1
  136. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +59 -0
  137. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.ts +11 -5
  138. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.ts +17 -27
  139. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +286 -0
  140. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.ts +3 -3
  141. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +227 -0
  142. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.ts +5 -4
  143. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +199 -0
  144. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.ts +4 -1
  145. package/src/services/assets/browser-bundle.service.test.ts +36 -0
  146. package/src/services/assets/browser-bundle.service.ts +53 -0
  147. package/src/services/cache/index.ts +3 -3
  148. package/src/services/cache/memory-cache-store.test.ts +225 -0
  149. package/src/services/cache/memory-cache-store.ts +1 -1
  150. package/src/services/cache/page-cache-service.test.ts +175 -0
  151. package/src/services/cache/page-cache-service.ts +3 -3
  152. package/src/services/cache/page-request-cache-coordinator.service.test.ts +79 -0
  153. package/src/services/{page-request-cache-coordinator.service.ts → cache/page-request-cache-coordinator.service.ts} +9 -6
  154. package/src/services/html/html-rewriter-provider.service.test.ts +183 -0
  155. package/src/services/html/html-rewriter-provider.service.ts +103 -0
  156. package/src/services/html/html-transformer.service.test.ts +378 -0
  157. package/src/services/html/html-transformer.service.ts +279 -0
  158. package/src/services/invalidation/development-invalidation.service.test.ts +77 -0
  159. package/src/services/invalidation/development-invalidation.service.ts +261 -0
  160. package/src/services/module-loading/app-server-module-transpiler.service.ts +52 -0
  161. package/src/services/module-loading/page-module-import.service.test.ts +253 -0
  162. package/src/services/module-loading/page-module-import.service.ts +200 -0
  163. package/src/services/module-loading/server-loader.service.test.ts +161 -0
  164. package/src/services/module-loading/server-loader.service.ts +130 -0
  165. package/src/services/module-loading/server-module-transpiler.service.test.ts +115 -0
  166. package/src/services/module-loading/server-module-transpiler.service.ts +105 -0
  167. package/src/services/runtime-manifest/node-runtime-manifest.service.test.ts +95 -0
  168. package/src/services/runtime-manifest/node-runtime-manifest.service.ts +101 -0
  169. package/src/services/runtime-state/dev-graph.service.ts +217 -0
  170. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +136 -0
  171. package/src/services/runtime-state/runtime-specifier-registry.service.ts +96 -0
  172. package/src/services/runtime-state/server-invalidation-state.service.ts +68 -0
  173. package/src/services/validation/schema-validation-service.test.ts +223 -0
  174. package/src/services/{schema-validation-service.ts → validation/schema-validation-service.ts} +1 -1
  175. package/src/static-site-generator/README.md +26 -0
  176. package/src/static-site-generator/static-site-generator.test.ts +307 -0
  177. package/src/static-site-generator/static-site-generator.ts +109 -6
  178. package/src/utils/deep-merge.test.ts +114 -0
  179. package/src/utils/invariant.test.ts +22 -0
  180. package/src/utils/path-utils.test.ts +15 -0
  181. package/src/utils/resolve-work-dir.ts +45 -0
  182. package/src/utils/server-utils.test.ts +38 -0
  183. package/src/watchers/project-watcher.integration.test.ts +337 -0
  184. package/src/watchers/project-watcher.test-helpers.ts +1 -1
  185. package/src/watchers/project-watcher.test.ts +678 -0
  186. package/src/watchers/project-watcher.ts +130 -111
  187. package/CHANGELOG.md +0 -91
  188. package/src/adapters/abstract/application-adapter.d.ts +0 -168
  189. package/src/adapters/abstract/application-adapter.js +0 -109
  190. package/src/adapters/abstract/router-adapter.d.ts +0 -26
  191. package/src/adapters/abstract/router-adapter.js +0 -5
  192. package/src/adapters/abstract/server-adapter.d.ts +0 -69
  193. package/src/adapters/abstract/server-adapter.js +0 -15
  194. package/src/adapters/bun/client-bridge.d.ts +0 -34
  195. package/src/adapters/bun/client-bridge.js +0 -48
  196. package/src/adapters/bun/create-app.d.ts +0 -60
  197. package/src/adapters/bun/create-app.js +0 -117
  198. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  199. package/src/adapters/bun/define-api-handler.js +0 -15
  200. package/src/adapters/bun/define-api-handler.ts +0 -114
  201. package/src/adapters/bun/hmr-manager.d.ts +0 -85
  202. package/src/adapters/bun/hmr-manager.js +0 -240
  203. package/src/adapters/bun/index.d.ts +0 -3
  204. package/src/adapters/bun/index.js +0 -8
  205. package/src/adapters/bun/server-adapter.d.ts +0 -155
  206. package/src/adapters/bun/server-adapter.js +0 -368
  207. package/src/adapters/bun/server-lifecycle.d.ts +0 -52
  208. package/src/adapters/bun/server-lifecycle.js +0 -120
  209. package/src/adapters/index.d.ts +0 -6
  210. package/src/adapters/index.js +0 -14
  211. package/src/adapters/node/create-app.d.ts +0 -21
  212. package/src/adapters/node/create-app.js +0 -143
  213. package/src/adapters/node/index.d.ts +0 -4
  214. package/src/adapters/node/index.js +0 -8
  215. package/src/adapters/node/node-client-bridge.d.ts +0 -26
  216. package/src/adapters/node/node-client-bridge.js +0 -66
  217. package/src/adapters/node/node-hmr-manager.d.ts +0 -63
  218. package/src/adapters/node/node-hmr-manager.js +0 -237
  219. package/src/adapters/node/server-adapter.d.ts +0 -190
  220. package/src/adapters/node/server-adapter.js +0 -420
  221. package/src/adapters/node/static-content-server.d.ts +0 -24
  222. package/src/adapters/node/static-content-server.js +0 -166
  223. package/src/adapters/shared/api-response.d.ts +0 -52
  224. package/src/adapters/shared/api-response.js +0 -96
  225. package/src/adapters/shared/application-adapter.d.ts +0 -18
  226. package/src/adapters/shared/application-adapter.js +0 -90
  227. package/src/adapters/shared/explicit-static-route-matcher.d.ts +0 -38
  228. package/src/adapters/shared/explicit-static-route-matcher.js +0 -100
  229. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +0 -65
  230. package/src/adapters/shared/file-route-middleware-pipeline.js +0 -98
  231. package/src/adapters/shared/fs-server-response-factory.d.ts +0 -19
  232. package/src/adapters/shared/fs-server-response-factory.js +0 -97
  233. package/src/adapters/shared/fs-server-response-matcher.d.ts +0 -71
  234. package/src/adapters/shared/fs-server-response-matcher.js +0 -155
  235. package/src/adapters/shared/render-context.d.ts +0 -14
  236. package/src/adapters/shared/render-context.js +0 -69
  237. package/src/adapters/shared/server-adapter.d.ts +0 -87
  238. package/src/adapters/shared/server-adapter.js +0 -353
  239. package/src/adapters/shared/server-route-handler.d.ts +0 -89
  240. package/src/adapters/shared/server-route-handler.js +0 -120
  241. package/src/adapters/shared/server-static-builder.d.ts +0 -38
  242. package/src/adapters/shared/server-static-builder.js +0 -46
  243. package/src/build/build-adapter.d.ts +0 -74
  244. package/src/build/build-adapter.js +0 -54
  245. package/src/build/build-types.d.ts +0 -57
  246. package/src/build/build-types.js +0 -0
  247. package/src/build/esbuild-build-adapter.d.ts +0 -69
  248. package/src/build/esbuild-build-adapter.js +0 -390
  249. package/src/config/config-builder.d.ts +0 -227
  250. package/src/config/config-builder.js +0 -392
  251. package/src/constants.d.ts +0 -32
  252. package/src/constants.js +0 -21
  253. package/src/create-app.d.ts +0 -17
  254. package/src/create-app.js +0 -66
  255. package/src/define-api-handler.d.ts +0 -25
  256. package/src/define-api-handler.js +0 -15
  257. package/src/dev/sc-server.d.ts +0 -30
  258. package/src/dev/sc-server.js +0 -111
  259. package/src/eco/component-render-context.d.ts +0 -105
  260. package/src/eco/component-render-context.js +0 -77
  261. package/src/eco/eco.d.ts +0 -9
  262. package/src/eco/eco.js +0 -110
  263. package/src/eco/eco.types.d.ts +0 -170
  264. package/src/eco/eco.types.js +0 -0
  265. package/src/eco/eco.utils.d.ts +0 -40
  266. package/src/eco/eco.utils.js +0 -40
  267. package/src/eco/global-injector-map.d.ts +0 -16
  268. package/src/eco/global-injector-map.js +0 -80
  269. package/src/eco/lazy-injector-map.d.ts +0 -8
  270. package/src/eco/lazy-injector-map.js +0 -70
  271. package/src/eco/module-dependencies.d.ts +0 -18
  272. package/src/eco/module-dependencies.js +0 -49
  273. package/src/errors/http-error.d.ts +0 -31
  274. package/src/errors/http-error.js +0 -50
  275. package/src/errors/index.d.ts +0 -2
  276. package/src/errors/index.js +0 -4
  277. package/src/errors/locals-access-error.d.ts +0 -4
  278. package/src/errors/locals-access-error.js +0 -9
  279. package/src/global/app-logger.d.ts +0 -2
  280. package/src/global/app-logger.js +0 -6
  281. package/src/hmr/client/hmr-runtime.d.ts +0 -10
  282. package/src/hmr/client/hmr-runtime.js +0 -86
  283. package/src/hmr/hmr-strategy.d.ts +0 -159
  284. package/src/hmr/hmr-strategy.js +0 -29
  285. package/src/hmr/hmr.test.e2e.d.ts +0 -1
  286. package/src/hmr/hmr.test.e2e.js +0 -50
  287. package/src/hmr/strategies/default-hmr-strategy.d.ts +0 -43
  288. package/src/hmr/strategies/default-hmr-strategy.js +0 -34
  289. package/src/hmr/strategies/js-hmr-strategy.d.ts +0 -136
  290. package/src/hmr/strategies/js-hmr-strategy.js +0 -188
  291. package/src/index.browser.d.ts +0 -3
  292. package/src/index.browser.js +0 -4
  293. package/src/index.d.ts +0 -5
  294. package/src/index.js +0 -10
  295. package/src/integrations/ghtml/ghtml-renderer.d.ts +0 -15
  296. package/src/integrations/ghtml/ghtml-renderer.js +0 -60
  297. package/src/integrations/ghtml/ghtml.plugin.d.ts +0 -20
  298. package/src/integrations/ghtml/ghtml.plugin.js +0 -21
  299. package/src/internal-types.d.ts +0 -200
  300. package/src/internal-types.js +0 -0
  301. package/src/plugins/alias-resolver-plugin.d.ts +0 -2
  302. package/src/plugins/alias-resolver-plugin.js +0 -39
  303. package/src/plugins/eco-component-meta-plugin.d.ts +0 -95
  304. package/src/plugins/eco-component-meta-plugin.js +0 -157
  305. package/src/plugins/integration-plugin.d.ts +0 -102
  306. package/src/plugins/integration-plugin.js +0 -100
  307. package/src/plugins/processor.d.ts +0 -82
  308. package/src/plugins/processor.js +0 -122
  309. package/src/public-types.d.ts +0 -1098
  310. package/src/public-types.js +0 -0
  311. package/src/route-renderer/component-graph-executor.d.ts +0 -32
  312. package/src/route-renderer/component-graph-executor.js +0 -31
  313. package/src/route-renderer/component-graph.d.ts +0 -42
  314. package/src/route-renderer/component-graph.js +0 -72
  315. package/src/route-renderer/component-marker.d.ts +0 -52
  316. package/src/route-renderer/component-marker.js +0 -46
  317. package/src/route-renderer/dependency-resolver.d.ts +0 -24
  318. package/src/route-renderer/dependency-resolver.js +0 -428
  319. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  320. package/src/route-renderer/html-post-processing.service.js +0 -86
  321. package/src/route-renderer/html-post-processing.service.ts +0 -103
  322. package/src/route-renderer/integration-renderer.d.ts +0 -339
  323. package/src/route-renderer/integration-renderer.js +0 -526
  324. package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
  325. package/src/route-renderer/marker-graph-resolver.js +0 -93
  326. package/src/route-renderer/page-module-loader.d.ts +0 -61
  327. package/src/route-renderer/page-module-loader.js +0 -102
  328. package/src/route-renderer/render-execution.service.d.ts +0 -69
  329. package/src/route-renderer/render-execution.service.js +0 -91
  330. package/src/route-renderer/render-preparation.service.d.ts +0 -112
  331. package/src/route-renderer/render-preparation.service.js +0 -243
  332. package/src/route-renderer/route-renderer.d.ts +0 -26
  333. package/src/route-renderer/route-renderer.js +0 -68
  334. package/src/router/fs-router-scanner.d.ts +0 -41
  335. package/src/router/fs-router-scanner.js +0 -155
  336. package/src/router/fs-router.d.ts +0 -26
  337. package/src/router/fs-router.js +0 -100
  338. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  339. package/src/services/asset-processing-service/asset-processing.service.js +0 -250
  340. package/src/services/asset-processing-service/asset.factory.d.ts +0 -17
  341. package/src/services/asset-processing-service/asset.factory.js +0 -82
  342. package/src/services/asset-processing-service/assets.types.d.ts +0 -88
  343. package/src/services/asset-processing-service/assets.types.js +0 -0
  344. package/src/services/asset-processing-service/index.d.ts +0 -3
  345. package/src/services/asset-processing-service/index.js +0 -3
  346. package/src/services/asset-processing-service/processor.interface.d.ts +0 -22
  347. package/src/services/asset-processing-service/processor.interface.js +0 -6
  348. package/src/services/asset-processing-service/processor.registry.d.ts +0 -8
  349. package/src/services/asset-processing-service/processor.registry.js +0 -15
  350. package/src/services/asset-processing-service/processors/base/base-processor.d.ts +0 -24
  351. package/src/services/asset-processing-service/processors/base/base-processor.js +0 -59
  352. package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +0 -16
  353. package/src/services/asset-processing-service/processors/base/base-script-processor.js +0 -80
  354. package/src/services/asset-processing-service/processors/index.d.ts +0 -5
  355. package/src/services/asset-processing-service/processors/index.js +0 -5
  356. package/src/services/asset-processing-service/processors/script/content-script.processor.d.ts +0 -5
  357. package/src/services/asset-processing-service/processors/script/content-script.processor.js +0 -57
  358. package/src/services/asset-processing-service/processors/script/file-script.processor.d.ts +0 -8
  359. package/src/services/asset-processing-service/processors/script/file-script.processor.js +0 -76
  360. package/src/services/asset-processing-service/processors/script/node-module-script.processor.d.ts +0 -7
  361. package/src/services/asset-processing-service/processors/script/node-module-script.processor.js +0 -74
  362. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +0 -5
  363. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
  364. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +0 -9
  365. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +0 -63
  366. package/src/services/cache/cache.types.d.ts +0 -107
  367. package/src/services/cache/cache.types.js +0 -0
  368. package/src/services/cache/index.d.ts +0 -7
  369. package/src/services/cache/index.js +0 -7
  370. package/src/services/cache/memory-cache-store.d.ts +0 -42
  371. package/src/services/cache/memory-cache-store.js +0 -98
  372. package/src/services/cache/page-cache-service.d.ts +0 -70
  373. package/src/services/cache/page-cache-service.js +0 -152
  374. package/src/services/html-transformer.service.d.ts +0 -50
  375. package/src/services/html-transformer.service.js +0 -163
  376. package/src/services/html-transformer.service.ts +0 -217
  377. package/src/services/page-module-import.service.d.ts +0 -37
  378. package/src/services/page-module-import.service.js +0 -88
  379. package/src/services/page-module-import.service.ts +0 -129
  380. package/src/services/page-request-cache-coordinator.service.d.ts +0 -75
  381. package/src/services/page-request-cache-coordinator.service.js +0 -107
  382. package/src/services/schema-validation-service.d.ts +0 -122
  383. package/src/services/schema-validation-service.js +0 -101
  384. package/src/services/validation/standard-schema.types.d.ts +0 -65
  385. package/src/services/validation/standard-schema.types.js +0 -0
  386. package/src/static-site-generator/static-site-generator.d.ts +0 -57
  387. package/src/static-site-generator/static-site-generator.js +0 -272
  388. package/src/utils/css.d.ts +0 -1
  389. package/src/utils/css.js +0 -7
  390. package/src/utils/deep-merge.d.ts +0 -14
  391. package/src/utils/deep-merge.js +0 -32
  392. package/src/utils/hash.d.ts +0 -1
  393. package/src/utils/hash.js +0 -7
  394. package/src/utils/html.d.ts +0 -1
  395. package/src/utils/html.js +0 -4
  396. package/src/utils/invariant.d.ts +0 -5
  397. package/src/utils/invariant.js +0 -11
  398. package/src/utils/locals-utils.d.ts +0 -15
  399. package/src/utils/locals-utils.js +0 -24
  400. package/src/utils/parse-cli-args.d.ts +0 -24
  401. package/src/utils/parse-cli-args.js +0 -47
  402. package/src/utils/path-utils.module.d.ts +0 -5
  403. package/src/utils/path-utils.module.js +0 -14
  404. package/src/utils/runtime.d.ts +0 -11
  405. package/src/utils/runtime.js +0 -40
  406. package/src/utils/server-utils.module.d.ts +0 -19
  407. package/src/utils/server-utils.module.js +0 -56
  408. package/src/watchers/project-watcher.d.ts +0 -125
  409. package/src/watchers/project-watcher.js +0 -265
  410. package/src/watchers/project-watcher.test-helpers.d.ts +0 -4
  411. package/src/watchers/project-watcher.test-helpers.js +0 -52
  412. /package/src/route-renderer/{component-graph-executor.ts → component-graph/component-graph-executor.ts} +0 -0
  413. /package/src/route-renderer/{component-graph.ts → component-graph/component-graph.ts} +0 -0
  414. /package/src/route-renderer/{component-marker.ts → component-graph/component-marker.ts} +0 -0
  415. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.ts +0 -0
  416. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/index.ts +0 -0
  417. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.ts +0 -0
  418. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.ts +0 -0
@@ -1,61 +0,0 @@
1
- import type { EcoPageFile, GetMetadata, GetMetadataContext, GetStaticProps, PageMetadataProps, RouteRendererOptions, EcoPageComponent } from '../public-types.js';
2
- import type { EcoPagesAppConfig } from '../internal-types.js';
3
- /**
4
- * Handles page module loading plus static props/metadata resolution.
5
- */
6
- export declare class PageModuleLoaderService {
7
- private appConfig;
8
- private runtimeOrigin;
9
- private pageModuleImportService;
10
- constructor(appConfig: EcoPagesAppConfig, runtimeOrigin: string);
11
- /**
12
- * Imports a page module from source.
13
- * Uses direct dynamic import in Bun and transpile+import fallback for other runtimes.
14
- */
15
- importPageFile(file: string): Promise<EcoPageFile>;
16
- /**
17
- * Executes `getStaticProps` with Ecopages runtime context.
18
- * Returns an empty props object when no static props function is defined.
19
- */
20
- getStaticPropsForPage(options: {
21
- getStaticProps?: GetStaticProps<Record<string, unknown>>;
22
- params?: RouteRendererOptions['params'];
23
- }): Promise<{
24
- props: Record<string, unknown>;
25
- metadata?: PageMetadataProps;
26
- }>;
27
- /**
28
- * Builds final page metadata using app-level defaults as a baseline.
29
- * If `getMetadata` exists, its result overlays defaults so page-level fields take precedence.
30
- */
31
- getMetadataPropsForPage(options: {
32
- getMetadata: GetMetadata | undefined;
33
- context: GetMetadataContext;
34
- }): Promise<PageMetadataProps>;
35
- /**
36
- * Loads a page module and normalizes integration-facing exports.
37
- * When both component static methods and module exports exist, component statics win.
38
- */
39
- resolvePageModule(options: {
40
- file: string;
41
- importPageFileFn?: (file: string) => Promise<EcoPageFile>;
42
- }): Promise<{
43
- Page: EcoPageFile['default'] | EcoPageComponent<any>;
44
- getStaticProps?: GetStaticProps<Record<string, unknown>>;
45
- getMetadata?: GetMetadata;
46
- integrationSpecificProps: Record<string, unknown>;
47
- }>;
48
- /**
49
- * Resolves render-time page data in order: static props first, then metadata derived from those props.
50
- */
51
- resolvePageData(options: {
52
- pageModule: {
53
- getStaticProps?: GetStaticProps<Record<string, unknown>>;
54
- getMetadata?: GetMetadata;
55
- };
56
- routeOptions: RouteRendererOptions;
57
- }): Promise<{
58
- props: Record<string, unknown>;
59
- metadata: PageMetadataProps;
60
- }>;
61
- }
@@ -1,102 +0,0 @@
1
- import { invariant } from "../utils/invariant.js";
2
- import { PageModuleImportService } from "../services/page-module-import.service.js";
3
- class PageModuleLoaderService {
4
- constructor(appConfig, runtimeOrigin) {
5
- this.appConfig = appConfig;
6
- this.runtimeOrigin = runtimeOrigin;
7
- this.pageModuleImportService = new PageModuleImportService();
8
- }
9
- pageModuleImportService;
10
- /**
11
- * Imports a page module from source.
12
- * Uses direct dynamic import in Bun and transpile+import fallback for other runtimes.
13
- */
14
- async importPageFile(file) {
15
- try {
16
- return await this.pageModuleImportService.importModule({
17
- filePath: file,
18
- rootDir: this.appConfig.rootDir,
19
- outdir: `${this.appConfig.absolutePaths.distDir}/.server-modules`,
20
- transpileErrorMessage: (details) => `Error transpiling page file: ${details}`,
21
- noOutputMessage: (targetFilePath) => `No transpiled output generated for page: ${targetFilePath}`
22
- });
23
- } catch (error) {
24
- invariant(false, `Error importing page file: ${error}`);
25
- }
26
- }
27
- /**
28
- * Executes `getStaticProps` with Ecopages runtime context.
29
- * Returns an empty props object when no static props function is defined.
30
- */
31
- async getStaticPropsForPage(options) {
32
- const { getStaticProps, params } = options;
33
- return getStaticProps ? await getStaticProps({
34
- pathname: { params: params ?? {} },
35
- appConfig: this.appConfig,
36
- runtimeOrigin: this.runtimeOrigin
37
- }).then((data) => data).catch((err) => {
38
- throw new Error(`Error fetching static props: ${err.message}`);
39
- }) : {
40
- props: {},
41
- metadata: void 0
42
- };
43
- }
44
- /**
45
- * Builds final page metadata using app-level defaults as a baseline.
46
- * If `getMetadata` exists, its result overlays defaults so page-level fields take precedence.
47
- */
48
- async getMetadataPropsForPage(options) {
49
- const { getMetadata, context } = options;
50
- let metadata = this.appConfig.defaultMetadata;
51
- if (getMetadata) {
52
- const dynamicMetadata = await getMetadata({
53
- params: context.params,
54
- query: context.query,
55
- props: context.props,
56
- appConfig: this.appConfig
57
- });
58
- metadata = { ...metadata, ...dynamicMetadata };
59
- }
60
- return metadata;
61
- }
62
- /**
63
- * Loads a page module and normalizes integration-facing exports.
64
- * When both component static methods and module exports exist, component statics win.
65
- */
66
- async resolvePageModule(options) {
67
- const module = await (options.importPageFileFn ?? ((file) => this.importPageFile(file)))(options.file);
68
- const {
69
- default: Page,
70
- getStaticProps: moduleGetStaticProps,
71
- getMetadata: moduleGetMetadata,
72
- ...integrationSpecificProps
73
- } = module;
74
- return {
75
- Page,
76
- getStaticProps: Page.staticProps ?? moduleGetStaticProps,
77
- getMetadata: Page.metadata ?? moduleGetMetadata,
78
- integrationSpecificProps
79
- };
80
- }
81
- /**
82
- * Resolves render-time page data in order: static props first, then metadata derived from those props.
83
- */
84
- async resolvePageData(options) {
85
- const { props } = await this.getStaticPropsForPage({
86
- getStaticProps: options.pageModule.getStaticProps,
87
- params: options.routeOptions.params
88
- });
89
- const metadata = await this.getMetadataPropsForPage({
90
- getMetadata: options.pageModule.getMetadata,
91
- context: {
92
- props,
93
- params: options.routeOptions.params ?? {},
94
- query: options.routeOptions.query ?? {}
95
- }
96
- });
97
- return { props, metadata };
98
- }
99
- }
100
- export {
101
- PageModuleLoaderService
102
- };
@@ -1,69 +0,0 @@
1
- import { type ComponentRenderBoundaryContext } from '../eco/component-render-context.js';
2
- import type { EcoComponent, IntegrationRendererRenderOptions, RouteRendererBody, RouteRendererOptions, RouteRenderResult } from '../public-types.js';
3
- import type { ProcessedAsset } from '../services/asset-processing-service/index.js';
4
- import type { MarkerGraphContext } from './marker-graph-resolver.js';
5
- /**
6
- * Serializable graph context merged from render-time captured references and
7
- * optional explicit page-module graph metadata.
8
- */
9
- export type RenderExecutionGraphContext = {
10
- propsByRef?: Record<string, Record<string, unknown>>;
11
- slotChildrenByRef?: MarkerGraphContext['slotChildrenByRef'];
12
- };
13
- export interface RenderExecutionCallbacks<C> {
14
- prepareRenderOptions(options: RouteRendererOptions): Promise<IntegrationRendererRenderOptions<C>>;
15
- render(renderOptions: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
16
- getComponentRenderBoundaryContext(): ComponentRenderBoundaryContext;
17
- resolveMarkerGraphHtml(input: {
18
- html: string;
19
- componentsToResolve: EcoComponent[];
20
- graphContext: RenderExecutionGraphContext;
21
- }): Promise<{
22
- html: string;
23
- assets: ProcessedAsset[];
24
- }>;
25
- dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[];
26
- getProcessedDependencies(): ProcessedAsset[];
27
- setProcessedDependencies(dependencies: ProcessedAsset[]): void;
28
- applyAttributesToFirstBodyElement(html: string, attributes: Record<string, string>): string;
29
- transformHtml(html: string): Promise<RouteRendererBody>;
30
- }
31
- /**
32
- * Executes the main post-preparation rendering flow for integration renderers.
33
- *
34
- * This service owns the orchestration that happens after normalized render
35
- * options have been prepared: the first render pass, graph-context capture,
36
- * deferred marker resolution, root-attribute application, and final HTML
37
- * transformation into a response body stream.
38
- */
39
- export declare class RenderExecutionService {
40
- /**
41
- * Executes one integration render pass and returns the final route render
42
- * result.
43
- *
44
- * @typeParam C Integration render output element type.
45
- * @param options Route-level render options.
46
- * @param currentIntegrationName Active integration name for this render pass.
47
- * @param callbacks Renderer-specific hooks required during execution.
48
- * @returns Final route render output with body and cache strategy.
49
- */
50
- execute<C = unknown>(options: RouteRendererOptions, currentIntegrationName: string, callbacks: RenderExecutionCallbacks<C>): Promise<RouteRenderResult>;
51
- /**
52
- * Merges captured render-time graph references with any explicit graph context
53
- * provided by the page module.
54
- *
55
- * @param capturedGraphContext Graph context captured from the first render pass.
56
- * @param explicitGraphContext Optional page-module graph metadata.
57
- * @returns Merged graph context used during marker resolution.
58
- */
59
- private mergeGraphContext;
60
- /**
61
- * Returns the component set that participates in marker graph resolution for a
62
- * render pass.
63
- *
64
- * @typeParam C Integration render output element type.
65
- * @param renderOptions Normalized render options for the pass.
66
- * @returns Ordered component list for graph registry construction.
67
- */
68
- private getComponentsToResolve;
69
- }
@@ -1,91 +0,0 @@
1
- import {
2
- runWithComponentRenderContext
3
- } from "../eco/component-render-context.js";
4
- class RenderExecutionService {
5
- /**
6
- * Executes one integration render pass and returns the final route render
7
- * result.
8
- *
9
- * @typeParam C Integration render output element type.
10
- * @param options Route-level render options.
11
- * @param currentIntegrationName Active integration name for this render pass.
12
- * @param callbacks Renderer-specific hooks required during execution.
13
- * @returns Final route render output with body and cache strategy.
14
- */
15
- async execute(options, currentIntegrationName, callbacks) {
16
- const renderOptions = await callbacks.prepareRenderOptions(options);
17
- const shouldApplyComponentRootAttributes = renderOptions.componentRender?.canAttachAttributes && renderOptions.componentRender.rootAttributes && Object.keys(renderOptions.componentRender.rootAttributes).length > 0;
18
- const renderExecution = await runWithComponentRenderContext(
19
- {
20
- currentIntegration: currentIntegrationName,
21
- boundaryContext: callbacks.getComponentRenderBoundaryContext()
22
- },
23
- async () => callbacks.render(renderOptions)
24
- );
25
- let renderedHtml = await new Response(renderExecution.value).text();
26
- const componentGraphContext = this.mergeGraphContext(
27
- renderExecution.graphContext,
28
- renderOptions.componentGraphContext
29
- );
30
- if (renderedHtml.includes("<eco-marker")) {
31
- const markerResolution = await callbacks.resolveMarkerGraphHtml({
32
- html: renderedHtml,
33
- componentsToResolve: this.getComponentsToResolve(renderOptions),
34
- graphContext: componentGraphContext
35
- });
36
- renderedHtml = markerResolution.html;
37
- if (markerResolution.assets.length > 0) {
38
- const mergedDependencies = callbacks.dedupeProcessedAssets([
39
- ...callbacks.getProcessedDependencies(),
40
- ...markerResolution.assets
41
- ]);
42
- callbacks.setProcessedDependencies(mergedDependencies);
43
- }
44
- }
45
- if (shouldApplyComponentRootAttributes) {
46
- renderedHtml = callbacks.applyAttributesToFirstBodyElement(
47
- renderedHtml,
48
- renderOptions.componentRender?.rootAttributes
49
- );
50
- }
51
- const body = await callbacks.transformHtml(renderedHtml);
52
- return {
53
- body,
54
- cacheStrategy: renderOptions.cacheStrategy
55
- };
56
- }
57
- /**
58
- * Merges captured render-time graph references with any explicit graph context
59
- * provided by the page module.
60
- *
61
- * @param capturedGraphContext Graph context captured from the first render pass.
62
- * @param explicitGraphContext Optional page-module graph metadata.
63
- * @returns Merged graph context used during marker resolution.
64
- */
65
- mergeGraphContext(capturedGraphContext, explicitGraphContext) {
66
- return {
67
- propsByRef: {
68
- ...capturedGraphContext.propsByRef ?? {},
69
- ...explicitGraphContext?.propsByRef ?? {}
70
- },
71
- slotChildrenByRef: {
72
- ...capturedGraphContext.slotChildrenByRef ?? {},
73
- ...explicitGraphContext?.slotChildrenByRef ?? {}
74
- }
75
- };
76
- }
77
- /**
78
- * Returns the component set that participates in marker graph resolution for a
79
- * render pass.
80
- *
81
- * @typeParam C Integration render output element type.
82
- * @param renderOptions Normalized render options for the pass.
83
- * @returns Ordered component list for graph registry construction.
84
- */
85
- getComponentsToResolve(renderOptions) {
86
- return renderOptions.Layout ? [renderOptions.HtmlTemplate, renderOptions.Layout, renderOptions.Page] : [renderOptions.HtmlTemplate, renderOptions.Page];
87
- }
88
- }
89
- export {
90
- RenderExecutionService
91
- };
@@ -1,112 +0,0 @@
1
- import type { EcoPagesAppConfig } from '../internal-types.js';
2
- import type { ComponentRenderResult, EcoComponent, EcoPageComponent, EcoPageFile, EcoPagesElement, GetMetadata, GetStaticProps, HtmlTemplateProps, IntegrationRendererRenderOptions, PageMetadataProps, RouteRendererOptions } from '../public-types.js';
3
- import { type AssetProcessingService, type ProcessedAsset } from '../services/asset-processing-service/index.js';
4
- import { type ComponentRenderBoundaryContext } from '../eco/component-render-context.js';
5
- type ResolvedPageModule = {
6
- Page: EcoPageFile['default'] | EcoPageComponent<any>;
7
- getStaticProps?: GetStaticProps<Record<string, unknown>>;
8
- getMetadata?: GetMetadata;
9
- integrationSpecificProps: Record<string, unknown>;
10
- };
11
- export interface RenderPreparationCallbacks {
12
- resolvePageModule(file: string): Promise<ResolvedPageModule>;
13
- getHtmlTemplate(): Promise<EcoComponent<HtmlTemplateProps>>;
14
- resolvePageData(pageModule: {
15
- getStaticProps?: GetStaticProps<Record<string, unknown>>;
16
- getMetadata?: GetMetadata;
17
- }, routeOptions: RouteRendererOptions): Promise<{
18
- props: Record<string, unknown>;
19
- metadata: PageMetadataProps;
20
- }>;
21
- resolveDependencies(components: (EcoComponent | Partial<EcoComponent>)[]): Promise<ProcessedAsset[]>;
22
- buildRouteRenderAssets(file: string): Promise<ProcessedAsset[]> | undefined;
23
- shouldRenderPageComponent(input: {
24
- Page: EcoComponent;
25
- Layout?: EcoComponent;
26
- options: RouteRendererOptions;
27
- }): boolean;
28
- renderPageComponent(input: {
29
- component: EcoComponent;
30
- props: Record<string, unknown>;
31
- }): Promise<ComponentRenderResult>;
32
- /**
33
- * Returns the boundary policy context that should be active while rendering
34
- * page-root component output during preparation.
35
- */
36
- getComponentRenderBoundaryContext(): ComponentRenderBoundaryContext;
37
- setProcessedDependencies(dependencies: ProcessedAsset[]): void;
38
- dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[];
39
- createPageLocalsProxy(filePath: string): RouteRendererOptions['locals'];
40
- }
41
- /**
42
- * Prepares the normalized render inputs consumed by `IntegrationRenderer.execute()`.
43
- *
44
- * This service owns the orchestration that happens before the main HTML render:
45
- * page module resolution, data loading, dependency aggregation, page-root
46
- * component artifact capture, lazy trigger bootstrap generation, and request
47
- * locals policy.
48
- */
49
- export declare class RenderPreparationService {
50
- private appConfig;
51
- private assetProcessingService;
52
- constructor(appConfig: EcoPagesAppConfig, assetProcessingService: AssetProcessingService);
53
- /**
54
- * Builds the final render options object used by the integration-specific
55
- * renderer.
56
- *
57
- * The returned object contains normalized page data, processed dependency
58
- * state, component render artifacts, and the locals contract expected by the
59
- * rest of the pipeline.
60
- *
61
- * @typeParam C Integration render output element type.
62
- * @param routeOptions Route-level render inputs.
63
- * @param currentIntegrationName Active integration name for this preparation pass.
64
- * @param callbacks Renderer-specific hooks used during preparation.
65
- * @returns Normalized render options.
66
- */
67
- prepare<C = EcoPagesElement>(routeOptions: RouteRendererOptions, currentIntegrationName: string, callbacks: RenderPreparationCallbacks): Promise<IntegrationRendererRenderOptions<C>>;
68
- /**
69
- * Collects resolved lazy trigger metadata from the component tree.
70
- *
71
- * Traversal is depth-first and deduplicated by component identity so shared
72
- * component dependencies do not emit duplicate trigger sets.
73
- *
74
- * @param components Root component set.
75
- * @param seen Internal visited set for shared graphs.
76
- * @returns All resolved lazy triggers reachable from the root set.
77
- */
78
- private collectResolvedTriggers;
79
- /**
80
- * Collects global integration dependencies used by nested components belonging
81
- * to integrations other than the current renderer.
82
- *
83
- * @param components Root component set.
84
- * @returns Processed integration dependencies contributed by nested integrations.
85
- */
86
- private collectUsedIntegrationDependencies;
87
- /**
88
- * Discovers integration names referenced by the component dependency graph.
89
- *
90
- * @param components Root component set.
91
- * @param seen Internal visited set for shared graphs.
92
- * @returns Set of integration names found in the graph.
93
- */
94
- private collectIntegrationNames;
95
- /**
96
- * Renders the page root through the component-level render contract so any
97
- * integration-specific assets and root attributes are available before the main
98
- * document render.
99
- *
100
- * @param input Page root render inputs.
101
- * @returns Structured component render result.
102
- */
103
- private renderPageRoot;
104
- /**
105
- * Builds the runtime assets needed to bootstrap global lazy trigger execution.
106
- *
107
- * @param triggers Fully resolved lazy trigger definitions.
108
- * @returns Processed assets that should be merged into the final dependency set.
109
- */
110
- private buildGlobalInjectorAssets;
111
- }
112
- export {};
@@ -1,243 +0,0 @@
1
- import { createRequire } from "node:module";
2
- import {
3
- AssetFactory
4
- } from "../services/asset-processing-service/index.js";
5
- import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from "../eco/global-injector-map.js";
6
- import { runWithComponentRenderContext } from "../eco/component-render-context.js";
7
- const coreRequire = createRequire(import.meta.url);
8
- class RenderPreparationService {
9
- constructor(appConfig, assetProcessingService) {
10
- this.appConfig = appConfig;
11
- this.assetProcessingService = assetProcessingService;
12
- }
13
- /**
14
- * Builds the final render options object used by the integration-specific
15
- * renderer.
16
- *
17
- * The returned object contains normalized page data, processed dependency
18
- * state, component render artifacts, and the locals contract expected by the
19
- * rest of the pipeline.
20
- *
21
- * @typeParam C Integration render output element type.
22
- * @param routeOptions Route-level render inputs.
23
- * @param currentIntegrationName Active integration name for this preparation pass.
24
- * @param callbacks Renderer-specific hooks used during preparation.
25
- * @returns Normalized render options.
26
- */
27
- async prepare(routeOptions, currentIntegrationName, callbacks) {
28
- const pageModule = await callbacks.resolvePageModule(routeOptions.file);
29
- const { Page, integrationSpecificProps } = pageModule;
30
- const HtmlTemplate = await callbacks.getHtmlTemplate();
31
- const { props, metadata } = await callbacks.resolvePageData(pageModule, routeOptions);
32
- const Layout = Page.config?.layout;
33
- const componentsToResolve = Layout ? [HtmlTemplate, Layout, Page] : [HtmlTemplate, Page];
34
- const resolvedDependencies = await callbacks.resolveDependencies(componentsToResolve);
35
- const usedIntegrationDependencies = this.collectUsedIntegrationDependencies(
36
- componentsToResolve,
37
- currentIntegrationName
38
- );
39
- const pageDeps = await callbacks.buildRouteRenderAssets(routeOptions.file) || [];
40
- const allDependencies = [...resolvedDependencies, ...usedIntegrationDependencies, ...pageDeps];
41
- let componentRender;
42
- if (callbacks.shouldRenderPageComponent({ Page, Layout, options: routeOptions })) {
43
- componentRender = await this.renderPageRoot({
44
- currentIntegrationName,
45
- Page,
46
- props,
47
- routeOptions,
48
- callbacks
49
- });
50
- if (componentRender.assets?.length) {
51
- allDependencies.push(...componentRender.assets);
52
- }
53
- }
54
- const triggers = this.collectResolvedTriggers(componentsToResolve);
55
- if (triggers.length > 0) {
56
- const globalAssets = await this.buildGlobalInjectorAssets(triggers, currentIntegrationName);
57
- allDependencies.push(...globalAssets);
58
- }
59
- callbacks.setProcessedDependencies(callbacks.dedupeProcessedAssets(allDependencies));
60
- const pageProps = {
61
- ...props,
62
- params: routeOptions.params || {},
63
- query: routeOptions.query || {}
64
- };
65
- const cacheStrategy = Page.cache;
66
- const defaultCacheStrategy = this.appConfig.cache?.defaultStrategy ?? "static";
67
- const effectiveCacheStrategy = cacheStrategy ?? defaultCacheStrategy;
68
- const localsAvailable = effectiveCacheStrategy === "dynamic" && routeOptions.locals !== void 0;
69
- const pageLocals = localsAvailable ? routeOptions.locals : callbacks.createPageLocalsProxy(routeOptions.file);
70
- const locals = localsAvailable ? routeOptions.locals : void 0;
71
- const preparedOptions = {
72
- ...routeOptions,
73
- resolvedDependencies,
74
- componentRender,
75
- HtmlTemplate,
76
- Layout,
77
- props,
78
- Page,
79
- metadata,
80
- params: routeOptions.params || {},
81
- query: routeOptions.query || {},
82
- pageProps,
83
- locals,
84
- pageLocals,
85
- cacheStrategy
86
- };
87
- return {
88
- ...integrationSpecificProps,
89
- ...preparedOptions
90
- };
91
- }
92
- /**
93
- * Collects resolved lazy trigger metadata from the component tree.
94
- *
95
- * Traversal is depth-first and deduplicated by component identity so shared
96
- * component dependencies do not emit duplicate trigger sets.
97
- *
98
- * @param components Root component set.
99
- * @param seen Internal visited set for shared graphs.
100
- * @returns All resolved lazy triggers reachable from the root set.
101
- */
102
- collectResolvedTriggers(components, seen = /* @__PURE__ */ new Set()) {
103
- const triggers = [];
104
- for (const comp of components) {
105
- const ecoComp = comp;
106
- if (seen.has(ecoComp)) {
107
- continue;
108
- }
109
- seen.add(ecoComp);
110
- const ownTriggers = ecoComp.config?._resolvedLazyTriggers;
111
- if (ownTriggers?.length) {
112
- triggers.push(...ownTriggers);
113
- }
114
- const nested = ecoComp.config?.dependencies?.components;
115
- if (nested?.length) {
116
- triggers.push(...this.collectResolvedTriggers(nested, seen));
117
- }
118
- }
119
- return triggers;
120
- }
121
- /**
122
- * Collects global integration dependencies used by nested components belonging
123
- * to integrations other than the current renderer.
124
- *
125
- * @param components Root component set.
126
- * @returns Processed integration dependencies contributed by nested integrations.
127
- */
128
- collectUsedIntegrationDependencies(components, currentIntegrationName) {
129
- const integrationNames = this.collectIntegrationNames(components);
130
- const dependencies = [];
131
- for (const integrationName of integrationNames) {
132
- if (integrationName === currentIntegrationName) {
133
- continue;
134
- }
135
- const integrationPlugin = this.appConfig.integrations.find(
136
- (integration) => integration.name === integrationName
137
- );
138
- if (!integrationPlugin || typeof integrationPlugin.getResolvedIntegrationDependencies !== "function") {
139
- continue;
140
- }
141
- dependencies.push(...integrationPlugin.getResolvedIntegrationDependencies());
142
- }
143
- return dependencies;
144
- }
145
- /**
146
- * Discovers integration names referenced by the component dependency graph.
147
- *
148
- * @param components Root component set.
149
- * @param seen Internal visited set for shared graphs.
150
- * @returns Set of integration names found in the graph.
151
- */
152
- collectIntegrationNames(components, seen = /* @__PURE__ */ new Set()) {
153
- const integrationNames = /* @__PURE__ */ new Set();
154
- for (const comp of components) {
155
- const ecoComp = comp;
156
- if (seen.has(ecoComp)) {
157
- continue;
158
- }
159
- seen.add(ecoComp);
160
- const integrationName = ecoComp.config?.integration ?? ecoComp.config?.__eco?.integration;
161
- if (integrationName) {
162
- integrationNames.add(integrationName);
163
- }
164
- const nested = ecoComp.config?.dependencies?.components;
165
- if (nested?.length) {
166
- const nestedNames = this.collectIntegrationNames(nested, seen);
167
- for (const nestedName of nestedNames) {
168
- integrationNames.add(nestedName);
169
- }
170
- }
171
- }
172
- return integrationNames;
173
- }
174
- /**
175
- * Renders the page root through the component-level render contract so any
176
- * integration-specific assets and root attributes are available before the main
177
- * document render.
178
- *
179
- * @param input Page root render inputs.
180
- * @returns Structured component render result.
181
- */
182
- async renderPageRoot(input) {
183
- const execution = await runWithComponentRenderContext(
184
- {
185
- currentIntegration: input.currentIntegrationName,
186
- boundaryContext: input.callbacks.getComponentRenderBoundaryContext()
187
- },
188
- async () => input.callbacks.renderPageComponent({
189
- component: input.Page,
190
- props: {
191
- ...input.props,
192
- params: input.routeOptions.params || {},
193
- query: input.routeOptions.query || {}
194
- }
195
- })
196
- );
197
- return execution.value;
198
- }
199
- /**
200
- * Builds the runtime assets needed to bootstrap global lazy trigger execution.
201
- *
202
- * @param triggers Fully resolved lazy trigger definitions.
203
- * @returns Processed assets that should be merged into the final dependency set.
204
- */
205
- async buildGlobalInjectorAssets(triggers, currentIntegrationName) {
206
- const globalInjectorImportPath = coreRequire.resolve("@ecopages/scripts-injector/global");
207
- const globalInjectorRuntimeAsset = AssetFactory.createNodeModuleScript({
208
- position: "head",
209
- name: "ecopages-scripts-injector-global",
210
- importPath: globalInjectorImportPath,
211
- excludeFromHtml: true
212
- });
213
- const [globalInjectorRuntimeProcessed] = await this.assetProcessingService.processDependencies(
214
- [globalInjectorRuntimeAsset],
215
- currentIntegrationName
216
- );
217
- const globalInjectorModuleUrl = globalInjectorRuntimeProcessed?.srcUrl;
218
- if (!globalInjectorModuleUrl) {
219
- throw new Error("[ecopages] Failed to resolve global injector runtime asset URL.");
220
- }
221
- const mapScript = AssetFactory.createInlineContentScript({
222
- position: "head",
223
- name: "ecopages-global-injector-map",
224
- content: buildGlobalInjectorMapScript(triggers),
225
- attributes: { type: "ecopages/global-injector-map" },
226
- bundle: false
227
- });
228
- const bootstrapScript = AssetFactory.createContentScript({
229
- position: "head",
230
- name: "ecopages-global-injector-bootstrap",
231
- content: buildGlobalInjectorBootstrapContent(globalInjectorModuleUrl),
232
- attributes: { type: "module" },
233
- bundle: false
234
- });
235
- return this.assetProcessingService.processDependencies(
236
- [mapScript, bootstrapScript, globalInjectorRuntimeAsset],
237
- currentIntegrationName
238
- );
239
- }
240
- }
241
- export {
242
- RenderPreparationService
243
- };