@types/node 14.18.9 → 15.0.0

node v14.18/module.d.ts → node/module.d.ts

@@ -1,5 +1,10 @@
+declare module 'node:module' {
+    import Module = require('module');
+    export = Module;
+}
+
 declare module 'module' {
-    import { URL } from 'url';
+    import { URL } from 'node:url';
     namespace Module {
         /**
          * Updates all the live bindings for builtin ES Modules to match the properties of the CommonJS exports.
@@ -50,7 +55,3 @@ declare module 'module' {
     }
     export = Module;
 }
-declare module 'node:module' {
-    import module = require('module');
-    export = module;
-}

node v14.18/net.d.ts → node/net.d.ts

@@ -1,7 +1,11 @@
+declare module 'node:net' {
+    export * from 'net';
+}
+
 declare module 'net' {
-    import * as stream from 'stream';
-    import EventEmitter = require('events');
-    import * as dns from 'dns';
+    import * as stream from 'node:stream';
+    import EventEmitter = require('node:events');
+    import * as dns from 'node:dns';
 
     type LookupFunction = (
         hostname: string,
@@ -16,10 +20,10 @@ declare module 'net' {
     }
 
     interface SocketConstructorOpts {
-        fd?: number | undefined;
-        allowHalfOpen?: boolean | undefined;
-        readable?: boolean | undefined;
-        writable?: boolean | undefined;
+        fd?: number;
+        allowHalfOpen?: boolean;
+        readable?: boolean;
+        writable?: boolean;
     }
 
     interface OnReadOpts {
@@ -38,17 +42,17 @@ declare module 'net' {
          * Note: this will cause the streaming functionality to not provide any data, however events like 'error', 'end', and 'close' will
          * still be emitted as normal and methods like pause() and resume() will also behave as expected.
          */
-        onread?: OnReadOpts | undefined;
+        onread?: OnReadOpts;
     }
 
     interface TcpSocketConnectOpts extends ConnectOpts {
         port: number;
-        host?: string | undefined;
-        localAddress?: string | undefined;
-        localPort?: number | undefined;
-        hints?: number | undefined;
-        family?: number | undefined;
-        lookup?: LookupFunction | undefined;
+        host?: string;
+        localAddress?: string;
+        localPort?: number;
+        hints?: number;
+        family?: number;
+        lookup?: LookupFunction;
     }
 
     interface IpcSocketConnectOpts extends ConnectOpts {
@@ -87,14 +91,14 @@ declare module 'net' {
         readonly destroyed: boolean;
         readonly localAddress: string;
         readonly localPort: number;
-        readonly remoteAddress?: string | undefined;
-        readonly remoteFamily?: string | undefined;
-        readonly remotePort?: number | undefined;
+        readonly remoteAddress?: string;
+        readonly remoteFamily?: string;
+        readonly remotePort?: number;
 
         // Extended base methods
-        end(cb?: () => void): this;
-        end(buffer: Uint8Array | string, cb?: () => void): this;
-        end(str: Uint8Array | string, encoding?: BufferEncoding, cb?: () => void): this;
+        end(cb?: () => void): void;
+        end(buffer: Uint8Array | string, cb?: () => void): void;
+        end(str: Uint8Array | string, encoding?: BufferEncoding, cb?: () => void): void;
 
         /**
          * events.EventEmitter
@@ -115,7 +119,6 @@ declare module 'net' {
         addListener(event: "end", listener: () => void): this;
         addListener(event: "error", listener: (err: Error) => void): this;
         addListener(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this;
-        addListener(event: "ready", listener: () => void): this;
         addListener(event: "timeout", listener: () => void): this;
 
         emit(event: string | symbol, ...args: any[]): boolean;
@@ -126,7 +129,6 @@ declare module 'net' {
         emit(event: "end"): boolean;
         emit(event: "error", err: Error): boolean;
         emit(event: "lookup", err: Error, address: string, family: string | number, host: string): boolean;
-        emit(event: "ready"): boolean;
         emit(event: "timeout"): boolean;
 
         on(event: string, listener: (...args: any[]) => void): this;
@@ -137,7 +139,6 @@ declare module 'net' {
         on(event: "end", listener: () => void): this;
         on(event: "error", listener: (err: Error) => void): this;
         on(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this;
-        on(event: "ready", listener: () => void): this;
         on(event: "timeout", listener: () => void): this;
 
         once(event: string, listener: (...args: any[]) => void): this;
@@ -148,7 +149,6 @@ declare module 'net' {
         once(event: "end", listener: () => void): this;
         once(event: "error", listener: (err: Error) => void): this;
         once(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this;
-        once(event: "ready", listener: () => void): this;
         once(event: "timeout", listener: () => void): this;
 
         prependListener(event: string, listener: (...args: any[]) => void): this;
@@ -159,7 +159,6 @@ declare module 'net' {
         prependListener(event: "end", listener: () => void): this;
         prependListener(event: "error", listener: (err: Error) => void): this;
         prependListener(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this;
-        prependListener(event: "ready", listener: () => void): this;
         prependListener(event: "timeout", listener: () => void): this;
 
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
@@ -170,36 +169,33 @@ declare module 'net' {
         prependOnceListener(event: "end", listener: () => void): this;
         prependOnceListener(event: "error", listener: (err: Error) => void): this;
         prependOnceListener(event: "lookup", listener: (err: Error, address: string, family: string | number, host: string) => void): this;
-        prependOnceListener(event: "ready", listener: () => void): this;
         prependOnceListener(event: "timeout", listener: () => void): this;
     }
 
     interface ListenOptions {
-        port?: number | undefined;
-        host?: string | undefined;
-        backlog?: number | undefined;
-        path?: string | undefined;
-        exclusive?: boolean | undefined;
-        readableAll?: boolean | undefined;
-        writableAll?: boolean | undefined;
+        port?: number;
+        host?: string;
+        backlog?: number;
+        path?: string;
+        exclusive?: boolean;
+        readableAll?: boolean;
+        writableAll?: boolean;
         /**
          * @default false
          */
-        ipv6Only?: boolean | undefined;
+        ipv6Only?: boolean;
     }
 
     interface ServerOpts {
         /**
-         * Indicates whether half-opened TCP connections are allowed.
-         * @default false
+         * Indicates whether half-opened TCP connections are allowed. __Default:__ `false`.
          */
-        allowHalfOpen?: boolean | undefined;
+        allowHalfOpen?: boolean;
 
         /**
-         * Indicates whether the socket should be paused on incoming connections.
-         * @default false
+         * Indicates whether the socket should be paused on incoming connections. __Default:__ `false`.
          */
-        pauseOnConnect?: boolean | undefined;
+        pauseOnConnect?: boolean;
     }
 
     // https://github.com/nodejs/node/blob/master/lib/net.js
@@ -269,12 +265,51 @@ declare module 'net' {
         prependOnceListener(event: "listening", listener: () => void): this;
     }
 
+    type IPVersion = 'ipv4' | 'ipv6';
+
+    class BlockList {
+        /**
+         * Adds a rule to block the given IP address.
+         *
+         * @param address An IPv4 or IPv6 address.
+         * @param type Either 'ipv4' or 'ipv6'. Default: 'ipv4'.
+         */
+        addAddress(address: string, type?: IPVersion): void;
+
+        /**
+         * Adds a rule to block a range of IP addresses from start (inclusive) to end (inclusive).
+         *
+         * @param start The starting IPv4 or IPv6 address in the range.
+         * @param end The ending IPv4 or IPv6 address in the range.
+         * @param type Either 'ipv4' or 'ipv6'. Default: 'ipv4'.
+         */
+        addRange(start: string, end: string, type?: IPVersion): void;
+
+        /**
+         * Adds a rule to block a range of IP addresses specified as a subnet mask.
+         *
+         * @param net The network IPv4 or IPv6 address.
+         * @param prefix The number of CIDR prefix bits.
+         * For IPv4, this must be a value between 0 and 32. For IPv6, this must be between 0 and 128.
+         * @param type Either 'ipv4' or 'ipv6'. Default: 'ipv4'.
+         */
+        addSubnet(net: string, prefix: number, type?: IPVersion): void;
+
+        /**
+         * Returns `true` if the given IP address matches any of the rules added to the `BlockList`.
+         *
+         * @param address The IP address to check
+         * @param type Either 'ipv4' or 'ipv6'. Default: 'ipv4'.
+         */
+        check(address: string, type?: IPVersion): boolean;
+    }
+
     interface TcpNetConnectOpts extends TcpSocketConnectOpts, SocketConstructorOpts {
-        timeout?: number | undefined;
+        timeout?: number;
     }
 
     interface IpcNetConnectOpts extends IpcSocketConnectOpts, SocketConstructorOpts {
-        timeout?: number | undefined;
+        timeout?: number;
     }
 
     type NetConnectOpts = TcpNetConnectOpts | IpcNetConnectOpts;
@@ -291,6 +326,3 @@ declare module 'net' {
     function isIPv4(input: string): boolean;
     function isIPv6(input: string): boolean;
 }
-declare module 'node:net' {
-    export * from 'net';
-}

node v14.18/os.d.ts → node/os.d.ts

@@ -1,3 +1,7 @@
+declare module 'node:os' {
+    export * from 'os';
+}
+
 declare module 'os' {
     interface CpuInfo {
         model: string;
@@ -237,6 +241,3 @@ declare module 'os' {
      */
     function setPriority(pid: number, priority: number): void;
 }
-declare module 'node:os' {
-    export * from 'os';
-}

node v14.18/package.json → node/package.json

@@ -1,8 +1,7 @@
 {
     "name": "@types/node",
-    "version": "14.18.9",
+    "version": "15.0.0",
     "description": "TypeScript definitions for Node.js",
-    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
     "contributors": [
         {
@@ -35,6 +34,11 @@
             "url": "https://github.com/btoueg",
             "githubUsername": "btoueg"
         },
+        {
+            "name": "Bruno Scheufler",
+            "url": "https://github.com/brunoscheufler",
+            "githubUsername": "brunoscheufler"
+        },
         {
             "name": "Chigozirim C.",
             "url": "https://github.com/smac89",
@@ -115,11 +119,6 @@
             "url": "https://github.com/eps1lon",
             "githubUsername": "eps1lon"
         },
-        {
-            "name": "Seth Westphal",
-            "url": "https://github.com/westy92",
-            "githubUsername": "westy92"
-        },
         {
             "name": "Simon Schick",
             "url": "https://github.com/SimonSchick",
@@ -165,6 +164,11 @@
             "url": "https://github.com/trivikr",
             "githubUsername": "trivikr"
         },
+        {
+            "name": "Minh Son Nguyen",
+            "url": "https://github.com/nguymin4",
+            "githubUsername": "nguymin4"
+        },
         {
             "name": "Junxiao Shi",
             "url": "https://github.com/yoursunny",
@@ -180,6 +184,11 @@
             "url": "https://github.com/ExE-Boss",
             "githubUsername": "ExE-Boss"
         },
+        {
+            "name": "Surasak Chaisurin",
+            "url": "https://github.com/Ryan-Willpower",
+            "githubUsername": "Ryan-Willpower"
+        },
         {
             "name": "Piotr Błażejewicz",
             "url": "https://github.com/peterblazejewicz",
@@ -190,6 +199,11 @@
             "url": "https://github.com/addaleax",
             "githubUsername": "addaleax"
         },
+        {
+            "name": "Jason Kwok",
+            "url": "https://github.com/JasonHK",
+            "githubUsername": "JasonHK"
+        },
         {
             "name": "Victor Perin",
             "url": "https://github.com/victorperin",
@@ -199,20 +213,17 @@
             "name": "Yongsheng Zhang",
             "url": "https://github.com/ZYSzys",
             "githubUsername": "ZYSzys"
-        },
-        {
-            "name": "Bond",
-            "url": "https://github.com/bondz",
-            "githubUsername": "bondz"
-        },
-        {
-            "name": "Linus Unnebäck",
-            "url": "https://github.com/LinusU",
-            "githubUsername": "LinusU"
         }
     ],
     "main": "",
     "types": "index.d.ts",
+    "typesVersions": {
+        "<=3.6": {
+            "*": [
+                "ts3.6/*"
+            ]
+        }
+    },
     "repository": {
         "type": "git",
         "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git",
@@ -220,6 +231,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "68390c0584f2fc1d1864ae913ab761058bae9ea9aec1dd34a2978d2675a6c31e",
-    "typeScriptVersion": "3.8"
+    "typesPublisherContentHash": "15950df262efcf8b9198c4f5e248ae770f5a72087f8e2ba8158795b58907b6c4",
+    "typeScriptVersion": "3.5"
 }

node v14.18/path.d.ts → node/path.d.ts

@@ -1,3 +1,8 @@
+declare module 'node:path' {
+    import path = require('path');
+    export = path;
+}
+
 declare module 'path' {
     namespace path {
         /**
@@ -30,23 +35,23 @@ declare module 'path' {
             /**
              * The root of the path such as '/' or 'c:\'
              */
-            root?: string | undefined;
+            root?: string;
             /**
              * The full directory path such as '/home/user/dir' or 'c:\path\dir'
              */
-            dir?: string | undefined;
+            dir?: string;
             /**
              * The file name including extension (if any) such as 'index.html'
              */
-            base?: string | undefined;
+            base?: string;
             /**
              * The file extension (if any) such as '.html'
              */
-            ext?: string | undefined;
+            ext?: string;
             /**
              * The file name without extension (if any) such as 'index'
              */
-            name?: string | undefined;
+            name?: string;
         }
 
         interface PlatformPath {
@@ -151,7 +156,3 @@ declare module 'path' {
     const path: path.PlatformPath;
     export = path;
 }
-declare module 'node:path' {
-    import path = require('path');
-    export = path;
-}

node v14.18/perf_hooks.d.ts → node/perf_hooks.d.ts

@@ -1,5 +1,9 @@
+declare module 'node:perf_hooks' {
+    export * from 'perf_hooks';
+}
+
 declare module 'perf_hooks' {
-    import { AsyncResource } from 'async_hooks';
+    import { AsyncResource } from 'node:async_hooks';
 
     type EntryType = 'node' | 'mark' | 'measure' | 'gc' | 'function' | 'http2' | 'http';
 
@@ -31,14 +35,14 @@ declare module 'perf_hooks' {
          * the type of garbage collection operation that occurred.
          * See perf_hooks.constants for valid values.
          */
-        readonly kind?: number | undefined;
+        readonly kind?: number;
 
         /**
          * When `performanceEntry.entryType` is equal to 'gc', the `performance.flags`
          * property contains additional information about garbage collection operation.
          * See perf_hooks.constants for valid values.
          */
-        readonly flags?: number | undefined;
+        readonly flags?: number;
     }
 
     interface PerformanceNodeTiming extends PerformanceEntry {
@@ -116,7 +120,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.
@@ -186,7 +190,7 @@ declare module 'perf_hooks' {
          * Property buffered defaults to false.
          * @param options
          */
-        observe(options: { entryTypes: ReadonlyArray<EntryType>; buffered?: boolean | undefined }): void;
+        observe(options: { entryTypes: ReadonlyArray<EntryType>; buffered?: boolean }): void;
     }
 
     namespace constants {
@@ -212,7 +216,7 @@ declare module 'perf_hooks' {
          * Must be greater than zero.
          * @default 10
          */
-        resolution?: number | undefined;
+        resolution?: number;
     }
 
     interface EventLoopDelayMonitor {
@@ -269,6 +273,3 @@ declare module 'perf_hooks' {
 
     function monitorEventLoopDelay(options?: EventLoopMonitorOptions): EventLoopDelayMonitor;
 }
-declare module 'node:perf_hooks' {
-    export * from 'perf_hooks';
-}

node v14.18/process.d.ts → node/process.d.ts

@@ -1,5 +1,9 @@
+declare module 'node:process' {
+    export = process;
+}
+
 declare module 'process' {
-    import * as tty from 'tty';
+    import * as tty from 'node:tty';
 
     global {
         var process: NodeJS.Process;
@@ -26,10 +30,10 @@ declare module 'process' {
 
             interface ProcessRelease {
                 name: string;
-                sourceUrl?: string | undefined;
-                headersUrl?: string | undefined;
-                libUrl?: string | undefined;
-                lts?: string | undefined;
+                sourceUrl?: string;
+                headersUrl?: string;
+                libUrl?: string;
+                lts?: string;
             }
 
             interface ProcessVersions extends Dict<string> {
@@ -60,14 +64,13 @@ declare module 'process' {
                 "SIGSTOP" | "SIGSYS" | "SIGTERM" | "SIGTRAP" | "SIGTSTP" | "SIGTTIN" | "SIGTTOU" | "SIGUNUSED" | "SIGURG" |
                 "SIGUSR1" | "SIGUSR2" | "SIGVTALRM" | "SIGWINCH" | "SIGXCPU" | "SIGXFSZ" | "SIGBREAK" | "SIGLOST" | "SIGINFO";
 
-            type UncaughtExceptionOrigin = 'uncaughtException' | 'unhandledRejection';
             type MultipleResolveType = 'resolve' | 'reject';
 
             type BeforeExitListener = (code: number) => void;
             type DisconnectListener = () => void;
             type ExitListener = (code: number) => void;
             type RejectionHandledListener = (promise: Promise<any>) => void;
-            type UncaughtExceptionListener = (error: Error, origin: UncaughtExceptionOrigin) => void;
+            type UncaughtExceptionListener = (error: Error) => void;
             type UnhandledRejectionListener = (reason: {} | null | undefined, promise: Promise<any>) => void;
             type WarningListener = (warning: Error) => void;
             type MessageListener = (message: any, sendHandle: any) => void;
@@ -77,7 +80,7 @@ declare module 'process' {
             type MultipleResolveListener = (type: MultipleResolveType, promise: Promise<any>, value: any) => void;
 
             interface Socket extends ReadWriteStream {
-                isTTY?: true | undefined;
+                isTTY?: true;
             }
 
             // Alias for compatibility
@@ -120,7 +123,7 @@ declare module 'process' {
                 /**
                  * If true, a diagnostic report is generated when the process
                  * receives the signal specified by process.report.signal.
-                 * @default false
+                 * @defaul false
                  */
                 reportOnSignal: boolean;
 
@@ -172,6 +175,32 @@ declare module 'process' {
                 voluntaryContextSwitches: number;
             }
 
+            interface EmitWarningOptions {
+                /**
+                 * When `warning` is a `string`, `type` is the name to use for the _type_ of warning being emitted.
+                 *
+                 * @default 'Warning'
+                 */
+                type?: string;
+
+                /**
+                 * A unique identifier for the warning instance being emitted.
+                 */
+                code?: string;
+
+                /**
+                 * When `warning` is a `string`, `ctor` is an optional function used to limit the generated stack trace.
+                 *
+                 * @default process.emitWarning
+                 */
+                ctor?: Function;
+
+                /**
+                 * Additional text to include with the error.
+                 */
+                detail?: string;
+            }
+
             interface Process extends EventEmitter {
                 /**
                  * Can also be a tty.WriteStream, not typed due to limitations.
@@ -197,10 +226,25 @@ declare module 'process' {
                 chdir(directory: string): void;
                 cwd(): string;
                 debugPort: number;
-                emitWarning(warning: string | Error, name?: string, ctor?: Function): void;
+
+                /**
+                 * The `process.emitWarning()` method can be used to emit custom or application specific process warnings.
+                 *
+                 * These can be listened for by adding a handler to the `'warning'` event.
+                 *
+                 * @param warning The warning to emit.
+                 * @param type When `warning` is a `string`, `type` is the name to use for the _type_ of warning being emitted. Default: `'Warning'`.
+                 * @param code A unique identifier for the warning instance being emitted.
+                 * @param ctor When `warning` is a `string`, `ctor` is an optional function used to limit the generated stack trace. Default: `process.emitWarning`.
+                 */
+                emitWarning(warning: string | Error, ctor?: Function): void;
+                emitWarning(warning: string | Error, type?: string, ctor?: Function): void;
+                emitWarning(warning: string | Error, type?: string, code?: string, ctor?: Function): void;
+                emitWarning(warning: string | Error, options?: EmitWarningOptions): void;
+
                 env: ProcessEnv;
                 exit(code?: number): never;
-                exitCode?: number | undefined;
+                exitCode?: number;
                 getgid(): number;
                 setgid(id: number | string): void;
                 getuid(): number;
@@ -248,7 +292,7 @@ declare module 'process' {
                 arch: string;
                 platform: Platform;
                 /** @deprecated since v14.0.0 - use `require.main` instead. */
-                mainModule?: Module | undefined;
+                mainModule?: Module;
                 memoryUsage(): MemoryUsage;
                 cpuUsage(previousValue?: CpuUsage): CpuUsage;
                 nextTick(callback: Function, ...args: any[]): void;
@@ -278,7 +322,7 @@ declare module 'process' {
                 domain: Domain;
 
                 // Worker
-                send?(message: any, sendHandle?: any, options?: { swallowErrors?: boolean | undefined}, callback?: (error: Error | null) => void): boolean;
+                send?(message: any, sendHandle?: any, options?: { swallowErrors?: boolean}, callback?: (error: Error | null) => void): boolean;
                 disconnect(): void;
                 connected: boolean;
 
@@ -292,7 +336,7 @@ declare module 'process' {
                 /**
                  * Only available with `--experimental-report`
                  */
-                report?: ProcessReport | undefined;
+                report?: ProcessReport;
 
                 resourceUsage(): ResourceUsage;
 
@@ -407,7 +451,3 @@ declare module 'process' {
 
     export = process;
 }
-declare module 'node:process' {
-    import process = require('process');
-    export = process;
-}

node v14.18/punycode.d.ts → node/punycode.d.ts

@@ -1,3 +1,14 @@
+/**
+ * @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.
+ */
+declare module 'node:punycode' {
+    export * from 'punycode';
+}
+
 /**
  * @deprecated since v7.0.0
  * The version of the punycode module bundled in Node.js is being deprecated.
@@ -73,6 +84,3 @@ declare module 'punycode' {
      */
     const version: string;
 }
-declare module 'node:punycode' {
-    export * from 'punycode';
-}

node v14.18/querystring.d.ts → node/querystring.d.ts

@@ -1,11 +1,15 @@
+declare module 'node:querystring' {
+    export * from 'querystring';
+}
+
 declare module 'querystring' {
     interface StringifyOptions {
-        encodeURIComponent?: ((str: string) => string) | undefined;
+        encodeURIComponent?: (str: string) => string;
     }
 
     interface ParseOptions {
-        maxKeys?: number | undefined;
-        decodeURIComponent?: ((str: string) => string) | undefined;
+        maxKeys?: number;
+        decodeURIComponent?: (str: string) => string;
     }
 
     interface ParsedUrlQuery extends NodeJS.Dict<string | string[]> { }
@@ -26,6 +30,3 @@ declare module 'querystring' {
     function escape(str: string): string;
     function unescape(str: string): string;
 }
-declare module 'node:querystring' {
-    export * from 'querystring';
-}