Add typed createFetchHttpClient function. (#1273)

lib/stripe.js

@@ -142,6 +142,18 @@ Stripe.createNodeHttpClient = (agent) => {
   return new NodeHttpClient(agent);
 };
 
+/**
+ * Creates an HTTP client for issuing Stripe API requests which uses the Web
+ * Fetch API.
+ *
+ * A fetch function can optionally be passed in as a parameter. If none is
+ * passed, will default to the default `fetch` function in the global scope.
+ */
+Stripe.createFetchHttpClient = (fetchFn) => {
+  const {FetchHttpClient} = require('./net/FetchHttpClient');
+  return new FetchHttpClient(fetchFn);
+};
+
 Stripe.prototype = {
   /**
    * @deprecated will be removed in a future major version. Use the config object instead:

types/net/net.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference lib="dom" />
 
 import {IncomingMessage} from 'http';
 declare module 'stripe' {
@@ -61,5 +62,21 @@ declare module 'stripe' {
     ) => HttpClient<
       HttpClientResponse<IncomingMessage, Stripe.StripeStreamResponse>
     >;
+
+    /**
+     * Creates an HTTP client for issuing Stripe API requests which uses the Web
+     * Fetch API.
+     *
+     * A fetch function can optionally be passed in as a parameter. If none is
+     * passed, will default to the default `fetch` function in the global scope.
+     */
+    export const createFetchHttpClient: (
+      fetchFn?: WindowOrWorkerGlobalScope['fetch']
+    ) => HttpClient<
+      HttpClientResponse<
+        ReturnType<WindowOrWorkerGlobalScope['fetch']>,
+        ReadableStream<Uint8Array>
+      >
+    >;
   }
 }

types/test/typescriptTest.ts

@@ -222,3 +222,30 @@ async (): Promise<void> => {
 
   const jsonResponse: object = await response.toJSON();
 };
+
+// Test FetchHttpClient request processing.
+async (): Promise<void> => {
+  const client = Stripe.createFetchHttpClient(window.fetch);
+
+  const response = await client.makeRequest(
+    'api.stripe.com',
+    '443',
+    '/test',
+    'POST',
+    {
+      'Stripe-Account': 'account',
+      'Content-Length': 123,
+    },
+    'requestdata',
+    'https',
+    80000
+  );
+
+  const stream: ReadableStream = response.toStream(() => {
+    return;
+  });
+
+  const results = await stream.getReader().read();
+
+  const jsonResponse: object = await response.toJSON();
+};