TypeScript definitions for `Dropbox.prototype.filesDownload`

[FreeMasen]

Current this method is defined as returning Promise<dropbox.files.FileMetadata>.

The actual return value is closer to Promise<dropbox.files.FileMetadata & {fileBlob?: File}>;

I am not sure if it would be more appropriate to change this to its own type definitions like dropbox.files.FileDownloadResult or to just user the & syntax listed above. I am also not sure if the fileBlob property is actually optional or not.

[greg-db]

Thanks for pointing this out! I'll ask the team to fix that up.

The file data (in fileBlob in browser environments, or fileBinary in Node) is guaranteed for any "download" style call, such as filesDownload, as long as the call succeeds (i.e., doesn't raise an error).

[SebastienGllmt]

Seems this is a duplicate of https://github.com/dropbox/dropbox-sdk-js/issues/162#issuecomment-364779780 (and a few other ones like #82)

[justinmoon]

This is still confusing

[greg-db]

@justinmoon Thanks for the note!

[LeanderD]

Any idea when this will be fixed?

[greg-db]

@LeanderD Unfortunately I don't have a timeline for work on this.