fix(s3): improve BucketProps types for public access control

[ChenKuanSun]

In this PR, we have enhanced the type definitions of BucketProps to provide safer and more explicit access control for S3 buckets. We've introduced two new types: BucketPropsPublicReadAccess and BucketPropsPrivateAccess, extending from the BucketPropsBase.

BucketPropsPublicReadAccess is intended for use cases where the S3 bucket needs to be publicly readable. It enforces the inclusion of a blockPublicAccess configuration whenever publicReadAccess is set to true, helping ensure that only necessary permissions are exposed.

BucketPropsPrivateAccess, on the other hand, is intended for cases where public read access is not required for the S3 bucket. It allows publicReadAccess to be false or undefined, and provides an optional blockPublicAccess configuration for additional control over public access.

Related #25983

Screenshot:

Screen.Recording.2023-07-28.at.08.27.05.mov

---

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.

[aws-cdk-automation]

The pull request linter fails with the following errors:

❌ Fixes must contain a change to a test file.
❌ Fixes must contain a change to an integration test file and the resulting snapshot.

PRs must pass status checks before we can provide a meaningful review.

If you would like to request an exemption from the status checks or clarification on feedback, please leave a comment on this PR containing Exemption Request and/or Clarification Request.

[aws-cdk-automation]

AWS CodeBuild CI Report

• CodeBuild project: AutoBuildv2Project1C6BFA3F-wQm2hXv2jqQv
• Commit ID: 2d99d4e
• Result: FAILED
• Build Logs (available for 30 days)

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

[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.