feat: new resource reference interfaces

tools/@aws-cdk/spec2cdk/lib/cdk/resource-class.ts

@@ -127,6 +127,14 @@ export class ResourceClass extends ClassType {
       });
     }
 
+    // Add the arn too, unless it is duplicated in the resourceIdentifier already
+    if (this.decider.arn && this.resourceInterface.properties.every((p) => p.name !== this.decider.arn!.name)) {
+      this.resourceInterface.addProperty({
+        ...this.decider.arn,
+        immutable: true,
+      });
+    }
+
     // Build the members of this class
     this.addProperty({
       name: staticResourceTypeName(),

tools/@aws-cdk/spec2cdk/lib/cdk/resource-decider.ts

@@ -28,6 +28,10 @@ export class ResourceDecider {
 
   private readonly taggability?: TaggabilityStyle;
 
+  /**
+   * The arn returned by the resource, if applicable.
+   */
+  public readonly arn?: PropertySpec;
   public readonly primaryIdentifier = new Array<PropertySpec>();
   public readonly propsProperties = new Array<PropsProperty>();
   public readonly classProperties = new Array<ClassProperty>();
@@ -40,6 +44,7 @@ export class ResourceDecider {
     this.convertAttributes();
 
     this.convertPrimaryIdentifier();
+    this.arn = this.findArn();
 
     this.propsProperties.sort((p1, p2) => p1.propertySpec.name.localeCompare(p2.propertySpec.name));
     this.classProperties.sort((p1, p2) => p1.propertySpec.name.localeCompare(p2.propertySpec.name));
@@ -65,6 +70,18 @@ export class ResourceDecider {
     }
   }
 
+  private findArn() {
+    // A list of possible names for the arn, in order of importance.
+    // This is relevant because some resources, like AWS::VpcLattice::AccessLogSubscription
+    // has both `Arn` and `ResourceArn`, and we want to select the `Arn` property.
+    const possibleArnNames = ['Arn', `${this.resource.name}Arn`];
+    for (const arn of possibleArnNames) {
+      const att = this.classAttributeProperties.find((a) => a.propertySpec.name === attributePropertyName(arn));
+      if (att) { return att.propertySpec; }
+    }
+    return;
+  }
+
   private convertPrimaryIdentifier() {
     if (this.resource.primaryIdentifier === undefined) { return; }
     for (let i = 0; i < (this.resource.primaryIdentifier).length; i++) {