@ecopages/core 0.2.0-alpha.1 → 0.2.0-alpha.10

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

@@ -1,179 +0,0 @@
-import { createServer, type IncomingMessage, type Server as NodeServerInstance, type ServerResponse } from 'node:http';
-import { Readable } from 'node:stream';
-import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from '../../constants.ts';
-import { appLogger } from '../../global/app-logger.ts';
-import type { EcoPagesAppConfig } from '../../internal-types.ts';
-import type { StaticRoute } from '../../public-types.ts';
-import { type ApplicationAdapterOptions } from '../abstract/application-adapter.ts';
-import { SharedApplicationAdapter } from '../shared/application-adapter.ts';
-import { type NodeServerAdapterResult, createNodeServerAdapter } from './server-adapter.ts';
-
-export interface EcopagesAppOptions extends ApplicationAdapterOptions {
-	appConfig: EcoPagesAppConfig;
-	serverOptions?: Record<string, any>;
-}
-
-export class EcopagesApp extends SharedApplicationAdapter<EcopagesAppOptions, NodeServerInstance, Request> {
-	serverAdapter: NodeServerAdapterResult | undefined;
-	private server: NodeServerInstance | null = null;
-	private runtimeOrigin = '';
-
-	public async stop(force = true): Promise<void> {
-		if (!this.server) {
-			return;
-		}
-
-		const activeServer = this.server;
-		this.server = null;
-
-		await new Promise<void>((resolve, reject) => {
-			activeServer.close((error) => {
-				if (error) {
-					reject(error);
-					return;
-				}
-
-				resolve();
-			});
-
-			if (force) {
-				activeServer.closeAllConnections();
-			}
-		});
-	}
-
-	protected async initializeServerAdapter(): Promise<NodeServerAdapterResult> {
-		const { dev } = this.cliArgs;
-		const { port: cliPort, hostname: cliHostname } = this.cliArgs;
-
-		const envPort = process.env.ECOPAGES_PORT;
-		const envHostname = process.env.ECOPAGES_HOSTNAME;
-
-		const preferredPort = cliPort ?? (envPort ? Number(envPort) : undefined) ?? DEFAULT_ECOPAGES_PORT;
-		const preferredHostname = cliHostname ?? envHostname ?? DEFAULT_ECOPAGES_HOSTNAME;
-		this.runtimeOrigin = `http://${preferredHostname}:${preferredPort}`;
-
-		return createNodeServerAdapter({
-			runtimeOrigin: this.runtimeOrigin,
-			appConfig: this.appConfig,
-			apiHandlers: this.apiHandlers,
-			staticRoutes: this.staticRoutes as StaticRoute[],
-			errorHandler: this.errorHandler,
-			options: { watch: dev },
-			serveOptions: {
-				port: preferredPort,
-				hostname: preferredHostname,
-				...this.serverOptions,
-			},
-		});
-	}
-
-	public async start(): Promise<NodeServerInstance | void> {
-		if (!this.serverAdapter) {
-			this.serverAdapter = await this.initializeServerAdapter();
-		}
-
-		if (this.server) {
-			return this.server;
-		}
-
-		const { build, preview } = this.cliArgs;
-
-		if (build || preview) {
-			appLogger.debugTime('Building static pages');
-			await this.serverAdapter.buildStatic({ preview });
-			await this.stop(true);
-			appLogger.debugTimeEnd('Building static pages');
-
-			if (build) {
-				process.exit(0);
-			}
-			return;
-		}
-
-		const serveOptions = this.serverAdapter.getServerOptions();
-		const hostname = String(serveOptions.hostname ?? DEFAULT_ECOPAGES_HOSTNAME);
-		const port = Number(serveOptions.port ?? DEFAULT_ECOPAGES_PORT);
-		this.runtimeOrigin = `http://${hostname}:${port}`;
-
-		this.server = createServer(async (req, res) => {
-			try {
-				const webRequest = this.createWebRequest(req);
-				const response = await this.serverAdapter!.handleRequest(webRequest);
-				await this.sendNodeResponse(res, response);
-			} catch (error) {
-				appLogger.error('Node server adapter request failed', error as Error);
-				res.statusCode = 500;
-				res.end('Internal Server Error');
-			}
-		});
-
-		await new Promise<void>((resolve) => {
-			this.server!.listen(port, hostname, () => resolve());
-		});
-
-		await this.serverAdapter.completeInitialization(this.server);
-		appLogger.info(`Node server running at ${this.runtimeOrigin}`);
-
-		return this.server;
-	}
-
-	private createWebRequest(req: IncomingMessage): Request {
-		const url = new URL(req.url ?? '/', this.runtimeOrigin);
-		const headers = new Headers();
-
-		for (const [key, value] of Object.entries(req.headers)) {
-			if (Array.isArray(value)) {
-				for (const item of value) {
-					headers.append(key, item);
-				}
-				continue;
-			}
-
-			if (value !== undefined) {
-				headers.set(key, value);
-			}
-		}
-
-		const method = (req.method ?? 'GET').toUpperCase();
-		const requestInit: RequestInit & { duplex?: 'half' } = {
-			method,
-			headers,
-		};
-
-		if (method !== 'GET' && method !== 'HEAD') {
-			requestInit.body = Readable.toWeb(req) as unknown as BodyInit;
-			requestInit.duplex = 'half';
-		}
-
-		return new Request(url, requestInit);
-	}
-
-	private async sendNodeResponse(res: ServerResponse, response: Response): Promise<void> {
-		res.statusCode = response.status;
-
-		response.headers.forEach((value, key) => {
-			res.setHeader(key, value);
-		});
-
-		if (!response.body) {
-			res.end();
-			return;
-		}
-
-		const body = Buffer.from(await response.arrayBuffer());
-		res.end(body);
-	}
-
-	public async fetch(request: Request): Promise<Response> {
-		if (!this.serverAdapter) {
-			this.serverAdapter = await this.initializeServerAdapter();
-		}
-
-		return this.serverAdapter.handleRequest(request);
-	}
-}
-
-export async function createNodeApp(options: EcopagesAppOptions): Promise<EcopagesApp> {
-	return new EcopagesApp(options);
-}

package/src/adapters/node/index.ts

@@ -1,9 +0,0 @@
-export { NodeServerAdapter, createNodeServerAdapter } from './server-adapter.ts';
-export { EcopagesApp, createNodeApp } from './create-app.ts';
-export type { EcopagesAppOptions } from './create-app.ts';
-export type {
-	NodeServerAdapterParams,
-	NodeServerAdapterResult,
-	NodeServerInstance,
-	NodeServeAdapterServerOptions,
-} from './server-adapter.ts';

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

@@ -1,79 +0,0 @@
-import type { WebSocket } from 'ws';
-import type { ClientBridgeEvent, IClientBridge } from '../../public-types.ts';
-
-const HEARTBEAT_INTERVAL_MS = 30_000;
-
-export class NodeClientBridge implements IClientBridge {
-	private subscribers = new Set<WebSocket>();
-	private heartbeatTimer: ReturnType<typeof setInterval> | null = null;
-
-	constructor() {
-		this.heartbeatTimer = setInterval(() => this.sweep(), HEARTBEAT_INTERVAL_MS);
-		/* Allow the process to exit even if the timer is still active */
-		this.heartbeatTimer.unref?.();
-	}
-
-	/**
-	 * Pings all open subscribers and removes any that are no longer in OPEN state.
-	 * This prevents a slow memory leak caused by zombie connections that never
-	 * send a close event (e.g. abruptly killed browsers, orphaned tabs, network drops).
-	 */
-	private sweep(): void {
-		for (const ws of this.subscribers) {
-			if (ws.readyState !== 1 /* OPEN */) {
-				this.subscribers.delete(ws);
-				continue;
-			}
-			ws.ping();
-		}
-	}
-
-	subscribe(ws: WebSocket): void {
-		this.subscribers.add(ws);
-	}
-
-	unsubscribe(ws: WebSocket): void {
-		this.subscribers.delete(ws);
-	}
-
-	broadcast(event: ClientBridgeEvent): void {
-		const payload = JSON.stringify(event);
-		for (const ws of this.subscribers) {
-			if (ws.readyState === 1) {
-				ws.send(payload);
-			}
-		}
-	}
-
-	reload(): void {
-		this.broadcast({ type: 'reload' });
-	}
-
-	cssUpdate(path: string): void {
-		this.broadcast({ type: 'css-update', path, timestamp: Date.now() });
-	}
-
-	update(path: string): void {
-		this.broadcast({ type: 'update', path, timestamp: Date.now() });
-	}
-
-	error(message: string): void {
-		this.broadcast({ type: 'error', message });
-	}
-
-	get subscriberCount(): number {
-		return this.subscribers.size;
-	}
-
-	/**
-	 * Stops the heartbeat timer and clears all subscribers.
-	 * Call this when the dev server is shutting down.
-	 */
-	destroy(): void {
-		if (this.heartbeatTimer !== null) {
-			clearInterval(this.heartbeatTimer);
-			this.heartbeatTimer = null;
-		}
-		this.subscribers.clear();
-	}
-}

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

@@ -1,271 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { RESOLVED_ASSETS_DIR } from '../../constants.ts';
-import { defaultBuildAdapter } from '../../build/build-adapter.ts';
-import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../internal-types.ts';
-import type { EcoBuildPlugin } from '../../build/build-types.ts';
-import { fileSystem } from '@ecopages/file-system';
-import type { HmrStrategy } from '../../hmr/hmr-strategy.ts';
-import { DefaultHmrStrategy } from '../../hmr/strategies/default-hmr-strategy.ts';
-import { JsHmrStrategy } from '../../hmr/strategies/js-hmr-strategy.ts';
-import { appLogger } from '../../global/app-logger.ts';
-import type { ClientBridgeEvent } from '../../public-types.ts';
-
-export interface NodeHmrManagerParams {
-	appConfig: EcoPagesAppConfig;
-	bridge: IClientBridge;
-}
-
-export class NodeHmrManager implements IHmrManager {
-	public readonly appConfig: EcoPagesAppConfig;
-	private readonly bridge: IClientBridge;
-	private watchers = new Map<string, fs.FSWatcher>();
-	private watchedFiles = new Map<string, string>();
-	private specifierMap = new Map<string, string>();
-	/**
-	 * Node-only reverse invalidation index: dependency file -> affected entrypoints.
-	 */
-	private dependencyEntrypoints = new Map<string, Set<string>>();
-	/**
-	 * Node-only forward index: entrypoint -> latest dependency set.
-	 */
-	private entrypointDependencies = new Map<string, Set<string>>();
-	private distDir: string;
-	private plugins: EcoBuildPlugin[] = [];
-	private enabled = true;
-	private strategies: HmrStrategy[] = [];
-
-	constructor({ appConfig, bridge }: NodeHmrManagerParams) {
-		this.appConfig = appConfig;
-		this.bridge = bridge;
-		this.distDir = path.join(this.appConfig.absolutePaths.distDir, RESOLVED_ASSETS_DIR, '_hmr');
-		this.cleanDistDir();
-		this.initializeStrategies();
-	}
-
-	/**
-	 * Ensures the HMR output directory exists.
-	 *
-	 * This must not remove the directory because multiple app processes
-	 * can share the same dist path during e2e runs.
-	 */
-	private cleanDistDir(): void {
-		fileSystem.ensureDir(this.distDir);
-	}
-
-	private initializeStrategies(): void {
-		const jsContext = {
-			getWatchedFiles: () => this.watchedFiles,
-			getSpecifierMap: () => this.specifierMap,
-			getDependencyEntrypoints: (filePath: string) =>
-				new Set(this.dependencyEntrypoints.get(path.resolve(filePath)) ?? []),
-			setEntrypointDependencies: (entrypointPath: string, dependencies: string[]) =>
-				this.setEntrypointDependencies(entrypointPath, dependencies),
-			getDistDir: () => this.distDir,
-			getPlugins: () => this.plugins,
-			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
-		};
-
-		this.strategies = [new JsHmrStrategy(jsContext), new DefaultHmrStrategy()];
-	}
-
-	public registerStrategy(strategy: HmrStrategy): void {
-		this.strategies.push(strategy);
-	}
-
-	public setPlugins(plugins: EcoBuildPlugin[]): void {
-		this.plugins = [...plugins];
-	}
-
-	public setEnabled(enabled: boolean): void {
-		this.enabled = enabled;
-	}
-
-	public isEnabled(): boolean {
-		return this.enabled;
-	}
-
-	public registerSpecifierMap(map: Record<string, string>): void {
-		for (const [specifier, url] of Object.entries(map)) {
-			this.specifierMap.set(specifier, url);
-		}
-	}
-
-	public async buildRuntime(): Promise<void> {
-		const currentDir = path.dirname(fileURLToPath(import.meta.url));
-		const runtimeSource = path.resolve(currentDir, '../../hmr/client/hmr-runtime.ts');
-
-		const result = await defaultBuildAdapter.build({
-			entrypoints: [runtimeSource],
-			outdir: this.distDir,
-			naming: '_hmr_runtime.js',
-			minify: false,
-			...defaultBuildAdapter.getTranspileOptions('hmr-runtime'),
-			plugins: this.plugins,
-		});
-
-		if (!result.success) {
-			appLogger.error('[HMR] Failed to build runtime script:', result.logs);
-		}
-	}
-
-	public getRuntimePath(): string {
-		return path.join(this.distDir, '_hmr_runtime.js');
-	}
-
-	public broadcast(event: ClientBridgeEvent) {
-		appLogger.debug(
-			`[HMR] Broadcasting ${event.type} event, path=${event.path || 'all'}, subscribers=${this.bridge.subscriberCount}`,
-		);
-		this.bridge.broadcast(event);
-	}
-
-	public async handleFileChange(filePath: string): Promise<void> {
-		const sorted = [...this.strategies].sort((a, b) => b.priority - a.priority);
-		const strategy = sorted.find((s) => {
-			try {
-				return s.matches(filePath);
-			} catch (err) {
-				appLogger.error(`[NodeHmrManager] Error checking match for ${s.constructor.name}:`, err as Error);
-				return false;
-			}
-		});
-
-		if (!strategy) {
-			appLogger.warn(`[HMR] No strategy found for ${filePath}`);
-			return;
-		}
-
-		appLogger.debug(`[NodeHmrManager] Selected strategy: ${strategy.constructor.name}`);
-
-		const action = await strategy.process(filePath);
-
-		if (action.type === 'broadcast') {
-			if (action.events) {
-				for (const event of action.events) {
-					this.broadcast(event);
-				}
-			}
-		}
-	}
-
-	public getOutputUrl(entrypointPath: string): string | undefined {
-		return this.watchedFiles.get(entrypointPath);
-	}
-
-	public getWatchedFiles(): Map<string, string> {
-		return this.watchedFiles;
-	}
-
-	public getSpecifierMap(): Map<string, string> {
-		return this.specifierMap;
-	}
-
-	public getDistDir(): string {
-		return this.distDir;
-	}
-
-	public getPlugins(): EcoBuildPlugin[] {
-		return this.plugins;
-	}
-
-	public getDefaultContext(): DefaultHmrContext {
-		return {
-			getWatchedFiles: () => this.watchedFiles,
-			getSpecifierMap: () => this.specifierMap,
-			getDistDir: () => this.distDir,
-			getPlugins: () => this.plugins,
-			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
-			getLayoutsDir: () => this.appConfig.absolutePaths.layoutsDir,
-			getPagesDir: () => this.appConfig.absolutePaths.pagesDir,
-		};
-	}
-
-	/**
-	 * Updates Node HMR dependency indexes for selective invalidation.
-	 *
-	 * @remarks
-	 * Graph data comes from Node/esbuild build metadata and does not affect Bun
-	 * HMR behavior.
-	 */
-	private setEntrypointDependencies(entrypointPath: string, dependencies: string[]): void {
-		const normalizedEntrypoint = path.resolve(entrypointPath);
-		const previousDependencies = this.entrypointDependencies.get(normalizedEntrypoint);
-
-		if (previousDependencies) {
-			for (const dependencyPath of previousDependencies) {
-				const entrypoints = this.dependencyEntrypoints.get(dependencyPath);
-				if (!entrypoints) {
-					continue;
-				}
-
-				entrypoints.delete(normalizedEntrypoint);
-				if (entrypoints.size === 0) {
-					this.dependencyEntrypoints.delete(dependencyPath);
-				}
-			}
-		}
-
-		const normalizedDependencies = new Set<string>([
-			normalizedEntrypoint,
-			...dependencies.map((dependencyPath) => path.resolve(dependencyPath)),
-		]);
-
-		this.entrypointDependencies.set(normalizedEntrypoint, normalizedDependencies);
-
-		for (const dependencyPath of normalizedDependencies) {
-			const entrypoints = this.dependencyEntrypoints.get(dependencyPath) ?? new Set<string>();
-			entrypoints.add(normalizedEntrypoint);
-			this.dependencyEntrypoints.set(dependencyPath, entrypoints);
-		}
-	}
-
-	public async registerEntrypoint(entrypointPath: string): Promise<string> {
-		if (this.watchedFiles.has(entrypointPath)) {
-			return this.watchedFiles.get(entrypointPath)!;
-		}
-
-		const srcDir = this.appConfig.absolutePaths.srcDir;
-		const relativePath = path.relative(srcDir, entrypointPath);
-		const relativePathJs = relativePath.replace(/\.(tsx?|jsx?|mdx?)$/, '.js');
-		const encodedPathJs = this.encodeDynamicSegments(relativePathJs);
-
-		const urlPath = encodedPathJs.split(path.sep).join('/');
-		const outputUrl = `/${path.join(RESOLVED_ASSETS_DIR, '_hmr', urlPath)}`;
-		const outputPath = path.join(this.distDir, urlPath);
-
-		this.watchedFiles.set(entrypointPath, outputUrl);
-
-		await this.handleFileChange(entrypointPath);
-
-		if (!fileSystem.exists(outputPath)) {
-			const fallback = await defaultBuildAdapter.build({
-				entrypoints: [entrypointPath],
-				outdir: this.distDir,
-				naming: encodedPathJs,
-				minify: false,
-				external: Array.from(this.specifierMap.keys()),
-				...defaultBuildAdapter.getTranspileOptions('hmr-entrypoint'),
-				plugins: this.plugins,
-			});
-
-			if (!fallback.success) {
-				appLogger.error(`[HMR] Fallback build failed for ${entrypointPath}:`, fallback.logs);
-			}
-		}
-
-		return outputUrl;
-	}
-
-	private encodeDynamicSegments(filepath: string): string {
-		return filepath.replace(/\[([^\]]+)\]/g, '_$1_');
-	}
-
-	public stop() {
-		for (const watcher of this.watchers.values()) {
-			watcher.close();
-		}
-		this.watchers.clear();
-	}
-}