@ecopages/core 0.2.0-alpha.9 → 0.2.1
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 +18 -11
- package/README.md +23 -26
- package/package.json +76 -58
- package/src/adapters/README.md +2 -2
- 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 +4 -12
- package/src/adapters/bun/create-app.js +4 -5
- package/src/adapters/bun/hmr-manager.d.ts +4 -4
- package/src/adapters/bun/hmr-manager.js +8 -8
- package/src/adapters/bun/index.d.ts +1 -1
- package/src/adapters/bun/index.js +2 -2
- package/src/adapters/bun/server-adapter.d.ts +5 -5
- package/src/adapters/bun/server-adapter.js +6 -5
- package/src/adapters/bun/server-lifecycle.d.ts +4 -4
- package/src/adapters/bun/server-lifecycle.js +2 -2
- 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 +1 -5
- package/src/adapters/index.js +1 -7
- 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 +2 -2
- package/src/adapters/node/node-hmr-manager.js +3 -3
- package/src/adapters/node/server-adapter.d.ts +4 -4
- package/src/adapters/node/server-adapter.js +13 -12
- package/src/adapters/node/static-content-server.d.ts +1 -1
- package/src/adapters/node/static-content-server.js +1 -1
- package/src/adapters/shared/application-adapter.d.ts +1 -1
- package/src/adapters/shared/define-api-handler.d.ts +1 -1
- package/src/adapters/shared/explicit-static-route-matcher.d.ts +2 -2
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +1 -1
- package/src/adapters/shared/fs-server-response-factory.d.ts +2 -2
- package/src/adapters/shared/fs-server-response-factory.js +1 -1
- package/src/adapters/shared/fs-server-response-matcher.d.ts +1 -1
- package/src/adapters/shared/hmr-entrypoint-registrar.js +1 -1
- package/src/adapters/shared/hmr-html-response.d.ts +1 -1
- package/src/adapters/shared/render-context.d.ts +2 -1
- package/src/adapters/shared/render-context.js +3 -1
- package/src/adapters/shared/runtime-bootstrap.d.ts +1 -1
- package/src/adapters/shared/runtime-bootstrap.js +1 -1
- package/src/adapters/shared/server-adapter.d.ts +1 -1
- package/src/adapters/shared/server-adapter.js +5 -1
- package/src/adapters/shared/server-route-handler.d.ts +4 -4
- package/src/adapters/shared/server-route-handler.js +3 -3
- package/src/adapters/shared/server-static-builder.d.ts +5 -5
- package/src/adapters/shared/server-static-builder.js +5 -4
- package/src/build/README.md +19 -13
- package/src/build/build-adapter.d.ts +67 -20
- package/src/build/build-adapter.js +420 -19
- package/src/build/dev-build-coordinator.d.ts +10 -12
- package/src/build/dev-build-coordinator.js +8 -15
- package/src/build/esbuild-build-adapter.d.ts +6 -0
- package/src/build/esbuild-build-adapter.js +94 -11
- package/src/build/runtime-build-executor.d.ts +5 -4
- package/src/build/runtime-build-executor.js +5 -3
- package/src/build/runtime-specifier-alias-plugin.js +19 -15
- package/src/build/runtime-specifier-aliases.d.ts +5 -0
- package/src/build/runtime-specifier-aliases.js +95 -0
- package/src/config/README.md +5 -2
- package/src/config/config-builder.d.ts +25 -2
- package/src/config/config-builder.js +44 -7
- package/src/declarations.d.ts +1 -1
- package/src/dev/sc-server.d.ts +1 -1
- package/src/dev/sc-server.js +1 -1
- package/src/eco/eco.browser.d.ts +2 -0
- package/src/eco/eco.browser.js +83 -0
- package/src/eco/eco.js +19 -48
- package/src/eco/eco.types.d.ts +1 -1
- 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 +1 -1
- package/src/eco/lazy-injector-map.d.ts +1 -1
- package/src/hmr/hmr-strategy.d.ts +16 -13
- package/src/hmr/hmr-strategy.js +22 -7
- 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 +2 -2
- package/src/hmr/strategies/js-hmr-strategy.js +2 -2
- package/src/index.browser.d.ts +2 -2
- package/src/index.browser.js +1 -1
- package/src/index.d.ts +3 -2
- package/src/index.js +15 -4
- package/src/integrations/ghtml/ghtml-renderer.d.ts +6 -1
- package/src/integrations/ghtml/ghtml-renderer.js +29 -28
- package/src/integrations/ghtml/ghtml.plugin.d.ts +2 -2
- package/src/integrations/ghtml/ghtml.plugin.js +2 -2
- package/src/plugins/README.md +1 -0
- package/src/plugins/eco-component-meta-plugin.d.ts +12 -1
- package/src/plugins/eco-component-meta-plugin.js +26 -20
- 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 +99 -33
- package/src/plugins/integration-plugin.js +68 -21
- package/src/plugins/processor.d.ts +2 -2
- package/src/plugins/processor.js +2 -2
- package/src/plugins/source-transform.d.ts +46 -0
- package/src/plugins/source-transform.js +71 -0
- package/src/route-renderer/GRAPH.md +54 -84
- package/src/route-renderer/README.md +14 -20
- package/src/route-renderer/orchestration/component-render-context.d.ts +83 -0
- package/src/route-renderer/orchestration/component-render-context.js +147 -0
- package/src/route-renderer/orchestration/integration-renderer.d.ts +233 -76
- package/src/route-renderer/orchestration/integration-renderer.js +500 -143
- package/src/route-renderer/orchestration/queued-boundary-runtime.service.d.ts +93 -0
- package/src/route-renderer/orchestration/queued-boundary-runtime.service.js +155 -0
- package/src/route-renderer/orchestration/render-execution.service.d.ts +11 -71
- package/src/route-renderer/orchestration/render-execution.service.js +65 -80
- package/src/{eco/eco.utils.ts → route-renderer/orchestration/render-output.utils.d.ts} +10 -53
- package/src/route-renderer/orchestration/render-output.utils.js +65 -0
- package/src/route-renderer/orchestration/render-preparation.service.d.ts +2 -8
- package/src/route-renderer/orchestration/render-preparation.service.js +10 -17
- 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/dependency-resolver.d.ts +2 -2
- package/src/route-renderer/page-loading/dependency-resolver.js +10 -8
- package/src/route-renderer/page-loading/page-module-loader.d.ts +6 -4
- package/src/route-renderer/page-loading/page-module-loader.js +7 -5
- package/src/route-renderer/route-renderer.d.ts +5 -3
- package/src/route-renderer/route-renderer.js +13 -3
- package/src/router/README.md +79 -8
- package/src/router/client/navigation-coordinator.js +2 -2
- package/src/router/server/fs-router-scanner.d.ts +1 -1
- package/src/router/server/fs-router-scanner.js +6 -1
- package/src/router/server/fs-router.d.ts +1 -1
- package/src/services/assets/asset-processing-service/asset-processing.service.d.ts +3 -3
- package/src/services/assets/asset-processing-service/asset-processing.service.js +6 -6
- package/src/services/assets/asset-processing-service/asset.factory.d.ts +1 -1
- package/src/services/assets/asset-processing-service/asset.factory.js +2 -2
- package/src/services/assets/asset-processing-service/index.d.ts +5 -5
- package/src/services/assets/asset-processing-service/index.js +5 -5
- package/src/services/assets/asset-processing-service/processor.interface.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processor.registry.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts +1 -1
- package/src/services/assets/asset-processing-service/processors/base/base-processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts +3 -3
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js +2 -2
- package/src/services/assets/asset-processing-service/processors/index.d.ts +5 -5
- package/src/services/assets/asset-processing-service/processors/index.js +5 -5
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts +4 -3
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js +15 -3
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts +3 -3
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +1 -1
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +2 -2
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +1 -1
- package/src/services/assets/browser-bundle.service.d.ts +1 -1
- package/src/services/assets/browser-bundle.service.js +2 -2
- package/src/services/html/html-rewriter-provider.service.js +4 -1
- package/src/services/html/html-transformer.service.d.ts +2 -2
- package/src/services/html/html-transformer.service.js +4 -10
- package/src/services/invalidation/development-invalidation.service.d.ts +1 -1
- package/src/services/invalidation/development-invalidation.service.js +1 -0
- package/src/services/module-loading/app-module-loader.service.d.ts +25 -0
- package/src/services/module-loading/app-module-loader.service.js +31 -0
- package/src/services/module-loading/app-server-module-transpiler.service.d.ts +9 -1
- package/src/services/module-loading/app-server-module-transpiler.service.js +77 -2
- 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/{adapters/node/bootstrap-dependency-resolver.d.ts → services/module-loading/node-bootstrap-plugin.d.ts} +2 -24
- package/src/{adapters/node/bootstrap-dependency-resolver.js → services/module-loading/node-bootstrap-plugin.js} +42 -22
- package/src/services/module-loading/page-module-import.service.d.ts +4 -0
- package/src/services/module-loading/page-module-import.service.js +38 -9
- package/src/services/module-loading/server-module-transpiler.service.d.ts +3 -0
- package/src/services/module-loading/server-module-transpiler.service.js +4 -1
- package/src/services/runtime-state/dev-graph.service.d.ts +6 -6
- package/src/services/runtime-state/dev-graph.service.js +10 -10
- package/src/services/runtime-state/entrypoint-dependency-graph.service.d.ts +1 -1
- package/src/services/runtime-state/runtime-specifier-registry.service.d.ts +1 -1
- package/src/services/runtime-state/server-invalidation-state.service.d.ts +1 -1
- package/src/static-site-generator/static-site-generator.d.ts +2 -2
- package/src/static-site-generator/static-site-generator.js +1 -1
- package/src/{internal-types.d.ts → types/internal-types.d.ts} +24 -14
- package/src/{public-types.d.ts → types/public-types.d.ts} +30 -14
- 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.js +1 -1
- package/src/watchers/project-watcher.d.ts +4 -4
- package/src/watchers/project-watcher.js +4 -10
- package/src/watchers/project-watcher.test-helpers.d.ts +2 -2
- 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/hmr-manager.ts +0 -409
- package/src/adapters/bun/index.ts +0 -2
- package/src/adapters/bun/server-adapter.ts +0 -499
- package/src/adapters/bun/server-lifecycle.ts +0 -124
- package/src/adapters/index.ts +0 -6
- package/src/adapters/node/bootstrap-dependency-resolver.ts +0 -301
- package/src/adapters/node/create-app.ts +0 -179
- package/src/adapters/node/index.d.ts +0 -6
- package/src/adapters/node/index.js +0 -11
- package/src/adapters/node/index.ts +0 -16
- package/src/adapters/node/node-client-bridge.ts +0 -79
- package/src/adapters/node/node-hmr-manager.ts +0 -381
- package/src/adapters/node/runtime-adapter.d.ts +0 -46
- package/src/adapters/node/runtime-adapter.js +0 -306
- package/src/adapters/node/runtime-adapter.ts +0 -439
- package/src/adapters/node/server-adapter.ts +0 -488
- package/src/adapters/node/static-content-server.ts +0 -239
- package/src/adapters/node/write-runtime-manifest.d.ts +0 -26
- package/src/adapters/node/write-runtime-manifest.js +0 -12
- package/src/adapters/node/write-runtime-manifest.ts +0 -38
- package/src/adapters/shared/api-response.ts +0 -104
- package/src/adapters/shared/application-adapter.ts +0 -199
- package/src/adapters/shared/define-api-handler.ts +0 -66
- package/src/adapters/shared/explicit-static-route-matcher.ts +0 -140
- package/src/adapters/shared/file-route-middleware-pipeline.ts +0 -127
- package/src/adapters/shared/fs-server-response-factory.ts +0 -118
- package/src/adapters/shared/fs-server-response-matcher.ts +0 -205
- package/src/adapters/shared/hmr-entrypoint-registrar.ts +0 -149
- package/src/adapters/shared/hmr-html-response.ts +0 -52
- package/src/adapters/shared/render-context.ts +0 -120
- package/src/adapters/shared/runtime-bootstrap.ts +0 -79
- package/src/adapters/shared/server-adapter.ts +0 -489
- package/src/adapters/shared/server-route-handler.ts +0 -153
- package/src/adapters/shared/server-static-builder.ts +0 -166
- package/src/build/build-adapter.ts +0 -361
- package/src/build/build-manifest.ts +0 -54
- package/src/build/build-types.ts +0 -83
- package/src/build/dev-build-coordinator.ts +0 -221
- package/src/build/esbuild-build-adapter.ts +0 -559
- package/src/build/runtime-build-executor.ts +0 -34
- package/src/build/runtime-specifier-alias-plugin.ts +0 -58
- package/src/config/config-builder.ts +0 -706
- package/src/constants.ts +0 -54
- package/src/create-app.ts +0 -87
- 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 -87
- package/src/eco/component-render-context.ts +0 -224
- package/src/eco/eco.ts +0 -242
- package/src/eco/eco.types.ts +0 -221
- 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/hmr-runtime.ts +0 -152
- package/src/hmr/hmr-strategy.ts +0 -172
- package/src/hmr/hmr.postcss.test.e2e.ts +0 -41
- package/src/hmr/hmr.test.e2e.ts +0 -66
- 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 -96
- package/src/integrations/ghtml/ghtml.plugin.ts +0 -32
- package/src/internal-types.ts +0 -232
- package/src/plugins/alias-resolver-plugin.ts +0 -63
- package/src/plugins/eco-component-meta-plugin.ts +0 -481
- package/src/plugins/integration-plugin.ts +0 -226
- package/src/plugins/processor.ts +0 -240
- package/src/plugins/runtime-capability.ts +0 -14
- package/src/public-types.ts +0 -1317
- package/src/route-renderer/component-graph/component-graph-executor.d.ts +0 -32
- package/src/route-renderer/component-graph/component-graph-executor.js +0 -31
- package/src/route-renderer/component-graph/component-graph-executor.ts +0 -84
- package/src/route-renderer/component-graph/component-graph.d.ts +0 -42
- package/src/route-renderer/component-graph/component-graph.js +0 -72
- package/src/route-renderer/component-graph/component-graph.ts +0 -159
- package/src/route-renderer/component-graph/component-marker.d.ts +0 -52
- package/src/route-renderer/component-graph/component-marker.js +0 -46
- package/src/route-renderer/component-graph/component-marker.ts +0 -117
- package/src/route-renderer/component-graph/component-reference.d.ts +0 -10
- package/src/route-renderer/component-graph/component-reference.js +0 -19
- package/src/route-renderer/component-graph/component-reference.ts +0 -29
- package/src/route-renderer/component-graph/marker-graph-resolver.d.ts +0 -77
- package/src/route-renderer/component-graph/marker-graph-resolver.js +0 -95
- package/src/route-renderer/component-graph/marker-graph-resolver.ts +0 -155
- package/src/route-renderer/orchestration/integration-renderer.ts +0 -790
- package/src/route-renderer/orchestration/render-execution.service.ts +0 -230
- package/src/route-renderer/orchestration/render-preparation.service.ts +0 -476
- package/src/route-renderer/page-loading/dependency-resolver.ts +0 -612
- package/src/route-renderer/page-loading/page-module-loader.ts +0 -181
- package/src/route-renderer/route-renderer.ts +0 -115
- package/src/router/client/link-intent.test.browser.ts +0 -51
- package/src/router/client/link-intent.ts +0 -92
- package/src/router/client/navigation-coordinator.ts +0 -433
- package/src/router/server/fs-router-scanner.ts +0 -219
- package/src/router/server/fs-router.ts +0 -122
- package/src/services/assets/asset-processing-service/asset-processing.service.ts +0 -401
- package/src/services/assets/asset-processing-service/asset.factory.ts +0 -105
- package/src/services/assets/asset-processing-service/assets.types.ts +0 -113
- package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.ts +0 -95
- package/src/services/assets/asset-processing-service/browser-runtime-entry.factory.ts +0 -78
- package/src/services/assets/asset-processing-service/index.ts +0 -5
- package/src/services/assets/asset-processing-service/processor.interface.ts +0 -27
- package/src/services/assets/asset-processing-service/processor.registry.ts +0 -18
- package/src/services/assets/asset-processing-service/processors/base/base-processor.ts +0 -82
- package/src/services/assets/asset-processing-service/processors/base/base-script-processor.ts +0 -95
- package/src/services/assets/asset-processing-service/processors/index.ts +0 -5
- package/src/services/assets/asset-processing-service/processors/script/content-script.processor.ts +0 -66
- package/src/services/assets/asset-processing-service/processors/script/file-script.processor.ts +0 -88
- package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.ts +0 -85
- package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +0 -27
- package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +0 -80
- package/src/services/assets/browser-bundle.service.ts +0 -53
- 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/cache/page-request-cache-coordinator.service.ts +0 -131
- package/src/services/html/html-rewriter-provider.service.ts +0 -103
- package/src/services/html/html-transformer.service.ts +0 -279
- package/src/services/invalidation/development-invalidation.service.ts +0 -261
- package/src/services/module-loading/app-server-module-transpiler.service.ts +0 -52
- package/src/services/module-loading/page-module-import.service.ts +0 -200
- package/src/services/module-loading/server-loader.service.d.ts +0 -96
- package/src/services/module-loading/server-loader.service.js +0 -32
- package/src/services/module-loading/server-loader.service.ts +0 -130
- package/src/services/module-loading/server-module-transpiler.service.ts +0 -105
- package/src/services/runtime-manifest/node-runtime-manifest.service.d.ts +0 -35
- package/src/services/runtime-manifest/node-runtime-manifest.service.js +0 -60
- package/src/services/runtime-manifest/node-runtime-manifest.service.ts +0 -101
- package/src/services/runtime-state/dev-graph.service.ts +0 -217
- package/src/services/runtime-state/entrypoint-dependency-graph.service.ts +0 -136
- package/src/services/runtime-state/runtime-specifier-registry.service.ts +0 -96
- package/src/services/runtime-state/server-invalidation-state.service.ts +0 -68
- package/src/services/validation/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 -462
- 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/resolve-work-dir.ts +0 -45
- 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 -363
- /package/src/{constants.d.ts → config/constants.d.ts} +0 -0
- /package/src/{constants.js → config/constants.js} +0 -0
- /package/src/{internal-types.js → services/module-loading/module-loading-types.js} +0 -0
- /package/src/{public-types.js → types/internal-types.js} +0 -0
|
@@ -1,200 +0,0 @@
|
|
|
1
|
-
import path from 'node:path';
|
|
2
|
-
import { pathToFileURL } from 'node:url';
|
|
3
|
-
import { fileSystem } from '@ecopages/file-system';
|
|
4
|
-
import { build, type BuildExecutor, type BuildResult } from '../../build/build-adapter.ts';
|
|
5
|
-
import type { EcoBuildPlugin } from '../../build/build-types.ts';
|
|
6
|
-
|
|
7
|
-
export interface PageModuleImportOptions {
|
|
8
|
-
filePath: string;
|
|
9
|
-
rootDir: string;
|
|
10
|
-
outdir: string;
|
|
11
|
-
buildExecutor?: BuildExecutor;
|
|
12
|
-
invalidationVersion?: number;
|
|
13
|
-
splitting?: boolean;
|
|
14
|
-
externalPackages?: boolean;
|
|
15
|
-
plugins?: EcoBuildPlugin[];
|
|
16
|
-
transpileErrorMessage?: (details: string) => string;
|
|
17
|
-
noOutputMessage?: (filePath: string) => string;
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
/**
|
|
21
|
-
* Minimal runtime dependencies required to load page modules.
|
|
22
|
-
*
|
|
23
|
-
* @remarks
|
|
24
|
-
* This service owns cache and runtime import policy. Hashing and build
|
|
25
|
-
* execution are injected so tests can provide explicit fakes without module
|
|
26
|
-
* interception.
|
|
27
|
-
*/
|
|
28
|
-
export interface PageModuleImportDependencies {
|
|
29
|
-
hashFile(filePath: string): string;
|
|
30
|
-
buildModule(options: Parameters<typeof build>[0], buildExecutor?: BuildExecutor): Promise<BuildResult>;
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
/**
|
|
34
|
-
* Loads source page modules in a runtime-agnostic way.
|
|
35
|
-
*
|
|
36
|
-
* This service centralizes the Bun-vs-Node import strategy used by route
|
|
37
|
-
* scanning, page data loading, and request-time page inspection. In Bun it can
|
|
38
|
-
* import source files directly; in Node it transpiles the file into a dedicated
|
|
39
|
-
* output directory first and then imports the generated module.
|
|
40
|
-
*
|
|
41
|
-
* Keeping this logic in one place prevents subtle drift in cache-busting,
|
|
42
|
-
* transpilation settings, and error semantics across the different callers.
|
|
43
|
-
*/
|
|
44
|
-
export class PageModuleImportService {
|
|
45
|
-
private readonly dependencies: PageModuleImportDependencies;
|
|
46
|
-
private readonly importCache = new Map<string, Promise<unknown>>();
|
|
47
|
-
private developmentInvalidationVersion = 0;
|
|
48
|
-
|
|
49
|
-
constructor(dependencies?: Partial<PageModuleImportDependencies>) {
|
|
50
|
-
this.dependencies = {
|
|
51
|
-
hashFile: dependencies?.hashFile ?? ((filePath) => fileSystem.hash(filePath)),
|
|
52
|
-
buildModule: dependencies?.buildModule ?? ((options, buildExecutor) => build(options, buildExecutor)),
|
|
53
|
-
};
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
/**
|
|
57
|
-
* Clears the shared import cache used by framework-owned page-module loads.
|
|
58
|
-
*/
|
|
59
|
-
clearImportCache(): void {
|
|
60
|
-
this.importCache.clear();
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
/**
|
|
64
|
-
* Invalidates all previously imported modules in development by clearing the
|
|
65
|
-
* import cache and incrementing the invalidation version included in cache keys.
|
|
66
|
-
*
|
|
67
|
-
* This forces all modules to be reloaded on the next import, even if their
|
|
68
|
-
* source content hasn't changed. This is necessary to ensure that changes to
|
|
69
|
-
* non-content aspects of modules (e.g. dependencies, transpilation output)
|
|
70
|
-
* are picked up during development.
|
|
71
|
-
*/
|
|
72
|
-
invalidateDevelopmentGraph(): void {
|
|
73
|
-
this.clearImportCache();
|
|
74
|
-
this.developmentInvalidationVersion += 1;
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
/**
|
|
78
|
-
* Imports a page-like module from source.
|
|
79
|
-
*
|
|
80
|
-
* The caller controls the output directory and error wording so different
|
|
81
|
-
* subsystems can reuse the same loading mechanism while preserving their
|
|
82
|
-
* current diagnostics. Module identities stay stable for unchanged files and
|
|
83
|
-
* roll forward automatically when the source hash changes during watch mode.
|
|
84
|
-
*
|
|
85
|
-
* @typeParam T Expected module shape.
|
|
86
|
-
* @param options Runtime-specific import settings.
|
|
87
|
-
* @returns The loaded module.
|
|
88
|
-
*/
|
|
89
|
-
async importModule<T = unknown>(options: PageModuleImportOptions): Promise<T> {
|
|
90
|
-
const { filePath, rootDir, externalPackages, splitting } = options;
|
|
91
|
-
const invalidationVersion = options.invalidationVersion ?? this.developmentInvalidationVersion;
|
|
92
|
-
|
|
93
|
-
const fileHash = this.dependencies.hashFile(filePath);
|
|
94
|
-
const runtime = typeof Bun !== 'undefined' ? 'bun' : 'node';
|
|
95
|
-
const cacheKey = [
|
|
96
|
-
runtime,
|
|
97
|
-
filePath,
|
|
98
|
-
rootDir,
|
|
99
|
-
splitting ?? 'default',
|
|
100
|
-
externalPackages ?? 'default',
|
|
101
|
-
fileHash,
|
|
102
|
-
invalidationVersion,
|
|
103
|
-
].join('::');
|
|
104
|
-
const cachedModule = this.importCache.get(cacheKey);
|
|
105
|
-
|
|
106
|
-
if (cachedModule) {
|
|
107
|
-
return (await cachedModule) as T;
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
const importPromise = this.loadModule<T>({
|
|
111
|
-
...options,
|
|
112
|
-
fileHash,
|
|
113
|
-
});
|
|
114
|
-
|
|
115
|
-
this.importCache.set(cacheKey, importPromise);
|
|
116
|
-
|
|
117
|
-
try {
|
|
118
|
-
return await importPromise;
|
|
119
|
-
} catch (error) {
|
|
120
|
-
this.importCache.delete(cacheKey);
|
|
121
|
-
throw error;
|
|
122
|
-
}
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
private async loadModule<T = unknown>(
|
|
126
|
-
options: PageModuleImportOptions & {
|
|
127
|
-
fileHash: string;
|
|
128
|
-
},
|
|
129
|
-
): Promise<T> {
|
|
130
|
-
/**
|
|
131
|
-
* Runtime-specific module loading stays centralized here so callers can share
|
|
132
|
-
* one cache-key and invalidation model while still diverging between Bun's
|
|
133
|
-
* direct source imports and Node's transpile-then-import path.
|
|
134
|
-
*/
|
|
135
|
-
const {
|
|
136
|
-
filePath,
|
|
137
|
-
rootDir,
|
|
138
|
-
outdir,
|
|
139
|
-
invalidationVersion = this.developmentInvalidationVersion,
|
|
140
|
-
splitting,
|
|
141
|
-
externalPackages,
|
|
142
|
-
transpileErrorMessage = (details) => `Error transpiling page module: ${details}`,
|
|
143
|
-
noOutputMessage = (targetFilePath) => `No transpiled output generated for page module: ${targetFilePath}`,
|
|
144
|
-
fileHash,
|
|
145
|
-
} = options;
|
|
146
|
-
|
|
147
|
-
if (typeof Bun !== 'undefined') {
|
|
148
|
-
const moduleUrl = pathToFileURL(filePath);
|
|
149
|
-
|
|
150
|
-
if (process.env.NODE_ENV === 'development') {
|
|
151
|
-
moduleUrl.searchParams.set('update', `${fileHash}-${invalidationVersion}`);
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
return (await import(moduleUrl.href)) as T;
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
const fileBaseName = path.basename(filePath, path.extname(filePath));
|
|
158
|
-
const outputFileName = `${fileBaseName}-${fileHash}.js`;
|
|
159
|
-
|
|
160
|
-
const buildResult = await this.dependencies.buildModule(
|
|
161
|
-
{
|
|
162
|
-
entrypoints: [filePath],
|
|
163
|
-
root: rootDir,
|
|
164
|
-
outdir,
|
|
165
|
-
target: 'node',
|
|
166
|
-
format: 'esm',
|
|
167
|
-
sourcemap: 'none',
|
|
168
|
-
splitting: splitting ?? true,
|
|
169
|
-
minify: false,
|
|
170
|
-
naming: outputFileName,
|
|
171
|
-
externalPackages: true,
|
|
172
|
-
plugins: options.plugins,
|
|
173
|
-
...(externalPackages !== undefined ? { externalPackages } : {}),
|
|
174
|
-
},
|
|
175
|
-
options.buildExecutor,
|
|
176
|
-
);
|
|
177
|
-
|
|
178
|
-
if (!buildResult.success) {
|
|
179
|
-
const details = buildResult.logs.map((log) => log.message).join(' | ');
|
|
180
|
-
throw new Error(transpileErrorMessage(details));
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
const preferredOutputPath = path.join(outdir, outputFileName);
|
|
184
|
-
const compiledOutput =
|
|
185
|
-
buildResult.outputs.find((output) => output.path === preferredOutputPath)?.path ??
|
|
186
|
-
buildResult.outputs.find((output) => output.path.endsWith('.js'))?.path;
|
|
187
|
-
|
|
188
|
-
if (!compiledOutput) {
|
|
189
|
-
throw new Error(noOutputMessage(filePath));
|
|
190
|
-
}
|
|
191
|
-
|
|
192
|
-
const compiledOutputUrl = pathToFileURL(compiledOutput);
|
|
193
|
-
|
|
194
|
-
if (process.env.NODE_ENV === 'development') {
|
|
195
|
-
compiledOutputUrl.searchParams.set('update', `${fileHash}-${invalidationVersion}`);
|
|
196
|
-
}
|
|
197
|
-
|
|
198
|
-
return (await import(compiledOutputUrl.href)) as T;
|
|
199
|
-
}
|
|
200
|
-
}
|
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
import type { EcoBuildPlugin } from '../../build/build-types.js';
|
|
2
|
-
import { type ServerModuleTranspilerBootstrapArgs, type ServerModuleTranspilerOptions } from './server-module-transpiler.service.js';
|
|
3
|
-
/**
|
|
4
|
-
* High-level module-loading options owned by the framework loader boundary.
|
|
5
|
-
*
|
|
6
|
-
* @remarks
|
|
7
|
-
* These are the same shape the lower-level transpiler needs, minus the
|
|
8
|
-
* root/build-executor ownership that the loader keeps internally.
|
|
9
|
-
*/
|
|
10
|
-
export interface ServerLoaderModuleOptions extends ServerModuleTranspilerOptions {
|
|
11
|
-
plugins?: EcoBuildPlugin[];
|
|
12
|
-
}
|
|
13
|
-
/**
|
|
14
|
-
* Mutable app-phase server-loading context.
|
|
15
|
-
*
|
|
16
|
-
* @remarks
|
|
17
|
-
* The loader starts with bootstrap config-loading context. Once a real built
|
|
18
|
-
* app config is available, the runtime adapter rebinds the loader so app-entry
|
|
19
|
-
* and downstream server modules load through the app-owned executor.
|
|
20
|
-
*/
|
|
21
|
-
export interface ServerLoaderAppContext extends ServerModuleTranspilerBootstrapArgs {
|
|
22
|
-
}
|
|
23
|
-
/**
|
|
24
|
-
* Minimal transpiler dependency required by the server loader.
|
|
25
|
-
*
|
|
26
|
-
* @remarks
|
|
27
|
-
* The loader owns orchestration between bootstrap and app phases, so tests only
|
|
28
|
-
* need this narrow import/invalidate/dispose surface rather than the concrete
|
|
29
|
-
* transpiler class.
|
|
30
|
-
*/
|
|
31
|
-
export interface ServerLoaderTranspilerDependency {
|
|
32
|
-
importModule<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
33
|
-
invalidate(changedFiles?: string[]): void;
|
|
34
|
-
dispose(): Promise<void>;
|
|
35
|
-
}
|
|
36
|
-
/**
|
|
37
|
-
* Factory dependency used by the loader to create phase-specific transpilers.
|
|
38
|
-
*/
|
|
39
|
-
export interface ServerLoaderDependencyFactory {
|
|
40
|
-
createTranspiler(context: ServerModuleTranspilerBootstrapArgs): ServerLoaderTranspilerDependency;
|
|
41
|
-
}
|
|
42
|
-
/**
|
|
43
|
-
* Framework-owned server loading boundary.
|
|
44
|
-
*
|
|
45
|
-
* @remarks
|
|
46
|
-
* This abstraction owns config loading, app-entry loading, and cache lifecycle
|
|
47
|
-
* for the Node thin-host runtime path. Hosts and runtime adapters should depend
|
|
48
|
-
* on this boundary rather than coordinating raw transpiler instances directly.
|
|
49
|
-
*/
|
|
50
|
-
export interface ServerLoader {
|
|
51
|
-
/**
|
|
52
|
-
* Loads the bootstrap config module through the bootstrap server-loading
|
|
53
|
-
* context.
|
|
54
|
-
*/
|
|
55
|
-
loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
56
|
-
/**
|
|
57
|
-
* Loads the app entry module through the currently active app context.
|
|
58
|
-
*
|
|
59
|
-
* @remarks
|
|
60
|
-
* Until app context is rebound, this falls back to the bootstrap context so a
|
|
61
|
-
* caller can still load through one boundary during early bootstrap.
|
|
62
|
-
*/
|
|
63
|
-
loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
64
|
-
/**
|
|
65
|
-
* Rebinds the app-phase loading context after a real app config has been
|
|
66
|
-
* loaded and app-owned build services are available.
|
|
67
|
-
*/
|
|
68
|
-
rebindAppContext(context: ServerLoaderAppContext): void;
|
|
69
|
-
/**
|
|
70
|
-
* Invalidates cached server module state for development reloads.
|
|
71
|
-
*/
|
|
72
|
-
invalidate(changedFiles?: string[]): void;
|
|
73
|
-
/**
|
|
74
|
-
* Releases loader-owned resources.
|
|
75
|
-
*/
|
|
76
|
-
dispose(): Promise<void>;
|
|
77
|
-
}
|
|
78
|
-
/**
|
|
79
|
-
* `ServerLoader` implementation backed by `ServerModuleTranspiler` instances.
|
|
80
|
-
*
|
|
81
|
-
* @remarks
|
|
82
|
-
* This is the first named loader abstraction for Workstream 3. It keeps the
|
|
83
|
-
* lower-level transpiler as the implementation detail while moving ownership of
|
|
84
|
-
* config/app entry orchestration into one service boundary.
|
|
85
|
-
*/
|
|
86
|
-
export declare class TranspilerServerLoader implements ServerLoader {
|
|
87
|
-
private readonly createTranspiler;
|
|
88
|
-
private readonly configTranspiler;
|
|
89
|
-
private appTranspiler;
|
|
90
|
-
constructor(configContext: ServerModuleTranspilerBootstrapArgs, dependencies?: ServerLoaderDependencyFactory);
|
|
91
|
-
loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
92
|
-
loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
93
|
-
rebindAppContext(context: ServerLoaderAppContext): void;
|
|
94
|
-
invalidate(changedFiles?: string[]): void;
|
|
95
|
-
dispose(): Promise<void>;
|
|
96
|
-
}
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
ServerModuleTranspiler
|
|
3
|
-
} from "./server-module-transpiler.service.js";
|
|
4
|
-
class TranspilerServerLoader {
|
|
5
|
-
createTranspiler;
|
|
6
|
-
configTranspiler;
|
|
7
|
-
appTranspiler = null;
|
|
8
|
-
constructor(configContext, dependencies) {
|
|
9
|
-
this.createTranspiler = dependencies?.createTranspiler ?? ((context) => new ServerModuleTranspiler(context));
|
|
10
|
-
this.configTranspiler = this.createTranspiler(configContext);
|
|
11
|
-
}
|
|
12
|
-
async loadConfig(options) {
|
|
13
|
-
return await this.configTranspiler.importModule(options);
|
|
14
|
-
}
|
|
15
|
-
async loadApp(options) {
|
|
16
|
-
return await (this.appTranspiler ?? this.configTranspiler).importModule(options);
|
|
17
|
-
}
|
|
18
|
-
rebindAppContext(context) {
|
|
19
|
-
this.appTranspiler = this.createTranspiler(context);
|
|
20
|
-
}
|
|
21
|
-
invalidate(changedFiles) {
|
|
22
|
-
this.configTranspiler.invalidate(changedFiles);
|
|
23
|
-
this.appTranspiler?.invalidate(changedFiles);
|
|
24
|
-
}
|
|
25
|
-
async dispose() {
|
|
26
|
-
await this.appTranspiler?.dispose();
|
|
27
|
-
await this.configTranspiler.dispose();
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
export {
|
|
31
|
-
TranspilerServerLoader
|
|
32
|
-
};
|
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
import type { EcoBuildPlugin } from '../../build/build-types.js';
|
|
2
|
-
import {
|
|
3
|
-
ServerModuleTranspiler,
|
|
4
|
-
type ServerModuleTranspilerBootstrapArgs,
|
|
5
|
-
type ServerModuleTranspilerOptions,
|
|
6
|
-
} from './server-module-transpiler.service.ts';
|
|
7
|
-
|
|
8
|
-
/**
|
|
9
|
-
* High-level module-loading options owned by the framework loader boundary.
|
|
10
|
-
*
|
|
11
|
-
* @remarks
|
|
12
|
-
* These are the same shape the lower-level transpiler needs, minus the
|
|
13
|
-
* root/build-executor ownership that the loader keeps internally.
|
|
14
|
-
*/
|
|
15
|
-
export interface ServerLoaderModuleOptions extends ServerModuleTranspilerOptions {
|
|
16
|
-
plugins?: EcoBuildPlugin[];
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
* Mutable app-phase server-loading context.
|
|
21
|
-
*
|
|
22
|
-
* @remarks
|
|
23
|
-
* The loader starts with bootstrap config-loading context. Once a real built
|
|
24
|
-
* app config is available, the runtime adapter rebinds the loader so app-entry
|
|
25
|
-
* and downstream server modules load through the app-owned executor.
|
|
26
|
-
*/
|
|
27
|
-
export interface ServerLoaderAppContext extends ServerModuleTranspilerBootstrapArgs {}
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* Minimal transpiler dependency required by the server loader.
|
|
31
|
-
*
|
|
32
|
-
* @remarks
|
|
33
|
-
* The loader owns orchestration between bootstrap and app phases, so tests only
|
|
34
|
-
* need this narrow import/invalidate/dispose surface rather than the concrete
|
|
35
|
-
* transpiler class.
|
|
36
|
-
*/
|
|
37
|
-
export interface ServerLoaderTranspilerDependency {
|
|
38
|
-
importModule<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
39
|
-
invalidate(changedFiles?: string[]): void;
|
|
40
|
-
dispose(): Promise<void>;
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
/**
|
|
44
|
-
* Factory dependency used by the loader to create phase-specific transpilers.
|
|
45
|
-
*/
|
|
46
|
-
export interface ServerLoaderDependencyFactory {
|
|
47
|
-
createTranspiler(context: ServerModuleTranspilerBootstrapArgs): ServerLoaderTranspilerDependency;
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
/**
|
|
51
|
-
* Framework-owned server loading boundary.
|
|
52
|
-
*
|
|
53
|
-
* @remarks
|
|
54
|
-
* This abstraction owns config loading, app-entry loading, and cache lifecycle
|
|
55
|
-
* for the Node thin-host runtime path. Hosts and runtime adapters should depend
|
|
56
|
-
* on this boundary rather than coordinating raw transpiler instances directly.
|
|
57
|
-
*/
|
|
58
|
-
export interface ServerLoader {
|
|
59
|
-
/**
|
|
60
|
-
* Loads the bootstrap config module through the bootstrap server-loading
|
|
61
|
-
* context.
|
|
62
|
-
*/
|
|
63
|
-
loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
64
|
-
|
|
65
|
-
/**
|
|
66
|
-
* Loads the app entry module through the currently active app context.
|
|
67
|
-
*
|
|
68
|
-
* @remarks
|
|
69
|
-
* Until app context is rebound, this falls back to the bootstrap context so a
|
|
70
|
-
* caller can still load through one boundary during early bootstrap.
|
|
71
|
-
*/
|
|
72
|
-
loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T>;
|
|
73
|
-
|
|
74
|
-
/**
|
|
75
|
-
* Rebinds the app-phase loading context after a real app config has been
|
|
76
|
-
* loaded and app-owned build services are available.
|
|
77
|
-
*/
|
|
78
|
-
rebindAppContext(context: ServerLoaderAppContext): void;
|
|
79
|
-
|
|
80
|
-
/**
|
|
81
|
-
* Invalidates cached server module state for development reloads.
|
|
82
|
-
*/
|
|
83
|
-
invalidate(changedFiles?: string[]): void;
|
|
84
|
-
|
|
85
|
-
/**
|
|
86
|
-
* Releases loader-owned resources.
|
|
87
|
-
*/
|
|
88
|
-
dispose(): Promise<void>;
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
/**
|
|
92
|
-
* `ServerLoader` implementation backed by `ServerModuleTranspiler` instances.
|
|
93
|
-
*
|
|
94
|
-
* @remarks
|
|
95
|
-
* This is the first named loader abstraction for Workstream 3. It keeps the
|
|
96
|
-
* lower-level transpiler as the implementation detail while moving ownership of
|
|
97
|
-
* config/app entry orchestration into one service boundary.
|
|
98
|
-
*/
|
|
99
|
-
export class TranspilerServerLoader implements ServerLoader {
|
|
100
|
-
private readonly createTranspiler: ServerLoaderDependencyFactory['createTranspiler'];
|
|
101
|
-
private readonly configTranspiler: ServerLoaderTranspilerDependency;
|
|
102
|
-
private appTranspiler: ServerLoaderTranspilerDependency | null = null;
|
|
103
|
-
|
|
104
|
-
constructor(configContext: ServerModuleTranspilerBootstrapArgs, dependencies?: ServerLoaderDependencyFactory) {
|
|
105
|
-
this.createTranspiler = dependencies?.createTranspiler ?? ((context) => new ServerModuleTranspiler(context));
|
|
106
|
-
this.configTranspiler = this.createTranspiler(configContext);
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
async loadConfig<T = unknown>(options: ServerLoaderModuleOptions): Promise<T> {
|
|
110
|
-
return await this.configTranspiler.importModule<T>(options);
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
async loadApp<T = unknown>(options: ServerLoaderModuleOptions): Promise<T> {
|
|
114
|
-
return await (this.appTranspiler ?? this.configTranspiler).importModule<T>(options);
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
rebindAppContext(context: ServerLoaderAppContext): void {
|
|
118
|
-
this.appTranspiler = this.createTranspiler(context);
|
|
119
|
-
}
|
|
120
|
-
|
|
121
|
-
invalidate(changedFiles?: string[]): void {
|
|
122
|
-
this.configTranspiler.invalidate(changedFiles);
|
|
123
|
-
this.appTranspiler?.invalidate(changedFiles);
|
|
124
|
-
}
|
|
125
|
-
|
|
126
|
-
async dispose(): Promise<void> {
|
|
127
|
-
await this.appTranspiler?.dispose();
|
|
128
|
-
await this.configTranspiler.dispose();
|
|
129
|
-
}
|
|
130
|
-
}
|
|
@@ -1,105 +0,0 @@
|
|
|
1
|
-
import type { BuildExecutor } from '../../build/build-adapter.js';
|
|
2
|
-
import type { EcoBuildPlugin } from '../../build/build-types.ts';
|
|
3
|
-
import { PageModuleImportService, type PageModuleImportOptions } from './page-module-import.service.ts';
|
|
4
|
-
|
|
5
|
-
export type ServerModuleTranspilerOptions = Omit<PageModuleImportOptions, 'rootDir' | 'buildExecutor'>;
|
|
6
|
-
|
|
7
|
-
/**
|
|
8
|
-
* Minimal import-service dependency required by the server module transpiler.
|
|
9
|
-
*
|
|
10
|
-
* @remarks
|
|
11
|
-
* This keeps the transpiler boundary testable without module-level mocking and
|
|
12
|
-
* lets callers provide an app-owned import implementation when needed.
|
|
13
|
-
*/
|
|
14
|
-
export interface ServerModuleImportDependency {
|
|
15
|
-
importModule<T = unknown>(options: PageModuleImportOptions): Promise<T>;
|
|
16
|
-
invalidateDevelopmentGraph(): void;
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
* Immutable execution context for one server-transpiler instance.
|
|
21
|
-
*
|
|
22
|
-
* @remarks
|
|
23
|
-
* Callers own when and why a new transpiler is created. This service only owns
|
|
24
|
-
* applying the supplied root/build-executor pair consistently to every module
|
|
25
|
-
* load that passes through it.
|
|
26
|
-
*/
|
|
27
|
-
export type ServerModuleTranspilerBootstrapArgs = {
|
|
28
|
-
rootDir: string;
|
|
29
|
-
getBuildExecutor: () => BuildExecutor | undefined;
|
|
30
|
-
getInvalidationVersion?: () => number;
|
|
31
|
-
invalidateModules?: (changedFiles?: string[]) => void;
|
|
32
|
-
pageModuleImportService?: ServerModuleImportDependency;
|
|
33
|
-
/** Factory evaluated on each importModule call to produce plugins applied to every load. */
|
|
34
|
-
getDefaultPlugins?: () => EcoBuildPlugin[];
|
|
35
|
-
};
|
|
36
|
-
|
|
37
|
-
/**
|
|
38
|
-
* App-owned boundary for server-side source module loading.
|
|
39
|
-
*
|
|
40
|
-
* @remarks
|
|
41
|
-
* This service centralizes server-side module transpilation and import behind
|
|
42
|
-
* an explicit caller-owned root and build executor.
|
|
43
|
-
*/
|
|
44
|
-
export class ServerModuleTranspiler {
|
|
45
|
-
private readonly pageModuleImportService: ServerModuleImportDependency;
|
|
46
|
-
private readonly getRootDir: () => string;
|
|
47
|
-
private readonly getBuildExecutor: () => BuildExecutor | undefined;
|
|
48
|
-
private readonly getInvalidationVersion: () => number | undefined;
|
|
49
|
-
private readonly invalidateModules: (changedFiles?: string[]) => void;
|
|
50
|
-
private readonly getDefaultPlugins: () => EcoBuildPlugin[];
|
|
51
|
-
|
|
52
|
-
/**
|
|
53
|
-
* Creates one explicit server-transpiler boundary for a given execution
|
|
54
|
-
* context.
|
|
55
|
-
*/
|
|
56
|
-
constructor(args: ServerModuleTranspilerBootstrapArgs) {
|
|
57
|
-
this.pageModuleImportService = args.pageModuleImportService ?? new PageModuleImportService();
|
|
58
|
-
this.getRootDir = () => args.rootDir;
|
|
59
|
-
this.getBuildExecutor = args.getBuildExecutor;
|
|
60
|
-
this.getInvalidationVersion = () => args.getInvalidationVersion?.();
|
|
61
|
-
this.getDefaultPlugins = args.getDefaultPlugins ?? (() => []);
|
|
62
|
-
this.invalidateModules = (changedFiles) => {
|
|
63
|
-
if (args.invalidateModules) {
|
|
64
|
-
args.invalidateModules(changedFiles);
|
|
65
|
-
return;
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
this.pageModuleImportService.invalidateDevelopmentGraph();
|
|
69
|
-
};
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
/**
|
|
73
|
-
* Loads a server-side source module through the caller-owned transpile
|
|
74
|
-
* context.
|
|
75
|
-
*/
|
|
76
|
-
async importModule<T = unknown>(options: ServerModuleTranspilerOptions): Promise<T> {
|
|
77
|
-
const mergedPlugins = [...this.getDefaultPlugins(), ...(options.plugins ?? [])];
|
|
78
|
-
const { plugins: _plugins, ...baseOptions } = options;
|
|
79
|
-
return await this.pageModuleImportService.importModule<T>({
|
|
80
|
-
...baseOptions,
|
|
81
|
-
...(mergedPlugins.length > 0 ? { plugins: mergedPlugins } : {}),
|
|
82
|
-
rootDir: this.getRootDir(),
|
|
83
|
-
buildExecutor: this.getBuildExecutor(),
|
|
84
|
-
invalidationVersion: this.getInvalidationVersion(),
|
|
85
|
-
});
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* Invalidates cached module state for development reloads.
|
|
90
|
-
*/
|
|
91
|
-
invalidate(changedFiles?: string[]): void {
|
|
92
|
-
this.invalidateModules(changedFiles);
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
/**
|
|
96
|
-
* Releases transpiler-owned resources.
|
|
97
|
-
*
|
|
98
|
-
* @remarks
|
|
99
|
-
* The current implementation delegates cache ownership to lower-level module
|
|
100
|
-
* loading services, so disposal is intentionally a no-op for now.
|
|
101
|
-
*/
|
|
102
|
-
async dispose(): Promise<void> {
|
|
103
|
-
return;
|
|
104
|
-
}
|
|
105
|
-
}
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
import type { EcoPagesAppConfig } from '../../internal-types.js';
|
|
2
|
-
export interface NodeRuntimeManifest {
|
|
3
|
-
runtime: 'node';
|
|
4
|
-
appRootDir: string;
|
|
5
|
-
sourceRootDir: string;
|
|
6
|
-
distDir: string;
|
|
7
|
-
workDir?: string;
|
|
8
|
-
modulePaths: {
|
|
9
|
-
config: string;
|
|
10
|
-
entry?: string;
|
|
11
|
-
};
|
|
12
|
-
}
|
|
13
|
-
/**
|
|
14
|
-
* Returns the default file handoff location for the Node runtime manifest.
|
|
15
|
-
*/
|
|
16
|
-
export declare function getNodeRuntimeManifestPath(appConfig: EcoPagesAppConfig): string;
|
|
17
|
-
export declare function createNodeRuntimeManifest(appConfig: EcoPagesAppConfig, options?: {
|
|
18
|
-
entryModulePath?: string;
|
|
19
|
-
}): NodeRuntimeManifest;
|
|
20
|
-
/**
|
|
21
|
-
* Serializes a Node runtime manifest to the file boundary used by the thin host.
|
|
22
|
-
*/
|
|
23
|
-
export declare function writeNodeRuntimeManifestFile(manifest: NodeRuntimeManifest, manifestFilePath: string): string;
|
|
24
|
-
/**
|
|
25
|
-
* Derives the app-owned Node manifest and writes it to the runtime handoff path.
|
|
26
|
-
*/
|
|
27
|
-
export declare function writeAppNodeRuntimeManifest(appConfig: EcoPagesAppConfig, options?: {
|
|
28
|
-
entryModulePath?: string;
|
|
29
|
-
manifestFilePath?: string;
|
|
30
|
-
}): {
|
|
31
|
-
manifest: NodeRuntimeManifest;
|
|
32
|
-
manifestFilePath: string;
|
|
33
|
-
};
|
|
34
|
-
export declare function getAppNodeRuntimeManifest(appConfig: EcoPagesAppConfig): NodeRuntimeManifest;
|
|
35
|
-
export declare function setAppNodeRuntimeManifest(appConfig: EcoPagesAppConfig, nodeRuntimeManifest: NodeRuntimeManifest): void;
|
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
import { mkdirSync, writeFileSync } from "node:fs";
|
|
2
|
-
import path from "node:path";
|
|
3
|
-
import { DEFAULT_ECOPAGES_WORK_DIR } from "../../constants.js";
|
|
4
|
-
const NODE_RUNTIME_MANIFEST_DIRNAME = "runtime";
|
|
5
|
-
const NODE_RUNTIME_MANIFEST_FILENAME = "node-runtime-manifest.json";
|
|
6
|
-
function getNodeRuntimeManifestPath(appConfig) {
|
|
7
|
-
return path.join(resolveWorkDir(appConfig), NODE_RUNTIME_MANIFEST_DIRNAME, NODE_RUNTIME_MANIFEST_FILENAME);
|
|
8
|
-
}
|
|
9
|
-
function resolveWorkDir(appConfig) {
|
|
10
|
-
return appConfig.absolutePaths?.workDir ?? path.join(appConfig.rootDir, appConfig.workDir ?? DEFAULT_ECOPAGES_WORK_DIR);
|
|
11
|
-
}
|
|
12
|
-
function createNodeRuntimeManifest(appConfig, options) {
|
|
13
|
-
return {
|
|
14
|
-
runtime: "node",
|
|
15
|
-
appRootDir: appConfig.rootDir,
|
|
16
|
-
sourceRootDir: appConfig.absolutePaths.srcDir,
|
|
17
|
-
distDir: appConfig.absolutePaths.distDir,
|
|
18
|
-
workDir: resolveWorkDir(appConfig),
|
|
19
|
-
modulePaths: {
|
|
20
|
-
config: appConfig.absolutePaths.config,
|
|
21
|
-
...options?.entryModulePath ? { entry: options.entryModulePath } : {}
|
|
22
|
-
}
|
|
23
|
-
};
|
|
24
|
-
}
|
|
25
|
-
function writeNodeRuntimeManifestFile(manifest, manifestFilePath) {
|
|
26
|
-
mkdirSync(path.dirname(manifestFilePath), { recursive: true });
|
|
27
|
-
writeFileSync(manifestFilePath, `${JSON.stringify(manifest, null, 2)}
|
|
28
|
-
`, "utf8");
|
|
29
|
-
return manifestFilePath;
|
|
30
|
-
}
|
|
31
|
-
function writeAppNodeRuntimeManifest(appConfig, options) {
|
|
32
|
-
const manifest = createNodeRuntimeManifest(appConfig, {
|
|
33
|
-
entryModulePath: options?.entryModulePath
|
|
34
|
-
});
|
|
35
|
-
const manifestFilePath = writeNodeRuntimeManifestFile(
|
|
36
|
-
manifest,
|
|
37
|
-
options?.manifestFilePath ?? getNodeRuntimeManifestPath(appConfig)
|
|
38
|
-
);
|
|
39
|
-
return {
|
|
40
|
-
manifest,
|
|
41
|
-
manifestFilePath
|
|
42
|
-
};
|
|
43
|
-
}
|
|
44
|
-
function getAppNodeRuntimeManifest(appConfig) {
|
|
45
|
-
return appConfig.runtime?.nodeRuntimeManifest ?? createNodeRuntimeManifest(appConfig);
|
|
46
|
-
}
|
|
47
|
-
function setAppNodeRuntimeManifest(appConfig, nodeRuntimeManifest) {
|
|
48
|
-
appConfig.runtime = {
|
|
49
|
-
...appConfig.runtime ?? {},
|
|
50
|
-
nodeRuntimeManifest
|
|
51
|
-
};
|
|
52
|
-
}
|
|
53
|
-
export {
|
|
54
|
-
createNodeRuntimeManifest,
|
|
55
|
-
getAppNodeRuntimeManifest,
|
|
56
|
-
getNodeRuntimeManifestPath,
|
|
57
|
-
setAppNodeRuntimeManifest,
|
|
58
|
-
writeAppNodeRuntimeManifest,
|
|
59
|
-
writeNodeRuntimeManifestFile
|
|
60
|
-
};
|