feat(client): allow binary returns (#416)

src/core.ts

@@ -52,6 +52,10 @@ async function defaultParseResponse<T>(props: APIResponseProps): Promise<T> {
     return null as T;
   }
 
+  if (props.options.__binaryResponse) {
+    return response as unknown as T;
+  }
+
   const contentType = response.headers.get('content-type');
   if (contentType?.includes('application/json')) {
     const json = await response.json();
@@ -61,10 +65,11 @@ async function defaultParseResponse<T>(props: APIResponseProps): Promise<T> {
     return json as T;
   }
 
-  // TODO handle blob, arraybuffer, other content types, etc.
   const text = await response.text();
   debug('response', response.status, response.url, response.headers, text);
-  return text as any as T;
+
+  // TODO handle blob, arraybuffer, other content types, etc.
+  return text as unknown as T;
 }
 
 /**
@@ -729,6 +734,8 @@ export type RequestOptions<Req extends {} = Record<string, unknown> | Readable>
   httpAgent?: Agent;
   signal?: AbortSignal | undefined | null;
   idempotencyKey?: string;
+
+  __binaryResponse?: boolean | undefined;
 };
 
 // This is required so that we can determine if a given object matches the RequestOptions
@@ -747,6 +754,8 @@ const requestOptionsKeys: KeysEnum<RequestOptions> = {
   httpAgent: true,
   signal: true,
   idempotencyKey: true,
+
+  __binaryResponse: true,
 };
 
 export const isRequestOptions = (obj: unknown): obj is RequestOptions<Record<string, unknown> | Readable> => {