@ecopages/core 0.2.0-alpha.7 → 0.2.0-alpha.8

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

@@ -1,316 +0,0 @@
-import assert from 'node:assert/strict';
-import { describe, expect, it, beforeAll, afterAll } from 'vitest';
-import {
-	ServerStaticBuilder,
-	type ServeOptions,
-	type ServerStaticBuilderLogger,
-	type ServerStaticPreviewServerFactory,
-} from './server-static-builder';
-import type { EcoPagesAppConfig } from '../../internal-types';
-import type { StaticSiteGenerator } from '../../static-site-generator/static-site-generator';
-import type { FSRouter } from '../../router/server/fs-router';
-import type { RouteRendererFactory } from '../../route-renderer/route-renderer';
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-
-const TMP_DIR = path.join(os.tmpdir(), 'server-static-builder-test');
-
-function createMockDependencies() {
-	const calls = {
-		staticSiteGeneratorRun: [] as Array<unknown>,
-		integrationSetup: 0,
-		processorSetup: 0,
-		warn: [] as Array<[string, string | undefined]>,
-		info: [] as string[],
-		error: [] as string[],
-		createServer: [] as Array<{
-			appConfig: EcoPagesAppConfig;
-			options: { port: number };
-		}>,
-	};
-
-	const StaticSiteGenerator = {
-		run: async (options: unknown) => {
-			calls.staticSiteGeneratorRun.push(options);
-		},
-	} as unknown as StaticSiteGenerator;
-
-	const mockIntegration = {
-		setup: async () => {
-			calls.integrationSetup += 1;
-		},
-	} as any;
-
-	const mockProcessor = {
-		setup: async () => {
-			calls.processorSetup += 1;
-			fs.mkdirSync(path.join(TMP_DIR, 'dist', 'images'), { recursive: true });
-			fs.writeFileSync(path.join(TMP_DIR, 'dist', 'images', 'processor.webp'), 'processor-output');
-		},
-	} as any;
-
-	const AppConfig = {
-		rootDir: TMP_DIR,
-		srcDir: 'src',
-		publicDir: 'public',
-		distDir: 'dist',
-		integrations: [mockIntegration],
-		processors: new Map([['image-processor', mockProcessor]]),
-		absolutePaths: {
-			distDir: path.join(TMP_DIR, 'dist'),
-			workDir: path.join(TMP_DIR, '.eco'),
-		} as EcoPagesAppConfig['absolutePaths'],
-	} as unknown as EcoPagesAppConfig;
-
-	const ServeOptions: ServeOptions = {
-		hostname: 'localhost',
-		port: 3000,
-	};
-
-	const Router = {} as FSRouter;
-	const RouteRendererFactory = {} as RouteRendererFactory;
-	const logger: ServerStaticBuilderLogger = {
-		warn: (message: string, detail?: string) => {
-			calls.warn.push([message, detail]);
-		},
-		info: (message: string) => {
-			calls.info.push(message);
-		},
-		error: (message: string) => {
-			calls.error.push(message);
-		},
-	};
-	const previewServerFactory: ServerStaticPreviewServerFactory = {
-		createServer: ({ appConfig, options }) => {
-			calls.createServer.push({ appConfig, options });
-			return {
-				server: { port: 3000 },
-			};
-		},
-	};
-
-	return {
-		calls,
-		StaticSiteGenerator,
-		AppConfig,
-		mockIntegration,
-		mockProcessor,
-		logger,
-		previewServerFactory,
-		ServeOptions,
-		Router,
-		RouteRendererFactory,
-		ApiHandlers: [],
-	};
-}
-
-describe('ServerStaticBuilder', () => {
-	beforeAll(() => {
-		fs.mkdirSync(TMP_DIR, { recursive: true });
-	});
-
-	afterAll(() => {
-		fs.rmSync(TMP_DIR, { recursive: true, force: true });
-	});
-
-	it('should warn when API handlers are registered for static build modes', async () => {
-		const { AppConfig, StaticSiteGenerator, ServeOptions, Router, RouteRendererFactory, logger, calls } =
-			createMockDependencies();
-
-		const builder = new ServerStaticBuilder({
-			appConfig: AppConfig,
-			staticSiteGenerator: StaticSiteGenerator,
-			serveOptions: ServeOptions,
-			logger,
-			apiHandlers: [
-				{ method: 'GET', path: '/api/auth/*', handler: () => undefined } as any,
-				{ method: 'POST', path: '/api/auth/*', handler: () => undefined } as any,
-			],
-		});
-
-		await builder.build(undefined, {
-			router: Router,
-			routeRendererFactory: RouteRendererFactory,
-		});
-
-		assert.deepEqual(calls.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',
-				'➤ GET /api/auth/*, POST /api/auth/*',
-			],
-		]);
-	});
-
-	describe('constructor', () => {
-		it('should create instance with provided options', () => {
-			const { AppConfig, StaticSiteGenerator, ServeOptions, logger, previewServerFactory } =
-				createMockDependencies();
-			const builder = new ServerStaticBuilder({
-				appConfig: AppConfig,
-				staticSiteGenerator: StaticSiteGenerator,
-				serveOptions: ServeOptions,
-				logger,
-				previewServerFactory,
-			});
-			expect(builder).toBeDefined();
-		});
-	});
-
-	describe('build', () => {
-		it('should run static site generator with correct options', async () => {
-			const { AppConfig, StaticSiteGenerator, ServeOptions, Router, RouteRendererFactory, logger, calls } =
-				createMockDependencies();
-
-			const builder = new ServerStaticBuilder({
-				appConfig: AppConfig,
-				staticSiteGenerator: StaticSiteGenerator,
-				serveOptions: ServeOptions,
-				logger,
-			});
-
-			await builder.build(undefined, {
-				router: Router,
-				routeRendererFactory: RouteRendererFactory,
-			});
-
-			assert.deepEqual(calls.staticSiteGeneratorRun, [
-				{
-					router: Router,
-					baseUrl: 'http://localhost:3000',
-					routeRendererFactory: RouteRendererFactory,
-					staticRoutes: undefined,
-				},
-			]);
-		});
-
-		it('should handle custom serve options for base URL', async () => {
-			const { AppConfig, StaticSiteGenerator, Router, RouteRendererFactory, logger, calls } =
-				createMockDependencies();
-
-			const customServeOptions: ServeOptions = {
-				hostname: '0.0.0.0',
-				port: 8080,
-			};
-
-			const builder = new ServerStaticBuilder({
-				appConfig: AppConfig,
-				staticSiteGenerator: StaticSiteGenerator,
-				serveOptions: customServeOptions,
-				logger,
-			});
-
-			await builder.build(undefined, {
-				router: Router,
-				routeRendererFactory: RouteRendererFactory,
-			});
-
-			assert.equal((calls.staticSiteGeneratorRun[0] as { baseUrl: string }).baseUrl, 'http://0.0.0.0:8080');
-		});
-
-		it('should start preview server when preview option is true', async () => {
-			const {
-				AppConfig,
-				StaticSiteGenerator,
-				ServeOptions,
-				Router,
-				RouteRendererFactory,
-				logger,
-				previewServerFactory,
-				calls,
-			} = createMockDependencies();
-
-			const builder = new ServerStaticBuilder({
-				appConfig: AppConfig,
-				staticSiteGenerator: StaticSiteGenerator,
-				serveOptions: ServeOptions,
-				logger,
-				previewServerFactory,
-			});
-
-			await builder.build(
-				{ preview: true },
-				{
-					router: Router,
-					routeRendererFactory: RouteRendererFactory,
-				},
-			);
-
-			assert.deepEqual(calls.createServer, [
-				{
-					appConfig: AppConfig,
-					options: { port: 3000 },
-				},
-			]);
-		});
-
-		it('should rebuild integration runtime assets after resetting the export directory', async () => {
-			const { AppConfig, StaticSiteGenerator, ServeOptions, Router, RouteRendererFactory, logger, calls } =
-				createMockDependencies();
-
-			const builder = new ServerStaticBuilder({
-				appConfig: AppConfig,
-				staticSiteGenerator: StaticSiteGenerator,
-				serveOptions: ServeOptions,
-				logger,
-			});
-
-			await builder.build(undefined, {
-				router: Router,
-				routeRendererFactory: RouteRendererFactory,
-			});
-
-			assert.equal(calls.integrationSetup, 1);
-		});
-
-		it('should rebuild processor-owned assets after resetting the export directory', async () => {
-			const { AppConfig, StaticSiteGenerator, ServeOptions, Router, RouteRendererFactory, logger, calls } =
-				createMockDependencies();
-
-			const builder = new ServerStaticBuilder({
-				appConfig: AppConfig,
-				staticSiteGenerator: StaticSiteGenerator,
-				serveOptions: ServeOptions,
-				logger,
-			});
-
-			await builder.build(undefined, {
-				router: Router,
-				routeRendererFactory: RouteRendererFactory,
-			});
-
-			assert.equal(calls.processorSetup, 1);
-			assert.equal(
-				fs.readFileSync(path.join(TMP_DIR, 'dist', 'images', 'processor.webp'), 'utf8'),
-				'processor-output',
-			);
-		});
-
-		it('should reset stale export contents before regenerating the public output', async () => {
-			const { AppConfig, StaticSiteGenerator, ServeOptions, Router, RouteRendererFactory, logger } =
-				createMockDependencies();
-
-			const publicDir = path.join(TMP_DIR, 'src', 'public');
-			const distDir = AppConfig.absolutePaths.distDir;
-			fs.mkdirSync(publicDir, { recursive: true });
-			fs.mkdirSync(path.join(distDir, '.server-modules-meta'), { recursive: true });
-			fs.writeFileSync(path.join(publicDir, 'site.css'), 'body { color: red; }');
-			fs.writeFileSync(path.join(distDir, '.server-modules-meta', 'stale.js'), 'stale');
-
-			const builder = new ServerStaticBuilder({
-				appConfig: AppConfig,
-				staticSiteGenerator: StaticSiteGenerator,
-				serveOptions: ServeOptions,
-				logger,
-			});
-
-			await builder.build(undefined, {
-				router: Router,
-				routeRendererFactory: RouteRendererFactory,
-			});
-
-			expect(fs.existsSync(path.join(distDir, '.server-modules-meta'))).toBe(false);
-			expect(fs.readFileSync(path.join(distDir, 'site.css'), 'utf8')).toBe('body { color: red; }');
-		});
-	});
-});

package/src/build/build-adapter-serialization.test.ts

@@ -1,268 +0,0 @@
-import assert from 'node:assert/strict';
-import path from 'node:path';
-import { afterEach, test, vi } from 'vitest';
-import { createAppBuildExecutor, createOrReuseAppBuildExecutor, DevBuildCoordinator } from './dev-build-coordinator.ts';
-import { EsbuildBuildAdapter } from './esbuild-build-adapter.ts';
-
-function createBuildResult(entryPoint: string) {
-	const label = path.basename(entryPoint).replace(/\.[^.]+$/u, '');
-	return {
-		success: true,
-		logs: [],
-		outputs: [{ path: `/tmp/out/${label}.js` }],
-	};
-}
-
-afterEach(() => {
-	vi.restoreAllMocks();
-});
-
-test('DevBuildCoordinator serializes concurrent build calls from overlapping callers', async () => {
-	let activeBuilds = 0;
-	let maxActiveBuilds = 0;
-	const order: string[] = [];
-	const adapter = new EsbuildBuildAdapter();
-	vi.spyOn(adapter, 'buildOrThrow').mockImplementation(async (options) => {
-		const entryPoint = options.entrypoints[0] ?? 'unknown';
-		const label = path.basename(entryPoint);
-
-		activeBuilds += 1;
-		maxActiveBuilds = Math.max(maxActiveBuilds, activeBuilds);
-		order.push(`start:${label}`);
-
-		await new Promise((resolve) => setTimeout(resolve, 25));
-
-		order.push(`end:${label}`);
-		activeBuilds -= 1;
-
-		return createBuildResult(entryPoint);
-	});
-	const coordinator = new DevBuildCoordinator(adapter);
-
-	const [firstBuild, secondBuild] = await Promise.all([
-		coordinator.build({
-			entrypoints: ['/tmp/first.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'node',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		}),
-		coordinator.build({
-			entrypoints: ['/tmp/second.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'node',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		}),
-	]);
-
-	assert.equal(firstBuild.success, true);
-	assert.equal(secondBuild.success, true);
-	assert.equal(maxActiveBuilds, 1);
-	assert.deepEqual(order, ['start:first.ts', 'end:first.ts', 'start:second.ts', 'end:second.ts']);
-});
-
-test('DevBuildCoordinator resets and retries after an esbuild protocol failure', async () => {
-	const adapter = new EsbuildBuildAdapter();
-	const buildOrThrow = vi
-		.spyOn(adapter, 'buildOrThrow')
-		.mockRejectedValueOnce(new Error('Unexpected end of JSON input'))
-		.mockResolvedValueOnce(createBuildResult('/tmp/recovered.ts'));
-	const stopEsbuildService = vi.spyOn(adapter, 'stopEsbuildService').mockResolvedValue(undefined);
-	const coordinator = new DevBuildCoordinator(adapter);
-
-	const result = await coordinator.build({
-		entrypoints: ['/tmp/recovered.ts'],
-		root: '/tmp',
-		outdir: '/tmp/out',
-		target: 'node',
-		format: 'esm',
-		sourcemap: 'none',
-		splitting: false,
-		minify: false,
-	});
-
-	assert.equal(result.success, true);
-	assert.equal(buildOrThrow.mock.calls.length, 2);
-	assert.equal(stopEsbuildService.mock.calls.length, 1);
-	assert.deepEqual(result.outputs, [{ path: '/tmp/out/recovered.js' }]);
-});
-
-test('DevBuildCoordinator recycles the esbuild service before the next serialized development build', async () => {
-	const adapter = new EsbuildBuildAdapter();
-	const buildOrThrow = vi
-		.spyOn(adapter, 'buildOrThrow')
-		.mockImplementation(async (options) => createBuildResult(options.entrypoints[0] ?? 'unknown'));
-	const stopEsbuildService = vi.spyOn(adapter, 'stopEsbuildService').mockResolvedValue(undefined);
-
-	const previousNodeEnv = process.env.NODE_ENV;
-	process.env.NODE_ENV = 'development';
-
-	try {
-		const coordinator = new DevBuildCoordinator(adapter);
-
-		const firstBuild = await coordinator.build({
-			entrypoints: ['/tmp/first.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'node',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		});
-
-		const secondBuild = await coordinator.build({
-			entrypoints: ['/tmp/second.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'node',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		});
-
-		assert.equal(firstBuild.success, true);
-		assert.equal(secondBuild.success, true);
-		assert.equal(buildOrThrow.mock.calls.length, 2);
-		assert.equal(stopEsbuildService.mock.calls.length, 1);
-	} finally {
-		process.env.NODE_ENV = previousNodeEnv;
-	}
-});
-
-test('DevBuildCoordinator does not recycle the esbuild service between serialized browser builds', async () => {
-	const adapter = new EsbuildBuildAdapter();
-	const buildOrThrow = vi
-		.spyOn(adapter, 'buildOrThrow')
-		.mockImplementation(async (options) => createBuildResult(options.entrypoints[0] ?? 'unknown'));
-	const stopEsbuildService = vi.spyOn(adapter, 'stopEsbuildService').mockResolvedValue(undefined);
-
-	const previousNodeEnv = process.env.NODE_ENV;
-	process.env.NODE_ENV = 'development';
-
-	try {
-		const coordinator = new DevBuildCoordinator(adapter);
-
-		await coordinator.build({
-			entrypoints: ['/tmp/first.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'browser',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		});
-
-		await coordinator.build({
-			entrypoints: ['/tmp/second.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'browser',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		});
-
-		assert.equal(buildOrThrow.mock.calls.length, 2);
-		assert.equal(stopEsbuildService.mock.calls.length, 0);
-	} finally {
-		process.env.NODE_ENV = previousNodeEnv;
-	}
-});
-
-test('DevBuildCoordinator can recover from a raw esbuild protocol fault', async () => {
-	const adapter = new EsbuildBuildAdapter();
-	const stopEsbuildService = vi.spyOn(adapter, 'stopEsbuildService').mockResolvedValue(undefined);
-	const coordinator = new DevBuildCoordinator(adapter);
-
-	const handled = await coordinator.recoverFromProtocolFault(new Error('Unexpected end of JSON input'));
-
-	assert.equal(handled, true);
-	assert.equal(stopEsbuildService.mock.calls.length, 1);
-});
-
-test('DevBuildCoordinator ignores non-esbuild runtime faults', async () => {
-	const adapter = new EsbuildBuildAdapter();
-	const stopEsbuildService = vi.spyOn(adapter, 'stopEsbuildService').mockResolvedValue(undefined);
-	const coordinator = new DevBuildCoordinator(adapter);
-
-	const handled = await coordinator.recoverFromProtocolFault(new Error('Something else failed'));
-
-	assert.equal(handled, false);
-	assert.equal(stopEsbuildService.mock.calls.length, 0);
-});
-
-test('DevBuildCoordinator recovery clears a wedged serialized build queue', async () => {
-	const adapter = new EsbuildBuildAdapter();
-	vi.spyOn(adapter, 'stopEsbuildService').mockResolvedValue(undefined);
-	const coordinator = new DevBuildCoordinator(adapter);
-	coordinator.setBuildQueueForTests(new Promise<void>(() => undefined));
-
-	const handled = await coordinator.recoverFromProtocolFault(new Error('Unexpected end of JSON input'));
-
-	assert.equal(handled, true);
-	await assert.doesNotReject(async () => {
-		await coordinator.getBuildQueueForTests();
-	});
-});
-
-test('createOrReuseAppBuildExecutor preserves serialization when rewrapping a dev executor', async () => {
-	let activeBuilds = 0;
-	let maxActiveBuilds = 0;
-	const adapter = new EsbuildBuildAdapter();
-	vi.spyOn(adapter, 'buildOrThrow').mockImplementation(async (options) => {
-		activeBuilds += 1;
-		maxActiveBuilds = Math.max(maxActiveBuilds, activeBuilds);
-
-		await new Promise((resolve) => setTimeout(resolve, 25));
-
-		activeBuilds -= 1;
-		return createBuildResult(options.entrypoints[0] ?? 'unknown');
-	});
-
-	const bootstrapExecutor = createAppBuildExecutor({
-		development: true,
-		adapter,
-	});
-	const runtimeExecutor = createOrReuseAppBuildExecutor({
-		development: true,
-		adapter,
-		currentExecutor: bootstrapExecutor,
-		getPlugins: () => [],
-	});
-
-	await Promise.all([
-		bootstrapExecutor.build({
-			entrypoints: ['/tmp/bootstrap.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'node',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		}),
-		runtimeExecutor.build({
-			entrypoints: ['/tmp/runtime.ts'],
-			root: '/tmp',
-			outdir: '/tmp/out',
-			target: 'node',
-			format: 'esm',
-			sourcemap: 'none',
-			splitting: false,
-			minify: false,
-		}),
-	]);
-
-	assert.equal(maxActiveBuilds, 1);
-});