@types/node 16.6.2 → 16.7.0

node/fs.d.ts

@@ -16,7 +16,7 @@
  *
  * All file system operations have synchronous, callback, and promise-based
  * forms, and are accessible using both CommonJS syntax and ES6 Modules (ESM).
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/fs.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/fs.js)
  */
 declare module 'fs' {
     import * as stream from 'node:stream';
@@ -71,7 +71,7 @@ declare module 'fs' {
     }
     export interface Stats extends StatsBase<number> {}
     /**
-     * A `<fs.Stats>` object provides information about a file.
+     * A `fs.Stats` object provides information about a file.
      *
      * Objects returned from {@link stat}, {@link lstat} and {@link fstat} and
      * their synchronous counterparts are of this type.
@@ -133,53 +133,53 @@ declare module 'fs' {
     export class Stats {}
     /**
      * A representation of a directory entry, which can be a file or a subdirectory
-     * within the directory, as returned by reading from an `<fs.Dir>`. The
+     * within the directory, as returned by reading from an `fs.Dir`. The
      * directory entry is a combination of the file name and file type pairs.
      *
      * Additionally, when {@link readdir} or {@link readdirSync} is called with
-     * the `withFileTypes` option set to `true`, the resulting array is filled with `<fs.Dirent>` objects, rather than strings or `<Buffer>` s.
+     * the `withFileTypes` option set to `true`, the resulting array is filled with `fs.Dirent` objects, rather than strings or `Buffer` s.
      * @since v10.10.0
      */
     export class Dirent {
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a regular file.
+         * Returns `true` if the `fs.Dirent` object describes a regular file.
          * @since v10.10.0
          */
         isFile(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a file system
+         * Returns `true` if the `fs.Dirent` object describes a file system
          * directory.
          * @since v10.10.0
          */
         isDirectory(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a block device.
+         * Returns `true` if the `fs.Dirent` object describes a block device.
          * @since v10.10.0
          */
         isBlockDevice(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a character device.
+         * Returns `true` if the `fs.Dirent` object describes a character device.
          * @since v10.10.0
          */
         isCharacterDevice(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a symbolic link.
+         * Returns `true` if the `fs.Dirent` object describes a symbolic link.
          * @since v10.10.0
          */
         isSymbolicLink(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a first-in-first-out
+         * Returns `true` if the `fs.Dirent` object describes a first-in-first-out
          * (FIFO) pipe.
          * @since v10.10.0
          */
         isFIFO(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a socket.
+         * Returns `true` if the `fs.Dirent` object describes a socket.
          * @since v10.10.0
          */
         isSocket(): boolean;
         /**
-         * The file name that this `<fs.Dirent>` object refers to. The type of this
+         * The file name that this `fs.Dirent` object refers to. The type of this
          * value is determined by the `options.encoding` passed to {@link readdir} or {@link readdirSync}.
          * @since v10.10.0
          */
@@ -202,7 +202,7 @@ declare module 'fs' {
      * }
      * ```
      *
-     * When using the async iterator, the `<fs.Dir>` object will be automatically
+     * When using the async iterator, the `fs.Dir` object will be automatically
      * closed after the iterator exits.
      * @since v12.12.0
      */
@@ -233,9 +233,9 @@ declare module 'fs' {
          */
         closeSync(): void;
         /**
-         * Asynchronously read the next directory entry via [`readdir(3)`](http://man7.org/linux/man-pages/man3/readdir.3.html) as an `<fs.Dirent>`.
+         * Asynchronously read the next directory entry via [`readdir(3)`](http://man7.org/linux/man-pages/man3/readdir.3.html) as an `fs.Dirent`.
          *
-         * A promise is returned that will be resolved with an `<fs.Dirent>`, or `null`if there are no more directory entries to read.
+         * A promise is returned that will be resolved with an `fs.Dirent`, or `null`if there are no more directory entries to read.
          *
          * Directory entries returned by this function are in no particular order as
          * provided by the operating system's underlying directory mechanisms.
@@ -247,7 +247,7 @@ declare module 'fs' {
         read(): Promise<Dirent | null>;
         read(cb: (err: NodeJS.ErrnoException | null, dirEnt: Dirent | null) => void): void;
         /**
-         * Synchronously read the next directory entry as an `<fs.Dirent>`. See the
+         * Synchronously read the next directory entry as an `fs.Dirent`. See the
          * POSIX [`readdir(3)`](http://man7.org/linux/man-pages/man3/readdir.3.html) documentation for more detail.
          *
          * If there are no more directory entries to read, `null` will be returned.
@@ -262,7 +262,7 @@ declare module 'fs' {
     }
     export interface FSWatcher extends EventEmitter {
         /**
-         * Stop watching for changes on the given `<fs.FSWatcher>`. Once stopped, the `<fs.FSWatcher>` object is no longer usable.
+         * Stop watching for changes on the given `fs.FSWatcher`. Once stopped, the `fs.FSWatcher` object is no longer usable.
          * @since v0.5.8
          */
         close(): void;
@@ -293,7 +293,7 @@ declare module 'fs' {
         prependOnceListener(event: 'close', listener: () => void): this;
     }
     /**
-     * Instances of `<fs.ReadStream>` are created and returned using the {@link createReadStream} function.
+     * Instances of `fs.ReadStream` are created and returned using the {@link createReadStream} function.
      * @since v0.1.93
      */
     export class ReadStream extends stream.Readable {
@@ -305,8 +305,8 @@ declare module 'fs' {
         bytesRead: number;
         /**
          * The path to the file the stream is reading from as specified in the first
-         * argument to `fs.createReadStream()`. If `path` is passed as a string, then`readStream.path` will be a string. If `path` is passed as a `<Buffer>`, then`readStream.path` will be a
-         * `<Buffer>`.
+         * argument to `fs.createReadStream()`. If `path` is passed as a string, then`readStream.path` will be a string. If `path` is passed as a `Buffer`, then`readStream.path` will be a
+         * `Buffer`.
          * @since v0.1.93
          */
         path: string | Buffer;
@@ -374,9 +374,9 @@ declare module 'fs' {
         prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
     }
     /**
-     * * Extends `<stream.Writable>`
+     * * Extends `stream.Writable`
      *
-     * Instances of `<fs.WriteStream>` are created and returned using the {@link createWriteStream} function.
+     * Instances of `fs.WriteStream` are created and returned using the {@link createWriteStream} function.
      * @since v0.1.93
      */
     export class WriteStream extends stream.Writable {
@@ -394,8 +394,8 @@ declare module 'fs' {
         bytesWritten: number;
         /**
          * The path to the file the stream is writing to as specified in the first
-         * argument to {@link createWriteStream}. If `path` is passed as a string, then`writeStream.path` will be a string. If `path` is passed as a `<Buffer>`, then`writeStream.path` will be a
-         * `<Buffer>`.
+         * argument to {@link createWriteStream}. If `path` is passed as a string, then`writeStream.path` will be a string. If `path` is passed as a `Buffer`, then`writeStream.path` will be a
+         * `Buffer`.
          * @since v0.1.93
          */
         path: string | Buffer;
@@ -499,6 +499,15 @@ declare module 'fs' {
      * given to the completion callback. A file descriptor can also be passed as the
      * first argument. In this case, `fs.ftruncate()` is called.
      *
+     * ```js
+     * import { truncate } from 'fs';
+     * // Assuming that 'path/file.txt' is a regular file.
+     * truncate('path/file.txt', (err) => {
+     *   if (err) throw err;
+     *   console.log('path/file.txt was truncated');
+     * });
+     * ```
+     *
      * Passing a file descriptor is deprecated and may result in an error being thrown
      * in the future.
      *
@@ -777,7 +786,7 @@ declare module 'fs' {
      */
     export function lchmodSync(path: PathLike, mode: Mode): void;
     /**
-     * Asynchronous [`stat(2)`](http://man7.org/linux/man-pages/man2/stat.2.html). The callback gets two arguments `(err, stats)` where`stats` is an `<fs.Stats>` object.
+     * Asynchronous [`stat(2)`](http://man7.org/linux/man-pages/man2/stat.2.html). The callback gets two arguments `(err, stats)` where`stats` is an `fs.Stats` object.
      *
      * In case of an error, the `err.code` will be one of `Common System Errors`.
      *
@@ -938,7 +947,7 @@ declare module 'fs' {
      */
     export const statSync: StatSyncFn;
     /**
-     * Invokes the callback with the `<fs.Stats>` for the file descriptor.
+     * Invokes the callback with the `fs.Stats` for the file descriptor.
      *
      * See the POSIX [`fstat(2)`](http://man7.org/linux/man-pages/man2/fstat.2.html) documentation for more detail.
      * @since v0.1.95
@@ -986,8 +995,8 @@ declare module 'fs' {
      */
     export const fstatSync: StatSyncFn<number>;
     /**
-     * Retrieves the `<fs.Stats>` for the symbolic link referred to by the path.
-     * The callback gets two arguments `(err, stats)` where `stats` is a `<fs.Stats>` object. `lstat()` is identical to `stat()`, except that if `path` is a symbolic
+     * Retrieves the `fs.Stats` for the symbolic link referred to by the path.
+     * The callback gets two arguments `(err, stats)` where `stats` is a `fs.Stats` object. `lstat()` is identical to `stat()`, except that if `path` is a symbolic
      * link, then the link itself is stat-ed, not the file that it refers to.
      *
      * See the POSIX [`lstat(2)`](http://man7.org/linux/man-pages/man2/lstat.2.html) documentation for more details.
@@ -1121,7 +1130,7 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the link path passed to the callback. If the `encoding` is set to `'buffer'`,
-     * the link path returned will be passed as a `<Buffer>` object.
+     * the link path returned will be passed as a `Buffer` object.
      * @since v0.1.31
      */
     export function readlink(path: PathLike, options: EncodingOption, callback: (err: NodeJS.ErrnoException | null, linkString: string) => void): void;
@@ -1170,7 +1179,7 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the link path returned. If the `encoding` is set to `'buffer'`,
-     * the link path returned will be passed as a `<Buffer>` object.
+     * the link path returned will be passed as a `Buffer` object.
      * @since v0.1.31
      */
     export function readlinkSync(path: PathLike, options?: EncodingOption): string;
@@ -1206,7 +1215,7 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the path passed to the callback. If the `encoding` is set to `'buffer'`,
-     * the path returned will be passed as a `<Buffer>` object.
+     * the path returned will be passed as a `Buffer` object.
      *
      * If `path` resolves to a socket or a pipe, the function will return a system
      * dependent name for that object.
@@ -1259,7 +1268,7 @@ declare module 'fs' {
          * The optional `options` argument can be a string specifying an encoding, or an
          * object with an `encoding` property specifying the character encoding to use for
          * the path passed to the callback. If the `encoding` is set to `'buffer'`,
-         * the path returned will be passed as a `<Buffer>` object.
+         * the path returned will be passed as a `Buffer` object.
          *
          * On Linux, when Node.js is linked against musl libc, the procfs file system must
          * be mounted on `/proc` in order for this function to work. Glibc does not have
@@ -1719,9 +1728,9 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the filenames passed to the callback. If the `encoding` is set to `'buffer'`,
-     * the filenames returned will be passed as `<Buffer>` objects.
+     * the filenames returned will be passed as `Buffer` objects.
      *
-     * If `options.withFileTypes` is set to `true`, the `files` array will contain `<fs.Dirent>` objects.
+     * If `options.withFileTypes` is set to `true`, the `files` array will contain `fs.Dirent` objects.
      * @since v0.1.8
      */
     export function readdir(
@@ -1848,9 +1857,9 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the filenames returned. If the `encoding` is set to `'buffer'`,
-     * the filenames returned will be passed as `<Buffer>` objects.
+     * the filenames returned will be passed as `Buffer` objects.
      *
-     * If `options.withFileTypes` is set to `true`, the result will contain `<fs.Dirent>` objects.
+     * If `options.withFileTypes` is set to `true`, the result will contain `fs.Dirent` objects.
      * @since v0.1.21
      */
     export function readdirSync(
@@ -2530,7 +2539,7 @@ declare module 'fs' {
      * performs multiple `write` calls internally to write the buffer passed to it.
      * For performance sensitive code consider using {@link createWriteStream}.
      *
-     * It is possible to use an `<AbortSignal>` to cancel an `fs.writeFile()`.
+     * It is possible to use an `AbortSignal` to cancel an `fs.writeFile()`.
      * Cancelation is "best effort", and some amount of data is likely still
      * to be written.
      *
@@ -2589,7 +2598,7 @@ declare module 'fs' {
     export function writeFileSync(file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options?: WriteFileOptions): void;
     /**
      * Asynchronously append data to a file, creating the file if it does not yet
-     * exist. `data` can be a string or a `<Buffer>`.
+     * exist. `data` can be a string or a `Buffer`.
      *
      * ```js
      * import { appendFile } from 'fs';
@@ -2663,7 +2672,7 @@ declare module 'fs' {
     }
     /**
      * Synchronously append data to a file, creating the file if it does not yet
-     * exist. `data` can be a string or a `<Buffer>`.
+     * exist. `data` can be a string or a `Buffer`.
      *
      * ```js
      * import { appendFileSync } from 'fs';
@@ -2801,10 +2810,10 @@ declare module 'fs' {
      * On most platforms, `'rename'` is emitted whenever a filename appears or
      * disappears in the directory.
      *
-     * The listener callback is attached to the `'change'` event fired by `<fs.FSWatcher>`, but it is not the same thing as the `'change'` value of`eventType`.
+     * The listener callback is attached to the `'change'` event fired by `fs.FSWatcher`, but it is not the same thing as the `'change'` value of`eventType`.
      *
      * If a `signal` is passed, aborting the corresponding AbortController will close
-     * the returned `<fs.FSWatcher>`.
+     * the returned `fs.FSWatcher`.
      * @since v0.5.10
      * @param listener
      */
@@ -3338,11 +3347,11 @@ declare module 'fs' {
      * start counting at 0, allowed values are in the
      * \[0, [`Number.MAX_SAFE_INTEGER`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)\] range. If `fd` is specified and `start` is
      * omitted or `undefined`, `fs.createReadStream()` reads sequentially from the
-     * current file position. The `encoding` can be any one of those accepted by `<Buffer>`.
+     * current file position. The `encoding` can be any one of those accepted by `Buffer`.
      *
      * If `fd` is specified, `ReadStream` will ignore the `path` argument and will use
      * the specified file descriptor. This means that no `'open'` event will be
-     * emitted. `fd` should be blocking; non-blocking `fd`s should be passed to `<net.Socket>`.
+     * emitted. `fd` should be blocking; non-blocking `fd`s should be passed to `net.Socket`.
      *
      * If `fd` points to a character device that only supports blocking reads
      * (such as keyboard or sound card), read operations do not finish until data is
@@ -3399,7 +3408,7 @@ declare module 'fs' {
      * position past the beginning of the file, allowed values are in the
      * \[0, [`Number.MAX_SAFE_INTEGER`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)\] range. Modifying a file rather than replacing
      * it may require the `flags` option to be set to `r+` rather than the default `w`.
-     * The `encoding` can be any one of those accepted by `<Buffer>`.
+     * The `encoding` can be any one of those accepted by `Buffer`.
      *
      * If `autoClose` is set to true (default behavior) on `'error'` or `'finish'`the file descriptor will be closed automatically. If `autoClose` is false,
      * then the file descriptor won't be closed, even if there's an error.
@@ -3413,9 +3422,9 @@ declare module 'fs' {
      * performance as some optimizations (`_writev()`)
      * will be disabled. When providing the `fs` option,  overrides for `open`,`close`, and at least one of `write` and `writev` are required.
      *
-     * Like `<fs.ReadStream>`, if `fd` is specified, `<fs.WriteStream>` will ignore the`path` argument and will use the specified file descriptor. This means that no`'open'` event will be
+     * Like `fs.ReadStream`, if `fd` is specified, `fs.WriteStream` will ignore the`path` argument and will use the specified file descriptor. This means that no`'open'` event will be
      * emitted. `fd` should be blocking; non-blocking `fd`s
-     * should be passed to `<net.Socket>`.
+     * should be passed to `net.Socket`.
      *
      * If `options` is a string, then it specifies the encoding.
      * @since v0.1.31
@@ -3610,7 +3619,7 @@ declare module 'fs' {
     /**
      * Synchronously open a directory. See [`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html).
      *
-     * Creates an `<fs.Dir>`, which contains all further functions for reading from
+     * Creates an `fs.Dir`, which contains all further functions for reading from
      * and cleaning up the directory.
      *
      * The `encoding` option sets the encoding for the `path` while opening the
@@ -3622,7 +3631,7 @@ declare module 'fs' {
      * Asynchronously open a directory. See the POSIX [`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html) documentation for
      * more details.
      *
-     * Creates an `<fs.Dir>`, which contains all further functions for reading from
+     * Creates an `fs.Dir`, which contains all further functions for reading from
      * and cleaning up the directory.
      *
      * The `encoding` option sets the encoding for the `path` while opening the
@@ -3647,6 +3656,67 @@ declare module 'fs' {
         bigint?: boolean | undefined;
         throwIfNoEntry?: boolean | undefined;
     }
+    export interface CopyOptions {
+        /**
+         * Dereference symlinks
+         * @default false
+         */
+        dereference?: boolean;
+        /**
+         * When `force` is `false`, and the destination
+         * exists, throw an error.
+         * @default false
+         */
+        errorOnExist?: boolean;
+        /**
+         * Function to filter copied files/directories. Return
+         * `true` to copy the item, `false` to ignore it.
+         */
+        filter?(source: string, destination: string): boolean;
+        /**
+         * Overwrite existing file or directory. _The copy
+         * operation will ignore errors if you set this to false and the destination
+         * exists. Use the `errorOnExist` option to change this behavior.
+         * @default true
+         */
+        force?: boolean;
+        /**
+         * When `true` timestamps from `src` will
+         * be preserved.
+         * @default false
+         */
+        preserveTimestamps?: boolean;
+        /**
+         * Copy directories recursively.
+         * @default false
+         */
+        recursive?: boolean;
+    }
+    /**
+     * Asynchronously copies the entire directory structure from `src` to `dest`,
+     * including subdirectories and files.
+     *
+     * When copying a directory to another directory, globs are not supported and
+     * behavior is similar to `cp dir1/ dir2/`.
+     * @since v16.7.0
+     * @experimental
+     * @param src source path to copy.
+     * @param dest destination path to copy to.
+     */
+    export function cp(source: string, destination: string, callback: (err: NodeJS.ErrnoException | null) => void): void;
+    export function cp(source: string, destination: string, opts: CopyOptions, callback: (err: NodeJS.ErrnoException | null) => void): void;
+    /**
+     * Synchronously copies the entire directory structure from `src` to `dest`,
+     * including subdirectories and files.
+     *
+     * When copying a directory to another directory, globs are not supported and
+     * behavior is similar to `cp dir1/ dir2/`.
+     * @since v16.7.0
+     * @experimental
+     * @param src source path to copy.
+     * @param dest destination path to copy to.
+     */
+    export function cpSync(source: string, destination: string, opts?: CopyOptions): void;
 }
 declare module 'node:fs' {
     export * from 'fs';

node/http.d.ts

@@ -37,7 +37,7 @@
  *   'Host', 'mysite.com',
  *   'accepT', '*' ]
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/http.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/http.js)
  */
 declare module 'http' {
     import * as stream from 'node:stream';
@@ -740,7 +740,7 @@ declare module 'http' {
      * access response
      * status, headers and data.
      *
-     * Different from its `socket` value which is a subclass of `<stream.Duplex>`, the`IncomingMessage` itself extends `<stream.Readable>` and is created separately to
+     * Different from its `socket` value which is a subclass of `stream.Duplex`, the`IncomingMessage` itself extends `stream.Readable` and is created separately to
      * parse and emit the incoming HTTP headers and payload, as the underlying socket
      * may be reused multiple times in case of keep-alive.
      * @since v0.1.17
@@ -800,9 +800,9 @@ declare module 'http' {
          * With HTTPS support, use `request.socket.getPeerCertificate()` to obtain the
          * client's authentication details.
          *
-         * This property is guaranteed to be an instance of the `<net.Socket>` class,
-         * a subclass of `<stream.Duplex>`, unless the user specified a socket
-         * type other than `<net.Socket>`.
+         * This property is guaranteed to be an instance of the `net.Socket` class,
+         * a subclass of `stream.Duplex`, unless the user specified a socket
+         * type other than `net.Socket`.
          * @since v0.3.0
          */
         socket: Socket;

node/http2.d.ts

@@ -6,7 +6,7 @@
  * const http2 = require('http2');
  * ```
  * @since v8.4.0
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/http2.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/http2.js)
  */
 declare module 'http2' {
     import EventEmitter = require('node:events');

node/https.d.ts

@@ -1,7 +1,7 @@
 /**
  * HTTPS is the HTTP protocol over TLS/SSL. In Node.js this is implemented as a
  * separate module.
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/https.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/https.js)
  */
 declare module 'https' {
     import { Duplex } from 'node:stream';

node/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for non-npm package Node.js 16.6
+// Type definitions for non-npm package Node.js 16.7
 // Project: http://nodejs.org/
 // Definitions by: Microsoft TypeScript <https://github.com/Microsoft>
 //                 DefinitelyTyped <https://github.com/DefinitelyTyped>

node/inspector.d.ts

@@ -15,7 +15,7 @@
  * ```js
  * const inspector = require('inspector');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/inspector.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/inspector.js)
  */
 declare module 'inspector' {
     import EventEmitter = require('node:events');

node/net.d.ts

@@ -10,7 +10,7 @@
  * ```js
  * const net = require('net');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/net.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/net.js)
  */
 declare module 'net' {
     import * as stream from 'node:stream';
@@ -99,7 +99,7 @@ declare module 'net' {
          * * `socket.connect(options[, connectListener])`
          * * `socket.connect(path[, connectListener])` for `IPC` connections.
          * * `socket.connect(port[, host][, connectListener])` for TCP connections.
-         * * Returns: `<net.Socket>` The socket itself.
+         * * Returns: `net.Socket` The socket itself.
          *
          * This function is asynchronous. When the connection is established, the `'connect'` event will be emitted. If there is a problem connecting,
          * instead of a `'connect'` event, an `'error'` event will be emitted with

node/os.d.ts

@@ -5,7 +5,7 @@
  * ```js
  * const os = require('os');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/os.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/os.js)
  */
 declare module 'os' {
     interface CpuInfo {

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "16.6.2",
+    "version": "16.7.0",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -237,6 +237,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "9098a84e13359567fcbeac38e6b9c82834a684435352a1307abccf6f39a6b5a3",
-    "typeScriptVersion": "3.6"
+    "typesPublisherContentHash": "7cd86199c47cc6326c3466fa04e6a7ddc2670bd283713c0c6ef81cfe9e715118",
+    "typeScriptVersion": "3.7"
 }

node/path.d.ts

@@ -13,7 +13,7 @@ declare module 'path/win32' {
  * ```js
  * const path = require('path');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/path.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/path.js)
  */
 declare module 'path' {
     namespace path {

node/perf_hooks.d.ts

@@ -26,7 +26,7 @@
  *   performance.measure('A to B', 'A', 'B');
  * });
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/perf_hooks.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/perf_hooks.js)
  */
 declare module 'perf_hooks' {
     import { AsyncResource } from 'node:async_hooks';
@@ -375,7 +375,7 @@ declare module 'perf_hooks' {
          */
         disconnect(): void;
         /**
-         * Subscribes the `<PerformanceObserver>` instance to notifications of new `<PerformanceEntry>` instances identified either by `options.entryTypes`or `options.type`:
+         * Subscribes the `PerformanceObserver` instance to notifications of new `PerformanceEntry` instances identified either by `options.entryTypes`or `options.type`:
          *
          * ```js
          * const {
@@ -545,7 +545,7 @@ declare module 'perf_hooks' {
         figures?: number | undefined;
     }
     /**
-     * Returns a `<RecordableHistogram>`.
+     * Returns a `RecordableHistogram`.
      * @since v15.9.0
      */
     function createHistogram(options?: CreateHistogramOptions): RecordableHistogram;

node/punycode.d.ts

@@ -24,7 +24,7 @@
  * made available to developers as a convenience. Fixes or other modifications to
  * the module must be directed to the [Punycode.js](https://github.com/bestiejs/punycode.js) project.
  * @deprecated Since v7.0.0 - Deprecated
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/punycode.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/punycode.js)
  */
 declare module 'punycode' {
     /**

node/querystring.d.ts

@@ -7,9 +7,9 @@
  * ```
  *
  * The `querystring` API is considered Legacy. While it is still maintained,
- * new code should use the `<URLSearchParams>` API instead.
+ * new code should use the `URLSearchParams` API instead.
  * @deprecated Legacy
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/querystring.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/querystring.js)
  */
 declare module 'querystring' {
     interface StringifyOptions {

node/readline.d.ts

@@ -26,7 +26,7 @@
  *
  * Once this code is invoked, the Node.js application will not terminate until the`readline.Interface` is closed because the interface waits for data to be
  * received on the `input` stream.
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/readline.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/readline.js)
  */
 declare module 'readline' {
     import { Abortable, EventEmitter } from 'node:events';

node/repl.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const repl = require('repl');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/repl.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/repl.js)
  */
 declare module 'repl' {
     import { Interface, Completer, AsyncCompleter } from 'node:readline';

node/stream/web.d.ts

@@ -1,7 +1,6 @@
 declare module 'stream/web' {
     // stub module, pending copy&paste from .d.ts or manual impl
 }
-
 declare module 'node:stream/web' {
     export * from 'stream/web';
 }

node/stream.d.ts

@@ -14,7 +14,7 @@
  *
  * The `stream` module is useful for creating new types of stream instances. It is
  * usually not necessary to use the `stream` module to consume streams.
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/stream.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/stream.js)
  */
 declare module 'stream' {
     import { EventEmitter, Abortable } from 'node:events';
@@ -1007,7 +1007,7 @@ declare module 'stream' {
          * ```
          *
          * The `pipeline` API provides a promise version, which can also
-         * receive an options argument as the last parameter with a`signal` `<AbortSignal>` property. When the signal is aborted,`destroy` will be called on the underlying pipeline, with
+         * receive an options argument as the last parameter with a`signal` `AbortSignal` property. When the signal is aborted,`destroy` will be called on the underlying pipeline, with
          * an`AbortError`.
          *
          * ```js