@ecopages/core 0.2.0-beta.29 → 0.2.0-beta.30

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

@@ -9,19 +9,19 @@ import { setupAppRuntimePlugins } from "../../build/build-adapter.js";
 import { installBuildRuntime } from "../../build/runtime/build-runtime.js";
 import { StaticSiteGenerator } from "../../static-site-generator/static-site-generator.js";
 import { ProjectWatcher } from "../../watchers/project-watcher.js";
-import { SharedServerAdapter } from "../shared/server-adapter.js";
-import { ApiResponseBuilder } from "../shared/api-response.js";
-import { ServerStaticBuilder } from "../shared/server-static-builder.js";
-import { attachNodeHttpWebSocketUpgrades } from "../shared/node-http-websocket-upgrades.js";
-import { createBunUserWebSocketLifecycle } from "../shared/bun-user-websocket-lifecycle.js";
-import { createEcopagesSocket } from "../shared/websocket-lifecycle.js";
-import { resolveServeRuntimeOrigin } from "../shared/runtime-app-bootstrap.js";
+import { SharedServerAdapter } from "../shared/runtime/server-adapter.js";
+import { ApiResponseBuilder } from "../shared/http/api-response.js";
+import { ServerStaticBuilder } from "../shared/runtime/server-static-builder.js";
+import { attachNodeHttpWebSocketUpgrades } from "../shared/ws/node-http-websocket-upgrades.js";
+import { createBunUserWebSocketLifecycle } from "./bun-user-websocket-lifecycle.js";
+import { createEcopagesSocket } from "../shared/ws/websocket-lifecycle.js";
+import { resolveServeRuntimeOrigin } from "../shared/runtime/runtime-app-bootstrap.js";
 import {
   attachHmrToIntegrations,
   disposeDevResources,
-  maybeInjectAdapterHmrHtmlResponse,
-  prepareRuntimePublicDir
-} from "../shared/runtime-server-lifecycle.js";
+  prepareRuntimePublicDir,
+  startConfiguredIntegrationRuntimePrewarm
+} from "../shared/runtime/runtime-server-lifecycle.js";
 import { ClientBridge } from "./client-bridge.js";
 import { setAppDevClientBridge } from "../../dev/client-bridge-registry.js";
 import { setAppHmrManager } from "../../dev/hmr-manager-registry.js";
@@ -137,21 +137,6 @@ class BunServerAdapter extends SharedServerAdapter {
       passthroughUnmatched: options?.passthroughUnmatched
     });
   }
-  /**
-   * Returns whether adapter-level HTML responses still need HMR runtime injection.
-   *
-   * @remarks
-   * Filesystem-routed pages are wrapped later in the shared route layer. This
-   * adapter-level check exists for explicit API handlers that return HTML and
-   * would otherwise bypass the route wrapper entirely.
-   */
-  async maybeInjectHmrScript(response) {
-    return maybeInjectAdapterHmrHtmlResponse(response, {
-      watch: this.options?.watch === true,
-      hmrManager: this.hmrManager,
-      hostOwnsDevClient: this.hostOwnsDevClient
-    });
-  }
   /**
    * Initializes the server adapter's core runtime components.
    */
@@ -307,14 +292,13 @@ class BunServerAdapter extends SharedServerAdapter {
   }
   /**
    * @remarks
-   * When `serveHmrEndpoints` is set, `/_hmr` and `/_hmr_runtime.js` are checked
-   * before user websocket patterns so HMR upgrades are never captured by app routes.
+   * When `serveHmrEndpoints` is set, `/_hmr` is checked before user websocket
+   * patterns so HMR upgrades are never captured by app routes. Runtime assets are
+   * served by `SharedServerAdapter.handleSharedRequest` via `tryHandleAssetRequest`.
    * Production mode with only user handlers skips the HMR branch entirely.
    */
   wrapFetchWithWebSocketUpgrades(originalFetch, { serveHmrEndpoints }) {
     const matchRoute = (pathname) => findWebSocketRoute(this.websocketHandlers, pathname);
-    const hmrManager = this.hmrManager;
-    const waitForInit = this.waitForInitialization.bind(this);
     return async function(request, server) {
       const url = new URL(request.url);
       if (serveHmrEndpoints) {
@@ -322,20 +306,6 @@ class BunServerAdapter extends SharedServerAdapter {
           const success = this.upgrade(request, { data: { kind: "__hmr__", params: {}, search: {} } });
           return success ? void 0 : new Response("WebSocket upgrade failed", { status: 400 });
         }
-        if (url.pathname === "/_hmr_runtime.js") {
-          await waitForInit();
-          const runtimeReady = await hmrManager.ensureRuntimeReady();
-          const runtimePath = hmrManager.getRuntimePath();
-          if (runtimeReady && fileSystem.exists(runtimePath)) {
-            return new Response(fileSystem.readFileAsBuffer(runtimePath), {
-              headers: { "Content-Type": "application/javascript" }
-            });
-          }
-          appLogger.warn(
-            `[HMR] Runtime script not found at ${runtimePath}; the HMR runtime build likely failed during startup.`
-          );
-          return new Response("Not Found", { status: 404 });
-        }
       }
       const wsMatch = matchRoute(url.pathname);
       if (wsMatch && request.headers.get("upgrade")?.toLowerCase() === "websocket") {
@@ -352,22 +322,6 @@ class BunServerAdapter extends SharedServerAdapter {
       return res instanceof Response ? res : new Response("Not Found", { status: 404 });
     };
   }
-  /**
-   * Helper method to retrieve and parse the request body.
-   * Handles JSON and plain text content types.
-   * For FormData (multipart/form-data, x-www-form-urlencoded), use ctx.request.formData() directly.
-   * Returns undefined for unsupported content types.
-   */
-  async retrieveBodyFromRequest(request) {
-    const contentType = request.headers.get("Content-Type") || "";
-    if (contentType.includes("application/json")) {
-      return await request.json();
-    }
-    if (contentType.includes("text/plain")) {
-      return await request.text();
-    }
-    return void 0;
-  }
   /**
    * Composes the base Bun server settings that all runtime modes build from.
    *
@@ -517,6 +471,10 @@ class BunServerAdapter extends SharedServerAdapter {
     });
     if (this.options?.watch) {
       await this.hmrManager.ensureRuntimeReady();
+      startConfiguredIntegrationRuntimePrewarm({
+        appConfig: this.appConfig,
+        runtimeOrigin: this.runtimeOrigin
+      });
     }
     this.fullyInitialized = true;
     if (this.options?.watch) await this.watch();
@@ -568,11 +526,9 @@ class BunServerAdapter extends SharedServerAdapter {
    * Handles HTTP requests by passing them securely to the shared core router adapter.
    *
    * @remarks
-   * Filesystem page responses are wrapped by `ServerRouteHandler`. This
-   * adapter-level pass only covers HTML returned by explicit API handlers,
-   * which bypass that route-layer wrapper and would otherwise miss the
-   * dev HMR runtime — so the HMR script injection happens here, after
-   * the shared handler runs.
+   * HMR HTML injection for API and page responses is owned by
+   * `SharedServerAdapter.handleSharedRequest`. This method only maps the
+   * request into the shared pipeline.
    */
   async handleRequest(request) {
     const response = await this.handleSharedRequest(request, {
@@ -581,7 +537,7 @@ class BunServerAdapter extends SharedServerAdapter {
       serverInstance: this.serverInstance,
       hmrManager: this.hmrManager
     });
-    return await this.maybeInjectHmrScript(response);
+    return response;
   }
   /**
    * Ensures server initialization completes before request handling.

package/src/adapters/bun/static-preview-host.d.ts

@@ -1,5 +1,5 @@
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { StaticPreviewHost, StaticPreviewHostStartOptions } from '../shared/static-preview-host.js';
+import type { StaticPreviewHost, StaticPreviewHostStartOptions } from '../shared/runtime/static-preview-host.js';
 type BunStaticPreviewServer = {
     server: {
         port?: number;

package/src/adapters/bun/static-preview-host.js

@@ -1,6 +1,6 @@
 import { StaticContentServer } from "../../dev/sc-server.js";
 import { appLogger } from "../../global/app-logger.js";
-import { PortManager } from "../shared/port-manager.js";
+import { PortManager } from "../shared/runtime/port-manager.js";
 class BunStaticPreviewHost {
   constructor(previewServerFactory = StaticContentServer, logger = appLogger) {
     this.previewServerFactory = previewServerFactory;

package/src/adapters/index.d.ts

@@ -1,2 +1,2 @@
 export { createApp } from './create-app.js';
-export { defineApiHandler, defineGroupHandler, type GroupHandler } from './shared/define-api-handler.js';
+export { defineApiHandler, defineGroupHandler, defineGet, definePost, definePut, defineDelete, definePatch, defineOptions, defineHead, json, html, redirect, type GroupHandler, } from './shared/http/define-api-handler.js';

package/src/adapters/index.js

@@ -1,7 +1,30 @@
 import { createApp } from "./create-app.js";
-import { defineApiHandler, defineGroupHandler } from "./shared/define-api-handler.js";
+import {
+  defineApiHandler,
+  defineGroupHandler,
+  defineGet,
+  definePost,
+  definePut,
+  defineDelete,
+  definePatch,
+  defineOptions,
+  defineHead,
+  json,
+  html,
+  redirect
+} from "./shared/http/define-api-handler.js";
 export {
   createApp,
   defineApiHandler,
-  defineGroupHandler
+  defineDelete,
+  defineGet,
+  defineGroupHandler,
+  defineHead,
+  defineOptions,
+  definePatch,
+  definePost,
+  definePut,
+  html,
+  json,
+  redirect
 };

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

@@ -1,5 +1,5 @@
-import { SharedApplicationAdapter } from '../shared/application-adapter.js';
-import type { RuntimeHost } from '../shared/runtime-host.js';
+import { SharedApplicationAdapter } from '../shared/runtime/application-adapter.js';
+import type { RuntimeHost } from '../shared/runtime/runtime-host.js';
 import type { EcopagesAppOptions } from '../create-app.js';
 import { type NodeServerAdapterResult, createNodeServerAdapter } from './server-adapter.js';
 import type { NodeServerInstance } from './server-adapter.js';

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

@@ -1,6 +1,6 @@
 import { appLogger } from "../../global/app-logger.js";
-import { SharedApplicationAdapter } from "../shared/application-adapter.js";
-import { resolveRuntimeBinding, resolveStaticRuntimeMode } from "../shared/runtime-app-bootstrap.js";
+import { SharedApplicationAdapter } from "../shared/runtime/application-adapter.js";
+import { resolveRuntimeBinding, resolveStaticRuntimeMode } from "../shared/runtime/runtime-app-bootstrap.js";
 import { createNodeServerAdapter } from "./server-adapter.js";
 import { NodeHttpRequestBridge } from "./http-request-bridge.js";
 import { NodeRuntimeHost } from "./runtime-host.js";

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

@@ -1,6 +1,6 @@
 import type { EcoPagesAppConfig, IClientBridge } from '../../types/internal-types.js';
 import { InMemoryEntrypointDependencyGraph, type EntrypointDependencyGraph } from '../../services/runtime-state/entrypoint-dependency-graph.service.js';
-import { SharedHmrManager } from '../shared/shared-hmr-manager.js';
+import { SharedHmrManager } from '../shared/hmr/shared-hmr-manager.js';
 export interface NodeHmrManagerParams {
     appConfig: EcoPagesAppConfig;
     bridge: IClientBridge;

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

@@ -2,7 +2,7 @@ import { appLogger } from "../../global/app-logger.js";
 import {
   InMemoryEntrypointDependencyGraph
 } from "../../services/runtime-state/entrypoint-dependency-graph.service.js";
-import { SharedHmrManager } from "../shared/shared-hmr-manager.js";
+import { SharedHmrManager } from "../shared/hmr/shared-hmr-manager.js";
 class NodeHmrManager extends SharedHmrManager {
   /**
    * Creates the Node HMR manager over the shared coordination pipeline.

package/src/adapters/node/runtime-host.d.ts

@@ -1,5 +1,5 @@
 import { createServer, type Server as NodeServerInstance } from 'node:http';
-import type { RuntimeHost, RuntimeHostStartOptions } from '../shared/runtime-host.js';
+import type { RuntimeHost, RuntimeHostStartOptions } from '../shared/runtime/runtime-host.js';
 import { NodeHttpRequestBridge } from './http-request-bridge.js';
 type NodeServerFactory = typeof createServer;
 /**

package/src/adapters/node/runtime-host.js

@@ -1,7 +1,7 @@
 import { createServer } from "node:http";
 import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
 import { appLogger } from "../../global/app-logger.js";
-import { resolveServeRuntimeOrigin } from "../shared/runtime-app-bootstrap.js";
+import { resolveServeRuntimeOrigin } from "../shared/runtime/runtime-app-bootstrap.js";
 import { isNodeClientAbortError, NodeHttpRequestBridge } from "./http-request-bridge.js";
 class NodeRuntimeHost {
   /**

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

@@ -1,10 +1,10 @@
 import { type Server as NodeHttpServer } from 'node:http';
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 import type { ApiHandler, ErrorHandler, StaticRoute, EcopagesWebSocketHandler } from '../../types/public-types.js';
-import { SharedServerAdapter } from '../shared/server-adapter.js';
+import { SharedServerAdapter } from '../shared/runtime/server-adapter.js';
 import type { ServerAdapterResult } from '../abstract/server-adapter.js';
 import { NodeHttpRequestBridge } from './http-request-bridge.js';
-import type { StaticPreviewHost } from '../shared/static-preview-host.js';
+import type { StaticPreviewHost } from '../shared/runtime/static-preview-host.js';
 import { type NodeServerDevRuntimeFactory } from './server-adapter-dependencies.js';
 export type NodeServerInstance = NodeHttpServer;
 export type NodeServeAdapterServerOptions = {
@@ -93,7 +93,6 @@ export declare class NodeServerAdapter extends SharedServerAdapter<NodeServerAda
         passthroughUnmatched?: boolean;
     }): void;
     private wireUserWebSocketUpgrades;
-    private maybeInjectHmrScript;
     /**
      * @remarks
      * `previewHost`, `requestBridge`, and `devRuntimeFactory` are optional on the

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

@@ -9,18 +9,18 @@ import { NodeHmrManager } from "./node-hmr-manager.js";
 import { ProjectWatcher } from "../../watchers/project-watcher.js";
 import {
   attachNodeHttpWebSocketUpgrades
-} from "../shared/node-http-websocket-upgrades.js";
+} from "../shared/ws/node-http-websocket-upgrades.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";
+import { SharedServerAdapter } from "../shared/runtime/server-adapter.js";
+import { ServerStaticBuilder } from "../shared/runtime/server-static-builder.js";
 import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
 import {
   attachHmrToIntegrations,
   disposeDevResources,
-  maybeInjectAdapterHmrHtmlResponse,
-  prepareRuntimePublicDir
-} from "../shared/runtime-server-lifecycle.js";
-import { resolveServeRuntimeOrigin } from "../shared/runtime-app-bootstrap.js";
+  prepareRuntimePublicDir,
+  startConfiguredIntegrationRuntimePrewarm
+} from "../shared/runtime/runtime-server-lifecycle.js";
+import { resolveServeRuntimeOrigin } from "../shared/runtime/runtime-app-bootstrap.js";
 import { NodeClientAbortError, NodeHttpRequestBridge } from "./http-request-bridge.js";
 import { NodeStaticPreviewHost } from "./static-preview-host.js";
 import { DefaultNodeServerDevRuntimeFactory } from "./server-adapter-dependencies.js";
@@ -69,13 +69,6 @@ class NodeServerAdapter extends SharedServerAdapter {
       preflight
     });
   }
-  async maybeInjectHmrScript(response) {
-    return maybeInjectAdapterHmrHtmlResponse(response, {
-      watch: this.options?.watch === true,
-      hmrManager: this.hmrManager ?? void 0,
-      hostOwnsDevClient: this.hostOwnsDevClient
-    });
-  }
   /**
    * @remarks
    * `previewHost`, `requestBridge`, and `devRuntimeFactory` are optional on the
@@ -243,9 +236,9 @@ class NodeServerAdapter extends SharedServerAdapter {
         apiHandlers: this.apiHandlers,
         errorHandler: this.errorHandler,
         serverInstance: this.serverInstance,
-        hmrManager: this.hmrManager
+        hmrManager: this.hmrManager ?? void 0
       });
-      return await this.maybeInjectHmrScript(response);
+      return response;
     } catch (error) {
       if (error instanceof NodeClientAbortError) {
         return new Response(null, { status: 499 });
@@ -299,14 +292,18 @@ class NodeServerAdapter extends SharedServerAdapter {
         });
       }
       attachHmrToIntegrations(this.appConfig, this.hmrManager);
+      startConfiguredIntegrationRuntimePrewarm({
+        appConfig: this.appConfig,
+        runtimeOrigin: this.runtimeOrigin
+      });
       this.configureSharedResponseHandlers(this.staticRoutes, this.hmrManager);
       const watcher = new ProjectWatcher({
         config: this.appConfig,
         refreshRouterRoutesCallback: this.createSharedWatchRefreshCallback({
           staticRoutes: this.staticRoutes,
-          hmrManager: this.hmrManager
+          hmrManager: this.hmrManager ?? void 0
         }),
-        hmrManager: this.hmrManager,
+        hmrManager: this.hmrManager ?? void 0,
         bridge: this.bridge,
         hostOwnsDevClient: this.hostOwnsDevClient
       });

package/src/adapters/node/static-preview-host.d.ts

@@ -1,6 +1,6 @@
 import type { AddressInfo } from 'node:net';
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { StaticPreviewHost, StaticPreviewHostStartOptions } from '../shared/static-preview-host.js';
+import type { StaticPreviewHost, StaticPreviewHostStartOptions } from '../shared/runtime/static-preview-host.js';
 type NodeStaticPreviewServer = {
     start(): Promise<{
         address(): AddressInfo | string | null;

package/src/adapters/node/static-preview-host.js

@@ -1,5 +1,5 @@
 import { appLogger } from "../../global/app-logger.js";
-import { PortManager } from "../shared/port-manager.js";
+import { PortManager } from "../shared/runtime/port-manager.js";
 import { NodeStaticContentServer } from "./static-content-server.js";
 class NodeStaticPreviewHost {
   /**

package/src/adapters/shared/{hmr-entrypoint-registrar.d.ts → hmr/hmr-entrypoint-registrar.d.ts}

@@ -1,4 +1,4 @@
-import { type ResolvedHmrEntrypoint } from '../../hmr/hmr-entrypoint-output.js';
+import { type ResolvedHmrEntrypoint } from '../../../hmr/hmr-entrypoint-output.js';
 /**
  * Runtime-specific hooks required to materialize a single HMR entrypoint.
  */

package/src/adapters/shared/{hmr-entrypoint-registrar.js → hmr/hmr-entrypoint-registrar.js}

@@ -3,7 +3,7 @@ import { fileSystem } from "@ecopages/file-system";
 import {
   removeStaleHmrEntrypointOutput,
   resolveHmrEntrypointOutputPaths
-} from "../../hmr/hmr-entrypoint-output.js";
+} from "../../../hmr/hmr-entrypoint-output.js";
 class HmrEntrypointRegistrar {
   options;
   inFlight = /* @__PURE__ */ new Map();

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

@@ -1,4 +1,4 @@
-import type { IHmrManager } from '../../types/public-types.js';
+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/{shared-hmr-manager.d.ts → hmr/shared-hmr-manager.d.ts}

@@ -1,13 +1,13 @@
 import fs from 'node:fs';
-import { type ResolvedHmrEntrypoint } from '../../hmr/hmr-entrypoint-output.js';
-import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../types/internal-types.js';
-import { type HmrStrategy } from '../../hmr/hmr-strategy.js';
-import { DevelopmentInvalidationService } from '../../services/invalidation/development-invalidation.service.js';
-import type { ClientBridgeEvent, HmrFileChangeOptions } from '../../types/public-types.js';
+import { type ResolvedHmrEntrypoint } from '../../../hmr/hmr-entrypoint-output.js';
+import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../../types/internal-types.js';
+import { type HmrStrategy } from '../../../hmr/hmr-strategy.js';
+import { DevelopmentInvalidationService } from '../../../services/invalidation/development-invalidation.service.js';
+import type { ClientBridgeEvent, HmrFileChangeOptions } from '../../../types/public-types.js';
 import { HmrEntrypointRegistrar } from './hmr-entrypoint-registrar.js';
-import { BrowserBundleService } from '../../services/assets/browser-bundle.service.js';
-import { type EntrypointDependencyGraph } from '../../services/runtime-state/entrypoint-dependency-graph.service.js';
-import type { ServerModuleTranspiler } from '../../services/module-loading/server-module-transpiler.service.js';
+import { BrowserBundleService } from '../../../services/assets/browser-bundle.service.js';
+import { type EntrypointDependencyGraph } from '../../../services/runtime-state/entrypoint-dependency-graph.service.js';
+import type { ServerModuleTranspiler } from '../../../services/module-loading/server-module-transpiler.service.js';
 type HandleFileChangeOptions = HmrFileChangeOptions;
 type SharedHmrManagerParams = {
     appConfig: EcoPagesAppConfig;
@@ -88,6 +88,7 @@ export declare abstract class SharedHmrManager implements IHmrManager {
      */
     getResolvedScriptOutput(entrypointPath: string): ResolvedHmrEntrypoint | undefined;
     getWatchedFiles(): Map<string, string>;
+    tryHandleAssetRequest(request: Request): Response | null;
     getDistDir(): string;
     getDefaultContext(): DefaultHmrContext;
     stop(): void;

package/src/adapters/shared/{shared-hmr-manager.js → hmr/shared-hmr-manager.js}

@@ -1,28 +1,28 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
+import { RESOLVED_ASSETS_DIR } from "../../../config/constants.js";
 import {
   removeStaleHmrEntrypointOutput,
   isRegisteredScriptEntrypoint,
   isBrowserOnlyRegisteredScriptEntrypoint
-} from "../../hmr/hmr-entrypoint-output.js";
-import { requireBuildRuntime } from "../../build/runtime/build-runtime.js";
+} from "../../../hmr/hmr-entrypoint-output.js";
+import { requireBuildRuntime } from "../../../build/runtime/build-runtime.js";
 import { fileSystem } from "@ecopages/file-system";
-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 { ServerRenderedTemplateHmrStrategy } from "../../hmr/strategies/server-rendered-template-hmr-strategy.js";
-import { DevelopmentInvalidationService } from "../../services/invalidation/development-invalidation.service.js";
-import { appLogger } from "../../global/app-logger.js";
+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 { ServerRenderedTemplateHmrStrategy } from "../../../hmr/strategies/server-rendered-template-hmr-strategy.js";
+import { DevelopmentInvalidationService } from "../../../services/invalidation/development-invalidation.service.js";
+import { appLogger } from "../../../global/app-logger.js";
 import { HmrEntrypointRegistrar } from "./hmr-entrypoint-registrar.js";
-import { BrowserBundleService } from "../../services/assets/browser-bundle.service.js";
-import { getAppServerModuleTranspiler } from "../../services/module-loading/app-server-module-transpiler.service.js";
+import { BrowserBundleService } from "../../../services/assets/browser-bundle.service.js";
+import { getAppServerModuleTranspiler } from "../../../services/module-loading/app-server-module-transpiler.service.js";
 import {
   getAppEntrypointDependencyGraph,
   setAppEntrypointDependencyGraph
-} from "../../services/runtime-state/entrypoint-dependency-graph.service.js";
-import { resolveInternalExecutionDir, resolveInternalWorkDir } from "../../utils/resolve-work-dir.js";
+} from "../../../services/runtime-state/entrypoint-dependency-graph.service.js";
+import { resolveInternalExecutionDir, resolveInternalWorkDir } from "../../../utils/resolve-work-dir.js";
 class SharedHmrManager {
   appConfig;
   bridge;
@@ -90,10 +90,9 @@ class SharedHmrManager {
       getEntrypointDependencyGraph: () => this.entrypointDependencyGraph,
       shouldProcessEntrypoint: (entrypointPath) => this.shouldJsStrategyProcessEntrypoint(entrypointPath)
     };
-    const invalidationService = new DevelopmentInvalidationService(this.appConfig);
     this.strategies = [
       new JsHmrStrategy(jsContext),
-      new ServerRenderedTemplateHmrStrategy(invalidationService),
+      new ServerRenderedTemplateHmrStrategy(this.invalidationService),
       new DefaultHmrStrategy()
     ];
   }
@@ -319,6 +318,33 @@ class SharedHmrManager {
   getWatchedFiles() {
     return this.entrypointRegistrar.getWatchedFiles();
   }
+  tryHandleAssetRequest(request) {
+    const url = new URL(request.url);
+    if (url.pathname === "/_hmr_runtime.js") {
+      const runtimePath = this.getRuntimePath();
+      if (fileSystem.exists(runtimePath)) {
+        return new Response(fileSystem.readFileAsBuffer(runtimePath), {
+          headers: {
+            "Content-Type": "application/javascript",
+            "Cache-Control": "no-store, must-revalidate"
+          }
+        });
+      }
+    }
+    if (url.pathname.startsWith("/assets/_hmr/")) {
+      const relativePath = url.pathname.slice("/assets/_hmr/".length);
+      const assetPath = path.join(this.distDir, relativePath);
+      if (fileSystem.exists(assetPath)) {
+        return new Response(fileSystem.readFileAsBuffer(assetPath), {
+          headers: {
+            "Content-Type": "application/javascript",
+            "Cache-Control": "no-store, must-revalidate"
+          }
+        });
+      }
+    }
+    return null;
+  }
   getDistDir() {
     return this.distDir;
   }

package/src/adapters/shared/http/api-request-pipeline.d.ts

@@ -0,0 +1,23 @@
+import type { SchemaValidationService } from '../../../services/validation/schema-validation-service.js';
+import type { ApiHandler, CacheInvalidator, ErrorHandler, RenderContext } from '../../../types/public-types.js';
+export type ApiRequestPipelineOptions = {
+    schemaValidator: SchemaValidationService;
+    getRenderContext: () => RenderContext;
+    getCacheService: () => CacheInvalidator | null;
+};
+export declare class ApiRequestPipeline<TRequest extends Request = Request, TServer = unknown> {
+    private readonly schemaValidator;
+    private readonly getRenderContext;
+    private readonly getCacheService;
+    constructor(options: ApiRequestPipelineOptions);
+    match(request: TRequest, apiHandlers: ApiHandler<string, TRequest, TServer>[]): {
+        routeConfig: ApiHandler<string, TRequest, TServer>;
+        params: Record<string, string | string[]>;
+    } | null;
+    tryHandle(request: TRequest, apiHandlers: ApiHandler<string, TRequest, TServer>[], serverInstance: TServer | undefined, errorHandler?: ErrorHandler<TRequest, TServer>): Promise<Response | null>;
+    execute(request: TRequest, params: Record<string, string | string[]>, routeConfig: ApiHandler<string, TRequest, TServer>, serverInstance: TServer | undefined, errorHandler?: ErrorHandler<TRequest, TServer>): Promise<Response>;
+    private createContext;
+    private normalizeParams;
+    private applyRequestSchema;
+    private runMiddlewareChain;
+}