@ecopages/core 0.2.0-beta.41 → 0.2.0-beta.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-beta.41",
+  "version": "0.2.0-beta.42",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -17,7 +17,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-beta.41",
+    "@ecopages/file-system": "0.2.0-beta.42",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
     "@oxc-project/runtime": "0.141.0",
@@ -32,7 +32,7 @@
     "@standard-schema/utils": "^0.3.0"
   },
   "peerDependencies": {
-    "@ecopages/dev-toolbar": "0.2.0-beta.41"
+    "@ecopages/dev-toolbar": "0.2.0-beta.42"
   },
   "peerDependenciesMeta": {
     "@ecopages/dev-toolbar": {

package/src/services/invalidation/development-invalidation.service.js

@@ -1,6 +1,7 @@
 import path from 'node:path';
 import { getAppServerInvalidationState } from '../runtime-state/server-invalidation-state.service.js';
 import { appLogger } from '../../global/app-logger.js';
+import { clearAppDevelopmentRouteModuleBuildCaches } from '../module-loading/route-module-build-cache-registry.js';
 /**
  * Framework-owned development invalidation service.
  *
@@ -29,6 +30,7 @@ export class DevelopmentInvalidationService {
     invalidateServerModules(changedFiles) {
         getAppServerInvalidationState(this.appConfig).invalidateServerModules(changedFiles);
         this.appConfig.runtime?.appModuleLoader?.invalidateDevelopmentGraph();
+        clearAppDevelopmentRouteModuleBuildCaches(this.appConfig);
     }
     /**
      * Registers an integration-owned handler for registered script entrypoint edits.
@@ -57,8 +59,8 @@ export class DevelopmentInvalidationService {
      * Resets runtime-owned graph state and invalidates server modules.
      */
     resetRuntimeState(changedFiles) {
+        this.invalidateServerModules(changedFiles);
         const serverInvalidationState = getAppServerInvalidationState(this.appConfig);
-        serverInvalidationState.invalidateServerModules(changedFiles);
         serverInvalidationState.reset();
     }
     /**

package/src/services/module-loading/README.md

@@ -33,7 +33,7 @@ Call site (route scan, renderer, SSG, API)
 2. **Disk transpile cache** (`.eco/.server-modules/.build-cache.json`) — production and stable development graphs when dependency hashes match. Manifest field `corePackageVersion` invalidates entries when the framework package changes.
 3. **Unified graph manifest** — production static export fast path only; see build layer docs.
 
-Development `?update=` query params use `sourceHash` plus a per-service import generation counter so Node and Bun bust ESM module cache after `invalidateDevelopmentGraph()` without a process-wide invalidation version in reuse keys.
+Development import URLs use `sourceHash` plus a per-service import generation counter. Node uses that value in its `?update=` query. Bun also receives a generation-specific compiled output filename because it retains a previously imported file when only its query changes. Both paths advance after `invalidateDevelopmentGraph()` without a process-wide invalidation version in reuse keys.
 
 ## Files
 
@@ -49,4 +49,4 @@ Development `?update=` query params use `sourceHash` plus a per-service import g
 
 ## Development invalidation
 
-`DevelopmentInvalidationService.invalidateServerModules()` calls `appModuleLoader.invalidateDevelopmentGraph()`, which clears the in-memory import cache, bumps the per-service dev import generation used only for `?update=` URLs, and clears dependency-hash memoization. Route-module disk reuse stays content-derived: unchanged source and dependency hashes keep their entries until the edited module or its graph changes.
+`DevelopmentInvalidationService.invalidateServerModules()` calls `appModuleLoader.invalidateDevelopmentGraph()`, which clears the in-memory import cache, bumps the per-service dev import generation used for runtime URLs and Bun output filenames, and clears dependency-hash memoization. It also clears persisted route-module entries: externalized generated modules can change without appearing in a route bundle's dependency graph, so retaining those entries could reload stale server HTML.

package/src/services/module-loading/page-module-import.service.js

@@ -127,10 +127,7 @@ export class PageModuleImportService {
     async loadModule(options) {
         const { filePath, fileHash, importCacheKey } = options;
         const { rootDir, outdir, splitting, externalPackages, transpileErrorMessage = (details) => `Error transpiling page module: ${details}`, noOutputMessage = (targetFilePath) => `No transpiled output generated for page module: ${targetFilePath}`, } = options;
-        const outputFileName = resolvePageModuleOutputFileName({
-            filePath,
-            fileHash,
-        });
+        const outputFileName = createRuntimeBuildOutputFileName(resolvePageModuleOutputFileName({ filePath, fileHash }), this.developmentImportGeneration);
         const outputNamingTemplate = outputFileName.replace(/\.mjs$/u, '.[ext]');
         const preferredOutputPath = path.join(outdir, outputFileName);
         const buildOptions = this.appConfig
@@ -229,3 +226,17 @@ function createRuntimeModuleUrl(filePath, fileHash, developmentImportGeneration)
 function shouldAddRuntimeUpdateQuery() {
     return process.env.NODE_ENV === 'development';
 }
+/**
+ * Gives Bun a distinct compiled module path after development invalidation.
+ *
+ * @remarks
+ * Bun does not reload an already-imported module when only its URL query changes.
+ * A dependency edit can leave the entrypoint source hash unchanged, so the output
+ * filename must include the import generation as well as the runtime query.
+ */
+function createRuntimeBuildOutputFileName(outputFileName, developmentImportGeneration) {
+    if (typeof Bun === 'undefined' || !shouldAddRuntimeUpdateQuery()) {
+        return outputFileName;
+    }
+    return outputFileName.replace(/\.mjs$/u, `-${developmentImportGeneration}.mjs`);
+}

package/src/services/module-loading/route-module-build-cache-registry.d.ts

@@ -22,3 +22,5 @@ export declare const getRouteModuleBuildCacheOutdir: typeof getServerModuleBuild
  * generation during the same build process.
  */
 export declare function getSharedRouteModuleBuildCache(outdir: string, appConfig?: EcoPagesAppConfig): RouteModuleBuildCache;
+/** Clears route-module cache entries that can retain stale external server modules during development. */
+export declare function clearAppDevelopmentRouteModuleBuildCaches(appConfig: EcoPagesAppConfig): void;

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

@@ -49,3 +49,15 @@ export function getSharedRouteModuleBuildCache(outdir, appConfig) {
     caches.set(outdir, routeModuleBuildCache);
     return routeModuleBuildCache;
 }
+/** Clears route-module cache entries that can retain stale external server modules during development. */
+export function clearAppDevelopmentRouteModuleBuildCaches(appConfig) {
+    const serverModuleCacheOutdir = getServerModuleBuildCacheOutdir(appConfig);
+    const caches = appConfig.runtime?.routeModuleBuildCaches;
+    const serverModuleCache = caches?.get(serverModuleCacheOutdir) ?? new RouteModuleBuildCache(serverModuleCacheOutdir);
+    serverModuleCache.clearDevelopmentEntries();
+    for (const cache of caches?.values() ?? []) {
+        if (cache !== serverModuleCache) {
+            cache.clearDevelopmentEntries();
+        }
+    }
+}

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

@@ -51,6 +51,16 @@ export declare class RouteModuleBuildCache {
         context: RouteModuleStaticRenderCacheContext;
     }): void;
     resetMemory(): void;
+    /**
+     * Removes every persisted route-module entry after development invalidation.
+     *
+     * @remarks
+     * Server bundles may externalize generated modules whose source dependencies
+     * are not present in the route bundle's dependency graph. Keeping an entry
+     * after its server graph changes can therefore reload a route that still
+     * imports an obsolete external bundle.
+     */
+    clearDevelopmentEntries(): void;
     pruneStaleRenderedOutputs(activePathnames: ReadonlySet<string>): string[];
     private loadManifest;
     private persistManifest;

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

@@ -164,6 +164,24 @@ export class RouteModuleBuildCache {
         this.manifest = undefined;
         this.manifestLoaded = false;
     }
+    /**
+     * Removes every persisted route-module entry after development invalidation.
+     *
+     * @remarks
+     * Server bundles may externalize generated modules whose source dependencies
+     * are not present in the route bundle's dependency graph. Keeping an entry
+     * after its server graph changes can therefore reload a route that still
+     * imports an obsolete external bundle.
+     */
+    clearDevelopmentEntries() {
+        if (!this.manifestLoaded && !this.dependencies.exists(this.manifestPath)) {
+            return;
+        }
+        const manifest = createEmptyRouteModuleBuildCacheManifest();
+        this.manifest = manifest;
+        this.manifestLoaded = true;
+        this.persistManifest(manifest);
+    }
     pruneStaleRenderedOutputs(activePathnames) {
         if (process.env.NODE_ENV !== 'production') {
             return [];