fix(core): overrideLogicalId validation

[nmussy]

Issue # (if applicable)

Closes #29701

Reason for this change

Calling overrideLogicalId on a Construct with an invalid logical ID (docs) would not throw an error at synthesis time. CloudFormation would

Description of changes

• Validate overrideLogicalId (must not be empty, must not be over 255 characters, must match /^[A-Za-z0-9]+$/
• Document exceptions with @error JSDoc tags

Description of how you validated changes

I've added unit tests, integration tests should not be necessary

Checklist

• My code adheres to the CONTRIBUTING GUIDE and DESIGN GUIDELINES

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[aws-cdk-automation]

The pull request linter has failed. See the aws-cdk-automation comment below for failure reasons. If you believe this pull request should receive an exemption, please comment and provide a justification.

A comment requesting an exemption should contain the text Exemption Request. Additionally, if clarification is needed add Clarification Request to a comment.

[nmussy]

Exemption Request: This is just a synth time check, CloudFormation is already failing if unhappy with the logical ID

[aws-cdk-automation]

AWS CodeBuild CI Report

• CodeBuild project: AutoBuildv2Project1C6BFA3F-wQm2hXv2jqQv
• Commit ID: e5dbaef
• Result: SUCCEEDED
• Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

[TheRealAmazonKendra]

I'm hesitant to accept this but am open to conversation about it. If CloudFormation updates their requirements here, it would create more manual work on our end. Is the error message unclear enough at deploy time that this provides a major quality of life improvement for users?

[nmussy]

The CloudFormation deploy time message is absolutely clear about this issue, this is a duplicated synth time check

The main issue is the difference in how the CDK resolves regular construct generated logical IDs vs overrides. The IDs provided to the constructor are slugified, but not the overrides:

new cdk.CfnOutput(this, 'Invalid construct name', { 
  value: 'value', 
});

new cdk.CfnOutput(this, 'Output', { 
  value: 'value', 
}).overrideLogicalId('Another invalid construct name');

$ npm run cdk synth

Outputs:
  Invalidconstructname:
    Value: value
  Another invalid construct name:
    Value: value

I don't think changing this behavior to also slugify the override is warranted, to leave the escape hatch as is. Giving the user an early warning is probably best.

This PR would also prevent an issue like #29700 from reoccurring. An integration test would have caught it, but a unit test would have been sufficient with this change.

[aws-cdk-automation]

This PR has been in the CHANGES REQUESTED state for 3 weeks, and looks abandoned. To keep this PR from being closed, please continue work on it. If not, it will automatically be closed in a week.

[nmussy]

@TheRealAmazonKendra Bump

[aws-cdk-automation]

This PR has been deemed to be abandoned, and will be automatically closed. Please create a new PR for these changes if you think this decision has been made in error.

[nmussy]

@TheRealAmazonKendra Bunping again 😅