@ecopages/core 0.2.0-beta.31 → 0.2.0-beta.32

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

@@ -1,226 +1,242 @@
-import path from "node:path";
-import { AbstractServerAdapter } from "../../abstract/server-adapter.js";
-import { RouteRendererFactory } from "../../../route-renderer/route-renderer.js";
-import { RouteRegistry } from "../../../router/server/route-registry.js";
-import { startupTrace } from "../../../diagnostics/startup-trace.js";
-import { requestBuildDedupe } from "../../../diagnostics/request-build-dedupe.js";
-import { MemoryCacheStore } from "../../../services/cache/memory-cache-store.js";
-import { PageCacheService } from "../../../services/cache/page-cache-service.js";
-import { SchemaValidationService } from "../../../services/validation/schema-validation-service.js";
-import { StaticSiteGenerator } from "../../../static-site-generator/static-site-generator.js";
-import { ServerStaticBuilder } from "./server-static-builder.js";
-import { ExplicitStaticRouteMatcher } from "../http/explicit-static-route-matcher.js";
-import { FileSystemServerResponseFactory } from "../http/fs-server-response-factory.js";
-import { FileSystemResponseMatcher } from "../http/fs-server-response-matcher.js";
-import { ServerRouteHandler } from "./server-route-handler.js";
-import { createRenderContext } from "./render-context.js";
-import { ApiRequestPipeline } from "../http/api-request-pipeline.js";
-import {
-  injectHmrRuntimeIntoHtmlResponse,
-  isHtmlResponse,
-  shouldInjectHmrHtmlResponse
-} from "../hmr/hmr-html-response.js";
-import { getAppServerModuleTranspiler } from "../../../services/module-loading/app-server-module-transpiler.service.js";
-import { resolveInternalExecutionDir } from "../../../utils/resolve-work-dir.js";
-class SharedServerAdapter extends AbstractServerAdapter {
-  router;
-  fileSystemResponseMatcher;
-  routeRendererFactory;
-  routeHandler;
-  staticSiteGenerator;
-  staticBuilder;
-  schemaValidator = new SchemaValidationService();
-  apiRequestPipeline = new ApiRequestPipeline({
-    schemaValidator: this.schemaValidator,
-    getRenderContext: () => this.getRenderContext(),
-    getCacheService: () => this.getCacheService()
-  });
-  hostOwnsDevClient = false;
-  async initializeSharedRouteHandling(options) {
-    this.ensureRouteRendererFactory();
-    await this.initSharedRouter();
-    this.configureSharedResponseHandlers(options.staticRoutes, options.hmrManager);
-  }
-  ensureRouteRendererFactory() {
-    if (this.routeRendererFactory) {
-      return;
-    }
-    this.routeRendererFactory = new RouteRendererFactory({
-      appConfig: this.appConfig,
-      rendererModules: this.appConfig.runtime?.rendererModuleContext,
-      runtimeOrigin: this.runtimeOrigin
+import path from 'node:path';
+import { AbstractServerAdapter } from '../../abstract/server-adapter.js';
+import { RouteRendererFactory } from '../../../route-renderer/route-renderer.js';
+import { RouteRegistry } from '../../../router/server/route-registry.js';
+import { startupTrace } from '../../../diagnostics/startup-trace.js';
+import { requestBuildDedupe } from '../../../diagnostics/request-build-dedupe.js';
+import { MemoryCacheStore } from '../../../services/cache/memory-cache-store.js';
+import { PageCacheService } from '../../../services/cache/page-cache-service.js';
+import { SchemaValidationService } from '../../../services/validation/schema-validation-service.js';
+import { StaticSiteGenerator } from '../../../static-site-generator/static-site-generator.js';
+import { ServerStaticBuilder } from './server-static-builder.js';
+import { ExplicitStaticRouteMatcher } from '../http/explicit-static-route-matcher.js';
+import { FileSystemServerResponseFactory } from '../http/fs-server-response-factory.js';
+import { FileSystemResponseMatcher } from '../http/fs-server-response-matcher.js';
+import { ServerRouteHandler } from './server-route-handler.js';
+import { createRenderContext } from './render-context.js';
+import { ApiRequestPipeline } from '../http/api-request-pipeline.js';
+import { injectDevToolbarIntoHtmlResponse, shouldInjectDevToolbarHtmlResponse, } from '../../../dev-toolbar/dev-toolbar-html-response.js';
+import { injectHmrRuntimeIntoHtmlResponse, isHtmlResponse, shouldInjectHmrHtmlResponse, } from '../hmr/hmr-html-response.js';
+import { getAppServerModuleTranspiler } from '../../../services/module-loading/app-server-module-transpiler.service.js';
+import { resolveInternalExecutionDir } from '../../../utils/resolve-work-dir.js';
+export class SharedServerAdapter extends AbstractServerAdapter {
+    router;
+    fileSystemResponseMatcher;
+    routeRendererFactory;
+    routeHandler;
+    staticSiteGenerator;
+    staticBuilder;
+    schemaValidator = new SchemaValidationService();
+    apiRequestPipeline = new ApiRequestPipeline({
+        schemaValidator: this.schemaValidator,
+        getRenderContext: () => this.getRenderContext(),
+        getCacheService: () => this.getCacheService(),
     });
-  }
-  createSharedWatchRefreshCallback(options) {
-    return async () => {
-      try {
-        await this.initializeSharedRouteHandling({
-          staticRoutes: options.staticRoutes,
-          hmrManager: options.hmrManager
-        });
-        if (options.onRoutesReady) {
-          await options.onRoutesReady();
-        }
-      } catch (error) {
-        if (options.onError) {
-          await options.onError(error instanceof Error ? error : new Error(String(error)));
-          return;
+    hostOwnsDevClient = false;
+    async initializeSharedRouteHandling(options) {
+        this.ensureRouteRendererFactory();
+        await this.initSharedRouter();
+        this.configureSharedResponseHandlers(options.staticRoutes, options.hmrManager);
+    }
+    ensureRouteRendererFactory() {
+        if (this.routeRendererFactory) {
+            return;
         }
-        throw error;
-      }
-    };
-  }
-  /**
-   * Scans the filesystem and dynamically constructs the Route Registry.
-   *
-   * This process runs identically across both Bun and Node wrappers. It analyzes the configured pages
-   * directory, building a map of all available UI routes and API endpoints.
-   * The resulting `RouteRegistry` instance becomes the central nervous system for mapping WinterCG incoming
-   * Web Requests (`Request`) to their corresponding internal execution paths.
-   */
-  async initSharedRouter() {
-    startupTrace.markPhaseStart("route-registry");
-    this.router = new RouteRegistry({
-      pagesDir: path.join(this.appConfig.rootDir, this.appConfig.srcDir, this.appConfig.pagesDir),
-      appConfig: this.appConfig,
-      origin: this.runtimeOrigin,
-      templatesExt: this.appConfig.templatesExt,
-      buildMode: !this.options?.watch,
-      pageModuleAdapter: this.createRouteRegistryPageModuleAdapter()
-    });
-    await this.router.init();
-    startupTrace.markPhaseEnd("route-registry");
-  }
-  createRouteRegistryPageModuleAdapter() {
-    this.ensureRouteRendererFactory();
-    return {
-      loadPageModule: async (filePath) => {
-        const module = await this.routeRendererFactory.getPageRenderer(filePath).loadPageModule(filePath);
-        const page = module.default;
+        this.routeRendererFactory = new RouteRendererFactory({
+            appConfig: this.appConfig,
+            rendererModules: this.appConfig.runtime?.rendererModuleContext,
+            runtimeOrigin: this.runtimeOrigin,
+        });
+    }
+    createSharedWatchRefreshCallback(options) {
+        return async () => {
+            try {
+                await this.initializeSharedRouteHandling({
+                    staticRoutes: options.staticRoutes,
+                    hmrManager: options.hmrManager,
+                });
+                if (options.onRoutesReady) {
+                    await options.onRoutesReady();
+                }
+            }
+            catch (error) {
+                if (options.onError) {
+                    await options.onError(error instanceof Error ? error : new Error(String(error)));
+                    return;
+                }
+                throw error;
+            }
+        };
+    }
+    /**
+     * Scans the filesystem and dynamically constructs the Route Registry.
+     *
+     * This process runs identically across both Bun and Node wrappers. It analyzes the configured pages
+     * directory, building a map of all available UI routes and API endpoints.
+     * The resulting `RouteRegistry` instance becomes the central nervous system for mapping WinterCG incoming
+     * Web Requests (`Request`) to their corresponding internal execution paths.
+     */
+    async initSharedRouter() {
+        startupTrace.markPhaseStart('route-registry');
+        this.router = new RouteRegistry({
+            pagesDir: path.join(this.appConfig.rootDir, this.appConfig.srcDir, this.appConfig.pagesDir),
+            appConfig: this.appConfig,
+            origin: this.runtimeOrigin,
+            templatesExt: this.appConfig.templatesExt,
+            buildMode: !this.options?.watch,
+            pageModuleAdapter: this.createRouteRegistryPageModuleAdapter(),
+        });
+        await this.router.init();
+        startupTrace.markPhaseEnd('route-registry');
+    }
+    createRouteRegistryPageModuleAdapter() {
+        this.ensureRouteRendererFactory();
         return {
-          staticPaths: page?.staticPaths ?? module.getStaticPaths,
-          staticProps: page?.staticProps ?? module.getStaticProps
+            loadPageModule: async (filePath) => {
+                const module = (await this.routeRendererFactory
+                    .getPageRenderer(filePath)
+                    .loadPageModule(filePath));
+                const page = module.default;
+                return {
+                    staticPaths: page?.staticPaths ?? module.getStaticPaths,
+                    staticProps: page?.staticProps ?? module.getStaticProps,
+                };
+            },
         };
-      }
-    };
-  }
-  /**
-   * Sets up the unified rendering pipeline and response matching chain.
-   *
-   * It bridges several sub-systems together so that when an incoming request is received, the adapter knows:
-   * 1. How to render React/Lit pages via `RouteRendererFactory`
-   * 2. How to match logical routes to physical filesystem artifacts via `FileSystemResponseMatcher`
-   * 3. Whether to serve the response from the embedded `PageCacheService` or generate it fresh on the fly.
-   *
-   * @param staticRoutes - A map of explicitly served static assets.
-   * @param hmrManager - The runtime-specific Hot Module Replacement orchestrator (if watching).
-   */
-  configureSharedResponseHandlers(staticRoutes, hmrManager) {
-    this.ensureRouteRendererFactory();
-    const { fileSystemResponseMatcher, explicitStaticRouteMatcher } = this.createSharedResponseHandlerDependencies(staticRoutes);
-    this.fileSystemResponseMatcher = fileSystemResponseMatcher;
-    this.routeHandler = new ServerRouteHandler({
-      router: this.router,
-      fileSystemResponseMatcher: this.fileSystemResponseMatcher,
-      explicitStaticRouteMatcher,
-      hmrManager
-    });
-  }
-  createSharedResponseHandlerDependencies(staticRoutes) {
-    const fileSystemResponseFactory = new FileSystemServerResponseFactory({
-      options: {
-        watchMode: !!this.options?.watch
-      }
-    });
-    const cacheService = this.createSharedPageCacheService();
-    const fileSystemResponseMatcher = new FileSystemResponseMatcher({
-      appConfig: this.appConfig,
-      assetPrefix: path.join(this.appConfig.rootDir, this.appConfig.distDir),
-      router: this.router,
-      routeRendererFactory: this.routeRendererFactory,
-      fileSystemResponseFactory,
-      cacheService,
-      defaultCacheStrategy: this.appConfig.cache?.defaultStrategy ?? "static"
-    });
-    return {
-      cacheService,
-      fileSystemResponseMatcher,
-      explicitStaticRouteMatcher: staticRoutes.length > 0 ? new ExplicitStaticRouteMatcher({
-        appConfig: this.appConfig,
-        routeRendererFactory: this.routeRendererFactory,
-        staticRoutes
-      }) : void 0
-    };
-  }
-  createSharedPageCacheService() {
-    const cacheConfig = this.appConfig.cache;
-    const isCacheEnabled = cacheConfig?.enabled ?? !this.options?.watch;
-    if (!isCacheEnabled) {
-      return null;
     }
-    const store = cacheConfig?.store === "memory" || !cacheConfig?.store ? new MemoryCacheStore({ maxEntries: cacheConfig?.maxEntries }) : cacheConfig.store;
-    return new PageCacheService({ store, enabled: true });
-  }
-  getCacheService() {
-    return this.fileSystemResponseMatcher?.getCacheService() ?? null;
-  }
-  getRenderContext() {
-    const serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
-    return createRenderContext({
-      integrations: this.appConfig.integrations,
-      rendererModules: this.appConfig.runtime?.rendererModuleContext,
-      importServerModule: async (filePath) => await serverModuleTranspiler.importModule({
-        filePath,
-        outdir: path.join(resolveInternalExecutionDir(this.appConfig), ".server-modules"),
-        externalPackages: true
-      })
-    });
-  }
-  tryHandleSharedHmrRequest(request, context) {
-    return context.hmrManager?.tryHandleAssetRequest(request) ?? null;
-  }
-  async injectSharedHmrHtmlResponse(response, context) {
-    if (shouldInjectHmrHtmlResponse(this.options?.watch ?? false, context.hmrManager, this.hostOwnsDevClient) && isHtmlResponse(response)) {
-      return injectHmrRuntimeIntoHtmlResponse(response);
+    /**
+     * Sets up the unified rendering pipeline and response matching chain.
+     *
+     * It bridges several sub-systems together so that when an incoming request is received, the adapter knows:
+     * 1. How to render React/Lit pages via `RouteRendererFactory`
+     * 2. How to match logical routes to physical filesystem artifacts via `FileSystemResponseMatcher`
+     * 3. Whether to serve the response from the embedded `PageCacheService` or generate it fresh on the fly.
+     *
+     * @param staticRoutes - A map of explicitly served static assets.
+     * @param hmrManager - The runtime-specific Hot Module Replacement orchestrator (if watching).
+     */
+    configureSharedResponseHandlers(staticRoutes, hmrManager) {
+        this.ensureRouteRendererFactory();
+        const { fileSystemResponseMatcher, explicitStaticRouteMatcher } = this.createSharedResponseHandlerDependencies(staticRoutes);
+        this.fileSystemResponseMatcher = fileSystemResponseMatcher;
+        this.routeHandler = new ServerRouteHandler({
+            router: this.router,
+            fileSystemResponseMatcher: this.fileSystemResponseMatcher,
+            explicitStaticRouteMatcher,
+            hmrManager,
+        });
     }
-    return response;
-  }
-  async tryHandleSharedApiRequest(request, context) {
-    return await this.apiRequestPipeline.tryHandle(
-      request,
-      context.apiHandlers,
-      context.serverInstance,
-      context.errorHandler
-    );
-  }
-  /**
-   * Universally processes an incoming WinterCG Web standard Request.
-   *
-   * 1. Resolves static Hot Module Replacement runtime blobs if development.
-   * 2. Checks if the incoming request matches any parsed API route schemas.
-   *   - Routes through `ApiRequestPipeline` which performs strict validation.
-   * 3. Falls through to standard `ServerRouteHandler` for React/Lit filesystem pages.
-   *
-   * Both Bun and Node bindings fall back to this exact function once they have mapped their
-   * native HTTP objects into Web Standard Requests.
-   */
-  async handleSharedRequest(request, context) {
-    return requestBuildDedupe.run(
-      () => startupTrace.traceFirstRequest(request, async () => {
-        const hmrResponse = this.tryHandleSharedHmrRequest(request, context);
-        if (hmrResponse) {
-          return hmrResponse;
+    createSharedResponseHandlerDependencies(staticRoutes) {
+        const fileSystemResponseFactory = new FileSystemServerResponseFactory({
+            options: {
+                watchMode: !!this.options?.watch,
+            },
+        });
+        const cacheService = this.createSharedPageCacheService();
+        const fileSystemResponseMatcher = new FileSystemResponseMatcher({
+            appConfig: this.appConfig,
+            assetPrefix: path.join(this.appConfig.rootDir, this.appConfig.distDir),
+            router: this.router,
+            routeRendererFactory: this.routeRendererFactory,
+            fileSystemResponseFactory,
+            cacheService,
+            defaultCacheStrategy: this.appConfig.cache?.defaultStrategy ?? 'static',
+        });
+        return {
+            cacheService,
+            fileSystemResponseMatcher,
+            explicitStaticRouteMatcher: staticRoutes.length > 0
+                ? new ExplicitStaticRouteMatcher({
+                    appConfig: this.appConfig,
+                    routeRendererFactory: this.routeRendererFactory,
+                    staticRoutes,
+                })
+                : undefined,
+        };
+    }
+    createSharedPageCacheService() {
+        const cacheConfig = this.appConfig.cache;
+        const isCacheEnabled = cacheConfig?.enabled ?? !this.options?.watch;
+        if (!isCacheEnabled) {
+            return null;
+        }
+        const store = cacheConfig?.store === 'memory' || !cacheConfig?.store
+            ? new MemoryCacheStore({ maxEntries: cacheConfig?.maxEntries })
+            : cacheConfig.store;
+        return new PageCacheService({ store, enabled: true });
+    }
+    getCacheService() {
+        return this.fileSystemResponseMatcher?.getCacheService() ?? null;
+    }
+    getRenderContext() {
+        const serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
+        return createRenderContext({
+            integrations: this.appConfig.integrations,
+            rendererModules: this.appConfig.runtime?.rendererModuleContext,
+            importServerModule: async (filePath) => await serverModuleTranspiler.importModule({
+                filePath,
+                outdir: path.join(resolveInternalExecutionDir(this.appConfig), '.server-modules'),
+                externalPackages: true,
+            }),
+        });
+    }
+    async tryHandleSharedDevClientRequest(request, context) {
+        const manager = context.hmrManager;
+        return (await manager?.tryHandleDevClientRequest?.(request)) ?? null;
+    }
+    tryHandleSharedHmrRequest(request, context) {
+        return context.hmrManager?.tryHandleAssetRequest(request) ?? null;
+    }
+    async injectSharedHmrHtmlResponse(response, context) {
+        if (!isHtmlResponse(response)) {
+            return response;
         }
-        const apiResponse = await this.tryHandleSharedApiRequest(request, context);
-        if (apiResponse) {
-          return await this.injectSharedHmrHtmlResponse(apiResponse, context);
+        let nextResponse = response;
+        if (shouldInjectHmrHtmlResponse(this.options?.watch ?? false, context.hmrManager, this.hostOwnsDevClient) &&
+            isHtmlResponse(nextResponse)) {
+            nextResponse = await injectHmrRuntimeIntoHtmlResponse(nextResponse);
         }
-        const routeResponse = await this.routeHandler.handleResponse(request);
-        return await this.injectSharedHmrHtmlResponse(routeResponse, context);
-      })
-    );
-  }
+        if (shouldInjectDevToolbarHtmlResponse(this.appConfig, {
+            watch: this.options?.watch ?? false,
+            hostOwnsDevClient: this.hostOwnsDevClient,
+        })) {
+            nextResponse = await injectDevToolbarIntoHtmlResponse(this.appConfig, {
+                watch: this.options?.watch ?? false,
+                hostOwnsDevClient: this.hostOwnsDevClient,
+            }, nextResponse);
+        }
+        return nextResponse;
+    }
+    async tryHandleSharedApiRequest(request, context) {
+        return await this.apiRequestPipeline.tryHandle(request, context.apiHandlers, context.serverInstance, context.errorHandler);
+    }
+    /**
+     * Universally processes an incoming WinterCG Web standard Request.
+     *
+     * 1. Resolves static Hot Module Replacement runtime blobs if development.
+     * 2. Checks if the incoming request matches any parsed API route schemas.
+     *   - Routes through `ApiRequestPipeline` which performs strict validation.
+     * 3. Falls through to standard `ServerRouteHandler` for React/Lit filesystem pages.
+     *
+     * Both Bun and Node bindings fall back to this exact function once they have mapped their
+     * native HTTP objects into Web Standard Requests.
+     */
+    async handleSharedRequest(request, context) {
+        return requestBuildDedupe.run(() => startupTrace.traceFirstRequest(request, async () => {
+            const devClientResponse = await this.tryHandleSharedDevClientRequest(request, context);
+            if (devClientResponse) {
+                return devClientResponse;
+            }
+            const hmrResponse = this.tryHandleSharedHmrRequest(request, context);
+            if (hmrResponse) {
+                return hmrResponse;
+            }
+            const apiResponse = await this.tryHandleSharedApiRequest(request, context);
+            if (apiResponse) {
+                return await this.injectSharedHmrHtmlResponse(apiResponse, context);
+            }
+            const routeResponse = await this.routeHandler.handleResponse(request);
+            return await this.injectSharedHmrHtmlResponse(routeResponse, context);
+        }));
+    }
 }
-export {
-  SharedServerAdapter
-};

package/src/adapters/shared/runtime/server-route-handler.js

@@ -1,73 +1,77 @@
-import { appLogger } from "../../../global/app-logger.js";
-import { HttpError } from "../../../errors/http-error.js";
-class ServerRouteHandler {
-  router;
-  fileSystemResponseMatcher;
-  explicitStaticRouteMatcher;
-  hmrManager;
-  /**
-   * Creates a new ServerRouteHandler instance.
-   *
-   * @param params - Configuration parameters
-   */
-  constructor({
-    router,
-    fileSystemResponseMatcher,
-    explicitStaticRouteMatcher,
-    hmrManager
-  }) {
-    this.router = router;
-    this.fileSystemResponseMatcher = fileSystemResponseMatcher;
-    this.explicitStaticRouteMatcher = explicitStaticRouteMatcher;
-    this.hmrManager = hmrManager;
-  }
-  /**
-   * Handles HTTP requests from the router adapter.
-   *
-   * Priority-based routing flow:
-   * 1. Check explicit static routes first (e.g., /sitemap.xml, /image.webp from plugins)
-   * 2. Match file-based routes without extensions (application routes)
-   * 3. Fall back to static file serving from disk
-   *
-   * @param request - The incoming HTTP request
-   * @returns HTTP response for the matched route
-   */
-  async handleResponse(request) {
-    const pathname = new URL(request.url).pathname;
-    const explicitMatch = this.explicitStaticRouteMatcher?.match(request.url);
-    if (explicitMatch) {
-      return await this.explicitStaticRouteMatcher.handleMatch(explicitMatch);
+import { appLogger } from '../../../global/app-logger.js';
+import { HttpError } from '../../../errors/http-error.js';
+/**
+ * Handles HTTP requests and routing for the server.
+ *
+ * This class manages the request routing flow with a priority-based approach:
+ * 1. Explicit static routes (highest priority - intentional mappings like /sitemap.xml)
+ * 2. File-based routes without extensions (application routes)
+ * 3. Static file fallback (lowest priority - disk serving)
+ *
+ */
+export class ServerRouteHandler {
+    router;
+    fileSystemResponseMatcher;
+    explicitStaticRouteMatcher;
+    hmrManager;
+    /**
+     * Creates a new ServerRouteHandler instance.
+     *
+     * @param params - Configuration parameters
+     */
+    constructor({ router, fileSystemResponseMatcher, explicitStaticRouteMatcher, hmrManager, }) {
+        this.router = router;
+        this.fileSystemResponseMatcher = fileSystemResponseMatcher;
+        this.explicitStaticRouteMatcher = explicitStaticRouteMatcher;
+        this.hmrManager = hmrManager;
     }
-    const fsMatch = !pathname.includes(".") && this.router.matchRequest(request.url);
-    return await (fsMatch ? this.fileSystemResponseMatcher.handleMatch(fsMatch, request) : this.handleNoMatch(request));
-  }
-  /**
-   * Handles requests that do not match any routes.
-   *
-   * This is the final fallback that attempts to serve static files from disk.
-   * If the requested path corresponds to an HTML file or no file is found,
-   * a custom 404 response is returned.
-   *
-   * @param request - The HTTP request to handle
-   * @returns Response from file system or error response
-   * @throws HttpError for standard HTTP errors
-   */
-  async handleNoMatch(request) {
-    try {
-      const pathname = new URL(request.url).pathname;
-      return await this.fileSystemResponseMatcher.handleNoMatch(pathname);
-    } catch (error) {
-      if (error instanceof HttpError) {
-        return error.toResponse();
-      }
-      if (error instanceof Error) {
-        this.hmrManager?.broadcast({ type: "error", message: error.message });
-        appLogger.error("Error handling no match:", error);
-      }
-      return new Response("Internal Server Error", { status: 500 });
+    /**
+     * Handles HTTP requests from the router adapter.
+     *
+     * Priority-based routing flow:
+     * 1. Check explicit static routes first (e.g., /sitemap.xml, /image.webp from plugins)
+     * 2. Match file-based routes without extensions (application routes)
+     * 3. Fall back to static file serving from disk
+     *
+     * @param request - The incoming HTTP request
+     * @returns HTTP response for the matched route
+     */
+    async handleResponse(request) {
+        const pathname = new URL(request.url).pathname;
+        const explicitMatch = this.explicitStaticRouteMatcher?.match(request.url);
+        if (explicitMatch) {
+            return await this.explicitStaticRouteMatcher.handleMatch(explicitMatch);
+        }
+        const fsMatch = !pathname.includes('.') && this.router.matchRequest(request.url);
+        return await (fsMatch
+            ? this.fileSystemResponseMatcher.handleMatch(fsMatch, request)
+            : this.handleNoMatch(request));
+    }
+    /**
+     * Handles requests that do not match any routes.
+     *
+     * This is the final fallback that attempts to serve static files from disk.
+     * If the requested path corresponds to an HTML file or no file is found,
+     * a custom 404 response is returned.
+     *
+     * @param request - The HTTP request to handle
+     * @returns Response from file system or error response
+     * @throws HttpError for standard HTTP errors
+     */
+    async handleNoMatch(request) {
+        try {
+            const pathname = new URL(request.url).pathname;
+            return await this.fileSystemResponseMatcher.handleNoMatch(pathname);
+        }
+        catch (error) {
+            if (error instanceof HttpError) {
+                return error.toResponse();
+            }
+            if (error instanceof Error) {
+                this.hmrManager?.broadcast({ type: 'error', message: error.message });
+                appLogger.error('Error handling no match:', error);
+            }
+            return new Response('Internal Server Error', { status: 500 });
+        }
     }
-  }
 }
-export {
-  ServerRouteHandler
-};