@rio-cloud/cdk-v2-constructs 8.2.0 → 8.2.1-alpha.0

package/node_modules/@types/node/worker_threads.d.ts

@@ -3,7 +3,7 @@
  * JavaScript in parallel. To access it:
  *
  * ```js
- * const worker = require('node:worker_threads');
+ * import worker_threads from 'node:worker_threads';
  * ```
  *
  * Workers (threads) are useful for performing CPU-intensive JavaScript operations.
@@ -11,32 +11,35 @@
  * asynchronous I/O operations are more efficient than Workers can be.
  *
  * Unlike `child_process` or `cluster`, `worker_threads` can share memory. They do
- * so by transferring `ArrayBuffer` instances or sharing `SharedArrayBuffer`instances.
+ * so by transferring `ArrayBuffer` instances or sharing `SharedArrayBuffer` instances.
  *
  * ```js
- * const {
- *   Worker, isMainThread, parentPort, workerData,
- * } = require('node:worker_threads');
+ * import {
+ *   Worker,
+ *   isMainThread,
+ *   parentPort,
+ *   workerData,
+ * } from 'node:worker_threads';
  *
- * if (isMainThread) {
- *   module.exports = function parseJSAsync(script) {
- *     return new Promise((resolve, reject) => {
- *       const worker = new Worker(__filename, {
- *         workerData: script,
- *       });
- *       worker.on('message', resolve);
- *       worker.on('error', reject);
- *       worker.on('exit', (code) => {
- *         if (code !== 0)
- *           reject(new Error(`Worker stopped with exit code ${code}`));
- *       });
- *     });
- *   };
- * } else {
- *   const { parse } = require('some-js-parsing-library');
+ * if (!isMainThread) {
+ *   const { parse } = await import('some-js-parsing-library');
  *   const script = workerData;
  *   parentPort.postMessage(parse(script));
  * }
+ *
+ * export default function parseJSAsync(script) {
+ *   return new Promise((resolve, reject) => {
+ *     const worker = new Worker(new URL(import.meta.url), {
+ *       workerData: script,
+ *     });
+ *     worker.on('message', resolve);
+ *     worker.once('error', reject);
+ *     worker.once('exit', (code) => {
+ *       if (code !== 0)
+ *         reject(new Error(`Worker stopped with exit code ${code}`));
+ *     });
+ *   });
+ * };
  * ```
  *
  * The above example spawns a Worker thread for each `parseJSAsync()` call. In
@@ -49,30 +52,33 @@
  *
  * Worker threads inherit non-process-specific options by default. Refer to `Worker constructor options` to know how to customize worker thread options,
  * specifically `argv` and `execArgv` options.
- * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/worker_threads.js)
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/worker_threads.js)
  */
 declare module "worker_threads" {
-    import { Blob } from "node:buffer";
     import { Context } from "node:vm";
-    import { EventEmitter } from "node:events";
-    import { EventLoopUtilityFunction } from "node:perf_hooks";
+    import { EventEmitter, NodeEventTarget } from "node:events";
     import { FileHandle } from "node:fs/promises";
+    import { Performance } from "node:perf_hooks";
     import { Readable, Writable } from "node:stream";
+    import { ReadableStream, TransformStream, WritableStream } from "node:stream/web";
     import { URL } from "node:url";
-    import { X509Certificate } from "node:crypto";
+    import { CPUProfileHandle, HeapInfo, HeapProfileHandle } from "node:v8";
+    import { MessageEvent } from "undici-types";
+    const isInternalThread: boolean;
     const isMainThread: boolean;
     const parentPort: null | MessagePort;
     const resourceLimits: ResourceLimits;
     const SHARE_ENV: unique symbol;
     const threadId: number;
+    const threadName: string | null;
     const workerData: any;
     /**
      * Instances of the `worker.MessageChannel` class represent an asynchronous,
      * two-way communications channel.
-     * The `MessageChannel` has no methods of its own. `new MessageChannel()`yields an object with `port1` and `port2` properties, which refer to linked `MessagePort` instances.
+     * The `MessageChannel` has no methods of its own. `new MessageChannel()` yields an object with `port1` and `port2` properties, which refer to linked `MessagePort` instances.
      *
      * ```js
-     * const { MessageChannel } = require('node:worker_threads');
+     * import { MessageChannel } from 'node:worker_threads';
      *
      * const { port1, port2 } = new MessageChannel();
      * port1.on('message', (message) => console.log('received', message));
@@ -85,22 +91,30 @@ declare module "worker_threads" {
         readonly port1: MessagePort;
         readonly port2: MessagePort;
     }
-    interface WorkerPerformance {
-        eventLoopUtilization: EventLoopUtilityFunction;
-    }
-    type TransferListItem = ArrayBuffer | MessagePort | FileHandle | X509Certificate | Blob;
+    interface WorkerPerformance extends Pick<Performance, "eventLoopUtilization"> {}
+    type Transferable =
+        | ArrayBuffer
+        | MessagePort
+        | AbortSignal
+        | FileHandle
+        | ReadableStream
+        | WritableStream
+        | TransformStream;
+    /** @deprecated Use `import { Transferable } from "node:worker_threads"` instead. */
+    // TODO: remove in a future major @types/node version.
+    type TransferListItem = Transferable;
     /**
      * Instances of the `worker.MessagePort` class represent one end of an
      * asynchronous, two-way communications channel. It can be used to transfer
-     * structured data, memory regions and other `MessagePort`s between different `Worker` s.
+     * structured data, memory regions and other `MessagePort`s between different `Worker`s.
      *
      * This implementation matches [browser `MessagePort`](https://developer.mozilla.org/en-US/docs/Web/API/MessagePort) s.
      * @since v10.5.0
      */
-    class MessagePort extends EventEmitter {
+    class MessagePort implements EventTarget {
         /**
          * Disables further sending of messages on either side of the connection.
-         * This method can be called when no further communication will happen over this`MessagePort`.
+         * This method can be called when no further communication will happen over this `MessagePort`.
          *
          * The `'close' event` is emitted on both `MessagePort` instances that
          * are part of the channel.
@@ -108,20 +122,20 @@ declare module "worker_threads" {
          */
         close(): void;
         /**
-         * Sends a JavaScript value to the receiving side of this channel.`value` is transferred in a way which is compatible with
+         * Sends a JavaScript value to the receiving side of this channel. `value` is transferred in a way which is compatible with
          * the [HTML structured clone algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm).
          *
          * In particular, the significant differences to `JSON` are:
          *
          * * `value` may contain circular references.
-         * * `value` may contain instances of builtin JS types such as `RegExp`s,`BigInt`s, `Map`s, `Set`s, etc.
+         * * `value` may contain instances of builtin JS types such as `RegExp`s, `BigInt`s, `Map`s, `Set`s, etc.
          * * `value` may contain typed arrays, both using `ArrayBuffer`s
          * and `SharedArrayBuffer`s.
          * * `value` may contain [`WebAssembly.Module`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Module) instances.
          * * `value` may not contain native (C++-backed) objects other than:
          *
          * ```js
-         * const { MessageChannel } = require('node:worker_threads');
+         * import { MessageChannel } from 'node:worker_threads';
          * const { port1, port2 } = new MessageChannel();
          *
          * port1.on('message', (message) => console.log(message));
@@ -140,10 +154,10 @@ declare module "worker_threads" {
          * If `value` contains [`SharedArrayBuffer`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer) instances, those are accessible
          * from either thread. They cannot be listed in `transferList`.
          *
-         * `value` may still contain `ArrayBuffer` instances that are not in`transferList`; in that case, the underlying memory is copied rather than moved.
+         * `value` may still contain `ArrayBuffer` instances that are not in `transferList`; in that case, the underlying memory is copied rather than moved.
          *
          * ```js
-         * const { MessageChannel } = require('node:worker_threads');
+         * import { MessageChannel } from 'node:worker_threads';
          * const { port1, port2 } = new MessageChannel();
          *
          * port1.on('message', (message) => console.log(message));
@@ -173,7 +187,12 @@ declare module "worker_threads" {
          * behind this API, see the `serialization API of the node:v8 module`.
          * @since v10.5.0
          */
-        postMessage(value: any, transferList?: readonly TransferListItem[]): void;
+        postMessage(value: any, transferList?: readonly Transferable[]): void;
+        /**
+         * If true, the `MessagePort` object will keep the Node.js event loop active.
+         * @since v18.1.0, v16.17.0
+         */
+        hasRef(): boolean;
         /**
          * Opposite of `unref()`. Calling `ref()` on a previously `unref()`ed port does _not_ let the program exit if it's the only active handle left (the default
          * behavior). If the port is `ref()`ed, calling `ref()` again has no effect.
@@ -186,16 +205,16 @@ declare module "worker_threads" {
         ref(): void;
         /**
          * Calling `unref()` on a port allows the thread to exit if this is the only
-         * active handle in the event system. If the port is already `unref()`ed calling`unref()` again has no effect.
+         * active handle in the event system. If the port is already `unref()`ed calling `unref()` again has no effect.
          *
-         * If listeners are attached or removed using `.on('message')`, the port is`ref()`ed and `unref()`ed automatically depending on whether
+         * If listeners are attached or removed using `.on('message')`, the port is `ref()`ed and `unref()`ed automatically depending on whether
          * listeners for the event exist.
          * @since v10.5.0
          */
         unref(): void;
         /**
          * Starts receiving messages on this `MessagePort`. When using this port
-         * as an event emitter, this is called automatically once `'message'`listeners are attached.
+         * as an event emitter, this is called automatically once `'message'` listeners are attached.
          *
          * This method exists for parity with the Web `MessagePort` API. In Node.js,
          * it is only useful for ignoring messages when no event listener is present.
@@ -205,39 +224,32 @@ declare module "worker_threads" {
          * @since v10.5.0
          */
         start(): void;
-        addListener(event: "close", listener: () => void): this;
+        addListener(event: "close", listener: (ev: Event) => void): this;
         addListener(event: "message", listener: (value: any) => void): this;
         addListener(event: "messageerror", listener: (error: Error) => void): this;
-        addListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        emit(event: "close"): boolean;
+        addListener(event: string, listener: (arg: any) => void): this;
+        emit(event: "close", ev: Event): boolean;
         emit(event: "message", value: any): boolean;
         emit(event: "messageerror", error: Error): boolean;
-        emit(event: string | symbol, ...args: any[]): boolean;
-        on(event: "close", listener: () => void): this;
+        emit(event: string, arg: any): boolean;
+        off(event: "close", listener: (ev: Event) => void, options?: EventListenerOptions): this;
+        off(event: "message", listener: (value: any) => void, options?: EventListenerOptions): this;
+        off(event: "messageerror", listener: (error: Error) => void, options?: EventListenerOptions): this;
+        off(event: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
+        on(event: "close", listener: (ev: Event) => void): this;
         on(event: "message", listener: (value: any) => void): this;
         on(event: "messageerror", listener: (error: Error) => void): this;
-        on(event: string | symbol, listener: (...args: any[]) => void): this;
-        once(event: "close", listener: () => void): this;
+        on(event: string, listener: (arg: any) => void): this;
+        once(event: "close", listener: (ev: Event) => void): this;
         once(event: "message", listener: (value: any) => void): this;
         once(event: "messageerror", listener: (error: Error) => void): this;
-        once(event: string | symbol, listener: (...args: any[]) => void): this;
-        prependListener(event: "close", listener: () => void): this;
-        prependListener(event: "message", listener: (value: any) => void): this;
-        prependListener(event: "messageerror", listener: (error: Error) => void): this;
-        prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        prependOnceListener(event: "close", listener: () => void): this;
-        prependOnceListener(event: "message", listener: (value: any) => void): this;
-        prependOnceListener(event: "messageerror", listener: (error: Error) => void): this;
-        prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        removeListener(event: "close", listener: () => void): this;
-        removeListener(event: "message", listener: (value: any) => void): this;
-        removeListener(event: "messageerror", listener: (error: Error) => void): this;
-        removeListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        off(event: "close", listener: () => void): this;
-        off(event: "message", listener: (value: any) => void): this;
-        off(event: "messageerror", listener: (error: Error) => void): this;
-        off(event: string | symbol, listener: (...args: any[]) => void): this;
+        once(event: string, listener: (arg: any) => void): this;
+        removeListener(event: "close", listener: (ev: Event) => void, options?: EventListenerOptions): this;
+        removeListener(event: "message", listener: (value: any) => void, options?: EventListenerOptions): this;
+        removeListener(event: "messageerror", listener: (error: Error) => void, options?: EventListenerOptions): this;
+        removeListener(event: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
     }
+    interface MessagePort extends NodeEventTarget {}
     interface WorkerOptions {
         /**
          * List of arguments which would be stringified and appended to
@@ -257,14 +269,14 @@ declare module "worker_threads" {
         /**
          * Additional data to send in the first worker message.
          */
-        transferList?: TransferListItem[] | undefined;
+        transferList?: Transferable[] | undefined;
         /**
          * @default true
          */
         trackUnmanagedFds?: boolean | undefined;
         /**
          * An optional `name` to be appended to the worker title
-         * for debuggin/identification purposes, making the final title as
+         * for debugging/identification purposes, making the final title as
          * `[worker ${id}] ${name}`.
          */
         name?: string | undefined;
@@ -295,8 +307,8 @@ declare module "worker_threads" {
      * Notable differences inside a Worker environment are:
      *
      * * The `process.stdin`, `process.stdout`, and `process.stderr` streams may be redirected by the parent thread.
-     * * The `require('node:worker_threads').isMainThread` property is set to `false`.
-     * * The `require('node:worker_threads').parentPort` message port is available.
+     * * The `import { isMainThread } from 'node:worker_threads'` variable is set to `false`.
+     * * The `import { parentPort } from 'node:worker_threads'` message port is available.
      * * `process.exit()` does not stop the whole program, just the single thread,
      * and `process.abort()` is not available.
      * * `process.chdir()` and `process` methods that set group or user ids
@@ -331,10 +343,10 @@ declare module "worker_threads" {
      * the thread barrier.
      *
      * ```js
-     * const assert = require('node:assert');
-     * const {
+     * import assert from 'node:assert';
+     * import {
      *   Worker, MessageChannel, MessagePort, isMainThread, parentPort,
-     * } = require('node:worker_threads');
+     * } from 'node:worker_threads';
      * if (isMainThread) {
      *   const worker = new Worker(__filename);
      *   const subChannel = new MessageChannel();
@@ -374,11 +386,17 @@ declare module "worker_threads" {
         readonly stderr: Readable;
         /**
          * An integer identifier for the referenced thread. Inside the worker thread,
-         * it is available as `require('node:worker_threads').threadId`.
+         * it is available as `import { threadId } from 'node:worker_threads'`.
          * This value is unique for each `Worker` instance inside a single process.
          * @since v10.5.0
          */
         readonly threadId: number;
+        /**
+         * A string identifier for the referenced thread or null if the thread is not running.
+         * Inside the worker thread, it is available as `require('node:worker_threads').threadName`.
+         * @since v24.6.0
+         */
+        readonly threadName: string | null;
         /**
          * Provides the set of JS engine resource constraints for this Worker thread.
          * If the `resourceLimits` option was passed to the `Worker` constructor,
@@ -390,7 +408,7 @@ declare module "worker_threads" {
         readonly resourceLimits?: ResourceLimits | undefined;
         /**
          * An object that can be used to query performance information from a worker
-         * instance. Similar to `perf_hooks.performance`.
+         * instance.
          * @since v15.1.0, v14.17.0, v12.22.0
          */
         readonly performance: WorkerPerformance;
@@ -405,7 +423,7 @@ declare module "worker_threads" {
          * See `port.postMessage()` for more details.
          * @since v10.5.0
          */
-        postMessage(value: any, transferList?: readonly TransferListItem[]): void;
+        postMessage(value: any, transferList?: readonly Transferable[]): void;
         /**
          * Opposite of `unref()`, calling `ref()` on a previously `unref()`ed worker does _not_ let the program exit if it's the only active handle left (the default
          * behavior). If the worker is `ref()`ed, calling `ref()` again has
@@ -415,7 +433,7 @@ declare module "worker_threads" {
         ref(): void;
         /**
          * Calling `unref()` on a worker allows the thread to exit if this is the only
-         * active handle in the event system. If the worker is already `unref()`ed calling`unref()` again has no effect.
+         * active handle in the event system. If the worker is already `unref()`ed calling `unref()` again has no effect.
          * @since v10.5.0
          */
         unref(): void;
@@ -425,6 +443,13 @@ declare module "worker_threads" {
          * @since v10.5.0
          */
         terminate(): Promise<number>;
+        /**
+         * This method returns a `Promise` that will resolve to an object identical to {@link process.threadCpuUsage()},
+         * or reject with an [`ERR_WORKER_NOT_RUNNING`](https://nodejs.org/docs/latest-v24.x/api/errors.html#err_worker_not_running) error if the worker is no longer running.
+         * This methods allows the statistics to be observed from outside the actual thread.
+         * @since v24.6.0
+         */
+        cpuUsage(prev?: NodeJS.CpuUsage): Promise<NodeJS.CpuUsage>;
         /**
          * Returns a readable stream for a V8 snapshot of the current state of the Worker.
          * See `v8.getHeapSnapshot()` for more details.
@@ -435,49 +460,143 @@ declare module "worker_threads" {
          * @return A promise for a Readable Stream containing a V8 heap snapshot
          */
         getHeapSnapshot(): Promise<Readable>;
-        addListener(event: "error", listener: (err: Error) => void): this;
+        /**
+         * This method returns a `Promise` that will resolve to an object identical to `v8.getHeapStatistics()`,
+         * or reject with an `ERR_WORKER_NOT_RUNNING` error if the worker is no longer running.
+         * This methods allows the statistics to be observed from outside the actual thread.
+         * @since v24.0.0
+         */
+        getHeapStatistics(): Promise<HeapInfo>;
+        /**
+         * Starting a CPU profile then return a Promise that fulfills with an error
+         * or an `CPUProfileHandle` object. This API supports `await using` syntax.
+         *
+         * ```js
+         * const { Worker } = require('node:worker_threads');
+         *
+         * const worker = new Worker(`
+         *   const { parentPort } = require('worker_threads');
+         *   parentPort.on('message', () => {});
+         *   `, { eval: true });
+         *
+         * worker.on('online', async () => {
+         *   const handle = await worker.startCpuProfile();
+         *   const profile = await handle.stop();
+         *   console.log(profile);
+         *   worker.terminate();
+         * });
+         * ```
+         *
+         * `await using` example.
+         *
+         * ```js
+         * const { Worker } = require('node:worker_threads');
+         *
+         * const w = new Worker(`
+         *   const { parentPort } = require('node:worker_threads');
+         *   parentPort.on('message', () => {});
+         *   `, { eval: true });
+         *
+         * w.on('online', async () => {
+         *   // Stop profile automatically when return and profile will be discarded
+         *   await using handle = await w.startCpuProfile();
+         * });
+         * ```
+         * @since v24.8.0
+         */
+        startCpuProfile(): Promise<CPUProfileHandle>;
+        /**
+         * Starting a Heap profile then return a Promise that fulfills with an error
+         * or an `HeapProfileHandle` object. This API supports `await using` syntax.
+         *
+         * ```js
+         * const { Worker } = require('node:worker_threads');
+         *
+         * const worker = new Worker(`
+         *   const { parentPort } = require('worker_threads');
+         *   parentPort.on('message', () => {});
+         *   `, { eval: true });
+         *
+         * worker.on('online', async () => {
+         *   const handle = await worker.startHeapProfile();
+         *   const profile = await handle.stop();
+         *   console.log(profile);
+         *   worker.terminate();
+         * });
+         * ```
+         *
+         * `await using` example.
+         *
+         * ```js
+         * const { Worker } = require('node:worker_threads');
+         *
+         * const w = new Worker(`
+         *   const { parentPort } = require('node:worker_threads');
+         *   parentPort.on('message', () => {});
+         *   `, { eval: true });
+         *
+         * w.on('online', async () => {
+         *   // Stop profile automatically when return and profile will be discarded
+         *   await using handle = await w.startHeapProfile();
+         * });
+         * ```
+         */
+        startHeapProfile(): Promise<HeapProfileHandle>;
+        /**
+         * Calls `worker.terminate()` when the dispose scope is exited.
+         *
+         * ```js
+         * async function example() {
+         *   await using worker = new Worker('for (;;) {}', { eval: true });
+         *   // Worker is automatically terminate when the scope is exited.
+         * }
+         * ```
+         * @since v24.2.0
+         */
+        [Symbol.asyncDispose](): Promise<void>;
+        addListener(event: "error", listener: (err: any) => void): this;
         addListener(event: "exit", listener: (exitCode: number) => void): this;
         addListener(event: "message", listener: (value: any) => void): this;
         addListener(event: "messageerror", listener: (error: Error) => void): this;
         addListener(event: "online", listener: () => void): this;
         addListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        emit(event: "error", err: Error): boolean;
+        emit(event: "error", err: any): boolean;
         emit(event: "exit", exitCode: number): boolean;
         emit(event: "message", value: any): boolean;
         emit(event: "messageerror", error: Error): boolean;
         emit(event: "online"): boolean;
         emit(event: string | symbol, ...args: any[]): boolean;
-        on(event: "error", listener: (err: Error) => void): this;
+        on(event: "error", listener: (err: any) => void): this;
         on(event: "exit", listener: (exitCode: number) => void): this;
         on(event: "message", listener: (value: any) => void): this;
         on(event: "messageerror", listener: (error: Error) => void): this;
         on(event: "online", listener: () => void): this;
         on(event: string | symbol, listener: (...args: any[]) => void): this;
-        once(event: "error", listener: (err: Error) => void): this;
+        once(event: "error", listener: (err: any) => void): this;
         once(event: "exit", listener: (exitCode: number) => void): this;
         once(event: "message", listener: (value: any) => void): this;
         once(event: "messageerror", listener: (error: Error) => void): this;
         once(event: "online", listener: () => void): this;
         once(event: string | symbol, listener: (...args: any[]) => void): this;
-        prependListener(event: "error", listener: (err: Error) => void): this;
+        prependListener(event: "error", listener: (err: any) => void): this;
         prependListener(event: "exit", listener: (exitCode: number) => void): this;
         prependListener(event: "message", listener: (value: any) => void): this;
         prependListener(event: "messageerror", listener: (error: Error) => void): this;
         prependListener(event: "online", listener: () => void): this;
         prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        prependOnceListener(event: "error", listener: (err: Error) => void): this;
+        prependOnceListener(event: "error", listener: (err: any) => void): this;
         prependOnceListener(event: "exit", listener: (exitCode: number) => void): this;
         prependOnceListener(event: "message", listener: (value: any) => void): this;
         prependOnceListener(event: "messageerror", listener: (error: Error) => void): this;
         prependOnceListener(event: "online", listener: () => void): this;
         prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        removeListener(event: "error", listener: (err: Error) => void): this;
+        removeListener(event: "error", listener: (err: any) => void): this;
         removeListener(event: "exit", listener: (exitCode: number) => void): this;
         removeListener(event: "message", listener: (value: any) => void): this;
         removeListener(event: "messageerror", listener: (error: Error) => void): this;
         removeListener(event: "online", listener: () => void): this;
         removeListener(event: string | symbol, listener: (...args: any[]) => void): this;
-        off(event: "error", listener: (err: Error) => void): this;
+        off(event: "error", listener: (err: any) => void): this;
         off(event: "exit", listener: (exitCode: number) => void): this;
         off(event: "message", listener: (value: any) => void): this;
         off(event: "messageerror", listener: (error: Error) => void): this;
@@ -492,11 +611,11 @@ declare module "worker_threads" {
      * ```js
      * 'use strict';
      *
-     * const {
+     * import {
      *   isMainThread,
      *   BroadcastChannel,
      *   Worker,
-     * } = require('node:worker_threads');
+     * } from 'node:worker_threads';
      *
      * const bc = new BroadcastChannel('hello');
      *
@@ -515,18 +634,18 @@ declare module "worker_threads" {
      * ```
      * @since v15.4.0
      */
-    class BroadcastChannel {
+    class BroadcastChannel extends EventTarget {
         readonly name: string;
         /**
          * Invoked with a single \`MessageEvent\` argument when a message is received.
          * @since v15.4.0
          */
-        onmessage: (message: unknown) => void;
+        onmessage: (message: MessageEvent) => void;
         /**
          * Invoked with a received message cannot be deserialized.
          * @since v15.4.0
          */
-        onmessageerror: (message: unknown) => void;
+        onmessageerror: (message: MessageEvent) => void;
         constructor(name: string);
         /**
          * Closes the `BroadcastChannel` connection.
@@ -539,9 +658,38 @@ declare module "worker_threads" {
          */
         postMessage(message: unknown): void;
     }
+    interface Lock {
+        readonly mode: LockMode;
+        readonly name: string;
+    }
+    interface LockGrantedCallback<T> {
+        (lock: Lock | null): T;
+    }
+    interface LockInfo {
+        clientId: string;
+        mode: LockMode;
+        name: string;
+    }
+    interface LockManager {
+        query(): Promise<LockManagerSnapshot>;
+        request<T>(name: string, callback: LockGrantedCallback<T>): Promise<Awaited<T>>;
+        request<T>(name: string, options: LockOptions, callback: LockGrantedCallback<T>): Promise<Awaited<T>>;
+    }
+    interface LockManagerSnapshot {
+        held: LockInfo[];
+        pending: LockInfo[];
+    }
+    type LockMode = "exclusive" | "shared";
+    interface LockOptions {
+        ifAvailable?: boolean;
+        mode?: LockMode;
+        signal?: AbortSignal;
+        steal?: boolean;
+    }
+    var locks: LockManager;
     /**
      * Mark an object as not transferable. If `object` occurs in the transfer list of
-     * a `port.postMessage()` call, it is ignored.
+     * a {@link MessagePort.postMessage port.postMessage()} call, it is ignored.
      *
      * In particular, this makes sense for objects that can be cloned, rather than
      * transferred, and which are used by other objects on the sending side.
@@ -550,7 +698,7 @@ declare module "worker_threads" {
      * This operation cannot be undone.
      *
      * ```js
-     * const { MessageChannel, markAsUntransferable } = require('node:worker_threads');
+     * import { MessageChannel, markAsUntransferable } from 'node:worker_threads';
      *
      * const pooledBuffer = new ArrayBuffer(8);
      * const typedArray1 = new Uint8Array(pooledBuffer);
@@ -574,7 +722,40 @@ declare module "worker_threads" {
      */
     function markAsUntransferable(object: object): void;
     /**
-     * Transfer a `MessagePort` to a different `vm` Context. The original `port`object is rendered unusable, and the returned `MessagePort` instance
+     * Check if an object is marked as not transferable with
+     * {@link markAsUntransferable}.
+     * @since v21.0.0
+     */
+    function isMarkedAsUntransferable(object: object): boolean;
+    /**
+     * Mark an object as not cloneable. If `object` is used as `message` in
+     * a `port.postMessage()` call, an error is thrown. This is a no-op if `object` is a
+     * primitive value.
+     *
+     * This has no effect on `ArrayBuffer`, or any `Buffer` like objects.
+     *
+     * This operation cannot be undone.
+     *
+     * ```js
+     * const { markAsUncloneable } = require('node:worker_threads');
+     *
+     * const anyObject = { foo: 'bar' };
+     * markAsUncloneable(anyObject);
+     * const { port1 } = new MessageChannel();
+     * try {
+     *   // This will throw an error, because anyObject is not cloneable.
+     *   port1.postMessage(anyObject)
+     * } catch (error) {
+     *   // error.name === 'DataCloneError'
+     * }
+     * ```
+     *
+     * There is no equivalent to this API in browsers.
+     * @since v22.10.0
+     */
+    function markAsUncloneable(object: object): void;
+    /**
+     * Transfer a `MessagePort` to a different `vm` Context. The original `port` object is rendered unusable, and the returned `MessagePort` instance
      * takes its place.
      *
      * The returned `MessagePort` is an object in the target context and
@@ -592,10 +773,10 @@ declare module "worker_threads" {
     function moveMessagePortToContext(port: MessagePort, contextifiedSandbox: Context): MessagePort;
     /**
      * Receive a single message from a given `MessagePort`. If no message is available,`undefined` is returned, otherwise an object with a single `message` property
-     * that contains the message payload, corresponding to the oldest message in the`MessagePort`'s queue.
+     * that contains the message payload, corresponding to the oldest message in the `MessagePort`'s queue.
      *
      * ```js
-     * const { MessageChannel, receiveMessageOnPort } = require('node:worker_threads');
+     * import { MessageChannel, receiveMessageOnPort } from 'node:worker_threads';
      * const { port1, port2 } = new MessageChannel();
      * port1.postMessage({ hello: 'world' });
      *
@@ -605,7 +786,7 @@ declare module "worker_threads" {
      * // Prints: undefined
      * ```
      *
-     * When this function is used, no `'message'` event is emitted and the`onmessage` listener is not invoked.
+     * When this function is used, no `'message'` event is emitted and the `onmessage` listener is not invoked.
      * @since v12.3.0
      */
     function receiveMessageOnPort(port: MessagePort):
@@ -621,32 +802,50 @@ declare module "worker_threads" {
      * automatically.
      *
      * ```js
-     * const {
+     * import {
      *   Worker,
      *   isMainThread,
      *   setEnvironmentData,
      *   getEnvironmentData,
-     * } = require('node:worker_threads');
+     * } from 'node:worker_threads';
      *
      * if (isMainThread) {
      *   setEnvironmentData('Hello', 'World!');
-     *   const worker = new Worker(__filename);
+     *   const worker = new Worker(new URL(import.meta.url));
      * } else {
      *   console.log(getEnvironmentData('Hello'));  // Prints 'World!'.
      * }
      * ```
      * @since v15.12.0, v14.18.0
-     * @param key Any arbitrary, cloneable JavaScript value that can be used as a {Map} key.
+     * @param key Any arbitrary, cloneable JavaScript value that can be used as a {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map Map} key.
      */
     function getEnvironmentData(key: Serializable): Serializable;
     /**
-     * The `worker.setEnvironmentData()` API sets the content of`worker.getEnvironmentData()` in the current thread and all new `Worker`instances spawned from the current context.
+     * The `worker.setEnvironmentData()` API sets the content of `worker.getEnvironmentData()` in the current thread and all new `Worker` instances spawned from the current context.
      * @since v15.12.0, v14.18.0
      * @param key Any arbitrary, cloneable JavaScript value that can be used as a {Map} key.
      * @param value Any arbitrary, cloneable JavaScript value that will be cloned and passed automatically to all new `Worker` instances. If `value` is passed as `undefined`, any previously set value
      * for the `key` will be deleted.
      */
-    function setEnvironmentData(key: Serializable, value: Serializable): void;
+    function setEnvironmentData(key: Serializable, value?: Serializable): void;
+    /**
+     * Sends a value to another worker, identified by its thread ID.
+     * @param threadId The target thread ID. If the thread ID is invalid, a `ERR_WORKER_MESSAGING_FAILED` error will be thrown.
+     * If the target thread ID is the current thread ID, a `ERR_WORKER_MESSAGING_SAME_THREAD` error will be thrown.
+     * @param value The value to send.
+     * @param transferList If one or more `MessagePort`-like objects are passed in value, a `transferList` is required for those items
+     * or `ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST` is thrown. See `port.postMessage()` for more information.
+     * @param timeout Time to wait for the message to be delivered in milliseconds. By default it's `undefined`, which means wait forever.
+     * If the operation times out, a `ERR_WORKER_MESSAGING_TIMEOUT` error is thrown.
+     * @since v22.5.0
+     */
+    function postMessageToThread(threadId: number, value: any, timeout?: number): Promise<void>;
+    function postMessageToThread(
+        threadId: number,
+        value: any,
+        transferList: readonly Transferable[],
+        timeout?: number,
+    ): Promise<void>;
 
     import {
         BroadcastChannel as _BroadcastChannel,
@@ -654,8 +853,12 @@ declare module "worker_threads" {
         MessagePort as _MessagePort,
     } from "worker_threads";
     global {
+        function structuredClone<T>(
+            value: T,
+            options?: { transfer?: Transferable[] },
+        ): T;
         /**
-         * `BroadcastChannel` class is a global reference for `require('worker_threads').BroadcastChannel`
+         * `BroadcastChannel` class is a global reference for `import { BroadcastChannel } from 'worker_threads'`
          * https://nodejs.org/api/globals.html#broadcastchannel
          * @since v18.0.0
          */
@@ -665,7 +868,7 @@ declare module "worker_threads" {
         } ? T
             : typeof _BroadcastChannel;
         /**
-         * `MessageChannel` class is a global reference for `require('worker_threads').MessageChannel`
+         * `MessageChannel` class is a global reference for `import { MessageChannel } from 'worker_threads'`
          * https://nodejs.org/api/globals.html#messagechannel
          * @since v15.0.0
          */
@@ -675,7 +878,7 @@ declare module "worker_threads" {
         } ? T
             : typeof _MessageChannel;
         /**
-         * `MessagePort` class is a global reference for `require('worker_threads').MessagePort`
+         * `MessagePort` class is a global reference for `import { MessagePort } from 'worker_threads'`
          * https://nodejs.org/api/globals.html#messageport
          * @since v15.0.0
          */