deal with legacy APIs

Author: mrgrain

packages/aws-cdk/lib/legacy-aws-auth.ts

@@ -0,0 +1,69 @@
+// This is a legacy wrapper for code from the aws-auth that we want to keep the signatures intact
+// We generally use two different patterns here:
+// - make a copy of the old code as is
+// - wrap the old code and add a deprecation warning
+// This way we can keep the old code running until the new code is fully ready
+// and can be used by the users that are ready to migrate
+// The old code will be removed in a future version of aws-cdk
+import type { AwsCredentialIdentityProvider, Logger, NodeHttpHandlerOptions } from '@smithy/types';
+import { SdkProvider as SdkProviderCurrentVersion } from './api/aws-auth/sdk-provider';
+import { CliIoHost } from './cli/io-host';
+
+/**
+ * Options for individual SDKs
+ */
+interface SdkHttpOptions {
+  /**
+   * Proxy address to use
+   *
+   * @default No proxy
+   */
+  readonly proxyAddress?: string;
+
+  /**
+   * A path to a certificate bundle that contains a cert to be trusted.
+   *
+   * @default No certificate bundle
+   */
+  readonly caBundlePath?: string;
+}
+
+/**
+ * Options for the default SDK provider
+ */
+interface SdkProviderOptions {
+  /**
+   * Profile to read from ~/.aws
+   *
+   * @default - No profile
+   */
+  readonly profile?: string;
+
+  /**
+   * HTTP options for SDK
+   */
+  readonly httpOptions?: SdkHttpOptions;
+
+  /**
+   * The logger for sdk calls.
+   */
+  readonly logger?: Logger;
+}
+
+export class SdkProvider {
+  public static async withAwsCliCompatibleDefaults(options: SdkProviderOptions = {}) {
+    return SdkProviderCurrentVersion.withAwsCliCompatibleDefaults({
+      ...options,
+      ioHelper: CliIoHost.instance().asIoHelper(),
+    });
+  }
+
+  public constructor(
+    defaultCredentialProvider: AwsCredentialIdentityProvider,
+    defaultRegion: string,
+    requestHandler: NodeHttpHandlerOptions = {},
+    logger?: Logger,
+  ) {
+    return new SdkProviderCurrentVersion(defaultCredentialProvider, defaultRegion, requestHandler, CliIoHost.instance().asIoHelper(), logger);
+  }
+}

packages/aws-cdk/lib/legacy-exports-source.ts

@@ -5,25 +5,31 @@
 
 // Note: All type exports are in `legacy-exports.ts`
 export * from './legacy-logging-source';
-export { deepClone, flatten, ifDefined, isArray, isEmpty, numberFromBool, partition, padLeft as leftPad, contentHash, deepMerge, lowerCaseFirstCharacter } from './util';
+
+// API
+export { SdkProvider } from './legacy-aws-auth';
+export { setSdkTracing as enableTracing } from './api/aws-auth/tracing';
+export { cached } from './api/aws-auth/cached';
+export { CfnEvaluationException } from './api/cloudformation';
+export { CloudExecutable } from './api/cxapp/cloud-executable';
+export { execProgram } from './api/cxapp/exec';
+export { Deployments } from './api/deployments';
 export { deployStack } from './api/deployments/deploy-stack';
-export { cli, exec } from './cli/cli';
-export { SdkProvider } from './api/aws-auth';
 export { PluginHost } from './api/plugin';
-export { Command, Configuration, PROJECT_CONTEXT } from './cli/user-configuration';
 export { Settings } from './api/settings';
 export { Bootstrapper } from './api/bootstrap';
-export { CloudExecutable } from './api/cxapp/cloud-executable';
-export { execProgram } from './api/cxapp/exec';
-export { RequireApproval } from './commands/diff';
-export { formatAsBanner } from './cli/util/console-formatters';
-export { setSdkTracing as enableTracing } from './api/aws-auth/tracing';
-export { aliases, command, describe } from './commands/docs';
-export { Deployments } from './api/deployments';
+
+// CLI
+export { cli, exec } from './cli/cli';
 export { cliRootDir as rootDir } from './cli/root-dir';
+export { Command, Configuration, PROJECT_CONTEXT } from './cli/user-configuration';
+export { formatAsBanner } from './cli/util/console-formatters';
 export { latestVersionIfHigher, versionNumber } from './cli/version';
+
+// Commands
+export { RequireApproval } from './commands/diff';
 export { availableInitTemplates } from './commands/init';
-export { cached } from './api/aws-auth/cached';
-export { CfnEvaluationException } from './api/cloudformation/evaluate-cloudformation-template';
-export { CredentialPlugins } from './api/aws-auth/credential-plugins';
-export { AwsCliCompatible } from './api/aws-auth/awscli-compatible';
+export { aliases, command, describe } from './commands/docs';
+
+// util
+export { deepClone, flatten, ifDefined, isArray, isEmpty, numberFromBool, partition, padLeft as leftPad, contentHash, deepMerge, lowerCaseFirstCharacter } from './util';

packages/aws-cdk/lib/legacy-exports.ts

@@ -70,8 +70,6 @@ export const {
   availableInitTemplates,
   cached,
   CfnEvaluationException,
-  CredentialPlugins,
-  AwsCliCompatible,
   withCorkedLogging,
   LogLevel,
   logLevel,