@types/node 18.18.14 → 18.19.1

{node v18.18 → node v18.19}/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/v18.
 
 ### Additional Details
- * Last updated: Wed, 29 Nov 2023 19:35:57 GMT
+ * Last updated: Fri, 01 Dec 2023 20:07:24 GMT
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
 
 # Credits

node v18.19/globals.d.ts

@@ -0,0 +1,377 @@
+export {}; // Make this a module
+
+// #region Fetch and friends
+// Conditional type aliases, used at the end of this file.
+// Will either be empty if lib-dom is included, or the undici version otherwise.
+type _Request = typeof globalThis extends { onmessage: any } ? {} : import("undici-types").Request;
+type _Response = typeof globalThis extends { onmessage: any } ? {} : import("undici-types").Response;
+type _FormData = typeof globalThis extends { onmessage: any } ? {} : import("undici-types").FormData;
+type _Headers = typeof globalThis extends { onmessage: any } ? {} : import("undici-types").Headers;
+type _RequestInit = typeof globalThis extends { onmessage: any } ? {}
+    : import("undici-types").RequestInit;
+type _ResponseInit = typeof globalThis extends { onmessage: any } ? {}
+    : import("undici-types").ResponseInit;
+// #endregion Fetch and friends
+
+declare global {
+    // Declare "static" methods in Error
+    interface ErrorConstructor {
+        /** Create .stack property on a target object */
+        captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+
+        /**
+         * Optional override for formatting stack traces
+         *
+         * @see https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+         */
+        prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+
+        stackTraceLimit: number;
+    }
+
+    /*-----------------------------------------------*
+    *                                               *
+    *                   GLOBAL                      *
+    *                                               *
+    ------------------------------------------------*/
+
+    // For backwards compability
+    interface NodeRequire extends NodeJS.Require {}
+    interface RequireResolve extends NodeJS.RequireResolve {}
+    interface NodeModule extends NodeJS.Module {}
+
+    var process: NodeJS.Process;
+    var console: Console;
+
+    var __filename: string;
+    var __dirname: string;
+
+    var require: NodeRequire;
+    var module: NodeModule;
+
+    // Same as module.exports
+    var exports: any;
+
+    /**
+     * Only available if `--expose-gc` is passed to the process.
+     */
+    var gc: undefined | (() => void);
+
+    // #region borrowed
+    // from https://github.com/microsoft/TypeScript/blob/38da7c600c83e7b31193a62495239a0fe478cb67/lib/lib.webworker.d.ts#L633 until moved to separate lib
+    /** A controller object that allows you to abort one or more DOM requests as and when desired. */
+    interface AbortController {
+        /**
+         * Returns the AbortSignal object associated with this object.
+         */
+
+        readonly signal: AbortSignal;
+        /**
+         * Invoking this method will set this object's AbortSignal's aborted flag and signal to any observers that the associated activity is to be aborted.
+         */
+        abort(reason?: any): void;
+    }
+
+    /** A signal object that allows you to communicate with a DOM request (such as a Fetch) and abort it if required via an AbortController object. */
+    interface AbortSignal extends EventTarget {
+        /**
+         * Returns true if this AbortSignal's AbortController has signaled to abort, and false otherwise.
+         */
+        readonly aborted: boolean;
+        readonly reason: any;
+        onabort: null | ((this: AbortSignal, event: Event) => any);
+        throwIfAborted(): void;
+    }
+
+    var AbortController: typeof globalThis extends { onmessage: any; AbortController: infer T } ? T
+        : {
+            prototype: AbortController;
+            new(): AbortController;
+        };
+
+    var AbortSignal: typeof globalThis extends { onmessage: any; AbortSignal: infer T } ? T
+        : {
+            prototype: AbortSignal;
+            new(): AbortSignal;
+            abort(reason?: any): AbortSignal;
+            timeout(milliseconds: number): AbortSignal;
+        };
+    // #endregion borrowed
+
+    // #region Disposable
+    interface SymbolConstructor {
+        /**
+         * A method that is used to release resources held by an object. Called by the semantics of the `using` statement.
+         */
+        readonly dispose: unique symbol;
+
+        /**
+         * A method that is used to asynchronously release resources held by an object. Called by the semantics of the `await using` statement.
+         */
+        readonly asyncDispose: unique symbol;
+    }
+
+    interface Disposable {
+        [Symbol.dispose](): void;
+    }
+
+    interface AsyncDisposable {
+        [Symbol.asyncDispose](): PromiseLike<void>;
+    }
+    // #endregion Disposable
+
+    // #region ArrayLike.at()
+    interface RelativeIndexable<T> {
+        /**
+         * Takes an integer value and returns the item at that index,
+         * allowing for positive and negative integers.
+         * Negative integers count back from the last item in the array.
+         */
+        at(index: number): T | undefined;
+    }
+    interface String extends RelativeIndexable<string> {}
+    interface Array<T> extends RelativeIndexable<T> {}
+    interface ReadonlyArray<T> extends RelativeIndexable<T> {}
+    interface Int8Array extends RelativeIndexable<number> {}
+    interface Uint8Array extends RelativeIndexable<number> {}
+    interface Uint8ClampedArray extends RelativeIndexable<number> {}
+    interface Int16Array extends RelativeIndexable<number> {}
+    interface Uint16Array extends RelativeIndexable<number> {}
+    interface Int32Array extends RelativeIndexable<number> {}
+    interface Uint32Array extends RelativeIndexable<number> {}
+    interface Float32Array extends RelativeIndexable<number> {}
+    interface Float64Array extends RelativeIndexable<number> {}
+    interface BigInt64Array extends RelativeIndexable<bigint> {}
+    interface BigUint64Array extends RelativeIndexable<bigint> {}
+    // #endregion ArrayLike.at() end
+
+    /**
+     * @since v17.0.0
+     *
+     * Creates a deep clone of an object.
+     */
+    function structuredClone<T>(
+        value: T,
+        transfer?: { transfer: ReadonlyArray<import("worker_threads").TransferListItem> },
+    ): T;
+
+    /*----------------------------------------------*
+    *                                               *
+    *               GLOBAL INTERFACES               *
+    *                                               *
+    *-----------------------------------------------*/
+    namespace NodeJS {
+        interface CallSite {
+            /**
+             * Value of "this"
+             */
+            getThis(): unknown;
+
+            /**
+             * Type of "this" as a string.
+             * This is the name of the function stored in the constructor field of
+             * "this", if available.  Otherwise the object's [[Class]] internal
+             * property.
+             */
+            getTypeName(): string | null;
+
+            /**
+             * Current function
+             */
+            getFunction(): Function | undefined;
+
+            /**
+             * Name of the current function, typically its name property.
+             * If a name property is not available an attempt will be made to try
+             * to infer a name from the function's context.
+             */
+            getFunctionName(): string | null;
+
+            /**
+             * Name of the property [of "this" or one of its prototypes] that holds
+             * the current function
+             */
+            getMethodName(): string | null;
+
+            /**
+             * Name of the script [if this function was defined in a script]
+             */
+            getFileName(): string | undefined;
+
+            /**
+             * Current line number [if this function was defined in a script]
+             */
+            getLineNumber(): number | null;
+
+            /**
+             * Current column number [if this function was defined in a script]
+             */
+            getColumnNumber(): number | null;
+
+            /**
+             * A call site object representing the location where eval was called
+             * [if this function was created using a call to eval]
+             */
+            getEvalOrigin(): string | undefined;
+
+            /**
+             * Is this a toplevel invocation, that is, is "this" the global object?
+             */
+            isToplevel(): boolean;
+
+            /**
+             * Does this call take place in code defined by a call to eval?
+             */
+            isEval(): boolean;
+
+            /**
+             * Is this call in native V8 code?
+             */
+            isNative(): boolean;
+
+            /**
+             * Is this a constructor call?
+             */
+            isConstructor(): boolean;
+        }
+
+        interface ErrnoException extends Error {
+            errno?: number | undefined;
+            code?: string | undefined;
+            path?: string | undefined;
+            syscall?: string | undefined;
+        }
+
+        interface ReadableStream extends EventEmitter {
+            readable: boolean;
+            read(size?: number): string | Buffer;
+            setEncoding(encoding: BufferEncoding): this;
+            pause(): this;
+            resume(): this;
+            isPaused(): boolean;
+            pipe<T extends WritableStream>(destination: T, options?: { end?: boolean | undefined }): T;
+            unpipe(destination?: WritableStream): this;
+            unshift(chunk: string | Uint8Array, encoding?: BufferEncoding): void;
+            wrap(oldStream: ReadableStream): this;
+            [Symbol.asyncIterator](): AsyncIterableIterator<string | Buffer>;
+        }
+
+        interface WritableStream extends EventEmitter {
+            writable: boolean;
+            write(buffer: Uint8Array | string, cb?: (err?: Error | null) => void): boolean;
+            write(str: string, encoding?: BufferEncoding, cb?: (err?: Error | null) => void): boolean;
+            end(cb?: () => void): this;
+            end(data: string | Uint8Array, cb?: () => void): this;
+            end(str: string, encoding?: BufferEncoding, cb?: () => void): this;
+        }
+
+        interface ReadWriteStream extends ReadableStream, WritableStream {}
+
+        interface RefCounted {
+            ref(): this;
+            unref(): this;
+        }
+
+        type TypedArray =
+            | Uint8Array
+            | Uint8ClampedArray
+            | Uint16Array
+            | Uint32Array
+            | Int8Array
+            | Int16Array
+            | Int32Array
+            | BigUint64Array
+            | BigInt64Array
+            | Float32Array
+            | Float64Array;
+        type ArrayBufferView = TypedArray | DataView;
+
+        interface Require {
+            (id: string): any;
+            resolve: RequireResolve;
+            cache: Dict<NodeModule>;
+            /**
+             * @deprecated
+             */
+            extensions: RequireExtensions;
+            main: Module | undefined;
+        }
+
+        interface RequireResolve {
+            (id: string, options?: { paths?: string[] | undefined }): string;
+            paths(request: string): string[] | null;
+        }
+
+        interface RequireExtensions extends Dict<(m: Module, filename: string) => any> {
+            ".js": (m: Module, filename: string) => any;
+            ".json": (m: Module, filename: string) => any;
+            ".node": (m: Module, filename: string) => any;
+        }
+        interface Module {
+            /**
+             * `true` if the module is running during the Node.js preload
+             */
+            isPreloading: boolean;
+            exports: any;
+            require: Require;
+            id: string;
+            filename: string;
+            loaded: boolean;
+            /** @deprecated since v14.6.0 Please use `require.main` and `module.children` instead. */
+            parent: Module | null | undefined;
+            children: Module[];
+            /**
+             * @since v11.14.0
+             *
+             * The directory name of the module. This is usually the same as the path.dirname() of the module.id.
+             */
+            path: string;
+            paths: string[];
+        }
+
+        interface Dict<T> {
+            [key: string]: T | undefined;
+        }
+
+        interface ReadOnlyDict<T> {
+            readonly [key: string]: T | undefined;
+        }
+    }
+
+    interface RequestInit extends _RequestInit {}
+
+    function fetch(
+        input: string | URL | Request,
+        init?: RequestInit,
+    ): Promise<Response>;
+
+    interface Request extends _Request {}
+    var Request: typeof globalThis extends {
+        onmessage: any;
+        Request: infer T;
+    } ? T
+        : typeof import("undici-types").Request;
+
+    interface ResponseInit extends _ResponseInit {}
+
+    interface Response extends _Response {}
+    var Response: typeof globalThis extends {
+        onmessage: any;
+        Response: infer T;
+    } ? T
+        : typeof import("undici-types").Response;
+
+    interface FormData extends _FormData {}
+    var FormData: typeof globalThis extends {
+        onmessage: any;
+        FormData: infer T;
+    } ? T
+        : typeof import("undici-types").FormData;
+
+    interface Headers extends _Headers {}
+    var Headers: typeof globalThis extends {
+        onmessage: any;
+        Headers: infer T;
+    } ? T
+        : typeof import("undici-types").Headers;
+}

{node v18.18/ts4.8 → node v18.19}/module.d.ts

@@ -120,7 +120,9 @@ declare module "module" {
              */
             findOrigin(lineNumber: number, columnNumber: number): SourceOrigin | {};
         }
-        interface ImportAssertions extends NodeJS.Dict<string> {
+        /** @deprecated Use `ImportAttributes` instead */
+        interface ImportAssertions extends ImportAttributes {}
+        interface ImportAttributes extends NodeJS.Dict<string> {
             type?: string | undefined;
         }
         type ModuleFormat = "builtin" | "commonjs" | "json" | "module" | "wasm";
@@ -129,6 +131,9 @@ declare module "module" {
             port: MessagePort;
         }
         /**
+         * @deprecated This hook will be removed in a future version.
+         * Use `initialize` instead. When a loader has an `initialize` export, `globalPreload` will be ignored.
+         *
          * Sometimes it might be necessary to run some code inside of the same global scope that the application runs in.
          * This hook allows the return of a string that is run as a sloppy-mode script on startup.
          *
@@ -136,15 +141,27 @@ declare module "module" {
          * @return Code to run before application startup
          */
         type GlobalPreloadHook = (context: GlobalPreloadContext) => string;
+        /**
+         * The `initialize` hook provides a way to define a custom function that runs in the hooks thread
+         * when the hooks module is initialized. Initialization happens when the hooks module is registered via `register`.
+         *
+         * This hook can receive data from a `register` invocation, including ports and other transferrable objects.
+         * The return value of `initialize` can be a `Promise`, in which case it will be awaited before the main application thread execution resumes.
+         */
+        type InitializeHook<Data = any> = (data: Data) => void | Promise<void>;
         interface ResolveHookContext {
             /**
              * Export conditions of the relevant `package.json`
              */
             conditions: string[];
+            /**
+             * @deprecated Use `importAttributes` instead
+             */
+            importAssertions: ImportAttributes;
             /**
              *  An object whose key-value pairs represent the assertions for the module to import
              */
-            importAssertions: ImportAssertions;
+            importAttributes: ImportAttributes;
             /**
              * The module importing this one, or undefined if this is the Node.js entry point
              */
@@ -156,9 +173,13 @@ declare module "module" {
              */
             format?: ModuleFormat | null | undefined;
             /**
-             * The import assertions to use when caching the module (optional; if excluded the input will be used)
+             * @deprecated Use `importAttributes` instead
              */
-            importAssertions?: ImportAssertions | undefined;
+            importAssertions?: ImportAttributes | undefined;
+            /**
+             * The import attributes to use when caching the module (optional; if excluded the input will be used)
+             */
+            importAttributes?: ImportAttributes | undefined;
             /**
              * A signal that this hook intends to terminate the chain of `resolve` hooks.
              * @default false
@@ -195,10 +216,14 @@ declare module "module" {
              * The format optionally supplied by the `resolve` hook chain
              */
             format: ModuleFormat;
+            /**
+             * @deprecated Use `importAttributes` instead
+             */
+            importAssertions: ImportAttributes;
             /**
              *  An object whose key-value pairs represent the assertions for the module to import
              */
-            importAssertions: ImportAssertions;
+            importAttributes: ImportAttributes;
         }
         interface LoadFnOutput {
             format: ModuleFormat;
@@ -226,6 +251,11 @@ declare module "module" {
             nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput | Promise<LoadFnOutput>,
         ) => LoadFnOutput | Promise<LoadFnOutput>;
     }
+    interface RegisterOptions<Data> {
+        parentURL: string | URL;
+        data?: Data | undefined;
+        transferList?: any[] | undefined;
+    }
     interface Module extends NodeModule {}
     class Module {
         static runMain(): void;
@@ -234,6 +264,12 @@ declare module "module" {
         static builtinModules: string[];
         static isBuiltin(moduleName: string): boolean;
         static Module: typeof Module;
+        static register<Data = any>(
+            specifier: string | URL,
+            parentURL?: string | URL,
+            options?: RegisterOptions<Data>,
+        ): void;
+        static register<Data = any>(specifier: string | URL, options?: RegisterOptions<Data>): void;
         constructor(id: string, parent?: Module);
     }
     global {

{node v18.18 → node v18.19}/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "18.18.14",
+    "version": "18.19.1",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -229,7 +229,7 @@
     "dependencies": {
         "undici-types": "~5.26.4"
     },
-    "typesPublisherContentHash": "d5af3cf2d005a6d2962993f11359c75f5fd371f76d1dce518e1fba4d8ee748e6",
+    "typesPublisherContentHash": "ca1ef3ccaed3691d811d98fbc35858936bc0dc8734cc2a8b967e52b7fcbae4bc",
     "typeScriptVersion": "4.6",
     "nonNpm": true
 }

{node v18.18/ts4.8 → node v18.19}/process.d.ts

@@ -901,6 +901,12 @@ declare module "process" {
                  * @experimental
                  */
                 setSourceMapsEnabled(value: boolean): void;
+                /**
+                 * The `process.sourceMapsEnabled` property returns whether the [Source Map v3](https://sourcemaps.info/spec.html) support for stack traces is enabled.
+                 * @since v18.19.0
+                 * @experimental
+                 */
+                readonly sourceMapsEnabled: boolean;
                 /**
                  * The `process.version` property contains the Node.js version string.
                  *