@ecopages/core 0.2.0-alpha.8 → 0.2.1

package/src/services/assets/asset-processing-service/index.js

@@ -1,5 +1,5 @@
-export * from "./asset.factory";
-export * from "./asset-processing.service";
-export * from "./assets.types";
-export * from "./browser-runtime-asset.factory";
-export * from "./browser-runtime-entry.factory";
+export * from "./asset.factory.js";
+export * from "./asset-processing.service.js";
+export * from "./assets.types.js";
+export * from "./browser-runtime-asset.factory.js";
+export * from "./browser-runtime-entry.factory.js";

package/src/services/assets/asset-processing-service/processor.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IHmrManager } from '../../../internal-types';
-import type { AssetDefinition, ProcessedAsset } from './assets.types';
+import type { IHmrManager } from '../../../types/internal-types.js';
+import type { AssetDefinition, ProcessedAsset } from './assets.types.js';
 /**
  * Base interface for asset processors.
  * Processors transform asset definitions into processed assets.

package/src/services/assets/asset-processing-service/processor.registry.d.ts

@@ -1,5 +1,5 @@
-import type { AssetKind, AssetSource } from './assets.types';
-import type { BaseProcessor } from './processors/base/base-processor';
+import type { AssetKind, AssetSource } from './assets.types.js';
+import type { BaseProcessor } from './processors/base/base-processor.js';
 export declare class ProcessorRegistry {
     private processors;
     register(kind: AssetKind, variant: AssetSource, processor: BaseProcessor<any>): void;

package/src/services/assets/asset-processing-service/processors/base/base-processor.d.ts

@@ -1,4 +1,4 @@
-import type { EcoPagesAppConfig } from '../../../../../internal-types.js';
+import type { EcoPagesAppConfig } from '../../../../../types/internal-types.js';
 import type { BaseAsset, ProcessedAsset } from '../../assets.types.js';
 export declare abstract class BaseProcessor<T extends BaseAsset> {
     protected appConfig: EcoPagesAppConfig;

package/src/services/assets/asset-processing-service/processors/base/base-processor.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { RESOLVED_ASSETS_DIR } from "../../../../../constants.js";
+import { RESOLVED_ASSETS_DIR } from "../../../../../config/constants.js";
 import { rapidhash } from "../../../../../utils/hash.js";
 import { isDevelopmentRuntime, isProductionRuntime } from "../../../../../utils/runtime.js";
 import { fileSystem } from "@ecopages/file-system";

package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts

@@ -1,7 +1,7 @@
-import type { EcoPagesAppConfig } from '../../../../../internal-types';
+import type { EcoPagesAppConfig } from '../../../../../types/internal-types.js';
 import type { EcoBuildPlugin } from '../../../../../build/build-types.js';
-import type { ScriptAsset } from '../../assets.types';
-import { BaseProcessor } from './base-processor';
+import type { ScriptAsset } from '../../assets.types.js';
+import { BaseProcessor } from './base-processor.js';
 export declare abstract class BaseScriptProcessor<T extends ScriptAsset> extends BaseProcessor<T> {
     private readonly browserBundleService;
     constructor({ appConfig }: {

package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js

@@ -1,8 +1,8 @@
-import { appLogger } from "../../../../../global/app-logger";
+import { appLogger } from "../../../../../global/app-logger.js";
 import { getAppBrowserBuildPlugins } from "../../../../../build/build-adapter.js";
 import { fileSystem } from "@ecopages/file-system";
 import path from "node:path";
-import { BaseProcessor } from "./base-processor";
+import { BaseProcessor } from "./base-processor.js";
 import { BrowserBundleService } from "../../../browser-bundle.service.js";
 class BaseScriptProcessor extends BaseProcessor {
   browserBundleService;

package/src/services/assets/asset-processing-service/processors/index.d.ts

@@ -1,5 +1,5 @@
-export * from './script/content-script.processor';
-export * from './script/file-script.processor';
-export * from './script/node-module-script.processor';
-export * from './stylesheet/content-stylesheet.processor';
-export * from './stylesheet/file-stylesheet.processor';
+export * from './script/content-script.processor.js';
+export * from './script/file-script.processor.js';
+export * from './script/node-module-script.processor.js';
+export * from './stylesheet/content-stylesheet.processor.js';
+export * from './stylesheet/file-stylesheet.processor.js';

package/src/services/assets/asset-processing-service/processors/index.js

@@ -1,5 +1,5 @@
-export * from "./script/content-script.processor";
-export * from "./script/file-script.processor";
-export * from "./script/node-module-script.processor";
-export * from "./stylesheet/content-stylesheet.processor";
-export * from "./stylesheet/file-stylesheet.processor";
+export * from "./script/content-script.processor.js";
+export * from "./script/file-script.processor.js";
+export * from "./script/node-module-script.processor.js";
+export * from "./stylesheet/content-stylesheet.processor.js";
+export * from "./stylesheet/file-stylesheet.processor.js";

package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts

@@ -1,5 +1,5 @@
-import type { ContentScriptAsset, ProcessedAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
+import type { ContentScriptAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class ContentScriptProcessor extends BaseScriptProcessor<ContentScriptAsset> {
     process(dep: ContentScriptAsset): Promise<ProcessedAsset>;
 }

package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseScriptProcessor } from "../base/base-script-processor";
+import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class ContentScriptProcessor extends BaseScriptProcessor {
   async process(dep) {
     const hash = this.generateHash(dep.content);

package/src/services/assets/asset-processing-service/processors/script/file-script.processor.d.ts

@@ -1,8 +1,9 @@
-import type { IHmrManager } from '../../../../../internal-types';
-import type { FileScriptAsset, ProcessedAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
+import type { IHmrManager } from '../../../../../types/internal-types.js';
+import type { FileScriptAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class FileScriptProcessor extends BaseScriptProcessor<FileScriptAsset> {
     private hmrManager?;
+    private resolveHmrOutputFilepath;
     setHmrManager(hmrManager: IHmrManager): void;
     process(dep: FileScriptAsset): Promise<ProcessedAsset>;
 }

package/src/services/assets/asset-processing-service/processors/script/file-script.processor.js

@@ -1,17 +1,29 @@
 import path from "node:path";
-import { RESOLVED_ASSETS_DIR } from "../../../../../constants";
+import { RESOLVED_ASSETS_DIR } from "../../../../../config/constants.js";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseScriptProcessor } from "../base/base-script-processor";
+import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class FileScriptProcessor extends BaseScriptProcessor {
   hmrManager;
+  resolveHmrOutputFilepath(entrypointPath) {
+    if (!this.hmrManager || !("getDistDir" in this.hmrManager)) {
+      return void 0;
+    }
+    const getDistDir = this.hmrManager.getDistDir;
+    if (typeof getDistDir !== "function") {
+      return void 0;
+    }
+    const relativePathJs = path.relative(this.appConfig.absolutePaths.srcDir, entrypointPath).replace(/\.(tsx?|jsx?|mdx?)$/, ".js").replace(/\[([^\]]+)\]/g, "_$1_");
+    return path.join(getDistDir.call(this.hmrManager), relativePathJs);
+  }
   setHmrManager(hmrManager) {
     this.hmrManager = hmrManager;
   }
   async process(dep) {
     if (this.hmrManager?.isEnabled() && !dep.inline) {
       const outputUrl = await this.hmrManager.registerScriptEntrypoint(dep.filepath);
+      const outputFilepath = this.resolveHmrOutputFilepath(dep.filepath);
       return {
-        filepath: dep.filepath,
+        filepath: outputFilepath ?? dep.filepath,
         srcUrl: outputUrl,
         kind: "script",
         position: dep.position,

package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.d.ts

@@ -1,7 +1,7 @@
-import type { NodeModuleScriptAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
+import type { NodeModuleScriptAsset } from '../../assets.types.js';
+import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class NodeModuleScriptProcessor extends BaseScriptProcessor<NodeModuleScriptAsset> {
-    process(dep: NodeModuleScriptAsset): Promise<import("../../assets.types").ProcessedAsset>;
+    process(dep: NodeModuleScriptAsset): Promise<import("../../assets.types.js").ProcessedAsset>;
     private resolveModulePath;
     private resolveModulePathFallback;
 }

package/src/services/assets/asset-processing-service/processors/script/node-module-script.processor.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
 import { getAppBuildAdapter } from "../../../../../build/build-adapter.js";
-import { BaseScriptProcessor } from "../base/base-script-processor";
+import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class NodeModuleScriptProcessor extends BaseScriptProcessor {
   async process(dep) {
     const modulePath = this.resolveModulePath(dep.importPath, this.appConfig.rootDir);

package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.d.ts

@@ -1,5 +1,5 @@
-import type { ContentStylesheetAsset, ProcessedAsset } from '../../assets.types';
-import { BaseProcessor } from '../base/base-processor';
+import type { ContentStylesheetAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseProcessor } from '../base/base-processor.js';
 export declare class ContentStylesheetProcessor extends BaseProcessor<ContentStylesheetAsset> {
     process(dep: ContentStylesheetAsset): Promise<ProcessedAsset>;
 }

package/src/services/assets/asset-processing-service/processors/stylesheet/content-stylesheet.processor.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseProcessor } from "../base/base-processor";
+import { BaseProcessor } from "../base/base-processor.js";
 class ContentStylesheetProcessor extends BaseProcessor {
   async process(dep) {
     const hash = this.generateHash(dep.content);

package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.d.ts

@@ -1,5 +1,5 @@
-import type { FileStylesheetAsset, ProcessedAsset } from '../../assets.types';
-import { BaseProcessor } from '../base/base-processor';
+import type { FileStylesheetAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseProcessor } from '../base/base-processor.js';
 export declare class FileStylesheetProcessor extends BaseProcessor<FileStylesheetAsset> {
     private static readonly PROCESSABLE_STYLESHEET_EXTENSIONS;
     getStyleContent: (srcUrl: string) => Buffer;

package/src/services/assets/asset-processing-service/processors/stylesheet/file-stylesheet.processor.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseProcessor } from "../base/base-processor";
+import { BaseProcessor } from "../base/base-processor.js";
 class FileStylesheetProcessor extends BaseProcessor {
   static PROCESSABLE_STYLESHEET_EXTENSIONS = /* @__PURE__ */ new Set([".css", ".scss", ".sass", ".less"]);
   getStyleContent = (srcUrl) => {

package/src/services/assets/browser-bundle.service.d.ts

@@ -1,5 +1,5 @@
 import type { BuildOptions, BuildResult, BuildTranspileProfile } from '../../build/build-adapter.js';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 export type BrowserBundleOptions = Omit<BuildOptions, 'target' | 'format' | 'sourcemap'> & {
     profile: BuildTranspileProfile;
 };

package/src/services/assets/browser-bundle.service.js

@@ -1,4 +1,4 @@
-import { getAppBrowserBuildPlugins, getAppBuildExecutor, getTranspileOptions } from "../../build/build-adapter.js";
+import { getAppBrowserBuildPlugins, getAppBuildExecutor, getAppTranspileOptions } from "../../build/build-adapter.js";
 import { mergeEcoBuildPlugins } from "../../build/build-manifest.js";
 class BrowserBundleService {
   appConfig;
@@ -22,7 +22,7 @@ class BrowserBundleService {
     const plugins = buildOptions.plugins;
     const request = {
       ...buildOptions,
-      ...getTranspileOptions(profile),
+      ...getAppTranspileOptions(this.appConfig, profile),
       plugins: mergeEcoBuildPlugins(plugins, getAppBrowserBuildPlugins(this.appConfig))
     };
     return await getAppBuildExecutor(this.appConfig).build(request);

package/src/services/html/html-rewriter-provider.service.js

@@ -49,7 +49,10 @@ async function loadWorkerToolsHtmlRewriter() {
     return module.HTMLRewriter;
   } catch (primaryError) {
     try {
-      const runtimeLocalModule = await import(new URL("../node_modules/@worker-tools/html-rewriter/base64.js", import.meta.url).href);
+      const runtimeLocalModule = await import(
+        /* @vite-ignore */
+        new URL("../node_modules/@worker-tools/html-rewriter/base64.js", import.meta.url).href
+      );
       return runtimeLocalModule.HTMLRewriter;
     } catch {
       const message = primaryError instanceof Error ? primaryError.message : String(primaryError);

package/src/services/html/html-transformer.service.d.ts

@@ -1,5 +1,5 @@
-import type { ProcessedAsset } from '../assets/asset-processing-service/assets.types';
-import { type HtmlRewriterMode, type HtmlRewriterProvider } from './html-rewriter-provider.service';
+import type { ProcessedAsset } from '../assets/asset-processing-service/assets.types.js';
+import { type HtmlRewriterMode, type HtmlRewriterProvider } from './html-rewriter-provider.service.js';
 export interface HtmlTransformerServiceOptions {
     htmlRewriterMode?: HtmlRewriterMode;
     htmlRewriterProvider?: HtmlRewriterProvider;

package/src/services/html/html-transformer.service.js

@@ -1,6 +1,6 @@
 import {
   DefaultHtmlRewriterProvider
-} from "./html-rewriter-provider.service";
+} from "./html-rewriter-provider.service.js";
 class HtmlTransformerService {
   processedDependencies = [];
   htmlRewriterProvider;
@@ -163,22 +163,16 @@ class HtmlTransformerService {
   async transform(res) {
     const { head, body } = this.groupDependenciesByPosition();
     const htmlRewriter = await this.htmlRewriterProvider.createHtmlRewriter();
-    const html = await res.text();
-    const headers = new Headers(res.headers);
     if (htmlRewriter) {
       htmlRewriter.on("head", {
         element: (element) => this.appendDependencies(element, head)
       }).on("body", {
         element: (element) => this.appendDependencies(element, body)
       });
-      return htmlRewriter.transform(
-        new Response(html, {
-          headers,
-          status: res.status,
-          statusText: res.statusText
-        })
-      );
+      return htmlRewriter.transform(res);
     }
+    const html = await res.text();
+    const headers = new Headers(res.headers);
     const withHeadDependencies = this.injectBeforeClosingTag(html, "head", this.buildDependencyTags(head));
     const transformedHtml = this.injectBeforeClosingTag(
       withHeadDependencies,

package/src/services/invalidation/development-invalidation.service.d.ts

@@ -1,4 +1,4 @@
-import type { EcoPagesAppConfig } from '../../internal-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 export type DevelopmentInvalidationCategory = 'public-asset' | 'additional-watch' | 'include-source' | 'route-source' | 'processor-owned-asset' | 'server-source' | 'other';
 /**
  * Framework-owned invalidation plan for one changed file.

package/src/services/invalidation/development-invalidation.service.js

@@ -16,6 +16,7 @@ class DevelopmentInvalidationService {
    */
   invalidateServerModules(changedFiles) {
     getAppServerInvalidationState(this.appConfig).invalidateServerModules(changedFiles);
+    this.appConfig.runtime?.appModuleLoader?.invalidateDevelopmentGraph();
   }
   /**
    * Resets runtime-owned graph state and invalidates server modules.

package/src/services/module-loading/app-module-loader.service.d.ts

@@ -0,0 +1,25 @@
+import { PageModuleImportService, type PageModuleImportDependencies, type PageModuleImportOptions } from './page-module-import.service.js';
+import type { BuildExecutor } from '../../build/build-adapter.js';
+export type AppModuleLoaderOwner = 'bun' | 'host';
+export interface AppModuleLoader {
+    readonly owner: AppModuleLoaderOwner;
+    importModule<T = unknown>(options: PageModuleImportOptions): Promise<T>;
+    invalidateDevelopmentGraph(): void;
+}
+export type AppModuleLoaderOptions = {
+    dependencies?: Partial<PageModuleImportDependencies>;
+    getBuildExecutor?: () => BuildExecutor | undefined;
+    getOwner?: () => AppModuleLoaderOwner;
+    getInvalidationVersion?: () => number | undefined;
+    pageModuleImportService?: PageModuleImportService;
+};
+export declare class RuntimeAppModuleLoader implements AppModuleLoader {
+    private readonly pageModuleImportService;
+    private readonly getBuildExecutorValue;
+    private readonly getOwnerValue;
+    private readonly getInvalidationVersionValue;
+    constructor(options?: AppModuleLoaderOptions);
+    get owner(): AppModuleLoaderOwner;
+    importModule<T = unknown>(options: PageModuleImportOptions): Promise<T>;
+    invalidateDevelopmentGraph(): void;
+}

package/src/services/module-loading/app-module-loader.service.js

@@ -0,0 +1,31 @@
+import {
+  PageModuleImportService
+} from "./page-module-import.service.js";
+class RuntimeAppModuleLoader {
+  pageModuleImportService;
+  getBuildExecutorValue;
+  getOwnerValue;
+  getInvalidationVersionValue;
+  constructor(options = {}) {
+    this.pageModuleImportService = options.pageModuleImportService ?? new PageModuleImportService(options.dependencies);
+    this.getBuildExecutorValue = options.getBuildExecutor ?? (() => void 0);
+    this.getOwnerValue = options.getOwner ?? (() => "bun");
+    this.getInvalidationVersionValue = options.getInvalidationVersion ?? (() => void 0);
+  }
+  get owner() {
+    return this.getOwnerValue();
+  }
+  async importModule(options) {
+    return await this.pageModuleImportService.importModule({
+      ...options,
+      buildExecutor: options.buildExecutor ?? this.getBuildExecutorValue(),
+      invalidationVersion: options.invalidationVersion ?? this.getInvalidationVersionValue()
+    });
+  }
+  invalidateDevelopmentGraph() {
+    this.pageModuleImportService.invalidateDevelopmentGraph();
+  }
+}
+export {
+  RuntimeAppModuleLoader
+};

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

@@ -1,5 +1,13 @@
-import type { EcoPagesAppConfig } from '../../internal-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+import { type AppModuleLoader } from './app-module-loader.service.js';
+import type { SourceModuleLoader } from './module-loading-types.js';
 import { ServerModuleTranspiler } from './server-module-transpiler.service.js';
+export declare function shouldAppUseHostModuleLoader(appConfig: EcoPagesAppConfig, filePath: string): boolean;
+export declare function getAppHostModuleLoader(appConfig: EcoPagesAppConfig): SourceModuleLoader | undefined;
+export declare function setAppHostModuleLoader(appConfig: EcoPagesAppConfig, hostModuleLoader?: SourceModuleLoader): void;
+export declare function createAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader;
+export declare function getAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader;
+export declare function setAppModuleLoader(appConfig: EcoPagesAppConfig, appModuleLoader: AppModuleLoader): void;
 /**
  * Creates the shared app-scoped server-module transpiler for one runtime
  * instance.

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

@@ -1,14 +1,83 @@
 import { getAppBuildExecutor } from "../../build/build-adapter.js";
-import { createAppNodeBootstrapPlugin } from "../../adapters/node/bootstrap-dependency-resolver.js";
+import path from "node:path";
 import { DevelopmentInvalidationService } from "../invalidation/development-invalidation.service.js";
+import {
+  RuntimeAppModuleLoader
+} from "./app-module-loader.service.js";
+import { createAppNodeBootstrapPlugin } from "./node-bootstrap-plugin.js";
 import { ServerModuleTranspiler } from "./server-module-transpiler.service.js";
+function supportsHostSourceModuleLoading(filePath) {
+  const extension = path.extname(filePath);
+  return extension === ".js" || extension === ".jsx" || extension === ".ts" || extension === ".tsx" || extension === ".mjs" || extension === ".mts" || extension === ".cjs" || extension === ".cts";
+}
+function shouldAppUseHostModuleLoader(appConfig, filePath) {
+  if (appConfig.runtime?.hostModuleLoader) {
+    return supportsHostSourceModuleLoading(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);
+}
+function getAppHostModuleLoader(appConfig) {
+  return appConfig.runtime?.hostModuleLoader;
+}
+function getAppModuleLoaderOwner(appConfig) {
+  return getAppHostModuleLoader(appConfig) ? "host" : "bun";
+}
+function setAppHostModuleLoader(appConfig, hostModuleLoader) {
+  appConfig.runtime = {
+    ...appConfig.runtime ?? {},
+    hostModuleLoader
+  };
+}
+function createAppModuleLoader(appConfig) {
+  const invalidationService = new DevelopmentInvalidationService(appConfig);
+  return new RuntimeAppModuleLoader({
+    dependencies: {
+      canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
+      getHostModuleLoader: () => getAppHostModuleLoader(appConfig)
+    },
+    getBuildExecutor: () => getAppBuildExecutor(appConfig),
+    getOwner: () => getAppModuleLoaderOwner(appConfig),
+    getInvalidationVersion: () => invalidationService.getServerModuleInvalidationVersion()
+  });
+}
+function getAppModuleLoader(appConfig) {
+  const existingModuleLoader = appConfig.runtime?.appModuleLoader;
+  if (existingModuleLoader) {
+    return existingModuleLoader;
+  }
+  const appModuleLoader = createAppModuleLoader(appConfig);
+  setAppModuleLoader(appConfig, appModuleLoader);
+  return appModuleLoader;
+}
+function setAppModuleLoader(appConfig, appModuleLoader) {
+  appConfig.runtime = {
+    ...appConfig.runtime ?? {},
+    appModuleLoader
+  };
+}
 function createAppServerModuleTranspiler(appConfig) {
   const invalidationService = new DevelopmentInvalidationService(appConfig);
   return new ServerModuleTranspiler({
     rootDir: appConfig.rootDir,
     getBuildExecutor: () => getAppBuildExecutor(appConfig),
+    getHostModuleLoader: () => getAppHostModuleLoader(appConfig),
+    canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
     getInvalidationVersion: () => invalidationService.getServerModuleInvalidationVersion(),
     invalidateModules: (changedFiles) => invalidationService.invalidateServerModules(changedFiles),
+    pageModuleImportService: getAppModuleLoader(appConfig),
     getDefaultPlugins: typeof Bun === "undefined" && appConfig.rootDir ? () => [createAppNodeBootstrapPlugin(appConfig)] : void 0
   });
 }
@@ -28,7 +97,13 @@ function setAppServerModuleTranspiler(appConfig, serverModuleTranspiler) {
   };
 }
 export {
+  createAppModuleLoader,
   createAppServerModuleTranspiler,
+  getAppHostModuleLoader,
+  getAppModuleLoader,
   getAppServerModuleTranspiler,
-  setAppServerModuleTranspiler
+  setAppHostModuleLoader,
+  setAppModuleLoader,
+  setAppServerModuleTranspiler,
+  shouldAppUseHostModuleLoader
 };

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

@@ -0,0 +1,4 @@
+import type { SourceModuleLoader } from './module-loading-types.js';
+export declare function setHostModuleLoader(loader: SourceModuleLoader): void;
+export declare function getHostModuleLoader(): SourceModuleLoader | undefined;
+export declare function clearHostModuleLoader(): void;

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

@@ -0,0 +1,15 @@
+let hostModuleLoader;
+function setHostModuleLoader(loader) {
+  hostModuleLoader = loader;
+}
+function getHostModuleLoader() {
+  return hostModuleLoader;
+}
+function clearHostModuleLoader() {
+  hostModuleLoader = void 0;
+}
+export {
+  clearHostModuleLoader,
+  getHostModuleLoader,
+  setHostModuleLoader
+};

package/src/services/module-loading/module-loading-types.d.ts

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

package/src/{adapters/node/bootstrap-dependency-resolver.d.ts → services/module-loading/node-bootstrap-plugin.d.ts}

@@ -1,11 +1,5 @@
 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;
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 /**
  * Returns the app-local node_modules directory used by framework-owned Node
  * bootstrap loads outside the thin-host manifest path.
@@ -18,27 +12,11 @@ export interface NodeBootstrapResolutionOptions {
 }
 /**
  * Builds the user-facing error for Bun-native imports that cannot run on the
- * Node thin-host bootstrap path.
+ * Node bootstrap transpile 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;