@types/node 17.0.37 → 17.0.40

node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Node.js (https://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Tue, 31 May 2022 18:31:34 GMT
+ * Last updated: Sun, 05 Jun 2022 08:01:31 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`, `structuredClone`
 

node/fs/promises.d.ts

@@ -11,6 +11,7 @@
 declare module 'fs/promises' {
     import { Abortable } from 'node:events';
     import { Stream } from 'node:stream';
+    import { ReadableStream } from 'node:stream/web';
     import {
         Stats,
         BigIntStats,
@@ -209,6 +210,29 @@ declare module 'fs/promises' {
          */
         read<T extends NodeJS.ArrayBufferView>(buffer: T, offset?: number | null, length?: number | null, position?: number | null): Promise<FileReadResult<T>>;
         read<T extends NodeJS.ArrayBufferView = Buffer>(options?: FileReadOptions<T>): Promise<FileReadResult<T>>;
+        /**
+         * Returns a `ReadableStream` that may be used to read the files data.
+         *
+         * An error will be thrown if this method is called more than once or is called after the `FileHandle` is closed
+         * or closing.
+         *
+         * ```js
+         * import { open } from 'node:fs/promises';
+         *
+         * const file = await open('./some/file/to/read');
+         *
+         * for await (const chunk of file.readableWebStream())
+         *   console.log(chunk);
+         *
+         * await file.close();
+         * ```
+         *
+         * While the `ReadableStream` will read the file to completion, it will not close the `FileHandle` automatically. User code must still call the `fileHandle.close()` method.
+         *
+         * @since v17.0.0
+         * @experimental
+         */
+        readableWebStream(): ReadableStream;
         /**
          * Asynchronously reads the entire contents of a file.
          *
@@ -487,7 +511,7 @@ declare module 'fs/promises' {
      * @param [mode=0o666] Sets the file mode (permission and sticky bits) if the file is created.
      * @return Fulfills with a {FileHandle} object.
      */
-    function open(path: PathLike, flags: string | number, mode?: Mode): Promise<FileHandle>;
+    function open(path: PathLike, flags?: string | number, mode?: Mode): Promise<FileHandle>;
     /**
      * Renames `oldPath` to `newPath`.
      * @since v10.0.0

node/fs.d.ts

@@ -1998,12 +1998,19 @@ declare module 'fs' {
      * @param [flags='r'] See `support of file system `flags``.
      * @param [mode=0o666]
      */
-    export function open(path: PathLike, flags: OpenMode, mode: Mode | undefined | null, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
+    export function open(path: PathLike, flags: OpenMode | undefined, mode: Mode | undefined | null, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
+    /**
+     * Asynchronous open(2) - open and possibly create a file. If the file is created, its mode will be `0o666`.
+     * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
+     * @param [flags='r'] See `support of file system `flags``.
+     */
+    export function open(path: PathLike, flags: OpenMode | undefined, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
     /**
      * Asynchronous open(2) - open and possibly create a file. If the file is created, its mode will be `0o666`.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      */
-    export function open(path: PathLike, flags: OpenMode, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
+    export function open(path: PathLike, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
+
     export namespace open {
         /**
          * Asynchronous open(2) - open and possibly create a file.

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "17.0.37",
+    "version": "17.0.40",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -220,6 +220,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "c6cc31e823440776df1d472e27a96eaeea82324ff3d04349017436ad1e821340",
+    "typesPublisherContentHash": "8924a04e799179c8e10493629b0bdf0c5388080a62ec2e413b2137b01ecc29c7",
     "typeScriptVersion": "3.9"
 }

node/process.d.ts

@@ -642,7 +642,7 @@ declare module 'process' {
                  * Android).
                  * @since v0.1.31
                  */
-                getgid(): number;
+                getgid?: () => number;
                 /**
                  * The `process.setgid()` method sets the group identity of the process. (See [`setgid(2)`](http://man7.org/linux/man-pages/man2/setgid.2.html).) The `id` can be passed as either a
                  * numeric ID or a group name
@@ -669,7 +669,7 @@ declare module 'process' {
                  * @since v0.1.31
                  * @param id The group name or ID
                  */
-                setgid(id: number | string): void;
+                setgid?: (id: number | string) => void;
                 /**
                  * The `process.getuid()` method returns the numeric user identity of the process.
                  * (See [`getuid(2)`](http://man7.org/linux/man-pages/man2/getuid.2.html).)
@@ -686,7 +686,7 @@ declare module 'process' {
                  * Android).
                  * @since v0.1.28
                  */
-                getuid(): number;
+                getuid?: () => number;
                 /**
                  * The `process.setuid(id)` method sets the user identity of the process. (See [`setuid(2)`](http://man7.org/linux/man-pages/man2/setuid.2.html).) The `id` can be passed as either a
                  * numeric ID or a username string.
@@ -712,7 +712,7 @@ declare module 'process' {
                  * This feature is not available in `Worker` threads.
                  * @since v0.1.28
                  */
-                setuid(id: number | string): void;
+                setuid?: (id: number | string) => void;
                 /**
                  * The `process.geteuid()` method returns the numerical effective user identity of
                  * the process. (See [`geteuid(2)`](http://man7.org/linux/man-pages/man2/geteuid.2.html).)
@@ -729,7 +729,7 @@ declare module 'process' {
                  * Android).
                  * @since v2.0.0
                  */
-                geteuid(): number;
+                geteuid?: () => number;
                 /**
                  * The `process.seteuid()` method sets the effective user identity of the process.
                  * (See [`seteuid(2)`](http://man7.org/linux/man-pages/man2/seteuid.2.html).) The `id` can be passed as either a numeric ID or a username
@@ -756,7 +756,7 @@ declare module 'process' {
                  * @since v2.0.0
                  * @param id A user name or ID
                  */
-                seteuid(id: number | string): void;
+                seteuid?: (id: number | string) => void;
                 /**
                  * The `process.getegid()` method returns the numerical effective group identity
                  * of the Node.js process. (See [`getegid(2)`](http://man7.org/linux/man-pages/man2/getegid.2.html).)
@@ -773,7 +773,7 @@ declare module 'process' {
                  * Android).
                  * @since v2.0.0
                  */
-                getegid(): number;
+                getegid?: () => number;
                 /**
                  * The `process.setegid()` method sets the effective group identity of the process.
                  * (See [`setegid(2)`](http://man7.org/linux/man-pages/man2/setegid.2.html).) The `id` can be passed as either a numeric ID or a group
@@ -800,7 +800,7 @@ declare module 'process' {
                  * @since v2.0.0
                  * @param id A group name or ID
                  */
-                setegid(id: number | string): void;
+                setegid?: (id: number | string) => void;
                 /**
                  * The `process.getgroups()` method returns an array with the supplementary group
                  * IDs. POSIX leaves it unspecified if the effective group ID is included but
@@ -818,7 +818,7 @@ declare module 'process' {
                  * Android).
                  * @since v0.9.4
                  */
-                getgroups(): number[];
+                getgroups?: () => number[];
                 /**
                  * The `process.setgroups()` method sets the supplementary group IDs for the
                  * Node.js process. This is a privileged operation that requires the Node.js
@@ -844,7 +844,7 @@ declare module 'process' {
                  * This feature is not available in `Worker` threads.
                  * @since v0.9.4
                  */
-                setgroups(groups: ReadonlyArray<string | number>): void;
+                setgroups?: (groups: ReadonlyArray<string | number>) => void;
                 /**
                  * The `process.setUncaughtExceptionCaptureCallback()` function sets a function
                  * that will be invoked when an uncaught exception occurs, which will receive the