@eggjs/watcher 5.0.0-beta.18 → 5.0.0-beta.20

package/dist/agent.d.ts

@@ -1,2 +1,2 @@
-import { Boot } from "./lib/boot.js";
+import { Boot } from "./boot-DG5R1PH_.js";
 export { Boot as default };

package/dist/agent.js

@@ -1,4 +1,7 @@
-import { Boot } from "./lib/boot.js";
+import "./base-C8f9YO9e.js";
+import "./utils-BSqdCAAj.js";
+import "./watcher-BGaGRNx5.js";
+import { Boot } from "./boot-0zKWMxhf.js";
 
 //#region src/agent.ts
 var agent_default = Boot;

package/dist/app.d.ts

@@ -1,2 +1,2 @@
-import { Boot } from "./lib/boot.js";
+import { Boot } from "./boot-DG5R1PH_.js";
 export { Boot as default };

package/dist/app.js

@@ -1,4 +1,7 @@
-import { Boot } from "./lib/boot.js";
+import "./base-C8f9YO9e.js";
+import "./utils-BSqdCAAj.js";
+import "./watcher-BGaGRNx5.js";
+import { Boot } from "./boot-0zKWMxhf.js";
 
 //#region src/app.ts
 var app_default = Boot;

package/dist/base-C8f9YO9e.js

@@ -0,0 +1,7 @@
+import { Base } from "sdk-base";
+
+//#region src/lib/event-sources/base.ts
+var BaseEventSource = class extends Base {};
+
+//#endregion
+export { BaseEventSource };

package/dist/base-DJbFfMBT.d.ts

@@ -0,0 +1,9 @@
+import { Base } from "sdk-base";
+
+//#region src/lib/event-sources/base.d.ts
+declare abstract class BaseEventSource extends Base {
+  abstract watch(file: string): void;
+  abstract unwatch(file: string): void;
+}
+//#endregion
+export { BaseEventSource };

package/dist/boot-0zKWMxhf.js

@@ -0,0 +1,26 @@
+import { Watcher } from "./watcher-BGaGRNx5.js";
+import { debuglog } from "node:util";
+
+//#region src/lib/boot.ts
+const debug = debuglog("egg/watcher/lib/boot");
+var Boot = class {
+	#app;
+	constructor(appOrAgent) {
+		this.#app = appOrAgent;
+		if (this.#app.options.mode === "all-in-one-process") {
+			debug("init watcher in all-in-one-process mode");
+			this.#app.watcher = new Watcher(appOrAgent.config);
+		} else {
+			debug("init watcher in cluster mode");
+			this.#app.watcher = this.#app.clusterWrapper(Watcher, {}).delegate("watch", "subscribe").create(appOrAgent.config);
+		}
+		this.#app.watcher.on("info", (msg, ...args) => this.#app.coreLogger.info(msg, ...args)).on("warn", (msg, ...args) => this.#app.coreLogger.warn(msg, ...args)).on("error", (msg, ...args) => this.#app.coreLogger.error(msg, ...args));
+	}
+	async didLoad() {
+		await this.#app.watcher.ready();
+		this.#app.coreLogger.info("[@eggjs/watcher:%s] watcher start success", this.#app.type);
+	}
+};
+
+//#endregion
+export { Boot };

package/dist/boot-DG5R1PH_.d.ts

@@ -0,0 +1,10 @@
+import { EggApplicationCore, ILifecycleBoot } from "egg";
+
+//#region src/lib/boot.d.ts
+declare class Boot implements ILifecycleBoot {
+  #private;
+  constructor(appOrAgent: EggApplicationCore);
+  didLoad(): Promise<void>;
+}
+//#endregion
+export { Boot };

package/dist/config/config.default.d.ts

@@ -1,23 +1,2 @@
-//#region src/config/config.default.d.ts
-interface WatcherConfig {
-  /**
-   * event source type, default is `default`
-   * can be `default` or `development`
-   */
-  type: string;
-  /**
-   * event sources
-   * key is event source type, value is event source module path
-   */
-  eventSources: Record<string, string>;
-}
-declare const _default: {
-  /**
-   * watcher options
-   * @member Config#watcher
-   * @property {string} type - event source type
-   */
-  watcher: WatcherConfig;
-};
-//#endregion
+import { WatcherConfig, _default } from "../config.default-Chl85mlX.js";
 export { WatcherConfig, _default as default };

package/dist/config.default-Chl85mlX.d.ts

@@ -0,0 +1,23 @@
+//#region src/config/config.default.d.ts
+interface WatcherConfig {
+  /**
+   * event source type, default is `default`
+   * can be `default` or `development`
+   */
+  type: string;
+  /**
+   * event sources
+   * key is event source type, value is event source module path
+   */
+  eventSources: Record<string, string>;
+}
+declare const _default: {
+  /**
+   * watcher options
+   * @member Config#watcher
+   * @property {string} type - event source type
+   */
+  watcher: WatcherConfig;
+};
+//#endregion
+export { WatcherConfig, _default };

package/dist/default-GKOXgWps.js

@@ -0,0 +1,19 @@
+import { BaseEventSource } from "./base-C8f9YO9e.js";
+
+//#region src/lib/event-sources/default.ts
+var DefaultEventSource = class extends BaseEventSource {
+	constructor() {
+		super();
+		setImmediate(() => this.emit("info", "[@eggjs/watcher] defaultEventSource watcher will NOT take effect"));
+		this.ready(true);
+	}
+	watch() {
+		this.emit("info", "[@eggjs/watcher] using defaultEventSource watcher.watch() does NOTHING");
+	}
+	unwatch() {
+		this.emit("info", "[@eggjs/watcher] using defaultEventSource watcher.unwatch() does NOTHING");
+	}
+};
+
+//#endregion
+export { DefaultEventSource };

package/dist/default-HrAUw2OK.d.ts

@@ -0,0 +1,10 @@
+import { BaseEventSource } from "./base-DJbFfMBT.js";
+
+//#region src/lib/event-sources/default.d.ts
+declare class DefaultEventSource extends BaseEventSource {
+  constructor();
+  watch(): void;
+  unwatch(): void;
+}
+//#endregion
+export { DefaultEventSource };

package/dist/development-Dxou8BHR.js

@@ -0,0 +1,66 @@
+import { BaseEventSource } from "./base-C8f9YO9e.js";
+import { debuglog } from "node:util";
+import path from "node:path";
+import fs from "node:fs";
+
+//#region src/lib/event-sources/development.ts
+const debug = debuglog("egg-watcher/lib/event-sources/development");
+var DevelopmentEventSource = class extends BaseEventSource {
+	#fileWatching = /* @__PURE__ */ new Map();
+	constructor() {
+		super();
+		this.ready(true);
+	}
+	watch(file) {
+		try {
+			const stat = fs.statSync(file, { throwIfNoEntry: false });
+			if (!stat) {
+				debug("watch %o ignore, file not exists", file);
+				return;
+			}
+			debug("watch %o, isFile: %o", file, stat.isFile());
+			let recursive = true;
+			if (process.platform === "linux" && process.version.startsWith("v18.")) recursive = false;
+			const handler = fs.watch(file, {
+				persistent: true,
+				recursive
+			}, (event, filename) => {
+				debug("watch %o => event: %o, filename: %o", file, event, filename);
+				let changePath = file;
+				if (stat.isFile()) this.#onFsWatchChange(event, changePath);
+				else {
+					if (filename) changePath = path.join(file, filename);
+					this.#onFsWatchChange(event, changePath);
+				}
+			});
+			this.#fileWatching.set(file, handler);
+		} catch (e) {
+			this.emit("warn", "[@eggjs/watcher:DevelopmentEventSource] watch %o error: %s", file, e);
+		}
+	}
+	unwatch(file) {
+		if (!file) return;
+		const h = this.#fileWatching.get(file);
+		if (!h) return;
+		h.removeAllListeners();
+		h.close();
+		this.#fileWatching.delete(file);
+	}
+	#onFsWatchChange(event, file) {
+		if (!file) {
+			this.emit("warn", "[@eggjs/watcher:DevelopmentEventSource] event: %o", event);
+			return;
+		}
+		const stat = fs.statSync(file, { throwIfNoEntry: false });
+		const info = {
+			path: file,
+			event,
+			stat,
+			isDirectory: stat?.isDirectory()
+		};
+		this.emit("change", info);
+	}
+};
+
+//#endregion
+export { DevelopmentEventSource };

package/dist/development-x407-Xwn.d.ts

@@ -0,0 +1,11 @@
+import { BaseEventSource } from "./base-DJbFfMBT.js";
+
+//#region src/lib/event-sources/development.d.ts
+declare class DevelopmentEventSource extends BaseEventSource {
+  #private;
+  constructor();
+  watch(file: string): void;
+  unwatch(file: string): void;
+}
+//#endregion
+export { DevelopmentEventSource };

package/dist/event-sources-BjXjuNzX.js

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

package/dist/index-C9nY9t1j.d.ts

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

package/dist/index.d.ts

@@ -1,5 +1,8 @@
-import { ChangeInfo, WatchListener, Watcher } from "./lib/watcher.js";
-import { BaseEventSource } from "./lib/event-sources/base.js";
-import DefaultEventSource from "./lib/event-sources/default.js";
-import DevelopmentEventSource from "./lib/event-sources/development.js";
+import "./config.default-Chl85mlX.js";
+import { ChangeInfo, WatchListener, Watcher } from "./watcher-J8AUQIOb.js";
+import "./types-DWelR7br.js";
+import { BaseEventSource } from "./base-DJbFfMBT.js";
+import { DefaultEventSource } from "./default-HrAUw2OK.js";
+import { DevelopmentEventSource } from "./development-x407-Xwn.js";
+import "./index-C9nY9t1j.js";
 export { BaseEventSource, ChangeInfo, DefaultEventSource, DevelopmentEventSource, WatchListener, Watcher };

package/dist/index.js

@@ -1,7 +1,9 @@
-import { BaseEventSource } from "./lib/event-sources/base.js";
-import { Watcher } from "./lib/watcher.js";
-import DefaultEventSource from "./lib/event-sources/default.js";
-import DevelopmentEventSource from "./lib/event-sources/development.js";
-import "./lib/event-sources/index.js";
+import { BaseEventSource } from "./base-C8f9YO9e.js";
+import "./utils-BSqdCAAj.js";
+import { Watcher } from "./watcher-BGaGRNx5.js";
+import "./types-CQtQr8gw.js";
+import { DefaultEventSource } from "./default-GKOXgWps.js";
+import { DevelopmentEventSource } from "./development-Dxou8BHR.js";
+import "./event-sources-BjXjuNzX.js";
 
 export { BaseEventSource, DefaultEventSource, DevelopmentEventSource, Watcher };

package/dist/lib/boot.d.ts

@@ -1,10 +1,2 @@
-import { EggApplicationCore, ILifecycleBoot } from "egg";
-
-//#region src/lib/boot.d.ts
-declare class Boot implements ILifecycleBoot {
-  #private;
-  constructor(appOrAgent: EggApplicationCore);
-  didLoad(): Promise<void>;
-}
-//#endregion
+import { Boot } from "../boot-DG5R1PH_.js";
 export { Boot };

package/dist/lib/boot.js

@@ -1,26 +1,6 @@
-import { Watcher } from "./watcher.js";
-import { debuglog } from "node:util";
+import "../base-C8f9YO9e.js";
+import "../utils-BSqdCAAj.js";
+import "../watcher-BGaGRNx5.js";
+import { Boot } from "../boot-0zKWMxhf.js";
 
-//#region src/lib/boot.ts
-const debug = debuglog("egg/watcher/lib/boot");
-var Boot = class {
-	#app;
-	constructor(appOrAgent) {
-		this.#app = appOrAgent;
-		if (this.#app.options.mode === "all-in-one-process") {
-			debug("init watcher in all-in-one-process mode");
-			this.#app.watcher = new Watcher(appOrAgent.config);
-		} else {
-			debug("init watcher in cluster mode");
-			this.#app.watcher = this.#app.clusterWrapper(Watcher, {}).delegate("watch", "subscribe").create(appOrAgent.config);
-		}
-		this.#app.watcher.on("info", (msg, ...args) => this.#app.coreLogger.info(msg, ...args)).on("warn", (msg, ...args) => this.#app.coreLogger.warn(msg, ...args)).on("error", (msg, ...args) => this.#app.coreLogger.error(msg, ...args));
-	}
-	async didLoad() {
-		await this.#app.watcher.ready();
-		this.#app.coreLogger.info("[@eggjs/watcher:%s] watcher start success", this.#app.type);
-	}
-};
-
-//#endregion
 export { Boot };

package/dist/lib/event-sources/base.d.ts

@@ -1,9 +1,2 @@
-import { Base } from "sdk-base";
-
-//#region src/lib/event-sources/base.d.ts
-declare abstract class BaseEventSource extends Base {
-  abstract watch(file: string): void;
-  abstract unwatch(file: string): void;
-}
-//#endregion
+import { BaseEventSource } from "../../base-DJbFfMBT.js";
 export { BaseEventSource };

package/dist/lib/event-sources/base.js

@@ -1,7 +1,3 @@
-import { Base } from "sdk-base";
+import { BaseEventSource } from "../../base-C8f9YO9e.js";
 
-//#region src/lib/event-sources/base.ts
-var BaseEventSource = class extends Base {};
-
-//#endregion
 export { BaseEventSource };

package/dist/lib/event-sources/default.d.ts

@@ -1,10 +1,3 @@
-import { BaseEventSource } from "./base.js";
-
-//#region src/lib/event-sources/default.d.ts
-declare class DefaultEventSource extends BaseEventSource {
-  constructor();
-  watch(): void;
-  unwatch(): void;
-}
-//#endregion
+import "../../base-DJbFfMBT.js";
+import { DefaultEventSource } from "../../default-HrAUw2OK.js";
 export { DefaultEventSource as default };

package/dist/lib/event-sources/default.js

@@ -1,19 +1,4 @@
-import { BaseEventSource } from "./base.js";
+import "../../base-C8f9YO9e.js";
+import { DefaultEventSource } from "../../default-GKOXgWps.js";
 
-//#region src/lib/event-sources/default.ts
-var DefaultEventSource = class extends BaseEventSource {
-	constructor() {
-		super();
-		setImmediate(() => this.emit("info", "[@eggjs/watcher] defaultEventSource watcher will NOT take effect"));
-		this.ready(true);
-	}
-	watch() {
-		this.emit("info", "[@eggjs/watcher] using defaultEventSource watcher.watch() does NOTHING");
-	}
-	unwatch() {
-		this.emit("info", "[@eggjs/watcher] using defaultEventSource watcher.unwatch() does NOTHING");
-	}
-};
-
-//#endregion
 export { DefaultEventSource as default };

package/dist/lib/event-sources/development.d.ts

@@ -1,11 +1,3 @@
-import { BaseEventSource } from "./base.js";
-
-//#region src/lib/event-sources/development.d.ts
-declare class DevelopmentEventSource extends BaseEventSource {
-  #private;
-  constructor();
-  watch(file: string): void;
-  unwatch(file: string): void;
-}
-//#endregion
+import "../../base-DJbFfMBT.js";
+import { DevelopmentEventSource } from "../../development-x407-Xwn.js";
 export { DevelopmentEventSource as default };

package/dist/lib/event-sources/development.js

@@ -1,66 +1,4 @@
-import { BaseEventSource } from "./base.js";
-import { debuglog } from "node:util";
-import path from "node:path";
-import fs from "node:fs";
+import "../../base-C8f9YO9e.js";
+import { DevelopmentEventSource } from "../../development-Dxou8BHR.js";
 
-//#region src/lib/event-sources/development.ts
-const debug = debuglog("egg-watcher/lib/event-sources/development");
-var DevelopmentEventSource = class extends BaseEventSource {
-	#fileWatching = /* @__PURE__ */ new Map();
-	constructor() {
-		super();
-		this.ready(true);
-	}
-	watch(file) {
-		try {
-			const stat = fs.statSync(file, { throwIfNoEntry: false });
-			if (!stat) {
-				debug("watch %o ignore, file not exists", file);
-				return;
-			}
-			debug("watch %o, isFile: %o", file, stat.isFile());
-			let recursive = true;
-			if (process.platform === "linux" && process.version.startsWith("v18.")) recursive = false;
-			const handler = fs.watch(file, {
-				persistent: true,
-				recursive
-			}, (event, filename) => {
-				debug("watch %o => event: %o, filename: %o", file, event, filename);
-				let changePath = file;
-				if (stat.isFile()) this.#onFsWatchChange(event, changePath);
-				else {
-					if (filename) changePath = path.join(file, filename);
-					this.#onFsWatchChange(event, changePath);
-				}
-			});
-			this.#fileWatching.set(file, handler);
-		} catch (e) {
-			this.emit("warn", "[@eggjs/watcher:DevelopmentEventSource] watch %o error: %s", file, e);
-		}
-	}
-	unwatch(file) {
-		if (!file) return;
-		const h = this.#fileWatching.get(file);
-		if (!h) return;
-		h.removeAllListeners();
-		h.close();
-		this.#fileWatching.delete(file);
-	}
-	#onFsWatchChange(event, file) {
-		if (!file) {
-			this.emit("warn", "[@eggjs/watcher:DevelopmentEventSource] event: %o", event);
-			return;
-		}
-		const stat = fs.statSync(file, { throwIfNoEntry: false });
-		const info = {
-			path: file,
-			event,
-			stat,
-			isDirectory: stat?.isDirectory()
-		};
-		this.emit("change", info);
-	}
-};
-
-//#endregion
 export { DevelopmentEventSource as default };

package/dist/lib/event-sources/index.d.ts

@@ -1,4 +1,5 @@
-import { BaseEventSource } from "./base.js";
-import DefaultEventSource from "./default.js";
-import DevelopmentEventSource from "./development.js";
+import { BaseEventSource } from "../../base-DJbFfMBT.js";
+import { DefaultEventSource } from "../../default-HrAUw2OK.js";
+import { DevelopmentEventSource } from "../../development-x407-Xwn.js";
+import "../../index-C9nY9t1j.js";
 export { BaseEventSource, DefaultEventSource, DevelopmentEventSource };

package/dist/lib/event-sources/index.js

@@ -1,5 +1,6 @@
-import { BaseEventSource } from "./base.js";
-import DefaultEventSource from "./default.js";
-import DevelopmentEventSource from "./development.js";
+import { BaseEventSource } from "../../base-C8f9YO9e.js";
+import { DefaultEventSource } from "../../default-GKOXgWps.js";
+import { DevelopmentEventSource } from "../../development-Dxou8BHR.js";
+import "../../event-sources-BjXjuNzX.js";
 
 export { BaseEventSource, DefaultEventSource, DevelopmentEventSource };

package/dist/lib/utils.js

@@ -1,9 +1,3 @@
-import path from "node:path";
+import { isEqualOrParentPath } from "../utils-BSqdCAAj.js";
 
-//#region src/lib/utils.ts
-function isEqualOrParentPath(parent, child) {
-	return !path.relative(parent, child).startsWith("..");
-}
-
-//#endregion
 export { isEqualOrParentPath };

package/dist/lib/watcher.d.ts

@@ -1,23 +1,2 @@
-import { Base } from "sdk-base";
-import { Stats, WatchEventType } from "node:fs";
-import { EggAppConfig } from "egg";
-
-//#region src/lib/watcher.d.ts
-interface ChangeInfo extends Record<string, any> {
-  event: WatchEventType;
-  /**
-   * file stat if path exists
-   */
-  stat?: Stats;
-  path: string;
-  isDirectory?: boolean;
-}
-type WatchListener = (info: ChangeInfo) => void;
-declare class Watcher extends Base {
-  #private;
-  constructor(config: EggAppConfig);
-  protected _init(): Promise<void>;
-  watch(path: string | string[], listener: WatchListener): void;
-}
-//#endregion
+import { ChangeInfo, WatchListener, Watcher } from "../watcher-J8AUQIOb.js";
 export { ChangeInfo, WatchListener, Watcher };

package/dist/lib/watcher.js

@@ -1,64 +1,5 @@
-import "./event-sources/base.js";
-import { isEqualOrParentPath } from "./utils.js";
-import { debuglog } from "node:util";
-import { Base } from "sdk-base";
-import camelcase from "camelcase";
-import { importModule } from "@eggjs/utils";
+import "../base-C8f9YO9e.js";
+import "../utils-BSqdCAAj.js";
+import { Watcher } from "../watcher-BGaGRNx5.js";
 
-//#region src/lib/watcher.ts
-const debug = debuglog("egg/watcher/lib/watcher");
-var Watcher = class extends Base {
-	#config;
-	#eventSource;
-	constructor(config) {
-		super({ initMethod: "_init" });
-		this.#config = config;
-	}
-	async _init() {
-		const watcherType = this.#config.watcher?.type;
-		debug("init with watcherType %o", watcherType);
-		if (!watcherType) {
-			debug("watcherType is not defined, skip initialization");
-			return;
-		}
-		let EventSource = this.#config.watcher?.eventSources[watcherType];
-		if (typeof EventSource === "string") EventSource = await importModule(EventSource, { importDefaultOnly: true });
-		const key = camelcase(["watcher", watcherType]);
-		const eventSourceOptions = this.#config[key] ?? {};
-		this.#eventSource = Reflect.construct(EventSource, [eventSourceOptions]);
-		this.#eventSource.on("change", this.#onChange.bind(this)).on("fuzzy-change", this.#onFuzzyChange.bind(this)).on("info", (...args) => this.emit("info", ...args)).on("warn", (...args) => this.emit("warn", ...args)).on("error", (...args) => this.emit("error", ...args));
-		await this.#eventSource.ready();
-	}
-	watch(path, listener) {
-		debug("watch %o", path);
-		this.emit("info", "[@eggjs/watcher] Start watching: %j", path);
-		if (!path) return;
-		if (Array.isArray(path)) {
-			path.forEach((p) => this.watch(p, listener));
-			return;
-		}
-		if (!this.listenerCount(path)) this.#eventSource.watch(path);
-		this.on(path, listener);
-	}
-	#onChange(info) {
-		debug("onChange %o", info);
-		this.emit("info", "[@eggjs/watcher] Received a change event from eventSource: %j", info);
-		const path = info.path;
-		for (const p of this.eventNames()) {
-			if (typeof p !== "string") continue;
-			if (isEqualOrParentPath(p, path)) this.emit(p, info);
-		}
-	}
-	#onFuzzyChange(info) {
-		debug("onFuzzyChange %o", info);
-		this.emit("info", "[@eggjs/watcher] Received a fuzzy-change event from eventSource: %j", info);
-		const path = info.path;
-		for (const p of this.eventNames()) {
-			if (typeof p !== "string") continue;
-			if (isEqualOrParentPath(path, p)) this.emit(p, info);
-		}
-	}
-};
-
-//#endregion
 export { Watcher };

package/dist/types-CQtQr8gw.js

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

package/dist/types-DWelR7br.d.ts

@@ -0,0 +1,12 @@
+import { WatcherConfig } from "./config.default-Chl85mlX.js";
+import { Watcher } from "./watcher-J8AUQIOb.js";
+
+//#region src/types.d.ts
+declare module 'egg' {
+  interface EggApplicationCore {
+    watcher: Watcher;
+  }
+  interface EggAppConfig {
+    watcher?: WatcherConfig;
+  }
+}

package/dist/types.d.ts

@@ -1,12 +1,3 @@
-import { WatcherConfig } from "./config/config.default.js";
-import { Watcher } from "./lib/watcher.js";
-
-//#region src/types.d.ts
-declare module 'egg' {
-  interface EggApplicationCore {
-    watcher: Watcher;
-  }
-  interface EggAppConfig {
-    watcher?: WatcherConfig;
-  }
-}
+import "./config.default-Chl85mlX.js";
+import "./watcher-J8AUQIOb.js";
+import "./types-DWelR7br.js";

package/dist/types.js

@@ -1 +1,3 @@
+import "./types-CQtQr8gw.js";
+
 export {  };

package/dist/utils-BSqdCAAj.js

@@ -0,0 +1,9 @@
+import path from "node:path";
+
+//#region src/lib/utils.ts
+function isEqualOrParentPath(parent, child) {
+	return !path.relative(parent, child).startsWith("..");
+}
+
+//#endregion
+export { isEqualOrParentPath };

package/dist/watcher-BGaGRNx5.js

@@ -0,0 +1,63 @@
+import { isEqualOrParentPath } from "./utils-BSqdCAAj.js";
+import { debuglog } from "node:util";
+import { Base } from "sdk-base";
+import camelcase from "camelcase";
+import { importModule } from "@eggjs/utils";
+
+//#region src/lib/watcher.ts
+const debug = debuglog("egg/watcher/lib/watcher");
+var Watcher = class extends Base {
+	#config;
+	#eventSource;
+	constructor(config) {
+		super({ initMethod: "_init" });
+		this.#config = config;
+	}
+	async _init() {
+		const watcherType = this.#config.watcher?.type;
+		debug("init with watcherType %o", watcherType);
+		if (!watcherType) {
+			debug("watcherType is not defined, skip initialization");
+			return;
+		}
+		let EventSource = this.#config.watcher?.eventSources[watcherType];
+		if (typeof EventSource === "string") EventSource = await importModule(EventSource, { importDefaultOnly: true });
+		const key = camelcase(["watcher", watcherType]);
+		const eventSourceOptions = this.#config[key] ?? {};
+		this.#eventSource = Reflect.construct(EventSource, [eventSourceOptions]);
+		this.#eventSource.on("change", this.#onChange.bind(this)).on("fuzzy-change", this.#onFuzzyChange.bind(this)).on("info", (...args) => this.emit("info", ...args)).on("warn", (...args) => this.emit("warn", ...args)).on("error", (...args) => this.emit("error", ...args));
+		await this.#eventSource.ready();
+	}
+	watch(path, listener) {
+		debug("watch %o", path);
+		this.emit("info", "[@eggjs/watcher] Start watching: %j", path);
+		if (!path) return;
+		if (Array.isArray(path)) {
+			path.forEach((p) => this.watch(p, listener));
+			return;
+		}
+		if (!this.listenerCount(path)) this.#eventSource.watch(path);
+		this.on(path, listener);
+	}
+	#onChange(info) {
+		debug("onChange %o", info);
+		this.emit("info", "[@eggjs/watcher] Received a change event from eventSource: %j", info);
+		const path = info.path;
+		for (const p of this.eventNames()) {
+			if (typeof p !== "string") continue;
+			if (isEqualOrParentPath(p, path)) this.emit(p, info);
+		}
+	}
+	#onFuzzyChange(info) {
+		debug("onFuzzyChange %o", info);
+		this.emit("info", "[@eggjs/watcher] Received a fuzzy-change event from eventSource: %j", info);
+		const path = info.path;
+		for (const p of this.eventNames()) {
+			if (typeof p !== "string") continue;
+			if (isEqualOrParentPath(path, p)) this.emit(p, info);
+		}
+	}
+};
+
+//#endregion
+export { Watcher };

package/dist/watcher-J8AUQIOb.d.ts

@@ -0,0 +1,23 @@
+import { Base } from "sdk-base";
+import { Stats, WatchEventType } from "node:fs";
+import { EggAppConfig } from "egg";
+
+//#region src/lib/watcher.d.ts
+interface ChangeInfo extends Record<string, any> {
+  event: WatchEventType;
+  /**
+   * file stat if path exists
+   */
+  stat?: Stats;
+  path: string;
+  isDirectory?: boolean;
+}
+type WatchListener = (info: ChangeInfo) => void;
+declare class Watcher extends Base {
+  #private;
+  constructor(config: EggAppConfig);
+  protected _init(): Promise<void>;
+  watch(path: string | string[], listener: WatchListener): void;
+}
+//#endregion
+export { ChangeInfo, WatchListener, Watcher };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/watcher",
-  "version": "5.0.0-beta.18",
+  "version": "5.0.0-beta.20",
   "publishConfig": {
     "access": "public"
   },
@@ -26,18 +26,18 @@
   "dependencies": {
     "camelcase": "^8.0.0",
     "sdk-base": "^5.0.1",
-    "@eggjs/utils": "5.0.0-beta.18"
+    "@eggjs/utils": "5.0.0-beta.20"
   },
   "peerDependencies": {
-    "egg": "4.1.0-beta.18"
+    "egg": "4.1.0-beta.20"
   },
   "devDependencies": {
     "tsdown": "^0.15.4",
-    "typescript": "5.9.2",
-    "vitest": "4.0.0-beta.13",
-    "@eggjs/mock": "7.0.0-beta.18",
-    "@eggjs/tsconfig": "3.1.0-beta.18",
-    "@eggjs/utils": "5.0.0-beta.18"
+    "typescript": "^5.9.3",
+    "vitest": "4.0.0-beta.16",
+    "@eggjs/mock": "7.0.0-beta.20",
+    "@eggjs/tsconfig": "3.1.0-beta.20",
+    "@eggjs/utils": "5.0.0-beta.20"
   },
   "type": "module",
   "exports": {