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

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