@ecopages/core 0.2.0-alpha.7 → 0.2.0-alpha.8

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 (354) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/package.json +212 -92
  3. package/src/adapters/abstract/application-adapter.d.ts +168 -0
  4. package/src/adapters/abstract/application-adapter.js +109 -0
  5. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  6. package/src/adapters/abstract/router-adapter.js +5 -0
  7. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  8. package/src/adapters/abstract/server-adapter.js +15 -0
  9. package/src/adapters/bun/client-bridge.d.ts +34 -0
  10. package/src/adapters/bun/client-bridge.js +48 -0
  11. package/src/adapters/bun/create-app.d.ts +60 -0
  12. package/src/adapters/bun/create-app.js +117 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +143 -0
  14. package/src/adapters/bun/hmr-manager.js +334 -0
  15. package/src/adapters/bun/index.d.ts +2 -0
  16. package/src/adapters/bun/index.js +8 -0
  17. package/src/adapters/bun/server-adapter.d.ts +155 -0
  18. package/src/adapters/bun/server-adapter.js +373 -0
  19. package/src/adapters/bun/server-lifecycle.d.ts +63 -0
  20. package/src/adapters/bun/server-lifecycle.js +92 -0
  21. package/src/adapters/index.d.ts +6 -0
  22. package/src/adapters/index.js +14 -0
  23. package/src/adapters/node/bootstrap-dependency-resolver.d.ts +44 -0
  24. package/src/adapters/node/bootstrap-dependency-resolver.js +172 -0
  25. package/src/adapters/node/create-app.d.ts +21 -0
  26. package/src/adapters/node/create-app.js +143 -0
  27. package/src/adapters/node/index.d.ts +6 -0
  28. package/src/adapters/node/index.js +11 -0
  29. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  30. package/src/adapters/node/node-client-bridge.js +66 -0
  31. package/src/adapters/node/node-hmr-manager.d.ts +133 -0
  32. package/src/adapters/node/node-hmr-manager.js +312 -0
  33. package/src/adapters/node/runtime-adapter.d.ts +46 -0
  34. package/src/adapters/node/runtime-adapter.js +306 -0
  35. package/src/adapters/node/server-adapter.d.ts +161 -0
  36. package/src/adapters/node/server-adapter.js +358 -0
  37. package/src/adapters/node/static-content-server.d.ts +60 -0
  38. package/src/adapters/node/static-content-server.js +194 -0
  39. package/src/adapters/node/write-runtime-manifest.d.ts +26 -0
  40. package/src/adapters/node/write-runtime-manifest.js +12 -0
  41. package/src/adapters/shared/api-response.d.ts +52 -0
  42. package/src/adapters/shared/api-response.js +96 -0
  43. package/src/adapters/shared/application-adapter.d.ts +18 -0
  44. package/src/adapters/shared/application-adapter.js +90 -0
  45. package/src/adapters/shared/define-api-handler.d.ts +25 -0
  46. package/src/adapters/shared/define-api-handler.js +15 -0
  47. package/src/adapters/shared/explicit-static-route-matcher.d.ts +38 -0
  48. package/src/adapters/shared/explicit-static-route-matcher.js +103 -0
  49. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
  50. package/src/adapters/shared/file-route-middleware-pipeline.js +99 -0
  51. package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
  52. package/src/adapters/shared/fs-server-response-factory.js +97 -0
  53. package/src/adapters/shared/fs-server-response-matcher.d.ts +75 -0
  54. package/src/adapters/shared/fs-server-response-matcher.js +160 -0
  55. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  56. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  57. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  58. package/src/adapters/shared/hmr-html-response.js +32 -0
  59. package/src/adapters/shared/render-context.d.ts +14 -0
  60. package/src/adapters/shared/render-context.js +70 -0
  61. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  62. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  63. package/src/adapters/shared/server-adapter.d.ts +97 -0
  64. package/src/adapters/shared/server-adapter.js +386 -0
  65. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  66. package/src/adapters/shared/server-route-handler.js +111 -0
  67. package/src/adapters/shared/server-static-builder.d.ts +70 -0
  68. package/src/adapters/shared/server-static-builder.js +99 -0
  69. package/src/build/build-adapter.d.ts +186 -0
  70. package/src/build/build-adapter.js +168 -0
  71. package/src/build/build-manifest.d.ts +27 -0
  72. package/src/build/build-manifest.js +30 -0
  73. package/src/build/build-types.d.ts +57 -0
  74. package/src/build/build-types.js +0 -0
  75. package/src/build/dev-build-coordinator.d.ts +74 -0
  76. package/src/build/dev-build-coordinator.js +161 -0
  77. package/src/build/esbuild-build-adapter.d.ts +72 -0
  78. package/src/build/esbuild-build-adapter.js +422 -0
  79. package/src/build/runtime-build-executor.d.ts +13 -0
  80. package/src/build/runtime-build-executor.js +20 -0
  81. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  82. package/src/build/runtime-specifier-alias-plugin.js +31 -0
  83. package/src/config/config-builder.d.ts +238 -0
  84. package/src/config/config-builder.js +565 -0
  85. package/src/constants.d.ts +45 -0
  86. package/src/constants.js +25 -0
  87. package/src/create-app.d.ts +17 -0
  88. package/src/create-app.js +66 -0
  89. package/src/dev/sc-server.d.ts +30 -0
  90. package/src/dev/sc-server.js +111 -0
  91. package/src/eco/component-render-context.d.ts +105 -0
  92. package/src/eco/component-render-context.js +87 -0
  93. package/src/eco/eco.d.ts +9 -0
  94. package/src/eco/eco.js +114 -0
  95. package/src/eco/eco.types.d.ts +178 -0
  96. package/src/eco/eco.types.js +0 -0
  97. package/src/eco/eco.utils.d.ts +40 -0
  98. package/src/eco/eco.utils.js +40 -0
  99. package/src/eco/global-injector-map.d.ts +16 -0
  100. package/src/eco/global-injector-map.js +80 -0
  101. package/src/eco/lazy-injector-map.d.ts +8 -0
  102. package/src/eco/lazy-injector-map.js +70 -0
  103. package/src/eco/module-dependencies.d.ts +18 -0
  104. package/src/eco/module-dependencies.js +49 -0
  105. package/src/errors/http-error.d.ts +31 -0
  106. package/src/errors/http-error.js +50 -0
  107. package/src/errors/index.d.ts +2 -0
  108. package/src/errors/index.js +4 -0
  109. package/src/errors/locals-access-error.d.ts +4 -0
  110. package/src/errors/locals-access-error.js +9 -0
  111. package/src/global/app-logger.d.ts +2 -0
  112. package/src/global/app-logger.js +6 -0
  113. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  114. package/src/hmr/client/hmr-runtime.js +109 -0
  115. package/src/hmr/hmr-strategy.d.ts +159 -0
  116. package/src/hmr/hmr-strategy.js +29 -0
  117. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  118. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  119. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  120. package/src/hmr/hmr.test.e2e.js +43 -0
  121. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  122. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  123. package/src/hmr/strategies/js-hmr-strategy.d.ts +139 -0
  124. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  125. package/src/index.browser.d.ts +3 -0
  126. package/src/index.browser.js +4 -0
  127. package/src/index.d.ts +5 -0
  128. package/src/index.js +10 -0
  129. package/src/integrations/ghtml/ghtml-renderer.d.ts +15 -0
  130. package/src/integrations/ghtml/ghtml-renderer.js +62 -0
  131. package/src/integrations/ghtml/ghtml.plugin.d.ts +20 -0
  132. package/src/integrations/ghtml/ghtml.plugin.js +21 -0
  133. package/src/internal-types.d.ts +221 -0
  134. package/src/internal-types.js +0 -0
  135. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  136. package/src/plugins/alias-resolver-plugin.js +53 -0
  137. package/src/plugins/eco-component-meta-plugin.d.ts +97 -0
  138. package/src/plugins/eco-component-meta-plugin.js +157 -0
  139. package/src/plugins/integration-plugin.d.ts +136 -0
  140. package/src/plugins/integration-plugin.js +133 -0
  141. package/src/plugins/processor.d.ts +95 -0
  142. package/src/plugins/processor.js +136 -0
  143. package/src/plugins/runtime-capability.d.ts +9 -0
  144. package/src/plugins/runtime-capability.js +0 -0
  145. package/src/public-types.d.ts +1149 -0
  146. package/src/public-types.js +0 -0
  147. package/src/route-renderer/component-graph/component-graph-executor.d.ts +32 -0
  148. package/src/route-renderer/component-graph/component-graph-executor.js +31 -0
  149. package/src/route-renderer/component-graph/component-graph.d.ts +42 -0
  150. package/src/route-renderer/component-graph/component-graph.js +72 -0
  151. package/src/route-renderer/component-graph/component-marker.d.ts +52 -0
  152. package/src/route-renderer/component-graph/component-marker.js +46 -0
  153. package/src/route-renderer/component-graph/component-reference.d.ts +10 -0
  154. package/src/route-renderer/component-graph/component-reference.js +19 -0
  155. package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +77 -0
  156. package/src/route-renderer/component-graph/marker-graph-resolver.js +95 -0
  157. package/src/route-renderer/orchestration/integration-renderer.d.ts +372 -0
  158. package/src/route-renderer/orchestration/integration-renderer.js +589 -0
  159. package/src/route-renderer/orchestration/render-execution.service.d.ts +103 -0
  160. package/src/route-renderer/orchestration/render-execution.service.js +121 -0
  161. package/src/route-renderer/orchestration/render-preparation.service.d.ts +121 -0
  162. package/src/route-renderer/orchestration/render-preparation.service.js +332 -0
  163. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  164. package/src/route-renderer/page-loading/dependency-resolver.js +442 -0
  165. package/src/route-renderer/page-loading/page-module-loader.d.ts +87 -0
  166. package/src/route-renderer/page-loading/page-module-loader.js +124 -0
  167. package/src/route-renderer/route-renderer.d.ts +61 -0
  168. package/src/route-renderer/route-renderer.js +87 -0
  169. package/src/router/client/link-intent.js +34 -0
  170. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  171. package/src/router/client/link-intent.test.browser.js +43 -0
  172. package/src/router/client/navigation-coordinator.d.ts +149 -0
  173. package/src/router/client/navigation-coordinator.js +215 -0
  174. package/src/router/server/fs-router-scanner.d.ts +41 -0
  175. package/src/router/server/fs-router-scanner.js +156 -0
  176. package/src/router/server/fs-router.d.ts +26 -0
  177. package/src/router/server/fs-router.js +100 -0
  178. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +120 -0
  179. package/src/services/assets/asset-processing-service/asset-processing.service.js +331 -0
  180. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  181. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  182. package/src/services/assets/asset-processing-service/assets.types.d.ts +89 -0
  183. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  184. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  185. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +48 -0
  186. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  187. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  188. package/src/services/assets/asset-processing-service/index.d.ts +5 -0
  189. package/src/services/assets/asset-processing-service/index.js +5 -0
  190. package/src/services/assets/asset-processing-service/processor.interface.d.ts +22 -0
  191. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  192. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  193. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  194. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  195. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +64 -0
  196. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +17 -0
  197. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +72 -0
  198. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  199. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  200. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +5 -0
  201. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +57 -0
  202. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +8 -0
  203. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +76 -0
  204. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  205. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +75 -0
  206. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -0
  207. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +25 -0
  208. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  209. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +66 -0
  210. package/src/services/assets/browser-bundle.service.d.ts +32 -0
  211. package/src/services/assets/browser-bundle.service.js +33 -0
  212. package/src/services/cache/cache.types.d.ts +107 -0
  213. package/src/services/cache/cache.types.js +0 -0
  214. package/src/services/cache/index.d.ts +7 -0
  215. package/src/services/cache/index.js +7 -0
  216. package/src/services/cache/memory-cache-store.d.ts +42 -0
  217. package/src/services/cache/memory-cache-store.js +98 -0
  218. package/src/services/cache/page-cache-service.d.ts +70 -0
  219. package/src/services/cache/page-cache-service.js +152 -0
  220. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  221. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  222. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  223. package/src/services/html/html-rewriter-provider.service.js +65 -0
  224. package/src/services/html/html-transformer.service.d.ts +77 -0
  225. package/src/services/html/html-transformer.service.js +221 -0
  226. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  227. package/src/services/invalidation/development-invalidation.service.js +189 -0
  228. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +16 -0
  229. package/src/services/module-loading/app-server-module-transpiler.service.js +34 -0
  230. package/src/services/module-loading/page-module-import.service.d.ts +71 -0
  231. package/src/services/module-loading/page-module-import.service.js +132 -0
  232. package/src/services/module-loading/server-loader.service.d.ts +96 -0
  233. package/src/services/module-loading/server-loader.service.js +32 -0
  234. package/src/services/module-loading/server-module-transpiler.service.d.ts +69 -0
  235. package/src/services/module-loading/server-module-transpiler.service.js +61 -0
  236. package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +35 -0
  237. package/src/services/runtime-manifest/node-runtime-manifest.service.js +60 -0
  238. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  239. package/src/services/runtime-state/dev-graph.service.js +162 -0
  240. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  241. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  242. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  243. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  244. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  245. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  246. package/src/services/validation/schema-validation-service.d.ts +122 -0
  247. package/src/services/validation/schema-validation-service.js +101 -0
  248. package/src/services/validation/standard-schema.types.d.ts +65 -0
  249. package/src/services/validation/standard-schema.types.js +0 -0
  250. package/src/static-site-generator/static-site-generator.d.ts +109 -0
  251. package/src/static-site-generator/static-site-generator.js +353 -0
  252. package/src/utils/css.d.ts +1 -0
  253. package/src/utils/css.js +7 -0
  254. package/src/utils/deep-merge.d.ts +14 -0
  255. package/src/utils/deep-merge.js +32 -0
  256. package/src/utils/hash.d.ts +1 -0
  257. package/src/utils/hash.js +7 -0
  258. package/src/utils/html.d.ts +1 -0
  259. package/src/utils/html.js +4 -0
  260. package/src/utils/invariant.d.ts +5 -0
  261. package/src/utils/invariant.js +11 -0
  262. package/src/utils/locals-utils.d.ts +15 -0
  263. package/src/utils/locals-utils.js +24 -0
  264. package/src/utils/parse-cli-args.d.ts +24 -0
  265. package/src/utils/parse-cli-args.js +47 -0
  266. package/src/utils/path-utils.module.d.ts +5 -0
  267. package/src/utils/path-utils.module.js +14 -0
  268. package/src/utils/resolve-work-dir.d.ts +11 -0
  269. package/src/utils/resolve-work-dir.js +31 -0
  270. package/src/utils/runtime.d.ts +11 -0
  271. package/src/utils/runtime.js +40 -0
  272. package/src/utils/server-utils.module.d.ts +19 -0
  273. package/src/utils/server-utils.module.js +56 -0
  274. package/src/watchers/project-watcher.d.ts +136 -0
  275. package/src/watchers/project-watcher.js +281 -0
  276. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  277. package/src/watchers/project-watcher.test-helpers.js +52 -0
  278. package/src/adapters/bun/hmr-manager.test.ts +0 -267
  279. package/src/adapters/node/bootstrap-dependency-resolver.test.ts +0 -282
  280. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  281. package/src/adapters/node/node-hmr-manager.test.ts +0 -322
  282. package/src/adapters/node/runtime-adapter.test.ts +0 -868
  283. package/src/adapters/node/static-content-server.test.ts +0 -60
  284. package/src/adapters/shared/api-response.test.ts +0 -97
  285. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  286. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -90
  287. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -187
  288. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -286
  289. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -196
  290. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  291. package/src/adapters/shared/render-context.test.ts +0 -146
  292. package/src/adapters/shared/server-adapter.test.ts +0 -77
  293. package/src/adapters/shared/server-route-handler.test.ts +0 -110
  294. package/src/adapters/shared/server-static-builder.test.ts +0 -316
  295. package/src/build/build-adapter-serialization.test.ts +0 -268
  296. package/src/build/build-adapter.test.ts +0 -815
  297. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -43
  298. package/src/config/config-builder.test.ts +0 -410
  299. package/src/eco/eco.test.ts +0 -678
  300. package/src/eco/eco.utils.test.ts +0 -124
  301. package/src/eco/global-injector-map.test.ts +0 -42
  302. package/src/eco/lazy-injector-map.test.ts +0 -66
  303. package/src/eco/module-dependencies.test.ts +0 -30
  304. package/src/errors/http-error.test.ts +0 -134
  305. package/src/global/utils.test.ts +0 -12
  306. 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
  307. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  308. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  309. package/src/hmr/hmr-strategy.test.ts +0 -124
  310. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -335
  311. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -63
  312. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  313. package/src/plugins/eco-component-meta-plugin.test.ts +0 -380
  314. package/src/plugins/integration-plugin.test.ts +0 -111
  315. package/src/plugins/processor.test.ts +0 -148
  316. package/src/route-renderer/component-graph/component-graph-executor.test.ts +0 -41
  317. package/src/route-renderer/component-graph/component-graph.test.ts +0 -63
  318. package/src/route-renderer/component-graph/component-marker.test.ts +0 -73
  319. package/src/route-renderer/component-graph/marker-graph-resolver.test.ts +0 -135
  320. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -936
  321. package/src/route-renderer/orchestration/render-execution.service.test.ts +0 -97
  322. package/src/route-renderer/orchestration/render-preparation.service.test.ts +0 -235
  323. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -345
  324. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -96
  325. package/src/router/client/navigation-coordinator.test.ts +0 -237
  326. package/src/router/server/fs-router-scanner.test.ts +0 -83
  327. package/src/router/server/fs-router.test.ts +0 -214
  328. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -385
  329. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  330. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -72
  331. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  332. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  333. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -286
  334. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  335. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -199
  336. package/src/services/assets/browser-bundle.service.test.ts +0 -36
  337. package/src/services/cache/memory-cache-store.test.ts +0 -225
  338. package/src/services/cache/page-cache-service.test.ts +0 -175
  339. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  340. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  341. package/src/services/html/html-transformer.service.test.ts +0 -378
  342. package/src/services/invalidation/development-invalidation.service.test.ts +0 -77
  343. package/src/services/module-loading/page-module-import.service.test.ts +0 -253
  344. package/src/services/module-loading/server-loader.service.test.ts +0 -161
  345. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -115
  346. package/src/services/runtime-manifest/node-runtime-manifest.service.test.ts +0 -95
  347. package/src/services/validation/schema-validation-service.test.ts +0 -223
  348. package/src/static-site-generator/static-site-generator.test.ts +0 -307
  349. package/src/utils/deep-merge.test.ts +0 -114
  350. package/src/utils/invariant.test.ts +0 -22
  351. package/src/utils/path-utils.test.ts +0 -15
  352. package/src/utils/server-utils.test.ts +0 -38
  353. package/src/watchers/project-watcher.integration.test.ts +0 -337
  354. package/src/watchers/project-watcher.test.ts +0 -678
@@ -0,0 +1,442 @@
1
+ import path from "node:path";
2
+ import { readFileSync } from "node:fs";
3
+ import { rapidhash } from "../../utils/hash.js";
4
+ import { AssetFactory } from "../../services/assets/asset-processing-service/index.js";
5
+ import { normalizeModuleDeclarations } from "../../eco/module-dependencies.js";
6
+ import { parseSync } from "oxc-parser";
7
+ const DEPENDENCY_ERRORS = {
8
+ INVALID_STYLESHEET_ENTRY: "Invalid stylesheet dependency entry: expected src or content",
9
+ INVALID_SCRIPT_ENTRY: "Invalid script dependency entry: expected src or content",
10
+ LAZY_SCRIPT_MISSING_SRC: "Lazy script dependency entry in dependencies.scripts requires a src value"
11
+ };
12
+ function extractEcopagesVirtualImports(file) {
13
+ let source;
14
+ try {
15
+ source = readFileSync(file, "utf-8");
16
+ } catch {
17
+ return [];
18
+ }
19
+ let result;
20
+ try {
21
+ result = parseSync(file, source, { sourceType: "module" });
22
+ } catch {
23
+ return [];
24
+ }
25
+ const found = /* @__PURE__ */ new Map();
26
+ for (const node of result.program.body ?? []) {
27
+ if (node.type !== "ImportDeclaration") continue;
28
+ if (node.importKind === "type") continue;
29
+ const specifier = node.source?.value ?? "";
30
+ if (!specifier.startsWith("ecopages:")) continue;
31
+ if (found.get(specifier) === null) {
32
+ continue;
33
+ }
34
+ const namedImports = [];
35
+ for (const spec of node.specifiers ?? []) {
36
+ if (spec.type === "ImportSpecifier") {
37
+ const importedName = spec.imported?.type === "Identifier" ? spec.imported.name : spec.imported?.type === "Literal" ? spec.imported.value : spec.local?.name;
38
+ namedImports.push(importedName);
39
+ }
40
+ }
41
+ if (namedImports.length === 0) {
42
+ found.set(specifier, null);
43
+ continue;
44
+ }
45
+ const existing = found.get(specifier);
46
+ if (!existing) {
47
+ found.set(specifier, new Set(namedImports));
48
+ continue;
49
+ }
50
+ for (const imported of namedImports) {
51
+ existing.add(imported);
52
+ }
53
+ }
54
+ return Array.from(found.entries()).map(([from, importsSet]) => ({
55
+ from,
56
+ imports: importsSet ? Array.from(importsSet) : void 0
57
+ }));
58
+ }
59
+ function createModuleScriptName(from, imports) {
60
+ const normalizedImports = imports ? [...imports].sort().join(",") : "*";
61
+ const hash = rapidhash(`${from}|${normalizedImports}`).toString(16);
62
+ return `module-${hash}`;
63
+ }
64
+ function createNamedImportModuleSource(from, imports) {
65
+ const namedImports = imports.join(", ");
66
+ return `export { ${namedImports} } from '${from}';`;
67
+ }
68
+ function createNamespaceImportModuleSource(from) {
69
+ return `export * from '${from}';`;
70
+ }
71
+ function resolveDependencyPath(componentDir, pathUrl) {
72
+ return path.join(componentDir, pathUrl);
73
+ }
74
+ function isDependencyEntryObject(entry) {
75
+ return typeof entry === "object" && entry !== null;
76
+ }
77
+ function getDependencyEntrySrc(entry) {
78
+ return isDependencyEntryObject(entry) ? entry.src : entry;
79
+ }
80
+ function getDependencyEntryContent(entry) {
81
+ return isDependencyEntryObject(entry) ? entry.content : void 0;
82
+ }
83
+ function getDependencyEntryAttributes(entry) {
84
+ return isDependencyEntryObject(entry) ? entry.attributes : void 0;
85
+ }
86
+ function getDependencyEntrySrcOrThrow(entry, errorMessage) {
87
+ const src = getDependencyEntrySrc(entry);
88
+ if (!src) {
89
+ throw new Error(errorMessage);
90
+ }
91
+ return src;
92
+ }
93
+ function getLazyTriggerKey(lazy) {
94
+ if ("on:idle" in lazy) {
95
+ return "on:idle";
96
+ }
97
+ if ("on:interaction" in lazy) {
98
+ return `on:interaction:${lazy["on:interaction"]}`;
99
+ }
100
+ if ("on:visible" in lazy) {
101
+ const value = lazy["on:visible"];
102
+ return `on:visible:${value === true ? "true" : value}`;
103
+ }
104
+ return JSON.stringify(lazy);
105
+ }
106
+ function resolveLazyScripts(appConfig, componentDir, scripts) {
107
+ const getSafeFileName = (filepath) => {
108
+ const EXTENSIONS_TO_JS = ["ts", "tsx"];
109
+ const safe = filepath.replace(new RegExp(`\\.(${EXTENSIONS_TO_JS.join("|")})$`), ".js");
110
+ return safe.startsWith("./") ? safe.slice(2) : safe;
111
+ };
112
+ const baseDir = componentDir.split(appConfig.srcDir)[1] ?? "";
113
+ const resolvedPaths = scripts.map((script) => {
114
+ const relativePath = [AssetFactory.RESOLVED_ASSETS_DIR, baseDir, getSafeFileName(script)].filter(Boolean).join("/").replace(/\/+/g, "/");
115
+ return `/${relativePath.replace(/^\/+/, "")}`;
116
+ });
117
+ return resolvedPaths.join(",");
118
+ }
119
+ function buildResolvedLazyTriggers(config, groups) {
120
+ if (groups.length === 0) return [];
121
+ const componentFile = config.__eco?.file ?? "";
122
+ const sortedUrls = groups.flatMap((group) => group.scripts).sort().join(",");
123
+ const triggerId = `eco-trigger-${rapidhash(`${componentFile}:${sortedUrls}`).toString(16)}`;
124
+ const rules = groups.map((group) => {
125
+ const { scripts, lazy } = group;
126
+ if ("on:idle" in lazy) {
127
+ return { "on:idle": { scripts } };
128
+ }
129
+ if ("on:interaction" in lazy) {
130
+ return { "on:interaction": { value: lazy["on:interaction"], scripts } };
131
+ }
132
+ if ("on:visible" in lazy) {
133
+ const visibleSelector = lazy["on:visible"];
134
+ if (visibleSelector === true) return { "on:visible": { scripts } };
135
+ return { "on:visible": { value: String(visibleSelector), scripts } };
136
+ }
137
+ throw new Error(`Unknown lazy trigger kind: ${JSON.stringify(lazy)}`);
138
+ });
139
+ return [{ triggerId, rules }];
140
+ }
141
+ class DependencyResolverService {
142
+ appConfig;
143
+ assetProcessingService;
144
+ /**
145
+ * Creates the dependency resolver used by route and component rendering.
146
+ *
147
+ * @remarks
148
+ * The resolver stays intentionally separate from HTML rendering so component
149
+ * dependency collection, lazy trigger grouping, and processed-asset generation
150
+ * can evolve without changing renderer implementations.
151
+ */
152
+ constructor(appConfig, assetProcessingService) {
153
+ this.appConfig = appConfig;
154
+ this.assetProcessingService = assetProcessingService;
155
+ }
156
+ /**
157
+ * Resolves one dependency path relative to the component that declared it.
158
+ */
159
+ resolveDependencyPath(componentDir, pathUrl) {
160
+ return resolveDependencyPath(componentDir, pathUrl);
161
+ }
162
+ /**
163
+ * Maps lazy script source entries to deterministic fallback public URLs
164
+ * used when bundling output URLs are unavailable.
165
+ */
166
+ resolveLazyScripts(componentDir, scripts) {
167
+ return resolveLazyScripts(this.appConfig, componentDir, scripts);
168
+ }
169
+ /**
170
+ * Collects and processes component dependencies (styles, scripts, modules, lazy scripts).
171
+ * Lazy dependencies are always resolved into global-injector trigger maps.
172
+ */
173
+ async processComponentDependencies(components, integrationName) {
174
+ if (!this.assetProcessingService?.processDependencies) return [];
175
+ const dependencies = [];
176
+ const lazyScriptsByConfig = /* @__PURE__ */ new Map();
177
+ const lazyDependencyKeys = /* @__PURE__ */ new Set();
178
+ for (const component of components) {
179
+ if (!component) continue;
180
+ const componentFile = component.config?.__eco?.file;
181
+ if (!componentFile) continue;
182
+ const stylesheetDependencyKeys = /* @__PURE__ */ new Set();
183
+ const scriptDependencyKeys = /* @__PURE__ */ new Set();
184
+ const modulesMap = /* @__PURE__ */ new Map();
185
+ const collect = (config) => {
186
+ if (!config) return;
187
+ const file = config.__eco?.file;
188
+ if (!file) return;
189
+ const dir = path.dirname(file);
190
+ const dependenciesConfig = config.dependencies;
191
+ const registerLazyScript = ({
192
+ lazy,
193
+ lazyKey,
194
+ fallbackUrl
195
+ }) => {
196
+ let grouped = lazyScriptsByConfig.get(config);
197
+ if (!grouped) {
198
+ grouped = /* @__PURE__ */ new Map();
199
+ lazyScriptsByConfig.set(config, grouped);
200
+ }
201
+ const triggerKey = getLazyTriggerKey(lazy);
202
+ const existing = grouped.get(triggerKey) ?? { lazy, scripts: [] };
203
+ existing.scripts.push({ lazyKey, fallbackUrl });
204
+ grouped.set(triggerKey, existing);
205
+ };
206
+ if (dependenciesConfig?.stylesheets) {
207
+ for (const style of dependenciesConfig.stylesheets) {
208
+ const content = getDependencyEntryContent(style);
209
+ const src = getDependencyEntrySrc(style);
210
+ const attributes = getDependencyEntryAttributes(style);
211
+ if (content) {
212
+ const depKey2 = `style:content:${content}:${JSON.stringify(attributes ?? {})}`;
213
+ if (stylesheetDependencyKeys.has(depKey2)) {
214
+ continue;
215
+ }
216
+ stylesheetDependencyKeys.add(depKey2);
217
+ dependencies.push(
218
+ AssetFactory.createContentStylesheet({
219
+ content,
220
+ position: "head",
221
+ attributes
222
+ })
223
+ );
224
+ continue;
225
+ }
226
+ if (!src) {
227
+ throw new Error(DEPENDENCY_ERRORS.INVALID_STYLESHEET_ENTRY);
228
+ }
229
+ const resolvedPath = resolveDependencyPath(dir, src);
230
+ const depKey = `style:file:${resolvedPath}:${JSON.stringify(attributes ?? {})}`;
231
+ if (stylesheetDependencyKeys.has(depKey)) {
232
+ continue;
233
+ }
234
+ stylesheetDependencyKeys.add(depKey);
235
+ dependencies.push(
236
+ AssetFactory.createFileStylesheet({
237
+ filepath: resolvedPath,
238
+ position: "head",
239
+ attributes: {
240
+ rel: "stylesheet",
241
+ ...attributes
242
+ }
243
+ })
244
+ );
245
+ }
246
+ }
247
+ if (dependenciesConfig?.scripts) {
248
+ for (const script of dependenciesConfig.scripts) {
249
+ if (isDependencyEntryObject(script) && script.lazy) {
250
+ continue;
251
+ }
252
+ const content = getDependencyEntryContent(script);
253
+ const src = getDependencyEntrySrc(script);
254
+ const attributes = getDependencyEntryAttributes(script);
255
+ if (content) {
256
+ const depKey2 = `script:content:${content}:${JSON.stringify(attributes ?? {})}`;
257
+ if (scriptDependencyKeys.has(depKey2)) {
258
+ continue;
259
+ }
260
+ scriptDependencyKeys.add(depKey2);
261
+ dependencies.push(
262
+ AssetFactory.createContentScript({
263
+ position: "head",
264
+ content,
265
+ attributes: {
266
+ type: "module",
267
+ defer: "",
268
+ ...attributes
269
+ }
270
+ })
271
+ );
272
+ continue;
273
+ }
274
+ if (!src) {
275
+ throw new Error(DEPENDENCY_ERRORS.INVALID_SCRIPT_ENTRY);
276
+ }
277
+ const resolvedPath = resolveDependencyPath(dir, src);
278
+ const depKey = `script:file:${resolvedPath}:${JSON.stringify(attributes ?? {})}`;
279
+ if (scriptDependencyKeys.has(depKey)) {
280
+ continue;
281
+ }
282
+ scriptDependencyKeys.add(depKey);
283
+ dependencies.push(
284
+ AssetFactory.createFileScript({
285
+ filepath: resolvedPath,
286
+ position: "head",
287
+ attributes: {
288
+ type: "module",
289
+ defer: "",
290
+ ...attributes
291
+ }
292
+ })
293
+ );
294
+ }
295
+ }
296
+ const normalizedModules = normalizeModuleDeclarations(dependenciesConfig?.modules);
297
+ for (const declaration of normalizedModules) {
298
+ const existing = modulesMap.get(declaration.from);
299
+ if (!declaration.imports || declaration.imports.length === 0) {
300
+ modulesMap.set(declaration.from, null);
301
+ continue;
302
+ }
303
+ if (existing === null) {
304
+ continue;
305
+ }
306
+ const merged = existing ?? /* @__PURE__ */ new Set();
307
+ for (const imported of declaration.imports) {
308
+ merged.add(imported);
309
+ }
310
+ modulesMap.set(declaration.from, merged);
311
+ }
312
+ for (const [index, scriptEntry] of (dependenciesConfig?.scripts ?? []).entries()) {
313
+ if (!isDependencyEntryObject(scriptEntry) || !scriptEntry.lazy) {
314
+ continue;
315
+ }
316
+ const lazy = scriptEntry.lazy;
317
+ const content = scriptEntry.content;
318
+ const src = scriptEntry.src;
319
+ const attributes = scriptEntry.attributes;
320
+ if (content) {
321
+ const lazyKey2 = `lazy:${rapidhash(`${file}:entry:${index}:${content}`).toString(16)}`;
322
+ const depKey2 = `lazy:entry:content:${getLazyTriggerKey(lazy)}:${content}:${JSON.stringify(attributes ?? {})}`;
323
+ if (!lazyDependencyKeys.has(depKey2)) {
324
+ lazyDependencyKeys.add(depKey2);
325
+ dependencies.push(
326
+ AssetFactory.createContentScript({
327
+ position: "head",
328
+ content,
329
+ excludeFromHtml: true,
330
+ attributes: {
331
+ type: "module",
332
+ defer: "",
333
+ "data-eco-lazy-key": lazyKey2,
334
+ ...attributes
335
+ }
336
+ })
337
+ );
338
+ }
339
+ registerLazyScript({
340
+ lazy,
341
+ lazyKey: lazyKey2
342
+ });
343
+ continue;
344
+ }
345
+ const script = src ?? getDependencyEntrySrcOrThrow(scriptEntry, DEPENDENCY_ERRORS.LAZY_SCRIPT_MISSING_SRC);
346
+ const resolvedPath = this.resolveDependencyPath(dir, script);
347
+ const fallbackUrl = this.resolveLazyScripts(dir, [script]).split(",")[0] ?? "";
348
+ const lazyKey = `lazy:${rapidhash(`${resolvedPath}:${getLazyTriggerKey(lazy)}`).toString(16)}`;
349
+ const depKey = `lazy:entry:file:${getLazyTriggerKey(lazy)}:${resolvedPath}:${JSON.stringify(attributes ?? {})}`;
350
+ if (!lazyDependencyKeys.has(depKey)) {
351
+ lazyDependencyKeys.add(depKey);
352
+ dependencies.push(
353
+ AssetFactory.createFileScript({
354
+ filepath: resolvedPath,
355
+ position: "head",
356
+ excludeFromHtml: true,
357
+ attributes: {
358
+ type: "module",
359
+ defer: "",
360
+ "data-eco-lazy-key": lazyKey,
361
+ ...attributes
362
+ }
363
+ })
364
+ );
365
+ }
366
+ registerLazyScript({
367
+ lazy,
368
+ lazyKey,
369
+ fallbackUrl
370
+ });
371
+ }
372
+ if (dependenciesConfig?.components) {
373
+ for (const nestedComponent of dependenciesConfig.components) {
374
+ if (nestedComponent?.config) {
375
+ collect(nestedComponent.config);
376
+ }
377
+ }
378
+ }
379
+ const autoVirtualImports = extractEcopagesVirtualImports(file);
380
+ for (const { from, imports } of autoVirtualImports) {
381
+ const existing = modulesMap.get(from);
382
+ if (!imports || imports.length === 0) {
383
+ if (existing !== null) modulesMap.set(from, null);
384
+ continue;
385
+ }
386
+ if (existing === null) continue;
387
+ const merged = existing ?? /* @__PURE__ */ new Set();
388
+ for (const imported of imports) merged.add(imported);
389
+ modulesMap.set(from, merged);
390
+ }
391
+ };
392
+ collect(component.config);
393
+ dependencies.push(
394
+ ...Array.from(modulesMap.entries()).map(([from, importsSet]) => {
395
+ const imports = importsSet ? Array.from(importsSet) : void 0;
396
+ return AssetFactory.createContentScript({
397
+ position: "head",
398
+ name: createModuleScriptName(from, imports),
399
+ content: imports && imports.length > 0 ? createNamedImportModuleSource(from, imports) : createNamespaceImportModuleSource(from),
400
+ attributes: {
401
+ type: "module",
402
+ defer: ""
403
+ }
404
+ });
405
+ })
406
+ );
407
+ }
408
+ const hasLazyDependencies = dependencies.some((dep) => dep.kind === "script" && dep.excludeFromHtml === true);
409
+ const processedDependencies = await this.assetProcessingService.processDependencies(
410
+ dependencies,
411
+ integrationName
412
+ );
413
+ const lazyKeyToOutputUrl = /* @__PURE__ */ new Map();
414
+ for (const dependency of processedDependencies) {
415
+ if (dependency.kind === "script" && dependency.srcUrl) {
416
+ const lazyKey = dependency.attributes?.["data-eco-lazy-key"];
417
+ if (lazyKey) {
418
+ lazyKeyToOutputUrl.set(lazyKey, dependency.srcUrl);
419
+ }
420
+ }
421
+ }
422
+ for (const [config, lazyGroupsMap] of lazyScriptsByConfig.entries()) {
423
+ const rawGroups = [];
424
+ for (const group of lazyGroupsMap.values()) {
425
+ const resolvedUrls = group.scripts.map(({ lazyKey, fallbackUrl }) => lazyKeyToOutputUrl.get(lazyKey) ?? fallbackUrl).filter((url) => Boolean(url && url.length > 0));
426
+ if (resolvedUrls.length === 0) {
427
+ continue;
428
+ }
429
+ rawGroups.push({ lazy: group.lazy, scripts: Array.from(new Set(resolvedUrls)) });
430
+ }
431
+ if (hasLazyDependencies) {
432
+ config._resolvedLazyTriggers = buildResolvedLazyTriggers(config, rawGroups);
433
+ config._resolvedLazyScripts = void 0;
434
+ }
435
+ }
436
+ return processedDependencies;
437
+ }
438
+ }
439
+ export {
440
+ DEPENDENCY_ERRORS,
441
+ DependencyResolverService
442
+ };
@@ -0,0 +1,87 @@
1
+ import type { EcoPageFile, GetMetadata, GetMetadataContext, GetStaticProps, PageMetadataProps, RouteRendererOptions, EcoPageComponent } from '../../public-types.js';
2
+ import type { EcoPagesAppConfig } from '../../internal-types.js';
3
+ /**
4
+ * Loads route page modules and normalizes their data hooks for rendering.
5
+ *
6
+ * @remarks
7
+ * This service keeps the render pipeline from depending directly on raw module
8
+ * imports. It owns the shared server-module transpiler setup, the precedence
9
+ * rules between component statics and module exports, and the normalization of
10
+ * page props and metadata into one renderer-facing shape.
11
+ */
12
+ export declare class PageModuleLoaderService {
13
+ private serverModuleTranspiler;
14
+ private appConfig;
15
+ private runtimeOrigin;
16
+ /**
17
+ * Creates the page-module loader for one app/runtime instance.
18
+ *
19
+ * @param appConfig Finalized app config that owns build and invalidation state.
20
+ * @param runtimeOrigin Runtime origin exposed to page data hooks.
21
+ */
22
+ constructor(appConfig: EcoPagesAppConfig, runtimeOrigin: string);
23
+ /**
24
+ * Imports one page module through the shared server-side module loading path.
25
+ *
26
+ * @remarks
27
+ * The underlying transpiler keeps Bun and Node aligned on one framework-owned
28
+ * loading contract even though the runtime-specific execution transport differs.
29
+ */
30
+ importPageFile(file: string): Promise<EcoPageFile>;
31
+ /**
32
+ * Executes the page's static-props hook with Ecopages runtime context.
33
+ *
34
+ * @remarks
35
+ * Pages without a static-props hook still return a normalized empty props
36
+ * object so downstream render preparation does not branch on hook presence.
37
+ */
38
+ getStaticPropsForPage(options: {
39
+ getStaticProps?: GetStaticProps<Record<string, unknown>>;
40
+ params?: RouteRendererOptions['params'];
41
+ }): Promise<{
42
+ props: Record<string, unknown>;
43
+ metadata?: PageMetadataProps;
44
+ }>;
45
+ /**
46
+ * Builds the final page metadata object for one render request.
47
+ *
48
+ * @remarks
49
+ * App-level default metadata forms the baseline, then page-level metadata is
50
+ * overlaid so route-specific fields win without dropping global defaults.
51
+ */
52
+ getMetadataPropsForPage(options: {
53
+ getMetadata: GetMetadata | undefined;
54
+ context: GetMetadataContext;
55
+ }): Promise<PageMetadataProps>;
56
+ /**
57
+ * Loads a page module and normalizes integration-facing exports.
58
+ * When both component static methods and module exports exist, component statics win.
59
+ */
60
+ resolvePageModule(options: {
61
+ file: string;
62
+ importPageFileFn?: (file: string) => Promise<EcoPageFile>;
63
+ }): Promise<{
64
+ Page: EcoPageFile['default'] | EcoPageComponent<any>;
65
+ getStaticProps?: GetStaticProps<Record<string, unknown>>;
66
+ getMetadata?: GetMetadata;
67
+ integrationSpecificProps: Record<string, unknown>;
68
+ }>;
69
+ /**
70
+ * Resolves the page data needed by the render pipeline.
71
+ *
72
+ * @remarks
73
+ * Static props are resolved first because page metadata may depend on those
74
+ * props. This preserves the same ordering whether data hooks are declared as
75
+ * component statics or module exports.
76
+ */
77
+ resolvePageData(options: {
78
+ pageModule: {
79
+ getStaticProps?: GetStaticProps<Record<string, unknown>>;
80
+ getMetadata?: GetMetadata;
81
+ };
82
+ routeOptions: RouteRendererOptions;
83
+ }): Promise<{
84
+ props: Record<string, unknown>;
85
+ metadata: PageMetadataProps;
86
+ }>;
87
+ }
@@ -0,0 +1,124 @@
1
+ import { invariant } from "../../utils/invariant.js";
2
+ import { getAppServerModuleTranspiler } from "../../services/module-loading/app-server-module-transpiler.service.js";
3
+ import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
4
+ class PageModuleLoaderService {
5
+ serverModuleTranspiler;
6
+ appConfig;
7
+ runtimeOrigin;
8
+ /**
9
+ * Creates the page-module loader for one app/runtime instance.
10
+ *
11
+ * @param appConfig Finalized app config that owns build and invalidation state.
12
+ * @param runtimeOrigin Runtime origin exposed to page data hooks.
13
+ */
14
+ constructor(appConfig, runtimeOrigin) {
15
+ this.appConfig = appConfig;
16
+ this.runtimeOrigin = runtimeOrigin;
17
+ this.serverModuleTranspiler = getAppServerModuleTranspiler(appConfig);
18
+ }
19
+ /**
20
+ * Imports one page module through the shared server-side module loading path.
21
+ *
22
+ * @remarks
23
+ * The underlying transpiler keeps Bun and Node aligned on one framework-owned
24
+ * loading contract even though the runtime-specific execution transport differs.
25
+ */
26
+ async importPageFile(file) {
27
+ try {
28
+ return await this.serverModuleTranspiler.importModule({
29
+ filePath: file,
30
+ outdir: `${resolveInternalExecutionDir(this.appConfig)}/.server-modules`,
31
+ transpileErrorMessage: (details) => `Error transpiling page file: ${details}`,
32
+ noOutputMessage: (targetFilePath) => `No transpiled output generated for page: ${targetFilePath}`
33
+ });
34
+ } catch (error) {
35
+ invariant(false, `Error importing page file: ${error}`);
36
+ }
37
+ }
38
+ /**
39
+ * Executes the page's static-props hook with Ecopages runtime context.
40
+ *
41
+ * @remarks
42
+ * Pages without a static-props hook still return a normalized empty props
43
+ * object so downstream render preparation does not branch on hook presence.
44
+ */
45
+ async getStaticPropsForPage(options) {
46
+ const { getStaticProps, params } = options;
47
+ return getStaticProps ? await getStaticProps({
48
+ pathname: { params: params ?? {} },
49
+ appConfig: this.appConfig,
50
+ runtimeOrigin: this.runtimeOrigin
51
+ }).then((data) => data).catch((err) => {
52
+ throw new Error(`Error fetching static props: ${err.message}`);
53
+ }) : {
54
+ props: {},
55
+ metadata: void 0
56
+ };
57
+ }
58
+ /**
59
+ * Builds the final page metadata object for one render request.
60
+ *
61
+ * @remarks
62
+ * App-level default metadata forms the baseline, then page-level metadata is
63
+ * overlaid so route-specific fields win without dropping global defaults.
64
+ */
65
+ async getMetadataPropsForPage(options) {
66
+ const { getMetadata, context } = options;
67
+ let metadata = this.appConfig.defaultMetadata;
68
+ if (getMetadata) {
69
+ const dynamicMetadata = await getMetadata({
70
+ params: context.params,
71
+ query: context.query,
72
+ props: context.props,
73
+ appConfig: this.appConfig
74
+ });
75
+ metadata = { ...metadata, ...dynamicMetadata };
76
+ }
77
+ return metadata;
78
+ }
79
+ /**
80
+ * Loads a page module and normalizes integration-facing exports.
81
+ * When both component static methods and module exports exist, component statics win.
82
+ */
83
+ async resolvePageModule(options) {
84
+ const module = await (options.importPageFileFn ?? ((file) => this.importPageFile(file)))(options.file);
85
+ const {
86
+ default: Page,
87
+ getStaticProps: moduleGetStaticProps,
88
+ getMetadata: moduleGetMetadata,
89
+ ...integrationSpecificProps
90
+ } = module;
91
+ return {
92
+ Page,
93
+ getStaticProps: Page.staticProps ?? moduleGetStaticProps,
94
+ getMetadata: Page.metadata ?? moduleGetMetadata,
95
+ integrationSpecificProps
96
+ };
97
+ }
98
+ /**
99
+ * Resolves the page data needed by the render pipeline.
100
+ *
101
+ * @remarks
102
+ * Static props are resolved first because page metadata may depend on those
103
+ * props. This preserves the same ordering whether data hooks are declared as
104
+ * component statics or module exports.
105
+ */
106
+ async resolvePageData(options) {
107
+ const { props } = await this.getStaticPropsForPage({
108
+ getStaticProps: options.pageModule.getStaticProps,
109
+ params: options.routeOptions.params
110
+ });
111
+ const metadata = await this.getMetadataPropsForPage({
112
+ getMetadata: options.pageModule.getMetadata,
113
+ context: {
114
+ props,
115
+ params: options.routeOptions.params ?? {},
116
+ query: options.routeOptions.query ?? {}
117
+ }
118
+ });
119
+ return { props, metadata };
120
+ }
121
+ }
122
+ export {
123
+ PageModuleLoaderService
124
+ };