@btc-embedded/cdk-extensions 0.22.2 → 0.22.3

package/.jsii

@@ -8494,7 +8494,7 @@
   },
   "name": "@btc-embedded/cdk-extensions",
   "readme": {
-    "markdown": "# @btc-embedded/cdk-extensions\n\nA collection of reusable AWS CDK (Cloud Development Kit) extensions and constructs for building cloud infrastructure with TypeScript.\n\n## Features\n\n- **CDK Constructs**: Includes ready-to-use constructs for API Gateway, Application Load Balancer, Cognito, VPC, DocumentDB, and more.\n- **ECS Service Extensions**: Provides ECS service extensions for advanced container orchestration.\n- **Utilities**: Common utilities and helpers for stack parameters, value imports, and configuration parsing.\n- **Modular Extensions**: Easily extend AWS resources with features like logging, OpenTelemetry, EFS, Cloud Map, and custom containers.\n\n## Installation\n\n```sh\nyarn install @btc-embedded/cdk-extensions\n```\n\n## Usage Example\n\n### Basic Usage\n\n```typescript\nimport { ApiGateway } from \"@btc-embedded/cdk-extensions\";\n\n// Use constructs and extensions in your CDK app\n```\n\n### Using ApplicationStack for Simplified Configuration\n\nFor application-level stacks that reference a base platform stack, use `ApplicationStack` to ensure consistent use of the base platform stack name:\n\n```typescript\nimport { ApplicationStack } from \"@btc-embedded/cdk-extensions\";\n\nexport class MyAppStack extends ApplicationStack {\n  constructor(scope: Construct, id: string) {\n    super(scope, id, {\n      basePlatformStackName: 'my-platform-stack',\n      env: {\n        account: '123456789012',\n        region: 'eu-central-1',\n      },\n    });\n\n    // Constructs and extensions automatically resolve the platform stack name\n    // No need to pass basePlatformStackName repeatedly\n  }\n}\n```\n\n### Config-Driven Deployments\n\nUse `createApplicationApp` for configuration-driven deployments:\n\n```typescript\nimport { createApplicationApp, ApplicationStack } from '@btc-embedded/cdk-extensions';\nimport { z } from 'zod';\n\nconst configSchema = z.object({\n  env: z.object({ account: z.string(), region: z.string() }),\n  basePlatformStackName: z.string(),\n});\n\ncreateApplicationApp({\n  directory: './config',\n  schema: configSchema,\n  createStack: (scope, config) => new MyAppStack(scope, 'MyApp', config),\n});\n```\n\n## Documentation\n\n- [API Reference](./API.md)\n\n## License\n\nApache-2.0 © BTC Embedded Systems AG\n"
+    "markdown": "# BTC Embedded CDK Extensions\n# @btc-embedded/cdk-extensions\n\nA collection of reusable AWS CDK (Cloud Development Kit) extensions and constructs for building cloud infrastructure with TypeScript.\n\n## Features\n\n- **CDK Constructs**: Includes ready-to-use constructs for API Gateway, Application Load Balancer, Cognito, VPC, DocumentDB, and more.\n- **ECS Service Extensions**: Provides ECS service extensions for advanced container orchestration.\n- **Utilities**: Common utilities and helpers for stack parameters, value imports, and configuration parsing.\n- **Modular Extensions**: Easily extend AWS resources with features like logging, OpenTelemetry, EFS, Cloud Map, and custom containers.\n\n## Installation\n\n```sh\nyarn install @btc-embedded/cdk-extensions\n```\n\n## Usage Example\n\n### Basic Usage\n\n```typescript\nimport { ApiGateway } from \"@btc-embedded/cdk-extensions\";\n\n// Use constructs and extensions in your CDK app\n```\n\n### Using ApplicationStack for Simplified Configuration\n\nFor application-level stacks that reference a base platform stack, use `ApplicationStack` to ensure consistent use of the base platform stack name:\n\n```typescript\nimport { ApplicationStack } from \"@btc-embedded/cdk-extensions\";\n\nexport class MyAppStack extends ApplicationStack {\n  constructor(scope: Construct, id: string) {\n    super(scope, id, {\n      basePlatformStackName: 'my-platform-stack',\n      env: {\n        account: '123456789012',\n        region: 'eu-central-1',\n      },\n    });\n\n    // Constructs and extensions automatically resolve the platform stack name\n    // No need to pass basePlatformStackName repeatedly\n  }\n}\n```\n\n### Config-Driven Deployments\n\nUse `createApplicationApp` for configuration-driven deployments:\n\n```typescript\nimport { createApplicationApp, ApplicationStack } from '@btc-embedded/cdk-extensions';\nimport { z } from 'zod';\n\nconst configSchema = z.object({\n  env: z.object({ account: z.string(), region: z.string() }),\n  basePlatformStackName: z.string(),\n});\n\ncreateApplicationApp({\n  directory: './config',\n  schema: configSchema,\n  createStack: (scope, config) => new MyAppStack(scope, 'MyApp', config),\n});\n```\n\n## Documentation\n\n- [API Reference](./API.md)\n\n## License\n\nApache-2.0 © BTC Embedded Systems AG\n\n"
   },
   "repository": {
     "type": "git",
@@ -8527,7 +8527,7 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "constructs.Construct",
       "docs": {
-        "deprecated": "Use the {@link ApiGatewayV2 } construct instead.",
+        "deprecated": "Use the ApiGatewayVpcLink construct instead.",
         "remarks": "This API Gateway construct sets up an API Gateway V2 and a default HTTP API\nprotected by the provided Cognito user pool and client(s). The construct\nregisters an A record for the subdomain in the provided hosted zone. It also\ncreates a VPC Link (and security group) for the API Gateway to connect to\nservices in the VPC.\n\nThe relevant parameters are exposed as CloudFormation outputs so that they\ncan be used by the CDK extensions provided in this library.",
         "stability": "deprecated",
         "summary": "API Gateway construct to be used in base platforms."
@@ -9493,7 +9493,7 @@
         },
         "locationInModule": {
           "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-          "line": 55
+          "line": 49
         },
         "parameters": [
           {
@@ -9528,7 +9528,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-        "line": 44
+        "line": 38
       },
       "methods": [
         {
@@ -9538,7 +9538,7 @@
           },
           "locationInModule": {
             "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-            "line": 102
+            "line": 96
           },
           "name": "allowConnection",
           "parameters": [
@@ -9564,7 +9564,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-            "line": 79
+            "line": 73
           },
           "name": "baseUrl",
           "type": {
@@ -9580,7 +9580,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-            "line": 94
+            "line": 88
           },
           "name": "keyManagementPath",
           "type": {
@@ -9595,7 +9595,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-            "line": 86
+            "line": 80
           },
           "name": "keysManagementPath",
           "type": {
@@ -9616,7 +9616,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-        "line": 29
+        "line": 28
       },
       "name": "ApiKeyManagementProps",
       "properties": [
@@ -9629,28 +9629,12 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-            "line": 38
+            "line": 32
           },
           "name": "apiKeys",
           "type": {
             "fqn": "@btc-embedded/cdk-extensions.ApiKeyStore"
           }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "experimental",
-            "summary": "The user pool to be used."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/constructs/api-keys/ApiKeyManagement.ts",
-            "line": 33
-          },
-          "name": "userPool",
-          "type": {
-            "fqn": "aws-cdk-lib.aws_cognito.IUserPool"
-          }
         }
       ],
       "symbolId": "src/constructs/api-keys/ApiKeyManagement:ApiKeyManagementProps"
@@ -10386,25 +10370,28 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Properties for the ApplicationLoadBalancerExtensionV2."
       },
       "fqn": "@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionPropsV2",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-        "line": 12
+        "line": 15
       },
       "name": "ApplicationLoadBalancerExtensionPropsV2",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "Either this or `loadBalancer` must be provided.",
+            "stability": "experimental",
+            "summary": "The name of the platform stack to use for the load balancer."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-            "line": 13
+            "line": 20
           },
           "name": "basePlatformStackName",
           "optional": true,
@@ -10415,12 +10402,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "Either this or `platformStackName` must be provided.",
+            "stability": "experimental",
+            "summary": "The Application Load Balancer to use."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-            "line": 14
+            "line": 26
           },
           "name": "loadBalancer",
           "optional": true,
@@ -10435,19 +10424,27 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "A service extension that adds an Application Load Balancer to an ECS service."
       },
       "fqn": "@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionV2",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "custom": {
+            "throws": "Error if neither platformStackName nor loadBalancer is provided."
+          },
+          "stability": "experimental",
+          "summary": "Creates a new ApplicationLoadBalancerExtensionV2."
         },
         "locationInModule": {
           "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-          "line": 20
+          "line": 40
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The properties for configuring the load balancer extension."
+            },
             "name": "props",
             "type": {
               "fqn": "@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionPropsV2"
@@ -10458,7 +10455,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-        "line": 17
+        "line": 32
       },
       "methods": [
         {
@@ -10468,7 +10465,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-            "line": 36
+            "line": 56
           },
           "name": "modifyServiceProps",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -10493,7 +10490,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-            "line": 32
+            "line": 52
           },
           "name": "prehook",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -10520,7 +10517,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-            "line": 43
+            "line": 63
           },
           "name": "useService",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -12869,16 +12866,19 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "experimental"
+        "remarks": "Cross-stack access is supported via {@link fromBasePlatform}, which imports:\n- the MongoDB connection URL secret ARN\n- the DocumentDB security group ID",
+        "stability": "experimental",
+        "summary": "Platform component that provisions an Amazon DocumentDB cluster and exports the required outputs for application stacks."
       },
       "fqn": "@btc-embedded/cdk-extensions.DocumentDB",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "experimental",
+          "summary": "Creates a new Amazon DocumentDB cluster and exports the necessary output parameters to allow application stacks to reference it."
         },
         "locationInModule": {
           "filename": "src/platform/DocumentDB.ts",
-          "line": 76
+          "line": 116
         },
         "parameters": [
           {
@@ -12904,32 +12904,42 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/platform/DocumentDB.ts",
-        "line": 40
+        "line": 69
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Imports a {@link IDocumentDB} instance from a base platform stack."
           },
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 41
+            "line": 77
           },
           "name": "fromBasePlatform",
           "parameters": [
             {
+              "docs": {
+                "summary": "Construct scope to attach the imported component to."
+              },
               "name": "scope",
               "type": {
                 "fqn": "constructs.Construct"
               }
             },
             {
+              "docs": {
+                "summary": "Construct id for the imported component."
+              },
               "name": "id",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "Base platform stack name used to import stack parameters."
+              },
               "name": "name",
               "optional": true,
               "type": {
@@ -12993,7 +13003,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/platform/DocumentDB.ts",
-        "line": 31
+        "line": 52
       },
       "methods": [
         {
@@ -13002,7 +13012,7 @@
           },
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 35
+            "line": 56
           },
           "name": "allowAccess",
           "overrides": "@btc-embedded/cdk-extensions.IDocumentDB",
@@ -13026,7 +13036,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 32
+            "line": 53
           },
           "name": "secret",
           "overrides": "@btc-embedded/cdk-extensions.IDocumentDB",
@@ -13042,7 +13052,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 33
+            "line": 54
           },
           "name": "securityGroup",
           "overrides": "@btc-embedded/cdk-extensions.IDocumentDB",
@@ -13057,25 +13067,27 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Properties for {@link DocumentDB}."
       },
       "fqn": "@btc-embedded/cdk-extensions.DocumentDBProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/platform/DocumentDB.ts",
-        "line": 17
+        "line": 20
       },
       "name": "DocumentDBProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Name of the Secrets Manager secret that stores the DocumentDB master credentials."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 20
+            "line": 33
           },
           "name": "secretName",
           "type": {
@@ -13085,12 +13097,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "Note: This value is currently not referenced directly by the implementation,\nbut is kept as part of the public contract.",
+            "stability": "experimental",
+            "summary": "Name of the stack this database belongs to."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 18
+            "line": 27
           },
           "name": "stackName",
           "type": {
@@ -13100,12 +13114,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Master username for the DocumentDB cluster."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 19
+            "line": 30
           },
           "name": "username",
           "type": {
@@ -13115,12 +13130,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "VPC to deploy the DocumentDB cluster into."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 21
+            "line": 36
           },
           "name": "vpc",
           "type": {
@@ -13134,7 +13150,9 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
       "docs": {
-        "stability": "experimental"
+        "remarks": "At synth-time, this extension:\n- imports the base platform DocumentDB via {@link DocumentDB.fromBasePlatform}\n- injects a `MONGODB_URL` secret into selected containers\n- optionally adds environment defaults needed by the application runtime\n- grants network/IAM access for the ECS service via `documentDb.allowAccess(...)`",
+        "stability": "experimental",
+        "summary": "ECS Service Extension that grants a service access to a shared Amazon DocumentDB instance defined in the base platform stack."
       },
       "fqn": "@btc-embedded/cdk-extensions.DocumentDbAccessExtension",
       "initializer": {
@@ -13143,7 +13161,7 @@
         },
         "locationInModule": {
           "filename": "src/extensions/DocumentDbAccessExtension.ts",
-          "line": 44
+          "line": 69
         },
         "parameters": [
           {
@@ -13157,7 +13175,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/extensions/DocumentDbAccessExtension.ts",
-        "line": 39
+        "line": 64
       },
       "methods": [
         {
@@ -13167,7 +13185,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 59
+            "line": 84
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
@@ -13179,7 +13197,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 49
+            "line": 74
           },
           "name": "prehook",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -13206,7 +13224,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 67
+            "line": 92
           },
           "name": "useService",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -13238,7 +13256,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 40
+            "line": 65
           },
           "name": "props",
           "type": {
@@ -13251,7 +13269,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 42
+            "line": 67
           },
           "name": "documentDb",
           "type": {
@@ -13265,25 +13283,28 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Configuration for {@link DocumentDbAccessExtension}."
       },
       "fqn": "@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/DocumentDbAccessExtension.ts",
-        "line": 12
+        "line": 15
       },
       "name": "DocumentDbAccessExtensionProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "Note: This property is currently not referenced directly by this extension's\nimplementation, but is kept as part of the public contract.",
+            "stability": "experimental",
+            "summary": "ID of the security group associated with the database access path."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 14
+            "line": 29
           },
           "name": "securityGroupId",
           "type": {
@@ -13293,12 +13314,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "This is passed to {@link DocumentDB.fromBasePlatform}.",
+            "stability": "experimental",
+            "summary": "Name of the base platform stack to import the shared DocumentDB instance from."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 13
+            "line": 21
           },
           "name": "basePlatformStackName",
           "optional": true,
@@ -13313,7 +13336,9 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
       "docs": {
-        "stability": "experimental"
+        "remarks": "It supports two complementary capabilities:\n- **Subscribe**: create/attach an SQS queue and subscribe it to one or more SNS topics\n- **Publish**: inject SNS topic metadata into the task so the service can publish events\n\nInternally it composes the ECS Service Extensions `QueueExtension` and `InjecterExtension`.",
+        "stability": "experimental",
+        "summary": "ECS Service Extension that wires domain-event messaging via SNS + SQS."
       },
       "fqn": "@btc-embedded/cdk-extensions.DomainEventMessagingExtension",
       "initializer": {
@@ -13322,7 +13347,7 @@
         },
         "locationInModule": {
           "filename": "src/extensions/DomainEventMessagingExtension.ts",
-          "line": 36
+          "line": 58
         },
         "parameters": [
           {
@@ -13337,7 +13362,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/extensions/DomainEventMessagingExtension.ts",
-        "line": 28
+        "line": 45
       },
       "methods": [
         {
@@ -13347,7 +13372,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 75
+            "line": 97
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
@@ -13359,7 +13384,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 41
+            "line": 63
           },
           "name": "prehook",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -13384,7 +13409,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 90
+            "line": 112
           },
           "name": "publish",
           "parameters": [
@@ -13402,7 +13427,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 85
+            "line": 107
           },
           "name": "subscribe",
           "parameters": [
@@ -13422,7 +13447,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 94
+            "line": 116
           },
           "name": "useService",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -13451,7 +13476,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 80
+            "line": 102
           },
           "name": "useTaskDefinition",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -13473,7 +13498,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 29
+            "line": 46
           },
           "name": "props",
           "type": {
@@ -13486,7 +13511,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 34
+            "line": 56
           },
           "name": "publishEvents",
           "type": {
@@ -13504,7 +13529,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 33
+            "line": 54
           },
           "name": "subscribeEvents",
           "type": {
@@ -13522,7 +13547,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 32
+            "line": 52
           },
           "name": "injecterExtension",
           "optional": true,
@@ -13536,7 +13561,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 30
+            "line": 48
           },
           "name": "queue",
           "optional": true,
@@ -13550,7 +13575,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 31
+            "line": 50
           },
           "name": "queueExtension",
           "optional": true,
@@ -14411,13 +14436,14 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Optional overrides for the environment variable names injected into application containers."
       },
       "fqn": "@btc-embedded/cdk-extensions.EnvironmentVariableNames",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/PostgresDbAccessExtension.ts",
-        "line": 16
+        "line": 20
       },
       "name": "EnvironmentVariableNames",
       "properties": [
@@ -14426,12 +14452,12 @@
           "docs": {
             "default": "DATABASE_URL",
             "stability": "experimental",
-            "summary": "Environment variable for the connction string."
+            "summary": "Environment variable for the connection string."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 22
+            "line": 26
           },
           "name": "databaseUrl",
           "optional": true,
@@ -14449,7 +14475,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 36
+            "line": 40
           },
           "name": "postgresDatabase",
           "optional": true,
@@ -14467,7 +14493,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 29
+            "line": 33
           },
           "name": "postgresEndpoint",
           "optional": true,
@@ -14485,7 +14511,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 50
+            "line": 54
           },
           "name": "postgresPassword",
           "optional": true,
@@ -14503,7 +14529,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 43
+            "line": 47
           },
           "name": "postgresUsername",
           "optional": true,
@@ -14518,25 +14544,28 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Configuration for {@link DomainEventMessagingExtension}."
       },
       "fqn": "@btc-embedded/cdk-extensions.EventListenerExtensionProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/DomainEventMessagingExtension.ts",
-        "line": 24
+        "line": 27
       },
       "name": "EventListenerExtensionProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "If omitted, the extension creates a new queue and a dead-letter queue.",
+            "stability": "experimental",
+            "summary": "Optional SQS queue to use for inbound domain events."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/DomainEventMessagingExtension.ts",
-            "line": 25
+            "line": 33
           },
           "name": "queue",
           "optional": true,
@@ -14743,25 +14772,27 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Option to use an already created CloudWatch Log Group for container logging."
       },
       "fqn": "@btc-embedded/cdk-extensions.ExistingLogroupOption",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/LogExtension.ts",
-        "line": 12
+        "line": 15
       },
       "name": "ExistingLogroupOption",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Target CloudWatch log group for container stdout/stderr."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/LogExtension.ts",
-            "line": 13
+            "line": 17
           },
           "name": "logGroup",
           "type": {
@@ -16150,13 +16181,15 @@
     "@btc-embedded/cdk-extensions.IDocumentDB": {
       "assembly": "@btc-embedded/cdk-extensions",
       "docs": {
-        "stability": "experimental"
+        "remarks": "The component exposes the connection secret and security group so application stacks\ncan wire services to it while keeping the underlying implementation hidden.",
+        "stability": "experimental",
+        "summary": "Public interface for a DocumentDB component."
       },
       "fqn": "@btc-embedded/cdk-extensions.IDocumentDB",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/platform/DocumentDB.ts",
-        "line": 24
+        "line": 45
       },
       "methods": [
         {
@@ -16166,7 +16199,7 @@
           },
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 28
+            "line": 49
           },
           "name": "allowAccess",
           "parameters": [
@@ -16189,7 +16222,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 25
+            "line": 46
           },
           "name": "secret",
           "type": {
@@ -16204,7 +16237,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/DocumentDB.ts",
-            "line": 26
+            "line": 47
           },
           "name": "securityGroup",
           "type": {
@@ -16469,13 +16502,14 @@
     "@btc-embedded/cdk-extensions.IPrivateDnsNamespace": {
       "assembly": "@btc-embedded/cdk-extensions",
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Public interface for the private DNS namespace platform component."
       },
       "fqn": "@btc-embedded/cdk-extensions.IPrivateDnsNamespace",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/platform/PrivateDnsNamespace.ts",
-        "line": 21
+        "line": 46
       },
       "name": "IPrivateDnsNamespace",
       "properties": [
@@ -16487,7 +16521,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 22
+            "line": 47
           },
           "name": "namespace",
           "type": {
@@ -16578,25 +16612,27 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Option to import the shared base platform log group."
       },
       "fqn": "@btc-embedded/cdk-extensions.ImportLogGroupOption",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/LogExtension.ts",
-        "line": 15
+        "line": 23
       },
       "name": "ImportLogGroupOption",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Base platform stack name used to import the log group via {@link BTCLogGroup.fromBasePlatform}."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/LogExtension.ts",
-            "line": 16
+            "line": 25
           },
           "name": "basePlatformStackName",
           "optional": true,
@@ -16661,16 +16697,19 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
       "docs": {
-        "stability": "experimental"
+        "remarks": "You can either:\n- pass an existing log group ({@link ExistingLogroupOption}), or\n- import a shared base platform log group ({@link ImportLogGroupOption}).",
+        "stability": "experimental",
+        "summary": "ECS Service Extension that configures CloudWatch Logs for all containers in a service."
       },
       "fqn": "@btc-embedded/cdk-extensions.LogExtension",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "experimental",
+          "summary": "Creates a new {@link LogExtension}."
         },
         "locationInModule": {
           "filename": "src/extensions/LogExtension.ts",
-          "line": 42
+          "line": 69
         },
         "parameters": [
           {
@@ -16693,7 +16732,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/extensions/LogExtension.ts",
-        "line": 40
+        "line": 63
       },
       "methods": [
         {
@@ -16703,7 +16742,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/LogExtension.ts",
-            "line": 61
+            "line": 88
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
@@ -16715,7 +16754,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/LogExtension.ts",
-            "line": 46
+            "line": 73
           },
           "name": "prehook",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -16929,7 +16968,9 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
       "docs": {
-        "stability": "experimental"
+        "remarks": "This extension injects the following into the main application container:\n- `OIDC_ISSUER_URL`\n- `OIDC_CLIENT_ID`\n- `OIDC_SCOPE`\n- `OIDC_CLIENT_SECRET` (as a Secrets Manager secret)\n- `OIDC_REDIRECT_URI` (optional)",
+        "stability": "experimental",
+        "summary": "ECS service extension that wires the service to OpenID Connect settings from the base platform's Cognito user pool."
       },
       "fqn": "@btc-embedded/cdk-extensions.OpenIdExtension",
       "initializer": {
@@ -16938,7 +16979,7 @@
         },
         "locationInModule": {
           "filename": "src/extensions/OpenIdExtension.ts",
-          "line": 66
+          "line": 110
         },
         "parameters": [
           {
@@ -16952,29 +16993,31 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/extensions/OpenIdExtension.ts",
-        "line": 61
+        "line": 100
       },
       "methods": [
         {
           "docs": {
+            "remarks": "Requires a main container named `service-container` with a configured\ntraffic port.",
             "stability": "experimental",
-            "summary": "A hook that allows the extension to add hooks to other extensions that are registered."
+            "summary": "Registers container hooks after the parent service and user pool are known."
           },
           "locationInModule": {
             "filename": "src/extensions/OpenIdExtension.ts",
-            "line": 71
+            "line": 121
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
         },
         {
           "docs": {
+            "remarks": "Called by the extensions framework before hooks are applied.",
             "stability": "experimental",
-            "summary": "A hook that is called for each extension ahead of time to allow for any initial setup, such as creating resources in advance."
+            "summary": "Resolves base-platform resources needed by the extension."
           },
           "locationInModule": {
             "filename": "src/extensions/OpenIdExtension.ts",
-            "line": 87
+            "line": 142
           },
           "name": "prehook",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -16998,11 +17041,13 @@
       "properties": [
         {
           "docs": {
-            "stability": "experimental"
+            "remarks": "Populated during {@link prehook}.",
+            "stability": "experimental",
+            "summary": "Resolved Cognito user pool from the base platform."
           },
           "locationInModule": {
             "filename": "src/extensions/OpenIdExtension.ts",
-            "line": 64
+            "line": 108
           },
           "name": "cognitoUserPool",
           "type": {
@@ -17022,7 +17067,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/OpenIdExtension.ts",
-        "line": 49
+        "line": 77
       },
       "name": "OpenIdExtensionProps",
       "properties": [
@@ -17035,7 +17080,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/OpenIdExtension.ts",
-            "line": 53
+            "line": 81
           },
           "name": "basePlatformStackName",
           "optional": true,
@@ -17052,7 +17097,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/OpenIdExtension.ts",
-            "line": 58
+            "line": 86
           },
           "name": "redirectUri",
           "optional": true,
@@ -17241,7 +17286,9 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
       "docs": {
-        "stability": "experimental"
+        "remarks": "What it does:\n- Imports DB endpoint, secrets and security group IDs from the base platform stack outputs.\n- Allows the service SG to connect to the DB SG on port 5432.\n- Injects connection details into selected containers via container hooks.\n- Optionally adds a one-shot migration container and wires dependencies so the\n  main container starts only after migrations succeed.",
+        "stability": "experimental",
+        "summary": "ECS service extension that grants an ECS service access to an Aurora Postgres database created by the base platform."
       },
       "fqn": "@btc-embedded/cdk-extensions.PostgresDbAccessExtension",
       "initializer": {
@@ -17250,7 +17297,7 @@
         },
         "locationInModule": {
           "filename": "src/extensions/PostgresDbAccessExtension.ts",
-          "line": 170
+          "line": 200
         },
         "parameters": [
           {
@@ -17264,17 +17311,18 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/extensions/PostgresDbAccessExtension.ts",
-        "line": 164
+        "line": 188
       },
       "methods": [
         {
           "docs": {
+            "remarks": "If `enableMigration` is true, also applies the hook to the migration\ncontainer (created later in {@link useTaskDefinition}).",
             "stability": "experimental",
-            "summary": "A hook that allows the extension to add hooks to other extensions that are registered."
+            "summary": "Applies the Postgres env/secrets hook to database-access containers."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 234
+            "line": 274
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
@@ -17282,11 +17330,11 @@
         {
           "docs": {
             "stability": "experimental",
-            "summary": "Prior to launching the task definition as a service, this hook is called on each extension to give it a chance to mutate the properties of the service to be created."
+            "summary": "When migrations are enabled, ensures the default container depends on the migration container completing successfully."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 315
+            "line": 370
           },
           "name": "modifyServiceProps",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -17307,11 +17355,11 @@
         {
           "docs": {
             "stability": "experimental",
-            "summary": "A hook that is called for each extension ahead of time to allow for any initial setup, such as creating resources in advance."
+            "summary": "Resolves base-platform outputs (endpoint, secret ARNs) and prepares a service-specific connection-string secret."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 175
+            "line": 209
           },
           "name": "prehook",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -17332,13 +17380,12 @@
         },
         {
           "docs": {
-            "remarks": "It is generally used to\ncreate any final resources which might depend on the service itself.",
             "stability": "experimental",
-            "summary": "When this hook is implemented by extension, it allows the extension to use the service which has been created."
+            "summary": "Grants the ECS service security group ingress to the database security group on TCP 5432."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 250
+            "line": 294
           },
           "name": "useService",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -17362,12 +17409,13 @@
         },
         {
           "docs": {
+            "remarks": "The migration container uses the same image repo/tag as the default\ncontainer, but runs with `command: [migrationParameter]`.",
             "stability": "experimental",
-            "summary": "Once the task definition is created, this hook is called for each extension to give it a chance to add containers to the task definition, change the task definition's role to add permissions, etc."
+            "summary": "Optionally adds a non-essential migration container that runs before the default container."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 268
+            "line": 319
           },
           "name": "useTaskDefinition",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -17390,7 +17438,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 165
+            "line": 189
           },
           "name": "props",
           "type": {
@@ -17399,11 +17447,12 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Connection-string secret created for this service (populated in {@link prehook})."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 166
+            "line": 192
           },
           "name": "connectionString",
           "type": {
@@ -17412,11 +17461,12 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Credentials secret imported from base platform (populated in {@link prehook})."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 167
+            "line": 195
           },
           "name": "credentialsSecret",
           "type": {
@@ -17425,11 +17475,12 @@
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Database endpoint imported from base platform (populated in {@link prehook})."
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 168
+            "line": 198
           },
           "name": "endpoint",
           "type": {
@@ -17449,7 +17500,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/PostgresDbAccessExtension.ts",
-        "line": 53
+        "line": 57
       },
       "name": "PostgresDbAccessExtensionProps",
       "properties": [
@@ -17462,7 +17513,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 63
+            "line": 67
           },
           "name": "dbName",
           "type": {
@@ -17479,7 +17530,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 58
+            "line": 62
           },
           "name": "basePlatformStackName",
           "optional": true,
@@ -17497,7 +17548,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 80
+            "line": 84
           },
           "name": "dbConnectionProperties",
           "optional": true,
@@ -17521,7 +17572,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 96
+            "line": 100
           },
           "name": "enableMigration",
           "optional": true,
@@ -17539,7 +17590,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 87
+            "line": 91
           },
           "name": "environmentVariableNames",
           "optional": true,
@@ -17558,7 +17609,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 72
+            "line": 76
           },
           "name": "logGroup",
           "optional": true,
@@ -17576,7 +17627,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 103
+            "line": 107
           },
           "name": "migrationParameter",
           "optional": true,
@@ -17591,25 +17642,27 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Attributes describing an already existing (predefined) Cloud Map private DNS namespace."
       },
       "fqn": "@btc-embedded/cdk-extensions.PredefinedPrivateDnsNamespaceProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/platform/PrivateDnsNamespace.ts",
-        "line": 9
+        "line": 12
       },
       "name": "PredefinedPrivateDnsNamespaceProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Namespace ARN."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 10
+            "line": 14
           },
           "name": "arn",
           "type": {
@@ -17619,12 +17672,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Namespace ID."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 11
+            "line": 16
           },
           "name": "id",
           "type": {
@@ -17634,12 +17688,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Namespace name (e.g. `services.internal`)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 12
+            "line": 18
           },
           "name": "namespace",
           "type": {
@@ -17695,16 +17750,19 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "experimental"
+        "remarks": "The namespace can either be created by this construct (via {@link PrivateDnsNamespaceProps.namespaceName})\nor referenced from an existing namespace (via {@link PrivateDnsNamespaceProps.definedPrivateDnsNamespace}).\n\nFor cross-stack usage, the construct exports namespace attributes as stack parameters and\ncan be imported from application stacks using {@link fromBasePlatform}.",
+        "stability": "experimental",
+        "summary": "Platform component that provides a Cloud Map private DNS namespace for service discovery."
       },
       "fqn": "@btc-embedded/cdk-extensions.PrivateDnsNamespace",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "experimental",
+          "summary": "Creates a new private DNS namespace or references an existing one, and exports its attributes for cross-stack consumption."
         },
         "locationInModule": {
           "filename": "src/platform/PrivateDnsNamespace.ts",
-          "line": 78
+          "line": 123
         },
         "parameters": [
           {
@@ -17733,32 +17791,42 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/platform/PrivateDnsNamespace.ts",
-        "line": 25
+        "line": 59
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Imports a {@link IPrivateDnsNamespace} instance from a base platform stack."
           },
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 29
+            "line": 70
           },
           "name": "fromBasePlatform",
           "parameters": [
             {
+              "docs": {
+                "summary": "Construct scope to attach the imported component to."
+              },
               "name": "scope",
               "type": {
                 "fqn": "constructs.Construct"
               }
             },
             {
+              "docs": {
+                "summary": "Construct id for the imported component."
+              },
               "name": "id",
               "type": {
                 "primitive": "string"
               }
             },
             {
+              "docs": {
+                "summary": "Base platform stack name used to import stack parameters."
+              },
               "name": "stackName",
               "optional": true,
               "type": {
@@ -17783,7 +17851,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 76
+            "line": 117
           },
           "name": "namespace",
           "overrides": "@btc-embedded/cdk-extensions.IPrivateDnsNamespace",
@@ -17798,25 +17866,27 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Properties for {@link PrivateDnsNamespace}."
       },
       "fqn": "@btc-embedded/cdk-extensions.PrivateDnsNamespaceProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/platform/PrivateDnsNamespace.ts",
-        "line": 15
+        "line": 24
       },
       "name": "PrivateDnsNamespaceProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "VPC in which the private DNS namespace is created/associated."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 18
+            "line": 40
           },
           "name": "vpc",
           "type": {
@@ -17826,12 +17896,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "If set, {@link namespaceName} is ignored.",
+            "stability": "experimental",
+            "summary": "Reuse an existing namespace by providing its attributes."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 16
+            "line": 30
           },
           "name": "definedPrivateDnsNamespace",
           "optional": true,
@@ -17842,12 +17914,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "Required when {@link definedPrivateDnsNamespace} is not provided.",
+            "stability": "experimental",
+            "summary": "Name for a new private DNS namespace to be created."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 17
+            "line": 37
           },
           "name": "namespaceName",
           "optional": true,
@@ -18976,7 +19050,9 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
       "docs": {
-        "stability": "experimental"
+        "remarks": "If no props are provided, defaults are applied:\n- `time`: 200\n- `interval`: 200\n- `probes`: 5",
+        "stability": "experimental",
+        "summary": "ECS service extension that configures Linux TCP keepalive settings for the service's containers."
       },
       "fqn": "@btc-embedded/cdk-extensions.TcpKeepAliveExtension",
       "initializer": {
@@ -18985,7 +19061,7 @@
         },
         "locationInModule": {
           "filename": "src/extensions/TcpKeepAliveExtension.ts",
-          "line": 45
+          "line": 83
         },
         "parameters": [
           {
@@ -19000,17 +19076,17 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/extensions/TcpKeepAliveExtension.ts",
-        "line": 42
+        "line": 80
       },
       "methods": [
         {
           "docs": {
             "stability": "experimental",
-            "summary": "A hook that allows the extension to add hooks to other extensions that are registered."
+            "summary": "Registers a container mutating hook that sets TCP keepalive sysctls."
           },
           "locationInModule": {
             "filename": "src/extensions/TcpKeepAliveExtension.ts",
-            "line": 59
+            "line": 100
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
@@ -19025,7 +19101,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/TcpKeepAliveExtension.ts",
-            "line": 43
+            "line": 81
           },
           "name": "props",
           "type": {
@@ -19039,25 +19115,28 @@
       "assembly": "@btc-embedded/cdk-extensions",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "remarks": "Values map to the following kernel parameters:\n- `net.ipv4.tcp_keepalive_time`\n- `net.ipv4.tcp_keepalive_intvl`\n- `net.ipv4.tcp_keepalive_probes`",
+        "stability": "experimental",
+        "summary": "Configuration for Linux TCP keepalive settings applied to the ECS task container via `systemControls`."
       },
       "fqn": "@btc-embedded/cdk-extensions.TcpKeepAliveExtensionProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/extensions/TcpKeepAliveExtension.ts",
-        "line": 8
+        "line": 17
       },
       "name": "TcpKeepAliveExtensionProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Seconds between keepalive probes."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/TcpKeepAliveExtension.ts",
-            "line": 10
+            "line": 26
           },
           "name": "interval",
           "type": {
@@ -19067,12 +19146,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Number of unacknowledged probes before declaring the connection dead."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/TcpKeepAliveExtension.ts",
-            "line": 11
+            "line": 31
           },
           "name": "probes",
           "type": {
@@ -19082,12 +19162,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Seconds of idle time before keepalive probes are sent."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/TcpKeepAliveExtension.ts",
-            "line": 9
+            "line": 21
           },
           "name": "time",
           "type": {
@@ -19577,6 +19658,6 @@
       "symbolId": "src/platform/VpcV2:VpcV2Props"
     }
   },
-  "version": "0.22.2",
-  "fingerprint": "VGN5re3bYPlwq4FluiPrW3ICLgprc3m7TomFzEIw6o4="
+  "version": "0.22.3",
+  "fingerprint": "3ye4Xlv2ACmAtam4xKpWFQAb5stOVxC+B8MIcw6Q2lE="
 }