stream: add AbortSignal support to promisified pipeline

[Linkgoron]

This PR adds support for AbortSignal to promisified pipeline (in stream/promises)

This resolves #37321.

As an aside, this wouldn't be hard to actually push it into pipeline itself and support it in the regular version, however it's already pretty simple to just call addAbortSignal from stream on the received pipeline.

• make -j4 test (UNIX), or vcbuild test (Windows) passes
• tests and/or benchmarks are included
• documentation is changed or added
• commit message follows commit guidelines

[benjamingr]

@ronag

[ronag]

@benjamingr: Isn't the usual pattern to send an options object i.e. { signal }?

[ronag]

needs docs?

[benjamingr]

Yeah I tend to prefer options with a signal too

[Linkgoron]

I've updated the docs, and also changed it to receive an options parameter, in the promise version (and added some checks, to make sure that the options object is really an options object).

@ronag I could also "push" the changes from the promise version, into the regular pipeline implementation, so that both the "regular" pipeline and promisified pipeline support cancellation. where the API will change to:
stream.pipeline(source[, ...transforms], destination[,options], callback)
stream.pipeline(streams[,options], callback)

Similarly to what was done in readline.question, a few weeks ago.

[nodejs-github-bot]

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

[benjamingr]

Landed in 38f6e5a 🎉