cloudstructs 0.6.43 → 0.6.45

package/node_modules/@types/cacheable-request/node_modules/@types/node/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.
 
 ### Additional Details
- * Last updated: Thu, 16 Nov 2023 21:07:02 GMT
+ * Last updated: Sun, 17 Dec 2023 21:35:25 GMT
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
 
 # Credits

package/node_modules/@types/cacheable-request/node_modules/@types/node/assert.d.ts

@@ -45,7 +45,7 @@ declare module "assert" {
                 /** The `operator` property on the error instance. */
                 operator?: string | undefined;
                 /** If provided, the generated stack trace omits frames before this function. */
-                // tslint:disable-next-line:ban-types
+                // eslint-disable-next-line @typescript-eslint/ban-types
                 stackStartFn?: Function | undefined;
             });
         }
@@ -228,7 +228,7 @@ declare module "assert" {
             expected: unknown,
             message?: string | Error,
             operator?: string,
-            // tslint:disable-next-line:ban-types
+            // eslint-disable-next-line @typescript-eslint/ban-types
             stackStartFn?: Function,
         ): never;
         /**

package/node_modules/@types/cacheable-request/node_modules/@types/node/buffer.d.ts

@@ -289,7 +289,7 @@ declare module "buffer" {
              * @param array The octets to store.
              * @deprecated since v10.0.0 - Use `Buffer.from(array)` instead.
              */
-            new(array: ReadonlyArray<any>): Buffer;
+            new(array: readonly any[]): Buffer;
             /**
              * Copies the passed {buffer} data onto a new {Buffer} instance.
              *
@@ -327,8 +327,8 @@ declare module "buffer" {
              * Creates a new Buffer using the passed {data}
              * @param data data to create a new Buffer
              */
-            from(data: Uint8Array | ReadonlyArray<number>): Buffer;
-            from(data: WithImplicitCoercion<Uint8Array | ReadonlyArray<number> | string>): Buffer;
+            from(data: Uint8Array | readonly number[]): Buffer;
+            from(data: WithImplicitCoercion<Uint8Array | readonly number[] | string>): Buffer;
             /**
              * Creates a new Buffer containing the given JavaScript string {str}.
              * If provided, the {encoding} parameter identifies the character encoding.
@@ -456,7 +456,7 @@ declare module "buffer" {
              * @param list List of `Buffer` or {@link Uint8Array} instances to concatenate.
              * @param totalLength Total length of the `Buffer` instances in `list` when concatenated.
              */
-            concat(list: ReadonlyArray<Uint8Array>, totalLength?: number): Buffer;
+            concat(list: readonly Uint8Array[], totalLength?: number): Buffer;
             /**
              * Copies the underlying memory of `view` into a new `Buffer`.
              *

package/node_modules/@types/cacheable-request/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/cacheable-request/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/cacheable-request/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/cacheable-request/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/cacheable-request/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/cacheable-request/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/cacheable-request/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/cacheable-request/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.