Binary streaming

[richardm-stripe]

Notify

r? @dcr-stripe
cc @stripe/api-libraries

Summary

This PR adds support for defining 'streaming' stripe methods on the Stripe client. Unlike existing methods, 'streaming' methods do not buffer the response body into memory and try to parse it into json -- they pass the underlying http.Request object to the caller, so that the caller can pipe it to a file or socket without having to buffer it.

The motivation for this is an upcoming /pdf method that will return a pdf instead of JSON.

Also incidentally adds the ability to set "host" per-request, this was useful in my testing.

[dcr-stripe]

Looks good overall! Extremely minor comments - thanks Richard!

[richardm-stripe]

r? @dcr-stripe - the problem was that there were test cases that were supposed to trigger timeouts by never calling res.end(). In these cases, the "finish" or "close" events wouldn't fire. There's not really a cute way to automatically close the server in these cases after the test case is finished, so I had the helper expose a closeServer function to trigger manually on the test case, for now.
2923bde

[dcr-stripe]

problem was that there were test cases that were supposed to trigger timeouts by never calling res.end(). In these cases, the "finish" or "close" events wouldn't fire. There's not really a cute way to automatically close the server in these cases after the test case is finished, so I had the helper expose a closeServer function to trigger manually on the test case, for now.

Ahhh good find. Makes sense! Thanks for digging into this Richard - LGTM! 🚢