@theia/filesystem 1.77.0-next.6 → 1.77.0-next.63

package/lib/node/filesystem-backend-module.js.map

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

package/lib/node/filesystem-watcher-service-impl.d.ts

@@ -0,0 +1,30 @@
+import { FileSystemWatcherService, FileSystemWatcherServiceClient, WatchOptions } from '../common/filesystem-watcher-protocol';
+import { ResolvedWatchOptions, WatcherLogger, WatcherProvider } from './filesystem-watcher';
+import { ParcelFileSystemWatcherServerOptions } from './parcel-watcher/parcel-watcher';
+/** Routes each request to the first provider that can handle it. The provider picks the watcher that serves it. */
+export declare class FileSystemWatcherServiceImpl implements FileSystemWatcherService {
+    protected client: FileSystemWatcherServiceClient | undefined;
+    protected watcherId: number;
+    protected readonly logger: WatcherLogger;
+    /** Checked in order. The first one whose `canHandle` returns `true` serves the request. */
+    protected readonly providers: readonly WatcherProvider[];
+    /**
+     * `this.client` is undefined until someone sets it.
+     */
+    protected readonly maybeClient: FileSystemWatcherServiceClient;
+    constructor(options?: Partial<ParcelFileSystemWatcherServerOptions>);
+    setClient(client: FileSystemWatcherServiceClient | undefined): void;
+    /** Requests resolving to the same target share a watcher. */
+    watchFileChanges(clientId: number, uri: string, options?: WatchOptions): Promise<number>;
+    unwatchFileChanges(watcherId: number): Promise<void>;
+    /** `options` keeps the parcel shape that adopters already bind. Only the recursive provider reads `parcelOptions`. */
+    protected createProviders(options: ParcelFileSystemWatcherServerOptions): WatcherProvider[];
+    protected providerFor(options: ResolvedWatchOptions): WatcherProvider;
+    /**
+     * Return fully qualified options. Watchers created before `recursive` existed were always recursive.
+     */
+    protected resolveWatchOptions(options?: WatchOptions): ResolvedWatchOptions;
+    protected debug(message: string, ...params: unknown[]): void;
+    dispose(): void;
+}
+//# sourceMappingURL=filesystem-watcher-service-impl.d.ts.map

package/lib/node/filesystem-watcher-service-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-watcher-service-impl.d.ts","sourceRoot":"","sources":["../../src/node/filesystem-watcher-service-impl.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC/H,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5F,OAAO,EAAE,oCAAoC,EAA4B,MAAM,iCAAiC,CAAC;AAEjH,mHAAmH;AACnH,qBAAa,4BAA6B,YAAW,wBAAwB;IAEzE,SAAS,CAAC,MAAM,EAAE,8BAA8B,GAAG,SAAS,CAAC;IAE7D,SAAS,CAAC,SAAS,SAAK;IAExB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAEzC,2FAA2F;IAC3F,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAEzD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAG5D;gBAEU,OAAO,CAAC,EAAE,OAAO,CAAC,oCAAoC,CAAC;IAYnE,SAAS,CAAC,MAAM,EAAE,8BAA8B,GAAG,SAAS,GAAG,IAAI;IAInE,6DAA6D;IACvD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxF,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,sHAAsH;IACtH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,oCAAoC,GAAG,eAAe,EAAE;IAO3F,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe;IAQrE;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,oBAAoB;IAO3E,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAM5D,OAAO,IAAI,IAAI;CAGlB"}

package/lib/node/filesystem-watcher-service-impl.js

@@ -0,0 +1,92 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017-2018 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemWatcherServiceImpl = void 0;
+const file_uri_1 = require("@theia/core/lib/common/file-uri");
+const node_directory_watcher_1 = require("./nodejs-watcher/node-directory-watcher");
+const parcel_watcher_1 = require("./parcel-watcher/parcel-watcher");
+/** Routes each request to the first provider that can handle it. The provider picks the watcher that serves it. */
+class FileSystemWatcherServiceImpl {
+    constructor(options) {
+        this.watcherId = 0;
+        /**
+         * `this.client` is undefined until someone sets it.
+         */
+        this.maybeClient = {
+            onDidFilesChanged: event => this.client?.onDidFilesChanged(event),
+            onError: event => this.client?.onError(event),
+        };
+        const resolved = {
+            parcelOptions: {},
+            verbose: false,
+            info: (message, ...args) => console.info(message, ...args),
+            error: (message, ...args) => console.error(message, ...args),
+            ...options
+        };
+        this.logger = resolved;
+        this.providers = this.createProviders(resolved);
+    }
+    setClient(client) {
+        this.client = client;
+    }
+    /** Requests resolving to the same target share a watcher. */
+    async watchFileChanges(clientId, uri, options) {
+        const resolvedOptions = this.resolveWatchOptions(options);
+        const provider = this.providerFor(resolvedOptions);
+        const watcherId = this.watcherId++;
+        await provider.watch(watcherId, { clientId, path: file_uri_1.FileUri.fsPath(uri), ignored: resolvedOptions.ignored });
+        return watcherId;
+    }
+    async unwatchFileChanges(watcherId) {
+        if (!this.providers.some(provider => provider.unwatch(watcherId))) {
+            console.warn(`tried to de-allocate a disposed watcher: watcherId=${watcherId}`);
+        }
+    }
+    /** `options` keeps the parcel shape that adopters already bind. Only the recursive provider reads `parcelOptions`. */
+    createProviders(options) {
+        return [
+            new parcel_watcher_1.RecursiveWatcherProvider(options, this.maybeClient),
+            new node_directory_watcher_1.DirectoryWatcherProvider(options, this.maybeClient)
+        ];
+    }
+    providerFor(options) {
+        const provider = this.providers.find(candidate => candidate.canHandle(options));
+        if (!provider) {
+            throw new Error(`No watcher provider takes options: ${JSON.stringify(options)}`);
+        }
+        return provider;
+    }
+    /**
+     * Return fully qualified options. Watchers created before `recursive` existed were always recursive.
+     */
+    resolveWatchOptions(options) {
+        return {
+            ignored: options?.ignored ?? [],
+            recursive: options?.recursive ?? true
+        };
+    }
+    debug(message, ...params) {
+        if (this.logger.verbose) {
+            this.logger.info(message, ...params);
+        }
+    }
+    dispose() {
+        // Singletons shouldn't be disposed...
+    }
+}
+exports.FileSystemWatcherServiceImpl = FileSystemWatcherServiceImpl;
+//# sourceMappingURL=filesystem-watcher-service-impl.js.map

package/lib/node/filesystem-watcher-service-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-watcher-service-impl.js","sourceRoot":"","sources":["../../src/node/filesystem-watcher-service-impl.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8CAA8C;AAC9C,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,8DAA0D;AAG1D,oFAAmF;AACnF,oEAAiH;AAEjH,mHAAmH;AACnH,MAAa,4BAA4B;IAmBrC,YAAY,OAAuD;QAfzD,cAAS,GAAG,CAAC,CAAC;QAOxB;;WAEG;QACgB,gBAAW,GAAmC;YAC7D,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC;YACjE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;SAChD,CAAC;QAGE,MAAM,QAAQ,GAAyC;YACnD,aAAa,EAAE,EAAE;YACjB,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;YAC1D,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;YAC5D,GAAG,OAAO;SACb,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,SAAS,CAAC,MAAkD;QACxD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,GAAW,EAAE,OAAsB;QACxE,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,kBAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3G,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,SAAiB;QACtC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,sDAAsD,SAAS,EAAE,CAAC,CAAC;QACpF,CAAC;IACL,CAAC;IAED,sHAAsH;IAC5G,eAAe,CAAC,OAA6C;QACnE,OAAO;YACH,IAAI,yCAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC;YACvD,IAAI,iDAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC;SAC1D,CAAC;IACN,CAAC;IAES,WAAW,CAAC,OAA6B;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;OAEG;IACO,mBAAmB,CAAC,OAAsB;QAChD,OAAO;YACH,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;YAC/B,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;SACxC,CAAC;IACN,CAAC;IAES,KAAK,CAAC,OAAe,EAAE,GAAG,MAAiB;QACjD,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;QACzC,CAAC;IACL,CAAC;IAED,OAAO;QACH,sCAAsC;IAC1C,CAAC;CACJ;AArFD,oEAqFC"}

package/lib/node/filesystem-watcher-service-impl.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filesystem-watcher-service-impl.spec.d.ts.map

package/lib/node/filesystem-watcher-service-impl.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-watcher-service-impl.spec.d.ts","sourceRoot":"","sources":["../../src/node/filesystem-watcher-service-impl.spec.ts"],"names":[],"mappings":""}

package/lib/node/filesystem-watcher-service-impl.spec.js

@@ -0,0 +1,202 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Ehab Younes and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const assert = tslib_1.__importStar(require("assert"));
+const promise_util_1 = require("@theia/core/lib/common/promise-util");
+const temp = tslib_1.__importStar(require("temp"));
+const fs = tslib_1.__importStar(require("@theia/core/shared/fs-extra"));
+const core_1 = require("@theia/core");
+const node_1 = require("@theia/core/lib/node");
+const node_directory_watcher_1 = require("./nodejs-watcher/node-directory-watcher");
+const watcher_test_helper_1 = require("./test/watcher-test-helper");
+const parcel_filesystem_service_1 = require("./parcel-watcher/parcel-filesystem-service");
+const track = temp.track();
+const RECURSIVE = { ignored: [], recursive: true };
+const NON_RECURSIVE = { ignored: [], recursive: false };
+class TestDirectoryProvider extends node_directory_watcher_1.DirectoryWatcherProvider {
+    get allocated() {
+        return this.activeWatchers;
+    }
+    watcherOf(watcherId) {
+        return this.watcherFor(watcherId);
+    }
+}
+class TestRecursiveProvider extends parcel_filesystem_service_1.RecursiveWatcherProvider {
+    get allocated() {
+        return this.activeWatchers;
+    }
+    watcherOf(watcherId) {
+        return this.watcherFor(watcherId);
+    }
+}
+function isTestProvider(provider) {
+    return provider instanceof TestDirectoryProvider || provider instanceof TestRecursiveProvider;
+}
+/** A temporary directory and a watcher service on it, one per test. */
+class Sandbox extends parcel_filesystem_service_1.FileSystemWatcherServiceImpl {
+    constructor() {
+        super(watcher_test_helper_1.NO_LOGGING);
+        /** The directory the requests of this test point into. */
+        this.files = new watcher_test_helper_1.TempDir(fs.realpathSync.native(temp.mkdirSync('filesystem-watcher-service')));
+        this.requested = [];
+    }
+    get root() {
+        return this.files.root;
+    }
+    watch(fsPath, options) {
+        return this.watchFileChanges(1, node_1.FileUri.create(fsPath).toString(), options)
+            .then(watcherId => (this.requested.push(watcherId), watcherId));
+    }
+    /** The watchers currently allocated, one per distinct key, across both providers. */
+    get allocated() {
+        return this.testProviders.flatMap(provider => provider.allocated);
+    }
+    get testProviders() {
+        return this.providers.filter(isTestProvider);
+    }
+    /** The watcher serving a request, asked of whichever provider holds it. */
+    watcherOf(watcherId) {
+        return this.testProviders.map(provider => provider.watcherOf(watcherId)).find(Boolean);
+    }
+    async release() {
+        const outstanding = this.requested.splice(0).filter(watcherId => this.watcherOf(watcherId));
+        const allocated = this.allocated;
+        await Promise.all(outstanding.map(watcherId => this.unwatchFileChanges(watcherId)));
+        await Promise.all(allocated.map(watcher => watcher.whenDisposed));
+    }
+    createProviders(options) {
+        return [
+            new TestRecursiveProvider(options, this.maybeClient, watcher_test_helper_1.WATCHER_TIMINGS.deferredDisposalTimeout),
+            new TestDirectoryProvider(options, this.maybeClient, watcher_test_helper_1.WATCHER_TIMINGS)
+        ];
+    }
+}
+describe('filesystem-watcher-service', function () {
+    this.timeout(20000);
+    let box;
+    beforeEach(() => {
+        box = new Sandbox();
+    });
+    afterEach(async () => {
+        await box.release();
+        track.cleanupSync();
+    });
+    describe('routing', () => {
+        it('keeps the deprecated service name usable by adopters', () => {
+            assert.strictEqual(parcel_filesystem_service_1.ParcelFileSystemWatcherService, parcel_filesystem_service_1.FileSystemWatcherServiceImpl);
+        });
+        it('serves a recursive request, and one that does not say, with the parcel watcher', async () => {
+            const recursive = await box.watch(box.root, RECURSIVE);
+            const unspecified = await box.watch(box.files.mkdir('other'), { ignored: [] });
+            assert.ok(box.watcherOf(recursive) instanceof parcel_filesystem_service_1.ParcelWatcher);
+            assert.ok(box.watcherOf(unspecified) instanceof parcel_filesystem_service_1.ParcelWatcher);
+        });
+        it('serves a non-recursive request with a directory watcher', async () => {
+            const watcherId = await box.watch(box.root, NON_RECURSIVE);
+            assert.ok(box.watcherOf(watcherId) instanceof node_directory_watcher_1.NodeDirectoryWatcher);
+        });
+        it('keeps a recursive and a non-recursive request on the same path apart', async () => {
+            const recursive = await box.watch(box.root, RECURSIVE);
+            const nonRecursive = await box.watch(box.root, NON_RECURSIVE);
+            assert.notStrictEqual(box.watcherOf(recursive), box.watcherOf(nonRecursive));
+            assert.strictEqual(box.allocated.length, 2);
+        });
+    });
+    describe('sharing', () => {
+        it('shares one watcher between a directory and the files inside it', async () => {
+            const directory = await box.watch(box.root, NON_RECURSIVE);
+            const first = await box.watch(box.files.write('a.txt'), NON_RECURSIVE);
+            const second = await box.watch(box.files.write('b.txt'), NON_RECURSIVE);
+            assert.strictEqual(box.allocated.length, 1);
+            assert.strictEqual(box.watcherOf(directory), box.watcherOf(first));
+            assert.strictEqual(box.watcherOf(first), box.watcherOf(second));
+        });
+        it('shares one watcher between requests with different excludes', async () => {
+            await box.watch(box.root, { ignored: ['**/node_modules'], recursive: false });
+            await box.watch(box.root, NON_RECURSIVE);
+            assert.strictEqual(box.allocated.length, 1);
+        });
+        it('shares one watcher between a directory and a symbolic link to it', async () => {
+            const real = box.files.mkdir('real');
+            fs.symlinkSync(real, box.files.path('link'), core_1.isWindows ? 'junction' : 'dir');
+            const direct = await box.watch(real, NON_RECURSIVE);
+            const linked = await box.watch(box.files.path('link'), NON_RECURSIVE);
+            assert.strictEqual(box.allocated.length, 1);
+            assert.strictEqual(box.watcherOf(direct), box.watcherOf(linked));
+        });
+        it('shares one watcher between concurrent requests for the same directory', async () => {
+            const [first, second] = [box.files.write('a.txt'), box.files.write('b.txt')];
+            const [one, two] = await Promise.all([box.watch(first, NON_RECURSIVE), box.watch(second, NON_RECURSIVE)]);
+            assert.strictEqual(box.allocated.length, 1);
+            assert.strictEqual(box.watcherOf(one), box.watcherOf(two));
+        });
+        it('moves a watcher to the parent once its path turns out to be a file', async () => {
+            const pending = await box.watch(box.files.path('later.txt'), NON_RECURSIVE);
+            box.files.write('later.txt');
+            await box.watcherOf(pending).whenStarted;
+            const directory = await box.watch(box.root, NON_RECURSIVE);
+            assert.strictEqual(box.allocated.length, 1);
+            assert.strictEqual(box.watcherOf(pending), box.watcherOf(directory));
+        });
+        it('merges two watchers whose paths turn out to be files in one directory', async () => {
+            const [one, two] = await Promise.all([
+                box.watch(box.files.path('a.txt'), NON_RECURSIVE),
+                box.watch(box.files.path('b.txt'), NON_RECURSIVE)
+            ]);
+            box.files.write('a.txt');
+            box.files.write('b.txt');
+            await Promise.all([one, two].map(watcherId => box.watcherOf(watcherId).whenStarted));
+            assert.strictEqual(box.allocated.length, 1);
+            assert.strictEqual(box.watcherOf(one), box.watcherOf(two));
+            // The handles have to follow the merge, or the moved request would never be released.
+            const survivor = box.watcherOf(one);
+            await Promise.all([one, two].map(watcherId => box.unwatchFileChanges(watcherId)));
+            await survivor.whenDisposed;
+            assert.strictEqual(box.allocated.length, 0);
+        });
+        it('does not attach a request to a watcher that is already disposed', async () => {
+            const first = await box.watch(box.root, NON_RECURSIVE);
+            const disposed = box.watcherOf(first);
+            disposed.dispose();
+            const second = await box.watch(box.root, NON_RECURSIVE);
+            assert.notStrictEqual(box.watcherOf(second), disposed);
+            assert.strictEqual(box.allocated.length, 1);
+        });
+    });
+    describe('releasing', () => {
+        it('disposes a directory watcher once its last request is unwatched', async () => {
+            const first = await box.watch(box.root, NON_RECURSIVE);
+            const second = await box.watch(box.root, NON_RECURSIVE);
+            const watcher = box.watcherOf(first);
+            await box.unwatchFileChanges(first);
+            await (0, promise_util_1.wait)(watcher_test_helper_1.WATCHER_TIMINGS.deferredDisposalTimeout * 2);
+            assert.strictEqual(watcher.isDisposed, false, 'the remaining request must keep the watcher alive');
+            await box.unwatchFileChanges(second);
+            await watcher.whenDisposed;
+            assert.strictEqual(box.allocated.length, 0);
+        });
+        it('releases the client reference of a recursive watcher', async () => {
+            const watcherId = await box.watch(box.root, RECURSIVE);
+            const watcher = box.watcherOf(watcherId);
+            await box.unwatchFileChanges(watcherId);
+            await watcher.whenDisposed;
+            assert.strictEqual(box.allocated.length, 0);
+        });
+    });
+});
+//# sourceMappingURL=filesystem-watcher-service-impl.spec.js.map

package/lib/node/filesystem-watcher-service-impl.spec.js.map

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

package/lib/node/filesystem-watcher.d.ts

@@ -0,0 +1,93 @@
+import { WatchOptions } from '../common/filesystem-watcher-protocol';
+/** How a watcher reports what it is doing. */
+export interface WatcherLogger {
+    verbose: boolean;
+    info: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+}
+/** A single client request served by a {@link FileSystemWatcher}. */
+export interface WatchRequest {
+    /** Client to route the changes of this request to. */
+    readonly clientId: number;
+    /** Path as requested by the client. Change URIs are built from it, never from the real path. */
+    readonly path: string;
+    /** Exclude patterns of this request alone. */
+    readonly ignored: readonly string[];
+}
+/** A watch shared by every request that resolves to the same target. Implementations decide whether it recurses. */
+export interface FileSystemWatcher {
+    /** A disposed watcher released its resources and must not be given further requests. */
+    readonly isDisposed: boolean;
+    /** Resolves once this watcher disposed itself. Never rejects. */
+    readonly whenDisposed: Promise<void>;
+    /** Serves `request` until {@link removeRequest} is called with the same `watcherId`. */
+    addRequest(watcherId: number, request: WatchRequest): void;
+    /** Releases a request. The watcher disposes itself once it has none left. */
+    removeRequest(watcherId: number): void;
+}
+/** Handles disposal and logging for a watcher. Subclasses decide how to observe the file system. */
+export declare abstract class AbstractFileSystemWatcher implements FileSystemWatcher {
+    /** Path this watcher was asked about; the subclass decides what it resolves to. */
+    protected readonly target: string;
+    private readonly logger;
+    private static debugIdSequence;
+    private readonly debugId;
+    private readonly disposalDeferred;
+    private readonly disposal;
+    readonly whenDisposed: Promise<void>;
+    constructor(
+    /** Path this watcher was asked about; the subclass decides what it resolves to. */
+    target: string, logger: WatcherLogger);
+    get isDisposed(): boolean;
+    abstract addRequest(watcherId: number, request: WatchRequest): void;
+    abstract removeRequest(watcherId: number): void;
+    /**
+     * Marks this watcher disposed.
+     * @returns `false` if it already was, in which case the caller must not clean up again.
+     */
+    protected markDisposed(): boolean;
+    /** Logs as-is. Unlike {@link info} it is not prefixed, since these messages name their own path. */
+    protected error(message: string, ...params: unknown[]): void;
+    protected info(prefix: string, ...params: unknown[]): void;
+    protected debug(prefix: string, ...params: unknown[]): void;
+}
+export type ResolvedWatchOptions = Required<WatchOptions>;
+/** Serves either recursive or non-recursive requests, and decides which watcher serves each one. */
+export interface WatcherProvider {
+    /** @returns `true` if this provider serves requests made with these options. */
+    canHandle(options: ResolvedWatchOptions): boolean;
+    /** Serves `request` under `watcherId`, on a watcher shared with requests resolving to the same target. */
+    watch(watcherId: number, request: WatchRequest): Promise<void>;
+    /**
+     * Releases the request registered under `watcherId`.
+     * @returns `true` if this provider served the request.
+     */
+    unwatch(watcherId: number): boolean;
+}
+/** A {@link WatcherProvider} that keeps one watcher per target. Subclasses decide which key a target maps to. */
+export declare abstract class AbstractWatcherProvider implements WatcherProvider {
+    private readonly watchersByTarget;
+    /** The watcher that serves each request, by `watcherId`. */
+    private readonly watchersByRequest;
+    /** Every watcher this provider currently has open. */
+    protected get activeWatchers(): readonly FileSystemWatcher[];
+    abstract canHandle(options: ResolvedWatchOptions): boolean;
+    abstract watch(watcherId: number, request: WatchRequest): Promise<void>;
+    unwatch(watcherId: number): boolean;
+    /** The watcher serving a request, if this provider has one. */
+    protected watcherFor(watcherId: number): FileSystemWatcher | undefined;
+    /** Puts a request on a watcher and records which one, so {@link unwatch} finds it again. */
+    protected serve(watcherId: number, watcher: FileSystemWatcher, request: WatchRequest): void;
+    /** Records the watcher of a request that reached it without {@link serve}, such as through a re-key. */
+    protected assign(watcherId: number, watcher: FileSystemWatcher): void;
+    /**
+     * Returns the watcher under `watcherKey`, or creates one. A disposed watcher stays in the map until a later
+     * promise callback removes it, so it is replaced here rather than handed a new request.
+     */
+    protected getOrCreateWatcher<T extends FileSystemWatcher>(watcherKey: string, create: () => T): T;
+    /** @returns `true` if `watcher` is the one registered under `watcherKey`. */
+    protected isRegisteredAs(watcher: FileSystemWatcher, watcherKey: string): boolean;
+    /** Forgets every key a watcher is registered under, so that it can be registered under another. */
+    protected unregisterWatcher(watcher: FileSystemWatcher): void;
+}
+//# sourceMappingURL=filesystem-watcher.d.ts.map

package/lib/node/filesystem-watcher.d.ts.map

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

package/lib/node/filesystem-watcher.js

@@ -0,0 +1,134 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Ehab Younes and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractWatcherProvider = exports.AbstractFileSystemWatcher = void 0;
+const promise_util_1 = require("@theia/core/lib/common/promise-util");
+const cancellation_1 = require("@theia/core/lib/common/cancellation");
+/** Handles disposal and logging for a watcher. Subclasses decide how to observe the file system. */
+class AbstractFileSystemWatcher {
+    static { this.debugIdSequence = 0; }
+    constructor(
+    /** Path this watcher was asked about; the subclass decides what it resolves to. */
+    target, logger) {
+        this.target = target;
+        this.logger = logger;
+        this.debugId = AbstractFileSystemWatcher.debugIdSequence++;
+        this.disposalDeferred = new promise_util_1.Deferred();
+        this.disposal = new cancellation_1.CancellationTokenSource();
+        this.whenDisposed = this.disposalDeferred.promise;
+    }
+    get isDisposed() {
+        return this.disposal.token.isCancellationRequested;
+    }
+    /**
+     * Marks this watcher disposed.
+     * @returns `false` if it already was, in which case the caller must not clean up again.
+     */
+    markDisposed() {
+        if (this.isDisposed) {
+            return false;
+        }
+        this.disposal.cancel();
+        this.disposalDeferred.resolve();
+        return true;
+    }
+    /** Logs as-is. Unlike {@link info} it is not prefixed, since these messages name their own path. */
+    error(message, ...params) {
+        this.logger.error(message, ...params);
+    }
+    info(prefix, ...params) {
+        this.logger.info(`${prefix} ${this.constructor.name}(${this.debugId} at "${this.target}"):`, ...params);
+    }
+    debug(prefix, ...params) {
+        if (this.logger.verbose) {
+            this.info(prefix, ...params);
+        }
+    }
+}
+exports.AbstractFileSystemWatcher = AbstractFileSystemWatcher;
+/** A {@link WatcherProvider} that keeps one watcher per target. Subclasses decide which key a target maps to. */
+class AbstractWatcherProvider {
+    constructor() {
+        this.watchersByTarget = new Map();
+        /** The watcher that serves each request, by `watcherId`. */
+        this.watchersByRequest = new Map();
+    }
+    /** Every watcher this provider currently has open. */
+    get activeWatchers() {
+        return Array.from(this.watchersByTarget.values());
+    }
+    unwatch(watcherId) {
+        const watcher = this.watchersByRequest.get(watcherId);
+        if (!watcher) {
+            return false;
+        }
+        this.watchersByRequest.delete(watcherId);
+        watcher.removeRequest(watcherId);
+        return true;
+    }
+    /** The watcher serving a request, if this provider has one. */
+    watcherFor(watcherId) {
+        return this.watchersByRequest.get(watcherId);
+    }
+    /** Puts a request on a watcher and records which one, so {@link unwatch} finds it again. */
+    serve(watcherId, watcher, request) {
+        watcher.addRequest(watcherId, request);
+        this.assign(watcherId, watcher);
+    }
+    /** Records the watcher of a request that reached it without {@link serve}, such as through a re-key. */
+    assign(watcherId, watcher) {
+        this.watchersByRequest.set(watcherId, watcher);
+    }
+    /**
+     * Returns the watcher under `watcherKey`, or creates one. A disposed watcher stays in the map until a later
+     * promise callback removes it, so it is replaced here rather than handed a new request.
+     */
+    getOrCreateWatcher(watcherKey, create) {
+        const existing = this.watchersByTarget.get(watcherKey);
+        if (existing && !existing.isDisposed) {
+            return existing;
+        }
+        const watcher = create();
+        this.watchersByTarget.set(watcherKey, watcher);
+        watcher.whenDisposed.then(() => {
+            if (this.watchersByTarget.get(watcherKey) === watcher) {
+                this.watchersByTarget.delete(watcherKey);
+            }
+            // Requests it handed to another watcher already point there, so drop only the ones still on it.
+            for (const [watcherId, serving] of this.watchersByRequest) {
+                if (serving === watcher) {
+                    this.watchersByRequest.delete(watcherId);
+                }
+            }
+        });
+        return watcher;
+    }
+    /** @returns `true` if `watcher` is the one registered under `watcherKey`. */
+    isRegisteredAs(watcher, watcherKey) {
+        return this.watchersByTarget.get(watcherKey) === watcher;
+    }
+    /** Forgets every key a watcher is registered under, so that it can be registered under another. */
+    unregisterWatcher(watcher) {
+        for (const [watcherKey, registered] of this.watchersByTarget) {
+            if (registered === watcher) {
+                this.watchersByTarget.delete(watcherKey);
+            }
+        }
+    }
+}
+exports.AbstractWatcherProvider = AbstractWatcherProvider;
+//# sourceMappingURL=filesystem-watcher.js.map

package/lib/node/filesystem-watcher.js.map

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