PnP: Allow FileHandle#read into TypedArrays and DataViews (#6950)

## What's the problem this PR addresses?

Fixes #6890
Fixes #6145

Node's
[implementation](https://github.com/nodejs/node/blob/94cbb7758282bf5db837412f7cb3698f17ac1af3/lib/internal/fs/promises.js#L648)
of `FileHandle#read` allows reading into `TypedArray`s and `DataView`s
(collectively known as `ArrayBufferView`s, and checks for them using
`ArrayBuffer.isView()`.

On the other hand, our implementation checks using `Buffer.isBuffer()`
and thus only allows `Buffer`. If an `ArrayBufferView` is given, it
treats them as an options bag and pass its `.buffer` (which is an
`ArrayBuffer`) as the sink to the backing fs. If the backing fs is
Node's native `fs` then it would throw.

## How did you fix it?

Allow `ArrayBufferView`s by checking with `ArrayBuffer.isView()` as in
Node's implementation.

Because the underlying `FakeFS` interface only allows `Buffer` (and
changing that would be a breaking change), a `Buffer` backed by the
`ArrayBufferView` is used. (Q: Should we make that change next major?)

Also un-vendored the TypeScript types if the exact same type is
available from `@types/node` along the way. AFAICT those were vendored
because those types wasn't available at first? \cc @merceyz

This fix should be orthogonal to #6919 

## Checklist

<!--- Don't worry if you miss something, chores are automatically
tested. -->
<!--- This checklist exists to help you remember doing the chores when
you submit a PR. -->
<!--- Put an `x` in all the boxes that apply. -->
- [x] I have read the [Contributing
Guide](https://yarnpkg.com/advanced/contributing).

<!-- See
https://yarnpkg.com/advanced/contributing#preparing-your-pr-to-be-released
for more details. -->
<!-- Check with `yarn version check` and fix with `yarn version check
-i` -->
- [x] I have set the packages that need to be released for my changes to
be effective.

<!-- The "Testing chores" workflow validates that your PR follows our
guidelines. -->
<!-- If it doesn't pass, click on it to see details as to what your PR
might be missing. -->
- [x] I will check that all automated PR checks pass before the PR gets
reviewed.

---------

Co-authored-by: Maël Nison <[email protected]>

Author: clemyan

.pnp.cjs

@@ -0,0 +1,39 @@
+releases:
+  "@yarnpkg/cli": patch
+  "@yarnpkg/fslib": patch
+  "@yarnpkg/pnp": patch
+
+declined:
+  - "@yarnpkg/plugin-catalog"
+  - "@yarnpkg/plugin-compat"
+  - "@yarnpkg/plugin-constraints"
+  - "@yarnpkg/plugin-dlx"
+  - "@yarnpkg/plugin-essentials"
+  - "@yarnpkg/plugin-exec"
+  - "@yarnpkg/plugin-file"
+  - "@yarnpkg/plugin-git"
+  - "@yarnpkg/plugin-github"
+  - "@yarnpkg/plugin-init"
+  - "@yarnpkg/plugin-interactive-tools"
+  - "@yarnpkg/plugin-jsr"
+  - "@yarnpkg/plugin-link"
+  - "@yarnpkg/plugin-nm"
+  - "@yarnpkg/plugin-npm"
+  - "@yarnpkg/plugin-npm-cli"
+  - "@yarnpkg/plugin-pack"
+  - "@yarnpkg/plugin-patch"
+  - "@yarnpkg/plugin-pnp"
+  - "@yarnpkg/plugin-pnpm"
+  - "@yarnpkg/plugin-stage"
+  - "@yarnpkg/plugin-typescript"
+  - "@yarnpkg/plugin-version"
+  - "@yarnpkg/plugin-workspace-tools"
+  - vscode-zipfs
+  - "@yarnpkg/builder"
+  - "@yarnpkg/core"
+  - "@yarnpkg/doctor"
+  - "@yarnpkg/libzip"
+  - "@yarnpkg/nm"
+  - "@yarnpkg/pnpify"
+  - "@yarnpkg/sdks"
+  - "@yarnpkg/shell"

.yarn/versions/21efef87.yml

@@ -114,7 +114,7 @@ describe(`Commands`, () => {
         });
 
         expect(manifest.resolutions).toEqual({
-        [`no-deps@npm:1.0.0`]: expect.stringMatching(/^patch:no-deps/),
+          [`no-deps@npm:1.0.0`]: expect.stringMatching(/^patch:no-deps/),
         });
       }),
     );

packages/acceptance-tests/pkg-tests-specs/sources/commands/patchCommit.test.ts

@@ -1,49 +1,23 @@
-import type {BigIntStats, ReadStream, StatOptions, Stats, WriteStream, WriteVResult} from 'fs';
-import {createInterface}                                                             from 'readline';
-
-import type {CreateReadStreamOptions, CreateWriteStreamOptions, FakeFS}              from '../FakeFS';
-import type {Path}                                                                   from '../path';
-
-// Types copied from https://github.com/DefinitelyTyped/DefinitelyTyped/blob/9e2e5af93f9cc2cf434a96e3249a573100e87351/types/node/v16
-// Implementation based on https://github.com/nodejs/node/blob/10493b48c7edb227c13a493d0a2c75efe878d7e9/lib/internal/fs/promises.js#L124-L336
-
-interface ObjectEncodingOptions {
-  encoding?: BufferEncoding | null | undefined;
-}
-
-interface FlagAndOpenMode {
-  mode?: Mode | undefined;
-  flag?: OpenMode | undefined;
-}
-
-type OpenMode = number | string;
-type Mode = number | string;
-
-interface FileReadResult<T extends ArrayBufferView> {
-  bytesRead: number;
-  buffer: T;
-}
-
-interface FileReadOptions<T extends ArrayBufferView = Buffer> {
-  buffer?: T;
-  offset?: number | null;
-  length?: number | null;
-  position?: number | null;
-}
-
-interface ReadVResult {
-  bytesRead: number;
-  buffers: Array<NodeJS.ArrayBufferView>;
-}
-
-interface AbortSignal {
-  readonly aborted: boolean;
-}
-
-interface Abortable {
-  signal?: AbortSignal | undefined;
-}
-
+import type {Abortable}                                                 from 'events';
+import type {FlagAndOpenMode, FileReadResult, FileReadOptions}          from 'fs/promises';
+import {createInterface}                                                from 'readline';
+
+import type {CreateReadStreamOptions, CreateWriteStreamOptions, FakeFS} from '../FakeFS';
+import type {Path}                                                      from '../path';
+
+import type {
+  BigIntStats,
+  ObjectEncodingOptions,
+  OpenMode,
+  ReadStream,
+  ReadVResult,
+  StatOptions,
+  Stats,
+  WriteStream,
+  WriteVResult,
+} from 'fs';
+
+// Implementation based on https://github.com/nodejs/node/blob/v18.12.0/lib/internal/fs/promises.js#L132-L351
 
 type WriteArgsBuffer<TBuffer extends Uint8Array> = [
   buffer: TBuffer,
@@ -133,45 +107,70 @@ export class FileHandle<P extends Path> {
     throw new Error(`Method not implemented.`);
   }
 
-  async read(options?: FileReadOptions<Buffer>): Promise<FileReadResult<Buffer>>;
-  async read(
-    buffer: Buffer,
+  // TODO: Once we drop Node 20 support, switch to ReadOptions and ReadOptionsWithoutBuffer from `@types/node`
+  async read<T extends NodeJS.ArrayBufferView>(
+    buffer: T,
     offset?: number | null,
     length?: number | null,
-    position?: number | null
-  ): Promise<FileReadResult<Buffer>>;
+    position?: number | null,
+  ): Promise<FileReadResult<T>>;
+  async read<T extends NodeJS.ArrayBufferView>(
+    buffer: T,
+    options?: Omit<FileReadOptions<T>, `buffer`>,
+  ): Promise<FileReadResult<T>>;
+  async read<T extends NodeJS.ArrayBufferView = NonSharedBuffer>(
+    options: FileReadOptions<T> & {buffer: T},
+  ): Promise<FileReadResult<T>>;
   async read(
-    bufferOrOptions?: Buffer | FileReadOptions<Buffer>,
-    offset?: number | null,
+    options?: FileReadOptions<NonSharedBuffer> & {buffer?: never},
+  ): Promise<FileReadResult<NonSharedBuffer>>;
+  async read<T extends NodeJS.ArrayBufferView>(
+    bufferOrOptions?: T | FileReadOptions<T>,
+    offsetOrOptions?: number | null | Omit<FileReadOptions<T>, `buffer`>,
     length?: number | null,
     position?: number | null,
-  ): Promise<FileReadResult<Buffer>> {
+  ): Promise<FileReadResult<T>> {
     try {
       this[kRef](this.read);
 
-      let buffer: Buffer;
-
-      if (!Buffer.isBuffer(bufferOrOptions)) {
-        bufferOrOptions ??= {};
-        buffer = bufferOrOptions.buffer ?? Buffer.alloc(16384);
-        offset = bufferOrOptions.offset || 0;
-        length = bufferOrOptions.length ?? buffer.byteLength;
-        position = bufferOrOptions.position ?? null;
+      let buffer: T;
+      let offset: number;
+
+      if (!ArrayBuffer.isView(bufferOrOptions)) {
+        // read([options])
+        // TypeScript isn't able to infer that the coalescing happens only in the no-generic case
+        buffer = bufferOrOptions?.buffer ?? Buffer.alloc(16384) as unknown as T;
+        offset = bufferOrOptions?.offset ?? 0;
+        length = bufferOrOptions?.length ?? buffer.byteLength - offset;
+        position = bufferOrOptions?.position ?? null;
+      } else if (typeof offsetOrOptions === `object` && offsetOrOptions !== null) {
+        // read(buffer[, options])
+        buffer = bufferOrOptions;
+        offset = offsetOrOptions?.offset ?? 0;
+        length = offsetOrOptions?.length ?? buffer.byteLength - offset;
+        position = offsetOrOptions?.position ?? null;
       } else {
+        // read(buffer, offset[, length[, position]])
         buffer = bufferOrOptions;
+        offset = offsetOrOptions ?? 0;
+        length ??= 0;
       }
 
-      offset ??= 0;
-      length ??= 0;
-
       if (length === 0) {
         return {
           bytesRead: length,
           buffer,
         };
       }
 
-      const bytesRead = await this[kBaseFs].readPromise(this.fd, buffer, offset, length, position);
+      const bytesRead = await this[kBaseFs].readPromise(
+        this.fd,
+        // FIXME: FakeFS should support ArrayBufferViews directly
+        Buffer.isBuffer(buffer) ? buffer : Buffer.from(buffer.buffer, buffer.byteOffset, buffer.byteLength),
+        offset,
+        length,
+        position,
+      );
 
       return {
         bytesRead,