@ecopages/core 0.2.0-alpha.27 → 0.2.0-alpha.28

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 (546) hide show
  1. package/CHANGELOG.md +91 -0
  2. package/package.json +162 -72
  3. package/src/adapters/abstract/application-adapter.d.ts +194 -0
  4. package/src/adapters/abstract/application-adapter.js +121 -0
  5. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  6. package/src/adapters/abstract/router-adapter.js +5 -0
  7. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  8. package/src/adapters/abstract/server-adapter.js +15 -0
  9. package/src/adapters/bun/client-bridge.d.ts +34 -0
  10. package/src/adapters/bun/client-bridge.js +48 -0
  11. package/src/adapters/bun/create-app.d.ts +53 -0
  12. package/src/adapters/bun/create-app.js +153 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +131 -0
  14. package/src/adapters/bun/hmr-manager.js +312 -0
  15. package/src/adapters/bun/index.d.ts +2 -0
  16. package/src/adapters/bun/index.js +8 -0
  17. package/src/adapters/bun/server-adapter.d.ts +155 -0
  18. package/src/adapters/bun/server-adapter.js +393 -0
  19. package/src/adapters/bun/server-lifecycle.d.ts +63 -0
  20. package/src/adapters/bun/server-lifecycle.js +92 -0
  21. package/src/adapters/create-app.d.ts +20 -0
  22. package/src/adapters/create-app.js +66 -0
  23. package/src/adapters/index.d.ts +2 -0
  24. package/src/adapters/index.js +8 -0
  25. package/src/adapters/node/create-app.d.ts +18 -0
  26. package/src/adapters/node/create-app.js +149 -0
  27. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  28. package/src/adapters/node/node-client-bridge.js +66 -0
  29. package/src/adapters/node/node-hmr-manager.d.ts +121 -0
  30. package/src/adapters/node/node-hmr-manager.js +290 -0
  31. package/src/adapters/node/server-adapter.d.ts +162 -0
  32. package/src/adapters/node/server-adapter.js +368 -0
  33. package/src/adapters/node/static-content-server.d.ts +60 -0
  34. package/src/adapters/node/static-content-server.js +194 -0
  35. package/src/adapters/shared/api-response.d.ts +52 -0
  36. package/src/adapters/shared/api-response.js +96 -0
  37. package/src/adapters/shared/application-adapter.d.ts +18 -0
  38. package/src/adapters/shared/application-adapter.js +90 -0
  39. package/src/adapters/shared/define-api-handler.d.ts +25 -0
  40. package/src/adapters/shared/define-api-handler.js +15 -0
  41. package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
  42. package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
  43. package/src/adapters/shared/explicit-static-route-matcher.d.ts +41 -0
  44. package/src/adapters/shared/explicit-static-route-matcher.js +101 -0
  45. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +62 -0
  46. package/src/adapters/shared/file-route-middleware-pipeline.js +90 -0
  47. package/src/adapters/shared/fs-server-response-factory.d.ts +23 -0
  48. package/src/adapters/shared/fs-server-response-factory.js +81 -0
  49. package/src/adapters/shared/fs-server-response-matcher.d.ts +75 -0
  50. package/src/adapters/shared/fs-server-response-matcher.js +186 -0
  51. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  52. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  53. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  54. package/src/adapters/shared/hmr-html-response.js +32 -0
  55. package/src/adapters/shared/render-context.d.ts +15 -0
  56. package/src/adapters/shared/render-context.js +72 -0
  57. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  58. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  59. package/src/adapters/shared/server-adapter.d.ts +108 -0
  60. package/src/adapters/shared/server-adapter.js +429 -0
  61. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  62. package/src/adapters/shared/server-route-handler.js +111 -0
  63. package/src/adapters/shared/server-static-builder.d.ts +71 -0
  64. package/src/adapters/shared/server-static-builder.js +100 -0
  65. package/src/build/build-adapter.d.ts +239 -0
  66. package/src/build/build-adapter.js +642 -0
  67. package/src/build/build-manifest.d.ts +27 -0
  68. package/src/build/build-manifest.js +30 -0
  69. package/src/build/build-types.d.ts +57 -0
  70. package/src/build/build-types.js +0 -0
  71. package/src/build/dev-build-coordinator.d.ts +72 -0
  72. package/src/build/dev-build-coordinator.js +154 -0
  73. package/src/build/esbuild-build-adapter.d.ts +78 -0
  74. package/src/build/esbuild-build-adapter.js +505 -0
  75. package/src/build/runtime-build-executor.d.ts +14 -0
  76. package/src/build/runtime-build-executor.js +22 -0
  77. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  78. package/src/build/runtime-specifier-alias-plugin.js +35 -0
  79. package/src/build/runtime-specifier-aliases.d.ts +5 -0
  80. package/src/build/runtime-specifier-aliases.js +95 -0
  81. package/src/config/config-builder.d.ts +252 -0
  82. package/src/config/config-builder.js +598 -0
  83. package/src/config/{constants.ts → constants.d.ts} +13 -22
  84. package/src/config/constants.js +25 -0
  85. package/src/dev/host-runtime.d.ts +10 -0
  86. package/src/dev/host-runtime.js +24 -0
  87. package/src/dev/sc-server.d.ts +30 -0
  88. package/src/dev/sc-server.js +111 -0
  89. package/src/eco/eco.browser.d.ts +2 -0
  90. package/src/eco/eco.browser.js +83 -0
  91. package/src/eco/eco.d.ts +9 -0
  92. package/src/eco/eco.js +85 -0
  93. package/src/eco/eco.types.d.ts +178 -0
  94. package/src/eco/eco.types.js +0 -0
  95. package/src/eco/eco.utils.d.ts +1 -0
  96. package/src/eco/eco.utils.js +10 -0
  97. package/src/eco/global-injector-map.d.ts +16 -0
  98. package/src/eco/global-injector-map.js +80 -0
  99. package/src/eco/lazy-injector-map.d.ts +8 -0
  100. package/src/eco/lazy-injector-map.js +70 -0
  101. package/src/eco/module-dependencies.d.ts +18 -0
  102. package/src/eco/module-dependencies.js +49 -0
  103. package/src/errors/http-error.d.ts +31 -0
  104. package/src/errors/http-error.js +50 -0
  105. package/src/errors/index.d.ts +3 -0
  106. package/src/errors/index.js +6 -0
  107. package/src/errors/locals-access-error.d.ts +4 -0
  108. package/src/errors/locals-access-error.js +9 -0
  109. package/src/global/app-logger.d.ts +2 -0
  110. package/src/global/app-logger.js +6 -0
  111. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  112. package/src/hmr/client/hmr-runtime.js +117 -0
  113. package/src/hmr/hmr-strategy.d.ts +162 -0
  114. package/src/hmr/hmr-strategy.js +44 -0
  115. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  116. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  117. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  118. package/src/hmr/hmr.test.e2e.js +43 -0
  119. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  120. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  121. package/src/hmr/strategies/js-hmr-strategy.d.ts +134 -0
  122. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  123. package/src/index.browser.d.ts +3 -0
  124. package/src/index.browser.js +4 -0
  125. package/src/index.d.ts +6 -0
  126. package/src/index.js +21 -0
  127. package/src/integrations/ghtml/ghtml-renderer.d.ts +16 -0
  128. package/src/integrations/ghtml/ghtml-renderer.js +57 -0
  129. package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
  130. package/src/integrations/ghtml/ghtml.constants.js +4 -0
  131. package/src/integrations/ghtml/ghtml.plugin.d.ts +16 -0
  132. package/src/integrations/ghtml/ghtml.plugin.js +20 -0
  133. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  134. package/src/plugins/alias-resolver-plugin.js +53 -0
  135. package/src/plugins/eco-component-meta-plugin.d.ts +108 -0
  136. package/src/plugins/eco-component-meta-plugin.js +162 -0
  137. package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
  138. package/src/plugins/foreign-jsx-override-plugin.js +35 -0
  139. package/src/plugins/integration-plugin.d.ts +215 -0
  140. package/src/plugins/integration-plugin.js +189 -0
  141. package/src/plugins/processor.d.ts +97 -0
  142. package/src/plugins/processor.js +141 -0
  143. package/src/plugins/{runtime-capability.ts → runtime-capability.d.ts} +3 -8
  144. package/src/plugins/runtime-capability.js +0 -0
  145. package/src/plugins/source-transform.d.ts +46 -0
  146. package/src/plugins/source-transform.js +71 -0
  147. package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
  148. package/src/route-renderer/orchestration/component-render-context.js +147 -0
  149. package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
  150. package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
  151. package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
  152. package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
  153. package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
  154. package/src/route-renderer/orchestration/integration-renderer.js +909 -0
  155. package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
  156. package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
  157. package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
  158. package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
  159. package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
  160. package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
  161. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
  162. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
  163. package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
  164. package/src/route-renderer/orchestration/render-output.utils.js +171 -0
  165. package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
  166. package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
  167. package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
  168. package/src/route-renderer/orchestration/template-serialization.js +45 -0
  169. package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
  170. package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
  171. package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
  172. package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
  173. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  174. package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
  175. package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
  176. package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
  177. package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
  178. package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
  179. package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
  180. package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
  181. package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
  182. package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
  183. package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
  184. package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
  185. package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
  186. package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
  187. package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
  188. package/src/route-renderer/page-loading/page-module-loader.js +127 -0
  189. package/src/route-renderer/route-renderer.d.ts +69 -0
  190. package/src/route-renderer/route-renderer.js +80 -0
  191. package/src/router/client/link-intent.js +34 -0
  192. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  193. package/src/router/client/link-intent.test.browser.js +43 -0
  194. package/src/router/client/navigation-coordinator.d.ts +169 -0
  195. package/src/router/client/navigation-coordinator.js +215 -0
  196. package/src/router/server/route-registry.d.ts +78 -0
  197. package/src/router/server/route-registry.js +262 -0
  198. package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
  199. package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
  200. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
  201. package/src/services/assets/asset-processing-service/asset-processing.service.js +285 -0
  202. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  203. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  204. package/src/services/assets/asset-processing-service/assets.types.d.ts +103 -0
  205. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  206. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  207. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
  208. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  209. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  210. package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
  211. package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
  212. package/src/services/assets/asset-processing-service/index.d.ts +6 -0
  213. package/src/services/assets/asset-processing-service/index.js +6 -0
  214. package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
  215. package/src/services/assets/asset-processing-service/page-package.js +74 -0
  216. package/src/services/assets/asset-processing-service/{processor.interface.ts → processor.interface.d.ts} +5 -10
  217. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  218. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  219. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  220. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  221. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +65 -0
  222. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
  223. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
  224. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  225. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  226. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +6 -0
  227. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
  228. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +9 -0
  229. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +97 -0
  230. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  231. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +79 -0
  232. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +8 -0
  233. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
  234. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  235. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +69 -0
  236. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
  237. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
  238. package/src/services/assets/browser-bundle.service.d.ts +73 -0
  239. package/src/services/assets/browser-bundle.service.js +41 -0
  240. package/src/services/cache/cache.types.d.ts +107 -0
  241. package/src/services/cache/cache.types.js +0 -0
  242. package/src/services/cache/index.d.ts +7 -0
  243. package/src/services/cache/index.js +7 -0
  244. package/src/services/cache/memory-cache-store.d.ts +42 -0
  245. package/src/services/cache/memory-cache-store.js +98 -0
  246. package/src/services/cache/page-cache-service.d.ts +70 -0
  247. package/src/services/cache/page-cache-service.js +152 -0
  248. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  249. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  250. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  251. package/src/services/html/html-rewriter-provider.service.js +68 -0
  252. package/src/services/html/html-transformer.service.d.ts +87 -0
  253. package/src/services/html/html-transformer.service.js +216 -0
  254. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  255. package/src/services/invalidation/development-invalidation.service.js +190 -0
  256. package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
  257. package/src/services/module-loading/app-module-loader.service.js +0 -0
  258. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
  259. package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
  260. package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
  261. package/src/services/module-loading/host-module-loader-registry.js +15 -0
  262. package/src/services/module-loading/{module-loading-types.ts → module-loading-types.d.ts} +0 -1
  263. package/src/services/module-loading/module-loading-types.js +0 -0
  264. package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
  265. package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
  266. package/src/services/module-loading/page-module-import.service.d.ts +76 -0
  267. package/src/services/module-loading/page-module-import.service.js +170 -0
  268. package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
  269. package/src/services/module-loading/server-module-transpiler.service.js +64 -0
  270. package/src/services/module-loading/source-module-support.d.ts +5 -0
  271. package/src/services/module-loading/source-module-support.js +8 -0
  272. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  273. package/src/services/runtime-state/dev-graph.service.js +162 -0
  274. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  275. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  276. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  277. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  278. package/src/services/validation/schema-validation-service.d.ts +122 -0
  279. package/src/services/validation/schema-validation-service.js +101 -0
  280. package/src/services/validation/{standard-schema.types.ts → standard-schema.types.d.ts} +17 -20
  281. package/src/services/validation/standard-schema.types.js +0 -0
  282. package/src/static-site-generator/static-site-generator.d.ts +104 -0
  283. package/src/static-site-generator/static-site-generator.js +316 -0
  284. package/src/types/internal-types.d.ts +232 -0
  285. package/src/types/internal-types.js +0 -0
  286. package/src/types/public-types.d.ts +1267 -0
  287. package/src/types/public-types.js +0 -0
  288. package/src/utils/deep-merge.d.ts +14 -0
  289. package/src/utils/deep-merge.js +32 -0
  290. package/src/utils/hash.d.ts +1 -0
  291. package/src/utils/hash.js +7 -0
  292. package/src/utils/html-escaping.d.ts +7 -0
  293. package/src/utils/html-escaping.js +6 -0
  294. package/src/utils/html.js +4 -0
  295. package/src/utils/invariant.d.ts +5 -0
  296. package/src/utils/invariant.js +11 -0
  297. package/src/utils/locals-utils.d.ts +15 -0
  298. package/src/utils/locals-utils.js +24 -0
  299. package/src/utils/parse-cli-args.d.ts +27 -0
  300. package/src/utils/parse-cli-args.js +62 -0
  301. package/src/utils/path-utils.module.d.ts +5 -0
  302. package/src/utils/path-utils.module.js +14 -0
  303. package/src/utils/resolve-work-dir.d.ts +11 -0
  304. package/src/utils/resolve-work-dir.js +31 -0
  305. package/src/utils/runtime.d.ts +11 -0
  306. package/src/utils/runtime.js +40 -0
  307. package/src/utils/server-utils.module.d.ts +19 -0
  308. package/src/utils/server-utils.module.js +56 -0
  309. package/src/watchers/project-watcher.d.ts +136 -0
  310. package/src/watchers/project-watcher.js +275 -0
  311. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  312. package/src/watchers/project-watcher.test-helpers.js +52 -0
  313. package/src/adapters/abstract/application-adapter.test.ts +0 -172
  314. package/src/adapters/abstract/application-adapter.ts +0 -379
  315. package/src/adapters/abstract/router-adapter.ts +0 -30
  316. package/src/adapters/abstract/server-adapter.ts +0 -79
  317. package/src/adapters/bun/client-bridge.ts +0 -62
  318. package/src/adapters/bun/create-app.ts +0 -232
  319. package/src/adapters/bun/hmr-manager.test.ts +0 -265
  320. package/src/adapters/bun/hmr-manager.ts +0 -383
  321. package/src/adapters/bun/index.ts +0 -2
  322. package/src/adapters/bun/server-adapter.ts +0 -526
  323. package/src/adapters/bun/server-lifecycle.ts +0 -124
  324. package/src/adapters/create-app.test.ts +0 -10
  325. package/src/adapters/create-app.ts +0 -91
  326. package/src/adapters/index.ts +0 -2
  327. package/src/adapters/node/create-app.test.ts +0 -53
  328. package/src/adapters/node/create-app.ts +0 -183
  329. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  330. package/src/adapters/node/node-client-bridge.ts +0 -79
  331. package/src/adapters/node/node-hmr-manager.test.ts +0 -320
  332. package/src/adapters/node/node-hmr-manager.ts +0 -355
  333. package/src/adapters/node/server-adapter.ts +0 -502
  334. package/src/adapters/node/static-content-server.test.ts +0 -60
  335. package/src/adapters/node/static-content-server.ts +0 -239
  336. package/src/adapters/shared/api-response.test.ts +0 -97
  337. package/src/adapters/shared/api-response.ts +0 -104
  338. package/src/adapters/shared/application-adapter.ts +0 -199
  339. package/src/adapters/shared/define-api-handler.ts +0 -66
  340. package/src/adapters/shared/explicit-static-render-preparation.ts +0 -58
  341. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  342. package/src/adapters/shared/explicit-static-route-matcher.ts +0 -131
  343. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -85
  344. package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -118
  345. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -176
  346. package/src/adapters/shared/fs-server-response-factory.ts +0 -96
  347. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -311
  348. package/src/adapters/shared/fs-server-response-matcher.ts +0 -240
  349. package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
  350. package/src/adapters/shared/hmr-html-response.ts +0 -52
  351. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -228
  352. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  353. package/src/adapters/shared/render-context.test.ts +0 -150
  354. package/src/adapters/shared/render-context.ts +0 -123
  355. package/src/adapters/shared/runtime-bootstrap.ts +0 -79
  356. package/src/adapters/shared/server-adapter.test.ts +0 -130
  357. package/src/adapters/shared/server-adapter.ts +0 -562
  358. package/src/adapters/shared/server-route-handler.test.ts +0 -111
  359. package/src/adapters/shared/server-route-handler.ts +0 -153
  360. package/src/adapters/shared/server-static-builder.test.ts +0 -338
  361. package/src/adapters/shared/server-static-builder.ts +0 -170
  362. package/src/build/build-adapter-serialization.test.ts +0 -281
  363. package/src/build/build-adapter.test.ts +0 -1240
  364. package/src/build/build-adapter.ts +0 -1012
  365. package/src/build/build-manifest.ts +0 -54
  366. package/src/build/build-types.ts +0 -83
  367. package/src/build/dev-build-coordinator.ts +0 -220
  368. package/src/build/esbuild-build-adapter.ts +0 -660
  369. package/src/build/runtime-build-executor.test.ts +0 -81
  370. package/src/build/runtime-build-executor.ts +0 -40
  371. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -67
  372. package/src/build/runtime-specifier-alias-plugin.ts +0 -62
  373. package/src/build/runtime-specifier-aliases.ts +0 -135
  374. package/src/config/config-builder.test.ts +0 -442
  375. package/src/config/config-builder.ts +0 -737
  376. package/src/config/config-builder.typecheck.test.ts +0 -96
  377. package/src/dev/host-runtime.ts +0 -34
  378. package/src/dev/sc-server.ts +0 -143
  379. package/src/eco/eco.browser.test.ts +0 -43
  380. package/src/eco/eco.browser.ts +0 -118
  381. package/src/eco/eco.test.ts +0 -654
  382. package/src/eco/eco.ts +0 -205
  383. package/src/eco/eco.types.ts +0 -221
  384. package/src/eco/eco.utils.test.ts +0 -219
  385. package/src/eco/eco.utils.ts +0 -5
  386. package/src/eco/global-injector-map.test.ts +0 -42
  387. package/src/eco/global-injector-map.ts +0 -112
  388. package/src/eco/lazy-injector-map.test.ts +0 -66
  389. package/src/eco/lazy-injector-map.ts +0 -120
  390. package/src/eco/module-dependencies.test.ts +0 -30
  391. package/src/eco/module-dependencies.ts +0 -75
  392. package/src/errors/http-error.test.ts +0 -134
  393. package/src/errors/http-error.ts +0 -72
  394. package/src/errors/index.ts +0 -3
  395. package/src/errors/locals-access-error.ts +0 -7
  396. package/src/global/app-logger.ts +0 -4
  397. package/src/global/utils.test.ts +0 -12
  398. 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
  399. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  400. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  401. package/src/hmr/client/hmr-runtime.ts +0 -162
  402. package/src/hmr/hmr-strategy.test.ts +0 -124
  403. package/src/hmr/hmr-strategy.ts +0 -177
  404. package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
  405. package/src/hmr/hmr.test.e2e.ts +0 -66
  406. package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
  407. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -334
  408. package/src/hmr/strategies/js-hmr-strategy.ts +0 -314
  409. package/src/index.browser.ts +0 -3
  410. package/src/index.ts +0 -15
  411. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -253
  412. package/src/integrations/ghtml/ghtml-renderer.ts +0 -87
  413. package/src/integrations/ghtml/ghtml.constants.ts +0 -1
  414. package/src/integrations/ghtml/ghtml.plugin.ts +0 -28
  415. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  416. package/src/plugins/alias-resolver-plugin.ts +0 -63
  417. package/src/plugins/eco-component-meta-plugin.test.ts +0 -406
  418. package/src/plugins/eco-component-meta-plugin.ts +0 -494
  419. package/src/plugins/foreign-jsx-override-plugin.test.ts +0 -65
  420. package/src/plugins/foreign-jsx-override-plugin.ts +0 -67
  421. package/src/plugins/integration-plugin.test.ts +0 -151
  422. package/src/plugins/integration-plugin.ts +0 -323
  423. package/src/plugins/processor.test.ts +0 -148
  424. package/src/plugins/processor.ts +0 -257
  425. package/src/plugins/source-transform.test.ts +0 -82
  426. package/src/plugins/source-transform.ts +0 -123
  427. package/src/route-renderer/orchestration/component-render-context.ts +0 -325
  428. package/src/route-renderer/orchestration/declared-ownership-graph.ts +0 -62
  429. package/src/route-renderer/orchestration/foreign-subtree-execution.service.ts +0 -383
  430. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -2085
  431. package/src/route-renderer/orchestration/integration-renderer.ts +0 -1244
  432. package/src/route-renderer/orchestration/ownership-planning.service.ts +0 -97
  433. package/src/route-renderer/orchestration/ownership-validation.service.ts +0 -76
  434. package/src/route-renderer/orchestration/processed-asset-dedupe.ts +0 -25
  435. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.test.ts +0 -324
  436. package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.ts +0 -294
  437. package/src/route-renderer/orchestration/render-output.utils.ts +0 -310
  438. package/src/route-renderer/orchestration/route-render-orchestrator.prepare-render-options.test.ts +0 -644
  439. package/src/route-renderer/orchestration/route-render-orchestrator.test.ts +0 -265
  440. package/src/route-renderer/orchestration/route-render-orchestrator.ts +0 -592
  441. package/src/route-renderer/orchestration/template-serialization.test.ts +0 -110
  442. package/src/route-renderer/orchestration/template-serialization.ts +0 -117
  443. package/src/route-renderer/page-loading/component-dependency-collection.ts +0 -202
  444. package/src/route-renderer/page-loading/declared-asset-collection.ts +0 -153
  445. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -761
  446. package/src/route-renderer/page-loading/dependency-resolver.ts +0 -144
  447. package/src/route-renderer/page-loading/ecopages-virtual-imports.ts +0 -75
  448. package/src/route-renderer/page-loading/lazy-entry-collection.ts +0 -167
  449. package/src/route-renderer/page-loading/lazy-trigger-planning.ts +0 -74
  450. package/src/route-renderer/page-loading/module-declaration-aggregation.ts +0 -60
  451. package/src/route-renderer/page-loading/module-declaration-scripts.ts +0 -16
  452. package/src/route-renderer/page-loading/page-dependency-bundling.ts +0 -244
  453. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -183
  454. package/src/route-renderer/page-loading/page-module-loader.ts +0 -184
  455. package/src/route-renderer/route-renderer.ts +0 -133
  456. package/src/router/client/link-intent.test.browser.ts +0 -51
  457. package/src/router/client/link-intent.ts +0 -92
  458. package/src/router/client/navigation-coordinator.test.ts +0 -237
  459. package/src/router/client/navigation-coordinator.ts +0 -453
  460. package/src/router/server/route-registry.test.ts +0 -176
  461. package/src/router/server/route-registry.ts +0 -382
  462. package/src/services/assets/asset-processing-service/asset-dependency-keys.ts +0 -66
  463. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -473
  464. package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -344
  465. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  466. package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
  467. package/src/services/assets/asset-processing-service/assets.types.ts +0 -128
  468. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -74
  469. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -96
  470. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  471. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
  472. package/src/services/assets/asset-processing-service/grouped-content-bundles.ts +0 -104
  473. package/src/services/assets/asset-processing-service/index.ts +0 -6
  474. package/src/services/assets/asset-processing-service/page-package.test.ts +0 -100
  475. package/src/services/assets/asset-processing-service/page-package.ts +0 -93
  476. package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
  477. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  478. package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -83
  479. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -173
  480. package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
  481. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.test.ts +0 -195
  482. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -137
  483. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -326
  484. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -116
  485. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  486. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -89
  487. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -261
  488. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -72
  489. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -83
  490. package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.ts +0 -65
  491. package/src/services/assets/browser-bundle.service.test.ts +0 -66
  492. package/src/services/assets/browser-bundle.service.ts +0 -109
  493. package/src/services/cache/cache.types.ts +0 -126
  494. package/src/services/cache/index.ts +0 -18
  495. package/src/services/cache/memory-cache-store.test.ts +0 -225
  496. package/src/services/cache/memory-cache-store.ts +0 -130
  497. package/src/services/cache/page-cache-service.test.ts +0 -175
  498. package/src/services/cache/page-cache-service.ts +0 -202
  499. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  500. package/src/services/cache/page-request-cache-coordinator.service.ts +0 -131
  501. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  502. package/src/services/html/html-rewriter-provider.service.ts +0 -104
  503. package/src/services/html/html-transformer.service.test.ts +0 -476
  504. package/src/services/html/html-transformer.service.ts +0 -275
  505. package/src/services/invalidation/development-invalidation.service.test.ts +0 -87
  506. package/src/services/invalidation/development-invalidation.service.ts +0 -262
  507. package/src/services/module-loading/app-module-loader.service.ts +0 -9
  508. package/src/services/module-loading/app-server-module-transpiler.service.test.ts +0 -130
  509. package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -141
  510. package/src/services/module-loading/host-module-loader-registry.ts +0 -15
  511. package/src/services/module-loading/node-bootstrap-plugin.test.ts +0 -335
  512. package/src/services/module-loading/node-bootstrap-plugin.ts +0 -311
  513. package/src/services/module-loading/page-module-import.service.test.ts +0 -504
  514. package/src/services/module-loading/page-module-import.service.ts +0 -251
  515. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -243
  516. package/src/services/module-loading/server-module-transpiler.service.ts +0 -104
  517. package/src/services/module-loading/source-module-support.ts +0 -19
  518. package/src/services/runtime-state/dev-graph.service.ts +0 -217
  519. package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
  520. package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
  521. package/src/services/validation/schema-validation-service.test.ts +0 -223
  522. package/src/services/validation/schema-validation-service.ts +0 -204
  523. package/src/static-site-generator/static-site-generator.test.ts +0 -408
  524. package/src/static-site-generator/static-site-generator.ts +0 -445
  525. package/src/types/internal-types.ts +0 -243
  526. package/src/types/public-types.ts +0 -1459
  527. package/src/utils/deep-merge.test.ts +0 -114
  528. package/src/utils/deep-merge.ts +0 -47
  529. package/src/utils/hash.ts +0 -5
  530. package/src/utils/html-escaping.ts +0 -9
  531. package/src/utils/invariant.test.ts +0 -22
  532. package/src/utils/invariant.ts +0 -15
  533. package/src/utils/locals-utils.ts +0 -37
  534. package/src/utils/parse-cli-args.test.ts +0 -69
  535. package/src/utils/parse-cli-args.ts +0 -105
  536. package/src/utils/path-utils.module.ts +0 -14
  537. package/src/utils/path-utils.test.ts +0 -15
  538. package/src/utils/resolve-work-dir.ts +0 -45
  539. package/src/utils/runtime.ts +0 -44
  540. package/src/utils/server-utils.module.ts +0 -67
  541. package/src/utils/server-utils.test.ts +0 -38
  542. package/src/watchers/project-watcher.integration.test.ts +0 -337
  543. package/src/watchers/project-watcher.test-helpers.ts +0 -42
  544. package/src/watchers/project-watcher.test.ts +0 -768
  545. package/src/watchers/project-watcher.ts +0 -357
  546. /package/src/utils/{html.ts → html.d.ts} +0 -0
@@ -1,118 +0,0 @@
1
- import { createRequire } from '../../utils/locals-utils.ts';
2
- import type { FileRouteMiddleware, FileRouteMiddlewareContext, RequestLocals } from '../../types/public-types.ts';
3
- import type { PageCacheService } from '../../services/cache/page-cache-service.ts';
4
- import { ApiResponseBuilder } from './api-response.ts';
5
- import { LocalsAccessError } from '../../errors/locals-access-error.ts';
6
-
7
- export const FILE_ROUTE_MIDDLEWARE_PIPELINE_ERRORS = {
8
- middlewareRequiresDynamic: (filePath: string) =>
9
- `[ecopages] Page middleware requires cache: 'dynamic'. Page: ${filePath}`,
10
- } as const;
11
-
12
- /**
13
- * Executes middleware for file-based page routes.
14
- *
15
- * This pipeline owns the middleware-specific rules that are distinct from route
16
- * matching and rendering, including request-local storage, the middleware
17
- * execution context, and the invariant that page middleware only runs for
18
- * request-time dynamic rendering.
19
- */
20
- export class FileRouteMiddlewarePipeline {
21
- private cacheService: PageCacheService | null;
22
-
23
- constructor(cacheService: PageCacheService | null) {
24
- this.cacheService = cacheService;
25
- }
26
-
27
- /**
28
- * Enforces the current middleware contract for file-routed pages.
29
- *
30
- * Middleware depends on request-scoped locals and therefore must not run when
31
- * the page is treated as statically cacheable.
32
- *
33
- * @param input Middleware list, effective cache strategy, and page path.
34
- * @throws LocalsAccessError When middleware is configured for a non-dynamic page.
35
- */
36
- assertValidConfiguration(input: {
37
- middleware: FileRouteMiddleware[];
38
- pageCacheStrategy: 'static' | 'dynamic' | { revalidate: number; tags?: string[] };
39
- filePath: string;
40
- }): void {
41
- if (input.middleware.length > 0 && input.pageCacheStrategy !== 'dynamic') {
42
- throw new LocalsAccessError(
43
- FILE_ROUTE_MIDDLEWARE_PIPELINE_ERRORS.middlewareRequiresDynamic(input.filePath),
44
- );
45
- }
46
- }
47
-
48
- /**
49
- * Creates the request-scoped middleware context used by page middleware.
50
- *
51
- * The context intentionally omits `render()` and `renderPartial()` because
52
- * rendering is owned by the page route pipeline, not by middleware stages.
53
- *
54
- * @param input Request details and the mutable locals store.
55
- * @returns Middleware execution context.
56
- */
57
- createContext(input: {
58
- request: Request;
59
- params: Record<string, string>;
60
- locals: RequestLocals;
61
- }): FileRouteMiddlewareContext {
62
- const context: FileRouteMiddlewareContext = {
63
- request: input.request,
64
- params: input.params,
65
- response: new ApiResponseBuilder(),
66
- server: null,
67
- services: {
68
- cache: this.cacheService,
69
- },
70
- locals: input.locals,
71
- require: createRequire(() => context.locals as unknown as Record<string, unknown>),
72
- json: (data, options) => {
73
- const builder = new ApiResponseBuilder();
74
- if (options?.status) builder.status(options.status);
75
- if (options?.headers) builder.headers(options.headers);
76
- return builder.json(data);
77
- },
78
- html: (content, options) => {
79
- const builder = new ApiResponseBuilder();
80
- if (options?.status) builder.status(options.status);
81
- if (options?.headers) builder.headers(options.headers);
82
- return builder.html(content);
83
- },
84
- };
85
-
86
- return context;
87
- }
88
-
89
- /**
90
- * Runs the middleware chain and eventually delegates to the render callback.
91
- *
92
- * Middleware may short-circuit by returning a response directly. If the chain
93
- * completes, the supplied `renderResponse` callback is executed exactly once.
94
- *
95
- * @param input Middleware context, chain, and terminal render callback.
96
- * @returns Response from middleware or final render stage.
97
- */
98
- async run(input: {
99
- middleware: FileRouteMiddleware[];
100
- context: FileRouteMiddlewareContext;
101
- renderResponse: () => Promise<Response>;
102
- }): Promise<Response> {
103
- if (input.middleware.length === 0) {
104
- return input.renderResponse();
105
- }
106
-
107
- let index = 0;
108
- const executeNext = async (): Promise<Response> => {
109
- if (index < input.middleware.length) {
110
- const current = input.middleware[index++];
111
- return current(input.context, executeNext);
112
- }
113
- return input.renderResponse();
114
- };
115
-
116
- return executeNext();
117
- }
118
- }
@@ -1,176 +0,0 @@
1
- import { beforeAll, describe, expect, it, vi } from 'vitest';
2
- import { fileSystem } from '@ecopages/file-system';
3
- import {
4
- FIXTURE_APP_PROJECT_DIR,
5
- FIXTURE_EXISTING_CSS_FILE_IN_DIST,
6
- FIXTURE_EXISTING_SVG_FILE_IN_DIST_PATH,
7
- } from '../../../__fixtures__/constants.js';
8
- import { appLogger } from '../../global/app-logger.ts';
9
- import { ConfigBuilder } from '../../config/config-builder.ts';
10
- import { STATUS_MESSAGE } from '../../config/constants.ts';
11
- import { FileSystemServerResponseFactory } from './fs-server-response-factory.ts';
12
-
13
- let appConfig: Awaited<ReturnType<ConfigBuilder['build']>>;
14
- let responseFactory: FileSystemServerResponseFactory;
15
-
16
- describe('FileSystemServerResponseFactory', () => {
17
- beforeAll(async () => {
18
- appConfig = await new ConfigBuilder().setRootDir(FIXTURE_APP_PROJECT_DIR).build();
19
-
20
- for (const integration of appConfig.integrations) {
21
- integration.setConfig(appConfig);
22
- integration.setRuntimeOrigin(appConfig.baseUrl);
23
- }
24
-
25
- responseFactory = new FileSystemServerResponseFactory({
26
- options: {
27
- watchMode: false,
28
- },
29
- });
30
- });
31
-
32
- describe('isHtml', () => {
33
- it('should return true for text/html content type', () => {
34
- const result = responseFactory.isHtml('text/html');
35
- expect(result).toBe(true);
36
- });
37
-
38
- it('should return false for text/plain content type', () => {
39
- const result = responseFactory.isHtml('text/plain');
40
- expect(result).toBe(false);
41
- });
42
-
43
- it('should return false for other content types', () => {
44
- const result = responseFactory.isHtml('application/json');
45
- expect(result).toBe(false);
46
- });
47
- });
48
-
49
- describe('shouldEnableGzip', () => {
50
- it('should return false in watch mode', () => {
51
- const responseFactoryWatch = new FileSystemServerResponseFactory({
52
- options: {
53
- watchMode: true,
54
- },
55
- });
56
-
57
- const result = responseFactoryWatch.shouldEnableGzip('text/javascript');
58
- expect(result).toBe(false);
59
- });
60
-
61
- it('should return true for text/javascript content type', () => {
62
- const result = responseFactory.shouldEnableGzip('text/javascript');
63
- expect(result).toBe(true);
64
- });
65
-
66
- it('should return true for text/css content type', () => {
67
- const result = responseFactory.shouldEnableGzip('text/css');
68
- expect(result).toBe(true);
69
- });
70
-
71
- it('should return false for other content types', () => {
72
- const result = responseFactory.shouldEnableGzip('application/json');
73
- expect(result).toBe(false);
74
- });
75
- });
76
-
77
- describe('createResponseWithBody', () => {
78
- it('should create a response with the given route renderer body', async () => {
79
- const routeRendererBody = '<html><body>Test</body></html>';
80
- const response = await responseFactory.createResponseWithBody(routeRendererBody);
81
- const body = await response.text();
82
- expect(body).toBe(routeRendererBody);
83
- expect(response.headers.get('Content-Type')).toBe('text/html');
84
- });
85
- });
86
-
87
- describe('createDefaultNotFoundResponse', () => {
88
- it('should create a response with status 404 and body "file not found"', async () => {
89
- const response = await responseFactory.createDefaultNotFoundResponse();
90
- expect(response.status).toBe(404);
91
- expect(await response.text()).toBe(STATUS_MESSAGE[404]);
92
- });
93
- });
94
-
95
- describe('createHtmlNotFoundResponse', () => {
96
- it('should create an html 404 response from a rendered body', async () => {
97
- const response = await responseFactory.createHtmlNotFoundResponse('<h1>404 - Page Not Found</h1>');
98
- const body = await response.text();
99
- expect(body).toContain('<h1>404 - Page Not Found</h1>');
100
- expect(response.headers.get('Content-Type')).toBe('text/html');
101
- expect(response.status).toBe(404);
102
- });
103
- });
104
-
105
- describe('createFileResponse', () => {
106
- it('should create a response with the file content and content type', async () => {
107
- const readFileAsBufferSpy = vi
108
- .spyOn(fileSystem, 'readFileAsBuffer')
109
- .mockReturnValue(Buffer.from('<svg></svg>'));
110
-
111
- const response = await responseFactory.createFileResponse(
112
- FIXTURE_EXISTING_SVG_FILE_IN_DIST_PATH,
113
- 'image/svg+xml',
114
- );
115
- readFileAsBufferSpy.mockRestore();
116
- if (!response) {
117
- throw new Error('Expected static file response');
118
- }
119
- expect(response.headers.get('Content-Type')).toBe('image/svg+xml');
120
- });
121
-
122
- it('should return null if the file does not exist', async () => {
123
- const response = await responseFactory.createFileResponse('/path/to/nonexistent.txt', 'text/plain');
124
- expect(response).toBeNull();
125
- });
126
-
127
- it('should log debug for ENOENT errors', async () => {
128
- const debugSpy = vi.spyOn(appLogger, 'debug');
129
- const errorSpy = vi.spyOn(appLogger, 'error');
130
-
131
- await responseFactory.createFileResponse('/path/to/nonexistent-debug.txt', 'text/plain');
132
-
133
- expect(debugSpy).toHaveBeenCalled();
134
- expect(errorSpy).not.toHaveBeenCalled();
135
-
136
- debugSpy.mockRestore();
137
- errorSpy.mockRestore();
138
- });
139
-
140
- it('should serve gzip file with Content-Encoding header when gzip is enabled', async () => {
141
- const cssFilePath = `${appConfig.absolutePaths.distDir}/${FIXTURE_EXISTING_CSS_FILE_IN_DIST}`;
142
- const existsSpy = vi
143
- .spyOn(fileSystem, 'exists')
144
- .mockImplementation((filePath) => filePath === `${cssFilePath}.gz`);
145
- const readFileAsBufferSpy = vi
146
- .spyOn(fileSystem, 'readFileAsBuffer')
147
- .mockReturnValue(Buffer.from('body{color:red}'));
148
- const response = await responseFactory.createFileResponse(cssFilePath, 'text/css');
149
- existsSpy.mockRestore();
150
- readFileAsBufferSpy.mockRestore();
151
-
152
- if (!response) {
153
- throw new Error('Expected gzip file response');
154
- }
155
- expect(response.headers.get('Content-Type')).toBe('text/css');
156
- expect(response.headers.get('Content-Encoding')).toBe('gzip');
157
- });
158
-
159
- it('should not set Content-Encoding header for non-gzip content types', async () => {
160
- const readFileAsBufferSpy = vi
161
- .spyOn(fileSystem, 'readFileAsBuffer')
162
- .mockReturnValue(Buffer.from('<svg></svg>'));
163
- const response = await responseFactory.createFileResponse(
164
- FIXTURE_EXISTING_SVG_FILE_IN_DIST_PATH,
165
- 'image/svg+xml',
166
- );
167
- readFileAsBufferSpy.mockRestore();
168
-
169
- if (!response) {
170
- throw new Error('Expected non-gzip file response');
171
- }
172
- expect(response.headers.get('Content-Type')).toBe('image/svg+xml');
173
- expect(response.headers.get('Content-Encoding')).toBeNull();
174
- });
175
- });
176
- });
@@ -1,96 +0,0 @@
1
- import { STATUS_MESSAGE } from '../../config/constants.ts';
2
- import { appLogger } from '../../global/app-logger.ts';
3
- import type { FileSystemServerOptions } from '../../types/internal-types.ts';
4
- import type { RouteRendererBody } from '../../types/public-types.ts';
5
- import { fileSystem } from '@ecopages/file-system';
6
-
7
- /**
8
- * Builds HTTP responses for static files and shared file-system fallbacks.
9
- */
10
- export class FileSystemServerResponseFactory {
11
- private options: FileSystemServerOptions;
12
-
13
- constructor({ options }: { options: FileSystemServerOptions }) {
14
- this.options = options;
15
- }
16
-
17
- isHtml(contentType: string) {
18
- return contentType === 'text/html';
19
- }
20
-
21
- shouldEnableGzip(contentType: string) {
22
- if (this.options.watchMode) return false;
23
- const gzipEnabledExtensions = ['text/javascript', 'text/css'];
24
- return gzipEnabledExtensions.includes(contentType);
25
- }
26
-
27
- async createResponseWithBody(
28
- body: RouteRendererBody,
29
- init: ResponseInit = {
30
- headers: {
31
- 'Content-Type': 'text/html',
32
- },
33
- },
34
- ) {
35
- return new Response(body as BodyInit, init);
36
- }
37
-
38
- async createDefaultNotFoundResponse() {
39
- return new Response(STATUS_MESSAGE[404], {
40
- status: 404,
41
- });
42
- }
43
-
44
- /**
45
- * Wraps already-rendered HTML in a 404 response envelope.
46
- */
47
- async createHtmlNotFoundResponse(body: RouteRendererBody) {
48
- return await this.createResponseWithBody(body, {
49
- status: 404,
50
- statusText: STATUS_MESSAGE[404],
51
- headers: {
52
- 'Content-Type': 'text/html',
53
- },
54
- });
55
- }
56
-
57
- /**
58
- * Reads a static file response, returning `null` when the file is missing.
59
- */
60
- async createFileResponse(filePath: string, contentType: string): Promise<Response | null> {
61
- try {
62
- let file: Buffer;
63
- const contentEncodingHeader: HeadersInit = {};
64
-
65
- if (this.shouldEnableGzip(contentType)) {
66
- const gzipPath = `${filePath}.gz`;
67
- if (fileSystem.exists(gzipPath)) {
68
- file = fileSystem.readFileAsBuffer(gzipPath);
69
- contentEncodingHeader['Content-Encoding'] = 'gzip';
70
- contentEncodingHeader['Vary'] = 'Accept-Encoding';
71
- } else {
72
- appLogger.debug('Gzip file not found, serving uncompressed', gzipPath);
73
- file = fileSystem.readFileAsBuffer(filePath);
74
- }
75
- } else {
76
- file = fileSystem.readFileAsBuffer(filePath);
77
- }
78
-
79
- return await this.createResponseWithBody(file as unknown as BodyInit, {
80
- headers: {
81
- 'Content-Type': contentType,
82
- ...contentEncodingHeader,
83
- },
84
- });
85
- } catch (error) {
86
- const err = error as Error & { code?: string; cause?: { code?: string } };
87
- const code = err.code || err.cause?.code;
88
- if (code === 'ENOENT') {
89
- appLogger.debug('File not found', filePath);
90
- } else {
91
- appLogger.error('Error reading file', filePath, err);
92
- }
93
- return null;
94
- }
95
- }
96
- }
@@ -1,311 +0,0 @@
1
- import { describe, expect, it, vi } from 'vitest';
2
- import { fileSystem } from '@ecopages/file-system';
3
- import path from 'node:path';
4
- import { APP_TEST_ROUTES, FIXTURE_APP_PROJECT_DIR, INDEX_TEMPLATE_FILE } from '../../../__fixtures__/constants.ts';
5
- import { ConfigBuilder } from '../../config/config-builder.ts';
6
- import type { MatchResult } from '../../types/internal-types.ts';
7
- import { RouteRendererFactory } from '../../route-renderer/route-renderer.ts';
8
- import { RouteRegistry } from '../../router/server/route-registry.ts';
9
- import { MemoryCacheStore } from '../../services/cache/memory-cache-store.ts';
10
- import { PageCacheService } from '../../services/cache/page-cache-service.ts';
11
- import { FileSystemServerResponseFactory } from './fs-server-response-factory.ts';
12
- import { FileSystemResponseMatcher } from './fs-server-response-matcher.ts';
13
-
14
- const appConfig = await new ConfigBuilder().setRootDir(FIXTURE_APP_PROJECT_DIR).build();
15
-
16
- for (const integration of appConfig.integrations) {
17
- integration.setConfig(appConfig);
18
- integration.setRuntimeOrigin(appConfig.baseUrl);
19
- }
20
-
21
- const router = new RouteRegistry({
22
- pagesDir: path.join(appConfig.rootDir, appConfig.srcDir, appConfig.pagesDir),
23
- appConfig,
24
- origin: appConfig.baseUrl,
25
- templatesExt: appConfig.templatesExt,
26
- buildMode: false,
27
- pageModuleAdapter: {
28
- loadPageModule: vi.fn(async () => ({})),
29
- },
30
- });
31
-
32
- await router.init();
33
-
34
- const routeRendererFactory = new RouteRendererFactory({
35
- appConfig,
36
- runtimeOrigin: appConfig.baseUrl,
37
- });
38
-
39
- const fileSystemResponseFactory = new FileSystemServerResponseFactory({
40
- options: {
41
- watchMode: false,
42
- },
43
- });
44
-
45
- describe('FileSystemResponseMatcher', () => {
46
- describe('without cache service', () => {
47
- const matcherWithoutCache = new FileSystemResponseMatcher({
48
- appConfig,
49
- assetPrefix: path.join(appConfig.rootDir, appConfig.distDir),
50
- router,
51
- routeRendererFactory,
52
- fileSystemResponseFactory,
53
- });
54
-
55
- it('should return custom 404 page for unmatched request URL', async () => {
56
- const requestUrl = APP_TEST_ROUTES.nonExistentFile;
57
- const response = await matcherWithoutCache.handleNoMatch(requestUrl);
58
- const body = await response.text();
59
- expect(body).toContain('<h1>404 - Page Not Found</h1>');
60
- });
61
-
62
- it('should handle match with disabled cache headers', async () => {
63
- const match: MatchResult = {
64
- requestedPathname: APP_TEST_ROUTES.index,
65
- templateRoute: {
66
- kind: 'exact',
67
- pathname: APP_TEST_ROUTES.index,
68
- filePath: INDEX_TEMPLATE_FILE,
69
- },
70
- params: {},
71
- query: {},
72
- };
73
- const response = await matcherWithoutCache.handleMatch(match);
74
- expect(response.headers.get('Content-Type')).toBe('text/html');
75
- expect(response.headers.get('X-Cache')).toBe('DISABLED');
76
- expect(response.headers.get('Cache-Control')).toBe('no-store, must-revalidate');
77
- });
78
-
79
- it('should return null for getCacheService when not configured', () => {
80
- expect(matcherWithoutCache.getCacheService()).toBeNull();
81
- });
82
- });
83
-
84
- describe('with cache service', () => {
85
- const cacheService = new PageCacheService({
86
- store: new MemoryCacheStore(),
87
- enabled: true,
88
- });
89
-
90
- const matcherWithCache = new FileSystemResponseMatcher({
91
- appConfig,
92
- assetPrefix: path.join(appConfig.rootDir, appConfig.distDir),
93
- router,
94
- routeRendererFactory,
95
- fileSystemResponseFactory,
96
- cacheService,
97
- defaultCacheStrategy: 'static',
98
- });
99
-
100
- it('should return cache service via getCacheService', () => {
101
- expect(matcherWithCache.getCacheService()).toBe(cacheService);
102
- });
103
-
104
- it('should return X-Cache header on first request (MISS)', async () => {
105
- const match: MatchResult = {
106
- requestedPathname: '/cache-test-miss',
107
- templateRoute: {
108
- kind: 'exact',
109
- pathname: '/cache-test-miss',
110
- filePath: INDEX_TEMPLATE_FILE,
111
- },
112
- params: {},
113
- query: {},
114
- };
115
- const response = await matcherWithCache.handleMatch(match);
116
- expect(response.headers.get('X-Cache')).toBe('MISS');
117
- expect(response.headers.get('Cache-Control')).toBe('public, max-age=31536000, immutable');
118
- });
119
-
120
- it('should return X-Cache HIT on second request to same path', async () => {
121
- const uniquePath = `/cache-test-hit-${Date.now()}`;
122
- const match: MatchResult = {
123
- requestedPathname: uniquePath,
124
- templateRoute: {
125
- kind: 'exact',
126
- pathname: uniquePath,
127
- filePath: INDEX_TEMPLATE_FILE,
128
- },
129
- params: {},
130
- query: {},
131
- };
132
-
133
- const response1 = await matcherWithCache.handleMatch(match);
134
- const response2 = await matcherWithCache.handleMatch(match);
135
-
136
- expect(response1.headers.get('X-Cache')).toBe('MISS');
137
- expect(response2.headers.get('X-Cache')).toBe('HIT');
138
- });
139
-
140
- it('should cache different paths separately', async () => {
141
- const match1: MatchResult = {
142
- requestedPathname: '/path-a',
143
- templateRoute: {
144
- kind: 'exact',
145
- pathname: '/path-a',
146
- filePath: INDEX_TEMPLATE_FILE,
147
- },
148
- params: {},
149
- query: {},
150
- };
151
- const match2: MatchResult = {
152
- requestedPathname: '/path-b',
153
- templateRoute: {
154
- kind: 'exact',
155
- pathname: '/path-b',
156
- filePath: INDEX_TEMPLATE_FILE,
157
- },
158
- params: {},
159
- query: {},
160
- };
161
-
162
- const response1 = await matcherWithCache.handleMatch(match1);
163
- const response2 = await matcherWithCache.handleMatch(match2);
164
-
165
- expect(response1.headers.get('X-Cache')).toBe('MISS');
166
- expect(response2.headers.get('X-Cache')).toBe('MISS');
167
- });
168
-
169
- it('should include query params in cache key', async () => {
170
- const basePath = `/search-${Date.now()}`;
171
- const matchWithQuery: MatchResult = {
172
- requestedPathname: basePath,
173
- templateRoute: {
174
- kind: 'exact',
175
- pathname: basePath,
176
- filePath: INDEX_TEMPLATE_FILE,
177
- },
178
- params: {},
179
- query: { q: 'test' },
180
- };
181
- const matchWithDifferentQuery: MatchResult = {
182
- requestedPathname: basePath,
183
- templateRoute: {
184
- kind: 'exact',
185
- pathname: basePath,
186
- filePath: INDEX_TEMPLATE_FILE,
187
- },
188
- params: {},
189
- query: { q: 'other' },
190
- };
191
-
192
- const firstCall = await matcherWithCache.handleMatch(matchWithQuery);
193
- const response1 = await matcherWithCache.handleMatch(matchWithQuery);
194
- const response2 = await matcherWithCache.handleMatch(matchWithDifferentQuery);
195
-
196
- expect(firstCall.headers.get('X-Cache')).toBe('MISS');
197
- expect(response1.headers.get('X-Cache')).toBe('HIT');
198
- expect(response2.headers.get('X-Cache')).toBe('MISS');
199
- });
200
- });
201
-
202
- describe('with dynamic cache strategy', () => {
203
- const cacheService = new PageCacheService({
204
- store: new MemoryCacheStore(),
205
- enabled: true,
206
- });
207
-
208
- const dynamicMatcher = new FileSystemResponseMatcher({
209
- appConfig,
210
- assetPrefix: path.join(appConfig.rootDir, appConfig.distDir),
211
- router,
212
- routeRendererFactory,
213
- fileSystemResponseFactory,
214
- cacheService,
215
- defaultCacheStrategy: 'dynamic',
216
- });
217
-
218
- it('should bypass cache entirely for dynamic strategy', async () => {
219
- const match: MatchResult = {
220
- requestedPathname: '/dynamic-page',
221
- templateRoute: {
222
- kind: 'exact',
223
- pathname: '/dynamic-page',
224
- filePath: INDEX_TEMPLATE_FILE,
225
- },
226
- params: {},
227
- query: {},
228
- };
229
-
230
- const response1 = await dynamicMatcher.handleMatch(match);
231
- const response2 = await dynamicMatcher.handleMatch(match);
232
-
233
- expect(response1.headers.get('X-Cache')).toBe('DISABLED');
234
- expect(response2.headers.get('X-Cache')).toBe('DISABLED');
235
- expect(response1.headers.get('Cache-Control')).toBe('no-store, must-revalidate');
236
- });
237
- });
238
-
239
- describe('handleNoMatch content type behavior', () => {
240
- const matcher = new FileSystemResponseMatcher({
241
- appConfig,
242
- assetPrefix: path.join(appConfig.rootDir, appConfig.distDir),
243
- router,
244
- routeRendererFactory,
245
- fileSystemResponseFactory,
246
- });
247
-
248
- it('should return custom 404 page for known extension like .html', async () => {
249
- const response = await matcher.handleNoMatch('/non-existent-page.html');
250
- const body = await response.text();
251
- expect(body).toContain('<h1>404 - Page Not Found</h1>');
252
- });
253
-
254
- it('should return custom 404 page for page requests without extension', async () => {
255
- const response = await matcher.handleNoMatch('/non-existent-page');
256
- const body = await response.text();
257
- expect(body).toContain('<h1>404 - Page Not Found</h1>');
258
- });
259
-
260
- it('should return custom 404 page for unknown extensions', async () => {
261
- const response = await matcher.handleNoMatch('/page.xyz');
262
- const body = await response.text();
263
- expect(body).toContain('<h1>404 - Page Not Found</h1>');
264
- });
265
-
266
- it('should return custom 404 page for trailing dot', async () => {
267
- const response = await matcher.handleNoMatch('/page.');
268
- const body = await response.text();
269
- expect(body).toContain('<h1>404 - Page Not Found</h1>');
270
- });
271
-
272
- it('should serve text/plain files from disk', async () => {
273
- const readFileAsBuffer = vi.spyOn(fileSystem, 'readFileAsBuffer').mockReturnValue(Buffer.from('robots'));
274
- const response = await matcher.handleNoMatch('/robots.txt');
275
- readFileAsBuffer.mockRestore();
276
- expect(response.headers.get('Content-Type')).toBe('text/plain');
277
- });
278
-
279
- it('should return custom 404 page for non-existent static files', async () => {
280
- const response = await matcher.handleNoMatch('/non-existent.txt');
281
- const body = await response.text();
282
- expect(body).toContain('<h1>404 - Page Not Found</h1>');
283
- });
284
- });
285
-
286
- describe('internal transpile output', () => {
287
- it('should inspect page modules through the owning route renderer', async () => {
288
- const matcher = new FileSystemResponseMatcher({
289
- appConfig,
290
- assetPrefix: path.join(appConfig.rootDir, appConfig.distDir),
291
- router,
292
- routeRendererFactory,
293
- fileSystemResponseFactory,
294
- });
295
-
296
- const loadPageModule = vi.fn(async () => ({}));
297
- (matcher as any).routeRendererFactory = {
298
- getPageRenderer: vi.fn(() => ({
299
- loadPageModule,
300
- })),
301
- };
302
-
303
- await (matcher as any).importPageModule(INDEX_TEMPLATE_FILE);
304
-
305
- expect((matcher as any).routeRendererFactory.getPageRenderer).toHaveBeenCalledWith(INDEX_TEMPLATE_FILE);
306
- expect(loadPageModule).toHaveBeenCalledWith(INDEX_TEMPLATE_FILE, {
307
- cacheScope: 'request-metadata',
308
- });
309
- });
310
- });
311
- });