@ecopages/core 0.2.0-alpha.3 → 0.2.0-alpha.30
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.
- package/CHANGELOG.md +66 -66
- package/README.md +268 -14
- package/package.json +72 -108
- package/src/adapters/README.md +39 -0
- package/src/adapters/abstract/application-adapter.d.ts +28 -2
- package/src/adapters/abstract/application-adapter.js +14 -2
- package/src/adapters/abstract/router-adapter.d.ts +1 -1
- package/src/adapters/abstract/server-adapter.d.ts +2 -2
- package/src/adapters/bun/client-bridge.d.ts +1 -1
- package/src/adapters/bun/create-app.d.ts +5 -12
- package/src/adapters/bun/create-app.js +43 -7
- package/src/adapters/bun/hmr-manager.d.ts +72 -26
- package/src/adapters/bun/hmr-manager.js +153 -81
- package/src/adapters/bun/index.d.ts +2 -3
- package/src/adapters/bun/index.js +3 -3
- package/src/adapters/bun/server-adapter.d.ts +5 -5
- package/src/adapters/bun/server-adapter.js +63 -38
- package/src/adapters/bun/server-lifecycle.d.ts +28 -17
- package/src/adapters/bun/server-lifecycle.js +34 -62
- package/src/{create-app.d.ts → adapters/create-app.d.ts} +9 -6
- package/src/{create-app.js → adapters/create-app.js} +4 -4
- package/src/adapters/index.d.ts +2 -6
- package/src/adapters/index.js +2 -8
- package/src/adapters/node/create-app.d.ts +6 -9
- package/src/adapters/node/create-app.js +12 -6
- package/src/adapters/node/node-client-bridge.d.ts +1 -1
- package/src/adapters/node/node-hmr-manager.d.ts +79 -21
- package/src/adapters/node/node-hmr-manager.js +167 -114
- package/src/adapters/node/server-adapter.d.ts +7 -35
- package/src/adapters/node/server-adapter.js +55 -107
- package/src/adapters/node/static-content-server.d.ts +37 -1
- package/src/adapters/node/static-content-server.js +29 -1
- package/src/adapters/shared/application-adapter.d.ts +1 -1
- package/src/{define-api-handler.d.ts → adapters/shared/define-api-handler.d.ts} +1 -1
- package/src/adapters/shared/explicit-static-render-preparation.d.ts +25 -0
- package/src/adapters/shared/explicit-static-render-preparation.js +26 -0
- package/src/adapters/shared/explicit-static-route-matcher.d.ts +7 -4
- package/src/adapters/shared/explicit-static-route-matcher.js +14 -13
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +7 -10
- package/src/adapters/shared/file-route-middleware-pipeline.js +3 -11
- package/src/adapters/shared/fs-server-response-factory.d.ts +14 -10
- package/src/adapters/shared/fs-server-response-factory.js +11 -27
- package/src/adapters/shared/fs-server-response-matcher.d.ts +20 -16
- package/src/adapters/shared/fs-server-response-matcher.js +76 -45
- package/src/adapters/shared/hmr-entrypoint-registrar.d.ts +55 -0
- package/src/adapters/shared/hmr-entrypoint-registrar.js +87 -0
- package/src/adapters/shared/hmr-html-response.d.ts +22 -0
- package/src/adapters/shared/hmr-html-response.js +32 -0
- package/src/adapters/shared/render-context.d.ts +4 -3
- package/src/adapters/shared/render-context.js +6 -3
- package/src/adapters/shared/runtime-bootstrap.d.ts +38 -0
- package/src/adapters/shared/runtime-bootstrap.js +43 -0
- package/src/adapters/shared/server-adapter.d.ts +33 -12
- package/src/adapters/shared/server-adapter.js +208 -132
- package/src/adapters/shared/server-route-handler.d.ts +5 -5
- package/src/adapters/shared/server-route-handler.js +7 -16
- package/src/adapters/shared/server-static-builder.d.ts +41 -8
- package/src/adapters/shared/server-static-builder.js +65 -11
- package/src/build/README.md +107 -0
- package/src/build/build-adapter.d.ts +168 -3
- package/src/build/build-adapter.js +604 -16
- package/src/build/build-manifest.d.ts +27 -0
- package/src/build/build-manifest.js +30 -0
- package/src/build/dev-build-coordinator.d.ts +72 -0
- package/src/build/dev-build-coordinator.js +154 -0
- package/src/build/esbuild-build-adapter.d.ts +15 -6
- package/src/build/esbuild-build-adapter.js +189 -74
- package/src/build/runtime-build-executor.d.ts +14 -0
- package/src/build/runtime-build-executor.js +22 -0
- package/src/build/runtime-specifier-alias-plugin.d.ts +15 -0
- package/src/build/runtime-specifier-alias-plugin.js +35 -0
- package/src/build/runtime-specifier-aliases.d.ts +5 -0
- package/src/build/runtime-specifier-aliases.js +95 -0
- package/src/config/README.md +36 -0
- package/src/config/config-builder.d.ts +54 -29
- package/src/config/config-builder.js +255 -49
- package/src/{constants.d.ts → config/constants.d.ts} +13 -0
- package/src/{constants.js → config/constants.js} +4 -0
- package/src/declarations.d.ts +19 -14
- package/src/dev/host-runtime.d.ts +10 -0
- package/src/dev/host-runtime.js +24 -0
- package/src/dev/sc-server.d.ts +1 -1
- package/src/dev/sc-server.js +1 -1
- package/src/eco/README.md +70 -16
- package/src/eco/eco.browser.d.ts +2 -0
- package/src/eco/eco.browser.js +83 -0
- package/src/eco/eco.js +32 -57
- package/src/eco/eco.types.d.ts +14 -6
- package/src/eco/eco.utils.d.ts +1 -40
- package/src/eco/eco.utils.js +5 -35
- package/src/eco/global-injector-map.d.ts +3 -3
- package/src/eco/global-injector-map.js +2 -2
- package/src/eco/lazy-injector-map.d.ts +2 -2
- package/src/errors/index.d.ts +1 -0
- package/src/errors/index.js +3 -1
- package/src/hmr/README.md +26 -0
- package/src/hmr/client/hmr-runtime.d.ts +1 -6
- package/src/hmr/client/hmr-runtime.js +38 -7
- package/src/hmr/hmr-strategy.d.ts +16 -13
- package/src/hmr/hmr-strategy.js +22 -7
- package/src/hmr/hmr.postcss.test.e2e.d.ts +1 -0
- package/src/hmr/hmr.postcss.test.e2e.js +31 -0
- package/src/hmr/hmr.test.e2e.js +26 -33
- package/src/hmr/strategies/default-hmr-strategy.d.ts +2 -2
- package/src/hmr/strategies/default-hmr-strategy.js +1 -1
- package/src/hmr/strategies/js-hmr-strategy.d.ts +46 -48
- package/src/hmr/strategies/js-hmr-strategy.js +64 -74
- package/src/index.browser.d.ts +2 -2
- package/src/index.browser.js +1 -1
- package/src/index.d.ts +4 -3
- package/src/index.js +16 -5
- package/src/integrations/ghtml/ghtml-renderer.d.ts +3 -2
- package/src/integrations/ghtml/ghtml-renderer.js +27 -30
- package/src/integrations/ghtml/ghtml.constants.d.ts +1 -0
- package/src/integrations/ghtml/ghtml.constants.js +4 -0
- package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -6
- package/src/integrations/ghtml/ghtml.plugin.js +3 -4
- package/src/plugins/README.md +35 -0
- package/src/plugins/alias-resolver-plugin.js +17 -3
- package/src/plugins/eco-component-meta-plugin.d.ts +14 -1
- package/src/plugins/eco-component-meta-plugin.js +27 -22
- package/src/plugins/foreign-jsx-override-plugin.d.ts +31 -0
- package/src/plugins/foreign-jsx-override-plugin.js +35 -0
- package/src/plugins/integration-plugin.d.ts +142 -29
- package/src/plugins/integration-plugin.js +103 -14
- package/src/plugins/processor.d.ts +17 -2
- package/src/plugins/processor.js +22 -3
- package/src/plugins/runtime-capability.d.ts +9 -0
- package/src/plugins/source-transform.d.ts +46 -0
- package/src/plugins/source-transform.js +71 -0
- package/src/route-renderer/GRAPH.md +83 -325
- package/src/route-renderer/README.md +73 -90
- package/src/route-renderer/orchestration/component-render-context.d.ts +89 -0
- package/src/route-renderer/orchestration/component-render-context.js +147 -0
- package/src/route-renderer/orchestration/declared-ownership-graph.d.ts +18 -0
- package/src/route-renderer/orchestration/declared-ownership-graph.js +34 -0
- package/src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts +108 -0
- package/src/route-renderer/orchestration/foreign-subtree-execution.service.js +206 -0
- package/src/route-renderer/orchestration/integration-renderer.d.ts +516 -0
- package/src/route-renderer/orchestration/integration-renderer.js +909 -0
- package/src/route-renderer/orchestration/ownership-planning.service.d.ts +24 -0
- package/src/route-renderer/orchestration/ownership-planning.service.js +63 -0
- package/src/route-renderer/orchestration/ownership-validation.service.d.ts +29 -0
- package/src/route-renderer/orchestration/ownership-validation.service.js +53 -0
- package/src/route-renderer/orchestration/processed-asset-dedupe.d.ts +2 -0
- package/src/route-renderer/orchestration/processed-asset-dedupe.js +23 -0
- package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.d.ts +90 -0
- package/src/route-renderer/orchestration/queued-foreign-subtree-resolution.service.js +158 -0
- package/src/route-renderer/orchestration/render-output.utils.d.ts +66 -0
- package/src/route-renderer/orchestration/render-output.utils.js +171 -0
- package/src/route-renderer/orchestration/route-render-orchestrator.d.ts +120 -0
- package/src/route-renderer/orchestration/route-render-orchestrator.js +388 -0
- package/src/route-renderer/orchestration/template-serialization.d.ts +38 -0
- package/src/route-renderer/orchestration/template-serialization.js +45 -0
- package/src/route-renderer/page-loading/component-dependency-collection.d.ts +37 -0
- package/src/route-renderer/page-loading/component-dependency-collection.js +132 -0
- package/src/route-renderer/page-loading/declared-asset-collection.d.ts +24 -0
- package/src/route-renderer/page-loading/declared-asset-collection.js +106 -0
- package/src/route-renderer/{dependency-resolver.d.ts → page-loading/dependency-resolver.d.ts} +15 -4
- package/src/route-renderer/page-loading/dependency-resolver.js +115 -0
- package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts +11 -0
- package/src/route-renderer/page-loading/ecopages-virtual-imports.js +57 -0
- package/src/route-renderer/page-loading/lazy-entry-collection.d.ts +45 -0
- package/src/route-renderer/page-loading/lazy-entry-collection.js +105 -0
- package/src/route-renderer/page-loading/lazy-trigger-planning.d.ts +19 -0
- package/src/route-renderer/page-loading/lazy-trigger-planning.js +40 -0
- package/src/route-renderer/page-loading/module-declaration-aggregation.d.ts +5 -0
- package/src/route-renderer/page-loading/module-declaration-aggregation.js +33 -0
- package/src/route-renderer/page-loading/module-declaration-scripts.d.ts +3 -0
- package/src/route-renderer/page-loading/module-declaration-scripts.js +18 -0
- package/src/route-renderer/page-loading/page-dependency-bundling.d.ts +13 -0
- package/src/route-renderer/page-loading/page-dependency-bundling.js +137 -0
- package/src/route-renderer/page-loading/page-module-loader.d.ts +90 -0
- package/src/route-renderer/{page-module-loader.js → page-loading/page-module-loader.js} +39 -14
- package/src/route-renderer/route-renderer.d.ts +57 -14
- package/src/route-renderer/route-renderer.js +30 -18
- package/src/router/README.md +94 -0
- package/src/router/client/link-intent.d.ts +53 -0
- package/src/router/client/link-intent.js +34 -0
- package/src/router/client/link-intent.test.browser.d.ts +1 -0
- package/src/router/client/link-intent.test.browser.js +43 -0
- package/src/router/client/navigation-coordinator.d.ts +169 -0
- package/src/router/client/navigation-coordinator.js +215 -0
- package/src/router/server/route-registry.d.ts +78 -0
- package/src/router/server/route-registry.js +262 -0
- package/src/services/README.md +28 -0
- package/src/services/assets/asset-processing-service/asset-dependency-keys.d.ts +3 -0
- package/src/services/assets/asset-processing-service/asset-dependency-keys.js +56 -0
- package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +103 -0
- package/src/services/{asset-processing-service → assets/asset-processing-service}/asset-processing.service.js +124 -89
- package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.d.ts +1 -1
- package/src/services/{asset-processing-service → assets/asset-processing-service}/asset.factory.js +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.d.ts +16 -1
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts +55 -0
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.js +49 -0
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.d.ts +20 -0
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.js +41 -0
- package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts +30 -0
- package/src/services/assets/asset-processing-service/grouped-content-bundles.js +65 -0
- package/src/services/assets/asset-processing-service/index.d.ts +6 -0
- package/src/services/assets/asset-processing-service/index.js +6 -0
- package/src/services/assets/asset-processing-service/page-package.d.ts +3 -0
- package/src/services/assets/asset-processing-service/page-package.js +74 -0
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.d.ts +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.d.ts +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.d.ts +1 -1
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-processor.js +11 -5
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +22 -0
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +136 -0
- package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -0
- package/src/services/assets/asset-processing-service/processors/index.js +5 -0
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts +3 -2
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +119 -0
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts +4 -3
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js +28 -7
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts +3 -3
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js +12 -7
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts +5 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +59 -0
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
- package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js +9 -3
- package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts +18 -0
- package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js +45 -0
- package/src/services/assets/browser-bundle.service.d.ts +73 -0
- package/src/services/assets/browser-bundle.service.js +41 -0
- package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts} +2 -2
- package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js} +3 -1
- package/src/services/html/html-rewriter-provider.service.d.ts +37 -0
- package/src/services/html/html-rewriter-provider.service.js +68 -0
- package/src/services/html/html-transformer.service.d.ts +87 -0
- package/src/services/html/html-transformer.service.js +216 -0
- package/src/services/invalidation/development-invalidation.service.d.ts +74 -0
- package/src/services/invalidation/development-invalidation.service.js +190 -0
- package/src/services/module-loading/app-module-loader.service.d.ts +7 -0
- package/src/services/module-loading/app-server-module-transpiler.service.d.ts +24 -0
- package/src/services/module-loading/app-server-module-transpiler.service.js +115 -0
- package/src/services/module-loading/host-module-loader-registry.d.ts +4 -0
- package/src/services/module-loading/host-module-loader-registry.js +15 -0
- package/src/services/module-loading/module-loading-types.d.ts +2 -0
- package/src/services/module-loading/module-loading-types.js +0 -0
- package/src/services/module-loading/node-bootstrap-plugin.d.ts +42 -0
- package/src/services/module-loading/node-bootstrap-plugin.js +216 -0
- package/src/services/module-loading/page-module-import.service.d.ts +76 -0
- package/src/services/module-loading/page-module-import.service.js +170 -0
- package/src/services/module-loading/server-module-transpiler.service.d.ts +63 -0
- package/src/services/module-loading/server-module-transpiler.service.js +64 -0
- package/src/services/module-loading/source-module-support.d.ts +5 -0
- package/src/services/module-loading/source-module-support.js +8 -0
- package/src/services/runtime-state/dev-graph.service.d.ts +118 -0
- package/src/services/runtime-state/dev-graph.service.js +162 -0
- package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +41 -0
- package/src/services/runtime-state/entrypoint-dependency-graph.service.js +85 -0
- package/src/services/runtime-state/server-invalidation-state.service.d.ts +26 -0
- package/src/services/runtime-state/server-invalidation-state.service.js +35 -0
- package/src/services/{schema-validation-service.d.ts → validation/schema-validation-service.d.ts} +1 -1
- package/src/static-site-generator/README.md +26 -0
- package/src/static-site-generator/static-site-generator.d.ts +67 -20
- package/src/static-site-generator/static-site-generator.js +182 -138
- package/src/{internal-types.d.ts → types/internal-types.d.ts} +62 -30
- package/src/types/internal-types.js +0 -0
- package/src/{public-types.d.ts → types/public-types.d.ts} +201 -32
- package/src/types/public-types.js +0 -0
- package/src/utils/html-escaping.d.ts +7 -0
- package/src/utils/html-escaping.js +6 -0
- package/src/utils/locals-utils.d.ts +1 -1
- package/src/utils/parse-cli-args.d.ts +4 -1
- package/src/utils/parse-cli-args.js +16 -1
- package/src/utils/resolve-work-dir.d.ts +11 -0
- package/src/utils/resolve-work-dir.js +31 -0
- package/src/watchers/project-watcher.d.ts +40 -29
- package/src/watchers/project-watcher.js +126 -116
- package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
- package/src/watchers/project-watcher.test-helpers.js +6 -6
- package/src/adapters/abstract/application-adapter.ts +0 -337
- package/src/adapters/abstract/router-adapter.ts +0 -30
- package/src/adapters/abstract/server-adapter.ts +0 -79
- package/src/adapters/bun/client-bridge.ts +0 -62
- package/src/adapters/bun/create-app.ts +0 -189
- package/src/adapters/bun/define-api-handler.d.ts +0 -61
- package/src/adapters/bun/define-api-handler.ts +0 -114
- package/src/adapters/bun/hmr-manager.ts +0 -296
- package/src/adapters/bun/index.ts +0 -3
- package/src/adapters/bun/server-adapter.ts +0 -492
- package/src/adapters/bun/server-lifecycle.ts +0 -154
- package/src/adapters/index.ts +0 -6
- package/src/adapters/node/create-app.ts +0 -179
- package/src/adapters/node/index.d.ts +0 -4
- package/src/adapters/node/index.js +0 -8
- package/src/adapters/node/index.ts +0 -9
- package/src/adapters/node/node-client-bridge.ts +0 -79
- package/src/adapters/node/node-hmr-manager.ts +0 -289
- package/src/adapters/node/server-adapter.ts +0 -561
- package/src/adapters/node/static-content-server.ts +0 -203
- package/src/adapters/shared/api-response.ts +0 -104
- package/src/adapters/shared/application-adapter.ts +0 -199
- package/src/adapters/shared/explicit-static-route-matcher.ts +0 -134
- package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -123
- package/src/adapters/shared/fs-server-response-factory.ts +0 -118
- package/src/adapters/shared/fs-server-response-matcher.ts +0 -198
- package/src/adapters/shared/render-context.ts +0 -105
- package/src/adapters/shared/server-adapter.ts +0 -442
- package/src/adapters/shared/server-route-handler.ts +0 -166
- package/src/adapters/shared/server-static-builder.ts +0 -82
- package/src/build/build-adapter.ts +0 -132
- package/src/build/build-types.ts +0 -83
- package/src/build/esbuild-build-adapter.ts +0 -510
- package/src/config/config-builder.ts +0 -474
- package/src/constants.ts +0 -39
- package/src/create-app.ts +0 -87
- package/src/define-api-handler.js +0 -15
- package/src/define-api-handler.ts +0 -66
- package/src/dev/sc-server.ts +0 -143
- package/src/eco/component-render-context.d.ts +0 -105
- package/src/eco/component-render-context.js +0 -77
- package/src/eco/component-render-context.ts +0 -202
- package/src/eco/eco.ts +0 -221
- package/src/eco/eco.types.ts +0 -202
- package/src/eco/eco.utils.ts +0 -89
- package/src/eco/global-injector-map.ts +0 -112
- package/src/eco/lazy-injector-map.ts +0 -120
- package/src/eco/module-dependencies.ts +0 -75
- package/src/errors/http-error.ts +0 -72
- package/src/errors/index.ts +0 -2
- package/src/errors/locals-access-error.ts +0 -7
- package/src/global/app-logger.ts +0 -4
- 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
- package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-HMR-Server-Integration-should-load-fixture-app-page-1.png +0 -0
- package/src/hmr/client/__screenshots__/hmr-runtime.test.browser.ts/HMR-Runtime-WebSocket-Connection-should-connect-to-correct-HMR-endpoint-1.png +0 -0
- package/src/hmr/client/hmr-runtime.ts +0 -121
- package/src/hmr/hmr-strategy.ts +0 -172
- package/src/hmr/hmr.test.e2e.ts +0 -75
- package/src/hmr/strategies/default-hmr-strategy.ts +0 -60
- package/src/hmr/strategies/js-hmr-strategy.ts +0 -320
- package/src/index.browser.ts +0 -3
- package/src/index.ts +0 -5
- package/src/integrations/ghtml/ghtml-renderer.ts +0 -93
- package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
- package/src/internal-types.ts +0 -212
- package/src/plugins/alias-resolver-plugin.ts +0 -45
- package/src/plugins/eco-component-meta-plugin.ts +0 -474
- package/src/plugins/integration-plugin.ts +0 -184
- package/src/plugins/processor.ts +0 -220
- package/src/public-types.ts +0 -1260
- package/src/route-renderer/component-graph-executor.d.ts +0 -32
- package/src/route-renderer/component-graph-executor.js +0 -31
- package/src/route-renderer/component-graph-executor.ts +0 -84
- package/src/route-renderer/component-graph.d.ts +0 -42
- package/src/route-renderer/component-graph.js +0 -72
- package/src/route-renderer/component-graph.ts +0 -159
- package/src/route-renderer/component-marker.d.ts +0 -52
- package/src/route-renderer/component-marker.js +0 -46
- package/src/route-renderer/component-marker.ts +0 -117
- package/src/route-renderer/dependency-resolver.js +0 -428
- package/src/route-renderer/dependency-resolver.ts +0 -596
- package/src/route-renderer/html-post-processing.service.d.ts +0 -40
- package/src/route-renderer/html-post-processing.service.js +0 -86
- package/src/route-renderer/html-post-processing.service.ts +0 -103
- package/src/route-renderer/integration-renderer.d.ts +0 -339
- package/src/route-renderer/integration-renderer.js +0 -526
- package/src/route-renderer/integration-renderer.ts +0 -696
- package/src/route-renderer/marker-graph-resolver.d.ts +0 -76
- package/src/route-renderer/marker-graph-resolver.js +0 -93
- package/src/route-renderer/marker-graph-resolver.ts +0 -153
- package/src/route-renderer/page-module-loader.d.ts +0 -61
- package/src/route-renderer/page-module-loader.ts +0 -153
- package/src/route-renderer/render-execution.service.d.ts +0 -69
- package/src/route-renderer/render-execution.service.js +0 -91
- package/src/route-renderer/render-execution.service.ts +0 -158
- package/src/route-renderer/render-preparation.service.d.ts +0 -112
- package/src/route-renderer/render-preparation.service.js +0 -243
- package/src/route-renderer/render-preparation.service.ts +0 -358
- package/src/route-renderer/route-renderer.ts +0 -80
- package/src/router/fs-router-scanner.d.ts +0 -41
- package/src/router/fs-router-scanner.js +0 -155
- package/src/router/fs-router-scanner.ts +0 -217
- package/src/router/fs-router.d.ts +0 -26
- package/src/router/fs-router.js +0 -100
- package/src/router/fs-router.ts +0 -122
- package/src/services/asset-processing-service/asset-processing.service.d.ts +0 -41
- package/src/services/asset-processing-service/asset-processing.service.ts +0 -306
- package/src/services/asset-processing-service/asset.factory.ts +0 -105
- package/src/services/asset-processing-service/assets.types.ts +0 -112
- package/src/services/asset-processing-service/index.d.ts +0 -3
- package/src/services/asset-processing-service/index.js +0 -3
- package/src/services/asset-processing-service/index.ts +0 -3
- package/src/services/asset-processing-service/processor.interface.ts +0 -27
- package/src/services/asset-processing-service/processor.registry.ts +0 -18
- package/src/services/asset-processing-service/processors/base/base-processor.ts +0 -76
- package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +0 -16
- package/src/services/asset-processing-service/processors/base/base-script-processor.js +0 -80
- package/src/services/asset-processing-service/processors/base/base-script-processor.ts +0 -105
- package/src/services/asset-processing-service/processors/index.d.ts +0 -5
- package/src/services/asset-processing-service/processors/index.js +0 -5
- package/src/services/asset-processing-service/processors/index.ts +0 -5
- package/src/services/asset-processing-service/processors/script/content-script.processor.js +0 -57
- package/src/services/asset-processing-service/processors/script/content-script.processor.ts +0 -66
- package/src/services/asset-processing-service/processors/script/file-script.processor.ts +0 -88
- package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +0 -84
- package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +0 -25
- package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
- package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -77
- package/src/services/cache/cache.types.ts +0 -126
- package/src/services/cache/index.ts +0 -18
- package/src/services/cache/memory-cache-store.ts +0 -130
- package/src/services/cache/page-cache-service.ts +0 -202
- package/src/services/html-transformer.service.d.ts +0 -50
- package/src/services/html-transformer.service.js +0 -163
- package/src/services/html-transformer.service.ts +0 -217
- package/src/services/page-module-import.service.d.ts +0 -37
- package/src/services/page-module-import.service.js +0 -88
- package/src/services/page-module-import.service.ts +0 -129
- package/src/services/page-request-cache-coordinator.service.ts +0 -128
- package/src/services/schema-validation-service.ts +0 -204
- package/src/services/validation/standard-schema.types.ts +0 -68
- package/src/static-site-generator/static-site-generator.ts +0 -359
- package/src/utils/css.d.ts +0 -1
- package/src/utils/css.js +0 -7
- package/src/utils/css.ts +0 -5
- package/src/utils/deep-merge.ts +0 -47
- package/src/utils/hash.ts +0 -5
- package/src/utils/html.ts +0 -1
- package/src/utils/invariant.ts +0 -15
- package/src/utils/locals-utils.ts +0 -37
- package/src/utils/parse-cli-args.ts +0 -83
- package/src/utils/path-utils.module.ts +0 -14
- package/src/utils/runtime.ts +0 -44
- package/src/utils/server-utils.module.ts +0 -67
- package/src/watchers/project-watcher.test-helpers.ts +0 -41
- package/src/watchers/project-watcher.ts +0 -344
- /package/src/adapters/{bun → shared}/define-api-handler.js +0 -0
- /package/src/{internal-types.js → plugins/runtime-capability.js} +0 -0
- /package/src/services/{asset-processing-service → assets/asset-processing-service}/assets.types.js +0 -0
- /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.interface.js +0 -0
- /package/src/services/{asset-processing-service → assets/asset-processing-service}/processor.registry.js +0 -0
- /package/src/{public-types.js → services/module-loading/app-module-loader.service.js} +0 -0
- /package/src/services/{schema-validation-service.js → validation/schema-validation-service.js} +0 -0
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
import { buildInjectorMapScript } from "../../eco/lazy-injector-map.js";
|
|
2
|
+
function cloneTemplateStrings(strings, firstString) {
|
|
3
|
+
const nextStrings = [...strings];
|
|
4
|
+
nextStrings[0] = firstString;
|
|
5
|
+
const rawDescriptor = Object.getOwnPropertyDescriptor(strings, "raw");
|
|
6
|
+
if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
|
|
7
|
+
const rawStrings = [...rawDescriptor.value];
|
|
8
|
+
rawStrings[0] = firstString;
|
|
9
|
+
Object.defineProperty(nextStrings, "raw", {
|
|
10
|
+
...rawDescriptor,
|
|
11
|
+
value: rawStrings
|
|
12
|
+
});
|
|
13
|
+
}
|
|
14
|
+
return nextStrings;
|
|
15
|
+
}
|
|
16
|
+
function cloneTemplateContentWithUpdatedFirstString(content, firstString) {
|
|
17
|
+
const descriptors = Object.getOwnPropertyDescriptors(content);
|
|
18
|
+
const clonedContent = Object.create(Object.getPrototypeOf(content));
|
|
19
|
+
const stringsDescriptor = descriptors.strings;
|
|
20
|
+
Object.defineProperties(clonedContent, {
|
|
21
|
+
...descriptors,
|
|
22
|
+
strings: {
|
|
23
|
+
...stringsDescriptor,
|
|
24
|
+
value: cloneTemplateStrings(content.strings, firstString)
|
|
25
|
+
}
|
|
26
|
+
});
|
|
27
|
+
return clonedContent;
|
|
28
|
+
}
|
|
29
|
+
function cloneMarkupNodeLikeWithUpdatedOuterHtml(content, outerHTML) {
|
|
30
|
+
const descriptors = Object.getOwnPropertyDescriptors(content);
|
|
31
|
+
const clonedContent = Object.create(Object.getPrototypeOf(content));
|
|
32
|
+
const outerHTMLDescriptor = descriptors.outerHTML;
|
|
33
|
+
Object.defineProperties(clonedContent, {
|
|
34
|
+
...descriptors,
|
|
35
|
+
outerHTML: {
|
|
36
|
+
configurable: outerHTMLDescriptor?.configurable ?? true,
|
|
37
|
+
enumerable: outerHTMLDescriptor?.enumerable ?? true,
|
|
38
|
+
writable: true,
|
|
39
|
+
value: outerHTML
|
|
40
|
+
}
|
|
41
|
+
});
|
|
42
|
+
return clonedContent;
|
|
43
|
+
}
|
|
44
|
+
function wrapWithScriptsInjectorMarkup(content, injectorMapScript) {
|
|
45
|
+
return `<scripts-injector><script type="ecopages/injector-map">${injectorMapScript}<\/script>${content}<\/scripts-injector>`;
|
|
46
|
+
}
|
|
47
|
+
function cloneTemplateContentWithWrappedInjector(content, injectorMapScript) {
|
|
48
|
+
if (content.strings.length === 0) {
|
|
49
|
+
return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
|
|
50
|
+
}
|
|
51
|
+
const nextStrings = [...content.strings];
|
|
52
|
+
nextStrings[0] = wrapWithScriptsInjectorMarkup(nextStrings[0] ?? "", injectorMapScript);
|
|
53
|
+
nextStrings[nextStrings.length - 1] = `${nextStrings[nextStrings.length - 1] ?? ""}<\/scripts-injector>`;
|
|
54
|
+
const rawDescriptor = Object.getOwnPropertyDescriptor(content.strings, "raw");
|
|
55
|
+
if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
|
|
56
|
+
const rawStrings = [...rawDescriptor.value];
|
|
57
|
+
rawStrings[0] = wrapWithScriptsInjectorMarkup(rawStrings[0] ?? "", injectorMapScript);
|
|
58
|
+
rawStrings[rawStrings.length - 1] = `${rawStrings[rawStrings.length - 1] ?? ""}<\/scripts-injector>`;
|
|
59
|
+
Object.defineProperty(nextStrings, "raw", {
|
|
60
|
+
...rawDescriptor,
|
|
61
|
+
value: rawStrings
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
const descriptors = Object.getOwnPropertyDescriptors(content);
|
|
65
|
+
const clonedContent = Object.create(Object.getPrototypeOf(content));
|
|
66
|
+
const stringsDescriptor = descriptors.strings;
|
|
67
|
+
Object.defineProperties(clonedContent, {
|
|
68
|
+
...descriptors,
|
|
69
|
+
strings: {
|
|
70
|
+
...stringsDescriptor,
|
|
71
|
+
value: nextStrings
|
|
72
|
+
}
|
|
73
|
+
});
|
|
74
|
+
return clonedContent;
|
|
75
|
+
}
|
|
76
|
+
function isThenable(value) {
|
|
77
|
+
return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
|
|
78
|
+
}
|
|
79
|
+
function isTemplateContentShape(value) {
|
|
80
|
+
return typeof value === "object" && value !== null && Array.isArray(value.strings) && ((value.values ?? void 0) === void 0 || Array.isArray(value.values));
|
|
81
|
+
}
|
|
82
|
+
function isMarkupNodeLikeShape(value) {
|
|
83
|
+
return typeof value === "object" && value !== null && typeof value.nodeType === "number";
|
|
84
|
+
}
|
|
85
|
+
function injectTriggerAttributeIntoString(content, triggerId) {
|
|
86
|
+
const str = content;
|
|
87
|
+
let i = 0;
|
|
88
|
+
while (i < str.length) {
|
|
89
|
+
if (str[i] !== "<") {
|
|
90
|
+
i++;
|
|
91
|
+
continue;
|
|
92
|
+
}
|
|
93
|
+
const next = str[i + 1];
|
|
94
|
+
if (next === "!" || next === "?") {
|
|
95
|
+
const end = str.indexOf(">", i);
|
|
96
|
+
if (end === -1) break;
|
|
97
|
+
i = end + 1;
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
if (next && /[a-zA-Z]/.test(next)) {
|
|
101
|
+
const tagSlice = str.slice(i + 1);
|
|
102
|
+
const nameEnd = tagSlice.search(/[\s/>]/);
|
|
103
|
+
if (nameEnd === -1) break;
|
|
104
|
+
const insertAt = i + 1 + nameEnd;
|
|
105
|
+
return `${str.slice(0, insertAt)} data-eco-trigger="${triggerId}"${str.slice(insertAt)}`;
|
|
106
|
+
}
|
|
107
|
+
break;
|
|
108
|
+
}
|
|
109
|
+
return str;
|
|
110
|
+
}
|
|
111
|
+
function addTriggerAttribute(content, triggerId) {
|
|
112
|
+
if (isTemplateContentShape(content)) {
|
|
113
|
+
if (content.strings.length === 0) {
|
|
114
|
+
return String(content);
|
|
115
|
+
}
|
|
116
|
+
return cloneTemplateContentWithUpdatedFirstString(
|
|
117
|
+
content,
|
|
118
|
+
injectTriggerAttributeIntoString(content.strings[0] ?? "", triggerId)
|
|
119
|
+
);
|
|
120
|
+
}
|
|
121
|
+
if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === "string") {
|
|
122
|
+
return cloneMarkupNodeLikeWithUpdatedOuterHtml(
|
|
123
|
+
content,
|
|
124
|
+
injectTriggerAttributeIntoString(content.outerHTML, triggerId)
|
|
125
|
+
);
|
|
126
|
+
}
|
|
127
|
+
return injectTriggerAttributeIntoString(String(content), triggerId);
|
|
128
|
+
}
|
|
129
|
+
function wrapWithScriptsInjector(content, lazyGroups) {
|
|
130
|
+
const injectorMapScript = buildInjectorMapScript(lazyGroups ?? []);
|
|
131
|
+
if (isTemplateContentShape(content)) {
|
|
132
|
+
return cloneTemplateContentWithWrappedInjector(content, injectorMapScript);
|
|
133
|
+
}
|
|
134
|
+
if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === "string") {
|
|
135
|
+
return cloneMarkupNodeLikeWithUpdatedOuterHtml(
|
|
136
|
+
content,
|
|
137
|
+
wrapWithScriptsInjectorMarkup(content.outerHTML, injectorMapScript)
|
|
138
|
+
);
|
|
139
|
+
}
|
|
140
|
+
return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
|
|
141
|
+
}
|
|
142
|
+
function decodeHtmlEntities(value) {
|
|
143
|
+
let decoded = value;
|
|
144
|
+
let previous;
|
|
145
|
+
do {
|
|
146
|
+
previous = decoded;
|
|
147
|
+
decoded = decoded.replaceAll(""", '"').replaceAll("'", "'").replaceAll("'", "'").replaceAll("<", "<").replaceAll(">", ">").replaceAll("&", "&");
|
|
148
|
+
} while (decoded !== previous);
|
|
149
|
+
return decoded;
|
|
150
|
+
}
|
|
151
|
+
function normalizeUnresolvedMarkerArtifactHtml(html) {
|
|
152
|
+
return html.replace(
|
|
153
|
+
/&(?:amp;)?lt;eco-marker\b[\s\S]*?&(?:amp;)?gt;&(?:amp;)?lt;\/eco-marker&(?:amp;)?gt;/g,
|
|
154
|
+
(marker) => decodeHtmlEntities(marker)
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
function inspectUnresolvedMarkerArtifactHtml(html) {
|
|
158
|
+
const normalizedHtml = normalizeUnresolvedMarkerArtifactHtml(html);
|
|
159
|
+
return {
|
|
160
|
+
normalizedHtml,
|
|
161
|
+
hasUnresolvedMarkerArtifacts: normalizedHtml.includes("<eco-marker")
|
|
162
|
+
};
|
|
163
|
+
}
|
|
164
|
+
export {
|
|
165
|
+
addTriggerAttribute,
|
|
166
|
+
decodeHtmlEntities,
|
|
167
|
+
inspectUnresolvedMarkerArtifactHtml,
|
|
168
|
+
isThenable,
|
|
169
|
+
normalizeUnresolvedMarkerArtifactHtml,
|
|
170
|
+
wrapWithScriptsInjector
|
|
171
|
+
};
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import type { EcoPagesAppConfig } from '../../types/internal-types.js';
|
|
2
|
+
import type { ComponentRenderResult, EcoComponent, EcoPageComponent, EcoPageFile, HtmlTemplateProps, IntegrationRendererRenderOptions, PageBrowserGraphResult, PageMetadataProps, RouteRendererBody, RouteRendererOptions, RouteRenderResult } from '../../types/public-types.js';
|
|
3
|
+
import { type AssetProcessingService, type ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
|
|
4
|
+
import { OwnershipValidationService } from './ownership-validation.service.js';
|
|
5
|
+
import { OwnershipPlanningService } from './ownership-planning.service.js';
|
|
6
|
+
export type RouteRenderOrchestratorResolvedInputs = {
|
|
7
|
+
Page: EcoPageFile['default'] | EcoPageComponent<any>;
|
|
8
|
+
HtmlTemplate: EcoComponent<HtmlTemplateProps>;
|
|
9
|
+
Layout?: EcoComponent;
|
|
10
|
+
props: Record<string, unknown>;
|
|
11
|
+
metadata: PageMetadataProps;
|
|
12
|
+
integrationSpecificProps: Record<string, unknown>;
|
|
13
|
+
};
|
|
14
|
+
export type RouteRenderOrchestratorResolvedAssets = {
|
|
15
|
+
resolvedDependencies: ProcessedAsset[];
|
|
16
|
+
pageBrowserGraph?: PageBrowserGraphResult;
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Structural HTML work applied after the route body has been fully resolved.
|
|
20
|
+
*
|
|
21
|
+
* The shared route flow only needs to know whether a post-render HTML step
|
|
22
|
+
* exists. When `finalizeHtml` is absent, the captured body can be reused as-is.
|
|
23
|
+
*/
|
|
24
|
+
export type RouteHtmlFinalization = {
|
|
25
|
+
finalizeHtml?(html: string): string;
|
|
26
|
+
};
|
|
27
|
+
export interface RouteRenderOrchestratorAdapter<C> {
|
|
28
|
+
/**
|
|
29
|
+
* Name of the owning Integration for the current route render.
|
|
30
|
+
*/
|
|
31
|
+
readonly name: string;
|
|
32
|
+
/**
|
|
33
|
+
* Loads the Integration-owned route inputs needed for one Page render.
|
|
34
|
+
*/
|
|
35
|
+
resolveRouteRenderInputs(routeOptions: RouteRendererOptions): Promise<RouteRenderOrchestratorResolvedInputs>;
|
|
36
|
+
/**
|
|
37
|
+
* Resolves route-owned assets needed before Integration rendering starts.
|
|
38
|
+
*/
|
|
39
|
+
resolveRouteAssets(input: {
|
|
40
|
+
routeOptions: RouteRendererOptions;
|
|
41
|
+
components: (EcoComponent | Partial<EcoComponent>)[];
|
|
42
|
+
}): Promise<RouteRenderOrchestratorResolvedAssets>;
|
|
43
|
+
/**
|
|
44
|
+
* Resolves the optional page-root render through the foreign-child-aware component contract.
|
|
45
|
+
*/
|
|
46
|
+
resolveRoutePageComponentRender(input: {
|
|
47
|
+
Page: EcoComponent;
|
|
48
|
+
Layout?: EcoComponent;
|
|
49
|
+
props: Record<string, unknown>;
|
|
50
|
+
routeOptions: RouteRendererOptions;
|
|
51
|
+
}): Promise<ComponentRenderResult | undefined>;
|
|
52
|
+
/**
|
|
53
|
+
* Executes the Integration-specific route render.
|
|
54
|
+
*/
|
|
55
|
+
renderRouteBody(renderOptions: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
|
|
56
|
+
/**
|
|
57
|
+
* Returns the structural Html finalization plan for one prepared route render.
|
|
58
|
+
*/
|
|
59
|
+
getRouteHtmlFinalization(renderOptions: IntegrationRendererRenderOptions<C>): RouteHtmlFinalization;
|
|
60
|
+
/**
|
|
61
|
+
* Runs SSR-policy response transformation and returns the body value exposed to callers.
|
|
62
|
+
*/
|
|
63
|
+
transformRouteResponse(response: Response): Promise<RouteRendererBody>;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Captured route-render output in both replayable body and string HTML forms.
|
|
67
|
+
*/
|
|
68
|
+
export interface CapturedHtmlRenderResult {
|
|
69
|
+
body: RouteRendererBody;
|
|
70
|
+
html: string;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Optional app-scoped collaborators used by the route render orchestrator.
|
|
74
|
+
*/
|
|
75
|
+
export interface RouteRenderOrchestratorDependencies {
|
|
76
|
+
ownershipPlanningService?: OwnershipPlanningService;
|
|
77
|
+
ownershipValidationService?: OwnershipValidationService;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Owns one route render from normalized module loading through final HTML output.
|
|
81
|
+
*
|
|
82
|
+
* This orchestrator keeps route rendering as one app-scoped unit while still
|
|
83
|
+
* delegating integration-specific behavior through the adapter seam. It owns
|
|
84
|
+
* route-root validation, dependency aggregation, page package creation, and the
|
|
85
|
+
* final HTML/body handling that happens after the integration render returns.
|
|
86
|
+
*/
|
|
87
|
+
export declare class RouteRenderOrchestrator {
|
|
88
|
+
private readonly appConfig;
|
|
89
|
+
private readonly assetProcessingService;
|
|
90
|
+
private readonly ownershipPlanningService;
|
|
91
|
+
private readonly ownershipValidationService;
|
|
92
|
+
constructor(appConfig: EcoPagesAppConfig, assetProcessingService: AssetProcessingService, dependencies?: RouteRenderOrchestratorDependencies);
|
|
93
|
+
/**
|
|
94
|
+
* Builds normalized route render options before the integration render runs.
|
|
95
|
+
*
|
|
96
|
+
* This preparation step validates route-root ownership, resolves page data,
|
|
97
|
+
* collects processed assets, captures optional page-root render metadata, and
|
|
98
|
+
* produces the page package consumed by downstream HTML transformation.
|
|
99
|
+
*/
|
|
100
|
+
prepareRenderOptions<C = unknown>(routeOptions: RouteRendererOptions, adapter: RouteRenderOrchestratorAdapter<C>): Promise<IntegrationRendererRenderOptions<C>>;
|
|
101
|
+
/**
|
|
102
|
+
* Captures one route render body as HTML while preserving a replayable body value.
|
|
103
|
+
*/
|
|
104
|
+
captureHtmlRender(render: () => Promise<RouteRendererBody>): Promise<CapturedHtmlRenderResult>;
|
|
105
|
+
/**
|
|
106
|
+
* Executes the full route-render flow and returns the final body plus cache strategy.
|
|
107
|
+
*/
|
|
108
|
+
execute<C = unknown>(options: RouteRendererOptions, adapter: RouteRenderOrchestratorAdapter<C>): Promise<RouteRenderResult>;
|
|
109
|
+
/**
|
|
110
|
+
* Executes the route-render finalization path for already prepared render options.
|
|
111
|
+
*/
|
|
112
|
+
executePrepared<C = unknown>(renderOptions: IntegrationRendererRenderOptions<C>, adapter: RouteRenderOrchestratorAdapter<C>): Promise<RouteRenderResult>;
|
|
113
|
+
private captureRenderedBody;
|
|
114
|
+
private collectResolvedTriggers;
|
|
115
|
+
private collectUsedIntegrationDependencies;
|
|
116
|
+
private collectIntegrationNames;
|
|
117
|
+
private buildGlobalInjectorAssets;
|
|
118
|
+
private buildEagerSsrLazyAssets;
|
|
119
|
+
private collectEagerSsrLazyDependencies;
|
|
120
|
+
}
|
|
@@ -0,0 +1,388 @@
|
|
|
1
|
+
import { createRequire } from "node:module";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import {
|
|
4
|
+
AssetFactory,
|
|
5
|
+
createPagePackage
|
|
6
|
+
} from "../../services/assets/asset-processing-service/index.js";
|
|
7
|
+
import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from "../../eco/global-injector-map.js";
|
|
8
|
+
import { LocalsAccessError } from "../../errors/locals-access-error.js";
|
|
9
|
+
import { inspectUnresolvedMarkerArtifactHtml } from "./render-output.utils.js";
|
|
10
|
+
import { OwnershipValidationService } from "./ownership-validation.service.js";
|
|
11
|
+
import { OwnershipPlanningService } from "./ownership-planning.service.js";
|
|
12
|
+
import { dedupeProcessedAssets } from "./processed-asset-dedupe.js";
|
|
13
|
+
function createPageLocalsProxy(filePath) {
|
|
14
|
+
const errorMessage = `[ecopages] Request locals are only available during request-time rendering with cache: 'dynamic'. Page: ${filePath}. If you meant to use locals here, set cache: 'dynamic' and provide locals from route middleware/handlers.`;
|
|
15
|
+
return new Proxy(
|
|
16
|
+
{},
|
|
17
|
+
{
|
|
18
|
+
get: () => {
|
|
19
|
+
throw new LocalsAccessError(errorMessage);
|
|
20
|
+
},
|
|
21
|
+
set: () => {
|
|
22
|
+
throw new LocalsAccessError(errorMessage);
|
|
23
|
+
},
|
|
24
|
+
has: () => {
|
|
25
|
+
throw new LocalsAccessError(errorMessage);
|
|
26
|
+
},
|
|
27
|
+
ownKeys: () => {
|
|
28
|
+
throw new LocalsAccessError(errorMessage);
|
|
29
|
+
},
|
|
30
|
+
deleteProperty: () => {
|
|
31
|
+
throw new LocalsAccessError(errorMessage);
|
|
32
|
+
},
|
|
33
|
+
defineProperty: () => {
|
|
34
|
+
throw new LocalsAccessError(errorMessage);
|
|
35
|
+
},
|
|
36
|
+
getOwnPropertyDescriptor: () => {
|
|
37
|
+
throw new LocalsAccessError(errorMessage);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
);
|
|
41
|
+
}
|
|
42
|
+
class RouteRenderOrchestrator {
|
|
43
|
+
appConfig;
|
|
44
|
+
assetProcessingService;
|
|
45
|
+
ownershipPlanningService;
|
|
46
|
+
ownershipValidationService;
|
|
47
|
+
constructor(appConfig, assetProcessingService, dependencies = {}) {
|
|
48
|
+
this.appConfig = appConfig;
|
|
49
|
+
this.assetProcessingService = assetProcessingService;
|
|
50
|
+
this.ownershipPlanningService = dependencies.ownershipPlanningService ?? new OwnershipPlanningService();
|
|
51
|
+
this.ownershipValidationService = dependencies.ownershipValidationService ?? new OwnershipValidationService(appConfig);
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Builds normalized route render options before the integration render runs.
|
|
55
|
+
*
|
|
56
|
+
* This preparation step validates route-root ownership, resolves page data,
|
|
57
|
+
* collects processed assets, captures optional page-root render metadata, and
|
|
58
|
+
* produces the page package consumed by downstream HTML transformation.
|
|
59
|
+
*/
|
|
60
|
+
async prepareRenderOptions(routeOptions, adapter) {
|
|
61
|
+
const resolvedInputs = await adapter.resolveRouteRenderInputs(routeOptions);
|
|
62
|
+
const { Page, HtmlTemplate, Layout, props, metadata, integrationSpecificProps } = resolvedInputs;
|
|
63
|
+
const validationErrors = this.ownershipValidationService.validate({
|
|
64
|
+
currentIntegrationName: adapter.name,
|
|
65
|
+
roots: [
|
|
66
|
+
{ component: HtmlTemplate, source: "html-template" },
|
|
67
|
+
...Layout ? [{ component: Layout, source: "layout" }] : [],
|
|
68
|
+
{ component: Page, source: "page" }
|
|
69
|
+
]
|
|
70
|
+
});
|
|
71
|
+
const ownershipPlan = this.ownershipPlanningService.buildPlan({
|
|
72
|
+
routeFile: routeOptions.file,
|
|
73
|
+
currentIntegrationName: adapter.name,
|
|
74
|
+
HtmlTemplate,
|
|
75
|
+
Layout,
|
|
76
|
+
Page,
|
|
77
|
+
validationErrors
|
|
78
|
+
});
|
|
79
|
+
const componentsToResolve = Layout ? [HtmlTemplate, Layout, Page] : [HtmlTemplate, Page];
|
|
80
|
+
const { resolvedDependencies, pageBrowserGraph } = await adapter.resolveRouteAssets({
|
|
81
|
+
routeOptions,
|
|
82
|
+
components: componentsToResolve
|
|
83
|
+
});
|
|
84
|
+
const usedIntegrationDependencies = this.collectUsedIntegrationDependencies(componentsToResolve, adapter.name);
|
|
85
|
+
const allDependencies = [
|
|
86
|
+
...resolvedDependencies,
|
|
87
|
+
...usedIntegrationDependencies,
|
|
88
|
+
...pageBrowserGraph?.assets ?? []
|
|
89
|
+
];
|
|
90
|
+
const componentRender = await adapter.resolveRoutePageComponentRender({
|
|
91
|
+
Page,
|
|
92
|
+
Layout,
|
|
93
|
+
props,
|
|
94
|
+
routeOptions
|
|
95
|
+
});
|
|
96
|
+
if (componentRender?.assets?.length) {
|
|
97
|
+
allDependencies.push(...componentRender.assets);
|
|
98
|
+
}
|
|
99
|
+
const triggers = this.collectResolvedTriggers(componentsToResolve);
|
|
100
|
+
if (triggers.length > 0) {
|
|
101
|
+
const globalAssets = await this.buildGlobalInjectorAssets(triggers, adapter.name);
|
|
102
|
+
allDependencies.push(...globalAssets);
|
|
103
|
+
}
|
|
104
|
+
const eagerSsrLazyAssets = await this.buildEagerSsrLazyAssets(componentsToResolve, adapter.name);
|
|
105
|
+
if (eagerSsrLazyAssets.length > 0) {
|
|
106
|
+
allDependencies.push(...eagerSsrLazyAssets);
|
|
107
|
+
}
|
|
108
|
+
const dedupedDependencies = dedupeProcessedAssets(allDependencies);
|
|
109
|
+
const pagePackage = createPagePackage(dedupedDependencies);
|
|
110
|
+
const pageProps = {
|
|
111
|
+
...props,
|
|
112
|
+
params: routeOptions.params || {},
|
|
113
|
+
query: routeOptions.query || {}
|
|
114
|
+
};
|
|
115
|
+
const cacheStrategy = Page.cache;
|
|
116
|
+
const defaultCacheStrategy = this.appConfig.cache?.defaultStrategy ?? "static";
|
|
117
|
+
const effectiveCacheStrategy = cacheStrategy ?? defaultCacheStrategy;
|
|
118
|
+
const localsAvailable = effectiveCacheStrategy === "dynamic" && routeOptions.locals !== void 0;
|
|
119
|
+
const pageLocals = localsAvailable ? routeOptions.locals : createPageLocalsProxy(routeOptions.file);
|
|
120
|
+
const locals = localsAvailable ? routeOptions.locals : void 0;
|
|
121
|
+
const preparedOptions = {
|
|
122
|
+
...routeOptions,
|
|
123
|
+
resolvedDependencies,
|
|
124
|
+
pagePackage,
|
|
125
|
+
componentRender,
|
|
126
|
+
HtmlTemplate,
|
|
127
|
+
Layout,
|
|
128
|
+
props,
|
|
129
|
+
Page,
|
|
130
|
+
metadata,
|
|
131
|
+
params: routeOptions.params || {},
|
|
132
|
+
query: routeOptions.query || {},
|
|
133
|
+
pageProps,
|
|
134
|
+
locals,
|
|
135
|
+
pageLocals,
|
|
136
|
+
cacheStrategy,
|
|
137
|
+
ownershipPlan
|
|
138
|
+
};
|
|
139
|
+
return {
|
|
140
|
+
...integrationSpecificProps,
|
|
141
|
+
...preparedOptions
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Captures one route render body as HTML while preserving a replayable body value.
|
|
146
|
+
*/
|
|
147
|
+
async captureHtmlRender(render) {
|
|
148
|
+
const renderedBody = await render();
|
|
149
|
+
const capturedRender = await this.captureRenderedBody(renderedBody);
|
|
150
|
+
return {
|
|
151
|
+
body: capturedRender.body,
|
|
152
|
+
html: capturedRender.html
|
|
153
|
+
};
|
|
154
|
+
}
|
|
155
|
+
/**
|
|
156
|
+
* Executes the full route-render flow and returns the final body plus cache strategy.
|
|
157
|
+
*/
|
|
158
|
+
async execute(options, adapter) {
|
|
159
|
+
const renderOptions = await this.prepareRenderOptions(options, adapter);
|
|
160
|
+
return this.executePrepared(renderOptions, adapter);
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* Executes the route-render finalization path for already prepared render options.
|
|
164
|
+
*/
|
|
165
|
+
async executePrepared(renderOptions, adapter) {
|
|
166
|
+
const renderExecution = await this.captureHtmlRender(async () => adapter.renderRouteBody(renderOptions));
|
|
167
|
+
const unresolvedArtifactInspection = inspectUnresolvedMarkerArtifactHtml(renderExecution.html);
|
|
168
|
+
const htmlFinalization = adapter.getRouteHtmlFinalization(renderOptions);
|
|
169
|
+
const hasUnresolvedMarkerHtml = unresolvedArtifactInspection.hasUnresolvedMarkerArtifacts;
|
|
170
|
+
if (hasUnresolvedMarkerHtml) {
|
|
171
|
+
throw new Error(
|
|
172
|
+
"[ecopages] Route render returned unresolved eco-marker artifact HTML. Full-route unresolved-marker fallback has been removed; resolve mixed foreign children inside renderComponentWithForeignChildren()."
|
|
173
|
+
);
|
|
174
|
+
}
|
|
175
|
+
const canReuseCapturedBody = !hasUnresolvedMarkerHtml && htmlFinalization.finalizeHtml === void 0;
|
|
176
|
+
if (canReuseCapturedBody) {
|
|
177
|
+
const body2 = await adapter.transformRouteResponse(
|
|
178
|
+
new Response(renderExecution.body, {
|
|
179
|
+
headers: {
|
|
180
|
+
"Content-Type": "text/html"
|
|
181
|
+
}
|
|
182
|
+
})
|
|
183
|
+
);
|
|
184
|
+
return {
|
|
185
|
+
body: body2,
|
|
186
|
+
cacheStrategy: renderOptions.cacheStrategy
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
const finalization = htmlFinalization.finalizeHtml ? htmlFinalization.finalizeHtml(unresolvedArtifactInspection.normalizedHtml) : unresolvedArtifactInspection.normalizedHtml;
|
|
190
|
+
const body = await adapter.transformRouteResponse(
|
|
191
|
+
new Response(finalization, {
|
|
192
|
+
headers: {
|
|
193
|
+
"Content-Type": "text/html"
|
|
194
|
+
}
|
|
195
|
+
})
|
|
196
|
+
);
|
|
197
|
+
return {
|
|
198
|
+
body,
|
|
199
|
+
cacheStrategy: renderOptions.cacheStrategy
|
|
200
|
+
};
|
|
201
|
+
}
|
|
202
|
+
async captureRenderedBody(body) {
|
|
203
|
+
const response = new Response(body);
|
|
204
|
+
if (typeof body === "string") {
|
|
205
|
+
return {
|
|
206
|
+
body,
|
|
207
|
+
html: await response.text()
|
|
208
|
+
};
|
|
209
|
+
}
|
|
210
|
+
if (!response.body) {
|
|
211
|
+
return {
|
|
212
|
+
body,
|
|
213
|
+
html: await response.text()
|
|
214
|
+
};
|
|
215
|
+
}
|
|
216
|
+
const [capturedBody, replayBody] = response.body.tee();
|
|
217
|
+
return {
|
|
218
|
+
body: replayBody,
|
|
219
|
+
html: await new Response(capturedBody).text()
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
collectResolvedTriggers(components, seen = /* @__PURE__ */ new Set()) {
|
|
223
|
+
const triggers = [];
|
|
224
|
+
for (const comp of components) {
|
|
225
|
+
if (!comp) {
|
|
226
|
+
continue;
|
|
227
|
+
}
|
|
228
|
+
const ecoComp = comp;
|
|
229
|
+
if (seen.has(ecoComp)) {
|
|
230
|
+
continue;
|
|
231
|
+
}
|
|
232
|
+
seen.add(ecoComp);
|
|
233
|
+
const ownTriggers = ecoComp.config?._resolvedLazyTriggers;
|
|
234
|
+
if (ownTriggers?.length) {
|
|
235
|
+
triggers.push(...ownTriggers);
|
|
236
|
+
}
|
|
237
|
+
const nested = ecoComp.config?.dependencies?.components;
|
|
238
|
+
if (nested?.length) {
|
|
239
|
+
triggers.push(...this.collectResolvedTriggers(nested, seen));
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
return triggers;
|
|
243
|
+
}
|
|
244
|
+
collectUsedIntegrationDependencies(components, currentIntegrationName) {
|
|
245
|
+
const integrationNames = this.collectIntegrationNames(components);
|
|
246
|
+
const dependencies = [];
|
|
247
|
+
for (const integrationName of integrationNames) {
|
|
248
|
+
if (integrationName === currentIntegrationName) {
|
|
249
|
+
continue;
|
|
250
|
+
}
|
|
251
|
+
const integrationPlugin = this.appConfig.integrations.find(
|
|
252
|
+
(integration) => integration.name === integrationName
|
|
253
|
+
);
|
|
254
|
+
if (!integrationPlugin || typeof integrationPlugin.getResolvedIntegrationDependencies !== "function") {
|
|
255
|
+
continue;
|
|
256
|
+
}
|
|
257
|
+
dependencies.push(...integrationPlugin.getResolvedIntegrationDependencies());
|
|
258
|
+
}
|
|
259
|
+
return dependencies;
|
|
260
|
+
}
|
|
261
|
+
collectIntegrationNames(components, seen = /* @__PURE__ */ new Set()) {
|
|
262
|
+
const integrationNames = /* @__PURE__ */ new Set();
|
|
263
|
+
for (const comp of components) {
|
|
264
|
+
if (!comp) {
|
|
265
|
+
continue;
|
|
266
|
+
}
|
|
267
|
+
const ecoComp = comp;
|
|
268
|
+
if (seen.has(ecoComp)) {
|
|
269
|
+
continue;
|
|
270
|
+
}
|
|
271
|
+
seen.add(ecoComp);
|
|
272
|
+
const integrationName = ecoComp.config?.integration ?? ecoComp.config?.__eco?.integration;
|
|
273
|
+
if (integrationName) {
|
|
274
|
+
integrationNames.add(integrationName);
|
|
275
|
+
}
|
|
276
|
+
const nested = ecoComp.config?.dependencies?.components;
|
|
277
|
+
if (nested?.length) {
|
|
278
|
+
const nestedNames = this.collectIntegrationNames(nested, seen);
|
|
279
|
+
for (const nestedName of nestedNames) {
|
|
280
|
+
integrationNames.add(nestedName);
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
return integrationNames;
|
|
285
|
+
}
|
|
286
|
+
async buildGlobalInjectorAssets(triggers, currentIntegrationName) {
|
|
287
|
+
const globalInjectorImportPath = createRequire(import.meta.url).resolve("@ecopages/scripts-injector/global");
|
|
288
|
+
const mapScript = AssetFactory.createInlineContentScript({
|
|
289
|
+
position: "head",
|
|
290
|
+
name: "ecopages-global-injector-map",
|
|
291
|
+
content: buildGlobalInjectorMapScript(triggers),
|
|
292
|
+
attributes: { type: "ecopages/global-injector-map" },
|
|
293
|
+
packageRole: "keep-separate",
|
|
294
|
+
bundle: false
|
|
295
|
+
});
|
|
296
|
+
const bootstrapInlineScript = AssetFactory.createInlineContentScript({
|
|
297
|
+
position: "head",
|
|
298
|
+
name: "ecopages-global-injector-bootstrap",
|
|
299
|
+
content: buildGlobalInjectorBootstrapContent(globalInjectorImportPath),
|
|
300
|
+
attributes: { type: "module" },
|
|
301
|
+
packageRole: "keep-separate",
|
|
302
|
+
bundle: true
|
|
303
|
+
});
|
|
304
|
+
return this.assetProcessingService.processDependencies(
|
|
305
|
+
[mapScript, bootstrapInlineScript],
|
|
306
|
+
currentIntegrationName
|
|
307
|
+
);
|
|
308
|
+
}
|
|
309
|
+
async buildEagerSsrLazyAssets(components, currentIntegrationName) {
|
|
310
|
+
const dependencies = this.collectEagerSsrLazyDependencies(components);
|
|
311
|
+
if (dependencies.length === 0) {
|
|
312
|
+
return [];
|
|
313
|
+
}
|
|
314
|
+
return this.assetProcessingService.processDependencies(dependencies, `${currentIntegrationName}:ssr-lazy`);
|
|
315
|
+
}
|
|
316
|
+
collectEagerSsrLazyDependencies(components) {
|
|
317
|
+
const dependencies = [];
|
|
318
|
+
const visitedConfigs = /* @__PURE__ */ new Set();
|
|
319
|
+
const seenKeys = /* @__PURE__ */ new Set();
|
|
320
|
+
const normalizeAttributes = (attributes) => ({
|
|
321
|
+
type: "module",
|
|
322
|
+
defer: "",
|
|
323
|
+
...attributes ?? {}
|
|
324
|
+
});
|
|
325
|
+
const collect = (config) => {
|
|
326
|
+
if (!config || visitedConfigs.has(config)) {
|
|
327
|
+
return;
|
|
328
|
+
}
|
|
329
|
+
visitedConfigs.add(config);
|
|
330
|
+
const componentFile = config.__eco?.file;
|
|
331
|
+
if (componentFile) {
|
|
332
|
+
const componentDir = path.dirname(componentFile);
|
|
333
|
+
for (const script of config.dependencies?.scripts ?? []) {
|
|
334
|
+
if (typeof script === "string" || !script.lazy || script.ssr !== true) {
|
|
335
|
+
continue;
|
|
336
|
+
}
|
|
337
|
+
const attributes = normalizeAttributes(script.attributes);
|
|
338
|
+
if (script.content) {
|
|
339
|
+
const key2 = `content:${script.content}:${JSON.stringify(attributes)}`;
|
|
340
|
+
if (seenKeys.has(key2)) {
|
|
341
|
+
continue;
|
|
342
|
+
}
|
|
343
|
+
seenKeys.add(key2);
|
|
344
|
+
dependencies.push(
|
|
345
|
+
AssetFactory.createContentScript({
|
|
346
|
+
position: "head",
|
|
347
|
+
content: script.content,
|
|
348
|
+
attributes,
|
|
349
|
+
packageRole: "dynamic-chunk"
|
|
350
|
+
})
|
|
351
|
+
);
|
|
352
|
+
continue;
|
|
353
|
+
}
|
|
354
|
+
if (!script.src) {
|
|
355
|
+
continue;
|
|
356
|
+
}
|
|
357
|
+
const resolvedPath = path.resolve(componentDir, script.src);
|
|
358
|
+
const key = `file:${resolvedPath}:${JSON.stringify(attributes)}`;
|
|
359
|
+
if (seenKeys.has(key)) {
|
|
360
|
+
continue;
|
|
361
|
+
}
|
|
362
|
+
seenKeys.add(key);
|
|
363
|
+
dependencies.push(
|
|
364
|
+
AssetFactory.createFileScript({
|
|
365
|
+
filepath: resolvedPath,
|
|
366
|
+
position: "head",
|
|
367
|
+
attributes,
|
|
368
|
+
packageRole: "dynamic-chunk"
|
|
369
|
+
})
|
|
370
|
+
);
|
|
371
|
+
}
|
|
372
|
+
}
|
|
373
|
+
if (config.layout?.config) {
|
|
374
|
+
collect(config.layout.config);
|
|
375
|
+
}
|
|
376
|
+
for (const nestedComponent of config.dependencies?.components ?? []) {
|
|
377
|
+
collect(nestedComponent?.config);
|
|
378
|
+
}
|
|
379
|
+
};
|
|
380
|
+
for (const component of components) {
|
|
381
|
+
collect(component.config);
|
|
382
|
+
}
|
|
383
|
+
return dependencies;
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
export {
|
|
387
|
+
RouteRenderOrchestrator
|
|
388
|
+
};
|