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

package/src/services/module-loading/route-module-build-cache.store.js

@@ -1,207 +1,202 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import { RouteModuleDependencyHasher } from "./route-module-dependency-hasher.js";
-import {
-  ROUTE_MODULE_BUILD_CACHE_FILENAME,
-  createEmptyRouteModuleBuildCacheManifest,
-  createPersistedRouteModuleBuildKey,
-  getCorePackageVersion,
-  normalizeRouteModuleCachePath,
-  readRouteModuleBuildCacheManifest,
-  shouldPersistRouteModuleBuildCache,
-  writeRouteModuleBuildCacheManifest
-} from "./route-module-build-manifest.js";
-import {
-  isProductionCacheManifestCurrent,
-  matchesProductionCacheFingerprint
-} from "../../build/cache/production-build-cache.js";
-class RouteModuleBuildCache {
-  manifestPath;
-  dependencies;
-  dependencyHasher;
-  manifest;
-  manifestLoaded = false;
-  constructor(outdir, dependencies) {
-    this.manifestPath = path.join(outdir, ROUTE_MODULE_BUILD_CACHE_FILENAME);
-    this.dependencies = {
-      readManifest: dependencies?.readManifest ?? readRouteModuleBuildCacheManifest,
-      writeManifest: dependencies?.writeManifest ?? writeRouteModuleBuildCacheManifest,
-      exists: dependencies?.exists ?? ((filePath) => fileSystem.exists(filePath)),
-      getCorePackageVersion: dependencies?.getCorePackageVersion ?? getCorePackageVersion,
-      createDependencyHasher: dependencies?.createDependencyHasher ?? (() => new RouteModuleDependencyHasher())
-    };
-    this.dependencyHasher = this.dependencies.createDependencyHasher();
-  }
-  lookup(options) {
-    if (!shouldPersistRouteModuleBuildCache(options)) {
-      return void 0;
-    }
-    const manifest = this.loadManifest();
-    if (manifest.invalidationVersion !== this.dependencies.getCorePackageVersion()) {
-      return void 0;
-    }
-    const buildKey = createPersistedRouteModuleBuildKey(options);
-    const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
-    const entry = manifest.entries[cacheFilePath];
-    if (!entry || entry.sourceHash !== options.fileHash || entry.buildKey !== buildKey) {
-      return void 0;
-    }
-    if (!this.dependencyHasher.matchesStoredHashes(entry.dependencyHashes, cacheFilePath, options.fileHash)) {
-      return void 0;
-    }
-    const outputPath = path.isAbsolute(entry.outputPath) ? entry.outputPath : path.join(options.outdir, entry.outputPath);
-    if (!this.dependencies.exists(outputPath)) {
-      return void 0;
-    }
-    return { outputPath, entry };
-  }
-  recordBuild(options) {
-    if (!shouldPersistRouteModuleBuildCache(options)) {
-      return;
-    }
-    const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
-    const dependencyModulePaths = options.dependencyModulePaths && options.dependencyModulePaths.length > 0 ? options.dependencyModulePaths : [cacheFilePath];
-    const dependencyHashes = this.dependencyHasher.createDependencyHashes(dependencyModulePaths);
-    dependencyHashes[cacheFilePath] = options.fileHash;
-    const manifest = this.loadManifest();
-    const existingEntry = manifest.entries[cacheFilePath];
-    manifest.invalidationVersion = this.dependencies.getCorePackageVersion();
-    manifest.entries[cacheFilePath] = {
-      sourceHash: options.fileHash,
-      outputPath: options.outputPath,
-      builtAt: Date.now(),
-      buildKey: createPersistedRouteModuleBuildKey(options),
-      dependencyHashes,
-      renderedOutputs: existingEntry?.renderedOutputs
-    };
-    this.persistManifest(manifest);
-  }
-  isIncrementalStaticGenerationAvailable(context) {
-    if (process.env.NODE_ENV !== "production") {
-      return false;
-    }
-    const manifest = this.loadManifest();
-    if (!isProductionCacheManifestCurrent(manifest, this.dependencies.getCorePackageVersion())) {
-      return false;
-    }
-    return manifest.configHash === context.configHash && matchesProductionCacheFingerprint(manifest, context.buildInputsFingerprint);
-  }
-  ensureIncrementalStaticGenerationContext(context) {
-    if (process.env.NODE_ENV !== "production") {
-      return;
-    }
-    const manifest = this.loadManifest();
-    manifest.invalidationVersion = this.dependencies.getCorePackageVersion();
-    manifest.configHash = context.configHash;
-    manifest.buildInputsFingerprint = context.buildInputsFingerprint;
-    this.persistManifest(manifest);
-  }
-  canReuseStaticRender(options) {
-    if (options.force) {
-      return false;
-    }
-    if (!fileSystem.exists(options.sourceFile)) {
-      return false;
-    }
-    const sourceHash = fileSystem.hash(options.sourceFile);
-    return this.lookupStaticRender({
-      filePath: options.sourceFile,
-      pathname: options.pathname,
-      sourceHash,
-      renderedOutputPath: options.renderedOutputPath,
-      context: options.context
-    });
-  }
-  lookupStaticRender(options) {
-    if (!this.isIncrementalStaticGenerationAvailable(options.context)) {
-      return false;
-    }
-    const manifest = this.loadManifest();
-    const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
-    const entry = manifest.entries[cacheFilePath];
-    const renderedOutput = entry?.renderedOutputs?.[options.pathname];
-    if (!entry || !renderedOutput) {
-      return false;
-    }
-    if (entry.sourceHash !== options.sourceHash || renderedOutput.sourceHash !== options.sourceHash) {
-      return false;
-    }
-    if (!this.dependencyHasher.matchesStoredHashes(entry.dependencyHashes, cacheFilePath, options.sourceHash)) {
-      return false;
-    }
-    const cachedOutputPath = path.isAbsolute(renderedOutput.renderedOutputPath) ? renderedOutput.renderedOutputPath : path.resolve(renderedOutput.renderedOutputPath);
-    if (cachedOutputPath !== path.resolve(options.renderedOutputPath)) {
-      return false;
+import path from 'node:path';
+import { fileSystem } from '@ecopages/file-system';
+import { RouteModuleDependencyHasher } from './route-module-dependency-hasher.js';
+import { ROUTE_MODULE_BUILD_CACHE_FILENAME, createEmptyRouteModuleBuildCacheManifest, createPersistedRouteModuleBuildKey, getCorePackageVersion, normalizeRouteModuleCachePath, readRouteModuleBuildCacheManifest, shouldPersistRouteModuleBuildCache, writeRouteModuleBuildCacheManifest, } from './route-module-build-manifest.js';
+import { isProductionCacheManifestCurrent, matchesProductionCacheFingerprint, } from '../../build/cache/production-build-cache.js';
+/**
+ * Persists route-module transpile and static-render metadata under one server outdir.
+ */
+export class RouteModuleBuildCache {
+    manifestPath;
+    dependencies;
+    dependencyHasher;
+    manifest;
+    manifestLoaded = false;
+    constructor(outdir, dependencies) {
+        this.manifestPath = path.join(outdir, ROUTE_MODULE_BUILD_CACHE_FILENAME);
+        this.dependencies = {
+            readManifest: dependencies?.readManifest ?? readRouteModuleBuildCacheManifest,
+            writeManifest: dependencies?.writeManifest ?? writeRouteModuleBuildCacheManifest,
+            exists: dependencies?.exists ?? ((filePath) => fileSystem.exists(filePath)),
+            getCorePackageVersion: dependencies?.getCorePackageVersion ?? getCorePackageVersion,
+            createDependencyHasher: dependencies?.createDependencyHasher ?? (() => new RouteModuleDependencyHasher()),
+        };
+        this.dependencyHasher = this.dependencies.createDependencyHasher();
+    }
+    lookup(options) {
+        if (!shouldPersistRouteModuleBuildCache(options)) {
+            return undefined;
+        }
+        const manifest = this.loadManifest();
+        if (manifest.invalidationVersion !== this.dependencies.getCorePackageVersion()) {
+            return undefined;
+        }
+        const buildKey = createPersistedRouteModuleBuildKey(options);
+        const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
+        const entry = manifest.entries[cacheFilePath];
+        if (!entry || entry.sourceHash !== options.fileHash || entry.buildKey !== buildKey) {
+            return undefined;
+        }
+        if (!this.dependencyHasher.matchesStoredHashes(entry.dependencyHashes, cacheFilePath, options.fileHash)) {
+            return undefined;
+        }
+        const outputPath = path.isAbsolute(entry.outputPath)
+            ? entry.outputPath
+            : path.join(options.outdir, entry.outputPath);
+        if (!this.dependencies.exists(outputPath)) {
+            return undefined;
+        }
+        return { outputPath, entry };
     }
-    return this.dependencies.exists(cachedOutputPath);
-  }
-  recordStaticRender(options) {
-    if (process.env.NODE_ENV !== "production") {
-      return;
+    recordBuild(options) {
+        if (!shouldPersistRouteModuleBuildCache(options)) {
+            return;
+        }
+        const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
+        const dependencyModulePaths = options.dependencyModulePaths && options.dependencyModulePaths.length > 0
+            ? options.dependencyModulePaths
+            : [cacheFilePath];
+        const dependencyHashes = this.dependencyHasher.createDependencyHashes(dependencyModulePaths);
+        dependencyHashes[cacheFilePath] = options.fileHash;
+        const manifest = this.loadManifest();
+        const existingEntry = manifest.entries[cacheFilePath];
+        manifest.invalidationVersion = this.dependencies.getCorePackageVersion();
+        manifest.entries[cacheFilePath] = {
+            sourceHash: options.fileHash,
+            outputPath: options.outputPath,
+            builtAt: Date.now(),
+            buildKey: createPersistedRouteModuleBuildKey(options),
+            dependencyHashes,
+            renderedOutputs: existingEntry?.renderedOutputs,
+        };
+        this.persistManifest(manifest);
+    }
+    isIncrementalStaticGenerationAvailable(context) {
+        if (process.env.NODE_ENV !== 'production') {
+            return false;
+        }
+        const manifest = this.loadManifest();
+        if (!isProductionCacheManifestCurrent(manifest, this.dependencies.getCorePackageVersion())) {
+            return false;
+        }
+        return (manifest.configHash === context.configHash &&
+            matchesProductionCacheFingerprint(manifest, context.buildInputsFingerprint));
     }
-    const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
-    const manifest = this.loadManifest();
-    const existingEntry = manifest.entries[cacheFilePath];
-    manifest.invalidationVersion = this.dependencies.getCorePackageVersion();
-    manifest.configHash = options.context.configHash;
-    manifest.buildInputsFingerprint = options.context.buildInputsFingerprint;
-    manifest.entries[cacheFilePath] = {
-      sourceHash: options.sourceHash,
-      outputPath: existingEntry?.outputPath ?? "",
-      builtAt: existingEntry?.builtAt ?? Date.now(),
-      buildKey: existingEntry?.buildKey ?? "",
-      dependencyHashes: existingEntry?.dependencyHashes,
-      renderedOutputs: {
-        ...existingEntry?.renderedOutputs ?? {},
-        [options.pathname]: {
-          renderedOutputPath: options.renderedOutputPath,
-          renderedAt: Date.now(),
-          sourceHash: options.sourceHash
-        }
-      }
-    };
-    this.persistManifest(manifest);
-  }
-  resetMemory() {
-    this.manifest = void 0;
-    this.manifestLoaded = false;
-  }
-  pruneStaleRenderedOutputs(activePathnames) {
-    if (process.env.NODE_ENV !== "production") {
-      return [];
+    ensureIncrementalStaticGenerationContext(context) {
+        if (process.env.NODE_ENV !== 'production') {
+            return;
+        }
+        const manifest = this.loadManifest();
+        manifest.invalidationVersion = this.dependencies.getCorePackageVersion();
+        manifest.configHash = context.configHash;
+        manifest.buildInputsFingerprint = context.buildInputsFingerprint;
+        this.persistManifest(manifest);
+    }
+    canReuseStaticRender(options) {
+        if (options.force) {
+            return false;
+        }
+        if (!fileSystem.exists(options.sourceFile)) {
+            return false;
+        }
+        const sourceHash = fileSystem.hash(options.sourceFile);
+        return this.lookupStaticRender({
+            filePath: options.sourceFile,
+            pathname: options.pathname,
+            sourceHash,
+            renderedOutputPath: options.renderedOutputPath,
+            context: options.context,
+        });
+    }
+    lookupStaticRender(options) {
+        if (!this.isIncrementalStaticGenerationAvailable(options.context)) {
+            return false;
+        }
+        const manifest = this.loadManifest();
+        const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
+        const entry = manifest.entries[cacheFilePath];
+        const renderedOutput = entry?.renderedOutputs?.[options.pathname];
+        if (!entry || !renderedOutput) {
+            return false;
+        }
+        if (entry.sourceHash !== options.sourceHash || renderedOutput.sourceHash !== options.sourceHash) {
+            return false;
+        }
+        if (!this.dependencyHasher.matchesStoredHashes(entry.dependencyHashes, cacheFilePath, options.sourceHash)) {
+            return false;
+        }
+        const cachedOutputPath = path.isAbsolute(renderedOutput.renderedOutputPath)
+            ? renderedOutput.renderedOutputPath
+            : path.resolve(renderedOutput.renderedOutputPath);
+        if (cachedOutputPath !== path.resolve(options.renderedOutputPath)) {
+            return false;
+        }
+        return this.dependencies.exists(cachedOutputPath);
     }
-    const manifest = this.loadManifest();
-    const removedOutputPaths = [];
-    for (const entry of Object.values(manifest.entries)) {
-      if (!entry.renderedOutputs) {
-        continue;
-      }
-      for (const [pathname, renderedOutput] of Object.entries(entry.renderedOutputs)) {
-        if (activePathnames.has(pathname)) {
-          continue;
-        }
-        removedOutputPaths.push(renderedOutput.renderedOutputPath);
-        delete entry.renderedOutputs[pathname];
-      }
+    recordStaticRender(options) {
+        if (process.env.NODE_ENV !== 'production') {
+            return;
+        }
+        const cacheFilePath = normalizeRouteModuleCachePath(options.filePath);
+        const manifest = this.loadManifest();
+        const existingEntry = manifest.entries[cacheFilePath];
+        manifest.invalidationVersion = this.dependencies.getCorePackageVersion();
+        manifest.configHash = options.context.configHash;
+        manifest.buildInputsFingerprint = options.context.buildInputsFingerprint;
+        manifest.entries[cacheFilePath] = {
+            sourceHash: options.sourceHash,
+            outputPath: existingEntry?.outputPath ?? '',
+            builtAt: existingEntry?.builtAt ?? Date.now(),
+            buildKey: existingEntry?.buildKey ?? '',
+            dependencyHashes: existingEntry?.dependencyHashes,
+            renderedOutputs: {
+                ...(existingEntry?.renderedOutputs ?? {}),
+                [options.pathname]: {
+                    renderedOutputPath: options.renderedOutputPath,
+                    renderedAt: Date.now(),
+                    sourceHash: options.sourceHash,
+                },
+            },
+        };
+        this.persistManifest(manifest);
+    }
+    resetMemory() {
+        this.manifest = undefined;
+        this.manifestLoaded = false;
+    }
+    pruneStaleRenderedOutputs(activePathnames) {
+        if (process.env.NODE_ENV !== 'production') {
+            return [];
+        }
+        const manifest = this.loadManifest();
+        const removedOutputPaths = [];
+        for (const entry of Object.values(manifest.entries)) {
+            if (!entry.renderedOutputs) {
+                continue;
+            }
+            for (const [pathname, renderedOutput] of Object.entries(entry.renderedOutputs)) {
+                if (activePathnames.has(pathname)) {
+                    continue;
+                }
+                removedOutputPaths.push(renderedOutput.renderedOutputPath);
+                delete entry.renderedOutputs[pathname];
+            }
+        }
+        if (removedOutputPaths.length > 0) {
+            this.persistManifest(manifest);
+        }
+        return removedOutputPaths;
     }
-    if (removedOutputPaths.length > 0) {
-      this.persistManifest(manifest);
+    loadManifest() {
+        if (this.manifestLoaded) {
+            return this.manifest ?? createEmptyRouteModuleBuildCacheManifest();
+        }
+        this.manifestLoaded = true;
+        this.manifest = this.dependencies.readManifest(this.manifestPath) ?? createEmptyRouteModuleBuildCacheManifest();
+        return this.manifest;
     }
-    return removedOutputPaths;
-  }
-  loadManifest() {
-    if (this.manifestLoaded) {
-      return this.manifest ?? createEmptyRouteModuleBuildCacheManifest();
+    persistManifest(manifest) {
+        this.manifest = manifest;
+        this.dependencies.writeManifest(this.manifestPath, manifest);
     }
-    this.manifestLoaded = true;
-    this.manifest = this.dependencies.readManifest(this.manifestPath) ?? createEmptyRouteModuleBuildCacheManifest();
-    return this.manifest;
-  }
-  persistManifest(manifest) {
-    this.manifest = manifest;
-    this.dependencies.writeManifest(this.manifestPath, manifest);
-  }
 }
-export {
-  RouteModuleBuildCache
-};

package/src/services/module-loading/route-module-build-manifest.js

@@ -1,85 +1,72 @@
-import path from "node:path";
-import { readProductionCacheManifest, writeProductionCacheManifest } from "../../build/cache/production-build-cache.js";
-import { createJsxCacheKey, createPluginCacheKey, getCorePackageVersion } from "../../build/cache/cache-keys.js";
-import {
-  createJsxCacheKey as createJsxCacheKey2,
-  createPluginCacheKey as createPluginCacheKey2,
-  getCorePackageVersion as getCorePackageVersion2,
-  hashPluginSetup
-} from "../../build/cache/cache-keys.js";
-import { ROUTE_MODULE_BUILD_CACHE_FILENAME } from "../../build/cache/cache-constants.js";
-function normalizeRouteModuleCachePath(filePath) {
-  return path.resolve(filePath);
+import path from 'node:path';
+import { readProductionCacheManifest, writeProductionCacheManifest } from '../../build/cache/production-build-cache.js';
+import { createJsxCacheKey, createPluginCacheKey, getCorePackageVersion } from '../../build/cache/cache-keys.js';
+export { createJsxCacheKey, createPluginCacheKey, getCorePackageVersion, hashPluginSetup, } from '../../build/cache/cache-keys.js';
+export { ROUTE_MODULE_BUILD_CACHE_FILENAME } from '../../build/cache/cache-constants.js';
+/** Normalizes filesystem paths used as manifest keys and build-key inputs. */
+export function normalizeRouteModuleCachePath(filePath) {
+    return path.resolve(filePath);
 }
-function shouldPersistRouteModuleBuildCache(options) {
-  if (process.env.NODE_ENV !== "production") {
-    return false;
-  }
-  if (options.bypassCache) {
-    return false;
-  }
-  if ((options.invalidationVersion ?? 0) > 0) {
-    return false;
-  }
-  if (options.cacheScope) {
-    return false;
-  }
-  return true;
+/** Returns whether route-module disk caching should run for the current import. */
+export function shouldPersistRouteModuleBuildCache(options) {
+    if (process.env.NODE_ENV !== 'production') {
+        return false;
+    }
+    if (options.bypassCache) {
+        return false;
+    }
+    if ((options.invalidationVersion ?? 0) > 0) {
+        return false;
+    }
+    if (options.cacheScope) {
+        return false;
+    }
+    return true;
 }
-function resolvePageModuleOutputFileName(options) {
-  const fileBaseName = path.basename(options.filePath, path.extname(options.filePath));
-  const cacheScopeSuffix = options.cacheScope ? `-${sanitizeCacheScope(options.cacheScope)}` : "";
-  const invalidationSuffix = shouldVersionBuildOutputPath(options.invalidationVersion ?? 0) ? `-v${options.invalidationVersion}` : "";
-  return `${fileBaseName}-${options.fileHash}${cacheScopeSuffix}${invalidationSuffix}.mjs`;
+/** Derives the deterministic on-disk filename for one transpiled route module. */
+export function resolvePageModuleOutputFileName(options) {
+    const fileBaseName = path.basename(options.filePath, path.extname(options.filePath));
+    const cacheScopeSuffix = options.cacheScope ? `-${sanitizeCacheScope(options.cacheScope)}` : '';
+    const invalidationSuffix = shouldVersionBuildOutputPath(options.invalidationVersion ?? 0)
+        ? `-v${options.invalidationVersion}`
+        : '';
+    return `${fileBaseName}-${options.fileHash}${cacheScopeSuffix}${invalidationSuffix}.mjs`;
 }
-function createPersistedRouteModuleBuildKey(options) {
-  return [
-    path.resolve(options.rootDir),
-    path.resolve(options.outdir),
-    options.splitting ?? "default",
-    options.externalPackages ?? "default",
-    createJsxCacheKey(options.jsx),
-    createPluginCacheKey(options.plugins)
-  ].join("::");
+/** Builds the cache key for persisted production route-module builds. */
+export function createPersistedRouteModuleBuildKey(options) {
+    return [
+        path.resolve(options.rootDir),
+        path.resolve(options.outdir),
+        options.splitting ?? 'default',
+        options.externalPackages ?? 'default',
+        createJsxCacheKey(options.jsx),
+        createPluginCacheKey(options.plugins),
+    ].join('::');
 }
-function createEmptyRouteModuleBuildCacheManifest() {
-  return {
-    invalidationVersion: getCorePackageVersion(),
-    entries: {}
-  };
+export function createEmptyRouteModuleBuildCacheManifest() {
+    return {
+        invalidationVersion: getCorePackageVersion(),
+        entries: {},
+    };
 }
-function readRouteModuleBuildCacheManifest(manifestPath) {
-  const parsed = readProductionCacheManifest(manifestPath);
-  if (!parsed || typeof parsed.entries !== "object") {
-    return void 0;
-  }
-  return {
-    invalidationVersion: parsed.invalidationVersion ?? "",
-    configHash: parsed.configHash,
-    buildInputsFingerprint: parsed.buildInputsFingerprint,
-    entries: parsed.entries
-  };
+export function readRouteModuleBuildCacheManifest(manifestPath) {
+    const parsed = readProductionCacheManifest(manifestPath);
+    if (!parsed || typeof parsed.entries !== 'object') {
+        return undefined;
+    }
+    return {
+        invalidationVersion: parsed.invalidationVersion ?? '',
+        configHash: parsed.configHash,
+        buildInputsFingerprint: parsed.buildInputsFingerprint,
+        entries: parsed.entries,
+    };
 }
-function writeRouteModuleBuildCacheManifest(manifestPath, manifest) {
-  writeProductionCacheManifest(manifestPath, manifest);
+export function writeRouteModuleBuildCacheManifest(manifestPath, manifest) {
+    writeProductionCacheManifest(manifestPath, manifest);
 }
 function shouldVersionBuildOutputPath(invalidationVersion) {
-  return typeof Bun !== "undefined" && invalidationVersion > 0;
+    return typeof Bun !== 'undefined' && invalidationVersion > 0;
 }
 function sanitizeCacheScope(cacheScope) {
-  return cacheScope.replace(/[^a-zA-Z0-9_-]+/g, "-");
+    return cacheScope.replace(/[^a-zA-Z0-9_-]+/g, '-');
 }
-export {
-  ROUTE_MODULE_BUILD_CACHE_FILENAME,
-  createEmptyRouteModuleBuildCacheManifest,
-  createJsxCacheKey2 as createJsxCacheKey,
-  createPersistedRouteModuleBuildKey,
-  createPluginCacheKey2 as createPluginCacheKey,
-  getCorePackageVersion2 as getCorePackageVersion,
-  hashPluginSetup,
-  normalizeRouteModuleCachePath,
-  readRouteModuleBuildCacheManifest,
-  resolvePageModuleOutputFileName,
-  shouldPersistRouteModuleBuildCache,
-  writeRouteModuleBuildCacheManifest
-};