@ecopages/core 0.2.0-rc.5 → 0.2.0-rc.6

package/README.md

@@ -53,7 +53,10 @@ flowchart TD
 	B --> C[DevelopmentInvalidationService]
 	C --> D{Change kind}
 	D -->|Route or server source| E[Invalidate server modules]
-	D -->|Public or include| F[Reload browser]
+	D -->|Additional watch| E
+	E --> N[Notify processors]
+	N --> F[Reload browser]
+	D -->|Public asset| F
 	D -->|Processor-owned asset| G[Notify processor only]
 	D -->|HMR-eligible source| H[Core HMR manager]
 	H --> I[Strategy selection]

package/package.json

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

package/src/plugins/README.md

@@ -37,6 +37,7 @@ These contracts are responsible for:
 2. Core seals the app-owned build manifest.
 3. Runtime startup calls runtime-only setup hooks.
 4. Request-time rendering and development invalidation reuse those finalized contracts.
+5. `DevelopmentInvalidationService.invalidateServerModules()` calls `Processor.invalidateServerArtifacts()` so processors can discard compiled server artifacts that are not part of the route-module graph.
 
 ## Discovered dependency metadata
 

package/src/plugins/processor.d.ts

@@ -147,6 +147,10 @@ export declare abstract class Processor<TOptions = Record<string, unknown>> {
     didChange(): boolean;
     abstract setup(): Promise<void>;
     abstract process(input: unknown, filePath?: string): Promise<unknown>;
+    /**
+     * Discards cached server build artifacts when server modules are invalidated.
+     */
+    invalidateServerArtifacts(): void;
     /**
      * Releases runtime resources owned by the processor.
      *

package/src/plugins/processor.js

@@ -108,6 +108,10 @@ export class Processor {
     didChange() {
         return false;
     }
+    /**
+     * Discards cached server build artifacts when server modules are invalidated.
+     */
+    invalidateServerArtifacts() { }
     /**
      * Releases runtime resources owned by the processor.
      *

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

@@ -2,6 +2,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';
+import { clearCollectionServerBuildArtifacts } from '../module-loading/collection-server-module-build.service.js';
 /**
  * Framework-owned development invalidation service.
  *
@@ -31,6 +32,10 @@ export class DevelopmentInvalidationService {
         getAppServerInvalidationState(this.appConfig).invalidateServerModules(changedFiles);
         this.appConfig.runtime?.appModuleLoader?.invalidateDevelopmentGraph();
         clearAppDevelopmentRouteModuleBuildCaches(this.appConfig);
+        clearCollectionServerBuildArtifacts(this.appConfig);
+        for (const processor of this.appConfig.processors.values()) {
+            processor.invalidateServerArtifacts?.();
+        }
     }
     /**
      * Registers an integration-owned handler for registered script entrypoint edits.
@@ -80,7 +85,7 @@ export class DevelopmentInvalidationService {
         if (this.matchesAdditionalWatchPaths(filePath)) {
             return {
                 category: 'additional-watch',
-                invalidateServerModules: false,
+                invalidateServerModules: true,
                 refreshRoutes: false,
                 reloadBrowser: true,
                 delegateToHmr: false,
@@ -162,11 +167,13 @@ export class DevelopmentInvalidationService {
             return false;
         for (const pattern of patterns) {
             if (pattern.includes('*')) {
-                const ext = pattern.replace(/\*\*?\/\*/, '');
+                const ext = pattern.replace(/\*\*?\/\*|\*+/g, '');
                 if (normalizedPath.endsWith(ext))
                     return true;
+                continue;
             }
-            else if (normalizedPath.endsWith(pattern) || normalizedPath === path.resolve(pattern)) {
+            const resolvedPattern = path.isAbsolute(pattern) ? pattern : path.resolve(this.appConfig.rootDir, pattern);
+            if (normalizedPath === resolvedPattern || normalizedPath.startsWith(`${resolvedPattern}${path.sep}`)) {
                 return true;
             }
         }

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

@@ -35,6 +35,8 @@ Call site (route scan, renderer, SSG, API)
 
 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.
 
+Compiled collection server modules also include the app-owned server invalidation version in their output filename (`<collection>-<buildIdentity>-<invalidationVersion>.mjs`) so Node's ESM loader treats recompiled bundles as new modules after co-located helper files change.
+
 ## Files
 
 | File                                      | Role                                                      |

package/src/services/module-loading/collection-server-module-build.service.d.ts

@@ -5,6 +5,7 @@ export type CollectionServerBuildArtifact = {
     outputUrl: string;
     sourcePaths: string[];
     buildIdentity: string;
+    invalidationVersion: number;
 };
 export declare function getCollectionServerBuildArtifact(appConfig: EcoPagesAppConfig, collectionName: string): CollectionServerBuildArtifact | undefined;
 export declare function clearCollectionServerBuildArtifacts(appConfig: EcoPagesAppConfig): void;

package/src/services/module-loading/collection-server-module-build.service.js

@@ -7,6 +7,7 @@ import { createServerBuildRequest } from '../../build/runtime/build-request-poli
 import { recordCollectionBuild } from '../../diagnostics/request-pipeline-metrics.js';
 import { resolveInternalExecutionDir } from '../../utils/resolve-work-dir.js';
 import { fileSystem } from '@ecopages/file-system';
+import { getAppServerInvalidationState } from '../runtime-state/server-invalidation-state.service.js';
 const artifactsByCollection = new WeakMap();
 function getArtifactMap(appConfig) {
     let artifacts = artifactsByCollection.get(appConfig);
@@ -51,13 +52,14 @@ export async function buildCollectionServerModule(input) {
         splitting: false,
         externalPackages: true,
     });
+    const invalidationVersion = getAppServerInvalidationState(appConfig).getServerInvalidationVersion();
     const buildIdentity = createCollectionBuildIdentity(createBuildRequestIdentity(buildRequest), sourceFilePath, ownedSourcePaths);
     const artifacts = getArtifactMap(appConfig);
     const existing = artifacts.get(collectionName);
-    if (existing?.buildIdentity === buildIdentity) {
+    if (existing?.buildIdentity === buildIdentity && existing?.invalidationVersion === invalidationVersion) {
         return existing;
     }
-    const outputFileName = `${collectionName}-${buildIdentity}.mjs`;
+    const outputFileName = `${collectionName}-${buildIdentity}-${invalidationVersion}.mjs`;
     const buildOptions = { ...buildRequest, naming: outputFileName.replace(/\.mjs$/u, '.[ext]') };
     recordCollectionBuild();
     const buildResult = await build(buildOptions);
@@ -77,6 +79,7 @@ export async function buildCollectionServerModule(input) {
         outputUrl: pathToFileURL(compiledOutput).href,
         sourcePaths: [...ownedSourcePaths, sourceFilePath],
         buildIdentity,
+        invalidationVersion,
     };
     artifacts.set(collectionName, artifact);
     return artifact;

package/src/watchers/project-watcher.js

@@ -184,6 +184,7 @@ export class ProjectWatcher {
                 await this.refreshRouterRoutesCallback();
             }
             if (plan.reloadBrowser) {
+                await this.notifyProcessors(filePath, event);
                 this.requestBrowserReload();
                 return;
             }
@@ -364,7 +365,10 @@ export class ProjectWatcher {
             processorPaths.add(this.appConfig.absolutePaths.publicDir);
         }
         for (const watchPath of this.appConfig.additionalWatchPaths) {
-            processorPaths.add(watchPath);
+            const resolvedWatchPath = path.isAbsolute(watchPath) || watchPath.includes('*')
+                ? watchPath
+                : path.resolve(this.appConfig.rootDir, watchPath);
+            processorPaths.add(resolvedWatchPath);
         }
         const ignored = createProjectWatcherIgnorePredicate(this.appConfig.absolutePaths);
         this.watcher = chokidar.watch(Array.from(processorPaths), {