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

package/src/adapters/node/runtime-adapter.d.ts

@@ -1,46 +0,0 @@
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import { type NodeRuntimeManifest } from '../../services/runtime-manifest/node-runtime-manifest.service.js';
-/**
- * Host-to-adapter handoff contract for the Node thin-host runtime.
- *
- * @remarks
- * The thin host is responsible only for validating the persisted manifest,
- * capturing process-level launch context, and passing those values into the
- * adapter. All framework bootstrap work begins after this handoff.
- */
-export interface NodeRuntimeStartOptions {
-    manifest: NodeRuntimeManifest;
-    workingDirectory: string;
-    cliArgs: string[];
-}
-/**
- * Runtime session state produced after the adapter has loaded the app through
- * the framework-owned loader path.
- */
-export interface LoadedAppRuntime {
-    manifest: NodeRuntimeManifest;
-    workingDirectory: string;
-    entryModulePath: string;
-    appConfig: EcoPagesAppConfig;
-    entryModule: unknown;
-}
-/**
- * Live Node thin-host runtime session.
- */
-export interface NodeRuntimeSession {
-    loadApp(): Promise<LoadedAppRuntime>;
-    invalidate(changedFiles: string[]): Promise<void>;
-    dispose(): Promise<void>;
-}
-/**
- * Adapter boundary created by the thin host after manifest validation.
- */
-export interface NodeRuntimeAdapter {
-    start(options: NodeRuntimeStartOptions): Promise<NodeRuntimeSession>;
-}
-/**
- * Validates and narrows the persisted Node runtime manifest used by the thin
- * host handoff.
- */
-export declare function assertNodeRuntimeManifest(manifest: unknown): NodeRuntimeManifest;
-export declare function createNodeRuntimeAdapter(): NodeRuntimeAdapter;

package/src/adapters/node/runtime-adapter.js

@@ -1,306 +0,0 @@
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import {
-  createBuildAdapter,
-  getAppBuildExecutor
-} from "../../build/build-adapter.js";
-import { createAppBuildExecutor } from "../../build/dev-build-coordinator.js";
-import { createNodeBootstrapPlugin, getNodeRuntimeNodeModulesDir } from "./bootstrap-dependency-resolver.js";
-import {
-  setAppNodeRuntimeManifest
-} from "../../services/runtime-manifest/node-runtime-manifest.service.js";
-import { DevelopmentInvalidationService } from "../../services/invalidation/development-invalidation.service.js";
-import { getAppEntrypointDependencyGraph } from "../../services/runtime-state/entrypoint-dependency-graph.service.js";
-import { createAliasResolverPlugin } from "../../plugins/alias-resolver-plugin.js";
-import {
-  TranspilerServerLoader
-} from "../../services/module-loading/server-loader.service.js";
-import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
-import { installAppRuntimeBuildExecutor } from "../../build/runtime-build-executor.js";
-const NODE_RUNTIME_CONFIG_OUTDIR = ".node-runtime-config";
-const NODE_RUNTIME_ENTRY_OUTDIR = ".node-runtime-entry";
-const NODE_RUNTIME_BOOTSTRAP_SPLITTING = false;
-const NODE_RUNTIME_CONFIG_NAMESPACE = "ecopages-runtime-config";
-const NODE_RUNTIME_CONFIG_GLOBAL_KEY = "__ecopagesNodeRuntimeConfig";
-const NODE_HMR_MANAGER_SOURCE_PATH = fileURLToPath(new URL("./node-hmr-manager.js", import.meta.url));
-function resolveConfigImportPath(importPath, importer) {
-  if (!importPath) {
-    return void 0;
-  }
-  if (path.isAbsolute(importPath)) {
-    return importPath;
-  }
-  if (!importPath.startsWith(".")) {
-    return void 0;
-  }
-  if (!importer) {
-    return void 0;
-  }
-  return path.resolve(path.dirname(importer), importPath);
-}
-function doesImportReferenceConfig(args, configModulePath) {
-  if (args.path === configModulePath) {
-    return true;
-  }
-  if (args.path === "./eco.config" || args.path === "./eco.config.js") {
-    return true;
-  }
-  const resolvedImportPath = resolveConfigImportPath(args.path, args.importer);
-  if (!resolvedImportPath) {
-    return false;
-  }
-  if (resolvedImportPath === configModulePath) {
-    return true;
-  }
-  const configPathWithoutExtension = configModulePath.replace(/\.[cm]?[jt]sx?$/i, "");
-  const resolvedPathWithoutExtension = resolvedImportPath.replace(/\.[cm]?[jt]sx?$/i, "");
-  return resolvedPathWithoutExtension === configPathWithoutExtension;
-}
-function createRuntimeConfigBridgePlugin(configModulePath) {
-  return {
-    name: "node-runtime-config-bridge",
-    setup(build) {
-      build.onResolve({ filter: /.*/ }, (args) => {
-        if (!doesImportReferenceConfig(args, configModulePath)) {
-          return void 0;
-        }
-        return {
-          path: NODE_RUNTIME_CONFIG_GLOBAL_KEY,
-          namespace: NODE_RUNTIME_CONFIG_NAMESPACE
-        };
-      });
-      build.onLoad({ filter: /.*/, namespace: NODE_RUNTIME_CONFIG_NAMESPACE }, () => {
-        return {
-          loader: "js",
-          contents: [
-            `const key = ${JSON.stringify(NODE_RUNTIME_CONFIG_GLOBAL_KEY)};`,
-            "const appConfig = globalThis[key];",
-            "if (!appConfig) {",
-            "throw new Error('Node runtime config bridge expected a loaded app config before app-entry evaluation.');",
-            "}",
-            "export default appConfig;"
-          ].join("\n")
-        };
-      });
-    }
-  };
-}
-function assertNodeRuntimeManifest(manifest) {
-  if (!manifest || typeof manifest !== "object") {
-    throw new Error("Invalid Node runtime manifest: expected an object.");
-  }
-  const candidate = manifest;
-  const modulePaths = candidate.modulePaths;
-  if (candidate.runtime !== "node") {
-    throw new Error('Invalid Node runtime manifest: runtime must be "node".');
-  }
-  if (typeof candidate.appRootDir !== "string" || typeof candidate.sourceRootDir !== "string" || typeof candidate.distDir !== "string") {
-    throw new Error("Invalid Node runtime manifest: root, source, and dist paths must be strings.");
-  }
-  if (!modulePaths || typeof modulePaths.config !== "string") {
-    throw new Error("Invalid Node runtime manifest: modulePaths.config must be present.");
-  }
-  return candidate;
-}
-function getRuntimeOutdir(manifest, kind) {
-  return path.join(
-    resolveInternalExecutionDir({
-      rootDir: manifest.appRootDir,
-      workDir: manifest.workDir,
-      absolutePaths: {
-        workDir: manifest.workDir,
-        distDir: manifest.distDir
-      }
-    }),
-    kind
-  );
-}
-class NodeRuntimeAdapterSession {
-  options;
-  serverLoader;
-  bootstrapBundlePlugin;
-  bootstrapBuildAdapter;
-  bootstrapBuildExecutor;
-  invalidationService = null;
-  appConfig = null;
-  loadedAppRuntime = null;
-  constructor(options) {
-    this.options = options;
-    this.bootstrapBundlePlugin = createNodeBootstrapPlugin({
-      projectDir: options.manifest.appRootDir,
-      runtimeNodeModulesDir: getNodeRuntimeNodeModulesDir(options.manifest),
-      preserveImportMetaPaths: [
-        options.manifest.modulePaths.config,
-        ...options.manifest.modulePaths.entry ? [options.manifest.modulePaths.entry] : [],
-        NODE_HMR_MANAGER_SOURCE_PATH
-      ]
-    });
-    this.bootstrapBuildAdapter = createBuildAdapter();
-    this.bootstrapBuildExecutor = createAppBuildExecutor({
-      development: false,
-      adapter: this.bootstrapBuildAdapter
-    });
-    this.serverLoader = new TranspilerServerLoader({
-      rootDir: options.manifest.appRootDir,
-      getBuildExecutor: () => this.bootstrapBuildExecutor
-    });
-  }
-  isDevelopmentMode() {
-    return this.options.cliArgs.includes("--dev") || process.env.NODE_ENV === "development";
-  }
-  get manifest() {
-    return this.options.manifest;
-  }
-  getEntryModulePath() {
-    const entryModulePath = this.manifest.modulePaths.entry;
-    if (!entryModulePath) {
-      throw new Error(
-        "Invalid Node runtime manifest: modulePaths.entry must be present before the Node thin-host adapter can load the app."
-      );
-    }
-    return entryModulePath;
-  }
-  createAppLoaderContext(appConfig, buildExecutor, invalidationService) {
-    return {
-      rootDir: appConfig.rootDir,
-      getBuildExecutor: () => buildExecutor,
-      getInvalidationVersion: () => invalidationService.getServerModuleInvalidationVersion(),
-      invalidateModules: (changedFiles) => invalidationService.invalidateServerModules(changedFiles)
-    };
-  }
-  /**
-   * Installs and returns the app-owned runtime build executor.
-   */
-  installAppBuildExecutor(appConfig) {
-    const appBuildExecutor = installAppRuntimeBuildExecutor(appConfig, {
-      development: this.isDevelopmentMode()
-    });
-    return appBuildExecutor;
-  }
-  /**
-   * Rebinds app-phase server loading to the installed app-owned executor.
-   */
-  bindAppServerLoader(appConfig, buildExecutor) {
-    if (!this.invalidationService) {
-      throw new Error("Node runtime invalidation service is not initialized.");
-    }
-    this.serverLoader.rebindAppContext(
-      this.createAppLoaderContext(appConfig, buildExecutor, this.invalidationService)
-    );
-  }
-  initializeAppRuntime(appConfig) {
-    setAppNodeRuntimeManifest(appConfig, this.manifest);
-    this.invalidationService = new DevelopmentInvalidationService(appConfig);
-    const appBuildExecutor = this.installAppBuildExecutor(appConfig);
-    this.bindAppServerLoader(appConfig, appBuildExecutor);
-    this.appConfig = appConfig;
-    return appConfig;
-  }
-  /**
-   * Loads and validates the built app config through the framework-owned server
-   * loader.
-   */
-  async loadAppConfig() {
-    if (this.appConfig) {
-      return this.appConfig;
-    }
-    let importedConfigModule;
-    try {
-      importedConfigModule = await this.serverLoader.loadConfig({
-        filePath: this.manifest.modulePaths.config,
-        outdir: getRuntimeOutdir(this.manifest, NODE_RUNTIME_CONFIG_OUTDIR),
-        splitting: NODE_RUNTIME_BOOTSTRAP_SPLITTING,
-        externalPackages: false,
-        plugins: [createAliasResolverPlugin(this.manifest.sourceRootDir), this.bootstrapBundlePlugin],
-        transpileErrorMessage: (details) => `Failed to transpile Ecopages config module: ${details}`,
-        noOutputMessage: (filePath) => `No transpiled output generated for Ecopages config module: ${filePath}`
-      });
-    } catch (error) {
-      throw new Error(
-        `Node thin-host runtime config bootstrap failed: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-    const exportedConfig = "default" in importedConfigModule ? importedConfigModule.default : importedConfigModule;
-    return this.initializeAppRuntime(exportedConfig);
-  }
-  /**
-   * Loads the application entry through the framework-owned server loader after
-   * config bootstrap has established app-owned runtime/build services.
-   */
-  async loadApp() {
-    if (this.loadedAppRuntime) {
-      return this.loadedAppRuntime;
-    }
-    const appConfig = await this.loadAppConfig();
-    const entryModulePath = this.getEntryModulePath();
-    let loadedEntryModule;
-    const runtimeGlobal = globalThis;
-    runtimeGlobal[NODE_RUNTIME_CONFIG_GLOBAL_KEY] = appConfig;
-    try {
-      loadedEntryModule = await this.serverLoader.loadApp({
-        filePath: entryModulePath,
-        outdir: getRuntimeOutdir(this.manifest, NODE_RUNTIME_ENTRY_OUTDIR),
-        splitting: NODE_RUNTIME_BOOTSTRAP_SPLITTING,
-        externalPackages: false,
-        plugins: [
-          createRuntimeConfigBridgePlugin(this.manifest.modulePaths.config),
-          createAliasResolverPlugin(appConfig.absolutePaths.srcDir),
-          this.bootstrapBundlePlugin
-        ],
-        transpileErrorMessage: (details) => `Failed to transpile Ecopages app entry module: ${details}`,
-        noOutputMessage: (filePath) => `No transpiled output generated for Ecopages app entry module: ${filePath}`
-      });
-    } catch (error) {
-      throw new Error(
-        `Node thin-host runtime app-entry bootstrap failed: ${error instanceof Error ? error.message : String(error)}`
-      );
-    } finally {
-      delete runtimeGlobal[NODE_RUNTIME_CONFIG_GLOBAL_KEY];
-    }
-    this.loadedAppRuntime = {
-      manifest: this.manifest,
-      workingDirectory: this.options.workingDirectory,
-      appConfig,
-      entryModulePath,
-      entryModule: loadedEntryModule
-    };
-    return this.loadedAppRuntime;
-  }
-  /**
-   * Invalidates server-loader and app dev-graph state before the next bootstrap
-   * cycle.
-   */
-  async invalidate(_changedFiles) {
-    this.serverLoader.invalidate(_changedFiles);
-    if (this.invalidationService) {
-      this.invalidationService.resetRuntimeState(_changedFiles);
-    }
-    this.loadedAppRuntime = null;
-    if (this.appConfig) {
-      this.bindAppServerLoader(this.appConfig, getAppBuildExecutor(this.appConfig));
-      return;
-    }
-  }
-  /**
-   * Disposes loader-owned resources for the current runtime session.
-   */
-  async dispose() {
-    await this.serverLoader.dispose();
-    if (this.appConfig) {
-      getAppEntrypointDependencyGraph(this.appConfig).reset();
-    }
-    this.invalidationService = null;
-  }
-}
-class DefaultNodeRuntimeAdapter {
-  async start(options) {
-    return new NodeRuntimeAdapterSession(options);
-  }
-}
-function createNodeRuntimeAdapter() {
-  return new DefaultNodeRuntimeAdapter();
-}
-export {
-  assertNodeRuntimeManifest,
-  createNodeRuntimeAdapter
-};