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

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

@@ -1,200 +1,20 @@
-import { Minimatch } from 'minimatch';
-import { FileChangeType, FileSystemWatcherService, FileSystemWatcherServiceClient, WatchOptions } from '../../common/filesystem-watcher-protocol';
-import { FileChangeCollection } from '../file-change-collection';
-import { Deferred } from '@theia/core/lib/common/promise-util';
-import { Options, AsyncSubscription, Event } from '@theia/core/shared/@parcel/watcher';
-export interface ParcelWatcherOptions {
-    /** Compiled exclude patterns, used to filter events after they arrive. */
-    ignored: Minimatch[];
-    /**
-     * Raw exclude patterns, passed to the native parcel `ignore` option so that excluded
-     * directories are never crawled or watched in the first place (rather than only having
-     * their events filtered out afterwards). This is what actually keeps the number of OS
-     * file watches (e.g. inotify watches on Linux) bounded on large workspaces.
-     */
-    ignorePatterns: string[];
-}
-export declare const ParcelFileSystemWatcherServerOptions: unique symbol;
-export interface ParcelFileSystemWatcherServerOptions {
-    verbose: boolean;
-    info: (message: string, ...args: any[]) => void;
-    error: (message: string, ...args: any[]) => void;
-    parcelOptions: Options;
-}
-/**
- * This is a flag value passed around upon disposal.
- */
-export declare const WatcherDisposal: unique symbol;
 /**
- * Because URIs can be watched by different clients, we'll track
- * how many are listening for a given URI.
- *
- * This component wraps the whole start/stop process given some
- * reference count.
- *
- * Once there are no more references the handle
- * will wait for some time before destroying its resources.
- */
-export declare class ParcelWatcher {
-    /** Filesystem path to be watched. */
-    readonly fsPath: string;
-    /** Watcher-specific options */
-    readonly watcherOptions: ParcelWatcherOptions;
-    /** Logging and parcel watcher options */
-    protected readonly parcelFileSystemWatchServerOptions: ParcelFileSystemWatcherServerOptions;
-    /** The client to forward events to. */
-    protected readonly fileSystemWatcherClient: FileSystemWatcherServiceClient;
-    /** Amount of time in ms to wait once this handle is not referenced anymore. */
-    protected readonly deferredDisposalTimeout: number;
-    protected static debugIdSequence: number;
-    protected disposed: boolean;
-    /**
-     * Used for debugging to keep track of the watchers.
-     */
-    protected debugId: number;
-    /**
-     * When this field is set, it means the watcher instance was successfully started.
-     */
-    protected watcher: AsyncSubscription | undefined;
-    /**
-     * When the ref count hits zero, we schedule this watch handle to be disposed.
-     */
-    protected deferredDisposalTimer: NodeJS.Timeout | undefined;
-    /**
-     * This deferred only rejects with `WatcherDisposal` and never resolves.
-     */
-    protected readonly deferredDisposalDeferred: Deferred<never>;
-    /**
-     * We count each reference made to this watcher, per client.
-     *
-     * We do this to know where to send events via the network.
-     *
-     * An entry should be removed when its value hits zero.
-     */
-    protected readonly refsPerClient: Map<number, {
-        value: number;
-    }>;
-    /**
-     * Ensures that events are processed in the order they are emitted,
-     * despite being processed async.
-     */
-    protected parcelEventProcessingQueue: Promise<void>;
-    /**
-     * Resolves once this handle disposed itself and its resources. Never throws.
-     */
-    readonly whenDisposed: Promise<void>;
-    /**
-     * Promise that resolves when the watcher is fully started, or got disposed.
-     *
-     * Will reject if an error occurred while starting.
-     *
-     * @returns `true` if successfully started, `false` if disposed early.
-     */
-    readonly whenStarted: Promise<boolean>;
-    private static readonly PARCEL_WATCHER_BACKEND;
-    constructor(
-    /** Initial reference to this handle. */
-    initialClientId: number, 
-    /** Filesystem path to be watched. */
-    fsPath: string, 
-    /** Watcher-specific options */
-    watcherOptions: ParcelWatcherOptions, 
-    /** Logging and parcel watcher options */
-    parcelFileSystemWatchServerOptions: ParcelFileSystemWatcherServerOptions, 
-    /** The client to forward events to. */
-    fileSystemWatcherClient: FileSystemWatcherServiceClient, 
-    /** Amount of time in ms to wait once this handle is not referenced anymore. */
-    deferredDisposalTimeout?: number);
-    addRef(clientId: number): void;
-    removeRef(clientId: number): void;
-    /**
-     * All clients with at least one active reference.
-     */
-    getClientIds(): number[];
-    /**
-     * Add the references for each client together.
-     */
-    getTotalReferences(): number;
-    /**
-     * Returns true if at least one client listens to this handle.
-     */
-    isInUse(): boolean;
-    /**
-     * @throws with {@link WatcherDisposal} if this instance is disposed.
-     */
-    protected assertNotDisposed(): void;
-    /**
-     * When starting a watcher, we'll first check and wait for the path to exists
-     * before running a parcel watcher.
-     */
-    protected start(): Promise<void>;
-    /**
-     * Given a started parcel watcher instance, gracefully shut it down.
-     */
-    protected stopWatcher(watcher: AsyncSubscription): Promise<void>;
-    protected createWatcher(): Promise<AsyncSubscription>;
-    protected handleWatcherEvents(events: Event[]): void;
-    protected resolveEventPath(directory: string, file: string): Promise<string>;
-    protected pushFileChange(changes: FileChangeCollection, type: FileChangeType, filePath: string): void;
-    protected fireError(): void;
-    /**
-     * When references hit zero, we'll schedule disposal for a bit later.
-     *
-     * This allows new references to reuse this watcher instead of creating a new one.
-     *
-     * e.g. A frontend disconnects for a few milliseconds before reconnecting again.
-     */
-    protected onRefsReachZero(): void;
-    /**
-     * If we get new references after hitting zero, let's unschedule our disposal and keep watching.
-     */
-    protected onRefsRevive(): void;
-    protected isIgnored(filePath: string): boolean;
-    /**
-     * Internal disposal mechanism.
-     */
-    protected _dispose(): Promise<void>;
-    protected info(prefix: string, ...params: any[]): void;
-    protected debug(prefix: string, ...params: any[]): void;
-}
-/**
- * Each time a client makes a watchRequest, we generate a unique watcherId for it.
- *
- * This watcherId will map to this handle type which keeps track of the clientId that made the request.
+ * Kept so that the names this module published keep resolving. The service moved to
+ * `filesystem-watcher-service-impl`, next to both watchers it routes to rather than only the parcel one, and
+ * `ParcelWatcher` moved to `parcel-watcher`. Delete this file once the deprecated names below can go, which
+ * per `doc/api-management.md` is a major release.
  */
+import { FileSystemWatcher } from '../filesystem-watcher';
+import { FileSystemWatcherServiceImpl } from '../filesystem-watcher-service-impl';
+export * from './parcel-watcher';
+export * from '../filesystem-watcher-service-impl';
+/** @deprecated since 1.77.0 - use `FileSystemWatcherServiceImpl`, which also serves non-recursive requests. */
+export declare const ParcelFileSystemWatcherService: typeof FileSystemWatcherServiceImpl;
+/** @deprecated since 1.77.0 - use `FileSystemWatcherServiceImpl`, which also serves non-recursive requests. */
+export type ParcelFileSystemWatcherService = FileSystemWatcherServiceImpl;
+/** @deprecated since 1.77.0 - a watcher id now maps straight to the {@link FileSystemWatcher} serving it. */
 export interface PacelWatcherHandle {
     clientId: number;
-    watcher: ParcelWatcher;
-}
-export declare class ParcelFileSystemWatcherService implements FileSystemWatcherService {
-    protected client: FileSystemWatcherServiceClient | undefined;
-    protected watcherId: number;
-    protected readonly watchers: Map<string, ParcelWatcher>;
-    protected readonly watcherHandles: Map<number, PacelWatcherHandle>;
-    protected readonly options: ParcelFileSystemWatcherServerOptions;
-    /**
-     * `this.client` is undefined until someone sets it.
-     */
-    protected readonly maybeClient: FileSystemWatcherServiceClient;
-    constructor(options?: Partial<ParcelFileSystemWatcherServerOptions>);
-    setClient(client: FileSystemWatcherServiceClient | undefined): void;
-    /**
-     * A specific client requests us to watch a given `uri` according to some `options`.
-     *
-     * We internally re-use all the same `(uri, options)` pairs.
-     */
-    watchFileChanges(clientId: number, uri: string, options?: WatchOptions): Promise<number>;
-    protected createWatcher(clientId: number, fsPath: string, options: WatchOptions): ParcelWatcher;
-    unwatchFileChanges(watcherId: number): Promise<void>;
-    /**
-     * Given some `URI` and some `WatchOptions`, generate a unique key.
-     */
-    protected getWatcherKey(uri: string, options: WatchOptions): string;
-    /**
-     * Return fully qualified options.
-     */
-    protected resolveWatchOptions(options?: WatchOptions): WatchOptions;
-    protected debug(message: string, ...params: any[]): void;
-    dispose(): void;
+    watcher: FileSystemWatcher;
 }
 //# sourceMappingURL=parcel-filesystem-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parcel-filesystem-service.d.ts","sourceRoot":"","sources":["../../../src/node/parcel-watcher/parcel-filesystem-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parcel-filesystem-service.d.ts","sourceRoot":"","sources":["../../../src/node/parcel-watcher/parcel-filesystem-service.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AAEnD,+GAA+G;AAC/G,eAAO,MAAM,8BAA8B,qCAA+B,CAAC;AAC3E,+GAA+G;AAC/G,MAAM,MAAM,8BAA8B,GAAG,4BAA4B,CAAC;AAE1E,6GAA6G;AAC7G,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,CAAC;CAC9B"}

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

@@ -15,428 +15,11 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ParcelFileSystemWatcherService = exports.ParcelWatcher = exports.WatcherDisposal = exports.ParcelFileSystemWatcherServerOptions = void 0;
-const path = require("path");
-const fs_1 = require("fs");
-const minimatch_1 = require("minimatch");
-const file_uri_1 = require("@theia/core/lib/common/file-uri");
-const file_change_collection_1 = require("../file-change-collection");
-const promise_util_1 = require("@theia/core/lib/common/promise-util");
-const watcher_1 = require("@theia/core/shared/@parcel/watcher");
-const core_1 = require("@theia/core");
-exports.ParcelFileSystemWatcherServerOptions = Symbol('ParcelFileSystemWatcherServerOptions');
-/**
- * This is a flag value passed around upon disposal.
- */
-exports.WatcherDisposal = Symbol('WatcherDisposal');
-/**
- * Because URIs can be watched by different clients, we'll track
- * how many are listening for a given URI.
- *
- * This component wraps the whole start/stop process given some
- * reference count.
- *
- * Once there are no more references the handle
- * will wait for some time before destroying its resources.
- */
-class ParcelWatcher {
-    static { this.debugIdSequence = 0; }
-    // copied from https://github.com/microsoft/vscode/blob/e3a5acfb517a443235981655413d566533107e92/src/vs/platform/files/node/watcher/parcel/parcelWatcher.ts#L158
-    static { this.PARCEL_WATCHER_BACKEND = core_1.isWindows ? 'windows' : core_1.isOSX ? 'fs-events' : 'inotify'; }
-    constructor(
-    /** Initial reference to this handle. */
-    initialClientId, 
-    /** Filesystem path to be watched. */
-    fsPath, 
-    /** Watcher-specific options */
-    watcherOptions, 
-    /** Logging and parcel watcher options */
-    parcelFileSystemWatchServerOptions, 
-    /** The client to forward events to. */
-    fileSystemWatcherClient, 
-    /** Amount of time in ms to wait once this handle is not referenced anymore. */
-    deferredDisposalTimeout = 10_000) {
-        this.fsPath = fsPath;
-        this.watcherOptions = watcherOptions;
-        this.parcelFileSystemWatchServerOptions = parcelFileSystemWatchServerOptions;
-        this.fileSystemWatcherClient = fileSystemWatcherClient;
-        this.deferredDisposalTimeout = deferredDisposalTimeout;
-        this.disposed = false;
-        /**
-         * Used for debugging to keep track of the watchers.
-         */
-        this.debugId = ParcelWatcher.debugIdSequence++;
-        /**
-         * This deferred only rejects with `WatcherDisposal` and never resolves.
-         */
-        this.deferredDisposalDeferred = new promise_util_1.Deferred();
-        /**
-         * We count each reference made to this watcher, per client.
-         *
-         * We do this to know where to send events via the network.
-         *
-         * An entry should be removed when its value hits zero.
-         */
-        this.refsPerClient = new Map();
-        /**
-         * Ensures that events are processed in the order they are emitted,
-         * despite being processed async.
-         */
-        this.parcelEventProcessingQueue = Promise.resolve();
-        /**
-         * Resolves once this handle disposed itself and its resources. Never throws.
-         */
-        this.whenDisposed = this.deferredDisposalDeferred.promise.catch(() => undefined);
-        this.refsPerClient.set(initialClientId, { value: 1 });
-        this.whenStarted = this.start().then(() => true, error => {
-            if (error === exports.WatcherDisposal) {
-                return false;
-            }
-            console.error(`Watcher failed to start at "${this.fsPath}":`, error);
-            this._dispose();
-            this.fireError();
-            throw error;
-        });
-        this.debug('NEW', `initialClientId=${initialClientId}`);
-    }
-    addRef(clientId) {
-        let refs = this.refsPerClient.get(clientId);
-        if (typeof refs === 'undefined') {
-            this.refsPerClient.set(clientId, refs = { value: 1 });
-        }
-        else {
-            refs.value += 1;
-        }
-        const totalRefs = this.getTotalReferences();
-        // If it was zero before, 1 means we were revived:
-        const revived = totalRefs === 1;
-        if (revived) {
-            this.onRefsRevive();
-        }
-        this.debug('REF++', `clientId=${clientId}, clientRefs=${refs.value}, totalRefs=${totalRefs}. revived=${revived}`);
-    }
-    removeRef(clientId) {
-        const refs = this.refsPerClient.get(clientId);
-        if (typeof refs === 'undefined') {
-            this.info('WARN REF--', `removed one too many reference: clientId=${clientId}`);
-            return;
-        }
-        refs.value -= 1;
-        // We must remove the key from `this.clientReferences` because
-        // we list active clients by reading the keys of this map.
-        if (refs.value === 0) {
-            this.refsPerClient.delete(clientId);
-        }
-        const totalRefs = this.getTotalReferences();
-        const dead = totalRefs === 0;
-        if (dead) {
-            this.onRefsReachZero();
-        }
-        this.debug('REF--', `clientId=${clientId}, clientRefs=${refs.value}, totalRefs=${totalRefs}, dead=${dead}`);
-    }
-    /**
-     * All clients with at least one active reference.
-     */
-    getClientIds() {
-        return Array.from(this.refsPerClient.keys());
-    }
-    /**
-     * Add the references for each client together.
-     */
-    getTotalReferences() {
-        let total = 0;
-        for (const refs of this.refsPerClient.values()) {
-            total += refs.value;
-        }
-        return total;
-    }
-    /**
-     * Returns true if at least one client listens to this handle.
-     */
-    isInUse() {
-        return this.refsPerClient.size > 0;
-    }
-    /**
-     * @throws with {@link WatcherDisposal} if this instance is disposed.
-     */
-    assertNotDisposed() {
-        if (this.disposed) {
-            throw exports.WatcherDisposal;
-        }
-    }
-    /**
-     * When starting a watcher, we'll first check and wait for the path to exists
-     * before running a parcel watcher.
-     */
-    async start() {
-        while (await fs_1.promises.stat(this.fsPath).then(() => false, () => true)) {
-            await (0, promise_util_1.timeout)(500);
-            this.assertNotDisposed();
-        }
-        this.assertNotDisposed();
-        // This race is specific to Linux/inotify: parcel-watcher's inotify backend walks
-        // the tree and then calls inotify_add_watch on every subdirectory. If a subdirectory
-        // disappears between the walk and the add (common when watching dirs that contain
-        // auto-rotated log/temp folders), the syscall returns ENOENT and parcel-watcher fails
-        // the entire subscribe. Retry a few times: by the next walk the gone-but-not-forgotten
-        // dir is no longer present. Windows (ReadDirectoryChangesW) and macOS (FSEvents) watch
-        // the whole subtree from a single handle on the root and never register per-subdirectory
-        // watches, so they cannot hit this race; the retry is simply a no-op there.
-        let watcher;
-        let attempt = 0;
-        while (true) {
-            try {
-                watcher = await this.createWatcher();
-                break;
-            }
-            catch (error) {
-                const message = (error && error.message) || '';
-                const isTransientEnoent = message.includes('No such file or directory')
-                    && await fs_1.promises.stat(this.fsPath).then(() => true, () => false);
-                if (!isTransientEnoent || attempt >= 4) {
-                    throw error;
-                }
-                attempt++;
-                this.assertNotDisposed();
-                await (0, promise_util_1.timeout)(100 * attempt);
-                this.assertNotDisposed();
-            }
-        }
-        this.assertNotDisposed();
-        this.debug('STARTED', `disposed=${this.disposed}`);
-        // The watcher could be disposed while it was starting, make sure to check for this:
-        if (this.disposed) {
-            await this.stopWatcher(watcher);
-            throw exports.WatcherDisposal;
-        }
-        this.watcher = watcher;
-    }
-    /**
-     * Given a started parcel watcher instance, gracefully shut it down.
-     */
-    async stopWatcher(watcher) {
-        await watcher.unsubscribe()
-            .then(() => 'success=true', error => error)
-            .then(status => this.debug('STOPPED', status));
-    }
-    async createWatcher() {
-        let fsPath = await fs_1.promises.realpath(this.fsPath);
-        if ((await fs_1.promises.stat(fsPath)).isFile()) {
-            fsPath = path.dirname(fsPath);
-        }
-        return (0, watcher_1.subscribe)(fsPath, (err, events) => {
-            if (err) {
-                if (err.message && err.message.includes('File system must be re-scanned')) {
-                    console.log(`FS Events were dropped on watcher ${fs_1.promises}`);
-                }
-                else {
-                    console.error(`Watcher service error on "${fsPath}":`, err);
-                    this._dispose();
-                    this.fireError();
-                    return;
-                }
-            }
-            if (events) {
-                this.handleWatcherEvents(events);
-            }
-        }, {
-            backend: ParcelWatcher.PARCEL_WATCHER_BACKEND,
-            ...this.parcelFileSystemWatchServerOptions.parcelOptions,
-            // Pass the excludes to parcel's native `ignore` so excluded directories are pruned
-            // from the watch tree (no OS watch is placed), not merely filtered out of the event
-            // stream. Mirrors VS Code's parcel watcher (`ignore: <request excludes>`).
-            ignore: [
-                ...(this.parcelFileSystemWatchServerOptions.parcelOptions.ignore ?? []),
-                ...this.watcherOptions.ignorePatterns
-            ]
-        });
-    }
-    handleWatcherEvents(events) {
-        // Only process events if someone is listening.
-        if (this.isInUse()) {
-            // This callback is async, but parcel won't wait for it to finish before firing the next one.
-            // We will use a lock/queue to make sure everything is processed in the order it arrives.
-            this.parcelEventProcessingQueue = this.parcelEventProcessingQueue.then(async () => {
-                const fileChangeCollection = new file_change_collection_1.FileChangeCollection();
-                for (const event of events) {
-                    const filePath = event.path;
-                    if (event.type === 'create') {
-                        this.pushFileChange(fileChangeCollection, 1 /* FileChangeType.ADDED */, filePath);
-                    }
-                    else if (event.type === 'delete') {
-                        this.pushFileChange(fileChangeCollection, 2 /* FileChangeType.DELETED */, filePath);
-                    }
-                    else if (event.type === 'update') {
-                        this.pushFileChange(fileChangeCollection, 0 /* FileChangeType.UPDATED */, filePath);
-                    }
-                }
-                const changes = fileChangeCollection.values();
-                // If all changes are part of the ignored files, the collection will be empty.
-                if (changes.length > 0) {
-                    this.fileSystemWatcherClient.onDidFilesChanged({
-                        clients: this.getClientIds(),
-                        changes,
-                    });
-                }
-            }, console.error);
-        }
-    }
-    async resolveEventPath(directory, file) {
-        // parcel already resolves symlinks, the paths should be clean already:
-        return path.resolve(directory, file);
-    }
-    pushFileChange(changes, type, filePath) {
-        if (!this.isIgnored(filePath)) {
-            const uri = file_uri_1.FileUri.create(filePath).toString();
-            changes.push({ type, uri });
-        }
-    }
-    fireError() {
-        this.fileSystemWatcherClient.onError({
-            clients: this.getClientIds(),
-            uri: this.fsPath,
-        });
-    }
-    /**
-     * When references hit zero, we'll schedule disposal for a bit later.
-     *
-     * This allows new references to reuse this watcher instead of creating a new one.
-     *
-     * e.g. A frontend disconnects for a few milliseconds before reconnecting again.
-     */
-    onRefsReachZero() {
-        this.deferredDisposalTimer = setTimeout(() => this._dispose(), this.deferredDisposalTimeout);
-    }
-    /**
-     * If we get new references after hitting zero, let's unschedule our disposal and keep watching.
-     */
-    onRefsRevive() {
-        if (this.deferredDisposalTimer) {
-            clearTimeout(this.deferredDisposalTimer);
-            this.deferredDisposalTimer = undefined;
-        }
-    }
-    isIgnored(filePath) {
-        return this.watcherOptions.ignored.length > 0
-            && this.watcherOptions.ignored.some(m => m.match(filePath));
-    }
-    /**
-     * Internal disposal mechanism.
-     */
-    async _dispose() {
-        if (!this.disposed) {
-            this.disposed = true;
-            this.deferredDisposalDeferred.reject(exports.WatcherDisposal);
-            if (this.watcher) {
-                this.stopWatcher(this.watcher);
-                this.watcher = undefined;
-            }
-            this.debug('DISPOSED');
-        }
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    info(prefix, ...params) {
-        this.parcelFileSystemWatchServerOptions.info(`${prefix} ParcelWatcher(${this.debugId} at "${this.fsPath}"):`, ...params);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    debug(prefix, ...params) {
-        if (this.parcelFileSystemWatchServerOptions.verbose) {
-            this.info(prefix, ...params);
-        }
-    }
-}
-exports.ParcelWatcher = ParcelWatcher;
-class ParcelFileSystemWatcherService {
-    constructor(options) {
-        this.watcherId = 0;
-        this.watchers = new Map();
-        this.watcherHandles = new Map();
-        /**
-         * `this.client` is undefined until someone sets it.
-         */
-        this.maybeClient = {
-            onDidFilesChanged: event => this.client?.onDidFilesChanged(event),
-            onError: event => this.client?.onError(event),
-        };
-        this.options = {
-            parcelOptions: {},
-            verbose: false,
-            info: (message, ...args) => console.info(message, ...args),
-            error: (message, ...args) => console.error(message, ...args),
-            ...options
-        };
-    }
-    setClient(client) {
-        this.client = client;
-    }
-    /**
-     * A specific client requests us to watch a given `uri` according to some `options`.
-     *
-     * We internally re-use all the same `(uri, options)` pairs.
-     */
-    async watchFileChanges(clientId, uri, options) {
-        const resolvedOptions = this.resolveWatchOptions(options);
-        const watcherKey = this.getWatcherKey(uri, resolvedOptions);
-        let watcher = this.watchers.get(watcherKey);
-        if (watcher === undefined) {
-            const fsPath = file_uri_1.FileUri.fsPath(uri);
-            watcher = this.createWatcher(clientId, fsPath, resolvedOptions);
-            watcher.whenDisposed.then(() => this.watchers.delete(watcherKey));
-            this.watchers.set(watcherKey, watcher);
-        }
-        else {
-            watcher.addRef(clientId);
-        }
-        const watcherId = this.watcherId++;
-        this.watcherHandles.set(watcherId, { clientId, watcher });
-        watcher.whenDisposed.then(() => this.watcherHandles.delete(watcherId));
-        return watcherId;
-    }
-    createWatcher(clientId, fsPath, options) {
-        const watcherOptions = {
-            ignored: options.ignored
-                .map(pattern => new minimatch_1.Minimatch(pattern, { dot: true })),
-            ignorePatterns: options.ignored,
-        };
-        return new ParcelWatcher(clientId, fsPath, watcherOptions, this.options, this.maybeClient);
-    }
-    async unwatchFileChanges(watcherId) {
-        const handle = this.watcherHandles.get(watcherId);
-        if (handle === undefined) {
-            console.warn(`tried to de-allocate a disposed watcher: watcherId=${watcherId}`);
-        }
-        else {
-            this.watcherHandles.delete(watcherId);
-            handle.watcher.removeRef(handle.clientId);
-        }
-    }
-    /**
-     * Given some `URI` and some `WatchOptions`, generate a unique key.
-     */
-    getWatcherKey(uri, options) {
-        return [
-            uri,
-            options.ignored.slice(0).sort().join() // use a **sorted copy** of `ignored` as part of the key
-        ].join();
-    }
-    /**
-     * Return fully qualified options.
-     */
-    resolveWatchOptions(options) {
-        return {
-            ignored: [],
-            ...options,
-        };
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    debug(message, ...params) {
-        if (this.options.verbose) {
-            this.options.info(message, ...params);
-        }
-    }
-    dispose() {
-        // Singletons shouldn't be disposed...
-    }
-}
-exports.ParcelFileSystemWatcherService = ParcelFileSystemWatcherService;
+exports.ParcelFileSystemWatcherService = void 0;
+const tslib_1 = require("tslib");
+const filesystem_watcher_service_impl_1 = require("../filesystem-watcher-service-impl");
+tslib_1.__exportStar(require("./parcel-watcher"), exports);
+tslib_1.__exportStar(require("../filesystem-watcher-service-impl"), exports);
+/** @deprecated since 1.77.0 - use `FileSystemWatcherServiceImpl`, which also serves non-recursive requests. */
+exports.ParcelFileSystemWatcherService = filesystem_watcher_service_impl_1.FileSystemWatcherServiceImpl;
 //# sourceMappingURL=parcel-filesystem-service.js.map