cloudstructs 0.6.42 → 0.6.44

package/node_modules/@types/is-stream/node_modules/@types/node/child_process.d.ts

@@ -833,50 +833,50 @@ declare module "child_process" {
     // overloads of spawn with 'args'
     function spawn(
         command: string,
-        args?: ReadonlyArray<string>,
+        args?: readonly string[],
         options?: SpawnOptionsWithoutStdio,
     ): ChildProcessWithoutNullStreams;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioPipe>,
     ): ChildProcessByStdio<Writable, Readable, Readable>;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioNull>,
     ): ChildProcessByStdio<Writable, Readable, null>;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioPipe>,
     ): ChildProcessByStdio<Writable, null, Readable>;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>,
     ): ChildProcessByStdio<null, Readable, Readable>;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioNull>,
     ): ChildProcessByStdio<Writable, null, null>;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioNull>,
     ): ChildProcessByStdio<null, Readable, null>;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioPipe>,
     ): ChildProcessByStdio<null, null, Readable>;
     function spawn(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioNull>,
     ): ChildProcessByStdio<null, null, null>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptions): ChildProcess;
+    function spawn(command: string, args: readonly string[], options: SpawnOptions): ChildProcess;
     interface ExecOptions extends CommonOptions {
         shell?: string | undefined;
         signal?: AbortSignal | undefined;
@@ -1150,10 +1150,10 @@ declare module "child_process" {
         file: string,
         options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
     ): ChildProcess;
-    function execFile(file: string, args?: ReadonlyArray<string> | null): ChildProcess;
+    function execFile(file: string, args?: readonly string[] | null): ChildProcess;
     function execFile(
         file: string,
-        args: ReadonlyArray<string> | undefined | null,
+        args: readonly string[] | undefined | null,
         options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
     ): ChildProcess;
     // no `options` definitely means stdout/stderr are `string`.
@@ -1163,7 +1163,7 @@ declare module "child_process" {
     ): ChildProcess;
     function execFile(
         file: string,
-        args: ReadonlyArray<string> | undefined | null,
+        args: readonly string[] | undefined | null,
         callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
     ): ChildProcess;
     // `options` with `"buffer"` or `null` for `encoding` means stdout/stderr are definitely `Buffer`.
@@ -1174,7 +1174,7 @@ declare module "child_process" {
     ): ChildProcess;
     function execFile(
         file: string,
-        args: ReadonlyArray<string> | undefined | null,
+        args: readonly string[] | undefined | null,
         options: ExecFileOptionsWithBufferEncoding,
         callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
     ): ChildProcess;
@@ -1186,7 +1186,7 @@ declare module "child_process" {
     ): ChildProcess;
     function execFile(
         file: string,
-        args: ReadonlyArray<string> | undefined | null,
+        args: readonly string[] | undefined | null,
         options: ExecFileOptionsWithStringEncoding,
         callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
     ): ChildProcess;
@@ -1199,7 +1199,7 @@ declare module "child_process" {
     ): ChildProcess;
     function execFile(
         file: string,
-        args: ReadonlyArray<string> | undefined | null,
+        args: readonly string[] | undefined | null,
         options: ExecFileOptionsWithOtherEncoding,
         callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
     ): ChildProcess;
@@ -1211,7 +1211,7 @@ declare module "child_process" {
     ): ChildProcess;
     function execFile(
         file: string,
-        args: ReadonlyArray<string> | undefined | null,
+        args: readonly string[] | undefined | null,
         options: ExecFileOptions,
         callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
     ): ChildProcess;
@@ -1226,7 +1226,7 @@ declare module "child_process" {
     ): ChildProcess;
     function execFile(
         file: string,
-        args: ReadonlyArray<string> | undefined | null,
+        args: readonly string[] | undefined | null,
         options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
         callback:
             | ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void)
@@ -1240,7 +1240,7 @@ declare module "child_process" {
         }>;
         function __promisify__(
             file: string,
-            args: ReadonlyArray<string> | undefined | null,
+            args: readonly string[] | undefined | null,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
@@ -1254,7 +1254,7 @@ declare module "child_process" {
         }>;
         function __promisify__(
             file: string,
-            args: ReadonlyArray<string> | undefined | null,
+            args: readonly string[] | undefined | null,
             options: ExecFileOptionsWithBufferEncoding,
         ): PromiseWithChild<{
             stdout: Buffer;
@@ -1269,7 +1269,7 @@ declare module "child_process" {
         }>;
         function __promisify__(
             file: string,
-            args: ReadonlyArray<string> | undefined | null,
+            args: readonly string[] | undefined | null,
             options: ExecFileOptionsWithStringEncoding,
         ): PromiseWithChild<{
             stdout: string;
@@ -1284,7 +1284,7 @@ declare module "child_process" {
         }>;
         function __promisify__(
             file: string,
-            args: ReadonlyArray<string> | undefined | null,
+            args: readonly string[] | undefined | null,
             options: ExecFileOptionsWithOtherEncoding,
         ): PromiseWithChild<{
             stdout: string | Buffer;
@@ -1299,7 +1299,7 @@ declare module "child_process" {
         }>;
         function __promisify__(
             file: string,
-            args: ReadonlyArray<string> | undefined | null,
+            args: readonly string[] | undefined | null,
             options: ExecFileOptions,
         ): PromiseWithChild<{
             stdout: string;
@@ -1314,7 +1314,7 @@ declare module "child_process" {
         }>;
         function __promisify__(
             file: string,
-            args: ReadonlyArray<string> | undefined | null,
+            args: readonly string[] | undefined | null,
             options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
         ): PromiseWithChild<{
             stdout: string | Buffer;
@@ -1388,7 +1388,7 @@ declare module "child_process" {
      * @param args List of string arguments.
      */
     function fork(modulePath: string, options?: ForkOptions): ChildProcess;
-    function fork(modulePath: string, args?: ReadonlyArray<string>, options?: ForkOptions): ChildProcess;
+    function fork(modulePath: string, args?: readonly string[], options?: ForkOptions): ChildProcess;
     interface SpawnSyncOptions extends CommonSpawnOptions {
         input?: string | NodeJS.ArrayBufferView | undefined;
         maxBuffer?: number | undefined;
@@ -1428,20 +1428,20 @@ declare module "child_process" {
     function spawnSync(command: string, options: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns<string>;
     function spawnSync(command: string, options: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns<Buffer>;
     function spawnSync(command: string, options?: SpawnSyncOptions): SpawnSyncReturns<string | Buffer>;
-    function spawnSync(command: string, args: ReadonlyArray<string>): SpawnSyncReturns<Buffer>;
+    function spawnSync(command: string, args: readonly string[]): SpawnSyncReturns<Buffer>;
     function spawnSync(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnSyncOptionsWithStringEncoding,
     ): SpawnSyncReturns<string>;
     function spawnSync(
         command: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: SpawnSyncOptionsWithBufferEncoding,
     ): SpawnSyncReturns<Buffer>;
     function spawnSync(
         command: string,
-        args?: ReadonlyArray<string>,
+        args?: readonly string[],
         options?: SpawnSyncOptions,
     ): SpawnSyncReturns<string | Buffer>;
     interface CommonExecOptions extends CommonOptions {
@@ -1522,18 +1522,18 @@ declare module "child_process" {
     function execFileSync(file: string, options: ExecFileSyncOptionsWithStringEncoding): string;
     function execFileSync(file: string, options: ExecFileSyncOptionsWithBufferEncoding): Buffer;
     function execFileSync(file: string, options?: ExecFileSyncOptions): string | Buffer;
-    function execFileSync(file: string, args: ReadonlyArray<string>): Buffer;
+    function execFileSync(file: string, args: readonly string[]): Buffer;
     function execFileSync(
         file: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: ExecFileSyncOptionsWithStringEncoding,
     ): string;
     function execFileSync(
         file: string,
-        args: ReadonlyArray<string>,
+        args: readonly string[],
         options: ExecFileSyncOptionsWithBufferEncoding,
     ): Buffer;
-    function execFileSync(file: string, args?: ReadonlyArray<string>, options?: ExecFileSyncOptions): string | Buffer;
+    function execFileSync(file: string, args?: readonly string[], options?: ExecFileSyncOptions): string | Buffer;
 }
 declare module "node:child_process" {
     export * from "child_process";

package/node_modules/@types/is-stream/node_modules/@types/node/console.d.ts

@@ -250,7 +250,7 @@ declare module "node:console" {
              * @since v10.0.0
              * @param properties Alternate properties for constructing the table.
              */
-            table(tabularData: any, properties?: ReadonlyArray<string>): void;
+            table(tabularData: any, properties?: readonly string[]): void;
             /**
              * Starts a timer that can be used to compute the duration of an operation. Timers
              * are identified by a unique `label`. Use the same `label` when calling {@link timeEnd} to stop the timer and output the elapsed time in

package/node_modules/@types/is-stream/node_modules/@types/node/crypto.d.ts

@@ -4208,7 +4208,7 @@ declare module "crypto" {
                     | HkdfParams
                     | Pbkdf2Params,
                 extractable: boolean,
-                keyUsages: ReadonlyArray<KeyUsage>,
+                keyUsages: readonly KeyUsage[],
             ): Promise<CryptoKey>;
             /**
              * Using the method identified by `algorithm`, `subtle.digest()` attempts to generate a digest of `data`.
@@ -4288,12 +4288,12 @@ declare module "crypto" {
             generateKey(
                 algorithm: RsaHashedKeyGenParams | EcKeyGenParams,
                 extractable: boolean,
-                keyUsages: ReadonlyArray<KeyUsage>,
+                keyUsages: readonly KeyUsage[],
             ): Promise<CryptoKeyPair>;
             generateKey(
                 algorithm: AesKeyGenParams | HmacKeyGenParams | Pbkdf2Params,
                 extractable: boolean,
-                keyUsages: ReadonlyArray<KeyUsage>,
+                keyUsages: readonly KeyUsage[],
             ): Promise<CryptoKey>;
             generateKey(
                 algorithm: AlgorithmIdentifier,
@@ -4320,7 +4320,7 @@ declare module "crypto" {
                     | HmacImportParams
                     | AesKeyAlgorithm,
                 extractable: boolean,
-                keyUsages: ReadonlyArray<KeyUsage>,
+                keyUsages: readonly KeyUsage[],
             ): Promise<CryptoKey>;
             importKey(
                 format: Exclude<KeyFormat, "jwk">,

package/node_modules/@types/is-stream/node_modules/@types/node/dgram.d.ts

@@ -342,18 +342,18 @@ declare module "dgram" {
          * @param callback Called when the message has been sent.
          */
         send(
-            msg: string | Uint8Array | ReadonlyArray<any>,
+            msg: string | Uint8Array | readonly any[],
             port?: number,
             address?: string,
             callback?: (error: Error | null, bytes: number) => void,
         ): void;
         send(
-            msg: string | Uint8Array | ReadonlyArray<any>,
+            msg: string | Uint8Array | readonly any[],
             port?: number,
             callback?: (error: Error | null, bytes: number) => void,
         ): void;
         send(
-            msg: string | Uint8Array | ReadonlyArray<any>,
+            msg: string | Uint8Array | readonly any[],
             callback?: (error: Error | null, bytes: number) => void,
         ): void;
         send(
@@ -501,7 +501,7 @@ declare module "dgram" {
          * process active, allowing the process to exit even if the socket is still
          * listening.
          *
-         * Calling `socket.unref()` multiple times will have no addition effect.
+         * Calling `socket.unref()` multiple times will have no additional effect.
          *
          * The `socket.unref()` method returns a reference to the socket so calls can be
          * chained.

package/node_modules/@types/is-stream/node_modules/@types/node/dns/promises.d.ts

@@ -307,6 +307,14 @@ declare module "dns/promises" {
      * @since v10.6.0
      */
     function reverse(ip: string): Promise<string[]>;
+    /**
+     * Get the default value for `verbatim` in {@link lookup} and `dnsPromises.lookup()`. The value could be:
+     *
+     * * `ipv4first`: for `verbatim` defaulting to `false`.
+     * * `verbatim`: for `verbatim` defaulting to `true`.
+     * @since v20.1.0
+     */
+    function getDefaultResultOrder(): "ipv4first" | "verbatim";
     /**
      * Sets the IP address and port of servers to be used when performing DNS
      * resolution. The `servers` argument is an array of [RFC 5952](https://tools.ietf.org/html/rfc5952#section-6) formatted
@@ -333,7 +341,7 @@ declare module "dns/promises" {
      * @since v10.6.0
      * @param servers array of `RFC 5952` formatted addresses
      */
-    function setServers(servers: ReadonlyArray<string>): void;
+    function setServers(servers: readonly string[]): void;
     /**
      * Set the default value of `verbatim` in `dns.lookup()` and `dnsPromises.lookup()`. The value could be:
      *

package/node_modules/@types/is-stream/node_modules/@types/node/dns.d.ts

@@ -661,7 +661,7 @@ declare module "dns" {
      * @since v0.11.3
      * @param servers array of `RFC 5952` formatted addresses
      */
-    export function setServers(servers: ReadonlyArray<string>): void;
+    export function setServers(servers: readonly string[]): void;
     /**
      * Returns an array of IP address strings, formatted according to [RFC 5952](https://tools.ietf.org/html/rfc5952#section-6),
      * that are currently configured for DNS resolution. A string will include a port

package/node_modules/@types/is-stream/node_modules/@types/node/events.d.ts

@@ -470,13 +470,41 @@ declare module "events" {
         }
 
         /**
-         * Integrates `EventEmitter` with `AsyncResource` for `EventEmitter`s that require
-         * manual async tracking. Specifically, all events emitted by instances of
-         * `EventEmitterAsyncResource` will run within its async context.
+         * Integrates `EventEmitter` with `AsyncResource` for `EventEmitter`s that
+         * require manual async tracking. Specifically, all events emitted by instances
+         * of `events.EventEmitterAsyncResource` will run within its `async context`.
          *
-         * The EventEmitterAsyncResource class has the same methods and takes the
-         * same options as EventEmitter and AsyncResource themselves.
-         * @throws if `options.name` is not provided when instantiated directly.
+         * ```js
+         * import { EventEmitterAsyncResource, EventEmitter } from 'node:events';
+         * import { notStrictEqual, strictEqual } from 'node:assert';
+         * import { executionAsyncId, triggerAsyncId } from 'node:async_hooks';
+         *
+         * // Async tracking tooling will identify this as 'Q'.
+         * const ee1 = new EventEmitterAsyncResource({ name: 'Q' });
+         *
+         * // 'foo' listeners will run in the EventEmitters async context.
+         * ee1.on('foo', () => {
+         *   strictEqual(executionAsyncId(), ee1.asyncId);
+         *   strictEqual(triggerAsyncId(), ee1.triggerAsyncId);
+         * });
+         *
+         * const ee2 = new EventEmitter();
+         *
+         * // 'foo' listeners on ordinary EventEmitters that do not track async
+         * // context, however, run in the same async context as the emit().
+         * ee2.on('foo', () => {
+         *   notStrictEqual(executionAsyncId(), ee2.asyncId);
+         *   notStrictEqual(triggerAsyncId(), ee2.triggerAsyncId);
+         * });
+         *
+         * Promise.resolve().then(() => {
+         *   ee1.emit('foo');
+         *   ee2.emit('foo');
+         * });
+         * ```
+         *
+         * The `EventEmitterAsyncResource` class has the same methods and takes the
+         * same options as `EventEmitter` and `AsyncResource` themselves.
          * @since v17.4.0, v16.14.0
          */
         export class EventEmitterAsyncResource extends EventEmitter {
@@ -485,17 +513,24 @@ declare module "events" {
              */
             constructor(options?: EventEmitterAsyncResourceOptions);
             /**
-             * Call all destroy hooks. This should only ever be called once. An
-             * error will be thrown if it is called more than once. This must be
-             * manually called. If the resource is left to be collected by the GC then
-             * the destroy hooks will never be called.
+             * Call all `destroy` hooks. This should only ever be called once. An error will
+             * be thrown if it is called more than once. This **must** be manually called. If
+             * the resource is left to be collected by the GC then the `destroy` hooks will
+             * never be called.
              */
             emitDestroy(): void;
-            /** The unique asyncId assigned to the resource. */
+            /**
+             * The unique `asyncId` assigned to the resource.
+             */
             readonly asyncId: number;
-            /** The same triggerAsyncId that is passed to the AsyncResource constructor. */
+            /**
+             * The same triggerAsyncId that is passed to the AsyncResource constructor.
+             */
             readonly triggerAsyncId: number;
-            /** The underlying AsyncResource */
+            /**
+             * The returned `AsyncResource` object has an additional `eventEmitter` property
+             * that provides a reference to this `EventEmitterAsyncResource`.
+             */
             readonly asyncResource: EventEmitterReferencingAsyncResource;
         }
     }

package/node_modules/@types/is-stream/node_modules/@types/node/fs/promises.d.ts

@@ -82,6 +82,7 @@ declare module "fs/promises" {
         emitClose?: boolean | undefined;
         start?: number | undefined;
         highWaterMark?: number | undefined;
+        flush?: boolean | undefined;
     }
     interface ReadableWebStreamOptions {
         /**
@@ -107,7 +108,10 @@ declare module "fs/promises" {
          */
         appendFile(
             data: string | Uint8Array,
-            options?: (ObjectEncodingOptions & FlagAndOpenMode) | BufferEncoding | null,
+            options?:
+                | (ObjectEncodingOptions & FlagAndOpenMode & { flush?: boolean | undefined })
+                | BufferEncoding
+                | null,
         ): Promise<void>;
         /**
          * Changes the ownership of the file. A wrapper for [`chown(2)`](http://man7.org/linux/man-pages/man2/chown.2.html).
@@ -366,7 +370,7 @@ declare module "fs/promises" {
          */
         truncate(len?: number): Promise<void>;
         /**
-         * Change the file system timestamps of the object referenced by the `FileHandle` then resolves the promise with no arguments upon success.
+         * Change the file system timestamps of the object referenced by the `FileHandle` then fulfills the promise with no arguments upon success.
          * @since v10.0.0
          */
         utimes(atime: TimeLike, mtime: TimeLike): Promise<void>;
@@ -374,14 +378,14 @@ declare module "fs/promises" {
          * Asynchronously writes data to a file, replacing the file if it already exists.`data` can be a string, a buffer, an
          * [AsyncIterable](https://tc39.github.io/ecma262/#sec-asynciterable-interface), or an
          * [Iterable](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#The_iterable_protocol) object.
-         * The promise is resolved with no arguments upon success.
+         * The promise is fulfilled with no arguments upon success.
          *
          * If `options` is a string, then it specifies the `encoding`.
          *
          * The `FileHandle` has to support writing.
          *
          * It is unsafe to use `filehandle.writeFile()` multiple times on the same file
-         * without waiting for the promise to be resolved (or rejected).
+         * without waiting for the promise to be fulfilled (or rejected).
          *
          * If one or more `filehandle.write()` calls are made on a file handle and then a`filehandle.writeFile()` call is made, the data will be written from the
          * current position till the end of the file. It doesn't always write from the
@@ -390,15 +394,18 @@ declare module "fs/promises" {
          */
         writeFile(
             data: string | Uint8Array,
-            options?: (ObjectEncodingOptions & FlagAndOpenMode & Abortable) | BufferEncoding | null,
+            options?:
+                | (ObjectEncodingOptions & FlagAndOpenMode & Abortable & { flush?: boolean | undefined })
+                | BufferEncoding
+                | null,
         ): Promise<void>;
         /**
          * Write `buffer` to the file.
          *
-         * The promise is resolved with an object containing two properties:
+         * The promise is fulfilled with an object containing two properties:
          *
          * It is unsafe to use `filehandle.write()` multiple times on the same file
-         * without waiting for the promise to be resolved (or rejected). For this
+         * without waiting for the promise to be fulfilled (or rejected). For this
          * scenario, use `filehandle.createWriteStream()`.
          *
          * On Linux, positional writes do not work when the file is opened in append mode.
@@ -430,10 +437,10 @@ declare module "fs/promises" {
         /**
          * Write an array of [ArrayBufferView](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView) s to the file.
          *
-         * The promise is resolved with an object containing a two properties:
+         * The promise is fulfilled with an object containing a two properties:
          *
          * It is unsafe to call `writev()` multiple times on the same file without waiting
-         * for the promise to be resolved (or rejected).
+         * for the promise to be fulfilled (or rejected).
          *
          * On Linux, positional writes don't work when the file is opened in append mode.
          * The kernel ignores the position argument and always appends the data to
@@ -442,14 +449,14 @@ declare module "fs/promises" {
          * @param [position='null'] The offset from the beginning of the file where the data from `buffers` should be written. If `position` is not a `number`, the data will be written at the current
          * position.
          */
-        writev(buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): Promise<WriteVResult>;
+        writev(buffers: readonly NodeJS.ArrayBufferView[], position?: number): Promise<WriteVResult>;
         /**
          * 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
          * @param [position='null'] The offset from the beginning of the file where the data should be read from. If `position` is not a `number`, the data will be read from the current position.
          * @return Fulfills upon success an object containing two properties:
          */
-        readv(buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): Promise<ReadVResult>;
+        readv(buffers: readonly NodeJS.ArrayBufferView[], position?: number): Promise<ReadVResult>;
         /**
          * Closes the file handle after waiting for any pending operation on the handle to
          * complete.
@@ -482,7 +489,7 @@ declare module "fs/promises" {
      * (e.g.`fs.constants.W_OK | fs.constants.R_OK`). Check `File access constants` for
      * possible values of `mode`.
      *
-     * If the accessibility check is successful, the promise is resolved with no
+     * If the accessibility check is successful, the promise is fulfilled with no
      * value. If any of the accessibility checks fail, the promise is rejected
      * with an [Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) object. The following example checks if the file`/etc/passwd` can be read and
      * written by the current process.
@@ -645,7 +652,7 @@ declare module "fs/promises" {
      * the filenames. If the `encoding` is set to `'buffer'`, the filenames returned
      * will be passed as `Buffer` objects.
      *
-     * If `options.withFileTypes` is set to `true`, the resolved array will contain `fs.Dirent` objects.
+     * If `options.withFileTypes` is set to `true`, the returned array will contain `fs.Dirent` objects.
      *
      * ```js
      * import { readdir } from 'node:fs/promises';
@@ -715,7 +722,7 @@ declare module "fs/promises" {
     ): Promise<Dirent[]>;
     /**
      * Reads the contents of the symbolic link referred to by `path`. See the POSIX [`readlink(2)`](http://man7.org/linux/man-pages/man2/readlink.2.html) documentation for more detail. The promise is
-     * resolved with the`linkString` upon success.
+     * fulfilled with the`linkString` upon success.
      *
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
@@ -1022,7 +1029,7 @@ declare module "fs/promises" {
     function appendFile(
         path: PathLike | FileHandle,
         data: string | Uint8Array,
-        options?: (ObjectEncodingOptions & FlagAndOpenMode) | BufferEncoding | null,
+        options?: (ObjectEncodingOptions & FlagAndOpenMode & { flush?: boolean | undefined }) | BufferEncoding | null,
     ): Promise<void>;
     /**
      * Asynchronously reads the entire contents of a file.

package/node_modules/@types/is-stream/node_modules/@types/node/fs.d.ts

@@ -2861,6 +2861,7 @@ declare module "fs" {
             & {
                 mode?: Mode | undefined;
                 flag?: string | undefined;
+                flush?: boolean | undefined;
             }
         )
         | BufferEncoding
@@ -3813,6 +3814,7 @@ declare module "fs" {
     }
     interface WriteStreamOptions extends StreamOptions {
         fs?: CreateWriteStreamFSImplementation | null | undefined;
+        flush?: boolean | undefined;
     }
     /**
      * Unlike the 16 KiB default `highWaterMark` for a `stream.Readable`, the stream
@@ -4029,12 +4031,12 @@ declare module "fs" {
      */
     export function writev(
         fd: number,
-        buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
+        buffers: readonly NodeJS.ArrayBufferView[],
         cb: (err: NodeJS.ErrnoException | null, bytesWritten: number, buffers: NodeJS.ArrayBufferView[]) => void,
     ): void;
     export function writev(
         fd: number,
-        buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
+        buffers: readonly NodeJS.ArrayBufferView[],
         position: number,
         cb: (err: NodeJS.ErrnoException | null, bytesWritten: number, buffers: NodeJS.ArrayBufferView[]) => void,
     ): void;
@@ -4045,7 +4047,7 @@ declare module "fs" {
     export namespace writev {
         function __promisify__(
             fd: number,
-            buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
+            buffers: readonly NodeJS.ArrayBufferView[],
             position?: number,
         ): Promise<WriteVResult>;
     }
@@ -4056,7 +4058,7 @@ declare module "fs" {
      * @param [position='null']
      * @return The number of bytes written.
      */
-    export function writevSync(fd: number, buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): number;
+    export function writevSync(fd: number, buffers: readonly NodeJS.ArrayBufferView[], position?: number): number;
     /**
      * Read from a file specified by `fd` and write to an array of `ArrayBufferView`s
      * using `readv()`.
@@ -4074,12 +4076,12 @@ declare module "fs" {
      */
     export function readv(
         fd: number,
-        buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
+        buffers: readonly NodeJS.ArrayBufferView[],
         cb: (err: NodeJS.ErrnoException | null, bytesRead: number, buffers: NodeJS.ArrayBufferView[]) => void,
     ): void;
     export function readv(
         fd: number,
-        buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
+        buffers: readonly NodeJS.ArrayBufferView[],
         position: number,
         cb: (err: NodeJS.ErrnoException | null, bytesRead: number, buffers: NodeJS.ArrayBufferView[]) => void,
     ): void;
@@ -4090,7 +4092,7 @@ declare module "fs" {
     export namespace readv {
         function __promisify__(
             fd: number,
-            buffers: ReadonlyArray<NodeJS.ArrayBufferView>,
+            buffers: readonly NodeJS.ArrayBufferView[],
             position?: number,
         ): Promise<ReadVResult>;
     }
@@ -4101,7 +4103,7 @@ declare module "fs" {
      * @param [position='null']
      * @return The number of bytes read.
      */
-    export function readvSync(fd: number, buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): number;
+    export function readvSync(fd: number, buffers: readonly NodeJS.ArrayBufferView[], position?: number): number;
 
     export interface OpenAsBlobOptions {
         /**