@ecopages/core 0.2.0-alpha.3 → 0.2.0-alpha.31

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 (436) hide show
  1. package/CHANGELOG.md +66 -66
  2. package/README.md +268 -14
  3. package/package.json +72 -108
  4. package/src/adapters/README.md +39 -0
  5. package/src/adapters/abstract/application-adapter.d.ts +28 -2
  6. package/src/adapters/abstract/application-adapter.js +14 -2
  7. package/src/adapters/abstract/router-adapter.d.ts +1 -1
  8. package/src/adapters/abstract/server-adapter.d.ts +2 -2
  9. package/src/adapters/bun/client-bridge.d.ts +1 -1
  10. package/src/adapters/bun/create-app.d.ts +5 -12
  11. package/src/adapters/bun/create-app.js +43 -7
  12. package/src/adapters/bun/hmr-manager.d.ts +72 -26
  13. package/src/adapters/bun/hmr-manager.js +153 -81
  14. package/src/adapters/bun/index.d.ts +2 -3
  15. package/src/adapters/bun/index.js +3 -3
  16. package/src/adapters/bun/server-adapter.d.ts +5 -5
  17. package/src/adapters/bun/server-adapter.js +63 -38
  18. package/src/adapters/bun/server-lifecycle.d.ts +28 -17
  19. package/src/adapters/bun/server-lifecycle.js +34 -62
  20. package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
  21. package/src/{create-app.js → adapters/create-app.js} +4 -4
  22. package/src/adapters/index.d.ts +2 -6
  23. package/src/adapters/index.js +2 -8
  24. package/src/adapters/node/create-app.d.ts +6 -9
  25. package/src/adapters/node/create-app.js +12 -6
  26. package/src/adapters/node/node-client-bridge.d.ts +1 -1
  27. package/src/adapters/node/node-hmr-manager.d.ts +79 -21
  28. package/src/adapters/node/node-hmr-manager.js +167 -114
  29. package/src/adapters/node/server-adapter.d.ts +7 -35
  30. package/src/adapters/node/server-adapter.js +55 -107
  31. package/src/adapters/node/static-content-server.d.ts +37 -1
  32. package/src/adapters/node/static-content-server.js +29 -1
  33. package/src/adapters/shared/application-adapter.d.ts +1 -1
  34. package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
  35. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  36. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  37. package/src/adapters/shared/explicit-static-route-matcher.d.ts +7 -4
  38. package/src/adapters/shared/explicit-static-route-matcher.js +14 -13
  39. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +7 -10
  40. package/src/adapters/shared/file-route-middleware-pipeline.js +3 -11
  41. package/src/adapters/shared/fs-server-response-factory.d.ts +14 -10
  42. package/src/adapters/shared/fs-server-response-factory.js +11 -27
  43. package/src/adapters/shared/fs-server-response-matcher.d.ts +20 -16
  44. package/src/adapters/shared/fs-server-response-matcher.js +76 -45
  45. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  46. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  47. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  48. package/src/adapters/shared/hmr-html-response.js +32 -0
  49. package/src/adapters/shared/render-context.d.ts +4 -3
  50. package/src/adapters/shared/render-context.js +6 -3
  51. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  52. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  53. package/src/adapters/shared/server-adapter.d.ts +33 -12
  54. package/src/adapters/shared/server-adapter.js +208 -132
  55. package/src/adapters/shared/server-route-handler.d.ts +5 -5
  56. package/src/adapters/shared/server-route-handler.js +7 -16
  57. package/src/adapters/shared/server-static-builder.d.ts +41 -8
  58. package/src/adapters/shared/server-static-builder.js +65 -11
  59. package/src/build/README.md +107 -0
  60. package/src/build/build-adapter.d.ts +168 -3
  61. package/src/build/build-adapter.js +604 -16
  62. package/src/build/build-manifest.d.ts +27 -0
  63. package/src/build/build-manifest.js +30 -0
  64. package/src/build/dev-build-coordinator.d.ts +72 -0
  65. package/src/build/dev-build-coordinator.js +154 -0
  66. package/src/build/esbuild-build-adapter.d.ts +15 -6
  67. package/src/build/esbuild-build-adapter.js +189 -74
  68. package/src/build/runtime-build-executor.d.ts +14 -0
  69. package/src/build/runtime-build-executor.js +22 -0
  70. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  71. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  72. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  73. package/src/build/runtime-specifier-aliases.js +95 -0
  74. package/src/config/README.md +36 -0
  75. package/src/config/config-builder.d.ts +54 -29
  76. package/src/config/config-builder.js +255 -49
  77. package/src/{constants.d.ts → config/constants.d.ts} +13 -0
  78. package/src/{constants.js → config/constants.js} +4 -0
  79. package/src/declarations.d.ts +19 -14
  80. package/src/dev/host-runtime.d.ts +10 -0
  81. package/src/dev/host-runtime.js +24 -0
  82. package/src/dev/sc-server.d.ts +1 -1
  83. package/src/dev/sc-server.js +1 -1
  84. package/src/eco/README.md +70 -16
  85. package/src/eco/eco.browser.d.ts +2 -0
  86. package/src/eco/eco.browser.js +83 -0
  87. package/src/eco/eco.js +32 -57
  88. package/src/eco/eco.types.d.ts +14 -6
  89. package/src/eco/eco.utils.d.ts +1 -40
  90. package/src/eco/eco.utils.js +5 -35
  91. package/src/eco/global-injector-map.d.ts +3 -3
  92. package/src/eco/global-injector-map.js +2 -2
  93. package/src/eco/lazy-injector-map.d.ts +2 -2
  94. package/src/errors/index.d.ts +1 -0
  95. package/src/errors/index.js +3 -1
  96. package/src/hmr/README.md +26 -0
  97. package/src/hmr/client/hmr-runtime.d.ts +1 -6
  98. package/src/hmr/client/hmr-runtime.js +38 -7
  99. package/src/hmr/hmr-strategy.d.ts +16 -13
  100. package/src/hmr/hmr-strategy.js +22 -7
  101. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  102. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  103. package/src/hmr/hmr.test.e2e.js +26 -33
  104. package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
  105. package/src/hmr/strategies/default-hmr-strategy.js +1 -1
  106. package/src/hmr/strategies/js-hmr-strategy.d.ts +46 -48
  107. package/src/hmr/strategies/js-hmr-strategy.js +64 -74
  108. package/src/index.browser.d.ts +2 -2
  109. package/src/index.browser.js +1 -1
  110. package/src/index.d.ts +4 -3
  111. package/src/index.js +16 -5
  112. package/src/integrations/ghtml/ghtml-renderer.d.ts +3 -2
  113. package/src/integrations/ghtml/ghtml-renderer.js +27 -30
  114. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  115. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  116. package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -6
  117. package/src/integrations/ghtml/ghtml.plugin.js +3 -4
  118. package/src/plugins/README.md +35 -0
  119. package/src/plugins/alias-resolver-plugin.js +17 -3
  120. package/src/plugins/eco-component-meta-plugin.d.ts +14 -1
  121. package/src/plugins/eco-component-meta-plugin.js +27 -22
  122. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  123. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  124. package/src/plugins/integration-plugin.d.ts +142 -29
  125. package/src/plugins/integration-plugin.js +103 -14
  126. package/src/plugins/processor.d.ts +17 -2
  127. package/src/plugins/processor.js +22 -3
  128. package/src/plugins/runtime-capability.d.ts +9 -0
  129. package/src/plugins/source-transform.d.ts +46 -0
  130. package/src/plugins/source-transform.js +71 -0
  131. package/src/route-renderer/GRAPH.md +83 -325
  132. package/src/route-renderer/README.md +73 -90
  133. package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
  134. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  135. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  136. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  137. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
  138. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
  139. package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
  140. package/src/route-renderer/orchestration/integration-renderer.js +909 -0
  141. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  142. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  143. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  144. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  145. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  146. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  147. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
  148. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
  149. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  150. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  151. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
  152. package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
  153. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  154. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  155. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  156. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  157. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  158. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  159. package/src/route-renderer/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
  160. package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
  161. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  162. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  163. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  164. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  165. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  166. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  167. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  168. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  169. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  170. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  171. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  172. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  173. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  174. package/src/route-renderer/{page-module-loader.js → page-loading/page-module-loader.js} +39 -14
  175. package/src/route-renderer/route-renderer.d.ts +57 -14
  176. package/src/route-renderer/route-renderer.js +30 -18
  177. package/src/router/README.md +94 -0
  178. package/src/router/client/link-intent.d.ts +53 -0
  179. package/src/router/client/link-intent.js +34 -0
  180. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  181. package/src/router/client/link-intent.test.browser.js +43 -0
  182. package/src/router/client/navigation-coordinator.d.ts +169 -0
  183. package/src/router/client/navigation-coordinator.js +215 -0
  184. package/src/router/server/route-registry.d.ts +78 -0
  185. package/src/router/server/route-registry.js +262 -0
  186. package/src/services/README.md +28 -0
  187. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  188. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  189. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  190. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +124 -89
  191. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +1 -1
  192. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
  193. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +16 -1
  194. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  195. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  196. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  197. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  198. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  199. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  200. package/src/services/assets/asset-processing-service/index.d.ts +6 -0
  201. package/src/services/assets/asset-processing-service/index.js +6 -0
  202. package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
  203. package/src/services/assets/asset-processing-service/page-package.js +74 -0
  204. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +2 -2
  205. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +2 -2
  206. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
  207. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +11 -5
  208. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  209. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  210. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  211. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  212. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +3 -2
  213. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
  214. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +4 -3
  215. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +28 -7
  216. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +3 -3
  217. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +12 -7
  218. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +5 -2
  219. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
  220. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
  221. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +9 -3
  222. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  223. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  224. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  225. package/src/services/assets/browser-bundle.service.js +41 -0
  226. package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
  227. package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
  228. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  229. package/src/services/html/html-rewriter-provider.service.js +68 -0
  230. package/src/services/html/html-transformer.service.d.ts +87 -0
  231. package/src/services/html/html-transformer.service.js +216 -0
  232. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  233. package/src/services/invalidation/development-invalidation.service.js +190 -0
  234. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  235. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  236. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  237. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  238. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  239. package/src/services/module-loading/module-loading-types.d.ts +2 -0
  240. package/src/services/module-loading/module-loading-types.js +0 -0
  241. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  242. package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
  243. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  244. package/src/services/module-loading/page-module-import.service.js +170 -0
  245. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  246. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  247. package/src/services/module-loading/source-module-support.d.ts +5 -0
  248. package/src/services/module-loading/source-module-support.js +8 -0
  249. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  250. package/src/services/runtime-state/dev-graph.service.js +162 -0
  251. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  252. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  253. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  254. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  255. package/src/services/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
  256. package/src/static-site-generator/README.md +26 -0
  257. package/src/static-site-generator/static-site-generator.d.ts +67 -20
  258. package/src/static-site-generator/static-site-generator.js +182 -138
  259. package/src/{internal-types.d.ts → types/internal-types.d.ts} +62 -30
  260. package/src/types/internal-types.js +0 -0
  261. package/src/{public-types.d.ts → types/public-types.d.ts} +201 -32
  262. package/src/types/public-types.js +0 -0
  263. package/src/utils/html-escaping.d.ts +7 -0
  264. package/src/utils/html-escaping.js +6 -0
  265. package/src/utils/locals-utils.d.ts +1 -1
  266. package/src/utils/parse-cli-args.d.ts +4 -1
  267. package/src/utils/parse-cli-args.js +16 -1
  268. package/src/utils/resolve-work-dir.d.ts +11 -0
  269. package/src/utils/resolve-work-dir.js +31 -0
  270. package/src/watchers/project-watcher.d.ts +40 -29
  271. package/src/watchers/project-watcher.js +126 -116
  272. package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
  273. package/src/watchers/project-watcher.test-helpers.js +6 -6
  274. package/src/adapters/abstract/application-adapter.ts +0 -337
  275. package/src/adapters/abstract/router-adapter.ts +0 -30
  276. package/src/adapters/abstract/server-adapter.ts +0 -79
  277. package/src/adapters/bun/client-bridge.ts +0 -62
  278. package/src/adapters/bun/create-app.ts +0 -189
  279. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  280. package/src/adapters/bun/define-api-handler.ts +0 -114
  281. package/src/adapters/bun/hmr-manager.ts +0 -296
  282. package/src/adapters/bun/index.ts +0 -3
  283. package/src/adapters/bun/server-adapter.ts +0 -492
  284. package/src/adapters/bun/server-lifecycle.ts +0 -154
  285. package/src/adapters/index.ts +0 -6
  286. package/src/adapters/node/create-app.ts +0 -179
  287. package/src/adapters/node/index.d.ts +0 -4
  288. package/src/adapters/node/index.js +0 -8
  289. package/src/adapters/node/index.ts +0 -9
  290. package/src/adapters/node/node-client-bridge.ts +0 -79
  291. package/src/adapters/node/node-hmr-manager.ts +0 -289
  292. package/src/adapters/node/server-adapter.ts +0 -561
  293. package/src/adapters/node/static-content-server.ts +0 -203
  294. package/src/adapters/shared/api-response.ts +0 -104
  295. package/src/adapters/shared/application-adapter.ts +0 -199
  296. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
  297. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
  298. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  299. package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
  300. package/src/adapters/shared/render-context.ts +0 -105
  301. package/src/adapters/shared/server-adapter.ts +0 -442
  302. package/src/adapters/shared/server-route-handler.ts +0 -166
  303. package/src/adapters/shared/server-static-builder.ts +0 -82
  304. package/src/build/build-adapter.ts +0 -132
  305. package/src/build/build-types.ts +0 -83
  306. package/src/build/esbuild-build-adapter.ts +0 -510
  307. package/src/config/config-builder.ts +0 -474
  308. package/src/constants.ts +0 -39
  309. package/src/create-app.ts +0 -87
  310. package/src/define-api-handler.js +0 -15
  311. package/src/define-api-handler.ts +0 -66
  312. package/src/dev/sc-server.ts +0 -143
  313. package/src/eco/component-render-context.d.ts +0 -105
  314. package/src/eco/component-render-context.js +0 -77
  315. package/src/eco/component-render-context.ts +0 -202
  316. package/src/eco/eco.ts +0 -221
  317. package/src/eco/eco.types.ts +0 -202
  318. package/src/eco/eco.utils.ts +0 -89
  319. package/src/eco/global-injector-map.ts +0 -112
  320. package/src/eco/lazy-injector-map.ts +0 -120
  321. package/src/eco/module-dependencies.ts +0 -75
  322. package/src/errors/http-error.ts +0 -72
  323. package/src/errors/index.ts +0 -2
  324. package/src/errors/locals-access-error.ts +0 -7
  325. package/src/global/app-logger.ts +0 -4
  326. 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
  327. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  328. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  329. package/src/hmr/client/hmr-runtime.ts +0 -121
  330. package/src/hmr/hmr-strategy.ts +0 -172
  331. package/src/hmr/hmr.test.e2e.ts +0 -75
  332. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  333. package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
  334. package/src/index.browser.ts +0 -3
  335. package/src/index.ts +0 -5
  336. package/src/integrations/ghtml/ghtml-renderer.ts +0 -93
  337. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  338. package/src/internal-types.ts +0 -212
  339. package/src/plugins/alias-resolver-plugin.ts +0 -45
  340. package/src/plugins/eco-component-meta-plugin.ts +0 -474
  341. package/src/plugins/integration-plugin.ts +0 -184
  342. package/src/plugins/processor.ts +0 -220
  343. package/src/public-types.ts +0 -1260
  344. package/src/route-renderer/component-graph-executor.d.ts +0 -32
  345. package/src/route-renderer/component-graph-executor.js +0 -31
  346. package/src/route-renderer/component-graph-executor.ts +0 -84
  347. package/src/route-renderer/component-graph.d.ts +0 -42
  348. package/src/route-renderer/component-graph.js +0 -72
  349. package/src/route-renderer/component-graph.ts +0 -159
  350. package/src/route-renderer/component-marker.d.ts +0 -52
  351. package/src/route-renderer/component-marker.js +0 -46
  352. package/src/route-renderer/component-marker.ts +0 -117
  353. package/src/route-renderer/dependency-resolver.js +0 -428
  354. package/src/route-renderer/dependency-resolver.ts +0 -596
  355. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  356. package/src/route-renderer/html-post-processing.service.js +0 -86
  357. package/src/route-renderer/html-post-processing.service.ts +0 -103
  358. package/src/route-renderer/integration-renderer.d.ts +0 -339
  359. package/src/route-renderer/integration-renderer.js +0 -526
  360. package/src/route-renderer/integration-renderer.ts +0 -696
  361. package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
  362. package/src/route-renderer/marker-graph-resolver.js +0 -93
  363. package/src/route-renderer/marker-graph-resolver.ts +0 -153
  364. package/src/route-renderer/page-module-loader.d.ts +0 -61
  365. package/src/route-renderer/page-module-loader.ts +0 -153
  366. package/src/route-renderer/render-execution.service.d.ts +0 -69
  367. package/src/route-renderer/render-execution.service.js +0 -91
  368. package/src/route-renderer/render-execution.service.ts +0 -158
  369. package/src/route-renderer/render-preparation.service.d.ts +0 -112
  370. package/src/route-renderer/render-preparation.service.js +0 -243
  371. package/src/route-renderer/render-preparation.service.ts +0 -358
  372. package/src/route-renderer/route-renderer.ts +0 -80
  373. package/src/router/fs-router-scanner.d.ts +0 -41
  374. package/src/router/fs-router-scanner.js +0 -155
  375. package/src/router/fs-router-scanner.ts +0 -217
  376. package/src/router/fs-router.d.ts +0 -26
  377. package/src/router/fs-router.js +0 -100
  378. package/src/router/fs-router.ts +0 -122
  379. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  380. package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
  381. package/src/services/asset-processing-service/asset.factory.ts +0 -105
  382. package/src/services/asset-processing-service/assets.types.ts +0 -112
  383. package/src/services/asset-processing-service/index.d.ts +0 -3
  384. package/src/services/asset-processing-service/index.js +0 -3
  385. package/src/services/asset-processing-service/index.ts +0 -3
  386. package/src/services/asset-processing-service/processor.interface.ts +0 -27
  387. package/src/services/asset-processing-service/processor.registry.ts +0 -18
  388. package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
  389. package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +0 -16
  390. package/src/services/asset-processing-service/processors/base/base-script-processor.js +0 -80
  391. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
  392. package/src/services/asset-processing-service/processors/index.d.ts +0 -5
  393. package/src/services/asset-processing-service/processors/index.js +0 -5
  394. package/src/services/asset-processing-service/processors/index.ts +0 -5
  395. package/src/services/asset-processing-service/processors/script/content-script.processor.js +0 -57
  396. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  397. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  398. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
  399. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
  400. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  401. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
  402. package/src/services/cache/cache.types.ts +0 -126
  403. package/src/services/cache/index.ts +0 -18
  404. package/src/services/cache/memory-cache-store.ts +0 -130
  405. package/src/services/cache/page-cache-service.ts +0 -202
  406. package/src/services/html-transformer.service.d.ts +0 -50
  407. package/src/services/html-transformer.service.js +0 -163
  408. package/src/services/html-transformer.service.ts +0 -217
  409. package/src/services/page-module-import.service.d.ts +0 -37
  410. package/src/services/page-module-import.service.js +0 -88
  411. package/src/services/page-module-import.service.ts +0 -129
  412. package/src/services/page-request-cache-coordinator.service.ts +0 -128
  413. package/src/services/schema-validation-service.ts +0 -204
  414. package/src/services/validation/standard-schema.types.ts +0 -68
  415. package/src/static-site-generator/static-site-generator.ts +0 -359
  416. package/src/utils/css.d.ts +0 -1
  417. package/src/utils/css.js +0 -7
  418. package/src/utils/css.ts +0 -5
  419. package/src/utils/deep-merge.ts +0 -47
  420. package/src/utils/hash.ts +0 -5
  421. package/src/utils/html.ts +0 -1
  422. package/src/utils/invariant.ts +0 -15
  423. package/src/utils/locals-utils.ts +0 -37
  424. package/src/utils/parse-cli-args.ts +0 -83
  425. package/src/utils/path-utils.module.ts +0 -14
  426. package/src/utils/runtime.ts +0 -44
  427. package/src/utils/server-utils.module.ts +0 -67
  428. package/src/watchers/project-watcher.test-helpers.ts +0 -41
  429. package/src/watchers/project-watcher.ts +0 -344
  430. /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
  431. /package/src/{internal-types.js → plugins/runtime-capability.js} +0 -0
  432. /package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.js +0 -0
  433. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
  434. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
  435. /package/src/{public-types.js → services/module-loading/app-module-loader.service.js} +0 -0
  436. /package/src/services/{schema-validation-service.js → validation/schema-validation-service.js} +0 -0
@@ -1,442 +0,0 @@
1
- import path from 'node:path';
2
- import { AbstractServerAdapter } from '../abstract/server-adapter.ts';
3
- import type { ServerAdapterOptions, ServerAdapterResult } from '../abstract/server-adapter.ts';
4
- import { RouteRendererFactory } from '../../route-renderer/route-renderer.ts';
5
- import { FSRouter } from '../../router/fs-router.ts';
6
- import { FSRouterScanner } from '../../router/fs-router-scanner.ts';
7
- import { MemoryCacheStore } from '../../services/cache/memory-cache-store.ts';
8
- import { PageCacheService } from '../../services/cache/page-cache-service.ts';
9
- import { SchemaValidationService } from '../../services/schema-validation-service.ts';
10
- import { StaticSiteGenerator } from '../../static-site-generator/static-site-generator.ts';
11
- import { ServerStaticBuilder } from './server-static-builder.ts';
12
- import { ExplicitStaticRouteMatcher } from './explicit-static-route-matcher.ts';
13
- import { FileSystemServerResponseFactory } from './fs-server-response-factory.ts';
14
- import { FileSystemResponseMatcher } from './fs-server-response-matcher.ts';
15
- import { ServerRouteHandler } from './server-route-handler.ts';
16
- import { createRenderContext } from './render-context.ts';
17
- import { createRequire } from '../../utils/locals-utils.ts';
18
- import { HttpError } from '../../errors/http-error.ts';
19
- import { ApiResponseBuilder } from './api-response.ts';
20
- import { appLogger } from '../../global/app-logger.ts';
21
- import type {
22
- ApiHandler,
23
- ApiHandlerContext,
24
- CacheInvalidator,
25
- ErrorHandler,
26
- RenderContext,
27
- StaticRoute,
28
- } from '../../public-types.ts';
29
-
30
- export abstract class SharedServerAdapter<
31
- TOptions extends ServerAdapterOptions,
32
- TResult extends ServerAdapterResult,
33
- > extends AbstractServerAdapter<TOptions, TResult> {
34
- protected router!: FSRouter;
35
- protected fileSystemResponseMatcher!: FileSystemResponseMatcher;
36
- protected routeRendererFactory!: RouteRendererFactory;
37
- protected routeHandler!: ServerRouteHandler;
38
- protected staticSiteGenerator!: StaticSiteGenerator;
39
- protected staticBuilder!: ServerStaticBuilder;
40
- protected readonly schemaValidator = new SchemaValidationService();
41
-
42
- /**
43
- * Scans the filesystem and dynamically constructs the universal router map.
44
- *
45
- * This process runs identically across both Bun and Node wrappers. It analyzes the configured pages
46
- * directory, building a map of all available UI routes and API endpoints.
47
- * The resulting `FSRouter` instance becomes the central nervous system for mapping WinterCG incoming
48
- * Web Requests (`Request`) to their corresponding internal execution paths.
49
- */
50
- protected async initSharedRouter(): Promise<void> {
51
- const scanner = new FSRouterScanner({
52
- dir: path.join(this.appConfig.rootDir, this.appConfig.srcDir, this.appConfig.pagesDir),
53
- appConfig: this.appConfig,
54
- origin: this.runtimeOrigin,
55
- templatesExt: this.appConfig.templatesExt,
56
- options: {
57
- buildMode: !this.options?.watch,
58
- },
59
- });
60
-
61
- this.router = new FSRouter({
62
- origin: this.runtimeOrigin,
63
- assetPrefix: path.join(this.appConfig.rootDir, this.appConfig.distDir),
64
- scanner,
65
- });
66
-
67
- await this.router.init();
68
- }
69
-
70
- /**
71
- * Sets up the unified rendering pipeline and response matching chain.
72
- *
73
- * It bridges several sub-systems together so that when an incoming request is received, the adapter knows:
74
- * 1. How to render React/Lit pages via `RouteRendererFactory`
75
- * 2. How to match logical routes to physical filesystem artifacts via `FileSystemResponseMatcher`
76
- * 3. Whether to serve the response from the embedded `PageCacheService` or generate it fresh on the fly.
77
- *
78
- * Because `HmrManager` implementations rely heavily on runtime-specific WebSocket APIs (e.g. Bun.serve Websockets vs Node WS),
79
- * we leave it untyped (`any`) here at the common denominator core.
80
- *
81
- * @param staticRoutes - A map of explicitly served static assets.
82
- * @param hmrManager - The runtime-specific Hot Module Replacement orchestrator (if watching).
83
- */
84
- protected configureSharedResponseHandlers(staticRoutes: StaticRoute[], hmrManager?: any): void {
85
- this.routeRendererFactory = new RouteRendererFactory({
86
- appConfig: this.appConfig,
87
- runtimeOrigin: this.runtimeOrigin,
88
- });
89
-
90
- const fileSystemResponseFactory = new FileSystemServerResponseFactory({
91
- appConfig: this.appConfig,
92
- routeRendererFactory: this.routeRendererFactory,
93
- options: {
94
- watchMode: !!this.options?.watch,
95
- },
96
- });
97
-
98
- const cacheConfig = this.appConfig.cache;
99
- const isCacheEnabled = cacheConfig?.enabled ?? !this.options?.watch;
100
- let cacheService: PageCacheService | null = null;
101
-
102
- if (isCacheEnabled) {
103
- const store =
104
- cacheConfig?.store === 'memory' || !cacheConfig?.store
105
- ? new MemoryCacheStore({ maxEntries: cacheConfig?.maxEntries })
106
- : cacheConfig.store;
107
- cacheService = new PageCacheService({ store, enabled: true });
108
- }
109
-
110
- this.fileSystemResponseMatcher = new FileSystemResponseMatcher({
111
- router: this.router,
112
- routeRendererFactory: this.routeRendererFactory,
113
- fileSystemResponseFactory,
114
- cacheService,
115
- defaultCacheStrategy: cacheConfig?.defaultStrategy ?? 'static',
116
- });
117
-
118
- const explicitStaticRouteMatcher =
119
- staticRoutes.length > 0
120
- ? new ExplicitStaticRouteMatcher({
121
- appConfig: this.appConfig,
122
- routeRendererFactory: this.routeRendererFactory,
123
- staticRoutes,
124
- })
125
- : undefined;
126
-
127
- this.routeHandler = new ServerRouteHandler({
128
- router: this.router,
129
- fileSystemResponseMatcher: this.fileSystemResponseMatcher,
130
- explicitStaticRouteMatcher,
131
- watch: !!this.options?.watch,
132
- hmrManager,
133
- });
134
- }
135
-
136
- protected getCacheService(): CacheInvalidator | null {
137
- return this.fileSystemResponseMatcher?.getCacheService() ?? null;
138
- }
139
-
140
- protected getRenderContext(): RenderContext {
141
- return createRenderContext({ integrations: this.appConfig.integrations });
142
- }
143
-
144
- /**
145
- * Executes an Application Programming Interface (API) handler in an environment-agnostic manner.
146
- *
147
- * API routes in Ecopages are universally written using standard WinterCG `Request` and `Response` objects.
148
- * This execution pipeline takes the raw `Request`, extracts its dynamic segments, runs our high-speed JSON schema
149
- * validator against the body/query/headers, and triggers the developer's middleware chain sequentially.
150
- *
151
- * If the execution throws an error, it is gracefully caught, logged, and mutated into a standardized Http error payload,
152
- * ensuring the consuming client receives a parsable response even upon internal catastrophic failure.
153
- *
154
- * @param request - The incoming Web standard `Request`.
155
- * @param params - The extracted dynamic URL parameters (e.g., `{ id: '123' }`).
156
- * @param routeConfig - The user-defined API handler object containing their business logic (`handler`) and `middleware`.
157
- * @param serverInstance - Untyped reference to the underlying native server instance (BunServer/NodeServer) for potential escape hatches.
158
- * @param errorHandler - Optional global error trap defined in project configuration.
159
- * @returns The resulting Web standard `Response` constructed by the user's handler.
160
- */
161
- protected async executeApiHandler(
162
- request: Request,
163
- params: Record<string, string | string[]>,
164
- routeConfig: ApiHandler,
165
- serverInstance: any,
166
- errorHandler?: ErrorHandler,
167
- ): Promise<Response> {
168
- let context: ApiHandlerContext<Request, any> | undefined;
169
-
170
- try {
171
- const middleware = routeConfig.middleware || [];
172
- const schema = routeConfig.schema;
173
- const locals: Record<string, unknown> = {};
174
-
175
- const normalizedParams = Object.fromEntries(
176
- Object.entries(params).map(([key, value]) => [key, Array.isArray(value) ? value.join('/') : value]),
177
- );
178
-
179
- context = {
180
- request,
181
- params: normalizedParams,
182
- response: new ApiResponseBuilder(),
183
- server: serverInstance,
184
- locals,
185
- require: createRequire((): Record<string, unknown> => locals),
186
- services: {
187
- cache: this.getCacheService(),
188
- },
189
- ...this.getRenderContext(),
190
- };
191
-
192
- if (schema) {
193
- const url = new URL(request.url);
194
- const queryParams = Object.fromEntries(url.searchParams);
195
- const headers = Object.fromEntries(request.headers);
196
-
197
- let body: unknown;
198
- if (schema.body) {
199
- try {
200
- const contentType = request.headers.get('Content-Type') || '';
201
- if (contentType.includes('application/json')) body = await request.clone().json();
202
- else if (contentType.includes('text/plain')) body = await request.clone().text();
203
- } catch {
204
- return context.response.status(400).json({ error: 'Invalid request body' });
205
- }
206
- }
207
-
208
- const validationResult = await this.schemaValidator.validateRequest(
209
- { body, query: queryParams, headers, params: normalizedParams },
210
- schema,
211
- );
212
-
213
- if (!validationResult.success) {
214
- return context.response.status(400).json({
215
- error: 'Validation failed',
216
- issues: validationResult.errors,
217
- });
218
- }
219
-
220
- const validated = validationResult.data!;
221
- if (validated.body !== undefined) context.body = validated.body;
222
- if (validated.query !== undefined) context.query = validated.query;
223
- if (validated.headers !== undefined) context.headers = validated.headers;
224
- if (validated.params !== undefined) context.params = validated.params as Record<string, string>;
225
- }
226
-
227
- if (middleware.length === 0) {
228
- return await routeConfig.handler(context);
229
- }
230
-
231
- let index = 0;
232
- const executeNext = async (): Promise<Response> => {
233
- if (index < middleware.length) {
234
- const currentMiddleware = middleware[index++];
235
- return await currentMiddleware(context!, executeNext);
236
- }
237
- return await routeConfig.handler(context!);
238
- };
239
-
240
- return await executeNext();
241
- } catch (error) {
242
- if (error instanceof Response) return error;
243
-
244
- if (errorHandler) {
245
- try {
246
- if (!context) {
247
- const locals: Record<string, unknown> = {};
248
- context = {
249
- request,
250
- params: Object.fromEntries(
251
- Object.entries(params).map(([key, value]) => [
252
- key,
253
- Array.isArray(value) ? value.join('/') : value,
254
- ]),
255
- ),
256
- response: new ApiResponseBuilder(),
257
- server: serverInstance,
258
- locals,
259
- require: createRequire((): Record<string, unknown> => locals),
260
- services: { cache: this.getCacheService() },
261
- ...this.getRenderContext(),
262
- };
263
- }
264
- return await errorHandler(error, context);
265
- } catch (handlerError) {
266
- appLogger.error(`[ecopages] Error in custom error handler: ${handlerError}`);
267
- }
268
- }
269
-
270
- if (error instanceof HttpError) return error.toResponse();
271
- appLogger.error(`[ecopages] Error handling API request: ${error}`);
272
- return new Response('Internal Server Error', { status: 500 });
273
- }
274
- }
275
-
276
- private normalizePath(pathname: string): string {
277
- if (pathname.length > 1 && pathname.endsWith('/')) {
278
- return pathname.slice(0, -1);
279
- }
280
-
281
- return pathname;
282
- }
283
-
284
- private matchApiPath(pattern: string, pathname: string): Record<string, string | string[]> | null {
285
- const normalizedPattern = this.normalizePath(pattern);
286
- const normalizedPathname = this.normalizePath(pathname);
287
-
288
- const patternSegments = normalizedPattern.split('/').filter(Boolean);
289
- const pathSegments = normalizedPathname.split('/').filter(Boolean);
290
- const params: Record<string, string | string[]> = {};
291
-
292
- let patternIndex = 0;
293
- let pathIndex = 0;
294
-
295
- while (patternIndex < patternSegments.length && pathIndex < pathSegments.length) {
296
- const patternSegment = patternSegments[patternIndex];
297
- const pathSegment = pathSegments[pathIndex];
298
-
299
- if (patternSegment === '*') {
300
- return params;
301
- }
302
-
303
- if (patternSegment.startsWith('[...') && patternSegment.endsWith(']')) {
304
- const paramName = patternSegment.slice(4, -1);
305
- params[paramName] = pathSegments.slice(pathIndex);
306
- return params;
307
- }
308
-
309
- if (patternSegment.startsWith(':')) {
310
- params[patternSegment.slice(1)] = pathSegment;
311
- patternIndex++;
312
- pathIndex++;
313
- continue;
314
- }
315
-
316
- if (patternSegment.startsWith('[') && patternSegment.endsWith(']')) {
317
- params[patternSegment.slice(1, -1)] = pathSegment;
318
- patternIndex++;
319
- pathIndex++;
320
- continue;
321
- }
322
-
323
- if (patternSegment !== pathSegment) {
324
- return null;
325
- }
326
-
327
- patternIndex++;
328
- pathIndex++;
329
- }
330
-
331
- if (patternIndex < patternSegments.length) {
332
- const remaining = patternSegments.slice(patternIndex);
333
- const catchAll = remaining[0];
334
-
335
- if (
336
- remaining.length === 1 &&
337
- (catchAll === '*' || (catchAll.startsWith('[...') && catchAll.endsWith(']')))
338
- ) {
339
- if (catchAll.startsWith('[...')) {
340
- const paramName = catchAll.slice(4, -1);
341
- params[paramName] = [];
342
- }
343
- return params;
344
- }
345
-
346
- return null;
347
- }
348
-
349
- if (pathIndex < pathSegments.length) {
350
- return null;
351
- }
352
-
353
- return params;
354
- }
355
-
356
- private getApiPathScore(pattern: string): number {
357
- const segments = this.normalizePath(pattern).split('/').filter(Boolean);
358
- let score = 0;
359
- for (const segment of segments) {
360
- if (segment === '*' || (segment.startsWith('[...') && segment.endsWith(']'))) {
361
- score += 10;
362
- } else if (segment.startsWith(':') || (segment.startsWith('[') && segment.endsWith(']'))) {
363
- score += 50;
364
- } else {
365
- score += 100;
366
- }
367
- }
368
- return score;
369
- }
370
-
371
- protected matchApiHandler(
372
- request: Request,
373
- apiHandlers: ApiHandler[],
374
- ): { routeConfig: ApiHandler; params: Record<string, string | string[]> } | null {
375
- const pathname = new URL(request.url).pathname;
376
- const method = request.method.toUpperCase();
377
-
378
- const sortedHandlers = [...apiHandlers].sort((a, b) => {
379
- return this.getApiPathScore(b.path) - this.getApiPathScore(a.path);
380
- });
381
-
382
- for (const routeConfig of sortedHandlers) {
383
- const routeMethod = (routeConfig.method || 'GET').toUpperCase();
384
- if (routeMethod !== method) {
385
- continue;
386
- }
387
-
388
- const params = this.matchApiPath(routeConfig.path, pathname);
389
- if (params) {
390
- return { routeConfig, params };
391
- }
392
- }
393
-
394
- return null;
395
- }
396
-
397
- /**
398
- * Universally processes an incoming WinterCG Web standard Request.
399
- *
400
- * 1. Resolves static Hot Module Replacement runtime blobs if development.
401
- * 2. Checks if the incoming request matches any parsed API route schemas.
402
- * - Routes through `executeApiHandler` which performs strict validation.
403
- * 3. Falls through to standard `ServerRouteHandler` for React/Lit filesystem pages.
404
- *
405
- * Both Bun and Node bindings fall back to this exact function once they have mapped their
406
- * native HTTP objects into Web Standard Requests.
407
- */
408
- public async handleSharedRequest(
409
- request: Request,
410
- context: {
411
- apiHandlers: ApiHandler[];
412
- errorHandler?: ErrorHandler;
413
- serverInstance?: any;
414
- hmrManager?: any;
415
- },
416
- ): Promise<Response> {
417
- const url = new URL(request.url);
418
-
419
- if (url.pathname === '/_hmr_runtime.js' && context.hmrManager) {
420
- const runtimePath = context.hmrManager.getRuntimePath();
421
- const fileSystem = (await import('@ecopages/file-system')).fileSystem;
422
- if (fileSystem.exists(runtimePath)) {
423
- return new Response(fileSystem.readFileAsBuffer(runtimePath) as BodyInit, {
424
- headers: { 'Content-Type': 'application/javascript' },
425
- });
426
- }
427
- }
428
-
429
- const apiMatch = this.matchApiHandler(request, context.apiHandlers);
430
- if (apiMatch) {
431
- return this.executeApiHandler(
432
- request,
433
- apiMatch.params,
434
- apiMatch.routeConfig,
435
- context.serverInstance,
436
- context.errorHandler,
437
- );
438
- }
439
-
440
- return this.routeHandler.handleResponse(request);
441
- }
442
- }
@@ -1,166 +0,0 @@
1
- import type { IHmrManager } from '../../public-types';
2
- import type { FSRouter } from '../../router/fs-router';
3
- import type { ExplicitStaticRouteMatcher } from './explicit-static-route-matcher';
4
- import type { FileSystemResponseMatcher } from './fs-server-response-matcher';
5
- import { appLogger } from '../../global/app-logger';
6
- import { HttpError } from '../../errors/http-error';
7
-
8
- /**
9
- * Configuration parameters for ServerRouteHandler.
10
- */
11
- export interface ServerRouteHandlerParams {
12
- /** File system router for matching request URLs to route handlers. */
13
- router: FSRouter;
14
- /** Matcher for handling file system route responses. */
15
- fileSystemResponseMatcher: FileSystemResponseMatcher;
16
- /** Optional matcher for explicit static routes like processed images or sitemaps. */
17
- explicitStaticRouteMatcher?: ExplicitStaticRouteMatcher;
18
- /** Enable watch mode for development. */
19
- watch?: boolean;
20
- /** HMR manager for broadcasting hot module reload events in development. */
21
- hmrManager?: IHmrManager;
22
- }
23
-
24
- /**
25
- * Handles HTTP requests and routing for the server.
26
- *
27
- * This class manages the request routing flow with a priority-based approach:
28
- * 1. Explicit static routes (highest priority - intentional mappings like /sitemap.xml)
29
- * 2. File-based routes without extensions (application routes)
30
- * 3. Static file fallback (lowest priority - disk serving)
31
- *
32
- * In development mode, it also injects HMR scripts into HTML responses.
33
- */
34
- export class ServerRouteHandler {
35
- private readonly router: FSRouter;
36
- private readonly fileSystemResponseMatcher: FileSystemResponseMatcher;
37
- private readonly explicitStaticRouteMatcher?: ExplicitStaticRouteMatcher;
38
- private readonly watch: boolean;
39
- private readonly hmrManager?: IHmrManager;
40
-
41
- /**
42
- * Creates a new ServerRouteHandler instance.
43
- *
44
- * @param params - Configuration parameters
45
- */
46
- constructor({
47
- router,
48
- fileSystemResponseMatcher,
49
- explicitStaticRouteMatcher,
50
- watch = false,
51
- hmrManager,
52
- }: ServerRouteHandlerParams) {
53
- this.router = router;
54
- this.fileSystemResponseMatcher = fileSystemResponseMatcher;
55
- this.explicitStaticRouteMatcher = explicitStaticRouteMatcher;
56
- this.watch = watch;
57
- this.hmrManager = hmrManager;
58
- }
59
-
60
- /**
61
- * Determines if HMR script should be injected.
62
- *
63
- * @returns true if in watch mode and HMR manager is enabled
64
- */
65
- shouldInjectHmrScript(): boolean {
66
- return this.watch && this.hmrManager?.isEnabled() === true;
67
- }
68
-
69
- /**
70
- * Checks if a response contains HTML content.
71
- *
72
- * @param response - The HTTP response to check
73
- * @returns true if Content-Type header starts with 'text/html'
74
- */
75
- isHtmlResponse(response: Response): boolean {
76
- const contentType = response.headers.get('Content-Type');
77
- return contentType !== null && contentType.startsWith('text/html');
78
- }
79
-
80
- /**
81
- * Handles HTTP requests from the router adapter.
82
- *
83
- * Priority-based routing flow:
84
- * 1. Check explicit static routes first (e.g., /sitemap.xml, /image.webp from plugins)
85
- * 2. Match file-based routes without extensions (application routes)
86
- * 3. Fall back to static file serving from disk
87
- *
88
- * @param request - The incoming HTTP request
89
- * @returns HTTP response, potentially with injected HMR script in dev mode
90
- */
91
- async handleResponse(request: Request): Promise<Response> {
92
- const pathname = new URL(request.url).pathname;
93
-
94
- const explicitMatch = this.explicitStaticRouteMatcher?.match(request.url);
95
-
96
- if (explicitMatch) {
97
- const response = await this.explicitStaticRouteMatcher!.handleMatch(explicitMatch);
98
- return this.maybeInjectHmrScript(response);
99
- }
100
-
101
- const fsMatch = !pathname.includes('.') && this.router.match(request.url);
102
-
103
- const response = await (fsMatch
104
- ? this.fileSystemResponseMatcher.handleMatch(fsMatch, request)
105
- : this.handleNoMatch(request));
106
-
107
- return this.maybeInjectHmrScript(response);
108
- }
109
-
110
- /**
111
- * Injects HMR script into HTML responses in development mode.
112
- *
113
- * The script is inserted before the closing </html> tag to enable
114
- * hot module reloading without full page refreshes.
115
- *
116
- * @param response - The HTTP response to potentially modify
117
- * @returns Original response or modified response with HMR script
118
- */
119
- private async maybeInjectHmrScript(response: Response): Promise<Response> {
120
- if (this.shouldInjectHmrScript() && this.isHtmlResponse(response)) {
121
- const html = await response.text();
122
-
123
- const hmrScript = `<script type="module">import '/_hmr_runtime.js';</script>`;
124
-
125
- const updatedHtml = html.replace(/<\/html>/i, `${hmrScript}</html>`);
126
-
127
- const headers = new Headers(response.headers);
128
- headers.delete('Content-Length');
129
-
130
- return new Response(updatedHtml, {
131
- status: response.status,
132
- statusText: response.statusText,
133
- headers,
134
- });
135
- }
136
-
137
- return response;
138
- }
139
-
140
- /**
141
- * Handles requests that do not match any routes.
142
- *
143
- * This is the final fallback that attempts to serve static files from disk.
144
- * If the requested path corresponds to an HTML file or no file is found,
145
- * a custom 404 response is returned.
146
- *
147
- * @param request - The HTTP request to handle
148
- * @returns Response from file system or error response
149
- * @throws HttpError for standard HTTP errors
150
- */
151
- async handleNoMatch(request: Request): Promise<Response> {
152
- try {
153
- const pathname = new URL(request.url).pathname;
154
- return await this.fileSystemResponseMatcher.handleNoMatch(pathname);
155
- } catch (error) {
156
- if (error instanceof HttpError) {
157
- return error.toResponse();
158
- }
159
- if (error instanceof Error) {
160
- this.hmrManager?.broadcast({ type: 'error', message: error.message });
161
- appLogger.error('Error handling no match:', error);
162
- }
163
- return new Response('Internal Server Error', { status: 500 });
164
- }
165
- }
166
- }
@@ -1,82 +0,0 @@
1
- import { StaticContentServer } from '../../dev/sc-server';
2
- import { appLogger } from '../../global/app-logger';
3
- import type { EcoPagesAppConfig } from '../../internal-types';
4
- import type { StaticRoute } from '../../public-types';
5
- import type { RouteRendererFactory } from '../../route-renderer/route-renderer';
6
- import type { FSRouter } from '../../router/fs-router';
7
- import type { StaticSiteGenerator } from '../../static-site-generator/static-site-generator';
8
-
9
- export interface StaticBuildOptions {
10
- preview?: boolean;
11
- }
12
-
13
- export interface ServeOptions {
14
- hostname?: string;
15
- port?: number | string;
16
- }
17
-
18
- export interface ServerStaticBuilderParams {
19
- appConfig: EcoPagesAppConfig;
20
- staticSiteGenerator: StaticSiteGenerator;
21
- serveOptions: ServeOptions;
22
- }
23
-
24
- /**
25
- * Handles static site generation and previews.
26
- */
27
- export class ServerStaticBuilder {
28
- private readonly appConfig: EcoPagesAppConfig;
29
- private readonly staticSiteGenerator: StaticSiteGenerator;
30
- private readonly serveOptions: ServeOptions;
31
-
32
- constructor({ appConfig, staticSiteGenerator, serveOptions }: ServerStaticBuilderParams) {
33
- this.appConfig = appConfig;
34
- this.staticSiteGenerator = staticSiteGenerator;
35
- this.serveOptions = serveOptions;
36
- }
37
-
38
- /**
39
- * Generates a static build of the site for deployment.
40
- * @param options.preview - If true, starts a preview server after build
41
- * @param dependencies.router - The initialized router
42
- * @param dependencies.routeRendererFactory - The route renderer factory
43
- * @param dependencies.staticRoutes - Explicit static routes registered via app.static()
44
- */
45
- async build(
46
- options: StaticBuildOptions | undefined,
47
- dependencies: {
48
- router: FSRouter;
49
- routeRendererFactory: RouteRendererFactory;
50
- staticRoutes?: StaticRoute[];
51
- },
52
- ): Promise<void> {
53
- const { preview = false } = options ?? {};
54
-
55
- const baseUrl = `http://${this.serveOptions.hostname || 'localhost'}:${this.serveOptions.port || 3000}`;
56
-
57
- await this.staticSiteGenerator.run({
58
- router: dependencies.router,
59
- baseUrl,
60
- routeRendererFactory: dependencies.routeRendererFactory,
61
- staticRoutes: dependencies.staticRoutes,
62
- });
63
-
64
- if (!preview) {
65
- appLogger.info('Build completed');
66
- return;
67
- }
68
-
69
- const previewPort = this.serveOptions.port || 3000;
70
-
71
- const { server } = StaticContentServer.createServer({
72
- appConfig: this.appConfig,
73
- options: { port: Number(previewPort) },
74
- });
75
-
76
- if (server) {
77
- appLogger.info(`Preview running at http://localhost:${server.port}`);
78
- } else {
79
- appLogger.error('Failed to start preview server');
80
- }
81
- }
82
- }