chore(signature-v4-multi-region): cleanups and docstrings

Author: siddsriv

Diff for: packages/signature-v4-multi-region/package.json

@@ -24,7 +24,6 @@
     "@aws-sdk/types": "*",
     "@smithy/protocol-http": "^4.0.3",
     "@smithy/signature-v4": "^3.1.2",
-    "@smithy/signature-v4a": "*",
     "@smithy/types": "^3.3.0",
     "tslib": "^2.6.2"
   },

Diff for: packages/signature-v4-multi-region/src/SignatureV4MultiRegion.ts

@@ -79,7 +79,7 @@ export class SignatureV4MultiRegion implements RequestPresigner, RequestSigner {
   private getSigv4aSigner(): InstanceType<OptionalCrtSignerV4> | InstanceType<OptionalSigV4aSigner> {
     if (!this.sigv4aSigner) {
       let CrtSignerV4: OptionalCrtSignerV4 | null = null;
-      let JsSigV4a: OptionalSigV4aSigner | null = null;
+      let JsSigV4aSigner: OptionalSigV4aSigner | null = null;
 
       if (signatureV4CrtContainer.CrtSignerV4) {
         try {
@@ -102,8 +102,8 @@ export class SignatureV4MultiRegion implements RequestPresigner, RequestSigner {
         });
       } else if (signatureV4aContainer.SignatureV4a) {
         try {
-          JsSigV4a = signatureV4aContainer.SignatureV4a;
-          if (typeof JsSigV4a !== "function") throw new Error();
+          JsSigV4aSigner = signatureV4aContainer.SignatureV4a;
+          if (typeof JsSigV4aSigner !== "function") throw new Error();
         } catch (e) {
           e.message =
             `${e.message}\n` +
@@ -113,13 +113,13 @@ export class SignatureV4MultiRegion implements RequestPresigner, RequestSigner {
           throw e;
         }
 
-        this.sigv4aSigner = new JsSigV4a({
+        this.sigv4aSigner = new JsSigV4aSigner({
           ...this.signerOptions,
         });
       } else {
         throw new Error(
           "Neither CRT nor JS SigV4a implementation is available. " +
-            "Please load either @aws-sdk/signature-v4-crt or @smithy/signature-v4a."
+          "Please load either @aws-sdk/signature-v4-crt or @smithy/signature-v4a."
         );
       }
     }

Diff for: packages/signature-v4-multi-region/src/signature-v4a-container.ts

@@ -5,6 +5,12 @@ import type { HttpRequest, RequestPresigner, RequestSigner, RequestSigningArgume
  * @public
  */
 export type OptionalSigV4aSigner = {
+  /**
+   * This constructor is not typed so as not to require a type import
+   * from the signature-v4a package.
+   *
+   * The true type is SignatureV4a from @smithy/signature-v4a.
+   */
   new (options: any): RequestPresigner &
     RequestSigner & {
       signWithCredentials(
@@ -17,6 +23,11 @@ export type OptionalSigV4aSigner = {
 
 /**
  * @public
+ *
+ * \@smithy/signature-v4a will install the constructor in this
+ * container if it is installed.
+ *
+ * This avoids a runtime-require being interpreted statically by bundlers.
  */
 export const signatureV4aContainer: {
   SignatureV4a: null | OptionalSigV4aSigner;