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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (354) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/package.json +212 -92
  3. package/src/adapters/abstract/application-adapter.d.ts +168 -0
  4. package/src/adapters/abstract/application-adapter.js +109 -0
  5. package/src/adapters/abstract/router-adapter.d.ts +26 -0
  6. package/src/adapters/abstract/router-adapter.js +5 -0
  7. package/src/adapters/abstract/server-adapter.d.ts +69 -0
  8. package/src/adapters/abstract/server-adapter.js +15 -0
  9. package/src/adapters/bun/client-bridge.d.ts +34 -0
  10. package/src/adapters/bun/client-bridge.js +48 -0
  11. package/src/adapters/bun/create-app.d.ts +60 -0
  12. package/src/adapters/bun/create-app.js +117 -0
  13. package/src/adapters/bun/hmr-manager.d.ts +143 -0
  14. package/src/adapters/bun/hmr-manager.js +334 -0
  15. package/src/adapters/bun/index.d.ts +2 -0
  16. package/src/adapters/bun/index.js +8 -0
  17. package/src/adapters/bun/server-adapter.d.ts +155 -0
  18. package/src/adapters/bun/server-adapter.js +373 -0
  19. package/src/adapters/bun/server-lifecycle.d.ts +63 -0
  20. package/src/adapters/bun/server-lifecycle.js +92 -0
  21. package/src/adapters/index.d.ts +6 -0
  22. package/src/adapters/index.js +14 -0
  23. package/src/adapters/node/bootstrap-dependency-resolver.d.ts +44 -0
  24. package/src/adapters/node/bootstrap-dependency-resolver.js +172 -0
  25. package/src/adapters/node/create-app.d.ts +21 -0
  26. package/src/adapters/node/create-app.js +143 -0
  27. package/src/adapters/node/index.d.ts +6 -0
  28. package/src/adapters/node/index.js +11 -0
  29. package/src/adapters/node/node-client-bridge.d.ts +26 -0
  30. package/src/adapters/node/node-client-bridge.js +66 -0
  31. package/src/adapters/node/node-hmr-manager.d.ts +133 -0
  32. package/src/adapters/node/node-hmr-manager.js +312 -0
  33. package/src/adapters/node/runtime-adapter.d.ts +46 -0
  34. package/src/adapters/node/runtime-adapter.js +306 -0
  35. package/src/adapters/node/server-adapter.d.ts +161 -0
  36. package/src/adapters/node/server-adapter.js +358 -0
  37. package/src/adapters/node/static-content-server.d.ts +60 -0
  38. package/src/adapters/node/static-content-server.js +194 -0
  39. package/src/adapters/node/write-runtime-manifest.d.ts +26 -0
  40. package/src/adapters/node/write-runtime-manifest.js +12 -0
  41. package/src/adapters/shared/api-response.d.ts +52 -0
  42. package/src/adapters/shared/api-response.js +96 -0
  43. package/src/adapters/shared/application-adapter.d.ts +18 -0
  44. package/src/adapters/shared/application-adapter.js +90 -0
  45. package/src/adapters/shared/define-api-handler.d.ts +25 -0
  46. package/src/adapters/shared/define-api-handler.js +15 -0
  47. package/src/adapters/shared/explicit-static-route-matcher.d.ts +38 -0
  48. package/src/adapters/shared/explicit-static-route-matcher.js +103 -0
  49. package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
  50. package/src/adapters/shared/file-route-middleware-pipeline.js +99 -0
  51. package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
  52. package/src/adapters/shared/fs-server-response-factory.js +97 -0
  53. package/src/adapters/shared/fs-server-response-matcher.d.ts +75 -0
  54. package/src/adapters/shared/fs-server-response-matcher.js +160 -0
  55. package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
  56. package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
  57. package/src/adapters/shared/hmr-html-response.d.ts +22 -0
  58. package/src/adapters/shared/hmr-html-response.js +32 -0
  59. package/src/adapters/shared/render-context.d.ts +14 -0
  60. package/src/adapters/shared/render-context.js +70 -0
  61. package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
  62. package/src/adapters/shared/runtime-bootstrap.js +43 -0
  63. package/src/adapters/shared/server-adapter.d.ts +97 -0
  64. package/src/adapters/shared/server-adapter.js +386 -0
  65. package/src/adapters/shared/server-route-handler.d.ts +89 -0
  66. package/src/adapters/shared/server-route-handler.js +111 -0
  67. package/src/adapters/shared/server-static-builder.d.ts +70 -0
  68. package/src/adapters/shared/server-static-builder.js +99 -0
  69. package/src/build/build-adapter.d.ts +186 -0
  70. package/src/build/build-adapter.js +168 -0
  71. package/src/build/build-manifest.d.ts +27 -0
  72. package/src/build/build-manifest.js +30 -0
  73. package/src/build/build-types.d.ts +57 -0
  74. package/src/build/build-types.js +0 -0
  75. package/src/build/dev-build-coordinator.d.ts +74 -0
  76. package/src/build/dev-build-coordinator.js +161 -0
  77. package/src/build/esbuild-build-adapter.d.ts +72 -0
  78. package/src/build/esbuild-build-adapter.js +422 -0
  79. package/src/build/runtime-build-executor.d.ts +13 -0
  80. package/src/build/runtime-build-executor.js +20 -0
  81. package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
  82. package/src/build/runtime-specifier-alias-plugin.js +31 -0
  83. package/src/config/config-builder.d.ts +238 -0
  84. package/src/config/config-builder.js +565 -0
  85. package/src/constants.d.ts +45 -0
  86. package/src/constants.js +25 -0
  87. package/src/create-app.d.ts +17 -0
  88. package/src/create-app.js +66 -0
  89. package/src/dev/sc-server.d.ts +30 -0
  90. package/src/dev/sc-server.js +111 -0
  91. package/src/eco/component-render-context.d.ts +105 -0
  92. package/src/eco/component-render-context.js +87 -0
  93. package/src/eco/eco.d.ts +9 -0
  94. package/src/eco/eco.js +114 -0
  95. package/src/eco/eco.types.d.ts +178 -0
  96. package/src/eco/eco.types.js +0 -0
  97. package/src/eco/eco.utils.d.ts +40 -0
  98. package/src/eco/eco.utils.js +40 -0
  99. package/src/eco/global-injector-map.d.ts +16 -0
  100. package/src/eco/global-injector-map.js +80 -0
  101. package/src/eco/lazy-injector-map.d.ts +8 -0
  102. package/src/eco/lazy-injector-map.js +70 -0
  103. package/src/eco/module-dependencies.d.ts +18 -0
  104. package/src/eco/module-dependencies.js +49 -0
  105. package/src/errors/http-error.d.ts +31 -0
  106. package/src/errors/http-error.js +50 -0
  107. package/src/errors/index.d.ts +2 -0
  108. package/src/errors/index.js +4 -0
  109. package/src/errors/locals-access-error.d.ts +4 -0
  110. package/src/errors/locals-access-error.js +9 -0
  111. package/src/global/app-logger.d.ts +2 -0
  112. package/src/global/app-logger.js +6 -0
  113. package/src/hmr/client/hmr-runtime.d.ts +5 -0
  114. package/src/hmr/client/hmr-runtime.js +109 -0
  115. package/src/hmr/hmr-strategy.d.ts +159 -0
  116. package/src/hmr/hmr-strategy.js +29 -0
  117. package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
  118. package/src/hmr/hmr.postcss.test.e2e.js +31 -0
  119. package/src/hmr/hmr.test.e2e.d.ts +1 -0
  120. package/src/hmr/hmr.test.e2e.js +43 -0
  121. package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
  122. package/src/hmr/strategies/default-hmr-strategy.js +34 -0
  123. package/src/hmr/strategies/js-hmr-strategy.d.ts +139 -0
  124. package/src/hmr/strategies/js-hmr-strategy.js +178 -0
  125. package/src/index.browser.d.ts +3 -0
  126. package/src/index.browser.js +4 -0
  127. package/src/index.d.ts +5 -0
  128. package/src/index.js +10 -0
  129. package/src/integrations/ghtml/ghtml-renderer.d.ts +15 -0
  130. package/src/integrations/ghtml/ghtml-renderer.js +62 -0
  131. package/src/integrations/ghtml/ghtml.plugin.d.ts +20 -0
  132. package/src/integrations/ghtml/ghtml.plugin.js +21 -0
  133. package/src/internal-types.d.ts +221 -0
  134. package/src/internal-types.js +0 -0
  135. package/src/plugins/alias-resolver-plugin.d.ts +2 -0
  136. package/src/plugins/alias-resolver-plugin.js +53 -0
  137. package/src/plugins/eco-component-meta-plugin.d.ts +97 -0
  138. package/src/plugins/eco-component-meta-plugin.js +157 -0
  139. package/src/plugins/integration-plugin.d.ts +136 -0
  140. package/src/plugins/integration-plugin.js +133 -0
  141. package/src/plugins/processor.d.ts +95 -0
  142. package/src/plugins/processor.js +136 -0
  143. package/src/plugins/runtime-capability.d.ts +9 -0
  144. package/src/plugins/runtime-capability.js +0 -0
  145. package/src/public-types.d.ts +1149 -0
  146. package/src/public-types.js +0 -0
  147. package/src/route-renderer/component-graph/component-graph-executor.d.ts +32 -0
  148. package/src/route-renderer/component-graph/component-graph-executor.js +31 -0
  149. package/src/route-renderer/component-graph/component-graph.d.ts +42 -0
  150. package/src/route-renderer/component-graph/component-graph.js +72 -0
  151. package/src/route-renderer/component-graph/component-marker.d.ts +52 -0
  152. package/src/route-renderer/component-graph/component-marker.js +46 -0
  153. package/src/route-renderer/component-graph/component-reference.d.ts +10 -0
  154. package/src/route-renderer/component-graph/component-reference.js +19 -0
  155. package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +77 -0
  156. package/src/route-renderer/component-graph/marker-graph-resolver.js +95 -0
  157. package/src/route-renderer/orchestration/integration-renderer.d.ts +372 -0
  158. package/src/route-renderer/orchestration/integration-renderer.js +589 -0
  159. package/src/route-renderer/orchestration/render-execution.service.d.ts +103 -0
  160. package/src/route-renderer/orchestration/render-execution.service.js +121 -0
  161. package/src/route-renderer/orchestration/render-preparation.service.d.ts +121 -0
  162. package/src/route-renderer/orchestration/render-preparation.service.js +332 -0
  163. package/src/route-renderer/page-loading/dependency-resolver.d.ts +35 -0
  164. package/src/route-renderer/page-loading/dependency-resolver.js +442 -0
  165. package/src/route-renderer/page-loading/page-module-loader.d.ts +87 -0
  166. package/src/route-renderer/page-loading/page-module-loader.js +124 -0
  167. package/src/route-renderer/route-renderer.d.ts +61 -0
  168. package/src/route-renderer/route-renderer.js +87 -0
  169. package/src/router/client/link-intent.js +34 -0
  170. package/src/router/client/link-intent.test.browser.d.ts +1 -0
  171. package/src/router/client/link-intent.test.browser.js +43 -0
  172. package/src/router/client/navigation-coordinator.d.ts +149 -0
  173. package/src/router/client/navigation-coordinator.js +215 -0
  174. package/src/router/server/fs-router-scanner.d.ts +41 -0
  175. package/src/router/server/fs-router-scanner.js +156 -0
  176. package/src/router/server/fs-router.d.ts +26 -0
  177. package/src/router/server/fs-router.js +100 -0
  178. package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +120 -0
  179. package/src/services/assets/asset-processing-service/asset-processing.service.js +331 -0
  180. package/src/services/assets/asset-processing-service/asset.factory.d.ts +17 -0
  181. package/src/services/assets/asset-processing-service/asset.factory.js +82 -0
  182. package/src/services/assets/asset-processing-service/assets.types.d.ts +89 -0
  183. package/src/services/assets/asset-processing-service/assets.types.js +0 -0
  184. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
  185. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +48 -0
  186. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
  187. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
  188. package/src/services/assets/asset-processing-service/index.d.ts +5 -0
  189. package/src/services/assets/asset-processing-service/index.js +5 -0
  190. package/src/services/assets/asset-processing-service/processor.interface.d.ts +22 -0
  191. package/src/services/assets/asset-processing-service/processor.interface.js +6 -0
  192. package/src/services/assets/asset-processing-service/processor.registry.d.ts +8 -0
  193. package/src/services/assets/asset-processing-service/processor.registry.js +15 -0
  194. package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +24 -0
  195. package/src/services/assets/asset-processing-service/processors/base/base-processor.js +64 -0
  196. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +17 -0
  197. package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +72 -0
  198. package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
  199. package/src/services/assets/asset-processing-service/processors/index.js +5 -0
  200. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +5 -0
  201. package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +57 -0
  202. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +8 -0
  203. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +76 -0
  204. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
  205. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +75 -0
  206. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -0
  207. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +25 -0
  208. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
  209. package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +66 -0
  210. package/src/services/assets/browser-bundle.service.d.ts +32 -0
  211. package/src/services/assets/browser-bundle.service.js +33 -0
  212. package/src/services/cache/cache.types.d.ts +107 -0
  213. package/src/services/cache/cache.types.js +0 -0
  214. package/src/services/cache/index.d.ts +7 -0
  215. package/src/services/cache/index.js +7 -0
  216. package/src/services/cache/memory-cache-store.d.ts +42 -0
  217. package/src/services/cache/memory-cache-store.js +98 -0
  218. package/src/services/cache/page-cache-service.d.ts +70 -0
  219. package/src/services/cache/page-cache-service.js +152 -0
  220. package/src/services/cache/page-request-cache-coordinator.service.d.ts +75 -0
  221. package/src/services/cache/page-request-cache-coordinator.service.js +109 -0
  222. package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
  223. package/src/services/html/html-rewriter-provider.service.js +65 -0
  224. package/src/services/html/html-transformer.service.d.ts +77 -0
  225. package/src/services/html/html-transformer.service.js +221 -0
  226. package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
  227. package/src/services/invalidation/development-invalidation.service.js +189 -0
  228. package/src/services/module-loading/app-server-module-transpiler.service.d.ts +16 -0
  229. package/src/services/module-loading/app-server-module-transpiler.service.js +34 -0
  230. package/src/services/module-loading/page-module-import.service.d.ts +71 -0
  231. package/src/services/module-loading/page-module-import.service.js +132 -0
  232. package/src/services/module-loading/server-loader.service.d.ts +96 -0
  233. package/src/services/module-loading/server-loader.service.js +32 -0
  234. package/src/services/module-loading/server-module-transpiler.service.d.ts +69 -0
  235. package/src/services/module-loading/server-module-transpiler.service.js +61 -0
  236. package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +35 -0
  237. package/src/services/runtime-manifest/node-runtime-manifest.service.js +60 -0
  238. package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
  239. package/src/services/runtime-state/dev-graph.service.js +162 -0
  240. package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
  241. package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
  242. package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +69 -0
  243. package/src/services/runtime-state/runtime-specifier-registry.service.js +37 -0
  244. package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
  245. package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
  246. package/src/services/validation/schema-validation-service.d.ts +122 -0
  247. package/src/services/validation/schema-validation-service.js +101 -0
  248. package/src/services/validation/standard-schema.types.d.ts +65 -0
  249. package/src/services/validation/standard-schema.types.js +0 -0
  250. package/src/static-site-generator/static-site-generator.d.ts +109 -0
  251. package/src/static-site-generator/static-site-generator.js +353 -0
  252. package/src/utils/css.d.ts +1 -0
  253. package/src/utils/css.js +7 -0
  254. package/src/utils/deep-merge.d.ts +14 -0
  255. package/src/utils/deep-merge.js +32 -0
  256. package/src/utils/hash.d.ts +1 -0
  257. package/src/utils/hash.js +7 -0
  258. package/src/utils/html.d.ts +1 -0
  259. package/src/utils/html.js +4 -0
  260. package/src/utils/invariant.d.ts +5 -0
  261. package/src/utils/invariant.js +11 -0
  262. package/src/utils/locals-utils.d.ts +15 -0
  263. package/src/utils/locals-utils.js +24 -0
  264. package/src/utils/parse-cli-args.d.ts +24 -0
  265. package/src/utils/parse-cli-args.js +47 -0
  266. package/src/utils/path-utils.module.d.ts +5 -0
  267. package/src/utils/path-utils.module.js +14 -0
  268. package/src/utils/resolve-work-dir.d.ts +11 -0
  269. package/src/utils/resolve-work-dir.js +31 -0
  270. package/src/utils/runtime.d.ts +11 -0
  271. package/src/utils/runtime.js +40 -0
  272. package/src/utils/server-utils.module.d.ts +19 -0
  273. package/src/utils/server-utils.module.js +56 -0
  274. package/src/watchers/project-watcher.d.ts +136 -0
  275. package/src/watchers/project-watcher.js +281 -0
  276. package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
  277. package/src/watchers/project-watcher.test-helpers.js +52 -0
  278. package/src/adapters/bun/hmr-manager.test.ts +0 -267
  279. package/src/adapters/node/bootstrap-dependency-resolver.test.ts +0 -282
  280. package/src/adapters/node/node-client-bridge.test.ts +0 -198
  281. package/src/adapters/node/node-hmr-manager.test.ts +0 -322
  282. package/src/adapters/node/runtime-adapter.test.ts +0 -868
  283. package/src/adapters/node/static-content-server.test.ts +0 -60
  284. package/src/adapters/shared/api-response.test.ts +0 -97
  285. package/src/adapters/shared/explicit-static-route-matcher.test.ts +0 -381
  286. package/src/adapters/shared/file-route-middleware-pipeline.test.ts +0 -90
  287. package/src/adapters/shared/fs-server-response-factory.test.ts +0 -187
  288. package/src/adapters/shared/fs-server-response-matcher.test.ts +0 -286
  289. package/src/adapters/shared/hmr-manager.contract.test.ts +0 -196
  290. package/src/adapters/shared/hmr-manager.dispatch.test.ts +0 -220
  291. package/src/adapters/shared/render-context.test.ts +0 -146
  292. package/src/adapters/shared/server-adapter.test.ts +0 -77
  293. package/src/adapters/shared/server-route-handler.test.ts +0 -110
  294. package/src/adapters/shared/server-static-builder.test.ts +0 -316
  295. package/src/build/build-adapter-serialization.test.ts +0 -268
  296. package/src/build/build-adapter.test.ts +0 -815
  297. package/src/build/runtime-specifier-alias-plugin.test.ts +0 -43
  298. package/src/config/config-builder.test.ts +0 -410
  299. package/src/eco/eco.test.ts +0 -678
  300. package/src/eco/eco.utils.test.ts +0 -124
  301. package/src/eco/global-injector-map.test.ts +0 -42
  302. package/src/eco/lazy-injector-map.test.ts +0 -66
  303. package/src/eco/module-dependencies.test.ts +0 -30
  304. package/src/errors/http-error.test.ts +0 -134
  305. package/src/global/utils.test.ts +0 -12
  306. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-have-HMR-script-injected-in-page-1.png +0 -0
  307. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
  308. package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
  309. package/src/hmr/hmr-strategy.test.ts +0 -124
  310. package/src/hmr/strategies/js-hmr-strategy.test.ts +0 -335
  311. package/src/integrations/ghtml/ghtml-renderer.test.ts +0 -63
  312. package/src/plugins/alias-resolver-plugin.test.ts +0 -41
  313. package/src/plugins/eco-component-meta-plugin.test.ts +0 -380
  314. package/src/plugins/integration-plugin.test.ts +0 -111
  315. package/src/plugins/processor.test.ts +0 -148
  316. package/src/route-renderer/component-graph/component-graph-executor.test.ts +0 -41
  317. package/src/route-renderer/component-graph/component-graph.test.ts +0 -63
  318. package/src/route-renderer/component-graph/component-marker.test.ts +0 -73
  319. package/src/route-renderer/component-graph/marker-graph-resolver.test.ts +0 -135
  320. package/src/route-renderer/orchestration/integration-renderer.test.ts +0 -936
  321. package/src/route-renderer/orchestration/render-execution.service.test.ts +0 -97
  322. package/src/route-renderer/orchestration/render-preparation.service.test.ts +0 -235
  323. package/src/route-renderer/page-loading/dependency-resolver.test.ts +0 -345
  324. package/src/route-renderer/page-loading/page-module-loader.test.ts +0 -96
  325. package/src/router/client/navigation-coordinator.test.ts +0 -237
  326. package/src/router/server/fs-router-scanner.test.ts +0 -83
  327. package/src/router/server/fs-router.test.ts +0 -214
  328. package/src/services/assets/asset-processing-service/asset-processing.service.test.ts +0 -385
  329. package/src/services/assets/asset-processing-service/asset.factory.test.ts +0 -63
  330. package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.test.ts +0 -72
  331. package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.test.ts +0 -67
  332. package/src/services/assets/asset-processing-service/processors/base/base-processor.test.ts +0 -59
  333. package/src/services/assets/asset-processing-service/processors/script/file-script.processor.test.ts +0 -286
  334. package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.test.ts +0 -227
  335. package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.test.ts +0 -199
  336. package/src/services/assets/browser-bundle.service.test.ts +0 -36
  337. package/src/services/cache/memory-cache-store.test.ts +0 -225
  338. package/src/services/cache/page-cache-service.test.ts +0 -175
  339. package/src/services/cache/page-request-cache-coordinator.service.test.ts +0 -79
  340. package/src/services/html/html-rewriter-provider.service.test.ts +0 -183
  341. package/src/services/html/html-transformer.service.test.ts +0 -378
  342. package/src/services/invalidation/development-invalidation.service.test.ts +0 -77
  343. package/src/services/module-loading/page-module-import.service.test.ts +0 -253
  344. package/src/services/module-loading/server-loader.service.test.ts +0 -161
  345. package/src/services/module-loading/server-module-transpiler.service.test.ts +0 -115
  346. package/src/services/runtime-manifest/node-runtime-manifest.service.test.ts +0 -95
  347. package/src/services/validation/schema-validation-service.test.ts +0 -223
  348. package/src/static-site-generator/static-site-generator.test.ts +0 -307
  349. package/src/utils/deep-merge.test.ts +0 -114
  350. package/src/utils/invariant.test.ts +0 -22
  351. package/src/utils/path-utils.test.ts +0 -15
  352. package/src/utils/server-utils.test.ts +0 -38
  353. package/src/watchers/project-watcher.integration.test.ts +0 -337
  354. package/src/watchers/project-watcher.test.ts +0 -678
@@ -0,0 +1,331 @@
1
+ import path from "node:path";
2
+ import { RESOLVED_ASSETS_DIR } from "../../../constants";
3
+ import { appLogger } from "../../../global/app-logger";
4
+ import { rapidhash } from "../../../utils/hash";
5
+ import { fileSystem } from "@ecopages/file-system";
6
+ import { isHmrAware } from "./processor.interface";
7
+ import { ProcessorRegistry } from "./processor.registry";
8
+ import {
9
+ ContentScriptProcessor,
10
+ ContentStylesheetProcessor,
11
+ FileScriptProcessor,
12
+ FileStylesheetProcessor,
13
+ NodeModuleScriptProcessor
14
+ } from "./processors";
15
+ class AssetProcessingService {
16
+ static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
17
+ registry = new ProcessorRegistry();
18
+ hmrManager;
19
+ cache = /* @__PURE__ */ new Map();
20
+ config;
21
+ /**
22
+ * Creates the asset-processing service bound to one finalized app config.
23
+ */
24
+ constructor(config) {
25
+ this.config = config;
26
+ }
27
+ /**
28
+ * Set the HMR manager for the asset processing service.
29
+ * @param hmrManager The HMR manager to set.
30
+ */
31
+ setHmrManager(hmrManager) {
32
+ this.hmrManager = hmrManager;
33
+ for (const processor of this.registry.getAllProcessors().values()) {
34
+ if (isHmrAware(processor)) {
35
+ processor.setHmrManager(hmrManager);
36
+ }
37
+ }
38
+ }
39
+ getHmrManager() {
40
+ return this.hmrManager;
41
+ }
42
+ /**
43
+ * Register a processor for a specific asset kind and source.
44
+ * @param kind The asset kind.
45
+ * @param variant The asset source.
46
+ * @param processor The processor to register.
47
+ */
48
+ registerProcessor(kind, variant, processor) {
49
+ if (this.hmrManager && isHmrAware(processor)) {
50
+ processor.setHmrManager(this.hmrManager);
51
+ }
52
+ this.registry.register(kind, variant, processor);
53
+ }
54
+ /**
55
+ * Processes one dependency list into normalized emitted assets.
56
+ *
57
+ * @remarks
58
+ * Dependencies are deduplicated before processor execution so repeated
59
+ * declarations across the render tree reuse the same emitted outputs and cache
60
+ * entries.
61
+ */
62
+ async processDependencies(deps, key) {
63
+ const depsDir = path.join(this.config.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
64
+ fileSystem.ensureDir(depsDir);
65
+ const dedupedDeps = this.deduplicateDependencies(deps);
66
+ const results = await this.processDependenciesParallel(dedupedDeps, key);
67
+ await this.optimizeDependencies(results);
68
+ return results;
69
+ }
70
+ /**
71
+ * Removes duplicate dependency declarations while preserving first-seen order.
72
+ */
73
+ deduplicateDependencies(deps) {
74
+ const seen = /* @__PURE__ */ new Map();
75
+ for (const dep of deps) {
76
+ const key = this.getDependencyKey(dep);
77
+ if (!seen.has(key)) {
78
+ seen.set(key, dep);
79
+ }
80
+ }
81
+ return Array.from(seen.values());
82
+ }
83
+ /**
84
+ * Builds the cache signature fragment for script dependencies that can vary by
85
+ * bundling policy.
86
+ */
87
+ getScriptDependencyBuildSignature(dep) {
88
+ if (dep.kind !== "script") {
89
+ return void 0;
90
+ }
91
+ const pluginNames = dep.bundleOptions?.plugins?.map((plugin) => plugin.name) ?? [];
92
+ const signature = {
93
+ bundle: dep.bundle,
94
+ inline: dep.inline,
95
+ excludeFromHtml: dep.excludeFromHtml,
96
+ naming: dep.bundleOptions?.naming,
97
+ external: dep.bundleOptions?.external,
98
+ minify: dep.bundleOptions?.minify,
99
+ plugins: pluginNames
100
+ };
101
+ return this.generateHash(JSON.stringify(signature));
102
+ }
103
+ /**
104
+ * Derives the stable cache key for one dependency declaration.
105
+ */
106
+ getDependencyKey(dep) {
107
+ const parts = [dep.kind, dep.source];
108
+ if ("filepath" in dep) {
109
+ parts.push(dep.filepath);
110
+ } else if ("content" in dep) {
111
+ parts.push(`content:${this.generateHash(dep.content)}`);
112
+ } else if ("importPath" in dep) {
113
+ parts.push(dep.importPath);
114
+ }
115
+ if ("position" in dep && dep.position) {
116
+ parts.push(dep.position);
117
+ }
118
+ const scriptBuildSignature = this.getScriptDependencyBuildSignature(dep);
119
+ if (scriptBuildSignature) {
120
+ parts.push(`build:${scriptBuildSignature}`);
121
+ }
122
+ return parts.join(":");
123
+ }
124
+ /**
125
+ * Hashes content used in dependency cache and signature keys.
126
+ */
127
+ generateHash(content) {
128
+ return rapidhash(content).toString();
129
+ }
130
+ /**
131
+ * Processes deduplicated dependencies grouped by processor type.
132
+ *
133
+ * @remarks
134
+ * Grouping keeps cache and processor behavior isolated by asset kind/source
135
+ * pair, while still allowing the overall dependency set to resolve in
136
+ * parallel.
137
+ */
138
+ async processDependenciesParallel(deps, key) {
139
+ const grouped = this.groupDependenciesByType(deps);
140
+ const groupPromises = Object.entries(grouped).map(async ([, typeDeps]) => {
141
+ const typePromises = typeDeps.map(async (dep) => {
142
+ const depKey = this.getDependencyKey(dep);
143
+ const cached = this.getCachedAsset(dep, depKey);
144
+ if (cached) {
145
+ return { key, ...cached };
146
+ }
147
+ const processor = this.registry.getProcessor(dep.kind, dep.source);
148
+ if (!processor) {
149
+ appLogger.error(`No processor found for ${dep.kind}/${dep.source}`);
150
+ return null;
151
+ }
152
+ if (dep.source === "file" && "filepath" in dep) {
153
+ const fileExists = fileSystem.exists(dep.filepath);
154
+ if (!fileExists) {
155
+ appLogger.warn(`Skipping missing ${dep.kind} file: ${dep.filepath}`);
156
+ return null;
157
+ }
158
+ }
159
+ try {
160
+ const processed = await processor.process(dep);
161
+ const srcUrl = this.resolveProcessedAssetSrcUrl(processed);
162
+ const processedWithKey = {
163
+ key,
164
+ ...processed,
165
+ srcUrl
166
+ };
167
+ this.setCachedAsset(dep, depKey, processedWithKey);
168
+ return processedWithKey;
169
+ } catch (error) {
170
+ appLogger.error(
171
+ `Failed to process dependency: ${error instanceof Error ? error.message : String(error)} for ${dep.kind}/${dep.source}`
172
+ );
173
+ appLogger.debug(error);
174
+ return null;
175
+ }
176
+ });
177
+ const typeResults = await Promise.all(typePromises);
178
+ return typeResults.filter((result) => result !== null);
179
+ });
180
+ const allTypeResults = await Promise.all(groupPromises);
181
+ return allTypeResults.flat();
182
+ }
183
+ /**
184
+ * Groups dependencies by processor bucket.
185
+ */
186
+ groupDependenciesByType(deps) {
187
+ return deps.reduce(
188
+ (acc, dep) => {
189
+ const key = `${dep.kind}_${dep.source}`;
190
+ if (!acc[key]) acc[key] = [];
191
+ acc[key].push(dep);
192
+ return acc;
193
+ },
194
+ {}
195
+ );
196
+ }
197
+ /**
198
+ * Converts a dist-local file path into its public URL.
199
+ */
200
+ getSrcUrl(filepath) {
201
+ const distDir = this.config.absolutePaths.distDir;
202
+ if (!filepath.startsWith(distDir)) return void 0;
203
+ const relativePath = filepath.slice(distDir.length);
204
+ const urlPath = relativePath.startsWith("/") ? relativePath : `/${relativePath}`;
205
+ return urlPath.replace(/\\/g, "/");
206
+ }
207
+ /**
208
+ * Normalizes the public source URL for one processed asset.
209
+ */
210
+ resolveProcessedAssetSrcUrl(processed) {
211
+ if (processed.srcUrl) {
212
+ if (this.isFilesystemPath(processed.srcUrl)) {
213
+ const srcUrlFromPath = this.getSrcUrl(processed.srcUrl);
214
+ if (srcUrlFromPath) return srcUrlFromPath;
215
+ } else {
216
+ return processed.srcUrl;
217
+ }
218
+ }
219
+ if (processed.filepath) {
220
+ return this.getSrcUrl(processed.filepath);
221
+ }
222
+ return void 0;
223
+ }
224
+ /**
225
+ * Returns whether a value should be interpreted as a filesystem path instead
226
+ * of an already-public URL.
227
+ */
228
+ isFilesystemPath(value) {
229
+ if (value.startsWith("http://") || value.startsWith("https://") || value.startsWith("//")) {
230
+ return false;
231
+ }
232
+ if (value.startsWith(this.config.absolutePaths.distDir)) {
233
+ return true;
234
+ }
235
+ const rootDir = this.config.rootDir;
236
+ if (rootDir && value.startsWith(rootDir)) {
237
+ return true;
238
+ }
239
+ return /^[A-Za-z]:\\/.test(value);
240
+ }
241
+ /**
242
+ * Applies post-processing for emitted production assets.
243
+ *
244
+ * @remarks
245
+ * Current optimization is intentionally conservative: only generated CSS and
246
+ * JavaScript files inside the app dist directory are gzipped.
247
+ */
248
+ async optimizeDependencies(processedAssets) {
249
+ if (process.env.NODE_ENV !== "production") {
250
+ return;
251
+ }
252
+ const filesToGzip = /* @__PURE__ */ new Set();
253
+ for (const asset of processedAssets) {
254
+ if (!asset.filepath) {
255
+ continue;
256
+ }
257
+ if (!asset.filepath.startsWith(this.config.absolutePaths.distDir)) {
258
+ continue;
259
+ }
260
+ const extension = path.extname(asset.filepath).slice(1);
261
+ if (extension === "css" || extension === "js") {
262
+ filesToGzip.add(asset.filepath);
263
+ }
264
+ }
265
+ for (const filePath of filesToGzip) {
266
+ if (fileSystem.exists(filePath)) {
267
+ fileSystem.gzipFile(filePath);
268
+ }
269
+ }
270
+ }
271
+ /**
272
+ * Returns the cached processed asset for a dependency key when available.
273
+ */
274
+ getCachedAsset(dep, depKey) {
275
+ if (process.env.NODE_ENV !== "production" && dep.source === "file" && dep.kind === "stylesheet") {
276
+ return null;
277
+ }
278
+ const cached = this.cache.get(depKey);
279
+ if (!cached) {
280
+ return null;
281
+ }
282
+ if (cached.asset.filepath && !fileSystem.exists(cached.asset.filepath)) {
283
+ this.cache.delete(depKey);
284
+ return null;
285
+ }
286
+ return cached.asset;
287
+ }
288
+ /**
289
+ * Stores one processed asset in the dependency cache.
290
+ */
291
+ setCachedAsset(dep, depKey, asset) {
292
+ this.cache.set(depKey, { asset });
293
+ }
294
+ /**
295
+ * Clears all cached processed assets.
296
+ */
297
+ clearCache() {
298
+ this.cache.clear();
299
+ }
300
+ /**
301
+ * Removes cached assets that were produced from the given file path.
302
+ */
303
+ invalidateCacheForFile(filepath) {
304
+ for (const [key, value] of this.cache.entries()) {
305
+ if (value.asset.filepath === filepath) {
306
+ this.cache.delete(key);
307
+ }
308
+ }
309
+ }
310
+ /**
311
+ * Creates a service prewired with the default core processors.
312
+ */
313
+ static createWithDefaultProcessors(appConfig) {
314
+ const service = new AssetProcessingService(appConfig);
315
+ service.registerProcessor("script", "content", new ContentScriptProcessor({ appConfig }));
316
+ service.registerProcessor("script", "file", new FileScriptProcessor({ appConfig }));
317
+ service.registerProcessor("script", "node-module", new NodeModuleScriptProcessor({ appConfig }));
318
+ service.registerProcessor("stylesheet", "content", new ContentStylesheetProcessor({ appConfig }));
319
+ service.registerProcessor("stylesheet", "file", new FileStylesheetProcessor({ appConfig }));
320
+ return service;
321
+ }
322
+ /**
323
+ * Returns the processor registry owned by this service.
324
+ */
325
+ getRegistry() {
326
+ return this.registry;
327
+ }
328
+ }
329
+ export {
330
+ AssetProcessingService
331
+ };
@@ -0,0 +1,17 @@
1
+ import type { ContentScriptAsset, ContentStylesheetAsset, FileScriptAsset, FileStylesheetAsset, InlineContentScriptAsset, InlineContentStylesheetAsset, InlineFileScriptAsset, JsonScriptAsset, NodeModuleScriptAsset } from './assets.types';
2
+ type CreateAssetOptions<T> = Omit<T, 'kind' | 'source' | 'inline'>;
3
+ export declare class AssetFactory {
4
+ static readonly RESOLVED_ASSETS_DIR = "assets";
5
+ static readonly RESOLVED_ASSETS_VENDORS_DIR: string;
6
+ static createContentScript(options: CreateAssetOptions<ContentScriptAsset>): ContentScriptAsset;
7
+ static createInlineContentScript(options: CreateAssetOptions<InlineContentScriptAsset>): InlineContentScriptAsset;
8
+ static createFileScript(options: CreateAssetOptions<FileScriptAsset>): FileScriptAsset;
9
+ static createInlineFileScript(options: CreateAssetOptions<InlineFileScriptAsset>): InlineFileScriptAsset;
10
+ static createNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset;
11
+ static createInlineNodeModuleScript(options: CreateAssetOptions<NodeModuleScriptAsset>): NodeModuleScriptAsset;
12
+ static createJsonScript(options: CreateAssetOptions<JsonScriptAsset>): JsonScriptAsset;
13
+ static createContentStylesheet(options: CreateAssetOptions<ContentStylesheetAsset>): ContentStylesheetAsset;
14
+ static createInlineContentStylesheet(options: CreateAssetOptions<InlineContentStylesheetAsset>): InlineContentStylesheetAsset;
15
+ static createFileStylesheet(options: CreateAssetOptions<FileStylesheetAsset>): FileStylesheetAsset;
16
+ }
17
+ export {};
@@ -0,0 +1,82 @@
1
+ import { RESOLVED_ASSETS_DIR, RESOLVED_ASSETS_VENDORS_DIR } from "../../../constants";
2
+ import { deepMerge } from "../../../utils/deep-merge";
3
+ class AssetFactory {
4
+ static RESOLVED_ASSETS_DIR = RESOLVED_ASSETS_DIR;
5
+ static RESOLVED_ASSETS_VENDORS_DIR = RESOLVED_ASSETS_VENDORS_DIR;
6
+ static createContentScript(options) {
7
+ return {
8
+ kind: "script",
9
+ source: "content",
10
+ position: options.position || "body",
11
+ ...options
12
+ };
13
+ }
14
+ static createInlineContentScript(options) {
15
+ return {
16
+ ...AssetFactory.createContentScript(options),
17
+ inline: true
18
+ };
19
+ }
20
+ static createFileScript(options) {
21
+ return {
22
+ kind: "script",
23
+ source: "file",
24
+ position: options.position || "body",
25
+ ...options
26
+ };
27
+ }
28
+ static createInlineFileScript(options) {
29
+ return {
30
+ ...AssetFactory.createFileScript(options),
31
+ inline: true
32
+ };
33
+ }
34
+ static createNodeModuleScript(options) {
35
+ return {
36
+ kind: "script",
37
+ source: "node-module",
38
+ position: options.position || "body",
39
+ ...options
40
+ };
41
+ }
42
+ static createInlineNodeModuleScript(options) {
43
+ return {
44
+ ...AssetFactory.createNodeModuleScript(options),
45
+ inline: true
46
+ };
47
+ }
48
+ static createJsonScript(options) {
49
+ return {
50
+ kind: "script",
51
+ source: "content",
52
+ attributes: deepMerge(options.attributes, { type: "application/json" }),
53
+ position: options.position || "body",
54
+ ...options
55
+ };
56
+ }
57
+ static createContentStylesheet(options) {
58
+ return {
59
+ kind: "stylesheet",
60
+ source: "content",
61
+ position: "head",
62
+ ...options
63
+ };
64
+ }
65
+ static createInlineContentStylesheet(options) {
66
+ return {
67
+ ...AssetFactory.createContentStylesheet(options),
68
+ inline: true
69
+ };
70
+ }
71
+ static createFileStylesheet(options) {
72
+ return {
73
+ kind: "stylesheet",
74
+ source: "file",
75
+ position: options.position || "head",
76
+ ...options
77
+ };
78
+ }
79
+ }
80
+ export {
81
+ AssetFactory
82
+ };
@@ -0,0 +1,89 @@
1
+ import type { EcoBuildPlugin } from '../../../build/build-types.js';
2
+ export type AssetSource = 'content' | 'file' | 'node-module';
3
+ export type AssetKind = 'script' | 'stylesheet';
4
+ export type AssetPosition = 'head' | 'body';
5
+ export interface BaseAsset {
6
+ kind: AssetKind;
7
+ source: AssetSource;
8
+ attributes?: Record<string, string>;
9
+ position?: AssetPosition;
10
+ }
11
+ export interface ScriptAsset extends BaseAsset {
12
+ kind: 'script';
13
+ inline?: boolean;
14
+ bundle?: boolean;
15
+ bundleOptions?: {
16
+ define?: Record<string, string>;
17
+ minify?: boolean;
18
+ external?: string[];
19
+ naming?: string;
20
+ plugins?: EcoBuildPlugin[];
21
+ };
22
+ /**
23
+ * Whether to exclude this asset from the HTML output.
24
+ * @default false
25
+ */
26
+ excludeFromHtml?: boolean;
27
+ }
28
+ export interface StylesheetAsset extends BaseAsset {
29
+ kind: 'stylesheet';
30
+ inline?: boolean;
31
+ }
32
+ export interface ContentScriptAsset extends ScriptAsset {
33
+ source: 'content';
34
+ content: string;
35
+ name?: string;
36
+ }
37
+ export interface InlineContentScriptAsset extends ContentScriptAsset {
38
+ inline: true;
39
+ }
40
+ export interface ContentStylesheetAsset extends StylesheetAsset {
41
+ source: 'content';
42
+ content: string;
43
+ }
44
+ export interface InlineContentStylesheetAsset extends ContentStylesheetAsset {
45
+ inline: true;
46
+ }
47
+ export interface FileScriptAsset extends ScriptAsset {
48
+ source: 'file';
49
+ filepath: string;
50
+ name?: string;
51
+ }
52
+ export interface InlineFileScriptAsset extends FileScriptAsset {
53
+ inline: true;
54
+ }
55
+ export interface FileStylesheetAsset extends StylesheetAsset {
56
+ source: 'file';
57
+ filepath: string;
58
+ name?: string;
59
+ }
60
+ export interface InlineFileStylesheetAsset extends FileStylesheetAsset {
61
+ inline: true;
62
+ }
63
+ export interface NodeModuleScriptAsset extends ScriptAsset {
64
+ kind: 'script';
65
+ source: 'node-module';
66
+ importPath: string;
67
+ name?: string;
68
+ }
69
+ export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
70
+ inline: true;
71
+ }
72
+ export interface InlineNodeModuleScriptAsset extends NodeModuleScriptAsset {
73
+ inline: true;
74
+ }
75
+ export interface JsonScriptAsset extends ScriptAsset {
76
+ source: 'content';
77
+ content: string;
78
+ }
79
+ export type ProcessedAsset = {
80
+ filepath?: string;
81
+ srcUrl?: string;
82
+ content?: string;
83
+ kind: AssetKind;
84
+ position?: AssetPosition;
85
+ attributes?: Record<string, string>;
86
+ inline?: boolean;
87
+ excludeFromHtml?: boolean;
88
+ };
89
+ export type AssetDefinition = ContentScriptAsset | FileScriptAsset | NodeModuleScriptAsset | JsonScriptAsset | ContentStylesheetAsset | FileStylesheetAsset;
@@ -0,0 +1,55 @@
1
+ import type { EcoBuildPlugin } from '../../../build/build-types.js';
2
+ import type { AssetDefinition } from './assets.types.js';
3
+ import { type BrowserRuntimeEntryModuleConfig } from './browser-runtime-entry.factory.js';
4
+ export declare const BROWSER_RUNTIME_SCRIPT_ATTRIBUTES: {
5
+ readonly type: "module";
6
+ readonly defer: "";
7
+ };
8
+ /**
9
+ * Builds the public vendor URL used for generated browser runtime assets.
10
+ */
11
+ export declare function buildBrowserRuntimeAssetUrl(fileName: string): string;
12
+ /**
13
+ * Declares a browser runtime script asset backed by one importable module.
14
+ *
15
+ * @remarks
16
+ * Runtime assets are emitted as excluded head scripts because integrations often
17
+ * need the bundler output and specifier registration without injecting the raw
18
+ * asset directly into HTML during dependency resolution.
19
+ */
20
+ export declare function createBrowserRuntimeScriptAsset(options: {
21
+ importPath: string;
22
+ name: string;
23
+ fileName: string;
24
+ bundleOptions?: {
25
+ define?: Record<string, string>;
26
+ minify?: boolean;
27
+ external?: string[];
28
+ naming?: string;
29
+ plugins?: EcoBuildPlugin[];
30
+ };
31
+ attributes?: Record<string, string>;
32
+ }): AssetDefinition;
33
+ /**
34
+ * Creates a browser runtime asset from a generated re-export entry module.
35
+ *
36
+ * @remarks
37
+ * This is the shared "module list -> generated entry file -> runtime asset"
38
+ * path used by integrations that need browser-side runtime bundles without
39
+ * owning bespoke entry-file generation logic.
40
+ */
41
+ export declare function createBrowserRuntimeModuleAsset(options: {
42
+ modules: BrowserRuntimeEntryModuleConfig[];
43
+ name: string;
44
+ fileName: string;
45
+ cacheDirName?: string;
46
+ rootDir?: string;
47
+ bundleOptions?: {
48
+ define?: Record<string, string>;
49
+ minify?: boolean;
50
+ external?: string[];
51
+ naming?: string;
52
+ plugins?: EcoBuildPlugin[];
53
+ };
54
+ attributes?: Record<string, string>;
55
+ }): AssetDefinition;
@@ -0,0 +1,48 @@
1
+ import { AssetFactory } from "./asset.factory.js";
2
+ import {
3
+ createBrowserRuntimeEntryModule
4
+ } from "./browser-runtime-entry.factory.js";
5
+ const BROWSER_RUNTIME_SCRIPT_ATTRIBUTES = {
6
+ type: "module",
7
+ defer: ""
8
+ };
9
+ function buildBrowserRuntimeAssetUrl(fileName) {
10
+ return `/${AssetFactory.RESOLVED_ASSETS_VENDORS_DIR}/${fileName}`;
11
+ }
12
+ function createBrowserRuntimeScriptAsset(options) {
13
+ return AssetFactory.createNodeModuleScript({
14
+ position: "head",
15
+ importPath: options.importPath,
16
+ name: options.name,
17
+ excludeFromHtml: true,
18
+ bundleOptions: {
19
+ naming: options.fileName,
20
+ ...options.bundleOptions
21
+ },
22
+ attributes: {
23
+ ...BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
24
+ ...options.attributes ?? {}
25
+ }
26
+ });
27
+ }
28
+ function createBrowserRuntimeModuleAsset(options) {
29
+ const importPath = createBrowserRuntimeEntryModule({
30
+ modules: options.modules,
31
+ fileName: `${options.name}-entry.mjs`,
32
+ rootDir: options.rootDir,
33
+ cacheDirName: options.cacheDirName
34
+ });
35
+ return createBrowserRuntimeScriptAsset({
36
+ importPath,
37
+ name: options.name,
38
+ fileName: options.fileName,
39
+ bundleOptions: options.bundleOptions,
40
+ attributes: options.attributes
41
+ });
42
+ }
43
+ export {
44
+ BROWSER_RUNTIME_SCRIPT_ATTRIBUTES,
45
+ buildBrowserRuntimeAssetUrl,
46
+ createBrowserRuntimeModuleAsset,
47
+ createBrowserRuntimeScriptAsset
48
+ };
@@ -0,0 +1,20 @@
1
+ export type BrowserRuntimeEntryModuleConfig = {
2
+ specifier: string;
3
+ defaultExport?: boolean;
4
+ };
5
+ /**
6
+ * Creates a generated ESM entry module that re-exports runtime modules through
7
+ * one stable file.
8
+ *
9
+ * @remarks
10
+ * Integrations use this helper when they need a browser runtime asset composed
11
+ * from multiple bare specifiers but do not want to own temporary file assembly
12
+ * logic themselves. The generated file lives under a cache directory inside the
13
+ * consuming app root so repeated runs can reuse the same location.
14
+ */
15
+ export declare function createBrowserRuntimeEntryModule(options: {
16
+ modules: BrowserRuntimeEntryModuleConfig[];
17
+ fileName: string;
18
+ rootDir?: string;
19
+ cacheDirName?: string;
20
+ }): string;
@@ -0,0 +1,41 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { createRequire } from "node:module";
4
+ function createBrowserRuntimeEntryModule(options) {
5
+ const rootDir = options.rootDir ?? process.cwd();
6
+ const artifactsDir = path.join(
7
+ rootDir,
8
+ "node_modules",
9
+ ".cache",
10
+ options.cacheDirName ?? "ecopages-browser-runtime"
11
+ );
12
+ fs.mkdirSync(artifactsDir, { recursive: true });
13
+ const requireFromRoot = createRequire(path.join(rootDir, "package.json"));
14
+ const seenExports = /* @__PURE__ */ new Set();
15
+ const statements = [];
16
+ for (const module of options.modules) {
17
+ if (module.defaultExport) {
18
+ statements.push(`import __ecopages_default_export__ from '${module.specifier}';`);
19
+ statements.push("export default __ecopages_default_export__;");
20
+ }
21
+ const exportNames = getModuleExportNames(module.specifier, requireFromRoot).filter(
22
+ (name) => !seenExports.has(name)
23
+ );
24
+ if (exportNames.length > 0) {
25
+ statements.push(`export { ${exportNames.join(", ")} } from '${module.specifier}';`);
26
+ for (const exportName of exportNames) {
27
+ seenExports.add(exportName);
28
+ }
29
+ }
30
+ }
31
+ const filePath = path.join(artifactsDir, options.fileName);
32
+ fs.writeFileSync(filePath, statements.join("\n"), "utf-8");
33
+ return filePath;
34
+ }
35
+ function getModuleExportNames(specifier, requireFromRoot) {
36
+ const moduleExports = requireFromRoot(specifier);
37
+ return Object.keys(moduleExports).filter((name) => name !== "__esModule" && name !== "default").filter((name) => /^[$A-Z_a-z][$\w]*$/.test(name)).sort();
38
+ }
39
+ export {
40
+ createBrowserRuntimeEntryModule
41
+ };
@@ -0,0 +1,5 @@
1
+ export * from './asset.factory';
2
+ export * from './asset-processing.service';
3
+ export * from './assets.types';
4
+ export * from './browser-runtime-asset.factory';
5
+ export * from './browser-runtime-entry.factory';