@types/node 15.6.1 → 15.12.1

node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Node.js (http://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Tue, 25 May 2021 00:01:37 GMT
+ * Last updated: Fri, 04 Jun 2021 16:31:37 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `Buffer`, `__dirname`, `__filename`, `clearImmediate`, `clearInterval`, `clearTimeout`, `console`, `exports`, `global`, `module`, `process`, `queueMicrotask`, `require`, `setImmediate`, `setInterval`, `setTimeout`
 

node/buffer.d.ts

@@ -1,4 +1,6 @@
 declare module 'buffer' {
+    import { BinaryLike } from 'crypto';
+
     export const INSPECT_MAX_BYTES: number;
     export const kMaxLength: number;
     export const kStringMaxLength: number;
@@ -19,4 +21,64 @@ declare module 'buffer' {
     };
 
     export { BuffType as Buffer };
+
+    /**
+     * @experimental
+     */
+    export interface BlobOptions {
+        /**
+         * @default 'utf8'
+         */
+        encoding?: BufferEncoding;
+
+        /**
+         * The Blob content-type. The intent is for `type` to convey
+         * the MIME media type of the data, however no validation of the type format
+         * is performed.
+         */
+        type?: string;
+    }
+
+    /**
+     * @experimental
+     */
+    export class Blob {
+        /**
+         * Returns a promise that fulfills with an {ArrayBuffer} containing a copy of the `Blob` data.
+         */
+        readonly size: number;
+
+        /**
+         * The content-type of the `Blob`.
+         */
+        readonly type: string;
+
+        /**
+         * Creates a new `Blob` object containing a concatenation of the given sources.
+         *
+         * {ArrayBuffer}, {TypedArray}, {DataView}, and {Buffer} sources are copied into
+         * the 'Blob' and can therefore be safely modified after the 'Blob' is created.
+         *
+         * String sources are also copied into the `Blob`.
+         */
+        constructor(sources: Array<(BinaryLike | Blob)>, options?: BlobOptions);
+
+        arrayBuffer(): Promise<ArrayBuffer>;
+
+        /**
+         * @param start The starting index.
+         * @param end The ending index.
+         * @param type The content-type for the new `Blob`
+         */
+        slice(start?: number, end?: number, type?: string): Blob;
+
+        /**
+         * Returns a promise that resolves the contents of the `Blob` decoded as a UTF-8 string.
+         */
+        text(): Promise<string>;
+    }
+}
+
+declare module 'node:buffer' {
+    export * from 'buffer';
 }

node/child_process.d.ts

@@ -4,7 +4,7 @@ declare module 'child_process' {
     import * as net from 'net';
     import { Writable, Readable, Stream, Pipe } from 'stream';
 
-    type Serializable = string | object | number | boolean;
+    type Serializable = string | object | number | boolean | bigint;
     type SendHandle = net.Socket | net.Server;
 
     interface ChildProcess extends EventEmitter {
@@ -20,7 +20,7 @@ declare module 'child_process' {
             Readable | Writable | null | undefined // extra
         ];
         readonly killed: boolean;
-        readonly pid: number;
+        readonly pid?: number;
         readonly connected: boolean;
         readonly exitCode: number | null;
         readonly signalCode: NodeJS.Signals | null;
@@ -135,12 +135,18 @@ declare module 'child_process' {
 
     type SerializationType = 'json' | 'advanced';
 
-    interface MessagingOptions {
+    interface MessagingOptions extends Abortable {
         /**
          * Specify the kind of serialization used for sending messages between processes.
          * @default 'json'
          */
         serialization?: SerializationType;
+
+        /**
+         * The signal value to be used when the spawned process will be killed by the abort signal.
+         * @default 'SIGTERM'
+         */
+        killSignal?: NodeJS.Signals | number;
     }
 
     interface ProcessEnvOptions {
@@ -451,7 +457,6 @@ declare module 'child_process' {
 
     interface SpawnSyncOptions extends CommonSpawnOptions {
         input?: string | NodeJS.ArrayBufferView;
-        killSignal?: NodeJS.Signals | number;
         maxBuffer?: number;
         encoding?: BufferEncoding | 'buffer' | null;
     }

node/crypto.d.ts

@@ -197,6 +197,45 @@ declare module 'crypto' {
         passphrase?: string | Buffer;
     }
 
+    interface JwkKeyExportOptions {
+        format: 'jwk';
+    }
+
+    interface JsonWebKey {
+        crv?: string;
+        d?: string;
+        dp?: string;
+        dq?: string;
+        e?: string;
+        k?: string;
+        kty?: string;
+        n?: string;
+        p?: string;
+        q?: string;
+        qi?: string;
+        x?: string;
+        y?: string;
+    }
+
+    interface AsymmetricKeyDetails {
+        /**
+         * Key size in bits (RSA, DSA).
+         */
+        modulusLength?: number;
+        /**
+         * Public exponent (RSA).
+         */
+        publicExponent?: bigint;
+        /**
+         * Size of q in bits (DSA).
+         */
+        divisorLength?: number;
+        /**
+         * Name of the curve (EC).
+         */
+        namedCurve?: string;
+    }
+
     class KeyObject {
         private constructor();
         asymmetricKeyType?: KeyType;
@@ -205,6 +244,13 @@ declare module 'crypto' {
          * bytes. This property is `undefined` for symmetric keys.
          */
         asymmetricKeySize?: number;
+        /**
+         * This property exists only on asymmetric keys. Depending on the type of the key,
+         * this object contains information about the key. None of the information obtained
+         * through this property can be used to uniquely identify a key or to compromise the
+         * security of the key.
+         */
+        asymmetricKeyDetails?: AsymmetricKeyDetails;
         export(options: KeyExportOptions<'pem'>): string | Buffer;
         export(options?: KeyExportOptions<'der'>): Buffer;
         symmetricKeySize?: number;
@@ -1163,22 +1209,28 @@ declare module 'crypto' {
      * algorithm. If `algorithm` is `null` or `undefined`, then the algorithm is
      * dependent upon the key type (especially Ed25519 and Ed448).
      *
-     * If `key` is not a [`KeyObject`][], this function behaves as if `key` had been
-     * passed to [`crypto.createPrivateKey()`][].
+     * If `key` is not a `KeyObject`, this function behaves as if `key` had been
+     * passed to `crypto.createPrivateKey().
      */
     function sign(
         algorithm: string | null | undefined,
         data: NodeJS.ArrayBufferView,
         key: KeyLike | SignKeyObjectInput | SignPrivateKeyInput,
     ): Buffer;
+    function sign(
+        algorithm: string | null | undefined,
+        data: NodeJS.ArrayBufferView,
+        key: KeyLike | SignKeyObjectInput | SignPrivateKeyInput,
+        callback: (error: Error | null, data: Buffer) => void
+    ): void;
 
     /**
      * Calculates and returns the signature for `data` using the given private key and
      * algorithm. If `algorithm` is `null` or `undefined`, then the algorithm is
      * dependent upon the key type (especially Ed25519 and Ed448).
      *
-     * If `key` is not a [`KeyObject`][], this function behaves as if `key` had been
-     * passed to [`crypto.createPublicKey()`][].
+     * If `key` is not a `KeyObject`, this function behaves as if `key` had been
+     * passed to `crypto.createPublicKey()`.
      */
     function verify(
         algorithm: string | null | undefined,
@@ -1186,6 +1238,13 @@ declare module 'crypto' {
         key: KeyLike | VerifyKeyObjectInput | VerifyPublicKeyInput,
         signature: NodeJS.ArrayBufferView,
     ): boolean;
+    function verify(
+        algorithm: string | null | undefined,
+        data: NodeJS.ArrayBufferView,
+        key: KeyLike | VerifyKeyObjectInput | VerifyPublicKeyInput,
+        signature: NodeJS.ArrayBufferView,
+        callback: (error: Error | null, result: boolean) => void
+    ): void;
 
     /**
      * Computes the Diffie-Hellman secret based on a privateKey and a publicKey.
@@ -1254,7 +1313,7 @@ declare module 'crypto' {
      *
      * The supplied `callback` function is called with two arguments: `err` and `derivedKey`.
      * If an errors occurs while deriving the key, `err` will be set; otherwise `err` will be `null`.
-     * The successfully generated `derivedKey` will be passed to the callback as an [`ArrayBuffer`][].
+     * The successfully generated `derivedKey` will be passed to the callback as an `ArrayBuffer`.
      * An error will be thrown if any of the input aguments specify invalid values or types.
      */
     function hkdf(digest: string, key: BinaryLike | KeyObject, salt: BinaryLike, info: BinaryLike, keylen: number, callback: (err: Error | null, derivedKey: ArrayBuffer) => any): void;
@@ -1263,7 +1322,7 @@ declare module 'crypto' {
      * Provides a synchronous HKDF key derivation function as defined in RFC 5869.
      * The given `key`, `salt` and `info` are used with the `digest` to derive a key of `keylen` bytes.
      *
-     * The successfully generated `derivedKey` will be returned as an [`ArrayBuffer`][].
+     * The successfully generated `derivedKey` will be returned as an `ArrayBuffer`.
      * An error will be thrown if any of the input aguments specify invalid values or types,
      * or if the derived key cannot be generated.
      */
@@ -1372,6 +1431,16 @@ declare module 'crypto' {
          */
         readonly keyUsage: string[];
 
+        /**
+         * The issuer identification included in this certificate.
+         */
+        readonly issuer: string;
+
+        /**
+         * The issuer certificate or `undefined` if the issuer certificate is not available.
+         */
+        readonly issuerCertificate?: X509Certificate;
+
         /**
          * The public key for this certificate.
          */
@@ -1438,7 +1507,7 @@ declare module 'crypto' {
         toJSON(): string;
 
         /**
-         * Returns information about this certificate using the legacy [certificate object][] encoding.
+         * Returns information about this certificate using the legacy certificate object encoding.
          */
         toLegacyObject(): PeerCertificate;
 
@@ -1453,4 +1522,57 @@ declare module 'crypto' {
          */
         verify(publicKey: KeyObject): boolean;
     }
+
+    type LargeNumberLike = NodeJS.ArrayBufferView | SharedArrayBuffer | ArrayBuffer | bigint;
+
+    interface GeneratePrimeOptions {
+        add?: LargeNumberLike;
+        rem?: LargeNumberLike;
+        /**
+         * @default false
+         */
+        safe?: boolean;
+        bigint?: boolean;
+    }
+
+    interface GeneratePrimeOptionsBigInt extends GeneratePrimeOptions {
+        bigint: true;
+    }
+
+    interface GeneratePrimeOptionsArrayBuffer extends GeneratePrimeOptions {
+        bigint?: false;
+    }
+
+    function generatePrime(size: number, callback: (err: Error | null, prime: ArrayBuffer) => void): void;
+    function generatePrime(size: number, options: GeneratePrimeOptionsBigInt, callback: (err: Error | null, prime: bigint) => void): void;
+    function generatePrime(size: number, options: GeneratePrimeOptionsArrayBuffer, callback: (err: Error | null, prime: ArrayBuffer) => void): void;
+    function generatePrime(size: number, options: GeneratePrimeOptions, callback: (err: Error | null, prime: ArrayBuffer | bigint) => void): void;
+
+    function generatePrimeSync(size: number): ArrayBuffer;
+    function generatePrimeSync(size: number, options: GeneratePrimeOptionsBigInt): bigint;
+    function generatePrimeSync(size: number, options: GeneratePrimeOptionsArrayBuffer): ArrayBuffer;
+    function generatePrimeSync(size: number, options: GeneratePrimeOptions): ArrayBuffer | bigint;
+
+    interface CheckPrimeOptions {
+        /**
+         * The number of Miller-Rabin probabilistic primality iterations to perform.
+         * When the value is 0 (zero), a number of checks is used that yields a false positive rate of at most 2-64 for random input.
+         * Care must be used when selecting a number of checks.
+         * Refer to the OpenSSL documentation for the BN_is_prime_ex function nchecks options for more details.
+         *
+         * @default 0
+         */
+        checks?: number;
+    }
+
+    /**
+     * Checks the primality of the candidate.
+     */
+    function checkPrime(value: LargeNumberLike, callback: (err: Error | null, result: boolean) => void): void;
+    function checkPrime(value: LargeNumberLike, options: CheckPrimeOptions, callback: (err: Error | null, result: boolean) => void): void;
+
+    /**
+     * Checks the primality of the candidate.
+     */
+    function checkPrimeSync(value: LargeNumberLike, options?: CheckPrimeOptions): boolean;
 }

node/dgram.d.ts

@@ -1,7 +1,7 @@
 declare module 'dgram' {
     import { AddressInfo } from 'net';
     import * as dns from 'dns';
-    import EventEmitter = require('events');
+    import { EventEmitter, Abortable } from 'events';
 
     interface RemoteInfo {
         address: string;
@@ -19,7 +19,7 @@ declare module 'dgram' {
 
     type SocketType = "udp4" | "udp6";
 
-    interface SocketOptions {
+    interface SocketOptions extends Abortable {
         type: SocketType;
         reuseAddr?: boolean;
         /**

node/fs/promises.d.ts

@@ -17,6 +17,7 @@ declare module 'fs/promises' {
         BufferEncodingOption,
         OpenMode,
         Mode,
+        WatchOptions,
     } from 'fs';
 
     interface FileHandle {
@@ -555,4 +556,37 @@ declare module 'fs/promises' {
     function readFile(path: PathLike | FileHandle, options?: BaseEncodingOptions & Abortable & { flag?: OpenMode } | BufferEncoding | null): Promise<string | Buffer>;
 
     function opendir(path: string, options?: OpenDirOptions): Promise<Dir>;
+
+    /**
+     * 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 & { encoding: "buffer" } | "buffer"): AsyncIterable<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<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 | string): AsyncIterable<string> | AsyncIterable<Buffer>;
 }

node/fs.d.ts

@@ -276,9 +276,7 @@ declare module 'fs' {
     /**
      * Asynchronous rename(2) - Change the name or location of a file or directory.
      * @param oldPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * @param newPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function rename(oldPath: PathLike, newPath: PathLike, callback: NoParamCallback): void;
 
@@ -297,9 +295,7 @@ declare module 'fs' {
     /**
      * Synchronous rename(2) - Change the name or location of a file or directory.
      * @param oldPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * @param newPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function renameSync(oldPath: PathLike, newPath: PathLike): void;
 
@@ -313,7 +309,6 @@ declare module 'fs' {
     /**
      * Asynchronous truncate(2) - Truncate a file to a specified length.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function truncate(path: PathLike, callback: NoParamCallback): void;
 
@@ -1242,7 +1237,7 @@ declare module 'fs' {
      * Asynchronous close(2) - close a file descriptor.
      * @param fd A file descriptor.
      */
-    export function close(fd: number, callback: NoParamCallback): void;
+    export function close(fd: number, callback?: NoParamCallback): void;
 
     // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
     export namespace close {
@@ -1487,6 +1482,8 @@ declare module 'fs' {
      */
     export function writeSync(fd: number, string: string, position?: number | null, encoding?: BufferEncoding | null): number;
 
+    export type ReadPosition = number | bigint;
+
     /**
      * Asynchronously reads data from the file referenced by the supplied file descriptor.
      * @param fd A file descriptor.
@@ -1500,7 +1497,7 @@ declare module 'fs' {
         buffer: TBuffer,
         offset: number,
         length: number,
-        position: number | null,
+        position: ReadPosition | null,
         callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: TBuffer) => void,
     ): void;
 
@@ -1534,7 +1531,7 @@ declare module 'fs' {
         /**
          * @default null
          */
-        position?: number | null;
+        position?: ReadPosition | null;
     }
 
     /**
@@ -1545,7 +1542,7 @@ declare module 'fs' {
      * @param length The number of bytes to read.
      * @param position The offset from the beginning of the file from which data should be read. If `null`, data will be read from the current position.
      */
-    export function readSync(fd: number, buffer: NodeJS.ArrayBufferView, offset: number, length: number, position: number | null): number;
+    export function readSync(fd: number, buffer: NodeJS.ArrayBufferView, offset: number, length: number, position: ReadPosition | null): number;
 
     /**
      * Similar to the above `fs.readSync` function, this version takes an optional `options` object.
@@ -1569,7 +1566,6 @@ declare module 'fs' {
     /**
      * 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.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1583,7 +1579,6 @@ declare module 'fs' {
     /**
      * 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.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1637,7 +1632,6 @@ declare module 'fs' {
     /**
      * Synchronously 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.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options An object that may contain an optional flag. If a flag is not provided, it defaults to `'r'`.
      */
@@ -1646,7 +1640,6 @@ declare module 'fs' {
     /**
      * Synchronously 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.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1656,7 +1649,6 @@ declare module 'fs' {
     /**
      * Synchronously 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.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1668,7 +1660,6 @@ declare module 'fs' {
     /**
      * Asynchronously writes data to a file, replacing the file if it already exists.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1682,7 +1673,6 @@ declare module 'fs' {
     /**
      * Asynchronously writes data to a file, replacing the file if it already exists.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      */
@@ -1708,7 +1698,6 @@ declare module 'fs' {
     /**
      * Synchronously writes data to a file, replacing the file if it already exists.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1722,7 +1711,6 @@ declare module 'fs' {
     /**
      * Asynchronously append data to a file, creating the file if it does not exist.
      * @param file A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1736,7 +1724,6 @@ declare module 'fs' {
     /**
      * Asynchronously append data to a file, creating the file if it does not exist.
      * @param file A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      */
@@ -1762,7 +1749,6 @@ declare module 'fs' {
     /**
      * Synchronously append data to a file, creating the file if it does not exist.
      * @param file A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1781,36 +1767,36 @@ declare module 'fs' {
     /**
      * Watch for changes on `filename`. The callback `listener` will be called each time the file is accessed.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function watchFile(filename: PathLike, listener: (curr: Stats, prev: Stats) => void): void;
 
     /**
      * Stop watching for changes on `filename`.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function unwatchFile(filename: PathLike, listener?: (curr: Stats, prev: Stats) => void): void;
 
+    export interface WatchOptions extends Abortable {
+        encoding?: BufferEncoding | "buffer";
+        persistent?: boolean;
+        recursive?: boolean;
+    }
+
+    export type WatchListener<T> = (event: "rename" | "change", filename: T) => void;
+
     /**
      * 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.
-     * URL support is _experimental_.
      * @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.
      */
-    export function watch(
-        filename: PathLike,
-        options: { encoding?: BufferEncoding | null, persistent?: boolean, recursive?: boolean } | BufferEncoding | undefined | null,
-        listener?: (event: "rename" | "change", filename: string) => void,
-    ): FSWatcher;
+    export function watch(filename: PathLike, options: WatchOptions & { encoding: "buffer" } | "buffer", listener?: WatchListener<Buffer>): FSWatcher;
 
     /**
      * 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.
-     * URL support is _experimental_.
      * @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.
@@ -1818,37 +1804,30 @@ declare module 'fs' {
      */
     export function watch(
         filename: PathLike,
-        options: { encoding: "buffer", persistent?: boolean, recursive?: boolean; } | "buffer",
-        listener?: (event: "rename" | "change", filename: Buffer) => void
+        options?: WatchOptions | BufferEncoding | null,
+        listener?: WatchListener<string>,
     ): FSWatcher;
 
     /**
      * 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.
-     * URL support is _experimental_.
      * @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.
      */
-    export function watch(
-        filename: PathLike,
-        options: { encoding?: BufferEncoding | null, persistent?: boolean, recursive?: boolean } | string | null,
-        listener?: (event: "rename" | "change", filename: string | Buffer) => void,
-    ): FSWatcher;
+    export function watch(filename: PathLike, options: WatchOptions | string, listener?: WatchListener<string | Buffer>): FSWatcher;
 
     /**
      * 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.
-     * URL support is _experimental_.
      */
-    export function watch(filename: PathLike, listener?: (event: "rename" | "change", filename: string) => any): FSWatcher;
+    export function watch(filename: PathLike, listener?: WatchListener<string>): FSWatcher;
 
     /**
      * Asynchronously tests whether or not the given path exists by checking with the file system.
      * @deprecated since v1.0.0 Use `fs.stat()` or `fs.access()` instead
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function exists(path: PathLike, callback: (exists: boolean) => void): void;
 
@@ -1864,7 +1843,6 @@ declare module 'fs' {
     /**
      * Synchronously tests whether or not the given path exists by checking with the file system.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function existsSync(path: PathLike): boolean;
 
@@ -2034,14 +2012,12 @@ declare module 'fs' {
     /**
      * Asynchronously tests a user's permissions for the file specified by path.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function access(path: PathLike, mode: number | undefined, callback: NoParamCallback): void;
 
     /**
      * Asynchronously tests a user's permissions for the file specified by path.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function access(path: PathLike, callback: NoParamCallback): void;
 
@@ -2058,7 +2034,6 @@ declare module 'fs' {
     /**
      * Synchronously tests a user's permissions for the file specified by path.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function accessSync(path: PathLike, mode?: number): void;
 
@@ -2083,14 +2058,12 @@ declare module 'fs' {
     /**
      * Returns a new `ReadStream` object.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function createReadStream(path: PathLike, options?: string | ReadStreamOptions): ReadStream;
 
     /**
      * Returns a new `WriteStream` object.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function createWriteStream(path: PathLike, options?: string | StreamOptions): WriteStream;
 

node/globals.d.ts

@@ -37,9 +37,9 @@ interface ImportMeta {
  ------------------------------------------------*/
 
 // For backwards compability
-interface NodeRequire extends NodeJS.Require {}
-interface RequireResolve extends NodeJS.RequireResolve {}
-interface NodeModule extends NodeJS.Module {}
+interface NodeRequire extends NodeJS.Require { }
+interface RequireResolve extends NodeJS.RequireResolve { }
+interface NodeModule extends NodeJS.Module { }
 
 declare var process: NodeJS.Process;
 declare var console: Console;
@@ -318,6 +318,7 @@ interface AbortController {
     /**
      * Returns the AbortSignal object associated with this object.
      */
+
     readonly signal: AbortSignal;
     /**
      * Invoking this method will set this object's AbortSignal's aborted flag and signal to any observers that the associated activity is to be aborted.
@@ -341,6 +342,7 @@ declare var AbortController: {
 declare var AbortSignal: {
     prototype: AbortSignal;
     new(): AbortSignal;
+    // TODO: Add abort() static
 };
 //#endregion borrowed
 

node/http.d.ts

@@ -107,7 +107,7 @@ declare module 'http' {
         ServerResponse?: typeof ServerResponse;
         /**
          * Optionally overrides the value of
-         * [`--max-http-header-size`][] for requests received by this server, i.e.
+         * `--max-http-header-size` for requests received by this server, i.e.
          * the maximum length of request headers in bytes.
          * @default 8192
          */
@@ -156,7 +156,8 @@ declare module 'http' {
 
     // https://github.com/nodejs/node/blob/master/lib/_http_outgoing.js
     class OutgoingMessage extends stream.Writable {
-        upgrading: boolean;
+        readonly req: IncomingMessage;
+
         chunkedEncoding: boolean;
         shouldKeepAlive: boolean;
         useChunkedEncodingByDefault: boolean;
@@ -165,12 +166,12 @@ declare module 'http' {
          * @deprecated Use `writableEnded` instead.
          */
         finished: boolean;
-        headersSent: boolean;
+        readonly headersSent: boolean;
         /**
          * @deprecated Use `socket` instead.
          */
-        connection: Socket | null;
-        socket: Socket | null;
+        readonly connection: Socket | null;
+        readonly socket: Socket | null;
 
         constructor();
 
@@ -420,7 +421,14 @@ declare module 'http' {
 
     /**
      * Read-only property specifying the maximum allowed size of HTTP headers in bytes.
-     * Defaults to 16KB. Configurable using the [`--max-http-header-size`][] CLI option.
+     * Defaults to 16KB. Configurable using the `--max-http-header-size` CLI option.
      */
     const maxHeaderSize: number;
+
+    /**
+     *
+     * This utility function converts a URL object into an ordinary options object as
+     * expected by the `http.request()` and `https.request()` APIs.
+     */
+    function urlToHttpOptions(url: URL): ClientRequestArgs;
 }

node/http2.d.ts

@@ -438,6 +438,13 @@ declare module 'http2' {
         paddingStrategy?: number;
         peerMaxConcurrentStreams?: number;
         settings?: Settings;
+        /**
+         * Specifies a timeout in milliseconds that
+         * a server should wait when an [`'unknownProtocol'`][] is emitted. If the
+         * socket has not been destroyed by that time the server will destroy it.
+         * @default 100000
+         */
+        unknownProtocolTimeout?: number;
 
         selectPadding?(frameLen: number, maxFrameLen: number): number;
         createConnection?(authority: url.URL, option: SessionOptions): stream.Duplex;

node/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for non-npm package Node.js 15.6
+// Type definitions for non-npm package Node.js 15.12
 // Project: http://nodejs.org/
 // Definitions by: Microsoft TypeScript <https://github.com/Microsoft>
 //                 DefinitelyTyped <https://github.com/DefinitelyTyped>
@@ -50,9 +50,9 @@
 
 // NOTE: TypeScript version-specific augmentations can be found in the following paths:
 //          - ~/base.d.ts         - Shared definitions common to all TypeScript versions
-//          - ~/index.d.ts        - Definitions specific to TypeScript 2.8
-//          - ~/ts3.5/index.d.ts  - Definitions specific to TypeScript 3.5
+//          - ~/index.d.ts        - Definitions specific to TypeScript 3.7
+//          - ~/ts3.6/index.d.ts  - Definitions specific to TypeScript 3.6
 
-// NOTE: Augmentations for TypeScript 3.5 and later should use individual files for overrides
-//       within the respective ~/ts3.5 (or later) folder. However, this is disallowed for versions
-//       prior to TypeScript 3.5, so the older definitions will be found here.
+// NOTE: Augmentations for TypeScript 3.6 and later should use individual files for overrides
+//       within the respective ~/ts3.6 (or later) folder. However, this is disallowed for versions
+//       prior to TypeScript 3.6, so the older definitions will be found here.

node/os.d.ts

@@ -212,7 +212,7 @@ declare module 'os' {
     /**
      * Returns a string identifying the kernel version.
      * On POSIX systems, the operating system release is determined by calling
-     * [uname(3)][]. On Windows, `pRtlGetVersion` is used, and if it is not available,
+     * uname(3). On Windows, `pRtlGetVersion` is used, and if it is not available,
      * `GetVersionExW()` will be used. See
      * https://en.wikipedia.org/wiki/Uname#Examples for more information.
      */

node/package.json

@@ -1,7 +1,8 @@
 {
     "name": "@types/node",
-    "version": "15.6.1",
+    "version": "15.12.1",
     "description": "TypeScript definitions for Node.js",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
     "contributors": [
         {
@@ -226,6 +227,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "f8f8a539a80cc272f918927a96e6cef5cc69df79ec257791f25651eb317ea354",
-    "typeScriptVersion": "3.5"
+    "typesPublisherContentHash": "c5eebcafad4271376ee5a2d516756464cef353232ac06db91239887b14f7f29a",
+    "typeScriptVersion": "3.6"
 }

node/perf_hooks.d.ts

@@ -3,7 +3,8 @@ declare module 'perf_hooks' {
 
     type EntryType = 'node' | 'mark' | 'measure' | 'gc' | 'function' | 'http2' | 'http';
 
-    interface PerformanceEntry {
+    class PerformanceEntry {
+        protected constructor();
         /**
          * The total number of milliseconds elapsed for this entry.
          * This value will not be meaningful for all Performance Entry types.
@@ -41,7 +42,7 @@ declare module 'perf_hooks' {
         readonly flags?: number;
     }
 
-    interface PerformanceNodeTiming extends PerformanceEntry {
+    class PerformanceNodeTiming extends PerformanceEntry {
         /**
          * The high resolution millisecond timestamp at which the Node.js process completed bootstrap.
          */
@@ -88,7 +89,10 @@ declare module 'perf_hooks' {
      * @param util1 The result of a previous call to eventLoopUtilization()
      * @param util2 The result of a previous call to eventLoopUtilization() prior to util1
      */
-    type EventLoopUtilityFunction = (util1?: EventLoopUtilization, util2?: EventLoopUtilization) => EventLoopUtilization;
+    type EventLoopUtilityFunction = (
+        util1?: EventLoopUtilization,
+        util2?: EventLoopUtilization,
+    ) => EventLoopUtilization;
 
     interface Performance {
         /**
@@ -122,7 +126,7 @@ declare module 'perf_hooks' {
          * @param startMark
          * @param endMark
          */
-        measure(name: string, startMark: string, endMark: string): void;
+        measure(name: string, startMark?: string, endMark?: string): void;
 
         /**
          * An instance of the PerformanceNodeTiming class that provides performance metrics for specific Node.js operational milestones.
@@ -218,15 +222,36 @@ declare module 'perf_hooks' {
         resolution?: number;
     }
 
-    interface EventLoopDelayMonitor {
+    interface Histogram {
         /**
-         * Enables the event loop delay sample timer. Returns `true` if the timer was started, `false` if it was already started.
+         * A `Map` object detailing the accumulated percentile distribution.
          */
-        enable(): boolean;
+        readonly percentiles: Map<number, number>;
+
         /**
-         * Disables the event loop delay sample timer. Returns `true` if the timer was stopped, `false` if it was already stopped.
+         * The number of times the event loop delay exceeded the maximum 1 hour eventloop delay threshold.
          */
-        disable(): boolean;
+        readonly exceeds: number;
+
+        /**
+         * The minimum recorded event loop delay.
+         */
+        readonly min: number;
+
+        /**
+         * The maximum recorded event loop delay.
+         */
+        readonly max: number;
+
+        /**
+         * The mean of the recorded event loop delays.
+         */
+        readonly mean: number;
+
+        /**
+         * The standard deviation of the recorded event loop delays.
+         */
+        readonly stddev: number;
 
         /**
          * Resets the collected histogram data.
@@ -238,37 +263,48 @@ declare module 'perf_hooks' {
          * @param percentile A percentile value between 1 and 100.
          */
         percentile(percentile: number): number;
+    }
 
+    interface IntervalHistogram extends Histogram {
         /**
-         * A `Map` object detailing the accumulated percentile distribution.
+         * Enables the event loop delay sample timer. Returns `true` if the timer was started, `false` if it was already started.
          */
-        readonly percentiles: Map<number, number>;
-
+        enable(): boolean;
         /**
-         * The number of times the event loop delay exceeded the maximum 1 hour eventloop delay threshold.
+         * Disables the event loop delay sample timer. Returns `true` if the timer was stopped, `false` if it was already stopped.
          */
-        readonly exceeds: number;
+        disable(): boolean;
+    }
+
+    interface RecordableHistogram extends Histogram {
+        record(val: number | bigint): void;
 
         /**
-         * The minimum recorded event loop delay.
+         * Calculates the amount of time (in nanoseconds) that has passed since the previous call to recordDelta() and records that amount in the histogram.
          */
-        readonly min: number;
+        recordDelta(): void;
+    }
+
+    function monitorEventLoopDelay(options?: EventLoopMonitorOptions): IntervalHistogram;
 
+    interface CreateHistogramOptions {
         /**
-         * The maximum recorded event loop delay.
+         * The minimum recordable value. Must be an integer value greater than 0.
+         * @default 1
          */
-        readonly max: number;
+        min?: number | bigint;
 
         /**
-         * The mean of the recorded event loop delays.
+         * The maximum recordable value. Must be an integer value greater than min.
+         * @default Number.MAX_SAFE_INTEGER
          */
-        readonly mean: number;
-
+        max?: number | bigint;
         /**
-         * The standard deviation of the recorded event loop delays.
+         * The number of accuracy digits. Must be a number between 1 and 5.
+         * @default 3
          */
-        readonly stddev: number;
+        figures?: number;
     }
 
-    function monitorEventLoopDelay(options?: EventLoopMonitorOptions): EventLoopDelayMonitor;
+    function createHistogram(options?: CreateHistogramOptions): RecordableHistogram;
 }

node/process.d.ts

@@ -336,7 +336,7 @@ declare module 'process' {
 
                 /**
                  * The `process.allowedNodeEnvironmentFlags` property is a special,
-                 * read-only `Set` of flags allowable within the [`NODE_OPTIONS`][]
+                 * read-only `Set` of flags allowable within the `NODE_OPTIONS`
                  * environment variable.
                  */
                 allowedNodeEnvironmentFlags: ReadonlySet<string>;

node/readline.d.ts

@@ -1,5 +1,5 @@
 declare module 'readline' {
-    import EventEmitter = require('events');
+    import { Abortable, EventEmitter } from 'events';
 
     interface Key {
         sequence?: string;
@@ -42,6 +42,7 @@ declare module 'readline' {
         setPrompt(prompt: string): void;
         prompt(preserveCursor?: boolean): void;
         question(query: string, callback: (answer: string) => void): void;
+        question(query: string, options: Abortable, callback: (answer: string) => void): void;
         pause(): this;
         resume(): this;
         close(): void;
@@ -63,8 +64,8 @@ declare module 'readline' {
          * 5. SIGCONT
          * 6. SIGINT
          * 7. SIGTSTP
+         * 8. history
          */
-
         addListener(event: string, listener: (...args: any[]) => void): this;
         addListener(event: "close", listener: () => void): this;
         addListener(event: "line", listener: (input: string) => void): this;
@@ -73,6 +74,7 @@ declare module 'readline' {
         addListener(event: "SIGCONT", listener: () => void): this;
         addListener(event: "SIGINT", listener: () => void): this;
         addListener(event: "SIGTSTP", listener: () => void): this;
+        addListener(event: "history", listener: (history: string[]) => void): this;
 
         emit(event: string | symbol, ...args: any[]): boolean;
         emit(event: "close"): boolean;
@@ -82,6 +84,7 @@ declare module 'readline' {
         emit(event: "SIGCONT"): boolean;
         emit(event: "SIGINT"): boolean;
         emit(event: "SIGTSTP"): boolean;
+        emit(event: "history", history: string[]): boolean;
 
         on(event: string, listener: (...args: any[]) => void): this;
         on(event: "close", listener: () => void): this;
@@ -91,6 +94,7 @@ declare module 'readline' {
         on(event: "SIGCONT", listener: () => void): this;
         on(event: "SIGINT", listener: () => void): this;
         on(event: "SIGTSTP", listener: () => void): this;
+        on(event: "history", listener: (history: string[]) => void): this;
 
         once(event: string, listener: (...args: any[]) => void): this;
         once(event: "close", listener: () => void): this;
@@ -100,6 +104,7 @@ declare module 'readline' {
         once(event: "SIGCONT", listener: () => void): this;
         once(event: "SIGINT", listener: () => void): this;
         once(event: "SIGTSTP", listener: () => void): this;
+        once(event: "history", listener: (history: string[]) => void): this;
 
         prependListener(event: string, listener: (...args: any[]) => void): this;
         prependListener(event: "close", listener: () => void): this;
@@ -109,6 +114,7 @@ declare module 'readline' {
         prependListener(event: "SIGCONT", listener: () => void): this;
         prependListener(event: "SIGINT", listener: () => void): this;
         prependListener(event: "SIGTSTP", listener: () => void): this;
+        prependListener(event: "history", listener: (history: string[]) => void): this;
 
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         prependOnceListener(event: "close", listener: () => void): this;
@@ -118,6 +124,8 @@ declare module 'readline' {
         prependOnceListener(event: "SIGCONT", listener: () => void): this;
         prependOnceListener(event: "SIGINT", listener: () => void): this;
         prependOnceListener(event: "SIGTSTP", listener: () => void): this;
+        prependOnceListener(event: "history", listener: (history: string[]) => void): this;
+
         [Symbol.asyncIterator](): AsyncIterableIterator<string>;
     }
 
@@ -133,9 +141,22 @@ declare module 'readline' {
         output?: NodeJS.WritableStream;
         completer?: Completer | AsyncCompleter;
         terminal?: boolean;
+        /**
+         *  Initial list of history lines. This option makes sense
+         * only if `terminal` is set to `true` by the user or by an internal `output`
+         * check, otherwise the history caching mechanism is not initialized at all.
+         * @default []
+         */
+        history?: string[];
         historySize?: number;
         prompt?: string;
         crlfDelay?: number;
+        /**
+         * If `true`, when a new input line added
+         * to the history list duplicates an older one, this removes the older line
+         * from the list.
+         * @default false
+         */
         removeHistoryDuplicates?: boolean;
         escapeCodeTimeout?: number;
         tabSize?: number;

node/stream.d.ts

@@ -301,7 +301,7 @@ declare module 'stream' {
          */
         function addAbortSignal<T extends Stream>(signal: AbortSignal, stream: T): T;
 
-        interface FinishedOptions {
+        interface FinishedOptions extends Abortable {
             error?: boolean;
             readable?: boolean;
             writable?: boolean;

node/timers/promises.d.ts

@@ -3,11 +3,19 @@ declare module 'timers/promises' {
 
     /**
      * Returns a promise that resolves after the specified delay in milliseconds.
+     * @param delay defaults to 1
      */
-    function setTimeout<T>(delay: number, value?: T, options?: TimerOptions): Promise<T>;
+    function setTimeout<T = void>(delay?: number, value?: T, options?: TimerOptions): Promise<T>;
 
     /**
      * Returns a promise that resolves in the next tick.
      */
-    function setImmediate<T>(value: T, options?: TimerOptions): Promise<T>;
+    function setImmediate<T = void>(value?: T, options?: TimerOptions): Promise<T>;
+
+    /**
+     *
+     * Returns an async iterator that generates values in an interval of delay ms.
+     * @param delay defaults to 1
+     */
+    function setInterval<T = void>(delay?: number, value?: T, options?: TimerOptions): AsyncIterable<T>;
 }

node/timers.d.ts

@@ -1,16 +1,13 @@
 declare module 'timers' {
-    interface TimerOptions {
+    import { Abortable } from 'events';
+
+    interface TimerOptions extends Abortable {
         /**
          * Set to `false` to indicate that the scheduled `Timeout`
          * should not require the Node.js event loop to remain active.
          * @default true
          */
         ref?: boolean;
-
-        /**
-         * An optional `AbortSignal` that can be used to cancel the scheduled `Timeout`.
-         */
-        signal?: AbortSignal;
     }
 
     function setTimeout(callback: (...args: any[]) => void, ms?: number, ...args: any[]): NodeJS.Timeout;

node/tls.d.ts

@@ -1,4 +1,5 @@
 declare module 'tls' {
+    import { X509Certificate } from 'crypto';
     import * as net from 'net';
 
     const CLIENT_RENEG_LIMIT: number;
@@ -295,6 +296,16 @@ declare module 'tls' {
          */
         enableTrace(): void;
 
+        /**
+         * If there is no peer certificate, or the socket has been destroyed, `undefined` will be returned.
+         */
+        getPeerX509Certificate(): X509Certificate | undefined;
+
+        /**
+         * If there is no local certificate, or the socket has been destroyed, `undefined` will be returned.
+         */
+        getX509Certificate(): X509Certificate | undefined;
+
         /**
          * @param length number of bytes to retrieve from keying material
          * @param label an application specific label, typically this will be a value from the

node/ts3.6/base.d.ts

@@ -3,8 +3,8 @@
 // NOTE: TypeScript version-specific augmentations can be found in the following paths:
 //          - ~/base.d.ts         - Shared definitions common to all TypeScript versions
 //          - ~/index.d.ts        - Definitions specific to TypeScript 3.7 and above
-//          - ~/ts3.5/base.d.ts   - Definitions specific to TypeScript 3.6 and earlier
-//          - ~/ts3.5/index.d.ts  - Definitions specific to TypeScript 3.6 and earlier with assert pulled in
+//          - ~/ts3.6/base.d.ts   - Definitions specific to TypeScript 3.6 and earlier
+//          - ~/ts3.6/index.d.ts  - Definitions specific to TypeScript 3.6 and earlier with assert pulled in
 
 // Reference required types from the default lib:
 /// <reference lib="es2018" />
@@ -61,8 +61,8 @@
 /// <reference path="../worker_threads.d.ts" />
 /// <reference path="../zlib.d.ts" />
 
-// TypeScript 3.5-specific augmentations:
+// TypeScript 3.6-specific augmentations:
 /// <reference path="../globals.global.d.ts" />
 
-// TypeScript 3.5-specific augmentations:
+// TypeScript 3.6-specific augmentations:
 /// <reference path="../wasi.d.ts" />

node/ts3.6/index.d.ts

@@ -1,4 +1,4 @@
-// NOTE: These definitions support NodeJS and TypeScript 3.5 - 3.6.
+// NOTE: These definitions support NodeJS and TypeScript 3.6.
 // This is required to enable typing assert in ts3.7 without causing errors
 // Typically type modifications should be made in base.d.ts instead of here
 

node/wasi.d.ts

@@ -58,7 +58,7 @@ declare module 'wasi' {
          * invoke the `__wasi_unstable_reactor_start()` export. If neither of those exports
          * is present on `instance`, then `start()` does nothing.
          *
-         * `start()` requires that `instance` exports a [`WebAssembly.Memory`][] named
+         * `start()` requires that `instance` exports a `WebAssembly.Memory` named
          * `memory`. If `instance` does not have a `memory` export an exception is thrown.
          *
          * If `start()` is called more than once, an exception is thrown.
@@ -69,7 +69,7 @@ declare module 'wasi' {
          * Attempt to initialize `instance` as a WASI reactor by invoking its `_initialize()` export, if it is present.
          * If `instance` contains a `_start()` export, then an exception is thrown.
          *
-         * `start()` requires that `instance` exports a [`WebAssembly.Memory`][] named
+         * `start()` requires that `instance` exports a `WebAssembly.Memory` named
          * `memory`. If `instance` does not have a `memory` export an exception is thrown.
          *
          * If `initialize()` is called more than once, an exception is thrown.
@@ -79,7 +79,7 @@ declare module 'wasi' {
         /**
          * Is an object that implements the WASI system call API. This object
          * should be passed as the `wasi_snapshot_preview1` import during the instantiation of a
-         * [`WebAssembly.Instance`][].
+         * `WebAssembly.Instance`.
          */
         readonly wasiImport: NodeJS.Dict<any>; // TODO: Narrow to DOM types
     }

node/worker_threads.d.ts

@@ -1,4 +1,5 @@
 declare module 'worker_threads' {
+    import { Blob } from 'node:buffer';
     import { Context } from 'vm';
     import { EventEmitter } from 'events';
     import { EventLoopUtilityFunction } from 'perf_hooks';
@@ -23,7 +24,7 @@ declare module 'worker_threads' {
         eventLoopUtilization: EventLoopUtilityFunction;
     }
 
-    type TransferListItem = ArrayBuffer | MessagePort | FileHandle | X509Certificate;
+    type TransferListItem = ArrayBuffer | MessagePort | FileHandle | X509Certificate | Blob;
 
     class MessagePort extends EventEmitter {
         close(): void;
@@ -145,11 +146,11 @@ declare module 'worker_threads' {
 
         /**
          * Returns a readable stream for a V8 snapshot of the current state of the Worker.
-         * See [`v8.getHeapSnapshot()`][] for more details.
+         * See `v8.getHeapSnapshot()` for more details.
          *
          * If the Worker thread is no longer running, which may occur before the
-         * [`'exit'` event][] is emitted, the returned `Promise` will be rejected
-         * immediately with an [`ERR_WORKER_NOT_RUNNING`][] error
+         * `'exit'` event is emitted, the returned `Promise` will be rejected
+         * immediately with an `ERR_WORKER_NOT_RUNNING` error
          */
         getHeapSnapshot(): Promise<Readable>;
 
@@ -261,4 +262,21 @@ declare module 'worker_threads' {
      * `MessagePort`’s queue.
      */
     function receiveMessageOnPort(port: MessagePort): { message: any } | undefined;
+
+    type Serializable = string | object | number | boolean | bigint;
+
+    /**
+     * @param key Any arbitrary, cloneable JavaScript value that can be used as a {Map} key.
+     * @experimental
+     */
+    function getEnvironmentData(key: Serializable): Serializable;
+
+    /**
+     * @param key Any arbitrary, cloneable JavaScript value that can be used as a {Map} key.
+     * @param value Any arbitrary, cloneable JavaScript value that will be cloned
+     * and passed automatically to all new `Worker` instances. If `value` is passed
+     * as `undefined`, any previously set value for the `key` will be deleted.
+     * @experimental
+     */
+    function setEnvironmentData(key: Serializable, value: Serializable): void;
 }