revert(core): add source tracing for L1 construct property mutations (#37415)

Reverts #37285

Closes #37407

Author: 9pace

packages/aws-cdk-lib/aws-sns/test/sns.test.ts

@@ -1,14 +1,10 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
 import { Template } from '../../assertions';
-import { AssertionError } from '../../assertions/lib/private/error';
 import * as notifications from '../../aws-codestarnotifications';
 import * as iam from '../../aws-iam';
 import { ServicePrincipal } from '../../aws-iam';
 import * as kms from '../../aws-kms';
 import { CfnKey } from '../../aws-kms';
 import * as cdk from '../../core';
-import { Stage } from '../../core';
 import * as sns from '../lib';
 import { TopicGrants } from '../lib';
 
@@ -1086,67 +1082,4 @@ describe('Topic', () => {
       ).toThrow('`fifoThroughputScope` can only be set for FIFO SNS topics.');
     });
   });
-
-  /*
-  This is a representative test suite for source tracing.
-  What we are asserting here about CfnTopic applies to all L1 constructs.
-   */
-  describe('Source tracing', () => {
-    test('Metadata contains propertyAssignment and stack trace with CDK_DEBUG=1', () => {
-      try {
-        process.env.CDK_DEBUG = '1';
-        const stack = new cdk.Stack();
-
-        const topic = new sns.CfnTopic(stack, 'MyTopic', {
-          topicName: 'topicName',
-        });
-
-        topic.displayName = 'something';
-        const lineWherePropertyWasSet = getLineNumber() - 1; // the one before this one
-
-        const asm = synth(stack);
-        const metadata = JSON.parse(fs.readFileSync(path.join(asm.directory, 'Default.metadata.json'), 'utf8'));
-        const propertyAssignmentEntry = metadata['/Default/MyTopic'].find((e: any) => e.type === 'aws:cdk:propertyAssignment');
-
-        expect(propertyAssignmentEntry).toBeDefined();
-        expect(propertyAssignmentEntry.data.propertyName).toEqual('DisplayName');
-        expect(propertyAssignmentEntry.data.stackTrace.some(
-          (t: string) => t.includes(`${__filename}:${lineWherePropertyWasSet}`)),
-        ).toBe(true);
-      } finally {
-        delete process.env.CDK_DEBUG;
-      }
-    });
-
-    test('Metadata does not contain propertyAssignment by default', () => {
-      const stack = new cdk.Stack();
-
-      const topic = new sns.CfnTopic(stack, 'MyTopic', {
-        topicName: 'topicName',
-      });
-
-      topic.displayName = 'something';
-
-      const asm = synth(stack);
-      const metadata = JSON.parse(fs.readFileSync(path.join(asm.directory, 'Default.metadata.json'), 'utf8'));
-      const propertyAssignmentEntry = metadata['/Default/MyTopic'].find((e: any) => e.type === 'aws:cdk:propertyAssignment');
-
-      expect(propertyAssignmentEntry).toBeUndefined();
-    });
-  });
 });
-
-function synth(stack: cdk.Stack) {
-  const stage = Stage.of(stack);
-  if (!Stage.isStage(stage)) {
-    throw new AssertionError('unexpected: all stacks must be part of a Stage or an App');
-  }
-
-  return stage.synth();
-}
-
-function getLineNumber(): number {
-  const err = new Error();
-  const line = err.stack?.split('\n')[2]?.match(/:(\d+):\d+\)?$/)?.[1];
-  return Number(line);
-}

packages/aws-cdk-lib/core/lib/stack-trace.ts

@@ -1,4 +1,3 @@
-import type { Node } from 'constructs';
 import { debugModeEnabled } from './debug';
 
 /**
@@ -191,25 +190,3 @@ interface CallSite {
   fileName: string;
   sourceLocation: string;
 }
-
-/**
- * Records a metadata entry on a construct node to trace a property assignment.
- *
- * When debug mode is enabled (via the `CDK_DEBUG` environment variable),
- * this attaches `aws:cdk:propertyAssignment` metadata to the given node,
- * including a stack trace pointing back to the caller. This is useful for
- * diagnosing where a particular property value was set during synthesis.
- *
- * This is a no-op when debug mode is not enabled.
- *
- * @param node the construct node to attach the metadata to.
- * @param propertyName the name of the property being assigned.
- */
-export function traceProperty(node: Node, propertyName: string) {
-  if (debugModeEnabled()) {
-    node.addMetadata('aws:cdk:propertyAssignment', {
-      propertyName,
-      stackTrace: captureStackTrace(traceProperty),
-    });
-  }
-}

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

@@ -36,7 +36,6 @@ export class CdkCore extends ExternalModule {
   public readonly unionMapper = makeCallableExpr(this, 'unionMapper');
   public readonly requireProperty = makeCallableExpr(this, 'requireProperty');
   public readonly isResolvableObject = makeCallableExpr(this, 'isResolvableObject');
-  public readonly traceProperty = makeCallableExpr(this, 'traceProperty');
   public readonly mapArrayInPlace = makeCallableExpr(this, 'mapArrayInPlace');
 
   public readonly ValidationResult = $T(Type.fromName(this, 'ValidationResult'));

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

@@ -217,31 +217,7 @@ export class ResourceClass extends ClassType implements Referenceable {
     }
 
     for (const prop of this.decider.classProperties) {
-      const spec = prop.propertySpec;
-      if (spec.immutable) {
-        this.addProperty(spec);
-      } else {
-        // For mutable properties, generate getter and setter
-        const backingFieldName = `_${spec.name}`;
-        this.addProperty({
-          name: backingFieldName,
-          type: spec.type,
-          optional: spec.optional,
-          visibility: MemberVisibility.Private,
-          docs: spec.docs,
-        });
-        this.addProperty({
-          name: spec.name,
-          type: spec.type,
-          optional: spec.optional,
-          docs: spec.docs,
-          getterBody: Block.with(stmt.ret($this[backingFieldName])),
-          setterBody: (value: Expression) => Block.with(
-            CDK_CORE.traceProperty($this.node, expr.lit(prop.cfnName)),
-            stmt.assign($this[backingFieldName], value),
-          ),
-        });
-      }
+      this.addProperty(prop.propertySpec);
     }
 
     // Copy properties onto class and props type
@@ -769,8 +745,8 @@ export class ResourceClass extends ClassType implements Referenceable {
 
     init.addBody(
       // Props
-      ...this.decider.classProperties.map(({ propertySpec: { name, immutable }, initializer }) =>
-        stmt.assign($this[immutable ? name : `_${name}`], initializer(props)),
+      ...this.decider.classProperties.map(({ propertySpec: { name }, initializer }) =>
+        stmt.assign($this[name], initializer(props)),
       ),
     );
 

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

@@ -104,7 +104,6 @@ export class ResourceDecider {
         immutable: false,
         docs: this.defaultClassPropDocs(cfnName, prop),
       },
-      cfnName,
       initializer: resolverResult.resolver,
       cfnValueToRender: { [resolverResult.name]: $this[resolverResult.name] },
     });
@@ -167,7 +166,6 @@ export class ResourceDecider {
             summary: 'Tag Manager which manages the tags for this resource',
           },
         },
-        cfnName,
         initializer: (props: Expression) =>
           new CDK_CORE.TagManager(
             this.tagManagerVariant(variant),
@@ -186,7 +184,6 @@ export class ResourceDecider {
           optional: true, // Tags are never required
           docs: this.defaultClassPropDocs(cfnName, prop),
         },
-        cfnName,
         initializer: (props: Expression) => $E(props)[originalName],
         cfnValueToRender: {}, // Gets rendered as part of the TagManager above
       },
@@ -224,7 +221,6 @@ export class ResourceDecider {
             summary: 'Tag Manager which manages the tags for this resource',
           },
         },
-        cfnName,
         initializer: (_: Expression) =>
           new CDK_CORE.TagManager(
             this.tagManagerVariant(variant),
@@ -243,7 +239,6 @@ export class ResourceDecider {
           optional: true, // Tags are never required
           docs: this.defaultClassPropDocs(cfnName, prop),
         },
-        cfnName,
         initializer: (props: Expression) => $E(props)[originalName],
         cfnValueToRender: {}, // Gets rendered as part of the TagManager above
       },
@@ -369,9 +364,6 @@ export interface PropsProperty {
 export interface ClassProperty {
   readonly propertySpec: PropertySpec;
 
-  /** The original CloudFormation property name */
-  readonly cfnName: string;
-
   /** Given the name of the props value, produce the member value */
   readonly initializer: (props: Expression) => Expression;
 

tools/@aws-cdk/spec2cdk/test/__snapshots__/cfn-prop-mixins.test.ts.snap

@@ -1,4 +1,4 @@
-// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+// Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`L1 property mixin for a standard-issue resource 1`] = `
 "/* eslint-disable prettier/prettier, @stylistic/max-len */

tools/@aws-cdk/spec2cdk/test/__snapshots__/fake-services.test.ts.snap

@@ -1,4 +1,4 @@
-// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+// Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`can codegen deprecated service 1`] = `
 "/* eslint-disable prettier/prettier, @stylistic/max-len */
@@ -54,7 +54,7 @@ export class CfnResource extends cdk.CfnResource implements cdk.IInspectable, IR
   /**
    * The identifier of the resource.
    */
-  private _id?: string;
+  public id?: string;
 
   /**
    * Create a new \`AWS::Some::Resource\`.
@@ -69,7 +69,7 @@ export class CfnResource extends cdk.CfnResource implements cdk.IInspectable, IR
       properties: props
     });
 
-    this._id = props.id;
+    this.id = props.id;
   }
 
   public get resourceRef(): ResourceReference {
@@ -78,20 +78,6 @@ export class CfnResource extends cdk.CfnResource implements cdk.IInspectable, IR
     };
   }
 
-  /**
-   * The identifier of the resource.
-   */
-  public get id(): string | undefined {
-    return this._id;
-  }
-  /**
-   * The identifier of the resource.
-   */
-  public set id(value: string | undefined) {
-    cdk.traceProperty(this.node, "Id");
-    this._id = value;
-  }
-
   protected get cfnProperties(): Record<string, any> {
     return {
       id: this.id