@types/node 24.13.6 → 24.19.0

{node v24.13 → node v24.19}/net.d.ts

@@ -38,6 +38,8 @@ declare module "net" {
         keepAlive?: boolean | undefined;
         keepAliveInitialDelay?: number | undefined;
         blockList?: BlockList | undefined;
+        typeOfService?: number | undefined;
+        handle?: BoundSocket | undefined;
     }
     interface OnReadOpts {
         buffer: Uint8Array | (() => Uint8Array);
@@ -70,6 +72,12 @@ declare module "net" {
     }
     type SocketConnectOpts = TcpSocketConnectOpts | IpcSocketConnectOpts;
     type SocketReadyState = "opening" | "open" | "readOnly" | "writeOnly" | "closed";
+    interface SetKeepAliveOptions {
+        enable?: boolean | undefined;
+        initialDelay?: number | undefined;
+        interval?: number | undefined;
+        count?: number | undefined;
+    }
     /**
      * This class is an abstraction of a TCP socket or a streaming `IPC` endpoint
      * (uses named pipes on Windows, and Unix domain sockets otherwise). It is also
@@ -201,25 +209,58 @@ declare module "net" {
          */
         setNoDelay(noDelay?: boolean): this;
         /**
-         * Enable/disable keep-alive functionality, and optionally set the initial
-         * delay before the first keepalive probe is sent on an idle socket.
+         * Configure keep-alive using an options object. See `socket.setKeepAlive()`
+         * for a description of each property.
          *
-         * Set `initialDelay` (in milliseconds) to set the delay between the last
-         * data packet received and the first keepalive probe. Setting `0` for`initialDelay` will leave the value unchanged from the default
-         * (or previous) setting.
+         * ```js
+         * socket.setKeepAlive({ enable: true, initialDelay: 1000, interval: 1000, count: 10 });
+         * ```
+         * @since v24.19.0
+         * @returns The socket itself.
+         */
+        setKeepAlive(options: SetKeepAliveOptions): this;
+        /**
+         * Configure keep-alive using positional arguments. See
+         * `socket.setKeepAlive()` for a description of each argument.
+         * @since v0.1.92
+         * @param enable **Default:** `false`
+         * @param initialDelay **Default:** `0`
+         * @param interval **Default:** `1000`
+         * @param count **Default:** `10`
+         * @returns The socket itself.
+         */
+        setKeepAlive(enable?: boolean, initialDelay?: number, interval?: number, count?: number): this;
+        /**
+         * Returns the current Type of Service (TOS) field for IPv4 packets or Traffic
+         * Class for IPv6 packets for this socket.
          *
-         * Enabling the keep-alive functionality will set the following socket options:
+         * `setTypeOfService()` may be called before the socket is connected; the value
+         * will be cached and applied when the socket establishes a connection.
+         * `getTypeOfService()` will return the currently set value even before connection.
          *
-         * * `SO_KEEPALIVE=1`
-         * * `TCP_KEEPIDLE=initialDelay`
-         * * `TCP_KEEPCNT=10`
-         * * `TCP_KEEPINTVL=1`
-         * @since v0.1.92
-         * @param [enable=false]
-         * @param [initialDelay=0]
-         * @return The socket itself.
+         * On some platforms (e.g., Linux), certain TOS/ECN bits may be masked or ignored,
+         * and behavior can differ between IPv4 and IPv6 or dual-stack sockets. Callers
+         * should verify platform-specific semantics.
+         * @since v24.15.0
+         * @returns The current TOS value.
+         */
+        getTypeOfService(): number;
+        /**
+         * Sets the Type of Service (TOS) field for IPv4 packets or Traffic Class for IPv6
+         * Packets sent from this socket. This can be used to prioritize network traffic.
+         *
+         * `setTypeOfService()` may be called before the socket is connected; the value
+         * will be cached and applied when the socket establishes a connection.
+         * `getTypeOfService()` will return the currently set value even before connection.
+         *
+         * On some platforms (e.g., Linux), certain TOS/ECN bits may be masked or ignored,
+         * and behavior can differ between IPv4 and IPv6 or dual-stack sockets. Callers
+         * should verify platform-specific semantics.
+         * @since v24.15.0
+         * @param tos The TOS value to set (0-255).
+         * @returns The socket itself.
          */
-        setKeepAlive(enable?: boolean, initialDelay?: number): this;
+        setTypeOfService(tos: number): this;
         /**
          * Returns the bound `address`, the address `family` name and `port` of the
          * socket as reported by the operating system:`{ port: 12346, family: 'IPv4', address: '127.0.0.1' }`
@@ -509,9 +550,92 @@ declare module "net" {
         prependOnceListener(event: "ready", listener: () => void): this;
         prependOnceListener(event: "timeout", listener: () => void): this;
     }
+    interface BoundSocketOptions {
+        /**
+         * Local address to bind. Must be a numeric IP literal; no DNS
+         * resolution is performed. **Default:** `'0.0.0.0'`, or `'::'` when
+         * `ipv6Only` is `true`.
+         */
+        host?: string | undefined;
+        /**
+         * Local port. `0` requests an OS-assigned ephemeral port.
+         * **Default:** `0`.
+         */
+        port?: number | undefined;
+        /**
+         * Sets `IPV6_V6ONLY`, disabling dual-stack support so the
+         * socket binds IPv6 only. Only meaningful for IPv6 binds. **Default:**
+         * `false`.
+         */
+        ipv6Only?: boolean | undefined;
+        /**
+         * Sets `SO_REUSEPORT`, allowing multiple sockets to bind
+         * the same address and port for kernel-level load balancing. Support is
+         * platform-dependent. **Default:** `false`.
+         */
+        reusePort?: boolean | undefined;
+    }
+    /**
+     * Allows for the synchronous creation of a pre-bound socket, that can be passed
+     * to `listen()` or `new net.Socket()` later on. For `listen()` this enables
+     * synchronous port reservation, while for `new net.Socket()`, it allows control
+     * over the local egress port/IP, via `bind(2)` semantics.
+     *
+     * Adoption transfers ownership of the socket; afterwards `address()` and `close()`
+     * throw `ERR_SOCKET_HANDLE_ADOPTED`. A handle that is never adopted must be
+     * closed to avoid leaking the socket.
+     *
+     * ```js
+     * import net from 'node:net';
+     *
+     * const bound = new net.BoundSocket();
+     * const { port } = bound.address();
+     * console.log(`Reserved port ${port} for server`);
+     *
+     * const server = net.createServer();
+     * server.listen(bound); // Adopt as a server, or pass to new net.Socket() instead.
+     * ```
+     * @since v24.19.0
+     */
+    class BoundSocket {
+        /**
+         * @since v26.4.0
+         */
+        constructor(options?: BoundSocketOptions);
+        /**
+         * Returns the bound local address. When bound with `port: 0`, `port` is the
+         * OS-assigned ephemeral port.
+         * @since v24.19.0
+         * @returns An object with `address`, `family`, and `port` properties,
+         * as `server.address()` returns.
+         */
+        address(): AddressInfo;
+        /**
+         * Returns the file descriptor of the bound socket. Ownership remains with the
+         * `BoundSocket`, so the descriptor must not be closed by the caller. The
+         * descriptor is only available before the handle is adopted; afterwards it belongs
+         * to the adopting `net.Server` or `net.Socket` and `fd()` throws
+         * `ERR_SOCKET_HANDLE_ADOPTED`.
+         * @since v24.19.0
+         * @returns The underlying OS file descriptor, or `-1` on platforms
+         * that do not expose one for sockets (such as Windows).
+         */
+        fd(): number;
+        /**
+         * Releases the bound socket. Only needed when the handle is never adopted.
+         * @since v24.19.0
+         */
+        close(): void;
+        /**
+         * Closes the handle if it has not been adopted or closed; otherwise a no-op.
+         * @since v24.19.0
+         */
+        [Symbol.dispose](): void;
+    }
     interface ListenOptions extends Abortable {
         backlog?: number | undefined;
         exclusive?: boolean | undefined;
+        handle?: BoundSocket | undefined;
         host?: string | undefined;
         /**
          * @default false

{node v24.13 → node v24.19}/os.d.ts

@@ -131,7 +131,7 @@ declare module "os" {
      *       irq: 20,
      *     },
      *   },
-     * ]
+     * ];
      * ```
      *
      * `nice` values are POSIX-only. On Windows, the `nice` values of all processors
@@ -176,44 +176,44 @@ declare module "os" {
      *
      * The properties available on the assigned network address object include:
      *
-     * ```js
+     * ```json
      * {
-     *   lo: [
+     *   "lo": [
      *     {
-     *       address: '127.0.0.1',
-     *       netmask: '255.0.0.0',
-     *       family: 'IPv4',
-     *       mac: '00:00:00:00:00:00',
-     *       internal: true,
-     *       cidr: '127.0.0.1/8'
+     *       "address:": "127.0.0.1",
+     *       "netmask:": "255.0.0.0",
+     *       "family:": "IPv4",
+     *       "mac:": "00:00:00:00:00:00",
+     *       "internal:": true,
+     *       "cidr:": "127.0.0.1/8"
      *     },
      *     {
-     *       address: '::1',
-     *       netmask: 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff',
-     *       family: 'IPv6',
-     *       mac: '00:00:00:00:00:00',
-     *       scopeid: 0,
-     *       internal: true,
-     *       cidr: '::1/128'
+     *       "address:": "::1",
+     *       "netmask:": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
+     *       "family:": "IPv6",
+     *       "mac:": "00:00:00:00:00:00",
+     *       "scopeid:": 0,
+     *       "internal:": true,
+     *       "cidr:": "::1/128"
      *     }
      *   ],
-     *   eth0: [
+     *   "eth0": [
      *     {
-     *       address: '192.168.1.108',
-     *       netmask: '255.255.255.0',
-     *       family: 'IPv4',
-     *       mac: '01:02:03:0a:0b:0c',
-     *       internal: false,
-     *       cidr: '192.168.1.108/24'
+     *       "address:": "192.168.1.108",
+     *       "netmask:": "255.255.255.0",
+     *       "family:": "IPv4",
+     *       "mac:": "01:02:03:0a:0b:0c",
+     *       "internal:": false,
+     *       "cidr:": "192.168.1.108/24"
      *     },
      *     {
-     *       address: 'fe80::a00:27ff:fe4e:66a1',
-     *       netmask: 'ffff:ffff:ffff:ffff::',
-     *       family: 'IPv6',
-     *       mac: '01:02:03:0a:0b:0c',
-     *       scopeid: 1,
-     *       internal: false,
-     *       cidr: 'fe80::a00:27ff:fe4e:66a1/64'
+     *       "address:": "fe80::a00:27ff:fe4e:66a1",
+     *       "netmask:": "ffff:ffff:ffff:ffff::",
+     *       "family:": "IPv6",
+     *       "mac:": "01:02:03:0a:0b:0c",
+     *       "scopeid:": 1,
+     *       "internal:": false,
+     *       "cidr:": "fe80::a00:27ff:fe4e:66a1/64"
      *     }
      *   ]
      * }

{node v24.13 → node v24.19}/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "24.13.6",
+    "version": "24.19.0",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -132,9 +132,9 @@
     },
     "scripts": {},
     "dependencies": {
-        "undici-types": "~7.18.0"
+        "undici-types": ">=7.24.0 <7.24.7"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "f7abb6ff9bff6be903c0a2b1cef90130ac2012f63be0b05e32126cb701326609",
+    "typesPublisherContentHash": "2415216739ceac17414280a87c6db4cffb78f43edb71f9fcc529bccb3fb63614",
     "typeScriptVersion": "5.6"
 }

{node v24.13 → node v24.19}/perf_hooks.d.ts

@@ -670,6 +670,7 @@ declare module "perf_hooks" {
     namespace constants {
         const NODE_PERFORMANCE_GC_MAJOR: number;
         const NODE_PERFORMANCE_GC_MINOR: number;
+        const NODE_PERFORMANCE_GC_MINOR_MARK_SWEEP: number;
         const NODE_PERFORMANCE_GC_INCREMENTAL: number;
         const NODE_PERFORMANCE_GC_WEAKCB: number;
         const NODE_PERFORMANCE_GC_FLAGS_NO: number;
@@ -683,9 +684,14 @@ declare module "perf_hooks" {
     const performance: Performance;
     interface EventLoopMonitorOptions {
         /**
-         * The sampling rate in milliseconds.
-         * Must be greater than zero.
-         * @default 10
+         * When `true`, samples are taken once per
+         * event loop iteration. **Default:** `false`.
+         */
+        samplePerIteration?: boolean | undefined;
+        /**
+         * The sampling rate in milliseconds for interval-based
+         * sampling. Must be greater than zero. This option is ignored when
+         * `samplePerIteration` is `true`. **Default:** `10`.
          */
         resolution?: number | undefined;
     }
@@ -769,21 +775,25 @@ declare module "perf_hooks" {
          */
         readonly stddev: number;
     }
-    interface IntervalHistogram extends Histogram {
+    /**
+     * A `Histogram` that records event loop delay, returned by
+     * `perf_hooks.monitorEventLoopDelay()`.
+     */
+    interface ELDHistogram extends Histogram {
         /**
-         * Enables the update interval timer. Returns `true` if the timer was
-         * started, `false` if it was already started.
+         * Disables event loop delay sampling. Returns `true` if sampling was
+         * stopped, `false` if it was already stopped.
          * @since v11.10.0
          */
-        enable(): boolean;
+        disable(): boolean;
         /**
-         * Disables the update interval timer. Returns `true` if the timer was
-         * stopped, `false` if it was already stopped.
+         * Enables event loop delay sampling. Returns `true` if sampling was
+         * started, `false` if it was already started.
          * @since v11.10.0
          */
-        disable(): boolean;
+        enable(): boolean;
         /**
-         * Disables the update interval timer when the histogram is disposed.
+         * Disables event loop delay sampling when the histogram is disposed.
          *
          * ```js
          * const { monitorEventLoopDelay } = require('node:perf_hooks');
@@ -895,14 +905,16 @@ declare module "perf_hooks" {
     /**
      * _This property is an extension by Node.js. It is not available in Web browsers._
      *
-     * Creates an `IntervalHistogram` object that samples and reports the event loop
-     * delay over time. The delays will be reported in nanoseconds.
+     * Creates a histogram object that samples and reports the event loop delay over
+     * time. The delays will be reported in nanoseconds.
      *
-     * Using a timer to detect approximate event loop delay works because the
-     * execution of timers is tied specifically to the lifecycle of the libuv
-     * event loop. That is, a delay in the loop will cause a delay in the execution
-     * of the timer, and those delays are specifically what this API is intended to
-     * detect.
+     * By default, the histogram is updated by a timer using the configured
+     * `resolution`. When `samplePerIteration` is `true`, samples are taken once per
+     * event loop iteration using `uv_prepare_t` and `uv_check_t` hooks. In that mode,
+     * the histogram does not keep the loop alive or force additional iterations when
+     * the application is idle.
+     * The two sampling modes produce significantly different results and should not
+     * be compared directly.
      *
      * ```js
      * import { monitorEventLoopDelay } from 'node:perf_hooks';
@@ -920,7 +932,7 @@ declare module "perf_hooks" {
      * ```
      * @since v11.10.0
      */
-    function monitorEventLoopDelay(options?: EventLoopMonitorOptions): IntervalHistogram;
+    function monitorEventLoopDelay(options?: EventLoopMonitorOptions): ELDHistogram;
     /**
      * _This property is an extension by Node.js. It is not available in Web browsers._
      *

{node v24.13 → node v24.19}/process.d.ts

@@ -668,14 +668,14 @@ declare module "process" {
                  *
                  * Results in `process.execArgv`:
                  *
-                 * ```js
+                 * ```json
                  * ["--icu-data-dir=./foo", "--require", "./bar.js"]
                  * ```
                  *
                  * And `process.argv`:
                  *
-                 * ```js
-                 * ['/usr/local/bin/node', 'script.js', '--version']
+                 * ```json
+                 * ["/usr/local/bin/node", "script.js", "--version"]
                  * ```
                  *
                  * Refer to `Worker constructor` for the detailed behavior of worker
@@ -687,8 +687,8 @@ declare module "process" {
                  * The `process.execPath` property returns the absolute pathname of the executable
                  * that started the Node.js process. Symbolic links, if any, are resolved.
                  *
-                 * ```js
-                 * '/usr/local/bin/node'
+                 * ```json
+                 * "/usr/local/bin/node"
                  * ```
                  * @since v0.1.100
                  */
@@ -849,18 +849,18 @@ declare module "process" {
                  *
                  * An example of this object looks like:
                  *
-                 * ```js
+                 * ```json
                  * {
-                 *   TERM: 'xterm-256color',
-                 *   SHELL: '/usr/local/bin/bash',
-                 *   USER: 'maciej',
-                 *   PATH: '~/.bin/:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin',
-                 *   PWD: '/Users/maciej',
-                 *   EDITOR: 'vim',
-                 *   SHLVL: '1',
-                 *   HOME: '/Users/maciej',
-                 *   LOGNAME: 'maciej',
-                 *   _: '/usr/local/bin/node'
+                 *   "TERM": "xterm-256color",
+                 *   "SHELL": "/usr/local/bin/bash",
+                 *   "USER": "maciej",
+                 *   "PATH": "~/.bin/:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin",
+                 *   "PWD": "/Users/maciej",
+                 *   "EDITOR": "vim",
+                 *   "SHLVL": "1",
+                 *   "HOME": "/Users/maciej",
+                 *   "LOGNAME": "maciej",
+                 *   "_": "/usr/local/bin/node"
                  * }
                  * ```
                  *
@@ -1389,29 +1389,28 @@ declare module "process" {
                  *
                  * An example of the possible output looks like:
                  *
-                 * ```js
+                 * ```json
                  * {
-                 *   target_defaults:
-                 *    { cflags: [],
-                 *      default_configuration: 'Release',
-                 *      defines: [],
-                 *      include_dirs: [],
-                 *      libraries: [] },
-                 *   variables:
+                 *   "target_defaults":
+                 *    { "cflags": [],
+                 *      "default_configuration": "Release",
+                 *      "defines": [],
+                 *      "include_dirs": [],
+                 *      "libraries": [] },
+                 *   "variables":
                  *    {
-                 *      host_arch: 'x64',
-                 *      napi_build_version: 5,
-                 *      node_install_npm: 'true',
-                 *      node_prefix: '',
-                 *      node_shared_cares: 'false',
-                 *      node_shared_http_parser: 'false',
-                 *      node_shared_libuv: 'false',
-                 *      node_shared_zlib: 'false',
-                 *      node_use_openssl: 'true',
-                 *      node_shared_openssl: 'false',
-                 *      strict_aliasing: 'true',
-                 *      target_arch: 'x64',
-                 *      v8_use_snapshot: 1
+                 *      "host_arch": "x64",
+                 *      "napi_build_version": 5,
+                 *      "node_install_npm": "true",
+                 *      "node_prefix": "",
+                 *      "node_shared_cares": "false",
+                 *      "node_shared_http_parser": "false",
+                 *      "node_shared_libuv": "false",
+                 *      "node_shared_zlib": "false",
+                 *      "node_use_openssl": "true",
+                 *      "node_shared_openssl": "false",
+                 *      "target_arch": "x64",
+                 *      "v8_use_snapshot": 1
                  *    }
                  * }
                  * ```
@@ -1725,13 +1724,13 @@ declare module "process" {
                  *
                  * `process.release` contains the following properties:
                  *
-                 * ```js
+                 * ```json
                  * {
-                 *   name: 'node',
-                 *   lts: 'Hydrogen',
-                 *   sourceUrl: 'https://nodejs.org/download/release/v18.12.0/node-v18.12.0.tar.gz',
-                 *   headersUrl: 'https://nodejs.org/download/release/v18.12.0/node-v18.12.0-headers.tar.gz',
-                 *   libUrl: 'https://nodejs.org/download/release/v18.12.0/win-x64/node.lib'
+                 *   "name": "node",
+                 *   "lts": "Hydrogen",
+                 *   "sourceUrl": "https://nodejs.org/download/release/v18.12.0/node-v18.12.0.tar.gz",
+                 *   "headersUrl": "https://nodejs.org/download/release/v18.12.0/node-v18.12.0-headers.tar.gz",
+                 *   "libUrl": "https://nodejs.org/download/release/v18.12.0/win-x64/node.lib"
                  * }
                  * ```
                  *