File#save should support Readable / AsyncIterable data

[matthieusieben]

Is your feature request related to a problem? Please describe.

I have a small utility function in my codebase that looks like this:

const { pipeline } = require('node:stream/promises')

async function write(file, data, type, metadata = undefined) {
  if (Buffer.isBuffer(data) || typeof data === 'string') {
    await file.save(data, {
      timeout: 9e3,
      contentType: type,
      resumable: false,
      metadata: { metadata },
    })
  } else {
    const writable = file.createWriteStream({
      timeout: 9e3,
      gzip: true,
      contentType: type,
      resumable: false,
      metadata: { metadata },
    })

    await pipeline(data, writable)
  }
}

And it seems this could easily be implemented in the lib itself.

Describe the solution you'd like

I would like File#save 's data argument to support AsyncIterable (Readable)

Describe alternatives you've considered

see code example above