@ecopages/core 0.2.0-alpha.1 → 0.2.0-alpha.10

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 (323) hide show
  1. package/CHANGELOG.md +13 -70
  2. package/README.md +213 -12
  3. package/package.json +50 -18
  4. package/src/adapters/README.md +39 -0
  5. package/src/adapters/bun/hmr-manager.d.ts +77 -18
  6. package/src/adapters/bun/hmr-manager.js +159 -52
  7. package/src/adapters/bun/index.d.ts +1 -2
  8. package/src/adapters/bun/index.js +1 -1
  9. package/src/adapters/bun/server-adapter.js +35 -30
  10. package/src/adapters/bun/server-lifecycle.d.ts +24 -13
  11. package/src/adapters/bun/server-lifecycle.js +32 -60
  12. package/src/adapters/index.d.ts +1 -1
  13. package/src/adapters/index.js +1 -1
  14. package/src/adapters/node/bootstrap-dependency-resolver.d.ts +44 -0
  15. package/src/adapters/node/bootstrap-dependency-resolver.js +172 -0
  16. package/src/adapters/node/index.d.ts +2 -0
  17. package/src/adapters/node/index.js +3 -0
  18. package/src/adapters/node/node-hmr-manager.d.ts +87 -16
  19. package/src/adapters/node/node-hmr-manager.js +179 -88
  20. package/src/adapters/node/runtime-adapter.d.ts +46 -0
  21. package/src/adapters/node/runtime-adapter.js +306 -0
  22. package/src/adapters/node/server-adapter.d.ts +2 -31
  23. package/src/adapters/node/server-adapter.js +31 -93
  24. package/src/adapters/node/static-content-server.d.ts +36 -0
  25. package/src/adapters/node/static-content-server.js +28 -0
  26. package/src/adapters/node/write-runtime-manifest.d.ts +26 -0
  27. package/src/adapters/node/write-runtime-manifest.js +12 -0
  28. package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
  29. package/src/adapters/shared/explicit-static-route-matcher.js +4 -1
  30. package/src/adapters/shared/file-route-middleware-pipeline.js +1 -0
  31. package/src/adapters/shared/fs-server-response-matcher.d.ts +9 -5
  32. package/src/adapters/shared/fs-server-response-matcher.js +13 -8
  33. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  34. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  35. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  36. package/src/adapters/shared/hmr-html-response.js +32 -0
  37. package/src/adapters/shared/render-context.js +3 -2
  38. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  39. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  40. package/src/adapters/shared/server-adapter.d.ts +12 -2
  41. package/src/adapters/shared/server-adapter.js +37 -4
  42. package/src/adapters/shared/server-route-handler.d.ts +1 -1
  43. package/src/adapters/shared/server-route-handler.js +4 -13
  44. package/src/adapters/shared/server-static-builder.d.ts +35 -3
  45. package/src/adapters/shared/server-static-builder.js +59 -6
  46. package/src/build/README.md +101 -0
  47. package/src/build/build-adapter.d.ts +114 -2
  48. package/src/build/build-adapter.js +119 -5
  49. package/src/build/build-manifest.d.ts +27 -0
  50. package/src/build/build-manifest.js +30 -0
  51. package/src/build/dev-build-coordinator.d.ts +74 -0
  52. package/src/build/dev-build-coordinator.js +161 -0
  53. package/src/build/esbuild-build-adapter.d.ts +9 -6
  54. package/src/build/esbuild-build-adapter.js +103 -71
  55. package/src/build/runtime-build-executor.d.ts +13 -0
  56. package/src/build/runtime-build-executor.js +20 -0
  57. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  58. package/src/build/runtime-specifier-alias-plugin.js +31 -0
  59. package/src/config/README.md +33 -0
  60. package/src/config/config-builder.d.ts +28 -17
  61. package/src/config/config-builder.js +221 -48
  62. package/src/constants.d.ts +13 -0
  63. package/src/constants.js +4 -0
  64. package/src/declarations.d.ts +18 -13
  65. package/src/eco/README.md +70 -16
  66. package/src/eco/component-render-context.d.ts +1 -1
  67. package/src/eco/component-render-context.js +26 -16
  68. package/src/eco/eco.js +16 -12
  69. package/src/eco/eco.types.d.ts +12 -4
  70. package/src/hmr/README.md +26 -0
  71. package/src/hmr/client/hmr-runtime.d.ts +1 -6
  72. package/src/hmr/client/hmr-runtime.js +30 -7
  73. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  74. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  75. package/src/hmr/hmr.test.e2e.js +26 -33
  76. package/src/hmr/strategies/js-hmr-strategy.d.ts +45 -42
  77. package/src/hmr/strategies/js-hmr-strategy.js +70 -71
  78. package/src/index.d.ts +1 -1
  79. package/src/index.js +1 -1
  80. package/src/integrations/ghtml/ghtml-renderer.d.ts +1 -1
  81. package/src/integrations/ghtml/ghtml-renderer.js +3 -1
  82. package/src/internal-types.d.ts +39 -18
  83. package/src/plugins/README.md +34 -0
  84. package/src/plugins/alias-resolver-plugin.js +17 -3
  85. package/src/plugins/eco-component-meta-plugin.d.ts +2 -0
  86. package/src/plugins/eco-component-meta-plugin.js +1 -1
  87. package/src/plugins/integration-plugin.d.ts +38 -4
  88. package/src/plugins/integration-plugin.js +34 -1
  89. package/src/plugins/processor.d.ts +14 -1
  90. package/src/plugins/processor.js +15 -1
  91. package/src/plugins/runtime-capability.d.ts +9 -0
  92. package/src/public-types.d.ts +65 -10
  93. package/src/route-renderer/GRAPH.md +16 -20
  94. package/src/route-renderer/README.md +8 -21
  95. package/src/route-renderer/component-graph/component-reference.d.ts +10 -0
  96. package/src/route-renderer/component-graph/component-reference.js +19 -0
  97. package/src/route-renderer/{marker-graph-resolver.d.ts → component-graph/marker-graph-resolver.d.ts} +6 -5
  98. package/src/route-renderer/{marker-graph-resolver.js → component-graph/marker-graph-resolver.js} +10 -8
  99. package/src/route-renderer/{integration-renderer.d.ts → orchestration/integration-renderer.d.ts} +45 -12
  100. package/src/route-renderer/{integration-renderer.js → orchestration/integration-renderer.js} +79 -16
  101. package/src/route-renderer/{render-execution.service.d.ts → orchestration/render-execution.service.d.ts} +39 -5
  102. package/src/route-renderer/{render-execution.service.js → orchestration/render-execution.service.js} +58 -28
  103. package/src/route-renderer/{render-preparation.service.d.ts → orchestration/render-preparation.service.d.ts} +13 -4
  104. package/src/route-renderer/{render-preparation.service.js → orchestration/render-preparation.service.js} +92 -3
  105. package/src/route-renderer/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
  106. package/src/route-renderer/{dependency-resolver.js → page-loading/dependency-resolver.js} +18 -4
  107. package/src/route-renderer/page-loading/page-module-loader.d.ts +87 -0
  108. package/src/route-renderer/{page-module-loader.js → page-loading/page-module-loader.js} +36 -14
  109. package/src/route-renderer/route-renderer.d.ts +36 -1
  110. package/src/route-renderer/route-renderer.js +19 -0
  111. package/src/router/README.md +26 -0
  112. package/src/router/client/link-intent.d.ts +53 -0
  113. package/src/router/client/link-intent.js +34 -0
  114. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  115. package/src/router/client/link-intent.test.browser.js +43 -0
  116. package/src/router/client/navigation-coordinator.d.ts +149 -0
  117. package/src/router/client/navigation-coordinator.js +215 -0
  118. package/src/router/{fs-router-scanner.d.ts → server/fs-router-scanner.d.ts} +3 -3
  119. package/src/router/{fs-router-scanner.js → server/fs-router-scanner.js} +8 -7
  120. package/src/router/{fs-router.d.ts → server/fs-router.d.ts} +1 -1
  121. package/src/router/{fs-router.js → server/fs-router.js} +1 -1
  122. package/src/services/README.md +29 -0
  123. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +120 -0
  124. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +88 -7
  125. package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
  126. package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +2 -1
  127. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  128. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  129. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +48 -0
  130. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  131. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  132. package/src/services/{asset-processing-service → assets/asset-processing-service}/index.d.ts +2 -0
  133. package/src/services/{asset-processing-service → assets/asset-processing-service}/index.js +2 -0
  134. package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +1 -1
  135. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
  136. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +9 -4
  137. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.d.ts +3 -2
  138. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.js +14 -22
  139. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +1 -1
  140. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +2 -2
  141. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +5 -4
  142. package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +4 -1
  143. package/src/services/assets/browser-bundle.service.d.ts +32 -0
  144. package/src/services/assets/browser-bundle.service.js +33 -0
  145. package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
  146. package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
  147. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  148. package/src/services/html/html-rewriter-provider.service.js +65 -0
  149. package/src/services/html/html-transformer.service.d.ts +77 -0
  150. package/src/services/html/html-transformer.service.js +221 -0
  151. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  152. package/src/services/invalidation/development-invalidation.service.js +189 -0
  153. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +16 -0
  154. package/src/services/module-loading/app-server-module-transpiler.service.js +34 -0
  155. package/src/services/module-loading/page-module-import.service.d.ts +71 -0
  156. package/src/services/module-loading/page-module-import.service.js +132 -0
  157. package/src/services/module-loading/server-loader.service.d.ts +96 -0
  158. package/src/services/module-loading/server-loader.service.js +32 -0
  159. package/src/services/module-loading/server-module-transpiler.service.d.ts +69 -0
  160. package/src/services/module-loading/server-module-transpiler.service.js +61 -0
  161. package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +35 -0
  162. package/src/services/runtime-manifest/node-runtime-manifest.service.js +60 -0
  163. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  164. package/src/services/runtime-state/dev-graph.service.js +162 -0
  165. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  166. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  167. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  168. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  169. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  170. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  171. package/src/services/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
  172. package/src/static-site-generator/README.md +26 -0
  173. package/src/static-site-generator/static-site-generator.d.ts +53 -1
  174. package/src/static-site-generator/static-site-generator.js +86 -5
  175. package/src/utils/resolve-work-dir.d.ts +11 -0
  176. package/src/utils/resolve-work-dir.js +31 -0
  177. package/src/watchers/project-watcher.d.ts +37 -21
  178. package/src/watchers/project-watcher.js +109 -66
  179. package/src/watchers/project-watcher.test-helpers.js +1 -0
  180. package/src/adapters/abstract/application-adapter.ts +0 -337
  181. package/src/adapters/abstract/router-adapter.ts +0 -30
  182. package/src/adapters/abstract/server-adapter.ts +0 -79
  183. package/src/adapters/bun/client-bridge.ts +0 -62
  184. package/src/adapters/bun/create-app.ts +0 -189
  185. package/src/adapters/bun/define-api-handler.d.ts +0 -61
  186. package/src/adapters/bun/define-api-handler.ts +0 -114
  187. package/src/adapters/bun/hmr-manager.ts +0 -281
  188. package/src/adapters/bun/index.ts +0 -3
  189. package/src/adapters/bun/server-adapter.ts +0 -492
  190. package/src/adapters/bun/server-lifecycle.ts +0 -154
  191. package/src/adapters/index.ts +0 -6
  192. package/src/adapters/node/create-app.ts +0 -179
  193. package/src/adapters/node/index.ts +0 -9
  194. package/src/adapters/node/node-client-bridge.ts +0 -79
  195. package/src/adapters/node/node-hmr-manager.ts +0 -271
  196. package/src/adapters/node/server-adapter.ts +0 -561
  197. package/src/adapters/node/static-content-server.ts +0 -203
  198. package/src/adapters/shared/api-response.ts +0 -104
  199. package/src/adapters/shared/application-adapter.ts +0 -199
  200. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
  201. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
  202. package/src/adapters/shared/fs-server-response-factory.ts +0 -118
  203. package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
  204. package/src/adapters/shared/render-context.ts +0 -105
  205. package/src/adapters/shared/server-adapter.ts +0 -442
  206. package/src/adapters/shared/server-route-handler.ts +0 -166
  207. package/src/adapters/shared/server-static-builder.ts +0 -82
  208. package/src/build/build-adapter.ts +0 -132
  209. package/src/build/build-types.ts +0 -83
  210. package/src/build/esbuild-build-adapter.ts +0 -510
  211. package/src/config/config-builder.ts +0 -474
  212. package/src/constants.ts +0 -39
  213. package/src/create-app.ts +0 -87
  214. package/src/define-api-handler.js +0 -15
  215. package/src/define-api-handler.ts +0 -66
  216. package/src/dev/sc-server.ts +0 -143
  217. package/src/eco/component-render-context.ts +0 -202
  218. package/src/eco/eco.ts +0 -221
  219. package/src/eco/eco.types.ts +0 -202
  220. package/src/eco/eco.utils.ts +0 -89
  221. package/src/eco/global-injector-map.ts +0 -112
  222. package/src/eco/lazy-injector-map.ts +0 -120
  223. package/src/eco/module-dependencies.ts +0 -75
  224. package/src/errors/http-error.ts +0 -72
  225. package/src/errors/index.ts +0 -2
  226. package/src/errors/locals-access-error.ts +0 -7
  227. package/src/global/app-logger.ts +0 -4
  228. 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
  229. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  230. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  231. package/src/hmr/client/hmr-runtime.ts +0 -121
  232. package/src/hmr/hmr-strategy.ts +0 -172
  233. package/src/hmr/hmr.test.e2e.ts +0 -75
  234. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  235. package/src/hmr/strategies/js-hmr-strategy.ts +0 -308
  236. package/src/index.browser.ts +0 -3
  237. package/src/index.ts +0 -5
  238. package/src/integrations/ghtml/ghtml-renderer.ts +0 -93
  239. package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
  240. package/src/internal-types.ts +0 -212
  241. package/src/plugins/alias-resolver-plugin.ts +0 -45
  242. package/src/plugins/eco-component-meta-plugin.ts +0 -474
  243. package/src/plugins/integration-plugin.ts +0 -184
  244. package/src/plugins/processor.ts +0 -220
  245. package/src/public-types.ts +0 -1255
  246. package/src/route-renderer/component-graph-executor.ts +0 -84
  247. package/src/route-renderer/component-graph.ts +0 -159
  248. package/src/route-renderer/component-marker.ts +0 -117
  249. package/src/route-renderer/dependency-resolver.ts +0 -596
  250. package/src/route-renderer/html-post-processing.service.d.ts +0 -40
  251. package/src/route-renderer/html-post-processing.service.js +0 -86
  252. package/src/route-renderer/html-post-processing.service.ts +0 -103
  253. package/src/route-renderer/integration-renderer.ts +0 -696
  254. package/src/route-renderer/marker-graph-resolver.ts +0 -153
  255. package/src/route-renderer/page-module-loader.d.ts +0 -61
  256. package/src/route-renderer/page-module-loader.ts +0 -153
  257. package/src/route-renderer/render-execution.service.ts +0 -158
  258. package/src/route-renderer/render-preparation.service.ts +0 -358
  259. package/src/route-renderer/route-renderer.ts +0 -80
  260. package/src/router/fs-router-scanner.ts +0 -217
  261. package/src/router/fs-router.ts +0 -122
  262. package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
  263. package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
  264. package/src/services/asset-processing-service/asset.factory.ts +0 -105
  265. package/src/services/asset-processing-service/assets.types.ts +0 -112
  266. package/src/services/asset-processing-service/index.ts +0 -3
  267. package/src/services/asset-processing-service/processor.interface.ts +0 -27
  268. package/src/services/asset-processing-service/processor.registry.ts +0 -18
  269. package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
  270. package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
  271. package/src/services/asset-processing-service/processors/index.ts +0 -5
  272. package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
  273. package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
  274. package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
  275. package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
  276. package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
  277. package/src/services/cache/cache.types.ts +0 -126
  278. package/src/services/cache/index.ts +0 -18
  279. package/src/services/cache/memory-cache-store.ts +0 -130
  280. package/src/services/cache/page-cache-service.ts +0 -202
  281. package/src/services/html-transformer.service.d.ts +0 -50
  282. package/src/services/html-transformer.service.js +0 -163
  283. package/src/services/html-transformer.service.ts +0 -217
  284. package/src/services/page-module-import.service.d.ts +0 -37
  285. package/src/services/page-module-import.service.js +0 -88
  286. package/src/services/page-module-import.service.ts +0 -129
  287. package/src/services/page-request-cache-coordinator.service.ts +0 -128
  288. package/src/services/schema-validation-service.ts +0 -204
  289. package/src/services/validation/standard-schema.types.ts +0 -68
  290. package/src/static-site-generator/static-site-generator.ts +0 -359
  291. package/src/utils/css.ts +0 -5
  292. package/src/utils/deep-merge.ts +0 -47
  293. package/src/utils/hash.ts +0 -5
  294. package/src/utils/html.ts +0 -1
  295. package/src/utils/invariant.ts +0 -15
  296. package/src/utils/locals-utils.ts +0 -37
  297. package/src/utils/parse-cli-args.ts +0 -83
  298. package/src/utils/path-utils.module.ts +0 -14
  299. package/src/utils/runtime.ts +0 -44
  300. package/src/utils/server-utils.module.ts +0 -67
  301. package/src/watchers/project-watcher.test-helpers.ts +0 -40
  302. package/src/watchers/project-watcher.ts +0 -306
  303. /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
  304. /package/src/{services/asset-processing-service/assets.types.js → plugins/runtime-capability.js} +0 -0
  305. /package/src/route-renderer/{component-graph-executor.d.ts → component-graph/component-graph-executor.d.ts} +0 -0
  306. /package/src/route-renderer/{component-graph-executor.js → component-graph/component-graph-executor.js} +0 -0
  307. /package/src/route-renderer/{component-graph.d.ts → component-graph/component-graph.d.ts} +0 -0
  308. /package/src/route-renderer/{component-graph.js → component-graph/component-graph.js} +0 -0
  309. /package/src/route-renderer/{component-marker.d.ts → component-graph/component-marker.d.ts} +0 -0
  310. /package/src/route-renderer/{component-marker.js → component-graph/component-marker.js} +0 -0
  311. /package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +0 -0
  312. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
  313. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +0 -0
  314. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
  315. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/index.d.ts +0 -0
  316. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/index.js +0 -0
  317. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +0 -0
  318. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.js +0 -0
  319. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +0 -0
  320. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +0 -0
  321. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.js +0 -0
  322. /package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +0 -0
  323. /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
- }