@ecopages/core 0.2.0-alpha.9 → 0.2.1

package/src/adapters/bun/hmr-manager.js

@@ -1,15 +1,15 @@
 import fs from "node:fs";
 import path from "node:path";
-import { RESOLVED_ASSETS_DIR } from "../../constants";
+import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
 import { getAppBuildExecutor } from "../../build/build-adapter.js";
 import { fileSystem } from "@ecopages/file-system";
-import { HmrStrategyType } from "../../hmr/hmr-strategy";
-import { DefaultHmrStrategy } from "../../hmr/strategies/default-hmr-strategy";
-import { JsHmrStrategy } from "../../hmr/strategies/js-hmr-strategy";
-import { appLogger } from "../../global/app-logger";
+import { HmrStrategyType } from "../../hmr/hmr-strategy.js";
+import { DefaultHmrStrategy } from "../../hmr/strategies/default-hmr-strategy.js";
+import { JsHmrStrategy } from "../../hmr/strategies/js-hmr-strategy.js";
+import { appLogger } from "../../global/app-logger.js";
 import { HmrEntrypointRegistrar } from "../shared/hmr-entrypoint-registrar.js";
 import { BrowserBundleService } from "../../services/assets/browser-bundle.service.js";
-import { getAppServerModuleTranspiler } from "../../services/module-loading/app-server-module-transpiler.service";
+import { getAppServerModuleTranspiler } from "../../services/module-loading/app-server-module-transpiler.service.js";
 import {
   getAppEntrypointDependencyGraph,
   NoopEntrypointDependencyGraph,
@@ -251,7 +251,7 @@ class HmrManager {
    */
   async registerEntrypoint(entrypointPath) {
     return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-      emit: async (normalizedEntrypoint, outputPath) => await this.emitStrictEntrypoint(normalizedEntrypoint, outputPath),
+      emit: async (normalizedEntrypoint) => await this.emitStrictEntrypoint(normalizedEntrypoint),
       getMissingOutputError: (normalizedEntrypoint, outputPath) => new Error(
         `[HMR] Integration failed to emit entrypoint ${normalizedEntrypoint} to ${outputPath}. Page entrypoints must be produced by their owning integration.`
       )
@@ -278,7 +278,7 @@ class HmrManager {
    * strategy processing without broadcasting, and then verifies that the owning
    * integration emitted the expected file.
    */
-  async emitStrictEntrypoint(entrypointPath, _outputPath) {
+  async emitStrictEntrypoint(entrypointPath) {
     await this.handleFileChange(entrypointPath, { broadcast: false });
   }
   /**

package/src/adapters/bun/index.d.ts

@@ -1,2 +1,2 @@
-export { EcopagesApp, createApp } from './create-app.js';
+export { BunEcopagesApp, createApp } from './create-app.js';
 export { defineApiHandler, defineGroupHandler, type GroupHandler } from '../shared/define-api-handler.js';

package/src/adapters/bun/index.js

@@ -1,7 +1,7 @@
-import { EcopagesApp, createApp } from "./create-app.js";
+import { BunEcopagesApp, createApp } from "./create-app.js";
 import { defineApiHandler, defineGroupHandler } from "../shared/define-api-handler.js";
 export {
-  EcopagesApp,
+  BunEcopagesApp,
   createApp,
   defineApiHandler,
   defineGroupHandler

package/src/adapters/bun/server-adapter.d.ts

@@ -1,12 +1,12 @@
 import type { Server, WebSocketHandler } from 'bun';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { ApiHandler, ErrorHandler, StaticRoute } from '../../public-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+import type { ApiHandler, ErrorHandler, StaticRoute } from '../../types/public-types.js';
 import { SharedServerAdapter } from '../shared/server-adapter.js';
 import type { ServerAdapterResult } from '../abstract/server-adapter.js';
 import { ServerRouteHandler, type ServerRouteHandlerParams } from '../shared/server-route-handler.js';
-import { ServerStaticBuilder, type ServerStaticBuilderParams } from '../shared/server-static-builder';
-import { ClientBridge } from './client-bridge';
-import { HmrManager } from './hmr-manager';
+import { ServerStaticBuilder, type ServerStaticBuilderParams } from '../shared/server-static-builder.js';
+import { ClientBridge } from './client-bridge.js';
+import { HmrManager } from './hmr-manager.js';
 import { ServerLifecycle } from './server-lifecycle.js';
 type BunServerInstance = Server<unknown>;
 type BunNativeServeOptions = Bun.Serve.Options<unknown>;

package/src/adapters/bun/server-adapter.js

@@ -1,3 +1,4 @@
+import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
 import { appLogger } from "../../global/app-logger.js";
 import { HttpError } from "../../errors/http-error.js";
 import { createRequire } from "../../utils/locals-utils.js";
@@ -6,14 +7,14 @@ import { SharedServerAdapter } from "../shared/server-adapter.js";
 import { ApiResponseBuilder } from "../shared/api-response.js";
 import { installSharedRuntimeBuildExecutor } from "../shared/runtime-bootstrap.js";
 import { ServerRouteHandler } from "../shared/server-route-handler.js";
-import { ServerStaticBuilder } from "../shared/server-static-builder";
+import { ServerStaticBuilder } from "../shared/server-static-builder.js";
 import {
   injectHmrRuntimeIntoHtmlResponse,
   isHtmlResponse,
   shouldInjectHmrHtmlResponse
-} from "../shared/hmr-html-response";
-import { ClientBridge } from "./client-bridge";
-import { HmrManager } from "./hmr-manager";
+} from "../shared/hmr-html-response.js";
+import { ClientBridge } from "./client-bridge.js";
+import { HmrManager } from "./hmr-manager.js";
 import { ServerLifecycle } from "./server-lifecycle.js";
 class BunServerAdapter extends SharedServerAdapter {
   apiHandlers;
@@ -347,7 +348,7 @@ class BunServerAdapter extends SharedServerAdapter {
   }
 }
 async function createBunServerAdapter(params) {
-  const runtimeOrigin = params.runtimeOrigin ?? `http://${params.serveOptions.hostname || "localhost"}:${params.serveOptions.port || 3e3}`;
+  const runtimeOrigin = params.runtimeOrigin ?? `http://${params.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME}:${params.serveOptions.port || DEFAULT_ECOPAGES_PORT}`;
   const bridge = params.bridge ?? new ClientBridge();
   const hmrManager = params.hmrManager ?? new HmrManager({ appConfig: params.appConfig, bridge });
   const lifecycle = params.lifecycle ?? new ServerLifecycle({

package/src/adapters/bun/server-lifecycle.d.ts

@@ -1,8 +1,8 @@
-import type { EcoPagesAppConfig } from '../../internal-types';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 import type { EcoBuildPlugin } from '../../build/build-types.js';
-import { StaticSiteGenerator } from '../../static-site-generator/static-site-generator';
-import type { ClientBridge } from './client-bridge';
-import type { HmrManager } from './hmr-manager';
+import { StaticSiteGenerator } from '../../static-site-generator/static-site-generator.js';
+import type { ClientBridge } from './client-bridge.js';
+import type { HmrManager } from './hmr-manager.js';
 export interface WatcherCallbacks {
     refreshRouterRoutesCallback: () => Promise<void>;
 }

package/src/adapters/bun/server-lifecycle.js

@@ -1,6 +1,6 @@
 import { getBunRuntime } from "../../utils/runtime.js";
-import { appLogger } from "../../global/app-logger";
-import { StaticSiteGenerator } from "../../static-site-generator/static-site-generator";
+import { appLogger } from "../../global/app-logger.js";
+import { StaticSiteGenerator } from "../../static-site-generator/static-site-generator.js";
 import {
   bindSharedRuntimeHmrManager,
   initializeSharedRuntimePlugins,

package/src/{create-app.d.ts → adapters/create-app.d.ts}

@@ -1,9 +1,12 @@
-import type { EcopagesAppOptions as BunOptions } from './adapters/bun/create-app.js';
-import type { EcopagesAppOptions as NodeOptions } from './adapters/node/create-app.js';
-import { AbstractApplicationAdapter } from './adapters/abstract/application-adapter.js';
-import { SharedApplicationAdapter } from './adapters/shared/application-adapter.js';
-export type EcopagesAppOptions = BunOptions | NodeOptions;
-export type UniversalEcopagesApp = AbstractApplicationAdapter<EcopagesAppOptions, any, Request>;
+import type { EcoPagesAppConfig } from '../types/internal-types.js';
+import { AbstractApplicationAdapter } from './abstract/application-adapter.js';
+import type { ApplicationAdapterOptions } from './abstract/application-adapter.js';
+import { SharedApplicationAdapter } from './shared/application-adapter.js';
+export interface EcopagesAppOptions extends ApplicationAdapterOptions {
+    appConfig: EcoPagesAppConfig;
+    serverOptions?: Record<string, any>;
+}
+export type UniversalEcopagesApp = AbstractApplicationAdapter<EcopagesAppOptions, unknown, Request>;
 export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<UniversalEcopagesApp>;
 export declare class EcopagesApp extends SharedApplicationAdapter<EcopagesAppOptions, unknown, Request> {
     private readonly appOptions;

package/src/{create-app.js → adapters/create-app.js}

@@ -1,12 +1,12 @@
-import { AbstractApplicationAdapter } from "./adapters/abstract/application-adapter.js";
-import { SharedApplicationAdapter } from "./adapters/shared/application-adapter.js";
+import { AbstractApplicationAdapter } from "./abstract/application-adapter.js";
+import { SharedApplicationAdapter } from "./shared/application-adapter.js";
 async function createRuntimeApp(options) {
   const bun = globalThis.Bun;
   if (bun) {
-    const { createApp: createBunApp } = await import("./adapters/bun/create-app.js");
+    const { createApp: createBunApp } = await import("./bun/create-app.js");
     return await createBunApp(options);
   }
-  const { createNodeApp } = await import("./adapters/node/create-app.js");
+  const { createApp: createNodeApp } = await import("./node/create-app.js");
   return await createNodeApp(options);
 }
 async function createApp(options) {

package/src/adapters/index.d.ts

@@ -1,6 +1,2 @@
-export { EcopagesApp, createApp } from './bun/create-app.js';
+export { EcopagesApp, createApp } from './create-app.js';
 export { defineApiHandler, defineGroupHandler, type GroupHandler } from './shared/define-api-handler.js';
-export { NodeServerAdapter, createNodeServerAdapter } from './node/server-adapter.js';
-export { EcopagesApp as NodeAdapterEcopagesApp, createNodeApp } from './node/create-app.js';
-export type { NodeServerAdapterParams, NodeServerAdapterResult } from './node/server-adapter.js';
-export type { EcopagesAppOptions as NodeEcopagesAppOptions } from './node/create-app.js';

package/src/adapters/index.js

@@ -1,14 +1,8 @@
-import { EcopagesApp, createApp } from "./bun/create-app.js";
+import { EcopagesApp, createApp } from "./create-app.js";
 import { defineApiHandler, defineGroupHandler } from "./shared/define-api-handler.js";
-import { NodeServerAdapter, createNodeServerAdapter } from "./node/server-adapter.js";
-import { EcopagesApp as EcopagesApp2, createNodeApp } from "./node/create-app.js";
 export {
   EcopagesApp,
-  EcopagesApp2 as NodeAdapterEcopagesApp,
-  NodeServerAdapter,
   createApp,
-  createNodeApp,
-  createNodeServerAdapter,
   defineApiHandler,
   defineGroupHandler
 };

package/src/adapters/node/create-app.d.ts

@@ -1,16 +1,12 @@
 import { type Server as NodeServerInstance } from 'node:http';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import { type ApplicationAdapterOptions } from '../abstract/application-adapter.js';
 import { SharedApplicationAdapter } from '../shared/application-adapter.js';
-import { type NodeServerAdapterResult } from './server-adapter.js';
-export interface EcopagesAppOptions extends ApplicationAdapterOptions {
-    appConfig: EcoPagesAppConfig;
-    serverOptions?: Record<string, any>;
-}
-export declare class EcopagesApp extends SharedApplicationAdapter<EcopagesAppOptions, NodeServerInstance, Request> {
+import type { EcopagesAppOptions } from '../create-app.js';
+import { type NodeServerAdapterResult, createNodeServerAdapter } from './server-adapter.js';
+export declare class NodeEcopagesApp extends SharedApplicationAdapter<EcopagesAppOptions, NodeServerInstance, Request> {
     serverAdapter: NodeServerAdapterResult | undefined;
     private server;
     private runtimeOrigin;
+    protected createServerAdapter(params: Parameters<typeof createNodeServerAdapter>[0]): Promise<NodeServerAdapterResult>;
     stop(force?: boolean): Promise<void>;
     protected initializeServerAdapter(): Promise<NodeServerAdapterResult>;
     start(): Promise<NodeServerInstance | void>;
@@ -18,4 +14,5 @@ export declare class EcopagesApp extends SharedApplicationAdapter<EcopagesAppOpt
     private sendNodeResponse;
     fetch(request: Request): Promise<Response>;
 }
-export declare function createNodeApp(options: EcopagesAppOptions): Promise<EcopagesApp>;
+export declare function createNodeApp(options: EcopagesAppOptions): Promise<NodeEcopagesApp>;
+export declare function createApp(options: EcopagesAppOptions): Promise<NodeEcopagesApp>;

package/src/adapters/node/create-app.js

@@ -1,14 +1,16 @@
 import { createServer } from "node:http";
 import { Readable } from "node:stream";
-import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../constants.js";
+import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
 import { appLogger } from "../../global/app-logger.js";
-import {} from "../abstract/application-adapter.js";
 import { SharedApplicationAdapter } from "../shared/application-adapter.js";
 import { createNodeServerAdapter } from "./server-adapter.js";
-class EcopagesApp extends SharedApplicationAdapter {
+class NodeEcopagesApp extends SharedApplicationAdapter {
   serverAdapter;
   server = null;
   runtimeOrigin = "";
+  createServerAdapter(params) {
+    return createNodeServerAdapter(params);
+  }
   async stop(force = true) {
     if (!this.server) {
       return;
@@ -36,7 +38,7 @@ class EcopagesApp extends SharedApplicationAdapter {
     const preferredPort = cliPort ?? (envPort ? Number(envPort) : void 0) ?? DEFAULT_ECOPAGES_PORT;
     const preferredHostname = cliHostname ?? envHostname ?? DEFAULT_ECOPAGES_HOSTNAME;
     this.runtimeOrigin = `http://${preferredHostname}:${preferredPort}`;
-    return createNodeServerAdapter({
+    return this.createServerAdapter({
       runtimeOrigin: this.runtimeOrigin,
       appConfig: this.appConfig,
       apiHandlers: this.apiHandlers,
@@ -135,9 +137,13 @@ class EcopagesApp extends SharedApplicationAdapter {
   }
 }
 async function createNodeApp(options) {
-  return new EcopagesApp(options);
+  return new NodeEcopagesApp(options);
+}
+async function createApp(options) {
+  return createNodeApp(options);
 }
 export {
-  EcopagesApp,
+  NodeEcopagesApp,
+  createApp,
   createNodeApp
 };

package/src/adapters/node/node-client-bridge.d.ts

@@ -1,5 +1,5 @@
 import type { WebSocket } from 'ws';
-import type { ClientBridgeEvent, IClientBridge } from '../../public-types.js';
+import type { ClientBridgeEvent, IClientBridge } from '../../types/public-types.js';
 export declare class NodeClientBridge implements IClientBridge {
     private subscribers;
     private heartbeatTimer;

package/src/adapters/node/node-hmr-manager.d.ts

@@ -1,7 +1,7 @@
-import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../internal-types.js';
+import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../types/internal-types.js';
 import type { EcoBuildPlugin } from '../../build/build-types.js';
 import { type HmrStrategy } from '../../hmr/hmr-strategy.js';
-import type { ClientBridgeEvent } from '../../public-types.js';
+import type { ClientBridgeEvent } from '../../types/public-types.js';
 export interface NodeHmrManagerParams {
     appConfig: EcoPagesAppConfig;
     bridge: IClientBridge;

package/src/adapters/node/node-hmr-manager.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { RESOLVED_ASSETS_DIR } from "../../constants.js";
+import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
 import { getAppBuildExecutor } from "../../build/build-adapter.js";
 import { fileSystem } from "@ecopages/file-system";
 import { HmrStrategyType } from "../../hmr/hmr-strategy.js";
@@ -225,7 +225,7 @@ class NodeHmrManager {
    */
   async registerEntrypoint(entrypointPath) {
     return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-      emit: async (normalizedEntrypoint, outputPath) => await this.emitStrictEntrypoint(normalizedEntrypoint, outputPath),
+      emit: async (normalizedEntrypoint) => await this.emitStrictEntrypoint(normalizedEntrypoint),
       getMissingOutputError: (normalizedEntrypoint, outputPath) => new Error(
         `[HMR] Integration failed to emit entrypoint ${normalizedEntrypoint} to ${outputPath}. Page entrypoints must be produced by their owning integration.`
       )
@@ -255,7 +255,7 @@ class NodeHmrManager {
    * 3. Let the strategy chain try to emit the entrypoint without broadcasting.
    * 4. Fail if the owning integration did not emit the expected output.
    */
-  async emitStrictEntrypoint(entrypointPath, _outputPath) {
+  async emitStrictEntrypoint(entrypointPath) {
     await this.handleFileChange(entrypointPath, { broadcast: false });
   }
   /**

package/src/adapters/node/server-adapter.d.ts

@@ -1,6 +1,6 @@
 import { type Server as NodeHttpServer } from 'node:http';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { ApiHandler, ErrorHandler, StaticRoute } from '../../public-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+import type { ApiHandler, ErrorHandler, StaticRoute } from '../../types/public-types.js';
 import { SharedServerAdapter } from '../shared/server-adapter.js';
 import type { ServerAdapterResult } from '../abstract/server-adapter.js';
 export type NodeServerInstance = NodeHttpServer;
@@ -132,7 +132,7 @@ export declare class NodeServerAdapter extends SharedServerAdapter<NodeServerAda
      * underlying socket closes early — into a 499 response so it does not
      * incorrectly surface as a 500 in application logs.
      */
-    handleRequest(_request: Request): Promise<Response>;
+    handleRequest(request: Request): Promise<Response>;
     /**
      * Called once the HTTP server is bound and listening.
      *
@@ -149,7 +149,7 @@ export declare class NodeServerAdapter extends SharedServerAdapter<NodeServerAda
      * WebSocket upgrade requests that do not target `/_hmr` are rejected with an
      * immediate socket destroy to prevent unhandled upgrade leaks.
      */
-    completeInitialization(_server: NodeServerInstance): Promise<void>;
+    completeInitialization(server: NodeServerInstance): Promise<void>;
 }
 /**
  * Factory function that creates and fully initialises a `NodeServerAdapter`.

package/src/adapters/node/server-adapter.js

@@ -1,7 +1,6 @@
 import { createServer } from "node:http";
 import { appLogger } from "../../global/app-logger.js";
 import { NodeClientBridge } from "./node-client-bridge.js";
-import { NodeHmrManager } from "./node-hmr-manager.js";
 import { StaticSiteGenerator } from "../../static-site-generator/static-site-generator.js";
 import { SharedServerAdapter } from "../shared/server-adapter.js";
 import { ServerStaticBuilder } from "../shared/server-static-builder.js";
@@ -13,6 +12,7 @@ import {
   startSharedProjectWatching
 } from "../shared/runtime-bootstrap.js";
 import { NodeStaticContentServer } from "./static-content-server.js";
+import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
 class ClientAbortError extends Error {
   constructor() {
     super("Client closed the request");
@@ -102,12 +102,12 @@ class NodeServerAdapter extends SharedServerAdapter {
       appConfig: this.appConfig,
       options: {
         hostname: this.serveOptions.hostname,
-        port: Number(this.serveOptions.port || 3e3)
+        port: Number(this.serveOptions.port || DEFAULT_ECOPAGES_PORT)
       }
     });
     await this.previewServer.start();
-    const previewHostname = this.serveOptions.hostname || "localhost";
-    const previewPort = this.serveOptions.port || 3e3;
+    const previewHostname = this.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME;
+    const previewPort = this.serveOptions.port || DEFAULT_ECOPAGES_PORT;
     appLogger.info(`Preview running at http://${previewHostname}:${previewPort}`);
   }
   /**
@@ -198,8 +198,8 @@ class NodeServerAdapter extends SharedServerAdapter {
    * `stopBuildRuntimeServer`, so it never overlaps with the actual dev/prod server.
    */
   async startBuildRuntimeServer() {
-    const hostname = String(this.serveOptions.hostname || "localhost");
-    const port = Number(this.serveOptions.port || 3e3);
+    const hostname = String(this.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME);
+    const port = Number(this.serveOptions.port || DEFAULT_ECOPAGES_PORT);
     const server = createServer(async (req, res) => {
       try {
         const webRequest = this.createWebRequest(req);
@@ -269,12 +269,12 @@ class NodeServerAdapter extends SharedServerAdapter {
    * underlying socket closes early — into a 499 response so it does not
    * incorrectly surface as a 500 in application logs.
    */
-  async handleRequest(_request) {
+  async handleRequest(request) {
     if (!this.initialized) {
       throw new Error("Node server adapter is not initialized. Call createAdapter() first.");
     }
     try {
-      return await this.handleSharedRequest(_request, {
+      return await this.handleSharedRequest(request, {
         apiHandlers: this.apiHandlers,
         errorHandler: this.errorHandler,
         serverInstance: this.serverInstance,
@@ -303,16 +303,17 @@ class NodeServerAdapter extends SharedServerAdapter {
    * WebSocket upgrade requests that do not target `/_hmr` are rejected with an
    * immediate socket destroy to prevent unhandled upgrade leaks.
    */
-  async completeInitialization(_server) {
-    this.serverInstance = _server;
+  async completeInitialization(server) {
+    this.serverInstance = server;
     if (this.options?.watch) {
+      const { NodeHmrManager } = await import("./node-hmr-manager.js");
       const { WebSocketServer } = await import("ws");
       const wss = new WebSocketServer({ noServer: true });
       this.bridge = new NodeClientBridge();
       this.hmrManager = new NodeHmrManager({ appConfig: this.appConfig, bridge: this.bridge });
       this.hmrManager.setEnabled(true);
       await this.hmrManager.buildRuntime();
-      _server.on("upgrade", (req, socket, head) => {
+      server.on("upgrade", (req, socket, head) => {
         const url = new URL(req.url ?? "/", this.runtimeOrigin);
         if (url.pathname === "/_hmr") {
           wss.handleUpgrade(req, socket, head, (ws) => {
@@ -345,7 +346,7 @@ class NodeServerAdapter extends SharedServerAdapter {
   }
 }
 async function createNodeServerAdapter(params) {
-  const runtimeOrigin = params.runtimeOrigin ?? `http://${params.serveOptions.hostname || "localhost"}:${params.serveOptions.port || 3e3}`;
+  const runtimeOrigin = params.runtimeOrigin ?? `http://${params.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME}:${params.serveOptions.port || DEFAULT_ECOPAGES_PORT}`;
   const adapter = new NodeServerAdapter({
     ...params,
     runtimeOrigin

package/src/adapters/node/static-content-server.d.ts

@@ -1,5 +1,5 @@
 import { type Server as NodeHttpServer } from 'node:http';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 type NodeStaticContentServerOptions = {
     hostname?: string;
     port?: number;

package/src/adapters/node/static-content-server.js

@@ -1,6 +1,6 @@
 import { createServer } from "node:http";
 import { extname, join, normalize, sep } from "node:path";
-import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT, STATUS_MESSAGE } from "../../constants.js";
+import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT, STATUS_MESSAGE } from "../../config/constants.js";
 import { fileSystem } from "@ecopages/file-system";
 import { ServerUtils } from "../../utils/server-utils.module.js";
 class NodeStaticContentServer {

package/src/adapters/shared/application-adapter.d.ts

@@ -1,4 +1,4 @@
-import type { ApiHandler, ApiHandlerContext, Middleware, RouteGroupBuilder, RouteOptions } from '../../public-types.js';
+import type { ApiHandler, ApiHandlerContext, Middleware, RouteGroupBuilder, RouteOptions } from '../../types/public-types.js';
 import { AbstractApplicationAdapter, type ApplicationAdapterOptions, type RouteGroupDefinition, type RouteHandler } from '../abstract/application-adapter.js';
 export declare abstract class SharedApplicationAdapter<TOptions extends ApplicationAdapterOptions = ApplicationAdapterOptions, TServer = any, TRequest extends Request = Request> extends AbstractApplicationAdapter<TOptions, TServer, TRequest> {
     protected register<P extends string, TContext extends ApiHandlerContext<TRequest, TServer> = ApiHandlerContext<TRequest, TServer>>(path: P, method: ApiHandler['method'], handler: RouteHandler<TRequest, TServer, TContext>, options?: RouteOptions<TRequest, TServer, TContext>): this;

package/src/adapters/shared/define-api-handler.d.ts

@@ -1,4 +1,4 @@
-import type { ApiHandler, ApiHandlerContext, Middleware, RouteSchema, TypedGroupHandlerContext } from '../../public-types.js';
+import type { ApiHandler, ApiHandlerContext, Middleware, RouteSchema, TypedGroupHandlerContext } from '../../types/public-types.js';
 type UniversalContext = ApiHandlerContext<Request, unknown>;
 type SchemaHandlerContext<TSchema extends RouteSchema | undefined, TContext extends UniversalContext> = TSchema extends RouteSchema ? TypedGroupHandlerContext<TSchema, TContext> : TContext;
 export declare function defineApiHandler<TPath extends string, TSchema extends RouteSchema | undefined = undefined, TContext extends UniversalContext = UniversalContext>(handler: Omit<ApiHandler<TPath, Request, unknown>, 'handler' | 'middleware' | 'schema'> & {

package/src/adapters/shared/explicit-static-route-matcher.d.ts

@@ -1,5 +1,5 @@
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { StaticRoute } from '../../public-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+import type { StaticRoute } from '../../types/public-types.js';
 import type { RouteRendererFactory } from '../../route-renderer/route-renderer.js';
 export declare const EXPLICIT_STATIC_ROUTE_MATCHER_ERRORS: {
     readonly missingIntegration: (routePath: string) => string;

package/src/adapters/shared/file-route-middleware-pipeline.d.ts

@@ -1,4 +1,4 @@
-import type { Middleware, ApiHandlerContext, RequestLocals } from '../../public-types.js';
+import type { Middleware, ApiHandlerContext, RequestLocals } from '../../types/public-types.js';
 import type { PageCacheService } from '../../services/cache/page-cache-service.js';
 export declare const FILE_ROUTE_MIDDLEWARE_PIPELINE_ERRORS: {
     readonly CTX_RENDER_UNAVAILABLE: "[ecopages] ctx.render is not available in file-route middleware";

package/src/adapters/shared/fs-server-response-factory.d.ts

@@ -1,5 +1,5 @@
-import type { EcoPagesAppConfig, FileSystemServerOptions } from '../../internal-types.js';
-import type { RouteRendererBody } from '../../public-types.js';
+import type { EcoPagesAppConfig, FileSystemServerOptions } from '../../types/internal-types.js';
+import type { RouteRendererBody } from '../../types/public-types.js';
 import type { RouteRendererFactory } from '../../route-renderer/route-renderer.js';
 export declare class FileSystemServerResponseFactory {
     private appConfig;

package/src/adapters/shared/fs-server-response-factory.js

@@ -1,4 +1,4 @@
-import { STATUS_MESSAGE } from "../../constants.js";
+import { STATUS_MESSAGE } from "../../config/constants.js";
 import { appLogger } from "../../global/app-logger.js";
 import { fileSystem } from "@ecopages/file-system";
 class FileSystemServerResponseFactory {

package/src/adapters/shared/fs-server-response-matcher.d.ts

@@ -1,4 +1,4 @@
-import type { EcoPagesAppConfig, MatchResult } from '../../internal-types.js';
+import type { EcoPagesAppConfig, MatchResult } from '../../types/internal-types.js';
 import type { RouteRendererFactory } from '../../route-renderer/route-renderer.js';
 import type { FSRouter } from '../../router/server/fs-router.js';
 import type { PageCacheService } from '../../services/cache/page-cache-service.js';

package/src/adapters/shared/hmr-entrypoint-registrar.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
 import { appLogger } from "../../global/app-logger.js";
-import { RESOLVED_ASSETS_DIR } from "../../constants.js";
+import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
 class HmrEntrypointRegistrar {
   options;
   constructor(options) {

package/src/adapters/shared/hmr-html-response.d.ts

@@ -1,4 +1,4 @@
-import type { IHmrManager } from '../../public-types';
+import type { IHmrManager } from '../../types/public-types.js';
 /**
  * Returns whether a response is HTML and therefore eligible for development HMR
  * runtime injection.

package/src/adapters/shared/render-context.d.ts

@@ -1,7 +1,8 @@
-import type { RenderContext } from '../../public-types.js';
+import type { RenderContext } from '../../types/public-types.js';
 import type { IntegrationPlugin } from '../../plugins/integration-plugin.js';
 export interface CreateRenderContextOptions {
     integrations: IntegrationPlugin[];
+    rendererModules?: unknown;
 }
 /**
  * Creates a render context for route handlers.

package/src/adapters/shared/render-context.js

@@ -15,7 +15,9 @@ function createRenderContext(options) {
     );
     const integration = integrations.find((i) => i.name === integrationName);
     invariant(!!integration, `No integration found for: ${integrationName}`);
-    return integration.initializeRenderer();
+    return integration.initializeRenderer({
+      rendererModules: options.rendererModules
+    });
   };
   const renderContext = {
     async render(view, props, renderOptions) {

package/src/adapters/shared/runtime-bootstrap.d.ts

@@ -1,6 +1,6 @@
 import { type BuildExecutor } from '../../build/build-adapter.js';
 import type { EcoBuildPlugin } from '../../build/build-types.js';
-import type { EcoPagesAppConfig, IClientBridge, IHmrManager } from '../../internal-types.js';
+import type { EcoPagesAppConfig, IClientBridge, IHmrManager } from '../../types/internal-types.js';
 /**
  * Installs and returns the app-owned runtime build executor used by adapter
  * startup and follow-up runtime work.

package/src/adapters/shared/runtime-bootstrap.js

@@ -2,7 +2,7 @@ import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
 import { getAppBrowserBuildPlugins, setupAppRuntimePlugins } from "../../build/build-adapter.js";
 import { installAppRuntimeBuildExecutor } from "../../build/runtime-build-executor.js";
-import { RESOLVED_ASSETS_DIR } from "../../constants.js";
+import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
 import { ProjectWatcher } from "../../watchers/project-watcher.js";
 function installSharedRuntimeBuildExecutor(appConfig, options) {
   return installAppRuntimeBuildExecutor(appConfig, options);

package/src/adapters/shared/server-adapter.d.ts

@@ -7,7 +7,7 @@ import { StaticSiteGenerator } from '../../static-site-generator/static-site-gen
 import { ServerStaticBuilder } from './server-static-builder.js';
 import { FileSystemResponseMatcher } from './fs-server-response-matcher.js';
 import { ServerRouteHandler } from './server-route-handler.js';
-import type { ApiHandler, CacheInvalidator, ErrorHandler, RenderContext, StaticRoute } from '../../public-types.js';
+import type { ApiHandler, CacheInvalidator, ErrorHandler, RenderContext, StaticRoute } from '../../types/public-types.js';
 export declare abstract class SharedServerAdapter<TOptions extends ServerAdapterOptions, TResult extends ServerAdapterResult> extends AbstractServerAdapter<TOptions, TResult> {
     protected router: FSRouter;
     protected fileSystemResponseMatcher: FileSystemResponseMatcher;

package/src/adapters/shared/server-adapter.js

@@ -91,6 +91,7 @@ class SharedServerAdapter extends AbstractServerAdapter {
   configureSharedResponseHandlers(staticRoutes, hmrManager) {
     this.routeRendererFactory = new RouteRendererFactory({
       appConfig: this.appConfig,
+      rendererModules: this.appConfig.runtime?.rendererModuleContext,
       runtimeOrigin: this.runtimeOrigin
     });
     const fileSystemResponseFactory = new FileSystemServerResponseFactory({
@@ -132,7 +133,10 @@ class SharedServerAdapter extends AbstractServerAdapter {
     return this.fileSystemResponseMatcher?.getCacheService() ?? null;
   }
   getRenderContext() {
-    return createRenderContext({ integrations: this.appConfig.integrations });
+    return createRenderContext({
+      integrations: this.appConfig.integrations,
+      rendererModules: this.appConfig.runtime?.rendererModuleContext
+    });
   }
   /**
    * Executes an Application Programming Interface (API) handler in an environment-agnostic manner.

package/src/adapters/shared/server-route-handler.d.ts

@@ -1,7 +1,7 @@
-import type { IHmrManager } from '../../public-types';
-import type { FSRouter } from '../../router/server/fs-router';
-import type { ExplicitStaticRouteMatcher } from './explicit-static-route-matcher';
-import type { FileSystemResponseMatcher } from './fs-server-response-matcher';
+import type { IHmrManager } from '../../types/public-types.js';
+import type { FSRouter } from '../../router/server/fs-router.js';
+import type { ExplicitStaticRouteMatcher } from './explicit-static-route-matcher.js';
+import type { FileSystemResponseMatcher } from './fs-server-response-matcher.js';
 /**
  * Configuration parameters for ServerRouteHandler.
  */