@btc-embedded/cdk-extensions 0.20.11 → 0.21.0

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```typescript\nimport { ApiGateway } from \"@btc-embedded/cdk-extensions\";\n\n// Use constructs and extensions in your CDK app\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\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"
   },
   "repository": {
     "type": "git",
@@ -8670,14 +8670,14 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "The name of the base platform stack."
+            "summary": "The prefix for the API Gateway endpoint."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApiGatewayExtension.ts",
-            "line": 30
+            "line": 25
           },
-          "name": "platformStackName",
+          "name": "prefix",
           "type": {
             "primitive": "string"
           }
@@ -8686,14 +8686,14 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "The prefix for the API Gateway endpoint."
+            "summary": "The security group ID of the API Gateway which should be allowed to connect to the service."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApiGatewayExtension.ts",
-            "line": 25
+            "line": 35
           },
-          "name": "prefix",
+          "name": "securityGroupId",
           "type": {
             "primitive": "string"
           }
@@ -8702,14 +8702,15 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "The security group ID of the API Gateway which should be allowed to connect to the service."
+            "summary": "The name of the base platform stack."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApiGatewayExtension.ts",
-            "line": 35
+            "line": 30
           },
-          "name": "securityGroupId",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -8867,7 +8868,7 @@
         },
         "locationInModule": {
           "filename": "src/platform/ApiGatewayVpcLink.ts",
-          "line": 108
+          "line": 114
         },
         "parameters": [
           {
@@ -8942,7 +8943,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/ApiGatewayVpcLink.ts",
-            "line": 105
+            "line": 111
           },
           "name": "securityGroup",
           "overrides": "@btc-embedded/cdk-extensions.ApiGatewayVpcLinkBase",
@@ -8957,7 +8958,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/ApiGatewayVpcLink.ts",
-            "line": 106
+            "line": 112
           },
           "name": "vpcLink",
           "overrides": "@btc-embedded/cdk-extensions.ApiGatewayVpcLinkBase",
@@ -9108,11 +9109,11 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/ApiGatewayVpcLink.ts",
-            "line": 31
+            "line": 32
           },
-          "name": "basePlatform",
+          "name": "vpc",
           "type": {
-            "primitive": "string"
+            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
           }
         },
         {
@@ -9123,11 +9124,12 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/ApiGatewayVpcLink.ts",
-            "line": 32
+            "line": 31
           },
-          "name": "vpc",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
+            "primitive": "string"
           }
         }
       ],
@@ -10086,7 +10088,7 @@
         },
         "locationInModule": {
           "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-          "line": 90
+          "line": 89
         },
         "parameters": [
           {
@@ -10110,7 +10112,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 96
+            "line": 94
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
@@ -10122,7 +10124,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 168
+            "line": 192
           },
           "name": "modifyServiceProps",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -10147,7 +10149,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 118
+            "line": 116
           },
           "name": "prehook",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -10174,7 +10176,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 175
+            "line": 199
           },
           "name": "useService",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -10203,10 +10205,9 @@
           "docs": {
             "stability": "deprecated"
           },
-          "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 88
+            "line": 87
           },
           "name": "fqdn",
           "type": {
@@ -10292,9 +10293,9 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 37
+            "line": 39
           },
-          "name": "platformStackName",
+          "name": "securityGroupId",
           "type": {
             "primitive": "string"
           }
@@ -10307,9 +10308,9 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 39
+            "line": 38
           },
-          "name": "securityGroupId",
+          "name": "userPoolClientSecret",
           "type": {
             "primitive": "string"
           }
@@ -10322,9 +10323,10 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtension.ts",
-            "line": 38
+            "line": 37
           },
-          "name": "userPoolClientSecret",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -10402,12 +10404,12 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-            "line": 14
+            "line": 13
           },
-          "name": "loadBalancer",
+          "name": "basePlatformStackName",
           "optional": true,
           "type": {
-            "fqn": "@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2"
+            "primitive": "string"
           }
         },
         {
@@ -10418,12 +10420,12 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/ApplicationLoadBalancerExtensionV2.ts",
-            "line": 13
+            "line": 14
           },
-          "name": "platformStackName",
+          "name": "loadBalancer",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2"
           }
         }
       ],
@@ -10782,7 +10784,7 @@
         },
         "locationInModule": {
           "filename": "src/platform/ApplicationLoadBalancerV2.ts",
-          "line": 143
+          "line": 147
         },
         "parameters": [
           {
@@ -10857,7 +10859,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/ApplicationLoadBalancerV2.ts",
-            "line": 141
+            "line": 145
           },
           "name": "domainName",
           "overrides": "@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2Base",
@@ -10872,7 +10874,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/ApplicationLoadBalancerV2.ts",
-            "line": 140
+            "line": 144
           },
           "name": "targetGroup",
           "overrides": "@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2Base",
@@ -11012,7 +11014,8 @@
             "filename": "src/platform/ApplicationLoadBalancerV2.ts",
             "line": 62
           },
-          "name": "basePlatform",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -11020,6 +11023,85 @@
       ],
       "symbolId": "src/platform/ApplicationLoadBalancerV2:ApplicationLoadBalancerV2LookupOptions"
     },
+    "@btc-embedded/cdk-extensions.ApplicationStack": {
+      "assembly": "@btc-embedded/cdk-extensions",
+      "base": "aws-cdk-lib.Stack",
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@btc-embedded/cdk-extensions.ApplicationStack",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/stacks/ApplicationStack.ts",
+          "line": 10
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@btc-embedded/cdk-extensions.ApplicationStackProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/stacks/ApplicationStack.ts",
+        "line": 9
+      },
+      "name": "ApplicationStack",
+      "symbolId": "src/stacks/ApplicationStack:ApplicationStack"
+    },
+    "@btc-embedded/cdk-extensions.ApplicationStackProps": {
+      "assembly": "@btc-embedded/cdk-extensions",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@btc-embedded/cdk-extensions.ApplicationStackProps",
+      "interfaces": [
+        "aws-cdk-lib.StackProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/stacks/ApplicationStack.ts",
+        "line": 5
+      },
+      "name": "ApplicationStackProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/stacks/ApplicationStack.ts",
+            "line": 6
+          },
+          "name": "basePlatformStackName",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/stacks/ApplicationStack:ApplicationStackProps"
+    },
     "@btc-embedded/cdk-extensions.BTCLogGroup": {
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "aws-cdk-lib.aws_logs.LogGroup",
@@ -11136,7 +11218,8 @@
             "filename": "src/platform/BTCLogGroup.ts",
             "line": 52
           },
-          "name": "basePlatform",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -11303,6 +11386,58 @@
       ],
       "symbolId": "src/platform/BTCLogGroup:BTCUniqueLogGroupOptions"
     },
+    "@btc-embedded/cdk-extensions.BasePlatformStackResolver": {
+      "assembly": "@btc-embedded/cdk-extensions",
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@btc-embedded/cdk-extensions.BasePlatformStackResolver",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/utils/BasePlatformStackResolver.ts",
+        "line": 6
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/utils/BasePlatformStackResolver.ts",
+            "line": 7
+          },
+          "name": "resolve",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "propsValue",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "BasePlatformStackResolver",
+      "symbolId": "src/utils/BasePlatformStackResolver:BasePlatformStackResolver"
+    },
     "@btc-embedded/cdk-extensions.CloudMapExtension": {
       "assembly": "@btc-embedded/cdk-extensions",
       "base": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -11488,7 +11623,8 @@
             "filename": "src/extensions/CloudMapExtension.ts",
             "line": 20
           },
-          "name": "platformStackName",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -11528,7 +11664,7 @@
         },
         "locationInModule": {
           "filename": "src/platform/CognitoUserPool.ts",
-          "line": 218
+          "line": 233
         },
         "parameters": [
           {
@@ -11580,7 +11716,8 @@
               }
             },
             {
-              "name": "basePlatform",
+              "name": "basePlatformStackName",
+              "optional": true,
               "type": {
                 "primitive": "string"
               }
@@ -11603,7 +11740,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/CognitoUserPool.ts",
-            "line": 213
+            "line": 228
           },
           "name": "apiUserPoolClient",
           "overrides": "@btc-embedded/cdk-extensions.CognitoUserPoolBase",
@@ -11618,7 +11755,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/CognitoUserPool.ts",
-            "line": 214
+            "line": 229
           },
           "name": "appClientSecret",
           "overrides": "@btc-embedded/cdk-extensions.CognitoUserPoolBase",
@@ -11634,7 +11771,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/CognitoUserPool.ts",
-            "line": 216
+            "line": 231
           },
           "name": "appOpenIdParameters",
           "overrides": "@btc-embedded/cdk-extensions.CognitoUserPoolBase",
@@ -11649,7 +11786,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/CognitoUserPool.ts",
-            "line": 212
+            "line": 227
           },
           "name": "appUserPoolClient",
           "overrides": "@btc-embedded/cdk-extensions.CognitoUserPoolBase",
@@ -11664,7 +11801,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/CognitoUserPool.ts",
-            "line": 215
+            "line": 230
           },
           "name": "cognitoUserPoolDomain",
           "overrides": "@btc-embedded/cdk-extensions.CognitoUserPoolBase",
@@ -11679,7 +11816,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/CognitoUserPool.ts",
-            "line": 211
+            "line": 226
           },
           "name": "userPool",
           "overrides": "@btc-embedded/cdk-extensions.CognitoUserPoolBase",
@@ -12794,6 +12931,7 @@
             },
             {
               "name": "name",
+              "optional": true,
               "type": {
                 "primitive": "string"
               }
@@ -13145,9 +13283,9 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 13
+            "line": 14
           },
-          "name": "basePlatformStackName",
+          "name": "securityGroupId",
           "type": {
             "primitive": "string"
           }
@@ -13160,9 +13298,10 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/DocumentDbAccessExtension.ts",
-            "line": 14
+            "line": 13
           },
-          "name": "securityGroupId",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -13437,7 +13576,7 @@
         },
         "locationInModule": {
           "filename": "src/platform/EcsCluster.ts",
-          "line": 79
+          "line": 82
         },
         "parameters": [
           {
@@ -13515,7 +13654,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/EcsCluster.ts",
-            "line": 77
+            "line": 80
           },
           "name": "cluster",
           "overrides": "@btc-embedded/cdk-extensions.IEcsCluster",
@@ -13544,16 +13683,16 @@
         {
           "abstract": true,
           "docs": {
-            "remarks": "This is usually the\nbase platform stack.",
+            "remarks": "This id used to look\nup the VPC when importing the cluster.",
             "stability": "experimental",
-            "summary": "The name of the stack where the ECS cluster is defined."
+            "summary": "The ID of the VPC where the ECS cluster is located."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/EcsCluster.ts",
-            "line": 32
+            "line": 38
           },
-          "name": "stackName",
+          "name": "vpcId",
           "type": {
             "primitive": "string"
           }
@@ -13561,16 +13700,17 @@
         {
           "abstract": true,
           "docs": {
-            "remarks": "This id used to look\nup the VPC when importing the cluster.",
+            "remarks": "This is usually the\nbase platform stack.",
             "stability": "experimental",
-            "summary": "The ID of the VPC where the ECS cluster is located."
+            "summary": "The name of the stack where the ECS cluster is defined."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/EcsCluster.ts",
-            "line": 38
+            "line": 32
           },
-          "name": "vpcId",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -13939,14 +14079,14 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "The name of the base platform."
+            "summary": "The name of the filesystem to be imported."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/EfsFileSystem.ts",
-            "line": 117
+            "line": 122
           },
-          "name": "basePlatformName",
+          "name": "filesystemName",
           "type": {
             "primitive": "string"
           }
@@ -13955,14 +14095,15 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "The name of the filesystem to be imported."
+            "summary": "The name of the base platform stack."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/EfsFileSystem.ts",
-            "line": 122
+            "line": 117
           },
-          "name": "filesystemName",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -14646,7 +14787,7 @@
         },
         "locationInModule": {
           "filename": "src/constructs/ExportedService.ts",
-          "line": 245
+          "line": 247
         },
         "parameters": [
           {
@@ -15334,7 +15475,8 @@
             "filename": "src/extensions/HTTPApiExtension.ts",
             "line": 36
           },
-          "name": "platformStackName",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -15445,7 +15587,7 @@
         },
         "locationInModule": {
           "filename": "src/platform/HostedZone.ts",
-          "line": 148
+          "line": 152
         },
         "parameters": [
           {
@@ -15525,7 +15667,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/HostedZone.ts",
-            "line": 146
+            "line": 150
           },
           "name": "zone",
           "overrides": "@btc-embedded/cdk-extensions.IHostedZone",
@@ -15563,7 +15705,8 @@
             "filename": "src/platform/HostedZone.ts",
             "line": 73
           },
-          "name": "stackName",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -16455,7 +16598,8 @@
             "filename": "src/extensions/LogExtension.ts",
             "line": 16
           },
-          "name": "basePlatformName",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -16893,7 +17037,8 @@
             "filename": "src/extensions/OpenIdExtension.ts",
             "line": 53
           },
-          "name": "platformStackName",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -17129,7 +17274,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 224
+            "line": 234
           },
           "name": "addHooks",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension"
@@ -17141,7 +17286,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 301
+            "line": 315
           },
           "name": "modifyServiceProps",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -17193,7 +17338,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 240
+            "line": 250
           },
           "name": "useService",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -17222,7 +17367,7 @@
           },
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 254
+            "line": 268
           },
           "name": "useTaskDefinition",
           "overrides": "@aws-cdk-containers/ecs-service-extensions.ServiceExtension",
@@ -17311,16 +17456,15 @@
         {
           "abstract": true,
           "docs": {
-            "remarks": "This name is used to look up output\nparameters.",
             "stability": "experimental",
-            "summary": "The name of the base platform stack."
+            "summary": "The name of the database."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 58
+            "line": 63
           },
-          "name": "basePlatformStackName",
+          "name": "dbName",
           "type": {
             "primitive": "string"
           }
@@ -17328,15 +17472,17 @@
         {
           "abstract": true,
           "docs": {
+            "remarks": "This name is used to look up output\nparameters.",
             "stability": "experimental",
-            "summary": "The name of the database."
+            "summary": "The name of the base platform stack."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/extensions/PostgresDbAccessExtension.ts",
-            "line": 63
+            "line": 58
           },
-          "name": "dbName",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -17558,7 +17704,7 @@
         },
         "locationInModule": {
           "filename": "src/platform/PrivateDnsNamespace.ts",
-          "line": 70
+          "line": 78
         },
         "parameters": [
           {
@@ -17614,6 +17760,7 @@
             },
             {
               "name": "stackName",
+              "optional": true,
               "type": {
                 "primitive": "string"
               }
@@ -17636,7 +17783,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/platform/PrivateDnsNamespace.ts",
-            "line": 68
+            "line": 76
           },
           "name": "namespace",
           "overrides": "@btc-embedded/cdk-extensions.IPrivateDnsNamespace",
@@ -18018,32 +18165,33 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "The name of the Base platform Stack."
+            "summary": "Props forwarded to the RestApi construct."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/SecureRestApi.ts",
-            "line": 20
+            "line": 35
           },
-          "name": "basePlatformStackName",
+          "name": "restApiProps",
           "type": {
-            "primitive": "string"
+            "fqn": "aws-cdk-lib.aws_apigateway.RestApiProps"
           }
         },
         {
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Props forwarded to the RestApi construct."
+            "summary": "The name of the Base platform Stack."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/SecureRestApi.ts",
-            "line": 35
+            "line": 20
           },
-          "name": "restApiProps",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_apigateway.RestApiProps"
+            "primitive": "string"
           }
         },
         {
@@ -18101,32 +18249,33 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "The name of the Base platform Stack."
+            "summary": "Props forwarded to the RestApi construct."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/SecureRestApiV2.ts",
-            "line": 20
+            "line": 38
           },
-          "name": "basePlatformStackName",
+          "name": "restApiProps",
           "type": {
-            "primitive": "string"
+            "fqn": "aws-cdk-lib.aws_apigateway.RestApiProps"
           }
         },
         {
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Props forwarded to the RestApi construct."
+            "summary": "The name of the Base platform Stack."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/constructs/SecureRestApiV2.ts",
-            "line": 38
+            "line": 20
           },
-          "name": "restApiProps",
+          "name": "basePlatformStackName",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_apigateway.RestApiProps"
+            "primitive": "string"
           }
         },
         {
@@ -18440,7 +18589,7 @@
         },
         "locationInModule": {
           "filename": "src/utils/StackParameter.ts",
-          "line": 82
+          "line": 83
         },
         "parameters": [
           {
@@ -18454,7 +18603,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/utils/StackParameter.ts",
-        "line": 73
+        "line": 74
       },
       "methods": [
         {
@@ -18465,7 +18614,7 @@
           },
           "locationInModule": {
             "filename": "src/utils/StackParameter.ts",
-            "line": 106
+            "line": 122
           },
           "name": "export",
           "parameters": [
@@ -18490,18 +18639,33 @@
         },
         {
           "docs": {
-            "remarks": "-v{version} is only emitted when the version is greater than 1.",
+            "remarks": "The stack name can be provided explicitly, or resolved from the construct tree\ncontext (set by ApplicationStack).",
+            "returns": "The imported CloudFormation value\n\n-v{version} is only emitted when the version is greater than 1.",
             "stability": "experimental",
             "summary": "Import the parameter as {stackName}:{prefix}-v{version}:{key}."
           },
           "locationInModule": {
             "filename": "src/utils/StackParameter.ts",
-            "line": 95
+            "line": 103
           },
           "name": "import",
           "parameters": [
             {
+              "docs": {
+                "summary": "- The construct scope for context resolution."
+              },
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "docs": {
+                "remarks": "If not provided, will resolve from context.",
+                "summary": "- Optional explicit stack name."
+              },
               "name": "stackName",
+              "optional": true,
               "type": {
                 "primitive": "string"
               }
@@ -18528,7 +18692,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/utils/StackParameter.ts",
-        "line": 36
+        "line": 37
       },
       "name": "StackParameterOptions",
       "properties": [
@@ -18541,7 +18705,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/utils/StackParameter.ts",
-            "line": 48
+            "line": 49
           },
           "name": "key",
           "type": {
@@ -18558,7 +18722,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/utils/StackParameter.ts",
-            "line": 43
+            "line": 44
           },
           "name": "prefix",
           "type": {
@@ -18588,7 +18752,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/utils/StackParameter.ts",
-            "line": 66
+            "line": 67
           },
           "name": "description",
           "optional": true,
@@ -18605,7 +18769,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/utils/StackParameter.ts",
-            "line": 53
+            "line": 54
           },
           "name": "name",
           "optional": true,
@@ -18623,7 +18787,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/utils/StackParameter.ts",
-            "line": 61
+            "line": 62
           },
           "name": "version",
           "optional": true,
@@ -19013,6 +19177,7 @@
             },
             {
               "name": "stackName",
+              "optional": true,
               "type": {
                 "primitive": "string"
               }
@@ -19412,6 +19577,6 @@
       "symbolId": "src/platform/VpcV2:VpcV2Props"
     }
   },
-  "version": "0.20.11",
-  "fingerprint": "lpOtSJQP4hbM6gbY3LzqBYZYREjCnODreS3lq1JBCR4="
+  "version": "0.21.0",
+  "fingerprint": "poJ4+VZ2TQmGYDO71nP/bAfsWBV9PxtmK/mYpwu7Bwc="
 }