@ecopages/core 0.2.0-beta.9 → 0.2.0-rc.0

package/src/static-site-generator/static-build-invalidation.js

@@ -1,78 +1,37 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import {
-  createBuildInputsFingerprint,
-  hashAppConfigFile,
-  haveBuildInputsChanged
-} from "../build/build-input-fingerprint.js";
-import {
-  ROUTE_MODULE_BUILD_CACHE_FILENAME
-} from "../services/module-loading/route-module-build-manifest.js";
-import {
-  getSharedRouteModuleBuildCache,
-  getServerModuleBuildCacheOutdir
-} from "../services/module-loading/route-module-build-cache-registry.js";
-import { resolveInternalExecutionDir } from "../utils/resolve-work-dir.js";
-import {
-  collectBuildInputContributors,
-  createBuildInputsFingerprint as createBuildInputsFingerprint2,
-  didBuildInputContributorChange,
-  hashAppConfigFile as hashAppConfigFile2,
-  haveBuildInputsChanged as haveBuildInputsChanged2
-} from "../build/build-input-fingerprint.js";
-function createRouteModuleStaticRenderCacheContext(appConfig) {
-  return {
-    configHash: hashAppConfigFile(appConfig),
-    buildInputsFingerprint: createBuildInputsFingerprint(appConfig)
-  };
+import { createBuildInputsFingerprint, hashAppConfigFile, haveBuildInputsChanged, } from '../build/cache/build-input-fingerprint.js';
+import { clearPersistedProductionBuildCacheManifests } from '../build/cache/production-build-cache.js';
+import {} from '../services/module-loading/route-module-build-manifest.js';
+import { getSharedRouteModuleBuildCache, getServerModuleBuildCacheOutdir, } from '../services/module-loading/route-module-build-cache-registry.js';
+export { collectBuildInputContributors, createBuildInputsFingerprint, didBuildInputContributorChange, hashAppConfigFile, haveBuildInputsChanged, } from '../build/cache/build-input-fingerprint.js';
+/** Builds the static-render invalidation context for one app config. */
+export function createRouteModuleStaticRenderCacheContext(appConfig) {
+    return {
+        configHash: hashAppConfigFile(appConfig),
+        buildInputsFingerprint: createBuildInputsFingerprint(appConfig),
+    };
 }
-function shouldResetStaticExportDirectory(appConfig, force = false) {
-  if (force) {
-    return true;
-  }
-  if (haveBuildInputsChanged(appConfig)) {
-    return true;
-  }
-  const routeModuleCache = getSharedRouteModuleBuildCache(getServerModuleBuildCacheOutdir(appConfig), appConfig);
-  return !routeModuleCache.isIncrementalStaticGenerationAvailable(
-    createRouteModuleStaticRenderCacheContext(appConfig)
-  );
+/** Returns whether `dist/` should be wiped before the next static export. */
+export function shouldResetStaticExportDirectory(appConfig, force = false) {
+    if (force) {
+        return true;
+    }
+    if (haveBuildInputsChanged(appConfig)) {
+        return true;
+    }
+    const routeModuleCache = getSharedRouteModuleBuildCache(getServerModuleBuildCacheOutdir(appConfig), appConfig);
+    return !routeModuleCache.isIncrementalStaticGenerationAvailable(createRouteModuleStaticRenderCacheContext(appConfig));
 }
-const PRODUCTION_BUILD_CACHE_OUTDIRS = [".server-modules", ".server-route-modules"];
-function clearProductionBuildCaches(appConfig) {
-  if (process.env.NODE_ENV !== "production") {
-    return;
-  }
-  const executionDir = resolveInternalExecutionDir(appConfig);
-  for (const subdir of PRODUCTION_BUILD_CACHE_OUTDIRS) {
-    const manifestPath = path.join(executionDir, subdir, ROUTE_MODULE_BUILD_CACHE_FILENAME);
-    if (fileSystem.exists(manifestPath)) {
-      fileSystem.remove(manifestPath);
+/** Removes persisted production build caches so the next build recomputes everything. */
+export function clearProductionBuildCaches(appConfig) {
+    if (process.env.NODE_ENV !== 'production') {
+        return;
+    }
+    clearPersistedProductionBuildCacheManifests(appConfig);
+    for (const cache of appConfig.runtime?.routeModuleBuildCaches?.values() ?? []) {
+        cache.resetMemory();
+    }
+    appConfig.runtime?.routeModuleBuildCaches?.clear();
+    if (appConfig.runtime) {
+        appConfig.runtime.buildRuntime = undefined;
     }
-  }
-  const serverEntryCachePath = path.join(executionDir, ".server-entry", ROUTE_MODULE_BUILD_CACHE_FILENAME);
-  if (fileSystem.exists(serverEntryCachePath)) {
-    fileSystem.remove(serverEntryCachePath);
-  }
-  const pagesGraphCachePath = path.join(executionDir, ".server-pages-graph", ROUTE_MODULE_BUILD_CACHE_FILENAME);
-  if (fileSystem.exists(pagesGraphCachePath)) {
-    fileSystem.remove(pagesGraphCachePath);
-  }
-  for (const cache of appConfig.runtime?.routeModuleBuildCaches?.values() ?? []) {
-    cache.resetMemory();
-  }
-  appConfig.runtime?.routeModuleBuildCaches?.clear();
-  if (appConfig.runtime) {
-    appConfig.runtime.serverEntryBuildExecutor = void 0;
-  }
 }
-export {
-  clearProductionBuildCaches,
-  collectBuildInputContributors,
-  createBuildInputsFingerprint2 as createBuildInputsFingerprint,
-  createRouteModuleStaticRenderCacheContext,
-  didBuildInputContributorChange,
-  hashAppConfigFile2 as hashAppConfigFile,
-  haveBuildInputsChanged2 as haveBuildInputsChanged,
-  shouldResetStaticExportDirectory
-};

package/src/static-site-generator/static-export-context.d.ts

@@ -1,5 +1,5 @@
 import type { EcoPagesAppConfig } from '../types/internal-types.js';
-import type { StaticRoute } from '../types/public-types.js';
+import type { EcopagesRouteInfo, StaticRoute } from '../types/public-types.js';
 import type { StaticGenerationRendererResolver } from '../route-renderer/route-renderer.js';
 import type { StaticGenerationRoute } from '../router/server/route-registry.js';
 type StaticGenerationRouteSource = {
@@ -18,5 +18,13 @@ export interface StaticExportContext {
     staticRoutes?: StaticRoute[];
     force: boolean;
     preserveExportDirectory: boolean;
+    /**
+     * Unfiltered static-generation routes (exact + expanded dynamic).
+     *
+     * @remarks
+     * Sitemap filtering is applied separately; integrations that build custom
+     * artifacts should start from this full list.
+     */
+    routes: EcopagesRouteInfo[];
 }
 export {};

package/src/static-site-generator/static-export-context.js

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

package/src/static-site-generator/static-site-generator.d.ts

@@ -1,5 +1,5 @@
 import type { EcoPagesAppConfig } from '../types/internal-types.js';
-import type { StaticRoute } from '../types/public-types.js';
+import type { SitemapConfig, StaticRoute } from '../types/public-types.js';
 import type { PageRendererResolver, StaticGenerationRendererResolver } from '../route-renderer/route-renderer.js';
 import type { StaticGenerationRoute } from '../router/server/route-registry.js';
 import type { RouteModuleBuildCache } from '../services/module-loading/route-module-build-cache.store.js';
@@ -31,6 +31,7 @@ export declare class StaticSiteGenerator {
     private readonly routeModuleBuildCacheOverride?;
     private staticRenderCacheContext;
     private forceFullStaticGeneration;
+    private pageModuleLoader?;
     /**
      * Creates the static-site generator for one app config.
      */
@@ -46,6 +47,10 @@ export declare class StaticSiteGenerator {
      * Writes the robots.txt file declared by the app config.
      */
     generateRobotsTxt(): void;
+    /**
+     * Writes the configured sitemap file to the export directory.
+     */
+    generateSitemap(locations: readonly string[], sitemap: SitemapConfig): void;
     /**
      * Returns whether the input path points at the root directory.
      */
@@ -56,6 +61,18 @@ export declare class StaticSiteGenerator {
     getDirectories(routes: string[]): string[];
     private writeStaticOutput;
     private writeStaticPageArtifact;
+    /**
+     * Marks a successfully exported pathname as sitemap-eligible when robots allow indexing.
+     *
+     * @remarks
+     * Fail-closed: metadata resolution errors omit the URL. `robots.index === false`
+     * also omits it. Eligibility is decided during generation, not by reloading modules
+     * after `afterStaticExport`.
+     */
+    private considerSitemapEligibility;
+    private getPageModuleLoader;
+    private resolveFilesystemPageMetadata;
+    private resolveExplicitViewMetadata;
     private pruneStaleStaticOutputs;
     private createFilesystemStaticContents;
     /**
@@ -64,7 +81,15 @@ export declare class StaticSiteGenerator {
      * @remarks
      * Routes are rendered through the normal route renderer directly.
      */
-    generateStaticPages(router: StaticGenerationRouteSource, baseUrl: string, routeRendererFactory?: StaticPageRouteRendererFactory, skipped?: string[], activeStaticPathnames?: Set<string>, preloadedRoutes?: readonly StaticGenerationRoute[]): Promise<void>;
+    generateStaticPages(input: {
+        router: StaticGenerationRouteSource;
+        baseUrl: string;
+        routeRendererFactory?: StaticPageRouteRendererFactory;
+        skipped?: string[];
+        activeStaticPathnames?: Set<string>;
+        preloadedRoutes?: readonly StaticGenerationRoute[];
+        sitemapEligiblePathnames?: Set<string>;
+    }): Promise<void>;
     private createStaticExportContext;
     private invokeStaticExportHook;
     /**
@@ -78,10 +103,6 @@ export declare class StaticSiteGenerator {
         force?: boolean;
         preserveExportDirectory?: boolean;
     }): Promise<void>;
-    /**
-     * Generates static pages from explicit static routes registered via app.static().
-     * These routes use eco.page views via loader functions for HMR support.
-     */
     private generateExplicitStaticPages;
     private resolveExplicitViewSourceFile;
     private generateExplicitStaticRoute;