fs: add windowsHandle option to file streams

[PickBas]

On Windows, a value passed as fd to fs.createReadStream() / fs.createWriteStream() is treated as a CRT file descriptor. When the value is actually a raw Win32 HANDLE, for example an inherited anonymous pipe handle received from another process, it fails with EBADF, since libuv operates on CRT file descriptors.

This adds a windowsHandle option to both stream constructors that wraps the HANDLE in a CRT file descriptor via _open_osfhandle(), so the stream can read from or write to it normally.

Fixes: #57288

[nodejs-github-bot]

Review requested:

• @nodejs/gyp

[PickBas]

@addaleax Could you please take another look at this PR?

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/74815/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/74844/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75006/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75041/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75196/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75244/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75248/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75422/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75462/

[codecov]

Codecov Report

❌ Patch coverage is 91.66667% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.31%. Comparing base (ee64033) to head (36f2bcd).
⚠️ Report is 3 commits behind head on main.

Files with missing lines	Patch %	Lines
lib/internal/fs/streams.js	91.66%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #63851      +/-   ##
==========================================
+ Coverage   90.29%   90.31%   +0.02%     
==========================================
  Files         759      759              
  Lines      247754   247788      +34     
  Branches    46721    46741      +20     
==========================================
+ Hits       223708   223798      +90     
+ Misses      15521    15468      -53     
+ Partials     8525     8522       -3     

Files with missing lines	Coverage Δ
src/node_file.cc	74.23% <ø> (-0.04%)	⬇️
lib/internal/fs/streams.js	93.10% <91.66%> (-0.12%)	⬇️

... and 35 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/75572/