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

package/src/build/cache/pages-unified-graph-build.js

@@ -1,198 +1,199 @@
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { fileSystem } from "@ecopages/file-system";
-import { appLogger } from "../../global/app-logger.js";
-import { build } from "../build-adapter.js";
-import { requireBuildRuntime } from "../runtime/build-runtime.js";
-import { createServerBuildRequest, resolveServerAppBuildPlugins } from "../runtime/build-request-policy.js";
-import { createBuildInputsFingerprint, hashAppConfigFile } from "./build-input-fingerprint.js";
-import {
-  isProductionCacheManifestCurrent,
-  matchesProductionCacheBuildKey,
-  matchesProductionCacheFingerprint,
-  readProductionCacheManifest,
-  writeProductionCacheManifest
-} from "./production-build-cache.js";
-import { getCorePackageVersion } from "./cache-keys.js";
-import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
-import { getSharedRouteModuleBuildCache } from "../../services/module-loading/route-module-build-cache-registry.js";
-import { resolveRouteModuleDependencyPaths } from "../../services/module-loading/route-module-dependency-hasher.js";
-const PAGES_UNIFIED_GRAPH_CACHE_DIR = ".server-pages-graph";
-const PAGES_UNIFIED_GRAPH_CACHE_FILENAME = ".build-cache.json";
-function isPagesUnifiedGraphEnabled() {
-  if (process.env.ECOPAGES_UNIFIED_PAGES_GRAPH === "0") {
-    return false;
-  }
-  if (process.env.ECOPAGES_UNIFIED_PAGES_GRAPH === "1") {
-    return true;
-  }
-  return process.env.NODE_ENV === "production";
+/**
+ * Unified pages Rolldown graph (Phase A build + Phase C import).
+ *
+ * Enabled by default in production builds. Opt out with
+ * `ECOPAGES_UNIFIED_PAGES_GRAPH=0`. Covers all static page template extensions
+ * registered on the app config.
+ */
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { fileSystem } from '@ecopages/file-system';
+import { appLogger } from '../../global/app-logger.js';
+import { build } from '../build-adapter.js';
+import { requireBuildRuntime } from '../runtime/build-runtime.js';
+import { createServerBuildRequest, resolveServerAppBuildPlugins } from '../runtime/build-request-policy.js';
+import { createBuildInputsFingerprint, hashAppConfigFile } from './build-input-fingerprint.js';
+import { isProductionCacheManifestCurrent, matchesProductionCacheBuildKey, matchesProductionCacheFingerprint, readProductionCacheManifest, writeProductionCacheManifest, } from './production-build-cache.js';
+import { getCorePackageVersion } from './cache-keys.js';
+import { resolveInternalExecutionDir } from '../../utils/resolve-work-dir.js';
+import { getSharedRouteModuleBuildCache } from '../../services/module-loading/route-module-build-cache-registry.js';
+import { resolveRouteModuleDependencyPaths } from '../../services/module-loading/route-module-dependency-hasher.js';
+export const PAGES_UNIFIED_GRAPH_CACHE_DIR = '.server-pages-graph';
+export const PAGES_UNIFIED_GRAPH_CACHE_FILENAME = '.build-cache.json';
+export function isPagesUnifiedGraphEnabled() {
+    if (process.env.ECOPAGES_UNIFIED_PAGES_GRAPH === '0') {
+        return false;
+    }
+    if (process.env.ECOPAGES_UNIFIED_PAGES_GRAPH === '1') {
+        return true;
+    }
+    return process.env.NODE_ENV === 'production';
 }
-function shouldBuildPagesUnifiedGraph() {
-  return isPagesUnifiedGraphEnabled() && process.env.NODE_ENV === "production";
+/** True when the unified graph should build or serve prebuilt page modules. */
+export function shouldBuildPagesUnifiedGraph() {
+    return isPagesUnifiedGraphEnabled() && process.env.NODE_ENV === 'production';
 }
-function isPagesUnifiedGraphPage(filePath, appConfig) {
-  const normalizedPath = path.normalize(filePath);
-  return appConfig.templatesExt.some((extension) => normalizedPath.endsWith(extension));
+export function isPagesUnifiedGraphPage(filePath, appConfig) {
+    const normalizedPath = path.normalize(filePath);
+    return appConfig.templatesExt.some((extension) => normalizedPath.endsWith(extension));
 }
 function getPagesUnifiedGraphCachePath(appConfig) {
-  return path.join(
-    resolveInternalExecutionDir(appConfig),
-    PAGES_UNIFIED_GRAPH_CACHE_DIR,
-    PAGES_UNIFIED_GRAPH_CACHE_FILENAME
-  );
+    return path.join(resolveInternalExecutionDir(appConfig), PAGES_UNIFIED_GRAPH_CACHE_DIR, PAGES_UNIFIED_GRAPH_CACHE_FILENAME);
 }
 function createPagesUnifiedGraphBuildKey(appConfig, outdir) {
-  const pluginNames = resolveServerAppBuildPlugins(appConfig).map((plugin) => plugin.name).sort().join("|");
-  const templateExtensions = [...appConfig.templatesExt].sort().join("|");
-  return [
-    path.resolve(outdir),
-    hashAppConfigFile(appConfig),
-    templateExtensions,
-    pluginNames,
-    "es2022",
-    "esm",
-    "external-packages"
-  ].join("::");
+    const pluginNames = resolveServerAppBuildPlugins(appConfig)
+        .map((plugin) => plugin.name)
+        .sort()
+        .join('|');
+    const templateExtensions = [...appConfig.templatesExt].sort().join('|');
+    return [
+        path.resolve(outdir),
+        hashAppConfigFile(appConfig),
+        templateExtensions,
+        pluginNames,
+        'es2022',
+        'esm',
+        'external-packages',
+    ].join('::');
 }
 function readPagesUnifiedGraphManifest(appConfig) {
-  const manifest = readProductionCacheManifest(
-    getPagesUnifiedGraphCachePath(appConfig)
-  );
-  if (!manifest?.outputs) {
-    return void 0;
-  }
-  return manifest;
+    const manifest = readProductionCacheManifest(getPagesUnifiedGraphCachePath(appConfig));
+    if (!manifest?.outputs) {
+        return undefined;
+    }
+    return manifest;
 }
 function writePagesUnifiedGraphManifest(appConfig, manifest) {
-  writeProductionCacheManifest(getPagesUnifiedGraphCachePath(appConfig), manifest);
+    writeProductionCacheManifest(getPagesUnifiedGraphCachePath(appConfig), manifest);
 }
 function createSafeGraphEntryKey(entryPath, rootDir) {
-  const relativePath = path.relative(rootDir, entryPath).replace(/\.[^.]+$/u, "");
-  const safeKey = relativePath.replace(/[^a-zA-Z0-9]+/gu, "-").replace(/^-+|-+$/gu, "");
-  return safeKey.length > 0 ? safeKey : "page";
+    const relativePath = path.relative(rootDir, entryPath).replace(/\.[^.]+$/u, '');
+    const safeKey = relativePath.replace(/[^a-zA-Z0-9]+/gu, '-').replace(/^-+|-+$/gu, '');
+    return safeKey.length > 0 ? safeKey : 'page';
 }
+/**
+ * @remarks
+ * Uses {@link BuildResult.entryOutputs} when present so resolution follows the
+ * bundler's `facadeModuleId` instead of guessing from sanitized entry keys.
+ * Basename prefix matching remains only as a fallback for backends that omit
+ * `entryOutputs`; it can mis-associate keys such as `pages-blog` and
+ * `pages-blog-index`.
+ */
 function resolveOutputForEntrypoint(entryPath, entryKey, buildResult) {
-  const exactOutput = buildResult.entryOutputs?.[path.resolve(entryPath)];
-  if (exactOutput) {
-    return exactOutput;
-  }
-  for (const { path: outputPath } of buildResult.outputs) {
-    const outputBaseName = path.basename(outputPath);
-    if (outputBaseName.startsWith(`${entryKey}-`) && /\.(?:m?js)$/u.test(outputBaseName)) {
-      return outputPath;
-    }
-    if (outputBaseName === `${entryKey}.js` || outputBaseName === `${entryKey}.mjs`) {
-      return outputPath;
-    }
-  }
-  return void 0;
+    const exactOutput = buildResult.entryOutputs?.[path.resolve(entryPath)];
+    if (exactOutput) {
+        return exactOutput;
+    }
+    for (const { path: outputPath } of buildResult.outputs) {
+        const outputBaseName = path.basename(outputPath);
+        if (outputBaseName.startsWith(`${entryKey}-`) && /\.(?:m?js)$/u.test(outputBaseName)) {
+            return outputPath;
+        }
+        if (outputBaseName === `${entryKey}.js` || outputBaseName === `${entryKey}.mjs`) {
+            return outputPath;
+        }
+    }
+    return undefined;
 }
 function isManifestValidForEntries(manifest, appConfig, outdir, entryPaths) {
-  if (!isProductionCacheManifestCurrent(manifest, getCorePackageVersion())) {
-    return false;
-  }
-  if (!matchesProductionCacheFingerprint(manifest, createBuildInputsFingerprint(appConfig))) {
-    return false;
-  }
-  if (!matchesProductionCacheBuildKey(manifest, createPagesUnifiedGraphBuildKey(appConfig, outdir))) {
-    return false;
-  }
-  return entryPaths.every((entryPath) => {
-    const resolvedEntryPath = path.resolve(entryPath);
-    const outputPath = manifest.outputs[resolvedEntryPath];
-    return outputPath ? fileSystem.exists(outputPath) : false;
-  });
+    if (!isProductionCacheManifestCurrent(manifest, getCorePackageVersion())) {
+        return false;
+    }
+    if (!matchesProductionCacheFingerprint(manifest, createBuildInputsFingerprint(appConfig))) {
+        return false;
+    }
+    if (!matchesProductionCacheBuildKey(manifest, createPagesUnifiedGraphBuildKey(appConfig, outdir))) {
+        return false;
+    }
+    return entryPaths.every((entryPath) => {
+        const resolvedEntryPath = path.resolve(entryPath);
+        const outputPath = manifest.outputs[resolvedEntryPath];
+        return outputPath ? fileSystem.exists(outputPath) : false;
+    });
 }
-async function ensurePagesUnifiedGraphBuilt(options) {
-  if (!shouldBuildPagesUnifiedGraph()) {
-    return void 0;
-  }
-  const eligibleEntryPaths = options.entryPaths.map((entryPath) => path.resolve(entryPath)).filter((entryPath) => isPagesUnifiedGraphPage(entryPath, options.appConfig));
-  if (eligibleEntryPaths.length === 0) {
-    return void 0;
-  }
-  const outdir = path.resolve(options.outdir);
-  const existingManifest = options.force ? void 0 : readPagesUnifiedGraphManifest(options.appConfig);
-  if (existingManifest && isManifestValidForEntries(existingManifest, options.appConfig, outdir, eligibleEntryPaths)) {
-    appLogger.debug("Reusing pages unified graph cache");
-    return existingManifest;
-  }
-  const routeModuleBuildCache = getSharedRouteModuleBuildCache(outdir, options.appConfig);
-  const entryRecord = {};
-  const entryKeysByPath = /* @__PURE__ */ new Map();
-  for (const entryPath of eligibleEntryPaths) {
-    const entryKey = createSafeGraphEntryKey(entryPath, options.appConfig.rootDir);
-    entryRecord[entryKey] = entryPath;
-    entryKeysByPath.set(entryPath, entryKey);
-  }
-  appLogger.debugTime("pagesUnifiedGraphBuild");
-  const buildOptions = createServerBuildRequest(options.appConfig, {
-    profile: "route-module",
-    entrypoints: entryRecord,
-    outdir,
-    splitting: true,
-    naming: "[name]-[hash].[ext]"
-  });
-  const plugins = buildOptions.plugins ?? [];
-  const buildResult = await build(buildOptions, requireBuildRuntime(options.appConfig).getProfile("route-module"));
-  appLogger.debugTimeEnd("pagesUnifiedGraphBuild");
-  if (!buildResult.success) {
-    const details = buildResult.logs.map((log) => log.message).join(" | ");
-    throw new Error(`Pages unified graph build failed: ${details}`);
-  }
-  const outputs = {};
-  for (const entryPath of eligibleEntryPaths) {
-    const fileHash = fileSystem.hash(entryPath);
-    const entryKey = entryKeysByPath.get(entryPath);
-    const compiledOutput = entryKey ? resolveOutputForEntrypoint(entryPath, entryKey, buildResult) : void 0;
-    if (!compiledOutput) {
-      throw new Error(`Pages unified graph build produced no output for ${entryPath}`);
-    }
-    outputs[entryPath] = compiledOutput;
-    routeModuleBuildCache.recordBuild({
-      filePath: entryPath,
-      rootDir: options.appConfig.rootDir,
-      outdir,
-      fileHash,
-      outputPath: compiledOutput,
-      dependencyModulePaths: resolveRouteModuleDependencyPaths(buildResult, entryPath, options.appConfig.rootDir),
-      externalPackages: true,
-      plugins
+/**
+ * Builds eligible static pages in one Rolldown invocation and seeds route-module disk cache.
+ */
+export async function ensurePagesUnifiedGraphBuilt(options) {
+    if (!shouldBuildPagesUnifiedGraph()) {
+        return undefined;
+    }
+    const eligibleEntryPaths = options.entryPaths
+        .map((entryPath) => path.resolve(entryPath))
+        .filter((entryPath) => isPagesUnifiedGraphPage(entryPath, options.appConfig));
+    if (eligibleEntryPaths.length === 0) {
+        return undefined;
+    }
+    const outdir = path.resolve(options.outdir);
+    const existingManifest = options.force ? undefined : readPagesUnifiedGraphManifest(options.appConfig);
+    if (existingManifest &&
+        isManifestValidForEntries(existingManifest, options.appConfig, outdir, eligibleEntryPaths)) {
+        appLogger.debug('Reusing pages unified graph cache');
+        return existingManifest;
+    }
+    const routeModuleBuildCache = getSharedRouteModuleBuildCache(outdir, options.appConfig);
+    const entryRecord = {};
+    const entryKeysByPath = new Map();
+    for (const entryPath of eligibleEntryPaths) {
+        const entryKey = createSafeGraphEntryKey(entryPath, options.appConfig.rootDir);
+        entryRecord[entryKey] = entryPath;
+        entryKeysByPath.set(entryPath, entryKey);
+    }
+    appLogger.debugTime('pagesUnifiedGraphBuild');
+    const buildOptions = createServerBuildRequest(options.appConfig, {
+        profile: 'route-module',
+        entrypoints: entryRecord,
+        outdir,
+        splitting: true,
+        naming: '[name]-[hash].[ext]',
     });
-  }
-  const manifest = {
-    invalidationVersion: getCorePackageVersion(),
-    buildInputsFingerprint: createBuildInputsFingerprint(options.appConfig),
-    buildKey: createPagesUnifiedGraphBuildKey(options.appConfig, outdir),
-    builtAt: Date.now(),
-    outputs
-  };
-  writePagesUnifiedGraphManifest(options.appConfig, manifest);
-  appLogger.debug(`Built pages unified graph for ${eligibleEntryPaths.length} entries`);
-  return manifest;
+    const plugins = buildOptions.plugins ?? [];
+    const buildResult = await build(buildOptions, requireBuildRuntime(options.appConfig).getProfile('route-module'));
+    appLogger.debugTimeEnd('pagesUnifiedGraphBuild');
+    if (!buildResult.success) {
+        const details = buildResult.logs.map((log) => log.message).join(' | ');
+        throw new Error(`Pages unified graph build failed: ${details}`);
+    }
+    const outputs = {};
+    for (const entryPath of eligibleEntryPaths) {
+        const fileHash = fileSystem.hash(entryPath);
+        const entryKey = entryKeysByPath.get(entryPath);
+        const compiledOutput = entryKey ? resolveOutputForEntrypoint(entryPath, entryKey, buildResult) : undefined;
+        if (!compiledOutput) {
+            throw new Error(`Pages unified graph build produced no output for ${entryPath}`);
+        }
+        outputs[entryPath] = compiledOutput;
+        routeModuleBuildCache.recordBuild({
+            filePath: entryPath,
+            rootDir: options.appConfig.rootDir,
+            outdir,
+            fileHash,
+            outputPath: compiledOutput,
+            dependencyModulePaths: resolveRouteModuleDependencyPaths(buildResult, entryPath, options.appConfig.rootDir),
+            externalPackages: true,
+            plugins,
+        });
+    }
+    const manifest = {
+        invalidationVersion: getCorePackageVersion(),
+        buildInputsFingerprint: createBuildInputsFingerprint(options.appConfig),
+        buildKey: createPagesUnifiedGraphBuildKey(options.appConfig, outdir),
+        builtAt: Date.now(),
+        outputs,
+    };
+    writePagesUnifiedGraphManifest(options.appConfig, manifest);
+    appLogger.debug(`Built pages unified graph for ${eligibleEntryPaths.length} entries`);
+    return manifest;
 }
-async function importPagesUnifiedGraphModule(appConfig, filePath) {
-  const manifest = readPagesUnifiedGraphManifest(appConfig);
-  if (!manifest) {
-    return void 0;
-  }
-  const resolvedFilePath = path.resolve(filePath);
-  const outputPath = manifest.outputs[resolvedFilePath];
-  if (!outputPath || !fileSystem.exists(outputPath)) {
-    return void 0;
-  }
-  return await import(
-    /* @vite-ignore */
-    pathToFileURL(outputPath).href
-  );
+export async function importPagesUnifiedGraphModule(appConfig, filePath) {
+    const manifest = readPagesUnifiedGraphManifest(appConfig);
+    if (!manifest) {
+        return undefined;
+    }
+    const resolvedFilePath = path.resolve(filePath);
+    const outputPath = manifest.outputs[resolvedFilePath];
+    if (!outputPath || !fileSystem.exists(outputPath)) {
+        return undefined;
+    }
+    return (await import(/* @vite-ignore */ pathToFileURL(outputPath).href));
 }
-export {
-  PAGES_UNIFIED_GRAPH_CACHE_DIR,
-  PAGES_UNIFIED_GRAPH_CACHE_FILENAME,
-  ensurePagesUnifiedGraphBuilt,
-  importPagesUnifiedGraphModule,
-  isPagesUnifiedGraphEnabled,
-  isPagesUnifiedGraphPage,
-  shouldBuildPagesUnifiedGraph
-};

package/src/build/cache/production-build-cache.js

@@ -1,63 +1,56 @@
-import { fileSystem } from "@ecopages/file-system";
-import path from "node:path";
-import { ROUTE_MODULE_BUILD_CACHE_FILENAME } from "./cache-constants.js";
-import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
-const ROUTE_MODULE_CACHE_OUTDIRS = [".server-modules", ".server-route-modules"];
-const PAGES_GRAPH_CACHE_DIR = ".server-pages-graph";
-function getProductionBuildCacheManifestPaths(appConfig) {
-  const executionDir = resolveInternalExecutionDir(appConfig);
-  const paths = [];
-  for (const subdir of ROUTE_MODULE_CACHE_OUTDIRS) {
-    paths.push(path.join(executionDir, subdir, ROUTE_MODULE_BUILD_CACHE_FILENAME));
-  }
-  paths.push(path.join(executionDir, ".server-entry", ROUTE_MODULE_BUILD_CACHE_FILENAME));
-  paths.push(path.join(executionDir, PAGES_GRAPH_CACHE_DIR, ROUTE_MODULE_BUILD_CACHE_FILENAME));
-  return paths;
+import { fileSystem } from '@ecopages/file-system';
+import path from 'node:path';
+import { ROUTE_MODULE_BUILD_CACHE_FILENAME } from './cache-constants.js';
+import { resolveInternalExecutionDir } from '../../utils/resolve-work-dir.js';
+const ROUTE_MODULE_CACHE_OUTDIRS = ['.server-modules', '.server-route-modules'];
+const PAGES_GRAPH_CACHE_DIR = '.server-pages-graph';
+/** Returns every persisted production cache manifest path for one app. */
+export function getProductionBuildCacheManifestPaths(appConfig) {
+    const executionDir = resolveInternalExecutionDir(appConfig);
+    const paths = [];
+    for (const subdir of ROUTE_MODULE_CACHE_OUTDIRS) {
+        paths.push(path.join(executionDir, subdir, ROUTE_MODULE_BUILD_CACHE_FILENAME));
+    }
+    paths.push(path.join(executionDir, '.server-entry', ROUTE_MODULE_BUILD_CACHE_FILENAME));
+    paths.push(path.join(executionDir, PAGES_GRAPH_CACHE_DIR, ROUTE_MODULE_BUILD_CACHE_FILENAME));
+    return paths;
 }
-function clearPersistedProductionBuildCacheManifests(appConfig) {
-  if (process.env.NODE_ENV !== "production") {
-    return;
-  }
-  for (const manifestPath of getProductionBuildCacheManifestPaths(appConfig)) {
-    if (fileSystem.exists(manifestPath)) {
-      fileSystem.remove(manifestPath);
+/** Removes all persisted production cache manifests for one app. */
+export function clearPersistedProductionBuildCacheManifests(appConfig) {
+    if (process.env.NODE_ENV !== 'production') {
+        return;
+    }
+    for (const manifestPath of getProductionBuildCacheManifestPaths(appConfig)) {
+        if (fileSystem.exists(manifestPath)) {
+            fileSystem.remove(manifestPath);
+        }
     }
-  }
 }
-function readProductionCacheManifest(manifestPath) {
-  if (!fileSystem.exists(manifestPath)) {
-    return void 0;
-  }
-  try {
-    const parsed = JSON.parse(fileSystem.readFileSync(manifestPath));
-    if (!parsed || typeof parsed !== "object") {
-      return void 0;
+export function readProductionCacheManifest(manifestPath) {
+    if (!fileSystem.exists(manifestPath)) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(fileSystem.readFileSync(manifestPath));
+        if (!parsed || typeof parsed !== 'object') {
+            return undefined;
+        }
+        return parsed;
+    }
+    catch {
+        return undefined;
     }
-    return parsed;
-  } catch {
-    return void 0;
-  }
 }
-function writeProductionCacheManifest(manifestPath, manifest) {
-  fileSystem.ensureDir(path.dirname(manifestPath));
-  fileSystem.write(manifestPath, `${JSON.stringify(manifest, null, "	")}
-`);
+export function writeProductionCacheManifest(manifestPath, manifest) {
+    fileSystem.ensureDir(path.dirname(manifestPath));
+    fileSystem.write(manifestPath, `${JSON.stringify(manifest, null, '\t')}\n`);
 }
-function isProductionCacheManifestCurrent(manifest, invalidationVersion) {
-  return manifest?.invalidationVersion === invalidationVersion;
+export function isProductionCacheManifestCurrent(manifest, invalidationVersion) {
+    return manifest?.invalidationVersion === invalidationVersion;
 }
-function matchesProductionCacheFingerprint(manifest, buildInputsFingerprint) {
-  return manifest?.buildInputsFingerprint === buildInputsFingerprint;
+export function matchesProductionCacheFingerprint(manifest, buildInputsFingerprint) {
+    return manifest?.buildInputsFingerprint === buildInputsFingerprint;
 }
-function matchesProductionCacheBuildKey(manifest, buildKey) {
-  return manifest?.buildKey === buildKey;
+export function matchesProductionCacheBuildKey(manifest, buildKey) {
+    return manifest?.buildKey === buildKey;
 }
-export {
-  clearPersistedProductionBuildCacheManifests,
-  getProductionBuildCacheManifestPaths,
-  isProductionCacheManifestCurrent,
-  matchesProductionCacheBuildKey,
-  matchesProductionCacheFingerprint,
-  readProductionCacheManifest,
-  writeProductionCacheManifest
-};