lib: promise version of streams.finished call clean up

ref: #44556
src: add autoCleanup logic to finished
docs: add autoCleanup true as default

doc/api/stream.md

@@ -2376,6 +2376,9 @@ changes:
     underlying stream will _not_ be aborted if the signal is aborted. The
     callback will get called with an `AbortError`. All registered
     listeners added by this function will also be removed.
+  * `autoCleanup` {boolean} remove all registered stream listeners.
+    **Default:** `true`.
+
 * `callback` {Function} A callback function that takes an optional error
   argument.
 * Returns: {Function} A cleanup function which removes all registered

lib/internal/streams/end-of-stream.js

@@ -19,6 +19,7 @@ const {
   validateAbortSignal,
   validateFunction,
   validateObject,
+  validateBoolean
 } = require('internal/validators');
 
 const { Promise } = primordials;
@@ -243,8 +244,19 @@ function eos(stream, options, callback) {
 }
 
 function finished(stream, opts) {
+  let autoCleanup = true;
+  if (opts === null) {
+    opts = kEmptyObject;
+  }
+  if (opts.autoCleanup) {
+    validateBoolean(opts.autoCleanup, 'autoCleanup');
+    autoCleanup = opts.autoCleanup;
+  }
   return new Promise((resolve, reject) => {
-    eos(stream, opts, (err) => {
+    const cleanup = eos(stream, opts, (err) => {
+      if (autoCleanup) {
+        cleanup();
+      }
       if (err) {
         reject(err);
       } else {