@ecopages/core 0.2.0-alpha.54 → 0.2.0-alpha.55

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

@@ -1,130 +0,0 @@
-import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { afterEach, test } from 'vitest';
-import { ConfigBuilder } from '../../config/config-builder.ts';
-import type { ServerAdapterResult } from '../abstract/server-adapter.ts';
-import type { ApiHandler } from '../../types/public-types.ts';
-import { SharedServerAdapter } from './server-adapter.ts';
-
-const tempRoots: string[] = [];
-
-function createTempRoot(prefix: string): string {
-	const root = fs.mkdtempSync(path.join(os.tmpdir(), `${prefix}-`));
-	tempRoots.push(root);
-	return root;
-}
-
-afterEach(() => {
-	for (const root of tempRoots.splice(0)) {
-		fs.rmSync(root, { recursive: true, force: true });
-	}
-});
-
-class TestSharedServerAdapter extends SharedServerAdapter<any, ServerAdapterResult> {
-	public async initialize(): Promise<void> {}
-	public getServerOptions(): Record<string, never> {
-		return {};
-	}
-	public async buildStatic(): Promise<void> {}
-	public async createAdapter(): Promise<ServerAdapterResult> {
-		return {
-			getServerOptions: () => ({}),
-			buildStatic: async () => {},
-		};
-	}
-	public async handleRequest(request: Request): Promise<Response> {
-		return await this.handleSharedRequest(request, {
-			apiHandlers: [],
-			hmrManager: {
-				getRuntimePath: () => '',
-				getDistDir: () => this.hmrDir,
-			},
-		});
-	}
-
-	public async handleSharedRequestForTest(request: Request, apiHandlers: ApiHandler[]): Promise<Response> {
-		return await this.handleSharedRequest(request, {
-			apiHandlers,
-		});
-	}
-
-	public setRouteHandlerForTest(handleResponse: (request: Request) => Promise<Response>): void {
-		this.routeHandler = {
-			handleResponse,
-		} as any;
-	}
-
-	constructor(
-		private readonly hmrDir: string,
-		rootDir: string,
-	) {
-		super({
-			appConfig: { rootDir } as any,
-			runtimeOrigin: 'http://localhost:3000',
-			serveOptions: {},
-			options: {},
-		});
-	}
-}
-
-test('SharedServerAdapter serves /assets/_hmr files from the HMR manager directory', async () => {
-	const rootDir = createTempRoot('ecopages-shared-server-hmr-assets');
-	const config = await new ConfigBuilder().setRootDir(rootDir).build();
-	const hmrDir = path.join(config.absolutePaths.workDir, 'assets', '_hmr');
-	const assetPath = path.join(hmrDir, 'pages', 'react-content.js');
-	fs.mkdirSync(path.dirname(assetPath), { recursive: true });
-	fs.writeFileSync(assetPath, 'export default 1;', 'utf8');
-
-	const adapter = new TestSharedServerAdapter(hmrDir, rootDir);
-	const response = await adapter.handleRequest(new Request('http://localhost/assets/_hmr/pages/react-content.js'));
-
-	assert.equal(response.status, 200);
-	assert.equal(response.headers.get('Content-Type'), 'application/javascript');
-	assert.equal(await response.text(), 'export default 1;');
-	assert.equal(
-		fs.existsSync(path.join(config.absolutePaths.distDir, 'assets', '_hmr', 'pages', 'react-content.js')),
-		false,
-	);
-});
-
-test('SharedServerAdapter dispatches matching API handlers before filesystem routes', async () => {
-	const rootDir = createTempRoot('ecopages-shared-server-api-dispatch');
-	const adapter = new TestSharedServerAdapter('', rootDir);
-	adapter.setRouteHandlerForTest(async () => new Response('filesystem'));
-
-	const response = await adapter.handleSharedRequestForTest(
-		new Request('http://localhost/api/posts/123', { method: 'GET' }),
-		[
-			{
-				path: '/api/posts/[id]',
-				method: 'GET',
-				handler: ({ params }) => new Response(`api:${params.id}`),
-			},
-		],
-	);
-
-	assert.equal(response.status, 200);
-	assert.equal(await response.text(), 'api:123');
-});
-
-test('SharedServerAdapter falls back to the route handler when no API handler matches', async () => {
-	const rootDir = createTempRoot('ecopages-shared-server-route-fallback');
-	const adapter = new TestSharedServerAdapter('', rootDir);
-	adapter.setRouteHandlerForTest(async () => new Response('filesystem'));
-
-	const response = await adapter.handleSharedRequestForTest(
-		new Request('http://localhost/blog/post-1', { method: 'GET' }),
-		[
-			{
-				path: '/api/posts/[id]',
-				method: 'GET',
-				handler: () => new Response('api'),
-			},
-		],
-	);
-
-	assert.equal(response.status, 200);
-	assert.equal(await response.text(), 'filesystem');
-});

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

@@ -1,571 +0,0 @@
-import path from 'node:path';
-import { AbstractServerAdapter } from '../abstract/server-adapter.ts';
-import type { ServerAdapterOptions, ServerAdapterResult } from '../abstract/server-adapter.ts';
-import { RouteRendererFactory } from '../../route-renderer/route-renderer.ts';
-import { RouteRegistry } from '../../router/server/route-registry.ts';
-import { MemoryCacheStore } from '../../services/cache/memory-cache-store.ts';
-import { PageCacheService } from '../../services/cache/page-cache-service.ts';
-import { SchemaValidationService } from '../../services/validation/schema-validation-service.ts';
-import { StaticSiteGenerator } from '../../static-site-generator/static-site-generator.ts';
-import { ServerStaticBuilder } from './server-static-builder.ts';
-import { ExplicitStaticRouteMatcher } from './explicit-static-route-matcher.ts';
-import { FileSystemServerResponseFactory } from './fs-server-response-factory.ts';
-import { FileSystemResponseMatcher } from './fs-server-response-matcher.ts';
-import { ServerRouteHandler } from './server-route-handler.ts';
-import { createRenderContext } from './render-context.ts';
-import { createRequire } from '../../utils/locals-utils.ts';
-import { HttpError } from '../../errors/http-error.ts';
-import { ApiResponseBuilder } from './api-response.ts';
-import { appLogger } from '../../global/app-logger.ts';
-import { fileSystem } from '@ecopages/file-system';
-import type { EcoPageFile } from '../../types/public-types.ts';
-import { getAppServerModuleTranspiler } from '../../services/module-loading/app-server-module-transpiler.service.ts';
-import { resolveInternalExecutionDir } from '../../utils/resolve-work-dir.ts';
-import type { RouteRegistryPageModuleAdapter } from '../../router/server/route-registry.ts';
-import type {
-	ApiHandler,
-	ApiHandlerContext,
-	CacheInvalidator,
-	ErrorHandler,
-	RenderContext,
-	StaticRoute,
-} from '../../types/public-types.ts';
-
-type SharedResponseHandlerDependencies = {
-	cacheService: PageCacheService | null;
-	fileSystemResponseMatcher: FileSystemResponseMatcher;
-	explicitStaticRouteMatcher?: ExplicitStaticRouteMatcher;
-};
-
-type SharedRequestContext = {
-	apiHandlers: ApiHandler[];
-	errorHandler?: ErrorHandler;
-	serverInstance?: any;
-	hmrManager?: any;
-};
-
-export abstract class SharedServerAdapter<
-	TOptions extends ServerAdapterOptions,
-	TResult extends ServerAdapterResult,
-> extends AbstractServerAdapter<TOptions, TResult> {
-	protected router!: RouteRegistry;
-	protected fileSystemResponseMatcher!: FileSystemResponseMatcher;
-	protected routeRendererFactory!: RouteRendererFactory;
-	protected routeHandler!: ServerRouteHandler;
-	protected staticSiteGenerator!: StaticSiteGenerator;
-	protected staticBuilder!: ServerStaticBuilder;
-	protected readonly schemaValidator = new SchemaValidationService();
-
-	protected async initializeSharedRouteHandling(options: {
-		staticRoutes: StaticRoute[];
-		hmrManager?: any;
-	}): Promise<void> {
-		await this.initSharedRouter();
-		this.configureSharedResponseHandlers(options.staticRoutes, options.hmrManager);
-	}
-
-	protected createSharedWatchRefreshCallback(options: {
-		staticRoutes: StaticRoute[];
-		hmrManager?: any;
-		onRoutesReady?: () => Promise<void> | void;
-		onError?: (error: Error) => Promise<void> | void;
-	}): () => Promise<void> {
-		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.
-	 */
-	protected async initSharedRouter(): Promise<void> {
-		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();
-	}
-
-	private createRouteRegistryPageModuleAdapter(): RouteRegistryPageModuleAdapter {
-		const serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
-
-		return {
-			loadPageModule: async (filePath) => {
-				const module = (await serverModuleTranspiler.importModule({
-					filePath,
-					outdir: path.join(resolveInternalExecutionDir(this.appConfig), '.server-route-modules'),
-					externalPackages: false,
-					transpileErrorMessage: (details) => `Error transpiling route module: ${details}`,
-					noOutputMessage: (targetFilePath) =>
-						`No transpiled output generated for route module: ${targetFilePath}`,
-				})) as EcoPageFile;
-
-				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.
-	 *
-	 * Because `HmrManager` implementations rely heavily on runtime-specific WebSocket APIs (e.g. Bun.serve Websockets vs Node WS),
-	 * we leave it untyped (`any`) here at the common denominator core.
-	 *
-	 * @param staticRoutes - A map of explicitly served static assets.
-	 * @param hmrManager - The runtime-specific Hot Module Replacement orchestrator (if watching).
-	 */
-	protected configureSharedResponseHandlers(staticRoutes: StaticRoute[], hmrManager?: any): void {
-		this.routeRendererFactory = new RouteRendererFactory({
-			appConfig: this.appConfig,
-			rendererModules: this.appConfig.runtime?.rendererModuleContext,
-			runtimeOrigin: this.runtimeOrigin,
-		});
-
-		const { fileSystemResponseMatcher, explicitStaticRouteMatcher } =
-			this.createSharedResponseHandlerDependencies(staticRoutes);
-
-		this.fileSystemResponseMatcher = fileSystemResponseMatcher;
-		this.routeHandler = new ServerRouteHandler({
-			router: this.router,
-			fileSystemResponseMatcher: this.fileSystemResponseMatcher,
-			explicitStaticRouteMatcher,
-			watch: !!this.options?.watch,
-			hmrManager,
-		});
-	}
-
-	private createSharedResponseHandlerDependencies(staticRoutes: StaticRoute[]): SharedResponseHandlerDependencies {
-		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,
-		};
-	}
-
-	private createSharedPageCacheService(): PageCacheService | null {
-		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 });
-	}
-
-	protected getCacheService(): CacheInvalidator | null {
-		return this.fileSystemResponseMatcher?.getCacheService() ?? null;
-	}
-
-	protected getRenderContext(): RenderContext {
-		const serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
-
-		return createRenderContext({
-			integrations: this.appConfig.integrations,
-			rendererModules: this.appConfig.runtime?.rendererModuleContext,
-			importServerModule: async <T = unknown>(filePath: string) =>
-				await serverModuleTranspiler.importModule<T>({
-					filePath,
-					outdir: path.join(resolveInternalExecutionDir(this.appConfig), '.server-modules'),
-					externalPackages: true,
-					bypassCache: this.options?.watch === true,
-				}),
-		});
-	}
-
-	/**
-	 * Executes an Application Programming Interface (API) handler in an environment-agnostic manner.
-	 *
-	 * API routes in Ecopages are universally written using standard WinterCG `Request` and `Response` objects.
-	 * This execution pipeline takes the raw `Request`, extracts its dynamic segments, runs our high-speed JSON schema
-	 * validator against the body/query/headers, and triggers the developer's middleware chain sequentially.
-	 *
-	 * If the execution throws an error, it is gracefully caught, logged, and mutated into a standardized Http error payload,
-	 * ensuring the consuming client receives a parsable response even upon internal catastrophic failure.
-	 *
-	 * @param request - The incoming Web standard `Request`.
-	 * @param params - The extracted dynamic URL parameters (e.g., `{ id: '123' }`).
-	 * @param routeConfig - The user-defined API handler object containing their business logic (`handler`) and `middleware`.
-	 * @param serverInstance - Untyped reference to the underlying native server instance (BunServer/NodeServer) for potential escape hatches.
-	 * @param errorHandler - Optional global error trap defined in project configuration.
-	 * @returns The resulting Web standard `Response` constructed by the user's handler.
-	 */
-	protected async executeApiHandler(
-		request: Request,
-		params: Record<string, string | string[]>,
-		routeConfig: ApiHandler,
-		serverInstance: any,
-		errorHandler?: ErrorHandler,
-	): Promise<Response> {
-		let context: ApiHandlerContext<Request, any> | undefined;
-
-		try {
-			context = this.createApiHandlerContext(request, params, serverInstance);
-			const schemaResponse = await this.applyApiRequestSchema(context, routeConfig.schema);
-			if (schemaResponse) {
-				return schemaResponse;
-			}
-
-			return await this.runApiMiddlewareChain(context, routeConfig);
-		} catch (error) {
-			if (error instanceof Response) return error;
-
-			if (errorHandler) {
-				try {
-					if (!context) {
-						context = this.createApiHandlerContext(request, params, serverInstance);
-					}
-					return await errorHandler(error, context);
-				} catch (handlerError) {
-					appLogger.error(`[ecopages] Error in custom error handler: ${handlerError}`);
-				}
-			}
-
-			if (error instanceof HttpError) return error.toResponse();
-			appLogger.error(`[ecopages] Error handling API request: ${error}`);
-			return new Response('Internal Server Error', { status: 500 });
-		}
-	}
-
-	private createApiHandlerContext(
-		request: Request,
-		params: Record<string, string | string[]>,
-		serverInstance: any,
-	): ApiHandlerContext<Request, any> {
-		const locals: Record<string, unknown> = {};
-		const normalizedParams = this.normalizeApiParams(params);
-
-		return {
-			request,
-			params: normalizedParams,
-			response: new ApiResponseBuilder(),
-			server: serverInstance,
-			locals,
-			require: createRequire((): Record<string, unknown> => locals),
-			services: {
-				cache: this.getCacheService(),
-			},
-			...this.getRenderContext(),
-		};
-	}
-
-	private normalizeApiParams(params: Record<string, string | string[]>): Record<string, string> {
-		return Object.fromEntries(
-			Object.entries(params).map(([key, value]) => [key, Array.isArray(value) ? value.join('/') : value]),
-		);
-	}
-
-	private async applyApiRequestSchema(
-		context: ApiHandlerContext<Request, any>,
-		schema: ApiHandler['schema'],
-	): Promise<Response | undefined> {
-		if (!schema) {
-			return undefined;
-		}
-
-		const url = new URL(context.request.url);
-		const queryParams = Object.fromEntries(url.searchParams);
-		const headers = Object.fromEntries(context.request.headers);
-
-		let body: unknown;
-		if (schema.body) {
-			try {
-				const contentType = context.request.headers.get('Content-Type') || '';
-				if (contentType.includes('application/json')) body = await context.request.clone().json();
-				else if (contentType.includes('text/plain')) body = await context.request.clone().text();
-			} catch {
-				return context.response.status(400).json({ error: 'Invalid request body' });
-			}
-		}
-
-		const validationResult = await this.schemaValidator.validateRequest(
-			{ body, query: queryParams, headers, params: context.params },
-			schema,
-		);
-
-		if (!validationResult.success) {
-			return context.response.status(400).json({
-				error: 'Validation failed',
-				issues: validationResult.errors,
-			});
-		}
-
-		const validated = validationResult.data!;
-		if (validated.body !== undefined) context.body = validated.body;
-		if (validated.query !== undefined) context.query = validated.query;
-		if (validated.headers !== undefined) context.headers = validated.headers;
-		if (validated.params !== undefined) context.params = validated.params as Record<string, string>;
-		return undefined;
-	}
-
-	private async runApiMiddlewareChain(
-		context: ApiHandlerContext<Request, any>,
-		routeConfig: ApiHandler,
-	): Promise<Response> {
-		const middleware = routeConfig.middleware || [];
-		if (middleware.length === 0) {
-			return await routeConfig.handler(context);
-		}
-
-		let index = 0;
-		const executeNext = async (): Promise<Response> => {
-			if (index < middleware.length) {
-				const currentMiddleware = middleware[index++];
-				return await currentMiddleware(context, executeNext);
-			}
-			return await routeConfig.handler(context);
-		};
-
-		return await executeNext();
-	}
-
-	private normalizePath(pathname: string): string {
-		if (pathname.length > 1 && pathname.endsWith('/')) {
-			return pathname.slice(0, -1);
-		}
-
-		return pathname;
-	}
-
-	private matchApiPath(pattern: string, pathname: string): Record<string, string | string[]> | null {
-		const normalizedPattern = this.normalizePath(pattern);
-		const normalizedPathname = this.normalizePath(pathname);
-
-		const patternSegments = normalizedPattern.split('/').filter(Boolean);
-		const pathSegments = normalizedPathname.split('/').filter(Boolean);
-		const params: Record<string, string | string[]> = {};
-
-		let patternIndex = 0;
-		let pathIndex = 0;
-
-		while (patternIndex < patternSegments.length && pathIndex < pathSegments.length) {
-			const patternSegment = patternSegments[patternIndex];
-			const pathSegment = pathSegments[pathIndex];
-
-			if (patternSegment === '*') {
-				return params;
-			}
-
-			if (patternSegment.startsWith('[...') && patternSegment.endsWith(']')) {
-				const paramName = patternSegment.slice(4, -1);
-				params[paramName] = pathSegments.slice(pathIndex);
-				return params;
-			}
-
-			if (patternSegment.startsWith(':')) {
-				params[patternSegment.slice(1)] = pathSegment;
-				patternIndex++;
-				pathIndex++;
-				continue;
-			}
-
-			if (patternSegment.startsWith('[') && patternSegment.endsWith(']')) {
-				params[patternSegment.slice(1, -1)] = pathSegment;
-				patternIndex++;
-				pathIndex++;
-				continue;
-			}
-
-			if (patternSegment !== pathSegment) {
-				return null;
-			}
-
-			patternIndex++;
-			pathIndex++;
-		}
-
-		if (patternIndex < patternSegments.length) {
-			const remaining = patternSegments.slice(patternIndex);
-			const catchAll = remaining[0];
-
-			if (
-				remaining.length === 1 &&
-				(catchAll === '*' || (catchAll.startsWith('[...') && catchAll.endsWith(']')))
-			) {
-				if (catchAll.startsWith('[...')) {
-					const paramName = catchAll.slice(4, -1);
-					params[paramName] = [];
-				}
-				return params;
-			}
-
-			return null;
-		}
-
-		if (pathIndex < pathSegments.length) {
-			return null;
-		}
-
-		return params;
-	}
-
-	private getApiPathScore(pattern: string): number {
-		const segments = this.normalizePath(pattern).split('/').filter(Boolean);
-		let score = 0;
-		for (const segment of segments) {
-			if (segment === '*' || (segment.startsWith('[...') && segment.endsWith(']'))) {
-				score += 10;
-			} else if (segment.startsWith(':') || (segment.startsWith('[') && segment.endsWith(']'))) {
-				score += 50;
-			} else {
-				score += 100;
-			}
-		}
-		return score;
-	}
-
-	protected matchApiHandler(
-		request: Request,
-		apiHandlers: ApiHandler[],
-	): { routeConfig: ApiHandler; params: Record<string, string | string[]> } | null {
-		const pathname = new URL(request.url).pathname;
-		const method = request.method.toUpperCase();
-
-		const sortedHandlers = [...apiHandlers].sort((a, b) => {
-			return this.getApiPathScore(b.path) - this.getApiPathScore(a.path);
-		});
-
-		for (const routeConfig of sortedHandlers) {
-			const routeMethod = (routeConfig.method || 'GET').toUpperCase();
-			if (routeMethod !== method) {
-				continue;
-			}
-
-			const params = this.matchApiPath(routeConfig.path, pathname);
-			if (params) {
-				return { routeConfig, params };
-			}
-		}
-
-		return null;
-	}
-
-	private tryHandleSharedHmrRequest(request: Request, context: SharedRequestContext): Response | null {
-		const url = new URL(request.url);
-
-		if (url.pathname === '/_hmr_runtime.js' && context.hmrManager) {
-			const runtimePath = context.hmrManager.getRuntimePath();
-			if (fileSystem.exists(runtimePath)) {
-				return new Response(fileSystem.readFileAsBuffer(runtimePath) as BodyInit, {
-					headers: { 'Content-Type': 'application/javascript' },
-				});
-			}
-		}
-
-		if (url.pathname.startsWith('/assets/_hmr/') && context.hmrManager) {
-			const relativePath = url.pathname.slice('/assets/_hmr/'.length);
-			const assetPath = path.join(context.hmrManager.getDistDir(), relativePath);
-
-			if (fileSystem.exists(assetPath)) {
-				return new Response(fileSystem.readFileAsBuffer(assetPath) as BodyInit, {
-					headers: { 'Content-Type': 'application/javascript' },
-				});
-			}
-		}
-
-		return null;
-	}
-
-	private async tryHandleSharedApiRequest(request: Request, context: SharedRequestContext): Promise<Response | null> {
-		const apiMatch = this.matchApiHandler(request, context.apiHandlers);
-		if (!apiMatch) {
-			return null;
-		}
-
-		return await this.executeApiHandler(
-			request,
-			apiMatch.params,
-			apiMatch.routeConfig,
-			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 `executeApiHandler` 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.
-	 */
-	public async handleSharedRequest(request: Request, context: SharedRequestContext): Promise<Response> {
-		const hmrResponse = this.tryHandleSharedHmrRequest(request, context);
-		if (hmrResponse) {
-			return hmrResponse;
-		}
-
-		const apiResponse = await this.tryHandleSharedApiRequest(request, context);
-		if (apiResponse) {
-			return apiResponse;
-		}
-
-		return this.routeHandler.handleResponse(request);
-	}
-}