@types/node 14.11.11 → 14.14.3

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, 20 Oct 2020 06:54:48 GMT
+ * Last updated: Sun, 25 Oct 2020 21:14:09 GMT
  * Dependencies: none
  * Global values: `Buffer`, `__dirname`, `__filename`, `clearImmediate`, `clearInterval`, `clearTimeout`, `console`, `exports`, `global`, `module`, `process`, `queueMicrotask`, `require`, `setImmediate`, `setInterval`, `setTimeout`
 

node/fs/promises.d.ts

@@ -4,7 +4,8 @@ declare module 'fs/promises' {
         WriteVResult,
         ReadVResult,
         PathLike,
-        RmDirAsyncOptions,
+        RmDirOptions,
+        RmOptions,
         MakeDirectoryOptions,
         Dirent,
         OpenDirOptions,
@@ -255,7 +256,12 @@ declare module 'fs/promises' {
      * 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>;
+
+    /**
+     * Asynchronously removes files and directories (modeled on the standard POSIX `rm` utility).
+     */
+    function rm(path: PathLike, options?: RmOptions): Promise<void>;
 
     /**
      * Asynchronous fdatasync(2) - synchronize a file's in-core state with storage device.
@@ -409,6 +415,16 @@ declare module 'fs/promises' {
      */
     function lchown(path: PathLike, uid: number, gid: number): Promise<void>;
 
+    /**
+     * Changes the access and modification times of a file in the same way as `fsPromises.utimes()`,
+     * with the difference that if the path refers to a symbolic link, then the link is not
+     * dereferenced: instead, the timestamps of the symbolic link itself are changed.
+     * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
+     * @param atime The last access time. If a string is provided, it will be coerced to number.
+     * @param mtime The last modified time. If a string is provided, it will be coerced to number.
+     */
+    function lutimes(path: PathLike, atime: string | number | Date, mtime: string | number | Date): Promise<void>;
+
     /**
      * Asynchronous fchown(2) - Change ownership of a file.
      * @param handle A `FileHandle`.

node/fs.d.ts

@@ -427,6 +427,39 @@ declare module "fs" {
      */
     export function lchownSync(path: PathLike, uid: number, gid: number): void;
 
+    /**
+     * Changes the access and modification times of a file in the same way as `fs.utimes()`,
+     * with the difference that if the path refers to a symbolic link, then the link is not
+     * dereferenced: instead, the timestamps of the symbolic link itself are changed.
+     * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
+     * @param atime The last access time. If a string is provided, it will be coerced to number.
+     * @param mtime The last modified time. If a string is provided, it will be coerced to number.
+     */
+    export function lutimes(path: PathLike, atime: string | number | Date, mtime: string | number | Date, callback: NoParamCallback): void;
+
+    // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
+    export namespace lutimes {
+        /**
+         * Changes the access and modification times of a file in the same way as `fsPromises.utimes()`,
+         * with the difference that if the path refers to a symbolic link, then the link is not
+         * dereferenced: instead, the timestamps of the symbolic link itself are changed.
+         * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
+         * @param atime The last access time. If a string is provided, it will be coerced to number.
+         * @param mtime The last modified time. If a string is provided, it will be coerced to number.
+         */
+        function __promisify__(path: PathLike, atime: string | number | Date, mtime: string | number | Date): Promise<void>;
+    }
+
+    /**
+     * Change the file system timestamps of the symbolic link referenced by `path`. Returns `undefined`,
+     * or throws an exception when parameters are incorrect or the operation fails.
+     * This is the synchronous version of `fs.lutimes()`.
+     * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
+     * @param atime The last access time. If a string is provided, it will be coerced to number.
+     * @param mtime The last modified time. If a string is provided, it will be coerced to number.
+     */
+    export function lutimesSync(path: PathLike, atime: string | number | Date, mtime: string | number | Date): void;
+
     /**
      * Asynchronous chmod(2) - Change permissions of a file.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
@@ -821,31 +854,32 @@ declare module "fs" {
 
     export interface RmDirOptions {
         /**
+         * If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or
+         * `EPERM` error is encountered, Node.js will retry the operation with a linear
+         * backoff wait of `retryDelay` ms longer on each try. This option represents the
+         * number of retries. This option is ignored if the `recursive` option is not
+         * `true`.
+         * @default 0
+         */
+        maxRetries?: number;
+        /**
+         * @deprecated since v14.14.0 In future versions of Node.js,
+         * `fs.rmdir(path, { recursive: true })` will throw on nonexistent
+         * paths, or when given a file as a target.
+         * Use `fs.rm(path, { recursive: true, force: true })` instead.
+         *
          * If `true`, perform a recursive directory removal. In
          * recursive mode, errors are not reported if `path` does not exist, and
          * operations are retried on failure.
-         * @experimental
          * @default false
          */
         recursive?: boolean;
-    }
-
-    export interface RmDirAsyncOptions extends RmDirOptions {
         /**
          * The amount of time in milliseconds to wait between retries.
          * This option is ignored if the `recursive` option is not `true`.
          * @default 100
          */
         retryDelay?: number;
-        /**
-         * If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or
-         * `EPERM` error is encountered, Node.js will retry the operation with a linear
-         * backoff wait of `retryDelay` ms longer on each try. This option represents the
-         * number of retries. This option is ignored if the `recursive` option is not
-         * `true`.
-         * @default 0
-         */
-        maxRetries?: number;
     }
 
     /**
@@ -853,7 +887,7 @@ declare module "fs" {
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      */
     export function rmdir(path: PathLike, callback: NoParamCallback): void;
-    export function rmdir(path: PathLike, options: RmDirAsyncOptions, callback: NoParamCallback): void;
+    export 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.
     export namespace rmdir {
@@ -861,7 +895,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>;
     }
 
     /**
@@ -870,6 +904,55 @@ declare module "fs" {
      */
     export function rmdirSync(path: PathLike, options?: RmDirOptions): void;
 
+    export interface RmOptions {
+        /**
+         * When `true`, exceptions will be ignored if `path` does not exist.
+         * @default false
+         */
+        force?: boolean;
+        /**
+         * If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or
+         * `EPERM` error is encountered, Node.js will retry the operation with a linear
+         * backoff wait of `retryDelay` ms longer on each try. This option represents the
+         * number of retries. This option is ignored if the `recursive` option is not
+         * `true`.
+         * @default 0
+         */
+        maxRetries?: number;
+        /**
+         * If `true`, perform a recursive directory removal. In
+         * recursive mode, errors are not reported if `path` does not exist, and
+         * operations are retried on failure.
+         * @default false
+         */
+        recursive?: boolean;
+        /**
+         * The amount of time in milliseconds to wait between retries.
+         * This option is ignored if the `recursive` option is not `true`.
+         * @default 100
+         */
+        retryDelay?: number;
+    }
+
+    /**
+     * Asynchronously removes files and directories (modeled on the standard POSIX `rm` utility).
+     */
+    export function rm(path: PathLike, callback: NoParamCallback): void;
+    export function rm(path: PathLike, options: RmOptions, callback: NoParamCallback): void;
+
+    // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
+    export namespace rm {
+        /**
+         * Asynchronously removes files and directories (modeled on the standard POSIX `rm` utility).
+         */
+        function __promisify__(path: PathLike, options?: RmOptions): Promise<void>;
+    }
+
+    /**
+     * Synchronously removes files and directories (modeled on the standard POSIX `rm` utility).
+     */
+    export function rmSync(path: PathLike, options?: RmOptions): void;
+
     export interface MakeDirectoryOptions {
         /**
          * Indicates whether parent folders should be created.

node/globals.d.ts

@@ -541,6 +541,7 @@ declare namespace NodeJS {
     interface Timer extends RefCounted {
         hasRef(): boolean;
         refresh(): this;
+        [Symbol.toPrimitive](): number;
     }
 
     interface Immediate extends RefCounted {
@@ -551,6 +552,7 @@ declare namespace NodeJS {
     interface Timeout extends Timer {
         hasRef(): boolean;
         refresh(): this;
+        [Symbol.toPrimitive](): number;
     }
 
     type TypedArray = Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array;

node/http.d.ts

@@ -51,6 +51,11 @@ declare module "http" {
         'range'?: string;
         'referer'?: string;
         'retry-after'?: string;
+        'sec-websocket-accept'?: string;
+        'sec-websocket-extensions'?: string;
+        'sec-websocket-key'?: string;
+        'sec-websocket-protocol'?: string;
+        'sec-websocket-version'?: string;
         'set-cookie'?: string[];
         'strict-transport-security'?: string;
         'tk'?: string;
@@ -65,7 +70,9 @@ declare module "http" {
     }
 
     // outgoing headers allows numbers (as they are converted internally to strings)
-    interface OutgoingHttpHeaders extends NodeJS.Dict<number | string | string[]> {
+    type OutgoingHttpHeader = number | string | string[];
+
+    interface OutgoingHttpHeaders extends NodeJS.Dict<OutgoingHttpHeader> {
     }
 
     interface ClientRequestArgs {
@@ -188,8 +195,8 @@ declare module "http" {
         // https://github.com/nodejs/node/blob/master/test/parallel/test-http-write-callbacks.js#L53
         // no args in writeContinue callback
         writeContinue(callback?: () => void): void;
-        writeHead(statusCode: number, reasonPhrase?: string, headers?: OutgoingHttpHeaders): this;
-        writeHead(statusCode: number, headers?: OutgoingHttpHeaders): this;
+        writeHead(statusCode: number, reasonPhrase?: string, headers?: OutgoingHttpHeaders | OutgoingHttpHeader[]): this;
+        writeHead(statusCode: number, headers?: OutgoingHttpHeaders | OutgoingHttpHeader[]): this;
         writeProcessing(): void;
     }
 
@@ -205,7 +212,9 @@ declare module "http" {
 
     // https://github.com/nodejs/node/blob/master/lib/_http_client.js#L77
     class ClientRequest extends OutgoingMessage {
-        aborted: number;
+        aborted: boolean;
+        host: string;
+        protocol: string;
 
         constructor(url: string | URL | ClientRequestArgs, cb?: (res: IncomingMessage) => void);
 
@@ -370,6 +379,7 @@ declare module "http" {
     class Agent {
         maxFreeSockets: number;
         maxSockets: number;
+        maxTotalSockets: number;
         readonly freeSockets: NodeJS.ReadOnlyDict<Socket[]>;
         readonly sockets: NodeJS.ReadOnlyDict<Socket[]>;
         readonly requests: NodeJS.ReadOnlyDict<IncomingMessage[]>;

node/index.d.ts

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

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "14.11.11",
+    "version": "14.14.3",
     "description": "TypeScript definitions for Node.js",
     "license": "MIT",
     "contributors": [
@@ -246,6 +246,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "c2b0b558a90b2111443786aacee9bd00dccbb5b39a303db22beb1f851fd91469",
+    "typesPublisherContentHash": "37f5583cc940418a85d23a7e11aef2e57552c324b40ea16cd1e1c1afa95adfe0",
     "typeScriptVersion": "3.2"
 }

node/process.d.ts

@@ -271,7 +271,7 @@ declare module "process" {
                 /**
                  * Can only be set if not in worker thread.
                  */
-                umask(mask: number): number;
+                umask(mask: string | number): number;
                 uptime(): number;
                 hrtime: HRTime;
                 domain: Domain;

node/tls.d.ts

@@ -707,12 +707,14 @@ declare module "tls" {
          */
         sessionIdContext?: string;
         /**
-         * 48 bytes of cryptographically strong pseudo-random data.
+         * 48-bytes of cryptographically strong pseudo-random data.
+         * See Session Resumption for more information.
          */
         ticketKeys?: Buffer;
         /**
-         * The number of seconds after which a TLS session created by the server
-         * will no longer be resumable.
+         * The number of seconds after which a TLS session created by the
+         * server will no longer be resumable. See Session Resumption for more
+         * information. Default: 300.
          */
         sessionTimeout?: number;
     }
@@ -738,7 +740,7 @@ declare module "tls" {
      * @deprecated since v0.11.3 Use `tls.TLSSocket` instead.
      */
     function createSecurePair(credentials?: SecureContext, isServer?: boolean, requestCert?: boolean, rejectUnauthorized?: boolean): SecurePair;
-    function createSecureContext(details: SecureContextOptions): SecureContext;
+    function createSecureContext(options?: SecureContextOptions): SecureContext;
     function getCiphers(): string[];
 
     /**

node/zlib.d.ts

@@ -1,3 +1,4 @@
+/* tslint:enable: unified-signatures */
 declare module "zlib" {
     import * as stream from "stream";
 
@@ -51,7 +52,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 {
@@ -88,69 +90,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;
@@ -228,165 +237,126 @@ declare module "zlib" {
         const INFLATERAW: number;
         const UNZIP: number;
 
-        const Z_BEST_COMPRESSION: number;
-        const Z_BEST_SPEED: number;
+        // Allowed flush values.
+        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;
+
+        // Return codes for the compression/decompression functions.
+        // Negative values are errors, positive values are used for special but normal events.
+        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;
+        // Compression levels.
+        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;
+        // Compression strategy.
         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;
 }