@ecopages/core 0.2.0-alpha.24 → 0.2.0-alpha.26

package/src/build/build-manifest.ts

@@ -1,54 +0,0 @@
-import type { EcoBuildPlugin } from './build-types.ts';
-
-export interface AppBuildManifest {
-	loaderPlugins: EcoBuildPlugin[];
-	runtimePlugins: EcoBuildPlugin[];
-	browserBundlePlugins: EcoBuildPlugin[];
-}
-
-/**
- * Merges plugin lists while preserving first-registration precedence by name.
- *
- * @remarks
- * Build manifests treat plugin names as stable identities. The first plugin
- * with a given name wins so config-time assembly stays deterministic across
- * loader, runtime, and browser buckets.
- */
-export function mergeEcoBuildPlugins(...pluginLists: Array<EcoBuildPlugin[] | undefined>): EcoBuildPlugin[] {
-	const byName = new Map<string, EcoBuildPlugin>();
-
-	for (const plugins of pluginLists) {
-		for (const plugin of plugins ?? []) {
-			if (!byName.has(plugin.name)) {
-				byName.set(plugin.name, plugin);
-			}
-		}
-	}
-
-	return Array.from(byName.values());
-}
-
-/**
- * Creates one app-owned build manifest from the supplied plugin buckets.
- */
-export function createAppBuildManifest(input?: Partial<AppBuildManifest>): AppBuildManifest {
-	return {
-		loaderPlugins: mergeEcoBuildPlugins(input?.loaderPlugins),
-		runtimePlugins: mergeEcoBuildPlugins(input?.runtimePlugins),
-		browserBundlePlugins: mergeEcoBuildPlugins(input?.browserBundlePlugins),
-	};
-}
-
-/**
- * Returns the plugin list used for server-oriented builds.
- */
-export function getServerBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[] {
-	return mergeEcoBuildPlugins(manifest.loaderPlugins, manifest.runtimePlugins);
-}
-
-/**
- * Returns the plugin list used for browser-oriented builds.
- */
-export function getBrowserBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[] {
-	return mergeEcoBuildPlugins(manifest.loaderPlugins, manifest.runtimePlugins, manifest.browserBundlePlugins);
-}

package/src/build/build-types.ts

@@ -1,83 +0,0 @@
-/**
- * Arguments passed to a build plugin `onResolve` callback.
- */
-export type EcoBuildOnResolveArgs = {
-	path: string;
-	importer?: string;
-	namespace?: string;
-};
-
-/**
- * Result returned by a build plugin `onResolve` callback.
- */
-export type EcoBuildOnResolveResult = {
-	path?: string;
-	namespace?: string;
-	external?: boolean;
-};
-
-/**
- * Arguments passed to a build plugin `onLoad` callback.
- */
-export type EcoBuildOnLoadArgs = {
-	path: string;
-	namespace?: string;
-};
-
-/**
- * Loader kinds supported across Bun/esbuild bridge points.
- */
-export type EcoBuildLoader =
-	| 'base64'
-	| 'binary'
-	| 'copy'
-	| 'css'
-	| 'dataurl'
-	| 'empty'
-	| 'file'
-	| 'global-css'
-	| 'js'
-	| 'json'
-	| 'jsx'
-	| 'local-css'
-	| 'object'
-	| 'text'
-	| 'ts'
-	| 'tsx';
-
-/**
- * Result returned by a build plugin `onLoad` callback.
- */
-export type EcoBuildOnLoadResult = {
-	contents?: string | Uint8Array;
-	loader?: EcoBuildLoader;
-	exports?: Record<string, unknown>;
-	resolveDir?: string;
-};
-
-/**
- * Shared plugin builder contract used by Ecopages across Bun and esbuild.
- */
-export interface EcoBuildPluginBuilder {
-	onResolve(
-		options: { filter: RegExp; namespace?: string },
-		callback: (
-			args: EcoBuildOnResolveArgs,
-		) => EcoBuildOnResolveResult | undefined | Promise<EcoBuildOnResolveResult | undefined>,
-	): void;
-	onLoad(
-		options: { filter: RegExp; namespace?: string },
-		callback: (
-			args: EcoBuildOnLoadArgs,
-		) => EcoBuildOnLoadResult | undefined | Promise<EcoBuildOnLoadResult | undefined>,
-	): void;
-	module(specifier: string, callback: () => EcoBuildOnLoadResult | Promise<EcoBuildOnLoadResult>): void;
-}
-
-/**
- * Runtime-agnostic build plugin contract consumed by Ecopages processors/loaders.
- */
-export type EcoBuildPlugin = {
-	name: string;
-	setup: (build: EcoBuildPluginBuilder) => void | Promise<void>;
-};

package/src/build/dev-build-coordinator.ts

@@ -1,220 +0,0 @@
-import { appLogger } from '../global/app-logger.ts';
-import {
-	defaultBunBuildAdapter,
-	type BuildAdapter,
-	type BuildExecutor,
-	type BuildOptions,
-	type BuildResult,
-} from './build-adapter.ts';
-import { EsbuildBuildAdapter, ESBUILD_ADAPTER_BRAND } from './esbuild-build-adapter.ts';
-import { mergeEcoBuildPlugins } from './build-manifest.ts';
-import type { EcoBuildPlugin } from './build-types.ts';
-
-function isEsbuildBuildAdapter(adapter: unknown): adapter is EsbuildBuildAdapter {
-	return (
-		adapter instanceof EsbuildBuildAdapter ||
-		(typeof adapter === 'object' &&
-			adapter !== null &&
-			(adapter as Record<symbol, unknown>)[ESBUILD_ADAPTER_BRAND] === true)
-	);
-}
-
-function mergeBuildPlugins(options: BuildOptions, appPlugins: EcoBuildPlugin[]): BuildOptions {
-	if (appPlugins.length === 0) {
-		return options;
-	}
-
-	return {
-		...options,
-		plugins: mergeEcoBuildPlugins(options.plugins, appPlugins),
-	};
-}
-
-class BuildExecutorWithPlugins implements BuildExecutor {
-	private readonly executor: BuildExecutor;
-	private readonly getPlugins: () => EcoBuildPlugin[];
-
-	constructor(executor: BuildExecutor, getPlugins: () => EcoBuildPlugin[]) {
-		this.executor = executor;
-		this.getPlugins = getPlugins;
-	}
-
-	async build(options: BuildOptions): Promise<BuildResult> {
-		return await this.executor.build(mergeBuildPlugins(options, this.getPlugins()));
-	}
-
-	unwrap(): BuildExecutor {
-		return this.executor;
-	}
-}
-
-function unwrapBuildExecutor(executor: BuildExecutor): BuildExecutor {
-	if (executor instanceof BuildExecutorWithPlugins) {
-		return unwrapBuildExecutor(executor.unwrap());
-	}
-
-	return executor;
-}
-
-export function withBuildExecutorPlugins(executor: BuildExecutor, getPlugins: () => EcoBuildPlugin[]): BuildExecutor {
-	return new BuildExecutorWithPlugins(executor, getPlugins);
-}
-
-/**
- * Serialized build coordinator for the shared esbuild adapter.
- *
- * The underlying adapter remains responsible for plain build execution. This
- * coordinator owns the policy that must be shared across callers while Bun-native
- * execution still uses the shared esbuild compatibility backend:
- *
- * - serialized access to the shared esbuild service
- * - recovery from known esbuild worker protocol faults
- *
- * Unlike the previous design, the coordinator does not monkey-patch the adapter
- * or install process-level fault handlers. The owning app/runtime passes this
- * executor explicitly to build consumers that need coordinated builds.
- */
-export class DevBuildCoordinator implements BuildExecutor {
-	private buildQueue: Promise<void> = Promise.resolve();
-	private esbuildSessionWarm = false;
-	private esbuildModuleGeneration = 0;
-	private readonly adapter: EsbuildBuildAdapter;
-
-	constructor(adapter: EsbuildBuildAdapter) {
-		this.adapter = adapter;
-	}
-
-	/**
-	 * Executes a build through the serialized development queue.
-	 *
-	 * If an esbuild protocol fault is detected, the coordinator resets the queue,
-	 * stops the corrupted service, increments the module generation, and retries
-	 * the build once.
-	 */
-	async build(options: BuildOptions): Promise<BuildResult> {
-		return this.runSerialized(async () => {
-			try {
-				const result = await this.adapter.buildOrThrow(options, this.esbuildModuleGeneration);
-				this.esbuildSessionWarm = true;
-				return result;
-			} catch (error) {
-				if (await this.recoverFromProtocolFault(error)) {
-					appLogger.warn('Recovered from esbuild protocol fault. Retrying build.');
-					try {
-						const retry = await this.adapter.buildOrThrow(options, this.esbuildModuleGeneration);
-						this.esbuildSessionWarm = true;
-						return retry;
-					} catch (retryError) {
-						return this.adapter.createFailureResult(retryError);
-					}
-				}
-				return this.adapter.createFailureResult(error);
-			}
-		});
-	}
-
-	/**
-	 * Attempts recovery from a known esbuild worker protocol fault.
-	 *
-	 * Returns `true` only when the error matches the protocol-fault signature and
-	 * the coordinator successfully reset its shared state.
-	 */
-	async recoverFromProtocolFault(error: unknown): Promise<boolean> {
-		if (!this.adapter.isEsbuildProtocolError(error)) {
-			return false;
-		}
-		this.buildQueue = Promise.resolve();
-		this.esbuildSessionWarm = false;
-		await this.adapter.stopEsbuildService(this.esbuildModuleGeneration);
-		this.esbuildModuleGeneration += 1;
-		return true;
-	}
-
-	/**
-	 * Clears internal coordinator state for isolated tests.
-	 */
-	resetForTests(): void {
-		this.buildQueue = Promise.resolve();
-		this.esbuildSessionWarm = false;
-		this.esbuildModuleGeneration = 0;
-	}
-
-	/**
-	 * Overrides the internal queue promise for fault-recovery tests.
-	 */
-	setBuildQueueForTests(queue: Promise<void>): void {
-		this.buildQueue = queue;
-	}
-
-	/**
-	 * Returns the current internal queue promise for fault-recovery tests.
-	 */
-	getBuildQueueForTests(): Promise<void> {
-		return this.buildQueue;
-	}
-
-	private async runSerialized<T>(operation: () => Promise<T>): Promise<T> {
-		let releaseBuild: (() => void) | undefined;
-		const currentBuild = new Promise<void>((resolve) => {
-			releaseBuild = resolve;
-		});
-		const previousBuild = this.buildQueue;
-
-		this.buildQueue = previousBuild.catch(() => undefined).then(async () => await currentBuild);
-		await previousBuild.catch(() => undefined);
-
-		try {
-			return await operation();
-		} finally {
-			releaseBuild?.();
-		}
-	}
-}
-
-/**
- * Creates the appropriate build executor for one app/runtime instance.
- *
- * Bun-native esbuild execution always uses the compatibility coordinator so
- * preview/static generation and development flows share the same serialized
- * access and protocol-fault recovery policy. Host-owned execution stays on the
- * plain adapter boundary.
- */
-export function createAppBuildExecutor(options: {
-	development: boolean;
-	adapter?: BuildAdapter;
-	getPlugins?: () => EcoBuildPlugin[];
-}): BuildExecutor {
-	const adapter = options.adapter ?? defaultBunBuildAdapter;
-	const baseExecutor = isEsbuildBuildAdapter(adapter)
-		? new DevBuildCoordinator(adapter as EsbuildBuildAdapter)
-		: adapter;
-
-	if (!options.getPlugins) {
-		return baseExecutor;
-	}
-
-	return new BuildExecutorWithPlugins(baseExecutor, options.getPlugins);
-}
-
-export function createOrReuseAppBuildExecutor(options: {
-	development: boolean;
-	adapter?: BuildAdapter;
-	currentExecutor?: BuildExecutor;
-	getPlugins?: () => EcoBuildPlugin[];
-}): BuildExecutor {
-	const adapter = options.adapter ?? defaultBunBuildAdapter;
-	const currentBaseExecutor = options.currentExecutor ? unwrapBuildExecutor(options.currentExecutor) : undefined;
-	const baseExecutor =
-		options.development && currentBaseExecutor instanceof DevBuildCoordinator
-			? currentBaseExecutor
-			: createAppBuildExecutor({
-					development: options.development,
-					adapter,
-				});
-
-	if (!options.getPlugins) {
-		return baseExecutor;
-	}
-
-	return withBuildExecutorPlugins(baseExecutor, options.getPlugins);
-}