@ecopages/core 0.2.0-alpha.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 +89 -0
- package/LICENSE +21 -0
- package/README.md +32 -0
- package/package.json +279 -0
- package/src/adapters/abstract/application-adapter.d.ts +168 -0
- package/src/adapters/abstract/application-adapter.js +109 -0
- package/src/adapters/abstract/application-adapter.ts +337 -0
- package/src/adapters/abstract/router-adapter.d.ts +26 -0
- package/src/adapters/abstract/router-adapter.js +5 -0
- package/src/adapters/abstract/router-adapter.ts +30 -0
- package/src/adapters/abstract/server-adapter.d.ts +69 -0
- package/src/adapters/abstract/server-adapter.js +15 -0
- package/src/adapters/abstract/server-adapter.ts +79 -0
- package/src/adapters/bun/client-bridge.d.ts +34 -0
- package/src/adapters/bun/client-bridge.js +48 -0
- package/src/adapters/bun/client-bridge.ts +62 -0
- package/src/adapters/bun/create-app.d.ts +60 -0
- package/src/adapters/bun/create-app.js +117 -0
- package/src/adapters/bun/create-app.ts +189 -0
- package/src/adapters/bun/define-api-handler.d.ts +61 -0
- package/src/adapters/bun/define-api-handler.js +15 -0
- package/src/adapters/bun/define-api-handler.ts +114 -0
- package/src/adapters/bun/hmr-manager.d.ts +84 -0
- package/src/adapters/bun/hmr-manager.js +227 -0
- package/src/adapters/bun/hmr-manager.ts +281 -0
- package/src/adapters/bun/index.d.ts +3 -0
- package/src/adapters/bun/index.js +8 -0
- package/src/adapters/bun/index.ts +3 -0
- package/src/adapters/bun/server-adapter.d.ts +155 -0
- package/src/adapters/bun/server-adapter.js +368 -0
- package/src/adapters/bun/server-adapter.ts +492 -0
- package/src/adapters/bun/server-lifecycle.d.ts +52 -0
- package/src/adapters/bun/server-lifecycle.js +120 -0
- package/src/adapters/bun/server-lifecycle.ts +154 -0
- package/src/adapters/index.d.ts +6 -0
- package/src/adapters/index.js +14 -0
- package/src/adapters/index.ts +6 -0
- package/src/adapters/node/create-app.d.ts +21 -0
- package/src/adapters/node/create-app.js +143 -0
- package/src/adapters/node/create-app.ts +179 -0
- package/src/adapters/node/index.d.ts +4 -0
- package/src/adapters/node/index.js +8 -0
- package/src/adapters/node/index.ts +9 -0
- package/src/adapters/node/node-client-bridge.d.ts +26 -0
- package/src/adapters/node/node-client-bridge.js +66 -0
- package/src/adapters/node/node-client-bridge.ts +79 -0
- package/src/adapters/node/node-hmr-manager.d.ts +62 -0
- package/src/adapters/node/node-hmr-manager.js +221 -0
- package/src/adapters/node/node-hmr-manager.ts +271 -0
- package/src/adapters/node/server-adapter.d.ts +190 -0
- package/src/adapters/node/server-adapter.js +420 -0
- package/src/adapters/node/server-adapter.ts +561 -0
- package/src/adapters/node/static-content-server.d.ts +24 -0
- package/src/adapters/node/static-content-server.js +166 -0
- package/src/adapters/node/static-content-server.ts +203 -0
- package/src/adapters/shared/api-response.d.ts +52 -0
- package/src/adapters/shared/api-response.js +96 -0
- package/src/adapters/shared/api-response.ts +104 -0
- package/src/adapters/shared/application-adapter.d.ts +18 -0
- package/src/adapters/shared/application-adapter.js +90 -0
- package/src/adapters/shared/application-adapter.ts +199 -0
- package/src/adapters/shared/explicit-static-route-matcher.d.ts +38 -0
- package/src/adapters/shared/explicit-static-route-matcher.js +100 -0
- package/src/adapters/shared/explicit-static-route-matcher.ts +134 -0
- package/src/adapters/shared/file-route-middleware-pipeline.d.ts +65 -0
- package/src/adapters/shared/file-route-middleware-pipeline.js +98 -0
- package/src/adapters/shared/file-route-middleware-pipeline.ts +123 -0
- package/src/adapters/shared/fs-server-response-factory.d.ts +19 -0
- package/src/adapters/shared/fs-server-response-factory.js +97 -0
- package/src/adapters/shared/fs-server-response-factory.ts +118 -0
- package/src/adapters/shared/fs-server-response-matcher.d.ts +71 -0
- package/src/adapters/shared/fs-server-response-matcher.js +155 -0
- package/src/adapters/shared/fs-server-response-matcher.ts +198 -0
- package/src/adapters/shared/render-context.d.ts +14 -0
- package/src/adapters/shared/render-context.js +69 -0
- package/src/adapters/shared/render-context.ts +105 -0
- package/src/adapters/shared/server-adapter.d.ts +87 -0
- package/src/adapters/shared/server-adapter.js +353 -0
- package/src/adapters/shared/server-adapter.ts +442 -0
- package/src/adapters/shared/server-route-handler.d.ts +89 -0
- package/src/adapters/shared/server-route-handler.js +120 -0
- package/src/adapters/shared/server-route-handler.ts +166 -0
- package/src/adapters/shared/server-static-builder.d.ts +38 -0
- package/src/adapters/shared/server-static-builder.js +46 -0
- package/src/adapters/shared/server-static-builder.ts +82 -0
- package/src/build/build-adapter.d.ts +74 -0
- package/src/build/build-adapter.js +54 -0
- package/src/build/build-adapter.ts +132 -0
- package/src/build/build-types.d.ts +57 -0
- package/src/build/build-types.js +0 -0
- package/src/build/build-types.ts +83 -0
- package/src/build/esbuild-build-adapter.d.ts +69 -0
- package/src/build/esbuild-build-adapter.js +390 -0
- package/src/build/esbuild-build-adapter.ts +510 -0
- package/src/config/config-builder.d.ts +227 -0
- package/src/config/config-builder.js +392 -0
- package/src/config/config-builder.ts +474 -0
- package/src/constants.d.ts +32 -0
- package/src/constants.js +21 -0
- package/src/constants.ts +39 -0
- package/src/create-app.d.ts +17 -0
- package/src/create-app.js +66 -0
- package/src/create-app.ts +87 -0
- package/src/declarations.d.ts +26 -0
- package/src/define-api-handler.d.ts +25 -0
- package/src/define-api-handler.js +15 -0
- package/src/define-api-handler.ts +66 -0
- package/src/dev/sc-server.d.ts +30 -0
- package/src/dev/sc-server.js +111 -0
- package/src/dev/sc-server.ts +143 -0
- package/src/eco/README.md +636 -0
- package/src/eco/component-render-context.d.ts +105 -0
- package/src/eco/component-render-context.js +77 -0
- package/src/eco/component-render-context.ts +202 -0
- package/src/eco/eco.d.ts +9 -0
- package/src/eco/eco.js +110 -0
- package/src/eco/eco.ts +221 -0
- package/src/eco/eco.types.d.ts +170 -0
- package/src/eco/eco.types.js +0 -0
- package/src/eco/eco.types.ts +202 -0
- package/src/eco/eco.utils.d.ts +40 -0
- package/src/eco/eco.utils.js +40 -0
- package/src/eco/eco.utils.ts +89 -0
- package/src/eco/global-injector-map.d.ts +16 -0
- package/src/eco/global-injector-map.js +80 -0
- package/src/eco/global-injector-map.ts +112 -0
- package/src/eco/lazy-injector-map.d.ts +8 -0
- package/src/eco/lazy-injector-map.js +70 -0
- package/src/eco/lazy-injector-map.ts +120 -0
- package/src/eco/module-dependencies.d.ts +18 -0
- package/src/eco/module-dependencies.js +49 -0
- package/src/eco/module-dependencies.ts +75 -0
- package/src/env.d.ts +20 -0
- package/src/errors/http-error.d.ts +31 -0
- package/src/errors/http-error.js +50 -0
- package/src/errors/http-error.ts +72 -0
- package/src/errors/index.d.ts +2 -0
- package/src/errors/index.js +4 -0
- package/src/errors/index.ts +2 -0
- package/src/errors/locals-access-error.d.ts +4 -0
- package/src/errors/locals-access-error.js +9 -0
- package/src/errors/locals-access-error.ts +7 -0
- package/src/global/app-logger.d.ts +2 -0
- package/src/global/app-logger.js +6 -0
- package/src/global/app-logger.ts +4 -0
- 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.d.ts +10 -0
- package/src/hmr/client/hmr-runtime.js +86 -0
- package/src/hmr/client/hmr-runtime.ts +121 -0
- package/src/hmr/hmr-strategy.d.ts +159 -0
- package/src/hmr/hmr-strategy.js +29 -0
- package/src/hmr/hmr-strategy.ts +172 -0
- package/src/hmr/hmr.test.e2e.d.ts +1 -0
- package/src/hmr/hmr.test.e2e.js +50 -0
- package/src/hmr/hmr.test.e2e.ts +75 -0
- package/src/hmr/strategies/default-hmr-strategy.d.ts +43 -0
- package/src/hmr/strategies/default-hmr-strategy.js +34 -0
- package/src/hmr/strategies/default-hmr-strategy.ts +60 -0
- package/src/hmr/strategies/js-hmr-strategy.d.ts +136 -0
- package/src/hmr/strategies/js-hmr-strategy.js +179 -0
- package/src/hmr/strategies/js-hmr-strategy.ts +308 -0
- package/src/index.browser.d.ts +3 -0
- package/src/index.browser.js +4 -0
- package/src/index.browser.ts +3 -0
- package/src/index.d.ts +5 -0
- package/src/index.js +10 -0
- package/src/index.ts +5 -0
- package/src/integrations/ghtml/ghtml-renderer.d.ts +15 -0
- package/src/integrations/ghtml/ghtml-renderer.js +60 -0
- package/src/integrations/ghtml/ghtml-renderer.ts +93 -0
- package/src/integrations/ghtml/ghtml.plugin.d.ts +20 -0
- package/src/integrations/ghtml/ghtml.plugin.js +21 -0
- package/src/integrations/ghtml/ghtml.plugin.ts +32 -0
- package/src/internal-types.d.ts +200 -0
- package/src/internal-types.js +0 -0
- package/src/internal-types.ts +212 -0
- package/src/plugins/alias-resolver-plugin.d.ts +2 -0
- package/src/plugins/alias-resolver-plugin.js +39 -0
- package/src/plugins/alias-resolver-plugin.ts +45 -0
- package/src/plugins/eco-component-meta-plugin.d.ts +95 -0
- package/src/plugins/eco-component-meta-plugin.js +157 -0
- package/src/plugins/eco-component-meta-plugin.ts +474 -0
- package/src/plugins/integration-plugin.d.ts +102 -0
- package/src/plugins/integration-plugin.js +100 -0
- package/src/plugins/integration-plugin.ts +184 -0
- package/src/plugins/processor.d.ts +82 -0
- package/src/plugins/processor.js +122 -0
- package/src/plugins/processor.ts +220 -0
- package/src/public-types.d.ts +1094 -0
- package/src/public-types.js +0 -0
- package/src/public-types.ts +1255 -0
- package/src/route-renderer/GRAPH.md +387 -0
- package/src/route-renderer/README.md +135 -0
- package/src/route-renderer/component-graph-executor.d.ts +32 -0
- package/src/route-renderer/component-graph-executor.js +31 -0
- package/src/route-renderer/component-graph-executor.ts +84 -0
- package/src/route-renderer/component-graph.d.ts +42 -0
- package/src/route-renderer/component-graph.js +72 -0
- package/src/route-renderer/component-graph.ts +159 -0
- package/src/route-renderer/component-marker.d.ts +52 -0
- package/src/route-renderer/component-marker.js +46 -0
- package/src/route-renderer/component-marker.ts +117 -0
- package/src/route-renderer/dependency-resolver.d.ts +24 -0
- package/src/route-renderer/dependency-resolver.js +428 -0
- package/src/route-renderer/dependency-resolver.ts +596 -0
- package/src/route-renderer/html-post-processing.service.d.ts +40 -0
- package/src/route-renderer/html-post-processing.service.js +86 -0
- package/src/route-renderer/html-post-processing.service.ts +103 -0
- package/src/route-renderer/integration-renderer.d.ts +339 -0
- package/src/route-renderer/integration-renderer.js +526 -0
- package/src/route-renderer/integration-renderer.ts +696 -0
- package/src/route-renderer/marker-graph-resolver.d.ts +76 -0
- package/src/route-renderer/marker-graph-resolver.js +93 -0
- package/src/route-renderer/marker-graph-resolver.ts +153 -0
- package/src/route-renderer/page-module-loader.d.ts +61 -0
- package/src/route-renderer/page-module-loader.js +102 -0
- package/src/route-renderer/page-module-loader.ts +153 -0
- package/src/route-renderer/render-execution.service.d.ts +69 -0
- package/src/route-renderer/render-execution.service.js +91 -0
- package/src/route-renderer/render-execution.service.ts +158 -0
- package/src/route-renderer/render-preparation.service.d.ts +112 -0
- package/src/route-renderer/render-preparation.service.js +243 -0
- package/src/route-renderer/render-preparation.service.ts +358 -0
- package/src/route-renderer/route-renderer.d.ts +26 -0
- package/src/route-renderer/route-renderer.js +68 -0
- package/src/route-renderer/route-renderer.ts +80 -0
- package/src/router/fs-router-scanner.d.ts +41 -0
- package/src/router/fs-router-scanner.js +155 -0
- package/src/router/fs-router-scanner.ts +217 -0
- package/src/router/fs-router.d.ts +26 -0
- package/src/router/fs-router.js +100 -0
- package/src/router/fs-router.ts +122 -0
- package/src/services/asset-processing-service/asset-processing.service.d.ts +41 -0
- package/src/services/asset-processing-service/asset-processing.service.js +250 -0
- package/src/services/asset-processing-service/asset-processing.service.ts +306 -0
- package/src/services/asset-processing-service/asset.factory.d.ts +17 -0
- package/src/services/asset-processing-service/asset.factory.js +82 -0
- package/src/services/asset-processing-service/asset.factory.ts +105 -0
- package/src/services/asset-processing-service/assets.types.d.ts +88 -0
- package/src/services/asset-processing-service/assets.types.js +0 -0
- package/src/services/asset-processing-service/assets.types.ts +112 -0
- package/src/services/asset-processing-service/index.d.ts +3 -0
- package/src/services/asset-processing-service/index.js +3 -0
- package/src/services/asset-processing-service/index.ts +3 -0
- package/src/services/asset-processing-service/processor.interface.d.ts +22 -0
- package/src/services/asset-processing-service/processor.interface.js +6 -0
- package/src/services/asset-processing-service/processor.interface.ts +27 -0
- package/src/services/asset-processing-service/processor.registry.d.ts +8 -0
- package/src/services/asset-processing-service/processor.registry.js +15 -0
- package/src/services/asset-processing-service/processor.registry.ts +18 -0
- package/src/services/asset-processing-service/processors/base/base-processor.d.ts +24 -0
- package/src/services/asset-processing-service/processors/base/base-processor.js +59 -0
- package/src/services/asset-processing-service/processors/base/base-processor.ts +76 -0
- package/src/services/asset-processing-service/processors/base/base-script-processor.d.ts +16 -0
- package/src/services/asset-processing-service/processors/base/base-script-processor.js +80 -0
- package/src/services/asset-processing-service/processors/base/base-script-processor.ts +105 -0
- package/src/services/asset-processing-service/processors/index.d.ts +5 -0
- package/src/services/asset-processing-service/processors/index.js +5 -0
- package/src/services/asset-processing-service/processors/index.ts +5 -0
- package/src/services/asset-processing-service/processors/script/content-script.processor.d.ts +5 -0
- package/src/services/asset-processing-service/processors/script/content-script.processor.js +57 -0
- package/src/services/asset-processing-service/processors/script/content-script.processor.ts +66 -0
- package/src/services/asset-processing-service/processors/script/file-script.processor.d.ts +8 -0
- package/src/services/asset-processing-service/processors/script/file-script.processor.js +76 -0
- package/src/services/asset-processing-service/processors/script/file-script.processor.ts +88 -0
- package/src/services/asset-processing-service/processors/script/node-module-script.processor.d.ts +7 -0
- package/src/services/asset-processing-service/processors/script/node-module-script.processor.js +74 -0
- package/src/services/asset-processing-service/processors/script/node-module-script.processor.ts +84 -0
- package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts +5 -0
- package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js +25 -0
- package/src/services/asset-processing-service/processors/stylesheet/content-stylesheet.processor.ts +27 -0
- package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts +9 -0
- package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js +63 -0
- package/src/services/asset-processing-service/processors/stylesheet/file-stylesheet.processor.ts +77 -0
- package/src/services/cache/cache.types.d.ts +107 -0
- package/src/services/cache/cache.types.js +0 -0
- package/src/services/cache/cache.types.ts +126 -0
- package/src/services/cache/index.d.ts +7 -0
- package/src/services/cache/index.js +7 -0
- package/src/services/cache/index.ts +18 -0
- package/src/services/cache/memory-cache-store.d.ts +42 -0
- package/src/services/cache/memory-cache-store.js +98 -0
- package/src/services/cache/memory-cache-store.ts +130 -0
- package/src/services/cache/page-cache-service.d.ts +70 -0
- package/src/services/cache/page-cache-service.js +152 -0
- package/src/services/cache/page-cache-service.ts +202 -0
- package/src/services/html-transformer.service.d.ts +50 -0
- package/src/services/html-transformer.service.js +163 -0
- package/src/services/html-transformer.service.ts +217 -0
- package/src/services/page-module-import.service.d.ts +37 -0
- package/src/services/page-module-import.service.js +88 -0
- package/src/services/page-module-import.service.ts +129 -0
- package/src/services/page-request-cache-coordinator.service.d.ts +75 -0
- package/src/services/page-request-cache-coordinator.service.js +107 -0
- package/src/services/page-request-cache-coordinator.service.ts +128 -0
- package/src/services/schema-validation-service.d.ts +122 -0
- package/src/services/schema-validation-service.js +101 -0
- package/src/services/schema-validation-service.ts +204 -0
- package/src/services/validation/standard-schema.types.d.ts +65 -0
- package/src/services/validation/standard-schema.types.js +0 -0
- package/src/services/validation/standard-schema.types.ts +68 -0
- package/src/static-site-generator/static-site-generator.d.ts +57 -0
- package/src/static-site-generator/static-site-generator.js +272 -0
- package/src/static-site-generator/static-site-generator.ts +359 -0
- package/src/utils/css.d.ts +1 -0
- package/src/utils/css.js +7 -0
- package/src/utils/css.ts +5 -0
- package/src/utils/deep-merge.d.ts +14 -0
- package/src/utils/deep-merge.js +32 -0
- package/src/utils/deep-merge.ts +47 -0
- package/src/utils/hash.d.ts +1 -0
- package/src/utils/hash.js +7 -0
- package/src/utils/hash.ts +5 -0
- package/src/utils/html.d.ts +1 -0
- package/src/utils/html.js +4 -0
- package/src/utils/html.ts +1 -0
- package/src/utils/invariant.d.ts +5 -0
- package/src/utils/invariant.js +11 -0
- package/src/utils/invariant.ts +15 -0
- package/src/utils/locals-utils.d.ts +15 -0
- package/src/utils/locals-utils.js +24 -0
- package/src/utils/locals-utils.ts +37 -0
- package/src/utils/parse-cli-args.d.ts +24 -0
- package/src/utils/parse-cli-args.js +47 -0
- package/src/utils/parse-cli-args.ts +83 -0
- package/src/utils/path-utils.module.d.ts +5 -0
- package/src/utils/path-utils.module.js +14 -0
- package/src/utils/path-utils.module.ts +14 -0
- package/src/utils/runtime.d.ts +11 -0
- package/src/utils/runtime.js +40 -0
- package/src/utils/runtime.ts +44 -0
- package/src/utils/server-utils.module.d.ts +19 -0
- package/src/utils/server-utils.module.js +56 -0
- package/src/utils/server-utils.module.ts +67 -0
- package/src/watchers/project-watcher.d.ts +120 -0
- package/src/watchers/project-watcher.js +238 -0
- package/src/watchers/project-watcher.test-helpers.d.ts +4 -0
- package/src/watchers/project-watcher.test-helpers.js +51 -0
- package/src/watchers/project-watcher.test-helpers.ts +40 -0
- package/src/watchers/project-watcher.ts +306 -0
|
@@ -0,0 +1,492 @@
|
|
|
1
|
+
import type { Server, WebSocketHandler } from 'bun';
|
|
2
|
+
import { appLogger } from '../../global/app-logger.ts';
|
|
3
|
+
import type { EcoPagesAppConfig } from '../../internal-types.ts';
|
|
4
|
+
import type { ApiHandler, ApiHandlerContext, ErrorHandler, StaticRoute } from '../../public-types.ts';
|
|
5
|
+
import { HttpError } from '../../errors/http-error.ts';
|
|
6
|
+
import { createRequire } from '../../utils/locals-utils.ts';
|
|
7
|
+
|
|
8
|
+
import { fileSystem } from '@ecopages/file-system';
|
|
9
|
+
import { SharedServerAdapter } from '../shared/server-adapter.ts';
|
|
10
|
+
import type { ServerAdapterResult } from '../abstract/server-adapter.ts';
|
|
11
|
+
import { ApiResponseBuilder } from '../shared/api-response.ts';
|
|
12
|
+
|
|
13
|
+
import { ServerRouteHandler, type ServerRouteHandlerParams } from '../shared/server-route-handler.ts';
|
|
14
|
+
import { ServerStaticBuilder, type ServerStaticBuilderParams } from '../shared/server-static-builder';
|
|
15
|
+
import { ClientBridge } from './client-bridge';
|
|
16
|
+
import { HmrManager } from './hmr-manager';
|
|
17
|
+
import { ServerLifecycle } from './server-lifecycle.ts';
|
|
18
|
+
|
|
19
|
+
type BunServerInstance = Server<unknown>;
|
|
20
|
+
type BunNativeServeOptions = Bun.Serve.Options<unknown>;
|
|
21
|
+
|
|
22
|
+
export type BunServerRoutes = Bun.Serve.Routes<unknown, string>;
|
|
23
|
+
|
|
24
|
+
export type BunServeAdapterServerOptions = Partial<
|
|
25
|
+
Omit<BunNativeServeOptions, 'fetch'> & {
|
|
26
|
+
fetch(this: BunServerInstance, request: Request): Promise<void | Response>;
|
|
27
|
+
}
|
|
28
|
+
>;
|
|
29
|
+
|
|
30
|
+
export type BunServeOptions = Omit<BunNativeServeOptions, 'fetch'> & {
|
|
31
|
+
fetch?: (this: BunServerInstance, request: Request, server: BunServerInstance) => Promise<void | Response>;
|
|
32
|
+
websocket?: WebSocketHandler<unknown>;
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
export interface BunServerAdapterParams {
|
|
36
|
+
appConfig: EcoPagesAppConfig;
|
|
37
|
+
runtimeOrigin: string;
|
|
38
|
+
serveOptions: BunServeAdapterServerOptions;
|
|
39
|
+
apiHandlers?: ApiHandler<string, Request, BunServerInstance>[];
|
|
40
|
+
staticRoutes?: StaticRoute[];
|
|
41
|
+
errorHandler?: ErrorHandler;
|
|
42
|
+
options?: {
|
|
43
|
+
watch?: boolean;
|
|
44
|
+
};
|
|
45
|
+
lifecycle?: ServerLifecycle;
|
|
46
|
+
staticBuilderFactory?: (params: ServerStaticBuilderParams) => ServerStaticBuilder;
|
|
47
|
+
routeHandlerFactory?: (params: ServerRouteHandlerParams) => ServerRouteHandler;
|
|
48
|
+
hmrManager?: HmrManager;
|
|
49
|
+
bridge?: ClientBridge;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export interface BunServerAdapterResult extends ServerAdapterResult {
|
|
53
|
+
getServerOptions: (options?: { enableHmr?: boolean }) => BunServeOptions;
|
|
54
|
+
buildStatic: (options?: { preview?: boolean }) => Promise<void>;
|
|
55
|
+
completeInitialization: (server?: BunServerInstance | null) => Promise<void>;
|
|
56
|
+
handleRequest: (request: Request) => Promise<Response>;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export class BunServerAdapter extends SharedServerAdapter<BunServerAdapterParams, BunServerAdapterResult> {
|
|
60
|
+
declare appConfig: EcoPagesAppConfig;
|
|
61
|
+
declare options: BunServerAdapterParams['options'];
|
|
62
|
+
declare serveOptions: BunServeAdapterServerOptions;
|
|
63
|
+
protected apiHandlers: ApiHandler<string, Request, BunServerInstance>[];
|
|
64
|
+
protected staticRoutes: StaticRoute[];
|
|
65
|
+
|
|
66
|
+
protected errorHandler?: ErrorHandler;
|
|
67
|
+
|
|
68
|
+
private bridge!: ClientBridge;
|
|
69
|
+
private lifecycle!: ServerLifecycle;
|
|
70
|
+
public hmrManager!: HmrManager;
|
|
71
|
+
private initializationPromise: Promise<void> | null = null;
|
|
72
|
+
private fullyInitialized = false;
|
|
73
|
+
declare serverInstance: BunServerInstance | null;
|
|
74
|
+
|
|
75
|
+
private readonly lifecycleFactory?: ServerLifecycle;
|
|
76
|
+
private readonly staticBuilderFactory?: (params: ServerStaticBuilderParams) => ServerStaticBuilder;
|
|
77
|
+
private readonly routeHandlerFactory?: (params: ServerRouteHandlerParams) => ServerRouteHandler;
|
|
78
|
+
private readonly hmrManagerFactory?: HmrManager;
|
|
79
|
+
private readonly bridgeFactory?: ClientBridge;
|
|
80
|
+
|
|
81
|
+
constructor({
|
|
82
|
+
appConfig,
|
|
83
|
+
runtimeOrigin,
|
|
84
|
+
serveOptions,
|
|
85
|
+
apiHandlers,
|
|
86
|
+
staticRoutes,
|
|
87
|
+
errorHandler,
|
|
88
|
+
options,
|
|
89
|
+
lifecycle,
|
|
90
|
+
staticBuilderFactory,
|
|
91
|
+
routeHandlerFactory,
|
|
92
|
+
hmrManager,
|
|
93
|
+
bridge,
|
|
94
|
+
}: BunServerAdapterParams) {
|
|
95
|
+
super({ appConfig, runtimeOrigin, serveOptions, options });
|
|
96
|
+
this.apiHandlers = apiHandlers || [];
|
|
97
|
+
this.staticRoutes = staticRoutes || [];
|
|
98
|
+
this.errorHandler = errorHandler;
|
|
99
|
+
this.lifecycleFactory = lifecycle;
|
|
100
|
+
this.staticBuilderFactory = staticBuilderFactory;
|
|
101
|
+
this.routeHandlerFactory = routeHandlerFactory;
|
|
102
|
+
this.hmrManagerFactory = hmrManager;
|
|
103
|
+
this.bridgeFactory = bridge;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Determines if HMR script should be injected.
|
|
108
|
+
* Only injects in watch mode when HMR manager is enabled.
|
|
109
|
+
*/
|
|
110
|
+
private shouldInjectHmrScript(): boolean {
|
|
111
|
+
return this.options?.watch === true && this.hmrManager?.isEnabled() === true;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* Checks if a response contains HTML content.
|
|
116
|
+
*/
|
|
117
|
+
private isHtmlResponse(response: Response): boolean {
|
|
118
|
+
const contentType = response.headers.get('Content-Type');
|
|
119
|
+
return contentType !== null && contentType.startsWith('text/html');
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Injects HMR script into HTML responses in development mode.
|
|
124
|
+
* Ensures explicit API handlers that return HTML get auto-reload capability.
|
|
125
|
+
*/
|
|
126
|
+
private async maybeInjectHmrScript(response: Response): Promise<Response> {
|
|
127
|
+
if (this.shouldInjectHmrScript() && this.isHtmlResponse(response)) {
|
|
128
|
+
const html = await response.text();
|
|
129
|
+
const hmrScript = `<script type="module">import '/_hmr_runtime.js';</script>`;
|
|
130
|
+
const updatedHtml = html.replace(/<\/html>/i, `${hmrScript}</html>`);
|
|
131
|
+
|
|
132
|
+
const headers = new Headers(response.headers);
|
|
133
|
+
headers.delete('Content-Length');
|
|
134
|
+
|
|
135
|
+
return new Response(updatedHtml, {
|
|
136
|
+
status: response.status,
|
|
137
|
+
statusText: response.statusText,
|
|
138
|
+
headers,
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
return response;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Initializes the server adapter's core components.
|
|
146
|
+
* Delegates to ServerLifecycle for setup.
|
|
147
|
+
*/
|
|
148
|
+
public async initialize(): Promise<void> {
|
|
149
|
+
this.bridge = this.bridgeFactory ?? new ClientBridge();
|
|
150
|
+
this.hmrManager = this.hmrManagerFactory ?? new HmrManager({ appConfig: this.appConfig, bridge: this.bridge });
|
|
151
|
+
this.lifecycle =
|
|
152
|
+
this.lifecycleFactory ??
|
|
153
|
+
new ServerLifecycle({
|
|
154
|
+
appConfig: this.appConfig,
|
|
155
|
+
runtimeOrigin: this.runtimeOrigin,
|
|
156
|
+
hmrManager: this.hmrManager,
|
|
157
|
+
bridge: this.bridge,
|
|
158
|
+
});
|
|
159
|
+
|
|
160
|
+
this.staticSiteGenerator = await this.lifecycle.initialize();
|
|
161
|
+
|
|
162
|
+
const staticBuilderOptions = {
|
|
163
|
+
appConfig: this.appConfig,
|
|
164
|
+
staticSiteGenerator: this.staticSiteGenerator,
|
|
165
|
+
serveOptions: this.serveOptions,
|
|
166
|
+
};
|
|
167
|
+
|
|
168
|
+
this.staticBuilder = this.staticBuilderFactory
|
|
169
|
+
? this.staticBuilderFactory(staticBuilderOptions)
|
|
170
|
+
: new ServerStaticBuilder(staticBuilderOptions);
|
|
171
|
+
|
|
172
|
+
await this.lifecycle.initializePlugins({ watch: this.options?.watch });
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
/**
|
|
176
|
+
* Refreshes the router routes during watch mode.
|
|
177
|
+
*/
|
|
178
|
+
private async refreshRouterRoutes(): Promise<void> {
|
|
179
|
+
if (this.serverInstance && typeof this.serverInstance.reload === 'function') {
|
|
180
|
+
try {
|
|
181
|
+
await this.initSharedRouter();
|
|
182
|
+
this.configureSharedResponseHandlers(this.staticRoutes, this.hmrManager);
|
|
183
|
+
const options = this.getServerOptions({ enableHmr: true });
|
|
184
|
+
this.serverInstance.reload(options as BunNativeServeOptions);
|
|
185
|
+
appLogger.debug('Server routes updated with dynamic routes');
|
|
186
|
+
} catch (error) {
|
|
187
|
+
if (error instanceof Error) {
|
|
188
|
+
this.hmrManager.broadcast({ type: 'error', message: error.message });
|
|
189
|
+
appLogger.error('Failed to refresh router routes:', error);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
} else {
|
|
193
|
+
appLogger.error('Server instance is not available for reloading');
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
private async watch(): Promise<void> {
|
|
198
|
+
await this.lifecycle.startWatching({
|
|
199
|
+
refreshRouterRoutesCallback: this.refreshRouterRoutes.bind(this),
|
|
200
|
+
});
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* Retrieves the current server options, optionally enabling HMR.
|
|
205
|
+
* If HMR is enabled, modifies fetch to handle WebSocket upgrades and serve HMR runtime.
|
|
206
|
+
* Ensures original fetch logic is preserved and called for non-HMR requests.
|
|
207
|
+
* @param options.enableHmr Whether to enable Hot Module Replacement
|
|
208
|
+
*/
|
|
209
|
+
public getServerOptions({ enableHmr = false } = {}): BunServeOptions {
|
|
210
|
+
appLogger.debug(`[BunServerAdapter] getServerOptions called with enableHmr: ${enableHmr}`);
|
|
211
|
+
const serverOptions = this.buildServerSettings();
|
|
212
|
+
|
|
213
|
+
if (enableHmr) {
|
|
214
|
+
const originalFetch = serverOptions.fetch;
|
|
215
|
+
const hmrHandler = this.hmrManager.getWebSocketHandler();
|
|
216
|
+
const hmrManager = this.hmrManager;
|
|
217
|
+
|
|
218
|
+
(serverOptions as any).development = true;
|
|
219
|
+
|
|
220
|
+
serverOptions.websocket = hmrHandler;
|
|
221
|
+
serverOptions.fetch = async function (
|
|
222
|
+
this: Server<unknown>,
|
|
223
|
+
request: Request,
|
|
224
|
+
_server: Server<unknown>,
|
|
225
|
+
): Promise<Response | void> {
|
|
226
|
+
const url = new URL(request.url);
|
|
227
|
+
appLogger.debug(`[HMR] Request: ${url.pathname}`);
|
|
228
|
+
|
|
229
|
+
/** Handle HMR WebSocket upgrade */
|
|
230
|
+
if (url.pathname === '/_hmr') {
|
|
231
|
+
const success = this.upgrade(request, {
|
|
232
|
+
data: undefined,
|
|
233
|
+
});
|
|
234
|
+
if (success) return;
|
|
235
|
+
return new Response('WebSocket upgrade failed', { status: 400 });
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
/** Serve HMR runtime script */
|
|
239
|
+
if (url.pathname === '/_hmr_runtime.js') {
|
|
240
|
+
appLogger.debug(`[HMR] Serving runtime from ${hmrManager.getRuntimePath()}`);
|
|
241
|
+
return new Response(fileSystem.readFileAsBuffer(hmrManager.getRuntimePath()) as BodyInit, {
|
|
242
|
+
headers: { 'Content-Type': 'application/javascript' },
|
|
243
|
+
});
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
/** Proceed with normal request handling */
|
|
247
|
+
let response: Response;
|
|
248
|
+
if (originalFetch) {
|
|
249
|
+
const res = await originalFetch.call(this, request, this);
|
|
250
|
+
response = res instanceof Response ? res : new Response('Not Found', { status: 404 });
|
|
251
|
+
} else {
|
|
252
|
+
response = new Response('Not Found', { status: 404 });
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
return response;
|
|
256
|
+
};
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
return serverOptions as BunServeOptions;
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
/**
|
|
263
|
+
* Helper method to retrieve and parse the request body.
|
|
264
|
+
* Handles JSON and plain text content types.
|
|
265
|
+
* For FormData (multipart/form-data, x-www-form-urlencoded), use ctx.request.formData() directly.
|
|
266
|
+
* Returns undefined for unsupported content types.
|
|
267
|
+
*/
|
|
268
|
+
private async retrieveBodyFromRequest(request: Request): Promise<unknown> {
|
|
269
|
+
const contentType = request.headers.get('Content-Type') || '';
|
|
270
|
+
|
|
271
|
+
if (contentType.includes('application/json')) {
|
|
272
|
+
return await request.json();
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
if (contentType.includes('text/plain')) {
|
|
276
|
+
return await request.text();
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
return undefined;
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* Creates complete server configuration with request handling.
|
|
284
|
+
* @returns Server options ready for Bun.serve()
|
|
285
|
+
*/
|
|
286
|
+
private buildServerSettings(): BunServeOptions {
|
|
287
|
+
const serverOptions = { ...this.serveOptions } as BunServeAdapterServerOptions;
|
|
288
|
+
const handleNoMatch = this.handleNoMatch.bind(this);
|
|
289
|
+
const waitForInit = this.waitForInitialization.bind(this);
|
|
290
|
+
const handleReq = this.handleRequest.bind(this);
|
|
291
|
+
const errorHandler = this.errorHandler;
|
|
292
|
+
const getCacheService = () => this.getCacheService();
|
|
293
|
+
const getRenderContext = () => this.getRenderContext();
|
|
294
|
+
|
|
295
|
+
appLogger.debug(`[BunServerAdapter] Building server settings`);
|
|
296
|
+
|
|
297
|
+
const finalOptions: BunServeOptions = {
|
|
298
|
+
...serverOptions,
|
|
299
|
+
async fetch(this: Server<unknown>, request: Request, _server: Server<unknown>) {
|
|
300
|
+
try {
|
|
301
|
+
await waitForInit();
|
|
302
|
+
return await handleReq(request);
|
|
303
|
+
} catch (error) {
|
|
304
|
+
if (error instanceof Response) return error;
|
|
305
|
+
if (errorHandler) {
|
|
306
|
+
try {
|
|
307
|
+
const locals: Record<string, unknown> = {};
|
|
308
|
+
const context: ApiHandlerContext<Request, BunServerInstance> = {
|
|
309
|
+
request,
|
|
310
|
+
params: {},
|
|
311
|
+
response: new ApiResponseBuilder(),
|
|
312
|
+
server: _server as BunServerInstance,
|
|
313
|
+
locals,
|
|
314
|
+
require: createRequire((): Record<string, unknown> => locals),
|
|
315
|
+
services: {
|
|
316
|
+
cache: getCacheService(),
|
|
317
|
+
},
|
|
318
|
+
...getRenderContext(),
|
|
319
|
+
};
|
|
320
|
+
|
|
321
|
+
return await errorHandler(error, context);
|
|
322
|
+
} catch (handlerError) {
|
|
323
|
+
appLogger.error(`[ecopages] Error in custom error handler: ${handlerError}`);
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
if (error instanceof HttpError) return error.toResponse();
|
|
327
|
+
|
|
328
|
+
appLogger.error(`[ecopages] Error handling request: ${error}`);
|
|
329
|
+
return new Response('Internal Server Error', { status: 500 });
|
|
330
|
+
}
|
|
331
|
+
},
|
|
332
|
+
error(this: Server<unknown>, error: Error) {
|
|
333
|
+
appLogger.error(`[ecopages] Error handling request: ${error}`);
|
|
334
|
+
return handleNoMatch(new Request('http://localhost'));
|
|
335
|
+
},
|
|
336
|
+
};
|
|
337
|
+
|
|
338
|
+
return finalOptions as unknown as BunServeOptions;
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
/**
|
|
342
|
+
* Generates a static build of the site for deployment.
|
|
343
|
+
* @param options.preview - If true, starts a preview server after build
|
|
344
|
+
*/
|
|
345
|
+
public async buildStatic(options?: { preview?: boolean }): Promise<void> {
|
|
346
|
+
if (!this.fullyInitialized) {
|
|
347
|
+
await this.initSharedRouter();
|
|
348
|
+
this.configureSharedResponseHandlers(this.staticRoutes, this.hmrManager);
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
await this.staticBuilder.build(options, {
|
|
352
|
+
router: this.router,
|
|
353
|
+
routeRendererFactory: this.routeRendererFactory,
|
|
354
|
+
staticRoutes: this.staticRoutes,
|
|
355
|
+
});
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
/**
|
|
359
|
+
* Initializes the server with dynamic routes after server creation.
|
|
360
|
+
* Must be called before handling any requests.
|
|
361
|
+
* @param server - The Bun server instance
|
|
362
|
+
*/
|
|
363
|
+
public async completeInitialization(server?: BunServerInstance | null): Promise<void> {
|
|
364
|
+
if (this.fullyInitialized) {
|
|
365
|
+
if (server && !this.serverInstance) {
|
|
366
|
+
this.serverInstance = server;
|
|
367
|
+
}
|
|
368
|
+
return;
|
|
369
|
+
}
|
|
370
|
+
|
|
371
|
+
if (!this.initializationPromise) {
|
|
372
|
+
this.initializationPromise = this._performInitialization(server ?? null);
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
return this.initializationPromise;
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
/**
|
|
379
|
+
* Performs complete server setup including routing, watchers, and HMR.
|
|
380
|
+
*/
|
|
381
|
+
private async _performInitialization(server: BunServerInstance | null): Promise<void> {
|
|
382
|
+
this.serverInstance = server;
|
|
383
|
+
appLogger.debug('Completing server initialization with dynamic routes');
|
|
384
|
+
|
|
385
|
+
await this.initSharedRouter();
|
|
386
|
+
this.configureSharedResponseHandlers(this.staticRoutes, this.hmrManager);
|
|
387
|
+
|
|
388
|
+
this.fullyInitialized = true;
|
|
389
|
+
|
|
390
|
+
if (this.options?.watch) await this.watch();
|
|
391
|
+
|
|
392
|
+
if (server && typeof server.reload === 'function') {
|
|
393
|
+
const updatedOptions = this.getServerOptions(this.options?.watch ? { enableHmr: true } : undefined);
|
|
394
|
+
server.reload(updatedOptions as BunNativeServeOptions);
|
|
395
|
+
appLogger.debug('Server routes updated with dynamic routes');
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
/**
|
|
400
|
+
* Creates and initializes the Bun server adapter.
|
|
401
|
+
* @returns Configured adapter with server methods
|
|
402
|
+
*/
|
|
403
|
+
public async createAdapter(): Promise<BunServerAdapterResult> {
|
|
404
|
+
await this.initialize();
|
|
405
|
+
|
|
406
|
+
return {
|
|
407
|
+
getServerOptions: this.getServerOptions.bind(this),
|
|
408
|
+
buildStatic: this.buildStatic.bind(this),
|
|
409
|
+
completeInitialization: this.completeInitialization.bind(this),
|
|
410
|
+
handleRequest: this.handleRequest.bind(this),
|
|
411
|
+
};
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
/**
|
|
415
|
+
* Handles HTTP requests by passing them securely to the shared core router adapter.
|
|
416
|
+
*/
|
|
417
|
+
public async handleRequest(request: Request): Promise<Response> {
|
|
418
|
+
const response = await this.handleSharedRequest(request, {
|
|
419
|
+
apiHandlers: this.apiHandlers,
|
|
420
|
+
errorHandler: this.errorHandler,
|
|
421
|
+
serverInstance: this.serverInstance,
|
|
422
|
+
hmrManager: this.hmrManager,
|
|
423
|
+
});
|
|
424
|
+
|
|
425
|
+
// Check if we need to manually inject HMR script since we're bypassing route level HMR wrapping
|
|
426
|
+
return await this.maybeInjectHmrScript(response);
|
|
427
|
+
}
|
|
428
|
+
|
|
429
|
+
/**
|
|
430
|
+
* Ensures server initialization completes before request handling.
|
|
431
|
+
* Prevents race conditions during startup.
|
|
432
|
+
*/
|
|
433
|
+
private async waitForInitialization(): Promise<void> {
|
|
434
|
+
if (this.fullyInitialized) {
|
|
435
|
+
return;
|
|
436
|
+
}
|
|
437
|
+
|
|
438
|
+
if (this.initializationPromise) {
|
|
439
|
+
return this.initializationPromise;
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
throw new Error('Server not initialized. Call completeInitialization() first.');
|
|
443
|
+
}
|
|
444
|
+
|
|
445
|
+
/**
|
|
446
|
+
* Handles HTTP requests from the router adapter.
|
|
447
|
+
*/
|
|
448
|
+
public async handleResponse(request: Request): Promise<Response> {
|
|
449
|
+
await this.waitForInitialization();
|
|
450
|
+
return this.routeHandler.handleResponse(request);
|
|
451
|
+
}
|
|
452
|
+
|
|
453
|
+
/**
|
|
454
|
+
* Handles requests that do not match any routes.
|
|
455
|
+
*/
|
|
456
|
+
private async handleNoMatch(request: Request): Promise<Response> {
|
|
457
|
+
await this.waitForInitialization();
|
|
458
|
+
return this.routeHandler.handleNoMatch(request);
|
|
459
|
+
}
|
|
460
|
+
}
|
|
461
|
+
|
|
462
|
+
/**
|
|
463
|
+
* Factory function to create a Bun server adapter
|
|
464
|
+
*/
|
|
465
|
+
export async function createBunServerAdapter(params: BunServerAdapterParams): Promise<BunServerAdapterResult> {
|
|
466
|
+
const runtimeOrigin =
|
|
467
|
+
params.runtimeOrigin ??
|
|
468
|
+
`http://${params.serveOptions.hostname || 'localhost'}:${params.serveOptions.port || 3000}`;
|
|
469
|
+
|
|
470
|
+
const bridge = params.bridge ?? new ClientBridge();
|
|
471
|
+
const hmrManager = params.hmrManager ?? new HmrManager({ appConfig: params.appConfig, bridge });
|
|
472
|
+
const lifecycle =
|
|
473
|
+
params.lifecycle ??
|
|
474
|
+
new ServerLifecycle({
|
|
475
|
+
appConfig: params.appConfig,
|
|
476
|
+
runtimeOrigin,
|
|
477
|
+
hmrManager,
|
|
478
|
+
bridge,
|
|
479
|
+
});
|
|
480
|
+
|
|
481
|
+
const adapter = new BunServerAdapter({
|
|
482
|
+
...params,
|
|
483
|
+
runtimeOrigin,
|
|
484
|
+
bridge,
|
|
485
|
+
hmrManager,
|
|
486
|
+
lifecycle,
|
|
487
|
+
staticBuilderFactory: params.staticBuilderFactory ?? ((opts) => new ServerStaticBuilder(opts)),
|
|
488
|
+
routeHandlerFactory: params.routeHandlerFactory ?? ((p) => new ServerRouteHandler(p)),
|
|
489
|
+
});
|
|
490
|
+
|
|
491
|
+
return adapter.createAdapter();
|
|
492
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { EcoPagesAppConfig } from '../../internal-types';
|
|
2
|
+
import type { EcoBuildPlugin } from '../../build/build-types.js';
|
|
3
|
+
import { StaticSiteGenerator } from '../../static-site-generator/static-site-generator';
|
|
4
|
+
import type { ClientBridge } from './client-bridge';
|
|
5
|
+
import type { HmrManager } from './hmr-manager';
|
|
6
|
+
export interface WatcherCallbacks {
|
|
7
|
+
refreshRouterRoutesCallback: () => Promise<void>;
|
|
8
|
+
}
|
|
9
|
+
export interface ServerLifecycleParams {
|
|
10
|
+
appConfig: EcoPagesAppConfig;
|
|
11
|
+
runtimeOrigin: string;
|
|
12
|
+
hmrManager: HmrManager;
|
|
13
|
+
bridge: ClientBridge;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Handles server lifecycle: initialization, plugins, loaders, and file watching.
|
|
17
|
+
*/
|
|
18
|
+
export declare class ServerLifecycle {
|
|
19
|
+
private readonly appConfig;
|
|
20
|
+
private readonly hmrManager;
|
|
21
|
+
private readonly bridge;
|
|
22
|
+
private readonly runtimeOrigin;
|
|
23
|
+
private staticSiteGenerator;
|
|
24
|
+
constructor({ appConfig, runtimeOrigin, hmrManager, bridge }: ServerLifecycleParams);
|
|
25
|
+
/**
|
|
26
|
+
* Initializes the server's core components.
|
|
27
|
+
* @returns The static site generator instance for use by other components
|
|
28
|
+
*/
|
|
29
|
+
initialize(): Promise<StaticSiteGenerator>;
|
|
30
|
+
/**
|
|
31
|
+
* Sets up Bun loaders from config.
|
|
32
|
+
* Note: This will be abstracted to a LoaderStrategy interface in #4 Runtime Abstraction.
|
|
33
|
+
*/
|
|
34
|
+
setupLoaders(): void;
|
|
35
|
+
/**
|
|
36
|
+
* Copies public directory contents to dist root.
|
|
37
|
+
* Static files are served from root (e.g., /favicon.ico, /robots.txt).
|
|
38
|
+
*/
|
|
39
|
+
copyPublicDir(): void;
|
|
40
|
+
/**
|
|
41
|
+
* Initializes processors and integrations.
|
|
42
|
+
* @param options.watch - Whether watch mode is enabled
|
|
43
|
+
*/
|
|
44
|
+
initializePlugins(options?: {
|
|
45
|
+
watch?: boolean;
|
|
46
|
+
}): Promise<EcoBuildPlugin[]>;
|
|
47
|
+
/**
|
|
48
|
+
* Starts file watching for HMR.
|
|
49
|
+
*/
|
|
50
|
+
startWatching(callbacks: WatcherCallbacks): Promise<void>;
|
|
51
|
+
getStaticSiteGenerator(): StaticSiteGenerator;
|
|
52
|
+
}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { getBunRuntime } from "../../utils/runtime.js";
|
|
3
|
+
import { RESOLVED_ASSETS_DIR } from "../../constants";
|
|
4
|
+
import { defaultBuildAdapter } from "../../build/build-adapter.js";
|
|
5
|
+
import { appLogger } from "../../global/app-logger";
|
|
6
|
+
import { fileSystem } from "@ecopages/file-system";
|
|
7
|
+
import { StaticSiteGenerator } from "../../static-site-generator/static-site-generator";
|
|
8
|
+
import { ProjectWatcher } from "../../watchers/project-watcher";
|
|
9
|
+
class ServerLifecycle {
|
|
10
|
+
appConfig;
|
|
11
|
+
hmrManager;
|
|
12
|
+
bridge;
|
|
13
|
+
runtimeOrigin;
|
|
14
|
+
staticSiteGenerator;
|
|
15
|
+
constructor({ appConfig, runtimeOrigin, hmrManager, bridge }) {
|
|
16
|
+
this.appConfig = appConfig;
|
|
17
|
+
this.runtimeOrigin = runtimeOrigin;
|
|
18
|
+
this.hmrManager = hmrManager;
|
|
19
|
+
this.bridge = bridge;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Initializes the server's core components.
|
|
23
|
+
* @returns The static site generator instance for use by other components
|
|
24
|
+
*/
|
|
25
|
+
async initialize() {
|
|
26
|
+
this.staticSiteGenerator = new StaticSiteGenerator({ appConfig: this.appConfig });
|
|
27
|
+
await this.hmrManager.buildRuntime();
|
|
28
|
+
this.setupLoaders();
|
|
29
|
+
this.copyPublicDir();
|
|
30
|
+
return this.staticSiteGenerator;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Sets up Bun loaders from config.
|
|
34
|
+
* Note: This will be abstracted to a LoaderStrategy interface in #4 Runtime Abstraction.
|
|
35
|
+
*/
|
|
36
|
+
setupLoaders() {
|
|
37
|
+
const loaders = this.appConfig.loaders;
|
|
38
|
+
for (const loader of loaders.values()) {
|
|
39
|
+
defaultBuildAdapter.registerPlugin(loader);
|
|
40
|
+
getBunRuntime()?.plugin(loader);
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Copies public directory contents to dist root.
|
|
45
|
+
* Static files are served from root (e.g., /favicon.ico, /robots.txt).
|
|
46
|
+
*/
|
|
47
|
+
copyPublicDir() {
|
|
48
|
+
try {
|
|
49
|
+
const srcPublicDir = path.join(this.appConfig.rootDir, this.appConfig.srcDir, this.appConfig.publicDir);
|
|
50
|
+
if (fileSystem.exists(srcPublicDir)) {
|
|
51
|
+
fileSystem.copyDir(srcPublicDir, path.join(this.appConfig.rootDir, this.appConfig.distDir));
|
|
52
|
+
}
|
|
53
|
+
fileSystem.ensureDir(path.join(this.appConfig.absolutePaths.distDir, RESOLVED_ASSETS_DIR));
|
|
54
|
+
} catch (error) {
|
|
55
|
+
appLogger.error(
|
|
56
|
+
`Failed to copy public directory: ${error instanceof Error ? error.message : String(error)}`
|
|
57
|
+
);
|
|
58
|
+
throw error;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Initializes processors and integrations.
|
|
63
|
+
* @param options.watch - Whether watch mode is enabled
|
|
64
|
+
*/
|
|
65
|
+
async initializePlugins(options) {
|
|
66
|
+
try {
|
|
67
|
+
const hmrEnabled = !!options?.watch;
|
|
68
|
+
this.hmrManager.setEnabled(hmrEnabled);
|
|
69
|
+
const processorBuildPlugins = [];
|
|
70
|
+
const processorPromises = Array.from(this.appConfig.processors.values()).map(async (processor) => {
|
|
71
|
+
await processor.setup();
|
|
72
|
+
if (processor.plugins) {
|
|
73
|
+
for (const plugin of processor.plugins) {
|
|
74
|
+
defaultBuildAdapter.registerPlugin(plugin);
|
|
75
|
+
getBunRuntime()?.plugin(plugin);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
if (processor.buildPlugins) {
|
|
79
|
+
processorBuildPlugins.push(...processor.buildPlugins);
|
|
80
|
+
}
|
|
81
|
+
});
|
|
82
|
+
const integrationPromises = this.appConfig.integrations.map(async (integration) => {
|
|
83
|
+
integration.setConfig(this.appConfig);
|
|
84
|
+
integration.setRuntimeOrigin(this.runtimeOrigin);
|
|
85
|
+
integration.setHmrManager(this.hmrManager);
|
|
86
|
+
await integration.setup();
|
|
87
|
+
for (const plugin of integration.plugins) {
|
|
88
|
+
defaultBuildAdapter.registerPlugin(plugin);
|
|
89
|
+
getBunRuntime()?.plugin(plugin);
|
|
90
|
+
}
|
|
91
|
+
});
|
|
92
|
+
await Promise.all([...processorPromises, ...integrationPromises]);
|
|
93
|
+
const loaderPlugins = Array.from(this.appConfig.loaders.values());
|
|
94
|
+
const allBuildPlugins = [...loaderPlugins, ...processorBuildPlugins];
|
|
95
|
+
this.hmrManager.setPlugins(allBuildPlugins);
|
|
96
|
+
return allBuildPlugins;
|
|
97
|
+
} catch (error) {
|
|
98
|
+
appLogger.error(`Failed to initialize plugins: ${error instanceof Error ? error.message : String(error)}`);
|
|
99
|
+
throw error;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Starts file watching for HMR.
|
|
104
|
+
*/
|
|
105
|
+
async startWatching(callbacks) {
|
|
106
|
+
const watcherInstance = new ProjectWatcher({
|
|
107
|
+
config: this.appConfig,
|
|
108
|
+
refreshRouterRoutesCallback: callbacks.refreshRouterRoutesCallback,
|
|
109
|
+
hmrManager: this.hmrManager,
|
|
110
|
+
bridge: this.bridge
|
|
111
|
+
});
|
|
112
|
+
await watcherInstance.createWatcherSubscription();
|
|
113
|
+
}
|
|
114
|
+
getStaticSiteGenerator() {
|
|
115
|
+
return this.staticSiteGenerator;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
export {
|
|
119
|
+
ServerLifecycle
|
|
120
|
+
};
|