@types/node 12.12.66 → 12.12.70

node v12.12/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/v12.
 
 ### Additional Details
- * Last updated: Thu, 08 Oct 2020 21:07:30 GMT
+ * Last updated: Wed, 21 Oct 2020 17:47:46 GMT
  * Dependencies: none
  * Global values: `Buffer`, `NodeJS`, `__dirname`, `__filename`, `clearImmediate`, `clearInterval`, `clearTimeout`, `console`, `exports`, `global`, `module`, `process`, `queueMicrotask`, `require`, `setImmediate`, `setInterval`, `setTimeout`
 

node v12.12/child_process.d.ts

@@ -384,19 +384,23 @@ declare module "child_process" {
     // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
     namespace execFile {
         function __promisify__(file: string): PromiseWithChild<{ stdout: string, stderr: string }>;
-        function __promisify__(file: string, args: string[] | undefined | null): PromiseWithChild<{ stdout: string, stderr: string }>;
+        function __promisify__(file: string, args: ReadonlyArray<string> | undefined | null): PromiseWithChild<{ stdout: string, stderr: string }>;
         function __promisify__(file: string, options: ExecFileOptionsWithBufferEncoding): PromiseWithChild<{ stdout: Buffer, stderr: Buffer }>;
-        function __promisify__(file: string, args: string[] | undefined | null, options: ExecFileOptionsWithBufferEncoding): PromiseWithChild<{ stdout: Buffer, stderr: Buffer }>;
+        function __promisify__(file: string, args: ReadonlyArray<string> | undefined | null, options: ExecFileOptionsWithBufferEncoding): PromiseWithChild<{ stdout: Buffer, stderr: Buffer }>;
         function __promisify__(file: string, options: ExecFileOptionsWithStringEncoding): PromiseWithChild<{ stdout: string, stderr: string }>;
-        function __promisify__(file: string, args: string[] | undefined | null, options: ExecFileOptionsWithStringEncoding): PromiseWithChild<{ stdout: string, stderr: string }>;
+        function __promisify__(file: string, args: ReadonlyArray<string> | undefined | null, options: ExecFileOptionsWithStringEncoding): PromiseWithChild<{ stdout: string, stderr: string }>;
         function __promisify__(file: string, options: ExecFileOptionsWithOtherEncoding): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
-        function __promisify__(file: string, args: string[] | undefined | null, options: ExecFileOptionsWithOtherEncoding): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
+        function __promisify__(
+            file: string,
+            args: ReadonlyArray<string> | undefined | null,
+            options: ExecFileOptionsWithOtherEncoding,
+        ): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
         function __promisify__(file: string, options: ExecFileOptions): PromiseWithChild<{ stdout: string, stderr: string }>;
-        function __promisify__(file: string, args: string[] | undefined | null, options: ExecFileOptions): PromiseWithChild<{ stdout: string, stderr: string }>;
+        function __promisify__(file: string, args: ReadonlyArray<string> | undefined | null, options: ExecFileOptions): PromiseWithChild<{ stdout: string, stderr: string }>;
         function __promisify__(file: string, options: ({ encoding?: string | null } & ExecFileOptions) | undefined | null): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
         function __promisify__(
             file: string,
-            args: string[] | undefined | null,
+            args: ReadonlyArray<string> | undefined | null,
             options: ({ encoding?: string | null } & ExecFileOptions) | undefined | null,
         ): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
     }

node v12.12/dgram.d.ts

@@ -50,9 +50,9 @@ declare module "dgram" {
         getSendBufferSize(): number;
         ref(): this;
         remoteAddress(): AddressInfo;
-        send(msg: string | Uint8Array | any[], port?: number, address?: string, callback?: (error: Error | null, bytes: number) => void): void;
-        send(msg: string | Uint8Array | any[], port?: number, callback?: (error: Error | null, bytes: number) => void): void;
-        send(msg: string | Uint8Array | any[], callback?: (error: Error | null, bytes: number) => void): void;
+        send(msg: string | Uint8Array | ReadonlyArray<any>, port?: number, address?: string, callback?: (error: Error | null, bytes: number) => void): void;
+        send(msg: string | Uint8Array | ReadonlyArray<any>, port?: number, callback?: (error: Error | null, bytes: number) => void): void;
+        send(msg: string | Uint8Array | ReadonlyArray<any>, callback?: (error: Error | null, bytes: number) => void): void;
         send(msg: string | Uint8Array, offset: number, length: number, port?: number, address?: string, callback?: (error: Error | null, bytes: number) => void): void;
         send(msg: string | Uint8Array, offset: number, length: number, port?: number, callback?: (error: Error | null, bytes: number) => void): void;
         send(msg: string | Uint8Array, offset: number, length: number, callback?: (error: Error | null, bytes: number) => void): void;

node v12.12/fs.d.ts

@@ -739,6 +739,14 @@ declare module "fs" {
     function unlinkSync(path: PathLike): void;
 
     interface RmDirOptions {
+        /**
+         * If an `EBUSY`, `ENOTEMPTY`, or `EPERM` error is
+         * encountered, Node.js will retry the operation with a linear backoff wait of
+         * 100ms longer on each try. This option represents the number of retries. This
+         * option is ignored if the `recursive` option is not `true`.
+         * @default 3
+         */
+        maxRetries?: number;
         /**
          * If `true`, perform a recursive directory removal. In
          * recursive mode, errors are not reported if `path` does not exist, and
@@ -747,9 +755,6 @@ declare module "fs" {
          * @default false
          */
         recursive?: boolean;
-    }
-
-    interface RmDirAsyncOptions extends RmDirOptions {
         /**
          * If an `EMFILE` error is encountered, Node.js will
          * retry the operation with a linear backoff of 1ms longer on each try until the
@@ -758,14 +763,6 @@ declare module "fs" {
          * @default 1000
          */
         emfileWait?: number;
-        /**
-         * If an `EBUSY`, `ENOTEMPTY`, or `EPERM` error is
-         * encountered, Node.js will retry the operation with a linear backoff wait of
-         * 100ms longer on each try. This option represents the number of retries. This
-         * option is ignored if the `recursive` option is not `true`.
-         * @default 3
-         */
-        maxBusyTries?: number;
     }
 
     /**
@@ -773,7 +770,7 @@ declare module "fs" {
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      */
     function rmdir(path: PathLike, callback: NoParamCallback): void;
-    function rmdir(path: PathLike, options: RmDirAsyncOptions, callback: NoParamCallback): void;
+    function rmdir(path: PathLike, options: RmDirOptions, callback: NoParamCallback): void;
 
     // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
     namespace rmdir {
@@ -781,7 +778,7 @@ declare module "fs" {
          * Asynchronous rmdir(2) - delete a directory.
          * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
          */
-        function __promisify__(path: PathLike, options?: RmDirAsyncOptions): Promise<void>;
+        function __promisify__(path: PathLike, options?: RmDirOptions): Promise<void>;
     }
 
     /**
@@ -1916,12 +1913,12 @@ declare module "fs" {
      */
     function writev(
         fd: number,
-        buffers: NodeJS.ArrayBufferView[],
+        buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
         cb: (err: NodeJS.ErrnoException | null, bytesWritten: number, buffers: NodeJS.ArrayBufferView[]) => void
     ): void;
     function writev(
         fd: number,
-        buffers: NodeJS.ArrayBufferView[],
+        buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
         position: number,
         cb: (err: NodeJS.ErrnoException | null, bytesWritten: number, buffers: NodeJS.ArrayBufferView[]) => void
     ): void;
@@ -1932,13 +1929,13 @@ declare module "fs" {
     }
 
     namespace writev {
-        function __promisify__(fd: number, buffers: NodeJS.ArrayBufferView[], position?: number): Promise<WriteVResult>;
+        function __promisify__(fd: number, buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): Promise<WriteVResult>;
     }
 
     /**
      * See `writev`.
      */
-    function writevSync(fd: number, buffers: NodeJS.ArrayBufferView[], position?: number): number;
+    function writevSync(fd: number, buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): number;
 
     interface OpenDirOptions {
         encoding?: BufferEncoding;
@@ -2082,7 +2079,7 @@ declare module "fs" {
             /**
              * See `fs.writev` promisified version.
              */
-            writev(buffers: NodeJS.ArrayBufferView[], position?: number): Promise<WriteVResult>;
+            writev(buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): Promise<WriteVResult>;
 
             /**
              * Asynchronous close(2) - close a `FileHandle`.
@@ -2189,7 +2186,7 @@ declare module "fs" {
          * Asynchronous rmdir(2) - delete a directory.
          * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
          */
-        function rmdir(path: PathLike, options?: RmDirAsyncOptions): Promise<void>;
+        function rmdir(path: PathLike, options?: RmDirOptions): Promise<void>;
 
         /**
          * Asynchronous fdatasync(2) - synchronize a file's in-core state with storage device.

node v12.12/globals.d.ts

@@ -62,7 +62,7 @@ interface Console {
      * This method does not display anything unless used in the inspector.
      *  Prints to `stdout` the array `array` formatted as a table.
      */
-    table(tabularData: any, properties?: string[]): void;
+    table(tabularData: any, properties?: ReadonlyArray<string>): void;
     /**
      * Starts a timer that can be used to compute the duration of an operation. Timers are identified by a unique `label`.
      */
@@ -305,7 +305,7 @@ declare class Buffer extends Uint8Array {
      * @param array The octets to store.
      * @deprecated since v10.0.0 - Use `Buffer.from(array)` instead.
      */
-    constructor(array: any[]);
+    constructor(array: ReadonlyArray<any>);
     /**
      * Copies the passed {buffer} data onto a new {Buffer} instance.
      *
@@ -326,7 +326,7 @@ declare class Buffer extends Uint8Array {
      * Creates a new Buffer using the passed {data}
      * @param data data to create a new Buffer
      */
-    static from(data: number[]): Buffer;
+    static from(data: ReadonlyArray<number>): Buffer;
     static from(data: Uint8Array): Buffer;
     /**
      * Creates a new buffer containing the coerced value of an object
@@ -380,7 +380,7 @@ declare class Buffer extends Uint8Array {
      * @param totalLength Total length of the buffers when concatenated.
      *   If totalLength is not provided, it is read from the buffers in the list. However, this adds an additional loop to the function, so it is faster to provide the length explicitly.
      */
-    static concat(list: Uint8Array[], totalLength?: number): Buffer;
+    static concat(list: ReadonlyArray<Uint8Array>, totalLength?: number): Buffer;
     /**
      * The same as buf1.compare(buf2).
      */
@@ -882,7 +882,7 @@ declare namespace NodeJS {
         getegid(): number;
         setegid(id: number | string): void;
         getgroups(): number[];
-        setgroups(groups: Array<string | number>): void;
+        setgroups(groups: ReadonlyArray<string | number>): void;
         setUncaughtExceptionCaptureCallback(cb: ((err: Error) => void) | null): void;
         hasUncaughtExceptionCaptureCallback(): boolean;
         version: string;

node v12.12/http.d.ts

@@ -135,13 +135,13 @@ declare module "http" {
         constructor();
 
         setTimeout(msecs: number, callback?: () => void): this;
-        setHeader(name: string, value: number | string | string[]): void;
+        setHeader(name: string, value: number | string | ReadonlyArray<string>): void;
         getHeader(name: string): number | string | string[] | undefined;
         getHeaders(): OutgoingHttpHeaders;
         getHeaderNames(): string[];
         hasHeader(name: string): boolean;
         removeHeader(name: string): void;
-        addTrailers(headers: OutgoingHttpHeaders | Array<[string, string]>): void;
+        addTrailers(headers: OutgoingHttpHeaders | ReadonlyArray<[string, string]>): void;
         flushHeaders(): void;
     }
 

node v12.12/http2.d.ts

@@ -356,7 +356,7 @@ declare module "http2" {
         addListener(event: string | symbol, listener: (...args: any[]) => void): this;
 
         emit(event: "altsvc", alt: string, origin: string, stream: number): boolean;
-        emit(event: "origin", origins: string[]): boolean;
+        emit(event: "origin", origins: ReadonlyArray<string>): boolean;
         emit(event: "connect", session: ClientHttp2Session, socket: net.Socket | tls.TLSSocket): boolean;
         emit(event: "stream", stream: ClientHttp2Stream, headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number): boolean;
         emit(event: string | symbol, ...args: any[]): boolean;
@@ -570,7 +570,7 @@ declare module "http2" {
     }
 
     export class Http2ServerRequest extends stream.Readable {
-        constructor(stream: ServerHttp2Stream, headers: IncomingHttpHeaders, options: stream.ReadableOptions, rawHeaders: string[]);
+        constructor(stream: ServerHttp2Stream, headers: IncomingHttpHeaders, options: stream.ReadableOptions, rawHeaders: ReadonlyArray<string>);
 
         readonly aborted: boolean;
         readonly authority: string;
@@ -657,7 +657,7 @@ declare module "http2" {
         getHeaders(): OutgoingHttpHeaders;
         hasHeader(name: string): boolean;
         removeHeader(name: string): void;
-        setHeader(name: string, value: number | string | string[]): void;
+        setHeader(name: string, value: number | string | ReadonlyArray<string>): void;
         setTimeout(msecs: number, callback?: () => void): void;
         write(chunk: string | Uint8Array, callback?: (err: Error) => void): boolean;
         write(chunk: string | Uint8Array, encoding: string, callback?: (err: Error) => void): boolean;

node v12.12/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "12.12.66",
+    "version": "12.12.70",
     "description": "TypeScript definitions for Node.js",
     "license": "MIT",
     "contributors": [
@@ -231,6 +231,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "2aa86deb3c0fcc183413ddd6db6789beb3aedb6a4011ce7cb28df21b17da78d9",
+    "typesPublisherContentHash": "86d21f1f394b808863aabd5045402fca03a666e6e4c13c81302c4c82c28462bd",
     "typeScriptVersion": "3.2"
 }

node v12.12/perf_hooks.d.ts

@@ -161,7 +161,7 @@ declare module "perf_hooks" {
          * Property buffered defaults to false.
          * @param options
          */
-        observe(options: { entryTypes: string[], buffered?: boolean }): void;
+        observe(options: { entryTypes: ReadonlyArray<string>, buffered?: boolean }): void;
     }
 
     namespace constants {

node v12.12/punycode.d.ts

@@ -1,12 +1,68 @@
 declare module "punycode" {
+    /**
+     * @deprecated since v7.0.0
+     * The version of the punycode module bundled in Node.js is being deprecated.
+     * In a future major version of Node.js this module will be removed.
+     * Users currently depending on the punycode module should switch to using
+     * the userland-provided Punycode.js module instead.
+     */
     function decode(string: string): string;
+    /**
+     * @deprecated since v7.0.0
+     * The version of the punycode module bundled in Node.js is being deprecated.
+     * In a future major version of Node.js this module will be removed.
+     * Users currently depending on the punycode module should switch to using
+     * the userland-provided Punycode.js module instead.
+     */
     function encode(string: string): string;
+    /**
+     * @deprecated since v7.0.0
+     * The version of the punycode module bundled in Node.js is being deprecated.
+     * In a future major version of Node.js this module will be removed.
+     * Users currently depending on the punycode module should switch to using
+     * the userland-provided Punycode.js module instead.
+     */
     function toUnicode(domain: string): string;
+    /**
+     * @deprecated since v7.0.0
+     * The version of the punycode module bundled in Node.js is being deprecated.
+     * In a future major version of Node.js this module will be removed.
+     * Users currently depending on the punycode module should switch to using
+     * the userland-provided Punycode.js module instead.
+     */
     function toASCII(domain: string): string;
+    /**
+     * @deprecated since v7.0.0
+     * The version of the punycode module bundled in Node.js is being deprecated.
+     * In a future major version of Node.js this module will be removed.
+     * Users currently depending on the punycode module should switch to using
+     * the userland-provided Punycode.js module instead.
+     */
     const ucs2: ucs2;
     interface ucs2 {
+        /**
+         * @deprecated since v7.0.0
+         * The version of the punycode module bundled in Node.js is being deprecated.
+         * In a future major version of Node.js this module will be removed.
+         * Users currently depending on the punycode module should switch to using
+         * the userland-provided Punycode.js module instead.
+         */
         decode(string: string): number[];
-        encode(codePoints: number[]): string;
+        /**
+         * @deprecated since v7.0.0
+         * The version of the punycode module bundled in Node.js is being deprecated.
+         * In a future major version of Node.js this module will be removed.
+         * Users currently depending on the punycode module should switch to using
+         * the userland-provided Punycode.js module instead.
+         */
+        encode(codePoints: ReadonlyArray<number>): string;
     }
+    /**
+     * @deprecated since v7.0.0
+     * The version of the punycode module bundled in Node.js is being deprecated.
+     * In a future major version of Node.js this module will be removed.
+     * Users currently depending on the punycode module should switch to using
+     * the userland-provided Punycode.js module instead.
+     */
     const version: string;
 }

node v12.12/stream.d.ts

@@ -293,7 +293,10 @@ declare module "stream" {
             stream5: T,
             callback?: (err: NodeJS.ErrnoException | null) => void,
         ): T;
-        function pipeline(streams: Array<NodeJS.ReadableStream | NodeJS.WritableStream | NodeJS.ReadWriteStream>, callback?: (err: NodeJS.ErrnoException | null) => void): NodeJS.WritableStream;
+        function pipeline(
+            streams: ReadonlyArray<NodeJS.ReadableStream | NodeJS.WritableStream | NodeJS.ReadWriteStream>,
+            callback?: (err: NodeJS.ErrnoException | null) => void,
+        ): NodeJS.WritableStream;
         function pipeline(
             stream1: NodeJS.ReadableStream,
             stream2: NodeJS.ReadWriteStream | NodeJS.WritableStream,
@@ -310,7 +313,7 @@ declare module "stream" {
                 stream4: NodeJS.ReadWriteStream,
                 stream5: NodeJS.WritableStream,
             ): Promise<void>;
-            function __promisify__(streams: Array<NodeJS.ReadableStream | NodeJS.WritableStream | NodeJS.ReadWriteStream>): Promise<void>;
+            function __promisify__(streams: ReadonlyArray<NodeJS.ReadableStream | NodeJS.WritableStream | NodeJS.ReadWriteStream>): Promise<void>;
             function __promisify__(
                 stream1: NodeJS.ReadableStream,
                 stream2: NodeJS.ReadWriteStream | NodeJS.WritableStream,

node v12.12/url.d.ts

@@ -93,7 +93,7 @@ declare module "url" {
     }
 
     class URLSearchParams implements Iterable<[string, string]> {
-        constructor(init?: URLSearchParams | string | { [key: string]: string | string[] | undefined } | Iterable<[string, string]> | Array<[string, string]>);
+        constructor(init?: URLSearchParams | string | { [key: string]: string | ReadonlyArray<string> | undefined } | Iterable<[string, string]> | ReadonlyArray<[string, string]>);
         append(name: string, value: string): void;
         delete(name: string): void;
         entries(): IterableIterator<[string, string]>;

node v12.12/vm.d.ts

@@ -106,5 +106,5 @@ declare module "vm" {
     function runInContext(code: string, contextifiedSandbox: Context, options?: RunningScriptOptions | string): any;
     function runInNewContext(code: string, sandbox?: Context, options?: RunningScriptOptions | string): any;
     function runInThisContext(code: string, options?: RunningScriptOptions | string): any;
-    function compileFunction(code: string, params?: string[], options?: CompileFunctionOptions): Function;
+    function compileFunction(code: string, params?: ReadonlyArray<string>, options?: CompileFunctionOptions): Function;
 }

node v12.12/worker_threads.d.ts

@@ -5,6 +5,7 @@ declare module "worker_threads" {
 
     const isMainThread: boolean;
     const parentPort: null | MessagePort;
+    const resourceLimits: ResourceLimits;
     const SHARE_ENV: unique symbol;
     const threadId: number;
     const workerData: any;
@@ -14,9 +15,11 @@ declare module "worker_threads" {
         readonly port2: MessagePort;
     }
 
+    type TransferListItem = ArrayBuffer | MessagePort;
+
     class MessagePort extends EventEmitter {
         close(): void;
-        postMessage(value: any, transferList?: Array<ArrayBuffer | MessagePort>): void;
+        postMessage(value: any, transferList?: ReadonlyArray<TransferListItem>): void;
         ref(): void;
         unref(): void;
         start(): void;
@@ -62,6 +65,26 @@ declare module "worker_threads" {
         stdout?: boolean;
         stderr?: boolean;
         execArgv?: string[];
+        resourceLimits?: ResourceLimits;
+        /**
+         * Additional data to send in the first worker message.
+         */
+        transferList?: TransferListItem[];
+    }
+
+    interface ResourceLimits {
+        /**
+         * The maximum size of a heap space for recently created objects.
+         */
+        maxYoungGenerationSizeMb?: number;
+        /**
+         * The maximum size of the main heap in MB.
+         */
+        maxOldGenerationSizeMb?: number;
+        /**
+         * The size of a pre-allocated memory range used for generated code.
+         */
+        codeRangeSizeMb?: number;
     }
 
     class Worker extends EventEmitter {
@@ -72,7 +95,7 @@ declare module "worker_threads" {
 
         constructor(filename: string, options?: WorkerOptions);
 
-        postMessage(value: any, transferList?: Array<ArrayBuffer | MessagePort>): void;
+        postMessage(value: any, transferList?: ReadonlyArray<TransferListItem>): void;
         ref(): void;
         unref(): void;
         /**

node v12.12/zlib.d.ts

@@ -49,7 +49,8 @@ declare module "zlib" {
         readonly bytesWritten: number;
         shell?: boolean | string;
         close(callback?: () => void): void;
-        flush(kind?: number | (() => void), callback?: () => void): void;
+        flush(kind?: number, callback?: () => void): void;
+        flush(callback?: () => void): void;
     }
 
     interface ZlibParams {
@@ -86,69 +87,76 @@ declare module "zlib" {
 
     function brotliCompress(buf: InputType, options: BrotliOptions, callback: CompressCallback): void;
     function brotliCompress(buf: InputType, callback: CompressCallback): void;
+    namespace brotliCompress {
+        function __promisify__(buffer: InputType, options?: BrotliOptions): Promise<Buffer>;
+    }
+
     function brotliCompressSync(buf: InputType, options?: BrotliOptions): Buffer;
+
     function brotliDecompress(buf: InputType, options: BrotliOptions, callback: CompressCallback): void;
     function brotliDecompress(buf: InputType, callback: CompressCallback): void;
+    namespace brotliDecompress {
+        function __promisify__(buffer: InputType, options?: BrotliOptions): Promise<Buffer>;
+    }
+
     function brotliDecompressSync(buf: InputType, options?: BrotliOptions): Buffer;
+
     function deflate(buf: InputType, callback: CompressCallback): void;
     function deflate(buf: InputType, options: ZlibOptions, callback: CompressCallback): void;
+    namespace deflate {
+        function __promisify__(buffer: InputType, options?: ZlibOptions): Promise<Buffer>;
+    }
+
     function deflateSync(buf: InputType, options?: ZlibOptions): Buffer;
+
     function deflateRaw(buf: InputType, callback: CompressCallback): void;
     function deflateRaw(buf: InputType, options: ZlibOptions, callback: CompressCallback): void;
+    namespace deflateRaw {
+        function __promisify__(buffer: InputType, options?: ZlibOptions): Promise<Buffer>;
+    }
+
     function deflateRawSync(buf: InputType, options?: ZlibOptions): Buffer;
+
     function gzip(buf: InputType, callback: CompressCallback): void;
     function gzip(buf: InputType, options: ZlibOptions, callback: CompressCallback): void;
+    namespace gzip {
+        function __promisify__(buffer: InputType, options?: ZlibOptions): Promise<Buffer>;
+    }
+
     function gzipSync(buf: InputType, options?: ZlibOptions): Buffer;
+
     function gunzip(buf: InputType, callback: CompressCallback): void;
     function gunzip(buf: InputType, options: ZlibOptions, callback: CompressCallback): void;
+    namespace gunzip {
+        function __promisify__(buffer: InputType, options?: ZlibOptions): Promise<Buffer>;
+    }
+
     function gunzipSync(buf: InputType, options?: ZlibOptions): Buffer;
+
     function inflate(buf: InputType, callback: CompressCallback): void;
     function inflate(buf: InputType, options: ZlibOptions, callback: CompressCallback): void;
+    namespace inflate {
+        function __promisify__(buffer: InputType, options?: ZlibOptions): Promise<Buffer>;
+    }
+
     function inflateSync(buf: InputType, options?: ZlibOptions): Buffer;
+
     function inflateRaw(buf: InputType, callback: CompressCallback): void;
     function inflateRaw(buf: InputType, options: ZlibOptions, callback: CompressCallback): void;
+    namespace inflateRaw {
+        function __promisify__(buffer: InputType, options?: ZlibOptions): Promise<Buffer>;
+    }
+
     function inflateRawSync(buf: InputType, options?: ZlibOptions): Buffer;
+
     function unzip(buf: InputType, callback: CompressCallback): void;
     function unzip(buf: InputType, options: ZlibOptions, callback: CompressCallback): void;
-    function unzipSync(buf: InputType, options?: ZlibOptions): Buffer;
-
-    namespace brotliCompress {
-        function __promisify__(buffer: InputType, options: BrotliOptions): Promise<Buffer>;
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-    }
-    namespace brotliDecompress {
-        function __promisify__(buffer: InputType, options: BrotliOptions): Promise<Buffer>;
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-    }
-    namespace deflate {
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-        function __promisify__(buffer: InputType, options: ZlibOptions): Promise<Buffer>;
-    }
-    namespace deflateRaw {
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-        function __promisify__(buffer: InputType, options: ZlibOptions): Promise<Buffer>;
-    }
-    namespace gzip {
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-        function __promisify__(buffer: InputType, options: ZlibOptions): Promise<Buffer>;
-    }
-    namespace gunzip {
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-        function __promisify__(buffer: InputType, options: ZlibOptions): Promise<Buffer>;
-    }
-    namespace inflate {
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-        function __promisify__(buffer: InputType, options: ZlibOptions): Promise<Buffer>;
-    }
-    namespace inflateRaw {
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-        function __promisify__(buffer: InputType, options: ZlibOptions): Promise<Buffer>;
-    }
     namespace unzip {
-        function __promisify__(buffer: InputType): Promise<Buffer>;
-        function __promisify__(buffer: InputType, options: ZlibOptions): Promise<Buffer>;
+        function __promisify__(buffer: InputType, options?: ZlibOptions): Promise<Buffer>;
     }
 
+    function unzipSync(buf: InputType, options?: ZlibOptions): Buffer;
+
     namespace constants {
         const BROTLI_DECODE: number;
         const BROTLI_DECODER_ERROR_ALLOC_BLOCK_TYPE_TREES: number;
@@ -226,165 +234,121 @@ declare module "zlib" {
         const INFLATERAW: number;
         const UNZIP: number;
 
-        const Z_BEST_COMPRESSION: number;
-        const Z_BEST_SPEED: number;
+        const Z_NO_FLUSH: number;
+        const Z_PARTIAL_FLUSH: number;
+        const Z_SYNC_FLUSH: number;
+        const Z_FULL_FLUSH: number;
+        const Z_FINISH: number;
         const Z_BLOCK: number;
-        const Z_BUF_ERROR: number;
+        const Z_TREES: number;
+
+        const Z_OK: number;
+        const Z_STREAM_END: number;
+        const Z_NEED_DICT: number;
+        const Z_ERRNO: number;
+        const Z_STREAM_ERROR: number;
         const Z_DATA_ERROR: number;
+        const Z_MEM_ERROR: number;
+        const Z_BUF_ERROR: number;
+        const Z_VERSION_ERROR: number;
 
-        const Z_DEFAULT_CHUNK: number;
+        const Z_NO_COMPRESSION: number;
+        const Z_BEST_SPEED: number;
+        const Z_BEST_COMPRESSION: number;
         const Z_DEFAULT_COMPRESSION: number;
-        const Z_DEFAULT_LEVEL: number;
-        const Z_DEFAULT_MEMLEVEL: number;
-        const Z_DEFAULT_STRATEGY: number;
-        const Z_DEFAULT_WINDOWBITS: number;
 
-        const Z_ERRNO: number;
         const Z_FILTERED: number;
-        const Z_FINISH: number;
-        const Z_FIXED: number;
-        const Z_FULL_FLUSH: number;
         const Z_HUFFMAN_ONLY: number;
-        const Z_MAX_CHUNK: number;
-        const Z_MAX_LEVEL: number;
-        const Z_MAX_MEMLEVEL: number;
+        const Z_RLE: number;
+        const Z_FIXED: number;
+        const Z_DEFAULT_STRATEGY: number;
+
+        const Z_DEFAULT_WINDOWBITS: number;
+        const Z_MIN_WINDOWBITS: number;
         const Z_MAX_WINDOWBITS: number;
-        const Z_MEM_ERROR: number;
+
         const Z_MIN_CHUNK: number;
-        const Z_MIN_LEVEL: number;
+        const Z_MAX_CHUNK: number;
+        const Z_DEFAULT_CHUNK: number;
+
         const Z_MIN_MEMLEVEL: number;
-        const Z_MIN_WINDOWBITS: number;
-        const Z_NEED_DICT: number;
-        const Z_NO_COMPRESSION: number;
-        const Z_NO_FLUSH: number;
-        const Z_OK: number;
-        const Z_PARTIAL_FLUSH: number;
-        const Z_RLE: number;
-        const Z_STREAM_END: number;
-        const Z_STREAM_ERROR: number;
-        const Z_SYNC_FLUSH: number;
-        const Z_VERSION_ERROR: number;
+        const Z_MAX_MEMLEVEL: number;
+        const Z_DEFAULT_MEMLEVEL: number;
+
+        const Z_MIN_LEVEL: number;
+        const Z_MAX_LEVEL: number;
+        const Z_DEFAULT_LEVEL: number;
+
         const ZLIB_VERNUM: number;
     }
 
-    /**
-     * @deprecated
-     */
+    // Allowed flush values.
+    /** @deprecated Use `constants.Z_NO_FLUSH` */
     const Z_NO_FLUSH: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_PARTIAL_FLUSH` */
     const Z_PARTIAL_FLUSH: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_SYNC_FLUSH` */
     const Z_SYNC_FLUSH: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_FULL_FLUSH` */
     const Z_FULL_FLUSH: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_FINISH` */
     const Z_FINISH: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_BLOCK` */
     const Z_BLOCK: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_TREES` */
     const Z_TREES: number;
-    /**
-     * @deprecated
-     */
+
+    // Return codes for the compression/decompression functions.
+    // Negative values are errors, positive values are used for special but normal events.
+    /** @deprecated Use `constants.Z_OK` */
     const Z_OK: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_STREAM_END` */
     const Z_STREAM_END: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_NEED_DICT` */
     const Z_NEED_DICT: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_ERRNO` */
     const Z_ERRNO: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_STREAM_ERROR` */
     const Z_STREAM_ERROR: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_DATA_ERROR` */
     const Z_DATA_ERROR: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_MEM_ERROR` */
     const Z_MEM_ERROR: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_BUF_ERROR` */
     const Z_BUF_ERROR: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_VERSION_ERROR` */
     const Z_VERSION_ERROR: number;
-    /**
-     * @deprecated
-     */
+
+    // Compression levels.
+    /** @deprecated Use `constants.Z_NO_COMPRESSION` */
     const Z_NO_COMPRESSION: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_BEST_SPEED` */
     const Z_BEST_SPEED: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_BEST_COMPRESSION` */
     const Z_BEST_COMPRESSION: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_DEFAULT_COMPRESSION` */
     const Z_DEFAULT_COMPRESSION: number;
-    /**
-     * @deprecated
-     */
+
+    // Compression strategy.
+    /** @deprecated Use `constants.Z_FILTERED` */
     const Z_FILTERED: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_HUFFMAN_ONLY` */
     const Z_HUFFMAN_ONLY: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_RLE` */
     const Z_RLE: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_FIXED` */
     const Z_FIXED: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated Use `constants.Z_DEFAULT_STRATEGY` */
     const Z_DEFAULT_STRATEGY: number;
-    /**
-     * @deprecated
-     */
+
+    /** @deprecated */
     const Z_BINARY: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated */
     const Z_TEXT: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated */
     const Z_ASCII: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated  */
     const Z_UNKNOWN: number;
-    /**
-     * @deprecated
-     */
+    /** @deprecated */
     const Z_DEFLATED: number;
 }