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

package/src/services/module-loading/app-server-module-transpiler.service.ts

@@ -0,0 +1,168 @@
+import { getAppBuildExecutor, getAppServerBuildPlugins } from '../../build/build-adapter.ts';
+import type { EcoBuildPlugin } from '../../build/build-types.ts';
+import { createForeignJsxOverridePlugin } from '../../plugins/foreign-jsx-override-plugin.ts';
+import path from 'node:path';
+import type { EcoPagesAppConfig } from '../../types/internal-types.ts';
+import { DevelopmentInvalidationService } from '../invalidation/development-invalidation.service.ts';
+import { type AppModuleLoader, type AppModuleLoaderOwner } from './app-module-loader.service.ts';
+import { PageModuleImportService, type PageModuleBuildImportOptions } from './page-module-import.service.ts';
+import type { SourceModuleLoader } from './module-loading-types.ts';
+import { supportsSourceModuleLoading } from './source-module-support.ts';
+import { ServerModuleTranspiler } from './server-module-transpiler.service.ts';
+
+export function shouldAppUseHostModuleLoader(appConfig: EcoPagesAppConfig, filePath: string): boolean {
+	if (appConfig.runtime?.hostModuleLoader) {
+		return supportsSourceModuleLoading(filePath);
+	}
+
+	const normalizedFilePath = path.normalize(filePath);
+	const frameworkOwnedDirectories = [
+		appConfig.absolutePaths.pagesDir,
+		appConfig.absolutePaths.includesDir,
+		appConfig.absolutePaths.layoutsDir,
+		appConfig.absolutePaths.componentsDir,
+	].map((directoryPath) => path.normalize(directoryPath));
+	const isFrameworkOwnedModule = frameworkOwnedDirectories.some((directoryPath) => {
+		return normalizedFilePath === directoryPath || normalizedFilePath.startsWith(`${directoryPath}${path.sep}`);
+	});
+	const isConfiguredTemplateModule = appConfig.templatesExt.some((extension) =>
+		normalizedFilePath.endsWith(extension),
+	);
+
+	return !(isFrameworkOwnedModule && isConfiguredTemplateModule);
+}
+
+export function getAppHostModuleLoader(appConfig: EcoPagesAppConfig): SourceModuleLoader | undefined {
+	return appConfig.runtime?.hostModuleLoader;
+}
+
+function getAppModuleLoaderOwner(appConfig: EcoPagesAppConfig): AppModuleLoaderOwner {
+	return getAppHostModuleLoader(appConfig) ? 'host' : 'app';
+}
+
+export function setAppHostModuleLoader(appConfig: EcoPagesAppConfig, hostModuleLoader?: SourceModuleLoader): void {
+	appConfig.runtime = {
+		...(appConfig.runtime ?? {}),
+		hostModuleLoader,
+	};
+}
+
+function getJsxOwnershipPlugins(appConfig: EcoPagesAppConfig): EcoBuildPlugin[] {
+	const jsxExtensions = (appConfig.integrations ?? [])
+		.filter((integration) => integration.jsxImportSource)
+		.flatMap((integration) =>
+			integration.extensions
+				.filter((extension) => extension.endsWith('.tsx') || extension.endsWith('.jsx'))
+				.map((extension) => ({ integration, extension })),
+		)
+		.sort((left, right) => right.extension.length - left.extension.length);
+
+	return jsxExtensions.map(({ integration, extension }) =>
+		createForeignJsxOverridePlugin({
+			hostJsxImportSource: integration.jsxImportSource!,
+			foreignExtensions: [extension],
+			excludeExtensions: jsxExtensions
+				.filter((candidate) => candidate.extension.length > extension.length)
+				.filter((candidate) => candidate.extension.endsWith(extension))
+				.map((candidate) => candidate.extension),
+			name: `ecopages-jsx-ownership-${integration.name}-${extension.replace(/[^a-zA-Z0-9]+/g, '-')}`,
+		}),
+	);
+}
+
+export function createAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader {
+	const invalidationService = new DevelopmentInvalidationService(appConfig);
+	const pageModuleImportService = new PageModuleImportService({
+		canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
+		getHostModuleLoader: () => getAppHostModuleLoader(appConfig),
+	});
+	const appServerBuildPlugins = appConfig.runtime?.buildManifest
+		? getAppServerBuildPlugins(appConfig)
+		: Array.from(appConfig.loaders?.values() ?? []);
+	const jsxOwnershipPlugins = getJsxOwnershipPlugins(appConfig);
+	const appModuleLoader: AppModuleLoader & {
+		pageModuleImportService: PageModuleImportService;
+	} = {
+		get owner(): AppModuleLoaderOwner {
+			return getAppModuleLoaderOwner(appConfig);
+		},
+		pageModuleImportService,
+		async importModule<T = unknown>(options: PageModuleBuildImportOptions) {
+			const invalidationVersion =
+				options.invalidationVersion ?? invalidationService.getServerModuleInvalidationVersion();
+			const mergedPlugins = [...appServerBuildPlugins, ...jsxOwnershipPlugins, ...(options.plugins ?? [])];
+
+			return await pageModuleImportService.importModule<T>({
+				...options,
+				...(mergedPlugins.length > 0 ? { plugins: mergedPlugins } : {}),
+				buildExecutor: options.buildExecutor ?? getAppBuildExecutor(appConfig),
+				invalidationVersion,
+			});
+		},
+		invalidateDevelopmentGraph() {
+			pageModuleImportService.invalidateDevelopmentGraph();
+		},
+	};
+
+	return appModuleLoader;
+}
+
+export function getAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader {
+	const existingModuleLoader = appConfig.runtime?.appModuleLoader;
+	if (existingModuleLoader) {
+		return existingModuleLoader;
+	}
+
+	const appModuleLoader = createAppModuleLoader(appConfig);
+	setAppModuleLoader(appConfig, appModuleLoader);
+	return appModuleLoader;
+}
+
+export function setAppModuleLoader(appConfig: EcoPagesAppConfig, appModuleLoader: AppModuleLoader): void {
+	appConfig.runtime = {
+		...(appConfig.runtime ?? {}),
+		appModuleLoader,
+	};
+}
+
+/**
+ * Creates the shared app-scoped server-module transpiler for one runtime
+ * instance.
+ */
+export function createAppServerModuleTranspiler(appConfig: EcoPagesAppConfig): ServerModuleTranspiler {
+	const invalidationService = new DevelopmentInvalidationService(appConfig);
+
+	return new ServerModuleTranspiler({
+		rootDir: appConfig.rootDir,
+		invalidateModules: (changedFiles) => invalidationService.invalidateServerModules(changedFiles),
+		pageModuleImportService: getAppModuleLoader(appConfig),
+	});
+}
+
+/**
+ * Returns the app-owned server-module transpiler, creating it lazily when the
+ * runtime first needs one.
+ */
+export function getAppServerModuleTranspiler(appConfig: EcoPagesAppConfig): ServerModuleTranspiler {
+	const existingTranspiler = appConfig.runtime?.serverModuleTranspiler;
+	if (existingTranspiler) {
+		return existingTranspiler;
+	}
+
+	const serverModuleTranspiler = createAppServerModuleTranspiler(appConfig);
+	setAppServerModuleTranspiler(appConfig, serverModuleTranspiler);
+	return serverModuleTranspiler;
+}
+
+/**
+ * Installs the server-module transpiler that should serve one app instance.
+ */
+export function setAppServerModuleTranspiler(
+	appConfig: EcoPagesAppConfig,
+	serverModuleTranspiler: ServerModuleTranspiler,
+): void {
+	appConfig.runtime = {
+		...(appConfig.runtime ?? {}),
+		serverModuleTranspiler,
+	};
+}

package/src/services/module-loading/host-module-loader-registry.ts

@@ -0,0 +1,15 @@
+import type { SourceModuleLoader } from './module-loading-types.ts';
+
+let hostModuleLoader: SourceModuleLoader | undefined;
+
+export function setHostModuleLoader(loader: SourceModuleLoader): void {
+	hostModuleLoader = loader;
+}
+
+export function getHostModuleLoader(): SourceModuleLoader | undefined {
+	return hostModuleLoader;
+}
+
+export function clearHostModuleLoader(): void {
+	hostModuleLoader = undefined;
+}

package/src/services/module-loading/{module-loading-types.d.ts → module-loading-types.ts}

@@ -1,2 +1,3 @@
 export type SourceModuleLoader = (id: string) => Promise<unknown>;
+
 export type SourceModuleLoaderFactory = () => SourceModuleLoader | undefined;