@types/node 20.19.25 → 24.10.3

{node v20.19 → node v24.10}/net.d.ts

@@ -10,7 +10,7 @@
  * ```js
  * import net from 'node:net';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/net.js)
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/net.js)
  */
 declare module "net" {
     import { NonSharedBuffer } from "node:buffer";
@@ -30,6 +30,7 @@ declare module "net" {
     interface SocketConstructorOpts {
         fd?: number | undefined;
         allowHalfOpen?: boolean | undefined;
+        onread?: OnReadOpts | undefined;
         readable?: boolean | undefined;
         writable?: boolean | undefined;
         signal?: AbortSignal | undefined;
@@ -38,20 +39,12 @@ declare module "net" {
         buffer: Uint8Array | (() => Uint8Array);
         /**
          * This function is called for every chunk of incoming data.
-         * Two arguments are passed to it: the number of bytes written to buffer and a reference to buffer.
-         * Return false from this function to implicitly pause() the socket.
+         * Two arguments are passed to it: the number of bytes written to `buffer` and a reference to `buffer`.
+         * Return `false` from this function to implicitly `pause()` the socket.
          */
-        callback(bytesWritten: number, buf: Uint8Array): boolean;
+        callback(bytesWritten: number, buffer: Uint8Array): boolean;
     }
-    interface ConnectOpts {
-        /**
-         * If specified, incoming data is stored in a single buffer and passed to the supplied callback when data arrives on the socket.
-         * 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;
-    }
-    interface TcpSocketConnectOpts extends ConnectOpts {
+    interface TcpSocketConnectOpts {
         port: number;
         host?: string | undefined;
         localAddress?: string | undefined;
@@ -70,8 +63,9 @@ declare module "net" {
          * @since v18.13.0
          */
         autoSelectFamilyAttemptTimeout?: number | undefined;
+        blockList?: BlockList | undefined;
     }
-    interface IpcSocketConnectOpts extends ConnectOpts {
+    interface IpcSocketConnectOpts {
         path: string;
     }
     type SocketConnectOpts = TcpSocketConnectOpts | IpcSocketConnectOpts;
@@ -497,17 +491,18 @@ declare module "net" {
         prependOnceListener(event: "timeout", listener: () => void): this;
     }
     interface ListenOptions extends Abortable {
-        port?: number | undefined;
-        host?: string | undefined;
         backlog?: number | undefined;
-        path?: string | undefined;
         exclusive?: boolean | undefined;
-        readableAll?: boolean | undefined;
-        writableAll?: boolean | undefined;
+        host?: string | undefined;
         /**
          * @default false
          */
         ipv6Only?: boolean | undefined;
+        reusePort?: boolean | undefined;
+        path?: string | undefined;
+        port?: number | undefined;
+        readableAll?: boolean | undefined;
+        writableAll?: boolean | undefined;
     }
     interface ServerOpts {
         /**
@@ -541,10 +536,19 @@ declare module "net" {
         keepAliveInitialDelay?: number | undefined;
         /**
          * Optionally overrides all `net.Socket`s' `readableHighWaterMark` and `writableHighWaterMark`.
-         * @default See [stream.getDefaultHighWaterMark()](https://nodejs.org/docs/latest-v20.x/api/stream.html#streamgetdefaulthighwatermarkobjectmode).
+         * @default See [stream.getDefaultHighWaterMark()](https://nodejs.org/docs/latest-v24.x/api/stream.html#streamgetdefaulthighwatermarkobjectmode).
          * @since v18.17.0, v20.1.0
          */
         highWaterMark?: number | undefined;
+        /**
+         * `blockList` can be used for disabling inbound
+         * access to specific IP addresses, IP ranges, or IP subnets. This does not
+         * work if the server is behind a reverse proxy, NAT, etc. because the address
+         * checked against the block list is the address of the proxy, or the one
+         * specified by the NAT.
+         * @since v22.13.0
+         */
+        blockList?: BlockList | undefined;
     }
     interface DropArgument {
         localAddress?: string;
@@ -796,6 +800,33 @@ declare module "net" {
          * @since v15.0.0, v14.18.0
          */
         rules: readonly string[];
+        /**
+         * Returns `true` if the `value` is a `net.BlockList`.
+         * @since v22.13.0
+         * @param value Any JS value
+         */
+        static isBlockList(value: unknown): value is BlockList;
+        /**
+         * ```js
+         * const blockList = new net.BlockList();
+         * const data = [
+         *   'Subnet: IPv4 192.168.1.0/24',
+         *   'Address: IPv4 10.0.0.5',
+         *   'Range: IPv4 192.168.2.1-192.168.2.10',
+         *   'Range: IPv4 10.0.0.1-10.0.0.10',
+         * ];
+         * blockList.fromJSON(data);
+         * blockList.fromJSON(JSON.stringify(data));
+         * ```
+         * @since v24.5.0
+         * @experimental
+         */
+        fromJSON(data: string | readonly string[]): void;
+        /**
+         * @since v24.5.0
+         * @experimental
+         */
+        toJSON(): readonly string[];
     }
     interface TcpNetConnectOpts extends TcpSocketConnectOpts, SocketConstructorOpts {
         timeout?: number | undefined;
@@ -907,6 +938,9 @@ declare module "net" {
     function getDefaultAutoSelectFamily(): boolean;
     /**
      * Sets the default value of the `autoSelectFamily` option of `socket.connect(options)`.
+     * @param value The new default value.
+     * The initial default value is `true`, unless the command line option
+     * `--no-network-family-autoselection` is provided.
      * @since v19.4.0
      */
     function setDefaultAutoSelectFamily(value: boolean): void;
@@ -1005,6 +1039,14 @@ declare module "net" {
          * @since v15.14.0, v14.18.0
          */
         readonly flowlabel: number;
+        /**
+         * @since v22.13.0
+         * @param input An input string containing an IP address and optional port,
+         * e.g. `123.1.2.3:1234` or `[1::1]:1234`.
+         * @returns Returns a `SocketAddress` if parsing was successful.
+         * Otherwise returns `undefined`.
+         */
+        static parse(input: string): SocketAddress | undefined;
     }
 }
 declare module "node:net" {

{node v20.19 → node v24.10}/os.d.ts

@@ -5,7 +5,7 @@
  * ```js
  * import os from 'node:os';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/os.js)
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/os.js)
  */
 declare module "os" {
     import { NonSharedBuffer } from "buffer";
@@ -251,7 +251,7 @@ declare module "os" {
      * environment variables for the home directory before falling back to the
      * operating system response.
      *
-     * Throws a [`SystemError`](https://nodejs.org/docs/latest-v20.x/api/errors.html#class-systemerror) if a user has no `username` or `homedir`.
+     * Throws a [`SystemError`](https://nodejs.org/docs/latest-v24.x/api/errors.html#class-systemerror) if a user has no `username` or `homedir`.
      * @since v6.0.0
      */
     function userInfo(options?: UserInfoOptionsWithStringEncoding): UserInfo<string>;
@@ -428,13 +428,13 @@ declare module "os" {
     const EOL: string;
     /**
      * Returns the operating system CPU architecture for which the Node.js binary was
-     * compiled. Possible values are `'arm'`, `'arm64'`, `'ia32'`, `'loong64'`, `'mips'`, `'mipsel'`, `'ppc'`, `'ppc64'`, `'riscv64'`, `'s390'`, `'s390x'`,
-     * and `'x64'`.
+     * compiled. Possible values are `'arm'`, `'arm64'`, `'ia32'`, `'loong64'`,
+     * `'mips'`, `'mipsel'`, `'ppc64'`, `'riscv64'`, `'s390x'`, and `'x64'`.
      *
-     * The return value is equivalent to [process.arch](https://nodejs.org/docs/latest-v20.x/api/process.html#processarch).
+     * The return value is equivalent to [process.arch](https://nodejs.org/docs/latest-v24.x/api/process.html#processarch).
      * @since v0.5.0
      */
-    function arch(): string;
+    function arch(): NodeJS.Architecture;
     /**
      * Returns a string identifying the kernel version.
      *
@@ -456,7 +456,8 @@ declare module "os" {
      */
     function platform(): NodeJS.Platform;
     /**
-     * Returns the machine type as a string, such as `arm`, `arm64`, `aarch64`, `mips`, `mips64`, `ppc64`, `ppc64le`, `s390`, `s390x`, `i386`, `i686`, `x86_64`.
+     * Returns the machine type as a string, such as `arm`, `arm64`, `aarch64`,
+     * `mips`, `mips64`, `ppc64`, `ppc64le`, `s390x`, `i386`, `i686`, `x86_64`.
      *
      * On POSIX systems, the machine type is determined by calling [`uname(3)`](https://linux.die.net/man/3/uname). On Windows, `RtlGetVersion()` is used, and if it is not
      * available, `GetVersionExW()` will be used. See [https://en.wikipedia.org/wiki/Uname#Examples](https://en.wikipedia.org/wiki/Uname#Examples) for more information.

{node v20.19 → node v24.10}/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "20.19.25",
+    "version": "24.10.3",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -114,6 +114,16 @@
             "name": "Dmitry Semigradsky",
             "githubUsername": "Semigradsky",
             "url": "https://github.com/Semigradsky"
+        },
+        {
+            "name": "René",
+            "githubUsername": "Renegade334",
+            "url": "https://github.com/Renegade334"
+        },
+        {
+            "name": "Yagiz Nizipli",
+            "githubUsername": "anonrig",
+            "url": "https://github.com/anonrig"
         }
     ],
     "main": "",
@@ -123,6 +133,11 @@
             "*": [
                 "ts5.6/*"
             ]
+        },
+        "<=5.7": {
+            "*": [
+                "ts5.7/*"
+            ]
         }
     },
     "repository": {
@@ -132,9 +147,9 @@
     },
     "scripts": {},
     "dependencies": {
-        "undici-types": "~6.21.0"
+        "undici-types": "~7.16.0"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "0ec557ab7cdbdee76964ef84ff1599c64e255facd49d8e83135e9183115ebc00",
+    "typesPublisherContentHash": "c1d0bd77a7979f7f1dab093518030acae3864ba1c2342b773d235a8a921ac6e0",
     "typeScriptVersion": "5.2"
 }

{node v20.19 → node v24.10}/path.d.ts

@@ -13,7 +13,7 @@ declare module "path/win32" {
  * ```js
  * import path from 'node:path';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/path.js)
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/path.js)
  */
 declare module "path" {
     namespace path {
@@ -67,7 +67,7 @@ declare module "path" {
         interface PlatformPath {
             /**
              * Normalize a string path, reducing '..' and '.' parts.
-             * When multiple slashes are found, they're replaced by a single one; when the path contains a trailing slash, it is preserved. On Windows backslashes are used.
+             * When multiple slashes are found, they're replaced by a single one; when the path contains a trailing slash, it is preserved. On Windows backslashes are used. If the path is a zero-length string, '.' is returned, representing the current working directory.
              *
              * @param path string path to normalize.
              * @throws {TypeError} if `path` is not a string.
@@ -100,7 +100,7 @@ declare module "path" {
              * @param pattern The glob to check the path against.
              * @returns Whether or not the `path` matched the `pattern`.
              * @throws {TypeError} if `path` or `pattern` are not strings.
-             * @since v20.17.0
+             * @since v22.5.0
              */
             matchesGlob(path: string, pattern: string): boolean;
             /**

{node v20.19 → node v24.10}/perf_hooks.d.ts

@@ -27,7 +27,7 @@
  *   performance.measure('A to B', 'A', 'B');
  * });
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/perf_hooks.js)
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/perf_hooks.js)
  */
 declare module "perf_hooks" {
     import { AsyncResource } from "node:async_hooks";
@@ -136,6 +136,7 @@ declare module "perf_hooks" {
      * @since v8.5.0
      */
     class PerformanceNodeTiming extends PerformanceEntry {
+        readonly entryType: "node";
         /**
          * The high resolution millisecond timestamp at which the Node.js process
          * completed bootstrapping. If bootstrapping has not yet finished, the property
@@ -184,7 +185,7 @@ declare module "perf_hooks" {
          * It is recommended to use this property inside a function whose execution was
          * scheduled using `setImmediate` to avoid collecting metrics before finishing all
          * operations scheduled during the current loop iteration.
-         * @since v20.18.0
+         * @since v22.8.0, v20.18.0
          */
         readonly uvMetricsInfo: UVMetrics;
         /**
@@ -311,6 +312,9 @@ declare module "perf_hooks" {
          * @param initiatorType The initiator name, e.g: 'fetch'
          * @param global
          * @param cacheMode The cache mode must be an empty string ('') or 'local'
+         * @param bodyInfo [Fetch Response Body Info](https://fetch.spec.whatwg.org/#response-body-info)
+         * @param responseStatus The response's status code
+         * @param deliveryType The delivery type. Default: ''.
          * @since v18.2.0, v16.17.0
          */
         markResourceTiming(
@@ -319,6 +323,9 @@ declare module "perf_hooks" {
             initiatorType: string,
             global: object,
             cacheMode: "" | "local",
+            bodyInfo: object,
+            responseStatus: number,
+            deliveryType?: string,
         ): PerformanceResourceTiming;
         /**
          * Creates a new PerformanceMeasure entry in the Performance Timeline.
@@ -804,6 +811,20 @@ declare module "perf_hooks" {
          * @since v11.10.0
          */
         disable(): boolean;
+        /**
+         * Disables the update interval timer when the histogram is disposed.
+         *
+         * ```js
+         * const { monitorEventLoopDelay } = require('node:perf_hooks');
+         * {
+         *   using hist = monitorEventLoopDelay({ resolution: 20 });
+         *   hist.enable();
+         *   // The histogram will be disabled when the block is exited.
+         * }
+         * ```
+         * @since v24.2.0
+         */
+        [Symbol.dispose](): void;
     }
     interface RecordableHistogram extends Histogram {
         /**
@@ -885,8 +906,8 @@ declare module "perf_hooks" {
     } from "perf_hooks";
     global {
         /**
-         * `PerformanceEntry` is a global reference for `import { PerformanceEntry } from 'node:node:perf_hooks'`
-         * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceentry
+         * `PerformanceEntry` is a global reference for `import { PerformanceEntry } from 'node:perf_hooks'`
+         * @see https://nodejs.org/docs/latest-v24.x/api/globals.html#performanceentry
          * @since v19.0.0
          */
         var PerformanceEntry: typeof globalThis extends {
@@ -895,8 +916,8 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceEntry;
         /**
-         * `PerformanceMark` is a global reference for `import { PerformanceMark } from 'node:node:perf_hooks'`
-         * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performancemark
+         * `PerformanceMark` is a global reference for `import { PerformanceMark } from 'node:perf_hooks'`
+         * @see https://nodejs.org/docs/latest-v24.x/api/globals.html#performancemark
          * @since v19.0.0
          */
         var PerformanceMark: typeof globalThis extends {
@@ -905,8 +926,8 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceMark;
         /**
-         * `PerformanceMeasure` is a global reference for `import { PerformanceMeasure } from 'node:node:perf_hooks'`
-         * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performancemeasure
+         * `PerformanceMeasure` is a global reference for `import { PerformanceMeasure } from 'node:perf_hooks'`
+         * @see https://nodejs.org/docs/latest-v24.x/api/globals.html#performancemeasure
          * @since v19.0.0
          */
         var PerformanceMeasure: typeof globalThis extends {
@@ -915,8 +936,8 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceMeasure;
         /**
-         * `PerformanceObserver` is a global reference for `import { PerformanceObserver } from 'node:node:perf_hooks'`
-         * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceobserver
+         * `PerformanceObserver` is a global reference for `import { PerformanceObserver } from 'node:perf_hooks'`
+         * @see https://nodejs.org/docs/latest-v24.x/api/globals.html#performanceobserver
          * @since v19.0.0
          */
         var PerformanceObserver: typeof globalThis extends {
@@ -925,8 +946,8 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceObserver;
         /**
-         * `PerformanceObserverEntryList` is a global reference for `import { PerformanceObserverEntryList } from 'node:node:perf_hooks'`
-         * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceobserverentrylist
+         * `PerformanceObserverEntryList` is a global reference for `import { PerformanceObserverEntryList } from 'node:perf_hooks'`
+         * @see https://nodejs.org/docs/latest-v24.x/api/globals.html#performanceobserverentrylist
          * @since v19.0.0
          */
         var PerformanceObserverEntryList: typeof globalThis extends {
@@ -935,8 +956,8 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceObserverEntryList;
         /**
-         * `PerformanceResourceTiming` is a global reference for `import { PerformanceResourceTiming } from 'node:node:perf_hooks'`
-         * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceresourcetiming
+         * `PerformanceResourceTiming` is a global reference for `import { PerformanceResourceTiming } from 'node:perf_hooks'`
+         * @see https://nodejs.org/docs/latest-v24.x/api/globals.html#performanceresourcetiming
          * @since v19.0.0
          */
         var PerformanceResourceTiming: typeof globalThis extends {
@@ -945,8 +966,8 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceResourceTiming;
         /**
-         * `performance` is a global reference for `import { performance } from 'node:node:perf_hooks'`
-         * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performance
+         * `performance` is a global reference for `import { performance } from 'node:perf_hooks'`
+         * @see https://nodejs.org/docs/latest-v24.x/api/globals.html#performance
          * @since v16.0.0
          */
         var performance: typeof globalThis extends {