@venos-inc/venos 0.1.14 → 0.1.15

package/etc/mcp-server/node_modules/@types/node/events.d.ts

@@ -32,10 +32,43 @@
  * });
  * myEmitter.emit('event');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/events.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/events.js)
  */
 declare module "events" {
     import { AsyncResource, AsyncResourceOptions } from "node:async_hooks";
+    // NOTE: This class is in the docs but is **not actually exported** by Node.
+    // If https://github.com/nodejs/node/issues/39903 gets resolved and Node
+    // actually starts exporting the class, uncomment below.
+    // import { EventListener, EventListenerObject } from '__dom-events';
+    // /** The NodeEventTarget is a Node.js-specific extension to EventTarget that emulates a subset of the EventEmitter API. */
+    // interface NodeEventTarget extends EventTarget {
+    //     /**
+    //      * Node.js-specific extension to the `EventTarget` class that emulates the equivalent `EventEmitter` API.
+    //      * The only difference between `addListener()` and `addEventListener()` is that addListener() will return a reference to the EventTarget.
+    //      */
+    //     addListener(type: string, listener: EventListener | EventListenerObject, options?: { once: boolean }): this;
+    //     /** Node.js-specific extension to the `EventTarget` class that returns an array of event `type` names for which event listeners are registered. */
+    //     eventNames(): string[];
+    //     /** Node.js-specific extension to the `EventTarget` class that returns the number of event listeners registered for the `type`. */
+    //     listenerCount(type: string): number;
+    //     /** Node.js-specific alias for `eventTarget.removeListener()`. */
+    //     off(type: string, listener: EventListener | EventListenerObject): this;
+    //     /** Node.js-specific alias for `eventTarget.addListener()`. */
+    //     on(type: string, listener: EventListener | EventListenerObject, options?: { once: boolean }): this;
+    //     /** Node.js-specific extension to the `EventTarget` class that adds a `once` listener for the given event `type`. This is equivalent to calling `on` with the `once` option set to `true`. */
+    //     once(type: string, listener: EventListener | EventListenerObject): this;
+    //     /**
+    //      * Node.js-specific extension to the `EventTarget` class.
+    //      * If `type` is specified, removes all registered listeners for `type`,
+    //      * otherwise removes all registered listeners.
+    //      */
+    //     removeAllListeners(type: string): this;
+    //     /**
+    //      * Node.js-specific extension to the `EventTarget` class that removes the listener for the given `type`.
+    //      * The only difference between `removeListener()` and `removeEventListener()` is that `removeListener()` will return a reference to the `EventTarget`.
+    //      */
+    //     removeListener(type: string, listener: EventListener | EventListenerObject): this;
+    // }
     interface EventEmitterOptions {
         /**
          * Enables automatic capturing of promise rejection.
@@ -271,12 +304,12 @@ declare module "events" {
             emitter: NodeJS.EventEmitter,
             eventName: string | symbol,
             options?: StaticEventEmitterIteratorOptions,
-        ): NodeJS.AsyncIterator<any[]>;
+        ): AsyncIterableIterator<any[]>;
         static on(
             emitter: EventTarget,
             eventName: string,
             options?: StaticEventEmitterIteratorOptions,
-        ): NodeJS.AsyncIterator<any[]>;
+        ): AsyncIterableIterator<any[]>;
         /**
          * A class method that returns the number of listeners for the given `eventName` registered on the given `emitter`.
          *
@@ -363,7 +396,7 @@ declare module "events" {
          * ```
          * @since v15.4.0
          * @param n A non-negative number. The maximum number of listeners per `EventTarget` event.
-         * @param eventTargets Zero or more {EventTarget} or {EventEmitter} instances. If none are specified, `n` is set as the default max for all newly created {EventTarget} and {EventEmitter}
+         * @param eventsTargets Zero or more {EventTarget} or {EventEmitter} instances. If none are specified, `n` is set as the default max for all newly created {EventTarget} and {EventEmitter}
          * objects.
          */
         static setMaxListeners(n?: number, ...eventTargets: Array<EventTarget | NodeJS.EventEmitter>): void;
@@ -398,6 +431,7 @@ declare module "events" {
          * }
          * ```
          * @since v20.5.0
+         * @experimental
          * @return Disposable that removes the `abort` listener.
          */
         static addAbortListener(signal: AbortSignal, resource: (event: Event) => void): Disposable;
@@ -484,7 +518,7 @@ declare module "events" {
              * directly rather than as a child class.
              * @default new.target.name if instantiated as a child class.
              */
-            name?: string | undefined;
+            name?: string;
         }
 
         /**
@@ -551,85 +585,6 @@ declare module "events" {
              */
             readonly asyncResource: EventEmitterReferencingAsyncResource;
         }
-        /**
-         * The `NodeEventTarget` is a Node.js-specific extension to `EventTarget`
-         * that emulates a subset of the `EventEmitter` API.
-         * @since v14.5.0
-         */
-        export interface NodeEventTarget extends EventTarget {
-            /**
-             * Node.js-specific extension to the `EventTarget` class that emulates the
-             * equivalent `EventEmitter` API. The only difference between `addListener()` and
-             * `addEventListener()` is that `addListener()` will return a reference to the
-             * `EventTarget`.
-             * @since v14.5.0
-             */
-            addListener(type: string, listener: (arg: any) => void): this;
-            /**
-             * Node.js-specific extension to the `EventTarget` class that dispatches the
-             * `arg` to the list of handlers for `type`.
-             * @since v15.2.0
-             * @returns `true` if event listeners registered for the `type` exist,
-             * otherwise `false`.
-             */
-            emit(type: string, arg: any): boolean;
-            /**
-             * Node.js-specific extension to the `EventTarget` class that returns an array
-             * of event `type` names for which event listeners are registered.
-             * @since 14.5.0
-             */
-            eventNames(): string[];
-            /**
-             * Node.js-specific extension to the `EventTarget` class that returns the number
-             * of event listeners registered for the `type`.
-             * @since v14.5.0
-             */
-            listenerCount(type: string): number;
-            /**
-             * Node.js-specific extension to the `EventTarget` class that sets the number
-             * of max event listeners as `n`.
-             * @since v14.5.0
-             */
-            setMaxListeners(n: number): void;
-            /**
-             * Node.js-specific extension to the `EventTarget` class that returns the number
-             * of max event listeners.
-             * @since v14.5.0
-             */
-            getMaxListeners(): number;
-            /**
-             * Node.js-specific alias for `eventTarget.removeEventListener()`.
-             * @since v14.5.0
-             */
-            off(type: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
-            /**
-             * Node.js-specific alias for `eventTarget.addEventListener()`.
-             * @since v14.5.0
-             */
-            on(type: string, listener: (arg: any) => void): this;
-            /**
-             * Node.js-specific extension to the `EventTarget` class that adds a `once`
-             * listener for the given event `type`. This is equivalent to calling `on`
-             * with the `once` option set to `true`.
-             * @since v14.5.0
-             */
-            once(type: string, listener: (arg: any) => void): this;
-            /**
-             * Node.js-specific extension to the `EventTarget` class. If `type` is specified,
-             * removes all registered listeners for `type`, otherwise removes all registered
-             * listeners.
-             * @since v14.5.0
-             */
-            removeAllListeners(type?: string): this;
-            /**
-             * Node.js-specific extension to the `EventTarget` class that removes the
-             * `listener` for the given `type`. The only difference between `removeListener()`
-             * and `removeEventListener()` is that `removeListener()` will return a reference
-             * to the `EventTarget`.
-             * @since v14.5.0
-             */
-            removeListener(type: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
-        }
     }
     global {
         namespace NodeJS {
@@ -813,7 +768,7 @@ declare module "events" {
                 setMaxListeners(n: number): this;
                 /**
                  * Returns the current max listener value for the `EventEmitter` which is either
-                 * set by `emitter.setMaxListeners(n)` or defaults to {@link EventEmitter.defaultMaxListeners}.
+                 * set by `emitter.setMaxListeners(n)` or defaults to {@link defaultMaxListeners}.
                  * @since v1.0.0
                  */
                 getMaxListeners(): number;

package/etc/mcp-server/node_modules/@types/node/fs/promises.d.ts

@@ -9,7 +9,6 @@
  * @since v10.0.0
  */
 declare module "fs/promises" {
-    import { NonSharedBuffer } from "node:buffer";
     import { Abortable } from "node:events";
     import { Stream } from "node:stream";
     import { ReadableStream } from "node:stream/web";
@@ -21,18 +20,12 @@ declare module "fs/promises" {
         CopyOptions,
         Dir,
         Dirent,
-        GlobOptions,
-        GlobOptionsWithFileTypes,
-        GlobOptionsWithoutFileTypes,
         MakeDirectoryOptions,
         Mode,
         ObjectEncodingOptions,
         OpenDirOptions,
         OpenMode,
         PathLike,
-        ReadOptions,
-        ReadOptionsWithBuffer,
-        ReadPosition,
         ReadStream,
         ReadVResult,
         RmDirOptions,
@@ -43,7 +36,7 @@ declare module "fs/promises" {
         StatsFs,
         TimeLike,
         WatchEventType,
-        WatchOptions as _WatchOptions,
+        WatchOptions,
         WriteStream,
         WriteVResult,
     } from "node:fs";
@@ -60,7 +53,6 @@ declare module "fs/promises" {
         bytesRead: number;
         buffer: T;
     }
-    /** @deprecated This interface will be removed in a future version. Use `import { ReadOptionsWithBuffer } from "node:fs"` instead. */
     interface FileReadOptions<T extends NodeJS.ArrayBufferView = Buffer> {
         /**
          * @default `Buffer.alloc(0xffff)`
@@ -74,9 +66,9 @@ declare module "fs/promises" {
          * @default `buffer.byteLength`
          */
         length?: number | null;
-        position?: ReadPosition | null;
+        position?: number | null;
     }
-    interface CreateReadStreamOptions extends Abortable {
+    interface CreateReadStreamOptions {
         encoding?: BufferEncoding | null | undefined;
         autoClose?: boolean | undefined;
         emitClose?: boolean | undefined;
@@ -93,7 +85,11 @@ declare module "fs/promises" {
         flush?: boolean | undefined;
     }
     interface ReadableWebStreamOptions {
-        autoClose?: boolean | undefined;
+        /**
+         * Whether to open a normal or a `'bytes'` stream.
+         * @since v20.0.0
+         */
+        type?: "bytes" | undefined;
     }
     // TODO: Add `EventEmitter` close
     interface FileHandle {
@@ -113,7 +109,7 @@ declare module "fs/promises" {
         appendFile(
             data: string | Uint8Array,
             options?:
-                | (ObjectEncodingOptions & Abortable)
+                | (ObjectEncodingOptions & FlagAndOpenMode & { flush?: boolean | undefined })
                 | BufferEncoding
                 | null,
         ): Promise<void>;
@@ -237,18 +233,11 @@ declare module "fs/promises" {
             buffer: T,
             offset?: number | null,
             length?: number | null,
-            position?: ReadPosition | null,
-        ): Promise<FileReadResult<T>>;
-        read<T extends NodeJS.ArrayBufferView>(
-            buffer: T,
-            options?: ReadOptions,
-        ): Promise<FileReadResult<T>>;
-        read<T extends NodeJS.ArrayBufferView = NonSharedBuffer>(
-            options?: ReadOptionsWithBuffer<T>,
+            position?: number | null,
         ): Promise<FileReadResult<T>>;
+        read<T extends NodeJS.ArrayBufferView = Buffer>(options?: FileReadOptions<T>): Promise<FileReadResult<T>>;
         /**
-         * Returns a byte-oriented `ReadableStream` that may be used to read the file's
-         * contents.
+         * Returns a `ReadableStream` that may be used to read the files data.
          *
          * An error will be thrown if this method is called more than once or is called
          * after the `FileHandle` is closed or closing.
@@ -269,6 +258,7 @@ declare module "fs/promises" {
          * While the `ReadableStream` will read the file to completion, it will not
          * close the `FileHandle` automatically. User code must still call the`fileHandle.close()` method.
          * @since v17.0.0
+         * @experimental
          */
         readableWebStream(options?: ReadableWebStreamOptions): ReadableStream;
         /**
@@ -286,29 +276,39 @@ declare module "fs/promises" {
          * data will be a string.
          */
         readFile(
-            options?:
-                | ({ encoding?: null | undefined } & Abortable)
-                | null,
-        ): Promise<NonSharedBuffer>;
+            options?: {
+                encoding?: null | undefined;
+                flag?: OpenMode | undefined;
+            } | null,
+        ): Promise<Buffer>;
         /**
          * Asynchronously reads the entire contents of a file. The underlying file will _not_ be closed automatically.
          * The `FileHandle` must have been opened for reading.
+         * @param options An object that may contain an optional flag.
+         * If a flag is not provided, it defaults to `'r'`.
          */
         readFile(
             options:
-                | ({ encoding: BufferEncoding } & Abortable)
+                | {
+                    encoding: BufferEncoding;
+                    flag?: OpenMode | undefined;
+                }
                 | BufferEncoding,
         ): Promise<string>;
         /**
          * Asynchronously reads the entire contents of a file. The underlying file will _not_ be closed automatically.
          * The `FileHandle` must have been opened for reading.
+         * @param options An object that may contain an optional flag.
+         * If a flag is not provided, it defaults to `'r'`.
          */
         readFile(
             options?:
-                | (ObjectEncodingOptions & Abortable)
+                | (ObjectEncodingOptions & {
+                    flag?: OpenMode | undefined;
+                })
                 | BufferEncoding
                 | null,
-        ): Promise<string | NonSharedBuffer>;
+        ): Promise<string | Buffer>;
         /**
          * Convenience method to create a `readline` interface and stream over the file.
          * See `filehandle.createReadStream()` for the options.
@@ -395,7 +395,7 @@ declare module "fs/promises" {
         writeFile(
             data: string | Uint8Array,
             options?:
-                | (ObjectEncodingOptions & Abortable)
+                | (ObjectEncodingOptions & FlagAndOpenMode & Abortable & { flush?: boolean | undefined })
                 | BufferEncoding
                 | null,
         ): Promise<void>;
@@ -417,7 +417,7 @@ declare module "fs/promises" {
          * @param [position='null'] The offset from the beginning of the file where the data from `buffer` should be written. If `position` is not a `number`, the data will be written at the current
          * position. See the POSIX pwrite(2) documentation for more detail.
          */
-        write<TBuffer extends NodeJS.ArrayBufferView>(
+        write<TBuffer extends Uint8Array>(
             buffer: TBuffer,
             offset?: number | null,
             length?: number | null,
@@ -426,13 +426,6 @@ declare module "fs/promises" {
             bytesWritten: number;
             buffer: TBuffer;
         }>;
-        write<TBuffer extends Uint8Array>(
-            buffer: TBuffer,
-            options?: { offset?: number; length?: number; position?: number },
-        ): Promise<{
-            bytesWritten: number;
-            buffer: TBuffer;
-        }>;
         write(
             data: string,
             position?: number | null,
@@ -456,20 +449,14 @@ declare module "fs/promises" {
          * @param [position='null'] The offset from the beginning of the file where the data from `buffers` should be written. If `position` is not a `number`, the data will be written at the current
          * position.
          */
-        writev<TBuffers extends readonly NodeJS.ArrayBufferView[]>(
-            buffers: TBuffers,
-            position?: number,
-        ): Promise<WriteVResult<TBuffers>>;
+        writev(buffers: readonly NodeJS.ArrayBufferView[], position?: number): Promise<WriteVResult>;
         /**
          * Read from a file and write to an array of [ArrayBufferView](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView) s
          * @since v13.13.0, v12.17.0
          * @param [position='null'] The offset from the beginning of the file where the data should be read from. If `position` is not a `number`, the data will be read from the current position.
          * @return Fulfills upon success an object containing two properties:
          */
-        readv<TBuffers extends readonly NodeJS.ArrayBufferView[]>(
-            buffers: TBuffers,
-            position?: number,
-        ): Promise<ReadVResult<TBuffers>>;
+        readv(buffers: readonly NodeJS.ArrayBufferView[], position?: number): Promise<ReadVResult>;
         /**
          * Closes the file handle after waiting for any pending operation on the handle to
          * complete.
@@ -489,8 +476,7 @@ declare module "fs/promises" {
          */
         close(): Promise<void>;
         /**
-         * Calls `filehandle.close()` and returns a promise that fulfills when the
-         * filehandle is closed.
+         * An alias for {@link FileHandle.close()}.
          * @since v20.4.0
          */
         [Symbol.asyncDispose](): Promise<void>;
@@ -706,7 +692,7 @@ declare module "fs/promises" {
                 recursive?: boolean | undefined;
             }
             | "buffer",
-    ): Promise<NonSharedBuffer[]>;
+    ): Promise<Buffer[]>;
     /**
      * Asynchronous readdir(3) - read a directory.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
@@ -721,7 +707,7 @@ declare module "fs/promises" {
             })
             | BufferEncoding
             | null,
-    ): Promise<string[] | NonSharedBuffer[]>;
+    ): Promise<string[] | Buffer[]>;
     /**
      * Asynchronous readdir(3) - read a directory.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
@@ -734,19 +720,6 @@ declare module "fs/promises" {
             recursive?: boolean | undefined;
         },
     ): Promise<Dirent[]>;
-    /**
-     * Asynchronous readdir(3) - read a directory.
-     * @param path A path to a directory. If a URL is provided, it must use the `file:` protocol.
-     * @param options Must include `withFileTypes: true` and `encoding: 'buffer'`.
-     */
-    function readdir(
-        path: PathLike,
-        options: {
-            encoding: "buffer";
-            withFileTypes: true;
-            recursive?: boolean | undefined;
-        },
-    ): Promise<Dirent<NonSharedBuffer>[]>;
     /**
      * Reads the contents of the symbolic link referred to by `path`. See the POSIX [`readlink(2)`](http://man7.org/linux/man-pages/man2/readlink.2.html) documentation for more detail. The promise is
      * fulfilled with the`linkString` upon success.
@@ -764,16 +737,13 @@ declare module "fs/promises" {
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
      */
-    function readlink(path: PathLike, options: BufferEncodingOption): Promise<NonSharedBuffer>;
+    function readlink(path: PathLike, options: BufferEncodingOption): Promise<Buffer>;
     /**
      * Asynchronous readlink(2) - read value of a symbolic link.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
      */
-    function readlink(
-        path: PathLike,
-        options?: ObjectEncodingOptions | string | null,
-    ): Promise<string | NonSharedBuffer>;
+    function readlink(path: PathLike, options?: ObjectEncodingOptions | string | null): Promise<string | Buffer>;
     /**
      * Creates a symbolic link.
      *
@@ -924,7 +894,7 @@ declare module "fs/promises" {
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
      */
-    function realpath(path: PathLike, options: BufferEncodingOption): Promise<NonSharedBuffer>;
+    function realpath(path: PathLike, options: BufferEncodingOption): Promise<Buffer>;
     /**
      * Asynchronous realpath(3) - return the canonicalized absolute pathname.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
@@ -933,7 +903,7 @@ declare module "fs/promises" {
     function realpath(
         path: PathLike,
         options?: ObjectEncodingOptions | BufferEncoding | null,
-    ): Promise<string | NonSharedBuffer>;
+    ): Promise<string | Buffer>;
     /**
      * Creates a unique temporary directory. A unique directory name is generated by
      * appending six random characters to the end of the provided `prefix`. Due to
@@ -959,7 +929,7 @@ declare module "fs/promises" {
      * The `fsPromises.mkdtemp()` method will append the six randomly selected
      * characters directly to the `prefix` string. For instance, given a directory `/tmp`, if the intention is to create a temporary directory _within_ `/tmp`, the `prefix` must end with a trailing
      * platform-specific path separator
-     * (`import { sep } from 'node:path'`).
+     * (`require('node:path').sep`).
      * @since v10.0.0
      * @return Fulfills with a string containing the file system path of the newly created temporary directory.
      */
@@ -969,16 +939,13 @@ declare module "fs/promises" {
      * Generates six random characters to be appended behind a required `prefix` to create a unique temporary directory.
      * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
      */
-    function mkdtemp(prefix: string, options: BufferEncodingOption): Promise<NonSharedBuffer>;
+    function mkdtemp(prefix: string, options: BufferEncodingOption): Promise<Buffer>;
     /**
      * Asynchronously creates a unique temporary directory.
      * Generates six random characters to be appended behind a required `prefix` to create a unique temporary directory.
      * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
      */
-    function mkdtemp(
-        prefix: string,
-        options?: ObjectEncodingOptions | BufferEncoding | null,
-    ): Promise<string | NonSharedBuffer>;
+    function mkdtemp(prefix: string, options?: ObjectEncodingOptions | BufferEncoding | null): Promise<string | Buffer>;
     /**
      * Asynchronously writes data to a file, replacing the file if it already exists. `data` can be a string, a buffer, an
      * [AsyncIterable](https://tc39.github.io/ecma262/#sec-asynciterable-interface), or an
@@ -1134,7 +1101,7 @@ declare module "fs/promises" {
                 flag?: OpenMode | undefined;
             } & Abortable)
             | null,
-    ): Promise<NonSharedBuffer>;
+    ): Promise<Buffer>;
     /**
      * Asynchronously reads the entire contents of a file.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
@@ -1170,7 +1137,7 @@ declare module "fs/promises" {
             )
             | BufferEncoding
             | null,
-    ): Promise<string | NonSharedBuffer>;
+    ): Promise<string | Buffer>;
     /**
      * Asynchronously open a directory for iterative scanning. See the POSIX [`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html) documentation for more detail.
      *
@@ -1200,21 +1167,11 @@ declare module "fs/promises" {
      * @return Fulfills with an {fs.Dir}.
      */
     function opendir(path: PathLike, options?: OpenDirOptions): Promise<Dir>;
-    interface WatchOptions extends _WatchOptions {
-        maxQueue?: number | undefined;
-        overflow?: "ignore" | "throw" | undefined;
-    }
-    interface WatchOptionsWithBufferEncoding extends WatchOptions {
-        encoding: "buffer";
-    }
-    interface WatchOptionsWithStringEncoding extends WatchOptions {
-        encoding?: BufferEncoding | undefined;
-    }
     /**
      * Returns an async iterator that watches for changes on `filename`, where `filename`is either a file or a directory.
      *
      * ```js
-     * import { watch } from 'node:fs/promises';
+     * const { watch } = require('node:fs/promises');
      *
      * const ac = new AbortController();
      * const { signal } = ac;
@@ -1242,16 +1199,33 @@ declare module "fs/promises" {
      */
     function watch(
         filename: PathLike,
-        options?: WatchOptionsWithStringEncoding | BufferEncoding,
-    ): NodeJS.AsyncIterator<FileChangeInfo<string>>;
-    function watch(
-        filename: PathLike,
-        options: WatchOptionsWithBufferEncoding | "buffer",
-    ): NodeJS.AsyncIterator<FileChangeInfo<NonSharedBuffer>>;
+        options:
+            | (WatchOptions & {
+                encoding: "buffer";
+            })
+            | "buffer",
+    ): AsyncIterable<FileChangeInfo<Buffer>>;
+    /**
+     * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
+     * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
+     * @param options Either the encoding for the filename provided to the listener, or an object optionally specifying encoding, persistent, and recursive options.
+     * If `encoding` is not supplied, the default of `'utf8'` is used.
+     * If `persistent` is not supplied, the default of `true` is used.
+     * If `recursive` is not supplied, the default of `false` is used.
+     */
+    function watch(filename: PathLike, options?: WatchOptions | BufferEncoding): AsyncIterable<FileChangeInfo<string>>;
+    /**
+     * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
+     * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
+     * @param options Either the encoding for the filename provided to the listener, or an object optionally specifying encoding, persistent, and recursive options.
+     * If `encoding` is not supplied, the default of `'utf8'` is used.
+     * If `persistent` is not supplied, the default of `true` is used.
+     * If `recursive` is not supplied, the default of `false` is used.
+     */
     function watch(
         filename: PathLike,
-        options: WatchOptions | BufferEncoding | "buffer",
-    ): NodeJS.AsyncIterator<FileChangeInfo<string | NonSharedBuffer>>;
+        options: WatchOptions | string,
+    ): AsyncIterable<FileChangeInfo<string>> | AsyncIterable<FileChangeInfo<Buffer>>;
     /**
      * Asynchronously copies the entire directory structure from `src` to `dest`,
      * including subdirectories and files.
@@ -1265,30 +1239,6 @@ declare module "fs/promises" {
      * @return Fulfills with `undefined` upon success.
      */
     function cp(source: string | URL, destination: string | URL, opts?: CopyOptions): Promise<void>;
-    /**
-     * ```js
-     * import { glob } from 'node:fs/promises';
-     *
-     * for await (const entry of glob('*.js'))
-     *   console.log(entry);
-     * ```
-     * @since v22.0.0
-     * @returns An AsyncIterator that yields the paths of files
-     * that match the pattern.
-     */
-    function glob(pattern: string | readonly string[]): NodeJS.AsyncIterator<string>;
-    function glob(
-        pattern: string | readonly string[],
-        options: GlobOptionsWithFileTypes,
-    ): NodeJS.AsyncIterator<Dirent>;
-    function glob(
-        pattern: string | readonly string[],
-        options: GlobOptionsWithoutFileTypes,
-    ): NodeJS.AsyncIterator<string>;
-    function glob(
-        pattern: string | readonly string[],
-        options: GlobOptions,
-    ): NodeJS.AsyncIterator<Dirent | string>;
 }
 declare module "node:fs/promises" {
     export * from "fs/promises";