@types/node 15.9.0 → 15.12.3

node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Node.js (http://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Wed, 02 Jun 2021 22:31:36 GMT
+ * Last updated: Fri, 18 Jun 2021 09:31:14 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `Buffer`, `__dirname`, `__filename`, `clearImmediate`, `clearInterval`, `clearTimeout`, `console`, `exports`, `global`, `module`, `process`, `queueMicrotask`, `require`, `setImmediate`, `setInterval`, `setTimeout`
 

node/child_process.d.ts

@@ -4,7 +4,7 @@ declare module 'child_process' {
     import * as net from 'net';
     import { Writable, Readable, Stream, Pipe } from 'stream';
 
-    type Serializable = string | object | number | boolean;
+    type Serializable = string | object | number | boolean | bigint;
     type SendHandle = net.Socket | net.Server;
 
     interface ChildProcess extends EventEmitter {
@@ -20,7 +20,7 @@ declare module 'child_process' {
             Readable | Writable | null | undefined // extra
         ];
         readonly killed: boolean;
-        readonly pid: number;
+        readonly pid?: number;
         readonly connected: boolean;
         readonly exitCode: number | null;
         readonly signalCode: NodeJS.Signals | null;
@@ -135,12 +135,18 @@ declare module 'child_process' {
 
     type SerializationType = 'json' | 'advanced';
 
-    interface MessagingOptions {
+    interface MessagingOptions extends Abortable {
         /**
          * Specify the kind of serialization used for sending messages between processes.
          * @default 'json'
          */
         serialization?: SerializationType;
+
+        /**
+         * The signal value to be used when the spawned process will be killed by the abort signal.
+         * @default 'SIGTERM'
+         */
+        killSignal?: NodeJS.Signals | number;
     }
 
     interface ProcessEnvOptions {
@@ -451,7 +457,6 @@ declare module 'child_process' {
 
     interface SpawnSyncOptions extends CommonSpawnOptions {
         input?: string | NodeJS.ArrayBufferView;
-        killSignal?: NodeJS.Signals | number;
         maxBuffer?: number;
         encoding?: BufferEncoding | 'buffer' | null;
     }

node/console.d.ts

@@ -25,16 +25,16 @@ declare module 'console' {
              */
             countReset(label?: string): void;
             /**
-             * The `console.debug()` function is an alias for {@link console.log()}.
+             * The `console.debug()` function is an alias for {@link console.log}.
              */
             debug(message?: any, ...optionalParams: any[]): void;
             /**
-             * Uses {@link util.inspect()} on `obj` and prints the resulting string to `stdout`.
+             * Uses {@link util.inspect} on `obj` and prints the resulting string to `stdout`.
              * This function bypasses any custom `inspect()` function defined on `obj`.
              */
             dir(obj: any, options?: InspectOptions): void;
             /**
-             * This method calls {@link console.log()} passing it the arguments received. Please note that this method does not produce any XML formatting
+             * This method calls {@link console.log} passing it the arguments received. Please note that this method does not produce any XML formatting
              */
             dirxml(...data: any[]): void;
             /**
@@ -47,7 +47,7 @@ declare module 'console' {
              */
             group(...label: any[]): void;
             /**
-             * The `console.groupCollapsed()` function is an alias for {@link console.group()}.
+             * The `console.groupCollapsed()` function is an alias for {@link console.group}.
              */
             groupCollapsed(...label: any[]): void;
             /**
@@ -55,7 +55,7 @@ declare module 'console' {
              */
             groupEnd(): void;
             /**
-             * The {@link console.info()} function is an alias for {@link console.log()}.
+             * The {@link console.info} function is an alias for {@link console.log}.
              */
             info(message?: any, ...optionalParams: any[]): void;
             /**
@@ -72,19 +72,19 @@ declare module 'console' {
              */
             time(label?: string): void;
             /**
-             * Stops a timer that was previously started by calling {@link console.time()} and prints the result to `stdout`.
+             * Stops a timer that was previously started by calling {@link console.time} and prints the result to `stdout`.
              */
             timeEnd(label?: string): void;
             /**
-             * For a timer that was previously started by calling {@link console.time()}, prints the elapsed time and other `data` arguments to `stdout`.
+             * For a timer that was previously started by calling {@link console.time}, prints the elapsed time and other `data` arguments to `stdout`.
              */
             timeLog(label?: string, ...data: any[]): void;
             /**
-             * Prints to `stderr` the string 'Trace :', followed by the {@link util.format()} formatted message and stack trace to the current position in the code.
+             * Prints to `stderr` the string 'Trace :', followed by the {@link util.format} formatted message and stack trace to the current position in the code.
              */
             trace(message?: any, ...optionalParams: any[]): void;
             /**
-             * The {@link console.warn()} function is an alias for {@link console.error()}.
+             * The {@link console.warn} function is an alias for {@link console.error}.
              */
             warn(message?: any, ...optionalParams: any[]): void;
 

node/crypto.d.ts

@@ -197,6 +197,45 @@ declare module 'crypto' {
         passphrase?: string | Buffer;
     }
 
+    interface JwkKeyExportOptions {
+        format: 'jwk';
+    }
+
+    interface JsonWebKey {
+        crv?: string;
+        d?: string;
+        dp?: string;
+        dq?: string;
+        e?: string;
+        k?: string;
+        kty?: string;
+        n?: string;
+        p?: string;
+        q?: string;
+        qi?: string;
+        x?: string;
+        y?: string;
+    }
+
+    interface AsymmetricKeyDetails {
+        /**
+         * Key size in bits (RSA, DSA).
+         */
+        modulusLength?: number;
+        /**
+         * Public exponent (RSA).
+         */
+        publicExponent?: bigint;
+        /**
+         * Size of q in bits (DSA).
+         */
+        divisorLength?: number;
+        /**
+         * Name of the curve (EC).
+         */
+        namedCurve?: string;
+    }
+
     class KeyObject {
         private constructor();
         asymmetricKeyType?: KeyType;
@@ -205,6 +244,13 @@ declare module 'crypto' {
          * bytes. This property is `undefined` for symmetric keys.
          */
         asymmetricKeySize?: number;
+        /**
+         * This property exists only on asymmetric keys. Depending on the type of the key,
+         * this object contains information about the key. None of the information obtained
+         * through this property can be used to uniquely identify a key or to compromise the
+         * security of the key.
+         */
+        asymmetricKeyDetails?: AsymmetricKeyDetails;
         export(options: KeyExportOptions<'pem'>): string | Buffer;
         export(options?: KeyExportOptions<'der'>): Buffer;
         symmetricKeySize?: number;
@@ -330,6 +376,8 @@ declare module 'crypto' {
         type?: 'pkcs1' | 'spki';
     }
 
+    function generateKey(type: 'hmac' | 'aes', options: {length: number}, callback: (err: Error | null, key: KeyObject) => void): KeyObject;
+
     function createPrivateKey(key: PrivateKeyInput | string | Buffer): KeyObject;
     function createPublicKey(key: PublicKeyInput | string | Buffer | KeyObject): KeyObject;
     function createSecretKey(key: NodeJS.ArrayBufferView): KeyObject;
@@ -1171,6 +1219,12 @@ declare module 'crypto' {
         data: NodeJS.ArrayBufferView,
         key: KeyLike | SignKeyObjectInput | SignPrivateKeyInput,
     ): Buffer;
+    function sign(
+        algorithm: string | null | undefined,
+        data: NodeJS.ArrayBufferView,
+        key: KeyLike | SignKeyObjectInput | SignPrivateKeyInput,
+        callback: (error: Error | null, data: Buffer) => void
+    ): void;
 
     /**
      * Calculates and returns the signature for `data` using the given private key and
@@ -1186,6 +1240,13 @@ declare module 'crypto' {
         key: KeyLike | VerifyKeyObjectInput | VerifyPublicKeyInput,
         signature: NodeJS.ArrayBufferView,
     ): boolean;
+    function verify(
+        algorithm: string | null | undefined,
+        data: NodeJS.ArrayBufferView,
+        key: KeyLike | VerifyKeyObjectInput | VerifyPublicKeyInput,
+        signature: NodeJS.ArrayBufferView,
+        callback: (error: Error | null, result: boolean) => void
+    ): void;
 
     /**
      * Computes the Diffie-Hellman secret based on a privateKey and a publicKey.

node/globals.d.ts

@@ -37,9 +37,9 @@ interface ImportMeta {
  ------------------------------------------------*/
 
 // For backwards compability
-interface NodeRequire extends NodeJS.Require {}
-interface RequireResolve extends NodeJS.RequireResolve {}
-interface NodeModule extends NodeJS.Module {}
+interface NodeRequire extends NodeJS.Require { }
+interface RequireResolve extends NodeJS.RequireResolve { }
+interface NodeModule extends NodeJS.Module { }
 
 declare var process: NodeJS.Process;
 declare var console: Console;
@@ -318,6 +318,7 @@ 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.
@@ -341,6 +342,7 @@ declare var AbortController: {
 declare var AbortSignal: {
     prototype: AbortSignal;
     new(): AbortSignal;
+    // TODO: Add abort() static
 };
 //#endregion borrowed
 

node/http2.d.ts

@@ -438,6 +438,13 @@ declare module 'http2' {
         paddingStrategy?: number;
         peerMaxConcurrentStreams?: number;
         settings?: Settings;
+        /**
+         * Specifies a timeout in milliseconds that
+         * a server should wait when an [`'unknownProtocol'`][] is emitted. If the
+         * socket has not been destroyed by that time the server will destroy it.
+         * @default 100000
+         */
+        unknownProtocolTimeout?: number;
 
         selectPadding?(frameLen: number, maxFrameLen: number): number;
         createConnection?(authority: url.URL, option: SessionOptions): stream.Duplex;

node/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for non-npm package Node.js 15.9
+// Type definitions for non-npm package Node.js 15.12
 // Project: http://nodejs.org/
 // Definitions by: Microsoft TypeScript <https://github.com/Microsoft>
 //                 DefinitelyTyped <https://github.com/DefinitelyTyped>
@@ -50,9 +50,9 @@
 
 // NOTE: TypeScript version-specific augmentations can be found in the following paths:
 //          - ~/base.d.ts         - Shared definitions common to all TypeScript versions
-//          - ~/index.d.ts        - Definitions specific to TypeScript 2.8
-//          - ~/ts3.5/index.d.ts  - Definitions specific to TypeScript 3.5
+//          - ~/index.d.ts        - Definitions specific to TypeScript 3.7
+//          - ~/ts3.6/index.d.ts  - Definitions specific to TypeScript 3.6
 
-// NOTE: Augmentations for TypeScript 3.5 and later should use individual files for overrides
-//       within the respective ~/ts3.5 (or later) folder. However, this is disallowed for versions
-//       prior to TypeScript 3.5, so the older definitions will be found here.
+// NOTE: Augmentations for TypeScript 3.6 and later should use individual files for overrides
+//       within the respective ~/ts3.6 (or later) folder. However, this is disallowed for versions
+//       prior to TypeScript 3.6, so the older definitions will be found here.

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "15.9.0",
+    "version": "15.12.3",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -227,6 +227,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "cb014fbf92870923982004e4fca76f59150c147625c5fc51365d369f858eb620",
+    "typesPublisherContentHash": "7d407772fe9c0edcbff7320cf0827e14396d3a734e2205f9ee6b37dc8ff8a33f",
     "typeScriptVersion": "3.6"
 }

node/stream.d.ts

@@ -301,7 +301,7 @@ declare module 'stream' {
          */
         function addAbortSignal<T extends Stream>(signal: AbortSignal, stream: T): T;
 
-        interface FinishedOptions {
+        interface FinishedOptions extends Abortable {
             error?: boolean;
             readable?: boolean;
             writable?: boolean;

node/ts3.6/base.d.ts

@@ -3,8 +3,8 @@
 // NOTE: TypeScript version-specific augmentations can be found in the following paths:
 //          - ~/base.d.ts         - Shared definitions common to all TypeScript versions
 //          - ~/index.d.ts        - Definitions specific to TypeScript 3.7 and above
-//          - ~/ts3.5/base.d.ts   - Definitions specific to TypeScript 3.6 and earlier
-//          - ~/ts3.5/index.d.ts  - Definitions specific to TypeScript 3.6 and earlier with assert pulled in
+//          - ~/ts3.6/base.d.ts   - Definitions specific to TypeScript 3.6 and earlier
+//          - ~/ts3.6/index.d.ts  - Definitions specific to TypeScript 3.6 and earlier with assert pulled in
 
 // Reference required types from the default lib:
 /// <reference lib="es2018" />
@@ -61,8 +61,8 @@
 /// <reference path="../worker_threads.d.ts" />
 /// <reference path="../zlib.d.ts" />
 
-// TypeScript 3.5-specific augmentations:
+// TypeScript 3.6-specific augmentations:
 /// <reference path="../globals.global.d.ts" />
 
-// TypeScript 3.5-specific augmentations:
+// TypeScript 3.6-specific augmentations:
 /// <reference path="../wasi.d.ts" />

node/ts3.6/index.d.ts

@@ -1,4 +1,4 @@
-// NOTE: These definitions support NodeJS and TypeScript 3.5 - 3.6.
+// NOTE: These definitions support NodeJS and TypeScript 3.6.
 // This is required to enable typing assert in ts3.7 without causing errors
 // Typically type modifications should be made in base.d.ts instead of here
 

node/worker_threads.d.ts

@@ -262,4 +262,21 @@ declare module 'worker_threads' {
      * `MessagePort`’s queue.
      */
     function receiveMessageOnPort(port: MessagePort): { message: any } | undefined;
+
+    type Serializable = string | object | number | boolean | bigint;
+
+    /**
+     * @param key Any arbitrary, cloneable JavaScript value that can be used as a {Map} key.
+     * @experimental
+     */
+    function getEnvironmentData(key: Serializable): Serializable;
+
+    /**
+     * @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.
+     * @experimental
+     */
+    function setEnvironmentData(key: Serializable, value: Serializable): void;
 }