@aws-cdk/aws-s3tables-alpha 2.207.0-alpha.0 → 2.209.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.207.0",
+    "aws-cdk-lib": "^2.209.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -4030,7 +4030,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "5.7.18 (build 7d9997b)",
+  "jsiiVersion": "5.7.20 (build 433aee4)",
   "keywords": [
     "aws",
     "cdk",
@@ -4053,7 +4053,7 @@
   },
   "name": "@aws-cdk/aws-s3tables-alpha",
   "readme": {
-    "markdown": "# Amazon S3 Tables Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n## Amazon S3 Tables\n\nAmazon S3 Tables deliver the first cloud object store with built-in Apache Iceberg support and streamline storing tabular data at scale.\n\n[Product Page](https://aws.amazon.com/s3/features/tables/) | [User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables.html)\n\n\n## Usage\n\n### Define an S3 Table Bucket\n\n```ts\n// Build a Table bucket\nconst sampleTableBucket = new TableBucket(scope, 'ExampleTableBucket', {\n    tableBucketName: 'example-bucket-1',\n    // optional fields:\n    unreferencedFileRemoval: {\n        status: UnreferencedFileRemovalStatus.ENABLED,\n        noncurrentDays: 20,\n        unreferencedDays: 20,\n    }\n});\n```\n\nLearn more about table buckets maintenance operations and default behavior from the [S3 Tables User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html)\n\n### Controlling Table Bucket Permissions\n\n```ts\n// Grant the principal read permissions to the bucket and all tables within\nconst accountId = '123456789012'\ntableBucket.grantRead(new iam.AccountPrincipal(accountId), '*');\n\n// Grant the role write permissions to the bucket and all tables within\nconst role = new iam.Role(stack, 'MyRole', { assumedBy: new iam.ServicePrincipal('sample') });\ntableBucket.grantWrite(role, '*');\n\n// Grant the user read and write permissions to the bucket and all tables within\ntableBucket.grantReadWrite(new iam.User(stack, 'MyUser'), '*');\n\n// Grant permissions to the bucket and a particular table within it\nconst tableId = '6ba046b2-26de-44cf-9144-0c7862593a7b'\ntableBucket.grantReadWrite(new iam.AccountPrincipal(accountId), tableId);\n\n// Add custom resource policy statements\nconst permissions = new iam.PolicyStatement({\n    effect: iam.Effect.ALLOW,\n    actions: ['s3tables:*'],\n    principals: [ new iam.ServicePrincipal('example.aws.internal') ],\n    resources: ['*']\n});\n\ntableBucket.addToResourcePolicy(permissions);\n```\n\n### Controlling Table Bucket Encryption Settings\n\nS3 TableBuckets have SSE (server-side encryption with AES-256) enabled by default with S3 managed keys.\nYou can also bring your own KMS key for KMS-SSE or have S3 create a KMS key for you.\n\nIf a bucket is encrypted with KMS, grant functions on the bucket will also grant access\nto the TableBucket's associated KMS key.\n\n```ts\n// Provide a user defined KMS Key:\nconst key = new kms.Key(scope, 'UserKey', {});\nconst encryptedBucket = new TableBucket(scope, 'EncryptedTableBucket', {\n    tableBucketName: 'table-bucket-1',\n    encryption: TableBucketEncryption.KMS,\n    encryptionKey: key,\n});\n// This account principal will also receive kms:Decrypt access to the KMS key\nencryptedBucket.grantRead(new iam.AccountPrincipal('123456789012'), '*');\n\n// Use S3 managed server side encryption (default)\nconst encryptedBucketDefault = new TableBucket(scope, 'EncryptedTableBucketDefault', {\n    tableBucketName: 'table-bucket-3',\n    encryption: TableBucketEncryption.S3_MANAGED, // Uses AES-256 encryption by default\n});\n```\n\nWhen using KMS encryption (`TableBucketEncryption.KMS`), if no encryption key is provided, CDK will automatically create a new KMS key for the table bucket with necessary permissions.\n\n```ts\n// If no key is provided, one will be created automatically\nconst encryptedBucketAuto = new TableBucket(scope, 'EncryptedTableBucketAuto', {\n    tableBucketName: 'table-bucket-2',\n    encryption: TableBucketEncryption.KMS,\n});\n```\n\n## Coming Soon\n\nL2 Construct support for:\n\n- Namespaces\n- Tables\n"
+    "markdown": "# Amazon S3 Tables Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n## Amazon S3 Tables\n\nAmazon S3 Tables deliver the first cloud object store with built-in Apache Iceberg support and streamline storing tabular data at scale.\n\n[Product Page](https://aws.amazon.com/s3/features/tables/) | [User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables.html)\n\n\n## Usage\n\n### Define an S3 Table Bucket\n\n```ts\n// Build a Table bucket\nconst sampleTableBucket = new TableBucket(scope, 'ExampleTableBucket', {\n    tableBucketName: 'example-bucket-1',\n    // optional fields:\n    unreferencedFileRemoval: {\n        status: UnreferencedFileRemovalStatus.ENABLED,\n        noncurrentDays: 20,\n        unreferencedDays: 20,\n    }\n});\n```\n\n### Define an S3 Tables Namespace\n\n```ts\n// Build a namespace\nconst sampleNamespace = new Namespace(scope, 'ExampleNamespace', {\n    namespaceName: 'example-namespace-1',\n    tableBucket: tableBucket,\n});\n```\n\n### Define an S3 Table\n\n```ts\n// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});\n```\n\nLearn more about table buckets maintenance operations and default behavior from the [S3 Tables User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html)\n\n### Controlling Table Bucket Permissions\n\n```ts\n// Grant the principal read permissions to the bucket and all tables within\nconst accountId = '123456789012'\ntableBucket.grantRead(new iam.AccountPrincipal(accountId), '*');\n\n// Grant the role write permissions to the bucket and all tables within\nconst role = new iam.Role(stack, 'MyRole', { assumedBy: new iam.ServicePrincipal('sample') });\ntableBucket.grantWrite(role, '*');\n\n// Grant the user read and write permissions to the bucket and all tables within\ntableBucket.grantReadWrite(new iam.User(stack, 'MyUser'), '*');\n\n// Grant permissions to the bucket and a particular table within it\nconst tableId = '6ba046b2-26de-44cf-9144-0c7862593a7b'\ntableBucket.grantReadWrite(new iam.AccountPrincipal(accountId), tableId);\n\n// Add custom resource policy statements\nconst permissions = new iam.PolicyStatement({\n    effect: iam.Effect.ALLOW,\n    actions: ['s3tables:*'],\n    principals: [ new iam.ServicePrincipal('example.aws.internal') ],\n    resources: ['*']\n});\n\ntableBucket.addToResourcePolicy(permissions);\n```\n\n### Controlling Table Bucket Encryption Settings\n\nS3 TableBuckets have SSE (server-side encryption with AES-256) enabled by default with S3 managed keys.\nYou can also bring your own KMS key for KMS-SSE or have S3 create a KMS key for you.\n\nIf a bucket is encrypted with KMS, grant functions on the bucket will also grant access\nto the TableBucket's associated KMS key.\n\n```ts\n// Provide a user defined KMS Key:\nconst key = new kms.Key(scope, 'UserKey', {});\nconst encryptedBucket = new TableBucket(scope, 'EncryptedTableBucket', {\n    tableBucketName: 'table-bucket-1',\n    encryption: TableBucketEncryption.KMS,\n    encryptionKey: key,\n});\n// This account principal will also receive kms:Decrypt access to the KMS key\nencryptedBucket.grantRead(new iam.AccountPrincipal('123456789012'), '*');\n\n// Use S3 managed server side encryption (default)\nconst encryptedBucketDefault = new TableBucket(scope, 'EncryptedTableBucketDefault', {\n    tableBucketName: 'table-bucket-3',\n    encryption: TableBucketEncryption.S3_MANAGED, // Uses AES-256 encryption by default\n});\n```\n\nWhen using KMS encryption (`TableBucketEncryption.KMS`), if no encryption key is provided, CDK will automatically create a new KMS key for the table bucket with necessary permissions.\n\n```ts\n// If no key is provided, one will be created automatically\nconst encryptedBucketAuto = new TableBucket(scope, 'EncryptedTableBucketAuto', {\n    tableBucketName: 'table-bucket-2',\n    encryption: TableBucketEncryption.KMS,\n});\n```\n\n## Coming Soon\n\nL2 Construct support for:\n\n- Table Policy\n- KMS encryption support for Tables\n"
   },
   "repository": {
     "directory": "packages/@aws-cdk/aws-s3tables-alpha",
@@ -4087,6 +4087,217 @@
     }
   },
   "types": {
+    "@aws-cdk/aws-s3tables-alpha.CompactionProperty": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "default": "- No compaction settings",
+        "stability": "experimental",
+        "summary": "Settings governing the Compaction maintenance action.",
+        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.CompactionProperty",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 115
+      },
+      "name": "CompactionProperty",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Status of the compaction maintenance action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 119
+          },
+          "name": "status",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.Status"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Target file size in megabytes for compaction."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 123
+          },
+          "name": "targetFileSizeMb",
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "lib/table:CompactionProperty"
+    },
+    "@aws-cdk/aws-s3tables-alpha.INamespace": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Represents an S3 Tables Namespace."
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.INamespace",
+      "interfaces": [
+        "aws-cdk-lib.IResource"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/namespace.ts",
+        "line": 12
+      },
+      "name": "INamespace",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The name of this namespace."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 17
+          },
+          "name": "namespaceName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The table bucket which this namespace belongs to."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 23
+          },
+          "name": "tableBucket",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.ITableBucket"
+          }
+        }
+      ],
+      "symbolId": "lib/namespace:INamespace"
+    },
+    "@aws-cdk/aws-s3tables-alpha.ITable": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Represents an S3 Table."
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.ITable",
+      "interfaces": [
+        "aws-cdk-lib.IResource"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 18
+      },
+      "name": "ITable",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The ARN of this table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 23
+          },
+          "name": "tableArn",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The name of this table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 29
+          },
+          "name": "tableName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The accountId containing this table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 35
+          },
+          "name": "account",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The region containing this table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 41
+          },
+          "name": "region",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/table:ITable"
+    },
     "@aws-cdk/aws-s3tables-alpha.ITableBucket": {
       "assembly": "@aws-cdk/aws-s3tables-alpha",
       "docs": {
@@ -4164,189 +4375,1025 @@
                 "primitive": "string"
               }
             }
-          ],
-          "returns": {
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_iam.Grant"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "If encryption is used, permission to use the key to encrypt/decrypt the contents\nof the bucket will also be granted to the same principal.",
+            "stability": "experimental",
+            "summary": "Grant read and write permissions for this table bucket and its tables to an IAM principal (Role/Group/User)."
+          },
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 101
+          },
+          "name": "grantReadWrite",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "The principal to allow read and write permissions to."
+              },
+              "name": "identity",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            },
+            {
+              "docs": {
+                "summary": "Allow the permissions to all tables using '*' or to single table by its unique ID."
+              },
+              "name": "tableId",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_iam.Grant"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "If encryption is used, permission to use the key to encrypt the contents\nof the bucket will also be granted to the same principal.",
+            "stability": "experimental",
+            "summary": "Grant write permissions for this table bucket and its tables to an IAM principal (Role/Group/User)."
+          },
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 89
+          },
+          "name": "grantWrite",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "The principal to allow write permissions to."
+              },
+              "name": "identity",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            },
+            {
+              "docs": {
+                "summary": "Allow the permissions to all tables using '*' or to single table by its unique ID."
+              },
+              "name": "tableId",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_iam.Grant"
+            }
+          }
+        }
+      ],
+      "name": "ITableBucket",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The ARN of the table bucket."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 21
+          },
+          "name": "tableBucketArn",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The name of the table bucket."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 27
+          },
+          "name": "tableBucketName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The accountId containing the table bucket."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 33
+          },
+          "name": "account",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Optional KMS encryption key associated with this table bucket."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 44
+          },
+          "name": "encryptionKey",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_kms.IKey"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The region containing the table bucket."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 39
+          },
+          "name": "region",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/table-bucket:ITableBucket"
+    },
+    "@aws-cdk/aws-s3tables-alpha.IcebergMetadataProperty": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "see": "http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3tables-table-icebergmetadata.html",
+        "stability": "experimental",
+        "summary": "Contains details about the metadata for an Iceberg table.",
+        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.IcebergMetadataProperty",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 144
+      },
+      "name": "IcebergMetadataProperty",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "see": "http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3tables-table-icebergmetadata.html#cfn-s3tables-table-icebergmetadata-icebergschema",
+            "stability": "experimental",
+            "summary": "Contains details about the schema for an Iceberg table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 150
+          },
+          "name": "icebergSchema",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.IcebergSchemaProperty"
+          }
+        }
+      ],
+      "symbolId": "lib/table:IcebergMetadataProperty"
+    },
+    "@aws-cdk/aws-s3tables-alpha.IcebergSchemaProperty": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Contains details about the schema for an Iceberg table.",
+        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.IcebergSchemaProperty",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 156
+      },
+      "name": "IcebergSchemaProperty",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Contains details about the schema for an Iceberg table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 160
+          },
+          "name": "schemaFieldList",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/aws-s3tables-alpha.SchemaFieldProperty"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "lib/table:IcebergSchemaProperty"
+    },
+    "@aws-cdk/aws-s3tables-alpha.Namespace": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "base": "aws-cdk-lib.Resource",
+      "docs": {
+        "remarks": "A namespace is a logical container for tables within a table bucket.",
+        "stability": "experimental",
+        "summary": "An S3 Tables Namespace with helpers.",
+        "example": "// Build a namespace\nconst sampleNamespace = new Namespace(scope, 'ExampleNamespace', {\n    namespaceName: 'example-namespace-1',\n    tableBucket: tableBucket,\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.Namespace",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "lib/namespace.ts",
+          "line": 155
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@aws-cdk/aws-s3tables-alpha.NamespaceProps"
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "@aws-cdk/aws-s3tables-alpha.INamespace"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/namespace.ts",
+        "line": 65
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Import an existing namespace from its attributes."
+          },
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 73
+          },
+          "name": "fromNamespaceAttributes",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "attrs",
+              "type": {
+                "fqn": "@aws-cdk/aws-s3tables-alpha.NamespaceAttributes"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-s3tables-alpha.INamespace"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "custom": {
+              "throws": "UnscopedValidationError if any naming errors are detected"
+            },
+            "stability": "experimental",
+            "summary": "See https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-naming.html."
+          },
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 86
+          },
+          "name": "validateNamespaceName",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "Name of the namespace."
+              },
+              "name": "namespaceName",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "static": true
+        }
+      ],
+      "name": "Namespace",
+      "properties": [
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Uniquely identifies this class."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 68
+          },
+          "name": "PROPERTY_INJECTION_ID",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of this namespace."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 148
+          },
+          "name": "namespaceName",
+          "overrides": "@aws-cdk/aws-s3tables-alpha.INamespace",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The table bucket which this namespace belongs to."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 153
+          },
+          "name": "tableBucket",
+          "overrides": "@aws-cdk/aws-s3tables-alpha.INamespace",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.ITableBucket"
+          }
+        }
+      ],
+      "symbolId": "lib/namespace:Namespace"
+    },
+    "@aws-cdk/aws-s3tables-alpha.NamespaceAttributes": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Attributes for importing an existing namespace.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as s3tables_alpha from '@aws-cdk/aws-s3tables-alpha';\n\ndeclare const tableBucket: s3tables_alpha.TableBucket;\nconst namespaceAttributes: s3tables_alpha.NamespaceAttributes = {\n  namespaceName: 'namespaceName',\n  tableBucket: tableBucket,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.NamespaceAttributes",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/namespace.ts",
+        "line": 48
+      },
+      "name": "NamespaceAttributes",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of the namespace."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 52
+          },
+          "name": "namespaceName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The table bucket this namespace belongs to."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 57
+          },
+          "name": "tableBucket",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.ITableBucket"
+          }
+        }
+      ],
+      "symbolId": "lib/namespace:NamespaceAttributes"
+    },
+    "@aws-cdk/aws-s3tables-alpha.NamespaceProps": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Parameters for constructing a Namespace.",
+        "example": "// Build a namespace\nconst sampleNamespace = new Namespace(scope, 'ExampleNamespace', {\n    namespaceName: 'example-namespace-1',\n    tableBucket: tableBucket,\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.NamespaceProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/namespace.ts",
+        "line": 29
+      },
+      "name": "NamespaceProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "A name for the namespace."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 33
+          },
+          "name": "namespaceName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The table bucket this namespace belongs to."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 37
+          },
+          "name": "tableBucket",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.ITableBucket"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "RemovalPolicy.DESTROY",
+            "stability": "experimental",
+            "summary": "Policy to apply when the policy is removed from this stack."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/namespace.ts",
+            "line": 42
+          },
+          "name": "removalPolicy",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.RemovalPolicy"
+          }
+        }
+      ],
+      "symbolId": "lib/namespace:NamespaceProps"
+    },
+    "@aws-cdk/aws-s3tables-alpha.OpenTableFormat": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Supported open table formats."
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.OpenTableFormat",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 103
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Apache Iceberg table format."
+          },
+          "name": "ICEBERG"
+        }
+      ],
+      "name": "OpenTableFormat",
+      "symbolId": "lib/table:OpenTableFormat"
+    },
+    "@aws-cdk/aws-s3tables-alpha.SchemaFieldProperty": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Contains details about a schema field.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as s3tables_alpha from '@aws-cdk/aws-s3tables-alpha';\nconst schemaFieldProperty: s3tables_alpha.SchemaFieldProperty = {\n  name: 'name',\n  type: 'type',\n\n  // the properties below are optional\n  required: false,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.SchemaFieldProperty",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 166
+      },
+      "name": "SchemaFieldProperty",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of the field."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 170
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "S3 Tables supports all Apache Iceberg primitive types. For more information, see the [Apache Iceberg documentation](https://docs.aws.amazon.com/https://iceberg.apache.org/spec/#primitive-types).",
+            "stability": "experimental",
+            "summary": "The field type."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 186
+          },
+          "name": "type",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "By default, this is `false` and null values are allowed in the field. If this is `true`, the field does not allow null values.",
+            "stability": "experimental",
+            "summary": "A Boolean value that specifies whether values are required for each row in this field."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 179
+          },
+          "name": "required",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "lib/table:SchemaFieldProperty"
+    },
+    "@aws-cdk/aws-s3tables-alpha.SnapshotManagementProperty": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "default": "- No snapshot management settings",
+        "remarks": "A snapshot is expired when it exceeds MinSnapshotsToKeep and MaxSnapshotAgeHours.",
+        "stability": "experimental",
+        "summary": "Contains details about the snapshot management settings for an Iceberg table.",
+        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.SnapshotManagementProperty",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 196
+      },
+      "name": "SnapshotManagementProperty",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No maximum age",
+            "stability": "experimental",
+            "summary": "The maximum age of a snapshot before it can be expired."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 202
+          },
+          "name": "maxSnapshotAgeHours",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No minimum number",
+            "stability": "experimental",
+            "summary": "The minimum number of snapshots to keep."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 209
+          },
+          "name": "minSnapshotsToKeep",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Not specified",
+            "stability": "experimental",
+            "summary": "Indicates whether the SnapshotManagement maintenance action is enabled."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 216
+          },
+          "name": "status",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.Status"
+          }
+        }
+      ],
+      "symbolId": "lib/table:SnapshotManagementProperty"
+    },
+    "@aws-cdk/aws-s3tables-alpha.Status": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Status values for maintenance actions.",
+        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.Status",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 129
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Enable the maintenance action."
+          },
+          "name": "ENABLED"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Disable the maintenance action."
+          },
+          "name": "DISABLED"
+        }
+      ],
+      "name": "Status",
+      "symbolId": "lib/table:Status"
+    },
+    "@aws-cdk/aws-s3tables-alpha.Table": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "base": "aws-cdk-lib.Resource",
+      "docs": {
+        "stability": "experimental",
+        "summary": "An S3 Table with helpers.",
+        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.Table",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "lib/table.ts",
+          "line": 353
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
             "type": {
-              "fqn": "aws-cdk-lib.aws_iam.Grant"
+              "fqn": "@aws-cdk/aws-s3tables-alpha.TableProps"
             }
           }
-        },
+        ]
+      },
+      "interfaces": [
+        "@aws-cdk/aws-s3tables-alpha.ITable"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 240
+      },
+      "methods": [
         {
-          "abstract": true,
           "docs": {
-            "remarks": "If encryption is used, permission to use the key to encrypt/decrypt the contents\nof the bucket will also be granted to the same principal.",
             "stability": "experimental",
-            "summary": "Grant read and write permissions for this table bucket and its tables to an IAM principal (Role/Group/User)."
+            "summary": "Defines a Table construct that represents an external table."
           },
           "locationInModule": {
-            "filename": "lib/table-bucket.ts",
-            "line": 101
+            "filename": "lib/table.ts",
+            "line": 252
           },
-          "name": "grantReadWrite",
+          "name": "fromTableAttributes",
           "parameters": [
             {
               "docs": {
-                "summary": "The principal to allow read and write permissions to."
+                "summary": "The parent creating construct (usually `this`)."
               },
-              "name": "identity",
+              "name": "scope",
               "type": {
-                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+                "fqn": "constructs.Construct"
               }
             },
             {
               "docs": {
-                "summary": "Allow the permissions to all tables using '*' or to single table by its unique ID."
+                "summary": "The construct's name."
               },
-              "name": "tableId",
+              "name": "id",
               "type": {
                 "primitive": "string"
               }
+            },
+            {
+              "docs": {
+                "summary": "A `TableAttributes` object containing the table name and ARN."
+              },
+              "name": "attrs",
+              "type": {
+                "fqn": "@aws-cdk/aws-s3tables-alpha.TableAttributes"
+              }
             }
           ],
           "returns": {
             "type": {
-              "fqn": "aws-cdk-lib.aws_iam.Grant"
+              "fqn": "@aws-cdk/aws-s3tables-alpha.ITable"
             }
-          }
+          },
+          "static": true
         },
         {
-          "abstract": true,
           "docs": {
-            "remarks": "If encryption is used, permission to use the key to encrypt the contents\nof the bucket will also be granted to the same principal.",
+            "custom": {
+              "throws": "UnscopedValidationError if any naming errors are detected"
+            },
             "stability": "experimental",
-            "summary": "Grant write permissions for this table bucket and its tables to an IAM principal (Role/Group/User)."
+            "summary": "See https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-naming.html."
           },
           "locationInModule": {
-            "filename": "lib/table-bucket.ts",
-            "line": 89
+            "filename": "lib/table.ts",
+            "line": 284
           },
-          "name": "grantWrite",
+          "name": "validateTableName",
           "parameters": [
             {
               "docs": {
-                "summary": "The principal to allow write permissions to."
-              },
-              "name": "identity",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
-              }
-            },
-            {
-              "docs": {
-                "summary": "Allow the permissions to all tables using '*' or to single table by its unique ID."
+                "summary": "Name of the table."
               },
-              "name": "tableId",
+              "name": "tableName",
               "type": {
                 "primitive": "string"
               }
             }
           ],
-          "returns": {
-            "type": {
-              "fqn": "aws-cdk-lib.aws_iam.Grant"
-            }
-          }
+          "static": true
         }
       ],
-      "name": "ITableBucket",
+      "name": "Table",
       "properties": [
         {
-          "abstract": true,
+          "const": true,
           "docs": {
-            "custom": {
-              "attribute": "true"
-            },
             "stability": "experimental",
-            "summary": "The ARN of the table bucket."
+            "summary": "Uniquely identifies this class."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "lib/table-bucket.ts",
-            "line": 21
+            "filename": "lib/table.ts",
+            "line": 243
           },
-          "name": "tableBucketArn",
+          "name": "PROPERTY_INJECTION_ID",
+          "static": true,
           "type": {
             "primitive": "string"
           }
         },
         {
-          "abstract": true,
           "docs": {
-            "custom": {
-              "attribute": "true"
-            },
             "stability": "experimental",
-            "summary": "The name of the table bucket."
+            "summary": "The namespace containing this table."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "lib/table-bucket.ts",
-            "line": 27
+            "filename": "lib/table.ts",
+            "line": 351
           },
-          "name": "tableBucketName",
+          "name": "namespace",
           "type": {
-            "primitive": "string"
+            "fqn": "@aws-cdk/aws-s3tables-alpha.INamespace"
           }
         },
         {
-          "abstract": true,
           "docs": {
-            "custom": {
-              "attribute": "true"
-            },
             "stability": "experimental",
-            "summary": "The accountId containing the table bucket."
+            "summary": "The unique Amazon Resource Name (arn) of this table."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "lib/table-bucket.ts",
-            "line": 33
+            "filename": "lib/table.ts",
+            "line": 335
           },
-          "name": "account",
-          "optional": true,
+          "name": "tableArn",
+          "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
           "type": {
             "primitive": "string"
           }
         },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of this table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 346
+          },
+          "name": "tableName",
+          "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/table:Table"
+    },
+    "@aws-cdk/aws-s3tables-alpha.TableAttributes": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "remarks": "The tableName, region, and account can be provided explicitly\nor will be inferred from the tableArn",
+        "stability": "experimental",
+        "summary": "A reference to a table outside this stack.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as s3tables_alpha from '@aws-cdk/aws-s3tables-alpha';\nconst tableAttributes: s3tables_alpha.TableAttributes = {\n  tableArn: 'tableArn',\n  tableName: 'tableName',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.TableAttributes",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 225
+      },
+      "name": "TableAttributes",
+      "properties": [
         {
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Optional KMS encryption key associated with this table bucket."
+            "summary": "The table's ARN."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "lib/table-bucket.ts",
-            "line": 44
+            "filename": "lib/table.ts",
+            "line": 234
           },
-          "name": "encryptionKey",
-          "optional": true,
+          "name": "tableArn",
           "type": {
-            "fqn": "aws-cdk-lib.aws_kms.IKey"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "custom": {
-              "attribute": "true"
-            },
             "stability": "experimental",
-            "summary": "The region containing the table bucket."
+            "summary": "Name of this table."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "lib/table-bucket.ts",
-            "line": 39
+            "filename": "lib/table.ts",
+            "line": 229
           },
-          "name": "region",
-          "optional": true,
+          "name": "tableName",
           "type": {
             "primitive": "string"
           }
         }
       ],
-      "symbolId": "lib/table-bucket:ITableBucket"
+      "symbolId": "lib/table:TableAttributes"
     },
     "@aws-cdk/aws-s3tables-alpha.TableBucket": {
       "assembly": "@aws-cdk/aws-s3tables-alpha",
@@ -5230,6 +6277,169 @@
       ],
       "symbolId": "lib/table-bucket:TableBucketProps"
     },
+    "@aws-cdk/aws-s3tables-alpha.TableProps": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Properties for creating a new S3 Table.",
+        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.TableProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/table.ts",
+        "line": 55
+      },
+      "name": "TableProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The namespace under which this table is created."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 63
+          },
+          "name": "namespace",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.INamespace"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Currently, the only supported value is OpenTableFormat.ICEBERG.",
+            "stability": "experimental",
+            "summary": "Format of this table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 67
+          },
+          "name": "openTableFormat",
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.OpenTableFormat"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Name of this table, unique within the namespace."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 59
+          },
+          "name": "tableName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "Amazon S3 selects the best compaction strategy based on your table sort order.",
+            "see": "https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html",
+            "stability": "experimental",
+            "summary": "Settings governing the Compaction maintenance action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 73
+          },
+          "name": "compaction",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.CompactionProperty"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "table is created without any metadata",
+            "stability": "experimental",
+            "summary": "Contains details about the metadata for an Iceberg table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 78
+          },
+          "name": "icebergMetadata",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.IcebergMetadataProperty"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "RETAIN",
+            "stability": "experimental",
+            "summary": "Controls what happens to this table it it stoped being managed by cloudformation."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 89
+          },
+          "name": "removalPolicy",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.RemovalPolicy"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "enabled: MinimumSnapshots is 1 by default and MaximumSnapshotAge is 120 hours by default.",
+            "stability": "experimental",
+            "summary": "Contains details about the snapshot management settings for an Iceberg table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 83
+          },
+          "name": "snapshotManagement",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.SnapshotManagementProperty"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "This property is mutually exclusive to 'IcebergMetadata'.",
+            "stability": "experimental",
+            "summary": "If true, indicates that you don't want to specify a schema for the table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 97
+          },
+          "name": "withoutMetadata",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "lib/table:TableProps"
+    },
     "@aws-cdk/aws-s3tables-alpha.UnreferencedFileRemoval": {
       "assembly": "@aws-cdk/aws-s3tables-alpha",
       "datatype": true,
@@ -5348,6 +6558,6 @@
       "symbolId": "lib/table-bucket:UnreferencedFileRemovalStatus"
     }
   },
-  "version": "2.207.0-alpha.0",
+  "version": "2.209.0-alpha.0",
   "fingerprint": "**********"
 }