chore(appconfig): add typeAsString escape hatch for custom configuration types

packages/aws-cdk-lib/aws-appconfig/lib/configuration.ts

@@ -58,6 +58,16 @@ export interface ConfigurationOptions {
    */
   readonly type?: ConfigurationType;
 
+  /**
+   * The type of configuration as a string. Use this to specify custom configuration types
+   * that are not available in the ConfigurationType enum.
+   *
+   * This property takes precedence over the 'type' property if both are specified.
+   *
+   * @default - Uses the 'type' property value
+   */
+  readonly typeAsString?: string;
+
   /**
    * The list of environments to deploy the configuration to.
    *
@@ -136,6 +146,11 @@ export interface IConfiguration extends IConstruct {
    */
   readonly type?: ConfigurationType;
 
+  /**
+   * The configuration type as a string.
+   */
+  readonly typeAsString?: string;
+
   /**
    * The environments to deploy to.
    */
@@ -186,6 +201,11 @@ abstract class ConfigurationBase extends Construct implements IConfiguration, IE
    */
   public readonly type?: ConfigurationType;
 
+  /**
+   * The configuration type as a string.
+   */
+  public readonly typeAsString?: string;
+
   /**
    * The deployment key for the configuration.
    */
@@ -210,6 +230,7 @@ abstract class ConfigurationBase extends Construct implements IConfiguration, IE
     this.application = props.application;
     this.applicationId = this.application.applicationId;
     this.type = props.type;
+    this.typeAsString = props.typeAsString;
     this.validators = props.validators;
     this.description = props.description;
     this.deployTo = props.deployTo;
@@ -349,6 +370,13 @@ abstract class ConfigurationBase extends Construct implements IConfiguration, IE
       environment.addDeployment(this);
     });
   }
+
+  /**
+   * Gets the effective configuration type, with typeAsString taking precedence over type.
+   */
+  protected effectiveType(): string | undefined {
+    return this.typeAsString || this.type;
+  }
 }
 
 /**
@@ -469,7 +497,7 @@ export class HostedConfiguration extends ConfigurationBase {
       locationUri: 'hosted',
       name: this.name!,
       description: this.description,
-      type: this.type,
+      type: this.effectiveType(),
       validators: this.validators,
       deletionProtectionCheck: this.deletionProtectionCheck,
       kmsKeyIdentifier: props.kmsKey?.keyRef.keyArn,
@@ -609,7 +637,7 @@ export class SourcedConfiguration extends ConfigurationBase {
       name: this.name!,
       description: this.description,
       retrievalRoleArn: this.retrievalRole?.roleArn,
-      type: this.type,
+      type: this.effectiveType(),
       validators: this.validators,
       deletionProtectionCheck: this.deletionProtectionCheck,
     });

packages/aws-cdk-lib/aws-appconfig/test/configuration.test.ts

@@ -705,6 +705,58 @@ describe('configuration', () => {
     Template.fromStack(stack).resourceCountIs('AWS::AppConfig::Deployment', 0);
   });
 
+  test('configuration profile with typeAsString feature flags', () => {
+    const stack = new cdk.Stack();
+    const app = new Application(stack, 'MyAppConfig');
+    new HostedConfiguration(stack, 'MyConfigurationProfile', {
+      name: 'TestConfigProfile',
+      application: app,
+      typeAsString: 'AWS.AppConfig.FeatureFlags',
+      content: ConfigurationContent.fromInlineText('This is my content'),
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::AppConfig::ConfigurationProfile', {
+      Name: 'TestConfigProfile',
+      Type: 'AWS.AppConfig.FeatureFlags',
+      LocationUri: 'hosted',
+    });
+  });
+
+  test('configuration profile with typeAsString freeform', () => {
+    const stack = new cdk.Stack();
+    const app = new Application(stack, 'MyAppConfig');
+    new HostedConfiguration(stack, 'MyConfigurationProfile', {
+      name: 'TestConfigProfile',
+      application: app,
+      typeAsString: 'AWS.Freeform',
+      content: ConfigurationContent.fromInlineText('This is my content'),
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::AppConfig::ConfigurationProfile', {
+      Name: 'TestConfigProfile',
+      Type: 'AWS.Freeform',
+      LocationUri: 'hosted',
+    });
+  });
+
+  test('configuration profile typeAsString takes precedence over type', () => {
+    const stack = new cdk.Stack();
+    const app = new Application(stack, 'MyAppConfig');
+    new HostedConfiguration(stack, 'MyConfigurationProfile', {
+      name: 'TestConfigProfile',
+      application: app,
+      type: ConfigurationType.FEATURE_FLAGS,
+      typeAsString: 'AWS.Freeform',
+      content: ConfigurationContent.fromInlineText('This is my content'),
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::AppConfig::ConfigurationProfile', {
+      Name: 'TestConfigProfile',
+      Type: 'AWS.Freeform',
+      LocationUri: 'hosted',
+    });
+  });
+
   test('configuration profile with description', () => {
     const stack = new cdk.Stack();
     const app = new Application(stack, 'MyAppConfig');