@ecopages/core 0.2.0-beta.31 → 0.2.0-beta.32

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

@@ -1,112 +1,118 @@
-import { requireBuildRuntime } from "../../build/runtime/build-runtime.js";
-import path from "node:path";
-import { DevelopmentInvalidationService } from "../invalidation/development-invalidation.service.js";
-import {} from "./app-module-loader.service.js";
-import { PageModuleImportService } from "./page-module-import.service.js";
-import { supportsSourceModuleLoading } from "./source-module-support.js";
-import { ServerModuleTranspiler } from "./server-module-transpiler.service.js";
-function shouldAppUseHostModuleLoader(appConfig, filePath) {
-  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);
+import { requireBuildRuntime } from '../../build/runtime/build-runtime.js';
+import path from 'node:path';
+import { DevelopmentInvalidationService } from '../invalidation/development-invalidation.service.js';
+import {} from './app-module-loader.service.js';
+import { PageModuleImportService } from './page-module-import.service.js';
+import { supportsSourceModuleLoading } from './source-module-support.js';
+import { ServerModuleTranspiler } from './server-module-transpiler.service.js';
+export function shouldAppUseHostModuleLoader(appConfig, filePath) {
+    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);
 }
-function getAppHostModuleLoader(appConfig) {
-  return appConfig.runtime?.hostModuleLoader;
+export function getAppHostModuleLoader(appConfig) {
+    return appConfig.runtime?.hostModuleLoader;
 }
 function getAppModuleLoaderOwner(appConfig) {
-  return getAppHostModuleLoader(appConfig) ? "host" : "app";
+    return getAppHostModuleLoader(appConfig) ? 'host' : 'app';
 }
-function setAppHostModuleLoader(appConfig, hostModuleLoader) {
-  appConfig.runtime = {
-    ...appConfig.runtime ?? {},
-    hostModuleLoader
-  };
+export function setAppHostModuleLoader(appConfig, hostModuleLoader) {
+    appConfig.runtime = {
+        ...(appConfig.runtime ?? {}),
+        hostModuleLoader,
+    };
 }
-function createAppModuleLoader(appConfig) {
-  const invalidationService = new DevelopmentInvalidationService(appConfig);
-  const pageModuleImportService = new PageModuleImportService(appConfig, {
-    canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
-    getHostModuleLoader: () => getAppHostModuleLoader(appConfig)
-  });
-  const appModuleLoader = {
-    get owner() {
-      return getAppModuleLoaderOwner(appConfig);
-    },
-    pageModuleImportService,
-    async importModule(options) {
-      const invalidationVersion = options.invalidationVersion ?? invalidationService.getServerModuleInvalidationVersion();
-      return await pageModuleImportService.importModule({
-        ...options,
-        buildExecutor: options.buildExecutor ?? requireBuildRuntime(appConfig).getProfile("route-module"),
-        invalidationVersion
-      });
-    },
-    invalidateDevelopmentGraph() {
-      pageModuleImportService.invalidateDevelopmentGraph();
-    }
-  };
-  return appModuleLoader;
+/**
+ * Creates the app module loader that imports route modules through the build pipeline.
+ *
+ * @remarks
+ * Caller `plugins` are treated as contributions only.
+ * {@link PageModuleImportService} assembles the complete server request via
+ * {@link createServerBuildRequest}; this loader does not merge app plugins.
+ */
+export function createAppModuleLoader(appConfig) {
+    const invalidationService = new DevelopmentInvalidationService(appConfig);
+    const pageModuleImportService = new PageModuleImportService(appConfig, {
+        canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
+        getHostModuleLoader: () => getAppHostModuleLoader(appConfig),
+    });
+    const appModuleLoader = {
+        get owner() {
+            return getAppModuleLoaderOwner(appConfig);
+        },
+        pageModuleImportService,
+        async importModule(options) {
+            const invalidationVersion = options.invalidationVersion ?? invalidationService.getServerModuleInvalidationVersion();
+            return await pageModuleImportService.importModule({
+                ...options,
+                buildExecutor: options.buildExecutor ?? requireBuildRuntime(appConfig).getProfile('route-module'),
+                invalidationVersion,
+            });
+        },
+        invalidateDevelopmentGraph() {
+            pageModuleImportService.invalidateDevelopmentGraph();
+        },
+    };
+    return appModuleLoader;
 }
-function getAppModuleLoader(appConfig) {
-  const existingModuleLoader = appConfig.runtime?.appModuleLoader;
-  if (existingModuleLoader) {
-    return existingModuleLoader;
-  }
-  const appModuleLoader = createAppModuleLoader(appConfig);
-  setAppModuleLoader(appConfig, appModuleLoader);
-  return appModuleLoader;
+export 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
-  };
+export function setAppModuleLoader(appConfig, appModuleLoader) {
+    appConfig.runtime = {
+        ...(appConfig.runtime ?? {}),
+        appModuleLoader,
+    };
 }
-function createAppServerModuleTranspiler(appConfig) {
-  const invalidationService = new DevelopmentInvalidationService(appConfig);
-  return new ServerModuleTranspiler({
-    rootDir: appConfig.rootDir,
-    invalidateModules: (changedFiles) => invalidationService.invalidateServerModules(changedFiles),
-    pageModuleImportService: getAppModuleLoader(appConfig)
-  });
+/**
+ * Creates the shared app-scoped server-module transpiler for one runtime
+ * instance.
+ */
+export function createAppServerModuleTranspiler(appConfig) {
+    const invalidationService = new DevelopmentInvalidationService(appConfig);
+    return new ServerModuleTranspiler({
+        rootDir: appConfig.rootDir,
+        invalidateModules: (changedFiles) => invalidationService.invalidateServerModules(changedFiles),
+        pageModuleImportService: getAppModuleLoader(appConfig),
+    });
 }
-function getAppServerModuleTranspiler(appConfig) {
-  const existingTranspiler = appConfig.runtime?.serverModuleTranspiler;
-  if (existingTranspiler) {
-    return existingTranspiler;
-  }
-  const serverModuleTranspiler = createAppServerModuleTranspiler(appConfig);
-  setAppServerModuleTranspiler(appConfig, serverModuleTranspiler);
-  return serverModuleTranspiler;
+/**
+ * Returns the app-owned server-module transpiler, creating it lazily when the
+ * runtime first needs one.
+ */
+export function getAppServerModuleTranspiler(appConfig) {
+    const existingTranspiler = appConfig.runtime?.serverModuleTranspiler;
+    if (existingTranspiler) {
+        return existingTranspiler;
+    }
+    const serverModuleTranspiler = createAppServerModuleTranspiler(appConfig);
+    setAppServerModuleTranspiler(appConfig, serverModuleTranspiler);
+    return serverModuleTranspiler;
 }
-function setAppServerModuleTranspiler(appConfig, serverModuleTranspiler) {
-  appConfig.runtime = {
-    ...appConfig.runtime ?? {},
-    serverModuleTranspiler
-  };
+/**
+ * Installs the server-module transpiler that should serve one app instance.
+ */
+export function setAppServerModuleTranspiler(appConfig, serverModuleTranspiler) {
+    appConfig.runtime = {
+        ...(appConfig.runtime ?? {}),
+        serverModuleTranspiler,
+    };
 }
-export {
-  createAppModuleLoader,
-  createAppServerModuleTranspiler,
-  getAppHostModuleLoader,
-  getAppModuleLoader,
-  getAppServerModuleTranspiler,
-  setAppHostModuleLoader,
-  setAppModuleLoader,
-  setAppServerModuleTranspiler,
-  shouldAppUseHostModuleLoader
-};

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

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

package/src/services/module-loading/module-loading-types.js

@@ -0,0 +1 @@
+export {};