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

package/src/adapters/shared/server-static-builder.ts

@@ -1,170 +0,0 @@
-import path from 'node:path';
-import { fileSystem } from '@ecopages/file-system';
-import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from '../../config/constants.ts';
-import { StaticContentServer } from '../../dev/sc-server.ts';
-import { appLogger } from '../../global/app-logger.ts';
-import type { EcoPagesAppConfig } from '../../types/internal-types.ts';
-import type { ApiHandler, StaticRoute } from '../../types/public-types.ts';
-import type { RouteRegistry } from '../../router/server/route-registry.ts';
-import type { StaticSiteGenerator } from '../../static-site-generator/static-site-generator.ts';
-import type { StaticGenerationRendererResolver } from '../../route-renderer/route-renderer.ts';
-
-export interface StaticBuildOptions {
-	preview?: boolean;
-	baseUrl?: string;
-}
-
-export interface ServeOptions {
-	hostname?: string;
-	port?: number | string;
-}
-
-export interface ServerStaticBuilderParams {
-	appConfig: EcoPagesAppConfig;
-	staticSiteGenerator: StaticSiteGenerator;
-	serveOptions: ServeOptions;
-	apiHandlers?: ApiHandler[];
-	logger?: ServerStaticBuilderLogger;
-	previewServerFactory?: ServerStaticPreviewServerFactory;
-}
-
-/**
- * Minimal logger dependency used by the static builder.
- */
-export interface ServerStaticBuilderLogger {
-	warn(message: string, detail?: string): unknown;
-	info(message: string): unknown;
-	error(message: string): unknown;
-}
-
-/**
- * Preview server factory dependency used when static preview mode is enabled.
- */
-export interface ServerStaticPreviewServerFactory {
-	createServer(args: { appConfig: EcoPagesAppConfig; options: { port: number } }): {
-		server?: {
-			port?: number;
-		} | null;
-	};
-}
-
-/**
- * Handles static site generation and previews.
- */
-export class ServerStaticBuilder {
-	private readonly appConfig: EcoPagesAppConfig;
-	private readonly staticSiteGenerator: StaticSiteGenerator;
-	private readonly serveOptions: ServeOptions;
-	private readonly apiHandlers: ApiHandler[];
-	private readonly logger: ServerStaticBuilderLogger;
-	private readonly previewServerFactory: ServerStaticPreviewServerFactory;
-
-	constructor({
-		appConfig,
-		staticSiteGenerator,
-		serveOptions,
-		apiHandlers,
-		logger,
-		previewServerFactory,
-	}: ServerStaticBuilderParams) {
-		this.appConfig = appConfig;
-		this.staticSiteGenerator = staticSiteGenerator;
-		this.serveOptions = serveOptions;
-		this.apiHandlers = apiHandlers ?? [];
-		this.logger = logger ?? appLogger;
-		this.previewServerFactory = previewServerFactory ?? StaticContentServer;
-	}
-
-	private warnApiHandlersUnavailableInStaticMode(): void {
-		if (this.apiHandlers.length === 0) {
-			return;
-		}
-
-		const uniqueHandlers = Array.from(
-			new Set(this.apiHandlers.map((handler) => `${handler.method} ${handler.path}`)),
-		);
-		const visibleHandlers = uniqueHandlers.slice(0, 5).join(', ');
-		const remainingCount = uniqueHandlers.length - Math.min(uniqueHandlers.length, 5);
-		const summary = remainingCount > 0 ? `${visibleHandlers}, +${remainingCount} more` : visibleHandlers;
-
-		this.logger.warn(
-			'Registered API endpoints are not available in static build or preview modes because no server runtime is started. They are excluded from the generated output.\n',
-			`➤ ${summary}`,
-		);
-	}
-
-	private prepareExportDirectory(): void {
-		const exportDir =
-			this.appConfig.absolutePaths?.distDir ?? path.join(this.appConfig.rootDir, this.appConfig.distDir);
-		fileSystem.ensureDir(exportDir, true);
-
-		const srcPublicDir = path.join(
-			this.appConfig.rootDir,
-			this.appConfig.srcDir ?? 'src',
-			this.appConfig.publicDir ?? 'public',
-		);
-		if (fileSystem.exists(srcPublicDir)) {
-			fileSystem.copyDir(srcPublicDir, exportDir);
-		}
-	}
-
-	private async refreshRuntimeAssets(): Promise<void> {
-		for (const processor of this.appConfig.processors.values()) {
-			await processor.setup();
-		}
-
-		for (const integration of this.appConfig.integrations) {
-			await integration.setup();
-		}
-	}
-
-	/**
-	 * Generates a static build of the site for deployment.
-	 * @param options.preview - If true, starts a preview server after build
-	 * @param dependencies.router - The initialized router
-	 * @param dependencies.routeRendererFactory - The route renderer factory
-	 * @param dependencies.staticRoutes - Explicit static routes registered via app.static()
-	 */
-	async build(
-		options: StaticBuildOptions | undefined,
-		dependencies: {
-			router: RouteRegistry;
-			routeRendererFactory: StaticGenerationRendererResolver;
-			staticRoutes?: StaticRoute[];
-		},
-	): Promise<void> {
-		const { preview = false, baseUrl: explicitBaseUrl } = options ?? {};
-
-		const baseUrl =
-			explicitBaseUrl ??
-			`http://${this.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME}:${this.serveOptions.port || DEFAULT_ECOPAGES_PORT}`;
-		this.warnApiHandlersUnavailableInStaticMode();
-		this.prepareExportDirectory();
-		await this.refreshRuntimeAssets();
-
-		await this.staticSiteGenerator.run({
-			router: dependencies.router,
-			baseUrl,
-			routeRendererFactory: dependencies.routeRendererFactory,
-			staticRoutes: dependencies.staticRoutes,
-		});
-
-		if (!preview) {
-			this.logger.info('Build completed');
-			return;
-		}
-
-		const previewPort = this.serveOptions.port || DEFAULT_ECOPAGES_PORT;
-
-		const { server } = this.previewServerFactory.createServer({
-			appConfig: this.appConfig,
-			options: { port: Number(previewPort) },
-		});
-
-		if (server?.port) {
-			this.logger.info(`Preview running at http://localhost:${server.port}`);
-		} else {
-			this.logger.error('Failed to start preview server');
-		}
-	}
-}

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

@@ -1,298 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { RESOLVED_ASSETS_DIR } from '../../config/constants.ts';
-import { getAppBuildExecutor } from '../../build/build-adapter.ts';
-import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../types/internal-types.ts';
-import type { EcoBuildPlugin } from '../../build/build-types.ts';
-import { fileSystem } from '@ecopages/file-system';
-import { HmrStrategyType, 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 '../../types/public-types.ts';
-import { HmrEntrypointRegistrar } from './hmr-entrypoint-registrar.ts';
-import { BrowserBundleService } from '../../services/assets/browser-bundle.service.ts';
-import { getAppServerModuleTranspiler } from '../../services/module-loading/app-server-module-transpiler.service.ts';
-import {
-	getAppEntrypointDependencyGraph,
-	setAppEntrypointDependencyGraph,
-	type EntrypointDependencyGraph,
-} from '../../services/runtime-state/entrypoint-dependency-graph.service.ts';
-import type { ServerModuleTranspiler } from '../../services/module-loading/server-module-transpiler.service.ts';
-import { resolveInternalExecutionDir, resolveInternalWorkDir } from '../../utils/resolve-work-dir.ts';
-
-type HandleFileChangeOptions = {
-	broadcast?: boolean;
-};
-
-type SharedHmrManagerParams = {
-	appConfig: EcoPagesAppConfig;
-	bridge: IClientBridge;
-	registrationTimeoutMs?: number;
-};
-
-export abstract class SharedHmrManager implements IHmrManager {
-	public readonly appConfig: EcoPagesAppConfig;
-	protected readonly bridge: IClientBridge;
-	protected watchers = new Map<string, fs.FSWatcher>();
-	protected watchedFiles = new Map<string, string>();
-	protected entrypointRegistrations = new Map<string, Promise<string>>();
-	protected distDir: string;
-	protected plugins: EcoBuildPlugin[] = [];
-	protected enabled = true;
-	protected strategies: HmrStrategy[] = [];
-	protected readonly entrypointRegistrar: HmrEntrypointRegistrar;
-	protected readonly browserBundleService: BrowserBundleService;
-	protected readonly entrypointDependencyGraph: EntrypointDependencyGraph;
-	protected readonly serverModuleTranspiler: ServerModuleTranspiler;
-
-	constructor({ appConfig, bridge, registrationTimeoutMs = 4000 }: SharedHmrManagerParams) {
-		this.appConfig = appConfig;
-		this.bridge = bridge;
-		this.distDir = path.join(resolveInternalWorkDir(this.appConfig), RESOLVED_ASSETS_DIR, '_hmr');
-		this.entrypointRegistrar = new HmrEntrypointRegistrar({
-			srcDir: this.appConfig.absolutePaths.srcDir,
-			distDir: this.distDir,
-			entrypointRegistrations: this.entrypointRegistrations,
-			watchedFiles: this.watchedFiles,
-			clearFailedRegistration: (entrypointPath) => this.clearFailedEntrypointRegistration(entrypointPath),
-			registrationTimeoutMs,
-		});
-		this.browserBundleService = new BrowserBundleService(appConfig);
-		this.entrypointDependencyGraph = this.createEntrypointDependencyGraph(
-			getAppEntrypointDependencyGraph(appConfig),
-		);
-		setAppEntrypointDependencyGraph(this.appConfig, this.entrypointDependencyGraph);
-		this.serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
-		this.ensureDistDir();
-		this.initializeStrategies();
-	}
-
-	protected abstract createEntrypointDependencyGraph(
-		existingEntrypointDependencyGraph: EntrypointDependencyGraph,
-	): EntrypointDependencyGraph;
-
-	protected shouldSkipMissingFileChange(_filePath: string): boolean {
-		return false;
-	}
-
-	protected onRuntimeBundleFailure(error: unknown): void {
-		appLogger.error('[HMR] Failed to build runtime script:', error);
-	}
-
-	protected ensureDistDir(): void {
-		fileSystem.ensureDir(this.distDir);
-	}
-
-	protected shouldJsStrategyProcessEntrypoint(entrypointPath: string): boolean {
-		return !this.strategies.some((strategy) => {
-			if (strategy.type !== HmrStrategyType.INTEGRATION || strategy.priority <= HmrStrategyType.SCRIPT) {
-				return false;
-			}
-
-			try {
-				return strategy.matches(entrypointPath);
-			} catch (error) {
-				appLogger.error(error);
-				return false;
-			}
-		});
-	}
-
-	protected initializeStrategies(): void {
-		const jsContext = {
-			getWatchedFiles: () => this.watchedFiles,
-			getDistDir: () => this.distDir,
-			getPlugins: () => this.plugins,
-			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
-			getPagesDir: () => this.appConfig.absolutePaths.pagesDir,
-			getLayoutsDir: () => this.appConfig.absolutePaths.layoutsDir,
-			getTemplateExtensions: () => this.appConfig.templatesExt,
-			getBrowserBundleService: () => this.browserBundleService,
-			getEntrypointDependencyGraph: () => this.entrypointDependencyGraph,
-			shouldProcessEntrypoint: (entrypointPath: string) => this.shouldJsStrategyProcessEntrypoint(entrypointPath),
-		};
-
-		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 async buildRuntime(): Promise<void> {
-		const runtimeSource = fileURLToPath(import.meta.resolve('@ecopages/core/hmr/client/hmr-runtime'));
-
-		try {
-			const result = await this.browserBundleService.bundle({
-				profile: 'hmr-runtime',
-				entrypoints: [runtimeSource],
-				outdir: this.distDir,
-				naming: '_hmr_runtime.js',
-				minify: false,
-				plugins: this.plugins,
-			});
-
-			if (!result.success) {
-				this.onRuntimeBundleFailure(result.logs);
-			}
-		} catch (error) {
-			this.onRuntimeBundleFailure(error);
-		}
-	}
-
-	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, options: HandleFileChangeOptions = {}): Promise<void> {
-		if (this.shouldSkipMissingFileChange(filePath) && !fileSystem.exists(filePath)) {
-			appLogger.debug(`[${this.constructor.name}] Skipping missing file change: ${filePath}`);
-			this.clearFailedEntrypointRegistration(filePath);
-			return;
-		}
-
-		const sorted = [...this.strategies].sort((a, b) => b.priority - a.priority);
-		const strategy = sorted.find((candidate) => {
-			try {
-				return candidate.matches(filePath);
-			} catch (error) {
-				appLogger.error(error);
-				return false;
-			}
-		});
-
-		if (!strategy) {
-			appLogger.warn(`[HMR] No strategy found for ${filePath}`);
-			return;
-		}
-
-		appLogger.debug(`[${this.constructor.name}] Selected strategy: ${strategy.constructor.name}`);
-
-		const action = await strategy.process(filePath);
-		const shouldBroadcast = options.broadcast ?? true;
-
-		if (shouldBroadcast && action.type === 'broadcast' && 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 getDistDir(): string {
-		return this.distDir;
-	}
-
-	public getPlugins(): EcoBuildPlugin[] {
-		return this.plugins;
-	}
-
-	public getDefaultContext(): DefaultHmrContext {
-		return {
-			getWatchedFiles: () => this.watchedFiles,
-			getDistDir: () => this.distDir,
-			getPlugins: () => this.plugins,
-			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
-			getLayoutsDir: () => this.appConfig.absolutePaths.layoutsDir,
-			getPagesDir: () => this.appConfig.absolutePaths.pagesDir,
-			getBuildExecutor: () => getAppBuildExecutor(this.appConfig),
-			getBrowserBundleService: () => this.browserBundleService,
-			getEntrypointDependencyGraph: () => this.entrypointDependencyGraph,
-			importServerModule: async <T>(filePath: string) =>
-				await this.serverModuleTranspiler.importModule<T>({
-					filePath,
-					outdir: path.join(resolveInternalExecutionDir(this.appConfig), '.server-modules'),
-					externalPackages: true,
-				}),
-		};
-	}
-
-	protected clearFailedEntrypointRegistration(entrypointPath: string): void {
-		this.watchedFiles.delete(entrypointPath);
-		this.entrypointDependencyGraph.clearEntrypointDependencies(entrypointPath);
-	}
-
-	public async registerEntrypoint(entrypointPath: string): Promise<string> {
-		return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-			emit: async (normalizedEntrypoint) => await this.emitStrictEntrypoint(normalizedEntrypoint),
-			getMissingOutputError: (normalizedEntrypoint, outputPath) =>
-				new Error(
-					`[HMR] Integration failed to emit entrypoint ${normalizedEntrypoint} to ${outputPath}. Page entrypoints must be produced by their owning integration.`,
-				),
-		});
-	}
-
-	public async registerScriptEntrypoint(entrypointPath: string): Promise<string> {
-		return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-			emit: async (normalizedEntrypoint, outputPath) =>
-				await this.emitScriptEntrypoint(normalizedEntrypoint, outputPath),
-			getMissingOutputError: (normalizedEntrypoint) =>
-				new Error(`[HMR] Failed to register script entrypoint: ${normalizedEntrypoint}`),
-		});
-	}
-
-	protected async emitStrictEntrypoint(entrypointPath: string): Promise<void> {
-		await this.handleFileChange(entrypointPath, { broadcast: false });
-	}
-
-	protected async emitScriptEntrypoint(entrypointPath: string, outputPath: string): Promise<void> {
-		const naming = path.relative(this.distDir, outputPath).split(path.sep).join('/');
-		const buildResult = await this.browserBundleService.bundle({
-			profile: 'hmr-entrypoint',
-			entrypoints: [entrypointPath],
-			outdir: this.distDir,
-			naming,
-			minify: false,
-			plugins: this.plugins,
-		});
-
-		if (!buildResult.success) {
-			appLogger.error(`[HMR] Generic script entrypoint build failed for ${entrypointPath}:`, buildResult.logs);
-			return;
-		}
-
-		const entrypointDependencies = buildResult.dependencyGraph?.entrypoints?.[entrypointPath];
-		if (entrypointDependencies) {
-			this.entrypointDependencyGraph.setEntrypointDependencies(entrypointPath, entrypointDependencies);
-		}
-	}
-
-	public stop() {
-		this.entrypointRegistrations.clear();
-		for (const watcher of this.watchers.values()) {
-			watcher.close();
-		}
-		this.watchers.clear();
-		this.watchedFiles.clear();
-		this.entrypointDependencyGraph.reset();
-		this.plugins = [];
-	}
-}

package/src/adapters/shared/static-preview-host.ts

@@ -1,12 +0,0 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.ts';
-
-export interface StaticPreviewHost {
-	start(options: StaticPreviewHostStartOptions): Promise<number | null>;
-	stop(force?: boolean): Promise<void>;
-}
-
-export interface StaticPreviewHostStartOptions {
-	appConfig: EcoPagesAppConfig;
-	hostname: string;
-	port: number;
-}

package/src/build/browser-runtime-manifest.test.ts

@@ -1,121 +0,0 @@
-import assert from 'node:assert/strict';
-import { test } from 'vitest';
-import {
-	BrowserRuntimeManifestConflictError,
-	createBrowserRuntimeManifest,
-	getBrowserRuntimeSpecifierMap,
-	mergeBrowserRuntimeManifests,
-} from './browser-runtime-manifest.ts';
-
-test('createBrowserRuntimeManifest indexes runtime assets by specifier', () => {
-	const manifest = createBrowserRuntimeManifest([
-		{
-			specifier: 'react',
-			owner: '@ecopages/react',
-			importPath: 'react',
-			publicPath: '/assets/vendors/react.js',
-			mode: 'development',
-			externals: ['react-dom'],
-		},
-	]);
-
-	assert.equal(manifest.assets.length, 1);
-	assert.deepEqual(manifest.bySpecifier.get('react'), {
-		specifier: 'react',
-		owner: '@ecopages/react',
-		importPath: 'react',
-		publicPath: '/assets/vendors/react.js',
-		mode: 'development',
-		externals: ['react-dom'],
-	});
-});
-
-test('createBrowserRuntimeManifest deduplicates identical declarations', () => {
-	const manifest = createBrowserRuntimeManifest([
-		{
-			specifier: 'react',
-			owner: '@ecopages/react',
-			importPath: 'react',
-			publicPath: '/assets/vendors/react.js',
-		},
-		{
-			specifier: 'react',
-			owner: '@ecopages/react',
-			importPath: 'react',
-			publicPath: '/assets/vendors/react.js',
-		},
-	]);
-
-	assert.equal(manifest.assets.length, 1);
-});
-
-test('createBrowserRuntimeManifest rejects conflicting declarations', () => {
-	assert.throws(
-		() =>
-			createBrowserRuntimeManifest([
-				{
-					specifier: 'react',
-					owner: '@ecopages/react',
-					importPath: 'react',
-					publicPath: '/assets/vendors/react.js',
-				},
-				{
-					specifier: 'react',
-					owner: 'custom-runtime',
-					importPath: 'react',
-					publicPath: '/assets/custom/react.js',
-				},
-			]),
-		(error) => {
-			assert.ok(error instanceof BrowserRuntimeManifestConflictError);
-			assert.equal(error.specifier, 'react');
-			assert.match(error.message, /@ecopages\/react maps to \/assets\/vendors\/react\.js/u);
-			return true;
-		},
-	);
-});
-
-test('mergeBrowserRuntimeManifests combines manifest declarations with conflict detection', () => {
-	const reactManifest = createBrowserRuntimeManifest([
-		{
-			specifier: 'react',
-			owner: '@ecopages/react',
-			importPath: 'react',
-			publicPath: '/assets/vendors/react.js',
-		},
-	]);
-	const routerManifest = createBrowserRuntimeManifest([
-		{
-			specifier: '@ecopages/react-router/browser',
-			owner: '@ecopages/react-router',
-			importPath: '@ecopages/react-router/browser',
-			publicPath: '/assets/vendors/react-router.js',
-		},
-	]);
-
-	const manifest = mergeBrowserRuntimeManifests(reactManifest, undefined, routerManifest);
-
-	assert.deepEqual(Array.from(manifest.bySpecifier.keys()), ['react', '@ecopages/react-router/browser']);
-});
-
-test('getBrowserRuntimeSpecifierMap returns concrete public URLs for rewriting', () => {
-	const manifest = createBrowserRuntimeManifest([
-		{
-			specifier: 'react',
-			owner: '@ecopages/react',
-			importPath: 'react',
-			publicPath: '/assets/vendors/react.js',
-		},
-		{
-			specifier: 'react-dom/client',
-			owner: '@ecopages/react',
-			importPath: 'react-dom/client',
-			publicPath: '/assets/vendors/react-dom-client.js',
-		},
-	]);
-
-	assert.deepEqual(Array.from(getBrowserRuntimeSpecifierMap(manifest).entries()), [
-		['react', '/assets/vendors/react.js'],
-		['react-dom/client', '/assets/vendors/react-dom-client.js'],
-	]);
-});