feat: enable ctor arg passthrough for requestHandler

Author: kuhe

.changeset/three-paws-add.md

@@ -0,0 +1,6 @@
+---
+"@smithy/protocol-http": minor
+"@smithy/smithy-client": minor
+---
+
+allow constructor parameters pass-through when initializing requestHandler

packages/protocol-http/src/httpHandler.ts

@@ -1,7 +1,12 @@
-import { HttpHandlerOptions, RequestHandler } from "@smithy/types";
+import type {
+  FetchHttpHandlerOptions,
+  HttpHandlerOptions,
+  NodeHttpHandlerOptions,
+  RequestHandler,
+} from "@smithy/types";
 
-import { HttpRequest } from "./httpRequest";
-import { HttpResponse } from "./httpResponse";
+import type { HttpRequest } from "./httpRequest";
+import type { HttpResponse } from "./httpResponse";
 
 /**
  * @internal
@@ -23,3 +28,21 @@ export type HttpHandler<HttpHandlerConfig extends object = {}> = RequestHandler<
    */
   httpHandlerConfigs(): HttpHandlerConfig;
 };
+
+/**
+ * @public
+ *
+ * A type representing the accepted user inputs for the `requestHandler` field
+ * of a client's constructor object.
+ *
+ * You may provide an instance of an HttpHandler, or alternatively
+ * provide the constructor arguments as an object which will be passed
+ * to the constructor of the default request handler.
+ *
+ * The default class constructor to which your arguments will be passed
+ * varies. The Node.js default is the NodeHttpHandler and the browser/react-native
+ * default is the FetchHttpHandler. In rarer cases specific clients may be
+ * configured to use other default implementations such as Websocket or HTTP2.
+ *
+ */
+export type HttpHandlerUserInput = HttpHandler | NodeHttpHandlerOptions | FetchHttpHandlerOptions;

packages/smithy-client/src/client.ts

@@ -1,11 +1,19 @@
 import { constructStack } from "@smithy/middleware-stack";
-import { Client as IClient, Command, MetadataBearer, MiddlewareStack, RequestHandler } from "@smithy/types";
+import {
+  Client as IClient,
+  Command,
+  FetchHttpHandlerOptions,
+  MetadataBearer,
+  MiddlewareStack,
+  NodeHttpHandlerOptions,
+  RequestHandler,
+} from "@smithy/types";
 
 /**
  * @public
  */
 export interface SmithyConfiguration<HandlerOptions> {
-  requestHandler: RequestHandler<any, any, HandlerOptions>;
+  requestHandler: RequestHandler<any, any, HandlerOptions> | NodeHttpHandlerOptions | FetchHttpHandlerOptions | any;
   /**
    * The API version set internally by the SDK, and is
    * not planned to be used by customer code.
@@ -17,7 +25,10 @@ export interface SmithyConfiguration<HandlerOptions> {
 /**
  * @internal
  */
-export type SmithyResolvedConfiguration<HandlerOptions> = SmithyConfiguration<HandlerOptions>;
+export type SmithyResolvedConfiguration<HandlerOptions> = {
+  requestHandler: RequestHandler<any, any, HandlerOptions>;
+  readonly apiVersion: string;
+};
 
 /**
  * @public