@ecopages/core 0.2.0-alpha.5 → 0.2.0-alpha.7

package/src/watchers/project-watcher.js

@@ -1,281 +0,0 @@
-import path from "node:path";
-import chokidar, {} from "chokidar";
-import { fileSystem } from "@ecopages/file-system";
-import { appLogger } from "../global/app-logger.js";
-class ProjectWatcher {
-  /**
-   * Duplicate identical watcher events within this window are ignored.
-   *
-   * Some editors or save pipelines emit two near-identical filesystem change
-   * notifications for the same file. Ecopages should treat those as one logical
-   * update so HMR and route refresh work are not repeated unnecessarily.
-   */
-  static duplicateChangeWindowMs = 150;
-  appConfig;
-  refreshRouterRoutesCallback;
-  hmrManager;
-  bridge;
-  watcher = null;
-  lastHandledChange = /* @__PURE__ */ new Map();
-  changeQueue = Promise.resolve();
-  constructor({ config, refreshRouterRoutesCallback, hmrManager, bridge }) {
-    this.appConfig = config;
-    this.refreshRouterRoutesCallback = refreshRouterRoutesCallback;
-    this.hmrManager = hmrManager;
-    this.bridge = bridge;
-    this.triggerRouterRefresh = this.triggerRouterRefresh.bind(this);
-    this.handleError = this.handleError.bind(this);
-    this.handleFileChange = this.handleFileChange.bind(this);
-  }
-  /**
-   * Uncaches modules in the source directory to ensure fresh imports.
-   * This is necessary for hot module replacement to work correctly.
-   * @private
-   */
-  uncacheModules() {
-    if (typeof require === "undefined") return;
-    const { srcDir, rootDir } = this.appConfig;
-    const regex = new RegExp(`${rootDir}/${srcDir}/.*`);
-    for (const key in require.cache) {
-      if (regex.test(key)) {
-        delete require.cache[key];
-      }
-    }
-  }
-  /**
-   * Handles public directory file changes by copying only the changed file.
-   * @param filePath - Absolute path of the changed file
-   */
-  async handlePublicDirFileChange(filePath) {
-    try {
-      const relativePath = path.relative(this.appConfig.absolutePaths.publicDir, filePath);
-      const destPath = path.join(this.appConfig.absolutePaths.distDir, relativePath);
-      if (fileSystem.exists(filePath)) {
-        const destDir = path.dirname(destPath);
-        fileSystem.ensureDir(destDir);
-        await fileSystem.copyFileAsync(filePath, destPath);
-      }
-      this.bridge.reload();
-    } catch (error) {
-      appLogger.error(`Failed to copy public file: ${error instanceof Error ? error.message : String(error)}`);
-      this.bridge.reload();
-    }
-  }
-  /**
-   * Serializes file change handling so that concurrent chokidar events are
-   * processed one at a time, preventing overlapping builds and race conditions.
-   */
-  enqueueChange(task) {
-    const queuedTask = this.changeQueue.then(task, task);
-    this.changeQueue = queuedTask.catch(() => void 0);
-  }
-  /**
-   * Handles file changes by uncaching modules, refreshing routes, and delegating appropriately.
-   * Follows 4-rule priority:
-   * 0. Public directory match? -> copy file and reload
-   * 1. additionalWatchPaths match? -> reload
-   * 2. Processor-owned asset? -> processor already handled it via notification, skip HMR
-   * 3. Otherwise -> HMR strategies
-   *
-   * Processors that watch a file extension as a dependency (e.g. PostCSS watching
-   * .tsx for Tailwind class scanning) are always notified first, but do not
-   * prevent the file from flowing through the normal HMR strategy pipeline.
-   *
-   * Duplicate identical watcher events for the same file are coalesced within a
-   * short window before any of the priority rules run.
-   * @param rawPath - Path of the changed file
-   * @param event - The type of file system event
-   */
-  async handleFileChange(rawPath, event = "change") {
-    const filePath = path.resolve(rawPath);
-    const now = Date.now();
-    const lastHandledAt = this.lastHandledChange.get(filePath);
-    if (lastHandledAt !== void 0 && now - lastHandledAt < ProjectWatcher.duplicateChangeWindowMs) {
-      return;
-    }
-    this.lastHandledChange.set(filePath, now);
-    try {
-      if (this.isPublicDirFile(filePath)) {
-        await this.handlePublicDirFileChange(filePath);
-        return;
-      }
-      this.uncacheModules();
-      const isPageFile = filePath.startsWith(this.appConfig.absolutePaths.pagesDir);
-      if (isPageFile) {
-        this.refreshRouterRoutesCallback();
-      }
-      if (this.matchesAdditionalWatchPaths(filePath)) {
-        this.bridge.reload();
-        return;
-      }
-      await this.notifyProcessors(filePath, event);
-      if (this.isHandledByProcessor(filePath)) {
-        return;
-      }
-      await this.hmrManager.handleFileChange(filePath);
-    } catch (error) {
-      if (error instanceof Error) {
-        this.bridge.error(error.message);
-        this.handleError(error);
-      }
-    }
-  }
-  /**
-   * Notifies all processors whose watch config matches the given file extension.
-   * This is called before checking processor ownership so that dependency-only
-   * processors (e.g. PostCSS watching .tsx for class scanning) receive their
-   * notifications regardless of whether they own the file.
-   */
-  async notifyProcessors(filePath, event) {
-    const ctx = { path: filePath, bridge: this.bridge };
-    for (const processor of this.appConfig.processors.values()) {
-      const watchConfig = processor.getWatchConfig();
-      if (!watchConfig) continue;
-      const { extensions = [] } = watchConfig;
-      if (extensions.length && !extensions.some((ext) => filePath.endsWith(ext))) {
-        continue;
-      }
-      const handler = this.getProcessorHandler(watchConfig, event);
-      if (handler) {
-        await handler(ctx);
-      }
-    }
-  }
-  getProcessorHandler(watchConfig, event) {
-    switch (event) {
-      case "change":
-        return watchConfig.onChange;
-      case "add":
-        return watchConfig.onCreate;
-      case "unlink":
-        return watchConfig.onDelete;
-    }
-  }
-  /**
-   * Checks if a file is in the public directory.
-   */
-  isPublicDirFile(filePath) {
-    return filePath.startsWith(this.appConfig.absolutePaths.publicDir);
-  }
-  /**
-   * Checks if file path matches any additionalWatchPaths patterns.
-   */
-  matchesAdditionalWatchPaths(filePath) {
-    const patterns = this.appConfig.additionalWatchPaths;
-    if (!patterns.length) return false;
-    for (const pattern of patterns) {
-      if (pattern.includes("*")) {
-        const ext = pattern.replace(/\*\*?\/\*/, "");
-        if (filePath.endsWith(ext)) return true;
-      } else {
-        if (filePath.endsWith(pattern) || filePath === path.resolve(pattern)) return true;
-      }
-    }
-    return false;
-  }
-  /**
-   * Checks if a file is handled by a processor.
-   * Processors that declare asset capabilities own those file types.
-   * Processors without capabilities fall back to checking watch extensions.
-   */
-  isHandledByProcessor(filePath) {
-    for (const processor of this.appConfig.processors.values()) {
-      const capabilities = processor.getAssetCapabilities?.() ?? [];
-      if (capabilities.length > 0) {
-        const matchesConfiguredAsset = typeof processor.matchesFileFilter !== "function" || processor.matchesFileFilter(filePath);
-        if (matchesConfiguredAsset && capabilities.some((capability) => processor.canProcessAsset?.(capability.kind, filePath))) {
-          return true;
-        }
-        continue;
-      }
-      const watchConfig = processor.getWatchConfig();
-      if (!watchConfig) continue;
-      const { extensions = [] } = watchConfig;
-      if (extensions.length && extensions.some((ext) => filePath.endsWith(ext))) {
-        return true;
-      }
-    }
-    return false;
-  }
-  /**
-   * Triggers router refresh for page directory changes.
-   * This ensures the router is updated when pages are added or removed.
-   *
-   * @param {string} path - Path of the changed directory
-   */
-  triggerRouterRefresh(path2) {
-    const isPageDir = path2.startsWith(this.appConfig.absolutePaths.pagesDir);
-    if (isPageDir) {
-      this.refreshRouterRoutesCallback();
-    }
-  }
-  /**
-   * Handles and logs errors that occur during file watching.
-   *
-   * @param {unknown} error - The error to handle
-   */
-  handleError(error) {
-    if (error instanceof Error) {
-      this.hmrManager.broadcast({ type: "error", message: error.message });
-    }
-    appLogger.error(`Watcher error: ${error}`);
-  }
-  /**
-   * Creates and configures the file system watcher.
-   * This sets up:
-   * 1. Page file watching
-   * 2. Directory watching
-   * 3. Error handling
-   *
-   * Processor notifications are dispatched inside handleFileChange, ensuring
-   * a single unified event pipeline with no parallel chokidar bindings.
-   *
-   * Uses chokidar's built-in debouncing through `awaitWriteFinish` to handle
-   * rapid file changes efficiently.
-   */
-  async createWatcherSubscription() {
-    if (!this.watcher) {
-      const processorPaths = [];
-      for (const processor of this.appConfig.processors.values()) {
-        const watchConfig = processor.getWatchConfig();
-        if (!watchConfig) continue;
-        processorPaths.push(...watchConfig.paths);
-      }
-      if (fileSystem.exists(this.appConfig.absolutePaths.pagesDir)) {
-        processorPaths.push(this.appConfig.absolutePaths.pagesDir);
-      }
-      if (fileSystem.exists(this.appConfig.absolutePaths.publicDir)) {
-        processorPaths.push(this.appConfig.absolutePaths.publicDir);
-      }
-      if (this.appConfig.additionalWatchPaths.length) {
-        processorPaths.push(...this.appConfig.additionalWatchPaths);
-      }
-      this.watcher = chokidar.watch(processorPaths, {
-        ignoreInitial: true,
-        ignorePermissionErrors: true,
-        awaitWriteFinish: {
-          stabilityThreshold: 50,
-          pollInterval: 50
-        }
-      });
-    }
-    this.watcher.add(this.appConfig.absolutePaths.srcDir);
-    this.watcher.on("change", (p) => this.enqueueChange(() => this.handleFileChange(p, "change"))).on("add", (p) => {
-      this.enqueueChange(() => this.handleFileChange(p, "add"));
-      this.triggerRouterRefresh(p);
-    }).on("addDir", (p) => this.triggerRouterRefresh(p)).on("unlink", (p) => {
-      this.enqueueChange(() => this.handleFileChange(p, "unlink"));
-      this.triggerRouterRefresh(p);
-    }).on("unlinkDir", (p) => this.triggerRouterRefresh(p)).on("error", (error) => this.handleError(error));
-    for (const processor of this.appConfig.processors.values()) {
-      const watchConfig = processor.getWatchConfig();
-      if (watchConfig?.onError) {
-        this.watcher.on("error", watchConfig.onError);
-      }
-    }
-    return this.watcher;
-  }
-}
-export {
-  ProjectWatcher
-};

package/src/watchers/project-watcher.test-helpers.d.ts

@@ -1,4 +0,0 @@
-import type { IHmrManager } from '../internal-types';
-import type { ClientBridge } from '../adapters/bun/client-bridge';
-export declare const createMockHmrManager: () => IHmrManager;
-export declare const createMockBridge: () => ClientBridge;

package/src/watchers/project-watcher.test-helpers.js

@@ -1,51 +0,0 @@
-import { vi } from "vitest";
-const createMockHmrManager = () => ({
-  handleFileChange: vi.fn(async () => {
-  }),
-  broadcast: vi.fn(() => {
-  }),
-  setEnabled: vi.fn(() => {
-  }),
-  setPlugins: vi.fn(() => {
-  }),
-  registerEntrypoint: vi.fn(async () => ""),
-  registerSpecifierMap: vi.fn(() => {
-  }),
-  registerStrategy: vi.fn(() => {
-  }),
-  isEnabled: vi.fn(() => true),
-  getOutputUrl: vi.fn(() => void 0),
-  getWatchedFiles: vi.fn(() => /* @__PURE__ */ new Map()),
-  getSpecifierMap: vi.fn(() => /* @__PURE__ */ new Map()),
-  getDistDir: vi.fn(() => ""),
-  getPlugins: vi.fn(() => []),
-  getDefaultContext: vi.fn(() => ({
-    getWatchedFiles: () => /* @__PURE__ */ new Map(),
-    getSpecifierMap: () => /* @__PURE__ */ new Map(),
-    getDistDir: () => "",
-    getPlugins: () => [],
-    getSrcDir: () => "",
-    getLayoutsDir: () => ""
-  }))
-});
-const createMockBridge = () => ({
-  reload: vi.fn(() => {
-  }),
-  error: vi.fn(() => {
-  }),
-  cssUpdate: vi.fn(() => {
-  }),
-  update: vi.fn(() => {
-  }),
-  subscribe: vi.fn(() => {
-  }),
-  unsubscribe: vi.fn(() => {
-  }),
-  broadcast: vi.fn(() => {
-  }),
-  subscriberCount: 0
-});
-export {
-  createMockBridge,
-  createMockHmrManager
-};