chore(config-resolver): resolve fips/dualstack config

Author: trivikr

packages/config-resolver/src/endpointsConfig/resolveCustomEndpointsConfig.ts

@@ -1,6 +1,7 @@
 import { Endpoint, Provider, UrlParser } from "@aws-sdk/types";
 
 import { EndpointsInputConfig, EndpointsResolvedConfig } from "./resolveEndpointsConfig";
+import { normalizeBoolean } from "./utils/normalizeBoolean";
 import { normalizeEndpoint } from "./utils/normalizeEndpoint";
 
 export interface CustomEndpointsInputConfig extends EndpointsInputConfig {
@@ -29,4 +30,6 @@ export const resolveCustomEndpointsConfig = <T>(
   tls: input.tls ?? true,
   endpoint: normalizeEndpoint(input),
   isCustomEndpoint: true,
+  useDualstackEndpoint: normalizeBoolean(input.useDualstackEndpoint!),
+  useFipsEndpoint: normalizeBoolean(input.useFipsEndpoint!),
 });

packages/config-resolver/src/endpointsConfig/resolveEndpointsConfig.ts

@@ -1,6 +1,7 @@
 import { Endpoint, Provider, RegionInfoProvider, UrlParser } from "@aws-sdk/types";
 
 import { getEndpointFromRegion } from "./utils/getEndpointFromRegion";
+import { normalizeBoolean } from "./utils/normalizeBoolean";
 import { normalizeEndpoint } from "./utils/normalizeEndpoint";
 
 export interface EndpointsInputConfig {
@@ -13,6 +14,16 @@ export interface EndpointsInputConfig {
    * Whether TLS is enabled for requests.
    */
   tls?: boolean;
+
+  /**
+   * Enables IPv6/IPv4 dualstack endpoint.
+   */
+  useDualstackEndpoint?: boolean | Provider<boolean>;
+
+  /**
+   * Enables FIPS compatible endpoints.
+   */
+  useFipsEndpoint?: boolean | Provider<boolean>;
 }
 
 interface PreviouslyResolved {
@@ -23,7 +34,7 @@ interface PreviouslyResolved {
 
 export interface EndpointsResolvedConfig extends Required<EndpointsInputConfig> {
   /**
-   * Resolved value for input {@link EndpointsResolvedConfig.endpoint}
+   * Resolved value for input {@link EndpointsInputConfig.endpoint}
    */
   endpoint: Provider<Endpoint>;
 
@@ -32,6 +43,16 @@ export interface EndpointsResolvedConfig extends Required<EndpointsInputConfig>
    * @internal
    */
   isCustomEndpoint: boolean;
+
+  /**
+   * Resolved value for input {@link EndpointsInputConfig.useDualstackEndpoint}
+   */
+  useDualstackEndpoint: Provider<boolean>;
+
+  /**
+   * Resolved value for input {@link EndpointsInputConfig.useFipsEndpoint}
+   */
+  useFipsEndpoint: Provider<boolean>;
 }
 
 export const resolveEndpointsConfig = <T>(
@@ -43,4 +64,6 @@ export const resolveEndpointsConfig = <T>(
     ? normalizeEndpoint({ ...input, endpoint: input.endpoint })
     : () => getEndpointFromRegion(input),
   isCustomEndpoint: input.endpoint ? true : false,
+  useDualstackEndpoint: normalizeBoolean(input.useDualstackEndpoint!),
+  useFipsEndpoint: normalizeBoolean(input.useFipsEndpoint!),
 });

packages/config-resolver/src/endpointsConfig/utils/normalizeBoolean.spec.ts

@@ -0,0 +1,13 @@
+import { normalizeBoolean } from "./normalizeBoolean";
+
+describe(normalizeBoolean.name, () => {
+  it.each([true, false])("returns Provider if value is boolean: %s", async (value) => {
+    const output = normalizeBoolean(value);
+    expect(await output()).toEqual(value);
+  });
+
+  it.each([true, false])("returns Provider if it's a Provider which returns %s", (value) => {
+    const mockBooleanProvider = () => Promise.resolve(value);
+    expect(normalizeBoolean(mockBooleanProvider)).toBe(mockBooleanProvider);
+  });
+});

packages/config-resolver/src/endpointsConfig/utils/normalizeBoolean.ts

@@ -0,0 +1,10 @@
+import { Provider } from "@aws-sdk/types";
+
+// TODO: Move to a utility file which can be used across packages
+export const normalizeBoolean = (value: boolean | Provider<boolean>): Provider<boolean> => {
+  if (typeof value === "boolean") {
+    const promisified = Promise.resolve(value);
+    return () => promisified;
+  }
+  return value as Provider<boolean>;
+};