@types/node 25.8.0 → 25.9.0

node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for node (https://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Thu, 14 May 2026 16:39:50 GMT
+ * Last updated: Mon, 18 May 2026 12:43:58 GMT
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
 
 # Credits

node/async_hooks.d.ts

@@ -491,6 +491,75 @@ declare module "node:async_hooks" {
          * @experimental
          */
         exit<R, TArgs extends any[]>(callback: (...args: TArgs) => R, ...args: TArgs): R;
+        /**
+         * Creates a disposable scope that enters the given store and automatically
+         * restores the previous store value when the scope is disposed. This method is
+         * designed to work with JavaScript's explicit resource management (`using` syntax).
+         *
+         * Example:
+         *
+         * ```js
+         * import { AsyncLocalStorage } from 'node:async_hooks';
+         *
+         * const asyncLocalStorage = new AsyncLocalStorage();
+         *
+         * {
+         *   using _ = asyncLocalStorage.withScope('my-store');
+         *   console.log(asyncLocalStorage.getStore()); // Prints: my-store
+         * }
+         *
+         * console.log(asyncLocalStorage.getStore()); // Prints: undefined
+         * ```
+         *
+         * The `withScope()` method is particularly useful for managing context in
+         * synchronous code where you want to ensure the previous store value is restored
+         * when exiting a block, even if an error is thrown.
+         *
+         * ```js
+         * import { AsyncLocalStorage } from 'node:async_hooks';
+         *
+         * const asyncLocalStorage = new AsyncLocalStorage();
+         *
+         * try {
+         *   using _ = asyncLocalStorage.withScope('my-store');
+         *   console.log(asyncLocalStorage.getStore()); // Prints: my-store
+         *   throw new Error('test');
+         * } catch (e) {
+         *   // Store is automatically restored even after error
+         *   console.log(asyncLocalStorage.getStore()); // Prints: undefined
+         * }
+         * ```
+         *
+         * **Important:** When using `withScope()` in async functions before the first
+         * `await`, be aware that the scope change will affect the caller's context. The
+         * synchronous portion of an async function (before the first `await`) runs
+         * immediately when called, and when it reaches the first `await`, it returns the
+         * promise to the caller. At that point, the scope change becomes visible in the
+         * caller's context and will persist in subsequent synchronous code until something
+         * else changes the scope value. For async operations, prefer using `run()` which
+         * properly isolates context across async boundaries.
+         *
+         * ```js
+         * import { AsyncLocalStorage } from 'node:async_hooks';
+         *
+         * const asyncLocalStorage = new AsyncLocalStorage();
+         *
+         * async function example() {
+         *   using _ = asyncLocalStorage.withScope('my-store');
+         *   console.log(asyncLocalStorage.getStore()); // Prints: my-store
+         *   await someAsyncOperation(); // Function pauses here and returns promise
+         *   console.log(asyncLocalStorage.getStore()); // Prints: my-store
+         * }
+         *
+         * // Calling without await
+         * example(); // Synchronous portion runs, then pauses at first await
+         * // After the promise is returned, the scope 'my-store' is now active in caller!
+         * console.log(asyncLocalStorage.getStore()); // Prints: my-store (unexpected!)
+         * ```
+         * @since v25.9.0
+         * @experimental
+         */
+        withScope(store: T): RunScope;
         /**
          * Transitions into the context for the remainder of the current
          * synchronous execution and then persists the store through any following
@@ -533,6 +602,45 @@ declare module "node:async_hooks" {
          */
         enterWith(store: T): void;
     }
+    /**
+     * A disposable scope returned by `asyncLocalStorage.withScope()` that
+     * automatically restores the previous store value when disposed. This class
+     * implements the [Explicit Resource Management](https://github.com/tc39/proposal-explicit-resource-management) protocol and is designed to work
+     * with JavaScript's `using` syntax.
+     *
+     * The scope automatically restores the previous store value when the `using` block
+     * exits, whether through normal completion or by throwing an error.
+     * @since v25.9.0
+     * @experimental
+     */
+    interface RunScope extends Disposable {
+        /**
+         * Explicitly ends the scope and restores the previous store value. This method
+         * is idempotent: calling it multiple times has the same effect as calling it once.
+         *
+         * The `[Symbol.dispose]()` method defers to `dispose()`.
+         *
+         * If `withScope()` is called without the `using` keyword, `dispose()` must be
+         * called manually to restore the previous store value. Forgetting to call
+         * `dispose()` will cause the store value to persist for the remainder of the
+         * current execution context:
+         *
+         * ```js
+         * import { AsyncLocalStorage } from 'node:async_hooks';
+         *
+         * const storage = new AsyncLocalStorage();
+         *
+         * // Without using, the scope must be disposed manually
+         * const scope = storage.withScope('my-store');
+         * // storage.getStore() === 'my-store' here
+         *
+         * scope.dispose(); // Restore previous value
+         * // storage.getStore() === undefined here
+         * ```
+         * @since v25.9.0
+         */
+        dispose(): void;
+    }
     /**
      * @since v17.2.0, v16.14.0
      * @return A map of provider types to the corresponding numeric id.

node/crypto.d.ts

@@ -3778,7 +3778,7 @@ declare module "node:crypto" {
         interface CShakeParams extends Algorithm {
             customization?: NodeJS.BufferSource;
             functionName?: NodeJS.BufferSource;
-            length: number;
+            outputLength: number;
         }
         interface ContextParams extends Algorithm {
             context?: NodeJS.BufferSource;
@@ -3815,6 +3815,10 @@ declare module "node:crypto" {
             hash: HashAlgorithmIdentifier;
             length?: number;
         }
+        interface KangarooTwelveParams {
+            customization?: NodeJS.BufferSource;
+            outputLength: number;
+        }
         interface JsonWebKey {
             alg?: string;
             crv?: string;
@@ -3849,7 +3853,7 @@ declare module "node:crypto" {
         }
         interface KmacParams extends Algorithm {
             customization?: NodeJS.BufferSource;
-            length: number;
+            outputLength: number;
         }
         interface Pbkdf2Params extends Algorithm {
             hash: HashAlgorithmIdentifier;
@@ -3884,6 +3888,10 @@ declare module "node:crypto" {
         interface RsaPssParams extends Algorithm {
             saltLength: number;
         }
+        interface TurboShakeParams {
+            domainSeparation?: number;
+            outputLength: number;
+        }
         interface Crypto {
             readonly subtle: SubtleCrypto;
             getRandomValues<
@@ -3945,7 +3953,10 @@ declare module "node:crypto" {
                 extractable: boolean,
                 keyUsages: readonly KeyUsage[],
             ): Promise<CryptoKey>;
-            digest(algorithm: AlgorithmIdentifier | CShakeParams, data: NodeJS.BufferSource): Promise<ArrayBuffer>;
+            digest(
+                algorithm: AlgorithmIdentifier | CShakeParams | TurboShakeParams | KangarooTwelveParams,
+                data: NodeJS.BufferSource,
+            ): Promise<ArrayBuffer>;
             encapsulateBits(
                 encapsulationAlgorithm: AlgorithmIdentifier,
                 encapsulationKey: CryptoKey,

node/fs/promises.d.ts

@@ -37,6 +37,7 @@ declare module "node:fs/promises" {
         WriteVResult,
     } from "node:fs";
     import { Stream } from "node:stream";
+    import { ByteReadableStream, Transform, Writer } from "node:stream/iter";
     import { ReadableStream } from "node:stream/web";
     interface FileChangeInfo<T extends string | Buffer> {
         eventType: WatchEventType;
@@ -85,6 +86,57 @@ declare module "node:fs/promises" {
     interface ReadableWebStreamOptions {
         autoClose?: boolean | undefined;
     }
+    interface PullOptions extends Abortable {
+        /**
+         * Close the file handle when the stream ends.
+         * @default false
+         */
+        autoClose?: boolean | undefined;
+        /**
+         * Byte offset to begin reading from. When specified,
+         * reads use explicit positioning (`pread` semantics).
+         */
+        start?: number | undefined;
+        /**
+         * Maximum number of bytes to read before ending the
+         * iterator. Reads stop when `limit` bytes have been delivered or EOF is
+         * reached, whichever comes first.
+         */
+        limit?: number | undefined;
+        /**
+         * Size in bytes of the buffer allocated for each
+         * read operation.
+         * @default 131072
+         */
+        chunkSize?: number | undefined;
+    }
+    interface WriterOptions {
+        /**
+         * Close the file handle when the writer ends or fails.
+         * @default false
+         */
+        autoClose?: boolean | undefined;
+        /**
+         * Byte offset to start writing at. When specified,
+         * writes use explicit positioning.
+         */
+        start?: number | undefined;
+        /**
+         * Maximum number of bytes the writer will accept.
+         * Async writes (`write()`, `writev()`) that would exceed the limit reject
+         * with `ERR_OUT_OF_RANGE`. Sync writes (`writeSync()`, `writevSync()`)
+         * return `false`.
+         */
+        limit?: number | undefined;
+        /**
+         * Maximum chunk size in bytes for synchronous write
+         * operations. Writes larger than this threshold fall back to async I/O.
+         * Set this to match the reader's `chunkSize` for optimal `pipeTo()`
+         * performance.
+         * @default 131072
+         */
+        chunkSize?: number | undefined;
+    }
     // TODO: Add `EventEmitter` close
     interface FileHandle {
         /**
@@ -202,6 +254,41 @@ declare module "node:fs/promises" {
          * @return Fulfills with `undefined` upon success.
          */
         datasync(): Promise<void>;
+        /**
+         * Return the file contents as an async iterable using the
+         * [`node:stream/iter`](https://nodejs.org/docs/latest-v25.x/api/stream_iter.html) pull model. Reads are performed in `chunkSize`-byte
+         * chunks (default 128 KB). If transforms are provided, they are applied
+         * via [`stream/iter pull()`](https://nodejs.org/docs/latest-v25.x/api/stream_iter.html#pullsource-transforms-options).
+         *
+         * The file handle is locked while the iterable is being consumed and unlocked
+         * when iteration completes, an error occurs, or the consumer breaks.
+         *
+         * This function is only available when the `--experimental-stream-iter` flag is
+         * enabled.
+         *
+         * ```js
+         * import { open } from 'node:fs/promises';
+         * import { text } from 'node:stream/iter';
+         * import { compressGzip } from 'node:zlib/iter';
+         *
+         * const fh = await open('input.txt', 'r');
+         *
+         * // Read as text
+         * console.log(await text(fh.pull({ autoClose: true })));
+         *
+         * // Read 1 KB starting at byte 100
+         * const fh2 = await open('input.txt', 'r');
+         * console.log(await text(fh2.pull({ start: 100, limit: 1024, autoClose: true })));
+         *
+         * // Read with compression
+         * const fh3 = await open('input.txt', 'r');
+         * const compressed = fh3.pull(compressGzip(), { autoClose: true });
+         * ```
+         * @since v25.9.0
+         * @experimental
+         */
+        pull(...transforms: Transform[]): ByteReadableStream;
+        pull(...args: [...transforms: Transform[], options: PullOptions]): ByteReadableStream;
         /**
          * Request that all data for the open file descriptor is flushed to the storage
          * device. The specific implementation is operating system and device specific.
@@ -450,6 +537,45 @@ declare module "node:fs/promises" {
             buffers: TBuffers,
             position?: number,
         ): Promise<WriteVResult<TBuffers>>;
+        /**
+         * Return a [`node:stream/iter`](https://nodejs.org/docs/latest-v25.x/api/stream_iter.html) writer backed by this file handle.
+         *
+         * The writer supports both `Symbol.asyncDispose` and `Symbol.dispose`:
+         *
+         * * `await using w = fh.writer()` — if the writer is still open (no `end()`
+         *   called), `asyncDispose` calls `fail()`. If `end()` is pending, it waits
+         *   for it to complete.
+         * * `using w = fh.writer()` — calls `fail()` unconditionally.
+         *
+         * The `writeSync()` and `writevSync()` methods enable the try-sync fast path
+         * used by [`stream/iter pipeTo()`](https://nodejs.org/docs/latest-v25.x/api/stream_iter.html#pipetosource-transforms-writer). When the reader's chunk size matches the
+         * writer's `chunkSize`, all writes in a `pipeTo()` pipeline complete
+         * synchronously with zero promise overhead.
+         *
+         * This function is only available when the `--experimental-stream-iter` flag is
+         * enabled.
+         *
+         * ```js
+         * import { open } from 'node:fs/promises';
+         * import { from, pipeTo } from 'node:stream/iter';
+         * import { compressGzip } from 'node:zlib/iter';
+         *
+         * // Async pipeline
+         * const fh = await open('output.gz', 'w');
+         * await pipeTo(from('Hello!'), compressGzip(), fh.writer({ autoClose: true }));
+         *
+         * // Sync pipeline with limit
+         * const src = await open('input.txt', 'r');
+         * const dst = await open('output.txt', 'w');
+         * const w = dst.writer({ limit: 1024 * 1024 }); // Max 1 MB
+         * await pipeTo(src.pull({ autoClose: true }), w);
+         * await w.end();
+         * await dst.close();
+         * ```
+         * @since v25.9.0
+         * @experimental
+         */
+        writer(options?: WriterOptions): Writer;
         /**
          * Read from a file and write to an array of [ArrayBufferView](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView) s
          * @since v13.13.0, v12.17.0

node/fs.d.ts

@@ -380,7 +380,8 @@ declare module "node:fs" {
         "ready": [];
     }
     /**
-     * Instances of `fs.ReadStream` are created and returned using the {@link createReadStream} function.
+     * Instances of `fs.ReadStream` cannot be constructed directly. They are created and
+     * returned using the `fs.createReadStream()` function.
      * @since v0.1.93
      */
     class ReadStream extends stream.Readable {
@@ -643,7 +644,8 @@ declare module "node:fs" {
         "ready": [];
     }
     /**
-     * Instances of `fs.WriteStream` are created and returned using the {@link createWriteStream} function.
+     * Instances of `fs.WriteStream` cannot be constructed directly. They are created and
+     * returned using the `fs.createWriteStream()` function.
      * @since v0.1.93
      */
     class WriteStream extends stream.Writable {

node/index.d.ts

@@ -95,6 +95,7 @@
 /// <reference path="sqlite.d.ts" />
 /// <reference path="stream.d.ts" />
 /// <reference path="stream/consumers.d.ts" />
+/// <reference path="stream/iter.d.ts" />
 /// <reference path="stream/promises.d.ts" />
 /// <reference path="stream/web.d.ts" />
 /// <reference path="string_decoder.d.ts" />
@@ -113,3 +114,4 @@
 /// <reference path="wasi.d.ts" />
 /// <reference path="worker_threads.d.ts" />
 /// <reference path="zlib.d.ts" />
+/// <reference path="zlib/iter.d.ts" />

node/inspector.generated.d.ts

@@ -2035,6 +2035,9 @@ declare module "node:inspector" {
             autoAttach: boolean;
             waitForDebuggerOnStart: boolean;
         }
+        interface GetTargetsReturnType {
+            targetInfos: TargetInfo[];
+        }
         interface TargetCreatedEventDataType {
             targetInfo: TargetInfo;
         }
@@ -2506,6 +2509,7 @@ declare module "node:inspector" {
          */
         post(method: "NodeWorker.detach", params?: NodeWorker.DetachParameterType, callback?: (err: Error | null) => void): void;
         post(method: "NodeWorker.detach", callback?: (err: Error | null) => void): void;
+        post(method: "Target.getTargets", callback?: (err: Error | null, params: Target.GetTargetsReturnType) => void): void;
         post(method: "Target.setAutoAttach", params?: Target.SetAutoAttachParameterType, callback?: (err: Error | null) => void): void;
         post(method: "Target.setAutoAttach", callback?: (err: Error | null) => void): void;
         post(method: "DOMStorage.clear", params?: DOMStorage.ClearParameterType, callback?: (err: Error | null) => void): void;
@@ -3642,6 +3646,7 @@ declare module "node:inspector/promises" {
          * Detached from the worker with given sessionId.
          */
         post(method: "NodeWorker.detach", params?: NodeWorker.DetachParameterType): Promise<void>;
+        post(method: "Target.getTargets"): Promise<Target.GetTargetsReturnType>;
         post(method: "Target.setAutoAttach", params?: Target.SetAutoAttachParameterType): Promise<void>;
         post(method: "DOMStorage.clear", params?: DOMStorage.ClearParameterType): Promise<void>;
         /**

node/module.d.ts

@@ -218,6 +218,7 @@ declare module "node:module" {
          * This feature requires `--allow-worker` if used with the
          * [Permission Model](https://nodejs.org/docs/latest-v25.x/api/permissions.html#permission-model).
          * @since v20.6.0, v18.19.0
+         * @deprecated Use `module.registerHooks()` instead.
          * @param specifier Customization hooks to be registered; this should be
          * the same string that would be passed to `import()`, except that if it is
          * relative, it is resolved relative to `parentURL`.

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "25.8.0",
+    "version": "25.9.0",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -150,6 +150,6 @@
         "undici-types": ">=7.24.0 <7.24.7"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "e3b0c76dfc9cc84424890451a36d8ae1dbc86b0b0e49cc458f2a886fda8e4649",
+    "typesPublisherContentHash": "2c46dd4d6ce51acbd418cda854101b97987beaea870ba7b8c1a22436b4a0a28c",
     "typeScriptVersion": "5.3"
 }

node/process.d.ts

@@ -822,6 +822,28 @@ declare module "node:process" {
                  * @since v0.7.0
                  */
                 abort(): never;
+                /**
+                 * The `process.addUncaughtExceptionCaptureCallback()` function adds a callback
+                 * that will be invoked when an uncaught exception occurs, receiving the exception
+                 * value as its first argument.
+                 *
+                 * Unlike `process.setUncaughtExceptionCaptureCallback()`, this function allows
+                 * multiple callbacks to be registered and does not conflict with the
+                 * [`domain`](https://nodejs.org/docs/latest-v25.x/api/domain.html) module. Callbacks are called in reverse order of registration
+                 * (most recent first). If a callback returns `true`, subsequent callbacks
+                 * and the default uncaught exception handling are skipped.
+                 *
+                 * ```js
+                 * import process from 'node:process';
+                 *
+                 * process.addUncaughtExceptionCaptureCallback((err) => {
+                 *   console.error('Caught exception:', err.message);
+                 *   return true; // Indicates exception was handled
+                 * });
+                 * ```
+                 * @since v25.9.0
+                 */
+                addUncaughtExceptionCaptureCallback(fn: (err: unknown) => boolean): void;
                 /**
                  * The `process.chdir()` method changes the current working directory of the
                  * Node.js process or throws an exception if doing so fails (for instance, if
@@ -1418,9 +1440,11 @@ declare module "node:process" {
                  * method with a non-`null` argument while another capture function is set will
                  * throw an error.
                  *
-                 * Using this function is mutually exclusive with using the deprecated `domain` built-in module.
+                 * To register multiple callbacks that can coexist, use
+                 * `process.addUncaughtExceptionCaptureCallback()` instead.
                  * @since v9.3.0
                  */
+                // TODO: callback parameter should be `unknown`
                 setUncaughtExceptionCaptureCallback(cb: ((err: Error) => void) | null): void;
                 /**
                  * Indicates whether a callback has been set using {@link setUncaughtExceptionCaptureCallback}.

node/quic.d.ts

@@ -179,7 +179,7 @@ declare module "node:quic" {
          * The TLS crypto keys to use for sessions.
          * @since v23.8.0
          */
-        keys?: KeyObject | webcrypto.CryptoKey | ReadonlyArray<KeyObject | webcrypto.CryptoKey> | undefined;
+        keys?: KeyObject | readonly KeyObject[] | undefined;
         /**
          * Specifies the maximum UDP packet payload size.
          * @since v23.8.0
@@ -653,7 +653,7 @@ declare module "node:quic" {
         /**
          * Sends an unreliable datagram to the remote peer, returning the datagram ID.
          * If the datagram payload is specified as an `ArrayBufferView`, then ownership of
-         * that view will be transfered to the underlying stream.
+         * that view will be transferred to the underlying stream.
          * @since v23.8.0
          */
         sendDatagram(datagram: string | NodeJS.ArrayBufferView): bigint;

node/repl.d.ts

@@ -86,6 +86,21 @@ declare module "node:repl" {
          * @default false
          */
         breakEvalOnSigint?: boolean | undefined;
+        /**
+         * This function customizes error handling in the REPL.
+         * It receives the thrown exception as its first argument and must return one
+         * of the following values synchronously:
+         * * `'print'` to print the error to the output stream (default behavior).
+         * * `'ignore'` to skip all remaining error handling.
+         * * `'unhandled'` to treat the exception as fully unhandled. In this case,
+         *   the error will be passed to process-wide exception handlers, such as
+         *   the `'uncaughtException'` event.
+         *   The `'unhandled'` value may or may not be desirable in situations
+         *   where the `REPLServer` instance has been closed, depending on the particular
+         *   use case.
+         * @since v25.9.0
+         */
+        handleError?: ((err: unknown) => "print" | "ignore" | "unhandled") | undefined;
     }
     type REPLEval = (
         this: REPLServer,

node/stream/iter.d.ts

@@ -0,0 +1,298 @@
+declare module "node:stream/iter" {
+    // Symbols and custom typedefs
+    const broadcastProtocol: unique symbol;
+    const drainableProtocol: unique symbol;
+    const shareProtocol: unique symbol;
+    const shareSyncProtocol: unique symbol;
+    const toAsyncStreamable: unique symbol;
+    const toStreamable: unique symbol;
+    type Source =
+        | string
+        | ArrayBufferLike
+        | ArrayBufferView
+        | Iterable<SyncSource>
+        | AsyncIterable<Source>
+        | Streamable
+        | AsyncStreamable;
+    type SyncSource = string | ArrayBufferLike | ArrayBufferView | Iterable<SyncSource> | Streamable;
+    type Transform = StatelessTransformFn | StatefulTransform;
+    type SyncTransform = SyncStatelessTransformFn | SyncStatefulTransform;
+    type TransformResult =
+        | string
+        | ArrayBufferLike
+        | ArrayBufferView
+        | Iterable<SyncTransformResult>
+        | AsyncIterable<TransformResult>;
+    type SyncTransformResult = string | ArrayBufferLike | ArrayBufferView | Iterable<SyncTransformResult>;
+    interface AsyncStreamable {
+        [toAsyncStreamable](): Source;
+    }
+    interface Broadcastable {
+        [broadcastProtocol](options: BroadcastOptions): Broadcast;
+    }
+    interface Drainable {
+        [drainableProtocol](): Promise<boolean> | null;
+    }
+    interface Shareable {
+        [shareProtocol](options: ShareOptions): Share;
+    }
+    interface Streamable {
+        [toStreamable](): SyncSource;
+    }
+    interface SyncShareable {
+        [shareSyncProtocol](options: ShareSyncOptions): SyncShare;
+    }
+    // IDL dictionaries, enums, typedefs
+    type BackpressurePolicy = "strict" | "block" | "drop-oldest" | "drop-newest";
+    type ByteReadableStream = AsyncIterable<Uint8Array[]>;
+    type SyncByteReadableStream = Iterable<Uint8Array[]>;
+    interface WriteOptions {
+        signal?: AbortSignal;
+    }
+    interface PushStreamOptions {
+        highWaterMark?: number;
+        backpressure?: BackpressurePolicy;
+        signal?: AbortSignal;
+    }
+    interface PullOptions {
+        signal?: AbortSignal;
+    }
+    interface PipeToOptions {
+        signal?: AbortSignal;
+        preventClose?: boolean;
+        preventFail?: boolean;
+    }
+    interface PipeToSyncOptions {
+        preventClose?: boolean;
+        preventFail?: boolean;
+    }
+    interface ConsumeOptions {
+        signal?: AbortSignal;
+        limit?: number;
+    }
+    interface ConsumeSyncOptions {
+        limit?: number;
+    }
+    interface TextConsumeOptions extends ConsumeOptions {
+        encoding?: string;
+    }
+    interface TextConsumeSyncOptions extends ConsumeSyncOptions {
+        encoding?: string;
+    }
+    interface MergeOptions {
+        signal?: AbortSignal;
+    }
+    interface BroadcastOptions {
+        highWaterMark?: number;
+        backpressure?: BackpressurePolicy;
+        signal?: AbortSignal;
+    }
+    interface ShareOptions {
+        highWaterMark?: number;
+        backpressure?: BackpressurePolicy;
+        signal?: AbortSignal;
+    }
+    interface ShareSyncOptions {
+        highWaterMark?: number;
+        backpressure?: BackpressurePolicy;
+    }
+    interface DuplexDirectionOptions {
+        highWaterMark?: number;
+        backpressure?: BackpressurePolicy;
+    }
+    interface DuplexOptions {
+        highWaterMark?: number;
+        backpressure?: BackpressurePolicy;
+        a?: DuplexDirectionOptions;
+        b?: DuplexDirectionOptions;
+        signal?: AbortSignal;
+    }
+    interface TransformCallbackOptions {
+        signal: AbortSignal;
+    }
+    interface StatelessTransformFn {
+        (chunks: Uint8Array[] | null, options: TransformCallbackOptions): TransformResult | null;
+    }
+    interface SyncStatelessTransformFn {
+        (chunks: Uint8Array[] | null): SyncTransformResult | null;
+    }
+    interface StatefulTransform {
+        transform(
+            source: AsyncIterable<Uint8Array[] | null>,
+            options: TransformCallbackOptions,
+        ): AsyncIterable<TransformResult>;
+    }
+    interface SyncStatefulTransform {
+        transform(source: Iterable<Uint8Array[] | null>): Iterable<SyncTransformResult>;
+    }
+    // IDL interfaces
+    interface PushWriter extends Writer, Drainable {}
+    interface PushStreamResult {
+        writer: PushWriter;
+        readable: ByteReadableStream;
+    }
+    interface BroadcastWriter extends Writer, Drainable {}
+    interface BroadcastResult {
+        writer: BroadcastWriter;
+        broadcast: Broadcast;
+    }
+    interface Writer extends Disposable, AsyncDisposable {
+        readonly desiredSize: number | null;
+        write(chunk: Uint8Array | string, options?: WriteOptions): Promise<void>;
+        writev(chunks: Array<Uint8Array | string>, options?: WriteOptions): Promise<void>;
+        writeSync(chunk: Uint8Array | string): boolean;
+        writevSync(chunks: Array<Uint8Array | string>): boolean;
+        end(options?: WriteOptions): Promise<number>;
+        endSync(): number;
+        fail(reason?: any): void;
+    }
+    interface PartialWriter extends Partial<Writer> {
+        write(chunk: Uint8Array | string, options?: WriteOptions): Promise<void>;
+    }
+    interface SyncWriter extends Disposable {
+        readonly desiredSize: number | null;
+        writeSync(chunk: Uint8Array | string): number;
+        writevSync(chunks: Array<Uint8Array | string>): number;
+        endSync(): number;
+        fail(reason?: any): void;
+    }
+    interface PartialSyncWriter extends Partial<SyncWriter> {
+        writeSync(chunk: Uint8Array | string): number;
+    }
+    interface Broadcast extends Disposable {
+        readonly consumerCount: number;
+        readonly bufferSize: number;
+        push(...args: any[]): ByteReadableStream;
+        cancel(reason?: any): void;
+    }
+    interface Share extends Disposable {
+        readonly consumerCount: number;
+        readonly bufferSize: number;
+        pull(...args: any[]): ByteReadableStream;
+        cancel(reason?: any): void;
+    }
+    interface SyncShare extends Disposable {
+        readonly consumerCount: number;
+        readonly bufferSize: number;
+        pull(...args: any): SyncByteReadableStream;
+        cancel(reason?: any): void;
+    }
+    interface DuplexChannel extends AsyncDisposable {
+        readonly writer: Writer;
+        readonly readable: ByteReadableStream;
+        close(): Promise<void>;
+    }
+    // Push stream creation
+    function push(...transforms: Transform[]): PushStreamResult;
+    function push(...args: [...transforms: Transform[], options: PushStreamOptions]): PushStreamResult;
+    // Stream factories
+    function from(input: Source): ByteReadableStream;
+    function fromSync(input: SyncSource): SyncByteReadableStream;
+    // Pull pipelines
+    function pull(source: Source, ...transforms: Transform[]): ByteReadableStream;
+    function pull(
+        source: Source,
+        ...args: [...transforms: Transform[], options: PullOptions]
+    ): ByteReadableStream;
+    function pullSync(source: SyncSource, ...transforms: SyncTransform[]): SyncByteReadableStream;
+    // Pipe operations
+    function pipeTo(source: Source, writer: PartialWriter, options?: PipeToOptions): Promise<number>;
+    function pipeTo(source: Source, ...args: [...transforms: Transform[], writer: PartialWriter]): Promise<number>;
+    function pipeTo(
+        source: Source,
+        ...args: [...transforms: Transform[], writer: PartialWriter, options: PipeToOptions]
+    ): Promise<number>;
+    function pipeToSync(source: SyncSource, writer: PartialSyncWriter, options?: PipeToSyncOptions): number;
+    function pipeToSync(
+        source: SyncSource,
+        ...args: [...transforms: SyncTransform[], writer: PartialSyncWriter]
+    ): number;
+    function pipeToSync(
+        source: SyncSource,
+        ...args: [...transforms: SyncTransform[], writer: PartialSyncWriter, options: PipeToSyncOptions]
+    ): number;
+    // Consumers
+    function bytes(source: Source, options?: ConsumeOptions): Promise<Uint8Array>;
+    function bytesSync(source: SyncSource, options?: ConsumeSyncOptions): Uint8Array;
+    function text(source: Source, options?: TextConsumeOptions): Promise<string>;
+    function textSync(source: SyncSource, options?: TextConsumeSyncOptions): string;
+    function arrayBuffer(source: Source, options?: ConsumeOptions): Promise<ArrayBuffer>;
+    function arrayBufferSync(source: SyncSource, options?: ConsumeSyncOptions): ArrayBuffer;
+    function array(source: Source, options?: ConsumeOptions): Promise<Uint8Array[]>;
+    function arraySync(source: SyncSource, options?: ConsumeSyncOptions): Uint8Array[];
+    // Utilities
+    function tap(callback: StatelessTransformFn): StatelessTransformFn;
+    function tapSync(callback: SyncStatelessTransformFn): SyncStatelessTransformFn;
+    function merge(...sources: Source[]): ByteReadableStream;
+    function merge(...args: [...sources: Source[], options: MergeOptions]): ByteReadableStream;
+    function ondrain(drainable: any): Promise<boolean> | null;
+    // Multi-consumer
+    function broadcast(options?: BroadcastOptions): BroadcastResult;
+    function share(source: Source, options?: ShareOptions): Share;
+    function shareSync(source: SyncSource, options?: ShareSyncOptions): SyncShare;
+    // Duplex
+    function duplex(options?: DuplexOptions): [DuplexChannel, DuplexChannel];
+    // Node.js-specific extensions
+    namespace Broadcast {
+        /**
+         * Create a `Broadcast` from an existing source. The source is consumed
+         * automatically and pushed to all subscribers.
+         * @since v25.9.0
+         * @param options Same as `broadcast()`.
+         */
+        function from(
+            input: ByteReadableStream | SyncByteReadableStream | Broadcastable,
+            options?: BroadcastOptions,
+        ): BroadcastResult;
+    }
+    namespace Share {
+        /**
+         * Create a `Share` from an existing source.
+         * @since v25.9.0
+         * @param options Same as `share()`.
+         */
+        function from(input: ByteReadableStream | SyncByteReadableStream | Shareable, options?: ShareOptions): Share;
+    }
+    namespace SyncShare {
+        /**
+         * @since v25.9.0
+         */
+        function from(input: SyncByteReadableStream | SyncShareable, options?: ShareSyncOptions): SyncShare;
+    }
+    namespace Stream {
+        export {
+            array,
+            arrayBuffer,
+            arrayBufferSync,
+            arraySync,
+            broadcast,
+            broadcastProtocol,
+            bytes,
+            bytesSync,
+            drainableProtocol,
+            duplex,
+            from,
+            fromSync,
+            merge,
+            ondrain,
+            pipeTo,
+            pipeToSync,
+            pull,
+            pullSync,
+            push,
+            share,
+            shareProtocol,
+            shareSync,
+            shareSyncProtocol,
+            tap,
+            tapSync,
+            text,
+            textSync,
+            toAsyncStreamable,
+            toStreamable,
+        };
+    }
+}
+declare module "stream/iter" {
+    export * from "node:stream/iter";
+}

node/test.d.ts

@@ -1479,19 +1479,40 @@ declare module "node:test" {
              */
             cache?: boolean | undefined;
             /**
-             * The value to use as the mocked module's default export.
-             *
-             * If this value is not provided, ESM mocks do not include a default export.
-             * If the mock is a CommonJS or builtin module, this setting is used as the value of `module.exports`.
-             * If this value is not provided, CJS and builtin mocks use an empty object as the value of `module.exports`.
+             * Optional mocked exports. The `default` property, if
+             * provided, is used as the mocked module's default export. All other own
+             * enumerable properties are used as named exports.
+             * **This option cannot be used with `defaultExport` or `namedExports`.**
+             * * If the mock is a CommonJS or builtin module, `exports.default` is used as
+             *   the value of `module.exports`.
+             * * If `exports.default` is not provided for a CommonJS or builtin mock,
+             *   `module.exports` defaults to an empty object.
+             * * If named exports are provided with a non-object default export, the mock
+             *   throws an exception when used as a CommonJS or builtin module.
+             */
+            exports?: object | undefined;
+            /**
+             * An optional value used as the mocked module's default
+             * export. If this value is not provided, ESM mocks do not include a default
+             * export. If the mock is a CommonJS or builtin module, this setting is used as
+             * the value of `module.exports`. If this value is not provided, CJS and builtin
+             * mocks use an empty object as the value of `module.exports`.
+             * **This option cannot be used with `options.exports`.**
+             * This option is deprecated and will be removed in a later version.
+             * Prefer `options.exports.default`.
+             * @deprecated
              */
             defaultExport?: any;
             /**
-             * An object whose keys and values are used to create the named exports of the mock module.
-             *
-             * If the mock is a CommonJS or builtin module, these values are copied onto `module.exports`.
-             * Therefore, if a mock is created with both named exports and a non-object default export,
-             * the mock will throw an exception when used as a CJS or builtin module.
+             * An optional object whose keys and values are used to
+             * create the named exports of the mock module. If the mock is a CommonJS or
+             * builtin module, these values are copied onto `module.exports`. Therefore, if a
+             * mock is created with both named exports and a non-object default export, the
+             * mock will throw an exception when used as a CJS or builtin module.
+             * **This option cannot be used with `options.exports`.**
+             * This option is deprecated and will be removed in a later version.
+             * Prefer `options.exports`.
+             * @deprecated
              */
             namedExports?: object | undefined;
         }
@@ -1666,14 +1687,19 @@ declare module "node:test" {
              * [`--experimental-test-module-mocks`](https://nodejs.org/docs/latest-v25.x/api/cli.html#--experimental-test-module-mocks)
              * command-line flag.
              *
+             * **Note**: [module customization hooks](https://nodejs.org/docs/latest-v25.x/api/module.html#customization-hooks) registered via the **synchronous** API effect resolution of
+             * the `specifier` provided to `mock.module`. Customization hooks registered via the **asynchronous**
+             * API are currently ignored (because the test runner's loader is synchronous, and node does not
+             * support multi-chain / cross-chain loading).
+             *
              * The following example demonstrates how a mock is created for a module.
              *
              * ```js
              * test('mocks a builtin module in both module systems', async (t) => {
-             *   // Create a mock of 'node:readline' with a named export named 'fn', which
+             *   // Create a mock of 'node:readline' with a named export named 'foo', which
              *   // does not exist in the original 'node:readline' module.
              *   const mock = t.mock.module('node:readline', {
-             *     namedExports: { fn() { return 42; } },
+             *     exports: { foo: () => 42 },
              *   });
              *
              *   let esmImpl = await import('node:readline');

node/ts5.6/index.d.ts

@@ -97,6 +97,7 @@
 /// <reference path="../sqlite.d.ts" />
 /// <reference path="../stream.d.ts" />
 /// <reference path="../stream/consumers.d.ts" />
+/// <reference path="../stream/iter.d.ts" />
 /// <reference path="../stream/promises.d.ts" />
 /// <reference path="../stream/web.d.ts" />
 /// <reference path="../string_decoder.d.ts" />
@@ -115,3 +116,4 @@
 /// <reference path="../wasi.d.ts" />
 /// <reference path="../worker_threads.d.ts" />
 /// <reference path="../zlib.d.ts" />
+/// <reference path="../zlib/iter.d.ts" />

node/ts5.7/index.d.ts

@@ -97,6 +97,7 @@
 /// <reference path="../sqlite.d.ts" />
 /// <reference path="../stream.d.ts" />
 /// <reference path="../stream/consumers.d.ts" />
+/// <reference path="../stream/iter.d.ts" />
 /// <reference path="../stream/promises.d.ts" />
 /// <reference path="../stream/web.d.ts" />
 /// <reference path="../string_decoder.d.ts" />
@@ -115,3 +116,4 @@
 /// <reference path="../wasi.d.ts" />
 /// <reference path="../worker_threads.d.ts" />
 /// <reference path="../zlib.d.ts" />
+/// <reference path="../zlib/iter.d.ts" />

node/vm.d.ts

@@ -232,11 +232,12 @@ declare module "node:vm" {
          *
          * 1. Creates a new context.
          * 2. If `contextObject` is an object, contextifies it with the new context.
-         *    If  `contextObject` is undefined, creates a new object and contextifies it.
+         *    If `contextObject` is undefined, creates a new object and contextifies it.
          *    If `contextObject` is `vm.constants.DONT_CONTEXTIFY`, don't contextify anything.
-         * 3. Runs the compiled code contained by the `vm.Script` object within the created context. The code
-         *    does not have access to the scope in which this method is called.
-         * 4. Returns the result.
+         * 3. Compiles the code as a `vm.Script`
+         * 4. Runs the compiled code within the created context. The code does not have access to the scope in
+         *    which this method is called.
+         * 5. Returns the result.
          *
          * The following example compiles code that sets a global variable, then executes
          * the code multiple times in different contexts. The globals are set on and

node/zlib/iter.d.ts

@@ -0,0 +1,131 @@
+declare module "node:zlib/iter" {
+    import { StatefulTransform, SyncStatefulTransform } from "node:stream/iter";
+    interface BrotliOptions {
+        chunkSize?: number | undefined;
+        params?: { [key: number]: number | boolean } | undefined;
+        dictionary?: NodeJS.ArrayBufferView | undefined;
+    }
+    interface ZlibOptions {
+        chunkSize?: number | undefined;
+        windowBits?: number | undefined;
+        dictionary?: NodeJS.ArrayBufferView | undefined;
+    }
+    interface ZlibCompressionOptions extends ZlibOptions {
+        level?: number | undefined;
+        memLevel?: number | undefined;
+        strategy?: number | undefined;
+    }
+    interface ZstdOptions {
+        chunkSize?: number | undefined;
+        params?: { [key: number]: number | boolean } | undefined;
+        dictionary?: NodeJS.ArrayBufferView | undefined;
+    }
+    interface ZstdCompressionOptions extends ZstdOptions {
+        pledgedSrcSize?: number | undefined;
+    }
+    /**
+     * Create a Brotli compression transform. Output is compatible with
+     * `zlib.brotliDecompress()` and `decompressBrotli()`/`decompressBrotliSync()`.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function compressBrotli(options?: BrotliOptions): StatefulTransform;
+    /**
+     * Create a Brotli compression transform. Output is compatible with
+     * `zlib.brotliDecompress()` and `decompressBrotli()`/`decompressBrotliSync()`.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function compressBrotliSync(options?: BrotliOptions): SyncStatefulTransform;
+    /**
+     * Create a deflate compression transform. Output is compatible with
+     * `zlib.inflate()` and `decompressDeflate()`/`decompressDeflateSync()`.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function compressDeflate(options?: ZlibCompressionOptions): StatefulTransform;
+    /**
+     * Create a deflate compression transform. Output is compatible with
+     * `zlib.inflate()` and `decompressDeflate()`/`decompressDeflateSync()`.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function compressDeflateSync(options?: ZlibCompressionOptions): SyncStatefulTransform;
+    /**
+     * Create a gzip compression transform. Output is compatible with `zlib.gunzip()`
+     * and `decompressGzip()`/`decompressGzipSync()`.
+     * @returns A stateful transform.
+     */
+    function compressGzip(options?: ZlibCompressionOptions): StatefulTransform;
+    /**
+     * Create a gzip compression transform. Output is compatible with `zlib.gunzip()`
+     * and `decompressGzip()`/`decompressGzipSync()`.
+     * @returns A stateful transform.
+     */
+    function compressGzipSync(options?: ZlibCompressionOptions): SyncStatefulTransform;
+    /**
+     * Create a Zstandard compression transform. Output is compatible with
+     * `zlib.zstdDecompress()` and `decompressZstd()`/`decompressZstdSync()`.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function compressZstd(options?: ZstdCompressionOptions): StatefulTransform;
+    /**
+     * Create a Zstandard compression transform. Output is compatible with
+     * `zlib.zstdDecompress()` and `decompressZstd()`/`decompressZstdSync()`.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function compressZstdSync(options?: ZstdCompressionOptions): SyncStatefulTransform;
+    /**
+     * Create a Brotli decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressBrotli(options?: BrotliOptions): StatefulTransform;
+    /**
+     * Create a Brotli decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressBrotliSync(options?: BrotliOptions): SyncStatefulTransform;
+    /**
+     * Create a deflate decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressDeflate(options?: ZlibOptions): StatefulTransform;
+    /**
+     * Create a deflate decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressDeflateSync(options?: ZlibOptions): SyncStatefulTransform;
+    /**
+     * Create a gzip decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressGzip(options?: ZlibOptions): StatefulTransform;
+    /**
+     * Create a gzip decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressGzipSync(options?: ZlibOptions): SyncStatefulTransform;
+    /**
+     * Create a Zstandard decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressZstd(options?: ZstdOptions): StatefulTransform;
+    /**
+     * Create a Zstandard decompression transform.
+     * @since v25.9.0
+     * @returns A stateful transform.
+     */
+    function decompressZstdSync(options?: ZstdOptions): SyncStatefulTransform;
+}
+declare module "zlib/iter" {
+    export * from "node:zlib/iter";
+}