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

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

@@ -1,243 +1,254 @@
-import path from "node:path";
-import { getAppServerInvalidationState } from "../runtime-state/server-invalidation-state.service.js";
-import { appLogger } from "../../global/app-logger.js";
-class DevelopmentInvalidationService {
-  appConfig;
-  constructor(appConfig) {
-    this.appConfig = appConfig;
-  }
-  /**
-   * Returns the current app-owned server-module invalidation version.
-   */
-  getServerModuleInvalidationVersion() {
-    return getAppServerInvalidationState(this.appConfig).getServerInvalidationVersion();
-  }
-  /**
-   * Invalidates the app-owned server-module graph.
-   */
-  invalidateServerModules(changedFiles) {
-    getAppServerInvalidationState(this.appConfig).invalidateServerModules(changedFiles);
-    this.appConfig.runtime?.appModuleLoader?.invalidateDevelopmentGraph();
-  }
-  /**
-   * Registers an integration-owned handler for registered script entrypoint edits.
-   */
-  registerRegisteredScriptEntrypointChangeHandler(handler) {
-    const runtime = this.appConfig.runtime ?? {};
-    this.appConfig.runtime = runtime;
-    runtime.registeredScriptEntrypointChangeHandlers ??= [];
-    runtime.registeredScriptEntrypointChangeHandlers.push(handler);
-  }
-  /**
-   * Notifies integration handlers that a registered script entrypoint changed.
-   */
-  async notifyRegisteredScriptEntrypointChange(filePath) {
-    const handlers = this.appConfig.runtime?.registeredScriptEntrypointChangeHandlers ?? [];
-    for (const handler of handlers) {
-      try {
-        await handler(filePath);
-      } catch (error) {
-        appLogger.error(
-          `Failed to handle registered script entrypoint change for ${filePath}: ${error instanceof Error ? error.message : String(error)}`
-        );
-      }
+import path from 'node:path';
+import { getAppServerInvalidationState } from '../runtime-state/server-invalidation-state.service.js';
+import { appLogger } from '../../global/app-logger.js';
+/**
+ * Framework-owned development invalidation service.
+ *
+ * @remarks
+ * This service centralizes two responsibilities:
+ * - file-change classification for watcher behavior
+ * - app-owned server-module invalidation versioning backed by the dev graph
+ *
+ * Hosts and watchers should ask this service what a file change means instead
+ * of deciding invalidation semantics inline.
+ */
+export class DevelopmentInvalidationService {
+    appConfig;
+    constructor(appConfig) {
+        this.appConfig = appConfig;
+    }
+    /**
+     * Returns the current app-owned server-module invalidation version.
+     */
+    getServerModuleInvalidationVersion() {
+        return getAppServerInvalidationState(this.appConfig).getServerInvalidationVersion();
+    }
+    /**
+     * Invalidates the app-owned server-module graph.
+     */
+    invalidateServerModules(changedFiles) {
+        getAppServerInvalidationState(this.appConfig).invalidateServerModules(changedFiles);
+        this.appConfig.runtime?.appModuleLoader?.invalidateDevelopmentGraph();
+    }
+    /**
+     * Registers an integration-owned handler for registered script entrypoint edits.
+     */
+    registerRegisteredScriptEntrypointChangeHandler(handler) {
+        const runtime = this.appConfig.runtime ?? {};
+        this.appConfig.runtime = runtime;
+        runtime.registeredScriptEntrypointChangeHandlers ??= [];
+        runtime.registeredScriptEntrypointChangeHandlers.push(handler);
+    }
+    /**
+     * Notifies integration handlers that a registered script entrypoint changed.
+     */
+    async notifyRegisteredScriptEntrypointChange(filePath) {
+        const handlers = this.appConfig.runtime?.registeredScriptEntrypointChangeHandlers ?? [];
+        for (const handler of handlers) {
+            try {
+                await handler(filePath);
+            }
+            catch (error) {
+                appLogger.error(`Failed to handle registered script entrypoint change for ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    /**
+     * Resets runtime-owned graph state and invalidates server modules.
+     */
+    resetRuntimeState(changedFiles) {
+        const serverInvalidationState = getAppServerInvalidationState(this.appConfig);
+        serverInvalidationState.invalidateServerModules(changedFiles);
+        serverInvalidationState.reset();
+    }
+    /**
+     * Classifies one changed file into an explicit framework invalidation plan.
+     */
+    planFileChange(filePath) {
+        if (this.isPublicDirFile(filePath)) {
+            return {
+                category: 'public-asset',
+                invalidateServerModules: false,
+                refreshRoutes: false,
+                reloadBrowser: true,
+                delegateToHmr: false,
+                processorHandledAsset: false,
+            };
+        }
+        if (this.matchesAdditionalWatchPaths(filePath)) {
+            return {
+                category: 'additional-watch',
+                invalidateServerModules: false,
+                refreshRoutes: false,
+                reloadBrowser: true,
+                delegateToHmr: false,
+                processorHandledAsset: false,
+            };
+        }
+        if (this.isIncludeSourceFile(filePath)) {
+            return {
+                category: 'include-source',
+                invalidateServerModules: true,
+                refreshRoutes: false,
+                reloadBrowser: false,
+                delegateToHmr: true,
+                processorHandledAsset: false,
+            };
+        }
+        if (this.isExplicitServerViewFile(filePath)) {
+            return {
+                category: 'explicit-server-view',
+                invalidateServerModules: true,
+                refreshRoutes: false,
+                reloadBrowser: false,
+                delegateToHmr: true,
+                processorHandledAsset: false,
+            };
+        }
+        if (this.isRouteSourceFile(filePath)) {
+            return {
+                category: 'route-source',
+                invalidateServerModules: true,
+                refreshRoutes: true,
+                reloadBrowser: false,
+                delegateToHmr: true,
+                processorHandledAsset: false,
+            };
+        }
+        if (this.isProcessorOwnedAsset(filePath)) {
+            return {
+                category: 'processor-owned-asset',
+                invalidateServerModules: false,
+                refreshRoutes: false,
+                reloadBrowser: false,
+                delegateToHmr: false,
+                processorHandledAsset: true,
+            };
+        }
+        if (this.isServerModuleSourceFile(filePath)) {
+            return {
+                category: 'server-source',
+                invalidateServerModules: true,
+                refreshRoutes: false,
+                reloadBrowser: false,
+                delegateToHmr: true,
+                processorHandledAsset: false,
+            };
+        }
+        return {
+            category: 'other',
+            invalidateServerModules: false,
+            refreshRoutes: false,
+            reloadBrowser: false,
+            delegateToHmr: true,
+            processorHandledAsset: false,
+        };
+    }
+    /**
+     * Returns whether the file lives under the public directory.
+     */
+    isPublicDirFile(filePath) {
+        return path.resolve(filePath).startsWith(this.appConfig.absolutePaths.publicDir);
+    }
+    /**
+     * Returns whether the file matches `additionalWatchPaths`.
+     */
+    matchesAdditionalWatchPaths(filePath) {
+        const normalizedPath = path.resolve(filePath);
+        const patterns = this.appConfig.additionalWatchPaths;
+        if (!patterns.length)
+            return false;
+        for (const pattern of patterns) {
+            if (pattern.includes('*')) {
+                const ext = pattern.replace(/\*\*?\/\*/, '');
+                if (normalizedPath.endsWith(ext))
+                    return true;
+            }
+            else if (normalizedPath.endsWith(pattern) || normalizedPath === path.resolve(pattern)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Returns whether the file is a route source file.
+     */
+    isRouteSourceFile(filePath) {
+        const resolvedPath = path.resolve(filePath);
+        if (!resolvedPath.startsWith(this.appConfig.absolutePaths.pagesDir)) {
+            return false;
+        }
+        if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
+            return true;
+        }
+        return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
+    }
+    /**
+     * Returns whether the file is an include/template source file.
+     */
+    isIncludeSourceFile(filePath) {
+        const resolvedPath = path.resolve(filePath);
+        if (!resolvedPath.startsWith(this.appConfig.absolutePaths.includesDir)) {
+            return false;
+        }
+        if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
+            return true;
+        }
+        return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
+    }
+    /**
+     * Returns whether the file is an explicit server-rendered view module.
+     *
+     * @remarks
+     * These modules are typically registered through `renderServerModule` in
+     * `app.ts` rather than the filesystem router. They need a full browser reload
+     * because their HTML is produced on the server, not through client HMR entrypoints.
+     */
+    isExplicitServerViewFile(filePath) {
+        const resolvedPath = path.resolve(filePath);
+        const viewsDir = path.join(this.appConfig.absolutePaths.srcDir, 'views');
+        if (resolvedPath !== viewsDir && !resolvedPath.startsWith(`${viewsDir}${path.sep}`)) {
+            return false;
+        }
+        if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
+            return true;
+        }
+        return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
+    }
+    /**
+     * Returns whether the file is a server-executed source module outside the
+     * special route/include buckets.
+     */
+    isServerModuleSourceFile(filePath) {
+        const resolvedPath = path.resolve(filePath);
+        if (!resolvedPath.startsWith(this.appConfig.absolutePaths.srcDir)) {
+            return false;
+        }
+        if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
+            return true;
+        }
+        return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
+    }
+    /**
+     * Returns whether a processor owns the changed file as an asset input.
+     *
+     * @remarks
+     * Watch config drives processor notifications only. Asset ownership requires
+     * declared capabilities so dependency-only watches (for example content
+     * collection MDX scans) do not skip server invalidation and HMR.
+     */
+    isProcessorOwnedAsset(filePath) {
+        for (const processor of this.appConfig.processors.values()) {
+            const capabilities = processor.getAssetCapabilities?.() ?? [];
+            if (capabilities.length === 0) {
+                continue;
+            }
+            const matchesConfiguredAsset = typeof processor.matchesFileFilter !== 'function' || processor.matchesFileFilter(filePath);
+            if (matchesConfiguredAsset &&
+                capabilities.some((capability) => processor.canProcessAsset?.(capability.kind, filePath))) {
+                return true;
+            }
+        }
+        return false;
     }
-  }
-  /**
-   * Resets runtime-owned graph state and invalidates server modules.
-   */
-  resetRuntimeState(changedFiles) {
-    const serverInvalidationState = getAppServerInvalidationState(this.appConfig);
-    serverInvalidationState.invalidateServerModules(changedFiles);
-    serverInvalidationState.reset();
-  }
-  /**
-   * Classifies one changed file into an explicit framework invalidation plan.
-   */
-  planFileChange(filePath) {
-    if (this.isPublicDirFile(filePath)) {
-      return {
-        category: "public-asset",
-        invalidateServerModules: false,
-        refreshRoutes: false,
-        reloadBrowser: true,
-        delegateToHmr: false,
-        processorHandledAsset: false
-      };
-    }
-    if (this.matchesAdditionalWatchPaths(filePath)) {
-      return {
-        category: "additional-watch",
-        invalidateServerModules: false,
-        refreshRoutes: false,
-        reloadBrowser: true,
-        delegateToHmr: false,
-        processorHandledAsset: false
-      };
-    }
-    if (this.isIncludeSourceFile(filePath)) {
-      return {
-        category: "include-source",
-        invalidateServerModules: true,
-        refreshRoutes: false,
-        reloadBrowser: false,
-        delegateToHmr: true,
-        processorHandledAsset: false
-      };
-    }
-    if (this.isExplicitServerViewFile(filePath)) {
-      return {
-        category: "explicit-server-view",
-        invalidateServerModules: true,
-        refreshRoutes: false,
-        reloadBrowser: false,
-        delegateToHmr: true,
-        processorHandledAsset: false
-      };
-    }
-    if (this.isRouteSourceFile(filePath)) {
-      return {
-        category: "route-source",
-        invalidateServerModules: true,
-        refreshRoutes: true,
-        reloadBrowser: false,
-        delegateToHmr: true,
-        processorHandledAsset: false
-      };
-    }
-    if (this.isProcessorOwnedAsset(filePath)) {
-      return {
-        category: "processor-owned-asset",
-        invalidateServerModules: false,
-        refreshRoutes: false,
-        reloadBrowser: false,
-        delegateToHmr: false,
-        processorHandledAsset: true
-      };
-    }
-    if (this.isServerModuleSourceFile(filePath)) {
-      return {
-        category: "server-source",
-        invalidateServerModules: true,
-        refreshRoutes: false,
-        reloadBrowser: false,
-        delegateToHmr: true,
-        processorHandledAsset: false
-      };
-    }
-    return {
-      category: "other",
-      invalidateServerModules: false,
-      refreshRoutes: false,
-      reloadBrowser: false,
-      delegateToHmr: true,
-      processorHandledAsset: false
-    };
-  }
-  /**
-   * Returns whether the file lives under the public directory.
-   */
-  isPublicDirFile(filePath) {
-    return path.resolve(filePath).startsWith(this.appConfig.absolutePaths.publicDir);
-  }
-  /**
-   * Returns whether the file matches `additionalWatchPaths`.
-   */
-  matchesAdditionalWatchPaths(filePath) {
-    const normalizedPath = path.resolve(filePath);
-    const patterns = this.appConfig.additionalWatchPaths;
-    if (!patterns.length) return false;
-    for (const pattern of patterns) {
-      if (pattern.includes("*")) {
-        const ext = pattern.replace(/\*\*?\/\*/, "");
-        if (normalizedPath.endsWith(ext)) return true;
-      } else if (normalizedPath.endsWith(pattern) || normalizedPath === path.resolve(pattern)) {
-        return true;
-      }
-    }
-    return false;
-  }
-  /**
-   * Returns whether the file is a route source file.
-   */
-  isRouteSourceFile(filePath) {
-    const resolvedPath = path.resolve(filePath);
-    if (!resolvedPath.startsWith(this.appConfig.absolutePaths.pagesDir)) {
-      return false;
-    }
-    if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
-      return true;
-    }
-    return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
-  }
-  /**
-   * Returns whether the file is an include/template source file.
-   */
-  isIncludeSourceFile(filePath) {
-    const resolvedPath = path.resolve(filePath);
-    if (!resolvedPath.startsWith(this.appConfig.absolutePaths.includesDir)) {
-      return false;
-    }
-    if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
-      return true;
-    }
-    return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
-  }
-  /**
-   * Returns whether the file is an explicit server-rendered view module.
-   *
-   * @remarks
-   * These modules are typically registered through `renderServerModule` in
-   * `app.ts` rather than the filesystem router. They need a full browser reload
-   * because their HTML is produced on the server, not through client HMR entrypoints.
-   */
-  isExplicitServerViewFile(filePath) {
-    const resolvedPath = path.resolve(filePath);
-    const viewsDir = path.join(this.appConfig.absolutePaths.srcDir, "views");
-    if (resolvedPath !== viewsDir && !resolvedPath.startsWith(`${viewsDir}${path.sep}`)) {
-      return false;
-    }
-    if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
-      return true;
-    }
-    return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
-  }
-  /**
-   * Returns whether the file is a server-executed source module outside the
-   * special route/include buckets.
-   */
-  isServerModuleSourceFile(filePath) {
-    const resolvedPath = path.resolve(filePath);
-    if (!resolvedPath.startsWith(this.appConfig.absolutePaths.srcDir)) {
-      return false;
-    }
-    if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
-      return true;
-    }
-    return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
-  }
-  /**
-   * Returns whether a processor owns the changed file as an asset input.
-   *
-   * @remarks
-   * Watch config drives processor notifications only. Asset ownership requires
-   * declared capabilities so dependency-only watches (for example content
-   * collection MDX scans) do not skip server invalidation and HMR.
-   */
-  isProcessorOwnedAsset(filePath) {
-    for (const processor of this.appConfig.processors.values()) {
-      const capabilities = processor.getAssetCapabilities?.() ?? [];
-      if (capabilities.length === 0) {
-        continue;
-      }
-      const matchesConfiguredAsset = typeof processor.matchesFileFilter !== "function" || processor.matchesFileFilter(filePath);
-      if (matchesConfiguredAsset && capabilities.some((capability) => processor.canProcessAsset?.(capability.kind, filePath))) {
-        return true;
-      }
-    }
-    return false;
-  }
 }
-export {
-  DevelopmentInvalidationService
-};

package/src/services/module-loading/app-module-loader.service.js

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