@lova/mem-vfs 0.1.0

package/dist/watcher/watcher.js

@@ -0,0 +1,194 @@
+/**
+ * VFSWatcher
+ * 虛擬檔案系統監聽器
+ */
+import { FileChangeType } from '../types/index.js';
+import { SimpleEventEmitter } from './watcher-events.js';
+import { Debouncer } from './debouncer.js';
+import { normalizePath, isSubPath } from '../path/path-resolver.js';
+/** VFS Watcher 類別 */
+export class VFSWatcher extends SimpleEventEmitter {
+    /** 監聽路徑 */
+    watchPath;
+    /** 選項 */
+    options;
+    /** 是否已關閉 */
+    closed = false;
+    /** 事件防抖器 */
+    debouncer;
+    /** 已知路徑快取（用於判斷新增或修改） */
+    knownPaths = new Set();
+    /** 預設選項 */
+    static DEFAULT_OPTIONS = {
+        persistent: true,
+        recursive: true,
+        ignoreInitial: false,
+        followSymlinks: true,
+        ignored: [],
+        debounce: 100,
+        depth: Infinity,
+    };
+    constructor(watchPath, options) {
+        super();
+        this.watchPath = normalizePath(watchPath);
+        this.options = { ...VFSWatcher.DEFAULT_OPTIONS, ...options };
+        this.debouncer = new Debouncer((events) => this.flushEvents(events), this.options.debounce);
+    }
+    /** 通知檔案變更 */
+    notifyChange(path, stats) {
+        if (this.closed) {
+            return;
+        }
+        const normalizedPath = normalizePath(path);
+        if (!this.shouldWatch(normalizedPath)) {
+            return;
+        }
+        const isNew = !this.knownPaths.has(normalizedPath);
+        this.knownPaths.add(normalizedPath);
+        const event = {
+            type: isNew ? FileChangeType.Add : FileChangeType.Change,
+            path: normalizedPath,
+            stats,
+        };
+        this.debouncer.add(normalizedPath, event);
+    }
+    /** 通知檔案刪除 */
+    notifyUnlink(path, isDirectory = false) {
+        if (this.closed) {
+            return;
+        }
+        const normalizedPath = normalizePath(path);
+        if (!this.shouldWatch(normalizedPath)) {
+            return;
+        }
+        this.knownPaths.delete(normalizedPath);
+        const event = {
+            type: isDirectory ? FileChangeType.UnlinkDir : FileChangeType.Unlink,
+            path: normalizedPath,
+        };
+        this.debouncer.add(normalizedPath, event);
+    }
+    /** 通知目錄新增 */
+    notifyAddDir(path, stats) {
+        if (this.closed) {
+            return;
+        }
+        const normalizedPath = normalizePath(path);
+        if (!this.shouldWatch(normalizedPath)) {
+            return;
+        }
+        this.knownPaths.add(normalizedPath);
+        const event = {
+            type: FileChangeType.AddDir,
+            path: normalizedPath,
+            stats,
+        };
+        this.debouncer.add(normalizedPath, event);
+    }
+    /** 發送 ready 事件 */
+    emitReady() {
+        if (this.closed) {
+            return;
+        }
+        this.emit('ready');
+    }
+    /** 發送錯誤事件 */
+    emitError(error) {
+        if (this.closed) {
+            return;
+        }
+        this.emit('error', error);
+    }
+    /** 註冊已知路徑 */
+    registerPath(path) {
+        this.knownPaths.add(normalizePath(path));
+    }
+    /** 取消註冊路徑 */
+    unregisterPath(path) {
+        this.knownPaths.delete(normalizePath(path));
+    }
+    /** 關閉監聽器 */
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.debouncer.cancel();
+        this.removeAllListeners();
+        this.knownPaths.clear();
+    }
+    /** 是否已關閉 */
+    get isClosed() {
+        return this.closed;
+    }
+    /** 監聽的路徑 */
+    get path() {
+        return this.watchPath;
+    }
+    /** 覆寫 on 方法 */
+    on(event, handler) {
+        return super.on(event, handler);
+    }
+    /** 檢查路徑是否應該被監聽 */
+    shouldWatch(path) {
+        // 檢查路徑是否在監聽範圍內
+        if (path !== this.watchPath && !isSubPath(path, this.watchPath)) {
+            return false;
+        }
+        // 檢查深度
+        const depth = this.getPathDepth(path);
+        if (depth > this.options.depth) {
+            return false;
+        }
+        // 檢查忽略規則
+        if (this.isIgnored(path)) {
+            return false;
+        }
+        return true;
+    }
+    /** 計算相對於監聽路徑的深度 */
+    getPathDepth(path) {
+        if (path === this.watchPath) {
+            return 0;
+        }
+        const relativePath = path.slice(this.watchPath.length);
+        return relativePath.split('/').filter(Boolean).length;
+    }
+    /** 檢查是否被忽略 */
+    isIgnored(path) {
+        const { ignored } = this.options;
+        if (!ignored) {
+            return false;
+        }
+        if (typeof ignored === 'function') {
+            return ignored(path);
+        }
+        const patterns = Array.isArray(ignored) ? ignored : [ignored];
+        for (const pattern of patterns) {
+            if (this.matchPattern(path, pattern)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /** 簡單的 pattern 匹配 */
+    matchPattern(path, pattern) {
+        // 簡單實作：支援 * 萬用字元
+        const regex = new RegExp('^' + pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*') + '$');
+        return regex.test(path) || regex.test(path.split('/').pop() ?? '');
+    }
+    /** 批量發送事件 */
+    flushEvents(events) {
+        for (const event of events.values()) {
+            // 發送特定類型事件
+            this.emit(event.type, event);
+            // 發送 'all' 事件
+            this.emit('all', event);
+        }
+    }
+}
+/** 建立 VFSWatcher 實例 */
+export function createWatcher(path, options) {
+    return new VFSWatcher(path, options);
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/watcher/watcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@lova/mem-vfs",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "High-performance in-memory virtual file system with symlink support, file watching, and snapshot/rollback capabilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src tests --ext .ts",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "virtual-file-system",
+    "vfs",
+    "memfs",
+    "in-memory",
+    "file-system",
+    "symlink",
+    "snapshot",
+    "watch"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "@vitest/coverage-v8": "1.6.0",
+    "eslint": "^8.54.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}