@ecopages/core 0.2.0-alpha.8 → 0.2.1-beta.0

package/src/adapters/bun/server-lifecycle.ts

@@ -1,124 +0,0 @@
-import { getBunRuntime } from '../../utils/runtime.ts';
-import { appLogger } from '../../global/app-logger';
-import type { EcoPagesAppConfig } from '../../internal-types';
-import type { EcoBuildPlugin } from '../../build/build-types.ts';
-import { StaticSiteGenerator } from '../../static-site-generator/static-site-generator';
-import type { ClientBridge } from './client-bridge';
-import type { HmrManager } from './hmr-manager';
-import {
-	bindSharedRuntimeHmrManager,
-	initializeSharedRuntimePlugins,
-	prepareSharedRuntimePublicDir,
-	startSharedProjectWatching,
-} from '../shared/runtime-bootstrap.ts';
-
-export interface WatcherCallbacks {
-	refreshRouterRoutesCallback: () => Promise<void>;
-}
-
-export interface ServerLifecycleParams {
-	appConfig: EcoPagesAppConfig;
-	runtimeOrigin: string;
-	hmrManager: HmrManager;
-	bridge: ClientBridge;
-}
-
-/**
- * Coordinates Bun-runtime server startup side effects for one app instance.
- *
- * @remarks
- * This class keeps runtime-only concerns together: build-runtime bootstrapping,
- * Bun loader registration, public asset preparation, plugin setup, and file
- * watching. Core config/build state is expected to already be finalized before
- * this lifecycle runs.
- */
-export class ServerLifecycle {
-	private readonly appConfig: EcoPagesAppConfig;
-	private readonly hmrManager: HmrManager;
-	private readonly bridge: ClientBridge;
-	private readonly runtimeOrigin: string;
-	private staticSiteGenerator!: StaticSiteGenerator;
-
-	constructor({ appConfig, runtimeOrigin, hmrManager, bridge }: ServerLifecycleParams) {
-		this.appConfig = appConfig;
-		this.runtimeOrigin = runtimeOrigin;
-		this.hmrManager = hmrManager;
-		this.bridge = bridge;
-	}
-
-	/**
-	 * Initializes the runtime services that Bun startup depends on.
-	 *
-	 * @returns The static-site generator instance reused by the adapter.
-	 */
-	async initialize(): Promise<StaticSiteGenerator> {
-		this.staticSiteGenerator = new StaticSiteGenerator({ appConfig: this.appConfig });
-		await this.hmrManager.buildRuntime();
-
-		this.setupLoaders();
-		prepareSharedRuntimePublicDir(this.appConfig);
-
-		return this.staticSiteGenerator;
-	}
-
-	/**
-	 * Registers config-owned build loaders with Bun's runtime plugin API.
-	 *
-	 * @remarks
-	 * Bun remains responsible only for transport-level plugin registration here.
-	 * Loader ownership and composition were already finalized during config build.
-	 */
-	setupLoaders(): void {
-		const loaders = this.appConfig.loaders;
-		for (const loader of loaders.values()) {
-			getBunRuntime()?.plugin(loader as any);
-		}
-	}
-
-	/**
-	 * Runs runtime-only processor and integration setup for this Bun app session.
-	 *
-	 * @param options.watch Whether watch mode is enabled.
-	 * @returns The browser build plugins visible to HMR after runtime setup.
-	 */
-	async initializePlugins(options?: { watch?: boolean }): Promise<EcoBuildPlugin[]> {
-		try {
-			const hmrEnabled = !!options?.watch;
-			this.hmrManager.setEnabled(hmrEnabled);
-
-			await initializeSharedRuntimePlugins({
-				appConfig: this.appConfig,
-				runtimeOrigin: this.runtimeOrigin,
-				hmrManager: this.hmrManager,
-				onRuntimePlugin: (plugin) => {
-					getBunRuntime()?.plugin(plugin as any);
-				},
-			});
-
-			return bindSharedRuntimeHmrManager(this.appConfig, this.hmrManager);
-		} catch (error) {
-			appLogger.error(`Failed to initialize plugins: ${error instanceof Error ? error.message : String(error)}`);
-			throw error;
-		}
-	}
-
-	/**
-	 * Starts file watching and wires change events back into the adapter refresh
-	 * callback.
-	 */
-	async startWatching(callbacks: WatcherCallbacks): Promise<void> {
-		await startSharedProjectWatching({
-			appConfig: this.appConfig,
-			refreshRouterRoutesCallback: callbacks.refreshRouterRoutesCallback,
-			hmrManager: this.hmrManager,
-			bridge: this.bridge,
-		});
-	}
-
-	/**
-	 * Returns the static-site generator created during initialization.
-	 */
-	getStaticSiteGenerator(): StaticSiteGenerator {
-		return this.staticSiteGenerator;
-	}
-}

package/src/adapters/index.ts

@@ -1,6 +0,0 @@
-export { EcopagesApp, createApp } from './bun/create-app.ts';
-export { defineApiHandler, defineGroupHandler, type GroupHandler } from './shared/define-api-handler.ts';
-export { NodeServerAdapter, createNodeServerAdapter } from './node/server-adapter.ts';
-export { EcopagesApp as NodeAdapterEcopagesApp, createNodeApp } from './node/create-app.ts';
-export type { NodeServerAdapterParams, NodeServerAdapterResult } from './node/server-adapter.ts';
-export type { EcopagesAppOptions as NodeEcopagesAppOptions } from './node/create-app.ts';

package/src/adapters/node/bootstrap-dependency-resolver.d.ts

@@ -1,44 +0,0 @@
-import type { EcoBuildOnResolveArgs, EcoBuildOnResolveResult, EcoBuildPlugin } from '../../build/build-types.js';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { NodeRuntimeManifest } from '../../services/runtime-manifest/node-runtime-manifest.service.js';
-/**
- * Returns the runtime-local node_modules directory used by the Node thin-host
- * bootstrap output.
- */
-export declare function getNodeRuntimeNodeModulesDir(manifest: NodeRuntimeManifest): string;
-/**
- * Returns the app-local node_modules directory used by framework-owned Node
- * bootstrap loads outside the thin-host manifest path.
- */
-export declare function getAppRuntimeNodeModulesDir(appConfig: Pick<EcoPagesAppConfig, 'rootDir' | 'workDir' | 'absolutePaths'>): string;
-export interface NodeBootstrapResolutionOptions {
-    projectDir: string;
-    runtimeNodeModulesDir: string;
-    preserveImportMetaPaths?: string[];
-}
-/**
- * Builds the user-facing error for Bun-native imports that cannot run on the
- * Node thin-host bootstrap path.
- */
-export declare function getNodeUnsupportedBuiltinError(specifier: string, importer?: string): string;
-/**
- * Resolves one bare specifier encountered while bundling Node thin-host
- * bootstrap modules.
- *
- * Workspace-owned `@ecopages/*` packages stay in the bundle graph so Node does
- * not execute their source files directly. Third-party packages stay external,
- * but are linked into the runtime-local `node_modules` tree so the generated
- * bootstrap output resolves them from a deterministic location.
- */
-export declare function resolveNodeBootstrapDependency(args: Pick<EcoBuildOnResolveArgs, 'path' | 'importer'>, options: NodeBootstrapResolutionOptions): EcoBuildOnResolveResult | undefined;
-/**
- * Creates the bootstrap-time resolver plugin used by the Node thin-host
- * adapter for config and entry module loading.
- */
-export declare function createNodeBootstrapPlugin(options: NodeBootstrapResolutionOptions): EcoBuildPlugin;
-/**
- * Creates the standard Node bootstrap plugin for one finalized app config.
- */
-export declare function createAppNodeBootstrapPlugin(appConfig: Pick<EcoPagesAppConfig, 'rootDir' | 'workDir' | 'absolutePaths'>, options?: {
-    preserveImportMetaPaths?: string[];
-}): EcoBuildPlugin;

package/src/adapters/node/bootstrap-dependency-resolver.js

@@ -1,172 +0,0 @@
-import path from "node:path";
-import { existsSync, mkdirSync, readFileSync, symlinkSync } from "node:fs";
-import { createRequire } from "node:module";
-import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
-function getNodeRuntimeNodeModulesDir(manifest) {
-  return path.join(
-    resolveInternalExecutionDir({
-      rootDir: manifest.appRootDir,
-      workDir: manifest.workDir,
-      absolutePaths: {
-        workDir: manifest.workDir,
-        distDir: manifest.distDir
-      }
-    }),
-    "node_modules"
-  );
-}
-function getAppRuntimeNodeModulesDir(appConfig) {
-  return path.join(resolveInternalExecutionDir(appConfig), "node_modules");
-}
-function getPackageNameFromSpecifier(specifier) {
-  if (specifier.startsWith("@")) {
-    const [scope, name] = specifier.split("/");
-    return `${scope}/${name}`;
-  }
-  return specifier.split("/")[0] ?? specifier;
-}
-function findPackageRoot(resolvedPath) {
-  let currentPath = path.dirname(resolvedPath);
-  while (true) {
-    const packageJsonPath = path.join(currentPath, "package.json");
-    if (existsSync(packageJsonPath)) {
-      return currentPath;
-    }
-    const parentPath = path.dirname(currentPath);
-    if (parentPath === currentPath) {
-      throw new Error(`Could not find package root for resolved dependency path: ${resolvedPath}`);
-    }
-    currentPath = parentPath;
-  }
-}
-function ensureRuntimePackageLink(nodeModulesDir, specifier, resolvedPath) {
-  const packageName = getPackageNameFromSpecifier(specifier);
-  const packageRoot = findPackageRoot(resolvedPath);
-  const linkPath = path.join(nodeModulesDir, packageName);
-  if (existsSync(linkPath)) {
-    return;
-  }
-  mkdirSync(path.dirname(linkPath), { recursive: true });
-  symlinkSync(packageRoot, linkPath, "dir");
-}
-function getNodeUnsupportedBuiltinError(specifier, importer) {
-  return `Node thin-host bootstrap does not support Bun builtin specifier ${JSON.stringify(specifier)}${importer ? ` imported from ${importer}` : ""}.`;
-}
-function shouldResolveFromImporter(importer) {
-  return Boolean(importer && importer.includes(`${path.sep}node_modules${path.sep}`));
-}
-function getBootstrapBuildLoaderForPath(filePath) {
-  switch (path.extname(filePath).toLowerCase()) {
-    case ".ts":
-    case ".mts":
-    case ".cts":
-      return "ts";
-    case ".tsx":
-      return "tsx";
-    case ".jsx":
-      return "jsx";
-    case ".json":
-      return "json";
-    default:
-      return "js";
-  }
-}
-const REEXPORT_FROM_STATEMENT_PATTERN = /^\s*export\s+(?!type\b)(?:\*|\{[\s\S]*?\})\s+from\s+(['"][^'"]+['"])\s*;?\s*$/gm;
-function injectBootstrapReexportImports(source) {
-  const sideEffectImports = [];
-  const importedSpecifiers = /* @__PURE__ */ new Set();
-  let importIndex = 0;
-  const rewrittenSource = source.replace(REEXPORT_FROM_STATEMENT_PATTERN, (statement, specifierLiteral) => {
-    if (!importedSpecifiers.has(specifierLiteral)) {
-      importedSpecifiers.add(specifierLiteral);
-      const importBinding = `__eco_bootstrap_reexport_${importIndex++}`;
-      sideEffectImports.push(`import * as ${importBinding} from ${specifierLiteral};`);
-      sideEffectImports.push(`void ${importBinding};`);
-    }
-    return statement;
-  });
-  if (sideEffectImports.length === 0) {
-    return source;
-  }
-  return `${sideEffectImports.join("\n")}
-${rewrittenSource}`;
-}
-function shouldRewriteBootstrapSource(filePath, projectDir) {
-  const normalizedPath = path.resolve(filePath);
-  const normalizedProjectDir = path.resolve(projectDir);
-  return normalizedPath.startsWith(`${normalizedProjectDir}${path.sep}`) && !normalizedPath.includes(`${path.sep}node_modules${path.sep}`);
-}
-function resolveNodeBootstrapDependency(args, options) {
-  if (args.path.startsWith("./") || args.path.startsWith("../") || args.path.startsWith("@/") || args.path.startsWith("/") || args.path.startsWith("node:")) {
-    return void 0;
-  }
-  const projectRequire = createRequire(path.join(options.projectDir, "package.json"));
-  const requireFromImporter = args.importer && path.isAbsolute(args.importer) && shouldResolveFromImporter(args.importer) ? createRequire(args.importer) : projectRequire;
-  if (args.path.startsWith("@ecopages/")) {
-    return {
-      path: requireFromImporter.resolve(args.path)
-    };
-  }
-  const resolvedPath = requireFromImporter.resolve(args.path);
-  ensureRuntimePackageLink(options.runtimeNodeModulesDir, args.path, resolvedPath);
-  return {
-    path: args.path,
-    external: true
-  };
-}
-function createNodeBootstrapPlugin(options) {
-  const projectDir = path.resolve(options.projectDir);
-  const importMetaRewritePaths = new Set(
-    (options.preserveImportMetaPaths ?? []).map((filePath) => path.resolve(filePath))
-  );
-  return {
-    name: "node-thin-host-bundle-workspace-packages",
-    setup(build) {
-      build.onResolve({ filter: /^bun:/ }, (args) => {
-        throw new Error(getNodeUnsupportedBuiltinError(args.path, args.importer));
-      });
-      build.onLoad({ filter: /\.[cm]?[jt]sx?$/ }, async (args) => {
-        const absolutePath = path.resolve(args.path);
-        const shouldPreserveImportMeta = importMetaRewritePaths.has(absolutePath);
-        const shouldRewriteReexports = shouldRewriteBootstrapSource(absolutePath, projectDir);
-        if (!shouldPreserveImportMeta && !shouldRewriteReexports) {
-          return void 0;
-        }
-        const originalContents = readFileSync(args.path, "utf8");
-        let contents = originalContents;
-        if (shouldPreserveImportMeta) {
-          contents = contents.replaceAll("import.meta.dirname", JSON.stringify(path.dirname(args.path))).replaceAll("import.meta.filename", JSON.stringify(args.path));
-        }
-        if (shouldRewriteReexports) {
-          contents = injectBootstrapReexportImports(contents);
-        }
-        if (contents === originalContents) {
-          return void 0;
-        }
-        return {
-          contents,
-          loader: getBootstrapBuildLoaderForPath(args.path),
-          resolveDir: path.dirname(args.path)
-        };
-      });
-      build.onResolve({ filter: /^[@A-Za-z0-9][^:]*$/ }, (args) => {
-        return resolveNodeBootstrapDependency(args, options);
-      });
-    }
-  };
-}
-function createAppNodeBootstrapPlugin(appConfig, options) {
-  return createNodeBootstrapPlugin({
-    projectDir: appConfig.rootDir,
-    runtimeNodeModulesDir: getAppRuntimeNodeModulesDir(appConfig),
-    preserveImportMetaPaths: options?.preserveImportMetaPaths
-  });
-}
-export {
-  createAppNodeBootstrapPlugin,
-  createNodeBootstrapPlugin,
-  getAppRuntimeNodeModulesDir,
-  getNodeRuntimeNodeModulesDir,
-  getNodeUnsupportedBuiltinError,
-  resolveNodeBootstrapDependency
-};

package/src/adapters/node/bootstrap-dependency-resolver.ts

@@ -1,301 +0,0 @@
-import path from 'node:path';
-import { existsSync, mkdirSync, readFileSync, symlinkSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import type { EcoBuildOnResolveArgs, EcoBuildOnResolveResult, EcoBuildPlugin } from '../../build/build-types.ts';
-import type { EcoPagesAppConfig } from '../../internal-types.ts';
-import type { NodeRuntimeManifest } from '../../services/runtime-manifest/node-runtime-manifest.service.ts';
-import { resolveInternalExecutionDir } from '../../utils/resolve-work-dir.ts';
-
-/**
- * Returns the runtime-local node_modules directory used by the Node thin-host
- * bootstrap output.
- */
-export function getNodeRuntimeNodeModulesDir(manifest: NodeRuntimeManifest): string {
-	return path.join(
-		resolveInternalExecutionDir({
-			rootDir: manifest.appRootDir,
-			workDir: manifest.workDir,
-			absolutePaths: {
-				workDir: manifest.workDir,
-				distDir: manifest.distDir,
-			},
-		}),
-		'node_modules',
-	);
-}
-
-/**
- * Returns the app-local node_modules directory used by framework-owned Node
- * bootstrap loads outside the thin-host manifest path.
- */
-export function getAppRuntimeNodeModulesDir(
-	appConfig: Pick<EcoPagesAppConfig, 'rootDir' | 'workDir' | 'absolutePaths'>,
-): string {
-	return path.join(resolveInternalExecutionDir(appConfig), 'node_modules');
-}
-
-/**
- * Derives the package root segment from a bare specifier.
- */
-function getPackageNameFromSpecifier(specifier: string): string {
-	if (specifier.startsWith('@')) {
-		const [scope, name] = specifier.split('/');
-		return `${scope}/${name}`;
-	}
-
-	return specifier.split('/')[0] ?? specifier;
-}
-
-/**
- * Walks upward from a resolved file until it finds the owning package root.
- */
-function findPackageRoot(resolvedPath: string): string {
-	let currentPath = path.dirname(resolvedPath);
-
-	while (true) {
-		const packageJsonPath = path.join(currentPath, 'package.json');
-		if (existsSync(packageJsonPath)) {
-			return currentPath;
-		}
-
-		const parentPath = path.dirname(currentPath);
-		if (parentPath === currentPath) {
-			throw new Error(`Could not find package root for resolved dependency path: ${resolvedPath}`);
-		}
-
-		currentPath = parentPath;
-	}
-}
-
-/**
- * Creates a runtime-local symlink for one external dependency package.
- *
- * @remarks
- * Node thin-host bootstrap bundles externalize third-party packages but still
- * need those packages to resolve from a deterministic runtime-local
- * `node_modules` directory. Symlinking the package root preserves that lookup
- * without copying package contents into the app cache.
- */
-function ensureRuntimePackageLink(nodeModulesDir: string, specifier: string, resolvedPath: string): void {
-	const packageName = getPackageNameFromSpecifier(specifier);
-	const packageRoot = findPackageRoot(resolvedPath);
-	const linkPath = path.join(nodeModulesDir, packageName);
-
-	if (existsSync(linkPath)) {
-		return;
-	}
-
-	mkdirSync(path.dirname(linkPath), { recursive: true });
-	symlinkSync(packageRoot, linkPath, 'dir');
-}
-
-export interface NodeBootstrapResolutionOptions {
-	projectDir: string;
-	runtimeNodeModulesDir: string;
-	preserveImportMetaPaths?: string[];
-}
-
-/**
- * Builds the user-facing error for Bun-native imports that cannot run on the
- * Node thin-host bootstrap path.
- */
-export function getNodeUnsupportedBuiltinError(specifier: string, importer?: string): string {
-	return `Node thin-host bootstrap does not support Bun builtin specifier ${JSON.stringify(specifier)}${importer ? ` imported from ${importer}` : ''}.`;
-}
-
-/**
- * Returns whether a dependency should be resolved relative to the importing
- * package instead of the app root.
- */
-function shouldResolveFromImporter(importer: string | undefined): importer is string {
-	return Boolean(importer && importer.includes(`${path.sep}node_modules${path.sep}`));
-}
-
-/**
- * Selects the build loader used when bootstrap-time source rewriting emits a
- * synthetic in-memory file.
- */
-function getBootstrapBuildLoaderForPath(filePath: string): 'js' | 'jsx' | 'json' | 'ts' | 'tsx' {
-	switch (path.extname(filePath).toLowerCase()) {
-		case '.ts':
-		case '.mts':
-		case '.cts':
-			return 'ts';
-		case '.tsx':
-			return 'tsx';
-		case '.jsx':
-			return 'jsx';
-		case '.json':
-			return 'json';
-		default:
-			return 'js';
-	}
-}
-
-const REEXPORT_FROM_STATEMENT_PATTERN =
-	/^\s*export\s+(?!type\b)(?:\*|\{[\s\S]*?\})\s+from\s+(['"][^'"]+['"])\s*;?\s*$/gm;
-
-/**
- * Prepends side-effect imports for re-export barrels during bootstrap bundling.
- *
- * @remarks
- * This keeps async module initialization observable even when the bootstrap
- * bundle only referenced the file through re-export syntax.
- */
-function injectBootstrapReexportImports(source: string): string {
-	const sideEffectImports: string[] = [];
-	const importedSpecifiers = new Set<string>();
-	let importIndex = 0;
-
-	const rewrittenSource = source.replace(REEXPORT_FROM_STATEMENT_PATTERN, (statement, specifierLiteral: string) => {
-		if (!importedSpecifiers.has(specifierLiteral)) {
-			importedSpecifiers.add(specifierLiteral);
-			const importBinding = `__eco_bootstrap_reexport_${importIndex++}`;
-			sideEffectImports.push(`import * as ${importBinding} from ${specifierLiteral};`);
-			sideEffectImports.push(`void ${importBinding};`);
-		}
-
-		return statement;
-	});
-
-	if (sideEffectImports.length === 0) {
-		return source;
-	}
-
-	return `${sideEffectImports.join('\n')}\n${rewrittenSource}`;
-}
-
-/**
- * Returns whether bootstrap source rewriting is allowed for the given file.
- *
- * @remarks
- * Re-export and `import.meta` rewrites are limited to project-owned sources so
- * third-party packages keep their original semantics.
- */
-function shouldRewriteBootstrapSource(filePath: string, projectDir: string): boolean {
-	const normalizedPath = path.resolve(filePath);
-	const normalizedProjectDir = path.resolve(projectDir);
-
-	return (
-		normalizedPath.startsWith(`${normalizedProjectDir}${path.sep}`) &&
-		!normalizedPath.includes(`${path.sep}node_modules${path.sep}`)
-	);
-}
-
-/**
- * Resolves one bare specifier encountered while bundling Node thin-host
- * bootstrap modules.
- *
- * Workspace-owned `@ecopages/*` packages stay in the bundle graph so Node does
- * not execute their source files directly. Third-party packages stay external,
- * but are linked into the runtime-local `node_modules` tree so the generated
- * bootstrap output resolves them from a deterministic location.
- */
-export function resolveNodeBootstrapDependency(
-	args: Pick<EcoBuildOnResolveArgs, 'path' | 'importer'>,
-	options: NodeBootstrapResolutionOptions,
-): EcoBuildOnResolveResult | undefined {
-	if (
-		args.path.startsWith('./') ||
-		args.path.startsWith('../') ||
-		args.path.startsWith('@/') ||
-		args.path.startsWith('/') ||
-		args.path.startsWith('node:')
-	) {
-		return undefined;
-	}
-
-	const projectRequire = createRequire(path.join(options.projectDir, 'package.json'));
-	const requireFromImporter =
-		args.importer && path.isAbsolute(args.importer) && shouldResolveFromImporter(args.importer)
-			? createRequire(args.importer)
-			: projectRequire;
-
-	if (args.path.startsWith('@ecopages/')) {
-		return {
-			path: requireFromImporter.resolve(args.path),
-		};
-	}
-
-	const resolvedPath = requireFromImporter.resolve(args.path);
-
-	ensureRuntimePackageLink(options.runtimeNodeModulesDir, args.path, resolvedPath);
-
-	return {
-		path: args.path,
-		external: true,
-	};
-}
-
-/**
- * Creates the bootstrap-time resolver plugin used by the Node thin-host
- * adapter for config and entry module loading.
- */
-export function createNodeBootstrapPlugin(options: NodeBootstrapResolutionOptions): EcoBuildPlugin {
-	const projectDir = path.resolve(options.projectDir);
-	const importMetaRewritePaths = new Set(
-		(options.preserveImportMetaPaths ?? []).map((filePath) => path.resolve(filePath)),
-	);
-
-	return {
-		name: 'node-thin-host-bundle-workspace-packages',
-		setup(build) {
-			build.onResolve({ filter: /^bun:/ }, (args) => {
-				throw new Error(getNodeUnsupportedBuiltinError(args.path, args.importer));
-			});
-
-			build.onLoad({ filter: /\.[cm]?[jt]sx?$/ }, async (args) => {
-				const absolutePath = path.resolve(args.path);
-				const shouldPreserveImportMeta = importMetaRewritePaths.has(absolutePath);
-				const shouldRewriteReexports = shouldRewriteBootstrapSource(absolutePath, projectDir);
-
-				if (!shouldPreserveImportMeta && !shouldRewriteReexports) {
-					return undefined;
-				}
-
-				const originalContents = readFileSync(args.path, 'utf8');
-				let contents = originalContents;
-
-				if (shouldPreserveImportMeta) {
-					contents = contents
-						.replaceAll('import.meta.dirname', JSON.stringify(path.dirname(args.path)))
-						.replaceAll('import.meta.filename', JSON.stringify(args.path));
-				}
-
-				if (shouldRewriteReexports) {
-					contents = injectBootstrapReexportImports(contents);
-				}
-
-				if (contents === originalContents) {
-					return undefined;
-				}
-
-				return {
-					contents,
-					loader: getBootstrapBuildLoaderForPath(args.path),
-					resolveDir: path.dirname(args.path),
-				};
-			});
-
-			build.onResolve({ filter: /^[@A-Za-z0-9][^:]*$/ }, (args) => {
-				return resolveNodeBootstrapDependency(args, options);
-			});
-		},
-	};
-}
-
-/**
- * Creates the standard Node bootstrap plugin for one finalized app config.
- */
-export function createAppNodeBootstrapPlugin(
-	appConfig: Pick<EcoPagesAppConfig, 'rootDir' | 'workDir' | 'absolutePaths'>,
-	options?: {
-		preserveImportMetaPaths?: string[];
-	},
-): EcoBuildPlugin {
-	return createNodeBootstrapPlugin({
-		projectDir: appConfig.rootDir,
-		runtimeNodeModulesDir: getAppRuntimeNodeModulesDir(appConfig),
-		preserveImportMetaPaths: options?.preserveImportMetaPaths,
-	});
-}