@types/node 22.15.21 → 22.18.10

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

@@ -225,12 +225,12 @@ declare module "module" {
              * See [load hook](https://nodejs.org/docs/latest-v22.x/api/module.html#loadurl-context-nextload).
              * @default undefined
              */
-            load?: LoadHook | undefined;
+            load?: LoadHookSync | undefined;
             /**
              * See [resolve hook](https://nodejs.org/docs/latest-v22.x/api/module.html#resolvespecifier-context-nextresolve).
              * @default undefined
              */
-            resolve?: ResolveHook | undefined;
+            resolve?: ResolveHookSync | undefined;
         }
         interface ModuleHooks {
             /**
@@ -429,6 +429,14 @@ declare module "module" {
                 context?: Partial<ResolveHookContext>,
             ) => ResolveFnOutput | Promise<ResolveFnOutput>,
         ) => ResolveFnOutput | Promise<ResolveFnOutput>;
+        type ResolveHookSync = (
+            specifier: string,
+            context: ResolveHookContext,
+            nextResolve: (
+                specifier: string,
+                context?: Partial<ResolveHookContext>,
+            ) => ResolveFnOutput,
+        ) => ResolveFnOutput;
         interface LoadHookContext {
             /**
              * Export conditions of the relevant `package.json`
@@ -444,7 +452,7 @@ declare module "module" {
             importAttributes: ImportAttributes;
         }
         interface LoadFnOutput {
-            format: ModuleFormat;
+            format: string | null | undefined;
             /**
              * A signal that this hook intends to terminate the chain of `resolve` hooks.
              * @default false
@@ -468,6 +476,34 @@ declare module "module" {
                 context?: Partial<LoadHookContext>,
             ) => LoadFnOutput | Promise<LoadFnOutput>,
         ) => LoadFnOutput | Promise<LoadFnOutput>;
+        type LoadHookSync = (
+            url: string,
+            context: LoadHookContext,
+            nextLoad: (
+                url: string,
+                context?: Partial<LoadHookContext>,
+            ) => LoadFnOutput,
+        ) => LoadFnOutput;
+        interface SourceMapsSupport {
+            /**
+             * If the source maps support is enabled
+             */
+            enabled: boolean;
+            /**
+             * If the support is enabled for files in `node_modules`.
+             */
+            nodeModules: boolean;
+            /**
+             * If the support is enabled for generated code from `eval` or `new Function`.
+             */
+            generatedCode: boolean;
+        }
+        /**
+         * This method returns whether the [Source Map v3](https://tc39.es/ecma426/) support for stack
+         * traces is enabled.
+         * @since v22.14.0
+         */
+        function getSourceMapsSupport(): SourceMapsSupport;
         /**
          * `path` is the resolved path for the file for which a corresponding source map
          * should be fetched.
@@ -475,6 +511,33 @@ declare module "module" {
          * @return Returns `module.SourceMap` if a source map is found, `undefined` otherwise.
          */
         function findSourceMap(path: string): SourceMap | undefined;
+        interface SetSourceMapsSupportOptions {
+            /**
+             * If enabling the support for files in `node_modules`.
+             * @default false
+             */
+            nodeModules?: boolean | undefined;
+            /**
+             * If enabling the support for generated code from `eval` or `new Function`.
+             * @default false
+             */
+            generatedCode?: boolean | undefined;
+        }
+        /**
+         * This function enables or disables the [Source Map v3](https://tc39.es/ecma426/) support for
+         * stack traces.
+         *
+         * It provides same features as launching Node.js process with commandline options
+         * `--enable-source-maps`, with additional options to alter the support for files
+         * in `node_modules` or generated codes.
+         *
+         * Only source maps in JavaScript files that are loaded after source maps has been
+         * enabled will be parsed and loaded. Preferably, use the commandline options
+         * `--enable-source-maps` to avoid losing track of source maps of modules loaded
+         * before this API call.
+         * @since v22.14.0
+         */
+        function setSourceMapsSupport(enabled: boolean, options?: SetSourceMapsSupportOptions): void;
         interface SourceMapConstructorOptions {
             /**
              * @since v21.0.0, v20.5.0
@@ -560,34 +623,91 @@ declare module "module" {
     global {
         interface ImportMeta {
             /**
-             * The directory name of the current module. This is the same as the `path.dirname()` of the `import.meta.filename`.
-             * **Caveat:** only present on `file:` modules.
+             * The directory name of the current module.
+             *
+             * This is the same as the `path.dirname()` of the `import.meta.filename`.
+             *
+             * > **Caveat**: only present on `file:` modules.
+             * @since v21.2.0, v20.11.0
              */
             dirname: string;
             /**
-             * The full absolute path and filename of the current module, with symlinks resolved.
+             * The full absolute path and filename of the current module, with
+             * symlinks resolved.
+             *
              * This is the same as the `url.fileURLToPath()` of the `import.meta.url`.
-             * **Caveat:** only local modules support this property. Modules not using the `file:` protocol will not provide it.
+             *
+             * > **Caveat** only local modules support this property. Modules not using the
+             * > `file:` protocol will not provide it.
+             * @since v21.2.0, v20.11.0
              */
             filename: string;
             /**
              * The absolute `file:` URL of the module.
+             *
+             * This is defined exactly the same as it is in browsers providing the URL of the
+             * current module file.
+             *
+             * This enables useful patterns such as relative file loading:
+             *
+             * ```js
+             * import { readFileSync } from 'node:fs';
+             * const buffer = readFileSync(new URL('./data.proto', import.meta.url));
+             * ```
              */
             url: string;
             /**
-             * Provides a module-relative resolution function scoped to each module, returning
-             * the URL string.
+             * `import.meta.resolve` is a module-relative resolution function scoped to
+             * each module, returning the URL string.
+             *
+             * ```js
+             * const dependencyAsset = import.meta.resolve('component-lib/asset.css');
+             * // file:///app/node_modules/component-lib/asset.css
+             * import.meta.resolve('./dep.js');
+             * // file:///app/dep.js
+             * ```
+             *
+             * All features of the Node.js module resolution are supported. Dependency
+             * resolutions are subject to the permitted exports resolutions within the package.
+             *
+             * **Caveats**:
+             *
+             * * This can result in synchronous file-system operations, which
+             *   can impact performance similarly to `require.resolve`.
+             * * This feature is not available within custom loaders (it would
+             *   create a deadlock).
+             * @since v13.9.0, v12.16.0
+             * @param specifier The module specifier to resolve relative to the
+             * current module.
+             * @param parent An optional absolute parent module URL to resolve from.
+             * **Default:** `import.meta.url`
+             * @returns The absolute URL string that the specifier would resolve to.
+             */
+            resolve(specifier: string, parent?: string | URL): string;
+            /**
+             * `true` when the current module is the entry point of the current process; `false` otherwise.
+             *
+             * Equivalent to `require.main === module` in CommonJS.
+             *
+             * Analogous to Python's `__name__ == "__main__"`.
              *
-             * Second `parent` parameter is only used when the `--experimental-import-meta-resolve`
-             * command flag enabled.
+             * ```js
+             * export function foo() {
+             *   return 'Hello, world';
+             * }
              *
-             * @since v20.6.0
+             * function main() {
+             *   const message = foo();
+             *   console.log(message);
+             * }
              *
-             * @param specifier The module specifier to resolve relative to `parent`.
-             * @param parent The absolute parent module URL to resolve from.
-             * @returns The absolute (`file:`) URL string for the resolved module.
+             * if (import.meta.main) main();
+             * // `foo` can be imported from another module without possible side-effects from `main`
+             * ```
+             * @since v22.18.0
+             * @experimental
              */
-            resolve(specifier: string, parent?: string | URL | undefined): string;
+            main: boolean;
         }
         namespace NodeJS {
             interface Module {
@@ -756,7 +876,6 @@ declare module "module" {
          */
         var require: NodeJS.Require;
         // Global-scope aliases for backwards compatibility with @types/node <13.0.x
-        // TODO: consider removing in a future major version update
         /** @deprecated Use `NodeJS.Module` instead. */
         interface NodeModule extends NodeJS.Module {}
         /** @deprecated Use `NodeJS.Require` instead. */

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

@@ -32,7 +32,7 @@ declare module "net" {
         onread?: OnReadOpts | undefined;
         readable?: boolean | undefined;
         writable?: boolean | undefined;
-        signal?: AbortSignal;
+        signal?: AbortSignal | undefined;
     }
     interface OnReadOpts {
         buffer: Uint8Array | (() => Uint8Array);
@@ -324,25 +324,25 @@ declare module "net" {
          * the socket is destroyed (for example, if the client disconnected).
          * @since v0.5.10
          */
-        readonly remoteAddress?: string | undefined;
+        readonly remoteAddress: string | undefined;
         /**
          * The string representation of the remote IP family. `'IPv4'` or `'IPv6'`. Value may be `undefined` if
          * the socket is destroyed (for example, if the client disconnected).
          * @since v0.11.14
          */
-        readonly remoteFamily?: string | undefined;
+        readonly remoteFamily: string | undefined;
         /**
          * The numeric representation of the remote port. For example, `80` or `21`. Value may be `undefined` if
          * the socket is destroyed (for example, if the client disconnected).
          * @since v0.5.10
          */
-        readonly remotePort?: number | undefined;
+        readonly remotePort: number | undefined;
         /**
          * The socket timeout in milliseconds as set by `socket.setTimeout()`.
          * It is `undefined` if a timeout has not been set.
          * @since v10.7.0
          */
-        readonly timeout?: number | undefined;
+        readonly timeout?: number;
         /**
          * Half-closes the socket. i.e., it sends a FIN packet. It is possible the
          * server will still send some data.

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

@@ -30,10 +30,10 @@ declare module "os" {
         mac: string;
         internal: boolean;
         cidr: string | null;
+        scopeid?: number;
     }
     interface NetworkInterfaceInfoIPv4 extends NetworkInterfaceBase {
         family: "IPv4";
-        scopeid?: undefined;
     }
     interface NetworkInterfaceInfoIPv6 extends NetworkInterfaceBase {
         family: "IPv6";
@@ -231,6 +231,15 @@ declare module "os" {
      * @since v2.3.0
      */
     function homedir(): string;
+    interface UserInfoOptions {
+        encoding?: BufferEncoding | "buffer" | undefined;
+    }
+    interface UserInfoOptionsWithBufferEncoding extends UserInfoOptions {
+        encoding: "buffer";
+    }
+    interface UserInfoOptionsWithStringEncoding extends UserInfoOptions {
+        encoding?: BufferEncoding | undefined;
+    }
     /**
      * Returns information about the currently effective user. On POSIX platforms,
      * this is typically a subset of the password file. The returned object includes
@@ -244,8 +253,9 @@ declare module "os" {
      * Throws a [`SystemError`](https://nodejs.org/docs/latest-v22.x/api/errors.html#class-systemerror) if a user has no `username` or `homedir`.
      * @since v6.0.0
      */
-    function userInfo(options: { encoding: "buffer" }): UserInfo<Buffer>;
-    function userInfo(options?: { encoding: BufferEncoding }): UserInfo<string>;
+    function userInfo(options: UserInfoOptionsWithBufferEncoding): UserInfo<Buffer>;
+    function userInfo(options?: UserInfoOptionsWithStringEncoding): UserInfo<string>;
+    function userInfo(options: UserInfoOptions): UserInfo<string | Buffer>;
     type SignalConstants = {
         [key in NodeJS.Signals]: number;
     };

node/package.json → node v22.18/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "22.15.21",
+    "version": "22.18.10",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -15,11 +15,6 @@
             "githubUsername": "jkomyno",
             "url": "https://github.com/jkomyno"
         },
-        {
-            "name": "Alvis HT Tang",
-            "githubUsername": "alvis",
-            "url": "https://github.com/alvis"
-        },
         {
             "name": "Andrew Makarov",
             "githubUsername": "r3nya",
@@ -30,56 +25,11 @@
             "githubUsername": "btoueg",
             "url": "https://github.com/btoueg"
         },
-        {
-            "name": "Chigozirim C.",
-            "githubUsername": "smac89",
-            "url": "https://github.com/smac89"
-        },
         {
             "name": "David Junger",
             "githubUsername": "touffy",
             "url": "https://github.com/touffy"
         },
-        {
-            "name": "Deividas Bakanas",
-            "githubUsername": "DeividasBakanas",
-            "url": "https://github.com/DeividasBakanas"
-        },
-        {
-            "name": "Eugene Y. Q. Shen",
-            "githubUsername": "eyqs",
-            "url": "https://github.com/eyqs"
-        },
-        {
-            "name": "Hannes Magnusson",
-            "githubUsername": "Hannes-Magnusson-CK",
-            "url": "https://github.com/Hannes-Magnusson-CK"
-        },
-        {
-            "name": "Huw",
-            "githubUsername": "hoo29",
-            "url": "https://github.com/hoo29"
-        },
-        {
-            "name": "Kelvin Jin",
-            "githubUsername": "kjin",
-            "url": "https://github.com/kjin"
-        },
-        {
-            "name": "Klaus Meinhardt",
-            "githubUsername": "ajafff",
-            "url": "https://github.com/ajafff"
-        },
-        {
-            "name": "Lishude",
-            "githubUsername": "islishude",
-            "url": "https://github.com/islishude"
-        },
-        {
-            "name": "Mariusz Wiktorczyk",
-            "githubUsername": "mwiktorczyk",
-            "url": "https://github.com/mwiktorczyk"
-        },
         {
             "name": "Mohsen Azimi",
             "githubUsername": "mohsen1",
@@ -90,46 +40,16 @@
             "githubUsername": "galkin",
             "url": "https://github.com/galkin"
         },
-        {
-            "name": "Parambir Singh",
-            "githubUsername": "parambirs",
-            "url": "https://github.com/parambirs"
-        },
         {
             "name": "Sebastian Silbermann",
             "githubUsername": "eps1lon",
             "url": "https://github.com/eps1lon"
         },
-        {
-            "name": "Thomas den Hollander",
-            "githubUsername": "ThomasdenH",
-            "url": "https://github.com/ThomasdenH"
-        },
         {
             "name": "Wilco Bakker",
             "githubUsername": "WilcoBakker",
             "url": "https://github.com/WilcoBakker"
         },
-        {
-            "name": "wwwy3y3",
-            "githubUsername": "wwwy3y3",
-            "url": "https://github.com/wwwy3y3"
-        },
-        {
-            "name": "Samuel Ainsworth",
-            "githubUsername": "samuela",
-            "url": "https://github.com/samuela"
-        },
-        {
-            "name": "Kyle Uehlein",
-            "githubUsername": "kuehlein",
-            "url": "https://github.com/kuehlein"
-        },
-        {
-            "name": "Thanik Bhongbhibhat",
-            "githubUsername": "bhongy",
-            "url": "https://github.com/bhongy"
-        },
         {
             "name": "Marcin Kopacz",
             "githubUsername": "chyzwar",
@@ -220,6 +140,6 @@
         "undici-types": "~6.21.0"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "5d2f879a002d15b5c339ca2ceae4757f171fe11f54ad330e4325efc50af262a7",
-    "typeScriptVersion": "5.1"
+    "typesPublisherContentHash": "e5707cd0627075030e43d45d8ff396de8a8bb1b71fd581233c7a8febe823657c",
+    "typeScriptVersion": "5.2"
 }

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

@@ -48,13 +48,13 @@ 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;
     }
     /**
      * The constructor of this class is not exposed to users directly.
@@ -92,11 +92,6 @@ declare module "perf_hooks" {
          * @since v8.5.0
          */
         readonly entryType: EntryType;
-        /**
-         * Additional detail specific to the `entryType`.
-         * @since v16.0.0
-         */
-        readonly detail?: NodeGCPerformanceDetail | unknown | undefined; // TODO: Narrow this based on entry type.
         toJSON(): any;
     }
     /**
@@ -104,6 +99,7 @@ declare module "perf_hooks" {
      * @since v18.2.0, v16.17.0
      */
     class PerformanceMark extends PerformanceEntry {
+        readonly detail: any;
         readonly duration: 0;
         readonly entryType: "mark";
     }
@@ -114,6 +110,7 @@ declare module "perf_hooks" {
      * @since v18.2.0, v16.17.0
      */
     class PerformanceMeasure extends PerformanceEntry {
+        readonly detail: any;
         readonly entryType: "measure";
     }
     interface UVMetrics {
@@ -130,6 +127,7 @@ declare module "perf_hooks" {
          */
         readonly eventsWaiting: number;
     }
+    // TODO: PerformanceNodeEntry is missing
     /**
      * _This property is an extension by Node.js. It is not available in Web browsers._
      *
@@ -225,7 +223,7 @@ declare module "perf_hooks" {
         /**
          * Additional optional detail to include with the mark.
          */
-        detail?: unknown | undefined;
+        detail?: unknown;
         /**
          * Duration between start and end times.
          */
@@ -866,12 +864,12 @@ declare module "perf_hooks" {
          * The minimum recordable value. Must be an integer value greater than 0.
          * @default 1
          */
-        min?: number | bigint | undefined;
+        lowest?: number | bigint | undefined;
         /**
          * The maximum recordable value. Must be an integer value greater than min.
          * @default Number.MAX_SAFE_INTEGER
          */
-        max?: number | bigint | undefined;
+        highest?: number | bigint | undefined;
         /**
          * The number of accuracy digits. Must be a number between 1 and 5.
          * @default 3

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

@@ -1,4 +1,5 @@
 declare module "process" {
+    import { Control, MessageOptions } from "node:child_process";
     import * as tty from "node:tty";
     import { Worker } from "node:worker_threads";
 
@@ -231,8 +232,9 @@ declare module "process" {
                  */
                 readonly tls_sni: boolean;
                 /**
-                 * A value that is `"strip"` if Node.js is run with `--experimental-strip-types`,
-                 * `"transform"` if Node.js is run with `--experimental-transform-types`, and `false` otherwise.
+                 * A value that is `"strip"` by default,
+                 * `"transform"` if Node.js is run with `--experimental-transform-types`, and `false` if
+                 * Node.js is run with `--no-experimental-strip-types`.
                  * @since v22.10.0
                  */
                 readonly typescript: "strip" | "transform" | false;
@@ -347,7 +349,7 @@ declare module "process" {
                 /**
                  * Can be used to change the default timezone at runtime
                  */
-                TZ?: string;
+                TZ?: string | undefined;
             }
             interface HRTime {
                 /**
@@ -991,7 +993,7 @@ declare module "process" {
                  * @since v0.1.13
                  * @param [code=0] The exit code. For string type, only integer strings (e.g.,'1') are allowed.
                  */
-                exit(code?: number | string | null | undefined): never;
+                exit(code?: number | string | null): never;
                 /**
                  * A number which will be the process exit code, when the process either
                  * exits gracefully, or is exited via {@link exit} without specifying
@@ -1002,7 +1004,7 @@ declare module "process" {
                  * @default undefined
                  * @since v0.11.8
                  */
-                exitCode?: number | string | number | undefined;
+                exitCode: number | string | null | undefined;
                 finalization: {
                     /**
                      * This function registers a callback to be called when the process emits the `exit` event if the `ref` object was not garbage collected.
@@ -1556,7 +1558,7 @@ declare module "process" {
                  * @since v0.1.17
                  * @deprecated Since v14.0.0 - Use `main` instead.
                  */
-                mainModule?: Module | undefined;
+                mainModule?: Module;
                 memoryUsage: MemoryUsageFn;
                 /**
                  * Gets the amount of memory available to the process (in bytes) based on
@@ -1566,13 +1568,11 @@ declare module "process" {
                  * See [`uv_get_constrained_memory`](https://docs.libuv.org/en/v1.x/misc.html#c.uv_get_constrained_memory) for more
                  * information.
                  * @since v19.6.0, v18.15.0
-                 * @experimental
                  */
                 constrainedMemory(): number;
                 /**
                  * Gets the amount of free memory that is still available to the process (in bytes).
                  * See [`uv_get_available_memory`](https://nodejs.org/docs/latest-v22.x/api/process.html#processavailablememory) for more information.
-                 * @experimental
                  * @since v20.13.0
                  */
                 availableMemory(): number;
@@ -1750,18 +1750,7 @@ declare module "process" {
                  * If no IPC channel exists, this property is undefined.
                  * @since v7.1.0
                  */
-                channel?: {
-                    /**
-                     * This method makes the IPC channel keep the event loop of the process running if .unref() has been called before.
-                     * @since v7.1.0
-                     */
-                    ref(): void;
-                    /**
-                     * This method makes the IPC channel not keep the event loop of the process running, and lets it finish even while the channel is open.
-                     * @since v7.1.0
-                     */
-                    unref(): void;
-                };
+                channel?: Control;
                 /**
                  * If Node.js is spawned with an IPC channel, the `process.send()` method can be
                  * used to send messages to the parent process. Messages will be received as a `'message'` event on the parent's `ChildProcess` object.
@@ -1776,9 +1765,7 @@ declare module "process" {
                 send?(
                     message: any,
                     sendHandle?: any,
-                    options?: {
-                        keepOpen?: boolean | undefined;
-                    },
+                    options?: MessageOptions,
                     callback?: (error: Error | null) => void,
                 ): boolean;
                 /**

node/readline/promises.d.ts → node v22.18/readline/promises.d.ts

@@ -1,6 +1,5 @@
 /**
  * @since v17.0.0
- * @experimental
  */
 declare module "readline/promises" {
     import { Abortable } from "node:events";
@@ -65,7 +64,7 @@ declare module "readline/promises" {
         constructor(
             stream: NodeJS.WritableStream,
             options?: {
-                autoCommit?: boolean;
+                autoCommit?: boolean | undefined;
             },
         );
         /**

node/repl.d.ts → node v22.18/repl.d.ts

@@ -37,12 +37,10 @@ declare module "repl" {
         terminal?: boolean | undefined;
         /**
          * The function to be used when evaluating each given line of input.
-         * Default: an async wrapper for the JavaScript `eval()` function. An `eval` function can
+         * **Default:** an async wrapper for the JavaScript `eval()` function. An `eval` function can
          * error with `repl.Recoverable` to indicate the input was incomplete and prompt for
-         * additional lines.
-         *
-         * @see https://nodejs.org/dist/latest-v22.x/docs/api/repl.html#repl_default_evaluation
-         * @see https://nodejs.org/dist/latest-v22.x/docs/api/repl.html#repl_custom_evaluation_functions
+         * additional lines. See the [custom evaluation functions](https://nodejs.org/dist/latest-v22.x/docs/api/repl.html#custom-evaluation-functions)
+         * section for more details.
          */
         eval?: REPLEval | undefined;
         /**