Incomplete Documentation For filesGetThumbnail

[pneyrinck]

The docs do not describe how the thumbnail data is returned. Via debugging I see a string property named fileBinary. The docs have no mention of this property anywhere.

[greg-db]

Thanks for pointing that out! Using fileBinary is the correct way of accessing the resulting data in node. (In the browser, it's fileBlob.) I'll ask the team to add this to the documentation.

[jvilk]

This is a limitation / issue with the Stone API specification. The Dropbox JS SDK manually adds fileBinary/fileBlob to the object because that property isn't in the Stone API specification. As a corollary, the TypeScript definition files lack these properties, and require hacky typecasting to 'any' to compile.

If you fix this in a generic manner (through e.g. arguments to the Stone generators that pass in library-specific augmentations to the Stone specification), then you could kill two birds with one stone -- improve the TypeScript definition files and correct the documentation.